quidproquo-core 0.1.2 → 0.1.3

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

@@ -13,6 +13,7 @@ export * from './inlineFunction';
 export * from './keyValueStore';
 export * from './log';
 export * from './math';
+export * from './metric';
 export * from './network';
 export * from './platform';
 export * from './queue';

package/lib/commonjs/actions/index.js

@@ -29,6 +29,7 @@ __exportStar(require("./inlineFunction"), exports);
 __exportStar(require("./keyValueStore"), exports);
 __exportStar(require("./log"), exports);
 __exportStar(require("./math"), exports);
+__exportStar(require("./metric"), exports);
 __exportStar(require("./network"), exports);
 __exportStar(require("./platform"), exports);
 __exportStar(require("./queue"), exports);

package/lib/commonjs/actions/metric/MetricActionType.d.ts

@@ -0,0 +1,3 @@
+export declare enum MetricActionType {
+    Put = "@quidproquo-core/Metric/Put"
+}

package/lib/commonjs/actions/metric/MetricActionType.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetricActionType = void 0;
+var MetricActionType;
+(function (MetricActionType) {
+    MetricActionType["Put"] = "@quidproquo-core/Metric/Put";
+})(MetricActionType || (exports.MetricActionType = MetricActionType = {}));

package/lib/commonjs/actions/metric/MetricPutActionRequester.d.ts

@@ -0,0 +1,7 @@
+import { MetricPutActionRequester } from './MetricPutActionTypes';
+import { MetricUnit } from './MetricUnit';
+export interface AskMetricPutOptions {
+    unit?: MetricUnit;
+    dimensions?: Record<string, string>;
+}
+export declare function askMetricPut(metricName: string, value?: number, options?: AskMetricPutOptions): MetricPutActionRequester;

package/lib/commonjs/actions/metric/MetricPutActionRequester.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askMetricPut = askMetricPut;
+const MetricActionType_1 = require("./MetricActionType");
+function* askMetricPut(metricName, value = 1, options) {
+    return yield {
+        type: MetricActionType_1.MetricActionType.Put,
+        payload: {
+            metricName,
+            value,
+            unit: options === null || options === void 0 ? void 0 : options.unit,
+            dimensions: options === null || options === void 0 ? void 0 : options.dimensions,
+        },
+    };
+}

package/lib/commonjs/actions/metric/MetricPutActionTypes.d.ts

@@ -0,0 +1,20 @@
+import { Action, ActionProcessor, ActionRequester } from '../../types/Action';
+import { MetricActionType } from './MetricActionType';
+import { MetricUnit } from './MetricUnit';
+export interface MetricPutActionPayload {
+    metricName: string;
+    value: number;
+    unit?: MetricUnit;
+    /**
+     * Extra metric dimensions on top of the standard service/environment ones. Each unique
+     * dimension combination is its own metric (and its own cost) - keep these
+     * low-cardinality: never per-user or per-request identifiers.
+     */
+    dimensions?: Record<string, string>;
+}
+export interface MetricPutAction extends Action<MetricPutActionPayload> {
+    type: MetricActionType.Put;
+    payload: MetricPutActionPayload;
+}
+export type MetricPutActionProcessor = ActionProcessor<MetricPutAction, void>;
+export type MetricPutActionRequester = ActionRequester<MetricPutAction, void>;

package/lib/commonjs/actions/metric/MetricPutActionTypes.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/commonjs/actions/metric/MetricUnit.d.ts

@@ -0,0 +1,8 @@
+export declare enum MetricUnit {
+    count = "Count",
+    milliseconds = "Milliseconds",
+    seconds = "Seconds",
+    bytes = "Bytes",
+    percent = "Percent",
+    none = "None"
+}

package/lib/commonjs/actions/metric/MetricUnit.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetricUnit = void 0;
+// Values are the CloudWatch unit strings.
+var MetricUnit;
+(function (MetricUnit) {
+    MetricUnit["count"] = "Count";
+    MetricUnit["milliseconds"] = "Milliseconds";
+    MetricUnit["seconds"] = "Seconds";
+    MetricUnit["bytes"] = "Bytes";
+    MetricUnit["percent"] = "Percent";
+    MetricUnit["none"] = "None";
+})(MetricUnit || (exports.MetricUnit = MetricUnit = {}));

package/lib/commonjs/actions/metric/index.d.ts

@@ -0,0 +1,4 @@
+export * from './MetricActionType';
+export * from './MetricPutActionRequester';
+export * from './MetricPutActionTypes';
+export * from './MetricUnit';

package/lib/commonjs/actions/metric/index.js

@@ -0,0 +1,20 @@
+"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("./MetricActionType"), exports);
+__exportStar(require("./MetricPutActionRequester"), exports);
+__exportStar(require("./MetricPutActionTypes"), exports);
+__exportStar(require("./MetricUnit"), exports);

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

@@ -22,7 +22,9 @@ export declare enum QPQCoreConfigSettingType {
     graphDatabase = "@quidproquo-core/config/GraphDatabase",
     virtualNetwork = "@quidproquo-core/config/VirtualNetwork",
     notifyError = "@quidproquo-core/config/notifyError",
-    inlineFunction = "@quidproquo-core/config/InlineFunction"
+    inlineFunction = "@quidproquo-core/config/InlineFunction",
+    javascriptRuntime = "@quidproquo-core/config/JavascriptRuntime",
+    federatedModuleStore = "@quidproquo-core/config/FederatedModuleStore"
 }
 export interface QPQConfigSetting {
     configSettingType: string;

package/lib/commonjs/config/QPQConfig.js

@@ -26,4 +26,6 @@ var QPQCoreConfigSettingType;
     QPQCoreConfigSettingType["virtualNetwork"] = "@quidproquo-core/config/VirtualNetwork";
     QPQCoreConfigSettingType["notifyError"] = "@quidproquo-core/config/notifyError";
     QPQCoreConfigSettingType["inlineFunction"] = "@quidproquo-core/config/InlineFunction";
+    QPQCoreConfigSettingType["javascriptRuntime"] = "@quidproquo-core/config/JavascriptRuntime";
+    QPQCoreConfigSettingType["federatedModuleStore"] = "@quidproquo-core/config/FederatedModuleStore";
 })(QPQCoreConfigSettingType || (exports.QPQCoreConfigSettingType = QPQCoreConfigSettingType = {}));

