@happyvertical/smrt-subscriptions 0.40.69 → 0.41.0

package/dist/manifest.json

@@ -2,7 +2,7 @@
   "version": "1.0.0",
   "timestamp": 0,
   "packageName": "@happyvertical/smrt-subscriptions",
-  "packageVersion": "0.40.69",
+  "packageVersion": "0.41.0",
   "objects": {
     "@happyvertical/smrt-subscriptions:SubscriptionPlanCollection": {
       "name": "subscriptionplancollection",
@@ -88,12 +88,6 @@
           }
         },
         "indexes": [
-          {
-            "name": "_smrt_subscription_plans_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "_smrt_subscription_plans_slug_context_idx",
             "columns": [
@@ -101,6 +95,12 @@
               "context"
             ],
             "unique": true
+          },
+          {
+            "name": "_smrt_subscription_plans_created_at_idx",
+            "columns": [
+              "created_at"
+            ]
           }
         ],
         "version": "e693208d"
@@ -220,12 +220,6 @@
           }
         },
         "indexes": [
-          {
-            "name": "_smrt_tenant_subscriptions_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "_smrt_tenant_subscriptions_slug_context_idx",
             "columns": [
@@ -233,6 +227,12 @@
               "context"
             ],
             "unique": true
+          },
+          {
+            "name": "_smrt_tenant_subscriptions_created_at_idx",
+            "columns": [
+              "created_at"
+            ]
           }
         ],
         "version": "1d17f963"
@@ -361,12 +361,6 @@
           }
         },
         "indexes": [
-          {
-            "name": "_smrt_tenant_usage_metrics_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "_smrt_tenant_usage_metrics_slug_context_idx",
             "columns": [
@@ -374,6 +368,12 @@
               "context"
             ],
             "unique": true
+          },
+          {
+            "name": "_smrt_tenant_usage_metrics_created_at_idx",
+            "columns": [
+              "created_at"
+            ]
           }
         ],
         "version": "8617d4ac"
@@ -431,7 +431,7 @@
           "default": 0
         },
         "priceAmount": {
-          "type": "decimal",
+          "type": "integer",
           "required": false,
           "default": 0
         },
