@contractspec/example.versioned-knowledge-base 1.57.0 → 1.59.0

package/dist/handlers/memory.handlers.d.ts

@@ -1,78 +1,76 @@
-//#region src/handlers/memory.handlers.d.ts
 interface SourceRef {
-  sourceDocumentId: string;
-  excerpt?: string;
+    sourceDocumentId: string;
+    excerpt?: string;
 }
 interface SourceDocument {
-  id: string;
-  jurisdiction: string;
-  authority: string;
-  title: string;
-  fetchedAt: Date;
-  hash: string;
-  fileId: string;
+    id: string;
+    jurisdiction: string;
+    authority: string;
+    title: string;
+    fetchedAt: Date;
+    hash: string;
+    fileId: string;
 }
 interface Rule {
-  id: string;
-  jurisdiction: string;
-  topicKey: string;
+    id: string;
+    jurisdiction: string;
+    topicKey: string;
 }
 interface RuleVersion {
-  id: string;
-  ruleId: string;
-  jurisdiction: string;
-  topicKey: string;
-  version: string;
-  content: string;
-  sourceRefs: SourceRef[];
-  status: 'draft' | 'approved' | 'rejected';
-  approvedBy?: string;
-  approvedAt?: Date;
-  createdAt: Date;
-}
-interface KBSnapshot {
-  id: string;
-  jurisdiction: string;
-  asOfDate: Date;
-  includedRuleVersionIds: string[];
-  publishedAt: Date;
-}
-interface MemoryKbStore {
-  sources: Map<string, SourceDocument>;
-  rules: Map<string, Rule>;
-  ruleVersions: Map<string, RuleVersion>;
-  snapshots: Map<string, KBSnapshot>;
-  nextRuleVersionNumberByRuleId: Map<string, number>;
-}
-declare function createMemoryKbStore(): MemoryKbStore;
-interface MemoryKbHandlers {
-  createRule(rule: Rule): Promise<Rule>;
-  ingestSource(input: Omit<SourceDocument, 'id'>): Promise<SourceDocument>;
-  upsertRuleVersion(input: {
+    id: string;
     ruleId: string;
+    jurisdiction: string;
+    topicKey: string;
+    version: string;
     content: string;
     sourceRefs: SourceRef[];
-  }): Promise<RuleVersion>;
-  approveRuleVersion(input: {
-    ruleVersionId: string;
-    approver: string;
-  }): Promise<RuleVersion>;
-  publishSnapshot(input: {
+    status: 'draft' | 'approved' | 'rejected';
+    approvedBy?: string;
+    approvedAt?: Date;
+    createdAt: Date;
+}
+interface KBSnapshot {
+    id: string;
     jurisdiction: string;
     asOfDate: Date;
-  }): Promise<KBSnapshot>;
-  search(input: {
-    snapshotId: string;
-    jurisdiction: string;
-    query: string;
-  }): Promise<{
-    items: {
-      ruleVersionId: string;
-      excerpt?: string;
-    }[];
-  }>;
+    includedRuleVersionIds: string[];
+    publishedAt: Date;
+}
+export interface MemoryKbStore {
+    sources: Map<string, SourceDocument>;
+    rules: Map<string, Rule>;
+    ruleVersions: Map<string, RuleVersion>;
+    snapshots: Map<string, KBSnapshot>;
+    nextRuleVersionNumberByRuleId: Map<string, number>;
+}
+export declare function createMemoryKbStore(): MemoryKbStore;
+export interface MemoryKbHandlers {
+    createRule(rule: Rule): Promise<Rule>;
+    ingestSource(input: Omit<SourceDocument, 'id'>): Promise<SourceDocument>;
+    upsertRuleVersion(input: {
+        ruleId: string;
+        content: string;
+        sourceRefs: SourceRef[];
+    }): Promise<RuleVersion>;
+    approveRuleVersion(input: {
+        ruleVersionId: string;
+        approver: string;
+    }): Promise<RuleVersion>;
+    publishSnapshot(input: {
+        jurisdiction: string;
+        asOfDate: Date;
+    }): Promise<KBSnapshot>;
+    search(input: {
+        snapshotId: string;
+        jurisdiction: string;
+        query: string;
+    }): Promise<{
+        items: {
+            ruleVersionId: string;
+            excerpt?: string;
+        }[];
+    }>;
 }
-declare function createMemoryKbHandlers(store: MemoryKbStore): MemoryKbHandlers;
-//#endregion
-export { MemoryKbHandlers, MemoryKbStore, createMemoryKbHandlers, createMemoryKbStore };
+export declare function createMemoryKbHandlers(store: MemoryKbStore): MemoryKbHandlers;
+export {};
 //# sourceMappingURL=memory.handlers.d.ts.map

