@fireproof/core 0.20.0-dev-preview-10 → 0.20.0-dev-preview-12

package/react/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/react/index.ts","../../../src/react/useFireproof.ts","../../../src/react/useDocument.ts","../../../src/react/useLiveQuery.ts","../../../src/react/useAllDocs.ts","../../../src/react/useChanges.ts"],"sourcesContent":["export {\n  type TLUseDocument,\n  /** @deprecated Use return values from useFireproof('dbname') instead. Top level usage will be removed in future versions. */\n  useDocument,\n} from \"./useDocument.js\";\nexport { FireproofCtx, type UseFireproof, useFireproof } from \"./useFireproof.js\";\nexport {\n  type TLUseLiveQuery,\n  /** @deprecated Use return values from useFireproof('dbname') instead. Top level usage will be removed in future versions. */\n  useLiveQuery,\n} from \"./useLiveQuery.js\";\nexport {\n  type TLUseAllDocs,\n  /** @deprecated Use return values from useFireproof('dbname') instead. Top level usage will be removed in future versions. */\n  useAllDocs,\n} from \"./useAllDocs.js\";\nexport {\n  type TLUseChanges,\n  /** @deprecated Use return values from useFireproof('dbname') instead. Top level usage will be removed in future versions. */\n  useChanges,\n} from \"./useChanges.js\";\n// why is this there is should be a package system\n// export * from \"@fireproof/core\";\n","import type {\n  ConfigOpts,\n  DocFragment,\n  DocResponse,\n  DocSet,\n  DocTypes,\n  DocWithId,\n  IndexKeyType,\n  IndexRow,\n  MapFn,\n  QueryOpts,\n  Database,\n} from \"@fireproof/core\";\nimport { fireproof } from \"@fireproof/core\";\nimport { useCallback, useEffect, useMemo, useState } from \"react\";\nimport type { AllDocsQueryOpts, ChangesOptions, ClockHead } from \"@fireproof/core\";\n\nexport interface LiveQueryResult<T extends DocTypes, K extends IndexKeyType, R extends DocFragment = T> {\n  readonly docs: DocWithId<T>[];\n  readonly rows: IndexRow<K, T, R>[];\n}\n\nexport type UseLiveQuery = <T extends DocTypes, K extends IndexKeyType = string, R extends DocFragment = T>(\n  mapFn: string | MapFn<T>,\n  query?: QueryOpts<K>,\n  initialRows?: IndexRow<K, T, R>[],\n) => LiveQueryResult<T, K, R>;\n\nexport interface AllDocsResult<T extends DocTypes> {\n  readonly docs: DocWithId<T>[];\n}\n\nexport interface ChangesResult<T extends DocTypes> {\n  readonly docs: DocWithId<T>[];\n}\n\nexport type UseAllDocs = <T extends DocTypes>(query?: AllDocsQueryOpts) => AllDocsResult<T>;\n\nexport type UseChanges = <T extends DocTypes>(since: ClockHead, opts: ChangesOptions) => ChangesResult<T>;\n\ninterface UpdateDocFnOptions {\n  readonly replace?: boolean;\n  readonly reset?: boolean;\n}\n\ntype UpdateDocFn<T extends DocTypes> = (newDoc?: DocSet<T>, options?: UpdateDocFnOptions) => void;\n\ntype StoreDocFn<T extends DocTypes> = (existingDoc?: DocWithId<T>) => Promise<DocResponse>;\n\ntype DeleteDocFn<T extends DocTypes> = (existingDoc?: DocWithId<T>) => Promise<DocResponse>;\n\nexport type UseDocumentResult<T extends DocTypes> = [DocWithId<T>, UpdateDocFn<T>, StoreDocFn<T>, DeleteDocFn<T>];\n\nexport type UseDocumentInitialDocOrFn<T extends DocTypes> = DocSet<T> | (() => DocSet<T>);\nexport type UseDocument = <T extends DocTypes>(initialDocOrFn: UseDocumentInitialDocOrFn<T>) => UseDocumentResult<T>;\n\nexport interface UseFireproof {\n  readonly database: Database;\n  /**\n   * ## Summary\n   *\n   * React hook that provides the ability to create/update/save new Fireproof documents into your custom Fireproof database.\n   * The creation occurs when you do not pass in an `_id` as part of your initial document -- the database will assign a new\n   * one when you call the provided `save` handler. The hook also provides generics support so you can inline your custom type into\n   * the invocation to receive type-safety and auto-complete support in your IDE.\n   *\n   * ## Usage\n   *\n   * ```tsx\n   * const [todo, setTodo, saveTodo] = useDocument<Todo>({\n   *   text: '',\n   *   date: Date.now(),\n   *   completed: false\n   * })\n   *\n   * const [doc, setDoc, saveDoc] = useDocument<Customer>({\n   *   _id: `${props.customerId}-profile`, // you can imagine `customerId` as a prop passed in\n   *   name: \"\",\n   *   company: \"\",\n   *   startedAt: Date.now()\n   * })\n   * ```\n   *\n   * ## Overview\n   *\n   * Changes made via remote sync peers, or other members of your cloud replica group will appear automatically\n   * when you use the `useLiveQuery` and `useDocument` APIs. By default, Fireproof stores data in the browser's\n   * local storage.\n   */\n  readonly useDocument: UseDocument;\n  /**\n   * ## Summary\n   * React hook that provides access to live query results, enabling real-time updates in your app.\n   *\n   * ## Usage\n   * ```tsx\n   * const result = useLiveQuery(\"date\"); // using string key\n   * const result = useLiveQuery('date', { limit: 10, descending: true }) // key + options\n   * const result = useLiveQuery<CustomType>(\"date\"); // using generics\n   * const result = useLiveQuery((doc) => doc.date)); // using map function\n   * ```\n   *\n   * ## Overview\n   * Changes made via remote sync peers, or other members of your cloud replica group will appear automatically\n   * when you use the `useLiveQuery` and `useDocument` APIs. By default, Fireproof stores data in the browser's\n   * local storage.\n   */\n  readonly useLiveQuery: UseLiveQuery;\n  /**\n   * ## Summary\n   * React hook that provides access to all documents in the database, sorted by `_id`.\n   *\n   * ## Usage\n   * ```tsx\n   * const result = useAllDocs({ limit: 10, descending: true }); // with options\n   * const result = useAllDocs(); // without options\n   * ```\n   *\n   * ## Overview\n   * Changes made via remote sync peers, or other members of your cloud replica group will appear automatically\n   * when you use the `useAllDocs` and `useDocument` APIs. By default, Fireproof stores data in the browser's\n   * local storage.\n   */\n  readonly useAllDocs: UseAllDocs;\n  /**\n   * ## Summary\n   * React hook that provides access to all new documents in the database added since the last time the changes was called\n   *\n   * ## Usage\n   * ```tsx\n   * const result = useChanges(prevresult.clock,{limit:10}); // with options\n   * const result = useChanges(); // without options\n   * const database = useChanges.database; // underlying \"useFireproof\" database accessor\n   * ```\n   *\n   * ## Overview\n   * Changes made via remote sync peers, or other members of your cloud replica group will appear automatically\n   * when you use the `useAllDocs`, `useChanges` and `useDocument` APIs. By default, Fireproof stores data in the browser's\n   * local storage.\n   */\n  readonly useChanges: UseChanges;\n}\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.DB(name, config) : name;\n\n  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;\n    }\n\n    // We purposely refetch the docId everytime to check if it has changed\n    const docId = initialDoc._id ?? \"\";\n\n    // We do not want to force consumers to memoize their initial document so we do it for them.\n    // We use the stringified generator function to ensure that the memoization is stable across renders.\n    // const initialDoc = useMemo(initialDocFn, [initialDocFn.toString()]);\n    const [doc, setDoc] = useState(initialDoc);\n\n    const refreshDoc = useCallback(async () => {\n      // todo add option for mvcc checks\n      const doc = docId ? await database.get<T>(docId).catch(() => initialDoc) : initialDoc;\n      setDoc(doc);\n    }, [docId]);\n\n    const saveDoc: StoreDocFn<T> = useCallback(\n      async (existingDoc) => {\n        const res = await database.put(existingDoc ?? doc);\n        // If the document was created, then we need to update the local state with the new `_id`\n        if (!existingDoc && !doc._id) setDoc((d) => ({ ...d, _id: res.id }));\n        return res;\n      },\n      [doc],\n    );\n\n    const deleteDoc: DeleteDocFn<T> = useCallback(\n      async (existingDoc) => {\n        const id = existingDoc?._id ?? docId;\n        const doc = await database.get<T>(id).catch(() => undefined);\n        if (!doc) 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      [docId, initialDoc],\n    );\n\n    const updateDoc: UpdateDocFn<T> = useCallback(\n      (newDoc, opts = { replace: false, reset: false }) => {\n        if (!newDoc) return void (opts.reset ? setDoc(initialDoc) : refreshDoc());\n        setDoc((d) => (opts.replace ? (newDoc as DocWithId<T>) : { ...d, ...newDoc }));\n      },\n      [refreshDoc, initialDoc],\n    );\n\n    useEffect(() => {\n      if (!docId) return;\n      return database.subscribe((changes) => {\n        if (changes.find((c) => c._id === docId)) {\n          void refreshDoc(); // todo use change.value\n        }\n      });\n    }, [docId, refreshDoc]);\n\n    useEffect(() => {\n      void refreshDoc();\n    }, [refreshDoc]);\n\n    return [{ _id: docId, ...doc }, updateDoc, saveDoc, deleteDoc];\n  }\n\n  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<LiveQueryResult<T, K, R>>(() => ({\n      rows: initialRows,\n      docs: initialRows.map((r) => r.doc).filter((r): r is DocWithId<T> => !!r),\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      setResult({ ...res, docs: res.rows.map((r) => r.doc as DocWithId<T>) });\n    }, [mapFnString, queryString]);\n\n    useEffect(() => {\n      refreshRows(); // Initial data fetch\n      return database.subscribe(refreshRows);\n    }, [refreshRows]);\n\n    return result;\n  }\n\n  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  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  return { database, useLiveQuery, useDocument, useAllDocs, useChanges };\n}\n","import { Database, DocTypes, DocWithId } from \"@fireproof/core\";\n\nimport { UseDocument, UseDocumentResult, useFireproof } from \"./useFireproof.js\";\n\nexport interface TLUseDocument {\n  <T extends DocTypes>(initialDoc: DocWithId<T>): UseDocumentResult<T>;\n  database: Database;\n}\n\nfunction topLevelUseDocument(...args: Parameters<UseDocument>) {\n  const { useDocument, database } = useFireproof();\n  (topLevelUseDocument as TLUseDocument).database = database;\n  return useDocument(...args);\n}\n\n/**\n * ## Summary\n *\n * React hook that provides the ability to create new Fireproof documents. The creation occurs when\n * you do not pass in an `_id` as part of your initial document -- the database will assign a new one when\n * you call the provided `save` handler This uses the default database named `useFireproof` under the hood which you can also\n * access via the `database` accessor.\n *\n * ## Usage\n *\n * ```tsx\n * const [todo, setTodo, saveTodo] = useDocument(() => ({\n *   text: '',\n *   date: Date.now(),\n *   completed: false\n * }))\n *\n * const [doc, setDoc, saveDoc] = useDocument(() => ({\n *   _id: `${props.customerId}-profile`, // you can imagine `customerId` as a prop passed in\n *   name: \"\",\n *   company: \"\",\n *   startedAt: Date.now()\n * }))\n *\n * const database = useDocument.database; // underlying \"useFireproof\" database accessor\n * ```\n *\n * ## Overview\n * Changes made via remote sync peers, or other members of your cloud replica group will appear automatically\n * when you use the `useLiveQuery` and `useDocument` APIs. By default, Fireproof stores data in the browser's\n * local storage.\n */\nexport const useDocument = topLevelUseDocument as TLUseDocument;\n","import { Database, DocFragment, DocTypes, IndexKeyType } from \"@fireproof/core\";\n\nimport { LiveQueryResult, useFireproof, UseLiveQuery } from \"./useFireproof.js\";\n\nexport interface TLUseLiveQuery {\n  <T extends DocTypes, K extends IndexKeyType, R extends DocFragment = T>(\n    ...args: Parameters<UseLiveQuery>\n  ): LiveQueryResult<T, K, R>;\n  database: Database;\n}\n\nfunction topLevelUseLiveQuery(...args: Parameters<UseLiveQuery>) {\n  const { useLiveQuery, database } = useFireproof();\n  (topLevelUseLiveQuery as TLUseLiveQuery).database = database;\n  return useLiveQuery(...args);\n}\n\n/**\n * ## Summary\n * React hook that provides access to live query results, enabling real-time updates in your app. This uses\n * the default database named \"useFireproof\" under the hood which you can also access via the `database` accessor.\n *\n * ## Usage\n * ```tsx\n * const results = useLiveQuery(\"date\"); // using string\n * const results = useLiveQuery((doc) => doc.date)); // using map function\n * const database = useLiveQuery.database; // underlying \"useFireproof\" database accessor\n * ```\n *\n * ## Overview\n * Changes made via remote sync peers, or other members of your cloud replica group will appear automatically\n * when you use the `useLiveQuery` and `useDocument` APIs. By default, Fireproof stores data in the browser's\n * local storage.\n */\nexport const useLiveQuery = topLevelUseLiveQuery as TLUseLiveQuery;\n","import { Database, DocTypes } from \"@fireproof/core\";\n\nimport { AllDocsResult, useFireproof, UseAllDocs } from \"./useFireproof.js\";\n\nexport interface TLUseAllDocs {\n  <T extends DocTypes>(...args: Parameters<UseAllDocs>): AllDocsResult<T>;\n  database: Database;\n}\n\nfunction topLevelUseAllDocs(...args: Parameters<UseAllDocs>) {\n  const { useAllDocs, database } = useFireproof();\n  (topLevelUseAllDocs as TLUseAllDocs).database = database;\n  return useAllDocs(...args);\n}\n\n/**\n * ## Summary\n * React hook that provides access to all documents in the database, sorted by `_id`.\n *\n * ## Usage\n * ```tsx\n * const result = useAllDocs({ limit: 10, descending: true }); // with options\n * const result = useAllDocs(); // without options\n * const database = useAllDocs.database; // underlying \"useFireproof\" database accessor\n * ```\n *\n * ## Overview\n * Changes made via remote sync peers, or other members of your cloud replica group will appear automatically\n * when you use the `useAllDocs` and `useDocument` APIs. By default, Fireproof stores data in the browser's\n * local storage.\n */\nexport const useAllDocs = topLevelUseAllDocs as TLUseAllDocs;\n","import { DocTypes, Database } from \"@fireproof/core\";\n\nimport { ChangesResult, useFireproof, UseChanges } from \"./useFireproof.js\";\n\nexport interface TLUseChanges {\n  <T extends DocTypes>(...args: Parameters<UseChanges>): ChangesResult<T>;\n  database: Database;\n}\n\nfunction topLevelUseChanges(...args: Parameters<UseChanges>) {\n  const { useChanges, database } = useFireproof();\n  (topLevelUseChanges as TLUseChanges).database = database;\n  return useChanges(...args);\n}\n\n/**\n * ## Summary\n * React hook that provides access to all new documents in the database added since the last time the changes was called\n *\n * ## Usage\n * ```tsx\n * const result = useChanges(prevresult.clock,{limit:10}); // with options\n * const result = useChanges(); // without options\n * const database = useChanges.database; // underlying \"useFireproof\" database accessor\n * ```\n *\n * ## Overview\n * Changes made via remote sync peers, or other members of your cloud replica group will appear automatically\n * when you use the `useAllDocs`, `useChanges` and `useDocument` APIs. By default, Fireproof stores data in the browser's\n * local storage.\n */\nexport const useChanges = topLevelUseChanges as TLUseChanges;\n"],"mappings":"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","names":["useDocument","doc","useLiveQuery","useAllDocs","useChanges","useDocument","useLiveQuery","useAllDocs","useChanges"]}
+{"version":3,"sources":["../../../src/react/index.ts","../../../src/react/useFireproof.ts","../../../src/react/useDocument.ts","../../../src/react/useLiveQuery.ts","../../../src/react/useAllDocs.ts","../../../src/react/useChanges.ts"],"sourcesContent":["export {\n  type TLUseDocument,\n  /** @deprecated Use return values from useFireproof('dbname') instead. Top level usage will be removed in future versions. */\n  useDocument,\n} from \"./useDocument.js\";\nexport { FireproofCtx, type UseFireproof, useFireproof } from \"./useFireproof.js\";\nexport {\n  type TLUseLiveQuery,\n  /** @deprecated Use return values from useFireproof('dbname') instead. Top level usage will be removed in future versions. */\n  useLiveQuery,\n} from \"./useLiveQuery.js\";\nexport {\n  type TLUseAllDocs,\n  /** @deprecated Use return values from useFireproof('dbname') instead. Top level usage will be removed in future versions. */\n  useAllDocs,\n} from \"./useAllDocs.js\";\nexport {\n  type TLUseChanges,\n  /** @deprecated Use return values from useFireproof('dbname') instead. Top level usage will be removed in future versions. */\n  useChanges,\n} from \"./useChanges.js\";\n// why is this there is should be a package system\n// export * from \"@fireproof/core\";\n","import type {\n  ConfigOpts,\n  DocFragment,\n  DocResponse,\n  DocSet,\n  DocTypes,\n  DocWithId,\n  IndexKeyType,\n  IndexRow,\n  MapFn,\n  QueryOpts,\n  Database,\n} from \"@fireproof/core\";\nimport { fireproof } from \"@fireproof/core\";\nimport { useCallback, useEffect, useMemo, useState } from \"react\";\nimport type { AllDocsQueryOpts, ChangesOptions, ClockHead } from \"@fireproof/core\";\n\nexport interface LiveQueryResult<T extends DocTypes, K extends IndexKeyType, R extends DocFragment = T> {\n  readonly docs: DocWithId<T>[];\n  readonly rows: IndexRow<K, T, R>[];\n}\n\nexport type UseLiveQuery = <T extends DocTypes, K extends IndexKeyType = string, R extends DocFragment = T>(\n  mapFn: string | MapFn<T>,\n  query?: QueryOpts<K>,\n  initialRows?: IndexRow<K, T, R>[],\n) => LiveQueryResult<T, K, R>;\n\nexport interface AllDocsResult<T extends DocTypes> {\n  readonly docs: DocWithId<T>[];\n}\n\nexport interface ChangesResult<T extends DocTypes> {\n  readonly docs: DocWithId<T>[];\n}\n\nexport type UseAllDocs = <T extends DocTypes>(query?: AllDocsQueryOpts) => AllDocsResult<T>;\n\nexport type UseChanges = <T extends DocTypes>(since: ClockHead, opts: ChangesOptions) => ChangesResult<T>;\n\ninterface UpdateDocFnOptions {\n  readonly replace?: boolean;\n  readonly reset?: boolean;\n}\n\ntype UpdateDocFn<T extends DocTypes> = (newDoc?: DocSet<T>, options?: UpdateDocFnOptions) => void;\n\ntype StoreDocFn<T extends DocTypes> = (existingDoc?: DocWithId<T>) => Promise<DocResponse>;\n\ntype DeleteDocFn<T extends DocTypes> = (existingDoc?: DocWithId<T>) => Promise<DocResponse>;\n\nexport type UseDocumentResult<T extends DocTypes> = [DocWithId<T>, UpdateDocFn<T>, StoreDocFn<T>, DeleteDocFn<T>];\n\nexport type UseDocumentInitialDocOrFn<T extends DocTypes> = DocSet<T> | (() => DocSet<T>);\nexport type UseDocument = <T extends DocTypes>(initialDocOrFn: UseDocumentInitialDocOrFn<T>) => UseDocumentResult<T>;\n\nexport interface UseFireproof {\n  readonly database: Database;\n  /**\n   * ## Summary\n   *\n   * React hook that provides the ability to create/update/save new Fireproof documents into your custom Fireproof database.\n   * The creation occurs when you do not pass in an `_id` as part of your initial document -- the database will assign a new\n   * one when you call the provided `save` handler. The hook also provides generics support so you can inline your custom type into\n   * the invocation to receive type-safety and auto-complete support in your IDE.\n   *\n   * ## Usage\n   *\n   * ```tsx\n   * const [todo, setTodo, saveTodo] = useDocument<Todo>({\n   *   text: '',\n   *   date: Date.now(),\n   *   completed: false\n   * })\n   *\n   * const [doc, setDoc, saveDoc] = useDocument<Customer>({\n   *   _id: `${props.customerId}-profile`, // you can imagine `customerId` as a prop passed in\n   *   name: \"\",\n   *   company: \"\",\n   *   startedAt: Date.now()\n   * })\n   * ```\n   *\n   * ## Overview\n   *\n   * Changes made via remote sync peers, or other members of your cloud replica group will appear automatically\n   * when you use the `useLiveQuery` and `useDocument` APIs. By default, Fireproof stores data in the browser's\n   * local storage.\n   */\n  readonly useDocument: UseDocument;\n  /**\n   * ## Summary\n   * React hook that provides access to live query results, enabling real-time updates in your app.\n   *\n   * ## Usage\n   * ```tsx\n   * const result = useLiveQuery(\"date\"); // using string key\n   * const result = useLiveQuery('date', { limit: 10, descending: true }) // key + options\n   * const result = useLiveQuery<CustomType>(\"date\"); // using generics\n   * const result = useLiveQuery((doc) => doc.date)); // using map function\n   * ```\n   *\n   * ## Overview\n   * Changes made via remote sync peers, or other members of your cloud replica group will appear automatically\n   * when you use the `useLiveQuery` and `useDocument` APIs. By default, Fireproof stores data in the browser's\n   * local storage.\n   */\n  readonly useLiveQuery: UseLiveQuery;\n  /**\n   * ## Summary\n   * React hook that provides access to all documents in the database, sorted by `_id`.\n   *\n   * ## Usage\n   * ```tsx\n   * const result = useAllDocs({ limit: 10, descending: true }); // with options\n   * const result = useAllDocs(); // without options\n   * ```\n   *\n   * ## Overview\n   * Changes made via remote sync peers, or other members of your cloud replica group will appear automatically\n   * when you use the `useAllDocs` and `useDocument` APIs. By default, Fireproof stores data in the browser's\n   * local storage.\n   */\n  readonly useAllDocs: UseAllDocs;\n  /**\n   * ## Summary\n   * React hook that provides access to all new documents in the database added since the last time the changes was called\n   *\n   * ## Usage\n   * ```tsx\n   * const result = useChanges(prevresult.clock,{limit:10}); // with options\n   * const result = useChanges(); // without options\n   * const database = useChanges.database; // underlying \"useFireproof\" database accessor\n   * ```\n   *\n   * ## Overview\n   * Changes made via remote sync peers, or other members of your cloud replica group will appear automatically\n   * when you use the `useAllDocs`, `useChanges` and `useDocument` APIs. By default, Fireproof stores data in the browser's\n   * local storage.\n   */\n  readonly useChanges: UseChanges;\n}\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  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;\n    }\n\n    // We purposely refetch the docId everytime to check if it has changed\n    const docId = initialDoc._id ?? \"\";\n\n    // We do not want to force consumers to memoize their initial document so we do it for them.\n    // We use the stringified generator function to ensure that the memoization is stable across renders.\n    // const initialDoc = useMemo(initialDocFn, [initialDocFn.toString()]);\n    const [doc, setDoc] = useState(initialDoc);\n\n    const refreshDoc = useCallback(async () => {\n      // todo add option for mvcc checks\n      const doc = docId ? await database.get<T>(docId).catch(() => initialDoc) : initialDoc;\n      setDoc(doc);\n    }, [docId]);\n\n    const saveDoc: StoreDocFn<T> = useCallback(\n      async (existingDoc) => {\n        const res = await database.put(existingDoc ?? doc);\n        // If the document was created, then we need to update the local state with the new `_id`\n        if (!existingDoc && !doc._id) setDoc((d) => ({ ...d, _id: res.id }));\n        return res;\n      },\n      [doc],\n    );\n\n    const deleteDoc: DeleteDocFn<T> = useCallback(\n      async (existingDoc) => {\n        const id = existingDoc?._id ?? docId;\n        const doc = await database.get<T>(id).catch(() => undefined);\n        if (!doc) 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      [docId, initialDoc],\n    );\n\n    const updateDoc: UpdateDocFn<T> = useCallback(\n      (newDoc, opts = { replace: false, reset: false }) => {\n        if (!newDoc) return void (opts.reset ? setDoc(initialDoc) : refreshDoc());\n        setDoc((d) => (opts.replace ? (newDoc as DocWithId<T>) : { ...d, ...newDoc }));\n      },\n      [refreshDoc, initialDoc],\n    );\n\n    useEffect(() => {\n      if (!docId) return;\n      return database.subscribe((changes) => {\n        if (changes.find((c) => c._id === docId)) {\n          void refreshDoc(); // todo use change.value\n        }\n      });\n    }, [docId, refreshDoc]);\n\n    useEffect(() => {\n      void refreshDoc();\n    }, [refreshDoc]);\n\n    return [{ _id: docId, ...doc }, updateDoc, saveDoc, deleteDoc];\n  }\n\n  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<LiveQueryResult<T, K, R>>(() => ({\n      rows: initialRows,\n      docs: initialRows.map((r) => r.doc).filter((r): r is DocWithId<T> => !!r),\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      setResult({ ...res, docs: res.rows.map((r) => r.doc as DocWithId<T>) });\n    }, [mapFnString, queryString]);\n\n    useEffect(() => {\n      refreshRows(); // Initial data fetch\n      return database.subscribe(refreshRows);\n    }, [refreshRows]);\n\n    return result;\n  }\n\n  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  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  return { database, useLiveQuery, useDocument, useAllDocs, useChanges };\n}\n","import { Database, DocTypes, DocWithId } from \"@fireproof/core\";\n\nimport { UseDocument, UseDocumentResult, useFireproof } from \"./useFireproof.js\";\n\nexport interface TLUseDocument {\n  <T extends DocTypes>(initialDoc: DocWithId<T>): UseDocumentResult<T>;\n  database: Database;\n}\n\nfunction topLevelUseDocument(...args: Parameters<UseDocument>) {\n  const { useDocument, database } = useFireproof();\n  (topLevelUseDocument as TLUseDocument).database = database;\n  return useDocument(...args);\n}\n\n/**\n * ## Summary\n *\n * React hook that provides the ability to create new Fireproof documents. The creation occurs when\n * you do not pass in an `_id` as part of your initial document -- the database will assign a new one when\n * you call the provided `save` handler This uses the default database named `useFireproof` under the hood which you can also\n * access via the `database` accessor.\n *\n * ## Usage\n *\n * ```tsx\n * const [todo, setTodo, saveTodo] = useDocument(() => ({\n *   text: '',\n *   date: Date.now(),\n *   completed: false\n * }))\n *\n * const [doc, setDoc, saveDoc] = useDocument(() => ({\n *   _id: `${props.customerId}-profile`, // you can imagine `customerId` as a prop passed in\n *   name: \"\",\n *   company: \"\",\n *   startedAt: Date.now()\n * }))\n *\n * const database = useDocument.database; // underlying \"useFireproof\" database accessor\n * ```\n *\n * ## Overview\n * Changes made via remote sync peers, or other members of your cloud replica group will appear automatically\n * when you use the `useLiveQuery` and `useDocument` APIs. By default, Fireproof stores data in the browser's\n * local storage.\n */\nexport const useDocument = topLevelUseDocument as TLUseDocument;\n","import { Database, DocFragment, DocTypes, IndexKeyType } from \"@fireproof/core\";\n\nimport { LiveQueryResult, useFireproof, UseLiveQuery } from \"./useFireproof.js\";\n\nexport interface TLUseLiveQuery {\n  <T extends DocTypes, K extends IndexKeyType, R extends DocFragment = T>(\n    ...args: Parameters<UseLiveQuery>\n  ): LiveQueryResult<T, K, R>;\n  database: Database;\n}\n\nfunction topLevelUseLiveQuery(...args: Parameters<UseLiveQuery>) {\n  const { useLiveQuery, database } = useFireproof();\n  (topLevelUseLiveQuery as TLUseLiveQuery).database = database;\n  return useLiveQuery(...args);\n}\n\n/**\n * ## Summary\n * React hook that provides access to live query results, enabling real-time updates in your app. This uses\n * the default database named \"useFireproof\" under the hood which you can also access via the `database` accessor.\n *\n * ## Usage\n * ```tsx\n * const results = useLiveQuery(\"date\"); // using string\n * const results = useLiveQuery((doc) => doc.date)); // using map function\n * const database = useLiveQuery.database; // underlying \"useFireproof\" database accessor\n * ```\n *\n * ## Overview\n * Changes made via remote sync peers, or other members of your cloud replica group will appear automatically\n * when you use the `useLiveQuery` and `useDocument` APIs. By default, Fireproof stores data in the browser's\n * local storage.\n */\nexport const useLiveQuery = topLevelUseLiveQuery as TLUseLiveQuery;\n","import { Database, DocTypes } from \"@fireproof/core\";\n\nimport { AllDocsResult, useFireproof, UseAllDocs } from \"./useFireproof.js\";\n\nexport interface TLUseAllDocs {\n  <T extends DocTypes>(...args: Parameters<UseAllDocs>): AllDocsResult<T>;\n  database: Database;\n}\n\nfunction topLevelUseAllDocs(...args: Parameters<UseAllDocs>) {\n  const { useAllDocs, database } = useFireproof();\n  (topLevelUseAllDocs as TLUseAllDocs).database = database;\n  return useAllDocs(...args);\n}\n\n/**\n * ## Summary\n * React hook that provides access to all documents in the database, sorted by `_id`.\n *\n * ## Usage\n * ```tsx\n * const result = useAllDocs({ limit: 10, descending: true }); // with options\n * const result = useAllDocs(); // without options\n * const database = useAllDocs.database; // underlying \"useFireproof\" database accessor\n * ```\n *\n * ## Overview\n * Changes made via remote sync peers, or other members of your cloud replica group will appear automatically\n * when you use the `useAllDocs` and `useDocument` APIs. By default, Fireproof stores data in the browser's\n * local storage.\n */\nexport const useAllDocs = topLevelUseAllDocs as TLUseAllDocs;\n","import { DocTypes, Database } from \"@fireproof/core\";\n\nimport { ChangesResult, useFireproof, UseChanges } from \"./useFireproof.js\";\n\nexport interface TLUseChanges {\n  <T extends DocTypes>(...args: Parameters<UseChanges>): ChangesResult<T>;\n  database: Database;\n}\n\nfunction topLevelUseChanges(...args: Parameters<UseChanges>) {\n  const { useChanges, database } = useFireproof();\n  (topLevelUseChanges as TLUseChanges).database = database;\n  return useChanges(...args);\n}\n\n/**\n * ## Summary\n * React hook that provides access to all new documents in the database added since the last time the changes was called\n *\n * ## Usage\n * ```tsx\n * const result = useChanges(prevresult.clock,{limit:10}); // with options\n * const result = useChanges(); // without options\n * const database = useChanges.database; // underlying \"useFireproof\" database accessor\n * ```\n *\n * ## Overview\n * Changes made via remote sync peers, or other members of your cloud replica group will appear automatically\n * when you use the `useAllDocs`, `useChanges` and `useDocument` APIs. By default, Fireproof stores data in the browser's\n * local storage.\n */\nexport const useChanges = topLevelUseChanges as TLUseChanges;\n"],"mappings":"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","names":["useDocument","doc","useLiveQuery","useAllDocs","useChanges","useDocument","useLiveQuery","useAllDocs","useChanges"]}

