@magnet-cms/plugin-polar 0.1.0

package/dist/chunk-7KT7JQIH.js

@@ -0,0 +1,2474 @@
+import { Plugin, InjectPluginOptions, DatabaseModule, RestrictedRoute, EmailService } from '@magnet-cms/core';
+import { Logger, HttpException, HttpStatus, Injectable, Module, Post, Body, Get, Param, Controller, HttpCode, Req, Headers, Optional } from '@nestjs/common';
+import { Polar } from '@polar-sh/sdk';
+import { Field, Schema, Prop, InjectModel } from '@magnet-cms/common';
+import { RFCDate } from '@polar-sh/sdk/types/rfcdate';
+import { validateEvent, WebhookVerificationError } from '@polar-sh/sdk/webhooks';
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+function _ts_decorate(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;
+}
+function _ts_metadata(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+function _ts_param(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+var PolarService;
+var init_polar_service = __esm({
+  "src/polar.service.ts"() {
+    __name(_ts_decorate, "_ts_decorate");
+    __name(_ts_metadata, "_ts_metadata");
+    __name(_ts_param, "_ts_param");
+    PolarService = class _PolarService {
+      static {
+        __name(this, "PolarService");
+      }
+      config;
+      logger;
+      polar;
+      constructor(config) {
+        this.config = config;
+        this.logger = new Logger(_PolarService.name);
+        this.polar = null;
+      }
+      onModuleInit() {
+        if (!this.config.accessToken) {
+          throw new Error("[PolarPlugin] Missing accessToken in plugin options. Configure it via: { plugin: PolarPlugin, options: { accessToken: process.env.POLAR_ACCESS_TOKEN } }");
+        }
+        this.polar = new Polar({
+          accessToken: this.config.accessToken
+        });
+        if (this.config.webhookSecret) {
+          this.logger.debug("Webhook secret configured. Ensure rawBody is enabled in NestFactory.create() for signature verification.");
+        }
+      }
+      /** Get the initialized Polar client */
+      get client() {
+        if (!this.polar) {
+          throw new Error("[PolarPlugin] Polar client not initialized. Ensure the module has been initialized.");
+        }
+        return this.polar;
+      }
+      /** Get the plugin configuration */
+      get pluginConfig() {
+        return this.config;
+      }
+      /**
+      * Verify that raw body is available on the request.
+      * Must be called before webhook signature verification.
+      * Consumers must enable `rawBody: true` in NestFactory.create().
+      */
+      verifyRawBodyAvailable(req) {
+        if (!req.rawBody) {
+          throw new HttpException("[PolarPlugin] Raw request body not available. Enable rawBody in your NestJS bootstrap: NestFactory.create(AppModule, { rawBody: true }). This is required for Polar webhook signature verification.", HttpStatus.INTERNAL_SERVER_ERROR);
+        }
+      }
+    };
+    PolarService = _ts_decorate([
+      Injectable(),
+      _ts_param(0, InjectPluginOptions("polar")),
+      _ts_metadata("design:type", Function),
+      _ts_metadata("design:paramtypes", [
+        typeof PolarPluginConfig === "undefined" ? Object : PolarPluginConfig
+      ])
+    ], PolarService);
+  }
+});
+function _ts_decorate2(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;
+}
+function _ts_metadata2(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+var PolarOrder;
+var init_order_schema = __esm({
+  "src/schemas/order.schema.ts"() {
+    __name(_ts_decorate2, "_ts_decorate");
+    __name(_ts_metadata2, "_ts_metadata");
+    PolarOrder = class {
+      static {
+        __name(this, "PolarOrder");
+      }
+      /** Polar Order ID */
+      polarOrderId;
+      /** Reference to PolarCustomer.polarCustomerId */
+      customerId;
+      /** Reference to PolarProduct.polarProductId */
+      productId;
+      /** Reference to PolarSubscription.polarSubscriptionId (nullable for one-time purchases) */
+      subscriptionId;
+      /** Order status */
+      status;
+      /** Total order amount in smallest currency unit (cents) */
+      totalAmount;
+      /** Three-letter ISO currency code */
+      currency;
+      /** Reason for billing (purchase, subscription_create, subscription_cycle, etc.) */
+      billingReason;
+      /** When the order was created */
+      createdAt;
+    };
+    _ts_decorate2([
+      Field.Text({
+        required: true,
+        unique: true
+      }),
+      _ts_metadata2("design:type", String)
+    ], PolarOrder.prototype, "polarOrderId", void 0);
+    _ts_decorate2([
+      Field.Text({
+        required: true
+      }),
+      _ts_metadata2("design:type", String)
+    ], PolarOrder.prototype, "customerId", void 0);
+    _ts_decorate2([
+      Field.Text({
+        required: true
+      }),
+      _ts_metadata2("design:type", String)
+    ], PolarOrder.prototype, "productId", void 0);
+    _ts_decorate2([
+      Field.Text(),
+      _ts_metadata2("design:type", String)
+    ], PolarOrder.prototype, "subscriptionId", void 0);
+    _ts_decorate2([
+      Field.Select({
+        required: true,
+        options: [
+          {
+            label: "Paid",
+            value: "paid"
+          },
+          {
+            label: "Refunded",
+            value: "refunded"
+          },
+          {
+            label: "Pending",
+            value: "pending"
+          }
+        ]
+      }),
+      _ts_metadata2("design:type", String)
+    ], PolarOrder.prototype, "status", void 0);
+    _ts_decorate2([
+      Field.Number({
+        required: true
+      }),
+      _ts_metadata2("design:type", Number)
+    ], PolarOrder.prototype, "totalAmount", void 0);
+    _ts_decorate2([
+      Field.Text({
+        required: true
+      }),
+      _ts_metadata2("design:type", String)
+    ], PolarOrder.prototype, "currency", void 0);
+    _ts_decorate2([
+      Field.Text(),
+      _ts_metadata2("design:type", String)
+    ], PolarOrder.prototype, "billingReason", void 0);
+    _ts_decorate2([
+      Field.Date({
+        required: true,
+        default: /* @__PURE__ */ __name(() => /* @__PURE__ */ new Date(), "default")
+      }),
+      _ts_metadata2("design:type", typeof Date === "undefined" ? Object : Date)
+    ], PolarOrder.prototype, "createdAt", void 0);
+    PolarOrder = _ts_decorate2([
+      Schema({
+        versioning: false,
+        i18n: false,
+        visible: false
+      })
+    ], PolarOrder);
+  }
+});
+function _ts_decorate3(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;
+}
+function _ts_metadata3(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+var PolarProduct;
+var init_product_schema = __esm({
+  "src/schemas/product.schema.ts"() {
+    __name(_ts_decorate3, "_ts_decorate");
+    __name(_ts_metadata3, "_ts_metadata");
+    PolarProduct = class {
+      static {
+        __name(this, "PolarProduct");
+      }
+      /** Polar Product ID */
+      polarProductId;
+      /** Product name */
+      name;
+      /** Product description */
+      description;
+      /** Whether the product is a recurring subscription */
+      isRecurring = false;
+      /** Whether the product is archived in Polar */
+      isArchived = false;
+      /** Polar Organization ID */
+      organizationId;
+      /** Arbitrary metadata from Polar */
+      metadata;
+      /** When the product was last synced */
+      updatedAt;
+    };
+    _ts_decorate3([
+      Field.Text({
+        required: true,
+        unique: true
+      }),
+      _ts_metadata3("design:type", String)
+    ], PolarProduct.prototype, "polarProductId", void 0);
+    _ts_decorate3([
+      Field.Text({
+        required: true
+      }),
+      _ts_metadata3("design:type", String)
+    ], PolarProduct.prototype, "name", void 0);
+    _ts_decorate3([
+      Field.Text(),
+      _ts_metadata3("design:type", String)
+    ], PolarProduct.prototype, "description", void 0);
+    _ts_decorate3([
+      Field.Boolean({
+        default: false
+      })
+    ], PolarProduct.prototype, "isRecurring", void 0);
+    _ts_decorate3([
+      Field.Boolean({
+        default: false
+      })
+    ], PolarProduct.prototype, "isArchived", void 0);
+    _ts_decorate3([
+      Field.Text(),
+      _ts_metadata3("design:type", String)
+    ], PolarProduct.prototype, "organizationId", void 0);
+    _ts_decorate3([
+      Prop({
+        type: Object
+      }),
+      _ts_metadata3("design:type", typeof Record === "undefined" ? Object : Record)
+    ], PolarProduct.prototype, "metadata", void 0);
+    _ts_decorate3([
+      Field.Date({
+        required: true,
+        default: /* @__PURE__ */ __name(() => /* @__PURE__ */ new Date(), "default")
+      }),
+      _ts_metadata3("design:type", typeof Date === "undefined" ? Object : Date)
+    ], PolarProduct.prototype, "updatedAt", void 0);
+    PolarProduct = _ts_decorate3([
+      Schema({
+        versioning: false,
+        i18n: false,
+        visible: false
+      })
+    ], PolarProduct);
+  }
+});
+function _ts_decorate4(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;
+}
+function _ts_metadata4(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+var PolarCustomer;
+var init_customer_schema = __esm({
+  "src/schemas/customer.schema.ts"() {
+    __name(_ts_decorate4, "_ts_decorate");
+    __name(_ts_metadata4, "_ts_metadata");
+    PolarCustomer = class {
+      static {
+        __name(this, "PolarCustomer");
+      }
+      /** Polar Customer ID */
+      polarCustomerId;
+      /** Customer email address */
+      email;
+      /** Customer display name */
+      name;
+      /** Reference to the Magnet user ID (via Polar externalId) */
+      userId;
+      /** Arbitrary metadata from Polar */
+      metadata;
+      /** When the customer was created in Polar */
+      createdAt;
+    };
+    _ts_decorate4([
+      Field.Text({
+        required: true,
+        unique: true
+      }),
+      _ts_metadata4("design:type", String)
+    ], PolarCustomer.prototype, "polarCustomerId", void 0);
+    _ts_decorate4([
+      Field.Email({
+        required: true
+      }),
+      _ts_metadata4("design:type", String)
+    ], PolarCustomer.prototype, "email", void 0);
+    _ts_decorate4([
+      Field.Text(),
+      _ts_metadata4("design:type", String)
+    ], PolarCustomer.prototype, "name", void 0);
+    _ts_decorate4([
+      Field.Text(),
+      _ts_metadata4("design:type", String)
+    ], PolarCustomer.prototype, "userId", void 0);
+    _ts_decorate4([
+      Prop({
+        type: Object
+      }),
+      _ts_metadata4("design:type", typeof Record === "undefined" ? Object : Record)
+    ], PolarCustomer.prototype, "metadata", void 0);
+    _ts_decorate4([
+      Field.Date({
+        required: true,
+        default: /* @__PURE__ */ __name(() => /* @__PURE__ */ new Date(), "default")
+      }),
+      _ts_metadata4("design:type", typeof Date === "undefined" ? Object : Date)
+    ], PolarCustomer.prototype, "createdAt", void 0);
+    PolarCustomer = _ts_decorate4([
+      Schema({
+        versioning: false,
+        i18n: false,
+        visible: false
+      })
+    ], PolarCustomer);
+  }
+});
+function _ts_decorate5(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;
+}
+function _ts_metadata5(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+function _ts_param2(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+var PolarCustomerService;
+var init_customer_service = __esm({
+  "src/services/customer.service.ts"() {
+    init_customer_schema();
+    __name(_ts_decorate5, "_ts_decorate");
+    __name(_ts_metadata5, "_ts_metadata");
+    __name(_ts_param2, "_ts_param");
+    PolarCustomerService = class {
+      static {
+        __name(this, "PolarCustomerService");
+      }
+      customerModel;
+      constructor(customerModel) {
+        this.customerModel = customerModel;
+      }
+      /**
+      * Upsert a Polar customer record from a webhook customer payload.
+      */
+      async upsertFromWebhook(data) {
+        const customerData = {
+          polarCustomerId: data.id,
+          email: data.email,
+          name: data.name ?? void 0,
+          userId: data.externalId ?? void 0,
+          metadata: data.metadata
+        };
+        const existing = await this.customerModel.findOne({
+          polarCustomerId: data.id
+        });
+        if (existing) {
+          return this.customerModel.update({
+            polarCustomerId: data.id
+          }, customerData);
+        }
+        return this.customerModel.create(customerData);
+      }
+      /**
+      * Delete a customer record by Polar Customer ID.
+      */
+      async deleteByPolarId(polarCustomerId) {
+        await this.customerModel.delete({
+          polarCustomerId
+        });
+      }
+      /**
+      * Find a customer by Magnet user ID.
+      */
+      async findByUserId(userId) {
+        return this.customerModel.findOne({
+          userId
+        });
+      }
+      /**
+      * Find a customer by Polar Customer ID.
+      */
+      async findByPolarId(polarCustomerId) {
+        return this.customerModel.findOne({
+          polarCustomerId
+        });
+      }
+      /**
+      * List all customers.
+      */
+      async findAll() {
+        return this.customerModel.find();
+      }
+      /**
+      * Link a Polar customer to a Magnet user.
+      */
+      async linkToUser(polarCustomerId, userId) {
+        return this.customerModel.update({
+          polarCustomerId
+        }, {
+          userId
+        });
+      }
+    };
+    PolarCustomerService = _ts_decorate5([
+      Injectable(),
+      _ts_param2(0, InjectModel(PolarCustomer)),
+      _ts_metadata5("design:type", Function),
+      _ts_metadata5("design:paramtypes", [
+        typeof Model === "undefined" ? Object : Model
+      ])
+    ], PolarCustomerService);
+  }
+});
+function _ts_decorate6(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;
+}
+function _ts_metadata6(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+var PolarSubscription;
+var init_subscription_schema = __esm({
+  "src/schemas/subscription.schema.ts"() {
+    __name(_ts_decorate6, "_ts_decorate");
+    __name(_ts_metadata6, "_ts_metadata");
+    PolarSubscription = class {
+      static {
+        __name(this, "PolarSubscription");
+      }
+      /** Polar Subscription ID */
+      polarSubscriptionId;
+      /** Reference to PolarCustomer.polarCustomerId */
+      customerId;
+      /** Reference to PolarProduct.polarProductId */
+      productId;
+      /** Subscription status from Polar */
+      status;
+      /** Subscription amount in smallest currency unit (cents) */
+      amount;
+      /** Three-letter ISO currency code */
+      currency;
+      /** Recurring interval (month, year, week, day) */
+      recurringInterval;
+      /** Start of the current billing period */
+      currentPeriodStart;
+      /** End of the current billing period */
+      currentPeriodEnd;
+      /** Whether the subscription will be canceled at the end of the period */
+      cancelAtPeriodEnd = false;
+      /** When the subscription started */
+      startedAt;
+      /** When the subscription ended (null if still active) */
+      endedAt;
+      /** When the subscription was last synced */
+      updatedAt;
+    };
+    _ts_decorate6([
+      Field.Text({
+        required: true,
+        unique: true
+      }),
+      _ts_metadata6("design:type", String)
+    ], PolarSubscription.prototype, "polarSubscriptionId", void 0);
+    _ts_decorate6([
+      Field.Text({
+        required: true
+      }),
+      _ts_metadata6("design:type", String)
+    ], PolarSubscription.prototype, "customerId", void 0);
+    _ts_decorate6([
+      Field.Text({
+        required: true
+      }),
+      _ts_metadata6("design:type", String)
+    ], PolarSubscription.prototype, "productId", void 0);
+    _ts_decorate6([
+      Field.Select({
+        required: true,
+        options: [
+          {
+            label: "Active",
+            value: "active"
+          },
+          {
+            label: "Canceled",
+            value: "canceled"
+          },
+          {
+            label: "Past Due",
+            value: "past_due"
+          },
+          {
+            label: "Trialing",
+            value: "trialing"
+          },
+          {
+            label: "Incomplete",
+            value: "incomplete"
+          },
+          {
+            label: "Unpaid",
+            value: "unpaid"
+          },
+          {
+            label: "Revoked",
+            value: "revoked"
+          }
+        ]
+      }),
+      _ts_metadata6("design:type", String)
+    ], PolarSubscription.prototype, "status", void 0);
+    _ts_decorate6([
+      Field.Number(),
+      _ts_metadata6("design:type", Number)
+    ], PolarSubscription.prototype, "amount", void 0);
+    _ts_decorate6([
+      Field.Text(),
+      _ts_metadata6("design:type", String)
+    ], PolarSubscription.prototype, "currency", void 0);
+    _ts_decorate6([
+      Field.Text(),
+      _ts_metadata6("design:type", String)
+    ], PolarSubscription.prototype, "recurringInterval", void 0);
+    _ts_decorate6([
+      Field.Date({
+        required: true
+      }),
+      _ts_metadata6("design:type", typeof Date === "undefined" ? Object : Date)
+    ], PolarSubscription.prototype, "currentPeriodStart", void 0);
+    _ts_decorate6([
+      Field.Date({
+        required: true
+      }),
+      _ts_metadata6("design:type", typeof Date === "undefined" ? Object : Date)
+    ], PolarSubscription.prototype, "currentPeriodEnd", void 0);
+    _ts_decorate6([
+      Field.Boolean({
+        default: false
+      })
+    ], PolarSubscription.prototype, "cancelAtPeriodEnd", void 0);
+    _ts_decorate6([
+      Field.Date(),
+      _ts_metadata6("design:type", typeof Date === "undefined" ? Object : Date)
+    ], PolarSubscription.prototype, "startedAt", void 0);
+    _ts_decorate6([
+      Field.Date(),
+      _ts_metadata6("design:type", typeof Date === "undefined" ? Object : Date)
+    ], PolarSubscription.prototype, "endedAt", void 0);
+    _ts_decorate6([
+      Field.Date({
+        required: true,
+        default: /* @__PURE__ */ __name(() => /* @__PURE__ */ new Date(), "default")
+      }),
+      _ts_metadata6("design:type", typeof Date === "undefined" ? Object : Date)
+    ], PolarSubscription.prototype, "updatedAt", void 0);
+    PolarSubscription = _ts_decorate6([
+      Schema({
+        versioning: false,
+        i18n: false,
+        visible: false
+      })
+    ], PolarSubscription);
+  }
+});
+function _ts_decorate7(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;
+}
+function _ts_metadata7(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+function _ts_param3(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+var PolarSubscriptionService;
+var init_subscription_service = __esm({
+  "src/services/subscription.service.ts"() {
+    init_polar_service();
+    init_subscription_schema();
+    __name(_ts_decorate7, "_ts_decorate");
+    __name(_ts_metadata7, "_ts_metadata");
+    __name(_ts_param3, "_ts_param");
+    PolarSubscriptionService = class {
+      static {
+        __name(this, "PolarSubscriptionService");
+      }
+      subscriptionModel;
+      polarService;
+      constructor(subscriptionModel, polarService) {
+        this.subscriptionModel = subscriptionModel;
+        this.polarService = polarService;
+      }
+      /**
+      * Upsert a subscription from a webhook subscription payload.
+      */
+      async syncSubscription(data) {
+        const subData = {
+          polarSubscriptionId: data.id,
+          customerId: data.customerId,
+          productId: data.productId,
+          status: data.status,
+          amount: data.amount,
+          currency: data.currency,
+          recurringInterval: data.recurringInterval,
+          currentPeriodStart: data.currentPeriodStart,
+          currentPeriodEnd: data.currentPeriodEnd,
+          cancelAtPeriodEnd: data.cancelAtPeriodEnd,
+          startedAt: data.startedAt ?? void 0,
+          endedAt: data.endedAt ?? void 0,
+          updatedAt: /* @__PURE__ */ new Date()
+        };
+        const existing = await this.subscriptionModel.findOne({
+          polarSubscriptionId: data.id
+        });
+        if (existing) {
+          return this.subscriptionModel.update({
+            polarSubscriptionId: data.id
+          }, subData);
+        }
+        return this.subscriptionModel.create(subData);
+      }
+      /**
+      * Delete a subscription record by Polar Subscription ID.
+      */
+      async deleteByPolarId(polarSubscriptionId) {
+        await this.subscriptionModel.delete({
+          polarSubscriptionId
+        });
+      }
+      /**
+      * Find active subscription for a customer.
+      */
+      async findActiveByCustomerId(customerId) {
+        return this.subscriptionModel.findOne({
+          customerId,
+          status: "active"
+        });
+      }
+      /**
+      * List all subscriptions.
+      */
+      async findAll() {
+        return this.subscriptionModel.find();
+      }
+      /**
+      * Revoke (cancel immediately) a subscription via Polar SDK.
+      */
+      async revoke(polarSubscriptionId) {
+        await this.polarService.client.subscriptions.revoke({
+          id: polarSubscriptionId
+        });
+      }
+    };
+    PolarSubscriptionService = _ts_decorate7([
+      Injectable(),
+      _ts_param3(0, InjectModel(PolarSubscription)),
+      _ts_metadata7("design:type", Function),
+      _ts_metadata7("design:paramtypes", [
+        typeof Model === "undefined" ? Object : Model,
+        typeof PolarService === "undefined" ? Object : PolarService
+      ])
+    ], PolarSubscriptionService);
+  }
+});
+function _ts_decorate8(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;
+}
+function _ts_metadata8(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+function _ts_param4(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+var PolarAccessService;
+var init_access_service = __esm({
+  "src/services/access.service.ts"() {
+    init_polar_service();
+    init_product_schema();
+    init_customer_service();
+    init_subscription_service();
+    __name(_ts_decorate8, "_ts_decorate");
+    __name(_ts_metadata8, "_ts_metadata");
+    __name(_ts_param4, "_ts_param");
+    PolarAccessService = class {
+      static {
+        __name(this, "PolarAccessService");
+      }
+      polarService;
+      customerService;
+      subscriptionService;
+      productModel;
+      constructor(polarService, customerService, subscriptionService, productModel) {
+        this.polarService = polarService;
+        this.customerService = customerService;
+        this.subscriptionService = subscriptionService;
+        this.productModel = productModel;
+      }
+      /**
+      * Get subscription access info for a user.
+      * Returns subscription status, plan name, and feature flags.
+      */
+      async getAccess(userId) {
+        const noAccess = {
+          hasActiveSubscription: false,
+          plan: null,
+          expiresAt: null,
+          features: []
+        };
+        const customer = await this.customerService.findByUserId(userId);
+        if (!customer) {
+          return noAccess;
+        }
+        const subscription = await this.subscriptionService.findActiveByCustomerId(customer.polarCustomerId);
+        if (!subscription) {
+          return noAccess;
+        }
+        let planName = null;
+        const product = await this.productModel.findOne({
+          polarProductId: subscription.productId
+        });
+        planName = product?.name ?? null;
+        const features = this.resolveFeaturesForPlan(planName);
+        return {
+          hasActiveSubscription: true,
+          plan: planName,
+          expiresAt: subscription.currentPeriodEnd,
+          features
+        };
+      }
+      /**
+      * Resolve feature flags for a plan name from plugin config.
+      */
+      resolveFeaturesForPlan(planName) {
+        if (!planName) return [];
+        const featuresConfig = this.polarService.pluginConfig.features;
+        if (!featuresConfig) return [];
+        const normalizedPlan = planName.toLowerCase();
+        for (const [key, features] of Object.entries(featuresConfig)) {
+          if (key.toLowerCase() === normalizedPlan) {
+            return features;
+          }
+        }
+        return [];
+      }
+    };
+    PolarAccessService = _ts_decorate8([
+      Injectable(),
+      _ts_param4(3, InjectModel(PolarProduct)),
+      _ts_metadata8("design:type", Function),
+      _ts_metadata8("design:paramtypes", [
+        typeof PolarService === "undefined" ? Object : PolarService,
+        typeof PolarCustomerService === "undefined" ? Object : PolarCustomerService,
+        typeof PolarSubscriptionService === "undefined" ? Object : PolarSubscriptionService,
+        typeof Model === "undefined" ? Object : Model
+      ])
+    ], PolarAccessService);
+  }
+});
+function _ts_decorate9(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;
+}
+function _ts_metadata9(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+var PolarBenefitGrant;
+var init_benefit_grant_schema = __esm({
+  "src/schemas/benefit-grant.schema.ts"() {
+    __name(_ts_decorate9, "_ts_decorate");
+    __name(_ts_metadata9, "_ts_metadata");
+    PolarBenefitGrant = class {
+      static {
+        __name(this, "PolarBenefitGrant");
+      }
+      /** Polar Benefit Grant ID */
+      polarBenefitGrantId;
+      /** Reference to PolarBenefit.polarBenefitId */
+      benefitId;
+      /** Reference to PolarCustomer.polarCustomerId */
+      customerId;
+      /** Reference to PolarSubscription.polarSubscriptionId (optional) */
+      subscriptionId;
+      /** Whether the benefit is currently granted */
+      isGranted = true;
+      /** Whether the benefit has been revoked */
+      isRevoked = false;
+      /** When the benefit was granted */
+      grantedAt;
+      /** When the benefit was revoked (null if still active) */
+      revokedAt;
+    };
+    _ts_decorate9([
+      Field.Text({
+        required: true,
+        unique: true
+      }),
+      _ts_metadata9("design:type", String)
+    ], PolarBenefitGrant.prototype, "polarBenefitGrantId", void 0);
+    _ts_decorate9([
+      Field.Text({
+        required: true
+      }),
+      _ts_metadata9("design:type", String)
+    ], PolarBenefitGrant.prototype, "benefitId", void 0);
+    _ts_decorate9([
+      Field.Text({
+        required: true
+      }),
+      _ts_metadata9("design:type", String)
+    ], PolarBenefitGrant.prototype, "customerId", void 0);
+    _ts_decorate9([
+      Field.Text(),
+      _ts_metadata9("design:type", String)
+    ], PolarBenefitGrant.prototype, "subscriptionId", void 0);
+    _ts_decorate9([
+      Field.Boolean({
+        default: true
+      })
+    ], PolarBenefitGrant.prototype, "isGranted", void 0);
+    _ts_decorate9([
+      Field.Boolean({
+        default: false
+      })
+    ], PolarBenefitGrant.prototype, "isRevoked", void 0);
+    _ts_decorate9([
+      Field.Date(),
+      _ts_metadata9("design:type", typeof Date === "undefined" ? Object : Date)
+    ], PolarBenefitGrant.prototype, "grantedAt", void 0);
+    _ts_decorate9([
+      Field.Date(),
+      _ts_metadata9("design:type", typeof Date === "undefined" ? Object : Date)
+    ], PolarBenefitGrant.prototype, "revokedAt", void 0);
+    PolarBenefitGrant = _ts_decorate9([
+      Schema({
+        versioning: false,
+        i18n: false,
+        visible: false
+      })
+    ], PolarBenefitGrant);
+  }
+});
+function _ts_decorate10(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;
+}
+function _ts_metadata10(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+var PolarBenefit;
+var init_benefit_schema = __esm({
+  "src/schemas/benefit.schema.ts"() {
+    __name(_ts_decorate10, "_ts_decorate");
+    __name(_ts_metadata10, "_ts_metadata");
+    PolarBenefit = class {
+      static {
+        __name(this, "PolarBenefit");
+      }
+      /** Polar Benefit ID */
+      polarBenefitId;
+      /** Benefit type (license_keys, downloadables, discord, custom, github_repository, meter_credit, etc.) */
+      type;
+      /** Benefit description */
+      description;
+      /** Polar Organization ID */
+      organizationId;
+      /** Whether the benefit is selectable by the customer */
+      selectable = false;
+      /** Whether the benefit can be deleted */
+      deletable = true;
+      /** When the benefit was created */
+      createdAt;
+    };
+    _ts_decorate10([
+      Field.Text({
+        required: true,
+        unique: true
+      }),
+      _ts_metadata10("design:type", String)
+    ], PolarBenefit.prototype, "polarBenefitId", void 0);
+    _ts_decorate10([
+      Field.Text({
+        required: true
+      }),
+      _ts_metadata10("design:type", String)
+    ], PolarBenefit.prototype, "type", void 0);
+    _ts_decorate10([
+      Field.Text(),
+      _ts_metadata10("design:type", String)
+    ], PolarBenefit.prototype, "description", void 0);
+    _ts_decorate10([
+      Field.Text(),
+      _ts_metadata10("design:type", String)
+    ], PolarBenefit.prototype, "organizationId", void 0);
+    _ts_decorate10([
+      Field.Boolean({
+        default: false
+      })
+    ], PolarBenefit.prototype, "selectable", void 0);
+    _ts_decorate10([
+      Field.Boolean({
+        default: true
+      })
+    ], PolarBenefit.prototype, "deletable", void 0);
+    _ts_decorate10([
+      Field.Date({
+        required: true,
+        default: /* @__PURE__ */ __name(() => /* @__PURE__ */ new Date(), "default")
+      }),
+      _ts_metadata10("design:type", typeof Date === "undefined" ? Object : Date)
+    ], PolarBenefit.prototype, "createdAt", void 0);
+    PolarBenefit = _ts_decorate10([
+      Schema({
+        versioning: false,
+        i18n: false,
+        visible: false
+      })
+    ], PolarBenefit);
+  }
+});
+function _ts_decorate11(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;
+}
+function _ts_metadata11(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+function _ts_param5(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+var PolarBenefitService;
+var init_benefit_service = __esm({
+  "src/services/benefit.service.ts"() {
+    init_benefit_grant_schema();
+    init_benefit_schema();
+    __name(_ts_decorate11, "_ts_decorate");
+    __name(_ts_metadata11, "_ts_metadata");
+    __name(_ts_param5, "_ts_param");
+    PolarBenefitService = class {
+      static {
+        __name(this, "PolarBenefitService");
+      }
+      benefitModel;
+      benefitGrantModel;
+      constructor(benefitModel, benefitGrantModel) {
+        this.benefitModel = benefitModel;
+        this.benefitGrantModel = benefitGrantModel;
+      }
+      /**
+      * Upsert a benefit from a webhook benefit payload.
+      */
+      async syncBenefit(data) {
+        const benefitData = {
+          polarBenefitId: data.id,
+          type: data.type,
+          description: data.description,
+          organizationId: data.organizationId,
+          selectable: data.selectable,
+          deletable: data.deletable
+        };
+        const existing = await this.benefitModel.findOne({
+          polarBenefitId: data.id
+        });
+        if (existing) {
+          return this.benefitModel.update({
+            polarBenefitId: data.id
+          }, benefitData);
+        }
+        return this.benefitModel.create(benefitData);
+      }
+      /**
+      * Upsert a benefit grant from a webhook payload.
+      * Handles created, updated, and revoked states.
+      */
+      async syncBenefitGrant(data) {
+        const grantData = {
+          polarBenefitGrantId: data.id,
+          benefitId: data.benefitId,
+          customerId: data.customerId,
+          subscriptionId: data.subscriptionId,
+          isGranted: data.isGranted,
+          isRevoked: data.isRevoked,
+          grantedAt: data.grantedAt,
+          revokedAt: data.revokedAt
+        };
+        const existing = await this.benefitGrantModel.findOne({
+          polarBenefitGrantId: data.id
+        });
+        if (existing) {
+          return this.benefitGrantModel.update({
+            polarBenefitGrantId: data.id
+          }, grantData);
+        }
+        return this.benefitGrantModel.create(grantData);
+      }
+      /**
+      * Find active benefit grants for a customer.
+      */
+      async findGrantsByCustomerId(customerId) {
+        return this.benefitGrantModel.findMany({
+          customerId,
+          isGranted: true,
+          isRevoked: false
+        });
+      }
+      /**
+      * List all benefits.
+      */
+      async findAll() {
+        return this.benefitModel.find();
+      }
+      /**
+      * List all benefit grants.
+      */
+      async findGrantsAll() {
+        return this.benefitGrantModel.find();
+      }
+    };
+    PolarBenefitService = _ts_decorate11([
+      Injectable(),
+      _ts_param5(0, InjectModel(PolarBenefit)),
+      _ts_param5(1, InjectModel(PolarBenefitGrant)),
+      _ts_metadata11("design:type", Function),
+      _ts_metadata11("design:paramtypes", [
+        typeof Model === "undefined" ? Object : Model,
+        typeof Model === "undefined" ? Object : Model
+      ])
+    ], PolarBenefitService);
+  }
+});
+function _ts_decorate12(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;
+}
+function _ts_metadata12(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+var PolarCheckoutService;
+var init_checkout_service = __esm({
+  "src/services/checkout.service.ts"() {
+    init_polar_service();
+    __name(_ts_decorate12, "_ts_decorate");
+    __name(_ts_metadata12, "_ts_metadata");
+    PolarCheckoutService = class {
+      static {
+        __name(this, "PolarCheckoutService");
+      }
+      polarService;
+      constructor(polarService) {
+        this.polarService = polarService;
+      }
+      /**
+      * Create a Polar Checkout session.
+      */
+      async createCheckoutSession(dto) {
+        const checkout = await this.polarService.client.checkouts.create({
+          products: dto.products,
+          successUrl: dto.successUrl,
+          returnUrl: dto.returnUrl,
+          customerEmail: dto.customerEmail,
+          externalCustomerId: dto.userId,
+          metadata: dto.metadata
+        });
+        return {
+          sessionId: checkout.id,
+          url: checkout.url
+        };
+      }
+    };
+    PolarCheckoutService = _ts_decorate12([
+      Injectable(),
+      _ts_metadata12("design:type", Function),
+      _ts_metadata12("design:paramtypes", [
+        typeof PolarService === "undefined" ? Object : PolarService
+      ])
+    ], PolarCheckoutService);
+  }
+});
+function _ts_decorate13(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;
+}
+function _ts_metadata13(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+function _ts_param6(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+var PolarMetricsService;
+var init_metrics_service = __esm({
+  "src/services/metrics.service.ts"() {
+    init_polar_service();
+    init_order_schema();
+    init_subscription_schema();
+    __name(_ts_decorate13, "_ts_decorate");
+    __name(_ts_metadata13, "_ts_metadata");
+    __name(_ts_param6, "_ts_param");
+    PolarMetricsService = class _PolarMetricsService {
+      static {
+        __name(this, "PolarMetricsService");
+      }
+      orderModel;
+      subscriptionModel;
+      polarService;
+      logger;
+      constructor(orderModel, subscriptionModel, polarService) {
+        this.orderModel = orderModel;
+        this.subscriptionModel = subscriptionModel;
+        this.polarService = polarService;
+        this.logger = new Logger(_PolarMetricsService.name);
+      }
+      /**
+      * Get dashboard metrics — hybrid of live Polar API and local DB data.
+      */
+      async getMetrics() {
+        try {
+          return await this.getMetricsFromApi();
+        } catch (error) {
+          this.logger.warn(`Failed to fetch metrics from Polar API, falling back to local DB: ${error instanceof Error ? error.message : String(error)}`);
+          return this.getMetricsFromDb();
+        }
+      }
+      /**
+      * Fetch metrics from Polar's analytics API.
+      */
+      async getMetricsFromApi() {
+        const now = /* @__PURE__ */ new Date();
+        const startDate = new Date(now.getFullYear(), now.getMonth() - 11, 1);
+        const response = await this.polarService.client.metrics.get({
+          startDate: new RFCDate(startDate),
+          endDate: new RFCDate(now),
+          interval: "month"
+        });
+        const periods = response.periods;
+        const latestPeriod = periods[periods.length - 1];
+        const mrr = Number(latestPeriod?.monthlyRecurringRevenue ?? 0);
+        const revenueThisMonth = Number(latestPeriod?.revenue ?? 0);
+        const activeSubscriptions = Number(latestPeriod?.activeSubscriptions ?? 0);
+        const churned = Number(latestPeriod?.churnedSubscriptions ?? 0);
+        const churnRate = activeSubscriptions + churned > 0 ? Math.round(churned / (activeSubscriptions + churned) * 100) : 0;
+        const revenueByMonth = periods.map((period) => {
+          const d = period.timestamp;
+          const key = `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}`;
+          return {
+            month: key,
+            revenue: Number(period.revenue ?? 0)
+          };
+        });
+        const recentOrders = await this.getRecentOrders();
+        return {
+          mrr,
+          revenueThisMonth,
+          activeSubscriptions,
+          churnRate,
+          revenueByMonth,
+          recentOrders
+        };
+      }
+      /**
+      * Fall back to local DB computation if API call fails.
+      */
+      async getMetricsFromDb() {
+        const [activeSubscriptions, revenueThisMonth, recentOrders] = await Promise.all([
+          this.countActiveSubscriptions(),
+          this.calculateRevenueThisMonth(),
+          this.getRecentOrders()
+        ]);
+        const churnRate = await this.calculateChurnRate();
+        const revenueByMonth = await this.getRevenueByMonth();
+        return {
+          mrr: 0,
+          revenueThisMonth,
+          activeSubscriptions,
+          churnRate,
+          revenueByMonth,
+          recentOrders
+        };
+      }
+      async countActiveSubscriptions() {
+        const subs = await this.subscriptionModel.findMany({
+          status: "active"
+        });
+        return subs.length;
+      }
+      async calculateRevenueThisMonth() {
+        const orders = await this.orderModel.findMany({
+          status: "paid"
+        });
+        const now = /* @__PURE__ */ new Date();
+        const startOfMonth = new Date(now.getFullYear(), now.getMonth(), 1);
+        return orders.filter((o) => new Date(o.createdAt) >= startOfMonth).reduce((sum, o) => sum + o.totalAmount, 0);
+      }
+      async calculateChurnRate() {
+        const allSubs = await this.subscriptionModel.find();
+        if (allSubs.length === 0) return 0;
+        const canceled = allSubs.filter((s) => s.status === "canceled");
+        return Math.round(canceled.length / allSubs.length * 100);
+      }
+      async getRevenueByMonth() {
+        const orders = await this.orderModel.findMany({
+          status: "paid"
+        });
+        const monthMap = /* @__PURE__ */ new Map();
+        const now = /* @__PURE__ */ new Date();
+        for (let i = 11; i >= 0; i--) {
+          const d = new Date(now.getFullYear(), now.getMonth() - i, 1);
+          const key = `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}`;
+          monthMap.set(key, 0);
+        }
+        for (const order of orders) {
+          const d = new Date(order.createdAt);
+          const key = `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}`;
+          if (monthMap.has(key)) {
+            monthMap.set(key, (monthMap.get(key) ?? 0) + order.totalAmount);
+          }
+        }
+        return Array.from(monthMap.entries()).map(([month, revenue]) => ({
+          month,
+          revenue
+        }));
+      }
+      async getRecentOrders() {
+        const orders = await this.orderModel.find();
+        return orders.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime()).slice(0, 10).map((o) => ({
+          id: o.id,
+          totalAmount: o.totalAmount,
+          currency: o.currency,
+          status: o.status,
+          customerEmail: o.customerId,
+          createdAt: o.createdAt.toISOString()
+        }));
+      }
+    };
+    PolarMetricsService = _ts_decorate13([
+      Injectable(),
+      _ts_param6(0, InjectModel(PolarOrder)),
+      _ts_param6(1, InjectModel(PolarSubscription)),
+      _ts_metadata13("design:type", Function),
+      _ts_metadata13("design:paramtypes", [
+        typeof Model === "undefined" ? Object : Model,
+        typeof Model === "undefined" ? Object : Model,
+        typeof PolarService === "undefined" ? Object : PolarService
+      ])
+    ], PolarMetricsService);
+  }
+});
+function _ts_decorate14(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;
+}
+function _ts_metadata14(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+var PolarPortalService;
+var init_portal_service = __esm({
+  "src/services/portal.service.ts"() {
+    init_polar_service();
+    init_customer_service();
+    __name(_ts_decorate14, "_ts_decorate");
+    __name(_ts_metadata14, "_ts_metadata");
+    PolarPortalService = class {
+      static {
+        __name(this, "PolarPortalService");
+      }
+      polarService;
+      customerService;
+      constructor(polarService, customerService) {
+        this.polarService = polarService;
+        this.customerService = customerService;
+      }
+      /**
+      * Create a Polar Customer Portal session.
+      */
+      async createPortalSession(dto) {
+        let customerId = dto.customerId;
+        if (!customerId && dto.userId) {
+          const customer = await this.customerService.findByUserId(dto.userId);
+          if (!customer) {
+            throw new HttpException("No Polar customer found for this user", HttpStatus.NOT_FOUND);
+          }
+          customerId = customer.polarCustomerId;
+        }
+        if (!customerId) {
+          throw new HttpException("Either customerId or userId must be provided", HttpStatus.BAD_REQUEST);
+        }
+        const session = await this.polarService.client.customerSessions.create({
+          customerId,
+          returnUrl: dto.returnUrl
+        });
+        return {
+          sessionId: session.id,
+          url: session.customerPortalUrl
+        };
+      }
+    };
+    PolarPortalService = _ts_decorate14([
+      Injectable(),
+      _ts_metadata14("design:type", Function),
+      _ts_metadata14("design:paramtypes", [
+        typeof PolarService === "undefined" ? Object : PolarService,
+        typeof PolarCustomerService === "undefined" ? Object : PolarCustomerService
+      ])
+    ], PolarPortalService);
+  }
+});
+function _ts_decorate15(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;
+}
+function _ts_metadata15(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+function _ts_param7(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+var PolarProductService;
+var init_product_service = __esm({
+  "src/services/product.service.ts"() {
+    init_product_schema();
+    __name(_ts_decorate15, "_ts_decorate");
+    __name(_ts_metadata15, "_ts_metadata");
+    __name(_ts_param7, "_ts_param");
+    PolarProductService = class {
+      static {
+        __name(this, "PolarProductService");
+      }
+      productModel;
+      constructor(productModel) {
+        this.productModel = productModel;
+      }
+      /**
+      * Upsert a product from a webhook product payload.
+      */
+      async syncProduct(data) {
+        const productData = {
+          polarProductId: data.id,
+          name: data.name,
+          description: data.description ?? void 0,
+          isRecurring: data.isRecurring,
+          isArchived: data.isArchived,
+          organizationId: data.organizationId,
+          metadata: data.metadata,
+          updatedAt: /* @__PURE__ */ new Date()
+        };
+        const existing = await this.productModel.findOne({
+          polarProductId: data.id
+        });
+        if (existing) {
+          return this.productModel.update({
+            polarProductId: data.id
+          }, productData);
+        }
+        return this.productModel.create(productData);
+      }
+      /**
+      * Delete a product by Polar Product ID.
+      */
+      async deleteProduct(polarProductId) {
+        await this.productModel.delete({
+          polarProductId
+        });
+      }
+      /**
+      * List all non-archived products.
+      */
+      async findActiveProducts() {
+        return this.productModel.findMany({
+          isArchived: false
+        });
+      }
+      /**
+      * List all products.
+      */
+      async findAllProducts() {
+        return this.productModel.find();
+      }
+    };
+    PolarProductService = _ts_decorate15([
+      Injectable(),
+      _ts_param7(0, InjectModel(PolarProduct)),
+      _ts_metadata15("design:type", Function),
+      _ts_metadata15("design:paramtypes", [
+        typeof Model === "undefined" ? Object : Model
+      ])
+    ], PolarProductService);
+  }
+});
+function _ts_decorate16(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;
+}
+function _ts_metadata16(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+var PolarProcessedEvent;
+var init_processed_event_schema = __esm({
+  "src/schemas/processed-event.schema.ts"() {
+    __name(_ts_decorate16, "_ts_decorate");
+    __name(_ts_metadata16, "_ts_metadata");
+    PolarProcessedEvent = class {
+      static {
+        __name(this, "PolarProcessedEvent");
+      }
+      /** Polar Event ID — unique to prevent reprocessing */
+      polarEventId;
+      /** Event type (e.g., 'order.paid', 'subscription.updated') */
+      eventType;
+      /** When this event was processed */
+      processedAt;
+    };
+    _ts_decorate16([
+      Field.Text({
+        required: true,
+        unique: true
+      }),
+      _ts_metadata16("design:type", String)
+    ], PolarProcessedEvent.prototype, "polarEventId", void 0);
+    _ts_decorate16([
+      Field.Text({
+        required: true
+      }),
+      _ts_metadata16("design:type", String)
+    ], PolarProcessedEvent.prototype, "eventType", void 0);
+    _ts_decorate16([
+      Field.Date({
+        required: true,
+        default: /* @__PURE__ */ __name(() => /* @__PURE__ */ new Date(), "default")
+      }),
+      _ts_metadata16("design:type", typeof Date === "undefined" ? Object : Date)
+    ], PolarProcessedEvent.prototype, "processedAt", void 0);
+    PolarProcessedEvent = _ts_decorate16([
+      Schema({
+        versioning: false,
+        i18n: false,
+        visible: false
+      })
+    ], PolarProcessedEvent);
+  }
+});
+function _ts_decorate17(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;
+}
+function _ts_metadata17(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+function _ts_param8(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+var PolarOrderService;
+var init_order_service = __esm({
+  "src/services/order.service.ts"() {
+    init_order_schema();
+    __name(_ts_decorate17, "_ts_decorate");
+    __name(_ts_metadata17, "_ts_metadata");
+    __name(_ts_param8, "_ts_param");
+    PolarOrderService = class {
+      static {
+        __name(this, "PolarOrderService");
+      }
+      orderModel;
+      constructor(orderModel) {
+        this.orderModel = orderModel;
+      }
+      /**
+      * Upsert an order from a webhook order payload.
+      */
+      async syncOrder(data) {
+        const orderData = {
+          polarOrderId: data.id,
+          customerId: data.customerId,
+          productId: data.productId,
+          subscriptionId: data.subscriptionId ?? void 0,
+          status: data.status === "paid" ? "paid" : data.status === "refunded" ? "refunded" : "pending",
+          totalAmount: data.totalAmount,
+          currency: data.currency,
+          billingReason: data.billingReason,
+          createdAt: data.createdAt ?? /* @__PURE__ */ new Date()
+        };
+        const existing = await this.orderModel.findOne({
+          polarOrderId: data.id
+        });
+        if (existing) {
+          return this.orderModel.update({
+            polarOrderId: data.id
+          }, orderData);
+        }
+        return this.orderModel.create(orderData);
+      }
+      /**
+      * List all orders.
+      */
+      async findAll() {
+        return this.orderModel.find();
+      }
+      /**
+      * Find orders for a customer.
+      */
+      async findByCustomerId(customerId) {
+        return this.orderModel.findMany({
+          customerId
+        });
+      }
+    };
+    PolarOrderService = _ts_decorate17([
+      Injectable(),
+      _ts_param8(0, InjectModel(PolarOrder)),
+      _ts_metadata17("design:type", Function),
+      _ts_metadata17("design:paramtypes", [
+        typeof Model === "undefined" ? Object : Model
+      ])
+    ], PolarOrderService);
+  }
+});
+function _ts_decorate18(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;
+}
+function _ts_metadata18(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+function _ts_param9(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+var PolarApiController;
+var init_polar_api_controller = __esm({
+  "src/polar-api.controller.ts"() {
+    init_polar_service();
+    init_order_schema();
+    init_access_service();
+    init_benefit_service();
+    init_checkout_service();
+    init_customer_service();
+    init_metrics_service();
+    init_portal_service();
+    init_product_service();
+    init_subscription_service();
+    __name(_ts_decorate18, "_ts_decorate");
+    __name(_ts_metadata18, "_ts_metadata");
+    __name(_ts_param9, "_ts_param");
+    PolarApiController = class {
+      static {
+        __name(this, "PolarApiController");
+      }
+      accessService;
+      benefitService;
+      checkoutService;
+      customerService;
+      metricsService;
+      orderModel;
+      portalService;
+      productService;
+      polarService;
+      subscriptionService;
+      constructor(accessService, benefitService, checkoutService, customerService, metricsService, orderModel, portalService, productService, polarService, subscriptionService) {
+        this.accessService = accessService;
+        this.benefitService = benefitService;
+        this.checkoutService = checkoutService;
+        this.customerService = customerService;
+        this.metricsService = metricsService;
+        this.orderModel = orderModel;
+        this.portalService = portalService;
+        this.productService = productService;
+        this.polarService = polarService;
+        this.subscriptionService = subscriptionService;
+      }
+      // =========================================================================
+      // Public Endpoints
+      // =========================================================================
+      /**
+      * Create a Polar Checkout session.
+      * POST /polar/checkout
+      */
+      async createCheckout(dto) {
+        try {
+          return await this.checkoutService.createCheckoutSession(dto);
+        } catch (error) {
+          if (error instanceof HttpException) throw error;
+          throw new HttpException(error instanceof Error ? error.message : "Failed to create checkout session", HttpStatus.INTERNAL_SERVER_ERROR);
+        }
+      }
+      /**
+      * Create a Polar Customer Portal session.
+      * POST /polar/portal
+      */
+      async createPortal(dto) {
+        try {
+          return await this.portalService.createPortalSession(dto);
+        } catch (error) {
+          if (error instanceof HttpException) throw error;
+          throw new HttpException(error instanceof Error ? error.message : "Failed to create portal session", HttpStatus.INTERNAL_SERVER_ERROR);
+        }
+      }
+      /**
+      * List active products.
+      * GET /polar/products
+      */
+      async listProducts() {
+        return this.productService.findActiveProducts();
+      }
+      /**
+      * Get a user's active subscription.
+      * GET /polar/subscription/:userId
+      */
+      async getUserSubscription(userId) {
+        const customer = await this.customerService.findByUserId(userId);
+        if (!customer) {
+          return {
+            subscription: null
+          };
+        }
+        const subscription = await this.subscriptionService.findActiveByCustomerId(customer.polarCustomerId);
+        return {
+          subscription
+        };
+      }
+      /**
+      * Get subscription access info and feature flags for a user.
+      * GET /polar/access/:userId
+      */
+      async getAccess(userId) {
+        return this.accessService.getAccess(userId);
+      }
+      // =========================================================================
+      // Admin Endpoints
+      // =========================================================================
+      /**
+      * Get dashboard metrics.
+      * GET /polar/admin/metrics
+      */
+      async getMetrics() {
+        return this.metricsService.getMetrics();
+      }
+      /**
+      * List all customers (admin).
+      * GET /polar/admin/customers
+      */
+      async listCustomers() {
+        return this.customerService.findAll();
+      }
+      /**
+      * List all subscriptions (admin).
+      * GET /polar/admin/subscriptions
+      */
+      async listSubscriptions() {
+        return this.subscriptionService.findAll();
+      }
+      /**
+      * Cancel (revoke) a subscription (admin).
+      * POST /polar/admin/subscriptions/:id/cancel
+      */
+      async cancelSubscription(polarSubscriptionId) {
+        await this.subscriptionService.revoke(polarSubscriptionId);
+        return {
+          canceled: true
+        };
+      }
+      /**
+      * List all products (admin).
+      * GET /polar/admin/products
+      */
+      async listAllProducts() {
+        return this.productService.findAllProducts();
+      }
+      /**
+      * Sync products from Polar API (admin).
+      * POST /polar/admin/sync-products
+      */
+      async syncProducts() {
+        let productCount = 0;
+        for await (const page of await this.polarService.client.products.list({})) {
+          for (const product of page.result.items) {
+            await this.productService.syncProduct({
+              id: product.id,
+              name: product.name,
+              description: product.description ?? void 0,
+              isRecurring: product.isRecurring,
+              isArchived: product.isArchived,
+              organizationId: product.organizationId,
+              metadata: product.metadata
+            });
+            productCount++;
+          }
+        }
+        return {
+          synced: true,
+          products: productCount
+        };
+      }
+      /**
+      * List all orders (admin).
+      * GET /polar/admin/orders
+      */
+      async listOrders() {
+        return this.orderModel.find();
+      }
+      /**
+      * List all benefits (admin).
+      * GET /polar/admin/benefits
+      */
+      async listBenefits() {
+        return this.benefitService.findAll();
+      }
+      /**
+      * List all benefit grants (admin).
+      * GET /polar/admin/benefit-grants
+      */
+      async listBenefitGrants() {
+        return this.benefitService.findGrantsAll();
+      }
+    };
+    _ts_decorate18([
+      Post("checkout"),
+      _ts_param9(0, Body()),
+      _ts_metadata18("design:type", Function),
+      _ts_metadata18("design:paramtypes", [
+        typeof CreateCheckoutDto === "undefined" ? Object : CreateCheckoutDto
+      ]),
+      _ts_metadata18("design:returntype", Promise)
+    ], PolarApiController.prototype, "createCheckout", null);
+    _ts_decorate18([
+      Post("portal"),
+      _ts_param9(0, Body()),
+      _ts_metadata18("design:type", Function),
+      _ts_metadata18("design:paramtypes", [
+        typeof CreatePortalDto === "undefined" ? Object : CreatePortalDto
+      ]),
+      _ts_metadata18("design:returntype", Promise)
+    ], PolarApiController.prototype, "createPortal", null);
+    _ts_decorate18([
+      Get("products"),
+      _ts_metadata18("design:type", Function),
+      _ts_metadata18("design:paramtypes", []),
+      _ts_metadata18("design:returntype", Promise)
+    ], PolarApiController.prototype, "listProducts", null);
+    _ts_decorate18([
+      Get("subscription/:userId"),
+      _ts_param9(0, Param("userId")),
+      _ts_metadata18("design:type", Function),
+      _ts_metadata18("design:paramtypes", [
+        String
+      ]),
+      _ts_metadata18("design:returntype", Promise)
+    ], PolarApiController.prototype, "getUserSubscription", null);
+    _ts_decorate18([
+      Get("access/:userId"),
+      RestrictedRoute(),
+      _ts_param9(0, Param("userId")),
+      _ts_metadata18("design:type", Function),
+      _ts_metadata18("design:paramtypes", [
+        String
+      ]),
+      _ts_metadata18("design:returntype", Promise)
+    ], PolarApiController.prototype, "getAccess", null);
+    _ts_decorate18([
+      Get("admin/metrics"),
+      RestrictedRoute(),
+      _ts_metadata18("design:type", Function),
+      _ts_metadata18("design:paramtypes", []),
+      _ts_metadata18("design:returntype", Promise)
+    ], PolarApiController.prototype, "getMetrics", null);
+    _ts_decorate18([
+      Get("admin/customers"),
+      RestrictedRoute(),
+      _ts_metadata18("design:type", Function),
+      _ts_metadata18("design:paramtypes", []),
+      _ts_metadata18("design:returntype", Promise)
+    ], PolarApiController.prototype, "listCustomers", null);
+    _ts_decorate18([
+      Get("admin/subscriptions"),
+      RestrictedRoute(),
+      _ts_metadata18("design:type", Function),
+      _ts_metadata18("design:paramtypes", []),
+      _ts_metadata18("design:returntype", Promise)
+    ], PolarApiController.prototype, "listSubscriptions", null);
+    _ts_decorate18([
+      Post("admin/subscriptions/:id/cancel"),
+      RestrictedRoute(),
+      _ts_param9(0, Param("id")),
+      _ts_metadata18("design:type", Function),
+      _ts_metadata18("design:paramtypes", [
+        String
+      ]),
+      _ts_metadata18("design:returntype", Promise)
+    ], PolarApiController.prototype, "cancelSubscription", null);
+    _ts_decorate18([
+      Get("admin/products"),
+      RestrictedRoute(),
+      _ts_metadata18("design:type", Function),
+      _ts_metadata18("design:paramtypes", []),
+      _ts_metadata18("design:returntype", Promise)
+    ], PolarApiController.prototype, "listAllProducts", null);
+    _ts_decorate18([
+      Post("admin/sync-products"),
+      RestrictedRoute(),
+      _ts_metadata18("design:type", Function),
+      _ts_metadata18("design:paramtypes", []),
+      _ts_metadata18("design:returntype", Promise)
+    ], PolarApiController.prototype, "syncProducts", null);
+    _ts_decorate18([
+      Get("admin/orders"),
+      RestrictedRoute(),
+      _ts_metadata18("design:type", Function),
+      _ts_metadata18("design:paramtypes", []),
+      _ts_metadata18("design:returntype", Promise)
+    ], PolarApiController.prototype, "listOrders", null);
+    _ts_decorate18([
+      Get("admin/benefits"),
+      RestrictedRoute(),
+      _ts_metadata18("design:type", Function),
+      _ts_metadata18("design:paramtypes", []),
+      _ts_metadata18("design:returntype", Promise)
+    ], PolarApiController.prototype, "listBenefits", null);
+    _ts_decorate18([
+      Get("admin/benefit-grants"),
+      RestrictedRoute(),
+      _ts_metadata18("design:type", Function),
+      _ts_metadata18("design:paramtypes", []),
+      _ts_metadata18("design:returntype", Promise)
+    ], PolarApiController.prototype, "listBenefitGrants", null);
+    PolarApiController = _ts_decorate18([
+      Controller("polar"),
+      _ts_param9(5, InjectModel(PolarOrder)),
+      _ts_metadata18("design:type", Function),
+      _ts_metadata18("design:paramtypes", [
+        typeof PolarAccessService === "undefined" ? Object : PolarAccessService,
+        typeof PolarBenefitService === "undefined" ? Object : PolarBenefitService,
+        typeof PolarCheckoutService === "undefined" ? Object : PolarCheckoutService,
+        typeof PolarCustomerService === "undefined" ? Object : PolarCustomerService,
+        typeof PolarMetricsService === "undefined" ? Object : PolarMetricsService,
+        typeof Model === "undefined" ? Object : Model,
+        typeof PolarPortalService === "undefined" ? Object : PolarPortalService,
+        typeof PolarProductService === "undefined" ? Object : PolarProductService,
+        typeof PolarService === "undefined" ? Object : PolarService,
+        typeof PolarSubscriptionService === "undefined" ? Object : PolarSubscriptionService
+      ])
+    ], PolarApiController);
+  }
+});
+function _ts_decorate19(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;
+}
+function _ts_metadata19(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+function _ts_param10(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+var PolarWebhookService;
+var init_polar_webhook_service = __esm({
+  "src/polar-webhook.service.ts"() {
+    init_processed_event_schema();
+    init_benefit_service();
+    init_customer_service();
+    init_order_service();
+    init_product_service();
+    init_subscription_service();
+    __name(_ts_decorate19, "_ts_decorate");
+    __name(_ts_metadata19, "_ts_metadata");
+    __name(_ts_param10, "_ts_param");
+    PolarWebhookService = class _PolarWebhookService {
+      static {
+        __name(this, "PolarWebhookService");
+      }
+      processedEventModel;
+      customerService;
+      productService;
+      subscriptionService;
+      orderService;
+      benefitService;
+      emailService;
+      logger;
+      constructor(processedEventModel, customerService, productService, subscriptionService, orderService, benefitService, emailService) {
+        this.processedEventModel = processedEventModel;
+        this.customerService = customerService;
+        this.productService = productService;
+        this.subscriptionService = subscriptionService;
+        this.orderService = orderService;
+        this.benefitService = benefitService;
+        this.emailService = emailService;
+        this.logger = new Logger(_PolarWebhookService.name);
+      }
+      /**
+      * Process a verified Polar event with idempotency.
+      * Returns silently if the event was already processed.
+      */
+      async processEvent(event) {
+        const eventId = "data" in event && event.data && "id" in event.data ? event.data.id : `${event.type}-${Date.now()}`;
+        const existing = await this.findProcessedEvent(eventId);
+        if (existing) {
+          this.logger.log(`Event ${eventId} already processed, skipping`);
+          return;
+        }
+        try {
+          await this.dispatchEvent(event);
+          await this.recordProcessedEvent(eventId, event.type);
+        } catch (error) {
+          this.logger.error(`Failed to process event ${eventId} (${event.type}): ${error instanceof Error ? error.message : String(error)}`);
+        }
+      }
+      /**
+      * Dispatch event to the appropriate handler.
+      */
+      async dispatchEvent(event) {
+        switch (event.type) {
+          case "customer.created":
+          case "customer.updated":
+            await this.customerService.upsertFromWebhook({
+              id: event.data.id,
+              email: event.data.email,
+              name: event.data.name ?? void 0,
+              externalId: event.data.externalId ?? void 0,
+              metadata: event.data.metadata
+            });
+            break;
+          case "customer.deleted":
+            await this.customerService.deleteByPolarId(event.data.id);
+            break;
+          case "product.created":
+          case "product.updated":
+            await this.productService.syncProduct({
+              id: event.data.id,
+              name: event.data.name,
+              description: event.data.description ?? void 0,
+              isRecurring: event.data.isRecurring,
+              isArchived: event.data.isArchived,
+              organizationId: event.data.organizationId,
+              metadata: event.data.metadata
+            });
+            break;
+          case "subscription.created":
+          case "subscription.updated":
+          case "subscription.active":
+          case "subscription.canceled":
+          case "subscription.uncanceled":
+          case "subscription.revoked":
+          case "subscription.past_due":
+            await this.subscriptionService.syncSubscription({
+              id: event.data.id,
+              customerId: event.data.customerId,
+              productId: event.data.productId,
+              status: event.data.status,
+              amount: event.data.amount,
+              currency: event.data.currency,
+              recurringInterval: event.data.recurringInterval,
+              currentPeriodStart: event.data.currentPeriodStart,
+              currentPeriodEnd: event.data.currentPeriodEnd,
+              cancelAtPeriodEnd: event.data.cancelAtPeriodEnd,
+              startedAt: event.data.startedAt ?? void 0,
+              endedAt: event.data.endedAt ?? void 0
+            });
+            break;
+          case "order.created":
+          case "order.paid":
+          case "order.updated":
+            await this.orderService.syncOrder({
+              id: event.data.id,
+              customerId: event.data.customerId,
+              productId: event.data.productId ?? "",
+              subscriptionId: event.data.subscriptionId ?? void 0,
+              status: event.data.paid ? "paid" : "pending",
+              totalAmount: event.data.totalAmount,
+              currency: event.data.currency,
+              billingReason: event.data.billingReason,
+              createdAt: event.data.createdAt
+            });
+            break;
+          case "order.refunded":
+            await this.orderService.syncOrder({
+              id: event.data.id,
+              customerId: event.data.customerId,
+              productId: event.data.productId ?? "",
+              subscriptionId: event.data.subscriptionId ?? void 0,
+              status: "refunded",
+              totalAmount: event.data.totalAmount,
+              currency: event.data.currency,
+              billingReason: event.data.billingReason,
+              createdAt: event.data.createdAt
+            });
+            break;
+          case "benefit.created":
+          case "benefit.updated":
+            await this.benefitService.syncBenefit({
+              id: event.data.id,
+              type: event.data.type,
+              description: event.data.description,
+              organizationId: event.data.organizationId,
+              selectable: event.data.selectable,
+              deletable: event.data.deletable
+            });
+            break;
+          case "benefit_grant.created":
+          case "benefit_grant.updated":
+            await this.benefitService.syncBenefitGrant({
+              id: event.data.id,
+              benefitId: event.data.benefitId,
+              customerId: event.data.customerId,
+              subscriptionId: event.data.subscriptionId ?? void 0,
+              isGranted: event.data.isGranted,
+              isRevoked: event.data.isRevoked,
+              grantedAt: event.data.isGranted ? event.data.modifiedAt ?? /* @__PURE__ */ new Date() : void 0
+            });
+            break;
+          case "benefit_grant.revoked":
+            await this.benefitService.syncBenefitGrant({
+              id: event.data.id,
+              benefitId: event.data.benefitId,
+              customerId: event.data.customerId,
+              subscriptionId: event.data.subscriptionId ?? void 0,
+              isGranted: false,
+              isRevoked: true,
+              revokedAt: event.data.modifiedAt ?? /* @__PURE__ */ new Date()
+            });
+            break;
+          default:
+            this.logger.log(`Unhandled event type: ${event.type}`);
+        }
+      }
+      // =========================================================================
+      // Idempotency Helpers
+      // =========================================================================
+      async findProcessedEvent(eventId) {
+        const result = await this.processedEventModel.findOne({
+          polarEventId: eventId
+        });
+        return result !== null;
+      }
+      async recordProcessedEvent(eventId, eventType) {
+        try {
+          await this.processedEventModel.create({
+            polarEventId: eventId,
+            eventType,
+            processedAt: /* @__PURE__ */ new Date()
+          });
+        } catch (error) {
+          this.logger.warn(`Failed to record processed event ${eventId}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+      }
+    };
+    PolarWebhookService = _ts_decorate19([
+      Injectable(),
+      _ts_param10(0, InjectModel(PolarProcessedEvent)),
+      _ts_param10(6, Optional()),
+      _ts_metadata19("design:type", Function),
+      _ts_metadata19("design:paramtypes", [
+        typeof Model === "undefined" ? Object : Model,
+        typeof PolarCustomerService === "undefined" ? Object : PolarCustomerService,
+        typeof PolarProductService === "undefined" ? Object : PolarProductService,
+        typeof PolarSubscriptionService === "undefined" ? Object : PolarSubscriptionService,
+        typeof PolarOrderService === "undefined" ? Object : PolarOrderService,
+        typeof PolarBenefitService === "undefined" ? Object : PolarBenefitService,
+        typeof EmailService === "undefined" ? Object : EmailService
+      ])
+    ], PolarWebhookService);
+  }
+});
+function _ts_decorate20(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;
+}
+function _ts_metadata20(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+function _ts_param11(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+var PolarWebhookController;
+var init_polar_webhook_controller = __esm({
+  "src/polar-webhook.controller.ts"() {
+    init_polar_webhook_service();
+    init_polar_service();
+    __name(_ts_decorate20, "_ts_decorate");
+    __name(_ts_metadata20, "_ts_metadata");
+    __name(_ts_param11, "_ts_param");
+    PolarWebhookController = class {
+      static {
+        __name(this, "PolarWebhookController");
+      }
+      polarService;
+      webhookService;
+      constructor(polarService, webhookService) {
+        this.polarService = polarService;
+        this.webhookService = webhookService;
+      }
+      async handleWebhook(req, headers) {
+        this.polarService.verifyRawBodyAvailable(req);
+        const { webhookSecret } = this.polarService.pluginConfig;
+        if (!webhookSecret) {
+          throw new Error("[PolarPlugin] webhookSecret is required for webhook verification");
+        }
+        let event;
+        try {
+          event = validateEvent(req.rawBody.toString(), headers, webhookSecret);
+        } catch (error) {
+          if (error instanceof WebhookVerificationError) {
+            throw error;
+          }
+          throw error;
+        }
+        await this.webhookService.processEvent(event);
+        return {
+          received: true
+        };
+      }
+    };
+    _ts_decorate20([
+      Post(),
+      HttpCode(200),
+      _ts_param11(0, Req()),
+      _ts_param11(1, Headers()),
+      _ts_metadata20("design:type", Function),
+      _ts_metadata20("design:paramtypes", [
+        Object,
+        typeof Record === "undefined" ? Object : Record
+      ]),
+      _ts_metadata20("design:returntype", Promise)
+    ], PolarWebhookController.prototype, "handleWebhook", null);
+    PolarWebhookController = _ts_decorate20([
+      Controller("polar/webhooks"),
+      _ts_metadata20("design:type", Function),
+      _ts_metadata20("design:paramtypes", [
+        typeof PolarService === "undefined" ? Object : PolarService,
+        typeof PolarWebhookService === "undefined" ? Object : PolarWebhookService
+      ])
+    ], PolarWebhookController);
+  }
+});
+
+// src/polar.module.ts
+var polar_module_exports = {};
+__export(polar_module_exports, {
+  PolarModule: () => PolarModule
+});
+function _ts_decorate21(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 PolarModule;
+var init_polar_module = __esm({
+  "src/polar.module.ts"() {
+    init_polar_api_controller();
+    init_polar_webhook_controller();
+    init_polar_webhook_service();
+    init_polar_service();
+    init_benefit_grant_schema();
+    init_benefit_schema();
+    init_customer_schema();
+    init_order_schema();
+    init_processed_event_schema();
+    init_product_schema();
+    init_subscription_schema();
+    init_access_service();
+    init_benefit_service();
+    init_checkout_service();
+    init_customer_service();
+    init_metrics_service();
+    init_order_service();
+    init_portal_service();
+    init_product_service();
+    init_subscription_service();
+    __name(_ts_decorate21, "_ts_decorate");
+    PolarModule = class {
+      static {
+        __name(this, "PolarModule");
+      }
+    };
+    PolarModule = _ts_decorate21([
+      Module({
+        imports: [
+          DatabaseModule.forFeature(PolarCustomer),
+          DatabaseModule.forFeature(PolarProduct),
+          DatabaseModule.forFeature(PolarSubscription),
+          DatabaseModule.forFeature(PolarOrder),
+          DatabaseModule.forFeature(PolarBenefit),
+          DatabaseModule.forFeature(PolarBenefitGrant),
+          DatabaseModule.forFeature(PolarProcessedEvent)
+        ],
+        controllers: [
+          PolarApiController,
+          PolarWebhookController
+        ],
+        providers: [
+          PolarService,
+          PolarWebhookService,
+          PolarCustomerService,
+          PolarProductService,
+          PolarSubscriptionService,
+          PolarOrderService,
+          PolarBenefitService,
+          PolarCheckoutService,
+          PolarPortalService,
+          PolarAccessService,
+          PolarMetricsService
+        ],
+        exports: [
+          PolarService,
+          PolarCustomerService,
+          PolarProductService,
+          PolarSubscriptionService,
+          PolarOrderService,
+          PolarBenefitService,
+          PolarCheckoutService,
+          PolarPortalService,
+          PolarAccessService
+        ]
+      })
+    ], PolarModule);
+  }
+});
+function _ts_decorate22(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;
+}
+__name(_ts_decorate22, "_ts_decorate");
+var PolarPlugin = class _PolarPlugin {
+  static {
+    __name(this, "PolarPlugin");
+  }
+  /** Environment variables used by this plugin */
+  static envVars = [
+    {
+      name: "POLAR_ACCESS_TOKEN",
+      required: true,
+      description: "Polar API access token"
+    },
+    {
+      name: "POLAR_WEBHOOK_SECRET",
+      required: true,
+      description: "Polar webhook signing secret"
+    },
+    {
+      name: "POLAR_ORGANIZATION_ID",
+      required: false,
+      description: "Polar organization ID"
+    }
+  ];
+  /**
+  * Create a configured plugin provider for MagnetModule.forRoot().
+  * Auto-resolves secret values from environment variables if not provided.
+  *
+  * @example
+  * ```typescript
+  * MagnetModule.forRoot([
+  *   PolarPlugin.forRoot({ currency: 'usd' }),
+  * ])
+  * ```
+  */
+  static forRoot(config) {
+    const resolvedConfig = {
+      accessToken: config?.accessToken ?? process.env.POLAR_ACCESS_TOKEN,
+      webhookSecret: config?.webhookSecret ?? process.env.POLAR_WEBHOOK_SECRET,
+      organizationId: config?.organizationId ?? process.env.POLAR_ORGANIZATION_ID,
+      syncProducts: config?.syncProducts,
+      currency: config?.currency,
+      features: config?.features
+    };
+    return {
+      type: "plugin",
+      plugin: _PolarPlugin,
+      options: resolvedConfig,
+      envVars: _PolarPlugin.envVars
+    };
+  }
+};
+PolarPlugin = _ts_decorate22([
+  Plugin({
+    name: "polar",
+    description: "Polar.sh payments plugin for Magnet CMS",
+    version: "0.1.0",
+    module: /* @__PURE__ */ __name(() => (init_polar_module(), __toCommonJS(polar_module_exports)).PolarModule, "module"),
+    frontend: {
+      routes: [
+        {
+          path: "polar",
+          componentId: "PolarDashboard",
+          requiresAuth: true,
+          children: [
+            {
+              path: "",
+              componentId: "PolarDashboard"
+            },
+            {
+              path: "customers",
+              componentId: "PolarCustomers"
+            },
+            {
+              path: "products",
+              componentId: "PolarProducts"
+            },
+            {
+              path: "subscriptions",
+              componentId: "PolarSubscriptions"
+            },
+            {
+              path: "orders",
+              componentId: "PolarOrders"
+            },
+            {
+              path: "benefits",
+              componentId: "PolarBenefits"
+            }
+          ]
+        }
+      ],
+      sidebar: [
+        {
+          id: "polar",
+          title: "Polar Payments",
+          url: "/polar",
+          icon: "Zap",
+          order: 31,
+          items: [
+            {
+              id: "polar-dashboard",
+              title: "Dashboard",
+              url: "/polar",
+              icon: "BarChart3"
+            },
+            {
+              id: "polar-customers",
+              title: "Customers",
+              url: "/polar/customers",
+              icon: "Users"
+            },
+            {
+              id: "polar-products",
+              title: "Products",
+              url: "/polar/products",
+              icon: "Package"
+            },
+            {
+              id: "polar-subscriptions",
+              title: "Subscriptions",
+              url: "/polar/subscriptions",
+              icon: "RefreshCw"
+            },
+            {
+              id: "polar-orders",
+              title: "Orders",
+              url: "/polar/orders",
+              icon: "Receipt"
+            },
+            {
+              id: "polar-benefits",
+              title: "Benefits",
+              url: "/polar/benefits",
+              icon: "Gift"
+            }
+          ]
+        }
+      ]
+    }
+  })
+], PolarPlugin);
+
+export { PolarAccessService, PolarBenefit, PolarBenefitGrant, PolarBenefitService, PolarCheckoutService, PolarCustomer, PolarCustomerService, PolarMetricsService, PolarModule, PolarOrder, PolarOrderService, PolarPlugin, PolarPortalService, PolarProcessedEvent, PolarProduct, PolarProductService, PolarService, PolarSubscription, PolarSubscriptionService, init_access_service, init_benefit_grant_schema, init_benefit_schema, init_benefit_service, init_checkout_service, init_customer_schema, init_customer_service, init_metrics_service, init_order_schema, init_order_service, init_polar_module, init_polar_service, init_portal_service, init_processed_event_schema, init_product_schema, init_product_service, init_subscription_schema, init_subscription_service };