@gobrand/tiempo 2.4.0 → 2.4.1

package/dist/browserTimezone.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Get the browser/device timezone.
+ *
+ * Returns the IANA timezone identifier configured on the user's device.
+ * This is primarily useful in client-side code (browsers, React Native).
+ *
+ * **Warning:** On servers, this returns the server's configured timezone
+ * (often "UTC"), which is rarely what you want. For user-specific timezones
+ * on the server, retrieve the timezone from user preferences or request headers.
+ *
+ * @returns The IANA timezone identifier (e.g., "America/New_York", "Europe/London")
+ *
+ * @example
+ * ```typescript
+ * import { toZonedTime, browserTimezone } from '@gobrand/tiempo';
+ *
+ * // Convert UTC to the user's local timezone
+ * const userTime = toZonedTime("2025-01-20T20:00:00Z", browserTimezone());
+ * ```
+ */
+export declare function browserTimezone(): string;
+//# sourceMappingURL=browserTimezone.d.ts.map

package/dist/browserTimezone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserTimezone.d.ts","sourceRoot":"","sources":["../src/browserTimezone.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC"}

package/dist/browserTimezone.js

@@ -0,0 +1,7 @@
+import {
+  browserTimezone
+} from "./chunk-RQUZG65U.js";
+export {
+  browserTimezone
+};
+//# sourceMappingURL=browserTimezone.js.map

package/dist/browserTimezone.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/browserTimezone.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=browserTimezone.test.d.ts.map

package/dist/browserTimezone.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserTimezone.test.d.ts","sourceRoot":"","sources":["../src/browserTimezone.test.ts"],"names":[],"mappings":""}

package/dist/{chunk-2MP3ESL7.js → chunk-DCJUK6EE.js}

