@camstack/system 1.2.1 → 1.2.3

package/dist/kernel/deps/manifest-native-deps.d.ts

@@ -23,3 +23,20 @@ import { IScopedLogger } from '@camstack/types';
  *     otherwise).
  */
 export declare function installManifestNativeDeps(addonDir: string, pkgRaw: Record<string, unknown>, logger: IScopedLogger, registry?: string, npmCacheDir?: string): Promise<void>;
+/**
+ * Propagate PREBUILT native modules from a bundled addon copy's own
+ * `node_modules` (the packaged-desktop 'local' source at
+ * `<resources>/addons/<addon>`) into the freshly-copied target
+ * (`<data>/addons/@camstack/<addon>`), BEFORE the target's `npm install` runs.
+ *
+ * Why (Mac desktop first-boot FATAL, 2026-07-21): `installCopy` copies only
+ * `dist/` then `npm install`s the addon's runtime deps. On a toolchain-less Mac
+ * that install leaves the traditional native `better-sqlite3` SOURCE-ONLY in
+ * `<addon>/node_modules` — a broken copy that then SHADOWS the good hoisted
+ * `.node` NODE_PATH would otherwise resolve, crashing the runner with "Could
+ * not locate the bindings file". Seeding the prebuilt copy here makes the npm
+ * install treat the native as satisfied (no re-run of `prebuild-install`), so
+ * the good `.node` stays in place. A no-op in dev / docker where the source
+ * carries no bundled natives.
+ */
+export declare function copyBundledNativeModules(sourceDir: string, targetDir: string, logger: IScopedLogger): void;

package/dist/{manifest-python-deps-Co8MTPdy.mjs → manifest-python-deps-6__QF75g.mjs}

@@ -1,4 +1,4 @@
-import { q as readNodePin } from "./dist-BLNvh8Qy.mjs";
+import { q as readNodePin } from "./dist-72yufD8v.mjs";
 import { ensureBinary, ensureFfmpeg, ensurePython, installPythonPackages, installPythonRequirements } from "@camstack/types/node";
 import { createServer } from "node:http";
 import * as fs from "node:fs";
@@ -437,6 +437,92 @@ function copyPrebuiltNativeDep(name, addonDir, logger) {
 	}
 	return false;
 }
