@carlonicora/nestjs-neo4jsonapi 6.8.0 → 7.0.0

package/dist/foundations/stripe-coupon/services/stripe-coupon-api.service.js.map

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

package/dist/foundations/stripe-coupon/services/stripe-coupon-code-checkout.service.d.ts

@@ -0,0 +1,81 @@
+import { ClsService } from "nestjs-cls";
+import { JsonApiListDocument } from "../../../core/jsonapi/interfaces/jsonapi.document.interface";
+import { JsonApiService } from "../../../core/jsonapi/services/jsonapi.service";
+import { AbstractService } from "../../../core/neo4j/abstracts/abstract.service";
+import { StripeCustomerRepository } from "../../stripe-customer/repositories/stripe-customer.repository";
+import { StripePriceRepository } from "../../stripe-price/repositories/stripe-price.repository";
+import { StripeSubscriptionRepository } from "../../stripe-subscription/repositories/stripe-subscription.repository";
+import { StripeCouponCode, StripeCouponCodeDescriptor } from "../entities/stripe-coupon-code";
+import { StripeCouponCodeRepository } from "../repositories/stripe-coupon-code.repository";
+import { StripeCouponRepository } from "../repositories/stripe-coupon.repository";
+import { StripeCouponApiService } from "./stripe-coupon-api.service";
+/**
+ * Checkout-side reads and writes on stored coupon codes: which code applies itself at a
+ * GM's first payment, whether Stripe has run out of places, and keeping our counts current.
+ */
+export declare class StripeCouponCodeCheckoutService extends AbstractService<StripeCouponCode, typeof StripeCouponCodeDescriptor.relationships> {
+    private readonly stripeCouponCodeRepository;
+    private readonly stripeCouponRepository;
+    private readonly stripeCouponApiService;
+    private readonly stripePriceRepository;
+    private readonly stripeCustomerRepository;
+    private readonly stripeSubscriptionRepository;
+    protected readonly descriptor: import("../../..").EntityDescriptor<StripeCouponCode, {
+        coupon: {
+            model: import("../../..").DataMeta;
+            direction: "in";
+            relationship: string;
+            cardinality: "one";
+            required: true;
+            dtoKey: string;
+        };
+    }>;
+    private readonly logger;
+    constructor(jsonApiService: JsonApiService, stripeCouponCodeRepository: StripeCouponCodeRepository, clsService: ClsService, stripeCouponRepository: StripeCouponRepository, stripeCouponApiService: StripeCouponApiService, stripePriceRepository: StripePriceRepository, stripeCustomerRepository: StripeCustomerRepository, stripeSubscriptionRepository: StripeSubscriptionRepository);
+    /**
+     * The automatic code, when it applies to this company paying this price for the first time.
+     * Returns null whenever any rule fails: the GM then pays the normal price, with no error.
+     */
+    findAutomaticForPrice(params: {
+        companyId: string;
+        priceId: string;
+    }): Promise<StripeCouponCode | null>;
+    /**
+     * Checks a promotion code the browser sent at checkout against our automatic code.
+     * - "not_automatic": not one of our automatic codes (typed or unknown); pass it to Stripe as is.
+     * - "eligible": it is the automatic code and it applies to this first payment right now.
+     * - "sold_out": it is the automatic code, it does not apply, and it has no places left.
+     * - "unavailable": it is the automatic code and it does not apply for any other reason.
+     * Uses the same rules as findAutomaticForPrice, so the review and the payment agree.
+     */
+    checkAutomaticForPrice(params: {
+        companyId: string;
+        priceId: string;
+        stripePromotionCodeId: string;
+        firstPayment: boolean;
+    }): Promise<"eligible" | "sold_out" | "unavailable" | "not_automatic">;
+    /**
+     * The automatic code for a price as a JSON:API list of 0 or 1 code, coupon included.
+     */
+    findAutomaticForPriceDocument(params: {
+        companyId: string;
+        priceId: string;
+        query: any;
+    }): Promise<JsonApiListDocument>;
+    /**
+     * Reads the promotion code and its coupon live from Stripe and tells whether either has run out.
+     */
+    isExhausted(stripePromotionCodeId: string): Promise<boolean>;
+    /**
+     * Re-reads a promotion code and its coupon from Stripe and writes the counts to our nodes.
+     * A no-op when the code is not one of ours; logs and never throws.
+     */
+    refreshCountsByStripePromotionCodeId(stripePromotionCodeId: string): Promise<void>;
+    /**
+     * No places left: our copy says 0, or Stripe says so live. A failed live read counts as "has places".
+     */
+    private hasNoPlacesLeft;
+    private limitReached;
+    private resolveCoupon;
+}
+//# sourceMappingURL=stripe-coupon-code-checkout.service.d.ts.map

