@gobrand/tiempo 2.2.3 → 2.3.1

package/dist/subNanoseconds.d.ts

@@ -0,0 +1,19 @@
+import type { Temporal } from '@js-temporal/polyfill';
+/**
+ * Subtracts the specified number of nanoseconds from a datetime.
+ *
+ * This is a convenience wrapper around addNanoseconds with negated value.
+ *
+ * @param input - A Temporal.Instant (UTC) or Temporal.ZonedDateTime
+ * @param nanoseconds - Number of nanoseconds to subtract
+ * @returns ZonedDateTime with nanoseconds subtracted, in the same timezone as input
+ *
+ * @example
+ * ```ts
+ * const instant = Temporal.Instant.from('2025-01-20T12:00:00.000001Z');
+ * const result = subNanoseconds(instant, 500);
+ * // 2025-01-20T12:00:00.000000500Z[UTC] (500 nanoseconds earlier)
+ * ```
+ */
+export declare function subNanoseconds(input: Temporal.Instant | Temporal.ZonedDateTime, nanoseconds: number): Temporal.ZonedDateTime;
+//# sourceMappingURL=subNanoseconds.d.ts.map

package/dist/subNanoseconds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subNanoseconds.d.ts","sourceRoot":"","sources":["../src/subNanoseconds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChD,WAAW,EAAE,MAAM,GAClB,QAAQ,CAAC,aAAa,CAExB"}

package/dist/subNanoseconds.js

@@ -0,0 +1,9 @@
+import {
+  subNanoseconds
+} from "./chunk-WVHAYLBW.js";
+import "./chunk-EYO2ZJLH.js";
+import "./chunk-MJSZNWCV.js";
+export {
+  subNanoseconds
+};
+//# sourceMappingURL=subNanoseconds.js.map

package/dist/subNanoseconds.js.map

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

package/dist/subNanoseconds.test.d.ts

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

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

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

package/dist/subSeconds.d.ts

@@ -0,0 +1,19 @@
+import type { Temporal } from '@js-temporal/polyfill';
+/**
+ * Subtracts the specified number of seconds from a datetime.
+ *
+ * This is a convenience wrapper around addSeconds with negated value.
+ *
+ * @param input - A Temporal.Instant (UTC) or Temporal.ZonedDateTime
+ * @param seconds - Number of seconds to subtract
+ * @returns ZonedDateTime with seconds subtracted, in the same timezone as input
+ *
+ * @example
+ * ```ts
+ * const instant = Temporal.Instant.from('2025-01-20T12:00:45Z');
+ * const result = subSeconds(instant, 30);
+ * // 2025-01-20T12:00:15Z[UTC] (30 seconds earlier)
+ * ```
+ */
+export declare function subSeconds(input: Temporal.Instant | Temporal.ZonedDateTime, seconds: number): Temporal.ZonedDateTime;
+//# sourceMappingURL=subSeconds.d.ts.map

package/dist/subSeconds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subSeconds.d.ts","sourceRoot":"","sources":["../src/subSeconds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChD,OAAO,EAAE,MAAM,GACd,QAAQ,CAAC,aAAa,CAExB"}

package/dist/subSeconds.js

@@ -0,0 +1,9 @@
+import {
+  subSeconds
+} from "./chunk-BH2YB4MV.js";
+import "./chunk-NRD5HRZV.js";
+import "./chunk-MJSZNWCV.js";
+export {
+  subSeconds
+};
+//# sourceMappingURL=subSeconds.js.map

package/dist/subSeconds.js.map

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

package/dist/subSeconds.test.d.ts

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

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

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

package/dist/subWeeks.d.ts

@@ -0,0 +1,20 @@
+import type { Temporal } from '@js-temporal/polyfill';
+/**
+ * Subtracts the specified number of weeks from a datetime.
+ *
+ * This is a convenience wrapper around addWeeks with negated value.
+ * Properly handles DST transitions and calendar edge cases through Temporal API.
+ *
+ * @param input - A Temporal.Instant (UTC) or Temporal.ZonedDateTime
+ * @param weeks - Number of weeks to subtract
+ * @returns ZonedDateTime with weeks subtracted, in the same timezone as input
+ *
+ * @example
+ * ```ts
+ * const instant = Temporal.Instant.from('2025-02-03T12:00:00Z');
+ * const result = subWeeks(instant, 2);
+ * // 2025-01-20T12:00:00Z[UTC] (2 weeks earlier)
+ * ```
+ */
+export declare function subWeeks(input: Temporal.Instant | Temporal.ZonedDateTime, weeks: number): Temporal.ZonedDateTime;
+//# sourceMappingURL=subWeeks.d.ts.map

