create-syncular-app 0.1.3 → 0.2.0

package/template/src/generated/syncular.generated.ts

@@ -1,769 +0,0 @@
-// @generated by `cargo run --manifest-path rust/Cargo.toml -p syncular-codegen --`
-// Source: migrations/*.sql and generated Syncular codegen handoff
-
-import { SYNCULAR_PACKAGE_NAME, SYNCULAR_PACKAGE_VERSION, SYNCULAR_WORKER_PROTOCOL_VERSION, createSyncularCommandHistory, createSyncularDatabase, withSyncularSchemaWrites } from '@syncular/client';
-import type { CreateSyncularDatabaseOptions, SyncularAppSchema, SyncularChangedCrdtField, SyncularChangedRow, SyncularCommandHistory, SyncularDatabase, SyncularEmbeddedMigration, SyncularFieldEncryptionConfig, SyncularFieldEncryptionRule, SyncularRowsChangedEvent, SyncularRuntimeInfo, SyncularYjsPayloadEnvelope } from '@syncular/client';
-
-import { sql, type Generated, type Kysely } from 'kysely';
-import { codecs, type BlobRef, type ColumnCodecSource } from '@syncular/core';
-
-export interface SyncularGeneratedOperation {
-  table: string;
-  row_id: string;
-  op: 'upsert' | 'delete';
-  payload: Record<string, unknown> | null;
-  base_version?: number | null;
-}
-
-export interface SyncularSubscriptionSpec {
-  id: string;
-  table: string;
-  scopes: Record<string, string | string[]>;
-  params: Record<string, unknown>;
-  bootstrapPhase?: number;
-}
-
-export interface SyncularSubscriptionArgs {
-  actorId: string;
-  projectId?: string | null;
-  bootstrapPhases?: Record<string, number>;
-}
-
-function syncularBootstrapPhase(args: SyncularSubscriptionArgs, table: string, subscriptionId: string): number {
-  return args.bootstrapPhases?.[subscriptionId] ?? args.bootstrapPhases?.[table] ?? 0;
-}
-
-export interface SyncularAppDb {
-  tasks: TaskTable;
-}
-
-export interface SyncularGeneratedTableConfig {
-  primaryKeyColumn: string;
-  serverVersionColumn: string;
-  softDeleteColumn: string | null;
-  subscriptionId: string;
-  subscriptionParams: Record<string, unknown>;
-  scopeColumns: Record<string, string>;
-  blobColumns: readonly string[];
-  crdtYjsFields: readonly { field: string; stateColumn: string; containerKey: string; rowIdField: string; kind: 'text' | 'xml-fragment' | 'prosemirror'; syncMode: 'server-merge' | 'encrypted-update-log' }[];
-  encryptedFields: readonly { field: string; scope: string; rowIdField: string }[];
-}
-
-export const syncularGeneratedSchemaVersion = 1 as const;
-export const syncularGeneratedClientSchemaSupport = {
-  current: syncularGeneratedSchemaVersion,
-  minSupported: 1,
-  supported: [1],
-} as const;
-export type SyncularGeneratedSupportedClientSchemaVersion = typeof syncularGeneratedClientSchemaSupport.supported[number];
-export function syncularIsSupportedClientSchemaVersion(schemaVersion: number | null | undefined): schemaVersion is SyncularGeneratedSupportedClientSchemaVersion {
-  if (typeof schemaVersion !== 'number') return false;
-  return (syncularGeneratedClientSchemaSupport.supported as readonly number[]).includes(schemaVersion);
-}
-
-const syncularGeneratedSchemaId = 'syncular-app';
-
-export interface SyncularGeneratedAppMigration {
-  version: string;
-  schemaVersion: number;
-  name: string;
-  appSql: readonly string[];
-  skippedSystemStatements: number;
-}
-
-export interface SyncularGeneratedEmbeddedMigration extends SyncularEmbeddedMigration {
-  version: string;
-  schemaVersion: number;
-  name: string;
-  upSql: string;
-}
-
-export const syncularGeneratedAppMigrations: readonly SyncularGeneratedAppMigration[] = [
-  {
-    version: '0001',
-    schemaVersion: 1,
-    name: 'initial',
-    appSql: [
-      `CREATE TABLE IF NOT EXISTS tasks (
-  id TEXT PRIMARY KEY,
-  title TEXT NOT NULL,
-  completed INTEGER NOT NULL DEFAULT 0,
-  user_id TEXT NOT NULL,
-  created_at BIGINT NOT NULL DEFAULT 0,
-  server_version BIGINT NOT NULL DEFAULT 0
-) WITHOUT ROWID;`,
-    ],
-    skippedSystemStatements: 0,
-  },
-];
-
-export const syncularGeneratedEmbeddedMigrations: readonly SyncularGeneratedEmbeddedMigration[] = [
-  {
-    version: '0001',
-    schemaVersion: 1,
-    name: 'initial',
-    upSql: 'CREATE TABLE IF NOT EXISTS tasks (\n  id TEXT PRIMARY KEY,\n  title TEXT NOT NULL,\n  completed INTEGER NOT NULL DEFAULT 0,\n  user_id TEXT NOT NULL,\n  created_at BIGINT NOT NULL DEFAULT 0,\n  server_version BIGINT NOT NULL DEFAULT 0\n) WITHOUT ROWID;',
-  },
-];
-
-export const syncularGeneratedRequiredRuntimeFeatures = [
-  'web-owned-sqlite-core',
-] as const;
-
-export const syncularGeneratedTableConfig = {
-  tasks: {
-    primaryKeyColumn: 'id',
-    serverVersionColumn: 'server_version',
-    softDeleteColumn: null,
-    subscriptionId: 'sub-tasks',
-    subscriptionParams: {},
-    scopeColumns: {
-      user_id: 'user_id',
-    },
-    blobColumns: [],
-    crdtYjsFields: [],
-    encryptedFields: [],
-  },
-} satisfies Record<'tasks', SyncularGeneratedTableConfig>;
-
-export interface SyncularGeneratedLocalReadModel {
-  name: string;
-  outputTable: keyof SyncularAppDb;
-  setupSql: readonly string[];
-  rebuildSql: readonly string[];
-}
-
-export const syncularGeneratedLocalReadModels: readonly SyncularGeneratedLocalReadModel[] = [
-];
-
-export interface SyncularGeneratedLocalIndex {
-  table: keyof SyncularAppDb;
-  name: string;
-  sql: string;
-  unique: boolean;
-  partial: boolean;
-  columns: readonly { name: string | null; descending: boolean }[];
-}
-
-export const syncularGeneratedLocalIndexes: readonly SyncularGeneratedLocalIndex[] = [
-];
-
-export interface SyncularGeneratedDerivedSchemaTimings {
-  totalMs: number;
-  metadataMs: number;
-  indexesMs: number;
-  readModelProbeMs: number;
-  readModelSetupMs: number;
-  readModelRebuildMs: number;
-  recordSchemaVersionMs: number;
-  rebuiltReadModels: string[];
-}
-
-export interface SyncularGeneratedSchemaInstallTimings extends SyncularGeneratedDerivedSchemaTimings {
-  baseSchemaMs: number;
-  derivedSchemaMs: number;
-}
-
-export const syncularGeneratedAppSchema = {
-  schemaVersion: syncularGeneratedSchemaVersion,
-  migrations: syncularGeneratedEmbeddedMigrations,
-  localBaseSchema: {
-    tableSetupSql: [
-      'CREATE TABLE IF NOT EXISTS "tasks" (\n  "id" TEXT PRIMARY KEY,\n  "title" TEXT NOT NULL,\n  "completed" INTEGER NOT NULL DEFAULT 0,\n  "user_id" TEXT NOT NULL,\n  "created_at" INTEGER NOT NULL DEFAULT 0,\n  "server_version" INTEGER NOT NULL DEFAULT 0\n) WITHOUT ROWID',
-    ],
-  },
-  tables: [
-    {
-      name: 'tasks',
-      primaryKeyColumn: 'id',
-      serverVersionColumn: 'server_version',
-      softDeleteColumn: null,
-      subscriptionId: 'sub-tasks',
-      columns: [
-        { name: 'id', typeFamily: 'text', notnullRequired: false, primaryKey: true },
-        { name: 'title', typeFamily: 'text', notnullRequired: true, primaryKey: false },
-        { name: 'completed', typeFamily: 'integer', notnullRequired: true, primaryKey: false },
-        { name: 'user_id', typeFamily: 'text', notnullRequired: true, primaryKey: false },
-        { name: 'created_at', typeFamily: 'integer', notnullRequired: true, primaryKey: false },
-        { name: 'server_version', typeFamily: 'integer', notnullRequired: true, primaryKey: false },
-      ],
-      blobColumns: [],
-      crdtYjsFields: [],
-      encryptedFields: [],
-      scopes: [{ name: 'user_id', column: 'user_id', source: 'actorId', required: true }],
-    },
-  ],
-} satisfies SyncularAppSchema;
-
-export const syncularGeneratedFieldEncryptionRules = [
-] satisfies readonly SyncularFieldEncryptionRule[];
-
-export function syncularGeneratedFieldEncryptionConfig(
-  options: Omit<SyncularFieldEncryptionConfig, 'rules'>
-): SyncularFieldEncryptionConfig {
-  return {
-    ...options,
-    rules: [...syncularGeneratedFieldEncryptionRules],
-  };
-}
-
-const syncularGeneratedAppTableNames = [
-  'tasks',
-] as const satisfies readonly (keyof SyncularAppDb)[];
-
-const syncularGeneratedAppTableRefs = {
-  tasks: {
-    name: 'tasks',
-    config: syncularGeneratedTableConfig.tasks,
-  },
-} as const;
-
-export type SyncularGeneratedChangedOperation = SyncularChangedRow['operation'];
-export type SyncularChangedRowsInput = SyncularRowsChangedEvent | { changedRows?: readonly SyncularChangedRow[] } | readonly SyncularChangedRow[];
-
-export interface SyncularGeneratedChangedRowBase<Table extends keyof SyncularAppDb, Field extends string> {
-  raw: SyncularChangedRow;
-  table: Table;
-  rowId: string | null;
-  operation: SyncularGeneratedChangedOperation;
-  changedFields: Field[];
-  crdtFields: Field[];
-  crdtFieldChanges: (SyncularChangedCrdtField & { field: Field })[];
-  changed: Record<Field, boolean>;
-  crdt: Record<Field, boolean>;
-  commitId: string | null;
-  commitSeq: number | null;
-  subscriptionId: string | null;
-  serverVersion: number | null;
-  isInsert: boolean;
-  isUpdate: boolean;
-  isDelete: boolean;
-}
-
-function syncularRowsFromChangedInput(input: SyncularChangedRowsInput): readonly SyncularChangedRow[] {
-  return Array.isArray(input) ? input : (input as { changedRows?: readonly SyncularChangedRow[] }).changedRows ?? [];
-}
-
-function syncularColumnFlags<Field extends string>(fields: readonly string[], allFields: readonly Field[]): Record<Field, boolean> {
-  const changed = new Set(fields);
-  return Object.fromEntries(allFields.map((field) => [field, changed.has(field)])) as Record<Field, boolean>;
-}
-
-function syncularTypedChangedRows<Table extends keyof SyncularAppDb, Field extends string>(
-  input: SyncularChangedRowsInput,
-  table: Table,
-  fields: readonly Field[]
-): SyncularGeneratedChangedRowBase<Table, Field>[] {
-  const fieldSet = new Set<string>(fields);
-  return syncularRowsFromChangedInput(input)
-    .filter((row) => row.table === table)
-    .map((row) => ({
-      raw: row,
-      table,
-      rowId: row.rowId ?? null,
-      operation: row.operation,
-      changedFields: row.changedFields.filter((field): field is Field => fieldSet.has(field)),
-      crdtFields: row.crdtFields.filter((field): field is Field => fieldSet.has(field)),
-      crdtFieldChanges: (row.crdtFieldChanges ?? []).filter((field): field is SyncularChangedCrdtField & { field: Field } => fieldSet.has(field.field)),
-      changed: syncularColumnFlags(row.changedFields, fields),
-      crdt: syncularColumnFlags(row.crdtFields, fields),
-      commitId: row.commitId ?? null,
-      commitSeq: row.commitSeq ?? null,
-      subscriptionId: row.subscriptionId ?? null,
-      serverVersion: row.serverVersion ?? null,
-      isInsert: row.operation === 'insert',
-      isUpdate: row.operation === 'update',
-      isDelete: row.operation === 'delete',
-    }));
-}
-
-export const syncularTaskChangedFields = [
-  'id',
-  'title',
-  'completed',
-  'user_id',
-  'created_at',
-  'server_version',
-] as const;
-export type TaskChangedField = typeof syncularTaskChangedFields[number];
-export type TaskChangedColumns = Record<TaskChangedField, boolean>;
-export type TaskChangedRow = SyncularGeneratedChangedRowBase<'tasks', TaskChangedField>;
-export function taskChangedRows(input: SyncularChangedRowsInput): TaskChangedRow[] {
-  return syncularTypedChangedRows(input, 'tasks', syncularTaskChangedFields);
-}
-
-export type SyncularAppChangedRow =
-  TaskChangedRow;
-
-export function syncularAppChangedRows(input: SyncularChangedRowsInput): SyncularAppChangedRow[] {
-  return [
-    ...taskChangedRows(input),
-  ];
-}
-
-export const syncularChangedRows = {
-  tasks: taskChangedRows,
-} as const;
-
-export const syncularGeneratedCodecs: ColumnCodecSource = (column) => {
-  const table = syncularGeneratedTableConfig[column.table as keyof typeof syncularGeneratedTableConfig];
-  const blobColumns: readonly string[] = table?.blobColumns ?? [];
-  if (blobColumns.includes(column.column)) {
-    return codecs.stringJson<BlobRef>({ ts: { type: 'BlobRef', import: { name: 'BlobRef', from: '@syncular/core' } } });
-  }
-  return undefined;
-};
-
-function withSyncularGeneratedCodecs(userCodecs?: ColumnCodecSource): ColumnCodecSource {
-  return (column) => syncularGeneratedCodecs(column) ?? userCodecs?.(column);
-}
-
-export const syncularGeneratedApp = {
-  currentSchemaVersion: syncularGeneratedSchemaVersion,
-  appSchema: syncularGeneratedAppSchema,
-  tables: syncularGeneratedAppTableRefs,
-  tableNames: syncularGeneratedAppTableNames,
-  tableConfig: syncularGeneratedTableConfig,
-  fieldEncryptionRules: syncularGeneratedFieldEncryptionRules,
-  fieldEncryptionConfig: syncularGeneratedFieldEncryptionConfig,
-  codecs: syncularGeneratedCodecs,
-} as const;
-
-export async function ensureSyncularAppBaseSchema(db: Kysely<any>): Promise<void> {
-  await ensureSyncularAppBaseSchemaWithMetadata(db);
-}
-
-async function ensureSyncularAppBaseSchemaWithMetadata(db: Kysely<any>): Promise<number | null> {
-  const syncularGeneratedPreviousSchemaVersion = await ensureSyncularAppSchemaMetadata(db);
-  for (const statement of syncularGeneratedAppSchema.localBaseSchema.tableSetupSql) {
-    await sql.raw(statement).execute(db);
-  }
-  return syncularGeneratedPreviousSchemaVersion;
-}
-
-function syncularGeneratedNowMs(): number {
-  return typeof performance !== 'undefined' && typeof performance.now === 'function' ? performance.now() : Date.now();
-}
-
-export async function ensureSyncularAppDerivedSchemaWithTimings(db: Kysely<any>, syncularGeneratedKnownSchemaVersion?: number | null): Promise<SyncularGeneratedDerivedSchemaTimings> {
-  const syncularGeneratedTotalStartedAt = syncularGeneratedNowMs();
-  const syncularGeneratedTimings: SyncularGeneratedDerivedSchemaTimings = {
-    totalMs: 0,
-    metadataMs: 0,
-    indexesMs: 0,
-    readModelProbeMs: 0,
-    readModelSetupMs: 0,
-    readModelRebuildMs: 0,
-    recordSchemaVersionMs: 0,
-    rebuiltReadModels: [],
-  };
-  let syncularGeneratedStartedAt = syncularGeneratedNowMs();
-  if (syncularGeneratedKnownSchemaVersion === undefined) {
-    await ensureSyncularAppSchemaMetadata(db);
-  }
-  syncularGeneratedTimings.metadataMs = syncularGeneratedNowMs() - syncularGeneratedStartedAt;
-  syncularGeneratedStartedAt = syncularGeneratedNowMs();
-  await ensureSyncularAppIndexes(db);
-  syncularGeneratedTimings.indexesMs = syncularGeneratedNowMs() - syncularGeneratedStartedAt;
-  syncularGeneratedStartedAt = syncularGeneratedNowMs();
-  await recordSyncularAppSchemaVersion(db);
-  syncularGeneratedTimings.recordSchemaVersionMs = syncularGeneratedNowMs() - syncularGeneratedStartedAt;
-  syncularGeneratedTimings.totalMs = syncularGeneratedNowMs() - syncularGeneratedTotalStartedAt;
-  return syncularGeneratedTimings;
-}
-
-export async function ensureSyncularAppDerivedSchema(db: Kysely<any>): Promise<void> {
-  await ensureSyncularAppDerivedSchemaWithTimings(db);
-}
-
-export async function ensureSyncularAppIndexes(db: Kysely<any>): Promise<void> {
-  for (const index of syncularGeneratedLocalIndexes) {
-    await sql.raw(index.sql).execute(db);
-  }
-}
-
-export async function ensureSyncularAppReadModelSetup(db: Kysely<any>): Promise<void> {
-  for (const readModel of syncularGeneratedLocalReadModels) {
-    for (const statement of readModel.setupSql) {
-      await sql.raw(statement).execute(db);
-    }
-  }
-}
-
-export async function rebuildSyncularAppReadModels(db: Kysely<any>): Promise<void> {
-  for (const readModel of syncularGeneratedLocalReadModels) {
-    for (const statement of readModel.rebuildSql) {
-      await sql.raw(statement).execute(db);
-    }
-  }
-}
-
-async function recordSyncularAppSchemaVersion(db: Kysely<any>): Promise<void> {
-  await validateSyncularAppSchema(db);
-  await sql`
-    insert into syncular_app_schema (schema_id, schema_version, updated_at)
-    values (${sql.val(syncularGeneratedSchemaId)}, ${sql.val(syncularGeneratedSchemaVersion)}, ${sql.val(Date.now())})
-    on conflict (schema_id) do update set
-      schema_version = excluded.schema_version,
-      updated_at = excluded.updated_at
-  `.execute(db);
-}
-
-export async function ensureSyncularAppSchema(db: Kysely<any>): Promise<void> {
-  await ensureSyncularAppSchemaWithTimings(db);
-}
-
-export async function ensureSyncularAppSchemaWithTimings(db: Kysely<any>): Promise<SyncularGeneratedSchemaInstallTimings> {
-  const syncularGeneratedTotalStartedAt = syncularGeneratedNowMs();
-  const syncularGeneratedBaseStartedAt = syncularGeneratedNowMs();
-  const syncularGeneratedPreviousSchemaVersion = await ensureSyncularAppBaseSchemaWithMetadata(db);
-  const syncularGeneratedBaseSchemaMs = syncularGeneratedNowMs() - syncularGeneratedBaseStartedAt;
-  const syncularGeneratedDerivedStartedAt = syncularGeneratedNowMs();
-  const syncularGeneratedDerivedTimings = await ensureSyncularAppDerivedSchemaWithTimings(db, syncularGeneratedPreviousSchemaVersion);
-  const syncularGeneratedDerivedSchemaMs = syncularGeneratedNowMs() - syncularGeneratedDerivedStartedAt;
-  return {
-    ...syncularGeneratedDerivedTimings,
-    totalMs: syncularGeneratedNowMs() - syncularGeneratedTotalStartedAt,
-    baseSchemaMs: syncularGeneratedBaseSchemaMs,
-    derivedSchemaMs: syncularGeneratedDerivedSchemaMs,
-  };
-}
-
-interface SyncularGeneratedColumnInfo {
-  name: string;
-  type: string;
-  notnull: number;
-  pk: number;
-}
-
-async function ensureSyncularAppSchemaMetadata(db: Kysely<any>): Promise<number | null> {
-  await db.schema
-    .createTable('syncular_app_schema')
-    .ifNotExists()
-    .addColumn('schema_id', 'text', (col) => col.primaryKey())
-    .addColumn('schema_version', 'integer', (col) => col.notNull())
-    .addColumn('updated_at', 'bigint', (col) => col.notNull())
-    .execute();
-
-  const rows = await sql<{ schema_version: number }>`
-    select schema_version
-    from syncular_app_schema
-    where schema_id = ${sql.val(syncularGeneratedSchemaId)}
-    limit 1
-  `.execute(db);
-  const version = rows.rows[0]?.schema_version;
-  if (version == null) return null;
-  const localVersion = Number(version);
-  if (localVersion > syncularGeneratedSchemaVersion) {
-    throw new Error(`Syncular app schema version mismatch: local ${localVersion}, generated ${syncularGeneratedSchemaVersion}. Regenerate the client before opening this database.`);
-  }
-  if (localVersion < syncularGeneratedSchemaVersion) {
-    await applySyncularGeneratedAppMigrations(db, localVersion);
-  }
-  return localVersion;
-}
-
-async function applySyncularGeneratedAppMigrations(db: Kysely<any>, localVersion: number): Promise<void> {
-  for (const migration of syncularGeneratedAppMigrations) {
-    if (migration.schemaVersion <= localVersion || migration.schemaVersion > syncularGeneratedSchemaVersion) continue;
-    for (const statement of migration.appSql) {
-      await sql.raw(statement).execute(db);
-    }
-  }
-}
-
-async function validateSyncularAppSchema(db: Kysely<any>): Promise<void> {
-  await validateSyncularGeneratedTable(db, 'tasks', [
-    { name: 'id', type: 'text', notnull: 0, pk: 1 },
-    { name: 'title', type: 'text', notnull: 1, pk: 0 },
-    { name: 'completed', type: 'integer', notnull: 1, pk: 0 },
-    { name: 'user_id', type: 'text', notnull: 1, pk: 0 },
-    { name: 'created_at', type: 'integer', notnull: 1, pk: 0 },
-    { name: 'server_version', type: 'integer', notnull: 1, pk: 0 },
-  ]);
-}
-
-async function validateSyncularGeneratedTable(db: Kysely<any>, table: string, expected: SyncularGeneratedColumnInfo[]): Promise<void> {
-  const rows = await sql<SyncularGeneratedColumnInfo>`
-    select name, type, "notnull" as "notnull", pk
-    from pragma_table_info(${sql.val(table)})
-  `.execute(db);
-  const actual = new Map(rows.rows.map((row) => [row.name, row]));
-  for (const column of expected) {
-    const found = actual.get(column.name);
-    if (!found) throw new Error(`Syncular app schema mismatch: ${table}.${column.name} is missing`);
-    if (sqliteTypeFamily(found.type) !== column.type) {
-      throw new Error(`Syncular app schema mismatch: ${table}.${column.name} has type ${found.type}, expected ${column.type}`);
-    }
-    if (column.pk > 0 && Number(found.pk) <= 0) {
-      throw new Error(`Syncular app schema mismatch: ${table}.${column.name} is not a primary key`);
-    }
-    if (column.notnull > 0 && Number(found.notnull) <= 0 && Number(found.pk) <= 0) {
-      throw new Error(`Syncular app schema mismatch: ${table}.${column.name} is nullable`);
-    }
-  }
-}
-
-function sqliteTypeFamily(type: string | null | undefined): string {
-  const upper = String(type ?? '').toUpperCase();
-  if (upper.includes('INT')) return 'integer';
-  if (upper.includes('REAL') || upper.includes('FLOA') || upper.includes('DOUB')) return 'real';
-  if (upper.includes('BLOB')) return 'blob';
-  return 'text';
-}
-
-export interface SyncularGeneratedMutationOptions {
-  baseVersion?: number | null;
-}
-
-export interface SyncularGeneratedMutationReceipt {
-  commitId: string;
-  clientCommitId: string;
-}
-
-export type SyncularGeneratedInsertReceipt = SyncularGeneratedMutationReceipt & { id: string };
-export type SyncularGeneratedInsertManyReceipt = SyncularGeneratedMutationReceipt & { ids: string[] };
-
-export interface SyncularGeneratedTableMutations<NewRow, Patch> {
-  insert(input: NewRow): Promise<SyncularGeneratedInsertReceipt>;
-  insertMany(rows: readonly NewRow[]): Promise<SyncularGeneratedInsertManyReceipt>;
-  update(rowId: string, patch: Patch, options?: SyncularGeneratedMutationOptions): Promise<SyncularGeneratedMutationReceipt>;
-  delete(rowId: string, options?: SyncularGeneratedMutationOptions): Promise<SyncularGeneratedMutationReceipt>;
-  upsert(rowId: string, patch: Patch, options?: SyncularGeneratedMutationOptions): Promise<SyncularGeneratedMutationReceipt>;
-}
-
-export interface SyncularGeneratedTableMutationsTx<NewRow, Patch> {
-  insert(input: NewRow): Promise<string>;
-  insertMany(rows: readonly NewRow[]): Promise<string[]>;
-  update(rowId: string, patch: Patch, options?: SyncularGeneratedMutationOptions): Promise<void>;
-  delete(rowId: string, options?: SyncularGeneratedMutationOptions): Promise<void>;
-  upsert(rowId: string, patch: Patch, options?: SyncularGeneratedMutationOptions): Promise<void>;
-}
-
-export interface SyncularAppMutationsTx {
-  tasks: SyncularGeneratedTableMutationsTx<NewTask, TaskPatch>;
-}
-
-export interface SyncularAppMutations {
-  $commit<R>(fn: (tx: SyncularAppMutationsTx) => Promise<R> | R): Promise<{ result: R; commit: SyncularGeneratedMutationReceipt }>;
-  tasks: SyncularGeneratedTableMutations<NewTask, TaskPatch>;
-}
-
-export type SyncularAppDatabase = Omit<SyncularDatabase<SyncularAppDb>, 'mutations' | 'leasedMutations'> & {
-  mutations: SyncularAppMutations;
-  leasedMutations: SyncularAppMutations;
-  commandHistory: SyncularCommandHistory;
-};
-export type SyncularAppSubscriptionsOption =
-  | false
-  | readonly SyncularSubscriptionSpec[]
-  | ((args: SyncularSubscriptionArgs) => readonly SyncularSubscriptionSpec[]);
-
-export interface CreateSyncularAppDatabaseOptions extends Omit<CreateSyncularDatabaseOptions, 'subscriptions'> {
-  subscriptions?: SyncularAppSubscriptionsOption;
-  bootstrapPhases?: Record<string, number>;
-  schemaInstallMode?: 'derived' | 'full' | 'base' | 'none';
-}
-
-export async function assertSyncularAppRuntime(database: Pick<SyncularAppDatabase, 'client'>): Promise<void> {
-  assertSyncularAppRuntimeInfo(await database.client.runtimeInfo());
-  const schemaState = await database.client.generatedSchemaState();
-  if (schemaState.currentSchemaVersion !== syncularGeneratedSchemaVersion) {
-    throw new Error(`Syncular Rust app schema version mismatch: ${schemaState.currentSchemaVersion}, expected ${syncularGeneratedSchemaVersion}`);
-  }
-  if (schemaState.schemaVersion !== null && schemaState.schemaVersion > syncularGeneratedSchemaVersion) {
-    throw new Error(`Syncular Rust local app schema version mismatch: local ${schemaState.schemaVersion}, generated ${syncularGeneratedSchemaVersion}`);
-  }
-}
-
-export function assertSyncularAppRuntimeInfo(runtimeInfo: SyncularRuntimeInfo): void {
-  if (runtimeInfo.packageName !== SYNCULAR_PACKAGE_NAME) {
-    throw new Error(`Syncular runtime package mismatch: ${runtimeInfo.packageName}, expected ${SYNCULAR_PACKAGE_NAME}`);
-  }
-  if (runtimeInfo.packageVersion !== SYNCULAR_PACKAGE_VERSION) {
-    throw new Error(`Syncular runtime package version mismatch: ${runtimeInfo.packageVersion}, expected ${SYNCULAR_PACKAGE_VERSION}`);
-  }
-  if (runtimeInfo.workerProtocolVersion !== SYNCULAR_WORKER_PROTOCOL_VERSION) {
-    throw new Error(`Syncular worker protocol mismatch: ${runtimeInfo.workerProtocolVersion}, expected ${SYNCULAR_WORKER_PROTOCOL_VERSION}`);
-  }
-  if (!runtimeInfo.rust) {
-    throw new Error('Syncular runtime did not report Rust runtime information');
-  }
-  for (const feature of syncularGeneratedRequiredRuntimeFeatures) {
-    if (!runtimeInfo.rust.features.includes(feature)) {
-      throw new Error(`Syncular Rust runtime is missing ${feature} support`);
-    }
-  }
-}
-
-function resolveSyncularAppSubscriptions(options: CreateSyncularAppDatabaseOptions): readonly SyncularSubscriptionSpec[] {
-  const args: SyncularSubscriptionArgs = {
-    actorId: options.config.actorId,
-    projectId: options.config.projectId,
-    bootstrapPhases: options.bootstrapPhases,
-  };
-  const subscriptions = options.subscriptions;
-  if (subscriptions === false) return [];
-  if (typeof subscriptions === 'function') return subscriptions(args);
-  return subscriptions ?? defaultSyncularSubscriptions(args);
-}
-
-export async function finalizeSyncularAppDatabaseSchema(database: Pick<SyncularAppDatabase, 'client'>): Promise<void> {
-  await withSyncularSchemaWrites(database, ensureSyncularAppDerivedSchema);
-}
-
-export async function createSyncularAppDatabase(
-  options: CreateSyncularAppDatabaseOptions
-): Promise<SyncularAppDatabase> {
-  const { subscriptions: _appSubscriptions, ...databaseOptions } = options;
-  const database = await createSyncularDatabase<SyncularAppDb>({
-    ...databaseOptions,
-    // The app factory installs the generated schema first; the lifecycle
-    // starts below once subscriptions and command history are wired.
-    lifecycle: { ...options.lifecycle, autoStart: false },
-    config: {
-      ...options.config,
-      schemaVersion: options.config.schemaVersion ?? syncularGeneratedSchemaVersion,
-      appSchema: options.config.appSchema ?? syncularGeneratedAppSchema,
-    },
-    codecs: withSyncularGeneratedCodecs(options.codecs),
-    appTables: syncularGeneratedApp.tableNames,
-    tableConfig: { ...options.tableConfig, ...syncularGeneratedTableConfig },
-    requiredRuntimeFeatures: syncularGeneratedRequiredRuntimeFeatures,
-  });
-  try {
-    await assertSyncularAppRuntime(database);
-    const schemaInstallMode = options.schemaInstallMode ?? 'derived';
-    if (schemaInstallMode === 'derived') {
-      await withSyncularSchemaWrites(database, ensureSyncularAppDerivedSchema);
-    } else if (schemaInstallMode === 'full') {
-      await withSyncularSchemaWrites(database, ensureSyncularAppSchema);
-    } else if (schemaInstallMode === 'base') {
-      await withSyncularSchemaWrites(database, ensureSyncularAppBaseSchema);
-    } else if (schemaInstallMode !== 'none') {
-      throw new Error(`Unknown Syncular schemaInstallMode: ${schemaInstallMode}`);
-    }
-    await database.client.setSubscriptions(resolveSyncularAppSubscriptions(options));
-    const appDatabase = database as unknown as SyncularAppDatabase;
-    const commandHistory = createSyncularCommandHistory<SyncularAppDb>({
-      client: database.client,
-      tableConfig: syncularGeneratedTableConfig,
-      mutations: database.mutations,
-      leasedMutations: database.leasedMutations,
-    });
-    appDatabase.commandHistory = commandHistory.history;
-    appDatabase.mutations = commandHistory.wrapMutations(database.mutations, 'mutations') as SyncularAppMutations;
-    appDatabase.leasedMutations = commandHistory.wrapMutations(database.leasedMutations, 'leasedMutations') as SyncularAppMutations;
-    if (options.lifecycle?.autoStart ?? (options.config.mode ?? 'remote') === 'remote') {
-      await database.start();
-    }
-    return appDatabase;
-  } catch (err) {
-    await database.close();
-    throw err;
-  }
-}
-
-export function defaultSyncularSubscriptions(args: SyncularSubscriptionArgs): SyncularSubscriptionSpec[] {
-  return [
-    taskSubscription(args),
-  ];
-}
-
-export interface TaskTable {
-  id: string;
-  title: string;
-  completed: Generated<number>;
-  user_id: string;
-  created_at: Generated<number>;
-  server_version: Generated<number>;
-}
-
-export interface TaskRow {
-  id: string;
-  title: string;
-  completed: number;
-  user_id: string;
-  created_at: number;
-  server_version: number;
-}
-
-export interface NewTask {
-  id: string;
-  title: string;
-  completed?: number;
-  user_id: string;
-  created_at?: number;
-}
-
-export interface NewTaskPayload {
-  title: string;
-  completed: number;
-  user_id: string;
-  created_at: number;
-}
-
-export type TaskPatch = Partial<Pick<TaskRow, 'title' | 'completed' | 'user_id' | 'created_at'>>;
-
-export function newTaskPayload(input: NewTask): NewTaskPayload {
-  const payload: Partial<NewTaskPayload> = {
-    title: input.title,
-    user_id: input.user_id,
-  };
-  payload.completed = input.completed ?? 0;
-  payload.created_at = input.created_at ?? 0;
-  return payload as NewTaskPayload;
-}
-
-export function taskPatchPayload(patch: TaskPatch): TaskPatch {
-  const payload: TaskPatch = {};
-  if (patch.title !== undefined) payload.title = patch.title;
-  if (patch.completed !== undefined) payload.completed = patch.completed;
-  if (patch.user_id !== undefined) payload.user_id = patch.user_id;
-  if (patch.created_at !== undefined) payload.created_at = patch.created_at;
-  return payload;
-}
-
-export function newTaskOperation(input: NewTask, baseVersion: number | null = 0): SyncularGeneratedOperation {
-  const payload = newTaskPayload(input);
-  return {
-    table: 'tasks',
-    row_id: String(input.id),
-    op: 'upsert',
-    payload: payload as unknown as Record<string, unknown>,
-    base_version: baseVersion,
-  };
-}
-
-export function patchTaskOperation(rowId: string, patch: TaskPatch, baseVersion: number | null = null): SyncularGeneratedOperation {
-  const payload = taskPatchPayload(patch);
-  return {
-    table: 'tasks',
-    row_id: rowId,
-    op: 'upsert',
-    payload: payload as unknown as Record<string, unknown>,
-    base_version: baseVersion,
-  };
-}
-
-export function deleteTaskOperation(rowId: string, baseVersion: number | null = null): SyncularGeneratedOperation {
-  return {
-    table: 'tasks',
-    row_id: rowId,
-    op: 'delete',
-    payload: null,
-    base_version: baseVersion,
-  };
-}
-
-export function taskSubscription(args: SyncularSubscriptionArgs): SyncularSubscriptionSpec {
-  const scopes: Record<string, string | string[]> = {};
-  scopes['user_id'] = args.actorId;
-  return {
-    id: 'sub-tasks',
-    table: 'tasks',
-    scopes,
-    params: {},
-    bootstrapPhase: syncularBootstrapPhase(args, 'tasks', 'sub-tasks'),
-  };
-}