@promakeai/dbreact 1.0.3 → 1.0.5

package/README.md

@@ -4,12 +4,12 @@ React hooks and providers for schema-driven, multi-language databases. Type-safe
 
 ## Features
 
-- **Type-Safe Hooks** - Generated TypeScript types and React hooks
+- **Type-Safe Hooks** - Generic React hooks with generated TypeScript types
 - **Multi-Language Support** - Automatic translation queries with fallback
 - **Browser SQLite** - sql.js WASM adapter for offline-first apps
-- **React Query Integration** - Built-in caching, loading states, optimistic updates
-- **Zero-Config Language Switching** - Change language, queries refetch automatically
-- **MongoDB-Style Queries** - Intuitive filter syntax (`$gt`, `$in`, `$like`, etc.)
+- **React Query Integration** - Built-in caching, loading states, optimistic updates
+- **Zero-Config Language Switching** - Change language, queries refetch automatically
+- **MongoDB-Style Queries** - Intuitive filter syntax (`$gt`, `$in`, `$like`, `$contains`, etc.)
 
 ## Installation
 
@@ -26,11 +26,16 @@ npm install @promakeai/dbreact @tanstack/react-query
 ### 1. Setup Adapter
 
 ```tsx
-import { SqliteAdapter } from '@promakeai/dbreact';
-
-const adapter = new SqliteAdapter({
-  storageKey: 'myapp-db',  // localStorage key for persistence
-});
+import { SqliteAdapter } from '@promakeai/dbreact';
+import { parseJSONSchema } from '@promakeai/dbreact';
+import schemaJson from './schema.json';
+
+const schema = parseJSONSchema(schemaJson as any);
+
+const adapter = new SqliteAdapter({
+  storageKey: 'myapp-db',  // localStorage key for persistence
+  schema,
+});
 ```
 
 ### 2. Wrap App with Provider
@@ -98,24 +103,27 @@ Main provider component that wraps your application.
 
 ```tsx
 <DbProvider
-  adapter={adapter}
-  lang="tr"
-  fallbackLang="en"
-  autoConnect={true}
->
+  adapter={adapter}
+  schema={schema}
+  lang="tr"
+  fallbackLang="en"
+  autoConnect={true}
+>
   <App />
 </DbProvider>
 ```
 
 **Props:**
 
-| Prop | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `adapter` | `IDataAdapter` | Yes | - | Database adapter instance |
-| `lang` | `string` | No | `'en'` | Current language code |
-| `fallbackLang` | `string` | No | `'en'` | Fallback language |
-| `autoConnect` | `boolean` | No | `true` | Auto-connect on mount |
-| `children` | `ReactNode` | Yes | - | Child components |
+| Prop | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `adapter` | `IDataAdapter` | Yes | - | Database adapter instance |
+| `schema` | `SchemaDefinition` | No | - | Enables populate + typed serialization |
+| `lang` | `string` | No | `'en'` | Current language code |
+| `fallbackLang` | `string` | No | `'en'` | Fallback language |
+| `autoConnect` | `boolean` | No | `true` | Auto-connect on mount |
+| `queryClient` | `QueryClient` | No | Internal | Provide a custom React Query client |
+| `children` | `ReactNode` | Yes | - | Child components |
 
 ---
 
