@paid-ai/paid-node 1.7.0 → 1.8.0

package/dist/esm/api/resources/valueMetrics/client/Client.d.mts

@@ -0,0 +1,111 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.mjs";
+import * as core from "../../../../core/index.mjs";
+import * as Paid from "../../../index.mjs";
+export declare namespace ValueMetrics {
+    interface Options extends BaseClientOptions {
+    }
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class ValueMetrics {
+    protected readonly _options: ValueMetrics.Options;
+    constructor(_options: ValueMetrics.Options);
+    /**
+     * Returns the value metrics in the current value model, without their formulas. Archived metrics are hidden unless includeArchived is true.
+     *
+     * @param {Paid.ListValueMetricsRequest} request
+     * @param {ValueMetrics.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.valueMetrics.listValueMetrics()
+     */
+    listValueMetrics(request?: Paid.ListValueMetricsRequest, requestOptions?: ValueMetrics.RequestOptions): core.HttpResponsePromise<Paid.ValueMetricListResponse>;
+    private __listValueMetrics;
+    /**
+     * Adds one value metric — its unit, formula, signal binding and optional monetary conversion — to the value model. The signal must already exist: an event name your organization has sent, or one referenced by usage pricing on an active product. Publishes a new value model version and recalculates delivered value for historical signals.
+     *
+     * @param {Paid.CreateValueMetricRequest} request
+     * @param {ValueMetrics.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.ConflictError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.valueMetrics.createValueMetric({
+     *         name: "Time saved",
+     *         unit: {
+     *             type: "monetary"
+     *         },
+     *         formula: {
+     *             expression: "minutes_saved / 60",
+     *             variables: [{
+     *                     id: "id",
+     *                     label: "label"
+     *                 }]
+     *         },
+     *         signal: {
+     *             eventName: "ticket_resolved"
+     *         }
+     *     })
+     */
+    createValueMetric(request: Paid.CreateValueMetricRequest, requestOptions?: ValueMetrics.RequestOptions): core.HttpResponsePromise<Paid.ValueMetricWriteAck>;
+    private __createValueMetric;
+    /**
+     * Returns one value metric with its formula, signal binding and monetary conversion joined together. Call getCurrentValueModel if you need the active version number to guard a follow-up write.
+     *
+     * @param {Paid.GetValueMetricRequest} request
+     * @param {ValueMetrics.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.valueMetrics.getValueMetric({
+     *         slug: "slug"
+     *     })
+     */
+    getValueMetric(request: Paid.GetValueMetricRequest, requestOptions?: ValueMetrics.RequestOptions): core.HttpResponsePromise<Paid.ValueMetricDetail>;
+    private __getValueMetric;
+    /**
+     * Marks a value metric archived so it stops appearing in listValueMetrics. Its formula and signal bindings are deliberately kept, so historical delivered value and sealed value receipts still resolve — which also means an archived metric's signals continue to be ingested and can still surface on value receipts. Removing it from receipts entirely requires deleting its signal bindings. Restore it with updateValueMetric and archivedAt null.
+     *
+     * @param {Paid.ArchiveValueMetricRequest} request
+     * @param {ValueMetrics.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.ConflictError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.valueMetrics.archiveValueMetric({
+     *         slug: "slug"
+     *     })
+     */
+    archiveValueMetric(request: Paid.ArchiveValueMetricRequest, requestOptions?: ValueMetrics.RequestOptions): core.HttpResponsePromise<Paid.ValueMetricWriteAck>;
+    private __archiveValueMetric;
+    /**
+     * Changes one value metric. Omitted fields are left alone. You can change its name, category, unit, customer-facing copy, sources, monetary rate, archive state, and the value, label or display format of any variable its formula declares. The formula expression and the signal it is bound to cannot be changed — recreate the metric, or use the whole value-model upload. Publishes a new value model version.
+     *
+     * @param {Paid.UpdateValueMetricRequest} request
+     * @param {ValueMetrics.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.ConflictError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.valueMetrics.updateValueMetric({
+     *         slug: "slug"
+     *     })
+     */
+    updateValueMetric(request: Paid.UpdateValueMetricRequest, requestOptions?: ValueMetrics.RequestOptions): core.HttpResponsePromise<Paid.ValueMetricWriteAck>;
+    private __updateValueMetric;
+    protected _getAuthorizationHeader(): Promise<string>;
+}

package/dist/esm/api/resources/valueMetrics/client/Client.mjs

@@ -0,0 +1,409 @@
+// This file was auto-generated by Fern from our API Definition.
+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());
+    });
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import { mergeHeaders, mergeOnlyDefinedHeaders } from "../../../../core/headers.mjs";
+import * as core from "../../../../core/index.mjs";
+import * as environments from "../../../../environments.mjs";
+import * as errors from "../../../../errors/index.mjs";
+import * as Paid from "../../../index.mjs";
+export class ValueMetrics {
+    constructor(_options) {
+        this._options = _options;
+    }
+    /**
+     * Returns the value metrics in the current value model, without their formulas. Archived metrics are hidden unless includeArchived is true.
+     *
+     * @param {Paid.ListValueMetricsRequest} request
+     * @param {ValueMetrics.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.valueMetrics.listValueMetrics()
+     */
+    listValueMetrics(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__listValueMetrics(request, requestOptions));
+    }
+    __listValueMetrics() {
+        return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            const { limit, offset, includeArchived } = request;
+            const _queryParams = {};
+            if (limit != null) {
+                _queryParams.limit = limit.toString();
+            }
+            if (offset != null) {
+                _queryParams.offset = offset.toString();
+            }
+            if (includeArchived != null) {
+                _queryParams.includeArchived = includeArchived.toString();
+            }
+            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, 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, "value-metrics/"),
+                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 404:
+                        throw new Paid.NotFoundError(_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 /value-metrics/.");
+                case "unknown":
+                    throw new errors.PaidError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Adds one value metric — its unit, formula, signal binding and optional monetary conversion — to the value model. The signal must already exist: an event name your organization has sent, or one referenced by usage pricing on an active product. Publishes a new value model version and recalculates delivered value for historical signals.
+     *
+     * @param {Paid.CreateValueMetricRequest} request
+     * @param {ValueMetrics.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.ConflictError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.valueMetrics.createValueMetric({
+     *         name: "Time saved",
+     *         unit: {
+     *             type: "monetary"
+     *         },
+     *         formula: {
+     *             expression: "minutes_saved / 60",
+     *             variables: [{
+     *                     id: "id",
+     *                     label: "label"
+     *                 }]
+     *         },
+     *         signal: {
+     *             eventName: "ticket_resolved"
+     *         }
+     *     })
+     */
+    createValueMetric(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__createValueMetric(request, requestOptions));
+    }
+    __createValueMetric(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, 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, "value-metrics/"),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: request,
+                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 404:
+                        throw new Paid.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 409:
+                        throw new Paid.ConflictError(_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 POST /value-metrics/.");
+                case "unknown":
+                    throw new errors.PaidError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Returns one value metric with its formula, signal binding and monetary conversion joined together. Call getCurrentValueModel if you need the active version number to guard a follow-up write.
+     *
+     * @param {Paid.GetValueMetricRequest} request
+     * @param {ValueMetrics.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.valueMetrics.getValueMetric({
+     *         slug: "slug"
+     *     })
+     */
+    getValueMetric(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getValueMetric(request, requestOptions));
+    }
+    __getValueMetric(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            const { slug } = request;
+            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, 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, `value-metrics/${core.url.encodePathParam(slug)}`),
+                method: "GET",
+                headers: _headers,
+                queryParameters: 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 404:
+                        throw new Paid.NotFoundError(_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 /value-metrics/{slug}.");
+                case "unknown":
+                    throw new errors.PaidError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Marks a value metric archived so it stops appearing in listValueMetrics. Its formula and signal bindings are deliberately kept, so historical delivered value and sealed value receipts still resolve — which also means an archived metric's signals continue to be ingested and can still surface on value receipts. Removing it from receipts entirely requires deleting its signal bindings. Restore it with updateValueMetric and archivedAt null.
+     *
+     * @param {Paid.ArchiveValueMetricRequest} request
+     * @param {ValueMetrics.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.ConflictError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.valueMetrics.archiveValueMetric({
+     *         slug: "slug"
+     *     })
+     */
+    archiveValueMetric(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__archiveValueMetric(request, requestOptions));
+    }
+    __archiveValueMetric(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            const { slug, expectedActiveVersion } = request;
+            const _queryParams = {};
+            if (expectedActiveVersion != null) {
+                _queryParams.expectedActiveVersion = expectedActiveVersion.toString();
+            }
+            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, 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, `value-metrics/${core.url.encodePathParam(slug)}`),
+                method: "DELETE",
+                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 404:
+                        throw new Paid.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 409:
+                        throw new Paid.ConflictError(_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 DELETE /value-metrics/{slug}.");
+                case "unknown":
+                    throw new errors.PaidError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Changes one value metric. Omitted fields are left alone. You can change its name, category, unit, customer-facing copy, sources, monetary rate, archive state, and the value, label or display format of any variable its formula declares. The formula expression and the signal it is bound to cannot be changed — recreate the metric, or use the whole value-model upload. Publishes a new value model version.
+     *
+     * @param {Paid.UpdateValueMetricRequest} request
+     * @param {ValueMetrics.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.ConflictError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.valueMetrics.updateValueMetric({
+     *         slug: "slug"
+     *     })
+     */
+    updateValueMetric(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__updateValueMetric(request, requestOptions));
+    }
+    __updateValueMetric(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            const { slug } = request, _body = __rest(request, ["slug"]);
+            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, 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, `value-metrics/${core.url.encodePathParam(slug)}`),
+                method: "PATCH",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: _body,
+                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 404:
+                        throw new Paid.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 409:
+                        throw new Paid.ConflictError(_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 PATCH /value-metrics/{slug}.");
+                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)}`;
+        });
+    }
+}

package/dist/esm/api/resources/valueMetrics/client/index.d.mts

@@ -0,0 +1 @@
+export * from "./requests/index.mjs";

package/dist/esm/api/resources/valueMetrics/client/index.mjs

@@ -0,0 +1 @@
+export * from "./requests/index.mjs";

package/dist/esm/api/resources/valueMetrics/client/requests/ArchiveValueMetricRequest.d.mts

@@ -0,0 +1,10 @@
+/**
+ * @example
+ *     {
+ *         slug: "slug"
+ *     }
+ */
+export interface ArchiveValueMetricRequest {
+    slug: string;
+    expectedActiveVersion?: number;
+}

package/dist/esm/api/resources/valueMetrics/client/requests/ArchiveValueMetricRequest.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/valueMetrics/client/requests/CreateValueMetricRequest.d.mts

@@ -0,0 +1,57 @@
+import type * as Paid from "../../../../index.mjs";
+/**
+ * @example
+ *     {
+ *         name: "Time saved",
+ *         unit: {
+ *             type: "monetary"
+ *         },
+ *         formula: {
+ *             expression: "minutes_saved / 60",
+ *             variables: [{
+ *                     id: "id",
+ *                     label: "label"
+ *                 }]
+ *         },
+ *         signal: {
+ *             eventName: "ticket_resolved"
+ *         }
+ *     }
+ */
+export interface CreateValueMetricRequest {
+    /** Customer-facing metric name. */
+    name: string;
+    /** Stable identifier. Derived from the name when omitted. */
+    slug?: string;
+    unit: Paid.ValueMetricUnit;
+    monetaryConversion?: Paid.ValueMetricMonetaryConversion | null;
+    formula: Paid.ValueMetricFormula;
+    signal: Paid.ValueMetricSignalBinding;
+    /** Classification: hve = human value equivalent, time = time saved, cost = cost savings, revenue = revenue generated, risk = risk avoided. */
+    category?: CreateValueMetricRequest.Category | null;
+    /** Short customer-facing copy shown on value receipts. */
+    description?: string | null;
+    longDescription?: string | null;
+    /** Up to 3 customer-facing citations backing this metric. */
+    sources?: CreateValueMetricRequest.Sources.Item[] | null;
+    /** Optimistic concurrency guard. When supplied and it does not match the live active version, the request fails with 409 instead of overwriting a concurrent change. */
+    expectedActiveVersion?: number;
+}
+export declare namespace CreateValueMetricRequest {
+    /** Classification: hve = human value equivalent, time = time saved, cost = cost savings, revenue = revenue generated, risk = risk avoided. */
+    const Category: {
+        readonly Hve: "hve";
+        readonly Time: "time";
+        readonly Cost: "cost";
+        readonly Revenue: "revenue";
+        readonly Risk: "risk";
+    };
+    type Category = (typeof Category)[keyof typeof Category];
+    type Sources = Sources.Item[];
+    namespace Sources {
+        interface Item {
+            name: string;
+            url: string;
+        }
+    }
+}

package/dist/esm/api/resources/valueMetrics/client/requests/CreateValueMetricRequest.mjs

@@ -0,0 +1,12 @@
+// This file was auto-generated by Fern from our API Definition.
+export var CreateValueMetricRequest;
+(function (CreateValueMetricRequest) {
+    /** Classification: hve = human value equivalent, time = time saved, cost = cost savings, revenue = revenue generated, risk = risk avoided. */
+    CreateValueMetricRequest.Category = {
+        Hve: "hve",
+        Time: "time",
+        Cost: "cost",
+        Revenue: "revenue",
+        Risk: "risk",
+    };
+})(CreateValueMetricRequest || (CreateValueMetricRequest = {}));

package/dist/esm/api/resources/valueMetrics/client/requests/GetValueMetricRequest.d.mts

@@ -0,0 +1,9 @@
+/**
+ * @example
+ *     {
+ *         slug: "slug"
+ *     }
+ */
+export interface GetValueMetricRequest {
+    slug: string;
+}

package/dist/esm/api/resources/valueMetrics/client/requests/GetValueMetricRequest.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/valueMetrics/client/requests/ListValueMetricsRequest.d.mts

@@ -0,0 +1,10 @@
+/**
+ * @example
+ *     {}
+ */
+export interface ListValueMetricsRequest {
+    limit?: number;
+    offset?: number;
+    /** Whether to include archived metrics in the response. Defaults to false. */
+    includeArchived?: boolean;
+}

package/dist/esm/api/resources/valueMetrics/client/requests/ListValueMetricsRequest.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};