react-native-global-state-hooks 16.0.4 → 16.0.5

package/README.md

@@ -8,7 +8,7 @@
 
 <div align="center">
 
-**Zero setup. Native persistence. Maximum performance.** 🚀
+**Shared React Native state. Precise subscriptions. Async persistence.** 🚀
 
 _The simplicity of `useState`, shared across your React Native app._ ✨
 
@@ -16,7 +16,7 @@ _The simplicity of `useState`, shared across your React Native app._ ✨
 [![Downloads](https://img.shields.io/npm/dm/react-native-global-state-hooks.svg)](https://www.npmjs.com/package/react-native-global-state-hooks)
 [![License](https://img.shields.io/npm/l/react-native-global-state-hooks.svg)](https://github.com/johnny-quesada-developer/react-native-global-state-hooks/blob/master/LICENSE)
 
-[**NPM**](https://www.npmjs.com/package/react-native-global-state-hooks) • [**GitHub**](https://github.com/johnny-quesada-developer/react-native-global-state-hooks) • [**Core API Demo**](https://johnny-quesada-developer.github.io/global-hooks-example/) • [**Video Tutorial**](https://www.youtube.com/watch?v=1UBqXk2MH8I/)
+[**NPM**](https://www.npmjs.com/package/react-native-global-state-hooks) • [**GitHub**](https://github.com/johnny-quesada-developer/react-native-global-state-hooks) • [**Core API Demo**](https://johnny-quesada-developer.github.io/global-hooks-example/) • [**Video Tutorial**](https://www.youtube.com/watch?v=1UBqXk2MH8I)
 
 </div>
 
@@ -44,9 +44,9 @@ function Counter() {
 
 ---
 
-## 🚀 Why Developers Love This Library
+## 🚀 Built for React applications
 
-### 🎓 **Zero Learning Curve**
+### 🎓 **Familiar React API**
 
 If you know `useState`, the basic API already feels familiar:
 
@@ -203,7 +203,7 @@ function ThemeToggle() {
 }
 ```
 
-### 60 Seconds to Production-Ready
+### Actions with async persistence
 
 A persisted React Native store initializes **asynchronously**, so the hook also exposes storage readiness through metadata.
 
@@ -424,9 +424,9 @@ const useActiveAdmins = useActiveUsers.createSelectorHook((users) =>
 );
 
 function UserStats() {
-  const [users] = useUsers();
-  const [activeUsers] = useActiveUsers();
-  const [activeAdmins] = useActiveAdmins();
+  const users = useUsers();
+  const activeUsers = useActiveUsers();
+  const activeAdmins = useActiveAdmins();
 
   return (
     <View>
@@ -594,7 +594,7 @@ useFeed.setMetadata((metadata) => ({
   isLoading: true,
 }));
 
-const metadata = useFeed.getMetadata();
+const metadata = useFeed.metadata;
 
 console.log(metadata.isLoading);
 ```
@@ -1023,7 +1023,7 @@ const useUsers = Data.use.createSelectorHook((state) => state.users);
 const useActiveUsers = useUsers.createSelectorHook((users) => users.filter((user) => user.active));
 
 function ActiveUsers() {
-  const [users] = useActiveUsers();
+  const users = useActiveUsers();
 
   return (
     <View>
@@ -1323,7 +1323,7 @@ const useApp = createGlobalState({
 | 📦 [**NPM Package**](https://www.npmjs.com/package/react-native-global-state-hooks)                     | Published React Native package                       |
 | 💻 [**GitHub Repository**](https://github.com/johnny-quesada-developer/react-native-global-state-hooks) | Source, tests, and issues                            |
 | 🎮 [**Core API Demo**](https://johnny-quesada-developer.github.io/global-hooks-example/)                | Browser demo of the shared state-management concepts |
-| 🎥 [**Video Tutorial**](https://www.youtube.com/watch?v=1UBqXk2MH8I/)                                   | State-management walkthrough                         |
+| 🎥 [**Video Tutorial**](https://www.youtube.com/watch?v=1UBqXk2MH8I)                                   | State-management walkthrough                         |
 | 📚 [**Core Package**](https://www.npmjs.com/package/react-hooks-global-states)                          | Shared state engine used by the platform packages    |
 
 ---
@@ -1342,7 +1342,7 @@ The state-management concepts are intentionally similar across the packages, but
 
 ## 🎉 Why Developers Choose This
 
-### The Bottom Line
+### At a glance
 
 | What You Get                        | What You Avoid                     |
 | ----------------------------------- | ---------------------------------- |

package/createGlobalState.d.ts

@@ -30,7 +30,7 @@ interface CreateGlobalState {
      * @param args.name optional name for debugging purposes
      * @param args.metadata optional non-reactive metadata associated with the state
      * @param args.callbacks optional lifecycle callbacks for the global state
-     * @param args.actions optional actions to restrict state mutations [if provided `setState` will be nullified]
+     * @param args.actions Optional actions returned as the hook’s second item; `setState` remains available on the store API
      * @param args.asyncStorage optional configuration to persist the state in local storage
      * @returns a state hook that you can use in your components
      *
@@ -87,7 +87,7 @@ interface CreateGlobalState {
      * @param args.name optional name for debugging purposes
      * @param args.metadata optional non-reactive metadata associated with the state
      * @param args.callbacks optional lifecycle callbacks for the global state
-     * @param args.actions optional actions to restrict state mutations [if provided `setState` will be nullified]
+     * @param args.actions Optional actions returned as the hook’s second item; `setState` remains available on the store API
      * @param args.asyncStorage optional configuration to persist the state in local storage
      * @returns a state hook that you can use in your components
      *

package/debug.cjs

@@ -0,0 +1 @@
+"use strict";var e=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var x=Object.getOwnPropertyNames;var a=Object.prototype.hasOwnProperty;var b=(p,o,i,t)=>{if(o&&typeof o=="object"||typeof o=="function")for(let r of x(o))!a.call(p,r)&&r!==i&&e(p,r,{get:()=>o[r],enumerable:!(t=m(o,r))||t.enumerable});return p};var c=p=>b(e({},"__esModule",{value:!0}),p);var d={};module.exports=c(d);var g=require("react-hooks-global-states/debug");

package/debug.d.ts

@@ -0,0 +1,2 @@
+import 'react-hooks-global-states/debug';
+export {};

package/debug.js

@@ -0,0 +1 @@
+"use strict";var e=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var x=Object.getOwnPropertyNames;var a=Object.prototype.hasOwnProperty;var b=(p,o,i,t)=>{if(o&&typeof o=="object"||typeof o=="function")for(let r of x(o))!a.call(p,r)&&r!==i&&e(p,r,{get:()=>o[r],enumerable:!(t=m(o,r))||t.enumerable});return p};var c=p=>b(e({},"__esModule",{value:!0}),p);var d={};module.exports=c(d);var g=require("react-hooks-global-states/debug");

package/debug.mjs

@@ -0,0 +1 @@
+import"react-hooks-global-states/debug";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "react-native-global-state-hooks",
-  "version": "16.0.4",
-  "description": "This is a package to easily handling global-state across your react-native-components No-redux... The library now includes @react-native-async-storage/async-storage to persist your state across sessions... if you want to keep using the old version without async-storage or react-native dependencies just use version 5.0.15 or user react-hooks-global-states instead",
+  "version": "16.0.5",
+  "description": "Shared React Native state with a useState-style API, selective subscriptions, actions and async persistence with optional AsyncStorage.",
   "main": "./bundle.cjs",
   "module": "./bundle.mjs",
   "types": "./index.d.ts",
@@ -62,6 +62,11 @@
       "import": "./actions.mjs",
       "require": "./actions.cjs"
     },
+    "./debug": {
+      "types": "./debug.d.ts",
+      "import": "./debug.mjs",
+      "require": "./debug.cjs"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -113,6 +118,9 @@
     }
   },
   "dependencies": {
-    "react-hooks-global-states": "^16.0.4"
+    "react-hooks-global-states": "^16.0.5"
+  },
+  "bin": {
+    "rgsh": "./rgsh.mjs"
   }
 }

package/rgsh.mjs

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import 'react-hooks-global-states/rgsh';