@tearleads/client-sdk 0.0.0-stage → 0.1.13

package/data/persistence/container-contents/dormantMetadataSweep.js

@@ -0,0 +1,102 @@
+import { and, eq, sql } from "drizzle-orm";
+import { dormantContainerMetadata, dormantMetadataSweepRequests, } from "../../sqlite/schema.js";
+import { getClientSQLitePersistenceRuntime, } from "../../sqlite/sqlitePersistenceRuntime.js";
+import { ensureContainerTables } from "../containers/containerPersistence.js";
+export async function requestDormantMetadataRestorationSweeps(execSql, input) {
+    await ensureContainerTables(execSql);
+    const requestedAt = new Date().toISOString();
+    return getClientSQLitePersistenceRuntime(execSql).runMutation(async (db) => {
+        const organizations = await db
+            .selectDistinct({
+            organizationId: dormantContainerMetadata.organizationId,
+        })
+            .from(dormantContainerMetadata)
+            .orderBy(dormantContainerMetadata.organizationId);
+        if (organizations.length === 0) {
+            return 0;
+        }
+        await db
+            .insert(dormantMetadataSweepRequests)
+            .values(organizations.map(({ organizationId }) => ({
+            attemptCount: 0,
+            generation: 1,
+            lastAttemptedAt: null,
+            organizationId,
+            requestedAt,
+            requesterUserId: input.requesterUserId,
+        })))
+            .onConflictDoUpdate({
+            target: [
+                dormantMetadataSweepRequests.organizationId,
+                dormantMetadataSweepRequests.requesterUserId,
+            ],
+            set: {
+                attemptCount: 0,
+                generation: sql `${dormantMetadataSweepRequests.generation} + 1`,
+                lastAttemptedAt: null,
+                requestedAt: sql `excluded.requested_at`,
+            },
+        })
+            .run();
+        return organizations.length;
+    });
+}
+export async function listDormantMetadataSweepRequests(execSql, requesterUserId) {
+    await ensureContainerTables(execSql);
+    return getClientSQLitePersistenceRuntime(execSql)
+        .db.select({
+        attemptCount: dormantMetadataSweepRequests.attemptCount,
+        generation: dormantMetadataSweepRequests.generation,
+        lastAttemptedAt: dormantMetadataSweepRequests.lastAttemptedAt,
+        organizationId: dormantMetadataSweepRequests.organizationId,
+        requestedAt: dormantMetadataSweepRequests.requestedAt,
+        requesterUserId: dormantMetadataSweepRequests.requesterUserId,
+    })
+        .from(dormantMetadataSweepRequests)
+        .where(eq(dormantMetadataSweepRequests.requesterUserId, requesterUserId))
+        .orderBy(dormantMetadataSweepRequests.organizationId);
+}
+export async function claimDormantMetadataSweepAttempt(execSql, sweep, attemptedAt, stillCurrent) {
+    await ensureContainerTables(execSql);
+    const runtime = getClientSQLitePersistenceRuntime(execSql);
+    const claim = async (tx) => {
+        const [current] = await tx
+            .select({ attemptCount: dormantMetadataSweepRequests.attemptCount })
+            .from(dormantMetadataSweepRequests)
+            .where(and(eq(dormantMetadataSweepRequests.organizationId, sweep.organizationId), eq(dormantMetadataSweepRequests.requesterUserId, sweep.requesterUserId), eq(dormantMetadataSweepRequests.generation, sweep.generation)))
+            .limit(1);
+        if (!current || current.attemptCount !== sweep.attemptCount) {
+            return false;
+        }
+        await tx
+            .update(dormantMetadataSweepRequests)
+            .set({
+            attemptCount: current.attemptCount + 1,
+            lastAttemptedAt: attemptedAt,
+        })
+            .where(and(eq(dormantMetadataSweepRequests.organizationId, sweep.organizationId), eq(dormantMetadataSweepRequests.requesterUserId, sweep.requesterUserId), eq(dormantMetadataSweepRequests.generation, sweep.generation), eq(dormantMetadataSweepRequests.attemptCount, current.attemptCount)))
+            .run();
+        return true;
+    };
+    if (!stillCurrent) {
+        return runtime.transaction(claim);
+    }
+    const outcome = await runtime.guardedTransaction(claim, stillCurrent);
+    return outcome.committed && outcome.result === true;
+}
+export async function completeDormantMetadataSweepRequest(execSql, sweep, stillCurrent) {
+    await ensureContainerTables(execSql);
+    const runtime = getClientSQLitePersistenceRuntime(execSql);
+    const complete = async (tx) => {
+        await tx
+            .delete(dormantMetadataSweepRequests)
+            .where(and(eq(dormantMetadataSweepRequests.organizationId, sweep.organizationId), eq(dormantMetadataSweepRequests.requesterUserId, sweep.requesterUserId), eq(dormantMetadataSweepRequests.generation, sweep.generation)))
+            .run();
+    };
+    if (stillCurrent) {
+        await runtime.guardedTransaction(complete, stillCurrent);
+        return;
+    }
+    await runtime.transaction(complete);
+}
+//# sourceMappingURL=dormantMetadataSweep.js.map

