@paid-ai/paid-node 1.8.0 → 2.0.0

package/dist/cjs/api/types/SignalSummaryPresenceDimension.d.ts

@@ -0,0 +1,23 @@
+export interface SignalSummaryPresenceDimension {
+    /** Key into the signal's data payload. Dots address nested fields, for example dimensions.pages. */
+    path: string;
+    /** Signal names this dimension breaks down. Signals not listed here get one column and no breakdown. */
+    appliesTo: string[];
+    values: SignalSummaryPresenceDimension.Values;
+}
+export declare namespace SignalSummaryPresenceDimension {
+    interface Values {
+        true: Values.True;
+        false: Values.False;
+    }
+    namespace Values {
+        interface True {
+            group: string;
+            slug?: string;
+        }
+        interface False {
+            group: string;
+            slug?: string;
+        }
+    }
+}

package/dist/cjs/api/types/SignalSummaryPresenceDimension.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/SignalSummaryResponse.d.ts

@@ -0,0 +1,29 @@
+import type * as Paid from "../index.js";
+export interface SignalSummaryResponse {
+    /** Period bucket size, echoed from the query. */
+    interval: SignalSummaryResponse.Interval;
+    /** How the points are grouped. Absent when not grouped. */
+    groupBy?: SignalSummaryResponse.GroupBy;
+    /** The signal-payload key the points are grouped by, echoed from the query. Present only when groupBy is dimension. */
+    dimensionKey?: string;
+    groups?: Paid.SignalSummaryGroups;
+    /** Points ordered by period, then by group key. Only periods and groups that recorded signals appear — a period with no signals is absent rather than zero, so a chart fills its own gaps. */
+    data: Paid.SignalSummaryPoint[];
+    pagination: Paid.SignalSummaryPage;
+}
+export declare namespace SignalSummaryResponse {
+    /** Period bucket size, echoed from the query. */
+    const Interval: {
+        readonly Hour: "hour";
+        readonly Day: "day";
+        readonly Week: "week";
+        readonly Month: "month";
+    };
+    type Interval = (typeof Interval)[keyof typeof Interval];
+    /** How the points are grouped. Absent when not grouped. */
+    const GroupBy: {
+        readonly SignalName: "signalName";
+        readonly Dimension: "dimension";
+    };
+    type GroupBy = (typeof GroupBy)[keyof typeof GroupBy];
+}

package/dist/cjs/api/types/SignalSummaryResponse.js

@@ -0,0 +1,19 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SignalSummaryResponse = void 0;
+var SignalSummaryResponse;
+(function (SignalSummaryResponse) {
+    /** Period bucket size, echoed from the query. */
+    SignalSummaryResponse.Interval = {
+        Hour: "hour",
+        Day: "day",
+        Week: "week",
+        Month: "month",
+    };
+    /** How the points are grouped. Absent when not grouped. */
+    SignalSummaryResponse.GroupBy = {
+        SignalName: "signalName",
+        Dimension: "dimension",
+    };
+})(SignalSummaryResponse || (exports.SignalSummaryResponse = SignalSummaryResponse = {}));

package/dist/cjs/api/types/SignalSummarySignalSelection.d.ts

@@ -0,0 +1,8 @@
+export interface SignalSummarySignalSelection {
+    /** Signal event name, matched exactly. */
+    name: string;
+    /** Label shown in the file's first header row, above every column derived from this signal. */
+    group: string;
+    /** Fragment used to build this signal's column names. Defaults to a slugified group. */
+    slug?: string;
+}

package/dist/cjs/api/types/SignalSummarySignalSelection.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/SignalSummarySpecInput.d.ts

