@milaboratories/pl-model-common 1.29.0 → 1.31.0

package/dist/services/service_declarations.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"service_declarations.cjs","names":["service"],"sources":["../../src/services/service_declarations.ts"],"sourcesContent":["/**\n * Service declarations — add new services here.\n *\n * After adding a service, fix type errors in these files:\n *\n * Model side:\n * - lib/node/pl-middle-layer/src/js_render/service_injectors.ts — VM bridge for workflow scripts\n * - lib/node/pl-middle-layer/src/middle_layer/middle_layer.ts — ModelServiceRegistry factory\n *\n * UI side:\n * - lib/model/common/src/services/service_injector_factory.ts — driver method wrappers (node services only)\n * - sdk/ui-vue/src/internal/createAppV3.ts — UiServiceRegistry factory\n *\n * Optional:\n * - sdk/model/src/services/block_service_flags.ts — only if default-required by all blocks\n */\n\nimport type { PFrameDriver, PFrameModelDriver } from \"../drivers/pframe/driver\";\nimport type { PFrameSpecDriver } from \"../drivers/pframe/spec_driver\";\nimport { service } from \"./service_types\";\n\nexport const Services = {\n  PFrameSpec: service<PFrameSpecDriver, PFrameSpecDriver>()({ type: \"wasm\", name: \"pframeSpec\" }),\n  PFrame: service<PFrameModelDriver, PFrameDriver>()({ type: \"node\", name: \"pframe\" }),\n};\n"],"mappings":";;;AAqBA,MAAa,WAAW;CACtB,YAAYA,+BAA6C,CAAC;EAAE,MAAM;EAAQ,MAAM;EAAc,CAAC;CAC/F,QAAQA,+BAA0C,CAAC;EAAE,MAAM;EAAQ,MAAM;EAAU,CAAC;CACrF"}

package/dist/services/service_declarations.d.ts

@@ -0,0 +1,16 @@
+import { Branded } from "../branding.js";
+import { PColumn } from "../drivers/pframe/spec/spec.js";
+import { DataInfo, PColumnValues } from "../drivers/pframe/data_info.js";
+import { PFrameSpecDriver } from "../drivers/pframe/spec_driver.js";
+import { PFrameDriver, PFrameModelDriver } from "../drivers/pframe/driver.js";
+import { ServiceTypesLike } from "./service_types.js";
+import "../index.js";
+
+//#region src/services/service_declarations.d.ts
+declare const Services: {
+  PFrameSpec: Branded<"pframeSpec", ServiceTypesLike<PFrameSpecDriver, PFrameSpecDriver, "wasm">>;
+  PFrame: Branded<"pframe", ServiceTypesLike<PFrameModelDriver<PColumn<string | PColumnValues | DataInfo<string>>>, PFrameDriver, "node">>;
+};
+//#endregion
+export { Services };
+//# sourceMappingURL=service_declarations.d.ts.map

package/dist/services/service_declarations.js

@@ -0,0 +1,17 @@
+import { service } from "./service_types.js";
+
+//#region src/services/service_declarations.ts
+const Services = {
+	PFrameSpec: service()({
+		type: "wasm",
+		name: "pframeSpec"
+	}),
+	PFrame: service()({
+		type: "node",
+		name: "pframe"
+	})
+};
+
+//#endregion
+export { Services };
+//# sourceMappingURL=service_declarations.js.map

package/dist/services/service_declarations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service_declarations.js","names":[],"sources":["../../src/services/service_declarations.ts"],"sourcesContent":["/**\n * Service declarations — add new services here.\n *\n * After adding a service, fix type errors in these files:\n *\n * Model side:\n * - lib/node/pl-middle-layer/src/js_render/service_injectors.ts — VM bridge for workflow scripts\n * - lib/node/pl-middle-layer/src/middle_layer/middle_layer.ts — ModelServiceRegistry factory\n *\n * UI side:\n * - lib/model/common/src/services/service_injector_factory.ts — driver method wrappers (node services only)\n * - sdk/ui-vue/src/internal/createAppV3.ts — UiServiceRegistry factory\n *\n * Optional:\n * - sdk/model/src/services/block_service_flags.ts — only if default-required by all blocks\n */\n\nimport type { PFrameDriver, PFrameModelDriver } from \"../drivers/pframe/driver\";\nimport type { PFrameSpecDriver } from \"../drivers/pframe/spec_driver\";\nimport { service } from \"./service_types\";\n\nexport const Services = {\n  PFrameSpec: service<PFrameSpecDriver, PFrameSpecDriver>()({ type: \"wasm\", name: \"pframeSpec\" }),\n  PFrame: service<PFrameModelDriver, PFrameDriver>()({ type: \"node\", name: \"pframe\" }),\n};\n"],"mappings":";;;AAqBA,MAAa,WAAW;CACtB,YAAY,SAA6C,CAAC;EAAE,MAAM;EAAQ,MAAM;EAAc,CAAC;CAC/F,QAAQ,SAA0C,CAAC;EAAE,MAAM;EAAQ,MAAM;EAAU,CAAC;CACrF"}

package/dist/services/service_injector_factory.cjs

@@ -0,0 +1,19 @@
+
+//#region src/services/service_injector_factory.ts
+function createUiServiceInjectors(driverKit) {
+	const { pFrameDriver } = driverKit;
+	return { PFrame: {
+		findColumns: (handle, request) => pFrameDriver.findColumns(handle, request),
+		getColumnSpec: (handle, columnId) => pFrameDriver.getColumnSpec(handle, columnId),
+		listColumns: (handle) => pFrameDriver.listColumns(handle),
+		calculateTableData: (handle, request, range) => pFrameDriver.calculateTableData(handle, request, range),
+		getUniqueValues: (handle, request) => pFrameDriver.getUniqueValues(handle, request),
+		getShape: (handle) => pFrameDriver.getShape(handle),
+		getSpec: (handle) => pFrameDriver.getSpec(handle),
+		getData: (handle, columnIndices, range) => pFrameDriver.getData(handle, columnIndices, range)
+	} };
+}
+
+//#endregion
+exports.createUiServiceInjectors = createUiServiceInjectors;
+//# sourceMappingURL=service_injector_factory.cjs.map

package/dist/services/service_injector_factory.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"service_injector_factory.cjs","names":[],"sources":["../../src/services/service_injector_factory.ts"],"sourcesContent":["/**\n * UI service injector factory.\n *\n * When adding a new node service, add its method wrappers here.\n * Everything else (SERVICE_METHOD_MAP, buildServiceInfo, UiServiceInjectorMap)\n * auto-derives from this factory + Services in service_declarations.ts.\n */\n\nimport type { DriverKit } from \"../driver_kit\";\nimport type { UiServiceInjectorMap } from \"./service_injectors\";\n\nexport function createUiServiceInjectors(driverKit: DriverKit): UiServiceInjectorMap {\n  const { pFrameDriver } = driverKit;\n  return {\n    PFrame: {\n      findColumns: (handle, request) => pFrameDriver.findColumns(handle, request),\n      getColumnSpec: (handle, columnId) => pFrameDriver.getColumnSpec(handle, columnId),\n      listColumns: (handle) => pFrameDriver.listColumns(handle),\n      calculateTableData: (handle, request, range) =>\n        pFrameDriver.calculateTableData(handle, request, range),\n      getUniqueValues: (handle, request) => pFrameDriver.getUniqueValues(handle, request),\n      getShape: (handle) => pFrameDriver.getShape(handle),\n      getSpec: (handle) => pFrameDriver.getSpec(handle),\n      getData: (handle, columnIndices, range) => pFrameDriver.getData(handle, columnIndices, range),\n    },\n  };\n}\n"],"mappings":";;AAWA,SAAgB,yBAAyB,WAA4C;CACnF,MAAM,EAAE,iBAAiB;AACzB,QAAO,EACL,QAAQ;EACN,cAAc,QAAQ,YAAY,aAAa,YAAY,QAAQ,QAAQ;EAC3E,gBAAgB,QAAQ,aAAa,aAAa,cAAc,QAAQ,SAAS;EACjF,cAAc,WAAW,aAAa,YAAY,OAAO;EACzD,qBAAqB,QAAQ,SAAS,UACpC,aAAa,mBAAmB,QAAQ,SAAS,MAAM;EACzD,kBAAkB,QAAQ,YAAY,aAAa,gBAAgB,QAAQ,QAAQ;EACnF,WAAW,WAAW,aAAa,SAAS,OAAO;EACnD,UAAU,WAAW,aAAa,QAAQ,OAAO;EACjD,UAAU,QAAQ,eAAe,UAAU,aAAa,QAAQ,QAAQ,eAAe,MAAM;EAC9F,EACF"}