package/data/persistence/container-contents/dormantMetadataSweep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dormantMetadataSweep.js","sourceRoot":"","sources":["dormantMetadataSweep.ts"],"names":[],"mappings":"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","sourcesContent":["import { and, eq, sql } from \"drizzle-orm\";\nimport {\n  dormantContainerMetadata,\n  dormantMetadataSweepRequests,\n} from \"../../sqlite/schema\";\nimport {\n  type ClientSQLiteTransactionScope,\n  getClientSQLitePersistenceRuntime,\n} from \"../../sqlite/sqlitePersistenceRuntime\";\nimport type { ExecSql } from \"../../sqlite/sqlSchema\";\nimport { ensureContainerTables } from \"../containers/containerPersistence\";\n\nexport interface DormantMetadataSweepRequest {\n  readonly attemptCount: number;\n  readonly generation: number;\n  readonly lastAttemptedAt: string | null;\n  readonly organizationId: string;\n  readonly requestedAt: string;\n  readonly requesterUserId: string;\n}\n\nexport interface DormantMetadataSweepPersistence {\n  claimDormantMetadataSweepAttempt: (\n    execSql: ExecSql,\n    sweep: DormantMetadataSweepRequest,\n    attemptedAt: string,\n    stillCurrent?: (() => boolean) | undefined,\n  ) => Promise<boolean>;\n  completeDormantMetadataSweepRequest: (\n    execSql: ExecSql,\n    sweep: DormantMetadataSweepRequest,\n    stillCurrent?: (() => boolean) | undefined,\n  ) => Promise<void>;\n  listDormantMetadataSweepRequests: (\n    execSql: ExecSql,\n    requesterUserId: string,\n  ) => Promise<readonly DormantMetadataSweepRequest[]>;\n}\n\nexport async function requestDormantMetadataRestorationSweeps(\n  execSql: ExecSql,\n  input: { requesterUserId: string },\n): Promise<number> {\n  await ensureContainerTables(execSql);\n  const requestedAt = new Date().toISOString();\n  return getClientSQLitePersistenceRuntime(execSql).runMutation(async (db) => {\n    const organizations = await db\n      .selectDistinct({\n        organizationId: dormantContainerMetadata.organizationId,\n      })\n      .from(dormantContainerMetadata)\n      .orderBy(dormantContainerMetadata.organizationId);\n    if (organizations.length === 0) {\n      return 0;\n    }\n\n    await db\n      .insert(dormantMetadataSweepRequests)\n      .values(\n        organizations.map(({ organizationId }) => ({\n          attemptCount: 0,\n          generation: 1,\n          lastAttemptedAt: null,\n          organizationId,\n          requestedAt,\n          requesterUserId: input.requesterUserId,\n        })),\n      )\n      .onConflictDoUpdate({\n        target: [\n          dormantMetadataSweepRequests.organizationId,\n          dormantMetadataSweepRequests.requesterUserId,\n        ],\n        set: {\n          attemptCount: 0,\n          generation: sql`${dormantMetadataSweepRequests.generation} + 1`,\n          lastAttemptedAt: null,\n          requestedAt: sql`excluded.requested_at`,\n        },\n      })\n      .run();\n    return organizations.length;\n  });\n}\n\nexport async function listDormantMetadataSweepRequests(\n  execSql: ExecSql,\n  requesterUserId: string,\n): Promise<readonly DormantMetadataSweepRequest[]> {\n  await ensureContainerTables(execSql);\n  return getClientSQLitePersistenceRuntime(execSql)\n    .db.select({\n      attemptCount: dormantMetadataSweepRequests.attemptCount,\n      generation: dormantMetadataSweepRequests.generation,\n      lastAttemptedAt: dormantMetadataSweepRequests.lastAttemptedAt,\n      organizationId: dormantMetadataSweepRequests.organizationId,\n      requestedAt: dormantMetadataSweepRequests.requestedAt,\n      requesterUserId: dormantMetadataSweepRequests.requesterUserId,\n    })\n    .from(dormantMetadataSweepRequests)\n    .where(eq(dormantMetadataSweepRequests.requesterUserId, requesterUserId))\n    .orderBy(dormantMetadataSweepRequests.organizationId);\n}\n\nexport async function claimDormantMetadataSweepAttempt(\n  execSql: ExecSql,\n  sweep: DormantMetadataSweepRequest,\n  attemptedAt: string,\n  stillCurrent?: (() => boolean) | undefined,\n): Promise<boolean> {\n  await ensureContainerTables(execSql);\n  const runtime = getClientSQLitePersistenceRuntime(execSql);\n  const claim = async (tx: ClientSQLiteTransactionScope) => {\n    const [current] = await tx\n      .select({ attemptCount: dormantMetadataSweepRequests.attemptCount })\n      .from(dormantMetadataSweepRequests)\n      .where(\n        and(\n          eq(dormantMetadataSweepRequests.organizationId, sweep.organizationId),\n          eq(\n            dormantMetadataSweepRequests.requesterUserId,\n            sweep.requesterUserId,\n          ),\n          eq(dormantMetadataSweepRequests.generation, sweep.generation),\n        ),\n      )\n      .limit(1);\n    if (!current || current.attemptCount !== sweep.attemptCount) {\n      return false;\n    }\n    await tx\n      .update(dormantMetadataSweepRequests)\n      .set({\n        attemptCount: current.attemptCount + 1,\n        lastAttemptedAt: attemptedAt,\n      })\n      .where(\n        and(\n          eq(dormantMetadataSweepRequests.organizationId, sweep.organizationId),\n          eq(\n            dormantMetadataSweepRequests.requesterUserId,\n            sweep.requesterUserId,\n          ),\n          eq(dormantMetadataSweepRequests.generation, sweep.generation),\n          eq(dormantMetadataSweepRequests.attemptCount, current.attemptCount),\n        ),\n      )\n      .run();\n    return true;\n  };\n  if (!stillCurrent) {\n    return runtime.transaction(claim);\n  }\n  const outcome = await runtime.guardedTransaction(claim, stillCurrent);\n  return outcome.committed && outcome.result === true;\n}\n\nexport async function completeDormantMetadataSweepRequest(\n  execSql: ExecSql,\n  sweep: DormantMetadataSweepRequest,\n  stillCurrent?: (() => boolean) | undefined,\n): Promise<void> {\n  await ensureContainerTables(execSql);\n  const runtime = getClientSQLitePersistenceRuntime(execSql);\n  const complete = async (tx: ClientSQLiteTransactionScope) => {\n    await tx\n      .delete(dormantMetadataSweepRequests)\n      .where(\n        and(\n          eq(dormantMetadataSweepRequests.organizationId, sweep.organizationId),\n          eq(\n            dormantMetadataSweepRequests.requesterUserId,\n            sweep.requesterUserId,\n          ),\n          eq(dormantMetadataSweepRequests.generation, sweep.generation),\n        ),\n      )\n      .run();\n  };\n  if (stillCurrent) {\n    await runtime.guardedTransaction(complete, stillCurrent);\n    return;\n  }\n  await runtime.transaction(complete);\n}\n"]}

