@wordpress/abilities 0.2.1-next.8b30e05b0.0 → 0.3.0

package/build-types/store/types.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Internal dependencies
+ */
+import type { Ability, AbilityCategory } from '../types';
+/**
+ * The state shape for the abilities store.
+ */
+export interface AbilitiesState {
+    /**
+     * Map of ability names to ability objects.
+     */
+    abilitiesByName: Record<string, Ability>;
+    /**
+     * Map of category slugs to category objects.
+     */
+    categoriesBySlug: Record<string, AbilityCategory>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/store/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B;;OAEG;IACH,eAAe,EAAE,MAAM,CAAE,MAAM,EAAE,OAAO,CAAE,CAAC;IAE3C;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAE,MAAM,EAAE,eAAe,CAAE,CAAC;CACpD"}

package/build-types/types.d.ts

@@ -50,28 +50,27 @@ export interface Ability {
      */
     output_schema?: Record<string, any>;
     /**
-     * Callback function for client-side abilities.
-     * If present, the ability will be executed locally in the browser.
-     * If not present, the ability will be executed via REST API on the server.
+     * Callback function for ability execution.
+     * This property is required for all abilities.
      */
     callback?: AbilityCallback;
     /**
-     * Client Permission callback for abilities.
+     * Permission callback for abilities.
      * Called before executing the ability to check if it's allowed.
      * If it returns false, the ability execution will be denied.
      */
     permissionCallback?: PermissionCallback;
     /**
      * Metadata about the ability.
-     * @see WP_Ability::get_meta()
      */
     meta?: {
         annotations?: {
-            readonly?: boolean | null;
-            destructive?: boolean | null;
-            idempotent?: boolean | null;
+            clientRegistered?: boolean;
+            serverRegistered?: boolean;
+            readonly?: boolean;
+            destructive?: boolean;
+            idempotent?: boolean;
         };
-        [key: string]: any;
     };
 }
 /**
@@ -108,9 +107,13 @@ export interface AbilityCategory {
     description: string;
     /**
      * Metadata about the category.
-     * @see WP_Ability_Category::get_meta()
      */
-    meta?: Record<string, any>;
+    meta?: {
+        annotations?: {
+            clientRegistered?: boolean;
+            serverRegistered?: boolean;
+        };
+    };
 }
 /**
  * Arguments for registering an ability category.
@@ -132,19 +135,6 @@ export interface AbilityCategoryArgs {
      */
     meta?: Record<string, any>;
 }
