@forumone/throughline-publishing 0.0.1 → 0.2.1

package/dist/pipeline/steps/accessibility.js

@@ -0,0 +1,32 @@
+import { BUILT_IN_ACCESSIBILITY_CHECKS } from '../../checks/index.js';
+/**
+ * Runs every built-in accessibility check followed by user-supplied ones.
+ * Errors block publish; warnings are surfaced on the result but don't fail
+ * the step. (Warning-only behavior is currently unused by the built-in
+ * checks but reserved for richer per-client checks.)
+ */
+export const accessibilityStep = async (ctx) => {
+    const checks = [
+        ...BUILT_IN_ACCESSIBILITY_CHECKS,
+        ...(ctx.options.accessibilityChecks ?? []),
+    ];
+    const allIssues = [];
+    for (const check of checks) {
+        const issues = await check.run(ctx.document, ctx.collection);
+        for (const issue of issues) {
+            allIssues.push({ ...issue, rule: check.name });
+        }
+    }
+    const errors = allIssues.filter((i) => i.severity === 'error');
+    if (errors.length > 0) {
+        return {
+            pass: false,
+            code: 'accessibility-errors',
+            reason: `${errors.length} accessibility issue${errors.length === 1 ? '' : 's'}`,
+            issues: errors,
+            suggestion: 'Every image needs alt text. Every link needs a label. Heading levels must not skip. Fix these before publishing.',
+        };
+    }
+    return { pass: true };
+};
+//# sourceMappingURL=accessibility.js.map

package/dist/pipeline/steps/accessibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessibility.js","sourceRoot":"","sources":["../../../src/pipeline/steps/accessibility.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAA;AAErE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAiB,KAAK,EAAE,GAAG,EAAE,EAAE;IAC3D,MAAM,MAAM,GAAG;QACb,GAAG,6BAA6B;QAChC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,mBAAmB,IAAI,EAAE,CAAC;KAC3C,CAAA;IAED,MAAM,SAAS,GAAoB,EAAE,CAAA;IACrC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC,CAAA;QAC5D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,SAAS,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;QAChD,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAA;IAC9D,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO;YACL,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,sBAAsB;YAC5B,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,uBAAuB,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE;YAC/E,MAAM,EAAE,MAAM;YACd,UAAU,EACR,kHAAkH;SACrH,CAAA;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;AACvB,CAAC,CAAA"}

package/dist/pipeline/steps/approval.d.ts

@@ -0,0 +1,21 @@
+import type { PipelineStep } from '../types.js';
+/**
+ * Symbol the approvals plugin attaches its resolver under. Publishing's
+ * approval step looks here when no resolver is supplied via options, which
+ * lets clients add the approvals plugin without re-wiring publishing's
+ * config. Keep in sync with the matching constant in the approvals package.
+ */
+export declare const APPROVALS_RESOLVER_SYMBOL: unique symbol;
+/**
+ * Gates publish on a granted approval when the document's policy demands
+ * one. Fails closed: if `policy.requiresApproval` is true but no resolver
+ * is available (neither in options nor attached via the approvals plugin),
+ * the step blocks the publish.
+ *
+ * Resolution order:
+ *   1. `options.approvalResolver` (explicit wiring)
+ *   2. The resolver attached on the Payload instance via
+ *      `APPROVALS_RESOLVER_SYMBOL` by the approvals plugin
+ */
+export declare const approvalStep: PipelineStep;
+//# sourceMappingURL=approval.d.ts.map

package/dist/pipeline/steps/approval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval.d.ts","sourceRoot":"","sources":["../../../src/pipeline/steps/approval.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,eAErC,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,EAAE,YAoC1B,CAAA"}

package/dist/pipeline/steps/approval.js

