@xbg.solutions/utils-timezone 1.0.0

package/lib/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Timezone Utilities
+ *
+ * Exports timezone calculation and validation utilities
+ */
+export { calculateTimezone, calculateTimezoneWithLogger, isValidTimezone, getCountryTimezones, getCountryInfo, type TimezoneCalculationOptions, type TimezoneCalculationResult } from './timezone-calculator';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,iBAAiB,EACjB,2BAA2B,EAC3B,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC/B,MAAM,uBAAuB,CAAC"}

package/lib/index.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Timezone Utilities
+ *
+ * Exports timezone calculation and validation utilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCountryInfo = exports.getCountryTimezones = exports.isValidTimezone = exports.calculateTimezoneWithLogger = exports.calculateTimezone = void 0;
+var timezone_calculator_1 = require("./timezone-calculator");
+Object.defineProperty(exports, "calculateTimezone", { enumerable: true, get: function () { return timezone_calculator_1.calculateTimezone; } });
+Object.defineProperty(exports, "calculateTimezoneWithLogger", { enumerable: true, get: function () { return timezone_calculator_1.calculateTimezoneWithLogger; } });
+Object.defineProperty(exports, "isValidTimezone", { enumerable: true, get: function () { return timezone_calculator_1.isValidTimezone; } });
+Object.defineProperty(exports, "getCountryTimezones", { enumerable: true, get: function () { return timezone_calculator_1.getCountryTimezones; } });
+Object.defineProperty(exports, "getCountryInfo", { enumerable: true, get: function () { return timezone_calculator_1.getCountryInfo; } });
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,6DAQ+B;AAP7B,wHAAA,iBAAiB,OAAA;AACjB,kIAAA,2BAA2B,OAAA;AAC3B,sHAAA,eAAe,OAAA;AACf,0HAAA,mBAAmB,OAAA;AACnB,qHAAA,cAAc,OAAA"}

package/lib/timezone-calculator.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Timezone Calculator Utility
+ *
+ * Calculates IANA timezone from city and country.
+ * Strategy: Country-based lookup (offline, fast, good for MVP)
+ * Future: Can integrate Google Places/Timezone API for precision
+ *
+ * @module utilities/timezone
+ * @reusable - Can be used in any Node.js project
+ */
+import ct from 'countries-and-timezones';
+/**
+ * Timezone calculation options
+ */
+export interface TimezoneCalculationOptions {
+    /** Fallback timezone if calculation fails (default: 'UTC') */
+    fallbackTimezone?: string;
+    /** Enable verbose logging (default: false) */
+    verbose?: boolean;
+}
+/**
+ * Timezone calculation result
+ */
+export interface TimezoneCalculationResult {
+    /** Calculated IANA timezone (e.g., 'Australia/Sydney') */
+    timezone: string;
+    /** Whether fallback was used */
+    usedFallback: boolean;
+    /** Whether country has multiple timezones */
+    multipleTimezones: boolean;
+    /** All available timezones for the country (if multiple) */
+    availableTimezones?: string[];
+    /** Confidence level: 'high' (single TZ), 'medium' (multi TZ), 'low' (fallback) */
+    confidence: 'high' | 'medium' | 'low';
+}
+/**
+ * Calculate timezone from city and country
+ *
+ * @param city - City name (currently used for logging only; precision TBD in future)
+ * @param countryCode - ISO 3166-1 alpha-2 country code (e.g., 'AU', 'US', 'GB')
+ * @param options - Calculation options
+ * @returns Timezone calculation result
+ *
+ * @example
+ * ```typescript
+ * const result = calculateTimezone('Sydney', 'AU');
+ * console.log(result.timezone); // 'Australia/Sydney'
+ * console.log(result.confidence); // 'high'
+ * ```
+ *
+ * @example
+ * ```typescript
+ * const result = calculateTimezone('New York', 'US');
+ * console.log(result.timezone); // 'America/New_York' (first in list)
+ * console.log(result.confidence); // 'medium'
+ * console.log(result.multipleTimezones); // true
+ * ```
+ */
+export declare function calculateTimezone(city: string, countryCode: string, options?: TimezoneCalculationOptions): TimezoneCalculationResult;
+/**
+ * Validate if a timezone string is a valid IANA timezone
+ *
+ * @param timezone - Timezone string to validate
+ * @returns true if valid IANA timezone
+ *
+ * @example
+ * ```typescript
+ * isValidTimezone('Australia/Sydney'); // true
+ * isValidTimezone('Invalid/Timezone'); // false
+ * isValidTimezone('EST'); // false (abbreviations not allowed)
+ * ```
+ */
+export declare function isValidTimezone(timezone: string): boolean;
+/**
+ * Get all timezones for a country
+ *
+ * @param countryCode - ISO 3166-1 alpha-2 country code
+ * @returns Array of IANA timezones, or empty array if country not found
+ *
+ * @example
+ * ```typescript
+ * getCountryTimezones('AU');
+ * // ['Australia/Sydney', 'Australia/Melbourne', 'Australia/Brisbane', ...]
+ * ```
+ */
+export declare function getCountryTimezones(countryCode: string): string[];
+/**
+ * Get country information including timezones
+ *
+ * @param countryCode - ISO 3166-1 alpha-2 country code
+ * @returns Country data or null if not found
+ *
+ * @example
+ * ```typescript
+ * const aus = getCountryInfo('AU');
+ * console.log(aus.name); // 'Australia'
+ * console.log(aus.timezones); // ['Australia/Sydney', ...]
+ * ```
+ */
+export declare function getCountryInfo(countryCode: string): ct.Country | undefined;
+/**
+ * Calculate timezone with logging support (for use with Logger instance)
+ *
+ * @param city - City name
+ * @param countryCode - ISO 3166-1 alpha-2 country code
+ * @param logger - Logger instance (optional)
+ * @returns Timezone calculation result
+ *
+ * @example
+ * ```typescript
+ * import { logger } from '@xbg/utils-logger';
+ *
+ * const result = calculateTimezoneWithLogger('Sydney', 'AU', logger);
+ * // Logs to your application logger
+ * ```
+ */
+export declare function calculateTimezoneWithLogger(city: string, countryCode: string, logger?: {
+    debug?: Function;
+    warn?: Function;
+    info?: Function;
+}): TimezoneCalculationResult;
+//# sourceMappingURL=timezone-calculator.d.ts.map

