@qpqjs/core 0.3.0 → 0.5.0

package/lib/esm/utils/logs/getTotalExecutionTime.js.map

@@ -1 +1 @@
-{"version":3,"file":"getTotalExecutionTime.js","sourceRoot":"","sources":["../../../../src/utils/logs/getTotalExecutionTime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAmC,MAAM,aAAa,CAAC;AAE9E,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,IAAuC,EAAU,EAAE;IACvF,IAAI,oBAAoB,GAAG,CAAC,CAAC;IAE7B,MAAM,QAAQ,GAAG,CAAC,IAAqC,EAAE,EAAE;QACzD,6CAA6C;QAC7C,IAAI,IAAI,CAAC,WAAW,KAAK,cAAc,CAAC,aAAa,EAAE,CAAC;YACtD,oBAAoB,IAAI,IAAI,CAAC,eAAe,CAAC;QAC/C,CAAC;QAED,iCAAiC;QACjC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC;IAEF,yCAAyC;IACzC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,QAAQ,CAAC,GAAG,CAAC,CAAC;IAChB,CAAC;IAED,OAAO,oBAAoB,CAAC;AAC9B,CAAC,CAAC","sourcesContent":["import { QpqRuntimeType, StoryResultMetadataWithChildren } from '../../types';\n\nexport const getTotalExecutionTime = (logs: StoryResultMetadataWithChildren[]): number => {\n  let totalExecutionTimeMs = 0;\n\n  const traverse = (node: StoryResultMetadataWithChildren) => {\n    // Add the node's execution time to the total\n    if (node.runtimeType === QpqRuntimeType.EXECUTE_STORY) {\n      totalExecutionTimeMs += node.executionTimeMs;\n    }\n\n    // Recursively process each child\n    for (const child of node.children) {\n      traverse(child);\n    }\n  };\n\n  // Start the traversal for each log entry\n  for (const log of logs) {\n    traverse(log);\n  }\n\n  return totalExecutionTimeMs;\n};\n"]}
+{"version":3,"file":"getTotalExecutionTime.js","sourceRoot":"","sources":["../../../../src/utils/logs/getTotalExecutionTime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAmC,MAAM,aAAa,CAAC;AAE9E,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,IAAuC,EAAU,EAAE;IACvF,IAAI,oBAAoB,GAAG,CAAC,CAAC;IAE7B,MAAM,QAAQ,GAAG,CAAC,IAAqC,EAAE,EAAE;QACzD,IAAI,IAAI,CAAC,WAAW,KAAK,cAAc,CAAC,aAAa,EAAE,CAAC;YACtD,oBAAoB,IAAI,IAAI,CAAC,eAAe,CAAC;QAC/C,CAAC;QAED,iCAAiC;QACjC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC;IAEF,yCAAyC;IACzC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,QAAQ,CAAC,GAAG,CAAC,CAAC;IAChB,CAAC;IAED,OAAO,oBAAoB,CAAC;AAC9B,CAAC,CAAC","sourcesContent":["import { QpqRuntimeType, StoryResultMetadataWithChildren } from '../../types';\n\nexport const getTotalExecutionTime = (logs: StoryResultMetadataWithChildren[]): number => {\n  let totalExecutionTimeMs = 0;\n\n  const traverse = (node: StoryResultMetadataWithChildren) => {\n    if (node.runtimeType === QpqRuntimeType.EXECUTE_STORY) {\n      totalExecutionTimeMs += node.executionTimeMs;\n    }\n\n    // Recursively process each child\n    for (const child of node.children) {\n      traverse(child);\n    }\n  };\n\n  // Start the traversal for each log entry\n  for (const log of logs) {\n    traverse(log);\n  }\n\n  return totalExecutionTimeMs;\n};\n"]}

package/lib/esm/utils/mimeTypes.js

@@ -37,9 +37,9 @@ export const getExtensionForMimeType = (mimeType) => {
     const key = mimeType.toLowerCase();
     // Own-property check so header-controlled values like "constructor" or
     // "__proto__" can't hit the prototype chain and leak an object instead of a string.
-    return Object.prototype.hasOwnProperty.call(MIME_TO_EXTENSION, key) ? MIME_TO_EXTENSION[key] : 'bin';
+    return Object.prototype.hasOwnProperty.call(MIME_TO_EXTENSION, key) ? (MIME_TO_EXTENSION[key] ?? 'bin') : 'bin';
 };
 // Strips parameters off a Content-Type header value, leaving just the MIME type
 // (e.g. "text/plain; charset=utf-8" -> "text/plain").
-export const getMimeTypeFromContentType = (contentType) => contentType.split(';')[0].trim();
+export const getMimeTypeFromContentType = (contentType) => (contentType.split(';')[0] ?? '').trim();
 //# sourceMappingURL=mimeTypes.js.map

package/lib/esm/utils/mimeTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"mimeTypes.js","sourceRoot":"","sources":["../../../src/utils/mimeTypes.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,sEAAsE;AACtE,oEAAoE;AACpE,MAAM,iBAAiB,GAA2B;IAChD,kBAAkB,EAAE,MAAM;IAC1B,0BAA0B,EAAE,KAAK;IACjC,iBAAiB,EAAE,KAAK;IACxB,iBAAiB,EAAE,KAAK;IACxB,mBAAmB,EAAE,KAAK;IAC1B,kBAAkB,EAAE,IAAI;IACxB,oBAAoB,EAAE,KAAK;IAC3B,yEAAyE,EAAE,MAAM;IACjF,0BAA0B,EAAE,KAAK;IACjC,mEAAmE,EAAE,MAAM;IAC3E,+BAA+B,EAAE,KAAK;IACtC,2EAA2E,EAAE,MAAM;IACnF,WAAW,EAAE,KAAK;IAClB,YAAY,EAAE,KAAK;IACnB,WAAW,EAAE,KAAK;IAClB,YAAY,EAAE,MAAM;IACpB,eAAe,EAAE,KAAK;IACtB,WAAW,EAAE,KAAK;IAClB,YAAY,EAAE,KAAK;IACnB,YAAY,EAAE,KAAK;IACnB,WAAW,EAAE,KAAK;IAClB,WAAW,EAAE,KAAK;IAClB,WAAW,EAAE,KAAK;IAClB,YAAY,EAAE,MAAM;IACpB,iBAAiB,EAAE,KAAK;IACxB,YAAY,EAAE,KAAK;IACnB,UAAU,EAAE,KAAK;IACjB,WAAW,EAAE,MAAM;IACnB,UAAU,EAAE,KAAK;IACjB,UAAU,EAAE,KAAK;CAClB,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,QAAgB,EAAU,EAAE;IAClE,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IAEnC,uEAAuE;IACvE,oFAAoF;IACpF,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AACvG,CAAC,CAAC;AAEF,gFAAgF;AAChF,sDAAsD;AACtD,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,WAAmB,EAAU,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC","sourcesContent":["// Minimal MIME → extension lookup for download filename fallbacks.\n// Inlined so we don't need the `mime-types` package, which depends on\n// Node's `path` module and breaks browser bundling under webpack 5.\nconst MIME_TO_EXTENSION: Record<string, string> = {\n  'application/json': 'json',\n  'application/octet-stream': 'bin',\n  'application/pdf': 'pdf',\n  'application/zip': 'zip',\n  'application/x-tar': 'tar',\n  'application/gzip': 'gz',\n  'application/msword': 'doc',\n  'application/vnd.openxmlformats-officedocument.wordprocessingml.document': 'docx',\n  'application/vnd.ms-excel': 'xls',\n  'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet': 'xlsx',\n  'application/vnd.ms-powerpoint': 'ppt',\n  'application/vnd.openxmlformats-officedocument.presentationml.presentation': 'pptx',\n  'image/png': 'png',\n  'image/jpeg': 'jpg',\n  'image/gif': 'gif',\n  'image/webp': 'webp',\n  'image/svg+xml': 'svg',\n  'image/bmp': 'bmp',\n  'image/tiff': 'tif',\n  'audio/mpeg': 'mp3',\n  'audio/ogg': 'ogg',\n  'audio/wav': 'wav',\n  'video/mp4': 'mp4',\n  'video/webm': 'webm',\n  'video/quicktime': 'mov',\n  'text/plain': 'txt',\n  'text/csv': 'csv',\n  'text/html': 'html',\n  'text/css': 'css',\n  'text/xml': 'xml',\n};\n\nexport const getExtensionForMimeType = (mimeType: string): string => {\n  const key = mimeType.toLowerCase();\n\n  // Own-property check so header-controlled values like \"constructor\" or\n  // \"__proto__\" can't hit the prototype chain and leak an object instead of a string.\n  return Object.prototype.hasOwnProperty.call(MIME_TO_EXTENSION, key) ? MIME_TO_EXTENSION[key] : 'bin';\n};\n\n// Strips parameters off a Content-Type header value, leaving just the MIME type\n// (e.g. \"text/plain; charset=utf-8\" -> \"text/plain\").\nexport const getMimeTypeFromContentType = (contentType: string): string => contentType.split(';')[0].trim();\n"]}
+{"version":3,"file":"mimeTypes.js","sourceRoot":"","sources":["../../../src/utils/mimeTypes.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,sEAAsE;AACtE,oEAAoE;AACpE,MAAM,iBAAiB,GAA2B;IAChD,kBAAkB,EAAE,MAAM;IAC1B,0BAA0B,EAAE,KAAK;IACjC,iBAAiB,EAAE,KAAK;IACxB,iBAAiB,EAAE,KAAK;IACxB,mBAAmB,EAAE,KAAK;IAC1B,kBAAkB,EAAE,IAAI;IACxB,oBAAoB,EAAE,KAAK;IAC3B,yEAAyE,EAAE,MAAM;IACjF,0BAA0B,EAAE,KAAK;IACjC,mEAAmE,EAAE,MAAM;IAC3E,+BAA+B,EAAE,KAAK;IACtC,2EAA2E,EAAE,MAAM;IACnF,WAAW,EAAE,KAAK;IAClB,YAAY,EAAE,KAAK;IACnB,WAAW,EAAE,KAAK;IAClB,YAAY,EAAE,MAAM;IACpB,eAAe,EAAE,KAAK;IACtB,WAAW,EAAE,KAAK;IAClB,YAAY,EAAE,KAAK;IACnB,YAAY,EAAE,KAAK;IACnB,WAAW,EAAE,KAAK;IAClB,WAAW,EAAE,KAAK;IAClB,WAAW,EAAE,KAAK;IAClB,YAAY,EAAE,MAAM;IACpB,iBAAiB,EAAE,KAAK;IACxB,YAAY,EAAE,KAAK;IACnB,UAAU,EAAE,KAAK;IACjB,WAAW,EAAE,MAAM;IACnB,UAAU,EAAE,KAAK;IACjB,UAAU,EAAE,KAAK;CAClB,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,QAAgB,EAAU,EAAE;IAClE,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IAEnC,uEAAuE;IACvE,oFAAoF;IACpF,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAClH,CAAC,CAAC;AAEF,gFAAgF;AAChF,sDAAsD;AACtD,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,WAAmB,EAAU,EAAE,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC","sourcesContent":["// Minimal MIME → extension lookup for download filename fallbacks.\n// Inlined so we don't need the `mime-types` package, which depends on\n// Node's `path` module and breaks browser bundling under webpack 5.\nconst MIME_TO_EXTENSION: Record<string, string> = {\n  'application/json': 'json',\n  'application/octet-stream': 'bin',\n  'application/pdf': 'pdf',\n  'application/zip': 'zip',\n  'application/x-tar': 'tar',\n  'application/gzip': 'gz',\n  'application/msword': 'doc',\n  'application/vnd.openxmlformats-officedocument.wordprocessingml.document': 'docx',\n  'application/vnd.ms-excel': 'xls',\n  'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet': 'xlsx',\n  'application/vnd.ms-powerpoint': 'ppt',\n  'application/vnd.openxmlformats-officedocument.presentationml.presentation': 'pptx',\n  'image/png': 'png',\n  'image/jpeg': 'jpg',\n  'image/gif': 'gif',\n  'image/webp': 'webp',\n  'image/svg+xml': 'svg',\n  'image/bmp': 'bmp',\n  'image/tiff': 'tif',\n  'audio/mpeg': 'mp3',\n  'audio/ogg': 'ogg',\n  'audio/wav': 'wav',\n  'video/mp4': 'mp4',\n  'video/webm': 'webm',\n  'video/quicktime': 'mov',\n  'text/plain': 'txt',\n  'text/csv': 'csv',\n  'text/html': 'html',\n  'text/css': 'css',\n  'text/xml': 'xml',\n};\n\nexport const getExtensionForMimeType = (mimeType: string): string => {\n  const key = mimeType.toLowerCase();\n\n  // Own-property check so header-controlled values like \"constructor\" or\n  // \"__proto__\" can't hit the prototype chain and leak an object instead of a string.\n  return Object.prototype.hasOwnProperty.call(MIME_TO_EXTENSION, key) ? (MIME_TO_EXTENSION[key] ?? 'bin') : 'bin';\n};\n\n// Strips parameters off a Content-Type header value, leaving just the MIME type\n// (e.g. \"text/plain; charset=utf-8\" -> \"text/plain\").\nexport const getMimeTypeFromContentType = (contentType: string): string => (contentType.split(';')[0] ?? '').trim();\n"]}

package/lib/esm/utils/path/distPaths/getAppDistPath.d.ts

@@ -0,0 +1,2 @@
+/** `dist/apps/<app>`: everything built for one app. */
+export declare const getAppDistPath: (root: string, appName: string) => string;

package/lib/esm/utils/path/distPaths/getAppDistPath.js

@@ -0,0 +1,4 @@
+import path from 'path';
+/** `dist/apps/<app>`: everything built for one app. */
+export const getAppDistPath = (root, appName) => path.join(root, 'dist', 'apps', appName);
+//# sourceMappingURL=getAppDistPath.js.map

package/lib/esm/utils/path/distPaths/getAppDistPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAppDistPath.js","sourceRoot":"","sources":["../../../../../src/utils/path/distPaths/getAppDistPath.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,uDAAuD;AACvD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,OAAe,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC","sourcesContent":["import path from 'path';\n\n/** `dist/apps/<app>`: everything built for one app. */\nexport const getAppDistPath = (root: string, appName: string): string => path.join(root, 'dist', 'apps', appName);\n"]}

package/lib/esm/utils/path/distPaths/getCdkOutPath.d.ts

@@ -0,0 +1,2 @@
+/** The cloud assembly `cdk deploy` / `cdk destroy` synth into. */
+export declare const getCdkOutPath: (root: string) => string;

package/lib/esm/utils/path/distPaths/getCdkOutPath.js

@@ -0,0 +1,5 @@
+import path from 'path';
+import { getQpqDistPath } from './getQpqDistPath';
+/** The cloud assembly `cdk deploy` / `cdk destroy` synth into. */
+export const getCdkOutPath = (root) => path.join(getQpqDistPath(root), 'cdk.out');
+//# sourceMappingURL=getCdkOutPath.js.map

package/lib/esm/utils/path/distPaths/getCdkOutPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCdkOutPath.js","sourceRoot":"","sources":["../../../../../src/utils/path/distPaths/getCdkOutPath.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,kEAAkE;AAClE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC","sourcesContent":["import path from 'path';\n\nimport { getQpqDistPath } from './getQpqDistPath';\n\n/** The cloud assembly `cdk deploy` / `cdk destroy` synth into. */\nexport const getCdkOutPath = (root: string): string => path.join(getQpqDistPath(root), 'cdk.out');\n"]}

package/lib/esm/utils/path/distPaths/getDevServerDistPath.d.ts

@@ -0,0 +1,2 @@
+/** Where the dev server, migrate and user-script-child bundles land. */
+export declare const getDevServerDistPath: (root: string) => string;

package/lib/esm/utils/path/distPaths/getDevServerDistPath.js

@@ -0,0 +1,5 @@
+import path from 'path';
+import { getQpqDistPath } from './getQpqDistPath';
+/** Where the dev server, migrate and user-script-child bundles land. */
+export const getDevServerDistPath = (root) => path.join(getQpqDistPath(root), 'dev-server');
+//# sourceMappingURL=getDevServerDistPath.js.map

package/lib/esm/utils/path/distPaths/getDevServerDistPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDevServerDistPath.js","sourceRoot":"","sources":["../../../../../src/utils/path/distPaths/getDevServerDistPath.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,wEAAwE;AACxE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC","sourcesContent":["import path from 'path';\n\nimport { getQpqDistPath } from './getQpqDistPath';\n\n/** Where the dev server, migrate and user-script-child bundles land. */\nexport const getDevServerDistPath = (root: string): string => path.join(getQpqDistPath(root), 'dev-server');\n"]}

package/lib/esm/utils/path/distPaths/getDockerImageContextPath.d.ts

@@ -0,0 +1,2 @@
+/** The docker build context assembled for an app's image. */
+export declare const getDockerImageContextPath: (root: string, appName: string) => string;

package/lib/esm/utils/path/distPaths/getDockerImageContextPath.js

@@ -0,0 +1,5 @@
+import path from 'path';
+import { getQpqDistPath } from './getQpqDistPath';
+/** The docker build context assembled for an app's image. */
+export const getDockerImageContextPath = (root, appName) => path.join(getQpqDistPath(root), 'docker-image', appName);
+//# sourceMappingURL=getDockerImageContextPath.js.map

package/lib/esm/utils/path/distPaths/getDockerImageContextPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDockerImageContextPath.js","sourceRoot":"","sources":["../../../../../src/utils/path/distPaths/getDockerImageContextPath.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,6DAA6D;AAC7D,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,IAAY,EAAE,OAAe,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC","sourcesContent":["import path from 'path';\n\nimport { getQpqDistPath } from './getQpqDistPath';\n\n/** The docker build context assembled for an app's image. */\nexport const getDockerImageContextPath = (root: string, appName: string): string => path.join(getQpqDistPath(root), 'docker-image', appName);\n"]}

package/lib/esm/utils/path/distPaths/getGoDockerBuildPath.d.ts

@@ -0,0 +1,2 @@
+/** The per-service directory a containerized deploy's build half owns. */
+export declare const getGoDockerBuildPath: (root: string, appName: string, serviceName: string) => string;

package/lib/esm/utils/path/distPaths/getGoDockerBuildPath.js

@@ -0,0 +1,5 @@
+import path from 'path';
+import { getQpqDistPath } from './getQpqDistPath';
+/** The per-service directory a containerized deploy's build half owns. */
+export const getGoDockerBuildPath = (root, appName, serviceName) => path.join(getQpqDistPath(root), 'go-docker', appName, serviceName);
+//# sourceMappingURL=getGoDockerBuildPath.js.map

package/lib/esm/utils/path/distPaths/getGoDockerBuildPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getGoDockerBuildPath.js","sourceRoot":"","sources":["../../../../../src/utils/path/distPaths/getGoDockerBuildPath.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,0EAA0E;AAC1E,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,IAAY,EAAE,OAAe,EAAE,WAAmB,EAAU,EAAE,CACjG,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC","sourcesContent":["import path from 'path';\n\nimport { getQpqDistPath } from './getQpqDistPath';\n\n/** The per-service directory a containerized deploy's build half owns. */\nexport const getGoDockerBuildPath = (root: string, appName: string, serviceName: string): string =>\n  path.join(getQpqDistPath(root), 'go-docker', appName, serviceName);\n"]}

package/lib/esm/utils/path/distPaths/getInfrastructureConfigPath.d.ts

@@ -0,0 +1,2 @@
+/** Where `qpq synth` writes each service's `<module>-config.json`. */
+export declare const getInfrastructureConfigPath: (root: string, appName: string) => string;

package/lib/esm/utils/path/distPaths/getInfrastructureConfigPath.js

@@ -0,0 +1,5 @@
+import path from 'path';
+import { getAppDistPath } from './getAppDistPath';
+/** Where `qpq synth` writes each service's `<module>-config.json`. */
+export const getInfrastructureConfigPath = (root, appName) => path.join(getAppDistPath(root, appName), 'infrastructure');
+//# sourceMappingURL=getInfrastructureConfigPath.js.map

package/lib/esm/utils/path/distPaths/getInfrastructureConfigPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getInfrastructureConfigPath.js","sourceRoot":"","sources":["../../../../../src/utils/path/distPaths/getInfrastructureConfigPath.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,sEAAsE;AACtE,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,IAAY,EAAE,OAAe,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,gBAAgB,CAAC,CAAC","sourcesContent":["import path from 'path';\n\nimport { getAppDistPath } from './getAppDistPath';\n\n/** Where `qpq synth` writes each service's `<module>-config.json`. */\nexport const getInfrastructureConfigPath = (root: string, appName: string): string => path.join(getAppDistPath(root, appName), 'infrastructure');\n"]}

package/lib/esm/utils/path/distPaths/getQpqDistPath.d.ts

@@ -0,0 +1,2 @@
+/** `dist/qpq`: the tooling's own build output (dev server bundles, cdk assemblies, docker contexts). */
+export declare const getQpqDistPath: (root: string) => string;

package/lib/esm/utils/path/distPaths/getQpqDistPath.js

@@ -0,0 +1,4 @@
+import path from 'path';
+/** `dist/qpq`: the tooling's own build output (dev server bundles, cdk assemblies, docker contexts). */
+export const getQpqDistPath = (root) => path.join(root, 'dist', 'qpq');
+//# sourceMappingURL=getQpqDistPath.js.map

package/lib/esm/utils/path/distPaths/getQpqDistPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getQpqDistPath.js","sourceRoot":"","sources":["../../../../../src/utils/path/distPaths/getQpqDistPath.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,wGAAwG;AACxG,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC","sourcesContent":["import path from 'path';\n\n/** `dist/qpq`: the tooling's own build output (dev server bundles, cdk assemblies, docker contexts). */\nexport const getQpqDistPath = (root: string): string => path.join(root, 'dist', 'qpq');\n"]}

package/lib/esm/utils/path/distPaths/getServiceBundleDistPath.d.ts

@@ -0,0 +1,2 @@
+/** The service's static backend bundle. */
+export declare const getServiceBundleDistPath: (root: string, appName: string, serviceName: string) => string;

package/lib/esm/utils/path/distPaths/getServiceBundleDistPath.js

@@ -0,0 +1,5 @@
+import path from 'path';
+import { getServiceDistPath } from './getServiceDistPath';
+/** The service's static backend bundle. */
+export const getServiceBundleDistPath = (root, appName, serviceName) => path.join(getServiceDistPath(root, appName, serviceName), 'service');
+//# sourceMappingURL=getServiceBundleDistPath.js.map

package/lib/esm/utils/path/distPaths/getServiceBundleDistPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getServiceBundleDistPath.js","sourceRoot":"","sources":["../../../../../src/utils/path/distPaths/getServiceBundleDistPath.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,2CAA2C;AAC3C,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,IAAY,EAAE,OAAe,EAAE,WAAmB,EAAU,EAAE,CACrG,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,SAAS,CAAC,CAAC","sourcesContent":["import path from 'path';\n\nimport { getServiceDistPath } from './getServiceDistPath';\n\n/** The service's static backend bundle. */\nexport const getServiceBundleDistPath = (root: string, appName: string, serviceName: string): string =>\n  path.join(getServiceDistPath(root, appName, serviceName), 'service');\n"]}

package/lib/esm/utils/path/distPaths/getServiceDistPath.d.ts

@@ -0,0 +1,2 @@
+/** `dist/apps/<app>/services/<service>`: the root of one service's build outputs. */
+export declare const getServiceDistPath: (root: string, appName: string, serviceName: string) => string;

package/lib/esm/utils/path/distPaths/getServiceDistPath.js

@@ -0,0 +1,5 @@
+import path from 'path';
+import { getAppDistPath } from './getAppDistPath';
+/** `dist/apps/<app>/services/<service>`: the root of one service's build outputs. */
+export const getServiceDistPath = (root, appName, serviceName) => path.join(getAppDistPath(root, appName), 'services', serviceName);
+//# sourceMappingURL=getServiceDistPath.js.map

package/lib/esm/utils/path/distPaths/getServiceDistPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getServiceDistPath.js","sourceRoot":"","sources":["../../../../../src/utils/path/distPaths/getServiceDistPath.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,qFAAqF;AACrF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAE,OAAe,EAAE,WAAmB,EAAU,EAAE,CAC/F,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC","sourcesContent":["import path from 'path';\n\nimport { getAppDistPath } from './getAppDistPath';\n\n/** `dist/apps/<app>/services/<service>`: the root of one service's build outputs. */\nexport const getServiceDistPath = (root: string, appName: string, serviceName: string): string =>\n  path.join(getAppDistPath(root, appName), 'services', serviceName);\n"]}

package/lib/esm/utils/path/distPaths/getServiceRemoteDistPath.d.ts

@@ -0,0 +1,2 @@
+/** The service's module-federation remote build, a sibling of the static bundle so the two never clobber each other. */
+export declare const getServiceRemoteDistPath: (root: string, appName: string, serviceName: string) => string;

package/lib/esm/utils/path/distPaths/getServiceRemoteDistPath.js

@@ -0,0 +1,5 @@
+import path from 'path';
+import { getServiceDistPath } from './getServiceDistPath';
+/** The service's module-federation remote build, a sibling of the static bundle so the two never clobber each other. */
+export const getServiceRemoteDistPath = (root, appName, serviceName) => path.join(getServiceDistPath(root, appName, serviceName), 'service-remote');
+//# sourceMappingURL=getServiceRemoteDistPath.js.map

package/lib/esm/utils/path/distPaths/getServiceRemoteDistPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getServiceRemoteDistPath.js","sourceRoot":"","sources":["../../../../../src/utils/path/distPaths/getServiceRemoteDistPath.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,wHAAwH;AACxH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,IAAY,EAAE,OAAe,EAAE,WAAmB,EAAU,EAAE,CACrG,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,gBAAgB,CAAC,CAAC","sourcesContent":["import path from 'path';\n\nimport { getServiceDistPath } from './getServiceDistPath';\n\n/** The service's module-federation remote build, a sibling of the static bundle so the two never clobber each other. */\nexport const getServiceRemoteDistPath = (root: string, appName: string, serviceName: string): string =>\n  path.join(getServiceDistPath(root, appName, serviceName), 'service-remote');\n"]}

package/lib/esm/utils/path/distPaths/getServiceRemotePublishedDistPath.d.ts

@@ -0,0 +1,2 @@
+/** The remote build as published to the federated code store. */
+export declare const getServiceRemotePublishedDistPath: (root: string, appName: string, serviceName: string) => string;

package/lib/esm/utils/path/distPaths/getServiceRemotePublishedDistPath.js

@@ -0,0 +1,5 @@
+import path from 'path';
+import { getServiceDistPath } from './getServiceDistPath';
+/** The remote build as published to the federated code store. */
+export const getServiceRemotePublishedDistPath = (root, appName, serviceName) => path.join(getServiceDistPath(root, appName, serviceName), 'service-remote-published');
+//# sourceMappingURL=getServiceRemotePublishedDistPath.js.map

package/lib/esm/utils/path/distPaths/getServiceRemotePublishedDistPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getServiceRemotePublishedDistPath.js","sourceRoot":"","sources":["../../../../../src/utils/path/distPaths/getServiceRemotePublishedDistPath.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,iEAAiE;AACjE,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,IAAY,EAAE,OAAe,EAAE,WAAmB,EAAU,EAAE,CAC9G,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,0BAA0B,CAAC,CAAC","sourcesContent":["import path from 'path';\n\nimport { getServiceDistPath } from './getServiceDistPath';\n\n/** The remote build as published to the federated code store. */\nexport const getServiceRemotePublishedDistPath = (root: string, appName: string, serviceName: string): string =>\n  path.join(getServiceDistPath(root, appName, serviceName), 'service-remote-published');\n"]}

package/lib/esm/utils/path/distPaths/getViewsDistPath.d.ts

@@ -0,0 +1,2 @@
+/** The service's built views (its web entries). */
+export declare const getViewsDistPath: (root: string, appName: string, serviceName: string) => string;

package/lib/esm/utils/path/distPaths/getViewsDistPath.js

@@ -0,0 +1,5 @@
+import path from 'path';
+import { getServiceDistPath } from './getServiceDistPath';
+/** The service's built views (its web entries). */
+export const getViewsDistPath = (root, appName, serviceName) => path.join(getServiceDistPath(root, appName, serviceName), 'views');
+//# sourceMappingURL=getViewsDistPath.js.map

package/lib/esm/utils/path/distPaths/getViewsDistPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getViewsDistPath.js","sourceRoot":"","sources":["../../../../../src/utils/path/distPaths/getViewsDistPath.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,mDAAmD;AACnD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAE,OAAe,EAAE,WAAmB,EAAU,EAAE,CAC7F,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC","sourcesContent":["import path from 'path';\n\nimport { getServiceDistPath } from './getServiceDistPath';\n\n/** The service's built views (its web entries). */\nexport const getViewsDistPath = (root: string, appName: string, serviceName: string): string =>\n  path.join(getServiceDistPath(root, appName, serviceName), 'views');\n"]}

package/lib/esm/utils/path/distPaths/getViewsEntryDistPath.d.ts

@@ -0,0 +1,2 @@
+/** Where the bundler writes the default entry files for a views package that ships none of its own (E8). */
+export declare const getViewsEntryDistPath: (root: string, appName: string, serviceName: string) => string;

package/lib/esm/utils/path/distPaths/getViewsEntryDistPath.js

@@ -0,0 +1,5 @@
+import path from 'path';
+import { getQpqDistPath } from './getQpqDistPath';
+/** Where the bundler writes the default entry files for a views package that ships none of its own (E8). */
+export const getViewsEntryDistPath = (root, appName, serviceName) => path.join(getQpqDistPath(root), 'views-entry', appName, serviceName);
+//# sourceMappingURL=getViewsEntryDistPath.js.map

package/lib/esm/utils/path/distPaths/getViewsEntryDistPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getViewsEntryDistPath.js","sourceRoot":"","sources":["../../../../../src/utils/path/distPaths/getViewsEntryDistPath.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,4GAA4G;AAC5G,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,IAAY,EAAE,OAAe,EAAE,WAAmB,EAAU,EAAE,CAClG,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC","sourcesContent":["import path from 'path';\n\nimport { getQpqDistPath } from './getQpqDistPath';\n\n/** Where the bundler writes the default entry files for a views package that ships none of its own (E8). */\nexport const getViewsEntryDistPath = (root: string, appName: string, serviceName: string): string =>\n  path.join(getQpqDistPath(root), 'views-entry', appName, serviceName);\n"]}

package/lib/esm/utils/path/distPaths/index.d.ts

@@ -0,0 +1,13 @@
+export * from './getAppDistPath';
+export * from './getCdkOutPath';
+export * from './getDevServerDistPath';
+export * from './getDockerImageContextPath';
+export * from './getGoDockerBuildPath';
+export * from './getInfrastructureConfigPath';
+export * from './getQpqDistPath';
+export * from './getServiceBundleDistPath';
+export * from './getServiceDistPath';
+export * from './getServiceRemoteDistPath';
+export * from './getServiceRemotePublishedDistPath';
+export * from './getViewsDistPath';
+export * from './getViewsEntryDistPath';

package/lib/esm/utils/path/distPaths/index.js

@@ -0,0 +1,14 @@
+export * from './getAppDistPath';
+export * from './getCdkOutPath';
+export * from './getDevServerDistPath';
+export * from './getDockerImageContextPath';
+export * from './getGoDockerBuildPath';
+export * from './getInfrastructureConfigPath';
+export * from './getQpqDistPath';
+export * from './getServiceBundleDistPath';
+export * from './getServiceDistPath';
+export * from './getServiceRemoteDistPath';
+export * from './getServiceRemotePublishedDistPath';
+export * from './getViewsDistPath';
+export * from './getViewsEntryDistPath';
+//# sourceMappingURL=index.js.map

package/lib/esm/utils/path/distPaths/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/utils/path/distPaths/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qCAAqC,CAAC;AACpD,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC","sourcesContent":["export * from './getAppDistPath';\nexport * from './getCdkOutPath';\nexport * from './getDevServerDistPath';\nexport * from './getDockerImageContextPath';\nexport * from './getGoDockerBuildPath';\nexport * from './getInfrastructureConfigPath';\nexport * from './getQpqDistPath';\nexport * from './getServiceBundleDistPath';\nexport * from './getServiceDistPath';\nexport * from './getServiceRemoteDistPath';\nexport * from './getServiceRemotePublishedDistPath';\nexport * from './getViewsDistPath';\nexport * from './getViewsEntryDistPath';\n"]}

package/lib/esm/utils/path/index.d.ts

@@ -1,3 +1,4 @@
+export * from './distPaths';
 export * from './getActionProcessorsFromQpqFunctionRuntime';
 export * from './getFederatedKeyFromQpqFunctionRuntime';
 export * from './getGlobalsFromQpqFunctionRuntime';

package/lib/esm/utils/path/index.js

@@ -1,3 +1,4 @@
+export * from './distPaths';
 export * from './getActionProcessorsFromQpqFunctionRuntime';
 export * from './getFederatedKeyFromQpqFunctionRuntime';
 export * from './getGlobalsFromQpqFunctionRuntime';

package/lib/esm/utils/path/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/utils/path/index.ts"],"names":[],"mappings":"AAAA,cAAc,6CAA6C,CAAC;AAC5D,cAAc,yCAAyC,CAAC;AACxD,cAAc,oCAAoC,CAAC;AACnD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC","sourcesContent":["export * from './getActionProcessorsFromQpqFunctionRuntime';\nexport * from './getFederatedKeyFromQpqFunctionRuntime';\nexport * from './getGlobalsFromQpqFunctionRuntime';\nexport * from './getUniqueKeyFromQpqFunctionRuntime';\nexport * from './isQpqFunctionRuntimeAdvanced';\nexport * from './isQpqFunctionRuntimeRelativePath';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/utils/path/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,6CAA6C,CAAC;AAC5D,cAAc,yCAAyC,CAAC;AACxD,cAAc,oCAAoC,CAAC;AACnD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC","sourcesContent":["export * from './distPaths';\nexport * from './getActionProcessorsFromQpqFunctionRuntime';\nexport * from './getFederatedKeyFromQpqFunctionRuntime';\nexport * from './getGlobalsFromQpqFunctionRuntime';\nexport * from './getUniqueKeyFromQpqFunctionRuntime';\nexport * from './isQpqFunctionRuntimeAdvanced';\nexport * from './isQpqFunctionRuntimeRelativePath';\n"]}

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

@@ -28,8 +28,8 @@ export function generateUuid() {
 // 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;
+    bytes[6] = ((bytes[6] ?? 0) & 0x0f) | 0x40;
+    bytes[8] = ((bytes[8] ?? 0) & 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)}`;
 }

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;;;;;;;;;;;;;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"]}
+{"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,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3C,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAE3C,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] ?? 0) & 0x0f) | 0x40;\n  bytes[8] = ((bytes[8] ?? 0) & 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/utils/uuid/generateUuidV5.js

@@ -57,8 +57,8 @@ export function generateUuidV5(name, namespace) {
     input.set(nameBytes, namespaceBytes.length);
     const bytes = sha1(input).slice(0, 16);
     // RFC 4122: the high nibble of byte 6 carries the version, the top bits of byte 8 the variant.
-    bytes[6] = (bytes[6] & 0x0f) | 0x50;
-    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    bytes[6] = ((bytes[6] ?? 0) & 0x0f) | 0x50;
+    bytes[8] = ((bytes[8] ?? 0) & 0x3f) | 0x80;
     return bytesToUuid(bytes);
 }
 //# sourceMappingURL=generateUuidV5.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"generateUuidV5.js","sourceRoot":"","sources":["../../../../src/utils/uuid/generateUuidV5.ts"],"names":[],"mappings":"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","sourcesContent":["import { sha1 } from '../hash/sha1';\n\n// The well-known namespace UUIDs from RFC 4122 Appendix C.\nexport enum UuidNamespace {\n  dns = '6ba7b810-9dad-11d1-80b4-00c04fd430c8',\n  url = '6ba7b811-9dad-11d1-80b4-00c04fd430c8',\n  oid = '6ba7b812-9dad-11d1-80b4-00c04fd430c8',\n  x500 = '6ba7b814-9dad-11d1-80b4-00c04fd430c8',\n}\n\nconst uuidFormatRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n\n// Raised when the namespace argument is not a canonical UUID string.\nexport enum InvalidUuidNamespaceErrorCode {\n  notAUuid = 'notAUuid',\n}\n\nexport class InvalidUuidNamespaceError extends Error {\n  constructor(\n    public readonly code: InvalidUuidNamespaceErrorCode,\n    message: string,\n  ) {\n    super(message);\n    this.name = 'InvalidUuidNamespaceError';\n  }\n}\n\nconst uuidToBytes = (uuid: string): Uint8Array => {\n  const hex = uuid.replace(/-/g, '');\n  const bytes = new Uint8Array(16);\n\n  for (let i = 0; i < 16; i++) {\n    bytes[i] = parseInt(hex.slice(i * 2, i * 2 + 2), 16);\n  }\n\n  return bytes;\n};\n\nconst bytesToUuid = (bytes: Uint8Array): string => {\n  const hex = Array.from(bytes, (b) => b.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, 32)}`;\n};\n\n/**\n * Generates a deterministic name-based (version 5) UUID - the sister of `generateUuid`.\n *\n * Where `generateUuid` mints a random v4 UUID, this derives a UUID from a name and a\n * namespace UUID per RFC 4122: the same inputs always produce the same UUID, so it is\n * useful for stable identifiers (e.g. mapping an external key to a UUID). It hashes with\n * the bundled pure-TypeScript SHA-1 so it stays synchronous and dependency-free in both\n * Node and browsers.\n *\n * @param {string} name - The name to derive the UUID from.\n * @param {string} namespace - The namespace UUID, e.g. `UuidNamespace.dns` or any UUID of your own.\n * @returns {string} The derived v5 UUID, e.g. `2ed6657d-e927-568b-95e1-2665a8aea6a2`.\n */\nexport function generateUuidV5(name: string, namespace: string): string {\n  if (!uuidFormatRegex.test(namespace)) {\n    throw new InvalidUuidNamespaceError(InvalidUuidNamespaceErrorCode.notAUuid, `Invalid namespace UUID [${namespace}]`);\n  }\n\n  const namespaceBytes = uuidToBytes(namespace);\n  const nameBytes = new TextEncoder().encode(name);\n\n  const input = new Uint8Array(namespaceBytes.length + nameBytes.length);\n  input.set(namespaceBytes);\n  input.set(nameBytes, namespaceBytes.length);\n\n  const bytes = sha1(input).slice(0, 16);\n\n  // RFC 4122: the high nibble of byte 6 carries the version, the top bits of byte 8 the variant.\n  bytes[6] = (bytes[6] & 0x0f) | 0x50;\n  bytes[8] = (bytes[8] & 0x3f) | 0x80;\n\n  return bytesToUuid(bytes);\n}\n"]}
+{"version":3,"file":"generateUuidV5.js","sourceRoot":"","sources":["../../../../src/utils/uuid/generateUuidV5.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEpC,2DAA2D;AAC3D,MAAM,CAAN,IAAY,aAKX;AALD,WAAY,aAAa;IACvB,6DAA4C,CAAA;IAC5C,6DAA4C,CAAA;IAC5C,6DAA4C,CAAA;IAC5C,8DAA6C,CAAA;AAC/C,CAAC,EALW,aAAa,KAAb,aAAa,QAKxB;AAED,MAAM,eAAe,GAAG,iEAAiE,CAAC;AAE1F,qEAAqE;AACrE,MAAM,CAAN,IAAY,6BAEX;AAFD,WAAY,6BAA6B;IACvC,sDAAqB,CAAA;AACvB,CAAC,EAFW,6BAA6B,KAA7B,6BAA6B,QAExC;AAED,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAEhC;IADlB,YACkB,IAAmC,EACnD,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAA+B;QAInD,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAED,MAAM,WAAW,GAAG,CAAC,IAAY,EAAc,EAAE;IAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IAEjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,KAAK,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,KAAiB,EAAU,EAAE;IAChD,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAE/E,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,EAAE,EAAE,CAAC,EAAE,CAAC;AACjH,CAAC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,SAAiB;IAC5D,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,yBAAyB,CAAC,6BAA6B,CAAC,QAAQ,EAAE,2BAA2B,SAAS,GAAG,CAAC,CAAC;IACvH,CAAC;IAED,MAAM,cAAc,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAEjD,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,cAAc,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IACvE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC1B,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IAE5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEvC,+FAA+F;IAC/F,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3C,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAE3C,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC","sourcesContent":["import { sha1 } from '../hash/sha1';\n\n// The well-known namespace UUIDs from RFC 4122 Appendix C.\nexport enum UuidNamespace {\n  dns = '6ba7b810-9dad-11d1-80b4-00c04fd430c8',\n  url = '6ba7b811-9dad-11d1-80b4-00c04fd430c8',\n  oid = '6ba7b812-9dad-11d1-80b4-00c04fd430c8',\n  x500 = '6ba7b814-9dad-11d1-80b4-00c04fd430c8',\n}\n\nconst uuidFormatRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n\n// Raised when the namespace argument is not a canonical UUID string.\nexport enum InvalidUuidNamespaceErrorCode {\n  notAUuid = 'notAUuid',\n}\n\nexport class InvalidUuidNamespaceError extends Error {\n  constructor(\n    public readonly code: InvalidUuidNamespaceErrorCode,\n    message: string,\n  ) {\n    super(message);\n    this.name = 'InvalidUuidNamespaceError';\n  }\n}\n\nconst uuidToBytes = (uuid: string): Uint8Array => {\n  const hex = uuid.replace(/-/g, '');\n  const bytes = new Uint8Array(16);\n\n  for (let i = 0; i < 16; i++) {\n    bytes[i] = parseInt(hex.slice(i * 2, i * 2 + 2), 16);\n  }\n\n  return bytes;\n};\n\nconst bytesToUuid = (bytes: Uint8Array): string => {\n  const hex = Array.from(bytes, (b) => b.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, 32)}`;\n};\n\n/**\n * Generates a deterministic name-based (version 5) UUID - the sister of `generateUuid`.\n *\n * Where `generateUuid` mints a random v4 UUID, this derives a UUID from a name and a\n * namespace UUID per RFC 4122: the same inputs always produce the same UUID, so it is\n * useful for stable identifiers (e.g. mapping an external key to a UUID). It hashes with\n * the bundled pure-TypeScript SHA-1 so it stays synchronous and dependency-free in both\n * Node and browsers.\n *\n * @param {string} name - The name to derive the UUID from.\n * @param {string} namespace - The namespace UUID, e.g. `UuidNamespace.dns` or any UUID of your own.\n * @returns {string} The derived v5 UUID, e.g. `2ed6657d-e927-568b-95e1-2665a8aea6a2`.\n */\nexport function generateUuidV5(name: string, namespace: string): string {\n  if (!uuidFormatRegex.test(namespace)) {\n    throw new InvalidUuidNamespaceError(InvalidUuidNamespaceErrorCode.notAUuid, `Invalid namespace UUID [${namespace}]`);\n  }\n\n  const namespaceBytes = uuidToBytes(namespace);\n  const nameBytes = new TextEncoder().encode(name);\n\n  const input = new Uint8Array(namespaceBytes.length + nameBytes.length);\n  input.set(namespaceBytes);\n  input.set(nameBytes, namespaceBytes.length);\n\n  const bytes = sha1(input).slice(0, 16);\n\n  // RFC 4122: the high nibble of byte 6 carries the version, the top bits of byte 8 the variant.\n  bytes[6] = ((bytes[6] ?? 0) & 0x0f) | 0x50;\n  bytes[8] = ((bytes[8] ?? 0) & 0x3f) | 0x80;\n\n  return bytesToUuid(bytes);\n}\n"]}

package/lib/esm/utils/when.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"when.js","sourceRoot":"","sources":["../../../src/utils/when.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,IAAI,CAAmB,SAAkB,EAAE,KAAQ,EAAE,QAAY;IAC/E,OAAO,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,QAAc,CAAC;AAC7C,CAAC","sourcesContent":["export function when<T, F = undefined>(condition: unknown, value: T, fallback?: F): T | F {\n  return condition ? value : (fallback as F);\n}\n"]}

package/package.json

@@ -1,10 +1,18 @@
 {
   "name": "@qpqjs/core",
-  "version": "0.3.0",
-  "description": "",
+  "version": "0.5.0",
+  "description": "Actions, stories and the runtime at the heart of quidproquo.",
   "main": "./lib/commonjs/index.js",
   "module": "./lib/esm/index.js",
   "types": "./lib/commonjs/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/commonjs/index.d.ts",
+      "module": "./lib/esm/index.js",
+      "default": "./lib/commonjs/index.js"
+    },
+    "./package.json": "./package.json"
+  },
   "sideEffects": false,
   "files": [
     "lib/**/*"
@@ -13,7 +21,8 @@
     "access": "public"
   },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "clean": "npx rimraf lib && npx rimraf node_modules",
     "build": "npm run clean && npm run build:esm && npm run build:cjs",
     "watch": "tsc -p tsconfig.commonjs.json -w",
@@ -25,7 +34,8 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/qpqjs/quidproquo.git"
+    "url": "git+https://github.com/qpqjs/quidproquo.git",
+    "directory": "packages/core"
   },
   "keywords": [],
   "author": "",
@@ -35,11 +45,15 @@
   },
   "homepage": "https://github.com/qpqjs/quidproquo#readme",
   "devDependencies": {
+    "@qpqjs/testing": "0.5.0",
+    "@qpqjs/tsconfig": "0.5.0",
     "@types/node": "^24.2.1",
-    "@qpqjs/tsconfig": "0.3.0",
     "typescript": "^5.8.2"
   },
   "dependencies": {
     "immer": "^10.1.1"
+  },
+  "engines": {
+    "node": ">=24"
   }
 }

