@cubist-labs/cubesigner-sdk 0.1.50 → 0.2.2

package/src/signer_session.ts

@@ -1,77 +1,58 @@
 import assert from "assert";
-import { CubeSigner, Key, toKeyInfo, Org, KeyInfo } from ".";
-import { components, paths } from "./client";
-import { assertOk } from "./util";
-import {
-  NewSessionResponse,
-  SignerSessionManager,
-  SignerSessionStorage,
-} from "./session/signer_session_manager";
-
-/* eslint-disable */
-export type EvmSignRequest =
-  paths["/v1/org/{org_id}/eth1/sign/{pubkey}"]["post"]["requestBody"]["content"]["application/json"];
-export type Eth2SignRequest =
-  paths["/v1/org/{org_id}/eth2/sign/{pubkey}"]["post"]["requestBody"]["content"]["application/json"];
-export type Eth2StakeRequest =
-  paths["/v1/org/{org_id}/eth2/stake"]["post"]["requestBody"]["content"]["application/json"];
-export type Eth2UnstakeRequest =
-  paths["/v1/org/{org_id}/eth2/unstake/{pubkey}"]["post"]["requestBody"]["content"]["application/json"];
-export type BlobSignRequest =
-  paths["/v1/org/{org_id}/blob/sign/{key_id}"]["post"]["requestBody"]["content"]["application/json"];
-export type BtcSignRequest =
-  paths["/v0/org/{org_id}/btc/sign/{pubkey}"]["post"]["requestBody"]["content"]["application/json"];
-export type SolanaSignRequest =
-  paths["/v1/org/{org_id}/solana/sign/{pubkey}"]["post"]["requestBody"]["content"]["application/json"];
-
-export type EvmSignResponse =
-  components["responses"]["Eth1SignResponse"]["content"]["application/json"];
-export type Eth2SignResponse =
-  components["responses"]["Eth2SignResponse"]["content"]["application/json"];
-export type Eth2StakeResponse =
-  components["responses"]["StakeResponse"]["content"]["application/json"];
-export type Eth2UnstakeResponse =
-  components["responses"]["UnstakeResponse"]["content"]["application/json"];
-export type BlobSignResponse =
-  components["responses"]["BlobSignResponse"]["content"]["application/json"];
-export type BtcSignResponse =
-  components["responses"]["BtcSignResponse"]["content"]["application/json"];
-export type SolanaSignResponse =
-  components["responses"]["SolanaSignResponse"]["content"]["application/json"];
-export type MfaRequestInfo =
-  components["responses"]["MfaRequestInfo"]["content"]["application/json"];
-
-export type AcceptedResponse = components["schemas"]["AcceptedResponse"];
-export type ErrorResponse = components["schemas"]["ErrorResponse"];
-export type BtcSignatureKind = components["schemas"]["BtcSignatureKind"];
-/* eslint-enable */
-
-/** MFA request kind */
-export type MfaType = components["schemas"]["MfaType"];
-
-type SignFn<U> = (headers?: HeadersInit) => Promise<U | AcceptedResponse>;
+import { CubeSigner, toKeyInfo, MfaReceipt, KeyInfo } from ".";
+import { CubeSignerClient } from "./client";
+import { AcceptedResponse, NewSessionResponse } from "./schema_types";
+import { SignerSessionManager, SignerSessionStorage } from "./session/signer_session_manager";
+
+type Response<U> = U | AcceptedResponse;
+type RequestFn<U> = (headers?: HeadersInit) => Promise<Response<U>>;
+type MapFn<U, V> = (u: U) => V;
+
+/**
+ * Takes a {@link Response<U>} and a {@link MapFn<U, V>} function and returns
+ * a {@link Response<V>} that maps the value of the original response when its status code is 200.
+ *
+ * @param {Response<U>} resp Original response
+ * @param {Map<U, V>} mapFn Map to apply to the response value when its status code is 200.
+ * @return {Response<V>} Response whose value for status code 200 is mapped from U to V
+ */
+export function mapResponse<U, V>(resp: Response<U>, mapFn: MapFn<U, V>): Response<V> {
+  if ((resp as AcceptedResponse).accepted?.MfaRequired) {
+    return resp as AcceptedResponse;
+  } else {
+    return mapFn(resp as U);
+  }
+}
+
+export interface MfaRequired {
+  /** Org id */
+  org_id: string;
+  /** MFA request id */
+  id: string;
+  /** Optional MFA session */
+  session?: NewSessionResponse | null;
+}
 
 /**
  * A response of a CubeSigner request.
  */
