@webiny/app-admin 6.0.0 → 6.1.0-beta.0

package/hooks/useHotkeys.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useEffect","useRef","isHotkey","state","listenerAttached","zIndex","handlers","triggerHotkeys","e","keys","key","registerZIndex","Object","length","Error","document","body","addEventListener","unregisterZIndex","Math","max","map","Number","removeEventListener","useHotkeys","props","disabled","prevPropsRef","firstRenderRef","current","assign"],"sources":["useHotkeys.ts"],"sourcesContent":["import { useEffect, useRef } from \"react\";\nimport isHotkey from \"is-hotkey\";\n\ntype HookProps = {\n    disabled?: boolean;\n    zIndex: number;\n    keys?: { [key: string]: (e: KeyboardEvent) => void };\n};\n\ntype State = {\n    listenerAttached: boolean;\n    zIndex: null | number;\n    handlers: { [zIndex: number]: { [key: string]: (e: KeyboardEvent) => void } };\n};\n\nconst state: State = {\n    listenerAttached: false,\n    zIndex: null,\n    handlers: {}\n};\n\nfunction triggerHotkeys(e: KeyboardEvent) {\n    if (state.zIndex === null) {\n        return;\n    }\n\n    const keys = state.handlers[state.zIndex];\n    for (const key in keys) {\n        if (isHotkey(key, e)) {\n            keys[key](e);\n            break;\n        }\n    }\n}\n\nfunction registerZIndex({ zIndex, keys }: HookProps) {\n    if (state.zIndex === null || state.zIndex < zIndex) {\n        state.zIndex = zIndex;\n    }\n\n    if (!state.handlers[zIndex]) {\n        state.handlers[zIndex] = {};\n    }\n\n    if (!keys || Object.keys(keys).length === 0) {\n        return;\n    }\n\n    for (const key in keys) {\n        if (key in state.handlers[zIndex]) {\n            throw Error(`Shortcut \"${key}\" already registered on zIndex ${zIndex}.`);\n        }\n        state.handlers[zIndex][key] = keys[key];\n    }\n\n    if (!state.listenerAttached) {\n        document.body.addEventListener(\"keydown\", triggerHotkeys);\n        state.listenerAttached = true;\n    }\n}\n\nfunction unregisterZIndex({ zIndex, keys }: HookProps) {\n    if (state.handlers && state.handlers[zIndex]) {\n        for (const key in keys) {\n            delete state.handlers[zIndex][key];\n        }\n\n        if (Object.keys(state.handlers[zIndex]).length === 0) {\n            delete state.handlers[zIndex];\n        }\n    }\n\n    if (Object.keys(state.handlers).length > 0) {\n        state.zIndex = Math.max(...Object.keys(state.handlers).map(Number));\n    } else {\n        state.zIndex = null;\n\n        if (state.listenerAttached) {\n            document.body.removeEventListener(\"keydown\", triggerHotkeys);\n            state.listenerAttached = false;\n        }\n    }\n}\n\nexport function useHotkeys(props: HookProps) {\n    const { disabled, zIndex, keys } = props;\n\n    const prevPropsRef = useRef<HookProps | undefined>();\n    const firstRenderRef = useRef(true);\n\n    useEffect(function () {\n        if (firstRenderRef.current || prevPropsRef.current?.disabled !== disabled) {\n            firstRenderRef.current = false;\n            if (disabled) {\n                unregisterZIndex(props);\n            } else {\n                registerZIndex(props);\n            }\n        }\n\n        if (!disabled && typeof keys === \"object\") {\n            Object.assign(state.handlers[zIndex], keys);\n        }\n        prevPropsRef.current = { ...props };\n    });\n\n    useEffect(function () {\n        return function () {\n            if (!disabled) {\n                unregisterZIndex(props);\n            }\n        };\n    }, []);\n}\n"],"mappings":"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","ignoreList":[]}

package/index.d.ts

@@ -32,5 +32,6 @@ export { useWcp } from "./presentation/wcp/useWcp.js";
 export { useTenantContext } from "./presentation/tenancy/useTenantContext.js";
 export { useIdentity } from "./presentation/security/hooks/useIdentity.js";
 export { useAuthentication } from "./presentation/security/hooks/useAuthentication.js";
+export { useBuildParams } from "./presentation/buildParams/useBuildParams.js";
 export { useSecurity } from "./presentation/security/hooks/useSecurity.js";
 export * from "@webiny/app/renderApp.js";

package/index.js

@@ -30,7 +30,6 @@ export { SystemInstallerProvider } from "./presentation/installation/components/
 
 // Feature types
 
-// Features
 export { BuildParamsFeature } from "./features/buildParams/feature.js";
 
 // Hooks
@@ -39,6 +38,8 @@ export { useWcp } from "./presentation/wcp/useWcp.js";
 export { useTenantContext } from "./presentation/tenancy/useTenantContext.js";
 export { useIdentity } from "./presentation/security/hooks/useIdentity.js";
 export { useAuthentication } from "./presentation/security/hooks/useAuthentication.js";
+export { useBuildParams } from "./presentation/buildParams/useBuildParams.js";
+
 // Legacy hook for easier migration
 export { useSecurity } from "./presentation/security/hooks/useSecurity.js";
 export * from "@webiny/app/renderApp.js";

