@carlonicora/nestjs-neo4jsonapi 7.1.0 → 8.1.0

package/dist/foundations/billing/interfaces/billing.config.interface.d.ts

@@ -0,0 +1,71 @@
+/**
+ * The three billing emails an app can switch off one by one.
+ */
+export type BillingEmailKey = "paymentFailed" | "cardExpiring" | "subscriptionEnded";
+/**
+ * App-relative paths the billing emails link to. The sender prefixes each with
+ * the app URL (`app.url`, trailing slash removed).
+ */
+export type BillingLinks = {
+    billing: string;
+    paymentMethod: string;
+    subscribe: string;
+    resubscribe: string;
+};
+/**
+ * One email job the library sender handles: the template id and the mapping from
+ * the queued payload to the template data.
+ */
+export interface BillingEmailJobDefinition {
+    template: string;
+    toTemplateData: (payload: Record<string, unknown>, ctx: {
+        appUrl: string;
+        locale: string;
+        links: BillingLinks;
+    }) => Record<string, unknown>;
+}
+/**
+ * Configuration for the BillingModule. Every key is optional; omitted keys keep
+ * the value in `DEFAULT_BILLING_CONFIG`.
+ */
+export interface BillingModuleConfig {
+    /**
+     * The library billing email sender (a BullMQ worker on `QueueId.EMAIL`).
+     * OFF by default: apps that consume the email queue with their own processor
+     * keep doing so. `extraJobs` adds or overrides job types for the app.
+     */
+    emailSender?: {
+        enabled?: boolean;
+        extraJobs?: Record<string, BillingEmailJobDefinition>;
+    };
+    /** Per-email switches. Default: every email on. */
+    emails?: Partial<Record<BillingEmailKey, boolean>>;
+    /** Keep full access while Stripe retries a failed renewal, for GMs who have paid before. Default on. */
+    failedCardGrace?: boolean;
+    /** Days between a subscription ending and the company's deletion date. Default 30. */
+    deletion?: {
+        afterSubscriptionEndedDays?: number;
+    };
+    /** App-relative paths used in billing emails. */
+    links?: Partial<BillingLinks>;
+}
+export type ResolvedBillingConfig = {
+    emailSender: {
+        enabled: boolean;
+        extraJobs: Record<string, BillingEmailJobDefinition>;
+    };
+    emails: Record<BillingEmailKey, boolean>;
+    failedCardGrace: boolean;
+    deletion: {
+        afterSubscriptionEndedDays: number;
+    };
+    links: BillingLinks;
+};
+export declare const DEFAULT_BILLING_CONFIG: ResolvedBillingConfig;
+export declare const BILLING_CONFIG: unique symbol;
+/**
+ * Merges an app's billing config over the defaults, key by key: a partial
+ * `emails` or `links` object keeps every key it does not name.
+ */
+export declare function resolveBillingConfig(config?: BillingModuleConfig): ResolvedBillingConfig;
+//# sourceMappingURL=billing.config.interface.d.ts.map

package/dist/foundations/billing/interfaces/billing.config.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.config.interface.d.ts","sourceRoot":"","sources":["../../../../src/foundations/billing/interfaces/billing.config.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG,cAAc,GAAG,mBAAmB,CAAC;AAErF;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9G;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,CACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,GAAG,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,YAAY,CAAA;KAAE,KACzD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,WAAW,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAA;KAAE,CAAC;IAC3F,mDAAmD;IACnD,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,wGAAwG;IACxG,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,sFAAsF;IACtF,QAAQ,CAAC,EAAE;QAAE,0BAA0B,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;CAC/B;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,WAAW,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAA;KAAE,CAAC;IACxF,MAAM,EAAE,MAAM,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IACzC,eAAe,EAAE,OAAO,CAAC;IACzB,QAAQ,EAAE;QAAE,0BAA0B,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,KAAK,EAAE,YAAY,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,qBAWpC,CAAC;AAEF,eAAO,MAAM,cAAc,eAA2B,CAAC;AAEvD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,qBAAqB,CAcxF"}