package/lib/commonjs/config/settings/federatedModuleStore.d.ts

@@ -0,0 +1,11 @@
+import { QPQConfigSetting } from '../QPQConfig';
+export interface FederatedModuleStoreOptions {
+    recheckMs?: number;
+    bundleFallback?: boolean;
+}
+export interface FederatedModuleStoreQPQConfigSetting extends QPQConfigSetting {
+    storageDrive: string;
+    recheckMs?: number;
+    bundleFallback: boolean;
+}
+export declare const defineFederatedModuleStore: (storageDrive: string, options?: FederatedModuleStoreOptions) => FederatedModuleStoreQPQConfigSetting;

package/lib/commonjs/config/settings/federatedModuleStore.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineFederatedModuleStore = void 0;
+const QPQConfig_1 = require("../QPQConfig");
+const defineFederatedModuleStore = (storageDrive, options) => {
+    var _a;
+    return ({
+        configSettingType: QPQConfig_1.QPQCoreConfigSettingType.federatedModuleStore,
+        uniqueKey: 'FederatedModuleStore',
+        storageDrive,
+        recheckMs: options === null || options === void 0 ? void 0 : options.recheckMs,
+        bundleFallback: (_a = options === null || options === void 0 ? void 0 : options.bundleFallback) !== null && _a !== void 0 ? _a : true,
+    });
+};
+exports.defineFederatedModuleStore = defineFederatedModuleStore;

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

@@ -11,9 +11,11 @@ export * from './deployEvent';
 export * from './emailTemplates';
 export * from './environmentSettings';
 export * from './eventBus';
+export * from './federatedModuleStore';
 export * from './global';
 export * from './graphDatabase';
 export * from './inlineFunction';
+export * from './javascriptRuntime';
 export * from './keyValueStore';
 export * from './moduleName';
 export * from './notifyError';

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

@@ -27,9 +27,11 @@ __exportStar(require("./deployEvent"), exports);
 __exportStar(require("./emailTemplates"), exports);
 __exportStar(require("./environmentSettings"), exports);
 __exportStar(require("./eventBus"), exports);
+__exportStar(require("./federatedModuleStore"), exports);
 __exportStar(require("./global"), exports);
 __exportStar(require("./graphDatabase"), exports);
 __exportStar(require("./inlineFunction"), exports);
+__exportStar(require("./javascriptRuntime"), exports);
 __exportStar(require("./keyValueStore"), exports);
 __exportStar(require("./moduleName"), exports);
 __exportStar(require("./notifyError"), exports);

package/lib/commonjs/config/settings/javascriptRuntime.d.ts

@@ -0,0 +1,19 @@
+import { QPQConfigAdvancedSettings, QPQConfigSetting } from '../QPQConfig';
+export declare enum JavascriptRuntimeVersion {
+    Node20 = "node20",
+    Node22 = "node22",
+    Node24 = "node24"
+}
+export declare enum JavascriptRuntimeArchitecture {
+    Arm64 = "arm64",
+    X86_64 = "x86_64"
+}
+export interface QPQConfigAdvancedJavascriptRuntimeSettings extends QPQConfigAdvancedSettings {
+    runtimeVersion?: JavascriptRuntimeVersion;
+    architecture?: JavascriptRuntimeArchitecture;
+}
+export interface JavascriptRuntimeQPQConfigSetting extends QPQConfigSetting {
+    runtimeVersion: JavascriptRuntimeVersion;
+    architecture: JavascriptRuntimeArchitecture;
+}
+export declare const defineJavascriptRuntime: (options?: QPQConfigAdvancedJavascriptRuntimeSettings) => JavascriptRuntimeQPQConfigSetting;

package/lib/commonjs/config/settings/javascriptRuntime.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineJavascriptRuntime = exports.JavascriptRuntimeArchitecture = exports.JavascriptRuntimeVersion = void 0;
+const QPQConfig_1 = require("../QPQConfig");
+// Cloud-agnostic runtime identifiers - the deploy layer maps these to
+// platform specific values (e.g. aws_lambda.Runtime / aws_lambda.Architecture)
+var JavascriptRuntimeVersion;
+(function (JavascriptRuntimeVersion) {
+    JavascriptRuntimeVersion["Node20"] = "node20";
+    JavascriptRuntimeVersion["Node22"] = "node22";
+    JavascriptRuntimeVersion["Node24"] = "node24";
+})(JavascriptRuntimeVersion || (exports.JavascriptRuntimeVersion = JavascriptRuntimeVersion = {}));
+var JavascriptRuntimeArchitecture;
+(function (JavascriptRuntimeArchitecture) {
+    JavascriptRuntimeArchitecture["Arm64"] = "arm64";
+    JavascriptRuntimeArchitecture["X86_64"] = "x86_64";
+})(JavascriptRuntimeArchitecture || (exports.JavascriptRuntimeArchitecture = JavascriptRuntimeArchitecture = {}));
+const defineJavascriptRuntime = (options) => {
+    var _a, _b;
+    return ({
+        configSettingType: QPQConfig_1.QPQCoreConfigSettingType.javascriptRuntime,
+        uniqueKey: 'JavascriptRuntime',
+        runtimeVersion: (_a = options === null || options === void 0 ? void 0 : options.runtimeVersion) !== null && _a !== void 0 ? _a : JavascriptRuntimeVersion.Node22,
+        architecture: (_b = options === null || options === void 0 ? void 0 : options.architecture) !== null && _b !== void 0 ? _b : JavascriptRuntimeArchitecture.Arm64,
+    });
+};
+exports.defineJavascriptRuntime = defineJavascriptRuntime;

package/lib/commonjs/config/settings/schedule.d.ts

