@peable.to/contracts 0.3.0 → 1.0.0

package/dist/cjs/resources/tax/deadlines.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.taxDeadlineRoutes = exports.taxDeadlineListSchema = exports.taxDeadlineUnavailableSchema = exports.taxDeadlineSchema = void 0;
+const zod_1 = require("zod");
+const envelopes_1 = require("../../common/envelopes");
+const objects_1 = require("../../common/objects");
+const primitives_1 = require("../../common/primitives");
+const route_1 = require("../../route");
+const tax_1 = require("../../vocabulary/tax");
+const shared_1 = require("./shared");
+/**
+ * A due date the rule set can compute. `filing_status` is `not_tracked`:
+ * Peable files nothing, so it never claims a return was or was not filed.
+ */
+exports.taxDeadlineSchema = (0, objects_1.defineObject)('tax.deadline', 'TaxDeadline', zod_1.z
+    .object({
+    object: zod_1.z.literal('tax.deadline'),
+    kind: zod_1.z.enum(tax_1.TAX_DEADLINE_KINDS),
+    rule: zod_1.z.string().describe('The rule that sets it.'),
+    country: primitives_1.nullableString,
+    state: shared_1.taxState,
+    period_start: primitives_1.unixSeconds.nullable(),
+    period_end: primitives_1.unixSeconds.nullable(),
+    due: primitives_1.unixSeconds,
+    status: zod_1.z.enum(tax_1.TAX_DEADLINE_STATUSES),
+    filing_status: zod_1.z.literal('not_tracked'),
+    description: zod_1.z.string(),
+    source: shared_1.taxRuleSourceSchema,
+})
+    .strict());
+/** Where a deadline exists but the rule set cannot compute it, and why. */
+exports.taxDeadlineUnavailableSchema = (0, objects_1.defineComponent)('TaxDeadlineUnavailable', zod_1.z
+    .object({
+    rule: primitives_1.nullableString,
+    country: primitives_1.nullableString,
+    state: shared_1.taxState,
+    reason: zod_1.z.string(),
+})
+    .strict());
+/** A complete list (`has_more` is `false`), with what could not be computed beside it. */
+exports.taxDeadlineListSchema = (0, objects_1.defineComponent)('TaxDeadlineList', (0, envelopes_1.listOf)(exports.taxDeadlineSchema).extend({
+    unavailable: zod_1.z
+        .array(exports.taxDeadlineUnavailableSchema)
+        .describe('Where a deadline exists but the rule set cannot compute it, and why.'),
+}));
+exports.taxDeadlineRoutes = [
+    (0, route_1.defineRoute)({
+        operationId: 'listTaxDeadlines',
+        method: 'get',
+        path: '/v1/tax/deadlines',
+        tag: 'Tax compliance',
+        summary: 'List tax deadlines',
+        description: 'Due dates the rule set computes from declared registrations and the latest assessment, soonest first.',
+        auth: 'service',
+        scope: 'payments:read',
+        response: exports.taxDeadlineListSchema,
+        sdk: 'tax.compliance.listDeadlines',
+    }),
+];

