@fluojs/drizzle 1.1.0 → 2.0.0

package/dist/registration-providers.d.ts

@@ -0,0 +1,44 @@
+import type { Provider } from '@fluojs/di';
+import type { DrizzleDatabaseLike, DrizzleModuleOptions } from './types.js';
+/**
+ * Normalized runtime options consumed by lifecycle-aware Drizzle providers.
+ *
+ * @internal
+ */
+export type DrizzleRuntimeOptions = {
+    strictTransactions: boolean;
+};
+/**
+ * Fully normalized module options stored behind an internal registration token.
+ *
+ * @internal
+ */
+export type ResolvedDrizzleModuleOptions<TDatabase extends DrizzleDatabaseLike<TTransactionDatabase, TTransactionOptions>, TTransactionDatabase, TTransactionOptions> = Omit<DrizzleModuleOptions<TDatabase, TTransactionDatabase, TTransactionOptions>, 'strictTransactions'> & {
+    strictTransactions: boolean;
+};
+/**
+ * Returns the internal options token for a default or named registration.
+ *
+ * @internal
+ * @param name Optional normalized registration name.
+ * @returns The internal token that stores normalized module options.
+ */
+export declare function getNormalizedOptionsToken(name?: string): symbol;
+/**
+ * Returns the globally stable duplicate-registration guard token for a name.
+ *
+ * @internal
+ * @param name Normalized named-registration identity.
+ * @returns The guard token shared by registrations using the same name.
+ */
+export declare function getRegistrationGuardToken(name: string): symbol;
+/**
+ * Builds the provider graph for a default or named Drizzle registration.
+ *
+ * @internal
+ * @param normalizedOptionsProvider Provider that supplies normalized module options.
+ * @param name Optional normalized registration name.
+ * @returns Providers for the registration's raw handle, lifecycle wrapper, options, and disposal hook.
+ */
+export declare function createDrizzleRuntimeProviders<TDatabase extends DrizzleDatabaseLike<TTransactionDatabase, TTransactionOptions>, TTransactionDatabase, TTransactionOptions>(normalizedOptionsProvider: Provider, name?: string): Provider[];
+//# sourceMappingURL=registration-providers.d.ts.map

package/dist/registration-providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registration-providers.d.ts","sourceRoot":"","sources":["../src/registration-providers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAU3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE5E;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,kBAAkB,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,4BAA4B,CACtC,SAAS,SAAS,mBAAmB,CAAC,oBAAoB,EAAE,mBAAmB,CAAC,EAChF,oBAAoB,EACpB,mBAAmB,IACjB,IAAI,CAAC,oBAAoB,CAAC,SAAS,EAAE,oBAAoB,EAAE,mBAAmB,CAAC,EAAE,oBAAoB,CAAC,GAAG;IAC3G,kBAAkB,EAAE,OAAO,CAAC;CAC7B,CAAC;AAKF;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAI/D;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9D;AAoBD;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,SAAS,SAAS,mBAAmB,CAAC,oBAAoB,EAAE,mBAAmB,CAAC,EAChF,oBAAoB,EACpB,mBAAmB,EAEnB,yBAAyB,EAAE,QAAQ,EACnC,IAAI,CAAC,EAAE,MAAM,GACZ,QAAQ,EAAE,CAyGZ"}

package/dist/registration-providers.js

