@scalemule/news-publication 0.0.67 → 0.0.69

package/dist/article-workflow-client.js

@@ -0,0 +1,262 @@
+// src/article-workflow-client.ts
+var ArticleWorkflowError = class extends Error {
+  constructor(message, status, articleId) {
+    super(message);
+    this.status = status;
+    this.articleId = articleId;
+    this.name = "ArticleWorkflowError";
+  }
+  status;
+  articleId;
+};
+var PublicationArticleClient = class {
+  constructor(config) {
+    this.config = config;
+    const url = new URL(config.apiUrl);
+    if (url.protocol !== "https:" && !["localhost", "127.0.0.1"].includes(url.hostname))
+      throw new Error("Use an HTTPS API endpoint");
+    this.base = config.apiUrl.replace(/\/$/, "") + `/v1/blog/publications/${encodeURIComponent(config.publicationId)}`;
+  }
+  config;
+  base;
+  async request(path, method = "GET", body, extra) {
+    const headers = new Headers(extra);
+    headers.set("accept", "application/json");
+    if (this.config.apiKey) headers.set("x-api-key", this.config.apiKey);
+    if (this.config.accessToken)
+      headers.set("authorization", `Bearer ${this.config.accessToken}`);
+    const form = body instanceof FormData;
+    if (body !== void 0 && !form)
+      headers.set("content-type", "application/json");
+    const url = new URL(
+      path.startsWith("/v1/") ? this.config.apiUrl.replace(/\/$/, "") + path : this.base + path
+    );
+    if (this.config.applicationId)
+      url.searchParams.set("application_id", this.config.applicationId);
+    const response = await (this.config.fetch ?? fetch)(url, {
+      method,
+      headers,
+      body: body === void 0 ? void 0 : form ? body : JSON.stringify(body),
+      cache: "no-store",
+      redirect: "error"
+    });
+    const value = await response.json();
+    if (!response.ok || value.success !== true || value.data == null)
+      throw new ArticleWorkflowError(
+        value.error?.message || `Article API returned ${response.status}`,
+        response.status
+      );
+    return value.data;
+  }
+  options(articleId) {
+    return this.request(
+      `/article-workflow/options${articleId ? `?article_id=${encodeURIComponent(articleId)}` : ""}`
+    );
+  }
+  get(articleId) {
+    return this.request(
+      `/articles/${encodeURIComponent(articleId)}/collaboration`
+    );
+  }
+  processing(articleId) {
+    return this.request(`/articles/${encodeURIComponent(articleId)}/processing`);
+  }
+  retryProcessing(articleId, expectedVersion, assetSourceFileId) {
+    return this.request(
+      `/articles/${encodeURIComponent(articleId)}/processing`,
+      "POST",
+      {
+        expected_version: expectedVersion,
+        asset_source_file_id: assetSourceFileId
+      }
+    );
+  }
+  create(key, authorProfileId, document, reviewPolicy = "SUBJECT_APPROVAL_PLUS_EDITOR") {
+    return this.request(
+      "/article-workflow",
+      "POST",
+      {
+        operation: "create",
+        author_profile_id: authorProfileId,
+        document,
+        review_policy: reviewPolicy
+      },
+      { "Idempotency-Key": key }
+    );
+  }
+  save(key, articleId, generation, document, reason = "EDITOR_EDIT") {
+    return this.request(
+      "/article-workflow",
+      "POST",
+      {
+        operation: "save",
+        article_id: articleId,
+        expected_generation: generation,
+        document,
+        reason
+      },
+      { "Idempotency-Key": key }
+    );
+  }
+  command(articleId, generation, action) {
+    return this.request(
+      `/articles/${encodeURIComponent(articleId)}/collaboration`,
+      "POST",
+      { ...action, expected_generation: generation }
+    );
+  }
+  registerPhoto(fileId) {
+    return this.request(
+      `/v1/photos/${this.config.applicationId ? "admin/register" : "register"}`,
+      "POST",
+      {
+        file_id: fileId,
+        content_kind: "article",
+        publication_id: this.config.publicationId,
+        ...this.config.applicationId ? { application_id: this.config.applicationId } : {}
+      }
+    );
+  }
+  upload(articleId, generation, file, filename, metadata) {
+    const body = new FormData();
+    body.set("metadata", JSON.stringify(metadata));
+    body.set("file", file, filename);
+    return this.request(`/articles/${encodeURIComponent(articleId)}/assets`, "POST", body, {
+      "If-Match": String(generation)
+    });
+  }
+  /** 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. */
+  async submitArticle(input) {
+    if (input.document.media?.length)
+      throw new Error(
+        "Pass file assets separately when creating an article package"
+      );
+    const capabilities = await this.options();
+    if (capabilities.workflow_version !== 1)
+      throw new Error("Unsupported article workflow version");
+    if (input.assets?.length && !capabilities.capabilities.managed_private_asset_upload)
+      throw new Error("Managed article upload is not deployed");
+    const created = await this.create(
+      input.operationKey,
+      input.authorProfileId,
+      input.document,
+      input.reviewPolicy
+    );
+    try {
+      const selected = [];
+      for (const asset of input.assets ?? []) {
+        let current = await this.get(created.article_id);
+        const digest = Array.from(
+          new Uint8Array(
+            await crypto.subtle.digest(
+              "SHA-256",
+              await asset.file.arrayBuffer()
+            )
+          )
+        ).map((v) => v.toString(16).padStart(2, "0")).join("");
+        const existing = current.contributions.find(
+          (c) => c.kind === "MEDIA" && c.state !== "REJECTED" && c.state !== "WITHDRAWN" && c.payload.sha256 === digest && Object.entries(asset.metadata).every(
+            ([k, v]) => c.payload[k] === v
+          )
+        );
+        const staged = existing?.payload.file_id ? { contribution_id: existing.id, file_id: existing.payload.file_id } : await this.upload(
+          created.article_id,
+          current.generation,
+          asset.file,
+          asset.filename,
+          asset.metadata
+        );
+        await this.registerPhoto(staged.file_id);
+        if (input.approveMedia) {
+          if (!asset.metadata.rights_confirmed || asset.metadata.private_preview_only)
+            throw new Error("Publication requires confirmed image rights");
+          if (existing?.state !== "APPROVED") {
+            current = await this.get(created.article_id);
+            await this.command(created.article_id, current.generation, {
+              action: "RESOLVE",
+              contribution_id: staged.contribution_id,
+              state: "APPROVED"
+            });
+          }
+          selected.push({
+            kind: "image",
+            contribution_id: staged.contribution_id,
+            file_id: staged.file_id,
+            caption: asset.metadata.caption,
+            credit: asset.metadata.credit,
+            alt: asset.metadata.alt,
+            position: asset.position
+          });
+        }
+      }
+      if (selected.length) {
+        const current = await this.get(created.article_id);
+        const document = { ...input.document, media: selected };
+        const saved = current.revisions.find(
+          (r) => r.id === current.current_revision_id
+        )?.document;
+        if (!saved) throw new Error("Current immutable revision is missing");
+        if (sameDocument(saved, document))
+          return {
+            ...created,
+            revision_id: current.current_revision_id,
+            generation: current.generation,
+            editorial_status: current.status,
+            replayed: true
+          };
+        if (!sameDocument(
+          { ...saved, media: [] },
+          { ...input.document, media: [] }
+        ) || saved.media?.length)
+          throw new ArticleWorkflowError(
+            "The article was edited after this package began; load its current revision before changing it",
+            409,
+            created.article_id
+          );
+        return await this.save(
+          `${input.operationKey}:assets`,
+          created.article_id,
+          current.generation,
+          document,
+          "MEDIA_UPDATE"
+        );
+      }
+      return created;
+    } catch (error) {
+      if (error instanceof ArticleWorkflowError) {
+        error.articleId = created.article_id;
+        throw error;
+      }
+      throw new ArticleWorkflowError(
+        error instanceof Error ? error.message : "Article package interrupted",
+        0,
+        created.article_id
+      );
+    }
+  }
+};
+function sameDocument(a, b) {
+  const canonical = (d) => [
+    d.title,
+    d.subtitle || "",
+    d.content_markdown,
+    d.section,
+    d.community || "",
+    d.format || null,
+    d.layout ? [d.layout.id, d.layout.version] : null,
+    (d.media || []).map((m) => [
+      m.kind || "image",
+      m.contribution_id,
+      m.file_id,
+      m.caption,
+      m.credit,
+      m.alt,
+      m.position
+    ])
+  ];
+  return JSON.stringify(canonical(a)) === JSON.stringify(canonical(b));
+}
+
+export { ArticleWorkflowError, PublicationArticleClient };

