@paid-ai/paid-node 1.8.0 → 2.0.0

package/dist/cjs/api/resources/deliveredValue/client/Client.d.ts

@@ -0,0 +1,60 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.js";
+import * as core from "../../../../core/index.js";
+import * as Paid from "../../../index.js";
+export declare namespace DeliveredValue {
+    interface Options extends BaseClientOptions {
+    }
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class DeliveredValue {
+    protected readonly _options: DeliveredValue.Options;
+    constructor(_options: DeliveredValue.Options);
+    /**
+     * Returns the value delivered to a customer over a period, computed live from your active value model on every call — per value metric: its definition, a display-ready calculation, the measured unit total, monetary total, and signal counts, plus a per-event signal breakdown. The same data a value receipt presents, without creating one — built for value dashboards and reporting. Figures always reflect the currently active value model. Shortly after you publish a model change, totals can still be priced under the previous model's rates.
+     *
+     * @param {Paid.GetDeliveredValueRequest} request
+     * @param {DeliveredValue.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.RequestTimeoutError}
+     * @throws {@link Paid.TooManyRequestsError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.deliveredValue.getDeliveredValue({
+     *         externalCustomerId: "acme-corp",
+     *         startDate: "2026-08-01",
+     *         endDate: "2026-08-31"
+     *     })
+     */
+    getDeliveredValue(request: Paid.GetDeliveredValueRequest, requestOptions?: DeliveredValue.RequestOptions): core.HttpResponsePromise<Paid.DeliveredValueResponse>;
+    private __getDeliveredValue;
+    /**
+     * Aggregates delivered value into period buckets for charting value over time, grouped by value metric, by a signal-payload key (for example, value delivered per team_id), or by the formula condition band that priced each row (for example, value delivered per workflow complexity). Any grouping can be narrowed to a single value metric, which is also what lets a dimension grouping state a unit total. Reads the same rows as GET /delivered-value, so summing every bucket's monetaryTotal matches that endpoint's total for the same customer and window. Figures always reflect the currently active value model. Shortly after you publish a model change, totals can still be priced under the previous model's rates. Grouping by band reads a figure recorded when the row was priced, so value delivered before this grouping existed reports under the "none" band until a value-model backfill re-derives it.
+     *
+     * @param {Paid.GetDeliveredValueSummaryRequest} request
+     * @param {DeliveredValue.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.RequestTimeoutError}
+     * @throws {@link Paid.TooManyRequestsError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.deliveredValue.getDeliveredValueSummary({
+     *         externalCustomerId: "acme-corp",
+     *         startDate: "2026-08-01",
+     *         endDate: "2026-08-31",
+     *         groupBy: "valueMetric",
+     *         interval: "month"
+     *     })
+     */
+    getDeliveredValueSummary(request: Paid.GetDeliveredValueSummaryRequest, requestOptions?: DeliveredValue.RequestOptions): core.HttpResponsePromise<Paid.DeliveredValueSummaryResponse>;
+    private __getDeliveredValueSummary;
+    protected _getAuthorizationHeader(): Promise<string>;
+}

package/dist/cjs/api/resources/deliveredValue/client/Client.js

@@ -0,0 +1,248 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeliveredValue = void 0;
+const headers_js_1 = require("../../../../core/headers.js");
+const core = __importStar(require("../../../../core/index.js"));
+const environments = __importStar(require("../../../../environments.js"));
+const errors = __importStar(require("../../../../errors/index.js"));
+const Paid = __importStar(require("../../../index.js"));
+class DeliveredValue {
+    constructor(_options) {
+        this._options = _options;
+    }
+    /**
+     * Returns the value delivered to a customer over a period, computed live from your active value model on every call — per value metric: its definition, a display-ready calculation, the measured unit total, monetary total, and signal counts, plus a per-event signal breakdown. The same data a value receipt presents, without creating one — built for value dashboards and reporting. Figures always reflect the currently active value model. Shortly after you publish a model change, totals can still be priced under the previous model's rates.
+     *
+     * @param {Paid.GetDeliveredValueRequest} request
+     * @param {DeliveredValue.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.RequestTimeoutError}
+     * @throws {@link Paid.TooManyRequestsError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.deliveredValue.getDeliveredValue({
+     *         externalCustomerId: "acme-corp",
+     *         startDate: "2026-08-01",
+     *         endDate: "2026-08-31"
+     *     })
+     */
+    getDeliveredValue(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getDeliveredValue(request, requestOptions));
+    }
+    __getDeliveredValue(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            const { customerId, externalCustomerId, startDate, endDate } = request;
+            const _queryParams = {};
+            if (customerId != null) {
+                _queryParams.customerId = customerId;
+            }
+            if (externalCustomerId != null) {
+                _queryParams.externalCustomerId = externalCustomerId;
+            }
+            _queryParams.startDate = startDate;
+            _queryParams.endDate = endDate;
+            const _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.PaidEnvironment.Default, "delivered-value/"),
+                method: "GET",
+                headers: _headers,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new Paid.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new Paid.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Paid.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 408:
+                        throw new Paid.RequestTimeoutError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new Paid.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new Paid.InternalServerError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.PaidError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.PaidError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.PaidTimeoutError("Timeout exceeded when calling GET /delivered-value/.");
+                case "unknown":
+                    throw new errors.PaidError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Aggregates delivered value into period buckets for charting value over time, grouped by value metric, by a signal-payload key (for example, value delivered per team_id), or by the formula condition band that priced each row (for example, value delivered per workflow complexity). Any grouping can be narrowed to a single value metric, which is also what lets a dimension grouping state a unit total. Reads the same rows as GET /delivered-value, so summing every bucket's monetaryTotal matches that endpoint's total for the same customer and window. Figures always reflect the currently active value model. Shortly after you publish a model change, totals can still be priced under the previous model's rates. Grouping by band reads a figure recorded when the row was priced, so value delivered before this grouping existed reports under the "none" band until a value-model backfill re-derives it.
+     *
+     * @param {Paid.GetDeliveredValueSummaryRequest} request
+     * @param {DeliveredValue.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.RequestTimeoutError}
+     * @throws {@link Paid.TooManyRequestsError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.deliveredValue.getDeliveredValueSummary({
+     *         externalCustomerId: "acme-corp",
+     *         startDate: "2026-08-01",
+     *         endDate: "2026-08-31",
+     *         groupBy: "valueMetric",
+     *         interval: "month"
+     *     })
+     */
+    getDeliveredValueSummary(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getDeliveredValueSummary(request, requestOptions));
+    }
+    __getDeliveredValueSummary(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            const { customerId, externalCustomerId, startDate, endDate, groupBy, dimensionKey, valueMetric, interval } = request;
+            const _queryParams = {};
+            if (customerId != null) {
+                _queryParams.customerId = customerId;
+            }
+            if (externalCustomerId != null) {
+                _queryParams.externalCustomerId = externalCustomerId;
+            }
+            _queryParams.startDate = startDate;
+            _queryParams.endDate = endDate;
+            _queryParams.groupBy = groupBy;
+            if (dimensionKey != null) {
+                _queryParams.dimensionKey = dimensionKey;
+            }
+            if (valueMetric != null) {
+                _queryParams.valueMetric = valueMetric;
+            }
+            _queryParams.interval = interval;
+            const _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.PaidEnvironment.Default, "delivered-value/summary"),
+                method: "GET",
+                headers: _headers,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new Paid.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new Paid.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Paid.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 408:
+                        throw new Paid.RequestTimeoutError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new Paid.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new Paid.InternalServerError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.PaidError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.PaidError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.PaidTimeoutError("Timeout exceeded when calling GET /delivered-value/summary.");
+                case "unknown":
+                    throw new errors.PaidError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    _getAuthorizationHeader() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return `Bearer ${yield core.Supplier.get(this._options.token)}`;
+        });
+    }
+}
+exports.DeliveredValue = DeliveredValue;