package/dist/foundations/stripe-coupon/services/stripe-coupon-code-checkout.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe-coupon-code-checkout.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/stripe-coupon/services/stripe-coupon-code-checkout.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AAElG,OAAO,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AACjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,+DAA+D,CAAC;AACzG,OAAO,EAAE,qBAAqB,EAAE,MAAM,yDAAyD,CAAC;AAChG,OAAO,EAAE,4BAA4B,EAAE,MAAM,uEAAuE,CAAC;AACrH,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAC9F,OAAO,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC;AAC3F,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAElF,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE;;;GAGG;AACH,qBACa,+BAAgC,SAAQ,eAAe,CAClE,gBAAgB,EAChB,OAAO,0BAA0B,CAAC,aAAa,CAChD;IAMG,OAAO,CAAC,QAAQ,CAAC,0BAA0B;IAE3C,OAAO,CAAC,QAAQ,CAAC,sBAAsB;IACvC,OAAO,CAAC,QAAQ,CAAC,sBAAsB;IACvC,OAAO,CAAC,QAAQ,CAAC,qBAAqB;IACtC,OAAO,CAAC,QAAQ,CAAC,wBAAwB;IACzC,OAAO,CAAC,QAAQ,CAAC,4BAA4B;IAX/C,SAAS,CAAC,QAAQ,CAAC,UAAU;;;;;;;;;OAA8B;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4D;gBAGjF,cAAc,EAAE,cAAc,EACb,0BAA0B,EAAE,0BAA0B,EACvE,UAAU,EAAE,UAAU,EACL,sBAAsB,EAAE,sBAAsB,EAC9C,sBAAsB,EAAE,sBAAsB,EAC9C,qBAAqB,EAAE,qBAAqB,EAC5C,wBAAwB,EAAE,wBAAwB,EAClD,4BAA4B,EAAE,4BAA4B;IAK7E;;;OAGG;IACG,qBAAqB,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAmD7G;;;;;;;OAOG;IACG,sBAAsB,CAAC,MAAM,EAAE;QACnC,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,qBAAqB,EAAE,MAAM,CAAC;QAC9B,YAAY,EAAE,OAAO,CAAC;KACvB,GAAG,OAAO,CAAC,UAAU,GAAG,UAAU,GAAG,aAAa,GAAG,eAAe,CAAC;IAetE;;OAEG;IACG,6BAA6B,CAAC,MAAM,EAAE;QAC1C,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,GAAG,CAAC;KACZ,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAOhC;;OAEG;IACG,WAAW,CAAC,qBAAqB,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAalE;;;OAGG;IACG,oCAAoC,CAAC,qBAAqB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BxF;;OAEG;YACW,eAAe;IAW7B,OAAO,CAAC,YAAY;YAIN,aAAa;CAM5B"}

package/dist/foundations/stripe-coupon/services/stripe-coupon-code-checkout.service.js

