@scalemule/news-publication 0.0.84 → 0.0.86

package/README.md

@@ -377,7 +377,7 @@ matches one declared slot. Credentials are normal project/member credentials.
 The operation key is retained for 30 days. A legacy article must first have an
 explicitly selected collaboration policy; this endpoint never downgrades review.
 
-### Edit article prose, cards and citations
+### Edit article prose, cards, citations and tags
 
 ```sh
 npx --yes --package @scalemule/news-publication@0.0.81 scalemule-article edit \
@@ -385,7 +385,10 @@ npx --yes --package @scalemule/news-publication@0.0.81 scalemule-article edit \
 ```
 
 The patch may contain title, subtitle, content_markdown, excerpt, section,
-community, format, layout, cards and citations. It preserves omitted fields and
+community, format, layout, cards, citations and `tag_ids`. Tag edits require SDK
+0.0.85+ and the deployed `versioned_editorial_tags` capability. Supply up to 32
+existing tenant-owned tag UUIDs; an empty array clears assignments. Create or
+select tags using the ordinary Blog tags API first. It preserves omitted fields and
 media and saves one immutable revision. Default: save for review. Add
 `--release` only to request release through the existing policy; the command
 never issues APPROVE or downgrades review. On a legacy article, explicitly choose
@@ -402,7 +405,7 @@ Unknown save/release responses reconcile against the original revision; another
 current revision stops rather than being overwritten. Completed replay and no-op
 edits add no revision. `RELEASE_HELD`/exit 2 preserves the saved revision while
 review is pending. With `--url --release`, success requires the rendered
-headline, prose and actual card components; public visibility pending is also
+headline, prose, actual card components and requested canonical tag links; public visibility pending is also
 exit 2. A saved revision and a rendered published correction are separate states.
 
 Use the same client method, `client.editArticle`, for a caller-supplied durable

package/bin/scalemule-article.mjs

