@lssm/example.analytics-dashboard 0.0.0-canary-20251221165922 → 0.0.0-canary-20251221185840

package/dist/events.d.ts

@@ -1,145 +1,145 @@
-import * as _lssm_lib_contracts3 from "@lssm/lib.contracts";
-import * as _lssm_lib_schema131 from "@lssm/lib.schema";
+import * as _lssm_lib_contracts0 from "@lssm/lib.contracts";
+import * as _lssm_lib_schema0 from "@lssm/lib.schema";
 
 //#region src/events.d.ts
-declare const DashboardCreatedEvent: _lssm_lib_contracts3.EventSpec<_lssm_lib_schema131.SchemaModel<{
+declare const DashboardCreatedEvent: _lssm_lib_contracts0.EventSpec<_lssm_lib_schema0.SchemaModel<{
   dashboardId: {
-    type: _lssm_lib_schema131.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: false;
   };
   title: {
-    type: _lssm_lib_schema131.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: false;
   };
   orgId: {
-    type: _lssm_lib_schema131.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: false;
   };
   createdBy: {
-    type: _lssm_lib_schema131.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: false;
   };
   timestamp: {
-    type: _lssm_lib_schema131.FieldType<Date, string>;
+    type: _lssm_lib_schema0.FieldType<Date, string>;
     isOptional: false;
   };
 }>>;
-declare const WidgetAddedEvent: _lssm_lib_contracts3.EventSpec<_lssm_lib_schema131.SchemaModel<{
+declare const WidgetAddedEvent: _lssm_lib_contracts0.EventSpec<_lssm_lib_schema0.SchemaModel<{
   widgetId: {
-    type: _lssm_lib_schema131.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: false;
   };
   dashboardId: {
-    type: _lssm_lib_schema131.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: false;
   };
   widgetType: {
-    type: _lssm_lib_schema131.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: false;
   };
   orgId: {
-    type: _lssm_lib_schema131.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: false;
   };
   timestamp: {
-    type: _lssm_lib_schema131.FieldType<Date, string>;
+    type: _lssm_lib_schema0.FieldType<Date, string>;
     isOptional: false;
   };
 }>>;
-declare const QueryCreatedEvent: _lssm_lib_contracts3.EventSpec<_lssm_lib_schema131.SchemaModel<{
+declare const QueryCreatedEvent: _lssm_lib_contracts0.EventSpec<_lssm_lib_schema0.SchemaModel<{
   queryId: {
-    type: _lssm_lib_schema131.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: false;
   };
   name: {
-    type: _lssm_lib_schema131.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: false;
   };
   queryType: {
-    type: _lssm_lib_schema131.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: false;
   };
   orgId: {
-    type: _lssm_lib_schema131.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: false;
   };
   createdBy: {
-    type: _lssm_lib_schema131.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: false;
   };
   timestamp: {
-    type: _lssm_lib_schema131.FieldType<Date, string>;
+    type: _lssm_lib_schema0.FieldType<Date, string>;
     isOptional: false;
   };
 }>>;
 declare const AnalyticsDashboardEvents: {
-  DashboardCreatedEvent: _lssm_lib_contracts3.EventSpec<_lssm_lib_schema131.SchemaModel<{
+  DashboardCreatedEvent: _lssm_lib_contracts0.EventSpec<_lssm_lib_schema0.SchemaModel<{
     dashboardId: {
-      type: _lssm_lib_schema131.FieldType<string, string>;
+      type: _lssm_lib_schema0.FieldType<string, string>;
       isOptional: false;
     };
     title: {
-      type: _lssm_lib_schema131.FieldType<string, string>;
+      type: _lssm_lib_schema0.FieldType<string, string>;
       isOptional: false;
     };
     orgId: {
-      type: _lssm_lib_schema131.FieldType<string, string>;
+      type: _lssm_lib_schema0.FieldType<string, string>;
       isOptional: false;
     };
     createdBy: {
-      type: _lssm_lib_schema131.FieldType<string, string>;
+      type: _lssm_lib_schema0.FieldType<string, string>;
       isOptional: false;
     };
     timestamp: {
-      type: _lssm_lib_schema131.FieldType<Date, string>;
+      type: _lssm_lib_schema0.FieldType<Date, string>;
       isOptional: false;
     };
   }>>;
-  WidgetAddedEvent: _lssm_lib_contracts3.EventSpec<_lssm_lib_schema131.SchemaModel<{
+  WidgetAddedEvent: _lssm_lib_contracts0.EventSpec<_lssm_lib_schema0.SchemaModel<{
     widgetId: {
-      type: _lssm_lib_schema131.FieldType<string, string>;
+      type: _lssm_lib_schema0.FieldType<string, string>;
       isOptional: false;
     };
     dashboardId: {
-      type: _lssm_lib_schema131.FieldType<string, string>;
+      type: _lssm_lib_schema0.FieldType<string, string>;
       isOptional: false;
     };
     widgetType: {
-      type: _lssm_lib_schema131.FieldType<string, string>;
+      type: _lssm_lib_schema0.FieldType<string, string>;
       isOptional: false;
     };
     orgId: {
-      type: _lssm_lib_schema131.FieldType<string, string>;
+      type: _lssm_lib_schema0.FieldType<string, string>;
       isOptional: false;
     };
     timestamp: {
-      type: _lssm_lib_schema131.FieldType<Date, string>;
+      type: _lssm_lib_schema0.FieldType<Date, string>;
       isOptional: false;
     };
   }>>;
-  QueryCreatedEvent: _lssm_lib_contracts3.EventSpec<_lssm_lib_schema131.SchemaModel<{
+  QueryCreatedEvent: _lssm_lib_contracts0.EventSpec<_lssm_lib_schema0.SchemaModel<{
     queryId: {
-      type: _lssm_lib_schema131.FieldType<string, string>;
+      type: _lssm_lib_schema0.FieldType<string, string>;
       isOptional: false;
     };
     name: {
-      type: _lssm_lib_schema131.FieldType<string, string>;
+      type: _lssm_lib_schema0.FieldType<string, string>;
       isOptional: false;
     };
     queryType: {
-      type: _lssm_lib_schema131.FieldType<string, string>;
+      type: _lssm_lib_schema0.FieldType<string, string>;
       isOptional: false;
     };
     orgId: {
-      type: _lssm_lib_schema131.FieldType<string, string>;
+      type: _lssm_lib_schema0.FieldType<string, string>;
       isOptional: false;
     };
     createdBy: {
-      type: _lssm_lib_schema131.FieldType<string, string>;
+      type: _lssm_lib_schema0.FieldType<string, string>;
       isOptional: false;
     };
     timestamp: {
-      type: _lssm_lib_schema131.FieldType<Date, string>;
+      type: _lssm_lib_schema0.FieldType<Date, string>;
       isOptional: false;
     };
   }>>;

package/dist/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","names":[],"sources":["../src/events.ts"],"sourcesContent":[],"mappings":";;;;cAwCa,uBAAqB,oBAAA,CAAA,8BAAA;;UAKhC,mBAAA,CAAA;;EALW,CAAA;EAKX,KAAA,EAAA;;;;;;qBALgC;EAAA,CAAA;EAAA,SAAA,EAAA;IAOrB,IAAA,+BAKX,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;;;;;;;AAL2B,cAAhB,gBAAgB,EAAA,oBAAA,CAAA,SAAA,qBAAA,WAAA,CAAA;EAAA,QAAA,EAAA;IAOhB,IAAA,EAFX,mBAAA,CAAA,SAOA,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;;;;;;;uCAL4B,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EAAA,CAAA;EAOjB,KAAA,EAAA;IAIZ,IAAA,+BAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;cAXY,mBAAiB,oBAAA,CAAA,8BAAA;;UAK5B,mBAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;cAEW;;;YAIZ,mBAAA,CAAA"}
+{"version":3,"file":"events.d.ts","names":[],"sources":["../src/events.ts"],"sourcesContent":[],"mappings":";;;;cAwCa,uBAAqB,oBAAA,CAAA,4BAAA;;UAKhC,iBAAA,CAAA;;EALW,CAAA;EAKX,KAAA,EAAA;;;;;;gBALgC,KAAA;EAAA,CAAA;EAAA,SAAA,EAAA;IAOrB,IAAA,6BAKX,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;;;;;;;AAL2B,cAAhB,gBAAgB,EAAA,oBAAA,CAAA,SAAA,mBAAA,WAAA,CAAA;EAAA,QAAA,EAAA;IAOhB,IAAA,EAFX,iBAAA,CAAA,SAOA,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;;;;;;;qCAL4B,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EAAA,CAAA;EAOjB,KAAA,EAAA;IAIZ,IAAA,6BAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;cAXY,mBAAiB,oBAAA,CAAA,4BAAA;;UAK5B,iBAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;cAEW;;;YAIZ,iBAAA,CAAA"}

package/dist/libs/contracts/dist/data-views/data-views.js

@@ -1 +1,7 @@
-import "../registry-utils.js";
+import { init_registry_utils } from "../registry-utils.js";
+
+//#region ../../libs/contracts/dist/data-views/data-views.js
+init_registry_utils();
+
+//#endregion
+//# sourceMappingURL=data-views.js.map

package/dist/libs/contracts/dist/data-views/data-views.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-views.js","names":[],"sources":["../../../../../../../libs/contracts/dist/data-views/data-views.js"],"sourcesContent":["import { filterBy, getUniqueTags, groupBy, init_registry_utils } from \"../registry-utils.js\";\n\n//#region src/data-views/data-views.ts\ninit_registry_utils();\nfunction keyOf(spec) {\n\treturn `${spec.meta.name}.v${spec.meta.version}`;\n}\nvar DataViewRegistry = class {\n\titems = /* @__PURE__ */ new Map();\n\tregister(spec) {\n\t\tconst key = keyOf(spec);\n\t\tif (this.items.has(key)) throw new Error(`Duplicate data view ${key}`);\n\t\tthis.items.set(key, spec);\n\t\treturn this;\n\t}\n\tlist() {\n\t\treturn [...this.items.values()];\n\t}\n\tget(name, version) {\n\t\tif (version != null) return this.items.get(`${name}.v${version}`);\n\t\tlet candidate;\n\t\tlet max = -Infinity;\n\t\tfor (const spec of this.items.values()) {\n\t\t\tif (spec.meta.name !== name) continue;\n\t\t\tif (spec.meta.version > max) {\n\t\t\t\tmax = spec.meta.version;\n\t\t\t\tcandidate = spec;\n\t\t\t}\n\t\t}\n\t\treturn candidate;\n\t}\n\t/** Filter data views by criteria. */\n\tfilter(criteria) {\n\t\treturn filterBy(this.list(), criteria);\n\t}\n\t/** List data views with specific tag. */\n\tlistByTag(tag) {\n\t\treturn this.list().filter((d) => d.meta.tags?.includes(tag));\n\t}\n\t/** List data views by owner. */\n\tlistByOwner(owner) {\n\t\treturn this.list().filter((d) => d.meta.owners?.includes(owner));\n\t}\n\t/** Group data views by key function. */\n\tgroupBy(keyFn) {\n\t\treturn groupBy(this.list(), keyFn);\n\t}\n\t/** Get unique tags from all data views. */\n\tgetUniqueTags() {\n\t\treturn getUniqueTags(this.list());\n\t}\n};\nfunction dataViewKey(spec) {\n\treturn keyOf(spec);\n}\n\n//#endregion\nexport { DataViewRegistry, dataViewKey };"],"mappings":";;;AAGA,qBAAqB"}

package/dist/libs/contracts/dist/features.js

@@ -1 +1,7 @@
-import "./registry-utils.js";
+import { init_registry_utils } from "./registry-utils.js";
+
+//#region ../../libs/contracts/dist/features.js
+init_registry_utils();
+
+//#endregion
+//# sourceMappingURL=features.js.map

package/dist/libs/contracts/dist/features.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.js","names":[],"sources":["../../../../../../libs/contracts/dist/features.js"],"sourcesContent":["import { filterBy, getUniqueTags, groupBy, init_registry_utils } from \"./registry-utils.js\";\n\n//#region src/features.ts\ninit_registry_utils();\nfunction keyOf(f) {\n\treturn f.meta.key;\n}\n/** In-memory registry for FeatureModuleSpec. */\nvar FeatureRegistry = class {\n\titems = /* @__PURE__ */ new Map();\n\t/** Register a feature module. Throws when the key already exists. */\n\tregister(f) {\n\t\tconst key = keyOf(f);\n\t\tif (this.items.has(key)) throw new Error(`Duplicate feature ${key}`);\n\t\tthis.items.set(key, f);\n\t\treturn this;\n\t}\n\t/** List all registered feature modules. */\n\tlist() {\n\t\treturn [...this.items.values()];\n\t}\n\t/** Get a feature by its key (slug). */\n\tget(key) {\n\t\treturn this.items.get(key);\n\t}\n\t/** Filter features by criteria. */\n\tfilter(criteria) {\n\t\treturn filterBy(this.list(), criteria);\n\t}\n\t/** List features with specific tag. */\n\tlistByTag(tag) {\n\t\treturn this.list().filter((f) => f.meta.tags?.includes(tag));\n\t}\n\t/** List features by owner. */\n\tlistByOwner(owner) {\n\t\treturn this.list().filter((f) => f.meta.owners?.includes(owner));\n\t}\n\t/** Group features by key function. */\n\tgroupBy(keyFn) {\n\t\treturn groupBy(this.list(), keyFn);\n\t}\n\t/** Get unique tags from all features. */\n\tgetUniqueTags() {\n\t\treturn getUniqueTags(this.list());\n\t}\n};\n/** Validate and register a feature against optional registries/descriptors. */\nfunction installFeature(feature, deps) {\n\tif (deps.ops && feature.operations) {\n\t\tfor (const o of feature.operations) if (!deps.ops.getSpec(o.name, o.version)) throw new Error(`installFeature: operation not found ${o.name}.v${o.version}`);\n\t}\n\tif (deps.presentations && feature.presentations) {\n\t\tfor (const p of feature.presentations) if (!deps.presentations.get(p.name, p.version)) throw new Error(`installFeature: presentation not found ${p.name}.v${p.version}`);\n\t}\n\tif (feature.presentationsTargets && deps.descriptorsV2) for (const req of feature.presentationsTargets) {\n\t\tconst d = deps.descriptorsV2.find((x) => x.meta.name === req.name && x.meta.version === req.version);\n\t\tif (!d) throw new Error(`installFeature: V2 descriptor not found ${req.name}.v${req.version}`);\n\t\tfor (const t of req.targets) if (!d.targets.includes(t)) throw new Error(`installFeature: descriptor ${req.name}.v${req.version} missing target ${t}`);\n\t}\n\tif (feature.opToPresentation && feature.opToPresentation.length > 0) for (const link of feature.opToPresentation) {\n\t\tif (deps.ops) {\n\t\t\tif (!deps.ops.getSpec(link.op.name, link.op.version)) throw new Error(`installFeature: linked op not found ${link.op.name}.v${link.op.version}`);\n\t\t}\n\t\tif (deps.presentations) {\n\t\t\tif (!deps.presentations.get(link.pres.name, link.pres.version)) throw new Error(`installFeature: linked presentation not found ${link.pres.name}.v${link.pres.version}`);\n\t\t}\n\t}\n\tif (deps.capabilities && feature.capabilities?.provides) {\n\t\tfor (const cap of feature.capabilities.provides) if (!deps.capabilities.get(cap.key, cap.version)) throw new Error(`installFeature: capability not registered ${cap.key}.v${cap.version}`);\n\t}\n\tif (feature.capabilities?.requires?.length) {\n\t\tif (!deps.capabilities) throw new Error(`installFeature: capability registry required to validate capability requirements for ${feature.meta.key}`);\n\t\tconst provided = feature.capabilities.provides ?? [];\n\t\tfor (const req of feature.capabilities.requires) if (!deps.capabilities.satisfies(req, provided)) throw new Error(`installFeature: capability requirement not satisfied ${req.key}${req.version ? `.v${req.version}` : \"\"}`);\n\t}\n\tdeps.features.register(feature);\n\treturn deps.features;\n}\n/** Ensure declared target requirements exist on the provided descriptors. */\nfunction validateFeatureTargetsV2(feature, descriptors) {\n\tif (!feature.presentationsTargets || feature.presentationsTargets.length === 0) return true;\n\tfor (const req of feature.presentationsTargets) {\n\t\tconst d = descriptors.find((x) => x.meta.name === req.name && x.meta.version === req.version);\n\t\tif (!d) throw new Error(`V2 descriptor not found ${req.name}.v${req.version}`);\n\t\tfor (const t of req.targets) if (!d.targets.includes(t)) throw new Error(`Descriptor ${req.name}.v${req.version} missing target ${t}`);\n\t}\n\treturn true;\n}\n\n//#endregion\nexport { FeatureRegistry, installFeature, validateFeatureTargetsV2 };"],"mappings":";;;AAGA,qBAAqB"}

package/dist/libs/contracts/dist/operations/registry.js

@@ -1,2 +1,8 @@
 import "../events.js";
-import "../registry-utils.js";
+import { init_registry_utils } from "../registry-utils.js";
+
+//#region ../../libs/contracts/dist/operations/registry.js
+init_registry_utils();
+
+//#endregion
+//# sourceMappingURL=registry.js.map

package/dist/libs/contracts/dist/operations/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","names":[],"sources":["../../../../../../../libs/contracts/dist/operations/registry.js"],"sourcesContent":["import { eventKey } from \"../events.js\";\nimport { GroupingStrategies, filterBy, getUniqueOwners, getUniqueTags, groupBy, init_registry_utils } from \"../registry-utils.js\";\nimport { isEmitDeclRef } from \"./operation.js\";\n\n//#region src/operations/registry.ts\ninit_registry_utils();\nfunction opKey(name, version) {\n\treturn `${name}.v${version}`;\n}\n/**\n* In-memory registry for ContractSpecs and their bound handlers.\n* Provides validation, policy enforcement, and guarded event emission at execute time.\n*/\nvar OperationSpecRegistry = class {\n\tspecs = /* @__PURE__ */ new Map();\n\thandlers = /* @__PURE__ */ new Map();\n\t/**\n\t* Registers a OperationSpec definition.\n\t*\n\t* @param spec - The contract specification to register.\n\t* @returns The registry instance for chaining.\n\t* @throws If a spec with the same name and version is already registered.\n\t*/\n\tregister(spec) {\n\t\tconst key = opKey(spec.meta.name, spec.meta.version);\n\t\tif (this.specs.has(key)) throw new Error(`Duplicate spec ${key}`);\n\t\tthis.specs.set(key, spec);\n\t\treturn this;\n\t}\n\t/**\n\t* Binds a runtime handler implementation to a previously registered spec.\n\t*\n\t* @param spec - The spec to bind to.\n\t* @param handler - The async function implementing the business logic.\n\t* @returns The registry instance for chaining.\n\t* @throws If the spec is not found or a handler is already bound.\n\t*/\n\tbind(spec, handler) {\n\t\tconst key = opKey(spec.meta.name, spec.meta.version);\n\t\tif (!this.specs.has(key)) throw new Error(`Cannot bind; spec not found: ${key}`);\n\t\tif (this.handlers.has(key)) throw new Error(`Handler already bound for ${key}`);\n\t\tthis.handlers.set(key, handler);\n\t\treturn this;\n\t}\n\t/**\n\t* Retrieves a registered spec by name and version.\n\t* If version is omitted, returns the highest version found.\n\t*\n\t* @param name - Operation name.\n\t* @param version - (Optional) Specific version.\n\t*/\n\tgetSpec(name, version) {\n\t\tif (version != null) return this.specs.get(opKey(name, version));\n\t\tlet found;\n\t\tlet maxV = -Infinity;\n\t\tfor (const [k, s] of this.specs.entries()) {\n\t\t\tif (!k.startsWith(`${name}.v`)) continue;\n\t\t\tif (s.meta.version > maxV) {\n\t\t\t\tmaxV = s.meta.version;\n\t\t\t\tfound = s;\n\t\t\t}\n\t\t}\n\t\treturn found;\n\t}\n\t/**\n\t* Retrieves the bound handler for a spec.\n\t*/\n\tgetHandler(name, version) {\n\t\tconst spec = this.getSpec(name, version);\n\t\tif (!spec) return void 0;\n\t\treturn this.handlers.get(opKey(spec.meta.name, spec.meta.version));\n\t}\n\t/** Iterate all registered specs. */\n\tlistSpecs() {\n\t\treturn [...this.specs.values()];\n\t}\n\t/** Iterate all bound operations (spec+handler). */\n\tlistBound() {\n\t\tconst out = [];\n\t\tfor (const [k, spec] of this.specs.entries()) {\n\t\t\tconst h = this.handlers.get(k);\n\t\t\tif (h) out.push({\n\t\t\t\tspec,\n\t\t\t\thandler: h\n\t\t\t});\n\t\t}\n\t\treturn out;\n\t}\n\t/**\n\t* Filter specs by criteria.\n\t*/\n\tfilter(criteria) {\n\t\treturn filterBy(this.listSpecs(), criteria);\n\t}\n\t/**\n\t* List specs with specific tag.\n\t*/\n\tlistByTag(tag) {\n\t\treturn this.listSpecs().filter((s) => s.meta.tags?.includes(tag));\n\t}\n\t/**\n\t* List specs by owner.\n\t*/\n\tlistByOwner(owner) {\n\t\treturn this.listSpecs().filter((s) => s.meta.owners?.includes(owner));\n\t}\n\t/**\n\t* Group specs by key function.\n\t*/\n\tgroupBy(keyFn) {\n\t\treturn groupBy(this.listSpecs(), keyFn);\n\t}\n\t/**\n\t* Group by domain (first segment of name).\n\t*/\n\tgroupByDomain() {\n\t\treturn this.groupBy(GroupingStrategies.byDomain);\n\t}\n\t/**\n\t* Group by tag.\n\t*/\n\tgroupByTag() {\n\t\treturn this.groupBy(GroupingStrategies.byTag);\n\t}\n\t/**\n\t* Get unique tags from all specs.\n\t*/\n\tgetUniqueTags() {\n\t\treturn getUniqueTags(this.listSpecs());\n\t}\n\t/**\n\t* Get unique owners from all specs.\n\t*/\n\tgetUniqueOwners() {\n\t\treturn getUniqueOwners(this.listSpecs());\n\t}\n\t/**\n\t* Execute an operation by name/version with full runtime protections:\n\t* 1. Validates input against Zod schema.\n\t* 2. Enforces policy (Auth, RBAC, Rate Limits) via PDP.\n\t* 3. Guards event emission to ensure only declared events are sent.\n\t* 4. Validates output against Zod schema (if applicable).\n\t* 5. Tracks telemetry (success/failure).\n\t*\n\t* @param name - Operation name.\n\t* @param version - Operation version (optional, defaults to latest).\n\t* @param rawInput - The raw input payload (e.g. from JSON body).\n\t* @param ctx - The runtime context (actor, tenant, etc.).\n\t*/\n\tasync execute(name, version, rawInput, ctx) {\n\t\tconst baseSpec = this.getSpec(name, version);\n\t\tif (!baseSpec) throw new Error(`Spec not found for ${name}${version ? `.v${version}` : \"\"}`);\n\t\tconst spec = await ctx.specVariantResolver?.resolve({\n\t\t\tname: baseSpec.meta.name,\n\t\t\tversion: baseSpec.meta.version,\n\t\t\tkind: baseSpec.meta.kind\n\t\t}, ctx) ?? baseSpec;\n\t\tlet key = opKey(spec.meta.name, spec.meta.version);\n\t\tlet handler = this.handlers.get(key);\n\t\tif (!handler) {\n\t\t\tconst fallbackKey = opKey(baseSpec.meta.name, baseSpec.meta.version);\n\t\t\thandler = this.handlers.get(fallbackKey);\n\t\t\tkey = fallbackKey;\n\t\t}\n\t\tif (!handler) throw new Error(`No handler bound for ${key}`);\n\t\tconst parsedInput = spec.io.input?.getZod().parse(rawInput);\n\t\tif (ctx.decide) {\n\t\t\tconst [service, command] = spec.meta.name.split(\".\");\n\t\t\tif (!service || !command) throw new Error(`Invalid spec name: ${spec.meta.name}`);\n\t\t\tconst decision = await ctx.decide({\n\t\t\t\tservice,\n\t\t\t\tcommand,\n\t\t\t\tversion: spec.meta.version,\n\t\t\t\tactor: ctx.actor ?? \"anonymous\",\n\t\t\t\tchannel: ctx.channel,\n\t\t\t\troles: ctx.roles,\n\t\t\t\torganizationId: ctx.organizationId,\n\t\t\t\tuserId: ctx.userId,\n\t\t\t\tflags: []\n\t\t\t});\n\t\t\tif (decision.effect === \"deny\") throw new Error(`PolicyDenied: ${spec.meta.name}.v${spec.meta.version}`);\n\t\t\tif (decision.rateLimit && ctx.rateLimit) {\n\t\t\t\tconst key$1 = decision.rateLimit.key ?? \"default\";\n\t\t\t\tconst rpm = decision.rateLimit.rpm ?? 60;\n\t\t\t\tawait ctx.rateLimit(key$1, 1, rpm);\n\t\t\t}\n\t\t}\n\t\tconst allowedEvents = /* @__PURE__ */ new Map();\n\t\tif (spec.sideEffects?.emits) for (const e of spec.sideEffects.emits) if (isEmitDeclRef(e)) allowedEvents.set(`${e.ref.name}.v${e.ref.version}`, e.ref.payload);\n\t\telse allowedEvents.set(`${e.name}.v${e.version}`, e.payload);\n\t\tconst emitGuard = async (eventName, eventVersion, payload) => {\n\t\t\tconst key2 = eventKey(eventName, eventVersion);\n\t\t\tconst schema = allowedEvents.get(key2);\n\t\t\tif (!schema) throw new Error(`UndeclaredEvent: ${key2} not allowed by ${opKey(spec.meta.name, spec.meta.version)}`);\n\t\t\tconst parsed = schema.getZod().parse(payload);\n\t\t\tawait ctx.eventPublisher?.({\n\t\t\t\tname: eventName,\n\t\t\t\tversion: eventVersion,\n\t\t\t\tpayload: parsed,\n\t\t\t\ttraceId: ctx.traceId\n\t\t\t});\n\t\t};\n\t\tif (ctx.appConfig) {\n\t\t\tif (!ctx.branding) ctx.branding = ctx.appConfig.branding;\n\t\t\tif (!ctx.translation) ctx.translation = { config: ctx.appConfig.translation };\n\t\t\telse if (!ctx.translation.config) ctx.translation = {\n\t\t\t\t...ctx.translation,\n\t\t\t\tconfig: ctx.appConfig.translation\n\t\t\t};\n\t\t}\n\t\tconst telemetryContext = ctx.telemetry;\n\t\tconst trackTelemetry = async (trigger, details) => {\n\t\t\tif (!telemetryContext || !trigger?.event) return;\n\t\t\ttry {\n\t\t\t\tconst props = trigger.properties?.(details) ?? {};\n\t\t\t\tawait telemetryContext.track(trigger.event.name, trigger.event.version ?? 1, props, {\n\t\t\t\t\ttenantId: ctx.organizationId ?? void 0,\n\t\t\t\t\torganizationId: ctx.organizationId,\n\t\t\t\t\tuserId: ctx.userId,\n\t\t\t\t\tactor: ctx.actor,\n\t\t\t\t\tchannel: ctx.channel,\n\t\t\t\t\tmetadata: ctx.traceId ? { traceId: ctx.traceId } : void 0\n\t\t\t\t});\n\t\t\t} catch (_error) {}\n\t\t};\n\t\tlet result;\n\t\ttry {\n\t\t\tresult = await handler(parsedInput, {\n\t\t\t\t...ctx,\n\t\t\t\t__emitGuard__: emitGuard\n\t\t\t});\n\t\t} catch (error) {\n\t\t\tif (spec.telemetry?.failure) await trackTelemetry(spec.telemetry.failure, {\n\t\t\t\tinput: parsedInput ?? rawInput,\n\t\t\t\terror\n\t\t\t});\n\t\t\tthrow error;\n\t\t}\n\t\tif (spec.telemetry?.success) await trackTelemetry(spec.telemetry.success, {\n\t\t\tinput: parsedInput ?? rawInput,\n\t\t\toutput: result\n\t\t});\n\t\tconst outputModel = spec.io.output;\n\t\tif (outputModel?.getZod) return outputModel.getZod().parse(result);\n\t\treturn result;\n\t}\n};\n\n//#endregion\nexport { OperationSpecRegistry, opKey };"],"mappings":";;;;AAKA,qBAAqB"}

package/dist/libs/contracts/dist/presentations/presentations.js

@@ -1,2 +1,8 @@
-import "../registry-utils.js";
+import { init_registry_utils } from "../registry-utils.js";
 import z from "zod";
+
+//#region ../../libs/contracts/dist/presentations/presentations.js
+init_registry_utils();
+
+//#endregion
+//# sourceMappingURL=presentations.js.map

package/dist/libs/contracts/dist/presentations/presentations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentations.js","names":[],"sources":["../../../../../../../libs/contracts/dist/presentations/presentations.js"],"sourcesContent":["import { filterBy, getUniqueTags, groupBy, init_registry_utils } from \"../registry-utils.js\";\nimport z from \"zod\";\n\n//#region src/presentations/presentations.ts\ninit_registry_utils();\nfunction keyOf(p) {\n\treturn `${p.meta.name}.v${p.meta.version}`;\n}\n/** In-memory registry for V1 PresentationSpec. */\nvar PresentationRegistry = class {\n\titems = /* @__PURE__ */ new Map();\n\tconstructor(items) {\n\t\tif (items) items.forEach((p) => this.register(p));\n\t}\n\tregister(p) {\n\t\tconst key = keyOf(p);\n\t\tif (this.items.has(key)) throw new Error(`Duplicate presentation ${key}`);\n\t\tthis.items.set(key, p);\n\t\treturn this;\n\t}\n\tlist() {\n\t\treturn [...this.items.values()];\n\t}\n\tget(name, version) {\n\t\tif (version != null) return this.items.get(`${name}.v${version}`);\n\t\tlet candidate;\n\t\tlet max = -Infinity;\n\t\tfor (const [k, p] of this.items.entries()) {\n\t\t\tif (!k.startsWith(`${name}.v`)) continue;\n\t\t\tif (p.meta.version > max) {\n\t\t\t\tmax = p.meta.version;\n\t\t\t\tcandidate = p;\n\t\t\t}\n\t\t}\n\t\treturn candidate;\n\t}\n\t/** Filter presentations by criteria. */\n\tfilter(criteria) {\n\t\treturn filterBy(this.list(), criteria);\n\t}\n\t/** List presentations with specific tag. */\n\tlistByTag(tag) {\n\t\treturn this.list().filter((p) => p.meta.tags?.includes(tag));\n\t}\n\t/** List presentations by owner. */\n\tlistByOwner(owner) {\n\t\treturn this.list().filter((p) => p.meta.owners?.includes(owner));\n\t}\n\t/** Group presentations by key function. */\n\tgroupBy(keyFn) {\n\t\treturn groupBy(this.list(), keyFn);\n\t}\n\t/** Get unique tags from all presentations. */\n\tgetUniqueTags() {\n\t\treturn getUniqueTags(this.list());\n\t}\n};\nfunction jsonSchemaForPresentation(p) {\n\tconst base = {\n\t\tmeta: {\n\t\t\tname: p.meta.name,\n\t\t\tversion: p.meta.version,\n\t\t\tstability: p.meta.stability ?? \"stable\",\n\t\t\ttags: p.meta.tags ?? [],\n\t\t\tdescription: p.meta.description ?? \"\"\n\t\t},\n\t\tkind: p.content.kind\n\t};\n\tif (p.content.kind === \"web_component\") return {\n\t\t...base,\n\t\tframework: p.content.framework,\n\t\tcomponentKey: p.content.componentKey,\n\t\tprops: z.toJSONSchema(p.content.props.getZod())\n\t};\n\tif (p.content.kind === \"markdown\") return {\n\t\t...base,\n\t\tcontent: p.content.content,\n\t\tresourceUri: p.content.resourceUri\n\t};\n\treturn {\n\t\t...base,\n\t\tmimeType: p.content.mimeType,\n\t\tmodel: z.toJSONSchema(p.content.model.getZod())\n\t};\n}\n\n//#endregion\nexport { PresentationRegistry, jsonSchemaForPresentation };"],"mappings":";;;;AAIA,qBAAqB"}

