@fragno-dev/db 0.1.14 → 0.2.0

package/dist/mod.d.ts

@@ -1,10 +1,14 @@
 import { AnySchema } from "./schema/create.js";
 import { Cursor, CursorData, CursorResult, decodeCursor } from "./query/cursor.js";
-import { IUnitOfWorkBase, UOWCompiler, UOWDecoder, UOWExecutor, UnitOfWork, UnitOfWorkSchemaView, createUnitOfWork } from "./query/unit-of-work.js";
-import { AbstractQuery } from "./query/query.js";
+import { ExponentialBackoffRetryPolicy, LinearBackoffRetryPolicy, NoRetryPolicy, RetryPolicy } from "./query/unit-of-work/retry-policy.js";
+import { ExecuteUnitOfWorkCallbacks, ExecuteUnitOfWorkOptions, ExecuteUnitOfWorkResult, executeUnitOfWork } from "./query/unit-of-work/execute-unit-of-work.js";
+import { DatabaseFragmentContext, DatabaseFragmentDefinitionBuilder, DatabaseHandlerContext, FragnoPublicConfigWithDatabase, ImplicitDatabaseDependencies } from "./db-fragment-definition-builder.js";
+import { InternalFragmentInstance, internalFragmentDef } from "./fragments/internal-fragment.js";
+import { HookContext, HookFn, HookPayload, HooksMap, TriggerHookOptions } from "./hooks/hooks.js";
+import { IUnitOfWork, IUnitOfWorkRestricted, TypedUnitOfWork, UOWCompiler, UOWDecoder, UOWExecutor, UnitOfWork, createUnitOfWork } from "./query/unit-of-work/unit-of-work.js";
 import { DatabaseAdapter } from "./adapters/adapters.js";
-import { BoundServices } from "./bind-services.js";
-import { DatabaseFragmentBuilder, DatabaseFragmentContext, DatabaseRequestThisContext, DatabaseRouteHandler, FragnoPublicConfigWithDatabase, defineFragmentWithDatabase, serviceContext, uowStorage, withUnitOfWork } from "./fragment.js";
+import { withDatabase } from "./with-database.js";
+import { AnyFragnoInstantiatedFragment, BoundServices, FragnoInstantiatedFragment } from "@fragno-dev/core";
 
 //#region src/mod.d.ts
 declare const fragnoDatabaseFakeSymbol: "$fragno-database";
@@ -14,21 +18,6 @@ interface CreateFragnoDatabaseDefinitionOptions<T extends AnySchema> {
   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<TUOWConfig = void>(adapter: DatabaseAdapter<TUOWConfig>): FragnoDatabase<T, TUOWConfig>;
-}
 /**
  * A Fragno database instance with a bound adapter.
  * Created from a FragnoDatabaseDefinition by calling .create(adapter).
@@ -41,13 +30,36 @@ declare class FragnoDatabase<const T extends AnySchema, TUOWConfig = void> {
     adapter: DatabaseAdapter<TUOWConfig>;
   });
   get [fragnoDatabaseFakeSymbol](): typeof fragnoDatabaseFakeSymbol;
-  createClient(): Promise<AbstractQuery<T, TUOWConfig>>;
-  runMigrations(): Promise<boolean>;
   get namespace(): string;
   get schema(): T;
   get adapter(): DatabaseAdapter<TUOWConfig>;
 }
-declare function defineFragnoDatabase<const TSchema extends AnySchema>(options: CreateFragnoDatabaseDefinitionOptions<TSchema>): FragnoDatabaseDefinition<TSchema>;
+type AnyFragnoInstantiatedDatabaseFragment = FragnoInstantiatedFragment<any, ImplicitDatabaseDependencies<AnySchema>, any, any, any, any, FragnoPublicConfigWithDatabase, {
+  _fragno_internal: InternalFragmentInstance;
+} & Record<string, AnyFragnoInstantiatedFragment>>;
+/**
+ * Helper function to run migrations for a database fragment.
+ * Extracts the database adapter, schema, and namespace from the fragment and runs migrations.
+ * This function:
+ * 1. Ensures the internal settings fragment is migrated first
+ * 2. Retrieves the current database version from the internal fragment
+ * 3. Runs migration from current version to target version
+ *
+ * @param fragment - The instantiated fragment to run migrations for
+ * @throws Error if the fragment doesn't have database support or the adapter doesn't support migrations
+ *
+ * @example
+ * ```typescript
+ * const fragment = instantiate(myFragmentDef)
+ *   .withConfig({})
+ *   .withRoutes([])
+ *   .withOptions({ databaseAdapter: myAdapter })
+ *   .build();
+ *
+ * await migrate(fragment);
+ * ```
+ */
+declare function migrate(fragment: AnyFragnoInstantiatedDatabaseFragment): Promise<void>;
 //#endregion