package/dist/services/service_injector_factory.d.ts

@@ -0,0 +1,8 @@
+import { DriverKit } from "../driver_kit.js";
+import { UiServiceInjectorMap } from "./service_injectors.js";
+
+//#region src/services/service_injector_factory.d.ts
+declare function createUiServiceInjectors(driverKit: DriverKit): UiServiceInjectorMap;
+//#endregion
+export { createUiServiceInjectors };
+//# sourceMappingURL=service_injector_factory.d.ts.map

package/dist/services/service_injector_factory.js

@@ -0,0 +1,18 @@
+//#region src/services/service_injector_factory.ts
+function createUiServiceInjectors(driverKit) {
+	const { pFrameDriver } = driverKit;
+	return { PFrame: {
+		findColumns: (handle, request) => pFrameDriver.findColumns(handle, request),
+		getColumnSpec: (handle, columnId) => pFrameDriver.getColumnSpec(handle, columnId),
+		listColumns: (handle) => pFrameDriver.listColumns(handle),
+		calculateTableData: (handle, request, range) => pFrameDriver.calculateTableData(handle, request, range),
+		getUniqueValues: (handle, request) => pFrameDriver.getUniqueValues(handle, request),
+		getShape: (handle) => pFrameDriver.getShape(handle),
+		getSpec: (handle) => pFrameDriver.getSpec(handle),
+		getData: (handle, columnIndices, range) => pFrameDriver.getData(handle, columnIndices, range)
+	} };
+}
+
+//#endregion
+export { createUiServiceInjectors };
+//# sourceMappingURL=service_injector_factory.js.map

package/dist/services/service_injector_factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service_injector_factory.js","names":[],"sources":["../../src/services/service_injector_factory.ts"],"sourcesContent":["/**\n * UI service injector factory.\n *\n * When adding a new node service, add its method wrappers here.\n * Everything else (SERVICE_METHOD_MAP, buildServiceInfo, UiServiceInjectorMap)\n * auto-derives from this factory + Services in service_declarations.ts.\n */\n\nimport type { DriverKit } from \"../driver_kit\";\nimport type { UiServiceInjectorMap } from \"./service_injectors\";\n\nexport function createUiServiceInjectors(driverKit: DriverKit): UiServiceInjectorMap {\n  const { pFrameDriver } = driverKit;\n  return {\n    PFrame: {\n      findColumns: (handle, request) => pFrameDriver.findColumns(handle, request),\n      getColumnSpec: (handle, columnId) => pFrameDriver.getColumnSpec(handle, columnId),\n      listColumns: (handle) => pFrameDriver.listColumns(handle),\n      calculateTableData: (handle, request, range) =>\n        pFrameDriver.calculateTableData(handle, request, range),\n      getUniqueValues: (handle, request) => pFrameDriver.getUniqueValues(handle, request),\n      getShape: (handle) => pFrameDriver.getShape(handle),\n      getSpec: (handle) => pFrameDriver.getSpec(handle),\n      getData: (handle, columnIndices, range) => pFrameDriver.getData(handle, columnIndices, range),\n    },\n  };\n}\n"],"mappings":";AAWA,SAAgB,yBAAyB,WAA4C;CACnF,MAAM,EAAE,iBAAiB;AACzB,QAAO,EACL,QAAQ;EACN,cAAc,QAAQ,YAAY,aAAa,YAAY,QAAQ,QAAQ;EAC3E,gBAAgB,QAAQ,aAAa,aAAa,cAAc,QAAQ,SAAS;EACjF,cAAc,WAAW,aAAa,YAAY,OAAO;EACzD,qBAAqB,QAAQ,SAAS,UACpC,aAAa,mBAAmB,QAAQ,SAAS,MAAM;EACzD,kBAAkB,QAAQ,YAAY,aAAa,gBAAgB,QAAQ,QAAQ;EACnF,WAAW,WAAW,aAAa,SAAS,OAAO;EACnD,UAAU,WAAW,aAAa,QAAQ,OAAO;EACjD,UAAU,QAAQ,eAAe,UAAU,aAAa,QAAQ,QAAQ,eAAe,MAAM;EAC9F,EACF"}

package/dist/services/service_injectors.cjs

@@ -0,0 +1,48 @@
+const require_service_declarations = require('./service_declarations.cjs');
+const require_service_capabilities = require('./service_capabilities.cjs');
+const require_service_injector_factory = require('./service_injector_factory.cjs');
+
+//#region src/services/service_injectors.ts
+let cachedKit;
+let cachedInjectors;
+function getOrCreateInjectors(driverKit) {
+	if (!cachedInjectors || cachedKit !== driverKit) {
+		cachedKit = driverKit;
+		cachedInjectors = require_service_injector_factory.createUiServiceInjectors(driverKit);
+	}
+	return cachedInjectors;
+}
+/** Resolve the injector for a given service ID. Caches injectors per DriverKit reference. */
+function resolveUiInjector(driverKit, serviceId) {
+	const injectors = getOrCreateInjectors(driverKit);
+	const key = Object.keys(require_service_declarations.Services).find((k) => require_service_declarations.Services[k] === serviceId);
+	if (!key) return null;
+	return injectors[key];
+}
+/**
+* Static map of ServiceName → method names, auto-derived from the injector shape.
+* Computed once at module load. The stub DriverKit is never called — it only
+* provides a target so the closures in createUiServiceInjectors have own-property
+* keys that getMethodNames can introspect.
+*/
+const SERVICE_METHOD_MAP = (() => {
+	const injectors = require_service_injector_factory.createUiServiceInjectors(new Proxy({}, { get: () => new Proxy({}, { get: () => () => {} }) }));
+	const result = {};
+	for (const key of Object.keys(require_service_declarations.Services)) {
+		const serviceId = require_service_declarations.Services[key];
+		const injector = injectors[key];
+		result[serviceId] = injector ? require_service_capabilities.getMethodNames(injector) : [];
+	}
+	return result;
+})();
+/** Build service info for a block from its feature flags. */
+function buildServiceInfo(featureFlags) {
+	const serviceIds = require_service_capabilities.resolveRequiredServices(featureFlags);
+	return Object.fromEntries(serviceIds.map((id) => [id, SERVICE_METHOD_MAP[id] ?? []]));
+}
+
+//#endregion
+exports.SERVICE_METHOD_MAP = SERVICE_METHOD_MAP;
+exports.buildServiceInfo = buildServiceInfo;
+exports.resolveUiInjector = resolveUiInjector;
+//# sourceMappingURL=service_injectors.cjs.map

