@hpke/cose 0.0.0-stage → 0.0.1

package/esm/src/hpke1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hpke1.d.ts","sourceRoot":"","sources":["../../src/src/hpke1.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,UAAU,EAAe,MAAM,UAAU,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,sEAAsE;AACtE,wBAAgB,WAAW,IAAI,YAAY,CAO1C;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,WAAW,CAYjE"}

package/esm/src/hpke1.js

@@ -0,0 +1,23 @@
+import { Aes256Gcm, CipherSuite, DhkemP384HkdfSha384, HkdfSha384, } from "@hpke/core";
+import { CoseHpkeAlg } from "./alg.js";
+import { aesGcmContentCrypto } from "./contentAesGcm.js";
+import { CoseEncrypt0Impl } from "./encrypt0.js";
+import { CoseEncryptImpl } from "./encrypt.js";
+/** DHKEM(P-384), HKDF-SHA384, AES-256-GCM — Integrated Encryption. */
+export function createHpke1() {
+    const suite = new CipherSuite({
+        kem: new DhkemP384HkdfSha384(),
+        kdf: new HkdfSha384(),
+        aead: new Aes256Gcm(),
+    });
+    return new CoseEncrypt0Impl(suite, CoseHpkeAlg.HPKE_1);
+}
+/** DHKEM(P-384), HKDF-SHA384, AES-256-GCM — Key Encryption. */
+export function createHpke1Ke(contentAlg) {
+    const suite = new CipherSuite({
+        kem: new DhkemP384HkdfSha384(),
+        kdf: new HkdfSha384(),
+        aead: new Aes256Gcm(),
+    });
+    return new CoseEncryptImpl(suite, CoseHpkeAlg.HPKE_1_KE, contentAlg, aesGcmContentCrypto);
+}

package/esm/src/hpke2.d.ts

@@ -0,0 +1,8 @@
+import { type ContentAlg } from "./alg.js";
+import type { CoseEncrypt0 } from "./encrypt0.js";
+import type { CoseEncrypt } from "./encrypt.js";
+/** DHKEM(P-521), HKDF-SHA512, AES-256-GCM — Integrated Encryption. */
+export declare function createHpke2(): CoseEncrypt0;
+/** DHKEM(P-521), HKDF-SHA512, AES-256-GCM — Key Encryption. */
+export declare function createHpke2Ke(contentAlg: ContentAlg): CoseEncrypt;
+//# sourceMappingURL=hpke2.d.ts.map

package/esm/src/hpke2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hpke2.d.ts","sourceRoot":"","sources":["../../src/src/hpke2.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,UAAU,EAAe,MAAM,UAAU,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,sEAAsE;AACtE,wBAAgB,WAAW,IAAI,YAAY,CAO1C;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,WAAW,CAYjE"}

package/esm/src/hpke2.js

@@ -0,0 +1,23 @@
+import { Aes256Gcm, CipherSuite, DhkemP521HkdfSha512, HkdfSha512, } from "@hpke/core";
+import { CoseHpkeAlg } from "./alg.js";
+import { aesGcmContentCrypto } from "./contentAesGcm.js";
+import { CoseEncrypt0Impl } from "./encrypt0.js";
+import { CoseEncryptImpl } from "./encrypt.js";
+/** DHKEM(P-521), HKDF-SHA512, AES-256-GCM — Integrated Encryption. */
+export function createHpke2() {
+    const suite = new CipherSuite({
+        kem: new DhkemP521HkdfSha512(),
+        kdf: new HkdfSha512(),
+        aead: new Aes256Gcm(),
+    });
+    return new CoseEncrypt0Impl(suite, CoseHpkeAlg.HPKE_2);
+}
+/** DHKEM(P-521), HKDF-SHA512, AES-256-GCM — Key Encryption. */
+export function createHpke2Ke(contentAlg) {
+    const suite = new CipherSuite({
+        kem: new DhkemP521HkdfSha512(),
+        kdf: new HkdfSha512(),
+        aead: new Aes256Gcm(),
+    });
+    return new CoseEncryptImpl(suite, CoseHpkeAlg.HPKE_2_KE, contentAlg, aesGcmContentCrypto);
+}