-export { type BoundServices, CreateFragnoDatabaseDefinitionOptions, Cursor, type CursorData, type CursorResult, type DatabaseAdapter, DatabaseFragmentBuilder, type DatabaseFragmentContext, type DatabaseRequestThisContext, type DatabaseRouteHandler, FragnoDatabase, FragnoDatabaseDefinition, type FragnoPublicConfigWithDatabase, type IUnitOfWorkBase, type UOWCompiler, type UOWDecoder, type UOWExecutor, UnitOfWork, UnitOfWorkSchemaView, createUnitOfWork, decodeCursor, defineFragmentWithDatabase, defineFragnoDatabase, fragnoDatabaseFakeSymbol, fragnoDatabaseLibraryVersion, isFragnoDatabase, serviceContext, uowStorage, withUnitOfWork };
+export { AnyFragnoInstantiatedDatabaseFragment, type BoundServices, CreateFragnoDatabaseDefinitionOptions, Cursor, type CursorData, type CursorResult, type DatabaseAdapter, type DatabaseFragmentContext, DatabaseFragmentDefinitionBuilder, type DatabaseHandlerContext as DatabaseRequestContext, type ExecuteUnitOfWorkCallbacks, type ExecuteUnitOfWorkOptions, type ExecuteUnitOfWorkResult, ExponentialBackoffRetryPolicy, FragnoDatabase, type FragnoPublicConfigWithDatabase, type HookContext, type HookFn, type HookPayload, type HooksMap, type IUnitOfWork, type IUnitOfWorkRestricted, type ImplicitDatabaseDependencies, type InternalFragmentInstance, LinearBackoffRetryPolicy, NoRetryPolicy, type RetryPolicy, type TriggerHookOptions, TypedUnitOfWork, type UOWCompiler, type UOWDecoder, type UOWExecutor, UnitOfWork, createUnitOfWork, decodeCursor, executeUnitOfWork, fragnoDatabaseFakeSymbol, fragnoDatabaseLibraryVersion, internalFragmentDef, isFragnoDatabase, migrate, withDatabase };
 //# 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":";;;;;;;;;cASa;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;;;;;;AAoBA,cApBxB,wBAoBwB,CAAA,gBApBiB,SAoBjB,CAAA,CAAA;EAA6C,CAAA,OAAA;EAAG,WAAA,CAAA,OAAA,EAhB9D,qCAgB8D,CAhBxB,CAgBwB,CAAA;EAAlB,IAAA,SAAA,CAAA,CAAA,EAAA,MAAA;EAAc,IAAA,MAAA,CAAA,CAAA,EAPrE,CAOqE;EAapE;;;EAKmE,MAAA,CAAA,aAAA,IAAA,CAAA,CAAA,OAAA,EAlB3C,eAkB2C,CAlB3B,UAkB2B,CAAA,CAAA,EAlBb,cAkBa,CAlBE,CAkBF,EAlBK,UAkBL,CAAA;;;;;;AAUhD,cAfnB,cAemB,CAAA,gBAfY,SAeZ,EAAA,aAAA,IAAA,CAAA,CAAA;EAAR,CAAA,OAAA;EAYC,WAAA,CAAA,OAAA,EAAA;IAgBb,SAAA,EAAA,MAAA;IAIqB,MAAA,EA1CmB,CA0CnB;IAAhB,OAAA,EA1C+C,eA0C/C,CA1C+D,UA0C/D,CAAA;EAAe,CAAA;EAKhB,KAzCT,wBAAA,GAyC6B,EAAA,OAzCO,wBAyCP;EAAuB,YAAA,CAAA,CAAA,EArCnC,OAqCmC,CArC3B,aAqC2B,CArCb,CAqCa,EArCV,UAqCU,CAAA,CAAA;EACV,aAAA,CAAA,CAAA,EA1BxB,OA0BwB,CAAA,OAAA,CAAA;EAAtC,IAAA,SAAA,CAAA,CAAA,EAAA,MAAA;EACiB,IAAA,MAAA,CAAA,CAAA,EAXhB,CAWgB;EAAzB,IAAA,OAAA,CAAA,CAAA,EAPc,eAOd,CAP8B,UAO9B,CAAA;;iBAFa,2CAA2C,oBAChD,sCAAsC,WAC9C,yBAAyB"}
+{"version":3,"file":"mod.d.ts","names":[],"sources":["../src/mod.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;cAiBa;cACA;UAEI,gDAAgD;;EAHpD,MAAA,EAKH,CALG;AACb;AAEiB,iBAKD,gBAAA,CALC,KAAqC,EAAA,OAAA,CAAW,EAAA,KAAA,IAKN,cAHhD,CAG+D,SAH/D,CAAA;AAGX;AAmBA;;;AAKgF,cALnE,cAKmE,CAAA,gBALpC,SAKoC,EAAA,aAAA,IAAA,CAAA,CAAA;EAAhB,CAAA,OAAA;EAMrB,WAAA,CAAA,OAAA,EAAA;IAApC,SAAA,EAAA,MAAA;IAQK,MAAA,EAdwC,CAcxC;IAIqB,OAAA,EAlB+B,eAkB/B,CAlB+C,UAkB/C,CAAA;EAAhB,CAAA;EAAe,KAZzB,wBAAA,GAYyB,EAAA,OAZW,wBAYX;EAiDpB,IAAA,SAAA,CAAA,CAAA,EAAA,MAAA;EAGmB,IAAA,MAAA,CAAA,CAAA,EAxDnB,CAwDmB;EAA7B,IAAA,OAAA,CAAA,CAAA,EApDe,eAoDf,CApD+B,UAoD/B,CAAA;;KAHU,qCAAA,GAAwC,gCAGlD,6BAA6B,gCAS7B;oBAEoB;IAA6B,eAAe;;;;;;;;;;;;;;;;;;;;;;;iBAyB5C,OAAA,WAAkB,wCAAwC"}

package/dist/mod.js

@@ -1,6 +1,10 @@
-import { DatabaseFragmentBuilder, defineFragmentWithDatabase, serviceContext, uowStorage, withUnitOfWork } from "./fragment.js";
 import { Cursor, decodeCursor } from "./query/cursor.js";
-import { UnitOfWork, UnitOfWorkSchemaView, createUnitOfWork } from "./query/unit-of-work.js";
+import { TypedUnitOfWork, UnitOfWork, createUnitOfWork } from "./query/unit-of-work/unit-of-work.js";
+import { ExponentialBackoffRetryPolicy, LinearBackoffRetryPolicy, NoRetryPolicy } from "./query/unit-of-work/retry-policy.js";
+import { executeUnitOfWork } from "./query/unit-of-work/execute-unit-of-work.js";
+import { DatabaseFragmentDefinitionBuilder } from "./db-fragment-definition-builder.js";
+import { getSchemaVersionFromDatabase, internalFragmentDef } from "./fragments/internal-fragment.js";
+import { withDatabase } from "./with-database.js";
 
 //#region src/mod.ts
 const fragnoDatabaseFakeSymbol = "$fragno-database";
@@ -11,35 +15,6 @@ function isFragnoDatabase(value) {
 	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).
 */
@@ -55,17 +30,6 @@ var FragnoDatabase = class {
 	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;
 	}
@@ -76,10 +40,49 @@ var FragnoDatabase = class {
 		return this.#adapter;
 	}
 };
