@scalemule/news-publication 0.0.80 → 0.0.82

package/dist/article-workflow-client.d.cts

@@ -3,6 +3,13 @@ import { A as ArticleFormat, b as ArticleLayout } from './article-presentation-0
 /** Check rendered image tags, not a URL mentioned only in serialized page data. */
 declare function articlePhotoHtmlMatches(html: string, lead: string | string[], social: string): boolean;
 
+/** Requires visible body and actual card asides; serialized page data is not delivery. */
+declare function articleEditHtmlMatches(html: string, expected: {
+    title: string;
+    content_html: string;
+    card_titles: string[];
+}): boolean;
+
 type PhotoOperationCheckpoint = {
     version: 1;
     identity: string;
@@ -41,10 +48,51 @@ declare class ArticlePhotoOperationError extends Error {
     constructor(code: string, stage: string, message: string, fileId?: string | undefined, status?: number | undefined);
 }
 
+type ArticleEditPatch = Partial<Pick<ArticleDocument, "title" | "subtitle" | "content_markdown" | "excerpt" | "section" | "community" | "format" | "layout" | "cards" | "citations">>;
+type ArticleEditCheckpoint = {
+    version: 1;
+    identity: string;
+    articleId: string;
+    stage: string;
+    expectedGeneration?: number;
+    document?: ArticleDocument;
+    revisionId?: string;
+    savedGeneration?: number;
+    unchanged?: boolean;
+    sourceIdentity?: {
+        slug: string;
+        published_at: string | null;
+        canonical_url: string | null;
+    };
+};
+type ArticleEditInput = {
+    articleId: string;
+    operationKey: string;
+    patch: ArticleEditPatch;
+    expectedGeneration?: number;
+    /** Explicit legacy onboarding only. Existing policies are never changed. */
+    enableReviewPolicy?: "NONE" | "FACT_CHECK" | "CONTRIBUTOR_REVIEW" | "SUBJECT_APPROVAL_REQUIRED" | "SUBJECT_APPROVAL_PLUS_EDITOR";
+    /** Execute RELEASE under the caller's grants. Does not issue APPROVE. */
+    release?: boolean;
+    checkpoint?: ArticleEditCheckpoint;
+    saveCheckpoint: (checkpoint: ArticleEditCheckpoint) => Promise<void>;
+    timeoutMs?: number;
+};
+declare class ArticleEditOperationError extends Error {
+    code: string;
+    stage: string;
+    status?: number | undefined;
+    revisionId?: string | undefined;
+    constructor(code: string, stage: string, message: string, status?: number | undefined, revisionId?: string | undefined);
+}
+
 type ArticleDocument = {
     title: string;
     subtitle?: string;
     content_markdown: string;
+    excerpt?: string;
+    cards?: unknown[];
+    citations?: unknown[];
     section: string;
     community?: string;
     format?: ArticleFormat;
@@ -64,13 +112,13 @@ type ArticleMedia = {
     position: "hero" | "inline" | "gallery" | "attachment";
 };
 type AssetMetadata = {
-    caption: string;
-    credit: string;
-    alt: string;
-    creator: string;
-    who_is_pictured: string;
-    when_taken: string;
-    where_taken: string;
+    caption?: string;
+    credit?: string;
+    alt?: string;
+    creator?: string;
+    who_is_pictured?: string;
+    when_taken?: string;
+    where_taken?: string;
     rights_confirmed: boolean;
     private_preview_only?: boolean;
 };
@@ -146,6 +194,9 @@ type ArticleWorkflowOptions = {
         automatic_public_narration?: boolean;
         prioritized_narration_processing?: boolean;
         content_first_editor_document?: boolean;
+        versioned_editorial_fields?: boolean;
+        managed_submission_version?: number | null;
+        multipart_submission?: boolean;
     };
 };
 type ArticleOperation = {
@@ -175,6 +226,56 @@ type Record = {
         };
     }[];
 };
