@nehorai/credits 1.0.2 → 1.3.0

package/dist/sdk/client.js

@@ -1,247 +0,0 @@
-/**
- * CreditsClient - REST API client for the credits system
- *
- * Provides a type-safe interface for consuming credits API endpoints
- * from external services or other applications.
- *
- * @example
- * ```typescript
- * const client = new CreditsClient({
- *   baseUrl: process.env.CREDITS_API_URL,
- *   getAuthToken: async () => session.accessToken,
- * });
- *
- * // Check if user has sufficient credits
- * const check = await client.checkAvailability("story_generation");
- * if (!check.hasCredits) {
- *   console.log("Insufficient credits");
- *   return;
- * }
- *
- * // Two-phase commit pattern
- * const reservation = await client.reserve("story_generation");
- * try {
- *   const result = await doExpensiveWork();
- *   await client.commit(reservation.reservationId);
- *   return result;
- * } catch (error) {
- *   await client.release(reservation.reservationId);
- *   throw error;
- * }
- * ```
- */
-import { parseApiError, NetworkError } from "./errors.js";
-export class CreditsClient {
-    baseUrl;
-    getAuthToken;
-    fetchFn;
-    constructor(config) {
-        // Ensure baseUrl doesn't have trailing slash
-        this.baseUrl = config.baseUrl.replace(/\/$/, "");
-        this.getAuthToken = config.getAuthToken;
-        this.fetchFn = config.fetch ?? fetch;
-    }
-    /**
-     * Make an authenticated request to the API
-     */
-    async request(path, options = {}) {
-        const { method = "GET", body, params } = options;
-        // Build URL with query params
-        let url = `${this.baseUrl}${path}`;
-        if (params) {
-            const searchParams = new URLSearchParams();
-            for (const [key, value] of Object.entries(params)) {
-                if (value !== undefined) {
-                    searchParams.set(key, String(value));
-                }
-            }
-            const queryString = searchParams.toString();
-            if (queryString) {
-                url += `?${queryString}`;
-            }
-        }
-        // Build headers
-        const headers = {
-            "Content-Type": "application/json",
-        };
-        // Add auth token if available
-        if (this.getAuthToken) {
-            try {
-                const token = await this.getAuthToken();
-                if (token) {
-                    headers["Authorization"] = `Bearer ${token}`;
-                }
-            }
-            catch {
-                // Auth token not available, proceed without it
-            }
-        }
-        // Make the request
-        let response;
-        try {
-            response = await this.fetchFn(url, {
-                method,
-                headers,
-                body: body ? JSON.stringify(body) : undefined,
-            });
-        }
-        catch (error) {
-            throw new NetworkError(error instanceof Error ? error.message : "Network request failed", error instanceof Error ? error : undefined);
-        }
-        // Parse response
-        const responseBody = (await response.json());
-        // Handle errors
-        if (!response.ok) {
-            throw parseApiError(response.status, responseBody);
-        }
-        // Return data
-        return responseBody.data;
-    }
-    /**
-     * Get the current user's credit balance
-     *
-     * @returns User's credit information
-     * @throws AuthenticationError if not authenticated
-     */
-    async getBalance() {
-        return this.request("/api/v1/credits/balance");
-    }
-    /**
-     * Check if the user has sufficient credits for an operation
-     *
-     * @param operationType - Type of operation to check
-     * @param customCost - Optional custom cost to check against
-     * @returns Credit availability status
-     * @throws AuthenticationError if not authenticated
-     */
-    async checkAvailability(operationType, customCost) {
-        return this.request("/api/v1/credits/availability", {
-            params: {
-                operationType,
-                customCost: customCost?.toString(),
-            },
-        });
-    }
-    /**
-     * Reserve credits for an operation
-     *
-     * This is the first step in the two-phase commit pattern.
-     * Reserved credits are held for 5 minutes before expiring.
-     *
-     * @param operationType - Type of operation
-     * @param options - Optional reservation options
-     * @returns Reservation details including ID and expiry
-     * @throws InsufficientCreditsError if not enough credits
-     * @throws AuthenticationError if not authenticated
-     */
-    async reserve(operationType, options) {
-        return this.request("/api/v1/credits/reserve", {
-            method: "POST",
-            body: {
-                operationType,
-                ...options,
-            },
-        });
-    }
-    /**
-     * Commit a reservation (deduct credits)
-     *
-     * This is the second step in the two-phase commit pattern.
-     * Call this after your operation succeeds.
-     *
-     * @param reservationId - ID of the reservation to commit
-     * @throws ReservationNotFoundError if reservation doesn't exist
-     * @throws ReservationExpiredError if reservation has expired
-     * @throws AuthenticationError if not authenticated
-     */
-    async commit(reservationId) {
-        await this.request("/api/v1/credits/commit", {
-            method: "POST",
-            body: { reservationId },
-        });
-    }
-    /**
-     * Release a reservation (refund credits)
-     *
-     * Call this if your operation fails after reserving credits.
-     *
-     * @param reservationId - ID of the reservation to release
-     * @throws ReservationNotFoundError if reservation doesn't exist
-     * @throws AuthenticationError if not authenticated
-     */
-    async release(reservationId) {
-        await this.request("/api/v1/credits/release", {
-            method: "POST",
-            body: { reservationId },
-        });
-    }
-    /**
-     * Get usage history for the current user
-     *
-     * @param options - Optional pagination options
-     * @returns Paginated list of usage entries
-     * @throws AuthenticationError if not authenticated
-     */
-    async getHistory(options) {
-        return this.request("/api/v1/credits/history", {
-            params: {
-                page: options?.page,
-                limit: options?.limit,
-            },
-        });
-    }
-    /**
-     * Get the available credits (balance + bonus - reserved)
-     *
-     * Convenience method that calculates available credits from balance.
-     *
-     * @returns Number of available credits
-     * @throws AuthenticationError if not authenticated
-     */
-    async getAvailableCredits() {
-        const balance = await this.getBalance();
-        return balance.balance + balance.bonusCredits - balance.reserved;
-    }
-    /**
-     * Execute an operation with automatic credit handling
-     *
-     * This is a convenience method that handles the full two-phase commit
-     * pattern automatically.
-     *
-     * @param operationType - Type of operation
-     * @param operation - The operation to execute
-     * @param options - Optional reservation options
-     * @returns Result of the operation
-     * @throws InsufficientCreditsError if not enough credits
-     * @throws AuthenticationError if not authenticated
-     *
-     * @example
-     * ```typescript
-     * const result = await client.withCredits(
-     *   "story_generation",
-     *   async () => {
-     *     return generateStory(data);
-     *   }
-     * );
-     * ```
-     */
-    async withCredits(operationType, operation, options) {
-        const reservation = await this.reserve(operationType, options);
-        try {
-            const result = await operation();
-            await this.commit(reservation.reservationId);
-            return result;
-        }
-        catch (error) {
-            // Always attempt to release on failure
-            try {
-                await this.release(reservation.reservationId);
-            }
-            catch {
-                // Ignore release errors, original error is more important
-            }
-            throw error;
-        }
-    }
-}
-//# sourceMappingURL=client.js.map

