autotel-eventcatalog 19.0.0 → 21.0.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 21.0.0
+
+### Patch Changes
+
+- autotel-subscribers@51.0.0
+
+## 20.0.0
+
+### Patch Changes
+
+- Updated dependencies [d303348]
+  - autotel-subscribers@50.0.0
+
 ## 19.0.0
 
 ### Patch Changes

package/dist/cli.cjs

@@ -1,5 +1,5 @@
 
-const require_generate = require('./generate-CHjGIFJe.cjs');
+const require_generate = require('./generate-C1vYn-_M.cjs');
 let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");
 let node_url = require("node:url");
@@ -34,7 +34,7 @@ async function loadRendererModule(modulePath) {
 	try {
 		mod = await import((0, node_url.pathToFileURL)(resolved).href);
 	} catch (error) {
-		process.stderr.write(`Failed to load renderer module ${modulePath}: ${error.message}\n`);
+		process.stderr.write(`Failed to load renderer module ${modulePath}: ${error instanceof Error ? error.message : String(error)}\n`);
 		process.exit(2);
 	}
 	const candidate = mod.default ?? mod.renderer;
@@ -45,7 +45,7 @@ async function loadRendererModule(modulePath) {
 	try {
 		require_generate.registerRenderer(candidate);
 	} catch (error) {
-		process.stderr.write(`${error.message}\n`);
+		process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
 		process.exit(2);
 	}
 }
@@ -429,7 +429,7 @@ async function main() {
 	await runDrift(args);
 }
 main().catch((error) => {
-	process.stderr.write(`autotel-eventcatalog: ${error.message}\n`);
+	process.stderr.write(`autotel-eventcatalog: ${error instanceof Error ? error.message : String(error)}\n`);
 	process.exit(1);
 });
 

package/dist/cli.js

@@ -1,5 +1,5 @@
 
-import { A as countDriftEntries, F as readCatalogState, I as loadSnapshot, M as diffCatalogAgainstSnapshot, O as compareDriftReports, d as evaluatePolicy, g as registerRenderer, h as listRendererNames, j as countDriftReport, l as buildStampSummary, m as getRenderer, n as buildGenerateSummary, r as generateCatalogFromSnapshot, u as stampCatalog } from "./generate-r5KccyNS.js";
+import { A as countDriftEntries, F as readCatalogState, I as loadSnapshot, M as diffCatalogAgainstSnapshot, O as compareDriftReports, d as evaluatePolicy, g as registerRenderer, h as listRendererNames, j as countDriftReport, l as buildStampSummary, m as getRenderer, n as buildGenerateSummary, r as generateCatalogFromSnapshot, u as stampCatalog } from "./generate-w_py2l3I.js";
 import { mkdir, writeFile } from "node:fs/promises";
 import { dirname, resolve } from "node:path";
 import { pathToFileURL } from "node:url";
@@ -34,7 +34,7 @@ async function loadRendererModule(modulePath) {
 	try {
 		mod = await import(pathToFileURL(resolved).href);
 	} catch (error) {
-		process.stderr.write(`Failed to load renderer module ${modulePath}: ${error.message}\n`);
+		process.stderr.write(`Failed to load renderer module ${modulePath}: ${error instanceof Error ? error.message : String(error)}\n`);
 		process.exit(2);
 	}
 	const candidate = mod.default ?? mod.renderer;
@@ -45,7 +45,7 @@ async function loadRendererModule(modulePath) {
 	try {
 		registerRenderer(candidate);
 	} catch (error) {
-		process.stderr.write(`${error.message}\n`);
+		process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
 		process.exit(2);
 	}
 }
@@ -429,7 +429,7 @@ async function main() {
 	await runDrift(args);
 }
 main().catch((error) => {
-	process.stderr.write(`autotel-eventcatalog: ${error.message}\n`);
+	process.stderr.write(`autotel-eventcatalog: ${error instanceof Error ? error.message : String(error)}\n`);
 	process.exit(1);
 });
 

package/dist/{generate-CHjGIFJe.cjs → generate-C1vYn-_M.cjs}

@@ -46,14 +46,14 @@ async function loadSnapshot(path) {
 	} catch (err) {
 		if (isNodeFsError(err) && err.code === "ENOENT") throw new Error(`Snapshot not found: ${path}`);
 		if (isNodeFsError(err) && err.code === "EISDIR") throw new Error(`Snapshot path is a directory, not a file: ${path}`);
-		throw new Error(`Could not read snapshot at ${path}: ${err.message}`);
+		throw new Error(`Could not read snapshot at ${path}: ${err instanceof Error ? err.message : String(err)}`);
 	}
 	if (raw.trim().length === 0) throw new Error(`Snapshot is empty: ${path}`);
 	let parsed;
 	try {
 		parsed = JSON.parse(raw);
 	} catch (err) {
-		throw new Error(`Snapshot is not valid JSON: ${path} (${err.message})`);
+		throw new Error(`Snapshot is not valid JSON: ${path} (${err instanceof Error ? err.message : String(err)})`);
 	}
 	return validateSnapshot(parsed, path);
 }
@@ -82,8 +82,8 @@ function validateSnapshot(parsed, path) {
 function isJsonObject(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function isNodeFsError(err) {
-	return err instanceof Error && typeof err.code === "string";
+function isNodeFsError(cause) {
+	return cause instanceof Error && typeof cause.code === "string";
 }
 function describe(value) {
 	if (value === null) return "null";
@@ -150,42 +150,35 @@ function extractDeclaredFieldPaths(schema, prefix = "") {
 	return [...out].toSorted();
 }
 function walkSchema(schema, prefix, out) {
-	if (!schema || typeof schema !== "object") return;
-	const s = schema;
-	if (s.properties && typeof s.properties === "object") for (const [key, sub] of Object.entries(s.properties)) {
+	if (!schema) return;
+	for (const [key, sub] of Object.entries(schema.properties ?? {})) {
 		const path = prefix === "" ? key : `${prefix}.${key}`;
 		out.add(path);
 		walkSchema(sub, path, out);
 	}
-	if (s.items) {
-		const arrayPrefix = prefix + "[]";
-		walkSchema(s.items, arrayPrefix, out);
-	}
+	if (schema.items) walkSchema(schema.items, prefix + "[]", out);
 }
 function extractDeclaredSchemaConstraints(schema, prefix = "") {
 	const out = /* @__PURE__ */ new Map();
 	walkSchemaConstraints(schema, prefix, out);
-	const obj = {};
-	for (const [path, c] of out) obj[path] = c;
-	return obj;
+	return Object.fromEntries(out);
 }
 function walkSchemaConstraints(schema, prefix, out) {
-	if (!schema || typeof schema !== "object") return;
-	const s = schema;
-	const typeVal = s.type;
-	const enumVal = s.enum;
+	if (!schema) return;
+	const typeVal = schema.type;
+	const enumVal = schema.enum;
 	if (prefix !== "" && (typeVal !== void 0 || enumVal !== void 0)) {
 		const types = toTypeArray(typeVal);
 		const enumValues = Array.isArray(enumVal) ? [...enumVal] : void 0;
-		out.set(prefix, {
-			...types.length > 0 ? { types } : {},
-			...enumValues ? { enumValues } : {}
-		});
+		const field = {};
+		if (types.length > 0) field.types = types;
+		if (enumValues) field.enumValues = enumValues;
+		out.set(prefix, field);
 	}
-	if (s.properties && typeof s.properties === "object") for (const [key, sub] of Object.entries(s.properties)) walkSchemaConstraints(sub, prefix === "" ? key : `${prefix}.${key}`, out);
-	if (s.items) {
+	for (const [key, sub] of Object.entries(schema.properties ?? {})) walkSchemaConstraints(sub, prefix === "" ? key : `${prefix}.${key}`, out);
+	if (schema.items) {
 		const arrayPrefix = prefix + "[]";
-		walkSchemaConstraints(s.items, arrayPrefix, out);
+		walkSchemaConstraints(schema.items, arrayPrefix, out);
 	}
 }
 function toTypeArray(typeVal) {
@@ -1021,10 +1014,10 @@ async function generateCatalogFromSnapshot(opts) {
 					summary: `Generated from autotel snapshot event "${snapshotName}"`,
 					schemaPath: "schema.json",
 					markdown: buildEventMarkdown(snapshotName, obs, schemaSource),
-					...obs.channel ? { channels: [{
+					channels: obs.channel ? [{
 						id: obs.channel,
 						version: DEFAULT_VERSION
-					}] } : {}
+					}] : void 0
 				});
 				await sdk.addSchemaToEvent(eventId, {
 					schema: JSON.stringify(schema, null, 2),
@@ -1157,7 +1150,7 @@ function insertSchemaPath(root, path, observedTypes) {
 	for (let i = 0; i < steps.length; i++) {
 		const step = steps[i];
 		const last = i === steps.length - 1;
-		if (!current.properties || typeof current.properties !== "object") current.properties = {};
+		current.properties ??= {};
 		const properties = current.properties;
 		const next = properties[step.key] ?? {};
 		properties[step.key] = next;

package/dist/{generate-r5KccyNS.js → generate-w_py2l3I.js}

@@ -18,14 +18,14 @@ async function loadSnapshot(path) {
 	} catch (err) {
 		if (isNodeFsError(err) && err.code === "ENOENT") throw new Error(`Snapshot not found: ${path}`);
 		if (isNodeFsError(err) && err.code === "EISDIR") throw new Error(`Snapshot path is a directory, not a file: ${path}`);
-		throw new Error(`Could not read snapshot at ${path}: ${err.message}`);
+		throw new Error(`Could not read snapshot at ${path}: ${err instanceof Error ? err.message : String(err)}`);
 	}
 	if (raw.trim().length === 0) throw new Error(`Snapshot is empty: ${path}`);
 	let parsed;
 	try {
 		parsed = JSON.parse(raw);
 	} catch (err) {
-		throw new Error(`Snapshot is not valid JSON: ${path} (${err.message})`);
+		throw new Error(`Snapshot is not valid JSON: ${path} (${err instanceof Error ? err.message : String(err)})`);
 	}
 	return validateSnapshot(parsed, path);
 }
@@ -54,8 +54,8 @@ function validateSnapshot(parsed, path) {
 function isJsonObject(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function isNodeFsError(err) {
-	return err instanceof Error && typeof err.code === "string";
+function isNodeFsError(cause) {
+	return cause instanceof Error && typeof cause.code === "string";
 }
 function describe(value) {
 	if (value === null) return "null";
@@ -122,42 +122,35 @@ function extractDeclaredFieldPaths(schema, prefix = "") {
 	return [...out].toSorted();
 }
 function walkSchema(schema, prefix, out) {
-	if (!schema || typeof schema !== "object") return;
-	const s = schema;
-	if (s.properties && typeof s.properties === "object") for (const [key, sub] of Object.entries(s.properties)) {
+	if (!schema) return;
+	for (const [key, sub] of Object.entries(schema.properties ?? {})) {
 		const path = prefix === "" ? key : `${prefix}.${key}`;
 		out.add(path);
 		walkSchema(sub, path, out);
 	}
-	if (s.items) {
-		const arrayPrefix = prefix + "[]";
-		walkSchema(s.items, arrayPrefix, out);
-	}
+	if (schema.items) walkSchema(schema.items, prefix + "[]", out);
 }
 function extractDeclaredSchemaConstraints(schema, prefix = "") {
 	const out = /* @__PURE__ */ new Map();
 	walkSchemaConstraints(schema, prefix, out);
-	const obj = {};
-	for (const [path, c] of out) obj[path] = c;
-	return obj;
+	return Object.fromEntries(out);
 }
 function walkSchemaConstraints(schema, prefix, out) {
-	if (!schema || typeof schema !== "object") return;
-	const s = schema;
-	const typeVal = s.type;
-	const enumVal = s.enum;
+	if (!schema) return;
+	const typeVal = schema.type;
+	const enumVal = schema.enum;
 	if (prefix !== "" && (typeVal !== void 0 || enumVal !== void 0)) {
 		const types = toTypeArray(typeVal);
 		const enumValues = Array.isArray(enumVal) ? [...enumVal] : void 0;
-		out.set(prefix, {
-			...types.length > 0 ? { types } : {},
-			...enumValues ? { enumValues } : {}
-		});
+		const field = {};
+		if (types.length > 0) field.types = types;
+		if (enumValues) field.enumValues = enumValues;
+		out.set(prefix, field);
 	}
-	if (s.properties && typeof s.properties === "object") for (const [key, sub] of Object.entries(s.properties)) walkSchemaConstraints(sub, prefix === "" ? key : `${prefix}.${key}`, out);
-	if (s.items) {
+	for (const [key, sub] of Object.entries(schema.properties ?? {})) walkSchemaConstraints(sub, prefix === "" ? key : `${prefix}.${key}`, out);
+	if (schema.items) {
 		const arrayPrefix = prefix + "[]";
-		walkSchemaConstraints(s.items, arrayPrefix, out);
+		walkSchemaConstraints(schema.items, arrayPrefix, out);
 	}
 }
 function toTypeArray(typeVal) {
@@ -993,10 +986,10 @@ async function generateCatalogFromSnapshot(opts) {
 					summary: `Generated from autotel snapshot event "${snapshotName}"`,
 					schemaPath: "schema.json",
 					markdown: buildEventMarkdown(snapshotName, obs, schemaSource),
-					...obs.channel ? { channels: [{
+					channels: obs.channel ? [{
 						id: obs.channel,
 						version: DEFAULT_VERSION
-					}] } : {}
+					}] : void 0
 				});
 				await sdk.addSchemaToEvent(eventId, {
 					schema: JSON.stringify(schema, null, 2),
@@ -1129,7 +1122,7 @@ function insertSchemaPath(root, path, observedTypes) {
 	for (let i = 0; i < steps.length; i++) {
 		const step = steps[i];
 		const last = i === steps.length - 1;
-		if (!current.properties || typeof current.properties !== "object") current.properties = {};
+		current.properties ??= {};
 		const properties = current.properties;
 		const next = properties[step.key] ?? {};
 		properties[step.key] = next;

package/dist/index.cjs

@@ -1,6 +1,6 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_generate = require('./generate-CHjGIFJe.cjs');
+const require_generate = require('./generate-C1vYn-_M.cjs');
 
 exports.EVENTCATALOG_SNAPSHOT_DIFF_SPEC = require_generate.EVENTCATALOG_SNAPSHOT_DIFF_SPEC;
 exports.GENERATE_SUMMARY_SPEC = require_generate.GENERATE_SUMMARY_SPEC;

package/dist/index.d.cts

@@ -11,6 +11,86 @@ import { Channel, Event, Service } from "@eventcatalog/sdk";
  */
 declare function loadSnapshot(path: string): Promise<ArchitectureSnapshot$1>;
 //#endregion
+//#region src/generate.d.ts
+interface GenerateOptions {
+  snapshot: ArchitectureSnapshot;
+  catalogPath: string;
+  dryRun?: boolean;
+  edgesOnly?: boolean;
+  /** Version to assign to newly created resources. Defaults to '1.0.0'. */
+  version?: string;
+}
+type GenerateSummaryItem = {
+  kind: 'service' | 'event' | 'channel' | 'service-edge' | 'channel-edge';
+  id: string;
+  action: 'create' | 'exists' | 'link' | 'would-create' | 'would-link';
+  detail?: string;
+  /** For event items: where the JSON Schema came from. */
+  schemaSource?: 'declared' | 'inferred';
+};
+interface GenerateResult {
+  operations: GenerateSummaryItem[];
+}
+declare const GENERATE_SUMMARY_SPEC: "autotel-eventcatalog-generate-summary/v0.1.0";
+type GenerateSummary = {
+  spec: typeof GENERATE_SUMMARY_SPEC;
+  dryRun: boolean;
+  edgesOnly: boolean;
+  attempted: number;
+  /** Top-level totals for dashboards / status checks. */
+  totals: {
+    created: number;
+    linked: number;
+    skipped: number;
+  };
+  /** Per-kind counts so consumers can render detail without re-deriving from `operations`. */
+  created: {
+    services: string[];
+    events: string[];
+    channels: string[];
+  };
+  edges: {
+    sends: {
+      service: string;
+      event: string;
+    }[];
+    receives: {
+      service: string;
+      event: string;
+    }[];
+    messages: {
+      channel: string;
+      event: string;
+    }[];
+  };
+  /** Counts of declared- vs inferred-schema events created. Reveals adoption of `defineEvent`. */
+  schemaSources: {
+    declared: number;
+    inferred: number;
+  };
+  skipped: {
+    services: string[];
+    events: string[];
+    channels: string[];
+  };
+};
+/** A JSON Schema node, as this generator builds one. */
+interface JsonSchemaNode {
+  $schema?: string;
+  type?: string | string[];
+  enum?: Array<string | number | boolean | null>;
+  properties?: Record<string, JsonSchemaNode>;
+  items?: JsonSchemaNode;
+  format?: string;
+  description?: string;
+}
+declare function generateCatalogFromSnapshot(opts: GenerateOptions): Promise<GenerateResult>;
+declare function buildGenerateSummary(result: GenerateResult, options: {
+  dryRun: boolean;
+  edgesOnly: boolean;
+}): GenerateSummary;
+declare function inferJsonSchemaFromObservation(observation: EventObservation): JsonSchemaNode;
+//#endregion
 //#region src/catalog.d.ts
 type SchemaConstraint = {
   types?: string[];
@@ -40,7 +120,7 @@ declare function readCatalogState(catalogPath: string): Promise<CatalogState>;
  * used by the snapshot subscriber: arrays collapse to `[]`, nested objects
  * use `.`. We walk `properties` (objects) and `items` (arrays).
  */
-declare function extractDeclaredFieldPaths(schema: unknown, prefix?: string): string[];
+declare function extractDeclaredFieldPaths(schema: JsonSchemaNode | undefined, prefix?: string): string[];
 //#endregion
 //#region src/diff.d.ts
 type EventDrift = {
@@ -345,74 +425,4 @@ type StampSummary = {
 };
 declare function buildStampSummary(result: StampResult, dryRun: boolean): StampSummary;
 //#endregion
-//#region src/generate.d.ts
-interface GenerateOptions {
-  snapshot: ArchitectureSnapshot;
-  catalogPath: string;
-  dryRun?: boolean;
-  edgesOnly?: boolean;
-  /** Version to assign to newly created resources. Defaults to '1.0.0'. */
-  version?: string;
-}
-type GenerateSummaryItem = {
-  kind: 'service' | 'event' | 'channel' | 'service-edge' | 'channel-edge';
-  id: string;
-  action: 'create' | 'exists' | 'link' | 'would-create' | 'would-link';
-  detail?: string;
-  /** For event items: where the JSON Schema came from. */
-  schemaSource?: 'declared' | 'inferred';
-};
-interface GenerateResult {
-  operations: GenerateSummaryItem[];
-}
-declare const GENERATE_SUMMARY_SPEC: "autotel-eventcatalog-generate-summary/v0.1.0";
-type GenerateSummary = {
-  spec: typeof GENERATE_SUMMARY_SPEC;
-  dryRun: boolean;
-  edgesOnly: boolean;
-  attempted: number;
-  /** Top-level totals for dashboards / status checks. */
-  totals: {
-    created: number;
-    linked: number;
-    skipped: number;
-  };
-  /** Per-kind counts so consumers can render detail without re-deriving from `operations`. */
-  created: {
-    services: string[];
-    events: string[];
-    channels: string[];
-  };
-  edges: {
-    sends: {
-      service: string;
-      event: string;
-    }[];
-    receives: {
-      service: string;
-      event: string;
-    }[];
-    messages: {
-      channel: string;
-      event: string;
-    }[];
-  };
-  /** Counts of declared- vs inferred-schema events created. Reveals adoption of `defineEvent`. */
-  schemaSources: {
-    declared: number;
-    inferred: number;
-  };
-  skipped: {
-    services: string[];
-    events: string[];
-    channels: string[];
-  };
-};
-declare function generateCatalogFromSnapshot(opts: GenerateOptions): Promise<GenerateResult>;
-declare function buildGenerateSummary(result: GenerateResult, options: {
-  dryRun: boolean;
-  edgesOnly: boolean;
-}): GenerateSummary;
-declare function inferJsonSchemaFromObservation(observation: EventObservation): Record<string, unknown>;
-//#endregion
 export { type ArchitectureSnapshot, type CatalogChannel, type CatalogEvent, type CatalogService, type CatalogState, type ChannelDrift, type DriftCounts, type DriftDelta, type DriftEntries, type DriftPolicyMode, type DriftReport, EVENTCATALOG_SNAPSHOT_DIFF_SPEC, type EventCatalogSnapshotDiff, type EventCatalogSnapshotDiffEnvelope, type EventDrift, type EventObservation, type FieldDrift, GENERATE_SUMMARY_SPEC, type GenerateOptions, type GenerateResult, type GenerateSummary, type GenerateSummaryItem, type JsonReport, type JsonReportEnvelope, type PolicyEvaluationInput, type PolicyEvaluationResult, RENDERERS, RENDERER_NAMES, REPORT_SPEC, type RelationshipChange, type Renderer, type RendererName, type ResourceChange, STAMP_END, STAMP_START, STAMP_SUMMARY_SPEC, type ServiceDrift, type StampOptions, type StampResult, type StampSkip, type StampSummary, type StampUpdate, buildGenerateSummary, buildStampBlock, buildStampSummary, compareDriftReports, countDriftDelta, countDriftEntries, countDriftReport, diffCatalogAgainstSnapshot, evaluatePolicy, extractDeclaredFieldPaths, generateCatalogFromSnapshot, getRenderer, hasDrift, inferJsonSchemaFromObservation, loadSnapshot, readCatalogState, renderDeltaMarkdown, renderDeltaTerminal, renderEventCatalogSnapshotDiffFromDelta, renderEventCatalogSnapshotDiffFromReport, renderJson, renderMarkdown, renderTerminal, stampCatalog, toSnapshotDiffFromDelta, toSnapshotDiffFromReport };

package/dist/index.d.ts

@@ -11,6 +11,86 @@ import { ArchitectureSnapshot, ArchitectureSnapshot as ArchitectureSnapshot$1, E
  */
 declare function loadSnapshot(path: string): Promise<ArchitectureSnapshot$1>;
 //#endregion
+//#region src/generate.d.ts
+interface GenerateOptions {
+  snapshot: ArchitectureSnapshot;
+  catalogPath: string;
+  dryRun?: boolean;
+  edgesOnly?: boolean;
+  /** Version to assign to newly created resources. Defaults to '1.0.0'. */
+  version?: string;
+}
+type GenerateSummaryItem = {
+  kind: 'service' | 'event' | 'channel' | 'service-edge' | 'channel-edge';
+  id: string;
+  action: 'create' | 'exists' | 'link' | 'would-create' | 'would-link';
+  detail?: string;
+  /** For event items: where the JSON Schema came from. */
+  schemaSource?: 'declared' | 'inferred';
+};
+interface GenerateResult {
+  operations: GenerateSummaryItem[];
+}
+declare const GENERATE_SUMMARY_SPEC: "autotel-eventcatalog-generate-summary/v0.1.0";
+type GenerateSummary = {
+  spec: typeof GENERATE_SUMMARY_SPEC;
+  dryRun: boolean;
+  edgesOnly: boolean;
+  attempted: number;
+  /** Top-level totals for dashboards / status checks. */
+  totals: {
+    created: number;
+    linked: number;
+    skipped: number;
+  };
+  /** Per-kind counts so consumers can render detail without re-deriving from `operations`. */
+  created: {
+    services: string[];
+    events: string[];
+    channels: string[];
+  };
+  edges: {
+    sends: {
+      service: string;
+      event: string;
+    }[];
+    receives: {
+      service: string;
+      event: string;
+    }[];
+    messages: {
+      channel: string;
+      event: string;
+    }[];
+  };
+  /** Counts of declared- vs inferred-schema events created. Reveals adoption of `defineEvent`. */
+  schemaSources: {
+    declared: number;
+    inferred: number;
+  };
+  skipped: {
+    services: string[];
+    events: string[];
+    channels: string[];
+  };
+};
+/** A JSON Schema node, as this generator builds one. */
+interface JsonSchemaNode {
+  $schema?: string;
+  type?: string | string[];
+  enum?: Array<string | number | boolean | null>;
+  properties?: Record<string, JsonSchemaNode>;
+  items?: JsonSchemaNode;
+  format?: string;
+  description?: string;
+}
+declare function generateCatalogFromSnapshot(opts: GenerateOptions): Promise<GenerateResult>;
+declare function buildGenerateSummary(result: GenerateResult, options: {
+  dryRun: boolean;
+  edgesOnly: boolean;
+}): GenerateSummary;
+declare function inferJsonSchemaFromObservation(observation: EventObservation): JsonSchemaNode;
+//#endregion
 //#region src/catalog.d.ts
 type SchemaConstraint = {
   types?: string[];
@@ -40,7 +120,7 @@ declare function readCatalogState(catalogPath: string): Promise<CatalogState>;
  * used by the snapshot subscriber: arrays collapse to `[]`, nested objects
  * use `.`. We walk `properties` (objects) and `items` (arrays).
  */
-declare function extractDeclaredFieldPaths(schema: unknown, prefix?: string): string[];
+declare function extractDeclaredFieldPaths(schema: JsonSchemaNode | undefined, prefix?: string): string[];
 //#endregion
 //#region src/diff.d.ts
 type EventDrift = {
@@ -345,74 +425,4 @@ type StampSummary = {
 };
 declare function buildStampSummary(result: StampResult, dryRun: boolean): StampSummary;
 //#endregion
-//#region src/generate.d.ts
-interface GenerateOptions {
-  snapshot: ArchitectureSnapshot;
-  catalogPath: string;
-  dryRun?: boolean;
-  edgesOnly?: boolean;
-  /** Version to assign to newly created resources. Defaults to '1.0.0'. */
-  version?: string;
-}
-type GenerateSummaryItem = {
-  kind: 'service' | 'event' | 'channel' | 'service-edge' | 'channel-edge';
-  id: string;
-  action: 'create' | 'exists' | 'link' | 'would-create' | 'would-link';
-  detail?: string;
-  /** For event items: where the JSON Schema came from. */
-  schemaSource?: 'declared' | 'inferred';
-};
-interface GenerateResult {
-  operations: GenerateSummaryItem[];
-}
-declare const GENERATE_SUMMARY_SPEC: "autotel-eventcatalog-generate-summary/v0.1.0";
-type GenerateSummary = {
-  spec: typeof GENERATE_SUMMARY_SPEC;
-  dryRun: boolean;
-  edgesOnly: boolean;
-  attempted: number;
-  /** Top-level totals for dashboards / status checks. */
-  totals: {
-    created: number;
-    linked: number;
-    skipped: number;
-  };
-  /** Per-kind counts so consumers can render detail without re-deriving from `operations`. */
-  created: {
-    services: string[];
-    events: string[];
-    channels: string[];
-  };
-  edges: {
-    sends: {
-      service: string;
-      event: string;
-    }[];
-    receives: {
-      service: string;
-      event: string;
-    }[];
-    messages: {
-      channel: string;
-      event: string;
-    }[];
-  };
-  /** Counts of declared- vs inferred-schema events created. Reveals adoption of `defineEvent`. */
-  schemaSources: {
-    declared: number;
-    inferred: number;
-  };
-  skipped: {
-    services: string[];
-    events: string[];
-    channels: string[];
-  };
-};
-declare function generateCatalogFromSnapshot(opts: GenerateOptions): Promise<GenerateResult>;
-declare function buildGenerateSummary(result: GenerateResult, options: {
-  dryRun: boolean;
-  edgesOnly: boolean;
-}): GenerateSummary;
-declare function inferJsonSchemaFromObservation(observation: EventObservation): Record<string, unknown>;
-//#endregion
 export { type ArchitectureSnapshot, type CatalogChannel, type CatalogEvent, type CatalogService, type CatalogState, type ChannelDrift, type DriftCounts, type DriftDelta, type DriftEntries, type DriftPolicyMode, type DriftReport, EVENTCATALOG_SNAPSHOT_DIFF_SPEC, type EventCatalogSnapshotDiff, type EventCatalogSnapshotDiffEnvelope, type EventDrift, type EventObservation, type FieldDrift, GENERATE_SUMMARY_SPEC, type GenerateOptions, type GenerateResult, type GenerateSummary, type GenerateSummaryItem, type JsonReport, type JsonReportEnvelope, type PolicyEvaluationInput, type PolicyEvaluationResult, RENDERERS, RENDERER_NAMES, REPORT_SPEC, type RelationshipChange, type Renderer, type RendererName, type ResourceChange, STAMP_END, STAMP_START, STAMP_SUMMARY_SPEC, type ServiceDrift, type StampOptions, type StampResult, type StampSkip, type StampSummary, type StampUpdate, buildGenerateSummary, buildStampBlock, buildStampSummary, compareDriftReports, countDriftDelta, countDriftEntries, countDriftReport, diffCatalogAgainstSnapshot, evaluatePolicy, extractDeclaredFieldPaths, generateCatalogFromSnapshot, getRenderer, hasDrift, inferJsonSchemaFromObservation, loadSnapshot, readCatalogState, renderDeltaMarkdown, renderDeltaTerminal, renderEventCatalogSnapshotDiffFromDelta, renderEventCatalogSnapshotDiffFromReport, renderJson, renderMarkdown, renderTerminal, stampCatalog, toSnapshotDiffFromDelta, toSnapshotDiffFromReport };

package/dist/index.js

@@ -1,4 +1,4 @@
 
-import { A as countDriftEntries, C as renderJson, D as renderMarkdown, E as renderDeltaMarkdown, F as readCatalogState, I as loadSnapshot, M as diffCatalogAgainstSnapshot, N as hasDrift, O as compareDriftReports, P as extractDeclaredFieldPaths, S as REPORT_SPEC, T as renderTerminal, _ as EVENTCATALOG_SNAPSHOT_DIFF_SPEC, a as STAMP_END, b as toSnapshotDiffFromDelta, c as buildStampBlock, d as evaluatePolicy, f as RENDERERS, i as inferJsonSchemaFromObservation, j as countDriftReport, k as countDriftDelta, l as buildStampSummary, m as getRenderer, n as buildGenerateSummary, o as STAMP_START, p as RENDERER_NAMES, r as generateCatalogFromSnapshot, s as STAMP_SUMMARY_SPEC, t as GENERATE_SUMMARY_SPEC, u as stampCatalog, v as renderEventCatalogSnapshotDiffFromDelta, w as renderDeltaTerminal, x as toSnapshotDiffFromReport, y as renderEventCatalogSnapshotDiffFromReport } from "./generate-r5KccyNS.js";
+import { A as countDriftEntries, C as renderJson, D as renderMarkdown, E as renderDeltaMarkdown, F as readCatalogState, I as loadSnapshot, M as diffCatalogAgainstSnapshot, N as hasDrift, O as compareDriftReports, P as extractDeclaredFieldPaths, S as REPORT_SPEC, T as renderTerminal, _ as EVENTCATALOG_SNAPSHOT_DIFF_SPEC, a as STAMP_END, b as toSnapshotDiffFromDelta, c as buildStampBlock, d as evaluatePolicy, f as RENDERERS, i as inferJsonSchemaFromObservation, j as countDriftReport, k as countDriftDelta, l as buildStampSummary, m as getRenderer, n as buildGenerateSummary, o as STAMP_START, p as RENDERER_NAMES, r as generateCatalogFromSnapshot, s as STAMP_SUMMARY_SPEC, t as GENERATE_SUMMARY_SPEC, u as stampCatalog, v as renderEventCatalogSnapshotDiffFromDelta, w as renderDeltaTerminal, x as toSnapshotDiffFromReport, y as renderEventCatalogSnapshotDiffFromReport } from "./generate-w_py2l3I.js";
 
 export { EVENTCATALOG_SNAPSHOT_DIFF_SPEC, GENERATE_SUMMARY_SPEC, RENDERERS, RENDERER_NAMES, REPORT_SPEC, STAMP_END, STAMP_START, STAMP_SUMMARY_SPEC, buildGenerateSummary, buildStampBlock, buildStampSummary, compareDriftReports, countDriftDelta, countDriftEntries, countDriftReport, diffCatalogAgainstSnapshot, evaluatePolicy, extractDeclaredFieldPaths, generateCatalogFromSnapshot, getRenderer, hasDrift, inferJsonSchemaFromObservation, loadSnapshot, readCatalogState, renderDeltaMarkdown, renderDeltaTerminal, renderEventCatalogSnapshotDiffFromDelta, renderEventCatalogSnapshotDiffFromReport, renderJson, renderMarkdown, renderTerminal, stampCatalog, toSnapshotDiffFromDelta, toSnapshotDiffFromReport };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autotel-eventcatalog",
-  "version": "19.0.0",
+  "version": "21.0.0",
   "description": "Diff your autotel architecture snapshot against an EventCatalog and report drift. Same model as Pact, for event architectures.",
   "type": "module",
   "main": "./dist/index.js",
@@ -55,7 +55,7 @@
     "tsdown": "^0.22.14",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
-    "autotel-subscribers": "49.0.0"
+    "autotel-subscribers": "51.0.0"
   },
   "dependencies": {
     "@eventcatalog/sdk": "^2.26.3"