@enbox/agent 0.0.1

package/dist/esm/prototyping/clients/json-rpc-socket.js

@@ -0,0 +1,150 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { CryptoUtils } from '@enbox/crypto';
+import IsomorphicWebSocket from 'isomorphic-ws';
+import { createJsonRpcSubscriptionRequest, parseJson } from './json-rpc.js';
+// These were arbitrarily chosen, but can be modified via connect options
+const CONNECT_TIMEOUT = 3000;
+const RESPONSE_TIMEOUT = 30000;
+/**
+ * JSON RPC Socket Client for WebSocket request/response and long-running subscriptions.
+ *
+ * NOTE: This is temporarily copied over from https://github.com/TBD54566975/dwn-server/blob/main/src/json-rpc-socket.ts
+ * This was done in order to avoid taking a dependency on the `dwn-server`, until a future time when there will be a `clients` package.
+ */
+export class JsonRpcSocket {
+    constructor(socket, responseTimeout) {
+        this.socket = socket;
+        this.responseTimeout = responseTimeout;
+        this.messageHandlers = new Map();
+    }
+    static connect(url, options = {}) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { connectTimeout = CONNECT_TIMEOUT, responseTimeout = RESPONSE_TIMEOUT, onclose, onerror } = options;
+            const socket = new IsomorphicWebSocket(url);
+            if (!onclose) {
+                socket.onclose = () => {
+                    console.info(`JSON RPC Socket close ${url}`);
+                };
+            }
+            else {
+                socket.onclose = onclose;
+            }
+            if (!onerror) {
+                socket.onerror = (error) => {
+                    console.error(`JSON RPC Socket error ${url}`, error);
+                };
+            }
+            else {
+                socket.onerror = onerror;
+            }
+            return new Promise((resolve, reject) => {
+                socket.addEventListener('open', () => {
+                    const jsonRpcSocket = new JsonRpcSocket(socket, responseTimeout);
+                    socket.addEventListener('message', (event) => {
+                        const jsonRpcResponse = parseJson(event.data);
+                        const handler = jsonRpcSocket.messageHandlers.get(jsonRpcResponse.id);
+                        if (handler) {
+                            handler(event);
+                        }
+                    });
+                    resolve(jsonRpcSocket);
+                });
+                socket.addEventListener('error', (error) => {
+                    reject(error);
+                });
+                setTimeout(() => reject, connectTimeout);
+            });
+        });
+    }
+    close() {
+        this.socket.close();
+    }
+    /**
+     * Sends a JSON-RPC request through the socket and waits for a single response.
+     */
+    request(request) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => {
+                var _a;
+                (_a = request.id) !== null && _a !== void 0 ? _a : (request.id = CryptoUtils.randomUuid());
+                const handleResponse = (event) => {
+                    const jsonRpsResponse = parseJson(event.data);
+                    if (jsonRpsResponse.id === request.id) {
+                        // if the incoming response id matches the request id, we will remove the listener and resolve the response
+                        this.messageHandlers.delete(request.id);
+                        return resolve(jsonRpsResponse);
+                    }
+                };
+                // add the listener to the map of message handlers
+                this.messageHandlers.set(request.id, handleResponse);
+                this.send(request);
+                // reject this promise if we don't receive any response back within the timeout period
+                setTimeout(() => {
+                    this.messageHandlers.delete(request.id);
+                    reject(new Error('request timed out'));
+                }, this.responseTimeout);
+            });
+        });
+    }
+    /**
+     * Sends a JSON-RPC request through the socket and keeps a listener open to read associated responses as they arrive.
+     * Returns a close method to clean up the listener.
+     */
+    subscribe(request, listener) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!request.method.startsWith('rpc.subscribe.')) {
+                throw new Error('subscribe rpc requests must include the `rpc.subscribe` prefix');
+            }
+            if (!request.subscription) {
+                throw new Error('subscribe rpc requests must include subscribe options');
+            }
+            const subscriptionId = request.subscription.id;
+            const socketEventListener = (event) => {
+                const jsonRpcResponse = parseJson(event.data.toString());
+                if (jsonRpcResponse.id === subscriptionId) {
+                    if (jsonRpcResponse.error !== undefined) {
+                        // remove the event listener upon receipt of a JSON RPC Error.
+                        this.messageHandlers.delete(subscriptionId);
+                        this.closeSubscription(subscriptionId);
+                    }
+                    listener(jsonRpcResponse);
+                }
+            };
+            this.messageHandlers.set(subscriptionId, socketEventListener);
+            const response = yield this.request(request);
+            if (response.error) {
+                this.messageHandlers.delete(subscriptionId);
+                return { response };
+            }
+            // clean up listener and create a `rpc.subscribe.close` message to use when closing this JSON RPC subscription
+            const close = () => __awaiter(this, void 0, void 0, function* () {
+                this.messageHandlers.delete(subscriptionId);
+                yield this.closeSubscription(subscriptionId);
+            });
+            return {
+                response,
+                close
+            };
+        });
+    }
+    closeSubscription(id) {
+        const requestId = CryptoUtils.randomUuid();
+        const request = createJsonRpcSubscriptionRequest(requestId, 'close', id, {});
+        return this.request(request);
+    }
+    /**
+     * Sends a JSON-RPC request through the socket. You must subscribe to a message listener separately to capture the response.
+     */
+    send(request) {
+        this.socket.send(JSON.stringify(request));
+    }
+}
+//# sourceMappingURL=json-rpc-socket.js.map