+type ArticleSubmissionManifest = {
+    article: {
+        operation: "create";
+        author_profile_id: string;
+        document: ArticleDocument;
+        review_policy?: string;
+        celebration_type?: string;
+    } | {
+        operation: "save";
+        article_id: string;
+        expected_generation: number;
+        document: ArticleDocument;
+        reason: string;
+    };
+    intent?: "draft" | "review" | "publish";
+    approve_media?: boolean;
+    sensitivity_review?: {
+        policy_version: string;
+        rule_ids: string[];
+        reason: string;
+    };
+    assets?: {
+        slot: string;
+        position: "hero" | "gallery" | "attachment";
+        metadata: AssetMetadata;
+    }[];
+};
+type ArticleSubmissionReceipt = {
+    submission_id: string;
+    article_id: string | null;
+    revision_id: string | null;
+    status: "intake" | "queued" | "scanning" | "narrating" | "awaiting_review" | "held" | "complete" | "published";
+    error_code: string | null;
+    status_path: string;
+    permalink_path: string | null;
+    processing: ArticleProcessing | null;
+    progress: {
+        intent: string;
+        assets: {
+            [slot: string]: {
+                state: string;
+                contribution_id?: string;
+                file_id?: string;
+            };
+        };
+    };
+    accepted_is_not_published: true;
+    public_ready: boolean;
+    next_action: string;
+};
 declare class ArticleWorkflowError extends Error {
     status: number;
     articleId?: string | undefined;
@@ -194,6 +295,7 @@ declare class PublicationArticleClient {
     });
     private request;
     options(articleId?: string): Promise<ArticleWorkflowOptions>;
+    publicArticle(slug: string, signal?: AbortSignal): Promise<any>;
     /** Explicit approver-authorized onboarding for a legacy article; never called by get().
      * Existing schedules are cancelled by the server; public content remains unchanged.
      * Missing immutable media identities must be resolved through newsroom media controls.
@@ -212,6 +314,15 @@ declare class PublicationArticleClient {
         state: string;
         elapsed_ms: number;
     }>;
+    /** Save one exact revision; release is explicit and never manufactures approval. */
+    editArticle(input: ArticleEditInput): Promise<{
+        article_id: string;
+        revision_id: any;
+        generation: any;
+        state: string;
+        editorial_status: any;
+        elapsed_ms: number;
+    }>;
     /** Replace a legacy publication cover using ready, measured public Photo renditions.
      * This never enrolls a story, publishes text, creates narration or retries a conflict.
      * Collaboration-managed stories retain their server-enforced immutable revision workflow.
@@ -244,22 +355,30 @@ declare class PublicationArticleClient {
         kind: "image";
         state: "OPEN";
     }>;
-    /** One agent operation over existing owners. Stops at conflicts/unknown upload acknowledgement;
-     * replay the same operation key to inspect/reuse staged contributions before another transfer.
-     * Editorial approval and release are always separate explicit operations. */
+    /** One server-owned submission. No client-side Photo/TTS orchestration and no
+     * fallback to a different workflow. A 202 receipt is acceptance, not readiness.
+     * Replay the identical manifest/files/key after an uncertain acknowledgement.
+     */
+    submit(manifest: ArticleSubmissionManifest, operationKey: string, files?: {
+        slot: string;
+        file: Blob;
+        filename: string;
+    }[], signal?: AbortSignal): Promise<ArticleSubmissionReceipt>;
+    submission(submissionId: string, signal?: AbortSignal): Promise<ArticleSubmissionReceipt>;
     submitArticle(input: {
         operationKey: string;
         authorProfileId: string;
         document: ArticleDocument;
         reviewPolicy?: string;
+        intent?: "draft" | "review" | "publish";
         assets?: {
             file: Blob;
             filename: string;
             metadata: AssetMetadata;
-            position: ArticleMedia["position"];
+            position: "hero" | "gallery" | "attachment";
         }[];
         approveMedia?: boolean;
-    }): Promise<ArticleOperation>;
+    }): Promise<ArticleSubmissionReceipt>;
 }
 
-export { type ArticleDocument, type ArticleMedia, type ArticleOperation, type ArticlePhotoInput, ArticlePhotoOperationError, type ArticleProcessing, ArticleWorkflowError, type ArticleWorkflowOptions, type AssetMetadata, type PhotoOperationCheckpoint, PublicationArticleClient, type PublishedCoverReplacement, articlePhotoHtmlMatches };
+export { type ArticleDocument, type ArticleEditCheckpoint, type ArticleEditInput, ArticleEditOperationError, type ArticleEditPatch, type ArticleMedia, type ArticleOperation, type ArticlePhotoInput, ArticlePhotoOperationError, type ArticleProcessing, type ArticleSubmissionManifest, type ArticleSubmissionReceipt, ArticleWorkflowError, type ArticleWorkflowOptions, type AssetMetadata, type PhotoOperationCheckpoint, PublicationArticleClient, type PublishedCoverReplacement, articleEditHtmlMatches, articlePhotoHtmlMatches };