package/dist/cjs/resources/tax/documents.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.taxDocumentRoutes = exports.listTaxDocumentsQuery = exports.createTaxDocumentParams = exports.taxDocumentChecklistSchema = exports.taxDocumentChecklistItemSchema = exports.taxDocumentSchema = 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 tax_1 = require("../../vocabulary/tax");
+const shared_1 = require("./shared");
+/**
+ * A supporting document (`taxdoc_…`): a `file_…` of purpose `tax_document`
+ * (private, never addressable by URL) with what it is for. Attaching a
+ * document proves nothing by itself; it is what a reviewer reads.
+ */
+exports.taxDocumentSchema = (0, objects_1.defineObject)('tax.document', 'TaxDocument', zod_1.z
+    .object({
+    object: zod_1.z.literal('tax.document'),
+    id: zod_1.z.string().describe('`taxdoc_…`.'),
+    livemode: primitives_1.livemode,
+    file: zod_1.z.string().describe('The file (`file_…`, purpose `tax_document`).'),
+    // The file's `status` vocabulary (`available` / `withheld` / `removed`).
+    file_status: zod_1.z
+        .enum(['available', 'withheld', 'removed'])
+        .describe("The file's standing now: a `removed` file is a document that is gone."),
+    filename: primitives_1.nullableString,
+    kind: zod_1.z.enum(tax_1.TAX_DOCUMENT_KINDS),
+    country: primitives_1.nullableString.describe('ISO 3166-1 alpha-2.'),
+    state: shared_1.taxState,
+    registration_declaration: primitives_1.nullableString.describe('The declaration (`taxrd_…`) it supports, when it names one.'),
+    description: primitives_1.nullableString,
+    metadata: primitives_1.metadata,
+    created: primitives_1.unixSeconds,
+})
+    .strict(), {
+    examples: [
+        {
+            object: 'tax.document',
+            id: 'taxdoc_0193b8f2c1a87d3e9f4a',
+            livemode: false,
+            file: 'file_0193b8f2c1a87d3e9f4a',
+            file_status: 'available',
+            filename: 'oss-registration.pdf',
+            kind: 'registration_certificate',
+            country: 'ES',
+            state: null,
+            registration_declaration: 'taxrd_0193b8f2c1a87d3e9f4a',
+            description: null,
+            metadata: {},
+            created: 1793750400,
+        },
+    ],
+});
+exports.taxDocumentChecklistItemSchema = (0, objects_1.defineComponent)('TaxDocumentChecklistItem', zod_1.z
+    .object({
+    key: zod_1.z.string(),
+    kind: zod_1.z.enum(tax_1.TAX_DOCUMENT_KINDS),
+    country: primitives_1.nullableString,
+    state: shared_1.taxState,
+    status: zod_1.z
+        .enum(tax_1.TAX_DOCUMENT_CHECKLIST_STATUSES)
+        .describe('`provided`: an available document is attached; `unavailable`: only removed ones are.'),
+    documents: zod_1.z.array(zod_1.z.string()).describe('The attached documents (`taxdoc_…`).'),
+    reason: zod_1.z.string(),
+})
+    .strict());
+/** The documents the recorded facts call for, and which are attached. */
+exports.taxDocumentChecklistSchema = (0, objects_1.defineObject)('tax.document_checklist', 'TaxDocumentChecklist', zod_1.z
+    .object({
+    object: zod_1.z.literal('tax.document_checklist'),
+    livemode: primitives_1.livemode,
+    items: zod_1.z.array(exports.taxDocumentChecklistItemSchema),
+})
+    .strict());
+/** Orbit's attachment of a document (the owner's). Attaching the same file again answers the same document. */
+exports.createTaxDocumentParams = zod_1.z
+    .object({
+    file: shared_1.complianceIdParam.describe('A `file_…` of purpose `tax_document`.'),
+    kind: zod_1.z.enum(tax_1.TAX_DOCUMENT_KINDS),
+    country: shared_1.complianceCountryParam.nullable().optional(),
+    state: shared_1.complianceStateParam.optional(),
+    registration_declaration: shared_1.complianceIdParam.nullable().optional(),
+    description: (0, shared_1.complianceTextParam)(500).optional(),
+    metadata: params_1.metadataCreateParam.optional(),
+})
+    .strict();
+exports.listTaxDocumentsQuery = (0, params_1.listQuery)({});
+exports.taxDocumentRoutes = [
+    (0, route_1.defineRoute)({
+        operationId: 'listTaxDocuments',
+        method: 'get',
+        path: '/v1/tax/documents',
+        tag: 'Tax compliance',
+        summary: 'List tax documents',
+        auth: 'service',
+        scope: 'payments:read',
+        query: exports.listTaxDocumentsQuery,
+        response: (0, envelopes_1.listOf)(exports.taxDocumentSchema),
+        sdk: 'tax.compliance.listDocuments',
+        expandable: 'tax.document',
+    }),
+    (0, route_1.defineRoute)({
+        operationId: 'retrieveTaxDocument',
+        method: 'get',
+        path: '/v1/tax/documents/{id}',
+        tag: 'Tax compliance',
+        summary: 'Retrieve a tax document',
+        auth: 'service',
+        scope: 'payments:read',
+        params: { id: 'The document (`taxdoc_…`).' },
+        query: params_1.expandOnlyQuery,
+        response: exports.taxDocumentSchema,
+        sdk: 'tax.compliance.retrieveDocument',
+        expandable: 'tax.document',
+    }),
+    (0, route_1.defineRoute)({
+        operationId: 'retrieveTaxDocumentChecklist',
+        method: 'get',
+        path: '/v1/tax/document_checklist',
+        tag: 'Tax compliance',
+        summary: 'Retrieve the document checklist',
+        auth: 'service',
+        scope: 'payments:read',
+        response: exports.taxDocumentChecklistSchema,
+        sdk: 'tax.compliance.retrieveDocumentChecklist',
+    }),
+];

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