@@ -16,4 +16,4 @@ function toZonedTime(input, timezone) {
 export {
   toZonedTime
 };
-//# sourceMappingURL=chunk-2MP3ESL7.js.map
+//# sourceMappingURL=chunk-DCJUK6EE.js.map

package/dist/chunk-DCJUK6EE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/toZonedTime.ts"],"sourcesContent":["import { Temporal } from '@js-temporal/polyfill';\n\n/**\n * IANA timezone identifier or \"UTC\".\n *\n * Common timezones:\n * - \"UTC\" - Coordinated Universal Time\n * - \"America/New_York\" - US Eastern\n * - \"America/Los_Angeles\" - US Pacific\n * - \"Europe/London\" - UK\n * - \"Europe/Paris\" - Central European\n * - \"Asia/Tokyo\" - Japan\n * - \"Asia/Shanghai\" - China\n */\nexport type Timezone = 'UTC' | (string & {});\n\n/**\n * Convert a UTC ISO string, Date, Instant, or ZonedDateTime to a ZonedDateTime in the specified timezone.\n *\n * @param input - A UTC ISO 8601 string, Date object, Temporal.Instant, or Temporal.ZonedDateTime\n * @param timezone - IANA timezone identifier (e.g., \"America/New_York\", \"Europe/London\") or \"UTC\"\n * @returns A Temporal.ZonedDateTime in the specified timezone\n *\n * @example\n * ```typescript\n * import { toZonedTime, browserTimezone } from '@gobrand/tiempo';\n *\n * // Server-side: Convert to UTC\n * const utcTime = toZonedTime(\"2025-01-20T20:00:00Z\", \"UTC\");\n *\n * // Server-side: Convert to user's timezone (from DB/preferences)\n * const userTime = toZonedTime(\"2025-01-20T20:00:00Z\", user.timezone);\n *\n * // Client-side: Convert to browser's timezone\n * const localTime = toZonedTime(\"2025-01-20T20:00:00Z\", browserTimezone());\n *\n * // From Date (e.g., from Drizzle ORM)\n * const date = new Date(\"2025-01-20T20:00:00.000Z\");\n * const zoned = toZonedTime(date, \"America/New_York\");\n *\n * // From Instant\n * const instant = Temporal.Instant.from(\"2025-01-20T20:00:00Z\");\n * const zoned = toZonedTime(instant, \"Asia/Tokyo\");\n *\n * // From ZonedDateTime (convert to different timezone)\n * const nyTime = Temporal.ZonedDateTime.from(\"2025-01-20T15:00:00-05:00[America/New_York]\");\n * const tokyoTime = toZonedTime(nyTime, \"Asia/Tokyo\");\n * ```\n */\nexport function toZonedTime(\n  input: string | Date | Temporal.Instant | Temporal.ZonedDateTime,\n  timezone: Timezone\n): Temporal.ZonedDateTime {\n  if (typeof input === 'string') {\n    return Temporal.Instant.from(input).toZonedDateTimeISO(timezone);\n  }\n\n  if (input instanceof Date) {\n    return Temporal.Instant.from(input.toISOString()).toZonedDateTimeISO(timezone);\n  }\n\n  if (input instanceof Temporal.Instant) {\n    return input.toZonedDateTimeISO(timezone);\n  }\n\n  return input.toInstant().toZonedDateTimeISO(timezone);\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AAiDlB,SAAS,YACd,OACA,UACwB;AACxB,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,SAAS,QAAQ,KAAK,KAAK,EAAE,mBAAmB,QAAQ;AAAA,EACjE;AAEA,MAAI,iBAAiB,MAAM;AACzB,WAAO,SAAS,QAAQ,KAAK,MAAM,YAAY,CAAC,EAAE,mBAAmB,QAAQ;AAAA,EAC/E;AAEA,MAAI,iBAAiB,SAAS,SAAS;AACrC,WAAO,MAAM,mBAAmB,QAAQ;AAAA,EAC1C;AAEA,SAAO,MAAM,UAAU,EAAE,mBAAmB,QAAQ;AACtD;","names":[]}

package/dist/chunk-RQUZG65U.js

@@ -0,0 +1,9 @@
+// src/browserTimezone.ts
+function browserTimezone() {
+  return Intl.DateTimeFormat().resolvedOptions().timeZone;
+}
+
+export {
+  browserTimezone
+};
+//# sourceMappingURL=chunk-RQUZG65U.js.map

package/dist/chunk-RQUZG65U.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/browserTimezone.ts"],"sourcesContent":["/**\n * Get the browser/device timezone.\n *\n * Returns the IANA timezone identifier configured on the user's device.\n * This is primarily useful in client-side code (browsers, React Native).\n *\n * **Warning:** On servers, this returns the server's configured timezone\n * (often \"UTC\"), which is rarely what you want. For user-specific timezones\n * on the server, retrieve the timezone from user preferences or request headers.\n *\n * @returns The IANA timezone identifier (e.g., \"America/New_York\", \"Europe/London\")\n *\n * @example\n * ```typescript\n * import { toZonedTime, browserTimezone } from '@gobrand/tiempo';\n *\n * // Convert UTC to the user's local timezone\n * const userTime = toZonedTime(\"2025-01-20T20:00:00Z\", browserTimezone());\n * ```\n */\nexport function browserTimezone(): string {\n  return Intl.DateTimeFormat().resolvedOptions().timeZone;\n}\n"],"mappings":";AAoBO,SAAS,kBAA0B;AACxC,SAAO,KAAK,eAAe,EAAE,gBAAgB,EAAE;AACjD;","names":[]}

package/dist/{chunk-XEDXPI5G.js → chunk-TDQXOSO3.js}

@@ -1,3 +1,6 @@
+import {
+  differenceInMonths
+} from "./chunk-BIAPE4MR.js";
 import {
   differenceInSeconds
 } from "./chunk-ZHRMURYP.js";
@@ -16,9 +19,6 @@ import {
 import {
   differenceInMinutes
 } from "./chunk-RJY62CDU.js";
-import {
-  differenceInMonths
-} from "./chunk-BIAPE4MR.js";
 import {
   normalizeTemporalInput
 } from "./chunk-MJSZNWCV.js";
@@ -91,4 +91,4 @@ function intlFormatDistance(laterDate, earlierDate, options) {
 export {
   intlFormatDistance
 };
-//# sourceMappingURL=chunk-XEDXPI5G.js.map
+//# sourceMappingURL=chunk-TDQXOSO3.js.map

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-export { toZonedTime } from './toZonedTime';
+export { toZonedTime, type Timezone } from './toZonedTime';
+export { browserTimezone } from './browserTimezone';
 export { toUtc } from './toUtc';
 export { toIso, type IsoMode, type ToIsoOptions } from './toIso';
 export { toIso9075, type ToIso9075Options, type Iso9075Representation, type Iso9075Mode, } from './toIso9075';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,3 +1,6 @@
+import {
+  toIso
+} from "./chunk-BSV32PSO.js";
 import {
   toIso9075
 } from "./chunk-DFLGGK4F.js";
@@ -6,10 +9,13 @@ import {
 } from "./chunk-BW5SFCKS.js";
 import {
   toZonedTime
-} from "./chunk-2MP3ESL7.js";
+} from "./chunk-DCJUK6EE.js";
 import {
   today
 } from "./chunk-67QHALIG.js";
+import {
+  subMinutes
+} from "./chunk-J6G2I2TU.js";
 import {
   subMonths
 } from "./chunk-52NEOY34.js";
@@ -29,8 +35,8 @@ import {
   toDate
 } from "./chunk-TGKWBQ7L.js";
 import {
-  toIso
-} from "./chunk-BSV32PSO.js";
+  startOfDay
+} from "./chunk-TW5EV3DH.js";
 import {
   startOfMonth
 } from "./chunk-TU2UNOOW.js";
@@ -53,8 +59,8 @@ import {
   subMilliseconds
 } from "./chunk-HDBH7RTY.js";
 import {
-  subMinutes
-} from "./chunk-J6G2I2TU.js";
+  isSameMinute
+} from "./chunk-LDO6PRNJ.js";
 import {
   isSameMonth
 } from "./chunk-ADQTZVMH.js";
@@ -77,8 +83,8 @@ import {
   simpleFormat
 } from "./chunk-GQBO2UXH.js";
 import {
-  startOfDay
-} from "./chunk-TW5EV3DH.js";
+  isPast
+} from "./chunk-2H4KLXGL.js";
 import {
   isPlainDateAfter
 } from "./chunk-BPZ7BRJW.js";