@@ -0,0 +1,21 @@
+import type * as Paid from "../index.js";
+/**
+ * The shape of the file: which signals to count, how to break them down, and what each column is called. Required unless copyFrom is given.
+ */
+export interface SignalSummarySpecInput {
+    name: string;
+    /** Bucket size for each row. Only monthly buckets are supported today. */
+    interval?: SignalSummarySpecInput.Interval;
+    signalNames: Paid.SignalSummarySignalSelection[];
+    dimensions?: Paid.SignalSummarySpecInputDimensionsItem[];
+    measures: Paid.SignalSummaryMeasure[];
+    /** How a column's name is composed. {signal} is the signal's slug; {dim1} and {dim2} are the slugs of the first and second dimensions that apply to it. Placeholders with no value are dropped, so a signal with no dimensions renders as its slug alone. Use this to control ordering — {dim1}_{signal}_{dim2} yields names like ticket_runs_1_step. */
+    columnNameTemplate?: string;
+}
+export declare namespace SignalSummarySpecInput {
+    /** Bucket size for each row. Only monthly buckets are supported today. */
+    const Interval: {
+        readonly Month: "month";
+    };
+    type Interval = (typeof Interval)[keyof typeof Interval];
+}

package/dist/cjs/api/types/SignalSummarySpecInput.js

@@ -0,0 +1,11 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SignalSummarySpecInput = void 0;
+var SignalSummarySpecInput;
+(function (SignalSummarySpecInput) {
+    /** Bucket size for each row. Only monthly buckets are supported today. */
+    SignalSummarySpecInput.Interval = {
+        Month: "month",
+    };
+})(SignalSummarySpecInput || (exports.SignalSummarySpecInput = SignalSummarySpecInput = {}));

package/dist/cjs/api/types/SignalSummarySpecInputDimensionsItem.d.ts

@@ -0,0 +1,10 @@
+import type * as Paid from "../index.js";
+export type SignalSummarySpecInputDimensionsItem = Paid.SignalSummarySpecInputDimensionsItem.Presence | Paid.SignalSummarySpecInputDimensionsItem.Bands;
+export declare namespace SignalSummarySpecInputDimensionsItem {
+    interface Presence extends Paid.SignalSummaryPresenceDimension {
+        kind: "presence";
+    }
+    interface Bands extends Paid.SignalSummaryBandsDimension {
+        kind: "bands";
+    }
+}

package/dist/cjs/api/types/SignalSummarySpecInputDimensionsItem.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/SignalsMetadataResponse.d.ts

@@ -15,8 +15,29 @@ export declare namespace SignalsMetadataResponse {
                 interface Item {
                     /** JSON path inside the signal `data` payload, usable in queries as e.g. `data.<path>::String`. */
                     path: string;
-                    /** ClickHouse dynamic types observed for this path. */
+                    /** ClickHouse dynamic types observed for this path within the window. */
                     types: string[];
+                    /** True when this key is declared as a grouping dimension for your organization. Declared keys are listed first. */
+                    declared: boolean;
+                    /** The dimension slot a declared key fills. Present only when `declared` is true. */
+                    slot?: Item.Slot;
+                    /** When a signal carrying this path was first received, across all time rather than only the window. Omitted when not available. */
+                    firstSeen?: string;
+                    /** When a signal carrying this path was last received, across all time rather than only the window. Omitted when not available. */
+                    lastSeen?: string;
+                    /** How many times a signal of this name has been received carrying this path, across all time rather than only the window. Each revision of an edited signal counts again and deleted signals stay counted, so read it as a measure of use rather than a count of distinct or live signals. Omitted when not available. */
+                    signals?: number;
+                }
+                namespace Item {
+                    /** The dimension slot a declared key fills. Present only when `declared` is true. */
+                    const Slot: {
+                        readonly Dim1: "dim_1";
+                        readonly Dim2: "dim_2";
+                        readonly Dim3: "dim_3";
+                        readonly Dim4: "dim_4";
+                        readonly Dim5: "dim_5";
+                    };
+                    type Slot = (typeof Slot)[keyof typeof Slot];
                 }
             }
         }

package/dist/cjs/api/types/SignalsMetadataResponse.js

@@ -1,3 +1,27 @@
 "use strict";
 // This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.SignalsMetadataResponse = void 0;
