jmap-kit 0.0.0 → 1.0.2

package/dist/src/capabilities/vacationresponse-capability.d.ts

@@ -0,0 +1,65 @@
+import type { ValidationPlugin } from "../capability-registry/types.js";
+import { VACATIONRESPONSE_CAPABILITY_URI } from "../common/registry.js";
+/**
+ * Validates that invocations using the VacationResponse capability have a valid accountId that
+ * supports the VacationResponse capability.
+ *
+ * This plugin performs three critical validation checks:
+ * 1. Verifies the invocation includes a valid `accountId` argument (non-empty string)
+ * 2. Confirms the account exists in the session's accounts collection
+ * 3. Ensures the account's `accountCapabilities` includes the VacationResponse capability URI
+ *
+ * This validation applies to all VacationResponse capability invocations (VacationResponse/get
+ * and VacationResponse/set) and implements the account capability checks described in
+ * RFC 8621 Section 1.3.3.
+ *
+ * @see {@link https://www.rfc-editor.org/rfc/rfc8621.html#section-1.3.3 | RFC 8621 Section 1.3.3: The VacationResponse Capability}
+ */
+export declare const vacationResponseAccountSupportPlugin: ValidationPlugin<"invocation">;
+/**
+ * Defines the VacationResponse capability, including the VacationResponse invocations and
+ * validation plugins.
+ *
+ * Per RFC 8621 Section 1.3.3, the `urn:ietf:params:jmap:vacationresponse` capability represents
+ * support for the VacationResponse data type and associated API methods.
+ *
+ * Read-only account protection for VacationResponse/set is handled by Core's generic
+ * `preventSetOnReadOnlyAccountPlugin`.
+ *
+ * @see {@link https://www.rfc-editor.org/rfc/rfc8621.html#section-1.3.3 | RFC 8621 Section 1.3.3: The VacationResponse Capability}
+ */
+export declare const VacationResponseCapability: {
+    uri: "urn:ietf:params:jmap:vacationresponse";
+    invocations: {
+        VacationResponse: {
+            request: {
+                get: import("../index.js").InvocationFactory<import("./vacationresponse/types.js").VacationResponseGetRequestInvocationArgs, import("./vacationresponse/vacationresponse.js").VacationResponseInvocation<import("./vacationresponse/types.js").VacationResponseGetRequestInvocationArgs>>;
+                set: import("../index.js").InvocationFactory<import("./vacationresponse/types.js").VacationResponseSetRequestInvocationArgs, import("./vacationresponse/vacationresponse.js").VacationResponseInvocation<import("./vacationresponse/types.js").VacationResponseSetRequestInvocationArgs>>;
+            };
+            response: {
+                get: import("../index.js").InvocationFactory<import("./vacationresponse/types.js").VacationResponseGetResponseInvocationArgs, import("./vacationresponse/vacationresponse.js").VacationResponseInvocation<import("./vacationresponse/types.js").VacationResponseGetResponseInvocationArgs>>;
+                set: import("../index.js").InvocationFactory<import("./vacationresponse/types.js").VacationResponseSetResponseInvocationArgs, import("./vacationresponse/vacationresponse.js").VacationResponseInvocation<import("./vacationresponse/types.js").VacationResponseSetResponseInvocationArgs>>;
+            };
+        };
+    };
+    validators: {
+        name: string;
+        hook: "invocation";
+        trigger: {
+            capabilityUri?: import("../index.js").JMAPCapability;
+            dataType?: import("../index.js").JMAPDataType;
+            method?: import("../index.js").JMAPMethodName;
+        };
+        validate(this: void, context: import("../capability-registry/types.js").BasePluginContext & {
+            invocation: import("../index.js").Invocation<import("../index.js").BaseInvocationArgs>;
+        }): import("../index.js").MaybePromise<import("../capability-registry/types.js").ValidationResult>;
+    }[];
+};
+declare module "../common/types.js" {
+    interface ServerCapabilityRegistry {
+        [VACATIONRESPONSE_CAPABILITY_URI]?: EmptyObject;
+    }
+    interface AccountCapabilityRegistry {
+        [VACATIONRESPONSE_CAPABILITY_URI]?: EmptyObject;
+    }
+}

