react-permission-gate 0.1.0

package/dist/react/index.cjs

@@ -0,0 +1,169 @@
+"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/react/index.ts
+var index_exports = {};
+__export(index_exports, {
+  PermissionGate: () => PermissionGate,
+  PermissionProvider: () => PermissionProvider,
+  usePermissions: () => usePermissions
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/react/provider.tsx
+var import_react2 = require("react");
+
+// src/core/permission-checker.ts
+var PermissionChecker = class {
+  constructor(config) {
+    this.permissions = new Set(config.permissions);
+    const adminTypes = config.adminTypes ?? ["ADMIN"];
+    const bypass = config.adminBypass ?? true;
+    this.isAdmin = bypass && adminTypes.includes(config.userType ?? "");
+  }
+  /** Whether this checker was created with an admin-type user */
+  get admin() {
+    return this.isAdmin;
+  }
+  /** Check if user has a specific permission. Admins always return true. */
+  hasPermission(permission) {
+    if (this.isAdmin) return true;
+    return this.permissions.has(permission);
+  }
+  /** Check if user has ANY of the given permissions. Admins always return true. */
+  hasAnyPermission(permissionList) {
+    if (this.isAdmin) return true;
+    return permissionList.some((p) => this.permissions.has(p));
+  }
+  /** Check if user has ALL of the given permissions. Admins always return true. */
+  hasAllPermissions(permissionList) {
+    if (this.isAdmin) return true;
+    return permissionList.every((p) => this.permissions.has(p));
+  }
+  /** Detailed permission check with reason for the result */
+  check(permission) {
+    if (this.isAdmin) {
+      return { granted: true, reason: "admin_bypass" };
+    }
+    if (this.permissions.has(permission)) {
+      return { granted: true, reason: "permission_found" };
+    }
+    return { granted: false, reason: "permission_missing" };
+  }
+};
+
+// src/react/context.ts
+var import_react = require("react");
+var PermissionContext = (0, import_react.createContext)(
+  null
+);
+
+// src/react/provider.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+function PermissionProvider({
+  permissions,
+  userType = "",
+  adminTypes,
+  adminBypass,
+  loading = false,
+  children
+}) {
+  const checker = (0, import_react2.useMemo)(
+    () => new PermissionChecker({
+      permissions,
+      userType,
+      adminTypes,
+      adminBypass
+    }),
+    [permissions, userType, adminTypes, adminBypass]
+  );
+  const value = (0, import_react2.useMemo)(
+    () => ({
+      checker,
+      permissions,
+      userType,
+      isAdmin: checker.admin,
+      isLoading: loading
+    }),
+    [checker, permissions, userType, loading]
+  );
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(PermissionContext.Provider, { value, children });
+}
+
+// src/react/use-permissions.ts
+var import_react3 = require("react");
+function usePermissions() {
+  const context = (0, import_react3.useContext)(PermissionContext);
+  if (!context) {
+    throw new Error(
+      "usePermissions must be used within a <PermissionProvider>"
+    );
+  }
+  const { checker, permissions, userType, isAdmin, isLoading } = context;
+  return {
+    /** Raw permission strings */
+    permissions,
+    /** User type string */
+    userType,
+    /** Whether the user is an admin type */
+    isAdmin,
+    /** Whether permission data is still loading */
+    isLoading,
+    /** Check if user has a specific permission */
+    hasPermission: (permission) => checker.hasPermission(permission),
+    /** Check if user has ANY of the given permissions */
+    hasAnyPermission: (permissionList) => checker.hasAnyPermission(permissionList),
+    /** Check if user has ALL of the given permissions */
+    hasAllPermissions: (permissionList) => checker.hasAllPermissions(permissionList),
+    /** Detailed permission check with reason */
+    check: (permission) => checker.check(permission)
+  };
+}
+
+// src/react/permission-gate.tsx
+var import_jsx_runtime2 = require("react/jsx-runtime");
+function PermissionGate({
+  permission,
+  anyOf,
+  allOf,
+  children,
+  fallback = null
+}) {
+  const { hasPermission, hasAnyPermission, hasAllPermissions, isAdmin } = usePermissions();
+  if (isAdmin) {
+    return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_jsx_runtime2.Fragment, { children });
+  }
+  if (permission && !hasPermission(permission)) {
+    return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_jsx_runtime2.Fragment, { children: fallback });
+  }
+  if (anyOf && anyOf.length > 0 && !hasAnyPermission(anyOf)) {
+    return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_jsx_runtime2.Fragment, { children: fallback });
+  }
+  if (allOf && allOf.length > 0 && !hasAllPermissions(allOf)) {
+    return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_jsx_runtime2.Fragment, { children: fallback });
+  }
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_jsx_runtime2.Fragment, { children });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PermissionGate,
+  PermissionProvider,
+  usePermissions
+});
+//# sourceMappingURL=index.cjs.map

