@futdevpro/nts-dynamo 1.15.304 → 1.15.306

package/build/_modules/cli/_collections/cli-commander.util.d.ts

@@ -0,0 +1,25 @@
+import type * as Commander from 'commander';
+/** The supported `commander` range — kept in sync with `peerDependencies` (measured fleet: 12.1 – 14.x). */
+export declare const DyCLI_commanderRange: string;
+/**
+ * Lazy access to `commander` (HP-DOPL MP-4.1, D-5): `commander` is an OPTIONAL peer of `@futdevpro/nts-dynamo`, so
+ * it is never required in a module body — a server that only imports the root package must not need it. The `/cli`
+ * subpath loads it here, at the place of use; a missing package becomes the coded `DyNTS-OPT-MIS` error that says
+ * what to install.
+ *
+ * @example
+ * ```ts
+ * const commander: typeof Commander = await DyCLI_Commander_Util.load();
+ * const program: Commander.Command = new commander.Command('organizer');
+ * ```
+ */
+export declare class DyCLI_Commander_Util {
+    /**
+     * Loads `commander`.
+     * @throws 501 `DyNTS-OPT-MIS` (not installed) · `DyNTS-OPT-LDF` (installed, but failed to load)
+     */
+    static load(): Promise<typeof Commander>;
+    /** Imports `commander` — a static seam, so a spec can simulate a missing package. */
+    private static importCommander;
+}
+//# sourceMappingURL=cli-commander.util.d.ts.map

package/build/_modules/cli/_collections/cli-commander.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-commander.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/cli/_collections/cli-commander.util.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,SAAS,MAAM,WAAW,CAAC;AAK5C,4GAA4G;AAC5G,eAAO,MAAM,oBAAoB,EAAE,MAAuB,CAAC;AAE3D;;;;;;;;;;;GAWG;AACH,qBAAa,oBAAoB;IAC/B;;;OAGG;WACU,IAAI,IAAI,OAAO,CAAC,OAAO,SAAS,CAAC;IAO9C,qFAAqF;IACrF,OAAO,CAAC,MAAM,CAAC,eAAe,CAEyB;CACxD"}

package/build/_modules/cli/_collections/cli-commander.util.js

@@ -0,0 +1,69 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyCLI_Commander_Util = exports.DyCLI_commanderRange = void 0;
+const optional_peer_util_1 = require("../../../_collections/optional-peer.util");
+/** The supported `commander` range — kept in sync with `peerDependencies` (measured fleet: 12.1 – 14.x). */
+exports.DyCLI_commanderRange = '>=12.1.0 <15';
+/**
+ * Lazy access to `commander` (HP-DOPL MP-4.1, D-5): `commander` is an OPTIONAL peer of `@futdevpro/nts-dynamo`, so
+ * it is never required in a module body — a server that only imports the root package must not need it. The `/cli`
+ * subpath loads it here, at the place of use; a missing package becomes the coded `DyNTS-OPT-MIS` error that says
+ * what to install.
+ *
+ * @example
+ * ```ts
+ * const commander: typeof Commander = await DyCLI_Commander_Util.load();
+ * const program: Commander.Command = new commander.Command('organizer');
+ * ```
+ */
+class DyCLI_Commander_Util {
+    /**
+     * Loads `commander`.
+     * @throws 501 `DyNTS-OPT-MIS` (not installed) · `DyNTS-OPT-LDF` (installed, but failed to load)
+     */
+    static async load() {
+        return optional_peer_util_1.DyNTS_OptionalPeer_Util.load({
+            packageName: 'commander', range: exports.DyCLI_commanderRange, feature: 'the Dynamo CLI',
+            importer: DyCLI_Commander_Util.importCommander,
+        });
+    }
+    /** Imports `commander` — a static seam, so a spec can simulate a missing package. */
+    static importCommander = 
+    // eslint-disable-next-line @futdevpro/dynamo/no-dynamic-imports
+    () => Promise.resolve().then(() => __importStar(require('commander')));
+}
+exports.DyCLI_Commander_Util = DyCLI_Commander_Util;
+//# sourceMappingURL=cli-commander.util.js.map