@@ -589,7 +589,7 @@
       "collectionExportName": "SubscriptionPlanCollection",
       "schema": {
         "tableName": "_smrt_subscription_plans",
-        "ddl": "CREATE TABLE IF NOT EXISTS \"_smrt_subscription_plans\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID,\n  \"plan_key\" TEXT DEFAULT '',\n  \"name\" TEXT DEFAULT '',\n  \"description\" TEXT DEFAULT '',\n  \"status\" TEXT DEFAULT 'active',\n  \"sort_order\" INTEGER DEFAULT 0,\n  \"price_amount\" REAL DEFAULT 0,\n  \"currency\" TEXT DEFAULT 'USD',\n  \"billing_interval\" TEXT DEFAULT 'month',\n  \"external_provider\" TEXT DEFAULT 'stripe',\n  \"stripe_product_id\" TEXT DEFAULT '',\n  \"stripe_price_id\" TEXT DEFAULT '',\n  \"features\" TEXT DEFAULT '[]',\n  \"thresholds\" TEXT DEFAULT '[]',\n  \"metadata\" TEXT DEFAULT '{}'\n);",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"_smrt_subscription_plans\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID,\n  \"plan_key\" TEXT DEFAULT '',\n  \"name\" TEXT DEFAULT '',\n  \"description\" TEXT DEFAULT '',\n  \"status\" TEXT DEFAULT 'active',\n  \"sort_order\" INTEGER DEFAULT 0,\n  \"price_amount\" INTEGER DEFAULT 0,\n  \"currency\" TEXT DEFAULT 'USD',\n  \"billing_interval\" TEXT DEFAULT 'month',\n  \"external_provider\" TEXT DEFAULT 'stripe',\n  \"stripe_product_id\" TEXT DEFAULT '',\n  \"stripe_price_id\" TEXT DEFAULT '',\n  \"features\" TEXT DEFAULT '[]',\n  \"thresholds\" TEXT DEFAULT '[]',\n  \"metadata\" TEXT DEFAULT '{}'\n);",
         "columns": {
           "id": {
             "type": "UUID",
@@ -653,7 +653,7 @@
             "default": 0
           },
           "price_amount": {
-            "type": "REAL",
+            "type": "INTEGER",
             "notNull": false,
             "unique": false,
             "default": 0
@@ -708,21 +708,29 @@
           }
         },
         "indexes": [
-          {
-            "name": "_smrt_subscription_plans_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "_smrt_subscription_plans_plan_key_idx",
             "columns": [
               "plan_key"
             ],
             "unique": true
+          },
+          {
+            "name": "_smrt_subscription_plans_slug_context_idx",
+            "columns": [
+              "slug",
+              "context"
+            ]
+          },
+          {
+            "name": "_smrt_subscription_plans_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
           }
         ],
-        "version": "bbe13cf9"
+        "version": "65765fd0"
       }
     },
     "@happyvertical/smrt-subscriptions:TenantSubscription": {
@@ -1025,12 +1033,6 @@
           }
         },
         "indexes": [
-          {
-            "name": "_smrt_tenant_subscriptions_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "_smrt_tenant_subscriptions_tenant_id_subscriber_kind_idx",
             "columns": [
@@ -1039,6 +1041,26 @@
               "subscriber_external_id"
             ],
             "unique": true
+          },
+          {
+            "name": "_smrt_tenant_subscriptions_slug_context_idx",
+            "columns": [
+              "slug",
+              "context"
+            ]
+          },
+          {
+            "name": "_smrt_tenant_subscriptions_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
+          },
+          {
+            "name": "_smrt_tenant_subscriptions_plan_id_idx",
+            "columns": [
+              "plan_id"
+            ]
           }
         ],
         "version": "ef3d8be5"
@@ -1189,7 +1211,12 @@
         },
         "tenantScoped": {
           "mode": "required"
-        }
+        },
+        "conflictColumns": [
+          "tenant_id",
+          "slug",
+          "context"
+        ]
       },
       "extends": "SmrtObject",
       "exportName": "TenantUsageMetric",
@@ -1314,19 +1341,21 @@
           }
         },
         "indexes": [
-          {
-            "name": "_smrt_tenant_usage_metrics_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "_smrt_tenant_usage_metrics_slug_context_idx",
             "columns": [
+              "tenant_id",
               "slug",
               "context"
             ],
             "unique": true
+          },
+          {
+            "name": "_smrt_tenant_usage_metrics_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
           }
         ],
         "version": "b799c746"
@@ -1437,7 +1466,12 @@
         "mcp": true,
         "tenantScoped": {
           "mode": "required"
-        }
+        },
+        "conflictColumns": [
+          "tenant_id",
+          "slug",
+          "context"
+        ]
       },
       "extends": "SmrtObject",
       "exportName": "PricingRule",
@@ -1544,19 +1578,21 @@
           }
         },
         "indexes": [
-          {
-            "name": "_smrt_pricing_rules_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "_smrt_pricing_rules_slug_context_idx",
             "columns": [
+              "tenant_id",
               "slug",
               "context"
             ],
             "unique": true
+          },
+          {
+            "name": "_smrt_pricing_rules_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
           }
         ],
         "version": "88642897"
@@ -1638,7 +1674,7 @@
           "default": 0
         },
         "amount": {
-          "type": "decimal",
+          "type": "integer",
           "required": false,
           "default": 0
         },