package/dist/esm/prototyping/clients/json-rpc-socket.js.map

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

package/dist/esm/prototyping/clients/json-rpc.js

@@ -0,0 +1,58 @@
+export var JsonRpcErrorCodes;
+(function (JsonRpcErrorCodes) {
+    // JSON-RPC 2.0 pre-defined errors
+    JsonRpcErrorCodes[JsonRpcErrorCodes["InvalidRequest"] = -32600] = "InvalidRequest";
+    JsonRpcErrorCodes[JsonRpcErrorCodes["MethodNotFound"] = -32601] = "MethodNotFound";
+    JsonRpcErrorCodes[JsonRpcErrorCodes["InvalidParams"] = -32602] = "InvalidParams";
+    JsonRpcErrorCodes[JsonRpcErrorCodes["InternalError"] = -32603] = "InternalError";
+    JsonRpcErrorCodes[JsonRpcErrorCodes["ParseError"] = -32700] = "ParseError";
+    JsonRpcErrorCodes[JsonRpcErrorCodes["TransportError"] = -32300] = "TransportError";
+    // App defined errors
+    JsonRpcErrorCodes[JsonRpcErrorCodes["BadRequest"] = -50400] = "BadRequest";
+    JsonRpcErrorCodes[JsonRpcErrorCodes["Unauthorized"] = -50401] = "Unauthorized";
+    JsonRpcErrorCodes[JsonRpcErrorCodes["Forbidden"] = -50403] = "Forbidden";
+    JsonRpcErrorCodes[JsonRpcErrorCodes["Conflict"] = -50409] = "Conflict";
+})(JsonRpcErrorCodes || (JsonRpcErrorCodes = {}));
+export const createJsonRpcErrorResponse = (id, code, message, data) => {
+    const error = { code, message, data };
+    return {
+        jsonrpc: '2.0',
+        id,
+        error,
+    };
+};
+export const createJsonRpcRequest = (id, method, params) => {
+    return {
+        jsonrpc: '2.0',
+        id,
+        method,
+        params,
+    };
+};
+export const createJsonRpcSubscriptionRequest = (id, method, subscriptionId, params) => {
+    return {
+        jsonrpc: '2.0',
+        id,
+        method: `rpc.subscribe.${method}`,
+        params,
+        subscription: {
+            id: subscriptionId,
+        }
+    };
+};
+export const createJsonRpcSuccessResponse = (id, result) => {
+    return {
+        jsonrpc: '2.0',
+        id,
+        result,
+    };
+};
+export function parseJson(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch (_a) {
+        return null;
+    }
+}
+//# sourceMappingURL=json-rpc.js.map