package/dist/cjs/api/resources/deliveredValue/client/requests/GetDeliveredValueRequest.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @example
+ *     {
+ *         externalCustomerId: "acme-corp",
+ *         startDate: "2026-08-01",
+ *         endDate: "2026-08-31"
+ *     }
+ */
+export interface GetDeliveredValueRequest {
+    /** The customer to compute delivered value for. Accepts a Paid customer ID or, as a fallback, your external customer ID. Mutually exclusive with externalCustomerId; exactly one is required. */
+    customerId?: string;
+    /** Your external customer ID. Mutually exclusive with customerId; exactly one is required. */
+    externalCustomerId?: string;
+    /** Period start, inclusive. Accepts an ISO 8601 date or date-time. Date-only values (e.g. 2026-06-30) are treated as UTC; date-times without an explicit timezone offset are ambiguous, so include one (e.g. 2026-06-30T00:00:00-05:00) when precision matters. */
+    startDate: string;
+    /** Period end, inclusive — a date-only value means through the end of that UTC day. Accepts an ISO 8601 date or date-time. Date-only values (e.g. 2026-06-30) are treated as UTC; date-times without an explicit timezone offset are ambiguous, so include one (e.g. 2026-06-30T00:00:00-05:00) when precision matters. */
+    endDate: string;
+}