@@ -0,0 +1,48 @@
+/**
+ * Symbol the approvals plugin attaches its resolver under. Publishing's
+ * approval step looks here when no resolver is supplied via options, which
+ * lets clients add the approvals plugin without re-wiring publishing's
+ * config. Keep in sync with the matching constant in the approvals package.
+ */
+export const APPROVALS_RESOLVER_SYMBOL = Symbol.for('@forumone/throughline/approvals-resolver');
+/**
+ * Gates publish on a granted approval when the document's policy demands
+ * one. Fails closed: if `policy.requiresApproval` is true but no resolver
+ * is available (neither in options nor attached via the approvals plugin),
+ * the step blocks the publish.
+ *
+ * Resolution order:
+ *   1. `options.approvalResolver` (explicit wiring)
+ *   2. The resolver attached on the Payload instance via
+ *      `APPROVALS_RESOLVER_SYMBOL` by the approvals plugin
+ */
+export const approvalStep = async (ctx) => {
+    const policy = ctx.document[ctx.collection.policyField];
+    if (!policy?.['requiresApproval'])
+        return { pass: true };
+    const resolver = ctx.options.approvalResolver ?? lookupResolverOnPayload(ctx.payload);
+    if (!resolver) {
+        return {
+            pass: false,
+            code: 'approval-resolver-missing',
+            reason: 'Document requires approval but no approval resolver is configured',
+            suggestion: 'Register approvalsPlugin in your Payload config (it attaches the resolver automatically) or pass an explicit `approvalResolver` to publishingPlugin.',
+        };
+    }
+    const versionId = String(ctx.document['updatedAt'] ?? ctx.documentId);
+    const approval = await resolver.getActiveApproval(ctx.collection.slug, ctx.documentId, versionId);
+    if (!approval) {
+        return {
+            pass: false,
+            code: 'approval-required',
+            reason: 'This document requires approval and no granted approval exists for the current version',
+            suggestion: 'Use the Approvals Server to request approval. Once granted, publish will succeed.',
+        };
+    }
+    return { pass: true };
+};
+function lookupResolverOnPayload(payload) {
+    const value = payload[APPROVALS_RESOLVER_SYMBOL];
+    return typeof value === 'object' && value !== null ? value : undefined;
+}
+//# sourceMappingURL=approval.js.map

package/dist/pipeline/steps/approval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval.js","sourceRoot":"","sources":["../../../src/pipeline/steps/approval.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC,GAAG,CACjD,0CAA0C,CAC3C,CAAA;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,YAAY,GAAiB,KAAK,EAAE,GAAG,EAAE,EAAE;IACtD,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,CAEzC,CAAA;IACb,IAAI,CAAC,MAAM,EAAE,CAAC,kBAAkB,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IAExD,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,gBAAgB,IAAI,uBAAuB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IACrF,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,2BAA2B;YACjC,MAAM,EAAE,mEAAmE;YAC3E,UAAU,EACR,sJAAsJ;SACzJ,CAAA;IACH,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,CAAA;IACrE,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,iBAAiB,CAC/C,GAAG,CAAC,UAAU,CAAC,IAAI,EACnB,GAAG,CAAC,UAAU,EACd,SAAS,CACV,CAAA;IAED,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,mBAAmB;YACzB,MAAM,EACJ,wFAAwF;YAC1F,UAAU,EACR,mFAAmF;SACtF,CAAA;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;AACvB,CAAC,CAAA;AAED,SAAS,uBAAuB,CAAC,OAAe;IAC9C,MAAM,KAAK,GAAI,OAAmC,CAAC,yBAAyB,CAAC,CAAA;IAC7E,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAE,KAA0B,CAAC,CAAC,CAAC,SAAS,CAAA;AAC9F,CAAC"}

package/dist/pipeline/steps/composition.d.ts

@@ -0,0 +1,14 @@
+import type { PipelineStep } from '../types.js';
+/**
+ * Symbol the Component Server's plugin (C5) attaches its composition
+ * validator to. Keep in sync with the components package.
+ */
+export declare const COMPONENTS_VALIDATOR_SYMBOL: unique symbol;
+/**
+ * Validates a document's layout blocks via the Component Server's validator
+ * (attached to the Payload instance by `componentsPlugin`'s `onInit`). Empty
+ * layouts pass automatically. Composition warnings don't block publish; only
+ * errors do.
+ */
+export declare const compositionStep: PipelineStep;
+//# sourceMappingURL=composition.d.ts.map

package/dist/pipeline/steps/composition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition.d.ts","sourceRoot":"","sources":["../../../src/pipeline/steps/composition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,aAAa,CAAA;AAE9D;;;GAGG;AACH,eAAO,MAAM,2BAA2B,eAEvC,CAAA;AAqBD;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,YA2D7B,CAAA"}

package/dist/pipeline/steps/composition.js

