@chucky.cloud/sdk 0.2.7 → 0.3.1

package/dist/utils/errors.d.ts

@@ -1,80 +0,0 @@
-/**
- * Error Classes
- *
- * Custom error types for the Chucky SDK.
- */
-/**
- * Base error class for Chucky SDK errors
- */
-export declare class ChuckyError extends Error {
-    /** Error code */
-    readonly code: string;
-    /** Additional error details */
-    readonly details?: Record<string, unknown>;
-    constructor(message: string, code: string, details?: Record<string, unknown>);
-}
-/**
- * Connection error
- */
-export declare class ConnectionError extends ChuckyError {
-    constructor(message: string, details?: Record<string, unknown>);
-}
-/**
- * Authentication error
- */
-export declare class AuthenticationError extends ChuckyError {
-    constructor(message: string, details?: Record<string, unknown>);
-}
-/**
- * Budget exceeded error
- */
-export declare class BudgetExceededError extends ChuckyError {
-    constructor(message: string, details?: Record<string, unknown>);
-}
-/**
- * Concurrency limit error
- */
-export declare class ConcurrencyLimitError extends ChuckyError {
-    constructor(message: string, details?: Record<string, unknown>);
-}
-/**
- * Rate limit error
- */
-export declare class RateLimitError extends ChuckyError {
-    constructor(message: string, details?: Record<string, unknown>);
-}
-/**
- * Session error
- */
-export declare class SessionError extends ChuckyError {
-    constructor(message: string, details?: Record<string, unknown>);
-}
-/**
- * Tool execution error
- */
-export declare class ToolExecutionError extends ChuckyError {
-    /** Tool name */
-    readonly toolName: string;
-    constructor(message: string, toolName: string, details?: Record<string, unknown>);
-}
-/**
- * Timeout error
- */
-export declare class TimeoutError extends ChuckyError {
-    constructor(message: string, details?: Record<string, unknown>);
-}
-/**
- * Validation error
- */
-export declare class ValidationError extends ChuckyError {
-    constructor(message: string, details?: Record<string, unknown>);
-}
-/**
- * Parse error code from error message
- */
-export declare function parseErrorCode(message: string): string | null;
-/**
- * Create appropriate error from message and optional code
- */
-export declare function createError(message: string, code?: string): ChuckyError;
-//# sourceMappingURL=errors.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,iBAAiB;IACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAE/B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAW7E;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,WAAW;gBAClC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,WAAW;gBACtC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,WAAW;gBACtC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,WAAW;gBACxC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,WAAW;gBACjC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,WAAW;gBAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,WAAW;IACjD,gBAAgB;IAChB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAKjF;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,WAAW;gBAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,WAAW;gBAClC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAqB7D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,CAuBvE"}

package/dist/utils/errors.js

