hazo_connect 1.0.0

package/dist/__tests__/factory.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=factory.test.d.ts.map

package/dist/__tests__/factory.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.test.d.ts","sourceRoot":"","sources":["../../src/lib/__tests__/factory.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/factory.test.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// factory.test.ts verifies the createHazoConnect factory behavior across configuration inputs.
+const factory_1 = require("../factory");
+const postgrest_adapter_1 = require("../adapters/postgrest-adapter");
+describe("createHazoConnect", () => {
+    it("returns a PostgrestAdapter when using a config provider", async () => {
+        const base_url = process.env.POSTGREST_URL;
+        const config_provider = {
+            get: (section, key) => {
+                if (section === "postgrest" && key === "base_url") {
+                    return base_url;
+                }
+                return undefined;
+            },
+            getSection: (section) => {
+                if (section === "postgrest") {
+                    return { base_url };
+                }
+                return undefined;
+            }
+        };
+        const adapter = (0, factory_1.createHazoConnect)({
+            type: "postgrest",
+            configProvider: config_provider
+        });
+        expect(adapter).toBeInstanceOf(postgrest_adapter_1.PostgrestAdapter);
+        const adapter_config = await adapter.getConfig();
+        expect(adapter_config.base_url).toBe(base_url);
+        expect(adapter_config.api_key).toBe(process.env.POSTGREST_API_KEY);
+    });
+    it("merges direct config with environment API key", async () => {
+        const base_url = process.env.POSTGREST_URL;
+        const adapter = (0, factory_1.createHazoConnect)({
+            type: "postgrest",
+            postgrest: {
+                base_url
+            }
+        });
+        const adapter_config = await adapter.getConfig();
+        expect(adapter_config.base_url).toBe(base_url);
+        expect(adapter_config.api_key).toBe(process.env.POSTGREST_API_KEY);
+    });
+});
+//# sourceMappingURL=factory.test.js.map

package/dist/__tests__/factory.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.test.js","sourceRoot":"","sources":["../../src/lib/__tests__/factory.test.ts"],"names":[],"mappings":";;AAAA,+FAA+F;AAC/F,wCAA+C;AAC/C,qEAAiE;AAEjE,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,aAAuB,CAAC;QAErD,MAAM,eAAe,GAAG;YACtB,GAAG,EAAE,CAAC,OAAe,EAAE,GAAW,EAAE,EAAE;gBACpC,IAAI,OAAO,KAAK,WAAW,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;oBAClD,OAAO,QAAQ,CAAC;gBAClB,CAAC;gBACD,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,UAAU,EAAE,CAAC,OAAe,EAAE,EAAE;gBAC9B,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;oBAC5B,OAAO,EAAE,QAAQ,EAAE,CAAC;gBACtB,CAAC;gBACD,OAAO,SAAS,CAAC;YACnB,CAAC;SACF,CAAC;QAEF,MAAM,OAAO,GAAG,IAAA,2BAAiB,EAAC;YAChC,IAAI,EAAE,WAAW;YACjB,cAAc,EAAE,eAAsB;SACvC,CAAC,CAAC;QAEH,MAAM,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,oCAAgB,CAAC,CAAC;QACjD,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC;QACjD,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/C,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,aAAuB,CAAC;QAErD,MAAM,OAAO,GAAG,IAAA,2BAAiB,EAAC;YAChC,IAAI,EAAE,WAAW;YACjB,SAAS,EAAE;gBACT,QAAQ;aACT;SACF,CAAC,CAAC;QAEH,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC;QACjD,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/C,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/postgrest_adapter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=postgrest_adapter.test.d.ts.map

