@nxcode/sdk 1.0.0 → 1.0.5

package/dist/nxcode.min.js

@@ -1 +1 @@
-!function(t,e){"object"==typeof exports&&"undefined"!=typeof module?e(exports):"function"==typeof define&&define.amd?define(["exports"],e):e((t="undefined"!=typeof globalThis?globalThis:t||self).Nxcode={})}(this,function(t){"use strict";const e="nxcode_sdk_auth";class i{constructor(t,e){this.user=null,this.token=null,this.refreshToken=null,this.expiresAt=null,this.authCallbacks=[],this.popupWindow=null,this.messageHandler=null,this.apiEndpoint=t,this.appId=e,this.loadFromStorage(),this.setupMessageListener()}async login(t="google"){return new Promise((e,i)=>{const s=window.screenX+(window.outerWidth-500)/2,n=window.screenY+(window.outerHeight-600)/2,o=`${this.apiEndpoint}/api/sdk/auth/login?app_id=${this.appId}&provider=${t}`;if(this.popupWindow=window.open(o,"nxcode_login",`width=500,height=600,left=${s},top=${n}`),!this.popupWindow)return void i(new Error("Failed to open login popup. Please allow popups for this site."));const a=setTimeout(()=>{this.popupWindow?.close(),i(new Error("Login timeout"))},12e4),r=t=>{if("NXCODE_SDK_AUTH"!==t.data?.type)return;clearTimeout(a),window.removeEventListener("message",r);const s=t.data.payload;s.success&&s.user&&s.token?(this.setAuth(s),e(s.user)):i(new Error(s.error||"Login failed"))};window.addEventListener("message",r)})}async logout(){try{this.token&&await fetch(`${this.apiEndpoint}/api/sdk/auth/logout`,{method:"POST",headers:this.getHeaders()})}catch(t){console.warn("Logout request failed:",t)}this.clearAuth()}getUser(){return this.user}getToken(){return this.expiresAt&&new Date>this.expiresAt?(this.refreshSession().catch(console.error),null):this.token}async getValidToken(){return this.expiresAt&&new Date>this.expiresAt&&await this.refreshSession(),this.token}onAuthStateChange(t){return this.authCallbacks.push(t),t(this.user),()=>{const e=this.authCallbacks.indexOf(t);e>-1&&this.authCallbacks.splice(e,1)}}isLoggedIn(){return null!==this.user&&null!==this.token}async refreshSession(){if(this.refreshToken)try{const t=await fetch(`${this.apiEndpoint}/api/sdk/auth/refresh`,{method:"POST",headers:{"Content-Type":"application/json","X-App-Id":this.appId},body:JSON.stringify({refreshToken:this.refreshToken})});if(!t.ok)throw new Error("Refresh failed");const e=await t.json();this.setAuth({success:!0,token:e.token,refreshToken:e.refreshToken,expiresAt:e.expiresAt,user:e.user})}catch(t){console.error("Session refresh failed:",t),this.clearAuth()}else this.clearAuth()}async fetchUser(){if(!this.token)return null;try{const t=await fetch(`${this.apiEndpoint}/api/sdk/auth/me`,{headers:this.getHeaders()});if(!t.ok){if(401===t.status)return await this.refreshSession(),this.user;throw new Error("Failed to fetch user")}const e=await t.json();return this.user=e,this.notifyAuthChange(),this.saveToStorage(),e}catch(t){return console.error("Failed to fetch user:",t),null}}setAuth(t){t.success&&t.user&&t.token&&(this.user=t.user,this.token=t.token,this.refreshToken=t.refreshToken||null,this.expiresAt=t.expiresAt?new Date(t.expiresAt):null,this.saveToStorage(),this.notifyAuthChange())}clearAuth(){this.user=null,this.token=null,this.refreshToken=null,this.expiresAt=null,localStorage.removeItem(`${e}_${this.appId}`),this.notifyAuthChange()}saveToStorage(){if(this.user&&this.token){const t={token:this.token,refreshToken:this.refreshToken||"",expiresAt:this.expiresAt?.toISOString()||"",user:this.user};localStorage.setItem(`${e}_${this.appId}`,JSON.stringify(t))}}loadFromStorage(){try{const t=localStorage.getItem(`${e}_${this.appId}`);if(t){const e=JSON.parse(t);this.token=e.token,this.refreshToken=e.refreshToken,this.expiresAt=e.expiresAt?new Date(e.expiresAt):null,this.user=e.user,this.expiresAt&&new Date>this.expiresAt&&this.refreshSession().catch(()=>this.clearAuth())}}catch(t){console.warn("Failed to load auth from storage:",t)}}notifyAuthChange(){for(const t of this.authCallbacks)try{t(this.user)}catch(t){console.error("Auth callback error:",t)}}setupMessageListener(){}getHeaders(){const t={"Content-Type":"application/json","X-App-Id":this.appId};return this.token&&(t.Authorization=`Bearer ${this.token}`),t}}class s{constructor(t,e,i){this.apiEndpoint=t,this.appId=e,this.getToken=i}async getBalance(){const t=this.getToken();if(!t)throw new Error("Not authenticated. Please login first.");const e=await fetch(`${this.apiEndpoint}/api/sdk/billing/balance`,{headers:this.getHeaders(t)});if(!e.ok){if(401===e.status)throw new Error("Session expired. Please login again.");throw new Error("Failed to fetch balance")}return(await e.json()).balance}topUp(){const t=`${this.apiEndpoint}/api/sdk/billing/topup?app_id=${this.appId}`;window.open(t,"_blank")}getHeaders(t){return{"Content-Type":"application/json","X-App-Id":this.appId,Authorization:`Bearer ${t}`}}}class n{constructor(t,e,i){this.apiEndpoint=t,this.appId=e,this.getToken=i}async charge(t){const e=this.getToken();if(!e)return{success:!1,error:"Not authenticated. Please login first."};try{const i=await fetch(`${this.apiEndpoint}/api/sdk/payment/charge`,{method:"POST",headers:this.getHeaders(e),body:JSON.stringify({amount:t.amount,description:t.description,metadata:t.metadata})});if(!i.ok){if(401===i.status)return{success:!1,error:"Session expired. Please login again."};if(402===i.status)return{success:!1,error:"Insufficient balance. Please top up."};return{success:!1,error:(await i.json().catch(()=>({}))).detail||"Payment failed"}}return await i.json()}catch(t){return{success:!1,error:t instanceof Error?t.message:"Payment failed"}}}async getTransactions(t=50,e=0){const i=this.getToken();if(!i)throw new Error("Not authenticated. Please login first.");const s=await fetch(`${this.apiEndpoint}/api/sdk/payment/transactions?limit=${t}&offset=${e}`,{headers:this.getHeaders(i)});if(!s.ok){if(401===s.status)throw new Error("Session expired. Please login again.");throw new Error("Failed to fetch transactions")}return(await s.json()).transactions}getHeaders(t){return{"Content-Type":"application/json","X-App-Id":this.appId,Authorization:`Bearer ${t}`}}}const o=new class{constructor(){this.config=null,this._auth=null,this._billing=null,this._payment=null,this.initPromise=null,this.apiEndpoint=this.detectApiEndpoint(),this.autoInit()}async autoInit(){return this.initPromise||(this.initPromise=this.init()),this.initPromise}async init(){try{const t=await fetch(`${this.apiEndpoint}/api/sdk/config`,{credentials:"include"});t.ok&&(this.config=await t.json(),this.config.apiEndpoint=this.apiEndpoint,this.setupModules())}catch(t){console.warn("Nxcode SDK: Could not auto-detect app config. Call Nxcode.configure() manually.")}}configure(t){this.config={appId:t,name:"",billingMode:"creator_pays",apiEndpoint:this.apiEndpoint},this.setupModules()}setupModules(){this.config&&(this._auth=new i(this.config.apiEndpoint,this.config.appId),this._billing=new s(this.config.apiEndpoint,this.config.appId,()=>this._auth?.getToken()||null),this._payment=new n(this.config.apiEndpoint,this.config.appId,()=>this._auth?.getToken()||null))}detectApiEndpoint(){if("undefined"!=typeof window){const t=window.location.hostname;if("localhost"===t||"127.0.0.1"===t)return"http://localhost:8001";if(t.includes(".nxcode.dev")||t.includes(".nxcode.app"))return"https://studio-api.nxcode.io"}return"https://studio-api.nxcode.io"}async ensureInitialized(){if(this.initPromise&&await this.initPromise,!this.config)throw new Error("Nxcode SDK not configured. Add X-App-Id header or call Nxcode.configure(appId).")}get auth(){const t=this;return{login:async(e="google")=>(await t.ensureInitialized(),t._auth.login(e)),logout:async()=>(await t.ensureInitialized(),t._auth.logout()),getUser:()=>t._auth?.getUser()||null,getToken:()=>t._auth?.getToken()||null,onAuthStateChange(e){if(!t._auth){let i=null,s=!1;return t.ensureInitialized().then(()=>{!s&&t._auth&&(i=t._auth.onAuthStateChange(e))}),()=>{s=!0,i&&i()}}return t._auth.onAuthStateChange(e)},isLoggedIn:()=>t._auth?.isLoggedIn()||!1}}get billing(){const t=this;return{getBalance:async()=>(await t.ensureInitialized(),t._billing.getBalance()),topUp(){t._billing?.topUp()}}}get payment(){const t=this;return{charge:async e=>(await t.ensureInitialized(),t._payment.charge(e)),getTransactions:async(e,i)=>(await t.ensureInitialized(),t._payment.getTransactions(e,i))}}getConfig(){return this.config}isReady(){return null!==this.config&&null!==this._auth}async ready(){await this.ensureInitialized()}};"undefined"!=typeof window&&(window.Nxcode=o),t.Nxcode=o,t.default=o,Object.defineProperty(t,"__esModule",{value:!0})});
+!function(t,e){"object"==typeof exports&&"undefined"!=typeof module?e(exports):"function"==typeof define&&define.amd?define(["exports"],e):e((t="undefined"!=typeof globalThis?globalThis:t||self).Nxcode={})}(this,function(t){"use strict";const e="nxcode_sdk_auth";class n{constructor(t,e){this.user=null,this.token=null,this.refreshToken=null,this.expiresAt=null,this.authCallbacks=[],this.popupWindow=null,this.messageHandler=null,this.apiEndpoint=t,this.appId=e,this.loadFromStorage(),this.setupMessageListener()}async login(t="google"){return new Promise((e,n)=>{const s=window.screenX+(window.outerWidth-500)/2,i=window.screenY+(window.outerHeight-600)/2,a=`${this.apiEndpoint}/api/sdk/auth/login?app_id=${this.appId}&provider=${t}`;if(this.popupWindow=window.open(a,"nxcode_login",`width=500,height=600,left=${s},top=${i}`),!this.popupWindow)return void n(new Error("Failed to open login popup. Please allow popups for this site."));const o=setTimeout(()=>{this.popupWindow?.close(),n(new Error("Login timeout"))},12e4),r=t=>{if("NXCODE_SDK_AUTH"!==t.data?.type)return;clearTimeout(o),window.removeEventListener("message",r);const s=t.data.payload;s.success&&s.user&&s.token?(this.setAuth(s),e(s.user)):n(new Error(s.error||"Login failed"))};window.addEventListener("message",r)})}async logout(){try{this.token&&await fetch(`${this.apiEndpoint}/api/sdk/auth/logout`,{method:"POST",headers:this.getHeaders()})}catch(t){console.warn("Logout request failed:",t)}this.clearAuth()}getUser(){return this.user}getToken(){return this.expiresAt&&new Date>this.expiresAt?(this.refreshSession().catch(console.error),null):this.token}async getValidToken(){return this.expiresAt&&new Date>this.expiresAt&&await this.refreshSession(),this.token}onAuthStateChange(t){return this.authCallbacks.push(t),t(this.user),()=>{const e=this.authCallbacks.indexOf(t);e>-1&&this.authCallbacks.splice(e,1)}}isLoggedIn(){return null!==this.user&&null!==this.token}async refreshSession(){if(this.refreshToken)try{const t=await fetch(`${this.apiEndpoint}/api/sdk/auth/refresh`,{method:"POST",headers:{"Content-Type":"application/json","X-App-Id":this.appId},body:JSON.stringify({refreshToken:this.refreshToken})});if(!t.ok)throw new Error("Refresh failed");const e=await t.json();this.setAuth({success:!0,token:e.token,refreshToken:e.refreshToken,expiresAt:e.expiresAt,user:e.user})}catch(t){console.error("Session refresh failed:",t),this.clearAuth()}else this.clearAuth()}async fetchUser(){if(!this.token)return null;try{const t=await fetch(`${this.apiEndpoint}/api/sdk/auth/me`,{headers:this.getHeaders()});if(!t.ok){if(401===t.status)return await this.refreshSession(),this.user;throw new Error("Failed to fetch user")}const e=await t.json();return this.user=e,this.notifyAuthChange(),this.saveToStorage(),e}catch(t){return console.error("Failed to fetch user:",t),null}}setAuth(t){t.success&&t.user&&t.token&&(this.user=t.user,this.token=t.token,this.refreshToken=t.refreshToken||null,this.expiresAt=t.expiresAt?new Date(t.expiresAt):null,this.saveToStorage(),this.notifyAuthChange())}clearAuth(){this.user=null,this.token=null,this.refreshToken=null,this.expiresAt=null,localStorage.removeItem(`${e}_${this.appId}`),this.notifyAuthChange()}saveToStorage(){if(this.user&&this.token){const t={token:this.token,refreshToken:this.refreshToken||"",expiresAt:this.expiresAt?.toISOString()||"",user:this.user};localStorage.setItem(`${e}_${this.appId}`,JSON.stringify(t))}}loadFromStorage(){try{const t=localStorage.getItem(`${e}_${this.appId}`);if(t){const e=JSON.parse(t);this.token=e.token,this.refreshToken=e.refreshToken,this.expiresAt=e.expiresAt?new Date(e.expiresAt):null,this.user=e.user,this.expiresAt&&new Date>this.expiresAt&&this.refreshSession().catch(()=>this.clearAuth())}}catch(t){console.warn("Failed to load auth from storage:",t)}}notifyAuthChange(){for(const t of this.authCallbacks)try{t(this.user)}catch(t){console.error("Auth callback error:",t)}}setupMessageListener(){}getHeaders(){const t={"Content-Type":"application/json","X-App-Id":this.appId};return this.token&&(t.Authorization=`Bearer ${this.token}`),t}}class s{constructor(t,e,n){this.apiEndpoint=t,this.appId=e,this.getToken=n}async getBalance(){const t=this.getToken();if(!t)throw new Error("Not authenticated. Please login first.");const e=await fetch(`${this.apiEndpoint}/api/sdk/billing/balance`,{headers:this.getHeaders(t)});if(!e.ok){if(401===e.status)throw new Error("Session expired. Please login again.");throw new Error("Failed to fetch balance")}return(await e.json()).balance}topUp(){const t=`${this.apiEndpoint}/api/sdk/billing/topup?app_id=${this.appId}`;window.open(t,"_blank")}getHeaders(t){return{"Content-Type":"application/json","X-App-Id":this.appId,Authorization:`Bearer ${t}`}}}class i{constructor(t,e,n){this.apiEndpoint=t,this.appId=e,this.getToken=n}async charge(t){const e=this.getToken();if(!e)return{success:!1,error:"Not authenticated. Please login first."};try{const n=await fetch(`${this.apiEndpoint}/api/sdk/payment/charge`,{method:"POST",headers:this.getHeaders(e),body:JSON.stringify({amount:t.amount,description:t.description,metadata:t.metadata})});if(!n.ok){if(401===n.status)return{success:!1,error:"Session expired. Please login again."};if(402===n.status)return{success:!1,error:"Insufficient balance. Please top up."};return{success:!1,error:(await n.json().catch(()=>({}))).detail||"Payment failed"}}return await n.json()}catch(t){return{success:!1,error:t instanceof Error?t.message:"Payment failed"}}}async getTransactions(t=50,e=0){const n=this.getToken();if(!n)throw new Error("Not authenticated. Please login first.");const s=await fetch(`${this.apiEndpoint}/api/sdk/payment/transactions?limit=${t}&offset=${e}`,{headers:this.getHeaders(n)});if(!s.ok){if(401===s.status)throw new Error("Session expired. Please login again.");throw new Error("Failed to fetch transactions")}return(await s.json()).transactions}getHeaders(t){return{"Content-Type":"application/json","X-App-Id":this.appId,Authorization:`Bearer ${t}`}}}function a(t){if("string"===t)return{type:"STRING"};if("number"===t)return{type:"NUMBER"};if("boolean"===t)return{type:"BOOLEAN"};if(Array.isArray(t)){if(1!==t.length)throw new Error("Array schema must have exactly one element type");return{type:"ARRAY",items:a(t[0])}}if("object"==typeof t&&null!==t){const e={},n=[];for(const[s,i]of Object.entries(t))e[s]=a(i),n.push(s);return{type:"OBJECT",properties:e,required:n}}throw new Error(`Invalid schema type: ${t}`)}class o{constructor(t,e,n){this.apiEndpoint=t,this.appId=e,this.getToken=n}async chat(t){const e=this.getToken();if(!e)throw new Error("Not authenticated. Please login first.");const n=t.model||"fast",s={contents:this.convertMessagesToGemini(t.messages)};t.responseSchema&&(s.generationConfig={responseMimeType:"application/json",responseSchema:a(t.responseSchema)});const i=await fetch(`${this.apiEndpoint}/api/ai-gateway/v1beta/models/${n}:generateContent`,{method:"POST",headers:this.getHeaders(e),body:JSON.stringify(s)});i.ok||await this.handleError(i);const o=await i.json();return this.parseGeminiResponse(o)}async generate(t){const e=await this.chat({messages:[{role:"user",content:t.prompt}],model:t.model,responseSchema:t.responseSchema});return{text:e.content,usage:e.usage}}async chatStream(t){const e=this.getToken(),n=e?this.getHeaders(e):this.getAnonymousHeaders(),s=t.model||"fast",i={contents:this.convertMessagesToGemini(t.messages)},a=await fetch(`${this.apiEndpoint}/api/ai-gateway/v1beta/models/${s}:streamGenerateContent?alt=sse`,{method:"POST",headers:n,body:JSON.stringify(i)});a.ok||await this.handleError(a);const o=a.body?.getReader();if(!o)throw new Error("Streaming not supported");const r=new TextDecoder;let h="";try{for(;;){const{done:e,value:n}=await o.read();if(e)break;h+=r.decode(n,{stream:!0});const s=h.split("\n");h=s.pop()||"";for(const e of s)if(e.startsWith("data: ")){const n=e.slice(6).trim();if("[DONE]"===n)return void t.onChunk({content:"",done:!0});try{const e=JSON.parse(n),s=this.parseStreamChunk(e);t.onChunk(s)}catch{}}}if(h.startsWith("data: ")){const e=h.slice(6).trim();if(e&&"[DONE]"!==e)try{const n=JSON.parse(e),s=this.parseStreamChunk(n);t.onChunk(s)}catch{}}t.onChunk({content:"",done:!0})}finally{o.releaseLock()}}async generateStream(t){return this.chatStream({messages:[{role:"user",content:t.prompt}],model:t.model,onChunk:t.onChunk})}getHeaders(t){return{"Content-Type":"application/json","X-App-Id":this.appId,Authorization:`Bearer ${t}`}}getAnonymousHeaders(){return{"Content-Type":"application/json","X-App-Id":this.appId}}convertMessagesToGemini(t){return t.map(t=>({role:"assistant"===t.role?"model":"user",parts:this.convertContentToParts(t.content)}))}convertContentToParts(t){return"string"==typeof t?[{text:t}]:t.map(t=>{switch(t.type){case"text":return{text:t.text};case"image":return{inlineData:{mimeType:t.mimeType,data:t.data}};case"image_url":return{fileData:{fileUri:t.url}};default:return{text:""}}})}parseGeminiResponse(t){const e=t.candidates,n=e?.[0]?.content?.parts?.[0]?.text||"",s=t.usageMetadata;return{content:n,usage:s?{inputTokens:s.promptTokenCount||0,outputTokens:s.candidatesTokenCount||0}:void 0}}parseStreamChunk(t){const e=t.candidates,n=e?.[0]?.content?.parts?.[0]?.text||"",s=e?.[0]?.finishReason,i="STOP"===s||"END_TURN"===s,a=t.usageMetadata;return{content:n,done:i,usage:a?{inputTokens:a.promptTokenCount||0,outputTokens:a.candidatesTokenCount||0}:void 0}}async handleError(t){if(401===t.status)throw new Error("Session expired. Please login again.");if(402===t.status)throw new Error("Insufficient balance. Please top up to continue.");let e="AI request failed";try{const n=await t.json();e=n.detail||n.message||e}catch{}throw new Error(e)}}const r=new class{constructor(){this.config=null,this._auth=null,this._billing=null,this._payment=null,this._ai=null,this.initPromise=null,this.apiEndpoint=this.detectApiEndpoint(),this.autoInit()}async autoInit(){return this.initPromise||(this.initPromise=this.init()),this.initPromise}async init(){try{const t=await fetch(`${this.apiEndpoint}/api/sdk/config`,{credentials:"include"});t.ok&&(this.config=await t.json(),this.config.apiEndpoint=this.apiEndpoint,this.setupModules())}catch(t){console.warn("Nxcode SDK: Could not auto-detect app config. Call Nxcode.configure() manually.")}}configure(t,e){e?.apiEndpoint&&(this.apiEndpoint=e.apiEndpoint),this.config={appId:t,name:"",billingMode:"creator_pays",apiEndpoint:this.apiEndpoint},this.setupModules()}setupModules(){this.config&&(this._auth=new n(this.config.apiEndpoint,this.config.appId),this._billing=new s(this.config.apiEndpoint,this.config.appId,()=>this._auth?.getToken()||null),this._payment=new i(this.config.apiEndpoint,this.config.appId,()=>this._auth?.getToken()||null),this._ai=new o(this.config.apiEndpoint,this.config.appId,()=>this._auth?.getToken()||null))}detectApiEndpoint(){if("undefined"!=typeof window){const t=window.location.hostname;if("localhost"===t||"127.0.0.1"===t)return"http://localhost:8001";if(t.includes(".nxcode.dev")||t.includes(".nxcode.app"))return"https://studio-api.nxcode.io"}return"https://studio-api.nxcode.io"}async ensureInitialized(){if(this.initPromise&&await this.initPromise,!this.config)throw new Error("Nxcode SDK not configured. Add X-App-Id header or call Nxcode.configure(appId).")}get auth(){const t=this;return{login:async(e="google")=>(await t.ensureInitialized(),t._auth.login(e)),logout:async()=>(await t.ensureInitialized(),t._auth.logout()),getUser:()=>t._auth?.getUser()||null,getToken:()=>t._auth?.getToken()||null,onAuthStateChange(e){if(!t._auth){let n=null,s=!1;return t.ensureInitialized().then(()=>{!s&&t._auth&&(n=t._auth.onAuthStateChange(e))}),()=>{s=!0,n&&n()}}return t._auth.onAuthStateChange(e)},isLoggedIn:()=>t._auth?.isLoggedIn()||!1}}get billing(){const t=this;return{getBalance:async()=>(await t.ensureInitialized(),t._billing.getBalance()),topUp(){t._billing?.topUp()}}}get payment(){const t=this;return{charge:async e=>(await t.ensureInitialized(),t._payment.charge(e)),getTransactions:async(e,n)=>(await t.ensureInitialized(),t._payment.getTransactions(e,n))}}get ai(){const t=this;return{chat:async e=>(await t.ensureInitialized(),t._ai.chat(e)),generate:async e=>(await t.ensureInitialized(),t._ai.generate(e)),chatStream:async e=>(await t.ensureInitialized(),t._ai.chatStream(e)),generateStream:async e=>(await t.ensureInitialized(),t._ai.generateStream(e))}}getConfig(){return this.config}isReady(){return null!==this.config&&null!==this._auth}async ready(){await this.ensureInitialized()}};"undefined"!=typeof window&&(window.Nxcode=r),t.Nxcode=r,t.default=r,Object.defineProperty(t,"__esModule",{value:!0})});