-/**
- * The state shape for the abilities store.
- */
-export interface AbilitiesState {
-    /**
-     * Map of ability names to ability objects.
-     */
-    abilitiesByName: Record<string, Ability>;
-    /**
-     * Map of category slugs to category objects.
-     */
-    categoriesBySlug: Record<string, AbilityCategory>;
-}
 /**
  * Input parameters for ability execution.
  * Can be any JSON-serializable value: primitive, array, object, or null.

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAC7B,KAAK,EAAE,YAAY,KACf,aAAa,GAAG,OAAO,CAAE,aAAa,CAAE,CAAC;AAE9C;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAChC,KAAK,CAAC,EAAE,YAAY,KAChB,OAAO,GAAG,OAAO,CAAE,OAAO,CAAE,CAAC;AAElC;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACvB;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAE,MAAM,EAAE,GAAG,CAAE,CAAC;IAErC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAE,MAAM,EAAE,GAAG,CAAE,CAAC;IAEtC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC;IAE3B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IAExC;;;OAGG;IACH,IAAI,CAAC,EAAE;QACN,WAAW,CAAC,EAAE;YACb,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;YAC1B,WAAW,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;YAC7B,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;SAC5B,CAAC;QACF,CAAE,GAAG,EAAE,MAAM,GAAI,GAAG,CAAC;KACrB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC/B;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAE,MAAM,EAAE,GAAG,CAAE,CAAC;CAC7B;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IACnC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAE,MAAM,EAAE,GAAG,CAAE,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B;;OAEG;IACH,eAAe,EAAE,MAAM,CAAE,MAAM,EAAE,OAAO,CAAE,CAAC;IAE3C;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAE,MAAM,EAAE,eAAe,CAAE,CAAC;CACpD;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,GAAG,CAAC;AAE/B;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,GAAG,CAAC;AAEhC;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAC7B,KAAK,EAAE,YAAY,KACf,aAAa,GAAG,OAAO,CAAE,aAAa,CAAE,CAAC;AAE9C;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAChC,KAAK,CAAC,EAAE,YAAY,KAChB,OAAO,GAAG,OAAO,CAAE,OAAO,CAAE,CAAC;AAElC;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACvB;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAE,MAAM,EAAE,GAAG,CAAE,CAAC;IAErC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAE,MAAM,EAAE,GAAG,CAAE,CAAC;IAEtC;;;OAGG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC;IAE3B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IAExC;;OAEG;IACH,IAAI,CAAC,EAAE;QACN,WAAW,CAAC,EAAE;YACb,gBAAgB,CAAC,EAAE,OAAO,CAAC;YAC3B,gBAAgB,CAAC,EAAE,OAAO,CAAC;YAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,WAAW,CAAC,EAAE,OAAO,CAAC;YACtB,UAAU,CAAC,EAAE,OAAO,CAAC;SACrB,CAAC;KACF,CAAC;CACF;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC/B;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,IAAI,CAAC,EAAE;QACN,WAAW,CAAC,EAAE;YACb,gBAAgB,CAAC,EAAE,OAAO,CAAC;YAC3B,gBAAgB,CAAC,EAAE,OAAO,CAAC;SAC3B,CAAC;KACF,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IACnC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAE,MAAM,EAAE,GAAG,CAAE,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,GAAG,CAAC;AAE/B;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,GAAG,CAAC;AAEhC;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/abilities",
-	"version": "0.2.1-next.8b30e05b0.0",
+	"version": "0.3.0",
 	"description": "JavaScript client for WordPress Abilities API.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",
@@ -45,11 +45,8 @@
 	},
 	"types": "build-types",
 	"dependencies": {
-		"@wordpress/api-fetch": "^7.36.1-next.8b30e05b0.0",
-		"@wordpress/core-data": "^7.36.1-next.8b30e05b0.0",
-		"@wordpress/data": "^10.36.1-next.8b30e05b0.0",
-		"@wordpress/i18n": "^6.9.1-next.8b30e05b0.0",
-		"@wordpress/url": "^4.36.1-next.8b30e05b0.0",
+		"@wordpress/data": "^10.37.0",
+		"@wordpress/i18n": "^6.10.0",
 		"ajv": "^8.17.1",
 		"ajv-draft-04": "^1.0.0",
 		"ajv-formats": "^3.0.1"
@@ -57,5 +54,5 @@
 	"publishConfig": {
 		"access": "public"
 	},
-	"gitHead": "2466f6bc223f8be98c55e1ac7270e8c3e413eaaf"
+	"gitHead": "2cf13ec6cf86153c9b3cf369bf5c59046f5cd950"
 }

package/src/api.ts

@@ -1,9 +1,7 @@
 /**
  * WordPress dependencies
  */
-import { dispatch, resolveSelect } from '@wordpress/data';
-import apiFetch from '@wordpress/api-fetch';
-import { addQueryArgs } from '@wordpress/url';
+import { dispatch, select } from '@wordpress/data';
 import { sprintf } from '@wordpress/i18n';
 
 /**
@@ -24,43 +22,41 @@ import { validateValueFromSchema } from './validation';
  * Get all available abilities with optional filtering.
  *
  * @param args Optional query arguments to filter. Defaults to empty object.
- * @return Promise resolving to array of abilities.
+ * @return Array of abilities.
  */