package/dist/__tests__/postgrest_adapter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgrest_adapter.test.d.ts","sourceRoot":"","sources":["../../src/lib/__tests__/postgrest_adapter.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/postgrest_adapter.test.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// postgrest_adapter.test.ts ensures PostgREST adapter surfaces helpful error messages.
+const postgrest_adapter_1 = require("../adapters/postgrest-adapter");
+const originalFetch = global.fetch;
+const buildAdapter = () => new postgrest_adapter_1.PostgrestAdapter({
+    postgrest: {
+        base_url: "https://example.supabase.co/rest/v1",
+        api_key: "valid-key"
+    }
+});
+describe("PostgrestAdapter error handling", () => {
+    afterEach(() => {
+        global.fetch = originalFetch;
+    });
+    it("produces a descriptive message when the table is missing", async () => {
+        const mockResponse = {
+            ok: false,
+            status: 404,
+            statusText: "Not Found",
+            text: jest.fn().mockResolvedValue(JSON.stringify({
+                message: "relation \"missing_table\" does not exist"
+            }))
+        };
+        const fetchMock = jest.fn().mockResolvedValue(mockResponse);
+        global.fetch = fetchMock;
+        const adapter = buildAdapter();
+        await expect(adapter.rawQuery("/missing_table", { method: "GET" })).rejects.toThrow("PostgREST could not find resource 'missing_table'");
+        expect(fetchMock).toHaveBeenCalledTimes(1);
+    });
+});
+//# sourceMappingURL=postgrest_adapter.test.js.map

package/dist/__tests__/postgrest_adapter.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgrest_adapter.test.js","sourceRoot":"","sources":["../../src/lib/__tests__/postgrest_adapter.test.ts"],"names":[],"mappings":";;AAAA,uFAAuF;AACvF,qEAAiE;AAEjE,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC;AAEnC,MAAM,YAAY,GAAG,GAAG,EAAE,CACxB,IAAI,oCAAgB,CAAC;IACnB,SAAS,EAAE;QACT,QAAQ,EAAE,qCAAqC;QAC/C,OAAO,EAAE,WAAW;KACrB;CACF,CAAC,CAAC;AAEL,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC/C,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,CAAC,KAAK,GAAG,aAAa,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,YAAY,GAAG;YACnB,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,GAAG;YACX,UAAU,EAAE,WAAW;YACvB,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAC/B,IAAI,CAAC,SAAS,CAAC;gBACb,OAAO,EAAE,2CAA2C;aACrD,CAAC,CACH;SACF,CAAC;QAEF,MAAM,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,YAAmB,CAAC,CAAC;QAClE,MAAc,CAAC,KAAK,GAAG,SAAS,CAAC;QAElC,MAAM,OAAO,GAAG,YAAY,EAAE,CAAC;QAE/B,MAAM,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CACjF,mDAAmD,CACpD,CAAC;QAEF,MAAM,CAAC,SAAS,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/query_builder.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=query_builder.test.d.ts.map

package/dist/__tests__/query_builder.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query_builder.test.d.ts","sourceRoot":"","sources":["../../src/lib/__tests__/query_builder.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/query_builder.test.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// query_builder.test.ts validates QueryBuilder behaviors for select and join configuration.
+const query_builder_1 = require("../query-builder");
+const query_settings_1 = require("../../../tests/config/query_settings");
+describe("QueryBuilder", () => {
+    it("persists the configured table and selection values", () => {
+        const tableName = query_settings_1.test_table_name || "example_table";
+        const builder = new query_builder_1.QueryBuilder()
+            .from(tableName)
+            .select(["id", "name"])
+            .limit(25)
+            .offset(5);
+        expect(builder.getTable()).toBe(tableName);
+        expect(builder.getSelectFields()).toEqual(["id", "name"]);
+        expect(builder.getLimit()).toBe(25);
+        expect(builder.getOffset()).toBe(5);
+    });
+    it("records join metadata using the configured values", () => {
+        const tableName = query_settings_1.test_table_name || "example_table";
+        const joinTable = query_settings_1.test_join_table || "related_items";
+        const joinCondition = query_settings_1.test_join_condition || `${joinTable}.parent_id=${tableName}.id`;
+        const builder = new query_builder_1.QueryBuilder()
+            .from(tableName)
+            .join(joinTable, joinCondition, "left");
+        const joins = builder.getJoins();
+        expect(joins).toHaveLength(1);
+        expect(joins[0]).toEqual({
+            table: joinTable,
+            on: joinCondition,
+            type: "left"
+        });
+    });
+});
+//# sourceMappingURL=query_builder.test.js.map

