@contractspec/lib.contracts 1.56.1 → 1.58.0

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

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

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

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

package/dist/app-config/spec.d.ts

@@ -1,175 +1,170 @@
-import { PolicyRef } from "../policy/spec.js";
-import { CapabilityRef } from "../capabilities/capabilities.js";
-import { SpecContractRegistry } from "../registry.js";
-import "../capabilities/index.js";
-import { ExperimentRef } from "../experiments/spec.js";
-import { FeatureModuleSpec, FeatureRef } from "../features/types.js";
-import "../features/index.js";
-import { ThemeRef } from "../themes.js";
-import { IntegrationCategory, IntegrationOwnershipMode } from "../integrations/spec.js";
-import { AppIntegrationBinding } from "../integrations/binding.js";
-import { AppKnowledgeBinding } from "../knowledge/binding.js";
-import { BrandingDefaults, TenantBrandingConfig } from "./branding.js";
-import { Locale, TranslationEntry } from "../translations/catalog.js";
-import { ConfigStatus } from "./lifecycle.js";
-import { OwnerShipMeta } from "../ownership.js";
-
-//#region src/app-config/spec.d.ts
-interface SpecPointer {
-  key: string;
-  version?: string;
+import type { OwnerShipMeta } from '../ownership';
+import type { CapabilityRef } from '../capabilities';
+import type { FeatureRef, FeatureModuleSpec } from '../features';
+import type { PolicyRef } from '../policy/spec';
+import type { ThemeRef } from '../themes';
+import type { ExperimentRef } from '../experiments/spec';
+import type { IntegrationCategory, IntegrationOwnershipMode } from '../integrations/spec';
+import type { AppIntegrationBinding } from '../integrations/binding';
+import type { AppKnowledgeBinding } from '../knowledge/binding';
+import type { BrandingDefaults, TenantBrandingConfig } from './branding';
+import type { Locale, TranslationEntry } from '../translations/catalog';
+import type { ConfigStatus } from './lifecycle';
+import { SpecContractRegistry } from '../registry';
+export interface SpecPointer {
+    key: string;
+    version?: string;
 }
-interface AppRouteConfig {
-  path: string;
-  label?: string;
-  dataView?: string;
-  workflow?: string;
-  guard?: PolicyRef;
-  featureFlag?: string;
-  experiment?: ExperimentRef;
+export interface AppRouteConfig {
+    path: string;
+    label?: string;
+    dataView?: string;
+    workflow?: string;
+    guard?: PolicyRef;
+    featureFlag?: string;
+    experiment?: ExperimentRef;
 }
-interface TranslationCatalogPointer {
-  key: string;
-  version: string;
+export interface TranslationCatalogPointer {
+    key: string;
+    version: string;
 }
-interface AppIntegrationSlot {
-  /** Slot identifier unique within the blueprint (e.g., "primaryPayments"). */
-  slotId: string;
-  /** Integration category required to satisfy this slot. */
-  requiredCategory: IntegrationCategory;
-  /** Ownership modes allowed for this slot (defaults to any supported mode). */
-  allowedModes?: IntegrationOwnershipMode[];
-  /** Capabilities that must be provided by the integration spec. */
-  requiredCapabilities?: CapabilityRef[];
-  /** Whether this slot must be satisfied for the app to function. */
-  required?: boolean;
-  /** Description for App Studio UX. */
-  description?: string;
+export interface AppIntegrationSlot {
+    /** Slot identifier unique within the blueprint (e.g., "primaryPayments"). */
+    slotId: string;
+    /** Integration category required to satisfy this slot. */
+    requiredCategory: IntegrationCategory;
+    /** Ownership modes allowed for this slot (defaults to any supported mode). */
+    allowedModes?: IntegrationOwnershipMode[];
+    /** Capabilities that must be provided by the integration spec. */
+    requiredCapabilities?: CapabilityRef[];
+    /** Whether this slot must be satisfied for the app to function. */
+    required?: boolean;
+    /** Description for App Studio UX. */
+    description?: string;
 }
-interface FeatureFlagState {
-  key: string;
-  enabled: boolean;
-  variant?: string;
-  description?: string;
+export interface FeatureFlagState {
+    key: string;
+    enabled: boolean;
+    variant?: string;
+    description?: string;
 }
-interface TelemetryBinding {
-  spec?: SpecPointer;
-  disabledEvents?: string[];
-  samplingOverrides?: Record<string, number>;
+export interface TelemetryBinding {
+    spec?: SpecPointer;
+    disabledEvents?: string[];
+    samplingOverrides?: Record<string, number>;
 }
-interface AppThemeBinding {
-  primary: ThemeRef;
-  fallbacks?: ThemeRef[];
+export interface AppThemeBinding {
+    primary: ThemeRef;
+    fallbacks?: ThemeRef[];
 }
-interface AppBlueprintMeta extends OwnerShipMeta {
-  /** Logical application id (e.g. "artisan"). */
-  appId: string;
+export interface AppBlueprintMeta extends OwnerShipMeta {
+    /** Logical application id (e.g. "artisan"). */
+    appId: string;
 }
-interface AppBlueprintSpec {
-  meta: AppBlueprintMeta;
-  capabilities?: {
-    enabled?: CapabilityRef[];
-    disabled?: CapabilityRef[];
-  };
-  features?: {
-    include?: FeatureRef[];
-    exclude?: FeatureRef[];
-  };
-  integrationSlots?: AppIntegrationSlot[];
-  branding?: BrandingDefaults;
-  translationCatalog?: TranslationCatalogPointer;
-  dataViews?: Record<string, SpecPointer>;
-  workflows?: Record<string, SpecPointer>;
-  policies?: PolicyRef[];
-  theme?: AppThemeBinding;
-  telemetry?: TelemetryBinding;
-  experiments?: {
-    active?: ExperimentRef[];
-    paused?: ExperimentRef[];
-  };
-  featureFlags?: FeatureFlagState[];
-  routes?: AppRouteConfig[];
-  notes?: string;
+export interface AppBlueprintSpec {
+    meta: AppBlueprintMeta;
+    capabilities?: {
+        enabled?: CapabilityRef[];
+        disabled?: CapabilityRef[];
+    };
+    features?: {
+        include?: FeatureRef[];
+        exclude?: FeatureRef[];
+    };
+    integrationSlots?: AppIntegrationSlot[];
+    branding?: BrandingDefaults;
+    translationCatalog?: TranslationCatalogPointer;
+    dataViews?: Record<string, SpecPointer>;
+    workflows?: Record<string, SpecPointer>;
+    policies?: PolicyRef[];
+    theme?: AppThemeBinding;
+    telemetry?: TelemetryBinding;
+    experiments?: {
+        active?: ExperimentRef[];
+        paused?: ExperimentRef[];
+    };
+    featureFlags?: FeatureFlagState[];
+    routes?: AppRouteConfig[];
+    notes?: string;
 }
-declare class AppBlueprintRegistry extends SpecContractRegistry<'app-config', AppBlueprintSpec> {
-  constructor(items?: AppBlueprintSpec[]);
+export declare class AppBlueprintRegistry extends SpecContractRegistry<'app-config', AppBlueprintSpec> {
+    constructor(items?: AppBlueprintSpec[]);
 }
-declare function makeAppBlueprintKey(meta: AppBlueprintMeta): string;
-interface TenantAppConfigMeta {
-  id: string;
-  tenantId: string;
-  appId: string;
-  blueprintName: string;
-  blueprintVersion: string;
-  environment?: string;
-  /** Monotonic version for auditing changes to the tenant config. */
-  version: string;
-  status: ConfigStatus;
-  createdBy?: string;
-  publishedBy?: string;
-  publishedAt?: string | Date;
-  rolledBackFrom?: string;
-  rolledBackTo?: string;
-  changeSummary?: string;
-  createdAt?: string | Date;
-  updatedAt?: string | Date;
+export declare function makeAppBlueprintKey(meta: AppBlueprintMeta): string;
+export interface TenantAppConfigMeta {
+    id: string;
+    tenantId: string;
+    appId: string;
+    blueprintName: string;
+    blueprintVersion: string;
+    environment?: string;
+    /** Monotonic version for auditing changes to the tenant config. */
+    version: string;
+    status: ConfigStatus;
+    createdBy?: string;
+    publishedBy?: string;
+    publishedAt?: string | Date;
+    rolledBackFrom?: string;
+    rolledBackTo?: string;
+    changeSummary?: string;
+    createdAt?: string | Date;
+    updatedAt?: string | Date;
 }
-interface TenantSpecOverride {
-  slot: string;
-  pointer?: SpecPointer | null;
+export interface TenantSpecOverride {
+    slot: string;
+    pointer?: SpecPointer | null;
 }
-interface TenantRouteOverride {
-  path: string;
-  label?: string | null;
-  dataView?: string | null;
-  workflow?: string | null;
-  guard?: PolicyRef | null;
-  featureFlag?: string | null;
-  experiment?: ExperimentRef | null;
+export interface TenantRouteOverride {
+    path: string;
+    label?: string | null;
+    dataView?: string | null;
+    workflow?: string | null;
+    guard?: PolicyRef | null;
+    featureFlag?: string | null;
+    experiment?: ExperimentRef | null;
 }
-interface TenantAppConfig {
-  meta: TenantAppConfigMeta;
-  capabilities?: {
-    enable?: CapabilityRef[];
-    disable?: CapabilityRef[];
-  };
-  features?: {
-    include?: FeatureRef[];
-    exclude?: FeatureRef[];
-  };
-  dataViewOverrides?: TenantSpecOverride[];
-  workflowOverrides?: TenantSpecOverride[];
-  additionalPolicies?: PolicyRef[];
-  themeOverride?: {
-    primary?: ThemeRef | null;
-    fallbacks?: ThemeRef[];
-  };
-  telemetryOverride?: {
-    spec?: SpecPointer | null;
-    disabledEvents?: string[];
-    samplingOverrides?: Record<string, number>;
-  };
-  experiments?: {
-    active?: ExperimentRef[];
-    paused?: ExperimentRef[];
-  };
-  featureFlags?: FeatureFlagState[];
-  routeOverrides?: TenantRouteOverride[];
-  integrations?: AppIntegrationBinding[];
-  knowledge?: AppKnowledgeBinding[];
-  locales?: {
-    defaultLocale: Locale;
-    enabledLocales: Locale[];
-  };
-  translationOverrides?: {
-    entries?: TranslationEntry[];
-  };
-  branding?: TenantBrandingConfig;
-  notes?: string;
+export interface TenantAppConfig {
+    meta: TenantAppConfigMeta;
+    capabilities?: {
+        enable?: CapabilityRef[];
+        disable?: CapabilityRef[];
+    };
+    features?: {
+        include?: FeatureRef[];
+        exclude?: FeatureRef[];
+    };
+    dataViewOverrides?: TenantSpecOverride[];
+    workflowOverrides?: TenantSpecOverride[];
+    additionalPolicies?: PolicyRef[];
+    themeOverride?: {
+        primary?: ThemeRef | null;
+        fallbacks?: ThemeRef[];
+    };
+    telemetryOverride?: {
+        spec?: SpecPointer | null;
+        disabledEvents?: string[];
+        samplingOverrides?: Record<string, number>;
+    };
+    experiments?: {
+        active?: ExperimentRef[];
+        paused?: ExperimentRef[];
+    };
+    featureFlags?: FeatureFlagState[];
+    routeOverrides?: TenantRouteOverride[];
+    integrations?: AppIntegrationBinding[];
+    knowledge?: AppKnowledgeBinding[];
+    locales?: {
+        defaultLocale: Locale;
+        enabledLocales: Locale[];
+    };
+    translationOverrides?: {
+        entries?: TranslationEntry[];
+    };
+    branding?: TenantBrandingConfig;
+    notes?: string;
 }
 /**
  * Helper to define an AppConfig.
  */
-declare const defineAppConfig: (spec: FeatureModuleSpec) => FeatureModuleSpec;
-//#endregion
-export { AppBlueprintMeta, AppBlueprintRegistry, AppBlueprintSpec, AppIntegrationSlot, AppRouteConfig, AppThemeBinding, FeatureFlagState, SpecPointer, TelemetryBinding, TenantAppConfig, TenantAppConfigMeta, TenantRouteOverride, TenantSpecOverride, TranslationCatalogPointer, defineAppConfig, makeAppBlueprintKey };
+export declare const defineAppConfig: (spec: FeatureModuleSpec) => FeatureModuleSpec;
+//# sourceMappingURL=spec.d.ts.map

package/dist/app-config/spec.d.ts.map

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

package/dist/app-config/spec.js

@@ -1,19 +1,229 @@
-import { SpecContractRegistry } from "../registry.js";
-
-//#region src/app-config/spec.ts
-const blueprintKey = (meta) => `${meta.key}.v${meta.version}`;
-var AppBlueprintRegistry = class extends SpecContractRegistry {
-	constructor(items) {
-		super("app-config", items);
-	}
+// @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;
 };
-function makeAppBlueprintKey(meta) {
-	return blueprintKey(meta);
+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/registry-utils.ts
+var exports_registry_utils = {};
+__export(exports_registry_utils, {
+  groupByToArray: () => groupByToArray,
+  groupByMultiple: () => groupByMultiple,
+  groupBy: () => groupBy,
+  getUniqueTags: () => getUniqueTags,
+  getUniqueOwners: () => getUniqueOwners,
+  getUniqueDomains: () => getUniqueDomains,
+  filterBy: () => filterBy,
+  GroupingStrategies: () => GroupingStrategies
+});
+function filterBy(items, filter) {
+  return items.filter((item) => {
+    if (filter.tags?.length) {
+      const hasMatchingTag = filter.tags.some((tag) => item.meta.tags?.includes(tag));
+      if (!hasMatchingTag)
+        return false;
+    }
+    if (filter.owners?.length) {
+      const hasMatchingOwner = filter.owners.some((owner) => item.meta.owners?.includes(owner));
+      if (!hasMatchingOwner)
+        return false;
+    }
+    if (filter.stability?.length) {
+      if (!filter.stability.includes(item.meta.stability ?? "stable")) {
+        return false;
+      }
+    }
+    if (filter.domain) {
+      const itemDomain = GroupingStrategies.byDomain(item);
+      if (itemDomain !== filter.domain)
+        return false;
+    }
+    if (filter.keyPattern) {
+      const name = item.meta.key ?? item.meta.key ?? "";
+      const pattern = filter.keyPattern.replace(/\*/g, ".*").replace(/\?/g, ".");
+      const regex = new RegExp(`^${pattern}$`, "i");
+      if (!regex.test(name))
+        return false;
+    }
+    return true;
+  });
+}
+function groupBy(items, keyFn) {
+  const groups = new Map;
+  for (const item of items) {
+    const key = keyFn(item);
+    const existing = groups.get(key);
+    if (existing) {
+      existing.push(item);
+    } else {
+      groups.set(key, [item]);
+    }
+  }
+  return groups;
+}
+function groupByToArray(items, keyFn) {
+  const map = groupBy(items, keyFn);
+  return Array.from(map.entries()).map(([key, items2]) => ({ key, items: items2 }));
+}
+function groupByMultiple(items, keysFn) {
+  const groups = new Map;
+  for (const item of items) {
+    const keys = keysFn(item);
+    for (const key of keys) {
+      const existing = groups.get(key);
+      if (existing) {
+        existing.push(item);
+      } else {
+        groups.set(key, [item]);
+      }
+    }
+  }
+  return groups;
+}
+function getUniqueTags(items) {
+  const tags = new Set;
+  for (const item of items) {
+    for (const tag of item.meta.tags ?? []) {
+      tags.add(tag);
+    }
+  }
+  return Array.from(tags).sort();
+}
+function getUniqueOwners(items) {
+  const owners = new Set;
+  for (const item of items) {
+    for (const owner of item.meta.owners ?? []) {
+      owners.add(owner);
+    }
+  }
+  return Array.from(owners).sort();
 }
-/**
-* Helper to define an AppConfig.
-*/
-const defineAppConfig = (spec) => spec;
+function getUniqueDomains(items) {
+  const domains = new Set;
+  for (const item of items) {
+    domains.add(GroupingStrategies.byDomain(item));
+  }
+  return Array.from(domains).sort();
+}
+var GroupingStrategies;
+var init_registry_utils = __esm(() => {
+  GroupingStrategies = {
+    byTag: (item) => item.meta.tags?.[0] ?? "untagged",
+    byAllTags: (item) => item.meta.tags?.length ? item.meta.tags : ["untagged"],
+    byOwner: (item) => item.meta.owners?.[0] ?? "unowned",
+    byDomain: (item) => {
+      const name = item.meta.key ?? item.meta.key ?? "";
+      return name.split(".")[0] ?? "default";
+    },
+    byStability: (item) => item.meta.stability ?? "stable",
+    byUrlPath: (level) => (item) => {
+      if (!item.path)
+        return "root";
+      const segments = item.path.split("/").filter(Boolean);
+      return segments.slice(0, level).join("/") || "root";
+    }
+  };
+});
+
+// src/registry.ts
+init_registry_utils();
+import { compareVersions } from "compare-versions";
+var keyOfSpecContract = (spec) => `${spec.meta.key}.v${spec.meta.version}`;
+
+class SpecContractRegistry {
+  contractType;
+  items = new Map;
+  constructor(contractType, items) {
+    this.contractType = contractType;
+    if (items) {
+      items.forEach((p) => this.register(p));
+    }
+  }
+  register(p) {
+    const key = keyOfSpecContract(p);
+    if (this.items.has(key))
+      throw new Error(`Duplicate contract \`${this.contractType}\` ${key}`);
+    this.items.set(key, p);
+    return this;
+  }
+  count() {
+    return this.items.size;
+  }
+  list() {
+    return [...this.items.values()];
+  }
+  get(key, version) {
+    if (version != null)
+      return this.items.get(`${key}.v${version}`);
+    let candidate;
+    for (const [k, p] of this.items.entries()) {
+      if (!k.startsWith(`${key}.v`))
+        continue;
+      if (!candidate || compareVersions(p.meta.version, candidate.meta.version) > 0) {
+        candidate = p;
+      }
+    }
+    return candidate;
+  }
+  has(key, version) {
+    return !!this.get(key, version);
+  }
+  filter(criteria) {
+    return filterBy(this.list(), criteria);
+  }
+  listByTag(tag) {
+    return this.list().filter((p) => p.meta.tags?.includes(tag));
+  }
+  listByOwner(owner) {
+    return this.list().filter((p) => p.meta.owners?.includes(owner));
+  }
+  groupBy(keyFn) {
+    return groupBy(this.list(), keyFn);
+  }
+  getUniqueTags() {
+    return getUniqueTags(this.list());
+  }
+}
+
+// src/app-config/spec.ts
+var blueprintKey = (meta) => `${meta.key}.v${meta.version}`;
 
-//#endregion
-export { AppBlueprintRegistry, defineAppConfig, makeAppBlueprintKey };
+class AppBlueprintRegistry extends SpecContractRegistry {
+  constructor(items) {
+    super("app-config", items);
+  }
+}
+function makeAppBlueprintKey(meta) {
+  return blueprintKey(meta);
+}
+var defineAppConfig = (spec) => spec;
+export {
+  makeAppBlueprintKey,
+  defineAppConfig,
+  AppBlueprintRegistry
+};

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

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

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

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