@workglow/storage 0.2.31 → 0.2.32

package/dist/common.d.ts

@@ -9,11 +9,16 @@ export * from "./tabular/CachedTabularStorage";
 export * from "./tabular/CoveringIndexMissingError";
 export { pickCoveringIndex } from "./tabular/coveringIndexPicker";
 export type { RegisteredIndex, PickCoveringIndexInput, PickedIndex, } from "./tabular/coveringIndexPicker";
+export { encodeCursor, decodeCursor, assertCursorMatches, MAX_CURSOR_LENGTH, } from "./tabular/Cursor";
+export type { PageCursor } from "./tabular/Cursor";
 export * from "./tabular/HuggingFaceTabularStorage";
+export * from "./tabular/InMemoryTabularMigrationApplier";
 export * from "./tabular/InMemoryTabularStorage";
 export * from "./tabular/ITabularStorage";
 export * from "./tabular/StorageError";
 export * from "./tabular/TabularStorageRegistry";
+export * from "./tabular/sqlMigrationDdl";
+export * from "./tabular/SqlTabularMigrationApplier";
 export * from "./tabular/TelemetryTabularStorage";
 export * from "./kv/IKvStorage";
 export * from "./kv/InMemoryKvStorage";
@@ -22,6 +27,8 @@ export * from "./kv/KvViaTabularStorage";
 export * from "./kv/TelemetryKvStorage";
 export * from "./util/HybridSubscriptionManager";
 export * from "./util/PollingSubscriptionManager";
+export * from "./sql";
+export * from "./migrations";
 export * from "./vector/InMemoryVectorStorage";
 export * from "./vector/IVectorStorage";
 export * from "./vector/TelemetryVectorStorage";

package/dist/common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../src/common.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qCAAqC,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,YAAY,EACV,eAAe,EACf,sBAAsB,EACtB,WAAW,GACZ,MAAM,+BAA+B,CAAC;AACvC,cAAc,qCAAqC,CAAC;AACpD,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAElD,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AAExC,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAElD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAEhD,cAAc,0CAA0C,CAAC;AACzD,cAAc,4CAA4C,CAAC"}
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../src/common.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qCAAqC,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,YAAY,EACV,eAAe,EACf,sBAAsB,EACtB,WAAW,GACZ,MAAM,+BAA+B,CAAC;AAMvC,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sCAAsC,CAAC;AACrD,cAAc,mCAAmC,CAAC;AAElD,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AAExC,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAElD,cAAc,OAAO,CAAC;AACtB,cAAc,cAAc,CAAC;AAE7B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAEhD,cAAc,0CAA0C,CAAC;AACzD,cAAc,4CAA4C,CAAC"}

package/dist/migrations/IMigration.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Progress event emitted by {@link IMigrationRunner.run} as it works through
+ * a migration set.
+ *
+ * `phase` semantics:
+ *   - `"starting"` — `up()` is about to be invoked. `fraction` is `undefined`.
+ *   - `"running"` — intra-migration tick; `fraction` (when present) is in
+ *     `[0, 1]` reflecting how far along this single migration's `up()` is.
+ *     Migrations are NOT required to emit running events; many are too short
+ *     to be worth instrumenting. The runner does not synthesise them.
+ *   - `"completed"` — `up()` and the bookkeeping write succeeded.
+ *     `fraction` is `1`.
+ *   - `"failed"` — `up()` or the bookkeeping write threw. `error` carries
+ *     the thrown value. The runner re-throws after emitting; this event is
+ *     for observability, not recovery.
+ */
+export interface MigrationProgressEvent {
+    readonly component: string;
+    readonly version: number;
+    readonly phase: "starting" | "running" | "completed" | "failed";
+    readonly description?: string;
+    readonly fraction?: number;
+    readonly error?: unknown;
+}
+/** Subscriber for {@link MigrationProgressEvent}s emitted by an {@link IMigrationRunner}. */
+export type MigrationProgressListener = (event: MigrationProgressEvent) => void;
+/**
+ * A single, versioned, idempotent migration step.
+ *
+ * Migrations are addressed by `(component, version)`:
+ *   - `component` groups migrations belonging to the same logical schema
+ *     (e.g. `"queue:job_queue_tenant"`, `"rate-limiter"`, `"vector:chunks"`).
+ *   - `version` is a monotonically increasing positive integer within a
+ *     component. Versions MUST NOT be reused or renumbered after a release.
+ *
+ * The migration runner records each successfully applied `(component, version)`
+ * pair in an internal `_storage_migrations` table and skips any that have
+ * already been applied — so `up()` only runs once per environment.
+ *
+ * `up()` may report intra-migration progress via `report` (a fraction in
+ * `[0, 1]`). The runner forwards each `report` call to its
+ * {@link MigrationProgressListener} as a `phase: "running"` event. Migrations
+ * that aren't worth instrumenting can ignore the parameter.
+ */
+export interface IMigration<DB> {
+    readonly component: string;
+    readonly version: number;
+    readonly description?: string;
+    /** Apply the migration. Should be idempotent w.r.t. its own DDL. */
+    up(db: DB, report?: (fraction: number) => void): Promise<void> | void;
+}
+//# sourceMappingURL=IMigration.d.ts.map

