@calimero-network/mero-js 19.14.1 → 19.16.0

package/dist/index.d.ts

@@ -1,33 +1,36 @@
-export { MeroJs, createMeroJs } from './mero-js.js';
-export type { MeroJsConfig, TokenData } from './mero-js.js';
-export * from './http-client/index.js';
-export * from './auth-api/index.js';
-export * from './admin-api/index.js';
-export { parseAuthCallback, buildAuthLoginUrl } from './auth/index.js';
-export type { AuthCallbackResult, AuthLoginOptions } from './auth/index.js';
-export { MemoryTokenStore, LocalStorageTokenStore } from './token-store/index.js';
-export type { TokenStore } from './token-store/index.js';
-export { RpcClient, RpcError } from './rpc/index.js';
-export type { MigrateMyEntriesSummary } from './rpc/index.js';
-export type { ExecuteParams } from './rpc/index.js';
-export { SseClient, WsClient } from './events/index.js';
-export type { SseEventData, WsEventData, AppVersionChangedEvent, GroupMembershipEventData, GroupMigrationEventData, MigrationStartedData, MigrationProgressData, CascadeProgressData, MigrationCompletedData, } from './events/index.js';
-export { EphemeralClient, jsonCodec } from './ephemeral/index.js';
-export type { Codec, EphemeralEntry } from './ephemeral/index.js';
-export * from './cloud/index.js';
-export * from './relay/index.js';
-export { signWarrant, intentHash } from './warrant/index.js';
-export { generateAccountRoot, accountRootFromPhrase, accountRootFromSecret, signAccountLink, signAccountLogin, } from './account/index.js';
-export type { AccountRoot, RecoverableAccountRoot, AccountLinkInput, AccountLoginInput, } from './account/index.js';
-export { signDeviceCert, mintDeviceId, deviceCertPayload, accountForRoot, } from './device-cert/index.js';
-export type { DeviceCertInput } from './device-cert/index.js';
-export { signMemberJoinOp, encodeSignedInvitation, SIGNED_NAMESPACE_OP_SCHEMA_VERSION, } from './namespace-op/index.js';
-export type { SignMemberJoinInput } from './namespace-op/index.js';
-export type { WarrantInput } from './warrant/index.js';
-export { signLoginStatement } from './login/index.js';
-export type { Audience, LoginStatementInput } from './login/index.js';
-export { login, generateSessionKey } from './login/index.js';
-export type { LoginConfig, DelegatedSession, SessionKeyPair, } from './login/index.js';
-export * from './capabilities.js';
-export { DEFAULT_LOCAL_NODE_PORTS, localNodeUrl, nodeEndpoint, probeNodeHealth, discoverLocalNodes, } from './nodeDiscovery.js';
-export type { DiscoverLocalNodesOptions } from './nodeDiscovery.js';
+export { MeroJs, createMeroJs } from "./mero-js.js";
+export type { MeroJsConfig, TokenData } from "./mero-js.js";
+export * from "./http-client/index.js";
+export * from "./auth-api/index.js";
+export * from "./admin-api/index.js";
+export { parseAuthCallback, buildAuthLoginUrl } from "./auth/index.js";
+export type { AuthCallbackResult, AuthLoginOptions } from "./auth/index.js";
+export { MemoryTokenStore, LocalStorageTokenStore, } from "./token-store/index.js";
+export type { TokenStore } from "./token-store/index.js";
+export { RpcClient, RpcError } from "./rpc/index.js";
+export type { MigrateMyEntriesSummary } from "./rpc/index.js";
+export type { ExecuteParams } from "./rpc/index.js";
+export { SseClient, WsClient } from "./events/index.js";
+export type { SseEventData, WsEventData, AppVersionChangedEvent, GroupMembershipEventData, GroupMigrationEventData, MigrationStartedData, MigrationProgressData, CascadeProgressData, MigrationCompletedData, } from "./events/index.js";
+export { EphemeralClient, jsonCodec } from "./ephemeral/index.js";
+export type { Codec, EphemeralEntry } from "./ephemeral/index.js";
+export * from "./cloud/index.js";
+export * from "./relay/index.js";
+export { signWarrant, intentHash } from "./warrant/index.js";
+export { generateAccountRoot, accountRootFromPhrase, accountRootFromSecret, signAccountLink, signAccountLogin, } from "./account/index.js";
+export type { AccountRoot, RecoverableAccountRoot, AccountLinkInput, AccountLoginInput, } from "./account/index.js";
+export { signDeviceCert, mintDeviceId, deviceCertPayload, accountForRoot, } from "./device-cert/index.js";
+export type { DeviceCertInput } from "./device-cert/index.js";
+export { signMemberJoinOp, encodeSignedInvitation, SIGNED_NAMESPACE_OP_SCHEMA_VERSION, } from "./namespace-op/index.js";
+export type { SignMemberJoinInput } from "./namespace-op/index.js";
+export type { WarrantInput } from "./warrant/index.js";
+export { requestBodyHash, signRequest, callerProof, createProofSigner, } from "./request/index.js";
+export type { CallerProofInput, ProofRequest, ProofSignerOptions, } from "./request/index.js";
+export type { RequestSigInput } from "./request/index.js";
+export { signLoginStatement } from "./login/index.js";
+export type { Audience, LoginStatementInput } from "./login/index.js";
+export { login, generateSessionKey } from "./login/index.js";
+export type { LoginConfig, DelegatedSession, SessionKeyPair, } from "./login/index.js";
+export * from "./capabilities.js";
+export { DEFAULT_LOCAL_NODE_PORTS, localNodeUrl, nodeEndpoint, probeNodeHealth, discoverLocalNodes, } from "./nodeDiscovery.js";
+export type { DiscoverLocalNodesOptions } from "./nodeDiscovery.js";