package/lib/commonjs/actions/guid/askNewGuid.d.ts

@@ -1,2 +0,0 @@
-import { GuidActionType } from './GuidActionType';
-export declare const askNewGuid: import("../../types").ActionRequesterFunction<GuidActionType.New, [], undefined, string, never>;

package/lib/commonjs/actions/guid/askNewGuid.js

@@ -1,9 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.askNewGuid = void 0;
-const types_1 = require("../../types");
-const GuidActionType_1 = require("./GuidActionType");
-exports.askNewGuid = (0, types_1.createActionRequester)()({
-    actionType: GuidActionType_1.GuidActionType.New,
-});
-//# sourceMappingURL=askNewGuid.js.map

package/lib/commonjs/actions/guid/askNewGuid.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"askNewGuid.js","sourceRoot":"","sources":["../../../../src/actions/guid/askNewGuid.ts"],"names":[],"mappings":";;;AAAA,uCAAoD;AACpD,qDAAkD;AAErC,QAAA,UAAU,GAAG,IAAA,6BAAqB,GAAU,CAAC;IACxD,UAAU,EAAE,+BAAc,CAAC,GAAG;CAC/B,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../types';\nimport { GuidActionType } from './GuidActionType';\n\nexport const askNewGuid = createActionRequester<string>()({\n  actionType: GuidActionType.New,\n});\n"]}