@@ -1,158 +0,0 @@
-/**
- * Error Classes
- *
- * Custom error types for the Chucky SDK.
- */
-/**
- * Base error class for Chucky SDK errors
- */
-export class ChuckyError extends Error {
-    /** Error code */
-    code;
-    /** Additional error details */
-    details;
-    constructor(message, code, details) {
-        super(message);
-        this.name = 'ChuckyError';
-        this.code = code;
-        this.details = details;
-        // Maintains proper stack trace for where the error was thrown
-        if (Error.captureStackTrace) {
-            Error.captureStackTrace(this, ChuckyError);
-        }
-    }
-}
-/**
- * Connection error
- */
-export class ConnectionError extends ChuckyError {
-    constructor(message, details) {
-        super(message, 'CONNECTION_ERROR', details);
-        this.name = 'ConnectionError';
-    }
-}
-/**
- * Authentication error
- */
-export class AuthenticationError extends ChuckyError {
-    constructor(message, details) {
-        super(message, 'AUTHENTICATION_ERROR', details);
-        this.name = 'AuthenticationError';
-    }
-}
-/**
- * Budget exceeded error
- */
-export class BudgetExceededError extends ChuckyError {
-    constructor(message, details) {
-        super(message, 'BUDGET_EXCEEDED', details);
-        this.name = 'BudgetExceededError';
-    }
-}
-/**
- * Concurrency limit error
- */
-export class ConcurrencyLimitError extends ChuckyError {
-    constructor(message, details) {
-        super(message, 'CONCURRENCY_LIMIT', details);
-        this.name = 'ConcurrencyLimitError';
-    }
-}
-/**
- * Rate limit error
- */
-export class RateLimitError extends ChuckyError {
-    constructor(message, details) {
-        super(message, 'RATE_LIMIT', details);
-        this.name = 'RateLimitError';
-    }
-}
-/**
- * Session error
- */
-export class SessionError extends ChuckyError {
-    constructor(message, details) {
-        super(message, 'SESSION_ERROR', details);
-        this.name = 'SessionError';
-    }
-}
-/**
- * Tool execution error
- */
-export class ToolExecutionError extends ChuckyError {
-    /** Tool name */
-    toolName;
-    constructor(message, toolName, details) {
-        super(message, 'TOOL_EXECUTION_ERROR', { ...details, toolName });
-        this.name = 'ToolExecutionError';
-        this.toolName = toolName;
-    }
-}
-/**
- * Timeout error
- */
-export class TimeoutError extends ChuckyError {
-    constructor(message, details) {
-        super(message, 'TIMEOUT', details);
-        this.name = 'TimeoutError';
-    }
-}
-/**
- * Validation error
- */
-export class ValidationError extends ChuckyError {
-    constructor(message, details) {
-        super(message, 'VALIDATION_ERROR', details);
-        this.name = 'ValidationError';
-    }
-}
-/**
- * Parse error code from error message
- */
-export function parseErrorCode(message) {
-    // Common error patterns
-    const patterns = [
-        { pattern: /budget.*exceed/i, code: 'BUDGET_EXCEEDED' },
-        { pattern: /concurrency.*limit/i, code: 'CONCURRENCY_LIMIT' },
-        { pattern: /rate.*limit/i, code: 'RATE_LIMIT' },
-        { pattern: /auth|unauthorized|forbidden/i, code: 'AUTHENTICATION_ERROR' },
-        { pattern: /timeout/i, code: 'TIMEOUT' },
-        { pattern: /connect|disconnect|websocket/i, code: 'CONNECTION_ERROR' },
-        { pattern: /session/i, code: 'SESSION_ERROR' },
-        { pattern: /tool/i, code: 'TOOL_EXECUTION_ERROR' },
-        { pattern: /invalid|validation/i, code: 'VALIDATION_ERROR' },
-    ];
-    for (const { pattern, code } of patterns) {
-        if (pattern.test(message)) {
-            return code;
-        }
-    }
-    return null;
-}
-/**
- * Create appropriate error from message and optional code
- */
-export function createError(message, code) {
-    const errorCode = code || parseErrorCode(message) || 'UNKNOWN_ERROR';
-    switch (errorCode) {
-        case 'CONNECTION_ERROR':
-            return new ConnectionError(message);
-        case 'AUTHENTICATION_ERROR':
-            return new AuthenticationError(message);
-        case 'BUDGET_EXCEEDED':
-            return new BudgetExceededError(message);
-        case 'CONCURRENCY_LIMIT':
-            return new ConcurrencyLimitError(message);
-        case 'RATE_LIMIT':
-            return new RateLimitError(message);
-        case 'SESSION_ERROR':
-            return new SessionError(message);
-        case 'TIMEOUT':
-            return new TimeoutError(message);
-        case 'VALIDATION_ERROR':
-            return new ValidationError(message);
-        default:
-            return new ChuckyError(message, errorCode);
-    }
-}
-//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

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

package/dist/utils/index.d.ts

