@voltro/database 0.22.1 → 0.23.0

package/dist/sql.d.ts

@@ -135,7 +135,13 @@ export declare interface ApplyPlanCtx {
  * Caller passes the dialect explicitly. Defaults to `'postgres'` for
  * call-sites that haven't migrated yet.
  */
-export declare const applySchema: (tables: ReadonlyArray<AnyTable>, dialect?: DialectId) => Effect.Effect<void, never, SqlClient.SqlClient>;
+export declare const applySchema: (tables: ReadonlyArray<AnyTable>, dialect?: DialectId, 
+/** NOTIFY channel for the reactive triggers. Pass the SAME value the store
+ *  was built with. They are two halves of one contract and used to be able to
+ *  disagree silently: the store listened on its `cdcChannel` while the DDL
+ *  always emitted on the default, so a custom channel received nothing and
+ *  raised nothing. */
+cdcChannel?: string) => Effect.Effect<void, never, SqlClient.SqlClient>;
 
 /** Per-row backfill body executed by the migration runner. */
 declare type BackfillFunction<TsType = unknown> = (row: Readonly<Record<string, unknown>>) => TsType | Promise<TsType>;
@@ -706,6 +712,12 @@ declare type ColumnType = 'id' | 'text' | 'integer' | 'real' | 'decimal' | 'bigi
  */
 export declare const declaredSnapshot: (tables: ReadonlyArray<TableLike>, dialect?: DialectId) => SchemaSnapshot;
 
+/** The NOTIFY channel a schema emits on when none is configured. Exported so
+ *  the store and the DDL cannot drift: they must agree, and before this they
+ *  did not — the store read `options.cdcChannel` while the trigger hardcoded
+ *  the default, so any custom channel listened to silence. */
+export declare const DEFAULT_CDC_CHANNEL = "framework_changes";
+
 /**
  * `DEFAULT <expr>` for an array-valued default.
  *
@@ -815,7 +827,9 @@ export declare const emitDropColumnDdlMysql: (op: Extract<MigrationOperation, {
  * Dialect-uniform now, because there is nothing left in it that only one dialect
  * can express.
  */
-export declare const emitFrameworkBootstrapSql: (tables: ReadonlyArray<AnyTable>, dialect: DialectId) => string;
+export declare const emitFrameworkBootstrapSql: (tables: ReadonlyArray<AnyTable>, dialect: DialectId, 
+/** NOTIFY channel for the reactive triggers — see `applySchema`. */
+cdcChannel?: string) => string;
 
 /**
  * Emit the full schema DDL SCOPED to a tenant namespace. The container is
@@ -856,7 +870,10 @@ export declare const emitNamespacedSchemaSql: (tables: ReadonlyArray<AnyTable>,
  */
 export declare const emitNamespaceProvisionDdl: (namespace: string, dialect: DialectId, sqliteFile?: string) => string;
 
-export declare const emitSchemaSql: (entities: ReadonlyArray<AnyTable | AnyView>, dialect: DialectId) => string;
+export declare const emitSchemaSql: (entities: ReadonlyArray<AnyTable | AnyView>, dialect: DialectId, 
+/** NOTIFY channel for the reactive triggers. Must match the store's
+ *  `cdcChannel`, or writes emit where nothing is listening. */
+cdcChannel?: string) => string;
 
 declare type EmptyMerge = unknown;