@forumone/throughline 0.0.0-stage → 1.0.0-next.0

package/dist/email/functions/_shared.js

@@ -0,0 +1,40 @@
+export { unwrapRelationshipId } from '../../utils/relationships.js';
+const COLLECTION_TO_KIND = {
+    pages: 'page',
+    posts: 'post',
+};
+/**
+ * Maps a collection slug to the human-friendly noun the templates render.
+ * Defaults to "item" so unknown collections still produce sensible copy
+ * ("the item Homepage" reads weirder than "the page Homepage" but it's
+ * better than dropping the noun entirely).
+ */
+export function targetKindFromCollection(slug) {
+    return COLLECTION_TO_KIND[slug] ?? 'item';
+}
+/**
+ * Defensive normalizer for the `notifiedApprovers` json field. Older
+ * snapshots stored an array of strings; the post-C7 fixup wraps each
+ * as `{ id, at, channel }`. We accept either shape.
+ */
+export function readApproverIds(value) {
+    if (!Array.isArray(value))
+        return [];
+    const ids = [];
+    for (const entry of value) {
+        if (typeof entry === 'string') {
+            ids.push(entry);
+        }
+        else if (entry && typeof entry === 'object' && 'id' in entry) {
+            ids.push(String(entry.id));
+        }
+    }
+    return ids;
+}
+export function formatHumanDate(iso) {
+    const date = new Date(iso);
+    if (Number.isNaN(date.getTime()))
+        return iso;
+    return date.toLocaleDateString('en-US', { month: 'short', day: 'numeric', year: 'numeric' });
+}
+//# sourceMappingURL=_shared.js.map

package/dist/email/functions/_shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_shared.js","sourceRoot":"","sources":["../../../src/email/functions/_shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AAInE,MAAM,kBAAkB,GAAuC;IAC7D,KAAK,EAAE,MAAM;IACb,KAAK,EAAE,MAAM;CACd,CAAA;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,OAAO,kBAAkB,CAAC,IAAI,CAAC,IAAI,MAAM,CAAA;AAC3C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IACpC,MAAM,GAAG,GAAa,EAAE,CAAA;IACxB,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACjB,CAAC;aAAM,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,IAAI,IAAI,KAAK,EAAE,CAAC;YAC/D,GAAG,CAAC,IAAI,CAAC,MAAM,CAAE,KAAyB,CAAC,EAAE,CAAC,CAAC,CAAA;QACjD,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAA;IAC1B,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,GAAG,CAAA;IAC5C,OAAO,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAA;AAC9F,CAAC"}

package/dist/email/functions/index.d.ts

@@ -0,0 +1,7 @@
+export { notifyApprovalRequestJob } from './notify-approval-request.js';
+export type { NotifyApprovalRequestDeps, NotifyApprovalRequestJobDeps, } from './notify-approval-request.js';
+export { notifyApprovalDecisionJob } from './notify-approval-decision.js';
+export type { NotifyApprovalDecisionDeps, NotifyApprovalDecisionJobDeps, } from './notify-approval-decision.js';
+export { notifyApprovalExpiredJob } from './notify-approval-expired.js';
+export type { NotifyApprovalExpiredDeps, NotifyApprovalExpiredJobDeps, } from './notify-approval-expired.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/email/functions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/email/functions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAA;AACvE,YAAY,EACV,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,8BAA8B,CAAA;AACrC,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAA;AACzE,YAAY,EACV,0BAA0B,EAC1B,6BAA6B,GAC9B,MAAM,+BAA+B,CAAA;AACtC,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAA;AACvE,YAAY,EACV,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,8BAA8B,CAAA"}

package/dist/email/functions/index.js

@@ -0,0 +1,4 @@
+export { notifyApprovalRequestJob } from './notify-approval-request.js';
+export { notifyApprovalDecisionJob } from './notify-approval-decision.js';
+export { notifyApprovalExpiredJob } from './notify-approval-expired.js';
+//# sourceMappingURL=index.js.map

package/dist/email/functions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/email/functions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAA;AAKvE,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAA;AAKzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAA"}

