@nxcode/sdk 1.0.0 → 1.0.1

package/dist/types/ai.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Nxcode SDK - AI Module
+ *
+ * Provides access to AI capabilities through the Nxcode AI Gateway.
+ * All AI calls require user authentication and are billed to the user's balance.
+ */
+/**
+ * Content part for multimodal messages
+ */
+export interface TextPart {
+    type: 'text';
+    text: string;
+}
+export interface ImagePart {
+    type: 'image';
+    /** Base64 encoded image data */
+    data: string;
+    /** MIME type (e.g., 'image/png', 'image/jpeg') */
+    mimeType: string;
+}
+export interface ImageUrlPart {
+    type: 'image_url';
+    /** URL of the image */
+    url: string;
+}
+export type ContentPart = TextPart | ImagePart | ImageUrlPart;
+export interface ChatMessage {
+    role: 'user' | 'assistant' | 'system';
+    /** Text content or array of content parts for multimodal */
+    content: string | ContentPart[];
+}
+export interface ChatOptions {
+    messages: ChatMessage[];
+    model?: string;
+}
+export interface ChatResponse {
+    content: string;
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+export interface GenerateOptions {
+    prompt: string;
+    model?: string;
+}
+export interface GenerateResponse {
+    text: string;
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+export interface StreamChunk {
+    content: string;
+    done: boolean;
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+export type StreamCallback = (chunk: StreamChunk) => void;
+export declare class NxcodeAI {
+    private apiEndpoint;
+    private appId;
+    private getToken;
+    constructor(apiEndpoint: string, appId: string, getToken: () => string | null);
+    /**
+     * Send a chat message and get a response.
+     *
+     * @example
+     * const response = await Nxcode.ai.chat({
+     *   messages: [
+     *     { role: 'user', content: 'Hello!' }
+     *   ]
+     * });
+     * console.log(response.content);
+     */
+    chat(options: ChatOptions): Promise<ChatResponse>;
+    /**
+     * Generate text from a prompt.
+     *
+     * @example
+     * const response = await Nxcode.ai.generate({
+     *   prompt: 'Write a haiku about coding'
+     * });
+     * console.log(response.text);
+     */
+    generate(options: GenerateOptions): Promise<GenerateResponse>;
+    /**
+     * Stream a chat response in real-time.
+     *
+     * @example
+     * await Nxcode.ai.chatStream({
+     *   messages: [{ role: 'user', content: 'Tell me a story' }],
+     *   onChunk: (chunk) => {
+     *     process.stdout.write(chunk.content);
+     *     if (chunk.done) console.log('\n--- Done ---');
+     *   }
+     * });
+     */
+    chatStream(options: ChatOptions & {
+        onChunk: StreamCallback;
+    }): Promise<void>;
+    /**
+     * Stream text generation from a prompt.
+     *
+     * @example
+     * await Nxcode.ai.generateStream({
+     *   prompt: 'Write a poem',
+     *   onChunk: (chunk) => console.log(chunk.content)
+     * });
+     */
+    generateStream(options: GenerateOptions & {
+        onChunk: StreamCallback;
+    }): Promise<void>;
+    private getHeaders;
+    private getAnonymousHeaders;
+    private convertMessagesToGemini;
+    private convertContentToParts;
+    private parseGeminiResponse;
+    private parseStreamChunk;
+    private handleError;
+}

package/dist/types/auth.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Auth Module Unit Tests
+ *
+ * Run with: npx vitest run src/auth.test.ts
+ */
+export {};

package/dist/types/index.d.ts

@@ -11,12 +11,14 @@
  *     console.log('Logged in:', user.email);
  *   </script>
  */
+import { type ChatOptions, type ChatResponse, type GenerateOptions, type GenerateResponse, type StreamChunk, type StreamCallback, type ChatMessage, type ContentPart, type TextPart, type ImagePart, type ImageUrlPart } from './ai';
 import type { NxcodeUser, NxcodeConfig, ChargeOptions, ChargeResult, Transaction, AuthStateCallback } from './types';
 declare class NxcodeSDK {
     private config;
     private _auth;
     private _billing;
     private _payment;
+    private _ai;
     private initPromise;
     private apiEndpoint;
     constructor();
@@ -29,9 +31,11 @@ declare class NxcodeSDK {
      */
     private init;
     /**
-     * Manually configure SDK with app ID
+     * Manually configure SDK with app ID and optional endpoint
      */
-    configure(appId: string): void;
+    configure(appId: string, options?: {
+        apiEndpoint?: string;
+    }): void;
     /**
      * Set up SDK modules after configuration
      */
@@ -90,6 +94,51 @@ declare class NxcodeSDK {
          */
         getTransactions(limit?: number, offset?: number): Promise<Transaction[]>;
     };
+    get ai(): {
+        /**
+         * Send a chat message and get a response
+         *
+         * @example
+         * const response = await Nxcode.ai.chat({
+         *   messages: [{ role: 'user', content: 'Hello!' }]
+         * });
+         */
+        chat(options: ChatOptions): Promise<ChatResponse>;
+        /**
+         * Generate text from a prompt
+         *
+         * @example
+         * const response = await Nxcode.ai.generate({ prompt: 'Write a haiku' });
+         */
+        generate(options: GenerateOptions): Promise<GenerateResponse>;
+        /**
+         * Stream a chat response in real-time
+         *
+         * @example
+         * await Nxcode.ai.chatStream({
+         *   messages: [{ role: 'user', content: 'Tell me a story' }],
+         *   onChunk: (chunk) => {
+         *     document.body.innerText += chunk.content;
+         *     if (chunk.done) console.log('Done!');
+         *   }
+         * });
+         */
+        chatStream(options: ChatOptions & {
+            onChunk: StreamCallback;
+        }): Promise<void>;
+        /**
+         * Stream text generation from a prompt
+         *
+         * @example
+         * await Nxcode.ai.generateStream({
+         *   prompt: 'Write a poem',
+         *   onChunk: (chunk) => console.log(chunk.content)
+         * });
+         */
+        generateStream(options: GenerateOptions & {
+            onChunk: StreamCallback;
+        }): Promise<void>;
+    };
     /**
      * Get current configuration
      */
@@ -106,4 +155,4 @@ declare class NxcodeSDK {
 declare const Nxcode: NxcodeSDK;
 export default Nxcode;
 export { Nxcode };
-export type { NxcodeUser, NxcodeConfig, ChargeOptions, ChargeResult, Transaction, AuthStateCallback, };
+export type { NxcodeUser, NxcodeConfig, ChargeOptions, ChargeResult, Transaction, AuthStateCallback, ChatOptions, ChatResponse, ChatMessage, ContentPart, TextPart, ImagePart, ImageUrlPart, GenerateOptions, GenerateResponse, StreamChunk, StreamCallback, };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nxcode/sdk",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "type": "module",
   "description": "Nxcode SDK for web applications",
   "main": "dist/nxcode.js",