@@ -0,0 +1,206 @@
+"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 StripeCouponCodeCheckoutService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StripeCouponCodeCheckoutService = void 0;
+const common_1 = require("@nestjs/common");
+const nestjs_cls_1 = require("nestjs-cls");
+const jsonapi_paginator_1 = require("../../../core/jsonapi/serialisers/jsonapi.paginator");
+const jsonapi_service_1 = require("../../../core/jsonapi/services/jsonapi.service");
+const abstract_service_1 = require("../../../core/neo4j/abstracts/abstract.service");
+const stripe_customer_repository_1 = require("../../stripe-customer/repositories/stripe-customer.repository");
+const stripe_price_repository_1 = require("../../stripe-price/repositories/stripe-price.repository");
+const stripe_subscription_repository_1 = require("../../stripe-subscription/repositories/stripe-subscription.repository");
+const stripe_coupon_code_1 = require("../entities/stripe-coupon-code");
+const stripe_coupon_code_repository_1 = require("../repositories/stripe-coupon-code.repository");
+const stripe_coupon_repository_1 = require("../repositories/stripe-coupon.repository");
+const places_left_1 = require("../utils/places-left");
+const stripe_coupon_api_service_1 = require("./stripe-coupon-api.service");
+/**
+ * Checkout-side reads and writes on stored coupon codes: which code applies itself at a
+ * GM's first payment, whether Stripe has run out of places, and keeping our counts current.
+ */
+let StripeCouponCodeCheckoutService = StripeCouponCodeCheckoutService_1 = class StripeCouponCodeCheckoutService extends abstract_service_1.AbstractService {
+    constructor(jsonApiService, stripeCouponCodeRepository, clsService, stripeCouponRepository, stripeCouponApiService, stripePriceRepository, stripeCustomerRepository, stripeSubscriptionRepository) {
+        super(jsonApiService, stripeCouponCodeRepository, clsService, stripe_coupon_code_1.StripeCouponCodeDescriptor.model);
+        this.stripeCouponCodeRepository = stripeCouponCodeRepository;
+        this.stripeCouponRepository = stripeCouponRepository;
+        this.stripeCouponApiService = stripeCouponApiService;
+        this.stripePriceRepository = stripePriceRepository;
+        this.stripeCustomerRepository = stripeCustomerRepository;
+        this.stripeSubscriptionRepository = stripeSubscriptionRepository;
+        this.descriptor = stripe_coupon_code_1.StripeCouponCodeDescriptor;
+        this.logger = new common_1.Logger(StripeCouponCodeCheckoutService_1.name);
+    }
+    /**
+     * The automatic code, when it applies to this company paying this price for the first time.
+     * Returns null whenever any rule fails: the GM then pays the normal price, with no error.
+     */
+    async findAutomaticForPrice(params) {
+        const code = await this.stripeCouponCodeRepository.findAutomatic();
+        if (!code || !code.active || !code.automatic)
+            return null;
+        const coupon = code.coupon;
+        if (!coupon || !coupon.valid)
+            return null;
+        const now = new Date();
+        if (coupon.redeemBy && new Date(coupon.redeemBy).getTime() <= now.getTime())
+            return null;
+        if (code.expiresAt && new Date(code.expiresAt).getTime() <= now.getTime())
+            return null;
+        // Stripe treats a trial's €0 invoice as a past transaction, so a trial GM would be refused.
+        if (code.firstTimeTransaction)
+            return null;
+        const left = (0, places_left_1.placesLeft)(code, coupon);
+        if (left !== null && left <= 0)
+            return null;
+        const price = await this.stripePriceRepository.findById({ id: params.priceId });
+        if (!price || price.priceType !== "recurring" || price.isTrial)
+            return null;
+        if (coupon.stripeProductIds?.length) {
+            const stripeProductId = price.stripeProduct?.stripeProductId;
+            if (!stripeProductId || !coupon.stripeProductIds.includes(stripeProductId))
+                return null;
+        }
+        if (code.minimumAmount !== undefined && code.minimumAmount !== null) {
+            if (code.minimumAmountCurrency &&
+                code.minimumAmountCurrency.toLowerCase() !== (price.currency ?? "").toLowerCase())
+                return null;
+            if ((price.unitAmount ?? 0) < code.minimumAmount)
+                return null;
+        }
+        const customer = await this.stripeCustomerRepository.findByCompanyId({ companyId: params.companyId });
+        if (!customer)
+            return null;
+        if (code.stripeCustomerId && code.stripeCustomerId !== customer.stripeCustomerId)
+            return null;
+        // A first payment only: any subscription (canceled included) on a paid recurring price rules it out.
+        const subscriptions = await this.stripeSubscriptionRepository.findByStripeCustomerId({
+            stripeCustomerId: customer.id,
+        });
+        const hasPaidRecurring = subscriptions.some((subscription) => subscription.stripePrice?.priceType === "recurring" && !subscription.stripePrice?.isTrial);
+        if (hasPaidRecurring)
+            return null;
+        return code;
+    }
+    /**
+     * Checks a promotion code the browser sent at checkout against our automatic code.
+     * - "not_automatic": not one of our automatic codes (typed or unknown); pass it to Stripe as is.
+     * - "eligible": it is the automatic code and it applies to this first payment right now.
+     * - "sold_out": it is the automatic code, it does not apply, and it has no places left.
+     * - "unavailable": it is the automatic code and it does not apply for any other reason.
+     * Uses the same rules as findAutomaticForPrice, so the review and the payment agree.
+     */
+    async checkAutomaticForPrice(params) {
+        const code = await this.stripeCouponCodeRepository.findByStripePromotionCodeId({
+            stripePromotionCodeId: params.stripePromotionCodeId,
+        });
+        if (!code || !code.automatic)
+            return "not_automatic";
+        // The automatic code only ever applies to a first payment, whatever its places.
+        if (!params.firstPayment)
+            return "unavailable";
+        const current = await this.findAutomaticForPrice({ companyId: params.companyId, priceId: params.priceId });
+        if (current?.stripePromotionCodeId === params.stripePromotionCodeId)
+            return "eligible";
+        return (await this.hasNoPlacesLeft(code)) ? "sold_out" : "unavailable";
+    }
+    /**
+     * The automatic code for a price as a JSON:API list of 0 or 1 code, coupon included.
+     */
+    async findAutomaticForPriceDocument(params) {
+        const paginator = new jsonapi_paginator_1.JsonApiPaginator(params.query);
+        const code = await this.findAutomaticForPrice({ companyId: params.companyId, priceId: params.priceId });
+        return this.jsonApiService.buildList(stripe_coupon_code_1.StripeCouponCodeDescriptor.model, code ? [code] : [], paginator);
+    }
+    /**
+     * Reads the promotion code and its coupon live from Stripe and tells whether either has run out.
+     */
+    async isExhausted(stripePromotionCodeId) {
+        const promotionCode = await this.stripeCouponApiService.retrievePromotionCode(stripePromotionCodeId);
+        if (!promotionCode.active)
+            return true;
+        if (this.limitReached(promotionCode.max_redemptions, promotionCode.times_redeemed))
+            return true;
+        const coupon = await this.resolveCoupon(promotionCode);
+        if (!coupon)
+            return false;
+        if (!coupon.valid)
+            return true;
+        return this.limitReached(coupon.max_redemptions, coupon.times_redeemed);
+    }
+    /**
+     * Re-reads a promotion code and its coupon from Stripe and writes the counts to our nodes.
+     * A no-op when the code is not one of ours; logs and never throws.
+     */
+    async refreshCountsByStripePromotionCodeId(stripePromotionCodeId) {
+        try {
+            const code = await this.stripeCouponCodeRepository.findByStripePromotionCodeId({ stripePromotionCodeId });
+            if (!code)
+                return;
+            const promotionCode = await this.stripeCouponApiService.retrievePromotionCode(stripePromotionCodeId);
+            await this.stripeCouponCodeRepository.patch({
+                id: code.id,
+                timesRedeemed: promotionCode.times_redeemed,
+                active: promotionCode.active,
+            });
+            const coupon = await this.resolveCoupon(promotionCode);
+            if (coupon && code.coupon?.id) {
+                await this.stripeCouponRepository.patch({
+                    id: code.coupon.id,
+                    timesRedeemed: coupon.times_redeemed,
+                    valid: coupon.valid,
+                });
+            }
+        }
+        catch (error) {
+            this.logger.error(`Failed to refresh coupon counts for promotion code ${stripePromotionCodeId}:`, error);
+        }
+    }
+    /**
+     * No places left: our copy says 0, or Stripe says so live. A failed live read counts as "has places".
+     */
+    async hasNoPlacesLeft(code) {
+        if (code.coupon && (0, places_left_1.placesLeft)(code, code.coupon) === 0)
+            return true;
+        try {
+            return await this.isExhausted(code.stripePromotionCodeId);
+        }
+        catch (error) {
+            this.logger.error(`Failed to read live places for promotion code ${code.stripePromotionCodeId}:`, error);
+            return false;
+        }
+    }
+    limitReached(maxRedemptions, timesRedeemed) {
+        return maxRedemptions !== null && maxRedemptions !== undefined && timesRedeemed >= maxRedemptions;
+    }
+    async resolveCoupon(promotionCode) {
+        const coupon = promotionCode.promotion?.coupon;
+        if (!coupon)
+            return null;
+        if (typeof coupon === "string")
+            return this.stripeCouponApiService.retrieveCoupon(coupon);
+        return coupon;
+    }
+};
+exports.StripeCouponCodeCheckoutService = StripeCouponCodeCheckoutService;
+exports.StripeCouponCodeCheckoutService = StripeCouponCodeCheckoutService = StripeCouponCodeCheckoutService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [jsonapi_service_1.JsonApiService,
+        stripe_coupon_code_repository_1.StripeCouponCodeRepository,
+        nestjs_cls_1.ClsService,
+        stripe_coupon_repository_1.StripeCouponRepository,
+        stripe_coupon_api_service_1.StripeCouponApiService,
+        stripe_price_repository_1.StripePriceRepository,
+        stripe_customer_repository_1.StripeCustomerRepository,
+        stripe_subscription_repository_1.StripeSubscriptionRepository])
+], StripeCouponCodeCheckoutService);
+//# sourceMappingURL=stripe-coupon-code-checkout.service.js.map

