Add now option to delegate().

Author: dlongley

CHANGELOG.md

@@ -1,5 +1,10 @@
 # @digitalbazaar/ezcap Changelog
 
+## 4.2.0 - 2025-mm-dd
+
+### Added
+- Allow `now` to be passed to `delegate()` to make testing easier.
+
 ## 4.1.0 - 2024-01-01
 
 ### Changed

lib/ZcapClient.js

@@ -1,5 +1,5 @@
 /*!
- * Copyright (c) 2021-2023 Digital Bazaar, Inc. All rights reserved.
+ * Copyright (c) 2021-2025 Digital Bazaar, Inc. All rights reserved.
  */
 import {
   CapabilityDelegation,
@@ -132,13 +132,15 @@ export class ZcapClient {
    * @param {string|Array} [options.allowedActions] - Optional list of allowed
    *   actions or string specifying allowed delegated action. Default: [] -
    *   delegate all actions.
+   * @param {number} [options.now] - Optional timestamp for the current time;
+   *   useful for testing.
    *
    * @returns {Promise<object>} - A promise that resolves to a delegated
    *   capability.
    */
   async delegate({
     capability, controller, invocationTarget, expires,
-    allowedActions
+    allowedActions, now = Date.now()
   } = {}) {
     if(!(typeof controller === 'string' && controller.includes(':'))) {
       throw new Error(
@@ -161,7 +163,7 @@ export class ZcapClient {
 
     if(expires === undefined) {
       // default expiration is 5 minutes in the future
-      expires = new Date(Date.now() + 5 * 60 * 1000);
+      expires = new Date(now + 5 * 60 * 1000);
     } else if(expires instanceof Date || typeof expires === 'string') {
       // ensure expires is a valid date
       const time = Date.parse(expires);
@@ -242,7 +244,7 @@ export class ZcapClient {
 
     // ensure delegation date will not be at least after parent delegation date
     const [parentProof] = _getDelegationProofs({capability});
-    let date = new Date();
+    let date = new Date(now);
     if(parentProof) {
       const parentDelegationDate = new Date(parentProof.created);
       if(date < parentDelegationDate) {