package/dist/index.js

@@ -1,37 +1,38 @@
 // Mero.js - Pure JavaScript SDK for Calimero
 // This will contain the pure JavaScript SDK without React dependencies
 // Main SDK class
-export { MeroJs, createMeroJs } from './mero-js.js';
+export { MeroJs, createMeroJs } from "./mero-js.js";
 // HTTP client module (Web Standards based)
-export * from './http-client/index.js';
+export * from "./http-client/index.js";
 // Auth API client
-export * from './auth-api/index.js';
+export * from "./auth-api/index.js";
 // Admin API client
-export * from './admin-api/index.js';
+export * from "./admin-api/index.js";
 // Auth utilities
-export { parseAuthCallback, buildAuthLoginUrl } from './auth/index.js';
+export { parseAuthCallback, buildAuthLoginUrl } from "./auth/index.js";
 // Token store
-export { MemoryTokenStore, LocalStorageTokenStore } from './token-store/index.js';
+export { MemoryTokenStore, LocalStorageTokenStore, } from "./token-store/index.js";
 // RPC client
-export { RpcClient, RpcError } from './rpc/index.js';
+export { RpcClient, RpcError } from "./rpc/index.js";
 // Events (SSE / WebSocket)
-export { SseClient, WsClient } from './events/index.js';
+export { SseClient, WsClient } from "./events/index.js";
 // Ephemeral presence (cursors / typing / online)
-export { EphemeralClient, jsonCodec } from './ephemeral/index.js';
+export { EphemeralClient, jsonCodec } from "./ephemeral/index.js";
 // Cloud client — namespaces, relays, HA, and the cloud sign-in path
-export * from './cloud/index.js';
+export * from "./cloud/index.js";
 // Relay client — write through delegated execution, holding only a signing key
-export * from './relay/index.js';
+export * from "./relay/index.js";
 // Warrant signing — mint the author's consent for a relay to run one intent
-export { signWarrant, intentHash } from './warrant/index.js';
+export { signWarrant, intentHash } from "./warrant/index.js";
 // Account roots — mint one with a recovery phrase, or prove you hold one
-export { generateAccountRoot, accountRootFromPhrase, accountRootFromSecret, signAccountLink, signAccountLogin, } from './account/index.js';
-export { signDeviceCert, mintDeviceId, deviceCertPayload, accountForRoot, } from './device-cert/index.js';
-export { signMemberJoinOp, encodeSignedInvitation, SIGNED_NAMESPACE_OP_SCHEMA_VERSION, } from './namespace-op/index.js';
+export { generateAccountRoot, accountRootFromPhrase, accountRootFromSecret, signAccountLink, signAccountLogin, } from "./account/index.js";
+export { signDeviceCert, mintDeviceId, deviceCertPayload, accountForRoot, } from "./device-cert/index.js";
+export { signMemberJoinOp, encodeSignedInvitation, SIGNED_NAMESPACE_OP_SCHEMA_VERSION, } from "./namespace-op/index.js";
 // Login-statement signing — the device's half of a password-free session
