@sqlite-sync/core 0.9.1 → 0.9.3

package/dist/{index-BB-tsxEF.d.ts → index-iXdCBXzB.d.ts}

@@ -149,16 +149,18 @@ type SyncDbMigrator = ReturnType<typeof createMigrator>;
 type ColumnKind = "text" | "integer" | "real" | "boolean" | "enum";
 type SqliteStorageType = "text" | "integer" | "real";
 /**
- * How much of a table an AI agent may use. Consumed by `@sqlite-sync/ai`, which rejects
- * mutations to `read-only` tables, and leaves `hidden` tables out of the generated schema doc
- * while rejecting queries that read them.
+ * What `@sqlite-sync/ai` may do with a table.
+ * `read-only`: documented and queryable; mutations rejected.
+ * `hidden`: omitted from the schema doc; reads rejected.
  */
 type AiAccess = "read-write" | "read-only" | "hidden";
 /**
- * Which replicas may author CRDT events for a table. `"any"` (the default) lets every replica
- * write. `"server"` events are dropped from client pushes.
+ * Who may author CRDT events for a table.
+ * `"any"` (default): every replica. `"server"`: client pushes drop these events.
  */
 type WriteOrigin = "any" | "server";
+/** Whether backup and restore include a table. */
+type ExportImportMode = "include" | "ignore";
 type ColumnMeta = {
   kind: ColumnKind;
   /** Storage type used in generated DDL. Booleans store as integer 0/1. */
@@ -189,12 +191,18 @@ declare class ColumnBuilder<Value, HasDefault extends boolean = false> {
 }
 type AnyColumnBuilder = ColumnBuilder<any, boolean>;
 type TableColumns = Record<string, AnyColumnBuilder>;
-type AnyTableBuilder = TableBuilder<any, any>;
+type AnyTableBuilder = TableBuilder<any, any, WriteOrigin>;
 type SyncSchemaTables = Record<string, AnyTableBuilder>;
-type TableOptions<BaseName extends string | undefined = string | undefined> = {
+type TableOptions<BaseName extends string | undefined = string | undefined, Writes extends WriteOrigin = "any"> = {
   /** Override the materialized base table name (defaults to the crdt table name prefixed with "_"). */
   baseName?: BaseName;
   description?: string;
+  /** Defaults to `"read-write"`. See {@link AiAccess}. */
+  ai?: AiAccess;
+  /** Defaults to `"any"`. See {@link WriteOrigin}. */
+  writes?: Writes;
+  /** Defaults to `"include"`. Ignored tables are omitted from export and skipped on import. */
+  exportImport?: ExportImportMode;
 };
 type Simplify$1<T> = { [K in keyof T]: T[K]; } & {};
 type ColumnValue<Column> = Column extends ColumnBuilder<infer Value, boolean> ? Value : never;
@@ -209,26 +217,22 @@ type PayloadValidationResult = {
   success: false;
   errors: string[];
 };
-declare class TableBuilder<Cols extends TableColumns, BaseName extends string | undefined = undefined> {
-  #private;
+declare class TableBuilder<Cols extends TableColumns, BaseName extends string | undefined = undefined, Writes extends WriteOrigin = "any"> {
   readonly userColumns: Cols;
   readonly "~baseName": BaseName;
+  readonly "~writeOrigin": Writes;
   /** All columns in DDL order, including the auto-injected `id` and `tombstone`. */
   readonly columns: Record<string, ColumnMeta>;
   readonly baseName: BaseName;
   readonly description: string | undefined;
-  /** AI access declared via `.ai()`; "read-write" unless narrowed. */
-  get aiAccess(): AiAccess;
-  /** Who may author events for this table; "any" unless narrowed via `.writes()`. */
-  get writeOrigin(): WriteOrigin;
-  constructor(userColumns: Cols, options?: TableOptions<BaseName>);
-  /** Rebuilds the table with `overrides` applied, carrying over state kept outside the options. */
-  private withOptions;
-  describe(description: string): TableBuilder<Cols, BaseName>;
-  /** Restrict what an AI agent may do with this table; see {@link AiAccess}. */
-  ai(access: AiAccess): TableBuilder<Cols, BaseName>;
-  /** Restrict which replicas may author events for this table; see {@link WriteOrigin}. */
-  writes(origin: WriteOrigin): TableBuilder<Cols, BaseName>;
+  /** Resolved {@link AiAccess}; defaults to `"read-write"`. */
+  readonly aiAccess: AiAccess;
+  /** Resolved {@link WriteOrigin}; defaults to `"any"`. */
+  readonly writeOrigin: Writes;
+  /** Resolved {@link ExportImportMode}; defaults to `"include"`. */
+  readonly exportImport: ExportImportMode;
+  constructor(userColumns: Cols, options?: TableOptions<BaseName, Writes>);
+  describe(description: string): TableBuilder<Cols, BaseName, Writes>;
   /** Type-only: the row shape returned by queries. Do not access at runtime. */
   get $row(): InferRow<Cols>;
   /**
@@ -252,13 +256,15 @@ declare const t: {
    * For an open-ended set, use `t.text().$type<"idle" | (string & {})>()` instead.
    */
   enum: <const Values extends readonly [string, ...string[]]>(values: Values) => ColumnBuilder<Values[number], false>;
-  table: <Cols extends TableColumns, const BaseName extends string | undefined = undefined>(columns: Cols, options?: TableOptions<BaseName>) => TableBuilder<Cols, BaseName>;
+  table: <Cols extends TableColumns, const BaseName extends string | undefined = undefined, const Writes extends WriteOrigin = "any">(columns: Cols, options?: TableOptions<BaseName, Writes>) => TableBuilder<Cols, BaseName, Writes>;
 };
 //#endregion
 //#region src/sqlite-crdt/crdt-schema.d.ts
 type CrdtTableConfig = {
   baseTableName: string;
   crdtTableName: string;
+  /** Defaults to `"include"`. */
+  exportImport?: ExportImportMode;
 };
 interface SyncDbSchema<ClientDB = {}, ServerDB = {}, MutationsDB = {}> {
   get tablesConfig(): CrdtTableConfig[];
@@ -764,8 +770,8 @@ type SchemaForAdmitClientEvents = Pick<SyncDbSchema, "tables" | "tablesConfig">
   writeOriginByName?: ReadonlyMap<string, WriteOrigin>;
 };
 /**
- * Splits a client push into events the hub should persist and events for tables declared
- * `.writes("server")`. Unknown datasets stay admitted. Resolves either the crdt or the base
+ * Splits a client push into events the hub should persist and events for tables with
+ * `{ writes: "server" }`. Unknown datasets stay admitted. Matches either the crdt or the base
  * table name.
  */
 declare function admitClientEvents<T extends {
@@ -777,10 +783,10 @@ declare function admitClientEvents<T extends {
 //#endregion
 //#region src/schema/define-sync-schema.d.ts
 type Simplify<T> = { [K in keyof T]: T[K]; } & {};
-type RowOf<Table extends AnyTableBuilder> = Table extends TableBuilder<infer Cols extends TableColumns, any> ? InferRow<Cols> : never;
+type RowOf<Table extends AnyTableBuilder> = Table extends TableBuilder<infer Cols extends TableColumns, any, WriteOrigin> ? InferRow<Cols> : never;
 type BaseNameOf<CrdtName, Table extends AnyTableBuilder> = string extends Table["~baseName"] ? `_${CrdtName & string}` : [Table["~baseName"]] extends [string] ? Table["~baseName"] : `_${CrdtName & string}`;
-type ClientSchemaOf<Tables extends SyncSchemaTables> = Simplify<{ [K in keyof Tables]: RowOf<Tables[K]>; } & { [K in keyof Tables as BaseNameOf<K, Tables[K]>]: ReadonlyTable<RowOf<Tables[K]>>; }>;
-type ServerSchemaOf<Tables extends SyncSchemaTables> = Simplify<{ [K in keyof Tables]: ReadonlyTable<RowOf<Tables[K]>>; } & { [K in keyof Tables as BaseNameOf<K, Tables[K]>]: ReadonlyTable<RowOf<Tables[K]>>; }>;
+type ClientSchemaOf<Tables extends SyncSchemaTables> = Simplify<{ [K in keyof Tables]: Tables[K]["~writeOrigin"] extends "server" ? ReadonlyTable<RowOf<Tables[K]>> : RowOf<Tables[K]>; } & { [K in keyof Tables as BaseNameOf<K, Tables[K]>]: ReadonlyTable<RowOf<Tables[K]>>; }>;
+type ServerSchemaOf<Tables extends SyncSchemaTables> = Simplify<{ [K in keyof Tables]: RowOf<Tables[K]>; } & { [K in keyof Tables as BaseNameOf<K, Tables[K]>]: ReadonlyTable<RowOf<Tables[K]>>; }>;
 type MutationsSchemaOf<Tables extends SyncSchemaTables> = Simplify<{ [K in keyof Tables as BaseNameOf<K, Tables[K]>]: RowOf<Tables[K]>; }>;
 interface DefinedSyncSchema<Tables extends SyncSchemaTables> extends SyncDbSchema<ClientSchemaOf<Tables>, ServerSchemaOf<Tables>, MutationsSchemaOf<Tables>> {
   /** The table builders, for type extraction (`typeof schema.tables.item.$row`) and runtime metadata. */
@@ -1199,5 +1205,5 @@ type ResetStore = {
  */
 declare const RESET_REQUEST_TTL_MS: number;
 //#endregion
-export { CrdtChangeIntent as $, AnyColumnBuilder as $t, createCrdtApplyFunction as A, InternalSQLiteWrapper as At, defineSyncSchema as B, ColumnMetadata as Bt, WorkerNotificationMessage as C, CrdtEventStatus as Cn, tryCatch as Ct, SnapshotOptions as D, PersistedCrdtEvent as Dn, createSQLiteKvStore as Dt, CrdtStorageMutator as E, CrdtUpdateLogPayload as En, createKvStoreTableQuery as Et, CrdtEventValidationError as F, SQLiteDbWrapper as Ft, SharedLiveQuerySnapshot as G, HLCCounter as Gt, admitClientEvents as H, TableMetadata as Ht, NewCrdtEventValidationResult as I, SQLiteTransactionWrapper as It, ImportDataOptions as J, serializeHLC as Jt, parametersAreEqual as K, compareHLC as Kt, validateNewCrdtEvent as L, LogLevel as Lt, SchemaVerificationIssue as M, KyselyStatementFactory as Mt, formatSchemaVerificationIssues as N, PreparedStatement as Nt, createCrdtStorageMutator as O, isNoOpCrdtEventPayload as On, ExecuteParams as Ot, verifySyncSchema as P, QueryBuilderOutput as Pt, createImportData as Q, AiAccess as Qt, DefineSyncSchemaConfig as R, Logger as Rt, WorkerConfig as S, CrdtEventOrigin as Sn, quoteId as St, createCrdtSyncProducer as T, CrdtUpdateLogItem as Tn, KvStoreItem as Tt, SQLiteReactiveDb as U, introspectDb as Ut, AdmitClientEventsResult as V, DatabaseIntrospection as Vt, SharedLiveQuery as W, HLC as Wt, SyncedDbExport as X, ReadonlyTable as Xt, ImportDataResult as Y, CrdtTableConfig as Yt, createExportData as Z, SyncDbSchema as Zt, EventsPullRequest as _, createMigrations as _n, TypedEventTarget as _t, SyncedDbDatabase as a, PayloadValidationResult as an, SystemDbConfig as at, createCrdtSyncRemoteSource as b, createStoredValue as bn, generateId as bt, SyncedDbTransaction as c, TableBuilder as cn, applyMemoryDbSchema as ct, CRDT_CHANGE_INTENTS_TABLE as d, WriteOrigin as dn, createSystemDbConfig as dt, AnyTableBuilder as en, CrdtStorage as et, createCrdtViewStatements as f, t as fn, runSystemMigrations as ft, CreateRemoteSourceFactory as g, SyncDbMigrator as gn, TypedEvent as gt, CrdtSyncRemoteSource as h, MigrationsDb as hn, TypedBroadcastChannel as ht, SyncedDb as i, InferRow as in, createCrdtStorage as it, createSQLiteCrdtApplyFunction as j, KyselyQueryFactory as jt, PendingCrdtEvent as k, dummyKysely as kn, ExecuteResult as kt, UnsafeSyncedDbSqlExecutor as l, TableColumns as ln, applyWorkerDbSchema as lt, makeCrdtTable as m, Migrations as mn, DistributiveOmit as mt, ResetRequest as n, ColumnKind as nn, OwnCrdtEvent as nt, SyncedDbOptions as o, SqliteStorageType as on, SystemMigration as ot, drainCrdtChangeIntents as p, MigratableEvent as pn, DeferredPromise as pt, xxhash as q, deserializeHLC as qt, ResetStore as r, ColumnMeta as rn, OwnCrdtSnapshot as rt, SyncedDbSqlExecutor as s, SyncSchemaTables as sn, SystemMigrationContext as st, RESET_REQUEST_TTL_MS as t, ColumnBuilder as tn, GetEventsBatch as tt, createSyncedDb as u, TableOptions as un, baseSystemMigrations as ut, EventsPushRequest as v, createMigrator as vn, createDeferredPromise as vt, WorkerState as w, CrdtEventType as wn, tryCatchAsync as wt, EventsPullResponse as x, CRDT_EVENT_NO_OP_PAYLOAD as xn, jsonSafeParse as xt, EventsPushResponse as y, StoredValue as yn, createTypedEventTarget as yt, DefinedSyncSchema as z, startPerformanceLogger as zt };
-//# sourceMappingURL=index-BB-tsxEF.d.ts.map
+export { CrdtChangeIntent as $, AnyColumnBuilder as $t, createCrdtApplyFunction as A, dummyKysely as An, InternalSQLiteWrapper as At, defineSyncSchema as B, ColumnMetadata as Bt, WorkerNotificationMessage as C, CrdtEventOrigin as Cn, tryCatch as Ct, SnapshotOptions as D, CrdtUpdateLogPayload as Dn, createSQLiteKvStore as Dt, CrdtStorageMutator as E, CrdtUpdateLogItem as En, createKvStoreTableQuery as Et, CrdtEventValidationError as F, SQLiteDbWrapper as Ft, SharedLiveQuerySnapshot as G, HLCCounter as Gt, admitClientEvents as H, TableMetadata as Ht, NewCrdtEventValidationResult as I, SQLiteTransactionWrapper as It, ImportDataOptions as J, serializeHLC as Jt, parametersAreEqual as K, compareHLC as Kt, validateNewCrdtEvent as L, LogLevel as Lt, SchemaVerificationIssue as M, KyselyStatementFactory as Mt, formatSchemaVerificationIssues as N, PreparedStatement as Nt, createCrdtStorageMutator as O, PersistedCrdtEvent as On, ExecuteParams as Ot, verifySyncSchema as P, QueryBuilderOutput as Pt, createImportData as Q, AiAccess as Qt, DefineSyncSchemaConfig as R, Logger as Rt, WorkerConfig as S, CRDT_EVENT_NO_OP_PAYLOAD as Sn, quoteId as St, createCrdtSyncProducer as T, CrdtEventType as Tn, KvStoreItem as Tt, SQLiteReactiveDb as U, introspectDb as Ut, AdmitClientEventsResult as V, DatabaseIntrospection as Vt, SharedLiveQuery as W, HLC as Wt, SyncedDbExport as X, ReadonlyTable as Xt, ImportDataResult as Y, CrdtTableConfig as Yt, createExportData as Z, SyncDbSchema as Zt, EventsPullRequest as _, SyncDbMigrator as _n, TypedEventTarget as _t, SyncedDbDatabase as a, InferRow as an, SystemDbConfig as at, createCrdtSyncRemoteSource as b, StoredValue as bn, generateId as bt, SyncedDbTransaction as c, SyncSchemaTables as cn, applyMemoryDbSchema as ct, CRDT_CHANGE_INTENTS_TABLE as d, TableOptions as dn, createSystemDbConfig as dt, AnyTableBuilder as en, CrdtStorage as et, createCrdtViewStatements as f, WriteOrigin as fn, runSystemMigrations as ft, CreateRemoteSourceFactory as g, MigrationsDb as gn, TypedEvent as gt, CrdtSyncRemoteSource as h, Migrations as hn, TypedBroadcastChannel as ht, SyncedDb as i, ExportImportMode as in, createCrdtStorage as it, createSQLiteCrdtApplyFunction as j, KyselyQueryFactory as jt, PendingCrdtEvent as k, isNoOpCrdtEventPayload as kn, ExecuteResult as kt, UnsafeSyncedDbSqlExecutor as l, TableBuilder as ln, applyWorkerDbSchema as lt, makeCrdtTable as m, MigratableEvent as mn, DistributiveOmit as mt, ResetRequest as n, ColumnKind as nn, OwnCrdtEvent as nt, SyncedDbOptions as o, PayloadValidationResult as on, SystemMigration as ot, drainCrdtChangeIntents as p, t as pn, DeferredPromise as pt, xxhash as q, deserializeHLC as qt, ResetStore as r, ColumnMeta as rn, OwnCrdtSnapshot as rt, SyncedDbSqlExecutor as s, SqliteStorageType as sn, SystemMigrationContext as st, RESET_REQUEST_TTL_MS as t, ColumnBuilder as tn, GetEventsBatch as tt, createSyncedDb as u, TableColumns as un, baseSystemMigrations as ut, EventsPushRequest as v, createMigrations as vn, createDeferredPromise as vt, WorkerState as w, CrdtEventStatus as wn, tryCatchAsync as wt, EventsPullResponse as x, createStoredValue as xn, jsonSafeParse as xt, EventsPushResponse as y, createMigrator as yn, createTypedEventTarget as yt, DefinedSyncSchema as z, startPerformanceLogger as zt };
+//# sourceMappingURL=index-iXdCBXzB.d.ts.map

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import { $t as AnyColumnBuilder, A as createCrdtApplyFunction, B as defineSyncSchema, Bt as ColumnMetadata, C as WorkerNotificationMessage, Cn as CrdtEventStatus, Ct as tryCatch, D as SnapshotOptions, Dn as PersistedCrdtEvent, Dt as createSQLiteKvStore, E as CrdtStorageMutator, En as CrdtUpdateLogPayload, Et as createKvStoreTableQuery, F as CrdtEventValidationError, Ft as SQLiteDbWrapper, G as SharedLiveQuerySnapshot, Gt as HLCCounter, H as admitClientEvents, Ht as TableMetadata, I as NewCrdtEventValidationResult, It as SQLiteTransactionWrapper, J as ImportDataOptions, Jt as serializeHLC, K as parametersAreEqual, Kt as compareHLC, L as validateNewCrdtEvent, Lt as LogLevel, M as SchemaVerificationIssue, N as formatSchemaVerificationIssues, Nt as PreparedStatement, O as createCrdtStorageMutator, On as isNoOpCrdtEventPayload, Ot as ExecuteParams, P as verifySyncSchema, Pt as QueryBuilderOutput, Q as createImportData, Qt as AiAccess, R as DefineSyncSchemaConfig, Rt as Logger, S as WorkerConfig, Sn as CrdtEventOrigin, St as quoteId, T as createCrdtSyncProducer, Tn as CrdtUpdateLogItem, Tt as KvStoreItem, U as SQLiteReactiveDb, Ut as introspectDb, V as AdmitClientEventsResult, Vt as DatabaseIntrospection, W as SharedLiveQuery, Wt as HLC, X as SyncedDbExport, Xt as ReadonlyTable, Y as ImportDataResult, Yt as CrdtTableConfig, Z as createExportData, Zt as SyncDbSchema, _ as EventsPullRequest, _n as createMigrations, _t as TypedEventTarget, a as SyncedDbDatabase, an as PayloadValidationResult, at as SystemDbConfig, b as createCrdtSyncRemoteSource, bn as createStoredValue, bt as generateId, c as SyncedDbTransaction, cn as TableBuilder, ct as applyMemoryDbSchema, dn as WriteOrigin, en as AnyTableBuilder, et as CrdtStorage, fn as t, gn as SyncDbMigrator, gt as TypedEvent, h as CrdtSyncRemoteSource, hn as MigrationsDb, ht as TypedBroadcastChannel, i as SyncedDb, in as InferRow, it as createCrdtStorage, j as createSQLiteCrdtApplyFunction, jt as KyselyQueryFactory, k as PendingCrdtEvent, kn as dummyKysely, kt as ExecuteResult, l as UnsafeSyncedDbSqlExecutor, ln as TableColumns, lt as applyWorkerDbSchema, m as makeCrdtTable, mn as Migrations, mt as DistributiveOmit, n as ResetRequest, nn as ColumnKind, nt as OwnCrdtEvent, o as SyncedDbOptions, on as SqliteStorageType, ot as SystemMigration, pn as MigratableEvent, pt as DeferredPromise, q as xxhash, qt as deserializeHLC, r as ResetStore, rn as ColumnMeta, rt as OwnCrdtSnapshot, s as SyncedDbSqlExecutor, sn as SyncSchemaTables, st as SystemMigrationContext, t as RESET_REQUEST_TTL_MS, tn as ColumnBuilder, u as createSyncedDb, un as TableOptions, v as EventsPushRequest, vn as createMigrator, vt as createDeferredPromise, w as WorkerState, wn as CrdtEventType, wt as tryCatchAsync, xn as CRDT_EVENT_NO_OP_PAYLOAD, xt as jsonSafeParse, y as EventsPushResponse, yn as StoredValue, yt as createTypedEventTarget, z as DefinedSyncSchema, zt as startPerformanceLogger } from "./index-BB-tsxEF.js";
-export { type AdmitClientEventsResult, type AiAccess, type AnyColumnBuilder, type AnyTableBuilder, CRDT_EVENT_NO_OP_PAYLOAD, ColumnBuilder, type ColumnKind, type ColumnMeta, type ColumnMetadata, type CrdtEventOrigin, type CrdtEventStatus, type CrdtEventType, CrdtEventValidationError, type CrdtStorage, type CrdtStorageMutator, type CrdtSyncRemoteSource, type CrdtTableConfig, type CrdtUpdateLogItem, type CrdtUpdateLogPayload, type DatabaseIntrospection, type DeferredPromise, type DefineSyncSchemaConfig, type DefinedSyncSchema, type DistributiveOmit, type EventsPullRequest, type EventsPushRequest, type EventsPushResponse, type ExecuteParams, type ExecuteResult, type HLC, HLCCounter, type ImportDataOptions, type ImportDataResult, type InferRow, type KvStoreItem, type KyselyQueryFactory, type LogLevel, type Logger, type MigratableEvent, type Migrations, type MigrationsDb, type NewCrdtEventValidationResult, type OwnCrdtEvent, type OwnCrdtSnapshot, type PayloadValidationResult, type PendingCrdtEvent, type PersistedCrdtEvent, type PreparedStatement, type QueryBuilderOutput, RESET_REQUEST_TTL_MS, type ReadonlyTable, type ResetRequest, type ResetStore, SQLiteDbWrapper, SQLiteReactiveDb, type SQLiteTransactionWrapper, type SchemaVerificationIssue, type SharedLiveQuery, type SharedLiveQuerySnapshot, type SnapshotOptions, type SqliteStorageType, type StoredValue, type SyncDbMigrator, type SyncDbSchema, type SyncSchemaTables, type SyncedDb, type SyncedDbDatabase, type SyncedDbExport, type SyncedDbOptions, type SyncedDbSqlExecutor, type SyncedDbTransaction, type SystemDbConfig, type SystemMigration, type SystemMigrationContext, TableBuilder, type TableColumns, type TableMetadata, type TableOptions, TypedBroadcastChannel, TypedEvent, type TypedEventTarget, type UnsafeSyncedDbSqlExecutor, type WorkerConfig, type WorkerNotificationMessage, type WorkerState, type WriteOrigin, admitClientEvents, applyMemoryDbSchema, applyWorkerDbSchema, compareHLC, createCrdtApplyFunction, createCrdtStorage, createCrdtStorageMutator, createCrdtSyncProducer, createCrdtSyncRemoteSource, createDeferredPromise, createExportData, createImportData, createKvStoreTableQuery, createMigrations, createMigrator, createSQLiteCrdtApplyFunction, createSQLiteKvStore, createStoredValue, createSyncedDb, createTypedEventTarget, defineSyncSchema, deserializeHLC, dummyKysely, formatSchemaVerificationIssues, generateId, introspectDb, isNoOpCrdtEventPayload, jsonSafeParse, makeCrdtTable, parametersAreEqual, quoteId, serializeHLC, startPerformanceLogger, t, tryCatch, tryCatchAsync, validateNewCrdtEvent, verifySyncSchema, xxhash };
+import { $t as AnyColumnBuilder, A as createCrdtApplyFunction, An as dummyKysely, B as defineSyncSchema, Bt as ColumnMetadata, C as WorkerNotificationMessage, Cn as CrdtEventOrigin, Ct as tryCatch, D as SnapshotOptions, Dn as CrdtUpdateLogPayload, Dt as createSQLiteKvStore, E as CrdtStorageMutator, En as CrdtUpdateLogItem, Et as createKvStoreTableQuery, F as CrdtEventValidationError, Ft as SQLiteDbWrapper, G as SharedLiveQuerySnapshot, Gt as HLCCounter, H as admitClientEvents, Ht as TableMetadata, I as NewCrdtEventValidationResult, It as SQLiteTransactionWrapper, J as ImportDataOptions, Jt as serializeHLC, K as parametersAreEqual, Kt as compareHLC, L as validateNewCrdtEvent, Lt as LogLevel, M as SchemaVerificationIssue, N as formatSchemaVerificationIssues, Nt as PreparedStatement, O as createCrdtStorageMutator, On as PersistedCrdtEvent, Ot as ExecuteParams, P as verifySyncSchema, Pt as QueryBuilderOutput, Q as createImportData, Qt as AiAccess, R as DefineSyncSchemaConfig, Rt as Logger, S as WorkerConfig, Sn as CRDT_EVENT_NO_OP_PAYLOAD, St as quoteId, T as createCrdtSyncProducer, Tn as CrdtEventType, Tt as KvStoreItem, U as SQLiteReactiveDb, Ut as introspectDb, V as AdmitClientEventsResult, Vt as DatabaseIntrospection, W as SharedLiveQuery, Wt as HLC, X as SyncedDbExport, Xt as ReadonlyTable, Y as ImportDataResult, Yt as CrdtTableConfig, Z as createExportData, Zt as SyncDbSchema, _ as EventsPullRequest, _n as SyncDbMigrator, _t as TypedEventTarget, a as SyncedDbDatabase, an as InferRow, at as SystemDbConfig, b as createCrdtSyncRemoteSource, bn as StoredValue, bt as generateId, c as SyncedDbTransaction, cn as SyncSchemaTables, ct as applyMemoryDbSchema, dn as TableOptions, en as AnyTableBuilder, et as CrdtStorage, fn as WriteOrigin, gn as MigrationsDb, gt as TypedEvent, h as CrdtSyncRemoteSource, hn as Migrations, ht as TypedBroadcastChannel, i as SyncedDb, in as ExportImportMode, it as createCrdtStorage, j as createSQLiteCrdtApplyFunction, jt as KyselyQueryFactory, k as PendingCrdtEvent, kn as isNoOpCrdtEventPayload, kt as ExecuteResult, l as UnsafeSyncedDbSqlExecutor, ln as TableBuilder, lt as applyWorkerDbSchema, m as makeCrdtTable, mn as MigratableEvent, mt as DistributiveOmit, n as ResetRequest, nn as ColumnKind, nt as OwnCrdtEvent, o as SyncedDbOptions, on as PayloadValidationResult, ot as SystemMigration, pn as t, pt as DeferredPromise, q as xxhash, qt as deserializeHLC, r as ResetStore, rn as ColumnMeta, rt as OwnCrdtSnapshot, s as SyncedDbSqlExecutor, sn as SqliteStorageType, st as SystemMigrationContext, t as RESET_REQUEST_TTL_MS, tn as ColumnBuilder, u as createSyncedDb, un as TableColumns, v as EventsPushRequest, vn as createMigrations, vt as createDeferredPromise, w as WorkerState, wn as CrdtEventStatus, wt as tryCatchAsync, xn as createStoredValue, xt as jsonSafeParse, y as EventsPushResponse, yn as createMigrator, yt as createTypedEventTarget, z as DefinedSyncSchema, zt as startPerformanceLogger } from "./index-iXdCBXzB.js";
+export { type AdmitClientEventsResult, type AiAccess, type AnyColumnBuilder, type AnyTableBuilder, CRDT_EVENT_NO_OP_PAYLOAD, ColumnBuilder, type ColumnKind, type ColumnMeta, type ColumnMetadata, type CrdtEventOrigin, type CrdtEventStatus, type CrdtEventType, CrdtEventValidationError, type CrdtStorage, type CrdtStorageMutator, type CrdtSyncRemoteSource, type CrdtTableConfig, type CrdtUpdateLogItem, type CrdtUpdateLogPayload, type DatabaseIntrospection, type DeferredPromise, type DefineSyncSchemaConfig, type DefinedSyncSchema, type DistributiveOmit, type EventsPullRequest, type EventsPushRequest, type EventsPushResponse, type ExecuteParams, type ExecuteResult, type ExportImportMode, type HLC, HLCCounter, type ImportDataOptions, type ImportDataResult, type InferRow, type KvStoreItem, type KyselyQueryFactory, type LogLevel, type Logger, type MigratableEvent, type Migrations, type MigrationsDb, type NewCrdtEventValidationResult, type OwnCrdtEvent, type OwnCrdtSnapshot, type PayloadValidationResult, type PendingCrdtEvent, type PersistedCrdtEvent, type PreparedStatement, type QueryBuilderOutput, RESET_REQUEST_TTL_MS, type ReadonlyTable, type ResetRequest, type ResetStore, SQLiteDbWrapper, SQLiteReactiveDb, type SQLiteTransactionWrapper, type SchemaVerificationIssue, type SharedLiveQuery, type SharedLiveQuerySnapshot, type SnapshotOptions, type SqliteStorageType, type StoredValue, type SyncDbMigrator, type SyncDbSchema, type SyncSchemaTables, type SyncedDb, type SyncedDbDatabase, type SyncedDbExport, type SyncedDbOptions, type SyncedDbSqlExecutor, type SyncedDbTransaction, type SystemDbConfig, type SystemMigration, type SystemMigrationContext, TableBuilder, type TableColumns, type TableMetadata, type TableOptions, TypedBroadcastChannel, TypedEvent, type TypedEventTarget, type UnsafeSyncedDbSqlExecutor, type WorkerConfig, type WorkerNotificationMessage, type WorkerState, type WriteOrigin, admitClientEvents, applyMemoryDbSchema, applyWorkerDbSchema, compareHLC, createCrdtApplyFunction, createCrdtStorage, createCrdtStorageMutator, createCrdtSyncProducer, createCrdtSyncRemoteSource, createDeferredPromise, createExportData, createImportData, createKvStoreTableQuery, createMigrations, createMigrator, createSQLiteCrdtApplyFunction, createSQLiteKvStore, createStoredValue, createSyncedDb, createTypedEventTarget, defineSyncSchema, deserializeHLC, dummyKysely, formatSchemaVerificationIssues, generateId, introspectDb, isNoOpCrdtEventPayload, jsonSafeParse, makeCrdtTable, parametersAreEqual, quoteId, serializeHLC, startPerformanceLogger, t, tryCatch, tryCatchAsync, validateNewCrdtEvent, verifySyncSchema, xxhash };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { A as serializeHLC, C as createMigrator, D as HLCCounter, E as introspectDb, M as createExportData, N as createImportData, O as compareHLC, P as dummyKysely, S as createMigrations, T as startPerformanceLogger, _ as createSQLiteCrdtApplyFunction, a as createBroadcastChannels, b as CrdtEventValidationError, c as isWorkerNotificationMessage, d as syncDbClientLockName, g as createCrdtApplyFunction, h as createCrdtStorage, j as xxhash, k as deserializeHLC, m as createCrdtSyncProducer, o as isWorkerErrorResponseMessage, p as createCrdtSyncRemoteSource, t as RESET_REQUEST_TTL_MS, u as isWorkerResponseMessage, v as formatSchemaVerificationIssues, w as SQLiteDbWrapper, x as validateNewCrdtEvent, y as verifySyncSchema } from "./reset-state-D3nsfx_t.js";
+import { A as serializeHLC, C as createMigrator, D as HLCCounter, E as introspectDb, M as createExportData, N as createImportData, O as compareHLC, P as dummyKysely, S as createMigrations, T as startPerformanceLogger, _ as createSQLiteCrdtApplyFunction, a as createBroadcastChannels, b as CrdtEventValidationError, c as isWorkerNotificationMessage, d as syncDbClientLockName, g as createCrdtApplyFunction, h as createCrdtStorage, j as xxhash, k as deserializeHLC, m as createCrdtSyncProducer, o as isWorkerErrorResponseMessage, p as createCrdtSyncRemoteSource, t as RESET_REQUEST_TTL_MS, u as isWorkerResponseMessage, v as formatSchemaVerificationIssues, w as SQLiteDbWrapper, x as validateNewCrdtEvent, y as verifySyncSchema } from "./reset-state-4Hn95CKG.js";
 import { c as noop, d as tryCatch, f as tryCatchAsync, i as createTypedEventTarget, n as TypedEvent, o as generateId, r as createDeferredPromise, s as jsonSafeParse, t as TypedBroadcastChannel, u as quoteId } from "./utils-Dr5JwcTP.js";
 import { a as memoryDbConfig, c as createKvStoreTableQuery, d as CRDT_EVENT_NO_OP_PAYLOAD, f as isNoOpCrdtEventPayload, l as createSQLiteKvStore, n as applyWorkerDbSchema, t as applyMemoryDbSchema, u as createStoredValue } from "./system-schema-CkglcfTS.js";
 import { a as registerCrdtIntentDrainer, i as makeCrdtTable } from "./make-crdt-table-CvpTHmRY.js";
@@ -344,8 +344,8 @@ function buildWriteOriginByName(schema) {
 	return writeOriginByName;
 }
 /**
-* Splits a client push into events the hub should persist and events for tables declared
-* `.writes("server")`. Unknown datasets stay admitted. Resolves either the crdt or the base
+* Splits a client push into events the hub should persist and events for tables with
+* `{ writes: "server" }`. Unknown datasets stay admitted. Matches either the crdt or the base
 * table name.
 */
 function admitClientEvents(opts) {
@@ -379,7 +379,8 @@ const RESERVED_TABLE_NAMES = /* @__PURE__ */ new Set([
 function defineSyncSchema({ tables, migrations }) {
 	const tablesConfig = Object.entries(tables).map(([crdtTableName, table]) => ({
 		crdtTableName,
-		baseTableName: table.baseName ?? `_${crdtTableName}`
+		baseTableName: table.baseName ?? `_${crdtTableName}`,
+		...table.exportImport === "ignore" ? { exportImport: "ignore" } : {}
 	}));
 	const seenNames = /* @__PURE__ */ new Set();
 	for (const { crdtTableName, baseTableName } of tablesConfig) for (const name of [crdtTableName, baseTableName]) {
@@ -470,16 +471,12 @@ var TableBuilder = class TableBuilder {
 	columns;
 	baseName;
 	description;
-	#aiAccess = "read-write";
-	#writeOrigin = "any";
-	/** AI access declared via `.ai()`; "read-write" unless narrowed. */
-	get aiAccess() {
-		return this.#aiAccess;
-	}
-	/** Who may author events for this table; "any" unless narrowed via `.writes()`. */
-	get writeOrigin() {
-		return this.#writeOrigin;
-	}
+	/** Resolved {@link AiAccess}; defaults to `"read-write"`. */
+	aiAccess;
+	/** Resolved {@link WriteOrigin}; defaults to `"any"`. */
+	writeOrigin;
+	/** Resolved {@link ExportImportMode}; defaults to `"include"`. */
+	exportImport;
 	constructor(userColumns, options) {
 		this.userColumns = userColumns;
 		for (const reserved of RESERVED_COLUMNS) if (reserved in userColumns) throw new Error(`Column "${reserved}" is added automatically to every synced table and cannot be declared`);
@@ -490,32 +487,18 @@ var TableBuilder = class TableBuilder {
 		};
 		this.baseName = options?.baseName;
 		this.description = options?.description;
+		this.aiAccess = options?.ai ?? "read-write";
+		this.writeOrigin = options?.writes ?? "any";
+		this.exportImport = options?.exportImport ?? "include";
 	}
-	/** Rebuilds the table with `overrides` applied, carrying over state kept outside the options. */
-	withOptions(overrides) {
-		const next = new TableBuilder(this.userColumns, {
+	describe(description) {
+		return new TableBuilder(this.userColumns, {
 			baseName: this.baseName,
-			description: this.description,
-			...overrides
+			description,
+			ai: this.aiAccess,
+			writes: this.writeOrigin,
+			exportImport: this.exportImport
 		});
-		next.#aiAccess = this.#aiAccess;
-		next.#writeOrigin = this.#writeOrigin;
-		return next;
-	}
-	describe(description) {
-		return this.withOptions({ description });
-	}
-	/** Restrict what an AI agent may do with this table; see {@link AiAccess}. */
-	ai(access) {
-		const next = this.withOptions({});
-		next.#aiAccess = access;
-		return next;
-	}
-	/** Restrict which replicas may author events for this table; see {@link WriteOrigin}. */
-	writes(origin) {
-		const next = this.withOptions({});
-		next.#writeOrigin = origin;
-		return next;
 	}
 	/** Type-only: the row shape returned by queries. Do not access at runtime. */
 	get $row() {