@fragno-dev/db 0.1.14 → 0.1.15

package/dist/fragment.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fragment.js","names":["serviceContext: DatabaseRequestThisContext","#name","#schema","#namespace","#dependencies","#services","#usedServices","#providedServices","#createDatabaseContext","services","implementation: TService"],"sources":["../src/fragment.ts"],"sourcesContent":["import type { AnySchema } from \"./schema/create\";\nimport type { AbstractQuery } from \"./query/query\";\nimport type { DatabaseAdapter } from \"./adapters/adapters\";\nimport { bindServicesToContext, type BoundServices } from \"./bind-services\";\nimport { AsyncLocalStorage } from \"async_hooks\";\nimport type { IUnitOfWorkBase, UnitOfWorkSchemaView } from \"./query/unit-of-work\";\nimport type { RequestThisContext } from \"@fragno-dev/core/api\";\n\nexport const uowStorage = new AsyncLocalStorage<IUnitOfWorkBase>();\n\n/**\n * Service context for database fragments, providing access to the Unit of Work.\n */\nexport interface DatabaseRequestThisContext extends RequestThisContext {\n  /**\n   * Get the Unit of Work from the current context.\n   * @param schema - Optional schema to get a typed view. If not provided, returns the base UOW.\n   * @returns IUnitOfWorkBase if no schema provided, or typed UnitOfWorkSchemaView if schema provided.\n   */\n  getUnitOfWork(): IUnitOfWorkBase;\n  getUnitOfWork<TSchema extends AnySchema>(\n    schema: TSchema,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ): UnitOfWorkSchemaView<TSchema, [], any>;\n}\n\nexport const serviceContext: DatabaseRequestThisContext = {\n  getUnitOfWork<TSchema extends AnySchema>(\n    schema?: TSchema,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ): any {\n    const uow = uowStorage.getStore();\n    if (!uow) {\n      throw new Error(\"No UnitOfWork in context. Service must be called within a route handler.\");\n    }\n    if (schema) {\n      return uow.forSchema(schema);\n    }\n    return uow;\n  },\n};\n\nexport function withUnitOfWork<T>(uow: IUnitOfWorkBase, callback: () => T): Promise<T> {\n  return Promise.resolve(uowStorage.run(uow, callback));\n}\n\n/**\n * Type helper that enforces DatabaseRequestThisContext on all functions in a service object\n */\ntype WithDatabaseThis<T> = {\n  [K in keyof T]: T[K] extends (...args: infer A) => infer R\n    ? (this: DatabaseRequestThisContext, ...args: A) => R\n    : T[K] extends Record<string, unknown>\n      ? WithDatabaseThis<T[K]>\n      : T[K];\n};\n\n// Import types from fragno package\nimport type {\n  FragmentDefinition,\n  RouteHandler,\n  FragnoPublicConfig,\n  RequestInputContext,\n  RequestOutputContext,\n} from \"@fragno-dev/core\";\n\nexport { bindServicesToContext, type BoundServices };\n\n/**\n * Route handler type for database fragments with access to Unit of Work.\n */\nexport type DatabaseRouteHandler = (\n  this: DatabaseRequestThisContext,\n  inputContext: RequestInputContext,\n  outputContext: RequestOutputContext,\n) => Promise<Response>;\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 = {},\n  const TUsedServices = {},\n  const TProvidedServices = {},\n> {\n  // Type-only property to expose type parameters for better inference\n  readonly $types!: {\n    schema: TSchema;\n    config: TConfig;\n    deps: TDeps;\n    services: TServices;\n    usedServices: TUsedServices;\n    providedServices: TProvidedServices;\n  };\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 & TUsedServices;\n      defineService: <T extends Record<string, unknown>>(\n        services: WithDatabaseThis<T>,\n      ) => WithDatabaseThis<T>;\n    } & DatabaseFragmentContext<TSchema>,\n  ) => TServices;\n  #usedServices?: Record<string, { name: string; required: boolean }>;\n  #providedServices?: Record<string, unknown>;\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 & TUsedServices;\n        defineService: <T extends Record<string, unknown>>(\n          services: WithDatabaseThis<T>,\n        ) => WithDatabaseThis<T>;\n      } & DatabaseFragmentContext<TSchema>,\n    ) => TServices;\n    usedServices?: Record<string, { name: string; required: boolean }>;\n    providedServices?: Record<string, unknown>;\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    this.#usedServices = options.usedServices;\n    this.#providedServices = options.providedServices;\n  }\n\n  get $requiredOptions(): FragnoPublicConfigWithDatabase {\n    throw new Error(\"Type only method. Do not call.\");\n  }\n\n  get definition(): FragmentDefinition<\n    TConfig,\n    TDeps,\n    BoundServices<TServices>,\n    { databaseSchema?: TSchema; databaseNamespace: string },\n    BoundServices<TUsedServices>,\n    BoundServices<TProvidedServices>,\n    DatabaseRequestThisContext\n  > {\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    const providedServices = this.#providedServices;\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: (\n        config: TConfig,\n        options: FragnoPublicConfig,\n        deps: TDeps & BoundServices<TUsedServices>,\n      ) => {\n        const dbContext = this.#createDatabaseContext(options, schema, namespace, name);\n        // Cast deps back to raw type for internal services function.\n        // This is safe because:\n        // 1. deps are already bound (their 'this' parameters are stripped)\n        // 2. The services function expects raw types but only uses the public API\n        // 3. BoundServices<T> has the same runtime shape as T (just without 'this')\n\n        // defineService provides typing for service functions\n        // It expects the input to already have proper 'this' types on functions\n        const defineService = <T extends Record<string, unknown>>(\n          services: WithDatabaseThis<T>,\n        ): WithDatabaseThis<T> => services;\n\n        const rawServices =\n          services?.({\n            config,\n            fragnoConfig: options,\n            deps: deps as TDeps & TUsedServices,\n            defineService,\n            ...dbContext,\n          }) ?? ({} as TServices);\n\n        // Bind all service methods to serviceContext\n        return bindServicesToContext(\n          rawServices as Record<string, unknown>,\n        ) as BoundServices<TServices>;\n      },\n      additionalContext: {\n        databaseSchema: schema,\n        databaseNamespace: namespace,\n      },\n      createHandlerWrapper: schema\n        ? (options: FragnoPublicConfig) => {\n            const dbContext = this.#createDatabaseContext(options, schema, namespace, name);\n            const { orm } = dbContext;\n\n            // Return handler wrapper function\n            return (handler: DatabaseRouteHandler): RouteHandler => {\n              return async (inputContext, outputContext) => {\n                // Create UOW for this request\n                const uow = orm.createUnitOfWork();\n\n                // Execute handler within AsyncLocalStorage context\n                return withUnitOfWork(uow, async () => {\n                  // Bind handler to serviceContext so it has access to getUnitOfWork via 'this'\n                  const boundHandler = handler.bind(serviceContext);\n                  return boundHandler(inputContext, outputContext);\n                });\n              };\n            };\n          }\n        : undefined,\n      usedServices: this.#usedServices as\n        | {\n            [K in keyof TUsedServices]: { name: string; required: boolean };\n          }\n        | undefined,\n      // Pass providedServices as-is - let fragment-instantiation.ts handle resolution\n      // The factory functions will be called by createFragment\n      providedServices: providedServices as\n        | {\n            [K in keyof BoundServices<TProvidedServices>]: BoundServices<TProvidedServices>[K];\n          }\n        | ((\n            config: TConfig,\n            options: FragnoPublicConfig,\n            deps: TDeps & BoundServices<TUsedServices>,\n          ) => BoundServices<TProvidedServices>)\n        | undefined,\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<\n    TNewSchema,\n    TConfig,\n    TDeps,\n    TServices,\n    TUsedServices,\n    TProvidedServices\n  > {\n    return new DatabaseFragmentBuilder<\n      TNewSchema,\n      TConfig,\n      TDeps,\n      TServices,\n      TUsedServices,\n      TProvidedServices\n    >({\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 & TUsedServices;\n              defineService: <T extends Record<string, unknown>>(\n                services: WithDatabaseThis<T>,\n              ) => WithDatabaseThis<T>;\n            } & DatabaseFragmentContext<TNewSchema>,\n          ) => TServices)\n        | undefined,\n      usedServices: this.#usedServices,\n      providedServices: this.#providedServices,\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, {}, TUsedServices, TProvidedServices> {\n    return new DatabaseFragmentBuilder<\n      TSchema,\n      TConfig,\n      TNewDeps,\n      {},\n      TUsedServices,\n      TProvidedServices\n    >({\n      name: this.#name,\n      schema: this.#schema,\n      namespace: this.#namespace,\n      dependencies: fn,\n      services: undefined,\n      usedServices: this.#usedServices,\n      providedServices: this.#providedServices,\n    });\n  }\n\n  /**\n   * Declare that this fragment uses a service.\n   * @param serviceName - The name of the service to use\n   * @param options - Optional configuration: { optional: boolean } (defaults to required)\n   */\n  usesService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n    options?: { optional?: false },\n  ): DatabaseFragmentBuilder<\n    TSchema,\n    TConfig,\n    TDeps,\n    TServices,\n    TUsedServices & { [K in TServiceName]: TService },\n    TProvidedServices\n  >;\n  usesService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n    options: { optional: true },\n  ): DatabaseFragmentBuilder<\n    TSchema,\n    TConfig,\n    TDeps,\n    TServices,\n    TUsedServices & { [K in TServiceName]: TService | undefined },\n    TProvidedServices\n  >;\n  usesService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n    options?: { optional?: boolean },\n  ): DatabaseFragmentBuilder<\n    TSchema,\n    TConfig,\n    TDeps,\n    TServices,\n    TUsedServices & { [K in TServiceName]: TService | TService | undefined },\n    TProvidedServices\n  > {\n    const isOptional = options?.optional ?? false;\n    return new DatabaseFragmentBuilder<\n      TSchema,\n      TConfig,\n      TDeps,\n      TServices,\n      TUsedServices & { [K in TServiceName]: TService | (TService | undefined) },\n      TProvidedServices\n    >({\n      name: this.#name,\n      schema: this.#schema,\n      namespace: this.#namespace,\n      dependencies: this.#dependencies as unknown as\n        | ((\n            context: {\n              config: TConfig;\n              fragnoConfig: FragnoPublicConfig;\n            } & DatabaseFragmentContext<TSchema>,\n          ) => TDeps)\n        | undefined,\n      services: this.#services as unknown as\n        | ((\n            context: {\n              config: TConfig;\n              fragnoConfig: FragnoPublicConfig;\n              deps: TDeps &\n                (TUsedServices & { [K in TServiceName]: TService | (TService | undefined) });\n            } & DatabaseFragmentContext<TSchema>,\n          ) => TServices)\n        | undefined,\n      usedServices: {\n        ...this.#usedServices,\n        [serviceName]: { name: serviceName, required: !isOptional },\n      },\n      providedServices: this.#providedServices,\n    });\n  }\n\n  /**\n   * Define services for this fragment (unnamed).\n   * Functions in the service will have access to DatabaseRequestThisContext via `this` if using `defineService`.\n   *\n   * @example\n   * With `this` context:\n   * ```ts\n   * .providesService(({ defineService }) => defineService({\n   *   createUser: function(name: string) {\n   *     const uow = this.getUnitOfWork(mySchema);\n   *     return uow.create('user', { name });\n   *   }\n   * }))\n   * ```\n   *\n   * Without `this` context:\n   * ```ts\n   * .providesService(({ db }) => ({\n   *   createUser: async (name: string) => {\n   *     return db.create('user', { name });\n   *   }\n   * }))\n   * ```\n   */\n  providesService<TNewServices>(\n    fn: (context: {\n      config: TConfig;\n      fragnoConfig: FragnoPublicConfig;\n      deps: TDeps & TUsedServices;\n      db: AbstractQuery<TSchema>;\n      defineService: <T extends Record<string, unknown>>(\n        services: WithDatabaseThis<T>,\n      ) => WithDatabaseThis<T>;\n    }) => TNewServices,\n  ): DatabaseFragmentBuilder<\n    TSchema,\n    TConfig,\n    TDeps,\n    TNewServices,\n    TUsedServices,\n    TProvidedServices\n  >;\n\n  /**\n   * Provide a named service that other fragments can use.\n   * Functions in the service will have access to DatabaseRequestThisContext via `this` if using `defineService`.\n   * You can also pass a service object directly instead of a callback.\n   *\n   * @example\n   * With callback and `this` context:\n   * ```ts\n   * .providesService(\"myService\", ({ defineService }) => defineService({\n   *   createUser: function(name: string) {\n   *     const uow = this.getUnitOfWork(mySchema);\n   *     return uow.create('user', { name });\n   *   }\n   * }))\n   * ```\n   *\n   * With callback, no `this` context:\n   * ```ts\n   * .providesService(\"myService\", ({ db }) => ({\n   *   createUser: async (name: string) => {\n   *     return db.create('user', { name });\n   *   }\n   * }))\n   * ```\n   *\n   * With direct object:\n   * ```ts\n   * .providesService(\"myService\", {\n   *   createUser: async (name: string) => { ... }\n   * })\n   * ```\n   */\n  providesService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n    fnOrService:\n      | ((context: {\n          config: TConfig;\n          fragnoConfig: FragnoPublicConfig;\n          deps: TDeps & TUsedServices;\n          db: AbstractQuery<TSchema>;\n          defineService: <T extends Record<string, unknown>>(\n            services: WithDatabaseThis<T>,\n          ) => WithDatabaseThis<T>;\n        }) => TService)\n      | TService,\n  ): DatabaseFragmentBuilder<\n    TSchema,\n    TConfig,\n    TDeps,\n    TServices,\n    TUsedServices,\n    TProvidedServices & { [K in TServiceName]: BoundServices<TService> }\n  >;\n\n  providesService<TServiceName extends string, TService>(\n    ...args:\n      | [\n          fn: (context: {\n            config: TConfig;\n            fragnoConfig: FragnoPublicConfig;\n            deps: TDeps & TUsedServices;\n            db: AbstractQuery<TSchema>;\n            defineService: <T extends Record<string, unknown>>(\n              services: WithDatabaseThis<T>,\n            ) => WithDatabaseThis<T>;\n          }) => TService,\n        ]\n      | [\n          serviceName: TServiceName,\n          fnOrService:\n            | ((context: {\n                config: TConfig;\n                fragnoConfig: FragnoPublicConfig;\n                deps: TDeps & TUsedServices;\n                db: AbstractQuery<TSchema>;\n                defineService: <T extends Record<string, unknown>>(\n                  services: WithDatabaseThis<T>,\n                ) => WithDatabaseThis<T>;\n              }) => TService)\n            | TService,\n        ]\n  ):\n    | DatabaseFragmentBuilder<TSchema, TConfig, TDeps, TService, TUsedServices, TProvidedServices>\n    | DatabaseFragmentBuilder<\n        TSchema,\n        TConfig,\n        TDeps,\n        TServices,\n        TUsedServices,\n        TProvidedServices & { [K in TServiceName]: BoundServices<TService> }\n      > {\n    if (args.length === 1) {\n      // Unnamed service - replaces withServices\n      const [fn] = args;\n\n      // Create a callback that takes a single context object (matching #services signature)\n      // Note: We don't explicitly type the return to preserve the WithDatabaseThis wrapper\n      const servicesCallback = (\n        context: {\n          config: TConfig;\n          fragnoConfig: FragnoPublicConfig;\n          deps: TDeps & TUsedServices;\n        } & DatabaseFragmentContext<TSchema>,\n      ) => {\n        // defineService provides typing for service functions\n        // It expects the input to already have proper 'this' types on functions\n        const defineService = <T extends Record<string, unknown>>(\n          services: WithDatabaseThis<T>,\n        ): WithDatabaseThis<T> => services;\n\n        const services = fn({\n          config: context.config,\n          fragnoConfig: context.fragnoConfig,\n          deps: context.deps,\n          db: context.orm,\n          defineService,\n        });\n\n        // Return without casting to preserve the WithDatabaseThis wrapper\n        return services;\n      };\n\n      return new DatabaseFragmentBuilder<\n        TSchema,\n        TConfig,\n        TDeps,\n        TService,\n        TUsedServices,\n        TProvidedServices\n      >({\n        name: this.#name,\n        schema: this.#schema,\n        namespace: this.#namespace,\n        dependencies: this.#dependencies,\n        // Safe cast: servicesCallback returns WithDatabaseThis<TService> but we store it as TService.\n        // At runtime, bindServicesToContext will handle the 'this' binding properly.\n        services: servicesCallback as (\n          context: {\n            config: TConfig;\n            fragnoConfig: FragnoPublicConfig;\n            deps: TDeps & TUsedServices;\n            defineService: <T extends Record<string, unknown>>(\n              services: WithDatabaseThis<T>,\n            ) => WithDatabaseThis<T>;\n          } & DatabaseFragmentContext<TSchema>,\n        ) => TService,\n        usedServices: this.#usedServices,\n        providedServices: this.#providedServices,\n      });\n    } else {\n      // Named service\n      const [serviceName, fnOrService] = args;\n\n      // Create a callback that provides the full context\n      const createService = (\n        config: TConfig,\n        options: FragnoPublicConfig,\n        deps: TDeps & TUsedServices,\n      ): BoundServices<TService> => {\n        const dbContext = this.#createDatabaseContext(\n          options,\n          this.#schema,\n          this.#namespace ?? \"\",\n          this.#name,\n        );\n\n        // Check if fnOrService is a function or a direct object\n        let implementation: TService;\n        if (typeof fnOrService === \"function\") {\n          // It's a callback - call it with context\n          // defineService provides typing for service functions\n          // It expects the input to already have proper 'this' types on functions\n          const defineService = <T extends Record<string, unknown>>(\n            services: WithDatabaseThis<T>,\n          ): WithDatabaseThis<T> => services;\n\n          // Safe cast: we checked that fnOrService is a function\n          implementation = (\n            fnOrService as (context: {\n              config: TConfig;\n              fragnoConfig: FragnoPublicConfig;\n              deps: TDeps & TUsedServices;\n              db: AbstractQuery<TSchema>;\n              defineService: <T extends Record<string, unknown>>(\n                services: WithDatabaseThis<T>,\n              ) => WithDatabaseThis<T>;\n            }) => TService\n          )({\n            config,\n            fragnoConfig: options,\n            deps,\n            db: dbContext.orm,\n            defineService,\n          });\n        } else {\n          // It's a direct object\n          implementation = fnOrService;\n        }\n\n        // Bind the service implementation so methods have access to serviceContext\n        return bindServicesToContext(\n          implementation as Record<string, unknown>,\n        ) as BoundServices<TService>;\n      };\n\n      // We need to evaluate this immediately to store in providedServices\n      // For now, we'll create a placeholder that will be evaluated when fragment is instantiated\n      // Actually, we need to defer this until fragment instantiation\n      // Let's store a function that creates the service\n      return new DatabaseFragmentBuilder<\n        TSchema,\n        TConfig,\n        TDeps,\n        TServices,\n        TUsedServices,\n        TProvidedServices & { [K in TServiceName]: BoundServices<TService> }\n      >({\n        name: this.#name,\n        schema: this.#schema,\n        namespace: this.#namespace,\n        dependencies: this.#dependencies,\n        services: this.#services,\n        usedServices: this.#usedServices,\n        providedServices: {\n          ...this.#providedServices,\n          [serviceName]: createService,\n        } as Record<string, unknown>,\n      });\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":"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"}

