@darraghor/nest-backend-libs 5.7.4 → 6.0.0

package/dist/stripe-payments/stripe-payment.config.test.js

@@ -0,0 +1,59 @@
+import { describe, expect, it } from "vitest";
+import { createSecureStripeConfiguration, parseStripeProductCatalog, } from "./stripe-payment.config.js";
+import { SecureStripeProductService } from "./services/secure-stripe-product.service.js";
+describe("secure Stripe payment configuration", () => {
+    it("parses the server-side catalog and normalizes the redirect origin", () => {
+        const result = createSecureStripeConfiguration({
+            accessToken: "sk_test_secret",
+            webhookVerificationKey: "whsec_secret",
+            redirectsBaseUrl: "https://app.example.com/",
+            products: parseStripeProductCatalog(JSON.stringify({
+                starter: {
+                    priceId: "price_starter",
+                    mode: "subscription",
+                    internalSku: "starter",
+                    displayName: "Starter",
+                },
+            })),
+        });
+        expect(result.redirectsBaseUrl).toBe("https://app.example.com");
+        expect(result.products.get("starter")).toEqual({
+            key: "starter",
+            priceId: "price_starter",
+            mode: "subscription",
+            internalSku: "starter",
+            displayName: "Starter",
+        });
+    });
+    it("rejects duplicate price IDs so one price cannot map to two products", () => {
+        expect(() => createSecureStripeConfiguration({
+            accessToken: "sk_test_secret",
+            webhookVerificationKey: "whsec_secret",
+            redirectsBaseUrl: "https://app.example.com",
+            products: parseStripeProductCatalog(JSON.stringify({
+                first: { priceId: "price_same", mode: "payment" },
+                second: { priceId: "price_same", mode: "payment" },
+            })),
+        })).toThrow("Duplicate Stripe price ID");
+    });
+    it("requires a non-empty server-side catalog", () => {
+        expect(() => createSecureStripeConfiguration({
+            accessToken: "sk_test_secret",
+            webhookVerificationKey: "whsec_secret",
+            redirectsBaseUrl: "https://app.example.com",
+            products: [],
+        })).toThrow("at least one product");
+    });
+    it("only builds redirects on the configured origin", () => {
+        const service = new SecureStripeProductService({
+            accessToken: "sk_test_secret",
+            webhookVerificationKey: "whsec_secret",
+            redirectsBaseUrl: "https://app.example.com",
+            products: new Map(),
+        });
+        expect(service.buildRedirectUrl("/dashboard")).toBe("https://app.example.com/dashboard");
+        expect(() => service.buildRedirectUrl("https://evil.example/steal")).toThrow("Redirect path");
+        expect(() => service.buildRedirectUrl("//evil.example/steal")).toThrow("Redirect path");
+    });
+});
+//# sourceMappingURL=stripe-payment.config.test.js.map

