@openmeter/sdk 1.0.0-beta.9 → 1.0.0-beta.90

package/README.md

@@ -54,6 +54,12 @@ const event: Event = {
 await openmeter.events.ingest(event)
 ```
 
+### batch ingest
+
+```ts
+await openmeter.events.ingest([event1, event2, event3])
+```
+
 #### list
 
 Retrieve latest raw events. Useful for debugging.
@@ -96,7 +102,7 @@ const values = await openmeter.meters.query('my-meter-slug', {
 })
 ```
 
-#### subjects
+#### meter subjects
 
 List meter subjects.
 
@@ -104,57 +110,63 @@ List meter subjects.
 const subjects = await openmeter.meters.subjects('my-meter-slug')
 ```
 
-## Helpers
+### Portal
 
-### Vercel AI SDK / Next.js
+#### createToken
 
-The OpenAI streaming API used by the Vercel AI SDK doesn't return token usage metadata by default.
-The OpenMeter `createOpenAIStreamCallback` helper function decorates the callback with a `onUsage`
-callback which you can use to report usage to OpenMeter.
+Create subject specific tokens.
+Useful to build consumer dashboards.
 
 ```ts
-import OpenAI from 'openai'
-import { OpenAIStream, StreamingTextResponse } from 'ai'
-import { createOpenAIStreamCallback } from '@openmeter/sdk'
-
-export async function POST(req: Request) {
-  const { messages } = await req.json()
-  const model = 'gpt-3.5-turbo'
-
-  const response = await openai.chat.completions.create({
-    model,
-    messages,
-    stream: true,
-  })
-
-  const streamCallbacks = await createOpenAIStreamCallback(
-    {
-      model,
-      prompts: messages.map(({ content }) => content),
-    },
-    {
-      // onToken() => {...}
-      // onFinal() => {...}
-      async onUsage(usage) {
-        try {
-          await openmeter.events.ingest({
-            source: 'my-app',
-            type: 'my-event-type',
-            subject: 'my-customer-id',
-            data: {
-              // Usage is { total_tokens, prompt_tokens, completion_tokens }
-              ...usage,
-              model,
-            },
-          })
-        } catch (err) {
-          console.error('failed to ingest usage', err)
-        }
-      },
-    }
-  )
-
-  const stream = OpenAIStream(response, streamCallbacks)
-  return new StreamingTextResponse(stream)
-}
+const token = await openmeter.portal.createToken({ subject: 'customer-1' })
+```
+
+#### invalidateTokens
+
+Invalidate portal tokens for all or specific subjects.
+
+```ts
+await openmeter.portal.invalidateTokens()
+```
+
+### Subject
+
+Subject mappings. Like display name and metadata.
+
+#### upsert
+
+Upsert subjects.
+
+```ts
+const subjects = await openmeter.subjects.upsert([
+  {
+    key: 'customer-1',
+    displayName: 'ACME'
+  }
+])
+```
+
+#### list
+
+List subjects.
+
+```ts
+const subjects = await openmeter.subjects.list()
+```
+
+#### get
+
+Get subject by key.
+
+```ts
+const subjects = await openmeter.subjects.get('customer-1')
+```
+
+#### delete
+
+Delete subject by key.
+It doesn't delete corresponding usage.
+
+```ts
+await openmeter.subjects.delete('customer-1')
 ```

package/dist/cjs/clients/client.cjs

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpError = exports.BaseClient = void 0;
+const undici_1 = require("undici");
+class BaseClient {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async request({ path, method, searchParams, headers, body, options, }) {
+        // Building URL
+        const url = this.getUrl(path, searchParams);
+        // Request options
+        const reqHeaders = {
+            Accept: 'application/json',
+            ...headers,
+            ...this.getAuthHeaders(),
+            ...this.config.headers,
+            ...options?.headers,
+        };
+        const reqOpts = {
+            method,
+            headers: reqHeaders,
+        };
+        // Optional body
+        if (body) {
+            if (!reqHeaders['Content-Type'] && !reqHeaders['content-type']) {
+                throw new Error('Content Type is required with body');
+            }
+            reqOpts.body = body;
+        }
+        const resp = await (0, undici_1.request)(url, reqOpts);
+        // Error handling
+        if (resp.statusCode > 399) {
+            if (resp.headers['content-type'] === 'application/problem+json') {
+                const problem = (await resp.body.json());
+                throw new HttpError({
+                    statusCode: resp.statusCode,
+                    problem,
+                });
+            }
+            // Requests can fail before API, in this case we only have a status code
+            throw new HttpError({
+                statusCode: resp.statusCode,
+            });
+        }
+        // Response parsing
+        if (resp.statusCode === 204 || resp.headers['content-length'] === '0') {
+            return undefined;
+        }
+        if (resp.headers['content-type'] === 'application/json') {
+            return (await resp.body.json());
+        }
+        if (!resp.headers['content-type']) {
+            throw new Error('Missing content type');
+        }
+        throw new Error(`Unknown content type: ${resp.headers['content-type']}`);
+    }
+    getUrl(path, searchParams) {
+        let qs = searchParams ? searchParams.toString() : '';
+        qs = qs.length > 0 ? `?${qs}` : '';
+        const url = new URL(`${path}${qs}`, this.config.baseUrl);
+        return url;
+    }
+    getAuthHeaders() {
+        if (this.config.token) {
+            return {
+                authorization: `Bearer ${this.config.token}`,
+            };
+        }
+        if (this.config.username && this.config.password) {
+            const encoded = Buffer.from(`${this.config.username}:${this.config.password}`).toString('base64');
+            return {
+                authorization: `Basic ${encoded}`,
+            };
+        }
+        return {};
+    }
+    static toURLSearchParams(params) {
+        const searchParams = new URLSearchParams();
+        for (const [key, value] of Object.entries(params)) {
+            if (value === undefined) {
+                continue;
+            }
+            if (Array.isArray(value)) {
+                for (const item of value) {
+                    searchParams.append(key, item);
+                }
+            }
+            else if (value instanceof Date) {
+                searchParams.append(key, value.toISOString());
+            }
+            else if (typeof value === 'object') {
+                Object.entries(value).forEach(([k, v]) => {
+                    searchParams.append(`${key}[${k}]`, v);
+                });
+            }
+            else {
+                searchParams.append(key, value.toString());
+            }
+        }
+        return searchParams;
+    }
+}
+exports.BaseClient = BaseClient;
+class HttpError extends Error {
+    statusCode;
+    problem;
+    constructor({ statusCode, problem, }) {
+        super(problem?.type || 'unexpected status code');
+        this.name = 'HttpError';
+        this.statusCode = statusCode;
+        this.problem = problem;
+    }
+}
+exports.HttpError = HttpError;
+//# sourceMappingURL=client.js.map

package/dist/cjs/clients/client.d.cts

@@ -0,0 +1,40 @@
+/// <reference types="node" />
+/// <reference types="node" />
+/// <reference types="node" />
+import { IncomingHttpHeaders } from 'http';
+import { Dispatcher } from 'undici';
+import { components } from '../schemas/openapi.cjs';
+export type OpenMeterConfig = {
+    baseUrl: string;
+    token?: string;
+    username?: string;
+    password?: string;
+    headers?: IncomingHttpHeaders;
+};
+export type RequestOptions = {
+    headers?: IncomingHttpHeaders;
+};
+export type Problem = components['schemas']['Problem'];
+export declare class BaseClient {
+    protected config: OpenMeterConfig;
+    constructor(config: OpenMeterConfig);
+    protected request<T>({ path, method, searchParams, headers, body, options, }: {
+        path: string;
+        method: Dispatcher.HttpMethod;
+        searchParams?: URLSearchParams;
+        headers?: IncomingHttpHeaders;
+        body?: string | Buffer | Uint8Array;
+        options?: RequestOptions;
+    }): Promise<T>;
+    protected getUrl(path: string, searchParams?: URLSearchParams): import("url").URL;
+    protected getAuthHeaders(): IncomingHttpHeaders;
+    protected static toURLSearchParams(params: Record<string, string | number | Date | string[] | Record<string, string> | undefined>): URLSearchParams;
+}
+export declare class HttpError extends Error {
+    statusCode: number;
+    problem?: Problem;
+    constructor({ statusCode, problem, }: {
+        statusCode: number;
+        problem?: Problem;
+    });
+}

package/dist/cjs/clients/client.js.map

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

package/dist/cjs/clients/event.cjs

@@ -0,0 +1,71 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventsClient = void 0;
+const crypto_1 = __importDefault(require("crypto"));
+const client_js_1 = require("./client.cjs");
+class EventsClient extends client_js_1.BaseClient {
+    constructor(config) {
+        super(config);
+    }
+    /**
+     * Ingest usage event in a CloudEvents format
+     * @see https://cloudevents.io
+     */
+    async ingest(usageEvent, options) {
+        const isBatch = Array.isArray(usageEvent);
+        const cloudEvents = (isBatch ? usageEvent : [usageEvent]).map((ev) => {
+            // Validate content type
+            if (ev.datacontenttype && ev.datacontenttype !== 'application/json') {
+                throw new TypeError(`Unsupported datacontenttype: ${ev.datacontenttype}`);
+            }
+            // We default where we can to lower the barrier to use CloudEvents
+            const cloudEvent = {
+                specversion: ev.specversion ?? '1.0',
+                id: ev.id ?? crypto_1.default.randomUUID(),
+                source: ev.source ?? '@openmeter/sdk',
+                type: ev.type,
+                subject: ev.subject,
+                time: ev.time?.toISOString(),
+                datacontenttype: ev.datacontenttype,
+                dataschema: ev.dataschema,
+                data: ev.data,
+            };
+            return cloudEvent;
+        });
+        const contentType = isBatch
+            ? 'application/cloudevents-batch+json'
+            : 'application/cloudevents+json';
+        const body = isBatch
+            ? JSON.stringify(cloudEvents)
+            : JSON.stringify(cloudEvents[0]);
+        // Making Request
+        return await this.request({
+            path: '/api/v1/events',
+            method: 'POST',
+            body,
+            headers: {
+                'Content-Type': contentType,
+            },
+            options,
+        });
+    }
+    /**
+     * List raw events
+     */
+    async list(params, options) {
+        const searchParams = params
+            ? client_js_1.BaseClient.toURLSearchParams(params)
+            : undefined;
+        return this.request({
+            method: 'GET',
+            path: `/api/v1/events`,
+            searchParams,
+            options,
+        });
+    }
+}
+exports.EventsClient = EventsClient;
+//# sourceMappingURL=event.js.map

package/dist/cjs/clients/event.d.cts

@@ -0,0 +1,79 @@
+import { components } from '../schemas/openapi.cjs';
+import { RequestOptions, BaseClient, OpenMeterConfig } from './client.cjs';
+export type CloudEvent = components['schemas']['Event'];
+export type IngestedEvent = components['schemas']['IngestedEvent'];
+export type EventsQueryParams = {
+    /**
+     * @description Limit number of results. Max: 100
+     * @example 25
+     */
+    limit?: number;
+};
+/**
+ * Usage Event
+ */
+export type Event = {
+    /**
+     * @description The version of the CloudEvents specification which the event uses.
+     * @example 1.0
+     */
+    specversion?: string;
+    /**
+     * @description Unique identifier for the event, defaults to uuid v4.
+     * @example "5c10fade-1c9e-4d6c-8275-c52c36731d3c"
+     */
+    id?: string;
+    /**
+     * Format: uri-reference
+     * @description Identifies the context in which an event happened, defaults to: @openmeter/sdk
+     * @example services/service-0
+     */
+    source?: string;
+    /**
+     * @description Describes the type of event related to the originating occurrence.
+     * @example "api_request"
+     */
+    type: string;
+    /**
+     * @description Describes the subject of the event in the context of the event producer (identified by source).
+     * @example "customer_id"
+     */
+    subject: string;
+    /**
+     * Format: date-time
+     * @description Date of when the occurrence happened.
+     * @example new Date('2023-01-01T01:01:01.001Z')
+     */
+    time?: Date;
+    /**
+     * Format: uri
+     * @description Identifies the schema that data adheres to.
+     */
+    dataschema?: string;
+    /**
+     * @description Content type of the data value. Must adhere to RFC 2046 format.
+     * @example application/json
+     * @enum {string|null}
+     */
+    datacontenttype?: 'application/json';
+    /**
+     * @description The event payload.
+     * @example {
+     *   "duration_ms": "12",
+     *   "path": "/hello"
+     * }
+     */
+    data: Record<string, unknown>;
+};
+export declare class EventsClient extends BaseClient {
+    constructor(config: OpenMeterConfig);
+    /**
+     * Ingest usage event in a CloudEvents format
+     * @see https://cloudevents.io
+     */
+    ingest(usageEvent: Event | Event[], options?: RequestOptions): Promise<void>;
+    /**
+     * List raw events
+     */
+    list(params?: EventsQueryParams, options?: RequestOptions): Promise<IngestedEvent[]>;
+}

package/dist/cjs/clients/event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../../clients/event.ts"],"names":[],"mappings":";;;;;;AAAA,oDAA2B;AAE3B,2CAAyE;AAuEzE,MAAa,YAAa,SAAQ,sBAAU;IAC1C,YAAY,MAAuB;QACjC,KAAK,CAAC,MAAM,CAAC,CAAA;IACf,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,MAAM,CACjB,UAA2B,EAC3B,OAAwB;QAExB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;QACzC,MAAM,WAAW,GAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CACzE,CAAC,EAAE,EAAE,EAAE;YACL,wBAAwB;YACxB,IAAI,EAAE,CAAC,eAAe,IAAI,EAAE,CAAC,eAAe,KAAK,kBAAkB,EAAE,CAAC;gBACpE,MAAM,IAAI,SAAS,CACjB,gCAAgC,EAAE,CAAC,eAAe,EAAE,CACrD,CAAA;YACH,CAAC;YAED,kEAAkE;YAClE,MAAM,UAAU,GAAe;gBAC7B,WAAW,EAAE,EAAE,CAAC,WAAW,IAAI,KAAK;gBACpC,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,gBAAM,CAAC,UAAU,EAAE;gBAChC,MAAM,EAAE,EAAE,CAAC,MAAM,IAAI,gBAAgB;gBACrC,IAAI,EAAE,EAAE,CAAC,IAAI;gBACb,OAAO,EAAE,EAAE,CAAC,OAAO;gBACnB,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE;gBAC5B,eAAe,EAAE,EAAE,CAAC,eAAe;gBACnC,UAAU,EAAE,EAAE,CAAC,UAAU;gBACzB,IAAI,EAAE,EAAE,CAAC,IAAI;aACd,CAAA;YAED,OAAO,UAAU,CAAA;QACnB,CAAC,CACF,CAAA;QAED,MAAM,WAAW,GAAG,OAAO;YACzB,CAAC,CAAC,oCAAoC;YACtC,CAAC,CAAC,8BAA8B,CAAA;QAClC,MAAM,IAAI,GAAG,OAAO;YAClB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;YAC7B,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;QAElC,iBAAiB;QACjB,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC;YACxB,IAAI,EAAE,gBAAgB;YACtB,MAAM,EAAE,MAAM;YACd,IAAI;YACJ,OAAO,EAAE;gBACP,cAAc,EAAE,WAAW;aAC5B;YACD,OAAO;SACR,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,IAAI,CACf,MAA0B,EAC1B,OAAwB;QAExB,MAAM,YAAY,GAAG,MAAM;YACzB,CAAC,CAAC,sBAAU,CAAC,iBAAiB,CAAC,MAAM,CAAC;YACtC,CAAC,CAAC,SAAS,CAAA;QACb,OAAO,IAAI,CAAC,OAAO,CAAkB;YACnC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gBAAgB;YACtB,YAAY;YACZ,OAAO;SACR,CAAC,CAAA;IACJ,CAAC;CACF;AA5ED,oCA4EC"}

package/dist/cjs/clients/meter.cjs

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetersClient = exports.MeterAggregation = exports.WindowSize = void 0;
+const client_js_1 = require("./client.cjs");
+var WindowSize;
+(function (WindowSize) {
+    WindowSize["MINUTE"] = "MINUTE";
+    WindowSize["HOUR"] = "HOUR";
+    WindowSize["DAY"] = "DAY";
+})(WindowSize || (exports.WindowSize = WindowSize = {}));
+var MeterAggregation;
+(function (MeterAggregation) {
+    MeterAggregation["SUM"] = "SUM";
+    MeterAggregation["COUNT"] = "COUNT";
+    MeterAggregation["AVG"] = "AVG";
+    MeterAggregation["MIN"] = "MIN";
+    MeterAggregation["MAX"] = "MAX";
+})(MeterAggregation || (exports.MeterAggregation = MeterAggregation = {}));
+class MetersClient extends client_js_1.BaseClient {
+    constructor(config) {
+        super(config);
+    }
+    /**
+     * Get one meter by slug
+     */
+    async get(slug, options) {
+        return this.request({
+            method: 'GET',
+            path: `/api/v1/meters/${slug}`,
+            options,
+        });
+    }
+    /**
+     * List meters
+     */
+    async list(options) {
+        return this.request({
+            method: 'GET',
+            path: `/api/v1/meters`,
+            options,
+        });
+    }
+    /**
+     * Query a meter
+     */
+    async query(slug, params, options) {
+        const searchParams = params
+            ? client_js_1.BaseClient.toURLSearchParams(params)
+            : undefined;
+        return this.request({
+            method: 'GET',
+            path: `/api/v1/meters/${slug}/query`,
+            searchParams,
+            options,
+        });
+    }
+    /**
+     * List subjects of a meter
+     */
+    async subjects(slug, options) {
+        return this.request({
+            method: 'GET',
+            path: `/api/v1/meters/${slug}/subjects`,
+            options,
+        });
+    }
+}
+exports.MetersClient = MetersClient;
+//# sourceMappingURL=meter.js.map

package/dist/cjs/clients/meter.d.cts

@@ -0,0 +1,75 @@
+import { paths, components } from '../schemas/openapi.cjs';
+import { BaseClient, OpenMeterConfig, RequestOptions } from './client.cjs';
+export declare enum WindowSize {
+    MINUTE = "MINUTE",
+    HOUR = "HOUR",
+    DAY = "DAY"
+}
+export declare enum MeterAggregation {
+    SUM = "SUM",
+    COUNT = "COUNT",
+    AVG = "AVG",
+    MIN = "MIN",
+    MAX = "MAX"
+}
+export type MeterQueryParams = {
+    /**
+     * @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 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);
+    /**
+     * Get one meter by slug
+     */
+    get(slug: string, options?: RequestOptions): Promise<Meter>;
+    /**
+     * List meters
+     */
+    list(options?: RequestOptions): Promise<Meter[]>;
+    /**
+     * Query a meter
+     */
+    query(slug: string, params?: MeterQueryParams, options?: RequestOptions): Promise<MeterQueryResponse>;
+    /**
+     * List subjects of a meter
+     */
+    subjects(slug: string, options?: RequestOptions): Promise<string[]>;
+}

package/dist/cjs/clients/meter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meter.js","sourceRoot":"","sources":["../../../clients/meter.ts"],"names":[],"mappings":";;;AACA,2CAAyE;AAEzE,IAAY,UAIX;AAJD,WAAY,UAAU;IACpB,+BAAiB,CAAA;IACjB,2BAAa,CAAA;IACb,yBAAW,CAAA;AACb,CAAC,EAJW,UAAU,0BAAV,UAAU,QAIrB;AAED,IAAY,gBAMX;AAND,WAAY,gBAAgB;IAC1B,+BAAW,CAAA;IACX,mCAAe,CAAA;IACf,+BAAW,CAAA;IACX,+BAAW,CAAA;IACX,+BAAW,CAAA;AACb,CAAC,EANW,gBAAgB,gCAAhB,gBAAgB,QAM3B;AAgDD,MAAa,YAAa,SAAQ,sBAAU;IAC1C,YAAY,MAAuB;QACjC,KAAK,CAAC,MAAM,CAAC,CAAA;IACf,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,sBAAU,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;AA3DD,oCA2DC"}

package/dist/cjs/clients/portal.cjs

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PortalClient = void 0;
+const client_js_1 = require("./client.cjs");
+class PortalClient extends client_js_1.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,
+        });
+    }
+}
+exports.PortalClient = PortalClient;
+//# sourceMappingURL=portal.js.map

package/dist/cjs/clients/portal.d.cts

@@ -0,0 +1,22 @@
+import { components } from '../schemas/openapi.cjs';
+import { RequestOptions, BaseClient, OpenMeterConfig } from './client.cjs';
+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/cjs/clients/portal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal.js","sourceRoot":"","sources":["../../../clients/portal.ts"],"names":[],"mappings":";;;AACA,2CAAyE;AAIzE,MAAa,YAAa,SAAQ,sBAAU;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;AA9CD,oCA8CC"}