package/dist/services/service_injectors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"service_injectors.cjs","names":["createUiServiceInjectors","Services","getMethodNames","resolveRequiredServices"],"sources":["../../src/services/service_injectors.ts"],"sourcesContent":["/**\n * UI service injectors — auto-derived types, method map, and service info builder.\n *\n * The factory (createUiServiceInjectors) lives in service_injector_factory.ts —\n * that's the only file to edit when adding a new node service.\n */\n\nimport type { InferServiceKind, InferServiceUi, ServiceBrand, ServiceName } from \"./service_types\";\nimport type { DriverKit } from \"../driver_kit\";\nimport { Services } from \"./service_declarations\";\nimport { getMethodNames, resolveRequiredServices } from \"./service_capabilities\";\nimport { createUiServiceInjectors } from \"./service_injector_factory\";\n\nexport { createUiServiceInjectors } from \"./service_injector_factory\";\n\ntype NodeServiceKeys = {\n  [K in keyof typeof Services]: InferServiceKind<ServiceBrand<(typeof Services)[K]>> extends \"node\"\n    ? K\n    : never;\n}[keyof typeof Services];\n\n/** Auto-derived map of node service keys to their UI-side driver interfaces. */\nexport type UiServiceInjectorMap = {\n  [K in NodeServiceKeys]: InferServiceUi<ServiceBrand<(typeof Services)[K]>>;\n};\n\nlet cachedKit: DriverKit | undefined;\nlet cachedInjectors: UiServiceInjectorMap | undefined;\n\nfunction getOrCreateInjectors(driverKit: DriverKit): UiServiceInjectorMap {\n  if (!cachedInjectors || cachedKit !== driverKit) {\n    cachedKit = driverKit;\n    cachedInjectors = createUiServiceInjectors(driverKit);\n  }\n  return cachedInjectors;\n}\n\n/** Resolve the injector for a given service ID. Caches injectors per DriverKit reference. */\nexport function resolveUiInjector(\n  driverKit: DriverKit,\n  serviceId: ServiceName,\n): UiServiceInjectorMap[keyof UiServiceInjectorMap] | null {\n  const injectors = getOrCreateInjectors(driverKit);\n  const key = Object.keys(Services).find(\n    (k) => Services[k as keyof typeof Services] === serviceId,\n  ) as NodeServiceKeys | undefined;\n  if (!key) return null;\n  return injectors[key];\n}\n\n/**\n * Static map of ServiceName → method names, auto-derived from the injector shape.\n * Computed once at module load. The stub DriverKit is never called — it only\n * provides a target so the closures in createUiServiceInjectors have own-property\n * keys that getMethodNames can introspect.\n */\nexport const SERVICE_METHOD_MAP: Readonly<Record<string, string[]>> = (() => {\n  const stubKit = new Proxy({} as DriverKit, {\n    get: () => new Proxy({}, { get: () => () => {} }),\n  });\n  const injectors = createUiServiceInjectors(stubKit);\n  const result: Record<string, string[]> = {};\n  for (const key of Object.keys(Services) as (keyof typeof Services)[]) {\n    const serviceId = Services[key];\n    const injector = injectors[key as NodeServiceKeys];\n    result[serviceId] = injector ? getMethodNames(injector) : [];\n  }\n  return result;\n})();\n\n/** Build service info for a block from its feature flags. */\nexport function buildServiceInfo(\n  featureFlags: Record<string, unknown>,\n): Record<ServiceName, string[]> {\n  const serviceIds = resolveRequiredServices(featureFlags);\n  return Object.fromEntries(\n    serviceIds.map((id) => [id, SERVICE_METHOD_MAP[id as string] ?? []]),\n  ) as Record<ServiceName, string[]>;\n}\n"],"mappings":";;;;;AA0BA,IAAI;AACJ,IAAI;AAEJ,SAAS,qBAAqB,WAA4C;AACxE,KAAI,CAAC,mBAAmB,cAAc,WAAW;AAC/C,cAAY;AACZ,oBAAkBA,0DAAyB,UAAU;;AAEvD,QAAO;;;AAIT,SAAgB,kBACd,WACA,WACyD;CACzD,MAAM,YAAY,qBAAqB,UAAU;CACjD,MAAM,MAAM,OAAO,KAAKC,sCAAS,CAAC,MAC/B,MAAMA,sCAAS,OAAgC,UACjD;AACD,KAAI,CAAC,IAAK,QAAO;AACjB,QAAO,UAAU;;;;;;;;AASnB,MAAa,4BAAgE;CAI3E,MAAM,YAAYD,0DAHF,IAAI,MAAM,EAAE,EAAe,EACzC,WAAW,IAAI,MAAM,EAAE,EAAE,EAAE,iBAAiB,IAAI,CAAC,EAClD,CAAC,CACiD;CACnD,MAAM,SAAmC,EAAE;AAC3C,MAAK,MAAM,OAAO,OAAO,KAAKC,sCAAS,EAA+B;EACpE,MAAM,YAAYA,sCAAS;EAC3B,MAAM,WAAW,UAAU;AAC3B,SAAO,aAAa,WAAWC,4CAAe,SAAS,GAAG,EAAE;;AAE9D,QAAO;IACL;;AAGJ,SAAgB,iBACd,cAC+B;CAC/B,MAAM,aAAaC,qDAAwB,aAAa;AACxD,QAAO,OAAO,YACZ,WAAW,KAAK,OAAO,CAAC,IAAI,mBAAmB,OAAiB,EAAE,CAAC,CAAC,CACrE"}

package/dist/services/service_injectors.d.ts

@@ -0,0 +1,23 @@
+import { Services } from "./service_declarations.js";
+import { InferServiceKind, InferServiceUi, ServiceBrand, ServiceName } from "./service_types.js";
+import { DriverKit } from "../driver_kit.js";
+import { createUiServiceInjectors } from "./service_injector_factory.js";
+
+//#region src/services/service_injectors.d.ts
+type NodeServiceKeys = { [K in keyof typeof Services]: InferServiceKind<ServiceBrand<(typeof Services)[K]>> extends "node" ? K : never }[keyof typeof Services];
+/** Auto-derived map of node service keys to their UI-side driver interfaces. */
+type UiServiceInjectorMap = { [K in NodeServiceKeys]: InferServiceUi<ServiceBrand<(typeof Services)[K]>> };
+/** Resolve the injector for a given service ID. Caches injectors per DriverKit reference. */
+declare function resolveUiInjector(driverKit: DriverKit, serviceId: ServiceName): UiServiceInjectorMap[keyof UiServiceInjectorMap] | null;
+/**
+ * Static map of ServiceName → method names, auto-derived from the injector shape.
+ * Computed once at module load. The stub DriverKit is never called — it only
+ * provides a target so the closures in createUiServiceInjectors have own-property
+ * keys that getMethodNames can introspect.
+ */
+declare const SERVICE_METHOD_MAP: Readonly<Record<string, string[]>>;
+/** Build service info for a block from its feature flags. */
+declare function buildServiceInfo(featureFlags: Record<string, unknown>): Record<ServiceName, string[]>;
+//#endregion
+export { SERVICE_METHOD_MAP, UiServiceInjectorMap, buildServiceInfo, resolveUiInjector };
+//# sourceMappingURL=service_injectors.d.ts.map

package/dist/services/service_injectors.js

@@ -0,0 +1,46 @@
+import { Services } from "./service_declarations.js";
+import { getMethodNames, resolveRequiredServices } from "./service_capabilities.js";
+import { createUiServiceInjectors } from "./service_injector_factory.js";
+
+//#region src/services/service_injectors.ts
+let cachedKit;
+let cachedInjectors;
+function getOrCreateInjectors(driverKit) {
+	if (!cachedInjectors || cachedKit !== driverKit) {
+		cachedKit = driverKit;
+		cachedInjectors = createUiServiceInjectors(driverKit);
+	}
+	return cachedInjectors;
+}
+/** Resolve the injector for a given service ID. Caches injectors per DriverKit reference. */
+function resolveUiInjector(driverKit, serviceId) {
+	const injectors = getOrCreateInjectors(driverKit);
+	const key = Object.keys(Services).find((k) => Services[k] === serviceId);
+	if (!key) return null;
+	return injectors[key];
+}
+/**
+* Static map of ServiceName → method names, auto-derived from the injector shape.
+* Computed once at module load. The stub DriverKit is never called — it only
+* provides a target so the closures in createUiServiceInjectors have own-property
+* keys that getMethodNames can introspect.
+*/
+const SERVICE_METHOD_MAP = (() => {
+	const injectors = createUiServiceInjectors(new Proxy({}, { get: () => new Proxy({}, { get: () => () => {} }) }));
+	const result = {};
+	for (const key of Object.keys(Services)) {
+		const serviceId = Services[key];
+		const injector = injectors[key];
+		result[serviceId] = injector ? getMethodNames(injector) : [];
+	}
+	return result;
+})();
+/** Build service info for a block from its feature flags. */
+function buildServiceInfo(featureFlags) {
+	const serviceIds = resolveRequiredServices(featureFlags);
+	return Object.fromEntries(serviceIds.map((id) => [id, SERVICE_METHOD_MAP[id] ?? []]));
+}
+
+//#endregion
+export { SERVICE_METHOD_MAP, buildServiceInfo, resolveUiInjector };
+//# sourceMappingURL=service_injectors.js.map