package/data/persistence/container-contents/pendingContainerCreate.js

@@ -0,0 +1,21 @@
+import { and, eq } from "drizzle-orm";
+import { containerCreateIntents, containerCreateIntentTables, } from "../../sqlite/schema.js";
+import { getClientSQLitePersistenceRuntime } from "../../sqlite/sqlitePersistenceRuntime.js";
+import { ensureSqlTables } from "../../sqlite/sqlSchema.js";
+import { CONTAINER_CREATE_INTENT_TYPE } from "./containerContentsPersistenceTypes.js";
+/**
+ * A folder whose create has not settled can carry a listed identity that
+ * adoption has not verified, or has refused; nothing is created inside it
+ * until the create settles.
+ */
+export async function isContainerCreatePending(execSql, containerId) {
+    await ensureSqlTables(execSql, containerCreateIntentTables);
+    const { db } = getClientSQLitePersistenceRuntime(execSql);
+    const [pending] = await db
+        .select({ containerId: containerCreateIntents.containerId })
+        .from(containerCreateIntents)
+        .where(and(eq(containerCreateIntents.containerId, containerId), eq(containerCreateIntents.intentType, CONTAINER_CREATE_INTENT_TYPE), eq(containerCreateIntents.syncStatus, "pending")))
+        .limit(1);
+    return pending !== undefined;
+}
+//# sourceMappingURL=pendingContainerCreate.js.map

package/data/persistence/container-contents/pendingContainerCreate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pendingContainerCreate.js","sourceRoot":"","sources":["pendingContainerCreate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EACL,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iCAAiC,EAAE,MAAM,uCAAuC,CAAC;AAC1F,OAAO,EAAgB,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AAEnF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,OAAgB,EAChB,WAAmB;IAEnB,MAAM,eAAe,CAAC,OAAO,EAAE,2BAA2B,CAAC,CAAC;IAC5D,MAAM,EAAE,EAAE,EAAE,GAAG,iCAAiC,CAAC,OAAO,CAAC,CAAC;IAC1D,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,EAAE;SACvB,MAAM,CAAC,EAAE,WAAW,EAAE,sBAAsB,CAAC,WAAW,EAAE,CAAC;SAC3D,IAAI,CAAC,sBAAsB,CAAC;SAC5B,KAAK,CACJ,GAAG,CACD,EAAE,CAAC,sBAAsB,CAAC,WAAW,EAAE,WAAW,CAAC,EACnD,EAAE,CAAC,sBAAsB,CAAC,UAAU,EAAE,4BAA4B,CAAC,EACnE,EAAE,CAAC,sBAAsB,CAAC,UAAU,EAAE,SAAS,CAAC,CACjD,CACF;SACA,KAAK,CAAC,CAAC,CAAC,CAAC;IACZ,OAAO,OAAO,KAAK,SAAS,CAAC;AAC/B,CAAC","sourcesContent":["import { and, eq } from \"drizzle-orm\";\nimport {\n  containerCreateIntents,\n  containerCreateIntentTables,\n} from \"../../sqlite/schema\";\nimport { getClientSQLitePersistenceRuntime } from \"../../sqlite/sqlitePersistenceRuntime\";\nimport { type ExecSql, ensureSqlTables } from \"../../sqlite/sqlSchema\";\nimport { CONTAINER_CREATE_INTENT_TYPE } from \"./containerContentsPersistenceTypes\";\n\n/**\n * A folder whose create has not settled can carry a listed identity that\n * adoption has not verified, or has refused; nothing is created inside it\n * until the create settles.\n */\nexport async function isContainerCreatePending(\n  execSql: ExecSql,\n  containerId: string,\n): Promise<boolean> {\n  await ensureSqlTables(execSql, containerCreateIntentTables);\n  const { db } = getClientSQLitePersistenceRuntime(execSql);\n  const [pending] = await db\n    .select({ containerId: containerCreateIntents.containerId })\n    .from(containerCreateIntents)\n    .where(\n      and(\n        eq(containerCreateIntents.containerId, containerId),\n        eq(containerCreateIntents.intentType, CONTAINER_CREATE_INTENT_TYPE),\n        eq(containerCreateIntents.syncStatus, \"pending\"),\n      ),\n    )\n    .limit(1);\n  return pending !== undefined;\n}\n"]}

package/data/persistence/container-contents/supersededContainerBindings.js

@@ -0,0 +1,27 @@
+import { and, eq } from "drizzle-orm";
+import { supersededContainerBindings } from "../../sqlite/schema.js";
+import { getClientSQLitePersistenceRuntime, } from "../../sqlite/sqlitePersistenceRuntime.js";
+/** Whether a held folder was re-homed away from this organization. */
+export async function isSupersededContainerBinding(execSql, input) {
+    const rows = await getClientSQLitePersistenceRuntime(execSql)
+        .db.select({ containerId: supersededContainerBindings.containerId })
+        .from(supersededContainerBindings)
+        .where(and(eq(supersededContainerBindings.containerId, input.containerId), eq(supersededContainerBindings.organizationId, input.organizationId)))
+        .limit(1);
+    return rows.length > 0;
+}
+/** Record that folders left an organization, so it can never be replayed. */
+export async function recordSupersededContainerBindingsInTransaction(tx, input) {
+    if (input.containerIds.length === 0 || input.organizationId === "")
+        return;
+    await tx
+        .insert(supersededContainerBindings)
+        .values(input.containerIds.map((containerId) => ({
+        containerId,
+        organizationId: input.organizationId,
+        supersededAt: input.supersededAt,
+    })))
+        .onConflictDoNothing()
+        .run();
+}
+//# sourceMappingURL=supersededContainerBindings.js.map