package/dist/src/capabilities/vacationresponse-capability.js

@@ -0,0 +1,68 @@
+import { VACATIONRESPONSE_CAPABILITY_URI } from "../common/registry.js";
+import { VacationResponse } from "./vacationresponse/vacationresponse.js";
+/**
+ * Validates that invocations using the VacationResponse capability have a valid accountId that
+ * supports the VacationResponse capability.
+ *
+ * This plugin performs three critical validation checks:
+ * 1. Verifies the invocation includes a valid `accountId` argument (non-empty string)
+ * 2. Confirms the account exists in the session's accounts collection
+ * 3. Ensures the account's `accountCapabilities` includes the VacationResponse capability URI
+ *
+ * This validation applies to all VacationResponse capability invocations (VacationResponse/get
+ * and VacationResponse/set) and implements the account capability checks described in
+ * RFC 8621 Section 1.3.3.
+ *
+ * @see {@link https://www.rfc-editor.org/rfc/rfc8621.html#section-1.3.3 | RFC 8621 Section 1.3.3: The VacationResponse Capability}
+ */
+export const vacationResponseAccountSupportPlugin = {
+    name: "vacationresponse-account-support",
+    hook: "invocation",
+    trigger: {
+        capabilityUri: VACATIONRESPONSE_CAPABILITY_URI,
+    },
+    validate(context) {
+        const { invocation, accounts } = context;
+        const accountId = invocation.getArgument("accountId");
+        if (typeof accountId !== "string" || accountId === "") {
+            return {
+                valid: false,
+                errors: [new Error(`Invocation is missing a valid accountId argument.`)],
+            };
+        }
+        const account = accounts[accountId];
+        if (!account) {
+            return {
+                valid: false,
+                errors: [new Error(`Account "${accountId}" does not exist.`)],
+            };
+        }
+        if (!account.accountCapabilities[VACATIONRESPONSE_CAPABILITY_URI]) {
+            return {
+                valid: false,
+                errors: [new Error(`Account "${accountId}" does not support the VacationResponse capability.`)],
+            };
+        }
+        return { valid: true };
+    },
+};
+/**
+ * Defines the VacationResponse capability, including the VacationResponse invocations and
+ * validation plugins.
+ *
+ * Per RFC 8621 Section 1.3.3, the `urn:ietf:params:jmap:vacationresponse` capability represents
+ * support for the VacationResponse data type and associated API methods.
+ *
+ * Read-only account protection for VacationResponse/set is handled by Core's generic
+ * `preventSetOnReadOnlyAccountPlugin`.
+ *
+ * @see {@link https://www.rfc-editor.org/rfc/rfc8621.html#section-1.3.3 | RFC 8621 Section 1.3.3: The VacationResponse Capability}
+ */
+export const VacationResponseCapability = {
+    uri: VACATIONRESPONSE_CAPABILITY_URI,
+    invocations: {
+        VacationResponse,
+    },
+    validators: [vacationResponseAccountSupportPlugin],
+};
+//# sourceMappingURL=vacationresponse-capability.js.map

package/dist/src/capabilities/vacationresponse-capability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vacationresponse-capability.js","sourceRoot":"","sources":["../../../src/capabilities/vacationresponse-capability.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,+BAA+B,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAE1E;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAmC;IAChF,IAAI,EAAE,kCAAkC;IACxC,IAAI,EAAE,YAAY;IAClB,OAAO,EAAE;QACL,aAAa,EAAE,+BAA+B;KACjD;IACD,QAAQ,CAAC,OAAO;QACZ,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;QACzC,MAAM,SAAS,GAAG,UAAU,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QACtD,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,EAAE,EAAE,CAAC;YACpD,OAAO;gBACH,KAAK,EAAE,KAAK;gBACZ,MAAM,EAAE,CAAC,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;aAC3E,CAAC;QACN,CAAC;QACD,MAAM,OAAO,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;QACpC,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,OAAO;gBACH,KAAK,EAAE,KAAK;gBACZ,MAAM,EAAE,CAAC,IAAI,KAAK,CAAC,YAAY,SAAS,mBAAmB,CAAC,CAAC;aAChE,CAAC;QACN,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,+BAA+B,CAAC,EAAE,CAAC;YAChE,OAAO;gBACH,KAAK,EAAE,KAAK;gBACZ,MAAM,EAAE,CAAC,IAAI,KAAK,CAAC,YAAY,SAAS,qDAAqD,CAAC,CAAC;aAClG,CAAC;QACN,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;CACJ,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACtC,GAAG,EAAE,+BAA+B;IACpC,WAAW,EAAE;QACT,gBAAgB;KACnB;IACD,UAAU,EAAE,CAAC,oCAAoC,CAAC;CACtB,CAAC"}