@@ -6,12 +6,14 @@ export declare enum ScheduleTypeEnum {
 export interface QPQConfigAdvancedScheduleSettings extends QPQConfigAdvancedSettings {
     metadata?: Record<string, any>;
     owner?: CrossModuleOwner<'recurringSchedule'>;
+    maxConcurrentExecutions?: number;
 }
 export interface ScheduleQPQConfigSetting extends QPQConfigSetting {
     scheduleType: ScheduleTypeEnum;
     runtime: QpqFunctionRuntime;
     cronExpression: string;
     metadata: Record<string, any>;
+    maxConcurrentExecutions?: number;
     owner?: CrossModuleOwner;
 }
 /**

package/lib/commonjs/config/settings/schedule.js

@@ -77,6 +77,7 @@ const defineRecurringSchedule = (cronExpression, runtime, options) => {
         runtime,
         cronExpression,
         metadata: (options === null || options === void 0 ? void 0 : options.metadata) || {},
+        maxConcurrentExecutions: options === null || options === void 0 ? void 0 : options.maxConcurrentExecutions,
         owner: (0, crossModuleUtils_1.convertCrossModuleOwnerToGenericResourceNameOverride)(options === null || options === void 0 ? void 0 : options.owner),
     };
 };

package/lib/commonjs/qpqCoreUtils.d.ts

@@ -1,4 +1,4 @@
-import { AiQPQConfigSetting, ApplicationQPQConfigSetting, ClaudeAIQPQConfigSetting, DeployEventsQPQConfigSetting, EmailTemplates, EventBusQPQConfigSetting, GraphDatabaseQPQConfigSetting, InlineFunctionQPQConfigSetting, KeyValueStoreQPQConfigSetting, NotifyErrorQPQConfigSetting, ParameterQPQConfigSetting, QPQConfig, QPQConfigSetting, QpqQueueProcessors, QueueQPQConfigSetting, ScheduleQPQConfigSetting, SecretQPQConfigSetting, StorageDriveQPQConfigSetting, UserDirectoryQPQConfigSetting, VirtualNetworkQPQConfigSetting } from './config';
+import { AiQPQConfigSetting, ApplicationQPQConfigSetting, ClaudeAIQPQConfigSetting, DeployEventsQPQConfigSetting, EmailTemplates, EventBusQPQConfigSetting, FederatedModuleStoreQPQConfigSetting, GraphDatabaseQPQConfigSetting, InlineFunctionQPQConfigSetting, JavascriptRuntimeQPQConfigSetting, KeyValueStoreQPQConfigSetting, NotifyErrorQPQConfigSetting, ParameterQPQConfigSetting, QPQConfig, QPQConfigSetting, QpqQueueProcessors, QueueQPQConfigSetting, ScheduleQPQConfigSetting, SecretQPQConfigSetting, StorageDriveQPQConfigSetting, UserDirectoryQPQConfigSetting, VirtualNetworkQPQConfigSetting } from './config';
 import { ConfigUrl, CrossServiceResourceName, CustomFullyQualifiedResource, FullyQualifiedResource, QpqFunctionRuntime, ResourceName } from './types';
 /**
  * Flattens a QPQConfig array into a single array of QPQConfigSetting objects.
@@ -43,6 +43,7 @@ export declare const getConfigRoot: (qpqConfig: QPQConfig) => string;
 export declare const getApplicationModuleEnvironment: (qpqConfig: QPQConfig) => string;
 export declare const getStorageDrives: (configs: QPQConfig) => StorageDriveQPQConfigSetting[];
 export declare const getStorageDriveByName: (storageDriveName: string, configs: QPQConfig) => StorageDriveQPQConfigSetting | undefined;
+export declare const getFederatedModuleStore: (qpqConfig: QPQConfig) => FederatedModuleStoreQPQConfigSetting | undefined;
 export declare const getQueues: (configs: QPQConfig) => QueueQPQConfigSetting[];
 export declare const getOwnedQueues: (configs: QPQConfig) => QueueQPQConfigSetting[];
 export declare const getNotifyErrorConfigs: (configs: QPQConfig) => NotifyErrorQPQConfigSetting[];
@@ -50,6 +51,7 @@ export declare const getQueueByName: (configs: QPQConfig, name: string) => Queue
 export declare const getStorageDriveNames: (configs: QPQConfig) => string[];
 export declare const getAllEventBusConfigs: (qpqConfig: QPQConfig) => EventBusQPQConfigSetting[];
 export declare const getAllAiConfigs: (qpqConfig: QPQConfig) => AiQPQConfigSetting[];
+export declare const getJavascriptRuntimeConfig: (qpqConfig: QPQConfig) => JavascriptRuntimeQPQConfigSetting;
 export declare const getAllClaudeAiConfigs: (qpqConfig: QPQConfig) => ClaudeAIQPQConfigSetting[];
 export declare const getOwnedEventBusConfigs: (qpqConfig: QPQConfig) => EventBusQPQConfigSetting[];
 export declare const getEventBusConfigByName: (eventBusName: string, qpqConfig: QPQConfig) => EventBusQPQConfigSetting | undefined;

package/lib/commonjs/qpqCoreUtils.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getOwnedUserDirectories = exports.getUserDirectories = exports.resolveGlobalValue = exports.getGlobalConfigValue = exports.getOwnedSecrets = exports.getAllSecretConfigs = exports.getSecretByName = exports.getSrcFilenameFromQpqFunctionRuntime = exports.getApiBuildPath = exports.getAllSrcEntries = exports.getOwnedInlineFunctions = exports.getAllInlineFunctions = exports.getUserDirectorySrcEntries = exports.getQueueSrcEntries = exports.getOwnedScheduleEvents = exports.getScheduleEvents = exports.getUserDirectoryEmailTemplates = exports.getActionProcessorSources = exports.getKeyValueStoreByName = exports.resolveCrossServiceResourceName = exports.getOwnedStorageDrives = exports.getOwnedGraphDatabases = exports.getOwnedKeyValueStores = exports.getVirualNetworkConfigs = exports.getDeployEventConfigs = exports.getAllGraphDatabaseConfigs = exports.getAllKeyValueStores = exports.getOwnedItems = exports.getEventBusConfigByName = exports.getOwnedEventBusConfigs = exports.getAllClaudeAiConfigs = exports.getAllAiConfigs = exports.getAllEventBusConfigs = exports.getStorageDriveNames = exports.getQueueByName = exports.getNotifyErrorConfigs = exports.getOwnedQueues = exports.getQueues = exports.getStorageDriveByName = exports.getStorageDrives = exports.getApplicationModuleEnvironment = exports.getConfigRoot = exports.getApplicationModuleFeature = exports.getApplicationName = exports.getApplicationConfigRoot = exports.getApplicationModuleName = exports.getApplicationConfigSetting = exports.getConfigSetting = exports.getConfigSettings = exports.flattenQpqConfig = void 0;
-exports.getFullUrlFromConfigUrl = exports.isSameResource = exports.getKeyValueStoreFullyQualifiedResourceName = exports.getFullyQualifiedResourceName = exports.convertCustomFullyQualifiedResourceToGeneric = exports.getQueueQueueProcessors = exports.getUniqueKeyForSetting = exports.getOwnedParameterConfigs = exports.getParameterConfig = exports.getAllParameterConfigs = exports.getUserDirectoryByName = void 0;
+exports.resolveGlobalValue = exports.getGlobalConfigValue = exports.getOwnedSecrets = exports.getAllSecretConfigs = exports.getSecretByName = exports.getSrcFilenameFromQpqFunctionRuntime = exports.getApiBuildPath = exports.getAllSrcEntries = exports.getOwnedInlineFunctions = exports.getAllInlineFunctions = exports.getUserDirectorySrcEntries = exports.getQueueSrcEntries = exports.getOwnedScheduleEvents = exports.getScheduleEvents = exports.getUserDirectoryEmailTemplates = exports.getActionProcessorSources = exports.getKeyValueStoreByName = exports.resolveCrossServiceResourceName = exports.getOwnedStorageDrives = exports.getOwnedGraphDatabases = exports.getOwnedKeyValueStores = exports.getVirualNetworkConfigs = exports.getDeployEventConfigs = exports.getAllGraphDatabaseConfigs = exports.getAllKeyValueStores = exports.getOwnedItems = exports.getEventBusConfigByName = exports.getOwnedEventBusConfigs = exports.getAllClaudeAiConfigs = exports.getJavascriptRuntimeConfig = exports.getAllAiConfigs = exports.getAllEventBusConfigs = exports.getStorageDriveNames = exports.getQueueByName = exports.getNotifyErrorConfigs = exports.getOwnedQueues = exports.getQueues = exports.getFederatedModuleStore = exports.getStorageDriveByName = exports.getStorageDrives = exports.getApplicationModuleEnvironment = exports.getConfigRoot = exports.getApplicationModuleFeature = exports.getApplicationName = exports.getApplicationConfigRoot = exports.getApplicationModuleName = exports.getApplicationConfigSetting = exports.getConfigSetting = exports.getConfigSettings = exports.flattenQpqConfig = void 0;
+exports.getFullUrlFromConfigUrl = exports.isSameResource = exports.getKeyValueStoreFullyQualifiedResourceName = exports.getFullyQualifiedResourceName = exports.convertCustomFullyQualifiedResourceToGeneric = exports.getQueueQueueProcessors = exports.getUniqueKeyForSetting = exports.getOwnedParameterConfigs = exports.getParameterConfig = exports.getAllParameterConfigs = exports.getUserDirectoryByName = exports.getOwnedUserDirectories = exports.getUserDirectories = void 0;
 const config_1 = require("./config");
 const utils_1 = require("./utils");
 /**
@@ -143,6 +143,10 @@ const getStorageDriveByName = (storageDriveName, configs) => {
     return (0, exports.getStorageDrives)(configs).find((sd) => sd.storageDrive === storageDriveName);
 };
 exports.getStorageDriveByName = getStorageDriveByName;
+const getFederatedModuleStore = (qpqConfig) => {
+    return (0, exports.getConfigSetting)(qpqConfig, config_1.QPQCoreConfigSettingType.federatedModuleStore);
+};
+exports.getFederatedModuleStore = getFederatedModuleStore;
 const getQueues = (configs) => {
     return (0, exports.getConfigSettings)(configs, config_1.QPQCoreConfigSettingType.queue);
 };
@@ -173,6 +177,12 @@ const getAllAiConfigs = (qpqConfig) => {
     return (0, exports.getConfigSettings)(qpqConfig, config_1.QPQCoreConfigSettingType.ai);
 };
 exports.getAllAiConfigs = getAllAiConfigs;
+// Always resolves - falls back to the defineJavascriptRuntime defaults when no setting is present
+const getJavascriptRuntimeConfig = (qpqConfig) => {
+    var _a;
+    return (_a = (0, exports.getConfigSetting)(qpqConfig, config_1.QPQCoreConfigSettingType.javascriptRuntime)) !== null && _a !== void 0 ? _a : (0, config_1.defineJavascriptRuntime)();
+};
+exports.getJavascriptRuntimeConfig = getJavascriptRuntimeConfig;
 const getAllClaudeAiConfigs = (qpqConfig) => {
     const claudeAis = (0, exports.getConfigSettings)(qpqConfig, config_1.QPQCoreConfigSettingType.claudeAi);
     return claudeAis;

package/lib/commonjs/qpqCoreUtilsLib.d.ts

@@ -14,6 +14,7 @@ export declare const qpqCoreUtils: {
     getApplicationModuleEnvironment: (qpqConfig: import("./config").QPQConfig) => string;
     getStorageDrives: (configs: import("./config").QPQConfig) => import("./config").StorageDriveQPQConfigSetting[];
     getStorageDriveByName: (storageDriveName: string, configs: import("./config").QPQConfig) => import("./config").StorageDriveQPQConfigSetting | undefined;
+    getFederatedModuleStore: (qpqConfig: import("./config").QPQConfig) => import("./config").FederatedModuleStoreQPQConfigSetting | undefined;
     getQueues: (configs: import("./config").QPQConfig) => import("./config").QueueQPQConfigSetting[];
     getOwnedQueues: (configs: import("./config").QPQConfig) => import("./config").QueueQPQConfigSetting[];
     getNotifyErrorConfigs: (configs: import("./config").QPQConfig) => import("./config").NotifyErrorQPQConfigSetting[];
@@ -21,6 +22,7 @@ export declare const qpqCoreUtils: {
     getStorageDriveNames: (configs: import("./config").QPQConfig) => string[];
     getAllEventBusConfigs: (qpqConfig: import("./config").QPQConfig) => import("./config").EventBusQPQConfigSetting[];
     getAllAiConfigs: (qpqConfig: import("./config").QPQConfig) => import("./config").AiQPQConfigSetting[];
+    getJavascriptRuntimeConfig: (qpqConfig: import("./config").QPQConfig) => import("./config").JavascriptRuntimeQPQConfigSetting;
     getAllClaudeAiConfigs: (qpqConfig: import("./config").QPQConfig) => import("./config").ClaudeAIQPQConfigSetting[];
     getOwnedEventBusConfigs: (qpqConfig: import("./config").QPQConfig) => import("./config").EventBusQPQConfigSetting[];
     getEventBusConfigByName: (eventBusName: string, qpqConfig: import("./config").QPQConfig) => import("./config").EventBusQPQConfigSetting | undefined;

package/lib/commonjs/utils/path/getFederatedKeyFromQpqFunctionRuntime.d.ts

@@ -0,0 +1,2 @@
+import { QpqFunctionRuntime } from '../../types';
+export declare function getFederatedKeyFromQpqFunctionRuntime(qpqFunctionRuntime: QpqFunctionRuntime): string;

package/lib/commonjs/utils/path/getFederatedKeyFromQpqFunctionRuntime.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFederatedKeyFromQpqFunctionRuntime = getFederatedKeyFromQpqFunctionRuntime;
+const isQpqFunctionRuntimeAdvanced_1 = require("./isQpqFunctionRuntimeAdvanced");
+// A machine-INDEPENDENT identity key for a runtime, used to match a published
+// federated module against the runtime the lambda asks for.
+//
+// getUniqueKeyFromQpqFunctionRuntime is unsuitable here: for advanced runtimes it
+// embeds `basePath`, an absolute filesystem path. Federation deliberately builds
+// the lambda shell and publishes the artifacts as separate steps (often on
+// different machines / CI), so an absolute path in the key makes the publisher's
+// manifest key never equal the lambda's lookup key. We key on the relative path +
+// function name instead, which is stable across machines.
+function getFederatedKeyFromQpqFunctionRuntime(qpqFunctionRuntime) {
+    if ((0, isQpqFunctionRuntimeAdvanced_1.isQpqFunctionRuntimeAdvanced)(qpqFunctionRuntime)) {
+        const relativePath = qpqFunctionRuntime.relativePath.replace(/\\/g, '/').replace(/^\//, '');
+        return `${relativePath}::${qpqFunctionRuntime.functionName}`;
+    }
+    // Relative-string runtimes are already machine-independent.
+    return qpqFunctionRuntime;
+}

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

@@ -1,3 +1,4 @@
+export * from './getFederatedKeyFromQpqFunctionRuntime';
 export * from './getUniqueKeyFromQpqFunctionRuntime';
 export * from './isQpqFunctionRuntimeAdvanced';
 export * from './isQpqFunctionRuntimeRelativePath';

package/lib/commonjs/utils/path/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("./getFederatedKeyFromQpqFunctionRuntime"), exports);
 __exportStar(require("./getUniqueKeyFromQpqFunctionRuntime"), exports);
 __exportStar(require("./isQpqFunctionRuntimeAdvanced"), exports);
 __exportStar(require("./isQpqFunctionRuntimeRelativePath"), exports);

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

@@ -13,6 +13,7 @@ export * from './inlineFunction';
 export * from './keyValueStore';
 export * from './log';
 export * from './math';
+export * from './metric';
 export * from './network';
 export * from './platform';
 export * from './queue';

package/lib/esm/actions/index.js

@@ -13,6 +13,7 @@ export * from './inlineFunction';
 export * from './keyValueStore';
 export * from './log';
 export * from './math';
+export * from './metric';
 export * from './network';
 export * from './platform';
 export * from './queue';

package/lib/esm/actions/metric/MetricActionType.d.ts

@@ -0,0 +1,3 @@
+export declare enum MetricActionType {
+    Put = "@quidproquo-core/Metric/Put"
+}

package/lib/esm/actions/metric/MetricActionType.js

@@ -0,0 +1,4 @@
+export var MetricActionType;
+(function (MetricActionType) {
+    MetricActionType["Put"] = "@quidproquo-core/Metric/Put";
+})(MetricActionType || (MetricActionType = {}));

package/lib/esm/actions/metric/MetricPutActionRequester.d.ts

@@ -0,0 +1,7 @@
+import { MetricPutActionRequester } from './MetricPutActionTypes';
+import { MetricUnit } from './MetricUnit';
+export interface AskMetricPutOptions {
+    unit?: MetricUnit;
+    dimensions?: Record<string, string>;
+}
+export declare function askMetricPut(metricName: string, value?: number, options?: AskMetricPutOptions): MetricPutActionRequester;

package/lib/esm/actions/metric/MetricPutActionRequester.js

@@ -0,0 +1,12 @@
+import { MetricActionType } from './MetricActionType';
+export function* askMetricPut(metricName, value = 1, options) {
+    return yield {
+        type: MetricActionType.Put,
+        payload: {
+            metricName,
+            value,
+            unit: options?.unit,
+            dimensions: options?.dimensions,
+        },
+    };
+}

package/lib/esm/actions/metric/MetricPutActionTypes.d.ts

@@ -0,0 +1,20 @@
+import { Action, ActionProcessor, ActionRequester } from '../../types/Action';
+import { MetricActionType } from './MetricActionType';
+import { MetricUnit } from './MetricUnit';
+export interface MetricPutActionPayload {
+    metricName: string;
+    value: number;
+    unit?: MetricUnit;
+    /**
+     * Extra metric dimensions on top of the standard service/environment ones. Each unique
+     * dimension combination is its own metric (and its own cost) - keep these
+     * low-cardinality: never per-user or per-request identifiers.
+     */
+    dimensions?: Record<string, string>;
+}
+export interface MetricPutAction extends Action<MetricPutActionPayload> {
+    type: MetricActionType.Put;
+    payload: MetricPutActionPayload;
+}
+export type MetricPutActionProcessor = ActionProcessor<MetricPutAction, void>;
+export type MetricPutActionRequester = ActionRequester<MetricPutAction, void>;