package/dist/email/functions/notify-approval-decision.d.ts

@@ -0,0 +1,34 @@
+import type { Inngest } from 'inngest';
+import { type Job, type JobContext } from '../../jobs/types.js';
+import { type WorkflowFailureHandler } from '../../jobs/workflow-types.js';
+import type { Payload } from 'payload';
+import type { EmailClient } from '../client.js';
+import type { EmailBrandTokens } from '../tokens.js';
+import type { EmailPluginOptions } from '../options.js';
+export interface NotifyApprovalDecisionDeps {
+    inngest: Inngest;
+    payload: Payload;
+    client: EmailClient;
+    tokens: EmailBrandTokens;
+    options: EmailPluginOptions;
+    /** Override the function id. Default: `notify-approval-decision`. */
+    id?: string;
+    /** Called once when a run has exhausted its retries. `emailPlugin` passes one. */
+    onFailure?: WorkflowFailureHandler;
+}
+/**
+ * Subscribes to `notification/send-approval-decision` (fired by the C10
+ * audit-event-echo when one of `approval.granted`, `approval.declined`,
+ * or `approval.changes_requested` is recorded). The decider's audit
+ * action travels with the event so we render the right variant without
+ * re-checking the approval's status.
+ */
+/** What the job needs at run time: the deps, less the Inngest client and id. */
+export type NotifyApprovalDecisionJobDeps = Omit<NotifyApprovalDecisionDeps, 'inngest' | 'id'>;
+/**
+ * The same notification as a runner-neutral job. `resolve` supplies its
+ * dependencies when it runs: the plugin passes the ones it was built with, and `emailJobs` reads them from `context.payload`, for a runner
+ * whose jobs are declared before Payload exists.
+ */
+export declare function notifyApprovalDecisionJob(resolve: (context: JobContext) => NotifyApprovalDecisionJobDeps, id?: string): Job;
+//# sourceMappingURL=notify-approval-decision.d.ts.map

package/dist/email/functions/notify-approval-decision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify-approval-decision.d.ts","sourceRoot":"","sources":["../../../src/email/functions/notify-approval-decision.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEtC,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,8BAA8B,CAAA;AAC1E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAMpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAGvD,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,WAAW,CAAA;IACnB,MAAM,EAAE,gBAAgB,CAAA;IACxB,OAAO,EAAE,kBAAkB,CAAA;IAC3B,qEAAqE;IACrE,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,kFAAkF;IAClF,SAAS,CAAC,EAAE,sBAAsB,CAAA;CACnC;AAcD;;;;;;GAMG;AACH,gFAAgF;AAChF,MAAM,MAAM,6BAA6B,GAAG,IAAI,CAAC,0BAA0B,EAAE,SAAS,GAAG,IAAI,CAAC,CAAA;AAE9F;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,6BAA6B,EAC/D,EAAE,SAA6B,GAC9B,GAAG,CAuEL"}

package/dist/email/functions/notify-approval-decision.js

