ai-database 2.1.1 → 2.3.0

package/dist/cascade-orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cascade-orchestrator.js","sourceRoot":"","sources":["../src/cascade-orchestrator.ts"],"names":[],"mappings":"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"}

package/dist/cascade-write-strategy.d.ts

@@ -0,0 +1,584 @@
+/**
+ * Cascade Write Strategy — sharded parallel writes for cascade generation
+ *
+ * Phase 2 entry point of the cascade epic per
+ * [ADR-0003](../../../docs/adr/0003-storage-strategy-pg-clickhouse-default.md)
+ * and the
+ * [implementation plan](../../../docs/plans/2026-05-05-cascade-storage-execution-implementation.md).
+ *
+ * This module is **strategy + scaffolding** — the *primitive* the cascade
+ * orchestrator (`aip-8yal`) calls. It does not run the orchestration loop
+ * itself, does not call LLMs, and does not implement the dual-write to
+ * Pipelines/Iceberg fan-out (that's `aip-0ypt`). It does:
+ *
+ * 1. **Shard-key derivation** — given a cascade context, pick the
+ *    {@link ShardRef} the next batch should land in. Built-in strategies
+ *    cover the three sharding models declared on `DBProvider`:
+ *    `per-cascade` (DO SQLite default), `partitioned-by-tenant` (PG
+ *    schema-per-tenant or `tenant_id` partition key), `unsharded`.
+ *
+ * 2. **Bulk-write API** — {@link writeBatch} routes a batch of Things +
+ *    Actions through the adapter's cascade fast path. For PG, that's the
+ *    **CTE jsonb-bulk shape** proven by the substrate-write-probes
+ *    (91 ms p50 for 500 things + 499 actions on Neon HTTP — see
+ *    `docs/reviews/2026-05-05-cascade-poc-evaluation.md`). For DO SQLite,
+ *    the routing layer pins the shard and forwards the batch into the
+ *    per-cascade DO. For ClickHouse, JSONEachRow is the path.
+ *
+ * 3. **Read-back-during-traversal API** — {@link readShardLocal} performs a
+ *    point read against the same shard the batch was written to. Cascade
+ *    generation reads back just-written entities to inform the next
+ *    generation step; cross-shard reads on the hot path are explicitly
+ *    not supported.
+ *
+ * 4. **Pipelines fan-out hook** — a {@link AnalyticalEmitter} callback the
+ *    caller may pass to {@link writeBatch}. The cascade-write-strategy
+ *    invokes it post-commit so Stack B's dual-write
+ *    (DO SQLite local → Pipelines → Iceberg → ClickHouse) can be wired
+ *    later by `aip-0ypt` without changing this surface.
+ *
+ * ## Why a separate module
+ *
+ * The cascade orchestrator is long, has its own retry/validation/policy
+ * concerns, and needs swappable storage. Pulling the write-strategy
+ * primitive out keeps the orchestration module focused, lets us unit-test
+ * shard-key derivation independently of LLM calls, and keeps the
+ * provenance of the write shape (the substrate-write-probes verdict)
+ * documented in one place rather than scattered through orchestrator code.
+ *
+ * @see {@link ../docs/adr/0003-storage-strategy-pg-clickhouse-default.md}
+ * @see {@link ../docs/reviews/2026-05-05-cascade-poc-evaluation.md}
+ * @packageDocumentation
+ */
+import type { DBProvider } from './schema/provider.js';
+import type { DBProviderPort, ShardingModel, SVOAction } from './db-provider-port.js';
+/**
+ * Stable handle the cascade orchestrator carries between
+ * {@link CascadeWriteStrategy.pickShard} and subsequent calls to
+ * {@link CascadeWriteStrategy.writeBatch} / {@link CascadeWriteStrategy.readShardLocal}.
+ *
+ * `key` is the routing key the strategy emitted (e.g. `'cascade:abc'`,
+ * `'tenant:acme'`, `'__shared__'`); adapters consume it through
+ * `context.cascadeId` / `context.tenantId` / a custom hook. `model` is the
+ * sharding model that produced the key — useful for diagnostics and for
+ * orchestrators that route differently when shards are per-cascade vs.
+ * per-tenant.
+ *
+ * The opaque `context` field carries the full cascade context that
+ * produced this `ShardRef`; the DO SQLite shard-routing helper consumes
+ * it via {@link DOSqliteAdapter.withContext} so per-op operations land in
+ * the correct DO.
+ */
+export interface ShardRef {
+    /** Routing key emitted by the active sharding strategy. */
+    key: string;
+    /** Sharding model declared on the underlying DBProvider adapter. */
+    model: ShardingModel;
+    /** Cascade context that produced the key (for read-back routing). */
+    context: CascadeShardContext;
+}
+/**
+ * Per-batch context the cascade orchestrator passes into
+ * {@link CascadeWriteStrategy.pickShard}.
+ *
+ * Required fields are deliberately small. The full shape is open via
+ * `[key: string]: unknown` so callers can carry deployment-specific
+ * routing hints (e.g. region pin, A/B bucket) without changing this
+ * port.
+ *
+ * `rootEntity` is the cascade's root (e.g. `FoundingHypothesis-abc123`);
+ * the strategy may inspect its `$type` for type-aware sharding. It is
+ * NOT used as the routing key directly — that's `cascadeId`.
+ */
+export interface CascadeShardContext {
+    /**
+     * The cascade root entity reference. The strategy may derive type-aware
+     * routing from this (e.g. type-per-shard) but the canonical
+     * `'per-cascade'` strategy uses {@link CascadeShardContext.cascadeId}.
+     */
+    rootEntity?: {
+        $id: string;
+        $type: string;
+    };
+    /**
+     * Stable cascade id. Required for `'per-cascade'` strategy. The
+     * orchestrator typically derives this from a content hash of the
+     * root entity + cascade definition so re-runs route to the same shard.
+     */
+    cascadeId?: string;
+    /**
+     * Tenant id. Required for `'partitioned-by-tenant'` strategy.
+     */
+    tenantId?: string;
+    /**
+     * Free-form context the caller may consult inside a custom strategy.
+     */
+    [key: string]: unknown;
+}
+/**
+ * A sharding strategy maps a {@link CascadeShardContext} to a
+ * {@link ShardRef}.
+ *
+ * Strategies MUST be deterministic — the same context MUST produce the
+ * same key — so the cascade orchestrator's read-back during traversal
+ * lands on the shard that received the write.
+ *
+ * Built-in strategies are exported as constants on
+ * {@link CascadeShardingStrategies}; callers can also pass any
+ * `(ctx) => ShardRef` callback.
+ */
+export type CascadeShardingStrategy = (ctx: CascadeShardContext) => ShardRef;
+/**
+ * Built-in cascade sharding strategies.
+ *
+ * Each maps the abstract {@link ShardingModel} declared on a `DBProvider`
+ * to a concrete routing-key derivation. Adapters consult their adapter's
+ * declared sharding model via {@link getProviderCapabilities} when
+ * picking a default; callers can override.
+ *
+ * - {@link perCascade} — one shard per cascade. Default for
+ *   `do-sqlite` adapter (per ADR-0003 enabling pattern). Throws if
+ *   {@link CascadeShardContext.cascadeId} is missing.
+ * - {@link partitionedByTenant} — one shard per tenant. Default for
+ *   `pg+pgvector` adapter. Throws if {@link CascadeShardContext.tenantId}
+ *   is missing.
+ * - {@link unsharded} — single global shard. Default for `memory` and any
+ *   adapter that does not declare a sharding model. Always returns the
+ *   constant key `'__shared__'`.
+ */
+export declare const CascadeShardingStrategies: {
+    /**
+     * One shard per cascade. Stack B's enabling pattern: every active
+     * cascade gets its own DO (or its own PG partition / temp schema)
+     * giving full single-shard write throughput in parallel.
+     *
+     * @param defaultCascadeId - Fallback when the per-op context omits
+     *   `cascadeId`. Useful when the orchestrator has a stable cascade
+     *   scope but individual write batches don't restate it.
+     */
+    readonly perCascade: (defaultCascadeId?: string) => CascadeShardingStrategy;
+    /**
+     * One shard per tenant. The natural shape for multi-tenant Postgres
+     * (schema-per-tenant or `tenant_id` partition key). Many cascades
+     * within the same tenant share a partition; tenants are isolated.
+     *
+     * @param defaultTenantId - Fallback when the per-op context omits
+     *   `tenantId`.
+     */
+    readonly partitionedByTenant: (defaultTenantId?: string) => CascadeShardingStrategy;
+    /**
+     * Single global shard. Default for in-memory / dev / single small PG
+     * deployments. Cascade throughput hits the underlying adapter's
+     * single-writer ceiling.
+     */
+    readonly unsharded: () => CascadeShardingStrategy;
+};
+/**
+ * A Thing to write in a cascade batch.
+ *
+ * The cascade orchestrator pre-derives stable ids (content hashes
+ * including the parent's full idempotency key per the lineage-key
+ * discipline from `cf-substrate/tierA-cascade`) before commit so
+ * grandchildren backrefs point at the right parent. This module
+ * trusts the caller's id discipline and writes verbatim.
+ */
+export interface CascadeThing {
+    /** Stable, content-hashed id derived upstream by the orchestrator. */
+    id: string;
+    /** Thing `$type` (e.g. `'Customer'`, `'Order'`, `'NameCandidate'`). */
+    type: string;
+    /** Thing payload. The adapter writes this as a jsonb / String column. */
+    data: Record<string, unknown>;
+}
+/**
+ * An Action to write in a cascade batch.
+ *
+ * Wire-compatible with {@link SVOAction} minus `id` (caller-supplied or
+ * adapter-generated) and lifecycle timestamps (adapters set these at
+ * commit time). Actions carry **subject** + **object** + **Frame
+ * roles** — the post-SVO recording shape; adapters route them to the
+ * per-row columns / role jsonb map per their schema.
+ *
+ * `relateTuple` is the legacy `(fromType, fromId, relation, toType, toId)`
+ * shape some callers may carry; for backward compatibility the cascade
+ * orchestrator can populate it and the strategy converts to an Action
+ * before write. Pure SVO callers omit it.
+ */
+export interface CascadeAction {
+    /** Optional caller-supplied id. Adapter generates if omitted. */
+    id?: string;
+    /** Verb name. References a Verb in the adapter's registry. */
+    verb: string;
+    /** Subject Thing id (actor / who-acts). */
+    subject?: string;
+    /** Object Thing id (what-is-acted-on). */
+    object?: string;
+    /** Frame role assignments beyond subject/object (recipient/source/...). */
+    roles?: Record<string, string>;
+    /** Verb-specific payload. */
+    data?: Record<string, unknown>;
+    /**
+     * Action lifecycle status. Defaults to `'completed'` for cascade
+     * relations (the relation is observed-as-true at write time). The
+     * orchestrator may pass `'pending'` for Actions that record an
+     * in-flight LLM step and transition to `'completed'`/`'failed'`
+     * after the call returns.
+     */
+    status?: SVOAction['status'];
+}
+/**
+ * The unit of work the cascade orchestrator hands the strategy.
+ *
+ * Both arrays may be empty independently — a batch may be Things-only
+ * (entity creation) or Actions-only (relation recording).
+ */
+export interface CascadeBatch {
+    things?: ReadonlyArray<CascadeThing>;
+    actions?: ReadonlyArray<CascadeAction>;
+}
+/**
+ * Result returned by {@link CascadeWriteStrategy.writeBatch}.
+ *
+ * `thingsInserted` / `actionsInserted` reflect the count actually inserted
+ * (excludes idempotent conflicts). Adapters whose drivers don't surface
+ * row counts (some ClickHouse paths) report the input batch size — see
+ * adapter-specific docs.
+ */
+export interface CascadeBatchResult {
+    thingsInserted: number;
+    actionsInserted: number;
+    shard: ShardRef;
+}
+/**
+ * Optional `commitBatch` shape adapters expose to opt into the cascade
+ * fast path. PG and CH adapters in this package implement this; in-memory
+ * and DO SQLite do not (they fall back to per-op writes).
+ *
+ * When present, the strategy routes the entire batch through
+ * `commitBatch` — for PG that's the CTE jsonb-bulk shape, for CH it's
+ * the JSONEachRow path.
+ */
+export interface BulkCommitCapable {
+    commitBatch(input: {
+        things?: ReadonlyArray<{
+            id: string;
+            type: string;
+            data: Record<string, unknown>;
+        }>;
+        actions?: ReadonlyArray<{
+            id?: string;
+            verb: string;
+            subject?: string | undefined;
+            object?: string | undefined;
+            roles?: Record<string, string> | undefined;
+            data?: Record<string, unknown> | undefined;
+            status?: SVOAction['status'] | undefined;
+        }>;
+    }): Promise<{
+        thingsInserted: number;
+        actionsInserted: number;
+    }>;
+}
+/**
+ * Optional context-binding shape adapters expose to receive shard
+ * routing for every subsequent operation. The DO SQLite adapter
+ * implements `withCascade`/`withTenant`/`withContext`; PG and CH
+ * adapters return `this` (no per-shard binding needed — their `ns`
+ * column carries the partition key already).
+ */
+export interface ShardContextBindable<T> {
+    withContext(context: Record<string, unknown>): T;
+    withCascade?(cascadeId: string): T;
+    withTenant?(tenantId: string): T;
+}
+/**
+ * Hook the cascade-write-strategy invokes after a successful commit so
+ * Stack B's dual-write (DO SQLite local → Pipelines → Iceberg → CH) can
+ * fan-out the same batch to the analytical store.
+ *
+ * Implementation lives in `aip-0ypt`; this strategy only surfaces the
+ * extension point. Failures inside the emitter are logged and swallowed
+ * — the analytical fan-out is not load-bearing for cascade correctness.
+ */
+export type AnalyticalEmitter = (input: {
+    shard: ShardRef;
+    batch: CascadeBatch;
+    result: {
+        thingsInserted: number;
+        actionsInserted: number;
+    };
+}) => Promise<void> | void;
+/**
+ * Constructor options for {@link CascadeWriteStrategy}.
+ */
+export interface CascadeWriteStrategyOptions {
+    /**
+     * The DBProvider adapter to write through. Must be
+     * {@link BulkCommitCapable} for the cascade fast path; if not, the
+     * strategy falls back to per-op writes (`create()` + `relate()`).
+     */
+    adapter: DBProvider | DBProviderPort;
+    /**
+     * Sharding strategy. One of:
+     * - A built-in strategy from {@link CascadeShardingStrategies}.
+     * - A custom `(ctx) => ShardRef` callback.
+     * - A shorthand string mapped to a built-in:
+     *   - `'per-cascade'` → `CascadeShardingStrategies.perCascade()`
+     *   - `'partitioned-by-tenant'` → `CascadeShardingStrategies.partitionedByTenant()`
+     *   - `'unsharded'` → `CascadeShardingStrategies.unsharded()`
+     *
+     * Default: derived from the adapter's declared
+     * {@link ProviderTierCapabilities.shardingModel} via
+     * {@link getProviderCapabilities}. Adapters that don't declare default
+     * to `'unsharded'`.
+     */
+    sharding?: CascadeShardingStrategy | 'per-cascade' | 'partitioned-by-tenant' | 'unsharded';
+    /**
+     * Default cascade id used when {@link CascadeShardingStrategies.perCascade}
+     * is the active strategy and the per-op context omits it.
+     */
+    defaultCascadeId?: string;
+    /**
+     * Default tenant id used when
+     * {@link CascadeShardingStrategies.partitionedByTenant} is the active
+     * strategy and the per-op context omits it.
+     */
+    defaultTenantId?: string;
+    /**
+     * Maximum number of Things + Actions per round-trip to the adapter.
+     * Per the substrate-write-probes verdict the CTE jsonb-bulk shape
+     * achieves sublinear scaling above N=100 and 91 ms p50 at N=500. We
+     * default to **1000** — well within the sweet spot for both PG and
+     * DO SQLite per-op limits — and chunk larger batches into rounds.
+     *
+     * @default 1000
+     */
+    maxBatchSize?: number;
+    /**
+     * Optional analytical fan-out hook (see {@link AnalyticalEmitter}).
+     * Implementation deferred to `aip-0ypt`; surfaced here as a
+     * non-blocking extension point.
+     */
+    analyticalEmitter?: AnalyticalEmitter;
+}
+/**
+ * The cascade write strategy primitive.
+ *
+ * Composes a `DBProvider` adapter with a sharding strategy and exposes
+ * the bulk-write + read-back surface the cascade orchestrator
+ * (`aip-8yal`) calls per traversal step. This module owns:
+ *
+ * - Routing-key derivation ({@link pickShard})
+ * - Bulk write via the adapter's cascade fast path ({@link writeBatch})
+ * - Local read-back from the same shard ({@link readShardLocal})
+ * - Analytical fan-out hook (post-commit; opt-in)
+ *
+ * It does NOT own:
+ *
+ * - LLM-driven generation (the orchestrator calls it before issuing batches)
+ * - Validation / policy / retry (the orchestrator wraps the strategy)
+ * - Pipelines→Iceberg dual-write semantics (`aip-0ypt`)
+ * - Cross-shard joins (out of scope per ADR-0003 hot-path constraint)
+ *
+ * @example
+ * ```ts
+ * import {
+ *   CascadeWriteStrategy,
+ *   createPostgresProvider,
+ * } from 'ai-database'
+ *
+ * const adapter = createPostgresProvider({ executor, namespace: 'tenant-9' })
+ * const strategy = new CascadeWriteStrategy({
+ *   adapter,
+ *   sharding: 'partitioned-by-tenant',
+ *   defaultTenantId: 'tenant-9',
+ * })
+ *
+ * const shard = strategy.pickShard({
+ *   rootEntity: { $id: 'fh-1', $type: 'FoundingHypothesis' },
+ *   tenantId: 'tenant-9',
+ * })
+ *
+ * await strategy.writeBatch(shard, {
+ *   things: [{ id: 'cust-1', type: 'Customer', data: { name: 'Acme' } }],
+ *   actions: [{ verb: 'placedBy', subject: 'order-1', object: 'cust-1', status: 'completed' }],
+ * })
+ * ```
+ */
+export declare class CascadeWriteStrategy {
+    private readonly adapter;
+    private readonly strategy;
+    readonly maxBatchSize: number;
+    private readonly emitter;
+    constructor(options: CascadeWriteStrategyOptions);
+    /**
+     * Derive the {@link ShardRef} the next batch should land in. Pure —
+     * never touches the adapter.
+     *
+     * Throws when the active strategy needs context the caller didn't
+     * supply (e.g. `'per-cascade'` with no `cascadeId`).
+     */
+    pickShard(context: CascadeShardContext): ShardRef;
+    /**
+     * Bulk-commit a batch of Things + Actions to the shard.
+     *
+     * - When the adapter is {@link BulkCommitCapable}, the entire batch
+     *   travels in a single fast-path call — for PG that's the CTE
+     *   jsonb-bulk shape (91 ms p50 / 500 things on Neon HTTP), for CH
+     *   the JSONEachRow path.
+     * - When the adapter is not bulk-capable (in-memory, DO SQLite via
+     *   the current wire shape), the strategy falls back to per-op
+     *   `create()` + `relate()` calls. This still flows through the
+     *   shard-aware adapter so reads land on the same shard, but
+     *   throughput is the per-op ceiling.
+     * - Batches larger than {@link maxBatchSize} are split into rounds.
+     *   Rounds run sequentially within a single `writeBatch` call to
+     *   preserve write-order guarantees the orchestrator may rely on
+     *   (e.g. parents before children). Sibling parallelism is the
+     *   orchestrator's concern, not this primitive's.
+     *
+     * Post-commit, if an {@link AnalyticalEmitter} was configured, it is
+     * invoked once per chunk so Stack B's analytical fan-out can mirror
+     * the same batch into Pipelines→Iceberg. Emitter failures are logged
+     * and swallowed — they MUST NOT fail the cascade write.
+     */
+    writeBatch(shard: ShardRef, batch: CascadeBatch): Promise<CascadeBatchResult>;
+    /**
+     * Read a Thing back from the same shard the batch was written to.
+     *
+     * Cascade generation reads back just-written entities to inform the
+     * next traversal step (e.g. resolve a freshly-written `Customer`
+     * before generating its `Orders`). Cross-shard reads are explicitly
+     * not supported on the hot path per ADR-0003.
+     *
+     * Returns `null` if the entity is not in the shard. The caller may
+     * still attempt a cross-shard read via the unsharded adapter surface
+     * if needed for cold-path reconciliation.
+     */
+    readShardLocal(shard: ShardRef, type: string, id: string): Promise<Record<string, unknown> | null>;
+    /**
+     * Read a list of just-written entities from the shard. Wraps
+     * `adapter.list(type)` after binding the shard context.
+     *
+     * Use when the cascade needs to enumerate all of a type the current
+     * cascade has produced (e.g. all `OrderItem` for the current
+     * `Order`). For point reads, prefer {@link readShardLocal}.
+     */
+    listShardLocal(shard: ShardRef, type: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<Record<string, unknown>[]>;
+    /**
+     * Bind the adapter to the shard so subsequent ops route correctly.
+     *
+     * For DO SQLite, {@link DOSqliteAdapter.withContext} is used to pin
+     * the cascade/tenant id. For PG/CH, the `ns` column on the adapter
+     * already carries the partition key, so this is a no-op (return
+     * `this`).
+     */
+    private bindAdapterToShard;
+    /**
+     * Write a single chunk through the adapter's cascade fast path or
+     * the per-op fallback.
+     */
+    private writeChunk;
+}
+/**
+ * Stand-alone helper that emits the PG cascade-write SQL the
+ * substrate-write-probes proved out: a single CTE round-trip with
+ * bulk `VALUES (...), (...)` inserts and `ON CONFLICT DO NOTHING`.
+ *
+ * **This is the shape the canonical PG adapter's
+ * {@link PostgresProvider.commitBatch} uses.** The helper is exported so
+ * cascade orchestrators that bypass the adapter (e.g. running raw SQL
+ * for benchmarking) can still use the proven shape without re-deriving
+ * it. The adapter's `commitBatch` remains the recommended path.
+ *
+ * Returns the SQL text + ordered positional params. Things take 4
+ * columns: `(ns, id, type, data)`. Actions take 10 columns:
+ * `(ns, id, verb, subject, object, roles, data, status, created_at, completed_at)`.
+ *
+ * Why: documenting the shape in a stand-alone helper anchors the write
+ * shape to the substrate-write-probes evidence (91 ms p50 for 500 docs +
+ * 499 rels on Neon HTTP, sublinear scaling above N=100). Future schema
+ * changes that invalidate the column list will land here visibly.
+ *
+ * @internal Use {@link PostgresProvider.commitBatch} for production code.
+ */
+export declare function buildPgCommitBatchSql(input: {
+    schema: string;
+    namespace: string;
+    things: ReadonlyArray<CascadeThing>;
+    actions: ReadonlyArray<CascadeAction>;
+    /** ISO-8601 string for `created_at` / `completed_at` columns. */
+    now: string;
+}): {
+    sql: string;
+    params: unknown[];
+} | null;
+/**
+ * Resolve the DO id name for a given shard from a Cloudflare DO
+ * namespace binding.
+ *
+ * The actual shard pinning happens inside `DOSqliteAdapter` —
+ * {@link DOSqliteAdapter.withContext} consumes the `ShardRef.context`
+ * when subsequent ops are issued, and the adapter's internal
+ * `resolveStub` calls `namespace.idFromName(...).` This helper exposes
+ * the same routing logic for callers that need to **manually** route a
+ * batch into a per-cascade DO without going through the adapter (e.g.
+ * direct fetch into a DO that hasn't been wrapped yet).
+ *
+ * For canonical use, prefer the adapter — `withContext(shard.context)`
+ * encapsulates this.
+ *
+ * @example
+ * ```ts
+ * import { resolveDOIdName, CascadeShardingStrategies } from 'ai-database'
+ *
+ * const strategy = CascadeShardingStrategies.perCascade()
+ * const shard = strategy({ cascadeId: 'abc' })
+ * const idName = resolveDOIdName(shard) // 'cascade:abc'
+ * const id = env.DATABASE.idFromName(idName)
+ * const stub = env.DATABASE.get(id)
+ * await stub.fetch(...)
+ * ```
+ */
+export declare function resolveDOIdName(shard: ShardRef): string;
+/**
+ * Split a batch into chunks no larger than `maxBatchSize` rows
+ * (Things + Actions counted together).
+ *
+ * The substrate-write-probes verdict shows sublinear scaling above N=100
+ * for the CTE shape — a single round-trip carrying 500 things + 499 rels
+ * lands in 91 ms p50. We default to 1000 rows/chunk in the strategy;
+ * callers can override via {@link CascadeWriteStrategyOptions.maxBatchSize}.
+ *
+ * Things and Actions are kept together within a chunk so a parent +
+ * child + their relation can fit in one round-trip when the orchestrator
+ * emits them as one batch. When the chunk boundary falls inside a
+ * Thing/Action group the orchestrator built, callers should size their
+ * batches (or the `maxBatchSize`) to avoid splitting groups.
+ *
+ * @internal exported for tests.
+ */
+export declare function chunkBatch(batch: CascadeBatch, maxBatchSize: number): CascadeBatch[];
+/**
+ * Convenience factory.
+ *
+ * @example
+ * ```ts
+ * import {
+ *   createCascadeWriteStrategy,
+ *   createPostgresProvider,
+ * } from 'ai-database'
+ *
+ * const adapter = createPostgresProvider({ executor, namespace: 't9' })
+ * const strategy = createCascadeWriteStrategy({
+ *   adapter,
+ *   sharding: 'partitioned-by-tenant',
+ *   defaultTenantId: 't9',
+ * })
+ * ```
+ */
+export declare function createCascadeWriteStrategy(options: CascadeWriteStrategyOptions): CascadeWriteStrategy;
+//# sourceMappingURL=cascade-write-strategy.d.ts.map

package/dist/cascade-write-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cascade-write-strategy.d.ts","sourceRoot":"","sources":["../src/cascade-write-strategy.ts"],"names":[],"mappings":"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"}