payload-reserve 2.0.0 → 2.1.1

package/dist/utilities/tenantTimezone.js

@@ -0,0 +1,77 @@
+import { isValidTimezone } from './timezoneUtils.js';
+/**
+ * Pure precedence resolver for a tenant's effective timezone:
+ *
+ *   selected tenant's zone  →  global default  →  'UTC'
+ *
+ * An absent or invalid zone at any step is skipped, never thrown — so a tenant
+ * with a bad/empty timezone value transparently falls back to the global default.
+ */ export function resolveTenantTimezone(args) {
+    const { globalTimezone, tenantTimezone } = args;
+    if (isValidTimezone(tenantTimezone)) {
+        return tenantTimezone;
+    }
+    if (isValidTimezone(globalTimezone)) {
+        return globalTimezone;
+    }
+    return 'UTC';
+}
+/**
+ * The tenant collection's slug, read off the scoped collection's tenant
+ * relationship field (`relationTo`). Keeps the plugin tenant-agnostic — it never
+ * hardcodes a tenants slug. Returns null for an absent, polymorphic, or
+ * non-relationship tenant field.
+ */ export function tenantCollectionSlug(collection, tenantField) {
+    const fields = collection?.fields;
+    if (!Array.isArray(fields)) {
+        return null;
+    }
+    for (const f of fields){
+        if (typeof f === 'object' && f !== null && f.name === tenantField) {
+            const rel = f.relationTo;
+            return typeof rel === 'string' ? rel : null;
+        }
+    }
+    return null;
+}
+/**
+ * Resolve the effective timezone for the selected tenant in multiTenant mode.
+ *
+ * Loads the tenant document (slug derived from the scoped collection's tenant
+ * relationship) and reads `timezoneField`, then applies {@link resolveTenantTimezone}
+ * precedence. Returns the global default — without a DB read — when no tenant is
+ * selected, when the scoped collection lacks a tenant relationship, or when the
+ * lookup fails. Never throws.
+ */ export async function getEffectiveTenantTimezone(args) {
+    const { globalTimezone, payload, scopedCollection, tenantField, tenantId, timezoneField } = args;
+    if (!tenantId) {
+        return resolveTenantTimezone({
+            globalTimezone
+        });
+    }
+    const tenantSlug = tenantCollectionSlug(scopedCollection, tenantField);
+    if (!tenantSlug) {
+        return resolveTenantTimezone({
+            globalTimezone
+        });
+    }
+    let tenantTimezone = null;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const tenant = await payload.findByID({
+            id: tenantId,
+            collection: tenantSlug,
+            depth: 0
+        });
+        const raw = tenant?.[timezoneField];
+        tenantTimezone = typeof raw === 'string' ? raw : null;
+    } catch  {
+        tenantTimezone = null;
+    }
+    return resolveTenantTimezone({
+        globalTimezone,
+        tenantTimezone
+    });
+}
+
+//# sourceMappingURL=tenantTimezone.js.map

