@vandenberghinc/volt 1.2.4 → 1.2.6

package/backend/dist/cjs/backend/src/payments/stripe/error.js

@@ -1,64 +0,0 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-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);
-var stdin_exports = {};
-__export(stdin_exports, {
-  ExternalStripeError: () => ExternalStripeError,
-  InternalStripeError: () => InternalStripeError
-});
-module.exports = __toCommonJS(stdin_exports);
-var import_internal_external = require("../../errors/internal_external.js");
-class InternalStripeError extends import_internal_external.InternalError {
-  /** Stable error code for programmatic handling (never include secrets). */
-  error_code;
-  /** Optional safe context for debugging (never include secrets). */
-  context;
-  /** Constructs a StripeWrapperError. */
-  constructor(code, message, context, cause) {
-    super({
-      message,
-      type: code,
-      cause
-    });
-    this.name = "StripeError";
-    this.error_code = code;
-    this.context = context;
-    this.cause = cause;
-  }
-}
-class ExternalStripeError extends import_internal_external.ExternalError {
-  /** Stable error code for programmatic handling (never include secrets). */
-  error_code;
-  /** Optional safe context for debugging (never include secrets). */
-  context;
-  /** Constructs a StripeWrapperError. */
-  constructor(code, message, context, cause) {
-    super({
-      message,
-      type: code,
-      cause
-    });
-    this.name = "StripeError";
-    this.error_code = code;
-    this.context = context;
-  }
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  ExternalStripeError,
-  InternalStripeError
-});

package/backend/dist/cjs/backend/src/payments/stripe/events.d.ts

