@carlonicora/nestjs-neo4jsonapi 7.0.0 → 8.0.0

package/dist/foundations/stripe-subscription/repositories/stripe-subscription.repository.js

@@ -12,169 +12,131 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.StripeSubscriptionRepository = void 0;
 const common_1 = require("@nestjs/common");
 const crypto_1 = require("crypto");
-const neo4j_1 = require("../../../core/neo4j");
-const company_1 = require("../../company");
+const nestjs_cls_1 = require("nestjs-cls");
+const abstract_repository_1 = require("../../../core/neo4j/abstracts/abstract.repository");
+const neo4j_service_1 = require("../../../core/neo4j/services/neo4j.service");
+const security_service_1 = require("../../../core/security/services/security.service");
+const company_meta_1 = require("../../company/entities/company.meta");
 const stripe_customer_meta_1 = require("../../stripe-customer/entities/stripe-customer.meta");
 const stripe_price_meta_1 = require("../../stripe-price/entities/stripe-price.meta");
 const stripe_product_meta_1 = require("../../stripe-product/entities/stripe-product.meta");
+const user_meta_1 = require("../../user/entities/user.meta");
+const stripe_subscription_1 = require("../entities/stripe-subscription");
 const stripe_subscription_discount_1 = require("../entities/stripe-subscription.discount");
 const stripe_subscription_meta_1 = require("../entities/stripe-subscription.meta");
-const stripe_subscription_model_1 = require("../entities/stripe-subscription.model");
+const S = stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName;
+/** Datetime fields `update()` can set or clear: undefined leaves, null clears. */
+const CLEARABLE_DATETIME_FIELDS = ["canceledAt", "cardExpiryCheckedFor"];
 /**
  * StripeSubscriptionRepository
  *
- * Neo4j repository for managing Subscription nodes and their relationships to BillingCustomer and Price nodes.
- * Handles subscription lifecycle data storage and queries with status filtering.
+ * Neo4j repository for StripeSubscription nodes:
+ * `(stripeSubscription)-[:BELONGS_TO]->(stripeCustomer)`, `-[:USES_PRICE]->(stripePrice)`,
+ * `-[:BELONGS_TO]->(company)` and `-[:CREATED_BY]->(user)`.
  *
- * Key Features:
- * - Automatic constraint creation for ID and Stripe subscription ID uniqueness
- * - Query subscriptions by customer, status, or Stripe ID
- * - Create and update operations with relationship management
- * - Support for plan changes by updating price relationships
- * - Sync operations for webhook data
- * - Track trial periods, billing cycles, and cancellation status
- * - Bulk cancel operations for customer deletion
- *
- * @example
- * ```typescript
- * const subscription = await subscriptionRepository.create({
- *   stripeCustomerId: 'cust_123',
- *   priceId: 'price_456',
- *   stripeSubscriptionId: 'sub_stripe789',
- *   status: 'active',
- *   currentPeriodStart: new Date(),
- *   currentPeriodEnd: new Date(Date.now() + 30 * 24 * 60 * 60 * 1000),
- *   cancelAtPeriodEnd: false,
- *   quantity: 1
- * });
- * ```
+ * Every read and every request-time write starts from `buildDefaultMatch()`, so a request is
+ * scoped to the caller's company. Jobs with no company in CLS (webhooks, crons, backfills)
+ * reach every company through the `$companyId IS NULL` branch.
  */