@@ -0,0 +1,80 @@
+"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.taxRoutes = void 0;
+// Peable Tax (ADR 0011) and its business compliance (ADR 0020): one module per
+// resource, re-exported here, and their routes concatenated into `taxRoutes`.
+const assessments_1 = require("./assessments");
+const businessProfile_1 = require("./businessProfile");
+const calculations_1 = require("./calculations");
+const capabilities_1 = require("./capabilities");
+const codes_1 = require("./codes");
+const complianceActions_1 = require("./complianceActions");
+const deadlines_1 = require("./deadlines");
+const documents_1 = require("./documents");
+const locationEvidence_1 = require("./locationEvidence");
+const operatingLocations_1 = require("./operatingLocations");
+const products_1 = require("./products");
+const registrationDeclarations_1 = require("./registrationDeclarations");
+const registrations_1 = require("./registrations");
+const reports_1 = require("./reports");
+const reviewItems_1 = require("./reviewItems");
+const ruleSet_1 = require("./ruleSet");
+const salesDestinations_1 = require("./salesDestinations");
+const settings_1 = require("./settings");
+const transactions_1 = require("./transactions");
+__exportStar(require("./assessments"), exports);
+__exportStar(require("./businessProfile"), exports);
+__exportStar(require("./calculations"), exports);
+__exportStar(require("./capabilities"), exports);
+__exportStar(require("./codes"), exports);
+__exportStar(require("./complianceActions"), exports);
+__exportStar(require("./deadlines"), exports);
+__exportStar(require("./documents"), exports);
+__exportStar(require("./locationEvidence"), exports);
+__exportStar(require("./operatingLocations"), exports);
+__exportStar(require("./products"), exports);
+__exportStar(require("./registrationDeclarations"), exports);
+__exportStar(require("./registrations"), exports);
+__exportStar(require("./reports"), exports);
+__exportStar(require("./reviewItems"), exports);
+__exportStar(require("./ruleSet"), exports);
+__exportStar(require("./salesDestinations"), exports);
+__exportStar(require("./settings"), exports);
+__exportStar(require("./shared"), exports);
+__exportStar(require("./transactions"), exports);
+/** Peable Tax: collection (settings, evidence, calculations, transactions, reports) and business compliance. */
+exports.taxRoutes = [
+    ...codes_1.taxCodeRoutes,
+    ...settings_1.taxSettingsRoutes,
+    ...registrations_1.taxRegistrationRoutes,
+    ...products_1.taxProductRoutes,
+    ...locationEvidence_1.taxLocationEvidenceRoutes,
+    ...calculations_1.taxCalculationRoutes,
+    ...transactions_1.taxTransactionRoutes,
+    ...reports_1.taxReportRoutes,
+    ...businessProfile_1.taxBusinessProfileRoutes,
+    ...operatingLocations_1.taxOperatingLocationRoutes,
+    ...salesDestinations_1.taxSalesDestinationRoutes,
+    ...registrationDeclarations_1.taxRegistrationDeclarationRoutes,
+    ...documents_1.taxDocumentRoutes,
+    ...ruleSet_1.taxRuleSetRoutes,
+    ...capabilities_1.taxCapabilityRoutes,
+    ...deadlines_1.taxDeadlineRoutes,
+    ...assessments_1.taxAssessmentRoutes,
+    ...reviewItems_1.taxReviewItemRoutes,
+    ...complianceActions_1.taxComplianceActionRoutes,
+];