@@ -1,155 +0,0 @@
-/**
- * @author Daan van den Bergh
- * @copyright © 2026 - 2026 Daan van den Bergh. All rights reserved
- */
-import Stripe from "stripe";
-import { StripeResolvedSubscriptionItem } from "./webhooks.js";
-/**
- * Stripe webhook-driven events emitted by this module.
- *
- * These event names are intentionally explicit and stable.
- * Consumers can subscribe via `server.on("<event-type>", cb)` if your Server supports it,
- * or you can route them via `server.events.trigger("<event-type>", args)` as done below.
- */
-export type StripeEvents = {
-    /**
-     * Fired when a Stripe Checkout Session is completed.
-     *
-     * Docs: https://docs.stripe.com/api/events/types#event_types-checkout.session.completed
-     *
-     * @note The defined events are executed in parallel and are awaited inside the webhook handler.
-     */
-    "stripe.checkout_session_completed": (opts: {
-        /** The internal user id resolved from metadata. */
-        uid: string;
-        /** Stripe checkout session id. */
-        stripe_session_id: string;
-        /** Stripe checkout mode. */
-        mode: "payment" | "subscription" | "setup";
-        /** Stripe customer id. */
-        stripe_customer_id: string;
-        /** Stripe subscription id (only for mode="subscription"). */
-        stripe_subscription_id?: string;
-        /** Currency if available on the session. */
-        currency?: string;
-        /** Session metadata (safe). */
-        metadata: Stripe.Metadata;
-    }) => void | Promise<void>;
-    /**
-     * Fired when a Stripe subscription is created.
-     * Docs: https://docs.stripe.com/api/events/types#event_types-customer.subscription.created
-     *
-     * @note The defined events are executed in parallel and are awaited inside the webhook handler.
-     */
-    "stripe.subscription_created": (opts: {
-        /** The internal user id. */
-        uid: string;
-        /** Stripe subscription id. */
-        stripe_subscription_id: string;
-        /** Stripe customer id. */
-        stripe_customer_id: string;
-        /** Stripe subscription status. */
-        status: Stripe.Subscription.Status;
-        /**
-         * Matched subscription items (price -> plan/product mapping when resolvable).
-         * This can contain multiple items if the subscription has multiple prices.
-         */
-        items: StripeResolvedSubscriptionItem[];
-    }) => void | Promise<void>;
-    /**
-     * Fired when a Stripe subscription is updated.
-     * Docs: https://docs.stripe.com/api/events/types#event_types-customer.subscription.updated
-     *
-     * @note The defined events are executed in parallel and are awaited inside the webhook handler.
-     */
-    "stripe.subscription_updated": (opts: {
-        uid: string;
-        stripe_subscription_id: string;
-        stripe_customer_id: string;
-        status: Stripe.Subscription.Status;
-        items: StripeResolvedSubscriptionItem[];
-        cancel_at_period_end?: boolean;
-    }) => void | Promise<void>;
-    /**
-     * Fired when a Stripe subscription is deleted/canceled.
-     * Docs: https://docs.stripe.com/api/events/types#event_types-customer.subscription.deleted
-     *
-     * @note The defined events are executed in parallel and are awaited inside the webhook handler.
-     */
-    "stripe.subscription_deleted": (opts: {
-        uid: string;
-        stripe_subscription_id: string;
-        stripe_customer_id: string;
-        status: Stripe.Subscription.Status;
-        items: StripeResolvedSubscriptionItem[];
-    }) => void | Promise<void>;
-    /**
-     * Fired when an invoice is paid successfully.
-     * Docs: https://docs.stripe.com/api/events/types#event_types-invoice.paid
-     *
-     * @note The defined events are executed in parallel and are awaited inside the webhook handler.
-     */
-    "stripe.invoice_paid": (opts: {
-        uid: string;
-        stripe_invoice_id: string;
-        stripe_customer_id: string;
-        amount_paid: number;
-        currency: string;
-        hosted_invoice_url?: string;
-    }) => void | Promise<void>;
-    /**
-     * Fired when an invoice payment fails.
-     * Docs: https://docs.stripe.com/api/events/types#event_types-invoice.payment_failed
-     *
-     * @note The defined events are executed in parallel and are awaited inside the webhook handler.
-     */
-    "stripe.invoice_payment_failed": (opts: {
-        uid: string;
-        stripe_invoice_id: string;
-        stripe_customer_id: string;
-        amount_due: number;
-        currency: string;
-        hosted_invoice_url?: string;
-    }) => void | Promise<void>;
-    /**
-     * Fired when a PaymentIntent succeeds (covers one-time and some subscription flows).
-     * Docs: https://docs.stripe.com/api/events/types#event_types-payment_intent.succeeded
-     *
-     * @note The defined events are executed in parallel and are awaited inside the webhook handler.
-     */
-    "stripe.payment_succeeded": (opts: {
-        uid: string;
-        stripe_payment_intent_id: string;
-        stripe_customer_id?: string;
-        amount_received: number;
-        currency: string;
-        metadata: Stripe.Metadata;
-    }) => void | Promise<void>;
-    /**
-     * Fired when a PaymentIntent fails.
-     * Docs: https://docs.stripe.com/api/events/types#event_types-payment_intent.payment_failed
-     *
-     * @note The defined events are executed in parallel and are awaited inside the webhook handler.
-     */
-    "stripe.payment_failed": (opts: {
-        uid: string;
-        stripe_payment_intent_id: string;
-        stripe_customer_id?: string;
-        amount: number;
-        currency: string;
-        last_payment_error_message?: string;
-        metadata: Stripe.Metadata;
-    }) => void | Promise<void>;
-    /**
-     * Fired when a SetupIntent succeeds and we (best-effort) set the default payment method.
-     * Docs: https://docs.stripe.com/api/events/types#event_types-setup_intent.succeeded
-     *
-     * @note The defined events are executed in parallel and are awaited inside the webhook handler.
-     */
-    "stripe.payment_method_ready": (opts: {
-        uid: string;
-        stripe_customer_id: string;
-        stripe_setup_intent_id: string;
-        stripe_payment_method_id: string;
-    }) => void | Promise<void>;
-};