package/dist/esm/prototyping/clients/json-rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-rpc.js","sourceRoot":"","sources":["../../../../src/prototyping/clients/json-rpc.ts"],"names":[],"mappings":"AAmBA,MAAM,CAAN,IAAY,iBAcX;AAdD,WAAY,iBAAiB;IAC3B,kCAAkC;IAClC,kFAAuB,CAAA;IACvB,kFAAuB,CAAA;IACvB,gFAAsB,CAAA;IACtB,gFAAsB,CAAA;IACtB,0EAAmB,CAAA;IACnB,kFAAuB,CAAA;IAEvB,qBAAqB;IACrB,0EAAmB,CAAA;IACnB,8EAAqB,CAAA;IACrB,wEAAkB,CAAA;IAClB,sEAAiB,CAAA;AACnB,CAAC,EAdW,iBAAiB,KAAjB,iBAAiB,QAc5B;AAkBD,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,EAAa,EACb,IAAuB,EACvB,OAAe,EACf,IAAU,EACY,EAAE;IACxB,MAAM,KAAK,GAAiB,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACpD,OAAO;QACL,OAAO,EAAE,KAAK;QACd,EAAE;QACF,KAAK;KACN,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,EAAa,EACb,MAAc,EACd,MAAsB,EACN,EAAE;IAClB,OAAO;QACL,OAAO,EAAE,KAAK;QACd,EAAE;QACF,MAAM;QACN,MAAM;KACP,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAC9C,EAAa,EACb,MAAc,EACd,cAAyB,EACzB,MAAY,EACI,EAAE;IAClB,OAAO;QACL,OAAO,EAAQ,KAAK;QACpB,EAAE;QACF,MAAM,EAAS,iBAAiB,MAAM,EAAE;QACxC,MAAM;QACN,YAAY,EAAG;YACb,EAAE,EAAE,cAAc;SACnB;KACF,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAC1C,EAAa,EACb,MAAW,EACa,EAAE;IAC1B,OAAO;QACL,OAAO,EAAE,KAAK;QACd,EAAE;QACF,MAAM;KACP,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;KACzB;IAAC,WAAM;QACN,OAAO,IAAI,CAAC;KACb;AACH,CAAC"}

package/dist/esm/prototyping/clients/server-info-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=server-info-types.js.map

package/dist/esm/prototyping/clients/server-info-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-info-types.js","sourceRoot":"","sources":["../../../../src/prototyping/clients/server-info-types.ts"],"names":[],"mappings":""}

package/dist/esm/prototyping/clients/web-socket-clients.js

@@ -0,0 +1,90 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { CryptoUtils } from '@enbox/crypto';
+import { createJsonRpcRequest, createJsonRpcSubscriptionRequest } from './json-rpc.js';
+import { JsonRpcSocket } from './json-rpc-socket.js';
+export class WebSocketDwnRpcClient {
+    get transportProtocols() { return ['ws:', 'wss:']; }
+    sendDwnRequest(request, jsonRpcSocketOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // validate that the dwn URL provided is a valid WebSocket URL
+            const url = new URL(request.dwnUrl);
+            if (url.protocol !== 'ws:' && url.protocol !== 'wss:') {
+                throw new Error(`Invalid websocket protocol ${url.protocol}`);
+            }
+            // check if there is already a connection to this host, if it does not exist, initiate a new connection
+            const hasConnection = WebSocketDwnRpcClient.connections.has(url.host);
+            if (!hasConnection) {
+                try {
+                    const socket = yield JsonRpcSocket.connect(url.toString(), jsonRpcSocketOptions);
+                    const subscriptions = new Map();
+                    WebSocketDwnRpcClient.connections.set(url.host, { socket, subscriptions });
+                }
+                catch (error) {
+                    throw new Error(`Error connecting to ${url.host}: ${error.message}`);
+                }
+            }
+            const connection = WebSocketDwnRpcClient.connections.get(url.host);
+            const { targetDid, message, subscriptionHandler } = request;
+            if (subscriptionHandler) {
+                return WebSocketDwnRpcClient.subscriptionRequest(connection, targetDid, message, subscriptionHandler);
+            }
+            return WebSocketDwnRpcClient.processMessage(connection, targetDid, message);
+        });
+    }
+    static processMessage(connection, target, message) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestId = CryptoUtils.randomUuid();
+            const request = createJsonRpcRequest(requestId, 'dwn.processMessage', { target, message });
+            const { socket } = connection;
+            const response = yield socket.request(request);
+            const { error, result } = response;
+            if (error !== undefined) {
+                throw new Error(`error sending DWN request: ${error.message}`);
+            }
+            return result.reply;
+        });
+    }
+    static subscriptionRequest(connection, target, message, messageHandler) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestId = CryptoUtils.randomUuid();
+            const subscriptionId = CryptoUtils.randomUuid();
+            const request = createJsonRpcSubscriptionRequest(requestId, 'dwn.processMessage', subscriptionId, { target, message });
+            const { socket, subscriptions } = connection;
+            const { response, close } = yield socket.subscribe(request, (response) => {
+                const { result, error } = response;
+                if (error) {
+                    // if there is an error, close the subscription and delete it from the connection
+                    const subscription = subscriptions.get(subscriptionId);
+                    if (subscription) {
+                        subscription.close();
+                    }
+                    subscriptions.delete(subscriptionId);
+                    return;
+                }
+                const { event } = result;
+                messageHandler(event);
+            });
+            const { error, result } = response;
+            if (error) {
+                throw new Error(`could not subscribe via jsonrpc socket: ${error.message}`);
+            }
+            const { reply } = result;
+            if (reply.subscription && close) {
+                subscriptions.set(subscriptionId, Object.assign(Object.assign({}, reply.subscription), { close }));
+                reply.subscription.close = close;
+            }
+            return reply;
+        });
+    }
+}
+// a map of dwn host to WebSocket connection
+WebSocketDwnRpcClient.connections = new Map();
+//# sourceMappingURL=web-socket-clients.js.map

