@revstackhq/provider-polar 0.0.0-dev-20260301204402 → 0.0.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 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';
+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 } from '@revstackhq/providers-core';
 
 declare const manifest: ProviderManifest;
 
@@ -14,7 +14,7 @@ declare class PolarProvider extends BaseProvider {
     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>>>;
+    listPayments(ctx: ProviderContext, pagination: PaginationOptions, filters?: Record<string, any>): 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>>;
@@ -28,16 +28,11 @@ declare class PolarProvider extends BaseProvider {
     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>>>;
+    listSubscriptions(ctx: ProviderContext, pagination: PaginationOptions, filters?: Record<string, any>): Promise<AsyncActionResult<PaginatedResult<Subscription>>>;
     updateSubscription(ctx: ProviderContext, id: string, input: UpdateSubscriptionInput): Promise<AsyncActionResult<string>>;
-    listCustomers(ctx: ProviderContext, pagination: PaginationOptions): Promise<AsyncActionResult<PaginatedResult<Customer>>>;
+    listCustomers(ctx: ProviderContext, pagination: PaginationOptions, filters?: Record<string, any>): 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

@@ -37,7 +37,7 @@ var manifest = {
     payments: {
       supported: true,
       features: {
-        capture: true,
+        capture: false,
         disputes: true,
         partialRefunds: true,
         refunds: true
@@ -48,8 +48,8 @@ var manifest = {
       mode: "native",
       features: {
         cancellation: true,
-        pause: true,
-        resume: true,
+        pause: false,
+        resume: false,
         proration: true
       }
     },
@@ -107,94 +107,649 @@ var manifest = {
   }
 };
 
-// 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/api/v1/payments.ts
+import {
+  buildPagePagination,
+  RevstackErrorCode as RevstackErrorCode3
+} from "@revstackhq/providers-core";
+
+// src/api/v1/mappers.ts
+import {
+  SubscriptionStatus,
+  PaymentStatus
+} from "@revstackhq/providers-core";
 
-// src/clients/v1/subscriptions.ts
-var createSubscription = async (...args) => {
-  throw new Error("Not implemented");
+// src/shared/currency-map.ts
+var currencyMap = {
+  aud: "AUD",
+  brl: "BRL",
+  cad: "CAD",
+  chf: "CHF",
+  eur: "EUR",
+  inr: "INR",
+  gbp: "GBP",
+  jpy: "JPY",
+  sek: "SEK",
+  usd: "USD"
 };
-var getSubscription = async (...args) => {
-  throw new Error("Not implemented");
+
+// src/api/v1/mappers.ts
+function mapPolarSubStatusToSubscriptionStatus(status) {
+  const map = {
+    incomplete: SubscriptionStatus.Incomplete,
+    incomplete_expired: SubscriptionStatus.IncompleteExpired,
+    trialing: SubscriptionStatus.Trialing,
+    active: SubscriptionStatus.Active,
+    past_due: SubscriptionStatus.PastDue,
+    canceled: SubscriptionStatus.Canceled,
+    unpaid: SubscriptionStatus.Unpaid
+  };
+  return map[status] || SubscriptionStatus.Active;
+}
+function mapPolarOrderStatusToPaymentStatus(status) {
+  return status === "paid" ? PaymentStatus.Succeeded : PaymentStatus.Pending;
+}
+function mapSessionToCheckoutResult(session) {
+  return {
+    id: session.id,
+    expiresAt: session.expiresAt ? new Date(session.expiresAt).toISOString() : void 0
+  };
+}
+function mapPolarSubscriptionToSubscription(sub) {
+  return {
+    id: sub.id,
+    providerId: "polar",
+    externalId: sub.id,
+    status: mapPolarSubStatusToSubscriptionStatus(sub.status),
+    amount: sub.amount || 0,
+    currency: currencyMap[sub.currency],
+    interval: sub.recurringInterval === "year" ? "year" : "month",
+    customerId: sub.customerId,
+    currentPeriodStart: new Date(sub.currentPeriodStart).toISOString(),
+    currentPeriodEnd: sub.currentPeriodEnd ? new Date(sub.currentPeriodEnd).toISOString() : new Date(sub.currentPeriodStart).toISOString(),
+    cancelAtPeriodEnd: sub.cancelAtPeriodEnd,
+    startedAt: sub.startedAt ? new Date(sub.startedAt).toISOString() : (/* @__PURE__ */ new Date()).toISOString(),
+    canceledAt: sub.canceledAt ? new Date(sub.canceledAt).toISOString() : void 0,
+    raw: sub
+  };
+}
+function mapPolarOrderToPayment(order) {
+  return {
+    id: order.id,
+    providerId: "polar",
+    externalId: order.id,
+    amount: order.subtotalAmount || 0,
+    amountRefunded: order.refundedAmount || 0,
+    currency: currencyMap[order.currency],
+    status: mapPolarOrderStatusToPaymentStatus(order.status),
+    customerId: order.customerId,
+    createdAt: new Date(order.createdAt).toISOString(),
+    raw: order
+  };
+}
+function mapPolarCustomerToCustomer(customer) {
+  return {
+    id: customer.id,
+    providerId: "polar",
+    externalId: customer.externalId || customer.id,
+    email: customer.email,
+    name: customer.name || void 0,
+    phone: void 0,
+    // Polar doesn't store phone natively yet
+    metadata: customer.metadata,
+    createdAt: new Date(customer.createdAt).toISOString(),
+    deleted: false
+  };
+}
+
+// src/api/v1/client.ts
+import { Polar } from "@polar-sh/sdk";
+var polarClient = null;
+var getOrCreatePolar = (accessToken, testMode = false) => {
+  if (!polarClient) {
+    polarClient = new Polar({
+      accessToken,
+      server: testMode ? "sandbox" : "production"
+    });
+  }
+  return polarClient;
 };
-var cancelSubscription = async (...args) => {
-  throw new Error("Not implemented");
+function appendQueryParam(url, param) {
+  const sep = url.includes("?") ? "&" : "?";
+  return url + sep + param;
+}
+
+// src/utils/jit.ts
+import { RevstackErrorCode } from "@revstackhq/providers-core";
+async function resolveJitProductId(client, ctx, params) {
+  let needsCreation = !params.priceId;
+  if (params.priceId) {
+    try {
+      await client.products.get({ id: params.priceId });
+    } catch (err) {
+      if (err.status === 404) needsCreation = true;
+      else throw err;
+    }
+  }
+  if (!needsCreation) return params.priceId;
+  if (params.jit.interval) {
+    if (params.jit.interval === "day" || params.jit.interval === "week") {
+      throw {
+        isRevstackError: true,
+        errorPayload: {
+          code: RevstackErrorCode.InvalidInput,
+          message: "Polar only supports 'month' or 'year' for subscriptions."
+        }
+      };
+    }
+  }
+  const newProduct = await client.products.create({
+    name: params.jit.name,
+    description: params.jit.description,
+    organizationId: ctx.config.organizationId,
+    recurringInterval: params.jit.interval || void 0,
+    prices: [
+      {
+        amountType: "fixed",
+        priceAmount: params.jit.amount,
+        priceCurrency: currencyMap[params.jit.currency.toLowerCase()]
+      }
+    ]
+  });
+  return newProduct.id;
+}
+
+// src/shared/error-map.ts
+import { RevstackErrorCode as RevstackErrorCode2 } from "@revstackhq/providers-core";
+function mapError(error) {
+  const msg = error?.message || "Unknown error";
+  const name = error?.name || "Error";
+  if (error.status === 404) {
+    return {
+      code: RevstackErrorCode2.ResourceNotFound,
+      message: msg,
+      providerError: name
+    };
+  }
+  if (error.status === 401 || error.status === 403) {
+    return {
+      code: RevstackErrorCode2.InvalidCredentials,
+      message: msg,
+      providerError: name
+    };
+  }
+  if (error.status >= 500) {
+    return {
+      code: RevstackErrorCode2.ProviderUnavailable,
+      message: msg,
+      providerError: name
+    };
+  }
+  return {
+    code: RevstackErrorCode2.UnknownError,
+    message: msg,
+    providerError: name
+  };
+}
+
+// src/api/v1/payments.ts
+var createPayment = async (ctx, input, createCheckoutSession2) => {
+  try {
+    const polar = getOrCreatePolar(ctx.config.accessToken);
+    const resolvedProductId = await resolveJitProductId(polar, ctx, {
+      jit: {
+        name: input.jit?.name || input.description || "One-time Payment",
+        description: input.jit?.description,
+        amount: input.amount,
+        currency: input.currency
+      }
+    });
+    const result = await createCheckoutSession2(ctx, {
+      mode: "payment",
+      customerId: input.customerId,
+      successUrl: input.returnUrl || "",
+      cancelUrl: input.cancelUrl || "",
+      metadata: input.metadata,
+      lineItems: [
+        {
+          priceId: resolvedProductId,
+          quantity: 1
+        }
+      ]
+    });
+    return {
+      data: result.data?.id || null,
+      status: result.status,
+      nextAction: result.nextAction,
+      error: result.error
+    };
+  } catch (error) {
+    if (error.isRevstackError) {
+      return { data: null, status: "failed", error: error.errorPayload };
+    }
+    return { data: null, status: "failed", error: mapError(error) };
+  }
 };
-var pauseSubscription = async (...args) => {
-  throw new Error("Not implemented");
+var getPayment = async (ctx, paymentId) => {
+  try {
+    const polar = getOrCreatePolar(ctx.config.accessToken);
+    const order = await polar.orders.get({
+      id: paymentId
+    });
+    return {
+      data: mapPolarOrderToPayment(order),
+      status: "success"
+    };
+  } catch (error) {
+    if (error.isRevstackError) {
+      return { data: null, status: "failed", error: error.errorPayload };
+    }
+    return { data: null, status: "failed", error: mapError(error) };
+  }
 };
-var resumeSubscription = async (...args) => {
-  throw new Error("Not implemented");
+var listPayments = async (ctx, options, filters) => {
+  try {
+    const polar = getOrCreatePolar(ctx.config.accessToken);
+    const targetPage = options?.page || options?.startingAfter && parseInt(options.startingAfter) + 1 || options?.endingBefore && Math.max(1, parseInt(options.endingBefore) - 1) || 1;
+    const limit = options?.limit || 10;
+    const ordersPage = await polar.orders.list({
+      customerId: options?.customerId,
+      limit,
+      page: targetPage,
+      ...filters
+    });
+    return {
+      data: buildPagePagination(
+        ordersPage.result.items,
+        targetPage,
+        ordersPage.result.pagination.maxPage,
+        mapPolarOrderToPayment
+      ),
+      status: "success"
+    };
+  } catch (error) {
+    if (error.isRevstackError) {
+      return { data: null, status: "failed", error: error.errorPayload };
+    }
+    return { data: null, status: "failed", error: mapError(error) };
+  }
 };
-var listSubscriptions = async (...args) => {
-  throw new Error("Not implemented");
+var refundPayment = async (ctx, paymentId, amount) => {
+  try {
+    const polar = getOrCreatePolar(ctx.config.accessToken);
+    await polar.refunds.create({
+      orderId: paymentId,
+      amount: amount || 0,
+      // If 0, polar throws an error, which is correct (refunds must have amount > 1)
+      reason: "customer_request"
+    });
+    const order = await polar.orders.get({
+      id: paymentId
+    });
+    return {
+      data: order.id,
+      status: "success"
+    };
+  } catch (error) {
+    if (error.isRevstackError) {
+      return { data: null, status: "failed", error: error.errorPayload };
+    }
+    return { data: null, status: "failed", error: mapError(error) };
+  }
 };
-var updateSubscription = async (...args) => {
-  throw new Error("Not implemented");
+var capturePayment = async (_ctx, _paymentId, _amount) => {
+  return {
+    data: null,
+    status: "failed",
+    error: {
+      code: RevstackErrorCode3.NotImplemented,
+      message: "Manual capture is not supported by Polar logic yet."
+    }
+  };
 };
 
-// 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/api/v1/subscriptions.ts
+import {
+  RevstackErrorCode as RevstackErrorCode4,
+  buildPagePagination as buildPagePagination2
+} from "@revstackhq/providers-core";
+async function createSubscription(ctx, input, createCheckoutSession2) {
+  try {
+    const polar = getOrCreatePolar(ctx.config.accessToken);
+    const resolvedProductId = input.jit ? await resolveJitProductId(polar, ctx, {
+      priceId: input.priceId,
+      jit: input.jit
+    }) : input.priceId;
+    const result = await createCheckoutSession2(ctx, {
+      mode: "subscription",
+      customerId: input.customerId,
+      successUrl: input.returnUrl || "",
+      cancelUrl: input.cancelUrl || "",
+      metadata: input.metadata,
+      allowPromotionCodes: input.promotionCode ? true : void 0,
+      lineItems: [
+        {
+          priceId: resolvedProductId,
+          quantity: input.quantity || 1
+        }
+      ]
+    });
+    return {
+      data: result.data?.id || null,
+      status: result.status,
+      nextAction: result.nextAction,
+      error: result.error
+    };
+  } catch (error) {
+    if (error.isRevstackError) {
+      return { data: null, status: "failed", error: error.errorPayload };
+    }
+    return { data: null, status: "failed", error: mapError(error) };
+  }
+}
+async function getSubscription(ctx, id) {
+  try {
+    const polar = getOrCreatePolar(ctx.config.accessToken);
+    const sub = await polar.subscriptions.get({ id });
+    return {
+      data: mapPolarSubscriptionToSubscription(sub),
+      status: "success"
+    };
+  } catch (error) {
+    if (error.isRevstackError) {
+      return { data: null, status: "failed", error: error.errorPayload };
+    }
+    return { data: null, status: "failed", error: mapError(error) };
+  }
+}
+async function cancelSubscription(ctx, id, _reason) {
+  try {
+    const polar = getOrCreatePolar(ctx.config.accessToken);
+    const sub = await polar.subscriptions.revoke({ id });
+    return {
+      data: sub.id,
+      status: "success"
+    };
+  } catch (error) {
+    if (error.status === 404) {
+      return {
+        data: null,
+        status: "failed",
+        error: {
+          code: RevstackErrorCode4.SubscriptionNotFound,
+          message: error.message,
+          providerError: error.name
+        }
+      };
+    }
+    if (error.isRevstackError) {
+      return { data: null, status: "failed", error: error.errorPayload };
+    }
+    return { data: null, status: "failed", error: mapError(error) };
+  }
+}
+async function pauseSubscription(_ctx, _id) {
+  return {
+    data: null,
+    status: "failed",
+    error: {
+      code: RevstackErrorCode4.NotImplemented,
+      message: "Polar does not natively support pausing subscriptions yet."
+    }
+  };
+}
+async function resumeSubscription(_ctx, _id) {
+  return {
+    data: null,
+    status: "failed",
+    error: {
+      code: RevstackErrorCode4.NotImplemented,
+      message: "Polar does not natively support resuming paused subscriptions."
+    }
+  };
+}
+async function listSubscriptions(ctx, pagination, filters) {
+  try {
+    const polar = getOrCreatePolar(ctx.config.accessToken);
+    const targetPage = pagination.page || pagination.startingAfter && parseInt(pagination.startingAfter) + 1 || pagination.endingBefore && Math.max(1, parseInt(pagination.endingBefore) - 1) || 1;
+    const subsResponse = await polar.subscriptions.list({
+      organizationId: ctx.config.organizationId,
+      limit: pagination.limit || 10,
+      page: targetPage,
+      ...filters
+    });
+    return {
+      data: buildPagePagination2(
+        subsResponse.result.items,
+        targetPage,
+        subsResponse.result.pagination.maxPage,
+        mapPolarSubscriptionToSubscription
+      ),
+      status: "success"
+    };
+  } catch (error) {
+    if (error.isRevstackError) {
+      return { data: null, status: "failed", error: error.errorPayload };
+    }
+    return { data: null, status: "failed", error: mapError(error) };
+  }
+}
+async function updateSubscription(ctx, id, input) {
+  try {
+    const polar = getOrCreatePolar(ctx.config.accessToken);
+    const sub = await polar.subscriptions.update({
+      id,
+      subscriptionUpdate: {
+        prorationBehavior: "prorate",
+        productId: input.priceId || ""
+      }
+    });
+    return {
+      data: sub.id,
+      status: "success"
+    };
+  } catch (error) {
+    if (error.isRevstackError) {
+      return { data: null, status: "failed", error: error.errorPayload };
+    }
+    return { data: null, status: "failed", error: mapError(error) };
+  }
+}
 
-// src/clients/v1/customers.ts
-var createCustomer = async (...args) => {
-  throw new Error("Not implemented");
-};
-var updateCustomer = async (...args) => {
-  throw new Error("Not implemented");
+// src/api/v1/checkout.ts
+import {
+  RevstackErrorCode as RevstackErrorCode5
+} from "@revstackhq/providers-core";
+async function createCheckoutSession(ctx, input) {
+  const polar = getOrCreatePolar(ctx.config.accessToken);
+  try {
+    const productIds = input.lineItems.filter((item) => item.priceId).map((item) => item.priceId);
+    if (productIds.length === 0) {
+      return {
+        data: null,
+        status: "failed",
+        error: {
+          code: RevstackErrorCode5.InvalidInput,
+          message: "Failed to create checkout session. Please ensure you have a valid product or price.",
+          providerError: "missing_product"
+        }
+      };
+    }
+    const cleanMetadata = {};
+    if (input.metadata) {
+      Object.entries(input.metadata).forEach(([k, v]) => {
+        if (v !== null && v !== void 0) {
+          cleanMetadata[k] = v;
+        }
+      });
+    }
+    if (ctx.traceId) {
+      cleanMetadata.revstack_trace_id = ctx.traceId;
+    }
+    const sessionPayload = {
+      products: productIds,
+      successUrl: appendQueryParam(
+        input.successUrl,
+        "session_id={CHECKOUT_SESSION_ID}"
+      ),
+      customerId: input.customerId || void 0,
+      customerEmail: !input.customerId ? input.customerEmail : void 0,
+      allowDiscountCodes: input.allowPromotionCodes ?? true,
+      metadata: cleanMetadata
+    };
+    const session = await polar.checkouts.create(sessionPayload);
+    return {
+      data: mapSessionToCheckoutResult(session),
+      status: "requires_action",
+      nextAction: {
+        type: "redirect",
+        url: session.url
+      }
+    };
+  } catch (error) {
+    const mapped = mapError(error);
+    return {
+      data: null,
+      status: "failed",
+      error: mapped
+    };
+  }
+}
+async function createBillingPortalSession(ctx, input) {
+  const polar = getOrCreatePolar(ctx.config.accessToken);
+  try {
+    const session = await polar.customerSessions.create({
+      customerId: input.customerId,
+      returnUrl: input.returnUrl || void 0
+    });
+    return {
+      data: null,
+      status: "requires_action",
+      nextAction: {
+        type: "redirect",
+        url: session.customerPortalUrl
+      }
+    };
+  } catch (error) {
+    return {
+      data: null,
+      status: "failed",
+      error: mapError(error)
+    };
+  }
+}
+
+// src/api/v1/customers.ts
+import {
+  buildPagePagination as buildPagePagination3
+} from "@revstackhq/providers-core";
+var createCustomer = async (ctx, input) => {
+  try {
+    const polar = getOrCreatePolar(ctx.config.accessToken);
+    const customer = await polar.customers.create({
+      email: input.email,
+      name: input.name || void 0,
+      metadata: input.metadata || {}
+    });
+    return {
+      data: customer.id,
+      status: "success"
+    };
+  } catch (error) {
+    if (error.isRevstackError) {
+      return { data: null, status: "failed", error: error.errorPayload };
+    }
+    return { data: null, status: "failed", error: mapError(error) };
+  }
 };
-var deleteCustomer = async (...args) => {
-  throw new Error("Not implemented");
+var updateCustomer = async (ctx, customerId, input) => {
+  try {
+    const polar = getOrCreatePolar(ctx.config.accessToken);
+    const customer = await polar.customers.update({
+      id: customerId,
+      customerUpdate: {
+        email: input.email,
+        name: input.name || void 0,
+        metadata: input.metadata || {}
+      }
+    });
+    return {
+      data: customer.id,
+      status: "success"
+    };
+  } catch (error) {
+    if (error.isRevstackError) {
+      return { data: null, status: "failed", error: error.errorPayload };
+    }
+    return { data: null, status: "failed", error: mapError(error) };
+  }
 };
-var getCustomer = async (...args) => {
-  throw new Error("Not implemented");
+var deleteCustomer = async (ctx, customerId) => {
+  try {
+    const polar = getOrCreatePolar(ctx.config.accessToken);
+    await polar.customers.delete({
+      id: customerId
+    });
+    return {
+      data: true,
+      status: "success"
+    };
+  } catch (error) {
+    if (error.isRevstackError) {
+      return { data: false, status: "failed", error: error.errorPayload };
+    }
+    return { data: false, status: "failed", error: mapError(error) };
+  }
 };
-var listCustomers = async (...args) => {
-  throw new Error("Not implemented");
+var getCustomer = async (ctx, customerId) => {
+  try {
+    const polar = getOrCreatePolar(ctx.config.accessToken);
+    const customer = await polar.customers.get({
+      id: customerId
+    });
+    return {
+      data: mapPolarCustomerToCustomer(customer),
+      status: "success"
+    };
+  } catch (error) {
+    if (error.isRevstackError) {
+      return { data: null, status: "failed", error: error.errorPayload };
+    }
+    return { data: null, status: "failed", error: mapError(error) };
+  }
 };
-
-// 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
+var listCustomers = async (ctx, options, filters) => {
+  try {
+    const polar = getOrCreatePolar(ctx.config.accessToken);
+    const targetPage = options?.page || options?.startingAfter && parseInt(options.startingAfter) + 1 || options?.endingBefore && Math.max(1, parseInt(options.endingBefore) - 1) || 1;
+    const limit = options?.limit || 10;
+    const customersPage = await polar.customers.list({
+      limit,
+      page: targetPage,
+      email: options?.email,
+      ...filters
     });
+    return {
+      data: buildPagePagination3(
+        customersPage.result.items,
+        targetPage,
+        customersPage.result.pagination.maxPage,
+        mapPolarCustomerToCustomer
+      ),
+      status: "success"
+    };
+  } catch (error) {
+    if (error.isRevstackError) {
+      return { data: null, status: "failed", error: error.errorPayload };
+    }
+    return { data: null, status: "failed", error: mapError(error) };
   }
-  return polarClient;
 };
 
-// src/maps/event-map.ts
+// src/api/v1/webhooks.ts
+import { validateEvent } from "@polar-sh/sdk/webhooks.js";
+
+// src/shared/event-map.ts
 var EVENT_MAP = {
   // Checkout
   "checkout.created": "CHECKOUT_COMPLETED",
@@ -238,21 +793,21 @@ var EVENT_MAP = {
   "member.deleted": null
 };
 
-// src/clients/v1/webhooks.ts
+// src/api/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({});
+    const polar = getOrCreatePolar(ctx.config.accessToken);
+    await polar.organizations.list({});
     return { data: true, status: "success" };
   } catch {
     return { data: false, status: "failed" };
   }
 };
 var setupWebhooks = async (ctx, webhookUrl) => {
-  const polar2 = getOrCreatePolar(ctx.config.accessToken);
+  const polar = getOrCreatePolar(ctx.config.accessToken);
   try {
     const events = [
       "checkout.created",
@@ -278,18 +833,44 @@ var setupWebhooks = async (ctx, webhookUrl) => {
       "product.created",
       "product.updated"
     ];
-    const webhookEndpoint = await polar2.webhooks.createWebhookEndpoint({
-      url: webhookUrl,
-      format: "raw",
-      events,
-      name: "Revstack"
+    const webhooksList = await polar.webhooks.listWebhookEndpoints({
+      organizationId: ctx.config.organizationId,
+      limit: 100
     });
+    const existingWebhook = webhooksList.result.items.find(
+      (wh) => wh.url === webhookUrl
+    );
+    let webhookEndpointId;
+    let secret;
+    if (existingWebhook) {
+      const updated = await polar.webhooks.updateWebhookEndpoint({
+        id: existingWebhook.id,
+        webhookEndpointUpdate: {
+          url: webhookUrl,
+          format: "raw",
+          events
+        }
+      });
+      webhookEndpointId = updated.id;
+      secret = void 0;
+    } else {
+      const created = await polar.webhooks.createWebhookEndpoint({
+        url: webhookUrl,
+        format: "raw",
+        events,
+        name: "Revstack"
+      });
+      webhookEndpointId = created.id;
+      secret = created.secret;
+    }
     const data = {
-      webhookEndpointId: webhookEndpoint.id,
-      webhookSecret: webhookEndpoint.secret,
+      webhookEndpointId,
       accessToken: ctx.config.accessToken,
       organizationId: ctx.config.organizationId
     };
+    if (secret) {
+      data.webhookSecret = secret;
+    }
     return {
       data: { success: true, data },
       status: "success"
@@ -303,9 +884,9 @@ var setupWebhooks = async (ctx, webhookUrl) => {
   }
 };
 var removeWebhooks = async (ctx, webhookId) => {
-  const polar2 = getOrCreatePolar(ctx.config.accessToken);
+  const polar = getOrCreatePolar(ctx.config.accessToken);
   try {
-    await polar2.webhooks.deleteWebhookEndpoint({ id: webhookId });
+    await polar.webhooks.deleteWebhookEndpoint({ id: webhookId });
     return { data: true, status: "success" };
   } catch (error) {
     return { data: false, status: "failed" };
@@ -347,32 +928,28 @@ var parseWebhookEvent = async (payload) => {
   };
 };
 
-// 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");
+// src/api/v1/payment-methods.ts
+import {
+  RevstackErrorCode as RevstackErrorCode6
+} from "@revstackhq/providers-core";
+var NOT_IMPLEMENTED = {
+  status: "failed",
+  error: {
+    code: RevstackErrorCode6.NotImplemented,
+    message: "Payment methods management is natively not supported by Polar"
+  }
 };
-var listAddons = async (...args) => {
-  throw new Error("Not implemented");
+var setupPaymentMethod = async (_ctx, _input) => {
+  return { ...NOT_IMPLEMENTED, data: null };
 };
-
-// src/clients/v1/payment-methods.ts
-var listPaymentMethods = async (...args) => {
-  throw new Error("Not implemented");
+var listPaymentMethods = async (_ctx, _customerId) => {
+  return { ...NOT_IMPLEMENTED, data: null };
 };
-var deletePaymentMethod = async (...args) => {
-  throw new Error("Not implemented");
+var deletePaymentMethod = async (_ctx, _id) => {
+  return { ...NOT_IMPLEMENTED, data: false };
 };
 
-// src/clients/v1/index.ts
+// src/api/v1/index.ts
 var PolarClientV1 = class {
   // ===========================================================================
   // LIFECYCLE & WEBHOOKS
@@ -392,6 +969,9 @@ var PolarClientV1 = class {
   parseWebhookEvent(payload) {
     return parseWebhookEvent(payload);
   }
+  setupPaymentMethod(ctx, input) {
+    return setupPaymentMethod(ctx, input);
+  }
   listPaymentMethods(ctx, customerId) {
     return listPaymentMethods(ctx, customerId);
   }
@@ -408,7 +988,7 @@ var PolarClientV1 = class {
     return getPayment(ctx, id);
   }
   refundPayment(ctx, input) {
-    return refundPayment(ctx, input);
+    return refundPayment(ctx, input.paymentId, input.amount);
   }
   listPayments(ctx, pagination) {
     return listPayments(ctx, pagination);
@@ -450,9 +1030,6 @@ var PolarClientV1 = class {
   createCheckoutSession(ctx, input) {
     return createCheckoutSession(ctx, input);
   }
-  setupPaymentMethod(ctx, input) {
-    return setupPaymentMethod(ctx, input);
-  }
   createBillingPortalSession(ctx, input) {
     return createBillingPortalSession(ctx, input);
   }
@@ -474,27 +1051,9 @@ var PolarClientV1 = class {
   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
+// src/api/factory.ts
 function getClient(_config) {
   return new PolarClientV1();
 }
@@ -502,7 +1061,7 @@ function getClient(_config) {
 // src/provider.ts
 import {
   BaseProvider,
-  RevstackErrorCode
+  RevstackErrorCode as RevstackErrorCode7
 } from "@revstackhq/providers-core";
 var PolarProvider = class extends BaseProvider {
   static manifest = manifest;
@@ -519,7 +1078,7 @@ var PolarProvider = class extends BaseProvider {
         data: { success: false },
         status: "failed",
         error: {
-          code: RevstackErrorCode.InvalidCredentials,
+          code: RevstackErrorCode7.InvalidCredentials,
           message: "Failed to connect to provider. Please check your API Key / Secrets."
         }
       };
@@ -537,7 +1096,7 @@ var PolarProvider = class extends BaseProvider {
             data: { success: false },
             status: "failed",
             error: {
-              code: RevstackErrorCode.UnknownError,
+              code: RevstackErrorCode7.UnknownError,
               message: "Failed to setup webhooks in Polar"
             }
           };
@@ -552,7 +1111,7 @@ var PolarProvider = class extends BaseProvider {
           data: { success: false },
           status: "failed",
           error: {
-            code: RevstackErrorCode.MisconfiguredProvider,
+            code: RevstackErrorCode7.MisconfiguredProvider,
             message: `Webhook setup failed: ${error.message}`
           }
         };
@@ -611,7 +1170,7 @@ var PolarProvider = class extends BaseProvider {
         data: null,
         status: "failed",
         error: {
-          code: RevstackErrorCode.NotImplemented,
+          code: RevstackErrorCode7.NotImplemented,
           message: `Provider '${this.manifest.slug}' does not support createPayment.`
         }
       };
@@ -625,7 +1184,7 @@ var PolarProvider = class extends BaseProvider {
         data: null,
         status: "failed",
         error: {
-          code: RevstackErrorCode.NotImplemented,
+          code: RevstackErrorCode7.NotImplemented,
           message: "Get payment not supported"
         }
       };
@@ -639,26 +1198,26 @@ var PolarProvider = class extends BaseProvider {
         data: null,
         status: "failed",
         error: {
-          code: RevstackErrorCode.NotImplemented,
+          code: RevstackErrorCode7.NotImplemented,
           message: "Refunds not supported by this provider version"
         }
       };
     }
     return client.refundPayment(ctx, input);
   }
-  async listPayments(ctx, pagination) {
+  async listPayments(ctx, pagination, filters) {
     const client = getClient(ctx.config);
     if (!client.listPayments) {
       return {
         data: null,
         status: "failed",
         error: {
-          code: RevstackErrorCode.NotImplemented,
+          code: RevstackErrorCode7.NotImplemented,
           message: "List payments not supported"
         }
       };
     }
-    return client.listPayments(ctx, pagination);
+    return client.listPayments(ctx, pagination, filters);
   }
   // ===========================================================================
   // SUBSCRIPTIONS
@@ -670,7 +1229,7 @@ var PolarProvider = class extends BaseProvider {
         data: null,
         status: "failed",
         error: {
-          code: RevstackErrorCode.NotImplemented,
+          code: RevstackErrorCode7.NotImplemented,
           message: "Subscriptions not supported"
         }
       };
@@ -684,7 +1243,7 @@ var PolarProvider = class extends BaseProvider {
         data: null,
         status: "failed",
         error: {
-          code: RevstackErrorCode.NotImplemented,
+          code: RevstackErrorCode7.NotImplemented,
           message: "Get subscription not supported"
         }
       };
@@ -698,7 +1257,7 @@ var PolarProvider = class extends BaseProvider {
         data: null,
         status: "failed",
         error: {
-          code: RevstackErrorCode.NotImplemented,
+          code: RevstackErrorCode7.NotImplemented,
           message: "Cancel subscription not supported"
         }
       };
@@ -712,7 +1271,7 @@ var PolarProvider = class extends BaseProvider {
         data: null,
         status: "failed",
         error: {
-          code: RevstackErrorCode.NotImplemented,
+          code: RevstackErrorCode7.NotImplemented,
           message: "Pause subscription not supported"
         }
       };
@@ -726,7 +1285,7 @@ var PolarProvider = class extends BaseProvider {
         data: null,
         status: "failed",
         error: {
-          code: RevstackErrorCode.NotImplemented,
+          code: RevstackErrorCode7.NotImplemented,
           message: "Resume subscription not supported"
         }
       };
@@ -743,7 +1302,7 @@ var PolarProvider = class extends BaseProvider {
         data: null,
         status: "failed",
         error: {
-          code: RevstackErrorCode.NotImplemented,
+          code: RevstackErrorCode7.NotImplemented,
           message: "Checkout not supported"
         }
       };
@@ -760,7 +1319,7 @@ var PolarProvider = class extends BaseProvider {
         data: null,
         status: "failed",
         error: {
-          code: RevstackErrorCode.NotImplemented,
+          code: RevstackErrorCode7.NotImplemented,
           message: "Customer management not supported"
         }
       };
@@ -774,7 +1333,7 @@ var PolarProvider = class extends BaseProvider {
         data: null,
         status: "failed",
         error: {
-          code: RevstackErrorCode.NotImplemented,
+          code: RevstackErrorCode7.NotImplemented,
           message: "Customer update not supported"
         }
       };
@@ -788,7 +1347,7 @@ var PolarProvider = class extends BaseProvider {
         data: false,
         status: "failed",
         error: {
-          code: RevstackErrorCode.NotImplemented,
+          code: RevstackErrorCode7.NotImplemented,
           message: "Customer deletion not supported"
         }
       };
@@ -802,7 +1361,7 @@ var PolarProvider = class extends BaseProvider {
         data: null,
         status: "failed",
         error: {
-          code: RevstackErrorCode.NotImplemented,
+          code: RevstackErrorCode7.NotImplemented,
           message: "Get customer not supported"
         }
       };
@@ -819,7 +1378,7 @@ var PolarProvider = class extends BaseProvider {
         data: null,
         status: "failed",
         error: {
-          code: RevstackErrorCode.NotImplemented,
+          code: RevstackErrorCode7.NotImplemented,
           message: "List payment methods not supported"
         }
       };
@@ -833,7 +1392,7 @@ var PolarProvider = class extends BaseProvider {
         data: false,
         status: "failed",
         error: {
-          code: RevstackErrorCode.NotImplemented,
+          code: RevstackErrorCode7.NotImplemented,
           message: "Delete payment method not supported"
         }
       };
@@ -850,26 +1409,26 @@ var PolarProvider = class extends BaseProvider {
         data: null,
         status: "failed",
         error: {
-          code: RevstackErrorCode.NotImplemented,
+          code: RevstackErrorCode7.NotImplemented,
           message: "Capture not supported"
         }
       };
     }
     return client.capturePayment(ctx, id, amount);
   }
-  async listSubscriptions(ctx, pagination) {
+  async listSubscriptions(ctx, pagination, filters) {
     const client = getClient(ctx.config);
     if (!client.listSubscriptions) {
       return {
         data: null,
         status: "failed",
         error: {
-          code: RevstackErrorCode.NotImplemented,
+          code: RevstackErrorCode7.NotImplemented,
           message: "List subscriptions not supported"
         }
       };
     }
-    return client.listSubscriptions(ctx, pagination);
+    return client.listSubscriptions(ctx, pagination, filters);
   }
   async updateSubscription(ctx, id, input) {
     const client = getClient(ctx.config);
@@ -878,26 +1437,26 @@ var PolarProvider = class extends BaseProvider {
         data: null,
         status: "failed",
         error: {
-          code: RevstackErrorCode.NotImplemented,
+          code: RevstackErrorCode7.NotImplemented,
           message: "Update subscription not supported"
         }
       };
     }
     return client.updateSubscription(ctx, id, input);
   }
-  async listCustomers(ctx, pagination) {
+  async listCustomers(ctx, pagination, filters) {
     const client = getClient(ctx.config);
     if (!client.listCustomers) {
       return {
         data: null,
         status: "failed",
         error: {
-          code: RevstackErrorCode.NotImplemented,
+          code: RevstackErrorCode7.NotImplemented,
           message: "List customers not supported"
         }
       };
     }
-    return client.listCustomers(ctx, pagination);
+    return client.listCustomers(ctx, pagination, filters);
   }
   async setupPaymentMethod(ctx, input) {
     const client = getClient(ctx.config);
@@ -906,7 +1465,7 @@ var PolarProvider = class extends BaseProvider {
         data: null,
         status: "failed",
         error: {
-          code: RevstackErrorCode.NotImplemented,
+          code: RevstackErrorCode7.NotImplemented,
           message: "Setup payment method not supported"
         }
       };
@@ -920,86 +1479,13 @@ var PolarProvider = class extends BaseProvider {
         data: null,
         status: "failed",
         error: {
-          code: RevstackErrorCode.NotImplemented,
+          code: RevstackErrorCode7.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,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@revstackhq/provider-polar",
-  "version": "0.0.0-dev-20260301204402",
+  "version": "0.0.0",
   "private": false,
   "license": "FSL-1.1-MIT",
   "type": "module",
@@ -22,7 +22,7 @@
   "dependencies": {
     "@polar-sh/sdk": "^0.45.1",
     "dotenv": "^17.2.4",
-    "@revstackhq/providers-core": "0.0.0-dev-20260301195257"
+    "@revstackhq/providers-core": "0.0.0"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.1",