@contractspec/lib.contracts 1.44.0 → 1.45.0

package/dist/themes.d.ts

@@ -1,4 +1,5 @@
 import { OwnerShipMeta } from "./ownership.js";
+import { SpecContractRegistry } from "./registry.js";
 
 //#region src/themes.d.ts
 type ThemeScope = 'global' | 'tenant' | 'user';
@@ -40,13 +41,10 @@ interface ThemeSpec {
 }
 interface ThemeRef {
   key: string;
-  version: number;
+  version: string;
 }
-declare class ThemeRegistry {
-  private readonly items;
-  register(spec: ThemeSpec): this;
-  list(): ThemeSpec[];
-  get(key: string, version?: number): ThemeSpec | undefined;
+declare class ThemeRegistry extends SpecContractRegistry<'theme', ThemeSpec> {
+  constructor(items?: ThemeSpec[]);
 }
 declare function makeThemeRef(spec: ThemeSpec): ThemeRef;
 //#endregion

package/dist/themes.js

@@ -1,31 +1,9 @@
+import { SpecContractRegistry } from "./registry.js";
+
 //#region src/themes.ts
-const themeKey = (ref) => `${ref.key}.v${ref.version}`;
-var ThemeRegistry = class {
-	items = /* @__PURE__ */ new Map();
-	register(spec) {
-		const key = themeKey(spec.meta);
-		if (this.items.has(key)) throw new Error(`Duplicate theme ${key}`);
-		this.items.set(key, spec);
-		return this;
-	}
-	list() {
-		return [...this.items.values()];
-	}
-	get(key, version) {
-		if (version != null) return this.items.get(themeKey({
-			key,
-			version
-		}));
-		let candidate;
-		let max = -Infinity;
-		for (const spec of this.items.values()) {
-			if (spec.meta.key !== key) continue;
-			if (spec.meta.version > max) {
-				max = spec.meta.version;
-				candidate = spec;
-			}
-		}
-		return candidate;
+var ThemeRegistry = class extends SpecContractRegistry {
+	constructor(items) {
+		super("theme", items);
 	}
 };
 function makeThemeRef(spec) {

package/dist/translations/catalog.d.ts

@@ -9,7 +9,7 @@ interface TranslationEntry {
 }
 interface TranslationCatalogMeta {
   key: string;
-  version: number;
+  version: string;
   description?: string;
 }
 interface PlatformTranslationCatalog {

package/dist/types.d.ts

@@ -5,8 +5,8 @@ import { ResolvedBranding } from "./app-config/branding.js";
 import { Locale, MessageKey } from "./translations/catalog.js";
 import { ResolvedAppConfig, ResolvedIntegration, ResolvedKnowledge, ResolvedTranslation } from "./app-config/runtime.js";
 import { SecretProvider } from "./integrations/secrets/provider.js";
-import { SpecVariantResolver } from "./experiments/spec-resolver.js";
 import { EventRegistry } from "./events.js";
+import { SpecVariantResolver } from "./experiments/spec-resolver.js";
 
 //#region src/types.d.ts
 /**
@@ -14,7 +14,7 @@ import { EventRegistry } from "./events.js";
  */
 type Actor = 'anonymous' | 'user' | 'admin';
 type Channel = 'web' | 'mobile' | 'job' | 'agent';
-type ContractSpecType = 'app-config' | 'capability' | 'data-view' | 'experiment' | 'form' | 'integration' | 'knowledge' | 'operation' | 'policy' | 'presentation' | 'telemetry' | 'workflow' | 'event' | 'feature' | 'migration';
+type ContractSpecType = 'app-config' | 'agent' | 'operation' | 'event' | 'presentation' | 'capability' | 'integration' | 'data-view' | 'feature' | 'workflow' | 'policy' | 'theme' | 'telemetry' | 'experiment' | 'knowledge-space';
 interface FieldLevelDecision {
   field: string;
   effect: 'allow' | 'deny';
@@ -33,7 +33,7 @@ interface PolicyDecision {
 interface PolicyDeciderInput {
   service: string;
   command: string;
-  version: number;
+  version: string;
   actor: Actor;
   channel?: Channel;
   roles?: string[];
@@ -47,7 +47,7 @@ type TranslationResolver = (key: MessageKey, locale?: Locale) => Promise<string
 /** Outbox/bus event publisher (after validation & guarding) */
 type EventPublisher = (envelope: {
   key: string;
-  version: number;
+  version: string;
   payload: unknown;
   traceId?: string;
 }) => Promise<void>;
@@ -70,7 +70,7 @@ interface HandlerCtx {
   /** Secret provider for secure credentials */
   secretProvider?: SecretProvider;
   /** Internal pipe: filled by executor to enforce declared events */
-  __emitGuard__?: (key: string, version: number, payload: unknown) => Promise<void>;
+  __emitGuard__?: (key: string, version: string, payload: unknown) => Promise<void>;
   /** Resolved application configuration for the current execution context */
   appConfig?: ResolvedAppConfig;
   /** Resolved integration connections available to this execution */

package/dist/workflow/adapters/db-adapter.js

@@ -23,7 +23,7 @@ var PrismaStateStore = class {
 		return {
 			workflowId: record.id,
 			workflowName: record.name,
-			workflowVersion: parseInt(record.version, 10),
+			workflowVersion: record.version,
 			currentStep: record.currentStep,
 			data: record.data,
 			history: record.history,
@@ -51,7 +51,7 @@ var PrismaStateStore = class {
 		return {
 			workflowId: updated.id,
 			workflowName: updated.name,
-			workflowVersion: parseInt(updated.version, 10),
+			workflowVersion: updated.version,
 			currentStep: updated.currentStep,
 			data: updated.data,
 			history: updated.history,
@@ -67,7 +67,7 @@ var PrismaStateStore = class {
 		return (await this.prisma.workflowState.findMany({ where })).map((record) => ({
 			workflowId: record.id,
 			workflowName: record.name,
-			workflowVersion: parseInt(record.version, 10),
+			workflowVersion: record.version,
 			currentStep: record.currentStep,
 			data: record.data,
 			history: record.history,

package/dist/workflow/runner.d.ts

@@ -53,8 +53,10 @@ interface WorkflowRunnerConfig {
 declare class WorkflowRunner {
   private readonly config;
   constructor(config: WorkflowRunnerConfig);
-  preFlightCheck(workflowName: string, version?: number, resolvedConfig?: ResolvedAppConfig): Promise<WorkflowPreFlightResult>;
-  start(workflowName: string, version?: number, initialData?: Record<string, unknown>): Promise<string>;
+  preFlightCheck(workflowName: string, version?: string,
+  // Update to string
+  resolvedConfig?: ResolvedAppConfig): Promise<WorkflowPreFlightResult>;
+  start(workflowName: string, version?: string, initialData?: Record<string, unknown>): Promise<string>;
   executeStep(workflowId: string, input?: unknown): Promise<void>;
   rollback(workflowId: string): Promise<void>;
   getState(workflowId: string): Promise<WorkflowState>;

package/dist/workflow/spec.d.ts

@@ -1,8 +1,8 @@
 import { OwnerShipMeta } from "../ownership.js";
 import { CapabilityRef } from "../capabilities/capabilities.js";
 import "../capabilities/index.js";
+import { SpecContractRegistry } from "../registry.js";
 import { ExperimentRef } from "../experiments/spec.js";
-import { GroupKeyFn, RegistryFilter } from "../registry-utils.js";
 import { OpRef } from "../features/types.js";
 import "../features/index.js";
 
@@ -12,7 +12,7 @@ import "../features/index.js";
  */
 interface FormRef {
   key: string;
-  version: number;
+  version: string;
 }
 type StepType = 'human' | 'automation' | 'decision';
 type WorkflowStatus = 'running' | 'paused' | 'completed' | 'failed' | 'cancelled';
@@ -86,21 +86,8 @@ interface WorkflowSpec {
   };
   experiments?: ExperimentRef[];
 }
-declare class WorkflowRegistry {
-  private readonly items;
-  register(spec: WorkflowSpec): this;
-  list(): WorkflowSpec[];
-  get(name: string, version?: number): WorkflowSpec | undefined;
-  /** Filter workflows by criteria. */
-  filter(criteria: RegistryFilter): WorkflowSpec[];
-  /** List workflows with specific tag. */
-  listByTag(tag: string): WorkflowSpec[];
-  /** List workflows by owner. */
-  listByOwner(owner: string): WorkflowSpec[];
-  /** Group workflows by key function. */
-  groupBy(keyFn: GroupKeyFn<WorkflowSpec>): Map<string, WorkflowSpec[]>;
-  /** Get unique tags from all workflows. */
-  getUniqueTags(): string[];
+declare class WorkflowRegistry extends SpecContractRegistry<'workflow', WorkflowSpec> {
+  constructor(items?: WorkflowSpec[]);
 }
 //#endregion
 export { CompensationStep, CompensationStrategy, FormRef, GuardCondition, GuardConditionKind, RetryPolicy, SLA, Step, StepAction, StepType, Transition, WorkflowDefinition, WorkflowMeta, WorkflowRegistry, WorkflowSpec, WorkflowStatus };

package/dist/workflow/spec.js

@@ -1,53 +1,9 @@
-import { filterBy, getUniqueTags, groupBy, init_registry_utils } from "../registry-utils.js";
+import { SpecContractRegistry } from "../registry.js";
 
 //#region src/workflow/spec.ts
-init_registry_utils();
-function workflowKey(meta) {
-	return `${meta.key}.v${meta.version}`;
-}
-var WorkflowRegistry = class {
-	items = /* @__PURE__ */ new Map();
-	register(spec) {
-		const key = workflowKey(spec.meta);
-		if (this.items.has(key)) throw new Error(`Duplicate workflow ${key}`);
-		this.items.set(key, spec);
-		return this;
-	}
-	list() {
-		return [...this.items.values()];
-	}
-	get(name, version) {
-		if (version != null) return this.items.get(`${name}.v${version}`);
-		let candidate;
-		let max = -Infinity;
-		for (const spec of this.items.values()) {
-			if (spec.meta.key !== name) continue;
-			if (spec.meta.version > max) {
-				max = spec.meta.version;
-				candidate = spec;
-			}
-		}
-		return candidate;
-	}
-	/** Filter workflows by criteria. */
-	filter(criteria) {
-		return filterBy(this.list(), criteria);
-	}
-	/** List workflows with specific tag. */
-	listByTag(tag) {
-		return this.list().filter((w) => w.meta.tags?.includes(tag));
-	}
-	/** List workflows by owner. */
-	listByOwner(owner) {
-		return this.list().filter((w) => w.meta.owners?.includes(owner));
-	}
-	/** Group workflows by key function. */
-	groupBy(keyFn) {
-		return groupBy(this.list(), keyFn);
-	}
-	/** Get unique tags from all workflows. */
-	getUniqueTags() {
-		return getUniqueTags(this.list());
+var WorkflowRegistry = class extends SpecContractRegistry {
+	constructor(items) {
+		super("workflow", items);
 	}
 };
 

package/dist/workflow/state.d.ts

@@ -13,7 +13,7 @@ interface StepExecution {
 interface WorkflowState {
   workflowId: string;
   workflowName: string;
-  workflowVersion: number;
+  workflowVersion: string;
   currentStep: string;
   data: Record<string, unknown>;
   retryCounts?: Record<string, number>;

package/dist/workflow/validation.js

@@ -113,7 +113,7 @@ function validateStepActions(steps, options, issues) {
 		const action = step.action;
 		if (!action) continue;
 		if (action.operation && options.operations) {
-			if (!options.operations.getSpec(action.operation.key, action.operation.version)) issues.push({
+			if (!options.operations.get(action.operation.key, action.operation.version)) issues.push({
 				level: "error",
 				message: `Step "${step.id}" references unknown operation ${action.operation.key}.v${action.operation.version}.`
 			});