package/lib/timezone-calculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timezone-calculator.d.ts","sourceRoot":"","sources":["../src/timezone-calculator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAuFzC;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8CAA8C;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,YAAY,EAAE,OAAO,CAAC;IACtB,6CAA6C;IAC7C,iBAAiB,EAAE,OAAO,CAAC;IAC3B,4DAA4D;IAC5D,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,kFAAkF;IAClF,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACvC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,0BAA+B,GACvC,yBAAyB,CAgG3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAczD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CASjE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,0BAGjD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,QAAQ,CAAC;IAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAAC,IAAI,CAAC,EAAE,QAAQ,CAAA;CAAE,GAC9D,yBAAyB,CA2E3B"}

package/lib/timezone-calculator.js

@@ -0,0 +1,340 @@
+"use strict";
+/**
+ * Timezone Calculator Utility
+ *
+ * Calculates IANA timezone from city and country.
+ * Strategy: Country-based lookup (offline, fast, good for MVP)
+ * Future: Can integrate Google Places/Timezone API for precision
+ *
+ * @module utilities/timezone
+ * @reusable - Can be used in any Node.js project
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateTimezone = calculateTimezone;
+exports.isValidTimezone = isValidTimezone;
+exports.getCountryTimezones = getCountryTimezones;
+exports.getCountryInfo = getCountryInfo;
+exports.calculateTimezoneWithLogger = calculateTimezoneWithLogger;
+const countries_and_timezones_1 = __importDefault(require("countries-and-timezones"));
+/**
+ * Australian city to timezone mapping (offline, high precision)
+ * Covers all major cities and state capitals for launch market
+ */
+const AUSTRALIAN_CITY_TIMEZONES = {
+    // New South Wales
+    'sydney': 'Australia/Sydney',
+    'newcastle': 'Australia/Sydney',
+    'wollongong': 'Australia/Sydney',
+    'centralcoast': 'Australia/Sydney',
+    'bluemountains': 'Australia/Sydney',
+    'canberra': 'Australia/Sydney', // ACT uses Sydney timezone
+    // Victoria
+    'melbourne': 'Australia/Melbourne',
+    'geelong': 'Australia/Melbourne',
+    'ballarat': 'Australia/Melbourne',
+    'bendigo': 'Australia/Melbourne',
+    // Queensland
+    'brisbane': 'Australia/Brisbane',
+    'goldcoast': 'Australia/Brisbane',
+    'sunshinecoast': 'Australia/Brisbane',
+    'townsville': 'Australia/Brisbane',
+    'cairns': 'Australia/Brisbane',
+    'toowoomba': 'Australia/Brisbane',
+    'rockhampton': 'Australia/Brisbane',
+    'mackay': 'Australia/Brisbane',
+    // Western Australia
+    'perth': 'Australia/Perth',
+    'fremantle': 'Australia/Perth',
+    'bunbury': 'Australia/Perth',
+    'geraldton': 'Australia/Perth',
+    'kalgoorlie': 'Australia/Perth',
+    'albany': 'Australia/Perth',
+    // South Australia
+    'adelaide': 'Australia/Adelaide',
+    'mountgambier': 'Australia/Adelaide',
+    'whyalla': 'Australia/Adelaide',
+    'portaugusta': 'Australia/Adelaide',
+    // Tasmania
+    'hobart': 'Australia/Hobart',
+    'launceston': 'Australia/Hobart',
+    'burnie': 'Australia/Hobart',
+    'devonport': 'Australia/Hobart',
+    // Northern Territory
+    'darwin': 'Australia/Darwin',
+    'alicesprings': 'Australia/Darwin',
+    'katherina': 'Australia/Darwin',
+    // Lord Howe Island (special case - UTC+10:30/+11)
+    'lordhowe': 'Australia/Lord_Howe',
+    'lordhoweisland': 'Australia/Lord_Howe',
+    // Broken Hill (NSW but uses SA time)
+    'brokenhill': 'Australia/Broken_Hill',
+    // Eucla (WA border town with unique timezone)
+    'eucla': 'Australia/Eucla'
+};
+/**
+ * Normalize city name for lookup
+ * Removes spaces, hyphens, apostrophes and converts to lowercase
+ */
+function normalizeCityName(city) {
+    return city
+        .toLowerCase()
+        .trim()
+        .replace(/[\s\-']/g, ''); // Remove spaces, hyphens, apostrophes
+}
+/**
+ * Look up timezone for Australian city
+ * Returns timezone if found, undefined if not in mapping
+ */
+function getAustralianCityTimezone(city) {
+    const normalized = normalizeCityName(city);
+    return AUSTRALIAN_CITY_TIMEZONES[normalized];
+}
+/**
+ * Calculate timezone from city and country
+ *
+ * @param city - City name (currently used for logging only; precision TBD in future)
+ * @param countryCode - ISO 3166-1 alpha-2 country code (e.g., 'AU', 'US', 'GB')
+ * @param options - Calculation options
+ * @returns Timezone calculation result
+ *
+ * @example
+ * ```typescript
+ * const result = calculateTimezone('Sydney', 'AU');
+ * console.log(result.timezone); // 'Australia/Sydney'
+ * console.log(result.confidence); // 'high'
+ * ```
+ *
+ * @example
+ * ```typescript
+ * const result = calculateTimezone('New York', 'US');
+ * console.log(result.timezone); // 'America/New_York' (first in list)
+ * console.log(result.confidence); // 'medium'
+ * console.log(result.multipleTimezones); // true
+ * ```
+ */
+function calculateTimezone(city, countryCode, options = {}) {
+    const { fallbackTimezone = 'UTC', verbose = false } = options;
+    // Normalize country code
+    const normalizedCountryCode = countryCode.toUpperCase().trim();
+    if (verbose) {
+        console.log(`[TimezoneCalculator] Calculating timezone for: ${city}, ${normalizedCountryCode}`);
+    }
+    // Get country data
+    const country = countries_and_timezones_1.default.getCountry(normalizedCountryCode);
+    // Country not found - use fallback
+    if (!country || !country.timezones || country.timezones.length === 0) {
+        if (verbose) {
+            console.warn(`[TimezoneCalculator] Country not found or has no timezones: ${normalizedCountryCode}`);
+        }
+        return {
+            timezone: fallbackTimezone,
+            usedFallback: true,
+            multipleTimezones: false,
+            confidence: 'low'
+        };
+    }
+    // Single timezone country - high confidence
+    if (country.timezones.length === 1) {
+        const timezone = country.timezones[0];
+        if (verbose) {
+            console.log(`[TimezoneCalculator] Single timezone country: ${timezone}`);
+        }
+        return {
+            timezone,
+            usedFallback: false,
+            multipleTimezones: false,
+            confidence: 'high'
+        };
+    }
+    // Multiple timezone country - try city-level precision for Australia
+    if (normalizedCountryCode === 'AU' && city) {
+        const cityTimezone = getAustralianCityTimezone(city);
+        if (cityTimezone) {
+            if (verbose) {
+                console.log(`[TimezoneCalculator] Australian city matched: ${city} → ${cityTimezone}`);
+            }
+            return {
+                timezone: cityTimezone,
+                usedFallback: false,
+                multipleTimezones: true,
+                availableTimezones: country.timezones,
+                confidence: 'high' // High confidence for city-level match
+            };
+        }
+        if (verbose) {
+            console.log(`[TimezoneCalculator] Australian city not in mapping: ${city}`);
+            console.log(`[TimezoneCalculator] Falling back to Sydney timezone (most populous)`);
+        }
+        // Fallback to Sydney for unknown Australian cities (most populous)
+        return {
+            timezone: 'Australia/Sydney',
+            usedFallback: false,
+            multipleTimezones: true,
+            availableTimezones: country.timezones,
+            confidence: 'medium'
+        };
+    }
+    // Multiple timezone country (non-AU) - use first (usually most populous)
+    const defaultTimezone = country.timezones[0];
+    if (verbose) {
+        console.log(`[TimezoneCalculator] Multi-timezone country: ${normalizedCountryCode}`);
+        console.log(`[TimezoneCalculator] Selected: ${defaultTimezone}`);
+        console.log(`[TimezoneCalculator] Available: ${country.timezones.join(', ')}`);
+        console.log(`[TimezoneCalculator] Note: Using default timezone for country.`);
+    }
+    return {
+        timezone: defaultTimezone,
+        usedFallback: false,
+        multipleTimezones: true,
+        availableTimezones: country.timezones,
+        confidence: 'medium'
+    };
+}
+/**
+ * Validate if a timezone string is a valid IANA timezone
+ *
+ * @param timezone - Timezone string to validate
+ * @returns true if valid IANA timezone
+ *
+ * @example
+ * ```typescript
+ * isValidTimezone('Australia/Sydney'); // true
+ * isValidTimezone('Invalid/Timezone'); // false
+ * isValidTimezone('EST'); // false (abbreviations not allowed)
+ * ```
+ */
+function isValidTimezone(timezone) {
+    try {
+        // Check if timezone follows IANA format (Region/City) or is UTC
+        // Reject abbreviations like EST, PST, GMT+10, etc.
+        if (timezone !== 'UTC' && !timezone.includes('/')) {
+            return false;
+        }
+        // Additional validation using Intl API
+        Intl.DateTimeFormat(undefined, { timeZone: timezone });
+        return true;
+    }
+    catch (_a) {
+        return false;
+    }
+}
+/**
+ * Get all timezones for a country
+ *
+ * @param countryCode - ISO 3166-1 alpha-2 country code
+ * @returns Array of IANA timezones, or empty array if country not found
+ *
+ * @example
+ * ```typescript
+ * getCountryTimezones('AU');
+ * // ['Australia/Sydney', 'Australia/Melbourne', 'Australia/Brisbane', ...]
+ * ```
+ */
+function getCountryTimezones(countryCode) {
+    const normalizedCountryCode = countryCode.toUpperCase().trim();
+    const country = countries_and_timezones_1.default.getCountry(normalizedCountryCode);
+    if (!country || !country.timezones) {
+        return [];
+    }
+    return country.timezones;
+}
+/**
+ * Get country information including timezones
+ *
+ * @param countryCode - ISO 3166-1 alpha-2 country code
+ * @returns Country data or null if not found
+ *
+ * @example
+ * ```typescript
+ * const aus = getCountryInfo('AU');
+ * console.log(aus.name); // 'Australia'
+ * console.log(aus.timezones); // ['Australia/Sydney', ...]
+ * ```
+ */
+function getCountryInfo(countryCode) {
+    const normalizedCountryCode = countryCode.toUpperCase().trim();
+    return countries_and_timezones_1.default.getCountry(normalizedCountryCode);
+}
+/**
+ * Calculate timezone with logging support (for use with Logger instance)
+ *
+ * @param city - City name
+ * @param countryCode - ISO 3166-1 alpha-2 country code
+ * @param logger - Logger instance (optional)
+ * @returns Timezone calculation result
+ *
+ * @example
+ * ```typescript
+ * import { logger } from '@xbg/utils-logger';
+ *
+ * const result = calculateTimezoneWithLogger('Sydney', 'AU', logger);
+ * // Logs to your application logger
+ * ```
+ */
+function calculateTimezoneWithLogger(city, countryCode, logger) {
+    var _a, _b, _c, _d, _e, _f;
+    const normalizedCountryCode = countryCode.toUpperCase().trim();
+    (_a = logger === null || logger === void 0 ? void 0 : logger.debug) === null || _a === void 0 ? void 0 : _a.call(logger, 'Calculating timezone', { city, countryCode: normalizedCountryCode });
+    const country = countries_and_timezones_1.default.getCountry(normalizedCountryCode);
+    // Country not found
+    if (!country || !country.timezones || country.timezones.length === 0) {
+        (_b = logger === null || logger === void 0 ? void 0 : logger.warn) === null || _b === void 0 ? void 0 : _b.call(logger, 'Country not found or has no timezones', { countryCode: normalizedCountryCode });
+        return {
+            timezone: 'UTC',
+            usedFallback: true,
+            multipleTimezones: false,
+            confidence: 'low'
+        };
+    }
+    // Single timezone country
+    if (country.timezones.length === 1) {
+        const timezone = country.timezones[0];
+        (_c = logger === null || logger === void 0 ? void 0 : logger.debug) === null || _c === void 0 ? void 0 : _c.call(logger, 'Single timezone country', { timezone });
+        return {
+            timezone,
+            usedFallback: false,
+            multipleTimezones: false,
+            confidence: 'high'
+        };
+    }
+    // Multiple timezone country - try city-level precision for Australia
+    if (normalizedCountryCode === 'AU' && city) {
+        const cityTimezone = getAustralianCityTimezone(city);
+        if (cityTimezone) {
+            (_d = logger === null || logger === void 0 ? void 0 : logger.debug) === null || _d === void 0 ? void 0 : _d.call(logger, 'Australian city matched', { city, timezone: cityTimezone });
+            return {
+                timezone: cityTimezone,
+                usedFallback: false,
+                multipleTimezones: true,
+                availableTimezones: country.timezones,
+                confidence: 'high'
+            };
+        }
+        (_e = logger === null || logger === void 0 ? void 0 : logger.info) === null || _e === void 0 ? void 0 : _e.call(logger, 'Australian city not in mapping, using Sydney default', { city });
+        return {
+            timezone: 'Australia/Sydney',
+            usedFallback: false,
+            multipleTimezones: true,
+            availableTimezones: country.timezones,
+            confidence: 'medium'
+        };
+    }
+    // Multiple timezone country (non-AU)
+    const defaultTimezone = country.timezones[0];
+    (_f = logger === null || logger === void 0 ? void 0 : logger.info) === null || _f === void 0 ? void 0 : _f.call(logger, 'Multi-timezone country - using default', {
+        countryCode: normalizedCountryCode,
+        selectedTimezone: defaultTimezone,
+        availableTimezones: country.timezones
+    });
+    return {
+        timezone: defaultTimezone,
+        usedFallback: false,
+        multipleTimezones: true,
+        availableTimezones: country.timezones,
+        confidence: 'medium'
+    };
+}
+//# sourceMappingURL=timezone-calculator.js.map

package/lib/timezone-calculator.js.map

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

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@xbg.solutions/utils-timezone",
+  "version": "1.0.0",
+  "description": "Timezone conversion helper",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "files": ["lib"],
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "clean": "rm -rf lib",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {"countries-and-timezones": "^3.6.0"},
+  "devDependencies": {"@types/node": "^20.11.0", "typescript": "^5.3.3"},
+  "engines": {
+    "node": "22"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}