@@ -0,0 +1,63 @@
+/**
+ * Symbol the Component Server's plugin (C5) attaches its composition
+ * validator to. Keep in sync with the components package.
+ */
+export const COMPONENTS_VALIDATOR_SYMBOL = Symbol.for('@forumone/throughline/components-validator');
+/**
+ * Validates a document's layout blocks via the Component Server's validator
+ * (attached to the Payload instance by `componentsPlugin`'s `onInit`). Empty
+ * layouts pass automatically. Composition warnings don't block publish; only
+ * errors do.
+ */
+export const compositionStep = async (ctx) => {
+    const layoutValue = ctx.document[ctx.collection.layoutField];
+    if (!Array.isArray(layoutValue) || layoutValue.length === 0) {
+        return { pass: true };
+    }
+    const blocks = layoutValue
+        .map((block) => {
+        const type = block?.blockType;
+        const variant = block?.variant;
+        if (typeof type !== 'string')
+            return null;
+        return typeof variant === 'string'
+            ? { type, variant }
+            : { type };
+    })
+        .filter((b) => b !== null);
+    if (blocks.length === 0)
+        return { pass: true };
+    const validator = ctx.payload[COMPONENTS_VALIDATOR_SYMBOL];
+    if (!validator) {
+        return {
+            pass: false,
+            code: 'components-server-missing',
+            reason: 'Composition step requires the components plugin to be registered before publishingPlugin',
+            suggestion: 'Register `componentsPlugin` in your Payload config before `publishingPlugin`. Both must share the same Payload instance.',
+        };
+    }
+    const result = await validator({ blocks });
+    const errors = result.issues
+        .filter((issue) => issue.severity === 'error')
+        .map((issue) => {
+        const out = {
+            severity: 'error',
+            message: issue.message,
+            rule: issue.rule,
+        };
+        if (issue.blockIndex !== undefined)
+            out.field = `${ctx.collection.layoutField}[${issue.blockIndex}]`;
+        return out;
+    });
+    if (errors.length > 0) {
+        return {
+            pass: false,
+            code: 'composition-errors',
+            reason: `${errors.length} composition error${errors.length === 1 ? '' : 's'}`,
+            issues: errors,
+            suggestion: 'Fix the composition errors. Common causes: duplicate Heroes, forbidden adjacent blocks, or unknown component types.',
+        };
+    }
+    return { pass: true };
+};
+//# sourceMappingURL=composition.js.map

package/dist/pipeline/steps/composition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition.js","sourceRoot":"","sources":["../../../src/pipeline/steps/composition.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,MAAM,CAAC,GAAG,CACnD,4CAA4C,CAC7C,CAAA;AAqBD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAiB,KAAK,EAAE,GAAG,EAAE,EAAE;IACzD,MAAM,WAAW,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,CAAA;IAC5D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5D,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IACvB,CAAC;IAED,MAAM,MAAM,GAAI,WAA6B;SAC1C,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,KAAK,EAAE,SAAS,CAAA;QAC7B,MAAM,OAAO,GAAG,KAAK,EAAE,OAAO,CAAA;QAC9B,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAA;QACzC,OAAO,OAAO,OAAO,KAAK,QAAQ;YAChC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE;YACnB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAA;IACd,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,CAAC,EAA2C,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAA;IAErE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IAE9C,MAAM,SAAS,GAAI,GAAG,CAAC,OAA8C,CACnE,2BAA2B,CACM,CAAA;IAEnC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO;YACL,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,2BAA2B;YACjC,MAAM,EACJ,0FAA0F;YAC5F,UAAU,EACR,0HAA0H;SAC7H,CAAA;IACH,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;IAC1C,MAAM,MAAM,GAAoB,MAAM,CAAC,MAAM;SAC1C,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO,CAAC;SAC7C,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,GAAG,GAAkB;YACzB,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAA;QACD,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;YAAE,GAAG,CAAC,KAAK,GAAG,GAAG,GAAG,CAAC,UAAU,CAAC,WAAW,IAAI,KAAK,CAAC,UAAU,GAAG,CAAA;QACpG,OAAO,GAAG,CAAA;IACZ,CAAC,CAAC,CAAA;IAEJ,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO;YACL,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,oBAAoB;YAC1B,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,qBAAqB,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE;YAC7E,MAAM,EAAE,MAAM;YACd,UAAU,EACR,qHAAqH;SACxH,CAAA;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;AACvB,CAAC,CAAA"}

package/dist/pipeline/steps/embargo.d.ts

