@oxy-hq/sdk 0.1.5 → 0.1.6

package/README.md

@@ -33,38 +33,42 @@ npm install @duckdb/duckdb-wasm
 Perfect for embedding dashboards in iframes (e.g., v0.dev, sandboxed environments):
 
 ```typescript
-import { OxyClient } from '@oxy/sdk';
+import { OxyClient } from "@oxy/sdk";
 
 // SDK automatically requests API key from parent window
 const client = await OxyClient.create({
-  parentOrigin: 'https://app.example.com',  // Parent window origin
-  projectId: 'your-project-uuid',
-  baseUrl: 'https://api.oxy.tech'
+  parentOrigin: "https://app.example.com", // Parent window origin
+  projectId: "your-project-uuid",
+  baseUrl: "https://api.oxy.tech",
 });
 
 // Use the client
 const apps = await client.listApps();
-console.log('Available apps:', apps);
+console.log("Available apps:", apps);
 ```
 
 **Parent window setup** (one-time):
+
 ```typescript
 // In parent window that hosts the iframe
-window.addEventListener('message', (event) => {
-  if (event.data.type !== 'OXY_AUTH_REQUEST') return;
+window.addEventListener("message", (event) => {
+  if (event.data.type !== "OXY_AUTH_REQUEST") return;
 
   // Validate iframe origin
-  if (event.origin !== 'https://your-iframe-app.com') return;
+  if (event.origin !== "https://your-iframe-app.com") return;
 
   // Send user's API key to iframe
-  event.source.postMessage({
-    type: 'OXY_AUTH_RESPONSE',
-    version: '1.0',
-    requestId: event.data.requestId,
-    apiKey: getUserApiKey(),  // Your auth logic
-    projectId: 'your-project-uuid',
-    baseUrl: 'https://api.oxy.tech'
-  }, event.origin);
+  event.source.postMessage(
+    {
+      type: "OXY_AUTH_RESPONSE",
+      version: "1.0",
+      requestId: event.data.requestId,
+      apiKey: getUserApiKey(), // Your auth logic
+      projectId: "your-project-uuid",
+      baseUrl: "https://api.oxy.tech",
+    },
+    event.origin,
+  );
 });
 ```
 
@@ -82,7 +86,7 @@ export OXY_BRANCH="main"  # optional
 Basic usage:
 
 ```typescript
-import { OxyClient, createConfig } from '@oxy/sdk';
+import { OxyClient, createConfig } from "@oxy/sdk";
 
 // Create configuration from environment variables
 const config = createConfig();
@@ -92,16 +96,16 @@ const client = new OxyClient(config);
 
 // List all apps
 const apps = await client.listApps();
-console.log('Available apps:', apps);
+console.log("Available apps:", apps);
 
 // Get app data
-const data = await client.getAppData('dashboard.app.yml');
+const data = await client.getAppData("dashboard.app.yml");
 if (!data.error) {
-  console.log('App data:', data.data);
+  console.log("App data:", data.data);
 }
 
 // Fetch a file (e.g., chart image)
-const blob = await client.getFile('charts/sales-chart.png');
+const blob = await client.getFile("charts/sales-chart.png");
 const url = URL.createObjectURL(blob);
 // Use the URL in an <img> tag
 ```
@@ -109,19 +113,19 @@ const url = URL.createObjectURL(blob);
 ### Reading Parquet Files
 
 ```typescript
-import { OxyClient, createConfig, readParquet, ParquetReader } from '@oxy/sdk';
+import { OxyClient, createConfig, readParquet, ParquetReader } from "@oxy/sdk";
 
 const config = createConfig();
 const client = new OxyClient(config);
 
 // Quick read - get all data
-const blob = await client.getFile('data/sales.parquet');
+const blob = await client.getFile("data/sales.parquet");
 const data = await readParquet(blob, 1000); // Read first 1000 rows
 console.log(data.columns);
 console.log(data.rows);
 
 // Advanced - query with SQL
-const reader = new ParquetReader('sales');
+const reader = new ParquetReader("sales");
 await reader.registerParquet(blob);
 
 const result = await reader.query(`
@@ -132,7 +136,7 @@ const result = await reader.query(`
   LIMIT 10
 `);
 
-console.log('Top 10 products:', result.rows);
+console.log("Top 10 products:", result.rows);
 await reader.close();
 ```
 
@@ -169,7 +173,7 @@ function Dashboard() {
 ### Displaying Parquet Data
 
 ```typescript
