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

package/dist/{TinyCloudNode-BjJJIifr.d.ts → TinyCloudNode-BlNcvo1c.d.ts}

@@ -81,6 +81,12 @@ interface OpenKeyAuthorizeTinyCloud {
          * validates and size-bounds it before use.
          */
         presentation?: CapabilityPresentationEnvelopeV1;
+        /**
+         * Ask OpenKey to let the user change the session expiry in the approval.
+         * Sent only when true. `@openkey/sdk` >= 0.13.0 (beta: 0.13.0-beta.0)
+         * forwards it; 0.12.x ignores it.
+         */
+        expiryChangeable?: boolean;
     }, opts?: {
         mode?: "iframe" | "popup" | "redirect";
     }): Promise<{
@@ -114,6 +120,12 @@ interface OpenKeyBridgeInput {
      * manifest. Display-only.
      */
     presentation?: CapabilityPresentationEnvelopeV1;
+    /**
+     * Ask OpenKey to let the user change the session expiry. Forwarded only
+     * when true. The SDK accepts a changed expiry only for a request that
+     * carried this flag, and then uses the SIGNED expiry.
+     */
+    expiryChangeable?: boolean;
 }
 type NodeUserAuthorizationAuthorizeFn = (input: OpenKeyBridgeInput) => Promise<{
     protocolVersion: 1;
@@ -160,7 +172,14 @@ interface PreparedOpenKeyAuthorization {
     readonly chainId: number;
     readonly generation: number;
     readonly createdAt: number;
+    /** The app-level maximum for a changed signed expiry, if one was given. In memory only; never sent or persisted. */
+    readonly maxExpiresAt?: OpenKeyMaxExpiresAt;
 }
+/**
+ * A latest acceptable signed expiry: epoch MILLISECONDS, a `Date`, or a function returning either. A function is read
+ * when the OpenKey result arrives, not when the request is prepared.
+ */
+type OpenKeyMaxExpiresAt = number | Date | (() => number | Date);
 type OpenKeyAuthorizationResultV1 = Awaited<ReturnType<NodeUserAuthorizationAuthorizeFn>>;
 type PreparedOpenKeySession = {
     siwe: string;
@@ -636,6 +655,13 @@ declare class NodeUserAuthorization implements IUserAuthorization {
     private guardSpaceCreation;
     private recordActivationSkippedSpaces;
     createBootstrapSession(options: CreateBootstrapSessionOptions): Promise<TinyCloudSession>;
+    /**
+     * 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.
+     */
+    private sessionExpiryFrom;
     private persistedData;
     /**
      * Sign in and create a new session.
@@ -747,6 +773,21 @@ declare class NodeUserAuthorization implements IUserAuthorization {
         openkeyKeyId?: string;
         /** Caller-supplied display reason, not signed authority. */
         reason?: string;
+        /**
+         * Let the user change the session expiry in the OpenKey approval. Sent
+         * to OpenKey as `expiryChangeable: true` (`@openkey/sdk` >= 0.13.0
+         * (beta: 0.13.0-beta.0) forwards it; 0.12.x ignores it). The SIGNED
+         * expiry is then the session's expiry.
+         */
+        expiryChangeable?: boolean;
+        /**
+         * The latest signed expiry the caller will accept, used only with `expiryChangeable`: a signed expiry beyond it
+         * is refused before any session is built, stored or activated. Epoch MILLISECONDS or a `Date`; a function is
+         * called when the result arrives (so a slow approval does not count against it) and returns either. It is not
+         * sent to OpenKey and not persisted. It limits a CHANGED expiry only: an expiry equal to the one this SDK
+         * requested is accepted, so keep the configured session lifetime within the maximum.
+         */
+        maxExpiresAt?: OpenKeyMaxExpiresAt;
         /**
          * Supply another candidate without regenerating the SIWE or session key.
          * Called only after transport or pre-commit verification rejects a result.
@@ -803,8 +844,18 @@ declare class NodeUserAuthorization implements IUserAuthorization {
      *    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).
      */
-    signInWithOpenKeyResult(result: OpenKeyAuthorizationResultV1, prepared: PreparedOpenKeySession, keyId: string, jwk: Record<string, unknown>): Promise<ClientSession>;
+    signInWithOpenKeyResult(result: OpenKeyAuthorizationResultV1, prepared: PreparedOpenKeySession, keyId: string, jwk: Record<string, unknown>, options?: {
+        expiryChangeable?: boolean;
+        maxExpiresAt?: OpenKeyMaxExpiresAt;
+    }): Promise<ClientSession>;
     /** Validate a candidate without activating a network session, so paste retries reuse one preparation. */
     private verifyOpenKeyResult;
     /**
@@ -1686,7 +1737,7 @@ declare class TinyCloudNode {
      */
     signInWithOpenKey(authorizeFn: Parameters<NodeUserAuthorization["signInWithOpenKey"]>[0], options?: Parameters<NodeUserAuthorization["signInWithOpenKey"]>[1]): Promise<void>;
     /** Prepare the OpenKey request before the approval click. */
-    prepareOpenKeySignIn(): Promise<PreparedOpenKeyAuthorization>;
+    prepareOpenKeySignIn(options?: Parameters<NodeUserAuthorization["prepareOpenKeySignIn"]>[0]): Promise<PreparedOpenKeyAuthorization>;
     /** Start OpenKey authorization synchronously, then complete normal session setup. */
     signInWithPreparedOpenKey(pending: PreparedOpenKeyAuthorization, authorizeFn: Parameters<NodeUserAuthorization["signInWithOpenKey"]>[0]): Promise<void>;
     private signInWith;
@@ -2095,6 +2146,19 @@ declare class TinyCloudNode {
      * @internal
      */
     private getSessionExpiry;
+    /**
+     * 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
+     */
+    private getSignedSessionExpiry;
     /**
      * Wrapper for the WASM createDelegation function.
      *

package/dist/{TinyCloudNode-BhWBbCay.d.cts → TinyCloudNode-CnVaWnAX.d.cts}

@@ -81,6 +81,12 @@ interface OpenKeyAuthorizeTinyCloud {
          * validates and size-bounds it before use.
          */
         presentation?: CapabilityPresentationEnvelopeV1;
+        /**
+         * Ask OpenKey to let the user change the session expiry in the approval.
+         * Sent only when true. `@openkey/sdk` >= 0.13.0 (beta: 0.13.0-beta.0)
+         * forwards it; 0.12.x ignores it.
+         */
+        expiryChangeable?: boolean;
     }, opts?: {
         mode?: "iframe" | "popup" | "redirect";
     }): Promise<{
@@ -114,6 +120,12 @@ interface OpenKeyBridgeInput {
      * manifest. Display-only.
      */
     presentation?: CapabilityPresentationEnvelopeV1;
+    /**
+     * Ask OpenKey to let the user change the session expiry. Forwarded only
+     * when true. The SDK accepts a changed expiry only for a request that
+     * carried this flag, and then uses the SIGNED expiry.
+     */
+    expiryChangeable?: boolean;
 }
 type NodeUserAuthorizationAuthorizeFn = (input: OpenKeyBridgeInput) => Promise<{
     protocolVersion: 1;
@@ -160,7 +172,14 @@ interface PreparedOpenKeyAuthorization {
     readonly chainId: number;
     readonly generation: number;
     readonly createdAt: number;
+    /** The app-level maximum for a changed signed expiry, if one was given. In memory only; never sent or persisted. */
+    readonly maxExpiresAt?: OpenKeyMaxExpiresAt;
 }
+/**
+ * A latest acceptable signed expiry: epoch MILLISECONDS, a `Date`, or a function returning either. A function is read
+ * when the OpenKey result arrives, not when the request is prepared.
+ */
+type OpenKeyMaxExpiresAt = number | Date | (() => number | Date);
 type OpenKeyAuthorizationResultV1 = Awaited<ReturnType<NodeUserAuthorizationAuthorizeFn>>;
 type PreparedOpenKeySession = {
     siwe: string;
@@ -636,6 +655,13 @@ declare class NodeUserAuthorization implements IUserAuthorization {
     private guardSpaceCreation;
     private recordActivationSkippedSpaces;
     createBootstrapSession(options: CreateBootstrapSessionOptions): Promise<TinyCloudSession>;
+    /**
+     * 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.
+     */
+    private sessionExpiryFrom;
     private persistedData;
     /**
      * Sign in and create a new session.
@@ -747,6 +773,21 @@ declare class NodeUserAuthorization implements IUserAuthorization {
         openkeyKeyId?: string;
         /** Caller-supplied display reason, not signed authority. */
         reason?: string;
+        /**
+         * Let the user change the session expiry in the OpenKey approval. Sent
+         * to OpenKey as `expiryChangeable: true` (`@openkey/sdk` >= 0.13.0
+         * (beta: 0.13.0-beta.0) forwards it; 0.12.x ignores it). The SIGNED
+         * expiry is then the session's expiry.
+         */
+        expiryChangeable?: boolean;
+        /**
+         * The latest signed expiry the caller will accept, used only with `expiryChangeable`: a signed expiry beyond it
+         * is refused before any session is built, stored or activated. Epoch MILLISECONDS or a `Date`; a function is
+         * called when the result arrives (so a slow approval does not count against it) and returns either. It is not
+         * sent to OpenKey and not persisted. It limits a CHANGED expiry only: an expiry equal to the one this SDK
+         * requested is accepted, so keep the configured session lifetime within the maximum.
+         */
+        maxExpiresAt?: OpenKeyMaxExpiresAt;
         /**
          * Supply another candidate without regenerating the SIWE or session key.
          * Called only after transport or pre-commit verification rejects a result.
@@ -803,8 +844,18 @@ declare class NodeUserAuthorization implements IUserAuthorization {
      *    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).
      */
-    signInWithOpenKeyResult(result: OpenKeyAuthorizationResultV1, prepared: PreparedOpenKeySession, keyId: string, jwk: Record<string, unknown>): Promise<ClientSession>;
+    signInWithOpenKeyResult(result: OpenKeyAuthorizationResultV1, prepared: PreparedOpenKeySession, keyId: string, jwk: Record<string, unknown>, options?: {
+        expiryChangeable?: boolean;
+        maxExpiresAt?: OpenKeyMaxExpiresAt;
+    }): Promise<ClientSession>;
     /** Validate a candidate without activating a network session, so paste retries reuse one preparation. */
     private verifyOpenKeyResult;
     /**
@@ -1686,7 +1737,7 @@ declare class TinyCloudNode {
      */
     signInWithOpenKey(authorizeFn: Parameters<NodeUserAuthorization["signInWithOpenKey"]>[0], options?: Parameters<NodeUserAuthorization["signInWithOpenKey"]>[1]): Promise<void>;
     /** Prepare the OpenKey request before the approval click. */
-    prepareOpenKeySignIn(): Promise<PreparedOpenKeyAuthorization>;
+    prepareOpenKeySignIn(options?: Parameters<NodeUserAuthorization["prepareOpenKeySignIn"]>[0]): Promise<PreparedOpenKeyAuthorization>;
     /** Start OpenKey authorization synchronously, then complete normal session setup. */
     signInWithPreparedOpenKey(pending: PreparedOpenKeyAuthorization, authorizeFn: Parameters<NodeUserAuthorization["signInWithOpenKey"]>[0]): Promise<void>;
     private signInWith;
@@ -2095,6 +2146,19 @@ declare class TinyCloudNode {
      * @internal
      */
     private getSessionExpiry;
+    /**
+     * 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
+     */
+    private getSignedSessionExpiry;
     /**
      * Wrapper for the WASM createDelegation function.
      *

package/dist/{authority-WCJA3phs.d.cts → authority-B2SLx27M.d.cts}

@@ -1,7 +1,7 @@
 import { ReplicationOptions, PermissionEntry, TinyCloudSession, KVReplicaStorage, ServiceContext, IWasmBindings, WasmRecapEntry } from '@tinycloud/sdk-core';
 import { ReplicaConsentAnchor, AuthorityRefusal, ReplicationAuthority } from '@tinycloud/sdk-services';
 import { ReplicaLocalEraseOutcome, ReplicaPurgeLocalCopyResult, ReplicaPurgeTrigger, ReplicaPurgeFailedEvent, ReplicaSessionStamp, ReplicaDenyInput } from '@tinycloud/sdk-services/kv/replication';
-import { T as TinyCloudNode } from './TinyCloudNode-BhWBbCay.cjs';
+import { T as TinyCloudNode } from './TinyCloudNode-CnVaWnAX.cjs';
 
 /** Constructor-time validation; the space-dependent secrets check runs at sign-in and open. */
 declare function assertValidReplicationConfig(replication: (ReplicationOptions & {

package/dist/{authority-BzqKNzOr.d.ts → authority-DHIk5QvV.d.ts}

@@ -1,7 +1,7 @@
 import { ReplicationOptions, PermissionEntry, TinyCloudSession, KVReplicaStorage, ServiceContext, IWasmBindings, WasmRecapEntry } from '@tinycloud/sdk-core';
 import { ReplicaConsentAnchor, AuthorityRefusal, ReplicationAuthority } from '@tinycloud/sdk-services';
 import { ReplicaLocalEraseOutcome, ReplicaPurgeLocalCopyResult, ReplicaPurgeTrigger, ReplicaPurgeFailedEvent, ReplicaSessionStamp, ReplicaDenyInput } from '@tinycloud/sdk-services/kv/replication';
-import { T as TinyCloudNode } from './TinyCloudNode-BjJJIifr.js';
+import { T as TinyCloudNode } from './TinyCloudNode-BlNcvo1c.js';
 
 /** Constructor-time validation; the space-dependent secrets check runs at sign-in and open. */
 declare function assertValidReplicationConfig(replication: (ReplicationOptions & {

package/dist/core.cjs

@@ -454,6 +454,16 @@ var import_sdk_core4 = require("@tinycloud/sdk-core");
 var defaultSignStrategy = { type: "auto-sign" };
 
 // 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]}`;
@@ -1427,7 +1437,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) {
@@ -1482,6 +1492,17 @@ var NodeUserAuthorization = class {
       signature
     };
   }
+  /**
+   * 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,
@@ -1537,7 +1558,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 } : {},
@@ -1683,7 +1704,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 } : {},
@@ -1746,10 +1767,8 @@ var NodeUserAuthorization = class {
       siwe: prepared.siwe,
       signature
     };
-    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);
@@ -1808,6 +1827,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) {
@@ -1828,7 +1848,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,
@@ -1838,7 +1860,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. */
@@ -1856,7 +1881,11 @@ var NodeUserAuthorization = class {
     for (let attempt = 0; ; ) {
       try {
         result ?? (result = await authorization);
-        signed = await this.verifyOpenKeyResult(result, prepared);
+        signed = await this.verifyOpenKeyResult(result, prepared, {
+          // Relax only for a request that actually carried the opt-in.
+          allowExpirationChange: originalRequest.expiryChangeable === true,
+          maxExpiresAt: pending.maxExpiresAt
+        });
         signature = result.signature;
         break;
       } catch (error) {
@@ -1948,13 +1977,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.
-   */
-  async signInWithOpenKeyResult(result, prepared, keyId, jwk) {
-    const signed = await this.verifyOpenKeyResult(result, prepared);
+   *
+   * `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, options) {
+    const signed = await this.verifyOpenKeyResult(result, prepared, {
+      allowExpirationChange: options?.expiryChangeable === true,
+      maxExpiresAt: options?.maxExpiresAt
+    });
     return this.signInWithPreparedSession(signed, 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}`);
     }
@@ -1997,16 +2036,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;
@@ -2287,7 +2349,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(
@@ -4882,14 +4946,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) {
@@ -7473,7 +7537,7 @@ var _TinyCloudNode = class _TinyCloudNode {
         path: "",
         // Root access
         actions: [...ROOT_DELEGATION_ACTIONS],
-        expiry: this.getSessionExpiry(),
+        expiry: this.getSignedSessionExpiry(),
         isRevoked: false,
         allowSubDelegation: true
       };
@@ -7486,7 +7550,7 @@ var _TinyCloudNode = class _TinyCloudNode {
             spaceId,
             path: "",
             actions: [...ROOT_DELEGATION_ACTIONS],
-            expiry: this.getSessionExpiry(),
+            expiry: this.getSignedSessionExpiry(),
             isRevoked: false,
             allowSubDelegation: true
           });
@@ -7578,7 +7642,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);
@@ -7625,6 +7689,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 signed;
+    try {
+      signed = extractSiweExpiration(siwe);
+    } catch {
+      return this.getSessionExpiry();
+    }
+    return signed ?? this.getSessionExpiry();
+  }
   /**
    * Wrapper for the WASM createDelegation function.
    *
@@ -7654,6 +7741,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_core11.assertExpiryWithinTechnicalLimit)(params.expirationSecs * 1e3, "ucan");
     const result = this.wasmBindings.createDelegation(
       wasmSession,
       params.delegateDID,
@@ -7686,9 +7774,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_core11.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_core11.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");
@@ -7789,6 +7878,7 @@ var _TinyCloudNode = class _TinyCloudNode {
    * not sent.
    */
   async authorizeShareDeliveryV3(input) {
+    (0, import_sdk_core11.assertExpiryWithinTechnicalLimit)(new Date(input.expiresAt), "siwe");
     const envelopeRef = await (0, import_sdk_core11.shortDeliveryLinkBodyCid)(input.shareUrl, input.trustedOrigins);
     const session = this.currentTinyCloudSession();
     const serviceSession = this._serviceContext?.session;
@@ -7841,6 +7931,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     };
   }
   async createRootDelegationForSharing(params, assertActive) {
+    (0, import_sdk_core11.assertExpiryWithinTechnicalLimit)(params.requestedExpiry, "siwe");
     try {
       return (await this.createOwnerDelegation({
         delegateDid: params.shareKeyDID,
@@ -8537,6 +8628,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     if (sessionExpiry !== void 0 && sessionExpiry < expiresAt) {
       expiresAt = sessionExpiry;
     }
+    (0, import_sdk_core11.assertExpiryWithinTechnicalLimit)(expiresAt, "siwe");
     const delegations = [];
     let rawEntriesAttached = false;
     for (const [spaceId, entries] of bySpace) {
@@ -10009,6 +10101,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_core11.assertExpiryWithinTechnicalLimit)(expirationTime, "siwe");
     const prepared = this.wasmBindings.prepareSession({
       abilities,
       address: this.wasmBindings.ensureEip55(session.address),
@@ -10163,6 +10256,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     const { abilities, rawAbilities } = this.buildActivationAbilities(delegation);
     const now = /* @__PURE__ */ new Date();
     const expirationTime = delegation.expiry;
+    (0, import_sdk_core11.assertExpiryWithinTechnicalLimit)(expirationTime, "siwe");
     const prepared = this.wasmBindings.prepareSession({
       abilities,
       address: this.wasmBindings.ensureEip55(mySession.address),
@@ -10282,6 +10376,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_core11.assertExpiryWithinTechnicalLimit)(actualExpiry, "siwe");
     const abilities = {};
     const rawAbilities = {};
     for (const resource of requestedResources) {