autotel-pact 0.2.0

package/dist/auto-wrap.cjs

@@ -0,0 +1,255 @@
+'use strict';
+
+var autotel = require('autotel');
+var module$1 = require('module');
+var fs = require('fs');
+require('fs/promises');
+var path = require('path');
+
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var path__default = /*#__PURE__*/_interopDefault(path);
+
+// src/auto-wrap.ts
+
+// src/attrs.ts
+var PACT_ATTRS = {
+  CONSUMER: "pact.consumer",
+  PROVIDER: "pact.provider",
+  KIND: "pact.kind",
+  INTERACTION_DESCRIPTION: "pact.interaction.description",
+  INTERACTION_ID: "pact.interaction.id",
+  INTERACTION_STATES: "pact.interaction.states",
+  CONTRACT_FILE: "pact.contract.file",
+  OUTCOME: "pact.outcome"
+};
+function buildPactAttributes(meta, opts = {}) {
+  const attrs = {
+    [PACT_ATTRS.CONSUMER]: meta.consumer,
+    [PACT_ATTRS.PROVIDER]: meta.provider,
+    [PACT_ATTRS.KIND]: meta.kind,
+    [PACT_ATTRS.INTERACTION_DESCRIPTION]: meta.description,
+    [PACT_ATTRS.INTERACTION_STATES]: meta.states
+  };
+  if (opts.contractFile) {
+    attrs[PACT_ATTRS.CONTRACT_FILE] = opts.contractFile;
+  }
+  if (meta.interactionId) {
+    attrs[PACT_ATTRS.INTERACTION_ID] = meta.interactionId;
+  }
+  return attrs;
+}
+function outcomeAttribute(outcome) {
+  return { [PACT_ATTRS.OUTCOME]: outcome };
+}
+
+// src/types.ts
+var LEDGER_ENTRY_SPEC = "autotel-pact-ledger-entry/v0.2.0";
+
+// src/ledger.ts
+var DEFAULT_DIR = ".autotel-pact";
+function resolveLedgerDir(opts = {}) {
+  return path__default.default.resolve(process.cwd(), opts.dir ?? process.env.AUTOTEL_PACT_LEDGER_DIR ?? DEFAULT_DIR);
+}
+function resolveRunId(opts = {}) {
+  const explicit = opts.runId ?? process.env.AUTOTEL_PACT_RUN_ID;
+  if (explicit) return explicit;
+  return `local-${(/* @__PURE__ */ new Date()).toISOString().replaceAll(/[:.]/g, "-")}`;
+}
+function ledgerPath(opts = {}) {
+  const dir = resolveLedgerDir(opts);
+  return path__default.default.join(dir, `ledger-${resolveRunId(opts)}.jsonl`);
+}
+function writeLine(filePath, entry) {
+  fs.mkdirSync(path__default.default.dirname(filePath), { recursive: true });
+  fs.appendFileSync(filePath, JSON.stringify(entry) + "\n", "utf8");
+}
+function appendLedgerEntry(entry, opts = {}) {
+  const filePath = ledgerPath(opts);
+  const normalized = entry.type === "provider_verification_run" ? entry : { ...entry, spec: LEDGER_ENTRY_SPEC, type: "interaction" };
+  writeLine(filePath, normalized);
+}
+Promise.resolve();
+
+// src/auto-wrap.ts
+var INSTALLED = /* @__PURE__ */ Symbol.for("autotel-pact:auto-wrap-installed");
+function installAutoWrap(pactModule) {
+  const pactJs = pactModule ?? loadPactJs();
+  if (!pactJs) return false;
+  patchMessagePact(pactJs);
+  patchHttpPact(pactJs);
+  return true;
+}
+function loadPactJs() {
+  try {
+    const require2 = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('auto-wrap.cjs', document.baseURI).href)));
+    return require2("@pact-foundation/pact");
+  } catch {
+    process.stderr.write(
+      "autotel-pact/auto-wrap: @pact-foundation/pact not installed \u2014 skipping.\n"
+    );
+    return void 0;
+  }
+}
+function patchMessagePact(mod) {
+  const ctor = mod.MessageConsumerPact;
+  if (!ctor) return;
+  const proto = ctor.prototype;
+  if (proto[INSTALLED]) return;
+  const originalVerify = proto.verify;
+  proto.verify = async function patchedVerify(handler) {
+    const start = process.hrtime.bigint();
+    let captured;
+    const consumer = this.config?.consumer ?? "<unknown>";
+    const provider = this.config?.provider ?? "<unknown>";
+    return autotel.span("pact.interaction", async (span) => {
+      span.setAttributes({
+        "pact.consumer": consumer,
+        "pact.provider": provider,
+        "pact.kind": "message"
+      });
+      try {
+        const result = await originalVerify.call(this, async (reified) => {
+          captured = reified;
+          const meta = {
+            consumer,
+            provider,
+            description: reified.description ?? "<unknown>",
+            states: (reified.providerStates ?? []).map((s) => s.name),
+            kind: "message"
+          };
+          span.setAttributes(buildPactAttributes(meta));
+          return handler(reified);
+        });
+        span.setAttributes(outcomeAttribute("passed"));
+        writeAutoLedgerEntry({
+          consumer,
+          provider,
+          interaction: captured?.description ?? "<unknown>",
+          states: (captured?.providerStates ?? []).map((s) => s.name),
+          kind: "message",
+          outcome: "passed",
+          start
+        });
+        return result;
+      } catch (error) {
+        span.setAttributes(outcomeAttribute("failed"));
+        writeAutoLedgerEntry({
+          consumer,
+          provider,
+          interaction: captured?.description ?? "<unknown>",
+          states: (captured?.providerStates ?? []).map((s) => s.name),
+          kind: "message",
+          outcome: "failed",
+          start,
+          error: error instanceof Error ? error.message : String(error)
+        });
+        throw error;
+      }
+    });
+  };
+  proto[INSTALLED] = true;
+}
+function patchHttpPact(mod) {
+  const ctor = mod.PactV3;
+  if (!ctor) return;
+  const proto = ctor.prototype;
+  if (proto[INSTALLED]) return;
+  const tracked = /* @__PURE__ */ new WeakMap();
+  const originalAdd = proto.addInteraction;
+  proto.addInteraction = function patchedAddInteraction(interaction) {
+    const list = tracked.get(this) ?? [];
+    list.push(interaction);
+    tracked.set(this, list);
+    return originalAdd.call(this, interaction);
+  };
+  const originalExecute = proto.executeTest;
+  proto.executeTest = async function patchedExecuteTest(fn) {
+    const start = process.hrtime.bigint();
+    const consumer = this.opts?.consumer ?? "<unknown>";
+    const provider = this.opts?.provider ?? "<unknown>";
+    const interactions = tracked.get(this) ?? [];
+    tracked.set(this, []);
+    return autotel.span("pact.interaction", async (span) => {
+      span.setAttributes({
+        "pact.consumer": consumer,
+        "pact.provider": provider,
+        "pact.kind": "http"
+      });
+      const first = interactions[0];
+      if (first) {
+        span.setAttributes(
+          buildPactAttributes({
+            consumer,
+            provider,
+            description: first.uponReceiving,
+            states: (first.states ?? []).map((s) => s.description),
+            kind: "http"
+          })
+        );
+      }
+      try {
+        const result = await originalExecute.call(this, fn);
+        span.setAttributes(outcomeAttribute("passed"));
+        for (const i of interactions) {
+          writeAutoLedgerEntry({
+            consumer,
+            provider,
+            interaction: i.uponReceiving,
+            states: (i.states ?? []).map((s) => s.description),
+            kind: "http",
+            outcome: "passed",
+            start
+          });
+        }
+        return result;
+      } catch (error_) {
+        span.setAttributes(outcomeAttribute("failed"));
+        const error = error_ instanceof Error ? error_.message : String(error_);
+        for (const i of interactions) {
+          writeAutoLedgerEntry({
+            consumer,
+            provider,
+            interaction: i.uponReceiving,
+            states: (i.states ?? []).map((s) => s.description),
+            kind: "http",
+            outcome: "failed",
+            start,
+            error
+          });
+        }
+        throw error_;
+      }
+    });
+  };
+  proto[INSTALLED] = true;
+}
+function writeAutoLedgerEntry(args) {
+  const ctx = autotel.getActiveSpan()?.spanContext();
+  const entry = {
+    type: "interaction",
+    spec: LEDGER_ENTRY_SPEC,
+    consumer: args.consumer,
+    provider: args.provider,
+    interaction: args.interaction,
+    states: args.states,
+    kind: args.kind,
+    source: "test",
+    role: "consumer",
+    outcome: args.outcome,
+    duration_ms: Number(process.hrtime.bigint() - args.start) / 1e6,
+    observed_at: (/* @__PURE__ */ new Date()).toISOString(),
+    trace_id: ctx?.traceId,
+    span_id: ctx?.spanId,
+    run_id: process.env.AUTOTEL_PACT_RUN_ID,
+    git_sha: process.env.GIT_SHA ?? process.env.GITHUB_SHA,
+    error: args.error
+  };
+  appendLedgerEntry(entry);
+}
+installAutoWrap();
+
+exports.installAutoWrap = installAutoWrap;
+//# sourceMappingURL=auto-wrap.cjs.map
+//# sourceMappingURL=auto-wrap.cjs.map

