@revstackhq/provider-polar 0.0.0-dev-20260301193938

package/LICENSE

@@ -0,0 +1,110 @@
+# Functional Source License, Version 1.1, MIT Future License
+
+## Abbreviation
+
+FSL-1.1-MIT
+
+## Notice
+
+Copyright 2026 Revstack Inc.
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
+EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the MIT license that is effective on the second anniversary of the date we make
+the Software available. On or after that date, you may use the Software under
+the MIT license, in which case the following will apply:
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/assets/logo.svg

@@ -0,0 +1,6 @@
+<svg width="100%" height="100%" viewBox="0 0 24 24" stroke-width="1.5" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M12 22C6.47715 22 2 17.5228 2 12C2 6.47715 6.47715 2 12 2C17.5228 2 22 6.47715 22 12C22 17.5228 17.5228 22 12 22Z" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round"/>
+<path d="M12 22C9.79086 22 8 17.5228 8 12C8 6.47715 9.79086 2 12 2C14.2091 2 16 6.47715 16 12C16 17.5228 14.2091 22 12 22Z" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round"/>
+<path d="M9 21C6 20 5 15.611 5 12.5C5 9.38904 6.5 5.5 10 3" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round"/>
+<path d="M15 3C18 4 19 8.38904 19 11.5C19 14.611 17.5 18.5 14 21" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+import * as _revstackhq_providers_core from '@revstackhq/providers-core';
+import { ProviderManifest, BaseProvider, ProviderContext, InstallInput, AsyncActionResult, InstallResult, UninstallInput, RevstackEvent, WebhookResponse, CreatePaymentInput, Payment, RefundPaymentInput, PaginationOptions, PaginatedResult, CreateSubscriptionInput, Subscription, CheckoutSessionInput, CheckoutSessionResult, CreateCustomerInput, UpdateCustomerInput, Customer, PaymentMethod, UpdateSubscriptionInput, SetupPaymentMethodInput, BillingPortalInput, BillingPortalResult, CreateAddonInput, Addon, UpdateAddonInput, DeleteAddonInput } from '@revstackhq/providers-core';
+
+declare const manifest: ProviderManifest;
+
+declare class PolarProvider extends BaseProvider {
+    static manifest: _revstackhq_providers_core.ProviderManifest;
+    manifest: _revstackhq_providers_core.ProviderManifest;
+    onInstall(ctx: ProviderContext, input: InstallInput): Promise<AsyncActionResult<InstallResult>>;
+    onUninstall(ctx: ProviderContext, input: UninstallInput): Promise<AsyncActionResult<boolean>>;
+    verifyWebhookSignature(ctx: ProviderContext, payload: string | Buffer, headers: Record<string, string | string[] | undefined>, secret: string): Promise<AsyncActionResult<boolean>>;
+    parseWebhookEvent(ctx: ProviderContext, payload: any): Promise<AsyncActionResult<RevstackEvent | null>>;
+    getWebhookResponse(): Promise<AsyncActionResult<WebhookResponse>>;
+    createPayment(ctx: ProviderContext, input: CreatePaymentInput): Promise<AsyncActionResult<string>>;
+    getPayment(ctx: ProviderContext, id: string): Promise<AsyncActionResult<Payment>>;
+    refundPayment(ctx: ProviderContext, input: RefundPaymentInput): Promise<AsyncActionResult<string>>;
+    listPayments(ctx: ProviderContext, pagination: PaginationOptions): Promise<AsyncActionResult<PaginatedResult<Payment>>>;
+    createSubscription(ctx: ProviderContext, input: CreateSubscriptionInput): Promise<AsyncActionResult<string>>;
+    getSubscription(ctx: ProviderContext, id: string): Promise<AsyncActionResult<Subscription>>;
+    cancelSubscription(ctx: ProviderContext, id: string, reason?: string): Promise<AsyncActionResult<string>>;
+    pauseSubscription(ctx: ProviderContext, id: string, reason?: string): Promise<AsyncActionResult<string>>;
+    resumeSubscription(ctx: ProviderContext, id: string, reason?: string): Promise<AsyncActionResult<string>>;
+    createCheckoutSession(ctx: ProviderContext, input: CheckoutSessionInput): Promise<AsyncActionResult<CheckoutSessionResult>>;
+    createCustomer(ctx: ProviderContext, input: CreateCustomerInput): Promise<AsyncActionResult<string>>;
+    updateCustomer(ctx: ProviderContext, id: string, input: UpdateCustomerInput): Promise<AsyncActionResult<string>>;
+    deleteCustomer(ctx: ProviderContext, id: string): Promise<AsyncActionResult<boolean>>;
+    getCustomer(ctx: ProviderContext, id: string): Promise<AsyncActionResult<Customer>>;
+    listPaymentMethods(ctx: ProviderContext, customerId: string): Promise<AsyncActionResult<PaymentMethod[]>>;
+    deletePaymentMethod(ctx: ProviderContext, id: string): Promise<AsyncActionResult<boolean>>;
+    capturePayment(ctx: ProviderContext, id: string, amount?: number): Promise<AsyncActionResult<string>>;
+    listSubscriptions(ctx: ProviderContext, pagination: PaginationOptions): Promise<AsyncActionResult<PaginatedResult<Subscription>>>;
+    updateSubscription(ctx: ProviderContext, id: string, input: UpdateSubscriptionInput): Promise<AsyncActionResult<string>>;
+    listCustomers(ctx: ProviderContext, pagination: PaginationOptions): Promise<AsyncActionResult<PaginatedResult<Customer>>>;
+    setupPaymentMethod(ctx: ProviderContext, input: SetupPaymentMethodInput): Promise<AsyncActionResult<CheckoutSessionResult>>;
+    createBillingPortalSession(ctx: ProviderContext, input: BillingPortalInput): Promise<AsyncActionResult<BillingPortalResult>>;
+    createAddon(ctx: ProviderContext, input: CreateAddonInput): Promise<AsyncActionResult<string>>;
+    getAddon(ctx: ProviderContext, id: string): Promise<AsyncActionResult<Addon>>;
+    updateAddon(ctx: ProviderContext, id: string, input: UpdateAddonInput): Promise<AsyncActionResult<string>>;
+    deleteAddon(ctx: ProviderContext, input: DeleteAddonInput): Promise<AsyncActionResult<boolean>>;
+    listAddons(ctx: ProviderContext, subscriptionId: string, pagination: PaginationOptions): Promise<AsyncActionResult<PaginatedResult<Addon>>>;
+}
+
+export { PolarProvider, manifest };

