@topgunbuild/react 0.1.0

package/LICENSE

@@ -0,0 +1,97 @@
+Business Source License 1.1
+
+Parameters
+
+Licensor:             TopGun Contributors
+Licensed Work:        TopGun
+                      The Licensed Work is (c) 2024 TopGun Contributors.
+Additional Use Grant: You may make production use of the Licensed Work,
+                      provided Your use does not include offering the
+                      Licensed Work to third parties as a commercial
+                      managed database service, database-as-a-service,
+                      or similar hosted database offering that competes
+                      with TopGun products or services.
+
+                      For purposes of this license:
+                      - "Managed database service" means a service that
+                        allows third parties to create, manage, or operate
+                        databases using TopGun as the underlying technology.
+                      - Internal use within your organization is permitted.
+                      - Using TopGun as part of your application's backend
+                        (not exposed as a database service) is permitted.
+                      - Consulting and professional services around TopGun
+                        are permitted.
+
+Change Date:          Four years from the date of each version release
+Change License:       Apache License, Version 2.0
+
+For information about alternative licensing arrangements for the Licensed Work,
+please contact the Licensor.
+
+Notice
+
+Business Source License 1.1
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+MariaDB hereby grants you permission to use this License's text to license
+your works, and to refer to it using the trademark "Business Source License",
+as long as you comply with the Covenants of Licensor below.
+
+Covenants of Licensor
+
+In consideration of the right to use this License's text and the "Business
+Source License" name and trademark, Licensor covenants to MariaDB, and to all
+other recipients of the licensed work to be provided by Licensor:
+
+1. To specify as the Change License the GPL Version 2.0 or any later version,
+   or a license that is compatible with GPL Version 2.0 or a later version,
+   where "compatible" means that software provided under the Change License can
+   be included in a program with software provided under GPL Version 2.0 or a
+   later version. Licensor may specify additional Change Licenses without
+   limitation.
+
+2. To either: (a) specify an Additional Use Grant (above) that does not impose
+   any additional restriction on the right granted in this License, as the
+   Additional Use Grant; or (b) insert the text "None" to specify a Change Date.
+
+3. Not to modify this License in any other way.

package/dist/index.d.mts

@@ -0,0 +1,34 @@
+import React, { ReactNode } from 'react';
+import * as _topgunbuild_client from '@topgunbuild/client';
+import { TopGunClient, QueryResultItem, QueryFilter, TopicCallback } from '@topgunbuild/client';
+import { LWWMap, ORMap } from '@topgunbuild/core';
+
+interface TopGunProviderProps {
+    client: TopGunClient;
+    children: ReactNode;
+}
+declare const TopGunProvider: React.FC<TopGunProviderProps>;
+declare function useClient(): TopGunClient;
+
+interface UseQueryResult<T> {
+    data: QueryResultItem<T>[];
+    loading: boolean;
+    error: Error | null;
+}
+declare function useQuery<T = any>(mapName: string, query?: QueryFilter): UseQueryResult<T>;
+
+interface UseMutationResult<T, K = string> {
+    create: (key: K, value: T) => void;
+    update: (key: K, value: T) => void;
+    remove: (key: K) => void;
+    map: any;
+}
+declare function useMutation<T = any, K = string>(mapName: string): UseMutationResult<T, K>;
+
+declare function useMap<K = string, V = any>(mapName: string): LWWMap<K, V>;
+
+declare function useORMap<K = string, V = any>(mapName: string): ORMap<K, V>;
+
+declare function useTopic(topicName: string, callback?: TopicCallback): _topgunbuild_client.TopicHandle;
+
+export { TopGunProvider, type TopGunProviderProps, type UseMutationResult, type UseQueryResult, useClient, useMap, useMutation, useORMap, useQuery, useTopic };

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+import React, { ReactNode } from 'react';
+import * as _topgunbuild_client from '@topgunbuild/client';
+import { TopGunClient, QueryResultItem, QueryFilter, TopicCallback } from '@topgunbuild/client';
+import { LWWMap, ORMap } from '@topgunbuild/core';
+
+interface TopGunProviderProps {
+    client: TopGunClient;
+    children: ReactNode;
+}
+declare const TopGunProvider: React.FC<TopGunProviderProps>;
+declare function useClient(): TopGunClient;
+
+interface UseQueryResult<T> {
+    data: QueryResultItem<T>[];
+    loading: boolean;
+    error: Error | null;
+}
+declare function useQuery<T = any>(mapName: string, query?: QueryFilter): UseQueryResult<T>;
+
+interface UseMutationResult<T, K = string> {
+    create: (key: K, value: T) => void;
+    update: (key: K, value: T) => void;
+    remove: (key: K) => void;
+    map: any;
+}
+declare function useMutation<T = any, K = string>(mapName: string): UseMutationResult<T, K>;
+
+declare function useMap<K = string, V = any>(mapName: string): LWWMap<K, V>;
+
+declare function useORMap<K = string, V = any>(mapName: string): ORMap<K, V>;
+
+declare function useTopic(topicName: string, callback?: TopicCallback): _topgunbuild_client.TopicHandle;
+
+export { TopGunProvider, type TopGunProviderProps, type UseMutationResult, type UseQueryResult, useClient, useMap, useMutation, useORMap, useQuery, useTopic };