-export async function getAbilities(
-	args: AbilitiesQueryArgs = {}
-): Promise< Ability[] > {
-	return await resolveSelect( store ).getAbilities( args );
+export function getAbilities( args: AbilitiesQueryArgs = {} ): Ability[] {
+	return select( store ).getAbilities( args );
 }
 
 /**
  * Get a specific ability by name.
  *
  * @param name The ability name.
- * @return Promise resolving to the ability or null if not found.
+ * @return The ability or undefined if not found.
  */
-export async function getAbility( name: string ): Promise< Ability | null > {
-	return await resolveSelect( store ).getAbility( name );
+export function getAbility( name: string ): Ability | undefined {
+	return select( store ).getAbility( name );
 }
 
 /**
  * Get all available ability categories.
  *
- * @return Promise resolving to array of categories.
+ * @return Array of categories.
  */
-export async function getAbilityCategories(): Promise< AbilityCategory[] > {
-	return await resolveSelect( store ).getAbilityCategories();
+export function getAbilityCategories(): AbilityCategory[] {
+	return select( store ).getAbilityCategories();
 }
 
 /**
  * Get a specific ability category by slug.
  *
  * @param slug The category slug.
- * @return Promise resolving to the category or null if not found.
+ * @return The category or undefined if not found.
  */
-export async function getAbilityCategory(
+export function getAbilityCategory(
 	slug: string
-): Promise< AbilityCategory | null > {
-	return await resolveSelect( store ).getAbilityCategory( slug );
+): AbilityCategory | undefined {
+	return select( store ).getAbilityCategory( slug );
 }
 
 /**
@@ -70,17 +66,14 @@ export async function getAbilityCategory(
  * a callback function. The ability will be validated by the store action,
  * and an error will be thrown if validation fails.
  *
- * Categories will be automatically fetched from the REST API if they
- * haven't been loaded yet, so you don't need to call getAbilityCategories()
- * before registering abilities.
+ * The category must already be registered before registering abilities.
  *
  * @param  ability The ability definition including callback.
- * @return Promise that resolves when registration is complete.
  * @throws {Error} If the ability fails validation.
  *
  * @example
  * ```js
- * await registerAbility({
+ * registerAbility({
  *   name: 'my-plugin/navigate',
  *   label: 'Navigate to URL',
  *   description: 'Navigates to a URL within WordPress admin',
@@ -99,8 +92,8 @@ export async function getAbilityCategory(
  * });
  * ```
  */
-export async function registerAbility( ability: Ability ): Promise< void > {
-	await dispatch( store ).registerAbility( ability );
+export function registerAbility( ability: Ability ): void {
+	dispatch( store ).registerAbility( ability );
 }
 
 /**
@@ -123,24 +116,20 @@ export function unregisterAbility( name: string ): void {
  * This is useful when registering client-side abilities that introduce new
  * categories not defined by the server.
  *
- * Categories will be automatically fetched from the REST API if they haven't been
- * loaded yet to check for duplicates against server-side categories.
- *
  * @param  slug Category slug (lowercase alphanumeric with dashes only).
  * @param  args Category arguments (label, description, optional meta).
- * @return Promise that resolves when registration is complete.
  * @throws {Error} If the category fails validation.
  *
  * @example
  * ```js
  * // Register a new category for block editor abilities
- * await registerAbilityCategory('block-editor', {
+ * registerAbilityCategory('block-editor', {
  *   label: 'Block Editor',
  *   description: 'Abilities for interacting with the WordPress block editor'
  * });
  *
  * // Then register abilities using this category
- * await registerAbility({
+ * registerAbility({
  *   name: 'my-plugin/insert-block',
  *   label: 'Insert Block',
  *   description: 'Inserts a block into the editor',
@@ -152,11 +141,11 @@ export function unregisterAbility( name: string ): void {
  * });
  * ```
  */
-export async function registerAbilityCategory(
+export function registerAbilityCategory(
 	slug: string,
 	args: AbilityCategoryArgs
-): Promise< void > {
-	await dispatch( store ).registerAbilityCategory( slug, args );
+): void {
+	dispatch( store ).registerAbilityCategory( slug, args );
 }
 
 /**
@@ -176,21 +165,29 @@ export function unregisterAbilityCategory( slug: string ): void {
 }
 
 /**
- * Execute a client-side ability.
+ * Execute an ability.
  *
- * @param ability The ability to execute.
- * @param input   Input parameters for the ability.
+ * Executes abilities with validation for client-side abilities only.
+ * Server abilities bypass validation as it's handled on the server.
+ *
+ * @param name  The ability name.
+ * @param input Optional input parameters for the ability.
  * @return Promise resolving to the ability execution result.
- * @throws Error if validation fails or execution errors.
+ * @throws Error if the ability is not found or execution fails.
  */
-async function executeClientAbility(
-	ability: Ability,
-	input: AbilityInput
+export async function executeAbility(
+	name: string,
+	input?: AbilityInput
 ): Promise< AbilityOutput > {
+	const ability = getAbility( name );
+	if ( ! ability ) {
+		throw new Error( sprintf( 'Ability not found: %s', name ) );
+	}
+
 	if ( ! ability.callback ) {
 		throw new Error(
 			sprintf(
-				'Client ability %s is missing callback function',
+				'Ability "%s" is missing callback. Please ensure the ability is properly registered.',
 				ability.name
 			)
 		);
@@ -208,6 +205,7 @@ async function executeClientAbility(
 		}
 	}
 
+	// Validate input
 	if ( ability.input_schema ) {
 		const inputValidation = validateValueFromSchema(
 			input,
@@ -227,18 +225,17 @@ async function executeClientAbility(
 		}
 	}
 
+	// Execute the ability
 	let result: AbilityOutput;
 	try {
 		result = await ability.callback( input );
 	} catch ( error ) {
 		// eslint-disable-next-line no-console
-		console.error(
-			`Error executing client ability ${ ability.name }:`,
-			error
-		);
+		console.error( `Error executing ability ${ ability.name }:`, error );
 		throw error;
 	}
 
+	// Validate output
 	if ( ability.output_schema ) {
 		const outputValidation = validateValueFromSchema(
 			result,
@@ -260,80 +257,3 @@ async function executeClientAbility(
 
 	return result;
 }
-
-/**
- * Execute a server-side ability.
- *
- * @param ability The ability to execute.
- * @param input   Input parameters for the ability.
- * @return Promise resolving to the ability execution result.
- * @throws Error if the API call fails.
- */
-async function executeServerAbility(
-	ability: Ability,
-	input: AbilityInput
-): Promise< AbilityOutput > {
-	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: string;
-		data?: { input: AbilityInput };
-	} = {
-		method,
-	};
-
-	if ( [ 'GET', 'DELETE' ].includes( method ) && input !== null ) {
-		// For GET and DELETE requests, pass the input directly.
-		path = addQueryArgs( path, { input } );
-	} else if ( method === 'POST' && input !== null ) {
-		options.data = { input };
-	}
-
-	// Note: Input and output validation happens on the server side for these abilities.
-	try {
-		return await apiFetch< AbilityOutput >( {
-			path,
-			...options,
-		} );
-	} catch ( error ) {
-		// eslint-disable-next-line no-console
-		console.error( `Error executing ability ${ ability.name }:`, error );
-		throw error;
-	}
-}
-
-/**
- * Execute an ability.
- *
- * Determines whether to execute locally (client abilities) or remotely (server abilities)
- * based on whether the ability has a callback function.
- *
- * @param name  The ability name.
- * @param input Optional input parameters for the ability.
- * @return Promise resolving to the ability execution result.
- * @throws Error if the ability is not found or execution fails.
- */
-export async function executeAbility(
-	name: string,
-	input?: AbilityInput
-): Promise< AbilityOutput > {
-	const ability = await getAbility( name );
-	if ( ! ability ) {
-		throw new Error( sprintf( 'Ability not found: %s', name ) );
-	}
-
-	if ( ability.callback ) {
-		return executeClientAbility( ability, input );
-	}
-
-	return executeServerAbility( ability, input );
-}

package/src/index.ts

@@ -50,7 +50,6 @@ export type {
 	Ability,
 	AbilityCategory,
 	AbilityCategoryArgs,
-	AbilitiesState,
 	AbilitiesQueryArgs,
 	AbilityCallback,
 	PermissionCallback,

package/src/store/actions.ts

@@ -2,54 +2,50 @@
  * WordPress dependencies
  */
 import { sprintf } from '@wordpress/i18n';
-import { resolveSelect } from '@wordpress/data';
 
 /**
  * Internal dependencies
  */
 import type { Ability, AbilityCategory, AbilityCategoryArgs } from '../types';
 import {
-	RECEIVE_ABILITIES,
 	REGISTER_ABILITY,
 	UNREGISTER_ABILITY,
-	RECEIVE_CATEGORIES,
 	REGISTER_ABILITY_CATEGORY,
 	UNREGISTER_ABILITY_CATEGORY,
-	STORE_NAME,
+	ABILITY_NAME_PATTERN,
+	CATEGORY_SLUG_PATTERN,
 } from './constants';
 
-/**
- * Returns an action object used to receive abilities into the store.
- *
- * @param abilities Array of abilities to store.
- * @return Action object.
- */
-export function receiveAbilities( abilities: Ability[] ) {
-	return {
-		type: RECEIVE_ABILITIES,
-		abilities,
-	};
-}
+type AbilityAnnotations = NonNullable< Ability[ 'meta' ] >[ 'annotations' ];
 
 /**
- * Returns an action object used to receive categories into the store.
+ * Filters annotations to only include allowed keys with non-null values.
  *
- * @param categories Array of categories to store.
- * @return Action object.
+ * @param sourceAnnotations The source annotations object to filter.
+ * @param allowedKeys       Array of annotation keys to include.
+ * @return Filtered annotations object.
  */
-export function receiveCategories( categories: AbilityCategory[] ) {
-	return {
-		type: RECEIVE_CATEGORIES,
-		categories,
-	};
+function filterAnnotations< K extends keyof NonNullable< AbilityAnnotations > >(
+	sourceAnnotations: Record< string, boolean > | undefined,
+	allowedKeys: readonly K[]
+): NonNullable< AbilityAnnotations > {
+	const annotations: NonNullable< AbilityAnnotations > = {};
+
+	if ( sourceAnnotations ) {
+		for ( const key of allowedKeys ) {
+			if ( sourceAnnotations[ key ] !== undefined ) {
+				annotations[ key ] = sourceAnnotations[ key ];
+			}
+		}
+	}
+	return annotations;
 }
 
 /**
  * Registers an ability in the store.
  *
  * This action validates the ability before registration. If validation fails,
- * an error will be thrown. Categories will be automatically fetched from the
- * REST API if they haven't been loaded yet.
+ * an error will be thrown.
  *
  * @param  ability The ability to register.
  * @return Action object or function.
@@ -57,13 +53,13 @@ export function receiveCategories( categories: AbilityCategory[] ) {
  */
 export function registerAbility( ability: Ability ) {
 	// @ts-expect-error - registry types are not yet available
-	return async ( { select, dispatch } ) => {
+	return ( { select, dispatch } ) => {
 		if ( ! ability.name ) {
 			throw new Error( 'Ability name is required' );
 		}
 
 		// Validate name format matches server implementation
-		if ( ! /^[a-z0-9-]+\/[a-z0-9-]+$/.test( ability.name ) ) {
+		if ( ! ABILITY_NAME_PATTERN.test( ability.name ) ) {
 			throw new Error(
 				'Ability name must be a string containing a namespace prefix, i.e. "my-plugin/my-ability". It can only contain lowercase alphanumeric characters, dashes and the forward slash.'
 			);
@@ -88,19 +84,18 @@ export function registerAbility( ability: Ability ) {
 		}
 
 		// Validate category format
-		if ( ! /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test( ability.category ) ) {
+		if ( ! CATEGORY_SLUG_PATTERN.test( ability.category ) ) {
 			throw new Error(
 				sprintf(
-					'Ability "%1$s" has an invalid category. Category must be lowercase alphanumeric with dashes only Got: "%2$s"',
+					'Ability "%1$s" has an invalid category. Category must be lowercase alphanumeric with dashes only. Got: "%2$s"',
 					ability.name,
 					ability.category
 				)
 			);
 		}
 
-		// Ensure categories are loaded before validating
-		const categories =
-			await resolveSelect( STORE_NAME ).getAbilityCategories();
+		// Check that the category exists
+		const categories = select.getAbilityCategories();
 		const existingCategory = categories.find(
 			( cat: AbilityCategory ) => cat.slug === ability.category
 		);
@@ -132,10 +127,27 @@ export function registerAbility( ability: Ability ) {
 			);
 		}
 
+		const annotations = filterAnnotations( ability.meta?.annotations, [
+			'readonly',
+			'destructive',
+			'idempotent',
+			'serverRegistered',
+			'clientRegistered',
+		] );
+
+		if ( ! annotations.serverRegistered ) {
+			annotations.clientRegistered = true;
+		}
+
+		const meta = { annotations };
+
 		// All validation passed, dispatch the registration action
 		dispatch( {
 			type: REGISTER_ABILITY,
-			ability,
+			ability: {
+				...ability,
+				meta,
+			},
 		} );
 	};
 }
@@ -157,8 +169,7 @@ export function unregisterAbility( name: string ) {
  * Registers a client-side ability category in the store.
  *
  * This action validates the category before registration. If validation fails,
- * an error will be thrown. Categories will be automatically fetched from the
- * REST API if they haven't been loaded yet to check for duplicates.
+ * an error will be thrown.
  *
  * @param  slug The unique category slug identifier.
  * @param  args Category arguments (label, description, optional meta).
@@ -170,20 +181,19 @@ export function registerAbilityCategory(
 	args: AbilityCategoryArgs
 ) {
 	// @ts-expect-error - registry types are not yet available
-	return async ( { select, dispatch } ) => {
+	return ( { select, dispatch } ) => {
 		if ( ! slug ) {
 			throw new Error( 'Category slug is required' );
 		}
 
 		// Validate slug format matches server implementation
-		if ( ! /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test( slug ) ) {
+		if ( ! CATEGORY_SLUG_PATTERN.test( slug ) ) {
 			throw new Error(
 				'Category slug must contain only lowercase alphanumeric characters and dashes.'
 			);
 		}
 
-		// Ensure categories are loaded before checking for duplicates
-		await resolveSelect( STORE_NAME ).getAbilityCategories();
+		// Check for duplicates
 		const existingCategory = select.getAbilityCategory( slug );
 		if ( existingCategory ) {
 			throw new Error(
@@ -214,16 +224,21 @@ export function registerAbilityCategory(
 			);
 		}
 
+		const annotations = filterAnnotations( args.meta?.annotations, [
+			'serverRegistered',
+			'clientRegistered',
+		] );
+
+		if ( ! annotations.serverRegistered ) {
+			annotations.clientRegistered = true;
+		}
+
+		const meta = { annotations };
 		const category: AbilityCategory = {
 			slug,
 			label: args.label,
 			description: args.description,
-			meta: {
-				...( args.meta || {} ),
-				// Internal implementation note: Client-registered categories will have `meta._clientRegistered` set to `true` to differentiate them from server-fetched categories.
-				// This is used internally by the resolver to determine whether to fetch categories from the server.
-				_clientRegistered: true,
-			},
+			meta,
 		};
 
 		dispatch( {

package/src/store/constants.ts

@@ -2,14 +2,13 @@
  * Store constants
  */
 export const STORE_NAME = 'core/abilities';
-export const ENTITY_KIND = 'root';
-export const ENTITY_NAME = 'abilities';
-export const ENTITY_NAME_CATEGORIES = 'ability-categories';
+
+// Validation patterns
+export const ABILITY_NAME_PATTERN = /^[a-z0-9-]+\/[a-z0-9-]+$/;
+export const CATEGORY_SLUG_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
 
 // Action types
-export const RECEIVE_ABILITIES = 'RECEIVE_ABILITIES';
 export const REGISTER_ABILITY = 'REGISTER_ABILITY';
 export const UNREGISTER_ABILITY = 'UNREGISTER_ABILITY';
-export const RECEIVE_CATEGORIES = 'RECEIVE_CATEGORIES';
 export const REGISTER_ABILITY_CATEGORY = 'REGISTER_ABILITY_CATEGORY';
 export const UNREGISTER_ABILITY_CATEGORY = 'UNREGISTER_ABILITY_CATEGORY';