feat: allows UPS to receive cookie config options

CHANGELOG.md

@@ -1,3 +1,10 @@
+# [1.17.0-ups-configurable-cookie.1](https://github.com/mParticle/aquarium/compare/v1.16.1...v1.17.0-ups-configurable-cookie.1) (2024-06-03)
+
+
+### Features
+
+* allows UPS to receive cookie config options instead of only the key ([517d030](https://github.com/mParticle/aquarium/commit/517d03066bb1d55968d650bb7a2a6162a1567ad7))
+
 ## [1.16.1](https://github.com/mParticle/aquarium/compare/v1.16.0...v1.16.1) (2024-06-03)
 
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mparticle/aquarium",
-  "version": "1.16.1",
+  "version": "1.17.0-ups-configurable-cookie.1",
   "description": "mParticle Component Library",
   "license": "Apache-2.0",
   "keywords": [

src/services/user-preferences/user-preferences-service.spec.ts

@@ -51,9 +51,8 @@ describe('When testing the User Preferences Service', () => {
       userPreferencesService = new UserPreferencesService<TestUserPreferenceId>(
         definitions,
         compositeUserPreferencesService,
-        cookieKey,
         lowLevelScope,
-        () => new Date(),
+        { key: cookieKey },
       )
       await userPreferencesService.init()
 
@@ -82,9 +81,8 @@ describe('When testing the User Preferences Service', () => {
       userPreferencesService = new UserPreferencesService<TestUserPreferenceId>(
         definitions,
         compositeUserPreferencesService,
-        cookieKey,
         currentScope,
-        () => new Date(),
+        { key: cookieKey },
       )
       await userPreferencesService.init()
 
@@ -109,9 +107,8 @@ describe('When testing the User Preferences Service', () => {
       userPreferencesService = new UserPreferencesService<TestUserPreferenceId>(
         definitions,
         compositeUserPreferencesService,
-        cookieKey,
         someScope,
-        () => new Date(),
+        { key: cookieKey },
       )
       await userPreferencesService.init()
 
@@ -148,9 +145,8 @@ describe('When testing the User Preferences Service', () => {
         userPreferencesService = new UserPreferencesService<TestUserPreferenceId>(
           definitions,
           compositeUserPreferencesService,
-          cookieKey,
           lowLevelScope,
-          () => new Date(),
+          { key: cookieKey },
         )
         await userPreferencesService.init()
 
@@ -182,9 +178,8 @@ describe('When testing the User Preferences Service', () => {
       userPreferencesService = new UserPreferencesService<TestUserPreferenceId>(
         definitions,
         compositeUserPreferencesService,
-        cookieKey,
         lowLevelScope,
-        () => new Date(),
+        { key: cookieKey },
       )
       await userPreferencesService.init()
 

src/services/user-preferences/user-preferences.ts

@@ -1,20 +1,20 @@
 /* eslint-disable @typescript-eslint/no-extraneous-class,no-unused-vars,@typescript-eslint/no-unused-vars */
-import * as Cookies from '../../utils/Cookies'
 import { type UserPreferences } from 'src/services/user-preferences/models/storage-models/user-preferences'
 import { type CompositeUserPreferences } from 'src/services/user-preferences/models/user-preferences/composite-user-preferences'
 import { type UserPreferenceScope } from 'src/services/user-preferences/models/storage-models/user-preference-scope'
 import { type UserPreferenceDefinitions } from 'src/services/user-preferences/models/definitions/user-preference-definitions'
 import { type CompositeUserPreferencesService } from 'src/services/user-preferences/composite-user-preferences-service'
+import * as Cookies from 'src/utils/Cookies'
+import { type CookieOptions } from 'src/utils/Cookies'
 
 export class UserPreferencesService<TUserPreferenceId extends PropertyKey> {
   public preferences!: CompositeUserPreferences<TUserPreferenceId>
 
   constructor(
     private readonly definitions: UserPreferenceDefinitions<TUserPreferenceId>,
     private readonly compositeUserPreferencesService: CompositeUserPreferencesService<TUserPreferenceId>,
-    private readonly cookieKey: string,
     private readonly currentScope: UserPreferenceScope,
-    public dateFormatter: () => Date,
+    private readonly cookieOptions: CookieOptions & { key: string },
     private readonly onUpdate?: (resolvedPreferences: CompositeUserPreferences<TUserPreferenceId>) => void,
   ) {}
 
@@ -43,7 +43,7 @@ export class UserPreferencesService<TUserPreferenceId extends PropertyKey> {
     // @ts-expect-error
     const { allowedScope } = this.definitions[userPreferenceId]
 
-    const currentStoredPreferences = Cookies.getObject(this.cookieKey)
+    const currentStoredPreferences = Cookies.getObject(this.cookieOptions.key)
 
     const storedPreferences = this.compositeUserPreferencesService.getUpdatedUserPreferenceStorageObject(
       userPreferenceId,
@@ -69,14 +69,11 @@ export class UserPreferencesService<TUserPreferenceId extends PropertyKey> {
   }
 
   private async getStoredPreferences(): Promise<UserPreferences<TUserPreferenceId>> {
-    return await Promise.resolve(Cookies.getObject(this.cookieKey) ?? {})
+    return await Promise.resolve(Cookies.getObject(this.cookieOptions.key) ?? {})
   }
 
   private async setStoredPreferences(storedPreferences: UserPreferences<TUserPreferenceId>): Promise<void> {
-    Cookies.putObject(this.cookieKey, storedPreferences, {
-      expires: this.dateFormatter(),
-      path: '/',
-    })
+    Cookies.putObject(this.cookieOptions.key, storedPreferences, this.cookieOptions)
 
     await Promise.resolve()
   }

src/utils/Cookies.ts

@@ -12,23 +12,31 @@ export function getObject(key: string): string | null {
   return value ? JSON.parse(value) : value
 }
 
-export function put(key: string, value: string | null, options: any /* TODO fix any */ = {}): void {
+export type CookieOptions = {
+  path?: string
+  domain?: string
+  expires?: string | Date
+  secure?: boolean
+}
+
+export function put(key: string, value: string | null, options: CookieOptions = {}): void {
+  const defaultExpires = 'Thu, 01 Jan 1970 00:00:01 GMT'
   let expires = options.expires
-  if (value == null) expires = 'Thu, 01 Jan 1970 00:00:01 GMT'
+  if (value == null) expires = defaultExpires
   if (typeof expires === 'string') expires = new Date(expires)
   let str = `${_encode(key)}=${value != null ? _encode(value) : ''}`
   if (options.path) str += `; path=${options.path}`
   if (options.domain) str += `; domain=${options.domain}`
-  if (options.expires) str += `; expires=${expires.toUTCString()}`
+  if (options.expires) str += `; expires=${expires?.toUTCString() ?? defaultExpires}`
   if (options.secure) str += '; secure'
   document.cookie = str
 }
 
-export function putObject(key: string, value: Record<string, unknown>, options = {}): void {
+export function putObject(key: string, value: Record<string, unknown>, options: CookieOptions = {}): void {
   put(key, JSON.stringify(value), options)
 }
 
-export function remove(key: string, options = {}): void {
+export function remove(key: string, options: CookieOptions = {}): void {
   put(key, null, options)
 }