package/dist/__tests__/query_builder.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query_builder.test.js","sourceRoot":"","sources":["../../src/lib/__tests__/query_builder.test.ts"],"names":[],"mappings":";;AAAA,4FAA4F;AAC5F,oDAAgD;AAChD,yEAA6G;AAE7G,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,SAAS,GAAG,gCAAe,IAAI,eAAe,CAAC;QACrD,MAAM,OAAO,GAAG,IAAI,4BAAY,EAAE;aAC/B,IAAI,CAAC,SAAS,CAAC;aACf,MAAM,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;aACtB,KAAK,CAAC,EAAE,CAAC;aACT,MAAM,CAAC,CAAC,CAAC,CAAC;QAEb,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3C,MAAM,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QAC1D,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,SAAS,GAAG,gCAAe,IAAI,eAAe,CAAC;QACrD,MAAM,SAAS,GAAG,gCAAe,IAAI,eAAe,CAAC;QACrD,MAAM,aAAa,GACjB,oCAAmB,IAAI,GAAG,SAAS,cAAc,SAAS,KAAK,CAAC;QAElE,MAAM,OAAO,GAAG,IAAI,4BAAY,EAAE;aAC/B,IAAI,CAAC,SAAS,CAAC;aACf,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;QAE1C,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QACjC,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YACvB,KAAK,EAAE,SAAS;YAChB,EAAE,EAAE,aAAa;YACjB,IAAI,EAAE,MAAM;SACb,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/adapters/base-adapter.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Purpose: Abstract base adapter class with common error handling
+ *
+ * This file provides a base class for all database adapters.
+ * Includes common error handling and optional logger support.
+ * Zero dependencies - only Node.js built-ins and types.
+ */
+import type { Logger, HazoConnectError } from '../types';
+import { ErrorCode } from '../types';
+/**
+ * Abstract base adapter class
+ * All adapters should extend this class
+ */
+export declare abstract class BaseAdapter {
+    protected logger: Logger;
+    protected config: any;
+    /**
+     * Constructor
+     * @param config - Adapter-specific configuration
+     * @param logger - Optional logger instance
+     */
+    constructor(config: any, logger?: Logger);
+    /**
+     * Create a standardized error object
+     * @param code - Error code
+     * @param message - Error message
+     * @param statusCode - Optional HTTP status code
+     * @param originalError - Optional original error
+     * @returns HazoConnectError object
+     */
+    protected createError(code: ErrorCode, message: string, statusCode?: number, originalError?: any): HazoConnectError;
+    /**
+     * Throw a standardized error
+     * @param code - Error code
+     * @param message - Error message
+     * @param statusCode - Optional HTTP status code
+     * @param originalError - Optional original error
+     */
+    protected throwError(code: ErrorCode, message: string, statusCode?: number, originalError?: any): never;
+    /**
+     * Detect if an error is a connection failure
+     * @param error - Error to check
+     * @returns True if connection failure
+     */
+    protected isConnectionError(error: any): boolean;
+    /**
+     * Handle connection errors
+     * @param error - Error to handle
+     */
+    protected handleConnectionError(error: any): never;
+    /**
+     * Validate configuration
+     * @param requiredFields - Array of required field names
+     * @throws Error if validation fails
+     */
+    protected validateConfig(requiredFields: string[]): void;
+    /**
+     * Log a query operation
+     * @param operation - Operation name
+     * @param details - Operation details
+     */
+    protected logQuery(operation: string, details: any): void;
+    /**
+     * Get the adapter's configuration
+     * @returns Promise with adapter-specific config
+     */
+    abstract getConfig(): Promise<any>;
+}
+//# sourceMappingURL=base-adapter.d.ts.map

package/dist/adapters/base-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-adapter.d.ts","sourceRoot":"","sources":["../../src/lib/adapters/base-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AACxD,OAAO,EAAc,SAAS,EAAE,MAAM,UAAU,CAAA;AAEhD;;;GAGG;AACH,8BAAsB,WAAW;IAC/B,SAAS,CAAC,MAAM,EAAE,MAAM,CAAA;IACxB,SAAS,CAAC,MAAM,EAAE,GAAG,CAAA;IAErB;;;;OAIG;gBACS,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM;IAKxC;;;;;;;OAOG;IACH,SAAS,CAAC,WAAW,CACnB,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,GAAG,GAClB,gBAAgB;IAsBnB;;;;;;OAMG;IACH,SAAS,CAAC,UAAU,CAClB,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,GAAG,GAClB,KAAK;IAaR;;;;OAIG;IACH,SAAS,CAAC,iBAAiB,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO;IAahD;;;OAGG;IACH,SAAS,CAAC,qBAAqB,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK;IAYlD;;;;OAIG;IACH,SAAS,CAAC,cAAc,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,IAAI;IAWxD;;;;OAIG;IACH,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI;IAOzD;;;OAGG;IACH,QAAQ,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC;CACnC"}

