quidproquo-core 0.1.27 → 0.1.29

package/lib/commonjs/config/deploySettings/DEPLOY_SETTING_ENV_PREFIX.d.ts

@@ -0,0 +1,2 @@
+/** Prefix on the env var each deploy setting is delivered through. */
+export declare const DEPLOY_SETTING_ENV_PREFIX = "DEPLOY_SETTING_";

package/lib/commonjs/config/deploySettings/DEPLOY_SETTING_ENV_PREFIX.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEPLOY_SETTING_ENV_PREFIX = void 0;
+/** Prefix on the env var each deploy setting is delivered through. */
+exports.DEPLOY_SETTING_ENV_PREFIX = 'DEPLOY_SETTING_';
+//# sourceMappingURL=DEPLOY_SETTING_ENV_PREFIX.js.map

package/lib/commonjs/config/deploySettings/DEPLOY_SETTING_ENV_PREFIX.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DEPLOY_SETTING_ENV_PREFIX.js","sourceRoot":"","sources":["../../../../src/config/deploySettings/DEPLOY_SETTING_ENV_PREFIX.ts"],"names":[],"mappings":";;;AAAA,sEAAsE;AACzD,QAAA,yBAAyB,GAAG,iBAAiB,CAAC","sourcesContent":["/** Prefix on the env var each deploy setting is delivered through. */\nexport const DEPLOY_SETTING_ENV_PREFIX = 'DEPLOY_SETTING_';\n"]}

package/lib/commonjs/config/deploySettings/getDeploySetting.d.ts

@@ -0,0 +1,6 @@
+/**
+ * A deploy setting from the selected deployment's `settings` in deploy.config.json,
+ * for use in infrastructure.ts and config helpers. Throws when the setting is not
+ * defined, so a typo can't deploy an empty value.
+ */
+export declare const getDeploySetting: (key: string) => string;

package/lib/commonjs/config/deploySettings/getDeploySetting.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDeploySetting = void 0;
+const getDeploySettingEnvName_1 = require("./getDeploySettingEnvName");
+/**
+ * A deploy setting from the selected deployment's `settings` in deploy.config.json,
+ * for use in infrastructure.ts and config helpers. Throws when the setting is not
+ * defined, so a typo can't deploy an empty value.
+ */
+const getDeploySetting = (key) => {
+    const value = process.env[(0, getDeploySettingEnvName_1.getDeploySettingEnvName)(key)];
+    if (value === undefined) {
+        throw new Error(`Deploy setting '${key}' is not defined. Add it to the deployment's "settings" in deploy.config.json.`);
+    }
+    return value;
+};
+exports.getDeploySetting = getDeploySetting;
+//# sourceMappingURL=getDeploySetting.js.map

package/lib/commonjs/config/deploySettings/getDeploySetting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDeploySetting.js","sourceRoot":"","sources":["../../../../src/config/deploySettings/getDeploySetting.ts"],"names":[],"mappings":";;;AAAA,uEAAoE;AAEpE;;;;GAIG;AACI,MAAM,gBAAgB,GAAG,CAAC,GAAW,EAAU,EAAE;IACtD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAA,iDAAuB,EAAC,GAAG,CAAC,CAAC,CAAC;IAExD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,gFAAgF,CAAC,CAAC;IAC1H,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AARW,QAAA,gBAAgB,oBAQ3B","sourcesContent":["import { getDeploySettingEnvName } from './getDeploySettingEnvName';\n\n/**\n * A deploy setting from the selected deployment's `settings` in deploy.config.json,\n * for use in infrastructure.ts and config helpers. Throws when the setting is not\n * defined, so a typo can't deploy an empty value.\n */\nexport const getDeploySetting = (key: string): string => {\n  const value = process.env[getDeploySettingEnvName(key)];\n\n  if (value === undefined) {\n    throw new Error(`Deploy setting '${key}' is not defined. Add it to the deployment's \"settings\" in deploy.config.json.`);\n  }\n\n  return value;\n};\n"]}

package/lib/commonjs/config/deploySettings/getDeploySettingEnvName.d.ts

@@ -0,0 +1,2 @@
+/** The env var that carries the deploy setting `key` (the key is used verbatim, no case conversion). */
+export declare const getDeploySettingEnvName: (key: string) => string;

package/lib/commonjs/config/deploySettings/getDeploySettingEnvName.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDeploySettingEnvName = void 0;
+const DEPLOY_SETTING_ENV_PREFIX_1 = require("./DEPLOY_SETTING_ENV_PREFIX");
+/** The env var that carries the deploy setting `key` (the key is used verbatim, no case conversion). */
+const getDeploySettingEnvName = (key) => `${DEPLOY_SETTING_ENV_PREFIX_1.DEPLOY_SETTING_ENV_PREFIX}${key}`;
+exports.getDeploySettingEnvName = getDeploySettingEnvName;
+//# sourceMappingURL=getDeploySettingEnvName.js.map

package/lib/commonjs/config/deploySettings/getDeploySettingEnvName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDeploySettingEnvName.js","sourceRoot":"","sources":["../../../../src/config/deploySettings/getDeploySettingEnvName.ts"],"names":[],"mappings":";;;AAAA,2EAAwE;AAExE,wGAAwG;AACjG,MAAM,uBAAuB,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,GAAG,qDAAyB,GAAG,GAAG,EAAE,CAAC;AAAxF,QAAA,uBAAuB,2BAAiE","sourcesContent":["import { DEPLOY_SETTING_ENV_PREFIX } from './DEPLOY_SETTING_ENV_PREFIX';\n\n/** The env var that carries the deploy setting `key` (the key is used verbatim, no case conversion). */\nexport const getDeploySettingEnvName = (key: string): string => `${DEPLOY_SETTING_ENV_PREFIX}${key}`;\n"]}

package/lib/commonjs/config/deploySettings/getDeploySettingList.d.ts

@@ -0,0 +1,2 @@
+/** A comma-separated deploy setting as a trimmed list, empty items dropped. Throws like `getDeploySetting` when unset. */
+export declare const getDeploySettingList: (key: string) => string[];

package/lib/commonjs/config/deploySettings/getDeploySettingList.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDeploySettingList = void 0;
+const getDeploySetting_1 = require("./getDeploySetting");
+/** A comma-separated deploy setting as a trimmed list, empty items dropped. Throws like `getDeploySetting` when unset. */
+const getDeploySettingList = (key) => (0, getDeploySetting_1.getDeploySetting)(key)
+    .split(',')
+    .map((item) => item.trim())
+    .filter(Boolean);
+exports.getDeploySettingList = getDeploySettingList;
+//# sourceMappingURL=getDeploySettingList.js.map

package/lib/commonjs/config/deploySettings/getDeploySettingList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDeploySettingList.js","sourceRoot":"","sources":["../../../../src/config/deploySettings/getDeploySettingList.ts"],"names":[],"mappings":";;;AAAA,yDAAsD;AAEtD,0HAA0H;AACnH,MAAM,oBAAoB,GAAG,CAAC,GAAW,EAAY,EAAE,CAC5D,IAAA,mCAAgB,EAAC,GAAG,CAAC;KAClB,KAAK,CAAC,GAAG,CAAC;KACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;KAC1B,MAAM,CAAC,OAAO,CAAC,CAAC;AAJR,QAAA,oBAAoB,wBAIZ","sourcesContent":["import { getDeploySetting } from './getDeploySetting';\n\n/** A comma-separated deploy setting as a trimmed list, empty items dropped. Throws like `getDeploySetting` when unset. */\nexport const getDeploySettingList = (key: string): string[] =>\n  getDeploySetting(key)\n    .split(',')\n    .map((item) => item.trim())\n    .filter(Boolean);\n"]}