package/dist/shared/settings-schema.js

@@ -1,36 +0,0 @@
-import { column, idColumn, schema } from "../schema/create.js";
-
-//#region src/shared/settings-schema.ts
-const SETTINGS_TABLE_NAME = "fragno_db_settings";
-const SETTINGS_NAMESPACE = "fragno-db-settings";
-const settingsSchema = schema((s) => {
-	return s.addTable(SETTINGS_TABLE_NAME, (t) => {
-		return t.addColumn("id", idColumn()).addColumn("key", column("string")).addColumn("value", column("string")).createIndex("unique_key", ["key"], { unique: true });
-	});
-});
-function createSettingsManager(queryEngine, namespace) {
-	return {
-		async get(key) {
-			const [[result]] = await queryEngine.createUnitOfWork().find(SETTINGS_TABLE_NAME, (b) => b.whereIndex("unique_key", (eb) => eb("key", "=", `${namespace}.${key}`))).executeRetrieve();
-			return result;
-		},
-		async set(key, value) {
-			const uow = queryEngine.createUnitOfWork("createSettingsManager#set").find(SETTINGS_TABLE_NAME, (b) => b.whereIndex("unique_key", (eb) => eb("key", "=", `${namespace}.${key}`)));
-			const [[existing]] = await uow.executeRetrieve();
-			if (existing) uow.update(SETTINGS_TABLE_NAME, existing.id, (b) => b.set({ value }).check());
-			else uow.create(SETTINGS_TABLE_NAME, {
-				key: `${namespace}.${key}`,
-				value
-			});
-			const { success } = await uow.executeMutations();
-			if (!success) throw new Error("Failed to set schema version");
-		},
-		async delete(id) {
-			await queryEngine.delete(SETTINGS_TABLE_NAME, id);
-		}
-	};
-}
-
-//#endregion
-export { SETTINGS_NAMESPACE, SETTINGS_TABLE_NAME, createSettingsManager, settingsSchema };
-//# sourceMappingURL=settings-schema.js.map

