@antelopejs/interface-subscriptions 0.0.0-stage → 0.0.1

package/dist/tests/support.d.ts

@@ -0,0 +1,77 @@
+import { type Amount, type Payment } from "@antelopejs/interface-payment";
+import { type Subscription, type SubscriptionRequest } from "../index";
+export declare const SUITE_TIMEOUT = 60000;
+export declare const PERIOD_VALUE = 1900;
+export declare const RETURN_URL = "https://merchant.invalid/return/subscription";
+export declare const DAY_MS: number;
+export declare const SHORTEST_MONTH_MS: number;
+export declare const LONGEST_MONTH_MS: number;
+export declare const TRIAL_DAYS = 14;
+/**
+ * Providers keep creation times and schedule times to the second. Two
+ * subscriptions created within the same second may list in either order, and a
+ * requested trial end or billing anchor comes back truncated to the second.
+ */
+export declare const PROVIDER_CLOCK_RESOLUTION_MS = 1100;
+/** A time `ahead` from now, on a whole second, which every provider can echo exactly. */
+export declare function inWholeSeconds(ahead: number): number;
+/** An identifier no provider has a subscription for. */
+export declare const ABSENT_ID: string;
+/**
+ * A provider-specific token that the payment interface charges successfully
+ * on-session with `savePaymentMethod`, and whose saved method it then charges
+ * off-session. The same variable the payment interface's suite reads.
+ */
+export declare const TEST_METHOD: string | undefined;
+/**
+ * A provider-specific token that saves on-session, and whose saved method the
+ * provider declines off-session.
+ *
+ * There is no portable way to obtain one. Without it, the declined-first-period
+ * test is skipped.
+ */
+export declare const TEST_METHOD_DECLINES_LATER: string | undefined;
+/**
+ * Set when the implementation's events can reach this process during a test
+ * run. A native provider delivers them from webhooks, which a test container
+ * cannot usually receive; the generic fallback raises them in-process.
+ */
+export declare const EVENTS_OBSERVABLE: boolean;
+export declare const CHARGEABLE = "requires ANTELOPE_PAYMENT_TEST_METHOD";
+export declare const DECLINES_LATER = "requires ANTELOPE_SUBSCRIPTIONS_TEST_METHOD_DECLINES_LATER";
+export declare const OBSERVABLE = "requires ANTELOPE_SUBSCRIPTIONS_TEST_EVENTS";
+export declare function amount(value: number): Amount;
+export declare function key(): string;
+export declare function reference(): string;
+/**
+ * Asserts a timestamp is epoch milliseconds rather than epoch seconds, and is
+ * not further from now than `horizon` allows.
+ */
+export declare function assertEpochMillis(value: number, label: string, horizon?: number): void;
+/**
+ * Asserts the invariants every subscription holds, whatever its state.
+ */
+export declare function assertSubscriptionShape(subscription: Subscription, request: SubscriptionRequest): void;
+/**
+ * Polls until the payment leaves `pending`, the only status an off-session
+ * charge can sit in.
+ */
+export declare function settledPayment(id: string): Promise<Payment>;
+/**
+ * A customer with a method saved the only way the contract allows: an
+ * on-session payment that saves it, taken with the payer present.
+ */
+export interface Payer {
+    customer: string;
+    paymentMethod: string;
+}
+export declare function newPayer(token?: string | undefined): Promise<Payer>;
+/** Saves another method against an existing customer and returns its id. */
+export declare function saveMethod(customer: string, token?: string | undefined): Promise<string>;
+export declare function monthly(payer: Payer, overrides?: Partial<SubscriptionRequest>): SubscriptionRequest;
+export declare function subscribe(payer: Payer, overrides?: Partial<SubscriptionRequest>): Promise<Subscription>;
+/**
+ * Asserts that a call rejects with exactly the given error class, rather than
+ * any Error at all.
+ */
+export declare function rejectsWith(work: Promise<unknown>, expected: abstract new (...args: never[]) => Error, label: string): Promise<Error>;

package/dist/tests/support.js