package/dist/{chunk-OISLCYER.js → chunk-DN3TBZLK.js}

@@ -232,4 +232,40 @@ function renderArticleBlocksToHtml(blocks, mediaMap, options) {
   return parts.join("\n");
 }
 
-export { formatArtworkCaption, parseDocumentBlocks, renderArticleBlocksToHtml, sanitizeInlineMarkdown };
+// src/article-presentation.ts
+var standard = {
+  id: "standard",
+  version: 1,
+  name: "Standard article",
+  renderer: "standard",
+  hero_aspect: "landscape",
+  headline_position: "before_hero",
+  wide_body: false
+};
+var formats = [
+  "news",
+  "brief",
+  "explainer",
+  "interview",
+  "opinion",
+  "photo_essay",
+  "video_story"
+];
+function articlePresentation(value) {
+  const l = value?.layout;
+  if (!l || !/^[a-z0-9_-]{1,80}$/.test(l.id) || !Number.isInteger(l.version) || l.version < 1 || !["standard", "feature", "portrait"].includes(l.renderer) || !["landscape", "portrait", "square"].includes(l.hero_aspect) || !["before_hero", "after_hero"].includes(l.headline_position) || typeof l.wide_body !== "boolean") {
+    return { layout: standard };
+  }
+  return {
+    format: value?.format && formats.includes(value.format) ? value.format : void 0,
+    layout: l
+  };
+}
+function articleHeroRatio(layout) {
+  return layout.hero_aspect === "portrait" ? 4 / 5 : layout.hero_aspect === "square" ? 1 : 16 / 9;
+}
+function articleFormatLabel(format) {
+  return format === "opinion" ? "Opinion" : format === "explainer" ? "Explainer" : format === "interview" ? "Interview" : format === "photo_essay" ? "Photo essay" : format === "video_story" ? "Video story" : void 0;
+}
+
+export { articleFormatLabel, articleHeroRatio, articlePresentation, formatArtworkCaption, parseDocumentBlocks, renderArticleBlocksToHtml, sanitizeInlineMarkdown };

