@peable.to/contracts 0.4.0 → 1.1.0

package/dist/cjs/resources/catalog/billingSettings.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.billingSettingsRoutes = exports.updateBillingSettingsParams = exports.billingSettingsSchema = void 0;
+const zod_1 = require("zod");
+const objects_1 = require("../../common/objects");
+const params_1 = require("../../common/params");
+const primitives_1 = require("../../common/primitives");
+const route_1 = require("../../route");
+const catalog_1 = require("../../vocabulary/catalog");
+/**
+ * The merchant's billing settings (ADR 0018 §5; one per merchant and mode).
+ * Every field has a default, so a merchant that never opens the screen bills
+ * correctly:
+ *
+ *  - `invoice_prefix`: derived from the merchant id; numbers are
+ *    `PREFIX-0001`, gapless per merchant.
+ *  - `dunning.retry_schedule_days`: `[1, 3, 5, 7]` — each retry so many days
+ *    after the previous attempt (16 days, four retries, Stripe's default
+ *    window).
+ *  - `dunning.final_action`: `cancel` — the subscription ends when the last
+ *    retry fails; `dunning.invoice_action`: `mark_uncollectible`.
+ *  - emails on: the payer is told when an invoice is finalized for them
+ *    (`send_invoice`) and when a payment fails.
+ */
+exports.billingSettingsSchema = (0, objects_1.defineObject)('billing_settings', 'BillingSettings', zod_1.z
+    .object({
+    object: zod_1.z.literal('billing_settings'),
+    livemode: primitives_1.livemode,
+    invoice_prefix: zod_1.z.string().describe('Invoice numbers are `PREFIX-0001`, gapless.'),
+    next_invoice_sequence: zod_1.z
+        .number()
+        .int()
+        .describe('The next invoice number that will be assigned.'),
+    default_days_until_due: zod_1.z.number().int(),
+    dunning: zod_1.z
+        .object({
+        retry_schedule_days: zod_1.z
+            .array(zod_1.z.number().int())
+            .describe('Each retry so many days after the previous attempt.'),
+        final_action: zod_1.z
+            .enum(catalog_1.DUNNING_FINAL_ACTIONS)
+            .describe('What happens to the subscription once the last retry fails.'),
+        invoice_action: zod_1.z
+            .enum(catalog_1.DUNNING_INVOICE_ACTIONS)
+            .describe('What happens to the invoice once the last retry fails.'),
+    })
+        .strict(),
+    emails: zod_1.z
+        .object({
+        invoice_finalized: zod_1.z.boolean(),
+        payment_failed: zod_1.z.boolean(),
+    })
+        .strict(),
+    updated: primitives_1.unixSeconds,
+})
+    .strict(), {
+    examples: [
+        {
+            object: 'billing_settings',
+            livemode: false,
+            invoice_prefix: 'MENTION',
+            next_invoice_sequence: 1,
+            default_days_until_due: 30,
+            dunning: {
+                retry_schedule_days: [1, 3, 5, 7],
+                final_action: 'cancel',
+                invoice_action: 'mark_uncollectible',
+            },
+            emails: { invoice_finalized: true, payment_failed: true },
+            updated: 1793750400,
+        },
+    ],
+});
+exports.updateBillingSettingsParams = zod_1.z
+    .object({
+    invoice_prefix: zod_1.z
+        .string()
+        .regex(new RegExp(catalog_1.BILLING_SETTINGS_LIMITS.invoicePrefixPattern))
+        .optional()
+        .describe('3–12 uppercase letters and digits.'),
+    default_days_until_due: zod_1.z
+        .number()
+        .int()
+        .min(0)
+        .max(catalog_1.BILLING_SETTINGS_LIMITS.daysUntilDueMax)
+        .optional(),
+    dunning: zod_1.z
+        .object({
+        retry_schedule_days: zod_1.z
+            .array(zod_1.z.number().int().min(1).max(catalog_1.BILLING_SETTINGS_LIMITS.retryDaysMax))
+            .max(catalog_1.BILLING_SETTINGS_LIMITS.retriesMax)
+            .optional(),
+        final_action: zod_1.z.enum(catalog_1.DUNNING_FINAL_ACTIONS).optional(),
+        invoice_action: zod_1.z.enum(catalog_1.DUNNING_INVOICE_ACTIONS).optional(),
+    })
+        .strict()
+        .optional(),
+    emails: zod_1.z
+        .object({ invoice_finalized: zod_1.z.boolean().optional(), payment_failed: zod_1.z.boolean().optional() })
+        .strict()
+        .optional(),
+})
+    .strict();
+exports.billingSettingsRoutes = [
+    (0, route_1.defineRoute)({
+        operationId: 'retrieveBillingSettings',
+        method: 'get',
+        path: '/v1/billing_settings',
+        tag: 'Billing settings',
+        summary: 'Retrieve the billing settings',
+        auth: 'service',
+        scope: 'payments:read',
+        query: params_1.expandOnlyQuery,
+        response: exports.billingSettingsSchema,
+        sdk: 'billingSettings.retrieve',
+    }),
+    (0, route_1.defineRoute)({
+        operationId: 'updateBillingSettings',
+        method: 'post',
+        path: '/v1/billing_settings',
+        tag: 'Billing settings',
+        summary: 'Update the billing settings',
+        description: 'Invoice numbering, the default payment term, dunning and the payer emails.',
+        auth: 'service',
+        scope: 'payments:write',
+        idempotent: true,
+        body: exports.updateBillingSettingsParams,
+        response: exports.billingSettingsSchema,
+        sdk: 'billingSettings.update',
+    }),
+];