-function defineFragnoDatabase(options) {
-	return new FragnoDatabaseDefinition(options);
+/**
+* Helper function to run migrations for a database fragment.
+* Extracts the database adapter, schema, and namespace from the fragment and runs migrations.
+* This function:
+* 1. Ensures the internal settings fragment is migrated first
+* 2. Retrieves the current database version from the internal fragment
+* 3. Runs migration from current version to target version
+*
+* @param fragment - The instantiated fragment to run migrations for
+* @throws Error if the fragment doesn't have database support or the adapter doesn't support migrations
+*
+* @example
+* ```typescript
+* const fragment = instantiate(myFragmentDef)
+*   .withConfig({})
+*   .withRoutes([])
+*   .withOptions({ databaseAdapter: myAdapter })
+*   .build();
+*
+* await migrate(fragment);
+* ```
+*/
+async function migrate(fragment) {
+	const { options, deps, linkedFragments } = fragment.$internal;
+	const adapter = options.databaseAdapter;
+	if (!adapter.prepareMigrations) throw new Error("Database adapter does not support prepareMigrations. Please use an adapter that implements this method.");
+	const schema = deps.schema;
+	const namespace = deps.namespace;
+	const internalFragment = linkedFragments._fragno_internal;
+	if (!internalFragment) throw new Error("Internal fragment not found. Please ensure the internal fragment is linked.");
+	if (!await adapter.isConnectionHealthy()) throw new Error("Database connection is not healthy. Please check your database connection and try again.");
+	const internalDeps = internalFragment.$internal.deps;
+	const internalSchema = internalDeps.schema;
+	const internalNamespace = internalDeps.namespace;
+	const internalCurrentVersion = await getSchemaVersionFromDatabase(internalFragment, internalNamespace);
+	if (internalCurrentVersion < internalSchema.version) await adapter.prepareMigrations(internalSchema, internalNamespace).execute(internalCurrentVersion, internalSchema.version);
+	const currentVersion = await getSchemaVersionFromDatabase(internalFragment, namespace);
+	const targetVersion = schema.version;
+	if (currentVersion === targetVersion) return;
+	if (currentVersion > targetVersion) throw new Error(`Cannot migrate backwards: current version (${currentVersion}) > target version (${targetVersion})`);
+	await adapter.prepareMigrations(schema, namespace).execute(currentVersion, targetVersion);
 }
 
 //#endregion
-export { Cursor, DatabaseFragmentBuilder, FragnoDatabase, FragnoDatabaseDefinition, UnitOfWork, UnitOfWorkSchemaView, createUnitOfWork, decodeCursor, defineFragmentWithDatabase, defineFragnoDatabase, fragnoDatabaseFakeSymbol, fragnoDatabaseLibraryVersion, isFragnoDatabase, serviceContext, uowStorage, withUnitOfWork };
+export { Cursor, DatabaseFragmentDefinitionBuilder, ExponentialBackoffRetryPolicy, FragnoDatabase, LinearBackoffRetryPolicy, NoRetryPolicy, TypedUnitOfWork, UnitOfWork, createUnitOfWork, decodeCursor, executeUnitOfWork, fragnoDatabaseFakeSymbol, fragnoDatabaseLibraryVersion, internalFragmentDef, isFragnoDatabase, migrate, withDatabase };
 //# sourceMappingURL=mod.js.map

package/dist/mod.js.map

@@ -1 +1 @@
-{"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\";\nimport type { CursorResult } from \"./query/cursor\";\nimport { Cursor } from \"./query/cursor\";\n\nexport type { DatabaseAdapter, CursorResult };\nexport { Cursor };\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<TUOWConfig = void>(adapter: DatabaseAdapter<TUOWConfig>): FragnoDatabase<T, TUOWConfig> {\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, TUOWConfig = void> {\n  #namespace: string;\n  #schema: T;\n  #adapter: DatabaseAdapter<TUOWConfig>;\n\n  constructor(options: { namespace: string; schema: T; adapter: DatabaseAdapter<TUOWConfig> }) {\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, TUOWConfig>> {\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(): DatabaseAdapter<TUOWConfig> {\n    return this.#adapter;\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  type DatabaseRouteHandler,\n} from \"./fragment\";\n\nexport { decodeCursor, type CursorData } from \"./query/cursor\";\n\nexport {\n  createUnitOfWork,\n  UnitOfWork,\n  UnitOfWorkSchemaView,\n  type IUnitOfWorkBase,\n  type UOWCompiler,\n  type UOWExecutor,\n  type UOWDecoder,\n} from \"./query/unit-of-work\";\n\nexport {\n  withUnitOfWork,\n  serviceContext,\n  uowStorage,\n  type DatabaseRequestThisContext,\n} from \"./fragment\";\nexport { type BoundServices } from \"./bind-services\";\n"],"mappings":";;;;;AASA,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,OAA0B,SAAqE;AAC7F,SAAO,IAAI,eAAe;GACxB,WAAW,MAAKD;GAChB,QAAQ,MAAKC;GACb;GACD,CAAC;;;;;;;AAQN,IAAa,iBAAb,MAA0E;CACxE;CACA;CACA;CAEA,YAAY,SAAiF;AAC3F,QAAKD,YAAa,QAAQ;AAC1B,QAAKC,SAAU,QAAQ;AACvB,QAAKC,UAAW,QAAQ;;CAG1B,KAAK,4BAA6D;AAChE,SAAO;;CAGT,MAAM,eAAsD;EAC1D,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,UAAuC;AACzC,SAAO,MAAKC;;;AAIhB,SAAgB,qBACd,SACmC;AACnC,QAAO,IAAI,yBAAyB,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 { CursorResult } from \"./query/cursor\";\nimport { Cursor } from \"./query/cursor\";\nimport type { FragnoInstantiatedFragment, AnyFragnoInstantiatedFragment } from \"@fragno-dev/core\";\nimport type {\n  FragnoPublicConfigWithDatabase,\n  ImplicitDatabaseDependencies,\n} from \"./db-fragment-definition-builder\";\nimport {\n  getSchemaVersionFromDatabase,\n  type InternalFragmentInstance,\n} from \"./fragments/internal-fragment\";\n\nexport type { DatabaseAdapter, CursorResult };\nexport { Cursor };\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 * 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, TUOWConfig = void> {\n  #namespace: string;\n  #schema: T;\n  #adapter: DatabaseAdapter<TUOWConfig>;\n\n  constructor(options: { namespace: string; schema: T; adapter: DatabaseAdapter<TUOWConfig> }) {\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  get namespace() {\n    return this.#namespace;\n  }\n\n  get schema() {\n    return this.#schema;\n  }\n\n  get adapter(): DatabaseAdapter<TUOWConfig> {\n    return this.#adapter;\n  }\n}\n\nexport {\n  DatabaseFragmentDefinitionBuilder,\n  type FragnoPublicConfigWithDatabase,\n  type DatabaseFragmentContext,\n  type DatabaseHandlerContext as DatabaseRequestContext,\n  type ImplicitDatabaseDependencies,\n} from \"./db-fragment-definition-builder\";\n\nexport { withDatabase } from \"./with-database\";\n\nexport { decodeCursor, type CursorData } from \"./query/cursor\";\n\nexport {\n  createUnitOfWork,\n  UnitOfWork,\n  TypedUnitOfWork,\n  type IUnitOfWork,\n  type IUnitOfWorkRestricted,\n  type UOWCompiler,\n  type UOWExecutor,\n  type UOWDecoder,\n} from \"./query/unit-of-work/unit-of-work\";\n\nexport {\n  type RetryPolicy,\n  NoRetryPolicy,\n  ExponentialBackoffRetryPolicy,\n  LinearBackoffRetryPolicy,\n} from \"./query/unit-of-work/retry-policy\";\n\nexport {\n  executeUnitOfWork,\n  type ExecuteUnitOfWorkResult,\n  type ExecuteUnitOfWorkCallbacks,\n  type ExecuteUnitOfWorkOptions,\n} from \"./query/unit-of-work/execute-unit-of-work\";\n\nexport type { BoundServices } from \"@fragno-dev/core\";\n\nexport { internalFragmentDef } from \"./fragments/internal-fragment\";\nexport type { InternalFragmentInstance } from \"./fragments/internal-fragment\";\n\nexport type { HookContext, HooksMap, HookFn, HookPayload, TriggerHookOptions } from \"./hooks/hooks\";\n\nexport type AnyFragnoInstantiatedDatabaseFragment = FragnoInstantiatedFragment<\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  any,\n  ImplicitDatabaseDependencies<AnySchema>,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  any,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  any,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  any,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  any,\n  FragnoPublicConfigWithDatabase,\n  // Ensure the fragment has the internal fragment linked\n  { _fragno_internal: InternalFragmentInstance } & Record<string, AnyFragnoInstantiatedFragment>\n>;\n\n/**\n * Helper function to run migrations for a database fragment.\n * Extracts the database adapter, schema, and namespace from the fragment and runs migrations.\n * This function:\n * 1. Ensures the internal settings fragment is migrated first\n * 2. Retrieves the current database version from the internal fragment\n * 3. Runs migration from current version to target version\n *\n * @param fragment - The instantiated fragment to run migrations for\n * @throws Error if the fragment doesn't have database support or the adapter doesn't support migrations\n *\n * @example\n * ```typescript\n * const fragment = instantiate(myFragmentDef)\n *   .withConfig({})\n *   .withRoutes([])\n *   .withOptions({ databaseAdapter: myAdapter })\n *   .build();\n *\n * await migrate(fragment);\n * ```\n */\nexport async function migrate(fragment: AnyFragnoInstantiatedDatabaseFragment): Promise<void> {\n  const { options, deps, linkedFragments } = fragment.$internal;\n  const adapter = options.databaseAdapter;\n\n  // Check if adapter supports prepareMigrations\n  if (!adapter.prepareMigrations) {\n    throw new Error(\n      \"Database adapter does not support prepareMigrations. Please use an adapter that implements this method.\",\n    );\n  }\n\n  const schema = deps.schema;\n  const namespace = deps.namespace;\n\n  // Step 1: Ensure the internal fragment (settings table) is migrated first\n  const internalFragment = linkedFragments._fragno_internal;\n\n  if (!internalFragment) {\n    throw new Error(\"Internal fragment not found. Please ensure the internal fragment is linked.\");\n  }\n\n  if (!(await adapter.isConnectionHealthy())) {\n    throw new Error(\n      \"Database connection is not healthy. Please check your database connection and try again.\",\n    );\n  }\n\n  const internalDeps = internalFragment.$internal.deps;\n  const internalSchema = internalDeps.schema;\n  const internalNamespace = internalDeps.namespace;\n\n  const internalCurrentVersion = await getSchemaVersionFromDatabase(\n    internalFragment,\n    internalNamespace,\n  );\n\n  // Migrate internal fragment if needed\n  if (internalCurrentVersion < internalSchema.version) {\n    const internalMigrations = adapter.prepareMigrations(internalSchema, internalNamespace);\n    await internalMigrations.execute(internalCurrentVersion, internalSchema.version);\n  }\n\n  // Step 2: Get current database version for this fragment's namespace\n  const currentVersion = await getSchemaVersionFromDatabase(internalFragment, namespace);\n\n  // Step 3: Run the migration from current version to target version\n  const targetVersion = schema.version;\n\n  if (currentVersion === targetVersion) {\n    return;\n  }\n\n  if (currentVersion > targetVersion) {\n    throw new Error(\n      `Cannot migrate backwards: current version (${currentVersion}) > target version (${targetVersion})`,\n    );\n  }\n\n  const migrations = adapter.prepareMigrations(schema, namespace);\n  await migrations.execute(currentVersion, targetVersion);\n}\n"],"mappings":";;;;;;;;;AAiBA,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;;;;;;AAQxC,IAAa,iBAAb,MAA0E;CACxE;CACA;CACA;CAEA,YAAY,SAAiF;AAC3F,QAAKA,YAAa,QAAQ;AAC1B,QAAKC,SAAU,QAAQ;AACvB,QAAKC,UAAW,QAAQ;;CAG1B,KAAK,4BAA6D;AAChE,SAAO;;CAGT,IAAI,YAAY;AACd,SAAO,MAAKF;;CAGd,IAAI,SAAS;AACX,SAAO,MAAKC;;CAGd,IAAI,UAAuC;AACzC,SAAO,MAAKC;;;;;;;;;;;;;;;;;;;;;;;;;AAuFhB,eAAsB,QAAQ,UAAgE;CAC5F,MAAM,EAAE,SAAS,MAAM,oBAAoB,SAAS;CACpD,MAAM,UAAU,QAAQ;AAGxB,KAAI,CAAC,QAAQ,kBACX,OAAM,IAAI,MACR,0GACD;CAGH,MAAM,SAAS,KAAK;CACpB,MAAM,YAAY,KAAK;CAGvB,MAAM,mBAAmB,gBAAgB;AAEzC,KAAI,CAAC,iBACH,OAAM,IAAI,MAAM,8EAA8E;AAGhG,KAAI,CAAE,MAAM,QAAQ,qBAAqB,CACvC,OAAM,IAAI,MACR,2FACD;CAGH,MAAM,eAAe,iBAAiB,UAAU;CAChD,MAAM,iBAAiB,aAAa;CACpC,MAAM,oBAAoB,aAAa;CAEvC,MAAM,yBAAyB,MAAM,6BACnC,kBACA,kBACD;AAGD,KAAI,yBAAyB,eAAe,QAE1C,OAD2B,QAAQ,kBAAkB,gBAAgB,kBAAkB,CAC9D,QAAQ,wBAAwB,eAAe,QAAQ;CAIlF,MAAM,iBAAiB,MAAM,6BAA6B,kBAAkB,UAAU;CAGtF,MAAM,gBAAgB,OAAO;AAE7B,KAAI,mBAAmB,cACrB;AAGF,KAAI,iBAAiB,cACnB,OAAM,IAAI,MACR,8CAA8C,eAAe,sBAAsB,cAAc,GAClG;AAIH,OADmB,QAAQ,kBAAkB,QAAQ,UAAU,CAC9C,QAAQ,gBAAgB,cAAc"}