package/lib/commonjs/actions/guid/askNewSortableGuid.d.ts

@@ -1,2 +0,0 @@
-import { GuidActionType } from './GuidActionType';
-export declare const askNewSortableGuid: import("../../types").ActionRequesterFunction<GuidActionType.NewSortable, [], undefined, string, never>;

package/lib/commonjs/actions/guid/askNewSortableGuid.js

@@ -1,9 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.askNewSortableGuid = void 0;
-const types_1 = require("../../types");
-const GuidActionType_1 = require("./GuidActionType");
-exports.askNewSortableGuid = (0, types_1.createActionRequester)()({
-    actionType: GuidActionType_1.GuidActionType.NewSortable,
-});
-//# sourceMappingURL=askNewSortableGuid.js.map

package/lib/commonjs/actions/guid/askNewSortableGuid.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"askNewSortableGuid.js","sourceRoot":"","sources":["../../../../src/actions/guid/askNewSortableGuid.ts"],"names":[],"mappings":";;;AAAA,uCAAoD;AACpD,qDAAkD;AAErC,QAAA,kBAAkB,GAAG,IAAA,6BAAqB,GAAU,CAAC;IAChE,UAAU,EAAE,+BAAc,CAAC,WAAW;CACvC,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../types';\nimport { GuidActionType } from './GuidActionType';\n\nexport const askNewSortableGuid = createActionRequester<string>()({\n  actionType: GuidActionType.NewSortable,\n});\n"]}

