@camstack/system 1.2.290 → 1.2.292

package/dist/{manifest-system-deps-D_5UXqDb.mjs → child-cap-dispatch-CWkcQIRe.mjs}

@@ -1,4 +1,3 @@
-import { C as PEER_BYTES_CHUNK_BYTES } from "./dist-BkjMEa2F.mjs";
 import "./hub-cap-forward-BdT320dq.mjs";
 import * as crypto$1 from "node:crypto";
 import { randomBytes, randomUUID } from "node:crypto";
@@ -17,7 +16,7 @@ import * as v8 from "node:v8";
 import { Session } from "node:inspector/promises";
 import { monitorEventLoopDelay } from "node:perf_hooks";
 import * as vm from "node:vm";
-import { BOOT_RECOVERY_BACKOFF_MS, DATAPLANE_SECRET_HEADER, DEVICE_CHILDREN_BATCH_MAX, DeviceType, DisposerChain, EventCategory, ReadinessRegistry, asJsonObject, asString, createDeviceProxy, createEventBusSliceSource, deviceOpsCapability, emitReadiness, errMsg, expandCapMethods, readNodePin, scopeKey, sleep, withCapInputDefaults } from "@camstack/types/addon";
+import { BOOT_RECOVERY_BACKOFF_MS, DATAPLANE_SECRET_HEADER, DEVICE_CHILDREN_BATCH_MAX, DeviceType, DisposerChain, EventCategory, PEER_BYTES_CHUNK_BYTES, PEER_BYTES_MAX_OUTSTANDING, PEER_BYTES_STALL_MS, PEER_BYTES_TICKET_TTL_MS, ReadinessRegistry, asJsonObject, asString, createDeviceProxy, createEventBusSliceSource, deviceOpsCapability, emitReadiness, errMsg, expandCapMethods, readNodePin, scopeKey, sleep, withCapInputDefaults } from "@camstack/types/addon";
 import { once } from "node:events";
 import { connect, createConnection, createServer as createServer$1 } from "node:net";
 import { TRPCClientError, createTRPCClient } from "@trpc/client";