+var SignalsMetadataResponse;
+(function (SignalsMetadataResponse) {
+    let Signals;
+    (function (Signals) {
+        let Item;
+        (function (Item_1) {
+            let Paths;
+            (function (Paths) {
+                let Item;
+                (function (Item) {
+                    /** The dimension slot a declared key fills. Present only when `declared` is true. */
+                    Item.Slot = {
+                        Dim1: "dim_1",
+                        Dim2: "dim_2",
+                        Dim3: "dim_3",
+                        Dim4: "dim_4",
+                        Dim5: "dim_5",
+                    };
+                })(Item = Paths.Item || (Paths.Item = {}));
+            })(Paths = Item_1.Paths || (Item_1.Paths = {}));
+        })(Item = Signals.Item || (Signals.Item = {}));
+    })(Signals = SignalsMetadataResponse.Signals || (SignalsMetadataResponse.Signals = {}));
+})(SignalsMetadataResponse || (exports.SignalsMetadataResponse = SignalsMetadataResponse = {}));

package/dist/cjs/api/types/UpdateContactRequest.d.ts

@@ -1,5 +1,6 @@
 import type * as Paid from "../index.js";
 export interface UpdateContactRequest {
+    /** Destination customer ID. A contact can move only if no orders or invoices reference it. */
     customerId?: string;
     firstName?: string;
     lastName?: string;

package/dist/cjs/api/types/UsageBracketedPrepaidCreditsInput.d.ts

@@ -5,12 +5,15 @@ export interface UsageBracketedPrepaidCreditsInput {
     creditsCurrencyId?: string;
     unitValue?: number;
     overageUnitPrice?: number;
+    /** Overage price per credit in the currency's minor units (40 is $0.40 for USD, ¥40 for JPY, 0.040 KWD for KWD), keyed by uppercase ISO 4217 currency code. On an invoice, an entry for the invoice currency on any of the order's pricing or credit benefits beats every overageUnitPrice; overageUnitPrice applies only when no holder has an entry for that currency. Writes keep the two consistent for the primary currency (the organization's default when the product is priced in it, else the product's only pricing currency; an order line's own currency): a map entry for it sets overageUnitPrice, winning when a write sends both, and an overageUnitPrice sent without the map updates an existing entry for it. A write that sends only overageUnitPrice never creates a map. */
+    overageUnitPrices?: Record<string, number | null> | null;
     /** Credit amount, exact to at most 6 decimal places. */
     creditRolloverAmount?: number;
     pricingInput: UsageBracketedPrepaidCreditsInput.PricingInput;
     creditUnitBrackets: UsageBracketedPrepaidCreditsInput.CreditUnitBrackets.Item[];
     billingFrequency?: UsageBracketedPrepaidCreditsInput.BillingFrequency;
     billingFrequencyCustomMonths?: number;
+    /** When usage is billed. Usage must use Arrears, prepaid credits included; to sell credits up front, add a credit benefit to a recurring, seat or one-time attribute. */
     billingType?: UsageBracketedPrepaidCreditsInput.BillingType;
     pricePoints?: Paid.SimplePricePoint[];
 }
@@ -49,6 +52,7 @@ export declare namespace UsageBracketedPrepaidCreditsInput {
         readonly Custom: "Custom";
     };
     type BillingFrequency = (typeof BillingFrequency)[keyof typeof BillingFrequency];
+    /** When usage is billed. Usage must use Arrears, prepaid credits included; to sell credits up front, add a credit benefit to a recurring, seat or one-time attribute. */
     const BillingType: {
         readonly Advance: "Advance";
         readonly Arrears: "Arrears";

package/dist/cjs/api/types/UsageBracketedPrepaidCreditsInput.js

@@ -21,6 +21,7 @@ var UsageBracketedPrepaidCreditsInput;
         Annual: "Annual",
         Custom: "Custom",
     };
+    /** When usage is billed. Usage must use Arrears, prepaid credits included; to sell credits up front, add a credit benefit to a recurring, seat or one-time attribute. */
     UsageBracketedPrepaidCreditsInput.BillingType = {
         Advance: "Advance",
         Arrears: "Arrears",

package/dist/cjs/api/types/UsageCostPlusInput.d.ts

@@ -4,6 +4,7 @@ export interface UsageCostPlusInput {
     signalType?: UsageCostPlusInput.SignalType;
     billingFrequency?: UsageCostPlusInput.BillingFrequency;
     billingFrequencyCustomMonths?: number;
+    /** When usage is billed. Usage must use Arrears, prepaid credits included; to sell credits up front, add a credit benefit to a recurring, seat or one-time attribute. */
     billingType?: UsageCostPlusInput.BillingType;
     pricePoints?: Paid.SimplePricePoint[];
 }
@@ -21,6 +22,7 @@ export declare namespace UsageCostPlusInput {
         readonly Custom: "Custom";
     };
     type BillingFrequency = (typeof BillingFrequency)[keyof typeof BillingFrequency];
+    /** When usage is billed. Usage must use Arrears, prepaid credits included; to sell credits up front, add a credit benefit to a recurring, seat or one-time attribute. */
     const BillingType: {
         readonly Advance: "Advance";
         readonly Arrears: "Arrears";

package/dist/cjs/api/types/UsageCostPlusInput.js

@@ -15,6 +15,7 @@ var UsageCostPlusInput;
         Annual: "Annual",
         Custom: "Custom",
     };
+    /** When usage is billed. Usage must use Arrears, prepaid credits included; to sell credits up front, add a credit benefit to a recurring, seat or one-time attribute. */
     UsageCostPlusInput.BillingType = {
         Advance: "Advance",
         Arrears: "Arrears",

package/dist/cjs/api/types/UsageGraduatedInput.d.ts

@@ -4,6 +4,7 @@ export interface UsageGraduatedInput {
     signalType?: UsageGraduatedInput.SignalType;
     billingFrequency?: UsageGraduatedInput.BillingFrequency;
     billingFrequencyCustomMonths?: number;
+    /** When usage is billed. Usage must use Arrears, prepaid credits included; to sell credits up front, add a credit benefit to a recurring, seat or one-time attribute. */
     billingType?: UsageGraduatedInput.BillingType;
     pricePoints: Paid.TieredPricePoint[];
 }
@@ -21,6 +22,7 @@ export declare namespace UsageGraduatedInput {
         readonly Custom: "Custom";
     };
     type BillingFrequency = (typeof BillingFrequency)[keyof typeof BillingFrequency];
+    /** When usage is billed. Usage must use Arrears, prepaid credits included; to sell credits up front, add a credit benefit to a recurring, seat or one-time attribute. */
     const BillingType: {
         readonly Advance: "Advance";
         readonly Arrears: "Arrears";

package/dist/cjs/api/types/UsageGraduatedInput.js

@@ -15,6 +15,7 @@ var UsageGraduatedInput;
         Annual: "Annual",
         Custom: "Custom",
     };
+    /** When usage is billed. Usage must use Arrears, prepaid credits included; to sell credits up front, add a credit benefit to a recurring, seat or one-time attribute. */
     UsageGraduatedInput.BillingType = {
         Advance: "Advance",
         Arrears: "Arrears",

package/dist/cjs/api/types/UsagePerUnitInput.d.ts

@@ -4,6 +4,7 @@ export interface UsagePerUnitInput {
     signalType?: UsagePerUnitInput.SignalType;
     billingFrequency?: UsagePerUnitInput.BillingFrequency;
     billingFrequencyCustomMonths?: number;
+    /** When usage is billed. Usage must use Arrears, prepaid credits included; to sell credits up front, add a credit benefit to a recurring, seat or one-time attribute. */
     billingType?: UsagePerUnitInput.BillingType;
     pricePoints: Paid.SimplePricePoint[];
 }
@@ -21,6 +22,7 @@ export declare namespace UsagePerUnitInput {
         readonly Custom: "Custom";
     };
     type BillingFrequency = (typeof BillingFrequency)[keyof typeof BillingFrequency];
+    /** When usage is billed. Usage must use Arrears, prepaid credits included; to sell credits up front, add a credit benefit to a recurring, seat or one-time attribute. */
     const BillingType: {
         readonly Advance: "Advance";
         readonly Arrears: "Arrears";

package/dist/cjs/api/types/UsagePerUnitInput.js

@@ -15,6 +15,7 @@ var UsagePerUnitInput;
         Annual: "Annual",
         Custom: "Custom",
     };
+    /** When usage is billed. Usage must use Arrears, prepaid credits included; to sell credits up front, add a credit benefit to a recurring, seat or one-time attribute. */
     UsagePerUnitInput.BillingType = {
         Advance: "Advance",
         Arrears: "Arrears",

package/dist/cjs/api/types/UsagePrepaidCreditsInput.d.ts

@@ -6,9 +6,13 @@ export interface UsagePrepaidCreditsInput {
     /** Credit amount, exact to at most 6 decimal places. */
     creditCost: number;
     unitValue?: number;
+    overageUnitPrice?: number;
+    /** Overage price per credit in the currency's minor units (40 is $0.40 for USD, ¥40 for JPY, 0.040 KWD for KWD), keyed by uppercase ISO 4217 currency code. On an invoice, an entry for the invoice currency on any of the order's pricing or credit benefits beats every overageUnitPrice; overageUnitPrice applies only when no holder has an entry for that currency. Writes keep the two consistent for the primary currency (the organization's default when the product is priced in it, else the product's only pricing currency; an order line's own currency): a map entry for it sets overageUnitPrice, winning when a write sends both, and an overageUnitPrice sent without the map updates an existing entry for it. A write that sends only overageUnitPrice never creates a map. */
+    overageUnitPrices?: Record<string, number | null> | null;
     pricingInput?: UsagePrepaidCreditsInput.PricingInput;
     billingFrequency?: UsagePrepaidCreditsInput.BillingFrequency;
     billingFrequencyCustomMonths?: number;
+    /** When usage is billed. Usage must use Arrears, prepaid credits included; to sell credits up front, add a credit benefit to a recurring, seat or one-time attribute. */
     billingType?: UsagePrepaidCreditsInput.BillingType;
     pricePoints?: Paid.SimplePricePoint[];
 }
@@ -37,6 +41,7 @@ export declare namespace UsagePrepaidCreditsInput {
         readonly Custom: "Custom";
     };
     type BillingFrequency = (typeof BillingFrequency)[keyof typeof BillingFrequency];
+    /** When usage is billed. Usage must use Arrears, prepaid credits included; to sell credits up front, add a credit benefit to a recurring, seat or one-time attribute. */
     const BillingType: {
         readonly Advance: "Advance";
         readonly Arrears: "Arrears";

package/dist/cjs/api/types/UsagePrepaidCreditsInput.js

@@ -21,6 +21,7 @@ var UsagePrepaidCreditsInput;
         Annual: "Annual",
         Custom: "Custom",
     };
+    /** When usage is billed. Usage must use Arrears, prepaid credits included; to sell credits up front, add a credit benefit to a recurring, seat or one-time attribute. */
     UsagePrepaidCreditsInput.BillingType = {
         Advance: "Advance",
         Arrears: "Arrears",

package/dist/cjs/api/types/UsageVolumeInput.d.ts

@@ -4,6 +4,7 @@ export interface UsageVolumeInput {
     signalType?: UsageVolumeInput.SignalType;
     billingFrequency?: UsageVolumeInput.BillingFrequency;
     billingFrequencyCustomMonths?: number;
+    /** When usage is billed. Usage must use Arrears, prepaid credits included; to sell credits up front, add a credit benefit to a recurring, seat or one-time attribute. */
     billingType?: UsageVolumeInput.BillingType;
     pricePoints: Paid.TieredPricePoint[];
 }
@@ -21,6 +22,7 @@ export declare namespace UsageVolumeInput {
         readonly Custom: "Custom";
     };
     type BillingFrequency = (typeof BillingFrequency)[keyof typeof BillingFrequency];
+    /** When usage is billed. Usage must use Arrears, prepaid credits included; to sell credits up front, add a credit benefit to a recurring, seat or one-time attribute. */
     const BillingType: {
         readonly Advance: "Advance";
         readonly Arrears: "Arrears";

package/dist/cjs/api/types/UsageVolumeInput.js

@@ -15,6 +15,7 @@ var UsageVolumeInput;
         Annual: "Annual",
         Custom: "Custom",
     };
+    /** When usage is billed. Usage must use Arrears, prepaid credits included; to sell credits up front, add a credit benefit to a recurring, seat or one-time attribute. */
     UsageVolumeInput.BillingType = {
         Advance: "Advance",
         Arrears: "Arrears",

package/dist/cjs/api/types/ValidateCustomViewRequest.d.ts

@@ -1,5 +1,9 @@
 import type * as Paid from "../index.js";
 export interface ValidateCustomViewRequest {
+    /** Enable customer unit navigation for a customer-scoped view. Setting true requires customer hierarchies to be enabled for your organization, and every query must support unit selection. Existing views default to false. */
+    hierarchyEnabled?: boolean;
+    /** Send the customer's unit caps to the render bundle as `context.caps`. Needs `hierarchyEnabled` on a customer-scoped view. Turn it on only for views that draw cap usage: each load then reads cap usage from billing. Caps are spend policy, so an API key also needs `read:billing` to receive them in the data (they are left out otherwise) or to mint this view's embed token. Defaults to false. */
+    capsEnabled?: boolean;
     /** Query list to validate (same shape and gates as createCustomView). */
     queries?: Paid.CustomViewQuery[];
     /** Render bundle to validate (same gates as createCustomView: size cap, self-contained, not truncated, paid:data listener). */

package/dist/cjs/api/types/ValueModelContent.d.ts

@@ -1,5 +1,5 @@
 /**
- * Full value model configuration: value types, formulas, signals, and overrides.
+ * Full value model configuration: value types, formulas, events, and overrides.
  */
 export interface ValueModelContent {
     currency: string;
@@ -19,6 +19,8 @@ export declare namespace ValueModelContent {
             description?: string | null;
             longDescription?: string | null;
             sources?: Item.Sources.Item[] | null;
+            /** Gates when this value type's number is published to a customer on a value receipt. Evaluated per customer, cumulative since their first signal for this value type, as of the receipt's end date. Until the threshold is met the receipt withholds the figure and shows a 'gathering data' state instead. At least one of minDataPoints or minMonths is required. */
+            maturation?: unknown | null;
             displayOrder?: number | null;
             color?: string | null;
             icon?: string | null;
@@ -174,6 +176,10 @@ export declare namespace ValueModelContent {
                     interface DerivedFrom {
                         sourceField: string;
                         targetUnit: DerivedFrom.TargetUnit;
+                        /** Fixed source unit the signal field reports its value in; the engine converts it into the metric's duration unit (targetUnit). Used as the fallback when sourceUnitFromSignal is set but the companion field is missing/invalid. Requires a duration value type. */
+                        sourceUnit?: DerivedFrom.SourceUnit;
+                        /** When true, each event names its own source unit in a "<sourceField>_unit" companion field (e.g. sourceField "time_spent" reads "time_spent_unit"), which must be one of seconds|minutes|hours|days. Takes precedence over sourceUnit; if the companion is absent or invalid it falls back to sourceUnit. If neither resolves, the payload value is discarded and the variable's default is used (the default is stored in the metric's unit and is never converted); the value is never silently treated as seconds. Requires a duration value type. */
+                        sourceUnitFromSignal?: boolean;
                     }
                     namespace DerivedFrom {
                         const TargetUnit: {
@@ -183,6 +189,14 @@ export declare namespace ValueModelContent {
                             readonly Days: "days";
                         };
                         type TargetUnit = (typeof TargetUnit)[keyof typeof TargetUnit];
+                        /** Fixed source unit the signal field reports its value in; the engine converts it into the metric's duration unit (targetUnit). Used as the fallback when sourceUnitFromSignal is set but the companion field is missing/invalid. Requires a duration value type. */
+                        const SourceUnit: {
+                            readonly Seconds: "seconds";
+                            readonly Minutes: "minutes";
+                            readonly Hours: "hours";
+                            readonly Days: "days";
+                        };
+                        type SourceUnit = (typeof SourceUnit)[keyof typeof SourceUnit];
                     }
                 }
             }
@@ -296,26 +310,14 @@ export declare namespace ValueModelContent {
             label: string;
             scope: Item.Scope;
             currency?: string;
-            signalOverrides?: Record<string, Item.SignalOverrides.Value>;
-            /** Per-value-metric formula variable overrides, keyed by value type slug. Scoped to the named metric's formulas only — unlike signalOverrides (keyed by event name), a binding event shared with other metrics does not leak these values into them. When both shapes set the same variable, the value here wins. */
+            /** Per-value-metric formula variable overrides, keyed by value type slug. Scoped to the named metric's formulas only, so a binding event shared with other metrics does not leak these values into them. */
             valueTypeOverrides?: Record<string, Item.ValueTypeOverrides.Value>;
             additionalSignals?: Item.AdditionalSignals.Item[];
             monetaryConversionOverrides?: Record<string, Item.MonetaryConversionOverrides.Value>;
         }
         namespace Item {
             interface Scope {
-                customerIds?: string[];
-                customerGroupIds?: string[];
-            }
-            namespace SignalOverrides {
-                interface Value {
-                    defaults?: Record<string, Value.Defaults.Value>;
-                }
-                namespace Value {
-                    namespace Defaults {
-                        type Value = number | string;
-                    }
-                }
+                customerIds: string[];
             }
             namespace ValueTypeOverrides {
                 interface Value {

package/dist/cjs/api/types/ValueModelContent.js

@@ -87,6 +87,13 @@ var ValueModelContent;
                             Hours: "hours",
                             Days: "days",
                         };
+                        /** Fixed source unit the signal field reports its value in; the engine converts it into the metric's duration unit (targetUnit). Used as the fallback when sourceUnitFromSignal is set but the companion field is missing/invalid. Requires a duration value type. */
+                        DerivedFrom.SourceUnit = {
+                            Seconds: "seconds",
+                            Minutes: "minutes",
+                            Hours: "hours",
+                            Days: "days",
+                        };
                     })(DerivedFrom = Item.DerivedFrom || (Item.DerivedFrom = {}));
                 })(Item = Variables.Item || (Variables.Item = {}));
             })(Variables = Item_3.Variables || (Item_3.Variables = {}));

package/dist/cjs/api/types/ValueReceiptDetail.d.ts

@@ -1,5 +1,6 @@
 export interface ValueReceiptDetail {
     id: string;
+    /** Always "posted": a value receipt is immutable from creation. */
     status: string;
     publicUrlToken: string;
     publicUrl: string;

package/dist/cjs/api/types/ValueReceiptSummary.d.ts

@@ -1,5 +1,6 @@
 export interface ValueReceiptSummary {
     id: string;
+    /** Always "posted": a value receipt is immutable from creation. */
     status: string;
     publicUrlToken: string;
     publicUrl: string;

package/dist/cjs/api/types/ValueReceiptSyncResponse.d.ts

@@ -1,5 +1,6 @@
 export interface ValueReceiptSyncResponse {
     id: string;
+    /** Always "posted". */
     status: string;
     publicUrlToken: string;
     publicUrl: string;

package/dist/cjs/api/types/ViewCustomerUnitsResponse.d.ts

@@ -0,0 +1,7 @@
+import type * as Paid from "../index.js";
+export interface ViewCustomerUnitsResponse {
+    /** Whether this customer has an active non-root unit, regardless of the requested page or usage. */
+    hasHierarchy: boolean;
+    data: Paid.CustomViewCustomerUnit[];
+    pagination: Paid.Pagination;
+}

package/dist/cjs/api/types/ViewCustomerUnitsResponse.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/ViewDataResponse.d.ts

@@ -1,4 +1,6 @@
+import type * as Paid from "../index.js";
 export interface ViewDataResponse {
+    context?: Paid.CustomViewDataContext;
     /** Result sets keyed by query id. Each value is an array of row objects (column name → value); 64-bit integers are returned as JSON strings to preserve precision. */
     data: Record<string, Record<string, unknown>[]>;
 }

package/dist/cjs/api/types/Webhook.d.ts

@@ -10,7 +10,6 @@ export interface Webhook {
 }
 export declare namespace Webhook {
     const Name: {
-        readonly BillingInvoiceCreated: "billing-invoice-created";
         readonly BillingInvoicePaid: "billing-invoice-paid";
         readonly BillingInvoicePosted: "billing-invoice-posted";
         readonly BillingCheckoutCreated: "billing-checkout-created";

package/dist/cjs/api/types/Webhook.js

@@ -5,7 +5,6 @@ exports.Webhook = void 0;
 var Webhook;
 (function (Webhook) {
     Webhook.Name = {
-        BillingInvoiceCreated: "billing-invoice-created",
         BillingInvoicePaid: "billing-invoice-paid",
         BillingInvoicePosted: "billing-invoice-posted",
         BillingCheckoutCreated: "billing-checkout-created",

package/dist/cjs/api/types/WebhookUpdateResponse.d.ts

@@ -12,7 +12,6 @@ export interface WebhookUpdateResponse {
 }
 export declare namespace WebhookUpdateResponse {
     const Name: {
-        readonly BillingInvoiceCreated: "billing-invoice-created";
         readonly BillingInvoicePaid: "billing-invoice-paid";
         readonly BillingInvoicePosted: "billing-invoice-posted";
         readonly BillingCheckoutCreated: "billing-checkout-created";

package/dist/cjs/api/types/WebhookUpdateResponse.js

@@ -5,7 +5,6 @@ exports.WebhookUpdateResponse = void 0;
 var WebhookUpdateResponse;
 (function (WebhookUpdateResponse) {
     WebhookUpdateResponse.Name = {
-        BillingInvoiceCreated: "billing-invoice-created",
         BillingInvoicePaid: "billing-invoice-paid",
         BillingInvoicePosted: "billing-invoice-posted",
         BillingCheckoutCreated: "billing-checkout-created",

package/dist/cjs/api/types/WritableProvisionOrderLineType.d.ts

@@ -0,0 +1,6 @@
+/** Defaults to `STANDARD`. Set to `CREDIT` for a discount or credit line: send its prices as positive amounts, and Paid subtracts them from the invoice. */
+export declare const WritableProvisionOrderLineType: {
+    readonly Standard: "STANDARD";
+    readonly Credit: "CREDIT";
+};
+export type WritableProvisionOrderLineType = (typeof WritableProvisionOrderLineType)[keyof typeof WritableProvisionOrderLineType];

package/dist/cjs/api/types/WritableProvisionOrderLineType.js

@@ -0,0 +1,9 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WritableProvisionOrderLineType = void 0;
+/** Defaults to `STANDARD`. Set to `CREDIT` for a discount or credit line: send its prices as positive amounts, and Paid subtracts them from the invoice. */
+exports.WritableProvisionOrderLineType = {
+    Standard: "STANDARD",
+    Credit: "CREDIT",
+};