package/esm/src/hpke3.d.ts

@@ -0,0 +1,8 @@
+import { type ContentAlg } from "./alg.js";
+import type { CoseEncrypt0 } from "./encrypt0.js";
+import type { CoseEncrypt } from "./encrypt.js";
+/** DHKEM(X25519), HKDF-SHA256, AES-128-GCM — Integrated Encryption. */
+export declare function createHpke3(): CoseEncrypt0;
+/** DHKEM(X25519), HKDF-SHA256, AES-128-GCM — Key Encryption. */
+export declare function createHpke3Ke(contentAlg: ContentAlg): CoseEncrypt;
+//# sourceMappingURL=hpke3.d.ts.map

package/esm/src/hpke3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hpke3.d.ts","sourceRoot":"","sources":["../../src/src/hpke3.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,UAAU,EAAe,MAAM,UAAU,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,uEAAuE;AACvE,wBAAgB,WAAW,IAAI,YAAY,CAO1C;AAED,gEAAgE;AAChE,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,WAAW,CAYjE"}

package/esm/src/hpke3.js

@@ -0,0 +1,23 @@
+import { Aes128Gcm, CipherSuite, DhkemX25519HkdfSha256, HkdfSha256, } from "@hpke/core";
+import { CoseHpkeAlg } from "./alg.js";
+import { aesGcmContentCrypto } from "./contentAesGcm.js";
+import { CoseEncrypt0Impl } from "./encrypt0.js";
+import { CoseEncryptImpl } from "./encrypt.js";
+/** DHKEM(X25519), HKDF-SHA256, AES-128-GCM — Integrated Encryption. */
+export function createHpke3() {
+    const suite = new CipherSuite({
+        kem: new DhkemX25519HkdfSha256(),
+        kdf: new HkdfSha256(),
+        aead: new Aes128Gcm(),
+    });
+    return new CoseEncrypt0Impl(suite, CoseHpkeAlg.HPKE_3);
+}
+/** DHKEM(X25519), HKDF-SHA256, AES-128-GCM — Key Encryption. */
+export function createHpke3Ke(contentAlg) {
+    const suite = new CipherSuite({
+        kem: new DhkemX25519HkdfSha256(),
+        kdf: new HkdfSha256(),
+        aead: new Aes128Gcm(),
+    });
+    return new CoseEncryptImpl(suite, CoseHpkeAlg.HPKE_3_KE, contentAlg, aesGcmContentCrypto);
+}

package/esm/src/hpke4.d.ts

@@ -0,0 +1,8 @@
+import { ContentAlg } from "./alg.js";
+import type { CoseEncrypt0 } from "./encrypt0.js";
+import type { CoseEncrypt } from "./encrypt.js";
+/** DHKEM(X25519), HKDF-SHA256, ChaCha20Poly1305 — Integrated Encryption. */
+export declare function createHpke4(): CoseEncrypt0;
+/** DHKEM(X25519), HKDF-SHA256, ChaCha20Poly1305 — Key Encryption. */
+export declare function createHpke4Ke(contentAlg: ContentAlg): CoseEncrypt;
+//# sourceMappingURL=hpke4.d.ts.map

package/esm/src/hpke4.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hpke4.d.ts","sourceRoot":"","sources":["../../src/src/hpke4.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAe,MAAM,UAAU,CAAC;AAEnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAgBhD,4EAA4E;AAC5E,wBAAgB,WAAW,IAAI,YAAY,CAO1C;AAED,qEAAqE;AACrE,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,WAAW,CAUjE"}

package/esm/src/hpke4.js

