hydra-aidirector 1.6.0 → 1.6.1

package/README.md

@@ -1,399 +1,304 @@
-# hydra-aidirector
-
-The official Node.js/TypeScript SDK for [Hydra](https://hydrai.dev) — a high-performance AI API gateway.
-
-[![npm version](https://badge.fury.io/js/hydra-aidirector.svg)](https://www.npmjs.com/package/hydra-aidirector)
-[![TypeScript](https://badges.frapsoft.com/typescript/code/typescript.svg?v=101)](https://www.typescriptlang.org/)
-
-## Why Hydra?
-
-| Problem | Hydra Solution |
-|---------|----------------|
-| LLM outages break your app | 🔄 **Automatic Failover** – Seamless fallback between providers |
-| High latency & costs | ⚡ **God-Tier Caching** – Hybrid Redis + DB cache with AI-directed scoping |
-| Malformed JSON responses | 🛡️ **Self-Healing AI** – Auto-repair JSON, strip markdown, extract from prose |
-| Schema compliance issues | ✅ **Strict JSON Mode** – Force models to conform to your schema or fail |
-| No visibility into usage | 📊 **Detailed Analytics** – Track tokens, latency, and costs per model |
-
----
-
-## Installation
-
-```bash
-npm install hydra-aidirector
-# or
-pnpm add hydra-aidirector
-# or
-yarn add hydra-aidirector
-```
-
----
-
-## Quick Start
-
-```typescript
-import { Hydra } from 'hydra-aidirector';
-
-const client = new Hydra({
-  secretKey: process.env.HYDRA_SECRET_KEY!, // hyd_sk_...
-  baseUrl: 'https://your-instance.vercel.app',
-});
-
-// Basic generation
-const result = await client.generate({
-  chainId: 'my-chain',
-  prompt: 'Generate 5 user profiles as JSON',
-});
-
-if (result.success) {
-  console.log(result.data.valid); // Parsed, schema-validated objects
-}
-```
-
----
-
-## Core Features
-
-### 🔄 Automatic Failover
-Define fallback chains in your dashboard. If Gemini fails, Hydra automatically tries OpenRouter, Claude, etc.
-
-### 🛡️ Self-Healing JSON
-LLMs sometimes return broken JSON. Hydra extracts and repairs it automatically:
-
-```typescript
-const result = await client.generate({ chainId: 'x', prompt: 'Get user' });
-
-if (result.meta.recovered) {
-  console.log('JSON was malformed but healed!');
-  console.log(result.data.healingReport);
-  // [{ original: "{name: 'foo'", healed: { name: "foo" }, fixes: ["Added closing brace"] }]
-}
-```
-
-### ✅ Strict JSON Mode vs Self-Healing
-
-Hydra's self-healing JSON repair **works in both modes**. The difference is how the model behaves:
-
-| Mode | Model Behavior | Healing Role |
-|------|----------------|--------------|
-| **Strict** (`strictJson: true`) | Model is **forced** to output pure JSON via native API constraints. Output is already clean. | Safety net — rarely needed since output is constrained. |
-| **Non-Strict** (`strictJson: false`) | Model outputs best-effort JSON (may include markdown, prose, or broken syntax). | Primary mechanism — extracts and repairs JSON from messy output. |
-
-```typescript
-// Strict mode - model constrained to pure JSON
-await client.generate({
-  chainId: 'gemini-chain',
-  prompt: 'Extract invoice data',
-  schema: invoiceSchema,
-  strictJson: true, // No markdown, no explanations
-});
-
-// Non-strict mode - flexible output, Hydra heals as needed
-await client.generate({
-  chainId: 'any-chain',
-  prompt: 'Generate a creative story with metadata',
-  schema: storySchema,
-  strictJson: false, // Allow model to be creative, Hydra extracts JSON
-});
-```
-
----
-
-## Streaming (Recommended for Large Responses)
-
-Process JSON objects as they arrive — perfect for UIs that need instant feedback:
-
-```typescript
-await client.generateStream(
-  {
-    chainId: 'my-chain',
-    prompt: 'Generate 100 product descriptions',
-  },
-  {
-    onObject: (obj, index) => {
-      console.log(`Object ${index}:`, obj);
-      renderToUI(obj); // Render immediately!
-    },
-    onComplete: (result) => {
-      console.log(`Done! ${result.objectCount} objects`);
-    },
-    onError: (error) => {
-      console.error('Stream failed:', error);
-    },
-  }
-);
-```
-
----
-
-## Batch Generation
-
-Process multiple prompts in parallel with automatic error handling:
-
-```typescript
-const result = await client.generateBatch('my-chain', [
-  { id: 'item1', prompt: 'Describe product A' },
-  { id: 'item2', prompt: 'Describe product B' },
-  { id: 'item3', prompt: 'Describe product C' },
-]);
-
-console.log(`Processed ${result.summary.succeeded}/${result.summary.total}`);
-```
-
----
-
-## Caching
-
-### Cache Scope
-Control how responses are cached:
-
-```typescript
-// Global cache (shared across users - default)
-await client.generate({ chainId: 'x', prompt: 'Facts', cacheScope: 'global' });
-
-// User-scoped cache (private to authenticated user)
-await client.generate({ chainId: 'x', prompt: 'My profile', cacheScope: 'user' });
-
-// Skip cache entirely
-await client.generate({ chainId: 'x', prompt: 'Random', cacheScope: 'skip' });
-```
-
-### Cache Quality
-Control the trade-off between cache hit rate and precision:
-
-| Level | Behavior |
-|-------|----------|
-| `STANDARD` | Balanced fuzzy matching. Good for most cases. |
-| `HIGH` | Stricter matching. Higher quality hits, lower hit rate. |
-| `MAX_EFFICIENCY` | Aggressive matching. Maximum cost savings, less precision. |
-
-```typescript
-await client.generate({
-  chainId: 'my-chain',
-  prompt: 'Generate report',
-  cacheQuality: 'MAX_EFFICIENCY', // Maximize cache hits
-});
-```
-
-### AI-Directed Caching
-The AI can override cache scope by including a `_cache` directive in its output:
-
-```json
-{
-  "data": { "...": "..." },
-  "_cache": { "scope": "user" }
-}
-```
-
-The directive is automatically stripped from your final response.
-
----
-
-## File Attachments
-
-Upload documents for analysis. Hydra handles type detection and model compatibility:
-
-```typescript
-import fs from 'fs';
-
-const fileBuffer = fs.readFileSync('report.pdf');
-
-const result = await client.generate({
-  chainId: 'document-analysis',
-  prompt: 'Summarize this document',
-  files: [{
-    data: fileBuffer.toString('base64'),
-    filename: 'report.pdf',
-    mimeType: 'application/pdf',
-  }],
-});
-```
-
----
-
-## Request Cancellation
-
-Cancel long-running requests with `AbortSignal`:
-
-```typescript
-const controller = new AbortController();
-setTimeout(() => controller.abort(), 5000); // Cancel after 5s
-
-try {
-  const result = await client.generate({
-    chainId: 'my-chain',
-    prompt: 'Long task',
-    signal: controller.signal,
-  });
-} catch (error) {
-  if (error instanceof TimeoutError) {
-    console.log('Request was cancelled');
-  }
-}
-```
-
----
-
-## Thinking Mode
-
-Enable reasoning models to show their thought process:
-
-```typescript
-const result = await client.generate({
-  chainId: 'reasoning-chain',
-  prompt: 'Solve this complex problem step by step',
-  options: {
-    thinkingMode: true,
-  },
-});
-```
-
----
-
-## Webhooks
-
-Register callbacks for async notifications:
-
-```typescript
-// Register
-await client.registerWebhook({
-  requestId: 'req_123',
-  url: 'https://your-domain.com/webhooks/hydra',
-  secret: 'your-webhook-secret',
-  retryCount: 3,
-});
-
-// Manage
-const webhooks = await client.listWebhooks();
-await client.updateWebhook('webhook_id', { retryCount: 5 });
-await client.unregisterWebhook('webhook_id');
-```
-
----
-
-## Configuration Reference
-
-### Client Options
-
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `secretKey` | `string` | **required** | Your API key (`hyd_sk_...`) |
-| `baseUrl` | `string` | `http://localhost:3000` | API base URL |
-| `timeout` | `number` | `600000` | Request timeout in ms (10 min) |
-| `maxRetries` | `number` | `3` | Max retry attempts |
-| `debug` | `boolean` | `false` | Enable debug logging |
-
-### Generate Options
-
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `chainId` | `string` | **required** | Fallback chain ID |
-| `prompt` | `string` | **required** | The prompt to send |
-| `schema` | `object` | - | JSON schema for validation |
-| `cacheScope` | `'global' \| 'user' \| 'skip'` | `'global'` | Cache sharing behavior |
-| `cacheQuality` | `'STANDARD' \| 'HIGH' \| 'MAX_EFFICIENCY'` | `'STANDARD'` | Cache match precision |
-| `strictJson` | `boolean` | `true` | Force strict JSON mode |
-| `signal` | `AbortSignal` | - | Cancellation signal |
-| `maxRetries` | `number` | Client default | Override retries |
-| `requestId` | `string` | Auto-generated | Custom request ID |
-| `files` | `FileAttachment[]` | - | File attachments |
-| `useOptimized` | `boolean` | `true` | Use 3-step cost-saving flow |
-| `noCache` | `boolean` | `false` | Skip cache entirely |
-
----
-
-## API Methods
-
-| Method | Description |
-|--------|-------------|
-| `generate(options)` | Generate content with fallback chain |
-| `generateStream(options, callbacks)` | Stream JSON objects in real-time |
-| `generateBatch(chainId, items)` | Process multiple prompts |
-| `listModels()` | List available AI models |
-| `listChains()` | List your fallback chains |
-| `getUsage(options)` | Get usage statistics |
-| `health()` | Check API health |
-| `healthDetailed()` | Get detailed component health |
-| `registerWebhook(config)` | Register async webhook |
-| `unregisterWebhook(id)` | Remove a webhook |
-| `listWebhooks()` | List all webhooks |
-| `updateWebhook(id, updates)` | Modify webhook config |
-
----
-
-## Error Handling
-
-```typescript
-import {
-  RateLimitError,
-  TimeoutError,
-  AuthenticationError,
-  QuotaExceededError,
-  WorkerError,
-  FileProcessingError,
-  isRetryableError,
-} from 'hydra-aidirector';
-
-try {
-  const result = await client.generate({ chainId: 'x', prompt: 'y' });
-} catch (error) {
-  if (error instanceof RateLimitError) {
-    console.log(`Retry after ${error.retryAfterMs}ms`);
-  } else if (error instanceof QuotaExceededError) {
-    console.log(`Quota exceeded: ${error.used}/${error.limit} (${error.tier})`);
-  } else if (error instanceof TimeoutError) {
-    console.log(`Timed out after ${error.timeoutMs}ms`);
-  } else if (error instanceof AuthenticationError) {
-    console.log('Invalid API key');
-  } else if (error instanceof WorkerError) {
-    console.log('Worker failed - will retry');
-  } else if (error instanceof FileProcessingError) {
-    console.log(`File error: ${error.reason} - ${error.filename}`);
-  } else if (isRetryableError(error)) {
-    console.log('Transient error - safe to retry');
-  }
-}
-```
-
----
-
-## Pricing
-
-**BYOK (Bring Your Own Key)** — You pay AI providers directly. Hydra charges only for API access:
-
-| Tier | Price/mo | Requests | Overage |
-|------|----------|----------|---------|
-| Free | $0 | 1,000 | Blocked |
-| Starter | $9 | 25,000 | $0.50/1K |
-| Pro | $29 | 100,000 | $0.40/1K |
-| Scale | $79 | 500,000 | $0.30/1K |
-
----
-
-## TypeScript Support
-
-Full type safety with comprehensive types:
-
-```typescript
-import type {
-  GenerateOptions,
-  GenerateResult,
-  StreamCallbacks,
-  FileAttachment,
-  ChainInfo,
-  ModelInfo,
-} from 'hydra-aidirector';
-```
-
----
-
-## Requirements
-
-- Node.js 18+
-- TypeScript 5+ (optional but recommended)
-
----
-
-## License
-
-MIT © [Hydra](https://hydrai.dev)
+# hydra-aidirector
+
+The official TypeScript SDK for [Hydra](https://hydrai.dev).
+
+Hydra gives your app one stable AI gateway instead of a pile of provider glue. You send one request. Hydra handles routing, failover, cache behavior, JSON recovery, and operational visibility behind the same API.
+
+## Install
+
+```bash
+bun add hydra-aidirector
+# or
+npm install hydra-aidirector
+# or
+pnpm add hydra-aidirector
+# or
+yarn add hydra-aidirector
+```
+
+## Quick Start
+
+```ts
+import { Hydra } from 'hydra-aidirector';
+
+const client = new Hydra({
+  secretKey: process.env.HYDRA_SECRET_KEY!, // hyd_sk_...
+  baseUrl: 'https://your-hydra-instance.com',
+});
+
+const result = await client.generate({
+  chainId: 'support-replies',
+  prompt: 'Write 3 concise onboarding emails as JSON',
+});
+
+if (result.success) {
+  console.log(result.data.valid);
+}
+```
+
+## What You Get
+
+- Automatic failover across the models in your chain.
+- JSON extraction and repair when providers return noisy output.
+- User-safe caching with request-level cache controls.
+- Streaming for long responses.
+- Batch generation for parallel prompt execution.
+- Usage, health, and webhook management from the same client.
+
+## Generation Modes
+
+Hydra uses the optimized 3-step flow by default for simple requests. That keeps the fast path cheap and responsive.
+
+When you ask for features that require the full server pipeline, the SDK automatically falls back to the legacy endpoint. That includes:
+
+- `schema`
+- `noCache`
+- `cacheScope`
+- `cacheQuality`
+- `strictJson`
+- `maxRetries`
+
+You can also force the legacy endpoint yourself:
+
+```ts
+await client.generate({
+  chainId: 'support-replies',
+  prompt: 'Return a fresh answer',
+  useOptimized: false,
+});
+```
+
+## Structured Output
+
+Use `schema` when you want validated JSON back:
+
+```ts
+const result = await client.generate({
+  chainId: 'invoice-parser',
+  prompt: 'Extract invoice fields',
+  schema: {
+    invoiceNumber: 'string',
+    amount: 'number',
+    currency: 'string',
+  },
+  strictJson: true,
+});
+```
+
+If the provider returns malformed JSON, Hydra will still try to recover it before the request fails.
+
+## Cache Control
+
+Use request-level cache controls when the prompt should behave differently from the default path:
+
+```ts
+await client.generate({
+  chainId: 'account-summary',
+  prompt: 'Summarize this customer account',
+  cacheScope: 'user',
+});
+
+await client.generate({
+  chainId: 'pricing-faq',
+  prompt: 'Return the current pricing summary',
+  cacheScope: 'global',
+});
+
+await client.generate({
+  chainId: 'one-off',
+  prompt: 'Generate a fresh variant',
+  noCache: true,
+});
+```
+
+You can also tune cache matching:
+
+```ts
+await client.generate({
+  chainId: 'reporting',
+  prompt: 'Generate the weekly report',
+  cacheQuality: 'HIGH',
+});
+```
+
+## Streaming
+
+Stream parsed objects as they arrive:
+
+```ts
+await client.generateStream(
+  {
+    chainId: 'catalog-generator',
+    prompt: 'Generate 50 product blurbs as JSON',
+  },
+  {
+    onObject: (object, index) => {
+      console.log(index, object);
+    },
+    onComplete: (result) => {
+      console.log(result.objectCount);
+    },
+    onError: (error) => {
+      console.error(error);
+    },
+  }
+);
+```
+
+## Batch Generation
+
+Run multiple prompts in one call:
+
+```ts
+const batch = await client.generateBatch('catalog-generator', [
+  { id: 'a', prompt: 'Describe product A' },
+  { id: 'b', prompt: 'Describe product B' },
+  { id: 'c', prompt: 'Describe product C' },
+]);
+
+console.log(batch.summary);
+```
+
+## Files
+
+Send file attachments as base64:
+
+```ts
+import fs from 'node:fs';
+
+const file = fs.readFileSync('report.pdf');
+
+const result = await client.generate({
+  chainId: 'document-analysis',
+  prompt: 'Summarize this report',
+  files: [
+    {
+      data: file.toString('base64'),
+      filename: 'report.pdf',
+      mimeType: 'application/pdf',
+    },
+  ],
+});
+```
+
+## Usage and Health
+
+Get normalized usage metrics:
+
+```ts
+const usage = await client.getUsage({
+  startDate: new Date('2026-03-01T00:00:00.000Z'),
+  endDate: new Date('2026-04-01T00:00:00.000Z'),
+});
+
+console.log(usage.totalRequests);
+console.log(usage.cachedRequests);
+console.log(usage.byModelList);
+```
+
+Basic health:
+
+```ts
+const health = await client.health();
+console.log(health.ok, health.latencyMs);
+```
+
+Detailed health requires an admin key:
+
+```ts
+const detailed = await client.healthDetailed();
+console.log(detailed.status);
+```
+
+## Webhooks
+
+Register, list, update, and remove webhooks from the SDK:
+
+```ts
+await client.registerWebhook({
+  requestId: 'req_123',
+  url: 'https://example.com/webhooks/hydra',
+  secret: 'super-secret-webhook-key',
+  retryCount: 3,
+});
+
+const webhooks = await client.listWebhooks();
+
+await client.updateWebhook(webhooks[0].id, {
+  retryCount: 5,
+});
+
+await client.unregisterWebhook(webhooks[0].id);
+```
+
+## Cancellation
+
+Cancel long-running requests with `AbortController`:
+
+```ts
+const controller = new AbortController();
+
+setTimeout(() => controller.abort(), 5000);
+
+await client.generate({
+  chainId: 'long-job',
+  prompt: 'Generate a long report',
+  signal: controller.signal,
+});
+```
+
+## Error Handling
+
+```ts
+import {
+  AuthenticationError,
+  QuotaExceededError,
+  RateLimitError,
+  TimeoutError,
+  isRetryableError,
+} from 'hydra-aidirector';
+
+try {
+  await client.generate({
+    chainId: 'support-replies',
+    prompt: 'Write a response',
+  });
+} catch (error) {
+  if (error instanceof AuthenticationError) {
+    console.error('The Hydra secret key is invalid.');
+  } else if (error instanceof QuotaExceededError) {
+    console.error(error.tier, error.used, error.limit);
+  } else if (error instanceof RateLimitError) {
+    console.error(error.retryAfterMs);
+  } else if (error instanceof TimeoutError) {
+    console.error(error.timeoutMs);
+  } else if (isRetryableError(error)) {
+    console.error('Safe to retry.');
+  }
+}
+```
+
+## API Surface
+
+- `generate(options)`
+- `generateStream(options, callbacks)`
+- `generateBatch(chainId, items, options?)`
+- `listModels()`
+- `listChains()`
+- `getUsage(options?)`
+- `health()`
+- `healthDetailed()`
+- `registerWebhook(config)`
+- `listWebhooks()`
+- `updateWebhook(id, updates)`
+- `unregisterWebhook(id)`
+- `withConfig(overrides)`
+
+## Requirements
+
+- Node.js 18+
+- TypeScript 5+ for typed projects
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -69,7 +69,7 @@ interface GenerateOptions {
      * The server automatically handles:
      * - File type detection (magic bytes)
      * - Model compatibility checking
-     * - Automatic conversion (e.g., DOCX → PDF)
+     * - Automatic conversion (for example, DOCX to PDF)
      *
      * @example
      * ```typescript
@@ -94,10 +94,9 @@ interface GenerateOptions {
     useOptimized?: boolean;
     /**
      * Cache scope for this request.
-     * - 'global': Cache is shared across all users (default)
      * - 'user': Cache is scoped to the authenticated user
+     * - 'global': Cache is shared across users
      * - 'skip': Do not cache this response
-     * @default 'global'
      */
     cacheScope?: 'global' | 'user' | 'skip';
     /**
@@ -113,7 +112,7 @@ interface GenerateOptions {
     signal?: AbortSignal;
     /**
      * Override max retries for this specific request.
-     * Set to 0 to disable retries for idempotent-sensitive operations.
+     * Set to 0 to disable retries for this call.
      */
     maxRetries?: number;
     /**
@@ -125,12 +124,13 @@ interface GenerateOptions {
     cacheQuality?: 'STANDARD' | 'HIGH' | 'MAX_EFFICIENCY';
     /**
      * Force strict JSON usage for providers that support it.
-     * If true, ensures the model outputs valid JSON conforming to the schema.
+     * When enabled with a schema, the SDK uses the legacy endpoint so
+     * validation and repair behave consistently.
      */
     strictJson?: boolean;
     /**
-     * Client-generated request ID for tracing and debugging.
-     * If not provided, one will be generated automatically.
+     * Optional client-side correlation id.
+     * Reserved for compatibility with custom tracing layers.
      */
     requestId?: string;
     /**
@@ -184,9 +184,8 @@ interface GenerationParameters {
      */
     systemPrompt?: string;
     /**
-     * Enable thinking/reasoning mode for supported models.
-     * When enabled, the model will show its reasoning process.
-     * Only works with models that support thinking (e.g., Gemini 2.0 Flash Thinking).
+     * Reserved for reasoning-mode support on deployments that expose it.
+     * Deployments that do not support this flag may ignore it.
      */
     thinkingMode?: boolean;
 }
@@ -504,22 +503,68 @@ interface UsageStats {
     /**
      * Cached responses served
      */
+    cachedRequests: number;
+    /**
+     * Legacy alias for cachedRequests
+     */
     cachedResponses: number;
+    /**
+     * Total input tokens in the selected range
+     */
+    totalTokensIn: number;
+    /**
+     * Total output tokens in the selected range
+     */
+    totalTokensOut: number;
     /**
      * Total tokens used
      */
     totalTokens: TokenUsage;
     /**
-     * Usage by model
+     * Cache hit rate as a percentage
+     */
+    cacheHitRate: number;
+    /**
+     * Usage by model keyed by model id
      */
     byModel: Record<string, {
         requests: number;
         tokens: TokenUsage;
+        tokensIn: number;
+        tokensOut: number;
+    }>;
+    /**
+     * Usage by model in API response order
+     */
+    byModelList: Array<{
+        modelId: string;
+        requests: number;
+        tokensIn: number;
+        tokensOut: number;
+    }>;
+    /**
+     * Daily rollup for charts
+     */
+    byDay: Array<{
+        date: string;
+        requests: number;
+        tokens: number;
     }>;
     /**
      * Average latency in milliseconds
      */
+    averageLatencyMs: number;
+    /**
+     * Legacy alias for averageLatencyMs
+     */
     avgLatencyMs: number;
+    /**
+     * Date range for the returned stats
+     */
+    dateRange: {
+        start: string;
+        end: string;
+    };
     /**
      * Period start date
      */
@@ -641,11 +686,11 @@ interface WebhookConfig {
  * Use in Next.js API routes, Server Actions, or any Node.js/Edge environment.
  *
  * Features:
- * - 🔐 HMAC Authentication with browser support
- * - ⚡ Configurable timeout (default 10 minutes)
- * - 🔄 Automatic retries with exponential backoff
- * - 📦 Structured error handling
- * - 🎯 Full TypeScript support
+ * - HMAC authentication with browser support
+ * - Configurable timeout (default 10 minutes)
+ * - Automatic retries with exponential backoff
+ * - Structured error handling
+ * - Full TypeScript support
  *
  * @example
  * ```typescript
@@ -674,6 +719,7 @@ declare class Hydra {
     private readonly maxRetries;
     private readonly keyPrefix;
     private readonly debug;
+    private static readonly LEGACY_ONLY_OPTION_LABELS;
     constructor(config: HydraConfig);
     /**
      * Generate content using your fallback chain
@@ -692,11 +738,13 @@ declare class Hydra {
      * ```
      */
     generate(options: GenerateOptions): Promise<GenerateResult>;
+    private shouldUseOptimizedFlow;
+    private getLegacyFallbackReason;
     /**
      * Optimized 3-step generation (minimizes Vercel compute costs)
      *
      * Step 1: Get token from Vercel (~50ms)
-     * Step 2: Call CF Worker directly (FREE)
+     * Step 2: Call the Cloudflare Worker directly
      * Step 3: Cache result in Vercel (~50ms)
      *
      * Total Vercel time: ~100ms vs 30-120s in legacy mode
@@ -827,13 +875,7 @@ declare class Hydra {
      *
      * @returns Detailed health status
      */
-    healthDetailed(): Promise<{
-        status: 'healthy' | 'degraded' | 'unhealthy';
-        timestamp: string;
-        uptime: number;
-        components: Record<string, unknown>;
-        metrics: Record<string, unknown>;
-    }>;
+    healthDetailed(): Promise<DetailedHealthResult>;
     /**
      * Generate content for multiple prompts in a single request
      *
@@ -1024,8 +1066,7 @@ declare function isRetryableError(error: unknown): boolean;
  *
  * Automatically detects environment and uses appropriate implementation.
  *
- * IMPORTANT: We hash the secret key first, then use the hash as HMAC key.
- * This allows the server to verify using the stored hash (it never sees the full key).
+ * Uses the raw secret key as the HMAC key.
  */
 declare function generateSignature(secretKey: string, method: string, path: string, body: string, timestamp: number): Promise<string>;
 /**

package/dist/index.d.ts

@@ -69,7 +69,7 @@ interface GenerateOptions {
      * The server automatically handles:
      * - File type detection (magic bytes)
      * - Model compatibility checking
-     * - Automatic conversion (e.g., DOCX → PDF)
+     * - Automatic conversion (for example, DOCX to PDF)
      *
      * @example
      * ```typescript
@@ -94,10 +94,9 @@ interface GenerateOptions {
     useOptimized?: boolean;
     /**
      * Cache scope for this request.
-     * - 'global': Cache is shared across all users (default)
      * - 'user': Cache is scoped to the authenticated user
+     * - 'global': Cache is shared across users
      * - 'skip': Do not cache this response
-     * @default 'global'
      */
     cacheScope?: 'global' | 'user' | 'skip';
     /**
@@ -113,7 +112,7 @@ interface GenerateOptions {
     signal?: AbortSignal;
     /**
      * Override max retries for this specific request.
-     * Set to 0 to disable retries for idempotent-sensitive operations.
+     * Set to 0 to disable retries for this call.
      */
     maxRetries?: number;
     /**
@@ -125,12 +124,13 @@ interface GenerateOptions {
     cacheQuality?: 'STANDARD' | 'HIGH' | 'MAX_EFFICIENCY';
     /**
      * Force strict JSON usage for providers that support it.
-     * If true, ensures the model outputs valid JSON conforming to the schema.
+     * When enabled with a schema, the SDK uses the legacy endpoint so
+     * validation and repair behave consistently.
      */
     strictJson?: boolean;
     /**
-     * Client-generated request ID for tracing and debugging.
-     * If not provided, one will be generated automatically.
+     * Optional client-side correlation id.
+     * Reserved for compatibility with custom tracing layers.
      */
     requestId?: string;
     /**
@@ -184,9 +184,8 @@ interface GenerationParameters {
      */
     systemPrompt?: string;
     /**
-     * Enable thinking/reasoning mode for supported models.
-     * When enabled, the model will show its reasoning process.
-     * Only works with models that support thinking (e.g., Gemini 2.0 Flash Thinking).
+     * Reserved for reasoning-mode support on deployments that expose it.
+     * Deployments that do not support this flag may ignore it.
      */
     thinkingMode?: boolean;
 }
@@ -504,22 +503,68 @@ interface UsageStats {
     /**
      * Cached responses served
      */
+    cachedRequests: number;
+    /**
+     * Legacy alias for cachedRequests
+     */
     cachedResponses: number;
+    /**
+     * Total input tokens in the selected range
+     */
+    totalTokensIn: number;
+    /**
+     * Total output tokens in the selected range
+     */
+    totalTokensOut: number;
     /**
      * Total tokens used
      */
     totalTokens: TokenUsage;
     /**
-     * Usage by model
+     * Cache hit rate as a percentage
+     */
+    cacheHitRate: number;
+    /**
+     * Usage by model keyed by model id
      */
     byModel: Record<string, {
         requests: number;
         tokens: TokenUsage;
+        tokensIn: number;
+        tokensOut: number;
+    }>;
+    /**
+     * Usage by model in API response order
+     */
+    byModelList: Array<{
+        modelId: string;
+        requests: number;
+        tokensIn: number;
+        tokensOut: number;
+    }>;
+    /**
+     * Daily rollup for charts
+     */
+    byDay: Array<{
+        date: string;
+        requests: number;
+        tokens: number;
     }>;
     /**
      * Average latency in milliseconds
      */
+    averageLatencyMs: number;
+    /**
+     * Legacy alias for averageLatencyMs
+     */
     avgLatencyMs: number;
+    /**
+     * Date range for the returned stats
+     */
+    dateRange: {
+        start: string;
+        end: string;
+    };
     /**
      * Period start date
      */
@@ -641,11 +686,11 @@ interface WebhookConfig {
  * Use in Next.js API routes, Server Actions, or any Node.js/Edge environment.
  *
  * Features:
- * - 🔐 HMAC Authentication with browser support
- * - ⚡ Configurable timeout (default 10 minutes)
- * - 🔄 Automatic retries with exponential backoff
- * - 📦 Structured error handling
- * - 🎯 Full TypeScript support
+ * - HMAC authentication with browser support
+ * - Configurable timeout (default 10 minutes)
+ * - Automatic retries with exponential backoff
+ * - Structured error handling
+ * - Full TypeScript support
  *
  * @example
  * ```typescript
@@ -674,6 +719,7 @@ declare class Hydra {
     private readonly maxRetries;
     private readonly keyPrefix;
     private readonly debug;
+    private static readonly LEGACY_ONLY_OPTION_LABELS;
     constructor(config: HydraConfig);
     /**
      * Generate content using your fallback chain
@@ -692,11 +738,13 @@ declare class Hydra {
      * ```
      */
     generate(options: GenerateOptions): Promise<GenerateResult>;
+    private shouldUseOptimizedFlow;
+    private getLegacyFallbackReason;
     /**
      * Optimized 3-step generation (minimizes Vercel compute costs)
      *
      * Step 1: Get token from Vercel (~50ms)
-     * Step 2: Call CF Worker directly (FREE)
+     * Step 2: Call the Cloudflare Worker directly
      * Step 3: Cache result in Vercel (~50ms)
      *
      * Total Vercel time: ~100ms vs 30-120s in legacy mode
@@ -827,13 +875,7 @@ declare class Hydra {
      *
      * @returns Detailed health status
      */
-    healthDetailed(): Promise<{
-        status: 'healthy' | 'degraded' | 'unhealthy';
-        timestamp: string;
-        uptime: number;
-        components: Record<string, unknown>;
-        metrics: Record<string, unknown>;
-    }>;
+    healthDetailed(): Promise<DetailedHealthResult>;
     /**
      * Generate content for multiple prompts in a single request
      *
@@ -1024,8 +1066,7 @@ declare function isRetryableError(error: unknown): boolean;
  *
  * Automatically detects environment and uses appropriate implementation.
  *
- * IMPORTANT: We hash the secret key first, then use the hash as HMAC key.
- * This allows the server to verify using the stored hash (it never sees the full key).
+ * Uses the raw secret key as the HMAC key.
  */
 declare function generateSignature(secretKey: string, method: string, path: string, body: string, timestamp: number): Promise<string>;
 /**

package/dist/index.js

@@ -1,4 +1,4 @@
-'use strict';var K=typeof process<"u"&&process.versions?.node;async function H(n){let{createHash:e}=await import('crypto');return e("sha256").update(n).digest("hex")}async function G(n,e,t,r,o){let{createHmac:s}=await import('crypto'),c=[e.toUpperCase(),t,o.toString(),r].join(`
-`),d=await H(n);return s("sha256",d).update(c).digest("hex")}async function L(n){let t=new TextEncoder().encode(n),r=await crypto.subtle.digest("SHA-256",t);return Array.from(new Uint8Array(r)).map(s=>s.toString(16).padStart(2,"0")).join("")}async function W(n,e,t,r,o){let s=new TextEncoder,c=[e.toUpperCase(),t,o.toString(),r].join(`
-`),d=await L(n),a=s.encode(d),i=await crypto.subtle.importKey("raw",a,{name:"HMAC",hash:"SHA-256"},false,["sign"]),m=await crypto.subtle.sign("HMAC",i,s.encode(c));return Array.from(new Uint8Array(m)).map(p=>p.toString(16).padStart(2,"0")).join("")}async function T(n,e,t,r,o){return K?G(n,e,t,r,o):W(n,e,t,r,o)}function U(n){return n.slice(0,12)}function C(n){return typeof n=="string"&&n.startsWith("hyd_sk_")&&n.length>=20}var u=class extends Error{constructor(e,t,r){super(e),this.name="HydraError",this.code=t,this.retryable=r?.retryable??false,this.statusCode=r?.statusCode,this.originalError=r?.cause;}},k=class extends u{constructor(e){super(e,"CONFIGURATION_ERROR",{retryable:false}),this.name="ConfigurationError";}},x=class extends u{constructor(e,t){super(e,"AUTH_ERROR",{retryable:false,statusCode:t}),this.name="AuthenticationError";}},E=class extends u{constructor(e,t=6e4){super(e,"RATE_LIMITED",{retryable:true,statusCode:429}),this.name="RateLimitError",this.retryAfterMs=t;}},R=class extends u{constructor(e){super(`Request timed out after ${e}ms`,"TIMEOUT",{retryable:true}),this.name="TimeoutError",this.timeoutMs=e;}},w=class extends u{constructor(e,t){super(e,"NETWORK_ERROR",{retryable:true,cause:t}),this.name="NetworkError";}},f=class extends u{constructor(e,t=[]){super(e,"CHAIN_FAILED",{retryable:false}),this.name="ChainExecutionError",this.attemptedModels=t;}},P=class extends u{constructor(e,t=[]){super(e,"VALIDATION_ERROR",{retryable:false}),this.name="ValidationError",this.validationErrors=t;}},g=class extends u{constructor(e,t=500){super(e,"SERVER_ERROR",{retryable:true,statusCode:t}),this.name="ServerError";}},v=class extends u{constructor(e,t){super(e,"QUOTA_EXCEEDED",{retryable:false,statusCode:402}),this.name="QuotaExceededError",this.tier=t.tier,this.limit=t.limit,this.used=t.used;}},O=class extends u{constructor(e,t){super(e,"WORKER_ERROR",{retryable:true}),this.name="WorkerError",this.workerDurationMs=t;}},I=class extends u{constructor(e,t){super(e,"FILE_PROCESSING_ERROR",{retryable:false}),this.name="FileProcessingError",this.filename=t.filename,this.mimeType=t.mimeType,this.reason=t.reason;}},M=class extends u{constructor(e,t){super(e,"INVALID_SCHEMA",{retryable:false}),this.name="InvalidSchemaError",this.schemaPath=t;}};function _(n){return n instanceof u}function q(n){return _(n)?n.retryable:false}var F="http://localhost:3000",$=6e5,B=3,N=[1e3,2e3,5e3];function J(n){let e=n.trim(),t=e.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);t&&(e=t[1].trim());let r=e.indexOf("{"),o=e.indexOf("["),s;if(r===-1&&o===-1)return e;r===-1?s=o:o===-1?s=r:s=Math.min(r,o);let c=e[s],d=c==="{"?"}":"]",a=0,i=false,m=false,y=-1;for(let h=s;h<e.length;h++){let b=e[h];if(m){m=false;continue}if(b==="\\"&&i){m=true;continue}if(b==='"'&&!m){i=!i;continue}if(!i){if(b===c)a++;else if(b===d&&(a--,a===0)){y=h;break}}}if(y!==-1)return e.slice(s,y+1);let p=e.lastIndexOf(d);return p>s?e.slice(s,p+1):e}var D=class n{constructor(e){if(!e.secretKey)throw new k("secretKey is required");if(!C(e.secretKey))throw new k("Invalid secret key format. Expected format: hyd_sk_<key>");this.secretKey=e.secretKey,this.baseUrl=(e.baseUrl||F).replace(/\/$/,""),this.timeout=e.timeout??$,this.maxRetries=e.maxRetries??B,this.keyPrefix=U(e.secretKey),this.debug=e.debug??false,this.debug&&this.log("Initialized",{baseUrl:this.baseUrl,timeout:this.timeout});}async generate(e){if(e.useOptimized!==false)try{return await this.generateOptimized(e)}catch(r){this.debug&&this.log("3-step generation failed, falling back to legacy",{error:r instanceof Error?r.message:String(r)});}return this.generateLegacy(e)}async generateOptimized(e){let t=Date.now(),r="/api/v1/generate/token",o=JSON.stringify({chainId:e.chainId,prompt:e.prompt,systemPrompt:e.options?.systemPrompt,temperature:e.options?.temperature,maxTokens:e.options?.maxTokens,topP:e.options?.topP,topK:e.options?.topK,files:e.files}),s=await this.makeAuthenticatedRequest(r,"POST",o);if(s.cached&&s.data)return this.debug&&this.log("generate cache hit (optimized)",{latencyMs:Date.now()-t}),{success:true,data:s.data,meta:{cached:true,modelUsed:s.meta?.modelUsed||"",tokensUsed:{input:0,output:0},latencyMs:Date.now()-t,attemptedModels:[]}};if(!s.token||!s.workerUrl)throw new f("Token generation failed - no token or worker URL returned",[]);let c=JSON.stringify({token:s.token,prompt:e.prompt,systemPrompt:e.options?.systemPrompt,timeout:e.timeout??this.timeout}),a=await(await this.fetchWithTimeout(s.workerUrl,{method:"POST",headers:{"Content-Type":"application/json"},body:c},e.timeout??this.timeout)).json();if(!a.success||!a.content)return {success:false,data:{valid:[],invalid:[]},meta:{cached:false,modelUsed:a.modelId||"",tokensUsed:a.tokensUsed||{input:0,output:0},latencyMs:Date.now()-t,attemptedModels:[a.modelId||""]},error:{code:a.errorCode||"GENERATION_FAILED",message:a.errorMessage||"Generation failed",retryable:false}};let i=[],m=[],y=J(a.content);try{let h=JSON.parse(y);Array.isArray(h)?i=h:i=[h];}catch{i=[y];}a.completionToken&&this.cacheCompletionAsync({completionToken:a.completionToken,content:a.content,tokensUsed:a.tokensUsed||{input:0,output:0},finishReason:a.finishReason||"stop",chainId:e.chainId,modelUsed:a.modelId,prompt:e.prompt,systemPrompt:e.options?.systemPrompt,temperature:e.options?.temperature,maxTokens:e.options?.maxTokens,topP:e.options?.topP,topK:e.options?.topK}).catch(h=>{this.debug&&this.log("cacheCompletion failed (non-blocking)",{error:h});});let p=Date.now()-t;return this.debug&&this.log("generate success (optimized 3-step)",{latencyMs:p,modelUsed:a.modelId,tokensUsed:a.tokensUsed}),{success:true,data:{valid:i,invalid:m},meta:{cached:false,modelUsed:a.modelId,tokensUsed:a.tokensUsed||{input:0,output:0},latencyMs:p,attemptedModels:[a.modelId]}}}async cacheCompletionAsync(e){let t="/api/v1/generate/complete",r=JSON.stringify(e);await this.makeAuthenticatedRequest(t,"POST",r);}async generateLegacy(e){let t=Date.now(),r="/api/v1/generate",o=JSON.stringify({chainId:e.chainId,prompt:e.prompt,schema:e.schema,noCache:e.noCache,files:e.files,options:{...e.options,timeout:e.timeout??this.timeout}}),s=null;for(let a=0;a<=this.maxRetries;a++)try{let i=await this.makeAuthenticatedRequest(r,"POST",o,e.timeout),m=Date.now()-t;return this.debug&&this.log("generate success (legacy)",{latencyMs:m,attempt:a+1}),i.meta&&(i.meta.latencyMs=m),i}catch(i){if(s=i instanceof Error?i:new Error(String(i)),this.debug&&this.log(`generate attempt ${a+1} failed`,{error:s.message}),!this.isRetryable(i)||a>=this.maxRetries)break;let m=N[Math.min(a,N.length-1)];i instanceof E&&i.retryAfterMs>m?await this.sleep(i.retryAfterMs):await this.sleep(m);}let c=Date.now()-t,d=s instanceof R;return {success:false,data:{valid:[],invalid:[]},meta:{cached:false,modelUsed:"",tokensUsed:{input:0,output:0},latencyMs:c,attemptedModels:[]},error:{code:d?"TIMEOUT":"REQUEST_FAILED",message:s?.message||"Request failed after all retries",retryable:false}}}async generateStream(e,t){let r="/api/v1/generate/stream",o=JSON.stringify({chainId:e.chainId,prompt:e.prompt,schema:e.schema,options:e.options});try{let s=Date.now(),c=await T(this.secretKey,"POST",r,o,s),d=await this.fetchWithTimeout(`${this.baseUrl}${r}`,{method:"POST",headers:{"Content-Type":"application/json",Accept:"text/event-stream","x-hydra-signature":c,"x-hydra-timestamp":s.toString(),"x-hydra-key":this.keyPrefix},body:o},e.timeout??this.timeout);if(!d.ok){let p=await d.json();throw this.parseError(d.status,p)}let a=d.body?.getReader();if(!a)throw new w("Response body is not readable");let i=new TextDecoder,m="",y=[];for(;;){let{done:p,value:h}=await a.read();if(p)break;m+=i.decode(h,{stream:!0});let b=m.split(`
-`);m=b.pop()||"";let A="";for(let S of b){if(S.startsWith("event: ")){A=S.slice(7).trim();continue}if(S.startsWith("data: ")){let j=S.slice(6);if(j==="[DONE]")break;try{let l=JSON.parse(j);switch(A){case "start":this.debug&&this.log("Stream started",l);break;case "object":l.object!==void 0&&(y.push(l.object),t.onObject?.(l.object,l.index)),t.onChunk&&l.object&&t.onChunk(JSON.stringify(l.object));break;case "array_start":t.onArrayStart?.();break;case "complete":t.onComplete&&t.onComplete({objects:y,objectCount:l.objectCount,tokensUsed:l.tokensUsed,cached:l.cached});break;case "error":t.onError&&t.onError(new f(l.error||"Stream error",["STREAM_ERROR"]));break;default:l.chunk&&t.onChunk?.(l.chunk);}}catch{}A="";}}}}catch(s){if(t.onError)t.onError(s instanceof Error?s:new Error(String(s)));else throw s}}async listModels(){let t=await(await this.fetchWithTimeout(`${this.baseUrl}/api/v1/models`,{method:"GET",headers:{Accept:"application/json"}})).json();if(!t.success)throw new g(t.error?.message||"Failed to list models");return t.data}async listChains(){let t=await(await this.fetchWithTimeout(`${this.baseUrl}/api/v1/chains`,{method:"GET",credentials:"include",headers:{Accept:"application/json"}})).json();if(!t.success)throw new g(t.error?.message||"Failed to list chains");return t.data}async getUsage(e){let t=new URLSearchParams;e?.startDate&&t.set("startDate",e.startDate.toISOString()),e?.endDate&&t.set("endDate",e.endDate.toISOString());let r=`${this.baseUrl}/api/v1/usage${t.toString()?"?"+t:""}`,s=await(await this.fetchWithTimeout(r,{method:"GET",credentials:"include",headers:{Accept:"application/json"}})).json();if(!s.success)throw new g(s.error?.message||"Failed to get usage");return s.data}async health(){let e=Date.now();try{let t=await this.fetchWithTimeout(`${this.baseUrl}/api/health`,{method:"GET"},5e3),r=Date.now()-e,o=await t.json().catch(()=>({}));return {ok:t.ok,latencyMs:r,version:o.version}}catch{return {ok:false,latencyMs:Date.now()-e}}}withConfig(e){return new n({secretKey:this.secretKey,baseUrl:this.baseUrl,timeout:this.timeout,maxRetries:this.maxRetries,debug:this.debug,...e})}async registerWebhook(e){let t=await this.makeAuthenticatedRequest("/api/v1/webhooks","POST",JSON.stringify(e));if(!t.success||!t.data)throw new g(t.error?.message||"Failed to register webhook");return t.data}async unregisterWebhook(e){let t=await this.makeAuthenticatedRequest(`/api/v1/webhooks/${e}`,"DELETE","");if(!t.success||!t.data)throw new g(t.error?.message||"Failed to unregister webhook");return t.data}async listWebhooks(){let e=await this.makeAuthenticatedRequest("/api/v1/webhooks","GET","");if(!e.success)throw new g(e.error?.message||"Failed to list webhooks");return e.data||[]}async updateWebhook(e,t){let r=await this.makeAuthenticatedRequest(`/api/v1/webhooks/${e}`,"PATCH",JSON.stringify(t));if(!r.success||!r.data)throw new g(r.error?.message||"Failed to update webhook");return r.data}async healthDetailed(){return (await fetch(`${this.baseUrl}/api/v1/health/detailed`,{headers:{Accept:"application/json"}})).json()}async generateBatch(e,t,r={}){let o=await this.makeAuthenticatedRequest("/api/v1/generate/batch","POST",JSON.stringify({chainId:e,items:t,continueOnError:r.continueOnError??true}));if(!o.success||!o.data)throw new f(o.error?.message||"Batch generation failed",[]);return o.data}async makeAuthenticatedRequest(e,t,r,o){let s=Date.now(),c=await T(this.secretKey,t,e,r,s),d=await this.fetchWithTimeout(`${this.baseUrl}${e}`,{method:t,headers:{"Content-Type":"application/json",Accept:"application/json","x-hydra-signature":c,"x-hydra-timestamp":s.toString(),"x-hydra-key":this.keyPrefix},body:r},o??this.timeout),a=await d.json();if(!d.ok)throw this.parseError(d.status,a);return a}async fetchWithTimeout(e,t,r=this.timeout){let o=new AbortController,s=setTimeout(()=>o.abort(),r);try{return await fetch(e,{...t,signal:o.signal})}catch(c){throw c instanceof Error&&c.name==="AbortError"?new R(r):c instanceof Error?new w(c.message,c):new w(String(c))}finally{clearTimeout(s);}}parseError(e,t){let r=typeof t?.error=="string"?t.error:t?.error?.message||`HTTP ${e}`,o=t?.error?.code||"UNKNOWN";switch(e){case 401:return new x(r,e);case 429:let s=t?.retryAfterMs||6e4;return new E(r,s);case 500:case 502:case 503:case 504:return new g(r,e);default:return o==="CHAIN_FAILED"?new f(r,t?.error?.attemptedModels||[]):new u(r,o,{statusCode:e,retryable:e>=500})}}isRetryable(e){if(e instanceof u)return e.retryable;if(e instanceof Error){let t=e.message.toLowerCase();return t.includes("network")||t.includes("timeout")||e.name==="AbortError"}return  false}sleep(e){return new Promise(t=>setTimeout(t,e))}log(e,t){let r="[Hydra]";t?console.log(r,e,t):console.log(r,e);}};exports.AuthenticationError=x;exports.ChainExecutionError=f;exports.ConfigurationError=k;exports.FileProcessingError=I;exports.Hydra=D;exports.HydraError=u;exports.InvalidSchemaError=M;exports.NetworkError=w;exports.QuotaExceededError=v;exports.RateLimitError=E;exports.ServerError=g;exports.TimeoutError=R;exports.ValidationError=P;exports.WorkerError=O;exports.generateSignature=T;exports.getKeyPrefix=U;exports.isHydraError=_;exports.isRetryableError=q;exports.isValidSecretKey=C;
+'use strict';var G=typeof process<"u"&&process.versions?.node;async function H(i,e,t,r,a){let{createHmac:s}=await import('crypto'),o=[e.toUpperCase(),t,a.toString(),r].join(`
+`);return s("sha256",i).update(o).digest("hex")}async function j(i,e,t,r,a){let s=new TextEncoder,o=[e.toUpperCase(),t,a.toString(),r].join(`
+`),d=await crypto.subtle.importKey("raw",s.encode(i),{name:"HMAC",hash:"SHA-256"},false,["sign"]),n=await crypto.subtle.sign("HMAC",d,s.encode(o));return Array.from(new Uint8Array(n)).map(c=>c.toString(16).padStart(2,"0")).join("")}async function A(i,e,t,r,a){return G?H(i,e,t,r,a):j(i,e,t,r,a)}function I(i){return i.slice(0,12)}function C(i){return typeof i=="string"&&i.startsWith("hyd_sk_")&&i.length>=20}var m=class extends Error{constructor(e,t,r){super(e),this.name="HydraError",this.code=t,this.retryable=r?.retryable??false,this.statusCode=r?.statusCode,this.originalError=r?.cause;}},w=class extends m{constructor(e){super(e,"CONFIGURATION_ERROR",{retryable:false}),this.name="ConfigurationError";}},S=class extends m{constructor(e,t){super(e,"AUTH_ERROR",{retryable:false,statusCode:t}),this.name="AuthenticationError";}},E=class extends m{constructor(e,t=6e4){super(e,"RATE_LIMITED",{retryable:true,statusCode:429}),this.name="RateLimitError",this.retryAfterMs=t;}},R=class extends m{constructor(e){super(`Request timed out after ${e}ms`,"TIMEOUT",{retryable:true}),this.name="TimeoutError",this.timeoutMs=e;}},k=class extends m{constructor(e,t){super(e,"NETWORK_ERROR",{retryable:true,cause:t}),this.name="NetworkError";}},b=class extends m{constructor(e,t=[]){super(e,"CHAIN_FAILED",{retryable:false}),this.name="ChainExecutionError",this.attemptedModels=t;}},U=class extends m{constructor(e,t=[]){super(e,"VALIDATION_ERROR",{retryable:false}),this.name="ValidationError",this.validationErrors=t;}},y=class extends m{constructor(e,t=500){super(e,"SERVER_ERROR",{retryable:true,statusCode:t}),this.name="ServerError";}},T=class extends m{constructor(e,t){super(e,"QUOTA_EXCEEDED",{retryable:false,statusCode:402}),this.name="QuotaExceededError",this.tier=t.tier,this.limit=t.limit,this.used=t.used;}},P=class extends m{constructor(e,t){super(e,"WORKER_ERROR",{retryable:true}),this.name="WorkerError",this.workerDurationMs=t;}},M=class extends m{constructor(e,t){super(e,"FILE_PROCESSING_ERROR",{retryable:false}),this.name="FileProcessingError",this.filename=t.filename,this.mimeType=t.mimeType,this.reason=t.reason;}},D=class extends m{constructor(e,t){super(e,"INVALID_SCHEMA",{retryable:false}),this.name="InvalidSchemaError",this.schemaPath=t;}};function N(i){return i instanceof m}function K(i){return N(i)?i.retryable:false}var F="http://localhost:3000",W=6e5,J=3,_=[1e3,2e3,5e3];function $(i){let e=i.trim(),t=e.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);t&&(e=t[1].trim());let r=e.indexOf("{"),a=e.indexOf("["),s;if(r===-1&&a===-1)return e;r===-1?s=a:a===-1?s=r:s=Math.min(r,a);let o=e[s],d=o==="{"?"}":"]",n=0,u=false,c=false,l=-1;for(let g=s;g<e.length;g++){let h=e[g];if(c){c=false;continue}if(h==="\\"&&u){c=true;continue}if(h==='"'&&!c){u=!u;continue}if(!u){if(h===o)n++;else if(h===d&&(n--,n===0)){l=g;break}}}if(l!==-1)return e.slice(s,l+1);let f=e.lastIndexOf(d);return f>s?e.slice(s,f+1):e}var O=class O{constructor(e){if(!e.secretKey)throw new w("secretKey is required");if(!C(e.secretKey))throw new w("Invalid secret key format. Expected format: hyd_sk_<key>");this.secretKey=e.secretKey,this.baseUrl=(e.baseUrl||F).replace(/\/$/,""),this.timeout=e.timeout??W,this.maxRetries=e.maxRetries??J,this.keyPrefix=I(e.secretKey),this.debug=e.debug??false,this.debug&&this.log("Initialized",{baseUrl:this.baseUrl,timeout:this.timeout});}async generate(e){if(this.shouldUseOptimizedFlow(e))try{return await this.generateOptimized(e)}catch(r){this.debug&&this.log("3-step generation failed, falling back to legacy",{error:r instanceof Error?r.message:String(r)});}else e.useOptimized!==false&&this.debug&&this.log("generate using legacy endpoint",{reason:this.getLegacyFallbackReason(e)});return this.generateLegacy(e)}shouldUseOptimizedFlow(e){return e.useOptimized===false?false:O.LEGACY_ONLY_OPTION_LABELS.every(([t])=>e[t]===void 0)}getLegacyFallbackReason(e){let t=O.LEGACY_ONLY_OPTION_LABELS.filter(([r])=>e[r]!==void 0).map(([,r])=>r);return t.length===0?"optimized flow disabled":t.join(", ")}async generateOptimized(e){let t=Date.now(),r="/api/v1/generate/token",a=JSON.stringify({chainId:e.chainId,prompt:e.prompt,systemPrompt:e.options?.systemPrompt,temperature:e.options?.temperature,maxTokens:e.options?.maxTokens,topP:e.options?.topP,topK:e.options?.topK,files:e.files}),s=await this.makeAuthenticatedRequest(r,"POST",a,void 0,e.signal);if(s.cached&&s.data)return this.debug&&this.log("generate cache hit (optimized)",{latencyMs:Date.now()-t}),{success:true,data:s.data,meta:{cached:true,modelUsed:s.meta?.modelUsed||"",tokensUsed:{input:0,output:0},latencyMs:Date.now()-t,attemptedModels:[]}};if(!s.token||!s.workerUrl)throw new b("Token generation failed - no token or worker URL returned",[]);let o=JSON.stringify({token:s.token,prompt:e.prompt,systemPrompt:e.options?.systemPrompt,timeout:e.timeout??this.timeout}),n=await(await this.fetchWithTimeout(s.workerUrl,{method:"POST",headers:{"Content-Type":"application/json"},body:o},e.timeout??this.timeout,e.signal)).json();if(!n.success||!n.content)return {success:false,data:{valid:[],invalid:[]},meta:{cached:false,modelUsed:n.modelId||"",tokensUsed:n.tokensUsed||{input:0,output:0},latencyMs:Date.now()-t,attemptedModels:[n.modelId||""]},error:{code:n.errorCode||"GENERATION_FAILED",message:n.errorMessage||"Generation failed",retryable:false}};let u=[],c=[],l=$(n.content);try{let g=JSON.parse(l);Array.isArray(g)?u=g:u=[g];}catch{u=[l];}n.completionToken&&this.cacheCompletionAsync({completionToken:n.completionToken,content:n.content,tokensUsed:n.tokensUsed||{input:0,output:0},finishReason:n.finishReason||"stop",chainId:e.chainId,modelUsed:n.modelId,prompt:e.prompt,systemPrompt:e.options?.systemPrompt,temperature:e.options?.temperature,maxTokens:e.options?.maxTokens,topP:e.options?.topP,topK:e.options?.topK}).catch(g=>{this.debug&&this.log("cacheCompletion failed (non-blocking)",{error:g});});let f=Date.now()-t;return this.debug&&this.log("generate success (optimized 3-step)",{latencyMs:f,modelUsed:n.modelId,tokensUsed:n.tokensUsed}),{success:true,data:{valid:u,invalid:c},meta:{cached:false,modelUsed:n.modelId,tokensUsed:n.tokensUsed||{input:0,output:0},latencyMs:f,attemptedModels:[n.modelId]}}}async cacheCompletionAsync(e){let t="/api/v1/generate/complete",r=JSON.stringify(e);await this.makeAuthenticatedRequest(t,"POST",r);}async generateLegacy(e){let t=Date.now(),r="/api/v1/generate",a=JSON.stringify({chainId:e.chainId,prompt:e.prompt,schema:e.schema,noCache:e.noCache,cacheScope:e.cacheScope,cacheQuality:e.cacheQuality,strictJson:e.strictJson,files:e.files,options:{...e.options,timeout:e.timeout??this.timeout}}),s=null,o=e.maxRetries??this.maxRetries;for(let u=0;u<=o;u++)try{let c=await this.makeAuthenticatedRequest(r,"POST",a,e.timeout,e.signal),l=Date.now()-t;return this.debug&&this.log("generate success (legacy)",{latencyMs:l,attempt:u+1}),c.meta&&(c.meta.latencyMs=l),c}catch(c){if(s=c instanceof Error?c:new Error(String(c)),this.debug&&this.log(`generate attempt ${u+1} failed`,{error:s.message}),!this.isRetryable(c)||u>=o)break;let l=_[Math.min(u,_.length-1)];c instanceof E&&c.retryAfterMs>l?await this.sleep(c.retryAfterMs):await this.sleep(l);}let d=Date.now()-t,n=s instanceof R;return {success:false,data:{valid:[],invalid:[]},meta:{cached:false,modelUsed:"",tokensUsed:{input:0,output:0},latencyMs:d,attemptedModels:[]},error:{code:n?"TIMEOUT":"REQUEST_FAILED",message:s?.message||"Request failed after all retries",retryable:false}}}async generateStream(e,t){let r="/api/v1/generate/stream",a=JSON.stringify({chainId:e.chainId,prompt:e.prompt,schema:e.schema,options:e.options});try{let s=Date.now(),o=await A(this.secretKey,"POST",r,a,s),d=await this.fetchWithTimeout(`${this.baseUrl}${r}`,{method:"POST",headers:{"Content-Type":"application/json",Accept:"text/event-stream","x-hydra-signature":o,"x-hydra-timestamp":s.toString(),"x-hydra-key":this.keyPrefix},body:a},e.timeout??this.timeout);if(!d.ok){let f=await d.json();throw this.parseError(d.status,f)}let n=d.body?.getReader();if(!n)throw new k("Response body is not readable");let u=new TextDecoder,c="",l=[];for(;;){let{done:f,value:g}=await n.read();if(f)break;c+=u.decode(g,{stream:!0});let h=c.split(`
+`);c=h.pop()||"";let v="";for(let x of h){if(x.startsWith("event: ")){v=x.slice(7).trim();continue}if(x.startsWith("data: ")){let q=x.slice(6);if(q==="[DONE]")break;try{let p=JSON.parse(q);switch(v){case "start":this.debug&&this.log("Stream started",p);break;case "object":p.object!==void 0&&(l.push(p.object),t.onObject?.(p.object,p.index)),t.onChunk&&p.object&&t.onChunk(JSON.stringify(p.object));break;case "array_start":t.onArrayStart?.();break;case "complete":t.onComplete&&t.onComplete({objects:l,objectCount:p.objectCount,tokensUsed:p.tokensUsed,cached:p.cached});break;case "error":t.onError&&t.onError(new b(p.error||"Stream error",["STREAM_ERROR"]));break;default:p.chunk&&t.onChunk?.(p.chunk);}}catch{}v="";}}}}catch(s){if(t.onError)t.onError(s instanceof Error?s:new Error(String(s)));else throw s}}async listModels(){let t=await(await this.fetchWithTimeout(`${this.baseUrl}/api/v1/models`,{method:"GET",headers:{Accept:"application/json"}})).json();if(!t.success)throw new y(t.error?.message||"Failed to list models");return t.data}async listChains(){let t=await(await this.fetchWithTimeout(`${this.baseUrl}/api/v1/chains`,{method:"GET",credentials:"include",headers:{Accept:"application/json"}})).json();if(!t.success)throw new y(t.error?.message||"Failed to list chains");return t.data}async getUsage(e){let t=new URLSearchParams;e?.startDate&&t.set("start",e.startDate.toISOString()),e?.endDate&&t.set("end",e.endDate.toISOString());let r=`${this.baseUrl}/api/v1/usage${t.toString()?"?"+t:""}`,s=await(await this.fetchWithTimeout(r,{method:"GET",credentials:"include",headers:{Accept:"application/json"}})).json();if(!s.success)throw new y(s.error?.message||"Failed to get usage");let o=s.data;if(!o)throw new y("Usage payload was empty");let d=o.cachedRequests??o.cachedResponses??0,n=o.totalTokensIn??o.totalTokens?.input??0,u=o.totalTokensOut??o.totalTokens?.output??0,c=o.averageLatencyMs??o.avgLatencyMs??0,l=s.meta?.dateRange??{start:e?.startDate?.toISOString()??"",end:e?.endDate?.toISOString()??""},f=o.byModel??[],g=Object.fromEntries(f.map(h=>[h.modelId,{requests:h.requests,tokensIn:h.tokensIn,tokensOut:h.tokensOut,tokens:{input:h.tokensIn,output:h.tokensOut,total:h.tokensIn+h.tokensOut}}]));return {totalRequests:o.totalRequests,successfulRequests:o.successfulRequests,failedRequests:o.failedRequests,cachedRequests:d,cachedResponses:d,totalTokensIn:n,totalTokensOut:u,totalTokens:{input:n,output:u,total:n+u},cacheHitRate:o.cacheHitRate,averageLatencyMs:c,avgLatencyMs:c,byModel:g,byModelList:f,byDay:o.byDay??[],dateRange:l,periodStart:l.start,periodEnd:l.end}}async health(){let e=Date.now();try{let t=await this.fetchWithTimeout(`${this.baseUrl}/api/v1/health`,{method:"GET"},5e3),r=Date.now()-e,a=await t.json().catch(()=>({}));return {ok:t.ok,latencyMs:r,version:a.version}}catch{return {ok:false,latencyMs:Date.now()-e}}}withConfig(e){return new O({secretKey:this.secretKey,baseUrl:this.baseUrl,timeout:this.timeout,maxRetries:this.maxRetries,debug:this.debug,...e})}async registerWebhook(e){let t=await this.makeAuthenticatedRequest("/api/v1/webhooks","POST",JSON.stringify(e));if(!t.success||!t.data)throw new y(t.error?.message||"Failed to register webhook");return t.data}async unregisterWebhook(e){let t=await this.makeAuthenticatedRequest(`/api/v1/webhooks/${e}`,"DELETE","");if(!t.success||!t.data)throw new y(t.error?.message||"Failed to unregister webhook");return t.data}async listWebhooks(){let e=await this.makeAuthenticatedRequest("/api/v1/webhooks","GET","");if(!e.success)throw new y(e.error?.message||"Failed to list webhooks");return e.data||[]}async updateWebhook(e,t){let r=await this.makeAuthenticatedRequest(`/api/v1/webhooks/${e}`,"PATCH",JSON.stringify(t));if(!r.success||!r.data)throw new y(r.error?.message||"Failed to update webhook");return r.data}async healthDetailed(){return this.makeAuthenticatedRequest("/api/v1/health/detailed","GET","")}async generateBatch(e,t,r={}){let a=await this.makeAuthenticatedRequest("/api/v1/generate/batch","POST",JSON.stringify({chainId:e,items:t,continueOnError:r.continueOnError??true}));if(!a.success||!a.data)throw new b(a.error?.message||"Batch generation failed",[]);return a.data}async makeAuthenticatedRequest(e,t,r,a,s){let o=Date.now(),d=t.toUpperCase(),n=await A(this.secretKey,d,e,r,o),u={method:d,headers:{"Content-Type":"application/json",Accept:"application/json","x-hydra-signature":n,"x-hydra-timestamp":o.toString(),"x-hydra-key":this.keyPrefix}};r.length>0&&d!=="GET"&&d!=="HEAD"&&(u.body=r);let c=await this.fetchWithTimeout(`${this.baseUrl}${e}`,u,a??this.timeout,s),l=await c.json();if(!c.ok)throw this.parseError(c.status,l);return l}async fetchWithTimeout(e,t,r=this.timeout,a){let s=new AbortController,o=setTimeout(()=>s.abort(),r),d=()=>s.abort();a&&(a.aborted?s.abort():a.addEventListener("abort",d,{once:true}));try{return await fetch(e,{...t,signal:s.signal})}catch(n){throw n instanceof Error&&n.name==="AbortError"?new R(r):n instanceof Error?new k(n.message,n):new k(String(n))}finally{clearTimeout(o),a?.removeEventListener("abort",d);}}parseError(e,t){let r=typeof t?.error=="string"?t.error:t?.error?.message||`HTTP ${e}`,a=t?.error?.code||"UNKNOWN",s=t?.meta||t;switch(e){case 401:return new S(r,e);case 429:if(s?.tier&&typeof s?.used=="number"&&typeof s?.limit=="number")return new T(r,{tier:s.tier,used:s.used,limit:s.limit});let o=t?.retryAfterMs||6e4;return new E(r,o);case 402:return new T(r,{tier:s?.tier||"UNKNOWN",used:s?.used||0,limit:s?.limit||0});case 500:case 502:case 503:case 504:return new y(r,e);default:return a==="CHAIN_FAILED"?new b(r,t?.error?.attemptedModels||[]):new m(r,a,{statusCode:e,retryable:e>=500})}}isRetryable(e){if(e instanceof m)return e.retryable;if(e instanceof Error){let t=e.message.toLowerCase();return t.includes("network")||t.includes("timeout")||e.name==="AbortError"}return  false}sleep(e){return new Promise(t=>setTimeout(t,e))}log(e,t){let r="[Hydra]";t?console.log(r,e,t):console.log(r,e);}};O.LEGACY_ONLY_OPTION_LABELS=[["schema","schema validation"],["noCache","cache bypass"],["cacheQuality","cache quality override"],["strictJson","strict JSON mode"],["cacheScope","cache scope override"],["maxRetries","per-request retries"]];var L=O;exports.AuthenticationError=S;exports.ChainExecutionError=b;exports.ConfigurationError=w;exports.FileProcessingError=M;exports.Hydra=L;exports.HydraError=m;exports.InvalidSchemaError=D;exports.NetworkError=k;exports.QuotaExceededError=T;exports.RateLimitError=E;exports.ServerError=y;exports.TimeoutError=R;exports.ValidationError=U;exports.WorkerError=P;exports.generateSignature=A;exports.getKeyPrefix=I;exports.isHydraError=N;exports.isRetryableError=K;exports.isValidSecretKey=C;

package/dist/index.mjs

@@ -1,4 +1,4 @@
-var K=typeof process<"u"&&process.versions?.node;async function H(n){let{createHash:e}=await import('crypto');return e("sha256").update(n).digest("hex")}async function G(n,e,t,r,o){let{createHmac:s}=await import('crypto'),c=[e.toUpperCase(),t,o.toString(),r].join(`
-`),d=await H(n);return s("sha256",d).update(c).digest("hex")}async function L(n){let t=new TextEncoder().encode(n),r=await crypto.subtle.digest("SHA-256",t);return Array.from(new Uint8Array(r)).map(s=>s.toString(16).padStart(2,"0")).join("")}async function W(n,e,t,r,o){let s=new TextEncoder,c=[e.toUpperCase(),t,o.toString(),r].join(`
-`),d=await L(n),a=s.encode(d),i=await crypto.subtle.importKey("raw",a,{name:"HMAC",hash:"SHA-256"},false,["sign"]),m=await crypto.subtle.sign("HMAC",i,s.encode(c));return Array.from(new Uint8Array(m)).map(p=>p.toString(16).padStart(2,"0")).join("")}async function T(n,e,t,r,o){return K?G(n,e,t,r,o):W(n,e,t,r,o)}function U(n){return n.slice(0,12)}function C(n){return typeof n=="string"&&n.startsWith("hyd_sk_")&&n.length>=20}var u=class extends Error{constructor(e,t,r){super(e),this.name="HydraError",this.code=t,this.retryable=r?.retryable??false,this.statusCode=r?.statusCode,this.originalError=r?.cause;}},k=class extends u{constructor(e){super(e,"CONFIGURATION_ERROR",{retryable:false}),this.name="ConfigurationError";}},x=class extends u{constructor(e,t){super(e,"AUTH_ERROR",{retryable:false,statusCode:t}),this.name="AuthenticationError";}},E=class extends u{constructor(e,t=6e4){super(e,"RATE_LIMITED",{retryable:true,statusCode:429}),this.name="RateLimitError",this.retryAfterMs=t;}},R=class extends u{constructor(e){super(`Request timed out after ${e}ms`,"TIMEOUT",{retryable:true}),this.name="TimeoutError",this.timeoutMs=e;}},w=class extends u{constructor(e,t){super(e,"NETWORK_ERROR",{retryable:true,cause:t}),this.name="NetworkError";}},f=class extends u{constructor(e,t=[]){super(e,"CHAIN_FAILED",{retryable:false}),this.name="ChainExecutionError",this.attemptedModels=t;}},P=class extends u{constructor(e,t=[]){super(e,"VALIDATION_ERROR",{retryable:false}),this.name="ValidationError",this.validationErrors=t;}},g=class extends u{constructor(e,t=500){super(e,"SERVER_ERROR",{retryable:true,statusCode:t}),this.name="ServerError";}},v=class extends u{constructor(e,t){super(e,"QUOTA_EXCEEDED",{retryable:false,statusCode:402}),this.name="QuotaExceededError",this.tier=t.tier,this.limit=t.limit,this.used=t.used;}},O=class extends u{constructor(e,t){super(e,"WORKER_ERROR",{retryable:true}),this.name="WorkerError",this.workerDurationMs=t;}},I=class extends u{constructor(e,t){super(e,"FILE_PROCESSING_ERROR",{retryable:false}),this.name="FileProcessingError",this.filename=t.filename,this.mimeType=t.mimeType,this.reason=t.reason;}},M=class extends u{constructor(e,t){super(e,"INVALID_SCHEMA",{retryable:false}),this.name="InvalidSchemaError",this.schemaPath=t;}};function _(n){return n instanceof u}function q(n){return _(n)?n.retryable:false}var F="http://localhost:3000",$=6e5,B=3,N=[1e3,2e3,5e3];function J(n){let e=n.trim(),t=e.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);t&&(e=t[1].trim());let r=e.indexOf("{"),o=e.indexOf("["),s;if(r===-1&&o===-1)return e;r===-1?s=o:o===-1?s=r:s=Math.min(r,o);let c=e[s],d=c==="{"?"}":"]",a=0,i=false,m=false,y=-1;for(let h=s;h<e.length;h++){let b=e[h];if(m){m=false;continue}if(b==="\\"&&i){m=true;continue}if(b==='"'&&!m){i=!i;continue}if(!i){if(b===c)a++;else if(b===d&&(a--,a===0)){y=h;break}}}if(y!==-1)return e.slice(s,y+1);let p=e.lastIndexOf(d);return p>s?e.slice(s,p+1):e}var D=class n{constructor(e){if(!e.secretKey)throw new k("secretKey is required");if(!C(e.secretKey))throw new k("Invalid secret key format. Expected format: hyd_sk_<key>");this.secretKey=e.secretKey,this.baseUrl=(e.baseUrl||F).replace(/\/$/,""),this.timeout=e.timeout??$,this.maxRetries=e.maxRetries??B,this.keyPrefix=U(e.secretKey),this.debug=e.debug??false,this.debug&&this.log("Initialized",{baseUrl:this.baseUrl,timeout:this.timeout});}async generate(e){if(e.useOptimized!==false)try{return await this.generateOptimized(e)}catch(r){this.debug&&this.log("3-step generation failed, falling back to legacy",{error:r instanceof Error?r.message:String(r)});}return this.generateLegacy(e)}async generateOptimized(e){let t=Date.now(),r="/api/v1/generate/token",o=JSON.stringify({chainId:e.chainId,prompt:e.prompt,systemPrompt:e.options?.systemPrompt,temperature:e.options?.temperature,maxTokens:e.options?.maxTokens,topP:e.options?.topP,topK:e.options?.topK,files:e.files}),s=await this.makeAuthenticatedRequest(r,"POST",o);if(s.cached&&s.data)return this.debug&&this.log("generate cache hit (optimized)",{latencyMs:Date.now()-t}),{success:true,data:s.data,meta:{cached:true,modelUsed:s.meta?.modelUsed||"",tokensUsed:{input:0,output:0},latencyMs:Date.now()-t,attemptedModels:[]}};if(!s.token||!s.workerUrl)throw new f("Token generation failed - no token or worker URL returned",[]);let c=JSON.stringify({token:s.token,prompt:e.prompt,systemPrompt:e.options?.systemPrompt,timeout:e.timeout??this.timeout}),a=await(await this.fetchWithTimeout(s.workerUrl,{method:"POST",headers:{"Content-Type":"application/json"},body:c},e.timeout??this.timeout)).json();if(!a.success||!a.content)return {success:false,data:{valid:[],invalid:[]},meta:{cached:false,modelUsed:a.modelId||"",tokensUsed:a.tokensUsed||{input:0,output:0},latencyMs:Date.now()-t,attemptedModels:[a.modelId||""]},error:{code:a.errorCode||"GENERATION_FAILED",message:a.errorMessage||"Generation failed",retryable:false}};let i=[],m=[],y=J(a.content);try{let h=JSON.parse(y);Array.isArray(h)?i=h:i=[h];}catch{i=[y];}a.completionToken&&this.cacheCompletionAsync({completionToken:a.completionToken,content:a.content,tokensUsed:a.tokensUsed||{input:0,output:0},finishReason:a.finishReason||"stop",chainId:e.chainId,modelUsed:a.modelId,prompt:e.prompt,systemPrompt:e.options?.systemPrompt,temperature:e.options?.temperature,maxTokens:e.options?.maxTokens,topP:e.options?.topP,topK:e.options?.topK}).catch(h=>{this.debug&&this.log("cacheCompletion failed (non-blocking)",{error:h});});let p=Date.now()-t;return this.debug&&this.log("generate success (optimized 3-step)",{latencyMs:p,modelUsed:a.modelId,tokensUsed:a.tokensUsed}),{success:true,data:{valid:i,invalid:m},meta:{cached:false,modelUsed:a.modelId,tokensUsed:a.tokensUsed||{input:0,output:0},latencyMs:p,attemptedModels:[a.modelId]}}}async cacheCompletionAsync(e){let t="/api/v1/generate/complete",r=JSON.stringify(e);await this.makeAuthenticatedRequest(t,"POST",r);}async generateLegacy(e){let t=Date.now(),r="/api/v1/generate",o=JSON.stringify({chainId:e.chainId,prompt:e.prompt,schema:e.schema,noCache:e.noCache,files:e.files,options:{...e.options,timeout:e.timeout??this.timeout}}),s=null;for(let a=0;a<=this.maxRetries;a++)try{let i=await this.makeAuthenticatedRequest(r,"POST",o,e.timeout),m=Date.now()-t;return this.debug&&this.log("generate success (legacy)",{latencyMs:m,attempt:a+1}),i.meta&&(i.meta.latencyMs=m),i}catch(i){if(s=i instanceof Error?i:new Error(String(i)),this.debug&&this.log(`generate attempt ${a+1} failed`,{error:s.message}),!this.isRetryable(i)||a>=this.maxRetries)break;let m=N[Math.min(a,N.length-1)];i instanceof E&&i.retryAfterMs>m?await this.sleep(i.retryAfterMs):await this.sleep(m);}let c=Date.now()-t,d=s instanceof R;return {success:false,data:{valid:[],invalid:[]},meta:{cached:false,modelUsed:"",tokensUsed:{input:0,output:0},latencyMs:c,attemptedModels:[]},error:{code:d?"TIMEOUT":"REQUEST_FAILED",message:s?.message||"Request failed after all retries",retryable:false}}}async generateStream(e,t){let r="/api/v1/generate/stream",o=JSON.stringify({chainId:e.chainId,prompt:e.prompt,schema:e.schema,options:e.options});try{let s=Date.now(),c=await T(this.secretKey,"POST",r,o,s),d=await this.fetchWithTimeout(`${this.baseUrl}${r}`,{method:"POST",headers:{"Content-Type":"application/json",Accept:"text/event-stream","x-hydra-signature":c,"x-hydra-timestamp":s.toString(),"x-hydra-key":this.keyPrefix},body:o},e.timeout??this.timeout);if(!d.ok){let p=await d.json();throw this.parseError(d.status,p)}let a=d.body?.getReader();if(!a)throw new w("Response body is not readable");let i=new TextDecoder,m="",y=[];for(;;){let{done:p,value:h}=await a.read();if(p)break;m+=i.decode(h,{stream:!0});let b=m.split(`
-`);m=b.pop()||"";let A="";for(let S of b){if(S.startsWith("event: ")){A=S.slice(7).trim();continue}if(S.startsWith("data: ")){let j=S.slice(6);if(j==="[DONE]")break;try{let l=JSON.parse(j);switch(A){case "start":this.debug&&this.log("Stream started",l);break;case "object":l.object!==void 0&&(y.push(l.object),t.onObject?.(l.object,l.index)),t.onChunk&&l.object&&t.onChunk(JSON.stringify(l.object));break;case "array_start":t.onArrayStart?.();break;case "complete":t.onComplete&&t.onComplete({objects:y,objectCount:l.objectCount,tokensUsed:l.tokensUsed,cached:l.cached});break;case "error":t.onError&&t.onError(new f(l.error||"Stream error",["STREAM_ERROR"]));break;default:l.chunk&&t.onChunk?.(l.chunk);}}catch{}A="";}}}}catch(s){if(t.onError)t.onError(s instanceof Error?s:new Error(String(s)));else throw s}}async listModels(){let t=await(await this.fetchWithTimeout(`${this.baseUrl}/api/v1/models`,{method:"GET",headers:{Accept:"application/json"}})).json();if(!t.success)throw new g(t.error?.message||"Failed to list models");return t.data}async listChains(){let t=await(await this.fetchWithTimeout(`${this.baseUrl}/api/v1/chains`,{method:"GET",credentials:"include",headers:{Accept:"application/json"}})).json();if(!t.success)throw new g(t.error?.message||"Failed to list chains");return t.data}async getUsage(e){let t=new URLSearchParams;e?.startDate&&t.set("startDate",e.startDate.toISOString()),e?.endDate&&t.set("endDate",e.endDate.toISOString());let r=`${this.baseUrl}/api/v1/usage${t.toString()?"?"+t:""}`,s=await(await this.fetchWithTimeout(r,{method:"GET",credentials:"include",headers:{Accept:"application/json"}})).json();if(!s.success)throw new g(s.error?.message||"Failed to get usage");return s.data}async health(){let e=Date.now();try{let t=await this.fetchWithTimeout(`${this.baseUrl}/api/health`,{method:"GET"},5e3),r=Date.now()-e,o=await t.json().catch(()=>({}));return {ok:t.ok,latencyMs:r,version:o.version}}catch{return {ok:false,latencyMs:Date.now()-e}}}withConfig(e){return new n({secretKey:this.secretKey,baseUrl:this.baseUrl,timeout:this.timeout,maxRetries:this.maxRetries,debug:this.debug,...e})}async registerWebhook(e){let t=await this.makeAuthenticatedRequest("/api/v1/webhooks","POST",JSON.stringify(e));if(!t.success||!t.data)throw new g(t.error?.message||"Failed to register webhook");return t.data}async unregisterWebhook(e){let t=await this.makeAuthenticatedRequest(`/api/v1/webhooks/${e}`,"DELETE","");if(!t.success||!t.data)throw new g(t.error?.message||"Failed to unregister webhook");return t.data}async listWebhooks(){let e=await this.makeAuthenticatedRequest("/api/v1/webhooks","GET","");if(!e.success)throw new g(e.error?.message||"Failed to list webhooks");return e.data||[]}async updateWebhook(e,t){let r=await this.makeAuthenticatedRequest(`/api/v1/webhooks/${e}`,"PATCH",JSON.stringify(t));if(!r.success||!r.data)throw new g(r.error?.message||"Failed to update webhook");return r.data}async healthDetailed(){return (await fetch(`${this.baseUrl}/api/v1/health/detailed`,{headers:{Accept:"application/json"}})).json()}async generateBatch(e,t,r={}){let o=await this.makeAuthenticatedRequest("/api/v1/generate/batch","POST",JSON.stringify({chainId:e,items:t,continueOnError:r.continueOnError??true}));if(!o.success||!o.data)throw new f(o.error?.message||"Batch generation failed",[]);return o.data}async makeAuthenticatedRequest(e,t,r,o){let s=Date.now(),c=await T(this.secretKey,t,e,r,s),d=await this.fetchWithTimeout(`${this.baseUrl}${e}`,{method:t,headers:{"Content-Type":"application/json",Accept:"application/json","x-hydra-signature":c,"x-hydra-timestamp":s.toString(),"x-hydra-key":this.keyPrefix},body:r},o??this.timeout),a=await d.json();if(!d.ok)throw this.parseError(d.status,a);return a}async fetchWithTimeout(e,t,r=this.timeout){let o=new AbortController,s=setTimeout(()=>o.abort(),r);try{return await fetch(e,{...t,signal:o.signal})}catch(c){throw c instanceof Error&&c.name==="AbortError"?new R(r):c instanceof Error?new w(c.message,c):new w(String(c))}finally{clearTimeout(s);}}parseError(e,t){let r=typeof t?.error=="string"?t.error:t?.error?.message||`HTTP ${e}`,o=t?.error?.code||"UNKNOWN";switch(e){case 401:return new x(r,e);case 429:let s=t?.retryAfterMs||6e4;return new E(r,s);case 500:case 502:case 503:case 504:return new g(r,e);default:return o==="CHAIN_FAILED"?new f(r,t?.error?.attemptedModels||[]):new u(r,o,{statusCode:e,retryable:e>=500})}}isRetryable(e){if(e instanceof u)return e.retryable;if(e instanceof Error){let t=e.message.toLowerCase();return t.includes("network")||t.includes("timeout")||e.name==="AbortError"}return  false}sleep(e){return new Promise(t=>setTimeout(t,e))}log(e,t){let r="[Hydra]";t?console.log(r,e,t):console.log(r,e);}};export{x as AuthenticationError,f as ChainExecutionError,k as ConfigurationError,I as FileProcessingError,D as Hydra,u as HydraError,M as InvalidSchemaError,w as NetworkError,v as QuotaExceededError,E as RateLimitError,g as ServerError,R as TimeoutError,P as ValidationError,O as WorkerError,T as generateSignature,U as getKeyPrefix,_ as isHydraError,q as isRetryableError,C as isValidSecretKey};
+var G=typeof process<"u"&&process.versions?.node;async function H(i,e,t,r,a){let{createHmac:s}=await import('crypto'),o=[e.toUpperCase(),t,a.toString(),r].join(`
+`);return s("sha256",i).update(o).digest("hex")}async function j(i,e,t,r,a){let s=new TextEncoder,o=[e.toUpperCase(),t,a.toString(),r].join(`
+`),d=await crypto.subtle.importKey("raw",s.encode(i),{name:"HMAC",hash:"SHA-256"},false,["sign"]),n=await crypto.subtle.sign("HMAC",d,s.encode(o));return Array.from(new Uint8Array(n)).map(c=>c.toString(16).padStart(2,"0")).join("")}async function A(i,e,t,r,a){return G?H(i,e,t,r,a):j(i,e,t,r,a)}function I(i){return i.slice(0,12)}function C(i){return typeof i=="string"&&i.startsWith("hyd_sk_")&&i.length>=20}var m=class extends Error{constructor(e,t,r){super(e),this.name="HydraError",this.code=t,this.retryable=r?.retryable??false,this.statusCode=r?.statusCode,this.originalError=r?.cause;}},w=class extends m{constructor(e){super(e,"CONFIGURATION_ERROR",{retryable:false}),this.name="ConfigurationError";}},S=class extends m{constructor(e,t){super(e,"AUTH_ERROR",{retryable:false,statusCode:t}),this.name="AuthenticationError";}},E=class extends m{constructor(e,t=6e4){super(e,"RATE_LIMITED",{retryable:true,statusCode:429}),this.name="RateLimitError",this.retryAfterMs=t;}},R=class extends m{constructor(e){super(`Request timed out after ${e}ms`,"TIMEOUT",{retryable:true}),this.name="TimeoutError",this.timeoutMs=e;}},k=class extends m{constructor(e,t){super(e,"NETWORK_ERROR",{retryable:true,cause:t}),this.name="NetworkError";}},b=class extends m{constructor(e,t=[]){super(e,"CHAIN_FAILED",{retryable:false}),this.name="ChainExecutionError",this.attemptedModels=t;}},U=class extends m{constructor(e,t=[]){super(e,"VALIDATION_ERROR",{retryable:false}),this.name="ValidationError",this.validationErrors=t;}},y=class extends m{constructor(e,t=500){super(e,"SERVER_ERROR",{retryable:true,statusCode:t}),this.name="ServerError";}},T=class extends m{constructor(e,t){super(e,"QUOTA_EXCEEDED",{retryable:false,statusCode:402}),this.name="QuotaExceededError",this.tier=t.tier,this.limit=t.limit,this.used=t.used;}},P=class extends m{constructor(e,t){super(e,"WORKER_ERROR",{retryable:true}),this.name="WorkerError",this.workerDurationMs=t;}},M=class extends m{constructor(e,t){super(e,"FILE_PROCESSING_ERROR",{retryable:false}),this.name="FileProcessingError",this.filename=t.filename,this.mimeType=t.mimeType,this.reason=t.reason;}},D=class extends m{constructor(e,t){super(e,"INVALID_SCHEMA",{retryable:false}),this.name="InvalidSchemaError",this.schemaPath=t;}};function N(i){return i instanceof m}function K(i){return N(i)?i.retryable:false}var F="http://localhost:3000",W=6e5,J=3,_=[1e3,2e3,5e3];function $(i){let e=i.trim(),t=e.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);t&&(e=t[1].trim());let r=e.indexOf("{"),a=e.indexOf("["),s;if(r===-1&&a===-1)return e;r===-1?s=a:a===-1?s=r:s=Math.min(r,a);let o=e[s],d=o==="{"?"}":"]",n=0,u=false,c=false,l=-1;for(let g=s;g<e.length;g++){let h=e[g];if(c){c=false;continue}if(h==="\\"&&u){c=true;continue}if(h==='"'&&!c){u=!u;continue}if(!u){if(h===o)n++;else if(h===d&&(n--,n===0)){l=g;break}}}if(l!==-1)return e.slice(s,l+1);let f=e.lastIndexOf(d);return f>s?e.slice(s,f+1):e}var O=class O{constructor(e){if(!e.secretKey)throw new w("secretKey is required");if(!C(e.secretKey))throw new w("Invalid secret key format. Expected format: hyd_sk_<key>");this.secretKey=e.secretKey,this.baseUrl=(e.baseUrl||F).replace(/\/$/,""),this.timeout=e.timeout??W,this.maxRetries=e.maxRetries??J,this.keyPrefix=I(e.secretKey),this.debug=e.debug??false,this.debug&&this.log("Initialized",{baseUrl:this.baseUrl,timeout:this.timeout});}async generate(e){if(this.shouldUseOptimizedFlow(e))try{return await this.generateOptimized(e)}catch(r){this.debug&&this.log("3-step generation failed, falling back to legacy",{error:r instanceof Error?r.message:String(r)});}else e.useOptimized!==false&&this.debug&&this.log("generate using legacy endpoint",{reason:this.getLegacyFallbackReason(e)});return this.generateLegacy(e)}shouldUseOptimizedFlow(e){return e.useOptimized===false?false:O.LEGACY_ONLY_OPTION_LABELS.every(([t])=>e[t]===void 0)}getLegacyFallbackReason(e){let t=O.LEGACY_ONLY_OPTION_LABELS.filter(([r])=>e[r]!==void 0).map(([,r])=>r);return t.length===0?"optimized flow disabled":t.join(", ")}async generateOptimized(e){let t=Date.now(),r="/api/v1/generate/token",a=JSON.stringify({chainId:e.chainId,prompt:e.prompt,systemPrompt:e.options?.systemPrompt,temperature:e.options?.temperature,maxTokens:e.options?.maxTokens,topP:e.options?.topP,topK:e.options?.topK,files:e.files}),s=await this.makeAuthenticatedRequest(r,"POST",a,void 0,e.signal);if(s.cached&&s.data)return this.debug&&this.log("generate cache hit (optimized)",{latencyMs:Date.now()-t}),{success:true,data:s.data,meta:{cached:true,modelUsed:s.meta?.modelUsed||"",tokensUsed:{input:0,output:0},latencyMs:Date.now()-t,attemptedModels:[]}};if(!s.token||!s.workerUrl)throw new b("Token generation failed - no token or worker URL returned",[]);let o=JSON.stringify({token:s.token,prompt:e.prompt,systemPrompt:e.options?.systemPrompt,timeout:e.timeout??this.timeout}),n=await(await this.fetchWithTimeout(s.workerUrl,{method:"POST",headers:{"Content-Type":"application/json"},body:o},e.timeout??this.timeout,e.signal)).json();if(!n.success||!n.content)return {success:false,data:{valid:[],invalid:[]},meta:{cached:false,modelUsed:n.modelId||"",tokensUsed:n.tokensUsed||{input:0,output:0},latencyMs:Date.now()-t,attemptedModels:[n.modelId||""]},error:{code:n.errorCode||"GENERATION_FAILED",message:n.errorMessage||"Generation failed",retryable:false}};let u=[],c=[],l=$(n.content);try{let g=JSON.parse(l);Array.isArray(g)?u=g:u=[g];}catch{u=[l];}n.completionToken&&this.cacheCompletionAsync({completionToken:n.completionToken,content:n.content,tokensUsed:n.tokensUsed||{input:0,output:0},finishReason:n.finishReason||"stop",chainId:e.chainId,modelUsed:n.modelId,prompt:e.prompt,systemPrompt:e.options?.systemPrompt,temperature:e.options?.temperature,maxTokens:e.options?.maxTokens,topP:e.options?.topP,topK:e.options?.topK}).catch(g=>{this.debug&&this.log("cacheCompletion failed (non-blocking)",{error:g});});let f=Date.now()-t;return this.debug&&this.log("generate success (optimized 3-step)",{latencyMs:f,modelUsed:n.modelId,tokensUsed:n.tokensUsed}),{success:true,data:{valid:u,invalid:c},meta:{cached:false,modelUsed:n.modelId,tokensUsed:n.tokensUsed||{input:0,output:0},latencyMs:f,attemptedModels:[n.modelId]}}}async cacheCompletionAsync(e){let t="/api/v1/generate/complete",r=JSON.stringify(e);await this.makeAuthenticatedRequest(t,"POST",r);}async generateLegacy(e){let t=Date.now(),r="/api/v1/generate",a=JSON.stringify({chainId:e.chainId,prompt:e.prompt,schema:e.schema,noCache:e.noCache,cacheScope:e.cacheScope,cacheQuality:e.cacheQuality,strictJson:e.strictJson,files:e.files,options:{...e.options,timeout:e.timeout??this.timeout}}),s=null,o=e.maxRetries??this.maxRetries;for(let u=0;u<=o;u++)try{let c=await this.makeAuthenticatedRequest(r,"POST",a,e.timeout,e.signal),l=Date.now()-t;return this.debug&&this.log("generate success (legacy)",{latencyMs:l,attempt:u+1}),c.meta&&(c.meta.latencyMs=l),c}catch(c){if(s=c instanceof Error?c:new Error(String(c)),this.debug&&this.log(`generate attempt ${u+1} failed`,{error:s.message}),!this.isRetryable(c)||u>=o)break;let l=_[Math.min(u,_.length-1)];c instanceof E&&c.retryAfterMs>l?await this.sleep(c.retryAfterMs):await this.sleep(l);}let d=Date.now()-t,n=s instanceof R;return {success:false,data:{valid:[],invalid:[]},meta:{cached:false,modelUsed:"",tokensUsed:{input:0,output:0},latencyMs:d,attemptedModels:[]},error:{code:n?"TIMEOUT":"REQUEST_FAILED",message:s?.message||"Request failed after all retries",retryable:false}}}async generateStream(e,t){let r="/api/v1/generate/stream",a=JSON.stringify({chainId:e.chainId,prompt:e.prompt,schema:e.schema,options:e.options});try{let s=Date.now(),o=await A(this.secretKey,"POST",r,a,s),d=await this.fetchWithTimeout(`${this.baseUrl}${r}`,{method:"POST",headers:{"Content-Type":"application/json",Accept:"text/event-stream","x-hydra-signature":o,"x-hydra-timestamp":s.toString(),"x-hydra-key":this.keyPrefix},body:a},e.timeout??this.timeout);if(!d.ok){let f=await d.json();throw this.parseError(d.status,f)}let n=d.body?.getReader();if(!n)throw new k("Response body is not readable");let u=new TextDecoder,c="",l=[];for(;;){let{done:f,value:g}=await n.read();if(f)break;c+=u.decode(g,{stream:!0});let h=c.split(`
+`);c=h.pop()||"";let v="";for(let x of h){if(x.startsWith("event: ")){v=x.slice(7).trim();continue}if(x.startsWith("data: ")){let q=x.slice(6);if(q==="[DONE]")break;try{let p=JSON.parse(q);switch(v){case "start":this.debug&&this.log("Stream started",p);break;case "object":p.object!==void 0&&(l.push(p.object),t.onObject?.(p.object,p.index)),t.onChunk&&p.object&&t.onChunk(JSON.stringify(p.object));break;case "array_start":t.onArrayStart?.();break;case "complete":t.onComplete&&t.onComplete({objects:l,objectCount:p.objectCount,tokensUsed:p.tokensUsed,cached:p.cached});break;case "error":t.onError&&t.onError(new b(p.error||"Stream error",["STREAM_ERROR"]));break;default:p.chunk&&t.onChunk?.(p.chunk);}}catch{}v="";}}}}catch(s){if(t.onError)t.onError(s instanceof Error?s:new Error(String(s)));else throw s}}async listModels(){let t=await(await this.fetchWithTimeout(`${this.baseUrl}/api/v1/models`,{method:"GET",headers:{Accept:"application/json"}})).json();if(!t.success)throw new y(t.error?.message||"Failed to list models");return t.data}async listChains(){let t=await(await this.fetchWithTimeout(`${this.baseUrl}/api/v1/chains`,{method:"GET",credentials:"include",headers:{Accept:"application/json"}})).json();if(!t.success)throw new y(t.error?.message||"Failed to list chains");return t.data}async getUsage(e){let t=new URLSearchParams;e?.startDate&&t.set("start",e.startDate.toISOString()),e?.endDate&&t.set("end",e.endDate.toISOString());let r=`${this.baseUrl}/api/v1/usage${t.toString()?"?"+t:""}`,s=await(await this.fetchWithTimeout(r,{method:"GET",credentials:"include",headers:{Accept:"application/json"}})).json();if(!s.success)throw new y(s.error?.message||"Failed to get usage");let o=s.data;if(!o)throw new y("Usage payload was empty");let d=o.cachedRequests??o.cachedResponses??0,n=o.totalTokensIn??o.totalTokens?.input??0,u=o.totalTokensOut??o.totalTokens?.output??0,c=o.averageLatencyMs??o.avgLatencyMs??0,l=s.meta?.dateRange??{start:e?.startDate?.toISOString()??"",end:e?.endDate?.toISOString()??""},f=o.byModel??[],g=Object.fromEntries(f.map(h=>[h.modelId,{requests:h.requests,tokensIn:h.tokensIn,tokensOut:h.tokensOut,tokens:{input:h.tokensIn,output:h.tokensOut,total:h.tokensIn+h.tokensOut}}]));return {totalRequests:o.totalRequests,successfulRequests:o.successfulRequests,failedRequests:o.failedRequests,cachedRequests:d,cachedResponses:d,totalTokensIn:n,totalTokensOut:u,totalTokens:{input:n,output:u,total:n+u},cacheHitRate:o.cacheHitRate,averageLatencyMs:c,avgLatencyMs:c,byModel:g,byModelList:f,byDay:o.byDay??[],dateRange:l,periodStart:l.start,periodEnd:l.end}}async health(){let e=Date.now();try{let t=await this.fetchWithTimeout(`${this.baseUrl}/api/v1/health`,{method:"GET"},5e3),r=Date.now()-e,a=await t.json().catch(()=>({}));return {ok:t.ok,latencyMs:r,version:a.version}}catch{return {ok:false,latencyMs:Date.now()-e}}}withConfig(e){return new O({secretKey:this.secretKey,baseUrl:this.baseUrl,timeout:this.timeout,maxRetries:this.maxRetries,debug:this.debug,...e})}async registerWebhook(e){let t=await this.makeAuthenticatedRequest("/api/v1/webhooks","POST",JSON.stringify(e));if(!t.success||!t.data)throw new y(t.error?.message||"Failed to register webhook");return t.data}async unregisterWebhook(e){let t=await this.makeAuthenticatedRequest(`/api/v1/webhooks/${e}`,"DELETE","");if(!t.success||!t.data)throw new y(t.error?.message||"Failed to unregister webhook");return t.data}async listWebhooks(){let e=await this.makeAuthenticatedRequest("/api/v1/webhooks","GET","");if(!e.success)throw new y(e.error?.message||"Failed to list webhooks");return e.data||[]}async updateWebhook(e,t){let r=await this.makeAuthenticatedRequest(`/api/v1/webhooks/${e}`,"PATCH",JSON.stringify(t));if(!r.success||!r.data)throw new y(r.error?.message||"Failed to update webhook");return r.data}async healthDetailed(){return this.makeAuthenticatedRequest("/api/v1/health/detailed","GET","")}async generateBatch(e,t,r={}){let a=await this.makeAuthenticatedRequest("/api/v1/generate/batch","POST",JSON.stringify({chainId:e,items:t,continueOnError:r.continueOnError??true}));if(!a.success||!a.data)throw new b(a.error?.message||"Batch generation failed",[]);return a.data}async makeAuthenticatedRequest(e,t,r,a,s){let o=Date.now(),d=t.toUpperCase(),n=await A(this.secretKey,d,e,r,o),u={method:d,headers:{"Content-Type":"application/json",Accept:"application/json","x-hydra-signature":n,"x-hydra-timestamp":o.toString(),"x-hydra-key":this.keyPrefix}};r.length>0&&d!=="GET"&&d!=="HEAD"&&(u.body=r);let c=await this.fetchWithTimeout(`${this.baseUrl}${e}`,u,a??this.timeout,s),l=await c.json();if(!c.ok)throw this.parseError(c.status,l);return l}async fetchWithTimeout(e,t,r=this.timeout,a){let s=new AbortController,o=setTimeout(()=>s.abort(),r),d=()=>s.abort();a&&(a.aborted?s.abort():a.addEventListener("abort",d,{once:true}));try{return await fetch(e,{...t,signal:s.signal})}catch(n){throw n instanceof Error&&n.name==="AbortError"?new R(r):n instanceof Error?new k(n.message,n):new k(String(n))}finally{clearTimeout(o),a?.removeEventListener("abort",d);}}parseError(e,t){let r=typeof t?.error=="string"?t.error:t?.error?.message||`HTTP ${e}`,a=t?.error?.code||"UNKNOWN",s=t?.meta||t;switch(e){case 401:return new S(r,e);case 429:if(s?.tier&&typeof s?.used=="number"&&typeof s?.limit=="number")return new T(r,{tier:s.tier,used:s.used,limit:s.limit});let o=t?.retryAfterMs||6e4;return new E(r,o);case 402:return new T(r,{tier:s?.tier||"UNKNOWN",used:s?.used||0,limit:s?.limit||0});case 500:case 502:case 503:case 504:return new y(r,e);default:return a==="CHAIN_FAILED"?new b(r,t?.error?.attemptedModels||[]):new m(r,a,{statusCode:e,retryable:e>=500})}}isRetryable(e){if(e instanceof m)return e.retryable;if(e instanceof Error){let t=e.message.toLowerCase();return t.includes("network")||t.includes("timeout")||e.name==="AbortError"}return  false}sleep(e){return new Promise(t=>setTimeout(t,e))}log(e,t){let r="[Hydra]";t?console.log(r,e,t):console.log(r,e);}};O.LEGACY_ONLY_OPTION_LABELS=[["schema","schema validation"],["noCache","cache bypass"],["cacheQuality","cache quality override"],["strictJson","strict JSON mode"],["cacheScope","cache scope override"],["maxRetries","per-request retries"]];var L=O;export{S as AuthenticationError,b as ChainExecutionError,w as ConfigurationError,M as FileProcessingError,L as Hydra,m as HydraError,D as InvalidSchemaError,k as NetworkError,T as QuotaExceededError,E as RateLimitError,y as ServerError,R as TimeoutError,U as ValidationError,P as WorkerError,A as generateSignature,I as getKeyPrefix,N as isHydraError,K as isRetryableError,C as isValidSecretKey};

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "hydra-aidirector",
-    "version": "1.6.0",
+    "version": "1.6.1",
     "description": "Official TypeScript SDK for Hydra - Intelligent AI API Gateway with automatic failover, caching, and JSON extraction",
     "main": "./dist/index.js",
     "module": "./dist/index.mjs",
@@ -29,12 +29,12 @@
         "lint": "tsc --noEmit",
         "test": "vitest run",
         "test:watch": "vitest",
-        "prepublishOnly": "npm run build",
+        "prepublishOnly": "bun run build",
         "clean": "rimraf dist",
-        "publish:check": "npm pack --dry-run",
-        "release": "npm run build && npm publish --access public",
+        "publish:check": "bun publish --dry-run",
+        "release": "bun run build && bun publish --access public",
         "release:dual": "node scripts/publish-dual.js",
-        "release:beta": "npm run build && npm publish --tag beta"
+        "release:beta": "bun run build && bun publish --access public --tag beta"
     },
     "keywords": [
         "ai",