package/dist/src/capability-registry/capability-registry.d.ts

@@ -0,0 +1,148 @@
+import type { JMAPCapability, JMAPDataType, JMAPMethodName } from "../common/types.js";
+import type { GenericInvocationFactory, InvocationFactoryCollection } from "../invocation/types.js";
+import type { ClientContext } from "../jmap-client/types.js";
+import type { AccountCapabilityValidationResult, CapabilityDefinition, CapabilityRegistryInterface, PluginData, PluginLifecycleHook, ServerCapabilityValidationResult, TransformationPlugin, TransformerExecutionContext, ValidationPlugin, ValidationPluginLifecycleHook, ValidationResult, ValidatorExecutionContext } from "./types.js";
+/**
+ * Registry for managing JMAP capabilities
+ *
+ * The registry stores capability definitions and provides methods to register,
+ * unregister, and query capabilities.
+ * The Core capability is always registered and cannot be unregistered.
+ */
+export declare class CapabilityRegistry implements CapabilityRegistryInterface {
+    #private;
+    /**
+     * Creates a new CapabilityRegistry
+     *
+     * @param coreCapability The Core capability definition that will always be registered
+     * @param options Integration options including logger
+     */
+    constructor(coreCapability: CapabilityDefinition, { logger }: ClientContext);
+    /**
+     * Register a capability with the registry
+     *
+     * @param capability The capability definition to register
+     * @returns true if the capability was registered, false if it was already registered
+     */
+    register(capability: CapabilityDefinition): boolean;
+    /**
+     * Check if a capability is registered
+     *
+     * @param uri The URI of the capability to check
+     * @returns true if the capability is registered, false otherwise
+     */
+    has(uri: JMAPCapability): boolean;
+    /**
+     * Get a registered capability by URI
+     *
+     * @param uri The URI of the capability to get
+     * @returns The capability definition, or undefined if not registered
+     */
+    get(uri: JMAPCapability): CapabilityDefinition | undefined;
+    /**
+     * Get all registered capabilities
+     *
+     * @returns An array of all registered capability definitions
+     */
+    getAll(): CapabilityDefinition[];
+    /**
+     * Get all registered validation plugins for a specific hook
+     *
+     * @param hook The lifecycle hook to get validators for
+     * @returns An array of validation plugins for the specified hook
+     */
+    getValidatorsByHook<THook extends ValidationPluginLifecycleHook>(hook: THook): ValidationPlugin<THook>[];
+    /**
+     * Get all registered transformation plugins for a specific hook
+     *
+     * @param hook The lifecycle hook to get transformers for
+     * @returns An array of transformation plugins for the specified hook
+     */
+    getTransformersByHook<THook extends Exclude<PluginLifecycleHook, "pre-build">>(hook: THook): TransformationPlugin<THook>[];
+    /**
+     * Execute validators for the specified hook type
+     *
+     * Validates the provided context data against all registered validation plugins
+     * for the specified hook type.
+     *
+     * @param execution The validation execution context containing hook type and context data
+     * @returns A ValidationResult indicating whether the validation was successful or failed with errors
+     */
+    executeValidators<THook extends ValidationPluginLifecycleHook>({ hook, context, }: ValidatorExecutionContext<THook>): Promise<ValidationResult>;
+    /**
+     * Execute transformers for the pre-serialization hook
+     *
+     * @param options The transformer execution context containing hook type and context data
+     * @param options.hook The lifecycle hook to execute transformers for
+     * @param options.context The context data to transform
+     * @returns A Promise resolving to the transformed data
+     */
+    executeBuildTransformers({ hook, context, }: TransformerExecutionContext<"pre-serialization">): Promise<PluginData<"pre-serialization">>;
+    /**
+     * Execute transformers for the post-serialization hook
+     *
+     * @param options The transformer execution context containing hook type and context data
+     * @param options.hook The lifecycle hook to execute transformers for
+     * @param options.context The context data to transform
+     * @returns A Promise resolving to the transformed data
+     */
+    executeSerializationTransformers({ hook, context, }: TransformerExecutionContext<"post-serialization">): Promise<PluginData<"post-serialization">>;
+    /**
+     * Get the invocation factory collection for a specific data type
+     *
+     * @param dataType The JMAP data type to get factories for
+     * @returns The invocation factory collection for the data type, or undefined if not registered
+     */
+    getInvocationFactoryByDataType(dataType: JMAPDataType): InvocationFactoryCollection | undefined;
+    /**
+     * Get a specific invocation request factory by data type and method name
+     *
+     * @param dataType The JMAP data type
+     * @param methodName The JMAP method name
+     * @returns The invocation request factory function, or undefined if not found
+     */
+    getInvocationRequestFactory(dataType: JMAPDataType, methodName: JMAPMethodName): GenericInvocationFactory | undefined;
+    /**
+     * Get a specific invocation response factory by data type and method name
+     *
+     * @param dataType The JMAP data type
+     * @param methodName The JMAP method name
+     * @returns The invocation response factory function, or undefined if not found
+     */
+    getInvocationResponseFactory(dataType: JMAPDataType, methodName: JMAPMethodName): GenericInvocationFactory | undefined;
+    /**
+     * Validate server capability data against registered capability schemas.
+     *
+     * @param capabilities The server capabilities object from the parsed JMAP session
+     * @returns An array of validation failures (empty if all capabilities are valid)
+     */
+    validateServerCapabilities(capabilities: Record<string, unknown>): Promise<ServerCapabilityValidationResult[]>;
+    /**
+     * Validate account capability data against registered capability schemas.
+     *
+     * @param accounts The accounts object from the parsed JMAP session
+     * @returns An array of validation failures (empty if all account capabilities are valid)
+     */
+    validateAccountCapabilities(accounts: Record<string, {
+        accountCapabilities: Record<string, unknown>;
+    }>): Promise<AccountCapabilityValidationResult[]>;
+    /**
+     * Validate a single capability definition's schemas against session data
+     * without requiring the capability to be registered.
+     *
+     * @param capability The capability definition to validate
+     * @param serverCapabilities The server capabilities from the session
+     * @param accounts The accounts from the session
+     * @returns An object containing arrays of server and account capability validation failures
+     */
+    validateCapabilityDefinition(capability: CapabilityDefinition, serverCapabilities: Record<string, unknown>, accounts: Record<string, {
+        accountCapabilities: Record<string, unknown>;
+    }>): Promise<{
+        serverCapabilities: Extract<ServerCapabilityValidationResult, {
+            valid: false;
+        }>[];
+        accountCapabilities: Extract<AccountCapabilityValidationResult, {
+            valid: false;
+        }>[];
+    }>;
+}