@@ -0,0 +1,39 @@
+import { CipherSuite, DhkemX25519HkdfSha256, HkdfSha256 } from "@hpke/core";
+import { Chacha20Poly1305 } from "@hpke/chacha20poly1305";
+import { ContentAlg, CoseHpkeAlg } from "./alg.js";
+import { aesGcmContentCrypto } from "./contentAesGcm.js";
+import { CoseEncrypt0Impl } from "./encrypt0.js";
+import { CoseEncryptImpl } from "./encrypt.js";
+const chacha20ContentCrypto = {
+    async seal(key, nonce, plaintext, aad) {
+        const chacha = new Chacha20Poly1305();
+        const ctx = chacha.createEncryptionContext(key);
+        return new Uint8Array(await ctx.seal(nonce, plaintext, aad));
+    },
+    async open(key, nonce, ciphertext, aad) {
+        const chacha = new Chacha20Poly1305();
+        const ctx = chacha.createEncryptionContext(key);
+        return new Uint8Array(await ctx.open(nonce, ciphertext, aad));
+    },
+};
+/** DHKEM(X25519), HKDF-SHA256, ChaCha20Poly1305 — Integrated Encryption. */
+export function createHpke4() {
+    const suite = new CipherSuite({
+        kem: new DhkemX25519HkdfSha256(),
+        kdf: new HkdfSha256(),
+        aead: new Chacha20Poly1305(),
+    });
+    return new CoseEncrypt0Impl(suite, CoseHpkeAlg.HPKE_4);
+}
+/** DHKEM(X25519), HKDF-SHA256, ChaCha20Poly1305 — Key Encryption. */
+export function createHpke4Ke(contentAlg) {
+    const suite = new CipherSuite({
+        kem: new DhkemX25519HkdfSha256(),
+        kdf: new HkdfSha256(),
+        aead: new Chacha20Poly1305(),
+    });
+    const cc = contentAlg === ContentAlg.CHACHA20POLY1305
+        ? chacha20ContentCrypto
+        : aesGcmContentCrypto;
+    return new CoseEncryptImpl(suite, CoseHpkeAlg.HPKE_4_KE, contentAlg, cc);
+}

package/esm/src/hpke5.d.ts

@@ -0,0 +1,8 @@
+import { type ContentAlg } from "./alg.js";
+import type { CoseEncrypt0 } from "./encrypt0.js";
+import type { CoseEncrypt } from "./encrypt.js";
+/** DHKEM(X448), HKDF-SHA512, AES-256-GCM — Integrated Encryption. */
+export declare function createHpke5(): CoseEncrypt0;
+/** DHKEM(X448), HKDF-SHA512, AES-256-GCM — Key Encryption. */
+export declare function createHpke5Ke(contentAlg: ContentAlg): CoseEncrypt;
+//# sourceMappingURL=hpke5.d.ts.map

package/esm/src/hpke5.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hpke5.d.ts","sourceRoot":"","sources":["../../src/src/hpke5.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,UAAU,EAAe,MAAM,UAAU,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,qEAAqE;AACrE,wBAAgB,WAAW,IAAI,YAAY,CAO1C;AAED,8DAA8D;AAC9D,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,WAAW,CAYjE"}

package/esm/src/hpke5.js

@@ -0,0 +1,24 @@
+import { Aes256Gcm, CipherSuite, HkdfSha512 } from "@hpke/core";
+import { DhkemX448HkdfSha512 } from "@hpke/dhkem-x448";
+import { CoseHpkeAlg } from "./alg.js";
+import { aesGcmContentCrypto } from "./contentAesGcm.js";
+import { CoseEncrypt0Impl } from "./encrypt0.js";
+import { CoseEncryptImpl } from "./encrypt.js";
+/** DHKEM(X448), HKDF-SHA512, AES-256-GCM — Integrated Encryption. */
+export function createHpke5() {
+    const suite = new CipherSuite({
+        kem: new DhkemX448HkdfSha512(),
+        kdf: new HkdfSha512(),
+        aead: new Aes256Gcm(),
+    });
+    return new CoseEncrypt0Impl(suite, CoseHpkeAlg.HPKE_5);
+}
+/** DHKEM(X448), HKDF-SHA512, AES-256-GCM — Key Encryption. */
+export function createHpke5Ke(contentAlg) {
+    const suite = new CipherSuite({
+        kem: new DhkemX448HkdfSha512(),
+        kdf: new HkdfSha512(),
+        aead: new Aes256Gcm(),
+    });
+    return new CoseEncryptImpl(suite, CoseHpkeAlg.HPKE_5_KE, contentAlg, aesGcmContentCrypto);
+}