package/data/persistence/container-contents/supersededContainerBindings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supersededContainerBindings.js","sourceRoot":"","sources":["supersededContainerBindings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAEL,iCAAiC,GAClC,MAAM,uCAAuC,CAAC;AAG/C,sEAAsE;AACtE,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,OAAgB,EAChB,KAAsD;IAEtD,MAAM,IAAI,GAAG,MAAM,iCAAiC,CAAC,OAAO,CAAC;SAC1D,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,2BAA2B,CAAC,WAAW,EAAE,CAAC;SACnE,IAAI,CAAC,2BAA2B,CAAC;SACjC,KAAK,CACJ,GAAG,CACD,EAAE,CAAC,2BAA2B,CAAC,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC,EAC9D,EAAE,CAAC,2BAA2B,CAAC,cAAc,EAAE,KAAK,CAAC,cAAc,CAAC,CACrE,CACF;SACA,KAAK,CAAC,CAAC,CAAC,CAAC;IACZ,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,8CAA8C,CAClE,EAAgC,EAChC,KAIC;IAED,IAAI,KAAK,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,cAAc,KAAK,EAAE;QAAE,OAAO;IAC3E,MAAM,EAAE;SACL,MAAM,CAAC,2BAA2B,CAAC;SACnC,MAAM,CACL,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACvC,WAAW;QACX,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,YAAY,EAAE,KAAK,CAAC,YAAY;KACjC,CAAC,CAAC,CACJ;SACA,mBAAmB,EAAE;SACrB,GAAG,EAAE,CAAC;AACX,CAAC","sourcesContent":["import { and, eq } from \"drizzle-orm\";\nimport { supersededContainerBindings } from \"../../sqlite/schema\";\nimport {\n  type ClientSQLiteTransactionScope,\n  getClientSQLitePersistenceRuntime,\n} from \"../../sqlite/sqlitePersistenceRuntime\";\nimport type { ExecSql } from \"../../sqlite/sqlSchema\";\n\n/** Whether a held folder was re-homed away from this organization. */\nexport async function isSupersededContainerBinding(\n  execSql: ExecSql,\n  input: { containerId: string; organizationId: string },\n): Promise<boolean> {\n  const rows = await getClientSQLitePersistenceRuntime(execSql)\n    .db.select({ containerId: supersededContainerBindings.containerId })\n    .from(supersededContainerBindings)\n    .where(\n      and(\n        eq(supersededContainerBindings.containerId, input.containerId),\n        eq(supersededContainerBindings.organizationId, input.organizationId),\n      ),\n    )\n    .limit(1);\n  return rows.length > 0;\n}\n\n/** Record that folders left an organization, so it can never be replayed. */\nexport async function recordSupersededContainerBindingsInTransaction(\n  tx: ClientSQLiteTransactionScope,\n  input: {\n    containerIds: ReadonlyArray<string>;\n    organizationId: string;\n    supersededAt: string;\n  },\n): Promise<void> {\n  if (input.containerIds.length === 0 || input.organizationId === \"\") return;\n  await tx\n    .insert(supersededContainerBindings)\n    .values(\n      input.containerIds.map((containerId) => ({\n        containerId,\n        organizationId: input.organizationId,\n        supersededAt: input.supersededAt,\n      })),\n    )\n    .onConflictDoNothing()\n    .run();\n}\n"]}

package/data/persistence/containers/containerPersistence.d.ts

@@ -0,0 +1,35 @@
+import type { ContainerAccessLevel } from "../../../internal/crypto/index.js";
+import { type ContainerSystemSlot } from "../../../internal/validators/containerSystemSlot.js";
+import { type ClientSQLiteTransactionScope } from "../../sqlite/sqlitePersistenceRuntime.js";
+import { type ExecSql } from "../../sqlite/sqlSchema.js";
+export interface ContainerRecord {
+    createdAt?: string | null;
+    effectiveAccessLevel?: ContainerAccessLevel | null;
+    id: string;
+    organizationId: string;
+    parentId: string | null;
+    metadataDocumentId: string | null;
+    systemSlot?: ContainerSystemSlot | null;
+    name: string;
+    icon: string | null;
+    localCreatedAt?: string | null;
+    localUpdatedAt?: string | null;
+    serverCreatedAt?: string | null;
+    serverUpdatedAt?: string | null;
+    updatedAt?: string | null;
+}
+export declare function ensureContainerTables(execSql: ExecSql): Promise<void>;
+export declare function saveContainerRows(input: {
+    tx: ClientSQLiteTransactionScope;
+    record: ContainerRecord;
+    localUpdatedAt: string;
+}): Promise<ContainerRecord>;
+export declare function loadContainers(execSql: ExecSql): Promise<ContainerRecord[]>;
+export declare function loadContainerById(execSql: ExecSql, containerId: string): Promise<ContainerRecord | null>;
+export declare function loadContainerDisplayNamesByIds(execSql: ExecSql, ids: ReadonlyArray<string>): Promise<Map<string, string>>;
+export declare function saveContainer(execSql: ExecSql, record: ContainerRecord): Promise<void>;
+/**
+ * The container-row half of the delete cascade, statement-only so callers
+ * can compose it inside one atomic transaction.
+ */
+export declare function deleteContainerRowsInTransaction(tx: ClientSQLiteTransactionScope, ids: ReadonlyArray<string>): Promise<void>;

package/data/persistence/containers/containerPersistence.js

