orb-billing 1.0.1

package/dist/sdk/models/shared/usageitem.js

@@ -0,0 +1,63 @@
+"use strict";
+/*
+ * Code generated by Speakeasy (https://speakeasyapi.dev). DO NOT EDIT.
+ */
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UsageItem = void 0;
+var utils_1 = require("../../../internal/utils");
+var class_transformer_1 = require("class-transformer");
+var UsageItem = /** @class */ (function (_super) {
+    __extends(UsageItem, _super);
+    function UsageItem() {
+        return _super !== null && _super.apply(this, arguments) || this;
+    }
+    __decorate([
+        (0, utils_1.SpeakeasyMetadata)(),
+        (0, class_transformer_1.Expose)({ name: "quantity" }),
+        __metadata("design:type", String)
+    ], UsageItem.prototype, "quantity", void 0);
+    __decorate([
+        (0, utils_1.SpeakeasyMetadata)(),
+        (0, class_transformer_1.Expose)({ name: "timeframe_end" }),
+        (0, class_transformer_1.Transform)(function (_a) {
+            var value = _a.value;
+            return new Date(value);
+        }, { toClassOnly: true }),
+        __metadata("design:type", Date)
+    ], UsageItem.prototype, "timeframeEnd", void 0);
+    __decorate([
+        (0, utils_1.SpeakeasyMetadata)(),
+        (0, class_transformer_1.Expose)({ name: "timeframe_start" }),
+        (0, class_transformer_1.Transform)(function (_a) {
+            var value = _a.value;
+            return new Date(value);
+        }, { toClassOnly: true }),
+        __metadata("design:type", Date)
+    ], UsageItem.prototype, "timeframeStart", void 0);
+    return UsageItem;
+}(utils_1.SpeakeasyBase));
+exports.UsageItem = UsageItem;

package/dist/sdk/models/shared/validationerrors.d.ts

@@ -0,0 +1,13 @@
+import { SpeakeasyBase } from "../../../internal/utils";
+export declare class ValidationErrorsValidationErrors extends SpeakeasyBase {
+}
+export declare class ValidationErrors extends SpeakeasyBase {
+    /**
+     * The passed idempotency_key corresponding to the validation_errors
+     */
+    idempotencyKey?: string;
+    /**
+     * An array of objects corresponding to validation failures for each idempotency_key.
+     */
+    validationErrors?: ValidationErrorsValidationErrors[];
+}

package/dist/sdk/models/shared/validationerrors.js

@@ -0,0 +1,59 @@
+"use strict";
+/*
+ * Code generated by Speakeasy (https://speakeasyapi.dev). DO NOT EDIT.
+ */
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidationErrors = exports.ValidationErrorsValidationErrors = void 0;
+var utils_1 = require("../../../internal/utils");
+var class_transformer_1 = require("class-transformer");
+var ValidationErrorsValidationErrors = /** @class */ (function (_super) {
+    __extends(ValidationErrorsValidationErrors, _super);
+    function ValidationErrorsValidationErrors() {
+        return _super !== null && _super.apply(this, arguments) || this;
+    }
+    return ValidationErrorsValidationErrors;
+}(utils_1.SpeakeasyBase));
+exports.ValidationErrorsValidationErrors = ValidationErrorsValidationErrors;
+var ValidationErrors = /** @class */ (function (_super) {
+    __extends(ValidationErrors, _super);
+    function ValidationErrors() {
+        return _super !== null && _super.apply(this, arguments) || this;
+    }
+    __decorate([
+        (0, utils_1.SpeakeasyMetadata)(),
+        (0, class_transformer_1.Expose)({ name: "idempotency_key" }),
+        __metadata("design:type", String)
+    ], ValidationErrors.prototype, "idempotencyKey", void 0);
+    __decorate([
+        (0, utils_1.SpeakeasyMetadata)({ elemType: ValidationErrorsValidationErrors }),
+        (0, class_transformer_1.Expose)({ name: "validation_errors" }),
+        (0, class_transformer_1.Type)(function () { return ValidationErrorsValidationErrors; }),
+        __metadata("design:type", Array)
+    ], ValidationErrors.prototype, "validationErrors", void 0);
+    return ValidationErrors;
+}(utils_1.SpeakeasyBase));
+exports.ValidationErrors = ValidationErrors;

package/dist/sdk/models/shared/viewmode.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Controls whether Orb returns cumulative costs since the start of the billing period, or incremental day-by-day costs. If your customer has minimums or discounts, it's strongly recommended that you use the default cumulative behavior.
+ */
+export declare enum ViewMode {
+    Periodic = "periodic",
+    Cumulative = "cumulative"
+}

package/dist/sdk/models/shared/viewmode.js