package/react/index.js

@@ -3,7 +3,7 @@ import { fireproof } from "@fireproof/core";
 import { useCallback, useEffect, useMemo, useState } from "react";
 var FireproofCtx = {};
 function useFireproof(name = "useFireproof", config = {}) {
-  const database = typeof name === "string" ? fireproof.DB(name, config) : name;
+  const database = typeof name === "string" ? fireproof(name, config) : name;
   function useDocument2(initialDocOrFn) {
     let initialDoc;
     if (typeof initialDocOrFn === "function") {

package/react/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/react/useFireproof.ts","../../../src/react/useDocument.ts","../../../src/react/useLiveQuery.ts","../../../src/react/useAllDocs.ts","../../../src/react/useChanges.ts"],"sourcesContent":["import type {\n  ConfigOpts,\n  DocFragment,\n  DocResponse,\n  DocSet,\n  DocTypes,\n  DocWithId,\n  IndexKeyType,\n  IndexRow,\n  MapFn,\n  QueryOpts,\n  Database,\n} from \"@fireproof/core\";\nimport { fireproof } from \"@fireproof/core\";\nimport { useCallback, useEffect, useMemo, useState } from \"react\";\nimport type { AllDocsQueryOpts, ChangesOptions, ClockHead } from \"@fireproof/core\";\n\nexport interface LiveQueryResult<T extends DocTypes, K extends IndexKeyType, R extends DocFragment = T> {\n  readonly docs: DocWithId<T>[];\n  readonly rows: IndexRow<K, T, R>[];\n}\n\nexport type UseLiveQuery = <T extends DocTypes, K extends IndexKeyType = string, R extends DocFragment = T>(\n  mapFn: string | MapFn<T>,\n  query?: QueryOpts<K>,\n  initialRows?: IndexRow<K, T, R>[],\n) => LiveQueryResult<T, K, R>;\n\nexport interface AllDocsResult<T extends DocTypes> {\n  readonly docs: DocWithId<T>[];\n}\n\nexport interface ChangesResult<T extends DocTypes> {\n  readonly docs: DocWithId<T>[];\n}\n\nexport type UseAllDocs = <T extends DocTypes>(query?: AllDocsQueryOpts) => AllDocsResult<T>;\n\nexport type UseChanges = <T extends DocTypes>(since: ClockHead, opts: ChangesOptions) => ChangesResult<T>;\n\ninterface UpdateDocFnOptions {\n  readonly replace?: boolean;\n  readonly reset?: boolean;\n}\n\ntype UpdateDocFn<T extends DocTypes> = (newDoc?: DocSet<T>, options?: UpdateDocFnOptions) => void;\n\ntype StoreDocFn<T extends DocTypes> = (existingDoc?: DocWithId<T>) => Promise<DocResponse>;\n\ntype DeleteDocFn<T extends DocTypes> = (existingDoc?: DocWithId<T>) => Promise<DocResponse>;\n\nexport type UseDocumentResult<T extends DocTypes> = [DocWithId<T>, UpdateDocFn<T>, StoreDocFn<T>, DeleteDocFn<T>];\n\nexport type UseDocumentInitialDocOrFn<T extends DocTypes> = DocSet<T> | (() => DocSet<T>);\nexport type UseDocument = <T extends DocTypes>(initialDocOrFn: UseDocumentInitialDocOrFn<T>) => UseDocumentResult<T>;\n\nexport interface UseFireproof {\n  readonly database: Database;\n  /**\n   * ## Summary\n   *\n   * React hook that provides the ability to create/update/save new Fireproof documents into your custom Fireproof database.\n   * The creation occurs when you do not pass in an `_id` as part of your initial document -- the database will assign a new\n   * one when you call the provided `save` handler. The hook also provides generics support so you can inline your custom type into\n   * the invocation to receive type-safety and auto-complete support in your IDE.\n   *\n   * ## Usage\n   *\n   * ```tsx\n   * const [todo, setTodo, saveTodo] = useDocument<Todo>({\n   *   text: '',\n   *   date: Date.now(),\n   *   completed: false\n   * })\n   *\n   * const [doc, setDoc, saveDoc] = useDocument<Customer>({\n   *   _id: `${props.customerId}-profile`, // you can imagine `customerId` as a prop passed in\n   *   name: \"\",\n   *   company: \"\",\n   *   startedAt: Date.now()\n   * })\n   * ```\n   *\n   * ## Overview\n   *\n   * Changes made via remote sync peers, or other members of your cloud replica group will appear automatically\n   * when you use the `useLiveQuery` and `useDocument` APIs. By default, Fireproof stores data in the browser's\n   * local storage.\n   */\n  readonly useDocument: UseDocument;\n  /**\n   * ## Summary\n   * React hook that provides access to live query results, enabling real-time updates in your app.\n   *\n   * ## Usage\n   * ```tsx\n   * const result = useLiveQuery(\"date\"); // using string key\n   * const result = useLiveQuery('date', { limit: 10, descending: true }) // key + options\n   * const result = useLiveQuery<CustomType>(\"date\"); // using generics\n   * const result = useLiveQuery((doc) => doc.date)); // using map function\n   * ```\n   *\n   * ## Overview\n   * Changes made via remote sync peers, or other members of your cloud replica group will appear automatically\n   * when you use the `useLiveQuery` and `useDocument` APIs. By default, Fireproof stores data in the browser's\n   * local storage.\n   */\n  readonly useLiveQuery: UseLiveQuery;\n  /**\n   * ## Summary\n   * React hook that provides access to all documents in the database, sorted by `_id`.\n   *\n   * ## Usage\n   * ```tsx\n   * const result = useAllDocs({ limit: 10, descending: true }); // with options\n   * const result = useAllDocs(); // without options\n   * ```\n   *\n   * ## Overview\n   * Changes made via remote sync peers, or other members of your cloud replica group will appear automatically\n   * when you use the `useAllDocs` and `useDocument` APIs. By default, Fireproof stores data in the browser's\n   * local storage.\n   */\n  readonly useAllDocs: UseAllDocs;\n  /**\n   * ## Summary\n   * React hook that provides access to all new documents in the database added since the last time the changes was called\n   *\n   * ## Usage\n   * ```tsx\n   * const result = useChanges(prevresult.clock,{limit:10}); // with options\n   * const result = useChanges(); // without options\n   * const database = useChanges.database; // underlying \"useFireproof\" database accessor\n   * ```\n   *\n   * ## Overview\n   * Changes made via remote sync peers, or other members of your cloud replica group will appear automatically\n   * when you use the `useAllDocs`, `useChanges` and `useDocument` APIs. By default, Fireproof stores data in the browser's\n   * local storage.\n   */\n  readonly useChanges: UseChanges;\n}\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.DB(name, config) : name;\n\n  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;\n    }\n\n    // We purposely refetch the docId everytime to check if it has changed\n    const docId = initialDoc._id ?? \"\";\n\n    // We do not want to force consumers to memoize their initial document so we do it for them.\n    // We use the stringified generator function to ensure that the memoization is stable across renders.\n    // const initialDoc = useMemo(initialDocFn, [initialDocFn.toString()]);\n    const [doc, setDoc] = useState(initialDoc);\n\n    const refreshDoc = useCallback(async () => {\n      // todo add option for mvcc checks\n      const doc = docId ? await database.get<T>(docId).catch(() => initialDoc) : initialDoc;\n      setDoc(doc);\n    }, [docId]);\n\n    const saveDoc: StoreDocFn<T> = useCallback(\n      async (existingDoc) => {\n        const res = await database.put(existingDoc ?? doc);\n        // If the document was created, then we need to update the local state with the new `_id`\n        if (!existingDoc && !doc._id) setDoc((d) => ({ ...d, _id: res.id }));\n        return res;\n      },\n      [doc],\n    );\n\n    const deleteDoc: DeleteDocFn<T> = useCallback(\n      async (existingDoc) => {\n        const id = existingDoc?._id ?? docId;\n        const doc = await database.get<T>(id).catch(() => undefined);\n        if (!doc) 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      [docId, initialDoc],\n    );\n\n    const updateDoc: UpdateDocFn<T> = useCallback(\n      (newDoc, opts = { replace: false, reset: false }) => {\n        if (!newDoc) return void (opts.reset ? setDoc(initialDoc) : refreshDoc());\n        setDoc((d) => (opts.replace ? (newDoc as DocWithId<T>) : { ...d, ...newDoc }));\n      },\n      [refreshDoc, initialDoc],\n    );\n\n    useEffect(() => {\n      if (!docId) return;\n      return database.subscribe((changes) => {\n        if (changes.find((c) => c._id === docId)) {\n          void refreshDoc(); // todo use change.value\n        }\n      });\n    }, [docId, refreshDoc]);\n\n    useEffect(() => {\n      void refreshDoc();\n    }, [refreshDoc]);\n\n    return [{ _id: docId, ...doc }, updateDoc, saveDoc, deleteDoc];\n  }\n\n  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<LiveQueryResult<T, K, R>>(() => ({\n      rows: initialRows,\n      docs: initialRows.map((r) => r.doc).filter((r): r is DocWithId<T> => !!r),\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      setResult({ ...res, docs: res.rows.map((r) => r.doc as DocWithId<T>) });\n    }, [mapFnString, queryString]);\n\n    useEffect(() => {\n      refreshRows(); // Initial data fetch\n      return database.subscribe(refreshRows);\n    }, [refreshRows]);\n\n    return result;\n  }\n\n  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  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  return { database, useLiveQuery, useDocument, useAllDocs, useChanges };\n}\n","import { Database, DocTypes, DocWithId } from \"@fireproof/core\";\n\nimport { UseDocument, UseDocumentResult, useFireproof } from \"./useFireproof.js\";\n\nexport interface TLUseDocument {\n  <T extends DocTypes>(initialDoc: DocWithId<T>): UseDocumentResult<T>;\n  database: Database;\n}\n\nfunction topLevelUseDocument(...args: Parameters<UseDocument>) {\n  const { useDocument, database } = useFireproof();\n  (topLevelUseDocument as TLUseDocument).database = database;\n  return useDocument(...args);\n}\n\n/**\n * ## Summary\n *\n * React hook that provides the ability to create new Fireproof documents. The creation occurs when\n * you do not pass in an `_id` as part of your initial document -- the database will assign a new one when\n * you call the provided `save` handler This uses the default database named `useFireproof` under the hood which you can also\n * access via the `database` accessor.\n *\n * ## Usage\n *\n * ```tsx\n * const [todo, setTodo, saveTodo] = useDocument(() => ({\n *   text: '',\n *   date: Date.now(),\n *   completed: false\n * }))\n *\n * const [doc, setDoc, saveDoc] = useDocument(() => ({\n *   _id: `${props.customerId}-profile`, // you can imagine `customerId` as a prop passed in\n *   name: \"\",\n *   company: \"\",\n *   startedAt: Date.now()\n * }))\n *\n * const database = useDocument.database; // underlying \"useFireproof\" database accessor\n * ```\n *\n * ## Overview\n * Changes made via remote sync peers, or other members of your cloud replica group will appear automatically\n * when you use the `useLiveQuery` and `useDocument` APIs. By default, Fireproof stores data in the browser's\n * local storage.\n */\nexport const useDocument = topLevelUseDocument as TLUseDocument;\n","import { Database, DocFragment, DocTypes, IndexKeyType } from \"@fireproof/core\";\n\nimport { LiveQueryResult, useFireproof, UseLiveQuery } from \"./useFireproof.js\";\n\nexport interface TLUseLiveQuery {\n  <T extends DocTypes, K extends IndexKeyType, R extends DocFragment = T>(\n    ...args: Parameters<UseLiveQuery>\n  ): LiveQueryResult<T, K, R>;\n  database: Database;\n}\n\nfunction topLevelUseLiveQuery(...args: Parameters<UseLiveQuery>) {\n  const { useLiveQuery, database } = useFireproof();\n  (topLevelUseLiveQuery as TLUseLiveQuery).database = database;\n  return useLiveQuery(...args);\n}\n\n/**\n * ## Summary\n * React hook that provides access to live query results, enabling real-time updates in your app. This uses\n * the default database named \"useFireproof\" under the hood which you can also access via the `database` accessor.\n *\n * ## Usage\n * ```tsx\n * const results = useLiveQuery(\"date\"); // using string\n * const results = useLiveQuery((doc) => doc.date)); // using map function\n * const database = useLiveQuery.database; // underlying \"useFireproof\" database accessor\n * ```\n *\n * ## Overview\n * Changes made via remote sync peers, or other members of your cloud replica group will appear automatically\n * when you use the `useLiveQuery` and `useDocument` APIs. By default, Fireproof stores data in the browser's\n * local storage.\n */\nexport const useLiveQuery = topLevelUseLiveQuery as TLUseLiveQuery;\n","import { Database, DocTypes } from \"@fireproof/core\";\n\nimport { AllDocsResult, useFireproof, UseAllDocs } from \"./useFireproof.js\";\n\nexport interface TLUseAllDocs {\n  <T extends DocTypes>(...args: Parameters<UseAllDocs>): AllDocsResult<T>;\n  database: Database;\n}\n\nfunction topLevelUseAllDocs(...args: Parameters<UseAllDocs>) {\n  const { useAllDocs, database } = useFireproof();\n  (topLevelUseAllDocs as TLUseAllDocs).database = database;\n  return useAllDocs(...args);\n}\n\n/**\n * ## Summary\n * React hook that provides access to all documents in the database, sorted by `_id`.\n *\n * ## Usage\n * ```tsx\n * const result = useAllDocs({ limit: 10, descending: true }); // with options\n * const result = useAllDocs(); // without options\n * const database = useAllDocs.database; // underlying \"useFireproof\" database accessor\n * ```\n *\n * ## Overview\n * Changes made via remote sync peers, or other members of your cloud replica group will appear automatically\n * when you use the `useAllDocs` and `useDocument` APIs. By default, Fireproof stores data in the browser's\n * local storage.\n */\nexport const useAllDocs = topLevelUseAllDocs as TLUseAllDocs;\n","import { DocTypes, Database } from \"@fireproof/core\";\n\nimport { ChangesResult, useFireproof, UseChanges } from \"./useFireproof.js\";\n\nexport interface TLUseChanges {\n  <T extends DocTypes>(...args: Parameters<UseChanges>): ChangesResult<T>;\n  database: Database;\n}\n\nfunction topLevelUseChanges(...args: Parameters<UseChanges>) {\n  const { useChanges, database } = useFireproof();\n  (topLevelUseChanges as TLUseChanges).database = database;\n  return useChanges(...args);\n}\n\n/**\n * ## Summary\n * React hook that provides access to all new documents in the database added since the last time the changes was called\n *\n * ## Usage\n * ```tsx\n * const result = useChanges(prevresult.clock,{limit:10}); // with options\n * const result = useChanges(); // without options\n * const database = useChanges.database; // underlying \"useFireproof\" database accessor\n * ```\n *\n * ## Overview\n * Changes made via remote sync peers, or other members of your cloud replica group will appear automatically\n * when you use the `useAllDocs`, `useChanges` and `useDocument` APIs. By default, Fireproof stores data in the browser's\n * local storage.\n */\nexport const useChanges = topLevelUseChanges as TLUseChanges;\n"],"mappings":"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","names":["useDocument","doc","useLiveQuery","useAllDocs","useChanges","useDocument","useLiveQuery","useAllDocs","useChanges"]}
+{"version":3,"sources":["../../../src/react/useFireproof.ts","../../../src/react/useDocument.ts","../../../src/react/useLiveQuery.ts","../../../src/react/useAllDocs.ts","../../../src/react/useChanges.ts"],"sourcesContent":["import type {\n  ConfigOpts,\n  DocFragment,\n  DocResponse,\n  DocSet,\n  DocTypes,\n  DocWithId,\n  IndexKeyType,\n  IndexRow,\n  MapFn,\n  QueryOpts,\n  Database,\n} from \"@fireproof/core\";\nimport { fireproof } from \"@fireproof/core\";\nimport { useCallback, useEffect, useMemo, useState } from \"react\";\nimport type { AllDocsQueryOpts, ChangesOptions, ClockHead } from \"@fireproof/core\";\n\nexport interface LiveQueryResult<T extends DocTypes, K extends IndexKeyType, R extends DocFragment = T> {\n  readonly docs: DocWithId<T>[];\n  readonly rows: IndexRow<K, T, R>[];\n}\n\nexport type UseLiveQuery = <T extends DocTypes, K extends IndexKeyType = string, R extends DocFragment = T>(\n  mapFn: string | MapFn<T>,\n  query?: QueryOpts<K>,\n  initialRows?: IndexRow<K, T, R>[],\n) => LiveQueryResult<T, K, R>;\n\nexport interface AllDocsResult<T extends DocTypes> {\n  readonly docs: DocWithId<T>[];\n}\n\nexport interface ChangesResult<T extends DocTypes> {\n  readonly docs: DocWithId<T>[];\n}\n\nexport type UseAllDocs = <T extends DocTypes>(query?: AllDocsQueryOpts) => AllDocsResult<T>;\n\nexport type UseChanges = <T extends DocTypes>(since: ClockHead, opts: ChangesOptions) => ChangesResult<T>;\n\ninterface UpdateDocFnOptions {\n  readonly replace?: boolean;\n  readonly reset?: boolean;\n}\n\ntype UpdateDocFn<T extends DocTypes> = (newDoc?: DocSet<T>, options?: UpdateDocFnOptions) => void;\n\ntype StoreDocFn<T extends DocTypes> = (existingDoc?: DocWithId<T>) => Promise<DocResponse>;\n\ntype DeleteDocFn<T extends DocTypes> = (existingDoc?: DocWithId<T>) => Promise<DocResponse>;\n\nexport type UseDocumentResult<T extends DocTypes> = [DocWithId<T>, UpdateDocFn<T>, StoreDocFn<T>, DeleteDocFn<T>];\n\nexport type UseDocumentInitialDocOrFn<T extends DocTypes> = DocSet<T> | (() => DocSet<T>);\nexport type UseDocument = <T extends DocTypes>(initialDocOrFn: UseDocumentInitialDocOrFn<T>) => UseDocumentResult<T>;\n\nexport interface UseFireproof {\n  readonly database: Database;\n  /**\n   * ## Summary\n   *\n   * React hook that provides the ability to create/update/save new Fireproof documents into your custom Fireproof database.\n   * The creation occurs when you do not pass in an `_id` as part of your initial document -- the database will assign a new\n   * one when you call the provided `save` handler. The hook also provides generics support so you can inline your custom type into\n   * the invocation to receive type-safety and auto-complete support in your IDE.\n   *\n   * ## Usage\n   *\n   * ```tsx\n   * const [todo, setTodo, saveTodo] = useDocument<Todo>({\n   *   text: '',\n   *   date: Date.now(),\n   *   completed: false\n   * })\n   *\n   * const [doc, setDoc, saveDoc] = useDocument<Customer>({\n   *   _id: `${props.customerId}-profile`, // you can imagine `customerId` as a prop passed in\n   *   name: \"\",\n   *   company: \"\",\n   *   startedAt: Date.now()\n   * })\n   * ```\n   *\n   * ## Overview\n   *\n   * Changes made via remote sync peers, or other members of your cloud replica group will appear automatically\n   * when you use the `useLiveQuery` and `useDocument` APIs. By default, Fireproof stores data in the browser's\n   * local storage.\n   */\n  readonly useDocument: UseDocument;\n  /**\n   * ## Summary\n   * React hook that provides access to live query results, enabling real-time updates in your app.\n   *\n   * ## Usage\n   * ```tsx\n   * const result = useLiveQuery(\"date\"); // using string key\n   * const result = useLiveQuery('date', { limit: 10, descending: true }) // key + options\n   * const result = useLiveQuery<CustomType>(\"date\"); // using generics\n   * const result = useLiveQuery((doc) => doc.date)); // using map function\n   * ```\n   *\n   * ## Overview\n   * Changes made via remote sync peers, or other members of your cloud replica group will appear automatically\n   * when you use the `useLiveQuery` and `useDocument` APIs. By default, Fireproof stores data in the browser's\n   * local storage.\n   */\n  readonly useLiveQuery: UseLiveQuery;\n  /**\n   * ## Summary\n   * React hook that provides access to all documents in the database, sorted by `_id`.\n   *\n   * ## Usage\n   * ```tsx\n   * const result = useAllDocs({ limit: 10, descending: true }); // with options\n   * const result = useAllDocs(); // without options\n   * ```\n   *\n   * ## Overview\n   * Changes made via remote sync peers, or other members of your cloud replica group will appear automatically\n   * when you use the `useAllDocs` and `useDocument` APIs. By default, Fireproof stores data in the browser's\n   * local storage.\n   */\n  readonly useAllDocs: UseAllDocs;\n  /**\n   * ## Summary\n   * React hook that provides access to all new documents in the database added since the last time the changes was called\n   *\n   * ## Usage\n   * ```tsx\n   * const result = useChanges(prevresult.clock,{limit:10}); // with options\n   * const result = useChanges(); // without options\n   * const database = useChanges.database; // underlying \"useFireproof\" database accessor\n   * ```\n   *\n   * ## Overview\n   * Changes made via remote sync peers, or other members of your cloud replica group will appear automatically\n   * when you use the `useAllDocs`, `useChanges` and `useDocument` APIs. By default, Fireproof stores data in the browser's\n   * local storage.\n   */\n  readonly useChanges: UseChanges;\n}\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  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;\n    }\n\n    // We purposely refetch the docId everytime to check if it has changed\n    const docId = initialDoc._id ?? \"\";\n\n    // We do not want to force consumers to memoize their initial document so we do it for them.\n    // We use the stringified generator function to ensure that the memoization is stable across renders.\n    // const initialDoc = useMemo(initialDocFn, [initialDocFn.toString()]);\n    const [doc, setDoc] = useState(initialDoc);\n\n    const refreshDoc = useCallback(async () => {\n      // todo add option for mvcc checks\n      const doc = docId ? await database.get<T>(docId).catch(() => initialDoc) : initialDoc;\n      setDoc(doc);\n    }, [docId]);\n\n    const saveDoc: StoreDocFn<T> = useCallback(\n      async (existingDoc) => {\n        const res = await database.put(existingDoc ?? doc);\n        // If the document was created, then we need to update the local state with the new `_id`\n        if (!existingDoc && !doc._id) setDoc((d) => ({ ...d, _id: res.id }));\n        return res;\n      },\n      [doc],\n    );\n\n    const deleteDoc: DeleteDocFn<T> = useCallback(\n      async (existingDoc) => {\n        const id = existingDoc?._id ?? docId;\n        const doc = await database.get<T>(id).catch(() => undefined);\n        if (!doc) 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      [docId, initialDoc],\n    );\n\n    const updateDoc: UpdateDocFn<T> = useCallback(\n      (newDoc, opts = { replace: false, reset: false }) => {\n        if (!newDoc) return void (opts.reset ? setDoc(initialDoc) : refreshDoc());\n        setDoc((d) => (opts.replace ? (newDoc as DocWithId<T>) : { ...d, ...newDoc }));\n      },\n      [refreshDoc, initialDoc],\n    );\n\n    useEffect(() => {\n      if (!docId) return;\n      return database.subscribe((changes) => {\n        if (changes.find((c) => c._id === docId)) {\n          void refreshDoc(); // todo use change.value\n        }\n      });\n    }, [docId, refreshDoc]);\n\n    useEffect(() => {\n      void refreshDoc();\n    }, [refreshDoc]);\n\n    return [{ _id: docId, ...doc }, updateDoc, saveDoc, deleteDoc];\n  }\n\n  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<LiveQueryResult<T, K, R>>(() => ({\n      rows: initialRows,\n      docs: initialRows.map((r) => r.doc).filter((r): r is DocWithId<T> => !!r),\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      setResult({ ...res, docs: res.rows.map((r) => r.doc as DocWithId<T>) });\n    }, [mapFnString, queryString]);\n\n    useEffect(() => {\n      refreshRows(); // Initial data fetch\n      return database.subscribe(refreshRows);\n    }, [refreshRows]);\n\n    return result;\n  }\n\n  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  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  return { database, useLiveQuery, useDocument, useAllDocs, useChanges };\n}\n","import { Database, DocTypes, DocWithId } from \"@fireproof/core\";\n\nimport { UseDocument, UseDocumentResult, useFireproof } from \"./useFireproof.js\";\n\nexport interface TLUseDocument {\n  <T extends DocTypes>(initialDoc: DocWithId<T>): UseDocumentResult<T>;\n  database: Database;\n}\n\nfunction topLevelUseDocument(...args: Parameters<UseDocument>) {\n  const { useDocument, database } = useFireproof();\n  (topLevelUseDocument as TLUseDocument).database = database;\n  return useDocument(...args);\n}\n\n/**\n * ## Summary\n *\n * React hook that provides the ability to create new Fireproof documents. The creation occurs when\n * you do not pass in an `_id` as part of your initial document -- the database will assign a new one when\n * you call the provided `save` handler This uses the default database named `useFireproof` under the hood which you can also\n * access via the `database` accessor.\n *\n * ## Usage\n *\n * ```tsx\n * const [todo, setTodo, saveTodo] = useDocument(() => ({\n *   text: '',\n *   date: Date.now(),\n *   completed: false\n * }))\n *\n * const [doc, setDoc, saveDoc] = useDocument(() => ({\n *   _id: `${props.customerId}-profile`, // you can imagine `customerId` as a prop passed in\n *   name: \"\",\n *   company: \"\",\n *   startedAt: Date.now()\n * }))\n *\n * const database = useDocument.database; // underlying \"useFireproof\" database accessor\n * ```\n *\n * ## Overview\n * Changes made via remote sync peers, or other members of your cloud replica group will appear automatically\n * when you use the `useLiveQuery` and `useDocument` APIs. By default, Fireproof stores data in the browser's\n * local storage.\n */\nexport const useDocument = topLevelUseDocument as TLUseDocument;\n","import { Database, DocFragment, DocTypes, IndexKeyType } from \"@fireproof/core\";\n\nimport { LiveQueryResult, useFireproof, UseLiveQuery } from \"./useFireproof.js\";\n\nexport interface TLUseLiveQuery {\n  <T extends DocTypes, K extends IndexKeyType, R extends DocFragment = T>(\n    ...args: Parameters<UseLiveQuery>\n  ): LiveQueryResult<T, K, R>;\n  database: Database;\n}\n\nfunction topLevelUseLiveQuery(...args: Parameters<UseLiveQuery>) {\n  const { useLiveQuery, database } = useFireproof();\n  (topLevelUseLiveQuery as TLUseLiveQuery).database = database;\n  return useLiveQuery(...args);\n}\n\n/**\n * ## Summary\n * React hook that provides access to live query results, enabling real-time updates in your app. This uses\n * the default database named \"useFireproof\" under the hood which you can also access via the `database` accessor.\n *\n * ## Usage\n * ```tsx\n * const results = useLiveQuery(\"date\"); // using string\n * const results = useLiveQuery((doc) => doc.date)); // using map function\n * const database = useLiveQuery.database; // underlying \"useFireproof\" database accessor\n * ```\n *\n * ## Overview\n * Changes made via remote sync peers, or other members of your cloud replica group will appear automatically\n * when you use the `useLiveQuery` and `useDocument` APIs. By default, Fireproof stores data in the browser's\n * local storage.\n */\nexport const useLiveQuery = topLevelUseLiveQuery as TLUseLiveQuery;\n","import { Database, DocTypes } from \"@fireproof/core\";\n\nimport { AllDocsResult, useFireproof, UseAllDocs } from \"./useFireproof.js\";\n\nexport interface TLUseAllDocs {\n  <T extends DocTypes>(...args: Parameters<UseAllDocs>): AllDocsResult<T>;\n  database: Database;\n}\n\nfunction topLevelUseAllDocs(...args: Parameters<UseAllDocs>) {\n  const { useAllDocs, database } = useFireproof();\n  (topLevelUseAllDocs as TLUseAllDocs).database = database;\n  return useAllDocs(...args);\n}\n\n/**\n * ## Summary\n * React hook that provides access to all documents in the database, sorted by `_id`.\n *\n * ## Usage\n * ```tsx\n * const result = useAllDocs({ limit: 10, descending: true }); // with options\n * const result = useAllDocs(); // without options\n * const database = useAllDocs.database; // underlying \"useFireproof\" database accessor\n * ```\n *\n * ## Overview\n * Changes made via remote sync peers, or other members of your cloud replica group will appear automatically\n * when you use the `useAllDocs` and `useDocument` APIs. By default, Fireproof stores data in the browser's\n * local storage.\n */\nexport const useAllDocs = topLevelUseAllDocs as TLUseAllDocs;\n","import { DocTypes, Database } from \"@fireproof/core\";\n\nimport { ChangesResult, useFireproof, UseChanges } from \"./useFireproof.js\";\n\nexport interface TLUseChanges {\n  <T extends DocTypes>(...args: Parameters<UseChanges>): ChangesResult<T>;\n  database: Database;\n}\n\nfunction topLevelUseChanges(...args: Parameters<UseChanges>) {\n  const { useChanges, database } = useFireproof();\n  (topLevelUseChanges as TLUseChanges).database = database;\n  return useChanges(...args);\n}\n\n/**\n * ## Summary\n * React hook that provides access to all new documents in the database added since the last time the changes was called\n *\n * ## Usage\n * ```tsx\n * const result = useChanges(prevresult.clock,{limit:10}); // with options\n * const result = useChanges(); // without options\n * const database = useChanges.database; // underlying \"useFireproof\" database accessor\n * ```\n *\n * ## Overview\n * Changes made via remote sync peers, or other members of your cloud replica group will appear automatically\n * when you use the `useAllDocs`, `useChanges` and `useDocument` APIs. By default, Fireproof stores data in the browser's\n * local storage.\n */\nexport const useChanges = topLevelUseChanges as TLUseChanges;\n"],"mappings":";AAaA,SAAS,iBAAiB;AAC1B,SAAS,aAAa,WAAW,SAAS,gBAAgB;AAoInD,IAAM,eAAe,CAAC;AA0BtB,SAAS,aAAa,OAA0B,gBAAgB,SAAqB,CAAC,GAAiB;AAC5G,QAAM,WAAW,OAAO,SAAS,WAAW,UAAU,MAAM,MAAM,IAAI;AAEtE,WAASA,aAAgC,gBAAoE;AAC3G,QAAI;AACJ,QAAI,OAAO,mBAAmB,YAAY;AACxC,mBAAa,eAAe;AAAA,IAC9B,OAAO;AACL,mBAAa;AAAA,IACf;AAGA,UAAM,QAAQ,WAAW,OAAO;AAKhC,UAAM,CAAC,KAAK,MAAM,IAAI,SAAS,UAAU;AAEzC,UAAM,aAAa,YAAY,YAAY;AAEzC,YAAMC,OAAM,QAAQ,MAAM,SAAS,IAAO,KAAK,EAAE,MAAM,MAAM,UAAU,IAAI;AAC3E,aAAOA,IAAG;AAAA,IACZ,GAAG,CAAC,KAAK,CAAC;AAEV,UAAM,UAAyB;AAAA,MAC7B,OAAO,gBAAgB;AACrB,cAAM,MAAM,MAAM,SAAS,IAAI,eAAe,GAAG;AAEjD,YAAI,CAAC,eAAe,CAAC,IAAI,IAAK,QAAO,CAAC,OAAO,EAAE,GAAG,GAAG,KAAK,IAAI,GAAG,EAAE;AACnE,eAAO;AAAA,MACT;AAAA,MACA,CAAC,GAAG;AAAA,IACN;AAEA,UAAM,YAA4B;AAAA,MAChC,OAAO,gBAAgB;AACrB,cAAM,KAAK,aAAa,OAAO;AAC/B,cAAMA,OAAM,MAAM,SAAS,IAAO,EAAE,EAAE,MAAM,MAAM,MAAS;AAC3D,YAAI,CAACA,KAAK,OAAM,SAAS,OAAO,MAAM,EAAE,IAAI,MAAM,EAAE,EAAE,IAAI,oBAAoB,EAAE,QAAQ;AACxF,cAAM,MAAM,MAAM,SAAS,IAAI,EAAE;AACjC,eAAO,UAAU;AACjB,eAAO;AAAA,MACT;AAAA,MACA,CAAC,OAAO,UAAU;AAAA,IACpB;AAEA,UAAM,YAA4B;AAAA,MAChC,CAAC,QAAQ,OAAO,EAAE,SAAS,OAAO,OAAO,MAAM,MAAM;AACnD,YAAI,CAAC,OAAQ,QAAO,MAAM,KAAK,QAAQ,OAAO,UAAU,IAAI,WAAW;AACvE,eAAO,CAAC,MAAO,KAAK,UAAW,SAA0B,EAAE,GAAG,GAAG,GAAG,OAAO,CAAE;AAAA,MAC/E;AAAA,MACA,CAAC,YAAY,UAAU;AAAA,IACzB;AAEA,cAAU,MAAM;AACd,UAAI,CAAC,MAAO;AACZ,aAAO,SAAS,UAAU,CAAC,YAAY;AACrC,YAAI,QAAQ,KAAK,CAAC,MAAM,EAAE,QAAQ,KAAK,GAAG;AACxC,eAAK,WAAW;AAAA,QAClB;AAAA,MACF,CAAC;AAAA,IACH,GAAG,CAAC,OAAO,UAAU,CAAC;AAEtB,cAAU,MAAM;AACd,WAAK,WAAW;AAAA,IAClB,GAAG,CAAC,UAAU,CAAC;AAEf,WAAO,CAAC,EAAE,KAAK,OAAO,GAAG,IAAI,GAAG,WAAW,SAAS,SAAS;AAAA,EAC/D;AAEA,WAASC,cACP,OACA,QAAQ,CAAC,GACT,cAAmC,CAAC,GACV;AAC1B,UAAM,CAAC,QAAQ,SAAS,IAAI,SAAmC,OAAO;AAAA,MACpE,MAAM;AAAA,MACN,MAAM,YAAY,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,MAAyB,CAAC,CAAC,CAAC;AAAA,IAC1E,EAAE;AAEF,UAAM,cAAc,QAAQ,MAAM,KAAK,UAAU,KAAK,GAAG,CAAC,KAAK,CAAC;AAChE,UAAM,cAAc,QAAQ,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,CAAC;AAE3D,UAAM,cAAc,YAAY,YAAY;AAC1C,YAAM,MAAM,MAAM,SAAS,MAAe,OAAO,KAAK;AACtD,gBAAU,EAAE,GAAG,KAAK,MAAM,IAAI,KAAK,IAAI,CAAC,MAAM,EAAE,GAAmB,EAAE,CAAC;AAAA,IACxE,GAAG,CAAC,aAAa,WAAW,CAAC;AAE7B,cAAU,MAAM;AACd,kBAAY;AACZ,aAAO,SAAS,UAAU,WAAW;AAAA,IACvC,GAAG,CAAC,WAAW,CAAC;AAEhB,WAAO;AAAA,EACT;AAEA,WAASC,YAA+B,QAA0B,CAAC,GAAqB;AACtF,UAAM,CAAC,QAAQ,SAAS,IAAI,SAA2B;AAAA,MACrD,MAAM,CAAC;AAAA,IACT,CAAC;AAED,UAAM,cAAc,QAAQ,MAAM,KAAK,UAAU,KAAK,GAAG,CAAC,KAAK,CAAC;AAEhE,UAAM,cAAc,YAAY,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,cAAU,MAAM;AACd,kBAAY;AACZ,aAAO,SAAS,UAAU,WAAW;AAAA,IACvC,GAAG,CAAC,WAAW,CAAC;AAEhB,WAAO;AAAA,EACT;AAEA,WAASC,YAA+B,QAAmB,CAAC,GAAG,OAAuB,CAAC,GAAqB;AAC1G,UAAM,CAAC,QAAQ,SAAS,IAAI,SAA2B;AAAA,MACrD,MAAM,CAAC;AAAA,IACT,CAAC;AAED,UAAM,cAAc,QAAQ,MAAM,KAAK,UAAU,IAAI,GAAG,CAAC,IAAI,CAAC;AAE9D,UAAM,cAAc,YAAY,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,cAAU,MAAM;AACd,kBAAY;AACZ,aAAO,SAAS,UAAU,WAAW;AAAA,IACvC,GAAG,CAAC,WAAW,CAAC;AAEhB,WAAO;AAAA,EACT;AAEA,SAAO,EAAE,UAAU,cAAAF,eAAc,aAAAF,cAAa,YAAAG,aAAY,YAAAC,YAAW;AACvE;;;AC7SA,SAAS,uBAAuB,MAA+B;AAC7D,QAAM,EAAE,aAAAC,cAAa,SAAS,IAAI,aAAa;AAC/C,EAAC,oBAAsC,WAAW;AAClD,SAAOA,aAAY,GAAG,IAAI;AAC5B;AAkCO,IAAM,cAAc;;;ACpC3B,SAAS,wBAAwB,MAAgC;AAC/D,QAAM,EAAE,cAAAC,eAAc,SAAS,IAAI,aAAa;AAChD,EAAC,qBAAwC,WAAW;AACpD,SAAOA,cAAa,GAAG,IAAI;AAC7B;AAmBO,IAAM,eAAe;;;ACzB5B,SAAS,sBAAsB,MAA8B;AAC3D,QAAM,EAAE,YAAAC,aAAY,SAAS,IAAI,aAAa;AAC9C,EAAC,mBAAoC,WAAW;AAChD,SAAOA,YAAW,GAAG,IAAI;AAC3B;AAkBO,IAAM,aAAa;;;ACtB1B,SAAS,sBAAsB,MAA8B;AAC3D,QAAM,EAAE,YAAAC,aAAY,SAAS,IAAI,aAAa;AAC9C,EAAC,mBAAoC,WAAW;AAChD,SAAOA,YAAW,GAAG,IAAI;AAC3B;AAkBO,IAAM,aAAa;","names":["useDocument","doc","useLiveQuery","useAllDocs","useChanges","useDocument","useLiveQuery","useAllDocs","useChanges"]}

package/react/metafile-cjs.json

@@ -1 +1 @@
-{"inputs":{"src/react/useFireproof.ts":{"bytes":11393,"imports":[{"path":"@fireproof/core","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true}],"format":"esm"},"src/react/useDocument.ts":{"bytes":1680,"imports":[{"path":"@fireproof/core","kind":"import-statement","external":true},{"path":"src/react/useFireproof.ts","kind":"import-statement","original":"./useFireproof.js"}],"format":"esm"},"src/react/useLiveQuery.ts":{"bytes":1409,"imports":[{"path":"@fireproof/core","kind":"import-statement","external":true},{"path":"src/react/useFireproof.ts","kind":"import-statement","original":"./useFireproof.js"}],"format":"esm"},"src/react/useAllDocs.ts":{"bytes":1146,"imports":[{"path":"@fireproof/core","kind":"import-statement","external":true},{"path":"src/react/useFireproof.ts","kind":"import-statement","original":"./useFireproof.js"}],"format":"esm"},"src/react/useChanges.ts":{"bytes":1191,"imports":[{"path":"@fireproof/core","kind":"import-statement","external":true},{"path":"src/react/useFireproof.ts","kind":"import-statement","original":"./useFireproof.js"}],"format":"esm"},"src/react/index.ts":{"bytes":971,"imports":[{"path":"src/react/useDocument.ts","kind":"import-statement","original":"./useDocument.js"},{"path":"src/react/useFireproof.ts","kind":"import-statement","original":"./useFireproof.js"},{"path":"src/react/useLiveQuery.ts","kind":"import-statement","original":"./useLiveQuery.js"},{"path":"src/react/useAllDocs.ts","kind":"import-statement","original":"./useAllDocs.js"},{"path":"src/react/useChanges.ts","kind":"import-statement","original":"./useChanges.js"}],"format":"esm"}},"outputs":{"dist/fireproof-core/react/index.cjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":22633},"dist/fireproof-core/react/index.cjs":{"imports":[{"path":"@fireproof/core","kind":"require-call","external":true},{"path":"react","kind":"require-call","external":true}],"exports":[],"entryPoint":"src/react/index.ts","inputs":{"src/react/index.ts":{"bytesInOutput":305},"src/react/useFireproof.ts":{"bytesInOutput":4235},"src/react/useDocument.ts":{"bytesInOutput":222},"src/react/useLiveQuery.ts":{"bytesInOutput":229},"src/react/useAllDocs.ts":{"bytesInOutput":215},"src/react/useChanges.ts":{"bytesInOutput":215}},"bytes":6388}}}
+{"inputs":{"src/react/useFireproof.ts":{"bytes":11390,"imports":[{"path":"@fireproof/core","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true}],"format":"esm"},"src/react/useDocument.ts":{"bytes":1680,"imports":[{"path":"@fireproof/core","kind":"import-statement","external":true},{"path":"src/react/useFireproof.ts","kind":"import-statement","original":"./useFireproof.js"}],"format":"esm"},"src/react/useLiveQuery.ts":{"bytes":1409,"imports":[{"path":"@fireproof/core","kind":"import-statement","external":true},{"path":"src/react/useFireproof.ts","kind":"import-statement","original":"./useFireproof.js"}],"format":"esm"},"src/react/useAllDocs.ts":{"bytes":1146,"imports":[{"path":"@fireproof/core","kind":"import-statement","external":true},{"path":"src/react/useFireproof.ts","kind":"import-statement","original":"./useFireproof.js"}],"format":"esm"},"src/react/useChanges.ts":{"bytes":1191,"imports":[{"path":"@fireproof/core","kind":"import-statement","external":true},{"path":"src/react/useFireproof.ts","kind":"import-statement","original":"./useFireproof.js"}],"format":"esm"},"src/react/index.ts":{"bytes":971,"imports":[{"path":"src/react/useDocument.ts","kind":"import-statement","original":"./useDocument.js"},{"path":"src/react/useFireproof.ts","kind":"import-statement","original":"./useFireproof.js"},{"path":"src/react/useLiveQuery.ts","kind":"import-statement","original":"./useLiveQuery.js"},{"path":"src/react/useAllDocs.ts","kind":"import-statement","original":"./useAllDocs.js"},{"path":"src/react/useChanges.ts","kind":"import-statement","original":"./useChanges.js"}],"format":"esm"}},"outputs":{"dist/fireproof-core/react/index.cjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":22625},"dist/fireproof-core/react/index.cjs":{"imports":[{"path":"@fireproof/core","kind":"require-call","external":true},{"path":"react","kind":"require-call","external":true}],"exports":[],"entryPoint":"src/react/index.ts","inputs":{"src/react/index.ts":{"bytesInOutput":305},"src/react/useFireproof.ts":{"bytesInOutput":4237},"src/react/useDocument.ts":{"bytesInOutput":222},"src/react/useLiveQuery.ts":{"bytesInOutput":229},"src/react/useAllDocs.ts":{"bytesInOutput":215},"src/react/useChanges.ts":{"bytesInOutput":215}},"bytes":6390}}}

package/react/metafile-esm.json

@@ -1 +1 @@
-{"inputs":{"src/react/useFireproof.ts":{"bytes":11393,"imports":[{"path":"@fireproof/core","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true}],"format":"esm"},"src/react/useDocument.ts":{"bytes":1680,"imports":[{"path":"@fireproof/core","kind":"import-statement","external":true},{"path":"src/react/useFireproof.ts","kind":"import-statement","original":"./useFireproof.js"}],"format":"esm"},"src/react/useLiveQuery.ts":{"bytes":1409,"imports":[{"path":"@fireproof/core","kind":"import-statement","external":true},{"path":"src/react/useFireproof.ts","kind":"import-statement","original":"./useFireproof.js"}],"format":"esm"},"src/react/useAllDocs.ts":{"bytes":1146,"imports":[{"path":"@fireproof/core","kind":"import-statement","external":true},{"path":"src/react/useFireproof.ts","kind":"import-statement","original":"./useFireproof.js"}],"format":"esm"},"src/react/useChanges.ts":{"bytes":1191,"imports":[{"path":"@fireproof/core","kind":"import-statement","external":true},{"path":"src/react/useFireproof.ts","kind":"import-statement","original":"./useFireproof.js"}],"format":"esm"},"src/react/index.ts":{"bytes":971,"imports":[{"path":"src/react/useDocument.ts","kind":"import-statement","original":"./useDocument.js"},{"path":"src/react/useFireproof.ts","kind":"import-statement","original":"./useFireproof.js"},{"path":"src/react/useLiveQuery.ts","kind":"import-statement","original":"./useLiveQuery.js"},{"path":"src/react/useAllDocs.ts","kind":"import-statement","original":"./useAllDocs.js"},{"path":"src/react/useChanges.ts","kind":"import-statement","original":"./useChanges.js"}],"format":"esm"}},"outputs":{"dist/fireproof-core/react/index.js.map":{"imports":[],"exports":[],"inputs":{},"bytes":21518},"dist/fireproof-core/react/index.js":{"imports":[{"path":"@fireproof/core","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true}],"exports":["FireproofCtx","useAllDocs","useChanges","useDocument","useFireproof","useLiveQuery"],"entryPoint":"src/react/index.ts","inputs":{"src/react/useFireproof.ts":{"bytesInOutput":3892},"src/react/useDocument.ts":{"bytesInOutput":222},"src/react/index.ts":{"bytesInOutput":0},"src/react/useLiveQuery.ts":{"bytesInOutput":229},"src/react/useAllDocs.ts":{"bytesInOutput":215},"src/react/useChanges.ts":{"bytesInOutput":215}},"bytes":5019}}}
+{"inputs":{"src/react/useFireproof.ts":{"bytes":11390,"imports":[{"path":"@fireproof/core","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true}],"format":"esm"},"src/react/useDocument.ts":{"bytes":1680,"imports":[{"path":"@fireproof/core","kind":"import-statement","external":true},{"path":"src/react/useFireproof.ts","kind":"import-statement","original":"./useFireproof.js"}],"format":"esm"},"src/react/useLiveQuery.ts":{"bytes":1409,"imports":[{"path":"@fireproof/core","kind":"import-statement","external":true},{"path":"src/react/useFireproof.ts","kind":"import-statement","original":"./useFireproof.js"}],"format":"esm"},"src/react/useAllDocs.ts":{"bytes":1146,"imports":[{"path":"@fireproof/core","kind":"import-statement","external":true},{"path":"src/react/useFireproof.ts","kind":"import-statement","original":"./useFireproof.js"}],"format":"esm"},"src/react/useChanges.ts":{"bytes":1191,"imports":[{"path":"@fireproof/core","kind":"import-statement","external":true},{"path":"src/react/useFireproof.ts","kind":"import-statement","original":"./useFireproof.js"}],"format":"esm"},"src/react/index.ts":{"bytes":971,"imports":[{"path":"src/react/useDocument.ts","kind":"import-statement","original":"./useDocument.js"},{"path":"src/react/useFireproof.ts","kind":"import-statement","original":"./useFireproof.js"},{"path":"src/react/useLiveQuery.ts","kind":"import-statement","original":"./useLiveQuery.js"},{"path":"src/react/useAllDocs.ts","kind":"import-statement","original":"./useAllDocs.js"},{"path":"src/react/useChanges.ts","kind":"import-statement","original":"./useChanges.js"}],"format":"esm"}},"outputs":{"dist/fireproof-core/react/index.js.map":{"imports":[],"exports":[],"inputs":{},"bytes":21510},"dist/fireproof-core/react/index.js":{"imports":[{"path":"@fireproof/core","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true}],"exports":["FireproofCtx","useAllDocs","useChanges","useDocument","useFireproof","useLiveQuery"],"entryPoint":"src/react/index.ts","inputs":{"src/react/useFireproof.ts":{"bytesInOutput":3889},"src/react/useDocument.ts":{"bytesInOutput":222},"src/react/index.ts":{"bytesInOutput":0},"src/react/useLiveQuery.ts":{"bytesInOutput":229},"src/react/useAllDocs.ts":{"bytesInOutput":215},"src/react/useChanges.ts":{"bytesInOutput":215}},"bytes":5016}}}

package/tests/blockstore/interceptor-gateway.test.ts

@@ -54,7 +54,7 @@ class TestInterceptor extends bs.PassThroughGateway {
 describe("InterceptorGateway", () => {
   it("passthrough", async () => {
     const gwi = new TestInterceptor();
-    const db = fireproof.DB("interceptor-gateway", {
+    const db = fireproof("interceptor-gateway", {
       gatewayInterceptor: gwi,
     });
     expect(

package/tests/fireproof/all-gateway.test.ts

@@ -375,7 +375,7 @@ describe("noop Gateway subscribe", function () {
     await db.destroy();
   });
   beforeEach(async function () {
-    db = fireproof.DB("test-gateway-" + sthis.nextId().str);
+    db = fireproof("test-gateway-" + sthis.nextId().str);
 
     // Extract stores from the loader
     metaStore = (await db.ledger.crdt.blockstore.loader?.metaStore()) as bs.MetaStore;
@@ -425,7 +425,7 @@ describe("Gateway", function () {
     await db.destroy();
   });
   beforeEach(async function () {
-    db = fireproof.DB("test-gateway-" + sthis.nextId().str);
+    db = fireproof("test-gateway-" + sthis.nextId().str);
     const ok = await db.put({ _id: "test", foo: "bar" });
     expect(ok).toBeTruthy();
     expect(ok.id).toBe("test");

package/tests/fireproof/database.test.ts

@@ -23,7 +23,7 @@ describe("basic Ledger", () => {
   });
   beforeEach(async () => {
     await sthis.start();
-    db = fireproof.DB(undefined as unknown as string, {
+    db = fireproof(undefined as unknown as string, {
       logger: sthis.logger,
     });
   });
@@ -61,7 +61,7 @@ describe("basic Ledger with record", function () {
   });
   beforeEach(async function () {
     await sthis.start();
-    db = fireproof.DB("factory-name");
+    db = fireproof("factory-name");
     const ok = await db.put<Doc>({ _id: "hello", value: "world" });
     expect(ok.id).toBe("hello");
   });
@@ -93,7 +93,7 @@ describe("basic Ledger with record", function () {
     expect(rows[0].value._id).toBe("hello");
   });
   it("is not persisted", async function () {
-    const db2 = fireproof.DB("factory-name");
+    const db2 = fireproof("factory-name");
     const { rows } = await db2.changes([]);
     expect(rows.length).toBe(1);
     // assert((db.ledger.ref === db2.ledger.ref, "should be the same ledger");
@@ -116,7 +116,7 @@ describe("named Ledger with record", function () {
   });
   beforeEach(async function () {
     await sthis.start();
-    db = fireproof.DB("test-db-name");
+    db = fireproof("test-db-name");
     /** @type {Doc} */
     const doc = { _id: "hello", value: "world" };
     const ok = await db.put(doc);
@@ -243,7 +243,7 @@ describe("basic Ledger parallel writes / public ordered", () => {
   });
   beforeEach(async () => {
     await sthis.start();
-    db = fireproof.DB("test-parallel-writes-ordered", { writeQueue: { chunkSize: 1 } });
+    db = fireproof("test-parallel-writes-ordered", { writeQueue: { chunkSize: 1 } });
     for (let i = 0; i < 10; i++) {
       const doc = { _id: `id-${i}`, hello: "world" };
       writes.push(db.put(doc));
@@ -277,7 +277,7 @@ describe("basic Ledger parallel writes / public", () => {
   });
   beforeEach(async () => {
     await sthis.start();
-    db = fireproof.DB("test-parallel-writes", { writeQueue: { chunkSize: 32 } });
+    db = fireproof("test-parallel-writes", { writeQueue: { chunkSize: 32 } });
     for (let i = 0; i < 10; i++) {
       const doc = { _id: `id-${i}`, hello: "world" };
       writes.push(db.put(doc));
@@ -360,7 +360,7 @@ describe("basic Ledger with subscription", function () {
   });
   beforeEach(async function () {
     await sthis.start();
-    db = fireproof.DB("factory-name");
+    db = fireproof("factory-name");
     didRun = 0;
     waitForSub = new Promise((resolve) => {
       unsubscribe = db.subscribe((docs) => {
@@ -403,7 +403,7 @@ describe("basic Ledger with no update subscription", function () {
     await db.destroy();
   });
   beforeEach(async function () {
-    db = fireproof.DB("factory-name");
+    db = fireproof("factory-name");
     didRun = 0;
     unsubscribe = db.subscribe(() => {
       didRun++;
@@ -441,7 +441,7 @@ describe("ledger with files input", () => {
   beforeEach(async function () {
     await sthis.start();
     imagefiles = await buildBlobFiles();
-    db = fireproof.DB("fireproof-with-images");
+    db = fireproof("fireproof-with-images");
     const doc = {
       _id: "images-main",
       type: "files",

package/tests/fireproof/fireproof.test.ts

@@ -45,7 +45,7 @@ describe("dreamcode", function () {
   });
   beforeEach(async function () {
     await sthis.start();
-    db = fireproof.DB("test-db");
+    db = fireproof("test-db");
     ok = await db.put({ _id: "test-1", text: "fireproof", dream: true });
     doc = await db.get(ok.id);
     result = await db.query("text", { range: ["a", "z"] });
@@ -89,7 +89,7 @@ describe("public API", function () {
 
   beforeEach(async function () {
     await sthis.start();
-    db = fireproof.DB("test-api");
+    db = fireproof("test-api");
     // index = index(db, 'test-index', (doc) => doc.foo)
     ok = await db.put({ _id: "test", foo: "bar" });
     doc = await db.get("test");
@@ -126,7 +126,7 @@ describe("basic ledger", function () {
   });
   beforeEach(async function () {
     await sthis.start();
-    db = fireproof.DB("test-basic");
+    db = fireproof("test-basic");
   });
   it("can put with id", async function () {
     const ok = await db.put({ _id: "test", foo: "bar" });
@@ -200,7 +200,7 @@ describe("benchmarking with compaction", function () {
   beforeEach(async function () {
     // erase the existing test data
     await sthis.start();
-    db = fireproof.DB("test-benchmark-compaction", { autoCompact: 3 });
+    db = fireproof("test-benchmark-compaction", { autoCompact: 3 });
   });
   it.skip("insert during compaction", async function () {
     const ok = await db.put({ _id: "test", foo: "fast" });
@@ -254,8 +254,8 @@ describe("benchmarking a ledger", function () {
   beforeEach(async function () {
     await sthis.start();
     // erase the existing test data
-    db = fireproof.DB("test-benchmark", { autoCompact: 100000, public: true });
-    // db = fireproof.DB(null, {autoCompact: 100000})
+    db = fireproof("test-benchmark", { autoCompact: 100000, public: true });
+    // db = fireproof(null, {autoCompact: 100000})
   });
 
   // run benchmarking tests
@@ -305,7 +305,7 @@ describe("benchmarking a ledger", function () {
     // equals(allDocsResult2.rows.length, numDocs+1)
 
     // console.time("open new DB");
-    const newDb = fireproof.DB("test-benchmark", { autoCompact: 100000, public: true });
+    const newDb = fireproof("test-benchmark", { autoCompact: 100000, public: true });
     const doc = await newDb.get<{ foo: string }>("test");
     expect(doc.foo).toBe("fast");
     // console.timeEnd("open new DB");
@@ -347,7 +347,7 @@ describe("benchmarking a ledger", function () {
     await sleep(100);
 
     // console.time("compacted reopen again");
-    const newDb2 = fireproof.DB("test-benchmark", { autoCompact: 100000, public: true });
+    const newDb2 = fireproof("test-benchmark", { autoCompact: 100000, public: true });
     const doc21 = await newDb2.get<FooType>("test");
     expect(doc21.foo).toBe("fast");
     const blocks2 = newDb2.ledger.crdt.blockstore as bs.EncryptedBlockstore;
@@ -413,7 +413,7 @@ describe("Reopening a ledger", function () {
     // erase the existing test data
     await sthis.start();
 
-    db = fireproof.DB("test-reopen", { autoCompact: 100000 });
+    db = fireproof("test-reopen", { autoCompact: 100000 });
     const ok = await db.put({ _id: "test", foo: "bar" });
     expect(ok).toBeTruthy();
     expect(ok.id).toBe("test");
@@ -428,7 +428,7 @@ describe("Reopening a ledger", function () {
   });
 
   it("should have the same data on reopen", async function () {
-    const db2 = fireproof.DB("test-reopen");
+    const db2 = fireproof("test-reopen");
     const doc = await db2.get<FooType>("test");
     expect(doc.foo).toBe("bar");
     expect(db2.ledger.crdt.clock.head).toBeDefined();
@@ -447,7 +447,7 @@ describe("Reopening a ledger", function () {
   });
 
   it("should have carlog after reopen", async function () {
-    const db2 = fireproof.DB("test-reopen");
+    const db2 = fireproof("test-reopen");
     await db2.ledger.crdt.ready();
     const blocks = db2.ledger.crdt.blockstore as bs.EncryptedBlockstore;
     const loader = blocks.loader;
@@ -460,7 +460,7 @@ describe("Reopening a ledger", function () {
   it("faster, should have the same data on reopen after reopen and update", async function () {
     for (let i = 0; i < 4; i++) {
       // console.log('iteration', i)
-      const db = fireproof.DB("test-reopen");
+      const db = fireproof("test-reopen");
       // assert(db._crdt.xready());
       await db.ready();
       const blocks = db.ledger.crdt.blockstore as bs.EncryptedBlockstore;
@@ -479,7 +479,7 @@ describe("Reopening a ledger", function () {
     for (let i = 0; i < 200; i++) {
       // console.log("iteration", i);
       // console.time("db open");
-      const db = fireproof.DB("test-reopen", { autoCompact: 1000 }); // try with 10
+      const db = fireproof("test-reopen", { autoCompact: 1000 }); // try with 10
       // assert(db._crdt.ready);
       await db.ready();
       // console.timeEnd("db open");
@@ -516,7 +516,7 @@ describe("Reopening a ledger with indexes", function () {
   });
   beforeEach(async function () {
     await sthis.start();
-    db = fireproof.DB("test-reopen-idx");
+    db = fireproof("test-reopen-idx");
     const ok = await db.put({ _id: "test", foo: "bar" });
     expect(ok.id).toBe("test");
 
@@ -561,7 +561,7 @@ describe("Reopening a ledger with indexes", function () {
   });
 
   it("should have the same data on reopen", async function () {
-    const db2 = fireproof.DB("test-reopen-idx");
+    const db2 = fireproof("test-reopen-idx");
     const doc = await db2.get<FooType>("test");
     expect(doc.foo).toBe("bar");
     expect(db2.ledger.crdt.clock.head).toBeTruthy();
@@ -576,7 +576,7 @@ describe("Reopening a ledger with indexes", function () {
     expect(r0.rows.length).toBe(1);
     expect(r0.rows[0].key).toBe("bar");
 
-    const db2 = fireproof.DB("test-reopen-idx");
+    const db2 = fireproof("test-reopen-idx");
     const doc = await db2.get<FooType>("test");
     expect(doc.foo).toBe("bar");
     expect(db2.ledger.crdt.clock.head).toBeTruthy();
@@ -611,7 +611,7 @@ describe("basic js verify", function () {
     await sthis.start();
   });
   it("should include cids in arrays", async function () {
-    const db = fireproof.DB("test-verify");
+    const db = fireproof("test-verify");
     const ok = await db.put({ _id: "test", foo: ["bar", "bam"] });
     expect(ok.id).toBe("test");
     const ok2 = await db.put({ _id: "test2", foo: ["bar", "bam"] });
@@ -664,7 +664,7 @@ describe("same workload twice, same CID", function () {
     let ok: DocResponse;
     await sthis.start();
     // todo this fails because the test setup doesn't properly configure both ledgers to use the same key
-    dbA = fireproof.DB("test-dual-workload-a", configA);
+    dbA = fireproof("test-dual-workload-a", configA);
     for (const doc of docs) {
       ok = await dbA.put(doc);
       expect(ok).toBeTruthy();
@@ -673,7 +673,7 @@ describe("same workload twice, same CID", function () {
     headA = dbA.ledger.crdt.clock.head.toString();
 
     // todo this fails because the test setup doesn't properly configure both ledgers to use the same key
-    dbB = fireproof.DB("test-dual-workload-b", configB);
+    dbB = fireproof("test-dual-workload-b", configB);
     for (const doc of docs) {
       ok = await dbB.put(doc);
       expect(ok).toBeTruthy();

package/tests/fireproof/hello.test.ts

@@ -3,7 +3,7 @@ import { mockSuperThis } from "../helpers.js";
 
 describe("Hello World Test", function () {
   it("should pass the hello world test", function () {
-    const result = fireproof.DB("hello"); // call to your library function
+    const result = fireproof("hello"); // call to your library function
     expect(result.name).toBe("hello");
   });
 });
@@ -23,7 +23,7 @@ describe("hello public API", () => {
   });
   beforeEach(async () => {
     await sthis.start();
-    db = fireproof.DB("test-public-api");
+    db = fireproof("test-public-api");
     index<string, TestDoc>(db, "test-index", (doc) => doc.foo);
     ok = await db.put({ _id: "test", foo: "bar" });
     doc = await db.get("test");
@@ -41,7 +41,7 @@ describe("hello public API", () => {
   });
   it("should get when you open it again", async () => {
     await db.close();
-    db = fireproof.DB("test-public-api");
+    db = fireproof("test-public-api");
     doc = await db.get("test");
     expect(doc.foo).toBe("bar");
   });
@@ -54,7 +54,7 @@ describe("Simplified Reopening a ledger", function () {
     await db.destroy();
   });
   beforeEach(async function () {
-    db = fireproof.DB("test-reopen-simple");
+    db = fireproof("test-reopen-simple");
     const ok = await db.put({ _id: "test", foo: "bar" });
     expect(ok).toBeTruthy();
     expect(ok.id).toBe("test");
@@ -66,7 +66,7 @@ describe("Simplified Reopening a ledger", function () {
   });
 
   it("should have the same data on reopen", async function () {
-    const db2 = fireproof.DB("test-reopen-simple");
+    const db2 = fireproof("test-reopen-simple");
     const doc = await db2.get<{ foo: string }>("test");
     expect(doc.foo).toBe("bar");
     await db2.close();