-export { signLoginStatement } from './login/index.js';
-export { login, generateSessionKey } from './login/index.js';
+export { requestBodyHash, signRequest, callerProof, createProofSigner, } from "./request/index.js";
+export { signLoginStatement } from "./login/index.js";
+export { login, generateSessionKey } from "./login/index.js";
 // Member capability bitmask constants & helpers
-export * from './capabilities.js';
+export * from "./capabilities.js";
 // Utilities
-export { DEFAULT_LOCAL_NODE_PORTS, localNodeUrl, nodeEndpoint, probeNodeHealth, discoverLocalNodes, } from './nodeDiscovery.js';
+export { DEFAULT_LOCAL_NODE_PORTS, localNodeUrl, nodeEndpoint, probeNodeHealth, discoverLocalNodes, } from "./nodeDiscovery.js";

package/dist/index.mjs

@@ -85,6 +85,14 @@ function headersToRecord(headers) {
   });
   return record;
 }
+function pathForProof(url) {
+  try {
+    return new URL(url).pathname;
+  } catch {
+    const query = url.indexOf("?");
+    return query === -1 ? url : url.slice(0, query);
+  }
+}
 var WebHttpClient = class {
   constructor(transport) {
     this.transport = transport;
@@ -211,6 +219,16 @@ var WebHttpClient = class {
     if (init?.keepalive !== void 0) {
       requestInit.keepalive = init.keepalive;
     }
+    if (this.transport.getProof) {
+      const proof = await this.transport.getProof({
+        method: requestInit.method ?? "GET",
+        path: pathForProof(url),
+        body: requestInit.body
+      });
+      if (proof) {
+        headersObj["X-Calimero-Proof"] = proof;
+      }
+    }
     try {
       const response = await this.transport.fetch(url, requestInit);
       if (!response.ok) {
@@ -407,6 +425,7 @@ function createBrowserHttpClient(options) {
     fetch: (url, init) => globalThis.fetch(url, init),
     baseUrl: options.baseUrl,
     getAuthToken: options.getAuthToken,
+    getProof: options.getProof,
     onTokenRefresh: options.onTokenRefresh,
     refreshToken: options.refreshToken,
     onAuthRevoked: options.onAuthRevoked,
@@ -433,6 +452,7 @@ function createNodeHttpClient(options) {
     fetch: isDefaultFetch ? (url, init) => globalThis.fetch(url, init) : (url, init) => fetchImpl(url, init),
     baseUrl: options.baseUrl,
     getAuthToken: options.getAuthToken,
+    getProof: options.getProof,
     onTokenRefresh: options.onTokenRefresh,
     refreshToken: options.refreshToken,
     onAuthRevoked: options.onAuthRevoked,
@@ -2572,6 +2592,17 @@ function fromHex(value, label, expectedBytes) {
   }
   return bytes;
 }
+function fromHexUnsized(value, label) {
+  const clean = value.trim();
+  if (!/^[0-9a-fA-F]*$/.test(clean) || clean.length % 2 !== 0) {
+    throw new Error(`${label} must be an even number of hex characters`);
+  }
+  const bytes = new Uint8Array(clean.length / 2);
+  for (let i = 0; i < bytes.length; i += 1) {
+    bytes[i] = Number.parseInt(clean.slice(i * 2, i * 2 + 2), 16);
+  }
+  return bytes;
+}
 function u64le(value) {
   const out = new Uint8Array(8);
   new DataView(out.buffer).setBigUint64(0, BigInt(value), true);
@@ -6442,8 +6473,88 @@ async function signMemberJoinOp(input) {
   return hex(concat(signable, signature, unendorsed));
 }
 
+// src/request/request-sig.ts
+var SIGN_DOMAIN2 = new TextEncoder().encode("calimero.auth.request.v1");
+var BODY_DOMAIN = new TextEncoder().encode("calimero.auth.request.body.v1");
+function borshString2(value) {
+  const bytes = new TextEncoder().encode(value);
+  return concat(u32le(bytes.length), bytes);
+}
+async function requestBodyHash(body = new Uint8Array(0)) {
+  const bytes = typeof body === "string" ? new TextEncoder().encode(body) : body;
+  return domainHash(BODY_DOMAIN, [bytes]);
+}
+async function signRequest(input) {
+  const key = await importSigningKey(input.signerSecret);
+  const bodyHash = await requestBodyHash(input.body);
+  const issuedAt = u64le(input.issuedAt);
+  const expiresAt = u64le(input.expiresAt);
+  const encoder = new TextEncoder();
+  const preimage = await domainHash(SIGN_DOMAIN2, [
+    encoder.encode(input.method),
+    encoder.encode(input.path),
+    bodyHash,
+    issuedAt,
+    expiresAt
+  ]);
+  const signature = new Uint8Array(
+    await crypto.subtle.sign({ name: "Ed25519" }, key, preimage)
+  );
+  return hex(
+    concat(
+      borshString2(input.method),
+      borshString2(input.path),
+      bodyHash,
+      issuedAt,
+      expiresAt,
+      signature
+    )
+  );
+}
+
+// src/request/caller-proof.ts
+function callerProof(input) {
+  const credential = fromHexUnsized(input.credential, "credential");
+  const request = fromHexUnsized(input.request, "request signature");
+  const session = input.session === void 0 ? new Uint8Array([0]) : concat(new Uint8Array([1]), fromHexUnsized(input.session, "session statement"));
+  return hex(concat(credential, session, request));
+}
+
+// src/request/proof-signer.ts
+function bodyBytes(body) {
+  if (body === void 0 || body === null) return new Uint8Array(0);
+  if (typeof body === "string") return body;
+  if (body instanceof Uint8Array) return body;
+  if (body instanceof ArrayBuffer) return new Uint8Array(body);
+  if (ArrayBuffer.isView(body)) {
+    return new Uint8Array(body.buffer, body.byteOffset, body.byteLength);
+  }
+  throw new Error(
+    `a request-carried proof cannot commit to a ${body?.constructor?.name ?? typeof body} body: pass a string or bytes, or use a session for this call`
+  );
+}
+function createProofSigner(options) {
+  const ttl = options.ttlSeconds ?? 120;
+  const clock = options.now ?? (() => Math.floor(Date.now() / 1e3));
+  return async (request) => {
+    const issuedAt = clock();
+    return callerProof({
+      credential: options.credential,
+      session: options.session,
+      request: await signRequest({
+        method: request.method,
+        path: request.path,
+        body: bodyBytes(request.body),
+        issuedAt,
+        expiresAt: issuedAt + ttl,
+        signerSecret: options.signerSecret
+      })
+    });
+  };
+}
+
 // src/login/login.ts
-var SIGN_DOMAIN2 = new TextEncoder().encode("calimero.auth.login.v1");
+var SIGN_DOMAIN3 = new TextEncoder().encode("calimero.auth.login.v1");
 var AUDIENCE_TAG = {
   webOrigin: 0,
   codeSigningId: 1,
@@ -6482,7 +6593,7 @@ async function signLoginStatement(input) {
   const deviceKey = await derivePublicKey(input.deviceSecret);
   const issuedAt = u64le(input.issuedAt);
   const expiresAt = u64le(input.expiresAt);
-  const preimage = await domainHash(SIGN_DOMAIN2, [
+  const preimage = await domainHash(SIGN_DOMAIN3, [
     node,
     audienceSigningBytes(input.audience),
     challenge,
@@ -6683,6 +6794,7 @@ export {
   accountRootFromPhrase,
   accountRootFromSecret,
   buildAuthLoginUrl,
+  callerProof,
   combineSignals,
   compareSemver,
   connectCloud,
@@ -6700,6 +6812,7 @@ export {
   createNodeAdminApiClient,
   createNodeAuthApiClient,
   createNodeHttpClient,
+  createProofSigner,
   createRetryableMethod,
   createTimeoutSignal,
   createUniversalHttpClient,
@@ -6718,12 +6831,14 @@ export {
   nodeEndpoint,
   parseAuthCallback,
   probeNodeHealth,
+  requestBodyHash,
   routingProofHeaders,
   signAccountLink,
   signAccountLogin,
   signDeviceCert,
   signLoginStatement,
   signMemberJoinOp,
+  signRequest,
   signRoutingChallenge,
   signWarrant,
   withCap,