@fluojs/mongoose 1.0.1 → 1.0.3

package/README.ko.md

@@ -50,7 +50,7 @@ const connection = mongoose.createConnection('mongodb://localhost:27017/test');
 class AppModule {}
 ```
 
-`MongooseModule.forRootAsync(...)`는 주입된 의존성과 동기 또는 비동기로 옵션을 반환하는 `useFactory`를 지원합니다. provider를 전역으로 노출해야 할 때는 최상위 async 등록 옵션에 `global`을 전달하세요. 해석된 옵션은 모듈 인스턴스 안에서 재사용되므로 연결 설정과 dispose hook이 모든 provider에서 일관되게 유지됩니다.
+`MongooseModule.forRootAsync(...)`는 주입된 의존성과 동기 또는 비동기로 옵션을 반환하는 `useFactory`를 지원합니다. 여러 모듈에서 async 등록 helper를 공유할 때는 export된 `MongooseAsyncModuleOptions<TConnection>` 타입을 사용하세요. provider를 전역으로 노출해야 할 때는 최상위 async 등록 옵션에 `global`을 전달하세요. 해석된 옵션은 모듈 인스턴스 안에서 재사용되므로 연결 설정과 dispose hook이 모든 provider에서 일관되게 유지됩니다.
 
 ## 라이프사이클과 종료
 
@@ -122,15 +122,17 @@ HTTP interceptor 밖에서 같은 request-aware transaction boundary가 필요
 - `MongooseConnection`
 - `MongooseTransactionInterceptor`
 - `MONGOOSE_CONNECTION`, `MONGOOSE_DISPOSE`, `MONGOOSE_OPTIONS`
-- `createMongooseProviders(options)`
+- `createMongooseProviders(options)` — 호환성/수동 composition helper입니다. 애플리케이션-facing 등록에서는 module export와 provider visibility가 문서화된 namespace facade와 맞도록 `MongooseModule.forRoot(...)` 또는 `MongooseModule.forRootAsync(...)`를 우선 사용하세요.
 - `createMongoosePlatformStatusSnapshot(...)`
 
 ### 관련 export 타입
 
 - `MongooseModuleOptions<TConnection>`
+- `MongooseAsyncModuleOptions<TConnection>`
 - `MongooseConnectionLike`
 - `MongooseSessionLike`
 - `MongooseHandleProvider`
+- `MongoosePlatformStatusSnapshotInput`
 
 ## 관련 패키지
 

package/README.md

@@ -48,7 +48,7 @@ const connection = mongoose.createConnection('mongodb://localhost:27017/test');
 class AppModule {}
 ```
 
-`MongooseModule.forRootAsync(...)` accepts injected dependencies and a `useFactory` that may return options synchronously or asynchronously. Pass `global` on the top-level async registration when the providers should be visible globally. The resolved options are reused for the module instance, so connection setup and disposal hooks stay consistent across all providers.
+`MongooseModule.forRootAsync(...)` accepts injected dependencies and a `useFactory` that may return options synchronously or asynchronously. Use the exported `MongooseAsyncModuleOptions<TConnection>` type when sharing async registration helpers across modules. Pass `global` on the top-level async registration when the providers should be visible globally. The resolved options are reused for the module instance, so connection setup and disposal hooks stay consistent across all providers.
 
 ## Lifecycle and Shutdown
 
@@ -113,15 +113,17 @@ Use `MongooseConnection.requestTransaction(...)` directly when you need the same
 - `MongooseConnection`
 - `MongooseTransactionInterceptor`
 - `MONGOOSE_CONNECTION`, `MONGOOSE_DISPOSE`, `MONGOOSE_OPTIONS`
-- `createMongooseProviders(options)`
+- `createMongooseProviders(options)` — compatibility/manual composition helper; prefer `MongooseModule.forRoot(...)` or `MongooseModule.forRootAsync(...)` for application-facing registration so module exports and provider visibility stay aligned.
 - `createMongoosePlatformStatusSnapshot(...)`
 
 ### Related exported types
 
 - `MongooseModuleOptions<TConnection>`
+- `MongooseAsyncModuleOptions<TConnection>`
 - `MongooseConnectionLike`
 - `MongooseSessionLike`
 - `MongooseHandleProvider`
+- `MongoosePlatformStatusSnapshotInput`
 
 ## Related Packages
 

package/dist/module.d.ts