package/dist/cjs/api/resources/deliveredValue/client/requests/GetDeliveredValueRequest.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/resources/deliveredValue/client/requests/GetDeliveredValueSummaryRequest.d.ts

@@ -0,0 +1,29 @@
+import type * as Paid from "../../../../index.js";
+/**
+ * @example
+ *     {
+ *         externalCustomerId: "acme-corp",
+ *         startDate: "2026-08-01",
+ *         endDate: "2026-08-31",
+ *         groupBy: "valueMetric",
+ *         interval: "month"
+ *     }
+ */
+export interface GetDeliveredValueSummaryRequest {
+    /** The customer to summarize delivered value for. Accepts a Paid customer ID or, as a fallback, your external customer ID. Mutually exclusive with externalCustomerId; exactly one is required. */
+    customerId?: string;
+    /** Your external customer ID. Mutually exclusive with customerId; exactly one is required. */
+    externalCustomerId?: string;
+    /** Window start, inclusive. Accepts an ISO 8601 date or date-time. Date-only values (e.g. 2026-06-30) are treated as UTC; date-times without an explicit timezone offset are ambiguous, so include one (e.g. 2026-06-30T00:00:00-05:00) when precision matters. */
+    startDate: string;
+    /** Window end, inclusive — a date-only value means through the end of that UTC day. Accepts an ISO 8601 date or date-time. Date-only values (e.g. 2026-06-30) are treated as UTC; date-times without an explicit timezone offset are ambiguous, so include one (e.g. 2026-06-30T00:00:00-05:00) when precision matters. */
+    endDate: string;
+    /** How to group the buckets. valueMetric groups by the value metric that delivered the money. dimension groups by a signal-payload key named in dimensionKey, summed across metrics unless valueMetric narrows it to one — for example, value delivered per team when your signals carry a team_id field. formulaCondition cuts each metric by the condition band that priced it, for a value model that prices in graduated bands — for example, value delivered per workflow complexity when the metric bands runs by step count. A band the window never hit still reports a zero in every period, so the series keeps its shape. signal groups by the source event, one row per period per signal the value model binds to a metric, summed across the metrics the signal feeds unless valueMetric narrows it to one — the per-event breakdown GET /delivered-value states for a whole window, cut into periods. A signal the window never fired still reports a zero in every period. */
+    groupBy: Paid.GetDeliveredValueSummaryRequestGroupBy;
+    /** The signal-payload key to group by (up to 64 letters, digits, or underscores). Required when groupBy is dimension; rejected otherwise. A signal whose payload lacks the key, or holds it empty, groups under an empty groupKey. */
+    dimensionKey?: string;
+    /** Narrow the summary to a single value metric, by slug. Every grouping accepts it: it restricts which rows are read, so the totals are that metric's alone. Under groupBy=dimension and groupBy=signal it is also what makes unitTotal stateable — one metric is one unit, where a sum across metrics is in none. Under groupBy=signal it also keeps only the signals bound to that metric as groups. An archived metric may be named; a slug the value model has never defined is rejected. */
+    valueMetric?: string;
+    /** Period bucket size. Buckets align to UTC hours, calendar days, ISO weeks (Monday start), calendar months or calendar quarters; the first and last bucket's published bounds are clipped to the requested window. The window cannot hold more than 400 buckets. */
+    interval: Paid.GetDeliveredValueSummaryRequestInterval;
+}