package/lib/commonjs/config/deploySettings/getDeploySettingOrDefault.d.ts

@@ -0,0 +1,2 @@
+/** A deploy setting from the selected deployment, or `fallback` when the deployment does not define it. */
+export declare const getDeploySettingOrDefault: (key: string, fallback: string) => string;

package/lib/commonjs/config/deploySettings/getDeploySettingOrDefault.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDeploySettingOrDefault = void 0;
+const getDeploySettingEnvName_1 = require("./getDeploySettingEnvName");
+/** A deploy setting from the selected deployment, or `fallback` when the deployment does not define it. */
+const getDeploySettingOrDefault = (key, fallback) => { var _a; return (_a = process.env[(0, getDeploySettingEnvName_1.getDeploySettingEnvName)(key)]) !== null && _a !== void 0 ? _a : fallback; };
+exports.getDeploySettingOrDefault = getDeploySettingOrDefault;
+//# sourceMappingURL=getDeploySettingOrDefault.js.map

package/lib/commonjs/config/deploySettings/getDeploySettingOrDefault.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDeploySettingOrDefault.js","sourceRoot":"","sources":["../../../../src/config/deploySettings/getDeploySettingOrDefault.ts"],"names":[],"mappings":";;;AAAA,uEAAoE;AAEpE,2GAA2G;AACpG,MAAM,yBAAyB,GAAG,CAAC,GAAW,EAAE,QAAgB,EAAU,EAAE,WAAC,OAAA,MAAA,OAAO,CAAC,GAAG,CAAC,IAAA,iDAAuB,EAAC,GAAG,CAAC,CAAC,mCAAI,QAAQ,CAAA,EAAA,CAAC;AAA7H,QAAA,yBAAyB,6BAAoG","sourcesContent":["import { getDeploySettingEnvName } from './getDeploySettingEnvName';\n\n/** A deploy setting from the selected deployment, or `fallback` when the deployment does not define it. */\nexport const getDeploySettingOrDefault = (key: string, fallback: string): string => process.env[getDeploySettingEnvName(key)] ?? fallback;\n"]}

package/lib/commonjs/config/deploySettings/index.d.ts

@@ -0,0 +1,5 @@
+export * from './DEPLOY_SETTING_ENV_PREFIX';
+export * from './getDeploySetting';
+export * from './getDeploySettingEnvName';
+export * from './getDeploySettingList';
+export * from './getDeploySettingOrDefault';

package/lib/commonjs/config/deploySettings/index.js

@@ -0,0 +1,22 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./DEPLOY_SETTING_ENV_PREFIX"), exports);
+__exportStar(require("./getDeploySetting"), exports);
+__exportStar(require("./getDeploySettingEnvName"), exports);
+__exportStar(require("./getDeploySettingList"), exports);
+__exportStar(require("./getDeploySettingOrDefault"), exports);
+//# sourceMappingURL=index.js.map

package/lib/commonjs/config/deploySettings/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/config/deploySettings/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8DAA4C;AAC5C,qDAAmC;AACnC,4DAA0C;AAC1C,yDAAuC;AACvC,8DAA4C","sourcesContent":["export * from './DEPLOY_SETTING_ENV_PREFIX';\nexport * from './getDeploySetting';\nexport * from './getDeploySettingEnvName';\nexport * from './getDeploySettingList';\nexport * from './getDeploySettingOrDefault';\n"]}

package/lib/commonjs/config/index.d.ts

@@ -1,3 +1,4 @@
+export * from './deploySettings';
 export * from './QPQConfig';
 export * from './settings';
 export * from './utils';

package/lib/commonjs/config/index.js

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./deploySettings"), exports);
 __exportStar(require("./QPQConfig"), exports);
 __exportStar(require("./settings"), exports);
 __exportStar(require("./utils"), exports);

package/lib/commonjs/config/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,6CAA2B;AAC3B,0CAAwB","sourcesContent":["export * from './QPQConfig';\nexport * from './settings';\nexport * from './utils';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAiC;AACjC,8CAA4B;AAC5B,6CAA2B;AAC3B,0CAAwB","sourcesContent":["export * from './deploySettings';\nexport * from './QPQConfig';\nexport * from './settings';\nexport * from './utils';\n"]}

package/lib/commonjs/deployment/QpqAppDeployConfig.d.ts

@@ -0,0 +1,10 @@
+import { QpqAppDeployment } from './QpqAppDeployment';
+/**
+ * apps/<app>/deploy.config.json: the single source of truth for where and as what
+ * an app deploys. Kept as JSON so tooling can read it before any TS executes. Nothing
+ * in it is overridden by env vars or flags; to change a value, change the file or add
+ * an entry. Holds identity and settings only, never credentials.
+ */
+export type QpqAppDeployConfig = {
+    deployments: Record<string, QpqAppDeployment>;
+};

package/lib/commonjs/deployment/QpqAppDeployConfig.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=QpqAppDeployConfig.js.map