@@ -2,9 +2,21 @@ import type { AsyncModuleOptions } from '@fluojs/core';
 import type { Provider } from '@fluojs/di';
 import { type ModuleType } from '@fluojs/runtime';
 import type { MongooseConnectionLike, MongooseModuleOptions } from './types.js';
-type MongooseAsyncModuleOptions<TConnection extends MongooseConnectionLike> = AsyncModuleOptions<Omit<MongooseModuleOptions<TConnection>, 'global'>> & Pick<MongooseModuleOptions<TConnection>, 'global'>;
 /**
- * Creates Mongoose providers for manual module composition.
+ * Async registration options accepted by `MongooseModule.forRootAsync(...)`.
+ *
+ * The factory resolves the same connection, disposal, and strict transaction
+ * options accepted by `MongooseModule.forRoot(...)`; `global` remains on the
+ * top-level async registration so callers can opt into global provider export.
+ */
+export type MongooseAsyncModuleOptions<TConnection extends MongooseConnectionLike> = AsyncModuleOptions<Omit<MongooseModuleOptions<TConnection>, 'global'>> & Pick<MongooseModuleOptions<TConnection>, 'global'>;
+/**
+ * Creates Mongoose providers for compatibility-oriented manual module composition.
+ *
+ * Prefer `MongooseModule.forRoot(...)` for application registration so module
+ * exports and provider visibility stay aligned with the documented namespace
+ * facade. Use this helper only when hand-assembling providers in advanced
+ * compatibility scenarios.
  *
  * @param options Mongoose module options with a connection handle, optional dispose hook, and strict transaction policy.
  * @returns Provider definitions equivalent to `MongooseModule.forRoot(...)`.
@@ -19,5 +31,4 @@ export declare class MongooseModule {
     /** Creates a module definition from DI-aware async Mongoose options. */
     static forRootAsync<TConnection extends MongooseConnectionLike>(options: MongooseAsyncModuleOptions<TConnection>): ModuleType;
 }
-export {};
 //# 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,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAKhE,OAAO,KAAK,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAahF,KAAK,0BAA0B,CAAC,WAAW,SAAS,sBAAsB,IAAI,kBAAkB,CAC9F,IAAI,CAAC,qBAAqB,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,CACnD,GAAG,IAAI,CAAC,qBAAqB,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC;AAiFvD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,SAAS,sBAAsB,EAChF,OAAO,EAAE,qBAAqB,CAAC,WAAW,CAAC,GAC1C,QAAQ,EAAE,CAOZ;AA0BD;;GAEG;AACH,qBAAa,cAAc;IACzB,gEAAgE;IAChE,MAAM,CAAC,OAAO,CAAC,WAAW,SAAS,sBAAsB,EAAE,OAAO,EAAE,qBAAqB,CAAC,WAAW,CAAC,GAAG,UAAU;IAInH,wEAAwE;IACxE,MAAM,CAAC,YAAY,CAAC,WAAW,SAAS,sBAAsB,EAC5D,OAAO,EAAE,0BAA0B,CAAC,WAAW,CAAC,GAC/C,UAAU;CAGd"}
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAKhE,OAAO,KAAK,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAahF;;;;;;GAMG;AACH,MAAM,MAAM,0BAA0B,CAAC,WAAW,SAAS,sBAAsB,IAAI,kBAAkB,CACrG,IAAI,CAAC,qBAAqB,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,CACnD,GAAG,IAAI,CAAC,qBAAqB,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC;AAiFvD;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,SAAS,sBAAsB,EAChF,OAAO,EAAE,qBAAqB,CAAC,WAAW,CAAC,GAC1C,QAAQ,EAAE,CAOZ;AA0BD;;GAEG;AACH,qBAAa,cAAc;IACzB,gEAAgE;IAChE,MAAM,CAAC,OAAO,CAAC,WAAW,SAAS,sBAAsB,EAAE,OAAO,EAAE,qBAAqB,CAAC,WAAW,CAAC,GAAG,UAAU;IAInH,wEAAwE;IACxE,MAAM,CAAC,YAAY,CAAC,WAAW,SAAS,sBAAsB,EAC5D,OAAO,EAAE,0BAA0B,CAAC,WAAW,CAAC,GAC/C,UAAU;CAGd"}

package/dist/module.js

