@openmeter/sdk 1.0.0-beta.13 → 1.0.0-beta.131

package/dist/clients/feature.js

@@ -0,0 +1,76 @@
+import { BaseClient } from './client.js';
+export class FeatureClient extends BaseClient {
+    constructor(config) {
+        super(config);
+    }
+    /**
+     * Features are the building blocks of your entitlements, part of your product offering.
+     * @description
+     * Features are either metered or static. A feature is metered if meterSlug is provided at creation. For metered features you can pass additional filters that will be applied when calculating feature usage, based on the meter's groupBy fields. Only meters with SUM and COUNT aggregation are supported for features.
+     *
+     * Features cannot be updated later, only archived.
+     *
+     * @example
+     * const feature = await openmeter.features.create({
+     *  key: 'ai_tokens',
+     *  name: 'AI Tokens',
+     *  // optional
+     *  meterSlug: 'tokens_total',
+     * })
+     */
+    async create(input, options) {
+        return await this.request({
+            path: '/api/v1/features',
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(input),
+            options,
+        });
+    }
+    /**
+     * Get Feature
+     *
+     * @example
+     * const feature = await openmeter.features.get('ai_tokens')
+     */
+    async get(id, options) {
+        return await this.request({
+            path: `/api/v1/features/${id}`,
+            method: 'GET',
+            options,
+        });
+    }
+    /**
+     * List features
+     * @example
+     * const feature = await openmeter.features.list()
+     */
+    async list(params, options) {
+        const searchParams = params
+            ? BaseClient.toURLSearchParams(params)
+            : undefined;
+        return await this.request({
+            path: '/api/v1/features',
+            method: 'GET',
+            searchParams,
+            options,
+        });
+    }
+    /**
+     * Archive a feature
+     * @description
+     * Once a feature is archived it cannot be unarchived. If a feature is archived, new entitlements cannot be created for it, but archiving the feature does not affect existing entitlements.
+     * @example
+     * await openmeter.delete('ai_tokens')
+     */
+    async delete(id, options) {
+        return await this.request({
+            path: `/api/v1/features/${id}`,
+            method: 'DELETE',
+            options,
+        });
+    }
+}
+//# sourceMappingURL=feature.js.map

package/dist/clients/feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.js","sourceRoot":"","sources":["../../clients/feature.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,UAAU,EAAmB,MAAM,aAAa,CAAA;AAQzE,MAAM,OAAO,aAAc,SAAQ,UAAU;IAC3C,YAAY,MAAuB;QACjC,KAAK,CAAC,MAAM,CAAC,CAAA;IACf,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACI,KAAK,CAAC,MAAM,CACjB,KAA0B,EAC1B,OAAwB;QAExB,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC;YACxB,IAAI,EAAE,kBAAkB;YACxB,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;YAC3B,OAAO;SACR,CAAC,CAAA;IACJ,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,GAAG,CAAC,EAAU,EAAE,OAAwB;QACnD,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC;YACxB,IAAI,EAAE,oBAAoB,EAAE,EAAE;YAC9B,MAAM,EAAE,KAAK;YACb,OAAO;SACR,CAAC,CAAA;IACJ,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,IAAI,CACf,MAA+B,EAC/B,OAAwB;QAExB,MAAM,YAAY,GAAG,MAAM;YACzB,CAAC,CAAC,UAAU,CAAC,iBAAiB,CAAC,MAAM,CAAC;YACtC,CAAC,CAAC,SAAS,CAAA;QACb,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC;YACxB,IAAI,EAAE,kBAAkB;YACxB,MAAM,EAAE,KAAK;YACb,YAAY;YACZ,OAAO;SACR,CAAC,CAAA;IACJ,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,OAAwB;QACtD,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC;YACxB,IAAI,EAAE,oBAAoB,EAAE,EAAE;YAC9B,MAAM,EAAE,QAAQ;YAChB,OAAO;SACR,CAAC,CAAA;IACJ,CAAC;CACF"}

package/dist/clients/grant.d.ts