@@ -1716,7 +1752,7 @@
       ],
       "schema": {
         "tableName": "_smrt_client_charges",
-        "ddl": "CREATE TABLE IF NOT EXISTS \"_smrt_client_charges\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID NOT NULL,\n  \"usage_event_id\" UUID,\n  \"subscriber_kind\" TEXT DEFAULT 'tenant',\n  \"subscriber_external_id\" TEXT DEFAULT '',\n  \"project_id\" TEXT DEFAULT '',\n  \"work_ref_type\" TEXT DEFAULT '',\n  \"work_ref_id\" TEXT DEFAULT '',\n  \"provider\" TEXT DEFAULT '',\n  \"service_key\" TEXT DEFAULT '',\n  \"metric_key\" TEXT DEFAULT '',\n  \"quantity\" REAL DEFAULT 0,\n  \"amount\" REAL DEFAULT 0,\n  \"currency\" TEXT DEFAULT 'USD',\n  \"pricing_rule_id\" UUID,\n  \"pricing_snapshot\" TEXT DEFAULT '{}',\n  \"status\" TEXT DEFAULT 'draft',\n  \"approved_at\" TIMESTAMP\n);",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"_smrt_client_charges\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID NOT NULL,\n  \"usage_event_id\" UUID,\n  \"subscriber_kind\" TEXT DEFAULT 'tenant',\n  \"subscriber_external_id\" TEXT DEFAULT '',\n  \"project_id\" TEXT DEFAULT '',\n  \"work_ref_type\" TEXT DEFAULT '',\n  \"work_ref_id\" TEXT DEFAULT '',\n  \"provider\" TEXT DEFAULT '',\n  \"service_key\" TEXT DEFAULT '',\n  \"metric_key\" TEXT DEFAULT '',\n  \"quantity\" REAL DEFAULT 0,\n  \"amount\" INTEGER DEFAULT 0,\n  \"currency\" TEXT DEFAULT 'USD',\n  \"pricing_rule_id\" UUID,\n  \"pricing_snapshot\" TEXT DEFAULT '{}',\n  \"status\" TEXT DEFAULT 'draft',\n  \"approved_at\" TIMESTAMP\n);",
         "columns": {
           "id": {
             "type": "UUID",
@@ -1810,7 +1846,7 @@
             "default": 0
           },
           "amount": {
-            "type": "REAL",
+            "type": "INTEGER",
             "notNull": false,
             "unique": false,
             "default": 0
@@ -1846,21 +1882,35 @@
           }
         },
         "indexes": [
-          {
-            "name": "_smrt_client_charges_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "_smrt_client_charges_usage_event_id_idx",
             "columns": [
               "usage_event_id"
             ],
             "unique": true
+          },
+          {
+            "name": "_smrt_client_charges_slug_context_idx",
+            "columns": [
+              "slug",
+              "context"
+            ]
+          },
+          {
+            "name": "_smrt_client_charges_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
+          },
+          {
+            "name": "_smrt_client_charges_pricing_rule_id_idx",
+            "columns": [
+              "pricing_rule_id"
+            ]
           }
         ],
-        "version": "9bee0a3e"
+        "version": "eeee66e0"
       }
     },
     "@happyvertical/smrt-subscriptions:BillingAdjustment": {
@@ -1894,7 +1944,7 @@
           "related": "ClientCharge"
         },
         "amount": {
-          "type": "decimal",
+          "type": "integer",
           "required": false,
           "default": 0
         },
@@ -1947,7 +1997,12 @@
         },
         "tenantScoped": {
           "mode": "required"
-        }
+        },
+        "conflictColumns": [
+          "tenant_id",
+          "slug",
+          "context"
+        ]
       },
       "extends": "SmrtObject",
       "exportName": "BillingAdjustment",