package/dist/foundations/stripe-coupon/services/stripe-coupon-code-checkout.service.js.map

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

package/dist/foundations/stripe-coupon/services/stripe-coupon-code.service.d.ts

@@ -0,0 +1,92 @@
+import { ClsService } from "nestjs-cls";
+import Stripe from "stripe";
+import { JsonApiSingleDocument } from "../../../core/jsonapi/interfaces/jsonapi.document.interface";
+import { JsonApiService } from "../../../core/jsonapi/services/jsonapi.service";
+import { AbstractService } from "../../../core/neo4j/abstracts/abstract.service";
+import { StripeCouponCodePatchDataDTO } from "../dtos/stripe-coupon-code.patch.dto";
+import { StripeCouponCodePostAttributesDTO, StripeCouponCodePostDataDTO } from "../dtos/stripe-coupon-code.post.dto";
+import { StripeCouponCode, StripeCouponCodeDescriptor } from "../entities/stripe-coupon-code";
+import { StripeCouponCodeRepository } from "../repositories/stripe-coupon-code.repository";
+import { StripeCouponRepository } from "../repositories/stripe-coupon.repository";
+import { StripeCouponApiService } from "./stripe-coupon-api.service";
+/**
+ * Cross-field checks on a code's attributes, run before any Stripe call.
+ */
+export declare function assertCouponCodeAttributes(attributes: StripeCouponCodePostAttributesDTO): void;
+/**
+ * The Stripe promotion code parameters for a code POST's attributes.
+ */
+export declare function couponCodeStripeParams(stripeCouponId: string, attributes: StripeCouponCodePostAttributesDTO): {
+    stripeCouponId: string;
+    code: string;
+    firstTimeTransaction: boolean;
+    minimumAmount: number;
+    minimumAmountCurrency: string;
+    stripeCustomerId: string;
+    expiresAt: Date;
+    maxRedemptions: number;
+};
+/**
+ * The StripeCouponCode node parameters for a promotion code Stripe has just created.
+ */
+export declare function couponCodeNodeParams(params: {
+    id: string;
+    couponId: string;
+    attributes: StripeCouponCodePostAttributesDTO;
+    promotionCode: Stripe.PromotionCode;
+}): {
+    id: string;
+    stripePromotionCodeId: string;
+    code: string;
+    active: boolean;
+    automatic: boolean;
+    firstTimeTransaction: boolean;
+    minimumAmount: number;
+    minimumAmountCurrency: string;
+    stripeCustomerId: string;
+    expiresAt: string;
+    maxRedemptions: number;
+    timesRedeemed: number;
+    coupon: string;
+};
+/**
+ * StripeCouponCodeService
+ *
+ * Admin operations on the customer-facing codes of a coupon: add a code to an
+ * existing coupon, switch "Apply automatically", deactivate / reactivate.
+ * Every code is created in Stripe first, then mirrored as a node.
+ */
+export declare class StripeCouponCodeService extends AbstractService<StripeCouponCode, typeof StripeCouponCodeDescriptor.relationships> {
+    private readonly stripeCouponCodeRepository;
+    private readonly stripeCouponRepository;
+    private readonly stripeCouponApiService;
+    protected readonly descriptor: import("../../..").EntityDescriptor<StripeCouponCode, {
+        coupon: {
+            model: import("../../..").DataMeta;
+            direction: "in";
+            relationship: string;
+            cardinality: "one";
+            required: true;
+            dtoKey: string;
+        };
+    }>;
+    constructor(jsonApiService: JsonApiService, stripeCouponCodeRepository: StripeCouponCodeRepository, clsService: ClsService, stripeCouponRepository: StripeCouponRepository, stripeCouponApiService: StripeCouponApiService);
+    createForCoupon(params: {
+        data: StripeCouponCodePostDataDTO;
+    }): Promise<JsonApiSingleDocument>;
+    /**
+     * Switches "active" (in Stripe, then on the node) and / or "Apply
+     * automatically" (ours only: turning it on clears every other code).
+     */
+    updateFlags(params: {
+        data: StripeCouponCodePatchDataDTO;
+    }): Promise<JsonApiSingleDocument>;
+    /**
+     * The id of the coupon a code belongs to, so callers can refresh the
+     * coupon's cached entry after a change to one of its codes.
+     */
+    findCouponId(params: {
+        codeId: string;
+    }): Promise<string | undefined>;
+}
+//# sourceMappingURL=stripe-coupon-code.service.d.ts.map