@@ -143,19 +151,29 @@ const { data, isLoading, error, refetch } = useDbList<Product>('products', {
 | `orderBy` | `array` | Sort order `[{ field, direction }]` |
 | `limit` | `number` | Max records to return |
 | `offset` | `number` | Skip records |
-| `populate` | `string[]` | Resolve foreign key references |
+| `populate` | `PopulateOption` | Resolve foreign key references (string, array, or object) |
 | `enabled` | `boolean` | Enable/disable query |
 
-#### useDbGet
-
-Fetch single record by ID.
-
-```tsx
-const { data: product, isLoading } = useDbGet<Product>('products', productId, {
-  populate: ['categoryId'],
-  enabled: !!productId,
-});
-```
+#### useDbGet
+
+Fetch single record by ID.
+
+```tsx
+const { data: product, isLoading } = useDbGet<Product>('products', productId, {
+  populate: ['categoryId'],
+  enabled: !!productId,
+});
+```
+
+Find-one style (by where clause):
+
+```tsx
+const { data: product } = useDbGet<Product>('products', {
+  where: { slug: 'my-product' },
+  enabled: !!slug,
+  populate: { categoryId: true },
+});
+```
 
 ---
 
@@ -182,13 +200,13 @@ createProduct.mutate(
 Update an existing record.
 
 ```tsx
-const updateProduct = useDbUpdate<Product>('products', productId);
-
-updateProduct.mutate(
-  { price: 89.99 },
-  {
-    onSuccess: () => console.log('Updated'),
-  }
+const updateProduct = useDbUpdate<Product>('products');
+
+updateProduct.mutate(
+  { id: productId, data: { price: 89.99 } },
+  {
+    onSuccess: () => console.log('Updated'),
+  }
 );
 ```
 
@@ -197,11 +215,11 @@ updateProduct.mutate(
 Delete a record.
 
 ```tsx
-const deleteProduct = useDbDelete('products', productId);
-
-deleteProduct.mutate(undefined, {
-  onSuccess: () => console.log('Deleted'),
-});
+const deleteProduct = useDbDelete('products');
+
+deleteProduct.mutate(productId, {
+  onSuccess: () => console.log('Deleted'),
+});
 ```
 
 ---
@@ -294,12 +312,16 @@ const adapter = new SqliteAdapter({
 { name: { $like: '%shirt%' } }       // LIKE '%shirt%'
 { name: { $notLike: '%test%' } }     // NOT LIKE '%test%'
 
-// Range
-{ price: { $between: [10, 100] } }   // BETWEEN 10 AND 100
-
-// Null
-{ description: { $isNull: true } }   // IS NULL
-{ description: { $isNull: false } }  // IS NOT NULL
+// Range
+{ price: { $between: [10, 100] } }   // BETWEEN 10 AND 100
+
+// Null
+{ description: { $isNull: true } }   // IS NULL
+{ description: { $isNull: false } }  // IS NOT NULL
+
+// JSON array contains
+{ tags: { $contains: "sale" } }
+{ tags: { $containsAny: ["sale", "new"] } }
 
 // Logical
 { $and: [
@@ -318,18 +340,18 @@ const adapter = new SqliteAdapter({
 ### Query Interface
 
 ```typescript
-interface QueryOptions {
-  where?: Record<string, unknown>;
-  orderBy?: Array<{
-    field: string;
-    direction: 'ASC' | 'DESC';
-  }>;
-  limit?: number;
-  offset?: number;
-  populate?: string[];
-  lang?: string;
-  fallbackLang?: string;
-}
+interface QueryOptions {
+  where?: Record<string, unknown>;
+  orderBy?: Array<{
+    field: string;
+    direction: 'ASC' | 'DESC';
+  }>;
+  limit?: number;
+  offset?: number;
+  populate?: PopulateOption;
+  lang?: string;
+  fallbackLang?: string;
+}
 ```
 
 ---
@@ -387,36 +409,32 @@ function LanguageSwitcher() {
 
 ---
 
-## Generated Hooks
-
-Generate type-safe hooks from your schema:
-
-```bash
-dbcli generate --schema ./schema.ts --output ./src/db/generated
-```
-
-**Generated files:**
-- `types.ts` - TypeScript interfaces for each table
-- `hooks.ts` - Type-safe hooks for each table
-
-```tsx
-// Generated hooks usage
-import { useProducts, useProduct, useCreateProduct } from './db/generated/hooks';
-
-function ProductManager() {
-  const { data: products } = useProducts({
-    where: { stock: { $gt: 0 } },
-  });
-
-  const { data: product } = useProduct(1);
-
-  const createProduct = useCreateProduct();
-
-  return (
-    // ...
-  );
-}
-```
+## Generated Types + Generic Hooks
+
+Generate runtime schema and TypeScript interfaces:
+
+```bash
+dbcli generate --schema ./schema.json --output ./src/db
+```
+
+`dbcli generate` writes `schema.json` and `types.ts`. React hooks are imported from `@promakeai/dbreact`:
+
+```tsx
+import { useDbList, useDbGet, useDbCreate } from '@promakeai/dbreact';
+import type { DbProduct, DbProductInput } from './db/types';
+
+function ProductManager() {
+  const { data: products } = useDbList<DbProduct>('products', {
+    where: { stock: { $gt: 0 } },
+  });
+
+  const { data: product } = useDbGet<DbProduct>('products', 1);
+
+  const createProduct = useDbCreate<DbProduct, DbProductInput>('products');
+
+  return null;
+}
+```
 
 ---
 
@@ -425,15 +443,10 @@ function ProductManager() {
 ### Custom React Query Options
 
 ```tsx
-const { data } = useDbList('products', {
-  where: { active: true },
-}, {
-  // React Query options
-  staleTime: 1000 * 60 * 5,  // 5 minutes
-  gcTime: 1000 * 60 * 30,    // 30 minutes
-  refetchOnWindowFocus: false,
-  retry: 3,
-});
+const { data } = useDbList('products', {
+  where: { active: true },
+  limit: 50,
+});
 ```
 
 ### Direct Adapter Access
@@ -467,7 +480,7 @@ function AdvancedSearch() {
 ```tsx
 function ProductPrice({ product }) {
   const queryClient = useQueryClient();
-  const updateProduct = useDbUpdate('products', product.id);
+  const updateProduct = useDbUpdate('products');
 
   const handlePriceChange = async (newPrice: number) => {
     // Optimistic update
@@ -476,7 +489,10 @@ function ProductPrice({ product }) {
       { ...product, price: newPrice }
     );
 
-    await updateProduct.mutateAsync({ price: newPrice });
+    await updateProduct.mutateAsync({
+      id: product.id,
+      data: { price: newPrice },
+    });
   };
 
   return <PriceInput value={product.price} onChange={handlePriceChange} />;
@@ -568,13 +584,13 @@ function ProductSearch() {
 Full TypeScript support with generated types:
 
 ```typescript
-import type { Product, ProductInput } from './db/generated/types';
+import type { DbProduct, DbProductInput } from './db/types';
 
 // Type-safe queries
-const products: Product[] = await adapter.list('products');
+const products: DbProduct[] = await adapter.list('products');
 
 // Type-safe creates
-const newProduct: ProductInput = {
+const newProduct: DbProductInput = {
   sku: 'SHIRT-001',
   price: 99.99,
 };
@@ -606,10 +622,14 @@ await adapter.create('products', newProduct);
 
 ---
 
-## Troubleshooting
-
-**"useDbLang must be used within a DbProvider"**
-- Ensure component is wrapped in DbProvider
+## Troubleshooting
+
+**Production crash: `jsxDEV is not a function`**
+- Run `bun run test:build-runtime` before publishing.
+- This verifies `dist/index.js` does not include `react/jsx-dev-runtime`.
+
+**"useDbLang must be used within a DbProvider"**
+- Ensure component is wrapped in DbProvider
 
 **Queries return empty results**
 - Check adapter is connected: `const { isConnected } = useDb()`

package/dist/adapters/SqliteAdapter.d.ts

@@ -32,6 +32,7 @@ export interface SqliteAdapterConfig {
 export declare class SqliteAdapter implements IDataAdapter {
     private db;
     private SQL;
+    private tableColumnsCache;
     private config;
     schema?: SchemaDefinition;
     defaultLang?: string;
@@ -141,6 +142,8 @@ export declare class SqliteAdapter implements IDataAdapter {
         created: number;
         ids: (number | bigint)[];
     }>;
+    private getAvailableMainFallbackFields;
+    private getTableColumns;
     updateMany(table: string, updates: {
         id: number | string;
         data: Record<string, unknown>;

package/dist/adapters/SqliteAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SqliteAdapter.d.ts","sourceRoot":"","sources":["../../adapters/SqliteAdapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SqliteAdapter.d.ts","sourceRoot":"","sources":["../../adapters/SqliteAdapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAepG,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,gDAAgD;IAChD,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,aAAc,YAAW,YAAY;IAChD,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,GAAG,CAA4B;IACvC,OAAO,CAAC,iBAAiB,CAAkC;IAC3D,OAAO,CAAC,MAAM,CAGZ;IAEF,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;gBAET,MAAM,GAAE,mBAAwB;IAc5C,SAAS,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAMnC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB9B,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,KAAK;IAOb,OAAO,CAAC,QAAQ;IAkBhB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;OAEG;IACH,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,gBAAgB;IAuCxB;;OAEG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,CAAC,EAAE,CAAC;YAWD,YAAY;IA4B1B;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EACnB,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,MAAM,GAAG,MAAM,EACnB,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GACjD,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAUd,OAAO,CAAC,CAAC,GAAG,OAAO,EACvB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAClF,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;YAKN,WAAW;IA+BzB;;OAEG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAMnE;;OAEG;IACG,QAAQ,CAAC,CAAC,GAAG,OAAO,EACxB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAqB9B;;OAEG;IACG,MAAM,CAAC,CAAC,GAAG,OAAO,EACtB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,CAAC,CAAC;IA4Cb;;OAEG;IACG,sBAAsB,CAAC,CAAC,GAAG,OAAO,EACtC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACrD,OAAO,CAAC,CAAC,CAAC;IAwCb;;OAEG;IACG,MAAM,CAAC,CAAC,GAAG,OAAO,EACtB,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,MAAM,GAAG,MAAM,EACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,CAAC,CAAC;IAyCb;;OAEG;IACG,iBAAiB,CACrB,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,MAAM,GAAG,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC;IAYhB;;OAEG;IACG,eAAe,CAAC,CAAC,GAAG,OAAO,EAC/B,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,MAAM,GAAG,MAAM,GAClB,OAAO,CAAC,CAAC,EAAE,CAAC;IAaf;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAsBlE;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAWhH;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EACnB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC,CAAC,EAAE,CAAC;IAIf;;OAEG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB1E;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAOpC;;OAEG;IACG,cAAc,CAClB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAgBzE;;OAEG;IACH,KAAK,IAAI,IAAI;IAUP,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAKvB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAKzB,UAAU,CAAC,CAAC,GAAG,OAAO,EAC1B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAClC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAC7B,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;KAAE,CAAC;YAwC3C,8BAA8B;YAW9B,eAAe;IAUvB,UAAU,CACd,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EAAE,GAChE,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAWzB,UAAU,CACd,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GACvB,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAW/B;;OAEG;IACH,MAAM,IAAI,UAAU;IAIpB;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7C;;OAEG;IACH,KAAK,IAAI,IAAI;CAQd"}

package/dist/adapters/SqliteAdapter.js

@@ -21,6 +21,7 @@ import { buildWhereClause, buildTranslationQuery, buildTranslationQueryById, bui
 export class SqliteAdapter {
     db = null;
     SQL = null;
+    tableColumnsCache = new Map();
     config;
     schema;
     defaultLang;
@@ -39,6 +40,7 @@ export class SqliteAdapter {
     setSchema(schema) {
         this.schema = schema;
         this.config.schema = schema;
+        this.tableColumnsCache.clear();
     }
     async connect() {
         // Initialize sql.js
@@ -162,6 +164,7 @@ export class SqliteAdapter {
             schema: this.schema,
             lang: options.lang,
             fallbackLang: options.fallbackLang ?? this.defaultLang,
+            mainFallbackFields: await this.getAvailableMainFallbackFields(table),
             where: options.where,
             orderBy: options.orderBy,
             limit: options.limit,
@@ -195,7 +198,7 @@ export class SqliteAdapter {
             const results = await this.list(table, { where: { id }, limit: 1 });
             return results[0] ?? null;
         }
-        const { sql, params } = buildTranslationQueryById(table, this.schema, id, options.lang, options.fallbackLang ?? this.defaultLang);
+        const { sql, params } = buildTranslationQueryById(table, this.schema, id, options.lang, options.fallbackLang ?? this.defaultLang, await this.getAvailableMainFallbackFields(table));
         const rows = this.runQuery(sql, params);
         const deserialized = this.deserializeResults(table, rows);
         return deserialized[0] ?? null;
@@ -449,6 +452,7 @@ export class SqliteAdapter {
             this.persist();
             this.db.close();
             this.db = null;
+            this.tableColumnsCache.clear();
         }
     }
     // Transaction methods
@@ -495,6 +499,25 @@ export class SqliteAdapter {
         this.persist();
         return { created: ids.length, ids };
     }
+    async getAvailableMainFallbackFields(table) {
+        const tableSchema = this.schema?.tables[table];
+        if (!tableSchema)
+            return [];
+        const translatableFields = getTranslatableFields(tableSchema);
+        if (translatableFields.length === 0)
+            return [];
+        const tableColumns = await this.getTableColumns(table);
+        return translatableFields.filter((field) => tableColumns.has(field));
+    }
+    async getTableColumns(table) {
+        const cached = this.tableColumnsCache.get(table);
+        if (cached)
+            return cached;
+        const schema = await this.getTableSchema(table);
+        const columnSet = new Set(schema.map((col) => col.name));
+        this.tableColumnsCache.set(table, columnSet);
+        return columnSet;
+    }
     async updateMany(table, updates) {
         let updated = 0;
         for (const { id, data } of updates) {

package/dist/hooks/useDbHooks.js

@@ -21,7 +21,8 @@
  * ```
  */
 import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
-import { useAdapter, useDbLang } from "../providers/DbProvider";
+import { useAdapter, useDb, useDbLang } from "../providers/DbProvider";
+import { resolvePopulate } from "@promakeai/orm";
 /**
  * Hook to list all records from a table
  *
@@ -40,14 +41,25 @@ import { useAdapter, useDbLang } from "../providers/DbProvider";
  */
 export function useDbList(table, options) {
     const adapter = useAdapter();
+    const { schema } = useDb();
     const { lang, fallbackLang } = useDbLang();
+    const { populate, ...queryOpts } = options || {};
     return useQuery({
-        queryKey: [table, "list", options, lang],
-        queryFn: () => adapter.list(table, {
-            ...options,
-            lang,
-            fallbackLang,
-        }),
+        queryKey: [table, "list", queryOpts, lang, populate],
+        queryFn: async () => {
+            const records = await adapter.list(table, {
+                ...queryOpts,
+                lang,
+                fallbackLang,
+            });
+            if (populate && schema) {
+                const adapterWrapper = {
+                    findMany: (t, opts) => adapter.list(t, { ...opts, lang, fallbackLang }),
+                };
+                return resolvePopulate(records, table, populate, schema, adapterWrapper);
+            }
+            return records;
+        },
         enabled: options?.enabled ?? true,
     });
 }
@@ -73,15 +85,27 @@ export function useDbList(table, options) {
  */
 export function useDbGet(table, idOrOptions, maybeOptions) {
     const adapter = useAdapter();
+    const { schema } = useDb();
     const { lang, fallbackLang } = useDbLang();
     const isWhereMode = typeof idOrOptions === "object" && idOrOptions !== null && "where" in idOrOptions;
     const where = isWhereMode ? idOrOptions.where : { id: idOrOptions };
     const enabled = isWhereMode
         ? (idOrOptions.enabled ?? true)
         : ((maybeOptions?.enabled ?? true) && idOrOptions !== undefined);
+    const populate = isWhereMode ? idOrOptions.populate : maybeOptions?.populate;
     return useQuery({
-        queryKey: [table, "single", where, lang],
-        queryFn: () => adapter.findOne(table, { where, lang, fallbackLang }),
+        queryKey: [table, "single", where, lang, populate],
+        queryFn: async () => {
+            const record = await adapter.findOne(table, { where, lang, fallbackLang });
+            if (record && populate && schema) {
+                const adapterWrapper = {
+                    findMany: (t, opts) => adapter.list(t, { ...opts, lang, fallbackLang }),
+                };
+                const [populated] = await resolvePopulate([record], table, populate, schema, adapterWrapper);
+                return populated;
+            }
+            return record;
+        },
         enabled,
     });
 }

package/dist/index.js

@@ -1,674 +1,14 @@
-// index.ts
-import {
-  ORM,
-  defineSchema,
-  f,
-  buildWhereClause as buildWhereClause2,
-  resolvePopulate as resolvePopulate2,
-  getPopulatableFields,
-  validatePopulate,
-  parseJSONSchema
-} from "@promakeai/orm";
-
-// providers/DbProvider.tsx
-import {
-  createContext,
-  useContext,
-  useState,
-  useEffect,
-  useMemo,
-  useCallback,
-  useRef
-} from "react";
-import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
-import { jsxDEV } from "react/jsx-dev-runtime";
-var DbContext = createContext(null);
-var DbLangContext = createContext(null);
-var defaultQueryClient = new QueryClient({
-  defaultOptions: {
-    queries: {
-      staleTime: 1000 * 60 * 5,
-      gcTime: 1000 * 60 * 30,
-      refetchOnWindowFocus: false
-    }
-  }
-});
-function DbProvider({
-  adapter,
-  schema,
-  lang: langProp = "en",
-  fallbackLang = "en",
-  autoConnect = true,
-  queryClient = defaultQueryClient,
-  children
-}) {
-  const [isConnected, setIsConnected] = useState(false);
-  const [error, setError] = useState(null);
-  const [lang, setLangState] = useState(langProp);
-  const isFirstRender = useRef(true);
-  useEffect(() => {
-    if (langProp !== lang) {
-      setLangState(langProp);
-    }
-  }, [langProp]);
-  useEffect(() => {
-    if (isFirstRender.current) {
-      isFirstRender.current = false;
-      return;
-    }
-    queryClient.invalidateQueries();
-  }, [lang]);
-  useEffect(() => {
-    if (!autoConnect)
-      return;
-    let mounted = true;
-    async function connect() {
-      try {
-        await adapter.connect?.();
-        if (mounted) {
-          setIsConnected(true);
-          setError(null);
-        }
-      } catch (err) {
-        if (mounted) {
-          setError(err instanceof Error ? err : new Error(String(err)));
-          setIsConnected(false);
-        }
-      }
-    }
-    connect();
-    return () => {
-      mounted = false;
-    };
-  }, [adapter, autoConnect]);
-  const setLang = useCallback((newLang) => {
-    setLangState(newLang);
-  }, []);
-  const dbContextValue = useMemo(() => ({
-    adapter,
-    schema,
-    isConnected,
-    error
-  }), [adapter, schema, isConnected, error]);
-  const langContextValue = useMemo(() => ({
-    lang,
-    fallbackLang,
-    setLang
-  }), [lang, fallbackLang, setLang]);
-  return /* @__PURE__ */ jsxDEV(QueryClientProvider, {
-    client: queryClient,
-    children: /* @__PURE__ */ jsxDEV(DbContext.Provider, {
-      value: dbContextValue,
-      children: /* @__PURE__ */ jsxDEV(DbLangContext.Provider, {
-        value: langContextValue,
-        children
-      }, undefined, false, undefined, this)
-    }, undefined, false, undefined, this)
-  }, undefined, false, undefined, this);
-}
-function useDb() {
-  const context = useContext(DbContext);
-  if (!context) {
-    throw new Error("useDb must be used within a DbProvider");
-  }
-  return context;
-}
-function useAdapter() {
-  const { adapter } = useDb();
-  return adapter;
-}
-function useDbLang() {
-  const context = useContext(DbLangContext);
-  if (!context) {
-    throw new Error("useDbLang must be used within a DbProvider");
-  }
-  return context;
-}
-// hooks/useDbHooks.ts
-import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
-import { resolvePopulate } from "@promakeai/orm";
-function useDbList(table, options) {
-  const adapter = useAdapter();
-  const { schema } = useDb();
-  const { lang, fallbackLang } = useDbLang();
-  const { populate, ...queryOpts } = options || {};
-  return useQuery({
-    queryKey: [table, "list", queryOpts, lang, populate],
-    queryFn: async () => {
-      const records = await adapter.list(table, {
-        ...queryOpts,
-        lang,
-        fallbackLang
-      });
-      if (populate && schema) {
-        const adapterWrapper = {
-          findMany: (t, opts) => adapter.list(t, { ...opts, lang, fallbackLang })
-        };
-        return resolvePopulate(records, table, populate, schema, adapterWrapper);
-      }
-      return records;
-    },
-    enabled: options?.enabled ?? true
-  });
-}
-function useDbGet(table, idOrOptions, maybeOptions) {
-  const adapter = useAdapter();
-  const { schema } = useDb();
-  const { lang, fallbackLang } = useDbLang();
-  const isWhereMode = typeof idOrOptions === "object" && idOrOptions !== null && "where" in idOrOptions;
-  const where = isWhereMode ? idOrOptions.where : { id: idOrOptions };
-  const enabled = isWhereMode ? idOrOptions.enabled ?? true : (maybeOptions?.enabled ?? true) && idOrOptions !== undefined;
-  const populate = isWhereMode ? idOrOptions.populate : maybeOptions?.populate;
-  return useQuery({
-    queryKey: [table, "single", where, lang, populate],
-    queryFn: async () => {
-      const record = await adapter.findOne(table, { where, lang, fallbackLang });
-      if (record && populate && schema) {
-        const adapterWrapper = {
-          findMany: (t, opts) => adapter.list(t, { ...opts, lang, fallbackLang })
-        };
-        const [populated] = await resolvePopulate([record], table, populate, schema, adapterWrapper);
-        return populated;
-      }
-      return record;
-    },
-    enabled
-  });
-}
-function useDbCreate(table) {
-  const adapter = useAdapter();
-  const queryClient = useQueryClient();
-  return useMutation({
-    mutationFn: (data) => adapter.create(table, data),
-    onSuccess: () => {
-      queryClient.invalidateQueries({ queryKey: [table] });
-    }
-  });
-}
-function useDbUpdate(table) {
-  const adapter = useAdapter();
-  const queryClient = useQueryClient();
-  return useMutation({
-    mutationFn: ({ id, data }) => adapter.update(table, id, data),
-    onSuccess: (_, { id }) => {
-      queryClient.invalidateQueries({ queryKey: [table] });
-      queryClient.invalidateQueries({ queryKey: [table, "single", id] });
-    }
-  });
-}
-function useDbDelete(table) {
-  const adapter = useAdapter();
-  const queryClient = useQueryClient();
-  return useMutation({
-    mutationFn: (id) => adapter.delete(table, id),
-    onSuccess: () => {
-      queryClient.invalidateQueries({ queryKey: [table] });
-    }
-  });
-}
-// adapters/SqliteAdapter.ts
-import initSqlJs from "sql.js";
-import {
-  buildWhereClause,
-  buildTranslationQuery,
-  buildTranslationQueryById,
-  buildTranslationUpsert,
-  extractTranslatableData,
-  getTranslatableFields,
-  toTranslationTableName,
-  toTranslationFKName,
-  deserializeRow,
-  serializeRow
-} from "@promakeai/orm";
-
-class SqliteAdapter {
-  db = null;
-  SQL = null;
-  config;
-  schema;
-  defaultLang;
-  constructor(config = {}) {
-    this.config = {
-      storageKey: config.storageKey ?? "dbreact_db",
-      wasmPath: config.wasmPath ?? "https://sql.js.org/dist/sql-wasm.wasm",
-      initialData: config.initialData ?? new Uint8Array,
-      schema: config.schema,
-      defaultLang: config.defaultLang
-    };
-    this.schema = config.schema;
-    this.defaultLang = config.defaultLang;
-  }
-  setSchema(schema) {
-    this.schema = schema;
-    this.config.schema = schema;
-  }
-  async connect() {
-    this.SQL = await initSqlJs({
-      locateFile: (file) => file === "sql-wasm.wasm" ? this.config.wasmPath : file
-    });
-    const saved = localStorage.getItem(this.config.storageKey);
-    if (saved) {
-      const data = Uint8Array.from(atob(saved), (c) => c.charCodeAt(0));
-      this.db = new this.SQL.Database(data);
-    } else if (this.config.initialData.length > 0) {
-      this.db = new this.SQL.Database(this.config.initialData);
-      this.persist();
-    } else {
-      this.db = new this.SQL.Database;
-    }
-  }
-  persist() {
-    if (!this.db)
-      return;
-    const data = this.db.export();
-    const base64 = btoa(String.fromCharCode(...data));
-    localStorage.setItem(this.config.storageKey, base64);
-  }
-  getDb() {
-    if (!this.db) {
-      throw new Error("Database not connected. Call connect() first.");
-    }
-    return this.db;
-  }
-  runQuery(sql, params = []) {
-    const db = this.getDb();
-    const result = db.exec(sql, params);
-    if (result.length === 0 || result[0].values.length === 0) {
-      return [];
-    }
-    const columns = result[0].columns;
-    return result[0].values.map((row) => {
-      const obj = {};
-      columns.forEach((col, i) => {
-        obj[col] = row[i];
-      });
-      return obj;
-    });
-  }
-  deserializeResults(table, rows) {
-    const tableSchema = this.schema?.tables[table];
-    if (!tableSchema || rows.length === 0)
-      return rows;
-    return rows.map((row) => deserializeRow(row, tableSchema.fields));
-  }
-  serializeData(table, data) {
-    const tableSchema = this.schema?.tables[table];
-    if (!tableSchema)
-      return data;
-    return serializeRow(data, tableSchema.fields);
-  }
-  buildSelectQuery(table, options, countOnly = false) {
-    const select = countOnly ? "COUNT(*) as count" : "*";
-    let sql = `SELECT ${select} FROM ${table}`;
-    const params = [];
-    if (options?.where) {
-      const where = buildWhereClause(options.where);
-      if (where.sql) {
-        sql += ` WHERE ${where.sql}`;
-        params.push(...where.params);
-      }
-    }
-    if (!countOnly) {
-      if (options?.orderBy && options.orderBy.length > 0) {
-        const orderParts = options.orderBy.map((o) => `${o.field} ${o.direction}`);
-        sql += ` ORDER BY ${orderParts.join(", ")}`;
-      }
-      if (options?.limit !== undefined) {
-        sql += ` LIMIT ?`;
-        params.push(options.limit);
-      }
-      if (options?.offset !== undefined) {
-        sql += ` OFFSET ?`;
-        params.push(options.offset);
-      }
-    }
-    return { sql, params };
-  }
-  async list(table, options) {
-    if (options?.lang && this.schema?.tables[table]) {
-      return this.listWithLang(table, options);
-    }
-    const { sql, params } = this.buildSelectQuery(table, options);
-    const rows = this.runQuery(sql, params);
-    return this.deserializeResults(table, rows);
-  }
-  async listWithLang(table, options) {
-    const tableSchema = this.schema?.tables[table];
-    if (!tableSchema) {
-      const { sql: sql2, params: params2 } = this.buildSelectQuery(table, options);
-      return this.deserializeResults(table, this.runQuery(sql2, params2));
-    }
-    const translatableFields = getTranslatableFields(tableSchema);
-    if (translatableFields.length === 0) {
-      const { sql: sql2, params: params2 } = this.buildSelectQuery(table, options);
-      return this.deserializeResults(table, this.runQuery(sql2, params2));
-    }
-    const { sql, params } = buildTranslationQuery({
-      table,
-      schema: this.schema,
-      lang: options.lang,
-      fallbackLang: options.fallbackLang ?? this.defaultLang,
-      where: options.where,
-      orderBy: options.orderBy,
-      limit: options.limit,
-      offset: options.offset
-    });
-    return this.deserializeResults(table, this.runQuery(sql, params));
-  }
-  async get(table, id, options) {
-    if (options?.lang && this.schema?.tables[table]) {
-      return this.getWithLang(table, id, options);
-    }
-    const results = await this.list(table, { where: { id }, limit: 1 });
-    return results[0] ?? null;
-  }
-  async findOne(table, options) {
-    const results = await this.list(table, { ...options, limit: 1 });
-    return results[0] ?? null;
-  }
-  async getWithLang(table, id, options) {
-    const tableSchema = this.schema?.tables[table];
-    if (!tableSchema) {
-      const results = await this.list(table, { where: { id }, limit: 1 });
-      return results[0] ?? null;
-    }
-    const translatableFields = getTranslatableFields(tableSchema);
-    if (translatableFields.length === 0) {
-      const results = await this.list(table, { where: { id }, limit: 1 });
-      return results[0] ?? null;
-    }
-    const { sql, params } = buildTranslationQueryById(table, this.schema, id, options.lang, options.fallbackLang ?? this.defaultLang);
-    const rows = this.runQuery(sql, params);
-    const deserialized = this.deserializeResults(table, rows);
-    return deserialized[0] ?? null;
-  }
-  async count(table, options) {
-    const { sql, params } = this.buildSelectQuery(table, options, true);
-    const result = this.runQuery(sql, params);
-    return result[0]?.count ?? 0;
-  }
-  async paginate(table, page, limit, options) {
-    const total = await this.count(table, options);
-    const totalPages = Math.ceil(total / limit);
-    const offset = (page - 1) * limit;
-    const data = await this.list(table, {
-      ...options,
-      limit,
-      offset
-    });
-    return {
-      data,
-      page,
-      limit,
-      total,
-      totalPages,
-      hasMore: page < totalPages
-    };
-  }
-  async create(table, data) {
-    const db = this.getDb();
-    const tableSchema = this.schema?.tables[table];
-    const serializedData = this.serializeData(table, data);
-    if (tableSchema) {
-      const { mainData, translatableData } = extractTranslatableData(serializedData, tableSchema);
-      const columns2 = Object.keys(mainData);
-      const values2 = Object.values(mainData);
-      const placeholders2 = columns2.map(() => "?").join(", ");
-      const sql2 = `INSERT INTO ${table} (${columns2.join(", ")}) VALUES (${placeholders2})`;
-      db.run(sql2, values2);
-      const lastId2 = db.exec("SELECT last_insert_rowid() as id")[0].values[0][0];
-      this.persist();
-      if (Object.keys(translatableData).length > 0 && this.defaultLang) {
-        await this.upsertTranslation(table, lastId2, this.defaultLang, translatableData);
-      }
-      const result2 = await this.get(table, lastId2);
-      return result2;
-    }
-    const columns = Object.keys(serializedData);
-    const values = Object.values(serializedData);
-    const placeholders = columns.map(() => "?").join(", ");
-    const sql = `INSERT INTO ${table} (${columns.join(", ")}) VALUES (${placeholders})`;
-    db.run(sql, values);
-    const lastId = db.exec("SELECT last_insert_rowid() as id")[0].values[0][0];
-    this.persist();
-    const result = await this.get(table, lastId);
-    return result;
-  }
-  async createWithTranslations(table, data, translations) {
-    const db = this.getDb();
-    const tableSchema = this.schema?.tables[table];
-    const serializedData = this.serializeData(table, data);
-    let mainData = serializedData;
-    let translatableData = {};
-    if (tableSchema) {
-      const extracted = extractTranslatableData(serializedData, tableSchema);
-      mainData = extracted.mainData;
-      translatableData = extracted.translatableData;
-    }
-    const columns = Object.keys(mainData);
-    const values = Object.values(mainData);
-    const placeholders = columns.map(() => "?").join(", ");
-    const sql = `INSERT INTO ${table} (${columns.join(", ")}) VALUES (${placeholders})`;
-    db.run(sql, values);
-    const lastId = db.exec("SELECT last_insert_rowid() as id")[0].values[0][0];
-    if (translations) {
-      for (const [lang, langData] of Object.entries(translations)) {
-        await this.upsertTranslation(table, lastId, lang, langData);
-      }
-    } else if (Object.keys(translatableData).length > 0 && this.defaultLang) {
-      await this.upsertTranslation(table, lastId, this.defaultLang, translatableData);
-    }
-    this.persist();
-    const result = await this.get(table, lastId);
-    return result;
-  }
-  async update(table, id, data) {
-    const db = this.getDb();
-    const tableSchema = this.schema?.tables[table];
-    const serializedData = this.serializeData(table, data);
-    if (tableSchema) {
-      const { mainData, translatableData } = extractTranslatableData(serializedData, tableSchema);
-      if (Object.keys(mainData).length > 0) {
-        const columns2 = Object.keys(mainData);
-        const values2 = Object.values(mainData);
-        const setParts2 = columns2.map((col) => `${col} = ?`).join(", ");
-        const sql2 = `UPDATE ${table} SET ${setParts2} WHERE id = ?`;
-        db.run(sql2, [...values2, id]);
-      }
-      if (Object.keys(translatableData).length > 0 && this.defaultLang) {
-        await this.upsertTranslation(table, id, this.defaultLang, translatableData);
-      }
-      this.persist();
-      const result2 = await this.get(table, id);
-      return result2;
-    }
-    const columns = Object.keys(serializedData);
-    const values = Object.values(serializedData);
-    const setParts = columns.map((col) => `${col} = ?`).join(", ");
-    const sql = `UPDATE ${table} SET ${setParts} WHERE id = ?`;
-    db.run(sql, [...values, id]);
-    this.persist();
-    const result = await this.get(table, id);
-    return result;
-  }
-  async upsertTranslation(table, id, lang, data) {
-    const db = this.getDb();
-    if (!this.schema) {
-      throw new Error(`No schema found for table: ${table}`);
-    }
-    const { sql, params } = buildTranslationUpsert(table, this.schema, id, lang, data);
-    db.run(sql, params);
-    this.persist();
-  }
-  async getTranslations(table, id) {
-    const tableSchema = this.schema?.tables[table];
-    if (!tableSchema) {
-      return [];
-    }
-    const translationTable = toTranslationTableName(table);
-    const fkName = toTranslationFKName(table);
-    const sql = `SELECT * FROM ${translationTable} WHERE ${fkName} = ?`;
-    return this.runQuery(sql, [id]);
-  }
-  async delete(table, id) {
-    const db = this.getDb();
-    if (this.schema?.tables[table]) {
-      const translationTable = toTranslationTableName(table);
-      const fkName = toTranslationFKName(table);
-      try {
-        db.run(`DELETE FROM ${translationTable} WHERE ${fkName} = ?`, [id]);
-      } catch {}
-    }
-    const sql = `DELETE FROM ${table} WHERE id = ?`;
-    db.run(sql, [id]);
-    this.persist();
-    const changes = db.getRowsModified();
-    return changes > 0;
-  }
-  async execute(query, params) {
-    const db = this.getDb();
-    db.run(query, params);
-    this.persist();
-    const changes = db.getRowsModified();
-    const result = db.exec("SELECT last_insert_rowid() as id");
-    const lastInsertRowid = result[0]?.values[0]?.[0] ?? 0;
-    return { changes, lastInsertRowid };
-  }
-  async raw(query, params) {
-    return this.runQuery(query, params ?? []);
-  }
-  async seed(data) {
-    const db = this.getDb();
-    for (const [table, records] of Object.entries(data)) {
-      for (const record of records) {
-        const serialized = this.serializeData(table, record);
-        const columns = Object.keys(serialized);
-        const values = Object.values(serialized);
-        const placeholders = columns.map(() => "?").join(", ");
-        const sql = `INSERT INTO ${table} (${columns.join(", ")}) VALUES (${placeholders})`;
-        db.run(sql, values);
-      }
-    }
-    this.persist();
-  }
-  async getTables() {
-    const result = this.runQuery("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%'");
-    return result.map((row) => row.name);
-  }
-  async getTableSchema(table) {
-    const db = this.getDb();
-    const result = db.exec(`PRAGMA table_info(${table})`);
-    if (result.length === 0 || result[0].values.length === 0) {
-      return [];
-    }
-    return result[0].values.map((row) => ({
-      name: String(row[1]),
-      type: String(row[2]),
-      notnull: Number(row[3]),
-      pk: Number(row[5])
-    }));
-  }
-  close() {
-    if (this.db) {
-      this.persist();
-      this.db.close();
-      this.db = null;
-    }
-  }
-  async beginTransaction() {
-    await this.execute("BEGIN TRANSACTION");
-  }
-  async commit() {
-    await this.execute("COMMIT");
-    this.persist();
-  }
-  async rollback() {
-    await this.execute("ROLLBACK");
-  }
-  async createMany(table, records, options) {
-    const db = this.getDb();
-    const ids = [];
-    const tableSchema = this.schema?.tables[table];
-    for (const record of records) {
-      const serializedRecord = this.serializeData(table, record);
-      let mainData = serializedRecord;
-      let translatableData = {};
-      if (tableSchema) {
-        const extracted = extractTranslatableData(serializedRecord, tableSchema);
-        mainData = extracted.mainData;
-        translatableData = extracted.translatableData;
-      }
-      const columns = Object.keys(mainData);
-      const values = Object.values(mainData);
-      const placeholders = columns.map(() => "?").join(", ");
-      const insertType = options?.ignore ? "INSERT OR IGNORE" : "INSERT";
-      const sql = `${insertType} INTO ${table} (${columns.join(", ")}) VALUES (${placeholders})`;
-      db.run(sql, values);
-      const lastId = db.exec("SELECT last_insert_rowid() as id")[0].values[0][0];
-      if (db.getRowsModified() > 0) {
-        ids.push(lastId);
-        if (Object.keys(translatableData).length > 0 && this.defaultLang) {
-          await this.upsertTranslation(table, lastId, this.defaultLang, translatableData);
-        }
-      }
-    }
-    this.persist();
-    return { created: ids.length, ids };
-  }
-  async updateMany(table, updates) {
-    let updated = 0;
-    for (const { id, data } of updates) {
-      await this.update(table, id, data);
-      updated++;
-    }
-    return { updated };
-  }
-  async deleteMany(table, ids) {
-    let deleted = 0;
-    for (const id of ids) {
-      const success = await this.delete(table, id);
-      if (success)
-        deleted++;
-    }
-    return { deleted };
-  }
-  export() {
-    return this.getDb().export();
-  }
-  async import(data) {
-    if (!this.SQL) {
-      throw new Error("Database not connected. Call connect() first.");
-    }
-    this.db?.close();
-    this.db = new this.SQL.Database(data);
-    this.persist();
-  }
-  clear() {
-    if (!this.SQL) {
-      throw new Error("Database not connected. Call connect() first.");
-    }
-    this.db?.close();
-    this.db = new this.SQL.Database;
-    this.persist();
-  }
-}
-export {
-  validatePopulate,
-  useDbUpdate,
-  useDbList,
-  useDbLang,
-  useDbGet,
-  useDbDelete,
-  useDbCreate,
-  useDb,
-  useAdapter,
-  resolvePopulate2 as resolvePopulate,
-  parseJSONSchema,
-  getPopulatableFields,
-  f,
-  defineSchema,
-  buildWhereClause2 as buildWhereClause,
-  SqliteAdapter,
-  ORM,
-  DbProvider
-};
+/**
+ * @promakeai/dbreact
+ *
+ * React client for schema-driven multi-language database.
+ * Works with SQL.js (browser SQLite) or REST API backends.
+ */
+// Re-export ORM core for browser usage
+export { ORM, defineSchema, f, buildWhereClause, resolvePopulate, getPopulatableFields, validatePopulate, parseJSONSchema, } from "@promakeai/orm";
+// Provider
+export { DbProvider, useDb, useAdapter, useDbLang, } from "./providers/DbProvider";
+// Generic Hooks
+export { useDbList, useDbGet, useDbCreate, useDbUpdate, useDbDelete, } from "./hooks/useDbHooks";
+// Adapters
+export { SqliteAdapter } from "./adapters/SqliteAdapter";

package/dist/providers/DbProvider.js

@@ -42,7 +42,7 @@ const defaultQueryClient = new QueryClient({
  * }
  * ```
  */
-export function DbProvider({ adapter, lang: langProp = "en", fallbackLang = "en", autoConnect = true, queryClient = defaultQueryClient, children, }) {
+export function DbProvider({ adapter, schema, lang: langProp = "en", fallbackLang = "en", autoConnect = true, queryClient = defaultQueryClient, children, }) {
     const [isConnected, setIsConnected] = useState(false);
     const [error, setError] = useState(null);
     const [lang, setLangState] = useState(langProp);
@@ -94,9 +94,10 @@ export function DbProvider({ adapter, lang: langProp = "en", fallbackLang = "en"
     // Database context value
     const dbContextValue = useMemo(() => ({
         adapter,
+        schema,
         isConnected,
         error,
-    }), [adapter, isConnected, error]);
+    }), [adapter, schema, isConnected, error]);
     // Language context value
     const langContextValue = useMemo(() => ({
         lang,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@promakeai/dbreact",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "React client for schema-driven multi-language database",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -14,10 +14,12 @@
     }
   },
   "scripts": {
-    "build": "bun build index.ts --outdir dist --target browser --packages=external && bun run build:types",
+    "build:js": "tsc --project tsconfig.json --declaration false --declarationMap false --emitDeclarationOnly false --outDir dist",
+    "build": "bun run build:js && bun run build:types",
     "build:types": "tsc --emitDeclarationOnly --declaration --outDir dist",
     "dev": "bun build index.ts --outdir dist --target browser --packages=external --watch",
     "test": "bun test",
+    "test:build-runtime": "bun run build && bun test ./tests/build-runtime.test.ts",
     "typecheck": "tsc --noEmit",
     "release": "bun run build && npm publish --access public"
   },
@@ -40,7 +42,7 @@
     "sql.js": ">=1.11.0"
   },
   "dependencies": {
-    "@promakeai/orm": "1.0.3"
+    "@promakeai/orm": "1.0.5"
   },
   "devDependencies": {
     "@tanstack/query-core": "5.90.20",