package/dist/adapters/base-adapter.js

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * Purpose: Abstract base adapter class with common error handling
+ *
+ * This file provides a base class for all database adapters.
+ * Includes common error handling and optional logger support.
+ * Zero dependencies - only Node.js built-ins and types.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseAdapter = void 0;
+const types_1 = require("../types");
+/**
+ * Abstract base adapter class
+ * All adapters should extend this class
+ */
+class BaseAdapter {
+    /**
+     * Constructor
+     * @param config - Adapter-specific configuration
+     * @param logger - Optional logger instance
+     */
+    constructor(config, logger) {
+        this.config = config;
+        this.logger = logger || types_1.noOpLogger;
+    }
+    /**
+     * Create a standardized error object
+     * @param code - Error code
+     * @param message - Error message
+     * @param statusCode - Optional HTTP status code
+     * @param originalError - Optional original error
+     * @returns HazoConnectError object
+     */
+    createError(code, message, statusCode, originalError) {
+        // Convert enum to string to ensure it's serializable
+        const codeString = String(code);
+        const error = {
+            code: codeString,
+            message,
+            statusCode,
+            originalError
+        };
+        // Log the error
+        this.logger.error(`[${codeString}] ${message}`, {
+            code: codeString,
+            message,
+            statusCode,
+            originalError: originalError instanceof Error ? originalError.message : String(originalError)
+        });
+        return error;
+    }
+    /**
+     * Throw a standardized error
+     * @param code - Error code
+     * @param message - Error message
+     * @param statusCode - Optional HTTP status code
+     * @param originalError - Optional original error
+     */
+    throwError(code, message, statusCode, originalError) {
+        const error = this.createError(code, message, statusCode, originalError);
+        const err = new Error(message);
+        // Convert enum to string to ensure it's serializable
+        err.code = String(code);
+        err.statusCode = statusCode;
+        // Only include serializable error info
+        err.originalError = originalError instanceof Error
+            ? originalError.message
+            : (typeof originalError === 'object' ? JSON.stringify(originalError) : String(originalError));
+        throw err;
+    }
+    /**
+     * Detect if an error is a connection failure
+     * @param error - Error to check
+     * @returns True if connection failure
+     */
+    isConnectionError(error) {
+        if (!error)
+            return false;
+        const message = error.message || String(error);
+        return (message.includes('fetch failed') ||
+            message.includes('ECONNREFUSED') ||
+            message.includes('ENOTFOUND') ||
+            message.includes('ETIMEDOUT') ||
+            message.includes('Lost connection'));
+    }
+    /**
+     * Handle connection errors
+     * @param error - Error to handle
+     */
+    handleConnectionError(error) {
+        if (this.isConnectionError(error)) {
+            this.throwError(types_1.ErrorCode.CONNECTION_FAILED, 'Lost connection to database', undefined, error);
+        }
+        throw error;
+    }
+    /**
+     * Validate configuration
+     * @param requiredFields - Array of required field names
+     * @throws Error if validation fails
+     */
+    validateConfig(requiredFields) {
+        for (const field of requiredFields) {
+            if (!this.config || !this.config[field]) {
+                this.throwError(types_1.ErrorCode.CONFIG_ERROR, `Missing required configuration field: ${field}`);
+            }
+        }
+    }
+    /**
+     * Log a query operation
+     * @param operation - Operation name
+     * @param details - Operation details
+     */
+    logQuery(operation, details) {
+        this.logger.info(`[Query] ${operation}`, {
+            operation,
+            ...details
+        });
+    }
+}
+exports.BaseAdapter = BaseAdapter;
+//# sourceMappingURL=base-adapter.js.map

package/dist/adapters/base-adapter.js.map

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