@@ -0,0 +1,24 @@
+import { components, operations } from '../schemas/openapi.js';
+import { RequestOptions, BaseClient, OpenMeterConfig } from './client.js';
+import { Paginated } from './pagination.js';
+export type EntitlementGrant = components['schemas']['EntitlementGrant'];
+export type EntitlementGrantCreateInput = components['schemas']['EntitlementGrantCreateInput'];
+export type ListGrantQueryParams = operations['listGrants']['parameters']['query'];
+export type ListEntitlementGrantQueryParams = operations['listEntitlementGrants']['parameters']['query'];
+export declare class GrantClient extends BaseClient {
+    constructor(config: OpenMeterConfig);
+    /**
+     * List grants
+     * @example
+     * const grant = await openmeter.grants.list()
+     */
+    list(params?: ListGrantQueryParams, options?: RequestOptions): Promise<EntitlementGrant[] | Paginated<EntitlementGrant>>;
+    /**
+     * Void a grant
+     * @description
+     * Voiding a grant means it is no longer valid, it doesn't take part in further balance calculations. Voiding a grant does not retroactively take effect, meaning any usage that has already been attributed to the grant will remain, but future usage cannot be burnt down from the grant.
+     * @example
+     * const grant = await openmeter.grants.list()
+     */
+    delete(id: string, options?: RequestOptions): Promise<EntitlementGrant[]>;
+}

package/dist/clients/grant.js

@@ -0,0 +1,37 @@
+import { BaseClient } from './client.js';
+export class GrantClient extends BaseClient {
+    constructor(config) {
+        super(config);
+    }
+    /**
+     * List grants
+     * @example
+     * const grant = await openmeter.grants.list()
+     */
+    async list(params, options) {
+        const searchParams = params
+            ? BaseClient.toURLSearchParams(params)
+            : undefined;
+        return await this.request({
+            path: '/api/v1/grants',
+            method: 'GET',
+            searchParams,
+            options,
+        });
+    }
+    /**
+     * Void a grant
+     * @description
+     * Voiding a grant means it is no longer valid, it doesn't take part in further balance calculations. Voiding a grant does not retroactively take effect, meaning any usage that has already been attributed to the grant will remain, but future usage cannot be burnt down from the grant.
+     * @example
+     * const grant = await openmeter.grants.list()
+     */
+    async delete(id, options) {
+        return await this.request({
+            method: 'DELETE',
+            path: `/api/v1/grants/${id}`,
+            options,
+        });
+    }
+}
+//# sourceMappingURL=grant.js.map

package/dist/clients/grant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grant.js","sourceRoot":"","sources":["../../clients/grant.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,UAAU,EAAmB,MAAM,aAAa,CAAA;AAWzE,MAAM,OAAO,WAAY,SAAQ,UAAU;IACzC,YAAY,MAAuB;QACjC,KAAK,CAAC,MAAM,CAAC,CAAA;IACf,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,IAAI,CACf,MAA6B,EAC7B,OAAwB;QAExB,MAAM,YAAY,GAAG,MAAM;YACzB,CAAC,CAAC,UAAU,CAAC,iBAAiB,CAAC,MAAM,CAAC;YACtC,CAAC,CAAC,SAAS,CAAA;QACb,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC;YACxB,IAAI,EAAE,gBAAgB;YACtB,MAAM,EAAE,KAAK;YACb,YAAY;YACZ,OAAO;SACR,CAAC,CAAA;IACJ,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,MAAM,CACjB,EAAU,EACV,OAAwB;QAExB,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC;YACxB,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,kBAAkB,EAAE,EAAE;YAC5B,OAAO;SACR,CAAC,CAAA;IACJ,CAAC;CACF"}

package/dist/clients/meter.d.ts

@@ -12,36 +12,6 @@ export declare enum MeterAggregation {
     MIN = "MIN",
     MAX = "MAX"
 }
