@milaboratories/pl-model-common 1.34.1 → 1.36.0

package/dist/services/service_injectors.js

@@ -1,45 +1,48 @@
+import { getServiceModelMethods, getServiceUiMethods } from "./service_types.js";
 import { Services } from "./service_declarations.js";
-import { getMethodNames, resolveRequiredServices } from "./service_capabilities.js";
-import { createUiServiceInjectors } from "./service_injector_factory.js";
+import { resolveRequiredServices } from "./service_capabilities.js";
+import { createNodeServiceHandlers } from "./node_service_handlers.js";
 //#region src/services/service_injectors.ts
 let cachedKit;
-let cachedInjectors;
-function getOrCreateInjectors(driverKit) {
-	if (!cachedInjectors || cachedKit !== driverKit) {
+let cachedHandlers;
+function getOrCreateHandlers(driverKit) {
+	if (!cachedHandlers || cachedKit !== driverKit) {
 		cachedKit = driverKit;
-		cachedInjectors = createUiServiceInjectors(driverKit);
+		cachedHandlers = createNodeServiceHandlers(driverKit);
 	}
-	return cachedInjectors;
+	return cachedHandlers;
 }
-/** Resolve the injector for a given service ID. Caches injectors per DriverKit reference. */
-function resolveUiInjector(driverKit, serviceId) {
-	const injectors = getOrCreateInjectors(driverKit);
+/**
+* Resolve the worker-side handler object for a given service ID. Caches
+* per DriverKit reference. Called from the worker's IPC dispatch path.
+*/
+function resolveNodeServiceHandler(driverKit, serviceId) {
+	const handlers = getOrCreateHandlers(driverKit);
 	const key = Object.keys(Services).find((k) => Services[k] === serviceId);
 	if (!key) return null;
-	return injectors[key];
+	return handlers[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: () => () => {} }) }));
+function buildMethodMap(pick) {
 	const result = {};
-	for (const key of Object.keys(Services)) {
-		const serviceId = Services[key];
-		const injector = injectors[key];
-		result[serviceId] = injector ? getMethodNames(injector) : [];
-	}
+	for (const id of Object.values(Services)) result[id] = [...pick(id)];
 	return result;
-})();
+}
+/**
+* UI-side method names per service. Drives ServiceProxy forwarder
+* construction in the renderer.
+*/
+const SERVICE_METHOD_MAP = buildMethodMap(getServiceUiMethods);
+/**
+* Model-side method names per service. Drives the workflow VM bridge
+* (see pl-middle-layer js_render).
+*/
+const MODEL_SERVICE_METHOD_MAP = buildMethodMap(getServiceModelMethods);
 /** 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 };
+export { MODEL_SERVICE_METHOD_MAP, SERVICE_METHOD_MAP, buildServiceInfo, resolveNodeServiceHandler };
 
 //# sourceMappingURL=service_injectors.js.map

package/dist/services/service_injectors.js.map

@@ -1 +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"}
+{"version":3,"file":"service_injectors.js","names":[],"sources":["../../src/services/service_injectors.ts"],"sourcesContent":["/**\n * Service dispatch glue — auto-derived types, method maps, and service info builder.\n *\n * The worker-side handler factory (createNodeServiceHandlers) lives in\n * node_service_handlers.ts — that's the only file to edit when adding a\n * new node service. Method-name registries for UI and model sides are\n * derived directly from the `uiMethods` / `modelMethods` declarations in\n * service_declarations.ts — no factory introspection, no stubs.\n */\n\nimport type { InferServiceKind, InferServiceUi, ServiceBrand, ServiceName } from \"./service_types\";\nimport type { DriverKit } from \"../driver_kit\";\nimport { Services } from \"./service_declarations\";\nimport { getServiceModelMethods, getServiceUiMethods } from \"./service_types\";\nimport { resolveRequiredServices } from \"./service_capabilities\";\nimport { createNodeServiceHandlers } from \"./node_service_handlers\";\n\nexport { createNodeServiceHandlers } from \"./node_service_handlers\";\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/**\n * Auto-derived map of node service keys to their UI-facing interfaces.\n * Fulfilled by real driver wrappers in the worker. Main services are\n * dispatched by the Electron main-process router and never reach this\n * map; wasm services are instantiated locally on each consumer.\n */\nexport type NodeServiceHandlerMap = {\n  [K in NodeServiceKeys]: InferServiceUi<ServiceBrand<(typeof Services)[K]>>;\n};\n\nlet cachedKit: DriverKit | undefined;\nlet cachedHandlers: NodeServiceHandlerMap | undefined;\n\nfunction getOrCreateHandlers(driverKit: DriverKit): NodeServiceHandlerMap {\n  if (!cachedHandlers || cachedKit !== driverKit) {\n    cachedKit = driverKit;\n    cachedHandlers = createNodeServiceHandlers(driverKit);\n  }\n  return cachedHandlers;\n}\n\n/**\n * Resolve the worker-side handler object for a given service ID. Caches\n * per DriverKit reference. Called from the worker's IPC dispatch path.\n */\nexport function resolveNodeServiceHandler(\n  driverKit: DriverKit,\n  serviceId: ServiceName,\n): NodeServiceHandlerMap[keyof NodeServiceHandlerMap] | null {\n  const handlers = getOrCreateHandlers(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 handlers[key];\n}\n\nfunction buildMethodMap(\n  pick: (id: ServiceName) => readonly string[],\n): Readonly<Record<string, string[]>> {\n  const result: Record<string, string[]> = {};\n  for (const id of Object.values(Services)) {\n    result[id as string] = [...pick(id)];\n  }\n  return result;\n}\n\n/**\n * UI-side method names per service. Drives ServiceProxy forwarder\n * construction in the renderer.\n */\nexport const SERVICE_METHOD_MAP: Readonly<Record<string, string[]>> =\n  buildMethodMap(getServiceUiMethods);\n\n/**\n * Model-side method names per service. Drives the workflow VM bridge\n * (see pl-middle-layer js_render).\n */\nexport const MODEL_SERVICE_METHOD_MAP: Readonly<Record<string, string[]>> =\n  buildMethodMap(getServiceModelMethods);\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":";;;;;AAmCA,IAAI;AACJ,IAAI;AAEJ,SAAS,oBAAoB,WAA6C;AACxE,KAAI,CAAC,kBAAkB,cAAc,WAAW;AAC9C,cAAY;AACZ,mBAAiB,0BAA0B,UAAU;;AAEvD,QAAO;;;;;;AAOT,SAAgB,0BACd,WACA,WAC2D;CAC3D,MAAM,WAAW,oBAAoB,UAAU;CAC/C,MAAM,MAAM,OAAO,KAAK,SAAS,CAAC,MAC/B,MAAM,SAAS,OAAgC,UACjD;AACD,KAAI,CAAC,IAAK,QAAO;AACjB,QAAO,SAAS;;AAGlB,SAAS,eACP,MACoC;CACpC,MAAM,SAAmC,EAAE;AAC3C,MAAK,MAAM,MAAM,OAAO,OAAO,SAAS,CACtC,QAAO,MAAgB,CAAC,GAAG,KAAK,GAAG,CAAC;AAEtC,QAAO;;;;;;AAOT,MAAa,qBACX,eAAe,oBAAoB;;;;;AAMrC,MAAa,2BACX,eAAe,uBAAuB;;AAGxC,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_types.cjs