@@ -0,0 +1,120 @@
+import { DrizzleDatabase } from './database.js';
+import { getDrizzleDatabaseToken, getDrizzleDisposeToken, getDrizzleHandleProviderToken, getDrizzleOptionsToken } from './tokens.js';
+import { DrizzleTransactionInterceptor } from './transaction.js';
+
+/**
+ * Normalized runtime options consumed by lifecycle-aware Drizzle providers.
+ *
+ * @internal
+ */
+
+/**
+ * Fully normalized module options stored behind an internal registration token.
+ *
+ * @internal
+ */
+
+const DRIZZLE_NORMALIZED_OPTIONS = Symbol('fluo.drizzle.normalized-options');
+const DRIZZLE_REGISTRATION_IDENTITIES = Symbol.for('fluo.drizzle.registration-identities');
+
+/**
+ * Returns the internal options token for a default or named registration.
+ *
+ * @internal
+ * @param name Optional normalized registration name.
+ * @returns The internal token that stores normalized module options.
+ */
+export function getNormalizedOptionsToken(name) {
+  return name === undefined ? DRIZZLE_NORMALIZED_OPTIONS : Symbol.for(`fluo.drizzle.normalized-options:${name}`);
+}
+
+/**
+ * Returns the globally stable duplicate-registration guard token for a name.
+ *
+ * @internal
+ * @param name Normalized named-registration identity.
+ * @returns The guard token shared by registrations using the same name.
+ */
+export function getRegistrationGuardToken(name) {
+  return Symbol.for(`fluo.drizzle.registration-guard:${name}`);
+}
+function assertUniqueDrizzleRegistrationIdentities(identities) {
+  const seen = new Set();
+  for (const identity of identities) {
+    if (seen.has(identity)) {
+      throw new Error(`Duplicate @fluojs/drizzle registration identity "${identity}". Every named DrizzleModule.forRoot(...) registration owns one lifecycle-managed database, so pass a distinct name to each additional registration.`);
+    }
+    seen.add(identity);
+  }
+}
+function createRuntimeOptionsProviderValue(strictTransactions) {
+  return {
+    strictTransactions
+  };
+}
+
+/**
+ * Builds the provider graph for a default or named Drizzle registration.
+ *
+ * @internal
+ * @param normalizedOptionsProvider Provider that supplies normalized module options.
+ * @param name Optional normalized registration name.
+ * @returns Providers for the registration's raw handle, lifecycle wrapper, options, and disposal hook.
+ */
+export function createDrizzleRuntimeProviders(normalizedOptionsProvider, name) {
+  const normalizedOptionsToken = getNormalizedOptionsToken(name);
+  const databaseToken = getDrizzleDatabaseToken(name);
+  const disposeToken = getDrizzleDisposeToken(name);
+  const optionsToken = getDrizzleOptionsToken(name);
+  const handleProviderToken = getDrizzleHandleProviderToken(name);
+  const registrationGuardToken = name === undefined ? undefined : getRegistrationGuardToken(name);
+  const registrationProviders = registrationGuardToken === undefined ? [] : [{
+    multi: true,
+    provide: DRIZZLE_REGISTRATION_IDENTITIES,
+    useValue: name
+  }, {
+    inject: [DRIZZLE_REGISTRATION_IDENTITIES],
+    provide: registrationGuardToken,
+    scope: 'singleton',
+    useFactory: identities => {
+      assertUniqueDrizzleRegistrationIdentities(identities);
+    }
+  }];
+  const withRegistrationGuard = dependencies => registrationGuardToken === undefined ? [...dependencies] : [registrationGuardToken, ...dependencies];
+  return [...registrationProviders, normalizedOptionsProvider, {
+    inject: withRegistrationGuard([normalizedOptionsToken]),
+    provide: databaseToken,
+    useFactory: (...dependencies) => {
+      const options = dependencies.at(-1);
+      return options.database;
+    }
+  }, {
+    inject: withRegistrationGuard([normalizedOptionsToken]),
+    provide: disposeToken,
+    useFactory: (...dependencies) => {
+      const options = dependencies.at(-1);
+      return options.dispose;
+    }
+  }, {
+    inject: withRegistrationGuard([normalizedOptionsToken]),
+    provide: optionsToken,
+    useFactory: (...dependencies) => {
+      const options = dependencies.at(-1);
+      return createRuntimeOptionsProviderValue(options.strictTransactions);
+    }
+  }, ...(name === undefined ? [{
+    inject: [databaseToken, disposeToken, optionsToken],
+    provide: DrizzleDatabase,
+    useFactory: (database, dispose, databaseOptions) => DrizzleDatabase.createFacade(database, dispose, databaseOptions)
+  }, {
+    provide: handleProviderToken,
+    useExisting: DrizzleDatabase
+  }, DrizzleTransactionInterceptor] : [{
+    inject: withRegistrationGuard([databaseToken, disposeToken, optionsToken]),
+    provide: handleProviderToken,
+    useFactory: (...dependencies) => {
+      const [database, dispose, databaseOptions] = dependencies.slice(-3);
+      return DrizzleDatabase.createFacade(database, dispose, databaseOptions);
+    }
+  }])];
+}

package/dist/tokens.d.ts

@@ -1,3 +1,4 @@
+import type { Token } from '@fluojs/core';
 /** Dependency-injection token for the raw Drizzle database handle. */
 export declare const DRIZZLE_DATABASE: unique symbol;
 /** Dependency-injection token for the lifecycle-aware Drizzle database wrapper. */
@@ -6,4 +7,32 @@ export declare const DRIZZLE_HANDLE_PROVIDER: unique symbol;
 export declare const DRIZZLE_DISPOSE: unique symbol;
 /** Dependency-injection token for normalized Drizzle runtime options. */
 export declare const DRIZZLE_OPTIONS: unique symbol;