package/dist/foundations/billing/interfaces/billing.config.interface.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BILLING_CONFIG = exports.DEFAULT_BILLING_CONFIG = void 0;
+exports.resolveBillingConfig = resolveBillingConfig;
+exports.DEFAULT_BILLING_CONFIG = {
+    emailSender: { enabled: false, extraJobs: {} },
+    emails: { paymentFailed: true, cardExpiring: true, subscriptionEnded: true },
+    failedCardGrace: true,
+    deletion: { afterSubscriptionEndedDays: 30 },
+    links: {
+        billing: "/settings/billing",
+        paymentMethod: "/settings/billing",
+        subscribe: "/settings/billing?action=subscribe",
+        resubscribe: "/settings/billing",
+    },
+};
+exports.BILLING_CONFIG = Symbol("BILLING_CONFIG");
+/**
+ * Merges an app's billing config over the defaults, key by key: a partial
+ * `emails` or `links` object keeps every key it does not name.
+ */
+function resolveBillingConfig(config) {
+    return {
+        emailSender: {
+            enabled: config?.emailSender?.enabled ?? exports.DEFAULT_BILLING_CONFIG.emailSender.enabled,
+            extraJobs: { ...exports.DEFAULT_BILLING_CONFIG.emailSender.extraJobs, ...(config?.emailSender?.extraJobs ?? {}) },
+        },
+        emails: { ...exports.DEFAULT_BILLING_CONFIG.emails, ...stripUndefined(config?.emails) },
+        failedCardGrace: config?.failedCardGrace ?? exports.DEFAULT_BILLING_CONFIG.failedCardGrace,
+        deletion: {
+            afterSubscriptionEndedDays: config?.deletion?.afterSubscriptionEndedDays ?? exports.DEFAULT_BILLING_CONFIG.deletion.afterSubscriptionEndedDays,
+        },
+        links: { ...exports.DEFAULT_BILLING_CONFIG.links, ...stripUndefined(config?.links) },
+    };
+}
+function stripUndefined(value) {
+    if (!value)
+        return {};
+    return Object.fromEntries(Object.entries(value).filter(([, v]) => v !== undefined));
+}
+//# sourceMappingURL=billing.config.interface.js.map

package/dist/foundations/billing/interfaces/billing.config.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.config.interface.js","sourceRoot":"","sources":["../../../../src/foundations/billing/interfaces/billing.config.interface.ts"],"names":[],"mappings":";;;AAuEA,oDAcC;AAjCY,QAAA,sBAAsB,GAA0B;IAC3D,WAAW,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE;IAC9C,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE;IAC5E,eAAe,EAAE,IAAI;IACrB,QAAQ,EAAE,EAAE,0BAA0B,EAAE,EAAE,EAAE;IAC5C,KAAK,EAAE;QACL,OAAO,EAAE,mBAAmB;QAC5B,aAAa,EAAE,mBAAmB;QAClC,SAAS,EAAE,oCAAoC;QAC/C,WAAW,EAAE,mBAAmB;KACjC;CACF,CAAC;AAEW,QAAA,cAAc,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAEvD;;;GAGG;AACH,SAAgB,oBAAoB,CAAC,MAA4B;IAC/D,OAAO;QACL,WAAW,EAAE;YACX,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,IAAI,8BAAsB,CAAC,WAAW,CAAC,OAAO;YACnF,SAAS,EAAE,EAAE,GAAG,8BAAsB,CAAC,WAAW,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,IAAI,EAAE,CAAC,EAAE;SAC1G;QACD,MAAM,EAAE,EAAE,GAAG,8BAAsB,CAAC,MAAM,EAAE,GAAG,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE;QAC/E,eAAe,EAAE,MAAM,EAAE,eAAe,IAAI,8BAAsB,CAAC,eAAe;QAClF,QAAQ,EAAE;YACR,0BAA0B,EACxB,MAAM,EAAE,QAAQ,EAAE,0BAA0B,IAAI,8BAAsB,CAAC,QAAQ,CAAC,0BAA0B;SAC7G;QACD,KAAK,EAAE,EAAE,GAAG,8BAAsB,CAAC,KAAK,EAAE,GAAG,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE;KAC7E,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAmB,KAAS;IACjD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAe,CAAC;AACpG,CAAC"}

package/dist/foundations/billing/processors/billing-email.jobs.d.ts