package/dist/stripe-payments/stripe-payment.config.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe-payment.config.test.js","sourceRoot":"","sources":["../../src/stripe-payments/stripe-payment.config.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAC,MAAM,QAAQ,CAAC;AAC5C,OAAO,EACH,+BAA+B,EAC/B,yBAAyB,GAC5B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAC,0BAA0B,EAAC,MAAM,6CAA6C,CAAC;AAEvF,QAAQ,CAAC,qCAAqC,EAAE,GAAG,EAAE;IACjD,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QACzE,MAAM,MAAM,GAAG,+BAA+B,CAAC;YAC3C,WAAW,EAAE,gBAAgB;YAC7B,sBAAsB,EAAE,cAAc;YACtC,gBAAgB,EAAE,0BAA0B;YAC5C,QAAQ,EAAE,yBAAyB,CAC/B,IAAI,CAAC,SAAS,CAAC;gBACX,OAAO,EAAE;oBACL,OAAO,EAAE,eAAe;oBACxB,IAAI,EAAE,cAAc;oBACpB,WAAW,EAAE,SAAS;oBACtB,WAAW,EAAE,SAAS;iBACzB;aACJ,CAAC,CACL;SACJ,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QAChE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;YAC3C,GAAG,EAAE,SAAS;YACd,OAAO,EAAE,eAAe;YACxB,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,SAAS;YACtB,WAAW,EAAE,SAAS;SACzB,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC3E,MAAM,CAAC,GAAG,EAAE,CACR,+BAA+B,CAAC;YAC5B,WAAW,EAAE,gBAAgB;YAC7B,sBAAsB,EAAE,cAAc;YACtC,gBAAgB,EAAE,yBAAyB;YAC3C,QAAQ,EAAE,yBAAyB,CAC/B,IAAI,CAAC,SAAS,CAAC;gBACX,KAAK,EAAE,EAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAC;gBAC/C,MAAM,EAAE,EAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAC;aACnD,CAAC,CACL;SACJ,CAAC,CACL,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,GAAG,EAAE,CACR,+BAA+B,CAAC;YAC5B,WAAW,EAAE,gBAAgB;YAC7B,sBAAsB,EAAE,cAAc;YACtC,gBAAgB,EAAE,yBAAyB;YAC3C,QAAQ,EAAE,EAAE;SACf,CAAC,CACL,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACtD,MAAM,OAAO,GAAG,IAAI,0BAA0B,CAAC;YAC3C,WAAW,EAAE,gBAAgB;YAC7B,sBAAsB,EAAE,cAAc;YACtC,gBAAgB,EAAE,yBAAyB;YAC3C,QAAQ,EAAE,IAAI,GAAG,EAAE;SACtB,CAAC,CAAC;QAEH,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAC/C,mCAAmC,CACtC,CAAC;QACF,MAAM,CAAC,GAAG,EAAE,CACR,OAAO,CAAC,gBAAgB,CAAC,4BAA4B,CAAC,CACzD,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QAC3B,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,sBAAsB,CAAC,CAAC,CAAC,OAAO,CAClE,eAAe,CAClB,CAAC;IACN,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/stripe-payments/stripe-payments.extensions.d.ts

@@ -0,0 +1,69 @@
+import type { RequestUser } from "../authorization/models/RequestWithUser.js";
+export declare const STRIPE_PAYMENTS_ACCESS_POLICY: unique symbol;
+export declare const STRIPE_PAYMENTS_TELEMETRY: unique symbol;
+export declare const STRIPE_PAYMENTS_ENTITLEMENT_STORE: unique symbol;
+export interface StripePaymentsAccessContext {
+    organisationUuid: string;
+    user: RequestUser;
+    operation: "checkout" | "customer-portal";
+}
+export interface StripePaymentsAccessPolicy {
+    assertCanManageOrganisation(context: StripePaymentsAccessContext): void | Promise<void>;
+}
+export interface StripePaymentsEntitlement {
+    uuid: string;
+    organisationUuid: string;
+    paymentSystemTransactionId: string;
+    paymentSystemCustomerId: string;
+    paymentSystemMode: string;
+}
+export interface StripePaymentsEntitlementInput {
+    paymentSystemTransactionId: string;
+    paymentSystemProductId: string;
+    paymentSystemCustomerId: string;
+    paymentSystemCustomerEmail: string;
+    paymentSystemMode: "subscription" | "payment";
+    paymentSystemName: "stripe";
+    validUntil: Date;
+    internalSku: string;
+    productDisplayName: string;
+    organisationUuid?: string;
+    stripeEventId: string;
+    stripeEventCreatedAt: Date;
+    stripeStatus: string;
+}
+export type StripePaymentsRevocationInput = Pick<StripePaymentsEntitlementInput, "stripeEventId" | "stripeEventCreatedAt" | "stripeStatus">;
+export interface StripePaymentsEntitlementStore {
+    findByUuid(uuid: string): Promise<StripePaymentsEntitlement>;
+    findByTransactionId(paymentSystemTransactionId: string): Promise<StripePaymentsEntitlement | null>;
+    save(input: StripePaymentsEntitlementInput): Promise<void>;
+    revokeCustomerPayments(customerId: string, input: StripePaymentsRevocationInput): Promise<void>;
+    revokePayment(paymentSystemTransactionId: string, input: StripePaymentsRevocationInput): Promise<boolean>;
+}
+export type StripePaymentsTelemetryEvent = {
+    name: "checkout.created";
+    attemptId: number;
+    organisationUuid: string;
+    productKey: string;
+    stripeSessionId: string;
+} | {
+    name: "checkout.failed";
+    attemptId: number;
+    organisationUuid: string;
+    productKey: string;
+    error: string;
+} | {
+    name: "webhook.received" | "webhook.processed" | "webhook.failed";
+    stripeEventId: string;
+    eventType: string;
+    error?: string;
+};
+export interface StripePaymentsTelemetry {
+    record(event: StripePaymentsTelemetryEvent): void | Promise<void>;
+}
+export declare class DefaultStripePaymentsAccessPolicy implements StripePaymentsAccessPolicy {
+    assertCanManageOrganisation(context: StripePaymentsAccessContext): void;
+}
+export declare class NoopStripePaymentsTelemetry implements StripePaymentsTelemetry {
+    record(): void;
+}