package/dist/node_modules/.pnpm/rou3@0.7.10/node_modules/rou3/dist/index.js

@@ -0,0 +1,165 @@
+//#region ../../node_modules/.pnpm/rou3@0.7.10/node_modules/rou3/dist/index.mjs
+const NullProtoObj = /* @__PURE__ */ (() => {
+	const e = function() {};
+	return e.prototype = Object.create(null), Object.freeze(e.prototype), e;
+})();
+/**
+* Create a new router context.
+*/
+function createRouter() {
+	return {
+		root: { key: "" },
+		static: new NullProtoObj()
+	};
+}
+function splitPath(path) {
+	const [_, ...s] = path.split("/");
+	return s[s.length - 1] === "" ? s.slice(0, -1) : s;
+}
+function getMatchParams(segments, paramsMap) {
+	const params = new NullProtoObj();
+	for (const [index, name] of paramsMap) {
+		const segment = index < 0 ? segments.slice(-1 * index).join("/") : segments[index];
+		if (typeof name === "string") params[name] = segment;
+		else {
+			const match = segment.match(name);
+			if (match) for (const key in match.groups) params[key] = match.groups[key];
+		}
+	}
+	return params;
+}
+/**
+* Add a route to the router context.
+*/
+function addRoute(ctx, method = "", path, data) {
+	method = method.toUpperCase();
+	if (path.charCodeAt(0) !== 47) path = `/${path}`;
+	const segments = splitPath(path);
+	let node = ctx.root;
+	let _unnamedParamIndex = 0;
+	const paramsMap = [];
+	const paramsRegexp = [];
+	for (let i = 0; i < segments.length; i++) {
+		const segment = segments[i];
+		if (segment.startsWith("**")) {
+			if (!node.wildcard) node.wildcard = { key: "**" };
+			node = node.wildcard;
+			paramsMap.push([
+				-i,
+				segment.split(":")[1] || "_",
+				segment.length === 2
+			]);
+			break;
+		}
+		if (segment === "*" || segment.includes(":")) {
+			if (!node.param) node.param = { key: "*" };
+			node = node.param;
+			if (segment === "*") paramsMap.push([
+				i,
+				`_${_unnamedParamIndex++}`,
+				true
+			]);
+			else if (segment.includes(":", 1)) {
+				const regexp = getParamRegexp(segment);
+				paramsRegexp[i] = regexp;
+				node.hasRegexParam = true;
+				paramsMap.push([
+					i,
+					regexp,
+					false
+				]);
+			} else paramsMap.push([
+				i,
+				segment.slice(1),
+				false
+			]);
+			continue;
+		}
+		const child = node.static?.[segment];
+		if (child) node = child;
+		else {
+			const staticNode = { key: segment };
+			if (!node.static) node.static = new NullProtoObj();
+			node.static[segment] = staticNode;
+			node = staticNode;
+		}
+	}
+	const hasParams = paramsMap.length > 0;
+	if (!node.methods) node.methods = new NullProtoObj();
+	node.methods[method] ??= [];
+	node.methods[method].push({
+		data: data || null,
+		paramsRegexp,
+		paramsMap: hasParams ? paramsMap : void 0
+	});
+	if (!hasParams) ctx.static[path] = node;
+}
+function getParamRegexp(segment) {
+	const regex = segment.replace(/:(\w+)/g, (_, id) => `(?<${id}>[^/]+)`).replace(/\./g, "\\.");
+	return /* @__PURE__ */ new RegExp(`^${regex}$`);
+}
+/**
+* Find a route by path.
+*/
+function findRoute(ctx, method = "", path, opts) {
+	if (path.charCodeAt(path.length - 1) === 47) path = path.slice(0, -1);
+	const staticNode = ctx.static[path];
+	if (staticNode && staticNode.methods) {
+		const staticMatch = staticNode.methods[method] || staticNode.methods[""];
+		if (staticMatch !== void 0) return staticMatch[0];
+	}
+	const segments = splitPath(path);
+	const match = _lookupTree(ctx, ctx.root, method, segments, 0)?.[0];
+	if (match === void 0) return;
+	if (opts?.params === false) return match;
+	return {
+		data: match.data,
+		params: match.paramsMap ? getMatchParams(segments, match.paramsMap) : void 0
+	};
+}
+function _lookupTree(ctx, node, method, segments, index) {
+	if (index === segments.length) {
+		if (node.methods) {
+			const match = node.methods[method] || node.methods[""];
+			if (match) return match;
+		}
+		if (node.param && node.param.methods) {
+			const match = node.param.methods[method] || node.param.methods[""];
+			if (match) {
+				const pMap = match[0].paramsMap;
+				if (pMap?.[pMap?.length - 1]?.[2]) return match;
+			}
+		}
+		if (node.wildcard && node.wildcard.methods) {
+			const match = node.wildcard.methods[method] || node.wildcard.methods[""];
+			if (match) {
+				const pMap = match[0].paramsMap;
+				if (pMap?.[pMap?.length - 1]?.[2]) return match;
+			}
+		}
+		return;
+	}
+	const segment = segments[index];
+	if (node.static) {
+		const staticChild = node.static[segment];
+		if (staticChild) {
+			const match = _lookupTree(ctx, staticChild, method, segments, index + 1);
+			if (match) return match;
+		}
+	}
+	if (node.param) {
+		const match = _lookupTree(ctx, node.param, method, segments, index + 1);
+		if (match) {
+			if (node.param.hasRegexParam) {
+				const exactMatch = match.find((m) => m.paramsRegexp[index]?.test(segment)) || match.find((m) => !m.paramsRegexp[index]);
+				return exactMatch ? [exactMatch] : void 0;
+			}
+			return match;
+		}
+	}
+	if (node.wildcard && node.wildcard.methods) return node.wildcard.methods[method] || node.wildcard.methods[""];
+}
+
+//#endregion
+export { addRoute, createRouter, findRoute };
+//# sourceMappingURL=index.js.map

