@openmeter/sdk 1.0.0-alpha.3 → 1.0.0-beta-7b2d9ed372e3

package/dist/cjs/src/client/entitlements.d.cts

@@ -0,0 +1,506 @@
+import { type RequestOptions } from './utils.cjs';
+import type { EntitlementCreateInputs, EntitlementGrantCreateInput, operations, paths, ResetEntitlementUsageInput } from './schemas.cjs';
+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<{
+        data?: never;
+        error: import("./utils.cjs").Problem;
+        response: Response;
+    } | {
+        data: import("openapi-typescript-helpers").SuccessResponse<{
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": import("./schemas.cjs").components["schemas"]["Entitlement"];
+                };
+            };
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": import("./schemas.cjs").components["schemas"]["BadRequestProblemResponse"];
+                };
+            };
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": import("./schemas.cjs").components["schemas"]["UnauthorizedProblemResponse"];
+                };
+            };
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": import("./schemas.cjs").components["schemas"]["ForbiddenProblemResponse"];
+                };
+            };
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": import("./schemas.cjs").components["schemas"]["ConflictProblemResponse"];
+                };
+            };
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": import("./schemas.cjs").components["schemas"]["InternalServerErrorProblemResponse"];
+                };
+            };
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": import("./schemas.cjs").components["schemas"]["ServiceUnavailableProblemResponse"];
+                };
+            };
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": import("./schemas.cjs").components["schemas"]["UnexpectedProblemResponse"];
+                };
+            };
+        }, `${string}/${string}`>;
+        error?: never;
+        response: Response;
+    }>;
+    /**
+     * 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<{
+        data?: never;
+        error: import("./utils.cjs").Problem;
+        response: Response;
+    } | {
+        data: import("openapi-typescript-helpers").SuccessResponse<{
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": import("./schemas.cjs").components["schemas"]["Entitlement"];
+                };
+            };
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": import("./schemas.cjs").components["schemas"]["BadRequestProblemResponse"];
+                };
+            };
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": import("./schemas.cjs").components["schemas"]["UnauthorizedProblemResponse"];
+                };
+            };
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": import("./schemas.cjs").components["schemas"]["ForbiddenProblemResponse"];
+                };
+            };
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": import("./schemas.cjs").components["schemas"]["NotFoundProblemResponse"];
+                };
+            };
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": import("./schemas.cjs").components["schemas"]["InternalServerErrorProblemResponse"];
+                };
+            };
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": import("./schemas.cjs").components["schemas"]["ServiceUnavailableProblemResponse"];
+                };
+            };
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": import("./schemas.cjs").components["schemas"]["UnexpectedProblemResponse"];
+                };
+            };
+        }, `${string}/${string}`>;
+        error?: never;
+        response: Response;
+    }>;
+    /**
+     * List entitlements
+     *
+     * @param query - The query parameters
+     * @param signal - An optional abort signal
+     * @returns The entitlements
+     */
+    list(query?: operations['listEntitlements']['parameters']['query'], options?: RequestOptions): Promise<{
+        data?: never;
+        error: import("./utils.cjs").Problem;
+        response: Response;
+    } | {
+        data: import("openapi-typescript-helpers").SuccessResponse<{
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": import("./schemas.cjs").components["schemas"]["ListEntitlementsResult"];
+                };
+            };
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": import("./schemas.cjs").components["schemas"]["BadRequestProblemResponse"];
+                };
+            };
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": import("./schemas.cjs").components["schemas"]["UnauthorizedProblemResponse"];
+                };
+            };
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": import("./schemas.cjs").components["schemas"]["ForbiddenProblemResponse"];
+                };
+            };
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": import("./schemas.cjs").components["schemas"]["InternalServerErrorProblemResponse"];
+                };
+            };
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": import("./schemas.cjs").components["schemas"]["ServiceUnavailableProblemResponse"];
+                };
+            };
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": import("./schemas.cjs").components["schemas"]["UnexpectedProblemResponse"];
+                };
+            };
+        }, `${string}/${string}`>;
+        error?: never;
+        response: Response;
+    }>;
+    /**
+     * 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<{
+        data?: never;
+        error: import("./utils.cjs").Problem;
+        response: Response;
+    } | {
+        data: undefined;
+        error?: never;
+        response: Response;
+    }>;
+    /**
+     * 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<{
+        data?: never;
+        error: import("./utils.cjs").Problem;
+        response: Response;
+    } | {
+        data: {
+            readonly hasAccess: boolean;
+            readonly balance?: number;
+            readonly usage?: number;
+            readonly overage?: number;
+            readonly config?: string;
+        };
+        error?: never;
+        response: Response;
+    }>;
+    /**
+     * 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<{
+        data?: never;
+        error: import("./utils.cjs").Problem;
+        response: Response;
+    } | {
+        data: {
+            windowedHistory: import("./schemas.cjs").components["schemas"]["BalanceHistoryWindow"][];
+            burndownHistory: import("./schemas.cjs").components["schemas"]["GrantBurnDownHistorySegment"][];
+        };
+        error?: never;
+        response: Response;
+    }>;
+    /**
+     * 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<{
+        data?: never;
+        error: import("./utils.cjs").Problem;
+        response: Response;
+    } | {
+        data: import("openapi-typescript-helpers").SuccessResponse<{
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": import("./schemas.cjs").components["schemas"]["Entitlement"];
+                };
+            };
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": import("./schemas.cjs").components["schemas"]["BadRequestProblemResponse"];
+                };
+            };
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": import("./schemas.cjs").components["schemas"]["UnauthorizedProblemResponse"];
+                };
+            };
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": import("./schemas.cjs").components["schemas"]["ForbiddenProblemResponse"];
+                };
+            };
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": import("./schemas.cjs").components["schemas"]["NotFoundProblemResponse"];
+                };
+            };
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": import("./schemas.cjs").components["schemas"]["ConflictProblemResponse"];
+                };
+            };
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": import("./schemas.cjs").components["schemas"]["InternalServerErrorProblemResponse"];
+                };
+            };
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": import("./schemas.cjs").components["schemas"]["ServiceUnavailableProblemResponse"];
+                };
+            };
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": import("./schemas.cjs").components["schemas"]["UnexpectedProblemResponse"];
+                };
+            };
+        }, `${string}/${string}`>;
+        error?: never;
+        response: Response;
+    }>;
+    /**
+     * 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<{
+        data?: never;
+        error: import("./utils.cjs").Problem;
+        response: Response;
+    } | {
+        data: undefined;
+        error?: never;
+        response: Response;
+    }>;
+}
+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<{
+        data?: never;
+        error: import("./utils.cjs").Problem;
+        response: Response;
+    } | {
+        data: {
+            readonly createdAt: Date;
+            readonly updatedAt: Date;
+            readonly deletedAt?: Date;
+            amount: number;
+            priority?: number;
+            effectiveAt: Date;
+            expiration: import("./schemas.cjs").components["schemas"]["ExpirationPeriod"];
+            maxRolloverAmount?: number;
+            minRolloverAmount?: number;
+            metadata?: import("./schemas.cjs").components["schemas"]["Metadata"];
+            readonly id: string;
+            readonly entitlementId: string;
+            nextRecurrence?: Date;
+            readonly expiresAt?: Date;
+            voidedAt?: Date;
+            recurrence?: import("./schemas.cjs").components["schemas"]["RecurringPeriod"];
+        };
+        error?: never;
+        response: Response;
+    }>;
+    /**
+     * 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<{
+        data?: never;
+        error: import("./utils.cjs").Problem;
+        response: Response;
+    } | {
+        data: {
+            readonly createdAt: Date;
+            readonly updatedAt: Date;
+            readonly deletedAt?: Date;
+            amount: number;
+            priority?: number;
+            effectiveAt: Date;
+            expiration: import("./schemas.cjs").components["schemas"]["ExpirationPeriod"];
+            maxRolloverAmount?: number;
+            minRolloverAmount?: number;
+            metadata?: import("./schemas.cjs").components["schemas"]["Metadata"];
+            readonly id: string;
+            readonly entitlementId: string;
+            nextRecurrence?: Date;
+            readonly expiresAt?: Date;
+            voidedAt?: Date;
+            recurrence?: import("./schemas.cjs").components["schemas"]["RecurringPeriod"];
+        }[];
+        error?: never;
+        response: Response;
+    }>;
+}

package/dist/cjs/src/client/entitlements.js.map

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

package/dist/cjs/src/client/events.cjs

@@ -0,0 +1,65 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Events = void 0;
+const crypto_1 = __importDefault(require("crypto"));
+const utils_js_1 = require("./utils.cjs");
+/**
+ * Events are used to track usage of your product or service.
+ * Events are processed asynchronously by the meters, so they may not be immediately available for querying.
+ */
+class Events {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Ingests an event or batch of events
+     * @param events - The events to ingest
+     * @param signal - An optional abort signal
+     * @returns The ingested events
+     */
+    async ingest(events, options) {
+        const body = (Array.isArray(events) ? events : [events]).map(transformEvent);
+        const resp = await this.client.POST('/api/v1/events', {
+            body,
+            headers: {
+                'Content-Type': 'application/cloudevents-batch+json',
+            },
+            ...options,
+        });
+        return (0, utils_js_1.transformResponse)(resp);
+    }
+    /**
+     * List ingested events
+     * @param query - The query parameters
+     * @param signal - An optional abort signal
+     * @returns The events
+     */
+    async list(query, options) {
+        const resp = await this.client.GET('/api/v1/events', {
+            params: {
+                query,
+            },
+            ...options,
+        });
+        return (0, utils_js_1.transformResponse)(resp);
+    }
+}
+exports.Events = Events;
+function transformEvent(ev) {
+    return {
+        data: ev.data,
+        datacontenttype: ev.datacontenttype ?? 'application/json',
+        dataschema: ev.dataschema,
+        id: ev.id ?? crypto_1.default.randomUUID(),
+        source: ev.source ?? '@openmeter/sdk',
+        specversion: ev.specversion ?? '1.0',
+        subject: ev.subject,
+        time: ev.time,
+        type: ev.type,
+    };
+}
+//# sourceMappingURL=events.js.map

