Specify format: 'date-time' for date properties

README.md

@@ -3,7 +3,7 @@
 # Decentralized Web Node (DWN) SDK
 
 Code Coverage
-![Statements](https://img.shields.io/badge/statements-93.99%25-brightgreen.svg?style=flat) ![Branches](https://img.shields.io/badge/branches-93.5%25-brightgreen.svg?style=flat) ![Functions](https://img.shields.io/badge/functions-91.72%25-brightgreen.svg?style=flat) ![Lines](https://img.shields.io/badge/lines-93.99%25-brightgreen.svg?style=flat)
+![Statements](https://img.shields.io/badge/statements-93.99%25-brightgreen.svg?style=flat) ![Branches](https://img.shields.io/badge/branches-93.51%25-brightgreen.svg?style=flat) ![Functions](https://img.shields.io/badge/functions-91.72%25-brightgreen.svg?style=flat) ![Lines](https://img.shields.io/badge/lines-93.99%25-brightgreen.svg?style=flat)
 
 ## Introduction
 

json-schemas/definitions.json

@@ -14,6 +14,10 @@
     "did": {
       "type": "string",
       "pattern": "^did:([a-z0-9]+):((?:(?:[a-zA-Z0-9._-]|(?:%[0-9a-fA-F]{2}))*:)*((?:[a-zA-Z0-9._-]|(?:%[0-9a-fA-F]{2}))+))((;[a-zA-Z0-9_.:%-]+=[a-zA-Z0-9_.:%-]*)*)(\/[^#?]*)?([?][^#]*)?(#.*)?$"
+    },
+    "date-time": {
+      "type": "string",
+      "pattern": "^[0-9]{4}-[0-1]\\d-[0-3]\\dT([0-2]\\d:[0-5]\\d:[0-5]\\d|23:59:60)\\.[0-9]{6}Z$"
     }
   }
-}
+}

json-schemas/hooks/hooks-write.json

@@ -35,7 +35,7 @@
           "type": "string"
         },
         "dateCreated": {
-          "type": "string"
+          "$ref": "https://identity.foundation/dwn/json-schemas/defs.json#/definitions/date-time"
         },
         "schema": {
           "type": "string"

json-schemas/records/records-query.json

@@ -34,7 +34,7 @@
           "type": "string"
         },
         "dateCreated": {
-          "type": "string"
+          "$ref": "https://identity.foundation/dwn/json-schemas/defs.json#/definitions/date-time"
         },
         "filter": {
           "type": "object",
@@ -71,10 +71,10 @@
               "additionalProperties": false,
               "properties": {
                 "from": {
-                  "type": "string"
+                  "$ref": "https://identity.foundation/dwn/json-schemas/defs.json#/definitions/date-time"
                 },
                 "to": {
-                  "type": "string"
+                  "$ref": "https://identity.foundation/dwn/json-schemas/defs.json#/definitions/date-time"
                 }
               }
             }

json-schemas/records/records-write.json