package/dist/sdk/client.js.map

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

package/dist/sdk/errors.d.ts

@@ -1,91 +0,0 @@
-/**
- * SDK error classes
- *
- * Provides typed error handling for SDK operations.
- */
-import { type SDKErrorCodeType } from "./types.js";
-/**
- * Base error class for SDK errors
- */
-export declare class CreditsSDKError extends Error {
-    readonly code: SDKErrorCodeType;
-    readonly details?: Record<string, unknown>;
-    readonly statusCode?: number;
-    constructor(message: string, code: SDKErrorCodeType, options?: {
-        details?: Record<string, unknown>;
-        statusCode?: number;
-        cause?: Error;
-    });
-    /**
-     * Check if this is a specific error type
-     */
-    is(code: SDKErrorCodeType): boolean;
-    /**
-     * Create a JSON representation for logging
-     */
-    toJSON(): Record<string, unknown>;
-}
-/**
- * Error thrown when a network request fails
- */
-export declare class NetworkError extends CreditsSDKError {
-    constructor(message: string, cause?: Error);
-}
-/**
- * Error thrown when authentication fails
- */
-export declare class AuthenticationError extends CreditsSDKError {
-    constructor(message?: string);
-}
-/**
- * Error thrown when authorization fails
- */
-export declare class AuthorizationError extends CreditsSDKError {
-    constructor(message?: string);
-}
-/**
- * Error thrown when credits are insufficient
- */
-export declare class InsufficientCreditsError extends CreditsSDKError {
-    readonly available: number;
-    readonly required: number;
-    constructor(available: number, required: number);
-}
-/**
- * Error thrown when a reservation is not found
- */
-export declare class ReservationNotFoundError extends CreditsSDKError {
-    readonly reservationId: string;
-    constructor(reservationId: string);
-}
-/**
- * Error thrown when a reservation has expired
- */
-export declare class ReservationExpiredError extends CreditsSDKError {
-    readonly reservationId: string;
-    constructor(reservationId: string);
-}
-/**
- * Error thrown for validation failures
- */
-export declare class ValidationError extends CreditsSDKError {
-    readonly field?: string;
-    constructor(message: string, field?: string);
-}
-/**
- * Error thrown for server errors
- */
-export declare class ServerError extends CreditsSDKError {
-    constructor(message?: string);
-}
-/**
- * Parse an API error response into the appropriate SDK error
- */
-export declare function parseApiError(statusCode: number, body: {
-    error?: {
-        code?: string;
-        message?: string;
-        details?: unknown;
-    };
-}): CreditsSDKError;
-//# sourceMappingURL=errors.d.ts.map