package/esm/src/hpke6.d.ts

@@ -0,0 +1,8 @@
+import { ContentAlg } from "./alg.js";
+import type { CoseEncrypt0 } from "./encrypt0.js";
+import type { CoseEncrypt } from "./encrypt.js";
+/** DHKEM(X448), HKDF-SHA512, ChaCha20Poly1305 — Integrated Encryption. */
+export declare function createHpke6(): CoseEncrypt0;
+/** DHKEM(X448), HKDF-SHA512, ChaCha20Poly1305 — Key Encryption. */
+export declare function createHpke6Ke(contentAlg: ContentAlg): CoseEncrypt;
+//# sourceMappingURL=hpke6.d.ts.map

package/esm/src/hpke6.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hpke6.d.ts","sourceRoot":"","sources":["../../src/src/hpke6.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAe,MAAM,UAAU,CAAC;AAEnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAgBhD,0EAA0E;AAC1E,wBAAgB,WAAW,IAAI,YAAY,CAO1C;AAED,mEAAmE;AACnE,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,WAAW,CAUjE"}

package/esm/src/hpke6.js

@@ -0,0 +1,40 @@
+import { CipherSuite, HkdfSha512 } from "@hpke/core";
+import { DhkemX448HkdfSha512 } from "@hpke/dhkem-x448";
+import { Chacha20Poly1305 } from "@hpke/chacha20poly1305";
+import { ContentAlg, CoseHpkeAlg } from "./alg.js";
+import { aesGcmContentCrypto } from "./contentAesGcm.js";
+import { CoseEncrypt0Impl } from "./encrypt0.js";
+import { CoseEncryptImpl } from "./encrypt.js";
+const chacha20ContentCrypto = {
+    async seal(key, nonce, plaintext, aad) {
+        const chacha = new Chacha20Poly1305();
+        const ctx = chacha.createEncryptionContext(key);
+        return new Uint8Array(await ctx.seal(nonce, plaintext, aad));
+    },
+    async open(key, nonce, ciphertext, aad) {
+        const chacha = new Chacha20Poly1305();
+        const ctx = chacha.createEncryptionContext(key);
+        return new Uint8Array(await ctx.open(nonce, ciphertext, aad));
+    },
+};
+/** DHKEM(X448), HKDF-SHA512, ChaCha20Poly1305 — Integrated Encryption. */
+export function createHpke6() {
+    const suite = new CipherSuite({
+        kem: new DhkemX448HkdfSha512(),
+        kdf: new HkdfSha512(),
+        aead: new Chacha20Poly1305(),
+    });
+    return new CoseEncrypt0Impl(suite, CoseHpkeAlg.HPKE_6);
+}
+/** DHKEM(X448), HKDF-SHA512, ChaCha20Poly1305 — Key Encryption. */
+export function createHpke6Ke(contentAlg) {
+    const suite = new CipherSuite({
+        kem: new DhkemX448HkdfSha512(),
+        kdf: new HkdfSha512(),
+        aead: new Chacha20Poly1305(),
+    });
+    const cc = contentAlg === ContentAlg.CHACHA20POLY1305
+        ? chacha20ContentCrypto
+        : aesGcmContentCrypto;
+    return new CoseEncryptImpl(suite, CoseHpkeAlg.HPKE_6_KE, contentAlg, cc);
+}

package/esm/src/hpke7.d.ts

