@forumone/throughline 1.0.0-next.1 → 1.0.0-next.2

package/dist/migrate/rewrite.d.ts

@@ -0,0 +1,28 @@
+/** Every 0.x public path, and its 1.0 counterpart: the default target for its names. */
+export declare const COUNTERPARTS: Readonly<Record<string, string>>;
+/** Names 1.0 renamed, each to a name with the same value. */
+export declare const RENAMED: Readonly<Record<string, string>>;
+/** Names 1.0 removed or made internal, and what to do instead. */
+export declare const REMOVED: Readonly<Record<string, string>>;
+export interface Finding {
+    /** 1-based. */
+    line: number;
+    message: string;
+}
+export interface Rewrite {
+    text: string;
+    changed: boolean;
+    /** Rewritten, but worth a look: a mock or dynamic import pointed at one entry. */
+    review: Finding[];
+    /** Left as they were: what the codemod could not place. */
+    unresolved: Finding[];
+}
+/** The 1.0 entry for one name imported from one 0.x path, or why there is none. */
+export declare function placeName(oldSpecifier: string, name: string): {
+    specifier: string;
+    name: string;
+} | {
+    reason: string;
+};
+export declare function rewriteSource(text: string): Rewrite;
+//# sourceMappingURL=rewrite.d.ts.map

package/dist/migrate/rewrite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewrite.d.ts","sourceRoot":"","sources":["../../src/migrate/rewrite.ts"],"names":[],"mappings":"AAmBA,wFAAwF;AACxF,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAoCzD,CAAA;AAED,6DAA6D;AAC7D,eAAO,MAAM,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAGpD,CAAA;AAMD,kEAAkE;AAClE,eAAO,MAAM,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgCpD,CAAA;AAED,MAAM,WAAW,OAAO;IACtB,eAAe;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,OAAO,CAAA;IAChB,kFAAkF;IAClF,MAAM,EAAE,OAAO,EAAE,CAAA;IACjB,2DAA2D;IAC3D,UAAU,EAAE,OAAO,EAAE,CAAA;CACtB;AAOD,mFAAmF;AACnF,wBAAgB,SAAS,CACvB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,GACX;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAa1D;AAsBD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAoFnD"}

package/dist/migrate/rewrite.js

