@fragno-dev/db 0.0.1 → 0.1.0

package/dist/fragment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragment.js","names":["#name","#schema","#namespace","#dependencies","#services","#createDatabaseContext"],"sources":["../src/fragment.ts"],"sourcesContent":["import type { AnySchema } from \"./schema/create\";\nimport type { AbstractQuery } from \"./query/query\";\nimport type { DatabaseAdapter } from \"./adapters/adapters\";\nimport type { FragnoPublicConfig, FragmentDefinition } from \"@fragno-dev/core\";\n\n/**\n * Extended FragnoPublicConfig that includes a database adapter.\n * Use this type when creating fragments with database support.\n */\nexport type FragnoPublicConfigWithDatabase = FragnoPublicConfig & {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  databaseAdapter: DatabaseAdapter<any>;\n};\n\n/**\n * Additional context provided to database fragments containing the database adapter and ORM instance.\n */\nexport type DatabaseFragmentContext<TSchema extends AnySchema> = {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  databaseAdapter: DatabaseAdapter<any>;\n  orm: AbstractQuery<TSchema>;\n};\n\nexport class DatabaseFragmentBuilder<\n  const TSchema extends AnySchema,\n  const TConfig,\n  const TDeps = {},\n  const TServices extends Record<string, unknown> = {},\n> {\n  #name: string;\n  #schema?: TSchema;\n  #namespace?: string;\n  #dependencies?: (\n    context: {\n      config: TConfig;\n      fragnoConfig: FragnoPublicConfig;\n    } & DatabaseFragmentContext<TSchema>,\n  ) => TDeps;\n  #services?: (\n    context: {\n      config: TConfig;\n      fragnoConfig: FragnoPublicConfig;\n      deps: TDeps;\n    } & DatabaseFragmentContext<TSchema>,\n  ) => TServices;\n\n  constructor(options: {\n    name: string;\n    schema?: TSchema;\n    namespace?: string;\n    dependencies?: (\n      context: {\n        config: TConfig;\n        fragnoConfig: FragnoPublicConfig;\n      } & DatabaseFragmentContext<TSchema>,\n    ) => TDeps;\n    services?: (\n      context: {\n        config: TConfig;\n        fragnoConfig: FragnoPublicConfig;\n        deps: TDeps;\n      } & DatabaseFragmentContext<TSchema>,\n    ) => TServices;\n  }) {\n    this.#name = options.name;\n    this.#schema = options.schema;\n    this.#namespace = options.namespace;\n    this.#dependencies = options.dependencies;\n    this.#services = options.services;\n  }\n\n  get $requiredOptions(): FragnoPublicConfigWithDatabase {\n    throw new Error(\"Type only method. Do not call.\");\n  }\n\n  get definition(): FragmentDefinition<TConfig, TDeps, TServices> {\n    const schema = this.#schema;\n    const namespace = this.#namespace ?? \"\";\n    const name = this.#name;\n    const dependencies = this.#dependencies;\n    const services = this.#services;\n\n    return {\n      name,\n      dependencies: (config: TConfig, options: FragnoPublicConfig) => {\n        const dbContext = this.#createDatabaseContext(options, schema, namespace, name);\n        return dependencies?.({ config, fragnoConfig: options, ...dbContext }) ?? ({} as TDeps);\n      },\n      services: (config: TConfig, options: FragnoPublicConfig, deps: TDeps) => {\n        const dbContext = this.#createDatabaseContext(options, schema, namespace, name);\n        return (\n          services?.({ config, fragnoConfig: options, deps, ...dbContext }) ?? ({} as TServices)\n        );\n      },\n      additionalContext: {\n        databaseSchema: schema,\n        databaseNamespace: namespace,\n      },\n    };\n  }\n\n  #createDatabaseContext(\n    options: FragnoPublicConfig,\n    schema: TSchema | undefined,\n    namespace: string,\n    name: string,\n  ): DatabaseFragmentContext<TSchema> {\n    // Safe cast: FragnoPublicConfig is extended with databaseAdapter by the user\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const databaseAdapter = (options as any).databaseAdapter as DatabaseAdapter<any> | undefined;\n\n    if (!databaseAdapter) {\n      throw new Error(`Fragment '${name}' requires a database adapter in options.databaseAdapter`);\n    }\n    if (!schema) {\n      throw new Error(`Fragment '${name}' requires a schema. Use withDatabase() to provide one.`);\n    }\n\n    // Safe cast: we create a query engine for TSchema and know it will be AbstractQuery<TSchema>\n    const orm = databaseAdapter.createQueryEngine(\n      schema,\n      namespace,\n    ) as unknown as AbstractQuery<TSchema>;\n\n    return { databaseAdapter, orm };\n  }\n\n  withDatabase<TNewSchema extends AnySchema>(\n    schema: TNewSchema,\n    namespace?: string,\n  ): DatabaseFragmentBuilder<TNewSchema, TConfig, TDeps, TServices> {\n    return new DatabaseFragmentBuilder<TNewSchema, TConfig, TDeps, TServices>({\n      name: this.#name,\n      schema,\n      namespace: namespace ?? this.#name + \"-db\",\n      dependencies: this.#dependencies as\n        | ((\n            context: {\n              config: TConfig;\n              fragnoConfig: FragnoPublicConfig;\n            } & DatabaseFragmentContext<TNewSchema>,\n          ) => TDeps)\n        | undefined,\n      services: this.#services as\n        | ((\n            context: {\n              config: TConfig;\n              fragnoConfig: FragnoPublicConfig;\n              deps: TDeps;\n            } & DatabaseFragmentContext<TNewSchema>,\n          ) => TServices)\n        | undefined,\n    });\n  }\n\n  withDependencies<TNewDeps>(\n    fn: (\n      context: {\n        config: TConfig;\n        fragnoConfig: FragnoPublicConfig;\n      } & DatabaseFragmentContext<TSchema>,\n    ) => TNewDeps,\n  ): DatabaseFragmentBuilder<TSchema, TConfig, TNewDeps, {}> {\n    return new DatabaseFragmentBuilder<TSchema, TConfig, TNewDeps, {}>({\n      name: this.#name,\n      schema: this.#schema,\n      namespace: this.#namespace,\n      dependencies: fn,\n      services: undefined,\n    });\n  }\n\n  withServices<TNewServices extends Record<string, unknown>>(\n    fn: (\n      context: {\n        config: TConfig;\n        fragnoConfig: FragnoPublicConfig;\n        deps: TDeps;\n      } & DatabaseFragmentContext<TSchema>,\n    ) => TNewServices,\n  ): DatabaseFragmentBuilder<TSchema, TConfig, TDeps, TNewServices> {\n    return new DatabaseFragmentBuilder<TSchema, TConfig, TDeps, TNewServices>({\n      name: this.#name,\n      schema: this.#schema,\n      namespace: this.#namespace,\n      dependencies: this.#dependencies,\n      services: fn,\n    });\n  }\n}\n\nexport function defineFragmentWithDatabase<TConfig = {}>(\n  name: string,\n): DatabaseFragmentBuilder<never, TConfig, {}, {}> {\n  return new DatabaseFragmentBuilder<never, TConfig, {}, {}>({\n    name,\n  });\n}\n"],"mappings":";AAuBA,IAAa,0BAAb,MAAa,wBAKX;CACA;CACA;CACA;CACA;CAMA;CAQA,YAAY,SAiBT;AACD,QAAKA,OAAQ,QAAQ;AACrB,QAAKC,SAAU,QAAQ;AACvB,QAAKC,YAAa,QAAQ;AAC1B,QAAKC,eAAgB,QAAQ;AAC7B,QAAKC,WAAY,QAAQ;;CAG3B,IAAI,mBAAmD;AACrD,QAAM,IAAI,MAAM,iCAAiC;;CAGnD,IAAI,aAA4D;EAC9D,MAAM,SAAS,MAAKH;EACpB,MAAM,YAAY,MAAKC,aAAc;EACrC,MAAM,OAAO,MAAKF;EAClB,MAAM,eAAe,MAAKG;EAC1B,MAAM,WAAW,MAAKC;AAEtB,SAAO;GACL;GACA,eAAe,QAAiB,YAAgC;IAC9D,MAAM,YAAY,MAAKC,sBAAuB,SAAS,QAAQ,WAAW,KAAK;AAC/E,WAAO,eAAe;KAAE;KAAQ,cAAc;KAAS,GAAG;KAAW,CAAC,IAAK,EAAE;;GAE/E,WAAW,QAAiB,SAA6B,SAAgB;IACvE,MAAM,YAAY,MAAKA,sBAAuB,SAAS,QAAQ,WAAW,KAAK;AAC/E,WACE,WAAW;KAAE;KAAQ,cAAc;KAAS;KAAM,GAAG;KAAW,CAAC,IAAK,EAAE;;GAG5E,mBAAmB;IACjB,gBAAgB;IAChB,mBAAmB;IACpB;GACF;;CAGH,uBACE,SACA,QACA,WACA,MACkC;EAGlC,MAAM,kBAAmB,QAAgB;AAEzC,MAAI,CAAC,gBACH,OAAM,IAAI,MAAM,aAAa,KAAK,0DAA0D;AAE9F,MAAI,CAAC,OACH,OAAM,IAAI,MAAM,aAAa,KAAK,yDAAyD;AAS7F,SAAO;GAAE;GAAiB,KALd,gBAAgB,kBAC1B,QACA,UACD;GAE8B;;CAGjC,aACE,QACA,WACgE;AAChE,SAAO,IAAI,wBAA+D;GACxE,MAAM,MAAKL;GACX;GACA,WAAW,aAAa,MAAKA,OAAQ;GACrC,cAAc,MAAKG;GAQnB,UAAU,MAAKC;GAShB,CAAC;;CAGJ,iBACE,IAMyD;AACzD,SAAO,IAAI,wBAAwD;GACjE,MAAM,MAAKJ;GACX,QAAQ,MAAKC;GACb,WAAW,MAAKC;GAChB,cAAc;GACd,UAAU;GACX,CAAC;;CAGJ,aACE,IAOgE;AAChE,SAAO,IAAI,wBAA+D;GACxE,MAAM,MAAKF;GACX,QAAQ,MAAKC;GACb,WAAW,MAAKC;GAChB,cAAc,MAAKC;GACnB,UAAU;GACX,CAAC;;;AAIN,SAAgB,2BACd,MACiD;AACjD,QAAO,IAAI,wBAAgD,EACzD,MACD,CAAC"}