package/dist/handlers/memory.handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory.handlers.d.ts","names":[],"sources":["../../src/handlers/memory.handlers.ts"],"mappings":";UAAU,SAAA;EACR,gBAAA;EACA,OAAA;AAAA;AAAA,UAEQ,cAAA;EACR,EAAA;EACA,YAAA;EACA,SAAA;EACA,KAAA;EACA,SAAA,EAAW,IAAA;EACX,IAAA;EACA,MAAA;AAAA;AAAA,UAEQ,IAAA;EACR,EAAA;EACA,YAAA;EACA,QAAA;AAAA;AAAA,UAEQ,WAAA;EACR,EAAA;EACA,MAAA;EACA,YAAA;EACA,QAAA;EACA,OAAA;EACA,OAAA;EACA,UAAA,EAAY,SAAA;EACZ,MAAA;EACA,UAAA;EACA,UAAA,GAAa,IAAA;EACb,SAAA,EAAW,IAAA;AAAA;AAAA,UAEH,UAAA;EACR,EAAA;EACA,YAAA;EACA,QAAA,EAAU,IAAA;EACV,sBAAA;EACA,WAAA,EAAa,IAAA;AAAA;AAAA,UAGE,aAAA;EACf,OAAA,EAAS,GAAA,SAAY,cAAA;EACrB,KAAA,EAAO,GAAA,SAAY,IAAA;EACnB,YAAA,EAAc,GAAA,SAAY,WAAA;EAC1B,SAAA,EAAW,GAAA,SAAY,UAAA;EACvB,6BAAA,EAA+B,GAAA;AAAA;AAAA,iBAGjB,mBAAA,CAAA,GAAuB,aAAA;AAAA,UAUtB,gBAAA;EACf,UAAA,CAAW,IAAA,EAAM,IAAA,GAAO,OAAA,CAAQ,IAAA;EAChC,YAAA,CAAa,KAAA,EAAO,IAAA,CAAK,cAAA,UAAwB,OAAA,CAAQ,cAAA;EACzD,iBAAA,CAAkB,KAAA;IAChB,MAAA;IACA,OAAA;IACA,UAAA,EAAY,SAAA;EAAA,IACV,OAAA,CAAQ,WAAA;EACZ,kBAAA,CAAmB,KAAA;IACjB,aAAA;IACA,QAAA;EAAA,IACE,OAAA,CAAQ,WAAA;EACZ,eAAA,CAAgB,KAAA;IACd,YAAA;IACA,QAAA,EAAU,IAAA;EAAA,IACR,OAAA,CAAQ,UAAA;EACZ,MAAA,CAAO,KAAA;IACL,UAAA;IACA,YAAA;IACA,KAAA;EAAA,IACE,OAAA;IAAU,KAAA;MAAS,aAAA;MAAuB,OAAA;IAAA;EAAA;AAAA;AAAA,iBAOhC,sBAAA,CAAuB,KAAA,EAAO,aAAA,GAAgB,gBAAA"}
+{"version":3,"file":"memory.handlers.d.ts","sourceRoot":"","sources":["../../src/handlers/memory.handlers.ts"],"names":[],"mappings":"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"}

package/dist/handlers/memory.handlers.js

