tapimo 0.10.2 → 0.12.0

package/dist/apps/management/routes/billing.d.ts

@@ -90,7 +90,7 @@ export declare namespace schema {
                 usd: "usd";
             }>>;
         }, z.core.$strip>>;
-        updatedAt: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        updatedAt: z.ZodMiniOptional<z.ZodMiniISODateTime>;
     }, z.core.$strip>;
     /** A hosted Stripe session link. */
     const Session: z.ZodMiniObject<{
@@ -104,7 +104,7 @@ export declare namespace schema {
             expYear: z.ZodMiniNumber<number>;
             last4: z.ZodMiniString<string>;
         }, z.core.$strip>>;
-        createdAt: z.ZodMiniString<string>;
+        createdAt: z.ZodMiniISODateTime;
         default: z.ZodMiniBoolean<boolean>;
         id: z.ZodMiniString<string>;
         provider: z.ZodMiniLiteral<"stripe">;
@@ -119,7 +119,7 @@ export declare namespace schema {
                 expYear: z.ZodMiniNumber<number>;
                 last4: z.ZodMiniString<string>;
             }, z.core.$strip>>;
-            createdAt: z.ZodMiniString<string>;
+            createdAt: z.ZodMiniISODateTime;
             default: z.ZodMiniBoolean<boolean>;
             id: z.ZodMiniString<string>;
             provider: z.ZodMiniLiteral<"stripe">;
@@ -255,14 +255,14 @@ export declare function billing(): import("hono/hono-base").HonoBase<Environment
         } | {
             output: {
                 error: {
-                    code: "param_invalid";
+                    code: "organization_not_found";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 400;
+            status: 404;
             input: {
                 param: {
                     orgId: string;
@@ -275,14 +275,14 @@ export declare function billing(): import("hono/hono-base").HonoBase<Environment
         } | {
             output: {
                 error: {
-                    code: "organization_not_found";
+                    code: "param_invalid";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 404;
+            status: 400;
             input: {
                 param: {
                     orgId: string;
@@ -522,14 +522,14 @@ export declare function billing(): import("hono/hono-base").HonoBase<Environment
         } | {
             output: {
                 error: {
-                    code: "body_invalid";
+                    code: "organization_not_found";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 400;
+            status: 404;
             input: {
                 param: {
                     orgId: string;
@@ -554,7 +554,39 @@ export declare function billing(): import("hono/hono-base").HonoBase<Environment
         } | {
             output: {
                 error: {
-                    code: "param_invalid";
+                    code: "forbidden";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 403;
+            input: {
+                param: {
+                    orgId: string;
+                };
+            } & {
+                query?: {
+                    environment?: string | string[];
+                } | undefined;
+            } & {
+                json: {
+                    spendLimit?: {
+                        amount: string;
+                        currency?: "usd" | undefined;
+                        period?: "month" | undefined;
+                    } | null | undefined;
+                    txFeeLimit?: {
+                        amount: string;
+                        currency?: "usd" | undefined;
+                    } | null | undefined;
+                };
+            };
+        } | {
+            output: {
+                error: {
+                    code: "body_invalid";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
@@ -586,14 +618,14 @@ export declare function billing(): import("hono/hono-base").HonoBase<Environment
         } | {
             output: {
                 error: {
-                    code: "organization_not_found";
+                    code: "param_invalid";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 404;
+            status: 400;
             input: {
                 param: {
                     orgId: string;
@@ -785,14 +817,14 @@ export declare function billing(): import("hono/hono-base").HonoBase<Environment
         } | {
             output: {
                 error: {
-                    code: "param_invalid";
+                    code: "organization_not_found";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 400;
+            status: 404;
             input: {
                 param: {
                     orgId: string;
@@ -805,14 +837,14 @@ export declare function billing(): import("hono/hono-base").HonoBase<Environment
         } | {
             output: {
                 error: {
-                    code: "organization_not_found";
+                    code: "forbidden";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 404;
+            status: 403;
             input: {
                 param: {
                     orgId: string;
@@ -825,14 +857,14 @@ export declare function billing(): import("hono/hono-base").HonoBase<Environment
         } | {
             output: {
                 error: {
-                    code: "forbidden";
+                    code: "param_invalid";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 403;
+            status: 400;
             input: {
                 param: {
                     orgId: string;
@@ -1024,14 +1056,14 @@ export declare function billing(): import("hono/hono-base").HonoBase<Environment
         } | {
             output: {
                 error: {
-                    code: "param_invalid";
+                    code: "organization_not_found";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 400;
+            status: 404;
             input: {
                 param: {
                     orgId: string;
@@ -1044,14 +1076,34 @@ export declare function billing(): import("hono/hono-base").HonoBase<Environment
         } | {
             output: {
                 error: {
-                    code: "organization_not_found";
+                    code: "forbidden";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 404;
+            status: 403;
+            input: {
+                param: {
+                    orgId: string;
+                };
+            } & {
+                query?: {
+                    environment?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                error: {
+                    code: "param_invalid";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 400;
             input: {
                 param: {
                     orgId: string;
@@ -1243,14 +1295,14 @@ export declare function billing(): import("hono/hono-base").HonoBase<Environment
         } | {
             output: {
                 error: {
-                    code: "param_invalid";
+                    code: "organization_not_found";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 400;
+            status: 404;
             input: {
                 param: {
                     orgId: string;
@@ -1263,14 +1315,14 @@ export declare function billing(): import("hono/hono-base").HonoBase<Environment
         } | {
             output: {
                 error: {
-                    code: "organization_not_found";
+                    code: "param_invalid";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 404;
+            status: 400;
             input: {
                 param: {
                     orgId: string;
@@ -1460,14 +1512,14 @@ export declare function billing(): import("hono/hono-base").HonoBase<Environment
         } | {
             output: {
                 error: {
-                    code: "param_invalid";
+                    code: "organization_not_found";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 400;
+            status: 404;
             input: {
                 param: {
                     methodId: string;
@@ -1481,14 +1533,35 @@ export declare function billing(): import("hono/hono-base").HonoBase<Environment
         } | {
             output: {
                 error: {
-                    code: "organization_not_found";
+                    code: "forbidden";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 404;
+            status: 403;
+            input: {
+                param: {
+                    methodId: string;
+                    orgId: string;
+                };
+            } & {
+                query?: {
+                    environment?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                error: {
+                    code: "param_invalid";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 400;
             input: {
                 param: {
                     methodId: string;

package/dist/apps/management/routes/billing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"billing.d.ts","sourceRoot":"","sources":["../../../../src/apps/management/routes/billing.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAA;AAQ7B,OAAO,KAAK,QAAQ,MAAM,+BAA+B,CAAA;AAMzD,OAAO,KAAK,EAAW,WAAW,EAAE,MAAM,WAAW,CAAA;AAErD,iDAAiD;AACjD,yBAAiB,MAAM,CAAC;IAQtB,6DAA6D;IACtD,MAAM,MAAM;;qBAEoD,CAAA;IAEvE,0DAA0D;IACnD,MAAM,KAAK;;;;;sBAEsD,CAAA;IAExE,qDAAqD;IAC9C,MAAM,YAAY;;;qBAU6C,CAAA;IAEtE,gCAAgC;IACzB,MAAM,UAAU;;;;;;;;qBAuBtB,CAAA;IAED,iCAAiC;IAC1B,MAAM,UAAU;;;;;qBAiBtB,CAAA;IAED,qEAAqE;IAC9D,MAAM,KAAK;;;;;;;;;;;;;;;;qBAcjB,CAAA;IAED,uCAAuC;IAChC,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAmDnB,CAAA;IAED,oCAAoC;IAC7B,MAAM,OAAO;;qBAUnB,CAAA;IAED,gCAAgC;IACzB,MAAM,aAAa;;;;;;;;;;;;qBAkDzB,CAAA;IAED,yCAAyC;IAClC,MAAM,cAAc;;;;;;;;;;;;;;qBAK1B,CAAA;CACF;AAED;;GAEG;AACH,wBAAgB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BA+gBtB"}
+{"version":3,"file":"billing.d.ts","sourceRoot":"","sources":["../../../../src/apps/management/routes/billing.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAA;AAQ7B,OAAO,KAAK,QAAQ,MAAM,+BAA+B,CAAA;AAMzD,OAAO,KAAK,EAAW,WAAW,EAAE,MAAM,WAAW,CAAA;AAErD,iDAAiD;AACjD,yBAAiB,MAAM,CAAC;IAQtB,6DAA6D;IACtD,MAAM,MAAM;;qBAEoD,CAAA;IAEvE,0DAA0D;IACnD,MAAM,KAAK;;;;;sBAEsD,CAAA;IAExE,qDAAqD;IAC9C,MAAM,YAAY;;;qBAU6C,CAAA;IAEtE,gCAAgC;IACzB,MAAM,UAAU;;;;;;;;qBA0BtB,CAAA;IAED,iCAAiC;IAC1B,MAAM,UAAU;;;;;qBAoBtB,CAAA;IAED,qEAAqE;IAC9D,MAAM,KAAK;;;;;;;;;;;;;;;;qBAiBjB,CAAA;IAED,uCAAuC;IAChC,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAsDnB,CAAA;IAED,oCAAoC;IAC7B,MAAM,OAAO;;qBAanB,CAAA;IAED,gCAAgC;IACzB,MAAM,aAAa;;;;;;;;;;;;qBAqDzB,CAAA;IAED,yCAAyC;IAClC,MAAM,cAAc;;;;;;;;;;;;;;qBAU1B,CAAA;CACF;AAED;;GAEG;AACH,wBAAgB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAqkBtB"}

package/dist/apps/management/routes/billing.js

@@ -37,7 +37,7 @@ export var schema;
     })
         .check(z.describe('Path parameters addressing one payment method.'));
     /** A per-period spend limit. */
-    schema.SpendLimit = Schema.describe(z.object({
+    schema.SpendLimit = OpenApi.component(Schema.describe(z.object({
         amount: z.string().check(
         // The lookahead rejects zero: a zero limit would refuse all
         // sponsorship, which `null` (clear) already expresses.
@@ -48,9 +48,9 @@ export var schema;
         period: z
             ._default(z.enum(BillingSettings.periods), 'month')
             .check(z.describe('Window the limit applies over; `month` (UTC calendar) only today.'), z.meta({ examples: ['month'] })),
-    }), 'A per-period spend limit.');
+    }), 'A per-period spend limit.'), 'BillingSpendLimit');
     /** A per-transaction fee cap. */
-    schema.TxFeeLimit = Schema.describe(z.object({
+    schema.TxFeeLimit = OpenApi.component(Schema.describe(z.object({
         amount: z.string().check(
         // The lookahead rejects zero: a zero cap would refuse every
         // transaction, which is not a supported configuration.
@@ -58,17 +58,17 @@ export var schema;
         currency: z
             ._default(z.enum(BillingSettings.currencies), 'usd')
             .check(z.describe('Currency the cap is denominated in; `usd` only today.'), z.meta({ examples: ['usd'] })),
-    }), 'A per-transaction fee cap.');
+    }), 'A per-transaction fee cap.'), 'BillingTransactionFeeLimit');
     /** PATCH body; absent fields stay unchanged, null clears a limit. */
-    schema.Patch = Schema.describe(z.object({
+    schema.Patch = OpenApi.component(Schema.describe(z.object({
         spendLimit: z
             .optional(z.nullable(schema.SpendLimit))
             .check(z.describe('Spend limit per period; absent leaves it unchanged, null removes it.'), z.meta({ examples: [{ amount: '250', currency: 'usd', period: 'month' }] })),
         txFeeLimit: z.optional(z.nullable(schema.TxFeeLimit)).check(z.describe('Per-transaction fee cap; absent leaves it unchanged, null restores the platform default.'), // prettier-ignore
         z.meta({ examples: [{ amount: '0.50', currency: 'usd' }] })),
-    }), 'Billing settings to apply.');
+    }), 'Billing settings to apply.'), 'UpdateBillingRequest');
     /** An organization's billing state. */
-    schema.Billing = Schema.describe(z.object({
+    schema.Billing = OpenApi.component(Schema.describe(z.object({
         enabledSources: z
             .array(z.enum(EnabledBillingSources.sources))
             .check(z.describe('Billing sources this organization may set up.'), z.meta({ examples: [['stripe']] })),
@@ -92,17 +92,17 @@ export var schema;
         txFeeLimit: z
             .optional(schema.TxFeeLimit)
             .check(z.describe('Configured per-transaction fee cap; absent when the platform default applies.'), z.meta({ examples: [{ amount: '0.50', currency: 'usd' }] })),
-        updatedAt: z.optional(z.string()).check(z.describe('When the billing status last changed (ISO 8601); absent before first checkout.'), // prettier-ignore
+        updatedAt: z.optional(z.iso.datetime()).check(z.describe('When the billing status last changed (ISO 8601); absent before first checkout.'), // prettier-ignore
         z.meta({ examples: ['2026-01-01T00:00:00.000Z'] })),
-    }), "An organization's billing state.");
+    }), "An organization's billing state."), 'Billing');
     /** A hosted Stripe session link. */
-    schema.Session = Schema.describe(z.object({
+    schema.Session = OpenApi.component(Schema.describe(z.object({
         url: z
             .url()
             .check(z.describe('Hosted Stripe session URL; navigate the browser here.'), z.meta({ examples: ['https://checkout.stripe.com/c/pay/cs_test_a1b2c3'] })),
-    }), 'A hosted Stripe session link.');
+    }), 'A hosted Stripe session link.'), 'BillingSession');
     /** A payment method on file. */
-    schema.PaymentMethod = Schema.describe(z.object({
+    schema.PaymentMethod = OpenApi.component(Schema.describe(z.object({
         card: z
             .optional(z.object({
             brand: z
@@ -117,8 +117,8 @@ export var schema;
                 .check(z.describe('Last four digits.'), z.meta({ examples: ['4242'] })),
         }))
             .check(z.describe('Card details; present when `type` is `card`.'), z.meta({ examples: [{ brand: 'visa', expMonth: 12, expYear: 2030, last4: '4242' }] })),
-        createdAt: z
-            .string()
+        createdAt: z.iso
+            .datetime()
             .check(z.describe('When the method was attached (ISO 8601).'), z.meta({ examples: ['2026-01-01T00:00:00.000Z'] })),
         default: z
             .boolean()
@@ -132,11 +132,13 @@ export var schema;
         type: z
             .string()
             .check(z.describe('Method type (e.g. `card`, `us_bank_account`).'), z.meta({ examples: ['card'] })),
-    }), 'A payment method on file.');
+    }), 'A payment method on file.'), 'BillingPaymentMethod');
     /** An organization's payment methods. */
-    schema.PaymentMethods = Schema.describe(z.object({
-        data: z.array(schema.PaymentMethod).check(z.describe('Payment methods on file, newest first.')),
-    }), "An organization's payment methods.");
+    schema.PaymentMethods = OpenApi.component(Schema.describe(z.object({
+        data: z
+            .array(schema.PaymentMethod)
+            .check(z.describe('Payment methods on file, newest first.'), z.meta({ examples: [[]] })),
+    }), "An organization's payment methods."), 'BillingPaymentMethodList');
 })(schema || (schema = {}));
 /**
  * Mounts billing routes. Reads require membership or scoped API key access; organizations without provider state return `none`.
@@ -153,7 +155,14 @@ export function billing() {
         operationId: 'getBilling',
         responses: OpenApi.responses({
             errors: {
-                404: 'No accessible organization was found for this id.',
+                400: {
+                    codes: ['param_invalid', 'query_invalid'],
+                    description: 'Malformed API key, invalid path, or invalid query.',
+                },
+                404: {
+                    codes: ['organization_not_found'],
+                    description: 'No accessible organization was found for this id.',
+                },
             },
             success: { description: "The organization's billing state.", schema: schema.Billing },
         }),
@@ -195,8 +204,14 @@ export function billing() {
         operationId: 'updateBilling',
         responses: OpenApi.responses({
             errors: {
-                403: 'Requires the owner role.',
-                404: 'No accessible organization was found for this id.',
+                400: {
+                    codes: ['body_invalid', 'param_invalid', 'query_invalid'],
+                    description: 'Malformed API key, invalid path, invalid query, or invalid body.',
+                },
+                404: {
+                    codes: ['organization_not_found'],
+                    description: 'No accessible organization was found for this id.',
+                },
             },
             success: {
                 description: "The organization's updated billing state.",
@@ -210,6 +225,8 @@ export function billing() {
             return Auth.accessError(c);
         if (Auth.narrowScope)
             return Auth.ensureOrgError(c);
+        if (Auth.narrowOrgRole)
+            return Auth.ensureOrgRoleError(c);
         if (OpenApi.narrowValidation)
             return OpenApi.validationError(c, {
                 code: 'param_invalid',
@@ -264,12 +281,22 @@ export function billing() {
         operationId: 'createStripeCheckout',
         responses: OpenApi.responses({
             errors: {
+                400: {
+                    codes: ['param_invalid', 'query_invalid'],
+                    description: 'Malformed API key, invalid path, or invalid query.',
+                },
                 403: {
-                    codes: ['api_key_forbidden', 'billing_source_disabled', 'forbidden'],
+                    codes: ['billing_source_disabled'],
                     description: 'Requires the owner role and Stripe billing enabled.',
                 },
-                404: 'No accessible organization was found for this id.',
-                501: 'Billing is not configured on this deployment.',
+                404: {
+                    codes: ['organization_not_found'],
+                    description: 'No accessible organization was found for this id.',
+                },
+                501: {
+                    codes: ['billing_unconfigured'],
+                    description: 'Billing is not configured on this deployment.',
+                },
             },
             success: {
                 description: 'A Stripe Checkout (setup mode) session for attaching a payment method.',
@@ -352,9 +379,18 @@ export function billing() {
         operationId: 'createStripeManage',
         responses: OpenApi.responses({
             errors: {
-                403: 'Requires the owner role.',
-                404: 'No accessible organization, or no billing to manage yet.',
-                501: 'Billing is not configured on this deployment.',
+                400: {
+                    codes: ['param_invalid', 'query_invalid'],
+                    description: 'Malformed API key, invalid path, or invalid query.',
+                },
+                404: {
+                    codes: ['billing_not_found', 'organization_not_found'],
+                    description: 'No accessible organization or billing account was found.',
+                },
+                501: {
+                    codes: ['billing_unconfigured'],
+                    description: 'Billing is not configured on this deployment.',
+                },
             },
             success: {
                 description: 'A Stripe billing-portal session for managing payment methods and invoices.', // prettier-ignore
@@ -368,6 +404,8 @@ export function billing() {
             return Auth.accessError(c);
         if (Auth.narrowScope)
             return Auth.ensureOrgError(c);
+        if (Auth.narrowOrgRole)
+            return Auth.ensureOrgRoleError(c);
         if (OpenApi.narrowValidation)
             return OpenApi.validationError(c, {
                 code: 'param_invalid',
@@ -411,8 +449,18 @@ export function billing() {
         operationId: 'getBillingPaymentMethods',
         responses: OpenApi.responses({
             errors: {
-                404: 'No accessible organization was found for this id.',
-                501: 'Billing is not configured on this deployment.',
+                400: {
+                    codes: ['param_invalid', 'query_invalid'],
+                    description: 'Malformed API key, invalid path, or invalid query.',
+                },
+                404: {
+                    codes: ['organization_not_found'],
+                    description: 'No accessible organization was found for this id.',
+                },
+                501: {
+                    codes: ['billing_unconfigured'],
+                    description: 'Billing is not configured on this deployment.',
+                },
             },
             success: {
                 description: "The organization's payment methods.",
@@ -490,9 +538,18 @@ export function billing() {
         operationId: 'deleteBillingPaymentMethod',
         responses: OpenApi.responses({
             errors: {
-                403: 'Requires the owner role.',
-                404: 'No accessible organization, billing, or payment method for this id.',
-                501: 'Billing is not configured on this deployment.',
+                400: {
+                    codes: ['param_invalid', 'query_invalid'],
+                    description: 'Malformed API key, invalid path, or invalid query.',
+                },
+                404: {
+                    codes: ['billing_not_found', 'organization_not_found', 'payment_method_not_found'],
+                    description: 'No accessible organization, billing account, or payment method was found.', // prettier-ignore
+                },
+                501: {
+                    codes: ['billing_unconfigured'],
+                    description: 'Billing is not configured on this deployment.',
+                },
             },
             success: {
                 description: "The organization's updated billing state.",
@@ -506,6 +563,8 @@ export function billing() {
             return Auth.accessError(c);
         if (Auth.narrowScope)
             return Auth.ensureOrgError(c);
+        if (Auth.narrowOrgRole)
+            return Auth.ensureOrgRoleError(c);
         if (OpenApi.narrowValidation)
             return OpenApi.validationError(c, {
                 code: 'param_invalid',