@react-protected/react 0.2.0-beta.2 → 0.3.0

package/CHANGELOG.md

@@ -0,0 +1,54 @@
+# @react-protected/react
+
+## 0.3.0
+
+### Minor Changes
+
+- cb262d3: loader, action and middleware support
+
+### Patch Changes
+
+- Updated dependencies [cb262d3]
+  - @react-protected/core@0.3.0
+
+## 0.2.0
+
+### Minor Changes
+
+- 05cda4d: Update roadmap and docs
+
+### Patch Changes
+
+- 4b835f6: Docs added
+- 11a6537: Configure Changesets-based release automation and public package publish metadata.
+- Updated dependencies [4b835f6]
+- Updated dependencies [11a6537]
+- Updated dependencies [05cda4d]
+  - @react-protected/core@0.2.0
+
+## 0.2.0-beta.2
+
+### Minor Changes
+
+- 05cda4d: Update roadmap and docs
+
+### Patch Changes
+
+- Updated dependencies [05cda4d]
+  - @react-protected/core@0.2.0-beta.2
+
+## 0.1.1-beta.1
+
+### Patch Changes
+
+- 4b835f6: Docs added
+- Updated dependencies [4b835f6]
+  - @react-protected/core@0.1.1-beta.1
+
+## 0.1.1-beta.0
+
+### Patch Changes
+
+- 11a6537: Configure Changesets-based release automation and public package publish metadata.
+- Updated dependencies [11a6537]
+  - @react-protected/core@0.1.1-beta.0

package/README.md

@@ -1,82 +1,33 @@
 # @react-protected/react
 