@@ -18,7 +18,7 @@ Credentials: SCALEMULE_API_KEY and SCALEMULE_ACCESS_TOKEN (normal authorized mem
 Platform admins may use their normal access token with --application-id ID.
 Optional --api-url URL defaults to https://api.scalemule.com.
 
-edit saves prose, excerpt, cards and citations in one immutable revision.
+edit saves prose, excerpt, cards, citations and tenant-owned tag_ids in one immutable revision.
 Unspecified fields and media are retained. Default: save for review.
 --release explicitly requests release under the existing policy; it never issues
 APPROVE or changes a policy. Legacy onboarding requires an explicit
@@ -157,11 +157,11 @@ try {
             while(!verified){
               const response=await fetch(values.url,{redirect:'error',cache:'no-store',signal:AbortSignal.timeout(Math.min(5000,remaining()))});
               const html=await response.text();
-              verified=response.ok&&articleEditHtmlMatches(html,{title:article.title,content_html:article.content_html,card_titles:(article.metadata?.cards??[]).map(c=>c.title)});
+              verified=response.ok&&articleEditHtmlMatches(html,{title:article.title,content_html:article.content_html,card_titles:(article.metadata?.cards??[]).map(c=>c.title),tags:checkpoint.document.tag_ids?article.tags:undefined});
               if(!verified)await new Promise(r=>setTimeout(r,Math.min(300,remaining())));
             }
           }catch(error){reason=error.message;}
-          if(!verified){console.error(JSON.stringify({...result,state:'published_public_verification_pending',stage:'public_page',message:'The exact revision is published; rendered prose/cards remain unverified. Resume the same edit.',reason}));process.exitCode=2;}
+          if(!verified){console.error(JSON.stringify({...result,state:'published_public_verification_pending',stage:'public_page',message:'The exact revision is published; rendered prose/cards/tags remain unverified. Resume the same edit.',reason}));process.exitCode=2;}
           else console.log(JSON.stringify({...result,public_page_verified:true,total_elapsed_ms:Math.round(performance.now()-commandStarted)},null,2));
         }else{
         console.log(JSON.stringify({...result,total_elapsed_ms:Math.round(performance.now()-commandStarted)},null,2));

package/dist/article-workflow-client.cjs

@@ -43,6 +43,17 @@ function articleEditHtmlMatches(html, expected) {
   const all = text(visible);
   if (!paragraphs.length || !paragraphs.every((p) => all.includes(p)))
     return false;
+  if (expected.tags?.length) {
+    const links = [...visible.matchAll(/<a\b[^>]*href=["']([^"']+)["'][^>]*>([\s\S]*?)<\/a>/giu)];
+    if (!expected.tags.every((tag) => links.some((link) => {
+      try {
+        const url = new URL(decode(link[1]), "https://publication.example");
+        return url.pathname === "/news" && url.searchParams.get("tag") === tag.slug && text(link[2]).replace(/^#\s*/u, "") === tag.name;
+      } catch {
+        return false;
+      }
+    }))) return false;
+  }
   const titles = [
     ...visible.matchAll(
       /<aside\b[^>]*class=["'][^"']*\barticle-verified-card\b[^"']*["'][^>]*>([\s\S]*?)<\/aside>/giu
@@ -347,6 +358,16 @@ var canonical2 = (v) => Array.isArray(v) ? v.map(canonical2) : v && typeof v ===
   Object.keys(v).sort().map((k) => [k, canonical2(v[k])])
 ) : v;
 var equal = (a, b) => JSON.stringify(canonical2(a)) === JSON.stringify(canonical2(b));
+var uuidIdentity = (value) => {
+  if (typeof value !== "string" || !/^(?:[0-9a-f]{32}|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$/i.test(value)) return value;
+  return value.replaceAll("-", "").toLowerCase();
+};
+var comparableDocument = (document) => document && typeof document === "object" ? { ...document, ...Array.isArray(document.media) ? { media: document.media.map((media) => ({
+  ...media,
+  contribution_id: uuidIdentity(media.contribution_id),
+  file_id: uuidIdentity(media.file_id)
+})) } : {} } : document;
+var documentsEqual = (a, b) => equal(comparableDocument(a), comparableDocument(b));
 var digest2 = async (v) => [
   ...new Uint8Array(
     await crypto.subtle.digest(
@@ -365,7 +386,8 @@ var patchKeys = /* @__PURE__ */ new Set([
   "format",
   "layout",
   "cards",
-  "citations"
+  "citations",
+  "tag_ids"
 ]);
 function validate(input) {
   if (!input.operationKey || !/^[\w.:-]{1,128}$/u.test(input.operationKey) || !input.articleId || !input.patch || typeof input.patch !== "object" || Array.isArray(input.patch) || !Object.keys(input.patch).length)
@@ -374,7 +396,10 @@ function validate(input) {
     );
   for (const [key, value] of Object.entries(input.patch)) {
     if (!patchKeys.has(key)) throw Error("Unsupported edit field: " + key);
-    if (["cards", "citations"].includes(key)) {
+    if (key === "tag_ids") {
+      if (!Array.isArray(value) || value.length > 32 || new Set(value).size !== value.length || value.some((id) => typeof id !== "string" || !/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/iu.test(id) || /^0{8}-0{4}-0{4}-0{4}-0{12}$/u.test(id)))
+        throw Error("tag_ids must contain at most 32 distinct, nonempty UUIDs");
+    } else if (["cards", "citations"].includes(key)) {
       if (!Array.isArray(value)) throw Error(key + " must be an array");
     } else if (key === "layout") {
       if (!value || typeof value !== "object" || typeof value.id !== "string" || !Number.isInteger(value.version))
@@ -458,6 +483,8 @@ async function runArticleEdit(t, input) {
         stage,
         "The server must expose versioned_editorial_fields before this edit; no article was changed"
       );
+    if (input.patch.tag_ids !== void 0 && options.capabilities?.versioned_editorial_tags !== true)
+      throw new ArticleEditOperationError("CAPABILITY_UNAVAILABLE", stage, "The server must expose versioned_editorial_tags before changing tags; no article was changed");
     if (!identityMatches(source))
       throw new ArticleEditOperationError(
         "ARTICLE_IDENTITY_CHANGED",
@@ -495,7 +522,7 @@ async function runArticleEdit(t, input) {
           state.revisionId
         );
       const selected = currentRevision(record);
-      if (!selected || !equal(selected.document, state.document))
+      if (!selected || !documentsEqual(selected.document, state.document))
         throw new ArticleEditOperationError(
           "VERIFICATION_CONFLICT",
           stage,
@@ -563,7 +590,7 @@ async function runArticleEdit(t, input) {
         state.savedGeneration = saved.generation;
         await save("verify");
         record = await request(article + "/collaboration");
-        if (record.current_revision_id !== state.revisionId || !equal(currentRevision(record)?.document, state.document))
+        if (record.current_revision_id !== state.revisionId || !documentsEqual(currentRevision(record)?.document, state.document))
           throw new ArticleEditOperationError(
             "ARTICLE_CHANGED",
             stage,
@@ -621,6 +648,8 @@ async function runArticleEdit(t, input) {
           409,
           state.revisionId
         );
+    if (state.document?.tag_ids && !equal([...state.document.tag_ids].sort(), (after.tags ?? []).map((tag) => tag.id).sort()))
+      throw new ArticleEditOperationError("VERIFICATION_CONFLICT", stage, "Published tags differ from the saved revision", 409, state.revisionId);
     const normalizedCards = state.document?.cards;
     if (normalizedCards && after.metadata?.cards?.length !== normalizedCards.length)
       throw new ArticleEditOperationError(

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

@@ -8,6 +8,10 @@ declare function articleEditHtmlMatches(html: string, expected: {
     title: string;
     content_html: string;
     card_titles: string[];
+    tags?: {
+        name: string;
+        slug: string;
+    }[];
 }): boolean;
 
 type PhotoOperationCheckpoint = {
@@ -48,7 +52,7 @@ 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 ArticleEditPatch = Partial<Pick<ArticleDocument, "title" | "subtitle" | "content_markdown" | "excerpt" | "section" | "community" | "format" | "layout" | "cards" | "citations" | "tag_ids">>;
 type ArticleEditCheckpoint = {
     version: 1;
     identity: string;
@@ -93,6 +97,7 @@ type ArticleDocument = {
     excerpt?: string;
     cards?: unknown[];
     citations?: unknown[];
+    tag_ids?: string[];
     section: string;
     community?: string;
     format?: ArticleFormat;
@@ -195,6 +200,7 @@ type ArticleWorkflowOptions = {
         prioritized_narration_processing?: boolean;
         content_first_editor_document?: boolean;
         versioned_editorial_fields?: boolean;
+        versioned_editorial_tags?: boolean;
         managed_submission_version?: number | null;
         multipart_submission?: boolean;
     };

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

@@ -8,6 +8,10 @@ declare function articleEditHtmlMatches(html: string, expected: {
     title: string;
     content_html: string;
     card_titles: string[];
+    tags?: {
+        name: string;
+        slug: string;
+    }[];
 }): boolean;
 
 type PhotoOperationCheckpoint = {
@@ -48,7 +52,7 @@ 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 ArticleEditPatch = Partial<Pick<ArticleDocument, "title" | "subtitle" | "content_markdown" | "excerpt" | "section" | "community" | "format" | "layout" | "cards" | "citations" | "tag_ids">>;
 type ArticleEditCheckpoint = {
     version: 1;
     identity: string;
@@ -93,6 +97,7 @@ type ArticleDocument = {
     excerpt?: string;
     cards?: unknown[];
     citations?: unknown[];
+    tag_ids?: string[];
     section: string;
     community?: string;
     format?: ArticleFormat;
@@ -195,6 +200,7 @@ type ArticleWorkflowOptions = {
         prioritized_narration_processing?: boolean;
         content_first_editor_document?: boolean;
         versioned_editorial_fields?: boolean;
+        versioned_editorial_tags?: boolean;
         managed_submission_version?: number | null;
         multipart_submission?: boolean;
     };

package/dist/article-workflow-client.js

@@ -41,6 +41,17 @@ function articleEditHtmlMatches(html, expected) {
   const all = text(visible);
   if (!paragraphs.length || !paragraphs.every((p) => all.includes(p)))
     return false;
+  if (expected.tags?.length) {
+    const links = [...visible.matchAll(/<a\b[^>]*href=["']([^"']+)["'][^>]*>([\s\S]*?)<\/a>/giu)];
+    if (!expected.tags.every((tag) => links.some((link) => {
+      try {
+        const url = new URL(decode(link[1]), "https://publication.example");
+        return url.pathname === "/news" && url.searchParams.get("tag") === tag.slug && text(link[2]).replace(/^#\s*/u, "") === tag.name;
+      } catch {
+        return false;
+      }
+    }))) return false;
+  }
   const titles = [
     ...visible.matchAll(
       /<aside\b[^>]*class=["'][^"']*\barticle-verified-card\b[^"']*["'][^>]*>([\s\S]*?)<\/aside>/giu
@@ -345,6 +356,16 @@ var canonical2 = (v) => Array.isArray(v) ? v.map(canonical2) : v && typeof v ===
   Object.keys(v).sort().map((k) => [k, canonical2(v[k])])
 ) : v;
 var equal = (a, b) => JSON.stringify(canonical2(a)) === JSON.stringify(canonical2(b));
+var uuidIdentity = (value) => {
+  if (typeof value !== "string" || !/^(?:[0-9a-f]{32}|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$/i.test(value)) return value;
+  return value.replaceAll("-", "").toLowerCase();
+};
+var comparableDocument = (document) => document && typeof document === "object" ? { ...document, ...Array.isArray(document.media) ? { media: document.media.map((media) => ({
+  ...media,
+  contribution_id: uuidIdentity(media.contribution_id),
+  file_id: uuidIdentity(media.file_id)
+})) } : {} } : document;
+var documentsEqual = (a, b) => equal(comparableDocument(a), comparableDocument(b));
 var digest2 = async (v) => [
   ...new Uint8Array(
     await crypto.subtle.digest(
@@ -363,7 +384,8 @@ var patchKeys = /* @__PURE__ */ new Set([
   "format",
   "layout",
   "cards",
-  "citations"
+  "citations",
+  "tag_ids"
 ]);
 function validate(input) {
   if (!input.operationKey || !/^[\w.:-]{1,128}$/u.test(input.operationKey) || !input.articleId || !input.patch || typeof input.patch !== "object" || Array.isArray(input.patch) || !Object.keys(input.patch).length)
@@ -372,7 +394,10 @@ function validate(input) {
     );
   for (const [key, value] of Object.entries(input.patch)) {
     if (!patchKeys.has(key)) throw Error("Unsupported edit field: " + key);
-    if (["cards", "citations"].includes(key)) {
+    if (key === "tag_ids") {
+      if (!Array.isArray(value) || value.length > 32 || new Set(value).size !== value.length || value.some((id) => typeof id !== "string" || !/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/iu.test(id) || /^0{8}-0{4}-0{4}-0{4}-0{12}$/u.test(id)))
+        throw Error("tag_ids must contain at most 32 distinct, nonempty UUIDs");
+    } else if (["cards", "citations"].includes(key)) {
       if (!Array.isArray(value)) throw Error(key + " must be an array");
     } else if (key === "layout") {
       if (!value || typeof value !== "object" || typeof value.id !== "string" || !Number.isInteger(value.version))
@@ -456,6 +481,8 @@ async function runArticleEdit(t, input) {
         stage,
         "The server must expose versioned_editorial_fields before this edit; no article was changed"
       );
+    if (input.patch.tag_ids !== void 0 && options.capabilities?.versioned_editorial_tags !== true)
+      throw new ArticleEditOperationError("CAPABILITY_UNAVAILABLE", stage, "The server must expose versioned_editorial_tags before changing tags; no article was changed");
     if (!identityMatches(source))
       throw new ArticleEditOperationError(
         "ARTICLE_IDENTITY_CHANGED",
@@ -493,7 +520,7 @@ async function runArticleEdit(t, input) {
           state.revisionId
         );
       const selected = currentRevision(record);
-      if (!selected || !equal(selected.document, state.document))
+      if (!selected || !documentsEqual(selected.document, state.document))
         throw new ArticleEditOperationError(
           "VERIFICATION_CONFLICT",
           stage,
@@ -561,7 +588,7 @@ async function runArticleEdit(t, input) {
         state.savedGeneration = saved.generation;
         await save("verify");
         record = await request(article + "/collaboration");
-        if (record.current_revision_id !== state.revisionId || !equal(currentRevision(record)?.document, state.document))
+        if (record.current_revision_id !== state.revisionId || !documentsEqual(currentRevision(record)?.document, state.document))
           throw new ArticleEditOperationError(
             "ARTICLE_CHANGED",
             stage,
@@ -619,6 +646,8 @@ async function runArticleEdit(t, input) {
           409,
           state.revisionId
         );
+    if (state.document?.tag_ids && !equal([...state.document.tag_ids].sort(), (after.tags ?? []).map((tag) => tag.id).sort()))
+      throw new ArticleEditOperationError("VERIFICATION_CONFLICT", stage, "Published tags differ from the saved revision", 409, state.revisionId);
     const normalizedCards = state.document?.cards;
     if (normalizedCards && after.metadata?.cards?.length !== normalizedCards.length)
       throw new ArticleEditOperationError(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scalemule/news-publication",
-  "version": "0.0.84",
+  "version": "0.0.86",
   "description": "Shared server framework for ScaleMule local news publications. Walnut Creek Times is the broadsheet default; each paper supplies its own identity and feature flags.",
   "type": "module",
   "bin": {