@@ -0,0 +1,188 @@
+import table from './exports.json' with { type: 'json' };
+/*
+Rewrites a source file's imports of the 0.x packages to their 1.0 homes, by
+docs/spec/1.0-exports.md.
+
+Each name goes to the 1.0 entry that exports it, from `exports.json`, which is
+read from the packages themselves. Where a name is exported twice in one
+package, the 0.x path's own 1.0 counterpart wins: `ContentField` from
+design-contract is `/contract`'s, and from design-system-payload `/generate`'s.
+
+What it cannot do safely it reports rather than guesses: a removed name, a
+namespace or default import, a mock or a dynamic import whose names it cannot
+see, a re-export of everything.
+*/
+const THROUGHLINE = '@forumone/throughline';
+const DESIGN_SYSTEM = '@forumone/throughline-design-system';
+/** Every 0.x public path, and its 1.0 counterpart: the default target for its names. */
+export const COUNTERPARTS = {
+    '@forumone/throughline-core': THROUGHLINE,
+    '@forumone/throughline-core/audit': `${THROUGHLINE}/audit`,
+    '@forumone/throughline-core/auth': THROUGHLINE,
+    '@forumone/throughline-core/client': `${THROUGHLINE}/client`,
+    '@forumone/throughline-core/env': THROUGHLINE,
+    '@forumone/throughline-core/events': `${THROUGHLINE}/jobs`,
+    '@forumone/throughline-core/fields': `${THROUGHLINE}/fields`,
+    '@forumone/throughline-core/media': `${THROUGHLINE}/media`,
+    '@forumone/throughline-core/mcp': THROUGHLINE,
+    '@forumone/throughline-core/observability': `${THROUGHLINE}/observability`,
+    '@forumone/throughline-core/references': `${THROUGHLINE}/media`,
+    '@forumone/throughline-core/rsc': `${THROUGHLINE}/rsc`,
+    '@forumone/throughline-core/testing': `${THROUGHLINE}/testing`,
+    '@forumone/throughline-plugin-contract': THROUGHLINE,
+    '@forumone/throughline-audit': `${THROUGHLINE}/audit`,
+    '@forumone/throughline-approvals': `${THROUGHLINE}/approvals`,
+    '@forumone/throughline-publishing': `${THROUGHLINE}/publishing`,
+    '@forumone/throughline-publishing/checks': `${THROUGHLINE}/publishing`,
+    '@forumone/throughline-publishing/client': `${THROUGHLINE}/client`,
+    '@forumone/throughline-publishing/editorial': `${THROUGHLINE}/editorial`,
+    '@forumone/throughline-publishing/rsc': `${THROUGHLINE}/rsc`,
+    '@forumone/throughline-components': `${THROUGHLINE}/components`,
+    '@forumone/throughline-integrations': `${THROUGHLINE}/integrations`,
+    '@forumone/throughline-integrations/client': `${THROUGHLINE}/client`,
+    '@forumone/throughline-email': `${THROUGHLINE}/email`,
+    '@forumone/throughline-email/templates': `${THROUGHLINE}/email`,
+    '@forumone/throughline-workflows': `${THROUGHLINE}/jobs`,
+    '@forumone/throughline-workflows/cache-tags': `${THROUGHLINE}/cache-tags`,
+    '@forumone/throughline-design-contract': `${DESIGN_SYSTEM}/contract`,
+    '@forumone/throughline-design-contract/lint': `${DESIGN_SYSTEM}/lint`,
+    '@forumone/throughline-design-system-payload': `${DESIGN_SYSTEM}/generate`,
+    '@forumone/throughline-design-system-payload/generate': `${DESIGN_SYSTEM}/generate`,
+    '@forumone/throughline-design-system-payload/render': `${DESIGN_SYSTEM}/render`,
+    '@forumone/throughline-design-system-payload/client': `${DESIGN_SYSTEM}/client`,
+    '@forumone/throughline-design-system-payload/testing': `${DESIGN_SYSTEM}/testing`,
+};
+/** Names 1.0 renamed, each to a name with the same value. */
+export const RENAMED = {
+    DEFAULT_AUDIT_COLLECTION_SLUG: 'DEFAULT_AUDIT_SLUG',
+    DEFAULT_APPROVALS_COLLECTION_SLUG: 'DEFAULT_APPROVALS_SLUG',
+};
+const FACTORY = 'removed: register the job instead, with inngestJobs(inngest, { onFailure, payload }), or let throughline() list it in suite.jobs';
+const VIA_THROUGHLINE = 'internal: throughline() does this. See docs/spec/1.0-throughline-call.md';
+/** Names 1.0 removed or made internal, and what to do instead. */
+export const REMOVED = {
+    createRevalidateOnPublishFunction: `${FACTORY} (revalidateOnPublishJob, /publishing)`,
+    createExecuteScheduledPublishesFunction: `${FACTORY} (executeScheduledPublishesJob, /publishing)`,
+    createPublishAtScheduledTimeFunction: `${FACTORY} (publishAtScheduledTimeJob, /publishing)`,
+    createExpireStaleApprovalsFunction: `${FACTORY} (expireStaleApprovalsJob, /approvals)`,
+    createAuditEventEchoFunction: `${FACTORY} (auditEventEchoJob, /audit)`,
+    createHealthcheckFunction: `${FACTORY} (healthcheckJob, /integrations)`,
+    createNotifyApprovalRequestFunction: `${FACTORY} (emailJobs, /email)`,
+    createNotifyApprovalDecisionFunction: `${FACTORY} (emailJobs, /email)`,
+    createNotifyApprovalExpiredFunction: `${FACTORY} (emailJobs, /email)`,
+    createMcpToolCollector: `${VIA_THROUGHLINE}; give mcpPlugin suite.mcpTools`,
+    toPayloadMcpTool: VIA_THROUGHLINE,
+    toPayloadMcpTools: VIA_THROUGHLINE,
+    AddToolsOptions: VIA_THROUGHLINE,
+    CreateMcpToolCollectorOptions: VIA_THROUGHLINE,
+    DeclareToolsOptions: VIA_THROUGHLINE,
+    McpToolDescriptor: VIA_THROUGHLINE,
+    PayloadMcpRequest: VIA_THROUGHLINE,
+    ToPayloadMcpToolOptions: VIA_THROUGHLINE,
+    getPluginRegistry: `${VIA_THROUGHLINE}: it owns the order plugins register in`,
+    PluginRegistry: VIA_THROUGHLINE,
+    PluginRegistryEntry: VIA_THROUGHLINE,
+    resolveAdminGroup: `${VIA_THROUGHLINE}; pass admin: { group } to it`,
+    DEFAULT_ADMIN_GROUP: VIA_THROUGHLINE,
+    getEmailFunctions: `${VIA_THROUGHLINE}; serve suite.jobs from the Inngest route`,
+    getIntegrationRegistry: `${VIA_THROUGHLINE}; serve suite.jobs from the Inngest route`,
+    getIntegrationContext: `${VIA_THROUGHLINE}; serve suite.jobs from the Inngest route`,
+    APPROVALS_RESOLVER_SYMBOL: 'internal: approvalsPlugin attaches the resolver and publishing finds it',
+    auditServerFor: 'internal',
+    mcpServerRefusal: 'internal',
+    validateOptions: 'internal: each plugin validates its own options',
+};
+const OLD = Object.keys(COUNTERPARTS)
+    .sort((a, b) => b.length - a.length)
+    .map((s) => s.replace(/[/-]/g, (c) => `\\${c}`))
+    .join('|');
+/** The 1.0 entry for one name imported from one 0.x path, or why there is none. */
+export function placeName(oldSpecifier, name) {
+    const counterpart = COUNTERPARTS[oldSpecifier];
+    if (!counterpart)
+        return { reason: `${oldSpecifier} is not a 0.x Throughline path` };
+    const renamed = RENAMED[name] ?? name;
+    if (name in REMOVED)
+        return { reason: `${name}: ${REMOVED[name]}` };
+    const pkg = counterpart.startsWith(DESIGN_SYSTEM) ? DESIGN_SYSTEM : THROUGHLINE;
+    const homes = table[pkg]?.[renamed] ?? [];
+    if (homes.includes(counterpart))
+        return { specifier: counterpart, name: renamed };
+    if (homes.length === 1)
+        return { specifier: homes[0], name: renamed };
+    if (homes.length === 0) {
+        return { reason: `${name} is not exported by ${pkg} 1.0; see docs/spec/1.0-exports.md` };
+    }
+    return { reason: `${name} is exported from ${homes.join(' and ')}; choose one` };
+}
+function lineOf(text, index) {
+    return text.slice(0, index).split('\n').length;
+}
+/** `{ a, type B, c as d }` -> its specifiers, keeping `type` and `as`. */
+function specifiersOf(body) {
+    return body
+        .split(',')
+        .map((raw) => raw.trim())
+        .filter(Boolean)
+        .map((raw) => {
+        const typeOnly = /^type\s+/.test(raw);
+        const rest = raw.replace(/^type\s+/, '');
+        const [name, alias] = rest.split(/\s+as\s+/).map((part) => part.trim());
+        return { raw, name: name, typeOnly, ...(alias ? { alias } : {}) };
+    });
+}
+export function rewriteSource(text) {
+    const review = [];
+    const unresolved = [];
+    let out = text;
+    // 1. Named imports and re-exports: split by where each name now lives.
+    const declaration = new RegExp(`(import|export)(\\s+type)?\\s*\\{([^}]*)\\}\\s*from\\s*(['"])(${OLD})\\4`, 'g');
+    out = out.replace(declaration, (whole, kw, typeKw, body, quote, oldSpecifier, offset) => {
+        const groups = new Map();
+        const left = [];
+        for (const spec of specifiersOf(body)) {
+            const placed = placeName(oldSpecifier, spec.name);
+            if ('reason' in placed) {
+                unresolved.push({ line: lineOf(text, offset), message: placed.reason });
+                left.push(spec.raw);
+                continue;
+            }
+            const local = spec.alias ?? (placed.name !== spec.name ? spec.name : undefined);
+            const written = (spec.typeOnly ? 'type ' : '') +
+                placed.name +
+                (local && local !== placed.name ? ` as ${local}` : '');
+            groups.set(placed.specifier, [...(groups.get(placed.specifier) ?? []), written]);
+        }
+        const type = typeKw ? ' type' : '';
+        const lines = [...groups.entries()].map(([specifier, names]) => `${kw}${type} { ${names.join(', ')} } from ${quote}${specifier}${quote}`);
+        if (left.length > 0)
+            lines.push(`${kw}${type} { ${left.join(', ')} } from ${quote}${oldSpecifier}${quote}`);
+        return lines.length > 0 ? lines.join('\n') : whole;
+    });
+    // 2. Everything else that names a 0.x path as a whole: point it at the
+    //    counterpart, and say so, because the names inside cannot be checked.
+    const whole = new RegExp(`(import\\s+\\*\\s+as\\s+\\w+\\s+from|import\\s+\\w+\\s+from|export\\s+\\*\\s+from|import\\(|vi\\.mock\\(|vi\\.doMock\\(|declare\\s+module)\\s*(['"])(${OLD})\\2`, 'g');
+    out = out.replace(whole, (match, head, quote, oldSpecifier, offset) => {
+        const counterpart = COUNTERPARTS[oldSpecifier];
+        review.push({
+            line: lineOf(out, offset),
+            message: `${head.trim()} ${oldSpecifier} now names ${counterpart}; check the names it relies on live there`,
+        });
+        return `${head} ${quote}${counterpart}${quote}`.replace(/\(\s+/, '(');
+    });
+    // 3. Admin component paths: 'pkg/client#Name', as an importMap or a config names them.
+    const componentPath = new RegExp(`(['"\`])(${OLD})#(\\w+)\\1`, 'g');
+    out = out.replace(componentPath, (match, quote, oldSpecifier, name, offset) => {
+        const placed = placeName(oldSpecifier, name);
+        if ('reason' in placed) {
+            unresolved.push({
+                line: lineOf(out, offset),
+                message: `${oldSpecifier}#${name}: ${placed.reason}`,
+            });
+            return match;
+        }
+        return `${quote}${placed.specifier}#${placed.name}${quote}`;
+    });
+    return { text: out, changed: out !== text, review, unresolved };
+}
+//# sourceMappingURL=rewrite.js.map

package/dist/migrate/rewrite.js.map

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

package/dist/observability/collection.d.ts

@@ -1,4 +1,5 @@
 import type { Access, CollectionConfig } from 'payload';
+import { type PluginAdminOptions } from '../plugin-contract/admin.js';
 export declare const DEFAULT_JOB_FAILURES_SLUG = "job-failures";
 /** What kind of thing failed. Adding a value is a schema change and needs a migration. */
 export declare const JOB_FAILURE_KINDS: readonly ["job", "healthcheck"];
@@ -8,6 +9,8 @@ export interface JobFailuresCollectionOptions {
     slug?: string;
     /** Read access. Default: users with the `admin` role. */
     readAccess?: Access;
+    /** Sidebar group, as every Throughline collection takes it. Default: `Throughline`. */
+    admin?: PluginAdminOptions;
 }
 export declare function createJobFailuresCollection(options?: JobFailuresCollectionOptions): CollectionConfig;
 //# sourceMappingURL=collection.d.ts.map

package/dist/observability/collection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../../src/observability/collection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAgBvD,eAAO,MAAM,yBAAyB,iBAAiB,CAAA;AAEvD,0FAA0F;AAC1F,eAAO,MAAM,iBAAiB,iCAAkC,CAAA;AAChE,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/D,MAAM,WAAW,4BAA4B;IAC3C,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAOD,wBAAgB,2BAA2B,CACzC,OAAO,GAAE,4BAAiC,GACzC,gBAAgB,CAuDlB"}
+{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../../src/observability/collection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AACvD,OAAO,EAAE,KAAK,kBAAkB,EAAqB,MAAM,6BAA6B,CAAA;AAgBxF,eAAO,MAAM,yBAAyB,iBAAiB,CAAA;AAEvD,0FAA0F;AAC1F,eAAO,MAAM,iBAAiB,iCAAkC,CAAA;AAChE,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/D,MAAM,WAAW,4BAA4B;IAC3C,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,uFAAuF;IACvF,KAAK,CAAC,EAAE,kBAAkB,CAAA;CAC3B;AAOD,wBAAgB,2BAA2B,CACzC,OAAO,GAAE,4BAAiC,GACzC,gBAAgB,CAwDlB"}

package/dist/observability/collection.js

@@ -1,3 +1,4 @@
+import { resolveAdminGroup } from '../plugin-contract/admin.js';
 /*
 Where a background job's failure is recorded.
 
@@ -22,6 +23,7 @@ export function createJobFailuresCollection(options = {}) {
     return {
         slug: options.slug ?? DEFAULT_JOB_FAILURES_SLUG,
         admin: {
+            ...resolveAdminGroup(options.admin),
             useAsTitle: 'summary',
             defaultColumns: ['createdAt', 'kind', 'source', 'message'],
             description: 'Background jobs that ran out of retries, and healthchecks that failed. Read-only; written by the failure handlers.',

package/dist/observability/collection.js.map

@@ -1 +1 @@
-{"version":3,"file":"collection.js","sourceRoot":"","sources":["../../src/observability/collection.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;EAYE;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG,cAAc,CAAA;AAEvD,0FAA0F;AAC1F,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,aAAa,CAAU,CAAA;AAUhE,MAAM,SAAS,GAAW,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;IACpC,MAAM,KAAK,GAAI,GAAG,CAAC,IAAI,EAAE,CAAC,OAAO,CAA0B,IAAI,EAAE,CAAA;IACjE,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;AAChC,CAAC,CAAA;AAED,MAAM,UAAU,2BAA2B,CACzC,UAAwC,EAAE;IAE1C,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,yBAAyB;QAC/C,KAAK,EAAE;YACL,UAAU,EAAE,SAAS;YACrB,cAAc,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC;YAC1D,WAAW,EACT,oHAAoH;SACvH;QACD,MAAM,EAAE;YACN,IAAI,EAAE,OAAO,CAAC,UAAU,IAAI,SAAS;YACrC,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK;YACnB,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK;YACnB,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK;SACpB;QACD,MAAM,EAAE;YACN;gBACE,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,MAAM;gBACZ,QAAQ,EAAE,IAAI;gBACd,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBAC5C,KAAK,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE;aAC/C;YACD;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,OAAO,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;aACrE;YACD;gBACE,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,MAAM;gBACZ,QAAQ,EAAE,IAAI;gBACd,KAAK,EAAE,EAAE,WAAW,EAAE,iEAAiE,EAAE;aAC1F;YACD,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE;YACjD,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;YACrD,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE;YACnC;gBACE,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,EAAE,WAAW,EAAE,kEAAkE,EAAE;aAC3F;YACD,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE;YACtC;gBACE,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,EAAE,WAAW,EAAE,yDAAyD,EAAE;aAClF;YACD,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE;YACrC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE;SACjC;QACD,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,CAAC;QACzE,UAAU,EAAE,KAAK;KAClB,CAAA;AACH,CAAC"}
+{"version":3,"file":"collection.js","sourceRoot":"","sources":["../../src/observability/collection.ts"],"names":[],"mappings":"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"}

package/dist/publishing/hooks/block-status-writes.d.ts

@@ -47,6 +47,38 @@ import type { CollectionBeforeChangeHook } from 'payload';
  * its own check it passed as an ordinary edit, and the page came down with no
  * policy check, no `unpublished` event and nothing to drop the cached copy.
  * It is refused while the document is live: unpublish, then trash.
+ *
+ * A create is the same question again. A document created as `published` is
+ * live the moment it exists, so it is refused like any other publish: create
+ * it as a draft, then publish it. This hook used to skip creates entirely,
+ * which left REST, and Payload's own MCP `create` tools, a way to put a page
+ * live that no check, approval or audit row ever saw.
+ *
+ * And an edit to a live document is a change to what the public sees, so it
+ * belongs in the pipeline as much as the first publish does. A non-draft write
+ * to a live document is refused unless it changes nothing; editors save a
+ * draft and publish it, which is what the admin's own buttons do. Otherwise
+ * "requires approval" held for the first publish and for no edit after it.
+ *
+ * The one exception is data a system derives from the published document and
+ * writes back to it — an audio rendition's URL, a sync's timestamp. Running
+ * the pipeline for those would gate the page on its own side effects. A write
+ * that carries `DERIVED_WRITE_CONTEXT` may change fields on a document that is
+ * live with nothing pending. It can never change `_status`, never promote a
+ * pending draft, and never create: it is a way to annotate a live page, not
+ * to publish one.
  */
 export declare function createBlockStatusWritesHook(): CollectionBeforeChangeHook;
+/**
+ * The context for a write of data derived from a live document, such as an
+ * audio rendition's URL, which is allowed to change that document without the
+ * pipeline. See `createBlockStatusWritesHook`.
+ *
+ * ```ts
+ * await payload.update({ collection: 'posts', id, data: { narration }, context: DERIVED_WRITE_CONTEXT })
+ * ```
+ */
+export declare const DERIVED_WRITE_CONTEXT: Readonly<{
+    throughlineDerivedWrite: true;
+}>;
 //# sourceMappingURL=block-status-writes.d.ts.map

package/dist/publishing/hooks/block-status-writes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"block-status-writes.d.ts","sourceRoot":"","sources":["../../../src/publishing/hooks/block-status-writes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAkB,MAAM,SAAS,CAAA;AAGzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,wBAAgB,2BAA2B,IAAI,0BAA0B,CA2DxE"}
+{"version":3,"file":"block-status-writes.d.ts","sourceRoot":"","sources":["../../../src/publishing/hooks/block-status-writes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAkB,MAAM,SAAS,CAAA;AAGzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG;AACH,wBAAgB,2BAA2B,IAAI,0BAA0B,CAyExE;AA6ID;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB;;EAAmD,CAAA"}

package/dist/publishing/hooks/block-status-writes.js

@@ -48,15 +48,40 @@ import { isDraftWrite } from './draft-writes.js';
  * its own check it passed as an ordinary edit, and the page came down with no
  * policy check, no `unpublished` event and nothing to drop the cached copy.
  * It is refused while the document is live: unpublish, then trash.
+ *
+ * A create is the same question again. A document created as `published` is
+ * live the moment it exists, so it is refused like any other publish: create
+ * it as a draft, then publish it. This hook used to skip creates entirely,
+ * which left REST, and Payload's own MCP `create` tools, a way to put a page
+ * live that no check, approval or audit row ever saw.
+ *
+ * And an edit to a live document is a change to what the public sees, so it
+ * belongs in the pipeline as much as the first publish does. A non-draft write
+ * to a live document is refused unless it changes nothing; editors save a
+ * draft and publish it, which is what the admin's own buttons do. Otherwise
+ * "requires approval" held for the first publish and for no edit after it.
+ *
+ * The one exception is data a system derives from the published document and
+ * writes back to it — an audio rendition's URL, a sync's timestamp. Running
+ * the pipeline for those would gate the page on its own side effects. A write
+ * that carries `DERIVED_WRITE_CONTEXT` may change fields on a document that is
+ * live with nothing pending. It can never change `_status`, never promote a
+ * pending draft, and never create: it is a way to annotate a live page, not
+ * to publish one.
  */
 export function createBlockStatusWritesHook() {
     return async ({ collection, data, originalDoc, operation, context, req }) => {
-        if (operation !== 'update')
-            return data;
         if (!carriesStatus(data))
             return data;
         if (isBypassed(context) || isBypassed(req?.context))
             return data;
+        if (operation === 'create') {
+            if (data['_status'] !== 'published')
+                return data;
+            throw new APIError('Create it as a draft, then publish it. Publishing is what runs the checks a live page needs.', 400);
+        }
+        if (operation !== 'update')
+            return data;
         const nextStatus = data['_status'];
         const previousStatus = originalDoc?.['_status'];
         const id = originalDoc?.id;
@@ -75,15 +100,18 @@ export function createBlockStatusWritesHook() {
             return data;
         }
         if (nextStatus === 'published') {
-            // This puts content live. Allowed only when the document is already
-            // live *and* nothing is pending: a latest version of `published`
-            // means there is no newer draft for this write to promote. When a
-            // draft is pending, this is the publish and it belongs in the
-            // pipeline — even though the live status does not change.
-            if (previousStatus === 'published')
-                return data;
+            // This writes to what is live. Allowed when it changes nothing — a
+            // save that restates the live content, or Payload's "Revert to
+            // published" discarding a pending draft — or when it is derived data
+            // on a document that is live with nothing pending: a latest version of
+            // `published` means there is no newer draft for it to promote.
             if (await restatesLiveContent(req, collection?.slug, id, data))
                 return data;
+            if (previousStatus === 'published' && !restoresFromTrash(data, originalDoc)) {
+                if (isDerivedWrite(context) || isDerivedWrite(req?.context))
+                    return data;
+                throw new APIError('This page is live. Save your change as a draft, then publish it, so the checks a live page needs run.', 400);
+            }
         }
         else {
             // This takes the live document down. Harmless only if nothing is
@@ -234,6 +262,21 @@ function restoresFromTrash(data, originalDoc) {
     const previous = originalDoc?.['deletedAt'];
     return next == null && previous != null;
 }
+/**
+ * The context for a write of data derived from a live document, such as an
+ * audio rendition's URL, which is allowed to change that document without the
+ * pipeline. See `createBlockStatusWritesHook`.
+ *
+ * ```ts
+ * await payload.update({ collection: 'posts', id, data: { narration }, context: DERIVED_WRITE_CONTEXT })
+ * ```
+ */
+export const DERIVED_WRITE_CONTEXT = Object.freeze({ throughlineDerivedWrite: true });
+function isDerivedWrite(context) {
+    if (!context || typeof context !== 'object')
+        return false;
+    return context['throughlineDerivedWrite'] === true;
+}
 function isBypassed(context) {
     if (!context || typeof context !== 'object')
         return false;

package/dist/publishing/hooks/block-status-writes.js.map

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

package/dist/publishing/index.d.ts

@@ -25,6 +25,12 @@ export type { DocumentActionArgs, PublishOutcome, PublishRequest, PublishStatusO
  * notification fires every few seconds of typing unless it asks this first.
  */
 export { isDraftWrite } from './hooks/draft-writes.js';
+/**
+ * For a write of data derived from a live document — an audio rendition, a
+ * sync timestamp — which may change it without the publish pipeline. Never a
+ * status change, a create, or the promotion of a pending draft.
+ */
+export { DERIVED_WRITE_CONTEXT } from './hooks/block-status-writes.js';
 export { BUILT_IN_ACCESSIBILITY_CHECKS, altTextCheck, headingHierarchyCheck, linkLabelsCheck, } from './checks/index.js';
 export { revalidateOnPublishJob } from './jobs/revalidate-on-publish.js';
 export { executeScheduledPublishesJob } from './jobs/execute-scheduled-publishes.js';

package/dist/publishing/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/publishing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAE9C,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,cAAc,CAAA;AAErB,YAAY,EACV,eAAe,EACf,cAAc,EACd,YAAY,EACZ,kBAAkB,GACnB,MAAM,qBAAqB,CAAA;AAE5B;;;;GAIG;AACH,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,cAAc,CAAA;AAErB,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,cAAc,CAAA;AAErB;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAGtD,OAAO,EACL,6BAA6B,EAC7B,YAAY,EACZ,qBAAqB,EACrB,eAAe,GAChB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAA;AACxE,OAAO,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAA;AACpF,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAA;AAC/E,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAA;AAC3E,YAAY,EACV,wBAAwB,EACxB,oBAAoB,EACpB,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,WAAW,GACZ,MAAM,gCAAgC,CAAA;AACvC,YAAY,EACV,gCAAgC,EAChC,6BAA6B,EAC7B,YAAY,EACZ,0BAA0B,EAC1B,oBAAoB,EACpB,yBAAyB,EACzB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,2BAA2B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/publishing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAE9C,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,cAAc,CAAA;AAErB,YAAY,EACV,eAAe,EACf,cAAc,EACd,YAAY,EACZ,kBAAkB,GACnB,MAAM,qBAAqB,CAAA;AAE5B;;;;GAIG;AACH,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,cAAc,CAAA;AAErB,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,cAAc,CAAA;AAErB;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAEtD;;;;GAIG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAA;AAGtE,OAAO,EACL,6BAA6B,EAC7B,YAAY,EACZ,qBAAqB,EACrB,eAAe,GAChB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAA;AACxE,OAAO,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAA;AACpF,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAA;AAC/E,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAA;AAC3E,YAAY,EACV,wBAAwB,EACxB,oBAAoB,EACpB,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,WAAW,GACZ,MAAM,gCAAgC,CAAA;AACvC,YAAY,EACV,gCAAgC,EAChC,6BAA6B,EAC7B,YAAY,EACZ,0BAA0B,EAC1B,oBAAoB,EACpB,yBAAyB,EACzB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,2BAA2B,CAAA"}

package/dist/publishing/index.js

@@ -22,6 +22,12 @@ export { getPublishStatus, getPublishingService, publishDocument, scheduleDocume
  * notification fires every few seconds of typing unless it asks this first.
  */
 export { isDraftWrite } from './hooks/draft-writes.js';
+/**
+ * For a write of data derived from a live document — an audio rendition, a
+ * sync timestamp — which may change it without the publish pipeline. Never a
+ * status change, a create, or the promotion of a pending draft.
+ */
+export { DERIVED_WRITE_CONTEXT } from './hooks/block-status-writes.js';
 // Built-in accessibility checks, which were `@forumone/throughline-publishing/checks`.
 export { BUILT_IN_ACCESSIBILITY_CHECKS, altTextCheck, headingHierarchyCheck, linkLabelsCheck, } from './checks/index.js';
 // Revalidation and scheduled publishing, as jobs for either adapter in `/jobs`.

package/dist/publishing/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/publishing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAmB9C;;;;GAIG;AACH,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,cAAc,CAAA;AAerB;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAEtD,uFAAuF;AACvF,OAAO,EACL,6BAA6B,EAC7B,YAAY,EACZ,qBAAqB,EACrB,eAAe,GAChB,MAAM,mBAAmB,CAAA;AAE1B,gFAAgF;AAChF,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAA;AACxE,OAAO,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAA;AACpF,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAA;AAC/E,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/publishing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAmB9C;;;;GAIG;AACH,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,cAAc,CAAA;AAerB;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAEtD;;;;GAIG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAA;AAEtE,uFAAuF;AACvF,OAAO,EACL,6BAA6B,EAC7B,YAAY,EACZ,qBAAqB,EACrB,eAAe,GAChB,MAAM,mBAAmB,CAAA;AAE1B,gFAAgF;AAChF,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAA;AACxE,OAAO,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAA;AACpF,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAA;AAC/E,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAA"}

package/dist/publishing/pipeline/steps/accessibility.d.ts

@@ -1,9 +1,10 @@
 import type { PipelineStep } from '../types.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.)
+ * Errors block publish; warnings don't, and reach the publish result's
+ * `warnings`, one line each, named by the check that raised them. (The
+ * built-ins raise none; a site's own checks may.) They used to be dropped
+ * here, so a check that warned said nothing to anybody.
  *
  * Built-ins named in `disableAccessibilityChecks` are skipped, so a host
  * whose content shape trips one can replace it rather than wait for a

package/dist/publishing/pipeline/steps/accessibility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"accessibility.d.ts","sourceRoot":"","sources":["../../../../src/publishing/pipeline/steps/accessibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,aAAa,CAAA;AAG9D;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,EAAE,YA4B/B,CAAA"}
+{"version":3,"file":"accessibility.d.ts","sourceRoot":"","sources":["../../../../src/publishing/pipeline/steps/accessibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,aAAa,CAAA;AAG9D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,EAAE,YAiC/B,CAAA"}

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

@@ -1,9 +1,10 @@
 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.)
+ * Errors block publish; warnings don't, and reach the publish result's
+ * `warnings`, one line each, named by the check that raised them. (The
+ * built-ins raise none; a site's own checks may.) They used to be dropped
+ * here, so a check that warned said nothing to anybody.
  *
  * Built-ins named in `disableAccessibilityChecks` are skipped, so a host
  * whose content shape trips one can replace it rather than wait for a
@@ -23,8 +24,13 @@ export const accessibilityStep = async (ctx) => {
         }
     }
     const errors = allIssues.filter((i) => i.severity === 'error');
+    const warnings = allIssues
+        .filter((i) => i.severity === 'warning')
+        .map((i) => `${i.rule}: ${i.message}${i.field ? ` (${i.field})` : ''}`);
+    const carried = warnings.length ? { warnings } : {};
     if (errors.length > 0) {
         return {
+            ...carried,
             pass: false,
             code: 'accessibility-errors',
             reason: `${errors.length} accessibility issue${errors.length === 1 ? '' : 's'}`,
@@ -32,6 +38,6 @@ export const accessibilityStep = async (ctx) => {
             suggestion: 'Every image needs alt text. Every link needs a label. Heading levels must not skip. Fix these before publishing.',
         };
     }
-    return { pass: true };
+    return { pass: true, ...carried };
 };
 //# sourceMappingURL=accessibility.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"accessibility.js","sourceRoot":"","sources":["../../../../src/publishing/pipeline/steps/accessibility.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAA;AAErE;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAiB,KAAK,EAAE,GAAG,EAAE,EAAE;IAC3D,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAA;IACtE,MAAM,MAAM,GAAG;QACb,GAAG,6BAA6B,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7E,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"}
+{"version":3,"file":"accessibility.js","sourceRoot":"","sources":["../../../../src/publishing/pipeline/steps/accessibility.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAA;AAErE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAiB,KAAK,EAAE,GAAG,EAAE,EAAE;IAC3D,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAA;IACtE,MAAM,MAAM,GAAG;QACb,GAAG,6BAA6B,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7E,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,MAAM,QAAQ,GAAG,SAAS;SACvB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC;SACvC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IACzE,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IACnD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO;YACL,GAAG,OAAO;YACV,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,GAAG,OAAO,EAAE,CAAA;AACnC,CAAC,CAAA"}

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

@@ -42,7 +42,7 @@ export const approvalStep = async (ctx) => {
             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.',
+            suggestion: 'Call request_approval to ask for one. Once it is granted, publish will succeed.',
         };
     }
     return { pass: true };

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

@@ -1 +1 @@
-{"version":3,"file":"approval.js","sourceRoot":"","sources":["../../../../src/publishing/pipeline/steps/approval.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAA;AAGpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAA;AAGxE;;;;;;;;;;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;;;;;;;;;;MAUE;IACF,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACzD,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"}
+{"version":3,"file":"approval.js","sourceRoot":"","sources":["../../../../src/publishing/pipeline/steps/approval.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAA;AAGpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAA;AAGxE;;;;;;;;;;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;;;;;;;;;;MAUE;IACF,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACzD,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,iFAAiF;SACpF,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"}