@@ -0,0 +1,204 @@
+import { isContainerSystemSlot, } from "../../../internal/validators/containerSystemSlot.js";
+import { asc, eq, inArray, sql } from "drizzle-orm";
+import { DEFAULT_EFFECTIVE_ACCESS_LEVEL, normalizeEffectiveAccessLevel, } from "../../accessLevel.js";
+import { containerProjection, containers, containerTables, } from "../../sqlite/schema.js";
+import { getClientSQLitePersistenceRuntime, } from "../../sqlite/sqlitePersistenceRuntime.js";
+import { ensureSqlTables } from "../../sqlite/sqlSchema.js";
+export function ensureContainerTables(execSql) {
+    return ensureSqlTables(execSql, containerTables);
+}
+// The ONE display-name fallback: a projection row names the container; without
+// one the root reads '/' and everything else 'Untitled'.
+const containerDisplayName = sql `COALESCE(
+    ${containerProjection.displayName},
+    CASE WHEN ${containers.parentId} IS NULL THEN '/' ELSE 'Untitled' END
+  )`;
+function toDisplayContainerRecord(record) {
+    return {
+        ...record,
+        createdAt: record.serverCreatedAt ?? record.localCreatedAt ?? null,
+        updatedAt: record.serverUpdatedAt ?? record.localUpdatedAt ?? null,
+    };
+}
+function applyContainerTimestampDefaults(record, localUpdatedAt) {
+    const hasServerTimestamps = record.serverCreatedAt !== undefined ||
+        record.serverUpdatedAt !== undefined;
+    const localCreatedAt = record.localCreatedAt ??
+        (!hasServerTimestamps ? record.createdAt : null) ??
+        localUpdatedAt;
+    const serverCreatedAt = record.serverCreatedAt ?? null;
+    const serverUpdatedAt = record.serverUpdatedAt ?? null;
+    return {
+        ...record,
+        createdAt: serverCreatedAt ?? localCreatedAt,
+        localCreatedAt,
+        localUpdatedAt,
+        serverCreatedAt,
+        serverUpdatedAt,
+        updatedAt: serverUpdatedAt ?? localUpdatedAt,
+    };
+}
+function mapSelectedContainerRecord(row) {
+    const systemSlot = isContainerSystemSlot(row.systemSlot)
+        ? row.systemSlot
+        : null;
+    return toDisplayContainerRecord({
+        effectiveAccessLevel: normalizeEffectiveAccessLevel(row.effectiveAccessLevel),
+        id: String(row.id ?? ""),
+        organizationId: row.organizationId,
+        parentId: row.parentId,
+        metadataDocumentId: row.metadataDocumentId,
+        systemSlot,
+        name: row.name,
+        icon: row.icon && row.icon.length > 0 ? row.icon : null,
+        localCreatedAt: row.localCreatedAt,
+        localUpdatedAt: row.localUpdatedAt,
+        serverCreatedAt: row.serverCreatedAt,
+        serverUpdatedAt: row.serverUpdatedAt,
+    });
+}
+export async function saveContainerRows(input) {
+    const { record, tx, localUpdatedAt } = input;
+    const nextRecord = applyContainerTimestampDefaults(record, localUpdatedAt);
+    const containerRow = {
+        effectiveAccessLevel: nextRecord.effectiveAccessLevel ?? DEFAULT_EFFECTIVE_ACCESS_LEVEL,
+        id: nextRecord.id,
+        organizationId: nextRecord.organizationId,
+        parentId: nextRecord.parentId,
+        metadataDocumentId: nextRecord.metadataDocumentId,
+        systemSlot: nextRecord.systemSlot ?? null,
+        localCreatedAt: nextRecord.localCreatedAt,
+        localUpdatedAt,
+        serverCreatedAt: nextRecord.serverCreatedAt,
+        serverUpdatedAt: nextRecord.serverUpdatedAt,
+    };
+    await tx
+        .insert(containers)
+        .values(containerRow)
+        .onConflictDoUpdate({
+        target: containers.id,
+        set: {
+            organizationId: containerRow.organizationId,
+            parentId: containerRow.parentId,
+            metadataDocumentId: containerRow.metadataDocumentId,
+            systemSlot: containerRow.systemSlot,
+            effectiveAccessLevel: containerRow.effectiveAccessLevel,
+            localUpdatedAt: containerRow.localUpdatedAt,
+            serverCreatedAt: record.serverCreatedAt === undefined
+                ? sql `${containers.serverCreatedAt}`
+                : containerRow.serverCreatedAt,
+            serverUpdatedAt: record.serverUpdatedAt === undefined
+                ? sql `${containers.serverUpdatedAt}`
+                : containerRow.serverUpdatedAt,
+        },
+    })
+        .run();
+    const projectionRow = {
+        containerId: nextRecord.id,
+        displayName: nextRecord.name,
+        icon: nextRecord.icon,
+        updatedAt: localUpdatedAt,
+    };
+    await tx
+        .insert(containerProjection)
+        .values(projectionRow)
+        .onConflictDoUpdate({
+        target: containerProjection.containerId,
+        set: projectionRow,
+    })
+        .run();
+    return nextRecord;
+}
+export async function loadContainers(execSql) {
+    const { db } = getClientSQLitePersistenceRuntime(execSql);
+    const rows = await db
+        .select({
+        effectiveAccessLevel: containers.effectiveAccessLevel,
+        id: containers.id,
+        organizationId: containers.organizationId,
+        parentId: containers.parentId,
+        metadataDocumentId: containers.metadataDocumentId,
+        systemSlot: containers.systemSlot,
+        name: containerDisplayName,
+        icon: containerProjection.icon,
+        localCreatedAt: containers.localCreatedAt,
+        localUpdatedAt: containers.localUpdatedAt,
+        serverCreatedAt: containers.serverCreatedAt,
+        serverUpdatedAt: containers.serverUpdatedAt,
+    })
+        .from(containers)
+        .leftJoin(containerProjection, eq(containerProjection.containerId, containers.id))
+        .orderBy(asc(sql `${containerDisplayName} COLLATE NOCASE`));
+    return rows.map((row) => mapSelectedContainerRecord(row));
+}
+export async function loadContainerById(execSql, containerId) {
+    const { db } = getClientSQLitePersistenceRuntime(execSql);
+    const rows = await db
+        .select({
+        effectiveAccessLevel: containers.effectiveAccessLevel,
+        id: containers.id,
+        organizationId: containers.organizationId,
+        parentId: containers.parentId,
+        metadataDocumentId: containers.metadataDocumentId,
+        systemSlot: containers.systemSlot,
+        name: containerDisplayName,
+        icon: containerProjection.icon,
+        localCreatedAt: containers.localCreatedAt,
+        localUpdatedAt: containers.localUpdatedAt,
+        serverCreatedAt: containers.serverCreatedAt,
+        serverUpdatedAt: containers.serverUpdatedAt,
+    })
+        .from(containers)
+        .leftJoin(containerProjection, eq(containerProjection.containerId, containers.id))
+        .where(eq(containers.id, containerId))
+        .limit(1);
+    return rows[0] ? mapSelectedContainerRecord(rows[0]) : null;
+}
+export async function loadContainerDisplayNamesByIds(execSql, ids) {
+    const uniqueIds = Array.from(new Set(ids));
+    if (uniqueIds.length === 0) {
+        return new Map();
+    }
+    const { db } = getClientSQLitePersistenceRuntime(execSql);
+    const rows = await db
+        .select({
+        id: containers.id,
+        name: containerDisplayName,
+    })
+        .from(containers)
+        .leftJoin(containerProjection, eq(containerProjection.containerId, containers.id))
+        .where(inArray(containers.id, uniqueIds));
+    return new Map(rows.flatMap((row) => {
+        const displayName = row.name.trim();
+        if (!row.id || displayName.length === 0) {
+            return [];
+        }
+        return [[row.id, displayName]];
+    }));
+}
+export async function saveContainer(execSql, record) {
+    const localUpdatedAt = new Date().toISOString();
+    await getClientSQLitePersistenceRuntime(execSql).transaction(async (tx) => {
+        await saveContainerRows({
+            record,
+            tx,
+            localUpdatedAt,
+        });
+    });
+}
+/**
+ * The container-row half of the delete cascade, statement-only so callers
+ * can compose it inside one atomic transaction.
+ */
+export async function deleteContainerRowsInTransaction(tx, ids) {
+    const uniqueIds = Array.from(new Set(ids));
+    if (uniqueIds.length === 0) {
+        return;
+    }
+    await tx
+        .delete(containerProjection)
+        .where(inArray(containerProjection.containerId, uniqueIds))
+        .run();
+    await tx.delete(containers).where(inArray(containers.id, uniqueIds)).run();
+}
+//# sourceMappingURL=containerPersistence.js.map