package/backend/dist/cjs/backend/src/payments/stripe/events.js

@@ -1,15 +0,0 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-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);
-var stdin_exports = {};
-module.exports = __toCommonJS(stdin_exports);

package/backend/dist/cjs/backend/src/payments/stripe/meters.d.ts

@@ -1,105 +0,0 @@
-/**
- * @author Daan van den Bergh
- * @copyright © 2026 - 2026 Daan van den Bergh. All rights reserved
- */
-import Stripe from "stripe";
-import { InitializedMeterProduct, InitializedProduct, MeterProduct } from "./products.js";
-import { Server } from "../../server.js";
-type AmountRounding = "exact" | "floor" | "ceil" | "round";
-/**
- * The options for recording meter usage.
- */
-export type RecordMeterUsageOpts<Kind extends MeterProduct.Kind> = {
-    /** The internal user id (uid) whose usage should be recorded. */
-    uid: string;
-    /** The initialized meter product to record usage for. */
-    product: InitializedMeterProduct<Kind extends "units" ? MeterProduct.UnitsMeter : Kind extends "money" ? MeterProduct.MoneyMeter : never>;
-    /**
-     * Optional event timestamp.
-     * Must be within the past 35 calendar days or up to 5 minutes in the future.
-     * @see https://docs.stripe.com/api/billing/meter-event/create
-     */
-    timestamp?: Date;
-    /**
-     * Event identifier to deduplicate accidental retries.
-     * Stripe enforces uniqueness within a rolling >=24h window.
-     * Must be non-empty, max 100 chars, and contain only letters, numbers, dots, underscores or hyphens.
-     * @see https://docs.stripe.com/api/billing/meter-event/create
-     */
-    identifier: string;
-} & (Kind extends "units" ? {
-    /**
-     * The numeric usage value to record (integer).
-     * For "sum"/"last" meters this is the numeric value.
-     * For "count" meters this can be 1 per event (but we still send a value).
-     */
-    value: number;
-} : Kind extends "money" ? {
-    /**
-     * Money amount in major units (e.g., "0.007463" USD), used only when product.kind === "money".
-     * Can be string or number (number is normalized to string).
-     */
-    amount: string | number;
-    /**
-     * Rounding mode used when converting amount to internal integer units.
-     * @default "exact"
-     * @warning When round is `exact`, amounts with more precision than supported will be rejected by a thrown error, to prevent silent rounding bugs. Use an explicit rounding mode to allow lossy conversions.
-     */
-    round?: AmountRounding;
-} : never);
-/**
- * The result of recording meter usage.
- */
-export interface RecordMeterUsageResult {
-    /** The Stripe billing meter event id. */
-    meter_event_identifier: string;
-    /** The meter event name used. */
-    event_name: string;
-    /** The unix timestamp (seconds) used for the event, if provided. */
-    timestamp: number;
-}
-/**
- * Record usage for a metered subscription by creating a Stripe Billing Meter Event.
- *
- * Security & correctness guarantees:
- * - Requires that the user has an active-ish subscription containing the meter product's price id.
- * - Uses the meter's configured payload keys for customer/value mapping.
- * - Allows caller-provided `identifier` to dedupe retries.
- *
- * Stripe docs:
- * - Create meter event: https://docs.stripe.com/api/billing/meter-event/create
- * - Record usage guide: https://docs.stripe.com/billing/subscriptions/usage-based/recording-usage-api
- *
- * @throws {InternalStripeError} When round mode is `exact` and the amount has more precision than supported.
- * @throws {InternalStripeError} On internal errors.
- * @throws {ExternalStripeError} On external errors such as the customer not being entitled to record usage for the meter product.
- */
-export declare function record_meter_usage<Kind extends MeterProduct.Kind>(client: Stripe, server: Server, all_products: InitializedProduct[], opts: RecordMeterUsageOpts<Kind>): Promise<RecordMeterUsageResult>;
-/** The options for {@link cancel_meter_usage_event} */
-export interface CancelMeterUsageEventOpts {
-    /** The user id. */
-    uid: string;
-    /** The meter product whose event stream the event belongs to. */
-    product: InitializedMeterProduct;
-    /** The identifier of the meter event to cancel. */
-    meter_event_identifier: string;
-}
-/** The result type of {@link cancel_meter_usage_event} */
-export interface CancelMeterUsageEventResult {
-    /** The identifier of the canceled meter event. */
-    meter_event_identifier: string;
-    /** The status of the adjustment created to cancel the event. Typically "pending". */
-    status: string;
-}
-/**
- * Cancel a previously recorded meter event by identifier (best-effort within 24 hours).
- *
- * This is useful for:
- * - reverting accidental double-reporting
- * - compensating failed internal workflows
- *
- * Stripe docs:
- * - Create meter event adjustment: https://docs.stripe.com/api/billing/meter-event-adjustment/create
- */
-export declare function cancel_meter_usage_event(client: Stripe, server: Server, all_products: InitializedProduct[], opts: CancelMeterUsageEventOpts): Promise<CancelMeterUsageEventResult>;
-export {};