package/dist/react/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/react/index.ts","../../src/react/provider.tsx","../../src/core/permission-checker.ts","../../src/react/context.ts","../../src/react/use-permissions.ts","../../src/react/permission-gate.tsx"],"sourcesContent":["export { PermissionProvider } from \"./provider\";\nexport type { PermissionProviderProps } from \"./provider\";\nexport { usePermissions } from \"./use-permissions\";\nexport { PermissionGate } from \"./permission-gate\";\nexport type { PermissionGateProps } from \"./permission-gate\";\n","import { useMemo, type ReactNode } from \"react\";\nimport { PermissionChecker } from \"../core/permission-checker\";\nimport { PermissionContext } from \"./context\";\n\nexport interface PermissionProviderProps {\n  /** List of permission strings the user has */\n  permissions: string[];\n  /** User's type/role identifier */\n  userType?: string;\n  /** User types that bypass all permission checks (default: [\"ADMIN\"]) */\n  adminTypes?: string[];\n  /** Whether admin types bypass checks (default: true) */\n  adminBypass?: boolean;\n  /** External loading state (e.g., while fetching user data) */\n  loading?: boolean;\n  children: ReactNode;\n}\n\n/**\n * Provides permission context to the component tree.\n *\n * @example\n * <PermissionProvider\n *   permissions={user.permissions}\n *   userType={user.user_type}\n *   loading={isLoading}\n * >\n *   <App />\n * </PermissionProvider>\n */\nexport function PermissionProvider({\n  permissions,\n  userType = \"\",\n  adminTypes,\n  adminBypass,\n  loading = false,\n  children,\n}: PermissionProviderProps) {\n  const checker = useMemo(\n    () =>\n      new PermissionChecker({\n        permissions,\n        userType,\n        adminTypes,\n        adminBypass,\n      }),\n    [permissions, userType, adminTypes, adminBypass],\n  );\n\n  const value = useMemo(\n    () => ({\n      checker,\n      permissions,\n      userType,\n      isAdmin: checker.admin,\n      isLoading: loading,\n    }),\n    [checker, permissions, userType, loading],\n  );\n\n  return (\n    <PermissionContext.Provider value={value}>\n      {children}\n    </PermissionContext.Provider>\n  );\n}\n","import type { PermissionCheckResult, PermissionConfig } from \"./types\";\n\n/**\n * Pure TypeScript permission checker — no React dependency.\n *\n * @example\n * const checker = new PermissionChecker({\n *   permissions: [\"users.read\", \"users.create\"],\n *   userType: \"USER\",\n * });\n *\n * checker.hasPermission(\"users.read\"); // true\n * checker.hasPermission(\"users.delete\"); // false\n */\nexport class PermissionChecker {\n  private readonly permissions: Set<string>;\n  private readonly isAdmin: boolean;\n\n  constructor(config: PermissionConfig) {\n    this.permissions = new Set(config.permissions);\n    const adminTypes = config.adminTypes ?? [\"ADMIN\"];\n    const bypass = config.adminBypass ?? true;\n    this.isAdmin = bypass && adminTypes.includes(config.userType ?? \"\");\n  }\n\n  /** Whether this checker was created with an admin-type user */\n  get admin(): boolean {\n    return this.isAdmin;\n  }\n\n  /** Check if user has a specific permission. Admins always return true. */\n  hasPermission(permission: string): boolean {\n    if (this.isAdmin) return true;\n    return this.permissions.has(permission);\n  }\n\n  /** Check if user has ANY of the given permissions. Admins always return true. */\n  hasAnyPermission(permissionList: string[]): boolean {\n    if (this.isAdmin) return true;\n    return permissionList.some((p) => this.permissions.has(p));\n  }\n\n  /** Check if user has ALL of the given permissions. Admins always return true. */\n  hasAllPermissions(permissionList: string[]): boolean {\n    if (this.isAdmin) return true;\n    return permissionList.every((p) => this.permissions.has(p));\n  }\n\n  /** Detailed permission check with reason for the result */\n  check(permission: string): PermissionCheckResult {\n    if (this.isAdmin) {\n      return { granted: true, reason: \"admin_bypass\" };\n    }\n\n    if (this.permissions.has(permission)) {\n      return { granted: true, reason: \"permission_found\" };\n    }\n\n    return { granted: false, reason: \"permission_missing\" };\n  }\n}\n","import { createContext } from \"react\";\nimport type { PermissionChecker } from \"../core/permission-checker\";\n\nexport interface PermissionContextValue {\n  checker: PermissionChecker;\n  permissions: string[];\n  userType: string;\n  isAdmin: boolean;\n  isLoading: boolean;\n}\n\nexport const PermissionContext = createContext<PermissionContextValue | null>(\n  null,\n);\n","import { useContext } from \"react\";\nimport type { PermissionCheckResult } from \"../core/types\";\nimport { PermissionContext } from \"./context\";\n\n/**\n * Hook for checking user permissions within a PermissionProvider.\n *\n * @example\n * const { hasPermission, isAdmin } = usePermissions();\n *\n * if (hasPermission(\"users.read\")) { ... }\n * if (isAdmin) { ... }\n */\nexport function usePermissions() {\n  const context = useContext(PermissionContext);\n\n  if (!context) {\n    throw new Error(\n      \"usePermissions must be used within a <PermissionProvider>\",\n    );\n  }\n\n  const { checker, permissions, userType, isAdmin, isLoading } = context;\n\n  return {\n    /** Raw permission strings */\n    permissions,\n    /** User type string */\n    userType,\n    /** Whether the user is an admin type */\n    isAdmin,\n    /** Whether permission data is still loading */\n    isLoading,\n    /** Check if user has a specific permission */\n    hasPermission: (permission: string): boolean =>\n      checker.hasPermission(permission),\n    /** Check if user has ANY of the given permissions */\n    hasAnyPermission: (permissionList: string[]): boolean =>\n      checker.hasAnyPermission(permissionList),\n    /** Check if user has ALL of the given permissions */\n    hasAllPermissions: (permissionList: string[]): boolean =>\n      checker.hasAllPermissions(permissionList),\n    /** Detailed permission check with reason */\n    check: (permission: string): PermissionCheckResult =>\n      checker.check(permission),\n  };\n}\n","import type { ReactNode } from \"react\";\nimport { usePermissions } from \"./use-permissions\";\n\nexport interface PermissionGateProps {\n  /** Required permission to show children */\n  permission?: string;\n  /** Show children if user has ANY of these permissions */\n  anyOf?: string[];\n  /** Show children if user has ALL of these permissions */\n  allOf?: string[];\n  /** Content to show when permission is granted */\n  children: ReactNode;\n  /** Content to show when permission is denied */\n  fallback?: ReactNode;\n}\n\n/**\n * Conditionally renders content based on user permissions.\n * Admin users bypass all permission checks.\n *\n * @example\n * <PermissionGate permission=\"users.create\">\n *   <CreateButton />\n * </PermissionGate>\n *\n * <PermissionGate anyOf={[\"users.create\", \"users.update\"]} fallback={<NoAccess />}>\n *   <EditPanel />\n * </PermissionGate>\n */\nexport function PermissionGate({\n  permission,\n  anyOf,\n  allOf,\n  children,\n  fallback = null,\n}: PermissionGateProps) {\n  const { hasPermission, hasAnyPermission, hasAllPermissions, isAdmin } =\n    usePermissions();\n\n  if (isAdmin) {\n    return <>{children}</>;\n  }\n\n  if (permission && !hasPermission(permission)) {\n    return <>{fallback}</>;\n  }\n\n  if (anyOf && anyOf.length > 0 && !hasAnyPermission(anyOf)) {\n    return <>{fallback}</>;\n  }\n\n  if (allOf && allOf.length > 0 && !hasAllPermissions(allOf)) {\n    return <>{fallback}</>;\n  }\n\n  return <>{children}</>;\n}\n"],"mappings":"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","names":["import_react","import_react","import_jsx_runtime"]}