package/dist/stripe-payments/stripe-payments.extensions.js

@@ -0,0 +1,30 @@
+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;
+};
+import { ForbiddenException, Injectable } from "@nestjs/common";
+export const STRIPE_PAYMENTS_ACCESS_POLICY = Symbol("STRIPE_PAYMENTS_ACCESS_POLICY");
+export const STRIPE_PAYMENTS_TELEMETRY = Symbol("STRIPE_PAYMENTS_TELEMETRY");
+export const STRIPE_PAYMENTS_ENTITLEMENT_STORE = Symbol("STRIPE_PAYMENTS_ENTITLEMENT_STORE");
+let DefaultStripePaymentsAccessPolicy = class DefaultStripePaymentsAccessPolicy {
+    assertCanManageOrganisation(context) {
+        const isOwner = context.user.memberships
+            ?.filter((membership) => membership.roles?.some((role) => role.name === "owner"))
+            .some((membership) => membership.organisation.uuid === context.organisationUuid);
+        if (!isOwner) {
+            throw new ForbiddenException("You are not the owner of this organisation");
+        }
+    }
+};
+DefaultStripePaymentsAccessPolicy = __decorate([
+    Injectable()
+], DefaultStripePaymentsAccessPolicy);
+export { DefaultStripePaymentsAccessPolicy };
+export class NoopStripePaymentsTelemetry {
+    record() {
+        return;
+    }
+}
+//# sourceMappingURL=stripe-payments.extensions.js.map

package/dist/stripe-payments/stripe-payments.extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe-payments.extensions.js","sourceRoot":"","sources":["../../src/stripe-payments/stripe-payments.extensions.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAC,kBAAkB,EAAE,UAAU,EAAC,MAAM,gBAAgB,CAAC;AAG9D,MAAM,CAAC,MAAM,6BAA6B,GAAG,MAAM,CAC/C,+BAA+B,CAClC,CAAC;AACF,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC,2BAA2B,CAAC,CAAC;AAC7E,MAAM,CAAC,MAAM,iCAAiC,GAAG,MAAM,CACnD,mCAAmC,CACtC,CAAC;AAsFK,IAAM,iCAAiC,GAAvC,MAAM,iCAAiC;IAC1C,2BAA2B,CAAC,OAAoC;QAC5D,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW;YACpC,EAAE,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CACpB,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,CAC1D;aACA,IAAI,CACD,CAAC,UAAU,EAAE,EAAE,CACX,UAAU,CAAC,YAAY,CAAC,IAAI,KAAK,OAAO,CAAC,gBAAgB,CAChE,CAAC;QACN,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,MAAM,IAAI,kBAAkB,CACxB,4CAA4C,CAC/C,CAAC;QACN,CAAC;IACL,CAAC;CACJ,CAAA;AAhBY,iCAAiC;IAD7C,UAAU,EAAE;GACA,iCAAiC,CAgB7C;;AAED,MAAM,OAAO,2BAA2B;IACpC,MAAM;QACF,OAAO;IACX,CAAC;CACJ"}

package/dist/stripe-payments/stripe-payments.module.d.ts

@@ -0,0 +1,12 @@
+import { DynamicModule } from "@nestjs/common";
+import { StripePaymentsModuleAsyncOptions } from "./stripe-payments.options.js";
+/**
+ * Opinionated Stripe payments for organisation-based applications.
+ *
+ * The module owns the Stripe boundary, product catalog, idempotency records,
+ * durable webhook inbox, retries, replay, and subscription state updates.
+ * Applications provide only their server-side Stripe configuration and catalog.
+ */
+export declare class StripePaymentsModule {
+    static forRootAsync(options: StripePaymentsModuleAsyncOptions): DynamicModule;
+}