-export type MeterValuesParams = {
-    /**
-     * @description Subject(s) to filter by.
-     * @example ["customer-1", "customer-2"]
-     */
-    subject?: string;
-    /**
-     * @description Start date.
-     * Must be aligned with the window size.
-     * Inclusive.
-     */
-    from?: Date;
-    /**
-     * @description End date.
-     * Must be aligned with the window size.
-     * Inclusive.
-     */
-    to?: Date;
-    /**
-     * @description Window Size
-     * If not specified, a single usage aggregate will be returned for the entirety of
-     * the specified period for each subject and group.
-     */
-    windowSize?: WindowSizeType;
-    /**
-     * @description Group By
-     * If not specified a single aggregate will be returned for each subject and time window.
-     */
-    groupBy?: string[];
-};
 export type MeterQueryParams = {
     /**
      * @description Subject(s) to filter by.
@@ -66,17 +36,30 @@ export type MeterQueryParams = {
      * the specified period for each subject and group.
      */
     windowSize?: WindowSizeType;
+    /**
+     * @description The value is the name of the time zone as defined in the IANA Time Zone Database (http://www.iana.org/time-zones).
+     * If not specified, the UTC timezone will be used.
+     */
+    windowTimeZone?: string;
     /**
      * @description Group By
      * If not specified a single aggregate will be returned for each subject and time window.
      */
     groupBy?: string[];
+    /**
+     * @description Filter by group by
+     */
+    filterGroupBy?: Record<string, string>;
 };
 export type MeterQueryResponse = paths['/api/v1/meters/{meterIdOrSlug}/query']['get']['responses']['200']['content']['application/json'];
 export type Meter = components['schemas']['Meter'];
 export type WindowSizeType = components['schemas']['WindowSize'];
 export declare class MetersClient extends BaseClient {
     constructor(config: OpenMeterConfig);
+    /**
+     * Create a meter
+     */
+    create(meter: Meter, options?: RequestOptions): Promise<Meter>;
     /**
      * Get one meter by slug
      */

package/dist/clients/meter.js

@@ -17,6 +17,20 @@ export class MetersClient extends BaseClient {
     constructor(config) {
         super(config);
     }
+    /**
+     * Create a meter
+     */
+    async create(meter, options) {
+        return this.request({
+            method: 'POST',
+            path: `/api/v1/meters`,
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(meter),
+            options,
+        });
+    }
     /**
      * Get one meter by slug
      */
@@ -62,3 +76,4 @@ export class MetersClient extends BaseClient {
         });
     }
 }
+//# sourceMappingURL=meter.js.map

package/dist/clients/meter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meter.js","sourceRoot":"","sources":["../../clients/meter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAmC,MAAM,aAAa,CAAA;AAEzE,MAAM,CAAN,IAAY,UAIX;AAJD,WAAY,UAAU;IACpB,+BAAiB,CAAA;IACjB,2BAAa,CAAA;IACb,yBAAW,CAAA;AACb,CAAC,EAJW,UAAU,KAAV,UAAU,QAIrB;AAED,MAAM,CAAN,IAAY,gBAMX;AAND,WAAY,gBAAgB;IAC1B,+BAAW,CAAA;IACX,mCAAe,CAAA;IACf,+BAAW,CAAA;IACX,+BAAW,CAAA;IACX,+BAAW,CAAA;AACb,CAAC,EANW,gBAAgB,KAAhB,gBAAgB,QAM3B;AAgDD,MAAM,OAAO,YAAa,SAAQ,UAAU;IAC1C,YAAY,MAAuB;QACjC,KAAK,CAAC,MAAM,CAAC,CAAA;IACf,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,MAAM,CAAC,KAAY,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAQ;YACzB,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;YAC3B,OAAO;SACR,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,GAAG,CAAC,IAAY,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAQ;YACzB,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,kBAAkB,IAAI,EAAE;YAC9B,OAAO;SACR,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,IAAI,CAAC,OAAwB;QACxC,OAAO,IAAI,CAAC,OAAO,CAAU;YAC3B,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gBAAgB;YACtB,OAAO;SACR,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,KAAK,CAChB,IAAY,EACZ,MAAyB,EACzB,OAAwB;QAExB,MAAM,YAAY,GAAG,MAAM;YACzB,CAAC,CAAC,UAAU,CAAC,iBAAiB,CAAC,MAAM,CAAC;YACtC,CAAC,CAAC,SAAS,CAAA;QACb,OAAO,IAAI,CAAC,OAAO,CAAqB;YACtC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,kBAAkB,IAAI,QAAQ;YACpC,YAAY;YACZ,OAAO;SACR,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,QAAQ,CACnB,IAAY,EACZ,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAW;YAC5B,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,kBAAkB,IAAI,WAAW;YACvC,OAAO;SACR,CAAC,CAAA;IACJ,CAAC;CACF"}

package/dist/clients/pagination.d.ts

@@ -0,0 +1,6 @@
+export interface Paginated<T> {
+    items: T[];
+    totalCount: number;
+    page: number;
+    pageSize: number;
+}

package/dist/clients/pagination.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pagination.js.map

package/dist/clients/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../clients/pagination.ts"],"names":[],"mappings":""}

package/dist/clients/portal.d.ts