package/dist/react/index.d.cts

@@ -0,0 +1,94 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+interface PermissionProviderProps {
+    /** List of permission strings the user has */
+    permissions: string[];
+    /** User's type/role identifier */
+    userType?: string;
+    /** User types that bypass all permission checks (default: ["ADMIN"]) */
+    adminTypes?: string[];
+    /** Whether admin types bypass checks (default: true) */
+    adminBypass?: boolean;
+    /** External loading state (e.g., while fetching user data) */
+    loading?: boolean;
+    children: ReactNode;
+}
+/**
+ * Provides permission context to the component tree.
+ *
+ * @example
+ * <PermissionProvider
+ *   permissions={user.permissions}
+ *   userType={user.user_type}
+ *   loading={isLoading}
+ * >
+ *   <App />
+ * </PermissionProvider>
+ */
+declare function PermissionProvider({ permissions, userType, adminTypes, adminBypass, loading, children, }: PermissionProviderProps): react_jsx_runtime.JSX.Element;
+
+/** Reason for a permission check result */
+type PermissionCheckReason = "admin_bypass" | "permission_found" | "permission_missing" | "no_check";
+/** Result of a permission check with detailed reason */
+interface PermissionCheckResult {
+    granted: boolean;
+    reason: PermissionCheckReason;
+}
+
+/**
+ * Hook for checking user permissions within a PermissionProvider.
+ *
+ * @example
+ * const { hasPermission, isAdmin } = usePermissions();
+ *
+ * if (hasPermission("users.read")) { ... }
+ * if (isAdmin) { ... }
+ */
+declare function usePermissions(): {
+    /** Raw permission strings */
+    permissions: string[];
+    /** User type string */
+    userType: string;
+    /** Whether the user is an admin type */
+    isAdmin: boolean;
+    /** Whether permission data is still loading */
+    isLoading: boolean;
+    /** Check if user has a specific permission */
+    hasPermission: (permission: string) => boolean;
+    /** Check if user has ANY of the given permissions */
+    hasAnyPermission: (permissionList: string[]) => boolean;
+    /** Check if user has ALL of the given permissions */
+    hasAllPermissions: (permissionList: string[]) => boolean;
+    /** Detailed permission check with reason */
+    check: (permission: string) => PermissionCheckResult;
+};
+
+interface PermissionGateProps {
+    /** Required permission to show children */
+    permission?: string;
+    /** Show children if user has ANY of these permissions */
+    anyOf?: string[];
+    /** Show children if user has ALL of these permissions */
+    allOf?: string[];
+    /** Content to show when permission is granted */
+    children: ReactNode;
+    /** Content to show when permission is denied */
+    fallback?: ReactNode;
+}
+/**
+ * Conditionally renders content based on user permissions.
+ * Admin users bypass all permission checks.
+ *
+ * @example
+ * <PermissionGate permission="users.create">
+ *   <CreateButton />
+ * </PermissionGate>
+ *
+ * <PermissionGate anyOf={["users.create", "users.update"]} fallback={<NoAccess />}>
+ *   <EditPanel />
+ * </PermissionGate>
+ */
+declare function PermissionGate({ permission, anyOf, allOf, children, fallback, }: PermissionGateProps): react_jsx_runtime.JSX.Element;
+
+export { PermissionGate, type PermissionGateProps, PermissionProvider, type PermissionProviderProps, usePermissions };