package/dist/auto-wrap.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/attrs.ts","../src/types.ts","../src/ledger.ts","../src/auto-wrap.ts"],"names":["path","mkdirSync","appendFileSync","require","createRequire","autotelSpan","getActiveSpan"],"mappings":"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","file":"auto-wrap.cjs","sourcesContent":["import type { PactInteractionMeta, PactOutcome } from './types.js';\n\n/**\n * Attribute keys for Pact interactions. Centralised so the namespace is\n * a single source of truth and is forward-compatible with eventual OTel\n * semantic conventions.\n */\nexport const PACT_ATTRS = {\n  CONSUMER: 'pact.consumer',\n  PROVIDER: 'pact.provider',\n  KIND: 'pact.kind',\n  INTERACTION_DESCRIPTION: 'pact.interaction.description',\n  INTERACTION_ID: 'pact.interaction.id',\n  INTERACTION_STATES: 'pact.interaction.states',\n  CONTRACT_FILE: 'pact.contract.file',\n  OUTCOME: 'pact.outcome',\n} as const;\n\nexport type PactAttributeKey = (typeof PACT_ATTRS)[keyof typeof PACT_ATTRS];\n\n/**\n * Build the set of attributes to stamp on a span when an interaction is\n * about to be exercised. `outcome` is added later by the wrapper.\n */\nexport function buildPactAttributes(\n  meta: PactInteractionMeta,\n  opts: { contractFile?: string } = {},\n): Record<string, string | string[]> {\n  const attrs: Record<string, string | string[]> = {\n    [PACT_ATTRS.CONSUMER]: meta.consumer,\n    [PACT_ATTRS.PROVIDER]: meta.provider,\n    [PACT_ATTRS.KIND]: meta.kind,\n    [PACT_ATTRS.INTERACTION_DESCRIPTION]: meta.description,\n    [PACT_ATTRS.INTERACTION_STATES]: meta.states,\n  };\n  if (opts.contractFile) {\n    attrs[PACT_ATTRS.CONTRACT_FILE] = opts.contractFile;\n  }\n  if (meta.interactionId) {\n    attrs[PACT_ATTRS.INTERACTION_ID] = meta.interactionId;\n  }\n  return attrs;\n}\n\n/**\n * Helper that returns just the outcome attribute — stamped after the\n * handler resolves or rejects.\n */\nexport function outcomeAttribute(\n  outcome: PactOutcome,\n): Record<string, string> {\n  return { [PACT_ATTRS.OUTCOME]: outcome };\n}\n","/**\n * Kind of contract interaction observed.\n */\nexport type PactKind = 'message' | 'http';\n\nexport type PactOutcome = 'passed' | 'failed';\n\nexport type LedgerSource = 'test' | 'production';\nexport type LedgerRole = 'consumer' | 'provider';\n\nexport const LEDGER_ENTRY_SPEC = 'autotel-pact-ledger-entry/v0.2.0';\nexport const AUDIT_MATRIX_SPEC = 'autotel-pact-audit-matrix/v0.2.0';\n\n/**\n * Metadata about a single Pact interaction, derived from the reified message\n * plus the consumer/provider config. Stamped onto the span and the ledger entry.\n */\nexport interface PactInteractionMeta {\n  consumer: string;\n  provider: string;\n  description: string;\n  states: string[];\n  kind: PactKind;\n  interactionId?: string;\n}\n\n/**\n * Per-interaction ledger evidence (consumer exercise, provider verify, or production tag).\n */\nexport interface InteractionLedgerEntry {\n  type?: 'interaction';\n  spec: typeof LEDGER_ENTRY_SPEC;\n  consumer: string;\n  provider: string;\n  interaction: string;\n  interaction_id?: string;\n  states: string[];\n  kind: PactKind;\n  outcome: PactOutcome;\n  source: LedgerSource;\n  role: LedgerRole;\n  duration_ms: number;\n  observed_at: string;\n  trace_id?: string;\n  span_id?: string;\n  run_id?: string;\n  git_sha?: string;\n  error?: string;\n}\n\n/**\n * Run-level provider verification failure — does not imply per-interaction outcomes.\n */\nexport interface ProviderVerificationRunEntry {\n  type: 'provider_verification_run';\n  spec: typeof LEDGER_ENTRY_SPEC;\n  consumer: string;\n  provider: string;\n  outcome: 'failed';\n  source: LedgerSource;\n  role: 'provider';\n  observed_at: string;\n  error: string;\n  run_id?: string;\n  git_sha?: string;\n  trace_id?: string;\n  span_id?: string;\n}\n\nexport type LedgerRecord = InteractionLedgerEntry | ProviderVerificationRunEntry;\n\nexport function isInteractionLedgerEntry(\n  entry: LedgerRecord,\n): entry is InteractionLedgerEntry {\n  return entry.type !== 'provider_verification_run';\n}\n\nexport function isProviderVerificationRun(\n  entry: LedgerRecord,\n): entry is ProviderVerificationRunEntry {\n  return entry.type === 'provider_verification_run';\n}\n\n/**\n * Shape of a Pact contract file on disk (subset we read).\n */\nexport interface PactFile {\n  consumer: { name: string };\n  provider: { name: string };\n  messages?: Array<{\n    description: string;\n    providerStates?: Array<{ name: string }>;\n    metadata?: Record<string, unknown>;\n  }>;\n  interactions?: Array<{\n    description: string;\n    providerStates?: Array<{ name: string }>;\n    metadata?: Record<string, unknown>;\n  }>;\n}\n\nexport interface BrokerVerification {\n  consumer: string;\n  provider: string;\n  success: boolean;\n  verifiedAt?: string;\n  /**\n   * Populated when the broker could not be reached or returned a non-2xx\n   * response. Distinguishes \"broker said the pact is not verified\" (no error)\n   * from \"we could not determine verification status\" (error set).\n   */\n  error?: string;\n}\n\n/**\n * One row in the audit matrix.\n */\nexport interface AuditRow {\n  consumer: string;\n  provider: string;\n  interaction: string;\n  interaction_id?: string;\n  kind: PactKind;\n  contracted: boolean;\n  /** Any interaction-level ledger hit in the window (test or production). */\n  observed: boolean;\n  test_seen: boolean;\n  prod_seen: boolean;\n  provider_verified: boolean;\n  broker_verified: boolean;\n  broker_verified_at?: string;\n  /** Set when the broker check failed (network error, non-2xx, parse error). */\n  broker_error?: string;\n  last_observed_at?: string;\n  last_outcome?: PactOutcome;\n}\n\nexport interface AuditMatrix {\n  spec: typeof AUDIT_MATRIX_SPEC;\n  rows: AuditRow[];\n  counts: {\n    total: number;\n    /** Any contracted row. */\n    contracted: number;\n    /** Any row with test_seen OR prod_seen. */\n    observed: number;\n    /** Contracted AND seen in a consumer test. */\n    contracted_and_test_seen: number;\n    /** Contracted but not seen in a consumer test (stale confidence). */\n    contracted_not_test_seen: number;\n    /** Seen (test or production) without a matching contract (ungoverned flow). */\n    test_or_prod_seen_not_contracted: number;\n    test_seen: number;\n    prod_seen: number;\n    provider_verified: number;\n    broker_verified: number;\n  };\n  window_days: number;\n  generated_at: string;\n  verification_failures?: ProviderVerificationRunEntry[];\n}\n\nexport interface PactInteractionKey {\n  consumer: string;\n  provider: string;\n  interaction: string;\n  kind: PactKind;\n  interactionId?: string;\n}\n","import {\n  appendFileSync,\n  mkdirSync,\n  readdirSync,\n  readFileSync,\n  existsSync,\n} from 'node:fs';\nimport { appendFile, mkdir } from 'node:fs/promises';\nimport path from 'node:path';\nimport { normalizeLedgerRecord } from './ledger-normalize.js';\nimport { LEDGER_ENTRY_SPEC, type LedgerRecord } from './types.js';\n\nexport interface LedgerOptions {\n  dir?: string;\n  runId?: string;\n}\n\nconst DEFAULT_DIR = '.autotel-pact';\n\nfunction resolveLedgerDir(opts: LedgerOptions = {}): string {\n  return path.resolve(process.cwd(), opts.dir ?? process.env.AUTOTEL_PACT_LEDGER_DIR ?? DEFAULT_DIR);\n}\n\nfunction resolveRunId(opts: LedgerOptions = {}): string {\n  const explicit = opts.runId ?? process.env.AUTOTEL_PACT_RUN_ID;\n  if (explicit) return explicit;\n  return `local-${new Date().toISOString().replaceAll(/[:.]/g, '-')}`;\n}\n\nexport function ledgerPath(opts: LedgerOptions = {}): string {\n  const dir = resolveLedgerDir(opts);\n  return path.join(dir, `ledger-${resolveRunId(opts)}.jsonl`);\n}\n\nfunction writeLine(filePath: string, entry: LedgerRecord): void {\n  mkdirSync(path.dirname(filePath), { recursive: true });\n  appendFileSync(filePath, JSON.stringify(entry) + '\\n', 'utf8');\n}\n\n/**\n * Append a ledger record synchronously (tests and consumer wrappers).\n */\nexport function appendLedgerEntry(\n  entry: LedgerRecord,\n  opts: LedgerOptions = {},\n): void {\n  const filePath = ledgerPath(opts);\n  const normalized: LedgerRecord =\n    entry.type === 'provider_verification_run'\n      ? entry\n      : { ...entry, spec: LEDGER_ENTRY_SPEC, type: 'interaction' as const };\n  writeLine(filePath, normalized);\n}\n\nexport function appendProviderVerificationFailure(\n  entry: Omit<\n    import('./types.js').ProviderVerificationRunEntry,\n    'type' | 'spec' | 'outcome' | 'role'\n  > & { error: string },\n  opts: LedgerOptions = {},\n): void {\n  appendLedgerEntry(\n    {\n      type: 'provider_verification_run',\n      spec: LEDGER_ENTRY_SPEC,\n      outcome: 'failed',\n      role: 'provider',\n      source: entry.source ?? 'test',\n      consumer: entry.consumer,\n      provider: entry.provider,\n      observed_at: entry.observed_at,\n      error: entry.error,\n      run_id: entry.run_id,\n      git_sha: entry.git_sha,\n      trace_id: entry.trace_id,\n      span_id: entry.span_id,\n    },\n    opts,\n  );\n}\n\n/**\n * Read all ledger files and return normalized records.\n */\nexport function readLedger(opts: LedgerOptions = {}): LedgerRecord[] {\n  const dir = resolveLedgerDir(opts);\n  if (!existsSync(dir)) return [];\n  const files = readdirSync(dir).filter((f) => f.endsWith('.jsonl'));\n  const entries: LedgerRecord[] = [];\n  for (const file of files) {\n    const text = readFileSync(path.join(dir, file), 'utf8');\n    for (const line of text.split('\\n')) {\n      if (!line.trim()) continue;\n      try {\n        const normalized = normalizeLedgerRecord(JSON.parse(line));\n        if (normalized) entries.push(normalized);\n      } catch {\n        // skip malformed lines\n      }\n    }\n  }\n  return entries;\n}\n\n/**\n * Serialized async writes for production span processor.\n * Bounded by a producer-side backpressure threshold: once `pendingWrites`\n * reaches `MAX_PENDING_WRITES`, new callers await drainage before queueing,\n * so memory cannot grow unbounded under sustained pressure.\n */\nconst MAX_PENDING_WRITES = 4096;\nlet asyncWriteChain: Promise<void> = Promise.resolve();\nlet pendingWrites = 0;\n\nexport async function appendLedgerEntryAsync(\n  entry: LedgerRecord,\n  opts: LedgerOptions = {},\n): Promise<void> {\n  if (pendingWrites >= MAX_PENDING_WRITES) {\n    await asyncWriteChain;\n  }\n\n  const filePath = ledgerPath(opts);\n  const normalized: LedgerRecord =\n    entry.type === 'provider_verification_run'\n      ? entry\n      : { ...entry, spec: LEDGER_ENTRY_SPEC, type: 'interaction' as const };\n  const line = JSON.stringify(normalized);\n\n  pendingWrites++;\n  const run = asyncWriteChain.then(async () => {\n    try {\n      await mkdir(path.dirname(filePath), { recursive: true });\n      await appendFile(filePath, line + '\\n', 'utf8');\n    } finally {\n      pendingWrites--;\n    }\n  });\n  asyncWriteChain = run.catch(() => {});\n  return run;\n}\n\nexport async function flushLedgerWrites(): Promise<void> {\n  await asyncWriteChain;\n}\n\n/** @internal Reset async chain between tests. */\nexport function resetLedgerWriteChainForTests(): void {\n  asyncWriteChain = Promise.resolve();\n  pendingWrites = 0;\n}\n\n/** @internal Expose pending write count for tests. */\nexport function pendingLedgerWriteCount(): number {\n  return pendingWrites;\n}\n","/**\n * Auto-wrap entry for vitest / jest setup files.\n *\n * Importing this module monkey-patches `@pact-foundation/pact`'s\n * `MessageConsumerPact.prototype.verify` and `PactV3.prototype.executeTest`\n * so every contract test in the project records a ledger entry without\n * users having to wrap each call by hand.\n *\n * Usage (vitest):\n *\n * ```ts\n * // vitest.config.ts\n * import { defineConfig } from 'vitest/config';\n * export default defineConfig({\n *   test: { setupFiles: ['autotel-pact/auto-wrap'] },\n * });\n * ```\n *\n * Usage (jest):\n *\n * ```js\n * // jest.config.js\n * module.exports = { setupFilesAfterEach: ['autotel-pact/auto-wrap'] };\n * ```\n *\n * Configuration is via environment variables — there's no API surface,\n * because setup files don't get parameters:\n *\n * - `AUTOTEL_PACT_RUN_ID` — tag every ledger entry with this run id\n * - `AUTOTEL_PACT_LEDGER_DIR` — override the default `.autotel-pact/` dir\n *\n * Idempotent: importing twice is a no-op.\n *\n * Safe when Pact-JS isn't installed: logs a single warning and exits\n * cleanly. The same setup file can stay in place for a repo whose\n * non-contract test packages don't have Pact as a dependency.\n */\n\nimport { span as autotelSpan, getActiveSpan } from 'autotel';\nimport { createRequire } from 'node:module';\nimport { buildPactAttributes, outcomeAttribute } from './attrs.js';\nimport { appendLedgerEntry } from './ledger.js';\nimport { LEDGER_ENTRY_SPEC, type InteractionLedgerEntry, type PactInteractionMeta } from './types.js';\nimport type { HttpInteraction } from './wrapper-http.js';\nimport type { ReifiedMessage } from './wrapper.js';\n\nconst INSTALLED = Symbol.for('autotel-pact:auto-wrap-installed');\n\ninterface PactJsModule {\n  MessageConsumerPact?: { prototype: Record<string | symbol, unknown> };\n  PactV3?: { prototype: Record<string | symbol, unknown> };\n}\n\n/**\n * Install the auto-wrap. Called at module load when this file is imported.\n * Exposed for tests + explicit-invocation users.\n *\n * @param pactModule Override Pact-JS resolution. When omitted, requires\n *   `@pact-foundation/pact` from disk. Tests can pass synthetic classes.\n *\n * Returns `true` if Pact-JS was found and patched, `false` otherwise.\n */\nexport function installAutoWrap(pactModule?: PactJsModule): boolean {\n  const pactJs = pactModule ?? loadPactJs();\n  if (!pactJs) return false;\n\n  patchMessagePact(pactJs);\n  patchHttpPact(pactJs);\n  return true;\n}\n\nfunction loadPactJs(): PactJsModule | undefined {\n  try {\n    // Use createRequire so we work from both ESM and CJS without\n    // pulling Pact-JS into the dynamic import graph.\n    const require = createRequire(import.meta.url);\n    return require('@pact-foundation/pact') as PactJsModule;\n  } catch {\n    process.stderr.write(\n      'autotel-pact/auto-wrap: @pact-foundation/pact not installed — skipping.\\n',\n    );\n    return undefined;\n  }\n}\n\nfunction patchMessagePact(mod: PactJsModule): void {\n  const ctor = mod.MessageConsumerPact;\n  if (!ctor) return;\n  const proto = ctor.prototype;\n  if (proto[INSTALLED]) return;\n\n  const originalVerify = proto.verify as (\n    handler: (m: ReifiedMessage) => Promise<unknown>,\n  ) => Promise<unknown>;\n\n  proto.verify = async function patchedVerify(\n    this: { config: { consumer: string; provider: string } },\n    handler: (m: ReifiedMessage) => Promise<unknown>,\n  ): Promise<unknown> {\n    const start = process.hrtime.bigint();\n    let captured: ReifiedMessage | undefined;\n    const consumer = this.config?.consumer ?? '<unknown>';\n    const provider = this.config?.provider ?? '<unknown>';\n\n    return autotelSpan('pact.interaction', async (span) => {\n      span.setAttributes({\n        'pact.consumer': consumer,\n        'pact.provider': provider,\n        'pact.kind': 'message',\n      });\n\n      try {\n        const result = await originalVerify.call(this, async (reified) => {\n          captured = reified;\n          const meta: PactInteractionMeta = {\n            consumer,\n            provider,\n            description: reified.description ?? '<unknown>',\n            states: (reified.providerStates ?? []).map((s) => s.name),\n            kind: 'message',\n          };\n          span.setAttributes(buildPactAttributes(meta));\n          return handler(reified);\n        });\n        span.setAttributes(outcomeAttribute('passed'));\n        writeAutoLedgerEntry({\n          consumer,\n          provider,\n          interaction: captured?.description ?? '<unknown>',\n          states: (captured?.providerStates ?? []).map((s) => s.name),\n          kind: 'message',\n          outcome: 'passed',\n          start,\n        });\n        return result;\n      } catch (error) {\n        span.setAttributes(outcomeAttribute('failed'));\n        writeAutoLedgerEntry({\n          consumer,\n          provider,\n          interaction: captured?.description ?? '<unknown>',\n          states: (captured?.providerStates ?? []).map((s) => s.name),\n          kind: 'message',\n          outcome: 'failed',\n          start,\n          error: error instanceof Error ? error.message : String(error),\n        });\n        throw error;\n      }\n    });\n  };\n\n  proto[INSTALLED] = true;\n}\n\nfunction patchHttpPact(mod: PactJsModule): void {\n  const ctor = mod.PactV3;\n  if (!ctor) return;\n  const proto = ctor.prototype;\n  if (proto[INSTALLED]) return;\n\n  // Track interactions added to each PactV3 instance. Cleared after\n  // executeTest emits ledger entries for them, so the same instance can\n  // be reused across multiple test cases.\n  const tracked = new WeakMap<object, HttpInteraction[]>();\n\n  const originalAdd = proto.addInteraction as (i: HttpInteraction) => unknown;\n  proto.addInteraction = function patchedAddInteraction(this: object, interaction: HttpInteraction) {\n    const list = tracked.get(this) ?? [];\n    list.push(interaction);\n    tracked.set(this, list);\n    return originalAdd.call(this, interaction);\n  };\n\n  const originalExecute = proto.executeTest as <T>(\n    fn: (server: { url: string; port: number }) => Promise<T>,\n  ) => Promise<T | undefined>;\n\n  proto.executeTest = async function patchedExecuteTest<T>(\n    this: { opts?: { consumer?: string; provider?: string } },\n    fn: (server: { url: string; port: number }) => Promise<T>,\n  ): Promise<T | undefined> {\n    const start = process.hrtime.bigint();\n    const consumer = this.opts?.consumer ?? '<unknown>';\n    const provider = this.opts?.provider ?? '<unknown>';\n    const interactions = tracked.get(this) ?? [];\n    tracked.set(this, []);\n\n    return autotelSpan('pact.interaction', async (span) => {\n      span.setAttributes({\n        'pact.consumer': consumer,\n        'pact.provider': provider,\n        'pact.kind': 'http',\n      });\n      // If multiple interactions were added before executeTest, the span\n      // attributes describe the first; ledger entries are still written\n      // for each. Most real tests use one interaction per executeTest.\n      const first = interactions[0];\n      if (first) {\n        span.setAttributes(\n          buildPactAttributes({\n            consumer,\n            provider,\n            description: first.uponReceiving,\n            states: (first.states ?? []).map((s) => s.description),\n            kind: 'http',\n          }),\n        );\n      }\n\n      try {\n        const result = (await originalExecute.call(this, fn)) as T | undefined;\n        span.setAttributes(outcomeAttribute('passed'));\n        for (const i of interactions) {\n          writeAutoLedgerEntry({\n            consumer,\n            provider,\n            interaction: i.uponReceiving,\n            states: (i.states ?? []).map((s) => s.description),\n            kind: 'http',\n            outcome: 'passed',\n            start,\n          });\n        }\n        return result;\n      } catch (error_) {\n        span.setAttributes(outcomeAttribute('failed'));\n        const error = error_ instanceof Error ? error_.message : String(error_);\n        for (const i of interactions) {\n          writeAutoLedgerEntry({\n            consumer,\n            provider,\n            interaction: i.uponReceiving,\n            states: (i.states ?? []).map((s) => s.description),\n            kind: 'http',\n            outcome: 'failed',\n            start,\n            error,\n          });\n        }\n        throw error_;\n      }\n    });\n  };\n\n  proto[INSTALLED] = true;\n}\n\nfunction writeAutoLedgerEntry(args: {\n  consumer: string;\n  provider: string;\n  interaction: string;\n  states: string[];\n  kind: 'message' | 'http';\n  outcome: 'passed' | 'failed';\n  start: bigint;\n  error?: string;\n}): void {\n  const ctx = getActiveSpan()?.spanContext();\n  const entry: InteractionLedgerEntry = {\n    type: 'interaction',\n    spec: LEDGER_ENTRY_SPEC,\n    consumer: args.consumer,\n    provider: args.provider,\n    interaction: args.interaction,\n    states: args.states,\n    kind: args.kind,\n    source: 'test',\n    role: 'consumer',\n    outcome: args.outcome,\n    duration_ms: Number(process.hrtime.bigint() - args.start) / 1e6,\n    observed_at: new Date().toISOString(),\n    trace_id: ctx?.traceId,\n    span_id: ctx?.spanId,\n    run_id: process.env.AUTOTEL_PACT_RUN_ID,\n    git_sha: process.env.GIT_SHA ?? process.env.GITHUB_SHA,\n    error: args.error,\n  };\n  appendLedgerEntry(entry);\n}\n\n// Install on import — this file is meant to be loaded once as a setup file.\ninstallAutoWrap();\n"]}

package/dist/auto-wrap.d.cts

@@ -0,0 +1,57 @@
+/**
+ * Auto-wrap entry for vitest / jest setup files.
+ *
+ * Importing this module monkey-patches `@pact-foundation/pact`'s
+ * `MessageConsumerPact.prototype.verify` and `PactV3.prototype.executeTest`
+ * so every contract test in the project records a ledger entry without
+ * users having to wrap each call by hand.
+ *
+ * Usage (vitest):
+ *
+ * ```ts
+ * // vitest.config.ts
+ * import { defineConfig } from 'vitest/config';
+ * export default defineConfig({
+ *   test: { setupFiles: ['autotel-pact/auto-wrap'] },
+ * });
+ * ```
+ *
+ * Usage (jest):
+ *
+ * ```js
+ * // jest.config.js
+ * module.exports = { setupFilesAfterEach: ['autotel-pact/auto-wrap'] };
+ * ```
+ *
+ * Configuration is via environment variables — there's no API surface,
+ * because setup files don't get parameters:
+ *
+ * - `AUTOTEL_PACT_RUN_ID` — tag every ledger entry with this run id
+ * - `AUTOTEL_PACT_LEDGER_DIR` — override the default `.autotel-pact/` dir
+ *
+ * Idempotent: importing twice is a no-op.
+ *
+ * Safe when Pact-JS isn't installed: logs a single warning and exits
+ * cleanly. The same setup file can stay in place for a repo whose
+ * non-contract test packages don't have Pact as a dependency.
+ */
+interface PactJsModule {
+    MessageConsumerPact?: {
+        prototype: Record<string | symbol, unknown>;
+    };
+    PactV3?: {
+        prototype: Record<string | symbol, unknown>;
+    };
+}
+/**
+ * Install the auto-wrap. Called at module load when this file is imported.
+ * Exposed for tests + explicit-invocation users.
+ *
+ * @param pactModule Override Pact-JS resolution. When omitted, requires
+ *   `@pact-foundation/pact` from disk. Tests can pass synthetic classes.
+ *
+ * Returns `true` if Pact-JS was found and patched, `false` otherwise.
+ */
+declare function installAutoWrap(pactModule?: PactJsModule): boolean;
+
+export { installAutoWrap };

package/dist/auto-wrap.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Auto-wrap entry for vitest / jest setup files.
+ *
+ * Importing this module monkey-patches `@pact-foundation/pact`'s
+ * `MessageConsumerPact.prototype.verify` and `PactV3.prototype.executeTest`
+ * so every contract test in the project records a ledger entry without
+ * users having to wrap each call by hand.
+ *
+ * Usage (vitest):
+ *
+ * ```ts
+ * // vitest.config.ts
+ * import { defineConfig } from 'vitest/config';
+ * export default defineConfig({
+ *   test: { setupFiles: ['autotel-pact/auto-wrap'] },
+ * });
+ * ```
+ *
+ * Usage (jest):
+ *
+ * ```js
+ * // jest.config.js
+ * module.exports = { setupFilesAfterEach: ['autotel-pact/auto-wrap'] };
+ * ```
+ *
+ * Configuration is via environment variables — there's no API surface,
+ * because setup files don't get parameters:
+ *
+ * - `AUTOTEL_PACT_RUN_ID` — tag every ledger entry with this run id
+ * - `AUTOTEL_PACT_LEDGER_DIR` — override the default `.autotel-pact/` dir
+ *
+ * Idempotent: importing twice is a no-op.
+ *
+ * Safe when Pact-JS isn't installed: logs a single warning and exits
+ * cleanly. The same setup file can stay in place for a repo whose
+ * non-contract test packages don't have Pact as a dependency.
+ */
+interface PactJsModule {
+    MessageConsumerPact?: {
+        prototype: Record<string | symbol, unknown>;
+    };
+    PactV3?: {
+        prototype: Record<string | symbol, unknown>;
+    };
+}
+/**
+ * Install the auto-wrap. Called at module load when this file is imported.
+ * Exposed for tests + explicit-invocation users.
+ *
+ * @param pactModule Override Pact-JS resolution. When omitted, requires
+ *   `@pact-foundation/pact` from disk. Tests can pass synthetic classes.
+ *
+ * Returns `true` if Pact-JS was found and patched, `false` otherwise.
+ */
+declare function installAutoWrap(pactModule?: PactJsModule): boolean;
+
+export { installAutoWrap };

package/dist/auto-wrap.js

@@ -0,0 +1,248 @@
+import { span, getActiveSpan } from 'autotel';
+import { createRequire } from 'module';
+import { mkdirSync, appendFileSync } from 'fs';
+import 'fs/promises';
+import path from 'path';
+
+// src/auto-wrap.ts
+
+// src/attrs.ts
+var PACT_ATTRS = {
+  CONSUMER: "pact.consumer",
+  PROVIDER: "pact.provider",
+  KIND: "pact.kind",
+  INTERACTION_DESCRIPTION: "pact.interaction.description",
+  INTERACTION_ID: "pact.interaction.id",
+  INTERACTION_STATES: "pact.interaction.states",
+  CONTRACT_FILE: "pact.contract.file",
+  OUTCOME: "pact.outcome"
+};
+function buildPactAttributes(meta, opts = {}) {
+  const attrs = {
+    [PACT_ATTRS.CONSUMER]: meta.consumer,
+    [PACT_ATTRS.PROVIDER]: meta.provider,
+    [PACT_ATTRS.KIND]: meta.kind,
+    [PACT_ATTRS.INTERACTION_DESCRIPTION]: meta.description,
+    [PACT_ATTRS.INTERACTION_STATES]: meta.states
+  };
+  if (opts.contractFile) {
+    attrs[PACT_ATTRS.CONTRACT_FILE] = opts.contractFile;
+  }
+  if (meta.interactionId) {
+    attrs[PACT_ATTRS.INTERACTION_ID] = meta.interactionId;
+  }
+  return attrs;
+}
+function outcomeAttribute(outcome) {
+  return { [PACT_ATTRS.OUTCOME]: outcome };
+}
+
+// src/types.ts
+var LEDGER_ENTRY_SPEC = "autotel-pact-ledger-entry/v0.2.0";
+
+// src/ledger.ts
+var DEFAULT_DIR = ".autotel-pact";
+function resolveLedgerDir(opts = {}) {
+  return path.resolve(process.cwd(), opts.dir ?? process.env.AUTOTEL_PACT_LEDGER_DIR ?? DEFAULT_DIR);
+}
+function resolveRunId(opts = {}) {
+  const explicit = opts.runId ?? process.env.AUTOTEL_PACT_RUN_ID;
+  if (explicit) return explicit;
+  return `local-${(/* @__PURE__ */ new Date()).toISOString().replaceAll(/[:.]/g, "-")}`;
+}
+function ledgerPath(opts = {}) {
+  const dir = resolveLedgerDir(opts);
+  return path.join(dir, `ledger-${resolveRunId(opts)}.jsonl`);
+}
+function writeLine(filePath, entry) {
+  mkdirSync(path.dirname(filePath), { recursive: true });
+  appendFileSync(filePath, JSON.stringify(entry) + "\n", "utf8");
+}
+function appendLedgerEntry(entry, opts = {}) {
+  const filePath = ledgerPath(opts);
+  const normalized = entry.type === "provider_verification_run" ? entry : { ...entry, spec: LEDGER_ENTRY_SPEC, type: "interaction" };
+  writeLine(filePath, normalized);
+}
+Promise.resolve();
+
+// src/auto-wrap.ts
+var INSTALLED = /* @__PURE__ */ Symbol.for("autotel-pact:auto-wrap-installed");
+function installAutoWrap(pactModule) {
+  const pactJs = pactModule ?? loadPactJs();
+  if (!pactJs) return false;
+  patchMessagePact(pactJs);
+  patchHttpPact(pactJs);
+  return true;
+}
+function loadPactJs() {
+  try {
+    const require2 = createRequire(import.meta.url);
+    return require2("@pact-foundation/pact");
+  } catch {
+    process.stderr.write(
+      "autotel-pact/auto-wrap: @pact-foundation/pact not installed \u2014 skipping.\n"
+    );
+    return void 0;
+  }
+}
+function patchMessagePact(mod) {
+  const ctor = mod.MessageConsumerPact;
+  if (!ctor) return;
+  const proto = ctor.prototype;
+  if (proto[INSTALLED]) return;
+  const originalVerify = proto.verify;
+  proto.verify = async function patchedVerify(handler) {
+    const start = process.hrtime.bigint();
+    let captured;
+    const consumer = this.config?.consumer ?? "<unknown>";
+    const provider = this.config?.provider ?? "<unknown>";
+    return span("pact.interaction", async (span) => {
+      span.setAttributes({
+        "pact.consumer": consumer,
+        "pact.provider": provider,
+        "pact.kind": "message"
+      });
+      try {
+        const result = await originalVerify.call(this, async (reified) => {
+          captured = reified;
+          const meta = {
+            consumer,
+            provider,
+            description: reified.description ?? "<unknown>",
+            states: (reified.providerStates ?? []).map((s) => s.name),
+            kind: "message"
+          };
+          span.setAttributes(buildPactAttributes(meta));
+          return handler(reified);
+        });
+        span.setAttributes(outcomeAttribute("passed"));
+        writeAutoLedgerEntry({
+          consumer,
+          provider,
+          interaction: captured?.description ?? "<unknown>",
+          states: (captured?.providerStates ?? []).map((s) => s.name),
+          kind: "message",
+          outcome: "passed",
+          start
+        });
+        return result;
+      } catch (error) {
+        span.setAttributes(outcomeAttribute("failed"));
+        writeAutoLedgerEntry({
+          consumer,
+          provider,
+          interaction: captured?.description ?? "<unknown>",
+          states: (captured?.providerStates ?? []).map((s) => s.name),
+          kind: "message",
+          outcome: "failed",
+          start,
+          error: error instanceof Error ? error.message : String(error)
+        });
+        throw error;
+      }
+    });
+  };
+  proto[INSTALLED] = true;
+}
+function patchHttpPact(mod) {
+  const ctor = mod.PactV3;
+  if (!ctor) return;
+  const proto = ctor.prototype;
+  if (proto[INSTALLED]) return;
+  const tracked = /* @__PURE__ */ new WeakMap();
+  const originalAdd = proto.addInteraction;
+  proto.addInteraction = function patchedAddInteraction(interaction) {
+    const list = tracked.get(this) ?? [];
+    list.push(interaction);
+    tracked.set(this, list);
+    return originalAdd.call(this, interaction);
+  };
+  const originalExecute = proto.executeTest;
+  proto.executeTest = async function patchedExecuteTest(fn) {
+    const start = process.hrtime.bigint();
+    const consumer = this.opts?.consumer ?? "<unknown>";
+    const provider = this.opts?.provider ?? "<unknown>";
+    const interactions = tracked.get(this) ?? [];
+    tracked.set(this, []);
+    return span("pact.interaction", async (span) => {
+      span.setAttributes({
+        "pact.consumer": consumer,
+        "pact.provider": provider,
+        "pact.kind": "http"
+      });
+      const first = interactions[0];
+      if (first) {
+        span.setAttributes(
+          buildPactAttributes({
+            consumer,
+            provider,
+            description: first.uponReceiving,
+            states: (first.states ?? []).map((s) => s.description),
+            kind: "http"
+          })
+        );
+      }
+      try {
+        const result = await originalExecute.call(this, fn);
+        span.setAttributes(outcomeAttribute("passed"));
+        for (const i of interactions) {
+          writeAutoLedgerEntry({
+            consumer,
+            provider,
+            interaction: i.uponReceiving,
+            states: (i.states ?? []).map((s) => s.description),
+            kind: "http",
+            outcome: "passed",
+            start
+          });
+        }
+        return result;
+      } catch (error_) {
+        span.setAttributes(outcomeAttribute("failed"));
+        const error = error_ instanceof Error ? error_.message : String(error_);
+        for (const i of interactions) {
+          writeAutoLedgerEntry({
+            consumer,
+            provider,
+            interaction: i.uponReceiving,
+            states: (i.states ?? []).map((s) => s.description),
+            kind: "http",
+            outcome: "failed",
+            start,
+            error
+          });
+        }
+        throw error_;
+      }
+    });
+  };
+  proto[INSTALLED] = true;
+}
+function writeAutoLedgerEntry(args) {
+  const ctx = getActiveSpan()?.spanContext();
+  const entry = {
+    type: "interaction",
+    spec: LEDGER_ENTRY_SPEC,
+    consumer: args.consumer,
+    provider: args.provider,
+    interaction: args.interaction,
+    states: args.states,
+    kind: args.kind,
+    source: "test",
+    role: "consumer",
+    outcome: args.outcome,
+    duration_ms: Number(process.hrtime.bigint() - args.start) / 1e6,
+    observed_at: (/* @__PURE__ */ new Date()).toISOString(),
+    trace_id: ctx?.traceId,
+    span_id: ctx?.spanId,
+    run_id: process.env.AUTOTEL_PACT_RUN_ID,
+    git_sha: process.env.GIT_SHA ?? process.env.GITHUB_SHA,
+    error: args.error
+  };
+  appendLedgerEntry(entry);
+}
+installAutoWrap();
+
+export { installAutoWrap };
+//# sourceMappingURL=auto-wrap.js.map
+//# sourceMappingURL=auto-wrap.js.map