+/**
+ * Returns the DI token for the raw Drizzle database bound to a registration name.
+ *
+ * @param name Optional registration name. Omit it to target the default unnamed Drizzle registration.
+ * @returns The token that resolves the matching raw Drizzle database handle.
+ */
+export declare function getDrizzleDatabaseToken(name?: string): Token;
+/**
+ * Returns the DI token for the optional Drizzle disposal hook bound to a registration name.
+ *
+ * @param name Optional registration name. Omit it to target the default unnamed Drizzle registration.
+ * @returns The token that resolves the matching optional disposal hook.
+ */
+export declare function getDrizzleDisposeToken(name?: string): Token;
+/**
+ * Returns the DI token for the lifecycle-aware Drizzle handle bound to a registration name.
+ *
+ * @param name Optional registration name. Omit it to target the default unnamed Drizzle registration.
+ * @returns The token that resolves the matching lifecycle-aware Drizzle handle.
+ */
+export declare function getDrizzleHandleProviderToken(name?: string): Token;
+/**
+ * Returns the DI token for normalized Drizzle runtime options bound to a registration name.
+ *
+ * @param name Optional registration name. Omit it to target the default unnamed Drizzle registration.
+ * @returns The token that resolves the matching normalized runtime options.
+ */
+export declare function getDrizzleOptionsToken(name?: string): Token;
 //# sourceMappingURL=tokens.d.ts.map

package/dist/tokens.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,eAAsC,CAAC;AACpE,mFAAmF;AACnF,eAAO,MAAM,uBAAuB,eAA6C,CAAC;AAClF,iFAAiF;AACjF,eAAO,MAAM,eAAe,eAAqC,CAAC;AAClE,yEAAyE;AACzE,eAAO,MAAM,eAAe,eAAqC,CAAC"}
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAI1C,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,eAAsC,CAAC;AACpE,mFAAmF;AACnF,eAAO,MAAM,uBAAuB,eAA6C,CAAC;AAClF,iFAAiF;AACjF,eAAO,MAAM,eAAe,eAAqC,CAAC;AAClE,yEAAyE;AACzE,eAAO,MAAM,eAAe,eAAqC,CAAC;AAElE;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAM5D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAM3D;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAMlE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAM3D"}

package/dist/tokens.js

@@ -1,3 +1,5 @@
+import { normalizeDrizzleRegistrationName } from './registration-name.js';
+
 /** Dependency-injection token for the raw Drizzle database handle. */
 export const DRIZZLE_DATABASE = Symbol.for('fluo.drizzle.database');
 /** Dependency-injection token for the lifecycle-aware Drizzle database wrapper. */