package/dist/migrations/IMigration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMigration.d.ts","sourceRoot":"","sources":["../../src/migrations/IMigration.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IAChE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,6FAA6F;AAC7F,MAAM,MAAM,yBAAyB,GAAG,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,CAAC;AAEhF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,UAAU,CAAC,EAAE;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,oEAAoE;IACpE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACvE"}

package/dist/migrations/MigrationRunner.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { IMigration, MigrationProgressListener } from "./IMigration";
+/**
+ * Name of the bookkeeping table used by every runner. The leading underscore
+ * is intentional — it sorts before user tables in catalog views and signals
+ * "system table, don't touch".
+ */
+export declare const MIGRATIONS_TABLE = "_storage_migrations";
+/**
+ * Optional knobs accepted by {@link IMigrationRunner.run}.
+ *
+ * `onProgress` is invoked synchronously from inside the migration's
+ * transaction (or upgrade callback for IndexedDB), so listeners must NOT
+ * await IO that touches the same database — they would deadlock against
+ * the open transaction. Use them for logging, telemetry, or in-memory
+ * progress UI updates.
+ */
+export interface RunMigrationsOptions {
+    readonly onProgress?: MigrationProgressListener;
+}
+/**
+ * Common runner contract — runs the supplied migrations in (component, version)
+ * order, skipping any that have already been recorded. Returns the migrations
+ * that were actually applied this call (useful for logging/tests).
+ *
+ * Concrete runners live in driver-specific packages (`@workglow/postgres`,
+ * `@workglow/sqlite`) so that `@workglow/storage` does not have to depend on
+ * any database driver.
+ */
+export interface IMigrationRunner<DB> {
+    ensureBookkeepingTable(): Promise<void>;
+    appliedVersions(component: string): Promise<Set<number>>;
+    run(migrations: ReadonlyArray<IMigration<DB>>, options?: RunMigrationsOptions): Promise<ReadonlyArray<IMigration<DB>>>;
+}
+/**
+ * Stable sort by `(component asc, version asc)`. Exposed so concrete runners
+ * in driver packages don't need their own copy.
+ */
+export declare function sortMigrations<DB>(migrations: ReadonlyArray<IMigration<DB>>): IMigration<DB>[];
+//# sourceMappingURL=MigrationRunner.d.ts.map

package/dist/migrations/MigrationRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MigrationRunner.d.ts","sourceRoot":"","sources":["../../src/migrations/MigrationRunner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAE1E;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,wBAAwB,CAAC;AAEtD;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,yBAAyB,CAAC;CACjD;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB,CAAC,EAAE;IAClC,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACzD,GAAG,CACD,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,EACzC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;CAC3C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,GAAG,UAAU,CAAC,EAAE,CAAC,EAAE,CAK9F"}