package/dist/stripe-payments/stripe-payments.module.js

@@ -0,0 +1,118 @@
+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 StripePaymentsModule_1;
+import { BullModule } from "@nestjs/bullmq";
+import { Module } from "@nestjs/common";
+import { TypeOrmModule } from "@nestjs/typeorm";
+import { Organisation } from "../organisation/entities/organisation.entity.js";
+import { OrganisationSubscriptionsModule } from "../organisation-subscriptions/organisation-subscriptions.module.js";
+import { OrganisationSubscriptionRecord } from "../organisation-subscriptions/entities/organisation-subscription.entity.js";
+import { SubActivationQueueModule } from "../organisation-subscriptions/sub-activation-queue.module.js";
+import { PaymentSessionModule } from "../payment-sessions/payment-session.module.js";
+import { StripeCheckoutAttempt } from "./entities/stripe-checkout-attempt.entity.js";
+import { StripeCheckoutEvent } from "./entities/stripe-payment-event.entity.js";
+import { StripePaymentState } from "./entities/stripe-payment-state.entity.js";
+import { SecureStripeCheckoutController } from "./controllers/secure-stripe-checkout.controller.js";
+import { SecureStripeEventsController } from "./controllers/secure-stripe-events.controller.js";
+import { SecureStripeWebhookController } from "./controllers/secure-stripe-webhook.controller.js";
+import { secureStripeConfigurationProvider } from "./stripe-payment.config.js";
+import { STRIPE_PAYMENTS_OPTIONS, } from "./stripe-payments.options.js";
+import { secureStripeClientProvider } from "./services/secure-stripe-client.provider.js";
+import { SecureStripeCheckoutService } from "./services/secure-stripe-checkout.service.js";
+import { SecureStripeProductService } from "./services/secure-stripe-product.service.js";
+import { SecureStripeWebhookService } from "./services/secure-stripe-webhook.service.js";
+import { SecureSubscriptionService } from "./services/secure-subscription.service.js";
+import { StripePaymentEventProcessor } from "./services/stripe-payment-event.processor.js";
+import { StripePaymentEventService } from "./services/stripe-payment-event.service.js";
+import { StripePaymentFulfillmentService } from "./services/stripe-payment-fulfillment.service.js";
+import { DefaultStripePaymentsAccessPolicy, NoopStripePaymentsTelemetry, STRIPE_PAYMENTS_ACCESS_POLICY, STRIPE_PAYMENTS_ENTITLEMENT_STORE, STRIPE_PAYMENTS_TELEMETRY, } from "./stripe-payments.extensions.js";
+import { StripePaymentsTelemetryService } from "./services/stripe-payments-telemetry.service.js";
+import { StripePaymentsOperationsService } from "./services/stripe-payments-operations.service.js";
+import { DefaultStripePaymentsEntitlementStore } from "./services/default-stripe-payments-entitlement-store.js";
+/**
+ * Opinionated Stripe payments for organisation-based applications.
+ *
+ * The module owns the Stripe boundary, product catalog, idempotency records,
+ * durable webhook inbox, retries, replay, and subscription state updates.
+ * Applications provide only their server-side Stripe configuration and catalog.
+ */
+let StripePaymentsModule = StripePaymentsModule_1 = class StripePaymentsModule {
+    static forRootAsync(options) {
+        return {
+            module: StripePaymentsModule_1,
+            global: options.isGlobal ?? false,
+            imports: [
+                ...(options.imports ?? []),
+                BullModule.registerQueue({ name: "stripe-events" }),
+                OrganisationSubscriptionsModule,
+                SubActivationQueueModule,
+                PaymentSessionModule,
+                TypeOrmModule.forFeature([
+                    Organisation,
+                    OrganisationSubscriptionRecord,
+                    StripeCheckoutAttempt,
+                    StripeCheckoutEvent,
+                    StripePaymentState,
+                ]),
+            ],
+            providers: [
+                {
+                    provide: STRIPE_PAYMENTS_OPTIONS,
+                    useFactory: options.useFactory,
+                    inject: options.inject ?? [],
+                },
+                secureStripeConfigurationProvider,
+                secureStripeClientProvider,
+                SecureStripeProductService,
+                SecureStripeCheckoutService,
+                SecureSubscriptionService,
+                DefaultStripePaymentsEntitlementStore,
+                StripePaymentEventService,
+                SecureStripeWebhookService,
+                StripePaymentFulfillmentService,
+                StripePaymentEventProcessor,
+                StripePaymentsTelemetryService,
+                StripePaymentsOperationsService,
+                {
+                    provide: STRIPE_PAYMENTS_ACCESS_POLICY,
+                    useClass: DefaultStripePaymentsAccessPolicy,
+                },
+                {
+                    provide: STRIPE_PAYMENTS_TELEMETRY,
+                    useClass: NoopStripePaymentsTelemetry,
+                },
+                {
+                    provide: STRIPE_PAYMENTS_ENTITLEMENT_STORE,
+                    useExisting: DefaultStripePaymentsEntitlementStore,
+                },
+                ...(options.providers ?? []),
+            ],
+            controllers: [
+                SecureStripeCheckoutController,
+                SecureStripeEventsController,
+                SecureStripeWebhookController,
+            ],
+            exports: [
+                BullModule,
+                SecureStripeProductService,
+                SecureStripeCheckoutService,
+                SecureSubscriptionService,
+                StripePaymentEventService,
+                StripePaymentsOperationsService,
+                StripePaymentsTelemetryService,
+                STRIPE_PAYMENTS_ACCESS_POLICY,
+                STRIPE_PAYMENTS_ENTITLEMENT_STORE,
+                STRIPE_PAYMENTS_TELEMETRY,
+            ],
+        };
+    }
+};
+StripePaymentsModule = StripePaymentsModule_1 = __decorate([
+    Module({})
+], StripePaymentsModule);
+export { StripePaymentsModule };
+//# sourceMappingURL=stripe-payments.module.js.map

