Specify format: 'date-time' for date properties

build/compile-validators.js

@@ -60,6 +60,7 @@ const schemas = {
 };
 
 const ajv = new Ajv({ code: { source: true, esm: true } });
+ajv.addFormat('date-time', /^\d\d\d\d-[0-1]\d-[0-3]\dt(?:[0-2]\d:[0-5]\d:[0-5]\d|23:59:60)(?:\.\d+)?(?:z|[+-]\d\d(?::?\d\d)?)$/i);
 
 for (const schemaName in schemas) {
   ajv.addSchema(schemas[schemaName], schemaName);

json-schemas/hooks/hooks-write.json

@@ -35,7 +35,8 @@
           "type": "string"
         },
         "dateCreated": {
-          "type": "string"
+          "type": "string",
+          "format": "date-time"
         },
         "schema": {
           "type": "string"

json-schemas/records/records-query.json

@@ -34,7 +34,8 @@
           "type": "string"
         },
         "dateCreated": {
-          "type": "string"
+          "type": "string",
+          "format": "date-time"
         },
         "filter": {
           "type": "object",
@@ -71,10 +72,12 @@
               "additionalProperties": false,
               "properties": {
                 "from": {
-                  "type": "string"
+                  "type": "string",
+                  "format": "date-time"
                 },
                 "to": {
-                  "type": "string"
+                  "type": "string",
+                  "format": "date-time"
                 }
               }
             }

json-schemas/records/records-write.json

@@ -121,16 +121,19 @@
           "type": "number"
         },
         "dateCreated": {
-          "type": "string"
+          "type": "string",
+          "format": "date-time"
         },
         "dateModified": {
-          "type": "string"
+          "type": "string",
+          "format": "date-time"
         },
         "published": {
           "type": "boolean"
         },
         "datePublished": {
-          "type": "string"
+          "type": "string",
+          "format": "date-time"
         },
         "dataFormat": {
           "type": "string"

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

@@ -20,14 +20,21 @@ 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';
 
+declare global {
+  interface Date {
+    toTemporalInstant: typeof toTemporalInstant;
+  }
+}
+Date.prototype.toTemporalInstant = toTemporalInstant;
+
 chai.use(chaiAsPromised);
 
 describe('RecordsQueryHandler.handle()', () => {
@@ -184,11 +191,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 = new Date(2021, 1, 1).toTemporalInstant().toString({ smallestUnit: 'microseconds' });
+      const firstDayOf2022 = new Date(2022, 1, 1).toTemporalInstant().toString({ smallestUnit: 'microseconds' });
+      const firstDayOf2023 = new Date(2023, 1, 1).toTemporalInstant().toString({ smallestUnit: 'microseconds' });
       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 +211,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 = new Date(2021, 12, 31).toTemporalInstant().toString({ smallestUnit: 'microseconds' });
       const recordsQuery1 = await TestDataGenerator.generateRecordsQuery({
         requester : alice,
         filter    : { dateCreated: { from: lastDayOf2021 } },
@@ -215,7 +223,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 = new Date(2022, 12, 31).toTemporalInstant().toString({ smallestUnit: 'microseconds' });
       const recordsQuery2 = await TestDataGenerator.generateRecordsQuery({
         requester : alice,
         filter    : { dateCreated: { to: lastDayOf2022 } },
@@ -227,7 +235,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 = new Date(2023, 12, 31).toTemporalInstant().toString({ smallestUnit: 'microseconds' });
       const recordsQuery3 = await TestDataGenerator.generateRecordsQuery({
         requester : alice,
         filter    : { dateCreated: { from: lastDayOf2022, to: lastDayOf2023 } },
@@ -250,9 +258,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 = new Date(2021, 1, 1).toTemporalInstant().toString({ smallestUnit: 'microseconds' });
+      const firstDayOf2022 = new Date(2022, 1, 1).toTemporalInstant().toString({ smallestUnit: 'microseconds' });
+      const firstDayOf2023 = new Date(2023, 1, 1).toTemporalInstant().toString({ smallestUnit: 'microseconds' });
       const alice = await DidKeyResolver.generate();
       const schema = '2021And2022Schema';
       const write1 = await TestDataGenerator.generateRecordsWrite({
@@ -274,8 +282,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 = new Date(2021, 12, 31).toTemporalInstant().toString({ smallestUnit: 'microseconds' });
+      const lastDayOf2023 = new Date(2023, 12, 31).toTemporalInstant().toString({ smallestUnit: 'microseconds' });
       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: {