@trakit/react 0.0.2 → 0.0.4

package/hooks/useConnection.d.ts

@@ -37,5 +37,5 @@ export type UseConnectionResult = {
  * It initializes the synchronizer, listens for connection and account events,
  * and provides the current connection state and user/machine information.
  */
-export default function useConnection(restAddress?: URL | url | nothing, socketAddress?: URL | url | nothing): UseConnectionResult;
+export declare function useConnection(restAddress?: URL | url | nothing, socketAddress?: URL | url | nothing): UseConnectionResult;
 //# sourceMappingURL=useConnection.d.ts.map

package/hooks/useSync.d.ts

@@ -1,31 +1,54 @@
 import { Reply } from '@trakit/commands';
 import { IBelongCompany, IRequestable, nothing, SyncName, ulong } from '@trakit/objects';
 /**
- * The result of the `useSync` hook.
+ * The result of the `useSync` hook and `useSingle` hook.
  */
-export type UseSyncResult<T> = {
+export interface UseSyncResult {
     /**
-     * Whether the hook is currently loading data. This will be `true` until the initial synchronization is complete, and may briefly become `true` again if the connection is lost and re-established.
+     * Whether the hook is currently loading data. This will be `true` until the initial synchronization
+     * is complete, and may briefly become `true` again if the connection is lost and re-established.
      */
-    ready: boolean;
+    loading: boolean;
     /**
      * The list of replies received from the synchronization process.
      * This is normally not needed, but can be useful for debugging or error handling,
      * as it contains the {@link Reply} classes with {@link ErrorCode} and {@link ErrorDetail}.
      */
-    replies: Reply[];
+    replies: Reply[] | null;
+}
+/**
+ * The result of the `useSync` hook.
+ * This object behaves like a dictionary, where the {@link UseSyncResult} properties are combined with
+ * the synchronized objects of type `T` for each requested types.
+ */
+export type UseSyncMultiple<T extends IRequestable & IBelongCompany> = UseSyncResult & {
+    [key in SyncName]?: T[] | nothing;
+};
+/**
+ * The result of the `useSingle` hook.
+ * This is a combination of the {@link UseSyncResult} and the synchronized objects of type `T`
+ * for the given type, which are stored in an array.
+ */
+export type UseSyncSingle<T extends IRequestable & IBelongCompany> = UseSyncResult & {
     /**
-     * The list of synchronized objects of type `T`.
+     * The list of synchronized objects of the requested type.
      */
-    objects: T[];
+    objects: T[] | nothing;
 };
 /**
- * Subscribes to the given sync types for the current company, returning the
- * live list of synchronized objects and re-rendering the consumer whenever
- * that list changes.
+ * Subscribes to the given sync types for the given company, returning the live list of synchronized
+ * objects and re-rendering whenever any object, or part of that list changes.
+ * @param types		The {@link SyncName} array to subscribe to.
+ * @param companyId	Optional company ID to filter the synchronized objects. Default is your own company.
+ * @returns			An object containing the loading state, the list of replies, and the list(s) of synchronized objects.
+ */
+export declare function useSync<T extends IRequestable & IBelongCompany>(types: SyncName[], companyId?: ulong | nothing): UseSyncMultiple<T>;
+/**
+ * Subscribes to the given sync type for the given company, returning the live list of synchronized
+ * objects and re-rendering whenever any object, or part of that list changes.
  * @param type		The {@link SyncName} to subscribe to.
  * @param companyId	Optional company ID to filter the synchronized objects. Default is your own company.
  * @returns			An object containing the loading state, the list of replies, and the list of synchronized objects.
  */
-export default function useSync<T extends IRequestable & IBelongCompany>(type: SyncName, companyId?: ulong | nothing): UseSyncResult<T>;
+export declare function useSingle<T extends IRequestable & IBelongCompany>(type: SyncName, companyId?: ulong | nothing): UseSyncSingle<T>;
 //# sourceMappingURL=useSync.d.ts.map

package/index.d.ts

@@ -4,15 +4,15 @@
  * Last updated on Thu June 11 2026 15:43:01
  * @copyright Trak-iT Wireless Inc. 2026
  */
-import useConnection, { UseConnectionResult } from "./hooks/useConnection";
+import { useConnection, UseConnectionResult } from "./hooks/useConnection";
 import useIsOnline from "./hooks/useIsOnline";
-import useSync, { UseSyncResult } from "./hooks/useSync";
+import { useSingle, useSync, UseSyncMultiple, UseSyncResult, UseSyncSingle } from "./hooks/useSync";
 /**
  * Version number for this release.
  */
-export declare const version = "0.0.2";
+export declare const version = "0.0.4";
 /**
  * Hooks
  */
-export { useConnection, useIsOnline, useSync, type UseConnectionResult, type UseSyncResult };
+export { useConnection, useIsOnline, useSingle, useSync, type UseConnectionResult, type UseSyncMultiple, type UseSyncResult, type UseSyncSingle };
 //# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@trakit/react",
   "type": "module",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "main": "./trakit-react.min.js",
   "types": "./index.d.ts",
   "scripts": {

package/trakit-react.min.js

@@ -1,7 +1,7 @@
-function n(n,e){function t(n){I(n.online)}function o(n){const{account:e}=n;e.user?.login&&e.expiry>new Date?(u(y,e.ghostId,{...k,expires:e.expiry}),D(e.ghostId||"")):m(y,k),z(e.user||null),e.machine?.key&&e.expiry>new Date?(u(h,e.machine.key,{...k,expires:e.expiry}),u(g,e.machine.secret,{...k,expires:e.expiry})):(m(h,k),m(g,k)),S(e.machine||null)}const i=f(new s(null,n||l.URI_PROD,e||a.URI_PROD)),[r,u,m]=w([y,h,g]),[x,I]=d(i.current.socketOnline),[b,D]=d(r[y]||""),[j,z]=d(i.current.account.user||null),[N,S]=d(i.current.account.machine||r[h]&&new c({key:r[h],secret:r[g]})||null),v=x===!(!b&&!N);return p(()=>(i.current.on("open",t),i.current.on("error",t),i.current.on("close",t),i.current.on("account",o),(b||N)&&i.current.setAuth({ghostId:b,machine:N?.toJSON()}),()=>i.current.dispose()),[]),{synchronizer:i.current,ready:v,ghostId:b,online:x,user:j,machine:N}}function e(n){return window.addEventListener("online",n),window.addEventListener("offline",n),()=>{window.removeEventListener("online",n),window.removeEventListener("offline",n)}}function t(){return navigator.onLine}function o(){return!0}function i(){return m(e,t,o)}function r(e,t){const o=f(null),i=f(0),[r,c]=d(null),[s,l]=d(null),{synchronizer:m,ready:w,online:y,user:h,machine:g}=n();return p(()=>{function n(n,o){0!==i.current&&t===o&&e===n&&l([...u[n].values().filter(n=>n.companyId===t)])}function s(e){const{kind:t,companyId:o}=e;n(t,o)}function f(e){const{name:t,body:o}=e;n(a.msgNameToSyncName(t),o.company)}function d(){if(0===i.current){const n=r?.map(n=>n.syncName).filter(n=>!!n);n?.length&&m.desync(t,n),m.off("list",s),m.off("update",s),m.off("delete",s),m.off("message",f)}o.current=null}function p(o){c(o),n(e,t)}if(w&&e&&!isNaN(t))return i.current++,m.on("list",s),m.on("update",s),m.on("delete",s),m.on("message",f),o.current=m.sync(t,[e]),o.current.then(p,p),o.current.finally(d),()=>{i.current--,o.current||d()}},[w,y,t=t??h?.companyId??g?.companyId,e]),{ready:w&&y&&!!s&&!o.current,replies:r??[],objects:s??[]}}
+function n(n,e){function t(n){b(n.online)}function o(n){const{account:e}=n;e.user?.login&&e.expiry>new Date?(c(h,e.ghostId,{...x,expires:e.expiry}),j(e.ghostId||"")):u(h,x),z(e.user||null),e.machine?.key&&e.expiry>new Date?(c(y,e.machine.key,{...x,expires:e.expiry}),c(k,e.machine.secret,{...x,expires:e.expiry})):(u(y,x),u(k,x)),S(e.machine||null)}const i=d(new l(null,n||a.URI_PROD,e||f.URI_PROD)),[r,c,u]=g([h,y,k]),[w,b]=p(i.current.socketOnline),[I,j]=p(r[h]||""),[D,z]=p(i.current.account.user||null),[N,S]=p(i.current.account.machine||r[y]&&new s({key:r[y],secret:r[k]})||null),v=w===!(!I&&!N);return m(()=>(i.current.on("open",t),i.current.on("error",t),i.current.on("close",t),i.current.on("account",o),(I||N)&&i.current.setAuth({ghostId:I,machine:N?.toJSON()}),()=>i.current.dispose()),[]),{synchronizer:i.current,ready:v,ghostId:I,online:w,user:D,machine:N}}function e(n){return window.addEventListener("online",n),window.addEventListener("offline",n),()=>{window.removeEventListener("online",n),window.removeEventListener("offline",n)}}function t(){return navigator.onLine}function o(){return!0}function i(){return w(e,t,o)}function r(e,t){const o=d(null),i=d(0),[r,c]=p(null),[s,l]=p({}),{synchronizer:a,ready:w,online:g,user:h,machine:y}=n();return m(()=>{function n(n,o){0!==i.current&&t===o&&e.includes(n)&&l(e=>({...e,[n]:[...u[n].values().filter(n=>n.companyId===t)]}))}function s(e){const{kind:t,companyId:o}=e;n(t,o)}function d(e){const{name:t,body:o}=e;n(f.msgNameToSyncName(t),o.company)}function p(){if(0===i.current){const n=r?.map(n=>n.syncName).filter(n=>!!n);n?.length&&a.desync(t,n),a.off("list",s),a.off("update",s),a.off("delete",s),a.off("message",d)}o.current=null}function m(o){c(o),e.forEach(e=>n(e,t))}if(w&&e?.length&&!isNaN(t))return i.current++,a.on("list",s),a.on("update",s),a.on("delete",s),a.on("message",d),o.current=a.sync(t,e),o.current.then(m,m),o.current.finally(p),()=>{i.current--,o.current||p()}},[t=t??h?.companyId??y?.companyId,e.sort().join(",")]),{loading:!(w&&g&&Object.keys(s).length&&!o.current),replies:r??[],...s}}function c(n,e){const{loading:t,replies:o,[n]:i}=r([n],e);return{loading:t,replies:o,objects:i??[]}}
 /**
  * ReactJS library.
  * {@link https://github.com/trakitwireless/trakit-ts-react|ReactJS controls.}
  * Last updated on Thu June 11 2026 15:43:01
  * @copyright Trak-iT Wireless Inc. 2026
- */import{Machine as c,storage as u}from"@trakit/objects";import{TrakitSyncCommander as s,TrakitRestfulCommander as l,TrakitSocketCommander as a}from"@trakit/sync";import{useRef as f,useState as d,useEffect as p,useSyncExternalStore as m}from"react";import{useCookies as w}from"react-cookie";const y="ghostId",h="apiKey",g="apiSec",k={path:"/",secure:!0,sameSite:"strict",expires:new Date(0)},x="0.0.2";export{n as useConnection,i as useIsOnline,r as useSync,x as version};
+ */import{Machine as s,storage as u}from"@trakit/objects";import{TrakitSyncCommander as l,TrakitRestfulCommander as a,TrakitSocketCommander as f}from"@trakit/sync";import{useRef as d,useState as p,useEffect as m,useSyncExternalStore as w}from"react";import{useCookies as g}from"react-cookie";const h="ghostId",y="aK",k="aS",x={path:"/",secure:!0,sameSite:"strict",expires:new Date(0)},b="0.0.4";export{n as useConnection,i as useIsOnline,c as useSingle,r as useSync,b as version};