package/dist/utilities/tenantTimezone.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/tenantTimezone.ts"],"sourcesContent":["import type { Payload } from 'payload'\n\nimport { isValidTimezone } from './timezoneUtils.js'\n\ntype CollectionLike = { fields?: unknown[] } | null | undefined\n\ntype FieldLike = { name?: string; relationTo?: string | string[]; type?: string }\n\n/**\n * Pure precedence resolver for a tenant's effective timezone:\n *\n *   selected tenant's zone  →  global default  →  'UTC'\n *\n * An absent or invalid zone at any step is skipped, never thrown — so a tenant\n * with a bad/empty timezone value transparently falls back to the global default.\n */\nexport function resolveTenantTimezone(args: {\n  globalTimezone: string\n  tenantTimezone?: null | string\n}): string {\n  const { globalTimezone, tenantTimezone } = args\n  if (isValidTimezone(tenantTimezone)) {\n    return tenantTimezone\n  }\n  if (isValidTimezone(globalTimezone)) {\n    return globalTimezone\n  }\n  return 'UTC'\n}\n\n/**\n * The tenant collection's slug, read off the scoped collection's tenant\n * relationship field (`relationTo`). Keeps the plugin tenant-agnostic — it never\n * hardcodes a tenants slug. Returns null for an absent, polymorphic, or\n * non-relationship tenant field.\n */\nexport function tenantCollectionSlug(collection: CollectionLike, tenantField: string): null | string {\n  const fields = collection?.fields\n  if (!Array.isArray(fields)) {\n    return null\n  }\n  for (const f of fields) {\n    if (typeof f === 'object' && f !== null && (f as FieldLike).name === tenantField) {\n      const rel = (f as FieldLike).relationTo\n      return typeof rel === 'string' ? rel : null\n    }\n  }\n  return null\n}\n\n/**\n * Resolve the effective timezone for the selected tenant in multiTenant mode.\n *\n * Loads the tenant document (slug derived from the scoped collection's tenant\n * relationship) and reads `timezoneField`, then applies {@link resolveTenantTimezone}\n * precedence. Returns the global default — without a DB read — when no tenant is\n * selected, when the scoped collection lacks a tenant relationship, or when the\n * lookup fails. Never throws.\n */\nexport async function getEffectiveTenantTimezone(args: {\n  globalTimezone: string\n  payload: Payload\n  scopedCollection: CollectionLike\n  tenantField: string\n  tenantId: null | string\n  timezoneField: string\n}): Promise<string> {\n  const { globalTimezone, payload, scopedCollection, tenantField, tenantId, timezoneField } = args\n  if (!tenantId) {\n    return resolveTenantTimezone({ globalTimezone })\n  }\n  const tenantSlug = tenantCollectionSlug(scopedCollection, tenantField)\n  if (!tenantSlug) {\n    return resolveTenantTimezone({ globalTimezone })\n  }\n  let tenantTimezone: null | string = null\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const tenant = await (payload.findByID as any)({\n      id: tenantId,\n      collection: tenantSlug,\n      depth: 0,\n    })\n    const raw = (tenant as null | Record<string, unknown>)?.[timezoneField]\n    tenantTimezone = typeof raw === 'string' ? raw : null\n  } catch {\n    tenantTimezone = null\n  }\n  return resolveTenantTimezone({ globalTimezone, tenantTimezone })\n}\n"],"names":["isValidTimezone","resolveTenantTimezone","args","globalTimezone","tenantTimezone","tenantCollectionSlug","collection","tenantField","fields","Array","isArray","f","name","rel","relationTo","getEffectiveTenantTimezone","payload","scopedCollection","tenantId","timezoneField","tenantSlug","tenant","findByID","id","depth","raw"],"mappings":"AAEA,SAASA,eAAe,QAAQ,qBAAoB;AAMpD;;;;;;;CAOC,GACD,OAAO,SAASC,sBAAsBC,IAGrC;IACC,MAAM,EAAEC,cAAc,EAAEC,cAAc,EAAE,GAAGF;IAC3C,IAAIF,gBAAgBI,iBAAiB;QACnC,OAAOA;IACT;IACA,IAAIJ,gBAAgBG,iBAAiB;QACnC,OAAOA;IACT;IACA,OAAO;AACT;AAEA;;;;;CAKC,GACD,OAAO,SAASE,qBAAqBC,UAA0B,EAAEC,WAAmB;IAClF,MAAMC,SAASF,YAAYE;IAC3B,IAAI,CAACC,MAAMC,OAAO,CAACF,SAAS;QAC1B,OAAO;IACT;IACA,KAAK,MAAMG,KAAKH,OAAQ;QACtB,IAAI,OAAOG,MAAM,YAAYA,MAAM,QAAQ,AAACA,EAAgBC,IAAI,KAAKL,aAAa;YAChF,MAAMM,MAAM,AAACF,EAAgBG,UAAU;YACvC,OAAO,OAAOD,QAAQ,WAAWA,MAAM;QACzC;IACF;IACA,OAAO;AACT;AAEA;;;;;;;;CAQC,GACD,OAAO,eAAeE,2BAA2Bb,IAOhD;IACC,MAAM,EAAEC,cAAc,EAAEa,OAAO,EAAEC,gBAAgB,EAAEV,WAAW,EAAEW,QAAQ,EAAEC,aAAa,EAAE,GAAGjB;IAC5F,IAAI,CAACgB,UAAU;QACb,OAAOjB,sBAAsB;YAAEE;QAAe;IAChD;IACA,MAAMiB,aAAaf,qBAAqBY,kBAAkBV;IAC1D,IAAI,CAACa,YAAY;QACf,OAAOnB,sBAAsB;YAAEE;QAAe;IAChD;IACA,IAAIC,iBAAgC;IACpC,IAAI;QACF,8DAA8D;QAC9D,MAAMiB,SAAS,MAAM,AAACL,QAAQM,QAAQ,CAAS;YAC7CC,IAAIL;YACJZ,YAAYc;YACZI,OAAO;QACT;QACA,MAAMC,MAAOJ,QAA2C,CAACF,cAAc;QACvEf,iBAAiB,OAAOqB,QAAQ,WAAWA,MAAM;IACnD,EAAE,OAAM;QACNrB,iBAAiB;IACnB;IACA,OAAOH,sBAAsB;QAAEE;QAAgBC;IAAe;AAChE"}

