@hraness/oh 0.2.3

package/dist/contract.d.ts

@@ -0,0 +1,33 @@
+import { type JsonValue, type Sha256Hex } from "./canonical";
+import { OH_GRAPH_FORMAT_VERSION_V1, type KnowledgeGraphRecordKindV1 } from "./graph";
+import { OH_CONTRACT_ID_V1, OH_ONTOLOGY_VERSION_V1 } from "./ontology";
+import { OH_SCHEMA_FORMAT_VERSION_V1 } from "./schema";
+export type OhContractManifestV1 = Readonly<{
+    contractId: typeof OH_CONTRACT_ID_V1;
+    contractSha256: Sha256Hex;
+    graphFormatVersion: typeof OH_GRAPH_FORMAT_VERSION_V1;
+    ontologyVersion: typeof OH_ONTOLOGY_VERSION_V1;
+    recordKinds: readonly KnowledgeGraphRecordKindV1[];
+    schemaFormatVersion: typeof OH_SCHEMA_FORMAT_VERSION_V1;
+    v: 1;
+}>;
+export declare const OH_CONTRACT_MANIFEST_V1: OhContractManifestV1;
+/** Accepts only the complete, byte-equivalent V1 contract manifest. */
+export declare function parseOhContractManifestV1(value: unknown): OhContractManifestV1 | null;
+export type OhRecordCodec<T extends JsonValue = JsonValue> = Readonly<{
+    kind: KnowledgeGraphRecordKindV1;
+    parse(value: unknown): T | null;
+}>;
+/** Optional semantic validation layered over the immutable generic record envelope. */
+export declare class OhRecordCodecRegistry {
+    #private;
+    register(codec: OhRecordCodec): this;
+    parse(kind: KnowledgeGraphRecordKindV1, value: unknown): JsonValue | null;
+    has(kind: KnowledgeGraphRecordKindV1): boolean;
+    /** Parses only through an explicitly registered codec. */
+    parseRequired(kind: KnowledgeGraphRecordKindV1, value: unknown): JsonValue | null;
+    /** Prevents the validation policy from changing after an ingress is created. */
+    seal(): this;
+    get sealed(): boolean;
+}
+//# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7F,OAAO,EAAE,0BAA0B,EACjC,KAAK,0BAA0B,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AAEvD,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,UAAU,EAAE,OAAO,iBAAiB,CAAC;IACrC,cAAc,EAAE,SAAS,CAAC;IAC1B,kBAAkB,EAAE,OAAO,0BAA0B,CAAC;IACtD,eAAe,EAAE,OAAO,sBAAsB,CAAC;IAC/C,WAAW,EAAE,SAAS,0BAA0B,EAAE,CAAC;IACnD,mBAAmB,EAAE,OAAO,2BAA2B,CAAC;IACxD,CAAC,EAAE,CAAC,CAAC;CACN,CAAC,CAAC;AAWH,eAAO,MAAM,uBAAuB,EAAE,oBAGpC,CAAC;AAEH,uEAAuE;AACvE,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,GAAG,IAAI,CAKrF;AAED,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,IAAI,QAAQ,CAAC;IACpE,IAAI,EAAE,0BAA0B,CAAC;IACjC,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC;CACjC,CAAC,CAAC;AAEH,uFAAuF;AACvF,qBAAa,qBAAqB;;IAIhC,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAOpC,KAAK,CAAC,IAAI,EAAE,0BAA0B,EAAE,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI;IAMzE,GAAG,CAAC,IAAI,EAAE,0BAA0B,GAAG,OAAO;IAI9C,0DAA0D;IAC1D,aAAa,CAAC,IAAI,EAAE,0BAA0B,EAAE,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI;IAWjF,gFAAgF;IAChF,IAAI,IAAI,IAAI;IAKZ,IAAI,MAAM,IAAI,OAAO,CAEpB;CACF"}

package/dist/graph.d.ts

