@openmeter/sdk 1.0.0-beta.21 → 1.0.0-beta.210

package/dist/src/client/customers.js

@@ -0,0 +1,193 @@
+import { transformResponse } from './utils.js';
+/**
+ * Customers
+ * Manage customer subscription lifecycles and plan assignments.
+ */
+export class Customers {
+    client;
+    apps;
+    entitlements;
+    constructor(client) {
+        this.client = client;
+        this.apps = new CustomerApps(client);
+        this.entitlements = new CustomerEntitlements(client);
+    }
+    /**
+     * Create a customer
+     * @param customer - The customer to create
+     * @param signal - An optional abort signal
+     * @returns The created customer
+     */
+    async create(customer, options) {
+        const resp = await this.client.POST('/api/v1/customers', {
+            body: customer,
+            ...options,
+        });
+        return transformResponse(resp);
+    }
+    /**
+     * Get a customer by ID
+     * @param customerIdOrKey - The ID or Key of the customer
+     * @param signal - An optional abort signal
+     * @returns The customer
+     */
+    async get(customerIdOrKey, options) {
+        const resp = await this.client.GET('/api/v1/customers/{customerIdOrKey}', {
+            params: {
+                path: {
+                    customerIdOrKey,
+                },
+            },
+            ...options,
+        });
+        return transformResponse(resp);
+    }
+    /**
+     * Update a customer
+     * @param customerIdOrKey - The ID or Key of the customer
+     * @param customer - The customer to update
+     * @param signal - An optional abort signal
+     * @returns The updated customer
+     */
+    async update(customerIdOrKey, customer, options) {
+        const resp = await this.client.PUT('/api/v1/customers/{customerIdOrKey}', {
+            body: customer,
+            params: {
+                path: {
+                    customerIdOrKey,
+                },
+            },
+            ...options,
+        });
+        return transformResponse(resp);
+    }
+    /**
+     * Delete a customer
+     * @param customerIdOrKey - The ID or Key of the customer
+     * @param signal - An optional abort signal
+     * @returns The deleted customer
+     */
+    async delete(customerIdOrKey, options) {
+        const resp = await this.client.DELETE('/api/v1/customers/{customerIdOrKey}', {
+            params: {
+                path: {
+                    customerIdOrKey,
+                },
+            },
+            ...options,
+        });
+        return transformResponse(resp);
+    }
+    /**
+     * List customers
+     * @param signal - An optional abort signal
+     * @returns The list of customers
+     */
+    async list(query, options) {
+        const resp = await this.client.GET('/api/v1/customers', {
+            params: {
+                query,
+            },
+            ...options,
+        });
+        return transformResponse(resp);
+    }
+}
+/**
+ * Customer Apps
+ * Manage customer apps.
+ */
+export class CustomerApps {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Upsert customer app data
+     * @param customerIdOrKey - The ID or Key of the customer
+     * @param appData - The app data to upsert
+     * @param signal - An optional abort signal
+     * @returns The upserted app data
+     */
+    async upsert(customerIdOrKey, appData, options) {
+        const resp = await this.client.PUT('/api/v1/customers/{customerIdOrKey}/apps', {
+            body: appData,
+            params: {
+                path: {
+                    customerIdOrKey,
+                },
+            },
+            ...options,
+        });
+        return transformResponse(resp);
+    }
+    /**
+     * List customer app data
+     * @param customerIdOrKey - The ID or key of the customer
+     * @param query - The query parameters
+     * @param signal - An optional abort signal
+     * @returns The list of customer app data
+     */
+    async list(customerIdOrKey, query, options) {
+        const resp = await this.client.GET('/api/v1/customers/{customerIdOrKey}/apps', {
+            params: {
+                path: { customerIdOrKey },
+                query,
+            },
+            ...options,
+        });
+        return transformResponse(resp);
+    }
+    /**
+     * Delete customer app data
+     * @param customerIdOrKey - The ID or key of the customer
+     * @param appId - The ID of the app
+     * @param signal - An optional abort signal
+     * @returns The deleted customer app data
+     */
+    async delete(customerIdOrKey, appId, options) {
+        const resp = await this.client.DELETE('/api/v1/customers/{customerIdOrKey}/apps/{appId}', {
+            params: { path: { appId, customerIdOrKey } },
+            ...options,
+        });
+        return transformResponse(resp);
+    }
+    /**
+     * List customer subscriptions
+     * @param customerIdOrKey - The ID or key of the customer
+     * @param query - The query parameters
+     * @param signal - An optional abort signal
+     * @returns The list of customer subscriptions
+     */
+    async listSubscriptions(customerIdOrKey, query, options) {
+        const resp = await this.client.GET('/api/v1/customers/{customerIdOrKey}/subscriptions', {
+            params: { path: { customerIdOrKey }, query },
+            ...options,
+        });
+        return transformResponse(resp);
+    }
+}
+/**
+ * Customer Entitlements
+ */
+export class CustomerEntitlements {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get the value of an entitlement for a customer
+     * @param customerIdOrKey - The ID or Key of the customer
+     * @param featureKey - The key of the feature
+     * @param signal - An optional abort signal
+     * @returns The value of the entitlement
+     */
+    async value(customerIdOrKey, featureKey, options) {
+        const resp = await this.client.GET('/api/v1/customers/{customerIdOrKey}/entitlements/{featureKey}/value', {
+            params: { path: { customerIdOrKey, featureKey } },
+            ...options,
+        });
+        return transformResponse(resp);
+    }
+}
+//# sourceMappingURL=customers.js.map

