@chucky.cloud/sdk 0.1.0

package/dist/utils/token.d.ts

@@ -0,0 +1,93 @@
+/**
+ * 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;
+/**
+ * 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

@@ -0,0 +1 @@
+{"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;;;;;;;;;;;;;;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

@@ -0,0 +1,195 @@
+/**
+ * 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;
+    }
+}
+/**
+ * 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

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

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@chucky.cloud/sdk",
+  "version": "0.1.0",
+  "description": "SDK for interacting with Chucky sandbox - supports both browser and Node.js",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./browser": {
+      "import": "./dist/browser.js",
+      "types": "./dist/browser.d.ts"
+    },
+    "./node": {
+      "import": "./dist/node.js",
+      "types": "./dist/node.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "chucky",
+    "claude",
+    "anthropic",
+    "ai",
+    "sdk",
+    "agent"
+  ],
+  "author": "Chucky Cloud",
+  "license": "MIT",
+  "dependencies": {
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.10",
+    "@types/ws": "^8.5.13",
+    "typescript": "^5.7.3"
+  },
+  "peerDependencies": {
+    "zod": "^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "zod": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}