feat(balances): support pooled customer check and track

.gitignore

@@ -157,6 +157,7 @@ server/.turbo
 notes.txt
 server/experiments/results/*
 !server/experiments/results/.gitkeep
+server/experiments/out/getFullSubject-*
 
 # Leaf contract fixtures are synced from private S3.
 apps/leaf/contracts/

apps/docs/mintlify/api-reference/billing/attach.mdx

@@ -506,7 +506,7 @@ A customer who has paid is locked to their currency: passing a different one, or
             </DynamicParamField>
 
             <DynamicParamField body="purchase_limit" type="object">
-              Optional rate limit to cap how often auto top-ups occur.
+              Optional rate limit to cap how often auto top-ups occur. Pass count to set the current window's consumed top-ups.
               <Expandable title="properties">
                 <DynamicParamField body="interval" type="'hour' | 'day' | 'week' | 'month'" required>
                   The time interval for the purchase limit window.
@@ -520,6 +520,10 @@ A customer who has paid is locked to their currency: passing a different one, or
                   Maximum number of auto top-ups allowed within the interval.
                 </DynamicParamField>
 
+                <DynamicParamField body="count" type="number">
+                  Set the current window's consumed auto top-up count. Omit to leave runtime state unchanged.
+                </DynamicParamField>
+
               </Expandable>
             </DynamicParamField>
 

apps/docs/mintlify/api-reference/billing/billingUpdate.mdx

@@ -467,7 +467,7 @@ const response = await autumn.billing.update({
             </DynamicParamField>
 
             <DynamicParamField body="purchase_limit" type="object">
-              Optional rate limit to cap how often auto top-ups occur.
+              Optional rate limit to cap how often auto top-ups occur. Pass count to set the current window's consumed top-ups.
               <Expandable title="properties">
                 <DynamicParamField body="interval" type="'hour' | 'day' | 'week' | 'month'" required>
                   The time interval for the purchase limit window.
@@ -481,6 +481,10 @@ const response = await autumn.billing.update({
                   Maximum number of auto top-ups allowed within the interval.
                 </DynamicParamField>
 
+                <DynamicParamField body="count" type="number">
+                  Set the current window's consumed auto top-up count. Omit to leave runtime state unchanged.
+                </DynamicParamField>
+
               </Expandable>
             </DynamicParamField>
 

apps/docs/mintlify/api-reference/billing/createSchedule.mdx

@@ -459,7 +459,7 @@ import { DynamicResponseExample } from "/snippets/dynamic-response-example.jsx";
                     </DynamicParamField>
 
                     <DynamicParamField body="purchase_limit" type="object">
-                      Optional rate limit to cap how often auto top-ups occur.
+                      Optional rate limit to cap how often auto top-ups occur. Pass count to set the current window's consumed top-ups.
                       <Expandable title="properties">
                         <DynamicParamField body="interval" type="'hour' | 'day' | 'week' | 'month'" required>
                           The time interval for the purchase limit window.
@@ -473,6 +473,10 @@ import { DynamicResponseExample } from "/snippets/dynamic-response-example.jsx";
                           Maximum number of auto top-ups allowed within the interval.
                         </DynamicParamField>
 
+                        <DynamicParamField body="count" type="number">
+                          Set the current window's consumed auto top-up count. Omit to leave runtime state unchanged.
+                        </DynamicParamField>
+
                       </Expandable>
                     </DynamicParamField>
 

apps/docs/mintlify/api-reference/billing/import.mdx

@@ -982,7 +982,7 @@ import { DynamicResponseExample } from "/snippets/dynamic-response-example.jsx";
                             </DynamicResponseField>
 
                             <DynamicResponseField name="purchase_limit" type="object">
-                              Optional rate limit to cap how often auto top-ups occur.
+                              Optional rate limit to cap how often auto top-ups occur. Pass count to set the current window's consumed top-ups.
                               <Expandable title="properties">
                                 <DynamicResponseField name="interval" type="'hour' | 'day' | 'week' | 'month'">
                                   The time interval for the purchase limit window.
@@ -996,6 +996,10 @@ import { DynamicResponseExample } from "/snippets/dynamic-response-example.jsx";
                                   Maximum number of auto top-ups allowed within the interval.
                                 </DynamicResponseField>
 
+                                <DynamicResponseField name="count" type="number">
+                                  Set the current window's consumed auto top-up count. Omit to leave runtime state unchanged.
+                                </DynamicResponseField>
+
                               </Expandable>
                             </DynamicResponseField>
 
@@ -1917,7 +1921,7 @@ import { DynamicResponseExample } from "/snippets/dynamic-response-example.jsx";
                             </DynamicResponseField>
 
                             <DynamicResponseField name="purchase_limit" type="object">
-                              Optional rate limit to cap how often auto top-ups occur.
+                              Optional rate limit to cap how often auto top-ups occur. Pass count to set the current window's consumed top-ups.
                               <Expandable title="properties">
                                 <DynamicResponseField name="interval" type="'hour' | 'day' | 'week' | 'month'">
                                   The time interval for the purchase limit window.
@@ -1931,6 +1935,10 @@ import { DynamicResponseExample } from "/snippets/dynamic-response-example.jsx";
                                   Maximum number of auto top-ups allowed within the interval.
                                 </DynamicResponseField>
 
+                                <DynamicResponseField name="count" type="number">
+                                  Set the current window's consumed auto top-up count. Omit to leave runtime state unchanged.
+                                </DynamicResponseField>
+
                               </Expandable>
                             </DynamicResponseField>
 

apps/docs/mintlify/api-reference/billing/multiAttach.mdx

@@ -377,7 +377,7 @@ import { DynamicResponseExample } from "/snippets/dynamic-response-example.jsx";
             </DynamicParamField>
 
             <DynamicParamField body="purchase_limit" type="object">
-              Optional rate limit to cap how often auto top-ups occur.
+              Optional rate limit to cap how often auto top-ups occur. Pass count to set the current window's consumed top-ups.
               <Expandable title="properties">
                 <DynamicParamField body="interval" type="'hour' | 'day' | 'week' | 'month'" required>
                   The time interval for the purchase limit window.
@@ -391,6 +391,10 @@ import { DynamicResponseExample } from "/snippets/dynamic-response-example.jsx";
                   Maximum number of auto top-ups allowed within the interval.
                 </DynamicParamField>
 
+                <DynamicParamField body="count" type="number">
+                  Set the current window's consumed auto top-up count. Omit to leave runtime state unchanged.
+                </DynamicParamField>
+
               </Expandable>
             </DynamicParamField>
 

apps/docs/mintlify/api-reference/billing/previewAttach.mdx

@@ -433,7 +433,7 @@ import { DynamicResponseExample } from "/snippets/dynamic-response-example.jsx";
             </DynamicParamField>
 
             <DynamicParamField body="purchase_limit" type="object">
-              Optional rate limit to cap how often auto top-ups occur.
+              Optional rate limit to cap how often auto top-ups occur. Pass count to set the current window's consumed top-ups.
               <Expandable title="properties">
                 <DynamicParamField body="interval" type="'hour' | 'day' | 'week' | 'month'" required>
                   The time interval for the purchase limit window.
@@ -447,6 +447,10 @@ import { DynamicResponseExample } from "/snippets/dynamic-response-example.jsx";
                   Maximum number of auto top-ups allowed within the interval.
                 </DynamicParamField>
 
+                <DynamicParamField body="count" type="number">
+                  Set the current window's consumed auto top-up count. Omit to leave runtime state unchanged.
+                </DynamicParamField>
+
               </Expandable>
             </DynamicParamField>
 
@@ -1687,7 +1691,7 @@ import { DynamicResponseExample } from "/snippets/dynamic-response-example.jsx";
                         </DynamicResponseField>
 
                         <DynamicResponseField name="purchase_limit" type="object">
-                          Optional rate limit to cap how often auto top-ups occur.
+                          Optional rate limit to cap how often auto top-ups occur. Pass count to set the current window's consumed top-ups.
                           <Expandable title="properties">
                             <DynamicResponseField name="interval" type="'hour' | 'day' | 'week' | 'month'">
                               The time interval for the purchase limit window.
@@ -1701,6 +1705,10 @@ import { DynamicResponseExample } from "/snippets/dynamic-response-example.jsx";
                               Maximum number of auto top-ups allowed within the interval.
                             </DynamicResponseField>
 
+                            <DynamicResponseField name="count" type="number">
+                              Set the current window's consumed auto top-up count. Omit to leave runtime state unchanged.
+                            </DynamicResponseField>
+
                           </Expandable>
                         </DynamicResponseField>
 
@@ -2600,7 +2608,7 @@ import { DynamicResponseExample } from "/snippets/dynamic-response-example.jsx";
                         </DynamicResponseField>
 
                         <DynamicResponseField name="purchase_limit" type="object">
-                          Optional rate limit to cap how often auto top-ups occur.
+                          Optional rate limit to cap how often auto top-ups occur. Pass count to set the current window's consumed top-ups.
                           <Expandable title="properties">
                             <DynamicResponseField name="interval" type="'hour' | 'day' | 'week' | 'month'">
                               The time interval for the purchase limit window.
@@ -2614,6 +2622,10 @@ import { DynamicResponseExample } from "/snippets/dynamic-response-example.jsx";
                               Maximum number of auto top-ups allowed within the interval.
                             </DynamicResponseField>
 
+                            <DynamicResponseField name="count" type="number">
+                              Set the current window's consumed auto top-up count. Omit to leave runtime state unchanged.
+                            </DynamicResponseField>
+
                           </Expandable>
                         </DynamicResponseField>
 

apps/docs/mintlify/api-reference/billing/previewMultiAttach.mdx

@@ -377,7 +377,7 @@ import { DynamicResponseExample } from "/snippets/dynamic-response-example.jsx";
             </DynamicParamField>
 
             <DynamicParamField body="purchase_limit" type="object">
-              Optional rate limit to cap how often auto top-ups occur.
+              Optional rate limit to cap how often auto top-ups occur. Pass count to set the current window's consumed top-ups.
               <Expandable title="properties">
                 <DynamicParamField body="interval" type="'hour' | 'day' | 'week' | 'month'" required>
                   The time interval for the purchase limit window.
@@ -391,6 +391,10 @@ import { DynamicResponseExample } from "/snippets/dynamic-response-example.jsx";
                   Maximum number of auto top-ups allowed within the interval.
                 </DynamicParamField>
 
+                <DynamicParamField body="count" type="number">
+                  Set the current window's consumed auto top-up count. Omit to leave runtime state unchanged.
+                </DynamicParamField>
+
               </Expandable>
             </DynamicParamField>
 
@@ -1395,7 +1399,7 @@ import { DynamicResponseExample } from "/snippets/dynamic-response-example.jsx";
                         </DynamicResponseField>
 
                         <DynamicResponseField name="purchase_limit" type="object">
-                          Optional rate limit to cap how often auto top-ups occur.
+                          Optional rate limit to cap how often auto top-ups occur. Pass count to set the current window's consumed top-ups.
                           <Expandable title="properties">
                             <DynamicResponseField name="interval" type="'hour' | 'day' | 'week' | 'month'">
                               The time interval for the purchase limit window.
@@ -1409,6 +1413,10 @@ import { DynamicResponseExample } from "/snippets/dynamic-response-example.jsx";
                               Maximum number of auto top-ups allowed within the interval.
                             </DynamicResponseField>
 
+                            <DynamicResponseField name="count" type="number">
+                              Set the current window's consumed auto top-up count. Omit to leave runtime state unchanged.
+                            </DynamicResponseField>
+
                           </Expandable>
                         </DynamicResponseField>
 
@@ -2308,7 +2316,7 @@ import { DynamicResponseExample } from "/snippets/dynamic-response-example.jsx";
                         </DynamicResponseField>
 
                         <DynamicResponseField name="purchase_limit" type="object">
-                          Optional rate limit to cap how often auto top-ups occur.
+                          Optional rate limit to cap how often auto top-ups occur. Pass count to set the current window's consumed top-ups.
                           <Expandable title="properties">
                             <DynamicResponseField name="interval" type="'hour' | 'day' | 'week' | 'month'">
                               The time interval for the purchase limit window.
@@ -2322,6 +2330,10 @@ import { DynamicResponseExample } from "/snippets/dynamic-response-example.jsx";
                               Maximum number of auto top-ups allowed within the interval.
                             </DynamicResponseField>
 
+                            <DynamicResponseField name="count" type="number">
+                              Set the current window's consumed auto top-up count. Omit to leave runtime state unchanged.
+                            </DynamicResponseField>
+
                           </Expandable>
                         </DynamicResponseField>
 

apps/docs/mintlify/api-reference/billing/previewMultiUpdate.mdx

@@ -822,7 +822,7 @@ import { DynamicResponseExample } from "/snippets/dynamic-response-example.jsx";
                             </DynamicResponseField>
 
                             <DynamicResponseField name="purchase_limit" type="object">
-                              Optional rate limit to cap how often auto top-ups occur.
+                              Optional rate limit to cap how often auto top-ups occur. Pass count to set the current window's consumed top-ups.
                               <Expandable title="properties">
                                 <DynamicResponseField name="interval" type="'hour' | 'day' | 'week' | 'month'">
                                   The time interval for the purchase limit window.
@@ -836,6 +836,10 @@ import { DynamicResponseExample } from "/snippets/dynamic-response-example.jsx";
                                   Maximum number of auto top-ups allowed within the interval.
                                 </DynamicResponseField>
 
+                                <DynamicResponseField name="count" type="number">
+                                  Set the current window's consumed auto top-up count. Omit to leave runtime state unchanged.
+                                </DynamicResponseField>
+
                               </Expandable>
                             </DynamicResponseField>
 
@@ -1735,7 +1739,7 @@ import { DynamicResponseExample } from "/snippets/dynamic-response-example.jsx";
                             </DynamicResponseField>
 
                             <DynamicResponseField name="purchase_limit" type="object">
-                              Optional rate limit to cap how often auto top-ups occur.
+                              Optional rate limit to cap how often auto top-ups occur. Pass count to set the current window's consumed top-ups.
                               <Expandable title="properties">
                                 <DynamicResponseField name="interval" type="'hour' | 'day' | 'week' | 'month'">
                                   The time interval for the purchase limit window.
@@ -1749,6 +1753,10 @@ import { DynamicResponseExample } from "/snippets/dynamic-response-example.jsx";
                                   Maximum number of auto top-ups allowed within the interval.
                                 </DynamicResponseField>
 
+                                <DynamicResponseField name="count" type="number">
+                                  Set the current window's consumed auto top-up count. Omit to leave runtime state unchanged.
+                                </DynamicResponseField>
+
                               </Expandable>
                             </DynamicResponseField>