@gobrand/tiempo 2.7.0 → 2.8.0

package/dist/{chunk-MXQFENCR.js → chunk-4PSMM55Q.js}

@@ -4,6 +4,9 @@ function toZonedTime(input, timezone) {
   if (typeof input === "string") {
     return Temporal.Instant.from(input).toZonedDateTimeISO(timezone);
   }
+  if (typeof input === "number") {
+    return Temporal.Instant.fromEpochMilliseconds(input).toZonedDateTimeISO(timezone);
+  }
   if (input instanceof Date) {
     return Temporal.Instant.from(input.toISOString()).toZonedDateTimeISO(timezone);
   }
@@ -16,4 +19,4 @@ function toZonedTime(input, timezone) {
 export {
   toZonedTime
 };
-//# sourceMappingURL=chunk-MXQFENCR.js.map
+//# sourceMappingURL=chunk-4PSMM55Q.js.map

package/dist/chunk-4PSMM55Q.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/toZonedTime.ts"],"sourcesContent":["import { Temporal } from '@js-temporal/polyfill';\nimport type { Timezone } from './types';\n\n/**\n * Convert a UTC ISO string, Unix timestamp, Date, Instant, or ZonedDateTime to a ZonedDateTime in the specified timezone.\n *\n * @param input - A UTC ISO 8601 string, Unix timestamp (milliseconds), 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 Unix timestamp (e.g., from database BIGINT or API response)\n * const timestamp = 1737403200000;\n * const zoned = toZonedTime(timestamp, \"America/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 | number | 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 (typeof input === 'number') {\n    return Temporal.Instant.fromEpochMilliseconds(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;AAwClB,SAAS,YACd,OACA,UACwB;AACxB,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,SAAS,QAAQ,KAAK,KAAK,EAAE,mBAAmB,QAAQ;AAAA,EACjE;AAEA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,SAAS,QAAQ,sBAAsB,KAAK,EAAE,mBAAmB,QAAQ;AAAA,EAClF;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-BW5SFCKS.js → chunk-AE36GX4F.js}

@@ -4,6 +4,9 @@ function toUtc(input) {
   if (typeof input === "string") {
     return Temporal.Instant.from(input);
   }
+  if (typeof input === "number") {
+    return Temporal.Instant.fromEpochMilliseconds(input);
+  }
   if (input instanceof Date) {
     return Temporal.Instant.from(input.toISOString());
   }
@@ -13,4 +16,4 @@ function toUtc(input) {
 export {
   toUtc
 };
-//# sourceMappingURL=chunk-BW5SFCKS.js.map
+//# sourceMappingURL=chunk-AE36GX4F.js.map

package/dist/chunk-AE36GX4F.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/toUtc.ts"],"sourcesContent":["import { Temporal } from '@js-temporal/polyfill';\n\n/**\n * Convert a UTC ISO string, Unix timestamp, Date, or ZonedDateTime to a Temporal.Instant (UTC).\n *\n * @param input - A UTC ISO 8601 string, Unix timestamp (milliseconds), Date object, or Temporal.ZonedDateTime\n * @returns A Temporal.Instant representing the same moment in UTC\n *\n * @example\n * ```typescript\n * // From ISO string\n * const instant = toUtc(\"2025-01-20T20:00:00.000Z\");\n *\n * // From Unix timestamp (milliseconds since epoch)\n * const instant2 = toUtc(1737403200000);\n *\n * // From Date (e.g., from Drizzle ORM)\n * const date = new Date(\"2025-01-20T20:00:00.000Z\");\n * const instant3 = toUtc(date);\n *\n * // From ZonedDateTime\n * const zoned = Temporal.ZonedDateTime.from(\"2025-01-20T15:00:00-05:00[America/New_York]\");\n * const instant4 = toUtc(zoned);\n * // All represent the same UTC moment: 2025-01-20T20:00:00Z\n * ```\n */\nexport function toUtc(\n  input: string | number | Date | Temporal.ZonedDateTime\n): Temporal.Instant {\n  if (typeof input === 'string') {\n    return Temporal.Instant.from(input);\n  }\n\n  if (typeof input === 'number') {\n    return Temporal.Instant.fromEpochMilliseconds(input);\n  }\n\n  if (input instanceof Date) {\n    return Temporal.Instant.from(input.toISOString());\n  }\n\n  return input.toInstant();\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AA0BlB,SAAS,MACd,OACkB;AAClB,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,SAAS,QAAQ,KAAK,KAAK;AAAA,EACpC;AAEA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,SAAS,QAAQ,sBAAsB,KAAK;AAAA,EACrD;AAEA,MAAI,iBAAiB,MAAM;AACzB,WAAO,SAAS,QAAQ,KAAK,MAAM,YAAY,CAAC;AAAA,EAClD;AAEA,SAAO,MAAM,UAAU;AACzB;","names":[]}

package/dist/index.js

@@ -3,10 +3,10 @@ import {
 } from "./chunk-UJWM2BV2.js";
 import {
   toUtc
-} from "./chunk-BW5SFCKS.js";
+} from "./chunk-AE36GX4F.js";
 import {
   toZonedTime
-} from "./chunk-MXQFENCR.js";
+} from "./chunk-4PSMM55Q.js";
 import {
   today
 } from "./chunk-KZB6NERH.js";

package/dist/toUtc.d.ts

@@ -1,8 +1,8 @@
 import { Temporal } from '@js-temporal/polyfill';
 /**
- * Convert a UTC ISO string, Date, or ZonedDateTime to a Temporal.Instant (UTC).
+ * Convert a UTC ISO string, Unix timestamp, Date, or ZonedDateTime to a Temporal.Instant (UTC).
  *
- * @param input - A UTC ISO 8601 string, Date object, or Temporal.ZonedDateTime
+ * @param input - A UTC ISO 8601 string, Unix timestamp (milliseconds), Date object, or Temporal.ZonedDateTime
  * @returns A Temporal.Instant representing the same moment in UTC
  *
  * @example
@@ -10,15 +10,18 @@ import { Temporal } from '@js-temporal/polyfill';
  * // From ISO string
  * const instant = toUtc("2025-01-20T20:00:00.000Z");
  *
+ * // From Unix timestamp (milliseconds since epoch)
+ * const instant2 = toUtc(1737403200000);
+ *
  * // From Date (e.g., from Drizzle ORM)
  * const date = new Date("2025-01-20T20:00:00.000Z");
- * const instant2 = toUtc(date);
+ * const instant3 = toUtc(date);
  *
  * // From ZonedDateTime
  * const zoned = Temporal.ZonedDateTime.from("2025-01-20T15:00:00-05:00[America/New_York]");
- * const instant3 = toUtc(zoned);
+ * const instant4 = toUtc(zoned);
  * // All represent the same UTC moment: 2025-01-20T20:00:00Z
  * ```
  */
-export declare function toUtc(input: string | Date | Temporal.ZonedDateTime): Temporal.Instant;
+export declare function toUtc(input: string | number | Date | Temporal.ZonedDateTime): Temporal.Instant;
 //# sourceMappingURL=toUtc.d.ts.map

package/dist/toUtc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toUtc.d.ts","sourceRoot":"","sources":["../src/toUtc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,KAAK,CACnB,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,CAAC,aAAa,GAC5C,QAAQ,CAAC,OAAO,CAUlB"}
+{"version":3,"file":"toUtc.d.ts","sourceRoot":"","sources":["../src/toUtc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,KAAK,CACnB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,QAAQ,CAAC,aAAa,GACrD,QAAQ,CAAC,OAAO,CAclB"}

package/dist/toUtc.js

@@ -1,6 +1,6 @@
 import {
   toUtc
-} from "./chunk-BW5SFCKS.js";
+} from "./chunk-AE36GX4F.js";
 export {
   toUtc
 };

package/dist/toZonedTime.d.ts

@@ -1,9 +1,9 @@
 import { Temporal } from '@js-temporal/polyfill';
 import type { Timezone } from './types';
 /**
- * Convert a UTC ISO string, Date, Instant, or ZonedDateTime to a ZonedDateTime in the specified timezone.
+ * Convert a UTC ISO string, Unix timestamp, 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 input - A UTC ISO 8601 string, Unix timestamp (milliseconds), Date object, Temporal.Instant, or Temporal.ZonedDateTime
  * @param timezone - IANA timezone identifier (e.g., "America/New_York", "Europe/London") or "UTC"
  * @returns A Temporal.ZonedDateTime in the specified timezone
  *
@@ -20,18 +20,22 @@ import type { Timezone } from './types';
  * // Client-side: Convert to browser's timezone
  * const localTime = toZonedTime("2025-01-20T20:00:00Z", browserTimezone());
  *
+ * // From Unix timestamp (e.g., from database BIGINT or API response)
+ * const timestamp = 1737403200000;
+ * const zoned = toZonedTime(timestamp, "America/New_York");
+ *
  * // From Date (e.g., from Drizzle ORM)
  * const date = new Date("2025-01-20T20:00:00.000Z");
- * const zoned = toZonedTime(date, "America/New_York");
+ * const zoned2 = toZonedTime(date, "America/New_York");
  *
  * // From Instant
  * const instant = Temporal.Instant.from("2025-01-20T20:00:00Z");
- * const zoned = toZonedTime(instant, "Asia/Tokyo");
+ * const zoned3 = 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: Timezone): Temporal.ZonedDateTime;
+export declare function toZonedTime(input: string | number | 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;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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"}
+{"version":3,"file":"toZonedTime.d.ts","sourceRoot":"","sources":["../src/toZonedTime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EACzE,QAAQ,EAAE,QAAQ,GACjB,QAAQ,CAAC,aAAa,CAkBxB"}

package/dist/toZonedTime.js

@@ -1,6 +1,6 @@
 import {
   toZonedTime
-} from "./chunk-MXQFENCR.js";
+} from "./chunk-4PSMM55Q.js";
 export {
   toZonedTime
 };

package/package.json

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

package/dist/chunk-BW5SFCKS.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/toUtc.ts"],"sourcesContent":["import { Temporal } from '@js-temporal/polyfill';\n\n/**\n * Convert a UTC ISO string, Date, or ZonedDateTime to a Temporal.Instant (UTC).\n *\n * @param input - A UTC ISO 8601 string, Date object, or Temporal.ZonedDateTime\n * @returns A Temporal.Instant representing the same moment in UTC\n *\n * @example\n * ```typescript\n * // From ISO string\n * const instant = toUtc(\"2025-01-20T20:00:00.000Z\");\n *\n * // From Date (e.g., from Drizzle ORM)\n * const date = new Date(\"2025-01-20T20:00:00.000Z\");\n * const instant2 = toUtc(date);\n *\n * // From ZonedDateTime\n * const zoned = Temporal.ZonedDateTime.from(\"2025-01-20T15:00:00-05:00[America/New_York]\");\n * const instant3 = toUtc(zoned);\n * // All represent the same UTC moment: 2025-01-20T20:00:00Z\n * ```\n */\nexport function toUtc(\n  input: string | Date | Temporal.ZonedDateTime\n): Temporal.Instant {\n  if (typeof input === 'string') {\n    return Temporal.Instant.from(input);\n  }\n\n  if (input instanceof Date) {\n    return Temporal.Instant.from(input.toISOString());\n  }\n\n  return input.toInstant();\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AAuBlB,SAAS,MACd,OACkB;AAClB,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,SAAS,QAAQ,KAAK,KAAK;AAAA,EACpC;AAEA,MAAI,iBAAiB,MAAM;AACzB,WAAO,SAAS,QAAQ,KAAK,MAAM,YAAY,CAAC;AAAA,EAClD;AAEA,SAAO,MAAM,UAAU;AACzB;","names":[]}

package/dist/chunk-MXQFENCR.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/toZonedTime.ts"],"sourcesContent":["import { Temporal } from '@js-temporal/polyfill';\nimport type { Timezone } from './types';\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;AAoClB,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":[]}