@promakeai/dbreact 1.0.1

package/dist/hooks/useDbHooks.js

@@ -0,0 +1,157 @@
+/**
+ * Generic Database Hooks
+ *
+ * Type-safe React hooks for database operations.
+ * Works with any table - just pass the table name and type.
+ *
+ * @example
+ * ```tsx
+ * import { useDbList, useDbGet, useDbCreate } from '@promakeai/dbreact';
+ * import type { DbProduct } from './db/types';
+ *
+ * // List all products
+ * const { data } = useDbList<DbProduct>('products');
+ *
+ * // Get single product
+ * const { data } = useDbGet<DbProduct>('products', productId);
+ *
+ * // Create product
+ * const mutation = useDbCreate<DbProduct>('products');
+ * mutation.mutate({ name: 'New Product' });
+ * ```
+ */
+import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
+import { useAdapter, useDbLang } from "../providers/DbProvider";
+/**
+ * Hook to list all records from a table
+ *
+ * @param table - Table name
+ * @param options - Query options (where, orderBy, limit, offset, enabled)
+ * @returns React Query result with data array
+ *
+ * @example
+ * ```tsx
+ * const { data: products, isLoading } = useDbList<DbProduct>('products', {
+ *   where: { price: { $gt: 100 } },
+ *   orderBy: [{ field: 'name', direction: 'ASC' }],
+ *   limit: 10,
+ * });
+ * ```
+ */
+export function useDbList(table, options) {
+    const adapter = useAdapter();
+    const { lang, fallbackLang } = useDbLang();
+    return useQuery({
+        queryKey: [table, "list", options, lang],
+        queryFn: () => adapter.list(table, {
+            ...options,
+            lang,
+            fallbackLang,
+        }),
+        enabled: options?.enabled ?? true,
+    });
+}
+/**
+ * Hook to get a single record by ID or where query
+ *
+ * @param table - Table name
+ * @param idOrOptions - Record ID, or FindOneOptions with where clause
+ * @param maybeOptions - Query options when using ID form
+ * @returns React Query result with single record or null
+ *
+ * @example
+ * ```tsx
+ * // By ID
+ * const { data: product } = useDbGet<DbProduct>('products', productId);
+ *
+ * // By where query (findOne style)
+ * const { data: product } = useDbGet<DbProduct>('products', {
+ *   where: { slug: 'my-product' },
+ *   enabled: !!slug,
+ * });
+ * ```
+ */
+export function useDbGet(table, idOrOptions, maybeOptions) {
+    const adapter = useAdapter();
+    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);
+    return useQuery({
+        queryKey: [table, "single", where, lang],
+        queryFn: () => adapter.findOne(table, { where, lang, fallbackLang }),
+        enabled,
+    });
+}
+/**
+ * Hook to create a new record
+ *
+ * @param table - Table name
+ * @returns React Query mutation for creating records
+ *
+ * @example
+ * ```tsx
+ * const mutation = useDbCreate<DbProduct>('products');
+ *
+ * mutation.mutate({ sku: 'ABC', price: 100 });
+ * ```
+ */
+export function useDbCreate(table) {
+    const adapter = useAdapter();
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: (data) => adapter.create(table, data),
+        onSuccess: () => {
+            queryClient.invalidateQueries({ queryKey: [table] });
+        },
+    });
+}
+/**
+ * Hook to update an existing record
+ *
+ * @param table - Table name
+ * @returns React Query mutation for updating records
+ *
+ * @example
+ * ```tsx
+ * const mutation = useDbUpdate<DbProduct>('products');
+ *
+ * mutation.mutate({ id: 1, data: { price: 150 } });
+ * ```
+ */
+export 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] });
+        },
+    });
+}
+/**
+ * Hook to delete a record
+ *
+ * @param table - Table name
+ * @returns React Query mutation for deleting records
+ *
+ * @example
+ * ```tsx
+ * const mutation = useDbDelete('products');
+ *
+ * mutation.mutate(productId);
+ * ```
+ */
+export function useDbDelete(table) {
+    const adapter = useAdapter();
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: (id) => adapter.delete(table, id),
+        onSuccess: () => {
+            queryClient.invalidateQueries({ queryKey: [table] });
+        },
+    });
+}

package/dist/hooks/useDbLang.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDbLang.d.ts","sourceRoot":"","sources":["../../hooks/useDbLang.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,GAAG,EACH,YAAY,EACZ,CAAC,EACD,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,cAAc,EACd,cAAc,EACd,SAAS,EACT,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,WAAW,GACZ,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,GACf,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,UAAU,EACV,KAAK,EACL,UAAU,EACV,SAAS,GACV,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,SAAS,EACT,QAAQ,EACR,WAAW,EACX,WAAW,EACX,WAAW,EACX,KAAK,WAAW,EAChB,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}