@voyantjs/utils 0.1.0

package/dist/geographic-regions.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Geographic region utilities for filtering products by world regions.
+ *
+ * Regions follow the UN geoscheme (M49) standard:
+ * - af: Africa
+ * - an: Antarctica
+ * - as: Asia
+ * - eu: Europe
+ * - na: North America
+ * - oc: Oceania
+ * - sa: South America
+ * - me: Middle East (custom, subset of Asia/Africa)
+ */
+/**
+ * Geographic region codes
+ */
+export type GeographicRegionCode = "af" | "an" | "as" | "eu" | "na" | "oc" | "sa" | "me";
+/**
+ * Geographic region metadata
+ */
+export interface GeographicRegion {
+    code: GeographicRegionCode;
+    name: string;
+}
+/**
+ * All available geographic regions
+ */
+export declare const GEOGRAPHIC_REGIONS: GeographicRegion[];
+/**
+ * Get the geographic region for a country code.
+ *
+ * @param countryCode - ISO 3166-1 alpha-2 country code (e.g., "RO", "EG")
+ * @returns Geographic region code or null if not found
+ *
+ * @example
+ * getGeographicRegion("RO") // "eu"
+ * getGeographicRegion("EG") // "af"
+ * getGeographicRegion("AE") // "me"
+ */
+export declare function getGeographicRegion(countryCode: string): GeographicRegionCode | null;
+/**
+ * Get all country codes for a geographic region.
+ *
+ * @param region - Geographic region code (e.g., "eu", "af")
+ * @returns Array of ISO 3166-1 alpha-2 country codes
+ *
+ * @example
+ * getCountriesByRegion("eu") // ["AL", "AD", "AT", ...]
+ * getCountriesByRegion("me") // ["BH", "IR", "IQ", ...]
+ */
+export declare function getCountriesByRegion(region: GeographicRegionCode): string[];
+/**
+ * Check if a string is a valid geographic region code.
+ *
+ * @param code - String to check
+ * @returns True if the code is a valid region code
+ */
+export declare function isValidRegionCode(code: string): code is GeographicRegionCode;
+/**
+ * Get region metadata by code.
+ *
+ * @param code - Geographic region code
+ * @returns Region metadata or null if not found
+ */
+export declare function getRegionByCode(code: string): GeographicRegion | null;
+//# sourceMappingURL=geographic-regions.d.ts.map

package/dist/geographic-regions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geographic-regions.d.ts","sourceRoot":"","sources":["../src/geographic-regions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AAExF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,oBAAoB,CAAA;IAC1B,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,gBAAgB,EAShD,CAAA;AAuQD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAIpF;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,EAAE,CAE3E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,oBAAoB,CAE5E;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAErE"}

package/dist/geographic-regions.js