@@ -0,0 +1,77 @@
+import { defineJob } from '../../jobs/define.js';
+import { ApprovalDecisionEmail, } from '../templates/index.js';
+import { DEFAULT_APPROVALS_SLUG } from '../../approvals/collection.js';
+import { unwrapRelationshipId } from './_shared.js';
+const DECISION_BY_ACTION = {
+    'approval.granted': 'granted',
+    'approval.declined': 'declined',
+    'approval.changes_requested': 'changes-requested',
+};
+const SUBJECT_BY_DECISION = {
+    granted: (title) => `Approved: ${title}`,
+    declined: (title) => `Not approved: ${title}`,
+    'changes-requested': (title) => `Changes requested on ${title}`,
+};
+/**
+ * The same notification as a runner-neutral job. `resolve` supplies its
+ * dependencies when it runs: the plugin passes the ones it was built with, and `emailJobs` reads them from `context.payload`, for a runner
+ * whose jobs are declared before Payload exists.
+ */
+export function notifyApprovalDecisionJob(resolve, id = 'notify-approval-decision') {
+    return defineJob({ id, retries: 3, on: { event: 'notification/send-approval-decision' } }, async (context) => {
+        const { event, step, logger } = context;
+        const deps = resolve(context);
+        const data = (event.data ?? {});
+        const approvalId = data.approvalId;
+        const decisionAction = data.decision ?? '';
+        if (!approvalId)
+            return { skipped: true, reason: 'no-approvalId' };
+        const decision = DECISION_BY_ACTION[decisionAction];
+        if (!decision) {
+            logger.warn('Unknown decision action; skipping', { approvalId, decisionAction });
+            return { skipped: true, reason: 'unknown-decision' };
+        }
+        const collectionSlug = deps.options.approvalsCollectionSlug ?? DEFAULT_APPROVALS_SLUG;
+        const approval = await step.run('load-approval', async () => deps.payload.findByID({ collection: collectionSlug, id: approvalId, depth: 1 }));
+        if (!approval)
+            return { skipped: true, reason: 'approval-not-found' };
+        const requesterId = unwrapRelationshipId(approval['requestedBy']);
+        if (!requesterId) {
+            logger.warn('Approval has no requester; cannot notify', { approvalId });
+            return { skipped: true, reason: 'no-requester' };
+        }
+        const targetTitle = String(approval['targetTitle'] ?? '(untitled)');
+        const decisionNotes = typeof approval['decisionNotes'] === 'string' ? approval['decisionNotes'] : undefined;
+        const previewUrl = typeof approval['previewUrl'] === 'string' ? approval['previewUrl'] : '';
+        const decidedById = unwrapRelationshipId(approval['decidedBy']);
+        const decidedByRecord = decidedById ? await deps.options.resolveApprover(decidedById) : null;
+        const decidedByName = decidedByRecord?.name ?? decidedByRecord?.email ?? 'a reviewer';
+        await step.run(`send-to-${requesterId}`, async () => {
+            const requester = await deps.options.resolveRequester(requesterId);
+            if (!requester) {
+                logger.warn('No email for requester; skipping', { requesterId, approvalId });
+                return;
+            }
+            await deps.client.send({
+                to: requester.email,
+                subject: SUBJECT_BY_DECISION[decision](targetTitle),
+                template: ApprovalDecisionEmail({
+                    requesterName: requester.name ?? requester.email,
+                    decidedBy: decidedByName,
+                    targetTitle,
+                    decision,
+                    ...(decisionNotes ? { decisionNotes } : {}),
+                    previewUrl,
+                    tokens: deps.tokens,
+                }),
+                tags: [
+                    { name: 'type', value: 'approval-decision' },
+                    { name: 'approval-id', value: approvalId },
+                    { name: 'decision', value: decision },
+                ],
+            });
+        });
+        return { approvalId, decision, sent: 1 };
+    });
+}
+//# sourceMappingURL=notify-approval-decision.js.map

package/dist/email/functions/notify-approval-decision.js.map

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

package/dist/email/functions/notify-approval-expired.d.ts

@@ -0,0 +1,32 @@
+import type { Inngest } from 'inngest';
+import { type Job, type JobContext } from '../../jobs/types.js';
+import { type WorkflowFailureHandler } from '../../jobs/workflow-types.js';
+import type { Payload } from 'payload';
+import type { EmailClient } from '../client.js';
+import type { EmailBrandTokens } from '../tokens.js';
+import type { EmailPluginOptions } from '../options.js';
+export interface NotifyApprovalExpiredDeps {
+    inngest: Inngest;
+    payload: Payload;
+    client: EmailClient;
+    tokens: EmailBrandTokens;
+    options: EmailPluginOptions;
+    /** Override the function id. Default: `notify-approval-expired`. */
+    id?: string;
+    /** Called once when a run has exhausted its retries. `emailPlugin` passes one. */
+    onFailure?: WorkflowFailureHandler;
+}
+/**
+ * Subscribes to `approval/expired` (fired by the C10 expire-stale-approvals
+ * cron). Notifies the original requester so they can decide whether to
+ * re-request approval or drop the change.
+ */
+/** What the job needs at run time: the deps, less the Inngest client and id. */
+export type NotifyApprovalExpiredJobDeps = Omit<NotifyApprovalExpiredDeps, 'inngest' | 'id'>;
+/**
+ * The same notification as a runner-neutral job. `resolve` supplies its
+ * dependencies when it runs: the plugin passes the ones it was built with, and `emailJobs` reads them from `context.payload`, for a runner
+ * whose jobs are declared before Payload exists.
+ */
+export declare function notifyApprovalExpiredJob(resolve: (context: JobContext) => NotifyApprovalExpiredJobDeps, id?: string): Job;
+//# sourceMappingURL=notify-approval-expired.d.ts.map