package/dist/esm/prototyping/clients/web-socket-clients.js.map

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

package/dist/esm/prototyping/common/object.js

@@ -0,0 +1,14 @@
+export function hasDuplicateProperties(...objects) {
+    const propertySet = new Set();
+    const objectsWithoutUndefined = objects.filter(Boolean); // Remove any undefined values
+    for (const obj of objectsWithoutUndefined) {
+        for (const key in obj) {
+            if (propertySet.has(key)) {
+                return true; // Return true if a duplicate property is found
+            }
+            propertySet.add(key);
+        }
+    }
+    return false; // Return false if no duplicates are found
+}
+//# sourceMappingURL=object.js.map

package/dist/esm/prototyping/common/object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../../../../src/prototyping/common/object.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,sBAAsB,CAAC,GAAG,OAA+C;IACvF,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,MAAM,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,8BAA8B;IAEvF,KAAK,MAAM,GAAG,IAAI,uBAAuB,EAAE;QACzC,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE;YACrB,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;gBACxB,OAAO,IAAI,CAAC,CAAC,+CAA+C;aAC7D;YACD,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;SACtB;KACF;IAED,OAAO,KAAK,CAAC,CAAC,0CAA0C;AAC1D,CAAC"}

package/dist/esm/prototyping/common/type-utils.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=type-utils.js.map

package/dist/esm/prototyping/common/type-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-utils.js","sourceRoot":"","sources":["../../../../src/prototyping/common/type-utils.ts"],"names":[],"mappings":""}

package/dist/esm/prototyping/crypto/algorithms/aes-gcm.js

