@quatrain/core 1.2.13 → 1.2.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quatrain/core",
-  "version": "1.2.13",
+  "version": "1.2.15",
   "description": "Core objects for business apps",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -33,7 +33,7 @@
   },
   "dependencies": {
     "@quatrain/log": "^1.2.3",
-    "@quatrain/types": "^1.2.12",
+    "@quatrain/types": "^1.2.13",
     "node-persist": "^4.0.4",
     "which": "^5.0.0"
   },

package/src/components/ObjectUri.test.ts

@@ -71,4 +71,43 @@ describe('Object Uri', () => {
       uri.collection = 'collection'
       expect(uri.collection).toBe('collection')
    })
+
+   test('exceptions and error boundaries', () => {
+      // 1. Odd number of path parts (> 1) and not a file
+      expect(() => new ObjectUri('part1/part2/part3')).toThrow("Path parts number must be 1 or even")
+
+      const uri = new ObjectUri('collection/uid')
+      
+      // 2. class setter/getter
+      uri.class = { name: 'MyClass' }
+      expect(uri.collection).toBe('myclass')
+      expect(uri.class).toEqual({ name: 'MyClass' })
+
+      uri.class = null
+      expect(uri.collection).toBeUndefined()
+
+      // 3. ownPath getter
+      const parentUri = new ObjectUri('collection1/uid1/collection2/uid2')
+      expect(parentUri.ownPath).toBe('collection2/uid2')
+
+      // 4. collection setter exception
+      const lockedUri = new ObjectUri('collection/uid')
+      expect(() => { lockedUri.collection = 'new-collection' }).toThrow('Collection value already set')
+
+      // 5. toReference and toJSON
+      const refUri = new ObjectUri('@s3:collection/uid', 'my label')
+      refUri.path = 'collection/uid'
+      expect(refUri.toReference()).toEqual({
+         ref: 'collection/uid',
+         uri: '@s3:collection/uid',
+         label: 'my label'
+      })
+
+      expect(refUri.toJSON()).toEqual({
+         ref: 'collection/uid',
+         label: 'my label',
+         backend: '@s3'
+      })
+   })
 })
+

package/src/properties/DateTimeProperty.test.ts

@@ -0,0 +1,91 @@
+import { DateTimeProperty } from './DateTimeProperty'
+
+describe('DateTimeProperty', () => {
+   afterEach(() => {
+      // Restore default global setting after each test
+      DateTimeProperty.RETURN_AS = DateTimeProperty.AS_IS
+   })
+
+   describe('timezone configuration', () => {
+      it('should default to "Z" timezone if none is provided', () => {
+         const prop = new DateTimeProperty({ name: 'testDate' })
+         expect(prop.timezone).toBe('Z')
+      })
+
+      it('should accept and return a custom timezone string', () => {
+         const prop = new DateTimeProperty({ name: 'testDate', timezone: 'Europe/Paris' })
+         expect(prop.timezone).toBe('Europe/Paris')
+      })
+   })
+
+   describe('value setting with default RETURN_AS = asis', () => {
+      it('should set and get values unmodified', () => {
+         const prop = new DateTimeProperty({ name: 'testDate' })
+         const date = new Date()
+
+         prop.set(date)
+         expect(prop.val()).toBe(date)
+
+         prop.set('2026-05-24T09:00:00Z')
+         expect(prop.val()).toBe('2026-05-24T09:00:00Z')
+
+         prop.set(1716537600000)
+         expect(prop.val()).toBe(1716537600000)
+      })
+   })
+
+   describe('value setting with RETURN_AS = unix_timestamp', () => {
+      beforeEach(() => {
+         DateTimeProperty.RETURN_AS = DateTimeProperty.UNIX_TIMESTAMP
+      })
+
+      it('should convert JS Date objects to UNIX timestamp milliseconds', () => {
+         const prop = new DateTimeProperty({ name: 'testDate' })
+         const date = new Date('2026-05-24T12:00:00.000Z')
+
+         prop.set(date)
+         expect(prop.val()).toBe(date.getTime())
+      })
+
+      it('should parse ISO strings with trailing Z as UTC timestamps', () => {
+         const prop = new DateTimeProperty({ name: 'testDate' })
+         prop.set('2026-05-24T12:00:00.000Z')
+
+         const expectedTime = Date.parse('2026-05-24T12:00:00.000Z')
+         expect(prop.val()).toBe(expectedTime)
+      })
+
+      it('should parse ISO strings with timezone offsets correctly', () => {
+         const prop = new DateTimeProperty({ name: 'testDate' })
+         prop.set('2026-05-24T12:00:00+02:00')
+
+         const expectedTime = Date.parse('2026-05-24T12:00:00+02:00')
+         expect(prop.val()).toBe(expectedTime)
+      })
+
+      it('should treat plain date strings without timezone as UTC by appending T and Z', () => {
+         const prop = new DateTimeProperty({ name: 'testDate' })
+         
+         // Non-ISO string with space, no offset
+         prop.set('2026-05-24 12:00:00')
+
+         const expectedTime = Date.parse('2026-05-24T12:00:00Z')
+         expect(prop.val()).toBe(expectedTime)
+      })
+
+      it('should pass numeric timestamps directly', () => {
+         const prop = new DateTimeProperty({ name: 'testDate' })
+         const timestamp = 1716552000000
+
+         prop.set(timestamp)
+         expect(prop.val()).toBe(timestamp)
+      })
+
+      it('should handle falsy/empty values gracefully without throw', () => {
+         const prop = new DateTimeProperty({ name: 'testDate' })
+         
+         prop.set('')
+         expect(prop.val()).toBe('')
+      })
+   })
+})