device-passport 1.0.0 → 1.1.0

package/dist/geo/index.cjs

@@ -0,0 +1,50 @@
+'use strict';
+
+const aligner = require('../shared/device-passport.BPd2-w8e.cjs');
+
+const GEO_LOCALES = aligner.COUNTRY_LOCALES;
+const TIMEZONE_MATRIX = aligner.TIMEZONE_TO_COUNTRY;
+const isValidCountryCode = aligner.hasCountryConfig;
+function detectGeoFromUrl(url) {
+  return aligner.extractCountryFromProxyUrl(url);
+}
+function getLocaleProfile(countryCode, timezone) {
+  const geo = aligner.alignGeoContext({
+    country: countryCode || void 0,
+    timezone
+  });
+  return aligner.toLocaleProfile(geo);
+}
+
+exports.ALPHA3_TO_ALPHA2 = aligner.ALPHA3_TO_ALPHA2;
+exports.COUNTRY_LOCALES = aligner.COUNTRY_LOCALES;
+exports.COUNTRY_NAME_TO_CODE = aligner.COUNTRY_NAME_TO_CODE;
+exports.DEFAULT_ACCEPT_LANGUAGE = aligner.DEFAULT_ACCEPT_LANGUAGE;
+exports.DEFAULT_COUNTRY = aligner.DEFAULT_COUNTRY;
+exports.DEFAULT_LOCALE = aligner.DEFAULT_LOCALE;
+exports.DEFAULT_TIMEZONE = aligner.DEFAULT_TIMEZONE;
+exports.TIMEZONE_TO_COUNTRY = aligner.TIMEZONE_TO_COUNTRY;
+exports.alignGeoContext = aligner.alignGeoContext;
+exports.detectCountry = aligner.detectCountry;
+exports.extractCountryFromProxyUrl = aligner.extractCountryFromProxyUrl;
+exports.formatAcceptLanguage = aligner.formatAcceptLanguage;
+exports.getAllSupportedCountries = aligner.getAllSupportedCountries;
+exports.getCountryConfig = aligner.getCountryConfig;
+exports.getCountryForTimezone = aligner.getCountryForTimezone;
+exports.getDefaultTimezoneForCountry = aligner.getDefaultTimezoneForCountry;
+exports.getTimezoneOffsetMinutes = aligner.getTimezoneOffsetMinutes;
+exports.getTimezonesForCountry = aligner.getTimezonesForCountry;
+exports.hasCountryConfig = aligner.hasCountryConfig;
+exports.isGeoAligned = aligner.isGeoAligned;
+exports.isTimezoneAlignedWithCountry = aligner.isTimezoneAlignedWithCountry;
+exports.isValidTimezone = aligner.isValidTimezone;
+exports.listAllTimezones = aligner.listAllTimezones;
+exports.normalizeCountryCode = aligner.normalizeCountryCode;
+exports.parseAcceptLanguage = aligner.parseAcceptLanguage;
+exports.toGeoLocation = aligner.toGeoLocation;
+exports.toLocaleProfile = aligner.toLocaleProfile;
+exports.GEO_LOCALES = GEO_LOCALES;
+exports.TIMEZONE_MATRIX = TIMEZONE_MATRIX;
+exports.detectGeoFromUrl = detectGeoFromUrl;
+exports.getLocaleProfile = getLocaleProfile;
+exports.isValidCountryCode = isValidCountryCode;

package/dist/geo/index.d.cts

