@tinycloud/node-sdk 3.10.0 → 3.11.0-beta.1

package/dist/encryption-keys.d.cts

@@ -1,6 +1,6 @@
 import { NamedKeyClient } from '@tinycloud/sdk-services/encryption/named-keys';
 export { DecryptManyResult, KeyCallOptions, KeyDescriptor, KeyEncryptOptions, NamedKeyClient, NamedKeyEnvelope, NamedKeyError, NamedKeyErrorCode, PublicKeyDescriptor, buildKeyAdminFacts, buildKeyDescribeFacts } from '@tinycloud/sdk-services/encryption/named-keys';
-import { T as TinyCloudNode } from './TinyCloudNode-BhWBbCay.cjs';
+import { T as TinyCloudNode } from './TinyCloudNode-CnVaWnAX.cjs';
 import '@tinycloud/sdk-core';
 import '@tinycloud/sdk-services/kv/replication';
 import '@tinycloud/sdk-services';

package/dist/encryption-keys.d.ts

@@ -1,6 +1,6 @@
 import { NamedKeyClient } from '@tinycloud/sdk-services/encryption/named-keys';
 export { DecryptManyResult, KeyCallOptions, KeyDescriptor, KeyEncryptOptions, NamedKeyClient, NamedKeyEnvelope, NamedKeyError, NamedKeyErrorCode, PublicKeyDescriptor, buildKeyAdminFacts, buildKeyDescribeFacts } from '@tinycloud/sdk-services/encryption/named-keys';
-import { T as TinyCloudNode } from './TinyCloudNode-BjJJIifr.js';
+import { T as TinyCloudNode } from './TinyCloudNode-BlNcvo1c.js';
 import '@tinycloud/sdk-core';
 import '@tinycloud/sdk-services/kv/replication';
 import '@tinycloud/sdk-services';

package/dist/index.cjs

@@ -18969,6 +18969,16 @@ var MemorySessionStorage = class {
 };
 
 // src/authorization/NodeUserAuthorization.ts