package/dist/article-workflow-client.d.ts

@@ -3,6 +3,13 @@ import { A as ArticleFormat, b as ArticleLayout } from './article-presentation-0
 /** Check rendered image tags, not a URL mentioned only in serialized page data. */
 declare function articlePhotoHtmlMatches(html: string, lead: string | string[], social: string): boolean;
 
+/** Requires visible body and actual card asides; serialized page data is not delivery. */
+declare function articleEditHtmlMatches(html: string, expected: {
+    title: string;
+    content_html: string;
+    card_titles: string[];
+}): boolean;
+
 type PhotoOperationCheckpoint = {
     version: 1;
     identity: string;
@@ -41,10 +48,51 @@ declare class ArticlePhotoOperationError extends Error {
     constructor(code: string, stage: string, message: string, fileId?: string | undefined, status?: number | undefined);
 }
 
+type ArticleEditPatch = Partial<Pick<ArticleDocument, "title" | "subtitle" | "content_markdown" | "excerpt" | "section" | "community" | "format" | "layout" | "cards" | "citations">>;
+type ArticleEditCheckpoint = {
+    version: 1;
+    identity: string;
+    articleId: string;
+    stage: string;
+    expectedGeneration?: number;
+    document?: ArticleDocument;
+    revisionId?: string;
+    savedGeneration?: number;
+    unchanged?: boolean;
+    sourceIdentity?: {
+        slug: string;
+        published_at: string | null;
+        canonical_url: string | null;
+    };
+};
+type ArticleEditInput = {
+    articleId: string;
+    operationKey: string;
+    patch: ArticleEditPatch;
+    expectedGeneration?: number;
+    /** Explicit legacy onboarding only. Existing policies are never changed. */
+    enableReviewPolicy?: "NONE" | "FACT_CHECK" | "CONTRIBUTOR_REVIEW" | "SUBJECT_APPROVAL_REQUIRED" | "SUBJECT_APPROVAL_PLUS_EDITOR";
+    /** Execute RELEASE under the caller's grants. Does not issue APPROVE. */
+    release?: boolean;
+    checkpoint?: ArticleEditCheckpoint;
+    saveCheckpoint: (checkpoint: ArticleEditCheckpoint) => Promise<void>;
+    timeoutMs?: number;
+};
+declare class ArticleEditOperationError extends Error {
+    code: string;
+    stage: string;
+    status?: number | undefined;
+    revisionId?: string | undefined;
+    constructor(code: string, stage: string, message: string, status?: number | undefined, revisionId?: string | undefined);
+}
+
 type ArticleDocument = {
     title: string;
     subtitle?: string;
     content_markdown: string;
+    excerpt?: string;
+    cards?: unknown[];
+    citations?: unknown[];
     section: string;
     community?: string;
     format?: ArticleFormat;
@@ -64,13 +112,13 @@ type ArticleMedia = {
     position: "hero" | "inline" | "gallery" | "attachment";
 };
 type AssetMetadata = {
-    caption: string;
-    credit: string;
-    alt: string;
-    creator: string;
-    who_is_pictured: string;
-    when_taken: string;
-    where_taken: string;
+    caption?: string;
+    credit?: string;
+    alt?: string;
+    creator?: string;
+    who_is_pictured?: string;
+    when_taken?: string;
+    where_taken?: string;
     rights_confirmed: boolean;
     private_preview_only?: boolean;
 };
@@ -146,6 +194,9 @@ type ArticleWorkflowOptions = {
         automatic_public_narration?: boolean;
         prioritized_narration_processing?: boolean;
         content_first_editor_document?: boolean;
+        versioned_editorial_fields?: boolean;
+        managed_submission_version?: number | null;
+        multipart_submission?: boolean;
     };
 };
 type ArticleOperation = {
@@ -175,6 +226,56 @@ type Record = {
         };
     }[];
 };