package/data/persistence/containers/containerPersistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"containerPersistence.js","sourceRoot":"","sources":["containerPersistence.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ContainerAccessLevel } from \"@tearleads/crypto\";\nimport {\n  type ContainerSystemSlot,\n  isContainerSystemSlot,\n} from \"@tearleads/validators/containerSystemSlot\";\nimport { asc, eq, inArray, sql } from \"drizzle-orm\";\nimport {\n  DEFAULT_EFFECTIVE_ACCESS_LEVEL,\n  normalizeEffectiveAccessLevel,\n} from \"../../accessLevel\";\nimport {\n  containerProjection,\n  containers,\n  containerTables,\n} from \"../../sqlite/schema\";\nimport {\n  type ClientSQLiteTransactionScope,\n  getClientSQLitePersistenceRuntime,\n} from \"../../sqlite/sqlitePersistenceRuntime\";\nimport { type ExecSql, ensureSqlTables } from \"../../sqlite/sqlSchema\";\n\nexport interface ContainerRecord {\n  createdAt?: string | null;\n  effectiveAccessLevel?: ContainerAccessLevel | null;\n  id: string;\n  organizationId: string;\n  parentId: string | null;\n  metadataDocumentId: string | null;\n  systemSlot?: ContainerSystemSlot | null;\n  name: string;\n  icon: string | null;\n  localCreatedAt?: string | null;\n  localUpdatedAt?: string | null;\n  serverCreatedAt?: string | null;\n  serverUpdatedAt?: string | null;\n  updatedAt?: string | null;\n}\n\ninterface ContainerRecordWithTimestampDefaults extends ContainerRecord {\n  createdAt: string | null;\n  localCreatedAt: string;\n  localUpdatedAt: string;\n  serverCreatedAt: string | null;\n  serverUpdatedAt: string | null;\n  updatedAt: string | null;\n}\n\nexport function ensureContainerTables(execSql: ExecSql): Promise<void> {\n  return ensureSqlTables(execSql, containerTables);\n}\n\n// The ONE display-name fallback: a projection row names the container; without\n// one the root reads '/' and everything else 'Untitled'.\nconst containerDisplayName = sql<string>`COALESCE(\n    ${containerProjection.displayName},\n    CASE WHEN ${containers.parentId} IS NULL THEN '/' ELSE 'Untitled' END\n  )`;\n\ninterface SelectedContainerRecord {\n  effectiveAccessLevel: string | null;\n  id: string | null;\n  organizationId: string;\n  parentId: string | null;\n  metadataDocumentId: string | null;\n  systemSlot: string | null;\n  name: string;\n  icon: string | null;\n  localCreatedAt: string;\n  localUpdatedAt: string;\n  serverCreatedAt: string | null;\n  serverUpdatedAt: string | null;\n}\n\nfunction toDisplayContainerRecord(record: ContainerRecord): ContainerRecord {\n  return {\n    ...record,\n    createdAt: record.serverCreatedAt ?? record.localCreatedAt ?? null,\n    updatedAt: record.serverUpdatedAt ?? record.localUpdatedAt ?? null,\n  };\n}\n\nfunction applyContainerTimestampDefaults(\n  record: ContainerRecord,\n  localUpdatedAt: string,\n): ContainerRecordWithTimestampDefaults {\n  const hasServerTimestamps =\n    record.serverCreatedAt !== undefined ||\n    record.serverUpdatedAt !== undefined;\n  const localCreatedAt =\n    record.localCreatedAt ??\n    (!hasServerTimestamps ? record.createdAt : null) ??\n    localUpdatedAt;\n  const serverCreatedAt = record.serverCreatedAt ?? null;\n  const serverUpdatedAt = record.serverUpdatedAt ?? null;\n\n  return {\n    ...record,\n    createdAt: serverCreatedAt ?? localCreatedAt,\n    localCreatedAt,\n    localUpdatedAt,\n    serverCreatedAt,\n    serverUpdatedAt,\n    updatedAt: serverUpdatedAt ?? localUpdatedAt,\n  };\n}\n\nfunction mapSelectedContainerRecord(\n  row: SelectedContainerRecord,\n): ContainerRecord {\n  const systemSlot = isContainerSystemSlot(row.systemSlot)\n    ? row.systemSlot\n    : null;\n\n  return toDisplayContainerRecord({\n    effectiveAccessLevel: normalizeEffectiveAccessLevel(\n      row.effectiveAccessLevel,\n    ),\n    id: String(row.id ?? \"\"),\n    organizationId: row.organizationId,\n    parentId: row.parentId,\n    metadataDocumentId: row.metadataDocumentId,\n    systemSlot,\n    name: row.name,\n    icon: row.icon && row.icon.length > 0 ? row.icon : null,\n    localCreatedAt: row.localCreatedAt,\n    localUpdatedAt: row.localUpdatedAt,\n    serverCreatedAt: row.serverCreatedAt,\n    serverUpdatedAt: row.serverUpdatedAt,\n  });\n}\n\nexport async function saveContainerRows(input: {\n  tx: ClientSQLiteTransactionScope;\n  record: ContainerRecord;\n  localUpdatedAt: string;\n}): Promise<ContainerRecord> {\n  const { record, tx, localUpdatedAt } = input;\n  const nextRecord = applyContainerTimestampDefaults(record, localUpdatedAt);\n  const containerRow = {\n    effectiveAccessLevel:\n      nextRecord.effectiveAccessLevel ?? DEFAULT_EFFECTIVE_ACCESS_LEVEL,\n    id: nextRecord.id,\n    organizationId: nextRecord.organizationId,\n    parentId: nextRecord.parentId,\n    metadataDocumentId: nextRecord.metadataDocumentId,\n    systemSlot: nextRecord.systemSlot ?? null,\n    localCreatedAt: nextRecord.localCreatedAt,\n    localUpdatedAt,\n    serverCreatedAt: nextRecord.serverCreatedAt,\n    serverUpdatedAt: nextRecord.serverUpdatedAt,\n  };\n  await tx\n    .insert(containers)\n    .values(containerRow)\n    .onConflictDoUpdate({\n      target: containers.id,\n      set: {\n        organizationId: containerRow.organizationId,\n        parentId: containerRow.parentId,\n        metadataDocumentId: containerRow.metadataDocumentId,\n        systemSlot: containerRow.systemSlot,\n        effectiveAccessLevel: containerRow.effectiveAccessLevel,\n        localUpdatedAt: containerRow.localUpdatedAt,\n        serverCreatedAt:\n          record.serverCreatedAt === undefined\n            ? sql`${containers.serverCreatedAt}`\n            : containerRow.serverCreatedAt,\n        serverUpdatedAt:\n          record.serverUpdatedAt === undefined\n            ? sql`${containers.serverUpdatedAt}`\n            : containerRow.serverUpdatedAt,\n      },\n    })\n    .run();\n\n  const projectionRow = {\n    containerId: nextRecord.id,\n    displayName: nextRecord.name,\n    icon: nextRecord.icon,\n    updatedAt: localUpdatedAt,\n  };\n  await tx\n    .insert(containerProjection)\n    .values(projectionRow)\n    .onConflictDoUpdate({\n      target: containerProjection.containerId,\n      set: projectionRow,\n    })\n    .run();\n\n  return nextRecord;\n}\n\nexport async function loadContainers(\n  execSql: ExecSql,\n): Promise<ContainerRecord[]> {\n  const { db } = getClientSQLitePersistenceRuntime(execSql);\n  const rows = await db\n    .select({\n      effectiveAccessLevel: containers.effectiveAccessLevel,\n      id: containers.id,\n      organizationId: containers.organizationId,\n      parentId: containers.parentId,\n      metadataDocumentId: containers.metadataDocumentId,\n      systemSlot: containers.systemSlot,\n      name: containerDisplayName,\n      icon: containerProjection.icon,\n      localCreatedAt: containers.localCreatedAt,\n      localUpdatedAt: containers.localUpdatedAt,\n      serverCreatedAt: containers.serverCreatedAt,\n      serverUpdatedAt: containers.serverUpdatedAt,\n    })\n    .from(containers)\n    .leftJoin(\n      containerProjection,\n      eq(containerProjection.containerId, containers.id),\n    )\n    .orderBy(asc(sql`${containerDisplayName} COLLATE NOCASE`));\n\n  return rows.map((row) => mapSelectedContainerRecord(row));\n}\n\nexport async function loadContainerById(\n  execSql: ExecSql,\n  containerId: string,\n): Promise<ContainerRecord | null> {\n  const { db } = getClientSQLitePersistenceRuntime(execSql);\n  const rows = await db\n    .select({\n      effectiveAccessLevel: containers.effectiveAccessLevel,\n      id: containers.id,\n      organizationId: containers.organizationId,\n      parentId: containers.parentId,\n      metadataDocumentId: containers.metadataDocumentId,\n      systemSlot: containers.systemSlot,\n      name: containerDisplayName,\n      icon: containerProjection.icon,\n      localCreatedAt: containers.localCreatedAt,\n      localUpdatedAt: containers.localUpdatedAt,\n      serverCreatedAt: containers.serverCreatedAt,\n      serverUpdatedAt: containers.serverUpdatedAt,\n    })\n    .from(containers)\n    .leftJoin(\n      containerProjection,\n      eq(containerProjection.containerId, containers.id),\n    )\n    .where(eq(containers.id, containerId))\n    .limit(1);\n\n  return rows[0] ? mapSelectedContainerRecord(rows[0]) : null;\n}\n\nexport async function loadContainerDisplayNamesByIds(\n  execSql: ExecSql,\n  ids: ReadonlyArray<string>,\n): Promise<Map<string, string>> {\n  const uniqueIds = Array.from(new Set(ids));\n  if (uniqueIds.length === 0) {\n    return new Map();\n  }\n\n  const { db } = getClientSQLitePersistenceRuntime(execSql);\n  const rows = await db\n    .select({\n      id: containers.id,\n      name: containerDisplayName,\n    })\n    .from(containers)\n    .leftJoin(\n      containerProjection,\n      eq(containerProjection.containerId, containers.id),\n    )\n    .where(inArray(containers.id, uniqueIds));\n\n  return new Map(\n    rows.flatMap((row) => {\n      const displayName = row.name.trim();\n      if (!row.id || displayName.length === 0) {\n        return [];\n      }\n\n      return [[row.id, displayName]];\n    }),\n  );\n}\n\nexport async function saveContainer(\n  execSql: ExecSql,\n  record: ContainerRecord,\n): Promise<void> {\n  const localUpdatedAt = new Date().toISOString();\n\n  await getClientSQLitePersistenceRuntime(execSql).transaction(async (tx) => {\n    await saveContainerRows({\n      record,\n      tx,\n      localUpdatedAt,\n    });\n  });\n}\n\n/**\n * The container-row half of the delete cascade, statement-only so callers\n * can compose it inside one atomic transaction.\n */\nexport async function deleteContainerRowsInTransaction(\n  tx: ClientSQLiteTransactionScope,\n  ids: ReadonlyArray<string>,\n): Promise<void> {\n  const uniqueIds = Array.from(new Set(ids));\n  if (uniqueIds.length === 0) {\n    return;\n  }\n  await tx\n    .delete(containerProjection)\n    .where(inArray(containerProjection.containerId, uniqueIds))\n    .run();\n  await tx.delete(containers).where(inArray(containers.id, uniqueIds)).run();\n}\n"]}

