@zanzojs/react 0.1.0-beta.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gonzalo Jeria
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,57 @@
+"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, {
+  ZanzoContext: () => ZanzoContext,
+  ZanzoProvider: () => ZanzoProvider,
+  useZanzo: () => useZanzo
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/ZanzoProvider.tsx
+var import_react = require("react");
+var import_core = require("@zanzojs/core");
+var import_jsx_runtime = require("react/jsx-runtime");
+var ZanzoContext = (0, import_react.createContext)(null);
+var ZanzoProvider = ({ snapshot, children }) => {
+  const client = (0, import_react.useMemo)(() => new import_core.ZanzoClient(snapshot), [snapshot]);
+  const value = (0, import_react.useMemo)(() => ({
+    can: (action, resource) => client.can(action, resource)
+  }), [client]);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(ZanzoContext.Provider, { value, children });
+};
+
+// src/useZanzo.ts
+var import_react2 = require("react");
+function useZanzo() {
+  const context = (0, import_react2.useContext)(ZanzoContext);
+  if (!context) {
+    throw new Error("useZanzo must be used within a ZanzoProvider");
+  }
+  return context;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ZanzoContext,
+  ZanzoProvider,
+  useZanzo
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/ZanzoProvider.tsx","../src/useZanzo.ts"],"sourcesContent":["export * from './ZanzoProvider.js';\nexport * from './useZanzo.js';\n","import React, { createContext, useMemo, ReactNode } from 'react';\nimport { ZanzoClient } from '@zanzojs/core';\n\nexport interface ZanzoContextValue {\n    can: (action: string, resource: string) => boolean;\n}\n\nexport const ZanzoContext = createContext<ZanzoContextValue | null>(null);\n\nexport interface ZanzoProviderProps {\n    /**\n     * The flat JSON snapshot object provided by the server-side ZanzoCompiler.\n     * e.g. `{ \"Project:1\": [\"read\", \"write\"] }`\n     */\n    snapshot: Record<string, string[]>;\n    children: ReactNode;\n}\n\n/**\n * Injects the Zanzo ReBAC evaluation context into the React Component Tree.\n * It builds an optimized O(1) in-memory client using the provided snapshot.\n */\nexport const ZanzoProvider: React.FC<ZanzoProviderProps> = ({ snapshot, children }) => {\n\n    // Instance the lightweight client only once per snapshot reference\n    const client = useMemo(() => new ZanzoClient(snapshot), [snapshot]);\n\n    // Context value exposed to hooks\n    const value = useMemo<ZanzoContextValue>(() => ({\n        can: (action: string, resource: string) => client.can(action, resource)\n    }), [client]);\n\n    return (\n        <ZanzoContext.Provider value={value}>\n            {children}\n        </ZanzoContext.Provider>\n    );\n};\n","import { useContext } from 'react';\nimport { ZanzoContext, ZanzoContextValue } from './ZanzoProvider.js';\n\n/**\n * Consumes the Zanzo ReBAC context to evaluate permissions synchronously.\n * Must be used within a `<ZanzoProvider>` boundary.\n * \n * @example\n * ```tsx\n * const { can } = useZanzo();\n * \n * if (!can('read', 'Invoice:123')) {\n *   return <AccessDenied />;\n * }\n * ```\n */\nexport function useZanzo(): ZanzoContextValue {\n  const context = useContext(ZanzoContext);\n  \n  if (!context) {\n    throw new Error('useZanzo must be used within a ZanzoProvider');\n  }\n\n  return context;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,mBAAyD;AACzD,kBAA4B;AAgCpB;AA1BD,IAAM,mBAAe,4BAAwC,IAAI;AAejE,IAAM,gBAA8C,CAAC,EAAE,UAAU,SAAS,MAAM;AAGnF,QAAM,aAAS,sBAAQ,MAAM,IAAI,wBAAY,QAAQ,GAAG,CAAC,QAAQ,CAAC;AAGlE,QAAM,YAAQ,sBAA2B,OAAO;AAAA,IAC5C,KAAK,CAAC,QAAgB,aAAqB,OAAO,IAAI,QAAQ,QAAQ;AAAA,EAC1E,IAAI,CAAC,MAAM,CAAC;AAEZ,SACI,4CAAC,aAAa,UAAb,EAAsB,OAClB,UACL;AAER;;;ACrCA,IAAAA,gBAA2B;AAgBpB,SAAS,WAA8B;AAC5C,QAAM,cAAU,0BAAW,YAAY;AAEvC,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI,MAAM,8CAA8C;AAAA,EAChE;AAEA,SAAO;AACT;","names":["import_react"]}

package/dist/index.d.cts

@@ -0,0 +1,36 @@
+import React, { ReactNode } from 'react';
+
+interface ZanzoContextValue {
+    can: (action: string, resource: string) => boolean;
+}
+declare const ZanzoContext: React.Context<ZanzoContextValue | null>;
+interface ZanzoProviderProps {
+    /**
+     * The flat JSON snapshot object provided by the server-side ZanzoCompiler.
+     * e.g. `{ "Project:1": ["read", "write"] }`
+     */
+    snapshot: Record<string, string[]>;
+    children: ReactNode;
+}
+/**
+ * Injects the Zanzo ReBAC evaluation context into the React Component Tree.
+ * It builds an optimized O(1) in-memory client using the provided snapshot.
+ */
+declare const ZanzoProvider: React.FC<ZanzoProviderProps>;
+
+/**
+ * Consumes the Zanzo ReBAC context to evaluate permissions synchronously.
+ * Must be used within a `<ZanzoProvider>` boundary.
+ *
+ * @example
+ * ```tsx
+ * const { can } = useZanzo();
+ *
+ * if (!can('read', 'Invoice:123')) {
+ *   return <AccessDenied />;
+ * }
+ * ```
+ */
+declare function useZanzo(): ZanzoContextValue;
+
+export { ZanzoContext, type ZanzoContextValue, ZanzoProvider, type ZanzoProviderProps, useZanzo };

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+import React, { ReactNode } from 'react';
+
+interface ZanzoContextValue {
+    can: (action: string, resource: string) => boolean;
+}
+declare const ZanzoContext: React.Context<ZanzoContextValue | null>;
+interface ZanzoProviderProps {
+    /**
+     * The flat JSON snapshot object provided by the server-side ZanzoCompiler.
+     * e.g. `{ "Project:1": ["read", "write"] }`
+     */
+    snapshot: Record<string, string[]>;
+    children: ReactNode;
+}
+/**
+ * Injects the Zanzo ReBAC evaluation context into the React Component Tree.
+ * It builds an optimized O(1) in-memory client using the provided snapshot.
+ */
+declare const ZanzoProvider: React.FC<ZanzoProviderProps>;
+
+/**
+ * Consumes the Zanzo ReBAC context to evaluate permissions synchronously.
+ * Must be used within a `<ZanzoProvider>` boundary.
+ *
+ * @example
+ * ```tsx
+ * const { can } = useZanzo();
+ *
+ * if (!can('read', 'Invoice:123')) {
+ *   return <AccessDenied />;
+ * }
+ * ```
+ */
+declare function useZanzo(): ZanzoContextValue;
+
+export { ZanzoContext, type ZanzoContextValue, ZanzoProvider, type ZanzoProviderProps, useZanzo };

package/dist/index.js

@@ -0,0 +1,28 @@
+// src/ZanzoProvider.tsx
+import { createContext, useMemo } from "react";
+import { ZanzoClient } from "@zanzojs/core";
+import { jsx } from "react/jsx-runtime";
+var ZanzoContext = createContext(null);
+var ZanzoProvider = ({ snapshot, children }) => {
+  const client = useMemo(() => new ZanzoClient(snapshot), [snapshot]);
+  const value = useMemo(() => ({
+    can: (action, resource) => client.can(action, resource)
+  }), [client]);
+  return /* @__PURE__ */ jsx(ZanzoContext.Provider, { value, children });
+};
+
+// src/useZanzo.ts
+import { useContext } from "react";
+function useZanzo() {
+  const context = useContext(ZanzoContext);
+  if (!context) {
+    throw new Error("useZanzo must be used within a ZanzoProvider");
+  }
+  return context;
+}
+export {
+  ZanzoContext,
+  ZanzoProvider,
+  useZanzo
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ZanzoProvider.tsx","../src/useZanzo.ts"],"sourcesContent":["import React, { createContext, useMemo, ReactNode } from 'react';\nimport { ZanzoClient } from '@zanzojs/core';\n\nexport interface ZanzoContextValue {\n    can: (action: string, resource: string) => boolean;\n}\n\nexport const ZanzoContext = createContext<ZanzoContextValue | null>(null);\n\nexport interface ZanzoProviderProps {\n    /**\n     * The flat JSON snapshot object provided by the server-side ZanzoCompiler.\n     * e.g. `{ \"Project:1\": [\"read\", \"write\"] }`\n     */\n    snapshot: Record<string, string[]>;\n    children: ReactNode;\n}\n\n/**\n * Injects the Zanzo ReBAC evaluation context into the React Component Tree.\n * It builds an optimized O(1) in-memory client using the provided snapshot.\n */\nexport const ZanzoProvider: React.FC<ZanzoProviderProps> = ({ snapshot, children }) => {\n\n    // Instance the lightweight client only once per snapshot reference\n    const client = useMemo(() => new ZanzoClient(snapshot), [snapshot]);\n\n    // Context value exposed to hooks\n    const value = useMemo<ZanzoContextValue>(() => ({\n        can: (action: string, resource: string) => client.can(action, resource)\n    }), [client]);\n\n    return (\n        <ZanzoContext.Provider value={value}>\n            {children}\n        </ZanzoContext.Provider>\n    );\n};\n","import { useContext } from 'react';\nimport { ZanzoContext, ZanzoContextValue } from './ZanzoProvider.js';\n\n/**\n * Consumes the Zanzo ReBAC context to evaluate permissions synchronously.\n * Must be used within a `<ZanzoProvider>` boundary.\n * \n * @example\n * ```tsx\n * const { can } = useZanzo();\n * \n * if (!can('read', 'Invoice:123')) {\n *   return <AccessDenied />;\n * }\n * ```\n */\nexport function useZanzo(): ZanzoContextValue {\n  const context = useContext(ZanzoContext);\n  \n  if (!context) {\n    throw new Error('useZanzo must be used within a ZanzoProvider');\n  }\n\n  return context;\n}\n"],"mappings":";AAAA,SAAgB,eAAe,eAA0B;AACzD,SAAS,mBAAmB;AAgCpB;AA1BD,IAAM,eAAe,cAAwC,IAAI;AAejE,IAAM,gBAA8C,CAAC,EAAE,UAAU,SAAS,MAAM;AAGnF,QAAM,SAAS,QAAQ,MAAM,IAAI,YAAY,QAAQ,GAAG,CAAC,QAAQ,CAAC;AAGlE,QAAM,QAAQ,QAA2B,OAAO;AAAA,IAC5C,KAAK,CAAC,QAAgB,aAAqB,OAAO,IAAI,QAAQ,QAAQ;AAAA,EAC1E,IAAI,CAAC,MAAM,CAAC;AAEZ,SACI,oBAAC,aAAa,UAAb,EAAsB,OAClB,UACL;AAER;;;ACrCA,SAAS,kBAAkB;AAgBpB,SAAS,WAA8B;AAC5C,QAAM,UAAU,WAAW,YAAY;AAEvC,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI,MAAM,8CAA8C;AAAA,EAChE;AAEA,SAAO;AACT;","names":[]}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@zanzojs/react",
+  "version": "0.1.0-beta.0",
+  "description": "React bindings for Zanzo ReBAC. O(1) permission checks via ZanzoProvider and useZanzo hook.",
+  "keywords": [
+    "@zanzojs/core",
+    "react",
+    "rebac",
+    "authorization",
+    "permissions",
+    "hooks"
+  ],
+  "homepage": "https://github.com/GonzaloJeria/zanzo",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/GonzaloJeria/zanzo.git",
+    "directory": "packages/react"
+  },
+  "license": "MIT",
+  "author": "Gonzalo Jeria",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@zanzojs/core": "^0.1.0-beta.0",
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
+  },
+  "devDependencies": {
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "@types/react": "^18.0.0",
+    "@types/react-dom": "^18.0.0",
+    "@testing-library/react": "^14.2.1",
+    "jsdom": "^24.0.0",
+    "tsup": "latest",
+    "typescript": "^5.7.2",
+    "vitest": "latest",
+    "@zanzojs/core": "0.1.0-beta.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:types": "vitest run --typecheck"
+  }
+}