@astriveone/adapter-react 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import type { AstriveOne, Doc, FindOptions } from "@astriveone/core";
+export declare function useCollection(db: AstriveOne, collection: string, options?: FindOptions): Doc[];
+export declare function useDocument(db: AstriveOne, collection: string, id: string | undefined): Doc | null;
+/** Imperative mutation hook with built-in pending/error state for forms */
+export declare function useMutation(db: AstriveOne, collection: string): {
+    pending: any;
+    error: any;
+    set: (doc: Doc) => Promise<Doc | undefined>;
+    update: (id: string, patch: Partial<Doc>) => Promise<Doc | null | undefined>;
+    remove: (id: string) => Promise<boolean | undefined>;
+};

package/dist/index.js

@@ -0,0 +1,71 @@
+/**
+ * astriveone/adapters/react — React hooks for AstriveOne.
+ * Peer dependency: react >= 18 (not bundled, to avoid version conflicts).
+ *
+ *   import { useCollection, useDocument } from "astriveone/adapters/react";
+ *
+ *   function UserList({ db }) {
+ *     const users = useCollection(db, "users");
+ *     return <ul>{users.map(u => <li key={u.id}>{u.username}</li>)}</ul>;
+ *   }
+ */
+import { useEffect, useState } from "react";
+export function useCollection(db, collection, options) {
+    const [data, setData] = useState([]);
+    useEffect(() => {
+        let active = true;
+        const refresh = () => db.find(collection, options).then((docs) => active && setData(docs));
+        refresh();
+        const unsub = db.watch(collection, refresh);
+        return () => {
+            active = false;
+            unsub();
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [db, collection, JSON.stringify(options)]);
+    return data;
+}
+export function useDocument(db, collection, id) {
+    const [doc, setDoc] = useState(null);
+    useEffect(() => {
+        if (!id) {
+            setDoc(null);
+            return;
+        }
+        let active = true;
+        const refresh = () => db.get(collection, id).then((d) => active && setDoc(d));
+        refresh();
+        const unsub = db.watch(collection, refresh, id);
+        return () => {
+            active = false;
+            unsub();
+        };
+    }, [db, collection, id]);
+    return doc;
+}
+/** Imperative mutation hook with built-in pending/error state for forms */
+export function useMutation(db, collection) {
+    const [pending, setPending] = useState(false);
+    const [error, setError] = useState(null);
+    async function run(fn) {
+        setPending(true);
+        setError(null);
+        try {
+            return await fn();
+        }
+        catch (err) {
+            setError(err);
+            return undefined;
+        }
+        finally {
+            setPending(false);
+        }
+    }
+    return {
+        pending,
+        error,
+        set: (doc) => run(() => db.set(collection, doc)),
+        update: (id, patch) => run(() => db.update(collection, id, patch)),
+        remove: (id) => run(() => db.delete(collection, id)),
+    };
+}

package/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@astriveone/adapter-react",
+  "version": "1.0.0",
+  "description": "AstriveOne adapter for react",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": { "build": "tsc -p tsconfig.json" },
+  "dependencies": { "@astriveone/core": "1.0.0" },
+  "peerDependencies": { "react": ">=18" },
+  "files": ["dist"],
+  "license": "MIT"
+}