package/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["Admin","HasPermission","SecureRoute","FileManager","FileManagerRenderer","SystemInstallerProvider","BuildParamsFeature","useWcp","useTenantContext","useIdentity","useAuthentication","useSecurity"],"sources":["index.ts"],"sourcesContent":["export * from \"@webiny/app\";\nexport type { HigherOrderComponent, ProviderProps, ComposeProps } from \"@webiny/app\";\n// UI components\nexport * from \"./base/ui/Tags.js\";\nexport * from \"./base/ui/Layout.js\";\nexport * from \"./base/ui/TenantSelector.js\";\nexport type { LayoutProps } from \"./base/ui/Layout.js\";\nexport * from \"./base/ui/Navigation.js\";\nexport * from \"./base/ui/Brand.js\";\nexport * from \"./base/ui/Logo.js\";\nexport * from \"./base/ui/UserMenu.js\";\nexport * from \"./base/ui/LoginScreen.js\";\nexport * from \"./base/ui/CenteredView.js\";\nexport * from \"./base/ui/Dashboard.js\";\nexport * from \"./base/ui/NotFound.js\";\n\n// Base admin app\nexport { Admin } from \"./base/Admin.js\";\nexport * from \"./config/AdminConfig.js\";\n\nexport type { AdminProps } from \"./base/Admin.js\";\n\n// Plugins\nexport * from \"./base/plugins/AddGraphQLQuerySelection.js\";\n\n// Permissions\nexport * from \"./permissions/index.js\";\n\n// Components\nexport * from \"./components/index.js\";\nexport type { RichTextValueWithHtml } from \"./components/index.js\";\nexport { HasPermission } from \"./presentation/security/components/HasPermission.js\";\nexport { SecureRoute } from \"./presentation/security/components/SecureRoute.js\";\n\nexport { FileManager, FileManagerRenderer } from \"./base/ui/FileManager.js\";\nexport type {\n    FileManagerProps,\n    FileManagerRendererProps,\n    FileManagerFileItem,\n    FileManagerOnChange\n} from \"./base/ui/FileManager.js\";\n\nexport { SystemInstallerProvider } from \"./presentation/installation/components/SystemInstaller/index.js\";\n\n// Feature types\nexport type { AaclPermission } from \"./features/wcp/types.js\";\nexport type { Tenant } from \"./features/tenancy/types.js\";\n\n// Features\nexport { BuildParamsFeature } from \"./features/buildParams/feature.js\";\n\n// Hooks\nexport * from \"./hooks/index.js\";\nexport { useWcp } from \"./presentation/wcp/useWcp.js\";\nexport { useTenantContext } from \"./presentation/tenancy/useTenantContext.js\";\nexport { useIdentity } from \"./presentation/security/hooks/useIdentity.js\";\nexport { useAuthentication } from \"./presentation/security/hooks/useAuthentication.js\";\n// Legacy hook for easier migration\nexport { useSecurity } from \"./presentation/security/hooks/useSecurity.js\";\n\nexport * from \"@webiny/app/renderApp.js\";\n"],"mappings":"AAAA,cAAc,aAAa;AAE3B;AACA;AACA;AACA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA,SAASA,KAAK;AACd;AAIA;AACA;;AAEA;AACA;;AAEA;AACA;AAEA,SAASC,aAAa;AACtB,SAASC,WAAW;AAEpB,SAASC,WAAW,EAAEC,mBAAmB;AAQzC,SAASC,uBAAuB;;AAEhC;;AAIA;AACA,SAASC,kBAAkB;;AAE3B;AACA;AACA,SAASC,MAAM;AACf,SAASC,gBAAgB;AACzB,SAASC,WAAW;AACpB,SAASC,iBAAiB;AAC1B;AACA,SAASC,WAAW;AAEpB,cAAc,0BAA0B","ignoreList":[]}
+{"version":3,"names":["Admin","HasPermission","SecureRoute","FileManager","FileManagerRenderer","SystemInstallerProvider","BuildParamsFeature","useWcp","useTenantContext","useIdentity","useAuthentication","useBuildParams","useSecurity"],"sources":["index.ts"],"sourcesContent":["export * from \"@webiny/app\";\nexport type { HigherOrderComponent, ProviderProps, ComposeProps } from \"@webiny/app\";\n// UI components\nexport * from \"./base/ui/Tags.js\";\nexport * from \"./base/ui/Layout.js\";\nexport * from \"./base/ui/TenantSelector.js\";\nexport type { LayoutProps } from \"./base/ui/Layout.js\";\nexport * from \"./base/ui/Navigation.js\";\nexport * from \"./base/ui/Brand.js\";\nexport * from \"./base/ui/Logo.js\";\nexport * from \"./base/ui/UserMenu.js\";\nexport * from \"./base/ui/LoginScreen.js\";\nexport * from \"./base/ui/CenteredView.js\";\nexport * from \"./base/ui/Dashboard.js\";\nexport * from \"./base/ui/NotFound.js\";\n\n// Base admin app\nexport { Admin } from \"./base/Admin.js\";\nexport * from \"./config/AdminConfig.js\";\n\nexport type { AdminProps } from \"./base/Admin.js\";\n\n// Plugins\nexport * from \"./base/plugins/AddGraphQLQuerySelection.js\";\n\n// Permissions\nexport * from \"./permissions/index.js\";\n\n// Components\nexport * from \"./components/index.js\";\nexport type { RichTextValueWithHtml } from \"./components/index.js\";\nexport { HasPermission } from \"./presentation/security/components/HasPermission.js\";\nexport { SecureRoute } from \"./presentation/security/components/SecureRoute.js\";\n\nexport { FileManager, FileManagerRenderer } from \"./base/ui/FileManager.js\";\nexport type {\n    FileManagerProps,\n    FileManagerRendererProps,\n    FileManagerFileItem,\n    FileManagerOnChange\n} from \"./base/ui/FileManager.js\";\n\nexport { SystemInstallerProvider } from \"./presentation/installation/components/SystemInstaller/index.js\";\n\n// Feature types\nexport type { AaclPermission } from \"./features/wcp/types.js\";\nexport type { Tenant } from \"./features/tenancy/types.js\";\n\nexport { BuildParamsFeature } from \"./features/buildParams/feature.js\";\n\n// Hooks\nexport * from \"./hooks/index.js\";\nexport { useWcp } from \"./presentation/wcp/useWcp.js\";\nexport { useTenantContext } from \"./presentation/tenancy/useTenantContext.js\";\nexport { useIdentity } from \"./presentation/security/hooks/useIdentity.js\";\nexport { useAuthentication } from \"./presentation/security/hooks/useAuthentication.js\";\nexport { useBuildParams } from \"./presentation/buildParams/useBuildParams.js\";\n\n// Legacy hook for easier migration\nexport { useSecurity } from \"./presentation/security/hooks/useSecurity.js\";\n\nexport * from \"@webiny/app/renderApp.js\";\n"],"mappings":"AAAA,cAAc,aAAa;AAE3B;AACA;AACA;AACA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA,SAASA,KAAK;AACd;AAIA;AACA;;AAEA;AACA;;AAEA;AACA;AAEA,SAASC,aAAa;AACtB,SAASC,WAAW;AAEpB,SAASC,WAAW,EAAEC,mBAAmB;AAQzC,SAASC,uBAAuB;;AAEhC;;AAIA,SAASC,kBAAkB;;AAE3B;AACA;AACA,SAASC,MAAM;AACf,SAASC,gBAAgB;AACzB,SAASC,WAAW;AACpB,SAASC,iBAAiB;AAC1B,SAASC,cAAc;;AAEvB;AACA,SAASC,WAAW;AAEpB,cAAc,0BAA0B","ignoreList":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@webiny/app-admin",
-	"version": "6.0.0",
+	"version": "6.1.0-beta.0",
 	"type": "module",
 	"main": "index.js",
 	"description": "A collection of plugins that together form a complete admin interface, customizable and extensible with Webiny apps and plugins.",
@@ -13,53 +13,49 @@
 	"dependencies": {
 		"@apollo/react-components": "3.1.5",
 		"@apollo/react-hooks": "3.1.5",
-		"@emotion/react": "11.10.8",
-		"@emotion/styled": "11.10.6",
-		"@iconify/json": "2.2.448",
-		"@monaco-editor/react": "4.7.0",
-		"@svgr/webpack": "6.5.1",
-		"@types/mime": "2.0.3",
+		"@emotion/css": "11.13.5",
+		"@emotion/react": "11.14.0",
+		"@emotion/styled": "11.14.1",
+		"@iconify/json": "2.2.455",
+		"@svgr/webpack": "8.1.0",
 		"@types/react": "18.2.79",
-		"@webiny/admin-ui": "6.0.0",
-		"@webiny/app": "6.0.0",
+		"@webiny/admin-ui": "6.1.0-beta.0",
+		"@webiny/app": "6.1.0-beta.0",
 		"@webiny/di": "0.2.3",
-		"@webiny/feature": "6.0.0",
-		"@webiny/form": "6.0.0",
-		"@webiny/icons": "6.0.0",
-		"@webiny/lexical-converter": "6.0.0",
-		"@webiny/lexical-editor": "6.0.0",
-		"@webiny/lexical-theme": "6.0.0",
-		"@webiny/plugins": "6.0.0",
-		"@webiny/react-composition": "6.0.0",
-		"@webiny/react-properties": "6.0.0",
-		"@webiny/telemetry": "6.0.0",
-		"@webiny/ui": "6.0.0",
-		"@webiny/utils": "6.0.0",
-		"@webiny/validation": "6.0.0",
-		"@webiny/wcp": "6.0.0",
+		"@webiny/feature": "6.1.0-beta.0",
+		"@webiny/form": "6.1.0-beta.0",
+		"@webiny/icons": "6.1.0-beta.0",
+		"@webiny/lexical-converter": "6.1.0-beta.0",
+		"@webiny/lexical-editor": "6.1.0-beta.0",
+		"@webiny/lexical-theme": "6.1.0-beta.0",
+		"@webiny/plugins": "6.1.0-beta.0",
+		"@webiny/react-composition": "6.1.0-beta.0",
+		"@webiny/react-properties": "6.1.0-beta.0",
+		"@webiny/telemetry": "6.1.0-beta.0",
+		"@webiny/ui": "6.1.0-beta.0",
+		"@webiny/utils": "6.1.0-beta.0",
+		"@webiny/validation": "6.1.0-beta.0",
+		"@webiny/wcp": "6.1.0-beta.0",
 		"apollo-cache": "1.3.5",
 		"apollo-client": "2.6.10",
 		"apollo-link": "1.2.14",
 		"apollo-link-context": "1.0.20",
 		"apollo-utilities": "1.3.4",
 		"classnames": "2.5.1",
-		"emotion": "10.0.27",
-		"graphql": "16.13.1",
+		"graphql": "16.13.2",
 		"graphql-tag": "2.12.6",
 		"history": "5.3.0",
 		"is-hotkey": "0.2.0",
 		"lodash": "4.17.23",
-		"markdown-to-jsx": "9.7.8",
+		"markdown-to-jsx": "9.7.13",
 		"minimatch": "10.2.4",
 		"mobx": "6.15.0",
-		"mobx-react-lite": "3.4.3",
+		"mobx-react-lite": "4.1.1",
 		"monaco-editor": "0.53.0",
 		"prop-types": "15.8.1",
 		"react": "18.2.0",
 		"react-dom": "18.2.0",
-		"react-draggable": "4.5.0",
-		"react-resizable": "3.1.3",
-		"react-resizable-panels": "4.7.2",
+		"react-resizable-panels": "4.7.6",
 		"react-transition-group": "4.4.5",
 		"react-virtualized": "9.22.6",
 		"reset-css": "5.0.2",
@@ -68,7 +64,7 @@
 	},
 	"devDependencies": {
 		"@emotion/babel-plugin": "11.13.5",
-		"@testing-library/react": "15.0.7",
+		"@testing-library/react": "16.3.2",
 		"@types/bytes": "3.1.5",
 		"@types/graphlib": "2.1.12",
 		"@types/is-hotkey": "0.1.10",
@@ -76,10 +72,10 @@
 		"@types/react-transition-group": "4.4.12",
 		"@types/store": "2.0.5",
 		"@types/tinycolor2": "1.4.6",
-		"@webiny/build-tools": "6.0.0",
+		"@webiny/build-tools": "6.1.0-beta.0",
 		"rimraf": "6.1.3",
 		"typescript": "5.9.3",
-		"vitest": "4.0.18"
+		"vitest": "4.1.2"
 	},
 	"publishConfig": {
 		"access": "public",
@@ -102,5 +98,5 @@
 			]
 		}
 	},
-	"gitHead": "9c6892640a45679ff521e25cd6587dff57393a2e"
+	"gitHead": "a3bd3695c66c79238e380d7360d9731b5fcf9c87"
 }

package/permissions/createHasPermission.d.ts

@@ -1,3 +1,3 @@
 import React from "react";