package/dist/shared/settings-schema.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"settings-schema.js","names":[],"sources":["../../src/shared/settings-schema.ts"],"sourcesContent":["import type { AbstractQuery } from \"../query/query\";\nimport { schema, idColumn, column, type FragnoId } from \"../schema/create\";\n\nexport const SETTINGS_TABLE_NAME = \"fragno_db_settings\" as const;\nexport const SETTINGS_NAMESPACE = \"fragno-db-settings\" as const;\n\nexport const settingsSchema = schema((s) => {\n  return s.addTable(SETTINGS_TABLE_NAME, (t) => {\n    return t\n      .addColumn(\"id\", idColumn())\n      .addColumn(\"key\", column(\"string\"))\n      .addColumn(\"value\", column(\"string\"))\n      .createIndex(\"unique_key\", [\"key\"], { unique: true });\n  });\n});\n\nexport function createSettingsManager(\n  // oxlint-disable-next-line no-explicit-any\n  queryEngine: AbstractQuery<typeof settingsSchema, any>,\n  namespace: string,\n) {\n  return {\n    async get(key: string): Promise<{ id: FragnoId; key: string; value: string } | undefined> {\n      const uow = queryEngine\n        .createUnitOfWork()\n        .find(SETTINGS_TABLE_NAME, (b) =>\n          b.whereIndex(\"unique_key\", (eb) => eb(\"key\", \"=\", `${namespace}.${key}`)),\n        );\n      const [[result]] = await uow.executeRetrieve();\n      return result; // Safe: result can be undefined if key doesn't exist\n    },\n\n    async set(key: string, value: string) {\n      const uow = queryEngine\n        .createUnitOfWork(\"createSettingsManager#set\")\n        .find(SETTINGS_TABLE_NAME, (b) =>\n          b.whereIndex(\"unique_key\", (eb) => eb(\"key\", \"=\", `${namespace}.${key}`)),\n        );\n      const [[existing]] = await uow.executeRetrieve();\n\n      if (existing) {\n        uow.update(SETTINGS_TABLE_NAME, existing.id, (b) => b.set({ value }).check());\n      } else {\n        uow.create(SETTINGS_TABLE_NAME, {\n          key: `${namespace}.${key}`,\n          value,\n        });\n      }\n\n      const { success } = await uow.executeMutations();\n\n      if (!success) {\n        throw new Error(\"Failed to set schema version\");\n      }\n    },\n\n    async delete(id: FragnoId) {\n      await queryEngine.delete(SETTINGS_TABLE_NAME, id);\n    },\n  };\n}\n"],"mappings":";;;AAGA,MAAa,sBAAsB;AACnC,MAAa,qBAAqB;AAElC,MAAa,iBAAiB,QAAQ,MAAM;AAC1C,QAAO,EAAE,SAAS,sBAAsB,MAAM;AAC5C,SAAO,EACJ,UAAU,MAAM,UAAU,CAAC,CAC3B,UAAU,OAAO,OAAO,SAAS,CAAC,CAClC,UAAU,SAAS,OAAO,SAAS,CAAC,CACpC,YAAY,cAAc,CAAC,MAAM,EAAE,EAAE,QAAQ,MAAM,CAAC;GACvD;EACF;AAEF,SAAgB,sBAEd,aACA,WACA;AACA,QAAO;EACL,MAAM,IAAI,KAAgF;GAMxF,MAAM,CAAC,CAAC,WAAW,MALP,YACT,kBAAkB,CAClB,KAAK,sBAAsB,MAC1B,EAAE,WAAW,eAAe,OAAO,GAAG,OAAO,KAAK,GAAG,UAAU,GAAG,MAAM,CAAC,CAC1E,CAC0B,iBAAiB;AAC9C,UAAO;;EAGT,MAAM,IAAI,KAAa,OAAe;GACpC,MAAM,MAAM,YACT,iBAAiB,4BAA4B,CAC7C,KAAK,sBAAsB,MAC1B,EAAE,WAAW,eAAe,OAAO,GAAG,OAAO,KAAK,GAAG,UAAU,GAAG,MAAM,CAAC,CAC1E;GACH,MAAM,CAAC,CAAC,aAAa,MAAM,IAAI,iBAAiB;AAEhD,OAAI,SACF,KAAI,OAAO,qBAAqB,SAAS,KAAK,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC;OAE7E,KAAI,OAAO,qBAAqB;IAC9B,KAAK,GAAG,UAAU,GAAG;IACrB;IACD,CAAC;GAGJ,MAAM,EAAE,YAAY,MAAM,IAAI,kBAAkB;AAEhD,OAAI,CAAC,QACH,OAAM,IAAI,MAAM,+BAA+B;;EAInD,MAAM,OAAO,IAAc;AACzB,SAAM,YAAY,OAAO,qBAAqB,GAAG;;EAEpD"}