@@ -0,0 +1,12 @@
+import type { PipelineStep } from '../types.js';
+/**
+ * Enforces the document's policy:
+ * - `embargoedUntil`: blocks publish until that time has passed
+ * - `expiresAt`: blocks publish if the document has already expired
+ *
+ * Both fields live under the configured `policyField` on the document.
+ * Missing or null values are treated as "no policy applies" — the step
+ * passes.
+ */
+export declare const embargoStep: PipelineStep;
+//# sourceMappingURL=embargo.d.ts.map

package/dist/pipeline/steps/embargo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embargo.d.ts","sourceRoot":"","sources":["../../../src/pipeline/steps/embargo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,EAAE,YA6BzB,CAAA"}

package/dist/pipeline/steps/embargo.js

@@ -0,0 +1,41 @@
+/**
+ * Enforces the document's policy:
+ * - `embargoedUntil`: blocks publish until that time has passed
+ * - `expiresAt`: blocks publish if the document has already expired
+ *
+ * Both fields live under the configured `policyField` on the document.
+ * Missing or null values are treated as "no policy applies" — the step
+ * passes.
+ */
+export const embargoStep = async (ctx) => {
+    const policy = ctx.document[ctx.collection.policyField];
+    if (!policy)
+        return { pass: true };
+    const now = Date.now();
+    const embargoedUntil = parseDate(policy['embargoedUntil']);
+    if (embargoedUntil !== null && embargoedUntil > now) {
+        return {
+            pass: false,
+            code: 'embargoed',
+            reason: `Embargoed until ${new Date(embargoedUntil).toISOString()}`,
+            suggestion: 'Wait until the embargo expires, update the embargoedUntil date, or schedule publish for after the embargo.',
+        };
+    }
+    const expiresAt = parseDate(policy['expiresAt']);
+    if (expiresAt !== null && expiresAt < now) {
+        return {
+            pass: false,
+            code: 'expired',
+            reason: `Content expired on ${new Date(expiresAt).toISOString()}`,
+            suggestion: 'Update the expiresAt date or unpublish this content.',
+        };
+    }
+    return { pass: true };
+};
+function parseDate(value) {
+    if (typeof value !== 'string')
+        return null;
+    const ms = Date.parse(value);
+    return Number.isNaN(ms) ? null : ms;
+}
+//# sourceMappingURL=embargo.js.map

package/dist/pipeline/steps/embargo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embargo.js","sourceRoot":"","sources":["../../../src/pipeline/steps/embargo.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,WAAW,GAAiB,KAAK,EAAE,GAAG,EAAE,EAAE;IACrD,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,CAEzC,CAAA;IACb,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IAElC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IACtB,MAAM,cAAc,GAAG,SAAS,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAA;IAC1D,IAAI,cAAc,KAAK,IAAI,IAAI,cAAc,GAAG,GAAG,EAAE,CAAC;QACpD,OAAO;YACL,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,WAAW;YACjB,MAAM,EAAE,mBAAmB,IAAI,IAAI,CAAC,cAAc,CAAC,CAAC,WAAW,EAAE,EAAE;YACnE,UAAU,EACR,4GAA4G;SAC/G,CAAA;IACH,CAAC;IAED,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAA;IAChD,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,GAAG,GAAG,EAAE,CAAC;QAC1C,OAAO;YACL,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,sBAAsB,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,EAAE;YACjE,UAAU,EAAE,sDAAsD;SACnE,CAAA;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;AACvB,CAAC,CAAA;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IAC1C,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAC5B,OAAO,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAA;AACrC,CAAC"}

package/dist/pipeline/steps/execute.d.ts

@@ -0,0 +1,12 @@
+import type { PipelineStep } from '../types.js';
+/**
+ * Performs the actual publish: writes `_status: 'published'` and updates
+ * the publishedAt field, then fires `content/page.published` with metadata
+ * subscribers can react to (revalidation, integrations, etc.).
+ *
+ * Sets `context.bypassPublishingServer = true` on the Payload update so the
+ * status-write blocking hook recognizes this as a sanctioned write. Any
+ * other path that tries to flip `_status` will be rejected by the hook.
+ */
+export declare const executeStep: PipelineStep;
+//# sourceMappingURL=execute.d.ts.map

package/dist/pipeline/steps/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/pipeline/steps/execute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,EAAE,YA+BzB,CAAA"}

package/dist/pipeline/steps/execute.js

