hazo_connect 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Purpose: Core TypeScript types and interfaces for Hazo Connect
+ *
+ * This file defines all types used throughout the hazo_connect component.
+ * Zero dependencies - only TypeScript types.
+ *
+ * Note: ConfigProvider is imported from hazo_config npm package.
+ * Components can work with either direct config or ConfigProvider.
+ */
+import type { ConfigProvider } from 'hazo_config';
+/**
+ * Optional logger interface for dependency injection
+ * If not provided, a no-op logger will be used
+ */
+export interface Logger {
+    debug(message: string, data?: Record<string, unknown>): void;
+    info(message: string, data?: Record<string, unknown>): void;
+    warn(message: string, data?: Record<string, unknown>): void;
+    error(message: string, data?: Record<string, unknown>): void;
+}
+/**
+ * No-op logger implementation (default when no logger provided)
+ */
+export declare const noOpLogger: Logger;
+/**
+ * Connection types supported by Hazo Connect
+ */
+export type ConnectionType = 'postgrest' | 'supabase' | 'sqlite' | 'file';
+/**
+ * Main configuration interface for Hazo Connect
+ * Logger is optional - defaults to no-op if not provided
+ *
+ * Can accept either:
+ * - Direct config object with type and provider-specific config
+ * - ConfigProvider instance (from hazo_config) for dependency injection
+ */
+export interface HazoConnectConfig {
+    type: ConnectionType;
+    logger?: Logger;
+    configProvider?: ConfigProvider;
+    [key: string]: any;
+}
+/**
+ * Query operator types supported by the query builder
+ */
+export type QueryOperator = 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'like' | 'ilike' | 'in' | 'is' | 'or';
+/**
+ * Where condition structure
+ */
+export interface WhereCondition {
+    field: string;
+    operator: QueryOperator;
+    value: any;
+}
+/**
+ * Order direction
+ */
+export type OrderDirection = 'asc' | 'desc';
+/**
+ * Join type
+ */
+export type JoinType = 'inner' | 'left' | 'right';
+/**
+ * Nested select structure for PostgREST syntax
+ */
+export interface NestedSelect {
+    table: string;
+    fields: string[];
+}
+/**
+ * Database adapter interface
+ * All adapters must implement this interface
+ */
+export interface HazoConnectAdapter {
+    /**
+     * Execute a query using the query builder
+     * @param builder - The query builder instance
+     * @param method - HTTP method (GET, POST, PUT, PATCH, DELETE)
+     * @param body - Request body for POST/PUT/PATCH
+     * @returns Promise with query results
+     */
+    query(builder: any, // QueryBuilder type (avoid circular dependency)
+    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<any>;
+}
+/**
+ * Standardized error response
+ * Note: code is a string (ErrorCode enum values are strings)
+ */
+export interface HazoConnectError {
+    code: string;
+    message: string;
+    statusCode?: number;
+    originalError?: any;
+}
+/**
+ * Error codes
+ */
+export declare enum ErrorCode {
+    CONFIG_ERROR = "HAZO_CONNECT_CONFIG_ERROR",
+    CONNECTION_FAILED = "HAZO_CONNECT_CONNECTION_FAILED",
+    QUERY_ERROR = "HAZO_CONNECT_QUERY_ERROR",
+    NOT_IMPLEMENTED = "HAZO_CONNECT_NOT_IMPLEMENTED",
+    VALIDATION_ERROR = "HAZO_CONNECT_VALIDATION_ERROR"
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/lib/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAC5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAC3D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAC3D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CAC7D;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,MAKxB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAA;AAEzE;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,cAAc,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,KAAK,GACL,MAAM,GACN,OAAO,GACP,IAAI,GACJ,IAAI,GACJ,IAAI,CAAA;AAER;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,aAAa,CAAA;IACvB,KAAK,EAAE,GAAG,CAAA;CACX;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,CAAA;AAE3C;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAA;AAEjD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;OAMG;IACH,KAAK,CACH,OAAO,EAAE,GAAG,EAAE,gDAAgD;IAC9D,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,EACpD,IAAI,CAAC,EAAE,GAAG,GACT,OAAO,CAAC,GAAG,CAAC,CAAA;IAEf;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IAE/D;;;OAGG;IACH,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,CAAA;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,GAAG,CAAA;CACpB;AAED;;GAEG;AACH,oBAAY,SAAS;IACnB,YAAY,8BAA8B;IAC1C,iBAAiB,mCAAmC;IACpD,WAAW,6BAA6B;IACxC,eAAe,iCAAiC;IAChD,gBAAgB,kCAAkC;CACnD"}

package/dist/types.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * Purpose: Core TypeScript types and interfaces for Hazo Connect
+ *
+ * This file defines all types used throughout the hazo_connect component.
+ * Zero dependencies - only TypeScript types.
+ *
+ * Note: ConfigProvider is imported from hazo_config npm package.
+ * Components can work with either direct config or ConfigProvider.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorCode = exports.noOpLogger = void 0;
+/**
+ * No-op logger implementation (default when no logger provided)
+ */
+exports.noOpLogger = {
+    debug: () => { },
+    info: () => { },
+    warn: () => { },
+    error: () => { }
+};
+/**
+ * Error codes
+ */
+var ErrorCode;
+(function (ErrorCode) {
+    ErrorCode["CONFIG_ERROR"] = "HAZO_CONNECT_CONFIG_ERROR";
+    ErrorCode["CONNECTION_FAILED"] = "HAZO_CONNECT_CONNECTION_FAILED";
+    ErrorCode["QUERY_ERROR"] = "HAZO_CONNECT_QUERY_ERROR";
+    ErrorCode["NOT_IMPLEMENTED"] = "HAZO_CONNECT_NOT_IMPLEMENTED";
+    ErrorCode["VALIDATION_ERROR"] = "HAZO_CONNECT_VALIDATION_ERROR";
+})(ErrorCode || (exports.ErrorCode = ErrorCode = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/lib/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAgBH;;GAEG;AACU,QAAA,UAAU,GAAW;IAChC,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;IACf,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;CAChB,CAAA;AA6GD;;GAEG;AACH,IAAY,SAMX;AAND,WAAY,SAAS;IACnB,uDAA0C,CAAA;IAC1C,iEAAoD,CAAA;IACpD,qDAAwC,CAAA;IACxC,6DAAgD,CAAA;IAChD,+DAAkD,CAAA;AACpD,CAAC,EANW,SAAS,yBAAT,SAAS,QAMpB"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "hazo_connect",
+  "version": "1.0.0",
+  "description": "Module to connect to the data store (postgres via postgrest, supabase, etc)",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "build:lib": "tsc --project tsconfig.lib.json",
+    "start": "next start",
+    "lint": "next lint",
+    "storybook": "storybook dev -p 6006",
+    "build_storybook": "storybook build",
+    "demo:test": "cd apps/test_app && tsx main.ts",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "test:integration": "POSTGREST_INTEGRATION=true jest --runInBand tests/integration/postgrest.integration.test.ts",
+    "prepublishOnly": "npm run build:lib",
+    "postinstall": "patch-package"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pub12/hazo_connect.git"
+  },
+  "keywords": [
+    "database",
+    "connection",
+    "postgrest"
+  ],
+  "author": "Pubs Abayasiri",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/pub12/hazo_connect/issues"
+  },
+  "homepage": "https://github.com/pub12/hazo_connect#readme",
+  "dependencies": {
+    "dotenv": "^16.4.5",
+    "hazo_config": "^1.3.0",
+    "next": "14.2.5",
+    "react": "18.3.1",
+    "react-dom": "18.3.1"
+  },
+  "devDependencies": {
+    "@storybook/addon-essentials": "^8.2.6",
+    "@storybook/addon-interactions": "^8.2.6",
+    "@storybook/experimental-nextjs-vite": "^8.6.14",
+    "@storybook/nextjs": "^8.2.6",
+    "@storybook/react": "^8.2.6",
+    "@storybook/test": "^8.2.6",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^20.14.10",
+    "@types/react": "^18.3.3",
+    "@types/react-dom": "^18.3.0",
+    "autoprefixer": "^10.4.19",
+    "eslint": "^8.57.0",
+    "eslint-config-next": "14.2.5",
+    "jest": "^30.2.0",
+    "jest-environment-node": "^30.2.0",
+    "patch-package": "^8.0.1",
+    "postcss": "^8.4.39",
+    "storybook": "^8.2.6",
+    "tailwindcss": "^3.4.10",
+    "ts-jest": "^29.4.5",
+    "tsx": "^4.17.0",
+    "typescript": "^5.5.4"
+  }
+}