package/backend/dist/cjs/backend/src/payments/stripe/meters.js

@@ -1,230 +0,0 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-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);
-var stdin_exports = {};
-__export(stdin_exports, {
-  cancel_meter_usage_event: () => cancel_meter_usage_event,
-  record_meter_usage: () => record_meter_usage
-});
-module.exports = __toCommonJS(stdin_exports);
-var import_customers = require("./customers.js");
-var import_error = require("./error.js");
-var import_utils = require("./utils.js");
-var import_products = require("./products.js");
-var import_subscriptions = require("./subscriptions.js");
-function money_major_to_pico_cents_units(amount, round) {
-  const s = amount.trim();
-  (0, import_utils.assert)(s.length > 0, "invalid_argument", "Property 'amount' must be a non-empty string.", { amount });
-  (0, import_utils.assert)(/^\d+(\.\d+)?$/.test(s), "invalid_argument", "Property 'amount' must be a non-negative decimal.", { amount });
-  const [whole_raw, frac_raw = ""] = s.split(".");
-  const whole = whole_raw ?? "0";
-  const frac = frac_raw ?? "";
-  const SHIFT = import_products.MeterProduct.MONEY_METER_MAJOR_TO_PICO_CENTS_SHIFT;
-  const frac_padded = frac + "0".repeat(SHIFT);
-  const frac_keep = frac_padded.slice(0, SHIFT);
-  const frac_rest = frac_padded.slice(SHIFT);
-  const remainder_nonzero = /[1-9]/.test(frac_rest);
-  let increment = false;
-  if (frac.length > SHIFT || remainder_nonzero) {
-    if (round === "exact") {
-      (0, import_utils.assert)(!remainder_nonzero, "invalid_argument", "Property 'amount' has more precision than supported for exact conversion.", {
-        amount,
-        max_decimals: SHIFT
-      });
-    } else if (round === "floor") {
-    } else if (round === "ceil") {
-      increment = remainder_nonzero;
-    } else if (round === "round") {
-      increment = frac_rest.length > 0 && frac_rest[0] >= "5";
-    } else {
-      round.toString();
-      throw new import_error.InternalStripeError("invalid_argument", `Invalid rounding: ${round}`, { round });
-    }
-  }
-  const raw_int_str = (whole + frac_keep).replace(/^0+/, "") || "0";
-  let units = BigInt(raw_int_str);
-  if (increment) {
-    units += 1n;
-  }
-  return units.toString();
-}
-function normalize_amount_to_string(amount) {
-  if (typeof amount === "string") {
-    return amount;
-  }
-  (0, import_utils.assert)(Number.isFinite(amount), "invalid_argument", "Property 'amount' must be a finite number.", { amount });
-  (0, import_utils.assert)(Math.abs(amount) < 1e21, "invalid_argument", "Property 'amount' number is too large.", { amount });
-  const s = amount.toFixed(20);
-  return s.replace(/\.?0+$/, "");
-}
-function validate_meter_event_identifier(identifier) {
-  (0, import_utils.assert)(identifier.length <= 100, "invalid_argument", "Meter event identifier must be <= 100 characters.", { identifier_length: identifier.length });
-  (0, import_utils.assert)(identifier.trim().length > 0, "invalid_argument", "Meter event identifier must be non-empty.", {
-    identifier_length: identifier.length
-  });
-  (0, import_utils.assert)(/^[a-zA-Z0-9._-]+$/.test(identifier), "invalid_argument", "Meter event identifier contains invalid characters.", {});
-}
-function validate_meter_event_timestamp(now, timestamp) {
-  const now_ms = now.getTime();
-  const ts_ms = timestamp.getTime();
-  (0, import_utils.assert)(Number.isFinite(ts_ms), "invalid_argument", "Meter event timestamp is invalid.", {});
-  const max_past_ms = 35 * 24 * 60 * 60 * 1e3;
-  const max_future_ms = 5 * 60 * 1e3;
-  (0, import_utils.assert)(ts_ms >= now_ms - max_past_ms, "invalid_argument", "Meter event timestamp is too far in the past.", { now_ms, ts_ms });
-  (0, import_utils.assert)(ts_ms <= now_ms + max_future_ms, "invalid_argument", "Meter event timestamp is too far in the future.", { now_ms, ts_ms });
-}
-async function assert_customer_entitled_for_meter_price(client, server, opts) {
-  const active_meters = await (0, import_subscriptions.list_subscribed_meters)(client, server, {
-    uid: opts.uid,
-    stripe_customer_id: opts.stripe_customer_id,
-    all_products: opts.all_products
-  });
-  if (!active_meters[opts.meter_product.id]) {
-    throw new import_error.ExternalStripeError("subscription_not_active", "You must be subscribed to use this metered feature.", { uid: opts.uid, stripe_customer_id: opts.stripe_customer_id, meter_product: opts.meter_product.id });
-  }
-}
-function resolve_meter_payload_keys(product) {
-  const customer_key = product.customer_mapping_event_payload_key ?? "stripe_customer_id";
-  const value_key = product.value_settings_event_payload_key ?? "value";
-  (0, import_utils.assert)(customer_key.trim().length > 0, "invalid_product", "Meter customer payload key must be non-empty.", {
-    product_id: product.id,
-    customer_key
-  });
-  (0, import_utils.assert)(value_key.trim().length > 0, "invalid_product", "Meter value payload key must be non-empty.", {
-    product_id: product.id,
-    value_key
-  });
-  (0, import_utils.assert)(customer_key.length <= 100, "invalid_product", "Meter customer payload key must be <= 100 characters.", {
-    product_id: product.id,
-    customer_key_length: customer_key.length
-  });
-  (0, import_utils.assert)(value_key.length <= 100, "invalid_product", "Meter value payload key must be <= 100 characters.", {
-    product_id: product.id,
-    value_key_length: value_key.length
-  });
-  return { customer_key, value_key };
-}
-async function record_meter_usage(client, server, all_products, opts) {
-  (0, import_utils.public_assert)((0, import_utils.is_non_empty_string)(opts.uid), "invalid_argument", "Property 'uid' must be a non-empty string.");
-  (0, import_utils.assert)(opts.product.type === "meter", "invalid_argument", "Property 'product' must be a meter product.", {
-    product_type: opts.product.type
-  });
-  (0, import_utils.assert)((0, import_utils.is_non_empty_string)(opts.product.meter_event_name) && opts.product.meter_event_name.length <= 100, "invalid_product", "Meter product meter_event_name is invalid.", { product_id: opts.product.id, meter_event_name: opts.product.meter_event_name });
-  let value_str;
-  const meter_kind = opts.product.kind ?? "units";
-  if (meter_kind === "money") {
-    (0, import_utils.assert)("amount" in opts, "invalid_argument", "Property 'amount' must be provided for money meters.", {
-      product_id: opts.product.id
-    });
-    const rounding = opts.round ?? "exact";
-    const amount_str = normalize_amount_to_string(opts.amount);
-    value_str = money_major_to_pico_cents_units(amount_str, rounding);
-    (0, import_utils.assert)(BigInt(value_str) >= 0n, "invalid_argument", "Property 'amount' must be >= 0.", {
-      amount: amount_str,
-      value_str
-    });
-  } else if (meter_kind === "units") {
-    (0, import_utils.assert)("value" in opts, "invalid_argument", "Property 'value' must be provided for unit meters.", {
-      product_id: opts.product.id
-    });
-    (0, import_utils.assert)(Number.isFinite(opts.value), "invalid_argument", "Property 'value' must be a finite number.", { value: opts.value });
-    (0, import_utils.assert)(opts.value >= 0, "invalid_argument", "Property 'value' must be >= 0.", { value: opts.value });
-    (0, import_utils.assert)(Number.isInteger(opts.value), "invalid_argument", "Property 'value' must be an integer.", { value: opts.value });
-    value_str = `${opts.value}`;
-  } else {
-    meter_kind.toString();
-    throw new import_error.InternalStripeError("invalid_product", `Invalid MeterProduct kind: ${meter_kind}`, {
-      product_id: opts.product.id,
-      meter_kind
-    });
-  }
-  const identifier = opts.identifier;
-  validate_meter_event_identifier(identifier);
-  const now = /* @__PURE__ */ new Date();
-  const timestamp_seconds = opts.timestamp ? (0, import_utils.to_unix_seconds)(opts.timestamp) : null;
-  if (opts.timestamp) {
-    validate_meter_event_timestamp(now, opts.timestamp);
-  }
-  const stripe_customer_id = await (0, import_customers.ensure_stripe_customer)(client, server, opts.uid);
-  await assert_customer_entitled_for_meter_price(client, server, {
-    uid: opts.uid,
-    meter_product: opts.product,
-    stripe_customer_id,
-    all_products
-  });
-  const { customer_key, value_key } = resolve_meter_payload_keys(opts.product);
-  const payload = {
-    [customer_key]: stripe_customer_id,
-    [value_key]: value_str
-  };
-  const meter_event = await (0, import_utils.stripe_api_call)(() => client.billing.meterEvents.create(
-    {
-      event_name: opts.product.meter_event_name,
-      payload,
-      identifier,
-      ...timestamp_seconds !== null ? { timestamp: timestamp_seconds } : {}
-    },
-    // Idempotency at the HTTP layer in addition to Stripe's identifier dedupe helps during transient retries.
-    { idempotencyKey: (0, import_utils.stable_idempotency_key)(`meter_event_create_${identifier}`, 255) }
-  ), {
-    operation: "billing.meterEvents.create",
-    uid: opts.uid,
-    stripe_customer_id,
-    stripe_price_id: opts.product.stripe_price_id,
-    meter_event_name: opts.product.meter_event_name,
-    identifier,
-    timestamp_seconds
-  });
-  return {
-    meter_event_identifier: meter_event.identifier,
-    event_name: meter_event.event_name,
-    timestamp: meter_event.timestamp
-  };
-}
-async function cancel_meter_usage_event(client, server, all_products, opts) {
-  (0, import_utils.public_assert)(opts.product.type === "meter", "invalid_argument", "Property 'product' must be a meter product.", {
-    product_type: opts.product.type
-  });
-  (0, import_utils.public_assert)((0, import_utils.is_non_empty_string)(opts.uid), "invalid_argument", "Property 'uid' must be a non-empty string.");
-  (0, import_utils.public_assert)((0, import_utils.is_non_empty_string)(opts.meter_event_identifier), "invalid_argument", "Property 'identifier' must be a non-empty string.");
-  validate_meter_event_identifier(opts.meter_event_identifier);
-  const stripe_customer_id = await (0, import_customers.ensure_stripe_customer)(client, server, opts.uid);
-  await assert_customer_entitled_for_meter_price(client, server, {
-    uid: opts.uid,
-    meter_product: opts.product,
-    stripe_customer_id,
-    all_products
-  });
-  const adjustment = await (0, import_utils.stripe_api_call)(() => client.billing.meterEventAdjustments.create({
-    event_name: opts.product.meter_event_name,
-    type: "cancel",
-    cancel: { identifier: opts.meter_event_identifier }
-  }, { idempotencyKey: (0, import_utils.stable_idempotency_key)(`meter_event_cancel_${opts.meter_event_identifier}`, 255) }), {
-    operation: "billing.meterEventAdjustments.create",
-    meter_event_name: opts.product.meter_event_name,
-    identifier: opts.meter_event_identifier
-  });
-  return {
-    meter_event_identifier: opts.meter_event_identifier,
-    status: adjustment.status
-  };
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  cancel_meter_usage_event,
-  record_meter_usage
-});