package/dist/email/functions/notify-approval-expired.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify-approval-expired.d.ts","sourceRoot":"","sources":["../../../src/email/functions/notify-approval-expired.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEtC,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,8BAA8B,CAAA;AAC1E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAGpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAGvD,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,WAAW,CAAA;IACnB,MAAM,EAAE,gBAAgB,CAAA;IACxB,OAAO,EAAE,kBAAkB,CAAA;IAC3B,oEAAoE;IACpE,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,kFAAkF;IAClF,SAAS,CAAC,EAAE,sBAAsB,CAAA;CACnC;AAED;;;;GAIG;AACH,gFAAgF;AAChF,MAAM,MAAM,4BAA4B,GAAG,IAAI,CAAC,yBAAyB,EAAE,SAAS,GAAG,IAAI,CAAC,CAAA;AAE5F;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,4BAA4B,EAC9D,EAAE,SAA4B,GAC7B,GAAG,CAwDL"}

package/dist/email/functions/notify-approval-expired.js

@@ -0,0 +1,54 @@
+import { defineJob } from '../../jobs/define.js';
+import { ApprovalExpiredEmail } from '../templates/index.js';
+import { DEFAULT_APPROVALS_SLUG } from '../../approvals/collection.js';
+import { formatHumanDate, unwrapRelationshipId } from './_shared.js';
+/**
+ * The same notification as a runner-neutral job. `resolve` supplies its
+ * dependencies when it runs: the plugin passes the ones it was built with, and `emailJobs` reads them from `context.payload`, for a runner
+ * whose jobs are declared before Payload exists.
+ */
+export function notifyApprovalExpiredJob(resolve, id = 'notify-approval-expired') {
+    return defineJob({ id, retries: 3, on: { event: 'approval/expired' } }, async (context) => {
+        const { event, step, logger } = context;
+        const deps = resolve(context);
+        const data = (event.data ?? {});
+        const approvalId = data.approvalId;
+        if (!approvalId)
+            return { skipped: true, reason: 'no-approvalId' };
+        const collectionSlug = deps.options.approvalsCollectionSlug ?? DEFAULT_APPROVALS_SLUG;
+        const approval = await step.run('load-approval', async () => deps.payload.findByID({ collection: collectionSlug, id: approvalId, depth: 1 }));
+        if (!approval)
+            return { skipped: true, reason: 'approval-not-found' };
+        const requesterId = data.requesterId ?? unwrapRelationshipId(approval['requestedBy']);
+        if (!requesterId) {
+            logger.warn('Expired approval has no requester; cannot notify', { approvalId });
+            return { skipped: true, reason: 'no-requester' };
+        }
+        const targetTitle = String(approval['targetTitle'] ?? '(untitled)');
+        const requestedAtIso = String(approval['requestedAt'] ?? '');
+        const requestedAt = requestedAtIso ? formatHumanDate(requestedAtIso) : 'an earlier date';
+        await step.run(`send-to-${requesterId}`, async () => {
+            const requester = await deps.options.resolveRequester(requesterId);
+            if (!requester) {
+                logger.warn('No email for requester; skipping', { requesterId, approvalId });
+                return;
+            }
+            await deps.client.send({
+                to: requester.email,
+                subject: `Approval expired: ${targetTitle}`,
+                template: ApprovalExpiredEmail({
+                    requesterName: requester.name ?? requester.email,
+                    targetTitle,
+                    requestedAt,
+                    tokens: deps.tokens,
+                }),
+                tags: [
+                    { name: 'type', value: 'approval-expired' },
+                    { name: 'approval-id', value: approvalId },
+                ],
+            });
+        });
+        return { approvalId, sent: 1 };
+    });
+}
+//# sourceMappingURL=notify-approval-expired.js.map