package/dist/stripe-payments/stripe-payments.module.js.map

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

package/dist/stripe-payments/stripe-payments.options.d.ts

@@ -0,0 +1,21 @@
+import type { ModuleMetadata } from "@nestjs/common";
+export declare const STRIPE_PAYMENTS_OPTIONS = "StripePaymentsOptions";
+export type StripePaymentsMode = "subscription" | "payment";
+export interface StripePaymentsProduct {
+    key: string;
+    priceId: string;
+    mode: StripePaymentsMode;
+    internalSku?: string;
+    displayName?: string;
+}
+export interface StripePaymentsModuleOptions {
+    accessToken: string;
+    webhookVerificationKey: string;
+    redirectsBaseUrl: string;
+    products: readonly StripePaymentsProduct[];
+}
+export interface StripePaymentsModuleAsyncOptions extends Pick<ModuleMetadata, "imports" | "providers"> {
+    useFactory: (...arguments_: any[]) => Promise<StripePaymentsModuleOptions> | StripePaymentsModuleOptions;
+    inject?: any[];
+    isGlobal?: boolean;
+}

package/dist/stripe-payments/stripe-payments.options.js

@@ -0,0 +1,2 @@
+export const STRIPE_PAYMENTS_OPTIONS = "StripePaymentsOptions";
+//# sourceMappingURL=stripe-payments.options.js.map

package/dist/stripe-payments/stripe-payments.options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe-payments.options.js","sourceRoot":"","sources":["../../src/stripe-payments/stripe-payments.options.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,uBAAuB,GAAG,uBAAuB,CAAC"}

package/dist/typeorm/entities.d.ts