-let StripeSubscriptionRepository = class StripeSubscriptionRepository {
-    constructor(neo4j) {
-        this.neo4j = neo4j;
+let StripeSubscriptionRepository = class StripeSubscriptionRepository extends abstract_repository_1.AbstractRepository {
+    constructor(neo4j, securityService, clsService) {
+        super(neo4j, securityService, clsService);
+        this.descriptor = stripe_subscription_1.StripeSubscriptionDescriptor;
     }
-    /**
-     * Initialize repository constraints
-     *
-     * Creates unique constraints and indexes on module initialization.
-     */
+    /** The inherited id constraint and indexes, plus the unique Stripe subscription id. */
     async onModuleInit() {
+        await super.onModuleInit();
         await this.neo4j.writeOne({
-            query: `CREATE CONSTRAINT ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_id IF NOT EXISTS FOR (${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}:${stripe_subscription_meta_1.stripeSubscriptionMeta.labelName}) REQUIRE ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}.id IS UNIQUE`,
-        });
-        await this.neo4j.writeOne({
-            query: `CREATE CONSTRAINT ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_stripeSubscriptionId IF NOT EXISTS FOR (${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}:${stripe_subscription_meta_1.stripeSubscriptionMeta.labelName}) REQUIRE ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}.stripeSubscriptionId IS UNIQUE`,
+            query: `CREATE CONSTRAINT ${S}_stripeSubscriptionId IF NOT EXISTS FOR (${S}:${stripe_subscription_meta_1.stripeSubscriptionMeta.labelName}) REQUIRE ${S}.stripeSubscriptionId IS UNIQUE`,
         });
     }
     /**
-     * Find subscriptions by stripe customer ID
-     *
-     * @param params - Query parameters
-     * @param params.stripeCustomerId - Stripe customer identifier (internal ID)
-     * @param params.status - Optional filter by subscription status
-     * @returns Array of subscriptions ordered by creation date descending
+     * The subscription with its company, customer, price, the price's product and its creator.
      */
-    async findByStripeCustomerId(params) {
-        const query = this.neo4j.initQuery({ serialiser: stripe_subscription_model_1.StripeSubscriptionModel });
-        const whereParams = [];
-        if (params.status) {
-            query.queryParams.status = params.status;
-            whereParams.push(`${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}.status = $status`);
-        }
-        const where = whereParams.length > 0 ? `AND ${whereParams.join(" AND ")}` : "";
-        query.queryParams.stripeCustomerId = params.stripeCustomerId;
-        query.query = `
-      MATCH (${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}:${stripe_subscription_meta_1.stripeSubscriptionMeta.labelName})-[:BELONGS_TO]->(${stripe_customer_meta_1.stripeCustomerMeta.nodeName}:${stripe_customer_meta_1.stripeCustomerMeta.labelName} {id: $stripeCustomerId})
-      MATCH (${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName})-[:USES_PRICE]->(${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName}:${stripe_price_meta_1.stripePriceMeta.labelName})-[:BELONGS_TO]->(${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName}_${stripe_product_meta_1.stripeProductMeta.nodeName}:${stripe_product_meta_1.stripeProductMeta.labelName})
-      WHERE 1=1 ${where}
-      RETURN ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}, ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName}, ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName}_${stripe_product_meta_1.stripeProductMeta.nodeName}
-      ORDER BY ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}.createdAt DESC
+    buildReturnStatement() {
+        return `
+      MATCH (${S})-[:BELONGS_TO]->(${S}_${company_meta_1.companyMeta.nodeName}:${company_meta_1.companyMeta.labelName})
+      MATCH (${S})-[:BELONGS_TO]->(${S}_stripeCustomer:${stripe_customer_meta_1.stripeCustomerMeta.labelName})
+      MATCH (${S})-[:USES_PRICE]->(${S}_stripePrice:${stripe_price_meta_1.stripePriceMeta.labelName})-[:BELONGS_TO]->(${S}_stripePrice_${stripe_product_meta_1.stripeProductMeta.nodeName}:${stripe_product_meta_1.stripeProductMeta.labelName})
+      OPTIONAL MATCH (${S})-[:CREATED_BY]->(${S}_createdBy:${user_meta_1.userMeta.labelName})
+      RETURN ${S},
+        ${S}_${company_meta_1.companyMeta.nodeName},
+        ${S}_stripeCustomer,
+        ${S}_stripePrice,
+        ${S}_stripePrice_${stripe_product_meta_1.stripeProductMeta.nodeName},
+        ${S}_createdBy
     `;
-        return this.neo4j.readMany(query);
     }
     /**
-     * Find subscription by internal ID
+     * The cron finders read across every company. Inside a request `buildDefaultMatch()` would
+     * scope them to the caller's company, so they refuse to run there.
+     */
+    assertNoRequestCompany(method) {
+        if (this.clsService.get("companyId")) {
+            throw new Error(`StripeSubscriptionRepository.${method} is for the worker cron only, not for a request.`);
+        }
+    }
+    /**
+     * Subscriptions of a customer, newest first.
      *
-     * @param params - Query parameters
-     * @param params.id - Internal subscription ID
-     * @returns Subscription if found, null otherwise
+     * @param params.stripeCustomerId - internal StripeCustomer id
+     * @param params.status - optional status filter
      */
-    async findById(params) {
-        const query = this.neo4j.initQuery({ serialiser: stripe_subscription_model_1.StripeSubscriptionModel });
+    async findByStripeCustomerId(params) {
+        const query = this.neo4j.initQuery({ serialiser: stripe_subscription_1.StripeSubscriptionDescriptor.model, fetchAll: true });
         query.queryParams = {
-            id: params.id,
+            ...query.queryParams,
+            stripeCustomerId: params.stripeCustomerId,
+            ...(params.status ? { status: params.status } : {}),
         };
-        query.query = `
-      MATCH (${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}:${stripe_subscription_meta_1.stripeSubscriptionMeta.labelName} {id: $id})-[:BELONGS_TO]->(${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_customer_meta_1.stripeCustomerMeta.nodeName}:${stripe_customer_meta_1.stripeCustomerMeta.labelName})
-      MATCH (${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName})-[:USES_PRICE]->(${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName}:${stripe_price_meta_1.stripePriceMeta.labelName})-[:BELONGS_TO]->(${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName}_${stripe_product_meta_1.stripeProductMeta.nodeName}:${stripe_product_meta_1.stripeProductMeta.labelName})
-      RETURN ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}, ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_customer_meta_1.stripeCustomerMeta.nodeName}, ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName}, ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName}_${stripe_product_meta_1.stripeProductMeta.nodeName}
+        query.query += `
+      ${this.buildDefaultMatch()}
+      MATCH (${S})-[:BELONGS_TO]->(:${stripe_customer_meta_1.stripeCustomerMeta.labelName} {id: $stripeCustomerId})
+      ${params.status ? `WHERE ${S}.status = $status` : ``}
+      WITH ${S}
+      ${this.buildReturnStatement()}
+      ORDER BY ${S}.createdAt DESC
     `;