@@ -0,0 +1,22 @@
+import { components } from '../schemas/openapi.js';
+import { RequestOptions, BaseClient, OpenMeterConfig } from './client.js';
+export type PortalToken = components['schemas']['PortalToken'];
+export declare class PortalClient extends BaseClient {
+    constructor(config: OpenMeterConfig);
+    /**
+     * Create portal token
+     * Useful for creating a token sharable with your customer to query their own usage
+     */
+    createToken(token: {
+        subject: string;
+        expiresAt?: Date;
+        allowedMeterSlugs?: string[];
+    }, options?: RequestOptions): Promise<PortalToken>;
+    /**
+     * Invalidate portal token
+     * @note OpenMeter Cloud only feature
+     */
+    invalidateTokens(invalidate?: {
+        subject?: string;
+    }, options?: RequestOptions): Promise<void>;
+}

package/dist/clients/portal.js

@@ -0,0 +1,37 @@
+import { BaseClient } from './client.js';
+export class PortalClient extends BaseClient {
+    constructor(config) {
+        super(config);
+    }
+    /**
+     * Create portal token
+     * Useful for creating a token sharable with your customer to query their own usage
+     */
+    async createToken(token, options) {
+        return await this.request({
+            path: '/api/v1/portal/tokens',
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(token),
+            options,
+        });
+    }
+    /**
+     * Invalidate portal token
+     * @note OpenMeter Cloud only feature
+     */
+    async invalidateTokens(invalidate = {}, options) {
+        return await this.request({
+            path: '/api/v1/portal/tokens/invalidate',
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(invalidate),
+            options,
+        });
+    }
+}
+//# sourceMappingURL=portal.js.map

package/dist/clients/portal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal.js","sourceRoot":"","sources":["../../clients/portal.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,UAAU,EAAmB,MAAM,aAAa,CAAA;AAIzE,MAAM,OAAO,YAAa,SAAQ,UAAU;IAC1C,YAAY,MAAuB;QACjC,KAAK,CAAC,MAAM,CAAC,CAAA;IACf,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,WAAW,CACtB,KAIC,EACD,OAAwB;QAExB,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC;YACxB,IAAI,EAAE,uBAAuB;YAC7B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;YAC3B,OAAO;SACR,CAAC,CAAA;IACJ,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,gBAAgB,CAC3B,aAAmC,EAAE,EACrC,OAAwB;QAExB,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC;YACxB,IAAI,EAAE,kCAAkC;YACxC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;YAChC,OAAO;SACR,CAAC,CAAA;IACJ,CAAC;CACF"}

package/dist/clients/subject.d.ts