@@ -2707,9 +2706,9 @@ async function writeBufferWithBackpressure(res, bytes, stallMs) {
 }
 function createAddonPeerBytesFacility(args) {
 	const now = args.now ?? (() => Date.now());
-	const ttlMs = args.ttlMs ?? 3e4;
-	const maxOutstanding = args.maxOutstanding ?? 64;
-	const stallMs = args.stallMs ?? 15e3;
+	const ttlMs = args.ttlMs ?? PEER_BYTES_TICKET_TTL_MS;
+	const maxOutstanding = args.maxOutstanding ?? PEER_BYTES_MAX_OUTSTANDING;
+	const stallMs = args.stallMs ?? PEER_BYTES_STALL_MS;
 	const host = args.host ?? "127.0.0.1";
 	const hostNodeId = hostNodeIdOf(args.nodeId);
 	const offers = /* @__PURE__ */ new Map();
@@ -12271,4 +12270,54 @@ async function defaultRun(command, args) {
 	await execFileAsync(command, [...args], { timeout: INSTALL_TIMEOUT_MS });
 }
 //#endregion
-export { buildNativeCapProxy as $, strandedMb as $t, createUdsLogger as A, readSocketQueues as An, HEAP_RECLAIM_TRIGGER_MB as At, UDS_NO_ROUTE_PREFIX as B, MAX_CAP_ACTIONS_PER_PEER as Bn, ZERO_LOOP_DELAY as Bt, deviceCapResolverLink as C, EMPTY_SOCKET_PLANE_BASELINE as Cn, resolveNpmInvocation as Ct, createUdsEventBridge as D, createSocketPlaneReader as Dn, createAddonDataPlaneFacility as Dt, createParentUnownedCallHandler as E, createSocketPlaneMeter as En, hostNodeIdOf as Et, callWithServiceDiscovery as F, socketDirectionBytes as Fn, HUB_RSS_BUDGET_ENV as Ft, getCapUsageRegistry as G, createEventPlaneMeter as Gn, describeRss as Gt, CapUsageRegistry as H, createCapActionCensus as Hn, createDeferredHeapWatchSink as Ht, CapRouteError as I, socketDirectionMessages as In, RSS_BUDGET_REANNOUNCE_MIN_MS as It, UdsLocalTransportServer as J, formatEventPlane as Jn, parseRssBudgetMb as Jt, createLocalTransport as K, createEventPlaneReader as Kn, hubMainRssBudget as Kt, classifyCapRoute as L, CAP_ACTION_OVERFLOW_LABEL as Ln, RSS_BUDGET_RELEASE_RATIO as Lt, AGENT_CAP_FWD_ACTION as M, createSocketDirectionCounters as Mn, HEAP_WATCH_WARN_RATIO as Mt, AGENT_CAP_FWD_SERVICE as N, recordSocketFrame as Nn, HUB_MAIN_HEAP_WATCH_LABEL as Nt, createUdsEventBus as O, diffSocketPlane as On, HEAP_RECLAIM_MIN_INTERVAL_MS as Ot, CapRouteResolver as P, sampleSocketDirection as Pn, HUB_MAIN_RSS_BUDGET_MB as Pt, encodeFrame as Q, startRunnerHeapWatch as Qt, LocalChildClient as R, CAP_ACTION_UNLABELLED as Rn, RUNNER_HEAP_WATCH_INTERVAL_MS as Rt, buildLinkChain as S, formatMeshQueue as Sn, buildNpmChildEnv as St, localProviderLink as T, SOCKET_QUEUE_TOP_N as Tn, createAddonPeerBytesFacility as Tt, PARENT_ROUTED_PROVIDER_ADDON_ID as U, diffCapActionCensus as Un, createLoopDelayMeter as Ut, readMoleculerFanoutMode as V, capActionLabel as Vn, buildHeapSample as Vt, __resetCapUsageRegistryForTests as W, EVENT_PLANE_TOP_N as Wn, createV8Reclaimer as Wt, localEndpointPath as X, shouldReclaim as Xt, SocketChannel as Y, reclaimIntervalMs as Yt, FrameDecoder as Z, startHeapWatch as Zt, AddonDepsManager as _, OUTBOUND_QUEUE_THRESHOLD_BYTES as _n, CapabilityHandle as _t, createUdsAddonContext as a, createInspectorArrayBufferCensus as an, setWorkerNativeCapsChangeListener as at, brokerCallForCap as b, MESH_QUEUE_TOP_N as bn, installManifestNativeDeps as bt, getOrInitReadinessRegistryForClient as c, DECISIVE_HEAP_SPACES as cn, NATIVE_PROVIDER_SERVICE_INFIX as ct, clusterEventTopic as d, formatHeapSpaces as dn, capBareAction as dt, ARRAY_BUFFER_CENSUS_COOLDOWN_MS as en, buildUdsNativeCapProxy as et, getBrokerEventBus as f, heapSpaceField as fn, capServiceName as ft, subscribePassthrough as g, OUTBOUND_QUEUE_SUSTAIN_MS as gn, DeviceRegistry as gt, setNodeEventInterest as h, OUTBOUND_QUEUE_COOLDOWN_MS as hn, serializeTypedArrays as ht, createAddonContext as i, createArrayBufferCensusGate as in, mountNativeCapService as it, createUdsLoggerWithControl as j, EMPTY_SOCKET_DIRECTION as jn, HEAP_WATCH_INTERVAL_MS as jt, udsChildLogToWorkerEntry as k, formatSocketPlane as kn, HEAP_RECLAIM_STEADY_STATE_INTERVAL_MS as kt, setHubConnected as l, HEAP_SPACE_REPORT_MIN_MB as ln, capActionName as lt, registerEventBusService as m, selectReportedSpaces as mn, deserializeTypedArrays as mt, installManifestPythonDeps as n, ARRAY_BUFFER_CENSUS_THRESHOLD_MB as nn, getWorkerNativeCapProvider as nt, getWorkerDeviceRegistry as o, formatArrayBufferCensus as on, createAddonService as ot, getMoleculerEventStats as p, readHeapSpaces as pn, parseCapAction as pt, UdsLocalTransportClient as q, diffEventPlane as qn, nextRssBudgetState as qt, adaptBrokerToCluster as r, ARRAY_BUFFER_RELEASE_MIN_DROP_RATIO as rn, getWorkerNativeCapSnapshot as rt, getOrInitReadinessRegistry as s, isArrayBufferCensusReport as sn, validateProviderRegistrations as st, installManifestSystemDeps as t, ARRAY_BUFFER_CENSUS_SUSTAIN_MS as tn, createBrokerDeviceManagerApi as tt, EVENT_TOPIC_PREFIX as u, emitHeapDiagnosticReport as un, capActionSuffix as ut, createKernelHwAccel as v, createOutboundQueueGate as vn, CapabilityUnavailableError as vt, ipcParentLink as w, SOCKET_PLANE_TOP_N as wn, runNpm as wt, brokerTransportLink as x, createMeshQueueReader as xn, resolveAddonClass as xt, resolveHwAccel as y, formatOutboundQueueVerdict as yn, copyBundledNativeModules as yt, LocalChildRegistry as z, EMPTY_CAP_ACTION_READING as zn, RUNNER_RSS_BUDGET_ENV as zt };
+//#region src/kernel/moleculer/child-cap-dispatch.ts
+/** Type guard narrowing a dynamically-read provider member to a callable method. */
+function isCapMethod(value) {
+	return typeof value === "function";
+}
+/**
+* Prefix the hub matches to turn a child-side "declared optional, not served"
+* into a `NOT_IMPLEMENTED`. A prefix rather than an error subclass because the
+* error crosses a UDS boundary as a plain message.
+*/
+var CAP_METHOD_NOT_IMPLEMENTED = "CAP_METHOD_NOT_IMPLEMENTED";
+/**
+* Extract a string `addonId` out of arbitrary method args — the fallback
+* provider-selection hint for calls that arrive WITHOUT the out-of-band
+* `CapCallMessage.addonId` (e.g. a sibling child's unowned collection call
+* forwarded by the parent, where the raw input still carries `addonId`).
+*/
+function extractArgsAddonId(args) {
+	if (args === null || typeof args !== "object") return void 0;
+	const raw = Reflect.get(args, "addonId");
+	return typeof raw === "string" ? raw : void 0;
+}
+/**
+* Creates a unified dispatcher that routes a {@link CapCallInput} to either a
+* device-scoped or singleton provider, then invokes the requested method.
+*
+* Pure module — no Moleculer, no broker, no addon-runner dependency.
+*/
+function createChildCapDispatch(deps) {
+	return async (call) => {
+		const { capName, method, args, deviceId } = call;
+		const addonId = call.addonId ?? extractArgsAddonId(args);
+		let provider;
+		if (deviceId !== void 0) {
+			provider = deps.getDeviceProvider(capName, deviceId) ?? deps.getSingletonProvider(capName, addonId);
+			if (provider == null) throw new Error(`child-cap-dispatch: no provider for '${capName}' (device '${String(deviceId)}' or singleton)`);
+		} else {
+			provider = deps.getSingletonProvider(capName, addonId);
+			if (provider == null) throw new Error(`child-cap-dispatch: no singleton provider for '${capName}'`);
+		}
+		const fn = Reflect.get(provider, method);
+		if (!isCapMethod(fn)) {
+			if (deps.isCollectionListMethod(capName, method)) return [];
+			if (deps.isProviderOptionalMethod(capName, method)) throw new Error(`${CAP_METHOD_NOT_IMPLEMENTED}: '${capName}.${method}' is declared optional and this provider does not serve it`);
+			throw new Error(`child-cap-dispatch: method '${method}' not found on provider '${capName}'`);
+		}
+		return await fn.call(provider, args);
+	};
+}
+//#endregion
+export { FrameDecoder as $, startHeapWatch as $t, createUdsEventBus as A, diffSocketPlane as An, HEAP_RECLAIM_MIN_INTERVAL_MS as At, LocalChildClient as B, CAP_ACTION_UNLABELLED as Bn, RUNNER_HEAP_WATCH_INTERVAL_MS as Bt, brokerTransportLink as C, createMeshQueueReader as Cn, resolveAddonClass as Ct, localProviderLink as D, SOCKET_QUEUE_TOP_N as Dn, createAddonPeerBytesFacility as Dt, ipcParentLink as E, SOCKET_PLANE_TOP_N as En, runNpm as Et, AGENT_CAP_FWD_SERVICE as F, recordSocketFrame as Fn, HUB_MAIN_HEAP_WATCH_LABEL as Ft, PARENT_ROUTED_PROVIDER_ADDON_ID as G, diffCapActionCensus as Gn, createLoopDelayMeter as Gt, UDS_NO_ROUTE_PREFIX as H, MAX_CAP_ACTIONS_PER_PEER as Hn, ZERO_LOOP_DELAY as Ht, CapRouteResolver as I, sampleSocketDirection as In, HUB_MAIN_RSS_BUDGET_MB as It, createLocalTransport as J, createEventPlaneReader as Jn, hubMainRssBudget as Jt, __resetCapUsageRegistryForTests as K, EVENT_PLANE_TOP_N as Kn, createV8Reclaimer as Kt, callWithServiceDiscovery as L, socketDirectionBytes as Ln, HUB_RSS_BUDGET_ENV as Lt, createUdsLogger as M, readSocketQueues as Mn, HEAP_RECLAIM_TRIGGER_MB as Mt, createUdsLoggerWithControl as N, EMPTY_SOCKET_DIRECTION as Nn, HEAP_WATCH_INTERVAL_MS as Nt, createParentUnownedCallHandler as O, createSocketPlaneMeter as On, hostNodeIdOf as Ot, AGENT_CAP_FWD_ACTION as P, createSocketDirectionCounters as Pn, HEAP_WATCH_WARN_RATIO as Pt, localEndpointPath as Q, shouldReclaim as Qt, CapRouteError as R, socketDirectionMessages as Rn, RSS_BUDGET_REANNOUNCE_MIN_MS as Rt, brokerCallForCap as S, MESH_QUEUE_TOP_N as Sn, installManifestNativeDeps as St, deviceCapResolverLink as T, EMPTY_SOCKET_PLANE_BASELINE as Tn, resolveNpmInvocation as Tt, readMoleculerFanoutMode as U, capActionLabel as Un, buildHeapSample as Ut, LocalChildRegistry as V, EMPTY_CAP_ACTION_READING as Vn, RUNNER_RSS_BUDGET_ENV as Vt, CapUsageRegistry as W, createCapActionCensus as Wn, createDeferredHeapWatchSink as Wt, UdsLocalTransportServer as X, formatEventPlane as Xn, parseRssBudgetMb as Xt, UdsLocalTransportClient as Y, diffEventPlane as Yn, nextRssBudgetState as Yt, SocketChannel as Z, reclaimIntervalMs as Zt, setNodeEventInterest as _, OUTBOUND_QUEUE_COOLDOWN_MS as _n, serializeTypedArrays as _t, adaptBrokerToCluster as a, ARRAY_BUFFER_RELEASE_MIN_DROP_RATIO as an, getWorkerNativeCapSnapshot as at, createKernelHwAccel as b, createOutboundQueueGate as bn, CapabilityUnavailableError as bt, getWorkerDeviceRegistry as c, formatArrayBufferCensus as cn, createAddonService as ct, setHubConnected as d, HEAP_SPACE_REPORT_MIN_MB as dn, capActionName as dt, startRunnerHeapWatch as en, encodeFrame as et, EVENT_TOPIC_PREFIX as f, emitHeapDiagnosticReport as fn, capActionSuffix as ft, registerEventBusService as g, selectReportedSpaces as gn, deserializeTypedArrays as gt, getMoleculerEventStats as h, readHeapSpaces as hn, parseCapAction as ht, installManifestPythonDeps as i, ARRAY_BUFFER_CENSUS_THRESHOLD_MB as in, getWorkerNativeCapProvider as it, udsChildLogToWorkerEntry as j, formatSocketPlane as jn, HEAP_RECLAIM_STEADY_STATE_INTERVAL_MS as jt, createUdsEventBridge as k, createSocketPlaneReader as kn, createAddonDataPlaneFacility as kt, getOrInitReadinessRegistry as l, isArrayBufferCensusReport as ln, validateProviderRegistrations as lt, getBrokerEventBus as m, heapSpaceField as mn, capServiceName as mt, createChildCapDispatch as n, ARRAY_BUFFER_CENSUS_COOLDOWN_MS as nn, buildUdsNativeCapProxy as nt, createAddonContext as o, createArrayBufferCensusGate as on, mountNativeCapService as ot, clusterEventTopic as p, formatHeapSpaces as pn, capBareAction as pt, getCapUsageRegistry as q, createEventPlaneMeter as qn, describeRss as qt, installManifestSystemDeps as r, ARRAY_BUFFER_CENSUS_SUSTAIN_MS as rn, createBrokerDeviceManagerApi as rt, createUdsAddonContext as s, createInspectorArrayBufferCensus as sn, setWorkerNativeCapsChangeListener as st, CAP_METHOD_NOT_IMPLEMENTED as t, strandedMb as tn, buildNativeCapProxy as tt, getOrInitReadinessRegistryForClient as u, DECISIVE_HEAP_SPACES as un, NATIVE_PROVIDER_SERVICE_INFIX as ut, subscribePassthrough as v, OUTBOUND_QUEUE_SUSTAIN_MS as vn, DeviceRegistry as vt, buildLinkChain as w, formatMeshQueue as wn, buildNpmChildEnv as wt, resolveHwAccel as x, formatOutboundQueueVerdict as xn, copyBundledNativeModules as xt, AddonDepsManager as y, OUTBOUND_QUEUE_THRESHOLD_BYTES as yn, CapabilityHandle as yt, classifyCapRoute as z, CAP_ACTION_OVERFLOW_LABEL as zn, RSS_BUDGET_RELEASE_RATIO as zt };

package/dist/{manifest-system-deps-Dm7QhyvL.js → child-cap-dispatch-CzNzGnGm.js}

@@ -1,5 +1,4 @@
 const require_chunk = require("./chunk-Cek0wNdY.js");
-const require_dist = require("./dist-KRK9zLWt.js");
 require("./hub-cap-forward-DmHNjbB0.js");
 let node_crypto = require("node:crypto");
 node_crypto = require_chunk.__toESM(node_crypto);
@@ -2692,7 +2691,7 @@ async function writeBufferWithBackpressure(res, bytes, stallMs) {
 			sent,
 			outcome: "peer-gone"
 		};
-		const end = Math.min(sent + require_dist.PEER_BYTES_CHUNK_BYTES, bytes.byteLength);
+		const end = Math.min(sent + _camstack_types_addon.PEER_BYTES_CHUNK_BYTES, bytes.byteLength);
 		const took = res.write(bytes.subarray(sent, end));
 		sent = end;
 		if (took) continue;
@@ -2710,9 +2709,9 @@ async function writeBufferWithBackpressure(res, bytes, stallMs) {
 }
 function createAddonPeerBytesFacility(args) {
 	const now = args.now ?? (() => Date.now());
-	const ttlMs = args.ttlMs ?? 3e4;
-	const maxOutstanding = args.maxOutstanding ?? 64;
-	const stallMs = args.stallMs ?? 15e3;
+	const ttlMs = args.ttlMs ?? _camstack_types_addon.PEER_BYTES_TICKET_TTL_MS;
+	const maxOutstanding = args.maxOutstanding ?? _camstack_types_addon.PEER_BYTES_MAX_OUTSTANDING;
+	const stallMs = args.stallMs ?? _camstack_types_addon.PEER_BYTES_STALL_MS;
 	const host = args.host ?? "127.0.0.1";
 	const hostNodeId = hostNodeIdOf(args.nodeId);
 	const offers = /* @__PURE__ */ new Map();
@@ -12274,6 +12273,56 @@ async function defaultRun(command, args) {
 	await execFileAsync(command, [...args], { timeout: INSTALL_TIMEOUT_MS });
 }
 //#endregion
+//#region src/kernel/moleculer/child-cap-dispatch.ts
+/** Type guard narrowing a dynamically-read provider member to a callable method. */
+function isCapMethod(value) {
+	return typeof value === "function";
+}
+/**
+* Prefix the hub matches to turn a child-side "declared optional, not served"
+* into a `NOT_IMPLEMENTED`. A prefix rather than an error subclass because the
+* error crosses a UDS boundary as a plain message.
+*/
+var CAP_METHOD_NOT_IMPLEMENTED = "CAP_METHOD_NOT_IMPLEMENTED";
+/**
+* Extract a string `addonId` out of arbitrary method args — the fallback
+* provider-selection hint for calls that arrive WITHOUT the out-of-band
+* `CapCallMessage.addonId` (e.g. a sibling child's unowned collection call
+* forwarded by the parent, where the raw input still carries `addonId`).
+*/
+function extractArgsAddonId(args) {
+	if (args === null || typeof args !== "object") return void 0;
+	const raw = Reflect.get(args, "addonId");
+	return typeof raw === "string" ? raw : void 0;
+}
+/**
+* Creates a unified dispatcher that routes a {@link CapCallInput} to either a
+* device-scoped or singleton provider, then invokes the requested method.
+*
+* Pure module — no Moleculer, no broker, no addon-runner dependency.
+*/
+function createChildCapDispatch(deps) {
+	return async (call) => {
+		const { capName, method, args, deviceId } = call;
+		const addonId = call.addonId ?? extractArgsAddonId(args);
+		let provider;
+		if (deviceId !== void 0) {
+			provider = deps.getDeviceProvider(capName, deviceId) ?? deps.getSingletonProvider(capName, addonId);
+			if (provider == null) throw new Error(`child-cap-dispatch: no provider for '${capName}' (device '${String(deviceId)}' or singleton)`);
+		} else {
+			provider = deps.getSingletonProvider(capName, addonId);
+			if (provider == null) throw new Error(`child-cap-dispatch: no singleton provider for '${capName}'`);
+		}
+		const fn = Reflect.get(provider, method);
+		if (!isCapMethod(fn)) {
+			if (deps.isCollectionListMethod(capName, method)) return [];
+			if (deps.isProviderOptionalMethod(capName, method)) throw new Error(`${CAP_METHOD_NOT_IMPLEMENTED}: '${capName}.${method}' is declared optional and this provider does not serve it`);
+			throw new Error(`child-cap-dispatch: method '${method}' not found on provider '${capName}'`);
+		}
+		return await fn.call(provider, args);
+	};
+}
+//#endregion
 Object.defineProperty(exports, "AGENT_CAP_FWD_ACTION", {
 	enumerable: true,
 	get: function() {
@@ -12328,6 +12377,12 @@ Object.defineProperty(exports, "CAP_ACTION_UNLABELLED", {
 		return CAP_ACTION_UNLABELLED;
 	}
 });
+Object.defineProperty(exports, "CAP_METHOD_NOT_IMPLEMENTED", {
+	enumerable: true,
+	get: function() {
+		return CAP_METHOD_NOT_IMPLEMENTED;
+	}
+});
 Object.defineProperty(exports, "CapRouteError", {
 	enumerable: true,
 	get: function() {
@@ -12730,6 +12785,12 @@ Object.defineProperty(exports, "createCapActionCensus", {
 		return createCapActionCensus;
 	}
 });
+Object.defineProperty(exports, "createChildCapDispatch", {
+	enumerable: true,
+	get: function() {
+		return createChildCapDispatch;
+	}
+});
 Object.defineProperty(exports, "createDeferredHeapWatchSink", {
 	enumerable: true,
 	get: function() {