@@ -1,103 +1,116 @@
-//#region src/handlers/memory.handlers.ts
+// @bun
+// src/handlers/memory.handlers.ts
 function createMemoryKbStore() {
-	return {
-		sources: /* @__PURE__ */ new Map(),
-		rules: /* @__PURE__ */ new Map(),
-		ruleVersions: /* @__PURE__ */ new Map(),
-		snapshots: /* @__PURE__ */ new Map(),
-		nextRuleVersionNumberByRuleId: /* @__PURE__ */ new Map()
-	};
+  return {
+    sources: new Map,
+    rules: new Map,
+    ruleVersions: new Map,
+    snapshots: new Map,
+    nextRuleVersionNumberByRuleId: new Map
+  };
 }
 function stableId(prefix, value) {
-	return `${prefix}_${value.replace(/[^a-zA-Z0-9_-]/g, "_")}`;
+  return `${prefix}_${value.replace(/[^a-zA-Z0-9_-]/g, "_")}`;
 }
 function createMemoryKbHandlers(store) {
-	async function createRule(rule) {
-		store.rules.set(rule.id, rule);
-		return rule;
-	}
-	async function ingestSource(input) {
-		const id = stableId("src", `${input.jurisdiction}_${input.hash}`);
-		const doc = {
-			id,
-			...input
-		};
-		store.sources.set(id, doc);
-		return doc;
-	}
-	async function upsertRuleVersion(input) {
-		if (!input.sourceRefs.length) throw new Error("SOURCE_REFS_REQUIRED");
-		const rule = store.rules.get(input.ruleId);
-		if (!rule) throw new Error("RULE_NOT_FOUND");
-		const next = (store.nextRuleVersionNumberByRuleId.get(input.ruleId) ?? 0) + 1;
-		const id = stableId("rv", `${input.ruleId}_${next}`);
-		const ruleVersion = {
-			id,
-			ruleId: input.ruleId,
-			jurisdiction: rule.jurisdiction,
-			topicKey: rule.topicKey,
-			version: next.toString(),
-			content: input.content,
-			sourceRefs: input.sourceRefs,
-			status: "draft",
-			createdAt: /* @__PURE__ */ new Date(),
-			approvedAt: void 0,
-			approvedBy: void 0
-		};
-		store.ruleVersions.set(id, ruleVersion);
-		return ruleVersion;
-	}
-	async function approveRuleVersion(input) {
-		const existing = store.ruleVersions.get(input.ruleVersionId);
-		if (!existing) throw new Error("RULE_VERSION_NOT_FOUND");
-		const approved = {
-			...existing,
-			status: "approved",
-			approvedBy: input.approver,
-			approvedAt: /* @__PURE__ */ new Date()
-		};
-		store.ruleVersions.set(approved.id, approved);
-		return approved;
-	}
-	async function publishSnapshot(input) {
-		const approved = [...store.ruleVersions.values()].filter((rv) => rv.status === "approved" && rv.jurisdiction === input.jurisdiction);
-		if (approved.length === 0) throw new Error("NO_APPROVED_RULES");
-		const includedRuleVersionIds = approved.map((rv) => rv.id).sort();
-		const id = stableId("snap", `${input.jurisdiction}_${input.asOfDate.toISOString().slice(0, 10)}_${includedRuleVersionIds.length}`);
-		const snapshot = {
-			id,
-			jurisdiction: input.jurisdiction,
-			asOfDate: input.asOfDate,
-			includedRuleVersionIds,
-			publishedAt: /* @__PURE__ */ new Date()
-		};
-		store.snapshots.set(id, snapshot);
-		return snapshot;
-	}
-	async function search(input) {
-		const snapshot = store.snapshots.get(input.snapshotId);
-		if (!snapshot) throw new Error("SNAPSHOT_NOT_FOUND");
-		if (snapshot.jurisdiction !== input.jurisdiction) throw new Error("JURISDICTION_MISMATCH");
-		const tokens = input.query.toLowerCase().split(/\s+/).map((t) => t.trim()).filter(Boolean);
-		return { items: snapshot.includedRuleVersionIds.map((id) => store.ruleVersions.get(id)).filter((rv) => Boolean(rv)).filter((rv) => {
-			if (tokens.length === 0) return true;
-			const hay = rv.content.toLowerCase();
-			return tokens.every((token) => hay.includes(token));
-		}).map((rv) => ({
-			ruleVersionId: rv.id,
-			excerpt: rv.content.slice(0, 120)
-		})) };
-	}
-	return {
-		createRule,
-		ingestSource,
-		upsertRuleVersion,
-		approveRuleVersion,
-		publishSnapshot,
-		search
-	};
+  async function createRule(rule) {
+    store.rules.set(rule.id, rule);
+    return rule;
+  }
+  async function ingestSource(input) {
+    const id = stableId("src", `${input.jurisdiction}_${input.hash}`);
+    const doc = { id, ...input };
+    store.sources.set(id, doc);
+    return doc;
+  }
+  async function upsertRuleVersion(input) {
+    if (!input.sourceRefs.length) {
+      throw new Error("SOURCE_REFS_REQUIRED");
+    }
+    const rule = store.rules.get(input.ruleId);
+    if (!rule) {
+      throw new Error("RULE_NOT_FOUND");
+    }
+    const next = (store.nextRuleVersionNumberByRuleId.get(input.ruleId) ?? 0) + 1;
+    const id = stableId("rv", `${input.ruleId}_${next}`);
+    const ruleVersion = {
+      id,
+      ruleId: input.ruleId,
+      jurisdiction: rule.jurisdiction,
+      topicKey: rule.topicKey,
+      version: next.toString(),
+      content: input.content,
+      sourceRefs: input.sourceRefs,
+      status: "draft",
+      createdAt: new Date,
+      approvedAt: undefined,
+      approvedBy: undefined
+    };
+    store.ruleVersions.set(id, ruleVersion);
+    return ruleVersion;
+  }
+  async function approveRuleVersion(input) {
+    const existing = store.ruleVersions.get(input.ruleVersionId);
+    if (!existing) {
+      throw new Error("RULE_VERSION_NOT_FOUND");
+    }
+    const approved = {
+      ...existing,
+      status: "approved",
+      approvedBy: input.approver,
+      approvedAt: new Date
+    };
+    store.ruleVersions.set(approved.id, approved);
+    return approved;
+  }
+  async function publishSnapshot(input) {
+    const approved = [...store.ruleVersions.values()].filter((rv) => rv.status === "approved" && rv.jurisdiction === input.jurisdiction);
+    if (approved.length === 0) {
+      throw new Error("NO_APPROVED_RULES");
+    }
+    const includedRuleVersionIds = approved.map((rv) => rv.id).sort();
+    const id = stableId("snap", `${input.jurisdiction}_${input.asOfDate.toISOString().slice(0, 10)}_${includedRuleVersionIds.length}`);
+    const snapshot = {
+      id,
+      jurisdiction: input.jurisdiction,
+      asOfDate: input.asOfDate,
+      includedRuleVersionIds,
+      publishedAt: new Date
+    };
+    store.snapshots.set(id, snapshot);
+    return snapshot;
+  }
+  async function search(input) {
+    const snapshot = store.snapshots.get(input.snapshotId);
+    if (!snapshot) {
+      throw new Error("SNAPSHOT_NOT_FOUND");
+    }
+    if (snapshot.jurisdiction !== input.jurisdiction) {
+      throw new Error("JURISDICTION_MISMATCH");
+    }
+    const q = input.query.toLowerCase();
+    const tokens = q.split(/\s+/).map((t) => t.trim()).filter(Boolean);
+    const items = snapshot.includedRuleVersionIds.map((id) => store.ruleVersions.get(id)).filter((rv) => Boolean(rv)).filter((rv) => {
+      if (tokens.length === 0)
+        return true;
+      const hay = rv.content.toLowerCase();
+      return tokens.every((token) => hay.includes(token));
+    }).map((rv) => ({
+      ruleVersionId: rv.id,
+      excerpt: rv.content.slice(0, 120)
+    }));
+    return { items };
+  }
+  return {
+    createRule,
+    ingestSource,
+    upsertRuleVersion,
+    approveRuleVersion,
+    publishSnapshot,
+    search
+  };
 }