package/dist/index.js

@@ -0,0 +1,1006 @@
+// src/manifest.ts
+import { ProviderCategory } from "@revstackhq/providers-core";
+var manifest = {
+  name: "Polar",
+  slug: "polar",
+  version: "1.0.0",
+  categories: [ProviderCategory.Card, ProviderCategory.Wallet],
+  engine: {
+    revstack: "^1.0.0",
+    node: ">=18.0.0"
+  },
+  media: {
+    icon: "https://cdn.jsdelivr.net/npm/@revstackhq/provider-polar/assets/logo.svg",
+    logo: "https://cdn.jsdelivr.net/npm/@revstackhq/provider-polar/assets/logo.svg"
+  },
+  status: "beta",
+  dashboardUrl: "https://polar.sh/dashboard",
+  hidden: false,
+  pricing: {
+    model: "transactional",
+    fees: "4% + 40\xA2 per transaction",
+    url: "https://polar.sh/resources/pricing"
+  },
+  capabilities: {
+    customers: {
+      supported: true,
+      features: {
+        create: true,
+        update: true,
+        delete: false
+      }
+    },
+    checkout: {
+      supported: true,
+      strategy: "redirect"
+    },
+    payments: {
+      supported: true,
+      features: {
+        capture: true,
+        disputes: true,
+        partialRefunds: true,
+        refunds: true
+      }
+    },
+    subscriptions: {
+      supported: true,
+      mode: "native",
+      features: {
+        cancellation: true,
+        pause: true,
+        resume: true,
+        proration: true
+      }
+    },
+    webhooks: {
+      supported: true,
+      verification: "signature"
+    },
+    catalog: {
+      supported: true,
+      strategy: "pre_created"
+    }
+  },
+  author: "Revstack",
+  currencies: ["USD"],
+  description: "Merchant of record specifically tailored for software and SaaS developers.",
+  documentationUrl: "https://docs.revstack.dev/providers/polar",
+  regions: ["*"],
+  sandboxAvailable: true,
+  supportUrl: "https://polar.sh/docs/support",
+  configSchema: {
+    accessToken: {
+      label: "Access Token",
+      type: "password",
+      secure: true,
+      required: true,
+      description: "Polar Access Token",
+      pattern: "^polar_.*$",
+      errorMessage: "Must start with polar_"
+    },
+    organizationId: {
+      label: "Organization ID",
+      type: "text",
+      secure: false,
+      required: true,
+      description: "Polar Organization ID to process checkouts for."
+    }
+  },
+  dataSchema: {
+    webhookSecret: {
+      secure: true,
+      description: "Webhook signing secret"
+    },
+    webhookEndpointId: {
+      secure: false,
+      description: "Webhook endpoint ID"
+    },
+    accessToken: {
+      secure: true,
+      description: "Polar Access Token"
+    },
+    organizationId: {
+      secure: false,
+      description: "Polar Organization ID"
+    }
+  }
+};
+
+// src/clients/v1/payments.ts
+var createPayment = async (...args) => {
+  throw new Error("Not implemented");
+};
+var getPayment = async (...args) => {
+  throw new Error("Not implemented");
+};
+var refundPayment = async (...args) => {
+  throw new Error("Not implemented");
+};
+var listPayments = async (...args) => {
+  throw new Error("Not implemented");
+};
+var capturePayment = async (...args) => {
+  throw new Error("Not implemented");
+};
+
+// src/clients/v1/subscriptions.ts
+var createSubscription = async (...args) => {
+  throw new Error("Not implemented");
+};
+var getSubscription = async (...args) => {
+  throw new Error("Not implemented");
+};
+var cancelSubscription = async (...args) => {
+  throw new Error("Not implemented");
+};
+var pauseSubscription = async (...args) => {
+  throw new Error("Not implemented");
+};
+var resumeSubscription = async (...args) => {
+  throw new Error("Not implemented");
+};
+var listSubscriptions = async (...args) => {
+  throw new Error("Not implemented");
+};
+var updateSubscription = async (...args) => {
+  throw new Error("Not implemented");
+};
+
+// src/clients/v1/checkout.ts
+var createCheckoutSession = async (...args) => {
+  throw new Error("Not implemented");
+};
+var setupPaymentMethod = async (...args) => {
+  throw new Error("Not implemented");
+};
+var createBillingPortalSession = async (...args) => {
+  throw new Error("Not implemented");
+};
+
+// src/clients/v1/customers.ts
+var createCustomer = async (...args) => {
+  throw new Error("Not implemented");
+};
+var updateCustomer = async (...args) => {
+  throw new Error("Not implemented");
+};
+var deleteCustomer = async (...args) => {
+  throw new Error("Not implemented");
+};
+var getCustomer = async (...args) => {
+  throw new Error("Not implemented");
+};
+var listCustomers = async (...args) => {
+  throw new Error("Not implemented");
+};
+
+// src/clients/v1/webhooks.ts
+import { validateEvent } from "@polar-sh/sdk/webhooks.js";
+
+// src/clients/v1/shared.ts
+import { Polar } from "@polar-sh/sdk";
+var polar = new Polar({
+  accessToken: process.env.POLAR_ACCESS_TOKEN,
+  server: process.env.POLAR_MODE
+});
+var polarClient = null;
+var getOrCreatePolar = (accessToken) => {
+  if (!polarClient) {
+    polarClient = new Polar({
+      accessToken
+    });
+  }
+  return polarClient;
+};
+
+// src/maps/event-map.ts
+var EVENT_MAP = {
+  // Checkout
+  "checkout.created": "CHECKOUT_COMPLETED",
+  "checkout.updated": "CHECKOUT_COMPLETED",
+  "checkout.expired": "CHECKOUT_EXPIRED",
+  // Subscriptions
+  "subscription.created": "SUBSCRIPTION_CREATED",
+  "subscription.updated": "SUBSCRIPTION_UPDATED",
+  "subscription.canceled": "SUBSCRIPTION_CANCELED",
+  "subscription.active": "SUBSCRIPTION_RESUMED",
+  "subscription.uncanceled": "SUBSCRIPTION_RESUMED",
+  "subscription.revoked": "SUBSCRIPTION_CANCELED",
+  "subscription.past_due": "SUBSCRIPTION_PAYMENT_FAILED",
+  // Orders
+  "order.created": "PAYMENT_CREATED",
+  "order.updated": "PAYMENT_PROCESSING",
+  "order.paid": "PAYMENT_SUCCEEDED",
+  "order.refunded": "REFUND_PROCESSED",
+  // Customers
+  "customer.created": "CUSTOMER_CREATED",
+  "customer.updated": "CUSTOMER_UPDATED",
+  "customer.deleted": "CUSTOMER_DELETED",
+  "customer.state_changed": "CUSTOMER_UPDATED",
+  // Refunds
+  "refund.created": "REFUND_CREATED",
+  "refund.updated": "REFUND_PROCESSED",
+  "product.created": null,
+  "product.updated": null,
+  "benefit.created": null,
+  "benefit.updated": null,
+  "benefit_grant.created": null,
+  "benefit_grant.cycled": null,
+  "benefit_grant.updated": null,
+  "benefit_grant.revoked": null,
+  "organization.updated": null,
+  "customer_seat.assigned": null,
+  "customer_seat.claimed": null,
+  "customer_seat.revoked": null,
+  "member.created": null,
+  "member.updated": null,
+  "member.deleted": null
+};
+
+// src/clients/v1/webhooks.ts
+var validateCredentials = async (ctx) => {
+  if (!ctx.config.accessToken || !ctx.config.organizationId) {
+    return { data: false, status: "success" };
+  }
+  try {
+    const polar2 = getOrCreatePolar(ctx.config.accessToken);
+    await polar2.organizations.list({});
+    return { data: true, status: "success" };
+  } catch {
+    return { data: false, status: "failed" };
+  }
+};
+var setupWebhooks = async (ctx, webhookUrl) => {
+  const polar2 = getOrCreatePolar(ctx.config.accessToken);
+  try {
+    const events = [
+      "checkout.created",
+      "checkout.updated",
+      "customer.created",
+      "customer.updated",
+      "customer.deleted",
+      "order.created",
+      "order.updated",
+      "order.paid",
+      "order.refunded",
+      "subscription.created",
+      "subscription.updated",
+      "subscription.active",
+      "subscription.canceled",
+      "subscription.uncanceled",
+      "subscription.revoked",
+      "subscription.past_due",
+      "refund.created",
+      "refund.updated",
+      "product.created",
+      "product.updated"
+    ];
+    const webhookEndpoint = await polar2.webhooks.createWebhookEndpoint({
+      url: webhookUrl,
+      format: "raw",
+      events,
+      name: "Revstack",
+      organizationId: ctx.config.organizationId
+    });
+    const data = {
+      webhookEndpointId: webhookEndpoint.id,
+      webhookSecret: webhookEndpoint.secret,
+      accessToken: ctx.config.accessToken,
+      organizationId: ctx.config.organizationId
+    };
+    return {
+      data: { success: true, data },
+      status: "success"
+    };
+  } catch (error) {
+    return {
+      data: { success: false, data: {} },
+      status: "failed",
+      error: { code: "UNKNOWN_ERROR", message: error.message }
+    };
+  }
+};
+var removeWebhooks = async (ctx, webhookId) => {
+  const polar2 = getOrCreatePolar(ctx.config.accessToken);
+  try {
+    await polar2.webhooks.deleteWebhookEndpoint({ id: webhookId });
+    return { data: true, status: "success" };
+  } catch (error) {
+    return { data: false, status: "failed" };
+  }
+};
+var verifyWebhookSignature = async (_ctx, payload, headers, secret) => {
+  try {
+    const normalizedHeaders = {};
+    for (const [k, v] of Object.entries(headers)) {
+      if (v)
+        normalizedHeaders[k] = Array.isArray(v) ? v[0] || "" : v;
+    }
+    validateEvent(payload, normalizedHeaders, secret);
+    return { data: true, status: "success" };
+  } catch (error) {
+    return { data: false, status: "failed" };
+  }
+};
+function extractResourceId(payload) {
+  const data = payload.data;
+  if (!data) return null;
+  return data.id || null;
+}
+var parseWebhookEvent = async (payload) => {
+  if (!payload || !payload.type) return { data: null, status: "failed" };
+  const mappedType = EVENT_MAP[payload.type];
+  if (!mappedType) return { data: null, status: "failed" };
+  const resourceId = extractResourceId(payload) || payload.id;
+  return {
+    data: {
+      type: mappedType,
+      providerEventId: payload.id,
+      createdAt: /* @__PURE__ */ new Date(),
+      resourceId,
+      originalPayload: payload,
+      metadata: { polarType: payload.type }
+    },
+    status: "success"
+  };
+};
+
+// src/clients/v1/addons.ts
+var createAddon = async (...args) => {
+  throw new Error("Not implemented");
+};
+var getAddon = async (...args) => {
+  throw new Error("Not implemented");
+};
+var updateAddon = async (...args) => {
+  throw new Error("Not implemented");
+};
+var deleteAddon = async (...args) => {
+  throw new Error("Not implemented");
+};
+var listAddons = async (...args) => {
+  throw new Error("Not implemented");
+};
+
+// src/clients/v1/payment-methods.ts
+var listPaymentMethods = async (...args) => {
+  throw new Error("Not implemented");
+};
+var deletePaymentMethod = async (...args) => {
+  throw new Error("Not implemented");
+};
+
+// src/clients/v1/index.ts
+var PolarClientV1 = class {
+  // ===========================================================================
+  // LIFECYCLE & WEBHOOKS
+  // ===========================================================================
+  validateCredentials(ctx) {
+    return validateCredentials(ctx);
+  }
+  setupWebhooks(ctx, webhookUrl) {
+    return setupWebhooks(ctx, webhookUrl);
+  }
+  removeWebhooks(ctx, webhookId) {
+    return removeWebhooks(ctx, webhookId);
+  }
+  verifyWebhookSignature(ctx, payload, headers, secret) {
+    return verifyWebhookSignature(ctx, payload, headers, secret);
+  }
+  parseWebhookEvent(payload) {
+    return parseWebhookEvent(payload);
+  }
+  listPaymentMethods(ctx, customerId) {
+    return listPaymentMethods(ctx, customerId);
+  }
+  deletePaymentMethod(ctx, id) {
+    return deletePaymentMethod(ctx, id);
+  }
+  // ===========================================================================
+  // PAYMENTS
+  // ===========================================================================
+  createPayment(ctx, input) {
+    return createPayment(ctx, input, createCheckoutSession);
+  }
+  getPayment(ctx, id) {
+    return getPayment(ctx, id);
+  }
+  refundPayment(ctx, input) {
+    return refundPayment(ctx, input);
+  }
+  listPayments(ctx, pagination) {
+    return listPayments(ctx, pagination);
+  }
+  capturePayment(ctx, id, amount) {
+    return capturePayment(ctx, id, amount);
+  }
+  // ===========================================================================
+  // SUBSCRIPTIONS
+  // ===========================================================================
+  createSubscription(ctx, input) {
+    return createSubscription(
+      ctx,
+      input,
+      createCheckoutSession
+    );
+  }
+  getSubscription(ctx, id) {
+    return getSubscription(ctx, id);
+  }
+  cancelSubscription(ctx, id, reason) {
+    return cancelSubscription(ctx, id, reason);
+  }
+  pauseSubscription(ctx, id) {
+    return pauseSubscription(ctx, id);
+  }
+  resumeSubscription(ctx, id) {
+    return resumeSubscription(ctx, id);
+  }
+  listSubscriptions(ctx, pagination) {
+    return listSubscriptions(ctx, pagination);
+  }
+  updateSubscription(ctx, id, input) {
+    return updateSubscription(ctx, id, input);
+  }
+  // ===========================================================================
+  // CHECKOUT
+  // ===========================================================================
+  createCheckoutSession(ctx, input) {
+    return createCheckoutSession(ctx, input);
+  }
+  setupPaymentMethod(ctx, input) {
+    return setupPaymentMethod(ctx, input);
+  }
+  createBillingPortalSession(ctx, input) {
+    return createBillingPortalSession(ctx, input);
+  }
+  // ===========================================================================
+  // CUSTOMERS
+  // ===========================================================================
+  createCustomer(ctx, input) {
+    return createCustomer(ctx, input);
+  }
+  updateCustomer(ctx, id, input) {
+    return updateCustomer(ctx, id, input);
+  }
+  deleteCustomer(ctx, id) {
+    return deleteCustomer(ctx, id);
+  }
+  getCustomer(ctx, id) {
+    return getCustomer(ctx, id);
+  }
+  listCustomers(ctx, pagination) {
+    return listCustomers(ctx, pagination);
+  }
+  // ===========================================================================
+  // ADDONS
+  // ===========================================================================
+  createAddon(ctx, input) {
+    return createAddon(ctx, input);
+  }
+  getAddon(ctx, id) {
+    return getAddon(ctx, id);
+  }
+  updateAddon(ctx, id, input) {
+    return updateAddon(ctx, id, input);
+  }
+  deleteAddon(ctx, input) {
+    return deleteAddon(ctx, input);
+  }
+  listAddons(ctx, subscriptionId, pagination) {
+    return listAddons(ctx, subscriptionId, pagination);
+  }
+};
+
+// src/clients/factory.ts
+function getClient(_config) {
+  return new PolarClientV1();
+}
+
+// src/provider.ts
+import {
+  BaseProvider,
+  RevstackErrorCode
+} from "@revstackhq/providers-core";
+var PolarProvider = class extends BaseProvider {
+  static manifest = manifest;
+  manifest = manifest;
+  async onInstall(ctx, input) {
+    const client = getClient(input.config);
+    const installVersion = manifest.version;
+    const isValid = await client.validateCredentials({
+      ...ctx,
+      config: input.config
+    });
+    if (!isValid) {
+      return {
+        data: { success: false },
+        status: "failed",
+        error: {
+          code: RevstackErrorCode.InvalidCredentials,
+          message: "Failed to connect to provider. Please check your API Key / Secrets."
+        }
+      };
+    }
+    let webhookData = {};
+    if (client.setupWebhooks && input.webhookUrl) {
+      try {
+        const wh = await client.setupWebhooks(
+          { ...ctx, config: input.config },
+          input.webhookUrl
+        );
+        const whData = wh.data;
+        if (!wh.data || !whData.success) {
+          return {
+            data: { success: false },
+            status: "failed",
+            error: {
+              code: RevstackErrorCode.UnknownError,
+              message: "Failed to setup webhooks in Polar"
+            }
+          };
+        }
+        webhookData = {
+          webhookEndpointId: whData.data?.webhookEndpointId,
+          webhookSecret: whData.data?.webhookSecret
+        };
+      } catch (error) {
+        console.warn("Webhook setup failed (non-fatal):", error.message);
+        return {
+          data: { success: false },
+          status: "failed",
+          error: {
+            code: RevstackErrorCode.MisconfiguredProvider,
+            message: `Webhook setup failed: ${error.message}`
+          }
+        };
+      }
+    }
+    return {
+      data: {
+        success: true,
+        data: {
+          ...input.config,
+          ...webhookData,
+          _providerVersion: installVersion
+        }
+      },
+      status: "success"
+    };
+  }
+  async onUninstall(ctx, input) {
+    const client = getClient(input.config);
+    if (client.removeWebhooks && input.data.webhookEndpointId) {
+      try {
+        await client.removeWebhooks(
+          ctx,
+          input.data.webhookEndpointId
+        );
+      } catch (e) {
+        console.warn("Failed to remove webhook on uninstall:", e);
+      }
+    }
+    return {
+      data: true,
+      status: "success"
+    };
+  }
+  async verifyWebhookSignature(ctx, payload, headers, secret) {
+    const client = getClient(ctx.config);
+    return client.verifyWebhookSignature(ctx, payload, headers, secret);
+  }
+  async parseWebhookEvent(ctx, payload) {
+    const client = getClient(ctx.config);
+    return client.parseWebhookEvent(payload);
+  }
+  async getWebhookResponse() {
+    return {
+      data: { statusCode: 200, body: { received: true } },
+      status: "success"
+    };
+  }
+  // ===========================================================================
+  // PAYMENTS
+  // ===========================================================================
+  async createPayment(ctx, input) {
+    const client = getClient(ctx.config);
+    if (!client.createPayment) {
+      return {
+        data: null,
+        status: "failed",
+        error: {
+          code: RevstackErrorCode.NotImplemented,
+          message: `Provider '${this.manifest.slug}' does not support createPayment.`
+        }
+      };
+    }
+    return client.createPayment(ctx, input);
+  }
+  async getPayment(ctx, id) {
+    const client = getClient(ctx.config);
+    if (!client.getPayment) {
+      return {
+        data: null,
+        status: "failed",
+        error: {
+          code: RevstackErrorCode.NotImplemented,
+          message: "Get payment not supported"
+        }
+      };
+    }
+    return client.getPayment(ctx, id);
+  }
+  async refundPayment(ctx, input) {
+    const client = getClient(ctx.config);
+    if (!client.refundPayment) {
+      return {
+        data: null,
+        status: "failed",
+        error: {
+          code: RevstackErrorCode.NotImplemented,
+          message: "Refunds not supported by this provider version"
+        }
+      };
+    }
+    return client.refundPayment(ctx, input);
+  }
+  async listPayments(ctx, pagination) {
+    const client = getClient(ctx.config);
+    if (!client.listPayments) {
+      return {
+        data: null,
+        status: "failed",
+        error: {
+          code: RevstackErrorCode.NotImplemented,
+          message: "List payments not supported"
+        }
+      };
+    }
+    return client.listPayments(ctx, pagination);
+  }
+  // ===========================================================================
+  // SUBSCRIPTIONS
+  // ===========================================================================
+  async createSubscription(ctx, input) {
+    const client = getClient(ctx.config);
+    if (!client.createSubscription) {
+      return {
+        data: null,
+        status: "failed",
+        error: {
+          code: RevstackErrorCode.NotImplemented,
+          message: "Subscriptions not supported"
+        }
+      };
+    }
+    return client.createSubscription(ctx, input);
+  }
+  async getSubscription(ctx, id) {
+    const client = getClient(ctx.config);
+    if (!client.getSubscription) {
+      return {
+        data: null,
+        status: "failed",
+        error: {
+          code: RevstackErrorCode.NotImplemented,
+          message: "Get subscription not supported"
+        }
+      };
+    }
+    return client.getSubscription(ctx, id);
+  }
+  async cancelSubscription(ctx, id, reason) {
+    const client = getClient(ctx.config);
+    if (!client.cancelSubscription) {
+      return {
+        data: null,
+        status: "failed",
+        error: {
+          code: RevstackErrorCode.NotImplemented,
+          message: "Cancel subscription not supported"
+        }
+      };
+    }
+    return client.cancelSubscription(ctx, id, reason);
+  }
+  async pauseSubscription(ctx, id, reason) {
+    const client = getClient(ctx.config);
+    if (!client.pauseSubscription) {
+      return {
+        data: null,
+        status: "failed",
+        error: {
+          code: RevstackErrorCode.NotImplemented,
+          message: "Pause subscription not supported"
+        }
+      };
+    }
+    return client.pauseSubscription(ctx, id, reason);
+  }
+  async resumeSubscription(ctx, id, reason) {
+    const client = getClient(ctx.config);
+    if (!client.resumeSubscription) {
+      return {
+        data: null,
+        status: "failed",
+        error: {
+          code: RevstackErrorCode.NotImplemented,
+          message: "Resume subscription not supported"
+        }
+      };
+    }
+    return client.resumeSubscription(ctx, id, reason);
+  }
+  // ===========================================================================
+  // CHECKOUT
+  // ===========================================================================
+  async createCheckoutSession(ctx, input) {
+    const client = getClient(ctx.config);
+    if (!client.createCheckoutSession) {
+      return {
+        data: null,
+        status: "failed",
+        error: {
+          code: RevstackErrorCode.NotImplemented,
+          message: "Checkout not supported"
+        }
+      };
+    }
+    return client.createCheckoutSession(ctx, input);
+  }
+  // ===========================================================================
+  // CUSTOMERS
+  // ===========================================================================
+  async createCustomer(ctx, input) {
+    const client = getClient(ctx.config);
+    if (!client.createCustomer) {
+      return {
+        data: null,
+        status: "failed",
+        error: {
+          code: RevstackErrorCode.NotImplemented,
+          message: "Customer management not supported"
+        }
+      };
+    }
+    return client.createCustomer(ctx, input);
+  }
+  async updateCustomer(ctx, id, input) {
+    const client = getClient(ctx.config);
+    if (!client.updateCustomer) {
+      return {
+        data: null,
+        status: "failed",
+        error: {
+          code: RevstackErrorCode.NotImplemented,
+          message: "Customer update not supported"
+        }
+      };
+    }
+    return client.updateCustomer(ctx, id, input);
+  }
+  async deleteCustomer(ctx, id) {
+    const client = getClient(ctx.config);
+    if (!client.deleteCustomer) {
+      return {
+        data: false,
+        status: "failed",
+        error: {
+          code: RevstackErrorCode.NotImplemented,
+          message: "Customer deletion not supported"
+        }
+      };
+    }
+    return client.deleteCustomer(ctx, id);
+  }
+  async getCustomer(ctx, id) {
+    const client = getClient(ctx.config);
+    if (!client.getCustomer) {
+      return {
+        data: null,
+        status: "failed",
+        error: {
+          code: RevstackErrorCode.NotImplemented,
+          message: "Get customer not supported"
+        }
+      };
+    }
+    return client.getCustomer(ctx, id);
+  }
+  // ===========================================================================
+  // PAYMENT METHODS
+  // ===========================================================================
+  async listPaymentMethods(ctx, customerId) {
+    const client = getClient(ctx.config);
+    if (!client.listPaymentMethods) {
+      return {
+        data: null,
+        status: "failed",
+        error: {
+          code: RevstackErrorCode.NotImplemented,
+          message: "List payment methods not supported"
+        }
+      };
+    }
+    return client.listPaymentMethods(ctx, customerId);
+  }
+  async deletePaymentMethod(ctx, id) {
+    const client = getClient(ctx.config);
+    if (!client.deletePaymentMethod) {
+      return {
+        data: false,
+        status: "failed",
+        error: {
+          code: RevstackErrorCode.NotImplemented,
+          message: "Delete payment method not supported"
+        }
+      };
+    }
+    return client.deletePaymentMethod(ctx, id);
+  }
+  // ===========================================================================
+  // ADDITIONAL METHODS
+  // ===========================================================================
+  async capturePayment(ctx, id, amount) {
+    const client = getClient(ctx.config);
+    if (!client.capturePayment) {
+      return {
+        data: null,
+        status: "failed",
+        error: {
+          code: RevstackErrorCode.NotImplemented,
+          message: "Capture not supported"
+        }
+      };
+    }
+    return client.capturePayment(ctx, id, amount);
+  }
+  async listSubscriptions(ctx, pagination) {
+    const client = getClient(ctx.config);
+    if (!client.listSubscriptions) {
+      return {
+        data: null,
+        status: "failed",
+        error: {
+          code: RevstackErrorCode.NotImplemented,
+          message: "List subscriptions not supported"
+        }
+      };
+    }
+    return client.listSubscriptions(ctx, pagination);
+  }
+  async updateSubscription(ctx, id, input) {
+    const client = getClient(ctx.config);
+    if (!client.updateSubscription) {
+      return {
+        data: null,
+        status: "failed",
+        error: {
+          code: RevstackErrorCode.NotImplemented,
+          message: "Update subscription not supported"
+        }
+      };
+    }
+    return client.updateSubscription(ctx, id, input);
+  }
+  async listCustomers(ctx, pagination) {
+    const client = getClient(ctx.config);
+    if (!client.listCustomers) {
+      return {
+        data: null,
+        status: "failed",
+        error: {
+          code: RevstackErrorCode.NotImplemented,
+          message: "List customers not supported"
+        }
+      };
+    }
+    return client.listCustomers(ctx, pagination);
+  }
+  async setupPaymentMethod(ctx, input) {
+    const client = getClient(ctx.config);
+    if (!client.setupPaymentMethod) {
+      return {
+        data: null,
+        status: "failed",
+        error: {
+          code: RevstackErrorCode.NotImplemented,
+          message: "Setup payment method not supported"
+        }
+      };
+    }
+    return client.setupPaymentMethod(ctx, input);
+  }
+  async createBillingPortalSession(ctx, input) {
+    const client = getClient(ctx.config);
+    if (!client.createBillingPortalSession) {
+      return {
+        data: null,
+        status: "failed",
+        error: {
+          code: RevstackErrorCode.NotImplemented,
+          message: "Billing portal not supported"
+        }
+      };
+    }
+    return client.createBillingPortalSession(ctx, input);
+  }
+  // ===========================================================================
+  // ADDONS
+  // ===========================================================================
+  async createAddon(ctx, input) {
+    const client = getClient(ctx.config);
+    if (!client.createAddon) {
+      return {
+        data: null,
+        status: "failed",
+        error: {
+          code: RevstackErrorCode.NotImplemented,
+          message: "Create Addon not supported"
+        }
+      };
+    }
+    return client.createAddon(ctx, input);
+  }
+  async getAddon(ctx, id) {
+    const client = getClient(ctx.config);
+    if (!client.getAddon) {
+      return {
+        data: null,
+        status: "failed",
+        error: {
+          code: RevstackErrorCode.NotImplemented,
+          message: "Get Addon not supported"
+        }
+      };
+    }
+    return client.getAddon(ctx, id);
+  }
+  async updateAddon(ctx, id, input) {
+    const client = getClient(ctx.config);
+    if (!client.updateAddon) {
+      return {
+        data: null,
+        status: "failed",
+        error: {
+          code: RevstackErrorCode.NotImplemented,
+          message: "Update Addon not supported"
+        }
+      };
+    }
+    return client.updateAddon(ctx, id, input);
+  }
+  async deleteAddon(ctx, input) {
+    const client = getClient(ctx.config);
+    if (!client.deleteAddon) {
+      return {
+        data: false,
+        status: "failed",
+        error: {
+          code: RevstackErrorCode.NotImplemented,
+          message: "Delete Addon not supported"
+        }
+      };
+    }
+    return client.deleteAddon(ctx, input);
+  }
+  async listAddons(ctx, subscriptionId, pagination) {
+    const client = getClient(ctx.config);
+    if (!client.listAddons) {
+      return {
+        data: null,
+        status: "failed",
+        error: {
+          code: RevstackErrorCode.NotImplemented,
+          message: "List Addons not supported"
+        }
+      };
+    }
+    return client.listAddons(ctx, subscriptionId, pagination);
+  }
+};
+export {
+  PolarProvider,
+  manifest
+};