package/dist/id.d.ts

@@ -0,0 +1,2 @@
+import { createId } from "@paralleldrive/cuid2";
+export { createId };

package/dist/migration-engine/auto-from-schema.js

@@ -0,0 +1,116 @@
+import "../schema/create.js";
+
+//#region src/migration-engine/auto-from-schema.ts
+/**
+* Generate migration operations from a schema's operation history
+*
+* The schema version number represents the cumulative number of operations applied.
+* This function takes operations from the schema between fromVersion and toVersion,
+* and converts them into migration operations.
+*
+* @param targetSchema - The schema containing the operations history
+* @param fromVersion - The current database version (e.g., 0)
+* @param toVersion - The target version to migrate to (e.g., 5)
+* @param options - Migration generation options
+* @returns Array of migration operations to apply
+*
+* @example
+* ```ts
+* const mySchema = schema(s => s
+*   .addTable("users", t => t.addColumn("id", idColumn()))       // version 1
+*   .addTable("posts", t => t.addColumn("id", idColumn()))       // version 2
+* );
+*
+* // Generate operations from version 0 to 1 (only creates users table)
+* const operations = generateMigrationFromSchema(mySchema, 0, 1);
+* ```
+*/
+function generateMigrationFromSchema(targetSchema, fromVersion, toVersion) {
+	if (fromVersion < 0) throw new Error(`fromVersion cannot be negative: ${fromVersion}`);
+	if (fromVersion > targetSchema.version) throw new Error(`fromVersion (${fromVersion}) exceeds schema version (${targetSchema.version})`);
+	if (toVersion > targetSchema.version) throw new Error(`toVersion (${toVersion}) exceeds schema version (${targetSchema.version})`);
+	if (toVersion < fromVersion) throw new Error(`Cannot migrate backwards: toVersion (${toVersion}) < fromVersion (${fromVersion})`);
+	const relevantOperations = targetSchema.operations.slice(fromVersion, toVersion);
+	const migrationOperations = [];
+	for (const op of relevantOperations) if (op.type === "add-table") {
+		const columns = [];
+		for (const subOp of op.operations) if (subOp.type === "add-column") {
+			const col = subOp.column;
+			columns.push({
+				name: subOp.columnName,
+				type: col.type,
+				isNullable: col.isNullable,
+				role: col.role,
+				default: col.default ? {
+					value: "value" in col.default ? col.default.value : void 0,
+					runtime: "runtime" in col.default ? typeof col.default.runtime === "string" ? col.default.runtime : void 0 : void 0
+				} : void 0
+			});
+		}
+		migrationOperations.push({
+			type: "create-table",
+			name: op.tableName,
+			columns
+		});
+		for (const subOp of op.operations) if (subOp.type === "add-index") migrationOperations.push({
+			type: "add-index",
+			table: op.tableName,
+			name: subOp.name,
+			columns: subOp.columns,
+			unique: subOp.unique
+		});
+		else if (subOp.type === "add-foreign-key") migrationOperations.push({
+			type: "add-foreign-key",
+			table: op.tableName,
+			value: {
+				name: subOp.name,
+				columns: subOp.columns,
+				referencedTable: subOp.referencedTable,
+				referencedColumns: subOp.referencedColumns
+			}
+		});
+	} else if (op.type === "alter-table") {
+		const columnOps = op.operations.filter((o) => o.type === "add-column");
+		if (columnOps.length > 0) migrationOperations.push({
+			type: "alter-table",
+			name: op.tableName,
+			value: columnOps.map((o) => {
+				const col = o.column;
+				return {
+					type: "create-column",
+					value: {
+						name: o.columnName,
+						type: col.type,
+						isNullable: col.isNullable,
+						role: col.role,
+						default: col.default ? {
+							value: "value" in col.default ? col.default.value : void 0,
+							runtime: "runtime" in col.default ? typeof col.default.runtime === "string" ? col.default.runtime : void 0 : void 0
+						} : void 0
+					}
+				};
+			})
+		});
+		for (const subOp of op.operations) if (subOp.type === "add-index") migrationOperations.push({
+			type: "add-index",
+			table: op.tableName,
+			name: subOp.name,
+			columns: subOp.columns,
+			unique: subOp.unique
+		});
+	} else if (op.type === "add-reference") migrationOperations.push({
+		type: "add-foreign-key",
+		table: op.tableName,
+		value: {
+			name: `${op.tableName}_${op.config.to.table}_${op.referenceName}_fk`,
+			columns: [op.config.from.column],
+			referencedTable: op.config.to.table,
+			referencedColumns: [op.config.to.column]
+		}
+	});
+	return migrationOperations;
+}
+
+//#endregion
+export { generateMigrationFromSchema };
+//# sourceMappingURL=auto-from-schema.js.map