@@ -0,0 +1,147 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { AesGcm, CryptoAlgorithm } from '@enbox/crypto';
+/**
+ * The `AesGcmAlgorithm` class provides a concrete implementation for cryptographic operations using
+ * the AES algorithm in Galois/Counter Mode (GCM). This class implements both
+ * {@link Cipher | `Cipher`} and { @link KeyGenerator | `KeyGenerator`} interfaces, providing
+ * key generation, encryption, and decryption features.
+ *
+ * This class is typically accessed through implementations that extend the
+ * {@link CryptoApi | `CryptoApi`} interface.
+ */
+export class AesGcmAlgorithm extends CryptoAlgorithm {
+    bytesToPrivateKey({ privateKeyBytes }) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Convert the byte array to a JWK.
+            const privateKey = yield AesGcm.bytesToPrivateKey({ privateKeyBytes });
+            // Set the `alg` property based on the key length.
+            privateKey.alg = { 16: 'A128GCM', 24: 'A192GCM', 32: 'A256GCM' }[privateKeyBytes.length];
+            return privateKey;
+        });
+    }
+    /**
+     * Decrypts the provided data using AES-GCM.
+     *
+     * @remarks
+     * This method performs AES-GCM decryption on the given encrypted data using the specified key.
+     * It requires an initialization vector (IV), the encrypted data along with the decryption key,
+     * and optionally, additional authenticated data (AAD). The method returns the decrypted data as a
+     * Uint8Array. The optional `tagLength` parameter specifies the size in bits of the authentication
+     * tag used when encrypting the data. If not specified, the default tag length of 128 bits is
+     * used.
+     *
+     * @example
+     * ```ts
+     * const aesGcm = new AesGcmAlgorithm();
+     * const encryptedData = new Uint8Array([...]); // Encrypted data
+     * const iv = new Uint8Array([...]); // Initialization vector used during encryption
+     * const additionalData = new Uint8Array([...]); // Optional additional authenticated data
+     * const key = { ... }; // A Jwk object representing the AES key
+     * const decryptedData = await aesGcm.decrypt({
+     *   data: encryptedData,
+     *   iv,
+     *   additionalData,
+     *   key,
+     *   tagLength: 128 // Optional tag length in bits
+     * });
+     * ```
+     *
+     * @param params - The parameters for the decryption operation.
+     *
+     * @returns A Promise that resolves to the decrypted data as a Uint8Array.
+     */
+    decrypt(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const plaintext = AesGcm.decrypt(params);
+            return plaintext;
+        });
+    }
+    /**
+     * Encrypts the provided data using AES-GCM.
+     *
+     * @remarks
+     * This method performs AES-GCM encryption on the given data using the specified key.
+     * It requires an initialization vector (IV), the encrypted data along with the decryption key,
+     * and optionally, additional authenticated data (AAD). The method returns the encrypted data as a
+     * Uint8Array. The optional `tagLength` parameter specifies the size in bits of the authentication
+     * tag generated in the encryption operation and used for authentication in the corresponding
+     * decryption. If not specified, the default tag length of 128 bits is used.
+     *
+     * @example
+     * ```ts
+     * const aesGcm = new AesGcmAlgorithm();
+     * const data = new TextEncoder().encode('Messsage');
+     * const iv = new Uint8Array([...]); // Initialization vector
+     * const additionalData = new Uint8Array([...]); // Optional additional authenticated data
+     * const key = { ... }; // A Jwk object representing an AES key
+     * const encryptedData = await aesGcm.encrypt({
+     *   data,
+     *   iv,
+     *   additionalData,
+     *   key,
+     *   tagLength: 128 // Optional tag length in bits
+     * });
+     * ```
+     *
+     * @param params - The parameters for the encryption operation.
+     *
+     * @returns A Promise that resolves to the encrypted data as a Uint8Array.
+     */
+    encrypt(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const ciphertext = AesGcm.encrypt(params);
+            return ciphertext;
+        });
+    }
+    /**
+     * Generates a symmetric key for AES in Galois/Counter Mode (GCM) in JSON Web Key (JWK) format.
+     *
+     * @remarks
+     * This method generates a symmetric AES key for use in GCM mode, based on the specified
+     * `algorithm` parameter which determines the key length. It uses cryptographically secure random
+     * number generation to ensure the uniqueness and security of the key. The key is returned in JWK
+     * format.
+     *
+     * The generated key includes the following components:
+     * - `kty`: Key Type, set to 'oct' for Octet Sequence.
+     * - `k`: The symmetric key component, base64url-encoded.
+     * - `kid`: Key ID, generated based on the JWK thumbprint.
+     *
+     * @example
+     * ```ts
+     * const aesGcm = new AesGcmAlgorithm();
+     * const privateKey = await aesGcm.generateKey({ algorithm: 'A256GCM' });
+     * ```
+     *
+     * @param params - The parameters for the key generation.
+     *
+     * @returns A Promise that resolves to the generated symmetric key in JWK format.
+     */
+    generateKey({ algorithm }) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Map algorithm name to key length.
+            const length = { A128GCM: 128, A192GCM: 192, A256GCM: 256 }[algorithm];
+            // Generate a random private key.
+            const privateKey = yield AesGcm.generateKey({ length });
+            // Set the `alg` property based on the specified algorithm.
+            privateKey.alg = algorithm;
+            return privateKey;
+        });
+    }
+    privateKeyToBytes({ privateKey }) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Convert the JWK to a byte array.
+            const privateKeyBytes = yield AesGcm.privateKeyToBytes({ privateKey });
+            return privateKeyBytes;
+        });
+    }
+}
+//# sourceMappingURL=aes-gcm.js.map

