@contractspec/lib.contracts 1.56.1 → 1.58.0

package/dist/app-config/validation.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validation.test.d.ts.map

package/dist/app-config/validation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.test.d.ts","sourceRoot":"","sources":["../../src/app-config/validation.test.ts"],"names":[],"mappings":""}

package/dist/capabilities/capabilities.d.ts

@@ -1,100 +1,97 @@
-import { VersionedSpecRef } from "../versioning/refs.js";
-import { OwnerShipMeta } from "../ownership.js";
-
-//#region src/capabilities/capabilities.d.ts
+import type { OwnerShipMeta } from '../ownership';
+import type { VersionedSpecRef } from '../versioning';
 /** Classification of capability types. */
-type CapabilityKind = 'api' | 'event' | 'data' | 'ui' | 'integration';
+export type CapabilityKind = 'api' | 'event' | 'data' | 'ui' | 'integration';
 /** Surfaces where capabilities can be exposed or consumed. */
-type CapabilitySurface = 'operation' | 'event' | 'workflow' | 'presentation' | 'resource';
+export type CapabilitySurface = 'operation' | 'event' | 'workflow' | 'presentation' | 'resource';
 /**
  * Reference to a capability on a specific surface.
  * Extends VersionedSpecRef with surface and description context.
  */
-interface CapabilitySurfaceRef {
-  /** The surface type where this capability is exposed. */
-  surface: CapabilitySurface;
-  /** Unique key identifying the spec on that surface (e.g., operation key). */
-  key: string;
-  /** Semantic version of the spec on that surface. */
-  version?: string;
-  /** Optional description of what this capability provides. */
-  description?: string;
+export interface CapabilitySurfaceRef {
+    /** The surface type where this capability is exposed. */
+    surface: CapabilitySurface;
+    /** Unique key identifying the spec on that surface (e.g., operation key). */
+    key: string;
+    /** Semantic version of the spec on that surface. */
+    version?: string;
+    /** Optional description of what this capability provides. */
+    description?: string;
 }
 /** Metadata for a capability spec, extending ownership with kind. */
-interface CapabilityMeta extends OwnerShipMeta {
-  /** The kind/category of this capability. */
-  kind: CapabilityKind;
+export interface CapabilityMeta extends OwnerShipMeta {
+    /** The kind/category of this capability. */
+    kind: CapabilityKind;
 }
 /**
  * Requirement for a capability dependency.
  * Used to declare what capabilities a spec needs.
  */
-interface CapabilityRequirement {
-  /** Unique key of the required capability. */
-  key: string;
-  /** Optional specific version required. */
-  version?: string;
-  /** Optional kind filter for the requirement. */
-  kind?: CapabilityKind;
-  /** If true, the requirement is optional and won't block if missing. */
-  optional?: boolean;
-  /** Human-readable reason why this capability is required. */
-  reason?: string;
+export interface CapabilityRequirement {
+    /** Unique key of the required capability. */
+    key: string;
+    /** Optional specific version required. */
+    version?: string;
+    /** Optional kind filter for the requirement. */
+    kind?: CapabilityKind;
+    /** If true, the requirement is optional and won't block if missing. */
+    optional?: boolean;
+    /** Human-readable reason why this capability is required. */
+    reason?: string;
 }
 /**
  * Reference to a capability spec.
  * Uses key and version to identify a specific capability.
  */
-type CapabilityRef = VersionedSpecRef;
-interface CapabilitySpec {
-  meta: CapabilityMeta;
-  /** Capabilities this capability extends (inherits requirements from). */
-  extends?: CapabilityRef;
-  /** Surfaces (operations, events, presentations, etc.) this capability provides. */
-  provides?: CapabilitySurfaceRef[];
-  /** Capabilities that must be present for this capability to function. */
-  requires?: CapabilityRequirement[];
+export type CapabilityRef = VersionedSpecRef;
+export interface CapabilitySpec {
+    meta: CapabilityMeta;
+    /** Capabilities this capability extends (inherits requirements from). */
+    extends?: CapabilityRef;
+    /** Surfaces (operations, events, presentations, etc.) this capability provides. */
+    provides?: CapabilitySurfaceRef[];
+    /** Capabilities that must be present for this capability to function. */
+    requires?: CapabilityRequirement[];
 }
-declare class CapabilityRegistry {
-  private readonly items;
-  /** Reverse index: surface key -> capability key (built lazily) */
-  private surfaceIndex;
-  register(spec: CapabilitySpec): this;
-  list(): CapabilitySpec[];
-  get(key: string, version?: string): CapabilitySpec | undefined;
-  satisfies(requirement: CapabilityRequirement, additional?: CapabilityRef[] | undefined): boolean;
-  /** Build reverse index from surface specs to capabilities. */
-  private buildSurfaceIndex;
-  /** Get all operation keys provided by a capability. */
-  getOperationsFor(capabilityKey: string, version?: string): string[];
-  /** Get all event keys provided by a capability. */
-  getEventsFor(capabilityKey: string, version?: string): string[];
-  /** Get all presentation keys provided by a capability. */
-  getPresentationsFor(capabilityKey: string, version?: string): string[];
-  /** Get all workflow keys provided by a capability. */
-  getWorkflowsFor(capabilityKey: string, version?: string): string[];
-  /** Get all resource keys provided by a capability. */
-  getResourcesFor(capabilityKey: string, version?: string): string[];
-  /** Get capability refs that provide a specific operation. */
-  getCapabilitiesForOperation(operationKey: string): CapabilityRef[];
-  /** Get capability refs that provide a specific event. */
-  getCapabilitiesForEvent(eventKey: string): CapabilityRef[];
-  /** Get capability refs that provide a specific presentation. */
-  getCapabilitiesForPresentation(presentationKey: string): CapabilityRef[];
-  /** Get the ancestor chain for a capability (from immediate parent to root). */
-  getAncestors(capabilityKey: string, version?: string): CapabilitySpec[];
-  /**
-   * Get effective requirements for a capability, including inherited ones.
-   * Requirements from ancestors are included, with child requirements taking
-   * precedence over parent requirements for the same key.
-   */
-  getEffectiveRequirements(capabilityKey: string, version?: string): CapabilityRequirement[];
-  /**
-   * Get all surfaces provided by a capability, including inherited ones.
-   */
-  getEffectiveSurfaces(capabilityKey: string, version?: string): CapabilitySurfaceRef[];
+export declare class CapabilityRegistry {
+    private readonly items;
+    /** Reverse index: surface key -> capability key (built lazily) */
+    private surfaceIndex;
+    register(spec: CapabilitySpec): this;
+    list(): CapabilitySpec[];
+    get(key: string, version?: string): CapabilitySpec | undefined;
+    satisfies(requirement: CapabilityRequirement, additional?: CapabilityRef[] | undefined): boolean;
+    /** Build reverse index from surface specs to capabilities. */
+    private buildSurfaceIndex;
+    /** Get all operation keys provided by a capability. */
+    getOperationsFor(capabilityKey: string, version?: string): string[];
+    /** Get all event keys provided by a capability. */
+    getEventsFor(capabilityKey: string, version?: string): string[];
+    /** Get all presentation keys provided by a capability. */
+    getPresentationsFor(capabilityKey: string, version?: string): string[];
+    /** Get all workflow keys provided by a capability. */
+    getWorkflowsFor(capabilityKey: string, version?: string): string[];
+    /** Get all resource keys provided by a capability. */
+    getResourcesFor(capabilityKey: string, version?: string): string[];
+    /** Get capability refs that provide a specific operation. */
+    getCapabilitiesForOperation(operationKey: string): CapabilityRef[];
+    /** Get capability refs that provide a specific event. */
+    getCapabilitiesForEvent(eventKey: string): CapabilityRef[];
+    /** Get capability refs that provide a specific presentation. */
+    getCapabilitiesForPresentation(presentationKey: string): CapabilityRef[];
+    /** Get the ancestor chain for a capability (from immediate parent to root). */
+    getAncestors(capabilityKey: string, version?: string): CapabilitySpec[];
+    /**
+     * Get effective requirements for a capability, including inherited ones.
+     * Requirements from ancestors are included, with child requirements taking
+     * precedence over parent requirements for the same key.
+     */
+    getEffectiveRequirements(capabilityKey: string, version?: string): CapabilityRequirement[];
+    /**
+     * Get all surfaces provided by a capability, including inherited ones.
+     */
+    getEffectiveSurfaces(capabilityKey: string, version?: string): CapabilitySurfaceRef[];
 }
-declare function capabilityKey(spec: CapabilitySpec): string;
-declare function defineCapability(spec: CapabilitySpec): CapabilitySpec;
-//#endregion
-export { CapabilityKind, CapabilityMeta, CapabilityRef, CapabilityRegistry, CapabilityRequirement, CapabilitySpec, CapabilitySurface, CapabilitySurfaceRef, capabilityKey, defineCapability };
+export declare function capabilityKey(spec: CapabilitySpec): string;
+export declare function defineCapability(spec: CapabilitySpec): CapabilitySpec;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/capabilities/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/capabilities/capabilities.ts"],"names":[],"mappings":"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"}

package/dist/capabilities/capabilities.js

@@ -1,173 +1,217 @@
+// @bun
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = import.meta.require;
+
+// src/capabilities/capabilities.ts
 import { compareVersions } from "compare-versions";
+var capKey = (key, version) => `${key}.v${version}`;
 
-//#region src/capabilities/capabilities.ts
-const capKey = (key, version) => `${key}.v${version}`;
-var CapabilityRegistry = class {
-	items = /* @__PURE__ */ new Map();
-	/** Reverse index: surface key -> capability key (built lazily) */
-	surfaceIndex = null;
-	register(spec) {
-		const key = capKey(spec.meta.key, spec.meta.version);
-		if (this.items.has(key)) throw new Error(`Duplicate capability ${key}`);
-		this.items.set(key, spec);
-		this.surfaceIndex = null;
-		return this;
-	}
-	list() {
-		return [...this.items.values()];
-	}
-	get(key, version) {
-		if (version != null) return this.items.get(capKey(key, version));
-		let candidate;
-		for (const spec of this.items.values()) {
-			if (spec.meta.key !== key) continue;
-			if (!candidate || compareVersions(spec.meta.version, candidate.meta.version) > 0) candidate = spec;
-		}
-		return candidate;
-	}
-	satisfies(requirement, additional) {
-		if (requirement.optional) return true;
-		if (additional?.some((ref) => matchesRequirement(ref, requirement))) return true;
-		const spec = requirement.version ? this.get(requirement.key, requirement.version) : this.get(requirement.key);
-		if (!spec) return false;
-		if (requirement.kind && spec.meta.kind !== requirement.kind) return false;
-		if (requirement.version != null && spec.meta.version !== requirement.version) return false;
-		return true;
-	}
-	/** Build reverse index from surface specs to capabilities. */
-	buildSurfaceIndex() {
-		if (this.surfaceIndex) return this.surfaceIndex;
-		this.surfaceIndex = /* @__PURE__ */ new Map();
-		for (const spec of this.items.values()) {
-			const capabilityKey$1 = capKey(spec.meta.key, spec.meta.version);
-			for (const surface of spec.provides ?? []) {
-				const surfaceKey = `${surface.surface}:${surface.key}`;
-				if (!this.surfaceIndex.has(surfaceKey)) this.surfaceIndex.set(surfaceKey, /* @__PURE__ */ new Set());
-				this.surfaceIndex.get(surfaceKey)?.add(capabilityKey$1);
-			}
-		}
-		return this.surfaceIndex;
-	}
-	/** Get all operation keys provided by a capability. */
-	getOperationsFor(capabilityKey$1, version) {
-		const spec = this.get(capabilityKey$1, version);
-		if (!spec) return [];
-		return spec.provides?.filter((s) => s.surface === "operation").map((s) => s.key) ?? [];
-	}
-	/** Get all event keys provided by a capability. */
-	getEventsFor(capabilityKey$1, version) {
-		const spec = this.get(capabilityKey$1, version);
-		if (!spec) return [];
-		return spec.provides?.filter((s) => s.surface === "event").map((s) => s.key) ?? [];
-	}
-	/** Get all presentation keys provided by a capability. */
-	getPresentationsFor(capabilityKey$1, version) {
-		const spec = this.get(capabilityKey$1, version);
-		if (!spec) return [];
-		return spec.provides?.filter((s) => s.surface === "presentation").map((s) => s.key) ?? [];
-	}
-	/** Get all workflow keys provided by a capability. */
-	getWorkflowsFor(capabilityKey$1, version) {
-		const spec = this.get(capabilityKey$1, version);
-		if (!spec) return [];
-		return spec.provides?.filter((s) => s.surface === "workflow").map((s) => s.key) ?? [];
-	}
-	/** Get all resource keys provided by a capability. */
-	getResourcesFor(capabilityKey$1, version) {
-		const spec = this.get(capabilityKey$1, version);
-		if (!spec) return [];
-		return spec.provides?.filter((s) => s.surface === "resource").map((s) => s.key) ?? [];
-	}
-	/** Get capability refs that provide a specific operation. */
-	getCapabilitiesForOperation(operationKey) {
-		const capKeys = this.buildSurfaceIndex().get(`operation:${operationKey}`);
-		if (!capKeys) return [];
-		return [...capKeys].map((k) => {
-			const spec = this.items.get(k);
-			return {
-				key: spec?.meta.key ?? "",
-				version: spec?.meta.version ?? ""
-			};
-		});
-	}
-	/** Get capability refs that provide a specific event. */
-	getCapabilitiesForEvent(eventKey) {
-		const capKeys = this.buildSurfaceIndex().get(`event:${eventKey}`);
-		if (!capKeys) return [];
-		return [...capKeys].map((k) => {
-			const spec = this.items.get(k);
-			return {
-				key: spec?.meta.key ?? "",
-				version: spec?.meta.version ?? ""
-			};
-		});
-	}
-	/** Get capability refs that provide a specific presentation. */
-	getCapabilitiesForPresentation(presentationKey) {
-		const capKeys = this.buildSurfaceIndex().get(`presentation:${presentationKey}`);
-		if (!capKeys) return [];
-		return [...capKeys].map((k) => {
-			const spec = this.items.get(k);
-			return {
-				key: spec?.meta.key ?? "",
-				version: spec?.meta.version ?? ""
-			};
-		});
-	}
-	/** Get the ancestor chain for a capability (from immediate parent to root). */
-	getAncestors(capabilityKey$1, version) {
-		const ancestors = [];
-		const visited = /* @__PURE__ */ new Set();
-		let current = this.get(capabilityKey$1, version);
-		while (current?.extends) {
-			const parentKey = capKey(current.extends.key, current.extends.version);
-			if (visited.has(parentKey)) break;
-			visited.add(parentKey);
-			const parent = this.get(current.extends.key, current.extends.version);
-			if (!parent) break;
-			ancestors.push(parent);
-			current = parent;
-		}
-		return ancestors;
-	}
-	/**
-	* Get effective requirements for a capability, including inherited ones.
-	* Requirements from ancestors are included, with child requirements taking
-	* precedence over parent requirements for the same key.
-	*/
-	getEffectiveRequirements(capabilityKey$1, version) {
-		const spec = this.get(capabilityKey$1, version);
-		if (!spec) return [];
-		const ancestors = this.getAncestors(capabilityKey$1, version);
-		const requirementMap = /* @__PURE__ */ new Map();
-		for (const ancestor of [...ancestors].reverse()) for (const req of ancestor.requires ?? []) requirementMap.set(req.key, req);
-		for (const req of spec.requires ?? []) requirementMap.set(req.key, req);
-		return [...requirementMap.values()];
-	}
-	/**
-	* Get all surfaces provided by a capability, including inherited ones.
-	*/
-	getEffectiveSurfaces(capabilityKey$1, version) {
-		const spec = this.get(capabilityKey$1, version);
-		if (!spec) return [];
-		const ancestors = this.getAncestors(capabilityKey$1, version);
-		const surfaces = [];
-		for (const ancestor of [...ancestors].reverse()) surfaces.push(...ancestor.provides ?? []);
-		surfaces.push(...spec.provides ?? []);
-		return surfaces;
-	}
-};
+class CapabilityRegistry {
+  items = new Map;
+  surfaceIndex = null;
+  register(spec) {
+    const key = capKey(spec.meta.key, spec.meta.version);
+    if (this.items.has(key))
+      throw new Error(`Duplicate capability ${key}`);
+    this.items.set(key, spec);
+    this.surfaceIndex = null;
+    return this;
+  }
+  list() {
+    return [...this.items.values()];
+  }
+  get(key, version) {
+    if (version != null)
+      return this.items.get(capKey(key, version));
+    let candidate;
+    for (const spec of this.items.values()) {
+      if (spec.meta.key !== key)
+        continue;
+      if (!candidate || compareVersions(spec.meta.version, candidate.meta.version) > 0) {
+        candidate = spec;
+      }
+    }
+    return candidate;
+  }
+  satisfies(requirement, additional) {
+    if (requirement.optional)
+      return true;
+    if (additional?.some((ref) => matchesRequirement(ref, requirement)))
+      return true;
+    const spec = requirement.version ? this.get(requirement.key, requirement.version) : this.get(requirement.key);
+    if (!spec)
+      return false;
+    if (requirement.kind && spec.meta.kind !== requirement.kind)
+      return false;
+    if (requirement.version != null && spec.meta.version !== requirement.version)
+      return false;
+    return true;
+  }
+  buildSurfaceIndex() {
+    if (this.surfaceIndex)
+      return this.surfaceIndex;
+    this.surfaceIndex = new Map;
+    for (const spec of this.items.values()) {
+      const capabilityKey = capKey(spec.meta.key, spec.meta.version);
+      for (const surface of spec.provides ?? []) {
+        const surfaceKey = `${surface.surface}:${surface.key}`;
+        if (!this.surfaceIndex.has(surfaceKey)) {
+          this.surfaceIndex.set(surfaceKey, new Set);
+        }
+        this.surfaceIndex.get(surfaceKey)?.add(capabilityKey);
+      }
+    }
+    return this.surfaceIndex;
+  }
+  getOperationsFor(capabilityKey, version) {
+    const spec = this.get(capabilityKey, version);
+    if (!spec)
+      return [];
+    return spec.provides?.filter((s) => s.surface === "operation").map((s) => s.key) ?? [];
+  }
+  getEventsFor(capabilityKey, version) {
+    const spec = this.get(capabilityKey, version);
+    if (!spec)
+      return [];
+    return spec.provides?.filter((s) => s.surface === "event").map((s) => s.key) ?? [];
+  }
+  getPresentationsFor(capabilityKey, version) {
+    const spec = this.get(capabilityKey, version);
+    if (!spec)
+      return [];
+    return spec.provides?.filter((s) => s.surface === "presentation").map((s) => s.key) ?? [];
+  }
+  getWorkflowsFor(capabilityKey, version) {
+    const spec = this.get(capabilityKey, version);
+    if (!spec)
+      return [];
+    return spec.provides?.filter((s) => s.surface === "workflow").map((s) => s.key) ?? [];
+  }
+  getResourcesFor(capabilityKey, version) {
+    const spec = this.get(capabilityKey, version);
+    if (!spec)
+      return [];
+    return spec.provides?.filter((s) => s.surface === "resource").map((s) => s.key) ?? [];
+  }
+  getCapabilitiesForOperation(operationKey) {
+    const index = this.buildSurfaceIndex();
+    const capKeys = index.get(`operation:${operationKey}`);
+    if (!capKeys)
+      return [];
+    return [...capKeys].map((k) => {
+      const spec = this.items.get(k);
+      return { key: spec?.meta.key ?? "", version: spec?.meta.version ?? "" };
+    });
+  }
+  getCapabilitiesForEvent(eventKey) {
+    const index = this.buildSurfaceIndex();
+    const capKeys = index.get(`event:${eventKey}`);
+    if (!capKeys)
+      return [];
+    return [...capKeys].map((k) => {
+      const spec = this.items.get(k);
+      return { key: spec?.meta.key ?? "", version: spec?.meta.version ?? "" };
+    });
+  }
+  getCapabilitiesForPresentation(presentationKey) {
+    const index = this.buildSurfaceIndex();
+    const capKeys = index.get(`presentation:${presentationKey}`);
+    if (!capKeys)
+      return [];
+    return [...capKeys].map((k) => {
+      const spec = this.items.get(k);
+      return { key: spec?.meta.key ?? "", version: spec?.meta.version ?? "" };
+    });
+  }
+  getAncestors(capabilityKey, version) {
+    const ancestors = [];
+    const visited = new Set;
+    let current = this.get(capabilityKey, version);
+    while (current?.extends) {
+      const parentKey = capKey(current.extends.key, current.extends.version);
+      if (visited.has(parentKey)) {
+        break;
+      }
+      visited.add(parentKey);
+      const parent = this.get(current.extends.key, current.extends.version);
+      if (!parent)
+        break;
+      ancestors.push(parent);
+      current = parent;
+    }
+    return ancestors;
+  }
+  getEffectiveRequirements(capabilityKey, version) {
+    const spec = this.get(capabilityKey, version);
+    if (!spec)
+      return [];
+    const ancestors = this.getAncestors(capabilityKey, version);
+    const requirementMap = new Map;
+    for (const ancestor of [...ancestors].reverse()) {
+      for (const req of ancestor.requires ?? []) {
+        requirementMap.set(req.key, req);
+      }
+    }
+    for (const req of spec.requires ?? []) {
+      requirementMap.set(req.key, req);
+    }
+    return [...requirementMap.values()];
+  }
+  getEffectiveSurfaces(capabilityKey, version) {
+    const spec = this.get(capabilityKey, version);
+    if (!spec)
+      return [];
+    const ancestors = this.getAncestors(capabilityKey, version);
+    const surfaces = [];
+    for (const ancestor of [...ancestors].reverse()) {
+      surfaces.push(...ancestor.provides ?? []);
+    }
+    surfaces.push(...spec.provides ?? []);
+    return surfaces;
+  }
+}
 function matchesRequirement(ref, requirement) {
-	if (ref.key !== requirement.key) return false;
-	if (requirement.version != null && ref.version !== requirement.version) return false;
-	return true;
+  if (ref.key !== requirement.key)
+    return false;
+  if (requirement.version != null && ref.version !== requirement.version)
+    return false;
+  return true;
 }
 function capabilityKey(spec) {
-	return capKey(spec.meta.key, spec.meta.version);
+  return capKey(spec.meta.key, spec.meta.version);
 }
 function defineCapability(spec) {
-	return spec;
+  return spec;
 }
-
-//#endregion
-export { CapabilityRegistry, capabilityKey, defineCapability };
+export {
+  defineCapability,
+  capabilityKey,
+  CapabilityRegistry
+};

package/dist/capabilities/capabilities.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=capabilities.test.d.ts.map

package/dist/capabilities/capabilities.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.test.d.ts","sourceRoot":"","sources":["../../src/capabilities/capabilities.test.ts"],"names":[],"mappings":""}