@ancatag/n-r 0.1.0

package/README.md

@@ -0,0 +1,285 @@
+# Nova-route AI SDK (n-r)
+
+Official Node.js/TypeScript SDK for Nova-route AI API. OpenAI-compatible interface for chat completions and model management.
+
+## Installation
+
+### From npm (when published)
+```bash
+npm install @ancatag/n-r
+# or
+pnpm add @ancatag/n-r
+# or
+yarn add @ancatag/n-r
+```
+
+### Local Development (for OpenChat)
+
+For local development and testing within the Nova monorepo or OpenChat app:
+
+```bash
+# In Nova repo
+cd packages/sdk
+pnpm build
+
+# Link the package
+pnpm link --global
+
+# In OpenChat repo (or any project)
+pnpm link --global @ancatag/n-r
+```
+
+Or use pnpm workspace (if both repos are in a workspace):
+```bash
+# In OpenChat package.json, add:
+{
+  "dependencies": {
+    "@ancatag/n-r": "workspace:*"
+  }
+}
+```
+
+### Using from OpenChat (local)
+
+- Point the SDK to your local Nova API: `baseUrl: 'http://localhost:3000'` (REST) or `grpcUrl: '0.0.0.0:50051'` with `transport: 'grpc'`.
+- Use a Nova-route API key (`nova_sk_...`) scoped to the project/model configs you need.
+- Prefer workspace linking (above) or `pnpm link --global @ancatag/n-r` while developing both repos.
+
+
+## Quick Start
+
+```typescript
+import { NovaClient } from '@ancatag/n-r';
+
+// Initialize client with API key from Nova-route UI
+const client = new NovaClient({
+  apiKey: process.env.NOVA_API_KEY || 'nova_sk_...', // from env
+  transport: process.env.NOVA_TRANSPORT || 'rest',
+  timeoutMs: 60000, // Optional, defaults to 60s
+});
+
+// Non-streaming chat completion
+const response = await client.chat.create({
+  model: 'llama2',
+  messages: [
+    { role: 'system', content: 'You are a helpful assistant.' },
+    { role: 'user', content: 'Hello!' }
+  ],
+  temperature: 0.7,
+  max_tokens: 1000,
+});
+
+console.log(response.choices[0].message.content);
+console.log('Tokens used:', response.usage.total_tokens);
+console.log('Cache hit:', response.nova?.cacheHit);
+```
+
+## Streaming
+
+```typescript
+// Streaming chat completion
+const stream = client.chat.createStream({
+  model: 'llama2',
+  messages: [{ role: 'user', content: 'Tell me a story' }],
+  temperature: 0.7,
+});
+
+let fullContent = '';
+for await (const chunk of stream) {
+  const content = chunk.choices[0]?.delta?.content || '';
+  if (content) {
+    process.stdout.write(content); // Print as it arrives
+    fullContent += content;
+  }
+  
+  // Check if stream is complete
+  if (chunk.choices[0]?.finish_reason) {
+    console.log('\n\nStream complete!');
+    break;
+  }
+}
+```
+
+## Cancellation
+
+```typescript
+const controller = new AbortController();
+
+// Cancel after 5 seconds
+setTimeout(() => controller.abort(), 5000);
+
+try {
+  for await (const chunk of client.chat.createStream(
+    {
+      model: 'llama2',
+      messages: [{ role: 'user', content: 'Hello' }],
+    },
+    controller.signal
+  )) {
+    console.log(chunk.choices[0]?.delta?.content || '');
+  }
+} catch (error) {
+  if (error.name === 'AbortError') {
+    console.log('Stream cancelled');
+  }
+}
+```
+
+## Models API
+
+```typescript
+// List all available models
+const models = await client.models.list();
+console.log('Available models:', models.map(m => m.id));
+
+// Get specific model details
+const model = await client.models.get('llama2');
+console.log('Model:', model);
+```
+
+## Error Handling
+
+```typescript
+import { NovaClient, NovaError } from '@nova-route/sdk';
+
+const client = new NovaClient({
+  apiKey: 'nova_sk_...',
+});
+
+try {
+  const response = await client.chat.create({
+    model: 'invalid-model',
+    messages: [{ role: 'user', content: 'Hello' }],
+  });
+} catch (error) {
+  if (error instanceof NovaError) {
+    console.error('Nova API Error:', error.message);
+    console.error('Status:', error.status);
+    console.error('Code:', error.code);
+    console.error('Type:', error.type);
+  } else {
+    console.error('Unexpected error:', error);
+  }
+}
+```
+
+## Nova-Specific Features
+
+Nova extends the OpenAI API with additional features:
+
+```typescript
+const response = await client.chat.create({
+  model: 'llama2',
+  messages: [{ role: 'user', content: 'Hello' }],
+  
+  // Nova-route-specific options
+  nova: {
+    skipCache: false, // Skip cache for this request
+    modelConfigId: 'uuid', // Use specific model config
+    ragEnabled: true, // Enable RAG (if configured)
+    metadata: { userId: '123' }, // Custom metadata
+    systemPromptOverride: 'Custom system prompt', // Override system prompt
+  },
+});
+
+// Response includes Nova extensions
+console.log('Cache hit:', response.nova?.cacheHit);
+console.log('Cache layer:', response.nova?.cacheLayer); // 'hot' | 'semantic' | null
+console.log('Tokens saved:', response.nova?.tokensSaved);
+console.log('Response time:', response.nova?.responseTimeMs, 'ms');
+console.log('Request ID:', response.nova?.requestId);
+```
+
+## Configuration
+
+```typescript
+const client = new NovaClient({
+  apiKey: 'nova_sk_...', // Required: Get from Nova-route dashboard
+  
+  baseUrl: 'https://api.nova.ai', // Optional: Defaults to http://localhost:3000
+  timeoutMs: 120000, // Optional: Request timeout in ms (default: 60000)
+  maxRetries: 3, // Optional: Max retries for failed requests (default: 2)
+});
+```
+
+## API Key Setup
+
+1. Log in to Nova-route dashboard (http://localhost:3001)
+2. Navigate to API Keys section
+3. Create a new API key
+4. Copy the key (format: `nova_sk_...`)
+5. Use it in your SDK initialization
+
+## TypeScript Support
+
+Full TypeScript support with exported types:
+
+```typescript
+import type {
+  ChatMessage,
+  ChatCompletionRequest,
+  ChatCompletionResponse,
+  ChatCompletionChunk,
+  Model,
+  NovaClientConfig,
+} from '@nova-route/sdk';
+```
+
+## Requirements
+
+- Node.js 18+ (uses native `fetch`)
+- TypeScript 5.0+ (for type definitions)
+
+## License
+
+ISC
+
+
+
+
+
+## gRPC Transport
+
+Use the gRPC path for lower overhead (ts-proto stubs).
+```typescript
+import { NovaClient } from '@nova-route/sdk';
+
+const client = new NovaClient({
+  apiKey: process.env.NOVA_API_KEY || 'nova_sk_...',
+  transport: 'grpc',
+});
+
+const res = await client.chat.create({
+  model: 'llama2',
+  messages: [{ role: 'user', content: 'Hello' }],
+});
+console.log(res.choices[0].message.content);
+```
+
+Streaming works the same via `createStream`.
+
+```typescript
+for await (const chunk of client.chat.createStream({
+  model: 'llama2',
+  messages: [{ role: 'user', content: 'Hey' }],
+})) {
+  process.stdout.write(chunk.choices[0]?.delta?.content || '');
+}
+```
+
+Transport options:
+- `transport: 'rest'` (default) uses HTTP fetch.
+- `transport: 'grpc'` uses gRPC over grpc-js with ts-proto stubs.
+- `grpcUrl` defaults to `0.0.0.0:50051`.
+
+## Publishing to npm
+
+- Set env (recommended):
+  - `NOVA_API_KEY` (if needed for examples/tests)
+  - `NOVA_BASE_URL` (REST), `NOVA_GRPC_URL` (gRPC)
+- Build & publish:
+  ```bash
+  pnpm install
+  pnpm publish:npm  # runs prepublishOnly -> build, then npm publish --access public
+  ```
+- Ensure `npmrc` has an auth token with publish rights.

package/dist/chat.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Chat Completions API
+ * Handles chat completion requests (streaming and non-streaming)
+ */
+import { HttpClient } from './http-client.js';
+import { GrpcClient } from './grpc-client.js';
+import type { ChatCompletionRequest, ChatCompletionResponse, ChatCompletionChunk } from './types.js';
+export declare class ChatCompletions {
+    private readonly httpClient;
+    private readonly grpcClient?;
+    constructor(httpClient: HttpClient, grpcClient?: GrpcClient | undefined);
+    private isGrpc;
+    /**
+     * Create a chat completion (non-streaming)
+     */
+    create(request: ChatCompletionRequest): Promise<ChatCompletionResponse>;
+    /**
+     * Create a streaming chat completion
+     * Returns an async iterator over chunks
+     */
+    createStream(request: ChatCompletionRequest, signal?: AbortSignal): AsyncGenerator<ChatCompletionChunk, void, unknown>;
+}
+//# sourceMappingURL=chat.d.ts.map

package/dist/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../src/chat.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EACX,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,MAAM,YAAY,CAAC;AAEpB,qBAAa,eAAe;IAE1B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;gBADX,UAAU,EAAE,UAAU,EACtB,UAAU,CAAC,EAAE,UAAU,YAAA;IAGzC,OAAO,CAAC,MAAM;IAId;;OAEG;IACG,MAAM,CACX,OAAO,EAAE,qBAAqB,GAC5B,OAAO,CAAC,sBAAsB,CAAC;IAgBlC;;;OAGG;IACI,YAAY,CAClB,OAAO,EAAE,qBAAqB,EAC9B,MAAM,CAAC,EAAE,WAAW,GAClB,cAAc,CAAC,mBAAmB,EAAE,IAAI,EAAE,OAAO,CAAC;CAuDrD"}

package/dist/chat.js

@@ -0,0 +1,80 @@
+/**
+ * Chat Completions API
+ * Handles chat completion requests (streaming and non-streaming)
+ */
+export class ChatCompletions {
+    httpClient;
+    grpcClient;
+    constructor(httpClient, grpcClient) {
+        this.httpClient = httpClient;
+        this.grpcClient = grpcClient;
+    }
+    isGrpc() {
+        return Boolean(this.grpcClient);
+    }
+    /**
+     * Create a chat completion (non-streaming)
+     */
+    async create(request) {
+        if (this.isGrpc() && this.grpcClient) {
+            return this.grpcClient.createChatCompletion(request);
+        }
+        const payload = {
+            ...request,
+            stream: false,
+        };
+        return this.httpClient.post('v1/chat/completions', payload);
+    }
+    /**
+     * Create a streaming chat completion
+     * Returns an async iterator over chunks
+     */
+    async *createStream(request, signal) {
+        if (this.isGrpc() && this.grpcClient) {
+            for await (const chunk of this.grpcClient.createChatCompletionStream(request)) {
+                yield chunk;
+            }
+            return;
+        }
+        const payload = {
+            ...request,
+            stream: true,
+        };
+        const stream = await this.httpClient.postStream('v1/chat/completions', payload, signal);
+        const reader = stream.getReader();
+        const decoder = new TextDecoder();
+        let buffer = '';
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                const lines = buffer.split('\n');
+                buffer = lines.pop() || '';
+                for (const line of lines) {
+                    const trimmed = line.trim();
+                    if (!trimmed || trimmed === 'data: [DONE]') {
+                        continue;
+                    }
+                    if (!trimmed.startsWith('data: ')) {
+                        continue;
+                    }
+                    try {
+                        const jsonStr = trimmed.slice(6); // Remove 'data: ' prefix
+                        const chunk = JSON.parse(jsonStr);
+                        yield chunk;
+                    }
+                    catch (parseError) {
+                        // Skip malformed JSON chunks
+                        continue;
+                    }
+                }
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+}
+//# sourceMappingURL=chat.js.map

package/dist/chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../src/chat.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,MAAM,OAAO,eAAe;IAET;IACA;IAFlB,YACkB,UAAsB,EACtB,UAAuB;QADvB,eAAU,GAAV,UAAU,CAAY;QACtB,eAAU,GAAV,UAAU,CAAa;IACtC,CAAC;IAEI,MAAM;QACb,OAAO,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACX,OAA8B;QAE9B,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC,UAAU,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACtD,CAAC;QAED,MAAM,OAAO,GAA0B;YACtC,GAAG,OAAO;YACV,MAAM,EAAE,KAAK;SACb,CAAC;QAEF,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAC1B,qBAAqB,EACrB,OAAO,CACP,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,CAAC,YAAY,CAClB,OAA8B,EAC9B,MAAoB;QAEpB,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACtC,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,0BAA0B,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/E,MAAM,KAAK,CAAC;YACb,CAAC;YACD,OAAO;QACR,CAAC;QAED,MAAM,OAAO,GAA0B;YACtC,GAAG,OAAO;YACV,MAAM,EAAE,IAAI;SACZ,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,CAC9C,qBAAqB,EACrB,OAAO,EACP,MAAM,CACN,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;QAClC,IAAI,MAAM,GAAG,EAAE,CAAC;QAEhB,IAAI,CAAC;YACJ,OAAO,IAAI,EAAE,CAAC;gBACb,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC5C,IAAI,IAAI;oBAAE,MAAM;gBAEhB,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBAClD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACjC,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;gBAE3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;oBAC5B,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,cAAc,EAAE,CAAC;wBAC5C,SAAS;oBACV,CAAC;oBACD,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;wBACnC,SAAS;oBACV,CAAC;oBAED,IAAI,CAAC;wBACJ,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,yBAAyB;wBAC3D,MAAM,KAAK,GAAwB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;wBACvD,MAAM,KAAK,CAAC;oBACb,CAAC;oBAAC,OAAO,UAAU,EAAE,CAAC;wBACrB,6BAA6B;wBAC7B,SAAS;oBACV,CAAC;gBACF,CAAC;YACF,CAAC;QACF,CAAC;gBAAS,CAAC;YACV,MAAM,CAAC,WAAW,EAAE,CAAC;QACtB,CAAC;IACF,CAAC;CACD"}

package/dist/client.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Nova Client
+ * Main client class for interacting with Nova AI API
+ */
+import { ChatCompletions } from './chat.js';
+import { Models } from './models.js';
+import type { NovaClientConfig } from './types.js';
+export declare class NovaClient {
+    readonly chat: ChatCompletions;
+    readonly models: Models;
+    private readonly httpClient;
+    private readonly grpcClient?;
+    constructor(config: NovaClientConfig);
+    private shouldUseGrpc;
+    /**
+     * Get the API key (masked for security)
+     */
+    getApiKey(): string;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,KAAK,EAAE,gBAAgB,EAAiB,MAAM,YAAY,CAAC;AAElE,qBAAa,UAAU;IACtB,SAAgB,IAAI,EAAE,eAAe,CAAC;IACtC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAa;gBAE7B,MAAM,EAAE,gBAAgB;IASpC,OAAO,CAAC,aAAa;IAIrB;;OAEG;IACH,SAAS,IAAI,MAAM;CAMnB"}

package/dist/client.js

@@ -0,0 +1,36 @@
+/**
+ * Nova Client
+ * Main client class for interacting with Nova AI API
+ */
+import { HttpClient } from './http-client.js';
+import { ChatCompletions } from './chat.js';
+import { Models } from './models.js';
+import { GrpcClient } from './grpc-client.js';
+export class NovaClient {
+    chat;
+    models;
+    httpClient;
+    grpcClient;
+    constructor(config) {
+        this.httpClient = new HttpClient(config);
+        if (this.shouldUseGrpc(config.transport)) {
+            this.grpcClient = new GrpcClient(config);
+        }
+        this.chat = new ChatCompletions(this.httpClient, this.grpcClient);
+        this.models = new Models(this.httpClient, this.grpcClient);
+    }
+    shouldUseGrpc(transport) {
+        return transport === 'grpc';
+    }
+    /**
+     * Get the API key (masked for security)
+     */
+    getApiKey() {
+        // Access private field via type assertion for display purposes only
+        const key = this.httpClient.apiKey;
+        if (key.length <= 12)
+            return key;
+        return `${key.slice(0, 8)}...${key.slice(-4)}`;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,MAAM,OAAO,UAAU;IACN,IAAI,CAAkB;IACtB,MAAM,CAAS;IACd,UAAU,CAAa;IACvB,UAAU,CAAc;IAEzC,YAAY,MAAwB;QACnC,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1C,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;QAC1C,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAClE,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC5D,CAAC;IAEO,aAAa,CAAC,SAAyB;QAC9C,OAAO,SAAS,KAAK,MAAM,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,SAAS;QACR,oEAAoE;QACpE,MAAM,GAAG,GAAI,IAAI,CAAC,UAAkB,CAAC,MAAgB,CAAC;QACtD,IAAI,GAAG,CAAC,MAAM,IAAI,EAAE;YAAE,OAAO,GAAG,CAAC;QACjC,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChD,CAAC;CACD"}

package/dist/grpc-client.d.ts

@@ -0,0 +1,16 @@
+/**
+ * gRPC Client (stub implementation)
+ *
+ * This is a placeholder for gRPC functionality.
+ * OpenChat uses REST transport only, so this is not implemented.
+ *
+ * To implement gRPC support, this would use @grpc/grpc-js and @nova-ai/proto
+ */
+import type { ChatCompletionRequest, ChatCompletionResponse, ChatCompletionChunk, Model, NovaClientConfig } from './types.js';
+export declare class GrpcClient {
+    constructor(config: NovaClientConfig);
+    createChatCompletion(request: ChatCompletionRequest): Promise<ChatCompletionResponse>;
+    createChatCompletionStream(request: ChatCompletionRequest): AsyncGenerator<ChatCompletionChunk, void, unknown>;
+    listModels(): Promise<Model[]>;
+}
+//# sourceMappingURL=grpc-client.d.ts.map

package/dist/grpc-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grpc-client.d.ts","sourceRoot":"","sources":["../src/grpc-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACX,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,EACL,gBAAgB,EAChB,MAAM,YAAY,CAAC;AAEpB,qBAAa,UAAU;gBACV,MAAM,EAAE,gBAAgB;IAO9B,oBAAoB,CACzB,OAAO,EAAE,qBAAqB,GAC5B,OAAO,CAAC,sBAAsB,CAAC;IAI3B,0BAA0B,CAChC,OAAO,EAAE,qBAAqB,GAC5B,cAAc,CAAC,mBAAmB,EAAE,IAAI,EAAE,OAAO,CAAC;IAI/C,UAAU,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;CAGpC"}

package/dist/grpc-client.js

@@ -0,0 +1,24 @@
+/**
+ * gRPC Client (stub implementation)
+ *
+ * This is a placeholder for gRPC functionality.
+ * OpenChat uses REST transport only, so this is not implemented.
+ *
+ * To implement gRPC support, this would use @grpc/grpc-js and @nova-ai/proto
+ */
+export class GrpcClient {
+    constructor(config) {
+        // Stub implementation - gRPC not used by OpenChat
+        throw new Error('gRPC transport is not implemented. Use transport: "rest" instead.');
+    }
+    async createChatCompletion(request) {
+        throw new Error('gRPC not implemented');
+    }
+    async *createChatCompletionStream(request) {
+        throw new Error('gRPC not implemented');
+    }
+    async listModels() {
+        throw new Error('gRPC not implemented');
+    }
+}
+//# sourceMappingURL=grpc-client.js.map

package/dist/grpc-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grpc-client.js","sourceRoot":"","sources":["../src/grpc-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,MAAM,OAAO,UAAU;IACtB,YAAY,MAAwB;QACnC,kDAAkD;QAClD,MAAM,IAAI,KAAK,CACd,mEAAmE,CACnE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,oBAAoB,CACzB,OAA8B;QAE9B,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,CAAC,0BAA0B,CAChC,OAA8B;QAE9B,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,UAAU;QACf,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACzC,CAAC;CACD"}

package/dist/http-client.d.ts

@@ -0,0 +1,33 @@
+/**
+ * HTTP Client for Nova API
+ * Handles authentication, retries, timeouts, and error handling
+ */
+import type { NovaClientConfig } from './types.js';
+export declare class HttpClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly timeoutMs;
+    private readonly maxRetries;
+    constructor(config: NovaClientConfig);
+    /**
+     * Make a GET request
+     */
+    get<T>(path: string): Promise<T>;
+    /**
+     * Make a POST request
+     */
+    post<T>(path: string, body?: unknown): Promise<T>;
+    /**
+     * Make a streaming POST request (returns ReadableStream)
+     */
+    postStream(path: string, body?: unknown, signal?: AbortSignal): Promise<ReadableStream<Uint8Array>>;
+    /**
+     * Make an HTTP request with retries
+     */
+    private request;
+    /**
+     * Parse error response from API
+     */
+    private parseError;
+}
+//# sourceMappingURL=http-client.d.ts.map

package/dist/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../src/http-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGnD,qBAAa,UAAU;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,MAAM,EAAE,gBAAgB;IAiBpC;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAItC;;OAEG;IACG,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIvD;;OAEG;IACG,UAAU,CACf,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAkDtC;;OAEG;YACW,OAAO;IAqErB;;OAEG;YACW,UAAU;CA6BxB"}

package/dist/http-client.js

@@ -0,0 +1,153 @@
+/**
+ * HTTP Client for Nova API
+ * Handles authentication, retries, timeouts, and error handling
+ */
+import { NovaError } from './types.js';
+export class HttpClient {
+    apiKey;
+    baseUrl;
+    timeoutMs;
+    maxRetries;
+    constructor(config) {
+        if (!config.apiKey) {
+            throw new NovaError('API key is required');
+        }
+        if (!config.apiKey.startsWith('nova_sk_')) {
+            throw new NovaError('Invalid API key format. Expected format: nova_sk_...');
+        }
+        this.apiKey = config.apiKey;
+        const envBase = (typeof process !== 'undefined') ? process.env.NOVA_BASE_URL : undefined;
+        const configBase = config.baseUrl;
+        const fallback = 'http://localhost:3000';
+        this.baseUrl = (configBase || envBase || fallback).replace(/\/$/, '');
+        this.timeoutMs = config.timeoutMs || 60000;
+        this.maxRetries = config.maxRetries ?? 2;
+    }
+    /**
+     * Make a GET request
+     */
+    async get(path) {
+        return this.request('GET', path);
+    }
+    /**
+     * Make a POST request
+     */
+    async post(path, body) {
+        return this.request('POST', path, body);
+    }
+    /**
+     * Make a streaming POST request (returns ReadableStream)
+     */
+    async postStream(path, body, signal) {
+        const url = `${this.baseUrl}/${path}`;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);
+        // Combine abort signals
+        if (signal) {
+            signal.addEventListener('abort', () => controller.abort());
+        }
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${this.apiKey}`,
+                    'User-Agent': '@ancatag/n-r',
+                },
+                body: body ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                const error = await this.parseError(response);
+                throw error;
+            }
+            if (!response.body) {
+                throw new NovaError('No response body');
+            }
+            return response.body;
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error instanceof NovaError) {
+                throw error;
+            }
+            if (error.name === 'AbortError') {
+                throw new NovaError('Request timeout', 408, 'timeout');
+            }
+            throw new NovaError(error.message || 'Network error', 0, 'network_error');
+        }
+    }
+    /**
+     * Make an HTTP request with retries
+     */
+    async request(method, path, body, retryCount = 0) {
+        const url = `${this.baseUrl}/${path}`;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const response = await fetch(url, {
+                method,
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${this.apiKey}`,
+                    'User-Agent': '@ancatag/n-r',
+                },
+                body: body ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                const error = await this.parseError(response);
+                // Retry on server errors (5xx) or rate limits (429)
+                if ((error.status && error.status >= 500) ||
+                    error.status === 429) {
+                    if (retryCount < this.maxRetries) {
+                        // Exponential backoff: 1s, 2s, 4s
+                        const delay = Math.pow(2, retryCount) * 1000;
+                        await new Promise((resolve) => setTimeout(resolve, delay));
+                        return this.request(method, path, body, retryCount + 1);
+                    }
+                }
+                throw error;
+            }
+            const data = await response.json();
+            return data;
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error instanceof NovaError) {
+                throw error;
+            }
+            if (error.name === 'AbortError') {
+                throw new NovaError('Request timeout', 408, 'timeout');
+            }
+            // Retry on network errors
+            if (retryCount < this.maxRetries && method === 'GET') {
+                const delay = Math.pow(2, retryCount) * 1000;
+                await new Promise((resolve) => setTimeout(resolve, delay));
+                return this.request(method, path, body, retryCount + 1);
+            }
+            throw new NovaError(error.message || 'Network error', 0, 'network_error');
+        }
+    }
+    /**
+     * Parse error response from API
+     */
+    async parseError(response) {
+        let errorData;
+        try {
+            errorData = await response.json();
+        }
+        catch {
+            // If response is not JSON, use status text
+            return new NovaError(response.statusText || `HTTP ${response.status}`, response.status, 'http_error');
+        }
+        // Handle OpenAI-compatible error format
+        if (errorData.error) {
+            return new NovaError(errorData.error.message || 'API error', response.status, errorData.error.code, errorData.error.type);
+        }
+        return new NovaError(errorData.message || `HTTP ${response.status}`, response.status, 'http_error');
+    }
+}
+//# sourceMappingURL=http-client.js.map