@@ -0,0 +1,125 @@
+import { components } from '../schemas/openapi.js';
+import { RequestOptions, BaseClient, OpenMeterConfig } from './client.js';
+import { Entitlement, EntitlementCreateInputs, EntitlementResetInputs, EntitlementValue, GetEntitlementHistoryQueryParams, ListEntitlementQueryParams, WindowedBalanceHistory } from './entitlement.js';
+import { EntitlementGrant, EntitlementGrantCreateInput, ListEntitlementGrantQueryParams } from './grant.js';
+export type Subject = components['schemas']['Subject'];
+export declare class SubjectClient extends BaseClient {
+    constructor(config: OpenMeterConfig);
+    /**
+     * Upsert subject
+     * Useful to map display name and metadata to subjects
+     * @note OpenMeter Cloud only feature
+     */
+    upsert(subject: Omit<Subject, 'id'>[], options?: RequestOptions): Promise<Subject[]>;
+    /**
+     * Get subject by id or key
+     * @note OpenMeter Cloud only feature
+     */
+    get(idOrKey: string, options?: RequestOptions): Promise<Subject>;
+    /**
+     * List subjects
+     * @note OpenMeter Cloud only feature
+     */
+    list(options?: RequestOptions): Promise<Subject[]>;
+    /**
+     * Delete subject by id or key
+     * @note OpenMeter Cloud only feature
+     */
+    delete(idOrKey: string, options?: RequestOptions): Promise<void>;
+    /** Entitlements **/
+    /**
+     * Create Entitlement
+     * Entitlements allows you to manage subject feature access, balances, and usage limits.
+     * @remarks
+     * Input should be either `EntitlementMeteredCreateInputs`, `EntitlementStaticCreateInputs`, or `EntitlementBooleanCreateInputs`
+     * @example
+     * // Issue 10,000,000 tokens every month
+     * const entitlement = await openmeter.subjects.createEntitlement('customer-1', {
+     *    type: 'metered',
+     *    featureKey: 'ai_tokens',
+     *    usagePeriod: {
+     *      interval: 'MONTH',
+     *    },
+     *    issueAfterReset: 10000000,
+     * })
+     */
+    createEntitlement(subjectIdOrKey: string, input: EntitlementCreateInputs, options?: RequestOptions): Promise<Entitlement>;
+    /**
+     * List entitlements of a subject
+     * @example
+     * const entitlement = await openmeter.subjects.listEntitlements('customer-1')
+     */
+    listEntitlements(subjectIdOrKey: string, params?: ListEntitlementQueryParams, options?: RequestOptions): Promise<Entitlement[]>;
+    /**
+     * Get entitlement
+     *
+     * @example
+     * const entitlement = await openmeter.subjects.getEntitlement('customer-1', '01J1SD3QDV86GP77TQ4PZZ4EXE')
+     */
+    getEntitlement(subjectIdOrKey: string, entitlementId: string, options?: RequestOptions): Promise<Entitlement>;
+    /**
+     * Delete entitlement
+     * @example
+     * await openmeter.deleteEntitlement('customer-1', '01J1SD3QDV86GP77TQ4PZZ4EXE')
+     */
+    deleteEntitlement(subjectIdOrKey: string, entitlementId: string, options?: RequestOptions): Promise<void>;
+    /**
+     * Get entitlement value by ID or Feature Key
+     *
+     * @example
+     * const value = await openmeter.subjects.getEntitlementValue('customer-1', 'ai_tokens')
+     */
+    getEntitlementValue(subjectIdOrKey: string, entitlementIdOrFeatureKey: string, options?: RequestOptions): Promise<EntitlementValue>;
+    /**
+     * Get entitlement value at a specific time.
+     *
+     * @example
+     * const value = await openmeter.subjects.getEntitlementValueAt('customer-1', 'ai_tokens', new Date('2024-01-01'))
+     */
+    getEntitlementValueAt(subjectIdOrKey: string, entitlementIdOrFeatureKey: string, at: Date, options?: RequestOptions): Promise<EntitlementValue>;
+    /**
+     * Get entitlement history
+     * @example
+     * const entitlement = await openmeter.subjects.getEntitlementHistory('customer-1', '01J1SD3QDV86GP77TQ4PZZ4EXE')
+     */
+    getEntitlementHistory(subjectIdOrKey: string, entitlementId: string, params?: GetEntitlementHistoryQueryParams, options?: RequestOptions): Promise<WindowedBalanceHistory[]>;
+    /**
+     * Reset Entitlement Usage
+     * Reset the entitlement usage and start a new period. Eligible grants will be rolled over
+     *
+     * @example
+     * const entitlement = await openmeter.subjects.resetEntitlementUsage('customer-1', '01J1SD3QDV86GP77TQ4PZZ4EXE', {
+     *    retainAnchor: true
+     * })
+     */
+    resetEntitlementUsage(subjectIdOrKey: string, entitlementId: string, input: EntitlementResetInputs, options?: RequestOptions): Promise<Entitlement>;
+    /** Entitlement Grant **/
+    /**
+     * Create Entitlement Grant
+     * Create a grant for an entitlement.
+     *
+     * @example
+     * const grant = await openmeter.subjects.createEntitlementGrant('customer-1', '01J1SD3QDV86GP77TQ4PZZ4EXE', {
+     *    amount: 100,
+     *    priority: 1,
+     *    effectiveAt: '2023-01-01T00:00:00Z',
+     *    expiration: {
+     *      duration: 'HOUR',
+     *      count: 12,
+     *    },
+     *    minRolloverAmount: 100,
+     *    maxRolloverAmount: 100,
+     *    recurrence: {
+     *      interval: 'MONTH',
+     *      anchor: '2024-06-28T18:29:44.867Z',
+     *    },
+     * })
+     */
+    createEntitlementGrant(subjectIdOrKey: string, entitlementIdOrFeatureKey: string, input: EntitlementGrantCreateInput, options?: RequestOptions): Promise<EntitlementGrant>;
+    /**
+     * List entitlement grants
+     * @example
+     * const entitlement = await openmeter.subjects.listEntitlementGrants('customer-1', '01J1SD3QDV86GP77TQ4PZZ4EXE')
+     */
+    listEntitlementGrants(subjectIdOrKey: string, entitlementIdOrFeatureKey: string, params?: ListEntitlementGrantQueryParams, options?: RequestOptions): Promise<EntitlementGrant[]>;
+}