package/dist/subWeeks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subWeeks.d.ts","sourceRoot":"","sources":["../src/subWeeks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChD,KAAK,EAAE,MAAM,GACZ,QAAQ,CAAC,aAAa,CAExB"}

package/dist/subWeeks.js

@@ -0,0 +1,9 @@
+import {
+  subWeeks
+} from "./chunk-U4RNUZXO.js";
+import "./chunk-DT2EWLHU.js";
+import "./chunk-MJSZNWCV.js";
+export {
+  subWeeks
+};
+//# sourceMappingURL=subWeeks.js.map

package/dist/subWeeks.js.map

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

package/dist/subWeeks.test.d.ts

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

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

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

package/dist/subYears.d.ts

@@ -0,0 +1,20 @@
+import type { Temporal } from '@js-temporal/polyfill';
+/**
+ * Subtracts the specified number of years from a datetime.
+ *
+ * This is a convenience wrapper around addYears with negated value.
+ * Properly handles leap years and calendar edge cases through Temporal API.
+ *
+ * @param input - A Temporal.Instant (UTC) or Temporal.ZonedDateTime
+ * @param years - Number of years to subtract
+ * @returns ZonedDateTime with years subtracted, in the same timezone as input
+ *
+ * @example
+ * ```ts
+ * const instant = Temporal.Instant.from('2025-01-20T12:00:00Z');
+ * const result = subYears(instant, 2);
+ * // 2023-01-20T12:00:00Z[UTC] (2 years earlier)
+ * ```
+ */
+export declare function subYears(input: Temporal.Instant | Temporal.ZonedDateTime, years: number): Temporal.ZonedDateTime;
+//# sourceMappingURL=subYears.d.ts.map

package/dist/subYears.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subYears.d.ts","sourceRoot":"","sources":["../src/subYears.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChD,KAAK,EAAE,MAAM,GACZ,QAAQ,CAAC,aAAa,CAExB"}

package/dist/subYears.js

@@ -0,0 +1,9 @@
+import {
+  subYears
+} from "./chunk-AHMKY474.js";
+import "./chunk-Q2F3HEXB.js";
+import "./chunk-MJSZNWCV.js";
+export {
+  subYears
+};
+//# sourceMappingURL=subYears.js.map

package/dist/subYears.js.map

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

package/dist/subYears.test.d.ts

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

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

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

package/dist/toDate.d.ts

@@ -0,0 +1,27 @@
+import { Temporal } from '@js-temporal/polyfill';
+/**
+ * Convert a Temporal.Instant or ZonedDateTime to a Date object.
+ *
+ * @param input - A Temporal.Instant or Temporal.ZonedDateTime
+ * @returns A Date object representing the same moment in time
+ *
+ * @example
+ * ```typescript
+ * // From Instant
+ * const instant = Temporal.Instant.from("2025-01-20T20:00:00Z");
+ * const date = toDate(instant);
+ * // date.toISOString() === "2025-01-20T20:00:00.000Z"
+ *
+ * // From ZonedDateTime
+ * const zoned = Temporal.ZonedDateTime.from("2025-01-20T15:00:00-05:00[America/New_York]");
+ * const date2 = toDate(zoned);
+ * // date2.toISOString() === "2025-01-20T20:00:00.000Z"
+ *
+ * // Use with Drizzle ORM (for storing back to database)
+ * const instant = Temporal.Instant.from("2025-01-20T20:00:00Z");
+ * const date = toDate(instant);
+ * await db.update(posts).set({ publishedAt: date });
+ * ```
+ */
+export declare function toDate(input: Temporal.Instant | Temporal.ZonedDateTime): Date;
+//# sourceMappingURL=toDate.d.ts.map

package/dist/toDate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toDate.d.ts","sourceRoot":"","sources":["../src/toDate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,MAAM,CACpB,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,GAC/C,IAAI,CAMN"}

package/dist/toDate.js

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

package/dist/toDate.js.map

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

package/dist/toDate.test.d.ts

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

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

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

package/dist/toUtc.d.ts