@@ -0,0 +1,14 @@
+"use strict";
+/*
+ * Code generated by Speakeasy (https://speakeasyapi.dev). DO NOT EDIT.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ViewMode = void 0;
+/**
+ * Controls whether Orb returns cumulative costs since the start of the billing period, or incremental day-by-day costs. If your customer has minimums or discounts, it's strongly recommended that you use the default cumulative behavior.
+ */
+var ViewMode;
+(function (ViewMode) {
+    ViewMode["Periodic"] = "periodic";
+    ViewMode["Cumulative"] = "cumulative";
+})(ViewMode = exports.ViewMode || (exports.ViewMode = {}));

package/dist/sdk/plan.d.ts

@@ -0,0 +1,222 @@
+import * as operations from "./models/operations";
+import { SDKConfiguration } from "./sdk";
+import { AxiosRequestConfig } from "axios";
+/**
+ * The [Plan](../guides/core-concepts.mdx#plan-and-price) resource represents a plan that can be subscribed to by a customer. Plans define the billing behavior of the subscription.
+ *
+ * @remarks
+ *  Orb supports a few different pricing models out of the box. Each of these models is serialized differently in a given Price object. The model_type field determines the key for the configuration object that is present.
+ *
+ * ## Unit pricing
+ * With unit pricing, each unit costs a fixed amount.
+ * ```json
+ * {
+ *     ...
+ *     "model_type": "unit",
+ *     "unit_config": {
+ *         "unit_amount": "0.50"
+ *     }
+ *     ...
+ * }
+ * ```
+ *
+ * ## Tiered pricing
+ * In tiered pricing, the cost of a given unit depends on the tier range that it falls into, where each tier range is defined by an upper and lower bound. For example, the first ten units may cost $0.50 each and all units thereafter may cost $0.10 each.
+ * ```json
+ * {
+ *     ...
+ *     "model_type": "tiered",
+ *     "tiered_config": {
+ *         "tiers": [
+ *            {
+ *                 "first_unit": 1,
+ *                 "last_unit": 10,
+ *                 "unit_amount": "0.50"
+ *             },
+ *             {
+ *                 "first_unit": 11,
+ *                 "last_unit": null,
+ *                 "unit_amount": "0.10"
+ *             }
+ *         ]
+ *     }
+ *     ...
+ * }
+ * ```
+ *
+ * ## Bulk pricing
+ * Bulk pricing applies when the number of units determine the cost of all units. For example, if you've bought less than 10 units, they may each be $0.50 for a total of $5.00. Once you've bought more than 10 units, all units may now be priced at $0.40 (i.e. 101 units total would be $40.40).
+ * ```json
+ * {
+ *     ...
+ *     "model_type": "bulk",
+ *     "bulk_config": {
+ *         "tiers": [
+ *             {
+ *                 "maximum_units": 10,
+ *                 "unit_amount": "0.50"
+ *             },
+ *             {
+ *                 "maximum_units": 1000,
+ *                 "unit_amount": "0.40"
+ *             }
+ *           ]
+ *     }
+ *     ...
+ * }
+ * ```
+ *
+ * ## Package pricing
+ * Package pricing defines the size or granularity of a unit for billing purposes. For example, if the package size is set to 5, then 4 units will be billed as 5 and 6 units will be billed at 10.
+ * ```json
+ * {
+ *     ...
+ *     "model_type": "package",
+ *     "package_config": {
+ *        "package_amount": "0.80",
+ *        "package_size": 10
+ *     }
+ *     ...
+ *  }
+ * ```
+ *
+ * ## BPS pricing
+ * BPS pricing specifies a per-event (e.g. per-payment) rate in one hundredth of a percent (the number of basis points to charge), as well as a cap per event to assess. For example, this would allow you to assess a fee of 0.25% on every payment you process, with a maximum charge of $25 per payment.
+ * ```json
+ * {
+ *     ...
+ *     "model_type": "bps",
+ *     "bps_config": {
+ *        "bps": 125,
+ *        "per_unit_maximum": "11.00"
+ *     }
+ *     ...
+ *  }
+ * ```
+ *
+ * ## Bulk BPS pricing
+ * Bulk BPS pricing specifies BPS parameters in a tiered manner, dependent on the total quantity across all events. Similar to bulk pricing, the BPS parameters of a given event depends on the tier range that the billing period falls into. Each tier range is defined by an upper bound. For example, after $1.5M of payment volume is reached, each individual payment may have a lower cap or a smaller take-rate.
+ * ```json
+ *     ...
+ *     "model_type": "bulk_bps",
+ *     "bulk_bps_config": {
+ *         "tiers": [
+ *            {
+ *                 "maximum_amount": "1000000.00",
+ *                 "bps": 125,
+ *                 "per_unit_maximum": "19.00"
+ *            },
+ *           {
+ *                 "maximum_amount": null,
+ *                 "bps": 115,
+ *                 "per_unit_maximum": "4.00"
+ *             }
+ *         ]
+ *     }
+ *     ...
+ * }
+ * ```
+ *
+ * ## Tiered BPS pricing
+ * Tiered BPS pricing specifies BPS parameters in a graduated manner, where an event's applicable parameter is a function of its marginal addition to the period total. Similar to tiered pricing, the BPS parameters of a given event depends on the tier range that it falls into, where each tier range is defined by an upper and lower bound. For example, the first few payments may have a 0.8 BPS take-rate and all payments after a specific volume may incur a take-rate of 0.5 BPS each.
+ * ```json
+ *     ...
+ *     "model_type": "tiered_bps",
+ *     "tiered_bps_config": {
+ *         "tiers": [
+ *            {
+ *                 "minimum_amount": "0",
+ *                 "maximum_amount": "1000000.00",
+ *                 "bps": 125,
+ *                 "per_unit_maximum": "19.00"
+ *            },
+ *           {
+ *                 "minimum_amount": "1000000.00",
+ *                 "maximum_amount": null,
+ *                 "bps": 115,
+ *                 "per_unit_maximum": "4.00"
+ *             }
+ *         ]
+ *     }
+ *     ...
+ * }
+ * ```
+ *
+ * ## Matrix pricing
+ * Matrix pricing defines a set of unit prices in a one or two-dimensional matrix. `dimensions` defines the two event property values evaluated in this pricing model. In a one-dimensional matrix, the second value is `null`. Every configuration has a list of `matrix_values` which give the unit prices for specified property values. In a one-dimensional matrix, the matrix values will have `dimension_values` where the second value of the pair is null. If an event does not match any of the dimension values in the matrix, it will resort to the `default_unit_amount`.
+ * ```json
+ * ...
+ * "model_type": "matrix"
+ * "matrix_config": {
+ *     "default_unit_amount": "3.00",
+ *     "dimensions": [
+ *         "cluster_name",
+ *         "region"
+ *     ],
+ *     "matrix_values": [
+ *         {
+ *             "dimension_values": [
+ *                 "alpha",
+ *                 "west"
+ *             ],
+ *             "unit_amount": "2.00"
+ *         },
+ *         ...
+ *     ]
+ * }
+ * ...
+ * ```
+ *
+ * ### Fixed fees
+ * Fixed fees are prices that are applied independent of usage quantites, and follow unit pricing. They also have an additional parameter `fixed_price_quantity`. If the Price represents a fixed cost, this represents the quantity of units applied.
+ * ```json
+ * {
+ *     ...
+ *     "id": "price_id",
+ *     "model_type": "unit",
+ *     "unit_config": {
+ *        "unit_amount": "2.00"
+ *     },
+ *     "fixed_price_quantity": 3.0
+ *     ...
+ * }
+ * ```
+ *
+ */
+export declare class Plan {
+    private sdkConfiguration;
+    constructor(sdkConfig: SDKConfiguration);
+    /**
+     * Fetch plan
+     *
+     * @remarks
+     * This endpoint is used to fetch [plan](../guides/concepts##plan-and-price) details given a plan identifier. It returns information about the prices included in the plan and their configuration, as well as the product that the plan is attached to.
+     *
+     * ## Serialized prices
+     * Orb supports a few different pricing models out of the box. Each of these models is serialized differently in a given [Price](../guides/concepts#plan-and-price) object. The `model_type` field determines the key for the configuration object that is present. A detailed explanation of price types can be found in the [Price schema](../guides/concepts#plan-and-price).
+     *
+     * ## Phases
+     * Orb supports plan phases, also known as contract ramps. For plans with phases, the serialized prices refer to all prices across all phases.
+     */
+    fetch(req: operations.FetchPlanRequest, config?: AxiosRequestConfig): Promise<operations.FetchPlanResponse>;
+    /**
+     * Fetch plan by external ID
+     *
+     * @remarks
+     * This endpoint is used to fetch [plan](../guides/concepts##plan-and-price) details given an external_plan_id identifier. It returns information about the prices included in the plan and their configuration, as well as the product that the plan is attached to.
+     *
+     * ## Serialized prices
+     * Orb supports a few different pricing models out of the box. Each of these models is serialized differently in a given [Price](../guides/concepts#plan-and-price) object. The `model_type` field determines the key for the configuration object that is present. A detailed explanation of price types can be found in the [Price schema](../guides/concepts#plan-and-price).
+     */
+    getByExternalId(req: operations.FetchPlanExternalIdRequest, config?: AxiosRequestConfig): Promise<operations.FetchPlanExternalIdResponse>;
+    /**
+     * List plans
+     *
+     * @remarks
+     * This endpoint returns a list of all [plans](../guides/concepts##plan-and-price) for an account in a list format.
+     *
+     * The list of plans is ordered starting from the most recently created plan. The response also includes [`pagination_metadata`](../reference/pagination), which lets the caller retrieve the next page of results if they exist.
+     *
+     */
+    list(req: operations.ListPlansRequest, config?: AxiosRequestConfig): Promise<operations.ListPlansResponse>;
+}