package/lib/esm/actions/metric/MetricPutActionTypes.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/actions/metric/MetricUnit.d.ts

@@ -0,0 +1,8 @@
+export declare enum MetricUnit {
+    count = "Count",
+    milliseconds = "Milliseconds",
+    seconds = "Seconds",
+    bytes = "Bytes",
+    percent = "Percent",
+    none = "None"
+}

package/lib/esm/actions/metric/MetricUnit.js

@@ -0,0 +1,10 @@
+// Values are the CloudWatch unit strings.
+export var MetricUnit;
+(function (MetricUnit) {
+    MetricUnit["count"] = "Count";
+    MetricUnit["milliseconds"] = "Milliseconds";
+    MetricUnit["seconds"] = "Seconds";
+    MetricUnit["bytes"] = "Bytes";
+    MetricUnit["percent"] = "Percent";
+    MetricUnit["none"] = "None";
+})(MetricUnit || (MetricUnit = {}));

package/lib/esm/actions/metric/index.d.ts

@@ -0,0 +1,4 @@
+export * from './MetricActionType';
+export * from './MetricPutActionRequester';
+export * from './MetricPutActionTypes';
+export * from './MetricUnit';

package/lib/esm/actions/metric/index.js

@@ -0,0 +1,4 @@
+export * from './MetricActionType';
+export * from './MetricPutActionRequester';
+export * from './MetricPutActionTypes';
+export * from './MetricUnit';

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