package/dist/index.js

@@ -0,0 +1,181 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  TopGunProvider: () => TopGunProvider,
+  useClient: () => useClient,
+  useMap: () => useMap,
+  useMutation: () => useMutation,
+  useORMap: () => useORMap,
+  useQuery: () => useQuery,
+  useTopic: () => useTopic
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/TopGunProvider.tsx
+var import_react = require("react");
+var import_jsx_runtime = require("react/jsx-runtime");
+var TopGunContext = (0, import_react.createContext)(null);
+var TopGunProvider = ({ client, children }) => {
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(TopGunContext.Provider, { value: client, children });
+};
+function useClient() {
+  const client = (0, import_react.useContext)(TopGunContext);
+  if (!client) {
+    throw new Error("useClient must be used within a TopGunProvider");
+  }
+  return client;
+}
+
+// src/hooks/useQuery.ts
+var import_react2 = require("react");
+function useQuery(mapName, query = {}) {
+  const client = useClient();
+  const [data, setData] = (0, import_react2.useState)([]);
+  const [loading, setLoading] = (0, import_react2.useState)(true);
+  const [error, setError] = (0, import_react2.useState)(null);
+  const isMounted = (0, import_react2.useRef)(true);
+  const queryJson = JSON.stringify(query);
+  (0, import_react2.useEffect)(() => {
+    isMounted.current = true;
+    setLoading(true);
+    try {
+      const handle = client.query(mapName, query);
+      const unsubscribe = handle.subscribe((results) => {
+        if (isMounted.current) {
+          setData(results);
+          setLoading(false);
+        }
+      });
+      return () => {
+        isMounted.current = false;
+        unsubscribe();
+      };
+    } catch (err) {
+      if (isMounted.current) {
+        setError(err instanceof Error ? err : new Error(String(err)));
+        setLoading(false);
+      }
+      return () => {
+        isMounted.current = false;
+      };
+    }
+  }, [client, mapName, queryJson]);
+  return { data, loading, error };
+}
+
+// src/hooks/useMutation.ts
+var import_react3 = require("react");
+function useMutation(mapName) {
+  const client = useClient();
+  const map = client.getMap(mapName);
+  const create = (0, import_react3.useCallback)((key, value) => {
+    map.set(key, value);
+  }, [map]);
+  const update = (0, import_react3.useCallback)((key, value) => {
+    map.set(key, value);
+  }, [map]);
+  const remove = (0, import_react3.useCallback)((key) => {
+    map.remove(key);
+  }, [map]);
+  return { create, update, remove, map };
+}
+
+// src/hooks/useMap.ts
+var import_react4 = require("react");
+function useMap(mapName) {
+  const client = useClient();
+  const map = client.getMap(mapName);
+  const [, setTick] = (0, import_react4.useState)(0);
+  const isMounted = (0, import_react4.useRef)(true);
+  (0, import_react4.useEffect)(() => {
+    isMounted.current = true;
+    const unsubscribe = map.onChange(() => {
+      if (isMounted.current) {
+        setTick((t) => t + 1);
+      }
+    });
+    return () => {
+      isMounted.current = false;
+      unsubscribe();
+    };
+  }, [map]);
+  return map;
+}
+
+// src/hooks/useORMap.ts
+var import_react5 = require("react");
+function useORMap(mapName) {
+  const client = useClient();
+  const map = client.getORMap(mapName);
+  const [, setTick] = (0, import_react5.useState)(0);
+  const isMounted = (0, import_react5.useRef)(true);
+  (0, import_react5.useEffect)(() => {
+    isMounted.current = true;
+    const unsubscribe = map.onChange(() => {
+      if (isMounted.current) {
+        setTick((t) => t + 1);
+      }
+    });
+    return () => {
+      isMounted.current = false;
+      unsubscribe();
+    };
+  }, [map]);
+  return map;
+}
+
+// src/hooks/useTopic.ts
+var import_react6 = require("react");
+function useTopic(topicName, callback) {
+  const client = useClient();
+  const topic = client.topic(topicName);
+  const isMounted = (0, import_react6.useRef)(true);
+  const callbackRef = (0, import_react6.useRef)(callback);
+  (0, import_react6.useEffect)(() => {
+    callbackRef.current = callback;
+  }, [callback]);
+  (0, import_react6.useEffect)(() => {
+    isMounted.current = true;
+    if (!callback) return;
+    const unsubscribe = topic.subscribe((data, context) => {
+      if (isMounted.current && callbackRef.current) {
+        callbackRef.current(data, context);
+      }
+    });
+    return () => {
+      isMounted.current = false;
+      unsubscribe();
+    };
+  }, [topic, callback]);
+  return topic;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TopGunProvider,
+  useClient,
+  useMap,
+  useMutation,
+  useORMap,
+  useQuery,
+  useTopic
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/TopGunProvider.tsx","../src/hooks/useQuery.ts","../src/hooks/useMutation.ts","../src/hooks/useMap.ts","../src/hooks/useORMap.ts","../src/hooks/useTopic.ts"],"sourcesContent":["export * from './TopGunProvider';\nexport * from './hooks/useClient';\nexport * from './hooks/useQuery';\nexport * from './hooks/useMutation';\nexport * from './hooks/useMap';\nexport * from './hooks/useORMap';\nexport * from './hooks/useTopic';\n\n","import React, { createContext, useContext, ReactNode } from 'react';\nimport { TopGunClient } from '@topgunbuild/client';\n\nconst TopGunContext = createContext<TopGunClient | null>(null);\n\nexport interface TopGunProviderProps {\n  client: TopGunClient;\n  children: ReactNode;\n}\n\nexport const TopGunProvider: React.FC<TopGunProviderProps> = ({ client, children }) => {\n  return (\n    <TopGunContext.Provider value={client}>\n      {children}\n    </TopGunContext.Provider>\n  );\n};\n\nexport function useClient(): TopGunClient {\n  const client = useContext(TopGunContext);\n  if (!client) {\n    throw new Error('useClient must be used within a TopGunProvider');\n  }\n  return client;\n}\n\n","import { useState, useEffect, useRef } from 'react';\nimport { QueryFilter, QueryResultItem } from '@topgunbuild/client';\nimport { useClient } from './useClient';\n\nexport interface UseQueryResult<T> {\n  data: QueryResultItem<T>[];\n  loading: boolean;\n  error: Error | null;\n}\n\nexport function useQuery<T = any>(mapName: string, query: QueryFilter = {}): UseQueryResult<T> {\n  const client = useClient();\n  const [data, setData] = useState<QueryResultItem<T>[]>([]);\n  const [loading, setLoading] = useState(true);\n  const [error, setError] = useState<Error | null>(null);\n\n  // Use a ref to track if the component is mounted to avoid state updates on unmounted components\n  const isMounted = useRef(true);\n\n  // We serialize the query to use it as a stable dependency for the effect\n  const queryJson = JSON.stringify(query);\n\n  useEffect(() => {\n    isMounted.current = true;\n    setLoading(true);\n    \n    try {\n      const handle = client.query<T>(mapName, query);\n\n      const unsubscribe = handle.subscribe((results) => {\n        if (isMounted.current) {\n          setData(results);\n          setLoading(false);\n        }\n      });\n\n      return () => {\n        isMounted.current = false;\n        unsubscribe();\n      };\n    } catch (err) {\n      if (isMounted.current) {\n        setError(err instanceof Error ? err : new Error(String(err)));\n        setLoading(false);\n      }\n      return () => {\n        isMounted.current = false;\n      };\n    }\n  }, [client, mapName, queryJson]);\n\n  return { data, loading, error };\n}\n\n","import { useCallback } from 'react';\nimport { useClient } from './useClient';\n\nexport interface UseMutationResult<T, K = string> {\n  create: (key: K, value: T) => void;\n  update: (key: K, value: T) => void;\n  remove: (key: K) => void;\n  map: any; // Expose map instance if needed\n}\n\nexport function useMutation<T = any, K = string>(mapName: string): UseMutationResult<T, K> {\n  const client = useClient();\n  // We get the map instance. Note: getMap is synchronous but might trigger async restore.\n  // LWWMap is the default assumption for simple mutations.\n  const map = client.getMap<K, T>(mapName);\n\n  const create = useCallback((key: K, value: T) => {\n    map.set(key, value);\n  }, [map]);\n\n  const update = useCallback((key: K, value: T) => {\n    map.set(key, value);\n  }, [map]);\n\n  const remove = useCallback((key: K) => {\n    map.remove(key);\n  }, [map]);\n\n  return { create, update, remove, map };\n}\n\n","import { useState, useEffect, useRef } from 'react';\nimport { LWWMap } from '@topgunbuild/core';\nimport { useClient } from './useClient';\n\nexport function useMap<K = string, V = any>(mapName: string): LWWMap<K, V> {\n    const client = useClient();\n    // Get the map instance. This is stable for the same mapName.\n    const map = client.getMap<K, V>(mapName);\n\n    // We use a dummy state to trigger re-renders when the map changes\n    const [, setTick] = useState(0);\n    const isMounted = useRef(true);\n\n    useEffect(() => {\n        isMounted.current = true;\n\n        // Subscribe to map changes\n        const unsubscribe = map.onChange(() => {\n            if (isMounted.current) {\n                setTick(t => t + 1);\n            }\n        });\n\n        return () => {\n            isMounted.current = false;\n            unsubscribe();\n        };\n    }, [map]);\n\n    return map;\n}\n","import { useState, useEffect, useRef } from 'react';\nimport { ORMap } from '@topgunbuild/core';\nimport { useClient } from './useClient';\n\nexport function useORMap<K = string, V = any>(mapName: string): ORMap<K, V> {\n    const client = useClient();\n    const map = client.getORMap<K, V>(mapName);\n\n    const [, setTick] = useState(0);\n    const isMounted = useRef(true);\n\n    useEffect(() => {\n        isMounted.current = true;\n\n        const unsubscribe = map.onChange(() => {\n            if (isMounted.current) {\n                setTick(t => t + 1);\n            }\n        });\n\n        return () => {\n            isMounted.current = false;\n            unsubscribe();\n        };\n    }, [map]);\n\n    return map;\n}\n","import { useEffect, useRef } from 'react';\nimport { TopicCallback } from '@topgunbuild/client';\nimport { useClient } from './useClient';\n\nexport function useTopic(topicName: string, callback?: TopicCallback) {\n    const client = useClient();\n    const topic = client.topic(topicName);\n    const isMounted = useRef(true);\n\n    // Keep callback ref stable to avoid re-subscribing if callback function identity changes\n    const callbackRef = useRef(callback);\n    useEffect(() => {\n        callbackRef.current = callback;\n    }, [callback]);\n\n    useEffect(() => {\n        isMounted.current = true;\n\n        if (!callback) return;\n\n        const unsubscribe = topic.subscribe((data, context) => {\n            if (isMounted.current && callbackRef.current) {\n                callbackRef.current(data, context);\n            }\n        });\n\n        return () => {\n            isMounted.current = false;\n            unsubscribe();\n        };\n    }, [topic, callback]); // Re-subscribe if topic handle changes (rare) or if callback presence toggles\n\n    return topic;\n}\n"],"mappings":"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","names":["import_react","import_react","import_react","import_react","import_react"]}

package/dist/index.mjs

@@ -0,0 +1,148 @@
+// src/TopGunProvider.tsx
+import { createContext, useContext } from "react";
+import { jsx } from "react/jsx-runtime";
+var TopGunContext = createContext(null);
+var TopGunProvider = ({ client, children }) => {
+  return /* @__PURE__ */ jsx(TopGunContext.Provider, { value: client, children });
+};
+function useClient() {
+  const client = useContext(TopGunContext);
+  if (!client) {
+    throw new Error("useClient must be used within a TopGunProvider");
+  }
+  return client;
+}
+
+// src/hooks/useQuery.ts
+import { useState, useEffect, useRef } from "react";
+function useQuery(mapName, query = {}) {
+  const client = useClient();
+  const [data, setData] = useState([]);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const isMounted = useRef(true);
+  const queryJson = JSON.stringify(query);
+  useEffect(() => {
+    isMounted.current = true;
+    setLoading(true);
+    try {
+      const handle = client.query(mapName, query);
+      const unsubscribe = handle.subscribe((results) => {
+        if (isMounted.current) {
+          setData(results);
+          setLoading(false);
+        }
+      });
+      return () => {
+        isMounted.current = false;
+        unsubscribe();
+      };
+    } catch (err) {
+      if (isMounted.current) {
+        setError(err instanceof Error ? err : new Error(String(err)));
+        setLoading(false);
+      }
+      return () => {
+        isMounted.current = false;
+      };
+    }
+  }, [client, mapName, queryJson]);
+  return { data, loading, error };
+}
+
+// src/hooks/useMutation.ts
+import { useCallback } from "react";
+function useMutation(mapName) {
+  const client = useClient();
+  const map = client.getMap(mapName);
+  const create = useCallback((key, value) => {
+    map.set(key, value);
+  }, [map]);
+  const update = useCallback((key, value) => {
+    map.set(key, value);
+  }, [map]);
+  const remove = useCallback((key) => {
+    map.remove(key);
+  }, [map]);
+  return { create, update, remove, map };
+}
+
+// src/hooks/useMap.ts
+import { useState as useState2, useEffect as useEffect2, useRef as useRef2 } from "react";
+function useMap(mapName) {
+  const client = useClient();
+  const map = client.getMap(mapName);
+  const [, setTick] = useState2(0);
+  const isMounted = useRef2(true);
+  useEffect2(() => {
+    isMounted.current = true;
+    const unsubscribe = map.onChange(() => {
+      if (isMounted.current) {
+        setTick((t) => t + 1);
+      }
+    });
+    return () => {
+      isMounted.current = false;
+      unsubscribe();
+    };
+  }, [map]);
+  return map;
+}
+
+// src/hooks/useORMap.ts
+import { useState as useState3, useEffect as useEffect3, useRef as useRef3 } from "react";
+function useORMap(mapName) {
+  const client = useClient();
+  const map = client.getORMap(mapName);
+  const [, setTick] = useState3(0);
+  const isMounted = useRef3(true);
+  useEffect3(() => {
+    isMounted.current = true;
+    const unsubscribe = map.onChange(() => {
+      if (isMounted.current) {
+        setTick((t) => t + 1);
+      }
+    });
+    return () => {
+      isMounted.current = false;
+      unsubscribe();
+    };
+  }, [map]);
+  return map;
+}
+
+// src/hooks/useTopic.ts
+import { useEffect as useEffect4, useRef as useRef4 } from "react";
+function useTopic(topicName, callback) {
+  const client = useClient();
+  const topic = client.topic(topicName);
+  const isMounted = useRef4(true);
+  const callbackRef = useRef4(callback);
+  useEffect4(() => {
+    callbackRef.current = callback;
+  }, [callback]);
+  useEffect4(() => {
+    isMounted.current = true;
+    if (!callback) return;
+    const unsubscribe = topic.subscribe((data, context) => {
+      if (isMounted.current && callbackRef.current) {
+        callbackRef.current(data, context);
+      }
+    });
+    return () => {
+      isMounted.current = false;
+      unsubscribe();
+    };
+  }, [topic, callback]);
+  return topic;
+}
+export {
+  TopGunProvider,
+  useClient,
+  useMap,
+  useMutation,
+  useORMap,
+  useQuery,
+  useTopic
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/TopGunProvider.tsx","../src/hooks/useQuery.ts","../src/hooks/useMutation.ts","../src/hooks/useMap.ts","../src/hooks/useORMap.ts","../src/hooks/useTopic.ts"],"sourcesContent":["import React, { createContext, useContext, ReactNode } from 'react';\nimport { TopGunClient } from '@topgunbuild/client';\n\nconst TopGunContext = createContext<TopGunClient | null>(null);\n\nexport interface TopGunProviderProps {\n  client: TopGunClient;\n  children: ReactNode;\n}\n\nexport const TopGunProvider: React.FC<TopGunProviderProps> = ({ client, children }) => {\n  return (\n    <TopGunContext.Provider value={client}>\n      {children}\n    </TopGunContext.Provider>\n  );\n};\n\nexport function useClient(): TopGunClient {\n  const client = useContext(TopGunContext);\n  if (!client) {\n    throw new Error('useClient must be used within a TopGunProvider');\n  }\n  return client;\n}\n\n","import { useState, useEffect, useRef } from 'react';\nimport { QueryFilter, QueryResultItem } from '@topgunbuild/client';\nimport { useClient } from './useClient';\n\nexport interface UseQueryResult<T> {\n  data: QueryResultItem<T>[];\n  loading: boolean;\n  error: Error | null;\n}\n\nexport function useQuery<T = any>(mapName: string, query: QueryFilter = {}): UseQueryResult<T> {\n  const client = useClient();\n  const [data, setData] = useState<QueryResultItem<T>[]>([]);\n  const [loading, setLoading] = useState(true);\n  const [error, setError] = useState<Error | null>(null);\n\n  // Use a ref to track if the component is mounted to avoid state updates on unmounted components\n  const isMounted = useRef(true);\n\n  // We serialize the query to use it as a stable dependency for the effect\n  const queryJson = JSON.stringify(query);\n\n  useEffect(() => {\n    isMounted.current = true;\n    setLoading(true);\n    \n    try {\n      const handle = client.query<T>(mapName, query);\n\n      const unsubscribe = handle.subscribe((results) => {\n        if (isMounted.current) {\n          setData(results);\n          setLoading(false);\n        }\n      });\n\n      return () => {\n        isMounted.current = false;\n        unsubscribe();\n      };\n    } catch (err) {\n      if (isMounted.current) {\n        setError(err instanceof Error ? err : new Error(String(err)));\n        setLoading(false);\n      }\n      return () => {\n        isMounted.current = false;\n      };\n    }\n  }, [client, mapName, queryJson]);\n\n  return { data, loading, error };\n}\n\n","import { useCallback } from 'react';\nimport { useClient } from './useClient';\n\nexport interface UseMutationResult<T, K = string> {\n  create: (key: K, value: T) => void;\n  update: (key: K, value: T) => void;\n  remove: (key: K) => void;\n  map: any; // Expose map instance if needed\n}\n\nexport function useMutation<T = any, K = string>(mapName: string): UseMutationResult<T, K> {\n  const client = useClient();\n  // We get the map instance. Note: getMap is synchronous but might trigger async restore.\n  // LWWMap is the default assumption for simple mutations.\n  const map = client.getMap<K, T>(mapName);\n\n  const create = useCallback((key: K, value: T) => {\n    map.set(key, value);\n  }, [map]);\n\n  const update = useCallback((key: K, value: T) => {\n    map.set(key, value);\n  }, [map]);\n\n  const remove = useCallback((key: K) => {\n    map.remove(key);\n  }, [map]);\n\n  return { create, update, remove, map };\n}\n\n","import { useState, useEffect, useRef } from 'react';\nimport { LWWMap } from '@topgunbuild/core';\nimport { useClient } from './useClient';\n\nexport function useMap<K = string, V = any>(mapName: string): LWWMap<K, V> {\n    const client = useClient();\n    // Get the map instance. This is stable for the same mapName.\n    const map = client.getMap<K, V>(mapName);\n\n    // We use a dummy state to trigger re-renders when the map changes\n    const [, setTick] = useState(0);\n    const isMounted = useRef(true);\n\n    useEffect(() => {\n        isMounted.current = true;\n\n        // Subscribe to map changes\n        const unsubscribe = map.onChange(() => {\n            if (isMounted.current) {\n                setTick(t => t + 1);\n            }\n        });\n\n        return () => {\n            isMounted.current = false;\n            unsubscribe();\n        };\n    }, [map]);\n\n    return map;\n}\n","import { useState, useEffect, useRef } from 'react';\nimport { ORMap } from '@topgunbuild/core';\nimport { useClient } from './useClient';\n\nexport function useORMap<K = string, V = any>(mapName: string): ORMap<K, V> {\n    const client = useClient();\n    const map = client.getORMap<K, V>(mapName);\n\n    const [, setTick] = useState(0);\n    const isMounted = useRef(true);\n\n    useEffect(() => {\n        isMounted.current = true;\n\n        const unsubscribe = map.onChange(() => {\n            if (isMounted.current) {\n                setTick(t => t + 1);\n            }\n        });\n\n        return () => {\n            isMounted.current = false;\n            unsubscribe();\n        };\n    }, [map]);\n\n    return map;\n}\n","import { useEffect, useRef } from 'react';\nimport { TopicCallback } from '@topgunbuild/client';\nimport { useClient } from './useClient';\n\nexport function useTopic(topicName: string, callback?: TopicCallback) {\n    const client = useClient();\n    const topic = client.topic(topicName);\n    const isMounted = useRef(true);\n\n    // Keep callback ref stable to avoid re-subscribing if callback function identity changes\n    const callbackRef = useRef(callback);\n    useEffect(() => {\n        callbackRef.current = callback;\n    }, [callback]);\n\n    useEffect(() => {\n        isMounted.current = true;\n\n        if (!callback) return;\n\n        const unsubscribe = topic.subscribe((data, context) => {\n            if (isMounted.current && callbackRef.current) {\n                callbackRef.current(data, context);\n            }\n        });\n\n        return () => {\n            isMounted.current = false;\n            unsubscribe();\n        };\n    }, [topic, callback]); // Re-subscribe if topic handle changes (rare) or if callback presence toggles\n\n    return topic;\n}\n"],"mappings":"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","names":["useState","useEffect","useRef","useState","useRef","useEffect","useState","useEffect","useRef","useState","useRef","useEffect","useEffect","useRef","useRef","useEffect"]}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@topgunbuild/react",
+  "version": "0.1.0",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "react": ">=16.8.0",
+    "react-dom": ">=16.8.0"
+  },
+  "dependencies": {
+    "@topgunbuild/client": "0.1.0",
+    "@topgunbuild/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^14.0.0",
+    "@types/jest": "^29.5.14",
+    "@types/react": "^18.0.28",
+    "@types/react-dom": "^18.0.11",
+    "jest": "^29.7.0",
+    "jest-environment-jsdom": "^29.7.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "react-test-renderer": "^18.2.0",
+    "ts-jest": "^29.1.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "BSL-1.1",
+  "scripts": {
+    "build": "tsup",
+    "test": "jest",
+    "test:coverage": "jest --coverage"
+  }
+}