@@ -121,16 +121,16 @@
           "type": "number"
         },
         "dateCreated": {
-          "type": "string"
+          "$ref": "https://identity.foundation/dwn/json-schemas/defs.json#/definitions/date-time"
         },
         "dateModified": {
-          "type": "string"
+          "$ref": "https://identity.foundation/dwn/json-schemas/defs.json#/definitions/date-time"
         },
         "published": {
           "type": "boolean"
         },
         "datePublished": {
-          "type": "string"
+          "$ref": "https://identity.foundation/dwn/json-schemas/defs.json#/definitions/date-time"
         },
         "dataFormat": {
           "type": "string"

tests/interfaces/records/handlers/records-query.spec.ts

@@ -20,16 +20,20 @@ import { Message } from '../../../../src/core/message.js';
 import { MessageStoreLevel } from '../../../../src/store/message-store-level.js';
 import { RecordsQueryHandler } from '../../../../src/interfaces/records/handlers/records-query.js';
 import { StorageController } from '../../../../src/store/storage-controller.js';
-import { Temporal } from '@js-temporal/polyfill';
 import { TestDataGenerator } from '../../../utils/test-data-generator.js';
 import { TestStubGenerator } from '../../../utils/test-stub-generator.js';
+import { toTemporalInstant } from '@js-temporal/polyfill';
 
 import { constructRecordsWriteIndexes } from '../../../../src/interfaces/records/handlers/records-write.js';
 import { DataStream, DidResolver, Dwn, HdKey, KeyDerivationScheme, Records } from '../../../../src/index.js';
 import { DateSort, RecordsQuery } from '../../../../src/interfaces/records/messages/records-query.js';
 
 chai.use(chaiAsPromised);
 
+function createDateString(d: Date): string {
+  return toTemporalInstant.call(d).toString({ smallestUnit: 'microseconds' });
+}
+
 describe('RecordsQueryHandler.handle()', () => {
   describe('functional tests', () => {
     let didResolver: DidResolver;
@@ -184,11 +188,12 @@ describe('RecordsQueryHandler.handle()', () => {
       expect(reply3.entries?.length).to.equal(0);
     });
 
+
     it('should be able to range query by `dateCreated`', async () => {
       // scenario: 3 records authored by alice, created on first of 2021, 2022, and 2023 respectively, only the first 2 records share the same schema
-      const firstDayOf2021 = Temporal.PlainDateTime.from({ year: 2021, month: 1, day: 1 }).toString({ smallestUnit: 'microseconds' });
-      const firstDayOf2022 = Temporal.PlainDateTime.from({ year: 2022, month: 1, day: 1 }).toString({ smallestUnit: 'microseconds' });
-      const firstDayOf2023 = Temporal.PlainDateTime.from({ year: 2023, month: 1, day: 1 }).toString({ smallestUnit: 'microseconds' });
+      const firstDayOf2021 = createDateString(new Date(2021, 1, 1));
+      const firstDayOf2022 = createDateString(new Date(2022, 1, 1));
+      const firstDayOf2023 = createDateString(new Date(2023, 1, 1));
       const alice = await DidKeyResolver.generate();
       const write1 = await TestDataGenerator.generateRecordsWrite({ requester: alice, dateCreated: firstDayOf2021, dateModified: firstDayOf2021 });
       const write2 = await TestDataGenerator.generateRecordsWrite({ requester: alice, dateCreated: firstDayOf2022, dateModified: firstDayOf2022 });
@@ -203,7 +208,7 @@ describe('RecordsQueryHandler.handle()', () => {
       expect(writeReply3.status.code).to.equal(202);
 
       // testing `from` range
-      const lastDayOf2021 = Temporal.PlainDateTime.from({ year: 2021, month: 12, day: 31 }).toString({ smallestUnit: 'microseconds' });
+      const lastDayOf2021 = createDateString(new Date(2021, 12, 31));
       const recordsQuery1 = await TestDataGenerator.generateRecordsQuery({
         requester : alice,
         filter    : { dateCreated: { from: lastDayOf2021 } },
@@ -215,7 +220,7 @@ describe('RecordsQueryHandler.handle()', () => {
       expect(reply1.entries![1].encodedData).to.equal(Encoder.bytesToBase64Url(write3.dataBytes!));
 
       // testing `to` range
-      const lastDayOf2022 = Temporal.PlainDateTime.from({ year: 2022, month: 12, day: 31 }).toString({ smallestUnit: 'microseconds' });
+      const lastDayOf2022 = createDateString(new Date(2022, 12, 31));
       const recordsQuery2 = await TestDataGenerator.generateRecordsQuery({
         requester : alice,
         filter    : { dateCreated: { to: lastDayOf2022 } },
@@ -227,7 +232,7 @@ describe('RecordsQueryHandler.handle()', () => {
       expect(reply2.entries![1].encodedData).to.equal(Encoder.bytesToBase64Url(write2.dataBytes!));
 
       // testing `from` and `to` range
-      const lastDayOf2023 = Temporal.PlainDateTime.from({ year: 2023, month: 12, day: 31 }).toString({ smallestUnit: 'microseconds' });
+      const lastDayOf2023 = createDateString(new Date(2023, 12, 31));
       const recordsQuery3 = await TestDataGenerator.generateRecordsQuery({
         requester : alice,
         filter    : { dateCreated: { from: lastDayOf2022, to: lastDayOf2023 } },
@@ -250,9 +255,9 @@ describe('RecordsQueryHandler.handle()', () => {
 
     it('should be able use range and exact match queries at the same time', async () => {
       // scenario: 3 records authored by alice, created on first of 2021, 2022, and 2023 respectively, only the first 2 records share the same schema
-      const firstDayOf2021 = Temporal.PlainDateTime.from({ year: 2021, month: 1, day: 1 }).toString({ smallestUnit: 'microseconds' });
-      const firstDayOf2022 = Temporal.PlainDateTime.from({ year: 2022, month: 1, day: 1 }).toString({ smallestUnit: 'microseconds' });
-      const firstDayOf2023 = Temporal.PlainDateTime.from({ year: 2023, month: 1, day: 1 }).toString({ smallestUnit: 'microseconds' });
+      const firstDayOf2021 = createDateString(new Date(2021, 1, 1));
+      const firstDayOf2022 = createDateString(new Date(2022, 1, 1));
+      const firstDayOf2023 = createDateString(new Date(2023, 1, 1));
       const alice = await DidKeyResolver.generate();
       const schema = '2021And2022Schema';
       const write1 = await TestDataGenerator.generateRecordsWrite({
@@ -274,8 +279,8 @@ describe('RecordsQueryHandler.handle()', () => {
       expect(writeReply3.status.code).to.equal(202);
 
       // testing range criterion with another exact match
-      const lastDayOf2021 = Temporal.PlainDateTime.from({ year: 2021, month: 12, day: 31 }).toString({ smallestUnit: 'microseconds' });
-      const lastDayOf2023 = Temporal.PlainDateTime.from({ year: 2023, month: 12, day: 31 }).toString({ smallestUnit: 'microseconds' });
+      const lastDayOf2021 = createDateString(new Date(2021, 12, 31));
+      const lastDayOf2023 = createDateString(new Date(2023, 12, 31));
       const recordsQuery5 = await TestDataGenerator.generateRecordsQuery({
         requester : alice,
         filter    : {

tests/interfaces/records/handlers/records-write.spec.ts

@@ -426,7 +426,7 @@ describe('RecordsWriteHandler.handle()', () => {
 
       it('should return 400 if `dateCreated` and `dateModified` are not the same in an initial write', async () => {
         const { requester, message, dataStream } = await TestDataGenerator.generateRecordsWrite({
-          dateCreated  : '2023-01-10T10:20:30.405060',
+          dateCreated  : '2023-01-10T10:20:30.405060Z',
           dateModified : getCurrentTimeInHighPrecision() // this always generate a different timestamp
         });
         const tenant = requester.did;

tests/interfaces/records/messages/records-write.spec.ts

@@ -24,7 +24,7 @@ describe('RecordsWrite', () => {
         recipient                   : alice.did,
         data                        : TestDataGenerator.randomBytes(10),
         dataFormat                  : 'application/json',
-        dateCreated                 : '2022-10-14T10:20:30.405060',
+        dateCreated                 : '2022-10-14T10:20:30.405060Z',
         recordId                    : await TestDataGenerator.randomCborSha256Cid(),
         authorizationSignatureInput : Jws.createSignatureInput(alice)
       };

tests/validation/json-schemas/protocols/protocols-configure.spec.ts

@@ -25,7 +25,7 @@ describe('ProtocolsConfigure schema definition', () => {
       descriptor: {
         interface   : 'Protocols',
         method      : 'Configure',
-        dateCreated : '123',
+        dateCreated : '2022-10-14T10:20:30.405060Z',
         protocol    : 'anyProtocolUri',
         definition  : protocolDefinition
       },

tests/validation/json-schemas/records/records-query.spec.ts

@@ -7,7 +7,7 @@ describe('RecordsQuery schema validation', () => {
       descriptor: {
         interface   : 'Records',
         method      : 'Query',
-        dateCreated : '123',
+        dateCreated : '2022-10-14T10:20:30.405060Z',
         filter      : { schema: 'anySchema' }
       },
       authorization: {
@@ -26,7 +26,7 @@ describe('RecordsQuery schema validation', () => {
       descriptor: {
         interface   : 'Records',
         method      : 'Query',
-        dateCreated : '123',
+        dateCreated : '2022-10-14T10:20:30.405060Z',
         filter      : { schema: 'anySchema' }
       }
     };
@@ -41,7 +41,7 @@ describe('RecordsQuery schema validation', () => {
       descriptor: {
         interface   : 'Records',
         method      : 'Query',
-        dateCreated : '123',
+        dateCreated : '2022-10-14T10:20:30.405060Z',
         filter      : { schema: 'anySchema' }
       },
       authorization: {
@@ -64,7 +64,7 @@ describe('RecordsQuery schema validation', () => {
       descriptor: {
         interface       : 'Records',
         method          : 'Query',
-        dateCreated     : '123',
+        dateCreated     : '2022-10-14T10:20:30.405060Z',
         filter          : { schema: 'anySchema' },
         unknownProperty : 'unknownProperty' // unknown property
       },
@@ -90,7 +90,7 @@ describe('RecordsQuery schema validation', () => {
         descriptor: {
           interface   : 'Records',
           method      : 'Query',
-          dateCreated : '123',
+          dateCreated : '2022-10-14T10:20:30.405060Z',
           filter      : { schema: 'anySchema' },
           dateSort    : dateSortValue
         },
@@ -111,7 +111,7 @@ describe('RecordsQuery schema validation', () => {
       descriptor: {
         interface   : 'Records',
         method      : 'Query',
-        dateCreated : '123',
+        dateCreated : '2022-10-14T10:20:30.405060Z',
         filter      : { schema: 'anySchema' },
         dateSort    : 'unacceptable', // bad value
       },
@@ -135,7 +135,7 @@ describe('RecordsQuery schema validation', () => {
         descriptor: {
           interface   : 'Records',
           method      : 'Query',
-          dateCreated : '123',
+          dateCreated : '2022-10-14T10:20:30.405060Z',
           filter      : { }
         },
         authorization: {
@@ -157,7 +157,7 @@ describe('RecordsQuery schema validation', () => {
         descriptor: {
           interface   : 'Records',
           method      : 'Query',
-          dateCreated : '123',
+          dateCreated : '2022-10-14T10:20:30.405060Z',
           filter      : { dateCreated: { } } // empty `dateCreated` criteria
         },
         authorization: {
@@ -179,7 +179,7 @@ describe('RecordsQuery schema validation', () => {
         descriptor: {
           interface   : 'Records',
           method      : 'Query',
-          dateCreated : '123',
+          dateCreated : '2022-10-14T10:20:30.405060Z',
           filter      : { dateCreated: { unexpectedProperty: 'anyValue' } } // unexpected property in `dateCreated` criteria
         },
         authorization: {