@fluojs/prisma 1.0.0-beta.1 → 1.0.0-beta.2

package/README.ko.md

@@ -11,8 +11,10 @@ fluo 애플리케이션을 위한 Prisma 라이프사이클 및 ALS 기반 트
 - [빠른 시작](#빠른-시작)
 - [공통 패턴](#공통-패턴)
   - [PrismaService와 current()](#prismaservice와-current)
+  - [여러 클라이언트를 위한 이름 있는 등록](#여러-클라이언트를-위한-이름-있는-등록)
   - [수동 트랜잭션](#수동-트랜잭션)
   - [자동 요청 트랜잭션](#자동-요청-트랜잭션)
+  - [비동기 설정과 격리](#비동기-설정과-격리)
   - [수동 모듈 조합](#수동-모듈-조합)
 - [공개 API 개요](#공개-api-개요)
 - [관련 패키지](#관련-패키지)
@@ -73,6 +75,34 @@ export class UserRepository {
 }
 ```
 
+### 여러 클라이언트를 위한 이름 있는 등록
+
+하나의 애플리케이션 컨테이너 안에서 여러 Prisma Client가 필요하다면 각 등록에 명시적인 `name`을 부여하고 `getPrismaServiceToken(name)`으로 대응되는 토큰을 주입하세요.
+
+```typescript
+import { Inject } from '@fluojs/core';
+import { PrismaModule, PrismaService, getPrismaServiceToken } from '@fluojs/prisma';
+
+const usersPrismaModule = PrismaModule.forName('users', { client: usersPrisma });
+const analyticsPrismaModule = PrismaModule.forRoot({ name: 'analytics', client: analyticsPrisma });
+
+@Inject(getPrismaServiceToken('users'), getPrismaServiceToken('analytics'))
+export class MultiDatabaseService {
+  constructor(
+    private readonly users: PrismaService<typeof usersPrisma>,
+    private readonly analytics: PrismaService<typeof analyticsPrisma>,
+  ) {}
+
+  async loadDashboard(userId: string) {
+    const user = await this.users.current().user.findUnique({ where: { id: userId } });
+    const summary = await this.analytics.current().report.findMany();
+    return { summary, user };
+  }
+}
+```
+
+이름 없는 등록은 `PrismaService`, `PRISMA_CLIENT`, `PRISMA_OPTIONS`, `PrismaTransactionInterceptor`를 위한 기본 단일 클라이언트 경로로 유지됩니다. 같은 컨테이너에 여러 Prisma Client를 등록할 때는 토큰 해석이 명시적으로 유지되도록 추가 클라이언트마다 이름을 사용하세요.
+
 ### 수동 트랜잭션
 
 `prisma.transaction()`을 사용하여 대화형 트랜잭션 블록을 생성합니다. 블록 내부의 모든 `current()` 호출은 트랜잭션 범위의 클라이언트를 사용합니다.
@@ -101,6 +131,27 @@ class UserController {
 }
 ```
 
+`PrismaTransactionInterceptor`는 기본 이름 없는 `PrismaService`를 대상으로 합니다. 이름 있는 다중 클라이언트 등록에서는 해당 이름의 `PrismaService`를 주입한 뒤 필요한 위치에서 명시적으로 `transaction()` / `requestTransaction()` 경계를 여세요.
+
+### 비동기 설정과 격리
+
+주입된 설정이나 다른 비동기 소스에서 Prisma 클라이언트를 만들어야 할 때는 `PrismaModule.forRootAsync(...)`를 사용하세요. 비동기 factory는 애플리케이션 컨테이너마다 한 번 resolve되며, 테스트나 여러 앱을 띄우는 프로세스에서 같은 모듈 정의를 재사용하더라도 별도 bootstrap 사이에서 공유되지 않습니다.
+
+```typescript
+import { PrismaClient } from '@prisma/client';
+import { PrismaModule } from '@fluojs/prisma';
+
+PrismaModule.forRootAsync({
+  inject: [DatabaseConfig],
+  useFactory: (config: DatabaseConfig) => ({
+    client: new PrismaClient({ datasources: { db: { url: config.url } } }),
+    strictTransactions: true,
+  }),
+});
+```
+
+하나의 컴파일된 애플리케이션 안에서는 하위 provider가 동일하게 resolve된 `PrismaService`, ALS 트랜잭션 컨텍스트, 라이프사이클 관리 대상 클라이언트를 공유합니다. 서로 다른 애플리케이션 컨테이너는 독립된 factory 결과를 받으므로 `$connect` / `$disconnect` 소유권과 요청 트랜잭션 상태가 격리됩니다.
+
 ### 수동 모듈 조합
 
 `PrismaModule.forRoot(...)` / `forRootAsync(...)`를 사용해 Prisma를 등록합니다. 커스텀 `defineModule(...)` 등록 안에서 Prisma 지원을 조합해야 할 때도 동일한 모듈 entrypoint를 import해서 사용하세요.
@@ -125,7 +176,10 @@ defineModule(ManualPrismaModule, {
 ### `PrismaModule`
 
 - `PrismaModule.forRoot(options)` / `PrismaModule.forRootAsync(options)`
+- `PrismaModule.forName(name, options)` / `PrismaModule.forNameAsync(name, options)`
+- `forRoot(...)`와 `forRootAsync(...)`도 이름 있는/scoped 등록을 위해 `name`을 받을 수 있습니다.
 - `forRootAsync(...)`는 `AsyncModuleOptions<PrismaModuleOptions<...>>`를 받습니다.
+- `forRootAsync(...)`는 애플리케이션 컨테이너마다 옵션을 한 번 resolve하여, 별도 bootstrap 사이에서 클라이언트 라이프사이클과 요청 트랜잭션 격리를 보존합니다.
 - `strictTransactions: true` 설정 시 트랜잭션 미지원 환경에서 즉시 예외를 발생시킵니다.
 
 ### `PrismaService<TClient>`
@@ -141,6 +195,14 @@ defineModule(ManualPrismaModule, {
 
 원시 `PrismaClient` 인스턴스를 위한 주입 토큰입니다.
 
+### 이름 있는 Prisma 토큰 헬퍼
+
+- `getPrismaClientToken(name?)`
+- `getPrismaOptionsToken(name?)`
+- `getPrismaServiceToken(name?)`
+
+이 헬퍼들은 `name`이 없으면 기본 이름 없는 토큰을 반환하고, `name`이 있으면 해당 등록 전용 토큰을 반환합니다.
+
 ### 관련 export 타입
 
 - `PrismaModuleOptions`

package/README.md

@@ -11,8 +11,10 @@ Prisma lifecycle and ALS-backed transaction context for fluo applications. Conne
 - [Quick Start](#quick-start)
 - [Common Patterns](#common-patterns)
   - [PrismaService and current()](#prismaservice-and-current)
+  - [Named Registrations for Multiple Clients](#named-registrations-for-multiple-clients)
   - [Manual Transactions](#manual-transactions)
   - [Automatic Request Transactions](#automatic-request-transactions)
+  - [Async Configuration and Isolation](#async-configuration-and-isolation)
   - [Manual Module Composition](#manual-module-composition)
 - [Public API Overview](#public-api-overview)
 - [Related Packages](#related-packages)
@@ -73,6 +75,34 @@ export class UserRepository {
 }
 ```
 
+### Named Registrations for Multiple Clients
+
+When one application container needs more than one Prisma client, register each client with an explicit `name` and inject the matching token with `getPrismaServiceToken(name)`.
+
+```typescript
+import { Inject } from '@fluojs/core';
+import { PrismaModule, PrismaService, getPrismaServiceToken } from '@fluojs/prisma';
+
+const usersPrismaModule = PrismaModule.forName('users', { client: usersPrisma });
+const analyticsPrismaModule = PrismaModule.forRoot({ name: 'analytics', client: analyticsPrisma });
+
+@Inject(getPrismaServiceToken('users'), getPrismaServiceToken('analytics'))
+export class MultiDatabaseService {
+  constructor(
+    private readonly users: PrismaService<typeof usersPrisma>,
+    private readonly analytics: PrismaService<typeof analyticsPrisma>,
+  ) {}
+
+  async loadDashboard(userId: string) {
+    const user = await this.users.current().user.findUnique({ where: { id: userId } });
+    const summary = await this.analytics.current().report.findMany();
+    return { summary, user };
+  }
+}
+```
+
+Unnamed registration remains the default single-client path for `PrismaService`, `PRISMA_CLIENT`, `PRISMA_OPTIONS`, and `PrismaTransactionInterceptor`. When you register multiple Prisma clients in the same container, use names for every additional client so token resolution stays explicit.
+
 ### Manual Transactions
 
 Use `prisma.transaction()` to create an interactive transaction block. Any calls to `current()` inside the block will use the transaction-scoped client.
@@ -101,6 +131,27 @@ class UserController {
 }
 ```
 
+`PrismaTransactionInterceptor` targets the default unnamed `PrismaService`. For named multi-client registrations, inject the corresponding named `PrismaService` and open explicit `transaction()` / `requestTransaction()` boundaries where needed.
+
+### Async Configuration and Isolation
+
+Use `PrismaModule.forRootAsync(...)` when the Prisma client must be created from injected configuration or another async source. The async factory is resolved once per application container and is not shared across separate bootstraps, even when the same module definition is reused in tests or multi-app processes.
+
+```typescript
+import { PrismaClient } from '@prisma/client';
+import { PrismaModule } from '@fluojs/prisma';
+
+PrismaModule.forRootAsync({
+  inject: [DatabaseConfig],
+  useFactory: (config: DatabaseConfig) => ({
+    client: new PrismaClient({ datasources: { db: { url: config.url } } }),
+    strictTransactions: true,
+  }),
+});
+```
+
+Within one compiled application, downstream providers share the same resolved `PrismaService`, ALS transaction context, and lifecycle-managed client. Separate application containers receive independent factory results, so `$connect` / `$disconnect` ownership and request transaction state remain isolated.
+
 ### Manual Module Composition
 
 Use `PrismaModule.forRoot(...)` / `forRootAsync(...)` to register Prisma. When you need to compose Prisma support inside a custom `defineModule(...)` registration, import the module entrypoint there as well.
@@ -125,7 +176,10 @@ defineModule(ManualPrismaModule, {
 ### `PrismaModule`
 
 - `PrismaModule.forRoot(options)` / `PrismaModule.forRootAsync(options)`
+- `PrismaModule.forName(name, options)` / `PrismaModule.forNameAsync(name, options)`
+- `forRoot(...)` and `forRootAsync(...)` also accept `name` for named/scoped registrations.
 - `forRootAsync(...)` accepts `AsyncModuleOptions<PrismaModuleOptions<...>>`.
+- `forRootAsync(...)` resolves options once per application container, preserving client lifecycle and request transaction isolation across separate bootstraps.
 - Supports `strictTransactions: true` to throw if transaction support is missing.
 
 ### `PrismaService<TClient>`
@@ -141,6 +195,14 @@ defineModule(ManualPrismaModule, {
 
 Injectable token for the raw `PrismaClient` instance.
 
+### Named Prisma token helpers
+
+- `getPrismaClientToken(name?)`
+- `getPrismaOptionsToken(name?)`
+- `getPrismaServiceToken(name?)`
+
+These helpers return the default unnamed token when `name` is omitted and a registration-specific token when `name` is provided.
+
 ### Related exported types
 
 - `PrismaModuleOptions`

package/dist/module.d.ts

@@ -1,10 +1,18 @@
-import type { AsyncModuleOptions } from '@fluojs/core';
+import { type AsyncModuleOptions } from '@fluojs/core';
 import { type ModuleType } from '@fluojs/runtime';
 import type { InferPrismaTransactionClient, InferPrismaTransactionOptions, PrismaClientLike, PrismaModuleOptions } from './types.js';
 /**
  * Runtime module entrypoint for Prisma lifecycle and transaction wiring.
  */
 export declare class PrismaModule {
+    /**
+     * Registers Prisma providers from static options under an explicit name.
+     *
+     * @param name Registration name used to generate isolated Prisma DI tokens.
+     * @param options Prisma module options with client handle and strict transaction mode.
+     * @returns A module definition that exports the named Prisma tokens.
+     */
+    static forName<TClient extends PrismaClientLike<TTransactionClient, TTransactionOptions>, TTransactionClient = InferPrismaTransactionClient<TClient>, TTransactionOptions = InferPrismaTransactionOptions<TClient>>(name: string, options: Omit<PrismaModuleOptions<TClient, TTransactionClient, TTransactionOptions>, 'name'>): ModuleType;
     /**
      * Registers Prisma providers from static options.
      *
@@ -12,12 +20,22 @@ export declare class PrismaModule {
      * @returns A module definition that exports `PrismaService` and `PrismaTransactionInterceptor`.
      */
     static forRoot<TClient extends PrismaClientLike<TTransactionClient, TTransactionOptions>, TTransactionClient = InferPrismaTransactionClient<TClient>, TTransactionOptions = InferPrismaTransactionOptions<TClient>>(options: PrismaModuleOptions<TClient, TTransactionClient, TTransactionOptions>): ModuleType;
+    /**
+     * Registers Prisma providers from an async DI factory under an explicit name.
+     *
+     * @param name Registration name used to generate isolated Prisma DI tokens.
+     * @param options Async module options that resolve Prisma client/module configuration.
+     * @returns A module definition that resolves async options once per application container.
+     */
+    static forNameAsync<TClient extends PrismaClientLike<TTransactionClient, TTransactionOptions>, TTransactionClient = InferPrismaTransactionClient<TClient>, TTransactionOptions = InferPrismaTransactionOptions<TClient>>(name: string, options: AsyncModuleOptions<Omit<PrismaModuleOptions<TClient, TTransactionClient, TTransactionOptions>, 'name'>>): ModuleType;
     /**
      * Registers Prisma providers from an async DI factory.
      *
      * @param options Async module options that resolve Prisma client/module configuration.
-     * @returns A module definition that memoizes async options resolution per module instance.
+     * @returns A module definition that resolves async options once per application container.
      */
-    static forRootAsync<TClient extends PrismaClientLike<TTransactionClient, TTransactionOptions>, TTransactionClient = InferPrismaTransactionClient<TClient>, TTransactionOptions = InferPrismaTransactionOptions<TClient>>(options: AsyncModuleOptions<PrismaModuleOptions<TClient, TTransactionClient, TTransactionOptions>>): ModuleType;
+    static forRootAsync<TClient extends PrismaClientLike<TTransactionClient, TTransactionOptions>, TTransactionClient = InferPrismaTransactionClient<TClient>, TTransactionOptions = InferPrismaTransactionOptions<TClient>>(options: AsyncModuleOptions<PrismaModuleOptions<TClient, TTransactionClient, TTransactionOptions>> & {
+        name?: string;
+    }): ModuleType;
 }
 //# sourceMappingURL=module.d.ts.map

package/dist/module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAgB,MAAM,cAAc,CAAC;AAErE,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAKhE,OAAO,KAAK,EACV,4BAA4B,EAC5B,6BAA6B,EAC7B,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AA6GpB;;GAEG;AACH,qBAAa,YAAY;IACvB;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CACZ,OAAO,SAAS,gBAAgB,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,EACzE,kBAAkB,GAAG,4BAA4B,CAAC,OAAO,CAAC,EAC1D,mBAAmB,GAAG,6BAA6B,CAAC,OAAO,CAAC,EAE5D,OAAO,EAAE,mBAAmB,CAAC,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,CAAC,GAC7E,UAAU;IAIb;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CACjB,OAAO,SAAS,gBAAgB,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,EACzE,kBAAkB,GAAG,4BAA4B,CAAC,OAAO,CAAC,EAC1D,mBAAmB,GAAG,6BAA6B,CAAC,OAAO,CAAC,EAE5D,OAAO,EAAE,kBAAkB,CAAC,mBAAmB,CAAC,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,CAAC,CAAC,GACjG,UAAU;CAGd"}
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,kBAAkB,EAAc,MAAM,cAAc,CAAC;AAE3E,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAShE,OAAO,KAAK,EACV,4BAA4B,EAC5B,6BAA6B,EAC7B,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AA4KpB;;GAEG;AACH,qBAAa,YAAY;IACvB;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CACZ,OAAO,SAAS,gBAAgB,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,EACzE,kBAAkB,GAAG,4BAA4B,CAAC,OAAO,CAAC,EAC1D,mBAAmB,GAAG,6BAA6B,CAAC,OAAO,CAAC,EAE5D,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,CAAC,EAAE,MAAM,CAAC,GAC3F,UAAU;IAOb;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CACZ,OAAO,SAAS,gBAAgB,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,EACzE,kBAAkB,GAAG,4BAA4B,CAAC,OAAO,CAAC,EAC1D,mBAAmB,GAAG,6BAA6B,CAAC,OAAO,CAAC,EAE5D,OAAO,EAAE,mBAAmB,CAAC,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,CAAC,GAC7E,UAAU;IAIb;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CACjB,OAAO,SAAS,gBAAgB,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,EACzE,kBAAkB,GAAG,4BAA4B,CAAC,OAAO,CAAC,EAC1D,mBAAmB,GAAG,6BAA6B,CAAC,OAAO,CAAC,EAE5D,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,kBAAkB,CAAC,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,CAAC,EAAE,MAAM,CAAC,CAAC,GAC/G,UAAU;IAOb;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CACjB,OAAO,SAAS,gBAAgB,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,EACzE,kBAAkB,GAAG,4BAA4B,CAAC,OAAO,CAAC,EAC1D,mBAAmB,GAAG,6BAA6B,CAAC,OAAO,CAAC,EAE5D,OAAO,EAAE,kBAAkB,CAAC,mBAAmB,CAAC,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,CAAC,CAAC,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GACrH,UAAU;CAGd"}

package/dist/module.js

@@ -1,57 +1,90 @@
+import { Inject } from '@fluojs/core';
 import { defineModule } from '@fluojs/runtime';
 import { PrismaService } from './service.js';
-import { PRISMA_CLIENT, PRISMA_OPTIONS } from './tokens.js';
+import { getPrismaClientToken, getPrismaOptionsToken, getPrismaServiceToken } from './tokens.js';
 import { PrismaTransactionInterceptor } from './transaction.js';
 const PRISMA_NORMALIZED_OPTIONS = Symbol('fluo.prisma.normalized-options');
-const PRISMA_MODULE_EXPORTS = [PrismaService, PrismaTransactionInterceptor];
+function normalizePrismaRegistrationName(name) {
+  if (name === undefined) {
+    return undefined;
+  }
+  const normalizedName = name.trim();
+  if (normalizedName.length === 0) {
+    throw new Error('PrismaModule name must be a non-empty string when provided.');
+  }
+  return normalizedName;
+}
+function getPrismaNormalizedOptionsToken(name) {
+  const normalizedName = normalizePrismaRegistrationName(name);
+  return normalizedName === undefined ? PRISMA_NORMALIZED_OPTIONS : Symbol.for(`fluo.prisma.normalized-options:${normalizedName}`);
+}
 function normalizePrismaModuleOptions(options) {
   return {
+    name: normalizePrismaRegistrationName(options.name),
     client: options.client,
     strictTransactions: options.strictTransactions ?? false
   };
 }
-function createPrismaRuntimeProviders(normalizedOptionsProvider) {
+function createNamedPrismaServiceProvider(name) {
+  const clientToken = getPrismaClientToken(name);
+  const optionsToken = getPrismaOptionsToken(name);
+  const serviceToken = getPrismaServiceToken(name);
+  class NamedPrismaService extends PrismaService {}
+  Inject(clientToken, optionsToken)(NamedPrismaService, {});
+  return [NamedPrismaService, {
+    provide: serviceToken,
+    useExisting: NamedPrismaService
+  }];
+}
+function createPrismaRuntimeProviders(normalizedOptionsProvider, name) {
+  const normalizedOptionsToken = getPrismaNormalizedOptionsToken(name);
+  const clientToken = getPrismaClientToken(name);
+  const optionsToken = getPrismaOptionsToken(name);
   return [normalizedOptionsProvider, {
-    inject: [PRISMA_NORMALIZED_OPTIONS],
-    provide: PRISMA_CLIENT,
+    inject: [normalizedOptionsToken],
+    provide: clientToken,
     useFactory: options => options.client
   }, {
-    inject: [PRISMA_NORMALIZED_OPTIONS],
-    provide: PRISMA_OPTIONS,
+    inject: [normalizedOptionsToken],
+    provide: optionsToken,
     useFactory: options => ({
       strictTransactions: options.strictTransactions
     })
-  }, PrismaService, PrismaTransactionInterceptor];
+  }, ...(name === undefined ? [PrismaService, {
+    provide: getPrismaServiceToken(),
+    useExisting: PrismaService
+  }, PrismaTransactionInterceptor] : createNamedPrismaServiceProvider(name))];
 }
 function buildPrismaModule(options) {
   class PrismaRootModuleDefinition {}
+  const normalizedOptions = normalizePrismaModuleOptions(options);
   return defineModule(PrismaRootModuleDefinition, {
-    exports: PRISMA_MODULE_EXPORTS,
+    exports: normalizedOptions.name === undefined ? [PrismaService, PrismaTransactionInterceptor, getPrismaServiceToken(), getPrismaClientToken(), getPrismaOptionsToken()] : [getPrismaServiceToken(normalizedOptions.name), getPrismaClientToken(normalizedOptions.name), getPrismaOptionsToken(normalizedOptions.name)],
     providers: createPrismaRuntimeProviders({
-      provide: PRISMA_NORMALIZED_OPTIONS,
-      useValue: normalizePrismaModuleOptions(options)
-    })
+      provide: getPrismaNormalizedOptionsToken(normalizedOptions.name),
+      useValue: normalizedOptions
+    }, normalizedOptions.name)
   });
 }
 function buildPrismaModuleAsync(options) {
   class PrismaAsyncModuleDefinition {}
   const factory = options.useFactory;
-  let cachedResult;
-  const memoizedFactory = (...deps) => {
-    if (!cachedResult) {
-      cachedResult = Promise.resolve(factory(...deps)).then(resolved => normalizePrismaModuleOptions(resolved));
-    }
-    return cachedResult;
-  };
+  const normalizedName = normalizePrismaRegistrationName(options.name);
   const normalizedOptionsProvider = {
     inject: options.inject,
-    provide: PRISMA_NORMALIZED_OPTIONS,
+    provide: getPrismaNormalizedOptionsToken(normalizedName),
     scope: 'singleton',
-    useFactory: (...deps) => memoizedFactory(...deps)
+    useFactory: async (...deps) => {
+      const resolvedOptions = await factory(...deps);
+      return normalizePrismaModuleOptions({
+        ...resolvedOptions,
+        name: resolvedOptions.name ?? normalizedName
+      });
+    }
   };
   return defineModule(PrismaAsyncModuleDefinition, {
-    exports: PRISMA_MODULE_EXPORTS,
-    providers: createPrismaRuntimeProviders(normalizedOptionsProvider)
+    exports: normalizedName === undefined ? [PrismaService, PrismaTransactionInterceptor, getPrismaServiceToken(), getPrismaClientToken(), getPrismaOptionsToken()] : [getPrismaServiceToken(normalizedName), getPrismaClientToken(normalizedName), getPrismaOptionsToken(normalizedName)],
+    providers: createPrismaRuntimeProviders(normalizedOptionsProvider, normalizedName)
   });
 }
 
@@ -59,6 +92,20 @@ function buildPrismaModuleAsync(options) {
  * Runtime module entrypoint for Prisma lifecycle and transaction wiring.
  */
 export class PrismaModule {
+  /**
+   * Registers Prisma providers from static options under an explicit name.
+   *
+   * @param name Registration name used to generate isolated Prisma DI tokens.
+   * @param options Prisma module options with client handle and strict transaction mode.
+   * @returns A module definition that exports the named Prisma tokens.
+   */
+  static forName(name, options) {
+    return buildPrismaModule({
+      ...options,
+      name
+    });
+  }
+
   /**
    * Registers Prisma providers from static options.
    *
@@ -69,11 +116,25 @@ export class PrismaModule {
     return buildPrismaModule(options);
   }
 
+  /**
+   * Registers Prisma providers from an async DI factory under an explicit name.
+   *
+   * @param name Registration name used to generate isolated Prisma DI tokens.
+   * @param options Async module options that resolve Prisma client/module configuration.
+   * @returns A module definition that resolves async options once per application container.
+   */
+  static forNameAsync(name, options) {
+    return buildPrismaModuleAsync({
+      ...options,
+      name
+    });
+  }
+
   /**
    * Registers Prisma providers from an async DI factory.
    *
    * @param options Async module options that resolve Prisma client/module configuration.
-   * @returns A module definition that memoizes async options resolution per module instance.
+   * @returns A module definition that resolves async options once per application container.
    */
   static forRootAsync(options) {
     return buildPrismaModuleAsync(options);

package/dist/status.d.ts

@@ -9,6 +9,12 @@ type PrismaPlatformStatusSnapshotInput = {
     supportsTransaction: boolean;
     transactionAbortSignalSupport: 'unknown' | 'supported' | 'unsupported';
 };
+/**
+ * Create prisma platform status snapshot.
+ *
+ * @param input The input.
+ * @returns The create prisma platform status snapshot result.
+ */
 export declare function createPrismaPlatformStatusSnapshot(input: PrismaPlatformStatusSnapshotInput): PersistencePlatformStatusSnapshot;
 export {};
 //# sourceMappingURL=status.d.ts.map

package/dist/status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iCAAiC,EAGlC,MAAM,iBAAiB,CAAC;AAEzB,KAAK,4BAA4B,GAAG,SAAS,GAAG,OAAO,GAAG,eAAe,GAAG,SAAS,CAAC;AAEtF,KAAK,iCAAiC,GAAG;IACvC,yBAAyB,EAAE,MAAM,CAAC;IAClC,cAAc,EAAE,4BAA4B,CAAC;IAC7C,kBAAkB,EAAE,OAAO,CAAC;IAC5B,eAAe,EAAE,OAAO,CAAC;IACzB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,6BAA6B,EAAE,SAAS,GAAG,WAAW,GAAG,aAAa,CAAC;CACxE,CAAC;AAqDF,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,iCAAiC,GACvC,iCAAiC,CAmBnC"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iCAAiC,EAGlC,MAAM,iBAAiB,CAAC;AAEzB,KAAK,4BAA4B,GAAG,SAAS,GAAG,OAAO,GAAG,eAAe,GAAG,SAAS,CAAC;AAEtF,KAAK,iCAAiC,GAAG;IACvC,yBAAyB,EAAE,MAAM,CAAC;IAClC,cAAc,EAAE,4BAA4B,CAAC;IAC7C,kBAAkB,EAAE,OAAO,CAAC;IAC5B,eAAe,EAAE,OAAO,CAAC;IACzB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,6BAA6B,EAAE,SAAS,GAAG,WAAW,GAAG,aAAa,CAAC;CACxE,CAAC;AAqDF;;;;;GAKG;AACH,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,iCAAiC,GACvC,iCAAiC,CAmBnC"}

package/dist/status.js

@@ -42,6 +42,13 @@ function createHealth(input) {
     status: 'healthy'
   };
 }
+
+/**
+ * Create prisma platform status snapshot.
+ *
+ * @param input The input.
+ * @returns The create prisma platform status snapshot result.
+ */
 export function createPrismaPlatformStatusSnapshot(input) {
   return {
     details: {

package/dist/tokens.d.ts

@@ -1,5 +1,27 @@
+import type { Token } from '@fluojs/core';
 /** Dependency-injection token for the raw Prisma client handle. */
 export declare const PRISMA_CLIENT: unique symbol;
 /** Dependency-injection token for normalized Prisma runtime options. */
 export declare const PRISMA_OPTIONS: unique symbol;
+/**
+ * Returns the DI token for the raw Prisma client bound to a registration name.
+ *
+ * @param name Optional registration name. Omit it to target the default unnamed Prisma registration.
+ * @returns The token that resolves the matching Prisma client instance.
+ */
+export declare function getPrismaClientToken(name?: string): Token;
+/**
+ * Returns the DI token for normalized Prisma module options bound to a registration name.
+ *
+ * @param name Optional registration name. Omit it to target the default unnamed Prisma registration.
+ * @returns The token that resolves the matching Prisma runtime options.
+ */
+export declare function getPrismaOptionsToken(name?: string): Token;
+/**
+ * Returns the DI token for the transaction-aware Prisma service bound to a registration name.
+ *
+ * @param name Optional registration name. Omit it to target the default unnamed Prisma registration.
+ * @returns The token that resolves the matching `PrismaService` instance.
+ */
+export declare function getPrismaServiceToken(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,mEAAmE;AACnE,eAAO,MAAM,aAAa,eAAmC,CAAC;AAC9D,wEAAwE;AACxE,eAAO,MAAM,cAAc,eAAoC,CAAC"}
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C,mEAAmE;AACnE,eAAO,MAAM,aAAa,eAAmC,CAAC;AAC9D,wEAAwE;AACxE,eAAO,MAAM,cAAc,eAAoC,CAAC;AAgBhE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAMzD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAM1D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAM1D"}

package/dist/tokens.js

@@ -1,4 +1,47 @@
 /** Dependency-injection token for the raw Prisma client handle. */
 export const PRISMA_CLIENT = Symbol.for('fluo.prisma.client');
 /** Dependency-injection token for normalized Prisma runtime options. */
-export const PRISMA_OPTIONS = Symbol.for('fluo.prisma.options');
+export const PRISMA_OPTIONS = Symbol.for('fluo.prisma.options');
+function normalizePrismaRegistrationName(name) {
+  if (name === undefined) {
+    return undefined;
+  }
+  const normalizedName = name.trim();
+  if (normalizedName.length === 0) {
+    throw new Error('PrismaModule name must be a non-empty string when provided.');
+  }
+  return normalizedName;
+}
+
+/**
+ * Returns the DI token for the raw Prisma client bound to a registration name.
+ *
+ * @param name Optional registration name. Omit it to target the default unnamed Prisma registration.
+ * @returns The token that resolves the matching Prisma client instance.
+ */
+export function getPrismaClientToken(name) {
+  const normalizedName = normalizePrismaRegistrationName(name);
+  return normalizedName === undefined ? PRISMA_CLIENT : Symbol.for(`fluo.prisma.client:${normalizedName}`);
+}
+
+/**
+ * Returns the DI token for normalized Prisma module options bound to a registration name.
+ *
+ * @param name Optional registration name. Omit it to target the default unnamed Prisma registration.
+ * @returns The token that resolves the matching Prisma runtime options.
+ */
+export function getPrismaOptionsToken(name) {
+  const normalizedName = normalizePrismaRegistrationName(name);
+  return normalizedName === undefined ? PRISMA_OPTIONS : Symbol.for(`fluo.prisma.options:${normalizedName}`);
+}
+
+/**
+ * Returns the DI token for the transaction-aware Prisma service bound to a registration name.
+ *
+ * @param name Optional registration name. Omit it to target the default unnamed Prisma registration.
+ * @returns The token that resolves the matching `PrismaService` instance.
+ */
+export function getPrismaServiceToken(name) {
+  const normalizedName = normalizePrismaRegistrationName(name);
+  return normalizedName === undefined ? Symbol.for('fluo.prisma.service') : Symbol.for(`fluo.prisma.service:${normalizedName}`);
+}

package/dist/types.d.ts

@@ -41,6 +41,8 @@ export interface PrismaClientLike<TTransactionClient = unknown, TTransactionOpti
  * @typeParam TTransactionOptions Options forwarded to Prisma interactive transactions.
  */
 export interface PrismaModuleOptions<TClient extends PrismaClientLike<TTransactionClient, TTransactionOptions>, TTransactionClient = InferPrismaTransactionClient<TClient>, TTransactionOptions = InferPrismaTransactionOptions<TClient>> {
+    /** Optional registration name used to isolate Prisma tokens inside one application container. */
+    name?: string;
     /** Root Prisma client shared outside ambient transaction scopes. */
     client: TClient;
     /**

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,yBAAyB,CAAC,kBAAkB,EAAE,OAAO,IAAI,CAAC,MAAM,EAAE,kBAAkB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAE/G;;;;GAIG;AACH,MAAM,MAAM,4BAA4B,CAAC,OAAO,IAAI,OAAO,SAAS;IAClE,YAAY,CAAC,EAAE,CAAC,CAAC,EACf,QAAQ,EAAE,yBAAyB,CAAC,MAAM,kBAAkB,EAAE,CAAC,CAAC,EAChE,OAAO,CAAC,EAAE,MAAM,oBAAoB,KACjC,OAAO,CAAC,CAAC,CAAC,CAAC;CACjB,GACG,kBAAkB,GAClB,OAAO,CAAC;AAEZ;;;;GAIG;AACH,MAAM,MAAM,6BAA6B,CAAC,OAAO,IAAI,OAAO,SAAS;IACnE,YAAY,CAAC,EAAE,CAAC,CAAC,EACf,QAAQ,EAAE,yBAAyB,CAAC,MAAM,mBAAmB,EAAE,CAAC,CAAC,EACjE,OAAO,CAAC,EAAE,MAAM,mBAAmB,KAChC,OAAO,CAAC,CAAC,CAAC,CAAC;CACjB,GACG,mBAAmB,GACnB,OAAO,CAAC;AAEZ;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,CAAC,OAAO,IAAI,4BAA4B,CAAC,OAAO,CAAC,CAAC;AAErF;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB,CAAC,kBAAkB,GAAG,OAAO,EAAE,mBAAmB,GAAG,OAAO;IAC3F,QAAQ,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;IAChC,WAAW,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;IACnC,YAAY,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,yBAAyB,CAAC,kBAAkB,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACzH;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB,CAClC,OAAO,SAAS,gBAAgB,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,EACzE,kBAAkB,GAAG,4BAA4B,CAAC,OAAO,CAAC,EAC1D,mBAAmB,GAAG,6BAA6B,CAAC,OAAO,CAAC;IAE5D,oEAAoE;IACpE,MAAM,EAAE,OAAO,CAAC;IAChB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB,CACnC,OAAO,SAAS,gBAAgB,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,EACzE,kBAAkB,GAAG,4BAA4B,CAAC,OAAO,CAAC,EAC1D,mBAAmB,GAAG,6BAA6B,CAAC,OAAO,CAAC;IAE5D,gGAAgG;IAChG,OAAO,IAAI,OAAO,GAAG,kBAAkB,CAAC;IACxC;;;;;;;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;AAEjD,KAAK,yBAAyB,CAAC,kBAAkB,EAAE,OAAO,IAAI,CAAC,MAAM,EAAE,kBAAkB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAE/G;;;;GAIG;AACH,MAAM,MAAM,4BAA4B,CAAC,OAAO,IAAI,OAAO,SAAS;IAClE,YAAY,CAAC,EAAE,CAAC,CAAC,EACf,QAAQ,EAAE,yBAAyB,CAAC,MAAM,kBAAkB,EAAE,CAAC,CAAC,EAChE,OAAO,CAAC,EAAE,MAAM,oBAAoB,KACjC,OAAO,CAAC,CAAC,CAAC,CAAC;CACjB,GACG,kBAAkB,GAClB,OAAO,CAAC;AAEZ;;;;GAIG;AACH,MAAM,MAAM,6BAA6B,CAAC,OAAO,IAAI,OAAO,SAAS;IACnE,YAAY,CAAC,EAAE,CAAC,CAAC,EACf,QAAQ,EAAE,yBAAyB,CAAC,MAAM,mBAAmB,EAAE,CAAC,CAAC,EACjE,OAAO,CAAC,EAAE,MAAM,mBAAmB,KAChC,OAAO,CAAC,CAAC,CAAC,CAAC;CACjB,GACG,mBAAmB,GACnB,OAAO,CAAC;AAEZ;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,CAAC,OAAO,IAAI,4BAA4B,CAAC,OAAO,CAAC,CAAC;AAErF;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB,CAAC,kBAAkB,GAAG,OAAO,EAAE,mBAAmB,GAAG,OAAO;IAC3F,QAAQ,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;IAChC,WAAW,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;IACnC,YAAY,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,yBAAyB,CAAC,kBAAkB,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACzH;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB,CAClC,OAAO,SAAS,gBAAgB,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,EACzE,kBAAkB,GAAG,4BAA4B,CAAC,OAAO,CAAC,EAC1D,mBAAmB,GAAG,6BAA6B,CAAC,OAAO,CAAC;IAE5D,iGAAiG;IACjG,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,MAAM,EAAE,OAAO,CAAC;IAChB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB,CACnC,OAAO,SAAS,gBAAgB,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,EACzE,kBAAkB,GAAG,4BAA4B,CAAC,OAAO,CAAC,EAC1D,mBAAmB,GAAG,6BAA6B,CAAC,OAAO,CAAC;IAE5D,gGAAgG;IAChG,OAAO,IAAI,OAAO,GAAG,kBAAkB,CAAC;IACxC;;;;;;;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.0.0-beta.1",
+  "version": "1.0.0-beta.2",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -36,11 +36,11 @@
     "dist"
   ],
   "dependencies": {
-    "@fluojs/core": "^1.0.0-beta.1",
-    "@fluojs/http": "^1.0.0-beta.1",
-    "@fluojs/runtime": "^1.0.0-beta.1",
+    "@fluojs/core": "^1.0.0-beta.2",
     "@fluojs/validation": "^1.0.0-beta.1",
-    "@fluojs/di": "^1.0.0-beta.1"
+    "@fluojs/http": "^1.0.0-beta.3",
+    "@fluojs/di": "^1.0.0-beta.4",
+    "@fluojs/runtime": "^1.0.0-beta.4"
   },
   "peerDependencies": {
     "@prisma/client": ">=5.0.0"