@@ -0,0 +1,127 @@
+import { BillingEmailJobDefinition } from "../interfaces/billing.config.interface";
+/**
+ * Job types the library billing email sender handles out of the box.
+ *
+ * The mapping below is copied from only35's `apps/api/src/processors/email.processor.ts`
+ * (every job type except the app-specific `cull-completed`), with the hard-coded
+ * paths turned into the configurable `links`. `card-expiring` is new.
+ */
+export type LibraryBillingJobType = "payment-failure" | "subscription-status-change" | "payment-success-customer" | "payment-success-admin" | "trial-ending-reminder" | "trial-ended" | "deletion-warning" | "subscription-cancelled" | "company-deleted" | "referral-invite" | "referral-reward" | "card-expiring";
+export interface BillingEmailJobData {
+    jobType: string;
+    payload: Record<string, unknown> & {
+        to: string;
+        locale?: string;
+    };
+}
+export interface PaymentFailureEmailParams {
+    to: string;
+    customerName: string;
+    stripeCustomerId: string;
+    stripeInvoiceId?: string;
+    stripePaymentIntentId?: string;
+    amount?: number;
+    currency?: string;
+    errorMessage?: string;
+    invoiceUrl?: string;
+    invoiceNumber?: string;
+    keepsAccess?: boolean;
+    locale?: string;
+}
+export interface SubscriptionStatusEmailParams {
+    to: string;
+    customerName: string;
+    stripeCustomerId: string;
+    subscriptionId: string;
+    status: string;
+    locale?: string;
+}
+export interface PaymentSuccessCustomerEmailParams {
+    to: string;
+    customerName: string;
+    stripeCustomerId: string;
+    stripeInvoiceId?: string;
+    stripePaymentIntentId?: string;
+    amount: number;
+    currency: string;
+    invoiceUrl?: string;
+    invoiceNumber?: string;
+    isOneTimePurchase: boolean;
+    locale?: string;
+}
+export interface PaymentSuccessAdminEmailParams {
+    to: string;
+    adminName: string;
+    companyName: string;
+    amount: number;
+    currency: string;
+    isOneTimePurchase: boolean;
+    locale?: string;
+}
+export interface TrialEndingReminderEmailParams {
+    to: string;
+    customerName: string;
+    stripeCustomerId: string;
+    stripeSubscriptionId: string;
+    trialEndDate: string;
+    locale?: string;
+}
+export interface TrialEndedEmailParams {
+    to: string;
+    customerName: string;
+    companyName: string;
+    stripeCustomerId: string;
+    stripeSubscriptionId: string;
+    trialEndDate: string;
+    dataRemovalDate: string;
+    locale?: string;
+}
+export interface DeletionWarningEmailParams {
+    to: string;
+    companyName: string;
+    daysRemaining: number;
+    deletionDate: string;
+    reason: "trial_expired" | "subscription_cancelled";
+    isTrialExpired: boolean;
+    isSubscriptionCancelled: boolean;
+    locale?: string;
+}
+export interface SubscriptionCancelledEmailParams {
+    to: string;
+    companyName: string;
+    dataRemovalDate: string;
+    locale?: string;
+}
+export interface CompanyDeletedEmailParams {
+    to: string;
+    companyName: string;
+    reason: "trial_expired" | "subscription_cancelled" | "immediate_deletion";
+    deletionDate: string;
+    locale?: string;
+}
+export interface ReferralInviteEmailParams {
+    to: string;
+    referralCode: string;
+    companyName: string;
+    inviterName: string;
+    inviterEmail: string;
+    referralUrl: string;
+    locale?: string;
+}
+export interface ReferralRewardEmailParams {
+    to: string;
+    userName: string;
+    tokensAwarded: number;
+    locale?: string;
+}
+export interface CardExpiringEmailParams {
+    to: string;
+    customerName: string;
+    stripeCustomerId: string;
+    renewalDate: string;
+    cardBrand: string;
+    cardLast4: string;
+    locale?: string;
+}
+export declare const LIBRARY_BILLING_EMAIL_JOBS: Record<LibraryBillingJobType, BillingEmailJobDefinition>;
+//# sourceMappingURL=billing-email.jobs.d.ts.map

package/dist/foundations/billing/processors/billing-email.jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-email.jobs.d.ts","sourceRoot":"","sources":["../../../../src/foundations/billing/processors/billing-email.jobs.ts"],"names":[],"mappings":"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"}

package/dist/foundations/billing/processors/billing-email.jobs.js