package/dist/cjs/resources/catalog/coupons.js

@@ -0,0 +1,222 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.couponRoutes = exports.listCouponsQuery = exports.updateCouponParams = exports.createCouponParams = exports.deletedCouponSchema = exports.couponSchema = void 0;
+const zod_1 = require("zod");
+const envelopes_1 = require("../../common/envelopes");
+const objects_1 = require("../../common/objects");
+const params_1 = require("../../common/params");
+const primitives_1 = require("../../common/primitives");
+const route_1 = require("../../route");
+const catalog_1 = require("../../vocabulary/catalog");
+const shared_1 = require("./shared");
+/**
+ * Coupons (ADR 0018) — a discount, by percentage or by a fixed amount in one
+ * currency. Its `id` is the merchant's own (`SUMMER25`) or generated
+ * (`coupon_…`), and names that one coupon forever: a deleted coupon's id is
+ * never reused. Only `name` and `metadata` change; the terms of a discount a
+ * customer already holds cannot.
+ */
+exports.couponSchema = (0, objects_1.defineObject)('coupon', 'Coupon', zod_1.z
+    .object({
+    id: zod_1.z.string(),
+    object: zod_1.z.literal('coupon'),
+    livemode: primitives_1.livemode,
+    name: zod_1.z.string().nullable(),
+    percent_off: zod_1.z
+        .number()
+        .nullable()
+        .describe('0 < x ≤ 100, at most two decimals. Set exactly when `amount_off` is not.'),
+    amount_off: primitives_1.amount.nullable().describe('Base units taken off, in `currency`.'),
+    currency: primitives_1.currency.nullable(),
+    duration: zod_1.z.enum(catalog_1.COUPON_DURATIONS),
+    duration_in_months: zod_1.z
+        .number()
+        .int()
+        .nullable()
+        .describe('Months a `repeating` coupon lasts; `null` otherwise.'),
+    max_redemptions: zod_1.z.number().int().nullable(),
+    redeem_by: primitives_1.unixSeconds.nullable().describe('The last instant it can be redeemed.'),
+    times_redeemed: zod_1.z.number().int(),
+    valid: zod_1.z
+        .boolean()
+        .describe('Whether it can still be redeemed: not past `redeem_by` and not used up.'),
+    applies_to: zod_1.z
+        .object({ products: zod_1.z.array(zod_1.z.string()) })
+        .strict()
+        .nullable()
+        .describe('The products (`prod_…`) it is restricted to, or `null` for every product.'),
+    metadata: primitives_1.metadata,
+    created: primitives_1.unixSeconds,
+})
+    .strict(), {
+    examples: [
+        {
+            id: 'SUMMER25',
+            object: 'coupon',
+            livemode: false,
+            name: 'Summer sale',
+            percent_off: 25,
+            amount_off: null,
+            currency: null,
+            duration: 'repeating',
+            duration_in_months: 3,
+            max_redemptions: 100,
+            redeem_by: null,
+            times_redeemed: 0,
+            valid: true,
+            applies_to: null,
+            metadata: {},
+            created: 1793750400,
+        },
+    ],
+});
+/** What `DELETE /v1/coupons/{id}` answers. Existing discounts are not affected. */
+exports.deletedCouponSchema = (0, objects_1.defineComponent)('DeletedCoupon', (0, envelopes_1.deletedOf)('coupon'));
+/**
+ * A percentage with at most two decimals, as basis points (12.5 → 1250). The
+ * check is on the scaled value, so 33.333 is refused rather than rounded.
+ */
+const percentOff = zod_1.z
+    .number()
+    .gt(0)
+    .max(100)
+    .refine((value) => Math.abs(value * 100 - Math.round(value * 100)) < 1e-9, 'percent_off has at most two decimals')
+    .transform((value) => Math.round(value * 100));
+const couponId = zod_1.z
+    .string()
+    .regex(new RegExp(`^[A-Za-z0-9_-]{1,${catalog_1.CATALOG_LIMITS.couponIdMax}}$`), `a coupon id is 1–${catalog_1.CATALOG_LIMITS.couponIdMax} letters, digits, '_' or '-'`);
+const name = zod_1.z.string().min(1).max(catalog_1.CATALOG_LIMITS.couponNameMax);
+exports.createCouponParams = zod_1.z
+    .object({
+    id: couponId
+        .optional()
+        .describe('Your own id (`SUMMER25`); generated (`coupon_…`) when absent.'),
+    name: name.optional(),
+    percent_off: percentOff.optional(),
+    amount_off: shared_1.baseUnitAmountParam.optional(),
+    currency: primitives_1.currency.optional().describe('Required with `amount_off`.'),
+    duration: zod_1.z.enum(catalog_1.COUPON_DURATIONS).optional().describe('Default `once`.'),
+    duration_in_months: zod_1.z
+        .number()
+        .int()
+        .min(1)
+        .max(catalog_1.CATALOG_LIMITS.couponDurationInMonthsMax)
+        .optional()
+        .describe('Required for `repeating`.'),
+    max_redemptions: shared_1.countParam.optional(),
+    redeem_by: shared_1.positiveUnixSecondsParam.optional().describe('Unix seconds, in the future.'),
+    applies_to: zod_1.z
+        .object({
+        products: zod_1.z
+            .array(zod_1.z.string().min(1).max(255))
+            .min(1)
+            .max(catalog_1.CATALOG_LIMITS.couponAppliesToProductsMax),
+    })
+        .strict()
+        .optional(),
+    metadata: params_1.metadataCreateParam.optional(),
+    expand: params_1.expandParam.optional(),
+})
+    .strict()
+    .superRefine((body, ctx) => {
+    const issue = (path, message) => ctx.addIssue({ code: 'custom', path: [path], message });
+    if ((body.percent_off === undefined) === (body.amount_off === undefined)) {
+        issue('percent_off', 'a coupon takes exactly one of percent_off and amount_off');
+    }
+    if (body.amount_off !== undefined && body.currency === undefined) {
+        issue('currency', 'amount_off needs a currency');
+    }
+    if (body.amount_off === undefined && body.currency !== undefined) {
+        issue('currency', 'currency is only for an amount_off coupon');
+    }
+    if (body.amount_off === '0')
+        issue('amount_off', 'amount_off must be positive');
+    (0, shared_1.checkAmountBound)(ctx, body.amount_off, body.currency, ['amount_off']);
+    const duration = body.duration ?? 'once';
+    if (duration === 'repeating' && body.duration_in_months === undefined) {
+        issue('duration_in_months', 'a repeating coupon needs duration_in_months');
+    }
+    if (duration !== 'repeating' && body.duration_in_months !== undefined) {
+        issue('duration_in_months', 'duration_in_months is only for a repeating coupon');
+    }
+});
+exports.updateCouponParams = zod_1.z
+    .object({
+    name: (0, shared_1.clearing)(name).optional().describe('`""` clears it.'),
+    metadata: params_1.metadataUpdateParam.optional(),
+    expand: params_1.expandParam.optional(),
+})
+    .strict();
+exports.listCouponsQuery = (0, params_1.listQuery)({});
+exports.couponRoutes = [
+    (0, route_1.defineRoute)({
+        operationId: 'createCoupon',
+        method: 'post',
+        path: '/v1/coupons',
+        tag: 'Coupons',
+        summary: 'Create a coupon',
+        auth: 'service',
+        scope: 'payments:write',
+        idempotent: true,
+        body: exports.createCouponParams,
+        response: exports.couponSchema,
+        sdk: 'coupons.create',
+        expandable: 'coupon',
+    }),
+    (0, route_1.defineRoute)({
+        operationId: 'listCoupons',
+        method: 'get',
+        path: '/v1/coupons',
+        tag: 'Coupons',
+        summary: 'List coupons',
+        auth: 'service',
+        scope: 'payments:read',
+        query: exports.listCouponsQuery,
+        response: (0, envelopes_1.listOf)(exports.couponSchema),
+        sdk: 'coupons.list',
+        expandable: 'coupon',
+    }),
+    (0, route_1.defineRoute)({
+        operationId: 'retrieveCoupon',
+        method: 'get',
+        path: '/v1/coupons/{id}',
+        tag: 'Coupons',
+        summary: 'Retrieve a coupon',
+        auth: 'service',
+        scope: 'payments:read',
+        params: { id: 'The coupon (`SUMMER25`, `coupon_…`).' },
+        query: params_1.expandOnlyQuery,
+        response: exports.couponSchema,
+        sdk: 'coupons.retrieve',
+        expandable: 'coupon',
+    }),
+    (0, route_1.defineRoute)({
+        operationId: 'updateCoupon',
+        method: 'post',
+        path: '/v1/coupons/{id}',
+        tag: 'Coupons',
+        summary: 'Update a coupon',
+        description: 'Only `name` and `metadata` change.',
+        auth: 'service',
+        scope: 'payments:write',
+        idempotent: true,
+        params: { id: 'The coupon (`SUMMER25`, `coupon_…`).' },
+        body: exports.updateCouponParams,
+        response: exports.couponSchema,
+        sdk: 'coupons.update',
+        expandable: 'coupon',
+    }),
+    (0, route_1.defineRoute)({
+        operationId: 'deleteCoupon',
+        method: 'delete',
+        path: '/v1/coupons/{id}',
+        tag: 'Coupons',
+        summary: 'Delete a coupon',
+        description: 'Discounts customers already hold are not affected; the id is never reused.',
+        auth: 'service',
+        scope: 'payments:write',
+        params: { id: 'The coupon (`SUMMER25`, `coupon_…`).' },
+        response: exports.deletedCouponSchema,
+        sdk: 'coupons.del',
+    }),
+];