package/dist/index.cjs

@@ -3586,6 +3586,42 @@ function campaignReportHtml(report) {
   <footer><p>${escape(report.reporting_note)}</p><p>${escape(report.editorial_independence)}</p><p>Campaign reference: ${escape(report.campaign_id)}</p></footer></body></html>`;
 }
 
+// src/article-presentation.ts
+var standard = {
+  id: "standard",
+  version: 1,
+  name: "Standard article",
+  renderer: "standard",
+  hero_aspect: "landscape",
+  headline_position: "before_hero",
+  wide_body: false
+};
+var formats = [
+  "news",
+  "brief",
+  "explainer",
+  "interview",
+  "opinion",
+  "photo_essay",
+  "video_story"
+];
+function articlePresentation(value) {
+  const l = value?.layout;
+  if (!l || !/^[a-z0-9_-]{1,80}$/.test(l.id) || !Number.isInteger(l.version) || l.version < 1 || !["standard", "feature", "portrait"].includes(l.renderer) || !["landscape", "portrait", "square"].includes(l.hero_aspect) || !["before_hero", "after_hero"].includes(l.headline_position) || typeof l.wide_body !== "boolean") {
+    return { layout: standard };
+  }
+  return {
+    format: value?.format && formats.includes(value.format) ? value.format : void 0,
+    layout: l
+  };
+}
+function articleHeroRatio(layout) {
+  return layout.hero_aspect === "portrait" ? 4 / 5 : layout.hero_aspect === "square" ? 1 : 16 / 9;
+}
+function articleFormatLabel(format) {
+  return format === "opinion" ? "Opinion" : format === "explainer" ? "Explainer" : format === "interview" ? "Interview" : format === "photo_essay" ? "Photo essay" : format === "video_story" ? "Video story" : void 0;
+}
+
 Object.defineProperty(exports, "COOKIE_CONSENT_BACKUP_KEY", {
   enumerable: true,
   get: function () { return compliance.COOKIE_CONSENT_BACKUP_KEY; }
@@ -3726,7 +3762,10 @@ exports.applyNavigationConfig = applyNavigationConfig;
 exports.applyTheme = applyTheme;
 exports.articleCacheKey = articleCacheKey;
 exports.articleCacheOptions = articleCacheOptions;
+exports.articleFormatLabel = articleFormatLabel;
+exports.articleHeroRatio = articleHeroRatio;
 exports.articleMeta = articleMeta;
+exports.articlePresentation = articlePresentation;
 exports.articleUrl = articleUrl;
 exports.attribution = attribution;
 exports.briefSummary = briefSummary;

package/dist/index.d.cts

@@ -17,6 +17,7 @@ export { C as CommunityMapArticleEmbed, c as communityMapEmbeds } from './commun
 export { C as ContentBlock, S as StructuredDocument, a as StructuredMedia, f as formatArtworkCaption, p as parseDocumentBlocks, r as renderArticleBlocksToHtml, s as sanitizeInlineMarkdown } from './article-blocks-DsabIDmH.cjs';
 import { M as Measurement } from './sponsorships-CtnBe3S8.cjs';
 export { a as Campaign, b as CampaignStatus, c as CampaignTarget, C as Creative, d as Placement, e as PlacementType, P as PublicAcknowledgment, S as SPONSORSHIP_OFFERINGS, f as SPONSORSHIP_POLICY, g as SponsorParty, p as placementAvailable, s as safeSponsorUrl } from './sponsorships-CtnBe3S8.cjs';
+export { A as ArticleFormat, b as ArticleLayout, a as ArticlePresentation, c as articleFormatLabel, d as articleHeroRatio, e as articlePresentation } from './article-presentation-0d1FiDgA.cjs';
 import './pets.cjs';
 
 /** Walnut Creek Times broadsheet colors. A paper overrides only what it changes. */

package/dist/index.d.ts

@@ -17,6 +17,7 @@ export { C as CommunityMapArticleEmbed, c as communityMapEmbeds } from './commun
 export { C as ContentBlock, S as StructuredDocument, a as StructuredMedia, f as formatArtworkCaption, p as parseDocumentBlocks, r as renderArticleBlocksToHtml, s as sanitizeInlineMarkdown } from './article-blocks-DsabIDmH.js';
 import { M as Measurement } from './sponsorships-CtnBe3S8.js';
 export { a as Campaign, b as CampaignStatus, c as CampaignTarget, C as Creative, d as Placement, e as PlacementType, P as PublicAcknowledgment, S as SPONSORSHIP_OFFERINGS, f as SPONSORSHIP_POLICY, g as SponsorParty, p as placementAvailable, s as safeSponsorUrl } from './sponsorships-CtnBe3S8.js';
+export { A as ArticleFormat, b as ArticleLayout, a as ArticlePresentation, c as articleFormatLabel, d as articleHeroRatio, e as articlePresentation } from './article-presentation-0d1FiDgA.js';
 import './pets.js';
 
 /** Walnut Creek Times broadsheet colors. A paper overrides only what it changes. */

package/dist/index.js

@@ -1,17 +1,17 @@
+export { NetworkCopyrightNotice } from './chunk-FWEYKWKP.js';
 export { CURATED_COMMUNITY_CARDS, VerifiedCardComponent, VerifiedCardSection, getArticleCards, isSafeActionUrl } from './chunk-KYUVXEJY.js';
+export { MEET_ACTIVITIES, activityLabel, canHostMeetup, isAdult, prepareMeetup, screenMessage } from './chunk-AMLVCZDP.js';
 export { CookieConsentBanner } from './chunk-XSAVJJVW.js';
 export { CookieSettingsView } from './chunk-X7AU7DV6.js';
 export { THEME_COOKIE, THEME_EVENT, THEME_MAX_AGE_SECONDS, THEME_STORAGE_KEY, ThemeToggle, applyTheme, clearTheme, getStoredTheme, getSystemTheme, resolveEffectiveTheme, setTheme, subscribeTheme, themeInitScript } from './chunk-NQD3M7ZY.js';
 export { LocalNetworkBar } from './chunk-Q77T2S7B.js';
-export { NetworkCopyrightNotice } from './chunk-FWEYKWKP.js';
 import { localPublications } from './chunk-XWXPERLK.js';
 export { COOKIE_CATEGORIES, COOKIE_CONSENT_BACKUP_KEY, COOKIE_CONSENT_EVENT, COOKIE_CONSENT_KEY, COOKIE_CONSENT_MAX_AGE_SECONDS, DEFAULT_CONSENT_HUB_URL, DEFAULT_PREFERENCES_ACCEPTED, DEFAULT_PREFERENCES_REJECTED, EDITORIAL_PRINCIPLES, EU_EEA_UK_COUNTRIES, NETWORK_CONSENT_STORAGE_KEY, NETWORK_PARENT, acceptAllCookies, checkUrlConsentBridge, clearCookieConsent, communityPublications, consentModel, decorateNetworkUrl, effectivePreferences, findPublicationByHost, findPublicationBySlug, getCookieConsent, getNetworkPublicationUrl, hasConsented, impliedPreferences, isCategoryAllowed, isGeoConsentRequired, listedPublications, localPublications, queryNetworkConsentHub, recordConsentToCompliance, rejectOptionalCookies, setCookieConsent, setNetworkConsentHub, topicalPublications } from './chunk-XWXPERLK.js';
 export { communityMapEmbeds } from './chunk-IMYBSG7J.js';
-export { formatArtworkCaption, parseDocumentBlocks, renderArticleBlocksToHtml, sanitizeInlineMarkdown } from './chunk-OISLCYER.js';
+export { articleFormatLabel, articleHeroRatio, articlePresentation, formatArtworkCaption, parseDocumentBlocks, renderArticleBlocksToHtml, sanitizeInlineMarkdown } from './chunk-DN3TBZLK.js';
 import { definePublication } from './chunk-57YVL6BD.js';
 export { BROADSHEET_THEME, FEATURE_NAMES, LAYOUT_COOKIE, acceptRemoteRecord, acceptSnapshot, definePublication, featureEnabled, parseSnapshot, publicationFromSnapshot, publicationRecord, resolveLayout, snapshotFromRecord, syncPublication } from './chunk-57YVL6BD.js';
 export { CLASSIFIED_CATEGORIES, JOB_EMPLOYMENT_TYPES, categoryLabel, classifiedPath, classifiedSearchPath, clipChars, dealDollars, dealGoPath, dealsFeedPath, employmentLabel, isClassifiedCategory, isEmploymentType, jobEmployerBody, jobOpeningBody, jobPostingBody, prepareClassified, prepareJobPost, publicJobPath, publicJobsPath } from './chunk-C7ZPLH2K.js';
-export { MEET_ACTIVITIES, activityLabel, canHostMeetup, isAdult, prepareMeetup, screenMessage } from './chunk-AMLVCZDP.js';
 export { SPONSORSHIP_OFFERINGS, SPONSORSHIP_POLICY, placementAvailable, safeSponsorUrl } from './chunk-66GI2IX6.js';
 import './chunk-AFJ6S5WJ.js';
 import { jsxs, jsx } from 'react/jsx-runtime';