@@ -0,0 +1,196 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LIBRARY_BILLING_EMAIL_JOBS = void 0;
+const email_helpers_1 = require("../../../core/email/email.helpers");
+/** Narrows the queued payload to the shape a job expects. */
+function asParams(payload) {
+    return payload;
+}
+exports.LIBRARY_BILLING_EMAIL_JOBS = {
+    "payment-failure": {
+        template: "paymentFailure",
+        toTemplateData: (payload, { appUrl, locale, links }) => {
+            const params = asParams(payload);
+            return {
+                to: params.to,
+                customerName: params.customerName,
+                stripeInvoiceId: params.stripeInvoiceId,
+                stripePaymentIntentId: params.stripePaymentIntentId,
+                amount: params.amount,
+                currency: params.currency,
+                errorMessage: params.errorMessage,
+                invoiceUrl: params.invoiceUrl,
+                invoiceNumber: params.invoiceNumber,
+                updatePaymentUrl: `${appUrl}${links.paymentMethod}`,
+                keepsAccess: params.keepsAccess ?? false,
+                locale,
+            };
+        },
+    },
+    "subscription-status-change": {
+        template: "subscriptionStatusChange",
+        toTemplateData: (payload, { appUrl, locale, links }) => {
+            const params = asParams(payload);
+            return {
+                to: params.to,
+                customerName: params.customerName,
+                subscriptionId: params.subscriptionId,
+                status: params.status,
+                dashboardUrl: `${appUrl}${links.billing}`,
+                locale,
+            };
+        },
+    },
+    "payment-success-customer": {
+        template: "paymentSuccessCustomer",
+        toTemplateData: (payload, { appUrl, locale, links }) => {
+            const params = asParams(payload);
+            return {
+                to: params.to,
+                customerName: params.customerName,
+                amount: params.amount,
+                currency: params.currency?.toUpperCase() || "USD",
+                invoiceUrl: params.invoiceUrl,
+                invoiceNumber: params.invoiceNumber,
+                isOneTimePurchase: params.isOneTimePurchase,
+                billingDashboardUrl: `${appUrl}${links.billing}`,
+                locale,
+            };
+        },
+    },
+    "payment-success-admin": {
+        template: "paymentSuccessAdmin",
+        toTemplateData: (payload, { locale }) => {
+            const params = asParams(payload);
+            return {
+                to: params.to,
+                adminName: params.adminName,
+                companyName: params.companyName,
+                amount: params.amount,
+                currency: params.currency?.toUpperCase() || "USD",
+                isOneTimePurchase: params.isOneTimePurchase,
+                locale,
+            };
+        },
+    },
+    "trial-ending-reminder": {
+        template: "trialEndingReminder",
+        toTemplateData: (payload, { appUrl, locale, links }) => {
+            const params = asParams(payload);
+            return {
+                to: params.to,
+                customerName: params.customerName,
+                trialEndDate: (0, email_helpers_1.formatEmailDate)(params.trialEndDate, locale),
+                upgradeUrl: `${appUrl}${links.subscribe}`,
+                locale,
+            };
+        },
+    },
+    "trial-ended": {
+        template: "trialEndedWithoutPayment",
+        toTemplateData: (payload, { appUrl, locale, links }) => {
+            const params = asParams(payload);
+            return {
+                to: params.to,
+                customerName: params.customerName,
+                companyName: params.companyName,
+                trialEndDate: (0, email_helpers_1.formatEmailDate)(params.trialEndDate, locale),
+                dataRemovalDate: (0, email_helpers_1.formatEmailDate)(params.dataRemovalDate, locale),
+                upgradeUrl: `${appUrl}${links.resubscribe}`,
+                locale,
+            };
+        },
+    },
+    "deletion-warning": {
+        template: "deletionWarning",
+        toTemplateData: (payload, { appUrl, locale, links }) => {
+            const params = asParams(payload);
+            const subject = params.daysRemaining === 1
+                ? `Final Warning: Your ${params.companyName} data will be deleted tomorrow`
+                : `Warning: Your ${params.companyName} data will be deleted in ${params.daysRemaining} days`;
+            return {
+                to: params.to,
+                subject,
+                companyName: params.companyName,
+                daysRemaining: params.daysRemaining,
+                deletionDate: (0, email_helpers_1.formatEmailDate)(params.deletionDate, locale),
+                isTrialExpired: params.isTrialExpired,
+                isSubscriptionCancelled: params.isSubscriptionCancelled,
+                isFinalWarning: params.daysRemaining === 1,
+                resubscribeUrl: `${appUrl}${links.resubscribe}`,
+                locale,
+            };
+        },
+    },
+    "subscription-cancelled": {
+        template: "subscriptionCancelled",
+        toTemplateData: (payload, { appUrl, locale, links }) => {
+            const params = asParams(payload);
+            return {
+                to: params.to,
+                companyName: params.companyName,
+                dataRemovalDate: (0, email_helpers_1.formatEmailDate)(params.dataRemovalDate, locale),
+                resubscribeUrl: `${appUrl}${links.resubscribe}`,
+                locale,
+            };
+        },
+    },
+    "company-deleted": {
+        template: "companyDeleted",
+        toTemplateData: (payload, { locale }) => {
+            const params = asParams(payload);
+            return {
+                to: params.to,
+                companyName: params.companyName,
+                deletionDate: (0, email_helpers_1.formatEmailDate)(params.deletionDate, locale),
+                isTrialExpired: params.reason === "trial_expired",
+                isSubscriptionCancelled: params.reason === "subscription_cancelled",
+                isImmediateDeletion: params.reason === "immediate_deletion",
+                locale,
+            };
+        },
+    },
+    "referral-invite": {
+        template: "referralInvite",
+        toTemplateData: (payload, { locale }) => {
+            const params = asParams(payload);
+            return {
+                to: params.to,
+                referralCode: params.referralCode,
+                companyName: params.companyName,
+                inviterName: params.inviterName,
+                inviterEmail: params.inviterEmail,
+                referralUrl: params.referralUrl,
+                locale,
+            };
+        },
+    },
+    "referral-reward": {
+        template: "referralReward",
+        toTemplateData: (payload, { locale }) => {
+            const params = asParams(payload);
+            return {
+                to: params.to,
+                userName: params.userName,
+                tokensAwarded: params.tokensAwarded,
+                locale,
+            };
+        },
+    },
+    "card-expiring": {
+        template: "cardExpiring",
+        toTemplateData: (payload, { appUrl, locale, links }) => {
+            const params = asParams(payload);
+            return {
+                to: params.to,
+                customerName: params.customerName,
+                renewalDate: (0, email_helpers_1.formatEmailDate)(params.renewalDate, locale),
+                cardBrand: params.cardBrand,
+                cardLast4: params.cardLast4,
+                updatePaymentUrl: `${appUrl}${links.paymentMethod}`,
+                locale,
+            };
+        },
+    },
+};
+//# sourceMappingURL=billing-email.jobs.js.map