package/dist/src/capability-registry/capability-registry.js

@@ -0,0 +1,360 @@
+import { CORE_CAPABILITY_URI } from "../common/registry.js";
+import { transformBuild, transformSerialization, validateInvocation, validateLifecycleHook, validateSerialization, } from "./utils.js";
+/**
+ * Registry for managing JMAP capabilities
+ *
+ * The registry stores capability definitions and provides methods to register,
+ * unregister, and query capabilities.
+ * The Core capability is always registered and cannot be unregistered.
+ */
+export class CapabilityRegistry {
+    #capabilities = new Map();
+    #logger;
+    #validationPlugins = {
+        invocation: new Set(),
+        "pre-build": new Set(),
+        "pre-serialization": new Set(),
+        "post-serialization": new Set(),
+    };
+    #transformationPlugins = {
+        "pre-serialization": new Set(),
+        "post-serialization": new Set(),
+    };
+    #invocationFactories = new Map();
+    /**
+     * Creates a new CapabilityRegistry
+     *
+     * @param coreCapability The Core capability definition that will always be registered
+     * @param options Integration options including logger
+     */
+    constructor(coreCapability, { logger }) {
+        if (coreCapability.uri !== CORE_CAPABILITY_URI) {
+            throw new Error(`Core capability URI mismatch: expected ${CORE_CAPABILITY_URI}, got ${coreCapability.uri}`);
+        }
+        this.#logger = logger;
+        this.#capabilities.set(CORE_CAPABILITY_URI, coreCapability);
+        this.#initializePluginMaps(coreCapability);
+    }
+    /**
+     * Initialise the plugin arrays with plugins from a capability
+     *
+     * @param capability The capability definition to add plugins from
+     */
+    #initializePluginMaps(capability) {
+        this.#addValidatorsFromCapability(capability);
+        this.#addTransformersFromCapability(capability);
+        this.#addInvocationFactoriesFromCapability(capability);
+    }
+    /**
+     * Add validators from a capability to the validators arrays
+     *
+     * @param capability The capability definition to add validators from
+     */
+    #addValidatorsFromCapability(capability) {
+        const validators = capability.validators ?? [];
+        // Sort validators by hook
+        for (const validator of validators) {
+            switch (validator.hook) {
+                case "pre-build": {
+                    this.#logger.debug(`Adding pre-build validator: ${validator.name}`);
+                    this.#validationPlugins["pre-build"].add(validator);
+                    break;
+                }
+                case "pre-serialization": {
+                    this.#logger.debug(`Adding pre-serialization validator: ${validator.name}`);
+                    this.#validationPlugins["pre-serialization"].add(validator);
+                    break;
+                }
+                case "post-serialization": {
+                    this.#logger.debug(`Adding post-serialization validator: ${validator.name}`);
+                    this.#validationPlugins["post-serialization"].add(validator);
+                    break;
+                }
+                case "invocation": {
+                    this.#logger.debug(`Adding invocation validator: ${validator.name}`);
+                    this.#validationPlugins.invocation.add(validator);
+                    break;
+                }
+            }
+        }
+    }
+    /**
+     * Add transformers from a capability to the transformers arrays
+     *
+     * @param capability The capability definition to add transformers from
+     */
+    #addTransformersFromCapability(capability) {
+        const transformers = capability.transformers ?? [];
+        // Sort transformers by hook
+        for (const transformer of transformers) {
+            if (transformer.hook === "pre-serialization") {
+                this.#transformationPlugins["pre-serialization"].add(transformer);
+            }
+            else {
+                this.#transformationPlugins["post-serialization"].add(transformer);
+            }
+        }
+    }
+    /**
+     * Add invocation factories from a capability to the invocation factory map
+     *
+     * This handles the special case where Blob data type methods can come from multiple capabilities.
+     * The Core capability includes Blob/copy, but other Blob methods may come from a separate
+     * Blob capability with a different URI.
+     *
+     * @param capability The capability definition to add invocation factories from
+     */
+    #addInvocationFactoriesFromCapability(capability) {
+        for (const [dataType, factoryCollection] of Object.entries(capability.invocations)) {
+            if (!factoryCollection)
+                continue;
+            const typedDataType = dataType;
+            const existingCollection = this.#invocationFactories.get(typedDataType);
+            if (existingCollection) {
+                // Merge with existing collection (for cases like Blob methods from multiple capabilities)
+                this.#logger.debug(`Merging invocation factories for data type: ${dataType}`);
+                // Merge request factories
+                Object.assign(existingCollection.request, factoryCollection.request);
+                // Merge response factories
+                Object.assign(existingCollection.response, factoryCollection.response);
+            }
+            else {
+                // Add new collection (create shallow copy to maintain immutability)
+                this.#logger.debug(`Adding invocation factory collection for data type: ${dataType}`);
+                const collectionCopy = {
+                    request: { ...factoryCollection.request },
+                    response: { ...factoryCollection.response },
+                };
+                this.#invocationFactories.set(typedDataType, collectionCopy);
+            }
+        }
+    }
+    /**
+     * Register a capability with the registry
+     *
+     * @param capability The capability definition to register
+     * @returns true if the capability was registered, false if it was already registered
+     */
+    register(capability) {
+        if (this.#capabilities.has(capability.uri)) {
+            return false;
+        }
+        this.#capabilities.set(capability.uri, capability);
+        this.#initializePluginMaps(capability);
+        return true;
+    }
+    /**
+     * Check if a capability is registered
+     *
+     * @param uri The URI of the capability to check
+     * @returns true if the capability is registered, false otherwise
+     */
+    has(uri) {
+        return this.#capabilities.has(uri);
+    }
+    /**
+     * Get a registered capability by URI
+     *
+     * @param uri The URI of the capability to get
+     * @returns The capability definition, or undefined if not registered
+     */
+    get(uri) {
+        return this.#capabilities.get(uri);
+    }
+    /**
+     * Get all registered capabilities
+     *
+     * @returns An array of all registered capability definitions
+     */
+    getAll() {
+        return Array.from(this.#capabilities.values());
+    }
+    /**
+     * Get all registered validation plugins for a specific hook
+     *
+     * @param hook The lifecycle hook to get validators for
+     * @returns An array of validation plugins for the specified hook
+     */
+    getValidatorsByHook(hook) {
+        return Array.from(this.#validationPlugins[hook]);
+    }
+    /**
+     * Get all registered transformation plugins for a specific hook
+     *
+     * @param hook The lifecycle hook to get transformers for
+     * @returns An array of transformation plugins for the specified hook
+     */
+    getTransformersByHook(hook) {
+        return Array.from(this.#transformationPlugins[hook]);
+    }
+    /**
+     * Execute validators for the specified hook type
+     *
+     * Validates the provided context data against all registered validation plugins
+     * for the specified hook type.
+     *
+     * @param execution The validation execution context containing hook type and context data
+     * @returns A ValidationResult indicating whether the validation was successful or failed with errors
+     */
+    executeValidators({ hook, context, }) {
+        // Check which hook type we're dealing with and call the appropriate method
+        if (hook === "invocation") {
+            const validators = this.getValidatorsByHook(hook);
+            return validateInvocation(context, validators);
+        }
+        else if (hook === "post-serialization") {
+            const validators = this.getValidatorsByHook(hook);
+            return validateSerialization(context, validators);
+        }
+        else {
+            // For pre-build and pre-serialization hooks
+            const validators = this.getValidatorsByHook(hook);
+            return validateLifecycleHook(hook, context, validators);
+        }
+    }
+    /**
+     * Execute transformers for the pre-serialization hook
+     *
+     * @param options The transformer execution context containing hook type and context data
+     * @param options.hook The lifecycle hook to execute transformers for
+     * @param options.context The context data to transform
+     * @returns A Promise resolving to the transformed data
+     */
+    executeBuildTransformers({ hook = "pre-serialization", context, }) {
+        const transformers = this.getTransformersByHook(hook);
+        return transformBuild(context, transformers);
+    }
+    /**
+     * Execute transformers for the post-serialization hook
+     *
+     * @param options The transformer execution context containing hook type and context data
+     * @param options.hook The lifecycle hook to execute transformers for
+     * @param options.context The context data to transform
+     * @returns A Promise resolving to the transformed data
+     */
+    executeSerializationTransformers({ hook = "post-serialization", context, }) {
+        const transformers = this.getTransformersByHook(hook);
+        return transformSerialization(context, transformers);
+    }
+    /**
+     * Get the invocation factory collection for a specific data type
+     *
+     * @param dataType The JMAP data type to get factories for
+     * @returns The invocation factory collection for the data type, or undefined if not registered
+     */
+    getInvocationFactoryByDataType(dataType) {
+        return this.#invocationFactories.get(dataType);
+    }
+    /**
+     * Get a specific invocation request factory by data type and method name
+     *
+     * @param dataType The JMAP data type
+     * @param methodName The JMAP method name
+     * @returns The invocation request factory function, or undefined if not found
+     */
+    getInvocationRequestFactory(dataType, methodName) {
+        const collection = this.#invocationFactories.get(dataType);
+        if (!collection) {
+            return undefined;
+        }
+        return collection.request[methodName];
+    }
+    /**
+     * Get a specific invocation response factory by data type and method name
+     *
+     * @param dataType The JMAP data type
+     * @param methodName The JMAP method name
+     * @returns The invocation response factory function, or undefined if not found
+     */
+    getInvocationResponseFactory(dataType, methodName) {
+        const collection = this.#invocationFactories.get(dataType);
+        if (!collection) {
+            return undefined;
+        }
+        return collection.response[methodName];
+    }
+    /**
+     * Validate server capability data against registered capability schemas.
+     *
+     * @param capabilities The server capabilities object from the parsed JMAP session
+     * @returns An array of validation failures (empty if all capabilities are valid)
+     */
+    async validateServerCapabilities(capabilities) {
+        const pending = [];
+        for (const { uri, schema } of this.#capabilities.values()) {
+            if (!schema?.serverCapability || !(uri in capabilities))
+                continue;
+            pending.push(CapabilityRegistry.#validateWithStandardSchema(schema.serverCapability, capabilities[uri]).then((result) => ({ ...result, uri })));
+        }
+        return Promise.all(pending);
+    }
+    /**
+     * Validate account capability data against registered capability schemas.
+     *
+     * @param accounts The accounts object from the parsed JMAP session
+     * @returns An array of validation failures (empty if all account capabilities are valid)
+     */
+    async validateAccountCapabilities(accounts) {
+        const pending = [];
+        for (const { uri, schema } of this.#capabilities.values()) {
+            if (!schema?.accountCapability)
+                continue;
+            for (const [accountId, account] of Object.entries(accounts)) {
+                if (!(uri in account.accountCapabilities))
+                    continue;
+                pending.push(CapabilityRegistry.#validateWithStandardSchema(schema.accountCapability, account.accountCapabilities[uri]).then((result) => ({ ...result, uri, accountId })));
+            }
+        }
+        return Promise.all(pending);
+    }
+    /**
+     * Validate a single capability definition's schemas against session data
+     * without requiring the capability to be registered.
+     *
+     * @param capability The capability definition to validate
+     * @param serverCapabilities The server capabilities from the session
+     * @param accounts The accounts from the session
+     * @returns An object containing arrays of server and account capability validation failures
+     */
+    async validateCapabilityDefinition(capability, serverCapabilities, accounts) {
+        const serverFailures = [];
+        const accountFailures = [];
+        const { uri, schema } = capability;
+        // Validate server capability schema
+        if (schema?.serverCapability && uri in serverCapabilities) {
+            const result = await CapabilityRegistry.#validateWithStandardSchema(schema.serverCapability, serverCapabilities[uri]);
+            if (!result.valid) {
+                serverFailures.push({ ...result, uri });
+            }
+        }
+        // Validate account capability schema
+        if (schema?.accountCapability) {
+            for (const [accountId, account] of Object.entries(accounts)) {
+                if (!(uri in account.accountCapabilities))
+                    continue;
+                const result = await CapabilityRegistry.#validateWithStandardSchema(schema.accountCapability, account.accountCapabilities[uri]);
+                if (!result.valid) {
+                    accountFailures.push({ ...result, uri, accountId });
+                }
+            }
+        }
+        return { serverCapabilities: serverFailures, accountCapabilities: accountFailures };
+    }
+    /**
+     * Validate a value against a StandardSchema and return a ValidationResult.
+     */
+    static async #validateWithStandardSchema(schema, value) {
+        const result = await schema["~standard"].validate(value);
+        if (result.issues) {
+            return {
+                valid: false,
+                errors: result.issues.map((issue) => {
+                    const path = issue.path?.map((p) => (typeof p === "object" ? p.key : p)).join(".") ?? "";
+                    return new Error(path ? `${path}: ${issue.message}` : issue.message);
+                }),
+            };
+        }
+        return { valid: true };
+    }
+}
+//# sourceMappingURL=capability-registry.js.map

package/dist/src/capability-registry/capability-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-registry.js","sourceRoot":"","sources":["../../../src/capability-registry/capability-registry.ts"],"names":[],"mappings":"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"}