package/dist/services/service_injectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service_injectors.js","names":[],"sources":["../../src/services/service_injectors.ts"],"sourcesContent":["/**\n * UI service injectors — auto-derived types, method map, and service info builder.\n *\n * The factory (createUiServiceInjectors) lives in service_injector_factory.ts —\n * that's the only file to edit when adding a new node service.\n */\n\nimport type { InferServiceKind, InferServiceUi, ServiceBrand, ServiceName } from \"./service_types\";\nimport type { DriverKit } from \"../driver_kit\";\nimport { Services } from \"./service_declarations\";\nimport { getMethodNames, resolveRequiredServices } from \"./service_capabilities\";\nimport { createUiServiceInjectors } from \"./service_injector_factory\";\n\nexport { createUiServiceInjectors } from \"./service_injector_factory\";\n\ntype NodeServiceKeys = {\n  [K in keyof typeof Services]: InferServiceKind<ServiceBrand<(typeof Services)[K]>> extends \"node\"\n    ? K\n    : never;\n}[keyof typeof Services];\n\n/** Auto-derived map of node service keys to their UI-side driver interfaces. */\nexport type UiServiceInjectorMap = {\n  [K in NodeServiceKeys]: InferServiceUi<ServiceBrand<(typeof Services)[K]>>;\n};\n\nlet cachedKit: DriverKit | undefined;\nlet cachedInjectors: UiServiceInjectorMap | undefined;\n\nfunction getOrCreateInjectors(driverKit: DriverKit): UiServiceInjectorMap {\n  if (!cachedInjectors || cachedKit !== driverKit) {\n    cachedKit = driverKit;\n    cachedInjectors = createUiServiceInjectors(driverKit);\n  }\n  return cachedInjectors;\n}\n\n/** Resolve the injector for a given service ID. Caches injectors per DriverKit reference. */\nexport function resolveUiInjector(\n  driverKit: DriverKit,\n  serviceId: ServiceName,\n): UiServiceInjectorMap[keyof UiServiceInjectorMap] | null {\n  const injectors = getOrCreateInjectors(driverKit);\n  const key = Object.keys(Services).find(\n    (k) => Services[k as keyof typeof Services] === serviceId,\n  ) as NodeServiceKeys | undefined;\n  if (!key) return null;\n  return injectors[key];\n}\n\n/**\n * Static map of ServiceName → method names, auto-derived from the injector shape.\n * Computed once at module load. The stub DriverKit is never called — it only\n * provides a target so the closures in createUiServiceInjectors have own-property\n * keys that getMethodNames can introspect.\n */\nexport const SERVICE_METHOD_MAP: Readonly<Record<string, string[]>> = (() => {\n  const stubKit = new Proxy({} as DriverKit, {\n    get: () => new Proxy({}, { get: () => () => {} }),\n  });\n  const injectors = createUiServiceInjectors(stubKit);\n  const result: Record<string, string[]> = {};\n  for (const key of Object.keys(Services) as (keyof typeof Services)[]) {\n    const serviceId = Services[key];\n    const injector = injectors[key as NodeServiceKeys];\n    result[serviceId] = injector ? getMethodNames(injector) : [];\n  }\n  return result;\n})();\n\n/** Build service info for a block from its feature flags. */\nexport function buildServiceInfo(\n  featureFlags: Record<string, unknown>,\n): Record<ServiceName, string[]> {\n  const serviceIds = resolveRequiredServices(featureFlags);\n  return Object.fromEntries(\n    serviceIds.map((id) => [id, SERVICE_METHOD_MAP[id as string] ?? []]),\n  ) as Record<ServiceName, string[]>;\n}\n"],"mappings":";;;;;AA0BA,IAAI;AACJ,IAAI;AAEJ,SAAS,qBAAqB,WAA4C;AACxE,KAAI,CAAC,mBAAmB,cAAc,WAAW;AAC/C,cAAY;AACZ,oBAAkB,yBAAyB,UAAU;;AAEvD,QAAO;;;AAIT,SAAgB,kBACd,WACA,WACyD;CACzD,MAAM,YAAY,qBAAqB,UAAU;CACjD,MAAM,MAAM,OAAO,KAAK,SAAS,CAAC,MAC/B,MAAM,SAAS,OAAgC,UACjD;AACD,KAAI,CAAC,IAAK,QAAO;AACjB,QAAO,UAAU;;;;;;;;AASnB,MAAa,4BAAgE;CAI3E,MAAM,YAAY,yBAHF,IAAI,MAAM,EAAE,EAAe,EACzC,WAAW,IAAI,MAAM,EAAE,EAAE,EAAE,iBAAiB,IAAI,CAAC,EAClD,CAAC,CACiD;CACnD,MAAM,SAAmC,EAAE;AAC3C,MAAK,MAAM,OAAO,OAAO,KAAK,SAAS,EAA+B;EACpE,MAAM,YAAY,SAAS;EAC3B,MAAM,WAAW,UAAU;AAC3B,SAAO,aAAa,WAAW,eAAe,SAAS,GAAG,EAAE;;AAE9D,QAAO;IACL;;AAGJ,SAAgB,iBACd,cAC+B;CAC/B,MAAM,aAAa,wBAAwB,aAAa;AACxD,QAAO,OAAO,YACZ,WAAW,KAAK,OAAO,CAAC,IAAI,mBAAmB,OAAiB,EAAE,CAAC,CAAC,CACrE"}

package/dist/services/service_registry.cjs

@@ -0,0 +1,52 @@
+const require_errors = require('../errors.cjs');
+
+//#region src/services/service_registry.ts
+var ServiceRegistryBase = class {
+	registryName;
+	knownServices = /* @__PURE__ */ new Set();
+	factories = /* @__PURE__ */ new Map();
+	instances = /* @__PURE__ */ new Map();
+	constructor(registryName, serviceMap, factories) {
+		this.registryName = registryName;
+		for (const [key, factory] of Object.entries(factories)) {
+			const serviceId = serviceMap[key];
+			this.knownServices.add(serviceId);
+			if (factory !== null) this.factories.set(serviceId, factory);
+		}
+	}
+	async dispose() {
+		for (const instance of this.instances.values()) if (Symbol.asyncDispose in instance) await instance[Symbol.asyncDispose]();
+		else if (Symbol.dispose in instance) instance[Symbol.dispose]();
+		this.instances.clear();
+	}
+	getById(serviceId) {
+		if (!this.knownServices.has(serviceId)) throw new require_errors.ServiceNotRegisteredError(`Service "${serviceId}" is not registered in ${this.registryName}. Add it to the factory map.`);
+		if (this.instances.has(serviceId)) return this.instances.get(serviceId);
+		const factory = this.factories.get(serviceId);
+		if (!factory) return null;
+		const instance = factory();
+		this.instances.set(serviceId, instance);
+		return instance;
+	}
+};
+var ModelServiceRegistry = class extends ServiceRegistryBase {
+	constructor(serviceMap, factories) {
+		super("ModelServiceRegistry", serviceMap, factories);
+	}
+	get(id) {
+		return this.getById(id);
+	}
+};
+var UiServiceRegistry = class extends ServiceRegistryBase {
+	constructor(serviceMap, factories) {
+		super("UiServiceRegistry", serviceMap, factories);
+	}
+	get(id) {
+		return this.getById(id);
+	}
+};
+
+//#endregion
+exports.ModelServiceRegistry = ModelServiceRegistry;
+exports.UiServiceRegistry = UiServiceRegistry;
+//# sourceMappingURL=service_registry.cjs.map