package/src/bind-services.test.ts

@@ -1,214 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { bindServicesToContext } from "./bind-services";
-import { withUnitOfWork, type DatabaseRequestThisContext } from "./fragment";
-import type { IUnitOfWorkBase } from "./query/unit-of-work";
-import { schema, idColumn } from "./schema/create";
-
-// Create a simple test schema for tests
-const testSchema = schema((s) => {
-  return s.addTable("test", (t) => {
-    return t.addColumn("id", idColumn());
-  });
-});
-
-describe("bindServicesToContext", () => {
-  it("should bind simple function to context", async () => {
-    const mockSchemaView = { test: "schema-view" };
-    const mockUow = {
-      test: "uow",
-      forSchema: () => mockSchemaView,
-    } as unknown as IUnitOfWorkBase;
-
-    const services = {
-      testMethod: function (this: DatabaseRequestThisContext) {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        return this.getUnitOfWork(testSchema as any);
-      },
-    };
-
-    const bound = bindServicesToContext(services);
-
-    const result = await withUnitOfWork(mockUow, () => bound.testMethod());
-
-    expect(result).toBe(mockSchemaView);
-  });
-
-  it("should bind multiple functions", async () => {
-    const mockSchemaView = { test: "schema-view" };
-    const mockUow = {
-      test: "uow",
-      forSchema: () => mockSchemaView,
-    } as unknown as IUnitOfWorkBase;
-
-    const services = {
-      method1: function (this: DatabaseRequestThisContext) {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        return this.getUnitOfWork(testSchema as any);
-      },
-      method2: function (this: DatabaseRequestThisContext) {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        return this.getUnitOfWork(testSchema as any);
-      },
-    };
-
-    const bound = bindServicesToContext(services);
-
-    await withUnitOfWork(mockUow, () => {
-      expect(bound.method1()).toBe(mockSchemaView);
-      expect(bound.method2()).toBe(mockSchemaView);
-    });
-  });
-
-  it("should bind nested service objects", async () => {
-    const mockSchemaView = { test: "schema-view" };
-    const mockUow = {
-      test: "uow",
-      forSchema: () => mockSchemaView,
-    } as unknown as IUnitOfWorkBase;
-
-    const services = {
-      nested: {
-        method: function (this: DatabaseRequestThisContext) {
-          // eslint-disable-next-line @typescript-eslint/no-explicit-any
-          return this.getUnitOfWork(testSchema as any);
-        },
-      },
-    };
-
-    const bound = bindServicesToContext(services);
-
-    const result = await withUnitOfWork(mockUow, () => bound.nested.method());
-
-    expect(result).toBe(mockSchemaView);
-  });
-
-  it("should preserve non-function properties", () => {
-    const services = {
-      method: function () {
-        return "test";
-      },
-      constant: "value",
-      number: 42,
-    };
-
-    const bound = bindServicesToContext(services);
-
-    expect(bound.constant).toBe("value");
-    expect(bound.number).toBe(42);
-    expect(bound.method()).toBe("test");
-  });
-
-  it("should handle functions with parameters", async () => {
-    const mockSchemaView = { test: "schema-view" };
-    const mockUow = {
-      test: "uow",
-      forSchema: () => mockSchemaView,
-    } as unknown as IUnitOfWorkBase;
-
-    const services = {
-      testMethod: function (this: DatabaseRequestThisContext, param1: string, param2: number) {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        const uow = this.getUnitOfWork(testSchema as any);
-        return { uow, param1, param2 };
-      },
-    };
-
-    const bound = bindServicesToContext(services);
-
-    const result = await withUnitOfWork(mockUow, () => bound.testMethod("hello", 123));
-
-    expect(result.uow).toBe(mockSchemaView);
-    expect(result.param1).toBe("hello");
-    expect(result.param2).toBe(123);
-  });
-
-  it("should handle async functions", async () => {
-    const mockSchemaView = { test: "schema-view" };
-    const mockUow = {
-      test: "uow",
-      forSchema: () => mockSchemaView,
-    } as unknown as IUnitOfWorkBase;
-
-    const services = {
-      asyncMethod: async function (this: DatabaseRequestThisContext) {
-        await new Promise((resolve) => setTimeout(resolve, 10));
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        return this.getUnitOfWork(testSchema as any);
-      },
-    };
-
-    const bound = bindServicesToContext(services);
-
-    const result = await withUnitOfWork(mockUow, async () => await bound.asyncMethod());
-
-    expect(result).toBe(mockSchemaView);
-  });
-
-  it("should not bind arrays", () => {
-    const services = {
-      array: [1, 2, 3],
-      method: function () {
-        return "test";
-      },
-    };
-
-    const bound = bindServicesToContext(services);
-
-    expect(bound.array).toEqual([1, 2, 3]);
-    expect(Array.isArray(bound.array)).toBe(true);
-  });
-
-  it("should handle deeply nested objects", async () => {
-    const mockSchemaView = { test: "schema-view" };
-    const mockUow = {
-      test: "uow",
-      forSchema: () => mockSchemaView,
-    } as unknown as IUnitOfWorkBase;
-
-    const services = {
-      level1: {
-        level2: {
-          level3: {
-            method: function (this: DatabaseRequestThisContext) {
-              // eslint-disable-next-line @typescript-eslint/no-explicit-any
-              return this.getUnitOfWork(testSchema as any);
-            },
-          },
-        },
-      },
-    };
-
-    const bound = bindServicesToContext(services);
-
-    const result = await withUnitOfWork(mockUow, () => bound.level1.level2.level3.method());
-
-    expect(result).toBe(mockSchemaView);
-  });
-
-  it("should allow bound services to access UOW independently", async () => {
-    const mockSchemaView = { test: "schema-view" };
-    const mockUow = {
-      test: "uow",
-      forSchema: () => mockSchemaView,
-    } as unknown as IUnitOfWorkBase;
-
-    const services = {
-      getUow: function (this: DatabaseRequestThisContext) {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        return this.getUnitOfWork(testSchema as any);
-      },
-      callOther: function (this: DatabaseRequestThisContext) {
-        // Both methods can access UOW via their own `this` context
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        return this.getUnitOfWork(testSchema as any);
-      },
-    };
-
-    const bound = bindServicesToContext(services);
-
-    await withUnitOfWork(mockUow, () => {
-      expect(bound.getUow()).toBe(mockSchemaView);
-      expect(bound.callOther()).toBe(mockSchemaView);
-    });
-  });
-});