package/dist/cjs/resources/catalog/entitlements.js

@@ -0,0 +1,257 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.entitlementRoutes = exports.listActiveEntitlementsQuery = exports.listProductFeaturesQuery = exports.attachProductFeatureParams = exports.listEntitlementFeaturesQuery = exports.updateEntitlementFeatureParams = exports.createEntitlementFeatureParams = exports.activeEntitlementSummarySchema = exports.activeEntitlementSchema = exports.deletedProductFeatureSchema = exports.productFeatureSchema = exports.entitlementFeatureSchema = void 0;
+const zod_1 = require("zod");
+const envelopes_1 = require("../../common/envelopes");
+const objects_1 = require("../../common/objects");
+const params_1 = require("../../common/params");
+const primitives_1 = require("../../common/primitives");
+const route_1 = require("../../route");
+const shared_1 = require("./shared");
+/**
+ * Entitlements (ADR 0018 §8): features (`feat_…`) a product grants, and what a
+ * customer may access NOW. `lookup_key` is what an app checks access by.
+ */
+/** A feature (`feat_…`) a product grants — `lookup_key` is what an app checks. */
+exports.entitlementFeatureSchema = (0, objects_1.defineObject)('entitlements.feature', 'EntitlementFeature', zod_1.z
+    .object({
+    id: zod_1.z.string(),
+    object: zod_1.z.literal('entitlements.feature'),
+    livemode: primitives_1.livemode,
+    lookup_key: zod_1.z.string().describe('What an app checks access by; unique per merchant.'),
+    name: zod_1.z.string(),
+    active: zod_1.z
+        .boolean()
+        .describe('`false`: archived, and withdrawn from every customer that held it.'),
+    metadata: primitives_1.metadata,
+    created: primitives_1.unixSeconds,
+})
+    .strict(), {
+    examples: [
+        {
+            id: 'feat_0193b8f2c1a87d3e9f4f',
+            object: 'entitlements.feature',
+            livemode: false,
+            lookup_key: 'mention_plus',
+            name: 'Mention Plus',
+            active: true,
+            metadata: {},
+            created: 1793750400,
+        },
+    ],
+});
+/** A feature attached to a product (`prodft_…`). */
+exports.productFeatureSchema = (0, objects_1.defineObject)('product_feature', 'ProductFeature', zod_1.z
+    .object({
+    id: zod_1.z.string(),
+    object: zod_1.z.literal('product_feature'),
+    livemode: primitives_1.livemode,
+    product: zod_1.z.string().describe('The product (`prod_…`) that grants it.'),
+    entitlement_feature: exports.entitlementFeatureSchema,
+})
+    .strict(), {
+    examples: [
+        {
+            id: 'prodft_0193b8f2c1a87d3e9f50',
+            object: 'product_feature',
+            livemode: false,
+            product: 'prod_0193b8f2c1a87d3e9f4a',
+            entitlement_feature: {
+                id: 'feat_0193b8f2c1a87d3e9f4f',
+                object: 'entitlements.feature',
+                livemode: false,
+                lookup_key: 'mention_plus',
+                name: 'Mention Plus',
+                active: true,
+                metadata: {},
+                created: 1793750400,
+            },
+        },
+    ],
+});
+/** What `DELETE /v1/products/{id}/features/{feature}` answers. */
+exports.deletedProductFeatureSchema = (0, objects_1.defineComponent)('DeletedProductFeature', (0, envelopes_1.deletedOf)('product_feature'));
+/**
+ * One feature a customer is entitled to right now: some product granting it is
+ * on a `trialing`, `active` or `past_due` subscription of theirs. Several
+ * products granting the same feature give ONE entitlement — Mention Plus
+ * through the Plus product or through Oxy One is the same access.
+ */
+exports.activeEntitlementSchema = (0, objects_1.defineObject)('entitlements.active_entitlement', 'ActiveEntitlement', zod_1.z
+    .object({
+    id: zod_1.z.string().describe('Stable per customer and feature.'),
+    object: zod_1.z.literal('entitlements.active_entitlement'),
+    livemode: primitives_1.livemode,
+    feature: zod_1.z.string().describe('The feature (`feat_…`).'),
+    lookup_key: zod_1.z.string(),
+})
+    .strict(), {
+    examples: [
+        {
+            id: 'ent_5f1c0a9e2b7d4c3a8e6f1b2d',
+            object: 'entitlements.active_entitlement',
+            livemode: false,
+            feature: 'feat_0193b8f2c1a87d3e9f4f',
+            lookup_key: 'mention_plus',
+        },
+    ],
+});
+/** What `entitlements.active_entitlement_summary.updated` carries: a customer's complete set. */
+exports.activeEntitlementSummarySchema = (0, objects_1.defineObject)('entitlements.active_entitlement_summary', 'ActiveEntitlementSummary', zod_1.z
+    .object({
+    object: zod_1.z.literal('entitlements.active_entitlement_summary'),
+    livemode: primitives_1.livemode,
+    customer: zod_1.z.string().describe('The customer (`cus_…`).'),
+    entitlements: zod_1.z
+        .object({
+        object: zod_1.z.literal('list'),
+        data: zod_1.z.array(exports.activeEntitlementSchema),
+        has_more: zod_1.z.literal(false),
+        url: zod_1.z.string(),
+    })
+        .strict()
+        .describe('The complete set: never paged.'),
+})
+    .strict());
+const name = zod_1.z.string().min(1).max(80);
+exports.createEntitlementFeatureParams = zod_1.z
+    .object({
+    lookup_key: zod_1.z.string().regex(/^[A-Za-z0-9_.:-]{1,80}$/),
+    name,
+    metadata: params_1.metadataCreateParam.optional(),
+})
+    .strict();
+exports.updateEntitlementFeatureParams = zod_1.z
+    .object({
+    name: name.optional(),
+    active: zod_1.z
+        .boolean()
+        .optional()
+        .describe('`false` archives it and withdraws it from every customer that held it.'),
+    metadata: params_1.metadataUpdateParam.optional(),
+})
+    .strict();
+exports.listEntitlementFeaturesQuery = (0, params_1.listQuery)({
+    lookup_key: zod_1.z.string().min(1).max(80).optional(),
+    archived: shared_1.queryFlag.optional(),
+});
+exports.attachProductFeatureParams = zod_1.z
+    .object({ entitlement_feature: params_1.idParam.describe('The feature (`feat_…`) to grant.') })
+    .strict();
+exports.listProductFeaturesQuery = (0, params_1.listQuery)({});
+exports.listActiveEntitlementsQuery = (0, params_1.listQuery)({
+    customer: params_1.idParam.describe('The customer (`cus_…`).'),
+});
+const featureId = { id: 'The feature (`feat_…`).' };
+exports.entitlementRoutes = [
+    (0, route_1.defineRoute)({
+        operationId: 'createEntitlementFeature',
+        method: 'post',
+        path: '/v1/entitlements/features',
+        tag: 'Entitlements',
+        summary: 'Create a feature',
+        auth: 'service',
+        scope: 'payments:write',
+        idempotent: true,
+        body: exports.createEntitlementFeatureParams,
+        response: exports.entitlementFeatureSchema,
+        sdk: 'entitlements.features.create',
+    }),
+    (0, route_1.defineRoute)({
+        operationId: 'listEntitlementFeatures',
+        method: 'get',
+        path: '/v1/entitlements/features',
+        tag: 'Entitlements',
+        summary: 'List features',
+        auth: 'service',
+        scope: 'payments:read',
+        query: exports.listEntitlementFeaturesQuery,
+        response: (0, envelopes_1.listOf)(exports.entitlementFeatureSchema),
+        sdk: 'entitlements.features.list',
+        expandable: 'entitlements.feature',
+    }),
+    (0, route_1.defineRoute)({
+        operationId: 'retrieveEntitlementFeature',
+        method: 'get',
+        path: '/v1/entitlements/features/{id}',
+        tag: 'Entitlements',
+        summary: 'Retrieve a feature',
+        auth: 'service',
+        scope: 'payments:read',
+        params: featureId,
+        query: params_1.expandOnlyQuery,
+        response: exports.entitlementFeatureSchema,
+        sdk: 'entitlements.features.retrieve',
+    }),
+    (0, route_1.defineRoute)({
+        operationId: 'updateEntitlementFeature',
+        method: 'post',
+        path: '/v1/entitlements/features/{id}',
+        tag: 'Entitlements',
+        summary: 'Update a feature',
+        description: '`active: false` archives it and withdraws it from every customer that held it.',
+        auth: 'service',
+        scope: 'payments:write',
+        idempotent: true,
+        params: featureId,
+        body: exports.updateEntitlementFeatureParams,
+        response: exports.entitlementFeatureSchema,
+        sdk: 'entitlements.features.update',
+    }),
+    (0, route_1.defineRoute)({
+        operationId: 'attachProductFeature',
+        method: 'post',
+        path: '/v1/products/{id}/features',
+        tag: 'Entitlements',
+        summary: 'Attach a feature to a product',
+        auth: 'service',
+        scope: 'payments:write',
+        idempotent: true,
+        params: { id: 'The product (`prod_…`).' },
+        body: exports.attachProductFeatureParams,
+        response: exports.productFeatureSchema,
+        sdk: 'entitlements.productFeatures.attach',
+    }),
+    (0, route_1.defineRoute)({
+        operationId: 'listProductFeatures',
+        method: 'get',
+        path: '/v1/products/{id}/features',
+        tag: 'Entitlements',
+        summary: "List a product's features",
+        auth: 'service',
+        scope: 'payments:read',
+        params: { id: 'The product (`prod_…`).' },
+        query: exports.listProductFeaturesQuery,
+        response: (0, envelopes_1.listOf)(exports.productFeatureSchema),
+        sdk: 'entitlements.productFeatures.list',
+        expandable: 'product_feature',
+    }),
+    (0, route_1.defineRoute)({
+        operationId: 'detachProductFeature',
+        method: 'delete',
+        path: '/v1/products/{id}/features/{feature}',
+        tag: 'Entitlements',
+        summary: 'Detach a feature from a product',
+        auth: 'service',
+        scope: 'payments:write',
+        params: {
+            id: 'The product (`prod_…`).',
+            feature: 'The attachment (`prodft_…`).',
+        },
+        response: exports.deletedProductFeatureSchema,
+        sdk: 'entitlements.productFeatures.detach',
+    }),
+    (0, route_1.defineRoute)({
+        operationId: 'listActiveEntitlements',
+        method: 'get',
+        path: '/v1/entitlements/active_entitlements',
+        tag: 'Entitlements',
+        summary: "List a customer's active entitlements",
+        description: 'What the customer may access NOW: one entitlement per feature, however many products grant it. A complete set, never paged (`has_more` is always `false`).',
+        auth: 'service',
+        scope: 'payments:read',
+        query: exports.listActiveEntitlementsQuery,
+        response: (0, envelopes_1.listOf)(exports.activeEntitlementSchema),
+        sdk: 'entitlements.activeEntitlements.list',
+    }),
+];