package/dist/services/service_registry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"service_registry.cjs","names":["ServiceNotRegisteredError"],"sources":["../../src/services/service_registry.ts"],"sourcesContent":["import type {\n  ServiceTypesLike,\n  InferServiceModel,\n  InferServiceUi,\n  ServiceName,\n  ModelServiceFactoryMap,\n  UiServiceFactoryMap,\n} from \"./service_types\";\nimport { ServiceNotRegisteredError } from \"../errors\";\nimport type { Services } from \"./service_declarations\";\n\ntype RegistryName = \"ModelServiceRegistry\" | \"UiServiceRegistry\";\ntype ServiceFactory = () => Record<string, Function>;\n\nclass ServiceRegistryBase {\n  private readonly registryName: RegistryName;\n  private readonly knownServices = new Set<ServiceName>();\n  private readonly factories = new Map<ServiceName, ServiceFactory>();\n  private readonly instances = new Map<ServiceName, Record<string, Function>>();\n\n  protected constructor(\n    registryName: RegistryName,\n    serviceMap: Record<string, ServiceName>,\n    factories: Record<string, (() => unknown) | null>,\n  ) {\n    this.registryName = registryName;\n    for (const [key, factory] of Object.entries(factories)) {\n      const serviceId = serviceMap[key];\n      this.knownServices.add(serviceId);\n      if (factory !== null) {\n        this.factories.set(serviceId, factory as ServiceFactory);\n      }\n    }\n  }\n\n  async dispose(): Promise<void> {\n    for (const instance of this.instances.values()) {\n      if (Symbol.asyncDispose in instance) {\n        await (instance as AsyncDisposable)[Symbol.asyncDispose]();\n      } else if (Symbol.dispose in instance) {\n        (instance as Disposable)[Symbol.dispose]();\n      }\n    }\n    this.instances.clear();\n  }\n\n  protected getById(serviceId: ServiceName): Record<string, Function> | null {\n    if (!this.knownServices.has(serviceId)) {\n      throw new ServiceNotRegisteredError(\n        `Service \"${serviceId}\" is not registered in ${this.registryName}. Add it to the factory map.`,\n      );\n    }\n    if (this.instances.has(serviceId)) return this.instances.get(serviceId)!;\n\n    const factory = this.factories.get(serviceId);\n    if (!factory) return null;\n\n    const instance = factory();\n    this.instances.set(serviceId, instance);\n    return instance;\n  }\n}\n\nexport class ModelServiceRegistry<\n  SMap extends Record<string, ServiceName> = typeof Services,\n> extends ServiceRegistryBase {\n  constructor(serviceMap: SMap, factories: ModelServiceFactoryMap<SMap>) {\n    super(\"ModelServiceRegistry\", serviceMap, factories);\n  }\n\n  get<S extends ServiceTypesLike>(\n    id: ServiceName<S>,\n  ):\n    | ([unknown] extends [InferServiceModel<S>] ? Record<string, Function> : InferServiceModel<S>)\n    | null;\n  get(id: ServiceName): Record<string, Function> | null {\n    return this.getById(id);\n  }\n}\n\nexport class UiServiceRegistry<\n  SMap extends Record<string, ServiceName> = typeof Services,\n> extends ServiceRegistryBase {\n  constructor(serviceMap: SMap, factories: UiServiceFactoryMap<SMap>) {\n    super(\"UiServiceRegistry\", serviceMap, factories);\n  }\n\n  get<S extends ServiceTypesLike>(\n    id: ServiceName<S>,\n  ): ([unknown] extends [InferServiceUi<S>] ? Record<string, Function> : InferServiceUi<S>) | null;\n  get(id: ServiceName): Record<string, Function> | null {\n    return this.getById(id);\n  }\n}\n"],"mappings":";;;AAcA,IAAM,sBAAN,MAA0B;CACxB,AAAiB;CACjB,AAAiB,gCAAgB,IAAI,KAAkB;CACvD,AAAiB,4BAAY,IAAI,KAAkC;CACnE,AAAiB,4BAAY,IAAI,KAA4C;CAE7E,AAAU,YACR,cACA,YACA,WACA;AACA,OAAK,eAAe;AACpB,OAAK,MAAM,CAAC,KAAK,YAAY,OAAO,QAAQ,UAAU,EAAE;GACtD,MAAM,YAAY,WAAW;AAC7B,QAAK,cAAc,IAAI,UAAU;AACjC,OAAI,YAAY,KACd,MAAK,UAAU,IAAI,WAAW,QAA0B;;;CAK9D,MAAM,UAAyB;AAC7B,OAAK,MAAM,YAAY,KAAK,UAAU,QAAQ,CAC5C,KAAI,OAAO,gBAAgB,SACzB,OAAO,SAA6B,OAAO,eAAe;WACjD,OAAO,WAAW,SAC3B,CAAC,SAAwB,OAAO,UAAU;AAG9C,OAAK,UAAU,OAAO;;CAGxB,AAAU,QAAQ,WAAyD;AACzE,MAAI,CAAC,KAAK,cAAc,IAAI,UAAU,CACpC,OAAM,IAAIA,yCACR,YAAY,UAAU,yBAAyB,KAAK,aAAa,8BAClE;AAEH,MAAI,KAAK,UAAU,IAAI,UAAU,CAAE,QAAO,KAAK,UAAU,IAAI,UAAU;EAEvE,MAAM,UAAU,KAAK,UAAU,IAAI,UAAU;AAC7C,MAAI,CAAC,QAAS,QAAO;EAErB,MAAM,WAAW,SAAS;AAC1B,OAAK,UAAU,IAAI,WAAW,SAAS;AACvC,SAAO;;;AAIX,IAAa,uBAAb,cAEU,oBAAoB;CAC5B,YAAY,YAAkB,WAAyC;AACrE,QAAM,wBAAwB,YAAY,UAAU;;CAQtD,IAAI,IAAkD;AACpD,SAAO,KAAK,QAAQ,GAAG;;;AAI3B,IAAa,oBAAb,cAEU,oBAAoB;CAC5B,YAAY,YAAkB,WAAsC;AAClE,QAAM,qBAAqB,YAAY,UAAU;;CAMnD,IAAI,IAAkD;AACpD,SAAO,KAAK,QAAQ,GAAG"}

package/dist/services/service_registry.d.ts

@@ -0,0 +1,25 @@
+import { Services } from "./service_declarations.js";
+import { InferServiceModel, InferServiceUi, ModelServiceFactoryMap, ServiceName, ServiceTypesLike, UiServiceFactoryMap } from "./service_types.js";
+
+//#region src/services/service_registry.d.ts
+type RegistryName = "ModelServiceRegistry" | "UiServiceRegistry";
+declare class ServiceRegistryBase {
+  private readonly registryName;
+  private readonly knownServices;
+  private readonly factories;
+  private readonly instances;
+  protected constructor(registryName: RegistryName, serviceMap: Record<string, ServiceName>, factories: Record<string, (() => unknown) | null>);
+  dispose(): Promise<void>;
+  protected getById(serviceId: ServiceName): Record<string, Function> | null;
+}
+declare class ModelServiceRegistry<SMap extends Record<string, ServiceName> = typeof Services> extends ServiceRegistryBase {
+  constructor(serviceMap: SMap, factories: ModelServiceFactoryMap<SMap>);
+  get<S extends ServiceTypesLike>(id: ServiceName<S>): ([unknown] extends [InferServiceModel<S>] ? Record<string, Function> : InferServiceModel<S>) | null;
+}
+declare class UiServiceRegistry<SMap extends Record<string, ServiceName> = typeof Services> extends ServiceRegistryBase {
+  constructor(serviceMap: SMap, factories: UiServiceFactoryMap<SMap>);
+  get<S extends ServiceTypesLike>(id: ServiceName<S>): ([unknown] extends [InferServiceUi<S>] ? Record<string, Function> : InferServiceUi<S>) | null;
+}
+//#endregion
+export { ModelServiceRegistry, UiServiceRegistry };
+//# sourceMappingURL=service_registry.d.ts.map

package/dist/services/service_registry.js

@@ -0,0 +1,51 @@
+import { ServiceNotRegisteredError } from "../errors.js";
+
+//#region src/services/service_registry.ts
+var ServiceRegistryBase = class {
+	registryName;
+	knownServices = /* @__PURE__ */ new Set();
+	factories = /* @__PURE__ */ new Map();
+	instances = /* @__PURE__ */ new Map();
+	constructor(registryName, serviceMap, factories) {
+		this.registryName = registryName;
+		for (const [key, factory] of Object.entries(factories)) {
+			const serviceId = serviceMap[key];
+			this.knownServices.add(serviceId);
+			if (factory !== null) this.factories.set(serviceId, factory);
+		}
+	}
+	async dispose() {
+		for (const instance of this.instances.values()) if (Symbol.asyncDispose in instance) await instance[Symbol.asyncDispose]();
+		else if (Symbol.dispose in instance) instance[Symbol.dispose]();
+		this.instances.clear();
+	}
+	getById(serviceId) {
+		if (!this.knownServices.has(serviceId)) throw new ServiceNotRegisteredError(`Service "${serviceId}" is not registered in ${this.registryName}. Add it to the factory map.`);
+		if (this.instances.has(serviceId)) return this.instances.get(serviceId);
+		const factory = this.factories.get(serviceId);
+		if (!factory) return null;
+		const instance = factory();
+		this.instances.set(serviceId, instance);
+		return instance;
+	}
+};
+var ModelServiceRegistry = class extends ServiceRegistryBase {
+	constructor(serviceMap, factories) {
+		super("ModelServiceRegistry", serviceMap, factories);
+	}
+	get(id) {
+		return this.getById(id);
+	}
+};
+var UiServiceRegistry = class extends ServiceRegistryBase {
+	constructor(serviceMap, factories) {
+		super("UiServiceRegistry", serviceMap, factories);
+	}
+	get(id) {
+		return this.getById(id);
+	}
+};
+
+//#endregion
+export { ModelServiceRegistry, UiServiceRegistry };
+//# sourceMappingURL=service_registry.js.map