package/dist/cjs/resources/tax/locationEvidence.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.taxLocationEvidenceRoutes = exports.createTaxLocationEvidenceParams = exports.taxLocationEvidenceItemsParam = exports.taxLocationEvidenceItemParams = exports.taxLocationEvidenceSchema = exports.taxLocationEvidenceResultItemSchema = void 0;
+const zod_1 = require("zod");
+const objects_1 = require("../../common/objects");
+const primitives_1 = require("../../common/primitives");
+const route_1 = require("../../route");
+const tax_1 = require("../../vocabulary/tax");
+const settings_1 = require("./settings");
+const shared_1 = require("./shared");
+/**
+ * Customer location evidence (`taxloc_…`, ADR 0011): what places a customer
+ * in a jurisdiction, judged against that jurisdiction's own rule. There is
+ * deliberately no language, currency, locale or timezone evidence. An IP
+ * address is never stored; at most its salted hash.
+ */
+/** An item as judged: the place it points at, never more of the customer than the rule needs. */
+exports.taxLocationEvidenceResultItemSchema = (0, objects_1.defineComponent)('TaxLocationEvidenceResultItem', zod_1.z
+    .object({
+    type: zod_1.z.enum(tax_1.TAX_LOCATION_EVIDENCE_TYPES),
+    country: shared_1.taxCountry,
+    state: shared_1.taxState,
+})
+    .strict());
+exports.taxLocationEvidenceSchema = (0, objects_1.defineObject)('tax.location_evidence', 'TaxLocationEvidence', zod_1.z
+    .object({
+    object: zod_1.z.literal('tax.location_evidence'),
+    id: zod_1.z.string().describe('`taxloc_…`.'),
+    customer_ref: zod_1.z.string().describe('The customer this evidence is about.'),
+    status: zod_1.z
+        .enum(tax_1.TAX_EVIDENCE_STATUSES)
+        .describe('Only `sufficient` evidence can be calculated against.'),
+    rule: zod_1.z
+        .string()
+        .describe('The jurisdiction rule applied: `eu_digital_two_items`, `gb_digital_two_items`, `us_billing_address`, `ca_billing_address`, `default_one_item`, or `none` when no item names a country.'),
+    country: shared_1.taxCountry
+        .nullable()
+        .describe('Where the evidence places the customer, when it does.'),
+    state: shared_1.taxState,
+    items: zod_1.z.array(exports.taxLocationEvidenceResultItemSchema),
+    observed_at: primitives_1.unixSeconds,
+    expires_at: primitives_1.unixSeconds.describe('Evidence stays usable for a day.'),
+    livemode: primitives_1.livemode,
+})
+    .strict(), {
+    examples: [
+        {
+            object: 'tax.location_evidence',
+            id: 'taxloc_0193b8f2c1a87d3e9f4a',
+            customer_ref: 'cus_0193b8f2c1a87d3e9f4a',
+            status: 'sufficient',
+            rule: 'eu_digital_two_items',
+            country: 'DE',
+            state: null,
+            items: [
+                { type: 'billing_address', country: 'DE', state: null },
+                { type: 'ip_address', country: 'DE', state: null },
+            ],
+            observed_at: 1793750400,
+            expires_at: 1793836800,
+            livemode: false,
+        },
+    ],
+});
+const evidenceCountry = zod_1.z.string().regex(/^[A-Z]{2}$/);
+const evidenceState = zod_1.z
+    .string()
+    .regex(/^[A-Z0-9]{1,3}$/)
+    .nullish();
+const ipv4 = zod_1.z.ipv4();
+const ipv6 = zod_1.z.ipv6();
+/**
+ * One piece of evidence. Strict: an item claiming a language, currency, locale
+ * or timezone is not a smaller kind of evidence, it is refused.
+ */
+exports.taxLocationEvidenceItemParams = zod_1.z.discriminatedUnion('type', [
+    zod_1.z.object({ type: zod_1.z.literal('billing_address'), address: settings_1.taxAddressParams }).strict(),
+    zod_1.z
+        .object({
+        type: zod_1.z.literal('ip_address'),
+        ip_address: zod_1.z
+            .string()
+            .refine((value) => ipv4.safeParse(value).success || ipv6.safeParse(value).success, 'Not an IP address'),
+        country: evidenceCountry,
+        state: evidenceState,
+    })
+        .strict(),
+    zod_1.z
+        .object({
+        type: zod_1.z.enum(['payment_method_country', 'bank_country', 'sim_country', 'landline_country']),
+        country: evidenceCountry,
+    })
+        .strict(),
+]);
+/** At least one item and at most six. */
+exports.taxLocationEvidenceItemsParam = zod_1.z.array(exports.taxLocationEvidenceItemParams).min(1).max(6);
+exports.createTaxLocationEvidenceParams = zod_1.z
+    .object({
+    customer_ref: shared_1.taxReferenceParam.describe('The customer this evidence is about; for billing, the `storeId`.'),
+    evidence: exports.taxLocationEvidenceItemsParam,
+})
+    .strict();
+exports.taxLocationEvidenceRoutes = [
+    (0, route_1.defineRoute)({
+        operationId: 'createTaxLocationEvidence',
+        method: 'post',
+        path: '/v1/tax/location_evidence',
+        tag: 'Tax',
+        summary: 'Record customer location evidence',
+        description: "Judged at once against the customer's jurisdiction rule; the answer says whether it is `sufficient` to calculate against.",
+        auth: 'service',
+        scope: 'payments:write',
+        idempotent: true,
+        body: exports.createTaxLocationEvidenceParams,
+        response: exports.taxLocationEvidenceSchema,
+        status: 201,
+        sdk: 'tax.locationEvidence.create',
+    }),
+    (0, route_1.defineRoute)({
+        operationId: 'retrieveTaxLocationEvidence',
+        method: 'get',
+        path: '/v1/tax/location_evidence/{id}',
+        tag: 'Tax',
+        summary: 'Retrieve customer location evidence',
+        auth: 'service',
+        scope: 'payments:read',
+        params: { id: 'The evidence (`taxloc_…`).' },
+        response: exports.taxLocationEvidenceSchema,
+        sdk: 'tax.locationEvidence.retrieve',
+    }),
+];