package/dist/cjs/api/resources/deliveredValue/client/requests/GetDeliveredValueSummaryRequest.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/resources/deliveredValue/client/requests/index.d.ts

@@ -0,0 +1,2 @@
+export type { GetDeliveredValueRequest } from "./GetDeliveredValueRequest.js";
+export type { GetDeliveredValueSummaryRequest } from "./GetDeliveredValueSummaryRequest.js";

package/dist/cjs/api/resources/{customerGroups → deliveredValue}/index.d.ts

@@ -1 +1,2 @@
 export * from "./client/index.js";
+export * from "./types/index.js";

package/dist/cjs/api/resources/{customerGroups → deliveredValue}/index.js

@@ -15,3 +15,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./client/index.js"), exports);
+__exportStar(require("./types/index.js"), exports);

package/dist/cjs/api/resources/deliveredValue/types/GetDeliveredValueSummaryRequestGroupBy.d.ts

@@ -0,0 +1,7 @@
+export declare const GetDeliveredValueSummaryRequestGroupBy: {
+    readonly ValueMetric: "valueMetric";
+    readonly Dimension: "dimension";
+    readonly FormulaCondition: "formulaCondition";
+    readonly Signal: "signal";
+};
+export type GetDeliveredValueSummaryRequestGroupBy = (typeof GetDeliveredValueSummaryRequestGroupBy)[keyof typeof GetDeliveredValueSummaryRequestGroupBy];

package/dist/cjs/api/resources/deliveredValue/types/GetDeliveredValueSummaryRequestGroupBy.js

@@ -0,0 +1,10 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetDeliveredValueSummaryRequestGroupBy = void 0;
+exports.GetDeliveredValueSummaryRequestGroupBy = {
+    ValueMetric: "valueMetric",
+    Dimension: "dimension",
+    FormulaCondition: "formulaCondition",
+    Signal: "signal",
+};

package/dist/cjs/api/resources/deliveredValue/types/GetDeliveredValueSummaryRequestInterval.d.ts

@@ -0,0 +1,8 @@
+export declare const GetDeliveredValueSummaryRequestInterval: {
+    readonly Hour: "hour";
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+};
+export type GetDeliveredValueSummaryRequestInterval = (typeof GetDeliveredValueSummaryRequestInterval)[keyof typeof GetDeliveredValueSummaryRequestInterval];

package/dist/cjs/api/resources/deliveredValue/types/GetDeliveredValueSummaryRequestInterval.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.GetDeliveredValueSummaryRequestInterval = void 0;
+exports.GetDeliveredValueSummaryRequestInterval = {
+    Hour: "hour",
+    Day: "day",
+    Week: "week",
+    Month: "month",
+    Quarter: "quarter",
+};

package/dist/cjs/api/resources/deliveredValue/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./GetDeliveredValueSummaryRequestGroupBy.js";
+export * from "./GetDeliveredValueSummaryRequestInterval.js";

package/dist/cjs/api/resources/deliveredValue/types/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./GetDeliveredValueSummaryRequestGroupBy.js"), exports);
+__exportStar(require("./GetDeliveredValueSummaryRequestInterval.js"), exports);

package/dist/cjs/api/resources/index.d.ts

@@ -14,8 +14,6 @@ export * as costs from "./costs/index.js";
 export * from "./credits/client/requests/index.js";
 export * as credits from "./credits/index.js";
 export * from "./credits/types/index.js";
-export * from "./customerGroups/client/requests/index.js";
-export * as customerGroups from "./customerGroups/index.js";
 export * from "./customerPortals/client/requests/index.js";
 export * as customerPortals from "./customerPortals/index.js";
 export * from "./customers/client/requests/index.js";
@@ -24,6 +22,9 @@ export * from "./customers/types/index.js";
 export * from "./customViewsExperimental/client/requests/index.js";
 export * as customViewsExperimental from "./customViewsExperimental/index.js";
 export * from "./customViewsExperimental/types/index.js";
