@wordpress/abilities 0.1.1-next.dc3f6d3c1.0

package/README.md

@@ -0,0 +1,302 @@
+# WordPress Abilities API Client
+
+Client library for the WordPress Abilities API, providing a standardized way to discover and execute WordPress capabilities.
+
+## Table of Contents
+
+-   [Installation](#installation)
+-   [Usage](#usage)
+-   [API Reference](#api-reference)
+-   [Development and Testing](#development-and-testing)
+
+## Installation
+
+The client is currently available as a part of the Composer package.
+
+### As a WordPress Script
+
+When the Abilities API is installed, the client is automatically registered and enqueue in the admin.
+
+## Usage
+
+```javascript
+// In your WordPress plugin or theme JavaScript
+const { getAbilities, getAbility, executeAbility } = wp.abilities;
+// or import { getAbilities, getAbility, executeAbility } from '@wordpress/abilities'; depending on your setup
+
+// Get all abilities
+const abilities = await getAbilities();
+
+// Get a specific ability
+const ability = await getAbility( 'my-plugin/my-ability' );
+
+// Execute an ability
+const result = await executeAbility( 'my-plugin/my-ability', {
+	param1: 'value1',
+	param2: 'value2',
+} );
+```
+
+### Using with React and WordPress Data
+
+The client includes a data store that integrates with `@wordpress/data` for use in React components:
+
+```javascript
+import { useSelect } from '@wordpress/data';
+import { store as abilitiesStore } from '@wordpress/abilities';
+
+function MyComponent() {
+	const abilities = useSelect(
+		( select ) => select( abilitiesStore ).getAbilities(),
+		[]
+	);
+
+	const specificAbility = useSelect(
+		( select ) =>
+			select( abilitiesStore ).getAbility( 'my-plugin/my-ability' ),
+		[]
+	);
+
+	return (
+		<div>
+			<h2>All Abilities</h2>
+			<ul>
+				{ abilities.map( ( ability ) => (
+					<li key={ ability.name }>
+						<strong>{ ability.label }</strong>:{ ' ' }
+						{ ability.description }
+					</li>
+				) ) }
+			</ul>
+		</div>
+	);
+}
+```
+
+## API Reference
+
+### Functions
+
+#### `getAbilities( args: AbilitiesQueryArgs = {} ): Promise<Ability[]>`
+
+Returns all registered abilities. Optionally filter by category slug. Automatically handles pagination to fetch all abilities across multiple pages if needed.
+
+```javascript
+// Get all abilities
+const abilities = await getAbilities();
+console.log( `Found ${ abilities.length } abilities` );
+
+// Get abilities in a specific category
+const dataAbilities = await getAbilities( { category: 'data-retrieval' } );
+console.log( `Found ${ dataAbilities.length } data retrieval abilities` );
+```
+
+#### `getAbility( name: string ): Promise<Ability | null>`
+
+Returns a specific ability by name, or null if not found.
+
+```javascript
+const ability = await getAbility( 'my-plugin/create-post' );
+if ( ability ) {
+	console.log( `Found ability: ${ ability.label }` );
+}
+```
+
+#### `getAbilityCategories(): Promise<AbilityCategory[]>`
+
+Returns all registered ability categories. Categories are used to organize abilities into logical groups.
+
+```javascript
+const categories = await getAbilityCategories();
+console.log( `Found ${ categories.length } categories` );
+
+categories.forEach( ( category ) => {
+	console.log( `${ category.label }: ${ category.description }` );
+} );
+```
+
+#### `getAbilityCategory( slug: string ): Promise<AbilityCategory | null>`
+
+Returns a specific ability category by slug, or null if not found.
+
+```javascript
+const category = await getAbilityCategory( 'data-retrieval' );
+if ( category ) {
+	console.log( `Found category: ${ category.label }` );
+	console.log( `Description: ${ category.description }` );
+}
+```
+
+#### `registerAbility( ability: Ability ): Promise<void>`
+
+Registers a client-side ability. Client abilities are executed locally in the browser and must include a callback function and a valid category.
+
+```javascript
+import { registerAbility } from '@wordpress/abilities';
+
+await registerAbility( {
+	name: 'my-plugin/navigate',
+	label: 'Navigate to URL',
+	description: 'Navigates to a URL within WordPress admin',
+	category: 'navigation',
+	input_schema: {
+		type: 'object',
+		properties: {
+			url: { type: 'string' },
+		},
+		required: [ 'url' ],
+	},
+	callback: async ( { url } ) => {
+		window.location.href = url;
+		return { success: true };
+	},
+} );
+```
+
+#### `unregisterAbility( name: string ): void`
+
+Unregisters a client-side ability from the store.
+
+```javascript
+import { unregisterAbility } from '@wordpress/abilities';
+
+unregisterAbility( 'my-plugin/navigate' );
+```
+
+#### `registerAbilityCategory( slug: string, args: AbilityCategoryArgs ): Promise<void>`
+
+Registers a client-side ability category. This is useful when registering client-side abilities that introduce new categories not defined by the server.
+
+```javascript
+import { registerAbilityCategory } from '@wordpress/abilities';
+
+// Register a new category
+await registerAbilityCategory( 'block-editor', {
+	label: 'Block Editor',
+	description: 'Abilities for interacting with the WordPress block editor',
+} );
+
+// Register a category with optional metadata
+await registerAbilityCategory( 'custom-category', {
+	label: 'Custom Category',
+	description: 'A category for custom abilities',
+	meta: {
+		color: '#ff0000',
+	},
+} );
+
+// Then register abilities using the new category
+await registerAbility( {
+	name: 'my-plugin/insert-block',
+	label: 'Insert Block',
+	description: 'Inserts a block into the editor',
+	category: 'block-editor', // Uses the client-registered category
+	callback: async ( { blockType } ) => {
+		// Implementation
+		return { success: true };
+	},
+} );
+```
+
+#### `unregisterAbilityCategory( slug: string ): void`
+
+Unregisters an ability category from the store.
+
+```javascript
+import { unregisterAbilityCategory } from '@wordpress/abilities';
+
+unregisterAbilityCategory( 'block-editor' );
+```
+
+#### `executeAbility( name: string, input?: Record<string, any> ): Promise<any>`
+
+Executes an ability with optional input parameters. The HTTP method is automatically determined based on the ability's annotations:
+
+-   `readonly` abilities use GET (read-only operations)
+-   regular abilities use POST (write operations)
+
+```javascript
+// Execute a read-only ability (GET)
+const data = await executeAbility( 'my-plugin/get-data', {
+	id: 123,
+} );
+
+// Execute a regular ability (POST)
+const result = await executeAbility( 'my-plugin/create-item', {
+	title: 'New Item',
+	content: 'Item content',
+} );
+```
+
+### Store Selectors
+
+When using with `@wordpress/data`:
+
+-   `getAbilities( args: AbilitiesQueryArgs = {} )` - Returns all abilities from the store, optionally filtered by query arguments
+-   `getAbility( name: string )` - Returns a specific ability from the store
+-   `getAbilityCategories()` - Returns all categories from the store
+-   `getAbilityCategory( slug: string )` - Returns a specific category from the store
+
+```javascript
+import { useSelect } from '@wordpress/data';
+import { store as abilitiesStore } from '@wordpress/abilities';
+
+function MyComponent() {
+	// Get all abilities
+	const allAbilities = useSelect(
+		( select ) => select( abilitiesStore ).getAbilities(),
+		[]
+	);
+
+	// Get all categories
+	const categories = useSelect(
+		( select ) => select( abilitiesStore ).getAbilityCategories(),
+		[]
+	);
+
+	// Get abilities in a specific category
+	const dataAbilities = useSelect(
+		( select ) =>
+			select( abilitiesStore ).getAbilities( {
+				category: 'data-retrieval',
+			} ),
+		[]
+	);
+
+	// Get a specific category
+	const dataCategory = useSelect(
+		( select ) =>
+			select( abilitiesStore ).getAbilityCategory( 'data-retrieval' ),
+		[]
+	);
+
+	return (
+		<div>
+			<h2>All Abilities ({ allAbilities.length })</h2>
+			<h2>Categories ({ categories.length })</h2>
+			<ul>
+				{ categories.map( ( category ) => (
+					<li key={ category.slug }>
+						<strong>{ category.label }</strong>:{ ' ' }
+						{ category.description }
+					</li>
+				) ) }
+			</ul>
+			<h2>{ dataCategory?.label } Abilities</h2>
+			<ul>
+				{ dataAbilities.map( ( ability ) => (
+					<li key={ ability.name }>{ ability.label }</li>
+				) ) }
+			</ul>
+		</div>
+	);
+}
+```
+
+## Contributing to this package
+
+This is an individual package that's part of the Gutenberg project. The project is organized as a monorepo. It's made up of multiple self-contained software packages, each with a specific purpose. The packages in this monorepo are published to [npm](https://www.npmjs.com/) and used by [WordPress](https://make.wordpress.org/core/) as well as other software projects.
+
+To find out more about contributing to this package or Gutenberg as a whole, please read the project's main [contributor guide](https://github.com/WordPress/gutenberg/tree/HEAD/CONTRIBUTING.md).
+
+<br /><br /><p align="center"><img src="https://s.w.org/style/images/codeispoetry.png?1" alt="Code is Poetry." /></p>

package/build/api.js

@@ -0,0 +1,189 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// packages/abilities/src/api.ts
+var api_exports = {};
+__export(api_exports, {
+  executeAbility: () => executeAbility,
+  getAbilities: () => getAbilities,
+  getAbility: () => getAbility,
+  getAbilityCategories: () => getAbilityCategories,
+  getAbilityCategory: () => getAbilityCategory,
+  registerAbility: () => registerAbility,
+  registerAbilityCategory: () => registerAbilityCategory,
+  unregisterAbility: () => unregisterAbility,
+  unregisterAbilityCategory: () => unregisterAbilityCategory
+});
+module.exports = __toCommonJS(api_exports);
+var import_data = require("@wordpress/data");
+var import_api_fetch = __toESM(require("@wordpress/api-fetch"));
+var import_url = require("@wordpress/url");
+var import_i18n = require("@wordpress/i18n");
+var import_store = require("./store");
+var import_validation = require("./validation");
+async function getAbilities(args = {}) {
+  return await (0, import_data.resolveSelect)(import_store.store).getAbilities(args);
+}
+async function getAbility(name) {
+  return await (0, import_data.resolveSelect)(import_store.store).getAbility(name);
+}
+async function getAbilityCategories() {
+  return await (0, import_data.resolveSelect)(import_store.store).getAbilityCategories();
+}
+async function getAbilityCategory(slug) {
+  return await (0, import_data.resolveSelect)(import_store.store).getAbilityCategory(slug);
+}
+async function registerAbility(ability) {
+  await (0, import_data.dispatch)(import_store.store).registerAbility(ability);
+}
+function unregisterAbility(name) {
+  (0, import_data.dispatch)(import_store.store).unregisterAbility(name);
+}
+async function registerAbilityCategory(slug, args) {
+  await (0, import_data.dispatch)(import_store.store).registerAbilityCategory(slug, args);
+}
+function unregisterAbilityCategory(slug) {
+  (0, import_data.dispatch)(import_store.store).unregisterAbilityCategory(slug);
+}
+async function executeClientAbility(ability, input) {
+  if (!ability.callback) {
+    throw new Error(
+      (0, import_i18n.sprintf)(
+        "Client ability %s is missing callback function",
+        ability.name
+      )
+    );
+  }
+  if (ability.permissionCallback) {
+    const hasPermission = await ability.permissionCallback(input);
+    if (!hasPermission) {
+      const error = new Error(
+        (0, import_i18n.sprintf)("Permission denied for ability: %s", ability.name)
+      );
+      error.code = "ability_permission_denied";
+      throw error;
+    }
+  }
+  if (ability.input_schema) {
+    const inputValidation = (0, import_validation.validateValueFromSchema)(
+      input,
+      ability.input_schema,
+      "input"
+    );
+    if (inputValidation !== true) {
+      const error = new Error(
+        (0, import_i18n.sprintf)(
+          'Ability "%1$s" has invalid input. Reason: %2$s',
+          ability.name,
+          inputValidation
+        )
+      );
+      error.code = "ability_invalid_input";
+      throw error;
+    }
+  }
+  let result;
+  try {
+    result = await ability.callback(input);
+  } catch (error) {
+    console.error(
+      `Error executing client ability ${ability.name}:`,
+      error
+    );
+    throw error;
+  }
+  if (ability.output_schema) {
+    const outputValidation = (0, import_validation.validateValueFromSchema)(
+      result,
+      ability.output_schema,
+      "output"
+    );
+    if (outputValidation !== true) {
+      const error = new Error(
+        (0, import_i18n.sprintf)(
+          'Ability "%1$s" has invalid output. Reason: %2$s',
+          ability.name,
+          outputValidation
+        )
+      );
+      error.code = "ability_invalid_output";
+      throw error;
+    }
+  }
+  return result;
+}
+async function executeServerAbility(ability, input) {
+  let method = "POST";
+  if (!!ability.meta?.annotations?.readonly) {
+    method = "GET";
+  } else if (!!ability.meta?.annotations?.destructive && !!ability.meta?.annotations?.idempotent) {
+    method = "DELETE";
+  }
+  let path = `/wp-abilities/v1/abilities/${ability.name}/run`;
+  const options = {
+    method
+  };
+  if (["GET", "DELETE"].includes(method) && input !== null) {
+    path = (0, import_url.addQueryArgs)(path, { input });
+  } else if (method === "POST" && input !== null) {
+    options.data = { input };
+  }
+  try {
+    return await (0, import_api_fetch.default)({
+      path,
+      ...options
+    });
+  } catch (error) {
+    console.error(`Error executing ability ${ability.name}:`, error);
+    throw error;
+  }
+}
+async function executeAbility(name, input) {
+  const ability = await getAbility(name);
+  if (!ability) {
+    throw new Error((0, import_i18n.sprintf)("Ability not found: %s", name));
+  }
+  if (ability.callback) {
+    return executeClientAbility(ability, input);
+  }
+  return executeServerAbility(ability, input);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  executeAbility,
+  getAbilities,
+  getAbility,
+  getAbilityCategories,
+  getAbilityCategory,
+  registerAbility,
+  registerAbilityCategory,
+  unregisterAbility,
+  unregisterAbilityCategory
+});
+//# sourceMappingURL=api.js.map

package/build/api.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/api.ts"],
+  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { dispatch, resolveSelect } from '@wordpress/data';\nimport apiFetch from '@wordpress/api-fetch';\nimport { addQueryArgs } from '@wordpress/url';\nimport { sprintf } from '@wordpress/i18n';\n\n/**\n * Internal dependencies\n */\nimport { store } from './store';\nimport type {\n\tAbility,\n\tAbilityCategory,\n\tAbilityCategoryArgs,\n\tAbilitiesQueryArgs,\n\tAbilityInput,\n\tAbilityOutput,\n} from './types';\nimport { validateValueFromSchema } from './validation';\n\n/**\n * Get all available abilities with optional filtering.\n *\n * @param args Optional query arguments to filter. Defaults to empty object.\n * @return Promise resolving to array of abilities.\n */\nexport async function getAbilities(\n\targs: AbilitiesQueryArgs = {}\n): Promise< Ability[] > {\n\treturn await resolveSelect( store ).getAbilities( args );\n}\n\n/**\n * Get a specific ability by name.\n *\n * @param name The ability name.\n * @return Promise resolving to the ability or null if not found.\n */\nexport async function getAbility( name: string ): Promise< Ability | null > {\n\treturn await resolveSelect( store ).getAbility( name );\n}\n\n/**\n * Get all available ability categories.\n *\n * @return Promise resolving to array of categories.\n */\nexport async function getAbilityCategories(): Promise< AbilityCategory[] > {\n\treturn await resolveSelect( store ).getAbilityCategories();\n}\n\n/**\n * Get a specific ability category by slug.\n *\n * @param slug The category slug.\n * @return Promise resolving to the category or null if not found.\n */\nexport async function getAbilityCategory(\n\tslug: string\n): Promise< AbilityCategory | null > {\n\treturn await resolveSelect( store ).getAbilityCategory( slug );\n}\n\n/**\n * Register a client-side ability.\n *\n * Client abilities are executed locally in the browser and must include\n * a callback function. The ability will be validated by the store action,\n * and an error will be thrown if validation fails.\n *\n * Categories will be automatically fetched from the REST API if they\n * haven't been loaded yet, so you don't need to call getAbilityCategories()\n * before registering abilities.\n *\n * @param  ability The ability definition including callback.\n * @return Promise that resolves when registration is complete.\n * @throws {Error} If the ability fails validation.\n *\n * @example\n * ```js\n * await registerAbility({\n *   name: 'my-plugin/navigate',\n *   label: 'Navigate to URL',\n *   description: 'Navigates to a URL within WordPress admin',\n *   category: 'navigation',\n *   input_schema: {\n *     type: 'object',\n *     properties: {\n *       url: { type: 'string' }\n *     },\n *     required: ['url']\n *   },\n *   callback: async ({ url }) => {\n *     window.location.href = url;\n *     return { success: true };\n *   }\n * });\n * ```\n */\nexport async function registerAbility( ability: Ability ): Promise< void > {\n\tawait dispatch( store ).registerAbility( ability );\n}\n\n/**\n * Unregister an ability from the store.\n *\n * Remove a client-side ability from the store.\n * Note: This will return an error for server-side abilities.\n *\n * @param name The ability name to unregister.\n */\nexport function unregisterAbility( name: string ): void {\n\tdispatch( store ).unregisterAbility( name );\n}\n\n/**\n * Register a client-side ability category.\n *\n * Categories registered on the client are stored alongside server-side categories\n * in the same store and can be used when registering client side abilities.\n * This is useful when registering client-side abilities that introduce new\n * categories not defined by the server.\n *\n * Categories will be automatically fetched from the REST API if they haven't been\n * loaded yet to check for duplicates against server-side categories.\n *\n * @param  slug Category slug (lowercase alphanumeric with dashes only).\n * @param  args Category arguments (label, description, optional meta).\n * @return Promise that resolves when registration is complete.\n * @throws {Error} If the category fails validation.\n *\n * @example\n * ```js\n * // Register a new category for block editor abilities\n * await registerAbilityCategory('block-editor', {\n *   label: 'Block Editor',\n *   description: 'Abilities for interacting with the WordPress block editor'\n * });\n *\n * // Then register abilities using this category\n * await registerAbility({\n *   name: 'my-plugin/insert-block',\n *   label: 'Insert Block',\n *   description: 'Inserts a block into the editor',\n *   category: 'block-editor',\n *   callback: async ({ blockType }) => {\n *     // Implementation\n *     return { success: true };\n *   }\n * });\n * ```\n */\nexport async function registerAbilityCategory(\n\tslug: string,\n\targs: AbilityCategoryArgs\n): Promise< void > {\n\tawait dispatch( store ).registerAbilityCategory( slug, args );\n}\n\n/**\n * Unregister an ability category.\n *\n * Removes a category from the store.\n *\n * @param slug The category slug to unregister.\n *\n * @example\n * ```js\n * unregisterAbilityCategory('block-editor');\n * ```\n */\nexport function unregisterAbilityCategory( slug: string ): void {\n\tdispatch( store ).unregisterAbilityCategory( slug );\n}\n\n/**\n * Execute a client-side ability.\n *\n * @param ability The ability to execute.\n * @param input   Input parameters for the ability.\n * @return Promise resolving to the ability execution result.\n * @throws Error if validation fails or execution errors.\n */\nasync function executeClientAbility(\n\tability: Ability,\n\tinput: AbilityInput\n): Promise< AbilityOutput > {\n\tif ( ! ability.callback ) {\n\t\tthrow new Error(\n\t\t\tsprintf(\n\t\t\t\t'Client ability %s is missing callback function',\n\t\t\t\tability.name\n\t\t\t)\n\t\t);\n\t}\n\n\t// Check permission callback if defined\n\tif ( ability.permissionCallback ) {\n\t\tconst hasPermission = await ability.permissionCallback( input );\n\t\tif ( ! hasPermission ) {\n\t\t\tconst error = new Error(\n\t\t\t\tsprintf( 'Permission denied for ability: %s', ability.name )\n\t\t\t);\n\t\t\t( error as any ).code = 'ability_permission_denied';\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tif ( ability.input_schema ) {\n\t\tconst inputValidation = validateValueFromSchema(\n\t\t\tinput,\n\t\t\tability.input_schema,\n\t\t\t'input'\n\t\t);\n\t\tif ( inputValidation !== true ) {\n\t\t\tconst error = new Error(\n\t\t\t\tsprintf(\n\t\t\t\t\t'Ability \"%1$s\" has invalid input. Reason: %2$s',\n\t\t\t\t\tability.name,\n\t\t\t\t\tinputValidation\n\t\t\t\t)\n\t\t\t);\n\t\t\t( error as any ).code = 'ability_invalid_input';\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tlet result: AbilityOutput;\n\ttry {\n\t\tresult = await ability.callback( input );\n\t} catch ( error ) {\n\t\t// eslint-disable-next-line no-console\n\t\tconsole.error(\n\t\t\t`Error executing client ability ${ ability.name }:`,\n\t\t\terror\n\t\t);\n\t\tthrow error;\n\t}\n\n\tif ( ability.output_schema ) {\n\t\tconst outputValidation = validateValueFromSchema(\n\t\t\tresult,\n\t\t\tability.output_schema,\n\t\t\t'output'\n\t\t);\n\t\tif ( outputValidation !== true ) {\n\t\t\tconst error = new Error(\n\t\t\t\tsprintf(\n\t\t\t\t\t'Ability \"%1$s\" has invalid output. Reason: %2$s',\n\t\t\t\t\tability.name,\n\t\t\t\t\toutputValidation\n\t\t\t\t)\n\t\t\t);\n\t\t\t( error as any ).code = 'ability_invalid_output';\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\treturn result;\n}\n\n/**\n * Execute a server-side ability.\n *\n * @param ability The ability to execute.\n * @param input   Input parameters for the ability.\n * @return Promise resolving to the ability execution result.\n * @throws Error if the API call fails.\n */\nasync function executeServerAbility(\n\tability: Ability,\n\tinput: AbilityInput\n): Promise< AbilityOutput > {\n\tlet method = 'POST';\n\tif ( !! ability.meta?.annotations?.readonly ) {\n\t\tmethod = 'GET';\n\t} else if (\n\t\t!! ability.meta?.annotations?.destructive &&\n\t\t!! ability.meta?.annotations?.idempotent\n\t) {\n\t\tmethod = 'DELETE';\n\t}\n\n\tlet path = `/wp-abilities/v1/abilities/${ ability.name }/run`;\n\tconst options: {\n\t\tmethod: string;\n\t\tdata?: { input: AbilityInput };\n\t} = {\n\t\tmethod,\n\t};\n\n\tif ( [ 'GET', 'DELETE' ].includes( method ) && input !== null ) {\n\t\t// For GET and DELETE requests, pass the input directly.\n\t\tpath = addQueryArgs( path, { input } );\n\t} else if ( method === 'POST' && input !== null ) {\n\t\toptions.data = { input };\n\t}\n\n\t// Note: Input and output validation happens on the server side for these abilities.\n\ttry {\n\t\treturn await apiFetch< AbilityOutput >( {\n\t\t\tpath,\n\t\t\t...options,\n\t\t} );\n\t} catch ( error ) {\n\t\t// eslint-disable-next-line no-console\n\t\tconsole.error( `Error executing ability ${ ability.name }:`, error );\n\t\tthrow error;\n\t}\n}\n\n/**\n * Execute an ability.\n *\n * Determines whether to execute locally (client abilities) or remotely (server abilities)\n * based on whether the ability has a callback function.\n *\n * @param name  The ability name.\n * @param input Optional input parameters for the ability.\n * @return Promise resolving to the ability execution result.\n * @throws Error if the ability is not found or execution fails.\n */\nexport async function executeAbility(\n\tname: string,\n\tinput?: AbilityInput\n): Promise< AbilityOutput > {\n\tconst ability = await getAbility( name );\n\tif ( ! ability ) {\n\t\tthrow new Error( sprintf( 'Ability not found: %s', name ) );\n\t}\n\n\tif ( ability.callback ) {\n\t\treturn executeClientAbility( ability, input );\n\t}\n\n\treturn executeServerAbility( ability, input );\n}\n"],
+  "mappings": "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",
+  "names": ["apiFetch"]
+}

package/build/index.js

@@ -0,0 +1,53 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// packages/abilities/src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  executeAbility: () => import_api.executeAbility,
+  getAbilities: () => import_api.getAbilities,
+  getAbility: () => import_api.getAbility,
+  getAbilityCategories: () => import_api.getAbilityCategories,
+  getAbilityCategory: () => import_api.getAbilityCategory,
+  registerAbility: () => import_api.registerAbility,
+  registerAbilityCategory: () => import_api.registerAbilityCategory,
+  store: () => import_store.store,
+  unregisterAbility: () => import_api.unregisterAbility,
+  unregisterAbilityCategory: () => import_api.unregisterAbilityCategory,
+  validateValueFromSchema: () => import_validation.validateValueFromSchema
+});
+module.exports = __toCommonJS(index_exports);
+var import_api = require("./api");
+var import_store = require("./store");
+var import_validation = require("./validation");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  executeAbility,
+  getAbilities,
+  getAbility,
+  getAbilityCategories,
+  getAbilityCategory,
+  registerAbility,
+  registerAbilityCategory,
+  store,
+  unregisterAbility,
+  unregisterAbilityCategory,
+  validateValueFromSchema
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "sourcesContent": ["/**\n * WordPress Abilities API Client\n *\n * This package provides a client for interacting with the\n * WordPress Abilities API, allowing you to list, retrieve, and execute\n * abilities from client-side code.\n *\n * @package\n */\n\n/**\n * Public API functions\n */\nexport {\n\tgetAbilities,\n\tgetAbility,\n\tgetAbilityCategories,\n\tgetAbilityCategory,\n\texecuteAbility,\n\tregisterAbility,\n\tunregisterAbility,\n\tregisterAbilityCategory,\n\tunregisterAbilityCategory,\n} from './api';\n\n/**\n * The store can be used directly with @wordpress/data via selectors\n * in React components with useSelect.\n *\n * @example\n * ```js\n * import { useSelect } from '@wordpress/data';\n * import { store as abilitiesStore } from '@wordpress/abilities';\n *\n * function MyComponent() {\n *   const abilities = useSelect(\n *     (select) => select(abilitiesStore).getAbilities(),\n *     []\n *   );\n *   // Use abilities...\n * }\n * ```\n */\nexport { store } from './store';\n\n/**\n * Type definitions\n */\nexport type {\n\tAbility,\n\tAbilityCategory,\n\tAbilityCategoryArgs,\n\tAbilitiesState,\n\tAbilitiesQueryArgs,\n\tAbilityCallback,\n\tPermissionCallback,\n\tAbilityInput,\n\tAbilityOutput,\n\tValidationError,\n} from './types';\n\n/**\n * Validation utilities\n */\nexport { validateValueFromSchema } from './validation';\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAaA,iBAUO;AAoBP,mBAAsB;AAqBtB,wBAAwC;",
+  "names": []
+}