package/dist/utilities/timezoneUtils.d.ts

@@ -8,6 +8,11 @@ export declare function getHourInTimezone(date: Date, timeZone: string): number;
  * (round-trip check rejects shape-valid impossibilities like 2026-02-30).
  */
 export declare function isValidDayKey(dayKey: string): boolean;
+/**
+ * True when the given string is a usable IANA timezone name. Non-throwing
+ * counterpart to {@link validateTimezone}; an empty/nullish value is not valid.
+ */
+export declare function isValidTimezone(timeZone: null | string | undefined): timeZone is string;
 /**
  * Throws when the given string is not a valid IANA timezone name.
  */

package/dist/utilities/timezoneUtils.js

@@ -61,13 +61,25 @@ function getWallClockFormatter(timeZone) {
     }
 }
 /**
- * Throws when the given string is not a valid IANA timezone name.
- */ export function validateTimezone(timeZone) {
+ * True when the given string is a usable IANA timezone name. Non-throwing
+ * counterpart to {@link validateTimezone}; an empty/nullish value is not valid.
+ */ export function isValidTimezone(timeZone) {
+    if (!timeZone) {
+        return false;
+    }
     try {
         new Intl.DateTimeFormat('en-US', {
             timeZone
         });
+        return true;
     } catch  {
+        return false;
+    }
+}
+/**
+ * Throws when the given string is not a valid IANA timezone name.
+ */ export function validateTimezone(timeZone) {
+    if (!isValidTimezone(timeZone)) {
         throw new Error(`Invalid timezone "${timeZone}" — use an IANA name like 'Europe/Paris' or 'UTC'`);
     }
 }

package/dist/utilities/timezoneUtils.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utilities/timezoneUtils.ts"],"sourcesContent":["import type { DayOfWeek } from '../types.js'\n\nconst DAY_BY_UTC_INDEX: DayOfWeek[] = ['sun', 'mon', 'tue', 'wed', 'thu', 'fri', 'sat']\n\nconst DAY_KEY_RE = /^\\d{4}-\\d{2}-\\d{2}$/\n\nconst TIME_RE = /^(?:[01]\\d|2[0-3]):[0-5]\\d$/\n\nconst dayKeyFormatters = new Map<string, Intl.DateTimeFormat>()\nconst wallClockFormatters = new Map<string, Intl.DateTimeFormat>()\n\nfunction getDayKeyFormatter(timeZone: string): Intl.DateTimeFormat {\n  let formatter = dayKeyFormatters.get(timeZone)\n  if (!formatter) {\n    formatter = new Intl.DateTimeFormat('en-CA', {\n      day: '2-digit',\n      month: '2-digit',\n      timeZone,\n      year: 'numeric',\n    })\n    dayKeyFormatters.set(timeZone, formatter)\n  }\n  return formatter\n}\n\nfunction getWallClockFormatter(timeZone: string): Intl.DateTimeFormat {\n  let formatter = wallClockFormatters.get(timeZone)\n  if (!formatter) {\n    formatter = new Intl.DateTimeFormat('en-CA', {\n      day: '2-digit',\n      hour: '2-digit',\n      hourCycle: 'h23',\n      minute: '2-digit',\n      month: '2-digit',\n      second: '2-digit',\n      timeZone,\n      year: 'numeric',\n    })\n    wallClockFormatters.set(timeZone, formatter)\n  }\n  return formatter\n}\n\n/**\n * Wall-clock hour (0-23) of an instant as seen in the given timezone.\n */\nexport function getHourInTimezone(date: Date, timeZone: string): number {\n  const parts = getWallClockFormatter(timeZone).formatToParts(date)\n  return Number(parts.find((p) => p.type === 'hour')?.value ?? '0')\n}\n\n/**\n * True when the string is a real calendar date in YYYY-MM-DD form\n * (round-trip check rejects shape-valid impossibilities like 2026-02-30).\n */\nexport function isValidDayKey(dayKey: string): boolean {\n  if (!DAY_KEY_RE.test(dayKey)) {\n    return false\n  }\n  try {\n    return new Date(`${dayKey}T00:00:00Z`).toISOString().slice(0, 10) === dayKey\n  } catch {\n    return false\n  }\n}\n\n/**\n * Throws when the given string is not a valid IANA timezone name.\n */\nexport function validateTimezone(timeZone: string): void {\n  try {\n    new Intl.DateTimeFormat('en-US', { timeZone })\n  } catch {\n    throw new Error(\n      `Invalid timezone \"${timeZone}\" — use an IANA name like 'Europe/Paris' or 'UTC'`,\n    )\n  }\n}\n\n/**\n * Calendar day key (YYYY-MM-DD) of an instant as seen in the given timezone.\n * en-CA locale formats dates as YYYY-MM-DD natively.\n */\nexport function getDayKeyInTimezone(date: Date, timeZone: string): string {\n  return getDayKeyFormatter(timeZone).format(date)\n}\n\n/**\n * Day of week for a calendar date — TZ-independent pure calendar math.\n */\nexport function getDayOfWeekFromDayKey(dayKey: string): DayOfWeek {\n  if (!DAY_KEY_RE.test(dayKey)) {\n    throw new Error(`Invalid day key \"${dayKey}\" — expected YYYY-MM-DD`)\n  }\n  return DAY_BY_UTC_INDEX[new Date(`${dayKey}T00:00:00Z`).getUTCDay()]\n}\n\n/**\n * Wall-clock parts of a UTC instant in the given timezone, reconstructed as a\n * UTC timestamp — the difference to the instant is the zone's offset.\n */\nfunction offsetMs(timeZone: string, utcDate: Date): number {\n  const parts = getWallClockFormatter(timeZone).formatToParts(utcDate)\n  const get = (type: string): number =>\n    Number(parts.find((p) => p.type === type)?.value ?? '0')\n  const asUTC = Date.UTC(\n    get('year'),\n    get('month') - 1,\n    get('day'),\n    get('hour'),\n    get('minute'),\n    get('second'),\n  )\n  return asUTC - utcDate.getTime()\n}\n\n/**\n * The UTC instant of wall-clock `HH:mm` on calendar day `dayKey` in `timeZone`.\n * Two-pass offset algorithm; DST-safe. Spring-forward gap times resolve to a\n * nearby valid instant (for midnight-gap zones like America/Santiago this can be\n * late on the prior calendar day); fall-back ambiguous times resolve to one\n * consistent occurrence.\n */\nexport function combineDayKeyAndTime(dayKey: string, time: string, timeZone: string): Date {\n  if (!DAY_KEY_RE.test(dayKey)) {\n    throw new Error(`Invalid day key \"${dayKey}\" — expected YYYY-MM-DD`)\n  }\n  if (!TIME_RE.test(time)) {\n    throw new Error(`Invalid time \"${time}\" — expected HH:mm`)\n  }\n  const [y, mo, d] = dayKey.split('-').map(Number)\n  const [h, mi] = time.split(':').map(Number)\n  const guess = Date.UTC(y, mo - 1, d, h, mi)\n  const candidate = guess - offsetMs(timeZone, new Date(guess))\n  return new Date(guess - offsetMs(timeZone, new Date(candidate)))\n}\n\n/**\n * Instant of 23:59:59.999 (in `timeZone`) on the day containing `date`.\n */\nexport function endOfDayInTimezone(date: Date, timeZone: string): Date {\n  const dayKey = getDayKeyInTimezone(date, timeZone)\n  const lastMinute = combineDayKeyAndTime(dayKey, '23:59', timeZone)\n  return new Date(lastMinute.getTime() + 59_999)\n}\n\n/**\n * Pure calendar arithmetic on day keys — DST-proof day iteration.\n */\nexport function addDaysToDayKey(dayKey: string, days: number): string {\n  if (!DAY_KEY_RE.test(dayKey)) {\n    throw new Error(`Invalid day key \"${dayKey}\" — expected YYYY-MM-DD`)\n  }\n  const base = new Date(`${dayKey}T00:00:00Z`)\n  const shifted = new Date(base.getTime() + days * 86_400_000)\n  return shifted.toISOString().slice(0, 10)\n}\n"],"names":["DAY_BY_UTC_INDEX","DAY_KEY_RE","TIME_RE","dayKeyFormatters","Map","wallClockFormatters","getDayKeyFormatter","timeZone","formatter","get","Intl","DateTimeFormat","day","month","year","set","getWallClockFormatter","hour","hourCycle","minute","second","getHourInTimezone","date","parts","formatToParts","Number","find","p","type","value","isValidDayKey","dayKey","test","Date","toISOString","slice","validateTimezone","Error","getDayKeyInTimezone","format","getDayOfWeekFromDayKey","getUTCDay","offsetMs","utcDate","asUTC","UTC","getTime","combineDayKeyAndTime","time","y","mo","d","split","map","h","mi","guess","candidate","endOfDayInTimezone","lastMinute","addDaysToDayKey","days","base","shifted"],"mappings":"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"}
+{"version":3,"sources":["../../src/utilities/timezoneUtils.ts"],"sourcesContent":["import type { DayOfWeek } from '../types.js'\n\nconst DAY_BY_UTC_INDEX: DayOfWeek[] = ['sun', 'mon', 'tue', 'wed', 'thu', 'fri', 'sat']\n\nconst DAY_KEY_RE = /^\\d{4}-\\d{2}-\\d{2}$/\n\nconst TIME_RE = /^(?:[01]\\d|2[0-3]):[0-5]\\d$/\n\nconst dayKeyFormatters = new Map<string, Intl.DateTimeFormat>()\nconst wallClockFormatters = new Map<string, Intl.DateTimeFormat>()\n\nfunction getDayKeyFormatter(timeZone: string): Intl.DateTimeFormat {\n  let formatter = dayKeyFormatters.get(timeZone)\n  if (!formatter) {\n    formatter = new Intl.DateTimeFormat('en-CA', {\n      day: '2-digit',\n      month: '2-digit',\n      timeZone,\n      year: 'numeric',\n    })\n    dayKeyFormatters.set(timeZone, formatter)\n  }\n  return formatter\n}\n\nfunction getWallClockFormatter(timeZone: string): Intl.DateTimeFormat {\n  let formatter = wallClockFormatters.get(timeZone)\n  if (!formatter) {\n    formatter = new Intl.DateTimeFormat('en-CA', {\n      day: '2-digit',\n      hour: '2-digit',\n      hourCycle: 'h23',\n      minute: '2-digit',\n      month: '2-digit',\n      second: '2-digit',\n      timeZone,\n      year: 'numeric',\n    })\n    wallClockFormatters.set(timeZone, formatter)\n  }\n  return formatter\n}\n\n/**\n * Wall-clock hour (0-23) of an instant as seen in the given timezone.\n */\nexport function getHourInTimezone(date: Date, timeZone: string): number {\n  const parts = getWallClockFormatter(timeZone).formatToParts(date)\n  return Number(parts.find((p) => p.type === 'hour')?.value ?? '0')\n}\n\n/**\n * True when the string is a real calendar date in YYYY-MM-DD form\n * (round-trip check rejects shape-valid impossibilities like 2026-02-30).\n */\nexport function isValidDayKey(dayKey: string): boolean {\n  if (!DAY_KEY_RE.test(dayKey)) {\n    return false\n  }\n  try {\n    return new Date(`${dayKey}T00:00:00Z`).toISOString().slice(0, 10) === dayKey\n  } catch {\n    return false\n  }\n}\n\n/**\n * True when the given string is a usable IANA timezone name. Non-throwing\n * counterpart to {@link validateTimezone}; an empty/nullish value is not valid.\n */\nexport function isValidTimezone(timeZone: null | string | undefined): timeZone is string {\n  if (!timeZone) {\n    return false\n  }\n  try {\n    new Intl.DateTimeFormat('en-US', { timeZone })\n    return true\n  } catch {\n    return false\n  }\n}\n\n/**\n * Throws when the given string is not a valid IANA timezone name.\n */\nexport function validateTimezone(timeZone: string): void {\n  if (!isValidTimezone(timeZone)) {\n    throw new Error(\n      `Invalid timezone \"${timeZone}\" — use an IANA name like 'Europe/Paris' or 'UTC'`,\n    )\n  }\n}\n\n/**\n * Calendar day key (YYYY-MM-DD) of an instant as seen in the given timezone.\n * en-CA locale formats dates as YYYY-MM-DD natively.\n */\nexport function getDayKeyInTimezone(date: Date, timeZone: string): string {\n  return getDayKeyFormatter(timeZone).format(date)\n}\n\n/**\n * Day of week for a calendar date — TZ-independent pure calendar math.\n */\nexport function getDayOfWeekFromDayKey(dayKey: string): DayOfWeek {\n  if (!DAY_KEY_RE.test(dayKey)) {\n    throw new Error(`Invalid day key \"${dayKey}\" — expected YYYY-MM-DD`)\n  }\n  return DAY_BY_UTC_INDEX[new Date(`${dayKey}T00:00:00Z`).getUTCDay()]\n}\n\n/**\n * Wall-clock parts of a UTC instant in the given timezone, reconstructed as a\n * UTC timestamp — the difference to the instant is the zone's offset.\n */\nfunction offsetMs(timeZone: string, utcDate: Date): number {\n  const parts = getWallClockFormatter(timeZone).formatToParts(utcDate)\n  const get = (type: string): number =>\n    Number(parts.find((p) => p.type === type)?.value ?? '0')\n  const asUTC = Date.UTC(\n    get('year'),\n    get('month') - 1,\n    get('day'),\n    get('hour'),\n    get('minute'),\n    get('second'),\n  )\n  return asUTC - utcDate.getTime()\n}\n\n/**\n * The UTC instant of wall-clock `HH:mm` on calendar day `dayKey` in `timeZone`.\n * Two-pass offset algorithm; DST-safe. Spring-forward gap times resolve to a\n * nearby valid instant (for midnight-gap zones like America/Santiago this can be\n * late on the prior calendar day); fall-back ambiguous times resolve to one\n * consistent occurrence.\n */\nexport function combineDayKeyAndTime(dayKey: string, time: string, timeZone: string): Date {\n  if (!DAY_KEY_RE.test(dayKey)) {\n    throw new Error(`Invalid day key \"${dayKey}\" — expected YYYY-MM-DD`)\n  }\n  if (!TIME_RE.test(time)) {\n    throw new Error(`Invalid time \"${time}\" — expected HH:mm`)\n  }\n  const [y, mo, d] = dayKey.split('-').map(Number)\n  const [h, mi] = time.split(':').map(Number)\n  const guess = Date.UTC(y, mo - 1, d, h, mi)\n  const candidate = guess - offsetMs(timeZone, new Date(guess))\n  return new Date(guess - offsetMs(timeZone, new Date(candidate)))\n}\n\n/**\n * Instant of 23:59:59.999 (in `timeZone`) on the day containing `date`.\n */\nexport function endOfDayInTimezone(date: Date, timeZone: string): Date {\n  const dayKey = getDayKeyInTimezone(date, timeZone)\n  const lastMinute = combineDayKeyAndTime(dayKey, '23:59', timeZone)\n  return new Date(lastMinute.getTime() + 59_999)\n}\n\n/**\n * Pure calendar arithmetic on day keys — DST-proof day iteration.\n */\nexport function addDaysToDayKey(dayKey: string, days: number): string {\n  if (!DAY_KEY_RE.test(dayKey)) {\n    throw new Error(`Invalid day key \"${dayKey}\" — expected YYYY-MM-DD`)\n  }\n  const base = new Date(`${dayKey}T00:00:00Z`)\n  const shifted = new Date(base.getTime() + days * 86_400_000)\n  return shifted.toISOString().slice(0, 10)\n}\n"],"names":["DAY_BY_UTC_INDEX","DAY_KEY_RE","TIME_RE","dayKeyFormatters","Map","wallClockFormatters","getDayKeyFormatter","timeZone","formatter","get","Intl","DateTimeFormat","day","month","year","set","getWallClockFormatter","hour","hourCycle","minute","second","getHourInTimezone","date","parts","formatToParts","Number","find","p","type","value","isValidDayKey","dayKey","test","Date","toISOString","slice","isValidTimezone","validateTimezone","Error","getDayKeyInTimezone","format","getDayOfWeekFromDayKey","getUTCDay","offsetMs","utcDate","asUTC","UTC","getTime","combineDayKeyAndTime","time","y","mo","d","split","map","h","mi","guess","candidate","endOfDayInTimezone","lastMinute","addDaysToDayKey","days","base","shifted"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "payload-reserve",
-  "version": "2.0.0",
+  "version": "2.1.1",
   "description": "A Payload CMS 3.x plugin for reservation and booking management with conflict detection, status workflows, and calendar UI",
   "keywords": [
     "payload",