-import type { PermissionSchemaConfig, HasPermissionProps } from "./types.js";
+import type { HasPermissionProps, PermissionSchemaConfig } from "./types.js";
 export declare function createHasPermission<const S extends PermissionSchemaConfig>(schema: S): React.FC<HasPermissionProps<S>>;

package/permissions/createHasPermission.js

@@ -16,17 +16,32 @@ export function createHasPermission(schema) {
   }) {
     const permissions = usePermissions();
     const action = props.action;
+    const someActions = props.someActions;
+    const allActions = props.allActions;
     const entities = props.entity ? [props.entity] : props.any ?? props.all ?? [];
     const requireAll = !!props.all;
-    const check = entityId => {
-      if (!action) {
+    const checkAction = (entityId, singleAction) => {
+      if (!singleAction) {
         return permissions.canAccess(entityId);
       }
-      const method = BUILT_IN_ACTIONS[action];
-      if (method) {
+      const method = BUILT_IN_ACTIONS[singleAction];
+      if (method && typeof permissions[method] === "function") {
         return permissions[method](entityId);
       }
-      return permissions.canAction(action, entityId);
+      /**
+       * // TODO cant be typed properly because of the dynamic nature of custom actions.
+       */
+      // @ts-expect-error
+      return permissions.canAction(singleAction, entityId);
+    };
+    const check = entityId => {
+      if (allActions) {
+        return allActions.every(act => checkAction(entityId, act));
+      }
+      if (someActions) {
+        return someActions.some(act => checkAction(entityId, act));
+      }
+      return checkAction(entityId, action);
     };
     const allowed = requireAll ? entities.every(check) : entities.some(check);
     return allowed ? /*#__PURE__*/React.createElement(React.Fragment, null, children) : null;

package/permissions/createHasPermission.js.map

@@ -1 +1 @@
-{"version":3,"names":["React","createUsePermissions","BUILT_IN_ACTIONS","read","create","edit","delete","publish","unpublish","createHasPermission","schema","usePermissions","HasPermission","children","props","permissions","action","entities","entity","any","all","requireAll","check","entityId","canAccess","method","canAction","allowed","every","some","createElement","Fragment"],"sources":["createHasPermission.tsx"],"sourcesContent":["import React from \"react\";\nimport { createUsePermissions } from \"./usePermissions.js\";\nimport type { PermissionSchemaConfig, HasPermissionProps } from \"./types.js\";\n\nconst BUILT_IN_ACTIONS: Record<string, string> = {\n    read: \"canRead\",\n    create: \"canCreate\",\n    edit: \"canEdit\",\n    delete: \"canDelete\",\n    publish: \"canPublish\",\n    unpublish: \"canUnpublish\"\n};\n\nexport function createHasPermission<const S extends PermissionSchemaConfig>(\n    schema: S\n): React.FC<HasPermissionProps<S>> {\n    const usePermissions = createUsePermissions(schema);\n\n    return function HasPermission({ children, ...props }) {\n        const permissions = usePermissions();\n\n        const action = props.action as string | undefined;\n        const entities: string[] = props.entity ? [props.entity] : (props.any ?? props.all ?? []);\n        const requireAll = !!props.all;\n\n        const check = (entityId: string): boolean => {\n            if (!action) {\n                return permissions.canAccess(entityId as any);\n            }\n            const method = BUILT_IN_ACTIONS[action];\n            if (method) {\n                return (permissions as any)[method](entityId);\n            }\n            return permissions.canAction(action as any, entityId as any);\n        };\n\n        const allowed = requireAll ? entities.every(check) : entities.some(check);\n\n        return allowed ? <>{children}</> : null;\n    };\n}\n"],"mappings":"AAAA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,oBAAoB;AAG7B,MAAMC,gBAAwC,GAAG;EAC7CC,IAAI,EAAE,SAAS;EACfC,MAAM,EAAE,WAAW;EACnBC,IAAI,EAAE,SAAS;EACfC,MAAM,EAAE,WAAW;EACnBC,OAAO,EAAE,YAAY;EACrBC,SAAS,EAAE;AACf,CAAC;AAED,OAAO,SAASC,mBAAmBA,CAC/BC,MAAS,EACsB;EAC/B,MAAMC,cAAc,GAAGV,oBAAoB,CAACS,MAAM,CAAC;EAEnD,OAAO,SAASE,aAAaA,CAAC;IAAEC,QAAQ;IAAE,GAAGC;EAAM,CAAC,EAAE;IAClD,MAAMC,WAAW,GAAGJ,cAAc,CAAC,CAAC;IAEpC,MAAMK,MAAM,GAAGF,KAAK,CAACE,MAA4B;IACjD,MAAMC,QAAkB,GAAGH,KAAK,CAACI,MAAM,GAAG,CAACJ,KAAK,CAACI,MAAM,CAAC,GAAIJ,KAAK,CAACK,GAAG,IAAIL,KAAK,CAACM,GAAG,IAAI,EAAG;IACzF,MAAMC,UAAU,GAAG,CAAC,CAACP,KAAK,CAACM,GAAG;IAE9B,MAAME,KAAK,GAAIC,QAAgB,IAAc;MACzC,IAAI,CAACP,MAAM,EAAE;QACT,OAAOD,WAAW,CAACS,SAAS,CAACD,QAAe,CAAC;MACjD;MACA,MAAME,MAAM,GAAGvB,gBAAgB,CAACc,MAAM,CAAC;MACvC,IAAIS,MAAM,EAAE;QACR,OAAQV,WAAW,CAASU,MAAM,CAAC,CAACF,QAAQ,CAAC;MACjD;MACA,OAAOR,WAAW,CAACW,SAAS,CAACV,MAAM,EAASO,QAAe,CAAC;IAChE,CAAC;IAED,MAAMI,OAAO,GAAGN,UAAU,GAAGJ,QAAQ,CAACW,KAAK,CAACN,KAAK,CAAC,GAAGL,QAAQ,CAACY,IAAI,CAACP,KAAK,CAAC;IAEzE,OAAOK,OAAO,gBAAG3B,KAAA,CAAA8B,aAAA,CAAA9B,KAAA,CAAA+B,QAAA,QAAGlB,QAAW,CAAC,GAAG,IAAI;EAC3C,CAAC;AACL","ignoreList":[]}
+{"version":3,"names":["React","createUsePermissions","BUILT_IN_ACTIONS","read","create","edit","delete","publish","unpublish","createHasPermission","schema","usePermissions","HasPermission","children","props","permissions","action","someActions","allActions","entities","entity","any","all","requireAll","checkAction","entityId","singleAction","canAccess","method","canAction","check","every","act","some","allowed","createElement","Fragment"],"sources":["createHasPermission.tsx"],"sourcesContent":["import React from \"react\";\nimport { createUsePermissions } from \"./usePermissions.js\";\nimport type { HasPermissionProps, PermissionSchemaConfig } from \"./types.js\";\n\nconst BUILT_IN_ACTIONS: Record<string, string> = {\n    read: \"canRead\",\n    create: \"canCreate\",\n    edit: \"canEdit\",\n    delete: \"canDelete\",\n    publish: \"canPublish\",\n    unpublish: \"canUnpublish\"\n};\n\nexport function createHasPermission<const S extends PermissionSchemaConfig>(\n    schema: S\n): React.FC<HasPermissionProps<S>> {\n    const usePermissions = createUsePermissions(schema);\n\n    return function HasPermission({ children, ...props }) {\n        const permissions = usePermissions();\n\n        const action = props.action as string | undefined;\n        const someActions = props.someActions as string[] | undefined;\n        const allActions = props.allActions as string[] | undefined;\n        const entities: string[] = props.entity ? [props.entity] : (props.any ?? props.all ?? []);\n        const requireAll = !!props.all;\n\n        const checkAction = (entityId: string, singleAction: string | undefined): boolean => {\n            if (!singleAction) {\n                return permissions.canAccess(entityId);\n            }\n            const method = BUILT_IN_ACTIONS[singleAction] as keyof typeof permissions;\n            if (method && typeof permissions[method] === \"function\") {\n                return permissions[method](entityId);\n            }\n            /**\n             * // TODO cant be typed properly because of the dynamic nature of custom actions.\n             */\n            // @ts-expect-error\n            return permissions.canAction(singleAction, entityId);\n        };\n\n        const check = (entityId: string): boolean => {\n            if (allActions) {\n                return allActions.every(act => checkAction(entityId, act));\n            }\n            if (someActions) {\n                return someActions.some(act => checkAction(entityId, act));\n            }\n            return checkAction(entityId, action);\n        };\n\n        const allowed = requireAll ? entities.every(check) : entities.some(check);\n\n        return allowed ? <>{children}</> : null;\n    };\n}\n"],"mappings":"AAAA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,oBAAoB;AAG7B,MAAMC,gBAAwC,GAAG;EAC7CC,IAAI,EAAE,SAAS;EACfC,MAAM,EAAE,WAAW;EACnBC,IAAI,EAAE,SAAS;EACfC,MAAM,EAAE,WAAW;EACnBC,OAAO,EAAE,YAAY;EACrBC,SAAS,EAAE;AACf,CAAC;AAED,OAAO,SAASC,mBAAmBA,CAC/BC,MAAS,EACsB;EAC/B,MAAMC,cAAc,GAAGV,oBAAoB,CAACS,MAAM,CAAC;EAEnD,OAAO,SAASE,aAAaA,CAAC;IAAEC,QAAQ;IAAE,GAAGC;EAAM,CAAC,EAAE;IAClD,MAAMC,WAAW,GAAGJ,cAAc,CAAC,CAAC;IAEpC,MAAMK,MAAM,GAAGF,KAAK,CAACE,MAA4B;IACjD,MAAMC,WAAW,GAAGH,KAAK,CAACG,WAAmC;IAC7D,MAAMC,UAAU,GAAGJ,KAAK,CAACI,UAAkC;IAC3D,MAAMC,QAAkB,GAAGL,KAAK,CAACM,MAAM,GAAG,CAACN,KAAK,CAACM,MAAM,CAAC,GAAIN,KAAK,CAACO,GAAG,IAAIP,KAAK,CAACQ,GAAG,IAAI,EAAG;IACzF,MAAMC,UAAU,GAAG,CAAC,CAACT,KAAK,CAACQ,GAAG;IAE9B,MAAME,WAAW,GAAGA,CAACC,QAAgB,EAAEC,YAAgC,KAAc;MACjF,IAAI,CAACA,YAAY,EAAE;QACf,OAAOX,WAAW,CAACY,SAAS,CAACF,QAAQ,CAAC;MAC1C;MACA,MAAMG,MAAM,GAAG1B,gBAAgB,CAACwB,YAAY,CAA6B;MACzE,IAAIE,MAAM,IAAI,OAAOb,WAAW,CAACa,MAAM,CAAC,KAAK,UAAU,EAAE;QACrD,OAAOb,WAAW,CAACa,MAAM,CAAC,CAACH,QAAQ,CAAC;MACxC;MACA;AACZ;AACA;MACY;MACA,OAAOV,WAAW,CAACc,SAAS,CAACH,YAAY,EAAED,QAAQ,CAAC;IACxD,CAAC;IAED,MAAMK,KAAK,GAAIL,QAAgB,IAAc;MACzC,IAAIP,UAAU,EAAE;QACZ,OAAOA,UAAU,CAACa,KAAK,CAACC,GAAG,IAAIR,WAAW,CAACC,QAAQ,EAAEO,GAAG,CAAC,CAAC;MAC9D;MACA,IAAIf,WAAW,EAAE;QACb,OAAOA,WAAW,CAACgB,IAAI,CAACD,GAAG,IAAIR,WAAW,CAACC,QAAQ,EAAEO,GAAG,CAAC,CAAC;MAC9D;MACA,OAAOR,WAAW,CAACC,QAAQ,EAAET,MAAM,CAAC;IACxC,CAAC;IAED,MAAMkB,OAAO,GAAGX,UAAU,GAAGJ,QAAQ,CAACY,KAAK,CAACD,KAAK,CAAC,GAAGX,QAAQ,CAACc,IAAI,CAACH,KAAK,CAAC;IAEzE,OAAOI,OAAO,gBAAGlC,KAAA,CAAAmC,aAAA,CAAAnC,KAAA,CAAAoC,QAAA,QAAGvB,QAAW,CAAC,GAAG,IAAI;EAC3C,CAAC;AACL","ignoreList":[]}

package/permissions/createHasPermission.test.d.ts

@@ -0,0 +1 @@
+export {};

package/permissions/createHasPermission.test.js

@@ -0,0 +1,206 @@
+import { describe, it, expect, vi, afterEach } from "vitest";
+import React from "react";
+import { render, screen, cleanup } from "@testing-library/react";
+import { createHasPermission } from "./createHasPermission.js";
+import { createPermissionSchema } from "./createPermissionSchema.js";
+import { Identity } from "../domain/Identity.js";
+
+/**
+ * Mutable ref updated before each test so the mock always reflects the current identity.
+ * Using a ref (not a plain variable) keeps the mock factory closure stable across tests.
+ */
+const identityRef = {
+  current: Identity.createAnonymous()
+};
+vi.mock("~/presentation/security/hooks/useIdentity.js", () => ({
+  useIdentity: () => ({
+    identity: identityRef.current,
+    isAuthenticated: true
+  })
+}));
+const TEST_SCHEMA = createPermissionSchema({
+  prefix: "test",
+  fullAccess: true,
+  entities: [{
+    id: "page",
+    title: "Page",
+    permission: "test.page",
+    scopes: ["full"],
+    actions: [{
+      name: "rwd"
+    }, {
+      name: "pw"
+    }]
+  }]
+});
+const HasPermission = createHasPermission(TEST_SCHEMA);
+
+/**
+ * Each call increments the counter so every test gets a fresh identity id,
+ * avoiding hits on the module-level permission cache in usePermissions.ts.
+ */
+let idCounter = 0;
+function makeIdentity(permissions) {
+  return Identity.createAuthenticated({
+    id: `test-identity-${++idCounter}`,
+    displayName: "Test User",
+    type: "admin",
+    roles: [],
+    teams: [],
+    permissions,
+    profile: {
+      external: false
+    },
+    currentTenant: {
+      id: "root",
+      name: "Root"
+    },
+    defaultTenant: {
+      id: "root",
+      name: "Root"
+    }
+  });
+}
+const CHILD_TEXT = "protected content";
+const withPermissions = (permissions, jsx) => {
+  identityRef.current = makeIdentity(permissions);
+  return render(jsx);
+};
+afterEach(() => {
+  cleanup();
+});
+describe("createHasPermission", () => {
+  describe("single action", () => {
+    it("renders children when the user has the required action", () => {
+      withPermissions([{
+        name: "test.page",
+        pw: "p"
+      }], /*#__PURE__*/React.createElement(HasPermission, {
+        entity: "page",
+        action: "publish"
+      }, /*#__PURE__*/React.createElement("span", null, CHILD_TEXT)));
+      expect(screen.getByText(CHILD_TEXT)).toBeTruthy();
+    });
+    it("renders nothing when the user lacks the required action", () => {
+      withPermissions([{
+        name: "test.page",
+        pw: "u"
+      }], /*#__PURE__*/React.createElement(HasPermission, {
+        entity: "page",
+        action: "publish"
+      }, /*#__PURE__*/React.createElement("span", null, CHILD_TEXT)));
+      expect(screen.queryByText(CHILD_TEXT)).toBeNull();
+    });
+    it("renders nothing when the user has no permissions at all", () => {
+      withPermissions([], /*#__PURE__*/React.createElement(HasPermission, {
+        entity: "page",
+        action: "publish"
+      }, /*#__PURE__*/React.createElement("span", null, CHILD_TEXT)));
+      expect(screen.queryByText(CHILD_TEXT)).toBeNull();
+    });
+  });
+  describe("someActions (OR semantics)", () => {
+    it("renders children when the user has all actions in the array", () => {
+      withPermissions([{
+        name: "test.page",
+        pw: "pu"
+      }], /*#__PURE__*/React.createElement(HasPermission, {
+        entity: "page",
+        someActions: ["publish", "unpublish"]
+      }, /*#__PURE__*/React.createElement("span", null, CHILD_TEXT)));
+      expect(screen.getByText(CHILD_TEXT)).toBeTruthy();
+    });
+    it("renders children when the user has only one of the actions", () => {
+      withPermissions([{
+        name: "test.page",
+        pw: "p"
+      }], /*#__PURE__*/React.createElement(HasPermission, {
+        entity: "page",
+        someActions: ["publish", "unpublish"]
+      }, /*#__PURE__*/React.createElement("span", null, CHILD_TEXT)));
+      expect(screen.getByText(CHILD_TEXT)).toBeTruthy();
+    });
+    it("renders children when only the last action in the array is allowed", () => {
+      withPermissions([{
+        name: "test.page",
+        rwd: "rw"
+      }], /*#__PURE__*/React.createElement(HasPermission, {
+        entity: "page",
+        someActions: ["publish", "unpublish", "edit"]
+      }, /*#__PURE__*/React.createElement("span", null, CHILD_TEXT)));
+      expect(screen.getByText(CHILD_TEXT)).toBeTruthy();
+    });
+    it("renders nothing when the user has none of the actions", () => {
+      withPermissions([{
+        name: "test.page",
+        rwd: "r"
+      }], /*#__PURE__*/React.createElement(HasPermission, {
+        entity: "page",
+        someActions: ["publish", "unpublish"]
+      }, /*#__PURE__*/React.createElement("span", null, CHILD_TEXT)));
+      expect(screen.queryByText(CHILD_TEXT)).toBeNull();
+    });
+  });
+  describe("allActions (AND semantics)", () => {
+    it("renders children when the user has all actions in the array", () => {
+      withPermissions([{
+        name: "test.page",
+        pw: "pu"
+      }], /*#__PURE__*/React.createElement(HasPermission, {
+        entity: "page",
+        allActions: ["publish", "unpublish"]
+      }, /*#__PURE__*/React.createElement("span", null, CHILD_TEXT)));
+      expect(screen.getByText(CHILD_TEXT)).toBeTruthy();
+    });
+    it("renders nothing when the user has only one of the required actions", () => {
+      withPermissions([{
+        name: "test.page",
+        pw: "p"
+      }], /*#__PURE__*/React.createElement(HasPermission, {
+        entity: "page",
+        allActions: ["publish", "unpublish"]
+      }, /*#__PURE__*/React.createElement("span", null, CHILD_TEXT)));
+      expect(screen.queryByText(CHILD_TEXT)).toBeNull();
+    });
+    it("renders nothing when the user has none of the required actions", () => {
+      withPermissions([{
+        name: "test.page",
+        rwd: "r"
+      }], /*#__PURE__*/React.createElement(HasPermission, {
+        entity: "page",
+        allActions: ["publish", "unpublish"]
+      }, /*#__PURE__*/React.createElement("span", null, CHILD_TEXT)));
+      expect(screen.queryByText(CHILD_TEXT)).toBeNull();
+    });
+  });
+  describe("no action (entity access only)", () => {
+    it("renders children when the user has any permission for the entity", () => {
+      withPermissions([{
+        name: "test.page",
+        rwd: "r"
+      }], /*#__PURE__*/React.createElement(HasPermission, {
+        entity: "page"
+      }, /*#__PURE__*/React.createElement("span", null, CHILD_TEXT)));
+      expect(screen.getByText(CHILD_TEXT)).toBeTruthy();
+    });
+    it("renders nothing when the user has no permission for the entity", () => {
+      withPermissions([], /*#__PURE__*/React.createElement(HasPermission, {
+        entity: "page"
+      }, /*#__PURE__*/React.createElement("span", null, CHILD_TEXT)));
+      expect(screen.queryByText(CHILD_TEXT)).toBeNull();
+    });
+  });
+  describe("full access", () => {
+    it("renders children regardless of the action when the user has full access", () => {
+      withPermissions([{
+        name: "test.*"
+      }], /*#__PURE__*/React.createElement(HasPermission, {
+        entity: "page",
+        allActions: ["publish", "unpublish"]
+      }, /*#__PURE__*/React.createElement("span", null, CHILD_TEXT)));
+      expect(screen.getByText(CHILD_TEXT)).toBeTruthy();
+    });
+  });
+});
+
+//# sourceMappingURL=createHasPermission.test.js.map

package/permissions/createHasPermission.test.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["describe","it","expect","vi","afterEach","React","render","screen","cleanup","createHasPermission","createPermissionSchema","Identity","identityRef","current","createAnonymous","mock","useIdentity","identity","isAuthenticated","TEST_SCHEMA","prefix","fullAccess","entities","id","title","permission","scopes","actions","name","HasPermission","idCounter","makeIdentity","permissions","createAuthenticated","displayName","type","roles","teams","profile","external","currentTenant","defaultTenant","CHILD_TEXT","withPermissions","jsx","pw","createElement","entity","action","getByText","toBeTruthy","queryByText","toBeNull","someActions","rwd","allActions"],"sources":["createHasPermission.test.tsx"],"sourcesContent":["import { describe, it, expect, vi, afterEach } from \"vitest\";\nimport React from \"react\";\nimport { render, screen, cleanup } from \"@testing-library/react\";\nimport { createHasPermission } from \"./createHasPermission.js\";\nimport { createPermissionSchema } from \"./createPermissionSchema.js\";\nimport { Identity } from \"~/domain/Identity.js\";\n\n/**\n * Mutable ref updated before each test so the mock always reflects the current identity.\n * Using a ref (not a plain variable) keeps the mock factory closure stable across tests.\n */\nconst identityRef = { current: Identity.createAnonymous() };\n\nvi.mock(\"~/presentation/security/hooks/useIdentity.js\", () => ({\n    useIdentity: () => ({ identity: identityRef.current, isAuthenticated: true })\n}));\n\nconst TEST_SCHEMA = createPermissionSchema({\n    prefix: \"test\",\n    fullAccess: true,\n    entities: [\n        {\n            id: \"page\",\n            title: \"Page\",\n            permission: \"test.page\",\n            scopes: [\"full\"],\n            actions: [{ name: \"rwd\" }, { name: \"pw\" }]\n        }\n    ]\n} as const);\n\nconst HasPermission = createHasPermission(TEST_SCHEMA);\n\n/**\n * Each call increments the counter so every test gets a fresh identity id,\n * avoiding hits on the module-level permission cache in usePermissions.ts.\n */\nlet idCounter = 0;\n\nfunction makeIdentity(permissions: Array<{ name: string; [key: string]: any }>) {\n    return Identity.createAuthenticated({\n        id: `test-identity-${++idCounter}`,\n        displayName: \"Test User\",\n        type: \"admin\",\n        roles: [],\n        teams: [],\n        permissions,\n        profile: { external: false },\n        currentTenant: { id: \"root\", name: \"Root\" },\n        defaultTenant: { id: \"root\", name: \"Root\" }\n    });\n}\n\nconst CHILD_TEXT = \"protected content\";\n\nconst withPermissions = (\n    permissions: Array<{ name: string; [key: string]: any }>,\n    jsx: React.ReactElement\n) => {\n    identityRef.current = makeIdentity(permissions);\n    return render(jsx);\n};\n\nafterEach(() => {\n    cleanup();\n});\n\ndescribe(\"createHasPermission\", () => {\n    describe(\"single action\", () => {\n        it(\"renders children when the user has the required action\", () => {\n            withPermissions(\n                [{ name: \"test.page\", pw: \"p\" }],\n                <HasPermission entity={\"page\"} action={\"publish\"}>\n                    <span>{CHILD_TEXT}</span>\n                </HasPermission>\n            );\n            expect(screen.getByText(CHILD_TEXT)).toBeTruthy();\n        });\n\n        it(\"renders nothing when the user lacks the required action\", () => {\n            withPermissions(\n                [{ name: \"test.page\", pw: \"u\" }],\n                <HasPermission entity={\"page\"} action={\"publish\"}>\n                    <span>{CHILD_TEXT}</span>\n                </HasPermission>\n            );\n            expect(screen.queryByText(CHILD_TEXT)).toBeNull();\n        });\n\n        it(\"renders nothing when the user has no permissions at all\", () => {\n            withPermissions(\n                [],\n                <HasPermission entity={\"page\"} action={\"publish\"}>\n                    <span>{CHILD_TEXT}</span>\n                </HasPermission>\n            );\n            expect(screen.queryByText(CHILD_TEXT)).toBeNull();\n        });\n    });\n\n    describe(\"someActions (OR semantics)\", () => {\n        it(\"renders children when the user has all actions in the array\", () => {\n            withPermissions(\n                [{ name: \"test.page\", pw: \"pu\" }],\n                <HasPermission entity={\"page\"} someActions={[\"publish\", \"unpublish\"]}>\n                    <span>{CHILD_TEXT}</span>\n                </HasPermission>\n            );\n            expect(screen.getByText(CHILD_TEXT)).toBeTruthy();\n        });\n\n        it(\"renders children when the user has only one of the actions\", () => {\n            withPermissions(\n                [{ name: \"test.page\", pw: \"p\" }],\n                <HasPermission entity={\"page\"} someActions={[\"publish\", \"unpublish\"]}>\n                    <span>{CHILD_TEXT}</span>\n                </HasPermission>\n            );\n            expect(screen.getByText(CHILD_TEXT)).toBeTruthy();\n        });\n\n        it(\"renders children when only the last action in the array is allowed\", () => {\n            withPermissions(\n                [{ name: \"test.page\", rwd: \"rw\" }],\n                <HasPermission entity={\"page\"} someActions={[\"publish\", \"unpublish\", \"edit\"]}>\n                    <span>{CHILD_TEXT}</span>\n                </HasPermission>\n            );\n            expect(screen.getByText(CHILD_TEXT)).toBeTruthy();\n        });\n\n        it(\"renders nothing when the user has none of the actions\", () => {\n            withPermissions(\n                [{ name: \"test.page\", rwd: \"r\" }],\n                <HasPermission entity={\"page\"} someActions={[\"publish\", \"unpublish\"]}>\n                    <span>{CHILD_TEXT}</span>\n                </HasPermission>\n            );\n            expect(screen.queryByText(CHILD_TEXT)).toBeNull();\n        });\n    });\n\n    describe(\"allActions (AND semantics)\", () => {\n        it(\"renders children when the user has all actions in the array\", () => {\n            withPermissions(\n                [{ name: \"test.page\", pw: \"pu\" }],\n                <HasPermission entity={\"page\"} allActions={[\"publish\", \"unpublish\"]}>\n                    <span>{CHILD_TEXT}</span>\n                </HasPermission>\n            );\n            expect(screen.getByText(CHILD_TEXT)).toBeTruthy();\n        });\n\n        it(\"renders nothing when the user has only one of the required actions\", () => {\n            withPermissions(\n                [{ name: \"test.page\", pw: \"p\" }],\n                <HasPermission entity={\"page\"} allActions={[\"publish\", \"unpublish\"]}>\n                    <span>{CHILD_TEXT}</span>\n                </HasPermission>\n            );\n            expect(screen.queryByText(CHILD_TEXT)).toBeNull();\n        });\n\n        it(\"renders nothing when the user has none of the required actions\", () => {\n            withPermissions(\n                [{ name: \"test.page\", rwd: \"r\" }],\n                <HasPermission entity={\"page\"} allActions={[\"publish\", \"unpublish\"]}>\n                    <span>{CHILD_TEXT}</span>\n                </HasPermission>\n            );\n            expect(screen.queryByText(CHILD_TEXT)).toBeNull();\n        });\n    });\n\n    describe(\"no action (entity access only)\", () => {\n        it(\"renders children when the user has any permission for the entity\", () => {\n            withPermissions(\n                [{ name: \"test.page\", rwd: \"r\" }],\n                <HasPermission entity={\"page\"}>\n                    <span>{CHILD_TEXT}</span>\n                </HasPermission>\n            );\n            expect(screen.getByText(CHILD_TEXT)).toBeTruthy();\n        });\n\n        it(\"renders nothing when the user has no permission for the entity\", () => {\n            withPermissions(\n                [],\n                <HasPermission entity={\"page\"}>\n                    <span>{CHILD_TEXT}</span>\n                </HasPermission>\n            );\n            expect(screen.queryByText(CHILD_TEXT)).toBeNull();\n        });\n    });\n\n    describe(\"full access\", () => {\n        it(\"renders children regardless of the action when the user has full access\", () => {\n            withPermissions(\n                [{ name: \"test.*\" }],\n                <HasPermission entity={\"page\"} allActions={[\"publish\", \"unpublish\"]}>\n                    <span>{CHILD_TEXT}</span>\n                </HasPermission>\n            );\n            expect(screen.getByText(CHILD_TEXT)).toBeTruthy();\n        });\n    });\n});\n"],"mappings":"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","ignoreList":[]}

package/permissions/types.d.ts

@@ -1,4 +1,5 @@
 import type React from "react";
+import type { NonEmptyArray } from "@webiny/app/types.js";
 /**
  * A single permission object from the API.
  */
@@ -192,31 +193,50 @@ export interface UsePermissionsResultUntyped {
  * Built-in actions are always available; custom action names from the schema are inferred automatically.
  */
 export type HasPermissionAction<S extends PermissionSchemaConfig> = "read" | "create" | "edit" | "delete" | "publish" | "unpublish" | CustomActionNames<S>;
+/**
+ * Action constraint for `HasPermission`.
+ *
+ * Exactly one of `action`, `someActions`, or `allActions` may be provided:
+ * - `action` — single action; grants access if it passes.
+ * - `someActions` — array; grants access if ANY action passes (OR).
+ * - `allActions` — array; grants access only if ALL actions pass (AND).
+ */
+type ActionConstraint<S extends PermissionSchemaConfig> = {
+    action?: HasPermissionAction<S>;
+    someActions?: never;
+    allActions?: never;
+} | {
+    action?: never;
+    someActions: NonEmptyArray<HasPermissionAction<S>>;
+    allActions?: never;
+} | {
+    action?: never;
+    someActions?: never;
+    allActions: NonEmptyArray<HasPermissionAction<S>>;
+};
 /**
  * Props for a schema-bound `HasPermission` component created via `createHasPermission`.
  *
  * Exactly one of `entity`, `any`, or `all` must be provided.
+ * Optionally combine with `action`, `someActions`, or `allActions`.
  */
-export type HasPermissionProps<S extends PermissionSchemaConfig> = SingleEntityProps<S> | AnyEntitiesProps<S> | AllEntitiesProps<S>;
+export type HasPermissionProps<S extends PermissionSchemaConfig> = (SingleEntityProps<S> | AnyEntitiesProps<S> | AllEntitiesProps<S>) & ActionConstraint<S>;
 interface SingleEntityProps<S extends PermissionSchemaConfig> {
     entity: AllEntityIds<S>;
     any?: never;
     all?: never;
-    action?: HasPermissionAction<S>;
     children: React.ReactNode;
 }
 interface AnyEntitiesProps<S extends PermissionSchemaConfig> {
     entity?: never;
     any: AllEntityIds<S>[];
     all?: never;
-    action?: HasPermissionAction<S>;
     children: React.ReactNode;
 }
 interface AllEntitiesProps<S extends PermissionSchemaConfig> {
     entity?: never;
     any?: never;
     all: AllEntityIds<S>[];
-    action?: HasPermissionAction<S>;
     children: React.ReactNode;
 }
 type UsePermissionsResultTyped<S extends PermissionSchemaConfig> = {

package/permissions/types.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sources":["types.ts"],"sourcesContent":["import type React from \"react\";\n\n/**\n * A single permission object from the API.\n */\nexport interface Permission {\n    name: string;\n    [key: string]: any;\n}\n\n/**\n * An action definition on an entity.\n *\n * Built-in actions:\n * - `{ name: \"rwd\" }` — read/write/delete single-select (serialized as joined string, e.g. \"rw\")\n * - `{ name: \"pw\" }` — publish/unpublish multi-select (serialized as joined string, e.g. \"pu\")\n *\n * Custom actions:\n * - `{ name: \"install\", label: \"Install\" }` — boolean flag (serialized as `install: true`)\n */\nexport interface ActionDefinition {\n    /** Key on the permission object (e.g. \"rwd\", \"pw\", \"install\") */\n    name: string;\n    /** Display label for the UI. Required for custom actions; ignored for built-in \"rwd\"/\"pw\". */\n    label?: string;\n}\n\n/**\n * Defines an entity within a permission schema.\n */\nexport interface EntityDefinition {\n    /** Unique ID, used for form field naming: ${id}AccessScope, ${id}RWD, etc. */\n    id: string;\n    /** Display title for the UI renderer (e.g. \"Files\", \"Settings\") */\n    title?: string;\n    /** Permission name emitted for this entity (e.g. \"fm.file\") */\n    permission: string;\n    /** Available access scopes */\n    scopes: (\"full\" | \"own\")[];\n    /** Action definitions for this entity */\n    actions?: ActionDefinition[];\n    /** Dependency on another entity */\n    dependsOn?: {\n        /** ID of parent entity */\n        entity: string;\n        /** Required action character (e.g. \"r\") */\n        requires: string;\n    };\n}\n\n/**\n * Configuration for creating a permission schema.\n */\nexport interface PermissionSchemaConfig {\n    /** Permission prefix — used to filter permissions from the array */\n    prefix: string;\n    /**\n     * Full access configuration.\n     * - `true` — emits `{ name: \"${prefix}.*\" }`.\n     * - `{ ...extras }` — emits `{ name: \"${prefix}.*\", ...extras }`.\n     */\n    fullAccess: boolean | { [key: string]: any };\n    /**\n     * Read-only access configuration. When defined, the schema supports a read-only tier.\n     * - `true` — emits `{ name: \"${prefix}.*\", rwd: \"r\" }`.\n     * - `Permission[]` — emits the array as-is.\n     */\n    readOnlyAccess?: boolean | Permission[];\n    /** Entity definitions (optional — simple apps have none) */\n    entities?: EntityDefinition[];\n}\n\n/**\n * A compiled permission schema returned by `createPermissionSchema`.\n */\nexport interface PermissionSchema {\n    prefix: string;\n    /**\n     * Full access configuration.\n     * - `true` — emits `{ name: \"${prefix}.*\" }`.\n     * - `{ ...extras }` — emits `{ name: \"${prefix}.*\", ...extras }`.\n     */\n    fullAccess: boolean | { [key: string]: any };\n    /**\n     * Read-only access configuration. When defined, the schema supports a read-only tier.\n     * - `true` — emits `{ name: \"${prefix}.*\", rwd: \"r\" }`.\n     * - `Permission[]` — emits the array as-is.\n     */\n    readOnlyAccess?: boolean | Permission[];\n    entities?: EntityDefinition[];\n}\n\n/**\n * Options passed to the `usePermissionForm` hook.\n */\nexport interface UsePermissionFormOptions {\n    value: Permission[];\n    onChange: (value: Permission[]) => void;\n    /** Merge extra fields into deserialized form data (for CMS endpoints, resource scopes, etc.) */\n    deserialize?: (permissions: Permission[]) => Record<string, any>;\n    /** Transform or extend the core-serialized permissions (for CMS endpoints, resource scopes, etc.) */\n    serialize?: (formData: Record<string, any>, corePermissions: Permission[]) => Permission[];\n}\n\n/**\n * Return value of `usePermissionForm`.\n */\nexport interface UsePermissionFormResult {\n    formData: Record<string, any>;\n    onFormChange: (data: Record<string, any>) => void;\n}\n\n/**\n * Configuration for a permission renderer registered via AdminConfig.\n *\n * Either `schema` or `element` must be provided:\n * - `schema`: uses the built-in PermissionRenderer for auto-generated UI.\n * - `element`: uses a custom React element for full control.\n */\nexport type PermissionRendererConfig = PermissionRendererConfigBase &\n    (\n        | { schema: PermissionSchema; element?: never }\n        | { schema?: never; element: React.ReactElement }\n    );\n\ninterface PermissionRendererConfigBase {\n    name: string;\n    title: string;\n    description?: string;\n    icon?: React.ReactElement;\n    system?: boolean;\n}\n\n/**\n * Item that may have an owner (used for own-scope permission checks).\n */\nexport interface OwnableItem {\n    createdBy?: { id: string } | null;\n}\n\n/**\n * Extract the union of entity definitions from a schema config type.\n */\ntype EntitiesOf<S extends PermissionSchemaConfig> = S extends {\n    entities: ReadonlyArray<infer E extends EntityDefinition>;\n}\n    ? E\n    : never;\n\n/**\n * Extract entity IDs whose actions array contains an action with the given name.\n */\ntype EntityIdWithAction<S extends PermissionSchemaConfig, A extends string> = {\n    [K in EntitiesOf<S> as K extends { actions: ReadonlyArray<infer Act> }\n        ? Act extends { name: A }\n            ? K[\"id\"]\n            : never\n        : never]: never;\n} extends infer M\n    ? keyof M & string\n    : never;\n\n/**\n * Entity IDs that have the \"rwd\" action.\n */\nexport type RwdEntityId<S extends PermissionSchemaConfig> = EntityIdWithAction<S, \"rwd\">;\n\n/**\n * Entity IDs that have the \"pw\" action.\n */\nexport type PwEntityId<S extends PermissionSchemaConfig> = EntityIdWithAction<S, \"pw\">;\n\n/**\n * All entity IDs in the schema.\n */\nexport type AllEntityIds<S extends PermissionSchemaConfig> = EntitiesOf<S>[\"id\"];\n\n/**\n * Custom (non-builtin) action names across all entities.\n */\nexport type CustomActionNames<S extends PermissionSchemaConfig> = Exclude<\n    EntitiesOf<S> extends { actions: ReadonlyArray<infer Act extends ActionDefinition> }\n        ? Act[\"name\"]\n        : never,\n    \"rwd\" | \"pw\"\n>;\n\n/**\n * The return type of `usePermissions(schema)`.\n *\n * When the schema has literal entity types, methods are narrowed to only accept valid entity IDs.\n * When the schema is dynamically typed, all methods accept `string`.\n */\nexport type UsePermissionsResult<S extends PermissionSchemaConfig> =\n    string extends AllEntityIds<S> ? UsePermissionsResultUntyped : UsePermissionsResultTyped<S>;\n\nexport interface UsePermissionsResultUntyped {\n    canAccess: (entityId: string) => boolean;\n    canRead: (entityId: string) => boolean;\n    canCreate: (entityId: string) => boolean;\n    canEdit: (entityId: string, item?: OwnableItem) => boolean;\n    canDelete: (entityId: string, item?: OwnableItem) => boolean;\n    canPublish: (entityId: string) => boolean;\n    canUnpublish: (entityId: string) => boolean;\n    canAction: (action: string, entityId: string) => boolean;\n}\n\n/**\n * Action values accepted by `HasPermission`.\n *\n * Built-in actions are always available; custom action names from the schema are inferred automatically.\n */\nexport type HasPermissionAction<S extends PermissionSchemaConfig> =\n    | \"read\"\n    | \"create\"\n    | \"edit\"\n    | \"delete\"\n    | \"publish\"\n    | \"unpublish\"\n    | CustomActionNames<S>;\n\n/**\n * Props for a schema-bound `HasPermission` component created via `createHasPermission`.\n *\n * Exactly one of `entity`, `any`, or `all` must be provided.\n */\nexport type HasPermissionProps<S extends PermissionSchemaConfig> =\n    | SingleEntityProps<S>\n    | AnyEntitiesProps<S>\n    | AllEntitiesProps<S>;\n\ninterface SingleEntityProps<S extends PermissionSchemaConfig> {\n    entity: AllEntityIds<S>;\n    any?: never;\n    all?: never;\n    action?: HasPermissionAction<S>;\n    children: React.ReactNode;\n}\n\ninterface AnyEntitiesProps<S extends PermissionSchemaConfig> {\n    entity?: never;\n    any: AllEntityIds<S>[];\n    all?: never;\n    action?: HasPermissionAction<S>;\n    children: React.ReactNode;\n}\n\ninterface AllEntitiesProps<S extends PermissionSchemaConfig> {\n    entity?: never;\n    any?: never;\n    all: AllEntityIds<S>[];\n    action?: HasPermissionAction<S>;\n    children: React.ReactNode;\n}\n\ntype UsePermissionsResultTyped<S extends PermissionSchemaConfig> = {\n    canAccess: (entityId: AllEntityIds<S>) => boolean;\n    canAction: (\n        action: CustomActionNames<S> extends never ? string : CustomActionNames<S>,\n        entityId: AllEntityIds<S>\n    ) => boolean;\n} & ([RwdEntityId<S>] extends [never]\n    ? {\n          canRead: (entityId: string) => boolean;\n          canCreate: (entityId: string) => boolean;\n          canEdit: (entityId: string, item?: OwnableItem) => boolean;\n          canDelete: (entityId: string, item?: OwnableItem) => boolean;\n      }\n    : {\n          canRead: (entityId: RwdEntityId<S>) => boolean;\n          canCreate: (entityId: RwdEntityId<S>) => boolean;\n          canEdit: (entityId: RwdEntityId<S>, item?: OwnableItem) => boolean;\n          canDelete: (entityId: RwdEntityId<S>, item?: OwnableItem) => boolean;\n      }) &\n    ([PwEntityId<S>] extends [never]\n        ? {\n              canPublish: (entityId: string) => boolean;\n              canUnpublish: (entityId: string) => boolean;\n          }\n        : {\n              canPublish: (entityId: PwEntityId<S>) => boolean;\n              canUnpublish: (entityId: PwEntityId<S>) => boolean;\n          });\n"],"mappings":"","ignoreList":[]}
+{"version":3,"names":[],"sources":["types.ts"],"sourcesContent":["import type React from \"react\";\nimport type { NonEmptyArray } from \"@webiny/app/types.js\";\n\n/**\n * A single permission object from the API.\n */\nexport interface Permission {\n    name: string;\n    [key: string]: any;\n}\n\n/**\n * An action definition on an entity.\n *\n * Built-in actions:\n * - `{ name: \"rwd\" }` — read/write/delete single-select (serialized as joined string, e.g. \"rw\")\n * - `{ name: \"pw\" }` — publish/unpublish multi-select (serialized as joined string, e.g. \"pu\")\n *\n * Custom actions:\n * - `{ name: \"install\", label: \"Install\" }` — boolean flag (serialized as `install: true`)\n */\nexport interface ActionDefinition {\n    /** Key on the permission object (e.g. \"rwd\", \"pw\", \"install\") */\n    name: string;\n    /** Display label for the UI. Required for custom actions; ignored for built-in \"rwd\"/\"pw\". */\n    label?: string;\n}\n\n/**\n * Defines an entity within a permission schema.\n */\nexport interface EntityDefinition {\n    /** Unique ID, used for form field naming: ${id}AccessScope, ${id}RWD, etc. */\n    id: string;\n    /** Display title for the UI renderer (e.g. \"Files\", \"Settings\") */\n    title?: string;\n    /** Permission name emitted for this entity (e.g. \"fm.file\") */\n    permission: string;\n    /** Available access scopes */\n    scopes: (\"full\" | \"own\")[];\n    /** Action definitions for this entity */\n    actions?: ActionDefinition[];\n    /** Dependency on another entity */\n    dependsOn?: {\n        /** ID of parent entity */\n        entity: string;\n        /** Required action character (e.g. \"r\") */\n        requires: string;\n    };\n}\n\n/**\n * Configuration for creating a permission schema.\n */\nexport interface PermissionSchemaConfig {\n    /** Permission prefix — used to filter permissions from the array */\n    prefix: string;\n    /**\n     * Full access configuration.\n     * - `true` — emits `{ name: \"${prefix}.*\" }`.\n     * - `{ ...extras }` — emits `{ name: \"${prefix}.*\", ...extras }`.\n     */\n    fullAccess: boolean | { [key: string]: any };\n    /**\n     * Read-only access configuration. When defined, the schema supports a read-only tier.\n     * - `true` — emits `{ name: \"${prefix}.*\", rwd: \"r\" }`.\n     * - `Permission[]` — emits the array as-is.\n     */\n    readOnlyAccess?: boolean | Permission[];\n    /** Entity definitions (optional — simple apps have none) */\n    entities?: EntityDefinition[];\n}\n\n/**\n * A compiled permission schema returned by `createPermissionSchema`.\n */\nexport interface PermissionSchema {\n    prefix: string;\n    /**\n     * Full access configuration.\n     * - `true` — emits `{ name: \"${prefix}.*\" }`.\n     * - `{ ...extras }` — emits `{ name: \"${prefix}.*\", ...extras }`.\n     */\n    fullAccess: boolean | { [key: string]: any };\n    /**\n     * Read-only access configuration. When defined, the schema supports a read-only tier.\n     * - `true` — emits `{ name: \"${prefix}.*\", rwd: \"r\" }`.\n     * - `Permission[]` — emits the array as-is.\n     */\n    readOnlyAccess?: boolean | Permission[];\n    entities?: EntityDefinition[];\n}\n\n/**\n * Options passed to the `usePermissionForm` hook.\n */\nexport interface UsePermissionFormOptions {\n    value: Permission[];\n    onChange: (value: Permission[]) => void;\n    /** Merge extra fields into deserialized form data (for CMS endpoints, resource scopes, etc.) */\n    deserialize?: (permissions: Permission[]) => Record<string, any>;\n    /** Transform or extend the core-serialized permissions (for CMS endpoints, resource scopes, etc.) */\n    serialize?: (formData: Record<string, any>, corePermissions: Permission[]) => Permission[];\n}\n\n/**\n * Return value of `usePermissionForm`.\n */\nexport interface UsePermissionFormResult {\n    formData: Record<string, any>;\n    onFormChange: (data: Record<string, any>) => void;\n}\n\n/**\n * Configuration for a permission renderer registered via AdminConfig.\n *\n * Either `schema` or `element` must be provided:\n * - `schema`: uses the built-in PermissionRenderer for auto-generated UI.\n * - `element`: uses a custom React element for full control.\n */\nexport type PermissionRendererConfig = PermissionRendererConfigBase &\n    (\n        | { schema: PermissionSchema; element?: never }\n        | { schema?: never; element: React.ReactElement }\n    );\n\ninterface PermissionRendererConfigBase {\n    name: string;\n    title: string;\n    description?: string;\n    icon?: React.ReactElement;\n    system?: boolean;\n}\n\n/**\n * Item that may have an owner (used for own-scope permission checks).\n */\nexport interface OwnableItem {\n    createdBy?: { id: string } | null;\n}\n\n/**\n * Extract the union of entity definitions from a schema config type.\n */\ntype EntitiesOf<S extends PermissionSchemaConfig> = S extends {\n    entities: ReadonlyArray<infer E extends EntityDefinition>;\n}\n    ? E\n    : never;\n\n/**\n * Extract entity IDs whose actions array contains an action with the given name.\n */\ntype EntityIdWithAction<S extends PermissionSchemaConfig, A extends string> = {\n    [K in EntitiesOf<S> as K extends { actions: ReadonlyArray<infer Act> }\n        ? Act extends { name: A }\n            ? K[\"id\"]\n            : never\n        : never]: never;\n} extends infer M\n    ? keyof M & string\n    : never;\n\n/**\n * Entity IDs that have the \"rwd\" action.\n */\nexport type RwdEntityId<S extends PermissionSchemaConfig> = EntityIdWithAction<S, \"rwd\">;\n\n/**\n * Entity IDs that have the \"pw\" action.\n */\nexport type PwEntityId<S extends PermissionSchemaConfig> = EntityIdWithAction<S, \"pw\">;\n\n/**\n * All entity IDs in the schema.\n */\nexport type AllEntityIds<S extends PermissionSchemaConfig> = EntitiesOf<S>[\"id\"];\n\n/**\n * Custom (non-builtin) action names across all entities.\n */\nexport type CustomActionNames<S extends PermissionSchemaConfig> = Exclude<\n    EntitiesOf<S> extends { actions: ReadonlyArray<infer Act extends ActionDefinition> }\n        ? Act[\"name\"]\n        : never,\n    \"rwd\" | \"pw\"\n>;\n\n/**\n * The return type of `usePermissions(schema)`.\n *\n * When the schema has literal entity types, methods are narrowed to only accept valid entity IDs.\n * When the schema is dynamically typed, all methods accept `string`.\n */\nexport type UsePermissionsResult<S extends PermissionSchemaConfig> =\n    string extends AllEntityIds<S> ? UsePermissionsResultUntyped : UsePermissionsResultTyped<S>;\n\nexport interface UsePermissionsResultUntyped {\n    canAccess: (entityId: string) => boolean;\n    canRead: (entityId: string) => boolean;\n    canCreate: (entityId: string) => boolean;\n    canEdit: (entityId: string, item?: OwnableItem) => boolean;\n    canDelete: (entityId: string, item?: OwnableItem) => boolean;\n    canPublish: (entityId: string) => boolean;\n    canUnpublish: (entityId: string) => boolean;\n    canAction: (action: string, entityId: string) => boolean;\n}\n\n/**\n * Action values accepted by `HasPermission`.\n *\n * Built-in actions are always available; custom action names from the schema are inferred automatically.\n */\nexport type HasPermissionAction<S extends PermissionSchemaConfig> =\n    | \"read\"\n    | \"create\"\n    | \"edit\"\n    | \"delete\"\n    | \"publish\"\n    | \"unpublish\"\n    | CustomActionNames<S>;\n\n/**\n * Action constraint for `HasPermission`.\n *\n * Exactly one of `action`, `someActions`, or `allActions` may be provided:\n * - `action` — single action; grants access if it passes.\n * - `someActions` — array; grants access if ANY action passes (OR).\n * - `allActions` — array; grants access only if ALL actions pass (AND).\n */\ntype ActionConstraint<S extends PermissionSchemaConfig> =\n    | { action?: HasPermissionAction<S>; someActions?: never; allActions?: never }\n    | { action?: never; someActions: NonEmptyArray<HasPermissionAction<S>>; allActions?: never }\n    | { action?: never; someActions?: never; allActions: NonEmptyArray<HasPermissionAction<S>> };\n\n/**\n * Props for a schema-bound `HasPermission` component created via `createHasPermission`.\n *\n * Exactly one of `entity`, `any`, or `all` must be provided.\n * Optionally combine with `action`, `someActions`, or `allActions`.\n */\nexport type HasPermissionProps<S extends PermissionSchemaConfig> = (\n    | SingleEntityProps<S>\n    | AnyEntitiesProps<S>\n    | AllEntitiesProps<S>\n) &\n    ActionConstraint<S>;\n\ninterface SingleEntityProps<S extends PermissionSchemaConfig> {\n    entity: AllEntityIds<S>;\n    any?: never;\n    all?: never;\n    children: React.ReactNode;\n}\n\ninterface AnyEntitiesProps<S extends PermissionSchemaConfig> {\n    entity?: never;\n    any: AllEntityIds<S>[];\n    all?: never;\n    children: React.ReactNode;\n}\n\ninterface AllEntitiesProps<S extends PermissionSchemaConfig> {\n    entity?: never;\n    any?: never;\n    all: AllEntityIds<S>[];\n    children: React.ReactNode;\n}\n\ntype UsePermissionsResultTyped<S extends PermissionSchemaConfig> = {\n    canAccess: (entityId: AllEntityIds<S>) => boolean;\n    canAction: (\n        action: CustomActionNames<S> extends never ? string : CustomActionNames<S>,\n        entityId: AllEntityIds<S>\n    ) => boolean;\n} & ([RwdEntityId<S>] extends [never]\n    ? {\n          canRead: (entityId: string) => boolean;\n          canCreate: (entityId: string) => boolean;\n          canEdit: (entityId: string, item?: OwnableItem) => boolean;\n          canDelete: (entityId: string, item?: OwnableItem) => boolean;\n      }\n    : {\n          canRead: (entityId: RwdEntityId<S>) => boolean;\n          canCreate: (entityId: RwdEntityId<S>) => boolean;\n          canEdit: (entityId: RwdEntityId<S>, item?: OwnableItem) => boolean;\n          canDelete: (entityId: RwdEntityId<S>, item?: OwnableItem) => boolean;\n      }) &\n    ([PwEntityId<S>] extends [never]\n        ? {\n              canPublish: (entityId: string) => boolean;\n              canUnpublish: (entityId: string) => boolean;\n          }\n        : {\n              canPublish: (entityId: PwEntityId<S>) => boolean;\n              canUnpublish: (entityId: PwEntityId<S>) => boolean;\n          });\n"],"mappings":"","ignoreList":[]}

package/presentation/buildParams/useBuildParams.d.ts

@@ -0,0 +1 @@
+export declare const useBuildParams: () => import("../../features/buildParams/abstractions").IBuildParams;

package/presentation/buildParams/useBuildParams.js

@@ -0,0 +1,7 @@
+import { useFeature } from "@webiny/app";
+import { BuildParamsFeature } from "../../features/buildParams/feature.js";
+export const useBuildParams = () => {
+  return useFeature(BuildParamsFeature);
+};
+
+//# sourceMappingURL=useBuildParams.js.map

package/presentation/buildParams/useBuildParams.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useFeature","BuildParamsFeature","useBuildParams"],"sources":["useBuildParams.ts"],"sourcesContent":["import { useFeature } from \"@webiny/app\";\nimport { BuildParamsFeature } from \"~/features/buildParams/feature.js\";\n\nexport const useBuildParams = () => {\n    return useFeature(BuildParamsFeature);\n};\n"],"mappings":"AAAA,SAASA,UAAU,QAAQ,aAAa;AACxC,SAASC,kBAAkB;AAE3B,OAAO,MAAMC,cAAc,GAAGA,CAAA,KAAM;EAChC,OAAOF,UAAU,CAACC,kBAAkB,CAAC;AACzC,CAAC","ignoreList":[]}