package/data/persistence/containers/containerSyncWatermarkPersistence.d.ts

@@ -0,0 +1,48 @@
+import type { SyncWatermark } from "../../../internal/validators/response/index.js";
+import { type ClientSQLiteDatabase, type ClientSQLiteTransactionScope } from "../../sqlite/sqlitePersistenceRuntime.js";
+import { type ExecSql } from "../../sqlite/sqlSchema.js";
+declare const CONTAINER_PARENT_LANE = "container_parent";
+declare const CONTAINER_DOCUMENTS_LANE = "container_documents";
+export type ContainerSyncWatermarkLane = {
+    kind: typeof CONTAINER_PARENT_LANE;
+    parentId: string | null;
+} | {
+    kind: typeof CONTAINER_DOCUMENTS_LANE;
+    containerId: string;
+};
+interface ContainerSyncWatermarkRecord {
+    laneId: string;
+    laneKind: string;
+    updatedAt: string;
+    watermark: SyncWatermark;
+}
+export interface ContainerSyncLaneCheckRecord {
+    checkedAt: string;
+    laneId: string;
+    laneKind: string;
+}
+interface ContainerSyncMarkerMutationOptions {
+    readonly stillCurrent?: (() => boolean) | undefined;
+}
+export declare const containerParentSyncLane: (parentId: string | null) => ContainerSyncWatermarkLane;
+export declare const containerContentsSyncLane: (containerId: string) => ContainerSyncWatermarkLane;
+export declare function containerSyncWatermarkLaneKey(lane: ContainerSyncWatermarkLane): {
+    laneId: string;
+    laneKind: string;
+};
+/**
+ * The watermark half of the container-delete cascade, statement-only so the
+ * caller can run it inside one atomic transaction alongside the rest of the
+ * cascade.
+ */
+export declare function deleteContainerWatermarksInTransaction(tx: ClientSQLiteDatabase | ClientSQLiteTransactionScope, containerIds: ReadonlyArray<string>): Promise<void>;
+export declare const sqlContainerSyncWatermarkPersistence: {
+    ensureSchema(execSql: ExecSql): Promise<void>;
+    loadWatermark(execSql: ExecSql, lane: ContainerSyncWatermarkLane): Promise<SyncWatermark | null>;
+    loadWatermarkRecords(execSql: ExecSql, lanes: ReadonlyArray<ContainerSyncWatermarkLane>): Promise<Array<ContainerSyncWatermarkRecord | null>>;
+    loadCheckRecords(execSql: ExecSql, lanes: ReadonlyArray<ContainerSyncWatermarkLane>): Promise<Array<ContainerSyncLaneCheckRecord | null>>;
+    markChecked(execSql: ExecSql, lane: ContainerSyncWatermarkLane, options?: ContainerSyncMarkerMutationOptions): Promise<boolean>;
+    saveWatermark(execSql: ExecSql, lane: ContainerSyncWatermarkLane, watermark: SyncWatermark, options?: ContainerSyncMarkerMutationOptions): Promise<boolean>;
+    deleteWatermarksForContainers(execSql: ExecSql, containerIds: ReadonlyArray<string>): Promise<void>;
+};
+export {};