@@ -101,8 +107,8 @@ import {
   isSameMillisecond
 } from "./chunk-ISHZRFVN.js";
 import {
-  isSameMinute
-} from "./chunk-LDO6PRNJ.js";
+  endOfYear
+} from "./chunk-XDVUGTUV.js";
 import {
   format
 } from "./chunk-2G5RJGPR.js";
@@ -111,7 +117,7 @@ import {
 } from "./chunk-3A6X6WV5.js";
 import {
   intlFormatDistance
-} from "./chunk-XEDXPI5G.js";
+} from "./chunk-TDQXOSO3.js";
 import {
   isAfter
 } from "./chunk-BBNNR2QH.js";
@@ -122,8 +128,8 @@ import {
   isFuture
 } from "./chunk-R5XN76EV.js";
 import {
-  isPast
-} from "./chunk-2H4KLXGL.js";
+  differenceInMonths
+} from "./chunk-BIAPE4MR.js";
 import {
   differenceInNanoseconds
 } from "./chunk-OABS374T.js";
@@ -145,9 +151,6 @@ import {
 import {
   endOfWeek
 } from "./chunk-XVJJR7H6.js";
-import {
-  endOfYear
-} from "./chunk-XDVUGTUV.js";
 import "./chunk-AVGNRINZ.js";
 import {
   addWeeks
@@ -155,6 +158,9 @@ import {
 import {
   addYears
 } from "./chunk-Q2F3HEXB.js";
+import {
+  browserTimezone
+} from "./chunk-RQUZG65U.js";
 import {
   differenceInDays
 } from "./chunk-6IP245MS.js";
@@ -170,9 +176,6 @@ import {
 import {
   differenceInMinutes
 } from "./chunk-RJY62CDU.js";
-import {
-  differenceInMonths
-} from "./chunk-BIAPE4MR.js";
 import {
   addDays
 } from "./chunk-L4SVABDH.js";
@@ -209,6 +212,7 @@ export {
   addSeconds,
   addWeeks,
   addYears,
+  browserTimezone,
   differenceInDays,
   differenceInHours,
   differenceInMicroseconds,

package/dist/intlFormatDistance.js

@@ -1,13 +1,13 @@
 import {
   intlFormatDistance
-} from "./chunk-XEDXPI5G.js";
+} from "./chunk-TDQXOSO3.js";
+import "./chunk-BIAPE4MR.js";
 import "./chunk-ZHRMURYP.js";
 import "./chunk-PVAOUYXF.js";
 import "./chunk-CHW2EN2O.js";
 import "./chunk-6IP245MS.js";
 import "./chunk-PIDXROVB.js";
 import "./chunk-RJY62CDU.js";
-import "./chunk-BIAPE4MR.js";
 import "./chunk-MJSZNWCV.js";
 export {
   intlFormatDistance

package/dist/toZonedTime.d.ts

@@ -1,29 +1,49 @@
 import { Temporal } from '@js-temporal/polyfill';
+/**
+ * IANA timezone identifier or "UTC".
+ *
+ * Common timezones:
+ * - "UTC" - Coordinated Universal Time
+ * - "America/New_York" - US Eastern
+ * - "America/Los_Angeles" - US Pacific
+ * - "Europe/London" - UK
+ * - "Europe/Paris" - Central European
+ * - "Asia/Tokyo" - Japan
+ * - "Asia/Shanghai" - China
+ */
+export type Timezone = 'UTC' | (string & {});
 /**
  * Convert a UTC ISO string, Date, Instant, or ZonedDateTime to a ZonedDateTime in the specified timezone.
  *
  * @param input - A UTC ISO 8601 string, Date object, Temporal.Instant, or Temporal.ZonedDateTime
- * @param timezone - IANA timezone identifier (e.g., "America/New_York", "Europe/London")
+ * @param timezone - IANA timezone identifier (e.g., "America/New_York", "Europe/London") or "UTC"
  * @returns A Temporal.ZonedDateTime in the specified timezone
  *
  * @example
  * ```typescript
- * // From ISO string
- * const zoned = toZonedTime("2025-01-20T20:00:00.000Z", "America/New_York");
- * // zoned.hour === 15 (3 PM in New York)
+ * import { toZonedTime, browserTimezone } from '@gobrand/tiempo';
+ *
+ * // Server-side: Convert to UTC
+ * const utcTime = toZonedTime("2025-01-20T20:00:00Z", "UTC");
+ *
+ * // Server-side: Convert to user's timezone (from DB/preferences)
+ * const userTime = toZonedTime("2025-01-20T20:00:00Z", user.timezone);
+ *
+ * // Client-side: Convert to browser's timezone
+ * const localTime = toZonedTime("2025-01-20T20:00:00Z", browserTimezone());
  *
  * // From Date (e.g., from Drizzle ORM)
  * const date = new Date("2025-01-20T20:00:00.000Z");
- * const zoned2 = toZonedTime(date, "America/New_York");
+ * const zoned = toZonedTime(date, "America/New_York");
  *
  * // From Instant
  * const instant = Temporal.Instant.from("2025-01-20T20:00:00Z");
- * const zoned3 = toZonedTime(instant, "Asia/Tokyo");
+ * const zoned = toZonedTime(instant, "Asia/Tokyo");
  *
  * // From ZonedDateTime (convert to different timezone)
  * const nyTime = Temporal.ZonedDateTime.from("2025-01-20T15:00:00-05:00[America/New_York]");
  * const tokyoTime = toZonedTime(nyTime, "Asia/Tokyo");
  * ```
  */
-export declare function toZonedTime(input: string | Date | Temporal.Instant | Temporal.ZonedDateTime, timezone: string): Temporal.ZonedDateTime;
+export declare function toZonedTime(input: string | Date | Temporal.Instant | Temporal.ZonedDateTime, timezone: Timezone): Temporal.ZonedDateTime;
 //# sourceMappingURL=toZonedTime.d.ts.map

package/dist/toZonedTime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toZonedTime.d.ts","sourceRoot":"","sources":["../src/toZonedTime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChE,QAAQ,EAAE,MAAM,GACf,QAAQ,CAAC,aAAa,CAcxB"}
+{"version":3,"file":"toZonedTime.d.ts","sourceRoot":"","sources":["../src/toZonedTime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChE,QAAQ,EAAE,QAAQ,GACjB,QAAQ,CAAC,aAAa,CAcxB"}

package/dist/toZonedTime.js

@@ -1,6 +1,6 @@
 import {
   toZonedTime
-} from "./chunk-2MP3ESL7.js";
+} from "./chunk-DCJUK6EE.js";
 export {
   toZonedTime
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gobrand/tiempo",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "description": "Lightweight utility functions for converting between UTC and timezone-aware datetimes using the Temporal API",
   "private": false,
   "publishConfig": {

package/dist/chunk-2MP3ESL7.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/toZonedTime.ts"],"sourcesContent":["import { Temporal } from '@js-temporal/polyfill';\n\n/**\n * Convert a UTC ISO string, Date, Instant, or ZonedDateTime to a ZonedDateTime in the specified timezone.\n *\n * @param input - A UTC ISO 8601 string, Date object, Temporal.Instant, or Temporal.ZonedDateTime\n * @param timezone - IANA timezone identifier (e.g., \"America/New_York\", \"Europe/London\")\n * @returns A Temporal.ZonedDateTime in the specified timezone\n *\n * @example\n * ```typescript\n * // From ISO string\n * const zoned = toZonedTime(\"2025-01-20T20:00:00.000Z\", \"America/New_York\");\n * // zoned.hour === 15 (3 PM in New York)\n *\n * // From Date (e.g., from Drizzle ORM)\n * const date = new Date(\"2025-01-20T20:00:00.000Z\");\n * const zoned2 = toZonedTime(date, \"America/New_York\");\n *\n * // From Instant\n * const instant = Temporal.Instant.from(\"2025-01-20T20:00:00Z\");\n * const zoned3 = toZonedTime(instant, \"Asia/Tokyo\");\n *\n * // From ZonedDateTime (convert to different timezone)\n * const nyTime = Temporal.ZonedDateTime.from(\"2025-01-20T15:00:00-05:00[America/New_York]\");\n * const tokyoTime = toZonedTime(nyTime, \"Asia/Tokyo\");\n * ```\n */\nexport function toZonedTime(\n  input: string | Date | Temporal.Instant | Temporal.ZonedDateTime,\n  timezone: string\n): Temporal.ZonedDateTime {\n  if (typeof input === 'string') {\n    return Temporal.Instant.from(input).toZonedDateTimeISO(timezone);\n  }\n\n  if (input instanceof Date) {\n    return Temporal.Instant.from(input.toISOString()).toZonedDateTimeISO(timezone);\n  }\n\n  if (input instanceof Temporal.Instant) {\n    return input.toZonedDateTimeISO(timezone);\n  }\n\n  return input.toInstant().toZonedDateTimeISO(timezone);\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AA4BlB,SAAS,YACd,OACA,UACwB;AACxB,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,SAAS,QAAQ,KAAK,KAAK,EAAE,mBAAmB,QAAQ;AAAA,EACjE;AAEA,MAAI,iBAAiB,MAAM;AACzB,WAAO,SAAS,QAAQ,KAAK,MAAM,YAAY,CAAC,EAAE,mBAAmB,QAAQ;AAAA,EAC/E;AAEA,MAAI,iBAAiB,SAAS,SAAS;AACrC,WAAO,MAAM,mBAAmB,QAAQ;AAAA,EAC1C;AAEA,SAAO,MAAM,UAAU,EAAE,mBAAmB,QAAQ;AACtD;","names":[]}