package/dist/react/index.d.ts

@@ -0,0 +1,94 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+interface PermissionProviderProps {
+    /** List of permission strings the user has */
+    permissions: string[];
+    /** User's type/role identifier */
+    userType?: string;
+    /** User types that bypass all permission checks (default: ["ADMIN"]) */
+    adminTypes?: string[];
+    /** Whether admin types bypass checks (default: true) */
+    adminBypass?: boolean;
+    /** External loading state (e.g., while fetching user data) */
+    loading?: boolean;
+    children: ReactNode;
+}
+/**
+ * Provides permission context to the component tree.
+ *
+ * @example
+ * <PermissionProvider
+ *   permissions={user.permissions}
+ *   userType={user.user_type}
+ *   loading={isLoading}
+ * >
+ *   <App />
+ * </PermissionProvider>
+ */
+declare function PermissionProvider({ permissions, userType, adminTypes, adminBypass, loading, children, }: PermissionProviderProps): react_jsx_runtime.JSX.Element;
+
+/** Reason for a permission check result */
+type PermissionCheckReason = "admin_bypass" | "permission_found" | "permission_missing" | "no_check";
+/** Result of a permission check with detailed reason */
+interface PermissionCheckResult {
+    granted: boolean;
+    reason: PermissionCheckReason;
+}
+
+/**
+ * Hook for checking user permissions within a PermissionProvider.
+ *
+ * @example
+ * const { hasPermission, isAdmin } = usePermissions();
+ *
+ * if (hasPermission("users.read")) { ... }
+ * if (isAdmin) { ... }
+ */
+declare function usePermissions(): {
+    /** Raw permission strings */
+    permissions: string[];
+    /** User type string */
+    userType: string;
+    /** Whether the user is an admin type */
+    isAdmin: boolean;
+    /** Whether permission data is still loading */
+    isLoading: boolean;
+    /** Check if user has a specific permission */
+    hasPermission: (permission: string) => boolean;
+    /** Check if user has ANY of the given permissions */
+    hasAnyPermission: (permissionList: string[]) => boolean;
+    /** Check if user has ALL of the given permissions */
+    hasAllPermissions: (permissionList: string[]) => boolean;
+    /** Detailed permission check with reason */
+    check: (permission: string) => PermissionCheckResult;
+};
+
+interface PermissionGateProps {
+    /** Required permission to show children */
+    permission?: string;
+    /** Show children if user has ANY of these permissions */
+    anyOf?: string[];
+    /** Show children if user has ALL of these permissions */
+    allOf?: string[];
+    /** Content to show when permission is granted */
+    children: ReactNode;
+    /** Content to show when permission is denied */
+    fallback?: ReactNode;
+}
+/**
+ * Conditionally renders content based on user permissions.
+ * Admin users bypass all permission checks.
+ *
+ * @example
+ * <PermissionGate permission="users.create">
+ *   <CreateButton />
+ * </PermissionGate>
+ *
+ * <PermissionGate anyOf={["users.create", "users.update"]} fallback={<NoAccess />}>
+ *   <EditPanel />
+ * </PermissionGate>
+ */
+declare function PermissionGate({ permission, anyOf, allOf, children, fallback, }: PermissionGateProps): react_jsx_runtime.JSX.Element;
+
+export { PermissionGate, type PermissionGateProps, PermissionProvider, type PermissionProviderProps, usePermissions };

package/dist/react/index.js