@@ -1961,7 +2016,7 @@
       ],
       "schema": {
         "tableName": "_smrt_billing_adjustments",
-        "ddl": "CREATE TABLE IF NOT EXISTS \"_smrt_billing_adjustments\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID NOT NULL,\n  \"client_charge_id\" UUID,\n  \"amount\" REAL DEFAULT 0,\n  \"currency\" TEXT DEFAULT 'USD',\n  \"reason\" TEXT DEFAULT '',\n  \"source\" TEXT DEFAULT '',\n  \"source_id\" TEXT DEFAULT '',\n  \"created_by\" TEXT DEFAULT ''\n);",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"_smrt_billing_adjustments\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID NOT NULL,\n  \"client_charge_id\" UUID,\n  \"amount\" INTEGER DEFAULT 0,\n  \"currency\" TEXT DEFAULT 'USD',\n  \"reason\" TEXT DEFAULT '',\n  \"source\" TEXT DEFAULT '',\n  \"source_id\" TEXT DEFAULT '',\n  \"created_by\" TEXT DEFAULT ''\n);",
         "columns": {
           "id": {
             "type": "UUID",
@@ -2001,7 +2056,7 @@
             "unique": false
           },
           "amount": {
-            "type": "REAL",
+            "type": "INTEGER",
             "notNull": false,
             "unique": false,
             "default": 0
@@ -2038,22 +2093,30 @@
           }
         },
         "indexes": [
-          {
-            "name": "_smrt_billing_adjustments_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "_smrt_billing_adjustments_slug_context_idx",
             "columns": [
+              "tenant_id",
               "slug",
               "context"
             ],
             "unique": true
+          },
+          {
+            "name": "_smrt_billing_adjustments_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
+          },
+          {
+            "name": "_smrt_billing_adjustments_client_charge_id_idx",
+            "columns": [
+              "client_charge_id"
+            ]
           }
         ],
-        "version": "fefa2538"
+        "version": "1c7ec461"
       }
     },
     "@happyvertical/smrt-subscriptions:SpendingPolicy": {
@@ -2122,7 +2185,7 @@
           "default": 0
         },
         "limitAmount": {
-          "type": "decimal",
+          "type": "integer",
           "required": false,
           "default": 0
         },
@@ -2179,7 +2242,7 @@
       ],
       "schema": {
         "tableName": "_smrt_spending_policies",
-        "ddl": "CREATE TABLE IF NOT EXISTS \"_smrt_spending_policies\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID NOT NULL,\n  \"name\" TEXT DEFAULT '',\n  \"subscriber_kind\" TEXT DEFAULT '',\n  \"subscriber_external_id\" TEXT DEFAULT '',\n  \"project_id\" TEXT DEFAULT '',\n  \"service_key\" TEXT DEFAULT '',\n  \"metric_key\" TEXT DEFAULT '',\n  \"period\" TEXT DEFAULT 'month',\n  \"rolling_seconds\" INTEGER DEFAULT 0,\n  \"limit_amount\" REAL DEFAULT 0,\n  \"currency\" TEXT DEFAULT 'USD',\n  \"behavior\" TEXT DEFAULT 'observe',\n  \"priority\" INTEGER DEFAULT 0,\n  \"active\" BOOLEAN DEFAULT TRUE\n);",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"_smrt_spending_policies\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID NOT NULL,\n  \"name\" TEXT DEFAULT '',\n  \"subscriber_kind\" TEXT DEFAULT '',\n  \"subscriber_external_id\" TEXT DEFAULT '',\n  \"project_id\" TEXT DEFAULT '',\n  \"service_key\" TEXT DEFAULT '',\n  \"metric_key\" TEXT DEFAULT '',\n  \"period\" TEXT DEFAULT 'month',\n  \"rolling_seconds\" INTEGER DEFAULT 0,\n  \"limit_amount\" INTEGER DEFAULT 0,\n  \"currency\" TEXT DEFAULT 'USD',\n  \"behavior\" TEXT DEFAULT 'observe',\n  \"priority\" INTEGER DEFAULT 0,\n  \"active\" BOOLEAN DEFAULT TRUE\n);",
         "columns": {
           "id": {
             "type": "UUID",
@@ -2261,7 +2324,7 @@
             "default": 0
           },
           "limit_amount": {
-            "type": "REAL",
+            "type": "INTEGER",
             "notNull": false,
             "unique": false,
             "default": 0
@@ -2292,12 +2355,6 @@
           }
         },
         "indexes": [
-          {
-            "name": "_smrt_spending_policies_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "_smrt_spending_policies_tenant_id_subscriber_kind_idx",
             "columns": [
@@ -2311,9 +2368,23 @@
               "name"
             ],
             "unique": true
+          },
+          {
+            "name": "_smrt_spending_policies_slug_context_idx",
+            "columns": [
+              "slug",
+              "context"
+            ]
+          },
+          {
+            "name": "_smrt_spending_policies_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
           }
         ],
-        "version": "af20dc21"
+        "version": "6a413cf4"
       }
     },
     "@happyvertical/smrt-subscriptions:PricingRuleCollection": {
@@ -2363,12 +2434,6 @@
           }
         },
         "indexes": [
-          {
-            "name": "_smrt_pricing_rules_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "_smrt_pricing_rules_slug_context_idx",
             "columns": [
@@ -2376,6 +2441,12 @@
               "context"
             ],
             "unique": true
+          },
+          {
+            "name": "_smrt_pricing_rules_created_at_idx",
+            "columns": [
+              "created_at"
+            ]
           }
         ],
         "version": "3fb55a6a"