@@ -0,0 +1,38 @@
+/**
+ * Performs the actual publish: writes `_status: 'published'` and updates
+ * the publishedAt field, then fires `content/page.published` with metadata
+ * subscribers can react to (revalidation, integrations, etc.).
+ *
+ * Sets `context.bypassPublishingServer = true` on the Payload update so the
+ * status-write blocking hook recognizes this as a sanctioned write. Any
+ * other path that tries to flip `_status` will be rejected by the hook.
+ */
+export const executeStep = async (ctx) => {
+    const now = new Date().toISOString();
+    const previousPublishedAt = typeof ctx.document[ctx.collection.publishedAtField] === 'string'
+        ? ctx.document[ctx.collection.publishedAtField]
+        : null;
+    const wasFirstPublish = previousPublishedAt === null;
+    await ctx.payload.update({
+        collection: ctx.collection.slug,
+        id: ctx.documentId,
+        data: {
+            _status: 'published',
+            [ctx.collection.publishedAtField]: now,
+        },
+        context: { bypassPublishingServer: true },
+    });
+    await ctx.inngest.send({
+        name: 'content/page.published',
+        data: {
+            collection: ctx.collection.slug,
+            id: ctx.documentId,
+            slug: String(ctx.document[ctx.collection.slugField] ?? ctx.documentId),
+            publishedBy: ctx.actor.user?.id ?? 'system',
+            previousPublishedAt,
+            isFirstPublish: wasFirstPublish,
+        },
+    });
+    return { pass: true };
+};
+//# sourceMappingURL=execute.js.map

package/dist/pipeline/steps/execute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../../src/pipeline/steps/execute.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,WAAW,GAAiB,KAAK,EAAE,GAAG,EAAE,EAAE;IACrD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IACpC,MAAM,mBAAmB,GACvB,OAAO,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC,KAAK,QAAQ;QAC/D,CAAC,CAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAY;QAC3D,CAAC,CAAC,IAAI,CAAA;IACV,MAAM,eAAe,GAAG,mBAAmB,KAAK,IAAI,CAAA;IAEpD,MAAM,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC;QACvB,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,IAAI;QAC/B,EAAE,EAAE,GAAG,CAAC,UAAU;QAClB,IAAI,EAAE;YACJ,OAAO,EAAE,WAAW;YACpB,CAAC,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,GAAG;SACvC;QACD,OAAO,EAAE,EAAE,sBAAsB,EAAE,IAAI,EAAE;KAC1C,CAAC,CAAA;IAEF,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;QACrB,IAAI,EAAE,wBAAwB;QAC9B,IAAI,EAAE;YACJ,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,IAAI;YAC/B,EAAE,EAAE,GAAG,CAAC,UAAU;YAClB,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC;YACtE,WAAW,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,QAAQ;YAC3C,mBAAmB;YACnB,cAAc,EAAE,eAAe;SAChC;KACF,CAAC,CAAA;IAEF,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;AACvB,CAAC,CAAA"}

package/dist/pipeline/steps/exist.d.ts

@@ -0,0 +1,9 @@
+import type { PipelineStep } from '../types.js';
+/**
+ * Verifies the document exists and isn't already published with no
+ * outstanding draft changes. The publish operation should be idempotent
+ * but not silent — re-publishing a clean document returns a clear "already
+ * published" response so callers can distinguish that from success.
+ */
+export declare const existStep: PipelineStep;
+//# sourceMappingURL=exist.d.ts.map

package/dist/pipeline/steps/exist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exist.d.ts","sourceRoot":"","sources":["../../../src/pipeline/steps/exist.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,YAgBvB,CAAA"}

package/dist/pipeline/steps/exist.js

@@ -0,0 +1,31 @@
+/**
+ * Verifies the document exists and isn't already published with no
+ * outstanding draft changes. The publish operation should be idempotent
+ * but not silent — re-publishing a clean document returns a clear "already
+ * published" response so callers can distinguish that from success.
+ */
+export const existStep = async (ctx) => {
+    if (!ctx.document || Object.keys(ctx.document).length === 0) {
+        return { pass: false, code: 'not-found', reason: 'Document not found' };
+    }
+    const isPublished = ctx.document['_status'] === 'published';
+    if (isPublished && !hasUnpublishedChanges(ctx.document, ctx.collection.publishedAtField)) {
+        return {
+            pass: false,
+            code: 'already-published',
+            reason: 'Document is already published with no unpublished changes',
+            suggestion: 'Make a draft change first, then publish.',
+        };
+    }
+    return { pass: true };
+};
+function hasUnpublishedChanges(doc, publishedAtField) {
+    const updatedRaw = doc['updatedAt'];
+    const publishedRaw = doc[publishedAtField];
+    const updatedAt = typeof updatedRaw === 'string' ? Date.parse(updatedRaw) : 0;
+    const publishedAt = typeof publishedRaw === 'string' ? Date.parse(publishedRaw) : 0;
+    if (Number.isNaN(updatedAt) || Number.isNaN(publishedAt))
+        return true;
+    return updatedAt > publishedAt;
+}
+//# sourceMappingURL=exist.js.map

