@angelrove/forecast-utils 1.1.3 → 1.1.5

package/README.md

@@ -1,8 +1,6 @@
 ## Modules
 
 <dl>
-<dt><a href="#module_Astronomy">Astronomy</a></dt>
-<dd></dd>
 <dt><a href="#module_Astronomy/MoonCalc">Astronomy/MoonCalc</a></dt>
 <dd><p>MoonCalc for calculating moon times, positions, and phases.</p>
 <p>  import { MoonCalc } from ...</p>
@@ -16,6 +14,8 @@
 ¡Solo proporcionar HORA LOCAL DEL SISTEMA!: &#39;new Date()&#39;
 Con excepción de &#39;getSolarTime()&#39;: recibe la hora local correspondiente a la localización dada.</p>
 </dd>
+<dt><a href="#module_Astronomy/helpers">Astronomy/helpers</a></dt>
+<dd></dd>
 <dt><a href="#module_Geolocation">Geolocation</a></dt>
 <dd></dd>
 <dt><a href="#module_OpenMeteo">OpenMeteo</a></dt>
@@ -24,137 +24,6 @@ Con excepción de &#39;getSolarTime()&#39;: recibe la hora local correspondiente
 <dd></dd>
 </dl>
 
-<a name="module_Astronomy"></a>
-
-## Astronomy
-
-* [Astronomy](#module_Astronomy)
-    * [.exports.timeString([date], [sec])](#module_Astronomy.exports.timeString) ⇒ <code>string</code>
-    * [.exports.nowString(sec)](#module_Astronomy.exports.nowString) ⇒ <code>String</code>
-    * [.exports.dateFormat([date])](#module_Astronomy.exports.dateFormat) ⇒ <code>string</code>
-    * [.exports.getLocalTimeFromTz(timeZone, [date])](#module_Astronomy.exports.getLocalTimeFromTz) ⇒ <code>string</code>
-    * [.exports.getLocalTimeInfo(apiKey, lat, lng)](#module_Astronomy.exports.getLocalTimeInfo) ⇒ <code>Promise.&lt;(any\|LocalTimeData)&gt;</code>
-    * [.AstroPosition](#module_Astronomy.AstroPosition) : <code>Object</code>
-    * [.LocalTimeData](#module_Astronomy.LocalTimeData) : <code>Object</code>
-
-
-* * *
-
-<a name="module_Astronomy.exports.timeString"></a>
-
-### Astronomy.exports.timeString([date], [sec]) ⇒ <code>string</code>
-Formatea una fecha a un string legible.
-
-**Kind**: static method of [<code>Astronomy</code>](#module_Astronomy)  
-**Returns**: <code>string</code> - La fecha formateada.  
-
-| Param | Type | Default |
-| --- | --- | --- |
-| [date] | <code>Date</code> |  | 
-| [sec] | <code>boolean</code> | <code>false</code> | 
-
-
-* * *
-
-<a name="module_Astronomy.exports.nowString"></a>
-
-### Astronomy.exports.nowString(sec) ⇒ <code>String</code>
-**Kind**: static method of [<code>Astronomy</code>](#module_Astronomy)  
-
-| Param | Type |
-| --- | --- |
-| sec | <code>boolean</code> | 
-
-
-* * *
-
-<a name="module_Astronomy.exports.dateFormat"></a>
-
-### Astronomy.exports.dateFormat([date]) ⇒ <code>string</code>
-Formatea una fecha a un string legible.
-
-**Kind**: static method of [<code>Astronomy</code>](#module_Astronomy)  
-**Returns**: <code>string</code> - La fecha formateada.  
-
-| Param | Type | Default | Description |
-| --- | --- | --- | --- |
-| [date] | <code>Date</code> | <code>new Date()</code> | La fecha a formatear. |
-
-
-* * *
-
-<a name="module_Astronomy.exports.getLocalTimeFromTz"></a>
-
-### Astronomy.exports.getLocalTimeFromTz(timeZone, [date]) ⇒ <code>string</code>
-Get local time from timezone
-
-**Kind**: static method of [<code>Astronomy</code>](#module_Astronomy)  
-**Returns**: <code>string</code> - - The formatted local time string.  
-
-| Param | Type | Default | Description |
-| --- | --- | --- | --- |
-| timeZone | <code>string</code> |  | The timezone string (e.g., 'America/New_York'). |
-| [date] | <code>Date</code> \| <code>number</code> | <code>new Date()</code> | The date object to format. Defaults to the current date. |
-
-
-* * *
-
-<a name="module_Astronomy.exports.getLocalTimeInfo"></a>
-
-### Astronomy.exports.getLocalTimeInfo(apiKey, lat, lng) ⇒ <code>Promise.&lt;(any\|LocalTimeData)&gt;</code>
-Get local time from any location using Google Maps TimeZone API.
-
-**Kind**: static method of [<code>Astronomy</code>](#module_Astronomy)  
-**Returns**: <code>Promise.&lt;(any\|LocalTimeData)&gt;</code> - - An object containing the local time and timezone information:  
-**Throws**:
-
-- <code>Error</code> - If the API request fails or returns an error status.
-
-
-| Param | Type | Description |
-| --- | --- | --- |
-| apiKey | <code>string</code> | GoogleMaps API key. |
-| lat | <code>number</code> |  |
-| lng | <code>number</code> |  |
-
-
-* * *
-
-<a name="module_Astronomy.AstroPosition"></a>
-
-### Astronomy.AstroPosition : <code>Object</code>
-**Kind**: static typedef of [<code>Astronomy</code>](#module_Astronomy)  
-**Properties**
-
-| Name | Type |
-| --- | --- |
-| altitude | <code>number</code> | 
-| azimuth | <code>number</code> | 
-| direction | <code>string</code> | 
-| direction_full | <code>string</code> | 
-
-
-* * *
-
-<a name="module_Astronomy.LocalTimeData"></a>
-
-### Astronomy.LocalTimeData : <code>Object</code>
-**Kind**: static typedef of [<code>Astronomy</code>](#module_Astronomy)  
-**Properties**
-
-| Name | Type | Description |
-| --- | --- | --- |
-| time | <code>Date</code> | The local time. |
-| timeStr | <code>string</code> | The formatted local time string. |
-| timezone | <code>string</code> | The timezone name. |
-| timezoneId | <code>string</code> | The timezone ID. |
-| offset | <code>number</code> | The UTC offset in hours. |
-| offsetSign | <code>string</code> | The sign of the offset ('+' or '-'). |
-| dstOffset | <code>number</code> | The DST offset in hours. |
-
-
-* * *
-
 <a name="module_Astronomy/MoonCalc"></a>
 
 ## Astronomy/MoonCalc
@@ -392,6 +261,100 @@ Con excepción de 'getSolarTime()': recibe la hora local correspondiente a la lo
 | noon | <code>string</code> | 
 
 
+* * *
+
+<a name="module_Astronomy/helpers"></a>
+
+## Astronomy/helpers
+
+* [Astronomy/helpers](#module_Astronomy/helpers)
+    * [.exports.timeString([date], [sec])](#module_Astronomy/helpers.exports.timeString) ⇒ <code>string</code>
+    * [.exports.nowString(sec)](#module_Astronomy/helpers.exports.nowString) ⇒ <code>String</code>
+    * [.exports.dateFormat([date])](#module_Astronomy/helpers.exports.dateFormat) ⇒ <code>string</code>
+    * [.exports.getLocalTimeFromTz(timeZone, [date])](#module_Astronomy/helpers.exports.getLocalTimeFromTz) ⇒ <code>string</code>
+    * [.exports.getLocalTimeInfo(apiKey, lat, lng)](#module_Astronomy/helpers.exports.getLocalTimeInfo) ⇒ <code>Promise.&lt;(any\|LocalTimeData)&gt;</code>
+
+
+* * *
+
+<a name="module_Astronomy/helpers.exports.timeString"></a>
+
+### Astronomy/helpers.exports.timeString([date], [sec]) ⇒ <code>string</code>
+Formatea una fecha a un string legible.
+
+**Kind**: static method of [<code>Astronomy/helpers</code>](#module_Astronomy/helpers)  
+**Returns**: <code>string</code> - La fecha formateada.  
+
+| Param | Type | Default |
+| --- | --- | --- |
+| [date] | <code>Date</code> |  | 
+| [sec] | <code>boolean</code> | <code>false</code> | 
+
+
+* * *
+
+<a name="module_Astronomy/helpers.exports.nowString"></a>
+
+### Astronomy/helpers.exports.nowString(sec) ⇒ <code>String</code>
+**Kind**: static method of [<code>Astronomy/helpers</code>](#module_Astronomy/helpers)  
+
+| Param | Type |
+| --- | --- |
+| sec | <code>boolean</code> | 
+
+
+* * *
+
+<a name="module_Astronomy/helpers.exports.dateFormat"></a>
+
+### Astronomy/helpers.exports.dateFormat([date]) ⇒ <code>string</code>
+Formatea una fecha a un string legible.
+
+**Kind**: static method of [<code>Astronomy/helpers</code>](#module_Astronomy/helpers)  
+**Returns**: <code>string</code> - La fecha formateada.  
+
+| Param | Type | Default | Description |
+| --- | --- | --- | --- |
+| [date] | <code>Date</code> | <code>new Date()</code> | La fecha a formatear. |
+
+
+* * *
+
+<a name="module_Astronomy/helpers.exports.getLocalTimeFromTz"></a>
+
+### Astronomy/helpers.exports.getLocalTimeFromTz(timeZone, [date]) ⇒ <code>string</code>
+Get local time from timezone
+
+**Kind**: static method of [<code>Astronomy/helpers</code>](#module_Astronomy/helpers)  
+**Returns**: <code>string</code> - - The formatted local time string.  
+
+| Param | Type | Default | Description |
+| --- | --- | --- | --- |
+| timeZone | <code>string</code> |  | The timezone string (e.g., 'America/New_York'). |
+| [date] | <code>Date</code> \| <code>number</code> | <code>new Date()</code> | The date object to format. Defaults to the current date. |
+
+
+* * *
+
+<a name="module_Astronomy/helpers.exports.getLocalTimeInfo"></a>
+
+### Astronomy/helpers.exports.getLocalTimeInfo(apiKey, lat, lng) ⇒ <code>Promise.&lt;(any\|LocalTimeData)&gt;</code>
+Get local time from any location using Google Maps TimeZone API.
+
+**Kind**: static method of [<code>Astronomy/helpers</code>](#module_Astronomy/helpers)  
+**Returns**: <code>Promise.&lt;(any\|LocalTimeData)&gt;</code> - - An object containing the local time and timezone information:  
+**Throws**:
+
+- <code>Error</code> - If the API request fails or returns an error status.
+
+
+| Param | Type | Description |
+| --- | --- | --- |
+| apiKey | <code>string</code> | GoogleMaps API key. |
+| lat | <code>number</code> |  |
+| lng | <code>number</code> |  |
+
+
 * * *
 
 <a name="module_Geolocation"></a>

package/dist/types/astronomy/index.d.ts

@@ -1,4 +1,2 @@
 export { default as MoonCalc } from "./moon/MoonCalc.js";
 export { default as SunCalc } from "./sun/SunCalc.js";
-export { getLocalTimeInfo as getLocalTime } from "./timeZoneInfo.js";
-export { dateFormat, getLocalTimeFromTz, nowString, timeString } from "./timehelpers.js";

package/dist/types/geolocation/index.d.ts

@@ -1 +1,2 @@
 export { getGeolocation } from "./getGeolocation.js";
+export { timeFromLocation } from "./timeFromLocation.js";

package/dist/types/{astronomy/timeZoneInfo.d.ts → geolocation/timeFromLocation.d.ts}

@@ -1,11 +1,11 @@
 /**
- * Get local time from any location using Google Maps TimeZone API.
+ * Get local time from a given location (lat, lng) using 'GoogleMaps TimeZone' API.
  *
  * @param {string} apiKey - GoogleMaps API key.
  * @param {number} lat
  * @param {number} lng
  * @returns {Promise<any | LocalTimeData>} - An object containing the local time and timezone information:
  * @throws {Error} - If the API request fails or returns an error status.
- * @memberof module:Astronomy
+ * @memberof module:Geolocation
  */
-export function getLocalTimeInfo(apiKey: string, lat: number, lng: number): Promise<any | LocalTimeData>;
+export function timeFromLocation(apiKey: string, lat: number, lng: number): Promise<any | LocalTimeData>;

package/dist/types/index.d.ts

@@ -1,6 +1,7 @@
 export { default as MoonCalc } from "./astronomy/moon/MoonCalc.js";
 export { default as SunCalc } from "./astronomy/sun/SunCalc.js";
-export { getLocalTimeInfo as getLocalTime } from "./astronomy/timeZoneInfo.js";
+export { timeFromLocation } from "./geolocation/timeFromLocation.js";
+export { default as TimeDateStr } from "./utils/timehelpers.js";
 export { getGeolocation } from "./geolocation/getGeolocation.js";
 export { useForecastCurrent } from "./OpenMeteo/current/useForecastCurrent.js";
 export { useForecastDaily } from "./OpenMeteo/daily/useForecastDaily.js";
@@ -10,5 +11,4 @@ export { degreesToCompass } from "./utils/degreesToCompass.js";
 export { WindArrow } from "./utils/wind/WindArrow.jsx";
 export { windArrowTx } from "./utils/wind/windArrowTx.js";
 export { getWindLevel } from "./utils/wind/windLevel.js";
-export { dateFormat, getLocalTimeFromTz, nowString, timeString } from "./astronomy/timehelpers.js";
 export { getWarning, getWarningByDays } from "./utils/warning.js";

package/dist/types/utils/index.d.ts

@@ -1,4 +1,5 @@
 export { degreesToCompass } from "./degreesToCompass.js";
+export { default as TimeDateStr } from "./timehelpers.js";
 export { WindArrow } from "./wind/WindArrow.jsx";
 export { windArrowTx } from "./wind/windArrowTx.js";
 export { getWindLevel } from "./wind/windLevel.js";

package/dist/types/utils/timehelpers.d.ts

@@ -0,0 +1,41 @@
+export default TimeDateStr;
+declare namespace TimeDateStr {
+    export { dateFormat };
+    export { nowString };
+    export { timeString };
+    export { getLocalTimeFromTz };
+}
+/**
+ * Returns a date as a formated string.
+ *
+ * @param {Date} [date=new Date()] La fecha a formatear.
+ * @returns {string} La fecha formateada.
+ * @memberof module:Utils
+ */
+declare function dateFormat(date?: Date | undefined): string;
+/**
+ * Returns a now time as a formated string.
+ *
+ * @param {boolean} sec
+ * @returns {String}
+ * @memberof module:Utils
+ */
+declare function nowString(sec?: boolean): string;
+/**
+ * Returns a time as a formated string.
+ *
+ * @param {Date} [date]
+ * @param {boolean} [sec=false]
+ * @returns {string} La fecha formateada.
+ * @memberof module:Utils
+ */
+declare function timeString(date?: Date | undefined, sec?: boolean | undefined): string;
+/**
+ * Return the local time string from a given timezone.
+ *
+ * @param {string} timeZone - The timezone string (e.g., 'America/New_York').
+ * @param {Date | number} [date=new Date()] - The date object to format. Defaults to the current date.
+ * @returns {string} - The formatted local time string.
+ * @memberof module:Utils
+ */
+declare function getLocalTimeFromTz(timeZone: string, date?: number | Date | undefined): string;

package/package.json

@@ -1,9 +1,12 @@
 {
-  "name": "@angelrove/forecast-utils",
-  "version": "1.1.3",
   "author": "Jose Angel Romero Vegas",
-  "license": "MIT",
+  "name": "@angelrove/forecast-utils",
+  "version": "1.1.5",
   "description": "Utilities for obtaining weather and astronomy forecast data.",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
   "homepage": "https://github.com/angelrove/forecast-utils",
   "type": "module",
   "scripts": {
@@ -12,8 +15,7 @@
   "types": "dist/types/index.d.ts",
   "exports": {
     ".": {
-      "import": "./src/index.js",
-      "require": "./src/index.js"
+      "import": "./src/index.js"
     }
   },
   "files": [

package/src/astronomy/index.js

@@ -1,13 +1,2 @@
-/**
- * @module Astronomy
- */
-
 export { default as MoonCalc } from "./moon/MoonCalc.js";
 export { default as SunCalc } from "./sun/SunCalc.js";
-export {
-  dateFormat,
-  getLocalTimeFromTz,
-  nowString,
-  timeString,
-} from "./timehelpers.js";
-export { getLocalTimeInfo as getLocalTime } from "./timeZoneInfo.js";

package/src/astronomy/moon/MoonCalc.js

@@ -12,7 +12,7 @@
 
 // @ts-ignore
 import SunCalc from "suncalc3";
-import { dateFormat, getLocalTimeFromTz, timeString } from "../timehelpers.js";
+import TimeDateStr from "../../utils/timehelpers.js";
 import { parseBasicData } from "./parseBasicData.js";
 
 /**
@@ -25,7 +25,7 @@ import { parseBasicData } from "./parseBasicData.js";
  */
 
 /**
- * Export
+ * MoonCalc.
  * @ignore
  */
 const MoonCalc = {
@@ -105,8 +105,8 @@ function dataExt(latitude, longitude, date = new Date(), language = "es-ES") {
 
   // Return ---
   return {
-    date: dateFormat(date),
-    time: timeString(date),
+    date: TimeDateStr.dateFormat(date),
+    time: TimeDateStr.timeString(date),
     illumination: illumination,
     phase: phase,
     phaseId: phaseId,
@@ -160,9 +160,9 @@ function times(latitude, longitude, timezoneId, date = new Date()) {
     return ret;
   }
 
-  ret.rise = getLocalTimeFromTz(timezoneId, times.rise);
-  ret.set = getLocalTimeFromTz(timezoneId, times.set);
-  ret.highest = getLocalTimeFromTz(timezoneId, times.highest);
+  ret.rise = TimeDateStr.getLocalTimeFromTz(timezoneId, times.rise);
+  ret.set = TimeDateStr.getLocalTimeFromTz(timezoneId, times.set);
+  ret.highest = TimeDateStr.getLocalTimeFromTz(timezoneId, times.highest);
   return ret;
 }
 //--------------------------------------------------------------------

package/src/astronomy/moon/parseBasicData.js

@@ -1,6 +1,6 @@
 // @ts-nocheck
 import { degreesToCompass } from "../../utils/degreesToCompass.js";
-import { dateFormat } from "../timehelpers.js";
+import TimeDateStr from "../../utils/timehelpers.js";
 
 /**
  * Parse basic data from SunCalc
@@ -17,10 +17,10 @@ export function parseBasicData(data, language) {
   const direction = degreesToCompass(data.azimuthDegrees, language);
 
   // Next moon ---
-  const nextNewMoon = dateFormat(
+  const nextNewMoon = TimeDateStr.dateFormat(
     new Date(data.illumination.next.newMoon.value),
   );
-  const nextFullMoon = dateFormat(
+  const nextFullMoon = TimeDateStr.dateFormat(
     new Date(data.illumination.next.fullMoon.value),
   );
 

package/src/astronomy/sun/SunCalc.js

@@ -13,15 +13,10 @@
 // @ts-ignore
 import { default as SunCalc3 } from "suncalc3";
 import { degreesToCompass } from "../../utils/degreesToCompass.js";
-import {
-  dateFormat,
-  getLocalTimeFromTz,
-  nowString,
-  timeString,
-} from "../timehelpers.js";
+import TimeDateStr from "../../utils/timehelpers.js";
 
 /**
- * Export
+ * SunCalc.
  * @ignore
  */
 const SunCalc = {
@@ -69,11 +64,14 @@ function times(date, latitude, longitude, timezoneId) {
 
   const sunTimes = {
     date: date,
-    sunrise: getLocalTimeFromTz(timezoneId, times.sunriseStart.value),
-    sunset: getLocalTimeFromTz(timezoneId, times.sunsetStart.value),
-    noon: getLocalTimeFromTz(timezoneId, times.solarNoon.value),
-    dawn: getLocalTimeFromTz(timezoneId, times.civilDawn.value),
-    dusk: getLocalTimeFromTz(timezoneId, times.civilDusk.value),
+    sunrise: TimeDateStr.getLocalTimeFromTz(
+      timezoneId,
+      times.sunriseStart.value,
+    ),
+    sunset: TimeDateStr.getLocalTimeFromTz(timezoneId, times.sunsetStart.value),
+    noon: TimeDateStr.getLocalTimeFromTz(timezoneId, times.solarNoon.value),
+    dawn: TimeDateStr.getLocalTimeFromTz(timezoneId, times.civilDawn.value),
+    dusk: TimeDateStr.getLocalTimeFromTz(timezoneId, times.civilDusk.value),
   };
 
   // console.log(sunTimes);
@@ -92,7 +90,7 @@ function getSolarTime(date, lng, offsetSign, offset) {
   // Convert offsetSign and offset to a numeric UTC offset (e.g., -3, +2)
   const utcOffset = (offsetSign === "-" ? -1 : 1) * Math.abs(Number(offset));
   const solarTime = SunCalc3.getSolarTime(date, lng, utcOffset);
-  return timeString(solarTime);
+  return TimeDateStr.timeString(solarTime);
 }
 //-------------------------------------------------------
 /**
@@ -108,7 +106,7 @@ function position(latitude, longitude, date = new Date(), language = "es-ES") {
   const direction = degreesToCompass(position.azimuthDegrees, language);
 
   return {
-    date: dateFormat(date),
+    date: TimeDateStr.dateFormat(date),
     azimuth: position.azimuthDegrees,
     direction: direction.short,
     direction_full: direction.full,
@@ -134,8 +132,11 @@ function getIsNight(lat, lon, timezoneId, date, dateStr) {
 
   // se pueden comparar horas(hh:mm) estando en formato texto
   // y así no tenemos que tener en cuenta el día, mes.
-  const timeUp = getLocalTimeFromTz(timezoneId, times.sunriseEnd.value);
-  const timeDown = getLocalTimeFromTz(
+  const timeUp = TimeDateStr.getLocalTimeFromTz(
+    timezoneId,
+    times.sunriseEnd.value,
+  );
+  const timeDown = TimeDateStr.getLocalTimeFromTz(
     timezoneId,
     times.goldenHourDuskStart.value,
   );
@@ -150,7 +151,7 @@ function getIsNight(lat, lon, timezoneId, date, dateStr) {
  * @memberof module:Astronomy/SunCalc
  */
 function getPhase(altitude, noon) {
-  const nowTime = nowString();
+  const nowTime = TimeDateStr.nowString();
 
   let phase = "day";
   if (altitude < 4) {

package/src/geolocation/getGeolocation.js

@@ -1,7 +1,3 @@
-/**
- * Get the current geolocation of the device and reverse geocode it to get the address.
- */
-
 import geolocationCapacitor from "./lib/geolocation.js";
 import reverseGeocoding from "./lib/reversegeocoding.js";
 

package/src/geolocation/index.js

@@ -3,3 +3,4 @@
  */
 
 export { getGeolocation } from "./getGeolocation.js";
+export { timeFromLocation } from "./timeFromLocation.js";

package/src/geolocation/lib/geolocation.js

@@ -30,12 +30,16 @@ export default async function geolocation() {
     };
   } catch (error) {
     console.error(error);
+
+    // @ts-ignore
     if (error.code === error.PERMISSION_DENIED) {
       throw new Error("Geolocation: permission denied");
     }
+    // @ts-ignore
     if (error.code === error.POSITION_UNAVAILABLE) {
       throw new Error("Geolocation: position unavailable");
     }
+    // @ts-ignore
     if (error.code === error.TIMEOUT) {
       throw new Error("Geolocation: timeout");
     }

package/src/{astronomy/timeZoneInfo.js → geolocation/timeFromLocation.js}

@@ -1,24 +1,18 @@
 // @ts-nocheck
-/**
- * Get local time from any location using Google Maps TimeZone API.
- * - import { getLocalTimeInfo } from '@angelrov/forecast';
- *
- */
-
-import { timeString } from "./timehelpers.js";
+import TimeDateStr from "../utils/timehelpers.js";
 
 //------------------------------------------------------
 /**
- * Get local time from any location using Google Maps TimeZone API.
+ * Get local time from a given location (lat, lng) using 'GoogleMaps TimeZone' API.
  *
  * @param {string} apiKey - GoogleMaps API key.
  * @param {number} lat
  * @param {number} lng
  * @returns {Promise<any | LocalTimeData>} - An object containing the local time and timezone information:
  * @throws {Error} - If the API request fails or returns an error status.
- * @memberof module:Astronomy
+ * @memberof module:Geolocation
  */
-export async function getLocalTimeInfo(apiKey, lat, lng) {
+export async function timeFromLocation(apiKey, lat, lng) {
   const timestamp = Math.floor(Date.now() / 1000);
   const url =
     "https://maps.googleapis.com/maps/api/timezone/json?" +
@@ -45,6 +39,8 @@ export async function getLocalTimeInfo(apiKey, lat, lng) {
     });
 }
 //------------------------------------------------------
+// Private
+//------------------------------------------------------
 /**
  * @private
  * @param {Object} timezoneInfo - The timezone Google API information.
@@ -64,7 +60,7 @@ function getLocalTimeData(timezoneInfo) {
 
   return {
     time: time,
-    timeStr: timeString(time),
+    timeStr: TimeDateStr.timeString(time),
     timezone: timezoneInfo.timeZoneName,
     timezoneId: timezoneInfo.timeZoneId,
     offset: timezoneInfo.rawOffset / 3600,
@@ -81,7 +77,7 @@ function getLocalTimeDataErr() {
   const timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;
   return {
     time: new Date(),
-    timeStr: timeString(new Date()),
+    timeStr: TimeDateStr.timeString(new Date()),
     timezone: timezone,
     timezoneId: timezone,
     offset: 0,

package/src/index.js

@@ -12,13 +12,8 @@
 // Astronomy
 export { default as MoonCalc } from "./astronomy/moon/MoonCalc.js";
 export { default as SunCalc } from "./astronomy/sun/SunCalc.js";
-export {
-  dateFormat,
-  getLocalTimeFromTz,
-  nowString,
-  timeString,
-} from "./astronomy/timehelpers.js";
-export { getLocalTimeInfo as getLocalTime } from "./astronomy/timeZoneInfo.js";
+export { timeFromLocation } from "./geolocation/timeFromLocation.js";
+export { default as TimeDateStr } from "./utils/timehelpers.js";
 
 // Geolocation
 export { getGeolocation } from "./geolocation/getGeolocation.js";

package/src/utils/index.js

@@ -3,6 +3,7 @@
  */
 
 export { degreesToCompass } from "./degreesToCompass.js";
+export { default as TimeDateStr } from "./timehelpers.js";
 export { getWarning, getWarningByDays } from "./warning.js";
 export { WindArrow } from "./wind/WindArrow.jsx";
 export { windArrowTx } from "./wind/windArrowTx.js";

package/src/{astronomy → utils}/timehelpers.js

@@ -1,13 +1,47 @@
+/**
+ * Helpers for get date and time formeted strings
+ *
+ */
+
+/**
+ * TimeDateStr.
+ * @ignore
+ */
+const TimeDateStr = {
+  dateFormat,
+  nowString,
+  timeString,
+  getLocalTimeFromTz,
+};
+export default TimeDateStr;
+
 //------------------------------------------------------
 /**
- * Formatea una fecha a un string legible.
+ * Returns a date as a formated string.
+ *
+ * @param {Date} [date=new Date()] La fecha a formatear.
+ * @returns {string} La fecha formateada.
+ * @memberof module:Utils
+ */
+function dateFormat(date = new Date()) {
+  const options = {
+    weekday: "long",
+    day: "numeric",
+    month: "short",
+  };
+  // @ts-ignore
+  return date.toLocaleDateString([], options);
+}
+//------------------------------------------------------
+/**
+ * Returns a time as a formated string.
  *
  * @param {Date} [date]
  * @param {boolean} [sec=false]
  * @returns {string} La fecha formateada.
- * @memberof module:Astronomy
+ * @memberof module:Utils
  */
-export function timeString(date = new Date(), sec = false) {
+function timeString(date = new Date(), sec = false) {
   if (sec) {
     return date.toLocaleTimeString([], {
       hour: "2-digit",
@@ -25,41 +59,25 @@ export function timeString(date = new Date(), sec = false) {
 }
 //------------------------------------------------------
 /**
+ * Returns a now time as a formated string.
  *
  * @param {boolean} sec
  * @returns {String}
- * @memberof module:Astronomy
+ * @memberof module:Utils
  */
-export function nowString(sec = false) {
+function nowString(sec = false) {
   return timeString(new Date(), sec);
 }
 //------------------------------------------------------
 /**
- * Formatea una fecha a un string legible.
- *
- * @param {Date} [date=new Date()] La fecha a formatear.
- * @returns {string} La fecha formateada.
- * @memberof module:Astronomy
- */
-export function dateFormat(date = new Date()) {
-  const options = {
-    weekday: "long",
-    day: "numeric",
-    month: "short",
-  };
-  // @ts-ignore
-  return date.toLocaleDateString([], options);
-}
-//------------------------------------------------------
-/**
- * Get local time from timezone
+ * Return the local time string from a given timezone.
  *
  * @param {string} timeZone - The timezone string (e.g., 'America/New_York').
  * @param {Date | number} [date=new Date()] - The date object to format. Defaults to the current date.
  * @returns {string} - The formatted local time string.
- * @memberof module:Astronomy
+ * @memberof module:Utils
  */
-export function getLocalTimeFromTz(timeZone, date = new Date()) {
+function getLocalTimeFromTz(timeZone, date = new Date()) {
   // Timezone example
   // timeZone = 'America/New_York';
 

package/dist/types/astronomy/timehelpers.d.ts

@@ -1,33 +0,0 @@
-/**
- * Formatea una fecha a un string legible.
- *
- * @param {Date} [date]
- * @param {boolean} [sec=false]
- * @returns {string} La fecha formateada.
- * @memberof module:Astronomy
- */
-export function timeString(date?: Date | undefined, sec?: boolean | undefined): string;
-/**
- *
- * @param {boolean} sec
- * @returns {String}
- * @memberof module:Astronomy
- */
-export function nowString(sec?: boolean): string;
-/**
- * Formatea una fecha a un string legible.
- *
- * @param {Date} [date=new Date()] La fecha a formatear.
- * @returns {string} La fecha formateada.
- * @memberof module:Astronomy
- */
-export function dateFormat(date?: Date | undefined): string;
-/**
- * Get local time from timezone
- *
- * @param {string} timeZone - The timezone string (e.g., 'America/New_York').
- * @param {Date | number} [date=new Date()] - The date object to format. Defaults to the current date.
- * @returns {string} - The formatted local time string.
- * @memberof module:Astronomy
- */
-export function getLocalTimeFromTz(timeZone: string, date?: number | Date | undefined): string;