@@ -0,0 +1,15 @@
+import { Invitation } from "../invitations/entities/invitation.entity.js";
+import { OrganisationMembership } from "../organisation-memberships/entities/organisation-membership.entity.js";
+import { OrganisationSubscriptionRecord } from "../organisation-subscriptions/entities/organisation-subscription.entity.js";
+import { MembershipRole } from "../organisation/entities/member-role.entity.js";
+import { Organisation } from "../organisation/entities/organisation.entity.js";
+import { PaymentSessionReference } from "../payment-sessions/payment-session.entity.js";
+import { Email } from "../smtp-email-client/email.entity.js";
+import { StripeCheckoutEvent as LegacyStripeCheckoutEvent } from "../stripe-client/entities/stripe-checkout-event.entity.js";
+import { StripeCheckoutAttempt } from "../stripe-payments/entities/stripe-checkout-attempt.entity.js";
+import { StripeCheckoutEvent } from "../stripe-payments/entities/stripe-payment-event.entity.js";
+import { StripePaymentState } from "../stripe-payments/entities/stripe-payment-state.entity.js";
+import { UserApiKey } from "../user-api-key/userApiKey.entity.js";
+import { User } from "../user/entities/user.entity.js";
+export declare const STRIPE_PAYMENTS_ENTITIES: readonly [typeof StripeCheckoutAttempt, typeof StripeCheckoutEvent, typeof StripePaymentState];
+export declare const NEST_BACKEND_LIB_ENTITIES: readonly [typeof Invitation, typeof OrganisationMembership, typeof OrganisationSubscriptionRecord, typeof MembershipRole, typeof Organisation, typeof PaymentSessionReference, typeof Email, typeof LegacyStripeCheckoutEvent, typeof StripeCheckoutAttempt, typeof StripeCheckoutEvent, typeof StripePaymentState, typeof UserApiKey, typeof User];

package/dist/typeorm/entities.js

@@ -0,0 +1,32 @@
+import { Invitation } from "../invitations/entities/invitation.entity.js";
+import { OrganisationMembership } from "../organisation-memberships/entities/organisation-membership.entity.js";
+import { OrganisationSubscriptionRecord } from "../organisation-subscriptions/entities/organisation-subscription.entity.js";
+import { MembershipRole } from "../organisation/entities/member-role.entity.js";
+import { Organisation } from "../organisation/entities/organisation.entity.js";
+import { PaymentSessionReference } from "../payment-sessions/payment-session.entity.js";
+import { Email } from "../smtp-email-client/email.entity.js";
+import { StripeCheckoutEvent as LegacyStripeCheckoutEvent } from "../stripe-client/entities/stripe-checkout-event.entity.js";
+import { StripeCheckoutAttempt } from "../stripe-payments/entities/stripe-checkout-attempt.entity.js";
+import { StripeCheckoutEvent } from "../stripe-payments/entities/stripe-payment-event.entity.js";
+import { StripePaymentState } from "../stripe-payments/entities/stripe-payment-state.entity.js";
+import { UserApiKey } from "../user-api-key/userApiKey.entity.js";
+import { User } from "../user/entities/user.entity.js";
+export const STRIPE_PAYMENTS_ENTITIES = [
+    StripeCheckoutAttempt,
+    StripeCheckoutEvent,
+    StripePaymentState,
+];
+export const NEST_BACKEND_LIB_ENTITIES = [
+    Invitation,
+    OrganisationMembership,
+    OrganisationSubscriptionRecord,
+    MembershipRole,
+    Organisation,
+    PaymentSessionReference,
+    Email,
+    LegacyStripeCheckoutEvent,
+    ...STRIPE_PAYMENTS_ENTITIES,
+    UserApiKey,
+    User,
+];
+//# sourceMappingURL=entities.js.map