package/dist/email/functions/notify-approval-expired.js.map

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

package/dist/email/functions/notify-approval-request.d.ts

@@ -0,0 +1,35 @@
+import type { Inngest } from 'inngest';
+import { type Job, type JobContext } from '../../jobs/types.js';
+import { type WorkflowFailureHandler } from '../../jobs/workflow-types.js';
+import type { Payload } from 'payload';
+import type { EmailClient } from '../client.js';
+import type { EmailBrandTokens } from '../tokens.js';
+import type { EmailPluginOptions } from '../options.js';
+export interface NotifyApprovalRequestDeps {
+    inngest: Inngest;
+    payload: Payload;
+    client: EmailClient;
+    tokens: EmailBrandTokens;
+    options: EmailPluginOptions;
+    /** Override the function id. Default: `notify-approval-request`. */
+    id?: string;
+    /** Called once when a run has exhausted its retries. `emailPlugin` passes one. */
+    onFailure?: WorkflowFailureHandler;
+}
+/**
+ * Subscribes to `notification/send-approval-request` (fired by the C10
+ * audit-event-echo when `approval.requested` is recorded). Loads the
+ * approval, looks up the requester and each approver-id stored in
+ * `notifiedApprovers`, and sends one email per approver. Each email is
+ * its own `step.run` so a bouncing recipient retries without re-sending
+ * to the others.
+ */
+/** What the job needs at run time: the deps, less the Inngest client and id. */
+export type NotifyApprovalRequestJobDeps = Omit<NotifyApprovalRequestDeps, 'inngest' | 'id'>;
+/**
+ * The same notification as a runner-neutral job. `resolve` supplies its
+ * dependencies when it runs: the plugin passes the ones it was built with, and `emailJobs` reads them from `context.payload`, for a runner
+ * whose jobs are declared before Payload exists.
+ */
+export declare function notifyApprovalRequestJob(resolve: (context: JobContext) => NotifyApprovalRequestJobDeps, id?: string): Job;
+//# sourceMappingURL=notify-approval-request.d.ts.map

package/dist/email/functions/notify-approval-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify-approval-request.d.ts","sourceRoot":"","sources":["../../../src/email/functions/notify-approval-request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEtC,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,8BAA8B,CAAA;AAC1E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAGpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAQvD,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,WAAW,CAAA;IACnB,MAAM,EAAE,gBAAgB,CAAA;IACxB,OAAO,EAAE,kBAAkB,CAAA;IAC3B,oEAAoE;IACpE,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,kFAAkF;IAClF,SAAS,CAAC,EAAE,sBAAsB,CAAA;CACnC;AAED;;;;;;;GAOG;AACH,gFAAgF;AAChF,MAAM,MAAM,4BAA4B,GAAG,IAAI,CAAC,yBAAyB,EAAE,SAAS,GAAG,IAAI,CAAC,CAAA;AAE5F;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,4BAA4B,EAC9D,EAAE,SAA4B,GAC7B,GAAG,CAmGL"}

package/dist/email/functions/notify-approval-request.js