package/dist/sdk/errors.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/sdk/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEjE;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,SAAgB,IAAI,EAAE,gBAAgB,CAAC;IACvC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClD,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAGlC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,gBAAgB,EACtB,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,KAAK,CAAC;KACf;IASH;;OAEG;IACH,EAAE,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO;IAInC;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CASlC;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,eAAe;gBACnC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAI3C;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,eAAe;gBAC1C,OAAO,GAAE,MAAkC;CAIxD;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,eAAe;gBACzC,OAAO,GAAE,MAAwB;CAI9C;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,eAAe;IAC3D,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,QAAQ,EAAE,MAAM,CAAC;gBAErB,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAahD;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,eAAe;IAC3D,SAAgB,aAAa,EAAE,MAAM,CAAC;gBAE1B,aAAa,EAAE,MAAM;CAYlC;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,eAAe;IAC1D,SAAgB,aAAa,EAAE,MAAM,CAAC;gBAE1B,aAAa,EAAE,MAAM;CAYlC;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,eAAe;IAClD,SAAgB,KAAK,CAAC,EAAE,MAAM,CAAC;gBAEnB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAQ5C;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,eAAe;gBAClC,OAAO,GAAE,MAAgC;CAItD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GACvE,eAAe,CAmDjB"}

package/dist/sdk/errors.js