-import { ParquetReader } from '@oxy/sdk';
+import { ParquetReader } from "@oxy/sdk";
 
 function DataTable({ filePath }: { filePath: string }) {
   const [data, setData] = useState(null);
@@ -192,29 +196,42 @@ function DataTable({ filePath }: { filePath: string }) {
 
 ## Use with v0 and Other Sandbox Services
 
-Perfect for integrating Oxy data into v0-generated apps or other sandbox environments:
+Perfect for integrating Oxy data into v0-generated apps or other sandbox environments.
+
+**For AI Assistants (v0.dev, Cursor, etc.):** See [.v0/rules.md](.v0/rules.md) and [.cursorrules](.cursorrules) for comprehensive integration guidelines.
 
 ```typescript
 // In your v0 app
-import { OxyClient, createConfig, readParquet } from '@oxy/sdk';
+import { OxyClient, createConfig, readParquet } from "@oxy/sdk";
 
 // Configure with environment variables set in v0 project settings
 const client = new OxyClient(createConfig());
 
 export async function fetchDashboardData() {
   const [sales, customers] = await Promise.all([
-    client.getAppData('apps/sales.app.yml'),
-    client.getAppData('apps/customers.app.yml'),
+    client.getAppData("apps/sales.app.yml"),
+    client.getAppData("apps/customers.app.yml"),
   ]);
 
   return { sales: sales.data, customers: customers.data };
 }
 
 export function getSalesChartUrl() {
-  return client.getFileUrl('charts/sales-overview.png');
+  return client.getFileUrl("charts/sales-overview.png");
 }
 ```
 
+### v0 Environment Setup
+
+In your v0 project settings, configure these environment variables:
+
+```env
+OXY_URL=https://api.oxy.tech
+OXY_API_KEY=your-api-key-here
+OXY_PROJECT_ID=your-project-uuid-here
+OXY_BRANCH=main
+```
+
 ## API Reference
 
 ### OxyClient
@@ -333,3 +350,7 @@ MIT
 ## Support
 
 For issues and questions, please visit [GitHub Issues](https://github.com/dataframehq/oxy-internal/issues).
+
+### Local development with v0 or cloud service
+
+- Disable the local network access check [flag](chrome ://flags/#local-network-access-check)

package/dist/index.cjs

@@ -26,7 +26,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 
 //#endregion
-const require_postMessage = require('./postMessage-CufWf9ji.cjs');
+const require_postMessage = require('./postMessage-B1J0jDRN.cjs');
 let _duckdb_duckdb_wasm = require("@duckdb/duckdb-wasm");
 _duckdb_duckdb_wasm = __toESM(_duckdb_duckdb_wasm);
 
@@ -94,25 +94,40 @@ function createConfig(overrides) {
 * ```
 */
 async function createConfigAsync(overrides) {
-	const { isInIframe: isInIframe$1, requestAuthFromParent: requestAuthFromParent$1 } = await Promise.resolve().then(() => require("./postMessage-CVS3MsL5.cjs"));
+	const { isInIframe: isInIframe$1 } = await Promise.resolve().then(() => require("./postMessage-BSNS3ccd.cjs"));
 	let baseUrl = overrides?.baseUrl || process.env.OXY_URL;
 	let apiKey = overrides?.apiKey || process.env.OXY_API_KEY;
 	let projectId = overrides?.projectId || process.env.OXY_PROJECT_ID;
 	const disableAutoAuth = overrides?.disableAutoAuth ?? false;
 	const parentOrigin = overrides?.parentOrigin;
-	if (!disableAutoAuth && isInIframe$1() && !apiKey) if (!parentOrigin) console.warn("[Oxy SDK] Running in iframe without API key and no parentOrigin specified. PostMessage authentication will be skipped. Provide parentOrigin config to enable automatic authentication.");
-	else try {
-		const authResult = await requestAuthFromParent$1({
-			parentOrigin,
-			timeout: overrides?.timeout || 5e3
-		});
-		apiKey = authResult.apiKey;
-		if (authResult.projectId) projectId = authResult.projectId;
-		if (authResult.baseUrl) baseUrl = authResult.baseUrl;
-		console.log("[Oxy SDK] Successfully authenticated via postMessage");
-	} catch (error) {
+	if (!disableAutoAuth && isInIframe$1() && !apiKey) if (!parentOrigin) logWarningAboutMissingParentOrigin();
+	else apiKey = await attemptPostMessageAuth(parentOrigin, overrides?.timeout || 5e3, apiKey, projectId, baseUrl).then((result) => {
+		if (result.projectId) projectId = result.projectId;
+		if (result.baseUrl) baseUrl = result.baseUrl;
+		return result.apiKey;
+	}).catch((error) => {
 		console.error("[Oxy SDK] Failed to authenticate via postMessage:", error.message);
-	}
+		return apiKey;
+	});
+	return createFinalConfig(baseUrl, apiKey, projectId, overrides);
+}
+function logWarningAboutMissingParentOrigin() {
+	console.warn("[Oxy SDK] Running in iframe without API key and no parentOrigin specified. PostMessage authentication will be skipped. Provide parentOrigin config to enable automatic authentication.");
+}
+async function attemptPostMessageAuth(parentOrigin, timeout, currentApiKey, currentProjectId, currentBaseUrl) {
+	const { requestAuthFromParent: requestAuthFromParent$1 } = await Promise.resolve().then(() => require("./postMessage-BSNS3ccd.cjs"));
+	const authResult = await requestAuthFromParent$1({
+		parentOrigin,
+		timeout
+	});
+	console.log("[Oxy SDK] Successfully authenticated via postMessage");
+	return {
+		apiKey: authResult.apiKey || currentApiKey,
+		projectId: authResult.projectId || currentProjectId,
+		baseUrl: authResult.baseUrl || currentBaseUrl
+	};
+}
+function createFinalConfig(baseUrl, apiKey, projectId, overrides) {
 	if (!baseUrl) throw new Error("OXY_URL environment variable or baseUrl config is required");
 	if (!projectId) throw new Error("OXY_PROJECT_ID environment variable or projectId config is required");
 	return {
@@ -121,8 +136,8 @@ async function createConfigAsync(overrides) {
 		projectId,
 		branch: overrides?.branch || process.env.OXY_BRANCH,
 		timeout: overrides?.timeout || 3e4,
-		parentOrigin,
-		disableAutoAuth
+		parentOrigin: overrides?.parentOrigin,
+		disableAutoAuth: overrides?.disableAutoAuth
 	};
 }
 
@@ -130,6 +145,15 @@ async function createConfigAsync(overrides) {
 //#region src/parquet.ts
 let dbInstance = null;
 let connection = null;
+let operationQueue = Promise.resolve();
+/**
+* Enqueue an operation to prevent race conditions on shared DuckDB instance
+*/
+function enqueueOperation(operation) {
+	const currentOperation = operationQueue.then(operation, operation);
+	operationQueue = currentOperation.then(() => {}, () => {});
+	return currentOperation;
+}
 /**
 * Initialize DuckDB-WASM instance
 */
@@ -160,6 +184,7 @@ var ParquetReader = class {
 	constructor(tableName = "data") {
 		this.registered = false;
 		this.tableName = tableName;
+		this.internalTableName = `${tableName}_${`${Date.now()}_${Math.random().toString(36).substring(2, 9)}`}`;
 	}
 	/**
 	* Register a Parquet file from a Blob
@@ -174,16 +199,18 @@ var ParquetReader = class {
 	* ```
 	*/
 	async registerParquet(blob) {
-		const conn = await getConnection();
-		const db = await initializeDuckDB();
-		const arrayBuffer = await blob.arrayBuffer();
-		const uint8Array = new Uint8Array(arrayBuffer);
-		await db.registerFileBuffer(`${this.tableName}.parquet`, uint8Array);
-		try {
-			await conn.query(`DROP TABLE IF EXISTS ${this.tableName}`);
-		} catch (e) {}
-		await conn.query(`CREATE TABLE ${this.tableName} AS SELECT * FROM '${this.tableName}.parquet'`);
-		this.registered = true;
+		await enqueueOperation(async () => {
+			const conn = await getConnection();
+			const db = await initializeDuckDB();
+			const arrayBuffer = await blob.arrayBuffer();
+			const uint8Array = new Uint8Array(arrayBuffer);
+			await db.registerFileBuffer(`${this.internalTableName}.parquet`, uint8Array);
+			try {
+				await conn.query(`DROP TABLE IF EXISTS ${this.internalTableName}`);
+			} catch {}
+			await conn.query(`CREATE TABLE ${this.internalTableName} AS SELECT * FROM '${this.internalTableName}.parquet'`);
+			this.registered = true;
+		});
 	}
 	/**
 	* Execute a SQL query against the registered Parquet data
@@ -200,22 +227,26 @@ var ParquetReader = class {
 	*/
 	async query(sql) {
 		if (!this.registered) throw new Error("Parquet file not registered. Call registerParquet() first.");
-		const result = await (await getConnection()).query(sql);
-		const columns = result.schema.fields.map((field) => field.name);
-		const rows = [];
-		for (let i = 0; i < result.numRows; i++) {
-			const row = [];
-			for (let j = 0; j < result.numCols; j++) {
-				const col = result.getChildAt(j);
-				row.push(col?.get(i));
+		return enqueueOperation(async () => {
+			const conn = await getConnection();
+			const rewrittenSql = sql.replace(new RegExp(`\\b${this.tableName}\\b`, "g"), this.internalTableName);
+			const result = await conn.query(rewrittenSql);
+			const columns = result.schema.fields.map((field) => field.name);
+			const rows = [];
+			for (let i = 0; i < result.numRows; i++) {
+				const row = [];
+				for (let j = 0; j < result.numCols; j++) {
+					const col = result.getChildAt(j);
+					row.push(col?.get(i));
+				}
+				rows.push(row);
 			}
-			rows.push(row);
-		}
-		return {
-			columns,
-			rows,
-			rowCount: result.numRows
-		};
+			return {
+				columns,
+				rows,
+				rowCount: result.numRows
+			};
+		});
 	}
 	/**
 	* Get all data from the registered table
@@ -266,17 +297,17 @@ var ParquetReader = class {
 	* Close and cleanup resources
 	*/
 	async close() {
-		if (this.registered) {
+		if (this.registered) await enqueueOperation(async () => {
 			const conn = await getConnection();
 			const db = await initializeDuckDB();
 			try {
-				await conn.query(`DROP TABLE IF EXISTS ${this.tableName}`);
-			} catch (e) {}
+				await conn.query(`DROP TABLE IF EXISTS ${this.internalTableName}`);
+			} catch {}
 			try {
-				await db.dropFile(`${this.tableName}.parquet`);
-			} catch (e) {}
+				await db.dropFile(`${this.internalTableName}.parquet`);
+			} catch {}
 			this.registered = false;
-		}
+		});
 	}
 };
 /**
@@ -398,7 +429,7 @@ var OxyClient = class OxyClient {
 			return response.json();
 		} catch (error) {
 			clearTimeout(timeoutId);
-			if (error.name === "AbortError") throw new Error(`Request timeout after ${this.config.timeout || 3e4}ms`);
+			if (error instanceof Error && error.name === "AbortError") throw new Error(`Request timeout after ${this.config.timeout || 3e4}ms`);
 			throw error;
 		}
 	}
@@ -519,7 +550,7 @@ var OxyClient = class OxyClient {
 	async getFile(filePath) {
 		const pathb64 = this.encodePathBase64(filePath);
 		const query = this.buildQueryParams();
-		return this.request(`/${this.config.projectId}/app/file/${pathb64}${query}`, { headers: { "Accept": "application/octet-stream" } });
+		return this.request(`/${this.config.projectId}/app/file/${pathb64}${query}`, { headers: { Accept: "application/octet-stream" } });
 	}
 	/**
 	* Gets a file URL for direct browser access

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["isInIframe","requestAuthFromParent","duckdb"],"sources":["../src/config.ts","../src/parquet.ts","../src/client.ts"],"sourcesContent":["/**\n * Configuration for the Oxy SDK\n */\nexport interface OxyConfig {\n  /**\n   * Base URL of the Oxy API (e.g., 'https://api.oxy.tech' or 'http://localhost:3000')\n   */\n  baseUrl: string;\n\n  /**\n   * API key for authentication (optional for local development)\n   */\n  apiKey?: string;\n\n  /**\n   * Project ID (UUID)\n   */\n  projectId: string;\n\n  /**\n   * Optional branch name (defaults to current branch if not specified)\n   */\n  branch?: string;\n\n  /**\n   * Request timeout in milliseconds (default: 30000)\n   */\n  timeout?: number;\n\n  /**\n   * Parent window origin for postMessage authentication (iframe scenarios)\n   * Required when using postMessage auth for security.\n   * Example: 'https://app.example.com'\n   * Use '*' only in development!\n   */\n  parentOrigin?: string;\n\n  /**\n   * Disable automatic postMessage authentication even if in iframe\n   * Set to true if you want to provide API key manually in iframe context\n   */\n  disableAutoAuth?: boolean;\n}\n\n/**\n * Creates an Oxy configuration from environment variables\n *\n * Environment variables:\n * - OXY_URL: Base URL of the Oxy API\n * - OXY_API_KEY: API key for authentication\n * - OXY_PROJECT_ID: Project ID (UUID)\n * - OXY_BRANCH: (Optional) Branch name\n *\n * @param overrides - Optional configuration overrides\n * @returns OxyConfig object\n * @throws Error if required environment variables are missing\n */\nexport function createConfig(overrides?: Partial<OxyConfig>): OxyConfig {\n  const baseUrl = overrides?.baseUrl || process.env.OXY_URL;\n  const apiKey = overrides?.apiKey || process.env.OXY_API_KEY;\n  const projectId = overrides?.projectId || process.env.OXY_PROJECT_ID;\n\n  if (!baseUrl) {\n    throw new Error('OXY_URL environment variable or baseUrl config is required');\n  }\n\n  if (!projectId) {\n    throw new Error('OXY_PROJECT_ID environment variable or projectId config is required');\n  }\n\n  return {\n    baseUrl: baseUrl.replace(/\\/$/, ''), // Remove trailing slash\n    apiKey,\n    projectId,\n    branch: overrides?.branch || process.env.OXY_BRANCH,\n    timeout: overrides?.timeout || 30000,\n    parentOrigin: overrides?.parentOrigin,\n    disableAutoAuth: overrides?.disableAutoAuth,\n  };\n}\n\n/**\n * Creates an Oxy configuration asynchronously with support for postMessage authentication\n *\n * This is the recommended method for iframe scenarios where authentication\n * needs to be obtained from the parent window via postMessage.\n *\n * When running in an iframe without an API key, this function will:\n * 1. Detect the iframe context\n * 2. Send an authentication request to the parent window\n * 3. Wait for the parent to respond with credentials\n * 4. Return the configured client\n *\n * Environment variables (fallback):\n * - OXY_URL: Base URL of the Oxy API\n * - OXY_API_KEY: API key for authentication\n * - OXY_PROJECT_ID: Project ID (UUID)\n * - OXY_BRANCH: (Optional) Branch name\n *\n * @param overrides - Optional configuration overrides\n * @returns Promise resolving to OxyConfig object\n * @throws Error if required configuration is missing\n * @throws PostMessageAuthTimeoutError if parent doesn't respond\n *\n * @example\n * ```typescript\n * // Automatic iframe detection and authentication\n * const config = await createConfigAsync({\n *   parentOrigin: 'https://app.example.com',\n *   projectId: 'my-project-id',\n *   baseUrl: 'https://api.oxy.tech'\n * });\n * ```\n */\nexport async function createConfigAsync(\n  overrides?: Partial<OxyConfig>\n): Promise<OxyConfig> {\n  // Import postMessage utilities (dynamic to avoid circular deps)\n  const { isInIframe, requestAuthFromParent } = await import('./auth/postMessage');\n\n  // Start with environment variables and overrides\n  let baseUrl = overrides?.baseUrl || process.env.OXY_URL;\n  let apiKey = overrides?.apiKey || process.env.OXY_API_KEY;\n  let projectId = overrides?.projectId || process.env.OXY_PROJECT_ID;\n\n  const disableAutoAuth = overrides?.disableAutoAuth ?? false;\n  const parentOrigin = overrides?.parentOrigin;\n\n  // Automatic iframe detection and authentication\n  if (!disableAutoAuth && isInIframe() && !apiKey) {\n    if (!parentOrigin) {\n      console.warn(\n        '[Oxy SDK] Running in iframe without API key and no parentOrigin specified. ' +\n        'PostMessage authentication will be skipped. ' +\n        'Provide parentOrigin config to enable automatic authentication.'\n      );\n    } else {\n      try {\n        const authResult = await requestAuthFromParent({\n          parentOrigin,\n          timeout: overrides?.timeout || 5000,\n        });\n\n        apiKey = authResult.apiKey;\n        if (authResult.projectId) {\n          projectId = authResult.projectId;\n        }\n        if (authResult.baseUrl) {\n          baseUrl = authResult.baseUrl;\n        }\n\n        console.log('[Oxy SDK] Successfully authenticated via postMessage');\n      } catch (error) {\n        console.error(\n          '[Oxy SDK] Failed to authenticate via postMessage:',\n          (error as Error).message\n        );\n        // Fall through to use environment variables if available\n      }\n    }\n  }\n\n  // Validation\n  if (!baseUrl) {\n    throw new Error('OXY_URL environment variable or baseUrl config is required');\n  }\n\n  if (!projectId) {\n    throw new Error('OXY_PROJECT_ID environment variable or projectId config is required');\n  }\n\n  return {\n    baseUrl: baseUrl.replace(/\\/$/, ''), // Remove trailing slash\n    apiKey,\n    projectId,\n    branch: overrides?.branch || process.env.OXY_BRANCH,\n    timeout: overrides?.timeout || 30000,\n    parentOrigin,\n    disableAutoAuth,\n  };\n}\n","import * as duckdb from '@duckdb/duckdb-wasm';\n\nlet dbInstance: duckdb.AsyncDuckDB | null = null;\nlet connection: duckdb.AsyncDuckDBConnection | null = null;\n\n/**\n * Initialize DuckDB-WASM instance\n */\nexport async function initializeDuckDB(): Promise<duckdb.AsyncDuckDB> {\n  if (dbInstance) {\n    return dbInstance;\n  }\n\n  const JSDELIVR_BUNDLES = duckdb.getJsDelivrBundles();\n\n  // Select a bundle based on browser features\n  const bundle = await duckdb.selectBundle(JSDELIVR_BUNDLES);\n\n  const worker_url = URL.createObjectURL(\n    new Blob([`importScripts(\"${bundle.mainWorker}\");`], {\n      type: 'text/javascript',\n    })\n  );\n\n  const worker = new Worker(worker_url);\n  const logger = new duckdb.ConsoleLogger();\n\n  dbInstance = new duckdb.AsyncDuckDB(logger, worker);\n  await dbInstance.instantiate(bundle.mainModule, bundle.pthreadWorker);\n  URL.revokeObjectURL(worker_url);\n\n  return dbInstance;\n}\n\n/**\n * Get or create a DuckDB connection\n */\nasync function getConnection(): Promise<duckdb.AsyncDuckDBConnection> {\n  if (connection) {\n    return connection;\n  }\n\n  const db = await initializeDuckDB();\n  connection = await db.connect();\n  return connection;\n}\n\n/**\n * Query result interface\n */\nexport interface QueryResult {\n  columns: string[];\n  rows: any[][];\n  rowCount: number;\n}\n\n/**\n * ParquetReader provides methods to read and query Parquet files\n */\nexport class ParquetReader {\n  private tableName: string;\n  private registered: boolean = false;\n\n  constructor(tableName: string = 'data') {\n    this.tableName = tableName;\n  }\n\n  /**\n   * Register a Parquet file from a Blob\n   *\n   * @param blob - Parquet file as Blob\n   *\n   * @example\n   * ```typescript\n   * const blob = await client.getFile('data/sales.parquet');\n   * const reader = new ParquetReader('sales');\n   * await reader.registerParquet(blob);\n   * ```\n   */\n  async registerParquet(blob: Blob): Promise<void> {\n    const conn = await getConnection();\n    const db = await initializeDuckDB();\n\n    // Convert blob to Uint8Array\n    const arrayBuffer = await blob.arrayBuffer();\n    const uint8Array = new Uint8Array(arrayBuffer);\n\n    // Register the file with DuckDB\n    await db.registerFileBuffer(\n      `${this.tableName}.parquet`,\n      uint8Array\n    );\n\n    // Drop table if it exists\n    try {\n      await conn.query(`DROP TABLE IF EXISTS ${this.tableName}`);\n    } catch (e) {\n      // Ignore error if table doesn't exist\n    }\n\n    // Create table from parquet\n    await conn.query(\n      `CREATE TABLE ${this.tableName} AS SELECT * FROM '${this.tableName}.parquet'`\n    );\n\n    this.registered = true;\n  }\n\n  /**\n   * Execute a SQL query against the registered Parquet data\n   *\n   * @param sql - SQL query string\n   * @returns Query result with columns and rows\n   *\n   * @example\n   * ```typescript\n   * const result = await reader.query('SELECT * FROM sales LIMIT 10');\n   * console.log(result.columns);\n   * console.log(result.rows);\n   * ```\n   */\n  async query(sql: string): Promise<QueryResult> {\n    if (!this.registered) {\n      throw new Error('Parquet file not registered. Call registerParquet() first.');\n    }\n\n    const conn = await getConnection();\n    const result = await conn.query(sql);\n\n    const columns = result.schema.fields.map((field) => field.name);\n    const rows: any[][] = [];\n\n    // Convert Arrow table to rows\n    for (let i = 0; i < result.numRows; i++) {\n      const row: any[] = [];\n      for (let j = 0; j < result.numCols; j++) {\n        const col = result.getChildAt(j);\n        row.push(col?.get(i));\n      }\n      rows.push(row);\n    }\n\n    return {\n      columns,\n      rows,\n      rowCount: result.numRows,\n    };\n  }\n\n  /**\n   * Get all data from the registered table\n   *\n   * @param limit - Maximum number of rows to return (default: all)\n   * @returns Query result\n   *\n   * @example\n   * ```typescript\n   * const allData = await reader.getAll();\n   * const first100 = await reader.getAll(100);\n   * ```\n   */\n  async getAll(limit?: number): Promise<QueryResult> {\n    const limitClause = limit ? ` LIMIT ${limit}` : '';\n    return this.query(`SELECT * FROM ${this.tableName}${limitClause}`);\n  }\n\n  /**\n   * Get table schema information\n   *\n   * @returns Schema information\n   *\n   * @example\n   * ```typescript\n   * const schema = await reader.getSchema();\n   * console.log(schema.columns); // ['id', 'name', 'sales']\n   * console.log(schema.rows);    // [['id', 'INTEGER'], ['name', 'VARCHAR'], ...]\n   * ```\n   */\n  async getSchema(): Promise<QueryResult> {\n    return this.query(`DESCRIBE ${this.tableName}`);\n  }\n\n  /**\n   * Get row count\n   *\n   * @returns Number of rows in the table\n   *\n   * @example\n   * ```typescript\n   * const count = await reader.count();\n   * console.log(`Total rows: ${count}`);\n   * ```\n   */\n  async count(): Promise<number> {\n    const result = await this.query(`SELECT COUNT(*) as count FROM ${this.tableName}`);\n    return result.rows[0][0];\n  }\n\n  /**\n   * Close and cleanup resources\n   */\n  async close(): Promise<void> {\n    if (this.registered) {\n      const conn = await getConnection();\n      const db = await initializeDuckDB();\n\n      // Drop the table\n      try {\n        await conn.query(`DROP TABLE IF EXISTS ${this.tableName}`);\n      } catch (e) {\n        // Ignore error\n      }\n\n      // Drop the registered file buffer\n      try {\n        await db.dropFile(`${this.tableName}.parquet`);\n      } catch (e) {\n        // Ignore error if file doesn't exist\n      }\n\n      this.registered = false;\n    }\n  }\n}\n\n/**\n * Helper function to quickly read a Parquet blob and execute a query\n *\n * @param blob - Parquet file as Blob\n * @param sql - SQL query to execute (optional, defaults to SELECT *)\n * @returns Query result\n *\n * @example\n * ```typescript\n * const blob = await client.getFile('data/sales.parquet');\n * const result = await queryParquet(blob, 'SELECT product, SUM(amount) as total FROM data GROUP BY product');\n * console.log(result);\n * ```\n */\nexport async function queryParquet(\n  blob: Blob,\n  sql?: string\n): Promise<QueryResult> {\n  // Generate unique table name to avoid conflicts\n  const uniqueId = `temp_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;\n  const reader = new ParquetReader(uniqueId);\n\n  await reader.registerParquet(blob);\n\n  const query = sql || `SELECT * FROM ${uniqueId}`;\n  const result = await reader.query(query);\n\n  await reader.close();\n  return result;\n}\n\n/**\n * Helper function to read Parquet file and get all data\n *\n * @param blob - Parquet file as Blob\n * @param limit - Maximum number of rows (optional)\n * @returns Query result\n *\n * @example\n * ```typescript\n * const blob = await client.getFile('data/sales.parquet');\n * const data = await readParquet(blob, 1000);\n * console.log(`Loaded ${data.rowCount} rows`);\n * ```\n */\nexport async function readParquet(\n  blob: Blob,\n  limit?: number\n): Promise<QueryResult> {\n  // Generate unique table name to avoid conflicts\n  const uniqueId = `temp_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;\n  const reader = new ParquetReader(uniqueId);\n\n  await reader.registerParquet(blob);\n\n  const result = await reader.getAll(limit);\n\n  await reader.close();\n  return result;\n}\n","import { OxyConfig, createConfigAsync } from './config';\nimport {\n  AppItem,\n  AppDataResponse,\n  GetDisplaysResponse,\n  ApiError,\n  TableData,\n} from './types';\nimport { readParquet } from './parquet';\n\n/**\n * Oxy API Client for interacting with Oxy data\n */\nexport class OxyClient {\n  private config: OxyConfig;\n\n  constructor(config: OxyConfig) {\n    this.config = config;\n  }\n\n  /**\n   * Creates an OxyClient instance asynchronously with support for postMessage authentication\n   *\n   * This is the recommended method when using the SDK in an iframe that needs to\n   * obtain authentication from the parent window via postMessage.\n   *\n   * @param config - Optional configuration overrides\n   * @returns Promise resolving to OxyClient instance\n   * @throws Error if required configuration is missing\n   * @throws PostMessageAuthTimeoutError if parent doesn't respond\n   *\n   * @example\n   * ```typescript\n   * // In an iframe - automatic postMessage auth\n   * const client = await OxyClient.create({\n   *   parentOrigin: 'https://app.example.com',\n   *   projectId: 'my-project-id',\n   *   baseUrl: 'https://api.oxy.tech'\n   * });\n   *\n   * // Use the client normally\n   * const apps = await client.listApps();\n   * ```\n   */\n  static async create(config?: Partial<OxyConfig>): Promise<OxyClient> {\n    const resolvedConfig = await createConfigAsync(config);\n    return new OxyClient(resolvedConfig);\n  }\n\n  /**\n   * Encodes a file path to base64 for use in API URLs\n   */\n  private encodePathBase64(path: string): string {\n    if (typeof Buffer !== 'undefined') {\n      // Node.js environment\n      return Buffer.from(path).toString('base64');\n    } else {\n      // Browser environment\n      return btoa(path);\n    }\n  }\n\n  /**\n   * Makes an authenticated HTTP request to the Oxy API\n   */\n  private async request<T>(\n    endpoint: string,\n    options: RequestInit = {}\n  ): Promise<T> {\n    const url = `${this.config.baseUrl}${endpoint}`;\n\n    const headers: Record<string, string> = {\n      'Content-Type': 'application/json',\n      ...((options.headers as Record<string, string>) || {}),\n    };\n\n    // Only add Authorization header if API key is provided (optional for local dev)\n    if (this.config.apiKey) {\n      headers['Authorization'] = `Bearer ${this.config.apiKey}`;\n    }\n\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.config.timeout || 30000);\n\n    try {\n      const response = await fetch(url, {\n        ...options,\n        headers,\n        signal: controller.signal,\n      });\n\n      clearTimeout(timeoutId);\n\n      if (!response.ok) {\n        const errorText = await response.text().catch(() => 'Unknown error');\n        const error: ApiError = {\n          message: `API request failed: ${response.statusText}`,\n          status: response.status,\n          details: errorText,\n        };\n        throw error;\n      }\n\n      // Handle binary responses\n      const acceptHeader =\n        typeof options.headers === 'object' && options.headers !== null\n          ? (options.headers as Record<string, string>)['Accept']\n          : undefined;\n      if (acceptHeader === 'application/octet-stream') {\n        return response.blob() as Promise<T>;\n      }\n\n      return response.json();\n    } catch (error: any) {\n      clearTimeout(timeoutId);\n\n      if (error.name === 'AbortError') {\n        throw new Error(`Request timeout after ${this.config.timeout || 30000}ms`);\n      }\n\n      throw error;\n    }\n  }\n\n  /**\n   * Builds query parameters including optional branch\n   */\n  private buildQueryParams(additionalParams: Record<string, string> = {}): string {\n    const params: Record<string, string> = { ...additionalParams };\n\n    if (this.config.branch) {\n      params.branch = this.config.branch;\n    }\n\n    const searchParams = new URLSearchParams(params);\n    const queryString = searchParams.toString();\n    return queryString ? `?${queryString}` : '';\n  }\n\n  /**\n   * Lists all apps in the project\n   *\n   * @returns Array of app items\n   *\n   * @example\n   * ```typescript\n   * const apps = await client.listApps();\n   * console.log('Available apps:', apps);\n   * ```\n   */\n  async listApps(): Promise<AppItem[]> {\n    const query = this.buildQueryParams();\n    return this.request<AppItem[]>(`/${this.config.projectId}/app${query}`);\n  }\n\n  /**\n   * Gets data for a specific app\n   *\n   * @param appPath - Relative path to the app file (e.g., 'my-app.app.yml')\n   * @returns App data response\n   *\n   * @example\n   * ```typescript\n   * const data = await client.getAppData('dashboard.app.yml');\n   * if (data.error) {\n   *   console.error('Error:', data.error);\n   * } else {\n   *   console.log('App data:', data.data);\n   * }\n   * ```\n   */\n  async getAppData(appPath: string): Promise<AppDataResponse> {\n    const pathb64 = this.encodePathBase64(appPath);\n    const query = this.buildQueryParams();\n    return this.request<AppDataResponse>(\n      `/${this.config.projectId}/app/${pathb64}${query}`\n    );\n  }\n\n  /**\n   * Runs an app and returns fresh data (bypasses cache)\n   *\n   * @param appPath - Relative path to the app file\n   * @returns App data response\n   *\n   * @example\n   * ```typescript\n   * const data = await client.runApp('dashboard.app.yml');\n   * console.log('Fresh app data:', data.data);\n   * ```\n   */\n  async runApp(appPath: string): Promise<AppDataResponse> {\n    const pathb64 = this.encodePathBase64(appPath);\n    const query = this.buildQueryParams();\n    return this.request<AppDataResponse>(\n      `/${this.config.projectId}/app/${pathb64}/run${query}`,\n      { method: 'POST' }\n    );\n  }\n\n  /**\n   * Gets display configurations for an app\n   *\n   * @param appPath - Relative path to the app file\n   * @returns Display configurations with potential errors\n   *\n   * @example\n   * ```typescript\n   * const displays = await client.getDisplays('dashboard.app.yml');\n   * displays.displays.forEach(d => {\n   *   if (d.error) {\n   *     console.error('Display error:', d.error);\n   *   } else {\n   *     console.log('Display:', d.display);\n   *   }\n   * });\n   * ```\n   */\n  async getDisplays(appPath: string): Promise<GetDisplaysResponse> {\n    const pathb64 = this.encodePathBase64(appPath);\n    const query = this.buildQueryParams();\n    return this.request<GetDisplaysResponse>(\n      `/${this.config.projectId}/app/${pathb64}/displays${query}`\n    );\n  }\n\n  /**\n   * Gets a file from the app state directory (e.g., generated charts, images)\n   *\n   * This is useful for retrieving generated assets like charts, images, or other\n   * files produced by app workflows and stored in the state directory.\n   *\n   * @param filePath - Relative path to the file in state directory\n   * @returns Blob containing the file data\n   *\n   * @example\n   * ```typescript\n   * // Get a generated chart image\n   * const blob = await client.getFile('charts/sales-chart.png');\n   * const imageUrl = URL.createObjectURL(blob);\n   *\n   * // Use in an img tag\n   * document.querySelector('img').src = imageUrl;\n   * ```\n   *\n   * @example\n   * ```typescript\n   * // Download a file\n   * const blob = await client.getFile('exports/data.csv');\n   * const a = document.createElement('a');\n   * a.href = URL.createObjectURL(blob);\n   * a.download = 'data.csv';\n   * a.click();\n   * ```\n   */\n  async getFile(filePath: string): Promise<Blob> {\n    const pathb64 = this.encodePathBase64(filePath);\n    const query = this.buildQueryParams();\n    return this.request<Blob>(\n      `/${this.config.projectId}/app/file/${pathb64}${query}`,\n      {\n        headers: {\n          'Accept': 'application/octet-stream',\n        },\n      }\n    );\n  }\n\n  /**\n   * Gets a file URL for direct browser access\n   *\n   * This returns a URL that can be used directly in img tags, fetch calls, etc.\n   * The URL includes authentication via query parameters.\n   *\n   * @param filePath - Relative path to the file in state directory\n   * @returns Full URL to the file\n   *\n   * @example\n   * ```typescript\n   * const imageUrl = client.getFileUrl('charts/sales-chart.png');\n   *\n   * // Use directly in img tag (in environments where query-based auth is supported)\n   * document.querySelector('img').src = imageUrl;\n   * ```\n   */\n  getFileUrl(filePath: string): string {\n    const pathb64 = this.encodePathBase64(filePath);\n    const query = this.buildQueryParams();\n    return `${this.config.baseUrl}/${this.config.projectId}/app/file/${pathb64}${query}`;\n  }\n\n  /**\n   * Fetches a parquet file and parses it into table data\n   *\n   * @param filePath - Relative path to the parquet file\n   * @param limit - Maximum number of rows to return (default: 100)\n   * @returns TableData with columns and rows\n   *\n   * @example\n   * ```typescript\n   * const tableData = await client.getTableData('data/sales.parquet', 50);\n   * console.log(tableData.columns);\n   * console.log(tableData.rows);\n   * console.log(`Total rows: ${tableData.total_rows}`);\n   * ```\n   */\n  async getTableData(filePath: string, limit: number = 100): Promise<TableData> {\n    const blob = await this.getFile(filePath);\n    const result = await readParquet(blob, limit);\n\n    return {\n      columns: result.columns,\n      rows: result.rows,\n      total_rows: result.rowCount,\n    };\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["isInIframe","requestAuthFromParent","duckdb"],"sources":["../src/config.ts","../src/parquet.ts","../src/client.ts"],"sourcesContent":["/**\n * Configuration for the Oxy SDK\n */\nexport interface OxyConfig {\n  /**\n   * Base URL of the Oxy API (e.g., 'https://api.oxy.tech' or 'http://localhost:3000')\n   */\n  baseUrl: string;\n\n  /**\n   * API key for authentication (optional for local development)\n   */\n  apiKey?: string;\n\n  /**\n   * Project ID (UUID)\n   */\n  projectId: string;\n\n  /**\n   * Optional branch name (defaults to current branch if not specified)\n   */\n  branch?: string;\n\n  /**\n   * Request timeout in milliseconds (default: 30000)\n   */\n  timeout?: number;\n\n  /**\n   * Parent window origin for postMessage authentication (iframe scenarios)\n   * Required when using postMessage auth for security.\n   * Example: 'https://app.example.com'\n   * Use '*' only in development!\n   */\n  parentOrigin?: string;\n\n  /**\n   * Disable automatic postMessage authentication even if in iframe\n   * Set to true if you want to provide API key manually in iframe context\n   */\n  disableAutoAuth?: boolean;\n}\n\n/**\n * Creates an Oxy configuration from environment variables\n *\n * Environment variables:\n * - OXY_URL: Base URL of the Oxy API\n * - OXY_API_KEY: API key for authentication\n * - OXY_PROJECT_ID: Project ID (UUID)\n * - OXY_BRANCH: (Optional) Branch name\n *\n * @param overrides - Optional configuration overrides\n * @returns OxyConfig object\n * @throws Error if required environment variables are missing\n */\nexport function createConfig(overrides?: Partial<OxyConfig>): OxyConfig {\n  const baseUrl = overrides?.baseUrl || process.env.OXY_URL;\n  const apiKey = overrides?.apiKey || process.env.OXY_API_KEY;\n  const projectId = overrides?.projectId || process.env.OXY_PROJECT_ID;\n\n  if (!baseUrl) {\n    throw new Error(\n      \"OXY_URL environment variable or baseUrl config is required\",\n    );\n  }\n\n  if (!projectId) {\n    throw new Error(\n      \"OXY_PROJECT_ID environment variable or projectId config is required\",\n    );\n  }\n\n  return {\n    baseUrl: baseUrl.replace(/\\/$/, \"\"), // Remove trailing slash\n    apiKey,\n    projectId,\n    branch: overrides?.branch || process.env.OXY_BRANCH,\n    timeout: overrides?.timeout || 30000,\n    parentOrigin: overrides?.parentOrigin,\n    disableAutoAuth: overrides?.disableAutoAuth,\n  };\n}\n\n/**\n * Creates an Oxy configuration asynchronously with support for postMessage authentication\n *\n * This is the recommended method for iframe scenarios where authentication\n * needs to be obtained from the parent window via postMessage.\n *\n * When running in an iframe without an API key, this function will:\n * 1. Detect the iframe context\n * 2. Send an authentication request to the parent window\n * 3. Wait for the parent to respond with credentials\n * 4. Return the configured client\n *\n * Environment variables (fallback):\n * - OXY_URL: Base URL of the Oxy API\n * - OXY_API_KEY: API key for authentication\n * - OXY_PROJECT_ID: Project ID (UUID)\n * - OXY_BRANCH: (Optional) Branch name\n *\n * @param overrides - Optional configuration overrides\n * @returns Promise resolving to OxyConfig object\n * @throws Error if required configuration is missing\n * @throws PostMessageAuthTimeoutError if parent doesn't respond\n *\n * @example\n * ```typescript\n * // Automatic iframe detection and authentication\n * const config = await createConfigAsync({\n *   parentOrigin: 'https://app.example.com',\n *   projectId: 'my-project-id',\n *   baseUrl: 'https://api.oxy.tech'\n * });\n * ```\n */\nexport async function createConfigAsync(\n  overrides?: Partial<OxyConfig>,\n): Promise<OxyConfig> {\n  // Import postMessage utilities (dynamic to avoid circular deps)\n  const { isInIframe } = await import(\"./auth/postMessage\");\n\n  // Start with environment variables and overrides\n  let baseUrl = overrides?.baseUrl || process.env.OXY_URL;\n  let apiKey = overrides?.apiKey || process.env.OXY_API_KEY;\n  let projectId = overrides?.projectId || process.env.OXY_PROJECT_ID;\n\n  const disableAutoAuth = overrides?.disableAutoAuth ?? false;\n  const parentOrigin = overrides?.parentOrigin;\n\n  // Automatic iframe detection and authentication\n  if (!disableAutoAuth && isInIframe() && !apiKey) {\n    if (!parentOrigin) {\n      logWarningAboutMissingParentOrigin();\n    } else {\n      apiKey = await attemptPostMessageAuth(\n        parentOrigin,\n        overrides?.timeout || 5000,\n        apiKey,\n        projectId,\n        baseUrl,\n      )\n        .then((result) => {\n          if (result.projectId) projectId = result.projectId;\n          if (result.baseUrl) baseUrl = result.baseUrl;\n          return result.apiKey;\n        })\n        .catch((error) => {\n          console.error(\n            \"[Oxy SDK] Failed to authenticate via postMessage:\",\n            (error as Error).message,\n          );\n          return apiKey;\n        });\n    }\n  }\n\n  return createFinalConfig(baseUrl, apiKey, projectId, overrides);\n}\n\nfunction logWarningAboutMissingParentOrigin(): void {\n  console.warn(\n    \"[Oxy SDK] Running in iframe without API key and no parentOrigin specified. \" +\n      \"PostMessage authentication will be skipped. \" +\n      \"Provide parentOrigin config to enable automatic authentication.\",\n  );\n}\n\nasync function attemptPostMessageAuth(\n  parentOrigin: string,\n  timeout: number,\n  currentApiKey: string | undefined,\n  currentProjectId: string | undefined,\n  currentBaseUrl: string | undefined,\n): Promise<{ apiKey?: string; projectId?: string; baseUrl?: string }> {\n  const { requestAuthFromParent } = await import(\"./auth/postMessage\");\n  const authResult = await requestAuthFromParent({ parentOrigin, timeout });\n\n  console.log(\"[Oxy SDK] Successfully authenticated via postMessage\");\n\n  return {\n    apiKey: authResult.apiKey || currentApiKey,\n    projectId: authResult.projectId || currentProjectId,\n    baseUrl: authResult.baseUrl || currentBaseUrl,\n  };\n}\n\nfunction createFinalConfig(\n  baseUrl: string | undefined,\n  apiKey: string | undefined,\n  projectId: string | undefined,\n  overrides?: Partial<OxyConfig>,\n): OxyConfig {\n  // Validation\n  if (!baseUrl) {\n    throw new Error(\n      \"OXY_URL environment variable or baseUrl config is required\",\n    );\n  }\n\n  if (!projectId) {\n    throw new Error(\n      \"OXY_PROJECT_ID environment variable or projectId config is required\",\n    );\n  }\n\n  return {\n    baseUrl: baseUrl.replace(/\\/$/, \"\"), // Remove trailing slash\n    apiKey,\n    projectId,\n    branch: overrides?.branch || process.env.OXY_BRANCH,\n    timeout: overrides?.timeout || 30000,\n    parentOrigin: overrides?.parentOrigin,\n    disableAutoAuth: overrides?.disableAutoAuth,\n  };\n}\n","import * as duckdb from \"@duckdb/duckdb-wasm\";\n\nlet dbInstance: duckdb.AsyncDuckDB | null = null;\nlet connection: duckdb.AsyncDuckDBConnection | null = null;\n\n// Queue to serialize operations and prevent race conditions\nlet operationQueue = Promise.resolve();\n\n/**\n * Enqueue an operation to prevent race conditions on shared DuckDB instance\n */\nfunction enqueueOperation<T>(operation: () => Promise<T>): Promise<T> {\n  const currentOperation = operationQueue.then(operation, operation);\n  operationQueue = currentOperation.then(\n    () => {\n      return;\n    },\n    () => {\n      return;\n    },\n  );\n  return currentOperation;\n}\n\n/**\n * Initialize DuckDB-WASM instance\n */\nexport async function initializeDuckDB(): Promise<duckdb.AsyncDuckDB> {\n  if (dbInstance) {\n    return dbInstance;\n  }\n\n  const JSDELIVR_BUNDLES = duckdb.getJsDelivrBundles();\n\n  // Select a bundle based on browser features\n  const bundle = await duckdb.selectBundle(JSDELIVR_BUNDLES);\n\n  const worker_url = URL.createObjectURL(\n    new Blob([`importScripts(\"${bundle.mainWorker}\");`], {\n      type: \"text/javascript\",\n    }),\n  );\n\n  const worker = new Worker(worker_url);\n  const logger = new duckdb.ConsoleLogger();\n\n  dbInstance = new duckdb.AsyncDuckDB(logger, worker);\n  await dbInstance.instantiate(bundle.mainModule, bundle.pthreadWorker);\n  URL.revokeObjectURL(worker_url);\n\n  return dbInstance;\n}\n\n/**\n * Get or create a DuckDB connection\n */\nasync function getConnection(): Promise<duckdb.AsyncDuckDBConnection> {\n  if (connection) {\n    return connection;\n  }\n\n  const db = await initializeDuckDB();\n  connection = await db.connect();\n  return connection;\n}\n\n/**\n * Query result interface\n */\nexport interface QueryResult {\n  columns: string[];\n  rows: unknown[][];\n  rowCount: number;\n}\n\n/**\n * ParquetReader provides methods to read and query Parquet files\n */\nexport class ParquetReader {\n  private tableName: string;\n  private internalTableName: string;\n  private registered: boolean = false;\n\n  constructor(tableName: string = \"data\") {\n    this.tableName = tableName;\n    // Generate unique internal table name to prevent conflicts between concurrent instances\n    // Note: Math.random() is acceptable here as uniqueness is only needed for table naming (not security-critical)\n    /* eslint-disable sonarjs/pseudo-random */\n    const uniqueId = `${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;\n    /* eslint-enable sonarjs/pseudo-random */\n    this.internalTableName = `${tableName}_${uniqueId}`;\n  }\n\n  /**\n   * Register a Parquet file from a Blob\n   *\n   * @param blob - Parquet file as Blob\n   *\n   * @example\n   * ```typescript\n   * const blob = await client.getFile('data/sales.parquet');\n   * const reader = new ParquetReader('sales');\n   * await reader.registerParquet(blob);\n   * ```\n   */\n  async registerParquet(blob: Blob): Promise<void> {\n    await enqueueOperation(async () => {\n      const conn = await getConnection();\n      const db = await initializeDuckDB();\n\n      // Convert blob to Uint8Array\n      const arrayBuffer = await blob.arrayBuffer();\n      const uint8Array = new Uint8Array(arrayBuffer);\n\n      // Register the file with DuckDB using unique name\n      await db.registerFileBuffer(\n        `${this.internalTableName}.parquet`,\n        uint8Array,\n      );\n\n      // Drop table if it exists\n      try {\n        await conn.query(`DROP TABLE IF EXISTS ${this.internalTableName}`);\n      } catch {\n        // Ignore error if table doesn't exist\n      }\n\n      // Create table from parquet\n      await conn.query(\n        `CREATE TABLE ${this.internalTableName} AS SELECT * FROM '${this.internalTableName}.parquet'`,\n      );\n\n      this.registered = true;\n    });\n  }\n\n  /**\n   * Execute a SQL query against the registered Parquet data\n   *\n   * @param sql - SQL query string\n   * @returns Query result with columns and rows\n   *\n   * @example\n   * ```typescript\n   * const result = await reader.query('SELECT * FROM sales LIMIT 10');\n   * console.log(result.columns);\n   * console.log(result.rows);\n   * ```\n   */\n  async query(sql: string): Promise<QueryResult> {\n    if (!this.registered) {\n      throw new Error(\n        \"Parquet file not registered. Call registerParquet() first.\",\n      );\n    }\n\n    return enqueueOperation(async () => {\n      const conn = await getConnection();\n\n      // Replace user's table name with internal unique table name\n      const rewrittenSql = sql.replace(\n        new RegExp(`\\\\b${this.tableName}\\\\b`, \"g\"),\n        this.internalTableName,\n      );\n\n      const result = await conn.query(rewrittenSql);\n\n      const columns = result.schema.fields.map((field) => field.name);\n      const rows: unknown[][] = [];\n\n      // Convert Arrow table to rows\n      for (let i = 0; i < result.numRows; i++) {\n        const row: unknown[] = [];\n        for (let j = 0; j < result.numCols; j++) {\n          const col = result.getChildAt(j);\n          row.push(col?.get(i));\n        }\n        rows.push(row);\n      }\n\n      return {\n        columns,\n        rows,\n        rowCount: result.numRows,\n      };\n    });\n  }\n\n  /**\n   * Get all data from the registered table\n   *\n   * @param limit - Maximum number of rows to return (default: all)\n   * @returns Query result\n   *\n   * @example\n   * ```typescript\n   * const allData = await reader.getAll();\n   * const first100 = await reader.getAll(100);\n   * ```\n   */\n  async getAll(limit?: number): Promise<QueryResult> {\n    const limitClause = limit ? ` LIMIT ${limit}` : \"\";\n    return this.query(`SELECT * FROM ${this.tableName}${limitClause}`);\n  }\n\n  /**\n   * Get table schema information\n   *\n   * @returns Schema information\n   *\n   * @example\n   * ```typescript\n   * const schema = await reader.getSchema();\n   * console.log(schema.columns); // ['id', 'name', 'sales']\n   * console.log(schema.rows);    // [['id', 'INTEGER'], ['name', 'VARCHAR'], ...]\n   * ```\n   */\n  async getSchema(): Promise<QueryResult> {\n    return this.query(`DESCRIBE ${this.tableName}`);\n  }\n\n  /**\n   * Get row count\n   *\n   * @returns Number of rows in the table\n   *\n   * @example\n   * ```typescript\n   * const count = await reader.count();\n   * console.log(`Total rows: ${count}`);\n   * ```\n   */\n  async count(): Promise<number> {\n    const result = await this.query(\n      `SELECT COUNT(*) as count FROM ${this.tableName}`,\n    );\n    return result.rows[0][0] as number;\n  }\n\n  /**\n   * Close and cleanup resources\n   */\n  async close(): Promise<void> {\n    if (this.registered) {\n      await enqueueOperation(async () => {\n        const conn = await getConnection();\n        const db = await initializeDuckDB();\n\n        // Drop the table using internal unique name\n        try {\n          await conn.query(`DROP TABLE IF EXISTS ${this.internalTableName}`);\n        } catch {\n          // Ignore error\n        }\n\n        // Drop the registered file buffer using internal unique name\n        try {\n          await db.dropFile(`${this.internalTableName}.parquet`);\n        } catch {\n          // Ignore error if file doesn't exist\n        }\n\n        this.registered = false;\n      });\n    }\n  }\n}\n\n/**\n * Helper function to quickly read a Parquet blob and execute a query\n *\n * @param blob - Parquet file as Blob\n * @param sql - SQL query to execute (optional, defaults to SELECT *)\n * @returns Query result\n *\n * @example\n * ```typescript\n * const blob = await client.getFile('data/sales.parquet');\n * const result = await queryParquet(blob, 'SELECT product, SUM(amount) as total FROM data GROUP BY product');\n * console.log(result);\n * ```\n */\nexport async function queryParquet(\n  blob: Blob,\n  sql?: string,\n): Promise<QueryResult> {\n  // Generate unique table name to avoid conflicts\n  // Note: Math.random() is acceptable here as uniqueness is only needed for table naming (not security-critical)\n  /* eslint-disable sonarjs/pseudo-random */\n  const uniqueId = `temp_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;\n  /* eslint-enable sonarjs/pseudo-random */\n  const reader = new ParquetReader(uniqueId);\n\n  await reader.registerParquet(blob);\n\n  const query = sql || `SELECT * FROM ${uniqueId}`;\n  const result = await reader.query(query);\n\n  await reader.close();\n  return result;\n}\n\n/**\n * Helper function to read Parquet file and get all data\n *\n * @param blob - Parquet file as Blob\n * @param limit - Maximum number of rows (optional)\n * @returns Query result\n *\n * @example\n * ```typescript\n * const blob = await client.getFile('data/sales.parquet');\n * const data = await readParquet(blob, 1000);\n * console.log(`Loaded ${data.rowCount} rows`);\n * ```\n */\nexport async function readParquet(\n  blob: Blob,\n  limit?: number,\n): Promise<QueryResult> {\n  // Generate unique table name to avoid conflicts\n  // Note: Math.random() is acceptable here as uniqueness is only needed for table naming (not security-critical)\n  /* eslint-disable sonarjs/pseudo-random */\n  const uniqueId = `temp_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;\n  /* eslint-enable sonarjs/pseudo-random */\n  const reader = new ParquetReader(uniqueId);\n\n  await reader.registerParquet(blob);\n\n  const result = await reader.getAll(limit);\n\n  await reader.close();\n  return result;\n}\n","import { OxyConfig, createConfigAsync } from \"./config\";\nimport {\n  AppItem,\n  AppDataResponse,\n  GetDisplaysResponse,\n  ApiError,\n  TableData,\n} from \"./types\";\nimport { readParquet } from \"./parquet\";\n\n/**\n * Oxy API Client for interacting with Oxy data\n */\nexport class OxyClient {\n  private config: OxyConfig;\n\n  constructor(config: OxyConfig) {\n    this.config = config;\n  }\n\n  /**\n   * Creates an OxyClient instance asynchronously with support for postMessage authentication\n   *\n   * This is the recommended method when using the SDK in an iframe that needs to\n   * obtain authentication from the parent window via postMessage.\n   *\n   * @param config - Optional configuration overrides\n   * @returns Promise resolving to OxyClient instance\n   * @throws Error if required configuration is missing\n   * @throws PostMessageAuthTimeoutError if parent doesn't respond\n   *\n   * @example\n   * ```typescript\n   * // In an iframe - automatic postMessage auth\n   * const client = await OxyClient.create({\n   *   parentOrigin: 'https://app.example.com',\n   *   projectId: 'my-project-id',\n   *   baseUrl: 'https://api.oxy.tech'\n   * });\n   *\n   * // Use the client normally\n   * const apps = await client.listApps();\n   * ```\n   */\n  static async create(config?: Partial<OxyConfig>): Promise<OxyClient> {\n    const resolvedConfig = await createConfigAsync(config);\n    return new OxyClient(resolvedConfig);\n  }\n\n  /**\n   * Encodes a file path to base64 for use in API URLs\n   */\n  private encodePathBase64(path: string): string {\n    if (typeof Buffer !== \"undefined\") {\n      // Node.js environment\n      return Buffer.from(path).toString(\"base64\");\n    } else {\n      // Browser environment\n      return btoa(path);\n    }\n  }\n\n  /**\n   * Makes an authenticated HTTP request to the Oxy API\n   */\n  private async request<T>(\n    endpoint: string,\n    options: RequestInit = {},\n  ): Promise<T> {\n    const url = `${this.config.baseUrl}${endpoint}`;\n\n    const headers: Record<string, string> = {\n      \"Content-Type\": \"application/json\",\n      ...((options.headers as Record<string, string>) || {}),\n    };\n\n    // Only add Authorization header if API key is provided (optional for local dev)\n    if (this.config.apiKey) {\n      headers[\"Authorization\"] = `Bearer ${this.config.apiKey}`;\n    }\n\n    const controller = new AbortController();\n    const timeoutId = setTimeout(\n      () => controller.abort(),\n      this.config.timeout || 30000,\n    );\n\n    try {\n      const response = await fetch(url, {\n        ...options,\n        headers,\n        signal: controller.signal,\n      });\n\n      clearTimeout(timeoutId);\n\n      if (!response.ok) {\n        const errorText = await response.text().catch(() => \"Unknown error\");\n        const error: ApiError = {\n          message: `API request failed: ${response.statusText}`,\n          status: response.status,\n          details: errorText,\n        };\n        throw error;\n      }\n\n      // Handle binary responses\n      const acceptHeader =\n        typeof options.headers === \"object\" && options.headers !== null\n          ? (options.headers as Record<string, string>)[\"Accept\"]\n          : undefined;\n      if (acceptHeader === \"application/octet-stream\") {\n        return response.blob() as Promise<T>;\n      }\n\n      return response.json();\n    } catch (error: unknown) {\n      clearTimeout(timeoutId);\n\n      if (error instanceof Error && error.name === \"AbortError\") {\n        throw new Error(\n          `Request timeout after ${this.config.timeout || 30000}ms`,\n        );\n      }\n\n      throw error;\n    }\n  }\n\n  /**\n   * Builds query parameters including optional branch\n   */\n  private buildQueryParams(\n    additionalParams: Record<string, string> = {},\n  ): string {\n    const params: Record<string, string> = { ...additionalParams };\n\n    if (this.config.branch) {\n      params.branch = this.config.branch;\n    }\n\n    const searchParams = new URLSearchParams(params);\n    const queryString = searchParams.toString();\n    return queryString ? `?${queryString}` : \"\";\n  }\n\n  /**\n   * Lists all apps in the project\n   *\n   * @returns Array of app items\n   *\n   * @example\n   * ```typescript\n   * const apps = await client.listApps();\n   * console.log('Available apps:', apps);\n   * ```\n   */\n  async listApps(): Promise<AppItem[]> {\n    const query = this.buildQueryParams();\n    return this.request<AppItem[]>(`/${this.config.projectId}/app${query}`);\n  }\n\n  /**\n   * Gets data for a specific app\n   *\n   * @param appPath - Relative path to the app file (e.g., 'my-app.app.yml')\n   * @returns App data response\n   *\n   * @example\n   * ```typescript\n   * const data = await client.getAppData('dashboard.app.yml');\n   * if (data.error) {\n   *   console.error('Error:', data.error);\n   * } else {\n   *   console.log('App data:', data.data);\n   * }\n   * ```\n   */\n  async getAppData(appPath: string): Promise<AppDataResponse> {\n    const pathb64 = this.encodePathBase64(appPath);\n    const query = this.buildQueryParams();\n    return this.request<AppDataResponse>(\n      `/${this.config.projectId}/app/${pathb64}${query}`,\n    );\n  }\n\n  /**\n   * Runs an app and returns fresh data (bypasses cache)\n   *\n   * @param appPath - Relative path to the app file\n   * @returns App data response\n   *\n   * @example\n   * ```typescript\n   * const data = await client.runApp('dashboard.app.yml');\n   * console.log('Fresh app data:', data.data);\n   * ```\n   */\n  async runApp(appPath: string): Promise<AppDataResponse> {\n    const pathb64 = this.encodePathBase64(appPath);\n    const query = this.buildQueryParams();\n    return this.request<AppDataResponse>(\n      `/${this.config.projectId}/app/${pathb64}/run${query}`,\n      { method: \"POST\" },\n    );\n  }\n\n  /**\n   * Gets display configurations for an app\n   *\n   * @param appPath - Relative path to the app file\n   * @returns Display configurations with potential errors\n   *\n   * @example\n   * ```typescript\n   * const displays = await client.getDisplays('dashboard.app.yml');\n   * displays.displays.forEach(d => {\n   *   if (d.error) {\n   *     console.error('Display error:', d.error);\n   *   } else {\n   *     console.log('Display:', d.display);\n   *   }\n   * });\n   * ```\n   */\n  async getDisplays(appPath: string): Promise<GetDisplaysResponse> {\n    const pathb64 = this.encodePathBase64(appPath);\n    const query = this.buildQueryParams();\n    return this.request<GetDisplaysResponse>(\n      `/${this.config.projectId}/app/${pathb64}/displays${query}`,\n    );\n  }\n\n  /**\n   * Gets a file from the app state directory (e.g., generated charts, images)\n   *\n   * This is useful for retrieving generated assets like charts, images, or other\n   * files produced by app workflows and stored in the state directory.\n   *\n   * @param filePath - Relative path to the file in state directory\n   * @returns Blob containing the file data\n   *\n   * @example\n   * ```typescript\n   * // Get a generated chart image\n   * const blob = await client.getFile('charts/sales-chart.png');\n   * const imageUrl = URL.createObjectURL(blob);\n   *\n   * // Use in an img tag\n   * document.querySelector('img').src = imageUrl;\n   * ```\n   *\n   * @example\n   * ```typescript\n   * // Download a file\n   * const blob = await client.getFile('exports/data.csv');\n   * const a = document.createElement('a');\n   * a.href = URL.createObjectURL(blob);\n   * a.download = 'data.csv';\n   * a.click();\n   * ```\n   */\n  async getFile(filePath: string): Promise<Blob> {\n    const pathb64 = this.encodePathBase64(filePath);\n    const query = this.buildQueryParams();\n    return this.request<Blob>(\n      `/${this.config.projectId}/app/file/${pathb64}${query}`,\n      {\n        headers: {\n          Accept: \"application/octet-stream\",\n        },\n      },\n    );\n  }\n\n  /**\n   * Gets a file URL for direct browser access\n   *\n   * This returns a URL that can be used directly in img tags, fetch calls, etc.\n   * The URL includes authentication via query parameters.\n   *\n   * @param filePath - Relative path to the file in state directory\n   * @returns Full URL to the file\n   *\n   * @example\n   * ```typescript\n   * const imageUrl = client.getFileUrl('charts/sales-chart.png');\n   *\n   * // Use directly in img tag (in environments where query-based auth is supported)\n   * document.querySelector('img').src = imageUrl;\n   * ```\n   */\n  getFileUrl(filePath: string): string {\n    const pathb64 = this.encodePathBase64(filePath);\n    const query = this.buildQueryParams();\n    return `${this.config.baseUrl}/${this.config.projectId}/app/file/${pathb64}${query}`;\n  }\n\n  /**\n   * Fetches a parquet file and parses it into table data\n   *\n   * @param filePath - Relative path to the parquet file\n   * @param limit - Maximum number of rows to return (default: 100)\n   * @returns TableData with columns and rows\n   *\n   * @example\n   * ```typescript\n   * const tableData = await client.getTableData('data/sales.parquet', 50);\n   * console.log(tableData.columns);\n   * console.log(tableData.rows);\n   * console.log(`Total rows: ${tableData.total_rows}`);\n   * ```\n   */\n  async getTableData(\n    filePath: string,\n    limit: number = 100,\n  ): Promise<TableData> {\n    const blob = await this.getFile(filePath);\n    const result = await readParquet(blob, limit);\n\n    return {\n      columns: result.columns,\n      rows: result.rows,\n      total_rows: result.rowCount,\n    };\n  }\n}\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -108,7 +108,7 @@ interface FileReference {
  */
 interface TableData {
   columns: string[];
-  rows: any[][];
+  rows: unknown[][];
   total_rows?: number;
 }
 type DataContainer = Record<string, FileReference>;
@@ -131,7 +131,7 @@ interface DisplayWithError {
  */
 interface DisplayData {
   type: string;
-  content: any;
+  content: unknown;
 }
 /**
  * Response from get displays endpoint
@@ -144,7 +144,7 @@ interface GetDisplaysResponse {
  */
 interface QueryResult$1 {
   columns: string[];
-  rows: any[][];
+  rows: unknown[][];
   rowCount: number;
 }
 /**
@@ -154,8 +154,8 @@ interface QueryResult$1 {
  * Request message sent from iframe to parent window
  */
 interface OxyAuthRequestMessage {
-  type: 'OXY_AUTH_REQUEST';
-  version: '1.0';
+  type: "OXY_AUTH_REQUEST";
+  version: "1.0";
   timestamp: number;
   requestId: string;
 }
@@ -163,8 +163,8 @@ interface OxyAuthRequestMessage {
  * Response message sent from parent window to iframe
  */
 interface OxyAuthResponseMessage {
-  type: 'OXY_AUTH_RESPONSE';
-  version: '1.0';
+  type: "OXY_AUTH_RESPONSE";
+  version: "1.0";
   requestId: string;
   apiKey?: string;
   projectId?: string;
@@ -188,7 +188,7 @@ interface PostMessageAuthResult {
   apiKey?: string;
   projectId?: string;
   baseUrl?: string;
-  source: 'postmessage';
+  source: "postmessage";
 }
 /**
  * Custom error classes for postMessage authentication
@@ -399,7 +399,7 @@ declare function initializeDuckDB(): Promise<duckdb.AsyncDuckDB>;
  */
 interface QueryResult {
   columns: string[];
-  rows: any[][];
+  rows: unknown[][];
   rowCount: number;
 }
 /**
@@ -407,6 +407,7 @@ interface QueryResult {
  */
 declare class ParquetReader {
   private tableName;
+  private internalTableName;
   private registered;
   constructor(tableName?: string);
   /**

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/config.ts","../src/types.ts","../src/client.ts","../src/parquet.ts","../src/auth/postMessage.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/config.ts","../src/types.ts","../src/client.ts","../src/parquet.ts","../src/auth/postMessage.ts"],"sourcesContent":[],"mappings":"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"}