package/dist/migration-engine/auto-from-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-from-schema.js","names":["migrationOperations: MigrationOperation[]","columns: ColumnInfo[]"],"sources":["../../src/migration-engine/auto-from-schema.ts"],"sourcesContent":["import { type AnySchema } from \"../schema/create\";\nimport type { MigrationOperation, ColumnInfo } from \"./shared\";\n\n/**\n * Generate migration operations from a schema's operation history\n *\n * The schema version number represents the cumulative number of operations applied.\n * This function takes operations from the schema between fromVersion and toVersion,\n * and converts them into migration operations.\n *\n * @param targetSchema - The schema containing the operations history\n * @param fromVersion - The current database version (e.g., 0)\n * @param toVersion - The target version to migrate to (e.g., 5)\n * @param options - Migration generation options\n * @returns Array of migration operations to apply\n *\n * @example\n * ```ts\n * const mySchema = schema(s => s\n *   .addTable(\"users\", t => t.addColumn(\"id\", idColumn()))       // version 1\n *   .addTable(\"posts\", t => t.addColumn(\"id\", idColumn()))       // version 2\n * );\n *\n * // Generate operations from version 0 to 1 (only creates users table)\n * const operations = generateMigrationFromSchema(mySchema, 0, 1);\n * ```\n */\nexport function generateMigrationFromSchema(\n  targetSchema: AnySchema,\n  fromVersion: number,\n  toVersion: number,\n): MigrationOperation[] {\n  if (fromVersion < 0) {\n    throw new Error(`fromVersion cannot be negative: ${fromVersion}`);\n  }\n\n  if (fromVersion > targetSchema.version) {\n    throw new Error(\n      `fromVersion (${fromVersion}) exceeds schema version (${targetSchema.version})`,\n    );\n  }\n\n  if (toVersion > targetSchema.version) {\n    throw new Error(`toVersion (${toVersion}) exceeds schema version (${targetSchema.version})`);\n  }\n\n  if (toVersion < fromVersion) {\n    throw new Error(\n      `Cannot migrate backwards: toVersion (${toVersion}) < fromVersion (${fromVersion})`,\n    );\n  }\n\n  // Get operations between fromVersion and toVersion\n  // Operations are 1-indexed (operation 0 is version 0→1)\n  const relevantOperations = targetSchema.operations.slice(fromVersion, toVersion);\n\n  // Convert schema operations to migration operations\n  const migrationOperations: MigrationOperation[] = [];\n\n  for (const op of relevantOperations) {\n    if (op.type === \"add-table\") {\n      // Collect columns for create-table operation\n      const columns: ColumnInfo[] = [];\n\n      for (const subOp of op.operations) {\n        if (subOp.type === \"add-column\") {\n          const col = subOp.column;\n          columns.push({\n            name: subOp.columnName,\n            type: col.type,\n            isNullable: col.isNullable,\n            role: col.role,\n            default: col.default\n              ? {\n                  value: \"value\" in col.default ? col.default.value : undefined,\n                  runtime:\n                    \"runtime\" in col.default\n                      ? typeof col.default.runtime === \"string\"\n                        ? col.default.runtime\n                        : undefined\n                      : undefined,\n                }\n              : undefined,\n          });\n        }\n      }\n\n      migrationOperations.push({\n        type: \"create-table\",\n        name: op.tableName,\n        columns,\n      });\n\n      // Add indexes and foreign keys as separate operations\n      for (const subOp of op.operations) {\n        if (subOp.type === \"add-index\") {\n          migrationOperations.push({\n            type: \"add-index\",\n            table: op.tableName,\n            name: subOp.name,\n            columns: subOp.columns,\n            unique: subOp.unique,\n          });\n        } else if (subOp.type === \"add-foreign-key\") {\n          migrationOperations.push({\n            type: \"add-foreign-key\",\n            table: op.tableName,\n            value: {\n              name: subOp.name,\n              columns: subOp.columns,\n              referencedTable: subOp.referencedTable,\n              referencedColumns: subOp.referencedColumns,\n            },\n          });\n        }\n      }\n    } else if (op.type === \"alter-table\") {\n      const columnOps = op.operations.filter((o) => o.type === \"add-column\");\n\n      if (columnOps.length > 0) {\n        migrationOperations.push({\n          type: \"alter-table\",\n          name: op.tableName,\n          value: columnOps.map((o) => {\n            const col = o.column;\n            return {\n              type: \"create-column\" as const,\n              value: {\n                name: o.columnName,\n                type: col.type,\n                isNullable: col.isNullable,\n                role: col.role,\n                default: col.default\n                  ? {\n                      value: \"value\" in col.default ? col.default.value : undefined,\n                      runtime:\n                        \"runtime\" in col.default\n                          ? typeof col.default.runtime === \"string\"\n                            ? col.default.runtime\n                            : undefined\n                          : undefined,\n                    }\n                  : undefined,\n              },\n            };\n          }),\n        });\n      }\n\n      // Add indexes as separate operations\n      for (const subOp of op.operations) {\n        if (subOp.type === \"add-index\") {\n          migrationOperations.push({\n            type: \"add-index\",\n            table: op.tableName,\n            name: subOp.name,\n            columns: subOp.columns,\n            unique: subOp.unique,\n          });\n        }\n      }\n    } else if (op.type === \"add-reference\") {\n      migrationOperations.push({\n        type: \"add-foreign-key\",\n        table: op.tableName,\n        value: {\n          name: `${op.tableName}_${op.config.to.table}_${op.referenceName}_fk`,\n          columns: [op.config.from.column],\n          referencedTable: op.config.to.table,\n          referencedColumns: [op.config.to.column],\n        },\n      });\n    }\n  }\n\n  return migrationOperations;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,SAAgB,4BACd,cACA,aACA,WACsB;AACtB,KAAI,cAAc,EAChB,OAAM,IAAI,MAAM,mCAAmC,cAAc;AAGnE,KAAI,cAAc,aAAa,QAC7B,OAAM,IAAI,MACR,gBAAgB,YAAY,4BAA4B,aAAa,QAAQ,GAC9E;AAGH,KAAI,YAAY,aAAa,QAC3B,OAAM,IAAI,MAAM,cAAc,UAAU,4BAA4B,aAAa,QAAQ,GAAG;AAG9F,KAAI,YAAY,YACd,OAAM,IAAI,MACR,wCAAwC,UAAU,mBAAmB,YAAY,GAClF;CAKH,MAAM,qBAAqB,aAAa,WAAW,MAAM,aAAa,UAAU;CAGhF,MAAMA,sBAA4C,EAAE;AAEpD,MAAK,MAAM,MAAM,mBACf,KAAI,GAAG,SAAS,aAAa;EAE3B,MAAMC,UAAwB,EAAE;AAEhC,OAAK,MAAM,SAAS,GAAG,WACrB,KAAI,MAAM,SAAS,cAAc;GAC/B,MAAM,MAAM,MAAM;AAClB,WAAQ,KAAK;IACX,MAAM,MAAM;IACZ,MAAM,IAAI;IACV,YAAY,IAAI;IAChB,MAAM,IAAI;IACV,SAAS,IAAI,UACT;KACE,OAAO,WAAW,IAAI,UAAU,IAAI,QAAQ,QAAQ;KACpD,SACE,aAAa,IAAI,UACb,OAAO,IAAI,QAAQ,YAAY,WAC7B,IAAI,QAAQ,UACZ,SACF;KACP,GACD;IACL,CAAC;;AAIN,sBAAoB,KAAK;GACvB,MAAM;GACN,MAAM,GAAG;GACT;GACD,CAAC;AAGF,OAAK,MAAM,SAAS,GAAG,WACrB,KAAI,MAAM,SAAS,YACjB,qBAAoB,KAAK;GACvB,MAAM;GACN,OAAO,GAAG;GACV,MAAM,MAAM;GACZ,SAAS,MAAM;GACf,QAAQ,MAAM;GACf,CAAC;WACO,MAAM,SAAS,kBACxB,qBAAoB,KAAK;GACvB,MAAM;GACN,OAAO,GAAG;GACV,OAAO;IACL,MAAM,MAAM;IACZ,SAAS,MAAM;IACf,iBAAiB,MAAM;IACvB,mBAAmB,MAAM;IAC1B;GACF,CAAC;YAGG,GAAG,SAAS,eAAe;EACpC,MAAM,YAAY,GAAG,WAAW,QAAQ,MAAM,EAAE,SAAS,aAAa;AAEtE,MAAI,UAAU,SAAS,EACrB,qBAAoB,KAAK;GACvB,MAAM;GACN,MAAM,GAAG;GACT,OAAO,UAAU,KAAK,MAAM;IAC1B,MAAM,MAAM,EAAE;AACd,WAAO;KACL,MAAM;KACN,OAAO;MACL,MAAM,EAAE;MACR,MAAM,IAAI;MACV,YAAY,IAAI;MAChB,MAAM,IAAI;MACV,SAAS,IAAI,UACT;OACE,OAAO,WAAW,IAAI,UAAU,IAAI,QAAQ,QAAQ;OACpD,SACE,aAAa,IAAI,UACb,OAAO,IAAI,QAAQ,YAAY,WAC7B,IAAI,QAAQ,UACZ,SACF;OACP,GACD;MACL;KACF;KACD;GACH,CAAC;AAIJ,OAAK,MAAM,SAAS,GAAG,WACrB,KAAI,MAAM,SAAS,YACjB,qBAAoB,KAAK;GACvB,MAAM;GACN,OAAO,GAAG;GACV,MAAM,MAAM;GACZ,SAAS,MAAM;GACf,QAAQ,MAAM;GACf,CAAC;YAGG,GAAG,SAAS,gBACrB,qBAAoB,KAAK;EACvB,MAAM;EACN,OAAO,GAAG;EACV,OAAO;GACL,MAAM,GAAG,GAAG,UAAU,GAAG,GAAG,OAAO,GAAG,MAAM,GAAG,GAAG,cAAc;GAChE,SAAS,CAAC,GAAG,OAAO,KAAK,OAAO;GAChC,iBAAiB,GAAG,OAAO,GAAG;GAC9B,mBAAmB,CAAC,GAAG,OAAO,GAAG,OAAO;GACzC;EACF,CAAC;AAIN,QAAO"}

package/dist/migration-engine/create.d.ts