+function assertMaxExpiresAt(value) {
+  if (value === void 0 || typeof value === "function") return;
+  const ms = value instanceof Date ? value.getTime() : value;
+  if (typeof ms !== "number" || !Number.isFinite(new Date(ms).getTime())) {
+    throw new Error("maxExpiresAt must be a finite number of epoch milliseconds, a valid Date, or a function returning one");
+  }
+}
+function lastAnchoredLine(siwe, pattern) {
+  return [...siwe.matchAll(pattern)].at(-1)?.[1];
+}
 function pkhSpaceIdentity(spaceId) {
   const match = /^(tinycloud:pkh:eip155:\d+:)(0x[0-9a-fA-F]{40})(:.+)$/.exec(spaceId);
   return match === null ? spaceId : `${match[1]}${match[2].toLowerCase()}${match[3]}`;
@@ -19942,7 +19952,7 @@ var NodeUserAuthorization = class {
     }
     const jwk = JSON.parse(jwkString);
     const now = /* @__PURE__ */ new Date();
-    const expirationTime = new Date(now.getTime() + this.sessionExpirationMs);
+    const expirationTime = this.sessionExpiryFrom(now);
     const primaryIdentity = pkhSpaceIdentity(options.spaceId);
     const resourcesBySpace = /* @__PURE__ */ new Map();
     for (const resource of options.capabilityRequest.resources) {
@@ -19997,6 +20007,17 @@ var NodeUserAuthorization = class {
       signature: signature2
     };
   }
+  /**
+   * When a session that starts at `now` ends. Refused with a dated message when
+   * the configured lifetime reaches past what a sign-in message can carry,
+   * instead of the bare `RangeError` or WASM parse error `toISOString()` and
+   * `prepareSession` would otherwise give.
+   */
+  sessionExpiryFrom(now) {
+    const expirationTime = new Date(now.getTime() + this.sessionExpirationMs);
+    (0, import_sdk_core5.assertExpiryWithinTechnicalLimit)(expirationTime, "siwe");
+    return expirationTime;
+  }
   persistedData(session, expiresAt, createdAt, replicaStamp) {
     return {
       address: session.address,
@@ -20052,7 +20073,7 @@ var NodeUserAuthorization = class {
     const capabilityPlan = this.resolveSignInCapabilities(address, chainId);
     const spaceId = capabilityPlan.spaceId;
     const now = /* @__PURE__ */ new Date();
-    const expirationTime = new Date(now.getTime() + this.sessionExpirationMs);
+    const expirationTime = this.sessionExpiryFrom(now);
     const prepared = this.prepareSessionWithResources({
       abilities: capabilityPlan.abilities,
       ...capabilityPlan.spaceAbilities !== void 0 ? { spaceAbilities: capabilityPlan.spaceAbilities } : {},
@@ -20198,7 +20219,7 @@ var NodeUserAuthorization = class {
     const capabilityPlan = this.resolveSignInCapabilities(address, chainId);
     const spaceId = capabilityPlan.spaceId;
     const now = /* @__PURE__ */ new Date();
-    const expirationTime = new Date(now.getTime() + this.sessionExpirationMs);
+    const expirationTime = this.sessionExpiryFrom(now);
     const prepared = this.prepareSessionWithResources({
       abilities: capabilityPlan.abilities,
       ...capabilityPlan.spaceAbilities !== void 0 ? { spaceAbilities: capabilityPlan.spaceAbilities } : {},
@@ -20261,10 +20282,8 @@ var NodeUserAuthorization = class {
       siwe: prepared.siwe,
       signature: signature2
     };
-    const expirationMatch = prepared.siwe?.match(/Expiration Time: (.+)/);
-    const issuedAtMatch = prepared.siwe?.match(/Issued At: (.+)/);
-    const expiresAt = expirationMatch?.[1] ?? new Date(Date.now() + this.sessionExpirationMs).toISOString();
-    const createdAt = issuedAtMatch?.[1] ?? (/* @__PURE__ */ new Date()).toISOString();
+    const expiresAt = lastAnchoredLine(prepared.siwe ?? "", /^Expiration Time: (.+)$/gm) ?? this.sessionExpiryFrom(/* @__PURE__ */ new Date()).toISOString();
+    const createdAt = lastAnchoredLine(prepared.siwe ?? "", /^Issued At: (.+)$/gm) ?? (/* @__PURE__ */ new Date()).toISOString();
     const replicaStamp = await this.establishReplicaStamp?.(tinyCloudSession);
     const persistedData = this.persistedData(tinyCloudSession, expiresAt, createdAt, replicaStamp);
     await this.sessionStorage.save(address, persistedData);
@@ -20323,6 +20342,7 @@ var NodeUserAuthorization = class {
   /** Finish address, host and SIWE preparation before an approval click. */
   async prepareOpenKeySignIn(options) {
     refuseCaveated(this.getCapabilityRequest()?.manifests);
+    assertMaxExpiresAt(options?.maxExpiresAt);
     if (options?.host !== void 0) {
       const overrideHost = options.host.trim();
       if (!overrideHost) {
@@ -20343,7 +20363,9 @@ var NodeUserAuthorization = class {
       verificationMethod: prepared.verificationMethod,
       host: hostHint,
       keyId: options?.openkeyKeyId,
-      presentation
+      presentation,
+      // Present only when set, so the default request shape is unchanged.
+      ...options?.expiryChangeable === true ? { expiryChangeable: true } : {}
     };
     return {
       request: originalRequest,
@@ -20353,7 +20375,10 @@ var NodeUserAuthorization = class {
       address,
       chainId,
       generation: this.sessionGeneration,
-      createdAt: Date.now()
+      createdAt: Date.now(),
+      // Kept in memory with the pending request. It is not part of `request`, so it is never sent to OpenKey, and
+      // nothing here is persisted.
+      ...options?.maxExpiresAt === void 0 ? {} : { maxExpiresAt: options.maxExpiresAt }
     };
   }
   /** Complete a prepared approval. The caller starts authorization before awaiting this method. */
@@ -20371,7 +20396,11 @@ var NodeUserAuthorization = class {
     for (let attempt = 0; ; ) {
       try {
         result ?? (result = await authorization);
-        signed2 = await this.verifyOpenKeyResult(result, prepared);
+        signed2 = await this.verifyOpenKeyResult(result, prepared, {
+          // Relax only for a request that actually carried the opt-in.
+          allowExpirationChange: originalRequest.expiryChangeable === true,
+          maxExpiresAt: pending.maxExpiresAt
+        });
         signature2 = result.signature;
         break;
       } catch (error) {
@@ -20463,13 +20492,23 @@ var NodeUserAuthorization = class {
    *    in the original prepared SIWE — narrowing OK, broadening rejected.
    * 5. Every `result.selectedActionKeys` entry corresponds to a
    *    (resource, action) pair in the returned SIWE.
+   *
+   * `options.expiryChangeable` is true only when the request sent to OpenKey
+   * carried `expiryChangeable: true`. Then (and only then) the signed
+   * `Expiration Time` may differ from the prepared one and is the expiry the
+   * session is built with; the changed expiry must pass
+   * `checkChangedExpiration` and every other field in (3) must still match.
+   * Without it, any expiry difference is refused as in (3).
    */
-  async signInWithOpenKeyResult(result, prepared, keyId, jwk) {
-    const signed2 = await this.verifyOpenKeyResult(result, prepared);
+  async signInWithOpenKeyResult(result, prepared, keyId, jwk, options) {
+    const signed2 = await this.verifyOpenKeyResult(result, prepared, {
+      allowExpirationChange: options?.expiryChangeable === true,
+      maxExpiresAt: options?.maxExpiresAt
+    });
     return this.signInWithPreparedSession(signed2, result.signature, keyId, jwk);
   }
   /** Validate a candidate without activating a network session, so paste retries reuse one preparation. */
-  async verifyOpenKeyResult(result, prepared) {
+  async verifyOpenKeyResult(result, prepared, options) {
     if (result.protocolVersion !== 1) {
       throw new Error(`Unsupported OpenKey protocol version ${result.protocolVersion}`);
     }
@@ -20512,16 +20551,39 @@ var NodeUserAuthorization = class {
         `OpenKey signedMessage.address (${parsedSignedSiwe.address}) does not match local signer address (${expectedAddress})`
       );
     }
+    const parsedExpiry = parsedSignedSiwe.expirationTime;
+    const lineExpiry = lastAnchoredLine(result.signedMessage, /^Expiration Time: (.+)$/gm);
+    if (parsedExpiry === void 0 || parsedExpiry === null || lineExpiry === void 0) {
+      throw new Error("OpenKey signedMessage has no Expiration Time line of its own");
+    }
+    const parsedExpiryMs = Date.parse(parsedExpiry);
+    if (!Number.isFinite(parsedExpiryMs) || parsedExpiryMs !== Date.parse(lineExpiry)) {
+      throw new Error("OpenKey signedMessage Expiration Time line does not match the message's own expiry");
+    }
     const originalHasRecap = /(?:^|\n)-\s+urn:recap:/i.test(prepared.siwe);
     const originalFields = (0, import_sdk_core5.extractImmutableSiweFields)(prepared.siwe);
     const signedFields = (0, import_sdk_core5.extractImmutableSiweFields)(result.signedMessage);
-    const changedFields = (0, import_sdk_core5.diffImmutableSiweFields)(originalFields, signedFields, {
-      originalHasRecap
-    });
-    if (changedFields.length > 0) {
-      throw new Error(
-        `OpenKey signedMessage altered immutable SIWE fields: ${changedFields.join(", ")}`
-      );
+    if (options?.allowExpirationChange === true) {
+      const maxExpiresAt = typeof options.maxExpiresAt === "function" ? options.maxExpiresAt() : options.maxExpiresAt;
+      const refusal = (0, import_sdk_core5.checkChangedExpiration)({
+        preparedSiwe: prepared.siwe,
+        signedSiwe: result.signedMessage,
+        now: Date.now(),
+        originalHasRecap,
+        ...maxExpiresAt === void 0 ? {} : { maxExpiresAt }
+      });
+      if (refusal !== null) {
+        throw new Error(`OpenKey signedMessage ${refusal}`);
+      }
+    } else {
+      const changedFields = (0, import_sdk_core5.diffImmutableSiweFields)(originalFields, signedFields, {
+        originalHasRecap
+      });
+      if (changedFields.length > 0) {
+        throw new Error(
+          `OpenKey signedMessage altered immutable SIWE fields: ${changedFields.join(", ")}`
+        );
+      }
     }
     let originalCaps;
     let signedCaps;
@@ -22706,14 +22768,14 @@ var _TinyCloudNode = class _TinyCloudNode {
     await this.signInWith(() => this.auth.signInWithOpenKey(authorizeFn, options));
   }
   /** Prepare the OpenKey request before the approval click. */
-  async prepareOpenKeySignIn() {
+  async prepareOpenKeySignIn(options) {
     if (!this.signer || !this.tc || !this.auth) {
       throw new Error("Cannot prepare OpenKey sign-in in session-only mode. Provide a signer in config.");
     }
     await this.signOutInFlight;
     await this.accountRegistryTail;
     await this.wasmBindings.ensureInitialized?.();
-    return this.auth.prepareOpenKeySignIn();
+    return this.auth.prepareOpenKeySignIn(options);
   }
   /** Start OpenKey authorization synchronously, then complete normal session setup. */
   signInWithPreparedOpenKey(pending, authorizeFn) {
@@ -25297,7 +25359,7 @@ var _TinyCloudNode = class _TinyCloudNode {
         path: "",
         // Root access
         actions: [...ROOT_DELEGATION_ACTIONS],
-        expiry: this.getSessionExpiry(),
+        expiry: this.getSignedSessionExpiry(),
         isRevoked: false,
         allowSubDelegation: true
       };
@@ -25310,7 +25372,7 @@ var _TinyCloudNode = class _TinyCloudNode {
             spaceId,
             path: "",
             actions: [...ROOT_DELEGATION_ACTIONS],
-            expiry: this.getSessionExpiry(),
+            expiry: this.getSignedSessionExpiry(),
             isRevoked: false,
             allowSubDelegation: true
           });
@@ -25402,7 +25464,7 @@ var _TinyCloudNode = class _TinyCloudNode {
       assertActive: () => graph.assertActive(),
       keyProvider: this._keyProvider,
       registry: this._capabilityRegistry,
-      sessionExpiry: this.getSessionExpiry(),
+      sessionExpiry: this.getSignedSessionExpiry(),
       createDelegationWasm: (params) => {
         graph.assertActive();
         return this.createDelegationWrapper(params);
@@ -25449,6 +25511,29 @@ var _TinyCloudNode = class _TinyCloudNode {
     const expirationMs = this.config.sessionExpirationMs ?? DEFAULT_SESSION_EXPIRATION_MS;
     return new Date(Date.now() + expirationMs);
   }
+  /**
+   * The expiry of the session that was actually signed, so the registry root
+   * and the sharing service never outlive or undercut what the SIWE grants
+   * (a user may change the expiry in the OpenKey approval).
+   *
+   * Any expiry the SIWE parses to is used exactly as signed, however near or
+   * far. The configured lifetime is used only when the SIWE cannot be parsed
+   * (the session is already established, so failing sign-in here would be
+   * worse; real sign-ins verify the SIWE first) or when a valid SIWE carries
+   * no `Expiration Time` line, as the other `extractSiweExpiration` callers do.
+   * @internal
+   */
+  getSignedSessionExpiry() {
+    const siwe = this.auth?.tinyCloudSession?.siwe;
+    if (!siwe) return this.getSessionExpiry();
+    let signed2;
+    try {
+      signed2 = extractSiweExpiration(siwe);
+    } catch {
+      return this.getSessionExpiry();
+    }
+    return signed2 ?? this.getSessionExpiry();
+  }
   /**
    * Wrapper for the WASM createDelegation function.
    *
@@ -25478,6 +25563,7 @@ var _TinyCloudNode = class _TinyCloudNode {
       // DID here and rejects the fragment as an invalid audience DID.
       verificationMethod: params.session.verificationMethod.split("#", 1)[0]
     };
+    (0, import_sdk_core10.assertExpiryWithinTechnicalLimit)(params.expirationSecs * 1e3, "ucan");
     const result = this.wasmBindings.createDelegation(
       wasmSession,
       params.delegateDID,
@@ -25510,9 +25596,10 @@ var _TinyCloudNode = class _TinyCloudNode {
     }
     const permissions = ownerDelegationPermissions(params);
     const now = /* @__PURE__ */ new Date();
-    if (!(params.expiresAt instanceof Date) || params.expiresAt.getTime() <= now.getTime() || params.expiresAt.getTime() - now.getTime() > import_sdk_core10.EXPIRY.MAX_MS) {
-      throw new Error("Owner delegation expiry must be explicit, future, and within EXPIRY.MAX_MS");
+    if (!(params.expiresAt instanceof Date) || params.expiresAt.getTime() <= now.getTime()) {
+      throw new Error("Owner delegation expiry must be explicit, future, and a valid date");
     }
+    (0, import_sdk_core10.assertExpiryWithinTechnicalLimit)(params.expiresAt, "siwe");
     if (!this.signer) throw new Error("Owner wallet signer is required");
     const session = this.currentTinyCloudSession();
     if (!session) throw new Error("Owner session is required");
@@ -25613,6 +25700,7 @@ var _TinyCloudNode = class _TinyCloudNode {
    * not sent.
    */
   async authorizeShareDeliveryV3(input) {
+    (0, import_sdk_core10.assertExpiryWithinTechnicalLimit)(new Date(input.expiresAt), "siwe");
     const envelopeRef = await (0, import_sdk_core10.shortDeliveryLinkBodyCid)(input.shareUrl, input.trustedOrigins);
     const session = this.currentTinyCloudSession();
     const serviceSession = this._serviceContext?.session;
@@ -25665,6 +25753,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     };
   }
   async createRootDelegationForSharing(params, assertActive) {
+    (0, import_sdk_core10.assertExpiryWithinTechnicalLimit)(params.requestedExpiry, "siwe");
     try {
       return (await this.createOwnerDelegation({
         delegateDid: params.shareKeyDID,
@@ -26361,6 +26450,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     if (sessionExpiry !== void 0 && sessionExpiry < expiresAt) {
       expiresAt = sessionExpiry;
     }
+    (0, import_sdk_core10.assertExpiryWithinTechnicalLimit)(expiresAt, "siwe");
     const delegations = [];
     let rawEntriesAttached = false;
     for (const [spaceId, entries] of bySpace) {
@@ -27833,6 +27923,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     const now = /* @__PURE__ */ new Date();
     const expiryMs = params.expiryMs ?? 60 * 60 * 1e3;
     const expirationTime = new Date(now.getTime() + expiryMs);
+    (0, import_sdk_core10.assertExpiryWithinTechnicalLimit)(expirationTime, "siwe");
     const prepared = this.wasmBindings.prepareSession({
       abilities,
       address: this.wasmBindings.ensureEip55(session.address),
@@ -27987,6 +28078,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     const { abilities, rawAbilities } = this.buildActivationAbilities(delegation);
     const now = /* @__PURE__ */ new Date();
     const expirationTime = delegation.expiry;
+    (0, import_sdk_core10.assertExpiryWithinTechnicalLimit)(expirationTime, "siwe");
     const prepared = this.wasmBindings.prepareSession({
       abilities,
       address: this.wasmBindings.ensureEip55(mySession.address),
@@ -28106,6 +28198,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     const now = /* @__PURE__ */ new Date();
     const requestedExpiry = params.expiryMs === void 0 ? parentDelegation.expiry : new Date(now.getTime() + params.expiryMs);
     const actualExpiry = requestedExpiry > parentDelegation.expiry ? parentDelegation.expiry : requestedExpiry;
+    (0, import_sdk_core10.assertExpiryWithinTechnicalLimit)(actualExpiry, "siwe");
     const abilities = {};
     const rawAbilities = {};
     for (const resource of requestedResources) {
@@ -28335,7 +28428,9 @@ function wireOpenKeyAuthorize(openkey, opts) {
       host: input.host,
       // Forward the presentation envelope verbatim — the OpenKey SDK
       // validates and size-bounds it before use.
-      presentation: input.presentation
+      presentation: input.presentation,
+      // Sent only when true, so a request without it keeps its prior shape.
+      ...input.expiryChangeable === true ? { expiryChangeable: true } : {}
     }, opts);
     if (result.protocolVersion !== 1) {
       throw new Error(