@wordpress/core-abilities 0.11.0 → 0.12.0

package/README.md

@@ -16,26 +16,18 @@ _This package assumes that your code will run in an ES2015+ environment. If you'
 
 ## Usage
 
-This package is designed to be loaded as a script module on WordPress admin pages. When loaded, it automatically:
+This package is designed to be loaded as a script module on WordPress admin pages. It exposes an `initialize()` function that, on first call:
 
-1. Fetches all ability categories from `/wp-abilities/v1/categories`
-2. Registers them with `@wordpress/abilities`
-3. Fetches all abilities from `/wp-abilities/v1/abilities`
-4. Registers them with a `callback` that handles execution via REST API
+1. Fetches all ability categories from `/wp-abilities/v1/categories` and registers them with `@wordpress/abilities`
+2. Fetches all abilities from `/wp-abilities/v1/abilities` and registers them with a `callback` that handles execution via REST API
 
-Simply import the package to initialize the WordPress abilities:
+Initialization is lazy: importing the package does not trigger network requests. Call `initialize()` from the feature that needs abilities — for example, when the workflow palette opens. Repeated calls return the same in-flight or resolved promise, so the requests fire at most once.
 
 ```js
-import '@wordpress/core-abilities';
-```
-
-Initialization is asynchronous because categories and abilities are fetched from the REST API. To wait for registration to finish before calling `getAbilities()` or `executeAbility()`, await the exported `ready` promise:
-
-```js
-import { ready } from '@wordpress/core-abilities';
+import { initialize } from '@wordpress/core-abilities';
 import { getAbilities, executeAbility } from '@wordpress/abilities';
 
-await ready;
+await initialize();
 
 console.log( getAbilities() );
 console.log( await executeAbility( 'core/get-site-info' ) );

package/build/index.cjs

@@ -30,7 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // packages/core-abilities/src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  ready: () => ready
+  initialize: () => initialize
 });
 module.exports = __toCommonJS(index_exports);
 var import_abilities = require("@wordpress/abilities");
@@ -111,13 +111,18 @@ async function initializeAbilities() {
     console.error("Failed to fetch abilities:", error);
   }
 }
-async function initialize() {
-  await initializeCategories();
-  await initializeAbilities();
+var initializePromise = null;
+function initialize() {
+  if (!initializePromise) {
+    initializePromise = (async () => {
+      await initializeCategories();
+      await initializeAbilities();
+    })();
+  }
+  return initializePromise;
 }
-var ready = initialize();
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  ready
+  initialize
 });
 //# sourceMappingURL=index.cjs.map

package/build/index.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/index.ts"],
-  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { registerAbility, registerAbilityCategory } from '@wordpress/abilities';\nimport type {\n\tAbility,\n\tAbilityCategory,\n\tAbilityInput,\n\tAbilityOutput,\n} from '@wordpress/abilities';\nimport apiFetch from '@wordpress/api-fetch';\nimport { addQueryArgs } from '@wordpress/url';\n\n/**\n * API endpoint constants.\n */\nconst API_BASE = '/wp-abilities/v1';\nconst ABILITIES_ENDPOINT = `${ API_BASE }/abilities`;\nconst CATEGORIES_ENDPOINT = `${ API_BASE }/categories`;\n\n/**\n * Creates a serverCallback function for a WordPress REST API ability.\n *\n * @param ability The ability to create a callback for.\n * @return The serverCallback function.\n */\nfunction createServerCallback(\n\tability: Ability\n): ( input: AbilityInput ) => Promise< AbilityOutput > {\n\treturn async ( input: AbilityInput ) => {\n\t\t// Determine HTTP method based on ability annotations\n\t\tlet method = 'POST';\n\t\tif ( !! ability.meta?.annotations?.readonly ) {\n\t\t\tmethod = 'GET';\n\t\t} else if (\n\t\t\t!! ability.meta?.annotations?.destructive &&\n\t\t\t!! ability.meta?.annotations?.idempotent\n\t\t) {\n\t\t\tmethod = 'DELETE';\n\t\t}\n\n\t\tlet path = `${ ABILITIES_ENDPOINT }/${ ability.name }/run`;\n\t\tconst options: {\n\t\t\tmethod: string;\n\t\t\tdata?: { input: AbilityInput };\n\t\t} = {\n\t\t\tmethod,\n\t\t};\n\n\t\tif (\n\t\t\t[ 'GET', 'DELETE' ].includes( method ) &&\n\t\t\tinput !== null &&\n\t\t\tinput !== undefined\n\t\t) {\n\t\t\t// For GET and DELETE requests, pass the input as query parameters.\n\t\t\tpath = addQueryArgs( path, { input } );\n\t\t} else if (\n\t\t\tmethod === 'POST' &&\n\t\t\tinput !== null &&\n\t\t\tinput !== undefined\n\t\t) {\n\t\t\toptions.data = { input };\n\t\t}\n\n\t\t// Input and output validation happens on the server side for these abilities.\n\t\treturn apiFetch< AbilityOutput >( {\n\t\t\tpath,\n\t\t\t...options,\n\t\t} );\n\t};\n}\n\n/**\n * Fetches and registers all ability categories from WordPress.\n */\nasync function initializeCategories(): Promise< void > {\n\ttry {\n\t\tconst categories = await apiFetch< AbilityCategory[] >( {\n\t\t\tpath: addQueryArgs( CATEGORIES_ENDPOINT, {\n\t\t\t\tper_page: -1,\n\t\t\t\tcontext: 'edit',\n\t\t\t} ),\n\t\t} );\n\n\t\tif ( categories && Array.isArray( categories ) ) {\n\t\t\tfor ( const category of categories ) {\n\t\t\t\tregisterAbilityCategory( category.slug, {\n\t\t\t\t\tlabel: category.label,\n\t\t\t\t\tdescription: category.description,\n\t\t\t\t\tmeta: {\n\t\t\t\t\t\tannotations: { serverRegistered: true },\n\t\t\t\t\t},\n\t\t\t\t} );\n\t\t\t}\n\t\t}\n\t} catch ( error ) {\n\t\t// eslint-disable-next-line no-console\n\t\tconsole.error( 'Failed to fetch ability categories:', error );\n\t}\n}\n\n/**\n * Fetches and registers all abilities from WordPress.\n */\nasync function initializeAbilities(): Promise< void > {\n\ttry {\n\t\tconst abilities = await apiFetch< Ability[] >( {\n\t\t\tpath: addQueryArgs( ABILITIES_ENDPOINT, {\n\t\t\t\tper_page: -1,\n\t\t\t\tcontext: 'edit',\n\t\t\t} ),\n\t\t} );\n\n\t\tif ( abilities && Array.isArray( abilities ) ) {\n\t\t\tfor ( const ability of abilities ) {\n\t\t\t\t// Register the ability with a callback\n\t\t\t\t// The abilities package filters annotations to allowed keys\n\t\t\t\tregisterAbility( {\n\t\t\t\t\t...ability,\n\t\t\t\t\tcallback: createServerCallback( ability ),\n\t\t\t\t\tmeta: {\n\t\t\t\t\t\tannotations: {\n\t\t\t\t\t\t\t...ability.meta?.annotations,\n\t\t\t\t\t\t\tserverRegistered: true,\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t} );\n\t\t\t}\n\t\t}\n\t} catch ( error ) {\n\t\t// eslint-disable-next-line no-console\n\t\tconsole.error( 'Failed to fetch abilities:', error );\n\t}\n}\n\n/**\n * Initialize WordPress abilities integration.\n */\nasync function initialize(): Promise< void > {\n\t// Fetch and register categories, then abilities\n\tawait initializeCategories();\n\tawait initializeAbilities();\n}\n\n// Auto-initialize on import.\nexport const ready: Promise< void > = initialize();\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,uBAAyD;AAOzD,uBAAqB;AACrB,iBAA6B;AAK7B,IAAM,WAAW;AACjB,IAAM,qBAAqB,GAAI,QAAS;AACxC,IAAM,sBAAsB,GAAI,QAAS;AAQzC,SAAS,qBACR,SACsD;AACtD,SAAO,OAAQ,UAAyB;AAEvC,QAAI,SAAS;AACb,QAAK,CAAC,CAAE,QAAQ,MAAM,aAAa,UAAW;AAC7C,eAAS;AAAA,IACV,WACC,CAAC,CAAE,QAAQ,MAAM,aAAa,eAC9B,CAAC,CAAE,QAAQ,MAAM,aAAa,YAC7B;AACD,eAAS;AAAA,IACV;AAEA,QAAI,OAAO,GAAI,kBAAmB,IAAK,QAAQ,IAAK;AACpD,UAAM,UAGF;AAAA,MACH;AAAA,IACD;AAEA,QACC,CAAE,OAAO,QAAS,EAAE,SAAU,MAAO,KACrC,UAAU,QACV,UAAU,QACT;AAED,iBAAO,yBAAc,MAAM,EAAE,MAAM,CAAE;AAAA,IACtC,WACC,WAAW,UACX,UAAU,QACV,UAAU,QACT;AACD,cAAQ,OAAO,EAAE,MAAM;AAAA,IACxB;AAGA,eAAO,iBAAAA,SAA2B;AAAA,MACjC;AAAA,MACA,GAAG;AAAA,IACJ,CAAE;AAAA,EACH;AACD;AAKA,eAAe,uBAAwC;AACtD,MAAI;AACH,UAAM,aAAa,UAAM,iBAAAA,SAA+B;AAAA,MACvD,UAAM,yBAAc,qBAAqB;AAAA,QACxC,UAAU;AAAA,QACV,SAAS;AAAA,MACV,CAAE;AAAA,IACH,CAAE;AAEF,QAAK,cAAc,MAAM,QAAS,UAAW,GAAI;AAChD,iBAAY,YAAY,YAAa;AACpC,sDAAyB,SAAS,MAAM;AAAA,UACvC,OAAO,SAAS;AAAA,UAChB,aAAa,SAAS;AAAA,UACtB,MAAM;AAAA,YACL,aAAa,EAAE,kBAAkB,KAAK;AAAA,UACvC;AAAA,QACD,CAAE;AAAA,MACH;AAAA,IACD;AAAA,EACD,SAAU,OAAQ;AAEjB,YAAQ,MAAO,uCAAuC,KAAM;AAAA,EAC7D;AACD;AAKA,eAAe,sBAAuC;AACrD,MAAI;AACH,UAAM,YAAY,UAAM,iBAAAA,SAAuB;AAAA,MAC9C,UAAM,yBAAc,oBAAoB;AAAA,QACvC,UAAU;AAAA,QACV,SAAS;AAAA,MACV,CAAE;AAAA,IACH,CAAE;AAEF,QAAK,aAAa,MAAM,QAAS,SAAU,GAAI;AAC9C,iBAAY,WAAW,WAAY;AAGlC,8CAAiB;AAAA,UAChB,GAAG;AAAA,UACH,UAAU,qBAAsB,OAAQ;AAAA,UACxC,MAAM;AAAA,YACL,aAAa;AAAA,cACZ,GAAG,QAAQ,MAAM;AAAA,cACjB,kBAAkB;AAAA,YACnB;AAAA,UACD;AAAA,QACD,CAAE;AAAA,MACH;AAAA,IACD;AAAA,EACD,SAAU,OAAQ;AAEjB,YAAQ,MAAO,8BAA8B,KAAM;AAAA,EACpD;AACD;AAKA,eAAe,aAA8B;AAE5C,QAAM,qBAAqB;AAC3B,QAAM,oBAAoB;AAC3B;AAGO,IAAM,QAAyB,WAAW;",
+  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { registerAbility, registerAbilityCategory } from '@wordpress/abilities';\nimport type {\n\tAbility,\n\tAbilityCategory,\n\tAbilityInput,\n\tAbilityOutput,\n} from '@wordpress/abilities';\nimport apiFetch from '@wordpress/api-fetch';\nimport { addQueryArgs } from '@wordpress/url';\n\n/**\n * API endpoint constants.\n */\nconst API_BASE = '/wp-abilities/v1';\nconst ABILITIES_ENDPOINT = `${ API_BASE }/abilities`;\nconst CATEGORIES_ENDPOINT = `${ API_BASE }/categories`;\n\n/**\n * Creates a serverCallback function for a WordPress REST API ability.\n *\n * @param ability The ability to create a callback for.\n * @return The serverCallback function.\n */\nfunction createServerCallback(\n\tability: Ability\n): ( input: AbilityInput ) => Promise< AbilityOutput > {\n\treturn async ( input: AbilityInput ) => {\n\t\t// Determine HTTP method based on ability annotations\n\t\tlet method = 'POST';\n\t\tif ( !! ability.meta?.annotations?.readonly ) {\n\t\t\tmethod = 'GET';\n\t\t} else if (\n\t\t\t!! ability.meta?.annotations?.destructive &&\n\t\t\t!! ability.meta?.annotations?.idempotent\n\t\t) {\n\t\t\tmethod = 'DELETE';\n\t\t}\n\n\t\tlet path = `${ ABILITIES_ENDPOINT }/${ ability.name }/run`;\n\t\tconst options: {\n\t\t\tmethod: string;\n\t\t\tdata?: { input: AbilityInput };\n\t\t} = {\n\t\t\tmethod,\n\t\t};\n\n\t\tif (\n\t\t\t[ 'GET', 'DELETE' ].includes( method ) &&\n\t\t\tinput !== null &&\n\t\t\tinput !== undefined\n\t\t) {\n\t\t\t// For GET and DELETE requests, pass the input as query parameters.\n\t\t\tpath = addQueryArgs( path, { input } );\n\t\t} else if (\n\t\t\tmethod === 'POST' &&\n\t\t\tinput !== null &&\n\t\t\tinput !== undefined\n\t\t) {\n\t\t\toptions.data = { input };\n\t\t}\n\n\t\t// Input and output validation happens on the server side for these abilities.\n\t\treturn apiFetch< AbilityOutput >( {\n\t\t\tpath,\n\t\t\t...options,\n\t\t} );\n\t};\n}\n\n/**\n * Fetches and registers all ability categories from WordPress.\n */\nasync function initializeCategories(): Promise< void > {\n\ttry {\n\t\tconst categories = await apiFetch< AbilityCategory[] >( {\n\t\t\tpath: addQueryArgs( CATEGORIES_ENDPOINT, {\n\t\t\t\tper_page: -1,\n\t\t\t\tcontext: 'edit',\n\t\t\t} ),\n\t\t} );\n\n\t\tif ( categories && Array.isArray( categories ) ) {\n\t\t\tfor ( const category of categories ) {\n\t\t\t\tregisterAbilityCategory( category.slug, {\n\t\t\t\t\tlabel: category.label,\n\t\t\t\t\tdescription: category.description,\n\t\t\t\t\tmeta: {\n\t\t\t\t\t\tannotations: { serverRegistered: true },\n\t\t\t\t\t},\n\t\t\t\t} );\n\t\t\t}\n\t\t}\n\t} catch ( error ) {\n\t\t// eslint-disable-next-line no-console\n\t\tconsole.error( 'Failed to fetch ability categories:', error );\n\t}\n}\n\n/**\n * Fetches and registers all abilities from WordPress.\n */\nasync function initializeAbilities(): Promise< void > {\n\ttry {\n\t\tconst abilities = await apiFetch< Ability[] >( {\n\t\t\tpath: addQueryArgs( ABILITIES_ENDPOINT, {\n\t\t\t\tper_page: -1,\n\t\t\t\tcontext: 'edit',\n\t\t\t} ),\n\t\t} );\n\n\t\tif ( abilities && Array.isArray( abilities ) ) {\n\t\t\tfor ( const ability of abilities ) {\n\t\t\t\t// Register the ability with a callback\n\t\t\t\t// The abilities package filters annotations to allowed keys\n\t\t\t\tregisterAbility( {\n\t\t\t\t\t...ability,\n\t\t\t\t\tcallback: createServerCallback( ability ),\n\t\t\t\t\tmeta: {\n\t\t\t\t\t\tannotations: {\n\t\t\t\t\t\t\t...ability.meta?.annotations,\n\t\t\t\t\t\t\tserverRegistered: true,\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t} );\n\t\t\t}\n\t\t}\n\t} catch ( error ) {\n\t\t// eslint-disable-next-line no-console\n\t\tconsole.error( 'Failed to fetch abilities:', error );\n\t}\n}\n\nlet initializePromise: Promise< void > | null = null;\n\n/**\n * Fetches and registers core abilities and their categories.\n *\n * Memoized: repeated calls return the same in-flight or resolved promise, so\n * callers can invoke it from multiple entry points without triggering duplicate\n * REST requests.\n */\nexport function initialize(): Promise< void > {\n\tif ( ! initializePromise ) {\n\t\tinitializePromise = ( async () => {\n\t\t\tawait initializeCategories();\n\t\t\tawait initializeAbilities();\n\t\t} )();\n\t}\n\treturn initializePromise;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,uBAAyD;AAOzD,uBAAqB;AACrB,iBAA6B;AAK7B,IAAM,WAAW;AACjB,IAAM,qBAAqB,GAAI,QAAS;AACxC,IAAM,sBAAsB,GAAI,QAAS;AAQzC,SAAS,qBACR,SACsD;AACtD,SAAO,OAAQ,UAAyB;AAEvC,QAAI,SAAS;AACb,QAAK,CAAC,CAAE,QAAQ,MAAM,aAAa,UAAW;AAC7C,eAAS;AAAA,IACV,WACC,CAAC,CAAE,QAAQ,MAAM,aAAa,eAC9B,CAAC,CAAE,QAAQ,MAAM,aAAa,YAC7B;AACD,eAAS;AAAA,IACV;AAEA,QAAI,OAAO,GAAI,kBAAmB,IAAK,QAAQ,IAAK;AACpD,UAAM,UAGF;AAAA,MACH;AAAA,IACD;AAEA,QACC,CAAE,OAAO,QAAS,EAAE,SAAU,MAAO,KACrC,UAAU,QACV,UAAU,QACT;AAED,iBAAO,yBAAc,MAAM,EAAE,MAAM,CAAE;AAAA,IACtC,WACC,WAAW,UACX,UAAU,QACV,UAAU,QACT;AACD,cAAQ,OAAO,EAAE,MAAM;AAAA,IACxB;AAGA,eAAO,iBAAAA,SAA2B;AAAA,MACjC;AAAA,MACA,GAAG;AAAA,IACJ,CAAE;AAAA,EACH;AACD;AAKA,eAAe,uBAAwC;AACtD,MAAI;AACH,UAAM,aAAa,UAAM,iBAAAA,SAA+B;AAAA,MACvD,UAAM,yBAAc,qBAAqB;AAAA,QACxC,UAAU;AAAA,QACV,SAAS;AAAA,MACV,CAAE;AAAA,IACH,CAAE;AAEF,QAAK,cAAc,MAAM,QAAS,UAAW,GAAI;AAChD,iBAAY,YAAY,YAAa;AACpC,sDAAyB,SAAS,MAAM;AAAA,UACvC,OAAO,SAAS;AAAA,UAChB,aAAa,SAAS;AAAA,UACtB,MAAM;AAAA,YACL,aAAa,EAAE,kBAAkB,KAAK;AAAA,UACvC;AAAA,QACD,CAAE;AAAA,MACH;AAAA,IACD;AAAA,EACD,SAAU,OAAQ;AAEjB,YAAQ,MAAO,uCAAuC,KAAM;AAAA,EAC7D;AACD;AAKA,eAAe,sBAAuC;AACrD,MAAI;AACH,UAAM,YAAY,UAAM,iBAAAA,SAAuB;AAAA,MAC9C,UAAM,yBAAc,oBAAoB;AAAA,QACvC,UAAU;AAAA,QACV,SAAS;AAAA,MACV,CAAE;AAAA,IACH,CAAE;AAEF,QAAK,aAAa,MAAM,QAAS,SAAU,GAAI;AAC9C,iBAAY,WAAW,WAAY;AAGlC,8CAAiB;AAAA,UAChB,GAAG;AAAA,UACH,UAAU,qBAAsB,OAAQ;AAAA,UACxC,MAAM;AAAA,YACL,aAAa;AAAA,cACZ,GAAG,QAAQ,MAAM;AAAA,cACjB,kBAAkB;AAAA,YACnB;AAAA,UACD;AAAA,QACD,CAAE;AAAA,MACH;AAAA,IACD;AAAA,EACD,SAAU,OAAQ;AAEjB,YAAQ,MAAO,8BAA8B,KAAM;AAAA,EACpD;AACD;AAEA,IAAI,oBAA4C;AASzC,SAAS,aAA8B;AAC7C,MAAK,CAAE,mBAAoB;AAC1B,yBAAsB,YAAY;AACjC,YAAM,qBAAqB;AAC3B,YAAM,oBAAoB;AAAA,IAC3B,GAAI;AAAA,EACL;AACA,SAAO;AACR;",
   "names": ["apiFetch"]
 }

package/build-module/index.mjs

@@ -77,12 +77,17 @@ async function initializeAbilities() {
     console.error("Failed to fetch abilities:", error);
   }
 }
-async function initialize() {
-  await initializeCategories();
-  await initializeAbilities();
+var initializePromise = null;
+function initialize() {
+  if (!initializePromise) {
+    initializePromise = (async () => {
+      await initializeCategories();
+      await initializeAbilities();
+    })();
+  }
+  return initializePromise;
 }
-var ready = initialize();
 export {
-  ready
+  initialize
 };
 //# sourceMappingURL=index.mjs.map

package/build-module/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/index.ts"],
-  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { registerAbility, registerAbilityCategory } from '@wordpress/abilities';\nimport type {\n\tAbility,\n\tAbilityCategory,\n\tAbilityInput,\n\tAbilityOutput,\n} from '@wordpress/abilities';\nimport apiFetch from '@wordpress/api-fetch';\nimport { addQueryArgs } from '@wordpress/url';\n\n/**\n * API endpoint constants.\n */\nconst API_BASE = '/wp-abilities/v1';\nconst ABILITIES_ENDPOINT = `${ API_BASE }/abilities`;\nconst CATEGORIES_ENDPOINT = `${ API_BASE }/categories`;\n\n/**\n * Creates a serverCallback function for a WordPress REST API ability.\n *\n * @param ability The ability to create a callback for.\n * @return The serverCallback function.\n */\nfunction createServerCallback(\n\tability: Ability\n): ( input: AbilityInput ) => Promise< AbilityOutput > {\n\treturn async ( input: AbilityInput ) => {\n\t\t// Determine HTTP method based on ability annotations\n\t\tlet method = 'POST';\n\t\tif ( !! ability.meta?.annotations?.readonly ) {\n\t\t\tmethod = 'GET';\n\t\t} else if (\n\t\t\t!! ability.meta?.annotations?.destructive &&\n\t\t\t!! ability.meta?.annotations?.idempotent\n\t\t) {\n\t\t\tmethod = 'DELETE';\n\t\t}\n\n\t\tlet path = `${ ABILITIES_ENDPOINT }/${ ability.name }/run`;\n\t\tconst options: {\n\t\t\tmethod: string;\n\t\t\tdata?: { input: AbilityInput };\n\t\t} = {\n\t\t\tmethod,\n\t\t};\n\n\t\tif (\n\t\t\t[ 'GET', 'DELETE' ].includes( method ) &&\n\t\t\tinput !== null &&\n\t\t\tinput !== undefined\n\t\t) {\n\t\t\t// For GET and DELETE requests, pass the input as query parameters.\n\t\t\tpath = addQueryArgs( path, { input } );\n\t\t} else if (\n\t\t\tmethod === 'POST' &&\n\t\t\tinput !== null &&\n\t\t\tinput !== undefined\n\t\t) {\n\t\t\toptions.data = { input };\n\t\t}\n\n\t\t// Input and output validation happens on the server side for these abilities.\n\t\treturn apiFetch< AbilityOutput >( {\n\t\t\tpath,\n\t\t\t...options,\n\t\t} );\n\t};\n}\n\n/**\n * Fetches and registers all ability categories from WordPress.\n */\nasync function initializeCategories(): Promise< void > {\n\ttry {\n\t\tconst categories = await apiFetch< AbilityCategory[] >( {\n\t\t\tpath: addQueryArgs( CATEGORIES_ENDPOINT, {\n\t\t\t\tper_page: -1,\n\t\t\t\tcontext: 'edit',\n\t\t\t} ),\n\t\t} );\n\n\t\tif ( categories && Array.isArray( categories ) ) {\n\t\t\tfor ( const category of categories ) {\n\t\t\t\tregisterAbilityCategory( category.slug, {\n\t\t\t\t\tlabel: category.label,\n\t\t\t\t\tdescription: category.description,\n\t\t\t\t\tmeta: {\n\t\t\t\t\t\tannotations: { serverRegistered: true },\n\t\t\t\t\t},\n\t\t\t\t} );\n\t\t\t}\n\t\t}\n\t} catch ( error ) {\n\t\t// eslint-disable-next-line no-console\n\t\tconsole.error( 'Failed to fetch ability categories:', error );\n\t}\n}\n\n/**\n * Fetches and registers all abilities from WordPress.\n */\nasync function initializeAbilities(): Promise< void > {\n\ttry {\n\t\tconst abilities = await apiFetch< Ability[] >( {\n\t\t\tpath: addQueryArgs( ABILITIES_ENDPOINT, {\n\t\t\t\tper_page: -1,\n\t\t\t\tcontext: 'edit',\n\t\t\t} ),\n\t\t} );\n\n\t\tif ( abilities && Array.isArray( abilities ) ) {\n\t\t\tfor ( const ability of abilities ) {\n\t\t\t\t// Register the ability with a callback\n\t\t\t\t// The abilities package filters annotations to allowed keys\n\t\t\t\tregisterAbility( {\n\t\t\t\t\t...ability,\n\t\t\t\t\tcallback: createServerCallback( ability ),\n\t\t\t\t\tmeta: {\n\t\t\t\t\t\tannotations: {\n\t\t\t\t\t\t\t...ability.meta?.annotations,\n\t\t\t\t\t\t\tserverRegistered: true,\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t} );\n\t\t\t}\n\t\t}\n\t} catch ( error ) {\n\t\t// eslint-disable-next-line no-console\n\t\tconsole.error( 'Failed to fetch abilities:', error );\n\t}\n}\n\n/**\n * Initialize WordPress abilities integration.\n */\nasync function initialize(): Promise< void > {\n\t// Fetch and register categories, then abilities\n\tawait initializeCategories();\n\tawait initializeAbilities();\n}\n\n// Auto-initialize on import.\nexport const ready: Promise< void > = initialize();\n"],
-  "mappings": ";AAGA,SAAS,iBAAiB,+BAA+B;AAOzD,OAAO,cAAc;AACrB,SAAS,oBAAoB;AAK7B,IAAM,WAAW;AACjB,IAAM,qBAAqB,GAAI,QAAS;AACxC,IAAM,sBAAsB,GAAI,QAAS;AAQzC,SAAS,qBACR,SACsD;AACtD,SAAO,OAAQ,UAAyB;AAEvC,QAAI,SAAS;AACb,QAAK,CAAC,CAAE,QAAQ,MAAM,aAAa,UAAW;AAC7C,eAAS;AAAA,IACV,WACC,CAAC,CAAE,QAAQ,MAAM,aAAa,eAC9B,CAAC,CAAE,QAAQ,MAAM,aAAa,YAC7B;AACD,eAAS;AAAA,IACV;AAEA,QAAI,OAAO,GAAI,kBAAmB,IAAK,QAAQ,IAAK;AACpD,UAAM,UAGF;AAAA,MACH;AAAA,IACD;AAEA,QACC,CAAE,OAAO,QAAS,EAAE,SAAU,MAAO,KACrC,UAAU,QACV,UAAU,QACT;AAED,aAAO,aAAc,MAAM,EAAE,MAAM,CAAE;AAAA,IACtC,WACC,WAAW,UACX,UAAU,QACV,UAAU,QACT;AACD,cAAQ,OAAO,EAAE,MAAM;AAAA,IACxB;AAGA,WAAO,SAA2B;AAAA,MACjC;AAAA,MACA,GAAG;AAAA,IACJ,CAAE;AAAA,EACH;AACD;AAKA,eAAe,uBAAwC;AACtD,MAAI;AACH,UAAM,aAAa,MAAM,SAA+B;AAAA,MACvD,MAAM,aAAc,qBAAqB;AAAA,QACxC,UAAU;AAAA,QACV,SAAS;AAAA,MACV,CAAE;AAAA,IACH,CAAE;AAEF,QAAK,cAAc,MAAM,QAAS,UAAW,GAAI;AAChD,iBAAY,YAAY,YAAa;AACpC,gCAAyB,SAAS,MAAM;AAAA,UACvC,OAAO,SAAS;AAAA,UAChB,aAAa,SAAS;AAAA,UACtB,MAAM;AAAA,YACL,aAAa,EAAE,kBAAkB,KAAK;AAAA,UACvC;AAAA,QACD,CAAE;AAAA,MACH;AAAA,IACD;AAAA,EACD,SAAU,OAAQ;AAEjB,YAAQ,MAAO,uCAAuC,KAAM;AAAA,EAC7D;AACD;AAKA,eAAe,sBAAuC;AACrD,MAAI;AACH,UAAM,YAAY,MAAM,SAAuB;AAAA,MAC9C,MAAM,aAAc,oBAAoB;AAAA,QACvC,UAAU;AAAA,QACV,SAAS;AAAA,MACV,CAAE;AAAA,IACH,CAAE;AAEF,QAAK,aAAa,MAAM,QAAS,SAAU,GAAI;AAC9C,iBAAY,WAAW,WAAY;AAGlC,wBAAiB;AAAA,UAChB,GAAG;AAAA,UACH,UAAU,qBAAsB,OAAQ;AAAA,UACxC,MAAM;AAAA,YACL,aAAa;AAAA,cACZ,GAAG,QAAQ,MAAM;AAAA,cACjB,kBAAkB;AAAA,YACnB;AAAA,UACD;AAAA,QACD,CAAE;AAAA,MACH;AAAA,IACD;AAAA,EACD,SAAU,OAAQ;AAEjB,YAAQ,MAAO,8BAA8B,KAAM;AAAA,EACpD;AACD;AAKA,eAAe,aAA8B;AAE5C,QAAM,qBAAqB;AAC3B,QAAM,oBAAoB;AAC3B;AAGO,IAAM,QAAyB,WAAW;",
+  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { registerAbility, registerAbilityCategory } from '@wordpress/abilities';\nimport type {\n\tAbility,\n\tAbilityCategory,\n\tAbilityInput,\n\tAbilityOutput,\n} from '@wordpress/abilities';\nimport apiFetch from '@wordpress/api-fetch';\nimport { addQueryArgs } from '@wordpress/url';\n\n/**\n * API endpoint constants.\n */\nconst API_BASE = '/wp-abilities/v1';\nconst ABILITIES_ENDPOINT = `${ API_BASE }/abilities`;\nconst CATEGORIES_ENDPOINT = `${ API_BASE }/categories`;\n\n/**\n * Creates a serverCallback function for a WordPress REST API ability.\n *\n * @param ability The ability to create a callback for.\n * @return The serverCallback function.\n */\nfunction createServerCallback(\n\tability: Ability\n): ( input: AbilityInput ) => Promise< AbilityOutput > {\n\treturn async ( input: AbilityInput ) => {\n\t\t// Determine HTTP method based on ability annotations\n\t\tlet method = 'POST';\n\t\tif ( !! ability.meta?.annotations?.readonly ) {\n\t\t\tmethod = 'GET';\n\t\t} else if (\n\t\t\t!! ability.meta?.annotations?.destructive &&\n\t\t\t!! ability.meta?.annotations?.idempotent\n\t\t) {\n\t\t\tmethod = 'DELETE';\n\t\t}\n\n\t\tlet path = `${ ABILITIES_ENDPOINT }/${ ability.name }/run`;\n\t\tconst options: {\n\t\t\tmethod: string;\n\t\t\tdata?: { input: AbilityInput };\n\t\t} = {\n\t\t\tmethod,\n\t\t};\n\n\t\tif (\n\t\t\t[ 'GET', 'DELETE' ].includes( method ) &&\n\t\t\tinput !== null &&\n\t\t\tinput !== undefined\n\t\t) {\n\t\t\t// For GET and DELETE requests, pass the input as query parameters.\n\t\t\tpath = addQueryArgs( path, { input } );\n\t\t} else if (\n\t\t\tmethod === 'POST' &&\n\t\t\tinput !== null &&\n\t\t\tinput !== undefined\n\t\t) {\n\t\t\toptions.data = { input };\n\t\t}\n\n\t\t// Input and output validation happens on the server side for these abilities.\n\t\treturn apiFetch< AbilityOutput >( {\n\t\t\tpath,\n\t\t\t...options,\n\t\t} );\n\t};\n}\n\n/**\n * Fetches and registers all ability categories from WordPress.\n */\nasync function initializeCategories(): Promise< void > {\n\ttry {\n\t\tconst categories = await apiFetch< AbilityCategory[] >( {\n\t\t\tpath: addQueryArgs( CATEGORIES_ENDPOINT, {\n\t\t\t\tper_page: -1,\n\t\t\t\tcontext: 'edit',\n\t\t\t} ),\n\t\t} );\n\n\t\tif ( categories && Array.isArray( categories ) ) {\n\t\t\tfor ( const category of categories ) {\n\t\t\t\tregisterAbilityCategory( category.slug, {\n\t\t\t\t\tlabel: category.label,\n\t\t\t\t\tdescription: category.description,\n\t\t\t\t\tmeta: {\n\t\t\t\t\t\tannotations: { serverRegistered: true },\n\t\t\t\t\t},\n\t\t\t\t} );\n\t\t\t}\n\t\t}\n\t} catch ( error ) {\n\t\t// eslint-disable-next-line no-console\n\t\tconsole.error( 'Failed to fetch ability categories:', error );\n\t}\n}\n\n/**\n * Fetches and registers all abilities from WordPress.\n */\nasync function initializeAbilities(): Promise< void > {\n\ttry {\n\t\tconst abilities = await apiFetch< Ability[] >( {\n\t\t\tpath: addQueryArgs( ABILITIES_ENDPOINT, {\n\t\t\t\tper_page: -1,\n\t\t\t\tcontext: 'edit',\n\t\t\t} ),\n\t\t} );\n\n\t\tif ( abilities && Array.isArray( abilities ) ) {\n\t\t\tfor ( const ability of abilities ) {\n\t\t\t\t// Register the ability with a callback\n\t\t\t\t// The abilities package filters annotations to allowed keys\n\t\t\t\tregisterAbility( {\n\t\t\t\t\t...ability,\n\t\t\t\t\tcallback: createServerCallback( ability ),\n\t\t\t\t\tmeta: {\n\t\t\t\t\t\tannotations: {\n\t\t\t\t\t\t\t...ability.meta?.annotations,\n\t\t\t\t\t\t\tserverRegistered: true,\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t} );\n\t\t\t}\n\t\t}\n\t} catch ( error ) {\n\t\t// eslint-disable-next-line no-console\n\t\tconsole.error( 'Failed to fetch abilities:', error );\n\t}\n}\n\nlet initializePromise: Promise< void > | null = null;\n\n/**\n * Fetches and registers core abilities and their categories.\n *\n * Memoized: repeated calls return the same in-flight or resolved promise, so\n * callers can invoke it from multiple entry points without triggering duplicate\n * REST requests.\n */\nexport function initialize(): Promise< void > {\n\tif ( ! initializePromise ) {\n\t\tinitializePromise = ( async () => {\n\t\t\tawait initializeCategories();\n\t\t\tawait initializeAbilities();\n\t\t} )();\n\t}\n\treturn initializePromise;\n}\n"],
+  "mappings": ";AAGA,SAAS,iBAAiB,+BAA+B;AAOzD,OAAO,cAAc;AACrB,SAAS,oBAAoB;AAK7B,IAAM,WAAW;AACjB,IAAM,qBAAqB,GAAI,QAAS;AACxC,IAAM,sBAAsB,GAAI,QAAS;AAQzC,SAAS,qBACR,SACsD;AACtD,SAAO,OAAQ,UAAyB;AAEvC,QAAI,SAAS;AACb,QAAK,CAAC,CAAE,QAAQ,MAAM,aAAa,UAAW;AAC7C,eAAS;AAAA,IACV,WACC,CAAC,CAAE,QAAQ,MAAM,aAAa,eAC9B,CAAC,CAAE,QAAQ,MAAM,aAAa,YAC7B;AACD,eAAS;AAAA,IACV;AAEA,QAAI,OAAO,GAAI,kBAAmB,IAAK,QAAQ,IAAK;AACpD,UAAM,UAGF;AAAA,MACH;AAAA,IACD;AAEA,QACC,CAAE,OAAO,QAAS,EAAE,SAAU,MAAO,KACrC,UAAU,QACV,UAAU,QACT;AAED,aAAO,aAAc,MAAM,EAAE,MAAM,CAAE;AAAA,IACtC,WACC,WAAW,UACX,UAAU,QACV,UAAU,QACT;AACD,cAAQ,OAAO,EAAE,MAAM;AAAA,IACxB;AAGA,WAAO,SAA2B;AAAA,MACjC;AAAA,MACA,GAAG;AAAA,IACJ,CAAE;AAAA,EACH;AACD;AAKA,eAAe,uBAAwC;AACtD,MAAI;AACH,UAAM,aAAa,MAAM,SAA+B;AAAA,MACvD,MAAM,aAAc,qBAAqB;AAAA,QACxC,UAAU;AAAA,QACV,SAAS;AAAA,MACV,CAAE;AAAA,IACH,CAAE;AAEF,QAAK,cAAc,MAAM,QAAS,UAAW,GAAI;AAChD,iBAAY,YAAY,YAAa;AACpC,gCAAyB,SAAS,MAAM;AAAA,UACvC,OAAO,SAAS;AAAA,UAChB,aAAa,SAAS;AAAA,UACtB,MAAM;AAAA,YACL,aAAa,EAAE,kBAAkB,KAAK;AAAA,UACvC;AAAA,QACD,CAAE;AAAA,MACH;AAAA,IACD;AAAA,EACD,SAAU,OAAQ;AAEjB,YAAQ,MAAO,uCAAuC,KAAM;AAAA,EAC7D;AACD;AAKA,eAAe,sBAAuC;AACrD,MAAI;AACH,UAAM,YAAY,MAAM,SAAuB;AAAA,MAC9C,MAAM,aAAc,oBAAoB;AAAA,QACvC,UAAU;AAAA,QACV,SAAS;AAAA,MACV,CAAE;AAAA,IACH,CAAE;AAEF,QAAK,aAAa,MAAM,QAAS,SAAU,GAAI;AAC9C,iBAAY,WAAW,WAAY;AAGlC,wBAAiB;AAAA,UAChB,GAAG;AAAA,UACH,UAAU,qBAAsB,OAAQ;AAAA,UACxC,MAAM;AAAA,YACL,aAAa;AAAA,cACZ,GAAG,QAAQ,MAAM;AAAA,cACjB,kBAAkB;AAAA,YACnB;AAAA,UACD;AAAA,QACD,CAAE;AAAA,MACH;AAAA,IACD;AAAA,EACD,SAAU,OAAQ;AAEjB,YAAQ,MAAO,8BAA8B,KAAM;AAAA,EACpD;AACD;AAEA,IAAI,oBAA4C;AASzC,SAAS,aAA8B;AAC7C,MAAK,CAAE,mBAAoB;AAC1B,yBAAsB,YAAY;AACjC,YAAM,qBAAqB;AAC3B,YAAM,oBAAoB;AAAA,IAC3B,GAAI;AAAA,EACL;AACA,SAAO;AACR;",
   "names": []
 }

package/build-types/index.d.ts

@@ -1,2 +1,9 @@
-export declare const ready: Promise<void>;
+/**
+ * Fetches and registers core abilities and their categories.
+ *
+ * Memoized: repeated calls return the same in-flight or resolved promise, so
+ * callers can invoke it from multiple entry points without triggering duplicate
+ * REST requests.
+ */
+export declare function initialize(): Promise<void>;
 //# sourceMappingURL=index.d.ts.map

package/build-types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiJA,eAAO,MAAM,KAAK,EAAE,OAAO,CAAE,IAAI,CAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAyIA;;;;;;GAMG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAAE,IAAI,CAAE,CAQ5C"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/core-abilities",
-	"version": "0.11.0",
+	"version": "0.12.0",
 	"description": "WordPress core abilities integration for the Abilities API.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",
@@ -46,12 +46,12 @@
 	"types": "build-types",
 	"sideEffects": true,
 	"dependencies": {
-		"@wordpress/abilities": "^0.12.0",
-		"@wordpress/api-fetch": "^7.46.0",
-		"@wordpress/url": "^4.46.0"
+		"@wordpress/abilities": "^0.13.0",
+		"@wordpress/api-fetch": "^7.47.0",
+		"@wordpress/url": "^4.47.0"
 	},
 	"publishConfig": {
 		"access": "public"
 	},
-	"gitHead": "51264e33b95fadff9a06b68141e674ce9cde9675"
+	"gitHead": "d653c5fd6161571a0c2ebde28553d6e25624eacc"
 }

package/src/index.ts

@@ -133,14 +133,21 @@ async function initializeAbilities(): Promise< void > {
 	}
 }
 
+let initializePromise: Promise< void > | null = null;
+
 /**
- * Initialize WordPress abilities integration.
+ * Fetches and registers core abilities and their categories.
+ *
+ * Memoized: repeated calls return the same in-flight or resolved promise, so
+ * callers can invoke it from multiple entry points without triggering duplicate
+ * REST requests.
  */
-async function initialize(): Promise< void > {
-	// Fetch and register categories, then abilities
-	await initializeCategories();
-	await initializeAbilities();
+export function initialize(): Promise< void > {
+	if ( ! initializePromise ) {
+		initializePromise = ( async () => {
+			await initializeCategories();
+			await initializeAbilities();
+		} )();
+	}
+	return initializePromise;
 }
-
-// Auto-initialize on import.
-export const ready: Promise< void > = initialize();