@tearleads/client-sdk 0.1.42 → 0.1.43

package/data/sqlite/schema.d.ts

@@ -358,210 +358,11 @@ export declare const documents: import("drizzle-orm/sqlite-core").SQLiteTableWit
     };
     dialect: "sqlite";
 }>;
-/**
- * Outbound Loro updates waiting to be accepted by sync.
- *
- * Each row stores one locally produced update for a document scope. The queue is
- * replayed in creation order and acknowledged rows are deleted after sync
- * writes the corresponding server commit or persisted document state.
- *
- * Columns:
- * - `id`: Client-generated queue id used for acknowledgement deletes.
- * - `appKind`: Local document namespace matching `documents.appKind`.
- * - `localId`: Local document id matching `documents.localId`.
- * - `updateData`: Serialized Loro update payload.
- * - `partialStartVersionVector`: Version vector before this partial update.
- * - `partialEndVersionVector`: Version vector after this partial update.
- * - `sourceVersionVector`: Optional source vector used to avoid re-enqueuing
- *   updates that came from sync.
- * - `createdAt`: Queue insertion timestamp used for deterministic replay.
- *
- * Indexes:
- * - `id` is the primary key for targeted deletes.
- * - `(appKind, localId, createdAt)` supports ordered pending-update scans for a
- *   document scope.
- */
-export declare const documentPendingUpdates: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
-    name: "document_pending_updates";
-    schema: undefined;
-    columns: {
-        id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-            name: "id";
-            tableName: "document_pending_updates";
-            dataType: "string";
-            columnType: "SQLiteText";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: number | undefined;
-        }>;
-        appKind: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-            name: "app_kind";
-            tableName: "document_pending_updates";
-            dataType: "string";
-            columnType: "SQLiteText";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: number | undefined;
-        }>;
-        localId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-            name: "local_id";
-            tableName: "document_pending_updates";
-            dataType: "string";
-            columnType: "SQLiteText";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: number | undefined;
-        }>;
-        updateData: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-            name: "update_data";
-            tableName: "document_pending_updates";
-            dataType: "string";
-            columnType: "SQLiteText";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: number | undefined;
-        }>;
-        partialStartVersionVector: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-            name: "partial_start_version_vector";
-            tableName: "document_pending_updates";
-            dataType: "string";
-            columnType: "SQLiteText";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: number | undefined;
-        }>;
-        partialEndVersionVector: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-            name: "partial_end_version_vector";
-            tableName: "document_pending_updates";
-            dataType: "string";
-            columnType: "SQLiteText";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: number | undefined;
-        }>;
-        sourceVersionVector: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-            name: "source_version_vector";
-            tableName: "document_pending_updates";
-            dataType: "string";
-            columnType: "SQLiteText";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: number | undefined;
-        }>;
-        createdAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-            name: "created_at";
-            tableName: "document_pending_updates";
-            dataType: "string";
-            columnType: "SQLiteText";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: number | undefined;
-        }>;
-        rekeyCount: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-            name: "rekey_count";
-            tableName: "document_pending_updates";
-            dataType: "number";
-            columnType: "SQLiteInteger";
-            data: number;
-            driverParam: number;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-    };
-    dialect: "sqlite";
-}>;
 /**
  * Last terminal sync failure or quarantined incoming update per document scope.
  *
- * The durable write queue (`documentPendingUpdates`) has no status columns — a
- * row is either pending or settled-and-deleted. Terminal submissions and
+ * The durable write queue (queued rows of `documentHistoryUpdates`) has no
+ * status columns — a row is either queued or settled. Terminal submissions and
  * incoming updates that cannot be decrypted or imported are recorded here so
  * the write-queue view and footer can surface why the document is blocked.
  * Rows are upserted per scope and deleted only after a later fully validated
@@ -809,6 +610,38 @@ export declare const documentHistoryCheckpoints: import("drizzle-orm/sqlite-core
     };
     dialect: "sqlite";
 }>;
+/**
+ * The local update log: one row per Loro update, serving as both the history
+ * tail (restore = checkpoint + tail) and the outbound write queue.
+ *
+ * Every locally authored update is stored once. While it waits for sync it
+ * carries an `updateId` (the id submitted to the server) and the version-vector
+ * metadata the submission needs; settlement clears them, leaving the row as
+ * ordinary tail history until compaction folds it into a checkpoint.
+ *
+ * Columns:
+ * - `id`: Row id; tail compaction deletes by it.
+ * - `appKind`, `localId`: Document scope matching `documents`.
+ * - `updateData`: Serialized Loro update payload.
+ * - `origin`: "local" (authored on this device) or "remote" (decrypted
+ *   pulled update) for tail rows. Restores use it to advance the
+ *   outgoing-delta marker across remote rows — their ops are already
+ *   server-side — while a local row left behind by a crash stays below the
+ *   marker so the next edit re-derives and sends it. "outbox" marks a queued
+ *   update with no tail role (container metadata, whose content is its
+ *   checkpoint, and full-state re-uploads after a remote reset); restores and
+ *   compaction never see it and settlement deletes it.
+ * - `createdAt`: Insertion timestamp; with `rowid`, deterministic replay order.
+ * - `updateId`: Present exactly while the row is queued for sync; rekeyed
+ *   after a lost acknowledgement poisons the submitted id.
+ * - `partialStartVersionVector` / `partialEndVersionVector`: Version vectors
+ *   around a queued partial update.
+ * - `sourceVersionVector`: Present on a queued rotation baseline checkpoint.
+ * - `rekeyCount`: Durable bound on rekeys of a queued row.
+ *
+ * Invariant: compaction never deletes a queued row, so a checkpoint can cover
+ * a queued update's operations without removing it from the queue.
+ */
 export declare const documentHistoryUpdates: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
     name: "document_history_updates";
     schema: undefined;
