@tearleads/client-sdk 0.1.63 → 0.1.65

package/data/sqlite/schema/containerSchema.js

@@ -0,0 +1,103 @@
+import { index, integer, primaryKey, sqliteTable, text, } from "drizzle-orm/sqlite-core";
+import { defineSqlTableSchema } from "../sqlTableSchema.js";
+const accessLevelColumn = "effective_access_level";
+/**
+ * Materialized local container tree.
+ *
+ * Container rows describe the tree and its encrypted metadata document;
+ * metadata rows live in `documents`. `id` is the primary key for structural
+ * lookups. `metadataDocumentId` is the server metadata-document id when known;
+ * `systemSlot` is an optional opaque app-owned slot. `displayName` and `icon`
+ * are the decrypted metadata projection lists read: `displayName` stays
+ * nullable so presentation falls back to `/` for a root and `Untitled`
+ * otherwise. Local timestamps track client storage/structural changes, while
+ * server timestamps are populated once the container has synced.
+ */
+export const containers = sqliteTable("containers", {
+    id: text("id"),
+    organizationId: text("organization_id").notNull(),
+    parentId: text("parent_id"),
+    metadataDocumentId: text("metadata_document_id"),
+    systemSlot: text("system_slot"),
+    displayName: text("display_name"),
+    icon: text("icon"),
+    effectiveAccessLevel: text(accessLevelColumn).notNull().default("read"),
+    localCreatedAt: text("local_created_at").notNull(),
+    localUpdatedAt: text("local_updated_at").notNull(),
+    serverCreatedAt: text("server_created_at"),
+    serverUpdatedAt: text("server_updated_at"),
+}, (table) => [primaryKey({ columns: [table.id] })]);
+/**
+ * Latest removal observed for each container. Hydration must observe the same
+ * generation before fetching verified restoration evidence; unsigned clocks
+ * never establish a terminal deletion or bypass a concurrent removal. Cleared
+ * observations retain their generation so remove/restore/remove cannot reuse it.
+ */
+export const containerHydrationTombstones = sqliteTable("container_hydration_tombstones", {
+    containerId: text("container_id").notNull(),
+    generation: integer("generation").notNull().default(1),
+    cleared: integer("cleared", { mode: "boolean" }).notNull().default(false),
+    reason: text("reason").notNull(),
+    updatedAt: text("updated_at").notNull(),
+}, (table) => [primaryKey({ columns: [table.containerId] })]);
+/**
+ * Organization attribution for container metadata retained after access loss.
+ * The container row is removed on revocation, so this marker retains the
+ * organization scope needed by a later access-restoration sweep.
+ */
+export const dormantContainerMetadata = sqliteTable("dormant_container_metadata", {
+    containerId: text("container_id").notNull(),
+    organizationId: text("organization_id").notNull(),
+    retainedAt: text("retained_at").notNull(),
+}, (table) => [
+    primaryKey({ columns: [table.containerId] }),
+    index("dormant_container_metadata_organization_idx").on(table.organizationId, table.containerId),
+]);
+/**
+ * Organizations a held folder was re-homed away from. Purged-organization
+ * recovery re-creates folders under their existing ids and a purged
+ * organization never returns, so a later proof binding the folder back to one
+ * of these organizations is a replay. Retained across remote resets.
+ */
+export const supersededContainerBindings = sqliteTable("superseded_container_bindings", {
+    containerId: text("container_id").notNull(),
+    organizationId: text("organization_id").notNull(),
+    supersededAt: text("superseded_at").notNull(),
+}, (table) => [
+    primaryKey({ columns: [table.containerId, table.organizationId] }),
+]);
+/**
+ * Durable request for a post-access-restoration crawl and sweep. Attempt state
+ * enforces exponential backoff and a bounded retry budget across restarts.
+ */
+export const dormantMetadataSweepRequests = sqliteTable("dormant_metadata_sweep_requests", {
+    organizationId: text("organization_id").notNull(),
+    requesterUserId: text("requester_user_id").notNull(),
+    generation: integer("generation").notNull().default(1),
+    attemptCount: integer("attempt_count").notNull().default(0),
+    lastAttemptedAt: text("last_attempted_at"),
+    requestedAt: text("requested_at").notNull(),
+}, (table) => [
+    primaryKey({ columns: [table.organizationId, table.requesterUserId] }),
+]);
+export const containerTableSchemas = [
+    {
+        ...defineSqlTableSchema(containers),
+        requiredColumns: ["display_name", "icon"],
+    },
+    {
+        ...defineSqlTableSchema(containerHydrationTombstones),
+        requiredColumns: ["cleared"],
+    },
+    defineSqlTableSchema(dormantContainerMetadata),
+    defineSqlTableSchema(dormantMetadataSweepRequests),
+    defineSqlTableSchema(supersededContainerBindings),
+];
+export const containerSQLiteSchema = {
+    containers,
+    containerHydrationTombstones,
+    dormantContainerMetadata,
+    dormantMetadataSweepRequests,
+    supersededContainerBindings,
+};
+//# sourceMappingURL=containerSchema.js.map

