@fireproof/core 0.20.0-dev-preview-63 → 0.20.1-dev-preview-01

package/package.json

@@ -1,14 +1,11 @@
 {
   "name": "@fireproof/core",
-  "version": "0.20.0-dev-preview-63",
+  "version": "0.20.1-dev-preview-01",
   "description": "Live ledger for the web.",
   "type": "module",
   "module": "./index.js",
   "main": "./index.cjs",
   "types": "./index.d.ts",
-  "bin": {
-    "fp-cli": "./cli/main.js"
-  },
   "exports": {
     ".": {
       "import": "./index.js",
@@ -18,27 +15,27 @@
     },
     "./node": {
       "import": {
-        "browser": "./runtime/gateways/indexeddb/index.js",
-        "default": "./runtime/gateways/file/node/index.js"
+        "browser": "./indexeddb/index.js",
+        "default": "./node/index.js"
       },
-      "browser": "./runtime/gateways/indexeddb/index.js",
-      "require": "./runtime/gateways/file/node/index.cjs",
-      "types": "./runtime/gateways/file/node/index.d.ts"
+      "browser": "./indexeddb/index.js",
+      "require": "./node/index.cjs",
+      "types": "./node/index.d.ts"
     },
     "./deno": {
       "import": {
-        "browser": "./runtime/gateways/indexeddb/index.js",
-        "default": "./runtime/gateways/file/deno/index.js"
+        "browser": "./indexeddb/index.js",
+        "default": "./deno/index.js"
       },
-      "browser": "./runtime/gateways/indexeddb/index.js",
-      "require": "./runtime/gateways/file/deno/index.cjs",
-      "types": "./runtime/gateways/file/deno/index.d.ts"
+      "browser": "./indexeddb/index.js",
+      "require": "./deno/index.cjs",
+      "types": "./deno/index.d.ts"
     },
     "./indexeddb": {
-      "import": "./runtime/gateways/indexeddb/index.js",
-      "browser": "./runtime/gateways/indexeddb/index.js",
-      "require": "./runtime/gateways/indexeddb/index.cjs",
-      "types": "./runtime/gateways/indexeddb/index.d.ts"
+      "import": "./indexeddb/index.js",
+      "browser": "./indexeddb/index.js",
+      "require": "./indexeddb/index.cjs",
+      "types": "./indexeddb/index.d.ts"
     },
     "./react": {
       "import": "./react/index.js",
@@ -80,11 +77,11 @@
     "react": ">=18.0.0"
   },
   "dependencies": {
-    "@adviser/cement": "~0.4.7",
-    "@fireproof/vendor": "~2.0.2",
+    "@adviser/cement": "~0.4.10",
     "@ipld/car": "^5.4.0",
     "@ipld/dag-cbor": "^9.2.2",
     "@ipld/dag-json": "^10.2.3",
+    "@web3-storage/pail": "^0.6.2",
     "cborg": "^4.2.9",
     "jose": "^6.0.10",
     "multiformats": "^13.3.2",

package/react/index.cjs

@@ -0,0 +1,298 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/react/index.ts
+var index_exports = {};
+__export(index_exports, {
+  FireproofCtx: () => FireproofCtx,
+  ImgFile: () => ImgFile,
+  useFireproof: () => useFireproof
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/react/use-fireproof.ts
+var import_core = require("@fireproof/core");
+var import_react5 = require("react");
+
+// src/react/use-document.ts
+var import_react = require("react");
+
+// src/react/utils.ts
+function deepClone(value) {
+  return (structuredClone ?? ((v) => JSON.parse(JSON.stringify(v))))(value);
+}
+
+// src/react/use-document.ts
+function createUseDocument(database) {
+  const updateHappenedRef = (0, import_react.useRef)(false);
+  return function useDocument(initialDocOrFn) {
+    let initialDoc;
+    if (typeof initialDocOrFn === "function") {
+      initialDoc = initialDocOrFn();
+    } else {
+      initialDoc = initialDocOrFn ?? {};
+    }
+    const originalInitialDoc = (0, import_react.useMemo)(() => deepClone({ ...initialDoc }), []);
+    const [doc, setDoc] = (0, import_react.useState)(initialDoc);
+    const refresh = (0, import_react.useCallback)(async () => {
+      const gotDoc = doc._id ? await database.get(doc._id).catch(() => initialDoc) : initialDoc;
+      setDoc(gotDoc);
+    }, [doc._id]);
+    const save = (0, import_react.useCallback)(
+      async (existingDoc) => {
+        updateHappenedRef.current = false;
+        const toSave = existingDoc ?? doc;
+        const res = await database.put(toSave);
+        if (!updateHappenedRef.current && !doc._id && !existingDoc) {
+          setDoc((d) => ({ ...d, _id: res.id }));
+        }
+        return res;
+      },
+      [doc]
+    );
+    const remove = (0, import_react.useCallback)(
+      async (existingDoc) => {
+        const id = existingDoc?._id ?? doc._id;
+        if (!id) throw database.logger.Error().Msg(`Document must have an _id to be removed`).AsError();
+        const gotDoc = await database.get(id).catch(() => void 0);
+        if (!gotDoc) throw database.logger.Error().Str("id", id).Msg(`Document not found`).AsError();
+        const res = await database.del(id);
+        setDoc(initialDoc);
+        return res;
+      },
+      [doc, initialDoc]
+    );
+    const merge = (0, import_react.useCallback)((newDoc) => {
+      updateHappenedRef.current = true;
+      setDoc((prev) => ({ ...prev, ...newDoc }));
+    }, []);
+    const replace = (0, import_react.useCallback)((newDoc) => {
+      updateHappenedRef.current = true;
+      setDoc(newDoc);
+    }, []);
+    const reset = (0, import_react.useCallback)(() => {
+      updateHappenedRef.current = true;
+      setDoc({ ...originalInitialDoc });
+    }, [originalInitialDoc]);
+    const updateDoc = (0, import_react.useCallback)(
+      (newDoc, opts = { replace: false, reset: false }) => {
+        if (!newDoc) {
+          return opts.reset ? reset() : refresh();
+        }
+        return opts.replace ? replace(newDoc) : merge(newDoc);
+      },
+      [refresh, reset, replace, merge]
+    );
+    (0, import_react.useEffect)(() => {
+      if (!doc._id) return;
+      return database.subscribe((changes) => {
+        if (updateHappenedRef.current) {
+          return;
+        }
+        if (changes.find((c) => c._id === doc._id)) {
+          void refresh();
+        }
+      }, true);
+    }, [doc._id, refresh]);
+    (0, import_react.useEffect)(() => {
+      void refresh();
+    }, [refresh]);
+    const submit = (0, import_react.useCallback)(
+      async (e) => {
+        if (e?.preventDefault) e.preventDefault();
+        await save();
+        reset();
+      },
+      [save, reset]
+    );
+    const apiObject = {
+      doc: { ...doc },
+      merge,
+      replace,
+      reset,
+      refresh,
+      save,
+      remove,
+      submit
+    };
+    const tuple = [{ ...doc }, updateDoc, save, remove, reset, refresh];
+    Object.assign(apiObject, tuple);
+    Object.defineProperty(apiObject, Symbol.iterator, {
+      enumerable: false,
+      value: function* () {
+        yield* tuple;
+      }
+    });
+    return apiObject;
+  };
+}
+
+// src/react/use-live-query.ts
+var import_react2 = require("react");
+function createUseLiveQuery(database) {
+  return function useLiveQuery(mapFn, query = {}, initialRows = []) {
+    const [result, setResult] = (0, import_react2.useState)(() => {
+      const docs = initialRows.map((r) => r.doc).filter((r) => !!r);
+      return Object.assign(docs, {
+        docs,
+        rows: initialRows
+      });
+    });
+    const queryString = (0, import_react2.useMemo)(() => JSON.stringify(query), [query]);
+    const mapFnString = (0, import_react2.useMemo)(() => mapFn.toString(), [mapFn]);
+    const refreshRows = (0, import_react2.useCallback)(async () => {
+      const res = await database.query(mapFn, query);
+      const docs = res.rows.map((r) => r.doc).filter((r) => !!r);
+      setResult(
+        Object.assign(docs, {
+          docs,
+          rows: res.rows
+        })
+      );
+    }, [database, mapFnString, queryString]);
+    (0, import_react2.useEffect)(() => {
+      refreshRows();
+      const unsubscribe = database.subscribe(refreshRows);
+      return () => {
+        unsubscribe();
+      };
+    }, [database, refreshRows]);
+    return result;
+  };
+}
+
+// src/react/use-all-docs.ts
+var import_react3 = require("react");
+function createUseAllDocs(database) {
+  return function useAllDocs(query = {}) {
+    const [result, setResult] = (0, import_react3.useState)({
+      docs: []
+    });
+    const queryString = (0, import_react3.useMemo)(() => JSON.stringify(query), [query]);
+    const refreshRows = (0, import_react3.useCallback)(async () => {
+      const res = await database.allDocs(query);
+      setResult({ ...res, docs: res.rows.map((r) => r.value) });
+    }, [queryString]);
+    (0, import_react3.useEffect)(() => {
+      refreshRows();
+      return database.subscribe(refreshRows);
+    }, [refreshRows]);
+    return result;
+  };
+}
+
+// src/react/use-changes.ts
+var import_react4 = require("react");
+function createUseChanges(database) {
+  return function useChanges(since = [], opts = {}) {
+    const [result, setResult] = (0, import_react4.useState)({
+      docs: []
+    });
+    const queryString = (0, import_react4.useMemo)(() => JSON.stringify(opts), [opts]);
+    const refreshRows = (0, import_react4.useCallback)(async () => {
+      const res = await database.changes(since, opts);
+      setResult({ ...res, docs: res.rows.map((r) => r.value) });
+    }, [since, queryString]);
+    (0, import_react4.useEffect)(() => {
+      refreshRows();
+      return database.subscribe(refreshRows);
+    }, [refreshRows]);
+    return result;
+  };
+}
+
+// src/react/use-fireproof.ts
+var FireproofCtx = {};
+function useFireproof(name = "useFireproof", config = {}) {
+  const database = typeof name === "string" ? (0, import_core.fireproof)(name, config) : name;
+  const hooks = (0, import_react5.useMemo)(() => {
+    return {
+      useDocument: createUseDocument(database),
+      useLiveQuery: createUseLiveQuery(database),
+      useAllDocs: createUseAllDocs(database),
+      useChanges: createUseChanges(database)
+    };
+  }, [database]);
+  const { useDocument, useLiveQuery, useAllDocs, useChanges } = hooks;
+  return { database, useLiveQuery, useDocument, useAllDocs, useChanges };
+}
+
+// src/react/img-file.ts
+var import_react6 = __toESM(require("react"), 1);
+var { URL } = globalThis;
+function isFile(obj) {
+  return "type" in obj && "size" in obj && "stream" in obj && typeof obj.stream === "function";
+}
+function isFileMeta(obj) {
+  return "type" in obj && "size" in obj && "file" in obj && typeof obj.file === "function";
+}
+function ImgFile({ file, meta, ...imgProps }) {
+  const [imgDataUrl, setImgDataUrl] = (0, import_react6.useState)("");
+  const fileData = file || meta;
+  (0, import_react6.useEffect)(() => {
+    if (!fileData) return;
+    const loadFile = async () => {
+      let fileObj = null;
+      let fileType = "";
+      switch (true) {
+        case isFile(fileData):
+          fileObj = fileData;
+          fileType = fileData.type;
+          break;
+        case isFileMeta(fileData):
+          fileType = fileData.type;
+          fileObj = await fileData.file?.() || null;
+          break;
+      }
+      if (fileObj && /image/.test(fileType)) {
+        const src = URL.createObjectURL(fileObj);
+        setImgDataUrl(src);
+        return () => URL.revokeObjectURL(src);
+      }
+    };
+    let isMounted = true;
+    let cleanup;
+    loadFile().then((result) => {
+      if (isMounted) {
+        cleanup = result;
+      } else if (result) {
+        result();
+      }
+    });
+    return () => {
+      isMounted = false;
+      if (cleanup) cleanup();
+    };
+  }, [fileData]);
+  return imgDataUrl ? import_react6.default.createElement("img", {
+    src: imgDataUrl,
+    ...imgProps
+  }) : null;
+}
+//# sourceMappingURL=index.cjs.map

package/react/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/react/index.ts","../../../src/react/use-fireproof.ts","../../../src/react/use-document.ts","../../../src/react/utils.ts","../../../src/react/use-live-query.ts","../../../src/react/use-all-docs.ts","../../../src/react/use-changes.ts","../../../src/react/img-file.ts"],"sourcesContent":["export { FireproofCtx, useFireproof } from \"./use-fireproof.js\";\nexport * from \"./types.js\";\nexport * from \"./img-file.js\";\n","import type { ConfigOpts, Database } from \"@fireproof/core\";\nimport { fireproof } from \"@fireproof/core\";\nimport { useMemo } from \"react\";\nimport type { UseFireproof } from \"./types.js\";\nimport { createUseDocument } from \"./use-document.js\";\nimport { createUseLiveQuery } from \"./use-live-query.js\";\nimport { createUseAllDocs } from \"./use-all-docs.js\";\nimport { createUseChanges } from \"./use-changes.js\";\n\n/**\n * @deprecated Use the `useFireproof` hook instead\n */\nexport const FireproofCtx = {} as UseFireproof;\n\n/**\n *\n * ## Summary\n *\n * React hook to create a custom-named Fireproof database and provides the utility hooks to query against it.\n *\n * ## Usage\n * ```tsx\n * const { database, useLiveQuery, useDocument } = useFireproof(\"dbname\");\n * const { database, useLiveQuery, useDocument } = useFireproof(\"dbname\", { ...options });\n * ```\n *\n * ## Overview\n *\n * TL;DR: Only use this hook if you need to configure a database name other than the default `useFireproof`.\n *\n * For most applications, using the `useLiveQuery` or `useDocument` hooks exported from `use-fireproof` should\n * suffice for the majority of use-cases. Under the hood, they act against a database named `useFireproof` instantiated with\n * default configurations. However, if you need to do a custom database setup or configure a database name more to your liking\n * than the default `useFireproof`, then use `useFireproof` as it exists for that purpose. It will provide you with the\n * custom database accessor and *lexically scoped* versions of `useLiveQuery` and `useDocument` that act against said\n * custom database.\n *\n */\nexport function useFireproof(name: string | Database = \"useFireproof\", config: ConfigOpts = {}): UseFireproof {\n  const database = typeof name === \"string\" ? fireproof(name, config) : name;\n\n  // Memoize the hook factory functions together to ensure they don't recreate on every render\n  const hooks = useMemo(() => {\n    return {\n      useDocument: createUseDocument(database),\n      useLiveQuery: createUseLiveQuery(database),\n      useAllDocs: createUseAllDocs(database),\n      useChanges: createUseChanges(database),\n    };\n  }, [database]);\n\n  const { useDocument, useLiveQuery, useAllDocs, useChanges } = hooks;\n\n  return { database, useLiveQuery, useDocument, useAllDocs, useChanges };\n}\n\n// Export types\nexport type {\n  LiveQueryResult,\n  UseDocumentResult,\n  AllDocsResult,\n  ChangesResult,\n  UseDocument,\n  UseLiveQuery,\n  UseAllDocs,\n  UseChanges,\n  UseFireproof,\n} from \"./types.js\";\n","import { useCallback, useEffect, useMemo, useState, useRef } from \"react\";\nimport type { DocSet, DocTypes, DocWithId, Database } from \"@fireproof/core\";\nimport { deepClone } from \"./utils.js\";\nimport type { DeleteDocFn, StoreDocFn, UseDocumentInitialDocOrFn, UseDocumentResult } from \"./types.js\";\n\n/**\n * Implementation of the useDocument hook\n */\nexport function createUseDocument(database: Database) {\n  const updateHappenedRef = useRef(false);\n\n  return function useDocument<T extends DocTypes>(initialDocOrFn?: UseDocumentInitialDocOrFn<T>): UseDocumentResult<T> {\n    let initialDoc: DocSet<T>;\n    if (typeof initialDocOrFn === \"function\") {\n      initialDoc = initialDocOrFn();\n    } else {\n      initialDoc = initialDocOrFn ?? ({} as T);\n    }\n\n    const originalInitialDoc = useMemo(() => deepClone({ ...initialDoc }), []);\n\n    const [doc, setDoc] = useState(initialDoc);\n\n    const refresh = useCallback(async () => {\n      const gotDoc = doc._id ? await database.get<T>(doc._id).catch(() => initialDoc) : initialDoc;\n      setDoc(gotDoc);\n    }, [doc._id]);\n\n    const save: StoreDocFn<T> = useCallback(\n      async (existingDoc) => {\n        updateHappenedRef.current = false;\n        const toSave = existingDoc ?? doc;\n        const res = await database.put(toSave);\n\n        if (!updateHappenedRef.current && !doc._id && !existingDoc) {\n          setDoc((d) => ({ ...d, _id: res.id }));\n        }\n\n        return res;\n      },\n      [doc],\n    );\n\n    const remove: DeleteDocFn<T> = useCallback(\n      async (existingDoc) => {\n        const id = existingDoc?._id ?? doc._id;\n        if (!id) throw database.logger.Error().Msg(`Document must have an _id to be removed`).AsError();\n        const gotDoc = await database.get<T>(id).catch(() => undefined);\n        if (!gotDoc) throw database.logger.Error().Str(\"id\", id).Msg(`Document not found`).AsError();\n        const res = await database.del(id);\n        setDoc(initialDoc);\n        return res;\n      },\n      [doc, initialDoc],\n    );\n\n    // New granular update methods\n    const merge = useCallback((newDoc: Partial<T>) => {\n      updateHappenedRef.current = true;\n      setDoc((prev) => ({ ...prev, ...newDoc }));\n    }, []);\n\n    const replace = useCallback((newDoc: T) => {\n      updateHappenedRef.current = true;\n      setDoc(newDoc);\n    }, []);\n\n    const reset = useCallback(() => {\n      updateHappenedRef.current = true;\n      setDoc({ ...originalInitialDoc });\n    }, [originalInitialDoc]);\n\n    // Legacy-compatible updateDoc\n    const updateDoc = useCallback(\n      (newDoc?: DocSet<T>, opts = { replace: false, reset: false }) => {\n        if (!newDoc) {\n          return opts.reset ? reset() : refresh();\n        }\n        return opts.replace ? replace(newDoc as T) : merge(newDoc);\n      },\n      [refresh, reset, replace, merge],\n    );\n\n    useEffect(() => {\n      if (!doc._id) return;\n      return database.subscribe((changes) => {\n        if (updateHappenedRef.current) {\n          return;\n        }\n        if (changes.find((c) => c._id === doc._id)) {\n          void refresh();\n        }\n      }, true);\n    }, [doc._id, refresh]);\n\n    useEffect(() => {\n      void refresh();\n    }, [refresh]);\n\n    const submit = useCallback(\n      async (e?: Event) => {\n        if (e?.preventDefault) e.preventDefault();\n        await save();\n        reset();\n      },\n      [save, reset],\n    );\n\n    // Primary Object API with both new and legacy methods\n    const apiObject = {\n      doc: { ...doc } as DocWithId<T>,\n      merge,\n      replace,\n      reset,\n      refresh,\n      save,\n      remove,\n      submit,\n    };\n\n    // Make the object properly iterable\n    const tuple = [{ ...doc }, updateDoc, save, remove, reset, refresh];\n    Object.assign(apiObject, tuple);\n    Object.defineProperty(apiObject, Symbol.iterator, {\n      enumerable: false,\n      value: function* () {\n        yield* tuple;\n      },\n    });\n\n    return apiObject as UseDocumentResult<T>;\n  };\n}\n","/**\n * Deep clone a value\n */\nexport function deepClone<T>(value: T): T {\n  return (structuredClone ?? ((v: T) => JSON.parse(JSON.stringify(v))))(value);\n}\n","import { useCallback, useEffect, useMemo, useState } from \"react\";\nimport type { DocFragment, DocTypes, DocWithId, IndexKeyType, IndexRow, MapFn, Database } from \"@fireproof/core\";\nimport type { LiveQueryResult } from \"./types.js\";\n\n// Internal shadow type for array-like behavior (implementation detail)\ntype EnhancedQueryResult<T extends DocTypes, K extends IndexKeyType, R extends DocFragment = T> = LiveQueryResult<T, K, R> &\n  DocWithId<T>[];\n\n/**\n * Implementation of the useLiveQuery hook\n */\nexport function createUseLiveQuery(database: Database) {\n  return function useLiveQuery<T extends DocTypes, K extends IndexKeyType = string, R extends DocFragment = T>(\n    mapFn: MapFn<T> | string,\n    query = {},\n    initialRows: IndexRow<K, T, R>[] = [],\n  ): LiveQueryResult<T, K, R> {\n    const [result, setResult] = useState<EnhancedQueryResult<T, K, R>>(() => {\n      const docs = initialRows.map((r) => r.doc).filter((r): r is DocWithId<T> => !!r);\n      return Object.assign(docs, {\n        docs,\n        rows: initialRows,\n      });\n    });\n\n    const queryString = useMemo(() => JSON.stringify(query), [query]);\n    const mapFnString = useMemo(() => mapFn.toString(), [mapFn]);\n\n    const refreshRows = useCallback(async () => {\n      const res = await database.query<K, T, R>(mapFn, query);\n      const docs = res.rows.map((r) => r.doc).filter((r): r is DocWithId<T> => !!r);\n      setResult(\n        Object.assign(docs, {\n          docs,\n          rows: res.rows,\n        }),\n      );\n    }, [database, mapFnString, queryString]);\n\n    useEffect(() => {\n      refreshRows();\n      const unsubscribe = database.subscribe(refreshRows);\n      return () => {\n        unsubscribe();\n      };\n    }, [database, refreshRows]);\n\n    return result;\n  };\n}\n","import { useCallback, useEffect, useMemo, useState } from \"react\";\nimport type { AllDocsQueryOpts, DocTypes, DocWithId, Database } from \"@fireproof/core\";\nimport type { AllDocsResult } from \"./types.js\";\n\n/**\n * Implementation of the useAllDocs hook\n */\nexport function createUseAllDocs(database: Database) {\n  return function useAllDocs<T extends DocTypes>(query: AllDocsQueryOpts = {}): AllDocsResult<T> {\n    const [result, setResult] = useState<AllDocsResult<T>>({\n      docs: [],\n    });\n\n    const queryString = useMemo(() => JSON.stringify(query), [query]);\n\n    const refreshRows = useCallback(async () => {\n      const res = await database.allDocs<T>(query);\n      setResult({ ...res, docs: res.rows.map((r) => r.value as DocWithId<T>) });\n    }, [queryString]);\n\n    useEffect(() => {\n      refreshRows(); // Initial data fetch\n      return database.subscribe(refreshRows);\n    }, [refreshRows]);\n\n    return result;\n  };\n}\n","import { useCallback, useEffect, useMemo, useState } from \"react\";\nimport type { ChangesOptions, ClockHead, DocTypes, DocWithId, Database } from \"@fireproof/core\";\nimport type { ChangesResult } from \"./types.js\";\n\n/**\n * Implementation of the useChanges hook\n */\nexport function createUseChanges(database: Database) {\n  return function useChanges<T extends DocTypes>(since: ClockHead = [], opts: ChangesOptions = {}): ChangesResult<T> {\n    const [result, setResult] = useState<ChangesResult<T>>({\n      docs: [],\n    });\n\n    const queryString = useMemo(() => JSON.stringify(opts), [opts]);\n\n    const refreshRows = useCallback(async () => {\n      const res = await database.changes<T>(since, opts);\n      setResult({ ...res, docs: res.rows.map((r) => r.value as DocWithId<T>) });\n    }, [since, queryString]);\n\n    useEffect(() => {\n      refreshRows(); // Initial data fetch\n      return database.subscribe(refreshRows);\n    }, [refreshRows]);\n\n    return result;\n  };\n}\n","import { DocFileMeta } from \"@fireproof/core\";\nimport React, { useState, useEffect, ImgHTMLAttributes } from \"react\";\n\nconst { URL } = globalThis;\n\n// Union type to support both direct File objects and metadata objects\ntype FileType = File | DocFileMeta;\n\ninterface ImgFileProps extends Omit<ImgHTMLAttributes<HTMLImageElement>, \"src\"> {\n  file?: FileType;\n  /**\n   * @deprecated Use 'file' instead. This is for internal use only to support legacy code.\n   * @internal\n   */\n  meta?: FileType;\n}\n\n// Helper function to determine if the object is a File-like object\nfunction isFile(obj: FileType): obj is File {\n  return \"type\" in obj && \"size\" in obj && \"stream\" in obj && typeof obj.stream === \"function\";\n}\n\n// Helper function to determine if the object is a DocFileMeta\nfunction isFileMeta(obj: FileType): obj is DocFileMeta {\n  return \"type\" in obj && \"size\" in obj && \"file\" in obj && typeof obj.file === \"function\";\n}\n\nexport function ImgFile({ file, meta, ...imgProps }: ImgFileProps) {\n  const [imgDataUrl, setImgDataUrl] = useState(\"\");\n\n  // Use meta as fallback if file is not provided (for backward compatibility)\n  const fileData = file || meta;\n\n  useEffect(() => {\n    if (!fileData) return;\n\n    const loadFile = async () => {\n      let fileObj: File | null = null;\n      let fileType = \"\";\n\n      switch (true) {\n        case isFile(fileData):\n          fileObj = fileData;\n          fileType = fileData.type;\n          break;\n        case isFileMeta(fileData):\n          fileType = fileData.type;\n          fileObj = (await fileData.file?.()) || null;\n          break;\n      }\n\n      if (fileObj && /image/.test(fileType)) {\n        const src = URL.createObjectURL(fileObj);\n        setImgDataUrl(src);\n        return () => URL.revokeObjectURL(src);\n      }\n    };\n\n    let isMounted = true;\n    let cleanup: (() => void) | undefined;\n\n    loadFile().then((result) => {\n      if (isMounted) {\n        cleanup = result;\n      } else if (result) {\n        result();\n      }\n    });\n\n    return () => {\n      isMounted = false;\n      if (cleanup) cleanup();\n    };\n  }, [fileData]);\n\n  return imgDataUrl\n    ? React.createElement(\"img\", {\n        src: imgDataUrl,\n        ...imgProps,\n      })\n    : null;\n}\n\nexport default ImgFile;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACCA,kBAA0B;AAC1B,IAAAA,gBAAwB;;;ACFxB,mBAAkE;;;ACG3D,SAAS,UAAa,OAAa;AACxC,UAAQ,oBAAoB,CAAC,MAAS,KAAK,MAAM,KAAK,UAAU,CAAC,CAAC,IAAI,KAAK;AAC7E;;;ADGO,SAAS,kBAAkB,UAAoB;AACpD,QAAM,wBAAoB,qBAAO,KAAK;AAEtC,SAAO,SAAS,YAAgC,gBAAqE;AACnH,QAAI;AACJ,QAAI,OAAO,mBAAmB,YAAY;AACxC,mBAAa,eAAe;AAAA,IAC9B,OAAO;AACL,mBAAa,kBAAmB,CAAC;AAAA,IACnC;AAEA,UAAM,yBAAqB,sBAAQ,MAAM,UAAU,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;AAEzE,UAAM,CAAC,KAAK,MAAM,QAAI,uBAAS,UAAU;AAEzC,UAAM,cAAU,0BAAY,YAAY;AACtC,YAAM,SAAS,IAAI,MAAM,MAAM,SAAS,IAAO,IAAI,GAAG,EAAE,MAAM,MAAM,UAAU,IAAI;AAClF,aAAO,MAAM;AAAA,IACf,GAAG,CAAC,IAAI,GAAG,CAAC;AAEZ,UAAM,WAAsB;AAAA,MAC1B,OAAO,gBAAgB;AACrB,0BAAkB,UAAU;AAC5B,cAAM,SAAS,eAAe;AAC9B,cAAM,MAAM,MAAM,SAAS,IAAI,MAAM;AAErC,YAAI,CAAC,kBAAkB,WAAW,CAAC,IAAI,OAAO,CAAC,aAAa;AAC1D,iBAAO,CAAC,OAAO,EAAE,GAAG,GAAG,KAAK,IAAI,GAAG,EAAE;AAAA,QACvC;AAEA,eAAO;AAAA,MACT;AAAA,MACA,CAAC,GAAG;AAAA,IACN;AAEA,UAAM,aAAyB;AAAA,MAC7B,OAAO,gBAAgB;AACrB,cAAM,KAAK,aAAa,OAAO,IAAI;AACnC,YAAI,CAAC,GAAI,OAAM,SAAS,OAAO,MAAM,EAAE,IAAI,yCAAyC,EAAE,QAAQ;AAC9F,cAAM,SAAS,MAAM,SAAS,IAAO,EAAE,EAAE,MAAM,MAAM,MAAS;AAC9D,YAAI,CAAC,OAAQ,OAAM,SAAS,OAAO,MAAM,EAAE,IAAI,MAAM,EAAE,EAAE,IAAI,oBAAoB,EAAE,QAAQ;AAC3F,cAAM,MAAM,MAAM,SAAS,IAAI,EAAE;AACjC,eAAO,UAAU;AACjB,eAAO;AAAA,MACT;AAAA,MACA,CAAC,KAAK,UAAU;AAAA,IAClB;AAGA,UAAM,YAAQ,0BAAY,CAAC,WAAuB;AAChD,wBAAkB,UAAU;AAC5B,aAAO,CAAC,UAAU,EAAE,GAAG,MAAM,GAAG,OAAO,EAAE;AAAA,IAC3C,GAAG,CAAC,CAAC;AAEL,UAAM,cAAU,0BAAY,CAAC,WAAc;AACzC,wBAAkB,UAAU;AAC5B,aAAO,MAAM;AAAA,IACf,GAAG,CAAC,CAAC;AAEL,UAAM,YAAQ,0BAAY,MAAM;AAC9B,wBAAkB,UAAU;AAC5B,aAAO,EAAE,GAAG,mBAAmB,CAAC;AAAA,IAClC,GAAG,CAAC,kBAAkB,CAAC;AAGvB,UAAM,gBAAY;AAAA,MAChB,CAAC,QAAoB,OAAO,EAAE,SAAS,OAAO,OAAO,MAAM,MAAM;AAC/D,YAAI,CAAC,QAAQ;AACX,iBAAO,KAAK,QAAQ,MAAM,IAAI,QAAQ;AAAA,QACxC;AACA,eAAO,KAAK,UAAU,QAAQ,MAAW,IAAI,MAAM,MAAM;AAAA,MAC3D;AAAA,MACA,CAAC,SAAS,OAAO,SAAS,KAAK;AAAA,IACjC;AAEA,gCAAU,MAAM;AACd,UAAI,CAAC,IAAI,IAAK;AACd,aAAO,SAAS,UAAU,CAAC,YAAY;AACrC,YAAI,kBAAkB,SAAS;AAC7B;AAAA,QACF;AACA,YAAI,QAAQ,KAAK,CAAC,MAAM,EAAE,QAAQ,IAAI,GAAG,GAAG;AAC1C,eAAK,QAAQ;AAAA,QACf;AAAA,MACF,GAAG,IAAI;AAAA,IACT,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC;AAErB,gCAAU,MAAM;AACd,WAAK,QAAQ;AAAA,IACf,GAAG,CAAC,OAAO,CAAC;AAEZ,UAAM,aAAS;AAAA,MACb,OAAO,MAAc;AACnB,YAAI,GAAG,eAAgB,GAAE,eAAe;AACxC,cAAM,KAAK;AACX,cAAM;AAAA,MACR;AAAA,MACA,CAAC,MAAM,KAAK;AAAA,IACd;AAGA,UAAM,YAAY;AAAA,MAChB,KAAK,EAAE,GAAG,IAAI;AAAA,MACd;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAGA,UAAM,QAAQ,CAAC,EAAE,GAAG,IAAI,GAAG,WAAW,MAAM,QAAQ,OAAO,OAAO;AAClE,WAAO,OAAO,WAAW,KAAK;AAC9B,WAAO,eAAe,WAAW,OAAO,UAAU;AAAA,MAChD,YAAY;AAAA,MACZ,OAAO,aAAa;AAClB,eAAO;AAAA,MACT;AAAA,IACF,CAAC;AAED,WAAO;AAAA,EACT;AACF;;;AEpIA,IAAAC,gBAA0D;AAWnD,SAAS,mBAAmB,UAAoB;AACrD,SAAO,SAAS,aACd,OACA,QAAQ,CAAC,GACT,cAAmC,CAAC,GACV;AAC1B,UAAM,CAAC,QAAQ,SAAS,QAAI,wBAAuC,MAAM;AACvE,YAAM,OAAO,YAAY,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,MAAyB,CAAC,CAAC,CAAC;AAC/E,aAAO,OAAO,OAAO,MAAM;AAAA,QACzB;AAAA,QACA,MAAM;AAAA,MACR,CAAC;AAAA,IACH,CAAC;AAED,UAAM,kBAAc,uBAAQ,MAAM,KAAK,UAAU,KAAK,GAAG,CAAC,KAAK,CAAC;AAChE,UAAM,kBAAc,uBAAQ,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,CAAC;AAE3D,UAAM,kBAAc,2BAAY,YAAY;AAC1C,YAAM,MAAM,MAAM,SAAS,MAAe,OAAO,KAAK;AACtD,YAAM,OAAO,IAAI,KAAK,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,MAAyB,CAAC,CAAC,CAAC;AAC5E;AAAA,QACE,OAAO,OAAO,MAAM;AAAA,UAClB;AAAA,UACA,MAAM,IAAI;AAAA,QACZ,CAAC;AAAA,MACH;AAAA,IACF,GAAG,CAAC,UAAU,aAAa,WAAW,CAAC;AAEvC,iCAAU,MAAM;AACd,kBAAY;AACZ,YAAM,cAAc,SAAS,UAAU,WAAW;AAClD,aAAO,MAAM;AACX,oBAAY;AAAA,MACd;AAAA,IACF,GAAG,CAAC,UAAU,WAAW,CAAC;AAE1B,WAAO;AAAA,EACT;AACF;;;ACjDA,IAAAC,gBAA0D;AAOnD,SAAS,iBAAiB,UAAoB;AACnD,SAAO,SAAS,WAA+B,QAA0B,CAAC,GAAqB;AAC7F,UAAM,CAAC,QAAQ,SAAS,QAAI,wBAA2B;AAAA,MACrD,MAAM,CAAC;AAAA,IACT,CAAC;AAED,UAAM,kBAAc,uBAAQ,MAAM,KAAK,UAAU,KAAK,GAAG,CAAC,KAAK,CAAC;AAEhE,UAAM,kBAAc,2BAAY,YAAY;AAC1C,YAAM,MAAM,MAAM,SAAS,QAAW,KAAK;AAC3C,gBAAU,EAAE,GAAG,KAAK,MAAM,IAAI,KAAK,IAAI,CAAC,MAAM,EAAE,KAAqB,EAAE,CAAC;AAAA,IAC1E,GAAG,CAAC,WAAW,CAAC;AAEhB,iCAAU,MAAM;AACd,kBAAY;AACZ,aAAO,SAAS,UAAU,WAAW;AAAA,IACvC,GAAG,CAAC,WAAW,CAAC;AAEhB,WAAO;AAAA,EACT;AACF;;;AC3BA,IAAAC,gBAA0D;AAOnD,SAAS,iBAAiB,UAAoB;AACnD,SAAO,SAAS,WAA+B,QAAmB,CAAC,GAAG,OAAuB,CAAC,GAAqB;AACjH,UAAM,CAAC,QAAQ,SAAS,QAAI,wBAA2B;AAAA,MACrD,MAAM,CAAC;AAAA,IACT,CAAC;AAED,UAAM,kBAAc,uBAAQ,MAAM,KAAK,UAAU,IAAI,GAAG,CAAC,IAAI,CAAC;AAE9D,UAAM,kBAAc,2BAAY,YAAY;AAC1C,YAAM,MAAM,MAAM,SAAS,QAAW,OAAO,IAAI;AACjD,gBAAU,EAAE,GAAG,KAAK,MAAM,IAAI,KAAK,IAAI,CAAC,MAAM,EAAE,KAAqB,EAAE,CAAC;AAAA,IAC1E,GAAG,CAAC,OAAO,WAAW,CAAC;AAEvB,iCAAU,MAAM;AACd,kBAAY;AACZ,aAAO,SAAS,UAAU,WAAW;AAAA,IACvC,GAAG,CAAC,WAAW,CAAC;AAEhB,WAAO;AAAA,EACT;AACF;;;ALfO,IAAM,eAAe,CAAC;AA0BtB,SAAS,aAAa,OAA0B,gBAAgB,SAAqB,CAAC,GAAiB;AAC5G,QAAM,WAAW,OAAO,SAAS,eAAW,uBAAU,MAAM,MAAM,IAAI;AAGtE,QAAM,YAAQ,uBAAQ,MAAM;AAC1B,WAAO;AAAA,MACL,aAAa,kBAAkB,QAAQ;AAAA,MACvC,cAAc,mBAAmB,QAAQ;AAAA,MACzC,YAAY,iBAAiB,QAAQ;AAAA,MACrC,YAAY,iBAAiB,QAAQ;AAAA,IACvC;AAAA,EACF,GAAG,CAAC,QAAQ,CAAC;AAEb,QAAM,EAAE,aAAa,cAAc,YAAY,WAAW,IAAI;AAE9D,SAAO,EAAE,UAAU,cAAc,aAAa,YAAY,WAAW;AACvE;;;AMrDA,IAAAC,gBAA8D;AAE9D,IAAM,EAAE,IAAI,IAAI;AAehB,SAAS,OAAO,KAA4B;AAC1C,SAAO,UAAU,OAAO,UAAU,OAAO,YAAY,OAAO,OAAO,IAAI,WAAW;AACpF;AAGA,SAAS,WAAW,KAAmC;AACrD,SAAO,UAAU,OAAO,UAAU,OAAO,UAAU,OAAO,OAAO,IAAI,SAAS;AAChF;AAEO,SAAS,QAAQ,EAAE,MAAM,MAAM,GAAG,SAAS,GAAiB;AACjE,QAAM,CAAC,YAAY,aAAa,QAAI,wBAAS,EAAE;AAG/C,QAAM,WAAW,QAAQ;AAEzB,+BAAU,MAAM;AACd,QAAI,CAAC,SAAU;AAEf,UAAM,WAAW,YAAY;AAC3B,UAAI,UAAuB;AAC3B,UAAI,WAAW;AAEf,cAAQ,MAAM;AAAA,QACZ,KAAK,OAAO,QAAQ;AAClB,oBAAU;AACV,qBAAW,SAAS;AACpB;AAAA,QACF,KAAK,WAAW,QAAQ;AACtB,qBAAW,SAAS;AACpB,oBAAW,MAAM,SAAS,OAAO,KAAM;AACvC;AAAA,MACJ;AAEA,UAAI,WAAW,QAAQ,KAAK,QAAQ,GAAG;AACrC,cAAM,MAAM,IAAI,gBAAgB,OAAO;AACvC,sBAAc,GAAG;AACjB,eAAO,MAAM,IAAI,gBAAgB,GAAG;AAAA,MACtC;AAAA,IACF;AAEA,QAAI,YAAY;AAChB,QAAI;AAEJ,aAAS,EAAE,KAAK,CAAC,WAAW;AAC1B,UAAI,WAAW;AACb,kBAAU;AAAA,MACZ,WAAW,QAAQ;AACjB,eAAO;AAAA,MACT;AAAA,IACF,CAAC;AAED,WAAO,MAAM;AACX,kBAAY;AACZ,UAAI,QAAS,SAAQ;AAAA,IACvB;AAAA,EACF,GAAG,CAAC,QAAQ,CAAC;AAEb,SAAO,aACH,cAAAC,QAAM,cAAc,OAAO;AAAA,IACzB,KAAK;AAAA,IACL,GAAG;AAAA,EACL,CAAC,IACD;AACN;","names":["import_react","import_react","import_react","import_react","import_react","React"]}

package/react/{img-file.d.ts → index.d.cts}

@@ -1,14 +1,60 @@
-import { DocFileMeta } from "@fireproof/core";
-import React, { ImgHTMLAttributes } from "react";
+import { Database, DocTypes, DocSet, DocWithId, DocResponse, IndexKeyType, DocFragment, MapFn, QueryOpts, IndexRow, AllDocsQueryOpts, ClockHead, ChangesOptions, ConfigOpts, DocFileMeta } from '@fireproof/core';
+import React, { ImgHTMLAttributes } from 'react';
+
+interface LiveQueryResult<T extends DocTypes, K extends IndexKeyType, R extends DocFragment = T> {
+    readonly docs: DocWithId<T>[];
+    readonly rows: IndexRow<K, T, R>[];
+}
+type UseLiveQuery = <T extends DocTypes, K extends IndexKeyType = string, R extends DocFragment = T>(mapFn: string | MapFn<T>, query?: QueryOpts<K>, initialRows?: IndexRow<K, T, R>[]) => LiveQueryResult<T, K, R>;
+interface AllDocsResult<T extends DocTypes> {
+    readonly docs: DocWithId<T>[];
+}
+interface ChangesResult<T extends DocTypes> {
+    readonly docs: DocWithId<T>[];
+}
+type UseAllDocs = <T extends DocTypes>(query?: AllDocsQueryOpts) => AllDocsResult<T>;
+type UseChanges = <T extends DocTypes>(since: ClockHead, opts: ChangesOptions) => ChangesResult<T>;
+interface UpdateDocFnOptions {
+    replace?: boolean;
+    reset?: boolean;
+}
+type UpdateDocFn<T extends DocTypes> = (newDoc?: DocSet<T>, options?: UpdateDocFnOptions) => void;
+type StoreDocFn<T extends DocTypes> = (existingDoc?: DocWithId<T>) => Promise<DocResponse>;
+type DeleteDocFn<T extends DocTypes> = (existingDoc?: DocWithId<T>) => Promise<DocResponse>;
+type UseDocumentResultTuple<T extends DocTypes> = [DocWithId<T>, UpdateDocFn<T>, StoreDocFn<T>, DeleteDocFn<T>];
+interface UseDocumentResultObject<T extends DocTypes> {
+    readonly doc: DocWithId<T>;
+    merge(newDoc: Partial<T>): void;
+    replace(newDoc: T): void;
+    reset(): void;
+    refresh(): Promise<void>;
+    save(existingDoc?: DocWithId<T>): Promise<DocResponse>;
+    remove(existingDoc?: DocWithId<T>): Promise<DocResponse>;
+    submit(e?: Event): Promise<void>;
+}
+type UseDocumentResult<T extends DocTypes> = UseDocumentResultObject<T> & UseDocumentResultTuple<T>;
+type UseDocumentInitialDocOrFn<T extends DocTypes> = DocSet<T> | (() => DocSet<T>);
+type UseDocument = <T extends DocTypes>(initialDocOrFn: UseDocumentInitialDocOrFn<T>) => UseDocumentResult<T>;
+interface UseFireproof {
+    readonly database: Database;
+    readonly useDocument: UseDocument;
+    readonly useLiveQuery: UseLiveQuery;
+    readonly useAllDocs: UseAllDocs;
+    readonly useChanges: UseChanges;
+}
+
+declare const FireproofCtx: UseFireproof;
+declare function useFireproof(name?: string | Database, config?: ConfigOpts): UseFireproof;
+
 type FileType = File | DocFileMeta;
 interface ImgFileProps extends Omit<ImgHTMLAttributes<HTMLImageElement>, "src"> {
     file?: FileType;
     meta?: FileType;
 }
-export declare function ImgFile({ file, meta, ...imgProps }: ImgFileProps): React.DetailedReactHTMLElement<{
-    dir?: string | undefined | undefined;
+declare function ImgFile({ file, meta, ...imgProps }: ImgFileProps): React.DetailedReactHTMLElement<{
     id?: string | undefined | undefined;
     loading?: "eager" | "lazy" | undefined | undefined;
+    dir?: string | undefined | undefined;
     alt?: string | undefined | undefined;
     crossOrigin?: "" | "anonymous" | "use-credentials" | undefined;
     decoding?: "async" | "auto" | "sync" | undefined | undefined;
@@ -285,5 +331,6 @@ export declare function ImgFile({ file, meta, ...imgProps }: ImgFileProps): Reac
     onTransitionEndCapture?: React.TransitionEventHandler<HTMLImageElement> | undefined;
     src: string;
 }, HTMLElement> | null;
-export default ImgFile;
-//# sourceMappingURL=img-file.d.ts.map
+
+export { type AllDocsResult, type ChangesResult, type DeleteDocFn, FireproofCtx, ImgFile, type LiveQueryResult, type StoreDocFn, type UpdateDocFn, type UpdateDocFnOptions, type UseAllDocs, type UseChanges, type UseDocument, type UseDocumentInitialDocOrFn, type UseDocumentResult, type UseDocumentResultObject, type UseDocumentResultTuple, type UseFireproof, type UseLiveQuery, useFireproof };
+declare module '@fireproof/core/react'