@knpkv/control-center 0.1.0

package/dist/server/server/application/normalizedPluginPageMaterialization.d.ts

@@ -0,0 +1,109 @@
+import * as Crypto from "effect/Crypto";
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import type { PluginHealth } from "../../domain/freshness.js";
+import { type PluginConnectionId, type WorkspaceId } from "../../domain/identifiers.js";
+import { type ProviderId } from "../../domain/sourceRevision.js";
+import type { UtcTimestamp } from "../../domain/utcTimestamp.js";
+import type { PersistenceOperationFailure } from "../persistence/Persistence.js";
+import { Persistence } from "../persistence/Persistence.js";
+import type { PluginStreamKey } from "../persistence/repositories/pluginRuntimeModels.js";
+import type { PluginConflictFailure } from "../plugins/failures.js";
+import { type PluginSynchronizationAuthority } from "./pluginSynchronizationAuthority.js";
+declare const NormalizedPluginPageMaterializationError_base: Schema.Class<NormalizedPluginPageMaterializationError, Schema.TaggedStruct<"NormalizedPluginPageMaterializationError", {
+    readonly diagnosticCode: Schema.String;
+    readonly eventId: Schema.NullOr<Schema.String>;
+}>, import("effect/Cause").YieldableError>;
+/** Redacted failure raised before a normalized page can become a canonical projection. */
+export declare class NormalizedPluginPageMaterializationError extends NormalizedPluginPageMaterializationError_base {
+}
+/** Host authority supplied separately from provider-controlled normalized data. */
+export interface NormalizedPluginPageMaterializationScope {
+    readonly workspaceId: WorkspaceId;
+    readonly pluginConnectionId: PluginConnectionId;
+    readonly providerId: ProviderId;
+    readonly streamKey: PluginStreamKey;
+    readonly expectedRevision: number;
+    readonly committedAt: UtcTimestamp;
+    readonly successfulHealth: Extract<PluginHealth, {
+        readonly _tag: "healthy" | "degraded";
+    }>;
+    readonly expectedAuthority?: PluginSynchronizationAuthority;
+}
+/** Durable counts from one new page, or zero counts when the exact page is replayed. */
+export interface NormalizedPluginPageMaterializationReceipt {
+    readonly pageCommitted: boolean;
+    readonly acceptedEventCount: number;
+    readonly entityProjectionCount: number;
+    readonly evidenceClaimCount: number;
+    readonly evidenceItemCount: number;
+    readonly nodeCount: number;
+    readonly personCount: number;
+    readonly relationshipCount: number;
+    readonly skippedEntityCount: number;
+}
+/**
+ * Commit one decoded page and all accepted canonical projections atomically.
+ * The existing plugin checkpoint transaction nests as a savepoint; only its
+ * newly accepted event identities cross the materialization seam.
+ */
+export declare const materializeNormalizedPluginPage: (scope: NormalizedPluginPageMaterializationScope, page: Schema.Struct.ReadonlySide<{
+    readonly events: Schema.$Array<Schema.toTaggedUnion<"_tag", readonly [Schema.TaggedStruct<"UpsertEntity", {
+        readonly sourceUrl: Schema.NullOr<Schema.decodeTo<Schema.URL, Schema.String, never, never>>;
+        readonly title: Schema.String;
+        readonly attributes: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+        readonly entityType: Schema.brand<Schema.String, string>;
+        readonly vendorImmutableId: Schema.brand<Schema.String, "VendorImmutableId">;
+        readonly eventId: Schema.brand<Schema.String, string>;
+        readonly observedAt: Schema.DateTimeUtcFromString;
+        readonly revision: Schema.brand<Schema.String, "Revision">;
+    }>, Schema.TaggedStruct<"TombstoneEntity", {
+        readonly reason: Schema.String;
+        readonly entityType: Schema.brand<Schema.String, string>;
+        readonly vendorImmutableId: Schema.brand<Schema.String, "VendorImmutableId">;
+        readonly eventId: Schema.brand<Schema.String, string>;
+        readonly observedAt: Schema.DateTimeUtcFromString;
+        readonly revision: Schema.brand<Schema.String, "Revision">;
+    }>, Schema.TaggedStruct<"AppendEvidence", {
+        readonly evidenceId: Schema.brand<Schema.String, string>;
+        readonly subject: Schema.Struct<{
+            entityType: Schema.brand<Schema.String, string>;
+            vendorImmutableId: Schema.brand<Schema.String, "VendorImmutableId">;
+        }>;
+        readonly evidenceType: Schema.brand<Schema.String, string>;
+        readonly summary: Schema.String;
+        readonly capturedAt: Schema.DateTimeUtcFromString;
+        readonly data: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+        readonly eventId: Schema.brand<Schema.String, string>;
+        readonly observedAt: Schema.DateTimeUtcFromString;
+        readonly revision: Schema.brand<Schema.String, "Revision">;
+    }>, Schema.TaggedStruct<"UpsertPerson", {
+        readonly vendorPersonId: Schema.brand<Schema.String, string>;
+        readonly displayName: Schema.String;
+        readonly avatarUrl: Schema.NullOr<Schema.decodeTo<Schema.URL, Schema.String, never, never>>;
+        readonly active: Schema.Boolean;
+        readonly eventId: Schema.brand<Schema.String, string>;
+        readonly observedAt: Schema.DateTimeUtcFromString;
+        readonly revision: Schema.brand<Schema.String, "Revision">;
+    }>, Schema.TaggedStruct<"ProposeRelationship", {
+        readonly relationshipId: Schema.brand<Schema.String, string>;
+        readonly from: Schema.Struct<{
+            entityType: Schema.brand<Schema.String, string>;
+            vendorImmutableId: Schema.brand<Schema.String, "VendorImmutableId">;
+        }>;
+        readonly to: Schema.Struct<{
+            entityType: Schema.brand<Schema.String, string>;
+            vendorImmutableId: Schema.brand<Schema.String, "VendorImmutableId">;
+        }>;
+        readonly relationshipType: Schema.brand<Schema.String, string>;
+        readonly confidence: Schema.Number;
+        readonly evidenceIds: Schema.$Array<Schema.brand<Schema.String, string>>;
+        readonly eventId: Schema.brand<Schema.String, string>;
+        readonly observedAt: Schema.DateTimeUtcFromString;
+        readonly revision: Schema.brand<Schema.String, "Revision">;
+    }>]>>;
+    readonly checkpointAfterPage: Schema.brand<Schema.String, string>;
+    readonly hasMore: Schema.Boolean;
+}, "Type">) => Effect.Effect<NormalizedPluginPageMaterializationReceipt, PluginConflictFailure | PersistenceOperationFailure | NormalizedPluginPageMaterializationError, Crypto.Crypto | Persistence>;
+export {};
+//# sourceMappingURL=normalizedPluginPageMaterialization.d.ts.map