@@ -1,20 +1,39 @@
 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 { service, isNodeService, isWasmService, isMainService, getServiceKind, getServiceModelMethods, getServiceUiMethods } = (() => {
 	const typeMap = /* @__PURE__ */ new Map();
+	const modelMethodsMap = /* @__PURE__ */ new Map();
+	const uiMethodsMap = /* @__PURE__ */ new Map();
 	return {
 		service() {
 			return (options) => {
-				const { name, type } = options;
+				const { name, type, modelMethods, uiMethods } = 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);
+				modelMethodsMap.set(name, modelMethods);
+				uiMethodsMap.set(name, uiMethods);
 				return name;
 			};
 		},
 		isNodeService(id) {
 			return typeMap.get(id) === "node";
+		},
+		isWasmService(id) {
+			return typeMap.get(id) === "wasm";
+		},
+		isMainService(id) {
+			return typeMap.get(id) === "main";
+		},
+		getServiceKind(id) {
+			return typeMap.get(id);
+		},
+		getServiceModelMethods(id) {
+			return modelMethodsMap.get(id) ?? [];
+		},
+		getServiceUiMethods(id) {
+			return uiMethodsMap.get(id) ?? [];
 		}
 	};
 })();
@@ -22,7 +41,12 @@ function serviceFnKey(serviceId, method = "") {
 	return `service:${serviceId}:${method}`;
 }
 //#endregion
+exports.getServiceKind = getServiceKind;
+exports.getServiceModelMethods = getServiceModelMethods;
+exports.getServiceUiMethods = getServiceUiMethods;
+exports.isMainService = isMainService;
 exports.isNodeService = isNodeService;
+exports.isWasmService = isWasmService;
 exports.service = service;
 exports.serviceFnKey = serviceFnKey;
 