package/dist/foundations/stripe-coupon/services/stripe-coupon-code.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe-coupon-code.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/stripe-coupon/services/stripe-coupon-code.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AACpG,OAAO,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AACjF,OAAO,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,EAAE,iCAAiC,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AACrH,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAC9F,OAAO,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC;AAC3F,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,iCAAiC,GAAG,IAAI,CAK9F;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,iCAAiC;;;;;;;;;EAW3G;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,iCAAiC,CAAC;IAC9C,aAAa,EAAE,MAAM,CAAC,aAAa,CAAC;CACrC;;;;;;;;;;;;;;EAgBA;AAED;;;;;;GAMG;AACH,qBACa,uBAAwB,SAAQ,eAAe,CAC1D,gBAAgB,EAChB,OAAO,0BAA0B,CAAC,aAAa,CAChD;IAKG,OAAO,CAAC,QAAQ,CAAC,0BAA0B;IAE3C,OAAO,CAAC,QAAQ,CAAC,sBAAsB;IACvC,OAAO,CAAC,QAAQ,CAAC,sBAAsB;IAPzC,SAAS,CAAC,QAAQ,CAAC,UAAU;;;;;;;;;OAA8B;gBAGzD,cAAc,EAAE,cAAc,EACb,0BAA0B,EAAE,0BAA0B,EACvE,UAAU,EAAE,UAAU,EACL,sBAAsB,EAAE,sBAAsB,EAC9C,sBAAsB,EAAE,sBAAsB;IAK3D,eAAe,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,2BAA2B,CAAA;KAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAuBpG;;;OAGG;IACG,WAAW,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,4BAA4B,CAAA;KAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAoBjG;;;OAGG;IACG,YAAY,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;CAI5E"}