@@ -0,0 +1,140 @@
+// src/react/provider.tsx
+import { useMemo } from "react";
+
+// src/core/permission-checker.ts
+var PermissionChecker = class {
+  constructor(config) {
+    this.permissions = new Set(config.permissions);
+    const adminTypes = config.adminTypes ?? ["ADMIN"];
+    const bypass = config.adminBypass ?? true;
+    this.isAdmin = bypass && adminTypes.includes(config.userType ?? "");
+  }
+  /** Whether this checker was created with an admin-type user */
+  get admin() {
+    return this.isAdmin;
+  }
+  /** Check if user has a specific permission. Admins always return true. */
+  hasPermission(permission) {
+    if (this.isAdmin) return true;
+    return this.permissions.has(permission);
+  }
+  /** Check if user has ANY of the given permissions. Admins always return true. */
+  hasAnyPermission(permissionList) {
+    if (this.isAdmin) return true;
+    return permissionList.some((p) => this.permissions.has(p));
+  }
+  /** Check if user has ALL of the given permissions. Admins always return true. */
+  hasAllPermissions(permissionList) {
+    if (this.isAdmin) return true;
+    return permissionList.every((p) => this.permissions.has(p));
+  }
+  /** Detailed permission check with reason for the result */
+  check(permission) {
+    if (this.isAdmin) {
+      return { granted: true, reason: "admin_bypass" };
+    }
+    if (this.permissions.has(permission)) {
+      return { granted: true, reason: "permission_found" };
+    }
+    return { granted: false, reason: "permission_missing" };
+  }
+};
+
+// src/react/context.ts
+import { createContext } from "react";
+var PermissionContext = createContext(
+  null
+);
+
+// src/react/provider.tsx
+import { jsx } from "react/jsx-runtime";
+function PermissionProvider({
+  permissions,
+  userType = "",
+  adminTypes,
+  adminBypass,
+  loading = false,
+  children
+}) {
+  const checker = useMemo(
+    () => new PermissionChecker({
+      permissions,
+      userType,
+      adminTypes,
+      adminBypass
+    }),
+    [permissions, userType, adminTypes, adminBypass]
+  );
+  const value = useMemo(
+    () => ({
+      checker,
+      permissions,
+      userType,
+      isAdmin: checker.admin,
+      isLoading: loading
+    }),
+    [checker, permissions, userType, loading]
+  );
+  return /* @__PURE__ */ jsx(PermissionContext.Provider, { value, children });
+}
+
+// src/react/use-permissions.ts
+import { useContext } from "react";
+function usePermissions() {
+  const context = useContext(PermissionContext);
+  if (!context) {
+    throw new Error(
+      "usePermissions must be used within a <PermissionProvider>"
+    );
+  }
+  const { checker, permissions, userType, isAdmin, isLoading } = context;
+  return {
+    /** Raw permission strings */
+    permissions,
+    /** User type string */
+    userType,
+    /** Whether the user is an admin type */
+    isAdmin,
+    /** Whether permission data is still loading */
+    isLoading,
+    /** Check if user has a specific permission */
+    hasPermission: (permission) => checker.hasPermission(permission),
+    /** Check if user has ANY of the given permissions */
+    hasAnyPermission: (permissionList) => checker.hasAnyPermission(permissionList),
+    /** Check if user has ALL of the given permissions */
+    hasAllPermissions: (permissionList) => checker.hasAllPermissions(permissionList),
+    /** Detailed permission check with reason */
+    check: (permission) => checker.check(permission)
+  };
+}
+
+// src/react/permission-gate.tsx
+import { Fragment, jsx as jsx2 } from "react/jsx-runtime";
+function PermissionGate({
+  permission,
+  anyOf,
+  allOf,
+  children,
+  fallback = null
+}) {
+  const { hasPermission, hasAnyPermission, hasAllPermissions, isAdmin } = usePermissions();
+  if (isAdmin) {
+    return /* @__PURE__ */ jsx2(Fragment, { children });
+  }
+  if (permission && !hasPermission(permission)) {
+    return /* @__PURE__ */ jsx2(Fragment, { children: fallback });
+  }
+  if (anyOf && anyOf.length > 0 && !hasAnyPermission(anyOf)) {
+    return /* @__PURE__ */ jsx2(Fragment, { children: fallback });
+  }
+  if (allOf && allOf.length > 0 && !hasAllPermissions(allOf)) {
+    return /* @__PURE__ */ jsx2(Fragment, { children: fallback });
+  }
+  return /* @__PURE__ */ jsx2(Fragment, { children });
+}
+export {
+  PermissionGate,
+  PermissionProvider,
+  usePermissions
+};
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/react/provider.tsx","../../src/core/permission-checker.ts","../../src/react/context.ts","../../src/react/use-permissions.ts","../../src/react/permission-gate.tsx"],"sourcesContent":["import { useMemo, type ReactNode } from \"react\";\nimport { PermissionChecker } from \"../core/permission-checker\";\nimport { PermissionContext } from \"./context\";\n\nexport interface PermissionProviderProps {\n  /** List of permission strings the user has */\n  permissions: string[];\n  /** User's type/role identifier */\n  userType?: string;\n  /** User types that bypass all permission checks (default: [\"ADMIN\"]) */\n  adminTypes?: string[];\n  /** Whether admin types bypass checks (default: true) */\n  adminBypass?: boolean;\n  /** External loading state (e.g., while fetching user data) */\n  loading?: boolean;\n  children: ReactNode;\n}\n\n/**\n * Provides permission context to the component tree.\n *\n * @example\n * <PermissionProvider\n *   permissions={user.permissions}\n *   userType={user.user_type}\n *   loading={isLoading}\n * >\n *   <App />\n * </PermissionProvider>\n */\nexport function PermissionProvider({\n  permissions,\n  userType = \"\",\n  adminTypes,\n  adminBypass,\n  loading = false,\n  children,\n}: PermissionProviderProps) {\n  const checker = useMemo(\n    () =>\n      new PermissionChecker({\n        permissions,\n        userType,\n        adminTypes,\n        adminBypass,\n      }),\n    [permissions, userType, adminTypes, adminBypass],\n  );\n\n  const value = useMemo(\n    () => ({\n      checker,\n      permissions,\n      userType,\n      isAdmin: checker.admin,\n      isLoading: loading,\n    }),\n    [checker, permissions, userType, loading],\n  );\n\n  return (\n    <PermissionContext.Provider value={value}>\n      {children}\n    </PermissionContext.Provider>\n  );\n}\n","import type { PermissionCheckResult, PermissionConfig } from \"./types\";\n\n/**\n * Pure TypeScript permission checker — no React dependency.\n *\n * @example\n * const checker = new PermissionChecker({\n *   permissions: [\"users.read\", \"users.create\"],\n *   userType: \"USER\",\n * });\n *\n * checker.hasPermission(\"users.read\"); // true\n * checker.hasPermission(\"users.delete\"); // false\n */\nexport class PermissionChecker {\n  private readonly permissions: Set<string>;\n  private readonly isAdmin: boolean;\n\n  constructor(config: PermissionConfig) {\n    this.permissions = new Set(config.permissions);\n    const adminTypes = config.adminTypes ?? [\"ADMIN\"];\n    const bypass = config.adminBypass ?? true;\n    this.isAdmin = bypass && adminTypes.includes(config.userType ?? \"\");\n  }\n\n  /** Whether this checker was created with an admin-type user */\n  get admin(): boolean {\n    return this.isAdmin;\n  }\n\n  /** Check if user has a specific permission. Admins always return true. */\n  hasPermission(permission: string): boolean {\n    if (this.isAdmin) return true;\n    return this.permissions.has(permission);\n  }\n\n  /** Check if user has ANY of the given permissions. Admins always return true. */\n  hasAnyPermission(permissionList: string[]): boolean {\n    if (this.isAdmin) return true;\n    return permissionList.some((p) => this.permissions.has(p));\n  }\n\n  /** Check if user has ALL of the given permissions. Admins always return true. */\n  hasAllPermissions(permissionList: string[]): boolean {\n    if (this.isAdmin) return true;\n    return permissionList.every((p) => this.permissions.has(p));\n  }\n\n  /** Detailed permission check with reason for the result */\n  check(permission: string): PermissionCheckResult {\n    if (this.isAdmin) {\n      return { granted: true, reason: \"admin_bypass\" };\n    }\n\n    if (this.permissions.has(permission)) {\n      return { granted: true, reason: \"permission_found\" };\n    }\n\n    return { granted: false, reason: \"permission_missing\" };\n  }\n}\n","import { createContext } from \"react\";\nimport type { PermissionChecker } from \"../core/permission-checker\";\n\nexport interface PermissionContextValue {\n  checker: PermissionChecker;\n  permissions: string[];\n  userType: string;\n  isAdmin: boolean;\n  isLoading: boolean;\n}\n\nexport const PermissionContext = createContext<PermissionContextValue | null>(\n  null,\n);\n","import { useContext } from \"react\";\nimport type { PermissionCheckResult } from \"../core/types\";\nimport { PermissionContext } from \"./context\";\n\n/**\n * Hook for checking user permissions within a PermissionProvider.\n *\n * @example\n * const { hasPermission, isAdmin } = usePermissions();\n *\n * if (hasPermission(\"users.read\")) { ... }\n * if (isAdmin) { ... }\n */\nexport function usePermissions() {\n  const context = useContext(PermissionContext);\n\n  if (!context) {\n    throw new Error(\n      \"usePermissions must be used within a <PermissionProvider>\",\n    );\n  }\n\n  const { checker, permissions, userType, isAdmin, isLoading } = context;\n\n  return {\n    /** Raw permission strings */\n    permissions,\n    /** User type string */\n    userType,\n    /** Whether the user is an admin type */\n    isAdmin,\n    /** Whether permission data is still loading */\n    isLoading,\n    /** Check if user has a specific permission */\n    hasPermission: (permission: string): boolean =>\n      checker.hasPermission(permission),\n    /** Check if user has ANY of the given permissions */\n    hasAnyPermission: (permissionList: string[]): boolean =>\n      checker.hasAnyPermission(permissionList),\n    /** Check if user has ALL of the given permissions */\n    hasAllPermissions: (permissionList: string[]): boolean =>\n      checker.hasAllPermissions(permissionList),\n    /** Detailed permission check with reason */\n    check: (permission: string): PermissionCheckResult =>\n      checker.check(permission),\n  };\n}\n","import type { ReactNode } from \"react\";\nimport { usePermissions } from \"./use-permissions\";\n\nexport interface PermissionGateProps {\n  /** Required permission to show children */\n  permission?: string;\n  /** Show children if user has ANY of these permissions */\n  anyOf?: string[];\n  /** Show children if user has ALL of these permissions */\n  allOf?: string[];\n  /** Content to show when permission is granted */\n  children: ReactNode;\n  /** Content to show when permission is denied */\n  fallback?: ReactNode;\n}\n\n/**\n * Conditionally renders content based on user permissions.\n * Admin users bypass all permission checks.\n *\n * @example\n * <PermissionGate permission=\"users.create\">\n *   <CreateButton />\n * </PermissionGate>\n *\n * <PermissionGate anyOf={[\"users.create\", \"users.update\"]} fallback={<NoAccess />}>\n *   <EditPanel />\n * </PermissionGate>\n */\nexport function PermissionGate({\n  permission,\n  anyOf,\n  allOf,\n  children,\n  fallback = null,\n}: PermissionGateProps) {\n  const { hasPermission, hasAnyPermission, hasAllPermissions, isAdmin } =\n    usePermissions();\n\n  if (isAdmin) {\n    return <>{children}</>;\n  }\n\n  if (permission && !hasPermission(permission)) {\n    return <>{fallback}</>;\n  }\n\n  if (anyOf && anyOf.length > 0 && !hasAnyPermission(anyOf)) {\n    return <>{fallback}</>;\n  }\n\n  if (allOf && allOf.length > 0 && !hasAllPermissions(allOf)) {\n    return <>{fallback}</>;\n  }\n\n  return <>{children}</>;\n}\n"],"mappings":"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","names":["jsx"]}

