@trakit/react 0.0.1 → 0.0.2

package/README.md

@@ -4,17 +4,25 @@ This library contains ReactJS controls, hooks, and contexts to assist in working
 
 ### Prerequisites
 
-The `@trakit/objects` and `@trakit/commands` packages are required since they contain the definitions for all the commands required to manipulate the objects.
+The `@trakit/objects`, `@trakit/commands` and `@trakit/sync` packages are required since they contain the definitions for all the commands required to manipulate the objects.
 
-In order to build this project, you need to install the RollupJS, and plugins for TypeScript and Minifying.
+In order to build this project, you need to install the ReactJS types, RollupJS, and plugins for TypeScript and Minifying.
 ```
-npm i rollup rollup-plugin-typescript2 @rollup/plugin-terser
+npm i @types/react rollup rollup-plugin-typescript2 @rollup/plugin-terser
 ```
 After those have been installed, build the project normally.
 ```
 rollup --config rollup.config.js
 ```
 
+### `useConnection` hook
+
+Used as the main hook for keeping a persistent connection.
+
+### `useSync` hook
+
+Used to synchronize the specified type(s) of objects with the system.  Internally, this hook uses `useConnection`.
+
 ## Questions and Feedback
 
 If you have any questions, please start for the project on GitHub

package/index.d.ts

@@ -10,7 +10,7 @@ import useSync, { UseSyncResult } from "./hooks/useSync";
 /**
  * Version number for this release.
  */
-export declare const version = "0.0.1";
+export declare const version = "0.0.2";
 /**
  * Hooks
  */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@trakit/react",
   "type": "module",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "main": "./trakit-react.min.js",
   "types": "./index.d.ts",
   "scripts": {
@@ -26,7 +26,7 @@
     "url": "https://github.com/trakitwireless/trakit-ts-react/issues"
   },
   "homepage": "https://github.com/trakitwireless/trakit-ts-react#readme",
-  "description": "Trak-iT uses these object definitions to interact with all our APIs.",
+  "description": "ReactJS controls, hooks, and contexts to assist in working with Trak-iT's APIs.",
   "devDependencies": {
     "@rollup/plugin-terser": "^1.0.0",
     "rollup": "^4.35.0",
@@ -37,7 +37,8 @@
   "dependencies": {
     "@trakit/commands": "^0.1.2",
     "@trakit/objects": "^0.1.2",
-    "@trakit/sync": "^0.1.1",
-    "@types/react": "^19.2.17"
+    "@trakit/sync": "^0.1.2",
+    "@types/react": "^19.2.17",
+    "react-cookie": "^8.1.2"
   }
 }

package/trakit-react.min.js

@@ -1,7 +1,7 @@
-function n(n,o){function e(n){d(n.online)}function t(n){const{account:o}=n;p(o.user?.login&&o.expiry>new Date?o.ghostId:""),y(o.user||null),g(o.machine||null)}const r=s(new c(null,n||u.URI_PROD,o||l.URI_PROD)),[i,d]=f(r.current.socketOnline),[m,p]=f(r.current.account.ghostId||""),[w,y]=f(r.current.account.user||null),[h,g]=f(r.current.account.machine||null),b=i===!(!m&&!h);return a(()=>(r.current.on("open",e),r.current.on("error",e),r.current.on("close",e),r.current.on("account",t),()=>{r.current.off("open",e),r.current.off("error",e),r.current.off("close",e),r.current.off("account",t),r.current.dispose()}),[]),{synchronizer:r.current,ready:b,ghostId:m,online:i,user:w,machine:h}}function o(n){return window.addEventListener("online",n),window.addEventListener("offline",n),()=>{window.removeEventListener("online",n),window.removeEventListener("offline",n)}}function e(){return navigator.onLine}function t(){return!0}function r(){return d(o,e,t)}function i(o,e){const t=s(null),r=s(0),[i,c]=f(null),[u,d]=f(null),{synchronizer:p,ready:w,online:y,user:h,machine:g}=n();return a(()=>{function n(n,t){0!==r.current&&e===t&&o===n&&d([...m[n].values().filter(n=>n.companyId===e)])}function u(o){const{kind:e,companyId:t}=o;n(e,t)}function s(o){const{name:e,body:t}=o;n(l.msgNameToSyncName(e),t.company)}function f(){if(0===r.current){const n=i?.map(n=>n.syncName).filter(n=>!!n);n?.length&&p.desync(e,n),p.off("list",u),p.off("update",u),p.off("delete",u),p.off("message",s)}t.current=null}function a(t){c(t),n(o,e)}if(w&&o&&!isNaN(e))return r.current++,p.on("list",u),p.on("update",u),p.on("delete",u),p.on("message",s),t.current=p.sync(e,[o]),t.current.then(a,a),t.current.finally(f),()=>{r.current--,t.current||f()}},[w,y,e=e??h?.companyId??g?.companyId,o]),{ready:w&&y&&!!u&&!t.current,replies:i??[],objects:u??[]}}
+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??[]}}
 /**
  * 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{TrakitSyncCommander as c,TrakitRestfulCommander as u,TrakitSocketCommander as l}from"@trakit/sync";import{useRef as s,useState as f,useEffect as a,useSyncExternalStore as d}from"react";import{storage as m}from"@trakit/objects";const p="0.0.1";export{n as useConnection,r as useIsOnline,i as useSync,p as version};
+ */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};