package/dist/cjs/src/client/events.d.cts

@@ -0,0 +1,102 @@
+import { type RequestOptions } from './utils.cjs';
+import type { operations, paths } from './schemas.cjs';
+import type { Client } from 'openapi-fetch';
+/**
+ * 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>;
+};
+/**
+ * Events are used to track usage of your product or service.
+ * Events are processed asynchronously by the meters, so they may not be immediately available for querying.
+ */
+export declare class Events {
+    private client;
+    constructor(client: Client<paths, `${string}/${string}`>);
+    /**
+     * Ingests an event or batch of events
+     * @param events - The events to ingest
+     * @param signal - An optional abort signal
+     * @returns The ingested events
+     */
+    ingest(events: Event | Event[], options?: RequestOptions): Promise<{
+        data?: never;
+        error: import("./utils.cjs").Problem;
+        response: Response;
+    } | {
+        data: undefined;
+        error?: never;
+        response: Response;
+    }>;
+    /**
+     * List ingested events
+     * @param query - The query parameters
+     * @param signal - An optional abort signal
+     * @returns The events
+     */
+    list(query?: operations['listEvents']['parameters']['query'], options?: RequestOptions): Promise<{
+        data?: never;
+        error: import("./utils.cjs").Problem;
+        response: Response;
+    } | {
+        data: {
+            event: import("./schemas.cjs").components["schemas"]["Event"];
+            validationError?: string;
+            ingestedAt: Date;
+            storedAt: Date;
+        }[];
+        error?: never;
+        response: Response;
+    }>;
+}