package/dist/src/client/customers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customers.js","sourceRoot":"","sources":["../../../src/client/customers.ts"],"names":[],"mappings":"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"}

package/dist/src/client/entitlements.d.ts

@@ -0,0 +1,472 @@
+import type { RequestOptions } from './common.js';
+import type { EntitlementCreateInputs, EntitlementGrantCreateInput, operations, paths, ResetEntitlementUsageInput } from './schemas.js';
+import type { Client } from 'openapi-fetch';
+/**
+ * Entitlements
+ * @description With Entitlements, you can define and enforce usage limits, implement quota-based pricing, and manage access to features in your application.
+ */
+export declare class Entitlements {
+    private client;
+    grants: Grants;
+    constructor(client: Client<paths, `${string}/${string}`>);
+    /**
+     * Create an entitlement
+     *
+     *     - Boolean entitlements define static feature access, e.g. "Can use SSO authentication".
+     *     - Static entitlements let you pass along a configuration while granting access, e.g. "Using this feature with X Y settings" (passed in the config).
+     *     - Metered entitlements have many use cases, from setting up usage-based access to implementing complex credit systems.  Example: The customer can use 10000 AI tokens during the usage period of the entitlement.
+     *
+     *     A given subject can only have one active (non-deleted) entitlement per featureKey. If you try to create a new entitlement for a featureKey that already has an active entitlement, the request will fail with a 409 error.
+     *
+     *     Once an entitlement is created you cannot modify it, only delete it.
+     *
+     * @param subjectIdOrKey - The ID or key of the subject
+     * @param entitlement - The entitlement to create
+     * @param signal - An optional abort signal
+     * @returns The created entitlement
+     */
+    create(subjectIdOrKey: operations['createEntitlement']['parameters']['path']['subjectIdOrKey'], entitlement: EntitlementCreateInputs, options?: RequestOptions): Promise<import("openapi-typescript-helpers").SuccessResponse<{
+        201: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": import("./schemas.js").components["schemas"]["Entitlement"];
+            };
+        };
+        400: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/problem+json": import("./schemas.js").components["schemas"]["BadRequestProblemResponse"];
+            };
+        };
+        401: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/problem+json": import("./schemas.js").components["schemas"]["UnauthorizedProblemResponse"];
+            };
+        };
+        403: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/problem+json": import("./schemas.js").components["schemas"]["ForbiddenProblemResponse"];
+            };
+        };
+        409: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/problem+json": import("./schemas.js").components["schemas"]["ConflictProblemResponse"];
+            };
+        };
+        412: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/problem+json": import("./schemas.js").components["schemas"]["PreconditionFailedProblemResponse"];
+            };
+        };
+        500: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/problem+json": import("./schemas.js").components["schemas"]["InternalServerErrorProblemResponse"];
+            };
+        };
+        503: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/problem+json": import("./schemas.js").components["schemas"]["ServiceUnavailableProblemResponse"];
+            };
+        };
+        default: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/problem+json": import("./schemas.js").components["schemas"]["UnexpectedProblemResponse"];
+            };
+        };
+    }, `${string}/${string}`>>;
+    /**
+     * Get an entitlement by ID
+     *
+     * @param id - The ID of the entitlement
+     * @param signal - An optional abort signal
+     * @returns The entitlement
+     */
+    get(id: operations['getEntitlement']['parameters']['path']['entitlementId'], options?: RequestOptions): Promise<import("openapi-typescript-helpers").SuccessResponse<{
+        200: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": import("./schemas.js").components["schemas"]["Entitlement"];
+            };
+        };
+        400: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/problem+json": import("./schemas.js").components["schemas"]["BadRequestProblemResponse"];
+            };
+        };
+        401: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/problem+json": import("./schemas.js").components["schemas"]["UnauthorizedProblemResponse"];
+            };
+        };
+        403: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/problem+json": import("./schemas.js").components["schemas"]["ForbiddenProblemResponse"];
+            };
+        };
+        404: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/problem+json": import("./schemas.js").components["schemas"]["NotFoundProblemResponse"];
+            };
+        };
+        412: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/problem+json": import("./schemas.js").components["schemas"]["PreconditionFailedProblemResponse"];
+            };
+        };
+        500: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/problem+json": import("./schemas.js").components["schemas"]["InternalServerErrorProblemResponse"];
+            };
+        };
+        503: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/problem+json": import("./schemas.js").components["schemas"]["ServiceUnavailableProblemResponse"];
+            };
+        };
+        default: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/problem+json": import("./schemas.js").components["schemas"]["UnexpectedProblemResponse"];
+            };
+        };
+    }, `${string}/${string}`>>;
+    /**
+     * List entitlements
+     *
+     * @param query - The query parameters
+     * @param signal - An optional abort signal
+     * @returns The entitlements
+     */
+    list(query?: Omit<operations['listEntitlements']['parameters']['query'], 'page' | 'pageSize'>, options?: RequestOptions): Promise<({
+        type: "metered";
+        isSoftLimit?: boolean;
+        isUnlimited?: boolean;
+        issueAfterReset?: number;
+        issueAfterResetPriority?: number;
+        preserveOverageAtReset?: boolean;
+        readonly createdAt: Date;
+        readonly updatedAt: Date;
+        readonly deletedAt?: Date;
+        metadata?: import("./schemas.js").components["schemas"]["Metadata"];
+        activeFrom: Date;
+        activeTo?: Date;
+        readonly annotations?: import("./schemas.js").components["schemas"]["Annotations"];
+        readonly id: string;
+        subjectKey: string;
+        featureKey: string;
+        featureId: string;
+        readonly lastReset: Date;
+        readonly currentUsagePeriod: import("./schemas.js").components["schemas"]["Period"];
+        readonly measureUsageFrom: Date;
+        readonly usagePeriod: import("./schemas.js").components["schemas"]["RecurringPeriod"];
+    } | {
+        type: "static";
+        config: string;
+        readonly createdAt: Date;
+        readonly updatedAt: Date;
+        readonly deletedAt?: Date;
+        metadata?: import("./schemas.js").components["schemas"]["Metadata"];
+        activeFrom: Date;
+        activeTo?: Date;
+        readonly annotations?: import("./schemas.js").components["schemas"]["Annotations"];
+        readonly id: string;
+        subjectKey: string;
+        featureKey: string;
+        featureId: string;
+        currentUsagePeriod?: import("./schemas.js").components["schemas"]["Period"];
+        usagePeriod?: import("./schemas.js").components["schemas"]["RecurringPeriod"];
+    } | ({
+        type: "boolean";
+        readonly createdAt: Date;
+        readonly updatedAt: Date;
+        readonly deletedAt?: Date;
+        metadata?: import("./schemas.js").components["schemas"]["Metadata"];
+        activeFrom: Date;
+        activeTo?: Date;
+        readonly annotations?: import("./schemas.js").components["schemas"]["Annotations"];
+        readonly id: string;
+        subjectKey: string;
+        featureKey: string;
+        featureId: string;
+        currentUsagePeriod?: import("./schemas.js").components["schemas"]["Period"];
+        usagePeriod?: import("./schemas.js").components["schemas"]["RecurringPeriod"];
+    } & {
+        readonly createdAt: Date;
+        readonly updatedAt: Date;
+        readonly deletedAt?: Date;
+        metadata?: import("./schemas.js").components["schemas"]["Metadata"];
+        activeFrom: Date;
+        activeTo?: Date;
+        readonly annotations?: import("./schemas.js").components["schemas"]["Annotations"];
+        readonly id: string;
+        type: import("./schemas.js").components["schemas"]["EntitlementType"];
+        subjectKey: string;
+        featureKey: string;
+        featureId: string;
+        currentUsagePeriod?: import("./schemas.js").components["schemas"]["Period"];
+        usagePeriod?: import("./schemas.js").components["schemas"]["RecurringPeriod"];
+    } & {
+        readonly id: string;
+        readonly createdAt: Date;
+        readonly updatedAt: Date;
+        type: import("./schemas.js").components["schemas"]["EntitlementType"];
+        activeFrom: Date;
+        subjectKey: string;
+        featureKey: string;
+        featureId: string;
+    } & {
+        type: "boolean";
+    }))[]>;
+    /**
+     * Delete an entitlement
+     *
+     * @param subjectIdOrKey - The ID or key of the subject
+     * @param entitlementId - The ID of the entitlement
+     * @param signal - An optional abort signal
+     * @returns The deleted entitlement
+     */
+    delete(subjectIdOrKey: operations['deleteEntitlement']['parameters']['path']['subjectIdOrKey'], entitlementId: operations['deleteEntitlement']['parameters']['path']['entitlementId'], options?: RequestOptions): Promise<undefined>;
+    /**
+     * Get the value of an entitlement to check access
+     * All entitlement types share the hasAccess property in their value response, but multiple other properties are returned based on the entitlement type.
+     *
+     * @param subjectIdOrKey - The ID or key of the subject
+     * @param entitlementIdOrFeatureKey - The ID or feature key of the entitlement
+     * @param query - The query parameters
+     * @param signal - An optional abort signal
+     * @returns The entitlement value
+     */
+    value(subjectIdOrKey: operations['getEntitlementValue']['parameters']['path']['subjectIdOrKey'], entitlementIdOrFeatureKey: operations['getEntitlementValue']['parameters']['path']['entitlementIdOrFeatureKey'], query?: operations['getEntitlementValue']['parameters']['query'], options?: RequestOptions): Promise<{
+        readonly hasAccess: boolean;
+        readonly balance?: number;
+        readonly usage?: number;
+        readonly overage?: number;
+        readonly config?: string;
+    }>;
+    /**
+     * Get the history of an entitlement
+     * Returns historical balance and usage data for the entitlement. The queried history can span accross multiple reset events.
+     *
+     * @param subjectIdOrKey - The ID or key of the subject
+     * @param entitlementId - The ID of the entitlement
+     * @param query - The query parameters
+     * @param signal - An optional abort signal
+     * @returns The history of the entitlement
+     */
+    history(subjectIdOrKey: operations['getEntitlementHistory']['parameters']['path']['subjectIdOrKey'], entitlementId: operations['getEntitlementHistory']['parameters']['path']['entitlementId'], query: operations['getEntitlementHistory']['parameters']['query'], options?: RequestOptions): Promise<{
+        windowedHistory: import("./schemas.js").components["schemas"]["BalanceHistoryWindow"][];
+        burndownHistory: import("./schemas.js").components["schemas"]["GrantBurnDownHistorySegment"][];
+    }>;
+    /**
+     * Override an entitlement
+     * This is useful for upgrades, downgrades, or other changes to entitlements that require a new entitlement to be created with zero downtime.
+     *
+     * @param subjectIdOrKey - The ID or key of the subject
+     * @param entitlementIdOrFeatureKey - The ID or feature key of the entitlement
+     * @param override - The override to create
+     * @param signal - An optional abort signal
+     * @returns The overridden entitlement
+     */
+    override(subjectIdOrKey: operations['overrideEntitlement']['parameters']['path']['subjectIdOrKey'], entitlementIdOrFeatureKey: operations['overrideEntitlement']['parameters']['path']['entitlementIdOrFeatureKey'], override: EntitlementCreateInputs, options?: RequestOptions): Promise<import("openapi-typescript-helpers").SuccessResponse<{
+        201: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": import("./schemas.js").components["schemas"]["Entitlement"];
+            };
+        };
+        400: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/problem+json": import("./schemas.js").components["schemas"]["BadRequestProblemResponse"];
+            };
+        };
+        401: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/problem+json": import("./schemas.js").components["schemas"]["UnauthorizedProblemResponse"];
+            };
+        };
+        403: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/problem+json": import("./schemas.js").components["schemas"]["ForbiddenProblemResponse"];
+            };
+        };
+        404: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/problem+json": import("./schemas.js").components["schemas"]["NotFoundProblemResponse"];
+            };
+        };
+        409: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/problem+json": import("./schemas.js").components["schemas"]["ConflictProblemResponse"];
+            };
+        };
+        412: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/problem+json": import("./schemas.js").components["schemas"]["PreconditionFailedProblemResponse"];
+            };
+        };
+        500: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/problem+json": import("./schemas.js").components["schemas"]["InternalServerErrorProblemResponse"];
+            };
+        };
+        503: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/problem+json": import("./schemas.js").components["schemas"]["ServiceUnavailableProblemResponse"];
+            };
+        };
+        default: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/problem+json": import("./schemas.js").components["schemas"]["UnexpectedProblemResponse"];
+            };
+        };
+    }, `${string}/${string}`>>;
+    /**
+     * Reset entitlement usage
+     * - Reset marks the start of a new usage period for the entitlement and initiates grant rollover. At the start of a period usage is zerod out and grants are rolled over based on their rollover settings. It would typically be synced with the subjects billing period to enforce usage based on their subscription.
+     * - Usage is automatically reset for metered entitlements based on their usage period, but this endpoint allows to manually reset it at any time. When doing so the period anchor of the entitlement can be changed if needed.
+     *
+     * @param subjectIdOrKey - The ID or key of the subject
+     * @param entitlementId - The ID of the entitlement
+     * @param body - The body of the request
+     * @param signal - An optional abort signal
+     * @returns The reset entitlement
+     */
+    reset(subjectIdOrKey: operations['resetEntitlementUsage']['parameters']['path']['subjectIdOrKey'], entitlementId: operations['resetEntitlementUsage']['parameters']['path']['entitlementId'], body: ResetEntitlementUsageInput, options?: RequestOptions): Promise<undefined>;
+}
+export declare class Grants {
+    private client;
+    constructor(client: Client<paths, `${string}/${string}`>);
+    /**
+    /**
+     * Grant usage to a subject for an entitlement
+     *
+     * @param subjectIdOrKey - The ID or key of the subject
+     * @param entitlementIdOrFeatureKey - The ID or feature key of the entitlement
+     * @param grant - The grant to create
+     * @param signal - An optional abort signal
+     * @returns The created grant
+     */
+    create(subjectIdOrKey: operations['createGrant']['parameters']['path']['subjectIdOrKey'], entitlementIdOrFeatureKey: operations['createGrant']['parameters']['path']['entitlementIdOrFeatureKey'], grant: EntitlementGrantCreateInput, options?: RequestOptions): Promise<{
+        readonly createdAt: Date;
+        readonly updatedAt: Date;
+        readonly deletedAt?: Date;
+        amount: number;
+        priority?: number;
+        effectiveAt: Date;
+        expiration: import("./schemas.js").components["schemas"]["ExpirationPeriod"];
+        maxRolloverAmount?: number;
+        minRolloverAmount?: number;
+        metadata?: import("./schemas.js").components["schemas"]["Metadata"];
+        readonly id: string;
+        readonly entitlementId: string;
+        nextRecurrence?: Date;
+        readonly expiresAt?: Date;
+        voidedAt?: Date;
+        recurrence?: import("./schemas.js").components["schemas"]["RecurringPeriod"];
+    }>;
+    /**
+     * List grants for an entitlement
+     *
+     * @param subjectIdOrKey - The ID or key of the subject
+     * @param entitlementIdOrFeatureKey - The ID or feature key of the entitlement
+     * @param signal - An optional abort signal
+     * @returns The grants
+     */
+    list(subjectIdOrKey: operations['listEntitlementGrants']['parameters']['path']['subjectIdOrKey'], entitlementIdOrFeatureKey: operations['listEntitlementGrants']['parameters']['path']['entitlementIdOrFeatureKey'], query?: operations['listEntitlementGrants']['parameters']['query'], options?: RequestOptions): Promise<{
+        readonly createdAt: Date;
+        readonly updatedAt: Date;
+        readonly deletedAt?: Date;
+        amount: number;
+        priority?: number;
+        effectiveAt: Date;
+        expiration: import("./schemas.js").components["schemas"]["ExpirationPeriod"];
+        maxRolloverAmount?: number;
+        minRolloverAmount?: number;
+        metadata?: import("./schemas.js").components["schemas"]["Metadata"];
+        readonly id: string;
+        readonly entitlementId: string;
+        nextRecurrence?: Date;
+        readonly expiresAt?: Date;
+        voidedAt?: Date;
+        recurrence?: import("./schemas.js").components["schemas"]["RecurringPeriod"];
+    }[]>;
+}