package/dist/typeorm/entities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.js","sourceRoot":"","sources":["../../src/typeorm/entities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,8CAA8C,CAAC;AACxE,OAAO,EAAC,sBAAsB,EAAC,MAAM,wEAAwE,CAAC;AAC9G,OAAO,EAAC,8BAA8B,EAAC,MAAM,4EAA4E,CAAC;AAC1H,OAAO,EAAC,cAAc,EAAC,MAAM,gDAAgD,CAAC;AAC9E,OAAO,EAAC,YAAY,EAAC,MAAM,iDAAiD,CAAC;AAC7E,OAAO,EAAC,uBAAuB,EAAC,MAAM,+CAA+C,CAAC;AACtF,OAAO,EAAC,KAAK,EAAC,MAAM,sCAAsC,CAAC;AAC3D,OAAO,EAAC,mBAAmB,IAAI,yBAAyB,EAAC,MAAM,2DAA2D,CAAC;AAC3H,OAAO,EAAC,qBAAqB,EAAC,MAAM,+DAA+D,CAAC;AACpG,OAAO,EAAC,mBAAmB,EAAC,MAAM,4DAA4D,CAAC;AAC/F,OAAO,EAAC,kBAAkB,EAAC,MAAM,4DAA4D,CAAC;AAC9F,OAAO,EAAC,UAAU,EAAC,MAAM,sCAAsC,CAAC;AAChE,OAAO,EAAC,IAAI,EAAC,MAAM,iCAAiC,CAAC;AAErD,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACpC,qBAAqB;IACrB,mBAAmB;IACnB,kBAAkB;CACZ,CAAC;AAEX,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACrC,UAAU;IACV,sBAAsB;IACtB,8BAA8B;IAC9B,cAAc;IACd,YAAY;IACZ,uBAAuB;IACvB,KAAK;IACL,yBAAyB;IACzB,GAAG,wBAAwB;IAC3B,UAAU;IACV,IAAI;CACE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@darraghor/nest-backend-libs",
-    "version": "5.7.4",
+    "version": "6.0.0",
     "license": "SEE LICENSE IN LICENSE.md",
     "description": "Some helpers for personal projects in nestjs",
     "homepage": "https://github.com/darraghoriordan/nest-backend-libs",
@@ -28,6 +28,46 @@
         ".": {
             "types": "./dist/index.d.ts",
             "import": "./dist/index.js"
+        },
+        "./authorization": {
+            "types": "./dist/exports/authorization.d.ts",
+            "import": "./dist/exports/authorization.js"
+        },
+        "./core": {
+            "types": "./dist/exports/core.d.ts",
+            "import": "./dist/exports/core.js"
+        },
+        "./database": {
+            "types": "./dist/exports/database.d.ts",
+            "import": "./dist/exports/database.js"
+        },
+        "./email": {
+            "types": "./dist/exports/email.d.ts",
+            "import": "./dist/exports/email.js"
+        },
+        "./invitations": {
+            "types": "./dist/exports/invitations.d.ts",
+            "import": "./dist/exports/invitations.js"
+        },
+        "./organisations": {
+            "types": "./dist/exports/organisations.d.ts",
+            "import": "./dist/exports/organisations.js"
+        },
+        "./stripe": {
+            "types": "./dist/exports/stripe.d.ts",
+            "import": "./dist/exports/stripe.js"
+        },
+        "./stripe-legacy": {
+            "types": "./dist/exports/stripe-legacy.d.ts",
+            "import": "./dist/exports/stripe-legacy.js"
+        },
+        "./twitter": {
+            "types": "./dist/exports/twitter.d.ts",
+            "import": "./dist/exports/twitter.js"
+        },
+        "./users": {
+            "types": "./dist/exports/users.d.ts",
+            "import": "./dist/exports/users.js"
         }
     },
     "keywords": [
@@ -37,6 +77,11 @@
         "access": "public",
         "provenance": true
     },
