@contractspec/lib.contracts 1.57.0 → 1.58.0

package/dist/translations/validation.test.d.ts

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

package/dist/translations/validation.test.d.ts.map

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

package/dist/types.d.ts

@@ -1,14 +1,3 @@
-import { ConsentDefinition, PolicySpec, RateLimitDefinition } from "./policy/spec.js";
-import { TelemetryTracker } from "./telemetry/tracker.js";
-import "./telemetry/index.js";
-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";
-
-//#region src/types.d.ts
 /**
  * Common runtime types for ContractSpec execution.
  *
@@ -24,7 +13,7 @@ import { EventRegistry } from "./events.js";
  * - `user`: Authenticated end-user
  * - `admin`: Administrative/system user with elevated privileges
  */
-type Actor = 'anonymous' | 'user' | 'admin';
+export type Actor = 'anonymous' | 'user' | 'admin';
 /**
  * Channel through which a request originates.
  *
@@ -33,24 +22,32 @@ type Actor = 'anonymous' | 'user' | 'admin';
  * - `job`: Background job/scheduled task
  * - `agent`: AI agent or automated system
  */
-type Channel = 'web' | 'mobile' | 'job' | 'agent' | 'ci';
+export type Channel = 'web' | 'mobile' | 'job' | 'agent' | 'ci';
+import type { ConsentDefinition, PolicySpec, RateLimitDefinition } from './policy/spec';
+import type { TelemetryTracker } from './telemetry';
+import type { ResolvedAppConfig, ResolvedIntegration, ResolvedKnowledge, ResolvedTranslation } from './app-config/runtime';
+import type { ResolvedBranding } from './app-config/branding';
+import type { Locale, MessageKey } from './translations/catalog';
+import type { SecretProvider } from './integrations/secrets/provider';
+import type { SpecVariantResolver } from './experiments/spec-resolver';
+import type { EventRegistry } from './events';
 /**
  * Discriminator for all ContractSpec specification types.
  *
  * Used to identify the kind of spec in registries and runtime operations.
  */
-type ContractSpecType = 'operation' | 'event' | 'presentation' | 'feature' | 'capability' | 'data-view' | 'form' | 'agent' | 'migration' | 'workflow' | 'experiment' | 'integration' | 'theme' | 'knowledge' | 'telemetry' | 'example' | 'app-config' | 'product-intent' | 'policy' | 'test-spec' | 'type' | 'knowledge-space';
+export type ContractSpecType = 'operation' | 'event' | 'presentation' | 'feature' | 'capability' | 'data-view' | 'form' | 'agent' | 'migration' | 'workflow' | 'experiment' | 'integration' | 'theme' | 'knowledge' | 'telemetry' | 'example' | 'app-config' | 'product-intent' | 'policy' | 'test-spec' | 'type' | 'knowledge-space';
 /**
  * Decision for a specific field access.
  * Used for fine-grained field-level authorization.
  */