package/dist/react-router/index.cjs

@@ -0,0 +1,101 @@
+"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/react-router/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ProtectedRoute: () => ProtectedRoute
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/react-router/protected-route.tsx
+var import_react_router_dom = require("react-router-dom");
+
+// src/react/use-permissions.ts
+var import_react2 = require("react");
+
+// src/react/context.ts
+var import_react = require("react");
+var PermissionContext = (0, import_react.createContext)(
+  null
+);
+
+// src/react/use-permissions.ts
+function usePermissions() {
+  const context = (0, import_react2.useContext)(PermissionContext);
+  if (!context) {
+    throw new Error(
+      "usePermissions must be used within a <PermissionProvider>"
+    );
+  }
+  const { checker, permissions, userType, isAdmin, isLoading } = context;
+  return {
+    /** Raw permission strings */
+    permissions,
+    /** User type string */
+    userType,
+    /** Whether the user is an admin type */
+    isAdmin,
+    /** Whether permission data is still loading */
+    isLoading,
+    /** Check if user has a specific permission */
+    hasPermission: (permission) => checker.hasPermission(permission),
+    /** Check if user has ANY of the given permissions */
+    hasAnyPermission: (permissionList) => checker.hasAnyPermission(permissionList),
+    /** Check if user has ALL of the given permissions */
+    hasAllPermissions: (permissionList) => checker.hasAllPermissions(permissionList),
+    /** Detailed permission check with reason */
+    check: (permission) => checker.check(permission)
+  };
+}
+
+// src/react-router/protected-route.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+function ProtectedRoute({
+  permission,
+  anyOf,
+  allOf,
+  children,
+  redirectTo = "/",
+  loadingComponent = null
+}) {
+  const location = (0, import_react_router_dom.useLocation)();
+  const { hasPermission, hasAnyPermission, hasAllPermissions, isAdmin, isLoading } = usePermissions();
+  if (isLoading) {
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_jsx_runtime.Fragment, { children: loadingComponent });
+  }
+  if (isAdmin) {
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_jsx_runtime.Fragment, { children });
+  }
+  if (permission && !hasPermission(permission)) {
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_router_dom.Navigate, { to: redirectTo, state: { from: location }, replace: true });
+  }
+  if (anyOf && anyOf.length > 0 && !hasAnyPermission(anyOf)) {
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_router_dom.Navigate, { to: redirectTo, state: { from: location }, replace: true });
+  }
+  if (allOf && allOf.length > 0 && !hasAllPermissions(allOf)) {
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_router_dom.Navigate, { to: redirectTo, state: { from: location }, replace: true });
+  }
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_jsx_runtime.Fragment, { children });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ProtectedRoute
+});
+//# sourceMappingURL=index.cjs.map