@@ -1,8 +0,0 @@
-/**
- * Utils Index
- *
- * Re-exports all utility functions.
- */
-export { createToken, decodeToken, verifyToken, isTokenExpired, extractProjectId, createBudget, } from './token.js';
-export { ChuckyError, ConnectionError, AuthenticationError, BudgetExceededError, ConcurrencyLimitError, RateLimitError, SessionError, ToolExecutionError, TimeoutError, ValidationError, parseErrorCode, createError, } from './errors.js';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,WAAW,EACX,WAAW,EACX,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,cAAc,EACd,WAAW,GACZ,MAAM,aAAa,CAAC"}

package/dist/utils/index.js

@@ -1,8 +0,0 @@
-/**
- * Utils Index
- *
- * Re-exports all utility functions.
- */
-export { createToken, decodeToken, verifyToken, isTokenExpired, extractProjectId, createBudget, } from './token.js';
-export { ChuckyError, ConnectionError, AuthenticationError, BudgetExceededError, ConcurrencyLimitError, RateLimitError, SessionError, ToolExecutionError, TimeoutError, ValidationError, parseErrorCode, createError, } from './errors.js';
-//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,WAAW,EACX,WAAW,EACX,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,cAAc,EACd,WAAW,GACZ,MAAM,aAAa,CAAC"}

package/dist/utils/token.d.ts

@@ -1,104 +0,0 @@
-/**
- * Token Utilities
- *
- * Helpers for creating and decoding JWT tokens for authentication.
- * These are primarily for server-side use (Node.js).
- */
-import type { CreateTokenOptions, DecodedToken, TokenBudget } from '../types/token.js';
-/**
- * Create a budget token (JWT) for authenticating with Chucky
- *
- * @param options - Token creation options
- * @returns Signed JWT token
- *
- * @example
- * ```typescript
- * // Server-side token creation
- * const token = await createToken({
- *   userId: 'user-123',
- *   projectId: '550e8400-e29b-41d4-a716-446655440000',
- *   secret: 'your-hmac-secret',
- *   budget: {
- *     ai: 1_000_000, // $1 in microdollars
- *     compute: 3600,  // 1 hour
- *     window: 'day',
- *     windowStart: new Date().toISOString(),
- *   },
- * });
- * ```
- */
-export declare function createToken(options: CreateTokenOptions): Promise<string>;
-/**
- * Decode a token without verification
- *
- * @param token - JWT token to decode
- * @returns Decoded token parts
- *
- * @example
- * ```typescript
- * const decoded = decodeToken(token);
- * console.log(decoded.payload.sub); // User ID
- * console.log(decoded.payload.budget); // Budget limits
- * ```
- */
-export declare function decodeToken(token: string): DecodedToken;
-/**
- * Verify a token signature
- *
- * @param token - JWT token to verify
- * @param secret - HMAC secret for verification
- * @returns True if signature is valid
- *
- * @example
- * ```typescript
- * const isValid = await verifyToken(token, 'your-hmac-secret');
- * if (!isValid) {
- *   throw new Error('Invalid token');
- * }
- * ```
- */
-export declare function verifyToken(token: string, secret: string): Promise<boolean>;
-/**
- * Check if a token is expired
- *
- * @param token - JWT token to check
- * @returns True if token is expired
- */
-export declare function isTokenExpired(token: string): boolean;
-/**
- * @deprecated The project ID is now separate from the HMAC key for security reasons.
- * Get your project ID from the Chucky portal (app.chucky.cloud) instead.
- *
- * Previously, the HMAC key embedded the project ID, but this exposed the secret
- * in JWT tokens. Project IDs are now Convex document IDs visible in the portal.
- *
- * @param _hmacKey - Ignored (previously used to extract project ID)
- * @throws Always throws an error directing users to get project ID from portal
- */
-export declare function extractProjectId(_hmacKey: string): never;
-/**
- * Create a simple budget configuration
- *
- * @param options - Budget options
- * @returns Budget configuration
- *
- * @example
- * ```typescript
- * const budget = createBudget({
- *   aiDollars: 1.00,    // $1 AI budget
- *   computeHours: 1,    // 1 hour compute
- *   window: 'day',
- * });
- * ```
- */
-export declare function createBudget(options: {
-    /** AI budget in dollars */
-    aiDollars: number;
-    /** Compute budget in hours */
-    computeHours: number;
-    /** Budget window */
-    window: 'hour' | 'day' | 'week' | 'month';
-    /** Window start (default: now) */
-    windowStart?: Date;
-}): TokenBudget;
-//# sourceMappingURL=token.d.ts.map