@@ -0,0 +1,209 @@
+import { c as GeoOptions, G as GeoContext } from '../shared/device-passport.C_F1vBE8.cjs';
+import { GeoCoordinates, LocaleProfile } from '../index.cjs';
+
+/**
+ * Comprehensive Geographic-Locale Mapping Database.
+ * Zero-dependency, pure TypeScript.
+ */
+
+interface CountryLocaleConfig {
+    /** ISO 3166-1 alpha-2 uppercase country code */
+    country: string;
+    /** Full English country name */
+    countryName: string;
+    /** Primary locale identifier, e.g. 'en-US', 'ja-JP' */
+    primaryLocale: string;
+    /** Primary and fallback languages ordered by preference */
+    languages: string[];
+    /** Strictly formatted RFC 9110 Accept-Language weighted header string */
+    acceptLanguage: string;
+    /** Supported IANA timezones within this country */
+    timezones: string[];
+    /** Default primary IANA timezone */
+    defaultTimezone: string;
+    /** ISO 4217 currency code */
+    currency: string;
+    /** Representative geographical center/capital coordinates */
+    coordinates: GeoCoordinates;
+}
+/**
+ * Global fallback defaults
+ */
+declare const DEFAULT_COUNTRY = "US";
+declare const DEFAULT_LOCALE = "en-US";
+declare const DEFAULT_TIMEZONE = "America/New_York";
+declare const DEFAULT_ACCEPT_LANGUAGE = "en-US,en;q=0.9";
+/**
+ * Comprehensive Country Locale & Geographic Database.
+ */
+declare const COUNTRY_LOCALES: Record<string, CountryLocaleConfig>;
+/**
+ * Get country locale configuration with fallback.
+ */
+declare function getCountryConfig(countryCode?: string | null): CountryLocaleConfig;
+/**
+ * Check if a country code is supported in the database.
+ */
+declare function hasCountryConfig(countryCode?: string | null): boolean;
+/**
+ * Get all supported ISO country codes.
+ */
+declare function getAllSupportedCountries(): string[];
+/**
+ * Strictly format an Accept-Language weighted header string from an array of languages.
+ * Example: ['en-US', 'en'] -> 'en-US,en;q=0.9'
+ * Example: ['de-DE', 'de', 'en-US', 'en'] -> 'de-DE,de;q=0.9,en-US;q=0.8,en;q=0.7'
+ */
+declare function formatAcceptLanguage(languages: string[]): string;
+/**
+ * Parse an Accept-Language header string into an array of { locale, q } items ordered by weight descending.
+ */
+declare function parseAcceptLanguage(header: string): Array<{
+    locale: string;
+    q: number;
+}>;
+
+/**
+ * Timezone Matrix and Chrono-Alignment Engine.
+ * Pure TypeScript, zero external dependencies.
+ */
+/**
+ * Direct mapping from IANA Timezone ID to ISO 3166-1 alpha-2 country code.
+ */
+declare const TIMEZONE_TO_COUNTRY: Record<string, string>;
+/**
+ * Validate if a timezone string is a valid IANA timezone identifier.
+ */
+declare function isValidTimezone(timezone: string): boolean;
+/**
+ * Get all supported timezones for a specific country code.
+ */
+declare function getTimezonesForCountry(countryCode: string): string[];
+/**
+ * Look up the ISO country code associated with an IANA timezone identifier.
+ */
+declare function getCountryForTimezone(timezone: string): string | undefined;
+/**
+ * Get the primary/default timezone for a country code.
+ */
+declare function getDefaultTimezoneForCountry(countryCode: string): string;
+/**
+ * Check if a timezone is chronologically aligned with a given country.
+ */
+declare function isTimezoneAlignedWithCountry(timezone: string, countryCode: string): boolean;
+/**
+ * Calculate timezone offset in minutes relative to UTC.
+ * Note: Following the standard convention matching LocaleProfile.timezoneOffset:
+ * - Negative for zones west of UTC (e.g. -240 for EDT, -300 for EST)
+ * - Positive for zones east of UTC (e.g. +480 for CST / Asia/Shanghai, +540 for JST)
+ * - 0 for UTC
+ */
+declare function getTimezoneOffsetMinutes(timezone: string, date?: Date): number;
+/**
+ * List all unique timezones known to the system.
+ */
+declare function listAllTimezones(): string[];
+
+/**
+ * Proxy and Geo-Context Detector.
+ * Extracts country and geo information from residential proxy URLs, IP hints, or explicit ISO codes.
+ * Pure TypeScript, zero external dependencies.
+ */
+interface GeoDetectOptions {
+    /** Country code to fall back to if detection fails. Defaults to 'US'. */
+    fallbackCountry?: string;
+}
+/**
+ * ISO 3166-1 alpha-3 to alpha-2 code mapping.
+ */
+declare const ALPHA3_TO_ALPHA2: Record<string, string>;
+/**
+ * Common English country name aliases to ISO 3166-1 alpha-2 code.
+ */
+declare const COUNTRY_NAME_TO_CODE: Record<string, string>;
+/**
+ * Normalize any country input (2-letter, 3-letter, alias, name) to an ISO 3166-1 alpha-2 uppercase code.
+ */
+declare function normalizeCountryCode(code?: string | null): string | null;
+/**
+ * Extract an ISO country code from a residential proxy URL or connection string.
+ * Supports:
+ * - Username authentication tokens (e.g. user-country-us, customer-zone-cc-DE, lum-customer-*-country-fr)
+ * - Query parameters (e.g. ?country=JP, &country_code=KR, ?cc=SG, &geo=DE)
+ * - Subdomain patterns (e.g. us.smartproxy.com, jp.proxy-seller.com)
+ */
+declare function extractCountryFromProxyUrl(url: string): string | null;
+/**
+ * Universal country detector.
+ * Accepts:
+ * - Explicit ISO 3166-1 alpha-2 / alpha-3 codes ('US', 'GB', 'jp', 'JPN')
+ * - Country names ('Japan', 'United States', 'Germany')
+ * - Residential proxy URLs (http://user-country-us:pass@proxy...)
+ * - IANA Timezone strings ('America/New_York' -> 'US', 'Asia/Tokyo' -> 'JP')
+ * - Falls back to DEFAULT_COUNTRY ('US') when unknown.
+ */
+declare function detectCountry(input?: string | null, options?: GeoDetectOptions): string;
+
+/**
+ * Geo-Chrono Aligner.
+ * Aligns browser persona parameters (country, timezone, locale, accept-language header)
+ * with zero contradictions for stealth crawlers and automation.
+ * Pure TypeScript, zero external dependencies.
+ */
+
+/**
+ * Align geographic and chronological parameters into a cohesive, contradiction-free GeoContext.
+ *
+ * @param geoInput Proxy URL, ISO country code, IANA timezone string, or GeoOptions object
+ * @returns Fully correlated GeoContext
+ */
+declare function alignGeoContext(geoInput?: string | GeoOptions): GeoContext;
+/**
+ * Verify whether a partial or full GeoContext is free of geographic or chronological contradictions.
+ */
+declare function isGeoAligned(context: Partial<GeoContext>): boolean;
+/**
+ * Format GeoContext into a LocaleProfile for runtime device-passport consumers.
+ */
+declare function toLocaleProfile(geo: GeoContext): {
+    language: string;
+    languages: string[];
+    timezone: string;
+    timezoneOffset: number;
+    country: string;
+    currency: string | undefined;
+};
+/**
+ * Format GeoContext into a GeoLocation object for browser geolocation emulation.
+ */
+declare function toGeoLocation(geo: GeoContext): {
+    latitude: number;
+    longitude: number;
+    accuracy: number;
+    country: string;
+    countryCode: string;
+    timezone: string;
+    locale: string;
+    languages: string[];
+};
+
+/**
+ * Geo and Chrono Aligner module for Device Passport.
+ * Provides geographic-locale mapping database, proxy/IP geo detector,
+ * and zero-contradiction geo-chrono alignment.
+ */
+
+declare const GEO_LOCALES: Record<string, CountryLocaleConfig>;
+declare const TIMEZONE_MATRIX: Record<string, string>;
+declare const isValidCountryCode: typeof hasCountryConfig;
+/**
+ * Detect country code from residential proxy URL.
+ */
+declare function detectGeoFromUrl(url: string): string | null;
+/**
+ * Get a complete LocaleProfile for a country code and optional timezone.
+ */
+declare function getLocaleProfile(countryCode?: string | null, timezone?: string): LocaleProfile;
+
+export { ALPHA3_TO_ALPHA2, COUNTRY_LOCALES, COUNTRY_NAME_TO_CODE, DEFAULT_ACCEPT_LANGUAGE, DEFAULT_COUNTRY, DEFAULT_LOCALE, DEFAULT_TIMEZONE, GEO_LOCALES, GeoContext, GeoOptions, TIMEZONE_MATRIX, TIMEZONE_TO_COUNTRY, alignGeoContext, detectCountry, detectGeoFromUrl, extractCountryFromProxyUrl, formatAcceptLanguage, getAllSupportedCountries, getCountryConfig, getCountryForTimezone, getDefaultTimezoneForCountry, getLocaleProfile, getTimezoneOffsetMinutes, getTimezonesForCountry, hasCountryConfig, isGeoAligned, isTimezoneAlignedWithCountry, isValidCountryCode, isValidTimezone, listAllTimezones, normalizeCountryCode, parseAcceptLanguage, toGeoLocation, toLocaleProfile };
+export type { CountryLocaleConfig, GeoDetectOptions };