package/dist/services/service_types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"service_types.cjs","names":["ServiceInvalidIdError","ServiceAlreadyRegisteredError"],"sources":["../../src/services/service_types.ts"],"sourcesContent":["import { UnionToIntersection } from \"@milaboratories/helpers\";\nimport 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 TServices = 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 TServices as ExtractServiceName<TServices[K]>]: InferServiceModel<\n    ServiceBrand<TServices[K]>\n  >;\n};\n\n/** UI-side service interfaces keyed by service name literal. */\nexport type UiServices = {\n  [K in keyof TServices as ExtractServiceName<TServices[K]>]: InferServiceUi<\n    ServiceBrand<TServices[K]>\n  >;\n};\n\n/** Map from Services keys to their unbranded string name literals. */\nexport type ServiceNameLiterals = {\n  [K in keyof TServices]: ExtractServiceName<TServices[K]>;\n};\n\n/** Auto-derived requires* feature flags from Services keys. */\nexport type ServiceRequireFlags = {\n  [K in keyof TServices as `requires${K & string}`]?: boolean;\n};\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":";;AA0BA,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,eAAAA,sBACR,uBAAuB,KAAK,gBAAgB,qBAC7C;AAEH,QAAI,QAAQ,IAAI,KAAK,CACnB,OAAM,IAAIC,eAAAA,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"}
+{"version":3,"file":"service_types.cjs","names":["ServiceInvalidIdError","ServiceAlreadyRegisteredError"],"sources":["../../src/services/service_types.ts"],"sourcesContent":["import { UnionToIntersection } from \"@milaboratories/helpers\";\nimport 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\" | \"main\";\n\nconst SERVICE_ID_PATTERN = /^[a-zA-Z][a-zA-Z0-9]*$/;\n\nexport const {\n  service,\n  isNodeService,\n  isWasmService,\n  isMainService,\n  getServiceKind,\n  getServiceModelMethods,\n  getServiceUiMethods,\n} = (() => {\n  const typeMap = new Map<string, ServiceType>();\n  const modelMethodsMap = new Map<string, readonly string[]>();\n  const uiMethodsMap = new Map<string, readonly string[]>();\n  return {\n    service<Model, Ui>() {\n      return <\n        K extends ServiceType,\n        N extends string,\n        MM extends readonly (keyof Model & string)[],\n        UM extends readonly (keyof Ui & string)[],\n      >(options: {\n        readonly type: K;\n        readonly name: N;\n        readonly modelMethods: MM;\n        readonly uiMethods: UM;\n      }): Branded<N, ServiceTypesLike<Model, Ui, K>> => {\n        const { name, type, modelMethods, uiMethods } = 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        modelMethodsMap.set(name, modelMethods);\n        uiMethodsMap.set(name, uiMethods);\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    isWasmService(id: ServiceName): boolean {\n      return typeMap.get(id) === \"wasm\";\n    },\n    isMainService(id: ServiceName): boolean {\n      return typeMap.get(id) === \"main\";\n    },\n    getServiceKind(id: ServiceName): ServiceType | undefined {\n      return typeMap.get(id);\n    },\n    getServiceModelMethods(id: ServiceName): readonly string[] {\n      return modelMethodsMap.get(id) ?? [];\n    },\n    getServiceUiMethods(id: ServiceName): readonly string[] {\n      return uiMethodsMap.get(id) ?? [];\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 TServices = 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 TServices as ExtractServiceName<TServices[K]>]: InferServiceModel<\n    ServiceBrand<TServices[K]>\n  >;\n};\n\n/** UI-side service interfaces keyed by service name literal. */\nexport type UiServices = {\n  [K in keyof TServices as ExtractServiceName<TServices[K]>]: InferServiceUi<\n    ServiceBrand<TServices[K]>\n  >;\n};\n\n/** Map from Services keys to their unbranded string name literals. */\nexport type ServiceNameLiterals = {\n  [K in keyof TServices]: ExtractServiceName<TServices[K]>;\n};\n\n/** Auto-derived requires* feature flags from Services keys. */\nexport type ServiceRequireFlags = {\n  [K in keyof TServices as `requires${K & string}`]?: boolean;\n};\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":";;AA0BA,MAAM,qBAAqB;AAE3B,MAAa,EACX,SACA,eACA,eACA,eACA,gBACA,wBACA,+BACS;CACT,MAAM,0BAAU,IAAI,KAA0B;CAC9C,MAAM,kCAAkB,IAAI,KAAgC;CAC5D,MAAM,+BAAe,IAAI,KAAgC;AACzD,QAAO;EACL,UAAqB;AACnB,WAKE,YAKgD;IAChD,MAAM,EAAE,MAAM,MAAM,cAAc,cAAc;AAChD,QAAI,CAAC,mBAAmB,KAAK,KAAK,CAChC,OAAM,IAAIA,eAAAA,sBACR,uBAAuB,KAAK,gBAAgB,qBAC7C;AAEH,QAAI,QAAQ,IAAI,KAAK,CACnB,OAAM,IAAIC,eAAAA,8BAA8B,YAAY,KAAK,sBAAsB;AAEjF,YAAQ,IAAI,MAAM,KAAK;AACvB,oBAAgB,IAAI,MAAM,aAAa;AACvC,iBAAa,IAAI,MAAM,UAAU;AACjC,WAAO;;;EAGX,cAAc,IAA0B;AACtC,UAAO,QAAQ,IAAI,GAAG,KAAK;;EAE7B,cAAc,IAA0B;AACtC,UAAO,QAAQ,IAAI,GAAG,KAAK;;EAE7B,cAAc,IAA0B;AACtC,UAAO,QAAQ,IAAI,GAAG,KAAK;;EAE7B,eAAe,IAA0C;AACvD,UAAO,QAAQ,IAAI,GAAG;;EAExB,uBAAuB,IAAoC;AACzD,UAAO,gBAAgB,IAAI,GAAG,IAAI,EAAE;;EAEtC,oBAAoB,IAAoC;AACtD,UAAO,aAAa,IAAI,GAAG,IAAI,EAAE;;EAEpC;IACC;AAEJ,SAAgB,aAAa,WAAmB,SAAS,IAAY;AACnE,QAAO,WAAW,UAAU,GAAG"}

package/dist/services/service_types.d.ts

@@ -14,11 +14,13 @@ type InferServiceModel<S extends ServiceTypesLike> = S extends ServiceTypesLike<
 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$1<string, S>;
-type ServiceType = "node" | "wasm";
-declare const service: <Model, Ui>() => <K extends ServiceType, N extends string>(options: {
+type ServiceType = "node" | "wasm" | "main";
+declare const service: <Model, Ui>() => <K extends ServiceType, N extends string, MM extends readonly (keyof Model & string)[], UM extends readonly (keyof Ui & string)[]>(options: {
     readonly type: K;
     readonly name: N;
-  }) => Branded$1<N, ServiceTypesLike<Model, Ui, K>>, isNodeService: (id: ServiceName) => boolean;
+    readonly modelMethods: MM;
+    readonly uiMethods: UM;
+  }) => Branded$1<N, ServiceTypesLike<Model, Ui, K>>, isNodeService: (id: ServiceName) => boolean, isWasmService: (id: ServiceName) => boolean, isMainService: (id: ServiceName) => boolean, getServiceKind: (id: ServiceName) => ServiceType | undefined, getServiceModelMethods: (id: ServiceName) => readonly string[], getServiceUiMethods: (id: ServiceName) => readonly string[];
 declare function serviceFnKey(serviceId: string, method?: string): string;
 type ServiceBrand<T> = T extends Branded$1<string, infer S extends ServiceTypesLike> ? S : never;
 type ModelServiceFactoryMap<SMap extends Record<string, ServiceName>> = { [K in keyof SMap]: (() => InferServiceModel<ServiceBrand<SMap[K]>>) | null };
@@ -41,5 +43,5 @@ type ServiceNameLiterals = { [K in keyof TServices]: ExtractServiceName<TService
 type ServiceRequireFlags = { [K in keyof TServices as `requires${K & string}`]?: boolean };
 type RequireServices<T extends ServiceName> = UnionToIntersection<T extends Branded$1<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 };
+export { InferServiceKind, InferServiceModel, InferServiceUi, ModelServiceFactoryMap, ModelServices, RequireServices, ServiceBrand, ServiceDispatch, ServiceName, ServiceNameLiterals, ServiceRequireFlags, ServiceType, ServiceTypesLike, UiServiceFactoryMap, UiServices, getServiceKind, getServiceModelMethods, getServiceUiMethods, isMainService, isNodeService, isWasmService, service, serviceFnKey };
 //# sourceMappingURL=service_types.d.ts.map

package/dist/services/service_types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service_types.d.ts","names":[],"sources":["../../src/services/service_types.ts"],"mappings":";;;;;KAKY,gBAAA,6CAGG,WAAA,GAAc,WAAA;EAAA,SAElB,OAAA;IAAY,KAAA,EAAO,KAAA;IAAO,EAAA,EAAI,EAAA;IAAI,IAAA,EAAM,IAAA;EAAA;AAAA;AAAA,KAGvC,iBAAA,WAA4B,gBAAA,IACtC,CAAA,SAAU,gBAAA,mBAAmC,WAAA,IAAe,CAAA;AAAA,KAElD,cAAA,WAAyB,gBAAA,IACnC,CAAA,SAAU,gBAAA,mBAAmC,WAAA,IAAe,CAAA;AAAA,KAElD,gBAAA,WAA2B,gBAAA,IACrC,CAAA,SAAU,gBAAA,8BAA8C,CAAA,GAAI,WAAA;AAAA,KAElD,WAAA,WAAsB,gBAAA,GAAmB,gBAAA,IAAoB,SAAA,SAAgB,CAAA;AAAA,KAE7E,WAAA;AAAA,cAIG,OAAA,8BAIS,WAAA,oBAA6B,OAAA;IAAA,SACpC,IAAA,EAAM,CAAA;IAAA,SACN,IAAA,EAAM,CAAA;EAAA,MACb,SAAA,CAAQ,CAAA,EAAG,gBAAA,CAAiB,KAAA,EAAO,EAAA,EAAI,CAAA,IAAA,aAAA,GAPZ,EAAA,EAqBf,WAAA;AAAA,iBAMN,YAAA,CAAa,SAAA,UAAmB,MAAA;AAAA,KAIpC,YAAA,MACV,CAAA,SAAU,SAAA,yBAAgC,gBAAA,IAAoB,CAAA;AAAA,KAEpD,sBAAA,cAAoC,MAAA,SAAe,WAAA,mBACjD,IAAA,UAAc,iBAAA,CAAkB,YAAA,CAAa,IAAA,CAAK,CAAA;AAAA,KAGpD,mBAAA,cAAiC,MAAA,SAAe,WAAA,mBAC9C,IAAA,UAAc,cAAA,CAAe,YAAA,CAAa,IAAA,CAAK,CAAA;;UAI5C,eAAA;EACf,eAAA,IAAmB,WAAA;EACnB,iBAAA,CAAkB,SAAA,EAAW,WAAA;EAC7B,iBAAA,CAAkB,SAAA,EAAW,WAAA,EAAa,MAAA,aAAmB,IAAA;AAAA;AAAA,KAM1D,SAAA,UAAmB,QAAA;AAAA,KAEnB,kBAAA,MAAwB,CAAA,SAAU,SAAA,gCAAuC,CAAA;;KAGlE,aAAA,iBACE,SAAA,IAAa,kBAAA,CAAmB,SAAA,CAAU,CAAA,KAAM,iBAAA,CAC1D,YAAA,CAAa,SAAA,CAAU,CAAA;;KAKf,UAAA,iBACE,SAAA,IAAa,kBAAA,CAAmB,SAAA,CAAU,CAAA,KAAM,cAAA,CAC1D,YAAA,CAAa,SAAA,CAAU,CAAA;;KAKf,mBAAA,iBACE,SAAA,GAAY,kBAAA,CAAmB,SAAA,CAAU,CAAA;AApFvD;AAAA,KAwFY,mBAAA,iBACE,SAAA,eAAwB,CAAA;AAAA,KAG1B,eAAA,WAA0B,WAAA,IAAe,mBAAA,CACnD,CAAA,SAAU,SAAA,yCAAgD,gBAAA,IACtD,MAAA,CAAO,CAAA,EAAG,iBAAA,CAAkB,CAAA"}
+{"version":3,"file":"service_types.d.ts","names":[],"sources":["../../src/services/service_types.ts"],"mappings":";;;;;KAKY,gBAAA,6CAGG,WAAA,GAAc,WAAA;EAAA,SAElB,OAAA;IAAY,KAAA,EAAO,KAAA;IAAO,EAAA,EAAI,EAAA;IAAI,IAAA,EAAM,IAAA;EAAA;AAAA;AAAA,KAGvC,iBAAA,WAA4B,gBAAA,IACtC,CAAA,SAAU,gBAAA,mBAAmC,WAAA,IAAe,CAAA;AAAA,KAElD,cAAA,WAAyB,gBAAA,IACnC,CAAA,SAAU,gBAAA,mBAAmC,WAAA,IAAe,CAAA;AAAA,KAElD,gBAAA,WAA2B,gBAAA,IACrC,CAAA,SAAU,gBAAA,8BAA8C,CAAA,GAAI,WAAA;AAAA,KAElD,WAAA,WAAsB,gBAAA,GAAmB,gBAAA,IAAoB,SAAA,SAAgB,CAAA;AAAA,KAE7E,WAAA;AAAA,cAKV,OAAA,8BAcgB,WAAA,+CAEiB,KAAA,yCACA,EAAA,cAAc,OAAA;IAAA,SAEhC,IAAA,EAAM,CAAA;IAAA,SACN,IAAA,EAAM,CAAA;IAAA,SACN,YAAA,EAAc,EAAA;IAAA,SACd,SAAA,EAAW,EAAA;EAAA,MAClB,SAAA,CAAQ,CAAA,EAAG,gBAAA,CAAiB,KAAA,EAAO,EAAA,EAAI,CAAA,IAAA,aAAA,GAtBlC,EAAA,EAsCO,WAAA,cAAA,aAAA,GArCP,EAAA,EAwCO,WAAA,cAAA,aAAA,GAvCP,EAAA,EA0CO,WAAA,cAAA,cAAA,GAzCN,EAAA,EA4CO,WAAA,KAAc,WAAA,cAAA,sBAAA,GA3Cb,EAAA,EA8CO,WAAA,wBAAA,mBAAA,GA7CV,EAAA,EAgDO,WAAA;AAAA,iBAMZ,YAAA,CAAa,SAAA,UAAmB,MAAA;AAAA,KAIpC,YAAA,MACV,CAAA,SAAU,SAAA,yBAAgC,gBAAA,IAAoB,CAAA;AAAA,KAEpD,sBAAA,cAAoC,MAAA,SAAe,WAAA,mBACjD,IAAA,UAAc,iBAAA,CAAkB,YAAA,CAAa,IAAA,CAAK,CAAA;AAAA,KAGpD,mBAAA,cAAiC,MAAA,SAAe,WAAA,mBAC9C,IAAA,UAAc,cAAA,CAAe,YAAA,CAAa,IAAA,CAAK,CAAA;AAxF7D;AAAA,UA4FiB,eAAA;EACf,eAAA,IAAmB,WAAA;EACnB,iBAAA,CAAkB,SAAA,EAAW,WAAA;EAC7B,iBAAA,CAAkB,SAAA,EAAW,WAAA,EAAa,MAAA,aAAmB,IAAA;AAAA;AAAA,KAM1D,SAAA,UAAmB,QAAA;AAAA,KAEnB,kBAAA,MAAwB,CAAA,SAAU,SAAA,gCAAuC,CAAA;;KAGlE,aAAA,iBACE,SAAA,IAAa,kBAAA,CAAmB,SAAA,CAAU,CAAA,KAAM,iBAAA,CAC1D,YAAA,CAAa,SAAA,CAAU,CAAA;;KAKf,UAAA,iBACE,SAAA,IAAa,kBAAA,CAAmB,SAAA,CAAU,CAAA,KAAM,cAAA,CAC1D,YAAA,CAAa,SAAA,CAAU,CAAA;;KAKf,mBAAA,iBACE,SAAA,GAAY,kBAAA,CAAmB,SAAA,CAAU,CAAA;;KAI3C,mBAAA,iBACE,SAAA,eAAwB,CAAA;AAAA,KAG1B,eAAA,WAA0B,WAAA,IAAe,mBAAA,CACnD,CAAA,SAAU,SAAA,yCAAgD,gBAAA,IACtD,MAAA,CAAO,CAAA,EAAG,iBAAA,CAAkB,CAAA"}

package/dist/services/service_types.js

@@ -1,20 +1,39 @@
 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 { service, isNodeService, isWasmService, isMainService, getServiceKind, getServiceModelMethods, getServiceUiMethods } = (() => {
 	const typeMap = /* @__PURE__ */ new Map();
+	const modelMethodsMap = /* @__PURE__ */ new Map();
+	const uiMethodsMap = /* @__PURE__ */ new Map();
 	return {
 		service() {
 			return (options) => {
-				const { name, type } = options;
+				const { name, type, modelMethods, uiMethods } = 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);
+				modelMethodsMap.set(name, modelMethods);
+				uiMethodsMap.set(name, uiMethods);
 				return name;
 			};
 		},
 		isNodeService(id) {
 			return typeMap.get(id) === "node";
+		},
+		isWasmService(id) {
+			return typeMap.get(id) === "wasm";
+		},
+		isMainService(id) {
+			return typeMap.get(id) === "main";
+		},
+		getServiceKind(id) {
+			return typeMap.get(id);
+		},
+		getServiceModelMethods(id) {
+			return modelMethodsMap.get(id) ?? [];
+		},
+		getServiceUiMethods(id) {
+			return uiMethodsMap.get(id) ?? [];
 		}
 	};
 })();