package/lib/commonjs/actions/guid/askNewSortableGuids.d.ts

@@ -1,4 +0,0 @@
-import { GuidActionType } from './GuidActionType';
-export declare const askNewSortableGuids: import("../../types").ActionRequesterFunction<GuidActionType.NewSortableMany, [count: number], {
-    count: number;
-}, string[], never>;

package/lib/commonjs/actions/guid/askNewSortableGuids.js

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.askNewSortableGuids = void 0;
-const types_1 = require("../../types");
-const GuidActionType_1 = require("./GuidActionType");
-// Mint `count` sortable ids in ONE action. The processor generates them in
-// sequence, so the returned array is itself in sort order: ids[0] < ids[1] < ...
-// (uuidv7's counter bits keep same-millisecond mints monotonic). The batch
-// primitive for bulk writers — one append fan-out should not pay one action
-// per id.
-exports.askNewSortableGuids = (0, types_1.createActionRequester)()({
-    actionType: GuidActionType_1.GuidActionType.NewSortableMany,
-    getPayload: (count) => ({ count }),
-});
-//# sourceMappingURL=askNewSortableGuids.js.map

package/lib/commonjs/actions/guid/askNewSortableGuids.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"askNewSortableGuids.js","sourceRoot":"","sources":["../../../../src/actions/guid/askNewSortableGuids.ts"],"names":[],"mappings":";;;AAAA,uCAAoD;AACpD,qDAAkD;AAElD,2EAA2E;AAC3E,iFAAiF;AACjF,2EAA2E;AAC3E,4EAA4E;AAC5E,UAAU;AACG,QAAA,mBAAmB,GAAG,IAAA,6BAAqB,GAAY,CAAC;IACnE,UAAU,EAAE,+BAAc,CAAC,eAAe;IAC1C,UAAU,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;CAC3C,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../types';\nimport { GuidActionType } from './GuidActionType';\n\n// Mint `count` sortable ids in ONE action. The processor generates them in\n// sequence, so the returned array is itself in sort order: ids[0] < ids[1] < ...\n// (uuidv7's counter bits keep same-millisecond mints monotonic). The batch\n// primitive for bulk writers — one append fan-out should not pay one action\n// per id.\nexport const askNewSortableGuids = createActionRequester<string[]>()({\n  actionType: GuidActionType.NewSortableMany,\n  getPayload: (count: number) => ({ count }),\n});\n"]}

