@rotorsoft/act-sqlite 1.22.3 → 1.22.4

package/dist/@types/sqlite-store.d.ts

@@ -126,37 +126,12 @@ export declare function streamPatternToGlob(input: string): string;
  */
 export declare class SqliteStore implements Store {
     private client;
-    /**
-     * Memoized key resolver for the optional `pii_encryption` envelope.
-     * Initialized in the constructor when encryption is configured;
-     * `undefined` otherwise. The resolver caches the operator's key on
-     * first use — rotation means restarting the store with a fresh
-     * provider.
-     */
     private readonly _resolve_pii_key;
     constructor(config: SqliteConfig);
-    /**
-     * Write-side pii encoder: encrypts when `pii_encryption` is configured,
-     * stringifies for the TEXT column either way. `null` passes through so
-     * `forget_pii` semantics survive intact (the row format skips the
-     * column entirely on a `NULL` write).
-     *
-     * @internal
-     */
     private _stringify_pii_for_write;
-    /**
-     * Read-side pii decoder: parses the TEXT column, and when
-     * `pii_encryption` is configured, transparently decrypts any value
-     * that came back as a JSON string. Plaintext writes deserialize to
-     * objects and pass through — which is what makes mixed-data
-     * rollouts (some pre-encryption rows, some post-) read cleanly.
-     *
-     * @internal
-     */
     private _parse_pii_from_read;
     seed(): Promise<void>;
     drop(): Promise<void>;
-    /** One write transaction: any failure rolls back and throws a {@link StoreError} naming the operation. */
     private _tx;
     dispose(): Promise<void>;
     commit<E extends Schemas>(stream: string, msgs: Message<E, keyof E>[], meta: EventMeta, expectedVersion?: number): Promise<Committed<E, keyof E>[]>;
@@ -170,23 +145,7 @@ export declare class SqliteStore implements Store {
     ack(leases: Lease[]): Promise<Lease[]>;
     block(leases: BlockedLease[]): Promise<BlockedLease[]>;
     defer(input: string[] | StreamFilter, deferred_at: number): Promise<number>;
-    /**
-     * Runs `UPDATE streams <set>` on the streams named by `input`, in one
-     * write transaction (`_tx`) that rolls back on failure. An explicit list is
-     * de-duplicated, so a repeated name counts once (matching PG's set-based
-     * `stream = ANY(...)`), and updated one name per statement, so a long list
-     * never meets SQLite's bound-parameter limit. `set` and `where` bind
-     * `params` in order; libSQL `?` placeholders are positional and can't be
-     * reused, so a value used twice is passed twice.
-     *
-     * @returns Count of rows updated.
-     */
     private _update;
-    /**
-     * Translate a {@link StreamFilter} to a SQLite `WHERE` clause fragment
-     * plus positional args. Returns `"1"` (always true) when empty so
-     * callers can compose it unconditionally.
-     */
     private _filter_clause;
     reset(input: string[] | StreamFilter): Promise<number>;
     unblock(input: string[] | StreamFilter): Promise<number>;
@@ -216,16 +175,7 @@ export declare class SqliteStore implements Store {
      *   since SQLite has no native array type.
      */
     query_stats<E extends Schemas>(input: string[] | Pick<StreamFilter, "stream" | "stream_exact">, options?: QueryStatsOptions<E>): Promise<Map<string, StreamStats<E>>>;
-    /**
-     * Cheap path — head (and optional tail) via ROW_NUMBER() over the
-     * `(stream, version)` unique index. Parallel queries when tail set.
-     */
     private _query_stats_heads_only;
-    /**
-     * Full-scan path — one CTE-based query with per-stream `COUNT(*)` and
-     * `json_group_object(name, n)`. Heads (and optional tails) ride free
-     * on the same scan.
-     */
     private _query_stats_full_scan;
     prioritize(filter: StreamFilter, priority: number): Promise<number>;
     truncate(targets: Array<{

package/dist/@types/sqlite-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite-store.d.ts","sourceRoot":"","sources":["../../src/sqlite-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACT,SAAS,EACT,KAAK,EACL,OAAO,EACP,KAAK,EACL,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,OAAO,EACP,KAAK,EACL,YAAY,EACZ,cAAc,EACd,WAAW,EACX,cAAc,EACd,eAAe,EAChB,MAAM,gBAAgB,CAAC;AAOxB,OAAO,EAEL,KAAK,UAAU,EAGhB,MAAM,uBAAuB,CAAC;AAE/B;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,cAAc,CAAC,EAAE,UAAU,CAAC;CAC7B;AA6GD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAmCzD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,WAAY,YAAW,KAAK;IACvC,OAAO,CAAC,MAAM,CAAS;IACvB;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAsC;IAEvE,YAAY,MAAM,EAAE,YAAY,EAQ/B;IAED;;;;;;;OAOG;YACW,wBAAwB;IAUtC;;;;;;;;OAQG;YACW,oBAAoB;IAgB5B,IAAI,kBAwLT;IAEK,IAAI,kBAIT;IAED,0GAA0G;YAC5F,GAAG;IAeX,OAAO,kBAGZ;IAGK,MAAM,CAAC,CAAC,SAAS,OAAO,EAC5B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,EAC3B,IAAI,EAAE,SAAS,EACf,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CA4ElC;IAGK,KAAK,CAAC,CAAC,SAAS,OAAO,EAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,IAAI,EAChD,KAAK,CAAC,EAAE,KAAK,GACZ,OAAO,CAAC,MAAM,CAAC,CAoFjB;IAMK,SAAS,CACb,OAAO,EAAE,cAAc,EAAE,EACzB,aAAa,CAAC,EAAE,MAAM,EACtB,UAAU,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GACvD,OAAO,CAAC,eAAe,CAAC,CA0I1B;IAKK,KAAK,CACT,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,oBA8Gd;IAGK,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,oBAgDxB;IAGK,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,2BAkCjC;IAMK,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,WAAW,EAAE,MAAM,mBAK9D;IAED;;;;;;;;;;OAUG;IACH,OAAO,CAAC,OAAO;IA0Bf;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAqCtB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,YAAY,mBAOnC;IAOD,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,YAAY,mBASrC;IAGK,aAAa,CACjB,QAAQ,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,EAC5C,KAAK,CAAC,EAAE,YAAY,GACnB,OAAO,CAAC,kBAAkB,CAAC,CA0C7B;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,WAAW,CAAC,CAAC,SAAS,OAAO,EACjC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,cAAc,CAAC,EAC/D,OAAO,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC7B,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CA2EtC;IAED;;;OAGG;YACW,uBAAuB;IAsErC;;;;OAIG;YACW,sBAAsB;IA8FpC,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQlE;IAMK,QAAQ,CACZ,OAAO,EAAE,KAAK,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,IAAI,CAAC,EAAE,SAAS,CAAC;QACjB,MAAM,CAAC,EAAE,IAAI,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;iBAKW,MAAM;mBACJ,SAAS,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC;iBACnC,IAAI;QAiFlB;IAED;;;;;;;;;;OAUG;IACG,OAAO,CACX,MAAM,EAAE,CACN,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,KACpE,OAAO,CAAC,IAAI,CAAC,GACjB,OAAO,CAAC,IAAI,CAAC,CAmCf;IAED;;;;;;;;;;;;;;;;OAgBG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMhD;CACF"}
+{"version":3,"file":"sqlite-store.d.ts","sourceRoot":"","sources":["../../src/sqlite-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACT,SAAS,EACT,KAAK,EACL,OAAO,EACP,KAAK,EACL,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,OAAO,EACP,KAAK,EACL,YAAY,EACZ,cAAc,EACd,WAAW,EACX,cAAc,EACd,eAAe,EAChB,MAAM,gBAAgB,CAAC;AAOxB,OAAO,EAEL,KAAK,UAAU,EAGhB,MAAM,uBAAuB,CAAC;AAE/B;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,cAAc,CAAC,EAAE,UAAU,CAAC;CAC7B;AA6GD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAmCzD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,WAAY,YAAW,KAAK;IACvC,OAAO,CAAC,MAAM,CAAS;IAMvB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAsC;IAEvE,YAAY,MAAM,EAAE,YAAY,EAQ/B;YAMa,wBAAwB;YAexB,oBAAoB;IAgB5B,IAAI,kBAwLT;IAEK,IAAI,kBAIT;YAGa,GAAG;IAeX,OAAO,kBAGZ;IAGK,MAAM,CAAC,CAAC,SAAS,OAAO,EAC5B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,EAC3B,IAAI,EAAE,SAAS,EACf,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CA4ElC;IAGK,KAAK,CAAC,CAAC,SAAS,OAAO,EAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,IAAI,EAChD,KAAK,CAAC,EAAE,KAAK,GACZ,OAAO,CAAC,MAAM,CAAC,CAoFjB;IAMK,SAAS,CACb,OAAO,EAAE,cAAc,EAAE,EACzB,aAAa,CAAC,EAAE,MAAM,EACtB,UAAU,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GACvD,OAAO,CAAC,eAAe,CAAC,CA0I1B;IAKK,KAAK,CACT,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,oBA8Gd;IAGK,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,oBAgDxB;IAGK,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,2BAkCjC;IAMK,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,WAAW,EAAE,MAAM,mBAK9D;IAWD,OAAO,CAAC,OAAO;IA6Bf,OAAO,CAAC,cAAc;IAqCtB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,YAAY,mBAOnC;IAOD,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,YAAY,mBASrC;IAGK,aAAa,CACjB,QAAQ,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,EAC5C,KAAK,CAAC,EAAE,YAAY,GACnB,OAAO,CAAC,kBAAkB,CAAC,CA0C7B;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,WAAW,CAAC,CAAC,SAAS,OAAO,EACjC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,cAAc,CAAC,EAC/D,OAAO,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC7B,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CA2EtC;YAIa,uBAAuB;YAyEvB,sBAAsB;IA8FpC,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQlE;IAMK,QAAQ,CACZ,OAAO,EAAE,KAAK,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,IAAI,CAAC,EAAE,SAAS,CAAC;QACjB,MAAM,CAAC,EAAE,IAAI,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;iBAKW,MAAM;mBACJ,SAAS,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC;iBACnC,IAAI;QAiFlB;IAED;;;;;;;;;;OAUG;IACG,OAAO,CACX,MAAM,EAAE,CACN,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,KACpE,OAAO,CAAC,IAAI,CAAC,GACjB,OAAO,CAAC,IAAI,CAAC,CAmCf;IAED;;;;;;;;;;;;;;;;OAgBG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMhD;CACF"}

package/dist/index.cjs

@@ -97,13 +97,11 @@ function streamPatternToGlob(input) {
 }
 var SqliteStore = class {
   client;
-  /**
-   * Memoized key resolver for the optional `pii_encryption` envelope.
-   * Initialized in the constructor when encryption is configured;
-   * `undefined` otherwise. The resolver caches the operator's key on
-   * first use — rotation means restarting the store with a fresh
-   * provider.
-   */
+  // Memoized key resolver for the optional `pii_encryption` envelope.
+  // Initialized in the constructor when encryption is configured;
+  // `undefined` otherwise. The resolver caches the operator's key on
+  // first use — rotation means restarting the store with a fresh
+  // provider.
   _resolve_pii_key;
   constructor(config) {
     this.client = (0, import_client.createClient)({
@@ -112,14 +110,10 @@ var SqliteStore = class {
     });
     this._resolve_pii_key = config.pii_encryption ? (0, import_act_crypto.makeKeyResolver)(config.pii_encryption) : void 0;
   }
-  /**
-   * Write-side pii encoder: encrypts when `pii_encryption` is configured,
-   * stringifies for the TEXT column either way. `null` passes through so
-   * `forget_pii` semantics survive intact (the row format skips the
-   * column entirely on a `NULL` write).
-   *
-   * @internal
-   */
+  // Write-side pii encoder: encrypts when `pii_encryption` is configured,
+  // stringifies for the TEXT column either way. `null` passes through so
+  // `forget_pii` semantics survive intact (the row format skips the
+  // column entirely on a `NULL` write).
   async _stringify_pii_for_write(pii) {
     if (pii == null) return null;
     if (this._resolve_pii_key) {
@@ -127,15 +121,11 @@ var SqliteStore = class {
     }
     return JSON.stringify(pii);
   }
-  /**
-   * Read-side pii decoder: parses the TEXT column, and when
-   * `pii_encryption` is configured, transparently decrypts any value
-   * that came back as a JSON string. Plaintext writes deserialize to
-   * objects and pass through — which is what makes mixed-data
-   * rollouts (some pre-encryption rows, some post-) read cleanly.
-   *
-   * @internal
-   */
+  // Read-side pii decoder: parses the TEXT column, and when
+  // `pii_encryption` is configured, transparently decrypts any value
+  // that came back as a JSON string. Plaintext writes deserialize to
+  // objects and pass through — which is what makes mixed-data
+  // rollouts (some pre-encryption rows, some post-) read cleanly.
   async _parse_pii_from_read(raw) {
     if (raw == null) return null;
     const parsed = parse_json(raw);
@@ -271,7 +261,7 @@ var SqliteStore = class {
     await this.client.execute("DROP TABLE IF EXISTS streams");
     await this.client.execute("DROP TABLE IF EXISTS correlated");
   }
-  /** One write transaction: any failure rolls back and throws a {@link StoreError} naming the operation. */
+  // One write transaction: any failure rolls back and throws a {@link StoreError} naming the operation.
   async _tx(operation, work) {
     const tx = await this.client.transaction("write");
     try {
@@ -671,17 +661,15 @@ var SqliteStore = class {
       at_iso
     ]);
   }
-  /**
-   * Runs `UPDATE streams <set>` on the streams named by `input`, in one
-   * write transaction (`_tx`) that rolls back on failure. An explicit list is
-   * de-duplicated, so a repeated name counts once (matching PG's set-based
-   * `stream = ANY(...)`), and updated one name per statement, so a long list
-   * never meets SQLite's bound-parameter limit. `set` and `where` bind
-   * `params` in order; libSQL `?` placeholders are positional and can't be
-   * reused, so a value used twice is passed twice.
-   *
-   * @returns Count of rows updated.
-   */
+  // Runs `UPDATE streams <set>` on the streams named by `input`, in one
+  // write transaction (`_tx`) that rolls back on failure. An explicit list is
+  // de-duplicated, so a repeated name counts once (matching PG's set-based
+  // `stream = ANY(...)`), and updated one name per statement, so a long list
+  // never meets SQLite's bound-parameter limit. `set` and `where` bind
+  // `params` in order; libSQL `?` placeholders are positional and can't be
+  // reused, so a value used twice is passed twice.
+  //
+  // @returns Count of rows updated.
   _update(operation, input, set, params = [], where) {
     const selections = Array.isArray(input) ? [...new Set(input)].map((stream) => ({
       clause: "stream = ?",
@@ -699,11 +687,9 @@ var SqliteStore = class {
       return count;
     });
   }
-  /**
-   * Translate a {@link StreamFilter} to a SQLite `WHERE` clause fragment
-   * plus positional args. Returns `"1"` (always true) when empty so
-   * callers can compose it unconditionally.
-   */
+  // Translate a {@link StreamFilter} to a SQLite `WHERE` clause fragment
+  // plus positional args. Returns `"1"` (always true) when empty so
+  // callers can compose it unconditionally.
   _filter_clause(filter) {
     const conditions = [];
     const args = [];
@@ -880,10 +866,8 @@ var SqliteStore = class {
       limit
     );
   }
-  /**
-   * Cheap path — head (and optional tail) via ROW_NUMBER() over the
-   * `(stream, version)` unique index. Parallel queries when tail set.
-   */
+  // Cheap path — head (and optional tail) via ROW_NUMBER() over the
+  // `(stream, version)` unique index. Parallel queries when tail set.
   async _query_stats_heads_only(from_clause, where_clause, args, want_tail, limit) {
     const cols = `e.id, e.stream, e.version, e.name, e.data, e.created, e.meta`;
     const limit_clause = limit !== void 0 ? " LIMIT ?" : "";
@@ -923,11 +907,9 @@ var SqliteStore = class {
     }
     return out;
   }
-  /**
-   * Full-scan path — one CTE-based query with per-stream `COUNT(*)` and
-   * `json_group_object(name, n)`. Heads (and optional tails) ride free
-   * on the same scan.
-   */
+  // Full-scan path — one CTE-based query with per-stream `COUNT(*)` and
+  // `json_group_object(name, n)`. Heads (and optional tails) ride free
+  // on the same scan.
   async _query_stats_full_scan(from_clause, where_clause, args, want_tail, want_count, want_names, limit) {
     const tail_cte = want_tail ? `, tails AS (
           SELECT * FROM (