package/dist/esm/prototyping/crypto/algorithms/aes-gcm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aes-gcm.js","sourceRoot":"","sources":["../../../../../src/prototyping/crypto/algorithms/aes-gcm.ts"],"names":[],"mappings":";;;;;;;;;AAUA,OAAO,EAAE,MAAM,EAAuB,eAAe,EAAE,MAAM,eAAe,CAAC;AAqD7E;;;;;;;;GAQG;AACH,MAAM,OAAO,eAAgB,SAAQ,eAAe;IAKrC,iBAAiB,CAAC,EAAE,eAAe,EAA2B;;YACzE,mCAAmC;YACnC,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,EAAE,eAAe,EAAE,CAAC,CAAC;YAEvE,kDAAkD;YAClD,UAAU,CAAC,GAAG,GAAG,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;YAEzF,OAAO,UAAU,CAAC;QACpB,CAAC;KAAA;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACU,OAAO,CAAC,MACS;;YAE5B,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAEzC,OAAO,SAAS,CAAC;QACnB,CAAC;KAAA;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACU,OAAO,CAAC,MACS;;YAE5B,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAE1C,OAAO,UAAU,CAAC;QACpB,CAAC;KAAA;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACU,WAAW,CAAC,EAAE,SAAS,EACX;;YAEvB,oCAAoC;YACpC,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAoB,CAAC;YAE1F,iCAAiC;YACjC,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;YAExD,2DAA2D;YAC3D,UAAU,CAAC,GAAG,GAAG,SAAS,CAAC;YAE3B,OAAO,UAAU,CAAC;QACpB,CAAC;KAAA;IAEY,iBAAiB,CAAC,EAAE,UAAU,EAA2B;;YACpE,mCAAmC;YACnC,MAAM,eAAe,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;YAEvE,OAAO,eAAe,CAAC;QACzB,CAAC;KAAA;CACF"}

package/dist/esm/prototyping/crypto/algorithms/aes-kw.js

@@ -0,0 +1,137 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { CryptoAlgorithm } from '@enbox/crypto';
+import { AesKw } from '../primitives/aes-kw.js';
+/**
+ * The `AesKwAlgorithm` class provides a concrete implementation for cryptographic operations using
+ * the AES algorithm for key wrapping. This class implements both
+ * {@link KeyGenerator | `KeyGenerator`} and {@link KeyWrapper | `KeyWrapper`} interfaces, providing
+ * key generation, key wrapping, and key unwrapping features.
+ *
+ * This class is typically accessed through implementations that extend the
+ * {@link CryptoApi | `CryptoApi`} interface.
+ */
+export class AesKwAlgorithm extends CryptoAlgorithm {
+    bytesToPrivateKey({ privateKeyBytes }) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Convert the byte array to a JWK.
+            const privateKey = yield AesKw.bytesToPrivateKey({ privateKeyBytes });
+            // Set the `alg` property based on the key length.
+            privateKey.alg = { 16: 'A128KW', 24: 'A192KW', 32: 'A256KW' }[privateKeyBytes.length];
+            return privateKey;
+        });
+    }
+    /**
+     * Generates a symmetric key for AES for key wrapping in JSON Web Key (JWK) format.
+     *
+     * @remarks
+     * This method generates a symmetric AES key for use in key wrapping mode, based on the specified
+     * `algorithm` parameter which determines the key length. It uses cryptographically secure random
+     * number generation to ensure the uniqueness and security of the key. The key is returned in JWK
+     * format.
+     *
+     * The generated key includes the following components:
+     * - `kty`: Key Type, set to 'oct' for Octet Sequence.
+     * - `k`: The symmetric key component, base64url-encoded.
+     * - `kid`: Key ID, generated based on the JWK thumbprint.
+     * - `alg`: Algorithm, set to 'A128KW', 'A192KW', or 'A256KW' for AES Key Wrap with the
+     *   specified key length.
+     *
+     * @example
+     * ```ts
+     * const aesKw = new AesKwAlgorithm();
+     * const privateKey = await aesKw.generateKey({ algorithm: 'A256KW' });
+     * ```
+     *
+     * @param params - The parameters for the key generation.
+     *
+     * @returns A Promise that resolves to the generated symmetric key in JWK format.
+     */
+    generateKey({ algorithm }) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Map algorithm name to key length.
+            const length = { A128KW: 128, A192KW: 192, A256KW: 256 }[algorithm];
+            // Generate a random private key.
+            const privateKey = yield AesKw.generateKey({ length });
+            // Set the `alg` property based on the specified algorithm.
+            privateKey.alg = algorithm;
+            return privateKey;
+        });
+    }
+    privateKeyToBytes({ privateKey }) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Convert the JWK to a byte array.
+            const privateKeyBytes = yield AesKw.privateKeyToBytes({ privateKey });
+            return privateKeyBytes;
+        });
+    }
+    /**
+     * Decrypts a wrapped key using the AES Key Wrap algorithm.
+     *
+     * @remarks
+     * This method unwraps a previously wrapped cryptographic key using the AES Key Wrap algorithm.
+     * The wrapped key, provided as a byte array, is unwrapped using the decryption key specified in
+     * the parameters.
+     *
+     * This operation is useful for securely receiving keys transmitted over untrusted mediums. The
+     * method returns the unwrapped key as a JSON Web Key (JWK).
+     *
+     * @example
+     * ```ts
+     * const aesKw = new AesKwAlgorithm();
+     * const wrappedKeyBytes = new Uint8Array([...]); // Byte array of a wrapped AES-256 GCM key
+     * const decryptionKey = { ... }; // A Jwk object representing the AES unwrapping key
+     * const unwrappedKey = await aesKw.unwrapKey({
+     *   wrappedKeyBytes,
+     *   wrappedKeyAlgorithm: 'A256GCM',
+     *   decryptionKey
+     * });
+     * ```
+     *
+     * @param params - The parameters for the key unwrapping operation.
+     *
+     * @returns A Promise that resolves to the unwrapped key in JWK format.
+     */
+    unwrapKey(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const unwrappedKey = yield AesKw.unwrapKey(params);
+            return unwrappedKey;
+        });
+    }
+    /**
+     * Encrypts a given key using the AES Key Wrap algorithm.
+     *
+     * @remarks
+     * This method wraps a given cryptographic key using the AES Key Wrap algorithm. The private key
+     * to be wrapped is provided in the form of a JSON Web Key (JWK).
+     *
+     * This operation is useful for securely transmitting keys over untrusted mediums. The method
+     * returns the wrapped key as a byte array.
+     *
+     * @example
+     * ```ts
+     * const aesKw = new AesKwAlgorithm();
+     * const unwrappedKey = { ... }; // A Jwk object representing the key to be wrapped
+     * const encryptionKey = { ... }; // A Jwk object representing the AES wrapping key
+     * const wrappedKeyBytes = await aesKw.wrapKey({ unwrappedKey, encryptionKey });
+     * ```
+     *
+     * @param params - The parameters for the key wrapping operation.
+     *
+     * @returns A Promise that resolves to the wrapped key as a Uint8Array.
+     */
+    wrapKey(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const wrappedKeyBytes = AesKw.wrapKey(params);
+            return wrappedKeyBytes;
+        });
+    }
+}
+//# sourceMappingURL=aes-kw.js.map