package/dist/migrations/TabularMigration.d.ts

@@ -0,0 +1,85 @@
+/**
+ * @license
+ * Copyright 2026 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { JsonSchema } from "@workglow/util/schema";
+import type { MigrationProgressListener } from "./IMigration";
+/**
+ * Backend-agnostic, declarative description of a single schema-evolution step.
+ * Each op is translated to native operations by a per-backend
+ * {@link ITabularMigrationApplier}.
+ *
+ * Ops within a single migration are applied in array order inside one atomic
+ * unit (a `withTransaction` on SQL backends, an upgrade transaction on
+ * IndexedDB, best-effort sequential on schemaless backends).
+ */
+export type TabularMigrationOp = {
+    readonly kind: "addColumn";
+    readonly name: string;
+    readonly schema: JsonSchema;
+    readonly default?: string | number | boolean | null;
+} | {
+    readonly kind: "dropColumn";
+    readonly name: string;
+} | {
+    readonly kind: "renameColumn";
+    readonly from: string;
+    readonly to: string;
+} | {
+    readonly kind: "addIndex";
+    readonly name: string;
+    readonly columns: readonly string[];
+    readonly unique?: boolean;
+} | {
+    readonly kind: "dropIndex";
+    readonly name: string;
+} | {
+    readonly kind: "backfill";
+    readonly batchSize?: number;
+    readonly transform: (row: Record<string, unknown>) => Promise<Record<string, unknown> | undefined> | Record<string, unknown> | undefined;
+};
+/**
+ * One versioned migration for a tabular storage. Identified by
+ * `(component, version)` like {@link IMigration}; bookkeeping shares
+ * the existing `_storage_migrations` table.
+ *
+ * `component` defaults to `tabular:${storageName}` when omitted (the
+ * orchestrator fills it in from the owning storage).
+ */
+export interface ITabularMigration {
+    readonly component?: string;
+    readonly version: number;
+    readonly description?: string;
+    readonly ops: ReadonlyArray<TabularMigrationOp>;
+}
+/**
+ * Per-backend primitive that the orchestrator drives. A backend implements
+ * `applyMigration` as an atomic unit (DDL + backfill + bookkeeping write
+ * in one transaction where the backend supports it).
+ *
+ * `tableExists` is the freshness probe used by the orchestrator to decide
+ * whether to take the fast path (CREATE + mark all migrations applied) or
+ * the run-pending path.
+ */
+export interface ITabularMigrationApplier {
+    ensureBookkeeping(): Promise<void>;
+    appliedVersions(component: string): Promise<Set<number>>;
+    tableExists(): Promise<boolean>;
+    /**
+     * Apply all ops AND record `(component, version)` in bookkeeping in one
+     * atomic unit on backends with native transactions; best-effort sequential
+     * on schemaless backends (DDL no-ops + backfill + bookkeeping write).
+     */
+    applyMigration(component: string, version: number, description: string | undefined, ops: ReadonlyArray<TabularMigrationOp>, onProgress?: (fraction: number) => void): Promise<void>;
+    /**
+     * Mark all supplied `(component, version)` pairs as applied in bookkeeping
+     * without running their ops. Used by the fresh-DB fast path.
+     */
+    markAllApplied(component: string, versions: ReadonlyArray<{
+        version: number;
+        description: string | undefined;
+    }>): Promise<void>;
+}
+export type TabularMigrationProgressListener = MigrationProgressListener;
+//# sourceMappingURL=TabularMigration.d.ts.map

package/dist/migrations/TabularMigration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TabularMigration.d.ts","sourceRoot":"","sources":["../../src/migrations/TabularMigration.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAE9D;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IACE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;CACrD,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC7E;IACE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACrD;IACE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,CAClB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KACzB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CACzF,CAAC;AAEN;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;CACjD;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,wBAAwB;IACvC,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACzD,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC;;;;OAIG;IACH,cAAc,CACZ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,GAAG,EAAE,aAAa,CAAC,kBAAkB,CAAC,EACtC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GACtC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB;;;OAGG;IACH,cAAc,CACZ,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,aAAa,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC,GAC5E,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED,MAAM,MAAM,gCAAgC,GAAG,yBAAyB,CAAC"}