@@ -927,6 +760,99 @@ export declare const documentHistoryUpdates: import("drizzle-orm/sqlite-core").S
         }, {}, {
             length: number | undefined;
         }>;
+        updateId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "update_id";
+            tableName: "document_history_updates";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        partialStartVersionVector: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "partial_start_version_vector";
+            tableName: "document_history_updates";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        partialEndVersionVector: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "partial_end_version_vector";
+            tableName: "document_history_updates";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        sourceVersionVector: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "source_version_vector";
+            tableName: "document_history_updates";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        rekeyCount: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "rekey_count";
+            tableName: "document_history_updates";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
     };
     dialect: "sqlite";
 }>;
@@ -7793,182 +7719,6 @@ export declare const clientSQLiteSchema: {
         };
         dialect: "sqlite";
     }>;
-    documentPendingUpdates: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
-        name: "document_pending_updates";
-        schema: undefined;
-        columns: {
-            id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                name: "id";
-                tableName: "document_pending_updates";
-                dataType: "string";
-                columnType: "SQLiteText";
-                data: string;
-                driverParam: string;
-                notNull: false;
-                hasDefault: false;
-                isPrimaryKey: false;
-                isAutoincrement: false;
-                hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
-                baseColumn: never;
-                identity: undefined;
-                generated: undefined;
-            }, {}, {
-                length: number | undefined;
-            }>;
-            appKind: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                name: "app_kind";
-                tableName: "document_pending_updates";
-                dataType: "string";
-                columnType: "SQLiteText";
-                data: string;
-                driverParam: string;
-                notNull: true;
-                hasDefault: false;
-                isPrimaryKey: false;
-                isAutoincrement: false;
-                hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
-                baseColumn: never;
-                identity: undefined;
-                generated: undefined;
-            }, {}, {
-                length: number | undefined;
-            }>;
-            localId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                name: "local_id";
-                tableName: "document_pending_updates";
-                dataType: "string";
-                columnType: "SQLiteText";
-                data: string;
-                driverParam: string;
-                notNull: true;
-                hasDefault: false;
-                isPrimaryKey: false;
-                isAutoincrement: false;
-                hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
-                baseColumn: never;
-                identity: undefined;
-                generated: undefined;
-            }, {}, {
-                length: number | undefined;
-            }>;
-            updateData: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                name: "update_data";
-                tableName: "document_pending_updates";
-                dataType: "string";
-                columnType: "SQLiteText";
-                data: string;
-                driverParam: string;
-                notNull: true;
-                hasDefault: false;
-                isPrimaryKey: false;
-                isAutoincrement: false;
-                hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
-                baseColumn: never;
-                identity: undefined;
-                generated: undefined;
-            }, {}, {
-                length: number | undefined;
-            }>;
-            partialStartVersionVector: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                name: "partial_start_version_vector";
-                tableName: "document_pending_updates";
-                dataType: "string";
-                columnType: "SQLiteText";
-                data: string;
-                driverParam: string;
-                notNull: true;
-                hasDefault: false;
-                isPrimaryKey: false;
-                isAutoincrement: false;
-                hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
-                baseColumn: never;
-                identity: undefined;
-                generated: undefined;
-            }, {}, {
-                length: number | undefined;
-            }>;
-            partialEndVersionVector: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                name: "partial_end_version_vector";
-                tableName: "document_pending_updates";
-                dataType: "string";
-                columnType: "SQLiteText";
-                data: string;
-                driverParam: string;
-                notNull: true;
-                hasDefault: false;
-                isPrimaryKey: false;
-                isAutoincrement: false;
-                hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
-                baseColumn: never;
-                identity: undefined;
-                generated: undefined;
-            }, {}, {
-                length: number | undefined;
-            }>;
-            sourceVersionVector: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                name: "source_version_vector";
-                tableName: "document_pending_updates";
-                dataType: "string";
-                columnType: "SQLiteText";
-                data: string;
-                driverParam: string;
-                notNull: false;
-                hasDefault: false;
-                isPrimaryKey: false;
-                isAutoincrement: false;
-                hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
-                baseColumn: never;
-                identity: undefined;
-                generated: undefined;
-            }, {}, {
-                length: number | undefined;
-            }>;
-            createdAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                name: "created_at";
-                tableName: "document_pending_updates";
-                dataType: "string";
-                columnType: "SQLiteText";
-                data: string;
-                driverParam: string;
-                notNull: true;
-                hasDefault: false;
-                isPrimaryKey: false;
-                isAutoincrement: false;
-                hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
-                baseColumn: never;
-                identity: undefined;
-                generated: undefined;
-            }, {}, {
-                length: number | undefined;
-            }>;
-            rekeyCount: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                name: "rekey_count";
-                tableName: "document_pending_updates";
-                dataType: "number";
-                columnType: "SQLiteInteger";
-                data: number;
-                driverParam: number;
-                notNull: true;
-                hasDefault: true;
-                isPrimaryKey: false;
-                isAutoincrement: false;
-                hasRuntimeDefault: false;
-                enumValues: undefined;
-                baseColumn: never;
-                identity: undefined;
-                generated: undefined;
-            }, {}, {}>;
-        };
-        dialect: "sqlite";
-    }>;
     documentSyncFailures: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
         name: "document_sync_failures";
         schema: undefined;

