@happyvertical/smrt-planner 0.57.9 → 0.57.11

package/dist/catalog/catalog.json

@@ -5,7 +5,7 @@
     {
       "id": "ads",
       "packageName": "@happyvertical/smrt-ads",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Advertising delivery and tracking models for SMRT framework",
       "models": [
         {
@@ -1511,7 +1511,7 @@
     {
       "id": "analytics",
       "packageName": "@happyvertical/smrt-analytics",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Analytics integration models for SMRT framework",
       "models": [
         {
@@ -3420,7 +3420,7 @@
     {
       "id": "approvals",
       "packageName": "@happyvertical/smrt-approvals",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Approval decision gate for the SMRT framework: revision-bound, single-use approvals with quorum, expiry, and an append-only event ledger",
       "models": [
         {
@@ -3807,7 +3807,7 @@
     {
       "id": "assets",
       "packageName": "@happyvertical/smrt-assets",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Asset management system with versioning, metadata, and AI-powered operations for SMRT framework",
       "models": [
         {
@@ -5607,7 +5607,7 @@
     {
       "id": "chat",
       "packageName": "@happyvertical/smrt-chat",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Chat rooms, DMs, threads, and agent conversations for the SMRT framework",
       "models": [
         {
@@ -7974,7 +7974,7 @@
     {
       "id": "comments",
       "packageName": "@happyvertical/smrt-comments",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Record comments and mention hooks for SMRT applications",
       "models": [
         {
@@ -8390,7 +8390,7 @@
     {
       "id": "commerce",
       "packageName": "@happyvertical/smrt-commerce",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Commerce models for the SMRT framework - contracts, fulfillments, payments",
       "models": [
         {
@@ -8507,6 +8507,7 @@
               "name": "billingScheduleJson",
               "type": "text",
               "required": false,
+              "default": "",
               "system": true
             },
             {
@@ -9506,6 +9507,7 @@
               "name": "billingScheduleJson",
               "type": "text",
               "required": false,
+              "default": "",
               "system": true
             },
             {
@@ -9922,6 +9924,7 @@
               "name": "billingScheduleJson",
               "type": "text",
               "required": false,
+              "default": "",
               "system": true
             },
             {
@@ -11421,6 +11424,7 @@
               "name": "billingScheduleJson",
               "type": "text",
               "required": false,
+              "default": "",
               "system": true
             },
             {
@@ -14174,6 +14178,7 @@
               "name": "billingScheduleJson",
               "type": "text",
               "required": false,
+              "default": "",
               "system": true
             },
             {
@@ -14577,6 +14582,7 @@
               "name": "billingScheduleJson",
               "type": "text",
               "required": false,
+              "default": "",
               "system": true
             },
             {
@@ -15093,6 +15099,7 @@
               "name": "billingScheduleJson",
               "type": "text",
               "required": false,
+              "default": "",
               "system": true
             },
             {
@@ -15570,6 +15577,43 @@
               "type": "integer",
               "required": false,
               "default": 0
+            },
+            {
+              "name": "connectedAccountId",
+              "type": "text",
+              "required": false,
+              "default": ""
+            },
+            {
+              "name": "applicationFeeCents",
+              "type": "integer",
+              "required": false,
+              "default": 0
+            },
+            {
+              "name": "refundOfPaymentId",
+              "type": "text",
+              "required": false,
+              "default": ""
+            },
+            {
+              "name": "connectedRefundState",
+              "type": "text",
+              "required": false,
+              "default": "",
+              "enum": [
+                "",
+                "requested",
+                "pending",
+                "succeeded",
+                "failed"
+              ]
+            },
+            {
+              "name": "applicationFeeRefunded",
+              "type": "boolean",
+              "required": false,
+              "default": false
             }
           ],
           "rest": [
@@ -16566,6 +16610,36 @@
               "type": "text",
               "required": false,
               "default": ""
+            },
+            {
+              "name": "connectedAccountId",
+              "type": "text",
+              "required": false,
+              "default": ""
+            },
+            {
+              "name": "applicationFeeCents",
+              "type": "integer",
+              "required": false,
+              "default": 0
+            },
+            {
+              "name": "connectedEnvironment",
+              "type": "text",
+              "required": false,
+              "default": ""
+            },
+            {
+              "name": "connectedAmount",
+              "type": "integer",
+              "required": false,
+              "default": 0
+            },
+            {
+              "name": "connectedCurrency",
+              "type": "text",
+              "required": false,
+              "default": ""
             }
           ],
           "rest": [
@@ -17372,6 +17446,7 @@
               "name": "billingScheduleJson",
               "type": "text",
               "required": false,
+              "default": "",
               "system": true
             },
             {
@@ -17801,6 +17876,7 @@
               "name": "billingScheduleJson",
               "type": "text",
               "required": false,
+              "default": "",
               "system": true
             },
             {
@@ -18158,6 +18234,7 @@
               "name": "billingScheduleJson",
               "type": "text",
               "required": false,
+              "default": "",
               "system": true
             },
             {
@@ -18654,6 +18731,7 @@
               "name": "billingScheduleJson",
               "type": "text",
               "required": false,
+              "default": "",
               "system": true
             },
             {
@@ -19011,6 +19089,7 @@
               "name": "billingScheduleJson",
               "type": "text",
               "required": false,
+              "default": "",
               "system": true
             },
             {
@@ -19981,6 +20060,306 @@
           "references": [],
           "exposed": true
         },
+        {
+          "id": "@happyvertical/smrt-commerce:TenantPaymentAccount",
+          "name": "TenantPaymentAccount",
+          "collection": "tenantpaymentaccounts",
+          "description": "A tenant's connected payment account for one backend and environment.",
+          "fields": [
+            {
+              "name": "tenantId",
+              "type": "text",
+              "required": true,
+              "system": true
+            },
+            {
+              "name": "backendId",
+              "type": "text",
+              "required": true,
+              "default": "stripe"
+            },
+            {
+              "name": "environment",
+              "type": "text",
+              "required": true,
+              "default": "test",
+              "enum": [
+                "test",
+                "live"
+              ]
+            },
+            {
+              "name": "providerAccountId",
+              "type": "text",
+              "required": true,
+              "default": ""
+            },
+            {
+              "name": "status",
+              "type": "text",
+              "required": false,
+              "default": "pending",
+              "enum": [
+                "pending",
+                "restricted",
+                "enabled",
+                "disabled"
+              ]
+            },
+            {
+              "name": "chargesEnabled",
+              "type": "boolean",
+              "required": false,
+              "default": false
+            },
+            {
+              "name": "detailsSubmitted",
+              "type": "boolean",
+              "required": false,
+              "default": false
+            },
+            {
+              "name": "payoutsEnabled",
+              "type": "boolean",
+              "required": false,
+              "default": false
+            },
+            {
+              "name": "capabilitiesJson",
+              "type": "text",
+              "required": false,
+              "system": true
+            },
+            {
+              "name": "capabilitiesObservedAt",
+              "type": "datetime",
+              "required": false
+            },
+            {
+              "name": "feePolicyRef",
+              "type": "text",
+              "required": false,
+              "default": ""
+            },
+            {
+              "name": "disabledAt",
+              "type": "datetime",
+              "required": false
+            },
+            {
+              "name": "disabledReason",
+              "type": "text",
+              "required": false,
+              "default": ""
+            }
+          ],
+          "rest": [
+            {
+              "method": "GET",
+              "path": "/tenantpaymentaccounts"
+            },
+            {
+              "method": "GET",
+              "path": "/tenantpaymentaccounts/[id]"
+            }
+          ],
+          "mcp": [
+            {
+              "operation": "get",
+              "name": "tenantpaymentaccount_get"
+            },
+            {
+              "operation": "list",
+              "name": "tenantpaymentaccount_list"
+            }
+          ],
+          "cli": [
+            {
+              "operation": "get",
+              "name": "tenantpaymentaccount_get"
+            },
+            {
+              "operation": "getCapabilities",
+              "name": "tenantpaymentaccount_getCapabilities"
+            },
+            {
+              "operation": "isEnabled",
+              "name": "tenantpaymentaccount_isEnabled"
+            },
+            {
+              "operation": "list",
+              "name": "tenantpaymentaccount_list"
+            }
+          ],
+          "methods": [
+            {
+              "name": "build",
+              "async": true,
+              "parameters": [
+                "options: any"
+              ],
+              "returnType": "Promise<TenantPaymentAccount>",
+              "aiCallable": false
+            },
+            {
+              "name": "delete",
+              "async": true,
+              "parameters": [
+                "_options?: SmrtDeleteOptions"
+              ],
+              "returnType": "Promise<void>",
+              "aiCallable": false
+            },
+            {
+              "name": "findForTenant",
+              "async": true,
+              "parameters": [
+                "args: object"
+              ],
+              "returnType": "Promise<TenantPaymentAccount | null>",
+              "aiCallable": false
+            },
+            {
+              "name": "getCapabilities",
+              "async": false,
+              "parameters": [],
+              "returnType": "TenantPaymentCapabilitySnapshot | null",
+              "aiCallable": false
+            },
+            {
+              "name": "isEnabled",
+              "async": false,
+              "parameters": [],
+              "returnType": "boolean",
+              "aiCallable": false
+            },
+            {
+              "name": "save",
+              "async": true,
+              "parameters": [
+                "options?: SmrtSaveOptions"
+              ],
+              "returnType": "Promise<this>",
+              "aiCallable": false
+            },
+            {
+              "name": "setCapabilities",
+              "async": false,
+              "parameters": [
+                "snapshot: TenantPaymentCapabilitySnapshot",
+                "observedAt: Date"
+              ],
+              "returnType": "void",
+              "aiCallable": false
+            }
+          ],
+          "references": [],
+          "exposed": true
+        },
+        {
+          "id": "@happyvertical/smrt-commerce:TenantPaymentWebhookEvent",
+          "name": "TenantPaymentWebhookEvent",
+          "collection": "tenantpaymentwebhookevents",
+          "description": "One processed provider webhook event.",
+          "fields": [
+            {
+              "name": "backendId",
+              "type": "text",
+              "required": true,
+              "default": ""
+            },
+            {
+              "name": "environment",
+              "type": "text",
+              "required": true,
+              "default": ""
+            },
+            {
+              "name": "eventId",
+              "type": "text",
+              "required": true,
+              "default": ""
+            },
+            {
+              "name": "eventType",
+              "type": "text",
+              "required": false,
+              "default": ""
+            },
+            {
+              "name": "endpoint",
+              "type": "text",
+              "required": false,
+              "default": ""
+            },
+            {
+              "name": "tenantId",
+              "type": "crossPackageRef",
+              "required": true,
+              "related": "@happyvertical/smrt-users:Tenant",
+              "system": true
+            },
+            {
+              "name": "providerAccountId",
+              "type": "text",
+              "required": false,
+              "default": ""
+            },
+            {
+              "name": "outcome",
+              "type": "text",
+              "required": false,
+              "default": "ignored",
+              "enum": [
+                "settled",
+                "already_settled",
+                "pending",
+                "account_updated",
+                "stale_account_update",
+                "application_fee",
+                "refund_reported",
+                "refund_updated",
+                "late_payment",
+                "ignored"
+              ]
+            },
+            {
+              "name": "paymentIntentId",
+              "type": "text",
+              "required": false,
+              "default": ""
+            },
+            {
+              "name": "applicationFeeJson",
+              "type": "text",
+              "required": false,
+              "system": true
+            },
+            {
+              "name": "processedAt",
+              "type": "datetime",
+              "required": false
+            }
+          ],
+          "rest": [],
+          "mcp": [],
+          "cli": [],
+          "methods": [
+            {
+              "name": "build",
+              "async": true,
+              "parameters": [
+                "options: any"
+              ],
+              "returnType": "Promise<TenantPaymentWebhookEvent>",
+              "aiCallable": false
+            }
+          ],
+          "references": [
+            "@happyvertical/smrt-users:Tenant"
+          ],
+          "exposed": false
+        },
         {
           "id": "@happyvertical/smrt-commerce:Vendor",
           "name": "Vendor",
@@ -20451,6 +20830,7 @@
               "name": "billingScheduleJson",
               "type": "text",
               "required": false,
+              "default": "",
               "system": true
             },
             {
@@ -21297,6 +21677,21 @@
                 },
                 "transactionId": {
                   "visibility": "hidden"
+                },
+                "connectedAccountId": {
+                  "visibility": "hidden"
+                },
+                "applicationFeeCents": {
+                  "visibility": "hidden"
+                },
+                "refundOfPaymentId": {
+                  "visibility": "hidden"
+                },
+                "connectedRefundState": {
+                  "visibility": "hidden"
+                },
+                "applicationFeeRefunded": {
+                  "visibility": "hidden"
                 }
               }
             },
@@ -21923,7 +22318,7 @@
     {
       "id": "content",
       "packageName": "@happyvertical/smrt-content",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Content processing module for SMRT framework - handles documents, web content, and media",
       "models": [
         {
@@ -28853,7 +29248,7 @@
     {
       "id": "events",
       "packageName": "@happyvertical/smrt-events",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Hierarchical event management with participant tracking and SMRT framework support",
       "models": [
         {
@@ -30857,7 +31252,7 @@
     {
       "id": "expenses",
       "packageName": "@happyvertical/smrt-expenses",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Expense records for the SMRT framework - reviewed costs against a cost object, deduplicated receipts, and commitment drawdown",
       "models": [
         {
@@ -31669,7 +32064,7 @@
     {
       "id": "facts",
       "packageName": "@happyvertical/smrt-facts",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Distributed memory and knowledge management with provenance tracking for SMRT framework",
       "models": [
         {
@@ -33693,7 +34088,7 @@
     {
       "id": "fields",
       "packageName": "@happyvertical/smrt-fields",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Layered field policy store and resolver (defaults, visibility tiers, help text) for SMRT objects",
       "models": [
         {
@@ -34406,7 +34801,7 @@
     {
       "id": "human-resources",
       "packageName": "@happyvertical/smrt-human-resources",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "HR records for the SMRT framework: who works for an organization, as what, and with what standing — employment with dated terms, and qualifications with expiry",
       "models": [
         {
@@ -34926,7 +35321,7 @@
     {
       "id": "images",
       "packageName": "@happyvertical/smrt-images",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Image asset management with AI-powered categorization, search, editing, and metadata extraction for SMRT framework",
       "models": [
         {
@@ -35536,7 +35931,7 @@
     {
       "id": "ingestion",
       "packageName": "@happyvertical/smrt-ingestion",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Durable tenant-scoped intake and evidence foundations",
       "models": [
         {
@@ -36614,7 +37009,7 @@
     {
       "id": "inventory",
       "packageName": "@happyvertical/smrt-inventory",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Multi-location stock tracking for the SMRT framework — Sku, InventoryLocation, StockLevel, StockMovement, and a stock-mutation service",
       "models": [
         {
@@ -37218,7 +37613,7 @@
     {
       "id": "ledgers",
       "packageName": "@happyvertical/smrt-ledgers",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Double-entry accounting ledger for the SMRT framework",
       "models": [
         {
@@ -38767,7 +39162,7 @@
     {
       "id": "manufacturing",
       "packageName": "@happyvertical/smrt-manufacturing",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Bills of materials, cost rollup, and production-order operations for the SMRT framework — strictly industry-neutral",
       "models": [
         {
@@ -39719,7 +40114,7 @@
     {
       "id": "marketing",
       "packageName": "@happyvertical/smrt-marketing",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Cross-channel campaign coordination, immutable performance evidence, budget pacing, and reusable Svelte marketing surfaces for SMRT",
       "models": [
         {
@@ -40325,7 +40720,7 @@
     {
       "id": "messages",
       "packageName": "@happyvertical/smrt-messages",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Unified multi-channel messaging with STI-based hierarchies",
       "models": [
         {
@@ -46780,7 +47175,7 @@
     {
       "id": "places",
       "packageName": "@happyvertical/smrt-places",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Hierarchical place management with geo integration and SMRT framework support",
       "models": [
         {
@@ -47624,7 +48019,7 @@
     {
       "id": "preferences",
       "packageName": "@happyvertical/smrt-preferences",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Tenant defaults and per-user overrides for user-interface preferences (overview layouts, shell layout), validated per registered kind",
       "models": [
         {
@@ -47778,7 +48173,7 @@
     {
       "id": "products",
       "packageName": "@happyvertical/smrt-products",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "SMRT products module: triple-purpose microservice template for standalone apps, federated modules, and NPM libraries",
       "models": [
         {
@@ -49261,7 +49656,7 @@
     {
       "id": "profiles",
       "packageName": "@happyvertical/smrt-profiles",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Profile management system with relationships, metadata, and reciprocal associations for SMRT framework",
       "models": [
         {
@@ -53850,7 +54245,7 @@
     {
       "id": "projects",
       "packageName": "@happyvertical/smrt-projects",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Provider-agnostic project management models (Issues, PRs, Repositories, Projects) for SMRT framework",
       "models": [
         {
@@ -56843,7 +57238,7 @@
     {
       "id": "properties",
       "packageName": "@happyvertical/smrt-properties",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Digital property and zone management models for SMRT framework",
       "models": [
         {
@@ -57706,7 +58101,7 @@
     {
       "id": "reports",
       "packageName": "@happyvertical/smrt-reports",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Materialized aggregate report models for SMRT",
       "models": [
         {
@@ -58569,7 +58964,7 @@
     {
       "id": "sales",
       "packageName": "@happyvertical/smrt-sales",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Modular sales for the SMRT framework: agreement execution, CRM, referral intake, neutral commissions, and reusable Svelte surfaces",
       "models": [
         {
@@ -61407,6 +61802,12 @@
               "required": false,
               "system": true
             },
+            {
+              "name": "kind",
+              "type": "text",
+              "required": false,
+              "default": "person"
+            },
             {
               "name": "profileId",
               "type": "crossPackageRef",
@@ -61431,6 +61832,12 @@
               "required": false,
               "default": "bank_transfer"
             },
+            {
+              "name": "payoutDestination",
+              "type": "text",
+              "required": false,
+              "default": "{}"
+            },
             {
               "name": "payoutThresholdCents",
               "type": "integer",
@@ -61505,10 +61912,18 @@
               "operation": "getMetadata",
               "name": "earner_getMetadata"
             },
+            {
+              "operation": "getPayoutDestination",
+              "name": "earner_getPayoutDestination"
+            },
             {
               "operation": "isActive",
               "name": "earner_isActive"
             },
+            {
+              "operation": "isOrganisation",
+              "name": "earner_isOrganisation"
+            },
             {
               "operation": "isPending",
               "name": "earner_isPending"
@@ -61517,6 +61932,10 @@
               "operation": "isSuspended",
               "name": "earner_isSuspended"
             },
+            {
+              "operation": "isTreasury",
+              "name": "earner_isTreasury"
+            },
             {
               "operation": "list",
               "name": "earner_list"
@@ -61525,6 +61944,10 @@
               "operation": "setMetadata",
               "name": "earner_setMetadata"
             },
+            {
+              "operation": "setPayoutDestination",
+              "name": "earner_setPayoutDestination"
+            },
             {
               "operation": "update",
               "name": "earner_update"
@@ -61575,6 +61998,13 @@
               "returnType": "Record<string, unknown>",
               "aiCallable": false
             },
+            {
+              "name": "getPayoutDestination",
+              "async": false,
+              "parameters": [],
+              "returnType": "PayoutDestination | null",
+              "aiCallable": false
+            },
             {
               "name": "isActive",
               "async": false,
@@ -61582,6 +62012,13 @@
               "returnType": "boolean",
               "aiCallable": false
             },
+            {
+              "name": "isOrganisation",
+              "async": false,
+              "parameters": [],
+              "returnType": "boolean",
+              "aiCallable": false
+            },
             {
               "name": "isPending",
               "async": false,
@@ -61596,6 +62033,20 @@
               "returnType": "boolean",
               "aiCallable": false
             },
+            {
+              "name": "isTreasury",
+              "async": false,
+              "parameters": [],
+              "returnType": "boolean",
+              "aiCallable": false
+            },
+            {
+              "name": "save",
+              "async": true,
+              "parameters": [],
+              "returnType": "Promise<this>",
+              "aiCallable": false
+            },
             {
               "name": "setMetadata",
               "async": false,
@@ -61604,6 +62055,15 @@
               ],
               "returnType": "void",
               "aiCallable": false
+            },
+            {
+              "name": "setPayoutDestination",
+              "async": false,
+              "parameters": [
+                "destination: PayoutDestination | null"
+              ],
+              "returnType": "void",
+              "aiCallable": false
             }
           ],
           "references": [
@@ -65391,7 +65851,7 @@
     {
       "id": "sites",
       "packageName": "@happyvertical/smrt-sites",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Site lifecycle management for multi-tenant SMRT networks",
       "models": [
         {
@@ -65859,7 +66319,7 @@
     {
       "id": "social",
       "packageName": "@happyvertical/smrt-social",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Social media account management for multi-platform publishing in the SMRT ecosystem",
       "models": [
         {
@@ -66846,7 +67306,7 @@
     {
       "id": "subscriptions",
       "packageName": "@happyvertical/smrt-subscriptions",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Tenant subscriptions, entitlement resolution, usage thresholds, and subscription UI for SMRT",
       "models": [
         {
@@ -68076,10 +68536,18 @@
               "operation": "getMetadata",
               "name": "subscriptionplan_getMetadata"
             },
+            {
+              "operation": "getTerms",
+              "name": "subscriptionplan_getTerms"
+            },
             {
               "operation": "getThresholds",
               "name": "subscriptionplan_getThresholds"
             },
+            {
+              "operation": "getVersionInForce",
+              "name": "subscriptionplan_getVersionInForce"
+            },
             {
               "operation": "isActive",
               "name": "subscriptionplan_isActive"
@@ -68088,6 +68556,10 @@
               "operation": "list",
               "name": "subscriptionplan_list"
             },
+            {
+              "operation": "publishTerms",
+              "name": "subscriptionplan_publishTerms"
+            },
             {
               "operation": "setFeatureGrants",
               "name": "subscriptionplan_setFeatureGrants"
@@ -68178,6 +68650,13 @@
               "returnType": "JsonObject",
               "aiCallable": false
             },
+            {
+              "name": "getTerms",
+              "async": false,
+              "parameters": [],
+              "returnType": "PlanTerms",
+              "aiCallable": false
+            },
             {
               "name": "getThresholds",
               "async": false,
@@ -68185,6 +68664,15 @@
               "returnType": "PlanThreshold[]",
               "aiCallable": false
             },
+            {
+              "name": "getVersionInForce",
+              "async": true,
+              "parameters": [
+                "at?: any"
+              ],
+              "returnType": "Promise<SubscriptionPlanVersion | null>",
+              "aiCallable": false
+            },
             {
               "name": "isActive",
               "async": false,
@@ -68192,6 +68680,24 @@
               "returnType": "boolean",
               "aiCallable": false
             },
+            {
+              "name": "publishTerms",
+              "async": true,
+              "parameters": [
+                "options?: object"
+              ],
+              "returnType": "Promise<SubscriptionPlanVersion>",
+              "aiCallable": false
+            },
+            {
+              "name": "save",
+              "async": true,
+              "parameters": [
+                "options?: SmrtSaveOptions"
+              ],
+              "returnType": "Promise<this>",
+              "aiCallable": false
+            },
             {
               "name": "setFeatureGrants",
               "async": false,
@@ -68223,6 +68729,231 @@
           "references": [],
           "exposed": true
         },
+        {
+          "id": "@happyvertical/smrt-subscriptions:SubscriptionPlanVersion",
+          "name": "SubscriptionPlanVersion",
+          "collection": "subscriptionplanversions",
+          "description": "An immutable, effective-dated snapshot of a plan's terms (#4032).",
+          "display": {
+            "label": "name"
+          },
+          "fields": [
+            {
+              "name": "tenantId",
+              "type": "text",
+              "required": false,
+              "system": true
+            },
+            {
+              "name": "planId",
+              "type": "foreignKey",
+              "required": false,
+              "related": "@happyvertical/smrt-subscriptions:SubscriptionPlan"
+            },
+            {
+              "name": "planKey",
+              "type": "text",
+              "required": false,
+              "default": ""
+            },
+            {
+              "name": "version",
+              "type": "integer",
+              "required": false,
+              "default": 0
+            },
+            {
+              "name": "effectiveFrom",
+              "type": "datetime",
+              "required": false
+            },
+            {
+              "name": "name",
+              "type": "text",
+              "required": false,
+              "default": ""
+            },
+            {
+              "name": "status",
+              "type": "text",
+              "required": false,
+              "default": "active",
+              "enum": [
+                "active",
+                "archived",
+                "draft"
+              ]
+            },
+            {
+              "name": "priceAmount",
+              "type": "integer",
+              "required": false,
+              "default": 0
+            },
+            {
+              "name": "currency",
+              "type": "text",
+              "required": false,
+              "default": "USD"
+            },
+            {
+              "name": "billingInterval",
+              "type": "text",
+              "required": false,
+              "default": "month",
+              "enum": [
+                "day",
+                "week",
+                "month",
+                "year"
+              ]
+            },
+            {
+              "name": "pricingMode",
+              "type": "text",
+              "required": false,
+              "default": "fixed",
+              "enum": [
+                "free",
+                "fixed",
+                "pay_what_you_can"
+              ]
+            },
+            {
+              "name": "minimumAmount",
+              "type": "integer",
+              "required": false,
+              "default": 0
+            },
+            {
+              "name": "suggestedAmount",
+              "type": "integer",
+              "required": false,
+              "default": 0
+            },
+            {
+              "name": "features",
+              "type": "text",
+              "required": false,
+              "default": "[]"
+            },
+            {
+              "name": "thresholds",
+              "type": "text",
+              "required": false,
+              "default": "[]"
+            }
+          ],
+          "rest": [
+            {
+              "method": "GET",
+              "path": "/subscriptionplanversions"
+            },
+            {
+              "method": "GET",
+              "path": "/subscriptionplanversions/[id]"
+            }
+          ],
+          "mcp": [
+            {
+              "operation": "get",
+              "name": "subscriptionplanversion_get"
+            },
+            {
+              "operation": "list",
+              "name": "subscriptionplanversion_list"
+            }
+          ],
+          "cli": [
+            {
+              "operation": "get",
+              "name": "subscriptionplanversion_get"
+            },
+            {
+              "operation": "list",
+              "name": "subscriptionplanversion_list"
+            }
+          ],
+          "methods": [
+            {
+              "name": "findInForce",
+              "async": true,
+              "parameters": [
+                "planId: string",
+                "at: Date"
+              ],
+              "returnType": "Promise<SubscriptionPlanVersion | null>",
+              "aiCallable": false
+            },
+            {
+              "name": "findLatest",
+              "async": true,
+              "parameters": [
+                "planId: string",
+                "tenantId?: string | null"
+              ],
+              "returnType": "Promise<SubscriptionPlanVersion | null>",
+              "aiCallable": false
+            },
+            {
+              "name": "findVisibleById",
+              "async": true,
+              "parameters": [
+                "id: string"
+              ],
+              "returnType": "Promise<SubscriptionPlanVersion | null>",
+              "aiCallable": false
+            },
+            {
+              "name": "getFeatureGrants",
+              "async": false,
+              "parameters": [],
+              "returnType": "PlanFeatureGrant[]",
+              "aiCallable": false
+            },
+            {
+              "name": "getFeatureKeys",
+              "async": false,
+              "parameters": [],
+              "returnType": "string[]",
+              "aiCallable": false
+            },
+            {
+              "name": "getTerms",
+              "async": false,
+              "parameters": [],
+              "returnType": "PlanTerms",
+              "aiCallable": false
+            },
+            {
+              "name": "getThresholds",
+              "async": false,
+              "parameters": [],
+              "returnType": "PlanThreshold[]",
+              "aiCallable": false
+            },
+            {
+              "name": "isActive",
+              "async": false,
+              "parameters": [],
+              "returnType": "boolean",
+              "aiCallable": false
+            },
+            {
+              "name": "listForPlan",
+              "async": true,
+              "parameters": [
+                "planId: string"
+              ],
+              "returnType": "Promise<SubscriptionPlanVersion[]>",
+              "aiCallable": false
+            }
+          ],
+          "references": [
+            "@happyvertical/smrt-subscriptions:SubscriptionPlan"
+          ],
+          "exposed": true
+        },
         {
           "id": "@happyvertical/smrt-subscriptions:TenantSubscription",
           "name": "TenantSubscription",
@@ -68306,6 +69037,41 @@
               "type": "integer",
               "required": false
             },
+            {
+              "name": "planVersionId",
+              "type": "foreignKey",
+              "required": false,
+              "related": "@happyvertical/smrt-subscriptions:SubscriptionPlanVersion"
+            },
+            {
+              "name": "planVersionPinnedAt",
+              "type": "datetime",
+              "required": false
+            },
+            {
+              "name": "planVersionPinReason",
+              "type": "text",
+              "required": false,
+              "enum": [
+                "period_start",
+                "renewal",
+                "upgrade",
+                "authorized",
+                "migration"
+              ]
+            },
+            {
+              "name": "planVersionPinNote",
+              "type": "text",
+              "required": false,
+              "default": ""
+            },
+            {
+              "name": "retainsPaidPeriod",
+              "type": "boolean",
+              "required": false,
+              "default": false
+            },
             {
               "name": "externalProvider",
               "type": "text",
@@ -68393,6 +69159,10 @@
               "operation": "list",
               "name": "tenantsubscription_list"
             },
+            {
+              "operation": "replacePlanVersion",
+              "name": "tenantsubscription_replacePlanVersion"
+            },
             {
               "operation": "setMetadata",
               "name": "tenantsubscription_setMetadata"
@@ -68480,6 +69250,15 @@
               "returnType": "boolean",
               "aiCallable": false
             },
+            {
+              "name": "replacePlanVersion",
+              "async": true,
+              "parameters": [
+                "options: any"
+              ],
+              "returnType": "Promise<this>",
+              "aiCallable": false
+            },
             {
               "name": "setMetadata",
               "async": false,
@@ -68491,7 +69270,8 @@
             }
           ],
           "references": [
-            "@happyvertical/smrt-subscriptions:SubscriptionPlan"
+            "@happyvertical/smrt-subscriptions:SubscriptionPlan",
+            "@happyvertical/smrt-subscriptions:SubscriptionPlanVersion"
           ],
           "exposed": true
         },
@@ -68719,7 +69499,7 @@
     {
       "id": "support",
       "packageName": "@happyvertical/smrt-support",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "AI-first Support Cases: channel-neutral intake, lifecycle, routing, service targets, and service time for the SMRT framework",
       "models": [
         {
@@ -71912,7 +72692,7 @@
     {
       "id": "tags",
       "packageName": "@happyvertical/smrt-tags",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Reusable tagging system with hierarchies, contexts, and multi-language support for SMRT framework",
       "models": [
         {
@@ -72691,7 +73471,7 @@
     {
       "id": "timesheets",
       "packageName": "@happyvertical/smrt-timesheets",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Shared time entries for the SMRT framework: who worked how long on what, approval and correction, with immutable charge and compensation snapshots",
       "models": [
         {
@@ -74223,7 +75003,7 @@
     {
       "id": "users",
       "packageName": "@happyvertical/smrt-users",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Multi-tenant user management for the SMRT framework - users, tenants, roles, permissions, groups",
       "models": [
         {
@@ -78513,7 +79293,7 @@
     {
       "id": "video",
       "packageName": "@happyvertical/smrt-video",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Video content management for AI-powered video production in the SMRT ecosystem",
       "models": [
         {
@@ -85890,7 +86670,7 @@
     {
       "id": "voice",
       "packageName": "@happyvertical/smrt-voice",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Voice profile management for AI-powered voice synthesis and cloning in the SMRT ecosystem",
       "models": [
         {
@@ -87350,7 +88130,7 @@
     {
       "id": "webhooks",
       "packageName": "@happyvertical/smrt-webhooks",
-      "version": "0.57.9",
+      "version": "0.57.11",
       "description": "Outbound webhook subscriptions, signed delivery, and durable retries",
       "models": [
         {