package/dist/server/server/application/normalizedPluginPageMaterialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizedPluginPageMaterialization.d.ts","sourceRoot":"","sources":["../../../../src/server/application/normalizedPluginPageMaterialization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAGvC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAavC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAC7D,OAAO,EAOL,KAAK,kBAAkB,EAGvB,KAAK,WAAW,EACjB,MAAM,6BAA6B,CAAA;AAKpC,OAAO,EAA8B,KAAK,UAAU,EAAqB,MAAM,gCAAgC,CAAA;AAC/G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,KAAK,EAAE,2BAA2B,EAAsB,MAAM,+BAA+B,CAAA;AACpG,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAG3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oDAAoD,CAAA;AACzF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AACnE,OAAO,EACL,KAAK,8BAA8B,EAEpC,MAAM,qCAAqC,CAAA;;;;;AAiF5C,0FAA0F;AAC1F,qBAAa,wCAAyC,SAAQ,6CAK5D;CAAG;AA0+BL,mFAAmF;AACnF,MAAM,WAAW,wCAAwC;IACvD,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAA;IAC/C,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;IAC/B,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAA;IACnC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAA;IAClC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC,YAAY,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU,CAAA;KAAE,CAAC,CAAA;IAC3F,QAAQ,CAAC,iBAAiB,CAAC,EAAE,8BAA8B,CAAA;CAC5D;AAED,wFAAwF;AACxF,MAAM,WAAW,0CAA0C;IACzD,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;IACnC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAA;IACtC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;IACnC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;CACpC;AAED;;;;GAIG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qMA+F1C,CAAA"}