+    "pnpm": {
+        "overrides": {
+            "conventional-changelog-conventionalcommits": "7.0.2"
+        }
+    },
     "bin": {
         "miller": "dist/cli/cli.js",
         "generate-client": "dist/open-api-generation/generate.sh"
@@ -77,30 +122,32 @@
     "dependencies": {
         "@keyv/redis": "5.1.6",
         "@nestjs/axios": "4.0.1",
-        "@nestjs/cache-manager": "3.1.2",
-        "@nestjs/common": "11.1.21",
+        "@nestjs/bullmq": "11.0.4",
+        "@nestjs/cache-manager": "3.1.3",
+        "@nestjs/common": "11.1.28",
         "@nestjs/config": "4.0.4",
-        "@nestjs/core": "11.1.21",
-        "@nestjs/microservices": "11.1.21",
+        "@nestjs/core": "11.1.28",
+        "@nestjs/microservices": "11.1.28",
         "@nestjs/passport": "11.0.5",
-        "@nestjs/platform-express": "11.1.21",
-        "@nestjs/swagger": "11.4.3",
+        "@nestjs/platform-express": "11.1.28",
+        "@nestjs/swagger": "11.4.6",
         "@nestjs/terminus": "11.1.1",
-        "@nestjs/typeorm": "11.0.1",
+        "@nestjs/typeorm": "11.0.3",
         "add": "2.0.6",
-        "auth0": "5.10.0",
-        "axios": "1.16.1",
-        "cache-manager": "7.2.8",
+        "auth0": "6.0.0",
+        "axios": "1.18.1",
+        "bullmq": "5.80.8",
+        "cache-manager": "7.2.9",
         "chalk": "5.6.2",
         "class-transformer": "0.5.1",
-        "class-validator": "0.14.3",
-        "date-fns": "4.2.1",
+        "class-validator": "0.15.1",
+        "date-fns": "4.4.0",
         "dotenv": "17.4.2",
-        "helmet": "8.1.0",
-        "jwks-rsa": "4.0.1",
+        "helmet": "8.3.0",
+        "jwks-rsa": "4.1.0",
         "nanoid": "6.0.0",
         "nestjs-pino": "4.6.1",
-        "nodemailer": "8.0.7",
+        "nodemailer": "9.0.3",
         "passport": "0.7.0",
         "passport-headerapikey": "1.2.2",
         "passport-jwt": "4.0.1",
@@ -110,47 +157,47 @@
         "reflect-metadata": "0.2.2",
         "rimraf": "6.1.3",
         "rxjs": "7.8.2",
-        "stripe": "22.0.2",
+        "stripe": "22.3.2",
         "swagger-ui-express": "5.0.1",
         "twitter-api-v2": "1.29.0",
-        "typeorm": "0.3.28"
+        "typeorm": "0.3.27"
     },
     "devDependencies": {
-        "@commitlint/cli": "21.0.1",
-        "@commitlint/config-conventional": "21.0.1",
-        "@darraghor/eslint-plugin-nestjs-typed": "7.1.33",
+        "@commitlint/cli": "21.2.1",
+        "@commitlint/config-conventional": "21.2.0",
+        "@darraghor/eslint-plugin-nestjs-typed": "7.2.5",
         "@eslint/js": "10.0.1",
-        "@nestjs/cli": "11.0.21",
+        "@nestjs/cli": "11.0.24",
         "@nestjs/schematics": "^11.1.0",
-        "@nestjs/testing": "11.1.21",
+        "@nestjs/testing": "11.1.28",
         "@semantic-release/changelog": "6.0.3",
         "@semantic-release/exec": "7.1.0",
         "@types/auth0": "3.3.11",
         "@types/express": "5.0.6",
-        "@types/node": "25.9.0",
-        "@types/nodemailer": "8.0.0",
+        "@types/node": "26.1.1",
+        "@types/nodemailer": "8.0.1",
         "@types/passport-jwt": "4.0.1",
-        "@types/supertest": "7.2.0",
+        "@types/supertest": "7.2.1",
         "@types/yargs": "17.0.35",
-        "@typescript-eslint/eslint-plugin": "8.59.3",
-        "@typescript-eslint/parser": "8.59.3",
+        "@typescript-eslint/eslint-plugin": "8.64.0",
+        "@typescript-eslint/parser": "8.64.0",
         "copyfiles": "2.4.1",
         "eslint": "10.7.0",
         "eslint-config-prettier": "10.1.8",
-        "eslint-plugin-sonarjs": "4.0.3",
+        "eslint-plugin-sonarjs": "4.2.0",
         "eslint-plugin-unicorn": "72.0.0",
-        "globals": "17.6.0",
+        "globals": "17.7.0",
         "husky": "9.1.7",
-        "knip": "6.14.1",
-        "lint-staged": "17.0.5",
-        "prettier": "3.8.3",
-        "semantic-release": "25.0.3",
-        "ts-loader": "9.5.7",
+        "knip": "6.27.0",
+        "lint-staged": "17.0.8",
+        "prettier": "3.9.5",
+        "semantic-release": "25.0.8",
+        "ts-loader": "9.6.2",
         "ts-node": "10.9.2",
         "tsconfig-paths": "4.2.0",
-        "typescript": "6.0.3",
-        "typescript-eslint": "8.59.3",
-        "vitest": "4.1.6",
+        "typescript": "5.9.3",
+        "typescript-eslint": "8.64.0",
+        "vitest": "4.1.10",
         "yargs": "18.0.0"
     },
     "lint-staged": {