package/data/sqlite/schema.js

@@ -94,48 +94,11 @@ export const documents = sqliteTable("documents", {
         .on(table.appKind, table.documentId)
         .where(sql `${table.documentId} IS NOT NULL`),
 ]);
-/**
- * Outbound Loro updates waiting to be accepted by sync.
- *
- * Each row stores one locally produced update for a document scope. The queue is
- * replayed in creation order and acknowledged rows are deleted after sync
- * writes the corresponding server commit or persisted document state.
- *
- * Columns:
- * - `id`: Client-generated queue id used for acknowledgement deletes.
- * - `appKind`: Local document namespace matching `documents.appKind`.
- * - `localId`: Local document id matching `documents.localId`.
- * - `updateData`: Serialized Loro update payload.
- * - `partialStartVersionVector`: Version vector before this partial update.
- * - `partialEndVersionVector`: Version vector after this partial update.
- * - `sourceVersionVector`: Optional source vector used to avoid re-enqueuing
- *   updates that came from sync.
- * - `createdAt`: Queue insertion timestamp used for deterministic replay.
- *
- * Indexes:
- * - `id` is the primary key for targeted deletes.
- * - `(appKind, localId, createdAt)` supports ordered pending-update scans for a
- *   document scope.
- */
-export const documentPendingUpdates = sqliteTable("document_pending_updates", {
-    id: text("id"),
-    appKind: text("app_kind").notNull(),
-    localId: text("local_id").notNull(),
-    updateData: text("update_data").notNull(),
-    partialStartVersionVector: text("partial_start_version_vector").notNull(),
-    partialEndVersionVector: text("partial_end_version_vector").notNull(),
-    sourceVersionVector: text("source_version_vector"),
-    createdAt: text("created_at").notNull(),
-    rekeyCount: integer("rekey_count").notNull().default(0),
-}, (table) => [
-    primaryKey({ columns: [table.id] }),
-    index("document_pending_updates_scope_created_idx").on(table.appKind, table.localId, table.createdAt),
-]);
 /**
  * Last terminal sync failure or quarantined incoming update per document scope.
  *
- * The durable write queue (`documentPendingUpdates`) has no status columns — a
- * row is either pending or settled-and-deleted. Terminal submissions and
+ * The durable write queue (queued rows of `documentHistoryUpdates`) has no
+ * status columns — a row is either queued or settled. Terminal submissions and
  * incoming updates that cannot be decrypted or imported are recorded here so
  * the write-queue view and footer can surface why the document is blocked.
  * Rows are upserted per scope and deleted only after a later fully validated
@@ -177,21 +140,56 @@ export const documentHistoryCheckpoints = sqliteTable("document_history_checkpoi
     revision: text("revision").notNull(),
     updatedAt: text("updated_at").notNull(),
 }, (table) => [primaryKey({ columns: [table.appKind, table.localId] })]);
+/**
+ * The local update log: one row per Loro update, serving as both the history
+ * tail (restore = checkpoint + tail) and the outbound write queue.
+ *
+ * Every locally authored update is stored once. While it waits for sync it
+ * carries an `updateId` (the id submitted to the server) and the version-vector
+ * metadata the submission needs; settlement clears them, leaving the row as
+ * ordinary tail history until compaction folds it into a checkpoint.
+ *
+ * Columns:
+ * - `id`: Row id; tail compaction deletes by it.
+ * - `appKind`, `localId`: Document scope matching `documents`.
+ * - `updateData`: Serialized Loro update payload.
+ * - `origin`: "local" (authored on this device) or "remote" (decrypted
+ *   pulled update) for tail rows. Restores use it to advance the
+ *   outgoing-delta marker across remote rows — their ops are already
+ *   server-side — while a local row left behind by a crash stays below the
+ *   marker so the next edit re-derives and sends it. "outbox" marks a queued
+ *   update with no tail role (container metadata, whose content is its
+ *   checkpoint, and full-state re-uploads after a remote reset); restores and
+ *   compaction never see it and settlement deletes it.
+ * - `createdAt`: Insertion timestamp; with `rowid`, deterministic replay order.
+ * - `updateId`: Present exactly while the row is queued for sync; rekeyed
+ *   after a lost acknowledgement poisons the submitted id.
+ * - `partialStartVersionVector` / `partialEndVersionVector`: Version vectors
+ *   around a queued partial update.
+ * - `sourceVersionVector`: Present on a queued rotation baseline checkpoint.
+ * - `rekeyCount`: Durable bound on rekeys of a queued row.
+ *
+ * Invariant: compaction never deletes a queued row, so a checkpoint can cover
+ * a queued update's operations without removing it from the queue.
+ */
 export const documentHistoryUpdates = sqliteTable("document_history_updates", {
     id: text("id"),
     appKind: text("app_kind").notNull(),
     localId: text("local_id").notNull(),
     updateData: text("update_data").notNull(),
-    // Provenance: "local" (authored on this device) or "remote" (decrypted
-    // pulled update). Restores use it to advance the outgoing-delta marker
-    // across remote rows — their ops are already server-side — while a local
-    // row left behind by a crash stays below the marker so the next edit
-    // re-derives and sends it.
     origin: text("origin").notNull(),
     createdAt: text("created_at").notNull(),
+    updateId: text("update_id"),
+    partialStartVersionVector: text("partial_start_version_vector"),
+    partialEndVersionVector: text("partial_end_version_vector"),
+    sourceVersionVector: text("source_version_vector"),
+    rekeyCount: integer("rekey_count").notNull().default(0),
 }, (table) => [
     primaryKey({ columns: [table.id] }),
     index("document_history_updates_scope_created_idx").on(table.appKind, table.localId, table.createdAt),
+    uniqueIndex("document_history_updates_update_id_idx")
+        .on(table.updateId)
+        .where(sql `${table.updateId} IS NOT NULL`),
 ]);
 /**
  * Anti-rollback pin for verified access manifests.
@@ -511,10 +509,12 @@ export const documentTables = [
             "recovery_document_id",
         ],
     },
-    defineSqlTableSchema(documentPendingUpdates),
     defineSqlTableSchema(documentSyncFailures),
     defineSqlTableSchema(documentHistoryCheckpoints),
-    defineSqlTableSchema(documentHistoryUpdates),
+    {
+        ...defineSqlTableSchema(documentHistoryUpdates),
+        requiredColumns: ["update_id"],
+    },
 ];
 export const principalPolicyTables = [
     {
@@ -616,7 +616,6 @@ export const clientSQLiteSchema = {
     organizationFounders,
     principalGrantRetirements,
     documents,
-    documentPendingUpdates,
     documentSyncFailures,
     principalPolicies,
     principalPolicyBundleHistory,