package/data/sqlite/schema/containerSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"containerSchema.js","sourceRoot":"","sources":["containerSchema.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  index,\n  integer,\n  primaryKey,\n  sqliteTable,\n  text,\n} from \"drizzle-orm/sqlite-core\";\nimport { defineSqlTableSchema, type SqlTableSchema } from \"../sqlTableSchema\";\n\nconst accessLevelColumn = \"effective_access_level\";\n\n/**\n * Materialized local container tree.\n *\n * Container rows describe the tree and its encrypted metadata document;\n * metadata rows live in `documents`. `id` is the primary key for structural\n * lookups. `metadataDocumentId` is the server metadata-document id when known;\n * `systemSlot` is an optional opaque app-owned slot. `displayName` and `icon`\n * are the decrypted metadata projection lists read: `displayName` stays\n * nullable so presentation falls back to `/` for a root and `Untitled`\n * otherwise. Local timestamps track client storage/structural changes, while\n * server timestamps are populated once the container has synced.\n */\nexport const containers = sqliteTable(\n  \"containers\",\n  {\n    id: text(\"id\"),\n    organizationId: text(\"organization_id\").notNull(),\n    parentId: text(\"parent_id\"),\n    metadataDocumentId: text(\"metadata_document_id\"),\n    systemSlot: text(\"system_slot\"),\n    displayName: text(\"display_name\"),\n    icon: text(\"icon\"),\n    effectiveAccessLevel: text(accessLevelColumn).notNull().default(\"read\"),\n    localCreatedAt: text(\"local_created_at\").notNull(),\n    localUpdatedAt: text(\"local_updated_at\").notNull(),\n    serverCreatedAt: text(\"server_created_at\"),\n    serverUpdatedAt: text(\"server_updated_at\"),\n  },\n  (table) => [primaryKey({ columns: [table.id] })],\n);\n\n/**\n * Latest removal observed for each container. Hydration must observe the same\n * generation before fetching verified restoration evidence; unsigned clocks\n * never establish a terminal deletion or bypass a concurrent removal. Cleared\n * observations retain their generation so remove/restore/remove cannot reuse it.\n */\nexport const containerHydrationTombstones = sqliteTable(\n  \"container_hydration_tombstones\",\n  {\n    containerId: text(\"container_id\").notNull(),\n    generation: integer(\"generation\").notNull().default(1),\n    cleared: integer(\"cleared\", { mode: \"boolean\" }).notNull().default(false),\n    reason: text(\"reason\").notNull(),\n    updatedAt: text(\"updated_at\").notNull(),\n  },\n  (table) => [primaryKey({ columns: [table.containerId] })],\n);\n\n/**\n * Organization attribution for container metadata retained after access loss.\n * The container row is removed on revocation, so this marker retains the\n * organization scope needed by a later access-restoration sweep.\n */\nexport const dormantContainerMetadata = sqliteTable(\n  \"dormant_container_metadata\",\n  {\n    containerId: text(\"container_id\").notNull(),\n    organizationId: text(\"organization_id\").notNull(),\n    retainedAt: text(\"retained_at\").notNull(),\n  },\n  (table) => [\n    primaryKey({ columns: [table.containerId] }),\n    index(\"dormant_container_metadata_organization_idx\").on(\n      table.organizationId,\n      table.containerId,\n    ),\n  ],\n);\n\n/**\n * Organizations a held folder was re-homed away from. Purged-organization\n * recovery re-creates folders under their existing ids and a purged\n * organization never returns, so a later proof binding the folder back to one\n * of these organizations is a replay. Retained across remote resets.\n */\nexport const supersededContainerBindings = sqliteTable(\n  \"superseded_container_bindings\",\n  {\n    containerId: text(\"container_id\").notNull(),\n    organizationId: text(\"organization_id\").notNull(),\n    supersededAt: text(\"superseded_at\").notNull(),\n  },\n  (table) => [\n    primaryKey({ columns: [table.containerId, table.organizationId] }),\n  ],\n);\n\n/**\n * Durable request for a post-access-restoration crawl and sweep. Attempt state\n * enforces exponential backoff and a bounded retry budget across restarts.\n */\nexport const dormantMetadataSweepRequests = sqliteTable(\n  \"dormant_metadata_sweep_requests\",\n  {\n    organizationId: text(\"organization_id\").notNull(),\n    requesterUserId: text(\"requester_user_id\").notNull(),\n    generation: integer(\"generation\").notNull().default(1),\n    attemptCount: integer(\"attempt_count\").notNull().default(0),\n    lastAttemptedAt: text(\"last_attempted_at\"),\n    requestedAt: text(\"requested_at\").notNull(),\n  },\n  (table) => [\n    primaryKey({ columns: [table.organizationId, table.requesterUserId] }),\n  ],\n);\n\nexport const containerTableSchemas: ReadonlyArray<SqlTableSchema> = [\n  {\n    ...defineSqlTableSchema(containers),\n    requiredColumns: [\"display_name\", \"icon\"],\n  },\n  {\n    ...defineSqlTableSchema(containerHydrationTombstones),\n    requiredColumns: [\"cleared\"],\n  },\n  defineSqlTableSchema(dormantContainerMetadata),\n  defineSqlTableSchema(dormantMetadataSweepRequests),\n  defineSqlTableSchema(supersededContainerBindings),\n];\n\nexport const containerSQLiteSchema = {\n  containers,\n  containerHydrationTombstones,\n  dormantContainerMetadata,\n  dormantMetadataSweepRequests,\n  supersededContainerBindings,\n};\n"]}