-export class SignResponse<U> {
-  readonly #orgId: string;
-  readonly #signFn: SignFn<U>;
+export class CubeSignerResponse<U> {
+  readonly #requestFn: RequestFn<U>;
   readonly #resp: U | AcceptedResponse;
   /**
    * Optional MFA id. Only set if there is an MFA request associated with the
    * signing request
    */
-  #mfaId?: string;
+  readonly #mfaRequired?: MfaRequired;
 
   /** @return {string} The MFA id associated with this request */
   mfaId(): string {
-    return this.#mfaId!;
+    return this.#mfaRequired!.id;
   }
 
   /** @return {boolean} True if this request requires an MFA approval */
   requiresMfa(): boolean {
-    return this.#mfaId !== undefined;
+    return this.#mfaRequired !== undefined;
   }
 
   /**
@@ -82,8 +63,11 @@ export class SignResponse<U> {
     return (this.#resp as AcceptedResponse).accepted?.MfaRequired?.session ?? undefined;
   }
 
-  /** @return {U} The signed data */
+  /** @return {U} The response data, if no MFA is required */
   data(): U {
+    if (this.requiresMfa()) {
+      throw new Error("Cannot call `data()` while MFA is required");
+    }
     return this.#resp as U;
   }
 
@@ -92,10 +76,12 @@ export class SignResponse<U> {
    *
    * @param {SignerSession} session Signer session to use
    * @param {string} code 6-digit TOTP code
-   * @return {SignResponse<U>} The result of signing with the approval
+   * @return {CubeSignerResponse<U>} The result of signing with the approval
    */
-  async approveTotp(session: SignerSession, code: string): Promise<SignResponse<U>> {
+  async approveTotp(session: SignerSession, code: string): Promise<CubeSignerResponse<U>> {
+    assert(this.requiresMfa());
     const mfaId = this.mfaId();
+    const mfaOrgId = this.#mfaRequired!.org_id;
     const mfaApproval = await session.totpApprove(mfaId, code);
     assert(mfaApproval.id === mfaId);
     const mfaConf = mfaApproval.receipt?.confirmation;
@@ -104,18 +90,21 @@ export class SignResponse<U> {
       return this;
     }
 
-    return await this.signWithMfaApproval(mfaApproval);
+    return await this.signWithMfaApproval({ mfaId, mfaOrgId, mfaConf });
   }
 
   /**
-   * Approves the MFA request using a given `CubeSigner` instance (i.e., its management session).
+   * Approves the MFA request using a given `CubeSignerClient` instance (i.e., its session).
    *
    * @param {CubeSigner} cs CubeSigner whose session to use
-   * @return {SignResponse<U>} The result of signing with the approval
+   * @return {CubeSignerResponse<U>} The result of signing with the approval
    */
-  async approve(cs: CubeSigner): Promise<SignResponse<U>> {
-    const mfaId = this.mfaId();
-    const mfaApproval = await Org.mfaApprove(cs, this.#orgId, mfaId);
+  async approve(cs: CubeSigner): Promise<CubeSignerResponse<U>> {
+    assert(this.requiresMfa());
+    const mfaId = this.#mfaRequired!.id;
+    const mfaOrgId = this.#mfaRequired!.org_id;
+
+    const mfaApproval = await cs.mfaApprove(mfaOrgId, mfaId);
     assert(mfaApproval.id === mfaId);
     const mfaConf = mfaApproval.receipt?.confirmation;
 
@@ -123,16 +112,16 @@ export class SignResponse<U> {
       return this;
     }
 
-    return await this.signWithMfaApproval(mfaApproval);
+    return await this.signWithMfaApproval({ mfaId, mfaOrgId, mfaConf });
   }
 
   /**
-   * @param {MfaRequestInfo} mfaInfo The MFA request info with the approval
-   * @return {Promise<SignResponse<U>>} The result of signing after MFA approval
+   * @param {MfaReceipt} mfaReceipt The MFA receipt
+   * @return {Promise<CubeSignerResponse<U>>} The result of signing after MFA approval
    */
-  async signWithMfaApproval(mfaInfo: MfaRequestInfo): Promise<SignResponse<U>> {
-    const headers = SignResponse.getMfaHeaders(this.mfaId(), mfaInfo.receipt!.confirmation);
-    return new SignResponse(this.#orgId, this.#signFn, await this.#signFn(headers));
+  async signWithMfaApproval(mfaReceipt: MfaReceipt): Promise<CubeSignerResponse<U>> {
+    const headers = CubeSignerResponse.getMfaHeaders(mfaReceipt);
+    return new CubeSignerResponse(this.#requestFn, await this.#requestFn(headers));
   }
 
   // --------------------------------------------------------------------------
@@ -142,50 +131,59 @@ export class SignResponse<U> {
   /**
    * Constructor.
    *
-   * @param {string} orgId The org id of the corresponding signing request
-   * @param {SignFn} signFn The signing function that this response is from.
-   *                        This argument is used to resend requests with
-   *                        different headers if needed.
-   * @param {U | AcceptedResponse} resp The response as returned by the OpenAPI
-   *                                    client.
+   * @param {RequestFn} requestFn
+   *    The signing function that this response is from.
+   *    This argument is used to resend requests with different headers if needed.
+   * @param {U | AcceptedResponse} resp The response as returned by the OpenAPI client.
    */
-  constructor(orgId: string, signFn: SignFn<U>, resp: U | AcceptedResponse) {
-    this.#orgId = orgId;
-    this.#signFn = signFn;
+  constructor(requestFn: RequestFn<U>, resp: U | AcceptedResponse) {
+    this.#requestFn = requestFn;
     this.#resp = resp;
+    this.#mfaRequired = (this.#resp as AcceptedResponse).accepted?.MfaRequired;
+  }
 
-    const mfaRequired = (this.#resp as AcceptedResponse).accepted?.MfaRequired;
-    if (mfaRequired) {
-      this.#mfaId = mfaRequired.id;
-    }
+  /**
+   * Static constructor.
+   * @param {RequestFn} requestFn
+   *    The request function that this response is from.
+   *    This argument is used to resend requests with different headers if needed.
+   * @param {MfaReceipt} mfaReceipt Optional MFA receipt
+   * @return {Promise<CubeSignerResponse<U>>} New instance of this class.
+   */
+  static async create<U>(
+    requestFn: RequestFn<U>,
+    mfaReceipt?: MfaReceipt,
+  ): Promise<CubeSignerResponse<U>> {
+    const seed = await requestFn(this.getMfaHeaders(mfaReceipt));
+    return new CubeSignerResponse(requestFn, seed);
   }
 
   /**
-   * MFA receipt to attach.
+   * Returns HTTP headers containing a given MFA receipt.
    *
-   * @param {string} mfaId MFA request id
-   * @param {string} mfaConf MFA receipt confirmation code
-   * @return {HeadersInit} Headers
+   * @param {MfaReceipt} mfaReceipt MFA receipt
+   * @return {HeadersInit} Headers including that receipt
    */
-  static getMfaHeaders(mfaId: string, mfaConf: string): HeadersInit {
-    return {
-      "x-cubist-mfa-id": mfaId,
-      "x-cubist-mfa-confirmation": mfaConf,
-    };
+  static getMfaHeaders(mfaReceipt?: MfaReceipt): HeadersInit | undefined {
+    return mfaReceipt
+      ? {
+          "x-cubist-mfa-id": mfaReceipt.mfaId,
+          "x-cubist-mfa-org-id": mfaReceipt.mfaOrgId,
+          "x-cubist-mfa-confirmation": mfaReceipt.mfaConf,
+        }
+      : undefined;
   }
 }
 
 /** Signer session info. Can only be used to revoke a token, but not for authentication. */
 export class SignerSessionInfo {
-  readonly #cs: CubeSigner;
-  readonly #orgId: string;
-  readonly #roleId: string;
+  readonly #csc: CubeSignerClient;
   readonly #sessionId: string;
   public readonly purpose: string;
 
-  /** Revoke this token */
+  /** Revoke this session */
   async revoke() {
-    await SignerSession.revoke(this.#cs, this.#orgId, this.#roleId, this.#sessionId);
+    await this.#csc.sessionRevoke(this.#sessionId);
   }
 
   // --------------------------------------------------------------------------
@@ -194,235 +192,105 @@ export class SignerSessionInfo {
 
   /**
    * Internal constructor.
-   * @param {CubeSigner} cs CubeSigner instance to use when calling `revoke`
-   * @param {string} orgId Organization ID
-   * @param {string} roleId Role ID
-   * @param {string} hash The hash of the token; can be used for revocation but not for auth
+   * @param {CubeSignerClient} cs CubeSigner instance to use when calling `revoke`
+   * @param {string} sessionId The ID of the session; can be used for revocation but not for auth
    * @param {string} purpose Session purpose
    * @internal
    */
-  constructor(cs: CubeSigner, orgId: string, roleId: string, hash: string, purpose: string) {
-    this.#cs = cs;
-    this.#orgId = orgId;
-    this.#roleId = roleId;
-    this.#sessionId = hash;
+  constructor(cs: CubeSignerClient, sessionId: string, purpose: string) {
+    this.#csc = cs;
+    this.#sessionId = sessionId;
     this.purpose = purpose;
   }
 }
 
-/** Signer session. */
+/**
+ * Signer session.
+ *
+ * @deprecated Use {@link CubeSignerClient} instead.
+ */
 export class SignerSession {
-  sessionMgr: SignerSessionManager;
-  readonly #orgId: string;
+  readonly #csc: CubeSignerClient;
+
+  /** Deprecated */
+  get sessionMgr() {
+    return this.#csc.sessionMgr;
+  }
+
+  /** Org id */
+  get orgId() {
+    return this.#csc.orgId;
+  }
 
   /**
    * Returns the list of keys that this token grants access to.
-   * @return {Key[]} The list of keys.
+   * @return {KeyInfo[]} The list of keys.
    */
   async keys(): Promise<KeyInfo[]> {
-    const resp = await (
-      await this.sessionMgr.client()
-    ).get("/v0/org/{org_id}/token/keys", {
-      params: { path: { org_id: this.#orgId } },
-      parseAs: "json",
-    });
-    const data = assertOk(resp);
-    return data.keys.map((k) => toKeyInfo(k));
+    const keys = await this.#csc.sessionKeysList();
+    return keys.map((k) => toKeyInfo(k));
   }
 
-  /**
-   * Approve a pending MFA request using TOTP.
-   *
-   * @param {string} mfaId The MFA request to approve
-   * @param {string} code The TOTP code
-   * @return {Promise<MfaRequestInfo>} The current status of the MFA request
-   */
-  async totpApprove(mfaId: string, code: string): Promise<MfaRequestInfo> {
-    const resp = await (
-      await this.sessionMgr.client()
-    ).patch("/v0/org/{org_id}/mfa/{mfa_id}/totp", {
-      params: { path: { org_id: this.#orgId, mfa_id: mfaId } },
-      body: { code },
-      parseAs: "json",
-    });
-    return assertOk(resp);
+  /** Approve a pending MFA request using TOTP. */
+  get totpApprove() {
+    return this.#csc.mfaApproveTotp.bind(this.#csc);
   }
 
-  /**
-   * Get a pending MFA request by its id.
-   * @param {CubeSigner} cs Management session to use (this argument will be removed in future versions)
-   * @param {string} mfaId The id of the MFA request.
-   * @return {Promise<MfaRequestInfo>} The MFA request.
-   */
-  async getMfaInfo(cs: CubeSigner, mfaId: string): Promise<MfaRequestInfo> {
-    const resp = await (
-      await cs.management()
-    ).get("/v0/org/{org_id}/mfa/{mfa_id}", {
-      params: { path: { org_id: this.#orgId, mfa_id: mfaId } },
-    });
-    return assertOk(resp);
+  /** Initiate approval of an existing MFA request using FIDO. */
+  get fidoApproveStart() {
+    return this.#csc.mfaApproveFidoInit.bind(this.#csc);
   }
 
-  /**
-   * Submit an EVM sign request.
-   * @param {Key | string} key The key to sign with (either {@link Key} or its material ID).
-   * @param {EvmSignRequest} req What to sign.
-   * @return {Promise<EvmSignResponse | AcceptedResponse>} Signature
-   */
-  async signEvm(key: Key | string, req: EvmSignRequest): Promise<SignResponse<EvmSignResponse>> {
-    const pubkey = typeof key === "string" ? (key as string) : key.materialId;
-    const sign = async (headers?: HeadersInit) => {
-      const resp = await (
-        await this.sessionMgr.client()
-      ).post("/v1/org/{org_id}/eth1/sign/{pubkey}", {
-        params: { path: { org_id: this.#orgId, pubkey } },
-        body: req,
-        headers,
-        parseAs: "json",
-      });
-      return assertOk(resp);
-    };
-    return new SignResponse(this.#orgId, sign, await sign());
+  /** Get a pending MFA request by its id. */
+  get getMfaInfo() {
+    return this.#csc.mfaGet.bind(this.#csc);
   }
 
-  /**
-   * Submit an 'eth2' sign request.
-   * @param {Key | string} key The key to sign with (either {@link Key} or its material ID).
-   * @param {Eth2SignRequest} req What to sign.
-   * @return {Promise<Eth2SignResponse | AcceptedResponse>} Signature
-   */
-  async signEth2(key: Key | string, req: Eth2SignRequest): Promise<SignResponse<Eth2SignResponse>> {
-    const pubkey = typeof key === "string" ? (key as string) : key.materialId;
-    const sign = async (headers?: HeadersInit) => {
-      const resp = await (
-        await this.sessionMgr.client()
-      ).post("/v1/org/{org_id}/eth2/sign/{pubkey}", {
-        params: { path: { org_id: this.#orgId, pubkey } },
-        body: req,
-        headers,
-        parseAs: "json",
-      });
-      return assertOk(resp);
-    };
-    return new SignResponse(this.#orgId, sign, await sign());
+  /** Submit an EVM sign request. */
+  get signEvm() {
+    return this.#csc.signEvm.bind(this.#csc);
   }
 
-  /**
-   * Sign a stake request.
-   * @param {Eth2StakeRequest} req The request to sign.
-   * @return {Promise<Eth2StakeResponse | AcceptedResponse>} The response.
-   */
-  async stake(req: Eth2StakeRequest): Promise<SignResponse<Eth2StakeResponse>> {
-    const sign = async (headers?: HeadersInit) => {
-      const resp = await (
-        await this.sessionMgr.client()
-      ).post("/v1/org/{org_id}/eth2/stake", {
-        params: { path: { org_id: this.#orgId } },
-        body: req,
-        headers,
-        parseAs: "json",
-      });
-      return assertOk(resp);
-    };
-    return new SignResponse(this.#orgId, sign, await sign());
+  /** Submit an 'eth2' sign request. */
+  get signEth2() {
+    return this.#csc.signEth2.bind(this.#csc);
   }
 
-  /**
-   * Sign an unstake request.
-   * @param {Key | string} key The key to sign with (either {@link Key} or its material ID).
-   * @param {Eth2UnstakeRequest} req The request to sign.
-   * @return {Promise<Eth2UnstakeResponse | AcceptedResponse>} The response.
-   */
-  async unstake(
-    key: Key | string,
-    req: Eth2UnstakeRequest,
-  ): Promise<SignResponse<Eth2UnstakeResponse>> {
-    const pubkey = typeof key === "string" ? (key as string) : key.materialId;
-    const sign = async (headers?: HeadersInit) => {
-      const resp = await (
-        await this.sessionMgr.client()
-      ).post("/v1/org/{org_id}/eth2/unstake/{pubkey}", {
-        params: { path: { org_id: this.#orgId, pubkey } },
-        body: req,
-        headers,
-        parseAs: "json",
-      });
-      return assertOk(resp);
-    };
-    return new SignResponse(this.#orgId, sign, await sign());
+  /** Sign a stake request. */
+  get stake() {
+    return this.#csc.signStake.bind(this.#csc);
   }
 
-  /**
-   * Sign a raw blob.
-   * @param {Key | string} key The key to sign with (either {@link Key} or its ID).
-   * @param {BlobSignRequest} req What to sign
-   * @return {Promise<BlobSignResponse | AcceptedResponse>} The response.
-   */
-  async signBlob(key: Key | string, req: BlobSignRequest): Promise<SignResponse<BlobSignResponse>> {
-    const key_id = typeof key === "string" ? (key as string) : key.id;
-    const sign = async (headers?: HeadersInit) => {
-      const resp = await (
-        await this.sessionMgr.client()
-      ).post("/v1/org/{org_id}/blob/sign/{key_id}", {
-        params: {
-          path: { org_id: this.#orgId, key_id },
-        },
-        body: req,
-        headers,
-        parseAs: "json",
-      });
-      return assertOk(resp);
-    };
-    return new SignResponse(this.#orgId, sign, await sign());
+  /** Sign an unstake request. */
+  get unstake() {
+    return this.#csc.signUnstake.bind(this.#csc);
   }
 
-  /**
-   * Sign a bitcoin message.
-   * @param {Key | string} key The key to sign with (either {@link Key} or its material ID).
-   * @param {BtcSignRequest} req What to sign
-   * @return {Promise<BtcSignResponse | AcceptedResponse>} The response.
-   */
-  async signBtc(key: Key | string, req: BtcSignRequest): Promise<SignResponse<BtcSignResponse>> {
-    const pubkey = typeof key === "string" ? (key as string) : key.materialId;
-    const sign = async (headers?: HeadersInit) => {
-      const resp = await (
-        await this.sessionMgr.client()
-      ).post("/v0/org/{org_id}/btc/sign/{pubkey}", {
-        params: {
-          path: { org_id: this.#orgId, pubkey },
-        },
-        body: req,
-        headers: headers,
-        parseAs: "json",
-      });
-      return assertOk(resp);
-    };
-    return new SignResponse(this.#orgId, sign, await sign());
+  /** Sign a raw blob.*/
+  get signBlob() {
+    return this.#csc.signBlob.bind(this.#csc);
+  }
+
+  /** Sign a bitcoin message. */
+  get signBtc() {
+    return this.#csc.signBtc.bind(this.#csc);
+  }
+
+  /** Sign a solana message. */
+  get signSolana() {
+    return this.#csc.signSolana.bind(this.#csc);
+  }
+
+  /** Sign an Avalanche P- or X-chain message. */
+  get signAva() {
+    return this.#csc.signAva.bind(this.#csc);
   }
 
   /**
-   * Sign a solana message.
-   * @param {Key | string} key The key to sign with (either {@link Key} or its material ID).
-   * @param {SolanaSignRequest} req What to sign
-   * @return {Promise<SolanaSignResponse | AcceptedResponse>} The response.
+   * Obtain a proof of authentication.
    */
-  async signSolana(
-    key: Key | string,
-    req: SolanaSignRequest,
-  ): Promise<SignResponse<SolanaSignResponse>> {
-    const pubkey = typeof key === "string" ? (key as string) : key.materialId;
-    const sign = async (headers?: HeadersInit) => {
-      const resp = await (
-        await this.sessionMgr.client()
-      ).post("/v1/org/{org_id}/solana/sign/{pubkey}", {
-        params: { path: { org_id: this.#orgId, pubkey } },
-        body: req,
-        headers,
-        parseAs: "json",
-      });
-      return assertOk(resp);
-    };
-    return new SignResponse(this.#orgId, sign, await sign());
+  get proveIdentity() {
+    return this.#csc.identityProve.bind(this.#csc);
   }
 
   /**
@@ -441,33 +309,6 @@ export class SignerSession {
    * @internal
    */
   constructor(sessionMgr: SignerSessionManager) {
-    this.sessionMgr = sessionMgr;
-    this.#orgId = sessionMgr.orgId;
-  }
-
-  // --------------------------------------------------------------------------
-  // -- INTERNAL --------------------------------------------------------------
-  // --------------------------------------------------------------------------
-
-  /* eslint-disable require-jsdoc */
-
-  /**
-   * Static method for revoking a token (used both from {SignerSession} and {SignerSessionInfo}).
-   * @param {CubeSigner} cs CubeSigner instance
-   * @param {string} orgId Organization ID
-   * @param {string} roleId Role ID
-   * @param {string} sessionId Signer session ID
-   * @internal
-   */
-  static async revoke(cs: CubeSigner, orgId: string, roleId: string, sessionId: string) {
-    const resp = await (
-      await cs.management()
-    ).del("/v0/org/{org_id}/roles/{role_id}/tokens/{session_id}", {
-      params: {
-        path: { org_id: orgId, role_id: roleId, session_id: sessionId },
-      },
-      parseAs: "json",
-    });
-    assertOk(resp);
+    this.#csc = new CubeSignerClient(sessionMgr);
   }
 }

package/src/util.ts

@@ -1,5 +1,13 @@
 import * as path from "path";
 
+/** JSON map type */
+export interface JsonMap {
+  [member: string]: string | number | boolean | null | JsonArray | JsonMap;
+}
+
+/** JSON array type */
+export type JsonArray = Array<string | number | boolean | null | JsonArray | JsonMap>;
+
 /**
  * Directory where CubeSigner stores config files.
  * @return {string} Config dir
@@ -56,3 +64,36 @@ export function assertOk<D, T>(resp: ResponseType<D, T>, description?: string):
   }
   return resp.data;
 }
+
+/**
+ * Browser-friendly helper for decoding a 'base64url'-encoded string into a byte array.
+ *
+ * @param {string} b64url The 'base64url'-encoded string to decode
+ * @return {Uint8Array} Decoded byte array
+ */
+export function decodeBase64Url(b64url: string): Uint8Array {
+  const b64 = b64url.replace(/-/g, "+").replace(/_/g, "/").replace(/=*$/g, "");
+
+  // NOTE: there is no "base64url" encoding in the "buffer" module for the browser (unlike in node.js)
+  return typeof Buffer === "function"
+    ? Buffer.from(b64, "base64")
+    : Uint8Array.from(atob(b64), (c) => c.charCodeAt(0));
+}
+
+/**
+ * Browser-friendly helper for encoding a byte array into a 'base64url`-encoded string.
+ *
+ * @param {Iterable<number>} buffer The byte array to encode
+ * @return {string} The 'base64url' encoding of the byte array.
+ */
+export function encodeToBase64Url(buffer: Iterable<number>): string {
+  const bytes = new Uint8Array(buffer);
+
+  // NOTE: there is no "base64url" encoding in the "buffer" module for the browser (unlike in node.js)
+  const b64 =
+    typeof Buffer === "function"
+      ? Buffer.from(bytes).toString("base64")
+      : btoa(bytes.reduce((s, b) => s + String.fromCharCode(b), ""));
+
+  return b64.replace(/\+/g, "-").replace(/\//g, "_").replace(/=*$/g, "");
+}