@@ -0,0 +1,8 @@
+import { type ContentAlg } from "./alg.js";
+import type { CoseEncrypt0 } from "./encrypt0.js";
+import type { CoseEncrypt } from "./encrypt.js";
+/** DHKEM(P-256), HKDF-SHA256, AES-256-GCM — Integrated Encryption. */
+export declare function createHpke7(): CoseEncrypt0;
+/** DHKEM(P-256), HKDF-SHA256, AES-256-GCM — Key Encryption. */
+export declare function createHpke7Ke(contentAlg: ContentAlg): CoseEncrypt;
+//# sourceMappingURL=hpke7.d.ts.map

package/esm/src/hpke7.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hpke7.d.ts","sourceRoot":"","sources":["../../src/src/hpke7.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,UAAU,EAAe,MAAM,UAAU,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,sEAAsE;AACtE,wBAAgB,WAAW,IAAI,YAAY,CAO1C;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,WAAW,CAYjE"}

package/esm/src/hpke7.js

@@ -0,0 +1,23 @@
+import { Aes256Gcm, CipherSuite, DhkemP256HkdfSha256, HkdfSha256, } from "@hpke/core";
+import { CoseHpkeAlg } from "./alg.js";
+import { aesGcmContentCrypto } from "./contentAesGcm.js";
+import { CoseEncrypt0Impl } from "./encrypt0.js";
+import { CoseEncryptImpl } from "./encrypt.js";
+/** DHKEM(P-256), HKDF-SHA256, AES-256-GCM — Integrated Encryption. */
+export function createHpke7() {
+    const suite = new CipherSuite({
+        kem: new DhkemP256HkdfSha256(),
+        kdf: new HkdfSha256(),
+        aead: new Aes256Gcm(),
+    });
+    return new CoseEncrypt0Impl(suite, CoseHpkeAlg.HPKE_7);
+}
+/** DHKEM(P-256), HKDF-SHA256, AES-256-GCM — Key Encryption. */
+export function createHpke7Ke(contentAlg) {
+    const suite = new CipherSuite({
+        kem: new DhkemP256HkdfSha256(),
+        kdf: new HkdfSha256(),
+        aead: new Aes256Gcm(),
+    });
+    return new CoseEncryptImpl(suite, CoseHpkeAlg.HPKE_7_KE, contentAlg, aesGcmContentCrypto);
+}

package/esm/src/structures.d.ts

@@ -0,0 +1,41 @@
+/** COSE header label constants. */
+export declare const HeaderLabel: {
+    readonly ALG: 1;
+    readonly KID: 4;
+    readonly IV: 5;
+    readonly EK: -4;
+    readonly PSK_ID: -5;
+};
+/**
+ * Build Enc_structure for Integrated Encryption (COSE_Encrypt0) AAD.
+ *
+ * Enc_structure = [
+ *   "Encrypt0",            // context
+ *   protected_header_bytes, // serialized protected header
+ *   external_aad            // external additional authenticated data
+ * ]
+ */
+export declare function buildEncStructure(protectedHeader: Uint8Array, externalAad: Uint8Array): Uint8Array;
+/**
+ * Build Enc_structure for Key Encryption (COSE_Encrypt) AAD.
+ *
+ * Enc_structure = [
+ *   "Encrypt",
+ *   protected_header_bytes,
+ *   external_aad
+ * ]
+ */
+export declare function buildEncStructureEncrypt(protectedHeader: Uint8Array, externalAad: Uint8Array): Uint8Array;
+/**
+ * Build the HPKE info parameter for Key Encryption recipients
+ * using the Recipient_structure.
+ *
+ * Recipient_structure = [
+ *   "HPKE Recipient",             // context
+ *   next_layer_alg,               // content encryption algorithm (e.g. 1 for A128GCM)
+ *   recipient_protected_header,   // serialized recipient protected header
+ *   recipient_extra_info          // additional info for key derivation
+ * ]
+ */
+export declare function buildRecipientStructure(nextLayerAlg: number, recipientProtectedHeader: Uint8Array, recipientExtraInfo: Uint8Array): Uint8Array;
+//# sourceMappingURL=structures.d.ts.map