package/dist/foundations/billing/processors/billing-email.jobs.js.map

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

package/dist/foundations/billing/processors/billing-email.processor.d.ts

@@ -0,0 +1,33 @@
+import { WorkerHost } from "@nestjs/bullmq";
+import { ConfigService } from "@nestjs/config";
+import { Job } from "bullmq";
+import { EmailService } from "../../../core/email/services/email.service";
+import { AppLoggingService } from "../../../core/logging/services/logging.service";
+import { ResolvedBillingConfig } from "../interfaces/billing.config.interface";
+import { BillingEmailJobData } from "./billing-email.jobs";
+/**
+ * BillingEmailProcessor — the library billing email sender, lifted from only35's
+ * `EmailProcessor`. Consumes `QueueId.EMAIL` and renders the job's template.
+ *
+ * Registered by `BillingModule` on worker instances only, and only when
+ * `billing.emailSender.enabled` is true: apps that consume the email queue with
+ * their own processor keep it off.
+ */
+export declare class BillingEmailProcessor extends WorkerHost {
+    private readonly emailService;
+    private readonly logger;
+    private readonly configService;
+    /**
+     * App base URL for the links embedded in outgoing emails, without a trailing
+     * slash so `${appUrl}${links.billing}` cannot produce a doubled separator.
+     */
+    private readonly appUrl;
+    private readonly jobs;
+    private readonly config;
+    constructor(emailService: EmailService, logger: AppLoggingService, configService: ConfigService, billingConfig?: ResolvedBillingConfig);
+    onActive(job: Job<BillingEmailJobData>): void;
+    onError(job: Job<BillingEmailJobData>): void;
+    onCompleted(job: Job<BillingEmailJobData>): void;
+    process(job: Job<BillingEmailJobData>): Promise<void>;
+}
+//# sourceMappingURL=billing-email.processor.d.ts.map

package/dist/foundations/billing/processors/billing-email.processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-email.processor.d.ts","sourceRoot":"","sources":["../../../../src/foundations/billing/processors/billing-email.processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAE7B,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AACnF,OAAO,EAIL,qBAAqB,EACtB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAA8B,MAAM,sBAAsB,CAAC;AAEvF;;;;;;;GAOG;AACH,qBAIa,qBAAsB,SAAQ,UAAU;IAUjD,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAXhC;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA4C;IACjE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;gBAG5B,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,iBAAiB,EACzB,aAAa,EAAE,aAAa,EACT,aAAa,CAAC,EAAE,qBAAqB;IAS3E,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,mBAAmB,CAAC;IAKtC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,mBAAmB,CAAC;IAKrC,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,mBAAmB,CAAC;IAInC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,mBAAmB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAgB5D"}

