@heavybit/shared-lib 1.3.2 → 2.1.0

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

@@ -1,610 +0,0 @@
-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;
-    /** Reader-facing update note ("Updated with …"), shown under the article byline. */
-    readonly updateNote: 300;
-};
-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>;
-    }>;
-    /**
-     * Present when the draft updates a story editorial has already published (Phase 21.2): editorial
-     * stores it as a pending update on that story instead of creating a new one. Additive and optional.
-     */
-    updateOf: z.ZodOptional<z.ZodObject<{
-        storyId: z.ZodString;
-        note: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        storyId: string;
-        note: string;
-    }, {
-        storyId: string;
-        note: string;
-    }>>;
-}, "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[];
-    updateOf?: {
-        storyId: string;
-        note: string;
-    } | undefined;
-}, {
-    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[];
-    updateOf?: {
-        storyId: string;
-        note: string;
-    } | undefined;
-}>, {
-    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[];
-    updateOf?: {
-        storyId: string;
-        note: string;
-    } | undefined;
-}, {
-    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[];
-    updateOf?: {
-        storyId: string;
-        note: string;
-    } | undefined;
-}>;
-export type EditorialDraftSubmit = z.infer<typeof editorialDraftSubmitSchema>;
-export type EditorialDraftSource = EditorialDraftSubmit['sources'][number];
-export type EditorialDraftUpdateOf = NonNullable<EditorialDraftSubmit['updateOf']>;
-//# sourceMappingURL=editorial-draft.d.ts.map

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

@@ -1 +0,0 @@
-{"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;;;;;;IAMjC,oFAAoF;;CAE5E,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAGzD;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBH,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;AAC3E,MAAM,MAAM,sBAAsB,GAAG,WAAW,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC,CAAC"}

package/dist/types/contracts/upload-import.d.ts

@@ -1,96 +0,0 @@
-import { z } from 'zod';
-/**
- * Licensed image import by URL (Newswire R5, decision R39). newswire-service (and later
- * editorial-service) sends `upload:import`; upload-service fetches the file and answers with an
- * `upload.import.completed` or `upload.import.failed` event. One contract for both sides.
- */
-export declare const UPLOAD_IMPORT = "upload:import";
-export declare const UPLOAD_IMPORT_EVENTS: {
-    readonly COMPLETED: "upload.import.completed";
-    readonly FAILED: "upload.import.failed";
-};
-/** Upload policies an import may use. */
-export declare const UPLOAD_IMPORT_POLICIES: readonly ["news_image"];
-export type UploadImportPolicy = (typeof UPLOAD_IMPORT_POLICIES)[number];
-/** Field limits of the contract (upload-service's `uploads` columns). */
-export declare const UPLOAD_IMPORT_LIMITS: {
-    readonly url: 2048;
-    readonly ownerType: 50;
-    readonly licenceHolder: 160;
-    readonly licenceBasis: 255;
-    readonly reason: 255;
-};
-/**
- * `upload:import` data. The URL is only length-checked here: upload-service rejects a non-https or
- * unsafe URL itself, so the sender hears about it through a `failed` event instead of a dead letter.
- */
-export declare const uploadImportCommandSchema: z.ZodObject<{
-    /** ULID the outcome event echoes back; upload-service is idempotent on it. */
-    importId: z.ZodString;
-    url: z.ZodString;
-    policy: z.ZodEnum<["news_image"]>;
-    /** Echoed in the outcome only; the imported upload is a system row with no owner. */
-    ownerType: z.ZodString;
-    ownerId: z.ZodString;
-    licence: z.ZodObject<{
-        holder: z.ZodString;
-        basis: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        holder: string;
-        basis: string;
-    }, {
-        holder: string;
-        basis: string;
-    }>;
-}, "strip", z.ZodTypeAny, {
-    url: string;
-    importId: string;
-    policy: "news_image";
-    ownerType: string;
-    ownerId: string;
-    licence: {
-        holder: string;
-        basis: string;
-    };
-}, {
-    url: string;
-    importId: string;
-    policy: "news_image";
-    ownerType: string;
-    ownerId: string;
-    licence: {
-        holder: string;
-        basis: string;
-    };
-}>;
-export declare const uploadImportCompletedSchema: z.ZodObject<{
-    importId: z.ZodString;
-    uploadId: z.ZodString;
-    ownerType: z.ZodString;
-    ownerId: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    uploadId: string;
-    importId: string;
-    ownerType: string;
-    ownerId: string;
-}, {
-    uploadId: string;
-    importId: string;
-    ownerType: string;
-    ownerId: string;
-}>;
-/** `reason` is a machine code (`too_large`, `http_404`, …; see upload-service `ImportFailureReason`). */
-export declare const uploadImportFailedSchema: z.ZodObject<{
-    importId: z.ZodString;
-    reason: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    reason: string;
-    importId: string;
-}, {
-    reason: string;
-    importId: string;
-}>;
-export type UploadImportCommand = z.infer<typeof uploadImportCommandSchema>;
-export type UploadImportCompleted = z.infer<typeof uploadImportCompletedSchema>;
-export type UploadImportFailed = z.infer<typeof uploadImportFailedSchema>;
-//# sourceMappingURL=upload-import.d.ts.map