package/dist/http-client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Nova AI SDK
+ * Official Node.js/TypeScript SDK for Nova AI API
+ *
+ * @example
+ * ```typescript
+ * import { NovaClient } from '@ancatag/n-r';
+ *
+ * const client = new NovaClient({
+ *   apiKey: 'nova_sk_...',
+ *   baseUrl: 'http://localhost:3000', // optional
+ * });
+ *
+ * // Non-streaming
+ * const response = await client.chat.create({
+ *   model: 'llama2',
+ *   messages: [{ role: 'user', content: 'Hello!' }],
+ * });
+ *
+ * // Streaming
+ * for await (const chunk of client.chat.createStream({
+ *   model: 'llama2',
+ *   messages: [{ role: 'user', content: 'Hello!' }],
+ * })) {
+ *   console.log(chunk.choices[0]?.delta?.content || '');
+ * }
+ * ```
+ */
+export { NovaClient } from './client.js';
+export { ChatCompletions } from './chat.js';
+export { Models } from './models.js';
+export { HttpClient } from './http-client.js';
+export { GrpcClient } from './grpc-client.js';
+export { NovaError } from './types.js';
+export type { ChatMessage, ChatCompletionRequest, ChatCompletionResponse, ChatCompletionChunk, ChatCompletionChoice, ChatCompletionUsage, ChatCompletionChunkChoice, ChatCompletionError, Model, NovaClientConfig, NovaTransport, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,YAAY,EACX,WAAW,EACX,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,EACzB,mBAAmB,EACnB,KAAK,EACL,gBAAgB,EAChB,aAAa,GACb,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,35 @@
+/**
+ * Nova AI SDK
+ * Official Node.js/TypeScript SDK for Nova AI API
+ *
+ * @example
+ * ```typescript
+ * import { NovaClient } from '@ancatag/n-r';
+ *
+ * const client = new NovaClient({
+ *   apiKey: 'nova_sk_...',
+ *   baseUrl: 'http://localhost:3000', // optional
+ * });
+ *
+ * // Non-streaming
+ * const response = await client.chat.create({
+ *   model: 'llama2',
+ *   messages: [{ role: 'user', content: 'Hello!' }],
+ * });
+ *
+ * // Streaming
+ * for await (const chunk of client.chat.createStream({
+ *   model: 'llama2',
+ *   messages: [{ role: 'user', content: 'Hello!' }],
+ * })) {
+ *   console.log(chunk.choices[0]?.delta?.content || '');
+ * }
+ * ```
+ */
+export { NovaClient } from './client.js';
+export { ChatCompletions } from './chat.js';
+export { Models } from './models.js';
+export { HttpClient } from './http-client.js';
+export { GrpcClient } from './grpc-client.js';
+export { NovaError } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/models.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Models API
+ * Handles model listing and retrieval
+ */
+import { HttpClient } from './http-client.js';
+import { GrpcClient } from './grpc-client.js';
+import type { Model } from './types.js';
+export declare class Models {
+    private readonly httpClient;
+    private readonly grpcClient?;
+    constructor(httpClient: HttpClient, grpcClient?: GrpcClient | undefined);
+    private isGrpc;
+    /**
+     * List all available models for the API key
+     */
+    list(): Promise<Model[]>;
+    /**
+     * Get a specific model by ID
+     */
+    get(modelId: string): Promise<Model>;
+}
+//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,qBAAa,MAAM;IAEjB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;gBADX,UAAU,EAAE,UAAU,EACtB,UAAU,CAAC,EAAE,UAAU,YAAA;IAGzC,OAAO,CAAC,MAAM;IAId;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAW9B;;OAEG;IACG,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;CAM1C"}

package/dist/models.js

@@ -0,0 +1,33 @@
+/**
+ * Models API
+ * Handles model listing and retrieval
+ */
+export class Models {
+    httpClient;
+    grpcClient;
+    constructor(httpClient, grpcClient) {
+        this.httpClient = httpClient;
+        this.grpcClient = grpcClient;
+    }
+    isGrpc() {
+        return Boolean(this.grpcClient);
+    }
+    /**
+     * List all available models for the API key
+     */
+    async list() {
+        if (this.isGrpc() && this.grpcClient) {
+            return this.grpcClient.listModels();
+        }
+        const response = await this.httpClient.get('v1/models');
+        return response.data || [];
+    }
+    /**
+     * Get a specific model by ID
+     */
+    async get(modelId) {
+        const response = await this.httpClient.get(`v1/models/${modelId}`);
+        return response;
+    }
+}
+//# sourceMappingURL=models.js.map

package/dist/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,OAAO,MAAM;IAEA;IACA;IAFlB,YACkB,UAAsB,EACtB,UAAuB;QADvB,eAAU,GAAV,UAAU,CAAY;QACtB,eAAU,GAAV,UAAU,CAAa;IACtC,CAAC;IAEI,MAAM;QACb,OAAO,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACT,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;QACrC,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CACzC,WAAW,CACX,CAAC;QACF,OAAO,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,OAAe;QACxB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CACzC,aAAa,OAAO,EAAE,CACtB,CAAC;QACF,OAAO,QAAQ,CAAC;IACjB,CAAC;CACD"}

package/dist/types.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Nova SDK Types
+ * OpenAI-compatible types for Nova AI API
+ */
+export type NovaTransport = 'rest' | 'grpc';
+/**
+ * Chat message format (OpenAI-compatible)
+ */
+export interface ChatMessage {
+    role: 'system' | 'user' | 'assistant' | 'function';
+    content: string;
+    name?: string;
+    function_call?: {
+        name: string;
+        arguments: string;
+    };
+}
+/**
+ * Chat completion request (OpenAI-compatible)
+ */
+export interface ChatCompletionRequest {
+    model: string;
+    messages: ChatMessage[];
+    temperature?: number;
+    top_p?: number;
+    n?: number;
+    stream?: boolean;
+    stop?: string | string[];
+    max_tokens?: number;
+    presence_penalty?: number;
+    frequency_penalty?: number;
+    logit_bias?: Record<string, number>;
+    user?: string;
+    nova?: {
+        skipCache?: boolean;
+        modelConfigId?: string;
+        ragEnabled?: boolean;
+        metadata?: Record<string, any>;
+        systemPromptOverride?: string;
+    };
+}
+/**
+ * Chat completion response (OpenAI-compatible)
+ */
+export interface ChatCompletionResponse {
+    id: string;
+    object: 'chat.completion';
+    created: number;
+    model: string;
+    choices: ChatCompletionChoice[];
+    usage: ChatCompletionUsage;
+    nova?: {
+        cacheHit: boolean;
+        cacheLayer?: 'hot' | 'semantic' | null;
+        tokensSaved: number;
+        responseTimeMs: number;
+        requestId: string;
+    };
+}
+export interface ChatCompletionChoice {
+    index: number;
+    message: {
+        role: 'assistant';
+        content: string;
+        function_call?: {
+            name: string;
+            arguments: string;
+        };
+    };
+    finish_reason: 'stop' | 'length' | 'function_call' | 'content_filter' | null;
+}
+export interface ChatCompletionUsage {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+}
+/**
+ * Streaming response chunk (OpenAI-compatible)
+ */
+export interface ChatCompletionChunk {
+    id: string;
+    object: 'chat.completion.chunk';
+    created: number;
+    model: string;
+    choices: ChatCompletionChunkChoice[];
+}
+export interface ChatCompletionChunkChoice {
+    index: number;
+    delta: {
+        role?: 'assistant';
+        content?: string;
+        function_call?: {
+            name?: string;
+            arguments?: string;
+        };
+    };
+    finish_reason: 'stop' | 'length' | 'function_call' | 'content_filter' | null;
+}
+/**
+ * Error response (OpenAI-compatible)
+ */
+export interface ChatCompletionError {
+    error: {
+        message: string;
+        type: string;
+        param: string | null;
+        code: string;
+    };
+}
+/**
+ * Model information
+ */
+export interface Model {
+    id: string;
+    object: 'model';
+    created: number;
+    owned_by: string;
+}
+/**
+ * Client configuration
+ */
+export interface NovaClientConfig {
+    /** Nova API key (required, format: nova_sk_...) */
+    apiKey: string;
+    /** Base URL for REST API (default: http://localhost:3000) */
+    baseUrl?: string;
+    /** gRPC URL (default: 0.0.0.0:50051) */
+    grpcUrl?: string;
+    /** Preferred transport */
+    transport?: NovaTransport;
+    /** Request timeout in milliseconds (default: 60000) */
+    timeoutMs?: number;
+    /** Maximum number of retries for failed requests (default: 2) */
+    maxRetries?: number;
+}
+/**
+ * SDK error class
+ */
+export declare class NovaError extends Error {
+    readonly status?: number | undefined;
+    readonly code?: string | undefined;
+    readonly type?: string | undefined;
+    constructor(message: string, status?: number | undefined, code?: string | undefined, type?: string | undefined);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,20 @@
+/**
+ * Nova SDK Types
+ * OpenAI-compatible types for Nova AI API
+ */
+/**
+ * SDK error class
+ */
+export class NovaError extends Error {
+    status;
+    code;
+    type;
+    constructor(message, status, code, type) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.type = type;
+        this.name = 'NovaError';
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAuJH;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAGlB;IACA;IACA;IAJjB,YACC,OAAe,EACC,MAAe,EACf,IAAa,EACb,IAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,WAAM,GAAN,MAAM,CAAS;QACf,SAAI,GAAJ,IAAI,CAAS;QACb,SAAI,GAAJ,IAAI,CAAS;QAG7B,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IACzB,CAAC;CACD"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@ancatag/n-r",
+  "version": "0.1.0",
+  "description": "Official Node.js/TypeScript SDK for Nova AI API",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "type-check": "tsc --noEmit",
+    "prepublishOnly": "pnpm clean && pnpm build",
+    "publish:npm": "npm publish --access public"
+  },
+  "keywords": [
+    "nova",
+    "ai",
+    "sdk",
+    "chat",
+    "completions",
+    "openai-compatible"
+  ],
+  "author": "",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sayanmohsin/nova-route.git",
+    "directory": "packages/sdk"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "@types/node": "^20.11.30"
+  },
+  "type": "module",
+  "dependencies": {
+    "@grpc/grpc-js": "^1.14.3",
+    "@grpc/proto-loader": "^0.8.0"
+  }
+}