package/dist/pipeline/steps/exist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exist.js","sourceRoot":"","sources":["../../../src/pipeline/steps/exist.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAiB,KAAK,EAAE,GAAG,EAAE,EAAE;IACnD,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5D,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAA;IACzE,CAAC;IAED,MAAM,WAAW,GAAG,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,WAAW,CAAA;IAC3D,IAAI,WAAW,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACzF,OAAO;YACL,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,mBAAmB;YACzB,MAAM,EAAE,2DAA2D;YACnE,UAAU,EAAE,0CAA0C;SACvD,CAAA;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;AACvB,CAAC,CAAA;AAED,SAAS,qBAAqB,CAC5B,GAA4B,EAC5B,gBAAwB;IAExB,MAAM,UAAU,GAAG,GAAG,CAAC,WAAW,CAAC,CAAA;IACnC,MAAM,YAAY,GAAG,GAAG,CAAC,gBAAgB,CAAC,CAAA;IAC1C,MAAM,SAAS,GAAG,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC7E,MAAM,WAAW,GAAG,OAAO,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACnF,IAAI,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAA;IACrE,OAAO,SAAS,GAAG,WAAW,CAAA;AAChC,CAAC"}

package/dist/pipeline/steps/required-fields.d.ts

@@ -0,0 +1,9 @@
+import type { PipelineStep } from '../types.js';
+/**
+ * Verifies SEO title/description, slug, and any per-collection required
+ * fields are populated. SEO requirements are non-negotiable: a published
+ * page without title and description hurts share previews, search results,
+ * and accessibility cards.
+ */
+export declare const requiredFieldsStep: PipelineStep;
+//# sourceMappingURL=required-fields.d.ts.map

package/dist/pipeline/steps/required-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"required-fields.d.ts","sourceRoot":"","sources":["../../../src/pipeline/steps/required-fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,aAAa,CAAA;AAE9D;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,YAiDhC,CAAA"}

package/dist/pipeline/steps/required-fields.js

@@ -0,0 +1,63 @@
+/**
+ * Verifies SEO title/description, slug, and any per-collection required
+ * fields are populated. SEO requirements are non-negotiable: a published
+ * page without title and description hurts share previews, search results,
+ * and accessibility cards.
+ */
+export const requiredFieldsStep = async (ctx) => {
+    const issues = [];
+    const seo = ctx.document[ctx.collection.seoField];
+    if (!nonEmptyString(seo?.['title'])) {
+        issues.push({
+            field: `${ctx.collection.seoField}.title`,
+            message: 'SEO title is required',
+            severity: 'error',
+        });
+    }
+    if (!nonEmptyString(seo?.['description'])) {
+        issues.push({
+            field: `${ctx.collection.seoField}.description`,
+            message: 'SEO description is required',
+            severity: 'error',
+        });
+    }
+    if (!nonEmptyString(ctx.document[ctx.collection.slugField])) {
+        issues.push({
+            field: ctx.collection.slugField,
+            message: 'Slug is required',
+            severity: 'error',
+        });
+    }
+    for (const required of ctx.collection.requiredFields ?? []) {
+        const value = getPath(ctx.document, required.path);
+        if (value === null || value === undefined || value === '') {
+            issues.push({
+                field: required.path,
+                message: required.message,
+                severity: 'error',
+            });
+        }
+    }
+    if (issues.length > 0) {
+        return {
+            pass: false,
+            code: 'required-fields-missing',
+            reason: `${issues.length} required field${issues.length === 1 ? '' : 's'} missing`,
+            issues,
+            suggestion: 'Fill in the missing fields and try again.',
+        };
+    }
+    return { pass: true };
+};
+function nonEmptyString(value) {
+    return typeof value === 'string' && value.trim() !== '';
+}
+function getPath(obj, path) {
+    return path.split('.').reduce((acc, segment) => {
+        if (acc && typeof acc === 'object') {
+            return acc[segment];
+        }
+        return undefined;
+    }, obj);
+}
+//# sourceMappingURL=required-fields.js.map