@@ -0,0 +1,89 @@
+import { defineJob } from '../../jobs/define.js';
+import { ApprovalRequestEmail } from '../templates/index.js';
+import { DEFAULT_APPROVALS_SLUG } from '../../approvals/collection.js';
+import { formatHumanDate, readApproverIds, targetKindFromCollection, unwrapRelationshipId, } from './_shared.js';
+/**
+ * The same notification as a runner-neutral job. `resolve` supplies its
+ * dependencies when it runs: the plugin passes the ones it was built with, and `emailJobs` reads them from `context.payload`, for a runner
+ * whose jobs are declared before Payload exists.
+ */
+export function notifyApprovalRequestJob(resolve, id = 'notify-approval-request') {
+    return defineJob({ id, retries: 3, on: { event: 'notification/send-approval-request' } }, async (context) => {
+        const { event, step, logger } = context;
+        const deps = resolve(context);
+        const data = (event.data ?? {});
+        const approvalId = data.approvalId;
+        if (!approvalId) {
+            logger.warn('Skipping notify-approval-request without approvalId');
+            return { skipped: true };
+        }
+        const collectionSlug = deps.options.approvalsCollectionSlug ?? DEFAULT_APPROVALS_SLUG;
+        const approval = await step.run('load-approval', async () => deps.payload.findByID({ collection: collectionSlug, id: approvalId, depth: 1 }));
+        if (!approval) {
+            logger.warn('Approval not found for notify-approval-request', { approvalId });
+            return { skipped: true, reason: 'approval-not-found' };
+        }
+        const approverIds = readApproverIds(approval['notifiedApprovers']);
+        if (approverIds.length === 0) {
+            logger.warn('No approvers to notify on approval', { approvalId });
+            return { sent: 0, reason: 'no-approvers' };
+        }
+        const requesterId = unwrapRelationshipId(approval['requestedBy']);
+        const requester = requesterId
+            ? await step.run('load-requester', () => deps.options.resolveRequester(requesterId))
+            : null;
+        const requesterName = requester?.name ?? requester?.email ?? 'A teammate';
+        const targetCollection = String(approval['targetCollection'] ?? '');
+        const targetId = String(approval['targetId'] ?? '');
+        const targetTitle = String(approval['targetTitle'] ?? '(untitled)');
+        const targetKind = targetKindFromCollection(targetCollection);
+        const changesSummary = String(approval['changesSummary'] ?? '');
+        const expiresAt = formatHumanDate(String(approval['expiresAt'] ?? ''));
+        const requestReason = typeof approval['requestReason'] === 'string' ? approval['requestReason'] : undefined;
+        let previewUrl = typeof approval['previewUrl'] === 'string' ? approval['previewUrl'] : '';
+        if (!previewUrl && deps.options.buildPreviewUrl) {
+            previewUrl = await step.run('build-preview-url', async () => deps.options.buildPreviewUrl({ targetCollection, targetId, approvalId }));
+        }
+        let sent = 0;
+        for (const approverId of approverIds) {
+            await step.run(`send-to-${approverId}`, async () => {
+                const approver = await deps.options.resolveApprover(approverId);
+                if (!approver) {
+                    logger.warn('No email for approver; skipping', { approverId });
+                    return;
+                }
+                const [approveUrl, changesUrl, discussUrl] = await Promise.all([
+                    deps.options.buildActionUrl({ approvalId, action: 'approve', approverId }),
+                    deps.options.buildActionUrl({ approvalId, action: 'changes', approverId }),
+                    deps.options.buildActionUrl({ approvalId, action: 'discuss', approverId }),
+                ]);
+                await deps.client.send({
+                    to: approver.email,
+                    subject: `Approval needed: ${targetTitle}`,
+                    template: ApprovalRequestEmail({
+                        approverName: approver.name ?? approver.email,
+                        requesterName,
+                        targetTitle,
+                        targetKind,
+                        changesSummary,
+                        ...(requestReason ? { requestReason } : {}),
+                        previewUrl,
+                        approveUrl,
+                        changesUrl,
+                        discussUrl,
+                        expiresAt,
+                        tokens: deps.tokens,
+                    }),
+                    tags: [
+                        { name: 'type', value: 'approval-request' },
+                        { name: 'approval-id', value: approvalId },
+                    ],
+                });
+                sent += 1;
+            });
+        }
+        logger.info('Approval-request notifications sent', { approvalId, sent });
+        return { approvalId, sent };
+    });
+}
+//# sourceMappingURL=notify-approval-request.js.map

package/dist/email/functions/notify-approval-request.js.map

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