@@ -1,8 +1,8 @@
 import { Temporal } from '@js-temporal/polyfill';
 /**
- * Convert a UTC ISO string or ZonedDateTime to a Temporal.Instant (UTC).
+ * Convert a UTC ISO string, Date, or ZonedDateTime to a Temporal.Instant (UTC).
  *
- * @param input - A UTC ISO 8601 string or Temporal.ZonedDateTime
+ * @param input - A UTC ISO 8601 string, Date object, or Temporal.ZonedDateTime
  * @returns A Temporal.Instant representing the same moment in UTC
  *
  * @example
@@ -10,11 +10,15 @@ import { Temporal } from '@js-temporal/polyfill';
  * // From ISO string
  * const instant = toUtc("2025-01-20T20:00:00.000Z");
  *
+ * // From Date (e.g., from Drizzle ORM)
+ * const date = new Date("2025-01-20T20:00:00.000Z");
+ * const instant2 = toUtc(date);
+ *
  * // From ZonedDateTime
  * const zoned = Temporal.ZonedDateTime.from("2025-01-20T15:00:00-05:00[America/New_York]");
- * const instant2 = toUtc(zoned);
- * // Both represent the same UTC moment: 2025-01-20T20:00:00Z
+ * const instant3 = toUtc(zoned);
+ * // All represent the same UTC moment: 2025-01-20T20:00:00Z
  * ```
  */
-export declare function toUtc(input: string | Temporal.ZonedDateTime): Temporal.Instant;
+export declare function toUtc(input: string | 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;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,KAAK,CACnB,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC,aAAa,GACrC,QAAQ,CAAC,OAAO,CAMlB"}
+{"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"}

package/dist/toUtc.js

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

package/dist/toZonedTime.d.ts

@@ -1,8 +1,8 @@
 import { Temporal } from '@js-temporal/polyfill';
 /**
- * Convert a UTC ISO string, Instant, or ZonedDateTime to a ZonedDateTime in the specified timezone.
+ * Convert a UTC ISO string, Date, Instant, or ZonedDateTime to a ZonedDateTime in the specified timezone.
  *
- * @param input - A UTC ISO 8601 string, Temporal.Instant, or Temporal.ZonedDateTime
+ * @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")
  * @returns A Temporal.ZonedDateTime in the specified timezone
  *
@@ -12,14 +12,18 @@ import { Temporal } from '@js-temporal/polyfill';
  * const zoned = toZonedTime("2025-01-20T20:00:00.000Z", "America/New_York");
  * // zoned.hour === 15 (3 PM in New York)
  *
+ * // From Date (e.g., from Drizzle ORM)
+ * const date = new Date("2025-01-20T20:00:00.000Z");
+ * const zoned2 = toZonedTime(date, "America/New_York");
+ *
  * // From Instant
  * const instant = Temporal.Instant.from("2025-01-20T20:00:00Z");
- * const zoned2 = 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 | Temporal.Instant | Temporal.ZonedDateTime, timezone: string): Temporal.ZonedDateTime;
+export declare function toZonedTime(input: string | Date | Temporal.Instant | Temporal.ZonedDateTime, timezone: string): 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;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EACzD,QAAQ,EAAE,MAAM,GACf,QAAQ,CAAC,aAAa,CAUxB"}
+{"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"}

package/dist/toZonedTime.js

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

package/package.json

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

package/dist/chunk-GPAFAHKJ.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 or ZonedDateTime to a Temporal.Instant (UTC).\n *\n * @param input - A UTC ISO 8601 string 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 ZonedDateTime\n * const zoned = Temporal.ZonedDateTime.from(\"2025-01-20T15:00:00-05:00[America/New_York]\");\n * const instant2 = toUtc(zoned);\n * // Both represent the same UTC moment: 2025-01-20T20:00:00Z\n * ```\n */\nexport function toUtc(\n  input: string | Temporal.ZonedDateTime\n): Temporal.Instant {\n  if (typeof input === 'string') {\n    return Temporal.Instant.from(input);\n  }\n\n  return input.toInstant();\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AAmBlB,SAAS,MACd,OACkB;AAClB,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,SAAS,QAAQ,KAAK,KAAK;AAAA,EACpC;AAEA,SAAO,MAAM,UAAU;AACzB;","names":[]}

package/dist/chunk-KD5GEHUA.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, Instant, or ZonedDateTime to a ZonedDateTime in the specified timezone.\n *\n * @param input - A UTC ISO 8601 string, 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 Instant\n * const instant = Temporal.Instant.from(\"2025-01-20T20:00:00Z\");\n * const zoned2 = 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 | 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 Temporal.Instant) {\n    return input.toZonedDateTimeISO(timezone);\n  }\n\n  return input.toInstant().toZonedDateTimeISO(timezone);\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AAwBlB,SAAS,YACd,OACA,UACwB;AACxB,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,SAAS,QAAQ,KAAK,KAAK,EAAE,mBAAmB,QAAQ;AAAA,EACjE;AAEA,MAAI,iBAAiB,SAAS,SAAS;AACrC,WAAO,MAAM,mBAAmB,QAAQ;AAAA,EAC1C;AAEA,SAAO,MAAM,UAAU,EAAE,mBAAmB,QAAQ;AACtD;","names":[]}