sailfork / t3code-github / apps/ mobile/ src/ connection/ environment-cache-store.ts

import {
  ORCHESTRATION_CACHE_SCHEMA_VERSION,
  COMPACT_THREAD_CACHE_SCHEMA_VERSION,
  decodeStoredThreadSnapshot,
  encodeStoredThreadSnapshot,
  Persistence,
  makeStoredShellSnapshotEncoder,
} from "@t3tools/client-runtime/platform";
import { type EnvironmentId, ServerConfig, VcsListRefsResult } from "@t3tools/contracts";
import * as Effect from "effect/Effect";
import * as Layer from "effect/Layer";
import * as Option from "effect/Option";
import * as Schema from "effect/Schema";

import * as MobileDatabase from "../persistence/mobile-database";
import {
  attachProjectFaviconDatabase,
  projectFaviconDatabaseCache,
} from "../lib/projectFaviconDatabaseCache";
import { decodeStoredShellSnapshot } from "./shell-cache-decoding";

const SERVER_CONFIG_CACHE_SCHEMA_VERSION = 1;
const VCS_REFS_CACHE_SCHEMA_VERSION = 1;

const StoredServerConfig = Schema.Struct({
  schemaVersion: Schema.Literal(SERVER_CONFIG_CACHE_SCHEMA_VERSION),
  environmentId: Schema.String,
  config: ServerConfig,
});
const StoredVcsRefs = Schema.Struct({
  schemaVersion: Schema.Literal(VCS_REFS_CACHE_SCHEMA_VERSION),
  environmentId: Schema.String,
  cwd: Schema.String,
  refs: VcsListRefsResult,
});

const decodeStoredServerConfig = Schema.decodeUnknownEffect(
  Schema.fromJsonString(StoredServerConfig),
);
const encodeStoredServerConfig = Schema.encodeEffect(Schema.fromJsonString(StoredServerConfig));
const decodeStoredVcsRefs = Schema.decodeUnknownEffect(Schema.fromJsonString(StoredVcsRefs));
const encodeStoredVcsRefs = Schema.encodeEffect(Schema.fromJsonString(StoredVcsRefs));

type CacheOperation = Persistence.ConnectionPersistenceError["operation"];

function persistenceError(operation: CacheOperation, cause: unknown) {
  return new Persistence.ConnectionPersistenceError({
    operation,
    message: `Could not ${operation.replaceAll("-", " ")}: ${String(cause)}`,
  });
}

function mapDatabaseError(operation: CacheOperation) {
  return (error: MobileDatabase.MobileDatabaseError) => persistenceError(operation, error);
}

function loadDecodedCache<A, B, E>(input: {
  readonly database: MobileDatabase.MobileDatabase["Service"];
  readonly environmentId: EnvironmentId;
  readonly kind: MobileDatabase.ClientCacheKind;
  readonly cacheKey: string;
  readonly operation: CacheOperation;
  readonly decode: (raw: string) => Effect.Effect<A, E>;
  readonly select: (value: A) => Option.Option<B>;
}): Effect.Effect<Option.Option<B>, Persistence.ConnectionPersistenceError> {
  return input.database.loadCache(input.environmentId, input.kind, input.cacheKey).pipe(
    Effect.mapError(mapDatabaseError(input.operation)),
    Effect.flatMap(
      Option.match({
        onNone: () => Effect.succeed(Option.none<B>()),
        onSome: (raw) =>
          input.decode(raw).pipe(
            Effect.map(input.select),
            Effect.catch((cause) =>
              Effect.logWarning("Discarding corrupt mobile client cache record.", {
                environmentId: input.environmentId,
                kind: input.kind,
                cacheKey: input.cacheKey,
                cause: String(cause),
              }).pipe(
                Effect.andThen(
                  input.database
                    .removeCache(input.environmentId, input.kind, input.cacheKey)
                    .pipe(Effect.ignore),
                ),
                Effect.as(Option.none<B>()),
              ),
            ),
          ),
      }),
    ),
  );
}