package/dist/logo.svg

@@ -0,0 +1,6 @@
+<svg width="100%" height="100%" viewBox="0 0 24 24" stroke-width="1.5" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M12 22C6.47715 22 2 17.5228 2 12C2 6.47715 6.47715 2 12 2C17.5228 2 22 6.47715 22 12C22 17.5228 17.5228 22 12 22Z" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round"/>
+<path d="M12 22C9.79086 22 8 17.5228 8 12C8 6.47715 9.79086 2 12 2C14.2091 2 16 6.47715 16 12C16 17.5228 14.2091 22 12 22Z" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round"/>
+<path d="M9 21C6 20 5 15.611 5 12.5C5 9.38904 6.5 5.5 10 3" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round"/>
+<path d="M15 3C18 4 19 8.38904 19 11.5C19 14.611 17.5 18.5 14 21" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@revstackhq/provider-polar",
+  "version": "0.0.0-dev-20260301193938",
+  "private": false,
+  "license": "FSL-1.1-MIT",
+  "type": "module",
+  "sideEffects": true,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "assets"
+  ],
+  "dependencies": {
+    "@polar-sh/sdk": "^0.45.1",
+    "dotenv": "^17.2.4",
+    "@revstackhq/providers-core": "0.0.0-dev-20260227040420"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@types/node": "^20.11.30",
+    "eslint": "^9.39.1",
+    "eslint-config-prettier": "^10.1.1",
+    "eslint-plugin-turbo": "^2.7.1",
+    "tsup": "^8.1.0",
+    "typescript": "5.9.2",
+    "typescript-eslint": "^8.50.0",
+    "@revstackhq/eslint-config": "0.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean --publicDir assets --no-splitting",
+    "check-types": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint \"src/**/*.{ts,tsx}\"",
+    "dev:smoke": "tsx src/smoke.ts"
+  }
+}