@@ -2428,12 +2499,6 @@
           }
         },
         "indexes": [
-          {
-            "name": "_smrt_client_charges_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "_smrt_client_charges_slug_context_idx",
             "columns": [
@@ -2441,6 +2506,12 @@
               "context"
             ],
             "unique": true
+          },
+          {
+            "name": "_smrt_client_charges_created_at_idx",
+            "columns": [
+              "created_at"
+            ]
           }
         ],
         "version": "96756a5d"
@@ -2493,12 +2564,6 @@
           }
         },
         "indexes": [
-          {
-            "name": "_smrt_billing_adjustments_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "_smrt_billing_adjustments_slug_context_idx",
             "columns": [
@@ -2506,6 +2571,12 @@
               "context"
             ],
             "unique": true
+          },
+          {
+            "name": "_smrt_billing_adjustments_created_at_idx",
+            "columns": [
+              "created_at"
+            ]
           }
         ],
         "version": "5ca89c74"
@@ -2558,12 +2629,6 @@
           }
         },
         "indexes": [
-          {
-            "name": "_smrt_spending_policies_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "_smrt_spending_policies_slug_context_idx",
             "columns": [
@@ -2571,6 +2636,12 @@
               "context"
             ],
             "unique": true
+          },
+          {
+            "name": "_smrt_spending_policies_created_at_idx",
+            "columns": [
+              "created_at"
+            ]
           }
         ],
         "version": "4f25df0f"

package/dist/migrations/moneyMinorUnits.d.ts

@@ -0,0 +1,31 @@
+import { DatabaseInterface, MinorUnitsPreflightResult, MinorUnitsRescaleResult, MoneyColumnTarget } from '@happyvertical/smrt-core/migrations';
+/** Marker recorded in `_smrt_backfills` once the rescale has run. */
+export declare const SUBSCRIPTIONS_MONEY_MINOR_UNITS_BACKFILL = "@happyvertical/smrt-subscriptions:money-minor-units:v1";
+/**
+ * Every subscriptions money column that held major units before #2401.
+ *
+ * `quantity` columns are absent on purpose: metered quantities are genuinely
+ * fractional and stay DECIMAL.
+ */
+export declare const SUBSCRIPTIONS_MONEY_COLUMNS: MoneyColumnTarget[];
+/**
+ * Report what {@link migrateSubscriptionsMoneyToMinorUnits} would do, without
+ * writing anything.
+ */
+export declare function preflightSubscriptionsMoneyMinorUnits(db: DatabaseInterface, options?: {
+    scale?: number;
+    engineHint?: string;
+}): Promise<MinorUnitsPreflightResult>;
+/**
+ * Convert every subscriptions money column from floating-point major units to
+ * integer minor units. Idempotent via a `_smrt_backfills` marker.
+ *
+ * @throws `MinorUnitsPreflightError` when a row would be rounded or would
+ *   overflow `int4` and `force` was not set.
+ */
+export declare function migrateSubscriptionsMoneyToMinorUnits(db: DatabaseInterface, options?: {
+    scale?: number;
+    engineHint?: string;
+    force?: boolean;
+}): Promise<MinorUnitsRescaleResult>;
+//# sourceMappingURL=moneyMinorUnits.d.ts.map