package/dist/foundations/stripe-coupon/services/stripe-coupon-code.service.js

@@ -0,0 +1,134 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StripeCouponCodeService = void 0;
+exports.assertCouponCodeAttributes = assertCouponCodeAttributes;
+exports.couponCodeStripeParams = couponCodeStripeParams;
+exports.couponCodeNodeParams = couponCodeNodeParams;
+const common_1 = require("@nestjs/common");
+const nestjs_cls_1 = require("nestjs-cls");
+const jsonapi_service_1 = require("../../../core/jsonapi/services/jsonapi.service");
+const abstract_service_1 = require("../../../core/neo4j/abstracts/abstract.service");
+const stripe_coupon_code_1 = require("../entities/stripe-coupon-code");
+const stripe_coupon_code_repository_1 = require("../repositories/stripe-coupon-code.repository");
+const stripe_coupon_repository_1 = require("../repositories/stripe-coupon.repository");
+const stripe_coupon_api_service_1 = require("./stripe-coupon-api.service");
+/**
+ * Cross-field checks on a code's attributes, run before any Stripe call.
+ */
+function assertCouponCodeAttributes(attributes) {
+    if (attributes.minimumAmount !== undefined && !attributes.minimumAmountCurrency)
+        throw new common_1.BadRequestException("A minimum amount needs a currency");
+    if (attributes.minimumAmount === undefined && attributes.minimumAmountCurrency)
+        throw new common_1.BadRequestException("A minimum amount currency needs a minimum amount");
+}
+/**
+ * The Stripe promotion code parameters for a code POST's attributes.
+ */
+function couponCodeStripeParams(stripeCouponId, attributes) {
+    return {
+        stripeCouponId,
+        code: attributes.code,
+        firstTimeTransaction: attributes.firstTimeTransaction,
+        minimumAmount: attributes.minimumAmount,
+        minimumAmountCurrency: attributes.minimumAmountCurrency?.toLowerCase(),
+        stripeCustomerId: attributes.stripeCustomerId,
+        expiresAt: attributes.expiresAt ? new Date(attributes.expiresAt) : undefined,
+        maxRedemptions: attributes.maxRedemptions,
+    };
+}
+/**
+ * The StripeCouponCode node parameters for a promotion code Stripe has just created.
+ */
+function couponCodeNodeParams(params) {
+    return {
+        id: params.id,
+        stripePromotionCodeId: params.promotionCode.id,
+        code: params.promotionCode.code,
+        active: params.promotionCode.active,
+        automatic: params.attributes.automatic ?? false,
+        firstTimeTransaction: params.attributes.firstTimeTransaction ?? false,
+        minimumAmount: params.attributes.minimumAmount,
+        minimumAmountCurrency: params.attributes.minimumAmountCurrency?.toLowerCase(),
+        stripeCustomerId: params.attributes.stripeCustomerId,
+        expiresAt: params.attributes.expiresAt,
+        maxRedemptions: params.attributes.maxRedemptions,
+        timesRedeemed: params.promotionCode.times_redeemed ?? 0,
+        coupon: params.couponId,
+    };
+}
+/**
+ * StripeCouponCodeService
+ *
+ * Admin operations on the customer-facing codes of a coupon: add a code to an
+ * existing coupon, switch "Apply automatically", deactivate / reactivate.
+ * Every code is created in Stripe first, then mirrored as a node.
+ */
+let StripeCouponCodeService = class StripeCouponCodeService extends abstract_service_1.AbstractService {
+    constructor(jsonApiService, stripeCouponCodeRepository, clsService, stripeCouponRepository, stripeCouponApiService) {
+        super(jsonApiService, stripeCouponCodeRepository, clsService, stripe_coupon_code_1.StripeCouponCodeDescriptor.model);
+        this.stripeCouponCodeRepository = stripeCouponCodeRepository;
+        this.stripeCouponRepository = stripeCouponRepository;
+        this.stripeCouponApiService = stripeCouponApiService;
+        this.descriptor = stripe_coupon_code_1.StripeCouponCodeDescriptor;
+    }
+    async createForCoupon(params) {
+        const attributes = params.data.attributes;
+        const couponId = params.data.relationships.coupon.data.id;
+        assertCouponCodeAttributes(attributes);
+        const coupon = await this.stripeCouponRepository.findById({ id: couponId });
+        if (!coupon)
+            throw new common_1.NotFoundException("Coupon not found");
+        const promotionCode = await this.stripeCouponApiService.createPromotionCode(couponCodeStripeParams(coupon.stripeCouponId, attributes));
+        await this.stripeCouponCodeRepository.create(couponCodeNodeParams({ id: params.data.id, couponId, attributes, promotionCode }));
+        if (attributes.automatic)
+            await this.stripeCouponCodeRepository.setAutomatic({ id: params.data.id, automatic: true });
+        return this.findById({ id: params.data.id });
+    }
+    /**
+     * Switches "active" (in Stripe, then on the node) and / or "Apply
+     * automatically" (ours only: turning it on clears every other code).
+     */
+    async updateFlags(params) {
+        const attributes = params.data.attributes;
+        const code = await this.stripeCouponCodeRepository.findById({ id: params.data.id });
+        if (!code)
+            throw new common_1.NotFoundException("Code not found");
+        if (attributes.active !== undefined) {
+            await this.stripeCouponApiService.setPromotionCodeActive({
+                stripePromotionCodeId: code.stripePromotionCodeId,
+                active: attributes.active,
+            });
+            await this.stripeCouponCodeRepository.patch({ id: code.id, active: attributes.active });
+        }
+        if (attributes.automatic !== undefined)
+            await this.stripeCouponCodeRepository.setAutomatic({ id: code.id, automatic: attributes.automatic });
+        return this.findById({ id: code.id });
+    }
+    /**
+     * The id of the coupon a code belongs to, so callers can refresh the
+     * coupon's cached entry after a change to one of its codes.
+     */
+    async findCouponId(params) {
+        const code = await this.stripeCouponCodeRepository.findById({ id: params.codeId });
+        return code?.coupon?.id;
+    }
+};
+exports.StripeCouponCodeService = StripeCouponCodeService;
+exports.StripeCouponCodeService = StripeCouponCodeService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [jsonapi_service_1.JsonApiService,
+        stripe_coupon_code_repository_1.StripeCouponCodeRepository,
+        nestjs_cls_1.ClsService,
+        stripe_coupon_repository_1.StripeCouponRepository,
+        stripe_coupon_api_service_1.StripeCouponApiService])
+], StripeCouponCodeService);
+//# sourceMappingURL=stripe-coupon-code.service.js.map