@@ -0,0 +1,41 @@
+import { MigrationOperation } from "./shared.js";
+
+//#region src/migration-engine/create.d.ts
+
+interface MigrateOptions {
+  /**
+   * Update internal settings, it's true by default.
+   * We don't recommend to disable it other than testing purposes.
+   */
+  updateSettings?: boolean;
+}
+interface PreparedMigration {
+  operations: MigrationOperation[];
+  getSQL?: () => string;
+  execute: () => Promise<void>;
+}
+interface Migrator {
+  /**
+   * Get current version (returns 0 if not initialized)
+   */
+  getVersion: () => Promise<number>;
+  /**
+   * Migrate to the latest schema version
+   */
+  prepareMigration: (options?: MigrateOptions) => Promise<PreparedMigration>;
+  /**
+   * Migrate to a specific version (only forward migrations allowed)
+   * @param toVersion - Target version to migrate to
+   * @param options - Migration options including optional fromVersion
+   */
+  prepareMigrationTo: (toVersion: number, options?: MigrateOptions & {
+    fromVersion?: number;
+  }) => Promise<PreparedMigration>;
+  /**
+   * Get default file name for migration SQL
+   */
+  getDefaultFileName?: (namespace: string, fromVersion: number, toVersion: number) => string;
+}
+//#endregion
+export { Migrator };
+//# sourceMappingURL=create.d.ts.map

package/dist/migration-engine/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","names":[],"sources":["../../src/migration-engine/create.ts"],"sourcesContent":[],"mappings":";;;;AAmC0D,UAvBzC,cAAA,CAuByC;EAAR;;;;EAUpC,cAAA,CAAA,EAAA,OAAA;;UAzBG,iBAAA;cACH;;iBAEG;;UAGA,QAAA;;;;oBAIG;;;;+BAKW,mBAAmB,QAAQ;;;;;;oDAS5C;;QACP,QAAQ"}

package/dist/migration-engine/create.js

@@ -0,0 +1,58 @@
+import { generateMigrationFromSchema } from "./auto-from-schema.js";
+
+//#region src/migration-engine/create.ts
+function createMigrator({ settings, generateMigrationFromSchema: generateMigrationFromSchema$1 = generateMigrationFromSchema, schema: targetSchema, executor, sql: sqlConfig, transformers = [] }) {
+	return {
+		getVersion() {
+			return settings.getVersion();
+		},
+		async prepareMigration(options = {}) {
+			return this.prepareMigrationTo(targetSchema.version, options);
+		},
+		async prepareMigrationTo(toVersion, options = {}) {
+			const { updateSettings: updateVersion = true, fromVersion: providedFromVersion } = options;
+			const fromVersion = providedFromVersion ?? await settings.getVersion();
+			if (toVersion < 0) throw new Error(`Cannot migrate to negative version: ${toVersion}`);
+			if (fromVersion < 0) throw new Error(`Cannot migrate from negative version: ${fromVersion}`);
+			if (toVersion < fromVersion) throw new Error(`Cannot migrate backwards: current version is ${fromVersion}, target is ${toVersion}. Only forward migrations are supported.`);
+			if (toVersion > targetSchema.version) throw new Error(`Cannot migrate to version ${toVersion}: schema only has version ${targetSchema.version}`);
+			if (fromVersion > targetSchema.version) throw new Error(`Cannot migrate from version ${fromVersion}: schema only has version ${targetSchema.version}`);
+			if (toVersion === fromVersion) return {
+				operations: [],
+				getSQL: sqlConfig ? () => sqlConfig.toSql([]) : void 0,
+				execute: async () => {}
+			};
+			const context = { async auto() {
+				let generated = generateMigrationFromSchema$1(targetSchema, fromVersion, toVersion);
+				for (const transformer of transformers) {
+					if (!transformer.afterAuto) continue;
+					generated = transformer.afterAuto(generated, {
+						fromVersion,
+						toVersion,
+						schema: targetSchema,
+						options
+					});
+				}
+				return generated;
+			} };
+			let operations = updateVersion ? [...await settings.updateSettingsInMigration(fromVersion, toVersion), ...await context.auto()] : await context.auto();
+			for (const transformer of transformers) {
+				if (!transformer.afterAll) continue;
+				operations = transformer.afterAll(operations, {
+					fromVersion,
+					toVersion,
+					schema: targetSchema
+				});
+			}
+			return {
+				operations,
+				getSQL: sqlConfig ? () => sqlConfig.toSql(operations) : void 0,
+				execute: () => executor(operations)
+			};
+		}
+	};
+}
+
+//#endregion
+export { createMigrator };
+//# sourceMappingURL=create.js.map