+export * from "./deliveredValue/client/requests/index.js";
+export * as deliveredValue from "./deliveredValue/index.js";
+export * from "./deliveredValue/types/index.js";
 export * from "./invoices/client/requests/index.js";
 export * as invoices from "./invoices/index.js";
 export * from "./invoices/types/index.js";
@@ -45,6 +46,7 @@ export * from "./products/client/requests/index.js";
 export * as products from "./products/index.js";
 export * from "./signals/client/requests/index.js";
 export * as signals from "./signals/index.js";
+export * from "./signals/types/index.js";
 export * from "./valueMetrics/client/requests/index.js";
 export * as valueMetrics from "./valueMetrics/index.js";
 export * from "./valueModels/client/requests/index.js";

package/dist/cjs/api/resources/index.js

@@ -36,7 +36,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.webhooks = exports.valueReceipts = exports.valueModels = exports.valueMetrics = exports.signals = exports.products = exports.pricing = exports.plans = exports.payments = exports.paymentMethods = exports.paymentAllocations = exports.orders = exports.invoices = exports.customViewsExperimental = exports.customers = exports.customerPortals = exports.customerGroups = exports.credits = exports.costs = exports.contacts = exports.checkouts = exports.analyticsExperimental = exports.analytics = exports.amendments = void 0;
+exports.webhooks = exports.valueReceipts = exports.valueModels = exports.valueMetrics = exports.signals = exports.products = exports.pricing = exports.plans = exports.payments = exports.paymentMethods = exports.paymentAllocations = exports.orders = exports.invoices = exports.deliveredValue = exports.customViewsExperimental = exports.customers = exports.customerPortals = exports.credits = exports.costs = exports.contacts = exports.checkouts = exports.analyticsExperimental = exports.analytics = exports.amendments = void 0;
 __exportStar(require("./amendments/client/requests/index.js"), exports);
 exports.amendments = __importStar(require("./amendments/index.js"));
 __exportStar(require("./analytics/client/requests/index.js"), exports);
@@ -53,8 +53,6 @@ exports.costs = __importStar(require("./costs/index.js"));
 __exportStar(require("./credits/client/requests/index.js"), exports);
 exports.credits = __importStar(require("./credits/index.js"));
 __exportStar(require("./credits/types/index.js"), exports);
-__exportStar(require("./customerGroups/client/requests/index.js"), exports);
-exports.customerGroups = __importStar(require("./customerGroups/index.js"));
 __exportStar(require("./customerPortals/client/requests/index.js"), exports);
 exports.customerPortals = __importStar(require("./customerPortals/index.js"));
 __exportStar(require("./customers/client/requests/index.js"), exports);
@@ -63,6 +61,9 @@ __exportStar(require("./customers/types/index.js"), exports);
 __exportStar(require("./customViewsExperimental/client/requests/index.js"), exports);
 exports.customViewsExperimental = __importStar(require("./customViewsExperimental/index.js"));
 __exportStar(require("./customViewsExperimental/types/index.js"), exports);
+__exportStar(require("./deliveredValue/client/requests/index.js"), exports);
+exports.deliveredValue = __importStar(require("./deliveredValue/index.js"));
+__exportStar(require("./deliveredValue/types/index.js"), exports);
 __exportStar(require("./invoices/client/requests/index.js"), exports);
 exports.invoices = __importStar(require("./invoices/index.js"));
 __exportStar(require("./invoices/types/index.js"), exports);
@@ -84,6 +85,7 @@ __exportStar(require("./products/client/requests/index.js"), exports);
 exports.products = __importStar(require("./products/index.js"));
 __exportStar(require("./signals/client/requests/index.js"), exports);
 exports.signals = __importStar(require("./signals/index.js"));
+__exportStar(require("./signals/types/index.js"), exports);
 __exportStar(require("./valueMetrics/client/requests/index.js"), exports);
 exports.valueMetrics = __importStar(require("./valueMetrics/index.js"));
 __exportStar(require("./valueModels/client/requests/index.js"), exports);

package/dist/cjs/api/resources/orders/client/Client.d.ts