package/dist/libs/contracts/dist/workflow/spec.js

@@ -1 +1,7 @@
-import "../registry-utils.js";
+import { init_registry_utils } from "../registry-utils.js";
+
+//#region ../../libs/contracts/dist/workflow/spec.js
+init_registry_utils();
+
+//#endregion
+//# sourceMappingURL=spec.js.map

package/dist/libs/contracts/dist/workflow/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","names":[],"sources":["../../../../../../../libs/contracts/dist/workflow/spec.js"],"sourcesContent":["import { filterBy, getUniqueTags, groupBy, init_registry_utils } from \"../registry-utils.js\";\n\n//#region src/workflow/spec.ts\ninit_registry_utils();\nfunction workflowKey(meta) {\n\treturn `${meta.name}.v${meta.version}`;\n}\nvar WorkflowRegistry = class {\n\titems = /* @__PURE__ */ new Map();\n\tregister(spec) {\n\t\tconst key = workflowKey(spec.meta);\n\t\tif (this.items.has(key)) throw new Error(`Duplicate workflow ${key}`);\n\t\tthis.items.set(key, spec);\n\t\treturn this;\n\t}\n\tlist() {\n\t\treturn [...this.items.values()];\n\t}\n\tget(name, version) {\n\t\tif (version != null) return this.items.get(`${name}.v${version}`);\n\t\tlet candidate;\n\t\tlet max = -Infinity;\n\t\tfor (const spec of this.items.values()) {\n\t\t\tif (spec.meta.name !== name) continue;\n\t\t\tif (spec.meta.version > max) {\n\t\t\t\tmax = spec.meta.version;\n\t\t\t\tcandidate = spec;\n\t\t\t}\n\t\t}\n\t\treturn candidate;\n\t}\n\t/** Filter workflows by criteria. */\n\tfilter(criteria) {\n\t\treturn filterBy(this.list(), criteria);\n\t}\n\t/** List workflows with specific tag. */\n\tlistByTag(tag) {\n\t\treturn this.list().filter((w) => w.meta.tags?.includes(tag));\n\t}\n\t/** List workflows by owner. */\n\tlistByOwner(owner) {\n\t\treturn this.list().filter((w) => w.meta.owners?.includes(owner));\n\t}\n\t/** Group workflows by key function. */\n\tgroupBy(keyFn) {\n\t\treturn groupBy(this.list(), keyFn);\n\t}\n\t/** Get unique tags from all workflows. */\n\tgetUniqueTags() {\n\t\treturn getUniqueTags(this.list());\n\t}\n};\n\n//#endregion\nexport { WorkflowRegistry };"],"mappings":";;;AAGA,qBAAqB"}