@@ -22,7 +22,9 @@ export declare enum QPQCoreConfigSettingType {
     graphDatabase = "@quidproquo-core/config/GraphDatabase",
     virtualNetwork = "@quidproquo-core/config/VirtualNetwork",
     notifyError = "@quidproquo-core/config/notifyError",
-    inlineFunction = "@quidproquo-core/config/InlineFunction"
+    inlineFunction = "@quidproquo-core/config/InlineFunction",
+    javascriptRuntime = "@quidproquo-core/config/JavascriptRuntime",
+    federatedModuleStore = "@quidproquo-core/config/FederatedModuleStore"
 }
 export interface QPQConfigSetting {
     configSettingType: string;

package/lib/esm/config/QPQConfig.js

@@ -23,4 +23,6 @@ export var QPQCoreConfigSettingType;
     QPQCoreConfigSettingType["virtualNetwork"] = "@quidproquo-core/config/VirtualNetwork";
     QPQCoreConfigSettingType["notifyError"] = "@quidproquo-core/config/notifyError";
     QPQCoreConfigSettingType["inlineFunction"] = "@quidproquo-core/config/InlineFunction";
+    QPQCoreConfigSettingType["javascriptRuntime"] = "@quidproquo-core/config/JavascriptRuntime";
+    QPQCoreConfigSettingType["federatedModuleStore"] = "@quidproquo-core/config/FederatedModuleStore";
 })(QPQCoreConfigSettingType || (QPQCoreConfigSettingType = {}));

