nuabase 2.2.0 → 2.3.0

package/dist/cjs/index.cjs

@@ -1,6 +1,5 @@
 'use strict';
 
-var node_module = require('node:module');
 var require$$0 = require('ajv');
 var require$$1 = require('ajv/dist/2019');
 var require$$2 = require('ajv/dist/2020');
@@ -8,16 +7,12 @@ var require$$3 = require('ajv/dist/refs/json-schema-draft-07.json');
 var require$$4 = require('ajv/dist/refs/json-schema-draft-06.json');
 var zod = require('zod');
 
-var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 var dist = {};
 
 var nuaLlmClient = {};
 
 var logger = {};
 
-const require$1 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)));
-function __require() { return require$1("node:crypto"); }
-
 var hasRequiredLogger;
 function requireLogger() {
   if (hasRequiredLogger) return logger;
@@ -27,7 +22,6 @@ function requireLogger() {
   logger.truncateText = truncateText;
   logger.pickHeaders = pickHeaders;
   logger.normalizeError = normalizeError;
-  const node_crypto_1 = __require();
   class ConsoleLogger {
     debug(message, context) {
       console.debug(`[DEBUG] ${message}`, context || "");
@@ -43,7 +37,7 @@ function requireLogger() {
     }
   }
   logger.ConsoleLogger = ConsoleLogger;
-  const generateSpanId = () => (0, node_crypto_1.randomUUID)();
+  const generateSpanId = () => crypto.randomUUID();
   logger.generateSpanId = generateSpanId;
   function truncateText(text, limit = 500) {
     const length = text.length;
@@ -1216,9 +1210,10 @@ class DirectBackend {
     this.client = new distExports.NuaLlmClient({ providers: config.providers });
   }
   async castValue(params) {
+    const model = params.model ?? this.model;
     const startTime = Date.now();
     const result = await this.client.castValue({
-      model: this.model,
+      model,
       input: { prompt: params.prompt, data: params.data },
       output: { name: params.outputName, effectiveSchema: params.outputSchema }
     });
@@ -1235,20 +1230,21 @@ class DirectBackend {
       success: true,
       data: result.data,
       usage: result.usage || normalizedUsageZero,
-      model: this.model,
+      model,
       latencyMs,
       source: "direct",
       meta: {}
     };
   }
   async castArray(params) {
+    const model = params.model ?? this.model;
     const startTime = Date.now();
     const wrappedSchema = distExports.wrapArraySchema(params.outputSchema, {
       primaryKey: params.primaryKey,
       outputName: params.outputName
     });
     const result = await this.client.castArray({
-      model: this.model,
+      model,
       data: params.data,
       input: { prompt: params.prompt, primaryKey: params.primaryKey },
       output: { name: params.outputName, effectiveSchema: wrappedSchema }
@@ -1266,7 +1262,7 @@ class DirectBackend {
       success: true,
       data: result.data,
       usage: result.usage || normalizedUsageZero,
-      model: this.model,
+      model,
       latencyMs,
       source: "direct",
       meta: {}
@@ -1285,6 +1281,13 @@ function resolveConfigValue(config, key, envVar) {
 }
 
 const isBrowserEnvironment = () => typeof window !== "undefined" && !!window.document;
+const isLocalhost = () => {
+  if (typeof window === "undefined" || !window.location) {
+    return false;
+  }
+  const host = window.location.hostname;
+  return host === "localhost" || host === "127.0.0.1";
+};
 class AuthTokenManager {
   constructor(config) {
     this.apiKey = resolveConfigValue(config, "apiKey", "NUABASE_API_KEY") || void 0;
@@ -1298,9 +1301,12 @@ class AuthTokenManager {
       );
     }
     if (this.apiKey && isBrowserEnvironment()) {
-      throw new Error(
-        "found config.apiKey. It is a private secret that must only be used in server environments."
-      );
+      const allowedLocally = config.dangerouslyAllowBrowserApiKeyInLocalhost && isLocalhost();
+      if (!allowedLocally) {
+        throw new Error(
+          "found config.apiKey. It is a private secret that must only be used in server environments."
+        );
+      }
     }
   }
   async getToken() {
@@ -1391,7 +1397,8 @@ class GatewayBackend {
     const startTime = Date.now();
     const response = await this.post("cast/value/now", {
       input: { prompt: params.prompt, data: params.data },
-      output: { name: params.outputName, schema: params.outputSchema }
+      output: { name: params.outputName, schema: params.outputSchema },
+      ...params.model && { model: params.model }
     });
     const latencyMs = Date.now() - startTime;
     if (isErrorResponse(response)) {
@@ -1422,7 +1429,8 @@ class GatewayBackend {
     const startTime = Date.now();
     const response = await this.post("cast/array/now", {
       input: { prompt: params.prompt, data: params.data, primaryKey: params.primaryKey },
-      output: { name: params.outputName, schema: params.outputSchema }
+      output: { name: params.outputName, schema: params.outputSchema },
+      ...params.model && { model: params.model }
     });
     const latencyMs = Date.now() - startTime;
     if (isErrorResponse(response)) {
@@ -1452,7 +1460,8 @@ class GatewayBackend {
   async queueCastValue(params) {
     const response = await this.post("cast/value", {
       input: { prompt: params.prompt, data: params.data },
-      output: { name: params.outputName, schema: params.outputSchema }
+      output: { name: params.outputName, schema: params.outputSchema },
+      ...params.model && { model: params.model }
     });
     if (isErrorResponse(response)) {
       return { success: false, error: response.error, source: "gateway" };
@@ -1463,7 +1472,8 @@ class GatewayBackend {
   async queueCastArray(params) {
     const response = await this.post("cast/array", {
       input: { prompt: params.prompt, data: params.data, primaryKey: params.primaryKey },
-      output: { name: params.outputName, schema: params.outputSchema }
+      output: { name: params.outputName, schema: params.outputSchema },
+      ...params.model && { model: params.model }
     });
     if (isErrorResponse(response)) {
       return { success: false, error: response.error, source: "gateway" };
@@ -1520,7 +1530,8 @@ class Nua {
       prompt,
       data: options?.input ?? null,
       outputName,
-      outputSchema: jsonSchema
+      outputSchema: jsonSchema,
+      model: options?.model
     });
   }
   // ========== list() - Array Operations ==========
@@ -1540,7 +1551,8 @@ class Nua {
       data: options.input,
       primaryKey: options.primaryKey,
       outputName: options.output.name,
-      outputSchema: jsonSchema
+      outputSchema: jsonSchema,
+      model: options.model
     });
   }
   // Implementation
@@ -1558,7 +1570,8 @@ class Nua {
       prompt,
       data: options?.input ?? null,
       outputName,
-      outputSchema: jsonSchema
+      outputSchema: jsonSchema,
+      model: options?.model
     });
   }
   // ========== queueList() - Async Array Operations ==========
@@ -1581,7 +1594,8 @@ class Nua {
       data: options.input,
       primaryKey: options.primaryKey,
       outputName: options.output.name,
-      outputSchema: jsonSchema
+      outputSchema: jsonSchema,
+      model: options.model
     });
   }
 }

package/dist/esm/index.mjs

@@ -1,4 +1,3 @@
-import { createRequire } from 'node:module';
 import require$$0 from 'ajv';
 import require$$1 from 'ajv/dist/2019';
 import require$$2 from 'ajv/dist/2020';
@@ -13,9 +12,6 @@ var nuaLlmClient = {};
 
 var logger = {};
 
-const require$1 = createRequire(import.meta.url);
-function __require() { return require$1("node:crypto"); }
-
 var hasRequiredLogger;
 function requireLogger() {
   if (hasRequiredLogger) return logger;
@@ -25,7 +21,6 @@ function requireLogger() {
   logger.truncateText = truncateText;
   logger.pickHeaders = pickHeaders;
   logger.normalizeError = normalizeError;
-  const node_crypto_1 = __require();
   class ConsoleLogger {
     debug(message, context) {
       console.debug(`[DEBUG] ${message}`, context || "");
@@ -41,7 +36,7 @@ function requireLogger() {
     }
   }
   logger.ConsoleLogger = ConsoleLogger;
-  const generateSpanId = () => (0, node_crypto_1.randomUUID)();
+  const generateSpanId = () => crypto.randomUUID();
   logger.generateSpanId = generateSpanId;
   function truncateText(text, limit = 500) {
     const length = text.length;
@@ -1214,9 +1209,10 @@ class DirectBackend {
     this.client = new distExports.NuaLlmClient({ providers: config.providers });
   }
   async castValue(params) {
+    const model = params.model ?? this.model;
     const startTime = Date.now();
     const result = await this.client.castValue({
-      model: this.model,
+      model,
       input: { prompt: params.prompt, data: params.data },
       output: { name: params.outputName, effectiveSchema: params.outputSchema }
     });
@@ -1233,20 +1229,21 @@ class DirectBackend {
       success: true,
       data: result.data,
       usage: result.usage || normalizedUsageZero,
-      model: this.model,
+      model,
       latencyMs,
       source: "direct",
       meta: {}
     };
   }
   async castArray(params) {
+    const model = params.model ?? this.model;
     const startTime = Date.now();
     const wrappedSchema = distExports.wrapArraySchema(params.outputSchema, {
       primaryKey: params.primaryKey,
       outputName: params.outputName
     });
     const result = await this.client.castArray({
-      model: this.model,
+      model,
       data: params.data,
       input: { prompt: params.prompt, primaryKey: params.primaryKey },
       output: { name: params.outputName, effectiveSchema: wrappedSchema }
@@ -1264,7 +1261,7 @@ class DirectBackend {
       success: true,
       data: result.data,
       usage: result.usage || normalizedUsageZero,
-      model: this.model,
+      model,
       latencyMs,
       source: "direct",
       meta: {}
@@ -1283,6 +1280,13 @@ function resolveConfigValue(config, key, envVar) {
 }
 
 const isBrowserEnvironment = () => typeof window !== "undefined" && !!window.document;
+const isLocalhost = () => {
+  if (typeof window === "undefined" || !window.location) {
+    return false;
+  }
+  const host = window.location.hostname;
+  return host === "localhost" || host === "127.0.0.1";
+};
 class AuthTokenManager {
   constructor(config) {
     this.apiKey = resolveConfigValue(config, "apiKey", "NUABASE_API_KEY") || void 0;
@@ -1296,9 +1300,12 @@ class AuthTokenManager {
       );
     }
     if (this.apiKey && isBrowserEnvironment()) {
-      throw new Error(
-        "found config.apiKey. It is a private secret that must only be used in server environments."
-      );
+      const allowedLocally = config.dangerouslyAllowBrowserApiKeyInLocalhost && isLocalhost();
+      if (!allowedLocally) {
+        throw new Error(
+          "found config.apiKey. It is a private secret that must only be used in server environments."
+        );
+      }
     }
   }
   async getToken() {
@@ -1389,7 +1396,8 @@ class GatewayBackend {
     const startTime = Date.now();
     const response = await this.post("cast/value/now", {
       input: { prompt: params.prompt, data: params.data },
-      output: { name: params.outputName, schema: params.outputSchema }
+      output: { name: params.outputName, schema: params.outputSchema },
+      ...params.model && { model: params.model }
     });
     const latencyMs = Date.now() - startTime;
     if (isErrorResponse(response)) {
@@ -1420,7 +1428,8 @@ class GatewayBackend {
     const startTime = Date.now();
     const response = await this.post("cast/array/now", {
       input: { prompt: params.prompt, data: params.data, primaryKey: params.primaryKey },
-      output: { name: params.outputName, schema: params.outputSchema }
+      output: { name: params.outputName, schema: params.outputSchema },
+      ...params.model && { model: params.model }
     });
     const latencyMs = Date.now() - startTime;
     if (isErrorResponse(response)) {
@@ -1450,7 +1459,8 @@ class GatewayBackend {
   async queueCastValue(params) {
     const response = await this.post("cast/value", {
       input: { prompt: params.prompt, data: params.data },
-      output: { name: params.outputName, schema: params.outputSchema }
+      output: { name: params.outputName, schema: params.outputSchema },
+      ...params.model && { model: params.model }
     });
     if (isErrorResponse(response)) {
       return { success: false, error: response.error, source: "gateway" };
@@ -1461,7 +1471,8 @@ class GatewayBackend {
   async queueCastArray(params) {
     const response = await this.post("cast/array", {
       input: { prompt: params.prompt, data: params.data, primaryKey: params.primaryKey },
-      output: { name: params.outputName, schema: params.outputSchema }
+      output: { name: params.outputName, schema: params.outputSchema },
+      ...params.model && { model: params.model }
     });
     if (isErrorResponse(response)) {
       return { success: false, error: response.error, source: "gateway" };
@@ -1518,7 +1529,8 @@ class Nua {
       prompt,
       data: options?.input ?? null,
       outputName,
-      outputSchema: jsonSchema
+      outputSchema: jsonSchema,
+      model: options?.model
     });
   }
   // ========== list() - Array Operations ==========
@@ -1538,7 +1550,8 @@ class Nua {
       data: options.input,
       primaryKey: options.primaryKey,
       outputName: options.output.name,
-      outputSchema: jsonSchema
+      outputSchema: jsonSchema,
+      model: options.model
     });
   }
   // Implementation
@@ -1556,7 +1569,8 @@ class Nua {
       prompt,
       data: options?.input ?? null,
       outputName,
-      outputSchema: jsonSchema
+      outputSchema: jsonSchema,
+      model: options?.model
     });
   }
   // ========== queueList() - Async Array Operations ==========
@@ -1579,7 +1593,8 @@ class Nua {
       data: options.input,
       primaryKey: options.primaryKey,
       outputName: options.output.name,
-      outputSchema: jsonSchema
+      outputSchema: jsonSchema,
+      model: options.model
     });
   }
 }

package/dist/types/backend/types.d.ts

@@ -3,6 +3,7 @@ export type CastValueParams = {
     data: unknown;
     outputName: string;
     outputSchema: object;
+    model?: string;
 };
 export type CastArrayParams = {
     prompt: string;
@@ -10,6 +11,7 @@ export type CastArrayParams = {
     primaryKey: string;
     outputName: string;
     outputSchema: object;
+    model?: string;
 };
 export type NormalizedUsage = {
     promptTokens: number;

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

@@ -1,6 +1,7 @@
 export type AuthConfig = {
     apiKey?: string;
     fetchToken?: () => Promise<string>;
+    dangerouslyAllowBrowserApiKeyInLocalhost?: boolean;
 };
 export declare class AuthTokenManager {
     private readonly apiKey?;

package/dist/types/nua.d.ts

@@ -9,11 +9,13 @@ export type OutputDef<TSchema extends z.ZodTypeAny> = {
 export type GetOptions<TSchema extends z.ZodTypeAny> = {
     input?: unknown;
     output: OutputDef<TSchema>;
+    model?: string;
 };
 export type ListOptions<TSchema extends z.ZodTypeAny, TData extends Record<string, unknown>, PrimaryKey extends keyof TData & string> = {
     input: TData[];
     primaryKey: PrimaryKey;
     output: OutputDef<TSchema>;
+    model?: string;
 };
 export type ListResultRow<TSchema extends z.ZodTypeAny, PrimaryKey extends string> = {
     [K in PrimaryKey]: string | number;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "nuabase",
   "description": "Nuabase TypeScript client to create typed functions from LLM prompts",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "type": "module",
   "author": "Jasim A Basheer <jasim@nuabase.com>",
   "engines": {