package/dist/foundations/stripe-coupon/services/stripe-coupon-code.service.js.map

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

package/dist/foundations/stripe-coupon/services/stripe-coupon-offer.service.d.ts

@@ -0,0 +1,29 @@
+import { ClsService } from "nestjs-cls";
+import { JsonApiListDocument } from "../../../core/jsonapi/interfaces/jsonapi.document.interface";
+import { JsonApiService } from "../../../core/jsonapi/services/jsonapi.service";
+import { AbstractService } from "../../../core/neo4j/abstracts/abstract.service";
+import { StripeCouponCode, StripeCouponCodeDescriptor } from "../entities/stripe-coupon-code";
+import { StripeCouponCodeRepository } from "../repositories/stripe-coupon-code.repository";
+/**
+ * The public offer: places left on the automatic code, as a synthetic `stripe-coupon-offers`
+ * list of 0 or 1 offer. Reads our copy only, never Stripe.
+ */
+export declare class StripeCouponOfferService extends AbstractService<StripeCouponCode, typeof StripeCouponCodeDescriptor.relationships> {
+    private readonly stripeCouponCodeRepository;
+    protected readonly descriptor: import("../../..").EntityDescriptor<StripeCouponCode, {
+        coupon: {
+            model: import("../../..").DataMeta;
+            direction: "in";
+            relationship: string;
+            cardinality: "one";
+            required: true;
+            dtoKey: string;
+        };
+    }>;
+    constructor(jsonApiService: JsonApiService, stripeCouponCodeRepository: StripeCouponCodeRepository, clsService: ClsService);
+    findPublicOffers(params: {
+        query: any;
+    }): Promise<JsonApiListDocument>;
+    private buildOffer;
+}
+//# sourceMappingURL=stripe-coupon-offer.service.d.ts.map

package/dist/foundations/stripe-coupon/services/stripe-coupon-offer.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe-coupon-offer.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/stripe-coupon/services/stripe-coupon-offer.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AAElG,OAAO,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAE9F,OAAO,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC;AAG3F;;;GAGG;AACH,qBACa,wBAAyB,SAAQ,eAAe,CAC3D,gBAAgB,EAChB,OAAO,0BAA0B,CAAC,aAAa,CAChD;IAKG,OAAO,CAAC,QAAQ,CAAC,0BAA0B;IAJ7C,SAAS,CAAC,QAAQ,CAAC,UAAU;;;;;;;;;OAA8B;gBAGzD,cAAc,EAAE,cAAc,EACb,0BAA0B,EAAE,0BAA0B,EACvE,UAAU,EAAE,UAAU;IAKlB,gBAAgB,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,GAAG,CAAA;KAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC;YAO9D,UAAU;CA2BzB"}