@whop/cli 0.17.0 → 0.18.0

package/README.md

@@ -73,6 +73,8 @@ whop ask-question --content "How do trials interact with an existing subscriptio
 
 Both commands submit one observation for Whop's internal review and return a receipt. `ask-question` records an unanswered question; it does not return an answer or start a support conversation. Use a user credential from `whop login` (browser OAuth). Remove secrets, personal data, and payment details from `--content`.
 
+Use `--account_id biz_...` to identify the account for an affected resource. Both commands default to your active account when available. Account context is optional.
+
 ## Ship apps
 
 Hosted web apps (`*.whop.site`) follow a git-shaped lifecycle. Two on-ramps, one loop:
@@ -120,6 +122,14 @@ whop checkout-configurations create --help          # shareable, prefilled check
 whop stats list                                     # financial, audience, and traffic reporting
 ```
 
+Set product gallery images or videos with uploaded file IDs:
+
+```bash
+whop products update prod_xxxxxxxx --gallery_images '[{"id":"file_xxxxxxxx"}]'
+```
+
+`products create` accepts the same option. The array replaces the gallery in display order; include every file you want to keep. Pass `'[]'` to clear it. `banner_image` is separate and does not satisfy the marketplace gallery requirement.
+
 Money moves through the same surface: payouts, transfers, deposits, swaps, and cards. Payouts and card issuing require identity verification (`whop verifications`). Steps that need a browser, like KYC, show up as a link to open.
 
 ## Serve the customers you have

package/dist/index.js

@@ -33084,6 +33084,7 @@ var native_spec_default = {
             schema: {
               items: {
                 enum: [
+                  "account_settlement",
                   "ad_budget_release",
                   "ad_campaign_budget",
                   "ad_publisher_payout",
@@ -33511,6 +33512,7 @@ var native_spec_default = {
             schema: {
               items: {
                 enum: [
+                  "account_settlement",
                   "ad_budget_release",
                   "ad_campaign_budget",
                   "ad_publisher_payout",
@@ -41785,6 +41787,7 @@ var native_spec_default = {
                                 "kyc_completed",
                                 "rmi_clear",
                                 "identity_rfi_clear",
+                                "guardian_id_clear",
                                 "ecommerce_fulfillment_connected",
                                 "block_move_money_out",
                                 "block_move_money_out_set_by_parent",
@@ -46765,6 +46768,26 @@ var native_spec_default = {
                     example: "Full interior extraction, leather conditioning, and an ozone odor treatment.",
                     type: ["string", "null"]
                   },
+                  gallery_images: {
+                    description: "Images or videos displayed in the product gallery, in display order. Replaces the existing gallery. Send an empty array to clear it; omit or pass null to leave it unchanged. A banner image does not populate the gallery.",
+                    items: {
+                      properties: {
+                        direct_upload_id: {
+                          description: "The signed ID of a completed direct upload, as an alternative to id.",
+                          example: "eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+                          type: "string"
+                        },
+                        id: {
+                          description: "The tag of an already-uploaded attachment.",
+                          example: "file_xxxxxxxxxxxxxx",
+                          type: "string"
+                        }
+                      },
+                      type: "object"
+                    },
+                    maxItems: 8,
+                    type: ["array", "null"]
+                  },
                   global_affiliate_percentage: {
                     description: "The commission rate affiliates earn.",
                     example: 10,
@@ -47046,6 +47069,26 @@ var native_spec_default = {
                     example: "Full interior extraction, leather conditioning, and an ozone odor treatment.",
                     type: ["string", "null"]
                   },
+                  gallery_images: {
+                    description: "Images or videos displayed in the product gallery, in display order. Replaces the existing gallery. Send an empty array to clear it; omit or pass null to leave it unchanged. A banner image does not populate the gallery.",
+                    items: {
+                      properties: {
+                        direct_upload_id: {
+                          description: "The signed ID of a completed direct upload, as an alternative to id.",
+                          example: "eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+                          type: "string"
+                        },
+                        id: {
+                          description: "The tag of an already-uploaded attachment.",
+                          example: "file_xxxxxxxxxxxxxx",
+                          type: "string"
+                        }
+                      },
+                      type: "object"
+                    },
+                    maxItems: 8,
+                    type: ["array", "null"]
+                  },
                   headline: {
                     description: "A short marketing headline for the product page.",
                     example: "Steam, shampoo, and odor removal in one visit",
@@ -57639,6 +57682,7 @@ var native_spec_default = {
                         "ledger_account.funds_available",
                         "swap.completed",
                         "deposit.succeeded",
+                        "financial_activity.funds_available",
                         "transfer.created",
                         "transfer.completed",
                         "transfer.failed",
@@ -58011,6 +58055,7 @@ var native_spec_default = {
                         "ledger_account.funds_available",
                         "swap.completed",
                         "deposit.succeeded",
+                        "financial_activity.funds_available",
                         "transfer.created",
                         "transfer.completed",
                         "transfer.failed",
@@ -63878,6 +63923,143 @@ var native_spec_default = {
         tags: ["Exports"]
       }
     },
+    "financial_activity.funds_available": {
+      post: {
+        description: "Sent when a settlement moves one release date's pending funds into the account's available balance \u2014 one event per release date that cleared, carrying that settlement's ledger line. Its posted_at is the release date at midnight UTC, the same value as settlement_time_at on every payment it clears\n\nRequired permissions:\n - `webhook_receive:financial_activity`",
+        parameters: [
+          {
+            in: "header",
+            name: "webhook-id",
+            required: true,
+            schema: {
+              description: "A unique identifier for this webhook request",
+              example: "msg_xxxxxxxxxxxxxxxxxxxxxxxx",
+              type: "string"
+            }
+          },
+          {
+            in: "header",
+            name: "webhook-signature",
+            required: true,
+            schema: {
+              description: "The signature of the webhook request with the webhook version prepended",
+              example: "v1,BASE64ENCODEDSIGNATURE",
+              type: "string"
+            }
+          },
+          {
+            in: "header",
+            name: "webhook-timestamp",
+            required: true,
+            schema: {
+              description: "The timestamp in seconds since the Unix epoch that the webhook was sent at on the server",
+              example: "1727606400",
+              type: "string"
+            }
+          }
+        ],
+        requestBody: {
+          content: {
+            "application/json": {
+              example: {
+                account_id: "biz_xxxxxxxxxxxxxx",
+                api_version: "v1",
+                api_version_date: "2026-09-11-1",
+                data: {
+                  amount: "512345000000",
+                  available_at: "2026-01-01T12:00:00.000Z",
+                  currency: {
+                    code: "usd",
+                    precision: "100000000"
+                  },
+                  id: "line_7",
+                  line_type: "account_settlement",
+                  object: "ledger_activity",
+                  posted_at: "2026-01-02T12:00:00.000Z",
+                  resource: null,
+                  source: {
+                    id: "wallet_release_date_settlement|ldgr_xxxxxxxxxxxxxx|2026-01-01|usd",
+                    object: "settlement",
+                    release_date: "2026-01-01",
+                    settled_at: "2026-01-01T12:00:00.000Z"
+                  },
+                  usd_amount: "5123.45"
+                },
+                id: "msg_xxxxxxxxxxxxxxxxxxxxxxxx",
+                timestamp: "2025-01-01T00:00:00.000Z",
+                type: "financial_activity.funds_available"
+              },
+              schema: {
+                properties: {
+                  account_id: {
+                    description: "The account ID that this webhook event is associated with",
+                    example: "biz_xxxxxxxxxxxxxx",
+                    type: ["string", "null"]
+                  },
+                  api_version: {
+                    const: "v1",
+                    description: "The API version for this webhook",
+                    example: "v1",
+                    type: "string"
+                  },
+                  api_version_date: {
+                    description: "The dated API version (Api-Version-Date) the payload is serialized to",
+                    example: "2026-07-20",
+                    type: ["string", "null"]
+                  },
+                  data: {
+                    $ref: "#/components/schemas/LedgerActivity"
+                  },
+                  id: {
+                    description: "A unique ID for every single webhook request",
+                    example: "msg_xxxxxxxxxxxxxxxxxxxxxxxx",
+                    type: "string"
+                  },
+                  previous_attributes: {
+                    description: "For some `.updated` events, the old values of the payload fields that changed, keyed by field name. Omitted when no capture is available for the event",
+                    type: "object"
+                  },
+                  timestamp: {
+                    description: "The timestamp in ISO 8601 format that the webhook was sent at on the server",
+                    example: "2025-01-01T00:00:00.000Z",
+                    format: "date-time",
+                    type: "string"
+                  },
+                  type: {
+                    const: "financial_activity.funds_available",
+                    description: "The webhook event type",
+                    example: "financial_activity.funds_available",
+                    type: "string"
+                  }
+                },
+                required: [
+                  "id",
+                  "api_version",
+                  "api_version_date",
+                  "timestamp",
+                  "type",
+                  "data"
+                ],
+                type: "object"
+              }
+            }
+          }
+        },
+        responses: {
+          "200": {
+            description: "Return a 200 status to indicate that the data was received successfully"
+          }
+        },
+        summary: "Financial Activity Funds available",
+        tags: ["Ledgers"],
+        "x-mint": {
+          metadata: {
+            title: "Financial Activity Funds Available",
+            sidebarTitle: "Financial Activity Funds Available"
+          }
+        }
+      }
+    },
     "identity_profile.updated": {
       post: {
         description: "Sent whenever an identity profile changes state \u2014 a verification is approved, needs action, or is rejected, or a Whop review opens or clears. Every other identity_profile event is also delivered as an identity_profile.updated, so you can subscribe to this single event and re-fetch the verification to read its current status.\n\nRequired permissions:\n - `identity:read`\n - `webhook_receive:identity_profiles`",
@@ -70318,6 +70500,7 @@ var native_spec_default = {
                     claim_url: "https://whop.com/claim",
                     created_at: "2026-01-01T12:00:00.000Z",
                     estimated_arrival: "2026-01-01T12:00:00.000Z",
+                    fee_kind: "swap",
                     from_amount: "502.51",
                     from_currency: "usdt",
                     id: "airdrp_xxxxxxxxxxxxxx",
@@ -79692,12 +79875,6 @@ var native_spec_default = {
             example: "2026-01-01T12:00:00.000Z",
             type: ["string", "null"]
           },
-          execution_type: {
-            description: "How the card runs. `whop_ai` means `prompt` is sent to Whop AI, which carries out every step.",
-            enum: ["whop_ai"],
-            example: "whop_ai",
-            type: "string"
-          },
           id: {
             description: "Economic intelligence ID, prefixed `reca_`",
             example: "reca_xxxxxxxxxxxxxx",
@@ -79745,7 +79922,6 @@ var native_spec_default = {
           "id",
           "account_id",
           "action_type",
-          "execution_type",
           "title",
           "prompt",
           "reasoning",
@@ -80437,6 +80613,7 @@ var native_spec_default = {
           line_type: {
             description: "The ledger line category this activity was posted under.",
             enum: [
+              "account_settlement",
               "ad_budget_release",
               "ad_campaign_budget",
               "ad_publisher_payout",
@@ -81162,7 +81339,7 @@ var native_spec_default = {
           },
           source: {
             additionalProperties: true,
-            description: "Source of this ledger activity.",
+            description: "Source of this ledger activity. Platform markup fees use object platform_fee and the ledger activity ID.",
             properties: {
               amount_float: {
                 description: "Payout amount as a decimal number in the destination currency (payout sources only; requires payout:withdrawal:read).",
@@ -81195,6 +81372,19 @@ var native_spec_default = {
                 format: "date-time",
                 type: ["string", "null"]
               },
+              fee_kind: {
+                description: "Action that generated a platform markup fee: deposit, swap, transfer, card_spend, or payout. Present for platform_markup_fee and platform_markup_fee_payout, including when include_resource is false. Null when the originating action is unavailable; omitted on other source types.",
+                enum: [
+                  "payout",
+                  "transfer",
+                  "deposit",
+                  "swap",
+                  "card_spend",
+                  null
+                ],
+                example: "swap",
+                type: ["string", "null"]
+              },
               from_amount: {
                 description: "Amount converted out of from_currency as a decimal string (swap sources only).",
                 example: "502.51",
@@ -82510,7 +82700,7 @@ var native_spec_default = {
             type: ["string", "null"]
           },
           recovery_url: {
-            description: "Whop-hosted URL where the buyer can sign in and complete 3D Secure for a failed subscription renewal. Null when recovery is unavailable, you lack `member:basic:read`, or in list responses. Retrieve the payment for it.",
+            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.",
             type: ["string", "null"]
           },
           refundable: {
@@ -82547,7 +82737,7 @@ var native_spec_default = {
             type: ["object", "null"]
           },
           settlement_time_at: {
-            description: "When the funds post to the account's available balance, at midnight UTC. The `ledger_account.funds_available` webhook carries the same value. Null until the payment is paid, and always null in list responses \u2014 retrieve the payment for it.",
+            description: "When the funds post 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.",
             type: ["string", "null"]
           },
           shipment_id: {
@@ -82809,10 +82999,14 @@ var native_spec_default = {
             type: "string"
           },
           bank_code: {
-            description: "The receiving bank's code in the local clearing system.",
+            description: "The code that identifies the receiving bank \u2014 its code in the local clearing system, or its SWIFT/BIC on a transfer that crosses borders.",
             example: "684",
             type: "string"
           },
+          bank_code_label: {
+            description: "What to call `bank_code` when showing it, in the scheme's own terms \u2014 `SWIFT / BIC` on an international wire, for example.",
+            type: "string"
+          },
           bank_name: {
             description: "The receiving bank's name.",
             example: "Frost Bank",
@@ -84260,6 +84454,7 @@ var native_spec_default = {
           "webhook_receive:ledger_accounts",
           "webhook_receive:accounts",
           "webhook_receive:deposits",
+          "webhook_receive:financial_activity",
           "webhook_receive:transfers",
           "webhook_receive:card_transactions",
           "webhook_receive:cards",
@@ -84525,6 +84720,7 @@ var native_spec_default = {
           "WebhookReceiveLedgerAccounts",
           "WebhookReceiveAccounts",
           "WebhookReceiveDeposits",
+          "WebhookReceiveFinancialActivity",
           "WebhookReceiveTransfers",
           "WebhookReceiveCardTransactions",
           "WebhookReceiveCards",
@@ -85601,7 +85797,7 @@ var native_spec_default = {
           },
           description: {
             description: "Written description displayed on the product page. `null` if none is set.",
-            example: "evolve back-end solutions",
+            example: "aggregate 24/7 ROI",
             type: ["string", "null"]
           },
           external_identifier: {
@@ -85618,7 +85814,7 @@ var native_spec_default = {
           },
           headline: {
             description: "Short marketing headline displayed on product page.",
-            example: "impact map",
+            example: "SWAG",
             type: ["string", "null"]
           },
           id: {
@@ -88371,6 +88567,7 @@ var native_spec_default = {
                 "ledger_account.funds_available",
                 "swap.completed",
                 "deposit.succeeded",
+                "financial_activity.funds_available",
                 "transfer.created",
                 "transfer.completed",
                 "transfer.failed",
@@ -88501,6 +88698,7 @@ var native_spec_default = {
                 "ledger_account.funds_available",
                 "swap.completed",
                 "deposit.succeeded",
+                "financial_activity.funds_available",
                 "transfer.created",
                 "transfer.completed",
                 "transfer.failed",
@@ -88761,6 +88959,7 @@ var native_spec_default = {
                 "ledger_account.funds_available",
                 "swap.completed",
                 "deposit.succeeded",
+                "financial_activity.funds_available",
                 "transfer.created",
                 "transfer.completed",
                 "transfer.failed",
@@ -91994,7 +92193,7 @@ async function announceActionUrl(url, {
 // package.json
 var package_default = {
   name: "@whop/cli",
-  version: "0.17.0",
+  version: "0.18.0",
   description: "The Whop CLI \u2014 build and manage Whop apps from your terminal. Human and agent friendly.",
   keywords: [
     "agent",
@@ -93854,6 +94053,9 @@ function safeParse(text4) {
 
 // src/feedback.ts
 var feedbackOptions = external_exports.object({
+  account_id: external_exports.string().regex(/^biz_[A-Za-z0-9]+$/).max(255).optional().describe(
+    "Account ID (biz_...) for the affected resource. Defaults to your active account when available."
+  ),
   content: external_exports.string().trim().min(1).max(12e3).describe(
     "Describe the problem or unanswered question and relevant context. Remove credentials, personal data, and payment details."
   )
@@ -93879,7 +94081,11 @@ function buildFeedbackCommand(kind) {
             "Content-Type": "application/json",
             "Idempotency-Key": crypto.randomUUID()
           },
-          body: JSON.stringify({ source: `cli_${kind}`, content })
+          body: JSON.stringify({
+            source: `cli_${kind}`,
+            content,
+            account_id: options.account_id ?? await resolveActiveAccountId()
+          })
         })
       );
       if (!response.ok) throw await responseError(response);