entity-repository 0.2.1 → 0.3.0

package/dist/react.d.ts

@@ -1,11 +1,24 @@
 import { ReactNode } from "react";
 import { type Observable } from "rxjs";
 import type { ListQueryOptions, ListQueryState } from "./list-query";
-import type { EntityConfig, EntityDefinitions, EntityIdTuple, RepositoryQuery } from "./types";
+import type { EntityConfig, EntityDefinitions, EntityIdTuple, RepositoryConfig, RepositoryQuery } from "./types";
 import { Repository } from "./repository";
-export declare function createRepositoryContext<Definitions extends EntityDefinitions, Config extends EntityConfig<Definitions> = EntityConfig<Definitions>>(): {
-    RepositoryProvider: ({ repository, children, }: {
-        repository: Repository<Definitions, Config>;
+/**
+ * Creates a typed entity repository plus the React hooks that operate on it.
+ *
+ * The factory OWNS the Repository instance — there's exactly one per call,
+ * and it's exposed as `repository` on the return. Consumers don't write
+ * `new Repository(...)`; they `import { repository }` and use it directly
+ * for code that runs outside React (e.g. seeding rows inside a fetcher
+ * closure). Components reach the same instance through the hooks.
+ *
+ * The `RepositoryProvider` is still emitted so a subtree can opt into a
+ * different repository for testing, but in normal use it's a passthrough
+ * — `useRepository()` returns the factory-owned singleton by default.
+ */
+export declare function createRepositoryContext<Definitions extends EntityDefinitions, Config extends EntityConfig<Definitions> = EntityConfig<Definitions>>(config: RepositoryConfig<Definitions, Config>): {
+    repository: Repository<Definitions, Config>;
+    RepositoryProvider: ({ children }: {
         children: ReactNode;
     }) => import("react/jsx-runtime").JSX.Element;
     useRepository: () => Repository<Definitions, Config>;

package/dist/react.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,SAAS,EAA6E,MAAM,OAAO,CAAC;AAE5H,OAAO,EAAsB,KAAK,UAAU,EAAE,MAAM,MAAM,CAAC;AAE3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/F,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,wBAAgB,uBAAuB,CACrC,WAAW,SAAS,iBAAiB,EACrC,MAAM,SAAS,YAAY,CAAC,WAAW,CAAC,GAAG,YAAY,CAAC,WAAW,CAAC;oDAOjE;QACD,UAAU,EAAE,UAAU,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAC5C,QAAQ,EAAE,SAAS,CAAC;KACrB;;yBAyC2B,KAAK,SAAS,MAAM,WAAW,SAClD,KAAK,MACR,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,WACpC,CAAC,EAAE,EAAE,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,KAAK,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAC7F,eAAe,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;6BAmDN,KAAK,SAAS,MAAM,WAAW,EAAE,KAAK,SAC7D,KAAK,SACL,KAAK,WACH,gBAAgB,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,WACpC,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,KACvD,cAAc,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;wBAlCV,KAAK,SAAS,MAAM,WAAW,EAAE,GAAG,SACtD,KAAK,OACP,GAAG,WACC,gBAAgB,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,KAC5C,WAAW,CAAC,KAAK,CAAC,EAAE;yBAvDK,KAAK,cAAc,UAAU,CAAC,KAAK,CAAC,eAAe,MAAM,KAAK;EAmH3F"}
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,SAAS,EAA6E,MAAM,OAAO,CAAC;AAE5H,OAAO,EAAsB,KAAK,UAAU,EAAE,MAAM,MAAM,CAAC;AAE3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACjH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,SAAS,iBAAiB,EACrC,MAAM,SAAS,YAAY,CAAC,WAAW,CAAC,GAAG,YAAY,CAAC,WAAW,CAAC,EACpE,MAAM,EAAE,gBAAgB,CAAC,WAAW,EAAE,MAAM,CAAC;;uCAIH;QAAE,QAAQ,EAAE,SAAS,CAAA;KAAE;;yBAqCrC,KAAK,SAAS,MAAM,WAAW,SAClD,KAAK,MACR,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,WACpC,CAAC,EAAE,EAAE,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,KAAK,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAC7F,eAAe,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;6BA+CN,KAAK,SAAS,MAAM,WAAW,EAAE,KAAK,SAC7D,KAAK,SACL,KAAK,WACH,gBAAgB,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,WACpC,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,KACvD,cAAc,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;wBA/BV,KAAK,SAAS,MAAM,WAAW,EAAE,GAAG,SACtD,KAAK,OACP,GAAG,WACC,gBAAgB,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,KAC5C,WAAW,CAAC,KAAK,CAAC,EAAE;yBAtDK,KAAK,cAAc,UAAU,CAAC,KAAK,CAAC,eAAe,MAAM,KAAK;EA+G3F"}

package/dist/react.js

@@ -1,17 +1,28 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useSyncExternalStore } from "react";
 import { combineLatest, map } from "rxjs";
-export function createRepositoryContext() {
-    const RepositoryReactContext = createContext(null);
-    function RepositoryProvider({ repository, children, }) {
+import { Repository } from "./repository";
+/**
+ * Creates a typed entity repository plus the React hooks that operate on it.
+ *
+ * The factory OWNS the Repository instance — there's exactly one per call,
+ * and it's exposed as `repository` on the return. Consumers don't write
+ * `new Repository(...)`; they `import { repository }` and use it directly
+ * for code that runs outside React (e.g. seeding rows inside a fetcher
+ * closure). Components reach the same instance through the hooks.
+ *
+ * The `RepositoryProvider` is still emitted so a subtree can opt into a
+ * different repository for testing, but in normal use it's a passthrough
+ * — `useRepository()` returns the factory-owned singleton by default.
+ */
+export function createRepositoryContext(config) {
+    const repository = new Repository(config);
+    const RepositoryReactContext = createContext(repository);
+    function RepositoryProvider({ children }) {
         return (_jsx(RepositoryReactContext.Provider, { value: repository, children: children }));
     }
     function useRepository() {
-        const context = useContext(RepositoryReactContext);
-        if (!context) {
-            throw new Error("RepositoryProvider is missing.");
-        }
-        return context;
+        return useContext(RepositoryReactContext);
     }
     function useSubscribedState(observable, getSnapshot) {
         const snapshotRef = useRef(getSnapshot());
@@ -32,9 +43,8 @@ export function createRepositoryContext() {
      * query instance remains stable for a given `id`.
      */
     function useRepositoryQuery(table, id, fetcher) {
-        const repository = useRepository();
         // eslint-disable-next-line react-hooks/exhaustive-deps -- table/fetcher intentionally ignored
-        const recordQuery = useMemo(() => repository.recordQuery(table, id, fetcher), [repository, JSON.stringify(id)]);
+        const recordQuery = useMemo(() => repository.recordQuery(table, id, fetcher), [JSON.stringify(id)]);
         return useSubscribedState(recordQuery.$state, () => recordQuery.$state.value);
     }
     /**
@@ -49,12 +59,9 @@ export function createRepositoryContext() {
      * inputs, e.g. a task id).
      */
     function useObservableList(table, key, options) {
-        const repository = useRepository();
         // eslint-disable-next-line react-hooks/exhaustive-deps -- table/options intentionally ignored (stable for a given key)
-        const observable = useMemo(() => repository.observableList(table, options), [repository, JSON.stringify(key)]);
+        const observable = useMemo(() => repository.observableList(table, options), [JSON.stringify(key)]);
         return useSubscribedState(observable, () => {
-            // Pull the current snapshot via a synchronous one-shot subscribe.
-            // observableList emits its first value synchronously.
             let snapshot = [];
             const sub = observable.subscribe((value) => {
                 snapshot = value;
@@ -70,9 +77,8 @@ export function createRepositoryContext() {
      * list query instance remains stable for a given `param`.
      */
     function useRepositoryListQuery(table, param, options, fetcher) {
-        const repository = useRepository();
         // eslint-disable-next-line react-hooks/exhaustive-deps -- table/options/fetcher intentionally ignored
-        const listQuery = useMemo(() => repository.listQuery(table, options, () => fetcher(param)), [repository, JSON.stringify(param)]);
+        const listQuery = useMemo(() => repository.listQuery(table, options, () => fetcher(param)), [JSON.stringify(param)]);
         useEffect(() => {
             return () => listQuery.dispose();
         }, [listQuery]);
@@ -80,6 +86,7 @@ export function createRepositoryContext() {
         return useSubscribedState($state, () => ({ records: listQuery.$records.value, ...listQuery.$status.value }));
     }
     return {
+        repository,
         RepositoryProvider,
         useRepository,
         useRepositoryQuery,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "entity-repository",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Type-safe entity caching and state management with RxJS and React",
   "type": "module",
   "main": "./dist/index.js",
@@ -54,6 +54,7 @@
   "devDependencies": {
     "@types/node": "^22.0.0",
     "@types/react": "^19.2.8",
+    "react": "^19.0.0",
     "tsx": "^4.19.0",
     "typescript": "^5.9.3"
   }