package/dist/esm/prototyping/crypto/algorithms/aes-kw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aes-kw.js","sourceRoot":"","sources":["../../../../../src/prototyping/crypto/algorithms/aes-kw.ts"],"names":[],"mappings":";;;;;;;;;AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAIhD,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAiBhD;;;;;;;;GAQG;AACH,MAAM,OAAO,cAAe,SAAQ,eAAe;IAKpC,iBAAiB,CAAC,EAAE,eAAe,EACS;;YAEvD,mCAAmC;YACnC,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,iBAAiB,CAAC,EAAE,eAAe,EAAE,CAAC,CAAC;YAEtE,kDAAkD;YAClD,UAAU,CAAC,GAAG,GAAG,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;YAEtF,OAAO,UAAU,CAAC;QACpB,CAAC;KAAA;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACU,WAAW,CAAC,EAAE,SAAS,EACZ;;YAEtB,oCAAoC;YACpC,MAAM,MAAM,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAoB,CAAC;YAEvF,iCAAiC;YACjC,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;YAEvD,2DAA2D;YAC3D,UAAU,CAAC,GAAG,GAAG,SAAS,CAAC;YAE3B,OAAO,UAAU,CAAC;QACpB,CAAC;KAAA;IAEY,iBAAiB,CAAC,EAAE,UAAU,EAClB;;YAEvB,mCAAmC;YACnC,MAAM,eAAe,GAAG,MAAM,KAAK,CAAC,iBAAiB,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;YAEtE,OAAO,eAAe,CAAC;QACzB,CAAC;KAAA;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACU,SAAS,CAAC,MACN;;YAEf,MAAM,YAAY,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAEnD,OAAO,YAAY,CAAC;QACtB,CAAC;KAAA;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACU,OAAO,CAAC,MACN;;YAEb,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAE9C,OAAO,eAAe,CAAC;QACzB,CAAC;KAAA;CACF"}