-        return this.neo4j.readOne(query);
+        return this.neo4j.readMany(query);
     }
     /**
-     * Find every subscription, of every company.
-     *
-     * Not company-scoped and not paginated: it serves system jobs that run outside a
-     * request (the discount backfill), never an endpoint. It matches the same
-     * customer and price path as {@link update}, so every row it returns can be updated.
-     *
-     * @returns All subscriptions ordered by creation date ascending
+     * Every subscription, oldest first. Not paginated: it serves system jobs that run outside a
+     * request (the discount backfill), never an endpoint.
      */
     async findAll() {
-        const query = this.neo4j.initQuery({ serialiser: stripe_subscription_model_1.StripeSubscriptionModel, fetchAll: true });
+        const query = this.neo4j.initQuery({ serialiser: stripe_subscription_1.StripeSubscriptionDescriptor.model, fetchAll: true });
         query.query += `
-      MATCH (${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}:${stripe_subscription_meta_1.stripeSubscriptionMeta.labelName})-[:BELONGS_TO]->(${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_customer_meta_1.stripeCustomerMeta.nodeName}:${stripe_customer_meta_1.stripeCustomerMeta.labelName})
-      MATCH (${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName})-[:USES_PRICE]->(${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName}:${stripe_price_meta_1.stripePriceMeta.labelName})-[:BELONGS_TO]->(${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName}_${stripe_product_meta_1.stripeProductMeta.nodeName}:${stripe_product_meta_1.stripeProductMeta.labelName})
-      RETURN ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}, ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_customer_meta_1.stripeCustomerMeta.nodeName}, ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName}, ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName}_${stripe_product_meta_1.stripeProductMeta.nodeName}
-      ORDER BY ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}.createdAt ASC
+      ${this.buildDefaultMatch()}
+      ${this.buildReturnStatement()}
+      ORDER BY ${S}.createdAt ASC
     `;
         return this.neo4j.readMany(query);
     }