package/esm/src/structures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structures.d.ts","sourceRoot":"","sources":["../../src/src/structures.ts"],"names":[],"mappings":"AAGA,mCAAmC;AACnC,eAAO,MAAM,WAAW;;;;;;CAMd,CAAC;AAEX;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,eAAe,EAAE,UAAU,EAC3B,WAAW,EAAE,UAAU,GACtB,UAAU,CAOZ;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,eAAe,EAAE,UAAU,EAC3B,WAAW,EAAE,UAAU,GACtB,UAAU,CAOZ;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,EACpB,wBAAwB,EAAE,UAAU,EACpC,kBAAkB,EAAE,UAAU,GAC7B,UAAU,CAQZ"}

package/esm/src/structures.js

@@ -0,0 +1,63 @@
+import { encode } from "./cbor/encoder.js";
+/** COSE header label constants. */
+export const HeaderLabel = {
+    ALG: 1,
+    KID: 4,
+    IV: 5,
+    EK: -4,
+    PSK_ID: -5,
+};
+/**
+ * Build Enc_structure for Integrated Encryption (COSE_Encrypt0) AAD.
+ *
+ * Enc_structure = [
+ *   "Encrypt0",            // context
+ *   protected_header_bytes, // serialized protected header
+ *   external_aad            // external additional authenticated data
+ * ]
+ */
+export function buildEncStructure(protectedHeader, externalAad) {
+    const structure = [
+        "Encrypt0",
+        protectedHeader,
+        externalAad,
+    ];
+    return encode(structure);
+}
+/**
+ * Build Enc_structure for Key Encryption (COSE_Encrypt) AAD.
+ *
+ * Enc_structure = [
+ *   "Encrypt",
+ *   protected_header_bytes,
+ *   external_aad
+ * ]
+ */
+export function buildEncStructureEncrypt(protectedHeader, externalAad) {
+    const structure = [
+        "Encrypt",
+        protectedHeader,
+        externalAad,
+    ];
+    return encode(structure);
+}
+/**
+ * Build the HPKE info parameter for Key Encryption recipients
+ * using the Recipient_structure.
+ *
+ * Recipient_structure = [
+ *   "HPKE Recipient",             // context
+ *   next_layer_alg,               // content encryption algorithm (e.g. 1 for A128GCM)
+ *   recipient_protected_header,   // serialized recipient protected header
+ *   recipient_extra_info          // additional info for key derivation
+ * ]
+ */
+export function buildRecipientStructure(nextLayerAlg, recipientProtectedHeader, recipientExtraInfo) {
+    const structure = [
+        "HPKE Recipient",
+        nextLayerAlg,
+        recipientProtectedHeader,
+        recipientExtraInfo,
+    ];
+    return encode(structure);
+}

package/package.json

@@ -1,6 +1,51 @@
 {
   "name": "@hpke/cose",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.0.1",
+  "description": "COSE-HPKE (draft-ietf-cose-hpke) encryption for COSE_Encrypt0 and COSE_Encrypt",
+  "keywords": [
+    "hpke",
+    "cose",
+    "rfc9180",
+    "encryption",
+    "security"
+  ],
+  "author": "Ajitomi Daisuke",
+  "homepage": "https://github.com/dajiaji/hpke-js/tree/main/packages/cose#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dajiaji/hpke-js.git"
+  },
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/dajiaji/hpke-js/issues"
+  },
+  "main": "./esm/mod.js",
+  "module": "./esm/mod.js",
+  "types": "./esm/mod.d.ts",
+  "exports": {
+    ".": {
+      "import": "./esm/mod.js",
+      "types": "./esm/mod.d.ts"
+    },
+    "./package.json": "./package.json"
+  },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/dajiaji"
+  },
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@hpke/chacha20poly1305": "^1.8.0",
+    "@hpke/core": "^1.9.0",
+    "@hpke/dhkem-x448": "^1.8.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.9.0",
+    "@deno/shim-deno": "~0.18.0",
+    "picocolors": "^1.0.0"
+  },
+  "_generatedBy": "dnt@dev"
 }