package/dist/types/ai.d.ts

@@ -0,0 +1,149 @@
+/**
+ * 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.
+ */
+/**
+ * Simplified schema type for structured output.
+ *
+ * Use simple TypeScript-style notation:
+ * - Primitives: 'string', 'number', 'boolean'
+ * - Arrays: ['string'], ['number'], [{ nested: 'object' }]
+ * - Objects: { key: 'type', nested: { ... } }
+ *
+ * @example
+ * // Simple object
+ * { name: 'string', age: 'number', active: 'boolean' }
+ *
+ * // With arrays
+ * { tags: ['string'], scores: ['number'] }
+ *
+ * // Nested objects
+ * { user: { name: 'string', profile: { bio: 'string' } } }
+ */
+export type SimpleSchema = 'string' | 'number' | 'boolean' | SimpleSchema[] | {
+    [key: string]: SimpleSchema;
+};
+/**
+ * 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;
+    /** Schema for structured output. AI will return JSON matching this schema. */
+    responseSchema?: SimpleSchema;
+}
+export interface ChatResponse {
+    content: string;
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+export interface GenerateOptions {
+    prompt: string;
+    model?: string;
+    /** Schema for structured output. AI will return JSON matching this schema. */
+    responseSchema?: SimpleSchema;
+}
+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.5",
   "type": "module",
   "description": "Nxcode SDK for web applications",
   "main": "dist/nxcode.js",