-React context, hooks, and `HasAccess` component for [react-protected](https://github.com/astakhovaskold/react-protected).
-
-> **Using React Router?** Install [`@react-protected/react-router`](https://www.npmjs.com/package/@react-protected/react-router) instead — it includes this package.
-
----
-
-## Installation
-
-```bash
-npm install @react-protected/core @react-protected/react
-```
-
-```bash
-yarn add @react-protected/core @react-protected/react
-```
-
-```bash
-pnpm add @react-protected/core @react-protected/react
-```
+React context, hooks, and `HasAccess` component for `react-protected`.
 
 ## Usage
 
-### AccessProvider
-
-Wrap your app with `AccessProvider` to provide the guard to the component tree:
-
 ```tsx
-import { AccessProvider } from '@react-protected/react'
+import { AccessProvider, HasAccess, useHasAccess } from '@react-protected/react'
 
 const App = () => (
   <AccessProvider
     getUser={() => authStore.user}
     hasRole={(user, roles) => roles.some((role) => user.roles.includes(role))}
-    loginPath="/login"
-    forbiddenPath="/403"
-    defaultPath="/dashboard"
   >
-    <Router />
+    <Toolbar />
   </AccessProvider>
 )
-```
-
-### HasAccess
-
-Conditionally render UI elements based on access:
-
-```tsx
-import { HasAccess } from '@react-protected/react'
-
-const Toolbar = () => (
-  <nav>
-    <HasAccess roles={['admin']}>
-      <button>Delete</button>
-    </HasAccess>
-  </nav>
-)
-```
-
-### useHasAccess
 
-Hook version of `HasAccess`:
-
-```tsx
-import { useHasAccess } from '@react-protected/react'
-
-const canDelete = useHasAccess({ roles: ['admin'] })
+const Toolbar = () => {
+  const canDelete = useHasAccess({ roles: ['admin'] })
+
+  return (
+    <nav>
+      <HasAccess roles={['admin']}>
+        <button>Delete</button>
+      </HasAccess>
+      {canDelete ? <button>Danger zone</button> : null}
+    </nav>
+  )
+}
 ```
 
-## Packages
-
-| Package | Description |
-| --- | --- |
-| `@react-protected/core` | Pure access-control logic — no React, no router |
-| `@react-protected/react` | This package — React context, hooks, and `HasAccess` |
-| `@react-protected/react-router` | Adapter for React Router |
-
-## Documentation
-
-- [Full documentation](https://github.com/astakhovaskold/react-protected/blob/main/docs/en/README.md)
-- [Examples](https://github.com/astakhovaskold/react-protected/blob/main/docs/en/examples/basic.md)
+`AccessProvider` only provides the guard. It does not store redirect paths or route policy.

package/dist/{AccessProvider-DTsMa_Df.mjs → AccessProvider-DIHb6g-h.mjs}

@@ -1,6 +1,6 @@
-import ee, { createContext as re, useMemo as F, useContext as te } from "react";
+import ee, { createContext as re, useMemo as $, useContext as te } from "react";
 import { createGuard as ne } from "@react-protected/core";
-var y = { exports: {} }, _ = {};
+var P = { exports: {} }, E = {};
 /**
  * @license React
  * react-jsx-runtime.production.js
@@ -10,29 +10,29 @@ var y = { exports: {} }, _ = {};
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-var D;
-function oe() {
-  if (D) return _;
-  D = 1;
-  var u = Symbol.for("react.transitional.element"), m = Symbol.for("react.fragment");
-  function c(l, a, s) {
-    var i = null;
-    if (s !== void 0 && (i = "" + s), a.key !== void 0 && (i = "" + a.key), "key" in a) {
+var I;
+function ae() {
+  if (I) return E;
+  I = 1;
+  var u = Symbol.for("react.transitional.element"), i = Symbol.for("react.fragment");
+  function l(c, o, s) {
+    var f = null;
+    if (s !== void 0 && (f = "" + s), o.key !== void 0 && (f = "" + o.key), "key" in o) {
       s = {};
-      for (var f in a)
-        f !== "key" && (s[f] = a[f]);
-    } else s = a;
-    return a = s.ref, {
+      for (var m in o)
+        m !== "key" && (s[m] = o[m]);
+    } else s = o;
+    return o = s.ref, {
       $$typeof: u,
-      type: l,
-      key: i,
-      ref: a !== void 0 ? a : null,
+      type: c,
+      key: f,
+      ref: o !== void 0 ? o : null,
       props: s
     };
   }
-  return _.Fragment = m, _.jsx = c, _.jsxs = c, _;
+  return E.Fragment = i, E.jsx = l, E.jsxs = l, E;
 }
-var v = {};
+var _ = {};
 /**
  * @license React
  * react-jsx-runtime.development.js
@@ -42,20 +42,20 @@ var v = {};
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-var M;
-function ae() {
-  return M || (M = 1, process.env.NODE_ENV !== "production" && function() {
+var F;
+function oe() {
+  return F || (F = 1, process.env.NODE_ENV !== "production" && function() {
     function u(e) {
       if (e == null) return null;
       if (typeof e == "function")
         return e.$$typeof === Z ? null : e.displayName || e.name || null;
       if (typeof e == "string") return e;
       switch (e) {
-        case A:
+        case R:
           return "Fragment";
-        case z:
-          return "Profiler";
         case V:
+          return "Profiler";
+        case U:
           return "StrictMode";
         case J:
           return "Suspense";
@@ -70,16 +70,16 @@ function ae() {
         ), e.$$typeof) {
           case W:
             return "Portal";
-          case U:
-            return e.displayName || "Context";
           case G:
+            return e.displayName || "Context";
+          case z:
             return (e._context.displayName || "Context") + ".Consumer";
           case q:
             var r = e.render;
             return e = e.displayName, e || (e = r.displayName || r.name || "", e = e !== "" ? "ForwardRef(" + e + ")" : "ForwardRef"), e;
           case B:
             return r = e.displayName || null, r !== null ? r : u(e.type) || "Memo";
-          case O:
+          case p:
             r = e._payload, e = e._init;
             try {
               return u(e(r));
@@ -88,12 +88,12 @@ function ae() {
         }
       return null;
     }
-    function m(e) {
+    function i(e) {
       return "" + e;
     }
-    function c(e) {
+    function l(e) {
       try {
-        m(e);
+        i(e);
         var r = !1;
       } catch {
         r = !0;
@@ -105,12 +105,12 @@ function ae() {
           r,
           "The provided key is an unsupported type %s. This value must be coerced to a string before using it here.",
           n
-        ), m(e);
+        ), i(e);
       }
     }
-    function l(e) {
-      if (e === A) return "<>";
-      if (typeof e == "object" && e !== null && e.$$typeof === O)
+    function c(e) {
+      if (e === R) return "<>";
+      if (typeof e == "object" && e !== null && e.$$typeof === p)
         return "<...>";
       try {
         var r = u(e);
@@ -119,23 +119,23 @@ function ae() {
         return "<...>";
       }
     }
-    function a() {
-      var e = w.A;
+    function o() {
+      var e = T.A;
       return e === null ? null : e.getOwner();
     }
     function s() {
       return Error("react-stack-top-frame");
     }
-    function i(e) {
-      if (N.call(e, "key")) {
+    function f(e) {
+      if (y.call(e, "key")) {
         var r = Object.getOwnPropertyDescriptor(e, "key").get;
         if (r && r.isReactWarning) return !1;
       }
       return e.key !== void 0;
     }
-    function f(e, r) {
+    function m(e, r) {
       function t() {
-        h || (h = !0, console.error(
+        g || (g = !0, console.error(
           "%s: `key` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. (https://react.dev/link/special-props)",
           r
         ));
@@ -145,23 +145,23 @@ function ae() {
         configurable: !0
       });
     }
-    function R() {
+    function M() {
       var e = u(this.type);
-      return C[e] || (C[e] = !0, console.error(
+      return h[e] || (h[e] = !0, console.error(
         "Accessing element.ref was removed in React 19. ref is now a regular prop. It will be removed from the JSX Element type in a future release."
       )), e = this.props.ref, e !== void 0 ? e : null;
     }
-    function b(e, r, t, n, k, x) {
-      var o = t.ref;
+    function L(e, r, t, n, b, A) {
+      var a = t.ref;
       return e = {
-        $$typeof: g,
+        $$typeof: j,
         type: e,
         key: r,
         props: t,
         _owner: n
-      }, (o !== void 0 ? o : null) !== null ? Object.defineProperty(e, "ref", {
+      }, (a !== void 0 ? a : null) !== null ? Object.defineProperty(e, "ref", {
         enumerable: !1,
-        get: R
+        get: M
       }) : Object.defineProperty(e, "ref", { enumerable: !1, value: null }), e._store = {}, Object.defineProperty(e._store, "validated", {
         configurable: !1,
         enumerable: !1,
@@ -176,33 +176,33 @@ function ae() {
         configurable: !1,
         enumerable: !1,
         writable: !0,
-        value: k
+        value: b
       }), Object.defineProperty(e, "_debugTask", {
         configurable: !1,
         enumerable: !1,
         writable: !0,
-        value: x
+        value: A
       }), Object.freeze && (Object.freeze(e.props), Object.freeze(e)), e;
     }
-    function E(e, r, t, n, k, x) {
-      var o = r.children;
-      if (o !== void 0)
+    function w(e, r, t, n, b, A) {
+      var a = r.children;
+      if (a !== void 0)
         if (n)
-          if (Q(o)) {
-            for (n = 0; n < o.length; n++)
-              p(o[n]);
-            Object.freeze && Object.freeze(o);
+          if (Q(a)) {
+            for (n = 0; n < a.length; n++)
+              S(a[n]);
+            Object.freeze && Object.freeze(a);
           } else
             console.error(
               "React.jsx: Static children should always be an array. You are likely explicitly calling React.jsxs or React.jsxDEV. Use the Babel transform instead."
             );
-        else p(o);
-      if (N.call(r, "key")) {
-        o = u(e);
+        else S(a);
+      if (y.call(r, "key")) {
+        a = u(e);
         var d = Object.keys(r).filter(function(K) {
           return K !== "key";
         });
-        n = 0 < d.length ? "{key: someKey, " + d.join(": ..., ") + ": ...}" : "{key: someKey}", I[o + n] || (d = 0 < d.length ? "{" + d.join(": ..., ") + ": ...}" : "{}", console.error(
+        n = 0 < d.length ? "{key: someKey, " + d.join(": ..., ") + ": ...}" : "{key: someKey}", Y[a + n] || (d = 0 < d.length ? "{" + d.join(": ..., ") + ": ...}" : "{}", console.error(
           `A props object containing a "key" prop is being spread into JSX:
   let props = %s;
   <%s {...props} />
@@ -210,108 +210,98 @@ React keys must be passed directly to JSX without using spread:
   let props = %s;
   <%s key={someKey} {...props} />`,
           n,
-          o,
+          a,
           d,
-          o
-        ), I[o + n] = !0);
+          a
+        ), Y[a + n] = !0);
       }
-      if (o = null, t !== void 0 && (c(t), o = "" + t), i(r) && (c(r.key), o = "" + r.key), "key" in r) {
+      if (a = null, t !== void 0 && (l(t), a = "" + t), f(r) && (l(r.key), a = "" + r.key), "key" in r) {
         t = {};
-        for (var j in r)
-          j !== "key" && (t[j] = r[j]);
+        for (var O in r)
+          O !== "key" && (t[O] = r[O]);
       } else t = r;
-      return o && f(
+      return a && m(
         t,
         typeof e == "function" ? e.displayName || e.name || "Unknown" : e
-      ), b(
+      ), L(
         e,
-        o,
+        a,
         t,
-        a(),
-        k,
-        x
+        o(),
+        b,
+        A
       );
     }
-    function p(e) {
-      P(e) ? e._store && (e._store.validated = 1) : typeof e == "object" && e !== null && e.$$typeof === O && (e._payload.status === "fulfilled" ? P(e._payload.value) && e._payload.value._store && (e._payload.value._store.validated = 1) : e._store && (e._store.validated = 1));
+    function S(e) {
+      x(e) ? e._store && (e._store.validated = 1) : typeof e == "object" && e !== null && e.$$typeof === p && (e._payload.status === "fulfilled" ? x(e._payload.value) && e._payload.value._store && (e._payload.value._store.validated = 1) : e._store && (e._store.validated = 1));
     }
-    function P(e) {
-      return typeof e == "object" && e !== null && e.$$typeof === g;
+    function x(e) {
+      return typeof e == "object" && e !== null && e.$$typeof === j;
     }
-    var T = ee, g = Symbol.for("react.transitional.element"), W = Symbol.for("react.portal"), A = Symbol.for("react.fragment"), V = Symbol.for("react.strict_mode"), z = Symbol.for("react.profiler"), G = Symbol.for("react.consumer"), U = Symbol.for("react.context"), q = Symbol.for("react.forward_ref"), J = Symbol.for("react.suspense"), X = Symbol.for("react.suspense_list"), B = Symbol.for("react.memo"), O = Symbol.for("react.lazy"), H = Symbol.for("react.activity"), Z = Symbol.for("react.client.reference"), w = T.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE, N = Object.prototype.hasOwnProperty, Q = Array.isArray, S = console.createTask ? console.createTask : function() {
+    var v = ee, j = Symbol.for("react.transitional.element"), W = Symbol.for("react.portal"), R = Symbol.for("react.fragment"), U = Symbol.for("react.strict_mode"), V = Symbol.for("react.profiler"), z = Symbol.for("react.consumer"), G = Symbol.for("react.context"), q = Symbol.for("react.forward_ref"), J = Symbol.for("react.suspense"), X = Symbol.for("react.suspense_list"), B = Symbol.for("react.memo"), p = Symbol.for("react.lazy"), H = Symbol.for("react.activity"), Z = Symbol.for("react.client.reference"), T = v.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE, y = Object.prototype.hasOwnProperty, Q = Array.isArray, k = console.createTask ? console.createTask : function() {
       return null;
     };
-    T = {
+    v = {
       react_stack_bottom_frame: function(e) {
         return e();
       }
     };
-    var h, C = {}, Y = T.react_stack_bottom_frame.bind(
-      T,
+    var g, h = {}, N = v.react_stack_bottom_frame.bind(
+      v,
       s
-    )(), $ = S(l(s)), I = {};
-    v.Fragment = A, v.jsx = function(e, r, t) {
-      var n = 1e4 > w.recentlyCreatedOwnerStacks++;
-      return E(
+    )(), C = k(c(s)), Y = {};
+    _.Fragment = R, _.jsx = function(e, r, t) {
+      var n = 1e4 > T.recentlyCreatedOwnerStacks++;
+      return w(
         e,
         r,
         t,
         !1,
-        n ? Error("react-stack-top-frame") : Y,
-        n ? S(l(e)) : $
+        n ? Error("react-stack-top-frame") : N,
+        n ? k(c(e)) : C
       );
-    }, v.jsxs = function(e, r, t) {
-      var n = 1e4 > w.recentlyCreatedOwnerStacks++;
-      return E(
+    }, _.jsxs = function(e, r, t) {
+      var n = 1e4 > T.recentlyCreatedOwnerStacks++;
+      return w(
         e,
         r,
         t,
         !0,
-        n ? Error("react-stack-top-frame") : Y,
-        n ? S(l(e)) : $
+        n ? Error("react-stack-top-frame") : N,
+        n ? k(c(e)) : C
       );
     };
-  }()), v;
+  }()), _;
 }
-process.env.NODE_ENV === "production" ? y.exports = oe() : y.exports = ae();
-var se = y.exports;
-const L = re(null);
-function le({
+process.env.NODE_ENV === "production" ? P.exports = ae() : P.exports = oe();
+var se = P.exports;
+const D = re(null);
+function ce({
   children: u,
-  loginPath: m = "/login",
-  forbiddenPath: c = "/403",
-  defaultPath: l = "/",
-  callbackUrlParam: a,
-  shouldAddCallbackUrl: s,
   getUser: i,
-  isAuthenticated: f,
-  hasRole: R,
-  hasPermission: b
+  isAuthenticated: l,
+  hasRole: c,
+  hasPermission: o
 }) {
-  const E = F(
-    () => ne({ getUser: i, isAuthenticated: f, hasRole: R, hasPermission: b }),
-    [i, f, R, b]
-  ), p = F(
+  const s = $(
+    () => ne({ getUser: i, isAuthenticated: l, hasRole: c, hasPermission: o }),
+    [i, l, c, o]
+  ), f = $(
     () => ({
-      guard: E,
-      loginPath: m,
-      forbiddenPath: c,
-      defaultPath: l,
-      callbackUrlParam: a,
-      shouldAddCallbackUrl: s
+      guard: s
     }),
-    [E, m, c, l, a, s]
+    [s]
   );
-  return /* @__PURE__ */ se.jsx(L.Provider, { value: p, children: u });
+  return /* @__PURE__ */ se.jsx(D.Provider, { value: f, children: u });
 }
 function ie() {
-  const u = te(L);
+  const u = te(D);
   if (!u)
     throw new Error("useAccess must be used within <AccessProvider>");
   return u;
 }
 export {
-  le as A,
+  ce as A,
   se as j,
   ie as u
 };

package/dist/AccessProvider-PIwX6Nec.js

@@ -0,0 +1,22 @@
+"use strict";const v=require("react"),re=require("@react-protected/core");var w={exports:{}},E={};/**
+ * @license React
+ * react-jsx-runtime.production.js
+ *
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */var I;function te(){if(I)return E;I=1;var u=Symbol.for("react.transitional.element"),i=Symbol.for("react.fragment");function c(l,a,s){var f=null;if(s!==void 0&&(f=""+s),a.key!==void 0&&(f=""+a.key),"key"in a){s={};for(var m in a)m!=="key"&&(s[m]=a[m])}else s=a;return a=s.ref,{$$typeof:u,type:l,key:f,ref:a!==void 0?a:null,props:s}}return E.Fragment=i,E.jsx=c,E.jsxs=c,E}var _={};/**
+ * @license React
+ * react-jsx-runtime.development.js
+ *
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */var F;function ne(){return F||(F=1,process.env.NODE_ENV!=="production"&&function(){function u(e){if(e==null)return null;if(typeof e=="function")return e.$$typeof===Q?null:e.displayName||e.name||null;if(typeof e=="string")return e;switch(e){case p:return"Fragment";case V:return"Profiler";case q:return"StrictMode";case X:return"Suspense";case B:return"SuspenseList";case Z:return"Activity"}if(typeof e=="object")switch(typeof e.tag=="number"&&console.error("Received an unexpected object in getComponentNameFromType(). This is likely a bug in React. Please file an issue."),e.$$typeof){case U:return"Portal";case G:return e.displayName||"Context";case z:return(e._context.displayName||"Context")+".Consumer";case J:var r=e.render;return e=e.displayName,e||(e=r.displayName||r.name||"",e=e!==""?"ForwardRef("+e+")":"ForwardRef"),e;case H:return r=e.displayName||null,r!==null?r:u(e.type)||"Memo";case T:r=e._payload,e=e._init;try{return u(e(r))}catch{}}return null}function i(e){return""+e}function c(e){try{i(e);var r=!1}catch{r=!0}if(r){r=console;var t=r.error,n=typeof Symbol=="function"&&Symbol.toStringTag&&e[Symbol.toStringTag]||e.constructor.name||"Object";return t.call(r,"The provided key is an unsupported type %s. This value must be coerced to a string before using it here.",n),i(e)}}function l(e){if(e===p)return"<>";if(typeof e=="object"&&e!==null&&e.$$typeof===T)return"<...>";try{var r=u(e);return r?"<"+r+">":"<...>"}catch{return"<...>"}}function a(){var e=k.A;return e===null?null:e.getOwner()}function s(){return Error("react-stack-top-frame")}function f(e){if(g.call(e,"key")){var r=Object.getOwnPropertyDescriptor(e,"key").get;if(r&&r.isReactWarning)return!1}return e.key!==void 0}function m(e,r){function t(){h||(h=!0,console.error("%s: `key` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. (https://react.dev/link/special-props)",r))}t.isReactWarning=!0,Object.defineProperty(e,"key",{get:t,configurable:!0})}function L(){var e=u(this.type);return N[e]||(N[e]=!0,console.error("Accessing element.ref was removed in React 19. ref is now a regular prop. It will be removed from the JSX Element type in a future release.")),e=this.props.ref,e!==void 0?e:null}function W(e,r,t,n,R,O){var o=t.ref;return e={$$typeof:y,type:e,key:r,props:t,_owner:n},(o!==void 0?o:null)!==null?Object.defineProperty(e,"ref",{enumerable:!1,get:L}):Object.defineProperty(e,"ref",{enumerable:!1,value:null}),e._store={},Object.defineProperty(e._store,"validated",{configurable:!1,enumerable:!1,writable:!0,value:0}),Object.defineProperty(e,"_debugInfo",{configurable:!1,enumerable:!1,writable:!0,value:null}),Object.defineProperty(e,"_debugStack",{configurable:!1,enumerable:!1,writable:!0,value:R}),Object.defineProperty(e,"_debugTask",{configurable:!1,enumerable:!1,writable:!0,value:O}),Object.freeze&&(Object.freeze(e.props),Object.freeze(e)),e}function S(e,r,t,n,R,O){var o=r.children;if(o!==void 0)if(n)if(K(o)){for(n=0;n<o.length;n++)x(o[n]);Object.freeze&&Object.freeze(o)}else console.error("React.jsx: Static children should always be an array. You are likely explicitly calling React.jsxs or React.jsxDEV. Use the Babel transform instead.");else x(o);if(g.call(r,"key")){o=u(e);var d=Object.keys(r).filter(function(ee){return ee!=="key"});n=0<d.length?"{key: someKey, "+d.join(": ..., ")+": ...}":"{key: someKey}",$[o+n]||(d=0<d.length?"{"+d.join(": ..., ")+": ...}":"{}",console.error(`A props object containing a "key" prop is being spread into JSX:
+  let props = %s;
+  <%s {...props} />
+React keys must be passed directly to JSX without using spread:
+  let props = %s;
+  <%s key={someKey} {...props} />`,n,o,d,o),$[o+n]=!0)}if(o=null,t!==void 0&&(c(t),o=""+t),f(r)&&(c(r.key),o=""+r.key),"key"in r){t={};for(var P in r)P!=="key"&&(t[P]=r[P])}else t=r;return o&&m(t,typeof e=="function"?e.displayName||e.name||"Unknown":e),W(e,o,t,a(),R,O)}function x(e){j(e)?e._store&&(e._store.validated=1):typeof e=="object"&&e!==null&&e.$$typeof===T&&(e._payload.status==="fulfilled"?j(e._payload.value)&&e._payload.value._store&&(e._payload.value._store.validated=1):e._store&&(e._store.validated=1))}function j(e){return typeof e=="object"&&e!==null&&e.$$typeof===y}var b=v,y=Symbol.for("react.transitional.element"),U=Symbol.for("react.portal"),p=Symbol.for("react.fragment"),q=Symbol.for("react.strict_mode"),V=Symbol.for("react.profiler"),z=Symbol.for("react.consumer"),G=Symbol.for("react.context"),J=Symbol.for("react.forward_ref"),X=Symbol.for("react.suspense"),B=Symbol.for("react.suspense_list"),H=Symbol.for("react.memo"),T=Symbol.for("react.lazy"),Z=Symbol.for("react.activity"),Q=Symbol.for("react.client.reference"),k=b.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE,g=Object.prototype.hasOwnProperty,K=Array.isArray,A=console.createTask?console.createTask:function(){return null};b={react_stack_bottom_frame:function(e){return e()}};var h,N={},C=b.react_stack_bottom_frame.bind(b,s)(),Y=A(l(s)),$={};_.Fragment=p,_.jsx=function(e,r,t){var n=1e4>k.recentlyCreatedOwnerStacks++;return S(e,r,t,!1,n?Error("react-stack-top-frame"):C,n?A(l(e)):Y)},_.jsxs=function(e,r,t){var n=1e4>k.recentlyCreatedOwnerStacks++;return S(e,r,t,!0,n?Error("react-stack-top-frame"):C,n?A(l(e)):Y)}}()),_}process.env.NODE_ENV==="production"?w.exports=te():w.exports=ne();var D=w.exports;const M=v.createContext(null);function oe({children:u,getUser:i,isAuthenticated:c,hasRole:l,hasPermission:a}){const s=v.useMemo(()=>re.createGuard({getUser:i,isAuthenticated:c,hasRole:l,hasPermission:a}),[i,c,l,a]),f=v.useMemo(()=>({guard:s}),[s]);return D.jsx(M.Provider,{value:f,children:u})}function ae(){const u=v.useContext(M);if(!u)throw new Error("useAccess must be used within <AccessProvider>");return u}exports.AccessProvider=oe;exports.jsxRuntimeExports=D;exports.useAccess=ae;

package/dist/AccessProvider.d.ts

@@ -1,3 +1,17 @@
 import { AccessContextValue, AccessProviderProps } from './types';
-export declare function AccessProvider<TUser = unknown>({ children, loginPath, forbiddenPath, defaultPath, callbackUrlParam, shouldAddCallbackUrl, getUser, isAuthenticated, hasRole, hasPermission, }: AccessProviderProps<TUser>): import("react/jsx-runtime").JSX.Element;
+/**
+ * Provides access control configuration to the React subtree.
+ *
+ * @typeParam TUser - User shape returned by `getUser`.
+ * @param props - Guard callbacks, navigation settings, and descendant elements.
+ * @returns A context provider that enables access-aware hooks and components.
+ */
+export declare function AccessProvider<TUser = unknown>({ children, getUser, isAuthenticated, hasRole, hasPermission, }: AccessProviderProps<TUser>): import("react/jsx-runtime").JSX.Element;
+/**
+ * Returns the active access context from `AccessProvider`.
+ *
+ * @typeParam TUser - User shape stored in the access context.
+ * @returns The guard instance for the current subtree.
+ * @throws {Error} When called outside an `AccessProvider`.
+ */
 export declare function useAccess<TUser = unknown>(): AccessContextValue<TUser>;

package/dist/HasAccess.d.ts

@@ -3,6 +3,18 @@ import { RouteProtection } from './types';
 type HasAccessProps = RouteProtection & {
     children?: ReactNode;
 };
+/**
+ * Returns `true` when the current user satisfies the provided access config.
+ *
+ * @param config - Access requirements to evaluate with the active guard.
+ * @returns `true` when access is allowed, otherwise `false`.
+ */
 export declare function useHasAccess(config: RouteProtection): boolean;
+/**
+ * Renders its children only when the current user satisfies the access config.
+ *
+ * @param props - Access requirements and the children to render when allowed.
+ * @returns The provided children when access is allowed, otherwise `null`.
+ */
 export declare function HasAccess({ access, roles, permissions, meta, children }: HasAccessProps): string | number | boolean | import('react').ReactElement<any, string | import('react').JSXElementConstructor<any>> | Iterable<ReactNode> | null;
 export {};

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("./AccessProvider-sHL1A3i9.js");function r(s){const{guard:e}=c.useAccess();return e.check(s).allowed}function n({access:s,roles:e,permissions:u,meta:o,children:l}){return r({access:s,roles:e,permissions:u,meta:o})?l??null:null}exports.AccessProvider=c.AccessProvider;exports.useAccess=c.useAccess;exports.HasAccess=n;exports.useHasAccess=r;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("./AccessProvider-PIwX6Nec.js");function r(s){const{guard:e}=c.useAccess();return e.check(s).allowed}function n({access:s,roles:e,permissions:u,meta:o,children:l}){return r({access:s,roles:e,permissions:u,meta:o})?l??null:null}exports.AccessProvider=c.AccessProvider;exports.useAccess=c.useAccess;exports.HasAccess=n;exports.useHasAccess=r;

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export { AccessProvider, useAccess } from './AccessProvider';
 export { HasAccess, useHasAccess } from './HasAccess';
-export type { AccessContextValue, AccessProviderProps, AccessRouteProps, NavigationConfig, RouteProtection, } from './types';
+export type { AccessContextValue, AccessProviderProps, AccessRouteProps, RouteProtection, } from './types';

package/dist/index.js

@@ -1,5 +1,5 @@
-import { u as l } from "./AccessProvider-DTsMa_Df.mjs";
-import { A as f } from "./AccessProvider-DTsMa_Df.mjs";
+import { u as l } from "./AccessProvider-DIHb6g-h.mjs";
+import { A as f } from "./AccessProvider-DIHb6g-h.mjs";
 function n(s) {
   const { guard: e } = l();
   return e.check(s).allowed;

package/dist/testing.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./AccessProvider-sHL1A3i9.js");function a({user:s=null,allowed:e=!0,children:t,getUser:c,isAuthenticated:i,hasRole:o,hasPermission:n,loginPath:u,forbiddenPath:P,defaultPath:d,callbackUrlParam:v,shouldAddCallbackUrl:A}){return r.jsxRuntimeExports.jsx(r.AccessProvider,{getUser:c??(()=>s),isAuthenticated:i??(()=>e),hasRole:o??(()=>e),hasPermission:n??(()=>e),loginPath:u,forbiddenPath:P,defaultPath:d,callbackUrlParam:v,shouldAddCallbackUrl:A,children:t})}exports.MockAccessProvider=a;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./AccessProvider-PIwX6Nec.js");function u({user:s=null,allowed:e=!0,children:t,getUser:c,isAuthenticated:i,hasRole:o,hasPermission:n}){return r.jsxRuntimeExports.jsx(r.AccessProvider,{getUser:c??(()=>s),isAuthenticated:i??(()=>e),hasRole:o??(()=>e),hasPermission:n??(()=>e),children:t})}exports.MockAccessProvider=u;

package/dist/testing.d.ts

@@ -1,9 +1,30 @@
 import { GuardOptions } from '@react-protected/core';
 import { ReactNode } from 'react';
-import { NavigationConfig } from './types';
-export type MockAccessProviderProps<TUser = unknown> = Partial<GuardOptions<TUser>> & NavigationConfig & {
+/**
+ * Props accepted by `MockAccessProvider`.
+ */
+export type MockAccessProviderProps<TUser = unknown> = Partial<GuardOptions<TUser>> & {
+    /**
+     * User returned by the default `getUser` implementation.
+     */
     user?: TUser | null;
+    /**
+     * Default outcome used by generated access callbacks when explicit callbacks are not provided.
+     */
     allowed?: boolean;
+    /**
+     * React subtree that consumes the mocked access context.
+     */
     children?: ReactNode;
 };
-export declare function MockAccessProvider<TUser = unknown>({ user, allowed, children, getUser, isAuthenticated, hasRole, hasPermission, loginPath, forbiddenPath, defaultPath, callbackUrlParam, shouldAddCallbackUrl, }: MockAccessProviderProps<TUser>): import("react/jsx-runtime").JSX.Element;
+/**
+ * Test helper that provides a predictable access context.
+ *
+ * @typeParam TUser - User shape returned by the mocked `getUser`.
+ * @param props - Mocked user, optional callback overrides, navigation settings, and children.
+ * @param props - Mocked user, optional callback overrides, and children.
+ * @returns An `AccessProvider` configured for deterministic tests.
+ * @remarks When explicit callbacks are omitted, authentication, role, and permission checks all
+ * resolve to the `allowed` flag.
+ */
+export declare function MockAccessProvider<TUser = unknown>({ user, allowed, children, getUser, isAuthenticated, hasRole, hasPermission, }: MockAccessProviderProps<TUser>): import("react/jsx-runtime").JSX.Element;

package/dist/testing.js

@@ -1,34 +1,24 @@
-import { j as a, A as h } from "./AccessProvider-DTsMa_Df.mjs";
-function p({
+import { j as n, A as u } from "./AccessProvider-DIHb6g-h.mjs";
+function x({
   user: r = null,
   allowed: s = !0,
   children: e,
   getUser: t,
   isAuthenticated: i,
   hasRole: o,
-  hasPermission: c,
-  loginPath: n,
-  forbiddenPath: u,
-  defaultPath: m,
-  callbackUrlParam: x,
-  shouldAddCallbackUrl: A
+  hasPermission: c
 }) {
-  return /* @__PURE__ */ a.jsx(
-    h,
+  return /* @__PURE__ */ n.jsx(
+    u,
     {
       getUser: t ?? (() => r),
       isAuthenticated: i ?? (() => s),
       hasRole: o ?? (() => s),
       hasPermission: c ?? (() => s),
-      loginPath: n,
-      forbiddenPath: u,
-      defaultPath: m,
-      callbackUrlParam: x,
-      shouldAddCallbackUrl: A,
       children: e
     }
   );
 }
 export {
-  p as MockAccessProvider
+  x as MockAccessProvider
 };

package/dist/types.d.ts

@@ -1,24 +1,33 @@
-import { AccessConfig, Guard, GuardOptions } from '@react-protected/core';
+import { AccessConfig as CoreAccessConfig, Guard, GuardOptions } from '@react-protected/core';
 import { ReactNode } from 'react';
-export type { AccessConfig as RouteProtection } from '@react-protected/core';
-export type NavigationConfig = {
-    loginPath?: string;
-    forbiddenPath?: string;
-    defaultPath?: string;
-    callbackUrlParam?: string;
-    shouldAddCallbackUrl?: () => boolean;
-};
+/**
+ * Access requirements consumed by React hooks and components in this package.
+ */
+export type RouteProtection = CoreAccessConfig;
+/**
+ * Access context exposed by `useAccess()`.
+ */
 export type AccessContextValue<TUser = unknown> = {
+    /**
+     * Guard instance used to evaluate access rules.
+     */
     guard: Guard<TUser>;
-    loginPath: string;
-    forbiddenPath: string;
-    defaultPath: string;
-    callbackUrlParam?: string;
-    shouldAddCallbackUrl?: () => boolean;
 };
-export type AccessProviderProps<TUser = unknown> = GuardOptions<TUser> & NavigationConfig & {
+/**
+ * Props accepted by `AccessProvider`.
+ */
+export type AccessProviderProps<TUser = unknown> = GuardOptions<TUser> & {
+    /**
+     * React subtree that consumes the access context.
+     */
     children?: ReactNode;
 };
-export type AccessRouteProps = AccessConfig & {
+/**
+ * Access requirements accepted by `useHasAccess()` and `HasAccess`.
+ */
+export type AccessRouteProps = RouteProtection & {
+    /**
+     * React subtree rendered when the access check passes.
+     */
     children?: ReactNode;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-protected/react",
-  "version": "0.2.0-beta.2",
+  "version": "0.3.0",
   "license": "MIT",
   "description": "React context and hooks for react-protected",
   "main": "./dist/index.cjs",
@@ -27,10 +27,11 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "CHANGELOG.md"
   ],
   "dependencies": {
-    "@react-protected/core": "0.2.0-beta.2"
+    "@react-protected/core": "0.3.0"
   },
   "peerDependencies": {
     "react": ">=18.0.0",

package/dist/AccessProvider-sHL1A3i9.js

@@ -1,22 +0,0 @@
-"use strict";const R=require("react"),re=require("@react-protected/core");var y={exports:{}},_={};/**
- * @license React
- * react-jsx-runtime.production.js
- *
- * Copyright (c) Meta Platforms, Inc. and affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */var D;function te(){if(D)return _;D=1;var u=Symbol.for("react.transitional.element"),d=Symbol.for("react.fragment");function c(l,a,s){var i=null;if(s!==void 0&&(i=""+s),a.key!==void 0&&(i=""+a.key),"key"in a){s={};for(var f in a)f!=="key"&&(s[f]=a[f])}else s=a;return a=s.ref,{$$typeof:u,type:l,key:i,ref:a!==void 0?a:null,props:s}}return _.Fragment=d,_.jsx=c,_.jsxs=c,_}var v={};/**
- * @license React
- * react-jsx-runtime.development.js
- *
- * Copyright (c) Meta Platforms, Inc. and affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */var M;function ne(){return M||(M=1,process.env.NODE_ENV!=="production"&&function(){function u(e){if(e==null)return null;if(typeof e=="function")return e.$$typeof===Q?null:e.displayName||e.name||null;if(typeof e=="string")return e;switch(e){case O:return"Fragment";case z:return"Profiler";case V:return"StrictMode";case X:return"Suspense";case B:return"SuspenseList";case Z:return"Activity"}if(typeof e=="object")switch(typeof e.tag=="number"&&console.error("Received an unexpected object in getComponentNameFromType(). This is likely a bug in React. Please file an issue."),e.$$typeof){case q:return"Portal";case U:return e.displayName||"Context";case G:return(e._context.displayName||"Context")+".Consumer";case J:var r=e.render;return e=e.displayName,e||(e=r.displayName||r.name||"",e=e!==""?"ForwardRef("+e+")":"ForwardRef"),e;case H:return r=e.displayName||null,r!==null?r:u(e.type)||"Memo";case w:r=e._payload,e=e._init;try{return u(e(r))}catch{}}return null}function d(e){return""+e}function c(e){try{d(e);var r=!1}catch{r=!0}if(r){r=console;var t=r.error,n=typeof Symbol=="function"&&Symbol.toStringTag&&e[Symbol.toStringTag]||e.constructor.name||"Object";return t.call(r,"The provided key is an unsupported type %s. This value must be coerced to a string before using it here.",n),d(e)}}function l(e){if(e===O)return"<>";if(typeof e=="object"&&e!==null&&e.$$typeof===w)return"<...>";try{var r=u(e);return r?"<"+r+">":"<...>"}catch{return"<...>"}}function a(){var e=S.A;return e===null?null:e.getOwner()}function s(){return Error("react-stack-top-frame")}function i(e){if(h.call(e,"key")){var r=Object.getOwnPropertyDescriptor(e,"key").get;if(r&&r.isReactWarning)return!1}return e.key!==void 0}function f(e,r){function t(){C||(C=!0,console.error("%s: `key` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. (https://react.dev/link/special-props)",r))}t.isReactWarning=!0,Object.defineProperty(e,"key",{get:t,configurable:!0})}function b(){var e=u(this.type);return Y[e]||(Y[e]=!0,console.error("Accessing element.ref was removed in React 19. ref is now a regular prop. It will be removed from the JSX Element type in a future release.")),e=this.props.ref,e!==void 0?e:null}function p(e,r,t,n,k,P){var o=t.ref;return e={$$typeof:N,type:e,key:r,props:t,_owner:n},(o!==void 0?o:null)!==null?Object.defineProperty(e,"ref",{enumerable:!1,get:b}):Object.defineProperty(e,"ref",{enumerable:!1,value:null}),e._store={},Object.defineProperty(e._store,"validated",{configurable:!1,enumerable:!1,writable:!0,value:0}),Object.defineProperty(e,"_debugInfo",{configurable:!1,enumerable:!1,writable:!0,value:null}),Object.defineProperty(e,"_debugStack",{configurable:!1,enumerable:!1,writable:!0,value:k}),Object.defineProperty(e,"_debugTask",{configurable:!1,enumerable:!1,writable:!0,value:P}),Object.freeze&&(Object.freeze(e.props),Object.freeze(e)),e}function E(e,r,t,n,k,P){var o=r.children;if(o!==void 0)if(n)if(K(o)){for(n=0;n<o.length;n++)T(o[n]);Object.freeze&&Object.freeze(o)}else console.error("React.jsx: Static children should always be an array. You are likely explicitly calling React.jsxs or React.jsxDEV. Use the Babel transform instead.");else T(o);if(h.call(r,"key")){o=u(e);var m=Object.keys(r).filter(function(ee){return ee!=="key"});n=0<m.length?"{key: someKey, "+m.join(": ..., ")+": ...}":"{key: someKey}",F[o+n]||(m=0<m.length?"{"+m.join(": ..., ")+": ...}":"{}",console.error(`A props object containing a "key" prop is being spread into JSX:
-  let props = %s;
-  <%s {...props} />
-React keys must be passed directly to JSX without using spread:
-  let props = %s;
-  <%s key={someKey} {...props} />`,n,o,m,o),F[o+n]=!0)}if(o=null,t!==void 0&&(c(t),o=""+t),i(r)&&(c(r.key),o=""+r.key),"key"in r){t={};for(var j in r)j!=="key"&&(t[j]=r[j])}else t=r;return o&&f(t,typeof e=="function"?e.displayName||e.name||"Unknown":e),p(e,o,t,a(),k,P)}function T(e){g(e)?e._store&&(e._store.validated=1):typeof e=="object"&&e!==null&&e.$$typeof===w&&(e._payload.status==="fulfilled"?g(e._payload.value)&&e._payload.value._store&&(e._payload.value._store.validated=1):e._store&&(e._store.validated=1))}function g(e){return typeof e=="object"&&e!==null&&e.$$typeof===N}var A=R,N=Symbol.for("react.transitional.element"),q=Symbol.for("react.portal"),O=Symbol.for("react.fragment"),V=Symbol.for("react.strict_mode"),z=Symbol.for("react.profiler"),G=Symbol.for("react.consumer"),U=Symbol.for("react.context"),J=Symbol.for("react.forward_ref"),X=Symbol.for("react.suspense"),B=Symbol.for("react.suspense_list"),H=Symbol.for("react.memo"),w=Symbol.for("react.lazy"),Z=Symbol.for("react.activity"),Q=Symbol.for("react.client.reference"),S=A.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE,h=Object.prototype.hasOwnProperty,K=Array.isArray,x=console.createTask?console.createTask:function(){return null};A={react_stack_bottom_frame:function(e){return e()}};var C,Y={},$=A.react_stack_bottom_frame.bind(A,s)(),I=x(l(s)),F={};v.Fragment=O,v.jsx=function(e,r,t){var n=1e4>S.recentlyCreatedOwnerStacks++;return E(e,r,t,!1,n?Error("react-stack-top-frame"):$,n?x(l(e)):I)},v.jsxs=function(e,r,t){var n=1e4>S.recentlyCreatedOwnerStacks++;return E(e,r,t,!0,n?Error("react-stack-top-frame"):$,n?x(l(e)):I)}}()),v}process.env.NODE_ENV==="production"?y.exports=te():y.exports=ne();var L=y.exports;const W=R.createContext(null);function oe({children:u,loginPath:d="/login",forbiddenPath:c="/403",defaultPath:l="/",callbackUrlParam:a,shouldAddCallbackUrl:s,getUser:i,isAuthenticated:f,hasRole:b,hasPermission:p}){const E=R.useMemo(()=>re.createGuard({getUser:i,isAuthenticated:f,hasRole:b,hasPermission:p}),[i,f,b,p]),T=R.useMemo(()=>({guard:E,loginPath:d,forbiddenPath:c,defaultPath:l,callbackUrlParam:a,shouldAddCallbackUrl:s}),[E,d,c,l,a,s]);return L.jsx(W.Provider,{value:T,children:u})}function ae(){const u=R.useContext(W);if(!u)throw new Error("useAccess must be used within <AccessProvider>");return u}exports.AccessProvider=oe;exports.jsxRuntimeExports=L;exports.useAccess=ae;