package/lib/commonjs/actions/log/askLogTemplateLiteral.d.ts

@@ -1,11 +0,0 @@
-import { DecomposedString, DecomposedStringPrimitive } from '../../types';
-import { LogActionType } from './LogActionType';
-export type LogTemplateLiteralActionPayload = {
-    messageParts: DecomposedString;
-};
-export declare const askLogTemplateLiteral: import("../../types").ActionRequesterFunction<LogActionType.TemplateLiteral, [strings: TemplateStringsArray, ...variables: DecomposedStringPrimitive[]], {
-    messageParts: DecomposedString;
-}, void, never>;
-export declare const askLog: import("../../types").ActionRequesterFunction<LogActionType.TemplateLiteral, [strings: TemplateStringsArray, ...variables: DecomposedStringPrimitive[]], {
-    messageParts: DecomposedString;
-}, void, never>;

package/lib/commonjs/actions/log/askLogTemplateLiteral.js

@@ -1,13 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.askLog = exports.askLogTemplateLiteral = void 0;
-const createActionRequester_1 = require("../../types/utils/createActionRequester");
-const LogActionType_1 = require("./LogActionType");
-exports.askLogTemplateLiteral = (0, createActionRequester_1.createActionRequester)()({
-    actionType: LogActionType_1.LogActionType.TemplateLiteral,
-    getPayload: (strings, ...variables) => ({
-        messageParts: [[...strings], variables],
-    }),
-});
-exports.askLog = exports.askLogTemplateLiteral;
-//# sourceMappingURL=askLogTemplateLiteral.js.map