package/dist/adapters/file-adapter.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Purpose: File-based storage adapter stub
+ *
+ * This adapter will support file-based storage (JSON files).
+ * Currently returns NotImplementedError.
+ *
+ * Expected config structure:
+ * {
+ *   file: {
+ *     base_path: string,     // Base directory for data files
+ *     file_format: 'json',    // File format (currently only JSON)
+ *     table_to_file?: (table: string) => string  // Optional function to map table to filename
+ *   }
+ * }
+ */
+import type { HazoConnectAdapter, Logger } from '../types';
+import { BaseAdapter } from './base-adapter';
+import { QueryBuilder } from '../query-builder';
+/**
+ * File adapter implementation (stub)
+ */
+export declare class FileAdapter extends BaseAdapter implements HazoConnectAdapter {
+    /**
+     * Constructor
+     * @param config - File storage configuration
+     * @param logger - Optional logger instance
+     */
+    constructor(config: any, logger?: Logger);
+    /**
+     * Execute a query using the query builder
+     * @param builder - QueryBuilder instance
+     * @param method - HTTP method
+     * @param body - Request body
+     * @returns Promise with query results
+     */
+    query(builder: QueryBuilder, method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE', body?: any): Promise<any>;
+    /**
+     * Execute a raw query
+     * @param endpoint - Raw endpoint string (not applicable for file storage)
+     * @param options - Request options
+     * @returns Promise with query results
+     */
+    rawQuery(endpoint: string, options?: RequestInit): Promise<any>;
+    /**
+     * Get the adapter's configuration
+     * @returns Promise with adapter-specific config
+     */
+    getConfig(): Promise<any>;
+}
+//# sourceMappingURL=file-adapter.d.ts.map

package/dist/adapters/file-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-adapter.d.ts","sourceRoot":"","sources":["../../src/lib/adapters/file-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAG/C;;GAEG;AACH,qBAAa,WAAY,SAAQ,WAAY,YAAW,kBAAkB;IACxE;;;;OAIG;gBACS,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM;IAKxC;;;;;;OAMG;IACG,KAAK,CACT,OAAO,EAAE,YAAY,EACrB,MAAM,GAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAgB,EAC3D,IAAI,CAAC,EAAE,GAAG,GACT,OAAO,CAAC,GAAG,CAAC;IAOf;;;;;OAKG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,GAAG,CAAC;IAOzE;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC;CAGhC"}

package/dist/adapters/file-adapter.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * Purpose: File-based storage adapter stub
+ *
+ * This adapter will support file-based storage (JSON files).
+ * Currently returns NotImplementedError.
+ *
+ * Expected config structure:
+ * {
+ *   file: {
+ *     base_path: string,     // Base directory for data files
+ *     file_format: 'json',    // File format (currently only JSON)
+ *     table_to_file?: (table: string) => string  // Optional function to map table to filename
+ *   }
+ * }
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileAdapter = void 0;
+const base_adapter_1 = require("./base-adapter");
+const types_1 = require("../types");
+/**
+ * File adapter implementation (stub)
+ */
+class FileAdapter extends base_adapter_1.BaseAdapter {
+    /**
+     * Constructor
+     * @param config - File storage configuration
+     * @param logger - Optional logger instance
+     */
+    constructor(config, logger) {
+        super(config, logger);
+        // TODO: Validate file config when implemented
+    }
+    /**
+     * Execute a query using the query builder
+     * @param builder - QueryBuilder instance
+     * @param method - HTTP method
+     * @param body - Request body
+     * @returns Promise with query results
+     */
+    async query(builder, method = 'GET', body) {
+        this.throwError(types_1.ErrorCode.NOT_IMPLEMENTED, 'File adapter is not yet implemented. Please use PostgREST adapter for now.');
+    }
+    /**
+     * Execute a raw query
+     * @param endpoint - Raw endpoint string (not applicable for file storage)
+     * @param options - Request options
+     * @returns Promise with query results
+     */
+    async rawQuery(endpoint, options = {}) {
+        this.throwError(types_1.ErrorCode.NOT_IMPLEMENTED, 'File adapter is not yet implemented. Please use PostgREST adapter for now.');
+    }
+    /**
+     * Get the adapter's configuration
+     * @returns Promise with adapter-specific config
+     */
+    async getConfig() {
+        return Promise.resolve(this.config.file || this.config);
+    }
+}
+exports.FileAdapter = FileAdapter;
+//# sourceMappingURL=file-adapter.js.map

package/dist/adapters/file-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-adapter.js","sourceRoot":"","sources":["../../src/lib/adapters/file-adapter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAGH,iDAA4C;AAE5C,oCAAoC;AAEpC;;GAEG;AACH,MAAa,WAAY,SAAQ,0BAAW;IAC1C;;;;OAIG;IACH,YAAY,MAAW,EAAE,MAAe;QACtC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QACrB,8CAA8C;IAChD,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,CACT,OAAqB,EACrB,SAAsD,KAAK,EAC3D,IAAU;QAEV,IAAI,CAAC,UAAU,CACb,iBAAS,CAAC,eAAe,EACzB,4EAA4E,CAC7E,CAAA;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,QAAgB,EAAE,UAAuB,EAAE;QACxD,IAAI,CAAC,UAAU,CACb,iBAAS,CAAC,eAAe,EACzB,4EAA4E,CAC7E,CAAA;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS;QACb,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,CAAA;IACzD,CAAC;CACF;AAjDD,kCAiDC"}

package/dist/adapters/postgrest-adapter.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Purpose: PostgREST adapter implementation
+ *
+ * This adapter converts QueryBuilder to PostgREST URL format and executes queries.
+ * Uses injected config and logger (no file reading or project dependencies).
+ * Zero dependencies - only Node.js built-ins (fetch) and types.
+ */
+import type { HazoConnectAdapter, Logger } from '../types';
+import { BaseAdapter } from './base-adapter';
+import { QueryBuilder } from '../query-builder';
+/**
+ * PostgREST adapter configuration
+ */
+interface PostgrestConfig {
+    base_url: string;
+    api_key: string;
+}
+/**
+ * PostgREST adapter implementation
+ */
+export declare class PostgrestAdapter extends BaseAdapter implements HazoConnectAdapter {
+    private postgrestConfig;
+    /**
+     * Constructor
+     * @param config - PostgREST configuration (must include postgrest.base_url and postgrest.api_key)
+     * @param logger - Optional logger instance
+     */
+    constructor(config: any, logger?: Logger);
+    /**
+     * Convert QueryBuilder to PostgREST URL
+     * @param builder - QueryBuilder instance
+     * @returns PostgREST endpoint URL with query parameters
+     */
+    private buildPostgrestUrl;
+    /**
+     * Execute a query using the query builder
+     * @param builder - QueryBuilder instance
+     * @param method - HTTP method
+     * @param body - Request body for POST/PUT/PATCH
+     * @returns Promise with query results
+     */
+    query(builder: QueryBuilder, method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE', body?: any): Promise<any>;
+    /**
+     * Execute a raw query (for backward compatibility)
+     * @param endpoint - Raw endpoint string (e.g., '/table?id=eq.123')
+     * @param options - Request options
+     * @returns Promise with query results
+     */
+    rawQuery(endpoint: string, options?: RequestInit): Promise<any>;
+    /**
+     * Get the adapter's configuration
+     * @returns Promise with adapter-specific config
+     */
+    getConfig(): Promise<PostgrestConfig>;
+    private parseErrorPayload;
+    private buildFriendlyErrorMessage;
+    private sanitizeUrl;
+}
+export {};
+//# sourceMappingURL=postgrest-adapter.d.ts.map

package/dist/adapters/postgrest-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgrest-adapter.d.ts","sourceRoot":"","sources":["../../src/lib/adapters/postgrest-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAG/C;;GAEG;AACH,UAAU,eAAe;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,WAAY,YAAW,kBAAkB;IAC7E,OAAO,CAAC,eAAe,CAAiB;IAExC;;;;OAIG;gBACS,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM;IAoBxC;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAoGzB;;;;;;OAMG;IACG,KAAK,CACT,OAAO,EAAE,YAAY,EACrB,MAAM,GAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAgB,EAC3D,IAAI,CAAC,EAAE,GAAG,GACT,OAAO,CAAC,GAAG,CAAC;IAoBf;;;;;OAKG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,GAAG,CAAC;IAwFzE;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC;IAG3C,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,yBAAyB;IAyBjC,OAAO,CAAC,WAAW;CAKpB"}