-
-//#endregion
-export { createMemoryKbHandlers, createMemoryKbStore };
-//# sourceMappingURL=memory.handlers.js.map
+export {
+  createMemoryKbStore,
+  createMemoryKbHandlers
+};

package/dist/handlers/memory.handlers.test.d.ts

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

package/dist/handlers/memory.handlers.test.d.ts.map

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

package/dist/index.d.ts

@@ -1,9 +1,13 @@
-import { KBSnapshotModel, RuleModel, RuleVersionModel, SourceDocumentModel, SourceRefModel } from "./entities/models.js";
-import "./entities/index.js";
-import { KbRuleVersionApprovedEvent, KbRuleVersionCreatedEvent, KbSnapshotPublishedEvent, KbSourceIngestedEvent } from "./events.js";
-import example from "./example.js";
-import { MemoryKbHandlers, MemoryKbStore, createMemoryKbHandlers, createMemoryKbStore } from "./handlers/memory.handlers.js";
-import { KbApproveRuleVersionContract, KbIngestSourceContract, KbPublishSnapshotContract, KbSearchContract, KbUpsertRuleVersionContract } from "./operations/kb.js";
-import "./operations/index.js";
-import { VersionedKnowledgeBaseFeature } from "./versioned-knowledge-base.feature.js";
-export { KBSnapshotModel, KbApproveRuleVersionContract, KbIngestSourceContract, KbPublishSnapshotContract, KbRuleVersionApprovedEvent, KbRuleVersionCreatedEvent, KbSearchContract, KbSnapshotPublishedEvent, KbSourceIngestedEvent, KbUpsertRuleVersionContract, MemoryKbHandlers, MemoryKbStore, RuleModel, RuleVersionModel, SourceDocumentModel, SourceRefModel, VersionedKnowledgeBaseFeature, createMemoryKbHandlers, createMemoryKbStore, example };
+/**
+ * Versioned Knowledge Base Example
+ *
+ * Curated KB with immutable sources, reviewable rule versions, and published snapshots.
+ */
+export * from './entities';
+export * from './operations';
+export * from './events';
+export * from './handlers';
+export * from './versioned-knowledge-base.feature';
+export { default as example } from './example';
+import './docs';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,oCAAoC,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,QAAQ,CAAC"}