+type ArticleSubmissionManifest = {
+    article: {
+        operation: "create";
+        author_profile_id: string;
+        document: ArticleDocument;
+        review_policy?: string;
+        celebration_type?: string;
+    } | {
+        operation: "save";
+        article_id: string;
+        expected_generation: number;
+        document: ArticleDocument;
+        reason: string;
+    };
+    intent?: "draft" | "review" | "publish";
+    approve_media?: boolean;
+    sensitivity_review?: {
+        policy_version: string;
+        rule_ids: string[];
+        reason: string;
+    };
+    assets?: {
+        slot: string;
+        position: "hero" | "gallery" | "attachment";
+        metadata: AssetMetadata;
+    }[];
+};
+type ArticleSubmissionReceipt = {
+    submission_id: string;
+    article_id: string | null;
+    revision_id: string | null;
+    status: "intake" | "queued" | "scanning" | "narrating" | "awaiting_review" | "held" | "complete" | "published";
+    error_code: string | null;
+    status_path: string;
+    permalink_path: string | null;
+    processing: ArticleProcessing | null;
+    progress: {
+        intent: string;
+        assets: {
+            [slot: string]: {
+                state: string;
+                contribution_id?: string;
+                file_id?: string;
+            };
+        };
+    };
+    accepted_is_not_published: true;
+    public_ready: boolean;
+    next_action: string;
+};
 declare class ArticleWorkflowError extends Error {
     status: number;
     articleId?: string | undefined;
@@ -194,6 +295,7 @@ declare class PublicationArticleClient {
     });
     private request;
     options(articleId?: string): Promise<ArticleWorkflowOptions>;
+    publicArticle(slug: string, signal?: AbortSignal): Promise<any>;
     /** Explicit approver-authorized onboarding for a legacy article; never called by get().
      * Existing schedules are cancelled by the server; public content remains unchanged.
      * Missing immutable media identities must be resolved through newsroom media controls.
@@ -212,6 +314,15 @@ declare class PublicationArticleClient {
         state: string;
         elapsed_ms: number;
     }>;
+    /** Save one exact revision; release is explicit and never manufactures approval. */
+    editArticle(input: ArticleEditInput): Promise<{
+        article_id: string;
+        revision_id: any;
+        generation: any;
+        state: string;
+        editorial_status: any;
+        elapsed_ms: number;
+    }>;
     /** Replace a legacy publication cover using ready, measured public Photo renditions.
      * This never enrolls a story, publishes text, creates narration or retries a conflict.
      * Collaboration-managed stories retain their server-enforced immutable revision workflow.
@@ -244,22 +355,30 @@ declare class PublicationArticleClient {
         kind: "image";
         state: "OPEN";
     }>;
-    /** One agent operation over existing owners. Stops at conflicts/unknown upload acknowledgement;
-     * replay the same operation key to inspect/reuse staged contributions before another transfer.
-     * Editorial approval and release are always separate explicit operations. */
+    /** One server-owned submission. No client-side Photo/TTS orchestration and no
+     * fallback to a different workflow. A 202 receipt is acceptance, not readiness.
+     * Replay the identical manifest/files/key after an uncertain acknowledgement.
+     */
+    submit(manifest: ArticleSubmissionManifest, operationKey: string, files?: {
+        slot: string;
+        file: Blob;
+        filename: string;
+    }[], signal?: AbortSignal): Promise<ArticleSubmissionReceipt>;
+    submission(submissionId: string, signal?: AbortSignal): Promise<ArticleSubmissionReceipt>;
     submitArticle(input: {
         operationKey: string;
         authorProfileId: string;
         document: ArticleDocument;
         reviewPolicy?: string;
+        intent?: "draft" | "review" | "publish";
         assets?: {
             file: Blob;
             filename: string;
             metadata: AssetMetadata;
-            position: ArticleMedia["position"];
+            position: "hero" | "gallery" | "attachment";
         }[];
         approveMedia?: boolean;
-    }): Promise<ArticleOperation>;
+    }): Promise<ArticleSubmissionReceipt>;
 }
 
-export { type ArticleDocument, type ArticleMedia, type ArticleOperation, type ArticlePhotoInput, ArticlePhotoOperationError, type ArticleProcessing, ArticleWorkflowError, type ArticleWorkflowOptions, type AssetMetadata, type PhotoOperationCheckpoint, PublicationArticleClient, type PublishedCoverReplacement, articlePhotoHtmlMatches };
+export { type ArticleDocument, type ArticleEditCheckpoint, type ArticleEditInput, ArticleEditOperationError, type ArticleEditPatch, type ArticleMedia, type ArticleOperation, type ArticlePhotoInput, ArticlePhotoOperationError, type ArticleProcessing, type ArticleSubmissionManifest, type ArticleSubmissionReceipt, ArticleWorkflowError, type ArticleWorkflowOptions, type AssetMetadata, type PhotoOperationCheckpoint, PublicationArticleClient, type PublishedCoverReplacement, articleEditHtmlMatches, articlePhotoHtmlMatches };