package/lib/esm/config/settings/federatedModuleStore.d.ts

@@ -0,0 +1,11 @@
+import { QPQConfigSetting } from '../QPQConfig';
+export interface FederatedModuleStoreOptions {
+    recheckMs?: number;
+    bundleFallback?: boolean;
+}
+export interface FederatedModuleStoreQPQConfigSetting extends QPQConfigSetting {
+    storageDrive: string;
+    recheckMs?: number;
+    bundleFallback: boolean;
+}
+export declare const defineFederatedModuleStore: (storageDrive: string, options?: FederatedModuleStoreOptions) => FederatedModuleStoreQPQConfigSetting;

package/lib/esm/config/settings/federatedModuleStore.js

@@ -0,0 +1,8 @@
+import { QPQCoreConfigSettingType } from '../QPQConfig';
+export const defineFederatedModuleStore = (storageDrive, options) => ({
+    configSettingType: QPQCoreConfigSettingType.federatedModuleStore,
+    uniqueKey: 'FederatedModuleStore',
+    storageDrive,
+    recheckMs: options?.recheckMs,
+    bundleFallback: options?.bundleFallback ?? true,
+});

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

@@ -11,9 +11,11 @@ export * from './deployEvent';
 export * from './emailTemplates';
 export * from './environmentSettings';
 export * from './eventBus';
+export * from './federatedModuleStore';
 export * from './global';
 export * from './graphDatabase';
 export * from './inlineFunction';
+export * from './javascriptRuntime';
 export * from './keyValueStore';
 export * from './moduleName';
 export * from './notifyError';

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

@@ -11,9 +11,11 @@ export * from './deployEvent';
 export * from './emailTemplates';
 export * from './environmentSettings';
 export * from './eventBus';
+export * from './federatedModuleStore';
 export * from './global';
 export * from './graphDatabase';
 export * from './inlineFunction';
+export * from './javascriptRuntime';
 export * from './keyValueStore';
 export * from './moduleName';
 export * from './notifyError';

package/lib/esm/config/settings/javascriptRuntime.d.ts

@@ -0,0 +1,19 @@
+import { QPQConfigAdvancedSettings, QPQConfigSetting } from '../QPQConfig';
+export declare enum JavascriptRuntimeVersion {
+    Node20 = "node20",
+    Node22 = "node22",
+    Node24 = "node24"
+}
+export declare enum JavascriptRuntimeArchitecture {
+    Arm64 = "arm64",
+    X86_64 = "x86_64"
+}
+export interface QPQConfigAdvancedJavascriptRuntimeSettings extends QPQConfigAdvancedSettings {
+    runtimeVersion?: JavascriptRuntimeVersion;
+    architecture?: JavascriptRuntimeArchitecture;
+}
+export interface JavascriptRuntimeQPQConfigSetting extends QPQConfigSetting {
+    runtimeVersion: JavascriptRuntimeVersion;
+    architecture: JavascriptRuntimeArchitecture;
+}
+export declare const defineJavascriptRuntime: (options?: QPQConfigAdvancedJavascriptRuntimeSettings) => JavascriptRuntimeQPQConfigSetting;