package/build/_modules/cli/_collections/cli-commander.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-commander.util.js","sourceRoot":"","sources":["../../../../src/_modules/cli/_collections/cli-commander.util.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,iFAAmF;AAGnF,4GAA4G;AAC/F,QAAA,oBAAoB,GAAW,cAAc,CAAC;AAE3D;;;;;;;;;;;GAWG;AACH,MAAa,oBAAoB;IAC/B;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI;QACf,OAAO,4CAAuB,CAAC,IAAI,CAAC;YAClC,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,4BAAoB,EAAE,OAAO,EAAE,gBAAgB;YAChF,QAAQ,EAAE,oBAAoB,CAAC,eAAe;SAC/C,CAAC,CAAC;IACL,CAAC;IAED,qFAAqF;IAC7E,MAAM,CAAC,eAAe;IAC5B,gEAAgE;IAChE,GAA8B,EAAE,mDAAQ,WAAW,GAAC,CAAC;;AAfzD,oDAgBC"}

package/build/_modules/cli/index.d.ts

@@ -0,0 +1,2 @@
+export * from './_collections/cli-commander.util';
+//# sourceMappingURL=index.d.ts.map

package/build/_modules/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/cli/index.ts"],"names":[],"mappings":"AAOA,cAAc,mCAAmC,CAAC"}

package/build/_modules/cli/index.js

@@ -0,0 +1,9 @@
+"use strict";
+// CLI MODULE (HP-DOPL MP-4, D-4/D-5) — `@futdevpro/nts-dynamo/cli`: CLI commands from the same operation settings as
+// the REST endpoints and the MCP tools. `commander` is an OPTIONAL peer, loaded lazily; the root `index.ts` does NOT
+// re-export this module, so a server never needs `commander`.
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+// COLLECTIONS
+tslib_1.__exportStar(require("./_collections/cli-commander.util"), exports);
+//# sourceMappingURL=index.js.map

package/build/_modules/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/cli/index.ts"],"names":[],"mappings":";AAEA,qHAAqH;AACrH,qHAAqH;AACrH,8DAA8D;;;AAE9D,cAAc;AACd,4EAAkD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/nts-dynamo",
-  "version": "01.15.304",
+  "version": "01.15.306",
   "description": "Dynamic NodeTS (NodeJS-Typescript), MongoDB Backend System Framework by Future Development Program Ltd.",
   "DyBu_settings": {
     "packageType": "server-package",
@@ -203,6 +203,12 @@
       "types": "./build/_modules/mcp/index.d.ts",
       "typings": "./build/_modules/mcp/index.d.ts"
     },
+    "./cli": {
+      "default": "./build/_modules/cli/index.js",
+      "module": "./build/_modules/cli/index.js",
+      "types": "./build/_modules/cli/index.d.ts",
+      "typings": "./build/_modules/cli/index.d.ts"
+    },
     "./admin-auth": {
       "default": "./build/_modules/admin-auth/index.js",
       "module": "./build/_modules/admin-auth/index.js",
@@ -378,6 +384,9 @@
       "mcp": [
         "build/_modules/mcp/index.d.ts"
       ],
+      "cli": [
+        "build/_modules/cli/index.d.ts"
+      ],
       "admin-auth": [
         "build/_modules/admin-auth/index.d.ts"
       ],
@@ -452,6 +461,7 @@
     "@anthropic-ai/sdk": "~0.39.0",
     "@modelcontextprotocol/sdk": "~1.29.0",
     "better-sqlite3": "~12.4.1",
+    "commander": ">=12.1.0 <15",
     "@futdevpro/fsm-dynamo": ">=1.20.64 <2",
     "@types/express": "4.17.21",
     "@types/geoip-lite": "~1.4.4",
@@ -479,6 +489,9 @@
     "better-sqlite3": {
       "optional": true
     },
+    "commander": {
+      "optional": true
+    },
     "discord.js": {
       "optional": true
     },
@@ -510,9 +523,11 @@
     "@modelcontextprotocol/sdk": "~1.29.0",
     "@types/better-sqlite3": "~7.6.13",
     "better-sqlite3": "~12.4.1",
+    "commander": "~14.0.3",
     "decimal.js": "10.6.0",
     "discord.js": "~14.24.2",
     "eslint": "~9.39.5",
+    "express": "~4.22.2",
     "eslint-plugin-import": "^2.29.0",
     "eslint-plugin-jsdoc": "^48.0.0",
     "eslint-plugin-max-params-no-constructor": "^0.0.4",