package/dist/cjs/src/client/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../../src/client/events.ts"],"names":[],"mappings":";;;;;;AAAA,oDAA2B;AAC3B,yCAAmE;AA6DnE;;;GAGG;AACH,MAAa,MAAM;IACG;IAApB,YAAoB,MAA4C;QAA5C,WAAM,GAAN,MAAM,CAAsC;IAAG,CAAC;IAEpE;;;;;OAKG;IACI,KAAK,CAAC,MAAM,CAAC,MAAuB,EAAE,OAAwB;QACnE,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;QAE5E,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE;YACpD,IAAI;YACJ,OAAO,EAAE;gBACP,cAAc,EAAE,oCAAoC;aACrD;YACD,GAAG,OAAO;SACX,CAAC,CAAA;QAEF,OAAO,IAAA,4BAAiB,EAAC,IAAI,CAAC,CAAA;IAChC,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,IAAI,CACf,KAAuD,EACvD,OAAwB;QAExB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,gBAAgB,EAAE;YACnD,MAAM,EAAE;gBACN,KAAK;aACN;YACD,GAAG,OAAO;SACX,CAAC,CAAA;QAEF,OAAO,IAAA,4BAAiB,EAAC,IAAI,CAAC,CAAA;IAChC,CAAC;CACF;AA1CD,wBA0CC;AAED,SAAS,cAAc,CAAC,EAAS;IAC/B,OAAO;QACL,IAAI,EAAE,EAAE,CAAC,IAAI;QACb,eAAe,EAAE,EAAE,CAAC,eAAe,IAAI,kBAAkB;QACzD,UAAU,EAAE,EAAE,CAAC,UAAU;QACzB,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,gBAAM,CAAC,UAAU,EAAE;QAChC,MAAM,EAAE,EAAE,CAAC,MAAM,IAAI,gBAAgB;QACrC,WAAW,EAAE,EAAE,CAAC,WAAW,IAAI,KAAK;QACpC,OAAO,EAAE,EAAE,CAAC,OAAO;QACnB,IAAI,EAAE,EAAE,CAAC,IAAI;QACb,IAAI,EAAE,EAAE,CAAC,IAAI;KACd,CAAA;AACH,CAAC"}