@@ -5,4 +7,48 @@ export const DRIZZLE_HANDLE_PROVIDER = Symbol.for('fluo.drizzle.handle-provider'
 /** Dependency-injection token for the optional Drizzle shutdown dispose hook. */
 export const DRIZZLE_DISPOSE = Symbol.for('fluo.drizzle.dispose');
 /** Dependency-injection token for normalized Drizzle runtime options. */
-export const DRIZZLE_OPTIONS = Symbol.for('fluo.drizzle.options');
+export const DRIZZLE_OPTIONS = Symbol.for('fluo.drizzle.options');
+
+/**
+ * Returns the DI token for the raw Drizzle database bound to a registration name.
+ *
+ * @param name Optional registration name. Omit it to target the default unnamed Drizzle registration.
+ * @returns The token that resolves the matching raw Drizzle database handle.
+ */
+export function getDrizzleDatabaseToken(name) {
+  const normalizedName = normalizeDrizzleRegistrationName(name);
+  return normalizedName === undefined ? DRIZZLE_DATABASE : Symbol.for(`fluo.drizzle.database:${normalizedName}`);
+}
+
+/**
+ * Returns the DI token for the optional Drizzle disposal hook bound to a registration name.
+ *
+ * @param name Optional registration name. Omit it to target the default unnamed Drizzle registration.
+ * @returns The token that resolves the matching optional disposal hook.
+ */
+export function getDrizzleDisposeToken(name) {
+  const normalizedName = normalizeDrizzleRegistrationName(name);
+  return normalizedName === undefined ? DRIZZLE_DISPOSE : Symbol.for(`fluo.drizzle.dispose:${normalizedName}`);
+}
+
+/**
+ * Returns the DI token for the lifecycle-aware Drizzle handle bound to a registration name.
+ *
+ * @param name Optional registration name. Omit it to target the default unnamed Drizzle registration.
+ * @returns The token that resolves the matching lifecycle-aware Drizzle handle.
+ */
+export function getDrizzleHandleProviderToken(name) {
+  const normalizedName = normalizeDrizzleRegistrationName(name);
+  return normalizedName === undefined ? DRIZZLE_HANDLE_PROVIDER : Symbol.for(`fluo.drizzle.handle-provider:${normalizedName}`);
+}
+
+/**
+ * Returns the DI token for normalized Drizzle runtime options bound to a registration name.
+ *
+ * @param name Optional registration name. Omit it to target the default unnamed Drizzle registration.
+ * @returns The token that resolves the matching normalized runtime options.
+ */
+export function getDrizzleOptionsToken(name) {
+  const normalizedName = normalizeDrizzleRegistrationName(name);
+  return normalizedName === undefined ? DRIZZLE_OPTIONS : Symbol.for(`fluo.drizzle.options:${normalizedName}`);
+}

package/dist/transaction.d.ts

@@ -1,3 +1,6 @@
+import type { CallHandler, Interceptor, InterceptorContext } from '@fluojs/http';
+import { DrizzleDatabase } from './database.js';
+import type { DrizzleDatabaseLike } from './types.js';
 type TransactionCapableDrizzle<TTransactionOptions = unknown> = {
     transaction<T>(fn: () => Promise<T>, options?: TTransactionOptions): Promise<T>;
 };
@@ -7,14 +10,36 @@ type TransactionMethod<THost, TArgs extends unknown[], TResult> = (this: THost,
  * Standard TC39 method decorator that runs a service method inside a Drizzle transaction boundary.
  *
  * @remarks
- * `@Transaction()` uses `this.db` when present and otherwise treats the decorated instance itself as the
- * transaction-capable `DrizzleDatabase`. Pass an accessor such as `@Transaction((self) => self.analyticsDb)` to select
- * another Drizzle wrapper explicitly. Non-function factory input is forwarded as Drizzle transaction options.
+ * `@Transaction()` selects the first transaction-capable target by checking `this.db`, then direct host properties,
+ * then nested `.db` properties on those values. If none of those candidates exposes `transaction(...)`, the decorated
+ * instance itself is used as the transaction target. Pass an accessor such as `@Transaction((self) => self.analyticsDb)`
+ * to select another Drizzle wrapper explicitly. Non-function factory input is forwarded as Drizzle transaction options.
  *
  * @param accessorOrOptions Optional target accessor, or Drizzle transaction options.
  * @param options Optional Drizzle transaction options when an accessor is supplied.
  * @returns A standard 2023-11 method decorator.
  */
 export declare function Transaction<THost, TTransactionOptions = unknown>(accessorOrOptions?: TransactionAccessor<THost, TTransactionOptions> | TTransactionOptions, options?: TTransactionOptions): <TArgs extends unknown[], TResult>(value: TransactionMethod<THost, TArgs, TResult>, context: ClassMethodDecoratorContext<THost, TransactionMethod<THost, TArgs, TResult>>) => TransactionMethod<THost, TArgs, TResult>;
+/**
+ * Compatibility HTTP interceptor that opens a Drizzle request transaction around a routed handler.
+ *
+ * @remarks
+ * This deprecated 1.x bridge forwards the request `AbortSignal` to `DrizzleDatabase.requestTransaction(...)`.
+ * Prefer service-layer `@Transaction()` or an explicit request boundary for new code.
+ *
+ * @deprecated Prefer service-layer `@Transaction()` or explicit `DrizzleDatabase.requestTransaction(...)`.
+ */
+export declare class DrizzleTransactionInterceptor implements Interceptor {
+    private readonly database;
+    constructor(database: DrizzleDatabase<DrizzleDatabaseLike<unknown, unknown>, unknown, unknown>);
+    /**
+     * Runs the downstream handler inside the compatibility request transaction.
+     *
+     * @param context Interceptor context containing the request cancellation signal.
+     * @param next Downstream handler chain.
+     * @returns The downstream result after the request transaction settles.
+     */
+    intercept(context: InterceptorContext, next: CallHandler): Promise<unknown>;
+}
 export {};
 //# sourceMappingURL=transaction.d.ts.map

package/dist/transaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../src/transaction.ts"],"names":[],"mappings":"AAAA,KAAK,yBAAyB,CAAC,mBAAmB,GAAG,OAAO,IAAI;IAC9D,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACjF,CAAC;AAEF,KAAK,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,IAAI,CACrD,IAAI,EAAE,KAAK,KACR,yBAAyB,CAAC,mBAAmB,CAAC,CAAC;AAEpD,KAAK,iBAAiB,CAAC,KAAK,EAAE,KAAK,SAAS,OAAO,EAAE,EAAE,OAAO,IAAI,CAChE,IAAI,EAAE,KAAK,EACX,GAAG,IAAI,EAAE,KAAK,KACX,OAAO,CAAC,OAAO,CAAC,CAAC;AAwCtB;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,EAC9D,iBAAiB,CAAC,EAAE,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,CAAC,GAAG,mBAAmB,EACzF,OAAO,CAAC,EAAE,mBAAmB,IAOZ,KAAK,SAAS,OAAO,EAAE,EAAE,OAAO,EAC/C,OAAO,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAC/C,SAAS,2BAA2B,CAAC,KAAK,EAAE,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,KACpF,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAc5C"}
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../src/transaction.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEjF,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,KAAK,yBAAyB,CAAC,mBAAmB,GAAG,OAAO,IAAI;IAC9D,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACjF,CAAC;AAEF,KAAK,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,IAAI,CACrD,IAAI,EAAE,KAAK,KACR,yBAAyB,CAAC,mBAAmB,CAAC,CAAC;AAEpD,KAAK,iBAAiB,CAAC,KAAK,EAAE,KAAK,SAAS,OAAO,EAAE,EAAE,OAAO,IAAI,CAChE,IAAI,EAAE,KAAK,EACX,GAAG,IAAI,EAAE,KAAK,KACX,OAAO,CAAC,OAAO,CAAC,CAAC;AA0CtB;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,EAC9D,iBAAiB,CAAC,EAAE,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,CAAC,GAAG,mBAAmB,EACzF,OAAO,CAAC,EAAE,mBAAmB,IAOrB,KAAK,SAAS,OAAO,EAAE,EAAE,OAAO,EACtC,OAAO,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAC/C,SAAS,2BAA2B,CAAC,KAAK,EAAE,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,KACpF,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAc5C;AAED;;;;;;;;GAQG;AACH,qBACa,6BAA8B,YAAW,WAAW;IAE7D,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,eAAe,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC;IAGrG;;;;;;OAMG;IACG,SAAS,CAAC,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;CAGlF"}

package/dist/transaction.js

@@ -1,3 +1,11 @@
+let _initClass;
+function _applyDecs(e, t, n, r, o, i) { var a, c, u, s, f, l, p, d = Symbol.metadata || Symbol.for("Symbol.metadata"), m = Object.defineProperty, h = Object.create, y = [h(null), h(null)], v = t.length; function g(t, n, r) { return function (o, i) { n && (i = o, o = e); for (var a = 0; a < t.length; a++) i = t[a].apply(o, r ? [i] : []); return r ? i : o; }; } function b(e, t, n, r) { if ("function" != typeof e && (r || void 0 !== e)) throw new TypeError(t + " must " + (n || "be") + " a function" + (r ? "" : " or undefined")); return e; } function applyDec(e, t, n, r, o, i, u, s, f, l, p) { function d(e) { if (!p(e)) throw new TypeError("Attempted to access private element on non-instance"); } var h = [].concat(t[0]), v = t[3], w = !u, D = 1 === o, S = 3 === o, j = 4 === o, E = 2 === o; function I(t, n, r) { return function (o, i) { return n && (i = o, o = e), r && r(o), P[t].call(o, i); }; } if (!w) { var P = {}, k = [], F = S ? "get" : j || D ? "set" : "value"; if (f ? (l || D ? P = { get: _setFunctionName(function () { return v(this); }, r, "get"), set: function (e) { t[4](this, e); } } : P[F] = v, l || _setFunctionName(P[F], r, E ? "" : F)) : l || (P = Object.getOwnPropertyDescriptor(e, r)), !l && !f) { if ((c = y[+s][r]) && 7 !== (c ^ o)) throw Error("Decorating two elements with the same name (" + P[F].name + ") is not supported yet"); y[+s][r] = o < 3 ? 1 : o; } } for (var N = e, O = h.length - 1; O >= 0; O -= n ? 2 : 1) { var T = b(h[O], "A decorator", "be", !0), z = n ? h[O - 1] : void 0, A = {}, H = { kind: ["field", "accessor", "method", "getter", "setter", "class"][o], name: r, metadata: a, addInitializer: function (e, t) { if (e.v) throw new TypeError("attempted to call addInitializer after decoration was finished"); b(t, "An initializer", "be", !0), i.push(t); }.bind(null, A) }; if (w) c = T.call(z, N, H), A.v = 1, b(c, "class decorators", "return") && (N = c);else if (H.static = s, H.private = f, c = H.access = { has: f ? p.bind() : function (e) { return r in e; } }, j || (c.get = f ? E ? function (e) { return d(e), P.value; } : I("get", 0, d) : function (e) { return e[r]; }), E || S || (c.set = f ? I("set", 0, d) : function (e, t) { e[r] = t; }), N = T.call(z, D ? { get: P.get, set: P.set } : P[F], H), A.v = 1, D) { if ("object" == typeof N && N) (c = b(N.get, "accessor.get")) && (P.get = c), (c = b(N.set, "accessor.set")) && (P.set = c), (c = b(N.init, "accessor.init")) && k.unshift(c);else if (void 0 !== N) throw new TypeError("accessor decorators must return an object with get, set, or init properties or undefined"); } else b(N, (l ? "field" : "method") + " decorators", "return") && (l ? k.unshift(N) : P[F] = N); } return o < 2 && u.push(g(k, s, 1), g(i, s, 0)), l || w || (f ? D ? u.splice(-1, 0, I("get", s), I("set", s)) : u.push(E ? P[F] : b.call.bind(P[F])) : m(e, r, P)), N; } function w(e) { return m(e, d, { configurable: !0, enumerable: !0, value: a }); } return void 0 !== i && (a = i[d]), a = h(null == a ? null : a), f = [], l = function (e) { e && f.push(g(e)); }, p = function (t, r) { for (var i = 0; i < n.length; i++) { var a = n[i], c = a[1], l = 7 & c; if ((8 & c) == t && !l == r) { var p = a[2], d = !!a[3], m = 16 & c; applyDec(t ? e : e.prototype, a, m, d ? "#" + p : _toPropertyKey(p), l, l < 2 ? [] : t ? s = s || [] : u = u || [], f, !!t, d, r, t && d ? function (t) { return _checkInRHS(t) === e; } : o); } } }, p(8, 0), p(0, 0), p(8, 1), p(0, 1), l(u), l(s), c = f, v || w(e), { e: c, get c() { var n = []; return v && [w(e = applyDec(e, [t], r, e.name, 5, n)), g(n, 1)]; } }; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _setFunctionName(e, t, n) { "symbol" == typeof t && (t = (t = t.description) ? "[" + t + "]" : ""); try { Object.defineProperty(e, "name", { configurable: !0, value: n ? n + " " + t : t }); } catch (e) {} return e; }
+function _checkInRHS(e) { if (Object(e) !== e) throw TypeError("right-hand side of 'in' should be an object, got " + (null !== e ? typeof e : "null")); return e; }
+import { Inject } from '@fluojs/core';
+import { DrizzleDatabase } from './database.js';
 function isTransactionCapableDrizzle(value) {
   return typeof value?.transaction === 'function';
 }
@@ -13,6 +21,8 @@ function findNestedTransactionTarget(value) {
     if (isTransactionCapableDrizzle(propertyValue)) {
       return propertyValue;
     }
+  }
+  for (const propertyValue of Object.values(value)) {
     const nestedDatabase = propertyValue?.db;
     if (isTransactionCapableDrizzle(nestedDatabase)) {
       return nestedDatabase;
@@ -29,9 +39,10 @@ function resolveDefaultTransactionTarget(self) {
  * Standard TC39 method decorator that runs a service method inside a Drizzle transaction boundary.
  *
  * @remarks
- * `@Transaction()` uses `this.db` when present and otherwise treats the decorated instance itself as the
- * transaction-capable `DrizzleDatabase`. Pass an accessor such as `@Transaction((self) => self.analyticsDb)` to select
- * another Drizzle wrapper explicitly. Non-function factory input is forwarded as Drizzle transaction options.
+ * `@Transaction()` selects the first transaction-capable target by checking `this.db`, then direct host properties,
+ * then nested `.db` properties on those values. If none of those candidates exposes `transaction(...)`, the decorated
+ * instance itself is used as the transaction target. Pass an accessor such as `@Transaction((self) => self.analyticsDb)`
+ * to select another Drizzle wrapper explicitly. Non-function factory input is forwarded as Drizzle transaction options.
  *
  * @param accessorOrOptions Optional target accessor, or Drizzle transaction options.
  * @param options Optional Drizzle transaction options when an accessor is supplied.
@@ -40,7 +51,7 @@ function resolveDefaultTransactionTarget(self) {
 export function Transaction(accessorOrOptions, options) {
   const accessor = typeof accessorOrOptions === 'function' ? accessorOrOptions : undefined;
   const transactionOptions = accessor ? options : accessorOrOptions;
-  return function (value, context) {
+  return (value, context) => {
     if (context.kind !== 'method') {
       throw new Error('@Transaction() can only decorate methods.');
     }
@@ -49,4 +60,38 @@ export function Transaction(accessorOrOptions, options) {
       return drizzleDatabase.transaction(() => value.apply(this, args), transactionOptions);
     };
   };
-}
+}
+
+/**
+ * Compatibility HTTP interceptor that opens a Drizzle request transaction around a routed handler.
+ *
+ * @remarks
+ * This deprecated 1.x bridge forwards the request `AbortSignal` to `DrizzleDatabase.requestTransaction(...)`.
+ * Prefer service-layer `@Transaction()` or an explicit request boundary for new code.
+ *
+ * @deprecated Prefer service-layer `@Transaction()` or explicit `DrizzleDatabase.requestTransaction(...)`.
+ */
+let _DrizzleTransactionIn;
+class DrizzleTransactionInterceptor {
+  static {
+    [_DrizzleTransactionIn, _initClass] = _applyDecs(this, [Inject(DrizzleDatabase)], []).c;
+  }
+  constructor(database) {
+    this.database = database;
+  }
+
+  /**
+   * Runs the downstream handler inside the compatibility request transaction.
+   *
+   * @param context Interceptor context containing the request cancellation signal.
+   * @param next Downstream handler chain.
+   * @returns The downstream result after the request transaction settles.
+   */
+  async intercept(context, next) {
+    return this.database.requestTransaction(() => next.handle(), context.requestContext.request.signal);
+  }
+  static {
+    _initClass();
+  }
+}
+export { _DrizzleTransactionIn as DrizzleTransactionInterceptor };

package/dist/types.d.ts

@@ -1,4 +1,5 @@
 import type { MaybePromise } from '@fluojs/core';
+import type { PersistencePlatformStatusSnapshot } from '@fluojs/runtime';
 type DrizzleTransactionCallback<TTransactionDatabase, TResult> = (database: TTransactionDatabase) => Promise<TResult>;
 type DrizzleTransactionRunner<TTransactionDatabase, TTransactionOptions> = <T>(callback: DrizzleTransactionCallback<TTransactionDatabase, T>, options?: TTransactionOptions) => Promise<T>;
 /**
@@ -24,6 +25,14 @@ export interface DrizzleModuleOptions<TDatabase extends DrizzleDatabaseLike<TTra
     dispose?: (database: TDatabase) => MaybePromise<void>;
     /** Whether Drizzle providers should be visible globally. Defaults to `false`. */
     global?: boolean;
+    /**
+     * Optional identity for an additional Drizzle registration.
+     *
+     * @remarks
+     * Named registrations are non-global. Consumers must import a module that exports the matching token;
+     * names do not create isolated runtime containers.
+     */
+    name?: string;
     /**
      * Throws when transaction helpers are used against a database that does not expose `transaction(...)`.
      *
@@ -40,6 +49,8 @@ export interface DrizzleModuleOptions<TDatabase extends DrizzleDatabaseLike<TTra
  * @typeParam TTransactionOptions Options forwarded to `database.transaction(...)`.
  */
 export interface DrizzleHandleProvider<TDatabase extends DrizzleDatabaseLike<TTransactionDatabase, TTransactionOptions>, TTransactionDatabase = TDatabase, TTransactionOptions = unknown> {
+    /** Produces the platform diagnostics snapshot for health and readiness integrations. */
+    createPlatformStatusSnapshot(): PersistencePlatformStatusSnapshot;
     /** Returns the ambient transaction database when present, or the root Drizzle handle otherwise. */
     current(): TDatabase | TTransactionDatabase;
     /**

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,KAAK,0BAA0B,CAAC,oBAAoB,EAAE,OAAO,IAAI,CAAC,QAAQ,EAAE,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtH,KAAK,wBAAwB,CAAC,oBAAoB,EAAE,mBAAmB,IAAI,CAAC,CAAC,EAC3E,QAAQ,EAAE,0BAA0B,CAAC,oBAAoB,EAAE,CAAC,CAAC,EAC7D,OAAO,CAAC,EAAE,mBAAmB,KAC1B,OAAO,CAAC,CAAC,CAAC,CAAC;AAEhB;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB,CAAC,oBAAoB,GAAG,OAAO,EAAE,mBAAmB,GAAG,OAAO;IAChG,WAAW,CAAC,EAAE,wBAAwB,CAAC,oBAAoB,EAAE,mBAAmB,CAAC,CAAC;CACnF;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB,CAAC,SAAS,SAAS,mBAAmB,CAAC,oBAAoB,EAAE,mBAAmB,CAAC,EAAE,oBAAoB,GAAG,SAAS,EAAE,mBAAmB,GAAG,OAAO;IACrL,8EAA8E;IAC9E,QAAQ,EAAE,SAAS,CAAC;IACpB,kGAAkG;IAClG,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,YAAY,CAAC,IAAI,CAAC,CAAC;IACtD,iFAAiF;IACjF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB,CAAC,SAAS,SAAS,mBAAmB,CAAC,oBAAoB,EAAE,mBAAmB,CAAC,EAAE,oBAAoB,GAAG,SAAS,EAAE,mBAAmB,GAAG,OAAO;IACtL,mGAAmG;IACnG,OAAO,IAAI,SAAS,GAAG,oBAAoB,CAAC;IAC5C;;;;;;;OAOG;IACH,kBAAkB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7G;;;;;;OAMG;IACH,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACjF"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,iBAAiB,CAAC;AAEzE,KAAK,0BAA0B,CAAC,oBAAoB,EAAE,OAAO,IAAI,CAAC,QAAQ,EAAE,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtH,KAAK,wBAAwB,CAAC,oBAAoB,EAAE,mBAAmB,IAAI,CAAC,CAAC,EAC3E,QAAQ,EAAE,0BAA0B,CAAC,oBAAoB,EAAE,CAAC,CAAC,EAC7D,OAAO,CAAC,EAAE,mBAAmB,KAC1B,OAAO,CAAC,CAAC,CAAC,CAAC;AAEhB;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB,CAAC,oBAAoB,GAAG,OAAO,EAAE,mBAAmB,GAAG,OAAO;IAChG,WAAW,CAAC,EAAE,wBAAwB,CAAC,oBAAoB,EAAE,mBAAmB,CAAC,CAAC;CACnF;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB,CAAC,SAAS,SAAS,mBAAmB,CAAC,oBAAoB,EAAE,mBAAmB,CAAC,EAAE,oBAAoB,GAAG,SAAS,EAAE,mBAAmB,GAAG,OAAO;IACrL,8EAA8E;IAC9E,QAAQ,EAAE,SAAS,CAAC;IACpB,kGAAkG;IAClG,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,YAAY,CAAC,IAAI,CAAC,CAAC;IACtD,iFAAiF;IACjF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB,CAAC,SAAS,SAAS,mBAAmB,CAAC,oBAAoB,EAAE,mBAAmB,CAAC,EAAE,oBAAoB,GAAG,SAAS,EAAE,mBAAmB,GAAG,OAAO;IACtL,wFAAwF;IACxF,4BAA4B,IAAI,iCAAiC,CAAC;IAClE,mGAAmG;IACnG,OAAO,IAAI,SAAS,GAAG,oBAAoB,CAAC;IAC5C;;;;;;;OAOG;IACH,kBAAkB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7G;;;;;;OAMG;IACH,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACjF"}

package/package.json

@@ -9,7 +9,7 @@
     "transaction",
     "als"
   ],
-  "version": "1.1.0",
+  "version": "2.0.0",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -18,7 +18,7 @@
     "directory": "packages/drizzle"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=24.0.0 <27"
   },
   "publishConfig": {
     "access": "public"
@@ -36,12 +36,13 @@
     "dist"
   ],
   "dependencies": {
-    "@fluojs/core": "^1.0.3",
-    "@fluojs/di": "^1.1.0",
-    "@fluojs/runtime": "^1.1.8"
+    "@fluojs/core": "^2.0.0",
+    "@fluojs/di": "^3.0.0",
+    "@fluojs/http": "^3.0.0",
+    "@fluojs/runtime": "^3.0.0"
   },
   "peerDependencies": {
-    "drizzle-orm": ">=0.30.0"
+    "drizzle-orm": ">=0.45.2"
   },
   "peerDependenciesMeta": {
     "drizzle-orm": {
@@ -49,8 +50,7 @@
     }
   },
   "devDependencies": {
-    "vitest": "^3.2.4",
-    "@fluojs/http": "^1.1.2"
+    "vitest": "^4.1.11"
   },
   "scripts": {
     "prebuild": "node ../../tooling/scripts/clean-dist.mjs",