package/dist/migrations/TabularMigrationOrchestrator.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @license
+ * Copyright 2026 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ITabularMigration, ITabularMigrationApplier, TabularMigrationProgressListener } from "./TabularMigration";
+/**
+ * Sequences pending tabular migrations through a backend's
+ * {@link ITabularMigrationApplier}.
+ *
+ * Two paths:
+ *   - **fresh-DB fast path** — applied is empty AND the caller signaled (via
+ *     `freshTable: true`) that the underlying table/store did not exist
+ *     before this run, OR `applier.tableExists()` returns false. The
+ *     orchestrator records every declared migration as already-applied
+ *     without running its ops.
+ *   - **run-pending path** — sorted-by-version, skip already-applied,
+ *     call `applyMigration` for each remaining one.
+ *
+ * Bookkeeping is owned by the applier (one row per `(component, version)`
+ * in the existing `_storage_migrations` table).
+ *
+ * The `freshTable` option exists because `setupDatabase()` typically creates
+ * the table at the target schema *before* invoking the orchestrator, which
+ * defeats the `tableExists()` probe (the store always looks "existing" by
+ * the time the orchestrator runs). Callers should pass the freshness probe
+ * they took *before* creating the table.
+ */
+export interface RunTabularMigrationsOptions {
+    readonly onProgress?: TabularMigrationProgressListener;
+    readonly freshTable?: boolean;
+}
+export declare function runTabularMigrations(applier: ITabularMigrationApplier, defaultComponent: string, migrations: ReadonlyArray<ITabularMigration>, options?: RunTabularMigrationsOptions): Promise<void>;
+//# sourceMappingURL=TabularMigrationOrchestrator.d.ts.map

package/dist/migrations/TabularMigrationOrchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TabularMigrationOrchestrator.d.ts","sourceRoot":"","sources":["../../src/migrations/TabularMigrationOrchestrator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,wBAAwB,EACxB,gCAAgC,EACjC,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,UAAU,CAAC,EAAE,gCAAgC,CAAC;IACvD,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,wBAAwB,EACjC,gBAAgB,EAAE,MAAM,EACxB,UAAU,EAAE,aAAa,CAAC,iBAAiB,CAAC,EAC5C,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,IAAI,CAAC,CA6Ef"}

package/dist/migrations/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./IMigration";
+export * from "./MigrationRunner";
+export * from "./TabularMigration";
+export * from "./TabularMigrationOrchestrator";
+export * from "./runBackfill";
+//# sourceMappingURL=index.d.ts.map

package/dist/migrations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,eAAe,CAAC"}

package/dist/migrations/runBackfill.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2026 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { AnyTabularStorage } from "../tabular/ITabularStorage";
+/**
+ * Backend-agnostic, page-based backfill loop. Iterates every row in the
+ * storage in `batchSize`-row pages using cursor pagination so iteration
+ * is stable under concurrent writes.
+ *
+ * For each row, calls `transform` and:
+ *   - if it returns the **same reference** as the input, skips the write
+ *     (the row is unchanged);
+ *   - if it returns `undefined`, deletes the row;
+ *   - otherwise, writes the new row via `put`.
+ */
+export declare function runBackfill(storage: AnyTabularStorage, batchSize: number, transform: (row: Record<string, unknown>) => Promise<Record<string, unknown> | undefined> | Record<string, unknown> | undefined): Promise<void>;
+//# sourceMappingURL=runBackfill.d.ts.map

package/dist/migrations/runBackfill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runBackfill.d.ts","sourceRoot":"","sources":["../../src/migrations/runBackfill.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAc,MAAM,4BAA4B,CAAC;AAEhF;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,iBAAiB,EAC1B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,CACT,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KACzB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACtF,OAAO,CAAC,IAAI,CAAC,CAgBf"}