package/dist/cjs/resources/tax/operatingLocations.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.taxOperatingLocationRoutes = exports.listTaxOperatingLocationsQuery = exports.updateTaxOperatingLocationParams = exports.createTaxOperatingLocationParams = exports.taxOperatingLocationSchema = 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 tax_1 = require("../../vocabulary/tax");
+const shared_1 = require("./shared");
+/**
+ * Where the business ACTUALLY operates (`taxol_…`). `head_office` and
+ * `fixed_establishment` are the owner's statement of establishment (the EU
+ * rule reads them); any location in a US state is physical presence there.
+ */
+exports.taxOperatingLocationSchema = (0, objects_1.defineObject)('tax.operating_location', 'TaxOperatingLocation', zod_1.z
+    .object({
+    object: zod_1.z.literal('tax.operating_location'),
+    id: zod_1.z.string().describe('`taxol_…`.'),
+    livemode: primitives_1.livemode,
+    kind: zod_1.z.enum(tax_1.TAX_OPERATING_LOCATION_KINDS),
+    country: shared_1.taxCountry,
+    state: shared_1.taxState,
+    description: primitives_1.nullableString,
+    started: primitives_1.unixSeconds.nullable(),
+    ended: primitives_1.unixSeconds.nullable().describe('Set once the business no longer operates there.'),
+    metadata: primitives_1.metadata,
+    created: primitives_1.unixSeconds,
+})
+    .strict(), {
+    examples: [
+        {
+            object: 'tax.operating_location',
+            id: 'taxol_0193b8f2c1a87d3e9f4a',
+            livemode: false,
+            kind: 'head_office',
+            country: 'ES',
+            state: null,
+            description: 'Registered office, Barcelona',
+            started: 1735689600,
+            ended: null,
+            metadata: {},
+            created: 1793750400,
+        },
+    ],
+});
+/** Orbit's new operating location (the owner's). */
+exports.createTaxOperatingLocationParams = zod_1.z
+    .object({
+    kind: zod_1.z.enum(tax_1.TAX_OPERATING_LOCATION_KINDS),
+    country: shared_1.complianceCountryParam,
+    state: shared_1.complianceStateParam.optional(),
+    description: (0, shared_1.complianceTextParam)(500).optional(),
+    started: shared_1.taxInstantParam.nullable().optional(),
+    ended: shared_1.taxInstantParam.nullable().optional(),
+    metadata: params_1.metadataCreateParam.optional(),
+})
+    .strict();
+/** Orbit's update (the owner's): `kind` and the place are fixed; `metadata` is a patch. */
+exports.updateTaxOperatingLocationParams = zod_1.z
+    .object({
+    description: (0, shared_1.complianceTextParam)(500).optional(),
+    started: shared_1.taxInstantParam.nullable().optional(),
+    ended: shared_1.taxInstantParam.nullable().optional(),
+    metadata: params_1.metadataUpdateParam.optional(),
+})
+    .strict();
+exports.listTaxOperatingLocationsQuery = (0, params_1.listQuery)({});
+exports.taxOperatingLocationRoutes = [
+    (0, route_1.defineRoute)({
+        operationId: 'listTaxOperatingLocations',
+        method: 'get',
+        path: '/v1/tax/operating_locations',
+        tag: 'Tax compliance',
+        summary: 'List operating locations',
+        auth: 'service',
+        scope: 'payments:read',
+        query: exports.listTaxOperatingLocationsQuery,
+        response: (0, envelopes_1.listOf)(exports.taxOperatingLocationSchema),
+        sdk: 'tax.compliance.listOperatingLocations',
+        expandable: 'tax.operating_location',
+    }),
+    (0, route_1.defineRoute)({
+        operationId: 'retrieveTaxOperatingLocation',
+        method: 'get',
+        path: '/v1/tax/operating_locations/{id}',
+        tag: 'Tax compliance',
+        summary: 'Retrieve an operating location',
+        auth: 'service',
+        scope: 'payments:read',
+        params: { id: 'The operating location (`taxol_…`).' },
+        query: params_1.expandOnlyQuery,
+        response: exports.taxOperatingLocationSchema,
+        sdk: 'tax.compliance.retrieveOperatingLocation',
+        expandable: 'tax.operating_location',
+    }),
+];