package/lib/commonjs/actions/log/askLogTemplateLiteral.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"askLogTemplateLiteral.js","sourceRoot":"","sources":["../../../../src/actions/log/askLogTemplateLiteral.ts"],"names":[],"mappings":";;;AACA,mFAAgF;AAChF,mDAAgD;AAMnC,QAAA,qBAAqB,GAAG,IAAA,6CAAqB,GAAQ,CAAC;IACjE,UAAU,EAAE,6BAAa,CAAC,eAAe;IACzC,UAAU,EAAE,CAAC,OAA6B,EAAE,GAAG,SAAsC,EAAE,EAAE,CAAC,CAAC;QACzF,YAAY,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,EAAE,SAAS,CAAqB;KAC5D,CAAC;CACH,CAAC,CAAC;AAEU,QAAA,MAAM,GAAG,6BAAqB,CAAC","sourcesContent":["import { DecomposedString, DecomposedStringPrimitive } from '../../types';\nimport { createActionRequester } from '../../types/utils/createActionRequester';\nimport { LogActionType } from './LogActionType';\n\nexport type LogTemplateLiteralActionPayload = {\n  messageParts: DecomposedString;\n};\n\nexport const askLogTemplateLiteral = createActionRequester<void>()({\n  actionType: LogActionType.TemplateLiteral,\n  getPayload: (strings: TemplateStringsArray, ...variables: DecomposedStringPrimitive[]) => ({\n    messageParts: [[...strings], variables] as DecomposedString,\n  }),\n});\n\nexport const askLog = askLogTemplateLiteral;\n"]}