package/dist/utils/token.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../src/utils/token.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAEV,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACZ,MAAM,mBAAmB,CAAC;AAkF3B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsC9E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAYvD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUjF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAQrD;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAKxD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE;IACpC,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB;IACpB,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;IAC1C,kCAAkC;IAClC,WAAW,CAAC,EAAE,IAAI,CAAC;CACpB,GAAG,WAAW,CAOd"}

package/dist/utils/token.js

@@ -1,209 +0,0 @@
-/**
- * Token Utilities
- *
- * Helpers for creating and decoding JWT tokens for authentication.
- * These are primarily for server-side use (Node.js).
- */
-/**
- * Base64URL encode a string
- */
-function base64UrlEncode(data) {
-    let base64;
-    if (typeof data === 'string') {
-        // Use TextEncoder for string
-        const bytes = new TextEncoder().encode(data);
-        base64 = btoa(String.fromCharCode(...bytes));
-    }
-    else {
-        base64 = btoa(String.fromCharCode(...data));
-    }
-    return base64
-        .replace(/\+/g, '-')
-        .replace(/\//g, '_')
-        .replace(/=+$/, '');
-}
-/**
- * Base64URL decode a string
- */
-function base64UrlDecode(str) {
-    const base64 = str.replace(/-/g, '+').replace(/_/g, '/');
-    const padding = '='.repeat((4 - (base64.length % 4)) % 4);
-    const bytes = atob(base64 + padding);
-    return bytes;
-}
-/**
- * Get crypto implementation (browser or Node.js)
- */
-async function getCrypto() {
-    if (typeof crypto !== 'undefined' && crypto.subtle) {
-        return crypto;
-    }
-    // Node.js: use webcrypto
-    const nodeCrypto = await import('crypto');
-    return nodeCrypto.webcrypto;
-}
-/**
- * Create HMAC-SHA256 signature
- */
-async function createHmacSignature(secret, data) {
-    const { subtle } = await getCrypto();
-    const keyData = new TextEncoder().encode(secret);
-    const key = await subtle.importKey('raw', keyData, { name: 'HMAC', hash: 'SHA-256' }, false, ['sign']);
-    const signature = await subtle.sign('HMAC', key, new TextEncoder().encode(data));
-    return base64UrlEncode(new Uint8Array(signature));
-}
-/**
- * Verify HMAC-SHA256 signature
- */
-async function verifyHmacSignature(secret, data, signature) {
-    const expectedSignature = await createHmacSignature(secret, data);
-    return signature === expectedSignature;
-}
-/**
- * Create a budget token (JWT) for authenticating with Chucky
- *
- * @param options - Token creation options
- * @returns Signed JWT token
- *
- * @example
- * ```typescript
- * // Server-side token creation
- * const token = await createToken({
- *   userId: 'user-123',
- *   projectId: '550e8400-e29b-41d4-a716-446655440000',
- *   secret: 'your-hmac-secret',
- *   budget: {
- *     ai: 1_000_000, // $1 in microdollars
- *     compute: 3600,  // 1 hour
- *     window: 'day',
- *     windowStart: new Date().toISOString(),
- *   },
- * });
- * ```
- */
-export async function createToken(options) {
-    const { userId, projectId, secret, expiresIn = 3600, budget, permissions, sdkConfig, } = options;
-    const now = Math.floor(Date.now() / 1000);
-    const payload = {
-        sub: userId,
-        iss: projectId,
-        iat: now,
-        exp: now + expiresIn,
-        budget,
-        ...(permissions && { permissions }),
-        ...(sdkConfig && { sdkConfig }),
-    };
-    // Create header
-    const header = {
-        alg: 'HS256',
-        typ: 'JWT',
-    };
-    // Encode header and payload
-    const encodedHeader = base64UrlEncode(JSON.stringify(header));
-    const encodedPayload = base64UrlEncode(JSON.stringify(payload));
-    // Create signature
-    const signatureInput = `${encodedHeader}.${encodedPayload}`;
-    const signature = await createHmacSignature(secret, signatureInput);
-    return `${encodedHeader}.${encodedPayload}.${signature}`;
-}
-/**
- * Decode a token without verification
- *
- * @param token - JWT token to decode
- * @returns Decoded token parts
- *
- * @example
- * ```typescript
- * const decoded = decodeToken(token);
- * console.log(decoded.payload.sub); // User ID
- * console.log(decoded.payload.budget); // Budget limits
- * ```
- */
-export function decodeToken(token) {
-    const parts = token.split('.');
-    if (parts.length !== 3) {
-        throw new Error('Invalid token format');
-    }
-    const [encodedHeader, encodedPayload, signature] = parts;
-    const header = JSON.parse(base64UrlDecode(encodedHeader));
-    const payload = JSON.parse(base64UrlDecode(encodedPayload));
-    return { header, payload, signature };
-}
-/**
- * Verify a token signature
- *
- * @param token - JWT token to verify
- * @param secret - HMAC secret for verification
- * @returns True if signature is valid
- *
- * @example
- * ```typescript
- * const isValid = await verifyToken(token, 'your-hmac-secret');
- * if (!isValid) {
- *   throw new Error('Invalid token');
- * }
- * ```
- */
-export async function verifyToken(token, secret) {
-    const parts = token.split('.');
-    if (parts.length !== 3) {
-        return false;
-    }
-    const [encodedHeader, encodedPayload, signature] = parts;
-    const signatureInput = `${encodedHeader}.${encodedPayload}`;
-    return verifyHmacSignature(secret, signatureInput, signature);
-}
-/**
- * Check if a token is expired
- *
- * @param token - JWT token to check
- * @returns True if token is expired
- */
-export function isTokenExpired(token) {
-    try {
-        const decoded = decodeToken(token);
-        const now = Math.floor(Date.now() / 1000);
-        return decoded.payload.exp < now;
-    }
-    catch {
-        return true;
-    }
-}
-/**
- * @deprecated The project ID is now separate from the HMAC key for security reasons.
- * Get your project ID from the Chucky portal (app.chucky.cloud) instead.
- *
- * Previously, the HMAC key embedded the project ID, but this exposed the secret
- * in JWT tokens. Project IDs are now Convex document IDs visible in the portal.
- *
- * @param _hmacKey - Ignored (previously used to extract project ID)
- * @throws Always throws an error directing users to get project ID from portal
- */
-export function extractProjectId(_hmacKey) {
-    throw new Error('extractProjectId() is deprecated. The project ID is now separate from the HMAC key for security. ' +
-        'Get your project ID from the Chucky portal (app.chucky.cloud) in your project settings.');
-}
-/**
- * Create a simple budget configuration
- *
- * @param options - Budget options
- * @returns Budget configuration
- *
- * @example
- * ```typescript
- * const budget = createBudget({
- *   aiDollars: 1.00,    // $1 AI budget
- *   computeHours: 1,    // 1 hour compute
- *   window: 'day',
- * });
- * ```
- */
-export function createBudget(options) {
-    return {
-        ai: Math.floor(options.aiDollars * 1_000_000), // Convert to microdollars
-        compute: Math.floor(options.computeHours * 3600), // Convert to seconds
-        window: options.window,
-        windowStart: (options.windowStart || new Date()).toISOString(),
-    };
-}
-//# sourceMappingURL=token.js.map

package/dist/utils/token.js.map

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