+/**
+* Native packages the packaged desktop ships PREBUILT inside each bundled addon
+* copy (`scripts/stage-deps.mjs` plants them), keyed to the platform SIBLING
+* scopes that hold the N-API binary. The traditional `better-sqlite3` carries
+* its `.node` in its own dir; `sharp`/`node-av` carry it in a `@img`/`@seydx`
+* sibling.
+*/
+var BUNDLED_NATIVE_SIBLING_SCOPES = {
+	"better-sqlite3": [],
+	sharp: ["@img"],
+	"node-av": ["@seydx"]
+};
+/** Bounded recursive scan for ANY `*.node` under `dir`. */
+function hasAnyDotNode(dir, maxDepth) {
+	let entries;
+	try {
+		entries = fs.readdirSync(dir, { withFileTypes: true });
+	} catch {
+		return false;
+	}
+	for (const entry of entries) if (entry.isFile() && entry.name.endsWith(".node")) return true;
+	if (maxDepth <= 0) return false;
+	for (const entry of entries) if (entry.isDirectory() && hasAnyDotNode(path$1.join(dir, entry.name), maxDepth - 1)) return true;
+	return false;
+}
+/** Copy `<src>` → `<dst>` when `<src>` carries a `.node`. Best-effort. */
+function copyPrebuiltModuleDir(src, dst, label, logger) {
+	if (!hasAnyDotNode(src, 5)) return;
+	if (hasAnyDotNode(dst, 5)) return;
+	try {
+		fs.rmSync(dst, {
+			recursive: true,
+			force: true
+		});
+		fs.mkdirSync(path$1.dirname(dst), { recursive: true });
+		fs.cpSync(src, dst, {
+			recursive: true,
+			dereference: true
+		});
+		logger.info("Prebuilt native module propagated from bundled addon copy", { meta: {
+			module: label,
+			src,
+			dst
+		} });
+	} catch (err) {
+		logger.warn("Prebuilt native module propagation failed (npm install will retry)", { meta: {
+			module: label,
+			src,
+			error: errMsg(err)
+		} });
+	}
+}
+/**
+* Propagate PREBUILT native modules from a bundled addon copy's own
+* `node_modules` (the packaged-desktop 'local' source at
+* `<resources>/addons/<addon>`) into the freshly-copied target
+* (`<data>/addons/@camstack/<addon>`), BEFORE the target's `npm install` runs.
+*
+* Why (Mac desktop first-boot FATAL, 2026-07-21): `installCopy` copies only
+* `dist/` then `npm install`s the addon's runtime deps. On a toolchain-less Mac
+* that install leaves the traditional native `better-sqlite3` SOURCE-ONLY in
+* `<addon>/node_modules` — a broken copy that then SHADOWS the good hoisted
+* `.node` NODE_PATH would otherwise resolve, crashing the runner with "Could
+* not locate the bindings file". Seeding the prebuilt copy here makes the npm
+* install treat the native as satisfied (no re-run of `prebuild-install`), so
+* the good `.node` stays in place. A no-op in dev / docker where the source
+* carries no bundled natives.
+*/
+function copyBundledNativeModules(sourceDir, targetDir, logger) {
+	const srcNm = path$1.join(sourceDir, "node_modules");
+	if (!fs.existsSync(srcNm)) return;
+	const dstNm = path$1.join(targetDir, "node_modules");
+	for (const [name, scopes] of Object.entries(BUNDLED_NATIVE_SIBLING_SCOPES)) {
+		copyPrebuiltModuleDir(path$1.join(srcNm, name), path$1.join(dstNm, name), name, logger);
+		for (const scope of scopes) {
+			const scopeSrc = path$1.join(srcNm, scope);
+			let siblings;
+			try {
+				siblings = fs.readdirSync(scopeSrc);
+			} catch {
+				continue;
+			}
+			for (const sibling of siblings) copyPrebuiltModuleDir(path$1.join(scopeSrc, sibling), path$1.join(dstNm, scope, sibling), `${scope}/${sibling}`, logger);
+		}
+	}
+}
 /** A package dir is "built" when it carries a compiled `.node` or a prebuilds tree. */
 function hasBuiltBinary(pkgDir) {
 	if (!fs.existsSync(path$1.join(pkgDir, "package.json"))) return false;
@@ -7320,4 +7406,4 @@ async function installManifestPythonDeps(declaration, addonDir, deps, logger) {
 	await deps.installPythonRequirements(reqAbs);
 }
 //#endregion
-export { buildNativeCapProxy as $, createHubCapForwardService as A, AGENT_CAP_FWD_ACTION as B, brokerTransportLink as C, createAddonDataPlaneFacility as Ct, localProviderLink as D, ipcParentLink as E, createUdsLogger as F, callWithServiceDiscovery as G, CapRouteResolver as H, createUdsLoggerWithControl as I, UdsLocalTransportServer as J, createLocalTransport as K, LocalChildClient as L, createUdsEventBridge as M, createUdsEventBus as N, HUB_CAP_FWD_ACTION as O, udsChildLogToWorkerEntry as P, encodeFrame as Q, LocalChildRegistry as R, brokerCallForCap as S, resolveAddonClass as St, ipcChildLink as T, CapRouteError as U, AGENT_CAP_FWD_SERVICE as V, classifyCapRoute as W, localEndpointPath as X, SocketChannel as Y, FrameDecoder as Z, createKernelHwAccel as _, CapabilityHandle as _t, getWorkerDeviceRegistry as a, setWorkerNativeCapsChangeListener as at, __resetCapUsageRegistryForTests as b, resolveNpmInvocation as bt, setHubConnected as c, NATIVE_PROVIDER_SERVICE_INFIX as ct, getBrokerEventBus as d, capBareAction as dt, buildUdsNativeCapProxy as et, getMoleculerEventStats as f, capServiceName as ft, AddonDepsManager as g, DeviceRegistry as gt, subscribePassthrough as h, serializeTypedArrays as ht, createUdsAddonContext as i, mountNativeCapService as it, createParentUnownedCallHandler as j, HUB_CAP_FWD_SERVICE as k, EVENT_TOPIC_PREFIX as l, capActionName as lt, setNodeEventInterest as m, deserializeTypedArrays as mt, adaptBrokerToCluster as n, getWorkerNativeCapProvider as nt, getOrInitReadinessRegistry as o, createAddonService as ot, registerEventBusService as p, parseCapAction as pt, UdsLocalTransportClient as q, createAddonContext as r, getWorkerNativeCapSnapshot as rt, getOrInitReadinessRegistryForClient as s, validateProviderRegistrations as st, installManifestPythonDeps as t, createBrokerDeviceManagerApi as tt, clusterEventTopic as u, capActionSuffix as ut, resolveHwAccel as v, CapabilityUnavailableError as vt, buildLinkChain as w, getCapUsageRegistry as x, runNpm as xt, CapUsageRegistry as y, installManifestNativeDeps as yt, UDS_NO_ROUTE_PREFIX as z };
+export { buildNativeCapProxy as $, createHubCapForwardService as A, AGENT_CAP_FWD_ACTION as B, brokerTransportLink as C, resolveAddonClass as Ct, localProviderLink as D, ipcParentLink as E, createUdsLogger as F, callWithServiceDiscovery as G, CapRouteResolver as H, createUdsLoggerWithControl as I, UdsLocalTransportServer as J, createLocalTransport as K, LocalChildClient as L, createUdsEventBridge as M, createUdsEventBus as N, HUB_CAP_FWD_ACTION as O, udsChildLogToWorkerEntry as P, encodeFrame as Q, LocalChildRegistry as R, brokerCallForCap as S, runNpm as St, ipcChildLink as T, CapRouteError as U, AGENT_CAP_FWD_SERVICE as V, classifyCapRoute as W, localEndpointPath as X, SocketChannel as Y, FrameDecoder as Z, createKernelHwAccel as _, CapabilityHandle as _t, getWorkerDeviceRegistry as a, setWorkerNativeCapsChangeListener as at, __resetCapUsageRegistryForTests as b, installManifestNativeDeps as bt, setHubConnected as c, NATIVE_PROVIDER_SERVICE_INFIX as ct, getBrokerEventBus as d, capBareAction as dt, buildUdsNativeCapProxy as et, getMoleculerEventStats as f, capServiceName as ft, AddonDepsManager as g, DeviceRegistry as gt, subscribePassthrough as h, serializeTypedArrays as ht, createUdsAddonContext as i, mountNativeCapService as it, createParentUnownedCallHandler as j, HUB_CAP_FWD_SERVICE as k, EVENT_TOPIC_PREFIX as l, capActionName as lt, setNodeEventInterest as m, deserializeTypedArrays as mt, adaptBrokerToCluster as n, getWorkerNativeCapProvider as nt, getOrInitReadinessRegistry as o, createAddonService as ot, registerEventBusService as p, parseCapAction as pt, UdsLocalTransportClient as q, createAddonContext as r, getWorkerNativeCapSnapshot as rt, getOrInitReadinessRegistryForClient as s, validateProviderRegistrations as st, installManifestPythonDeps as t, createBrokerDeviceManagerApi as tt, clusterEventTopic as u, capActionSuffix as ut, resolveHwAccel as v, CapabilityUnavailableError as vt, buildLinkChain as w, createAddonDataPlaneFacility as wt, getCapUsageRegistry as x, resolveNpmInvocation as xt, CapUsageRegistry as y, copyBundledNativeModules as yt, UDS_NO_ROUTE_PREFIX as z };

package/dist/{manifest-python-deps-DE8HxnIx.js → manifest-python-deps-Cd7ocUBi.js}

@@ -1,5 +1,5 @@
 const require_chunk = require("./chunk-Cek0wNdY.js");
-const require_dist = require("./dist-DP2SKMvU.js");
+const require_dist = require("./dist-CQZxGJ8u.js");
 let _camstack_types_node = require("@camstack/types/node");
 let node_http = require("node:http");
 let node_fs = require("node:fs");
@@ -439,6 +439,92 @@ function copyPrebuiltNativeDep(name, addonDir, logger) {
 	}
 	return false;
 }