@@ -60,7 +60,7 @@ export declare class Orders {
     getOrderById(request: Paid.GetOrderByIdRequest, requestOptions?: Orders.RequestOptions): core.HttpResponsePromise<Paid.Order>;
     private __getOrderById;
     /**
-     * Update an order by ID
+     * Update an order by ID. creationState must equal the order's current state; activate a draft order with POST /orders/{id}/activate.
      *
      * @param {Paid.UpdateOrderRequest} request
      * @param {Orders.RequestOptions} requestOptions - Request-specific configuration.
@@ -189,5 +189,91 @@ export declare class Orders {
      */
     batchOrderSeatAssignments(request: Paid.BatchSeatAssignmentsRequest, requestOptions?: Orders.RequestOptions): core.HttpResponsePromise<Paid.BatchSeatAssignmentsResponse>;
     private __batchOrderSeatAssignments;
+    /**
+     * Creates or updates a customer, an optional contact, the products on the order, and the order with its lines, in one call. Each record is matched by its `externalId`, so you can send the same deal again after it changes in your CRM. Returns 201 Created when the order is new, and 200 OK when an existing draft order with the same `externalId` was updated. Treat both as success. Re-provisioning an order that is already active returns 409 `ORDER_ALREADY_ACTIVE`; change an active order through the amendments API instead. Amounts are whole numbers in minor currency units (cents).
+     *
+     * @param {Paid.ProvisionRequest} request
+     * @param {Orders.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.ConflictError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.orders.upsertOrderByExternalId({
+     *         "idempotency-key": "deal_88213-2026-09-30T14:05:00Z",
+     *         externalReference: {
+     *             source: "standard",
+     *             metadata: {
+     *                 "crmDealId": "deal_88213",
+     *                 "crmAccountId": "acct_4410"
+     *             }
+     *         },
+     *         customer: {
+     *             externalId: "acct_4410",
+     *             name: "Northwind Logistics",
+     *             email: "billing@northwind.example",
+     *             billingAddress: {
+     *                 line1: "200 Harbor Way",
+     *                 city: "Seattle",
+     *                 state: "WA",
+     *                 zipCode: "98101",
+     *                 country: "US"
+     *             }
+     *         },
+     *         order: {
+     *             externalId: "deal_88213",
+     *             name: "Northwind Logistics - Growth plan",
+     *             currency: "USD",
+     *             startDate: "2026-10-01T00:00:00.000Z",
+     *             lines: [{
+     *                     externalId: "deal_88213_platform",
+     *                     startDate: "2026-10-01T00:00:00.000Z",
+     *                     product: {
+     *                         externalId: "growth_plan",
+     *                         name: "Growth plan",
+     *                         attributes: [{
+     *                                 name: "Platform fee",
+     *                                 pricing: {
+     *                                     chargeType: "recurring",
+     *                                     pricingModel: "perUnit",
+     *                                     billingFrequency: "monthly",
+     *                                     billingType: "advance",
+     *                                     pricePoints: {
+     *                                         currency: "USD",
+     *                                         unitPrice: 49900
+     *                                     }
+     *                                 }
+     *                             }]
+     *                     }
+     *                 }, {
+     *                     externalId: "deal_88213_launch_discount",
+     *                     lineType: "CREDIT",
+     *                     startDate: "2026-10-01T00:00:00.000Z",
+     *                     endDate: "2027-01-01T00:00:00.000Z",
+     *                     product: {
+     *                         externalId: "launch_discount",
+     *                         name: "Launch discount",
+     *                         attributes: [{
+     *                                 name: "Launch discount",
+     *                                 pricing: {
+     *                                     chargeType: "recurring",
+     *                                     pricingModel: "perUnit",
+     *                                     billingFrequency: "monthly",
+     *                                     billingType: "advance",
+     *                                     pricePoints: {
+     *                                         currency: "USD",
+     *                                         unitPrice: 10000
+     *                                     }
+     *                                 }
+     *                             }]
+     *                     }
+     *                 }]
+     *         }
+     *     })
+     */
+    upsertOrderByExternalId(request: Paid.ProvisionRequest, requestOptions?: Orders.RequestOptions): core.HttpResponsePromise<Paid.ProvisionResponse>;
+    private __upsertOrderByExternalId;
     protected _getAuthorizationHeader(): Promise<string>;
 }