@whop/cli 0.19.0 → 0.20.0

package/dist/index.js

@@ -1621,20 +1621,20 @@ var require_parse_async = __commonJS({
       const index2 = 0;
       const blocksize = opts.blocksize || 40960;
       const parser = new TOMLParser();
-      return new Promise((resolve9, reject) => {
-        setImmediate(parseAsyncNext, index2, blocksize, resolve9, reject);
+      return new Promise((resolve10, reject) => {
+        setImmediate(parseAsyncNext, index2, blocksize, resolve10, reject);
       });
-      function parseAsyncNext(index3, blocksize2, resolve9, reject) {
+      function parseAsyncNext(index3, blocksize2, resolve10, reject) {
         if (index3 >= str2.length) {
           try {
-            return resolve9(parser.finish());
+            return resolve10(parser.finish());
           } catch (err2) {
             return reject(prettyError(err2, str2));
           }
         }
         try {
           parser.parse(str2.slice(index3, index3 + blocksize2));
-          setImmediate(parseAsyncNext, index3 + blocksize2, blocksize2, resolve9, reject);
+          setImmediate(parseAsyncNext, index3 + blocksize2, blocksize2, resolve10, reject);
         } catch (err2) {
           reject(prettyError(err2, str2));
         }
@@ -1660,7 +1660,7 @@ var require_parse_stream = __commonJS({
     function parseReadable(stm) {
       const parser = new TOMLParser();
       stm.setEncoding("utf8");
-      return new Promise((resolve9, reject) => {
+      return new Promise((resolve10, reject) => {
         let readable;
         let ended = false;
         let errored = false;
@@ -1668,7 +1668,7 @@ var require_parse_stream = __commonJS({
           ended = true;
           if (readable) return;
           try {
-            resolve9(parser.finish());
+            resolve10(parser.finish());
           } catch (err2) {
             reject(err2);
           }
@@ -13597,7 +13597,7 @@ async function waitForMcpDoctorResponses(chunks, finished) {
   while (!finished() && (chunks.join("").match(/\n/g)?.length ?? 0) < 2) {
     if (Date.now() - started >= 1e3)
       return;
-    await new Promise((resolve9) => setTimeout(resolve9, 5));
+    await new Promise((resolve10) => setTimeout(resolve10, 5));
   }
 }
 function parseMcpDoctorResponses(chunks) {
@@ -14121,11 +14121,11 @@ function resolveDisplayName(name, aliases) {
   const bin = process.argv[1];
   if (!bin)
     return name;
-  const basename3 = path3.basename(bin);
-  if (basename3 === name)
+  const basename4 = path3.basename(bin);
+  if (basename4 === name)
     return name;
-  if (aliases?.includes(basename3))
-    return basename3;
+  if (aliases?.includes(basename4))
+    return basename4;
   return name;
 }
 
@@ -14259,7 +14259,7 @@ var native_spec_default = {
       "x-whop-summary": "Issue cards that spend from a balance."
     },
     {
-      description: "Cashback rules designate a funding platform, optional merchant name and category filters, a rate, and an eligibility window. Every supplied merchant filter must match. An account ID limits the rule to one of the platform's direct connected accounts and is required when both merchant filters are omitted or null.\n\nUse the Cashback Rules API to create future-dated rules, update their merchant name, MCC, description, or expiration, and list every rule funded by the authenticated platform, including expired and discarded rules. Discarded rules cannot be updated. Creating or updating a rule does not transfer funds.\n",
+      description: "Cashback rules designate a funding platform, optional merchant name and category filters, a rate, and an eligibility window. Every supplied merchant filter must match. An account ID limits the rule to one of the platform's direct connected accounts and is required when both merchant filters are omitted or null.\n\nUse the Cashback Rules API to create future-dated rules, update their merchant name, MCC, description, or expiration, and list every rule funded by the authenticated platform, including expired and discarded rules. Discarded rules cannot be updated. Creating or updating a rule does not transfer funds.\n\nPay out cashback on demand from the platform's available USD balance with optional rule, account, and transaction filters. Only completed, unpaid, eligible transactions are paid. The response returns status `processing` and echoes supplied filters; `failed` means the queue rejected the request. These statuses describe scheduling, not payment completion.\n",
       name: "Cashback Rules",
       "x-whop-summary": "Configure platform-sponsored card cashback."
     },
@@ -14689,6 +14689,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -16290,6 +16291,7 @@ var native_spec_default = {
                           },
                           business_name: {
                             description: "The business name on the latest application.",
+                            example: null,
                             type: ["string", "null"]
                           },
                           business_type: {
@@ -16318,10 +16320,12 @@ var native_spec_default = {
                           },
                           denial_reason: {
                             description: "Why the latest application was denied. `null` unless `status` is `denied`.",
+                            example: null,
                             type: ["string", "null"]
                           },
                           request_id: {
                             description: "The latest application's request ID, prefixed `inrq_`. `null` until the account applies.",
+                            example: null,
                             type: ["string", "null"]
                           },
                           status: {
@@ -16338,6 +16342,7 @@ var native_spec_default = {
                           },
                           url: {
                             description: "The website on the latest application.",
+                            example: null,
                             type: ["string", "null"]
                           }
                         },
@@ -16516,6 +16521,7 @@ var native_spec_default = {
                     },
                     economic_intelligence_ends_at: {
                       description: "When the account's committed Economic Intelligence period ends, as an ISO 8601 timestamp. Economic Intelligence can't be turned off before then. `null` when Economic Intelligence is off or has no end date.",
+                      example: null,
                       type: ["string", "null"]
                     },
                     economic_intelligence_offers: {
@@ -16799,6 +16805,7 @@ var native_spec_default = {
                           },
                           business_name: {
                             description: "The business name on the latest application.",
+                            example: null,
                             type: ["string", "null"]
                           },
                           business_type: {
@@ -16827,6 +16834,7 @@ var native_spec_default = {
                           },
                           denial_reason: {
                             description: "Why the latest application was denied. `null` unless `status` is `denied`.",
+                            example: null,
                             type: ["string", "null"]
                           },
                           request_id: {
@@ -16848,6 +16856,7 @@ var native_spec_default = {
                           },
                           url: {
                             description: "The website on the latest application.",
+                            example: null,
                             type: ["string", "null"]
                           }
                         },
@@ -18867,6 +18876,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           nullable: true,
                           type: "string"
                         },
@@ -19759,6 +19769,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           nullable: true,
                           type: "string"
                         },
@@ -19771,6 +19782,7 @@ var native_spec_default = {
                           type: "boolean"
                         },
                         start_cursor: {
+                          example: null,
                           nullable: true,
                           type: "string"
                         }
@@ -20551,6 +20563,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           nullable: true,
                           type: "string"
                         },
@@ -21995,6 +22008,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           nullable: true,
                           type: "string"
                         },
@@ -23339,6 +23353,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -23350,6 +23365,7 @@ var native_spec_default = {
                           type: "boolean"
                         },
                         start_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         }
                       },
@@ -23591,6 +23607,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           nullable: true,
                           type: "string"
                         },
@@ -23603,6 +23620,7 @@ var native_spec_default = {
                           type: "boolean"
                         },
                         start_cursor: {
+                          example: null,
                           nullable: true,
                           type: "string"
                         }
@@ -23761,6 +23779,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -25224,6 +25243,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -25887,6 +25907,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -26267,6 +26288,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -26778,6 +26800,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -27412,6 +27435,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -27950,6 +27974,7 @@ var native_spec_default = {
                     },
                     canceled_at: {
                       description: "When the card was canceled.",
+                      example: null,
                       format: "date-time",
                       type: ["string", "null"]
                     },
@@ -29055,6 +29080,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -29066,6 +29092,7 @@ var native_spec_default = {
                           type: "boolean"
                         },
                         start_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         }
                       },
@@ -29112,6 +29139,97 @@ var native_spec_default = {
         }
       }
     },
+    "/cashback_rules/payout": {
+      post: {
+        description: "Distributes cashback on demand from the authenticated platform's available USD balance to its direct connected accounts. Requires payout:transfer_funds. Optional filters combine; an empty body includes all eligible transactions. Only completed, unpaid transactions created before this request are considered. The latest matching rule wins; its funding account must be the authenticated platform. Amounts are calculated when processed. Returns status `processing` and echoes supplied filters when background processing is queued. Status `failed` with HTTP 200 means the queue rejected the request. This is not a payment confirmation. Failed transaction jobs retry automatically; insufficient funds requires adding USD to the funding wallet. Supports Idempotency-Key, and overlapping requests cannot pay the same card transaction twice.",
+        operationId: "payout",
+        parameters: [
+          {
+            $ref: "#/components/parameters/ApiVersionDate"
+          },
+          {
+            description: "Client-generated key for replaying the same request safely for 24 hours.",
+            in: "header",
+            name: "Idempotency-Key",
+            required: false,
+            schema: {
+              maxLength: 255,
+              minLength: 1,
+              type: "string"
+            }
+          }
+        ],
+        requestBody: {
+          content: {
+            "application/json": {
+              schema: {
+                additionalProperties: false,
+                properties: {
+                  account_id: {
+                    description: "Pay only this direct connected account.",
+                    pattern: "^biz_",
+                    type: ["string", "null"]
+                  },
+                  cashback_rule_id: {
+                    description: "Pay only transactions whose winning cashback rule has this ID and is funded by the authenticated platform.",
+                    pattern: "^cicbr_",
+                    type: ["string", "null"]
+                  },
+                  transaction_id: {
+                    description: "Pay only this card transaction belonging to a direct connected account.",
+                    example: "citx_xxxxxxxxxxxxxx",
+                    pattern: "^citx_",
+                    type: ["string", "null"]
+                  }
+                },
+                type: "object"
+              }
+            }
+          },
+          required: true
+        },
+        responses: {
+          "200": {
+            content: {
+              "application/json": {
+                schema: {
+                  $ref: "#/components/schemas/CashbackPayout"
+                }
+              }
+            },
+            description: "queue rejected the request"
+          },
+          "202": {
+            content: {
+              "application/json": {
+                schema: {
+                  $ref: "#/components/schemas/CashbackPayout"
+                }
+              }
+            },
+            description: "payout queued"
+          },
+          "400": {
+            $ref: "#/components/responses/InvalidParameters",
+            description: "invalid filter"
+          },
+          "401": {
+            $ref: "#/components/responses/Unauthorized",
+            description: "authentication required"
+          },
+          "409": {
+            $ref: "#/components/responses/Conflict"
+          }
+        },
+        security: [
+          {
+            bearerAuth: []
+          }
+        ],
+        summary: "Pay Out Cashback",
+        tags: ["Cashback Rules"]
+      }
+    },
     "/cashback_rules/{id}": {
       patch: {
         description: "Updates a cashback rule funded by the authenticated platform account. Requires payout:transfer_funds. Only merchant_name, merchant_category_code, description, and expires_at can change; starts_at, rate_bps, funding_account_id, and scoped_account_id are immutable. Omitted fields stay unchanged. Scheduled, active, and expired rules can be updated; discarded rules cannot. Updating a rule does not transfer funds.",
@@ -29535,6 +29653,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -30905,6 +31024,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -31172,6 +31292,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -32228,6 +32349,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -32602,6 +32724,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -34354,6 +34477,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -35279,6 +35403,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -35948,6 +36073,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -37650,6 +37776,7 @@ var native_spec_default = {
                           $ref: "#/components/schemas/Money"
                         },
                         {
+                          example: null,
                           type: "null"
                         }
                       ]
@@ -38067,6 +38194,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -38291,6 +38419,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -38509,6 +38638,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -39853,6 +39983,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -40095,6 +40226,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -41119,6 +41251,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -42130,6 +42263,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -42577,6 +42711,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -42843,6 +42978,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -43305,6 +43441,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -43527,6 +43664,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -44182,6 +44320,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -44829,6 +44968,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -44840,6 +44980,7 @@ var native_spec_default = {
                           type: "boolean"
                         },
                         start_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         }
                       },
@@ -45896,11 +46037,13 @@ var native_spec_default = {
                     },
                     destination_amount: {
                       description: "The amount delivered in the destination currency, as a decimal string. Null until the payout settles; appears on the payout in GET /payouts once assigned.",
+                      example: null,
                       format: "decimal",
                       type: ["string", "null"]
                     },
                     destination_currency: {
                       description: "Currency the funds are delivered in, taken from the payout method. On a stablecoin payout it follows the settlement payout minted alongside it \u2014 the `GET /payouts` row carrying this payout's id as `payout_request_id` \u2014 and is `null` only when no settlement payout exists.",
+                      example: null,
                       type: ["string", "null"]
                     },
                     estimated_arrival: {
@@ -45911,6 +46054,7 @@ var native_spec_default = {
                     },
                     exchange_rate: {
                       description: "Exchange rate from the payout currency to the destination currency. Null until the payout settles; appears on the payout in GET /payouts once assigned.",
+                      example: null,
                       format: "float",
                       type: ["number", "null"]
                     },
@@ -46085,6 +46229,7 @@ var native_spec_default = {
                     },
                     trace_code: {
                       description: "ACH trace number the recipient's bank can use to locate this payout. Always `null` here \u2014 it is assigned when the payout is submitted to the bank, and appears on the payout in GET /payouts once it has been sent; payouts not sent over ACH never get one.",
+                      example: null,
                       type: ["string", "null"]
                     }
                   },
@@ -46499,6 +46644,7 @@ var native_spec_default = {
                           },
                           status_reason: {
                             description: "Machine-readable code for why the method is `broken` \u2014 the newest disabling failure recorded through it, whether a payout error or a pre-payout rejection. `null` unless the method is broken, or when it was disabled without a recorded failure.",
+                            example: null,
                             type: ["string", "null"]
                           },
                           supported_payout_method: {
@@ -46704,6 +46850,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -46876,10 +47023,12 @@ var native_spec_default = {
                     },
                     estimated_arrival: {
                       description: "Null on create. List payout methods to retrieve arrival estimates.",
+                      example: null,
                       type: ["object", "null"]
                     },
                     fee_structure: {
                       description: "Null on create. List payout methods to retrieve the configured fee terms.",
+                      example: null,
                       type: ["object", "null"]
                     },
                     id: {
@@ -46902,6 +47051,7 @@ var native_spec_default = {
                     },
                     last_paid_out_at: {
                       description: "When the most recent completed payout was delivered to this method, as an ISO 8601 timestamp. `null` when nothing has been paid out to it yet.",
+                      example: null,
                       format: "date-time",
                       type: ["string", "null"]
                     },
@@ -46931,6 +47081,7 @@ var native_spec_default = {
                     },
                     quote: {
                       description: "Always null on create.",
+                      example: null,
                       type: ["object", "null"]
                     },
                     status: {
@@ -46941,6 +47092,7 @@ var native_spec_default = {
                     },
                     status_reason: {
                       description: "Always `null` on create.",
+                      example: null,
                       type: ["string", "null"]
                     },
                     supported_payout_method: {
@@ -47229,10 +47381,12 @@ var native_spec_default = {
                     },
                     estimated_arrival: {
                       description: "`null` after an update. List payout methods to retrieve arrival estimates.",
+                      example: null,
                       type: ["object", "null"]
                     },
                     fee_structure: {
                       description: "`null` after an update. List payout methods to retrieve the configured fee terms.",
+                      example: null,
                       type: ["object", "null"]
                     },
                     id: {
@@ -47255,6 +47409,7 @@ var native_spec_default = {
                     },
                     last_paid_out_at: {
                       description: "When the most recent completed payout was delivered to this method, as an ISO 8601 timestamp. `null` when nothing has been paid out to it yet.",
+                      example: null,
                       format: "date-time",
                       type: ["string", "null"]
                     },
@@ -47284,6 +47439,7 @@ var native_spec_default = {
                     },
                     quote: {
                       description: "Always `null` after an update.",
+                      example: null,
                       type: ["object", "null"]
                     },
                     status: {
@@ -47294,6 +47450,7 @@ var native_spec_default = {
                     },
                     status_reason: {
                       description: "Machine-readable code for why the method is `broken` \u2014 the newest failure recorded through it, whether a payout error or a pre-payout rejection. `null` unless the method is broken, or when it was disabled without a recorded failure.",
+                      example: null,
                       type: ["string", "null"]
                     },
                     supported_payout_method: {
@@ -48458,6 +48615,7 @@ var native_spec_default = {
                         },
                         funds_returned_at: {
                           description: "The effective time of the reversal that put the funds back in the balance \u2014 `null` if they never left it or have not returned yet. Set only once the return is confirmed in the ledger; the ledger posting itself can land moments after this time.",
+                          example: null,
                           format: "date-time",
                           type: ["string", "null"]
                         },
@@ -50533,6 +50691,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -51791,6 +51950,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -52595,6 +52755,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -53243,6 +53404,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -53537,6 +53699,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -54355,6 +54518,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -54779,6 +54943,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -55297,6 +55462,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -55742,6 +55908,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           nullable: true,
                           type: "string"
                         },
@@ -57316,10 +57483,22 @@ var native_spec_default = {
         operationId: "status",
         parameters: [
           {
-            description: "Business or user account ID (biz_* / user_*).",
+            $ref: "#/components/parameters/ApiVersionDate"
+          },
+          {
+            description: "Business account whose swaps to list, prefixed `biz_`. Provide this or `user_id`.",
             in: "query",
             name: "account_id",
-            required: true,
+            required: false,
+            schema: {
+              type: "string"
+            }
+          },
+          {
+            description: "The caller's own user ID, prefixed `user_`, to list swaps in their personal account. Provide this or `account_id`.",
+            in: "query",
+            name: "user_id",
+            required: false,
             schema: {
               type: "string"
             }
@@ -57336,7 +57515,7 @@ var native_spec_default = {
                       items: {
                         properties: {
                           account_id: {
-                            description: "Account ID that owns the wallet used for the swap.",
+                            description: "Account that owns the swap: a business ID prefixed `biz_`, or the user ID for a personal account.",
                             example: "biz_xxxxxxxxxxxxxx",
                             type: "string"
                           },
@@ -57368,12 +57547,18 @@ var native_spec_default = {
                               type: "string"
                             },
                             type: "array"
+                          },
+                          user_id: {
+                            description: "User whose personal account owns the swap, prefixed `user_`. Null for a business account.",
+                            example: null,
+                            type: ["string", "null"]
                           }
                         },
                         required: [
                           "object",
                           "id",
                           "account_id",
+                          "user_id",
                           "status",
                           "tx_hashes"
                         ],
@@ -57420,6 +57605,9 @@ var native_spec_default = {
         description: "Swaps one token for another from the account's wallet, or converts between fiat currencies in the account's ledger at the mid-market rate. Crypto swaps finish in the background \u2014 check the swap for its status.",
         operationId: "create",
         parameters: [
+          {
+            $ref: "#/components/parameters/ApiVersionDate"
+          },
           {
             $ref: "#/components/parameters/IdempotencyKey"
           }
@@ -57430,7 +57618,7 @@ var native_spec_default = {
               schema: {
                 properties: {
                   account_id: {
-                    description: "Business or user account ID (biz_* / user_*).",
+                    description: "Business account that makes the swap, prefixed `biz_`. Provide this or `user_id`.",
                     example: "biz_xxxxxxxxxxxxxx",
                     type: "string"
                   },
@@ -57488,9 +57676,13 @@ var native_spec_default = {
                     description: 'Destination token contract address or ticker symbol, such as "XAUT".',
                     example: "cad",
                     type: "string"
+                  },
+                  user_id: {
+                    description: "The caller's own user ID, prefixed `user_`, to swap in their personal account. Provide this or `account_id`.",
+                    type: "string"
                   }
                 },
-                required: ["account_id", "from_token", "to_token"],
+                required: ["from_token", "to_token"],
                 type: "object"
               }
             }
@@ -57504,7 +57696,7 @@ var native_spec_default = {
                 schema: {
                   properties: {
                     account_id: {
-                      description: "Account ID that owns the wallet used for the swap.",
+                      description: "Account that owns the swap: a business ID prefixed `biz_`, or the user ID for a personal account.",
                       example: "biz_xxxxxxxxxxxxxx",
                       type: "string"
                     },
@@ -57573,9 +57765,14 @@ var native_spec_default = {
                         }
                       },
                       type: ["object", "null"]
+                    },
+                    user_id: {
+                      description: "User whose personal account owns the swap, prefixed `user_`. Null for a business account.",
+                      example: null,
+                      type: ["string", "null"]
                     }
                   },
-                  required: ["object", "account_id", "status"],
+                  required: ["object", "account_id", "user_id", "status"],
                   type: "object"
                 }
               }
@@ -57849,6 +58046,9 @@ var native_spec_default = {
         description: "Retrieves a single swap and its status.",
         operationId: "get",
         parameters: [
+          {
+            $ref: "#/components/parameters/ApiVersionDate"
+          },
           {
             description: "Swap ID returned from POST /swaps.",
             in: "path",
@@ -57866,7 +58066,7 @@ var native_spec_default = {
                 schema: {
                   properties: {
                     account_id: {
-                      description: "Account ID that owns the wallet used for the swap.",
+                      description: "Account that owns the swap: a business ID prefixed `biz_`, or the user ID for a personal account.",
                       example: "biz_xxxxxxxxxxxxxx",
                       type: "string"
                     },
@@ -57898,12 +58098,18 @@ var native_spec_default = {
                         type: "string"
                       },
                       type: "array"
+                    },
+                    user_id: {
+                      description: "User whose personal account owns the swap, prefixed `user_`. Null for a business account.",
+                      example: null,
+                      type: ["string", "null"]
                     }
                   },
                   required: [
                     "object",
                     "id",
                     "account_id",
+                    "user_id",
                     "status",
                     "tx_hashes"
                   ],
@@ -58102,6 +58308,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -58666,15 +58873,18 @@ var native_spec_default = {
                           },
                           failed_at: {
                             description: "When the transfer failed, as an ISO 8601 timestamp. Null unless the transfer has failed.",
+                            example: null,
                             format: "date-time",
                             type: ["string", "null"]
                           },
                           failure_code: {
                             description: "Machine-readable code for why the transfer failed. Null unless the transfer has failed.",
+                            example: null,
                             type: ["string", "null"]
                           },
                           failure_reason: {
                             description: "Human-readable explanation of why the transfer failed. Null unless the transfer has failed.",
+                            example: null,
                             type: ["string", "null"]
                           },
                           fee_amount: {
@@ -58737,6 +58947,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -59007,15 +59218,18 @@ var native_spec_default = {
                         },
                         failed_at: {
                           description: "When the transfer failed, as an ISO 8601 timestamp. Null unless the transfer has failed.",
+                          example: null,
                           format: "date-time",
                           type: ["string", "null"]
                         },
                         failure_code: {
                           description: "Machine-readable code for why the transfer failed. Null unless the transfer has failed.",
+                          example: null,
                           type: ["string", "null"]
                         },
                         failure_reason: {
                           description: "Human-readable explanation of why the transfer failed. Null unless the transfer has failed.",
+                          example: null,
                           type: ["string", "null"]
                         },
                         fee_amount: {
@@ -59448,6 +59662,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -59649,15 +59864,18 @@ var native_spec_default = {
                     },
                     failed_at: {
                       description: "When the transfer failed, as an ISO 8601 timestamp. Null unless the transfer has failed.",
+                      example: null,
                       format: "date-time",
                       type: ["string", "null"]
                     },
                     failure_code: {
                       description: "Machine-readable code for why the transfer failed. Null unless the transfer has failed.",
+                      example: null,
                       type: ["string", "null"]
                     },
                     failure_reason: {
                       description: "Human-readable explanation of why the transfer failed. Null unless the transfer has failed.",
+                      example: null,
                       type: ["string", "null"]
                     },
                     fee_amount: {
@@ -59894,6 +60112,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -60045,6 +60264,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -60953,6 +61173,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -61096,6 +61317,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -61532,10 +61754,19 @@ var native_spec_default = {
             $ref: "#/components/parameters/ApiVersionDate"
           },
           {
-            description: "Account or user ID whose verifications you want to list. Use a `biz_` account ID, or the caller's `user_` ID for personal verifications.",
+            description: "Business account whose verifications you want to list, prefixed `biz_`. Provide this or `user_id`.",
             in: "query",
             name: "account_id",
-            required: true,
+            required: false,
+            schema: {
+              type: "string"
+            }
+          },
+          {
+            description: "The caller's own user ID, prefixed `user_`, to list personal verifications. Provide this or `account_id`.",
+            in: "query",
+            name: "user_id",
+            required: false,
             schema: {
               type: "string"
             }
@@ -61893,10 +62124,19 @@ var native_spec_default = {
             $ref: "#/components/parameters/ApiVersionDate"
           },
           {
-            description: "Account or user ID whose identity you want to verify. Use a `biz_` account ID for account verifications, or the caller's `user_` ID for personal verification.",
+            description: "Business account whose identity you want to verify, prefixed `biz_`. Provide this or `user_id`.",
             in: "query",
             name: "account_id",
-            required: true,
+            required: false,
+            schema: {
+              type: "string"
+            }
+          },
+          {
+            description: "The caller's own user ID, prefixed `user_`, for a personal verification. Provide this or `account_id`.",
+            in: "query",
+            name: "user_id",
+            required: false,
             schema: {
               type: "string"
             }
@@ -64029,6 +64269,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -64238,6 +64479,7 @@ var native_spec_default = {
                     },
                     plan_id: {
                       description: "The plan the request was narrowed to, prefixed `plan_`, or `null` when every waitlist plan on the account was included.",
+                      example: null,
                       type: ["string", "null"]
                     },
                     queued: {
@@ -64618,6 +64860,7 @@ var native_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -64811,50 +65054,7 @@ var native_spec_default = {
                         "refund.created",
                         "refund.updated",
                         "dispute_alert.created",
-                        "membership.cancel_at_period_end_changed",
-                        "membership_went_valid",
-                        "membership_went_invalid",
-                        "membership_metadata_updated",
-                        "resolution_created",
-                        "resolution_updated",
-                        "resolution_decided",
-                        "payment_affiliate_reward_created",
-                        "membership_experience_claimed",
-                        "app_membership_went_valid",
-                        "app_membership_went_invalid",
-                        "app_payment_created",
-                        "app_payment_succeeded",
-                        "app_payment_failed",
-                        "app_payment_pending",
-                        "app_payment_requires_action",
-                        "app_membership_cancel_at_period_end_changed",
-                        "payment_created",
-                        "payment_succeeded",
-                        "payment_failed",
-                        "payment_pending",
-                        "payment_requires_action",
-                        "dispute_created",
-                        "dispute_updated",
-                        "refund_created",
-                        "refund_updated",
-                        "dispute_alert_created",
-                        "membership_cancel_at_period_end_changed",
-                        "membership.went_valid",
-                        "membership.went_invalid",
-                        "membership.metadata_updated",
-                        "resolution.created",
-                        "resolution.updated",
-                        "resolution.decided",
-                        "payment.affiliate_reward_created",
-                        "membership.experience_claimed",
-                        "app_membership.went_valid",
-                        "app_membership.went_invalid",
-                        "app_payment.created",
-                        "app_payment.succeeded",
-                        "app_payment.failed",
-                        "app_payment.pending",
-                        "app_payment.requires_action",
-                        "app_membership.cancel_at_period_end_changed"
+                        "membership.cancel_at_period_end_changed"
                       ],
                       example: "payment.succeeded",
                       type: "string"
@@ -65212,50 +65412,7 @@ var native_spec_default = {
                         "refund.created",
                         "refund.updated",
                         "dispute_alert.created",
-                        "membership.cancel_at_period_end_changed",
-                        "membership_went_valid",
-                        "membership_went_invalid",
-                        "membership_metadata_updated",
-                        "resolution_created",
-                        "resolution_updated",
-                        "resolution_decided",
-                        "payment_affiliate_reward_created",
-                        "membership_experience_claimed",
-                        "app_membership_went_valid",
-                        "app_membership_went_invalid",
-                        "app_payment_created",
-                        "app_payment_succeeded",
-                        "app_payment_failed",
-                        "app_payment_pending",
-                        "app_payment_requires_action",
-                        "app_membership_cancel_at_period_end_changed",
-                        "payment_created",
-                        "payment_succeeded",
-                        "payment_failed",
-                        "payment_pending",
-                        "payment_requires_action",
-                        "dispute_created",
-                        "dispute_updated",
-                        "refund_created",
-                        "refund_updated",
-                        "dispute_alert_created",
-                        "membership_cancel_at_period_end_changed",
-                        "membership.went_valid",
-                        "membership.went_invalid",
-                        "membership.metadata_updated",
-                        "resolution.created",
-                        "resolution.updated",
-                        "resolution.decided",
-                        "payment.affiliate_reward_created",
-                        "membership.experience_claimed",
-                        "app_membership.went_valid",
-                        "app_membership.went_invalid",
-                        "app_payment.created",
-                        "app_payment.succeeded",
-                        "app_payment.failed",
-                        "app_payment.pending",
-                        "app_payment.requires_action",
-                        "app_membership.cancel_at_period_end_changed"
+                        "membership.cancel_at_period_end_changed"
                       ],
                       example: "payment.failed",
                       type: "string"
@@ -65395,6 +65552,7 @@ var native_spec_default = {
                           type: "boolean"
                         },
                         start_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         }
                       },
@@ -67302,6 +67460,14 @@ var native_spec_default = {
                         example: "issues",
                         type: "string"
                       },
+                      desired_cost_per_result: {
+                        description: "Google only: the target cost per conversion in USD when `bid_type` is `average_target`. `null` otherwise.",
+                        type: ["number", "null"]
+                      },
+                      ends_at: {
+                        description: "Google only: when the campaign stops delivering, as an ISO 8601 timestamp. `null` runs it until paused.",
+                        type: ["string", "null"]
+                      },
                       id: {
                         description: "Unique identifier for the ad campaign, prefixed `adcamp_`.",
                         example: "adcamp_xxxxxxxxxxxxxx",
@@ -67329,6 +67495,7 @@ var native_spec_default = {
                       },
                       optimization_goal: {
                         description: "The event the campaign optimizes for when a single goal is set campaign-wide. `null` when each ad group sets its own optimization_goal.",
+                        example: null,
                         type: ["string", "null"]
                       },
                       platform: {
@@ -67351,6 +67518,10 @@ var native_spec_default = {
                         },
                         type: "array"
                       },
+                      starts_at: {
+                        description: "Google only: when the campaign starts delivering, as an ISO 8601 timestamp. `null` starts it as soon as it launches.",
+                        type: ["string", "null"]
+                      },
                       status: {
                         description: "The configured lifecycle status of the ad campaign. Billing failures preserve active or paused here and set delivery_status to payment_failed.",
                         enum: [
@@ -67602,6 +67773,14 @@ var native_spec_default = {
                         example: "issues",
                         type: "string"
                       },
+                      desired_cost_per_result: {
+                        description: "Google only: the target cost per conversion in USD when `bid_type` is `average_target`. `null` otherwise.",
+                        type: ["number", "null"]
+                      },
+                      ends_at: {
+                        description: "Google only: when the campaign stops delivering, as an ISO 8601 timestamp. `null` runs it until paused.",
+                        type: ["string", "null"]
+                      },
                       id: {
                         description: "Unique identifier for the ad campaign, prefixed `adcamp_`.",
                         example: "adcamp_xxxxxxxxxxxxxx",
@@ -67629,6 +67808,7 @@ var native_spec_default = {
                       },
                       optimization_goal: {
                         description: "The event the campaign optimizes for when a single goal is set campaign-wide. `null` when each ad group sets its own optimization_goal.",
+                        example: null,
                         type: ["string", "null"]
                       },
                       platform: {
@@ -67651,6 +67831,10 @@ var native_spec_default = {
                         },
                         type: "array"
                       },
+                      starts_at: {
+                        description: "Google only: when the campaign starts delivering, as an ISO 8601 timestamp. `null` starts it as soon as it launches.",
+                        type: ["string", "null"]
+                      },
                       status: {
                         description: "The configured lifecycle status of the ad campaign. Billing failures preserve active or paused here and set delivery_status to payment_failed.",
                         enum: [
@@ -70800,6 +70984,7 @@ var native_spec_default = {
                 data: {
                   account_id: null,
                   amount: 25,
+                  auto_refunded: false,
                   card_brand: "visa",
                   created_at: "2026-01-01T12:00:00.000Z",
                   currency: "usd",
@@ -75547,6 +75732,7 @@ var native_spec_default = {
                       },
                       status_reason: {
                         description: "Machine-readable code for why the method is `broken` \u2014 the newest disabling failure recorded through it, whether a payout error or a pre-payout rejection. `null` unless the method is broken, or when it was disabled without a recorded failure.",
+                        example: null,
                         type: ["string", "null"]
                       },
                       supported_payout_method: {
@@ -78628,7 +78814,7 @@ var native_spec_default = {
                     from_amount: "502.51",
                     from_currency: "usdt",
                     id: "airdrp_xxxxxxxxxxxxxx",
-                    notes: "some_string",
+                    notes: null,
                     object: "airdrop_link",
                     payer_name: "MassPay",
                     payment_amount: {
@@ -78936,15 +79122,18 @@ var native_spec_default = {
                       },
                       failed_at: {
                         description: "When the transfer failed, as an ISO 8601 timestamp. Null unless the transfer has failed.",
+                        example: null,
                         format: "date-time",
                         type: ["string", "null"]
                       },
                       failure_code: {
                         description: "Machine-readable code for why the transfer failed. Null unless the transfer has failed.",
+                        example: null,
                         type: ["string", "null"]
                       },
                       failure_reason: {
                         description: "Human-readable explanation of why the transfer failed. Null unless the transfer has failed.",
+                        example: null,
                         type: ["string", "null"]
                       },
                       fee_amount: {
@@ -79320,15 +79509,18 @@ var native_spec_default = {
                       },
                       failed_at: {
                         description: "When the transfer failed, as an ISO 8601 timestamp. Null unless the transfer has failed.",
+                        example: null,
                         format: "date-time",
                         type: ["string", "null"]
                       },
                       failure_code: {
                         description: "Machine-readable code for why the transfer failed. Null unless the transfer has failed.",
+                        example: null,
                         type: ["string", "null"]
                       },
                       failure_reason: {
                         description: "Human-readable explanation of why the transfer failed. Null unless the transfer has failed.",
+                        example: null,
                         type: ["string", "null"]
                       },
                       fee_amount: {
@@ -79702,15 +79894,18 @@ var native_spec_default = {
                       },
                       failed_at: {
                         description: "When the transfer failed, as an ISO 8601 timestamp. Null unless the transfer has failed.",
+                        example: null,
                         format: "date-time",
                         type: ["string", "null"]
                       },
                       failure_code: {
                         description: "Machine-readable code for why the transfer failed. Null unless the transfer has failed.",
+                        example: null,
                         type: ["string", "null"]
                       },
                       failure_reason: {
                         description: "Human-readable explanation of why the transfer failed. Null unless the transfer has failed.",
+                        example: null,
                         type: ["string", "null"]
                       },
                       fee_amount: {
@@ -84457,6 +84652,7 @@ var native_spec_default = {
         properties: {
           day: {
             description: "Day the automatic withdrawal runs on: 0-6 (Sunday-Saturday) for `weekly`, 1-31 for `monthly`. `null` for `manual` and `daily`.",
+            example: null,
             type: ["integer", "null"]
           },
           frequency: {
@@ -84467,6 +84663,7 @@ var native_spec_default = {
           },
           next_payout_date: {
             description: "Next date the automatic withdrawal is scheduled to run, as an ISO 8601 date. `null` for `manual` and `daily`, where no single next date applies.",
+            example: null,
             type: ["string", "null"]
           }
         },
@@ -84688,6 +84885,7 @@ var native_spec_default = {
           },
           frequency: {
             description: "Platform-reported impressions divided by reach.",
+            example: null,
             type: ["number", "null"]
           },
           headlines: {
@@ -84901,6 +85099,7 @@ var native_spec_default = {
           },
           unique_click_through_rate: {
             description: "Unique clicks divided by impressions, between 0 and 1.",
+            example: null,
             type: ["number", "null"]
           },
           unique_clicks: {
@@ -85186,8 +85385,17 @@ var native_spec_default = {
             example: "issues",
             type: "string"
           },
+          desired_cost_per_result: {
+            description: "Google only: the target cost per conversion in USD when `bid_type` is `average_target`. `null` otherwise.",
+            type: ["number", "null"]
+          },
+          ends_at: {
+            description: "Google only: when the campaign stops delivering, as an ISO 8601 timestamp. `null` runs it until paused.",
+            type: ["string", "null"]
+          },
           frequency: {
             description: "Platform-reported impressions divided by reach.",
+            example: null,
             type: ["number", "null"]
           },
           id: {
@@ -85237,6 +85445,7 @@ var native_spec_default = {
           },
           optimization_goal: {
             description: "The event the campaign optimizes for when a single goal is set campaign-wide. `null` when each ad group sets its own optimization_goal.",
+            example: null,
             type: ["string", "null"]
           },
           platform: {
@@ -85327,6 +85536,10 @@ var native_spec_default = {
             example: "usd",
             type: ["string", "null"]
           },
+          starts_at: {
+            description: "Google only: when the campaign starts delivering, as an ISO 8601 timestamp. `null` starts it as soon as it launches.",
+            type: ["string", "null"]
+          },
           status: {
             description: "The configured lifecycle status of the ad campaign. Billing failures preserve active or paused here and set delivery_status to payment_failed.",
             enum: [
@@ -85363,6 +85576,7 @@ var native_spec_default = {
           },
           unique_click_through_rate: {
             description: "Unique clicks divided by impressions, between 0 and 1.",
+            example: null,
             type: ["number", "null"]
           },
           unique_clicks: {
@@ -85499,6 +85713,7 @@ var native_spec_default = {
           },
           percentage_change: {
             description: "Signed percent change: 20 increases by 20%, negative 20 decreases by 20%. The sent value cannot go below zero. Null for a fixed rule.",
+            example: null,
             type: ["number", "null"]
           },
           status: {
@@ -85539,6 +85754,7 @@ var native_spec_default = {
         properties: {
           custom_name: {
             description: "Exact custom event name. Null for standard events.",
+            example: null,
             type: ["string", "null"]
           },
           event_name: {
@@ -85573,6 +85789,7 @@ var native_spec_default = {
           },
           resource_id: {
             description: "Selected campaign, ad group, or ad ID. Null for a business target.",
+            example: null,
             type: ["string", "null"]
           },
           resource_title: {
@@ -85899,6 +86116,7 @@ var native_spec_default = {
           },
           frequency: {
             description: "Platform-reported impressions divided by reach.",
+            example: null,
             type: ["number", "null"]
           },
           frequency_cap: {
@@ -86105,6 +86323,7 @@ var native_spec_default = {
           },
           unique_click_through_rate: {
             description: "Unique clicks divided by impressions, between 0 and 1.",
+            example: null,
             type: ["number", "null"]
           },
           unique_clicks: {
@@ -86969,6 +87188,7 @@ var native_spec_default = {
           },
           file_url: {
             description: "File the follow-up button opens. Set when `button_type` is `download`.",
+            example: null,
             type: ["string", "null"]
           },
           headline: {
@@ -86978,6 +87198,7 @@ var native_spec_default = {
           },
           phone_number: {
             description: "Number the follow-up button calls. Set when `button_type` is `call`.",
+            example: null,
             type: ["string", "null"]
           },
           url: {
@@ -87498,6 +87719,7 @@ var native_spec_default = {
             type: "string"
           },
           domains: {
+            example: null,
             items: {
               $ref: "#/components/schemas/AppDomain",
               description: "Custom domain claims and assignments for this app, excluding removed domains. Empty when none exist; `null` when the caller lacks the account's `developer:basic:read` permission."
@@ -87912,6 +88134,7 @@ var native_spec_default = {
           },
           build_id: {
             description: "The build the deployment produced, prefixed `abld_`, or `null` until it succeeds.",
+            example: null,
             type: ["string", "null"]
           },
           draft: {
@@ -87921,6 +88144,7 @@ var native_spec_default = {
           },
           error: {
             description: "Why the deployment failed, or `null` when it did not.",
+            example: null,
             type: ["string", "null"]
           },
           estimated_duration_ms: {
@@ -87935,6 +88159,7 @@ var native_spec_default = {
           },
           finished_at: {
             description: "When the deployment ended, in milliseconds since the epoch, or `null` while it is still running.",
+            example: null,
             type: ["integer", "null"]
           },
           phase: {
@@ -87977,6 +88202,7 @@ var native_spec_default = {
           },
           url: {
             description: "Where the deployed site is served, or `null` unless the deployment went live.",
+            example: null,
             type: ["string", "null"]
           }
         },
@@ -88065,6 +88291,7 @@ var native_spec_default = {
           },
           base_url: {
             description: "The production base URL where the app is hosted. `null` if no base URL is configured, if the caller lacks the `developer:basic:read` permission on the app's account, or on list responses, which never expose it.",
+            example: null,
             type: ["string", "null"]
           },
           businesses_created_count: {
@@ -88105,6 +88332,7 @@ var native_spec_default = {
             type: "string"
           },
           domains: {
+            example: null,
             items: {
               $ref: "#/components/schemas/AppDomain",
               description: "Custom domain claims and assignments for this app, excluding removed domains. Empty when none exist; `null` when the caller lacks the account's `developer:basic:read` permission."
@@ -88887,14 +89115,17 @@ var native_spec_default = {
           },
           discussion_experience_id: {
             description: "Experience the bounty's discussion thread lives in, prefixed `exp_`. Read this \u2014 not `experience_id` \u2014 to open the thread: a platform-wide bounty has no hosting experience of its own but its discussion still lives in one.",
+            example: null,
             type: ["string", "null"]
           },
           discussion_feed_id: {
             description: "Forum feed containing the bounty's discussion thread. `null` for a bounty with no forum post.",
+            example: null,
             type: ["string", "null"]
           },
           discussion_post_id: {
             description: "Forum post anchoring the bounty's discussion thread. Read together with `discussion_experience_id` to address the thread. `null` for a bounty with no forum post.",
+            example: null,
             type: ["string", "null"]
           },
           experience_id: {
@@ -89240,14 +89471,17 @@ var native_spec_default = {
           },
           discussion_experience_id: {
             description: "Experience the bounty's discussion thread lives in, prefixed `exp_`. Read this \u2014 not `experience_id` \u2014 to open the thread: a platform-wide bounty has no hosting experience of its own but its discussion still lives in one.",
+            example: null,
             type: ["string", "null"]
           },
           discussion_feed_id: {
             description: "Forum feed containing the bounty's discussion thread. `null` for a bounty with no forum post.",
+            example: null,
             type: ["string", "null"]
           },
           discussion_post_id: {
             description: "Forum post anchoring the bounty's discussion thread. Read together with `discussion_experience_id` to address the thread. `null` for a bounty with no forum post.",
+            example: null,
             type: ["string", "null"]
           },
           experience_id: {
@@ -89294,6 +89528,7 @@ var native_spec_default = {
           },
           min_total_verified_duration_seconds: {
             description: "Total verified footage a submission must accumulate before it can be submitted, in seconds. Always a whole number of hours. Present only on `data_capture` bounties \u2014 it is what `net_reward_amount` pays for, so rate displays divide by it. `null` for every other goal type.",
+            example: null,
             type: ["integer", "null"]
           },
           net_reward_amount: {
@@ -89398,6 +89633,7 @@ var native_spec_default = {
             type: "string"
           },
           capture_clips: {
+            example: null,
             items: {
               $ref: "#/components/schemas/BountyCaptureClip",
               description: "The submission's capture clips in recording order, each carrying its own review `status` and temporary signed artifact URLs. The full deliverable when `deliverable_type` is `data_capture`, populated only on single-submission reads; `null` on list responses (use `captured_clip_count` and `captured_duration_seconds` for the summary) and for other deliverable types. An attempt still in progress lists every clip it has recorded, including failed ones; once submitted, only clips that passed validation are listed, since only those are evidence."
@@ -89966,6 +90202,31 @@ var native_spec_default = {
         ],
         type: "object"
       },
+      CashbackPayout: {
+        properties: {
+          account_id: {
+            description: "Connected account filter from the request, prefixed `biz_`. Omitted when not supplied.",
+            type: ["string", "null"]
+          },
+          cashback_rule_id: {
+            description: "Cashback rule filter from the request, prefixed `cicbr_`. Omitted when not supplied.",
+            type: ["string", "null"]
+          },
+          status: {
+            description: "Request status. `processing` means background processing was queued, not that payment completed. `failed` means the queue rejected the request. Subsequent transaction failures retry automatically.",
+            enum: ["processing", "failed"],
+            example: "failed",
+            type: "string"
+          },
+          transaction_id: {
+            description: "Card transaction filter from the request, prefixed `citx_`. Omitted when not supplied.",
+            example: "citx_xxxxxxxxxxxxxx",
+            type: ["string", "null"]
+          }
+        },
+        required: ["status"],
+        type: "object"
+      },
       CashbackRule: {
         properties: {
           created_at: {
@@ -89980,6 +90241,7 @@ var native_spec_default = {
           },
           discarded_at: {
             description: "When the rule was discarded, as an ISO 8601 timestamp. Null means it has not been discarded.",
+            example: null,
             type: ["string", "null"]
           },
           expires_at: {
@@ -90491,6 +90753,11 @@ var native_spec_default = {
             example: 25,
             type: "number"
           },
+          auto_refunded: {
+            description: "Whether Whop automatically refunded the alerted payment. Reflects the payment, so it can be `true` for a refund issued by another flow (RDR, resolution) on the same payment.",
+            example: false,
+            type: "boolean"
+          },
           card_brand: {
             description: "The card network as reported by the issuer, lowercased, such as `visa` or `mastercard`. `unknown` when the report carries neither a network nor a recognizable BIN.",
             example: "visa",
@@ -90519,6 +90786,7 @@ var native_spec_default = {
           issuer: {
             deprecated: true,
             description: "Deprecated: always `null` outside Whop's own dashboard. Name of the bank that issued the card and filed the report.\nDEPRECATED: Always null outside Whop's own dashboard.",
+            example: null,
             type: ["string", "null"]
           },
           payment_id: {
@@ -90568,6 +90836,7 @@ var native_spec_default = {
           "payment_id",
           "product_id",
           "fee_charged",
+          "auto_refunded",
           "reported_at",
           "transaction_at",
           "created_at",
@@ -90941,6 +91210,7 @@ var native_spec_default = {
           payment_processor: {
             deprecated: true,
             description: "Deprecated: no longer populated. Always `null`.\nDEPRECATED: No longer populated. Always null.",
+            example: null,
             type: ["string", "null"]
           }
         },
@@ -90971,6 +91241,7 @@ var native_spec_default = {
           },
           certificate_status: {
             description: "Cloudflare's latest certificate issuance status.",
+            example: null,
             type: ["string", "null"]
           },
           created_at: {
@@ -90998,6 +91269,7 @@ var native_spec_default = {
           },
           hostname_status: {
             description: "Cloudflare's latest hostname activation status.",
+            example: null,
             type: ["string", "null"]
           },
           id: {
@@ -91014,6 +91286,7 @@ var native_spec_default = {
           },
           last_checked_at: {
             description: "When DNS and provider state were last checked, as an ISO 8601 timestamp.",
+            example: null,
             type: ["string", "null"]
           },
           metadata: {
@@ -91049,6 +91322,7 @@ var native_spec_default = {
           },
           verified_at: {
             description: "When Whop verified the ownership TXT record, as an ISO 8601 timestamp.",
+            example: null,
             type: ["string", "null"]
           }
         },
@@ -91124,6 +91398,7 @@ var native_spec_default = {
           },
           ai_chat_id: {
             description: "The chat to resume after its initial message is accepted, or null before a chat is ready.",
+            example: null,
             type: ["string", "null"]
           },
           created_at: {
@@ -91192,6 +91467,7 @@ var native_spec_default = {
           },
           user_feedback: {
             description: "The user's written feedback, or `null` if they have not provided any.",
+            example: null,
             type: ["string", "null"]
           }
         },
@@ -92874,6 +93150,7 @@ var native_spec_default = {
               },
               notes: {
                 description: "Memo attached to the transfer or payout source, or null when none was provided (on payout sources requires payout:withdrawal:read).",
+                example: null,
                 type: ["string", "null"]
               },
               object: {
@@ -93889,6 +94166,7 @@ var native_spec_default = {
           },
           whop_partner_verified_at: {
             description: "When the user became a verified Whop Partner, as an ISO 8601 timestamp. `null` if not verified.",
+            example: null,
             type: ["string", "null"]
           }
         },
@@ -93975,6 +94253,7 @@ var native_spec_default = {
           },
           code: {
             description: "Unique referral code, when assigned.",
+            example: null,
             type: ["string", "null"]
           },
           created_at: {
@@ -93989,6 +94268,7 @@ var native_spec_default = {
           },
           max_redemptions: {
             description: "Maximum permitted redemptions, when limited.",
+            example: null,
             type: ["integer", "null"]
           },
           partner: {
@@ -94152,6 +94432,7 @@ var native_spec_default = {
           },
           checkout_configuration_id: {
             description: "The checkout configuration the buyer paid through, prefixed `ch_`, or null.",
+            example: null,
             type: ["string", "null"]
           },
           client_secret: {
@@ -94191,14 +94472,17 @@ var native_spec_default = {
           },
           dispute_alerted_at: {
             description: "When an issuer warned that this payment will be disputed, or null.",
+            example: null,
             type: ["string", "null"]
           },
           failure_message: {
             description: "Why the most recent attempt failed, in plain words, or null.",
+            example: null,
             type: ["string", "null"]
           },
           financing_installments_count: {
             description: "For installment methods, how many payments the charge splits into.",
+            example: null,
             type: ["number", "null"]
           },
           holds: {
@@ -94215,6 +94499,7 @@ var native_spec_default = {
           },
           last_payment_attempt_at: {
             description: "When the most recent charge attempt ran, or null.",
+            example: null,
             type: ["string", "null"]
           },
           line_items: {
@@ -94248,6 +94533,7 @@ var native_spec_default = {
           },
           next_payment_attempt_at: {
             description: "When the next automatic retry is scheduled, or null.",
+            example: null,
             type: ["string", "null"]
           },
           paid_at: {
@@ -94317,10 +94603,12 @@ var native_spec_default = {
           },
           promo_code_id: {
             description: "The promo code applied at checkout, prefixed `promo_`, or null.",
+            example: null,
             type: ["string", "null"]
           },
           recovery_url: {
             description: "Whop-hosted URL where the buyer can sign in and complete 3D Secure for an off-session charge the bank challenged \u2014 a subscription renewal or a saved-card payment. Null when recovery is unavailable, you lack `member:basic:read`, or in list responses. Retrieve the payment for it.",
+            example: null,
             type: ["string", "null"]
           },
           refundable: {
@@ -94341,6 +94629,7 @@ var native_spec_default = {
           },
           refunded_at: {
             description: "When the payment was refunded, or null.",
+            example: null,
             type: ["string", "null"]
           },
           retryable: {
@@ -94350,19 +94639,23 @@ var native_spec_default = {
           },
           risk_score: {
             description: "Whop's published risk index from 0 (lowest) to 100 (highest), including enforced decision floors. This is not a fraud probability. Null when no score is available.",
+            example: null,
             type: ["number", "null"]
           },
           risk_signals: {
             deprecated: true,
             description: "Deprecated. Risk score explanations are no longer provided; always null.\nDEPRECATED: Risk score explanations are no longer provided. Always null.",
+            example: null,
             type: ["object", "null"]
           },
           settlement_time_at: {
             description: "When the portion not listed in `holds` posts to the account's available balance, at midnight UTC. The `financial_activity.funds_available` webhook's `posted_at` carries the same value when the settlement that clears it posts. Null until the payment is paid, and always null in list responses \u2014 retrieve the payment for it.",
+            example: null,
             type: ["string", "null"]
           },
           shipment_id: {
             description: "The shipment fulfilling this payment, prefixed `ship_`. Null when nothing ships or without the shipment:basic:read permission.",
+            example: null,
             type: ["string", "null"]
           },
           shipping_address: {
@@ -94839,6 +95132,7 @@ var native_spec_default = {
           },
           description: {
             description: "A longer explanation of the fee, when there is one.",
+            example: null,
             type: ["string", "null"]
           },
           label: {
@@ -94990,6 +95284,7 @@ var native_spec_default = {
           },
           installment_count: {
             description: "Installment methods only: how many payments the charge splits into. Data, not copy \u2014 compose and translate the label client-side.",
+            example: null,
             type: ["number", "null"]
           },
           payment_method_type: {
@@ -95683,6 +95978,7 @@ var native_spec_default = {
           },
           deleted_at: {
             description: "When the rule was deleted, as an ISO 8601 timestamp. `null` unless `status` is `deleted`.",
+            example: null,
             type: ["string", "null"]
           },
           id: {
@@ -95920,6 +96216,7 @@ var native_spec_default = {
           },
           auto_capture_at: {
             description: "When Whop will capture this authorization automatically, as an ISO 8601 timestamp. `null` when no automatic capture was requested.",
+            example: null,
             type: ["string", "null"]
           },
           capture_expires_at: {
@@ -96132,6 +96429,7 @@ var native_spec_default = {
           },
           category: {
             description: "The category the action is grouped under, or `null` when uncategorized.",
+            example: null,
             type: ["string", "null"]
           },
           description: {
@@ -97934,6 +98232,7 @@ var native_spec_default = {
           },
           expiration_days: {
             description: "Access duration in days for expiration-based plans. `null` for plans without an expiration.",
+            example: null,
             type: ["number", "null"]
           },
           id: {
@@ -97957,6 +98256,7 @@ var native_spec_default = {
           },
           title: {
             description: "Plan display name shown to customers. `null` if no title has been set.",
+            example: null,
             type: ["string", "null"]
           },
           unlimited_stock: {
@@ -98713,6 +99013,7 @@ var native_spec_default = {
               "fraudulent",
               "requested_by_customer",
               "expired_uncaptured_charge",
+              "dispute_alert",
               null
             ],
             example: "duplicate",
@@ -98737,6 +99038,7 @@ var native_spec_default = {
           },
           reference_value: {
             description: "The tracking reference the buyer's bank can trace the refund by.",
+            example: null,
             type: ["string", "null"]
           },
           status: {
@@ -99110,6 +99412,7 @@ var native_spec_default = {
           },
           checkout_configuration_id: {
             description: "The checkout configuration this setup was created through, prefixed `ch_`. Null for a setup created through this API rather than a hosted checkout.",
+            example: null,
             type: ["string", "null"]
           },
           client_secret: {
@@ -100647,6 +100950,7 @@ var native_spec_default = {
           },
           price_usd: {
             description: "USD price per native currency unit, or `null` when no exchange rate is available.",
+            example: null,
             type: ["number", "null"]
           },
           reserve_balance_usd: {
@@ -101131,6 +101435,7 @@ var native_spec_default = {
           },
           buyer_account_id: {
             description: "The account the signup was submitted on behalf of, prefixed `biz_`, or `null` when the user signed up for themselves.",
+            example: null,
             type: ["string", "null"]
           },
           created_at: {
@@ -101152,6 +101457,7 @@ var native_spec_default = {
           },
           membership_id: {
             description: "The membership created for this signup, prefixed `mem_`, or `null` when there is none. Check the membership's status to determine access.",
+            example: null,
             type: ["string", "null"]
           },
           metadata: {
@@ -102047,6 +102353,7 @@ var apps_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -103400,6 +103707,7 @@ var apps_spec_default = {
           },
           base_url: {
             description: "The production base URL where the app is hosted. `null` if no base URL is configured, if the caller lacks the `developer:basic:read` permission on the app's account, or on list responses, which never expose it.",
+            example: null,
             type: ["string", "null"]
           },
           businesses_created_count: {
@@ -103440,6 +103748,7 @@ var apps_spec_default = {
             type: "string"
           },
           domains: {
+            example: null,
             items: {
               $ref: "#/components/schemas/AppDomain",
               description: "Custom domain claims and assignments for this app, excluding removed domains. Empty when none exist; `null` when the caller lacks the account's `developer:basic:read` permission."
@@ -103647,6 +103956,7 @@ var apps_spec_default = {
             type: "string"
           },
           domains: {
+            example: null,
             items: {
               $ref: "#/components/schemas/AppDomain",
               description: "Custom domain claims and assignments for this app, excluding removed domains. Empty when none exist; `null` when the caller lacks the account's `developer:basic:read` permission."
@@ -104098,6 +104408,7 @@ var apps_spec_default = {
           },
           build_id: {
             description: "The build the deployment produced, prefixed `abld_`, or `null` until it succeeds.",
+            example: null,
             type: ["string", "null"]
           },
           draft: {
@@ -104107,6 +104418,7 @@ var apps_spec_default = {
           },
           error: {
             description: "Why the deployment failed, or `null` when it did not.",
+            example: null,
             type: ["string", "null"]
           },
           estimated_duration_ms: {
@@ -104121,6 +104433,7 @@ var apps_spec_default = {
           },
           finished_at: {
             description: "When the deployment ended, in milliseconds since the epoch, or `null` while it is still running.",
+            example: null,
             type: ["integer", "null"]
           },
           phase: {
@@ -104163,6 +104476,7 @@ var apps_spec_default = {
           },
           url: {
             description: "Where the deployed site is served, or `null` unless the deployment went live.",
+            example: null,
             type: ["string", "null"]
           }
         },
@@ -104437,6 +104751,7 @@ var files_spec_default = {
                     page_info: {
                       properties: {
                         end_cursor: {
+                          example: null,
                           type: ["string", "null"]
                         },
                         has_next_page: {
@@ -105019,7 +105334,7 @@ async function announceActionUrl(url, {
 // package.json
 var package_default = {
   name: "@whop/cli",
-  version: "0.19.0",
+  version: "0.20.0",
   description: "The Whop CLI \u2014 build and manage Whop apps from your terminal. Human and agent friendly.",
   keywords: [
     "agent",
@@ -106954,6 +107269,167 @@ function buildFeedbackCommand(kind) {
   };
 }
 
+// src/files/upload.ts
+import { closeSync, openSync, readFileSync as readFileSync7, readSync, statSync } from "fs";
+import { basename as basename2, resolve as resolve4 } from "path";
+
+// src/journey/client.ts
+var PLACEHOLDER = "https://api.whop.com";
+var proxyFetch = createWhopFetch();
+async function makeWhopRequest(method, path9, body, accessToken) {
+  const init = { method };
+  if (body !== void 0) init.body = JSON.stringify(body);
+  const res = accessToken ? await whopApiFetch(
+    `${apiBaseUrl().replace(/\/$/, "")}${path9}`,
+    accessToken,
+    {
+      ...init,
+      headers: body !== void 0 ? { "Content-Type": "application/json" } : {}
+    }
+  ) : await proxyFetch(new Request(`${PLACEHOLDER}${path9}`, init));
+  if (!res.ok) throw await responseError(res);
+  const text4 = await res.text();
+  return text4 ? JSON.parse(text4) : { success: true };
+}
+
+// src/files/upload.ts
+var MULTIPART_THRESHOLD = 100 * 1024 * 1024;
+var defaultDependencies = {
+  request: makeWhopRequest,
+  put: (url, init) => fetch(url, init),
+  sleep: (milliseconds) => new Promise((done) => setTimeout(done, milliseconds)),
+  readyTimeoutMs: 12e4,
+  multipartThreshold: MULTIPART_THRESHOLD
+};
+async function uploadLocalFile(input, dependencies = defaultDependencies) {
+  const path9 = resolve4(input.filepath);
+  const stats = statSync(path9, { throwIfNoEntry: false });
+  if (!stats?.isFile()) throw new Error(`No file at ${input.filepath}.`);
+  if (stats.size === 0) throw new Error(`${input.filepath} is empty.`);
+  const multipart = stats.size > dependencies.multipartThreshold;
+  const file = await dependencies.request("POST", "/files", {
+    filename: input.filename ?? basename2(path9),
+    ...input.visibility ? { visibility: input.visibility } : {},
+    ...multipart ? { multipart: true, byte_size: stats.size } : {}
+  });
+  if (multipart) await uploadParts(path9, stats.size, file, dependencies);
+  else await uploadWhole(path9, file, dependencies);
+  return waitUntilReady(file.id, dependencies);
+}
+async function uploadWhole(path9, file, dependencies) {
+  if (!file.upload_url)
+    throw new Error(`Whop created ${file.id} without an upload URL.`);
+  const response = await dependencies.put(file.upload_url, {
+    method: "PUT",
+    headers: file.upload_headers ?? {},
+    body: new Uint8Array(readFileSync7(path9))
+  });
+  if (!response.ok)
+    throw new Error(
+      `Uploading ${file.id} failed: ${response.status} ${await response.text()}`
+    );
+}
+async function uploadParts(path9, size, file, dependencies) {
+  const {
+    multipart_upload_id: uploadID,
+    multipart_chunk_size: chunkSize,
+    multipart_upload_urls: urls
+  } = file;
+  if (!uploadID || !chunkSize || !urls?.length)
+    throw new Error(`Whop created ${file.id} without multipart upload URLs.`);
+  const descriptor2 = openSync(path9, "r");
+  const parts = [];
+  try {
+    for (const part of [...urls].sort(
+      (a, b) => a.part_number - b.part_number
+    )) {
+      const offset = (part.part_number - 1) * chunkSize;
+      const chunk = Buffer.alloc(Math.min(chunkSize, size - offset));
+      readSync(descriptor2, chunk, 0, chunk.length, offset);
+      const response = await dependencies.put(part.url, {
+        method: "PUT",
+        body: new Uint8Array(chunk)
+      });
+      const etag = response.headers.get("ETag");
+      if (!response.ok || !etag)
+        throw new Error(
+          `Uploading part ${part.part_number} of ${file.id} failed: ${response.status}`
+        );
+      parts.push({ part_number: part.part_number, etag });
+    }
+  } finally {
+    closeSync(descriptor2);
+  }
+  await dependencies.request("POST", `/files/${file.id}/complete`, {
+    multipart_upload_id: uploadID,
+    multipart_parts: parts
+  });
+}
+async function waitUntilReady(id, dependencies) {
+  const deadline = Date.now() + dependencies.readyTimeoutMs;
+  while (true) {
+    const file = await dependencies.request("GET", `/files/${id}`);
+    if (file.upload_status === "ready") return file;
+    if (file.upload_status === "failed")
+      throw new Error(`Whop could not process ${id}.`);
+    if (Date.now() >= deadline)
+      throw new Error(
+        `${id} was uploaded but is still ${file.upload_status ?? "processing"}. Check it with \`whop files get ${id}\`.`
+      );
+    await dependencies.sleep(1e3);
+  }
+}
+
+// src/files/commands.ts
+async function buildFilesGroup(description) {
+  const files = Cli_exports.create("files", { description });
+  const spec2 = filterSpecByTag(native_spec_default, "Files");
+  const generated = await Openapi_exports.generateCommands(
+    spec2,
+    createWhopFetch(),
+    {
+      config: { security: false }
+    }
+  );
+  for (const [name, entry] of generated) {
+    if (!("run" in entry)) continue;
+    files.command(name, name === "create" ? withLocalUpload(entry) : entry);
+  }
+  return files;
+}
+function withLocalUpload(entry) {
+  const options = (entry.options ?? external_exports.object({})).partial({ filename: true }).extend({
+    filepath: external_exports.string().optional().describe(
+      "Path to a local file to upload. Creates the file, uploads its bytes, and returns it once ready. --filename defaults to the file's name."
+    )
+  });
+  return {
+    ...entry,
+    description: "Upload a local file with --filepath, or create a file record and upload its bytes yourself",
+    options,
+    examples: [
+      {
+        options: { filepath: "./ad.mp4", visibility: "public" },
+        description: "Upload a local file and wait until it is ready"
+      }
+    ],
+    run: (context) => {
+      const { filepath, ...rest } = context.options;
+      if (filepath)
+        return uploadLocalFile({
+          filepath,
+          filename: rest.filename,
+          visibility: rest.visibility
+        });
+      if (!rest.filename)
+        throw new Error(
+          "Pass --filepath to upload a local file, or --filename to create a file record."
+        );
+      return entry.run({ ...context, options: rest });
+    }
+  };
+}
+
 // src/api/groups.json
 var groups_default = [
   {
@@ -107291,30 +107767,11 @@ var API_GROUPS = groups_default.filter(
 // src/apps/commands.ts
 import { spinner as spinner4 } from "@clack/prompts";
 import { createHash as createHash3 } from "crypto";
-import { existsSync as existsSync12, mkdtempSync as mkdtempSync3, readFileSync as readFileSync11, rmSync as rmSync4 } from "fs";
+import { existsSync as existsSync12, mkdtempSync as mkdtempSync3, readFileSync as readFileSync12, rmSync as rmSync4 } from "fs";
 import { tmpdir as tmpdir3 } from "os";
-import { join as join12, relative as relative3, resolve as resolve8 } from "path";
+import { join as join12, relative as relative3, resolve as resolve9 } from "path";
 import chalk2 from "chalk";
 
-// src/journey/client.ts
-var PLACEHOLDER = "https://api.whop.com";
-var proxyFetch = createWhopFetch();
-async function makeWhopRequest(method, path9, body, accessToken) {
-  const init = { method };
-  if (body !== void 0) init.body = JSON.stringify(body);
-  const res = accessToken ? await whopApiFetch(
-    `${apiBaseUrl().replace(/\/$/, "")}${path9}`,
-    accessToken,
-    {
-      ...init,
-      headers: body !== void 0 ? { "Content-Type": "application/json" } : {}
-    }
-  ) : await proxyFetch(new Request(`${PLACEHOLDER}${path9}`, init));
-  if (!res.ok) throw await responseError(res);
-  const text4 = await res.text();
-  return text4 ? JSON.parse(text4) : { success: true };
-}
-
 // src/apps/api.ts
 async function createApp(input) {
   const company_id = input.company_id ?? await resolveActiveAccountId();
@@ -107411,18 +107868,18 @@ async function waitForBuildPromotion(buildId, timeoutMs = 3e4) {
   return latest;
 }
 function sleep(ms) {
-  return new Promise((resolve9) => setTimeout(resolve9, ms));
+  return new Promise((resolve10) => setTimeout(resolve10, ms));
 }
 
 // src/apps/config.ts
-import { existsSync as existsSync8, readFileSync as readFileSync7, writeFileSync as writeFileSync6 } from "fs";
-import { join as join6, resolve as resolve4 } from "path";
+import { existsSync as existsSync8, readFileSync as readFileSync8, writeFileSync as writeFileSync6 } from "fs";
+import { join as join6, resolve as resolve5 } from "path";
 var APP_CONFIG_FILENAME = "whop.app.json";
 function findProjectDir(startDir) {
-  let dir = resolve4(startDir ?? process.cwd());
+  let dir = resolve5(startDir ?? process.cwd());
   for (let i = 0; i < 25; i++) {
     if (existsSync8(join6(dir, APP_CONFIG_FILENAME))) return dir;
-    const parent = resolve4(dir, "..");
+    const parent = resolve5(dir, "..");
     if (parent === dir) break;
     dir = parent;
   }
@@ -107433,7 +107890,7 @@ function readAppConfig(projectDir) {
   if (!existsSync8(path9)) return null;
   try {
     const parsed = JSON.parse(
-      readFileSync7(path9, "utf-8")
+      readFileSync8(path9, "utf-8")
     );
     if (typeof parsed.app_id === "string" && typeof parsed.name === "string" && typeof parsed.route === "string") {
       return { app_id: parsed.app_id, name: parsed.name, route: parsed.route };
@@ -107608,7 +108065,7 @@ function stashPop(dir) {
 // src/apps/init.ts
 import { spinner as spinner3 } from "@clack/prompts";
 import { existsSync as existsSync11, readdirSync as readdirSync3 } from "fs";
-import { resolve as resolve6 } from "path";
+import { resolve as resolve7 } from "path";
 import chalk from "chalk";
 
 // src/apps/source-archive.ts
@@ -107616,11 +108073,11 @@ import { spawnSync as spawnSync2 } from "child_process";
 import {
   mkdirSync as mkdirSync7,
   readdirSync as readdirSync2,
-  readFileSync as readFileSync8,
-  statSync,
+  readFileSync as readFileSync9,
+  statSync as statSync2,
   writeFileSync as writeFileSync7
 } from "fs";
-import { dirname as dirname8, join as join8, resolve as resolve5, sep as sep2 } from "path";
+import { dirname as dirname8, join as join8, resolve as resolve6, sep as sep2 } from "path";
 
 // ../../node_modules/.pnpm/fflate@0.8.2/node_modules/fflate/esm/index.mjs
 import { createRequire as createRequire3 } from "module";
@@ -108623,7 +109080,7 @@ function listGitFiles(projectDir) {
   return [...new Set(listed.stdout.split("\0").filter(Boolean))].filter(
     (path9) => {
       try {
-        return statSync(join8(projectDir, path9)).isFile();
+        return statSync2(join8(projectDir, path9)).isFile();
       } catch {
         return false;
       }
@@ -108654,7 +109111,7 @@ function packSourceArchive(projectDir) {
   }
   const contents = {};
   for (const path9 of paths) {
-    contents[path9] = readFileSync8(join8(projectDir, path9));
+    contents[path9] = readFileSync9(join8(projectDir, path9));
   }
   return {
     zip: zipSync(contents, { level: 9, mem: 12 }),
@@ -108663,11 +109120,11 @@ function packSourceArchive(projectDir) {
   };
 }
 function extractSourceArchive(zip, targetDir) {
-  const root = resolve5(targetDir);
+  const root = resolve6(targetDir);
   let count = 0;
   for (const [name, data] of Object.entries(unzipSync(zip))) {
     if (name.endsWith("/")) continue;
-    const dest = resolve5(root, name);
+    const dest = resolve6(root, name);
     if (!dest.startsWith(root + sep2)) {
       throw new Error(`Archive entry escapes the target directory: ${name}`);
     }
@@ -108680,8 +109137,8 @@ function extractSourceArchive(zip, targetDir) {
 
 // src/apps/scaffold.ts
 import { spawnSync as spawnSync3 } from "child_process";
-import { existsSync as existsSync9, readFileSync as readFileSync9, writeFileSync as writeFileSync8 } from "fs";
-import { basename as basename2, join as join9 } from "path";
+import { existsSync as existsSync9, readFileSync as readFileSync10, writeFileSync as writeFileSync8 } from "fs";
+import { basename as basename3, join as join9 } from "path";
 var SPAWN_VIA_SHELL2 = process.platform === "win32";
 var DLX_RUNNERS = {
   npm: ["npx", "-y"],
@@ -108786,7 +109243,7 @@ function patchPackageJson(dir, manualSteps) {
   let raw;
   let pkg;
   try {
-    raw = readFileSync9(file, "utf-8");
+    raw = readFileSync10(file, "utf-8");
     pkg = JSON.parse(raw);
   } catch {
     manualSteps.push(
@@ -108823,13 +109280,13 @@ function patchViteConfig(dir, manualSteps) {
     );
     return;
   }
-  let content = readFileSync9(file, "utf-8");
+  let content = readFileSync10(file, "utf-8");
   const hasWhopPlugin = content.includes("@whop/cli/vite");
   if (!hasWhopPlugin) {
     const pluginsOpen = /plugins:\s*\[/;
     if (!pluginsOpen.test(content)) {
       manualSteps.push(
-        `Could not find a \`plugins: [...]\` array in ${basename2(file)}. Add \`import { whop } from '@whop/cli/vite'\` and include \`whop()\` in the config's plugins so builds pack dist/whop-build.zip.`
+        `Could not find a \`plugins: [...]\` array in ${basename3(file)}. Add \`import { whop } from '@whop/cli/vite'\` and include \`whop()\` in the config's plugins so builds pack dist/whop-build.zip.`
       );
     } else {
       content = `import { whop } from '@whop/cli/vite'
@@ -108844,7 +109301,7 @@ ${content}`;
   }
   if (!content.includes("@cloudflare/vite-plugin")) {
     manualSteps.push(
-      `${basename2(file)} does not use @cloudflare/vite-plugin. Whop hosting runs builds on Cloudflare Workers: install @cloudflare/vite-plugin and wrangler, add \`cloudflare({ viteEnvironment: { name: 'ssr' } })\` to the plugins array (before your framework plugin), and make sure \`vite build\` emits dist/client (static assets) and dist/server (worker modules with an index.js entry).`
+      `${basename3(file)} does not use @cloudflare/vite-plugin. Whop hosting runs builds on Cloudflare Workers: install @cloudflare/vite-plugin and wrangler, add \`cloudflare({ viteEnvironment: { name: 'ssr' } })\` to the plugins array (before your framework plugin), and make sure \`vite build\` emits dist/client (static assets) and dist/server (worker modules with an index.js entry).`
     );
   }
 }
@@ -108858,13 +109315,13 @@ function patchWranglerConfig(dir, route, manualSteps) {
     );
     return;
   }
-  const content = readFileSync9(file, "utf-8");
+  const content = readFileSync10(file, "utf-8");
   const updated = replaceTopLevelName(content, route);
   if (updated) {
     writeIfChanged(file, updated, content);
   } else {
     manualSteps.push(
-      `Set the top-level "name" in ${basename2(file)} to "${route}" so the worker is named after the app's route.`
+      `Set the top-level "name" in ${basename3(file)} to "${route}" so the worker is named after the app's route.`
     );
   }
 }
@@ -108910,7 +109367,7 @@ function replaceTopLevelName(content, route) {
 // src/apps/shared.ts
 import { isCancel as isCancel4, select as select3, spinner as spinner2, text as text2 } from "@clack/prompts";
 import { spawnSync as spawnSync4 } from "child_process";
-import { existsSync as existsSync10, readFileSync as readFileSync10 } from "fs";
+import { existsSync as existsSync10, readFileSync as readFileSync11 } from "fs";
 import { join as join10 } from "path";
 var CommandAbort = class extends Error {
   constructor(options) {
@@ -108995,7 +109452,7 @@ function detectProjectPackageManager(projectDir) {
 function hasScript(projectDir, script) {
   try {
     const pkg = JSON.parse(
-      readFileSync10(join10(projectDir, "package.json"), "utf-8")
+      readFileSync11(join10(projectDir, "package.json"), "utf-8")
     );
     return Boolean(pkg.scripts?.[script]);
   } catch {
@@ -109187,7 +109644,7 @@ async function runInitFlow(c2, options, pm = ensurePackageManager()) {
     options,
     templateAppType
   );
-  const targetDir = resolve6(options.dir ?? `./${route}`);
+  const targetDir = resolve7(options.dir ?? `./${route}`);
   ensureEmptyTarget(targetDir);
   let app;
   try {
@@ -109277,7 +109734,7 @@ function initGitRepo(c2, targetDir) {
 // src/apps/pull.ts
 import { mkdtempSync as mkdtempSync2, mkdirSync as mkdirSync8, rmSync as rmSync3 } from "fs";
 import { tmpdir as tmpdir2 } from "os";
-import { join as join11, resolve as resolve7 } from "path";
+import { join as join11, resolve as resolve8 } from "path";
 var pullOptions = external_exports.object({
   app: external_exports.string().optional().describe("App id (defaults to the project's linked app)"),
   build: external_exports.string().optional().describe(
@@ -109380,7 +109837,7 @@ async function loadApp(appId) {
   }
 }
 function resolveTargetDir(options, app) {
-  if (options.dir) return resolve7(options.dir);
+  if (options.dir) return resolve8(options.dir);
   const projectDir = findProjectDir();
   if (projectDir && readAppConfig(projectDir)?.app_id === app.id) {
     return projectDir;
@@ -109393,7 +109850,7 @@ function resolveTargetDir(options, app) {
       retryable: true
     });
   }
-  return resolve7(`./${route}`);
+  return resolve8(`./${route}`);
 }
 function ensureUsableRepo(targetDir) {
   const status = repoStatus(targetDir);
@@ -109559,7 +110016,7 @@ async function registerSpecCommands(group, tag) {
   }
 }
 async function resolveDeployProject(c2, dirOption) {
-  const projectDir = dirOption ? resolve8(dirOption) : findProjectDir() ?? process.cwd();
+  const projectDir = dirOption ? resolve9(dirOption) : findProjectDir() ?? process.cwd();
   const isViteApp = existsSync12(join12(projectDir, "package.json")) && findViteConfig(projectDir) !== void 0;
   if (isViteApp) return { projectDir, freshInit: null };
   if (c2.agent) {
@@ -109993,7 +110450,7 @@ async function buildAppGroup() {
       )
     }),
     run: async (c2) => {
-      const projectDir = c2.options.dir ? resolve8(c2.options.dir) : findProjectDir();
+      const projectDir = c2.options.dir ? resolve9(c2.options.dir) : findProjectDir();
       const config = projectDir ? readAppConfig(projectDir) : null;
       if (!projectDir || !config) {
         return c2.error({
@@ -110169,7 +110626,7 @@ Then re-run \`whop apps deploy\` \u2014 it re-checks the wiring and applies anyt
             message: `No build archive at ${BUILD_ARCHIVE}. Add the whop() plugin from @whop/cli/vite to your vite config, then build. See https://whop.com/docs/apps/hosting.`
           });
         }
-        const zip = readFileSync11(archivePath);
+        const zip = readFileSync12(archivePath);
         const sizeMb = (zip.byteLength / 1024 / 1024).toFixed(1);
         const checksum = createHash3("sha256").update(zip).digest("hex");
         const sourceArchive = packSourceArchive(projectDir);
@@ -111222,7 +111679,7 @@ async function fetchAsset(c2, getEntry, id, progress) {
   }
 }
 function sleep2(ms) {
-  return new Promise((resolve9) => setTimeout(resolve9, ms));
+  return new Promise((resolve10) => setTimeout(resolve10, ms));
 }
 
 // src/journey/quickstart.ts
@@ -111261,7 +111718,7 @@ var quickstartOutput = external_exports.object({
   ),
   created: external_exports.boolean().describe("Whether this run created the selected business account")
 });
-var defaultDependencies = {
+var defaultDependencies2 = {
   getActiveProfile,
   getActiveProfileForRequest,
   getValidAccessToken,
@@ -111288,7 +111745,7 @@ var defaultDependencies = {
   promptBusinessName,
   startSpinner
 };
-async function runQuickstart(ctx, dependencies = defaultDependencies) {
+async function runQuickstart(ctx, dependencies = defaultDependencies2) {
   const profile = dependencies.getActiveProfileForRequest();
   if (ctx.options.account_id && ctx.options.business_name !== void 0) {
     return ctx.error({
@@ -112423,12 +112880,6 @@ cli.command("quickstart", {
 cli.command("report-feedback", buildFeedbackCommand("report_feedback"));
 cli.command("ask-question", buildFeedbackCommand("ask_question"));
 cli.command(await buildAppGroup());
-cli.command("files", {
-  description: "Create file uploads and retrieve uploaded file details.",
-  fetch: fetch2,
-  openapi: filterSpecByTag(files_spec_default, "Files"),
-  openapiConfig: { security: false }
-});
 cli.command("upgrade", {
   description: "Update the whop CLI to the latest version",
   options: upgradeOptions,
@@ -112463,6 +112914,10 @@ for (const { name, tag, description } of API_GROUPS) {
     cli.command(await buildMediaGroup(description));
     continue;
   }
+  if (name === "files") {
+    cli.command(await buildFilesGroup(description));
+    continue;
+  }
   cli.command(name, {
     description,
     fetch: fetch2,