@@ -1,185 +0,0 @@
-/**
- * SDK error classes
- *
- * Provides typed error handling for SDK operations.
- */
-import { SDKErrorCode } from "./types.js";
-/**
- * Base error class for SDK errors
- */
-export class CreditsSDKError extends Error {
-    code;
-    details;
-    statusCode;
-    constructor(message, code, options) {
-        super(message, { cause: options?.cause });
-        this.name = "CreditsSDKError";
-        this.code = code;
-        this.details = options?.details;
-        this.statusCode = options?.statusCode;
-    }
-    /**
-     * Check if this is a specific error type
-     */
-    is(code) {
-        return this.code === code;
-    }
-    /**
-     * Create a JSON representation for logging
-     */
-    toJSON() {
-        return {
-            name: this.name,
-            message: this.message,
-            code: this.code,
-            details: this.details,
-            statusCode: this.statusCode,
-        };
-    }
-}
-/**
- * Error thrown when a network request fails
- */
-export class NetworkError extends CreditsSDKError {
-    constructor(message, cause) {
-        super(message, SDKErrorCode.NETWORK_ERROR, { cause });
-        this.name = "NetworkError";
-    }
-}
-/**
- * Error thrown when authentication fails
- */
-export class AuthenticationError extends CreditsSDKError {
-    constructor(message = "Authentication required") {
-        super(message, SDKErrorCode.AUTHENTICATION_ERROR, { statusCode: 401 });
-        this.name = "AuthenticationError";
-    }
-}
-/**
- * Error thrown when authorization fails
- */
-export class AuthorizationError extends CreditsSDKError {
-    constructor(message = "Access denied") {
-        super(message, SDKErrorCode.AUTHORIZATION_ERROR, { statusCode: 403 });
-        this.name = "AuthorizationError";
-    }
-}
-/**
- * Error thrown when credits are insufficient
- */
-export class InsufficientCreditsError extends CreditsSDKError {
-    available;
-    required;
-    constructor(available, required) {
-        super(`Insufficient credits: available ${available}, required ${required}`, SDKErrorCode.INSUFFICIENT_CREDITS, {
-            statusCode: 402,
-            details: { available, required },
-        });
-        this.name = "InsufficientCreditsError";
-        this.available = available;
-        this.required = required;
-    }
-}
-/**
- * Error thrown when a reservation is not found
- */
-export class ReservationNotFoundError extends CreditsSDKError {
-    reservationId;
-    constructor(reservationId) {
-        super(`Reservation not found: ${reservationId}`, SDKErrorCode.RESERVATION_NOT_FOUND, {
-            statusCode: 404,
-            details: { reservationId },
-        });
-        this.name = "ReservationNotFoundError";
-        this.reservationId = reservationId;
-    }
-}
-/**
- * Error thrown when a reservation has expired
- */
-export class ReservationExpiredError extends CreditsSDKError {
-    reservationId;
-    constructor(reservationId) {
-        super(`Reservation expired: ${reservationId}`, SDKErrorCode.RESERVATION_EXPIRED, {
-            statusCode: 410,
-            details: { reservationId },
-        });
-        this.name = "ReservationExpiredError";
-        this.reservationId = reservationId;
-    }
-}
-/**
- * Error thrown for validation failures
- */
-export class ValidationError extends CreditsSDKError {
-    field;
-    constructor(message, field) {
-        super(message, SDKErrorCode.VALIDATION_ERROR, {
-            statusCode: 400,
-            details: field ? { field } : undefined,
-        });
-        this.name = "ValidationError";
-        this.field = field;
-    }
-}
-/**
- * Error thrown for server errors
- */
-export class ServerError extends CreditsSDKError {
-    constructor(message = "Internal server error") {
-        super(message, SDKErrorCode.SERVER_ERROR, { statusCode: 500 });
-        this.name = "ServerError";
-    }
-}
-/**
- * Parse an API error response into the appropriate SDK error
- */
-export function parseApiError(statusCode, body) {
-    const errorCode = body.error?.code || "";
-    const errorMessage = body.error?.message || "An error occurred";
-    const details = body.error?.details;
-    switch (statusCode) {
-        case 401:
-            return new AuthenticationError(errorMessage);
-        case 403:
-            return new AuthorizationError(errorMessage);
-        case 402:
-            // Parse insufficient credits details
-            if (details?.available !== undefined && details?.required !== undefined) {
-                return new InsufficientCreditsError(details.available, details.required);
-            }
-            return new CreditsSDKError(errorMessage, SDKErrorCode.INSUFFICIENT_CREDITS, {
-                statusCode,
-                details,
-            });
-        case 404:
-            if (errorCode === "RESERVATION_NOT_FOUND" && details?.reservationId) {
-                return new ReservationNotFoundError(details.reservationId);
-            }
-            return new CreditsSDKError(errorMessage, SDKErrorCode.RESERVATION_NOT_FOUND, {
-                statusCode,
-                details,
-            });
-        case 410:
-            if (errorCode === "RESERVATION_EXPIRED" && details?.reservationId) {
-                return new ReservationExpiredError(details.reservationId);
-            }
-            return new CreditsSDKError(errorMessage, SDKErrorCode.RESERVATION_EXPIRED, {
-                statusCode,
-                details,
-            });
-        case 400:
-        case 422:
-            return new ValidationError(errorMessage, details?.field);
-        case 500:
-        default:
-            if (statusCode >= 500) {
-                return new ServerError(errorMessage);
-            }
-            return new CreditsSDKError(errorMessage, SDKErrorCode.UNKNOWN_ERROR, {
-                statusCode,
-                details,
-            });
-    }
-}
-//# sourceMappingURL=errors.js.map

package/dist/sdk/errors.js.map

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

package/dist/sdk/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGvD,YAAY,EACV,mBAAmB,EACnB,wBAAwB,EACxB,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,WAAW,EACX,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,OAAO,EACL,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,EACvB,eAAe,EACf,WAAW,EACX,aAAa,GACd,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC"}

package/dist/sdk/types.d.ts