package/dist/react-router/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/react-router/index.ts","../../src/react-router/protected-route.tsx","../../src/react/use-permissions.ts","../../src/react/context.ts"],"sourcesContent":["export { ProtectedRoute } from \"./protected-route\";\nexport type { ProtectedRouteProps } from \"./protected-route\";\n","import type { ReactNode } from \"react\";\nimport { Navigate, useLocation } from \"react-router-dom\";\nimport { usePermissions } from \"../react/use-permissions\";\n\nexport interface ProtectedRouteProps {\n  /** Required permission to access route */\n  permission?: string;\n  /** Allow access if user has ANY of these permissions */\n  anyOf?: string[];\n  /** Allow access if user has ALL of these permissions */\n  allOf?: string[];\n  /** Route content */\n  children: ReactNode;\n  /** Redirect path when access is denied (default: \"/\") */\n  redirectTo?: string;\n  /** Component to show while loading (default: null) */\n  loadingComponent?: ReactNode;\n}\n\n/**\n * Route wrapper that checks permissions before rendering.\n * Redirects when permission check fails. Admin users bypass all checks.\n *\n * @example\n * <Route path=\"/users\" element={\n *   <ProtectedRoute permission=\"users.read\">\n *     <UsersPage />\n *   </ProtectedRoute>\n * } />\n */\nexport function ProtectedRoute({\n  permission,\n  anyOf,\n  allOf,\n  children,\n  redirectTo = \"/\",\n  loadingComponent = null,\n}: ProtectedRouteProps) {\n  const location = useLocation();\n  const { hasPermission, hasAnyPermission, hasAllPermissions, isAdmin, isLoading } =\n    usePermissions();\n\n  if (isLoading) {\n    return <>{loadingComponent}</>;\n  }\n\n  if (isAdmin) {\n    return <>{children}</>;\n  }\n\n  if (permission && !hasPermission(permission)) {\n    return <Navigate to={redirectTo} state={{ from: location }} replace />;\n  }\n\n  if (anyOf && anyOf.length > 0 && !hasAnyPermission(anyOf)) {\n    return <Navigate to={redirectTo} state={{ from: location }} replace />;\n  }\n\n  if (allOf && allOf.length > 0 && !hasAllPermissions(allOf)) {\n    return <Navigate to={redirectTo} state={{ from: location }} replace />;\n  }\n\n  return <>{children}</>;\n}\n","import { useContext } from \"react\";\nimport type { PermissionCheckResult } from \"../core/types\";\nimport { PermissionContext } from \"./context\";\n\n/**\n * Hook for checking user permissions within a PermissionProvider.\n *\n * @example\n * const { hasPermission, isAdmin } = usePermissions();\n *\n * if (hasPermission(\"users.read\")) { ... }\n * if (isAdmin) { ... }\n */\nexport function usePermissions() {\n  const context = useContext(PermissionContext);\n\n  if (!context) {\n    throw new Error(\n      \"usePermissions must be used within a <PermissionProvider>\",\n    );\n  }\n\n  const { checker, permissions, userType, isAdmin, isLoading } = context;\n\n  return {\n    /** Raw permission strings */\n    permissions,\n    /** User type string */\n    userType,\n    /** Whether the user is an admin type */\n    isAdmin,\n    /** Whether permission data is still loading */\n    isLoading,\n    /** Check if user has a specific permission */\n    hasPermission: (permission: string): boolean =>\n      checker.hasPermission(permission),\n    /** Check if user has ANY of the given permissions */\n    hasAnyPermission: (permissionList: string[]): boolean =>\n      checker.hasAnyPermission(permissionList),\n    /** Check if user has ALL of the given permissions */\n    hasAllPermissions: (permissionList: string[]): boolean =>\n      checker.hasAllPermissions(permissionList),\n    /** Detailed permission check with reason */\n    check: (permission: string): PermissionCheckResult =>\n      checker.check(permission),\n  };\n}\n","import { createContext } from \"react\";\nimport type { PermissionChecker } from \"../core/permission-checker\";\n\nexport interface PermissionContextValue {\n  checker: PermissionChecker;\n  permissions: string[];\n  userType: string;\n  isAdmin: boolean;\n  isLoading: boolean;\n}\n\nexport const PermissionContext = createContext<PermissionContextValue | null>(\n  null,\n);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACCA,8BAAsC;;;ACDtC,IAAAA,gBAA2B;;;ACA3B,mBAA8B;AAWvB,IAAM,wBAAoB;AAAA,EAC/B;AACF;;;ADAO,SAAS,iBAAiB;AAC/B,QAAM,cAAU,0BAAW,iBAAiB;AAE5C,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAEA,QAAM,EAAE,SAAS,aAAa,UAAU,SAAS,UAAU,IAAI;AAE/D,SAAO;AAAA;AAAA,IAEL;AAAA;AAAA,IAEA;AAAA;AAAA,IAEA;AAAA;AAAA,IAEA;AAAA;AAAA,IAEA,eAAe,CAAC,eACd,QAAQ,cAAc,UAAU;AAAA;AAAA,IAElC,kBAAkB,CAAC,mBACjB,QAAQ,iBAAiB,cAAc;AAAA;AAAA,IAEzC,mBAAmB,CAAC,mBAClB,QAAQ,kBAAkB,cAAc;AAAA;AAAA,IAE1C,OAAO,CAAC,eACN,QAAQ,MAAM,UAAU;AAAA,EAC5B;AACF;;;ADHW;AAbJ,SAAS,eAAe;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,aAAa;AAAA,EACb,mBAAmB;AACrB,GAAwB;AACtB,QAAM,eAAW,qCAAY;AAC7B,QAAM,EAAE,eAAe,kBAAkB,mBAAmB,SAAS,UAAU,IAC7E,eAAe;AAEjB,MAAI,WAAW;AACb,WAAO,2EAAG,4BAAiB;AAAA,EAC7B;AAEA,MAAI,SAAS;AACX,WAAO,2EAAG,UAAS;AAAA,EACrB;AAEA,MAAI,cAAc,CAAC,cAAc,UAAU,GAAG;AAC5C,WAAO,4CAAC,oCAAS,IAAI,YAAY,OAAO,EAAE,MAAM,SAAS,GAAG,SAAO,MAAC;AAAA,EACtE;AAEA,MAAI,SAAS,MAAM,SAAS,KAAK,CAAC,iBAAiB,KAAK,GAAG;AACzD,WAAO,4CAAC,oCAAS,IAAI,YAAY,OAAO,EAAE,MAAM,SAAS,GAAG,SAAO,MAAC;AAAA,EACtE;AAEA,MAAI,SAAS,MAAM,SAAS,KAAK,CAAC,kBAAkB,KAAK,GAAG;AAC1D,WAAO,4CAAC,oCAAS,IAAI,YAAY,OAAO,EAAE,MAAM,SAAS,GAAG,SAAO,MAAC;AAAA,EACtE;AAEA,SAAO,2EAAG,UAAS;AACrB;","names":["import_react"]}