@@ -22,6 +41,6 @@ function serviceFnKey(serviceId, method = "") {
 	return `service:${serviceId}:${method}`;
 }
 //#endregion
-export { isNodeService, service, serviceFnKey };
+export { getServiceKind, getServiceModelMethods, getServiceUiMethods, isMainService, isNodeService, isWasmService, service, serviceFnKey };
 
 //# sourceMappingURL=service_types.js.map

package/dist/services/service_types.js.map

@@ -1 +1 @@
-{"version":3,"file":"service_types.js","names":[],"sources":["../../src/services/service_types.ts"],"sourcesContent":["import { UnionToIntersection } from \"@milaboratories/helpers\";\nimport 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 TServices = 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 TServices as ExtractServiceName<TServices[K]>]: InferServiceModel<\n    ServiceBrand<TServices[K]>\n  >;\n};\n\n/** UI-side service interfaces keyed by service name literal. */\nexport type UiServices = {\n  [K in keyof TServices as ExtractServiceName<TServices[K]>]: InferServiceUi<\n    ServiceBrand<TServices[K]>\n  >;\n};\n\n/** Map from Services keys to their unbranded string name literals. */\nexport type ServiceNameLiterals = {\n  [K in keyof TServices]: ExtractServiceName<TServices[K]>;\n};\n\n/** Auto-derived requires* feature flags from Services keys. */\nexport type ServiceRequireFlags = {\n  [K in keyof TServices as `requires${K & string}`]?: boolean;\n};\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":";;AA0BA,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"}
+{"version":3,"file":"service_types.js","names":[],"sources":["../../src/services/service_types.ts"],"sourcesContent":["import { UnionToIntersection } from \"@milaboratories/helpers\";\nimport 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\" | \"main\";\n\nconst SERVICE_ID_PATTERN = /^[a-zA-Z][a-zA-Z0-9]*$/;\n\nexport const {\n  service,\n  isNodeService,\n  isWasmService,\n  isMainService,\n  getServiceKind,\n  getServiceModelMethods,\n  getServiceUiMethods,\n} = (() => {\n  const typeMap = new Map<string, ServiceType>();\n  const modelMethodsMap = new Map<string, readonly string[]>();\n  const uiMethodsMap = new Map<string, readonly string[]>();\n  return {\n    service<Model, Ui>() {\n      return <\n        K extends ServiceType,\n        N extends string,\n        MM extends readonly (keyof Model & string)[],\n        UM extends readonly (keyof Ui & string)[],\n      >(options: {\n        readonly type: K;\n        readonly name: N;\n        readonly modelMethods: MM;\n        readonly uiMethods: UM;\n      }): Branded<N, ServiceTypesLike<Model, Ui, K>> => {\n        const { name, type, modelMethods, uiMethods } = 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        modelMethodsMap.set(name, modelMethods);\n        uiMethodsMap.set(name, uiMethods);\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    isWasmService(id: ServiceName): boolean {\n      return typeMap.get(id) === \"wasm\";\n    },\n    isMainService(id: ServiceName): boolean {\n      return typeMap.get(id) === \"main\";\n    },\n    getServiceKind(id: ServiceName): ServiceType | undefined {\n      return typeMap.get(id);\n    },\n    getServiceModelMethods(id: ServiceName): readonly string[] {\n      return modelMethodsMap.get(id) ?? [];\n    },\n    getServiceUiMethods(id: ServiceName): readonly string[] {\n      return uiMethodsMap.get(id) ?? [];\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 TServices = 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 TServices as ExtractServiceName<TServices[K]>]: InferServiceModel<\n    ServiceBrand<TServices[K]>\n  >;\n};\n\n/** UI-side service interfaces keyed by service name literal. */\nexport type UiServices = {\n  [K in keyof TServices as ExtractServiceName<TServices[K]>]: InferServiceUi<\n    ServiceBrand<TServices[K]>\n  >;\n};\n\n/** Map from Services keys to their unbranded string name literals. */\nexport type ServiceNameLiterals = {\n  [K in keyof TServices]: ExtractServiceName<TServices[K]>;\n};\n\n/** Auto-derived requires* feature flags from Services keys. */\nexport type ServiceRequireFlags = {\n  [K in keyof TServices as `requires${K & string}`]?: boolean;\n};\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":";;AA0BA,MAAM,qBAAqB;AAE3B,MAAa,EACX,SACA,eACA,eACA,eACA,gBACA,wBACA,+BACS;CACT,MAAM,0BAAU,IAAI,KAA0B;CAC9C,MAAM,kCAAkB,IAAI,KAAgC;CAC5D,MAAM,+BAAe,IAAI,KAAgC;AACzD,QAAO;EACL,UAAqB;AACnB,WAKE,YAKgD;IAChD,MAAM,EAAE,MAAM,MAAM,cAAc,cAAc;AAChD,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,oBAAgB,IAAI,MAAM,aAAa;AACvC,iBAAa,IAAI,MAAM,UAAU;AACjC,WAAO;;;EAGX,cAAc,IAA0B;AACtC,UAAO,QAAQ,IAAI,GAAG,KAAK;;EAE7B,cAAc,IAA0B;AACtC,UAAO,QAAQ,IAAI,GAAG,KAAK;;EAE7B,cAAc,IAA0B;AACtC,UAAO,QAAQ,IAAI,GAAG,KAAK;;EAE7B,eAAe,IAA0C;AACvD,UAAO,QAAQ,IAAI,GAAG;;EAExB,uBAAuB,IAAoC;AACzD,UAAO,gBAAgB,IAAI,GAAG,IAAI,EAAE;;EAEtC,oBAAoB,IAAoC;AACtD,UAAO,aAAa,IAAI,GAAG,IAAI,EAAE;;EAEpC;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.34.1",
+  "version": "1.36.0",
   "description": "Platforma SDK Model",
   "files": [
     "./dist/**/*",
@@ -27,8 +27,8 @@
     "typescript": "~5.9.3",
     "vitest": "^4.1.3",
     "@milaboratories/build-configs": "2.0.0",
-    "@milaboratories/ts-builder": "1.3.2",
-    "@milaboratories/ts-configs": "1.2.3"
+    "@milaboratories/ts-configs": "1.2.3",
+    "@milaboratories/ts-builder": "1.3.2"
   },
   "scripts": {
     "build": "ts-builder build --target node",

package/src/dialog/index.ts

@@ -0,0 +1,33 @@
+/**
+ * File filter passed to the native save dialog. Matches Electron's
+ * `FileFilter` shape so desktop runtimes can forward it verbatim.
+ */
+export interface FileFilter {
+  name: string;
+  extensions: string[];
+}
+
+/**
+ * Options accepted by `Dialog.showSaveDialog`. The UI supplies only a
+ * default file name; the main-process handler decides the default
+ * directory (e.g. `~/Downloads`).
+ */
+export interface ShowSaveDialogOptions {
+  defaultFileName?: string;
+  filters?: FileFilter[];
+  title?: string;
+}
+
+/** Result of `Dialog.showSaveDialog`. */
+export interface ShowSaveDialogResult {
+  canceled: boolean;
+  path?: string;
+}
+
+/**
+ * UI-facing save-dialog service. Implemented by desktop runtimes that
+ * can open a native file picker; absent in web/preview environments.
+ */
+export interface DialogService {
+  showSaveDialog(options: ShowSaveDialogOptions): Promise<ShowSaveDialogResult>;
+}

package/src/drivers/pframe/data_types.ts

@@ -48,7 +48,7 @@ function isBitSet(bitVector: Uint8Array, offset: number): boolean {
   return (bitVector[chunkIndex] & mask) > 0;
 }
 
-function isValueNA(vector: PTableVector, row: number): boolean {
+export function isValueNA(vector: PTableVector, row: number): boolean {
   if (vector.isNA) return isBitSet(vector.isNA, row);
 
   // Check for legacy magic values to support old desktop versions
@@ -236,3 +236,32 @@ export type PTableShape = {
   /** Number of rows */
   rows: number;
 };
+
+/** Supported formats for PTable file download. */
+export type PTableDownloadFormat = "csv" | "tsv";
+
+/** Compression applied to the written file. */
+export type PTableDownloadCompression = "none" | "gzip";
+
+/** Options for downloading PTable data to a file. */
+export interface WritePTableToFsOptions {
+  path: string;
+  format: PTableDownloadFormat;
+  columnIndices: number[];
+  range?: TableRange;
+  chunkSize?: number;
+  includeHeader?: boolean;
+  bom?: boolean;
+  compression?: {
+    type: "gzip";
+    level?: number;
+  };
+  signal?: AbortSignal;
+}
+
+/** Result of a PTable file download. */
+export interface WritePTableToFsResult {
+  path: string;
+  rowsWritten: number;
+  bytesWritten: number;
+}

package/src/drivers/pframe/driver.ts

@@ -5,7 +5,13 @@ import type { PColumn } from "./spec/spec";
 import type { PColumnValues, DataInfo } from "./data_info";
 import type { PTableDef, PTableDefV2 } from "./table_calculate";
 import type { AddParameterToAllMethods } from "./type_util";
-import type { PTableShape, PTableVector, TableRange } from "./data_types";
+import type {
+  WritePTableToFsOptions,
+  WritePTableToFsResult,
+  PTableShape,
+  PTableVector,
+  TableRange,
+} from "./data_types";
 import type { FindColumnsRequest, FindColumnsResponse } from "./find_columns";
 import type { PObjectId } from "../../pool";
 import type { PColumnIdAndSpec, PColumnSpec } from "./spec/spec";
@@ -88,6 +94,15 @@ export interface PFrameDriver {
     columnIndices: number[],
     range?: TableRange,
   ): Promise<PTableVector[]>;
+
+  /**
+   * Stream the table to a file at the given path. Caller is responsible
+   * for producing the destination path (e.g. via the `Dialog` service).
+   */
+  writePTableToFs(
+    handle: PTableHandle,
+    options: WritePTableToFsOptions,
+  ): Promise<WritePTableToFsResult>;
 }
 
 //
@@ -102,4 +117,4 @@ type ExpectedPFrameDriverType = ExpectedPFrameDriverTypeF & ExpectedPFrameDriver
 type TypeEqualityGuard<A, B> = Exclude<A, B> | Exclude<B, A>;
 function assert<_T extends never>() {}
 
-assert<TypeEqualityGuard<PFrameDriver, ExpectedPFrameDriverType>>();
+assert<TypeEqualityGuard<Omit<PFrameDriver, "writePTableToFs">, ExpectedPFrameDriverType>>();

package/src/index.ts

@@ -4,6 +4,7 @@ export * from "./bmodel";
 export * from "./branding";
 export * from "./common_types";
 export * from "./driver_kit";
+export * from "./dialog";
 export * from "./drivers";
 export * from "./errors";
 export * from "./flags";

package/src/ref.test.ts

@@ -0,0 +1,37 @@
+import { describe, expect, it } from "vitest";
+import { createPlRef, isPlRef, isPrimaryRef } from "./ref";
+
+const sampleRef = createPlRef("block1", "output1", true);
+
+describe("isPrimaryRef", () => {
+  it("returns true for a valid PrimaryRef", () => {
+    expect(isPrimaryRef({ __isPrimaryRef: "v1", column: sampleRef })).toBe(true);
+  });
+
+  it("returns true for PrimaryRef with filter", () => {
+    const filter = createPlRef("block1", "filter1");
+    expect(isPrimaryRef({ __isPrimaryRef: "v1", column: sampleRef, filter })).toBe(true);
+  });
+
+  it("returns false for a PlRef", () => {
+    expect(isPrimaryRef(sampleRef)).toBe(false);
+  });
+
+  it("returns false for null", () => {
+    expect(isPrimaryRef(null)).toBe(false);
+  });
+
+  it("returns false for a plain object", () => {
+    expect(isPrimaryRef({ foo: "bar" })).toBe(false);
+  });
+});
+
+describe("isPlRef", () => {
+  it("returns false for a PrimaryRef", () => {
+    expect(isPlRef({ __isPrimaryRef: "v1", column: sampleRef })).toBe(false);
+  });
+
+  it("returns true for a PlRef", () => {
+    expect(isPlRef(sampleRef)).toBe(true);
+  });
+});

package/src/ref.ts

@@ -60,7 +60,11 @@ export type Option = {
  * @param name - The name of the reference.
  * @param requireEnrichments - Whether the reference requires enrichments.
  */
-export function createPlRef(blockId: string, name: string, requireEnrichments: boolean = false) {
+export function createPlRef(
+  blockId: string,
+  name: string,
+  requireEnrichments: boolean = false,
+): PlRef {
   if (requireEnrichments)
     return {
       __isRef: true,
@@ -97,6 +101,35 @@ export function withEnrichments(ref: PlRef, requireEnrichments: boolean = true):
   }
 }
 
+/** Primary dataset reference with an optional filter. */
+export type PrimaryRef = {
+  readonly __isPrimaryRef: "v1";
+  readonly column: PlRef;
+  readonly filter?: PlRef;
+};
+
+export function isPrimaryRef(value: unknown): value is PrimaryRef {
+  return (
+    typeof value === "object" &&
+    value !== null &&
+    (value as { __isPrimaryRef?: unknown }).__isPrimaryRef === "v1" &&
+    "column" in value
+  );
+}
+
+export function createPrimaryRef(column: PlRef, filter?: PlRef): PrimaryRef {
+  if (filter !== undefined) return { __isPrimaryRef: "v1", column, filter };
+  else return { __isPrimaryRef: "v1", column };
+}
+
+/** Block args accept either form — backward compatible. */
+export type DatasetInput = PlRef | PrimaryRef;
+
+/** Dataset option with optional filter choices. */
+export type DatasetOption = Option & {
+  readonly filters?: readonly Option[];
+};
+
 /** Compare two PlRefs and returns true if they are qual */
 export function plRefsEqual(ref1: PlRef, ref2: PlRef, ignoreEnrichments: boolean = false) {
   return (

package/src/services/{service_injector_factory.ts → node_service_handlers.ts}

@@ -1,15 +1,21 @@
 /**
- * UI service injector factory.
+ * Worker-side dispatch table for `node`-kind services.
  *
- * When adding a new node service, add its method wrappers here.
- * Everything else (SERVICE_METHOD_MAP, buildServiceInfo, UiServiceInjectorMap)
- * auto-derives from this factory + Services in service_declarations.ts.
+ * Each entry maps a method name to a closure that calls the real driver
+ * inside the worker process. Used by `callServiceMethod` in the worker
+ * (see `platforma-desktop-app/packages/worker/src/workerApi.ts`) to route
+ * incoming IPC calls to concrete driver methods.
+ *
+ * NOT used for:
+ * - `wasm` services — instantiated locally on each consumer (no IPC).
+ * - `main` services — dispatched in the Electron main process via its
+ *   own router, never reaches the worker.
  */
 
 import type { DriverKit } from "../driver_kit";
-import type { UiServiceInjectorMap } from "./service_injectors";
+import type { NodeServiceHandlerMap } from "./service_injectors";
 
-export function createUiServiceInjectors(driverKit: DriverKit): UiServiceInjectorMap {
+export function createNodeServiceHandlers(driverKit: DriverKit): NodeServiceHandlerMap {
   const { pFrameDriver } = driverKit;
   return {
     PFrame: {
@@ -22,6 +28,7 @@ export function createUiServiceInjectors(driverKit: DriverKit): UiServiceInjecto
       getShape: (handle) => pFrameDriver.getShape(handle),
       getSpec: (handle) => pFrameDriver.getSpec(handle),
       getData: (handle, columnIndices, range) => pFrameDriver.getData(handle, columnIndices, range),
+      writePTableToFs: (handle, options) => pFrameDriver.writePTableToFs(handle, options),
     },
   };
 }