package/dist/pipeline/steps/required-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"required-fields.js","sourceRoot":"","sources":["../../../src/pipeline/steps/required-fields.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAiB,KAAK,EAAE,GAAG,EAAE,EAAE;IAC5D,MAAM,MAAM,GAAoB,EAAE,CAAA;IAClC,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAwC,CAAA;IAExF,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC;YACV,KAAK,EAAE,GAAG,GAAG,CAAC,UAAU,CAAC,QAAQ,QAAQ;YACzC,OAAO,EAAE,uBAAuB;YAChC,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAA;IACJ,CAAC;IACD,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC;YACV,KAAK,EAAE,GAAG,GAAG,CAAC,UAAU,CAAC,QAAQ,cAAc;YAC/C,OAAO,EAAE,6BAA6B;YACtC,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAA;IACJ,CAAC;IAED,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QAC5D,MAAM,CAAC,IAAI,CAAC;YACV,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,SAAS;YAC/B,OAAO,EAAE,kBAAkB;YAC3B,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,MAAM,QAAQ,IAAI,GAAG,CAAC,UAAU,CAAC,cAAc,IAAI,EAAE,EAAE,CAAC;QAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAA;QAClD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YAC1D,MAAM,CAAC,IAAI,CAAC;gBACV,KAAK,EAAE,QAAQ,CAAC,IAAI;gBACpB,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO;YACL,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,yBAAyB;YAC/B,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,kBAAkB,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,UAAU;YAClF,MAAM;YACN,UAAU,EAAE,2CAA2C;SACxD,CAAA;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;AACvB,CAAC,CAAA;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAA;AACzD,CAAC;AAED,SAAS,OAAO,CAAC,GAA4B,EAAE,IAAY;IACzD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAU,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;QACtD,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACnC,OAAQ,GAA+B,CAAC,OAAO,CAAC,CAAA;QAClD,CAAC;QACD,OAAO,SAAS,CAAA;IAClB,CAAC,EAAE,GAAG,CAAC,CAAA;AACT,CAAC"}

package/dist/pipeline/types.d.ts