@@ -0,0 +1,181 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OBSERVABLE = exports.DECLINES_LATER = exports.CHARGEABLE = exports.EVENTS_OBSERVABLE = exports.TEST_METHOD_DECLINES_LATER = exports.TEST_METHOD = exports.ABSENT_ID = exports.PROVIDER_CLOCK_RESOLUTION_MS = exports.TRIAL_DAYS = exports.LONGEST_MONTH_MS = exports.SHORTEST_MONTH_MS = exports.DAY_MS = exports.RETURN_URL = exports.PERIOD_VALUE = exports.SUITE_TIMEOUT = void 0;
+exports.inWholeSeconds = inWholeSeconds;
+exports.amount = amount;
+exports.key = key;
+exports.reference = reference;
+exports.assertEpochMillis = assertEpochMillis;
+exports.assertSubscriptionShape = assertSubscriptionShape;
+exports.settledPayment = settledPayment;
+exports.newPayer = newPayer;
+exports.saveMethod = saveMethod;
+exports.monthly = monthly;
+exports.subscribe = subscribe;
+exports.rejectsWith = rejectsWith;
+const strict_1 = __importDefault(require("node:assert/strict"));
+const node_crypto_1 = require("node:crypto");
+const promises_1 = require("node:timers/promises");
+const interface_payment_1 = require("@antelopejs/interface-payment");
+const index_1 = require("../index");
+exports.SUITE_TIMEOUT = 60_000;
+const SETTLE_TIMEOUT = 30_000;
+const SETTLE_INTERVAL = 500;
+exports.PERIOD_VALUE = 1900;
+exports.RETURN_URL = "https://merchant.invalid/return/subscription";
+exports.DAY_MS = 24 * 60 * 60 * 1000;
+const SHORTEST_MONTH_DAYS = 28;
+const LONGEST_MONTH_DAYS = 31;
+exports.SHORTEST_MONTH_MS = SHORTEST_MONTH_DAYS * exports.DAY_MS;
+exports.LONGEST_MONTH_MS = LONGEST_MONTH_DAYS * exports.DAY_MS;
+exports.TRIAL_DAYS = 14;
+/**
+ * Providers keep creation times and schedule times to the second. Two
+ * subscriptions created within the same second may list in either order, and a
+ * requested trial end or billing anchor comes back truncated to the second.
+ */
+exports.PROVIDER_CLOCK_RESOLUTION_MS = 1100;
+const SECOND_MS = 1000;
+/** A time `ahead` from now, on a whole second, which every provider can echo exactly. */
+function inWholeSeconds(ahead) {
+    return Math.floor((Date.now() + ahead) / SECOND_MS) * SECOND_MS;
+}
+/** An identifier no provider has a subscription for. */
+exports.ABSENT_ID = `antelope-absent-${"0".repeat(24)}`;
+/**
+ * A provider-specific token that the payment interface charges successfully
+ * on-session with `savePaymentMethod`, and whose saved method it then charges
+ * off-session. The same variable the payment interface's suite reads.
+ */
+exports.TEST_METHOD = process.env.ANTELOPE_PAYMENT_TEST_METHOD;
+/**
+ * A provider-specific token that saves on-session, and whose saved method the
+ * provider declines off-session.
+ *
+ * There is no portable way to obtain one. Without it, the declined-first-period
+ * test is skipped.
+ */
+exports.TEST_METHOD_DECLINES_LATER = process.env.ANTELOPE_SUBSCRIPTIONS_TEST_METHOD_DECLINES_LATER;
+/**
+ * Set when the implementation's events can reach this process during a test
+ * run. A native provider delivers them from webhooks, which a test container
+ * cannot usually receive; the generic fallback raises them in-process.
+ */
+exports.EVENTS_OBSERVABLE = Boolean(process.env.ANTELOPE_SUBSCRIPTIONS_TEST_EVENTS);
+const CURRENCY = process.env.ANTELOPE_PAYMENT_TEST_CURRENCY || "EUR";
+exports.CHARGEABLE = "requires ANTELOPE_PAYMENT_TEST_METHOD";
+exports.DECLINES_LATER = "requires ANTELOPE_SUBSCRIPTIONS_TEST_METHOD_DECLINES_LATER";
+exports.OBSERVABLE = "requires ANTELOPE_SUBSCRIPTIONS_TEST_EVENTS";
+function amount(value) {
+    return { value, currency: CURRENCY };
+}
+function key() {
+    return `antelope-conformance-${(0, node_crypto_1.randomUUID)()}`;
+}
+function reference() {
+    return `conformance-${(0, node_crypto_1.randomUUID)()}`;
+}
+const EPOCH_MILLIS_FLOOR = Date.UTC(2020, 0, 1);
+const CLOCK_SKEW_ALLOWANCE = 5 * 60 * 1000;
+/**
+ * Asserts a timestamp is epoch milliseconds rather than epoch seconds, and is
+ * not further from now than `horizon` allows.
+ */
+function assertEpochMillis(value, label, horizon = CLOCK_SKEW_ALLOWANCE) {
+    strict_1.default.ok(Number.isInteger(value), `${label} must be an integer`);
+    strict_1.default.ok(value > EPOCH_MILLIS_FLOOR, `${label} is ${value}, which is not epoch milliseconds (seconds, perhaps?)`);
+    strict_1.default.ok(value < Date.now() + horizon, `${label} is ${value}, further ahead than expected`);
+}
+/**
+ * Asserts the invariants every subscription holds, whatever its state.
+ */
+function assertSubscriptionShape(subscription, request) {
+    strict_1.default.ok(subscription.id.length > 0, "subscription id must be non-empty");
+    strict_1.default.ok(index_1.SUBSCRIPTION_STATUSES.includes(subscription.status), `status ${subscription.status} is outside the contract`);
+    strict_1.default.equal(subscription.reference, request.reference);
+    strict_1.default.equal(subscription.customer, request.customer);
+    strict_1.default.equal(subscription.interval, request.interval);
+    strict_1.default.equal(subscription.intervalCount, request.intervalCount ?? 1);
+    strict_1.default.deepEqual(subscription.amount, request.amount);
+    strict_1.default.equal(typeof subscription.cancelAtPeriodEnd, "boolean");
+    assertEpochMillis(subscription.createdAt, "createdAt");
+    assertEpochMillis(subscription.currentPeriodStart, "currentPeriodStart");
+    assertEpochMillis(subscription.currentPeriodEnd, "currentPeriodEnd", 400 * exports.DAY_MS);
+    strict_1.default.ok(subscription.currentPeriodEnd > subscription.currentPeriodStart, "a period must end after it starts");
+    const isCanceled = subscription.status === "canceled";
+    strict_1.default.equal(subscription.endedAt !== undefined, isCanceled, "endedAt is present exactly when the subscription has ended");
+    strict_1.default.equal(subscription.endReason !== undefined, isCanceled, "endReason is present exactly when the subscription has ended");
+}
+/**
+ * Polls until the payment leaves `pending`, the only status an off-session
+ * charge can sit in.
+ */
+async function settledPayment(id) {
+    const deadline = Date.now() + SETTLE_TIMEOUT;
+    let payment = await (0, interface_payment_1.GetPayment)(id);
+    while (!(0, interface_payment_1.isTerminalPaymentStatus)(payment.status) && Date.now() < deadline) {
+        await (0, promises_1.setTimeout)(SETTLE_INTERVAL);
+        payment = await (0, interface_payment_1.GetPayment)(id);
+    }
+    return payment;
+}
+const customers = [];
+after(async () => {
+    await Promise.all(customers.map((id) => (0, interface_payment_1.DeleteCustomer)(id, key()).catch(() => undefined)));
+});
+async function newPayer(token = exports.TEST_METHOD) {
+    const customer = await (0, interface_payment_1.CreateCustomer)({ email: `${(0, node_crypto_1.randomUUID)()}@merchant.invalid`, name: "Conformance Payer" }, key());
+    customers.push(customer.id);
+    return {
+        customer: customer.id,
+        paymentMethod: await saveMethod(customer.id, token),
+    };
+}
+/** Saves another method against an existing customer and returns its id. */
+async function saveMethod(customer, token = exports.TEST_METHOD) {
+    const before = await (0, interface_payment_1.ListPaymentMethods)(customer);
+    const payment = await (0, interface_payment_1.CreatePayment)({
+        amount: amount(exports.PERIOD_VALUE),
+        reference: reference(),
+        customer,
+        paymentMethod: token,
+        savePaymentMethod: true,
+        returnUrl: exports.RETURN_URL,
+    }, key());
+    const settled = await settledPayment(payment.id);
+    strict_1.default.equal(settled.status, "succeeded", "the saving payment must succeed");
+    const known = new Set(before.map((method) => method.id));
+    const saved = (await (0, interface_payment_1.ListPaymentMethods)(customer)).find((method) => !known.has(method.id));
+    strict_1.default.ok(saved, "the saving payment must leave a method saved");
+    return saved.id;
+}
+function monthly(payer, overrides = {}) {
+    return {
+        reference: reference(),
+        customer: payer.customer,
+        paymentMethod: payer.paymentMethod,
+        amount: amount(exports.PERIOD_VALUE),
+        interval: "month",
+        description: "Conformance subscription",
+        ...overrides,
+    };
+}
+async function subscribe(payer, overrides = {}) {
+    const request = monthly(payer, overrides);
+    const subscription = await (0, index_1.CreateSubscription)(request, key());
+    assertSubscriptionShape(subscription, request);
+    return subscription;
+}
+/**
+ * Asserts that a call rejects with exactly the given error class, rather than
+ * any Error at all.
+ */
+async function rejectsWith(work, expected, label) {
+    const error = await work.then(() => undefined, (reason) => reason);
+    strict_1.default.ok(error instanceof expected, `${label}: expected ${expected.name}, got ${String(error)}`);
+    return error;
+}
+//# sourceMappingURL=support.js.map