package/dist/migration-engine/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","names":["defaultGenerateMigrationFromSchema","context: MigrationContext","generateMigrationFromSchema"],"sources":["../../src/migration-engine/create.ts"],"sourcesContent":["import { type MigrationOperation } from \"./shared\";\nimport type { AnySchema } from \"../schema/create\";\nimport { generateMigrationFromSchema as defaultGenerateMigrationFromSchema } from \"./auto-from-schema\";\n\ntype Awaitable<T> = T | Promise<T>;\n\ninterface MigrationContext {\n  auto: () => Promise<MigrationOperation[]>;\n}\n\nexport type CustomMigrationFn = (context: MigrationContext) => Awaitable<MigrationOperation[]>;\n\nexport interface MigrateOptions {\n  /**\n   * Update internal settings, it's true by default.\n   * We don't recommend to disable it other than testing purposes.\n   */\n  updateSettings?: boolean;\n}\n\nexport interface PreparedMigration {\n  operations: MigrationOperation[];\n  getSQL?: () => string;\n  execute: () => Promise<void>;\n}\n\nexport interface Migrator {\n  /**\n   * Get current version (returns 0 if not initialized)\n   */\n  getVersion: () => Promise<number>;\n\n  /**\n   * Migrate to the latest schema version\n   */\n  prepareMigration: (options?: MigrateOptions) => Promise<PreparedMigration>;\n\n  /**\n   * Migrate to a specific version (only forward migrations allowed)\n   * @param toVersion - Target version to migrate to\n   * @param options - Migration options including optional fromVersion\n   */\n  prepareMigrationTo: (\n    toVersion: number,\n    options?: MigrateOptions & { fromVersion?: number },\n  ) => Promise<PreparedMigration>;\n\n  /**\n   * Get default file name for migration SQL\n   */\n  getDefaultFileName?: (namespace: string, fromVersion: number, toVersion: number) => string;\n}\n\nexport interface MigrationEngineOptions {\n  /**\n   * The target schema to migrate to\n   */\n  schema: AnySchema;\n\n  executor: (operations: MigrationOperation[]) => Promise<void>;\n\n  generateMigrationFromSchema?: typeof defaultGenerateMigrationFromSchema;\n\n  settings: {\n    /**\n     * Get current version from database (0 if not initialized)\n     */\n    getVersion: () => Promise<number>;\n\n    updateSettingsInMigration: (\n      fromVersion: number,\n      toVersion: number,\n    ) => Awaitable<MigrationOperation[]>;\n  };\n\n  sql?: {\n    toSql: (operations: MigrationOperation[]) => string;\n  };\n\n  transformers?: MigrationTransformer[];\n}\n\nexport interface MigrationTransformer {\n  /**\n   * Run after auto-generating migration operations\n   */\n  afterAuto?: (\n    operations: MigrationOperation[],\n    context: {\n      options: MigrateOptions;\n      fromVersion: number;\n      toVersion: number;\n      schema: AnySchema;\n    },\n  ) => MigrationOperation[];\n\n  /**\n   * Run on all migration operations\n   */\n  afterAll?: (\n    operations: MigrationOperation[],\n    context: {\n      fromVersion: number;\n      toVersion: number;\n      schema: AnySchema;\n    },\n  ) => MigrationOperation[];\n}\n\nexport function createMigrator({\n  settings,\n  generateMigrationFromSchema = defaultGenerateMigrationFromSchema,\n  schema: targetSchema,\n  executor,\n  sql: sqlConfig,\n  transformers = [],\n}: MigrationEngineOptions): Migrator {\n  const instance: Migrator = {\n    getVersion() {\n      return settings.getVersion();\n    },\n    async prepareMigration(options = {}) {\n      return this.prepareMigrationTo(targetSchema.version, options);\n    },\n    async prepareMigrationTo(toVersion, options = {}) {\n      const { updateSettings: updateVersion = true, fromVersion: providedFromVersion } = options;\n\n      // Use provided fromVersion if available, otherwise query the database\n      const fromVersion = providedFromVersion ?? (await settings.getVersion());\n\n      if (toVersion < 0) {\n        throw new Error(`Cannot migrate to negative version: ${toVersion}`);\n      }\n\n      if (fromVersion < 0) {\n        throw new Error(`Cannot migrate from negative version: ${fromVersion}`);\n      }\n\n      if (toVersion < fromVersion) {\n        throw new Error(\n          `Cannot migrate backwards: current version is ${fromVersion}, target is ${toVersion}. Only forward migrations are supported.`,\n        );\n      }\n\n      if (toVersion > targetSchema.version) {\n        throw new Error(\n          `Cannot migrate to version ${toVersion}: schema only has version ${targetSchema.version}`,\n        );\n      }\n\n      if (fromVersion > targetSchema.version) {\n        throw new Error(\n          `Cannot migrate from version ${fromVersion}: schema only has version ${targetSchema.version}`,\n        );\n      }\n\n      if (toVersion === fromVersion) {\n        // Already at target version, return empty migration\n        return {\n          operations: [],\n          getSQL: sqlConfig ? () => sqlConfig.toSql([]) : undefined,\n          execute: async () => {},\n        };\n      }\n\n      const context: MigrationContext = {\n        async auto() {\n          let generated = generateMigrationFromSchema(targetSchema, fromVersion, toVersion);\n\n          for (const transformer of transformers) {\n            if (!transformer.afterAuto) {\n              continue;\n            }\n\n            generated = transformer.afterAuto(generated, {\n              fromVersion,\n              toVersion,\n              schema: targetSchema,\n              options,\n            });\n          }\n\n          return generated;\n        },\n      };\n\n      let operations = updateVersion\n        ? [\n            ...(await settings.updateSettingsInMigration(fromVersion, toVersion)),\n            ...(await context.auto()),\n          ]\n        : await context.auto();\n\n      for (const transformer of transformers) {\n        if (!transformer.afterAll) {\n          continue;\n        }\n        operations = transformer.afterAll(operations, {\n          fromVersion,\n          toVersion,\n          schema: targetSchema,\n        });\n      }\n\n      return {\n        operations,\n        getSQL: sqlConfig ? () => sqlConfig.toSql(operations) : undefined,\n        execute: () => executor(operations),\n      };\n    },\n  };\n\n  return instance;\n}\n"],"mappings":";;;AA6GA,SAAgB,eAAe,EAC7B,UACA,6DAA8BA,6BAC9B,QAAQ,cACR,UACA,KAAK,WACL,eAAe,EAAE,IACkB;AAgGnC,QA/F2B;EACzB,aAAa;AACX,UAAO,SAAS,YAAY;;EAE9B,MAAM,iBAAiB,UAAU,EAAE,EAAE;AACnC,UAAO,KAAK,mBAAmB,aAAa,SAAS,QAAQ;;EAE/D,MAAM,mBAAmB,WAAW,UAAU,EAAE,EAAE;GAChD,MAAM,EAAE,gBAAgB,gBAAgB,MAAM,aAAa,wBAAwB;GAGnF,MAAM,cAAc,uBAAwB,MAAM,SAAS,YAAY;AAEvE,OAAI,YAAY,EACd,OAAM,IAAI,MAAM,uCAAuC,YAAY;AAGrE,OAAI,cAAc,EAChB,OAAM,IAAI,MAAM,yCAAyC,cAAc;AAGzE,OAAI,YAAY,YACd,OAAM,IAAI,MACR,gDAAgD,YAAY,cAAc,UAAU,0CACrF;AAGH,OAAI,YAAY,aAAa,QAC3B,OAAM,IAAI,MACR,6BAA6B,UAAU,4BAA4B,aAAa,UACjF;AAGH,OAAI,cAAc,aAAa,QAC7B,OAAM,IAAI,MACR,+BAA+B,YAAY,4BAA4B,aAAa,UACrF;AAGH,OAAI,cAAc,YAEhB,QAAO;IACL,YAAY,EAAE;IACd,QAAQ,kBAAkB,UAAU,MAAM,EAAE,CAAC,GAAG;IAChD,SAAS,YAAY;IACtB;GAGH,MAAMC,UAA4B,EAChC,MAAM,OAAO;IACX,IAAI,YAAYC,8BAA4B,cAAc,aAAa,UAAU;AAEjF,SAAK,MAAM,eAAe,cAAc;AACtC,SAAI,CAAC,YAAY,UACf;AAGF,iBAAY,YAAY,UAAU,WAAW;MAC3C;MACA;MACA,QAAQ;MACR;MACD,CAAC;;AAGJ,WAAO;MAEV;GAED,IAAI,aAAa,gBACb,CACE,GAAI,MAAM,SAAS,0BAA0B,aAAa,UAAU,EACpE,GAAI,MAAM,QAAQ,MAAM,CACzB,GACD,MAAM,QAAQ,MAAM;AAExB,QAAK,MAAM,eAAe,cAAc;AACtC,QAAI,CAAC,YAAY,SACf;AAEF,iBAAa,YAAY,SAAS,YAAY;KAC5C;KACA;KACA,QAAQ;KACT,CAAC;;AAGJ,UAAO;IACL;IACA,QAAQ,kBAAkB,UAAU,MAAM,WAAW,GAAG;IACxD,eAAe,SAAS,WAAW;IACpC;;EAEJ"}

package/dist/migration-engine/shared.d.ts

@@ -0,0 +1,90 @@
+//#region src/migration-engine/shared.d.ts
+interface ForeignKeyInfo {
+  name: string;
+  columns: string[];
+  referencedTable: string;
+  referencedColumns: string[];
+}
+interface ColumnInfo {
+  name: string;
+  type: "string" | "integer" | "bigint" | "decimal" | "bool" | "date" | "timestamp" | "json" | "binary" | `varchar(${number})`;
+  isNullable: boolean;
+  role: "external-id" | "internal-id" | "version" | "reference" | "regular";
+  default?: {
+    value?: unknown;
+    runtime?: "now" | "auto";
+  };
+}
+type MigrationOperation = TableOperation | {
+  type: "add-foreign-key";
+  table: string;
+  value: ForeignKeyInfo;
+} | {
+  type: "drop-foreign-key";
+  table: string;
+  name: string;
+} | {
+  type: "drop-index";
+  table: string;
+  name: string;
+} | {
+  type: "add-index";
+  table: string;
+  columns: string[];
+  name: string;
+  unique: boolean;
+} | CustomOperation;
+type CustomOperation = {
+  type: "custom";
+} & Record<string, unknown>;
+type TableOperation = {
+  type: "create-table";
+  name: string;
+  columns: ColumnInfo[];
+} | {
+  type: "drop-table";
+  name: string;
+} | {
+  type: "alter-table";
+  name: string;
+  value: ColumnOperation[];
+} | {
+  type: "rename-table";
+  from: string;
+  to: string;
+};
+type ColumnOperation = {
+  type: "rename-column";
+  from: string;
+  to: string;
+} | {
+  type: "drop-column";
+  name: string;
+} | {
+  /**
+   * Note: unique constraints are not created, please use dedicated operations like `add-index` instead
+   */
+  type: "create-column";
+  value: ColumnInfo;
+} | {
+  /**
+   * warning: Not supported by SQLite
+   */
+  type: "update-column";
+  name: string;
+  /**
+   * For databases like MySQL, it requires the full definition for any modify column statement.
+   * Hence, you need to specify the full information of your column here.
+   *
+   * Then, opt-in for in-detail modification for other databases that supports changing data type/nullable/default separately, such as PostgreSQL.
+   *
+   * Note: unique constraints are not updated, please use dedicated operations like `add-index` instead
+   */
+  value: ColumnInfo;
+  updateNullable: boolean;
+  updateDefault: boolean;
+  updateDataType: boolean;
+};
+//#endregion
+export { MigrationOperation };
+//# sourceMappingURL=shared.d.ts.map

package/dist/migration-engine/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","names":[],"sources":["../../src/migration-engine/shared.ts"],"sourcesContent":[],"mappings":";UAAiB,cAAA;EAAA,IAAA,EAAA,MAAA;EAOA,OAAA,EAAA,MAAU,EAAA;EAqBf,eAAA,EAAA,MAAkB;EAC1B,iBAAA,EAAA,MAAA,EAAA;;AAyBA,UA/Ca,UAAA,CA+Cb;EAAe,IAAA,EAAA,MAAA;EAEP,IAAA,EAAA,QAAA,GAAA,SAAe,GAAA,QAEvB,GAAM,SAAA,GAAA,MAAA,GAAA,MAAA,GAAA,WAAA,GAAA,MAAA,GAAA,QAAA,GAAA,WAAA,MAAA,GAAA;EAEE,UAAA,EAAA,OAAc;EAqBd,IAAA,EAAA,aAAe,GAAA,aAed,GAAA,SAgBA,GAAA,WAAU,GAAA,SAAA;;;;;;KApFX,kBAAA,GACR;;;SAKS;;;;;;;;;;;;;;;IAoBT;KAEQ,eAAA;;IAER;KAEQ,cAAA;;;WAIG;;;;;;;SASF;;;;;;KAQD,eAAA;;;;;;;;;;;;SAeC;;;;;;;;;;;;;;;SAgBA"}