package/dist/node_modules/.pnpm/rou3@0.7.10/node_modules/rou3/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../../../../../../../node_modules/.pnpm/rou3@0.7.10/node_modules/rou3/dist/index.mjs"],"sourcesContent":["const NullProtoObj = /* @__PURE__ */ (() => {\n\tconst e = function() {};\n\treturn e.prototype = Object.create(null), Object.freeze(e.prototype), e;\n})();\n\n/**\n* Create a new router context.\n*/\nfunction createRouter() {\n\treturn {\n\t\troot: { key: \"\" },\n\t\tstatic: new NullProtoObj()\n\t};\n}\n\nfunction splitPath(path) {\n\tconst [_, ...s] = path.split(\"/\");\n\treturn s[s.length - 1] === \"\" ? s.slice(0, -1) : s;\n}\nfunction getMatchParams(segments, paramsMap) {\n\tconst params = new NullProtoObj();\n\tfor (const [index, name] of paramsMap) {\n\t\tconst segment = index < 0 ? segments.slice(-1 * index).join(\"/\") : segments[index];\n\t\tif (typeof name === \"string\") params[name] = segment;\n\t\telse {\n\t\t\tconst match = segment.match(name);\n\t\t\tif (match) for (const key in match.groups) params[key] = match.groups[key];\n\t\t}\n\t}\n\treturn params;\n}\n\n/**\n* Add a route to the router context.\n*/\nfunction addRoute(ctx, method = \"\", path, data) {\n\tmethod = method.toUpperCase();\n\tif (path.charCodeAt(0) !== 47) path = `/${path}`;\n\tconst segments = splitPath(path);\n\tlet node = ctx.root;\n\tlet _unnamedParamIndex = 0;\n\tconst paramsMap = [];\n\tconst paramsRegexp = [];\n\tfor (let i = 0; i < segments.length; i++) {\n\t\tconst segment = segments[i];\n\t\tif (segment.startsWith(\"**\")) {\n\t\t\tif (!node.wildcard) node.wildcard = { key: \"**\" };\n\t\t\tnode = node.wildcard;\n\t\t\tparamsMap.push([\n\t\t\t\t-i,\n\t\t\t\tsegment.split(\":\")[1] || \"_\",\n\t\t\t\tsegment.length === 2\n\t\t\t]);\n\t\t\tbreak;\n\t\t}\n\t\tif (segment === \"*\" || segment.includes(\":\")) {\n\t\t\tif (!node.param) node.param = { key: \"*\" };\n\t\t\tnode = node.param;\n\t\t\tif (segment === \"*\") paramsMap.push([\n\t\t\t\ti,\n\t\t\t\t`_${_unnamedParamIndex++}`,\n\t\t\t\ttrue\n\t\t\t]);\n\t\t\telse if (segment.includes(\":\", 1)) {\n\t\t\t\tconst regexp = getParamRegexp(segment);\n\t\t\t\tparamsRegexp[i] = regexp;\n\t\t\t\tnode.hasRegexParam = true;\n\t\t\t\tparamsMap.push([\n\t\t\t\t\ti,\n\t\t\t\t\tregexp,\n\t\t\t\t\tfalse\n\t\t\t\t]);\n\t\t\t} else paramsMap.push([\n\t\t\t\ti,\n\t\t\t\tsegment.slice(1),\n\t\t\t\tfalse\n\t\t\t]);\n\t\t\tcontinue;\n\t\t}\n\t\tconst child = node.static?.[segment];\n\t\tif (child) node = child;\n\t\telse {\n\t\t\tconst staticNode = { key: segment };\n\t\t\tif (!node.static) node.static = new NullProtoObj();\n\t\t\tnode.static[segment] = staticNode;\n\t\t\tnode = staticNode;\n\t\t}\n\t}\n\tconst hasParams = paramsMap.length > 0;\n\tif (!node.methods) node.methods = new NullProtoObj();\n\tnode.methods[method] ??= [];\n\tnode.methods[method].push({\n\t\tdata: data || null,\n\t\tparamsRegexp,\n\t\tparamsMap: hasParams ? paramsMap : void 0\n\t});\n\tif (!hasParams) ctx.static[path] = node;\n}\nfunction getParamRegexp(segment) {\n\tconst regex = segment.replace(/:(\\w+)/g, (_, id) => `(?<${id}>[^/]+)`).replace(/\\./g, \"\\\\.\");\n\treturn /* @__PURE__ */ new RegExp(`^${regex}$`);\n}\n\n/**\n* Find a route by path.\n*/\nfunction findRoute(ctx, method = \"\", path, opts) {\n\tif (path.charCodeAt(path.length - 1) === 47) path = path.slice(0, -1);\n\tconst staticNode = ctx.static[path];\n\tif (staticNode && staticNode.methods) {\n\t\tconst staticMatch = staticNode.methods[method] || staticNode.methods[\"\"];\n\t\tif (staticMatch !== void 0) return staticMatch[0];\n\t}\n\tconst segments = splitPath(path);\n\tconst match = _lookupTree(ctx, ctx.root, method, segments, 0)?.[0];\n\tif (match === void 0) return;\n\tif (opts?.params === false) return match;\n\treturn {\n\t\tdata: match.data,\n\t\tparams: match.paramsMap ? getMatchParams(segments, match.paramsMap) : void 0\n\t};\n}\nfunction _lookupTree(ctx, node, method, segments, index) {\n\tif (index === segments.length) {\n\t\tif (node.methods) {\n\t\t\tconst match = node.methods[method] || node.methods[\"\"];\n\t\t\tif (match) return match;\n\t\t}\n\t\tif (node.param && node.param.methods) {\n\t\t\tconst match = node.param.methods[method] || node.param.methods[\"\"];\n\t\t\tif (match) {\n\t\t\t\tconst pMap = match[0].paramsMap;\n\t\t\t\tif (pMap?.[pMap?.length - 1]?.[2]) return match;\n\t\t\t}\n\t\t}\n\t\tif (node.wildcard && node.wildcard.methods) {\n\t\t\tconst match = node.wildcard.methods[method] || node.wildcard.methods[\"\"];\n\t\t\tif (match) {\n\t\t\t\tconst pMap = match[0].paramsMap;\n\t\t\t\tif (pMap?.[pMap?.length - 1]?.[2]) return match;\n\t\t\t}\n\t\t}\n\t\treturn;\n\t}\n\tconst segment = segments[index];\n\tif (node.static) {\n\t\tconst staticChild = node.static[segment];\n\t\tif (staticChild) {\n\t\t\tconst match = _lookupTree(ctx, staticChild, method, segments, index + 1);\n\t\t\tif (match) return match;\n\t\t}\n\t}\n\tif (node.param) {\n\t\tconst match = _lookupTree(ctx, node.param, method, segments, index + 1);\n\t\tif (match) {\n\t\t\tif (node.param.hasRegexParam) {\n\t\t\t\tconst exactMatch = match.find((m) => m.paramsRegexp[index]?.test(segment)) || match.find((m) => !m.paramsRegexp[index]);\n\t\t\t\treturn exactMatch ? [exactMatch] : void 0;\n\t\t\t}\n\t\t\treturn match;\n\t\t}\n\t}\n\tif (node.wildcard && node.wildcard.methods) return node.wildcard.methods[method] || node.wildcard.methods[\"\"];\n}\n\n/**\n* Remove a route from the router context.\n*/\nfunction removeRoute(ctx, method, path) {\n\tconst segments = splitPath(path);\n\treturn _remove(ctx.root, method || \"\", segments, 0);\n}\nfunction _remove(node, method, segments, index) {\n\tif (index === segments.length) {\n\t\tif (node.methods && method in node.methods) {\n\t\t\tdelete node.methods[method];\n\t\t\tif (Object.keys(node.methods).length === 0) node.methods = void 0;\n\t\t}\n\t\treturn;\n\t}\n\tconst segment = segments[index];\n\tif (segment === \"*\") {\n\t\tif (node.param) {\n\t\t\t_remove(node.param, method, segments, index + 1);\n\t\t\tif (_isEmptyNode(node.param)) node.param = void 0;\n\t\t}\n\t\treturn;\n\t}\n\tif (segment.startsWith(\"**\")) {\n\t\tif (node.wildcard) {\n\t\t\t_remove(node.wildcard, method, segments, index + 1);\n\t\t\tif (_isEmptyNode(node.wildcard)) node.wildcard = void 0;\n\t\t}\n\t\treturn;\n\t}\n\tconst childNode = node.static?.[segment];\n\tif (childNode) {\n\t\t_remove(childNode, method, segments, index + 1);\n\t\tif (_isEmptyNode(childNode)) {\n\t\t\tdelete node.static[segment];\n\t\t\tif (Object.keys(node.static).length === 0) node.static = void 0;\n\t\t}\n\t}\n}\nfunction _isEmptyNode(node) {\n\treturn node.methods === void 0 && node.static === void 0 && node.param === void 0 && node.wildcard === void 0;\n}\n\n/**\n* Find all route patterns that match the given path.\n*/\nfunction findAllRoutes(ctx, method = \"\", path, opts) {\n\tif (path.charCodeAt(path.length - 1) === 47) path = path.slice(0, -1);\n\tconst segments = splitPath(path);\n\tconst matches = _findAll(ctx, ctx.root, method, segments, 0);\n\tif (opts?.params === false) return matches;\n\treturn matches.map((m) => {\n\t\treturn {\n\t\t\tdata: m.data,\n\t\t\tparams: m.paramsMap ? getMatchParams(segments, m.paramsMap) : void 0\n\t\t};\n\t});\n}\nfunction _findAll(ctx, node, method, segments, index, matches = []) {\n\tconst segment = segments[index];\n\tif (node.wildcard && node.wildcard.methods) {\n\t\tconst match = node.wildcard.methods[method] || node.wildcard.methods[\"\"];\n\t\tif (match) matches.push(...match);\n\t}\n\tif (node.param) {\n\t\t_findAll(ctx, node.param, method, segments, index + 1, matches);\n\t\tif (index === segments.length && node.param.methods) {\n\t\t\tconst match = node.param.methods[method] || node.param.methods[\"\"];\n\t\t\tif (match) {\n\t\t\t\tconst pMap = match[0].paramsMap;\n\t\t\t\tif (pMap?.[pMap?.length - 1]?.[2]) matches.push(...match);\n\t\t\t}\n\t\t}\n\t}\n\tconst staticChild = node.static?.[segment];\n\tif (staticChild) _findAll(ctx, staticChild, method, segments, index + 1, matches);\n\tif (index === segments.length && node.methods) {\n\t\tconst match = node.methods[method] || node.methods[\"\"];\n\t\tif (match) matches.push(...match);\n\t}\n\treturn matches;\n}\n\nfunction routeToRegExp(route = \"/\") {\n\tconst reSegments = [];\n\tlet idCtr = 0;\n\tfor (const segment of route.split(\"/\")) {\n\t\tif (!segment) continue;\n\t\tif (segment === \"*\") reSegments.push(`(?<_${idCtr++}>[^/]*)`);\n\t\telse if (segment.startsWith(\"**\")) reSegments.push(segment === \"**\" ? \"?(?<_>.*)\" : `?(?<${segment.slice(3)}>.+)`);\n\t\telse if (segment.includes(\":\")) reSegments.push(segment.replace(/:(\\w+)/g, (_, id) => `(?<${id}>[^/]+)`).replace(/\\./g, \"\\\\.\"));\n\t\telse reSegments.push(segment);\n\t}\n\treturn /* @__PURE__ */ new RegExp(`^/${reSegments.join(\"/\")}/?$`);\n}\n\nexport { NullProtoObj, addRoute, createRouter, findAllRoutes, findRoute, removeRoute, routeToRegExp };"],"x_google_ignoreList":[0],"mappings":"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"}

package/dist/packages/fragno/dist/api/bind-services.js

@@ -0,0 +1,20 @@
+//#region ../fragno/dist/api/bind-services.js
+/**
+* Bind all functions in a service object to a specific context.
+* This allows services to use `this` to access the context.
+*
+* @param services - The service object to bind
+* @param context - The context to bind to (e.g., { getUnitOfWork })
+* @returns A new object with all functions bound to the context
+*/
+function bindServicesToContext(services, context) {
+	const bound = {};
+	for (const [key, value] of Object.entries(services)) if (typeof value === "function") bound[key] = value.bind(context);
+	else if (value && typeof value === "object" && !Array.isArray(value)) bound[key] = bindServicesToContext(value, context);
+	else bound[key] = value;
+	return bound;
+}
+
+//#endregion
+export { bindServicesToContext };
+//# sourceMappingURL=bind-services.js.map

package/dist/packages/fragno/dist/api/bind-services.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bind-services.js","names":[],"sources":["../../../../../../fragno/dist/api/bind-services.js"],"sourcesContent":["//#region src/api/bind-services.ts\n/**\n* Bind all functions in a service object to a specific context.\n* This allows services to use `this` to access the context.\n*\n* @param services - The service object to bind\n* @param context - The context to bind to (e.g., { getUnitOfWork })\n* @returns A new object with all functions bound to the context\n*/\nfunction bindServicesToContext(services, context) {\n\tconst bound = {};\n\tfor (const [key, value] of Object.entries(services)) if (typeof value === \"function\") bound[key] = value.bind(context);\n\telse if (value && typeof value === \"object\" && !Array.isArray(value)) bound[key] = bindServicesToContext(value, context);\n\telse bound[key] = value;\n\treturn bound;\n}\n\n//#endregion\nexport { bindServicesToContext };\n//# sourceMappingURL=bind-services.js.map"],"mappings":";;;;;;;;;AASA,SAAS,sBAAsB,UAAU,SAAS;CACjD,MAAM,QAAQ,EAAE;AAChB,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,SAAS,CAAE,KAAI,OAAO,UAAU,WAAY,OAAM,OAAO,MAAM,KAAK,QAAQ;UAC7G,SAAS,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,MAAM,CAAE,OAAM,OAAO,sBAAsB,OAAO,QAAQ;KACnH,OAAM,OAAO;AAClB,QAAO"}

package/dist/packages/fragno/dist/api/error.js

@@ -0,0 +1,48 @@
+//#region ../fragno/dist/api/error.js
+var FragnoApiError = class extends Error {
+	#status;
+	#code;
+	constructor({ message, code }, status) {
+		super(message);
+		this.name = "FragnoApiError";
+		this.#status = status;
+		this.#code = code;
+	}
+	get status() {
+		return this.#status;
+	}
+	get code() {
+		return this.#code;
+	}
+	toResponse() {
+		return Response.json({
+			message: this.message,
+			code: this.code
+		}, { status: this.status });
+	}
+};
+var FragnoApiValidationError = class extends FragnoApiError {
+	#issues;
+	constructor(message, issues) {
+		super({
+			message,
+			code: "FRAGNO_VALIDATION_ERROR"
+		}, 400);
+		this.name = "FragnoApiValidationError";
+		this.#issues = issues;
+	}
+	get issues() {
+		return this.#issues;
+	}
+	toResponse() {
+		return Response.json({
+			message: this.message,
+			issues: this.#issues,
+			code: this.code
+		}, { status: this.status });
+	}
+};
+
+//#endregion
+export { FragnoApiError, FragnoApiValidationError };
+//# sourceMappingURL=error.js.map

package/dist/packages/fragno/dist/api/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","names":["#status","#code","#issues"],"sources":["../../../../../../fragno/dist/api/error.js"],"sourcesContent":["//#region src/api/error.ts\nvar FragnoApiError = class extends Error {\n\t#status;\n\t#code;\n\tconstructor({ message, code }, status) {\n\t\tsuper(message);\n\t\tthis.name = \"FragnoApiError\";\n\t\tthis.#status = status;\n\t\tthis.#code = code;\n\t}\n\tget status() {\n\t\treturn this.#status;\n\t}\n\tget code() {\n\t\treturn this.#code;\n\t}\n\ttoResponse() {\n\t\treturn Response.json({\n\t\t\tmessage: this.message,\n\t\t\tcode: this.code\n\t\t}, { status: this.status });\n\t}\n};\nvar FragnoApiValidationError = class extends FragnoApiError {\n\t#issues;\n\tconstructor(message, issues) {\n\t\tsuper({\n\t\t\tmessage,\n\t\t\tcode: \"FRAGNO_VALIDATION_ERROR\"\n\t\t}, 400);\n\t\tthis.name = \"FragnoApiValidationError\";\n\t\tthis.#issues = issues;\n\t}\n\tget issues() {\n\t\treturn this.#issues;\n\t}\n\ttoResponse() {\n\t\treturn Response.json({\n\t\t\tmessage: this.message,\n\t\t\tissues: this.#issues,\n\t\t\tcode: this.code\n\t\t}, { status: this.status });\n\t}\n};\n\n//#endregion\nexport { FragnoApiError, FragnoApiValidationError };\n//# sourceMappingURL=error.js.map"],"mappings":";AACA,IAAI,iBAAiB,cAAc,MAAM;CACxC;CACA;CACA,YAAY,EAAE,SAAS,QAAQ,QAAQ;AACtC,QAAM,QAAQ;AACd,OAAK,OAAO;AACZ,QAAKA,SAAU;AACf,QAAKC,OAAQ;;CAEd,IAAI,SAAS;AACZ,SAAO,MAAKD;;CAEb,IAAI,OAAO;AACV,SAAO,MAAKC;;CAEb,aAAa;AACZ,SAAO,SAAS,KAAK;GACpB,SAAS,KAAK;GACd,MAAM,KAAK;GACX,EAAE,EAAE,QAAQ,KAAK,QAAQ,CAAC;;;AAG7B,IAAI,2BAA2B,cAAc,eAAe;CAC3D;CACA,YAAY,SAAS,QAAQ;AAC5B,QAAM;GACL;GACA,MAAM;GACN,EAAE,IAAI;AACP,OAAK,OAAO;AACZ,QAAKC,SAAU;;CAEhB,IAAI,SAAS;AACZ,SAAO,MAAKA;;CAEb,aAAa;AACZ,SAAO,SAAS,KAAK;GACpB,SAAS,KAAK;GACd,QAAQ,MAAKA;GACb,MAAM,KAAK;GACX,EAAE,EAAE,QAAQ,KAAK,QAAQ,CAAC"}