package/lib/commonjs/deployment/QpqAppDeployConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QpqAppDeployConfig.js","sourceRoot":"","sources":["../../../src/deployment/QpqAppDeployConfig.ts"],"names":[],"mappings":"","sourcesContent":["import { QpqAppDeployment } from './QpqAppDeployment';\n\n/**\n * apps/<app>/deploy.config.json: the single source of truth for where and as what\n * an app deploys. Kept as JSON so tooling can read it before any TS executes. Nothing\n * in it is overridden by env vars or flags; to change a value, change the file or add\n * an entry. Holds identity and settings only, never credentials.\n */\nexport type QpqAppDeployConfig = {\n  // deployment name -> target. The name is what `qpq go --deployment <name>` selects.\n  deployments: Record<string, QpqAppDeployment>;\n};\n"]}

package/lib/commonjs/deployment/QpqAppDeploySettings.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Per-deployment values handed to infrastructure.ts as `DEPLOY_SETTING_<key>` env vars
+ * (read them with `getDeploySetting` from quidproquo-core). Keys are used verbatim as
+ * the env var suffix, values are always strings. Committed in cleartext: never a secret.
+ */
+export type QpqAppDeploySettings = Record<string, string>;

package/lib/commonjs/deployment/QpqAppDeploySettings.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=QpqAppDeploySettings.js.map

package/lib/commonjs/deployment/QpqAppDeploySettings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QpqAppDeploySettings.js","sourceRoot":"","sources":["../../../src/deployment/QpqAppDeploySettings.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Per-deployment values handed to infrastructure.ts as `DEPLOY_SETTING_<key>` env vars\n * (read them with `getDeploySetting` from quidproquo-core). Keys are used verbatim as\n * the env var suffix, values are always strings. Committed in cleartext: never a secret.\n */\nexport type QpqAppDeploySettings = Record<string, string>;\n"]}

package/lib/commonjs/deployment/QpqAppDeployment.d.ts

@@ -0,0 +1,11 @@
+import { QpqAppDeploymentBase } from './QpqAppDeploymentBase';
+/**
+ * One entry under `deployments` in apps/<app>/deploy.config.json. `platform` names the
+ * CLI driver; `platformSettings` is a flat string map, like `settings`, whose required
+ * keys each platform checks for itself (quidproquo-config-aws for aws), so this layer
+ * stays open to platforms it has never heard of.
+ */
+export type QpqAppDeployment = QpqAppDeploymentBase & {
+    platform: string;
+    platformSettings?: Record<string, string>;
+};

package/lib/commonjs/deployment/QpqAppDeployment.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=QpqAppDeployment.js.map

package/lib/commonjs/deployment/QpqAppDeployment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QpqAppDeployment.js","sourceRoot":"","sources":["../../../src/deployment/QpqAppDeployment.ts"],"names":[],"mappings":"","sourcesContent":["import { QpqAppDeploymentBase } from './QpqAppDeploymentBase';\n\n/**\n * One entry under `deployments` in apps/<app>/deploy.config.json. `platform` names the\n * CLI driver; `platformSettings` is a flat string map, like `settings`, whose required\n * keys each platform checks for itself (quidproquo-config-aws for aws), so this layer\n * stays open to platforms it has never heard of.\n */\nexport type QpqAppDeployment = QpqAppDeploymentBase & {\n  platform: string;\n  platformSettings?: Record<string, string>;\n};\n"]}

package/lib/commonjs/deployment/QpqAppDeploymentBase.d.ts

@@ -0,0 +1,8 @@
+import { QpqAppDeploySettings } from './QpqAppDeploySettings';
+/** The identity every deployment carries, whatever platform it targets. */
+export type QpqAppDeploymentBase = {
+    name: string;
+    environment: string;
+    feature?: string;
+    settings?: QpqAppDeploySettings;
+};

package/lib/commonjs/deployment/QpqAppDeploymentBase.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=QpqAppDeploymentBase.js.map

package/lib/commonjs/deployment/QpqAppDeploymentBase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QpqAppDeploymentBase.js","sourceRoot":"","sources":["../../../src/deployment/QpqAppDeploymentBase.ts"],"names":[],"mappings":"","sourcesContent":["import { QpqAppDeploySettings } from './QpqAppDeploySettings';\n\n/** The identity every deployment carries, whatever platform it targets. */\nexport type QpqAppDeploymentBase = {\n  // Application name: prefixes every stack and resource, so two deployments of one\n  // codebase with different names (say two products built from one repo) never share anything.\n  name: string;\n\n  environment: string;\n\n  // Optional feature/actor suffix for a personal or feature-branch stack set.\n  feature?: string;\n\n  settings?: QpqAppDeploySettings;\n};\n"]}

package/lib/commonjs/deployment/QpqDeployEnvVar.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The env vars a selected deployment is delivered through. Service configs and deploy
+ * tooling read these at load time, so they are primed before any infrastructure.ts is
+ * required. Platform identity vars are declared by the platform (see quidproquo-config-aws).
+ */
+export declare enum QpqDeployEnvVar {
+    deployAppName = "DEPLOY_APP_NAME",
+    deployName = "DEPLOY_NAME",
+    applicationName = "APPLICATION_NAME",
+    environment = "ENVIRONMENT",
+    featureName = "FEATURE_NAME"
+}

package/lib/commonjs/deployment/QpqDeployEnvVar.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QpqDeployEnvVar = void 0;
+/**
+ * The env vars a selected deployment is delivered through. Service configs and deploy
+ * tooling read these at load time, so they are primed before any infrastructure.ts is
+ * required. Platform identity vars are declared by the platform (see quidproquo-config-aws).
+ */
+var QpqDeployEnvVar;
+(function (QpqDeployEnvVar) {
+    // The app folder under apps/ and the deployment name within its deploy.config.json.
+    QpqDeployEnvVar["deployAppName"] = "DEPLOY_APP_NAME";
+    QpqDeployEnvVar["deployName"] = "DEPLOY_NAME";
+    QpqDeployEnvVar["applicationName"] = "APPLICATION_NAME";
+    QpqDeployEnvVar["environment"] = "ENVIRONMENT";
+    QpqDeployEnvVar["featureName"] = "FEATURE_NAME";
+})(QpqDeployEnvVar || (exports.QpqDeployEnvVar = QpqDeployEnvVar = {}));
+//# sourceMappingURL=QpqDeployEnvVar.js.map

package/lib/commonjs/deployment/QpqDeployEnvVar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QpqDeployEnvVar.js","sourceRoot":"","sources":["../../../src/deployment/QpqDeployEnvVar.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,IAAY,eAQX;AARD,WAAY,eAAe;IACzB,oFAAoF;IACpF,oDAAiC,CAAA;IACjC,6CAA0B,CAAA;IAE1B,uDAAoC,CAAA;IACpC,8CAA2B,CAAA;IAC3B,+CAA4B,CAAA;AAC9B,CAAC,EARW,eAAe,+BAAf,eAAe,QAQ1B","sourcesContent":["/**\n * The env vars a selected deployment is delivered through. Service configs and deploy\n * tooling read these at load time, so they are primed before any infrastructure.ts is\n * required. Platform identity vars are declared by the platform (see quidproquo-config-aws).\n */\nexport enum QpqDeployEnvVar {\n  // The app folder under apps/ and the deployment name within its deploy.config.json.\n  deployAppName = 'DEPLOY_APP_NAME',\n  deployName = 'DEPLOY_NAME',\n\n  applicationName = 'APPLICATION_NAME',\n  environment = 'ENVIRONMENT',\n  featureName = 'FEATURE_NAME',\n}\n"]}

package/lib/commonjs/deployment/index.d.ts

@@ -0,0 +1,5 @@
+export * from './QpqAppDeployConfig';
+export * from './QpqAppDeployment';
+export * from './QpqAppDeploymentBase';
+export * from './QpqAppDeploySettings';
+export * from './QpqDeployEnvVar';

package/lib/commonjs/deployment/index.js

@@ -0,0 +1,22 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./QpqAppDeployConfig"), exports);
+__exportStar(require("./QpqAppDeployment"), exports);
+__exportStar(require("./QpqAppDeploymentBase"), exports);
+__exportStar(require("./QpqAppDeploySettings"), exports);
+__exportStar(require("./QpqDeployEnvVar"), exports);
+//# sourceMappingURL=index.js.map

package/lib/commonjs/deployment/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/deployment/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,qDAAmC;AACnC,yDAAuC;AACvC,yDAAuC;AACvC,oDAAkC","sourcesContent":["export * from './QpqAppDeployConfig';\nexport * from './QpqAppDeployment';\nexport * from './QpqAppDeploymentBase';\nexport * from './QpqAppDeploySettings';\nexport * from './QpqDeployEnvVar';\n"]}

package/lib/commonjs/index.d.ts

@@ -2,6 +2,7 @@ export * from './actions';
 export * from './config';
 export * from './constants';
 export * from './createImplementationRuntime';
+export * from './deployment';
 export * from './logic';
 export * from './logic/actionLogic';
 export * from './proiseify';

package/lib/commonjs/index.js

@@ -18,6 +18,7 @@ __exportStar(require("./actions"), exports);
 __exportStar(require("./config"), exports);
 __exportStar(require("./constants"), exports);
 __exportStar(require("./createImplementationRuntime"), exports);
+__exportStar(require("./deployment"), exports);
 __exportStar(require("./logic"), exports);
 __exportStar(require("./logic/actionLogic"), exports);
 __exportStar(require("./proiseify"), exports);

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,2CAAyB;AACzB,8CAA4B;AAC5B,gEAA8C;AAC9C,0CAAwB;AACxB,sDAAoC;AACpC,8CAA4B;AAC5B,oDAAkC;AAClC,kDAAgC;AAChC,4CAA0B;AAC1B,4CAA0B;AAC1B,4CAA0B;AAC1B,0CAAwB;AACxB,0CAAwB;AACxB,+CAA6B","sourcesContent":["export * from './actions';\nexport * from './config';\nexport * from './constants';\nexport * from './createImplementationRuntime';\nexport * from './logic';\nexport * from './logic/actionLogic';\nexport * from './proiseify';\nexport * from './qpqCoreUtilsLib';\nexport * from './qpqExecuteLog';\nexport * from './runtime';\nexport * from './stories';\nexport * from './testing';\nexport * from './types';\nexport * from './utils';\nexport * from './validators';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,2CAAyB;AACzB,8CAA4B;AAC5B,gEAA8C;AAC9C,+CAA6B;AAC7B,0CAAwB;AACxB,sDAAoC;AACpC,8CAA4B;AAC5B,oDAAkC;AAClC,kDAAgC;AAChC,4CAA0B;AAC1B,4CAA0B;AAC1B,4CAA0B;AAC1B,0CAAwB;AACxB,0CAAwB;AACxB,+CAA6B","sourcesContent":["export * from './actions';\nexport * from './config';\nexport * from './constants';\nexport * from './createImplementationRuntime';\nexport * from './deployment';\nexport * from './logic';\nexport * from './logic/actionLogic';\nexport * from './proiseify';\nexport * from './qpqCoreUtilsLib';\nexport * from './qpqExecuteLog';\nexport * from './runtime';\nexport * from './stories';\nexport * from './testing';\nexport * from './types';\nexport * from './utils';\nexport * from './validators';\n"]}

package/lib/commonjs/utils/uuid/generateUuid.d.ts

@@ -1,12 +1,16 @@
 /**
  * Generates a new random (version 4) UUID.
  *
- * This is the single place in quidproquo to mint a v4 UUID. It uses the native
- * `crypto.randomUUID()` which is available in Node 20+ and all modern browsers
- * (secure contexts), so it works across both backend and frontend packages with
- * no external dependency. Centralising it here means the underlying source can be
- * swapped in one spot if that ever changes.
+ * This is the single place in quidproquo to mint a v4 UUID, so it works across
+ * both backend and frontend packages with no external dependency.
+ *
+ * It prefers the native `crypto.randomUUID()` (Node 20+, and browsers in a
+ * SECURE context: https or localhost). Browsers deliberately hide that method on
+ * plain-http origins, which is exactly where a self-hosted app on a LAN ip lives
+ * (e.g. http://192.168.x.x), so it falls back to assembling the same v4 layout
+ * from `crypto.getRandomValues()`, which is available everywhere.
  *
  * @returns {string} A randomly generated v4 UUID, e.g. `109156be-c4fb-41ea-b1b4-efe1671c5836`.
  */
 export declare function generateUuid(): string;
+export declare function generateUuidFromRandomValues(cryptoApi: Pick<Crypto, 'getRandomValues'>): string;

package/lib/commonjs/utils/uuid/generateUuid.js

@@ -1,18 +1,40 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateUuid = generateUuid;
+exports.generateUuidFromRandomValues = generateUuidFromRandomValues;
 /**
  * Generates a new random (version 4) UUID.
  *
- * This is the single place in quidproquo to mint a v4 UUID. It uses the native
- * `crypto.randomUUID()` which is available in Node 20+ and all modern browsers
- * (secure contexts), so it works across both backend and frontend packages with
- * no external dependency. Centralising it here means the underlying source can be
- * swapped in one spot if that ever changes.
+ * This is the single place in quidproquo to mint a v4 UUID, so it works across
+ * both backend and frontend packages with no external dependency.
+ *
+ * It prefers the native `crypto.randomUUID()` (Node 20+, and browsers in a
+ * SECURE context: https or localhost). Browsers deliberately hide that method on
+ * plain-http origins, which is exactly where a self-hosted app on a LAN ip lives
+ * (e.g. http://192.168.x.x), so it falls back to assembling the same v4 layout
+ * from `crypto.getRandomValues()`, which is available everywhere.
  *
  * @returns {string} A randomly generated v4 UUID, e.g. `109156be-c4fb-41ea-b1b4-efe1671c5836`.
  */
 function generateUuid() {
-    return globalThis.crypto.randomUUID();
+    // lib.dom types the global as always present; older runtimes (Node before 19,
+    // some workers) don't expose it, so treat it as optional and fail loudly. No
+    // Math.random() last resort: a guessable id is worse than no id.
+    const cryptoApi = globalThis.crypto;
+    if (typeof (cryptoApi === null || cryptoApi === void 0 ? void 0 : cryptoApi.randomUUID) === 'function') {
+        return cryptoApi.randomUUID();
+    }
+    if (typeof (cryptoApi === null || cryptoApi === void 0 ? void 0 : cryptoApi.getRandomValues) !== 'function') {
+        throw new Error('generateUuid: no Web Crypto API available in this environment');
+    }
+    return generateUuidFromRandomValues(cryptoApi);
+}
+// RFC 4122 v4 from 16 random bytes: version nibble 4 in byte 6, variant 10xx in byte 8.
+function generateUuidFromRandomValues(cryptoApi) {
+    const bytes = cryptoApi.getRandomValues(new Uint8Array(16));
+    bytes[6] = (bytes[6] & 0x0f) | 0x40;
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    const hex = Array.from(bytes, (byte) => byte.toString(16).padStart(2, '0')).join('');
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
 }
 //# sourceMappingURL=generateUuid.js.map

package/lib/commonjs/utils/uuid/generateUuid.js.map

@@ -1 +1 @@
-{"version":3,"file":"generateUuid.js","sourceRoot":"","sources":["../../../../src/utils/uuid/generateUuid.ts"],"names":[],"mappings":";;AAWA,oCAEC;AAbD;;;;;;;;;;GAUG;AACH,SAAgB,YAAY;IAC1B,OAAO,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;AACxC,CAAC","sourcesContent":["/**\n * Generates a new random (version 4) UUID.\n *\n * This is the single place in quidproquo to mint a v4 UUID. It uses the native\n * `crypto.randomUUID()` which is available in Node 20+ and all modern browsers\n * (secure contexts), so it works across both backend and frontend packages with\n * no external dependency. Centralising it here means the underlying source can be\n * swapped in one spot if that ever changes.\n *\n * @returns {string} A randomly generated v4 UUID, e.g. `109156be-c4fb-41ea-b1b4-efe1671c5836`.\n */\nexport function generateUuid(): string {\n  return globalThis.crypto.randomUUID();\n}\n"]}
+{"version":3,"file":"generateUuid.js","sourceRoot":"","sources":["../../../../src/utils/uuid/generateUuid.ts"],"names":[],"mappings":";;AAcA,oCAeC;AAGD,oEASC;AAzCD;;;;;;;;;;;;;GAaG;AACH,SAAgB,YAAY;IAC1B,8EAA8E;IAC9E,6EAA6E;IAC7E,iEAAiE;IACjE,MAAM,SAAS,GAAG,UAAU,CAAC,MAA4B,CAAC;IAE1D,IAAI,OAAO,CAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,UAAU,CAAA,KAAK,UAAU,EAAE,CAAC;QAChD,OAAO,SAAS,CAAC,UAAU,EAAE,CAAC;IAChC,CAAC;IAED,IAAI,OAAO,CAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,eAAe,CAAA,KAAK,UAAU,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IAED,OAAO,4BAA4B,CAAC,SAAS,CAAC,CAAC;AACjD,CAAC;AAED,wFAAwF;AACxF,SAAgB,4BAA4B,CAAC,SAA0C;IACrF,MAAM,KAAK,GAAG,SAAS,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;IAE5D,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IACpC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAEpC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAErF,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;AAC7G,CAAC","sourcesContent":["/**\n * Generates a new random (version 4) UUID.\n *\n * This is the single place in quidproquo to mint a v4 UUID, so it works across\n * both backend and frontend packages with no external dependency.\n *\n * It prefers the native `crypto.randomUUID()` (Node 20+, and browsers in a\n * SECURE context: https or localhost). Browsers deliberately hide that method on\n * plain-http origins, which is exactly where a self-hosted app on a LAN ip lives\n * (e.g. http://192.168.x.x), so it falls back to assembling the same v4 layout\n * from `crypto.getRandomValues()`, which is available everywhere.\n *\n * @returns {string} A randomly generated v4 UUID, e.g. `109156be-c4fb-41ea-b1b4-efe1671c5836`.\n */\nexport function generateUuid(): string {\n  // lib.dom types the global as always present; older runtimes (Node before 19,\n  // some workers) don't expose it, so treat it as optional and fail loudly. No\n  // Math.random() last resort: a guessable id is worse than no id.\n  const cryptoApi = globalThis.crypto as Crypto | undefined;\n\n  if (typeof cryptoApi?.randomUUID === 'function') {\n    return cryptoApi.randomUUID();\n  }\n\n  if (typeof cryptoApi?.getRandomValues !== 'function') {\n    throw new Error('generateUuid: no Web Crypto API available in this environment');\n  }\n\n  return generateUuidFromRandomValues(cryptoApi);\n}\n\n// RFC 4122 v4 from 16 random bytes: version nibble 4 in byte 6, variant 10xx in byte 8.\nexport function generateUuidFromRandomValues(cryptoApi: Pick<Crypto, 'getRandomValues'>): string {\n  const bytes = cryptoApi.getRandomValues(new Uint8Array(16));\n\n  bytes[6] = (bytes[6] & 0x0f) | 0x40;\n  bytes[8] = (bytes[8] & 0x3f) | 0x80;\n\n  const hex = Array.from(bytes, (byte) => byte.toString(16).padStart(2, '0')).join('');\n\n  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;\n}\n"]}

package/lib/esm/config/deploySettings/DEPLOY_SETTING_ENV_PREFIX.d.ts

@@ -0,0 +1,2 @@
+/** Prefix on the env var each deploy setting is delivered through. */
+export declare const DEPLOY_SETTING_ENV_PREFIX = "DEPLOY_SETTING_";

package/lib/esm/config/deploySettings/DEPLOY_SETTING_ENV_PREFIX.js

@@ -0,0 +1,3 @@
+/** Prefix on the env var each deploy setting is delivered through. */
+export const DEPLOY_SETTING_ENV_PREFIX = 'DEPLOY_SETTING_';
+//# sourceMappingURL=DEPLOY_SETTING_ENV_PREFIX.js.map

package/lib/esm/config/deploySettings/DEPLOY_SETTING_ENV_PREFIX.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DEPLOY_SETTING_ENV_PREFIX.js","sourceRoot":"","sources":["../../../../src/config/deploySettings/DEPLOY_SETTING_ENV_PREFIX.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,MAAM,CAAC,MAAM,yBAAyB,GAAG,iBAAiB,CAAC","sourcesContent":["/** Prefix on the env var each deploy setting is delivered through. */\nexport const DEPLOY_SETTING_ENV_PREFIX = 'DEPLOY_SETTING_';\n"]}

package/lib/esm/config/deploySettings/getDeploySetting.d.ts

@@ -0,0 +1,6 @@
+/**
+ * A deploy setting from the selected deployment's `settings` in deploy.config.json,
+ * for use in infrastructure.ts and config helpers. Throws when the setting is not
+ * defined, so a typo can't deploy an empty value.
+ */
+export declare const getDeploySetting: (key: string) => string;

package/lib/esm/config/deploySettings/getDeploySetting.js

@@ -0,0 +1,14 @@
+import { getDeploySettingEnvName } from './getDeploySettingEnvName';
+/**
+ * A deploy setting from the selected deployment's `settings` in deploy.config.json,
+ * for use in infrastructure.ts and config helpers. Throws when the setting is not
+ * defined, so a typo can't deploy an empty value.
+ */
+export const getDeploySetting = (key) => {
+    const value = process.env[getDeploySettingEnvName(key)];
+    if (value === undefined) {
+        throw new Error(`Deploy setting '${key}' is not defined. Add it to the deployment's "settings" in deploy.config.json.`);
+    }
+    return value;
+};
+//# sourceMappingURL=getDeploySetting.js.map

package/lib/esm/config/deploySettings/getDeploySetting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDeploySetting.js","sourceRoot":"","sources":["../../../../src/config/deploySettings/getDeploySetting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,GAAW,EAAU,EAAE;IACtD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC;IAExD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,gFAAgF,CAAC,CAAC;IAC1H,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC","sourcesContent":["import { getDeploySettingEnvName } from './getDeploySettingEnvName';\n\n/**\n * A deploy setting from the selected deployment's `settings` in deploy.config.json,\n * for use in infrastructure.ts and config helpers. Throws when the setting is not\n * defined, so a typo can't deploy an empty value.\n */\nexport const getDeploySetting = (key: string): string => {\n  const value = process.env[getDeploySettingEnvName(key)];\n\n  if (value === undefined) {\n    throw new Error(`Deploy setting '${key}' is not defined. Add it to the deployment's \"settings\" in deploy.config.json.`);\n  }\n\n  return value;\n};\n"]}

package/lib/esm/config/deploySettings/getDeploySettingEnvName.d.ts

@@ -0,0 +1,2 @@
+/** The env var that carries the deploy setting `key` (the key is used verbatim, no case conversion). */
+export declare const getDeploySettingEnvName: (key: string) => string;

package/lib/esm/config/deploySettings/getDeploySettingEnvName.js

@@ -0,0 +1,4 @@
+import { DEPLOY_SETTING_ENV_PREFIX } from './DEPLOY_SETTING_ENV_PREFIX';
+/** The env var that carries the deploy setting `key` (the key is used verbatim, no case conversion). */
+export const getDeploySettingEnvName = (key) => `${DEPLOY_SETTING_ENV_PREFIX}${key}`;
+//# sourceMappingURL=getDeploySettingEnvName.js.map

package/lib/esm/config/deploySettings/getDeploySettingEnvName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDeploySettingEnvName.js","sourceRoot":"","sources":["../../../../src/config/deploySettings/getDeploySettingEnvName.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAExE,wGAAwG;AACxG,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,GAAG,yBAAyB,GAAG,GAAG,EAAE,CAAC","sourcesContent":["import { DEPLOY_SETTING_ENV_PREFIX } from './DEPLOY_SETTING_ENV_PREFIX';\n\n/** The env var that carries the deploy setting `key` (the key is used verbatim, no case conversion). */\nexport const getDeploySettingEnvName = (key: string): string => `${DEPLOY_SETTING_ENV_PREFIX}${key}`;\n"]}

package/lib/esm/config/deploySettings/getDeploySettingList.d.ts

@@ -0,0 +1,2 @@
+/** A comma-separated deploy setting as a trimmed list, empty items dropped. Throws like `getDeploySetting` when unset. */
+export declare const getDeploySettingList: (key: string) => string[];

package/lib/esm/config/deploySettings/getDeploySettingList.js

@@ -0,0 +1,7 @@
+import { getDeploySetting } from './getDeploySetting';
+/** A comma-separated deploy setting as a trimmed list, empty items dropped. Throws like `getDeploySetting` when unset. */
+export const getDeploySettingList = (key) => getDeploySetting(key)
+    .split(',')
+    .map((item) => item.trim())
+    .filter(Boolean);
+//# sourceMappingURL=getDeploySettingList.js.map

package/lib/esm/config/deploySettings/getDeploySettingList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDeploySettingList.js","sourceRoot":"","sources":["../../../../src/config/deploySettings/getDeploySettingList.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,0HAA0H;AAC1H,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,GAAW,EAAY,EAAE,CAC5D,gBAAgB,CAAC,GAAG,CAAC;KAClB,KAAK,CAAC,GAAG,CAAC;KACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;KAC1B,MAAM,CAAC,OAAO,CAAC,CAAC","sourcesContent":["import { getDeploySetting } from './getDeploySetting';\n\n/** A comma-separated deploy setting as a trimmed list, empty items dropped. Throws like `getDeploySetting` when unset. */\nexport const getDeploySettingList = (key: string): string[] =>\n  getDeploySetting(key)\n    .split(',')\n    .map((item) => item.trim())\n    .filter(Boolean);\n"]}

package/lib/esm/config/deploySettings/getDeploySettingOrDefault.d.ts

@@ -0,0 +1,2 @@
+/** A deploy setting from the selected deployment, or `fallback` when the deployment does not define it. */
+export declare const getDeploySettingOrDefault: (key: string, fallback: string) => string;

package/lib/esm/config/deploySettings/getDeploySettingOrDefault.js

@@ -0,0 +1,4 @@
+import { getDeploySettingEnvName } from './getDeploySettingEnvName';
+/** A deploy setting from the selected deployment, or `fallback` when the deployment does not define it. */
+export const getDeploySettingOrDefault = (key, fallback) => process.env[getDeploySettingEnvName(key)] ?? fallback;
+//# sourceMappingURL=getDeploySettingOrDefault.js.map

package/lib/esm/config/deploySettings/getDeploySettingOrDefault.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDeploySettingOrDefault.js","sourceRoot":"","sources":["../../../../src/config/deploySettings/getDeploySettingOrDefault.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,2GAA2G;AAC3G,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,GAAW,EAAE,QAAgB,EAAU,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC,IAAI,QAAQ,CAAC","sourcesContent":["import { getDeploySettingEnvName } from './getDeploySettingEnvName';\n\n/** A deploy setting from the selected deployment, or `fallback` when the deployment does not define it. */\nexport const getDeploySettingOrDefault = (key: string, fallback: string): string => process.env[getDeploySettingEnvName(key)] ?? fallback;\n"]}

package/lib/esm/config/deploySettings/index.d.ts

@@ -0,0 +1,5 @@
+export * from './DEPLOY_SETTING_ENV_PREFIX';
+export * from './getDeploySetting';
+export * from './getDeploySettingEnvName';
+export * from './getDeploySettingList';
+export * from './getDeploySettingOrDefault';

package/lib/esm/config/deploySettings/index.js

@@ -0,0 +1,6 @@
+export * from './DEPLOY_SETTING_ENV_PREFIX';
+export * from './getDeploySetting';
+export * from './getDeploySettingEnvName';
+export * from './getDeploySettingList';
+export * from './getDeploySettingOrDefault';
+//# sourceMappingURL=index.js.map

package/lib/esm/config/deploySettings/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/config/deploySettings/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC","sourcesContent":["export * from './DEPLOY_SETTING_ENV_PREFIX';\nexport * from './getDeploySetting';\nexport * from './getDeploySettingEnvName';\nexport * from './getDeploySettingList';\nexport * from './getDeploySettingOrDefault';\n"]}

package/lib/esm/config/index.d.ts

@@ -1,3 +1,4 @@
+export * from './deploySettings';
 export * from './QPQConfig';
 export * from './settings';
 export * from './utils';

package/lib/esm/config/index.js

@@ -1,3 +1,4 @@
+export * from './deploySettings';
 export * from './QPQConfig';
 export * from './settings';
 export * from './utils';

package/lib/esm/config/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC","sourcesContent":["export * from './QPQConfig';\nexport * from './settings';\nexport * from './utils';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC","sourcesContent":["export * from './deploySettings';\nexport * from './QPQConfig';\nexport * from './settings';\nexport * from './utils';\n"]}

package/lib/esm/deployment/QpqAppDeployConfig.d.ts

@@ -0,0 +1,10 @@
+import { QpqAppDeployment } from './QpqAppDeployment';
+/**
+ * apps/<app>/deploy.config.json: the single source of truth for where and as what
+ * an app deploys. Kept as JSON so tooling can read it before any TS executes. Nothing
+ * in it is overridden by env vars or flags; to change a value, change the file or add
+ * an entry. Holds identity and settings only, never credentials.
+ */
+export type QpqAppDeployConfig = {
+    deployments: Record<string, QpqAppDeployment>;
+};

package/lib/esm/deployment/QpqAppDeployConfig.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=QpqAppDeployConfig.js.map

package/lib/esm/deployment/QpqAppDeployConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QpqAppDeployConfig.js","sourceRoot":"","sources":["../../../src/deployment/QpqAppDeployConfig.ts"],"names":[],"mappings":"","sourcesContent":["import { QpqAppDeployment } from './QpqAppDeployment';\n\n/**\n * apps/<app>/deploy.config.json: the single source of truth for where and as what\n * an app deploys. Kept as JSON so tooling can read it before any TS executes. Nothing\n * in it is overridden by env vars or flags; to change a value, change the file or add\n * an entry. Holds identity and settings only, never credentials.\n */\nexport type QpqAppDeployConfig = {\n  // deployment name -> target. The name is what `qpq go --deployment <name>` selects.\n  deployments: Record<string, QpqAppDeployment>;\n};\n"]}

package/lib/esm/deployment/QpqAppDeploySettings.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Per-deployment values handed to infrastructure.ts as `DEPLOY_SETTING_<key>` env vars
+ * (read them with `getDeploySetting` from quidproquo-core). Keys are used verbatim as
+ * the env var suffix, values are always strings. Committed in cleartext: never a secret.
+ */
+export type QpqAppDeploySettings = Record<string, string>;

package/lib/esm/deployment/QpqAppDeploySettings.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=QpqAppDeploySettings.js.map

package/lib/esm/deployment/QpqAppDeploySettings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QpqAppDeploySettings.js","sourceRoot":"","sources":["../../../src/deployment/QpqAppDeploySettings.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Per-deployment values handed to infrastructure.ts as `DEPLOY_SETTING_<key>` env vars\n * (read them with `getDeploySetting` from quidproquo-core). Keys are used verbatim as\n * the env var suffix, values are always strings. Committed in cleartext: never a secret.\n */\nexport type QpqAppDeploySettings = Record<string, string>;\n"]}

package/lib/esm/deployment/QpqAppDeployment.d.ts

@@ -0,0 +1,11 @@
+import { QpqAppDeploymentBase } from './QpqAppDeploymentBase';
+/**
+ * One entry under `deployments` in apps/<app>/deploy.config.json. `platform` names the
+ * CLI driver; `platformSettings` is a flat string map, like `settings`, whose required
+ * keys each platform checks for itself (quidproquo-config-aws for aws), so this layer
+ * stays open to platforms it has never heard of.
+ */
+export type QpqAppDeployment = QpqAppDeploymentBase & {
+    platform: string;
+    platformSettings?: Record<string, string>;
+};

package/lib/esm/deployment/QpqAppDeployment.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=QpqAppDeployment.js.map

package/lib/esm/deployment/QpqAppDeployment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QpqAppDeployment.js","sourceRoot":"","sources":["../../../src/deployment/QpqAppDeployment.ts"],"names":[],"mappings":"","sourcesContent":["import { QpqAppDeploymentBase } from './QpqAppDeploymentBase';\n\n/**\n * One entry under `deployments` in apps/<app>/deploy.config.json. `platform` names the\n * CLI driver; `platformSettings` is a flat string map, like `settings`, whose required\n * keys each platform checks for itself (quidproquo-config-aws for aws), so this layer\n * stays open to platforms it has never heard of.\n */\nexport type QpqAppDeployment = QpqAppDeploymentBase & {\n  platform: string;\n  platformSettings?: Record<string, string>;\n};\n"]}

package/lib/esm/deployment/QpqAppDeploymentBase.d.ts

@@ -0,0 +1,8 @@
+import { QpqAppDeploySettings } from './QpqAppDeploySettings';
+/** The identity every deployment carries, whatever platform it targets. */
+export type QpqAppDeploymentBase = {
+    name: string;
+    environment: string;
+    feature?: string;
+    settings?: QpqAppDeploySettings;
+};

package/lib/esm/deployment/QpqAppDeploymentBase.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=QpqAppDeploymentBase.js.map

package/lib/esm/deployment/QpqAppDeploymentBase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QpqAppDeploymentBase.js","sourceRoot":"","sources":["../../../src/deployment/QpqAppDeploymentBase.ts"],"names":[],"mappings":"","sourcesContent":["import { QpqAppDeploySettings } from './QpqAppDeploySettings';\n\n/** The identity every deployment carries, whatever platform it targets. */\nexport type QpqAppDeploymentBase = {\n  // Application name: prefixes every stack and resource, so two deployments of one\n  // codebase with different names (say two products built from one repo) never share anything.\n  name: string;\n\n  environment: string;\n\n  // Optional feature/actor suffix for a personal or feature-branch stack set.\n  feature?: string;\n\n  settings?: QpqAppDeploySettings;\n};\n"]}

package/lib/esm/deployment/QpqDeployEnvVar.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The env vars a selected deployment is delivered through. Service configs and deploy
+ * tooling read these at load time, so they are primed before any infrastructure.ts is
+ * required. Platform identity vars are declared by the platform (see quidproquo-config-aws).
+ */
+export declare enum QpqDeployEnvVar {
+    deployAppName = "DEPLOY_APP_NAME",
+    deployName = "DEPLOY_NAME",
+    applicationName = "APPLICATION_NAME",
+    environment = "ENVIRONMENT",
+    featureName = "FEATURE_NAME"
+}

package/lib/esm/deployment/QpqDeployEnvVar.js

@@ -0,0 +1,15 @@
+/**
+ * The env vars a selected deployment is delivered through. Service configs and deploy
+ * tooling read these at load time, so they are primed before any infrastructure.ts is
+ * required. Platform identity vars are declared by the platform (see quidproquo-config-aws).
+ */
+export var QpqDeployEnvVar;
+(function (QpqDeployEnvVar) {
+    // The app folder under apps/ and the deployment name within its deploy.config.json.
+    QpqDeployEnvVar["deployAppName"] = "DEPLOY_APP_NAME";
+    QpqDeployEnvVar["deployName"] = "DEPLOY_NAME";
+    QpqDeployEnvVar["applicationName"] = "APPLICATION_NAME";
+    QpqDeployEnvVar["environment"] = "ENVIRONMENT";
+    QpqDeployEnvVar["featureName"] = "FEATURE_NAME";
+})(QpqDeployEnvVar || (QpqDeployEnvVar = {}));
+//# sourceMappingURL=QpqDeployEnvVar.js.map

package/lib/esm/deployment/QpqDeployEnvVar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QpqDeployEnvVar.js","sourceRoot":"","sources":["../../../src/deployment/QpqDeployEnvVar.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAN,IAAY,eAQX;AARD,WAAY,eAAe;IACzB,oFAAoF;IACpF,oDAAiC,CAAA;IACjC,6CAA0B,CAAA;IAE1B,uDAAoC,CAAA;IACpC,8CAA2B,CAAA;IAC3B,+CAA4B,CAAA;AAC9B,CAAC,EARW,eAAe,KAAf,eAAe,QAQ1B","sourcesContent":["/**\n * The env vars a selected deployment is delivered through. Service configs and deploy\n * tooling read these at load time, so they are primed before any infrastructure.ts is\n * required. Platform identity vars are declared by the platform (see quidproquo-config-aws).\n */\nexport enum QpqDeployEnvVar {\n  // The app folder under apps/ and the deployment name within its deploy.config.json.\n  deployAppName = 'DEPLOY_APP_NAME',\n  deployName = 'DEPLOY_NAME',\n\n  applicationName = 'APPLICATION_NAME',\n  environment = 'ENVIRONMENT',\n  featureName = 'FEATURE_NAME',\n}\n"]}

package/lib/esm/deployment/index.d.ts

@@ -0,0 +1,5 @@
+export * from './QpqAppDeployConfig';
+export * from './QpqAppDeployment';
+export * from './QpqAppDeploymentBase';
+export * from './QpqAppDeploySettings';
+export * from './QpqDeployEnvVar';

package/lib/esm/deployment/index.js

@@ -0,0 +1,6 @@
+export * from './QpqAppDeployConfig';
+export * from './QpqAppDeployment';
+export * from './QpqAppDeploymentBase';
+export * from './QpqAppDeploySettings';
+export * from './QpqDeployEnvVar';
+//# sourceMappingURL=index.js.map

package/lib/esm/deployment/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/deployment/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC","sourcesContent":["export * from './QpqAppDeployConfig';\nexport * from './QpqAppDeployment';\nexport * from './QpqAppDeploymentBase';\nexport * from './QpqAppDeploySettings';\nexport * from './QpqDeployEnvVar';\n"]}

package/lib/esm/index.d.ts

@@ -2,6 +2,7 @@ export * from './actions';
 export * from './config';
 export * from './constants';
 export * from './createImplementationRuntime';
+export * from './deployment';
 export * from './logic';
 export * from './logic/actionLogic';
 export * from './proiseify';

package/lib/esm/index.js

@@ -2,6 +2,7 @@ export * from './actions';
 export * from './config';
 export * from './constants';
 export * from './createImplementationRuntime';
+export * from './deployment';
 export * from './logic';
 export * from './logic/actionLogic';
 export * from './proiseify';

package/lib/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,SAAS,CAAC;AACxB,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC","sourcesContent":["export * from './actions';\nexport * from './config';\nexport * from './constants';\nexport * from './createImplementationRuntime';\nexport * from './logic';\nexport * from './logic/actionLogic';\nexport * from './proiseify';\nexport * from './qpqCoreUtilsLib';\nexport * from './qpqExecuteLog';\nexport * from './runtime';\nexport * from './stories';\nexport * from './testing';\nexport * from './types';\nexport * from './utils';\nexport * from './validators';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC","sourcesContent":["export * from './actions';\nexport * from './config';\nexport * from './constants';\nexport * from './createImplementationRuntime';\nexport * from './deployment';\nexport * from './logic';\nexport * from './logic/actionLogic';\nexport * from './proiseify';\nexport * from './qpqCoreUtilsLib';\nexport * from './qpqExecuteLog';\nexport * from './runtime';\nexport * from './stories';\nexport * from './testing';\nexport * from './types';\nexport * from './utils';\nexport * from './validators';\n"]}

package/lib/esm/utils/uuid/generateUuid.d.ts

@@ -1,12 +1,16 @@
 /**
  * Generates a new random (version 4) UUID.
  *
- * This is the single place in quidproquo to mint a v4 UUID. It uses the native
- * `crypto.randomUUID()` which is available in Node 20+ and all modern browsers
- * (secure contexts), so it works across both backend and frontend packages with
- * no external dependency. Centralising it here means the underlying source can be
- * swapped in one spot if that ever changes.
+ * This is the single place in quidproquo to mint a v4 UUID, so it works across
+ * both backend and frontend packages with no external dependency.
+ *
+ * It prefers the native `crypto.randomUUID()` (Node 20+, and browsers in a
+ * SECURE context: https or localhost). Browsers deliberately hide that method on
+ * plain-http origins, which is exactly where a self-hosted app on a LAN ip lives
+ * (e.g. http://192.168.x.x), so it falls back to assembling the same v4 layout
+ * from `crypto.getRandomValues()`, which is available everywhere.
  *
  * @returns {string} A randomly generated v4 UUID, e.g. `109156be-c4fb-41ea-b1b4-efe1671c5836`.
  */
 export declare function generateUuid(): string;
+export declare function generateUuidFromRandomValues(cryptoApi: Pick<Crypto, 'getRandomValues'>): string;

package/lib/esm/utils/uuid/generateUuid.js

@@ -1,15 +1,36 @@
 /**
  * Generates a new random (version 4) UUID.
  *
- * This is the single place in quidproquo to mint a v4 UUID. It uses the native
- * `crypto.randomUUID()` which is available in Node 20+ and all modern browsers
- * (secure contexts), so it works across both backend and frontend packages with
- * no external dependency. Centralising it here means the underlying source can be
- * swapped in one spot if that ever changes.
+ * This is the single place in quidproquo to mint a v4 UUID, so it works across
+ * both backend and frontend packages with no external dependency.
+ *
+ * It prefers the native `crypto.randomUUID()` (Node 20+, and browsers in a
+ * SECURE context: https or localhost). Browsers deliberately hide that method on
+ * plain-http origins, which is exactly where a self-hosted app on a LAN ip lives
+ * (e.g. http://192.168.x.x), so it falls back to assembling the same v4 layout
+ * from `crypto.getRandomValues()`, which is available everywhere.
  *
  * @returns {string} A randomly generated v4 UUID, e.g. `109156be-c4fb-41ea-b1b4-efe1671c5836`.
  */
 export function generateUuid() {
-    return globalThis.crypto.randomUUID();
+    // lib.dom types the global as always present; older runtimes (Node before 19,
+    // some workers) don't expose it, so treat it as optional and fail loudly. No
+    // Math.random() last resort: a guessable id is worse than no id.
+    const cryptoApi = globalThis.crypto;
+    if (typeof cryptoApi?.randomUUID === 'function') {
+        return cryptoApi.randomUUID();
+    }
+    if (typeof cryptoApi?.getRandomValues !== 'function') {
+        throw new Error('generateUuid: no Web Crypto API available in this environment');
+    }
+    return generateUuidFromRandomValues(cryptoApi);
+}
+// RFC 4122 v4 from 16 random bytes: version nibble 4 in byte 6, variant 10xx in byte 8.
+export function generateUuidFromRandomValues(cryptoApi) {
+    const bytes = cryptoApi.getRandomValues(new Uint8Array(16));
+    bytes[6] = (bytes[6] & 0x0f) | 0x40;
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    const hex = Array.from(bytes, (byte) => byte.toString(16).padStart(2, '0')).join('');
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
 }
 //# sourceMappingURL=generateUuid.js.map

package/lib/esm/utils/uuid/generateUuid.js.map

@@ -1 +1 @@
-{"version":3,"file":"generateUuid.js","sourceRoot":"","sources":["../../../../src/utils/uuid/generateUuid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;AACxC,CAAC","sourcesContent":["/**\n * Generates a new random (version 4) UUID.\n *\n * This is the single place in quidproquo to mint a v4 UUID. It uses the native\n * `crypto.randomUUID()` which is available in Node 20+ and all modern browsers\n * (secure contexts), so it works across both backend and frontend packages with\n * no external dependency. Centralising it here means the underlying source can be\n * swapped in one spot if that ever changes.\n *\n * @returns {string} A randomly generated v4 UUID, e.g. `109156be-c4fb-41ea-b1b4-efe1671c5836`.\n */\nexport function generateUuid(): string {\n  return globalThis.crypto.randomUUID();\n}\n"]}
+{"version":3,"file":"generateUuid.js","sourceRoot":"","sources":["../../../../src/utils/uuid/generateUuid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,YAAY;IAC1B,8EAA8E;IAC9E,6EAA6E;IAC7E,iEAAiE;IACjE,MAAM,SAAS,GAAG,UAAU,CAAC,MAA4B,CAAC;IAE1D,IAAI,OAAO,SAAS,EAAE,UAAU,KAAK,UAAU,EAAE,CAAC;QAChD,OAAO,SAAS,CAAC,UAAU,EAAE,CAAC;IAChC,CAAC;IAED,IAAI,OAAO,SAAS,EAAE,eAAe,KAAK,UAAU,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IAED,OAAO,4BAA4B,CAAC,SAAS,CAAC,CAAC;AACjD,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,4BAA4B,CAAC,SAA0C;IACrF,MAAM,KAAK,GAAG,SAAS,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;IAE5D,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IACpC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAEpC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAErF,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;AAC7G,CAAC","sourcesContent":["/**\n * Generates a new random (version 4) UUID.\n *\n * This is the single place in quidproquo to mint a v4 UUID, so it works across\n * both backend and frontend packages with no external dependency.\n *\n * It prefers the native `crypto.randomUUID()` (Node 20+, and browsers in a\n * SECURE context: https or localhost). Browsers deliberately hide that method on\n * plain-http origins, which is exactly where a self-hosted app on a LAN ip lives\n * (e.g. http://192.168.x.x), so it falls back to assembling the same v4 layout\n * from `crypto.getRandomValues()`, which is available everywhere.\n *\n * @returns {string} A randomly generated v4 UUID, e.g. `109156be-c4fb-41ea-b1b4-efe1671c5836`.\n */\nexport function generateUuid(): string {\n  // lib.dom types the global as always present; older runtimes (Node before 19,\n  // some workers) don't expose it, so treat it as optional and fail loudly. No\n  // Math.random() last resort: a guessable id is worse than no id.\n  const cryptoApi = globalThis.crypto as Crypto | undefined;\n\n  if (typeof cryptoApi?.randomUUID === 'function') {\n    return cryptoApi.randomUUID();\n  }\n\n  if (typeof cryptoApi?.getRandomValues !== 'function') {\n    throw new Error('generateUuid: no Web Crypto API available in this environment');\n  }\n\n  return generateUuidFromRandomValues(cryptoApi);\n}\n\n// RFC 4122 v4 from 16 random bytes: version nibble 4 in byte 6, variant 10xx in byte 8.\nexport function generateUuidFromRandomValues(cryptoApi: Pick<Crypto, 'getRandomValues'>): string {\n  const bytes = cryptoApi.getRandomValues(new Uint8Array(16));\n\n  bytes[6] = (bytes[6] & 0x0f) | 0x40;\n  bytes[8] = (bytes[8] & 0x3f) | 0x80;\n\n  const hex = Array.from(bytes, (byte) => byte.toString(16).padStart(2, '0')).join('');\n\n  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "quidproquo-core",
-  "version": "0.1.27",
+  "version": "0.1.29",
   "description": "",
   "main": "./lib/commonjs/index.js",
   "module": "./lib/esm/index.js",
@@ -36,7 +36,7 @@
   "homepage": "https://github.com/qpqjs/quidproquo#readme",
   "devDependencies": {
     "@types/node": "^24.2.1",
-    "quidproquo-tsconfig": "0.1.27",
+    "quidproquo-tsconfig": "0.1.29",
     "typescript": "^5.8.2"
   },
   "dependencies": {