package/dist/cjs/resources/catalog/index.js

@@ -0,0 +1,58 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.catalogRoutes = exports.queryIdList = exports.queryFlag = exports.baseUnitAmountParam = void 0;
+// Contracts of this group: one module per resource, re-exported here, and
+// their routes concatenated into `catalogRoutes`.
+const billing_1 = require("./billing");
+const billingSettings_1 = require("./billingSettings");
+const coupons_1 = require("./coupons");
+const entitlements_1 = require("./entitlements");
+const meters_1 = require("./meters");
+const prices_1 = require("./prices");
+const products_1 = require("./products");
+const promotionCodes_1 = require("./promotionCodes");
+const testClocks_1 = require("./testClocks");
+__exportStar(require("./billing"), exports);
+__exportStar(require("./billingSettings"), exports);
+__exportStar(require("./coupons"), exports);
+__exportStar(require("./entitlements"), exports);
+__exportStar(require("./meters"), exports);
+__exportStar(require("./prices"), exports);
+__exportStar(require("./products"), exports);
+__exportStar(require("./promotionCodes"), exports);
+__exportStar(require("./testClocks"), exports);
+// The request pieces every body naming an amount, an inline price or a filter reuses.
+var shared_1 = require("./shared");
+Object.defineProperty(exports, "baseUnitAmountParam", { enumerable: true, get: function () { return shared_1.baseUnitAmountParam; } });
+Object.defineProperty(exports, "queryFlag", { enumerable: true, get: function () { return shared_1.queryFlag; } });
+Object.defineProperty(exports, "queryIdList", { enumerable: true, get: function () { return shared_1.queryIdList; } });
+/**
+ * The catalog (products, prices, coupons, promotion codes), entitlements, the
+ * billing engine's platform objects (test clocks, billing settings, meters)
+ * and the recurring billing transport (`/v1/billing/*`).
+ */
+exports.catalogRoutes = [
+    ...products_1.productRoutes,
+    ...prices_1.priceRoutes,
+    ...coupons_1.couponRoutes,
+    ...promotionCodes_1.promotionCodeRoutes,
+    ...entitlements_1.entitlementRoutes,
+    ...testClocks_1.testClockRoutes,
+    ...billingSettings_1.billingSettingsRoutes,
+    ...meters_1.meterRoutes,
+    ...billing_1.billingRoutes,
+];