@@ -1,110 +0,0 @@
-/**
- * SDK types for the credits system
- *
- * These types are used by the client SDKs for REST API consumption.
- */
-export type { PortableUserCredits as UserCredits, PortableReservation as CreditReservation, CreditCheckResult, SubscriptionTier, } from "../core/types.js";
-/**
- * Configuration for CreditsClient
- */
-export interface CreditsClientConfig {
-    /** Base URL of the credits API (e.g., "https://api.example.com") */
-    baseUrl: string;
-    /** Function to get the auth token for session-based auth */
-    getAuthToken?: () => Promise<string>;
-    /** Optional custom fetch function for testing */
-    fetch?: typeof fetch;
-}
-/**
- * Configuration for AdminCreditsClient
- */
-export interface AdminCreditsClientConfig {
-    /** Base URL of the credits API */
-    baseUrl: string;
-    /** Admin API key */
-    apiKey: string;
-    /** Optional custom fetch function for testing */
-    fetch?: typeof fetch;
-}
-/**
- * Result of a credit reservation
- */
-export interface ReservationResult {
-    /** The reservation ID */
-    reservationId: string;
-    /** Amount of credits reserved */
-    amount: number;
-    /** When the reservation expires (ISO 8601) */
-    expiresAt: string;
-}
-/**
- * Pagination options for API requests
- */
-export interface PaginationOptions {
-    /** Page number (1-indexed) */
-    page?: number;
-    /** Number of items per page */
-    limit?: number;
-}
-/**
- * Usage history entry
- */
-export interface UsageHistoryEntry {
-    /** Unique ID of the usage log */
-    id: string;
-    /** Type of operation */
-    operationType: string;
-    /** AI provider used */
-    provider: string;
-    /** Credits consumed */
-    creditsUsed: number;
-    /** Whether the operation was successful */
-    success: boolean;
-    /** Error message if unsuccessful */
-    errorMessage?: string;
-    /** ID of the related resource */
-    resourceId?: string;
-    /** Type of the related resource */
-    resourceType?: string;
-    /** When the operation occurred (ISO 8601) */
-    createdAt: string;
-}
-/**
- * Response from usage history endpoint
- */
-export interface UsageHistoryResponse {
-    /** List of usage entries */
-    entries: UsageHistoryEntry[];
-    /** Whether there are more results */
-    hasMore: boolean;
-    /** Total count (if available) */
-    total?: number;
-}
-/**
- * Generic API response wrapper
- */
-export interface ApiResponse<T> {
-    success: boolean;
-    data?: T;
-    error?: {
-        code: string;
-        message: string;
-        details?: unknown;
-    };
-}
-/**
- * SDK error codes
- */
-export declare const SDKErrorCode: {
-    readonly NETWORK_ERROR: "NETWORK_ERROR";
-    readonly AUTHENTICATION_ERROR: "AUTHENTICATION_ERROR";
-    readonly AUTHORIZATION_ERROR: "AUTHORIZATION_ERROR";
-    readonly INSUFFICIENT_CREDITS: "INSUFFICIENT_CREDITS";
-    readonly RESERVATION_NOT_FOUND: "RESERVATION_NOT_FOUND";
-    readonly RESERVATION_EXPIRED: "RESERVATION_EXPIRED";
-    readonly VALIDATION_ERROR: "VALIDATION_ERROR";
-    readonly SERVER_ERROR: "SERVER_ERROR";
-    readonly UNKNOWN_ERROR: "UNKNOWN_ERROR";
-};
-export type SDKErrorCodeType = (typeof SDKErrorCode)[keyof typeof SDKErrorCode];
-//# sourceMappingURL=types.d.ts.map

package/dist/sdk/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sdk/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,mBAAmB,IAAI,WAAW,EAClC,mBAAmB,IAAI,iBAAiB,EACxC,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,wBAAwB;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,4BAA4B;IAC5B,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;CAUf,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC"}

package/dist/sdk/types.js

@@ -1,20 +0,0 @@
-/**
- * SDK types for the credits system
- *
- * These types are used by the client SDKs for REST API consumption.
- */
-/**
- * SDK error codes
- */
-export const SDKErrorCode = {
-    NETWORK_ERROR: "NETWORK_ERROR",
-    AUTHENTICATION_ERROR: "AUTHENTICATION_ERROR",
-    AUTHORIZATION_ERROR: "AUTHORIZATION_ERROR",
-    INSUFFICIENT_CREDITS: "INSUFFICIENT_CREDITS",
-    RESERVATION_NOT_FOUND: "RESERVATION_NOT_FOUND",
-    RESERVATION_EXPIRED: "RESERVATION_EXPIRED",
-    VALIDATION_ERROR: "VALIDATION_ERROR",
-    SERVER_ERROR: "SERVER_ERROR",
-    UNKNOWN_ERROR: "UNKNOWN_ERROR",
-};
-//# sourceMappingURL=types.js.map