package/dist/email/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `@forumone/throughline/email`: the email plugin and its Resend client, brand
+ * tokens, the three approval notifications as jobs, and their React Email
+ * templates. Was `@forumone/throughline-email` (and its `/templates`) in 0.x.
+ */
+export { emailJobs, emailPlugin, getEmailClient, getEmailFunctions } from './plugin.js';
+export { createEmailClient } from './client.js';
+export type { EmailClient, EmailClientOptions, SendEmailParams, SendEmailResult, TemplateRenderer, } from './client.js';
+export { defaultTokens, mergeTokens } from './tokens.js';
+export type { EmailBrandTokens } from './tokens.js';
+export { emailEnv } from './options.js';
+export type { ApprovalActionKind, BuildActionUrlArgs, EmailPluginOptions, ResolvedEmailEnv, ResolvedRecipient, } from './options.js';
+export { notifyApprovalRequestJob, notifyApprovalDecisionJob, notifyApprovalExpiredJob, } from './functions/index.js';
+export type { NotifyApprovalRequestJobDeps, NotifyApprovalDecisionJobDeps, NotifyApprovalExpiredJobDeps, } from './functions/index.js';
+export { EmailLayout, ApprovalRequestEmail, ApprovalDecisionEmail, ApprovalExpiredEmail, } from './templates/index.js';
+export type { ApprovalRequestEmailProps, ApprovalDecisionEmailProps, ApprovalDecisionKind, ApprovalExpiredEmailProps, ApprovalTargetKind, EmailLayoutProps, } from './templates/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/email/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/C,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,gBAAgB,GACjB,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACxD,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEnD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AACvC,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EACV,4BAA4B,EAC5B,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EACV,yBAAyB,EACzB,0BAA0B,EAC1B,oBAAoB,EACpB,yBAAyB,EACzB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,sBAAsB,CAAA"}

package/dist/email/index.js

@@ -0,0 +1,12 @@
+/**
+ * `@forumone/throughline/email`: the email plugin and its Resend client, brand
+ * tokens, the three approval notifications as jobs, and their React Email
+ * templates. Was `@forumone/throughline-email` (and its `/templates`) in 0.x.
+ */
+export { emailJobs, emailPlugin, getEmailClient, getEmailFunctions } from './plugin.js';
+export { createEmailClient } from './client.js';
+export { defaultTokens, mergeTokens } from './tokens.js';
+export { emailEnv } from './options.js';
+export { notifyApprovalRequestJob, notifyApprovalDecisionJob, notifyApprovalExpiredJob, } from './functions/index.js';
+export { EmailLayout, ApprovalRequestEmail, ApprovalDecisionEmail, ApprovalExpiredEmail, } from './templates/index.js';
+//# sourceMappingURL=index.js.map

package/dist/email/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/email/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAS/C,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAGxD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AASvC,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,sBAAsB,CAAA;AAO7B,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,sBAAsB,CAAA"}

package/dist/email/options.d.ts