package/lib/esm/config/settings/javascriptRuntime.js

@@ -0,0 +1,20 @@
+import { QPQCoreConfigSettingType } from '../QPQConfig';
+// Cloud-agnostic runtime identifiers - the deploy layer maps these to
+// platform specific values (e.g. aws_lambda.Runtime / aws_lambda.Architecture)
+export var JavascriptRuntimeVersion;
+(function (JavascriptRuntimeVersion) {
+    JavascriptRuntimeVersion["Node20"] = "node20";
+    JavascriptRuntimeVersion["Node22"] = "node22";
+    JavascriptRuntimeVersion["Node24"] = "node24";
+})(JavascriptRuntimeVersion || (JavascriptRuntimeVersion = {}));
+export var JavascriptRuntimeArchitecture;
+(function (JavascriptRuntimeArchitecture) {
+    JavascriptRuntimeArchitecture["Arm64"] = "arm64";
+    JavascriptRuntimeArchitecture["X86_64"] = "x86_64";
+})(JavascriptRuntimeArchitecture || (JavascriptRuntimeArchitecture = {}));
+export const defineJavascriptRuntime = (options) => ({
+    configSettingType: QPQCoreConfigSettingType.javascriptRuntime,
+    uniqueKey: 'JavascriptRuntime',
+    runtimeVersion: options?.runtimeVersion ?? JavascriptRuntimeVersion.Node22,
+    architecture: options?.architecture ?? JavascriptRuntimeArchitecture.Arm64,
+});

package/lib/esm/config/settings/schedule.d.ts

