latticesql 3.1.0 → 3.2.0

package/dist/index.d.cts

@@ -1798,18 +1798,26 @@ interface RenderOptions {
 declare class ProgressThrottle {
     private readonly cb;
     private readonly windowMs;
-    private lastEmit;
+    /**
+     * Last passthrough time, keyed per table (`event.table`, or `''` for the
+     * table-less `done`/`error` lifecycle events). Per-table — not a single shared
+     * clock — so when tables render CONCURRENTLY each one keeps its own ~5/sec
+     * budget: a fast table can't consume the window and starve a slow table's
+     * progress. `force` (table-start) resets only that table's budget.
+     */
+    private readonly lastEmit;
     constructor(cb: RenderProgressCallback | undefined, windowMs?: number);
     /**
-     * Emit a `table-progress` event, but only if the window since the last
-     * passthrough has elapsed. Dropped events are simply not delivered — the next
-     * one that survives carries the latest running count.
+     * Emit a `table-progress` event, but only if the window since this table's
+     * last passthrough has elapsed. Dropped events are simply not delivered — the
+     * next one that survives carries the latest running count.
      */
     tick(event: RenderProgress): void;
     /**
-     * Emit a lifecycle event immediately and reset the throttle window. Use for
-     * `table-start`, `table-done`, `done`, and `error` — none of which should
-     * ever be dropped. Resetting on `table-start` gives each table a clean budget.
+     * Emit a lifecycle event immediately and reset this table's throttle window.
+     * Use for `table-start`, `table-done`, `done`, and `error` — none of which
+     * should ever be dropped. Resetting on `table-start` gives each table a clean
+     * budget.
      */
     force(event: RenderProgress): void;
 }
@@ -4337,19 +4345,6 @@ declare class FoldCache {
     get size(): number;
 }
 
-/**
- * Turn a Postgres database into a secured Lattice cloud, in place: install the
- * RLS bootstrap + the observation substrate, then for every registered user
- * table stamp the current role as owner of the existing rows and force RLS (plus
- * a cell-masking view for any audience columns). Idempotent and additive — safe
- * to run on a fresh migration target OR on an already-populated Postgres that
- * isn't a cloud yet (the "secure this cloud" cutover). No-op on SQLite.
- *
- * Must run as a role that owns the tables and can create roles (a cloud
- * owner / DBA). `backfillOwnership` runs BEFORE `enableRlsForTable` so a
- * non-superuser owner can still SELECT every row to stamp it before FORCE RLS
- * filters the table to rows it already owns.
- */
 declare function secureCloud(db: Lattice): Promise<void>;
 
 /**

package/dist/index.d.ts

@@ -1798,18 +1798,26 @@ interface RenderOptions {
 declare class ProgressThrottle {
     private readonly cb;
     private readonly windowMs;
-    private lastEmit;
+    /**
+     * Last passthrough time, keyed per table (`event.table`, or `''` for the
+     * table-less `done`/`error` lifecycle events). Per-table — not a single shared
+     * clock — so when tables render CONCURRENTLY each one keeps its own ~5/sec
+     * budget: a fast table can't consume the window and starve a slow table's
+     * progress. `force` (table-start) resets only that table's budget.
+     */
+    private readonly lastEmit;
     constructor(cb: RenderProgressCallback | undefined, windowMs?: number);
     /**
-     * Emit a `table-progress` event, but only if the window since the last
-     * passthrough has elapsed. Dropped events are simply not delivered — the next
-     * one that survives carries the latest running count.
+     * Emit a `table-progress` event, but only if the window since this table's
+     * last passthrough has elapsed. Dropped events are simply not delivered — the
+     * next one that survives carries the latest running count.
      */
     tick(event: RenderProgress): void;
     /**
-     * Emit a lifecycle event immediately and reset the throttle window. Use for
-     * `table-start`, `table-done`, `done`, and `error` — none of which should
-     * ever be dropped. Resetting on `table-start` gives each table a clean budget.
+     * Emit a lifecycle event immediately and reset this table's throttle window.
+     * Use for `table-start`, `table-done`, `done`, and `error` — none of which
+     * should ever be dropped. Resetting on `table-start` gives each table a clean
+     * budget.
      */
     force(event: RenderProgress): void;
 }
@@ -4337,19 +4345,6 @@ declare class FoldCache {
     get size(): number;
 }
 
-/**
- * Turn a Postgres database into a secured Lattice cloud, in place: install the
- * RLS bootstrap + the observation substrate, then for every registered user
- * table stamp the current role as owner of the existing rows and force RLS (plus
- * a cell-masking view for any audience columns). Idempotent and additive — safe
- * to run on a fresh migration target OR on an already-populated Postgres that
- * isn't a cloud yet (the "secure this cloud" cutover). No-op on SQLite.
- *
- * Must run as a role that owns the tables and can create roles (a cloud
- * owner / DBA). `backfillOwnership` runs BEFORE `enableRlsForTable` so a
- * non-superuser owner can still SELECT every row to stamp it before FORCE RLS
- * filters the table to rows it already owns.
- */
 declare function secureCloud(db: Lattice): Promise<void>;
 
 /**