@bett3r-dev/pv3 1.0.0 → 1.1.7

package/build/ports/configuration/index.js

@@ -1,4 +1,37 @@
 "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;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -6,17 +39,26 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Configuration = void 0;
 const pv3_types_1 = require("@bett3r-dev/pv3-types");
 const path_1 = __importDefault(require("path"));
-const ramda_1 = __importDefault(require("ramda"));
+const R = __importStar(require("ramda"));
 const validation_1 = require("../../libraries/validation");
 const base_1 = require("../base");
 const args_1 = require("./args");
 const localConfig_1 = require("./localConfig");
-const appRoot = process.env.APP_ROOT_DIR || global.appRoot || process.cwd() || path_1.default.dirname(require.main?.filename || '');
+let appRoot = process.env.APP_ROOT_DIR || global.appRoot || process.cwd() || path_1.default.dirname(require.main?.filename || '');
 const Configuration = (...adapters) => {
     let _config;
     let _args = {};
+    // "Has a parse happened yet?" MUST be its own boolean and MUST NOT be derived
+    // from `_args`. `formatArgs` returns `omit([ '$0', '_' ], args )`, so a
+    // legitimately FLAGLESS parse yields `{}` — using emptiness as the sentinel
+    // would report "not parsed" for exactly the argv whose correct answer is
+    // "every flag is off". (pv3 ADR-024.)
+    let _argsParsed = false;
+    const paramAppRoot = adapters.filter(x => typeof x === 'string').pop();
+    appRoot = paramAppRoot || appRoot;
+    const configAdapters = adapters.filter(x => typeof x !== 'string');
     const applyAdapters = (config) => {
-        return (adapters || []).reduce((success, adapter) => success.then(adapter.applyConfig), Promise.resolve(config));
+        return (configAdapters || []).reduce((success, adapter) => success.then(adapter.applyConfig), Promise.resolve(config));
     };
     const _getConfig = () => _config
         ? Promise.resolve(_config)
@@ -25,25 +67,16 @@ const Configuration = (...adapters) => {
             .then(applyAdapters)
             .then(config => _config = config);
     const getModuleConfig = (configPath, schema) => {
-        const moduleConfig = ramda_1.default.path(configPath.split('.'), _config);
+        const moduleConfig = R.path(configPath.split('.'), _config);
         if (!moduleConfig) {
             if (schema.isRequired)
                 throw Error(`Configuration not available for ${configPath}`);
-            // return { config: {} as T, onArgsApplied: () => {} };
-        }
-        let moduleConfigInstance;
-        try {
-            moduleConfigInstance = (0, validation_1.validateSchema)(schema, true)(moduleConfig || {});
-        }
-        catch (e) {
-            e.description = `${e.description} - configPath: ${configPath}`;
-            throw e;
         }
         return {
-            config: moduleConfigInstance,
+            config: (0, validation_1.validateSchema)(schema, true)(moduleConfig),
             onArgsApplied: (callback) => {
                 config.emitter.on('argsApplied', ({ config }) => {
-                    callback(ramda_1.default.path(configPath.split('.'), config));
+                    callback(R.path(configPath.split('.'), config));
                 });
             }
         };
@@ -53,6 +86,7 @@ const Configuration = (...adapters) => {
         config.emitter.emit('argsApplied', appliedArgs);
         _config = appliedArgs.config;
         _args = appliedArgs.args;
+        _argsParsed = true;
         return config;
     };
     const getArgs = async () => {
@@ -61,9 +95,16 @@ const Configuration = (...adapters) => {
     };
     const configureCliArg = (options, yargs) => {
         const args = yargs || (0, args_1.getYargs)();
+        // Throws on a cross-flag collision; returns false when this exact definition is being
+        // re-registered, in which case every call below would be a no-op anyway.
+        if (!(0, args_1.claimCliArgTokens)(args, options['name'], options['alias']))
+            return;
         args[options['type']](options['name']);
         options.alias && args.alias(options['name'], options['alias']);
-        options.default && args.default(options['name'], options['default']);
+        // `!== undefined`, not truthiness: `false`, `0` and `''` are legitimate defaults and were
+        // being silently dropped. `alias`/`description` stay truthy-guarded -- an empty one is
+        // meaningless input, not a value worth registering.
+        options.default !== undefined && args.default(options['name'], options['default']);
         options.description && args.describe(options['name'], options['description']);
     };
     const configureCliCommand = (options) => {
@@ -75,12 +116,39 @@ const Configuration = (...adapters) => {
             return yargs;
         }, options.handler);
     };
+    /**
+     * The last-applied arg snapshot, synchronously and WITHOUT re-parsing —
+     * generalising `getLift()` below, which already reads `_args` this way.
+     *
+     * This exists for consumers that run in a synchronous frame and cannot await
+     * `getArgs()` — notably artifact factories on the `--lift` path, which must
+     * read their own process role without a second authority for it.
+     *
+     * It deliberately does NOT parse. `getArgs()` re-parses on every call, and
+     * that is a contract (`-p/--port` and `generateDocumentation` register during
+     * port setup and only take effect on a later parse). A sync accessor that
+     * parsed would either re-run yargs command handlers or freeze a premature
+     * snapshot; it reports what the last parse saw, and says so when there wasn't
+     * one.
+     *
+     * @returns `undefined` when nothing has parsed yet; otherwise the snapshot,
+     *          which is `{}` for a flagless argv. See the tri-state note on
+     *          `ConfigurationType.getArgsSync`.
+     */
+    const getArgsSync = () => _argsParsed ? _args : undefined;
+    const getLift = () => {
+        const lift = _args['lift'];
+        if (!lift || !Array.isArray(lift) || lift.length === 0)
+            return undefined;
+        return lift.map(String);
+    };
     const config = (0, base_1.createPort)({
         _getConfig: () => _config,
-        getModules: () => _config.modules,
         getArgs,
+        getArgsSync,
         applyArgs: applyCLIArgs,
         getModuleConfig,
+        getLift,
         configureCliArg,
         configureCliCommand,
         emitter: new pv3_types_1.TypedEventEmitter()

package/build/ports/configuration/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ports/configuration/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ports/configuration/index.ts"],"names":[],"mappings":"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"}

package/build/ports/configuration/localConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"localConfig.d.ts","sourceRoot":"","sources":["../../../src/ports/configuration/localConfig.ts"],"names":[],"mappings":"AA4CA,eAAO,MAAM,oBAAoB,YAAc,MAAM,iBASpD,CAAC;AAEF,wBAAgB,cAAc,CAAE,OAAO,EAAE,MAAM,EAAE,YAAY,SAAa,EAAE,aAAa,KAAK,EAAE,4BAA4B,UAAQ,gBA6DnI"}
+{"version":3,"file":"localConfig.d.ts","sourceRoot":"","sources":["../../../src/ports/configuration/localConfig.ts"],"names":[],"mappings":"AAwCA,eAAO,MAAM,oBAAoB,YAAc,MAAM,iBASpD,CAAC;AAEF,wBAAgB,cAAc,CAAE,OAAO,EAAE,MAAM,EAAE,YAAY,SAAa,EAAE,aAAa,KAAK,EAAE,4BAA4B,UAAQ,gBA4CnI"}

package/build/ports/configuration/localConfig.js

@@ -15,18 +15,29 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+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;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getLocalConfig = exports.getProjectRootConfig = void 0;
+exports.getProjectRootConfig = void 0;
+exports.getLocalConfig = getLocalConfig;
 const fs_1 = __importDefault(require("fs"));
 const glob = __importStar(require("glob"));
 const js_yaml_1 = __importDefault(require("js-yaml"));
@@ -45,13 +56,13 @@ const createDefaultConfigFile = (folder) => (content) => {
     Promise.resolve();
     return (0, util_1.promisify)(fs_1.default.writeFile)(path_1.default.join(folder, 'default.yaml'), js_yaml_1.default.dump(content, {
         indent: 2,
-        sortKeys: true,
+        sortKeys: true
     }))
         .then((0, ramda_1.always)(content));
 };
 function getFileContent(fileName) {
     if (['.js', '.json'].includes(path_1.default.extname(fileName))) {
-        return Promise.resolve(`${fileName}`).then(s => __importStar(require(s)));
+        return import(fileName);
     }
     else if (['.yaml', '.yml'].includes(path_1.default.extname(fileName))) {
         return readFile(fileName, 'utf8').then((file) => js_yaml_1.default.load(file, { json: true }));
@@ -63,7 +74,7 @@ function getFileContent(fileName) {
 const getProjectRootConfig = (appRoot) => {
     do {
         appRoot = path_1.default.dirname(appRoot);
-        const rootProjectFolder = path_1.default.join(appRoot, '.esas.config.json');
+        const rootProjectFolder = path_1.default.join(appRoot, '.blueprint.config.json');
         if (fs_1.default.existsSync(rootProjectFolder)) {
             return getLocalConfig(appRoot);
         }
@@ -74,7 +85,7 @@ exports.getProjectRootConfig = getProjectRootConfig;
 function getLocalConfig(appRoot, configFolder = './config', initialConfig = {}, forceCreateDefaultConfigFile = false) {
     const options = {
         configFolder: path_1.default.join(appRoot, configFolder),
-        configFilePattern: '*+(c|C)onfig.+(js|json|yaml|yml)',
+        configFilePattern: '*+(c|C)onfig.+(js|json|yaml|yml)'
     };
     let defaultConfigFile = searchFile(options.configFolder, 'default.+(js|json|yaml|yml)');
     let defaultConfigPromise = Promise.resolve();
@@ -86,23 +97,31 @@ function getLocalConfig(appRoot, configFolder = './config', initialConfig = {},
                 .then(() => !defaultConfigFile ? {} : getFileContent(path_1.default.join(options.configFolder, defaultConfigFile)))
                 .then((defaultConfig) => (0, common_1.mergeConfigProperty)(initialConfig, defaultConfig)))
         .then(async (configObj) => {
-        let localConfigFile = searchFile(options.configFolder, 'local.+(js|json|yaml|yml)');
-        if (localConfigFile) {
-            localConfigFile = path_1.default.join(options.configFolder, localConfigFile);
-            configObj = (0, common_1.mergeConfigProperty)(configObj, await getFileContent(localConfigFile));
-        }
-        let environmentFileName = searchFile(options.configFolder, `${environment}.+(js|json|yaml|yml)`);
-        if (environmentFileName) {
-            environmentFileName = path_1.default.join(options.configFolder, environmentFileName);
-            configObj = (0, common_1.mergeConfigProperty)(configObj, await getFileContent(environmentFileName));
-        }
-        let environmentFileLocalName = searchFile(options.configFolder, `local-${environment}.+(js|json|yaml|yml)`);
-        if (environmentFileLocalName) {
-            environmentFileLocalName = path_1.default.join(options.configFolder, environmentFileLocalName);
-            configObj = (0, common_1.mergeConfigProperty)(configObj, await getFileContent(environmentFileLocalName));
+        /*
+          Merge order, lowest precedence first:
+  
+            default  ->  <NODE_ENV>  ->  local  ->  local-<NODE_ENV>
+  
+          The two `local*` layers are supplied by the developer or by the
+          deployment (mounted secret) and are never committed. They must
+          therefore win over the committed `<NODE_ENV>` file: otherwise a key
+          present in, say, `production.yaml` would silently override the value
+          mounted at `local-production.yaml`, which is exactly backwards for
+          credentials. Committed files describe shape and non-secret settings;
+          the `local*` files supply the values that cannot live in git.
+        */
+        const layerPatterns = [
+            `${environment}.+(js|json|yaml|yml)`,
+            'local.+(js|json|yaml|yml)',
+            `local-${environment}.+(js|json|yaml|yml)`
+        ];
+        for (const pattern of layerPatterns) {
+            const fileName = searchFile(options.configFolder, pattern);
+            if (!fileName)
+                continue;
+            configObj = (0, common_1.mergeConfigProperty)(configObj, await getFileContent(path_1.default.join(options.configFolder, fileName)));
         }
         return configObj;
     });
 }
-exports.getLocalConfig = getLocalConfig;
 //# sourceMappingURL=localConfig.js.map

package/build/ports/configuration/localConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"localConfig.js","sourceRoot":"","sources":["../../../src/ports/configuration/localConfig.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4CAAoB;AACpB,2CAA6B;AAC7B,sDAA2B;AAC3B,gDAAwB;AACxB,iCAA+B;AAC/B,+BAAiC;AACjC,qCAA+C;AAO/C,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,aAAa,CAAC;AAE1D,MAAM,QAAQ,GAAG,IAAA,gBAAS,EAAE,YAAE,CAAC,QAAQ,CAAE,CAAC;AAC1C,SAAS,UAAU,CAAE,MAAc,EAAE,OAAe;IAClD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAE,OAAO,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;IACvD,IAAK,KAAK,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,uBAAuB,GAAG,CAAE,MAAa,EAAG,EAAE,CAAC,CAAE,OAAY,EAAG,EAAE;IACtE,OAAO,CAAC,OAAO,EAAE,CAAC;IAClB,OAAO,IAAA,gBAAS,EAAE,YAAE,CAAC,SAAS,CAAE,CAAE,cAAI,CAAC,IAAI,CAAE,MAAM,EAAE,cAAc,CAAE,EAAE,iBAAI,CAAC,IAAI,CAAE,OAAO,EAAE;QACzF,MAAM,EAAE,CAAC;QACT,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;SACA,IAAI,CAAE,IAAA,cAAM,EAAE,OAAO,CAAE,CAAC,CAAC;AAC9B,CAAC,CAAC;AAEF,SAAS,cAAc,CAAE,QAAgB;IACvC,IAAI,CAAE,KAAK,EAAE,OAAO,CAAE,CAAC,QAAQ,CAAE,cAAI,CAAC,OAAO,CAAE,QAAQ,CAAE,CAAC,EAAE;QAC1D,0BAAe,QAAQ,wCAAG;KAC3B;SAAM,IAAI,CAAE,OAAO,EAAE,MAAM,CAAE,CAAC,QAAQ,CAAE,cAAI,CAAC,OAAO,CAAE,QAAQ,CAAE,CAAC,EAAE;QAClE,OAAO,QAAQ,CAAE,QAAQ,EAAE,MAAM,CAAE,CAAC,IAAI,CACtC,CAAE,IAAI,EAAG,EAAE,CAAC,iBAAI,CAAC,IAAI,CAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAC7C,CAAC;KACH;SAAM;QACL,OAAO,OAAO,CAAC,MAAM,CACnB,KAAK,CAAE,oCAAoC,QAAQ,GAAG,CAAE,CACzD,CAAC;KACH;AACH,CAAC;AAEM,MAAM,oBAAoB,GAAG,CAAE,OAAe,EAAG,EAAE;IACxD,GAAG;QACD,OAAO,GAAG,cAAI,CAAC,OAAO,CAAE,OAAO,CAAE,CAAC;QAClC,MAAM,iBAAiB,GAAG,cAAI,CAAC,IAAI,CAAE,OAAO,EAAE,mBAAmB,CAAE,CAAC;QACpE,IAAK,YAAE,CAAC,UAAU,CAAE,iBAAiB,CAAE,EAAE;YACvC,OAAO,cAAc,CAAE,OAAO,CAAE,CAAC;SAClC;KACF,QAAS,OAAO,KAAK,GAAG,EAAG;IAC5B,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAC7B,CAAC,CAAC;AATW,QAAA,oBAAoB,wBAS/B;AAEF,SAAgB,cAAc,CAAE,OAAe,EAAE,YAAY,GAAG,UAAU,EAAE,aAAa,GAAG,EAAE,EAAE,4BAA4B,GAAG,KAAK;IAClI,MAAM,OAAO,GAAuB;QAClC,YAAY,EAAE,cAAI,CAAC,IAAI,CAAE,OAAO,EAAE,YAAY,CAAE;QAChD,iBAAiB,EAAE,kCAAkC;KACtD,CAAC;IACF,IAAI,iBAAiB,GAAG,UAAU,CAChC,OAAO,CAAC,YAAY,EACpB,6BAA6B,CAC9B,CAAC;IACF,IAAI,oBAAoB,GAAiB,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3D,OAAO,CACL,CAAC,iBAAiB,IAAI,4BAA4B;QAChD,CAAC,CAAC,oBAAoB;aACnB,IAAI,CAAE,uBAAuB,CAAE,cAAI,CAAC,IAAI,CAAE,OAAO,EAAE,SAAS,CAAE,CAAC,CAAC;QACnE,CAAC;YACD,oBAAoB;iBACjB,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,CAAE,cAAI,CAAC,IAAI,CAAE,OAAO,CAAC,YAAY,EAAE,iBAA2B,CAAE,CAAC,CAAC;iBACrH,IAAI,CAAC,CAAE,aAAa,EAAG,EAAE,CAAC,IAAA,4BAAmB,EAAE,aAAa,EAAE,aAAa,CAAE,CAAC,CACpF;SACE,IAAI,CAAE,KAAK,EAAG,SAAS,EAAG,EAAE;QAC3B,IAAI,eAAe,GAAG,UAAU,CAC9B,OAAO,CAAC,YAAY,EACpB,2BAA2B,CAC5B,CAAC;QACF,IAAK,eAAe,EAAG;YACrB,eAAe,GAAG,cAAI,CAAC,IAAI,CAAE,OAAO,CAAC,YAAY,EAAE,eAAe,CAAE,CAAC;YACrE,SAAS,GAAG,IAAA,4BAAmB,EAC7B,SAAS,EACT,MAAM,cAAc,CAAE,eAAe,CAAE,CACxC,CAAC;SACH;QACD,IAAI,mBAAmB,GAAG,UAAU,CAClC,OAAO,CAAC,YAAY,EACpB,GAAG,WAAW,sBAAsB,CACrC,CAAC;QACF,IAAK,mBAAmB,EAAG;YACzB,mBAAmB,GAAG,cAAI,CAAC,IAAI,CAC7B,OAAO,CAAC,YAAY,EACpB,mBAAmB,CACpB,CAAC;YACF,SAAS,GAAG,IAAA,4BAAmB,EAC7B,SAAS,EACT,MAAM,cAAc,CAAE,mBAAmB,CAAE,CAC5C,CAAC;SACH;QACD,IAAI,wBAAwB,GAAG,UAAU,CACvC,OAAO,CAAC,YAAY,EACpB,SAAS,WAAW,sBAAsB,CAC3C,CAAC;QACF,IAAK,wBAAwB,EAAG;YAC9B,wBAAwB,GAAG,cAAI,CAAC,IAAI,CAClC,OAAO,CAAC,YAAY,EACpB,wBAAwB,CACzB,CAAC;YACF,SAAS,GAAG,IAAA,4BAAmB,EAC7B,SAAS,EACT,MAAM,cAAc,CAAE,wBAAwB,CAAE,CACjD,CAAC;SACH;QACD,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC,CAAC;AACP,CAAC;AA7DD,wCA6DC"}
+{"version":3,"file":"localConfig.js","sourceRoot":"","sources":["../../../src/ports/configuration/localConfig.ts"],"names":[],"mappings":"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"}

package/build/ports/database/index.d.ts

@@ -1,4 +1,3 @@
 import { DatabaseAdapter, DatabasePort } from '@bett3r-dev/pv3-types';
-export declare const DuplicatedValueInIndex: () => import("@bett3r-dev/pv3-types").AppErrorType<{}>;
-export declare const Database: (adapter: DatabaseAdapter) => DatabasePort;
+export declare const Database: <T = any>(adapter: DatabaseAdapter<T>) => DatabasePort<T>;
 //# sourceMappingURL=index.d.ts.map

package/build/ports/database/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ports/database/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGtE,eAAO,MAAM,sBAAsB,wDAKjC,CAAC;AAEH,eAAO,MAAM,QAAQ,YAAc,eAAe,KAAI,YAYrD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ports/database/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGtE,eAAO,MAAM,QAAQ,GAAI,CAAC,GAAG,GAAG,WAAY,eAAe,CAAC,CAAC,CAAC,KAAI,YAAY,CAAC,CAAC,CA2B/E,CAAC"}

package/build/ports/database/index.js

@@ -1,27 +1,33 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Database = exports.DuplicatedValueInIndex = void 0;
-const utils_1 = require("../../utils");
+exports.Database = void 0;
 const base_1 = require("../base");
-const jsonschema_definer_1 = __importDefault(require("@bett3r-dev/jsonschema-definer"));
-const DuplicatedValueInIndex = () => (0, utils_1.AppError)({
-    error: 'NotUniqueError',
-    description: 'Duplicated values for Index marked as Unique',
-    schema: jsonschema_definer_1.default.shape({}).additionalProperties(true),
-    type: 'ConflictError',
-});
-exports.DuplicatedValueInIndex = DuplicatedValueInIndex;
 const Database = (adapter) => {
-    const database = Object.assign((0, base_1.createPort)(adapter), { _adapter: adapter });
-    adapter.start()
-        .then(() => {
+    const database = Object.assign((0, base_1.createPort)(adapter), { _adapter: () => adapter._adapter() });
+    // Eager auto-start (unchanged): callers such as `createTestPorts` never invoke
+    // `start()` and rely on `'started'` being emitted here so `onStarted` boot
+    // callbacks run. The chain now also awaits those async boot callbacks, so
+    // `'started'`/`start()` mean "fully started" (boot DDL like readmodel
+    // `ensureIndex` has completed) and a rejected boot callback rejects `start()`
+    // instead of becoming a swallowed unhandled rejection.
+    const bootstrapped = adapter.start()
+        .then(async () => {
         database.isStarted = true;
         database.emitter.emit('started');
+        await database.awaitStarted();
     });
-    return database;
+    // Prevent an orphan unhandled rejection when nobody awaits `start()`; awaiters
+    // of `start()` below still receive the rejection.
+    bootstrapped.catch(() => { });
+    return {
+        ...database,
+        start: () => bootstrapped,
+        stop: async () => {
+            await adapter.stop();
+            database.isStarted = false;
+            database.emitter.emit('stopped');
+        }
+    };
 };
 exports.Database = Database;
 //# sourceMappingURL=index.js.map

package/build/ports/database/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ports/database/index.ts"],"names":[],"mappings":";;;;;;AAAA,uCAAuC;AACvC,kCAAqC;AAErC,wFAA+C;AAExC,MAAM,sBAAsB,GAAG,GAAG,EAAE,CAAC,IAAA,gBAAQ,EAAC;IACnD,KAAK,EAAE,gBAAgB;IACvB,WAAW,EAAE,8CAA8C;IAC3D,MAAM,EAAE,4BAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,oBAAoB,CAAE,IAAI,CAAE;IAChD,IAAI,EAAE,eAAe;CACtB,CAAC,CAAC;AALU,QAAA,sBAAsB,0BAKhC;AAEI,MAAM,QAAQ,GAAG,CAAE,OAAwB,EAAiB,EAAE;IACnE,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAC5B,IAAA,iBAAU,EAAE,OAAO,CAAE,EACrB,EAAE,QAAQ,EAAE,OAAO,EAAE,CACtB,CAAC;IACF,OAAO,CAAC,KAAK,EAAE;SACZ,IAAI,CAAC,GAAG,EAAE;QACT,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC;QAC1B,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAE,SAAS,CAAE,CAAC;IACrC,CAAC,CAAC,CAAC;IAEL,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAZW,QAAA,QAAQ,YAYnB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ports/database/index.ts"],"names":[],"mappings":";;;AACA,kCAAqC;AAE9B,MAAM,QAAQ,GAAG,CAAW,OAA2B,EAAoB,EAAE;IAClF,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAE,IAAA,iBAAU,EAAE,OAAO,CAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC/F,+EAA+E;IAC/E,2EAA2E;IAC3E,0EAA0E;IAC1E,sEAAsE;IACtE,8EAA8E;IAC9E,uDAAuD;IACvD,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,EAAE;SACjC,IAAI,CAAE,KAAK,IAAI,EAAE;QAChB,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC;QAC1B,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAE,SAAS,CAAE,CAAC;QACnC,MAAM,QAAQ,CAAC,YAAY,EAAE,CAAC;IAChC,CAAC,CAAC,CAAC;IACL,+EAA+E;IAC/E,kDAAkD;IAClD,YAAY,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAE7B,OAAO;QACL,GAAG,QAAQ;QACX,KAAK,EAAE,GAAG,EAAE,CAAC,YAAY;QACzB,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;YACrB,QAAQ,CAAC,SAAS,GAAG,KAAK,CAAC;YAC3B,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAE,SAAS,CAAE,CAAC;QACrC,CAAC;KACF,CAAC;AACJ,CAAC,CAAC;AA3BW,QAAA,QAAQ,GAAR,QAAQ,CA2BnB"}

package/build/ports/database/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/build/ports/database/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../../src/ports/database/index.test.ts"],"names":[],"mappings":""}

package/build/ports/database/index.test.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_1 = require("./index");
+/**
+ * TV1-2057 regression guard — see cache/index.test.ts for the full bug description.
+ *
+ * The Database port is the closest structural analog to the buggy EventStore port:
+ * it DOES spread (`return { ...database, start, stop }`). It is nonetheless safe
+ * because `start`/`stop`/the eager bootstrap all mutate the ORIGINAL createPort
+ * instance's `isStarted` (`database.isStarted`) — which is exactly the flag the
+ * spread-copied `onStarted` closure reads. So a late `onStarted` fires.
+ *
+ * Note: the RETURNED object's own `isStarted` field is a stale COPY that stays
+ * `false` even once started; this is harmless precisely because `onStarted` ignores
+ * it and reads the instance flag. This test therefore asserts on the hook FIRING,
+ * never on the returned object's `isStarted`. It fails if `start()` is ever changed
+ * to flip the returned copy instead of the instance flag (the EventStore bug).
+ *
+ * PLAIN adapter double REQUIRED (a createPort/DatabaseEventstore-style adapter would
+ * shadow the port's lifecycle fields and mask the staleness bug).
+ */
+const plainDatabaseAdapter = () => ({
+    name: 'plain-db',
+    _adapter: () => ({}),
+    start: async () => { },
+    stop: async () => { }
+});
+describe('Database port — late onStarted (TV1-2057)', () => {
+    describe('Given a started Database port over a plain adapter', () => {
+        it('When onStarted is registered AFTER start, Then the hook still fires', async () => {
+            // Given — start() resolves once the eager bootstrap flips the instance flag
+            const database = (0, index_1.Database)(plainDatabaseAdapter());
+            await database.start();
+            // When — register the boot hook only after the port has started
+            let fired = false;
+            database.onStarted(() => { fired = true; });
+            await database.awaitStarted();
+            // Then — a start() that flipped the spread COPY would drop this hook
+            expect(fired).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/build/ports/database/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../../src/ports/database/index.test.ts"],"names":[],"mappings":";;AACA,mCAAmC;AAEnC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,oBAAoB,GAAG,GAAoB,EAAE,CAAC,CAAC;IACnD,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;IACpB,KAAK,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;IACrB,IAAI,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;CACW,CAAA,CAAC;AAElC,QAAQ,CAAE,2CAA2C,EAAE,GAAG,EAAE;IAC1D,QAAQ,CAAE,oDAAoD,EAAE,GAAG,EAAE;QACnE,EAAE,CAAE,qEAAqE,EAAE,KAAK,IAAI,EAAE;YACpF,4EAA4E;YAC5E,MAAM,QAAQ,GAAG,IAAA,gBAAQ,EAAE,oBAAoB,EAAE,CAAC,CAAC;YACnD,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC;YACvB,gEAAgE;YAChE,IAAI,KAAK,GAAG,KAAK,CAAC;YAClB,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5C,MAAM,QAAQ,CAAC,YAAY,EAAE,CAAC;YAC9B,qEAAqE;YACrE,MAAM,CAAE,KAAK,CAAE,CAAC,IAAI,CAAE,IAAI,CAAE,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/build/ports/endpoints/__tests__/declarationSite.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=declarationSite.test.d.ts.map

package/build/ports/endpoints/__tests__/declarationSite.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"declarationSite.test.d.ts","sourceRoot":"","sources":["../../../../src/ports/endpoints/__tests__/declarationSite.test.ts"],"names":[],"mappings":""}