package/dist/cjs/resources/tax/products.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.taxProductRoutes = exports.setTaxProductCodeParams = exports.taxProductRefParam = exports.taxProductCodeSchema = void 0;
+const zod_1 = require("zod");
+const envelopes_1 = require("../../common/envelopes");
+const objects_1 = require("../../common/objects");
+const primitives_1 = require("../../common/primitives");
+const route_1 = require("../../route");
+const shared_1 = require("./shared");
+/**
+ * A product's tax code: what a calculation line naming `product_ref` is taxed
+ * as when the line does not say. Classifying a product is the seller's call.
+ */
+exports.taxProductCodeSchema = (0, objects_1.defineObject)('tax.product', 'TaxProductCode', zod_1.z
+    .object({
+    object: zod_1.z.literal('tax.product'),
+    product_ref: zod_1.z
+        .string()
+        .describe("The merchant's product or plan reference (a billing `planId`)."),
+    tax_code: zod_1.z.string().describe('`txcd_…`.'),
+    updated_at: primitives_1.unixSeconds,
+})
+    .strict(), {
+    examples: [
+        {
+            object: 'tax.product',
+            product_ref: 'plan_pro_monthly',
+            tax_code: 'txcd_10103001',
+            updated_at: 1793750400,
+        },
+    ],
+});
+/** `{productRef}` of `PUT /v1/tax/products/{productRef}`. */
+exports.taxProductRefParam = shared_1.taxReferenceParam;
+exports.setTaxProductCodeParams = zod_1.z
+    .object({ tax_code: zod_1.z.string().describe('A `txcd_…` from `GET /v1/tax/codes`.') })
+    .strict();
+exports.taxProductRoutes = [
+    (0, route_1.defineRoute)({
+        operationId: 'listTaxProducts',
+        method: 'get',
+        path: '/v1/tax/products',
+        tag: 'Tax',
+        summary: 'List product tax codes',
+        description: 'Every classified product, by `product_ref`: a complete list, `has_more` is `false`.',
+        auth: 'service',
+        scope: 'payments:read',
+        response: (0, envelopes_1.listOf)(exports.taxProductCodeSchema),
+        sdk: 'tax.products.list',
+    }),
+    (0, route_1.defineRoute)({
+        operationId: 'setTaxProductCode',
+        method: 'put',
+        path: '/v1/tax/products/{productRef}',
+        tag: 'Tax',
+        summary: "Set a product's tax code",
+        description: 'Creates the classification or replaces it.',
+        auth: 'service',
+        scope: 'payments:write',
+        params: {
+            productRef: "The merchant's product or plan reference: 1–128 of `A-Z a-z 0-9 _ . : -`.",
+        },
+        body: exports.setTaxProductCodeParams,
+        response: exports.taxProductCodeSchema,
+        sdk: 'tax.products.setTaxCode',
+    }),
+];