package/dist/services/service_registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service_registry.js","names":[],"sources":["../../src/services/service_registry.ts"],"sourcesContent":["import type {\n  ServiceTypesLike,\n  InferServiceModel,\n  InferServiceUi,\n  ServiceName,\n  ModelServiceFactoryMap,\n  UiServiceFactoryMap,\n} from \"./service_types\";\nimport { ServiceNotRegisteredError } from \"../errors\";\nimport type { Services } from \"./service_declarations\";\n\ntype RegistryName = \"ModelServiceRegistry\" | \"UiServiceRegistry\";\ntype ServiceFactory = () => Record<string, Function>;\n\nclass ServiceRegistryBase {\n  private readonly registryName: RegistryName;\n  private readonly knownServices = new Set<ServiceName>();\n  private readonly factories = new Map<ServiceName, ServiceFactory>();\n  private readonly instances = new Map<ServiceName, Record<string, Function>>();\n\n  protected constructor(\n    registryName: RegistryName,\n    serviceMap: Record<string, ServiceName>,\n    factories: Record<string, (() => unknown) | null>,\n  ) {\n    this.registryName = registryName;\n    for (const [key, factory] of Object.entries(factories)) {\n      const serviceId = serviceMap[key];\n      this.knownServices.add(serviceId);\n      if (factory !== null) {\n        this.factories.set(serviceId, factory as ServiceFactory);\n      }\n    }\n  }\n\n  async dispose(): Promise<void> {\n    for (const instance of this.instances.values()) {\n      if (Symbol.asyncDispose in instance) {\n        await (instance as AsyncDisposable)[Symbol.asyncDispose]();\n      } else if (Symbol.dispose in instance) {\n        (instance as Disposable)[Symbol.dispose]();\n      }\n    }\n    this.instances.clear();\n  }\n\n  protected getById(serviceId: ServiceName): Record<string, Function> | null {\n    if (!this.knownServices.has(serviceId)) {\n      throw new ServiceNotRegisteredError(\n        `Service \"${serviceId}\" is not registered in ${this.registryName}. Add it to the factory map.`,\n      );\n    }\n    if (this.instances.has(serviceId)) return this.instances.get(serviceId)!;\n\n    const factory = this.factories.get(serviceId);\n    if (!factory) return null;\n\n    const instance = factory();\n    this.instances.set(serviceId, instance);\n    return instance;\n  }\n}\n\nexport class ModelServiceRegistry<\n  SMap extends Record<string, ServiceName> = typeof Services,\n> extends ServiceRegistryBase {\n  constructor(serviceMap: SMap, factories: ModelServiceFactoryMap<SMap>) {\n    super(\"ModelServiceRegistry\", serviceMap, factories);\n  }\n\n  get<S extends ServiceTypesLike>(\n    id: ServiceName<S>,\n  ):\n    | ([unknown] extends [InferServiceModel<S>] ? Record<string, Function> : InferServiceModel<S>)\n    | null;\n  get(id: ServiceName): Record<string, Function> | null {\n    return this.getById(id);\n  }\n}\n\nexport class UiServiceRegistry<\n  SMap extends Record<string, ServiceName> = typeof Services,\n> extends ServiceRegistryBase {\n  constructor(serviceMap: SMap, factories: UiServiceFactoryMap<SMap>) {\n    super(\"UiServiceRegistry\", serviceMap, factories);\n  }\n\n  get<S extends ServiceTypesLike>(\n    id: ServiceName<S>,\n  ): ([unknown] extends [InferServiceUi<S>] ? Record<string, Function> : InferServiceUi<S>) | null;\n  get(id: ServiceName): Record<string, Function> | null {\n    return this.getById(id);\n  }\n}\n"],"mappings":";;;AAcA,IAAM,sBAAN,MAA0B;CACxB,AAAiB;CACjB,AAAiB,gCAAgB,IAAI,KAAkB;CACvD,AAAiB,4BAAY,IAAI,KAAkC;CACnE,AAAiB,4BAAY,IAAI,KAA4C;CAE7E,AAAU,YACR,cACA,YACA,WACA;AACA,OAAK,eAAe;AACpB,OAAK,MAAM,CAAC,KAAK,YAAY,OAAO,QAAQ,UAAU,EAAE;GACtD,MAAM,YAAY,WAAW;AAC7B,QAAK,cAAc,IAAI,UAAU;AACjC,OAAI,YAAY,KACd,MAAK,UAAU,IAAI,WAAW,QAA0B;;;CAK9D,MAAM,UAAyB;AAC7B,OAAK,MAAM,YAAY,KAAK,UAAU,QAAQ,CAC5C,KAAI,OAAO,gBAAgB,SACzB,OAAO,SAA6B,OAAO,eAAe;WACjD,OAAO,WAAW,SAC3B,CAAC,SAAwB,OAAO,UAAU;AAG9C,OAAK,UAAU,OAAO;;CAGxB,AAAU,QAAQ,WAAyD;AACzE,MAAI,CAAC,KAAK,cAAc,IAAI,UAAU,CACpC,OAAM,IAAI,0BACR,YAAY,UAAU,yBAAyB,KAAK,aAAa,8BAClE;AAEH,MAAI,KAAK,UAAU,IAAI,UAAU,CAAE,QAAO,KAAK,UAAU,IAAI,UAAU;EAEvE,MAAM,UAAU,KAAK,UAAU,IAAI,UAAU;AAC7C,MAAI,CAAC,QAAS,QAAO;EAErB,MAAM,WAAW,SAAS;AAC1B,OAAK,UAAU,IAAI,WAAW,SAAS;AACvC,SAAO;;;AAIX,IAAa,uBAAb,cAEU,oBAAoB;CAC5B,YAAY,YAAkB,WAAyC;AACrE,QAAM,wBAAwB,YAAY,UAAU;;CAQtD,IAAI,IAAkD;AACpD,SAAO,KAAK,QAAQ,GAAG;;;AAI3B,IAAa,oBAAb,cAEU,oBAAoB;CAC5B,YAAY,YAAkB,WAAsC;AAClE,QAAM,qBAAqB,YAAY,UAAU;;CAMnD,IAAI,IAAkD;AACpD,SAAO,KAAK,QAAQ,GAAG"}

package/dist/services/service_types.cjs

@@ -0,0 +1,30 @@
+const require_errors = require('../errors.cjs');
+
+//#region src/services/service_types.ts
+const SERVICE_ID_PATTERN = /^[a-zA-Z][a-zA-Z0-9]*$/;
+const { service, isNodeService } = (() => {
+	const typeMap = /* @__PURE__ */ new Map();
+	return {
+		service() {
+			return (options) => {
+				const { name, type } = options;
+				if (!SERVICE_ID_PATTERN.test(name)) throw new require_errors.ServiceInvalidIdError(`Invalid service ID "${name}": must match ${SERVICE_ID_PATTERN}`);
+				if (typeMap.has(name)) throw new require_errors.ServiceAlreadyRegisteredError(`Service "${name}" already registered`);
+				typeMap.set(name, type);
+				return name;
+			};
+		},
+		isNodeService(id) {
+			return typeMap.get(id) === "node";
+		}
+	};
+})();
+function serviceFnKey(serviceId, method = "") {
+	return `service:${serviceId}:${method}`;
+}
+
+//#endregion
+exports.isNodeService = isNodeService;
+exports.service = service;
+exports.serviceFnKey = serviceFnKey;
+//# sourceMappingURL=service_types.cjs.map