-interface FieldLevelDecision {
-  /** The field path being evaluated. */
-  field: string;
-  /** Whether access is allowed or denied. */
-  effect: 'allow' | 'deny';
-  /** Human-readable reason for the decision. */
-  reason?: string;
+export interface FieldLevelDecision {
+    /** The field path being evaluated. */
+    field: string;
+    /** Whether access is allowed or denied. */
+    effect: 'allow' | 'deny';
+    /** Human-readable reason for the decision. */
+    reason?: string;
 }
 /**
  * Result of a policy evaluation.
@@ -58,52 +55,52 @@ interface FieldLevelDecision {
  * Contains the access decision and any applicable constraints
  * like rate limits, escalation requirements, or consent needs.
  */
-interface PolicyDecision {
-  /** Overall access decision: allow or deny. */
-  effect: 'allow' | 'deny';
-  /** Human-readable reason for the decision. */
-  reason?: string;
-  /** Rate limit constraints to apply if allowed. */
-  rateLimit?: Pick<RateLimitDefinition, 'rpm' | 'key' | 'windowSeconds' | 'burst'>;
-  /** Escalation requirement for manual review. */
-  escalate?: 'human_review' | null;
-  /** Per-field access decisions. */
-  fieldDecisions?: FieldLevelDecision[];
-  /** PII handling policy. */
-  pii?: PolicySpec['pii'];
-  /** Consents required before proceeding. */
-  requiredConsents?: ConsentDefinition[];
-  /** Which engine produced this decision. */
-  evaluatedBy?: 'engine' | 'opa';
+export interface PolicyDecision {
+    /** Overall access decision: allow or deny. */
+    effect: 'allow' | 'deny';
+    /** Human-readable reason for the decision. */
+    reason?: string;
+    /** Rate limit constraints to apply if allowed. */
+    rateLimit?: Pick<RateLimitDefinition, 'rpm' | 'key' | 'windowSeconds' | 'burst'>;
+    /** Escalation requirement for manual review. */
+    escalate?: 'human_review' | null;
+    /** Per-field access decisions. */
+    fieldDecisions?: FieldLevelDecision[];
+    /** PII handling policy. */
+    pii?: PolicySpec['pii'];
+    /** Consents required before proceeding. */
+    requiredConsents?: ConsentDefinition[];
+    /** Which engine produced this decision. */
+    evaluatedBy?: 'engine' | 'opa';
 }
 /**
  * Input for policy evaluation.
  * Contains context about the request being authorized.
  */
-interface PolicyDeciderInput {
-  /** Service name (e.g., "sigil"). */
-  service: string;
-  /** Command/operation name (e.g., "beginSignup"). */
-  command: string;
-  /** Operation version. */
-  version: string;
-  /** Actor type making the request. */
-  actor: Actor;
-  /** Channel the request came from. */
-  channel?: Channel;
-  /** Roles assigned to the actor. */
-  roles?: string[];
-  /** Organization context if applicable. */
-  organizationId?: string | null;
-  /** User context if authenticated. */
-  userId?: string | null;
-  /** Active feature flags. */
-  flags?: string[];
+export interface PolicyDeciderInput {
+    /** Service name (e.g., "sigil"). */
+    service: string;
+    /** Command/operation name (e.g., "beginSignup"). */
+    command: string;
+    /** Operation version. */
+    version: string;
+    /** Actor type making the request. */
+    actor: Actor;
+    /** Channel the request came from. */
+    channel?: Channel;
+    /** Roles assigned to the actor. */
+    roles?: string[];
+    /** Organization context if applicable. */
+    organizationId?: string | null;
+    /** User context if authenticated. */
+    userId?: string | null;
+    /** Active feature flags. */
+    flags?: string[];
 }
 /**
  * Function that evaluates policy rules and returns a decision.
  */
-type PolicyDecider = (input: PolicyDeciderInput) => Promise<PolicyDecision>;
+export type PolicyDecider = (input: PolicyDeciderInput) => Promise<PolicyDecision>;
 /**
  * Function that enforces rate limits.
  *
@@ -112,20 +109,24 @@ type PolicyDecider = (input: PolicyDeciderInput) => Promise<PolicyDecision>;
  * @param rpm - Requests per minute limit
  * @throws When rate limit is exceeded
  */
-type RateLimiter = (key: string, cost: number, rpm: number) => Promise<void>;
+export type RateLimiter = (key: string, cost: number, rpm: number) => Promise<void>;
 /**
  * Function that resolves translation keys to localized strings.
  */
-type TranslationResolver = (key: MessageKey, locale?: Locale) => Promise<string | null> | string | null;
+export type TranslationResolver = (key: MessageKey, locale?: Locale) => Promise<string | null> | string | null;
 /**
  * Function that publishes events to the outbox/message bus.
  * Called after validation and guard checks pass.
  */
-type EventPublisher = (envelope: {
-  /** Event key (e.g., "user.created"). */key: string; /** Event version. */
-  version: string; /** Validated event payload. */
-  payload: unknown; /** Trace ID for correlation. */
-  traceId?: string;
+export type EventPublisher = (envelope: {
+    /** Event key (e.g., "user.created"). */
+    key: string;
+    /** Event version. */
+    version: string;
+    /** Validated event payload. */
+    payload: unknown;
+    /** Trace ID for correlation. */
+    traceId?: string;
 }) => Promise<void>;
 /**
  * Execution context passed to operation handlers.
@@ -158,54 +159,55 @@ type EventPublisher = (envelope: {
  * }
  * ```
  */
-interface HandlerCtx {
-  /** Distributed trace identifier for request correlation. */
-  traceId?: string;
-  /** Idempotency key for deduplication. */
-  idemKey?: string;
-  /** Organization context for multi-tenant operations. */
-  organizationId?: string | null;
-  /** Authenticated user ID. */
-  userId?: string | null;
-  /** Actor type making the request. */
-  actor?: Actor;
-  /** Channel the request originated from. */
-  channel?: Channel;
-  /** Roles assigned to the authenticated user. */
-  roles?: string[];
-  /** Policy engine for authorization decisions. */
-  decide?: PolicyDecider;
-  /** Rate limiter service (e.g., Redis-backed). */
-  rateLimit?: RateLimiter;
-  /** Telemetry tracker for metrics and events. */
-  telemetry?: TelemetryTracker;
-  /** Event publisher for domain events (outbox/bus). */
-  eventPublisher?: EventPublisher;
-  /** Secret provider for secure credential access. */
-  secretProvider?: SecretProvider;
-  /**
-   * Internal emit guard for enforcing declared event emissions.
-   * Populated by the executor runtime.
-   * @internal
-   */
-  __emitGuard__?: (key: string, version: string, payload: unknown) => Promise<void>;
-  /** Resolved application configuration for this execution. */
-  appConfig?: ResolvedAppConfig;
-  /** Resolved integration connections available to this execution. */
-  integrations?: ResolvedIntegration[];
-  /** Resolved knowledge spaces available to this execution. */
-  knowledge?: ResolvedKnowledge[];
-  /** Resolved branding context (logos, colors, etc.). */
-  branding?: ResolvedBranding;
-  /** Translation context with config and resolver. */
-  translation?: {
-    /** Resolved translation configuration. */config: ResolvedTranslation; /** Function to resolve translation keys. */
-    resolve?: TranslationResolver;
-  };
-  /** Spec variant resolver for A/B testing and experiments. */
-  specVariantResolver?: SpecVariantResolver;
-  /** Event registry for runtime event spec lookup. */
-  eventSpecResolver?: EventRegistry;
+export interface HandlerCtx {
+    /** Distributed trace identifier for request correlation. */
+    traceId?: string;
+    /** Idempotency key for deduplication. */
+    idemKey?: string;
+    /** Organization context for multi-tenant operations. */
+    organizationId?: string | null;
+    /** Authenticated user ID. */
+    userId?: string | null;
+    /** Actor type making the request. */
+    actor?: Actor;
+    /** Channel the request originated from. */
+    channel?: Channel;
+    /** Roles assigned to the authenticated user. */
+    roles?: string[];
+    /** Policy engine for authorization decisions. */
+    decide?: PolicyDecider;
+    /** Rate limiter service (e.g., Redis-backed). */
+    rateLimit?: RateLimiter;
+    /** Telemetry tracker for metrics and events. */
+    telemetry?: TelemetryTracker;
+    /** Event publisher for domain events (outbox/bus). */
+    eventPublisher?: EventPublisher;
+    /** Secret provider for secure credential access. */
+    secretProvider?: SecretProvider;
+    /**
+     * Internal emit guard for enforcing declared event emissions.
+     * Populated by the executor runtime.
+     * @internal
+     */
+    __emitGuard__?: (key: string, version: string, payload: unknown) => Promise<void>;
+    /** Resolved application configuration for this execution. */
+    appConfig?: ResolvedAppConfig;
+    /** Resolved integration connections available to this execution. */
+    integrations?: ResolvedIntegration[];
+    /** Resolved knowledge spaces available to this execution. */
+    knowledge?: ResolvedKnowledge[];
+    /** Resolved branding context (logos, colors, etc.). */
+    branding?: ResolvedBranding;
+    /** Translation context with config and resolver. */
+    translation?: {
+        /** Resolved translation configuration. */
+        config: ResolvedTranslation;
+        /** Function to resolve translation keys. */
+        resolve?: TranslationResolver;
+    };
+    /** Spec variant resolver for A/B testing and experiments. */
+    specVariantResolver?: SpecVariantResolver;
+    /** Event registry for runtime event spec lookup. */
+    eventSpecResolver?: EventRegistry;
 }
-//#endregion
-export { Actor, Channel, ContractSpecType, EventPublisher, FieldLevelDecision, HandlerCtx, PolicyDecider, PolicyDeciderInput, PolicyDecision, RateLimiter, TranslationResolver };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;;;;;GAMG;AACH,MAAM,MAAM,KAAK,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC;AAEnD;;;;;;;GAOG;AACH,MAAM,MAAM,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,IAAI,CAAC;AAEhE,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACV,mBAAmB,EACpB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAM9C;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GACxB,WAAW,GACX,OAAO,GACP,cAAc,GACd,SAAS,GACT,YAAY,GACZ,WAAW,GACX,MAAM,GACN,OAAO,GACP,WAAW,GACX,UAAU,GACV,YAAY,GACZ,aAAa,GACb,OAAO,GACP,WAAW,GACX,WAAW,GACX,SAAS,GACT,YAAY,GACZ,gBAAgB,GAChB,QAAQ,GACR,WAAW,GACX,MAAM,GACN,iBAAiB,CAAC;AAMtB;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,SAAS,CAAC,EAAE,IAAI,CACd,mBAAmB,EACnB,KAAK,GAAG,KAAK,GAAG,eAAe,GAAG,OAAO,CAC1C,CAAC;IACF,gDAAgD;IAChD,QAAQ,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IACjC,kCAAkC;IAClC,cAAc,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACtC,2BAA2B;IAC3B,GAAG,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IACxB,2CAA2C;IAC3C,gBAAgB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACvC,2CAA2C;IAC3C,WAAW,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,KAAK,EAAE,KAAK,CAAC;IACb,qCAAqC;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,0CAA0C;IAC1C,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAC1B,KAAK,EAAE,kBAAkB,KACtB,OAAO,CAAC,cAAc,CAAC,CAAC;AAE7B;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,CACxB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,KACR,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,GAAG,EAAE,UAAU,EACf,MAAM,CAAC,EAAE,MAAM,KACZ,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;AAE5C;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE;IACtC,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAMpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,WAAW,UAAU;IACzB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,qCAAqC;IACrC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,2CAA2C;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjB,iDAAiD;IACjD,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,iDAAiD;IACjD,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,gDAAgD;IAChD,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,sDAAsD;IACtD,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,oDAAoD;IACpD,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;;;OAIG;IACH,aAAa,CAAC,EAAE,CACd,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,KACb,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,oEAAoE;IACpE,YAAY,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACrC,6DAA6D;IAC7D,SAAS,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAChC,uDAAuD;IACvD,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,oDAAoD;IACpD,WAAW,CAAC,EAAE;QACZ,0CAA0C;QAC1C,MAAM,EAAE,mBAAmB,CAAC;QAC5B,4CAA4C;QAC5C,OAAO,CAAC,EAAE,mBAAmB,CAAC;KAC/B,CAAC;IACF,6DAA6D;IAC7D,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,oDAAoD;IACpD,iBAAiB,CAAC,EAAE,aAAa,CAAC;CACnC"}

package/dist/types.js

@@ -0,0 +1 @@
+// @bun

package/dist/versioning/index.d.ts

@@ -1,4 +1,10 @@
-import { OptionalVersionedSpecRef, SpecKeyRef, VersionedSpecRef, createKeyRef, createOptionalRef, createVersionedRef, formatVersionedRefKey, isOptionalVersionedSpecRef, isSpecKeyRef, isVersionedSpecRef, parseVersionedRefKey } from "./refs.js";
-import { ChangeEntry, ChangeType, ChangelogDocBlock, ChangelogEntry, ChangelogJsonExport, ChangelogResult, SemanticVersion, VersionAnalysis, VersionAnalysisResult, VersionBumpType, isChangeType, isChangelogDocBlock, isVersionBumpType } from "./types.js";
-import { bumpVersion, compareVersions, determineBumpType, formatVersion, getBumpTypePriority, getMaxBumpType, isValidVersion, isVersionEqual, isVersionGreater, isVersionLess, parseVersion, parseVersionStrict, validateVersion } from "./utils.js";
-export { ChangeEntry, ChangeType, ChangelogDocBlock, ChangelogEntry, ChangelogJsonExport, ChangelogResult, OptionalVersionedSpecRef, SemanticVersion, SpecKeyRef, VersionAnalysis, VersionAnalysisResult, VersionBumpType, VersionedSpecRef, bumpVersion, compareVersions, createKeyRef, createOptionalRef, createVersionedRef, determineBumpType, formatVersion, formatVersionedRefKey, getBumpTypePriority, getMaxBumpType, isChangeType, isChangelogDocBlock, isOptionalVersionedSpecRef, isSpecKeyRef, isValidVersion, isVersionBumpType, isVersionEqual, isVersionGreater, isVersionLess, isVersionedSpecRef, parseVersion, parseVersionStrict, parseVersionedRefKey, validateVersion };
+/**
+ * Versioning module exports.
+ *
+ * Provides types and utilities for semantic versioning,
+ * changelog management, version analysis, and spec references.
+ */
+export * from './refs';
+export * from './types';
+export * from './utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/versioning/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/versioning/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

package/dist/versioning/index.js

@@ -1,5 +1,274 @@
-import { createKeyRef, createOptionalRef, createVersionedRef, formatVersionedRefKey, isOptionalVersionedSpecRef, isSpecKeyRef, isVersionedSpecRef, parseVersionedRefKey } from "./refs.js";
-import { isChangeType, isChangelogDocBlock, isVersionBumpType } from "./types.js";
-import { bumpVersion, compareVersions, determineBumpType, formatVersion, getBumpTypePriority, getMaxBumpType, isValidVersion, isVersionEqual, isVersionGreater, isVersionLess, parseVersion, parseVersionStrict, validateVersion } from "./utils.js";
+// @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;
 
-export { bumpVersion, compareVersions, createKeyRef, createOptionalRef, createVersionedRef, determineBumpType, formatVersion, formatVersionedRefKey, getBumpTypePriority, getMaxBumpType, isChangeType, isChangelogDocBlock, isOptionalVersionedSpecRef, isSpecKeyRef, isValidVersion, isVersionBumpType, isVersionEqual, isVersionGreater, isVersionLess, isVersionedSpecRef, parseVersion, parseVersionStrict, parseVersionedRefKey, validateVersion };
+// src/versioning/refs.ts
+function isVersionedSpecRef(ref) {
+  return typeof ref === "object" && ref !== null && "key" in ref && typeof ref.key === "string" && ref.key.length > 0 && "version" in ref && typeof ref.version === "string" && ref.version.length > 0;
+}
+function isOptionalVersionedSpecRef(ref) {
+  if (typeof ref !== "object" || ref === null)
+    return false;
+  if (!("key" in ref))
+    return false;
+  if (typeof ref.key !== "string" || ref.key.length === 0) {
+    return false;
+  }
+  if ("version" in ref && ref.version != null) {
+    return typeof ref.version === "string";
+  }
+  return true;
+}
+function isSpecKeyRef(ref) {
+  return typeof ref === "object" && ref !== null && "key" in ref && typeof ref.key === "string" && ref.key.length > 0;
+}
+function createVersionedRef(key, version) {
+  if (!key || key.trim().length === 0) {
+    throw new Error("Spec key cannot be empty");
+  }
+  if (!version || version.trim().length === 0) {
+    throw new Error("Spec version cannot be empty");
+  }
+  return { key: key.trim(), version: version.trim() };
+}
+function createOptionalRef(key, version) {
+  if (!key || key.trim().length === 0) {
+    throw new Error("Spec key cannot be empty");
+  }
+  const ref = { key: key.trim() };
+  if (version != null && version.trim().length > 0) {
+    ref.version = version.trim();
+  }
+  return ref;
+}
+function createKeyRef(key) {
+  if (!key || key.trim().length === 0) {
+    throw new Error("Spec key cannot be empty");
+  }
+  return { key: key.trim() };
+}
+function formatVersionedRefKey(ref) {
+  return `${ref.key}.v${ref.version}`;
+}
+function parseVersionedRefKey(refKey) {
+  const match = refKey.match(/^(.+)\.v(\d+\.\d+\.\d+(?:-.+)?)$/);
+  if (!match)
+    return;
+  const key = match[1];
+  const version = match[2];
+  if (!key || !version)
+    return;
+  return { key, version };
+}
+
+// src/versioning/types.ts
+function isChangelogDocBlock(doc) {
+  return doc.kind === "changelog" && "specKey" in doc && "entries" in doc;
+}
+function isVersionBumpType(value) {
+  return value === "patch" || value === "minor" || value === "major";
+}
+function isChangeType(value) {
+  const validTypes = [
+    "added",
+    "changed",
+    "fixed",
+    "removed",
+    "deprecated",
+    "breaking",
+    "security"
+  ];
+  return typeof value === "string" && validTypes.includes(value);
+}
+
+// src/versioning/utils.ts
+var SEMVER_REGEX = /^(\d+)\.(\d+)\.(\d+)(?:-([a-zA-Z0-9]+(?:\.[a-zA-Z0-9]+)*))?(?:\+([a-zA-Z0-9]+(?:\.[a-zA-Z0-9]+)*))?$/;
+function parseVersion(version) {
+  const match = version.trim().match(SEMVER_REGEX);
+  if (!match) {
+    return null;
+  }
+  const majorStr = match[1];
+  const minorStr = match[2];
+  const patchStr = match[3];
+  const prerelease = match[4];
+  const build = match[5];
+  if (!majorStr || !minorStr || !patchStr) {
+    return null;
+  }
+  return {
+    major: parseInt(majorStr, 10),
+    minor: parseInt(minorStr, 10),
+    patch: parseInt(patchStr, 10),
+    ...prerelease && { prerelease },
+    ...build && { build }
+  };
+}
+function parseVersionStrict(version) {
+  const parsed = parseVersion(version);
+  if (!parsed) {
+    throw new Error(`Invalid semantic version: "${version}"`);
+  }
+  return parsed;
+}
+function formatVersion(version) {
+  let result = `${version.major}.${version.minor}.${version.patch}`;
+  if (version.prerelease) {
+    result += `-${version.prerelease}`;
+  }
+  if (version.build) {
+    result += `+${version.build}`;
+  }
+  return result;
+}
+function compareVersions(a, b) {
+  const versionA = parseVersionStrict(a);
+  const versionB = parseVersionStrict(b);
+  if (versionA.major !== versionB.major) {
+    return versionA.major > versionB.major ? 1 : -1;
+  }
+  if (versionA.minor !== versionB.minor) {
+    return versionA.minor > versionB.minor ? 1 : -1;
+  }
+  if (versionA.patch !== versionB.patch) {
+    return versionA.patch > versionB.patch ? 1 : -1;
+  }
+  if (versionA.prerelease && !versionB.prerelease) {
+    return -1;
+  }
+  if (!versionA.prerelease && versionB.prerelease) {
+    return 1;
+  }
+  if (versionA.prerelease && versionB.prerelease) {
+    return versionA.prerelease < versionB.prerelease ? -1 : versionA.prerelease > versionB.prerelease ? 1 : 0;
+  }
+  return 0;
+}
+function isVersionGreater(a, b) {
+  return compareVersions(a, b) === 1;
+}
+function isVersionLess(a, b) {
+  return compareVersions(a, b) === -1;
+}
+function isVersionEqual(a, b) {
+  return compareVersions(a, b) === 0;
+}
+function bumpVersion(current, bumpType) {
+  const version = parseVersionStrict(current);
+  switch (bumpType) {
+    case "major":
+      return formatVersion({
+        major: version.major + 1,
+        minor: 0,
+        patch: 0
+      });
+    case "minor":
+      return formatVersion({
+        major: version.major,
+        minor: version.minor + 1,
+        patch: 0
+      });
+    case "patch":
+      return formatVersion({
+        major: version.major,
+        minor: version.minor,
+        patch: version.patch + 1
+      });
+  }
+}
+function determineBumpType(hasBreaking, hasNonBreaking) {
+  if (hasBreaking) {
+    return "major";
+  }
+  if (hasNonBreaking) {
+    return "minor";
+  }
+  return "patch";
+}
+function getBumpTypePriority(bumpType) {
+  switch (bumpType) {
+    case "major":
+      return 3;
+    case "minor":
+      return 2;
+    case "patch":
+      return 1;
+  }
+}
+function getMaxBumpType(bumpTypes) {
+  if (bumpTypes.length === 0) {
+    return null;
+  }
+  return bumpTypes.reduce((max, current) => getBumpTypePriority(current) > getBumpTypePriority(max) ? current : max);
+}
+function isValidVersion(version) {
+  return parseVersion(version) !== null;
+}
+function validateVersion(version) {
+  const errors = [];
+  if (!version || typeof version !== "string") {
+    errors.push("Version must be a non-empty string");
+    return errors;
+  }
+  const trimmed = version.trim();
+  if (trimmed !== version) {
+    errors.push("Version should not have leading or trailing whitespace");
+  }
+  if (!parseVersion(trimmed)) {
+    errors.push(`Invalid semantic version format: "${version}". Expected format: MAJOR.MINOR.PATCH[-prerelease][+build]`);
+  }
+  return errors;
+}
+export {
+  validateVersion,
+  parseVersionedRefKey,
+  parseVersionStrict,
+  parseVersion,
+  isVersionedSpecRef,
+  isVersionLess,
+  isVersionGreater,
+  isVersionEqual,
+  isVersionBumpType,
+  isValidVersion,
+  isSpecKeyRef,
+  isOptionalVersionedSpecRef,
+  isChangelogDocBlock,
+  isChangeType,
+  getMaxBumpType,
+  getBumpTypePriority,
+  formatVersionedRefKey,
+  formatVersion,
+  determineBumpType,
+  createVersionedRef,
+  createOptionalRef,
+  createKeyRef,
+  compareVersions,
+  bumpVersion
+};