package/dist/migration-engine/shared.js

@@ -0,0 +1,8 @@
+//#region src/migration-engine/shared.ts
+function isUpdated(op) {
+	return op.updateDataType || op.updateDefault || op.updateNullable;
+}
+
+//#endregion
+export { isUpdated };
+//# sourceMappingURL=shared.js.map

package/dist/migration-engine/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","names":[],"sources":["../../src/migration-engine/shared.ts"],"sourcesContent":["export interface ForeignKeyInfo {\n  name: string;\n  columns: string[];\n  referencedTable: string;\n  referencedColumns: string[];\n}\n\nexport interface ColumnInfo {\n  name: string;\n  type:\n    | \"string\"\n    | \"integer\"\n    | \"bigint\"\n    | \"decimal\"\n    | \"bool\"\n    | \"date\"\n    | \"timestamp\"\n    | \"json\"\n    | \"binary\"\n    | `varchar(${number})`;\n  isNullable: boolean;\n  role: \"external-id\" | \"internal-id\" | \"version\" | \"reference\" | \"regular\";\n  default?: {\n    value?: unknown;\n    runtime?: \"now\" | \"auto\";\n  };\n}\n\nexport type MigrationOperation =\n  | TableOperation\n  | {\n      // warning: not supported by SQLite\n      type: \"add-foreign-key\";\n      table: string;\n      value: ForeignKeyInfo;\n    }\n  | {\n      // warning: not supported by SQLite\n      type: \"drop-foreign-key\";\n      table: string;\n      name: string;\n    }\n  | {\n      type: \"drop-index\";\n      table: string;\n      name: string;\n    }\n  | {\n      type: \"add-index\";\n      table: string;\n      columns: string[];\n      name: string;\n      unique: boolean;\n    }\n  | CustomOperation;\n\nexport type CustomOperation = {\n  type: \"custom\";\n} & Record<string, unknown>;\n\nexport type TableOperation =\n  | {\n      type: \"create-table\";\n      name: string;\n      columns: ColumnInfo[];\n    }\n  | {\n      type: \"drop-table\";\n      name: string;\n    }\n  | {\n      type: \"alter-table\";\n      name: string;\n      value: ColumnOperation[];\n    }\n  | {\n      type: \"rename-table\";\n      from: string;\n      to: string;\n    };\n\nexport type ColumnOperation =\n  | {\n      type: \"rename-column\";\n      from: string;\n      to: string;\n    }\n  | {\n      type: \"drop-column\";\n      name: string;\n    }\n  | {\n      /**\n       * Note: unique constraints are not created, please use dedicated operations like `add-index` instead\n       */\n      type: \"create-column\";\n      value: ColumnInfo;\n    }\n  | {\n      /**\n       * warning: Not supported by SQLite\n       */\n      type: \"update-column\";\n      name: string;\n      /**\n       * For databases like MySQL, it requires the full definition for any modify column statement.\n       * Hence, you need to specify the full information of your column here.\n       *\n       * Then, opt-in for in-detail modification for other databases that supports changing data type/nullable/default separately, such as PostgreSQL.\n       *\n       * Note: unique constraints are not updated, please use dedicated operations like `add-index` instead\n       */\n      value: ColumnInfo;\n\n      updateNullable: boolean;\n      updateDefault: boolean;\n      updateDataType: boolean;\n    };\n\nexport function isUpdated(op: Extract<ColumnOperation, { type: \"update-column\" }>): boolean {\n  return op.updateDataType || op.updateDefault || op.updateNullable;\n}\n"],"mappings":";AAuHA,SAAgB,UAAU,IAAkE;AAC1F,QAAO,GAAG,kBAAkB,GAAG,iBAAiB,GAAG"}

package/dist/mod.d.ts

@@ -1,5 +1,58 @@
+import { AnySchema } from "./schema/create.js";
+import { AbstractQuery } from "./query/query.js";
+import { DatabaseAdapter } from "./adapters/adapters.js";
+import { DatabaseFragmentBuilder, DatabaseFragmentContext, FragnoPublicConfigWithDatabase, defineFragmentWithDatabase } from "./fragment.js";
+
 //#region src/mod.d.ts
-declare const hello = "world";
+declare const fragnoDatabaseFakeSymbol: "$fragno-database";
+declare const fragnoDatabaseLibraryVersion: "0.1";
+interface CreateFragnoDatabaseDefinitionOptions<T extends AnySchema> {
+  namespace: string;
+  schema: T;
+}
+declare function isFragnoDatabase(value: unknown): value is FragnoDatabase<AnySchema>;
+/**
+ * Definition of a Fragno database schema and namespace.
+ * Created by library authors using defineFragnoDatabase().
+ * Apps instantiate it by calling .create(adapter).
+ */
+declare class FragnoDatabaseDefinition<const T extends AnySchema> {
+  #private;
+  constructor(options: CreateFragnoDatabaseDefinitionOptions<T>);
+  get namespace(): string;
+  get schema(): T;
+  /**
+   * Creates a FragnoDatabase instance by binding an adapter to this definition.
+   */
+  create(adapter: DatabaseAdapter): FragnoDatabase<T>;
+}
+/**
+ * A Fragno database instance with a bound adapter.
+ * Created from a FragnoDatabaseDefinition by calling .create(adapter).
+ */
+declare class FragnoDatabase<const T extends AnySchema> {
+  #private;
+  constructor(options: {
+    namespace: string;
+    schema: T;
+    adapter: DatabaseAdapter;
+  });
+  get [fragnoDatabaseFakeSymbol](): typeof fragnoDatabaseFakeSymbol;
+  createClient(): Promise<AbstractQuery<T>>;
+  runMigrations(): Promise<boolean>;
+  get namespace(): string;
+  get schema(): T;
+  get adapter(): DatabaseAdapter<void>;
+  generateSchema(options?: {
+    path?: string;
+    toVersion?: number;
+    fromVersion?: number;
+  }): Promise<{
+    schema: string;
+    path: string;
+  }>;
+}
+declare function defineFragnoDatabase<const TSchema extends AnySchema>(options: CreateFragnoDatabaseDefinitionOptions<TSchema>): FragnoDatabaseDefinition<TSchema>;
 //#endregion
-export { hello };
+export { CreateFragnoDatabaseDefinitionOptions, type DatabaseAdapter, DatabaseFragmentBuilder, type DatabaseFragmentContext, FragnoDatabase, FragnoDatabaseDefinition, type FragnoPublicConfigWithDatabase, defineFragmentWithDatabase, defineFragnoDatabase, fragnoDatabaseFakeSymbol, fragnoDatabaseLibraryVersion, isFragnoDatabase };
 //# sourceMappingURL=mod.d.ts.map

package/dist/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","names":[],"sources":["../src/mod.ts"],"sourcesContent":[],"mappings":";cAAa,KAAA"}
+{"version":3,"file":"mod.d.ts","names":[],"sources":["../src/mod.ts"],"sourcesContent":[],"mappings":";;;;;;cAMa;cACA;AADA,UAGI,qCAHkD,CAAA,UAGF,SAHE,CAAA,CAAA;EACtD,SAAA,EAAA,MAAA;EAEI,MAAA,EAEP,CAFO;AAKjB;AAoBa,iBApBG,gBAAA,CAoBqB,KAAA,EAAA,OAAA,CAAA,EAAA,KAAA,IApBsB,cAoBtB,CApBqC,SAoBrC,CAAA;;;;;;AAoBc,cApBtC,wBAoBsC,CAAA,gBApBG,SAoBH,CAAA,CAAA;EAAf,CAAA,OAAA;EAAc,WAAA,CAAA,OAAA,EAhB3B,qCAgB2B,CAhBW,CAgBX,CAAA;EAarC,IAAA,SAAA,CAAA,CAAA,EAAc,MAAA;EAAiB,IAAA,MAAA,CAAA,CAAA,EApBhC,CAoBgC;EAKQ;;;EAM7C,MAAA,CAAA,OAAA,EAxBW,eAwBX,CAAA,EAxB6B,cAwB7B,CAxB4C,CAwB5C,CAAA;;;;;;AAoCM,cA/CA,cA+CA,CAAA,gBA/C+B,SA+C/B,CAAA,CAAA;EAQP,CAAA,OAAA;EAAO,WAAA,CAAA,OAAA,EAAA;IA+DG,SAAA,EAAA,MAAA;IAA2C,MAAA,EAjHP,CAiHO;IACV,OAAA,EAlHe,eAkHf;EAAtC,CAAA;EACiB,KA7GrB,wBAAA,GA6GqB,EAAA,OA7Ge,wBA6Gf;EAAzB,YAAA,CAAA,CAAA,EAzGqB,OAyGrB,CAzG6B,aAyG7B,CAzG2C,CAyG3C,CAAA,CAAA;EAAwB,aAAA,CAAA,CAAA,EA7FF,OA6FE,CAAA,OAAA,CAAA;;gBA7Ef;iBAIC;;;;;MAQP;;;;;iBA+DU,2CAA2C,oBAChD,sCAAsC,WAC9C,yBAAyB"}