package/dist/services/service_types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"service_types.cjs","names":["ServiceInvalidIdError","ServiceAlreadyRegisteredError"],"sources":["../../src/services/service_types.ts"],"sourcesContent":["import type { Branded } from \"../branding\";\nimport { ServiceAlreadyRegisteredError, ServiceInvalidIdError } from \"../errors\";\nimport type { Services } from \"./service_declarations\";\n\nexport type ServiceTypesLike<\n  Model = unknown,\n  Ui = unknown,\n  Kind extends ServiceType = ServiceType,\n> = {\n  readonly __types?: { model: Model; ui: Ui; kind: Kind };\n};\n\nexport type InferServiceModel<S extends ServiceTypesLike> =\n  S extends ServiceTypesLike<infer M, unknown, ServiceType> ? M : unknown;\n\nexport type InferServiceUi<S extends ServiceTypesLike> =\n  S extends ServiceTypesLike<unknown, infer U, ServiceType> ? U : unknown;\n\nexport type InferServiceKind<S extends ServiceTypesLike> =\n  S extends ServiceTypesLike<unknown, unknown, infer K> ? K : ServiceType;\n\nexport type ServiceName<S extends ServiceTypesLike = ServiceTypesLike> = Branded<string, S>;\n\nexport type ServiceType = \"node\" | \"wasm\";\n\nconst SERVICE_ID_PATTERN = /^[a-zA-Z][a-zA-Z0-9]*$/;\n\nexport const { service, isNodeService } = (() => {\n  const typeMap = new Map<string, ServiceType>();\n  return {\n    service<Model, Ui>() {\n      return <K extends ServiceType, N extends string>(options: {\n        readonly type: K;\n        readonly name: N;\n      }): Branded<N, ServiceTypesLike<Model, Ui, K>> => {\n        const { name, type } = options;\n        if (!SERVICE_ID_PATTERN.test(name)) {\n          throw new ServiceInvalidIdError(\n            `Invalid service ID \"${name}\": must match ${SERVICE_ID_PATTERN}`,\n          );\n        }\n        if (typeMap.has(name)) {\n          throw new ServiceAlreadyRegisteredError(`Service \"${name}\" already registered`);\n        }\n        typeMap.set(name, type);\n        return name as Branded<N, ServiceTypesLike<Model, Ui, K>>;\n      };\n    },\n    isNodeService(id: ServiceName): boolean {\n      return typeMap.get(id) === \"node\";\n    },\n  };\n})();\n\nexport function serviceFnKey(serviceId: string, method = \"\"): string {\n  return `service:${serviceId}:${method}`;\n}\n\nexport type ServiceBrand<T> =\n  T extends Branded<string, infer S extends ServiceTypesLike> ? S : never;\n\nexport type ModelServiceFactoryMap<SMap extends Record<string, ServiceName>> = {\n  [K in keyof SMap]: (() => InferServiceModel<ServiceBrand<SMap[K]>>) | null;\n};\n\nexport type UiServiceFactoryMap<SMap extends Record<string, ServiceName>> = {\n  [K in keyof SMap]: (() => InferServiceUi<ServiceBrand<SMap[K]>>) | null;\n};\n\n/** Contract between any service provider and any service consumer. */\nexport interface ServiceDispatch {\n  getServiceNames(): ServiceName[];\n  getServiceMethods(serviceId: ServiceName): string[];\n  callServiceMethod(serviceId: ServiceName, method: string, ...args: unknown[]): unknown;\n}\n\n// Auto-derived types from the Services const in service_declarations.ts.\n// Adding a service to Services automatically updates all of these.\n\ntype SMap = typeof Services;\n\ntype ExtractServiceName<T> = T extends Branded<infer N extends string, any> ? N : never;\n\n/** Model-side service interfaces keyed by service name literal. */\nexport type ModelServices = {\n  [K in keyof SMap as ExtractServiceName<SMap[K]>]: InferServiceModel<ServiceBrand<SMap[K]>>;\n};\n\n/** UI-side service interfaces keyed by service name literal. */\nexport type UiServices = {\n  [K in keyof SMap as ExtractServiceName<SMap[K]>]: InferServiceUi<ServiceBrand<SMap[K]>>;\n};\n\n/** Map from Services keys to their unbranded string name literals. */\nexport type ServiceNameLiterals = {\n  [K in keyof SMap]: ExtractServiceName<SMap[K]>;\n};\n\n/** Auto-derived requires* feature flags from Services keys. */\nexport type ServiceRequireFlags = {\n  [K in keyof SMap as `requires${K & string}`]?: boolean;\n};\n\ntype UnionToIntersection<U> = (U extends unknown ? (k: U) => void : never) extends (\n  k: infer I,\n) => void\n  ? I\n  : never;\n\nexport type RequireServices<T extends ServiceName> = UnionToIntersection<\n  T extends Branded<infer N extends string, infer S extends ServiceTypesLike>\n    ? Record<N, InferServiceModel<S>>\n    : never\n>;\n"],"mappings":";;;AAyBA,MAAM,qBAAqB;AAE3B,MAAa,EAAE,SAAS,yBAAyB;CAC/C,MAAM,0BAAU,IAAI,KAA0B;AAC9C,QAAO;EACL,UAAqB;AACnB,WAAiD,YAGC;IAChD,MAAM,EAAE,MAAM,SAAS;AACvB,QAAI,CAAC,mBAAmB,KAAK,KAAK,CAChC,OAAM,IAAIA,qCACR,uBAAuB,KAAK,gBAAgB,qBAC7C;AAEH,QAAI,QAAQ,IAAI,KAAK,CACnB,OAAM,IAAIC,6CAA8B,YAAY,KAAK,sBAAsB;AAEjF,YAAQ,IAAI,MAAM,KAAK;AACvB,WAAO;;;EAGX,cAAc,IAA0B;AACtC,UAAO,QAAQ,IAAI,GAAG,KAAK;;EAE9B;IACC;AAEJ,SAAgB,aAAa,WAAmB,SAAS,IAAY;AACnE,QAAO,WAAW,UAAU,GAAG"}

package/dist/services/service_types.d.ts

@@ -0,0 +1,45 @@
+import { Branded } from "../branding.js";
+import { Services } from "./service_declarations.js";
+
+//#region src/services/service_types.d.ts
+type ServiceTypesLike<Model = unknown, Ui = unknown, Kind extends ServiceType = ServiceType> = {
+  readonly __types?: {
+    model: Model;
+    ui: Ui;
+    kind: Kind;
+  };
+};
+type InferServiceModel<S extends ServiceTypesLike> = S extends ServiceTypesLike<infer M, unknown, ServiceType> ? M : unknown;
+type InferServiceUi<S extends ServiceTypesLike> = S extends ServiceTypesLike<unknown, infer U, ServiceType> ? U : unknown;
+type InferServiceKind<S extends ServiceTypesLike> = S extends ServiceTypesLike<unknown, unknown, infer K> ? K : ServiceType;
+type ServiceName<S extends ServiceTypesLike = ServiceTypesLike> = Branded<string, S>;
+type ServiceType = "node" | "wasm";
+declare const service: <Model, Ui>() => <K extends ServiceType, N extends string>(options: {
+    readonly type: K;
+    readonly name: N;
+  }) => Branded<N, ServiceTypesLike<Model, Ui, K>>, isNodeService: (id: ServiceName) => boolean;
+declare function serviceFnKey(serviceId: string, method?: string): string;
+type ServiceBrand<T> = T extends Branded<string, infer S extends ServiceTypesLike> ? S : never;
+type ModelServiceFactoryMap<SMap extends Record<string, ServiceName>> = { [K in keyof SMap]: (() => InferServiceModel<ServiceBrand<SMap[K]>>) | null };
+type UiServiceFactoryMap<SMap extends Record<string, ServiceName>> = { [K in keyof SMap]: (() => InferServiceUi<ServiceBrand<SMap[K]>>) | null };
+/** Contract between any service provider and any service consumer. */
+interface ServiceDispatch {
+  getServiceNames(): ServiceName[];
+  getServiceMethods(serviceId: ServiceName): string[];
+  callServiceMethod(serviceId: ServiceName, method: string, ...args: unknown[]): unknown;
+}
+type SMap = typeof Services;
+type ExtractServiceName<T> = T extends Branded<infer N extends string, any> ? N : never;
+/** Model-side service interfaces keyed by service name literal. */
+type ModelServices = { [K in keyof SMap as ExtractServiceName<SMap[K]>]: InferServiceModel<ServiceBrand<SMap[K]>> };
+/** UI-side service interfaces keyed by service name literal. */
+type UiServices = { [K in keyof SMap as ExtractServiceName<SMap[K]>]: InferServiceUi<ServiceBrand<SMap[K]>> };
+/** Map from Services keys to their unbranded string name literals. */
+type ServiceNameLiterals = { [K in keyof SMap]: ExtractServiceName<SMap[K]> };
+/** Auto-derived requires* feature flags from Services keys. */
+type ServiceRequireFlags = { [K in keyof SMap as `requires${K & string}`]?: boolean };
+type UnionToIntersection<U> = (U extends unknown ? (k: U) => void : never) extends ((k: infer I) => void) ? I : never;
+type RequireServices<T extends ServiceName> = UnionToIntersection<T extends Branded<infer N extends string, infer S extends ServiceTypesLike> ? Record<N, InferServiceModel<S>> : never>;
+//#endregion
+export { InferServiceKind, InferServiceModel, InferServiceUi, ModelServiceFactoryMap, ModelServices, RequireServices, ServiceBrand, ServiceDispatch, ServiceName, ServiceNameLiterals, ServiceRequireFlags, ServiceType, ServiceTypesLike, UiServiceFactoryMap, UiServices, isNodeService, service, serviceFnKey };
+//# sourceMappingURL=service_types.d.ts.map