+/**
+* Native packages the packaged desktop ships PREBUILT inside each bundled addon
+* copy (`scripts/stage-deps.mjs` plants them), keyed to the platform SIBLING
+* scopes that hold the N-API binary. The traditional `better-sqlite3` carries
+* its `.node` in its own dir; `sharp`/`node-av` carry it in a `@img`/`@seydx`
+* sibling.
+*/
+var BUNDLED_NATIVE_SIBLING_SCOPES = {
+	"better-sqlite3": [],
+	sharp: ["@img"],
+	"node-av": ["@seydx"]
+};
+/** Bounded recursive scan for ANY `*.node` under `dir`. */
+function hasAnyDotNode(dir, maxDepth) {
+	let entries;
+	try {
+		entries = node_fs.readdirSync(dir, { withFileTypes: true });
+	} catch {
+		return false;
+	}
+	for (const entry of entries) if (entry.isFile() && entry.name.endsWith(".node")) return true;
+	if (maxDepth <= 0) return false;
+	for (const entry of entries) if (entry.isDirectory() && hasAnyDotNode(node_path.join(dir, entry.name), maxDepth - 1)) return true;
+	return false;
+}
+/** Copy `<src>` → `<dst>` when `<src>` carries a `.node`. Best-effort. */
+function copyPrebuiltModuleDir(src, dst, label, logger) {
+	if (!hasAnyDotNode(src, 5)) return;
+	if (hasAnyDotNode(dst, 5)) return;
+	try {
+		node_fs.rmSync(dst, {
+			recursive: true,
+			force: true
+		});
+		node_fs.mkdirSync(node_path.dirname(dst), { recursive: true });
+		node_fs.cpSync(src, dst, {
+			recursive: true,
+			dereference: true
+		});
+		logger.info("Prebuilt native module propagated from bundled addon copy", { meta: {
+			module: label,
+			src,
+			dst
+		} });
+	} catch (err) {
+		logger.warn("Prebuilt native module propagation failed (npm install will retry)", { meta: {
+			module: label,
+			src,
+			error: (0, _camstack_types_addon.errMsg)(err)
+		} });
+	}
+}
+/**
+* Propagate PREBUILT native modules from a bundled addon copy's own
+* `node_modules` (the packaged-desktop 'local' source at
+* `<resources>/addons/<addon>`) into the freshly-copied target
+* (`<data>/addons/@camstack/<addon>`), BEFORE the target's `npm install` runs.
+*
+* Why (Mac desktop first-boot FATAL, 2026-07-21): `installCopy` copies only
+* `dist/` then `npm install`s the addon's runtime deps. On a toolchain-less Mac
+* that install leaves the traditional native `better-sqlite3` SOURCE-ONLY in
+* `<addon>/node_modules` — a broken copy that then SHADOWS the good hoisted
+* `.node` NODE_PATH would otherwise resolve, crashing the runner with "Could
+* not locate the bindings file". Seeding the prebuilt copy here makes the npm
+* install treat the native as satisfied (no re-run of `prebuild-install`), so
+* the good `.node` stays in place. A no-op in dev / docker where the source
+* carries no bundled natives.
+*/
+function copyBundledNativeModules(sourceDir, targetDir, logger) {
+	const srcNm = node_path.join(sourceDir, "node_modules");
+	if (!node_fs.existsSync(srcNm)) return;
+	const dstNm = node_path.join(targetDir, "node_modules");
+	for (const [name, scopes] of Object.entries(BUNDLED_NATIVE_SIBLING_SCOPES)) {
+		copyPrebuiltModuleDir(node_path.join(srcNm, name), node_path.join(dstNm, name), name, logger);
+		for (const scope of scopes) {
+			const scopeSrc = node_path.join(srcNm, scope);
+			let siblings;
+			try {
+				siblings = node_fs.readdirSync(scopeSrc);
+			} catch {
+				continue;
+			}
+			for (const sibling of siblings) copyPrebuiltModuleDir(node_path.join(scopeSrc, sibling), node_path.join(dstNm, scope, sibling), `${scope}/${sibling}`, logger);
+		}
+	}
+}
 /** A package dir is "built" when it carries a compiled `.node` or a prebuilds tree. */
 function hasBuiltBinary(pkgDir) {
 	if (!node_fs.existsSync(node_path.join(pkgDir, "package.json"))) return false;
@@ -7526,6 +7612,12 @@ Object.defineProperty(exports, "clusterEventTopic", {
 		return clusterEventTopic;
 	}
 });
+Object.defineProperty(exports, "copyBundledNativeModules", {
+	enumerable: true,
+	get: function() {
+		return copyBundledNativeModules;
+	}
+});
 Object.defineProperty(exports, "createAddonContext", {
 	enumerable: true,
 	get: function() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/system",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "description": "Core addon for CamStack — builtins, pipeline, process management, auth, logging, events",
   "keywords": [
     "camstack",