package/src/bind-services.ts

@@ -1,37 +0,0 @@
-import { serviceContext } from "./fragment";
-
-// Type helper to remove 'this' parameter from functions
-type OmitThisParameter<T> = T extends (this: infer _This, ...args: infer A) => infer R
-  ? (...args: A) => R
-  : T;
-
-// Recursively remove 'this' parameter from all functions in an object
-export type BoundServices<T> = {
-  [K in keyof T]: T[K] extends (...args: never[]) => unknown
-    ? OmitThisParameter<T[K]>
-    : T[K] extends Record<string, unknown>
-      ? BoundServices<T[K]>
-      : T[K];
-};
-
-export function bindServicesToContext<T extends Record<string, unknown>>(
-  services: T,
-): BoundServices<T> {
-  const bound = {} as BoundServices<T>;
-
-  for (const [key, value] of Object.entries(services)) {
-    if (typeof value === "function") {
-      // Bind function to serviceContext
-      bound[key as keyof T] = value.bind(serviceContext) as BoundServices<T>[keyof T];
-    } else if (value && typeof value === "object" && !Array.isArray(value)) {
-      // Recursively bind nested service objects
-      bound[key as keyof T] = bindServicesToContext(
-        value as Record<string, unknown>,
-      ) as BoundServices<T>[keyof T];
-    } else {
-      bound[key as keyof T] = value as BoundServices<T>[keyof T];
-    }
-  }
-
-  return bound;
-}