package/dist/geo/index.d.mts

@@ -0,0 +1,209 @@
+import { c as GeoOptions, G as GeoContext } from '../shared/device-passport.C_F1vBE8.mjs';
+import { GeoCoordinates, LocaleProfile } from '../index.mjs';
+
+/**
+ * Comprehensive Geographic-Locale Mapping Database.
+ * Zero-dependency, pure TypeScript.
+ */
+
+interface CountryLocaleConfig {
+    /** ISO 3166-1 alpha-2 uppercase country code */
+    country: string;
+    /** Full English country name */
+    countryName: string;
+    /** Primary locale identifier, e.g. 'en-US', 'ja-JP' */
+    primaryLocale: string;
+    /** Primary and fallback languages ordered by preference */
+    languages: string[];
+    /** Strictly formatted RFC 9110 Accept-Language weighted header string */
+    acceptLanguage: string;
+    /** Supported IANA timezones within this country */
+    timezones: string[];
+    /** Default primary IANA timezone */
+    defaultTimezone: string;
+    /** ISO 4217 currency code */
+    currency: string;
+    /** Representative geographical center/capital coordinates */
+    coordinates: GeoCoordinates;
+}
+/**
+ * Global fallback defaults
+ */
+declare const DEFAULT_COUNTRY = "US";
+declare const DEFAULT_LOCALE = "en-US";
+declare const DEFAULT_TIMEZONE = "America/New_York";
+declare const DEFAULT_ACCEPT_LANGUAGE = "en-US,en;q=0.9";
+/**
+ * Comprehensive Country Locale & Geographic Database.
+ */
+declare const COUNTRY_LOCALES: Record<string, CountryLocaleConfig>;
+/**
+ * Get country locale configuration with fallback.
+ */
+declare function getCountryConfig(countryCode?: string | null): CountryLocaleConfig;
+/**
+ * Check if a country code is supported in the database.
+ */
+declare function hasCountryConfig(countryCode?: string | null): boolean;
+/**
+ * Get all supported ISO country codes.
+ */
+declare function getAllSupportedCountries(): string[];
+/**
+ * Strictly format an Accept-Language weighted header string from an array of languages.
+ * Example: ['en-US', 'en'] -> 'en-US,en;q=0.9'
+ * Example: ['de-DE', 'de', 'en-US', 'en'] -> 'de-DE,de;q=0.9,en-US;q=0.8,en;q=0.7'
+ */
+declare function formatAcceptLanguage(languages: string[]): string;
+/**
+ * Parse an Accept-Language header string into an array of { locale, q } items ordered by weight descending.
+ */
+declare function parseAcceptLanguage(header: string): Array<{
+    locale: string;
+    q: number;
+}>;
+
+/**
+ * Timezone Matrix and Chrono-Alignment Engine.
+ * Pure TypeScript, zero external dependencies.
+ */
+/**
+ * Direct mapping from IANA Timezone ID to ISO 3166-1 alpha-2 country code.
+ */
+declare const TIMEZONE_TO_COUNTRY: Record<string, string>;
+/**
+ * Validate if a timezone string is a valid IANA timezone identifier.
+ */
+declare function isValidTimezone(timezone: string): boolean;
+/**
+ * Get all supported timezones for a specific country code.
+ */
+declare function getTimezonesForCountry(countryCode: string): string[];
+/**
+ * Look up the ISO country code associated with an IANA timezone identifier.
+ */
+declare function getCountryForTimezone(timezone: string): string | undefined;
+/**
+ * Get the primary/default timezone for a country code.
+ */
+declare function getDefaultTimezoneForCountry(countryCode: string): string;
+/**
+ * Check if a timezone is chronologically aligned with a given country.
+ */
+declare function isTimezoneAlignedWithCountry(timezone: string, countryCode: string): boolean;
+/**
+ * Calculate timezone offset in minutes relative to UTC.
+ * Note: Following the standard convention matching LocaleProfile.timezoneOffset:
+ * - Negative for zones west of UTC (e.g. -240 for EDT, -300 for EST)
+ * - Positive for zones east of UTC (e.g. +480 for CST / Asia/Shanghai, +540 for JST)
+ * - 0 for UTC
+ */
+declare function getTimezoneOffsetMinutes(timezone: string, date?: Date): number;
+/**
+ * List all unique timezones known to the system.
+ */
+declare function listAllTimezones(): string[];
+
+/**
+ * Proxy and Geo-Context Detector.
+ * Extracts country and geo information from residential proxy URLs, IP hints, or explicit ISO codes.
+ * Pure TypeScript, zero external dependencies.
+ */
+interface GeoDetectOptions {
+    /** Country code to fall back to if detection fails. Defaults to 'US'. */
+    fallbackCountry?: string;
+}
+/**
+ * ISO 3166-1 alpha-3 to alpha-2 code mapping.
+ */
+declare const ALPHA3_TO_ALPHA2: Record<string, string>;
+/**
+ * Common English country name aliases to ISO 3166-1 alpha-2 code.
+ */
+declare const COUNTRY_NAME_TO_CODE: Record<string, string>;
+/**
+ * Normalize any country input (2-letter, 3-letter, alias, name) to an ISO 3166-1 alpha-2 uppercase code.
+ */
+declare function normalizeCountryCode(code?: string | null): string | null;
+/**
+ * Extract an ISO country code from a residential proxy URL or connection string.
+ * Supports:
+ * - Username authentication tokens (e.g. user-country-us, customer-zone-cc-DE, lum-customer-*-country-fr)
+ * - Query parameters (e.g. ?country=JP, &country_code=KR, ?cc=SG, &geo=DE)
+ * - Subdomain patterns (e.g. us.smartproxy.com, jp.proxy-seller.com)
+ */
+declare function extractCountryFromProxyUrl(url: string): string | null;
+/**
+ * Universal country detector.
+ * Accepts:
+ * - Explicit ISO 3166-1 alpha-2 / alpha-3 codes ('US', 'GB', 'jp', 'JPN')
+ * - Country names ('Japan', 'United States', 'Germany')
+ * - Residential proxy URLs (http://user-country-us:pass@proxy...)
+ * - IANA Timezone strings ('America/New_York' -> 'US', 'Asia/Tokyo' -> 'JP')
+ * - Falls back to DEFAULT_COUNTRY ('US') when unknown.
+ */
+declare function detectCountry(input?: string | null, options?: GeoDetectOptions): string;
+
+/**
+ * Geo-Chrono Aligner.
+ * Aligns browser persona parameters (country, timezone, locale, accept-language header)
+ * with zero contradictions for stealth crawlers and automation.
+ * Pure TypeScript, zero external dependencies.
+ */
+
+/**
+ * Align geographic and chronological parameters into a cohesive, contradiction-free GeoContext.
+ *
+ * @param geoInput Proxy URL, ISO country code, IANA timezone string, or GeoOptions object
+ * @returns Fully correlated GeoContext
+ */
+declare function alignGeoContext(geoInput?: string | GeoOptions): GeoContext;
+/**
+ * Verify whether a partial or full GeoContext is free of geographic or chronological contradictions.
+ */
+declare function isGeoAligned(context: Partial<GeoContext>): boolean;
+/**
+ * Format GeoContext into a LocaleProfile for runtime device-passport consumers.
+ */
+declare function toLocaleProfile(geo: GeoContext): {
+    language: string;
+    languages: string[];
+    timezone: string;
+    timezoneOffset: number;
+    country: string;
+    currency: string | undefined;
+};
+/**
+ * Format GeoContext into a GeoLocation object for browser geolocation emulation.
+ */
+declare function toGeoLocation(geo: GeoContext): {
+    latitude: number;
+    longitude: number;
+    accuracy: number;
+    country: string;
+    countryCode: string;
+    timezone: string;
+    locale: string;
+    languages: string[];
+};
+
+/**
+ * Geo and Chrono Aligner module for Device Passport.
+ * Provides geographic-locale mapping database, proxy/IP geo detector,
+ * and zero-contradiction geo-chrono alignment.
+ */
+
+declare const GEO_LOCALES: Record<string, CountryLocaleConfig>;
+declare const TIMEZONE_MATRIX: Record<string, string>;
+declare const isValidCountryCode: typeof hasCountryConfig;
+/**
+ * Detect country code from residential proxy URL.
+ */
+declare function detectGeoFromUrl(url: string): string | null;
+/**
+ * Get a complete LocaleProfile for a country code and optional timezone.
+ */
+declare function getLocaleProfile(countryCode?: string | null, timezone?: string): LocaleProfile;
+
+export { ALPHA3_TO_ALPHA2, COUNTRY_LOCALES, COUNTRY_NAME_TO_CODE, DEFAULT_ACCEPT_LANGUAGE, DEFAULT_COUNTRY, DEFAULT_LOCALE, DEFAULT_TIMEZONE, GEO_LOCALES, GeoContext, GeoOptions, TIMEZONE_MATRIX, TIMEZONE_TO_COUNTRY, alignGeoContext, detectCountry, detectGeoFromUrl, extractCountryFromProxyUrl, formatAcceptLanguage, getAllSupportedCountries, getCountryConfig, getCountryForTimezone, getDefaultTimezoneForCountry, getLocaleProfile, getTimezoneOffsetMinutes, getTimezonesForCountry, hasCountryConfig, isGeoAligned, isTimezoneAlignedWithCountry, isValidCountryCode, isValidTimezone, listAllTimezones, normalizeCountryCode, parseAcceptLanguage, toGeoLocation, toLocaleProfile };
+export type { CountryLocaleConfig, GeoDetectOptions };