package/dist/services/service_types.js

@@ -0,0 +1,28 @@
+import { ServiceAlreadyRegisteredError, ServiceInvalidIdError } from "../errors.js";
+
+//#region src/services/service_types.ts
+const SERVICE_ID_PATTERN = /^[a-zA-Z][a-zA-Z0-9]*$/;
+const { service, isNodeService } = (() => {
+	const typeMap = /* @__PURE__ */ new Map();
+	return {
+		service() {
+			return (options) => {
+				const { name, type } = options;
+				if (!SERVICE_ID_PATTERN.test(name)) throw new ServiceInvalidIdError(`Invalid service ID "${name}": must match ${SERVICE_ID_PATTERN}`);
+				if (typeMap.has(name)) throw new ServiceAlreadyRegisteredError(`Service "${name}" already registered`);
+				typeMap.set(name, type);
+				return name;
+			};
+		},
+		isNodeService(id) {
+			return typeMap.get(id) === "node";
+		}
+	};
+})();
+function serviceFnKey(serviceId, method = "") {
+	return `service:${serviceId}:${method}`;
+}
+
+//#endregion
+export { isNodeService, service, serviceFnKey };
+//# sourceMappingURL=service_types.js.map

package/dist/services/service_types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service_types.js","names":[],"sources":["../../src/services/service_types.ts"],"sourcesContent":["import type { Branded } from \"../branding\";\nimport { ServiceAlreadyRegisteredError, ServiceInvalidIdError } from \"../errors\";\nimport type { Services } from \"./service_declarations\";\n\nexport type ServiceTypesLike<\n  Model = unknown,\n  Ui = unknown,\n  Kind extends ServiceType = ServiceType,\n> = {\n  readonly __types?: { model: Model; ui: Ui; kind: Kind };\n};\n\nexport type InferServiceModel<S extends ServiceTypesLike> =\n  S extends ServiceTypesLike<infer M, unknown, ServiceType> ? M : unknown;\n\nexport type InferServiceUi<S extends ServiceTypesLike> =\n  S extends ServiceTypesLike<unknown, infer U, ServiceType> ? U : unknown;\n\nexport type InferServiceKind<S extends ServiceTypesLike> =\n  S extends ServiceTypesLike<unknown, unknown, infer K> ? K : ServiceType;\n\nexport type ServiceName<S extends ServiceTypesLike = ServiceTypesLike> = Branded<string, S>;\n\nexport type ServiceType = \"node\" | \"wasm\";\n\nconst SERVICE_ID_PATTERN = /^[a-zA-Z][a-zA-Z0-9]*$/;\n\nexport const { service, isNodeService } = (() => {\n  const typeMap = new Map<string, ServiceType>();\n  return {\n    service<Model, Ui>() {\n      return <K extends ServiceType, N extends string>(options: {\n        readonly type: K;\n        readonly name: N;\n      }): Branded<N, ServiceTypesLike<Model, Ui, K>> => {\n        const { name, type } = options;\n        if (!SERVICE_ID_PATTERN.test(name)) {\n          throw new ServiceInvalidIdError(\n            `Invalid service ID \"${name}\": must match ${SERVICE_ID_PATTERN}`,\n          );\n        }\n        if (typeMap.has(name)) {\n          throw new ServiceAlreadyRegisteredError(`Service \"${name}\" already registered`);\n        }\n        typeMap.set(name, type);\n        return name as Branded<N, ServiceTypesLike<Model, Ui, K>>;\n      };\n    },\n    isNodeService(id: ServiceName): boolean {\n      return typeMap.get(id) === \"node\";\n    },\n  };\n})();\n\nexport function serviceFnKey(serviceId: string, method = \"\"): string {\n  return `service:${serviceId}:${method}`;\n}\n\nexport type ServiceBrand<T> =\n  T extends Branded<string, infer S extends ServiceTypesLike> ? S : never;\n\nexport type ModelServiceFactoryMap<SMap extends Record<string, ServiceName>> = {\n  [K in keyof SMap]: (() => InferServiceModel<ServiceBrand<SMap[K]>>) | null;\n};\n\nexport type UiServiceFactoryMap<SMap extends Record<string, ServiceName>> = {\n  [K in keyof SMap]: (() => InferServiceUi<ServiceBrand<SMap[K]>>) | null;\n};\n\n/** Contract between any service provider and any service consumer. */\nexport interface ServiceDispatch {\n  getServiceNames(): ServiceName[];\n  getServiceMethods(serviceId: ServiceName): string[];\n  callServiceMethod(serviceId: ServiceName, method: string, ...args: unknown[]): unknown;\n}\n\n// Auto-derived types from the Services const in service_declarations.ts.\n// Adding a service to Services automatically updates all of these.\n\ntype SMap = typeof Services;\n\ntype ExtractServiceName<T> = T extends Branded<infer N extends string, any> ? N : never;\n\n/** Model-side service interfaces keyed by service name literal. */\nexport type ModelServices = {\n  [K in keyof SMap as ExtractServiceName<SMap[K]>]: InferServiceModel<ServiceBrand<SMap[K]>>;\n};\n\n/** UI-side service interfaces keyed by service name literal. */\nexport type UiServices = {\n  [K in keyof SMap as ExtractServiceName<SMap[K]>]: InferServiceUi<ServiceBrand<SMap[K]>>;\n};\n\n/** Map from Services keys to their unbranded string name literals. */\nexport type ServiceNameLiterals = {\n  [K in keyof SMap]: ExtractServiceName<SMap[K]>;\n};\n\n/** Auto-derived requires* feature flags from Services keys. */\nexport type ServiceRequireFlags = {\n  [K in keyof SMap as `requires${K & string}`]?: boolean;\n};\n\ntype UnionToIntersection<U> = (U extends unknown ? (k: U) => void : never) extends (\n  k: infer I,\n) => void\n  ? I\n  : never;\n\nexport type RequireServices<T extends ServiceName> = UnionToIntersection<\n  T extends Branded<infer N extends string, infer S extends ServiceTypesLike>\n    ? Record<N, InferServiceModel<S>>\n    : never\n>;\n"],"mappings":";;;AAyBA,MAAM,qBAAqB;AAE3B,MAAa,EAAE,SAAS,yBAAyB;CAC/C,MAAM,0BAAU,IAAI,KAA0B;AAC9C,QAAO;EACL,UAAqB;AACnB,WAAiD,YAGC;IAChD,MAAM,EAAE,MAAM,SAAS;AACvB,QAAI,CAAC,mBAAmB,KAAK,KAAK,CAChC,OAAM,IAAI,sBACR,uBAAuB,KAAK,gBAAgB,qBAC7C;AAEH,QAAI,QAAQ,IAAI,KAAK,CACnB,OAAM,IAAI,8BAA8B,YAAY,KAAK,sBAAsB;AAEjF,YAAQ,IAAI,MAAM,KAAK;AACvB,WAAO;;;EAGX,cAAc,IAA0B;AACtC,UAAO,QAAQ,IAAI,GAAG,KAAK;;EAE9B;IACC;AAEJ,SAAgB,aAAa,WAAmB,SAAS,IAAY;AACnE,QAAO,WAAW,UAAU,GAAG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@milaboratories/pl-model-common",
-  "version": "1.29.0",
+  "version": "1.31.0",
   "description": "Platforma SDK Model",
   "files": [
     "./dist/**/*",
@@ -19,15 +19,15 @@
   "dependencies": {
     "canonicalize": "~2.1.0",
     "zod": "~3.23.8",
-    "@milaboratories/helpers": "1.14.0",
-    "@milaboratories/pl-error-like": "1.12.9"
+    "@milaboratories/pl-error-like": "1.12.9",
+    "@milaboratories/helpers": "1.14.0"
   },
   "devDependencies": {
     "@vitest/coverage-istanbul": "^4.0.18",
     "typescript": "~5.9.3",
     "vitest": "^4.0.18",
-    "@milaboratories/build-configs": "1.5.2",
     "@milaboratories/ts-builder": "1.3.0",
+    "@milaboratories/build-configs": "1.5.2",
     "@milaboratories/ts-configs": "1.2.2"
   },
   "scripts": {