@@ -0,0 +1,45 @@
+import type { Inngest } from 'inngest';
+import type { Payload } from 'payload';
+import type { AuthenticatedUser } from '@forumone/throughline-plugin-contract';
+import type { AccessibilityIssue, PublishingPluginOptions, ResolvedCollection } from '../options.js';
+export interface PipelineActor {
+    user: AuthenticatedUser | null;
+    apiKeyName: string;
+    sessionId?: string | undefined;
+}
+export interface PipelineMeta {
+    userPrompt?: string | undefined;
+    reasoning?: string | undefined;
+    changesSummary?: string | undefined;
+}
+export interface PipelineContext {
+    payload: Payload;
+    inngest: Inngest;
+    options: PublishingPluginOptions;
+    collection: ResolvedCollection;
+    document: Record<string, unknown>;
+    documentId: string;
+    actor: PipelineActor;
+    meta?: PipelineMeta | undefined;
+}
+export type PipelineIssue = AccessibilityIssue & {
+    rule?: string;
+};
+export interface PipelineStepResult {
+    pass: boolean;
+    reason?: string;
+    code?: string;
+    issues?: PipelineIssue[];
+    suggestion?: string;
+}
+export type PipelineStep = (context: PipelineContext) => Promise<PipelineStepResult>;
+export interface PipelineResult {
+    success: boolean;
+    failedAt?: string;
+    reason?: string;
+    code?: string;
+    issues?: PipelineIssue[];
+    suggestion?: string;
+    publishedAt?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/pipeline/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/pipeline/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAA;AAC9E,OAAO,KAAK,EACV,kBAAkB,EAClB,uBAAuB,EACvB,kBAAkB,EACnB,MAAM,eAAe,CAAA;AAEtB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,uBAAuB,CAAA;IAChC,UAAU,EAAE,kBAAkB,CAAA;IAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,aAAa,CAAA;IACpB,IAAI,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;CAChC;AAED,MAAM,MAAM,aAAa,GAAG,kBAAkB,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAElE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,aAAa,EAAE,CAAA;IACxB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAA;AAEpF,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,aAAa,EAAE,CAAA;IACxB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB"}

package/dist/pipeline/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/pipeline/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/pipeline/types.ts"],"names":[],"mappings":""}

package/dist/plugin.d.ts

@@ -0,0 +1,4 @@
+import type { CorePlugin } from '@forumone/throughline-plugin-contract';
+import { type PublishingPluginOptions } from './options.js';
+export declare const publishingPlugin: CorePlugin<PublishingPluginOptions>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAA;AAQvE,OAAO,EAAE,KAAK,uBAAuB,EAAmB,MAAM,cAAc,CAAA;AAgB5E,eAAO,MAAM,gBAAgB,EAAE,UAAU,CAAC,uBAAuB,CA2F9D,CAAA"}

package/dist/plugin.js

@@ -0,0 +1,87 @@
+import { getPluginRegistry } from '@forumone/throughline-plugin-contract';
+import { createMcpHandler, createNamedLogger, defaultLogger, getAuditWriter, } from '@forumone/throughline-core';
+import { validateOptions } from './options.js';
+import { createBlockStatusWritesHook } from './hooks/block-status-writes.js';
+import { createGetPublishStatusTool, createPublishTool, createRollbackTool, createSchedulePublishTool, createUnpublishTool, } from './tools/index.js';
+const PLUGIN_ID = '@forumone/throughline-publishing';
+const PLUGIN_VERSION = '0.1.0';
+const MCP_HANDLER_SYMBOL = Symbol.for('@forumone/throughline/publishing-mcp-handler');
+export const publishingPlugin = (rawOptions) => (incomingConfig) => {
+    if (rawOptions.enabled === false)
+        return incomingConfig;
+    const options = validateOptions(rawOptions);
+    // Payload prepends `config.routes.api` (default `/api`); paths here must
+    // not start with /api or they'll be doubled.
+    const routePrefix = options.routePrefix ?? '/publishing';
+    const logger = createNamedLogger('publishing', options.logger ?? defaultLogger);
+    const publishableSlugs = new Set(options.collections.map((c) => c.slug));
+    // Inject the block-status-writes hook into every publishable collection.
+    const modifiedCollections = (incomingConfig.collections ?? []).map((collection) => {
+        if (!publishableSlugs.has(collection.slug))
+            return collection;
+        return {
+            ...collection,
+            hooks: {
+                ...(collection.hooks ?? {}),
+                beforeChange: [
+                    ...(collection.hooks?.beforeChange ?? []),
+                    createBlockStatusWritesHook(),
+                ],
+            },
+        };
+    });
+    return {
+        ...incomingConfig,
+        collections: modifiedCollections,
+        endpoints: [
+            ...(incomingConfig.endpoints ?? []),
+            {
+                path: `${routePrefix}/mcp`,
+                method: 'post',
+                handler: async (req) => {
+                    const handler = req.payload[MCP_HANDLER_SYMBOL];
+                    if (!handler) {
+                        return new Response(JSON.stringify({ error: 'Publishing MCP not initialized' }), { status: 503, headers: { 'content-type': 'application/json' } });
+                    }
+                    return handler(req);
+                },
+            },
+        ],
+        onInit: async (payload) => {
+            if (incomingConfig.onInit) {
+                await incomingConfig.onInit(payload);
+            }
+            const registry = getPluginRegistry(payload);
+            registry.requireCapability('audit-log', PLUGIN_ID);
+            const auditWriter = getAuditWriter(payload);
+            const tools = [
+                createPublishTool({ payload, options, auditWriter }),
+                createUnpublishTool({ payload, options, auditWriter }),
+                createSchedulePublishTool({ payload, options, auditWriter }),
+                createGetPublishStatusTool({ payload, options }),
+                createRollbackTool({ payload, options, auditWriter }),
+            ];
+            const handler = createMcpHandler({
+                payload,
+                serverName: 'publishing',
+                tools,
+                logger,
+            });
+            Object.defineProperty(payload, MCP_HANDLER_SYMBOL, {
+                value: handler,
+                enumerable: false,
+                writable: false,
+                configurable: false,
+            });
+            registry.register({
+                id: PLUGIN_ID,
+                version: PLUGIN_VERSION,
+                capabilities: ['publishing', 'publish-pipeline'],
+            });
+            logger.info('Publishing server ready', {
+                collections: options.collections.map((c) => c.slug),
+            });
+        },
+    };
+};
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"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"}