@@ -0,0 +1,67 @@
+import { type JsonValue, type Sha256Hex } from "./canonical";
+export declare const OH_GRAPH_FORMAT_VERSION_V1: 1;
+export declare const OH_GRAPH_LIMITS_V1: Readonly<{
+    changesPerOperation: 8192;
+    dependenciesPerRecord: 4096;
+    recordBytes: number;
+    recordsPerSnapshot: 65536;
+}>;
+export declare const OH_KNOWLEDGE_GRAPH_RECORD_KINDS_V1: readonly ["activity", "assertion", "context", "dependency-manifest", "edition", "entity", "evidence", "identity-operation", "inquiry", "inquiry-event", "review-decision", "rights-decision", "schema", "shape", "statement", "type-membership", "view", "vocabulary"];
+export type KnowledgeGraphRecordKindV1 = (typeof OH_KNOWLEDGE_GRAPH_RECORD_KINDS_V1)[number];
+export type KnowledgeGraphRecordV1 = Readonly<{
+    dependencies: readonly string[];
+    key: string;
+    kind: KnowledgeGraphRecordKindV1;
+    recordSha256: Sha256Hex;
+    v: 1;
+    value: JsonValue;
+}>;
+export type KnowledgeGraphRecordInputV1 = Omit<KnowledgeGraphRecordV1, "recordSha256">;
+export type KnowledgeGraphRecordRefV1 = Readonly<{
+    dependencies: readonly string[];
+    key: string;
+    kind: KnowledgeGraphRecordKindV1;
+    sha256: Sha256Hex;
+    v: 1;
+}>;
+export declare function createKnowledgeGraphRecordV1(input: KnowledgeGraphRecordInputV1): KnowledgeGraphRecordV1;
+export declare function parseKnowledgeGraphRecordV1(value: unknown): KnowledgeGraphRecordV1 | null;
+export declare function knowledgeGraphRecordRefV1(record: KnowledgeGraphRecordV1): KnowledgeGraphRecordRefV1;
+export type KnowledgeGraphChangeV1 = Readonly<{
+    kind: "put";
+    record: KnowledgeGraphRecordV1;
+    v: 1;
+}> | Readonly<{
+    key: string;
+    kind: "tombstone";
+    priorSha256: Sha256Hex;
+    v: 1;
+}>;
+export type KnowledgeGraphRevisionV1 = Readonly<{
+    changes: readonly KnowledgeGraphChangeV1[];
+    graphRevisionSha256: Sha256Hex;
+    operationId: string;
+    parentGraphRevisionSha256: Sha256Hex | null;
+    recordRefs: readonly KnowledgeGraphRecordRefV1[];
+    recordsSha256: Sha256Hex;
+    revision: number;
+    v: 1;
+}>;
+export declare function canonicalKnowledgeGraphChangesV1(changes: readonly KnowledgeGraphChangeV1[]): readonly KnowledgeGraphChangeV1[];
+/** Hashes the canonical graph transition envelope used by snapshots and operations. */
+export declare function graphRevisionSha256V1(input: Readonly<{
+    changes: readonly KnowledgeGraphChangeV1[];
+    operationId: string;
+    parentGraphRevisionSha256: Sha256Hex | null;
+    recordsSha256: Sha256Hex;
+    revision: number;
+}>): Sha256Hex;
+export declare function createKnowledgeGraphRevisionV1(input: Readonly<{
+    changes: readonly KnowledgeGraphChangeV1[];
+    operationId: string;
+    parent: KnowledgeGraphRevisionV1 | null;
+}>): KnowledgeGraphRevisionV1;
+export declare function parseKnowledgeGraphRevisionV1(value: unknown): KnowledgeGraphRevisionV1 | null;
+/** Deterministically reduces a revision chain and rejects gaps, forks, and false snapshots. */
+export declare function reduceKnowledgeGraphRevisionsV1(revisions: readonly KnowledgeGraphRevisionV1[]): KnowledgeGraphRevisionV1 | null;
+//# sourceMappingURL=graph.d.ts.map

package/dist/graph.d.ts.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./canonical";
+export * from "./contract";
+export * from "./graph";
+export * from "./ontology";
+export * from "./operation";
+export * from "./schema";
+export * from "./store";
+export * from "./sync";
+//# 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,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC"}