package/dist/migrations/moneyMinorUnits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moneyMinorUnits.d.ts","sourceRoot":"","sources":["../../src/migrations/moneyMinorUnits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EAGvB,MAAM,qCAAqC,CAAC;AAE7C,qEAAqE;AACrE,eAAO,MAAM,wCAAwC,2DACK,CAAC;AAE3D;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,EAAE,iBAAiB,EAK1D,CAAC;AAEF;;;GAGG;AACH,wBAAgB,qCAAqC,CACnD,EAAE,EAAE,iBAAiB,EACrB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACpD,OAAO,CAAC,yBAAyB,CAAC,CAEpC;AAED;;;;;;GAMG;AACH,wBAAgB,qCAAqC,CACnD,EAAE,EAAE,iBAAiB,EACrB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GACrE,OAAO,CAAC,uBAAuB,CAAC,CAMlC"}

package/dist/models/SubscriptionPlan.d.ts

@@ -7,6 +7,11 @@ export declare class SubscriptionPlan extends SmrtObject {
     description: string;
     status: SubscriptionPlanStatus;
     sortOrder: number;
+    /**
+     * Plan price in **integer minor units** of {@link currency} — `$19.99` is
+     * `1999`. The `= 0` initializer is load-bearing: SMRT maps an integer literal
+     * to INTEGER and a decimal literal to DECIMAL, and money is exact (#2401).
+     */
     priceAmount: number;
     currency: string;
     billingInterval: BillingInterval;

package/dist/models/SubscriptionPlan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SubscriptionPlan.d.ts","sourceRoot":"","sources":["../../src/models/SubscriptionPlan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AAE5D,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,aAAa,CAAC;AAQrB,qBAQa,gBAAiB,SAAQ,UAAU;IAE9C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B,OAAO,EAAE,MAAM,CAAM;IACrB,IAAI,EAAE,MAAM,CAAM;IAClB,WAAW,EAAE,MAAM,CAAM;IACzB,MAAM,EAAE,sBAAsB,CAAY;IAC1C,SAAS,EAAE,MAAM,CAAK;IACtB,WAAW,EAAE,MAAM,CAAO;IAC1B,QAAQ,EAAE,MAAM,CAAS;IACzB,eAAe,EAAE,eAAe,CAAW;IAC3C,gBAAgB,EAAE,MAAM,CAAY;IACpC,eAAe,EAAE,MAAM,CAAM;IAC7B,aAAa,EAAE,MAAM,CAAM;IAC3B,QAAQ,EAAE,MAAM,CAAQ;IACxB,UAAU,EAAE,MAAM,CAAQ;IAC1B,QAAQ,EAAE,MAAM,CAAQ;gBAEZ,OAAO,GAAE,uBAA4B;IA6BjD,QAAQ,IAAI,OAAO;IAInB,gBAAgB,IAAI,gBAAgB,EAAE;IAMtC,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,gBAAgB,CAAC,GAAG,IAAI;IAIhE,cAAc,IAAI,MAAM,EAAE;IAM1B,aAAa,IAAI,aAAa,EAAE;IAMhC,aAAa,CAAC,UAAU,EAAE,aAAa,EAAE,GAAG,IAAI;IAIhD,WAAW,IAAI,UAAU;IAIzB,WAAW,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI;CAGxC;AAED,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"SubscriptionPlan.d.ts","sourceRoot":"","sources":["../../src/models/SubscriptionPlan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AAE5D,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,aAAa,CAAC;AAQrB,qBAQa,gBAAiB,SAAQ,UAAU;IAE9C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B,OAAO,EAAE,MAAM,CAAM;IACrB,IAAI,EAAE,MAAM,CAAM;IAClB,WAAW,EAAE,MAAM,CAAM;IACzB,MAAM,EAAE,sBAAsB,CAAY;IAC1C,SAAS,EAAE,MAAM,CAAK;IACtB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAK;IACxB,QAAQ,EAAE,MAAM,CAAS;IACzB,eAAe,EAAE,eAAe,CAAW;IAC3C,gBAAgB,EAAE,MAAM,CAAY;IACpC,eAAe,EAAE,MAAM,CAAM;IAC7B,aAAa,EAAE,MAAM,CAAM;IAC3B,QAAQ,EAAE,MAAM,CAAQ;IACxB,UAAU,EAAE,MAAM,CAAQ;IAC1B,QAAQ,EAAE,MAAM,CAAQ;gBAEZ,OAAO,GAAE,uBAA4B;IA6BjD,QAAQ,IAAI,OAAO;IAInB,gBAAgB,IAAI,gBAAgB,EAAE;IAMtC,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,gBAAgB,CAAC,GAAG,IAAI;IAIhE,cAAc,IAAI,MAAM,EAAE;IAM1B,aAAa,IAAI,aAAa,EAAE;IAMhC,aAAa,CAAC,UAAU,EAAE,aAAa,EAAE,GAAG,IAAI;IAIhD,WAAW,IAAI,UAAU;IAIzB,WAAW,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI;CAGxC;AAED,eAAe,gBAAgB,CAAC"}

package/dist/models/commercial.d.ts

@@ -28,7 +28,19 @@ export declare class ClientCharge extends SmrtObject {
     provider: string;
     serviceKey: string;
     metricKey: string;
+    /**
+     * Metered quantity — genuinely fractional (`duration.seconds`, token counts
+     * scaled by a rate), so it stays DECIMAL.
+     */
     quantity: number;
+    /**
+     * Charge in **integer minor units** of {@link currency} (#2401).
+     *
+     * Summed against {@link BillingAdjustment.amount} and compared against
+     * {@link SpendingPolicy.limitAmount}, so all three carry the same unit —
+     * `CommercialService.calculateAmount()` rounds to a whole minor unit at the
+     * one boundary where the fractional pricing terms meet money.
+     */
     amount: number;
     currency: string;
     pricingRuleId: string;
@@ -41,6 +53,12 @@ export declare class ClientCharge extends SmrtObject {
 export declare class BillingAdjustment extends SmrtObject {
     tenantId?: string;
     clientChargeId: string;
+    /**
+     * Signed correction in **integer minor units**, same unit as
+     * {@link ClientCharge.amount} it adjusts. Negative values are legitimate
+     * (a credit) — that is why the non-negative guard in
+     * `CommercialService.calculateAmount()` does not apply here (#2401).
+     */
     amount: number;
     currency: string;
     reason: string;
@@ -59,6 +77,11 @@ export declare class SpendingPolicy extends SmrtObject {
     metricKey: string;
     period: SpendingPeriod;
     rollingSeconds: number;
+    /**
+     * Spending cap in **integer minor units** of {@link currency}. Compared
+     * directly against the sum of `ClientCharge.amount` + `BillingAdjustment`s
+     * plus the caller's estimate, so it must carry the same unit (#2401).
+     */
     limitAmount: number;
     currency: string;
     behavior: SpendingPolicyBehavior;