package/dist/query/query.enum.d.ts

@@ -1,10 +1,10 @@
-import * as _lssm_lib_schema247 from "@lssm/lib.schema";
+import * as _lssm_lib_schema323 from "@lssm/lib.schema";
 
 //#region src/query/query.enum.d.ts
 /**
  * Query type enum.
  */
-declare const QueryTypeEnum: _lssm_lib_schema247.EnumType<[string, string, string, string]>;
+declare const QueryTypeEnum: _lssm_lib_schema323.EnumType<[string, string, string, string]>;
 //#endregion
 export { QueryTypeEnum };
 //# sourceMappingURL=query.enum.d.ts.map

package/dist/query/query.operation.d.ts

@@ -1,120 +1,120 @@
 import * as _lssm_lib_contracts9 from "@lssm/lib.contracts";
-import * as _lssm_lib_schema248 from "@lssm/lib.schema";
+import * as _lssm_lib_schema247 from "@lssm/lib.schema";
 
 //#region src/query/query.operation.d.ts
 /**
  * Create a data query.
  */
-declare const CreateQueryContract: _lssm_lib_contracts9.OperationSpec<_lssm_lib_schema248.SchemaModel<{
+declare const CreateQueryContract: _lssm_lib_contracts9.OperationSpec<_lssm_lib_schema247.SchemaModel<{
   name: {
-    type: _lssm_lib_schema248.FieldType<string, string>;
+    type: _lssm_lib_schema247.FieldType<string, string>;
     isOptional: false;
   };
   description: {
-    type: _lssm_lib_schema248.FieldType<string, string>;
+    type: _lssm_lib_schema247.FieldType<string, string>;
     isOptional: true;
   };
   type: {
-    type: _lssm_lib_schema248.EnumType<[string, string, string, string]>;
+    type: _lssm_lib_schema247.EnumType<[string, string, string, string]>;
     isOptional: false;
   };
   definition: {
-    type: _lssm_lib_schema248.FieldType<unknown, unknown>;
+    type: _lssm_lib_schema247.FieldType<unknown, unknown>;
     isOptional: false;
   };
   sql: {
-    type: _lssm_lib_schema248.FieldType<string, string>;
+    type: _lssm_lib_schema247.FieldType<string, string>;
     isOptional: true;
   };
   metricIds: {
-    type: _lssm_lib_schema248.FieldType<string, string>;
+    type: _lssm_lib_schema247.FieldType<string, string>;
     isArray: true;
     isOptional: true;
   };
   cacheTtlSeconds: {
-    type: _lssm_lib_schema248.FieldType<number, number>;
+    type: _lssm_lib_schema247.FieldType<number, number>;
     isOptional: true;
   };
   isShared: {
-    type: _lssm_lib_schema248.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema247.FieldType<boolean, boolean>;
     isOptional: true;
   };
-}>, _lssm_lib_schema248.SchemaModel<{
+}>, _lssm_lib_schema247.SchemaModel<{
   id: {
-    type: _lssm_lib_schema248.FieldType<string, string>;
+    type: _lssm_lib_schema247.FieldType<string, string>;
     isOptional: false;
   };
   name: {
-    type: _lssm_lib_schema248.FieldType<string, string>;
+    type: _lssm_lib_schema247.FieldType<string, string>;
     isOptional: false;
   };
   description: {
-    type: _lssm_lib_schema248.FieldType<string, string>;
+    type: _lssm_lib_schema247.FieldType<string, string>;
     isOptional: true;
   };
   type: {
-    type: _lssm_lib_schema248.EnumType<[string, string, string, string]>;
+    type: _lssm_lib_schema247.EnumType<[string, string, string, string]>;
     isOptional: false;
   };
   definition: {
-    type: _lssm_lib_schema248.FieldType<unknown, unknown>;
+    type: _lssm_lib_schema247.FieldType<unknown, unknown>;
     isOptional: false;
   };
   sql: {
-    type: _lssm_lib_schema248.FieldType<string, string>;
+    type: _lssm_lib_schema247.FieldType<string, string>;
     isOptional: true;
   };
   cacheTtlSeconds: {
-    type: _lssm_lib_schema248.FieldType<number, number>;
+    type: _lssm_lib_schema247.FieldType<number, number>;
     isOptional: false;
   };
   isShared: {
-    type: _lssm_lib_schema248.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema247.FieldType<boolean, boolean>;
     isOptional: false;
   };
   createdAt: {
-    type: _lssm_lib_schema248.FieldType<Date, string>;
+    type: _lssm_lib_schema247.FieldType<Date, string>;
     isOptional: false;
   };
 }>, {
   name: string;
   version: number;
   when: string;
-  payload: _lssm_lib_schema248.SchemaModel<{
+  payload: _lssm_lib_schema247.SchemaModel<{
     id: {
-      type: _lssm_lib_schema248.FieldType<string, string>;
+      type: _lssm_lib_schema247.FieldType<string, string>;
       isOptional: false;
     };
     name: {
-      type: _lssm_lib_schema248.FieldType<string, string>;
+      type: _lssm_lib_schema247.FieldType<string, string>;
       isOptional: false;
     };
     description: {
-      type: _lssm_lib_schema248.FieldType<string, string>;
+      type: _lssm_lib_schema247.FieldType<string, string>;
       isOptional: true;
     };
     type: {
-      type: _lssm_lib_schema248.EnumType<[string, string, string, string]>;
+      type: _lssm_lib_schema247.EnumType<[string, string, string, string]>;
       isOptional: false;
     };
     definition: {
-      type: _lssm_lib_schema248.FieldType<unknown, unknown>;
+      type: _lssm_lib_schema247.FieldType<unknown, unknown>;
       isOptional: false;
     };
     sql: {
-      type: _lssm_lib_schema248.FieldType<string, string>;
+      type: _lssm_lib_schema247.FieldType<string, string>;
       isOptional: true;
     };
     cacheTtlSeconds: {
-      type: _lssm_lib_schema248.FieldType<number, number>;
+      type: _lssm_lib_schema247.FieldType<number, number>;
       isOptional: false;
     };
     isShared: {
-      type: _lssm_lib_schema248.FieldType<boolean, boolean>;
+      type: _lssm_lib_schema247.FieldType<boolean, boolean>;
       isOptional: false;
     };
     createdAt: {
-      type: _lssm_lib_schema248.FieldType<Date, string>;
+      type: _lssm_lib_schema247.FieldType<Date, string>;
       isOptional: false;
     };
   }>;
@@ -122,54 +122,54 @@ declare const CreateQueryContract: _lssm_lib_contracts9.OperationSpec<_lssm_lib_
 /**
  * Execute a data query.
  */
-declare const ExecuteQueryContract: _lssm_lib_contracts9.OperationSpec<_lssm_lib_schema248.SchemaModel<{
+declare const ExecuteQueryContract: _lssm_lib_contracts9.OperationSpec<_lssm_lib_schema247.SchemaModel<{
   queryId: {
-    type: _lssm_lib_schema248.FieldType<string, string>;
+    type: _lssm_lib_schema247.FieldType<string, string>;
     isOptional: false;
   };
   parameters: {
-    type: _lssm_lib_schema248.FieldType<unknown, unknown>;
+    type: _lssm_lib_schema247.FieldType<unknown, unknown>;
     isOptional: true;
   };
   dateRange: {
-    type: _lssm_lib_schema248.FieldType<unknown, unknown>;
+    type: _lssm_lib_schema247.FieldType<unknown, unknown>;
     isOptional: true;
   };
   filters: {
-    type: _lssm_lib_schema248.FieldType<unknown, unknown>;
+    type: _lssm_lib_schema247.FieldType<unknown, unknown>;
     isOptional: true;
   };
   forceRefresh: {
-    type: _lssm_lib_schema248.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema247.FieldType<boolean, boolean>;
     isOptional: true;
   };
-}>, _lssm_lib_schema248.SchemaModel<{
+}>, _lssm_lib_schema247.SchemaModel<{
   queryId: {
-    type: _lssm_lib_schema248.FieldType<string, string>;
+    type: _lssm_lib_schema247.FieldType<string, string>;
     isOptional: false;
   };
   data: {
-    type: _lssm_lib_schema248.FieldType<unknown, unknown>;
+    type: _lssm_lib_schema247.FieldType<unknown, unknown>;
     isOptional: false;
   };
   columns: {
-    type: _lssm_lib_schema248.FieldType<unknown, unknown>;
+    type: _lssm_lib_schema247.FieldType<unknown, unknown>;
     isOptional: false;
   };
   rowCount: {
-    type: _lssm_lib_schema248.FieldType<number, number>;
+    type: _lssm_lib_schema247.FieldType<number, number>;
     isOptional: false;
   };
   executionTimeMs: {
-    type: _lssm_lib_schema248.FieldType<number, number>;
+    type: _lssm_lib_schema247.FieldType<number, number>;
     isOptional: false;
   };
   cachedAt: {
-    type: _lssm_lib_schema248.FieldType<Date, string>;
+    type: _lssm_lib_schema247.FieldType<Date, string>;
     isOptional: true;
   };
   error: {
-    type: _lssm_lib_schema248.FieldType<string, string>;
+    type: _lssm_lib_schema247.FieldType<string, string>;
     isOptional: true;
   };
 }>, undefined>;