package/backend/dist/cjs/backend/src/payments/stripe/payment_methods.d.ts

@@ -1,58 +0,0 @@
-/**
- * @author Daan van den Bergh
- * @copyright © 2026 - 2026 Daan van den Bergh. All rights reserved
- */
-import Stripe from "stripe";
-import { Server } from "../../server.js";
-/**
- * Create a Stripe SetupIntent so the client can add a payment method and prepare it for off-session billing.
- *
- * Client flow:
- * - Call this endpoint to get `client_secret`.
- * - Confirm SetupIntent on the client (e.g. Stripe.js / mobile SDK).
- * - Call `finalize_payment_method_setup` with the returned `setup_intent_id`.
- *
- * Stripe docs:
- * - SetupIntents overview: https://docs.stripe.com/payments/setup-intents
- * - Create SetupIntent: https://docs.stripe.com/api/setup_intents/create
- */
-export declare function create_payment_method_setup_intent(client: Stripe, server: Server, opts: {
-    /** The internal user id, used to resolve/ensure Stripe customer. */
-    uid: string;
-    /** An optional idempotency key. */
-    idempotency_key?: string;
-}): Promise<{
-    /** The SetupIntent id. */
-    id: string;
-    /** The client secret used by the client to confirm the SetupIntent. */
-    client_secret: string;
-    /** The Stripe customer id. */
-    stripe_customer_id: string;
-}>;
-/**
- * Finalize a confirmed SetupIntent by setting its payment method as the customer's default for invoices/subscriptions.
- *
- * This ensures future subscription invoices can be charged automatically.
- *
- * Stripe docs:
- * - Retrieve SetupIntent: https://docs.stripe.com/api/setup_intents/retrieve
- * - Update customer invoice_settings.default_payment_method: https://docs.stripe.com/api/customers/update
- */
-export declare function finalize_payment_method_setup(client: Stripe, server: Server, opts: {
-    /** The internal user id, used to resolve/ensure Stripe customer. */
-    uid: string;
-    /**
-     * The SetupIntent id after client confirmation.
-     * The client should send this to the backend once confirmation succeeded.
-     */
-    setup_intent_id: string;
-    /** Optional idempotency key. */
-    idempotency_key?: string;
-}): Promise<{
-    /** The Stripe customer id. */
-    stripe_customer_id: string;
-    /** The payment method id that is now set as default. */
-    payment_method_id: string;
-    /** The SetupIntent id used to finalize. */
-    setup_intent_id: string;
-}>;