@@ -0,0 +1,326 @@
+/**
+ * Geographic region utilities for filtering products by world regions.
+ *
+ * Regions follow the UN geoscheme (M49) standard:
+ * - af: Africa
+ * - an: Antarctica
+ * - as: Asia
+ * - eu: Europe
+ * - na: North America
+ * - oc: Oceania
+ * - sa: South America
+ * - me: Middle East (custom, subset of Asia/Africa)
+ */
+/**
+ * All available geographic regions
+ */
+export const GEOGRAPHIC_REGIONS = [
+    { code: "af", name: "Africa" },
+    { code: "an", name: "Antarctica" },
+    { code: "as", name: "Asia" },
+    { code: "eu", name: "Europe" },
+    { code: "na", name: "North America" },
+    { code: "oc", name: "Oceania" },
+    { code: "sa", name: "South America" },
+    { code: "me", name: "Middle East" },
+];
+/**
+ * Country codes grouped by geographic region
+ * ISO 3166-1 alpha-2 country codes
+ */
+const REGION_COUNTRIES = {
+    // Africa
+    af: [
+        "DZ",
+        "AO",
+        "BJ",
+        "BW",
+        "BF",
+        "BI",
+        "CV",
+        "CM",
+        "CF",
+        "TD",
+        "KM",
+        "CG",
+        "CD",
+        "CI",
+        "DJ",
+        "EG",
+        "GQ",
+        "ER",
+        "SZ",
+        "ET",
+        "GA",
+        "GM",
+        "GH",
+        "GN",
+        "GW",
+        "KE",
+        "LS",
+        "LR",
+        "LY",
+        "MG",
+        "MW",
+        "ML",
+        "MR",
+        "MU",
+        "YT",
+        "MA",
+        "MZ",
+        "NA",
+        "NE",
+        "NG",
+        "RW",
+        "RE",
+        "SH",
+        "ST",
+        "SN",
+        "SC",
+        "SL",
+        "SO",
+        "ZA",
+        "SS",
+        "SD",
+        "TZ",
+        "TG",
+        "TN",
+        "UG",
+        "EH",
+        "ZM",
+        "ZW",
+    ],
+    // Antarctica
+    an: ["AQ", "BV", "GS", "HM", "TF"],
+    // Asia (excluding Middle East countries)
+    as: [
+        "AF",
+        "AM",
+        "AZ",
+        "BD",
+        "BT",
+        "BN",
+        "KH",
+        "CN",
+        "CY",
+        "GE",
+        "HK",
+        "IN",
+        "ID",
+        "JP",
+        "KZ",
+        "KP",
+        "KR",
+        "KG",
+        "LA",
+        "MO",
+        "MY",
+        "MV",
+        "MN",
+        "MM",
+        "NP",
+        "PK",
+        "PH",
+        "SG",
+        "LK",
+        "TW",
+        "TJ",
+        "TH",
+        "TL",
+        "TM",
+        "UZ",
+        "VN",
+    ],
+    // Europe
+    eu: [
+        "AL",
+        "AD",
+        "AT",
+        "BY",
+        "BE",
+        "BA",
+        "BG",
+        "HR",
+        "CZ",
+        "DK",
+        "EE",
+        "FO",
+        "FI",
+        "FR",
+        "DE",
+        "GI",
+        "GR",
+        "GG",
+        "HU",
+        "IS",
+        "IE",
+        "IM",
+        "IT",
+        "JE",
+        "XK",
+        "LV",
+        "LI",
+        "LT",
+        "LU",
+        "MT",
+        "MD",
+        "MC",
+        "ME",
+        "NL",
+        "MK",
+        "NO",
+        "PL",
+        "PT",
+        "RO",
+        "RU",
+        "SM",
+        "RS",
+        "SK",
+        "SI",
+        "ES",
+        "SJ",
+        "SE",
+        "CH",
+        "UA",
+        "GB",
+        "VA",
+        "AX",
+    ],
+    // North America (including Central America and Caribbean)
+    na: [
+        "AI",
+        "AG",
+        "AW",
+        "BS",
+        "BB",
+        "BZ",
+        "BM",
+        "CA",
+        "KY",
+        "CR",
+        "CU",
+        "CW",
+        "DM",
+        "DO",
+        "SV",
+        "GL",
+        "GD",
+        "GP",
+        "GT",
+        "HT",
+        "HN",
+        "JM",
+        "MQ",
+        "MX",
+        "MS",
+        "NI",
+        "PA",
+        "PR",
+        "BL",
+        "KN",
+        "LC",
+        "MF",
+        "PM",
+        "VC",
+        "SX",
+        "TT",
+        "TC",
+        "US",
+        "VI",
+        "VG",
+    ],
+    // Oceania (Australia, New Zealand, Pacific Islands)
+    oc: [
+        "AS",
+        "AU",
+        "CK",
+        "FJ",
+        "PF",
+        "GU",
+        "KI",
+        "MH",
+        "FM",
+        "NR",
+        "NC",
+        "NZ",
+        "NU",
+        "NF",
+        "MP",
+        "PW",
+        "PG",
+        "PN",
+        "WS",
+        "SB",
+        "TK",
+        "TO",
+        "TV",
+        "UM",
+        "VU",
+        "WF",
+        "CX",
+        "CC",
+    ],
+    // South America
+    sa: ["AR", "BO", "BR", "CL", "CO", "EC", "FK", "GF", "GY", "PY", "PE", "SR", "UY", "VE"],
+    // Middle East (custom region for travel industry)
+    me: ["BH", "IR", "IQ", "IL", "JO", "KW", "LB", "OM", "PS", "QA", "SA", "SY", "TR", "AE", "YE"],
+};
+/**
+ * Reverse lookup: country code to region
+ */
+const COUNTRY_TO_REGION = new Map();
+// Build reverse lookup
+for (const [region, countries] of Object.entries(REGION_COUNTRIES)) {
+    for (const country of countries) {
+        COUNTRY_TO_REGION.set(country, region);
+    }
+}
+/**
+ * Get the geographic region for a country code.
+ *
+ * @param countryCode - ISO 3166-1 alpha-2 country code (e.g., "RO", "EG")
+ * @returns Geographic region code or null if not found
+ *
+ * @example
+ * getGeographicRegion("RO") // "eu"
+ * getGeographicRegion("EG") // "af"
+ * getGeographicRegion("AE") // "me"
+ */
+export function getGeographicRegion(countryCode) {
+    const normalized = countryCode?.trim().toUpperCase();
+    if (!normalized)
+        return null;
+    return COUNTRY_TO_REGION.get(normalized) ?? null;
+}
+/**
+ * Get all country codes for a geographic region.
+ *
+ * @param region - Geographic region code (e.g., "eu", "af")
+ * @returns Array of ISO 3166-1 alpha-2 country codes
+ *
+ * @example
+ * getCountriesByRegion("eu") // ["AL", "AD", "AT", ...]
+ * getCountriesByRegion("me") // ["BH", "IR", "IQ", ...]
+ */
+export function getCountriesByRegion(region) {
+    return REGION_COUNTRIES[region] ?? [];
+}
+/**
+ * Check if a string is a valid geographic region code.
+ *
+ * @param code - String to check
+ * @returns True if the code is a valid region code
+ */
+export function isValidRegionCode(code) {
+    return GEOGRAPHIC_REGIONS.some((r) => r.code === code);
+}
+/**
+ * Get region metadata by code.
+ *
+ * @param code - Geographic region code
+ * @returns Region metadata or null if not found
+ */
+export function getRegionByCode(code) {
+    return GEOGRAPHIC_REGIONS.find((r) => r.code === code) ?? null;
+}
+//# sourceMappingURL=geographic-regions.js.map