package/lib/commonjs/actions/math/askRandomNumber.d.ts

@@ -1,6 +0,0 @@
-import { MathActionType } from './MathActionType';
-/**
- * A number in [0, 1) from the platform's plain pseudo-random generator (Math.random). Not a secure source: never use
- * it for tokens, ids or anything an attacker must not predict; use askSecureTokenGenerate or askNewGuid for those.
- */
-export declare const askRandomNumber: import("../../types").ActionRequesterFunction<MathActionType, [], undefined, number, never>;

package/lib/commonjs/actions/math/askRandomNumber.js

@@ -1,13 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.askRandomNumber = void 0;
-const types_1 = require("../../types");
-const MathActionType_1 = require("./MathActionType");
-/**
- * A number in [0, 1) from the platform's plain pseudo-random generator (Math.random). Not a secure source: never use
- * it for tokens, ids or anything an attacker must not predict; use askSecureTokenGenerate or askNewGuid for those.
- */
-exports.askRandomNumber = (0, types_1.createActionRequester)()({
-    actionType: MathActionType_1.MathActionType.RandomNumber,
-});
-//# sourceMappingURL=askRandomNumber.js.map

package/lib/commonjs/actions/math/askRandomNumber.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"askRandomNumber.js","sourceRoot":"","sources":["../../../../src/actions/math/askRandomNumber.ts"],"names":[],"mappings":";;;AAAA,uCAAoD;AACpD,qDAAkD;AAElD;;;GAGG;AACU,QAAA,eAAe,GAAG,IAAA,6BAAqB,GAAU,CAAC;IAC7D,UAAU,EAAE,+BAAc,CAAC,YAAY;CACxC,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../types';\nimport { MathActionType } from './MathActionType';\n\n/**\n * A number in [0, 1) from the platform's plain pseudo-random generator (Math.random). Not a secure source: never use\n * it for tokens, ids or anything an attacker must not predict; use askSecureTokenGenerate or askNewGuid for those.\n */\nexport const askRandomNumber = createActionRequester<number>()({\n  actionType: MathActionType.RandomNumber,\n});\n"]}

package/lib/commonjs/actions/platform/askDelay.d.ts

@@ -1,4 +0,0 @@
-import { PlatformActionType } from './PlatformActionType';
-export declare const askDelay: import("../../types").ActionRequesterFunction<PlatformActionType.Delay, [timeMs: number], {
-    timeMs: number;
-}, void, never>;