export const make = Effect.fn("MobileEnvironmentCacheStore.make")(function* () {
  const database = yield* MobileDatabase.MobileDatabase;
  attachProjectFaviconDatabase(database);
  const encodeStoredShellSnapshot = makeStoredShellSnapshotEncoder();
  return Persistence.EnvironmentCacheStore.of({
    loadShell: Effect.fn("MobileEnvironmentCache.loadShell")((environmentId) =>
      loadDecodedCache({
        database,
        environmentId,
        kind: "shell",
        cacheKey: "snapshot",
        operation: "load-shell",
        decode: decodeStoredShellSnapshot,
        select: (stored) =>
          stored.environmentId === environmentId ? Option.some(stored.snapshot) : Option.none(),
      }).pipe(
        Effect.zipWith(
          Effect.promise(() => projectFaviconDatabaseCache.hydrate()),
          (snapshot) => snapshot,
          { concurrent: true },
        ),
      ),
    ),
    saveShell: Effect.fn("MobileEnvironmentCache.saveShell")(function* (environmentId, snapshot) {
      const payload = yield* encodeStoredShellSnapshot({
        schemaVersion: ORCHESTRATION_CACHE_SCHEMA_VERSION,
        environmentId,
        snapshot,
      }).pipe(Effect.mapError((cause) => persistenceError("save-shell", cause)));
      yield* database
        .saveCache(environmentId, "shell", "snapshot", ORCHESTRATION_CACHE_SCHEMA_VERSION, payload)
        .pipe(Effect.mapError(mapDatabaseError("save-shell")));
    }),
    loadThread: Effect.fn("MobileEnvironmentCache.loadThread")((environmentId, threadId) =>
      loadDecodedCache({
        database,
        environmentId,
        kind: "thread",
        cacheKey: threadId,
        operation: "load-thread",
        decode: decodeStoredThreadSnapshot,
        select: (stored) =>
          stored.environmentId === environmentId && stored.threadId === threadId
            ? Option.some(stored.snapshot)
            : Option.none(),
      }),
    ),
    saveThread: Effect.fn("MobileEnvironmentCache.saveThread")(function* (environmentId, snapshot) {
      const threadId = snapshot.projection.thread.id;
      const payload = yield* encodeStoredThreadSnapshot({
        environmentId,
        threadId,
        snapshot,
      }).pipe(Effect.mapError((cause) => persistenceError("save-thread", cause)));
      yield* database
        .saveCache(environmentId, "thread", threadId, COMPACT_THREAD_CACHE_SCHEMA_VERSION, payload)
        .pipe(Effect.mapError(mapDatabaseError("save-thread")));
    }),
    removeThread: Effect.fn("MobileEnvironmentCache.removeThread")((environmentId, threadId) =>
      database
        .removeCache(environmentId, "thread", threadId)
        .pipe(Effect.mapError(mapDatabaseError("remove-thread"))),
    ),
    loadServerConfig: Effect.fn("MobileEnvironmentCache.loadServerConfig")((environmentId) =>
      loadDecodedCache({
        database,
        environmentId,
        kind: "server-config",
        cacheKey: "config",
        operation: "load-server-config",
        decode: decodeStoredServerConfig,
        select: (stored) =>
          stored.environmentId === environmentId ? Option.some(stored.config) : Option.none(),
      }),
    ),
    saveServerConfig: Effect.fn("MobileEnvironmentCache.saveServerConfig")(
      function* (environmentId, config) {
        const payload = yield* encodeStoredServerConfig({
          schemaVersion: SERVER_CONFIG_CACHE_SCHEMA_VERSION,
          environmentId,
          config,
        }).pipe(Effect.mapError((cause) => persistenceError("save-server-config", cause)));
        yield* database
          .saveCache(
            environmentId,
            "server-config",
            "config",
            SERVER_CONFIG_CACHE_SCHEMA_VERSION,
            payload,
          )
          .pipe(Effect.mapError(mapDatabaseError("save-server-config")));
      },
    ),
    loadVcsRefs: Effect.fn("MobileEnvironmentCache.loadVcsRefs")((environmentId, cwd) =>
      loadDecodedCache({
        database,
        environmentId,
        kind: "vcs-refs",
        cacheKey: cwd,
        operation: "load-vcs-refs",
        decode: decodeStoredVcsRefs,
        select: (stored) =>
          stored.environmentId === environmentId && stored.cwd === cwd
            ? Option.some(stored.refs)
            : Option.none(),
      }),
    ),
    saveVcsRefs: Effect.fn("MobileEnvironmentCache.saveVcsRefs")(
      function* (environmentId, cwd, refs) {
        const payload = yield* encodeStoredVcsRefs({
          schemaVersion: VCS_REFS_CACHE_SCHEMA_VERSION,
          environmentId,
          cwd,
          refs,
        }).pipe(Effect.mapError((cause) => persistenceError("save-vcs-refs", cause)));
        yield* database
          .saveCache(environmentId, "vcs-refs", cwd, VCS_REFS_CACHE_SCHEMA_VERSION, payload)
          .pipe(Effect.mapError(mapDatabaseError("save-vcs-refs")));
      },
    ),
    removeVcsRefs: Effect.fn("MobileEnvironmentCache.removeVcsRefs")((environmentId, cwd) =>
      database
        .removeCache(environmentId, "vcs-refs", cwd)
        .pipe(Effect.mapError(mapDatabaseError("remove-vcs-refs"))),
    ),
    clearVcsRefs: Effect.fn("MobileEnvironmentCache.clearVcsRefs")((environmentId) =>
      database
        .clearCacheKind(environmentId, "vcs-refs")
        .pipe(Effect.mapError(mapDatabaseError("clear-vcs-refs"))),
    ),
    clear: Effect.fn("MobileEnvironmentCache.clear")((environmentId) =>
      Effect.promise(() => projectFaviconDatabaseCache.clearEnvironment(environmentId)).pipe(
        Effect.andThen(database.clearEnvironmentCache(environmentId)),
        Effect.mapError(mapDatabaseError("clear-environment")),
      ),
    ),
  });
});

export const layer = Layer.effect(Persistence.EnvironmentCacheStore, make());