package/dist/mod.js

@@ -1,6 +1,115 @@
+import { DatabaseFragmentBuilder, defineFragmentWithDatabase } from "./fragment.js";
+
 //#region src/mod.ts
-const hello = "world";
+const fragnoDatabaseFakeSymbol = "$fragno-database";
+const fragnoDatabaseLibraryVersion = "0.1";
+function isFragnoDatabase(value) {
+	if (value instanceof FragnoDatabase) return true;
+	if (typeof value !== "object" || value === null) return false;
+	return fragnoDatabaseFakeSymbol in value && value[fragnoDatabaseFakeSymbol] === fragnoDatabaseFakeSymbol;
+}
+/**
+* Definition of a Fragno database schema and namespace.
+* Created by library authors using defineFragnoDatabase().
+* Apps instantiate it by calling .create(adapter).
+*/
+var FragnoDatabaseDefinition = class {
+	#namespace;
+	#schema;
+	constructor(options) {
+		this.#namespace = options.namespace;
+		this.#schema = options.schema;
+	}
+	get namespace() {
+		return this.#namespace;
+	}
+	get schema() {
+		return this.#schema;
+	}
+	/**
+	* Creates a FragnoDatabase instance by binding an adapter to this definition.
+	*/
+	create(adapter) {
+		return new FragnoDatabase({
+			namespace: this.#namespace,
+			schema: this.#schema,
+			adapter
+		});
+	}
+};
+/**
+* A Fragno database instance with a bound adapter.
+* Created from a FragnoDatabaseDefinition by calling .create(adapter).
+*/
+var FragnoDatabase = class {
+	#namespace;
+	#schema;
+	#adapter;
+	constructor(options) {
+		this.#namespace = options.namespace;
+		this.#schema = options.schema;
+		this.#adapter = options.adapter;
+	}
+	get [fragnoDatabaseFakeSymbol]() {
+		return fragnoDatabaseFakeSymbol;
+	}
+	async createClient() {
+		const dbVersion = await this.#adapter.getSchemaVersion(this.#namespace);
+		if (dbVersion !== this.#schema.version.toString()) throw new Error(`Database is not at expected version. Did you forget to run migrations? Current version: ${dbVersion}, Expected version: ${this.#schema.version}`);
+		return this.#adapter.createQueryEngine(this.#schema, this.#namespace);
+	}
+	async runMigrations() {
+		if (!this.#adapter.createMigrationEngine) throw new Error("Migration engine not supported for this adapter.");
+		const preparedMigration = await this.#adapter.createMigrationEngine(this.#schema, this.#namespace).prepareMigration();
+		await preparedMigration.execute();
+		return preparedMigration.operations.length > 0;
+	}
+	get namespace() {
+		return this.#namespace;
+	}
+	get schema() {
+		return this.#schema;
+	}
+	get adapter() {
+		return this.#adapter;
+	}
+	async generateSchema(options) {
+		const adapter = this.#adapter;
+		if (adapter.createSchemaGenerator) {
+			if (options?.toVersion !== void 0 || options?.fromVersion !== void 0) console.warn("⚠️ toVersion and fromVersion are not supported for schema generation.");
+			const generator = adapter.createSchemaGenerator(this.#schema, this.#namespace);
+			const defaultPath = options?.path ?? "schema.ts";
+			return generator.generateSchema({
+				path: defaultPath,
+				toVersion: options?.toVersion,
+				fromVersion: options?.fromVersion
+			});
+		}
+		if (adapter.createMigrationEngine) {
+			const migrator = adapter.createMigrationEngine(this.#schema, this.#namespace);
+			const targetVersion = options?.toVersion ?? this.#schema.version;
+			const sourceVersion = options?.fromVersion;
+			const currentVersion = sourceVersion ?? await migrator.getVersion();
+			const defaultPath = options?.path ?? (migrator.getDefaultFileName ? migrator.getDefaultFileName(this.#namespace, currentVersion, targetVersion) : "schema.sql");
+			const preparedMigration = await migrator.prepareMigrationTo(targetVersion, {
+				updateSettings: true,
+				fromVersion: sourceVersion
+			});
+			if (!preparedMigration.getSQL) throw new Error("Migration engine does not support SQL generation. Ensure your adapter's migration engine provides getSQL().");
+			const sql = preparedMigration.getSQL();
+			if (!sql.trim()) throw new Error("No migrations needed. Database is already at the target version.");
+			return {
+				schema: sql,
+				path: defaultPath
+			};
+		}
+		throw new Error("Adapter does not support schema generation. Ensure your adapter implements either createSchemaGenerator or createMigrationEngine.");
+	}
+};
+function defineFragnoDatabase(options) {
+	return new FragnoDatabaseDefinition(options);
+}
 
 //#endregion
-export { hello };
+export { DatabaseFragmentBuilder, FragnoDatabase, FragnoDatabaseDefinition, defineFragmentWithDatabase, defineFragnoDatabase, fragnoDatabaseFakeSymbol, fragnoDatabaseLibraryVersion, isFragnoDatabase };
 //# sourceMappingURL=mod.js.map

package/dist/mod.js.map

@@ -1 +1 @@
-{"version":3,"file":"mod.js","names":[],"sources":["../src/mod.ts"],"sourcesContent":["export const hello = \"world\";\n"],"mappings":";AAAA,MAAa,QAAQ"}
+{"version":3,"file":"mod.js","names":["#namespace","#schema","#adapter"],"sources":["../src/mod.ts"],"sourcesContent":["import type { DatabaseAdapter } from \"./adapters/adapters\";\nimport type { AnySchema } from \"./schema/create\";\nimport type { AbstractQuery } from \"./query/query\";\n\nexport type { DatabaseAdapter };\n\nexport const fragnoDatabaseFakeSymbol = \"$fragno-database\" as const;\nexport const fragnoDatabaseLibraryVersion = \"0.1\" as const;\n\nexport interface CreateFragnoDatabaseDefinitionOptions<T extends AnySchema> {\n  namespace: string;\n  schema: T;\n}\n\nexport function isFragnoDatabase(value: unknown): value is FragnoDatabase<AnySchema> {\n  if (value instanceof FragnoDatabase) {\n    return true;\n  }\n\n  if (typeof value !== \"object\" || value === null) {\n    return false;\n  }\n\n  return (\n    fragnoDatabaseFakeSymbol in value &&\n    value[fragnoDatabaseFakeSymbol] === fragnoDatabaseFakeSymbol\n  );\n}\n\n/**\n * Definition of a Fragno database schema and namespace.\n * Created by library authors using defineFragnoDatabase().\n * Apps instantiate it by calling .create(adapter).\n */\nexport class FragnoDatabaseDefinition<const T extends AnySchema> {\n  #namespace: string;\n  #schema: T;\n\n  constructor(options: CreateFragnoDatabaseDefinitionOptions<T>) {\n    this.#namespace = options.namespace;\n    this.#schema = options.schema;\n  }\n\n  get namespace() {\n    return this.#namespace;\n  }\n\n  get schema() {\n    return this.#schema;\n  }\n\n  /**\n   * Creates a FragnoDatabase instance by binding an adapter to this definition.\n   */\n  create(adapter: DatabaseAdapter): FragnoDatabase<T> {\n    return new FragnoDatabase({\n      namespace: this.#namespace,\n      schema: this.#schema,\n      adapter,\n    });\n  }\n}\n\n/**\n * A Fragno database instance with a bound adapter.\n * Created from a FragnoDatabaseDefinition by calling .create(adapter).\n */\nexport class FragnoDatabase<const T extends AnySchema> {\n  #namespace: string;\n  #schema: T;\n  #adapter: DatabaseAdapter;\n\n  constructor(options: { namespace: string; schema: T; adapter: DatabaseAdapter }) {\n    this.#namespace = options.namespace;\n    this.#schema = options.schema;\n    this.#adapter = options.adapter;\n  }\n\n  get [fragnoDatabaseFakeSymbol](): typeof fragnoDatabaseFakeSymbol {\n    return fragnoDatabaseFakeSymbol;\n  }\n\n  async createClient(): Promise<AbstractQuery<T>> {\n    const dbVersion = await this.#adapter.getSchemaVersion(this.#namespace);\n    if (dbVersion !== this.#schema.version.toString()) {\n      throw new Error(\n        `Database is not at expected version. Did you forget to run migrations?` +\n          ` Current version: ${dbVersion}, Expected version: ${this.#schema.version}`,\n      );\n    }\n\n    return this.#adapter.createQueryEngine(this.#schema, this.#namespace);\n  }\n\n  async runMigrations(): Promise<boolean> {\n    if (!this.#adapter.createMigrationEngine) {\n      throw new Error(\"Migration engine not supported for this adapter.\");\n    }\n\n    const migrator = this.#adapter.createMigrationEngine(this.#schema, this.#namespace);\n    const preparedMigration = await migrator.prepareMigration();\n    await preparedMigration.execute();\n\n    return preparedMigration.operations.length > 0;\n  }\n\n  get namespace() {\n    return this.#namespace;\n  }\n\n  get schema() {\n    return this.#schema;\n  }\n\n  get adapter() {\n    return this.#adapter;\n  }\n\n  async generateSchema(options?: {\n    path?: string;\n    toVersion?: number;\n    fromVersion?: number;\n  }): Promise<{ schema: string; path: string }> {\n    const adapter = this.#adapter;\n\n    if (adapter.createSchemaGenerator) {\n      if (options?.toVersion !== undefined || options?.fromVersion !== undefined) {\n        console.warn(\"⚠️ toVersion and fromVersion are not supported for schema generation.\");\n      }\n\n      const generator = adapter.createSchemaGenerator(this.#schema, this.#namespace);\n      const defaultPath = options?.path ?? \"schema.ts\";\n      return generator.generateSchema({\n        path: defaultPath,\n        toVersion: options?.toVersion,\n        fromVersion: options?.fromVersion,\n      });\n    }\n\n    if (adapter.createMigrationEngine) {\n      const migrator = adapter.createMigrationEngine(this.#schema, this.#namespace);\n      const targetVersion = options?.toVersion ?? this.#schema.version;\n      const sourceVersion = options?.fromVersion;\n\n      // Get current version for file naming if not provided\n      const currentVersion = sourceVersion ?? (await migrator.getVersion());\n\n      // Determine the default path using the migrator's getDefaultFileName if available\n      const defaultPath =\n        options?.path ??\n        (migrator.getDefaultFileName\n          ? migrator.getDefaultFileName(this.#namespace, currentVersion, targetVersion)\n          : \"schema.sql\");\n\n      // Generate migration from source to target version\n      const preparedMigration = await migrator.prepareMigrationTo(targetVersion, {\n        updateSettings: true,\n        fromVersion: sourceVersion,\n      });\n\n      if (!preparedMigration.getSQL) {\n        throw new Error(\n          \"Migration engine does not support SQL generation. Ensure your adapter's migration engine provides getSQL().\",\n        );\n      }\n\n      const sql = preparedMigration.getSQL();\n\n      // If no migrations needed, return informative message\n      if (!sql.trim()) {\n        throw new Error(\"No migrations needed. Database is already at the target version.\");\n      }\n\n      return {\n        schema: sql,\n        path: defaultPath,\n      };\n    }\n\n    throw new Error(\n      \"Adapter does not support schema generation. Ensure your adapter implements either createSchemaGenerator or createMigrationEngine.\",\n    );\n  }\n}\n\nexport function defineFragnoDatabase<const TSchema extends AnySchema>(\n  options: CreateFragnoDatabaseDefinitionOptions<TSchema>,\n): FragnoDatabaseDefinition<TSchema> {\n  return new FragnoDatabaseDefinition(options);\n}\n\nexport {\n  defineFragmentWithDatabase,\n  DatabaseFragmentBuilder,\n  type FragnoPublicConfigWithDatabase,\n  type DatabaseFragmentContext,\n} from \"./fragment\";\n"],"mappings":";;;AAMA,MAAa,2BAA2B;AACxC,MAAa,+BAA+B;AAO5C,SAAgB,iBAAiB,OAAoD;AACnF,KAAI,iBAAiB,eACnB,QAAO;AAGT,KAAI,OAAO,UAAU,YAAY,UAAU,KACzC,QAAO;AAGT,QACE,4BAA4B,SAC5B,MAAM,8BAA8B;;;;;;;AASxC,IAAa,2BAAb,MAAiE;CAC/D;CACA;CAEA,YAAY,SAAmD;AAC7D,QAAKA,YAAa,QAAQ;AAC1B,QAAKC,SAAU,QAAQ;;CAGzB,IAAI,YAAY;AACd,SAAO,MAAKD;;CAGd,IAAI,SAAS;AACX,SAAO,MAAKC;;;;;CAMd,OAAO,SAA6C;AAClD,SAAO,IAAI,eAAe;GACxB,WAAW,MAAKD;GAChB,QAAQ,MAAKC;GACb;GACD,CAAC;;;;;;;AAQN,IAAa,iBAAb,MAAuD;CACrD;CACA;CACA;CAEA,YAAY,SAAqE;AAC/E,QAAKD,YAAa,QAAQ;AAC1B,QAAKC,SAAU,QAAQ;AACvB,QAAKC,UAAW,QAAQ;;CAG1B,KAAK,4BAA6D;AAChE,SAAO;;CAGT,MAAM,eAA0C;EAC9C,MAAM,YAAY,MAAM,MAAKA,QAAS,iBAAiB,MAAKF,UAAW;AACvE,MAAI,cAAc,MAAKC,OAAQ,QAAQ,UAAU,CAC/C,OAAM,IAAI,MACR,2FACuB,UAAU,sBAAsB,MAAKA,OAAQ,UACrE;AAGH,SAAO,MAAKC,QAAS,kBAAkB,MAAKD,QAAS,MAAKD,UAAW;;CAGvE,MAAM,gBAAkC;AACtC,MAAI,CAAC,MAAKE,QAAS,sBACjB,OAAM,IAAI,MAAM,mDAAmD;EAIrE,MAAM,oBAAoB,MADT,MAAKA,QAAS,sBAAsB,MAAKD,QAAS,MAAKD,UAAW,CAC1C,kBAAkB;AAC3D,QAAM,kBAAkB,SAAS;AAEjC,SAAO,kBAAkB,WAAW,SAAS;;CAG/C,IAAI,YAAY;AACd,SAAO,MAAKA;;CAGd,IAAI,SAAS;AACX,SAAO,MAAKC;;CAGd,IAAI,UAAU;AACZ,SAAO,MAAKC;;CAGd,MAAM,eAAe,SAIyB;EAC5C,MAAM,UAAU,MAAKA;AAErB,MAAI,QAAQ,uBAAuB;AACjC,OAAI,SAAS,cAAc,UAAa,SAAS,gBAAgB,OAC/D,SAAQ,KAAK,wEAAwE;GAGvF,MAAM,YAAY,QAAQ,sBAAsB,MAAKD,QAAS,MAAKD,UAAW;GAC9E,MAAM,cAAc,SAAS,QAAQ;AACrC,UAAO,UAAU,eAAe;IAC9B,MAAM;IACN,WAAW,SAAS;IACpB,aAAa,SAAS;IACvB,CAAC;;AAGJ,MAAI,QAAQ,uBAAuB;GACjC,MAAM,WAAW,QAAQ,sBAAsB,MAAKC,QAAS,MAAKD,UAAW;GAC7E,MAAM,gBAAgB,SAAS,aAAa,MAAKC,OAAQ;GACzD,MAAM,gBAAgB,SAAS;GAG/B,MAAM,iBAAiB,iBAAkB,MAAM,SAAS,YAAY;GAGpE,MAAM,cACJ,SAAS,SACR,SAAS,qBACN,SAAS,mBAAmB,MAAKD,WAAY,gBAAgB,cAAc,GAC3E;GAGN,MAAM,oBAAoB,MAAM,SAAS,mBAAmB,eAAe;IACzE,gBAAgB;IAChB,aAAa;IACd,CAAC;AAEF,OAAI,CAAC,kBAAkB,OACrB,OAAM,IAAI,MACR,8GACD;GAGH,MAAM,MAAM,kBAAkB,QAAQ;AAGtC,OAAI,CAAC,IAAI,MAAM,CACb,OAAM,IAAI,MAAM,mEAAmE;AAGrF,UAAO;IACL,QAAQ;IACR,MAAM;IACP;;AAGH,QAAM,IAAI,MACR,oIACD;;;AAIL,SAAgB,qBACd,SACmC;AACnC,QAAO,IAAI,yBAAyB,QAAQ"}