@@ -0,0 +1,100 @@
+import type { Inngest } from 'inngest';
+import type { WorkflowFailureHandler } from '../jobs/workflow-types.js';
+import type { BaseCorePluginOptions } from '../plugin-contract/index.js';
+import type { EnvRequirement } from '../plugin-contract/env.js';
+import type { EmailBrandTokens } from './tokens.js';
+export type ApprovalActionKind = 'approve' | 'decline' | 'changes' | 'discuss';
+export interface ResolvedRecipient {
+    email: string;
+    name?: string;
+}
+export interface BuildActionUrlArgs {
+    approvalId: string;
+    action: ApprovalActionKind;
+    approverId: string;
+}
+export interface EmailPluginOptions extends BaseCorePluginOptions {
+    /**
+     * Inngest client used to register the three notification functions. Omit it
+     * on a site that runs jobs on Payload Jobs: pass `emailJobs(options)` to its
+     * jobs adapter instead.
+     */
+    inngest?: Inngest;
+    /**
+     * Called once when a notification run has exhausted its retries. Default:
+     * `createTerminalFailureHandler({ payload })` from the workflows package,
+     * which records a `job-failures` row (with `jobFailuresPlugin`), logs, and
+     * reports. These three ran with none, so a failed approval email was silent.
+     */
+    onTerminalFailure?: WorkflowFailureHandler;
+    /** Resend API key. Falls back to `process.env.RESEND_API_KEY`. */
+    apiKey?: string;
+    /** From address (e.g. `notifications@example.com`). Falls back to `EMAIL_FROM_ADDRESS`. */
+    fromAddress?: string;
+    /**
+     * From display name. Falls back to `EMAIL_FROM_NAME` then `tokens.brandName`.
+     * Centralizing on `brandName` is intentional — keep "this came from <site>"
+     * consistent across header, From, and footer.
+     */
+    fromName?: string;
+    /** Reply-to. Falls back to `EMAIL_REPLY_TO`. */
+    replyTo?: string;
+    /**
+     * Brand-token overrides. Anything omitted falls back to the neutral defaults
+     * (black on white, system sans, "Your Site"). Pass an empty object to keep
+     * defaults entirely.
+     */
+    tokens?: Partial<EmailBrandTokens>;
+    /** Approvals collection slug. Default: 'approvals'. */
+    approvalsCollectionSlug?: string;
+    /**
+     * Resolves an approver's email + display name from a user ID. The plugin
+     * stays decoupled from Payload's user model — different deployments may
+     * have users in different collections with different field names.
+     */
+    resolveApprover: (userId: string) => Promise<ResolvedRecipient | null>;
+    /** Resolves a requester's email + display name from a user ID. */
+    resolveRequester: (userId: string) => Promise<ResolvedRecipient | null>;
+    /**
+     * Builds the URL for an approval action button (Approve, Request changes,
+     * Discuss, Decline). Default implementation lands in a follow-up; clients
+     * normally pass their own builder that wraps approvals' HMAC-signed token.
+     */
+    buildActionUrl: (args: BuildActionUrlArgs) => Promise<string>;
+    /**
+     * Builds a deployment-relative preview URL for the given target document.
+     * Default implementation builds `${NEXT_PUBLIC_SERVER_URL}/preview?...` if
+     * the env var is set; clients with bespoke previews override.
+     */
+    buildPreviewUrl?: (args: {
+        targetCollection: string;
+        targetId: string;
+        approvalId: string;
+    }) => Promise<string>;
+}
+/**
+ * What `emailPlugin` reads from the environment when the matching option is
+ * omitted, and refuses to start without. Hand it to `assertEnvironment` from
+ * `@forumone/throughline` so a site reports it with everything else.
+ *
+ * Leave it out if you pass `apiKey` and `fromAddress` yourself. The optional
+ * `EMAIL_FROM_NAME` and `EMAIL_REPLY_TO` are not requirements.
+ */
+export declare const emailEnv: readonly EnvRequirement[];
+export interface ResolvedEmailEnv {
+    apiKey: string;
+    fromAddress: string;
+    fromName: string;
+    replyTo?: string;
+}
+/**
+ * Validates options at plugin init. Resolves the Resend secrets via env
+ * fallback so missing configuration surfaces immediately rather than on the
+ * first Inngest invocation.
+ */
+export declare function validateOptions(options: EmailPluginOptions): {
+    options: EmailPluginOptions;
+    env: ResolvedEmailEnv;
+    brandName: string;
+};
+//# sourceMappingURL=options.d.ts.map

package/dist/email/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/email/options.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAA;AACvE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAA;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEnD,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAA;AAE9E,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,kBAAkB,CAAA;IAC1B,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,kBAAmB,SAAQ,qBAAqB;IAC/D;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,sBAAsB,CAAA;IAC1C,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,2FAA2F;IAC3F,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAClC,uDAAuD;IACvD,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC;;;;OAIG;IACH,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAA;IACtE,kEAAkE;IAClE,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAA;IACvE;;;;OAIG;IACH,cAAc,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAC7D;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE;QACvB,gBAAgB,EAAE,MAAM,CAAA;QACxB,QAAQ,EAAE,MAAM,CAAA;QAChB,UAAU,EAAE,MAAM,CAAA;KACnB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CACtB;AAYD;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,EAAE,SAAS,cAAc,EAAoC,CAAA;AAElF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,kBAAkB,GAAG;IAC5D,OAAO,EAAE,kBAAkB,CAAA;IAC3B,GAAG,EAAE,gBAAgB,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;CAClB,CAuCA"}