package/dist/geo/index.d.ts

@@ -0,0 +1,209 @@
+import { c as GeoOptions, G as GeoContext } from '../shared/device-passport.C_F1vBE8.js';
+import { GeoCoordinates, LocaleProfile } from '../index.js';
+
+/**
+ * Comprehensive Geographic-Locale Mapping Database.
+ * Zero-dependency, pure TypeScript.
+ */
+
+interface CountryLocaleConfig {
+    /** ISO 3166-1 alpha-2 uppercase country code */
+    country: string;
+    /** Full English country name */
+    countryName: string;
+    /** Primary locale identifier, e.g. 'en-US', 'ja-JP' */
+    primaryLocale: string;
+    /** Primary and fallback languages ordered by preference */
+    languages: string[];
+    /** Strictly formatted RFC 9110 Accept-Language weighted header string */
+    acceptLanguage: string;
+    /** Supported IANA timezones within this country */
+    timezones: string[];
+    /** Default primary IANA timezone */
+    defaultTimezone: string;
+    /** ISO 4217 currency code */
+    currency: string;
+    /** Representative geographical center/capital coordinates */
+    coordinates: GeoCoordinates;
+}
+/**
+ * Global fallback defaults
+ */
+declare const DEFAULT_COUNTRY = "US";
+declare const DEFAULT_LOCALE = "en-US";
+declare const DEFAULT_TIMEZONE = "America/New_York";
+declare const DEFAULT_ACCEPT_LANGUAGE = "en-US,en;q=0.9";
+/**
+ * Comprehensive Country Locale & Geographic Database.
+ */
+declare const COUNTRY_LOCALES: Record<string, CountryLocaleConfig>;
+/**
+ * Get country locale configuration with fallback.
+ */
+declare function getCountryConfig(countryCode?: string | null): CountryLocaleConfig;
+/**
+ * Check if a country code is supported in the database.
+ */
+declare function hasCountryConfig(countryCode?: string | null): boolean;
+/**
+ * Get all supported ISO country codes.
+ */
+declare function getAllSupportedCountries(): string[];
+/**
+ * Strictly format an Accept-Language weighted header string from an array of languages.
+ * Example: ['en-US', 'en'] -> 'en-US,en;q=0.9'
+ * Example: ['de-DE', 'de', 'en-US', 'en'] -> 'de-DE,de;q=0.9,en-US;q=0.8,en;q=0.7'
+ */
+declare function formatAcceptLanguage(languages: string[]): string;
+/**
+ * Parse an Accept-Language header string into an array of { locale, q } items ordered by weight descending.
+ */
+declare function parseAcceptLanguage(header: string): Array<{
+    locale: string;
+    q: number;
+}>;
+
+/**
+ * Timezone Matrix and Chrono-Alignment Engine.
+ * Pure TypeScript, zero external dependencies.
+ */
+/**
+ * Direct mapping from IANA Timezone ID to ISO 3166-1 alpha-2 country code.
+ */
+declare const TIMEZONE_TO_COUNTRY: Record<string, string>;
+/**
+ * Validate if a timezone string is a valid IANA timezone identifier.
+ */
+declare function isValidTimezone(timezone: string): boolean;
+/**
+ * Get all supported timezones for a specific country code.
+ */
+declare function getTimezonesForCountry(countryCode: string): string[];
+/**
+ * Look up the ISO country code associated with an IANA timezone identifier.
+ */
+declare function getCountryForTimezone(timezone: string): string | undefined;
+/**
+ * Get the primary/default timezone for a country code.
+ */
+declare function getDefaultTimezoneForCountry(countryCode: string): string;
+/**
+ * Check if a timezone is chronologically aligned with a given country.
+ */
+declare function isTimezoneAlignedWithCountry(timezone: string, countryCode: string): boolean;
+/**
+ * Calculate timezone offset in minutes relative to UTC.
+ * Note: Following the standard convention matching LocaleProfile.timezoneOffset:
+ * - Negative for zones west of UTC (e.g. -240 for EDT, -300 for EST)
+ * - Positive for zones east of UTC (e.g. +480 for CST / Asia/Shanghai, +540 for JST)
+ * - 0 for UTC
+ */
+declare function getTimezoneOffsetMinutes(timezone: string, date?: Date): number;
+/**
+ * List all unique timezones known to the system.
+ */
+declare function listAllTimezones(): string[];
+
+/**
+ * Proxy and Geo-Context Detector.
+ * Extracts country and geo information from residential proxy URLs, IP hints, or explicit ISO codes.
+ * Pure TypeScript, zero external dependencies.
+ */
+interface GeoDetectOptions {
+    /** Country code to fall back to if detection fails. Defaults to 'US'. */
+    fallbackCountry?: string;
+}
+/**
+ * ISO 3166-1 alpha-3 to alpha-2 code mapping.
+ */
+declare const ALPHA3_TO_ALPHA2: Record<string, string>;
+/**
+ * Common English country name aliases to ISO 3166-1 alpha-2 code.
+ */
+declare const COUNTRY_NAME_TO_CODE: Record<string, string>;
+/**
+ * Normalize any country input (2-letter, 3-letter, alias, name) to an ISO 3166-1 alpha-2 uppercase code.
+ */
+declare function normalizeCountryCode(code?: string | null): string | null;
+/**
+ * Extract an ISO country code from a residential proxy URL or connection string.
+ * Supports:
+ * - Username authentication tokens (e.g. user-country-us, customer-zone-cc-DE, lum-customer-*-country-fr)
+ * - Query parameters (e.g. ?country=JP, &country_code=KR, ?cc=SG, &geo=DE)
+ * - Subdomain patterns (e.g. us.smartproxy.com, jp.proxy-seller.com)
+ */
+declare function extractCountryFromProxyUrl(url: string): string | null;
+/**
+ * Universal country detector.
+ * Accepts:
+ * - Explicit ISO 3166-1 alpha-2 / alpha-3 codes ('US', 'GB', 'jp', 'JPN')
+ * - Country names ('Japan', 'United States', 'Germany')
+ * - Residential proxy URLs (http://user-country-us:pass@proxy...)
+ * - IANA Timezone strings ('America/New_York' -> 'US', 'Asia/Tokyo' -> 'JP')
+ * - Falls back to DEFAULT_COUNTRY ('US') when unknown.
+ */
+declare function detectCountry(input?: string | null, options?: GeoDetectOptions): string;
+
+/**
+ * Geo-Chrono Aligner.
+ * Aligns browser persona parameters (country, timezone, locale, accept-language header)
+ * with zero contradictions for stealth crawlers and automation.
+ * Pure TypeScript, zero external dependencies.
+ */
+
+/**
+ * Align geographic and chronological parameters into a cohesive, contradiction-free GeoContext.
+ *
+ * @param geoInput Proxy URL, ISO country code, IANA timezone string, or GeoOptions object
+ * @returns Fully correlated GeoContext
+ */
+declare function alignGeoContext(geoInput?: string | GeoOptions): GeoContext;
+/**
+ * Verify whether a partial or full GeoContext is free of geographic or chronological contradictions.
+ */
+declare function isGeoAligned(context: Partial<GeoContext>): boolean;
+/**
+ * Format GeoContext into a LocaleProfile for runtime device-passport consumers.
+ */
+declare function toLocaleProfile(geo: GeoContext): {
+    language: string;
+    languages: string[];
+    timezone: string;
+    timezoneOffset: number;
+    country: string;
+    currency: string | undefined;
+};
+/**
+ * Format GeoContext into a GeoLocation object for browser geolocation emulation.
+ */
+declare function toGeoLocation(geo: GeoContext): {
+    latitude: number;
+    longitude: number;
+    accuracy: number;
+    country: string;
+    countryCode: string;
+    timezone: string;
+    locale: string;
+    languages: string[];
+};
+
+/**
+ * Geo and Chrono Aligner module for Device Passport.
+ * Provides geographic-locale mapping database, proxy/IP geo detector,
+ * and zero-contradiction geo-chrono alignment.
+ */
+
+declare const GEO_LOCALES: Record<string, CountryLocaleConfig>;
+declare const TIMEZONE_MATRIX: Record<string, string>;
+declare const isValidCountryCode: typeof hasCountryConfig;
+/**
+ * Detect country code from residential proxy URL.
+ */
+declare function detectGeoFromUrl(url: string): string | null;
+/**
+ * Get a complete LocaleProfile for a country code and optional timezone.
+ */
+declare function getLocaleProfile(countryCode?: string | null, timezone?: string): LocaleProfile;
+
+export { ALPHA3_TO_ALPHA2, COUNTRY_LOCALES, COUNTRY_NAME_TO_CODE, DEFAULT_ACCEPT_LANGUAGE, DEFAULT_COUNTRY, DEFAULT_LOCALE, DEFAULT_TIMEZONE, GEO_LOCALES, GeoContext, GeoOptions, TIMEZONE_MATRIX, TIMEZONE_TO_COUNTRY, alignGeoContext, detectCountry, detectGeoFromUrl, extractCountryFromProxyUrl, formatAcceptLanguage, getAllSupportedCountries, getCountryConfig, getCountryForTimezone, getDefaultTimezoneForCountry, getLocaleProfile, getTimezoneOffsetMinutes, getTimezonesForCountry, hasCountryConfig, isGeoAligned, isTimezoneAlignedWithCountry, isValidCountryCode, isValidTimezone, listAllTimezones, normalizeCountryCode, parseAcceptLanguage, toGeoLocation, toLocaleProfile };
+export type { CountryLocaleConfig, GeoDetectOptions };