@heavybit/shared-lib 0.0.0-stage → 1.2.0

package/dist/types/contracts/editorial-draft.d.ts

@@ -0,0 +1,577 @@
+import { z } from 'zod';
+/**
+ * The newswire → editorial draft hand-off (design Appendix A.4 plus `paragraphFactIds` and
+ * `image.uploadId`, decision R14). newswire-service stages it through its outbox; editorial-service
+ * validates it with the same schema before creating the story. One contract for both sides.
+ */
+export declare const EDITORIAL_DRAFT_SUBMIT = "editorial:draft.submit";
+/** Field limits of the contract (editorial's story columns). */
+export declare const EDITORIAL_DRAFT_LIMITS: {
+    readonly headline: 200;
+    readonly excerpt: 400;
+    readonly tags: 6;
+    readonly seoTitle: 70;
+    readonly seoDescription: 170;
+};
+export declare const DRAFT_SOURCE_ROLES: readonly ["primary", "corroborating"];
+export declare const DRAFT_RISKS: readonly ["low", "medium", "high"];
+export declare const GATE_VERDICTS: readonly ["pass", "review", "block"];
+/**
+ * Every quality gate newswire runs on a draft, in design order. A submitted draft carries one result per
+ * gate; editorial treats a missing one as not passed (auto-publish never runs on an unchecked draft).
+ */
+export declare const QUALITY_GATE_NAMES: readonly ["originality", "grounding", "quote_limits", "corroboration", "conflicts", "sensitivity", "category", "freshness", "duplicate_of_published", "length_format"];
+export type QualityGateName = (typeof QUALITY_GATE_NAMES)[number];
+export declare const FACT_KINDS: readonly ["event", "person", "date", "place", "number", "quote", "context"];
+export declare const editorialDraftSubmitSchema: z.ZodEffects<z.ZodObject<{
+    draftId: z.ZodString;
+    clusterId: z.ZodString;
+    headline: z.ZodString;
+    excerpt: z.ZodString;
+    paragraphs: z.ZodArray<z.ZodString, "many">;
+    /** The fact-sheet fact ids each paragraph asserts (same length as `paragraphs`). */
+    paragraphFactIds: z.ZodArray<z.ZodArray<z.ZodString, "many">, "many">;
+    category: z.ZodString;
+    tags: z.ZodArray<z.ZodString, "many">;
+    seo: z.ZodObject<{
+        title: z.ZodString;
+        description: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        title: string;
+    }, {
+        description: string;
+        title: string;
+    }>;
+    social: z.ZodObject<{
+        facebook: z.ZodString;
+        x: z.ZodString;
+        whatsapp: z.ZodString;
+        instagram: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        facebook: string;
+        x: string;
+        whatsapp: string;
+        instagram: string;
+    }, {
+        facebook: string;
+        x: string;
+        whatsapp: string;
+        instagram: string;
+    }>;
+    sources: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        url: z.ZodEffects<z.ZodString, string, string>;
+        publishedAt: z.ZodOptional<z.ZodString>;
+        role: z.ZodEnum<["primary", "corroborating"]>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        url: string;
+        role: "primary" | "corroborating";
+        publishedAt?: string | undefined;
+    }, {
+        name: string;
+        url: string;
+        role: "primary" | "corroborating";
+        publishedAt?: string | undefined;
+    }>, "many">;
+    /** An imported or profile cover (upload-service id), or null when the draft has none. */
+    image: z.ZodNullable<z.ZodObject<{
+        uploadId: z.ZodString;
+        credit: z.ZodString;
+        alt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        uploadId: string;
+        credit: string;
+        alt: string;
+    }, {
+        uploadId: string;
+        credit: string;
+        alt: string;
+    }>>;
+    relatedProfileIds: z.ZodArray<z.ZodString, "many">;
+    suggestedProfileIds: z.ZodArray<z.ZodString, "many">;
+    review: z.ZodObject<{
+        confidence: z.ZodNumber;
+        risk: z.ZodEnum<["low", "medium", "high"]>;
+        riskReasons: z.ZodArray<z.ZodString, "many">;
+        gates: z.ZodArray<z.ZodObject<{
+            gate: z.ZodString;
+            verdict: z.ZodEnum<["pass", "review", "block"]>;
+            reasons: z.ZodArray<z.ZodString, "many">;
+            metrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        }, "strip", z.ZodTypeAny, {
+            gate: string;
+            verdict: "pass" | "review" | "block";
+            reasons: string[];
+            metrics?: Record<string, number> | undefined;
+        }, {
+            gate: string;
+            verdict: "pass" | "review" | "block";
+            reasons: string[];
+            metrics?: Record<string, number> | undefined;
+        }>, "many">;
+        factSheet: z.ZodObject<{
+            facts: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                statement: z.ZodString;
+                kind: z.ZodEnum<["event", "person", "date", "place", "number", "quote", "context"]>;
+                entities: z.ZodArray<z.ZodString, "many">;
+                supportedBy: z.ZodArray<z.ZodObject<{
+                    itemId: z.ZodString;
+                    paragraph: z.ZodNumber;
+                }, "strip", z.ZodTypeAny, {
+                    itemId: string;
+                    paragraph: number;
+                }, {
+                    itemId: string;
+                    paragraph: number;
+                }>, "many">;
+                conflictsWith: z.ZodArray<z.ZodString, "many">;
+                independentSources: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                statement: string;
+                kind: "number" | "date" | "event" | "person" | "place" | "quote" | "context";
+                entities: string[];
+                supportedBy: {
+                    itemId: string;
+                    paragraph: number;
+                }[];
+                conflictsWith: string[];
+                independentSources: number;
+            }, {
+                id: string;
+                statement: string;
+                kind: "number" | "date" | "event" | "person" | "place" | "quote" | "context";
+                entities: string[];
+                supportedBy: {
+                    itemId: string;
+                    paragraph: number;
+                }[];
+                conflictsWith: string[];
+                independentSources: number;
+            }>, "many">;
+            quotes: z.ZodArray<z.ZodObject<{
+                itemId: z.ZodString;
+                paragraph: z.ZodNumber;
+            } & {
+                text: z.ZodString;
+                speaker: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                itemId: string;
+                paragraph: number;
+                text: string;
+                speaker: string;
+            }, {
+                itemId: string;
+                paragraph: number;
+                text: string;
+                speaker: string;
+            }>, "many">;
+            conflicts: z.ZodArray<z.ZodObject<{
+                description: z.ZodString;
+                factIds: z.ZodArray<z.ZodString, "many">;
+            }, "strip", z.ZodTypeAny, {
+                description: string;
+                factIds: string[];
+            }, {
+                description: string;
+                factIds: string[];
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            conflicts: {
+                description: string;
+                factIds: string[];
+            }[];
+            facts: {
+                id: string;
+                statement: string;
+                kind: "number" | "date" | "event" | "person" | "place" | "quote" | "context";
+                entities: string[];
+                supportedBy: {
+                    itemId: string;
+                    paragraph: number;
+                }[];
+                conflictsWith: string[];
+                independentSources: number;
+            }[];
+            quotes: {
+                itemId: string;
+                paragraph: number;
+                text: string;
+                speaker: string;
+            }[];
+        }, {
+            conflicts: {
+                description: string;
+                factIds: string[];
+            }[];
+            facts: {
+                id: string;
+                statement: string;
+                kind: "number" | "date" | "event" | "person" | "place" | "quote" | "context";
+                entities: string[];
+                supportedBy: {
+                    itemId: string;
+                    paragraph: number;
+                }[];
+                conflictsWith: string[];
+                independentSources: number;
+            }[];
+            quotes: {
+                itemId: string;
+                paragraph: number;
+                text: string;
+                speaker: string;
+            }[];
+        }>;
+        /** Prompt slug → version used to produce the draft. */
+        promptVersions: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        confidence: number;
+        risk: "low" | "medium" | "high";
+        riskReasons: string[];
+        gates: {
+            gate: string;
+            verdict: "pass" | "review" | "block";
+            reasons: string[];
+            metrics?: Record<string, number> | undefined;
+        }[];
+        factSheet: {
+            conflicts: {
+                description: string;
+                factIds: string[];
+            }[];
+            facts: {
+                id: string;
+                statement: string;
+                kind: "number" | "date" | "event" | "person" | "place" | "quote" | "context";
+                entities: string[];
+                supportedBy: {
+                    itemId: string;
+                    paragraph: number;
+                }[];
+                conflictsWith: string[];
+                independentSources: number;
+            }[];
+            quotes: {
+                itemId: string;
+                paragraph: number;
+                text: string;
+                speaker: string;
+            }[];
+        };
+        promptVersions: Record<string, number>;
+    }, {
+        confidence: number;
+        risk: "low" | "medium" | "high";
+        riskReasons: string[];
+        gates: {
+            gate: string;
+            verdict: "pass" | "review" | "block";
+            reasons: string[];
+            metrics?: Record<string, number> | undefined;
+        }[];
+        factSheet: {
+            conflicts: {
+                description: string;
+                factIds: string[];
+            }[];
+            facts: {
+                id: string;
+                statement: string;
+                kind: "number" | "date" | "event" | "person" | "place" | "quote" | "context";
+                entities: string[];
+                supportedBy: {
+                    itemId: string;
+                    paragraph: number;
+                }[];
+                conflictsWith: string[];
+                independentSources: number;
+            }[];
+            quotes: {
+                itemId: string;
+                paragraph: number;
+                text: string;
+                speaker: string;
+            }[];
+        };
+        promptVersions: Record<string, number>;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    review: {
+        confidence: number;
+        risk: "low" | "medium" | "high";
+        riskReasons: string[];
+        gates: {
+            gate: string;
+            verdict: "pass" | "review" | "block";
+            reasons: string[];
+            metrics?: Record<string, number> | undefined;
+        }[];
+        factSheet: {
+            conflicts: {
+                description: string;
+                factIds: string[];
+            }[];
+            facts: {
+                id: string;
+                statement: string;
+                kind: "number" | "date" | "event" | "person" | "place" | "quote" | "context";
+                entities: string[];
+                supportedBy: {
+                    itemId: string;
+                    paragraph: number;
+                }[];
+                conflictsWith: string[];
+                independentSources: number;
+            }[];
+            quotes: {
+                itemId: string;
+                paragraph: number;
+                text: string;
+                speaker: string;
+            }[];
+        };
+        promptVersions: Record<string, number>;
+    };
+    category: string;
+    draftId: string;
+    clusterId: string;
+    headline: string;
+    excerpt: string;
+    paragraphs: string[];
+    paragraphFactIds: string[][];
+    tags: string[];
+    seo: {
+        description: string;
+        title: string;
+    };
+    social: {
+        facebook: string;
+        x: string;
+        whatsapp: string;
+        instagram: string;
+    };
+    sources: {
+        name: string;
+        url: string;
+        role: "primary" | "corroborating";
+        publishedAt?: string | undefined;
+    }[];
+    image: {
+        uploadId: string;
+        credit: string;
+        alt: string;
+    } | null;
+    relatedProfileIds: string[];
+    suggestedProfileIds: string[];
+}, {
+    review: {
+        confidence: number;
+        risk: "low" | "medium" | "high";
+        riskReasons: string[];
+        gates: {
+            gate: string;
+            verdict: "pass" | "review" | "block";
+            reasons: string[];
+            metrics?: Record<string, number> | undefined;
+        }[];
+        factSheet: {
+            conflicts: {
+                description: string;
+                factIds: string[];
+            }[];
+            facts: {
+                id: string;
+                statement: string;
+                kind: "number" | "date" | "event" | "person" | "place" | "quote" | "context";
+                entities: string[];
+                supportedBy: {
+                    itemId: string;
+                    paragraph: number;
+                }[];
+                conflictsWith: string[];
+                independentSources: number;
+            }[];
+            quotes: {
+                itemId: string;
+                paragraph: number;
+                text: string;
+                speaker: string;
+            }[];
+        };
+        promptVersions: Record<string, number>;
+    };
+    category: string;
+    draftId: string;
+    clusterId: string;
+    headline: string;
+    excerpt: string;
+    paragraphs: string[];
+    paragraphFactIds: string[][];
+    tags: string[];
+    seo: {
+        description: string;
+        title: string;
+    };
+    social: {
+        facebook: string;
+        x: string;
+        whatsapp: string;
+        instagram: string;
+    };
+    sources: {
+        name: string;
+        url: string;
+        role: "primary" | "corroborating";
+        publishedAt?: string | undefined;
+    }[];
+    image: {
+        uploadId: string;
+        credit: string;
+        alt: string;
+    } | null;
+    relatedProfileIds: string[];
+    suggestedProfileIds: string[];
+}>, {
+    review: {
+        confidence: number;
+        risk: "low" | "medium" | "high";
+        riskReasons: string[];
+        gates: {
+            gate: string;
+            verdict: "pass" | "review" | "block";
+            reasons: string[];
+            metrics?: Record<string, number> | undefined;
+        }[];
+        factSheet: {
+            conflicts: {
+                description: string;
+                factIds: string[];
+            }[];
+            facts: {
+                id: string;
+                statement: string;
+                kind: "number" | "date" | "event" | "person" | "place" | "quote" | "context";
+                entities: string[];
+                supportedBy: {
+                    itemId: string;
+                    paragraph: number;
+                }[];
+                conflictsWith: string[];
+                independentSources: number;
+            }[];
+            quotes: {
+                itemId: string;
+                paragraph: number;
+                text: string;
+                speaker: string;
+            }[];
+        };
+        promptVersions: Record<string, number>;
+    };
+    category: string;
+    draftId: string;
+    clusterId: string;
+    headline: string;
+    excerpt: string;
+    paragraphs: string[];
+    paragraphFactIds: string[][];
+    tags: string[];
+    seo: {
+        description: string;
+        title: string;
+    };
+    social: {
+        facebook: string;
+        x: string;
+        whatsapp: string;
+        instagram: string;
+    };
+    sources: {
+        name: string;
+        url: string;
+        role: "primary" | "corroborating";
+        publishedAt?: string | undefined;
+    }[];
+    image: {
+        uploadId: string;
+        credit: string;
+        alt: string;
+    } | null;
+    relatedProfileIds: string[];
+    suggestedProfileIds: string[];
+}, {
+    review: {
+        confidence: number;
+        risk: "low" | "medium" | "high";
+        riskReasons: string[];
+        gates: {
+            gate: string;
+            verdict: "pass" | "review" | "block";
+            reasons: string[];
+            metrics?: Record<string, number> | undefined;
+        }[];
+        factSheet: {
+            conflicts: {
+                description: string;
+                factIds: string[];
+            }[];
+            facts: {
+                id: string;
+                statement: string;
+                kind: "number" | "date" | "event" | "person" | "place" | "quote" | "context";
+                entities: string[];
+                supportedBy: {
+                    itemId: string;
+                    paragraph: number;
+                }[];
+                conflictsWith: string[];
+                independentSources: number;
+            }[];
+            quotes: {
+                itemId: string;
+                paragraph: number;
+                text: string;
+                speaker: string;
+            }[];
+        };
+        promptVersions: Record<string, number>;
+    };
+    category: string;
+    draftId: string;
+    clusterId: string;
+    headline: string;
+    excerpt: string;
+    paragraphs: string[];
+    paragraphFactIds: string[][];
+    tags: string[];
+    seo: {
+        description: string;
+        title: string;
+    };
+    social: {
+        facebook: string;
+        x: string;
+        whatsapp: string;
+        instagram: string;
+    };
+    sources: {
+        name: string;
+        url: string;
+        role: "primary" | "corroborating";
+        publishedAt?: string | undefined;
+    }[];
+    image: {
+        uploadId: string;
+        credit: string;
+        alt: string;
+    } | null;
+    relatedProfileIds: string[];
+    suggestedProfileIds: string[];
+}>;
+export type EditorialDraftSubmit = z.infer<typeof editorialDraftSubmitSchema>;
+export type EditorialDraftSource = EditorialDraftSubmit['sources'][number];
+//# sourceMappingURL=editorial-draft.d.ts.map

package/dist/types/contracts/editorial-draft.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editorial-draft.d.ts","sourceRoot":"","sources":["../../../src/contracts/editorial-draft.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAE/D,gEAAgE;AAChE,eAAO,MAAM,sBAAsB;;;;;;CAMzB,CAAC;AAEX,eAAO,MAAM,kBAAkB,uCAAwC,CAAC;AACxE,eAAO,MAAM,WAAW,oCAAqC,CAAC;AAC9D,eAAO,MAAM,aAAa,sCAAuC,CAAC;AAClE;;;GAGG;AACH,eAAO,MAAM,kBAAkB,wKAGrB,CAAC;AACX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAClE,eAAO,MAAM,UAAU,6EAA8E,CAAC;AAuCtG,eAAO,MAAM,0BAA0B;;;;;;IAOnC,oFAAoF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUpF,yFAAyF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAcvF,uDAAuD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBzD,CAAC;AAEL,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/types/contracts/index.d.ts

@@ -0,0 +1,4 @@
+export * from './editorial-draft.js';
+export * from './notification-dispatch.js';
+export * from './upload-import.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/contracts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/contracts/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC"}