@@ -2,6 +2,15 @@ import { defineModule } from '@fluojs/runtime';
 import { MongooseConnection } from './connection.js';
 import { MONGOOSE_CONNECTION, MONGOOSE_DISPOSE, MONGOOSE_OPTIONS } from './tokens.js';
 import { MongooseTransactionInterceptor } from './transaction.js';
+
+/**
+ * Async registration options accepted by `MongooseModule.forRootAsync(...)`.
+ *
+ * The factory resolves the same connection, disposal, and strict transaction
+ * options accepted by `MongooseModule.forRoot(...)`; `global` remains on the
+ * top-level async registration so callers can opt into global provider export.
+ */
+
 const MONGOOSE_NORMALIZED_OPTIONS = Symbol('fluo.mongoose.normalized-options');
 const MONGOOSE_MODULE_EXPORTS = [MongooseConnection, MongooseTransactionInterceptor];
 function normalizeMongooseModuleOptions(options) {
@@ -54,7 +63,12 @@ function createMongooseProvidersAsync(options) {
 }
 
 /**
- * Creates Mongoose providers for manual module composition.
+ * Creates Mongoose providers for compatibility-oriented manual module composition.
+ *
+ * Prefer `MongooseModule.forRoot(...)` for application registration so module
+ * exports and provider visibility stay aligned with the documented namespace
+ * facade. Use this helper only when hand-assembling providers in advanced
+ * compatibility scenarios.
  *
  * @param options Mongoose module options with a connection handle, optional dispose hook, and strict transaction policy.
  * @returns Provider definitions equivalent to `MongooseModule.forRoot(...)`.

package/dist/status.d.ts

@@ -1,6 +1,9 @@
 import type { PersistencePlatformStatusSnapshot } from '@fluojs/runtime';
 type MongoosePlatformLifecycleState = 'ready' | 'shutting-down' | 'stopped';
-type MongoosePlatformStatusSnapshotInput = {
+/**
+ * Input values used to create a Mongoose persistence platform status snapshot.
+ */
+export type MongoosePlatformStatusSnapshotInput = {
     activeRequestTransactions: number;
     activeSessions: number;
     hasActiveSession: boolean;

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,8BAA8B,GAAG,OAAO,GAAG,eAAe,GAAG,SAAS,CAAC;AAE5E,KAAK,mCAAmC,GAAG;IACzC,yBAAyB,EAAE,MAAM,CAAC;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,8BAA8B,CAAC;IAC/C,kBAAkB,EAAE,OAAO,CAAC;IAC5B,6BAA6B,EAAE,OAAO,CAAC;IACvC,oBAAoB,EAAE,OAAO,CAAC;CAC/B,CAAC;AAqDF;;;;;GAKG;AACH,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,mCAAmC,GACzC,iCAAiC,CAoBnC"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iCAAiC,EAGlC,MAAM,iBAAiB,CAAC;AAEzB,KAAK,8BAA8B,GAAG,OAAO,GAAG,eAAe,GAAG,SAAS,CAAC;AAE5E;;GAEG;AACH,MAAM,MAAM,mCAAmC,GAAG;IAChD,yBAAyB,EAAE,MAAM,CAAC;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,8BAA8B,CAAC;IAC/C,kBAAkB,EAAE,OAAO,CAAC;IAC5B,6BAA6B,EAAE,OAAO,CAAC;IACvC,oBAAoB,EAAE,OAAO,CAAC;CAC/B,CAAC;AAqDF;;;;;GAKG;AACH,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,mCAAmC,GACzC,iCAAiC,CAoBnC"}

package/dist/status.js

@@ -1,3 +1,7 @@
+/**
+ * Input values used to create a Mongoose persistence platform status snapshot.
+ */
+
 function createReadiness(input) {
   if (input.lifecycleState === 'shutting-down') {
     return {

package/package.json

@@ -9,7 +9,7 @@
     "transaction",
     "odm"
   ],
-  "version": "1.0.1",
+  "version": "1.0.3",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -36,10 +36,10 @@
     "dist"
   ],
   "dependencies": {
-    "@fluojs/core": "^1.0.1",
+    "@fluojs/core": "^1.0.2",
     "@fluojs/http": "^1.0.0",
-    "@fluojs/di": "^1.0.1",
-    "@fluojs/runtime": "^1.0.1"
+    "@fluojs/di": "^1.0.2",
+    "@fluojs/runtime": "^1.1.0"
   },
   "peerDependencies": {
     "mongoose": ">=7.0.0"