package/dist/geographic-regions.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./countries.js";
+export * from "./currencies.js";
+export * from "./geographic-regions.js";
+export * from "./kms.js";
+export * from "./kv.js";
+export * from "./languages.js";
+export * from "./localized-countries-regions.js";
+export * from "./timezones.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,yBAAyB,CAAA;AACvC,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kCAAkC,CAAA;AAChD,cAAc,gBAAgB,CAAA"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export * from "./countries.js";
+export * from "./currencies.js";
+export * from "./geographic-regions.js";
+export * from "./kms.js";
+export * from "./kv.js";
+export * from "./languages.js";
+export * from "./localized-countries-regions.js";
+export * from "./timezones.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,yBAAyB,CAAA;AACvC,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kCAAkC,CAAA;AAChD,cAAc,gBAAgB,CAAA"}

package/dist/kms-aws.d.ts

@@ -0,0 +1,26 @@
+/**
+ * AWS KMS provider using SigV4-signed HTTPS requests.
+ *
+ * Works in Workers and modern Node without AWS SDK dependencies.
+ */
+import type { KeyRef, KmsKeyType, KmsProvider } from "./kms.js";
+export interface AwsKmsConfig {
+    region: string;
+    accessKeyId: string;
+    secretAccessKey: string;
+    sessionToken?: string;
+    endpoint?: string;
+    keyIdByType: Record<KmsKeyType, string>;
+}
+export declare class AwsKmsProvider implements KmsProvider {
+    private readonly config;
+    readonly name: "aws";
+    constructor(config: AwsKmsConfig);
+    private resolveKeyId;
+    private resolveEndpoint;
+    private signedHeaders;
+    private callAws;
+    encrypt(plaintext: string, key: KeyRef): Promise<string>;
+    decrypt(ciphertext: string, key: KeyRef): Promise<string>;
+}
+//# sourceMappingURL=kms-aws.d.ts.map