package/dist/foundations/billing/processors/billing-email.processor.js

@@ -0,0 +1,95 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BillingEmailProcessor = void 0;
+const bullmq_1 = require("@nestjs/bullmq");
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+const bullmq_2 = require("bullmq");
+const queue_id_1 = require("../../../config/enums/queue.id");
+const email_service_1 = require("../../../core/email/services/email.service");
+const logging_service_1 = require("../../../core/logging/services/logging.service");
+const billing_config_interface_1 = require("../interfaces/billing.config.interface");
+const billing_email_jobs_1 = require("./billing-email.jobs");
+/**
+ * BillingEmailProcessor — the library billing email sender, lifted from only35's
+ * `EmailProcessor`. Consumes `QueueId.EMAIL` and renders the job's template.
+ *
+ * Registered by `BillingModule` on worker instances only, and only when
+ * `billing.emailSender.enabled` is true: apps that consume the email queue with
+ * their own processor keep it off.
+ */
+let BillingEmailProcessor = class BillingEmailProcessor extends bullmq_1.WorkerHost {
+    constructor(emailService, logger, configService, billingConfig) {
+        super();
+        this.emailService = emailService;
+        this.logger = logger;
+        this.configService = configService;
+        this.config = billingConfig ?? billing_config_interface_1.DEFAULT_BILLING_CONFIG;
+        this.appUrl = (this.configService.get("app")?.url ?? "").replace(/\/$/, "");
+        this.jobs = { ...billing_email_jobs_1.LIBRARY_BILLING_EMAIL_JOBS, ...this.config.emailSender.extraJobs };
+    }
+    onActive(job) {
+        this.logger.debug(`Processing email job ${job.data.jobType} (ID: ${job.id})`);
+    }
+    onError(job) {
+        this.logger.error(`Failed to send email ${job.data.jobType} (ID: ${job.id}). Reason: ${job.failedReason}`);
+    }
+    onCompleted(job) {
+        this.logger.debug(`Email ${job.data.jobType} sent successfully (ID: ${job.id})`);
+    }
+    async process(job) {
+        const { jobType, payload } = job.data;
+        const definition = this.jobs[jobType];
+        if (!definition) {
+            this.logger.warn(`Unknown email job type: ${jobType}`);
+            return;
+        }
+        const locale = payload.locale || "en";
+        const data = definition.toTemplateData(payload, { appUrl: this.appUrl, locale, links: this.config.links });
+        await this.emailService.sendEmail(definition.template, { to: payload.to, ...data }, locale);
+        this.logger.log(`Sent ${jobType} email to ${payload.to}`);
+    }
+};
+exports.BillingEmailProcessor = BillingEmailProcessor;
+__decorate([
+    (0, bullmq_1.OnWorkerEvent)("active"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [bullmq_2.Job]),
+    __metadata("design:returntype", void 0)
+], BillingEmailProcessor.prototype, "onActive", null);
+__decorate([
+    (0, bullmq_1.OnWorkerEvent)("failed"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [bullmq_2.Job]),
+    __metadata("design:returntype", void 0)
+], BillingEmailProcessor.prototype, "onError", null);
+__decorate([
+    (0, bullmq_1.OnWorkerEvent)("completed"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [bullmq_2.Job]),
+    __metadata("design:returntype", void 0)
+], BillingEmailProcessor.prototype, "onCompleted", null);
+exports.BillingEmailProcessor = BillingEmailProcessor = __decorate([
+    (0, bullmq_1.Processor)(queue_id_1.QueueId.EMAIL, {
+        concurrency: 5,
+        lockDuration: 30000,
+    }),
+    __param(3, (0, common_1.Optional)()),
+    __param(3, (0, common_1.Inject)(billing_config_interface_1.BILLING_CONFIG)),
+    __metadata("design:paramtypes", [email_service_1.EmailService,
+        logging_service_1.AppLoggingService,
+        config_1.ConfigService, Object])
+], BillingEmailProcessor);
+//# sourceMappingURL=billing-email.processor.js.map

package/dist/foundations/billing/processors/billing-email.processor.js.map

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