-    /**
-     * Find subscription by Stripe subscription ID
-     *
-     * @param params - Query parameters
-     * @param params.stripeSubscriptionId - Stripe subscription ID
-     * @returns Subscription if found, null otherwise
-     */
+    /** The subscription with this Stripe subscription id, or null. */
     async findByStripeSubscriptionId(params) {
-        const query = this.neo4j.initQuery({ serialiser: stripe_subscription_model_1.StripeSubscriptionModel });
-        query.queryParams = {
-            stripeSubscriptionId: params.stripeSubscriptionId,
-        };
-        query.query = `
-      MATCH (${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}:${stripe_subscription_meta_1.stripeSubscriptionMeta.labelName} {stripeSubscriptionId: $stripeSubscriptionId})-[:BELONGS_TO]->(${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_customer_meta_1.stripeCustomerMeta.nodeName}:${stripe_customer_meta_1.stripeCustomerMeta.labelName})
-      MATCH (${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName})-[:USES_PRICE]->(${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName}:${stripe_price_meta_1.stripePriceMeta.labelName})-[:BELONGS_TO]->(${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName}_${stripe_product_meta_1.stripeProductMeta.nodeName}:${stripe_product_meta_1.stripeProductMeta.labelName})
-      RETURN ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}, ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_customer_meta_1.stripeCustomerMeta.nodeName}, ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName}, ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName}_${stripe_product_meta_1.stripeProductMeta.nodeName}
+        const query = this.neo4j.initQuery({ serialiser: stripe_subscription_1.StripeSubscriptionDescriptor.model });
+        query.queryParams = { ...query.queryParams, searchValue: params.stripeSubscriptionId };
+        query.query += `
+      ${this.buildDefaultMatch({ searchField: "stripeSubscriptionId" })}
+      ${this.buildReturnStatement()}
     `;
         return this.neo4j.readOne(query);
     }
     /**
-     * Create a new subscription
-     *
-     * Creates a Subscription node with BELONGS_TO relationship to StripeCustomer
-     * and USES_PRICE relationship to StripePrice.
-     *
-     * @param params - Creation parameters
-     * @param params.stripeCustomerId - Stripe customer ID to link to
-     * @param params.priceId - Price ID to link to
-     * @param params.stripeSubscriptionId - Stripe subscription ID
-     * @param params.stripeSubscriptionItemId - Optional Stripe subscription item ID
-     * @param params.status - Subscription status
-     * @param params.currentPeriodStart - Current billing period start date
-     * @param params.currentPeriodEnd - Current billing period end date
-     * @param params.cancelAtPeriodEnd - Whether subscription cancels at period end
-     * @param params.trialStart - Optional trial start date
-     * @param params.trialEnd - Optional trial end date
-     * @param params.quantity - Subscription quantity
-     * @returns Created Subscription
+     * Creates a subscription linked to its customer, its price, the caller's company and the
+     * caller. The customer and price ids are checked against the caller's company first.
      */
-    async create(params) {
-        const query = this.neo4j.initQuery({ serialiser: stripe_subscription_model_1.StripeSubscriptionModel });
-        const id = (0, crypto_1.randomUUID)();
+    async createSubscription(params) {
+        await this.neo4j.validateRelatedNodes({
+            nodes: [
+                { id: params.stripeCustomerId, label: stripe_customer_meta_1.stripeCustomerMeta.labelName },
+                { id: params.priceId, label: stripe_price_meta_1.stripePriceMeta.labelName },
+            ],
+        });
+        const query = this.neo4j.initQuery({ serialiser: stripe_subscription_1.StripeSubscriptionDescriptor.model });
         query.queryParams = {
             ...query.queryParams,
-            id: id,
+            id: (0, crypto_1.randomUUID)(),
             stripeCustomerId: params.stripeCustomerId,
             priceId: params.priceId,
             stripeSubscriptionId: params.stripeSubscriptionId,
@@ -188,11 +150,12 @@ let StripeSubscriptionRepository = class StripeSubscriptionRepository {
             quantity: params.quantity,
             ...(0, stripe_subscription_discount_1.discountQueryParams)(params.discount ?? null),
         };
-        // Guarded: initQuery() binds this variable only when the id is in CLS; an unbound CREATE target creates an orphan node.
+        // Guarded: initQuery() binds `company` / `currentUser` only when CLS holds them; an
+        // unbound CREATE target would create an orphan node.
         query.query += `
-      MATCH (${stripe_customer_meta_1.stripeCustomerMeta.nodeName}:${stripe_customer_meta_1.stripeCustomerMeta.labelName} {id: $stripeCustomerId})
-      MATCH (${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName}:${stripe_price_meta_1.stripePriceMeta.labelName} {id: $priceId})-[:BELONGS_TO]->(${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName}_${stripe_product_meta_1.stripeProductMeta.nodeName}:${stripe_product_meta_1.stripeProductMeta.labelName})
-      CREATE (${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}:${stripe_subscription_meta_1.stripeSubscriptionMeta.labelName} {
+      MATCH (newStripeCustomer:${stripe_customer_meta_1.stripeCustomerMeta.labelName} {id: $stripeCustomerId})
+      MATCH (newStripePrice:${stripe_price_meta_1.stripePriceMeta.labelName} {id: $priceId})
+      CREATE (${S}:${stripe_subscription_meta_1.stripeSubscriptionMeta.labelName} {
         id: $id,
         stripeSubscriptionId: $stripeSubscriptionId,
         stripeSubscriptionItemId: $stripeSubscriptionItemId,
@@ -212,213 +175,182 @@ let StripeSubscriptionRepository = class StripeSubscriptionRepository {
         createdAt: datetime(),
         updatedAt: datetime()
       })
-      CREATE (${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName})-[:BELONGS_TO]->(${stripe_customer_meta_1.stripeCustomerMeta.nodeName})
-      CREATE (${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName})-[:USES_PRICE]->(${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName})
-      ${query.queryParams.companyId ? `CREATE (${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName})-[:BELONGS_TO]->(${company_1.companyMeta.nodeName})` : ``}
-      ${query.queryParams.currentUserId ? `CREATE (${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName})-[:CREATED_BY]->(currentUser)` : ``}
-      RETURN ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}, ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName}, ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName}_${stripe_product_meta_1.stripeProductMeta.nodeName}
+      CREATE (${S})-[:BELONGS_TO]->(newStripeCustomer)
+      CREATE (${S})-[:USES_PRICE]->(newStripePrice)
+      ${query.queryParams.companyId ? `CREATE (${S})-[:BELONGS_TO]->(${company_meta_1.companyMeta.nodeName})` : ``}
+      ${query.queryParams.currentUserId ? `CREATE (${S})-[:CREATED_BY]->(currentUser)` : ``}
+      WITH ${S}
+      ${this.buildReturnStatement()}
     `;
         return this.neo4j.writeOne(query);
     }
     /**
-     * Update subscription by internal ID
-     *
-     * @param params - Update parameters
-     * @param params.id - Internal subscription ID
-     * @param params.status - Optional new status
-     * @param params.currentPeriodStart - Optional new period start
-     * @param params.currentPeriodEnd - Optional new period end
-     * @param params.cancelAtPeriodEnd - Optional cancel at period end flag
-     * @param params.canceledAt - Optional cancellation date (null to clear)
-     * @param params.trialStart - Optional trial start date
-     * @param params.trialEnd - Optional trial end date
-     * @param params.pausedAt - Optional pause date (null to clear)
-     * @param params.quantity - Optional new quantity
-     * @returns Updated Subscription
+     * Updates a subscription by internal id. For every optional field, undefined leaves the
+     * stored value and (where the type allows it) null clears it.
      */
     async update(params) {
-        const query = this.neo4j.initQuery({ serialiser: stripe_subscription_model_1.StripeSubscriptionModel });
-        const setParams = [];
-        setParams.push(`${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}.updatedAt = datetime()`);
+        const query = this.neo4j.initQuery({ serialiser: stripe_subscription_1.StripeSubscriptionDescriptor.model });
+        const setParams = [`${S}.updatedAt = datetime()`];
+        const values = {};
         if (params.status !== undefined) {
-            setParams.push(`${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}.status = $status`);
+            setParams.push(`${S}.status = $status`);
+            values.status = params.status;
         }
         if (params.currentPeriodStart !== undefined) {
-            setParams.push(`${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}.currentPeriodStart = datetime($currentPeriodStart)`);
+            setParams.push(`${S}.currentPeriodStart = datetime($currentPeriodStart)`);
+            values.currentPeriodStart = params.currentPeriodStart.toISOString();
         }
         if (params.currentPeriodEnd !== undefined) {
-            setParams.push(`${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}.currentPeriodEnd = datetime($currentPeriodEnd)`);
+            setParams.push(`${S}.currentPeriodEnd = datetime($currentPeriodEnd)`);
+            values.currentPeriodEnd = params.currentPeriodEnd.toISOString();
         }
         if (params.cancelAtPeriodEnd !== undefined) {
-            setParams.push(`${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}.cancelAtPeriodEnd = $cancelAtPeriodEnd`);
-        }
-        if (params.canceledAt !== undefined) {
-            setParams.push(params.canceledAt === null
-                ? `${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}.canceledAt = null`
-                : `${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}.canceledAt = datetime($canceledAt)`);
+            setParams.push(`${S}.cancelAtPeriodEnd = $cancelAtPeriodEnd`);
+            values.cancelAtPeriodEnd = params.cancelAtPeriodEnd;
         }
         if (params.trialStart !== undefined) {
-            setParams.push(`${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}.trialStart = datetime($trialStart)`);
+            setParams.push(`${S}.trialStart = datetime($trialStart)`);
+            values.trialStart = params.trialStart.toISOString();
         }
         if (params.trialEnd !== undefined) {
-            setParams.push(`${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}.trialEnd = datetime($trialEnd)`);
+            setParams.push(`${S}.trialEnd = datetime($trialEnd)`);
+            values.trialEnd = params.trialEnd.toISOString();
         }
-        if (params.pausedAt !== undefined) {
-            setParams.push(params.pausedAt === null
-                ? `${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}.pausedAt = null`
-                : `${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}.pausedAt = datetime($pausedAt)`);
+        for (const field of CLEARABLE_DATETIME_FIELDS) {
+            const value = params[field];
+            if (value === undefined)
+                continue;
+            if (value === null) {
+                setParams.push(`${S}.${field} = null`);
+            }
+            else {
+                setParams.push(`${S}.${field} = datetime($${field})`);
+                values[field] = value.toISOString();
+            }
         }
         if (params.quantity !== undefined) {
-            setParams.push(`${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}.quantity = $quantity`);
+            setParams.push(`${S}.quantity = $quantity`);
+            values.quantity = params.quantity;
         }
         // undefined leaves the stored discount as it is; null clears it.
         if (params.discount !== undefined) {
-            setParams.push(`${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}.discountPercentOff = $discountPercentOff`, `${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}.discountAmountOff = $discountAmountOff`, `${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}.discountCurrency = $discountCurrency`, `${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}.discountDuration = $discountDuration`, `${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}.discountDurationInMonths = $discountDurationInMonths`, `${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}.discountEnd = CASE WHEN $discountEnd IS NOT NULL THEN datetime($discountEnd) ELSE null END`);
+            setParams.push(`${S}.discountPercentOff = $discountPercentOff`, `${S}.discountAmountOff = $discountAmountOff`, `${S}.discountCurrency = $discountCurrency`, `${S}.discountDuration = $discountDuration`, `${S}.discountDurationInMonths = $discountDurationInMonths`, `${S}.discountEnd = CASE WHEN $discountEnd IS NOT NULL THEN datetime($discountEnd) ELSE null END`);
+            Object.assign(values, (0, stripe_subscription_discount_1.discountQueryParams)(params.discount));
         }
-        query.queryParams = {
-            id: params.id,
-            status: params.status,
-            currentPeriodStart: params.currentPeriodStart?.toISOString(),
-            currentPeriodEnd: params.currentPeriodEnd?.toISOString(),
-            cancelAtPeriodEnd: params.cancelAtPeriodEnd,
-            canceledAt: params.canceledAt?.toISOString(),
-            trialStart: params.trialStart?.toISOString(),
-            trialEnd: params.trialEnd?.toISOString(),
-            pausedAt: params.pausedAt?.toISOString(),
-            quantity: params.quantity,
-            ...(params.discount !== undefined ? (0, stripe_subscription_discount_1.discountQueryParams)(params.discount) : {}),
-        };
-        query.query = `
-      MATCH (${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}:${stripe_subscription_meta_1.stripeSubscriptionMeta.labelName} {id: $id})-[:BELONGS_TO]->(${stripe_customer_meta_1.stripeCustomerMeta.nodeName}:${stripe_customer_meta_1.stripeCustomerMeta.labelName})
-      MATCH (${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName})-[:USES_PRICE]->(${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName}:${stripe_price_meta_1.stripePriceMeta.labelName})-[:BELONGS_TO]->(${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName}_${stripe_product_meta_1.stripeProductMeta.nodeName}:${stripe_product_meta_1.stripeProductMeta.labelName})
+        query.queryParams = { ...query.queryParams, ...values, searchValue: params.id };
+        query.query += `
+      ${this.buildDefaultMatch({ searchField: "id" })}
       SET ${setParams.join(", ")}
-      RETURN ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}, ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName}, ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName}_${stripe_product_meta_1.stripeProductMeta.nodeName}
+      WITH ${S}
+      ${this.buildReturnStatement()}
     `;
         return this.neo4j.writeOne(query);
     }
     /**
-     * Update subscription by Stripe subscription ID
+     * Updates a subscription by Stripe subscription id (webhook sync).
      *
-     * Used primarily by webhook handlers to sync subscription data from Stripe.
-     *
-     * @param params - Update parameters
-     * @param params.stripeSubscriptionId - Stripe subscription ID
-     * @param params.status - Optional new status
-     * @param params.currentPeriodStart - Optional new period start
-     * @param params.currentPeriodEnd - Optional new period end
-     * @param params.cancelAtPeriodEnd - Optional cancel at period end flag
-     * @param params.canceledAt - Optional cancellation date (null to clear)
-     * @param params.trialStart - Optional trial start date
-     * @param params.trialEnd - Optional trial end date
-     * @param params.pausedAt - Optional pause date (null to clear)
-     * @param params.quantity - Optional new quantity
-     * @returns Updated Subscription if found, null otherwise
+     * @returns the updated subscription, or null when none has this id
      */
     async updateByStripeSubscriptionId(params) {
         const existing = await this.findByStripeSubscriptionId({ stripeSubscriptionId: params.stripeSubscriptionId });
         if (!existing)
             return null;
-        return this.update({
-            id: existing.id,
-            ...params,
-        });
+        return this.update({ id: existing.id, ...params });
     }
     /**
-     * Update subscription price (change plan)
-     *
-     * Removes old USES_PRICE relationship and creates new one to different price.
-     *
-     * @param params - Update parameters
-     * @param params.id - Internal subscription ID
-     * @param params.newPriceId - New price ID to switch to
-     * @returns Updated Subscription with new price relationship
+     * Moves the subscription to another price (plan change). The price id is checked against
+     * the caller's company first.
      */
     async updatePrice(params) {
-        const query = this.neo4j.initQuery({ serialiser: stripe_subscription_model_1.StripeSubscriptionModel });
-        query.queryParams = {
-            id: params.id,
-            newPriceId: params.newPriceId,
-        };
-        query.query = `
-      MATCH (${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}:${stripe_subscription_meta_1.stripeSubscriptionMeta.labelName} {id: $id})-[:BELONGS_TO]->(${stripe_customer_meta_1.stripeCustomerMeta.nodeName}:${stripe_customer_meta_1.stripeCustomerMeta.labelName})
-      MATCH (${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName})-[oldRel:USES_PRICE]->(:${stripe_price_meta_1.stripePriceMeta.labelName})
+        await this.neo4j.validateRelatedNodes({
+            nodes: [{ id: params.newPriceId, label: stripe_price_meta_1.stripePriceMeta.labelName }],
+        });
+        const query = this.neo4j.initQuery({ serialiser: stripe_subscription_1.StripeSubscriptionDescriptor.model });
+        query.queryParams = { ...query.queryParams, searchValue: params.id, newPriceId: params.newPriceId };
+        query.query += `
+      ${this.buildDefaultMatch({ searchField: "id" })}
+      MATCH (${S})-[oldRel:USES_PRICE]->(:${stripe_price_meta_1.stripePriceMeta.labelName})
       DELETE oldRel
-      WITH ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}, ${stripe_customer_meta_1.stripeCustomerMeta.nodeName}
-      MATCH (${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName}:${stripe_price_meta_1.stripePriceMeta.labelName} {id: $newPriceId})-[:BELONGS_TO]->(${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName}_${stripe_product_meta_1.stripeProductMeta.nodeName}:${stripe_product_meta_1.stripeProductMeta.labelName})
-      CREATE (${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName})-[:USES_PRICE]->(${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName})
-      SET ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}.updatedAt = datetime()
-      RETURN ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}, ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName}, ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName}_${stripe_product_meta_1.stripeProductMeta.nodeName}
+      WITH ${S}
+      MATCH (newStripePrice:${stripe_price_meta_1.stripePriceMeta.labelName} {id: $newPriceId})
+      CREATE (${S})-[:USES_PRICE]->(newStripePrice)
+      SET ${S}.updatedAt = datetime()
+      WITH ${S}
+      ${this.buildReturnStatement()}
     `;
         return this.neo4j.writeOne(query);
     }
     /**
-     * Delete subscription
-     *
-     * Performs a DETACH DELETE to remove the subscription and all relationships.
-     *
-     * @param params - Deletion parameters
-     * @param params.id - Internal subscription ID
-     * @returns Promise that resolves when deletion is complete
-     */
-    async delete(params) {
-        const query = this.neo4j.initQuery();
-        query.queryParams = {
-            id: params.id,
-        };
-        query.query = `
-      MATCH (${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}:${stripe_subscription_meta_1.stripeSubscriptionMeta.labelName} {id: $id})
-      DETACH DELETE ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}
-    `;
-        await this.neo4j.writeOne(query);
-    }
-    /**
-     * Cancel all active subscriptions for a Stripe customer
-     *
-     * Bulk operation to cancel all active, trialing, or past_due subscriptions
-     * when a customer is deleted. Sets status to canceled and updates timestamps.
+     * Cancels every active, trialing or past_due subscription of a customer (customer deleted).
      *
-     * @param params - Cancellation parameters
-     * @param params.stripeCustomerId - Stripe customer ID
-     * @returns Number of subscriptions canceled
+     * @param params.stripeCustomerId - Stripe customer id (cus_xxx)
+     * @returns number of subscriptions cancelled
      */
     async cancelAllByStripeCustomerId(params) {
-        const query = this.neo4j.initQuery();
+        const query = this.neo4j.initQuery({ serialiser: stripe_subscription_1.StripeSubscriptionDescriptor.model });
         query.queryParams = {
+            ...query.queryParams,
             stripeCustomerId: params.stripeCustomerId,
             canceledStatus: "canceled",
             canceledAt: new Date().toISOString(),
         };
-        query.query = `
-      MATCH (${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}:${stripe_subscription_meta_1.stripeSubscriptionMeta.labelName})-[:BELONGS_TO]->(${stripe_customer_meta_1.stripeCustomerMeta.nodeName}:${stripe_customer_meta_1.stripeCustomerMeta.labelName} {stripeCustomerId: $stripeCustomerId})
-      WHERE ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}.status IN ['active', 'trialing', 'past_due']
-      SET ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}.status = $canceledStatus,
-          ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}.canceledAt = datetime($canceledAt),
-          ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}.cancelAtPeriodEnd = false,
-          ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}.updatedAt = datetime()
-      RETURN count(${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}) as count
+        query.query += `
+      ${this.buildDefaultMatch()}
+      MATCH (${S})-[:BELONGS_TO]->(:${stripe_customer_meta_1.stripeCustomerMeta.labelName} {stripeCustomerId: $stripeCustomerId})
+      WHERE ${S}.status IN ['active', 'trialing', 'past_due']
+      SET ${S}.status = $canceledStatus,
+          ${S}.canceledAt = datetime($canceledAt),
+          ${S}.cancelAtPeriodEnd = false,
+          ${S}.updatedAt = datetime()
+      WITH ${S}
+      ${this.buildReturnStatement()}
     `;