package/dist/kms-aws.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kms-aws.d.ts","sourceRoot":"","sources":["../src/kms-aws.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAM/D,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,eAAe,EAAE,MAAM,CAAA;IACvB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;CACxC;AAkDD,qBAAa,cAAe,YAAW,WAAW;IAGpC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,QAAQ,CAAC,IAAI,EAAG,KAAK,CAAS;gBAED,MAAM,EAAE,YAAY;IAEjD,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,eAAe;YAIT,aAAa;YAyDb,OAAO;IAgBf,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASxD,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAchE"}

package/dist/kms-aws.js

@@ -0,0 +1,133 @@
+/**
+ * AWS KMS provider using SigV4-signed HTTPS requests.
+ *
+ * Works in Workers and modern Node without AWS SDK dependencies.
+ */
+const PREFIX = "aws:v1:";
+const SERVICE = "kms";
+const JSON_CONTENT_TYPE = "application/x-amz-json-1.1";
+function toHex(bytes) {
+    return Array.from(bytes)
+        .map((byte) => byte.toString(16).padStart(2, "0"))
+        .join("");
+}
+async function sha256Hex(input) {
+    const digest = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(input));
+    return toHex(new Uint8Array(digest));
+}
+async function hmacSha256Raw(key, message) {
+    const raw = new Uint8Array(key.byteLength);
+    raw.set(key);
+    const cryptoKey = await crypto.subtle.importKey("raw", raw.buffer, { name: "HMAC", hash: "SHA-256" }, false, ["sign"]);
+    const signature = await crypto.subtle.sign("HMAC", cryptoKey, new TextEncoder().encode(message));
+    return new Uint8Array(signature);
+}
+async function deriveSigningKey(secretAccessKey, dateStamp, region) {
+    const kDate = await hmacSha256Raw(new TextEncoder().encode(`AWS4${secretAccessKey}`), dateStamp);
+    const kRegion = await hmacSha256Raw(kDate, region);
+    const kService = await hmacSha256Raw(kRegion, SERVICE);
+    return hmacSha256Raw(kService, "aws4_request");
+}
+function formatAmzDate(date) {
+    const iso = date.toISOString().replace(/[:-]|\.\d{3}/g, "");
+    return {
+        amzDate: iso,
+        dateStamp: iso.slice(0, 8),
+    };
+}
+function joinHeaders(headers) {
+    return headers.map(([name, value]) => `${name}:${value.trim()}\n`).join("");
+}
+export class AwsKmsProvider {
+    config;
+    name = "aws";
+    constructor(config) {
+        this.config = config;
+    }
+    resolveKeyId(key) {
+        return this.config.keyIdByType[key.keyType];
+    }
+    resolveEndpoint() {
+        return this.config.endpoint ?? `https://kms.${this.config.region}.amazonaws.com/`;
+    }
+    async signedHeaders(target, body) {
+        const endpoint = new URL(this.resolveEndpoint());
+        const now = new Date();
+        const { amzDate, dateStamp } = formatAmzDate(now);
+        const payloadHash = await sha256Hex(body);
+        const headers = [
+            ["content-type", JSON_CONTENT_TYPE],
+            ["host", endpoint.host],
+            ["x-amz-date", amzDate],
+            ["x-amz-target", target],
+        ];
+        if (this.config.sessionToken) {
+            headers.push(["x-amz-security-token", this.config.sessionToken]);
+        }
+        headers.sort(([a], [b]) => a.localeCompare(b));
+        const canonicalHeaders = joinHeaders(headers);
+        const signedHeaders = headers.map(([name]) => name).join(";");
+        const canonicalRequest = [
+            "POST",
+            endpoint.pathname || "/",
+            "",
+            canonicalHeaders,
+            signedHeaders,
+            payloadHash,
+        ].join("\n");
+        const credentialScope = `${dateStamp}/${this.config.region}/${SERVICE}/aws4_request`;
+        const stringToSign = [
+            "AWS4-HMAC-SHA256",
+            amzDate,
+            credentialScope,
+            await sha256Hex(canonicalRequest),
+        ].join("\n");
+        const signingKey = await deriveSigningKey(this.config.secretAccessKey, dateStamp, this.config.region);
+        const signature = toHex(await hmacSha256Raw(signingKey, stringToSign));
+        const authorization = [
+            `AWS4-HMAC-SHA256 Credential=${this.config.accessKeyId}/${credentialScope}`,
+            `SignedHeaders=${signedHeaders}`,
+            `Signature=${signature}`,
+        ].join(", ");
+        return {
+            endpoint: endpoint.toString(),
+            headers: Object.fromEntries([
+                ...headers,
+                ["authorization", authorization],
+            ]),
+        };
+    }
+    async callAws(target, body) {
+        const signed = await this.signedHeaders(target, body);
+        const res = await fetch(signed.endpoint, {
+            method: "POST",
+            headers: signed.headers,
+            body,
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`AWS KMS ${target} failed (${res.status}): ${text}`);
+        }
+        return (await res.json());
+    }
+    async encrypt(plaintext, key) {
+        const body = JSON.stringify({
+            KeyId: this.resolveKeyId(key),
+            Plaintext: btoa(plaintext),
+        });
+        const data = await this.callAws("TrentService.Encrypt", body);
+        return `${PREFIX}${data.CiphertextBlob}`;
+    }
+    async decrypt(ciphertext, key) {
+        if (!ciphertext.startsWith(PREFIX)) {
+            throw new Error(`AwsKmsProvider: ciphertext missing "${PREFIX}" prefix — was it encrypted by a different provider?`);
+        }
+        const body = JSON.stringify({
+            KeyId: this.resolveKeyId(key),
+            CiphertextBlob: ciphertext.slice(PREFIX.length),
+        });
+        const data = await this.callAws("TrentService.Decrypt", body);
+        return atob(data.Plaintext);
+    }
+}
+//# sourceMappingURL=kms-aws.js.map

package/dist/kms-aws.js.map

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

package/dist/kms-crypto.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Edge-compatible GCP KMS encryption/decryption using Web Crypto API.
+ * No Node.js dependencies — works in Cloudflare Workers.
+ */
+/**
+ * Creates a signed JWT assertion and exchanges it at Google's OAuth2 endpoint
+ * for a short-lived access token. Caches the token at module level.
+ */
+export declare function getGcpAccessToken(email: string, privateKeyPem: string): Promise<string>;
+/**
+ * Encrypt plaintext using GCP Cloud KMS.
+ * Returns base64 ciphertext string.
+ */
+export declare function kmsEncrypt(plaintext: string, keyName: string, accessToken: string): Promise<string>;
+/**
+ * Decrypt ciphertext using GCP Cloud KMS.
+ * Returns plaintext string.
+ */
+export declare function kmsDecrypt(ciphertext: string, keyName: string, accessToken: string): Promise<string>;
+//# sourceMappingURL=kms-crypto.d.ts.map

package/dist/kms-crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kms-crypto.d.ts","sourceRoot":"","sources":["../src/kms-crypto.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA0CH;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA0C7F;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAiBjB"}