@@ -6,12 +6,14 @@ export declare enum ScheduleTypeEnum {
 export interface QPQConfigAdvancedScheduleSettings extends QPQConfigAdvancedSettings {
     metadata?: Record<string, any>;
     owner?: CrossModuleOwner<'recurringSchedule'>;
+    maxConcurrentExecutions?: number;
 }
 export interface ScheduleQPQConfigSetting extends QPQConfigSetting {
     scheduleType: ScheduleTypeEnum;
     runtime: QpqFunctionRuntime;
     cronExpression: string;
     metadata: Record<string, any>;
+    maxConcurrentExecutions?: number;
     owner?: CrossModuleOwner;
 }
 /**

package/lib/esm/config/settings/schedule.js

@@ -74,6 +74,7 @@ export const defineRecurringSchedule = (cronExpression, runtime, options) => {
         runtime,
         cronExpression,
         metadata: options?.metadata || {},
+        maxConcurrentExecutions: options?.maxConcurrentExecutions,
         owner: convertCrossModuleOwnerToGenericResourceNameOverride(options?.owner),
     };
 };

package/lib/esm/qpqCoreUtils.d.ts

@@ -1,4 +1,4 @@
-import { AiQPQConfigSetting, ApplicationQPQConfigSetting, ClaudeAIQPQConfigSetting, DeployEventsQPQConfigSetting, EmailTemplates, EventBusQPQConfigSetting, GraphDatabaseQPQConfigSetting, InlineFunctionQPQConfigSetting, KeyValueStoreQPQConfigSetting, NotifyErrorQPQConfigSetting, ParameterQPQConfigSetting, QPQConfig, QPQConfigSetting, QpqQueueProcessors, QueueQPQConfigSetting, ScheduleQPQConfigSetting, SecretQPQConfigSetting, StorageDriveQPQConfigSetting, UserDirectoryQPQConfigSetting, VirtualNetworkQPQConfigSetting } from './config';
+import { AiQPQConfigSetting, ApplicationQPQConfigSetting, ClaudeAIQPQConfigSetting, DeployEventsQPQConfigSetting, EmailTemplates, EventBusQPQConfigSetting, FederatedModuleStoreQPQConfigSetting, GraphDatabaseQPQConfigSetting, InlineFunctionQPQConfigSetting, JavascriptRuntimeQPQConfigSetting, KeyValueStoreQPQConfigSetting, NotifyErrorQPQConfigSetting, ParameterQPQConfigSetting, QPQConfig, QPQConfigSetting, QpqQueueProcessors, QueueQPQConfigSetting, ScheduleQPQConfigSetting, SecretQPQConfigSetting, StorageDriveQPQConfigSetting, UserDirectoryQPQConfigSetting, VirtualNetworkQPQConfigSetting } from './config';
 import { ConfigUrl, CrossServiceResourceName, CustomFullyQualifiedResource, FullyQualifiedResource, QpqFunctionRuntime, ResourceName } from './types';
 /**
  * Flattens a QPQConfig array into a single array of QPQConfigSetting objects.
@@ -43,6 +43,7 @@ export declare const getConfigRoot: (qpqConfig: QPQConfig) => string;
 export declare const getApplicationModuleEnvironment: (qpqConfig: QPQConfig) => string;
 export declare const getStorageDrives: (configs: QPQConfig) => StorageDriveQPQConfigSetting[];
 export declare const getStorageDriveByName: (storageDriveName: string, configs: QPQConfig) => StorageDriveQPQConfigSetting | undefined;
+export declare const getFederatedModuleStore: (qpqConfig: QPQConfig) => FederatedModuleStoreQPQConfigSetting | undefined;
 export declare const getQueues: (configs: QPQConfig) => QueueQPQConfigSetting[];
 export declare const getOwnedQueues: (configs: QPQConfig) => QueueQPQConfigSetting[];
 export declare const getNotifyErrorConfigs: (configs: QPQConfig) => NotifyErrorQPQConfigSetting[];
@@ -50,6 +51,7 @@ export declare const getQueueByName: (configs: QPQConfig, name: string) => Queue
 export declare const getStorageDriveNames: (configs: QPQConfig) => string[];
 export declare const getAllEventBusConfigs: (qpqConfig: QPQConfig) => EventBusQPQConfigSetting[];
 export declare const getAllAiConfigs: (qpqConfig: QPQConfig) => AiQPQConfigSetting[];
+export declare const getJavascriptRuntimeConfig: (qpqConfig: QPQConfig) => JavascriptRuntimeQPQConfigSetting;
 export declare const getAllClaudeAiConfigs: (qpqConfig: QPQConfig) => ClaudeAIQPQConfigSetting[];
 export declare const getOwnedEventBusConfigs: (qpqConfig: QPQConfig) => EventBusQPQConfigSetting[];
 export declare const getEventBusConfigByName: (eventBusName: string, qpqConfig: QPQConfig) => EventBusQPQConfigSetting | undefined;

package/lib/esm/qpqCoreUtils.js

@@ -1,4 +1,4 @@
-import { QPQCoreConfigSettingType, } from './config';
+import { defineJavascriptRuntime, QPQCoreConfigSettingType, } from './config';
 import { isQpqFunctionRuntimeAdvanced } from './utils';
 /**
  * Flattens a QPQConfig array into a single array of QPQConfigSetting objects.
@@ -126,6 +126,9 @@ export const getStorageDrives = (configs) => {
 export const getStorageDriveByName = (storageDriveName, configs) => {
     return getStorageDrives(configs).find((sd) => sd.storageDrive === storageDriveName);
 };
+export const getFederatedModuleStore = (qpqConfig) => {
+    return getConfigSetting(qpqConfig, QPQCoreConfigSettingType.federatedModuleStore);
+};
 export const getQueues = (configs) => {
     return getConfigSettings(configs, QPQCoreConfigSettingType.queue);
 };
@@ -149,6 +152,10 @@ export const getAllEventBusConfigs = (qpqConfig) => {
 export const getAllAiConfigs = (qpqConfig) => {
     return getConfigSettings(qpqConfig, QPQCoreConfigSettingType.ai);
 };
+// Always resolves - falls back to the defineJavascriptRuntime defaults when no setting is present
+export const getJavascriptRuntimeConfig = (qpqConfig) => {
+    return getConfigSetting(qpqConfig, QPQCoreConfigSettingType.javascriptRuntime) ?? defineJavascriptRuntime();
+};
 export const getAllClaudeAiConfigs = (qpqConfig) => {
     const claudeAis = getConfigSettings(qpqConfig, QPQCoreConfigSettingType.claudeAi);
     return claudeAis;

package/lib/esm/qpqCoreUtilsLib.d.ts

@@ -14,6 +14,7 @@ export declare const qpqCoreUtils: {
     getApplicationModuleEnvironment: (qpqConfig: import("./config").QPQConfig) => string;
     getStorageDrives: (configs: import("./config").QPQConfig) => import("./config").StorageDriveQPQConfigSetting[];
     getStorageDriveByName: (storageDriveName: string, configs: import("./config").QPQConfig) => import("./config").StorageDriveQPQConfigSetting | undefined;
+    getFederatedModuleStore: (qpqConfig: import("./config").QPQConfig) => import("./config").FederatedModuleStoreQPQConfigSetting | undefined;
     getQueues: (configs: import("./config").QPQConfig) => import("./config").QueueQPQConfigSetting[];
     getOwnedQueues: (configs: import("./config").QPQConfig) => import("./config").QueueQPQConfigSetting[];
     getNotifyErrorConfigs: (configs: import("./config").QPQConfig) => import("./config").NotifyErrorQPQConfigSetting[];
@@ -21,6 +22,7 @@ export declare const qpqCoreUtils: {
     getStorageDriveNames: (configs: import("./config").QPQConfig) => string[];
     getAllEventBusConfigs: (qpqConfig: import("./config").QPQConfig) => import("./config").EventBusQPQConfigSetting[];
     getAllAiConfigs: (qpqConfig: import("./config").QPQConfig) => import("./config").AiQPQConfigSetting[];
+    getJavascriptRuntimeConfig: (qpqConfig: import("./config").QPQConfig) => import("./config").JavascriptRuntimeQPQConfigSetting;
     getAllClaudeAiConfigs: (qpqConfig: import("./config").QPQConfig) => import("./config").ClaudeAIQPQConfigSetting[];
     getOwnedEventBusConfigs: (qpqConfig: import("./config").QPQConfig) => import("./config").EventBusQPQConfigSetting[];
     getEventBusConfigByName: (eventBusName: string, qpqConfig: import("./config").QPQConfig) => import("./config").EventBusQPQConfigSetting | undefined;

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

@@ -0,0 +1,2 @@
+import { QpqFunctionRuntime } from '../../types';
+export declare function getFederatedKeyFromQpqFunctionRuntime(qpqFunctionRuntime: QpqFunctionRuntime): string;

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

@@ -0,0 +1,18 @@
+import { isQpqFunctionRuntimeAdvanced } from './isQpqFunctionRuntimeAdvanced';
+// A machine-INDEPENDENT identity key for a runtime, used to match a published
+// federated module against the runtime the lambda asks for.
+//
+// getUniqueKeyFromQpqFunctionRuntime is unsuitable here: for advanced runtimes it
+// embeds `basePath`, an absolute filesystem path. Federation deliberately builds
+// the lambda shell and publishes the artifacts as separate steps (often on
+// different machines / CI), so an absolute path in the key makes the publisher's
+// manifest key never equal the lambda's lookup key. We key on the relative path +
+// function name instead, which is stable across machines.
+export function getFederatedKeyFromQpqFunctionRuntime(qpqFunctionRuntime) {
+    if (isQpqFunctionRuntimeAdvanced(qpqFunctionRuntime)) {
+        const relativePath = qpqFunctionRuntime.relativePath.replace(/\\/g, '/').replace(/^\//, '');
+        return `${relativePath}::${qpqFunctionRuntime.functionName}`;
+    }
+    // Relative-string runtimes are already machine-independent.
+    return qpqFunctionRuntime;
+}

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

@@ -1,3 +1,4 @@
+export * from './getFederatedKeyFromQpqFunctionRuntime';
 export * from './getUniqueKeyFromQpqFunctionRuntime';
 export * from './isQpqFunctionRuntimeAdvanced';
 export * from './isQpqFunctionRuntimeRelativePath';

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

@@ -1,3 +1,4 @@
+export * from './getFederatedKeyFromQpqFunctionRuntime';
 export * from './getUniqueKeyFromQpqFunctionRuntime';
 export * from './isQpqFunctionRuntimeAdvanced';
 export * from './isQpqFunctionRuntimeRelativePath';

package/package.json

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