-        const result = await this.neo4j.writeOne(query);
-        return result?.count ?? 0;
+        const cancelled = await this.neo4j.writeAndReturnMany(query);
+        return (cancelled ?? []).length;
     }
     /**
-     * Find all active subscriptions for a Stripe customer
-     * Used for smart feature removal to check overlapping features
+     * Active or trialing subscriptions of a customer, newest first (smart feature removal).
      *
-     * @param params - Query parameters
-     * @param params.stripeCustomerId - Stripe customer ID (cus_xxx format)
-     * @returns Array of active subscriptions with price and product info
+     * @param params.stripeCustomerId - Stripe customer id (cus_xxx)
      */
     async findActiveByStripeCustomerId(params) {
-        const query = this.neo4j.initQuery({ serialiser: stripe_subscription_model_1.StripeSubscriptionModel });
+        const query = this.neo4j.initQuery({ serialiser: stripe_subscription_1.StripeSubscriptionDescriptor.model, fetchAll: true });
+        query.queryParams = { ...query.queryParams, stripeCustomerId: params.stripeCustomerId };
+        query.query += `
+      ${this.buildDefaultMatch()}
+      MATCH (${S})-[:BELONGS_TO]->(:${stripe_customer_meta_1.stripeCustomerMeta.labelName} {stripeCustomerId: $stripeCustomerId})
+      WHERE ${S}.status IN ['active', 'trialing']
+      WITH ${S}
+      ${this.buildReturnStatement()}
+      ORDER BY ${S}.createdAt DESC
+    `;
+        return this.neo4j.readMany(query);
+    }
+    /**
+     * Worker cron only. Active recurring subscriptions renewing between `now` (excluded) and
+     * `before` (included), not cancelling, whose card has not been checked yet for this renewal.
+     */
+    async findRenewalsForCardCheck(params) {
+        this.assertNoRequestCompany("findRenewalsForCardCheck");
+        const query = this.neo4j.initQuery({ serialiser: stripe_subscription_1.StripeSubscriptionDescriptor.model, fetchAll: true });
         query.queryParams = {
-            stripeCustomerId: params.stripeCustomerId,
+            ...query.queryParams,
+            now: params.now.toISOString(),
+            before: params.before.toISOString(),
         };
-        query.query = `
-      MATCH (${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}:${stripe_subscription_meta_1.stripeSubscriptionMeta.labelName})-[:BELONGS_TO]->(${stripe_customer_meta_1.stripeCustomerMeta.nodeName}:${stripe_customer_meta_1.stripeCustomerMeta.labelName} {stripeCustomerId: $stripeCustomerId})
-      WHERE ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}.status IN ['active', 'trialing']
-      MATCH (${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName})-[:USES_PRICE]->(${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName}:${stripe_price_meta_1.stripePriceMeta.labelName})-[:BELONGS_TO]->(${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName}_${stripe_product_meta_1.stripeProductMeta.nodeName}:${stripe_product_meta_1.stripeProductMeta.labelName})
-      RETURN ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}, ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName}, ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}_${stripe_price_meta_1.stripePriceMeta.nodeName}_${stripe_product_meta_1.stripeProductMeta.nodeName}
-      ORDER BY ${stripe_subscription_meta_1.stripeSubscriptionMeta.nodeName}.createdAt DESC
+        query.query += `
+      ${this.buildDefaultMatch()}
+      WHERE ${S}.status = "active"
+        AND ${S}.cancelAtPeriodEnd = false
+        AND ${S}.currentPeriodEnd > datetime($now)
+        AND ${S}.currentPeriodEnd <= datetime($before)
+        AND (${S}.cardExpiryCheckedFor IS NULL OR ${S}.cardExpiryCheckedFor <> ${S}.currentPeriodEnd)
+        AND EXISTS {
+          MATCH (${S})-[:USES_PRICE]->(recurringPrice:${stripe_price_meta_1.stripePriceMeta.labelName})
+          WHERE recurringPrice.priceType = "recurring"
+        }
+      ${this.buildReturnStatement()}
+      ORDER BY ${S}.currentPeriodEnd ASC
     `;
         return this.neo4j.readMany(query);
     }
@@ -426,6 +358,6 @@ let StripeSubscriptionRepository = class StripeSubscriptionRepository {
 exports.StripeSubscriptionRepository = StripeSubscriptionRepository;
 exports.StripeSubscriptionRepository = StripeSubscriptionRepository = __decorate([
     (0, common_1.Injectable)(),
-    __metadata("design:paramtypes", [neo4j_1.Neo4jService])
+    __metadata("design:paramtypes", [neo4j_service_1.Neo4jService, security_service_1.SecurityService, nestjs_cls_1.ClsService])
 ], StripeSubscriptionRepository);
 //# sourceMappingURL=stripe-subscription.repository.js.map