package/dist/tests/support.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"support.js","sourceRoot":"","sources":["../../src/tests/support.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,228 @@
+import type { Amount } from "@antelopejs/interface-payment";
+/**
+ * Every value {@link SubscriptionInterval} can take.
+ */
+export declare const SUBSCRIPTION_INTERVALS: readonly ["day", "week", "month", "year"];
+/**
+ * The unit a billing period is counted in.
+ *
+ * Calendar units are calendar units: a `month` period that starts on 31 January
+ * ends on the last day of February, and the one after it ends on 31 March. The
+ * day of the month comes from the billing anchor, not from the end of the
+ * previous period, so short months do not drift the cycle.
+ */
+export type SubscriptionInterval = (typeof SUBSCRIPTION_INTERVALS)[number];
+/**
+ * The longest billing period every implementation must accept: one year.
+ *
+ * Providers cap the period differently. A request for a longer one may be
+ * refused with {@link InvalidSubscriptionRequestError}.
+ */
+export declare const MAX_PORTABLE_PERIOD_DAYS = 366;
+/**
+ * Every value {@link SubscriptionStatus} can take, in lifecycle order.
+ */
+export declare const SUBSCRIPTION_STATUSES: readonly ["trialing", "active", "past_due", "canceled"];
+/**
+ * Normalised subscription status.
+ *
+ * | Status | Meaning |
+ * | --- | --- |
+ * | `trialing` | Before {@link Subscription.trialEnd}. Nothing has been charged. |
+ * | `active` | The current period is paid for, or not yet due. |
+ * | `past_due` | Charging the current period failed. The implementation is retrying under its own policy. |
+ * | `canceled` | Ended. Terminal: nothing is charged again. |
+ *
+ * `past_due` is reported the same way everywhere, but what happens next is
+ * not portable: native providers follow their configured retry schedule, and
+ * the generic fallback follows its documented policy. Decide access by status;
+ * do not predict when a `past_due` subscription will recover or end.
+ */
+export type SubscriptionStatus = (typeof SUBSCRIPTION_STATUSES)[number];
+/**
+ * Whether a subscription has ended for good.
+ *
+ * @param status - The status to classify
+ * @returns true for `canceled` only
+ */
+export declare function isTerminalSubscriptionStatus(status: SubscriptionStatus): boolean;
+/**
+ * Every value {@link SubscriptionEndReason} can take.
+ */
+export declare const SUBSCRIPTION_END_REASONS: readonly ["requested", "payment_failed"];
+/**
+ * Why a subscription ended: someone cancelled it, or the implementation gave up
+ * charging it.
+ */
+export type SubscriptionEndReason = (typeof SUBSCRIPTION_END_REASONS)[number];
+/**
+ * Every value {@link CancellationTiming} can take.
+ */
+export declare const CANCELLATION_TIMINGS: readonly ["now", "period_end"];
+/**
+ * When {@link CancelSubscription} takes effect.
+ *
+ * - `now` ends the subscription immediately. Nothing is refunded: a refund is a
+ *   separate `RefundPayment` through the payment interface.
+ * - `period_end` lets the period that has been paid for run out, and ends the
+ *   subscription then instead of renewing it. The status does not change until
+ *   it ends.
+ */
+export type CancellationTiming = (typeof CANCELLATION_TIMINGS)[number];
+/**
+ * A subscription, in whatever state it was last reported in.
+ *
+ * `id` is opaque. Correlate with your own records through
+ * {@link Subscription.reference}.
+ */
+export interface Subscription {
+    /** Opaque identifier. */
+    id: string;
+    /** The caller's own identifier, echoed back from the request. */
+    reference: string;
+    /** Opaque payment-interface customer identifier. */
+    customer: string;
+    /** Opaque payment-interface identifier of the saved method charged. */
+    paymentMethod: string;
+    /** Charged once per period. */
+    amount: Amount;
+    /** The unit a period is counted in. */
+    interval: SubscriptionInterval;
+    /** How many `interval`s make one period. At least 1. */
+    intervalCount: number;
+    /** Normalised status. */
+    status: SubscriptionStatus;
+    /**
+     * Unix epoch milliseconds. Start of the period most recently billed for, or
+     * of the trial or pre-anchor period before the first charge.
+     */
+    currentPeriodStart: number;
+    /**
+     * Unix epoch milliseconds. When the current period ends and the next one is
+     * charged, unless {@link Subscription.cancelAtPeriodEnd} is set.
+     */
+    currentPeriodEnd: number;
+    /** Unix epoch milliseconds. Present when the subscription began with a trial. */
+    trialEnd?: number;
+    /** The subscription ends at `currentPeriodEnd` instead of renewing. */
+    cancelAtPeriodEnd: boolean;
+    /** Unix epoch milliseconds. Present exactly when `status` is `canceled`. */
+    endedAt?: number;
+    /** Present exactly when `status` is `canceled`. */
+    endReason?: SubscriptionEndReason;
+    /**
+     * Opaque payment-interface identifier of the most recent charge attempt.
+     * Absent until something has been charged.
+     */
+    latestPayment?: string;
+    /** Unix epoch milliseconds. */
+    createdAt: number;
+    /** The metadata the subscription was created with. */
+    metadata?: Record<string, string>;
+    /**
+     * What the provider said about this subscription, verbatim, for logs and
+     * support tickets.
+     *
+     * Read-only. Nothing a caller does with this object reaches the provider, and
+     * no request type accepts it: provider-specific behaviour belongs in the
+     * provider's own interface, where the coupling is visible.
+     */
+    vendorData?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Parameters for {@link CreateSubscription}.
+ *
+ * The payer is not present. Take the mandate first, with an on-session
+ * payment-interface payment that sets `savePaymentMethod`, and pass the method
+ * it saved.
+ */
+export interface SubscriptionRequest {
+    /** Your own identifier for this subscription. */
+    reference: string;
+    /** Opaque payment-interface customer identifier. */
+    customer: string;
+    /**
+     * Opaque payment-interface identifier of a method saved against `customer`
+     * and chargeable off-session, from `ListPaymentMethods`.
+     */
+    paymentMethod: string;
+    /** Charged once per period. A positive integer of minor units. */
+    amount: Amount;
+    /** The unit a period is counted in. */
+    interval: SubscriptionInterval;
+    /** How many `interval`s make one period. Defaults to 1. */
+    intervalCount?: number;
+    /**
+     * Unix epoch milliseconds. Start with a free trial that ends here; the first
+     * charge is made at this time. Must be in the future. Mutually exclusive with
+     * `billingAnchor`. Kept at the provider's precision, which is at least the
+     * second: pass a whole second to have it echoed exactly.
+     */
+    trialEnd?: number;
+    /**
+     * Unix epoch milliseconds. Start the first paid period here rather than now;
+     * nothing is charged before it, and the status is `active` meanwhile. Must
+     * be in the future. Mutually exclusive with `trialEnd`. Kept at the
+     * provider's precision, which is at least the second.
+     */
+    billingAnchor?: number;
+    /** Shown to the payer where supported. */
+    description?: string;
+    /** Round-tripped opaque key/value pairs. */
+    metadata?: Record<string, string>;
+}
+/**
+ * Every value {@link SubscriptionEventType} can take.
+ */
+export declare const SUBSCRIPTION_EVENT_TYPES: readonly ["subscription.created", "subscription.payment_succeeded", "subscription.payment_failed", "subscription.canceled"];
+/**
+ * Normalised subscription event type.
+ *
+ * | Type | When |
+ * | --- | --- |
+ * | `subscription.created` | The subscription exists. |
+ * | `subscription.payment_succeeded` | A period was paid for, including the first. |
+ * | `subscription.payment_failed` | Charging a period failed; the status is `past_due`. |
+ * | `subscription.canceled` | The subscription ended, for any {@link SubscriptionEndReason}. |
+ */
+export type SubscriptionEventType = (typeof SUBSCRIPTION_EVENT_TYPES)[number];
+/**
+ * Something that happened to a subscription, normalised.
+ *
+ * Delivered at least once. De-duplicate on {@link SubscriptionEvent.id}.
+ */
+export interface SubscriptionEvent {
+    /** Opaque identifier, stable across redeliveries of the same event. */
+    id: string;
+    /** Normalised type. */
+    type: SubscriptionEventType;
+    /** Unix epoch milliseconds. */
+    createdAt: number;
+    /** The subscription as it was when the event happened. */
+    subscription: Subscription;
+    /**
+     * Opaque payment-interface identifier of the charge behind a
+     * `subscription.payment_*` event. Read it with `GetPayment`.
+     *
+     * Absent from a `subscription.payment_failed` when the provider refused to
+     * make the charge at all — the saved method was removed, say — since there is
+     * no payment to point at.
+     */
+    payment?: string;
+}
+/**
+ * Receives subscription events.
+ *
+ * A rejection, or a throw, means the event was not handled and will be
+ * delivered again.
+ */
+export type SubscriptionEventHandler = (event: SubscriptionEvent) => void | Promise<void>;
+/**
+ * The metadata key every charge made for a subscription carries, set to the
+ * subscription's identifier.
+ *
+ * Those charges are ordinary payment-interface payments, so their
+ * `payment.*` events reach your payment webhook route as well. Use this key to
+ * tell them from one-off payments.
+ */
+export declare const SUBSCRIPTION_METADATA_KEY = "antelopeSubscription";

package/dist/types.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SUBSCRIPTION_METADATA_KEY = exports.SUBSCRIPTION_EVENT_TYPES = exports.CANCELLATION_TIMINGS = exports.SUBSCRIPTION_END_REASONS = exports.SUBSCRIPTION_STATUSES = exports.MAX_PORTABLE_PERIOD_DAYS = exports.SUBSCRIPTION_INTERVALS = void 0;
+exports.isTerminalSubscriptionStatus = isTerminalSubscriptionStatus;
+/**
+ * Every value {@link SubscriptionInterval} can take.
+ */
+exports.SUBSCRIPTION_INTERVALS = Object.freeze([
+    "day",
+    "week",
+    "month",
+    "year",
+]);
+/**
+ * The longest billing period every implementation must accept: one year.
+ *
+ * Providers cap the period differently. A request for a longer one may be
+ * refused with {@link InvalidSubscriptionRequestError}.
+ */
+exports.MAX_PORTABLE_PERIOD_DAYS = 366;
+/**
+ * Every value {@link SubscriptionStatus} can take, in lifecycle order.
+ */
+exports.SUBSCRIPTION_STATUSES = Object.freeze([
+    "trialing",
+    "active",
+    "past_due",
+    "canceled",
+]);
+/**
+ * Whether a subscription has ended for good.
+ *
+ * @param status - The status to classify
+ * @returns true for `canceled` only
+ */
+function isTerminalSubscriptionStatus(status) {
+    return status === "canceled";
+}
+/**
+ * Every value {@link SubscriptionEndReason} can take.
+ */
+exports.SUBSCRIPTION_END_REASONS = Object.freeze([
+    "requested",
+    "payment_failed",
+]);
+/**
+ * Every value {@link CancellationTiming} can take.
+ */
+exports.CANCELLATION_TIMINGS = Object.freeze([
+    "now",
+    "period_end",
+]);
+/**
+ * Every value {@link SubscriptionEventType} can take.
+ */
+exports.SUBSCRIPTION_EVENT_TYPES = Object.freeze([
+    "subscription.created",
+    "subscription.payment_succeeded",
+    "subscription.payment_failed",
+    "subscription.canceled",
+]);
+/**
+ * The metadata key every charge made for a subscription carries, set to the
+ * subscription's identifier.
+ *
+ * Those charges are ordinary payment-interface payments, so their
+ * `payment.*` events reach your payment webhook route as well. Use this key to
+ * tell them from one-off payments.
+ */
+exports.SUBSCRIPTION_METADATA_KEY = "antelopeSubscription";
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AA+DA,oEAIC;AAjED;;GAEG;AACU,QAAA,sBAAsB,GAAG,MAAM,CAAC,MAAM,CAAC;IAClD,KAAK;IACL,MAAM;IACN,OAAO;IACP,MAAM;CACE,CAAC,CAAC;AAYZ;;;;;GAKG;AACU,QAAA,wBAAwB,GAAG,GAAG,CAAC;AAE5C;;GAEG;AACU,QAAA,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAAC;IACjD,UAAU;IACV,QAAQ;IACR,UAAU;IACV,UAAU;CACF,CAAC,CAAC;AAmBZ;;;;;GAKG;AACH,SAAgB,4BAA4B,CAC1C,MAA0B;IAE1B,OAAO,MAAM,KAAK,UAAU,CAAC;AAC/B,CAAC;AAED;;GAEG;AACU,QAAA,wBAAwB,GAAG,MAAM,CAAC,MAAM,CAAC;IACpD,WAAW;IACX,gBAAgB;CACR,CAAC,CAAC;AAQZ;;GAEG;AACU,QAAA,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC;IAChD,KAAK;IACL,YAAY;CACJ,CAAC,CAAC;AAqHZ;;GAEG;AACU,QAAA,wBAAwB,GAAG,MAAM,CAAC,MAAM,CAAC;IACpD,sBAAsB;IACtB,gCAAgC;IAChC,6BAA6B;IAC7B,uBAAuB;CACf,CAAC,CAAC;AAiDZ;;;;;;;GAOG;AACU,QAAA,yBAAyB,GAAG,sBAAsB,CAAC"}

package/dist/validation.d.ts

@@ -0,0 +1,16 @@
+import { type SubscriptionRequest } from "./types";
+/**
+ * Checks a {@link SubscriptionRequest} against the portable contract, so every
+ * implementation refuses the same request shapes. Consumers can supply `now`
+ * to also check that trial and billing dates are in the future.
+ *
+ * Implementations may omit `now` only when their provider validates future
+ * dates after checking for an idempotent replay. This lets a saved result be
+ * returned after its original date has passed without accepting a new request
+ * with a past date. Finite timestamps and all other rules are always checked.
+ *
+ * @param request - The request to check
+ * @param now - Optional Unix epoch milliseconds for relative date validation
+ * @throws InvalidSubscriptionRequestError naming the first rule broken
+ */
+export declare function ValidateSubscriptionRequest(request: SubscriptionRequest, now?: number): void;

package/dist/validation.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidateSubscriptionRequest = ValidateSubscriptionRequest;
+const errors_1 = require("./errors");
+const types_1 = require("./types");
+function positiveInteger(value) {
+    return typeof value === "number" && Number.isInteger(value) && value > 0;
+}
+function validTime(value, now) {
+    return (value === undefined ||
+        (Number.isFinite(value) && (now === undefined || value > now)));
+}
+const RULES = [
+    (request) => request.reference ? undefined : "reference must be a non-empty string",
+    (request) => (request.customer ? undefined : "customer is required"),
+    (request) => request.paymentMethod ? undefined : "paymentMethod is required",
+    (request) => positiveInteger(request.amount?.value)
+        ? undefined
+        : "amount must be a positive integer of minor units",
+    (request) => /^[A-Z]{3}$/.test(request.amount?.currency ?? "")
+        ? undefined
+        : "amount.currency must be an uppercase ISO-4217 code",
+    (request) => types_1.SUBSCRIPTION_INTERVALS.includes(request.interval)
+        ? undefined
+        : `interval must be one of ${types_1.SUBSCRIPTION_INTERVALS.join(", ")}`,
+    (request) => request.intervalCount === undefined ||
+        positiveInteger(request.intervalCount)
+        ? undefined
+        : "intervalCount must be a positive integer",
+    (request) => request.trialEnd !== undefined && request.billingAnchor !== undefined
+        ? "trialEnd and billingAnchor are mutually exclusive"
+        : undefined,
+    (request, now) => validTime(request.trialEnd, now)
+        ? undefined
+        : "trialEnd must be a finite timestamp in the future",
+    (request, now) => validTime(request.billingAnchor, now)
+        ? undefined
+        : "billingAnchor must be a finite timestamp in the future",
+];
+/**
+ * Checks a {@link SubscriptionRequest} against the portable contract, so every
+ * implementation refuses the same request shapes. Consumers can supply `now`
+ * to also check that trial and billing dates are in the future.
+ *
+ * Implementations may omit `now` only when their provider validates future
+ * dates after checking for an idempotent replay. This lets a saved result be
+ * returned after its original date has passed without accepting a new request
+ * with a past date. Finite timestamps and all other rules are always checked.
+ *
+ * @param request - The request to check
+ * @param now - Optional Unix epoch milliseconds for relative date validation
+ * @throws InvalidSubscriptionRequestError naming the first rule broken
+ */
+function ValidateSubscriptionRequest(request, now) {
+    const problem = RULES.map((rule) => rule(request, now)).find(Boolean);
+    if (problem)
+        throw new errors_1.InvalidSubscriptionRequestError(problem);
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":";;AAmEA,kEAMC;AAzED,qCAA2D;AAC3D,mCAA2E;AAI3E,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,SAAS,CAAC,KAAyB,EAAE,GAAY;IACxD,OAAO,CACL,KAAK,KAAK,SAAS;QACnB,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,GAAG,GAAG,CAAC,CAAC,CAC/D,CAAC;AACJ,CAAC;AAED,MAAM,KAAK,GAAW;IACpB,CAAC,OAAO,EAAE,EAAE,CACV,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,sCAAsC;IACxE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,sBAAsB,CAAC;IACpE,CAAC,OAAO,EAAE,EAAE,CACV,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,2BAA2B;IACjE,CAAC,OAAO,EAAE,EAAE,CACV,eAAe,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC;QACpC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,kDAAkD;IACxD,CAAC,OAAO,EAAE,EAAE,CACV,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,IAAI,EAAE,CAAC;QAC/C,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,oDAAoD;IAC1D,CAAC,OAAO,EAAE,EAAE,CACV,8BAAsB,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC;QAC/C,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,2BAA2B,8BAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;IACpE,CAAC,OAAO,EAAE,EAAE,CACV,OAAO,CAAC,aAAa,KAAK,SAAS;QACnC,eAAe,CAAC,OAAO,CAAC,aAAa,CAAC;QACpC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,0CAA0C;IAChD,CAAC,OAAO,EAAE,EAAE,CACV,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,aAAa,KAAK,SAAS;QACnE,CAAC,CAAC,mDAAmD;QACrD,CAAC,CAAC,SAAS;IACf,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,CACf,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;QAC9B,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,mDAAmD;IACzD,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,CACf,SAAS,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;QACnC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,wDAAwD;CAC/D,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,SAAgB,2BAA2B,CACzC,OAA4B,EAC5B,GAAY;IAEZ,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtE,IAAI,OAAO;QAAE,MAAM,IAAI,wCAA+B,CAAC,OAAO,CAAC,CAAC;AAClE,CAAC"}