fakexy-to-json 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,148 @@
+# fakexy-to-json
+
+Fetch and parse [fakexy.com](https://www.fakexy.com/) data to JSON. Get fake addresses, profiles, and credit cards by country.
+
+**Important:** fakexy.com is protected by Cloudflare. You **must** pass a valid `cf_clearance` cookie to get real data. Without it, requests will return 403. See [Cloudflare cookie](#cloudflare-cookie) below for how to obtain it.
+
+## Install
+
+```bash
+npm install fakexy-to-json
+```
+
+## Usage
+
+```typescript
+import { getAddress, getProfile, getCreditCard } from 'fakexy-to-json';
+
+// Pass the cf_clearance cookie (required - see Cloudflare section below)
+const address = await getAddress({
+  countryCode: 'us',
+  headers: {
+    Cookie: 'cf_clearance=YOUR_COOKIE_VALUE',
+  },
+});
+console.log(address);
+// { street, city, region, zipcode, phone, country, latitude?, longitude?, person?, creditcard? }
+
+// Get a fake profile (US with state)
+const profile = await getProfile({
+  countryCode: 'us',
+  stateCode: 'ca',
+  headers: { Cookie: 'cf_clearance=YOUR_COOKIE_VALUE' },
+});
+console.log(profile);
+// { name, gender, birthday, ssn }
+
+// Get a fake credit card
+const card = await getCreditCard({
+  brand: 'visa',
+  headers: { Cookie: 'cf_clearance=YOUR_COOKIE_VALUE' },
+});
+console.log(card);
+// { brand, number, expire, cvv }
+```
+
+## Cloudflare cookie
+
+fakexy.com is behind Cloudflare. To get the `cf_clearance` cookie:
+
+1. Open [fakexy.com](https://www.fakexy.com/) in your browser
+2. Pass the "Just a moment..." challenge (wait for the page to load)
+3. Open DevTools → Application → Cookies → `https://www.fakexy.com`
+4. Copy the `cf_clearance` value
+5. Pass it in the `headers` option: `headers: { Cookie: 'cf_clearance=YOUR_VALUE' }`
+
+The cookie expires after some time; you'll need to refresh it when requests start failing again.
+
+## API
+
+### `getAddress(options?)`
+
+Fetches a fake address. Options:
+
+- `countryCode` – Two-letter country code (e.g. `'us'`, `'uk'`, `'de'`). Default: `'us'`
+- `stateCode` – State/region for countries that support it (e.g. `'ca'`, `'mi'` for US)
+- `headers` – Custom HTTP headers. **Required:** include `Cookie: cf_clearance=...` (see [Cloudflare cookie](#cloudflare-cookie))
+- `timeout` – Request timeout in ms (default: 10000)
+
+### `getProfile(options?)`
+
+Fetches a fake person profile. Options: same as `getAddress`.
+
+### `getCreditCard(options?)`
+
+Fetches a fake credit card. Options:
+
+- `brand` – `'visa'`, `'mastercard'`, `'amex'`, `'discover'`. Default: `'visa'`
+- `headers`, `timeout` – Same as above
+
+## Error Handling
+
+The package throws typed errors you can catch and handle:
+
+```typescript
+import {
+  getAddress,
+  FakexyNetworkError,
+  FakexyHttpError,
+  FakexyParseError,
+} from 'fakexy-to-json';
+
+try {
+  const address = await getAddress({
+    countryCode: 'us',
+    headers: { Cookie: 'cf_clearance=YOUR_VALUE' },
+  });
+} catch (err) {
+  if (err instanceof FakexyNetworkError) {
+    console.error('Network failed:', err.url, err.cause);
+  } else if (err instanceof FakexyHttpError) {
+    console.error('HTTP error:', err.status, err.url);
+  } else if (err instanceof FakexyParseError) {
+    console.error('Parse failed - site structure may have changed');
+  }
+}
+```
+
+## Chrome Extension
+
+The package works in Chrome extension **background scripts** or **service workers**. Add `host_permissions` to your `manifest.json`:
+
+```json
+{
+  "manifest_version": 3,
+  "host_permissions": ["https://www.fakexy.com/*"]
+}
+```
+
+**Note:** Content scripts run in page context and are subject to CORS. Call the package from the background script and use `chrome.runtime.sendMessage` to pass results to content scripts or popup. Use the `chrome.cookies` API to read `cf_clearance` for fakexy.com and pass it in headers.
+
+## Types
+
+All types are exported for use in your code:
+
+```typescript
+import type {
+  AddressResult,
+  PersonResult,
+  CreditCardResult,
+} from 'fakexy-to-json';
+```
+
+## Supported Countries
+
+Use `SUPPORTED_COUNTRIES` for the full list:
+
+```typescript
+import { SUPPORTED_COUNTRIES } from 'fakexy-to-json';
+// ['ar', 'au', 'bd', 'be', 'br', 'ca', 'cn', ...]
+```
+
+## Disclaimer
+
+This package is unofficial and not affiliated with, endorsed by, or sponsored by [fakexy.com](https://www.fakexy.com/). You are responsible for complying with fakexy.com's terms of service and acceptable use policies when using this library, and for using any data only in lawful ways.
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,175 @@
+/**
+ * Base options shared by all generators.
+ */
+interface BaseOptions {
+    /** Custom HTTP headers (e.g. User-Agent, Cookie for Cloudflare workarounds) */
+    headers?: Record<string, string>;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Options for address generator.
+ */
+interface AddressOptions extends BaseOptions {
+    /** Two-letter country code (e.g. 'us', 'uk', 'de') */
+    countryCode?: string;
+    /** State/region code for countries that support it (e.g. 'ca', 'mi' for US) */
+    stateCode?: string;
+}
+/**
+ * Options for profile/name generator.
+ */
+interface ProfileOptions extends BaseOptions {
+    /** Two-letter country code (e.g. 'us', 'uk') */
+    countryCode?: string;
+    /** State code for US (e.g. 'ca', 'mi') */
+    stateCode?: string;
+}
+/**
+ * Options for credit card generator.
+ */
+interface CreditCardOptions extends BaseOptions {
+    /** Card brand: 'visa', 'mastercard', etc. */
+    brand?: string;
+}
+/**
+ * Person/profile result from fakexy.com.
+ */
+interface PersonResult {
+    name: string;
+    gender: string;
+    birthday: string;
+    ssn: string;
+}
+/**
+ * Credit card result from fakexy.com.
+ */
+interface CreditCardResult {
+    brand: string;
+    number: string;
+    expire: string;
+    cvv: string;
+}
+/**
+ * Address result from fakexy.com.
+ */
+interface AddressResult {
+    street: string;
+    city: string;
+    region: string;
+    zipcode: string;
+    phone: string;
+    country: string;
+    latitude?: string;
+    longitude?: string;
+    person?: PersonResult;
+    creditcard?: CreditCardResult;
+}
+
+/**
+ * Parses address HTML from fakexy.com into AddressResult.
+ * Use when you have HTML from a fetch (e.g. from page context).
+ */
+declare function parseAddressFromHtml(html: string, url?: string): AddressResult;
+/**
+ * Fetches a fake address from fakexy.com for the given country.
+ *
+ * @param options - Country code and optional state/region
+ * @returns Parsed address with street, city, zip, phone, and optionally person/creditcard
+ * @throws {FakexyNetworkError} When the request fails
+ * @throws {FakexyHttpError} When the server returns an error status
+ * @throws {FakexyParseError} When the page structure has changed
+ */
+declare function getAddress(options?: AddressOptions): Promise<AddressResult>;
+
+/**
+ * Fetches a fake person profile from fakexy.com.
+ *
+ * @param options - Country code and optional state (for US)
+ * @returns Parsed profile with name, gender, birthday, SSN
+ * @throws {FakexyNetworkError} When the request fails
+ * @throws {FakexyHttpError} When the server returns an error status
+ * @throws {FakexyParseError} When the page structure has changed
+ */
+declare function getProfile(options?: ProfileOptions): Promise<PersonResult>;
+
+/**
+ * Fetches a fake credit card from fakexy.com.
+ *
+ * @param options - Card brand (visa, mastercard, etc.)
+ * @returns Parsed credit card with brand, number, expire, cvv
+ * @throws {FakexyNetworkError} When the request fails
+ * @throws {FakexyHttpError} When the server returns an error status
+ * @throws {FakexyParseError} When the page structure has changed
+ */
+declare function getCreditCard(options?: CreditCardOptions): Promise<CreditCardResult>;
+
+/**
+ * Base error class for all fakexy-to-json errors.
+ */
+declare class FakexyError extends Error {
+    name: string;
+    constructor(message: string);
+}
+/**
+ * Thrown when a network request fails (fetch error, timeout).
+ */
+declare class FakexyNetworkError extends FakexyError {
+    readonly url: string;
+    readonly cause?: Error | undefined;
+    name: string;
+    constructor(message: string, url: string, cause?: Error | undefined);
+}
+/**
+ * Thrown when the server returns an error status (403, 404, 5xx).
+ */
+declare class FakexyHttpError extends FakexyError {
+    readonly status: number;
+    readonly statusText: string;
+    readonly url: string;
+    name: string;
+    constructor(message: string, status: number, statusText: string, url: string);
+}
+/**
+ * Thrown when the HTML structure has changed and cannot be parsed.
+ */
+declare class FakexyParseError extends FakexyError {
+    readonly url?: string | undefined;
+    name: string;
+    constructor(message: string, url?: string | undefined);
+}
+/**
+ * Thrown when options are invalid (e.g. invalid countryCode, brand).
+ */
+declare class FakexyValidationError extends FakexyError {
+    readonly field: string;
+    readonly value: unknown;
+    name: string;
+    constructor(message: string, field: string, value: unknown);
+}
+
+/**
+ * Supported country codes for fakexy.com generators.
+ * Based on the site's URL structure.
+ */
+declare const SUPPORTED_COUNTRIES: readonly ["ar", "au", "bd", "be", "br", "ca", "cn", "cz", "fr", "de", "gr", "hu", "in", "id", "ir", "it", "jp", "my", "mx", "np", "nl", "ng", "pe", "ph", "pl", "pt", "ro", "ru", "sa", "sg", "kr", "es", "se", "th", "tr", "ug", "ua", "uk", "us", "vn"];
+type SupportedCountryCode = (typeof SUPPORTED_COUNTRIES)[number];
+/**
+ * Supported credit card brands.
+ */
+declare const SUPPORTED_CREDIT_CARD_BRANDS: readonly ["visa", "mastercard", "amex", "discover"];
+type SupportedCreditCardBrand = (typeof SUPPORTED_CREDIT_CARD_BRANDS)[number];
+/**
+ * Build URL for address generator.
+ */
+declare function buildAddressUrl(countryCode?: string, stateCode?: string): string;
+/**
+ * Build URL for profile/name generator.
+ */
+declare function buildProfileUrl(countryCode?: string, stateCode?: string): string;
+/**
+ * Build URL for credit card generator.
+ */
+declare function buildCreditCardUrl(brand?: string): string;
+
+export { type AddressOptions, type AddressResult, type BaseOptions, type CreditCardOptions, type CreditCardResult, FakexyError, FakexyHttpError, FakexyNetworkError, FakexyParseError, FakexyValidationError, type PersonResult, type ProfileOptions, SUPPORTED_COUNTRIES, SUPPORTED_CREDIT_CARD_BRANDS, type SupportedCountryCode, type SupportedCreditCardBrand, buildAddressUrl, buildCreditCardUrl, buildProfileUrl, getAddress, getCreditCard, getProfile, parseAddressFromHtml };

package/dist/index.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Base options shared by all generators.
+ */
+interface BaseOptions {
+    /** Custom HTTP headers (e.g. User-Agent, Cookie for Cloudflare workarounds) */
+    headers?: Record<string, string>;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Options for address generator.
+ */
+interface AddressOptions extends BaseOptions {
+    /** Two-letter country code (e.g. 'us', 'uk', 'de') */
+    countryCode?: string;
+    /** State/region code for countries that support it (e.g. 'ca', 'mi' for US) */
+    stateCode?: string;
+}
+/**
+ * Options for profile/name generator.
+ */
+interface ProfileOptions extends BaseOptions {
+    /** Two-letter country code (e.g. 'us', 'uk') */
+    countryCode?: string;
+    /** State code for US (e.g. 'ca', 'mi') */
+    stateCode?: string;
+}
+/**
+ * Options for credit card generator.
+ */
+interface CreditCardOptions extends BaseOptions {
+    /** Card brand: 'visa', 'mastercard', etc. */
+    brand?: string;
+}
+/**
+ * Person/profile result from fakexy.com.
+ */
+interface PersonResult {
+    name: string;
+    gender: string;
+    birthday: string;
+    ssn: string;
+}
+/**
+ * Credit card result from fakexy.com.
+ */
+interface CreditCardResult {
+    brand: string;
+    number: string;
+    expire: string;
+    cvv: string;
+}
+/**
+ * Address result from fakexy.com.
+ */
+interface AddressResult {
+    street: string;
+    city: string;
+    region: string;
+    zipcode: string;
+    phone: string;
+    country: string;
+    latitude?: string;
+    longitude?: string;
+    person?: PersonResult;
+    creditcard?: CreditCardResult;
+}
+
+/**
+ * Parses address HTML from fakexy.com into AddressResult.
+ * Use when you have HTML from a fetch (e.g. from page context).
+ */
+declare function parseAddressFromHtml(html: string, url?: string): AddressResult;
+/**
+ * Fetches a fake address from fakexy.com for the given country.
+ *
+ * @param options - Country code and optional state/region
+ * @returns Parsed address with street, city, zip, phone, and optionally person/creditcard
+ * @throws {FakexyNetworkError} When the request fails
+ * @throws {FakexyHttpError} When the server returns an error status
+ * @throws {FakexyParseError} When the page structure has changed
+ */
+declare function getAddress(options?: AddressOptions): Promise<AddressResult>;
+
+/**
+ * Fetches a fake person profile from fakexy.com.
+ *
+ * @param options - Country code and optional state (for US)
+ * @returns Parsed profile with name, gender, birthday, SSN
+ * @throws {FakexyNetworkError} When the request fails
+ * @throws {FakexyHttpError} When the server returns an error status
+ * @throws {FakexyParseError} When the page structure has changed
+ */
+declare function getProfile(options?: ProfileOptions): Promise<PersonResult>;
+
+/**
+ * Fetches a fake credit card from fakexy.com.
+ *
+ * @param options - Card brand (visa, mastercard, etc.)
+ * @returns Parsed credit card with brand, number, expire, cvv
+ * @throws {FakexyNetworkError} When the request fails
+ * @throws {FakexyHttpError} When the server returns an error status
+ * @throws {FakexyParseError} When the page structure has changed
+ */
+declare function getCreditCard(options?: CreditCardOptions): Promise<CreditCardResult>;
+
+/**
+ * Base error class for all fakexy-to-json errors.
+ */
+declare class FakexyError extends Error {
+    name: string;
+    constructor(message: string);
+}
+/**
+ * Thrown when a network request fails (fetch error, timeout).
+ */
+declare class FakexyNetworkError extends FakexyError {
+    readonly url: string;
+    readonly cause?: Error | undefined;
+    name: string;
+    constructor(message: string, url: string, cause?: Error | undefined);
+}
+/**
+ * Thrown when the server returns an error status (403, 404, 5xx).
+ */
+declare class FakexyHttpError extends FakexyError {
+    readonly status: number;
+    readonly statusText: string;
+    readonly url: string;
+    name: string;
+    constructor(message: string, status: number, statusText: string, url: string);
+}
+/**
+ * Thrown when the HTML structure has changed and cannot be parsed.
+ */
+declare class FakexyParseError extends FakexyError {
+    readonly url?: string | undefined;
+    name: string;
+    constructor(message: string, url?: string | undefined);
+}
+/**
+ * Thrown when options are invalid (e.g. invalid countryCode, brand).
+ */
+declare class FakexyValidationError extends FakexyError {
+    readonly field: string;
+    readonly value: unknown;
+    name: string;
+    constructor(message: string, field: string, value: unknown);
+}
+
+/**
+ * Supported country codes for fakexy.com generators.
+ * Based on the site's URL structure.
+ */
+declare const SUPPORTED_COUNTRIES: readonly ["ar", "au", "bd", "be", "br", "ca", "cn", "cz", "fr", "de", "gr", "hu", "in", "id", "ir", "it", "jp", "my", "mx", "np", "nl", "ng", "pe", "ph", "pl", "pt", "ro", "ru", "sa", "sg", "kr", "es", "se", "th", "tr", "ug", "ua", "uk", "us", "vn"];
+type SupportedCountryCode = (typeof SUPPORTED_COUNTRIES)[number];
+/**
+ * Supported credit card brands.
+ */
+declare const SUPPORTED_CREDIT_CARD_BRANDS: readonly ["visa", "mastercard", "amex", "discover"];
+type SupportedCreditCardBrand = (typeof SUPPORTED_CREDIT_CARD_BRANDS)[number];
+/**
+ * Build URL for address generator.
+ */
+declare function buildAddressUrl(countryCode?: string, stateCode?: string): string;
+/**
+ * Build URL for profile/name generator.
+ */
+declare function buildProfileUrl(countryCode?: string, stateCode?: string): string;
+/**
+ * Build URL for credit card generator.
+ */
+declare function buildCreditCardUrl(brand?: string): string;
+
+export { type AddressOptions, type AddressResult, type BaseOptions, type CreditCardOptions, type CreditCardResult, FakexyError, FakexyHttpError, FakexyNetworkError, FakexyParseError, FakexyValidationError, type PersonResult, type ProfileOptions, SUPPORTED_COUNTRIES, SUPPORTED_CREDIT_CARD_BRANDS, type SupportedCountryCode, type SupportedCreditCardBrand, buildAddressUrl, buildCreditCardUrl, buildProfileUrl, getAddress, getCreditCard, getProfile, parseAddressFromHtml };

package/dist/index.js

@@ -0,0 +1,365 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  FakexyError: () => FakexyError,
+  FakexyHttpError: () => FakexyHttpError,
+  FakexyNetworkError: () => FakexyNetworkError,
+  FakexyParseError: () => FakexyParseError,
+  FakexyValidationError: () => FakexyValidationError,
+  SUPPORTED_COUNTRIES: () => SUPPORTED_COUNTRIES,
+  SUPPORTED_CREDIT_CARD_BRANDS: () => SUPPORTED_CREDIT_CARD_BRANDS,
+  buildAddressUrl: () => buildAddressUrl,
+  buildCreditCardUrl: () => buildCreditCardUrl,
+  buildProfileUrl: () => buildProfileUrl,
+  getAddress: () => getAddress,
+  getCreditCard: () => getCreditCard,
+  getProfile: () => getProfile,
+  parseAddressFromHtml: () => parseAddressFromHtml
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors.ts
+var FakexyError = class _FakexyError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "FakexyError";
+    Object.setPrototypeOf(this, _FakexyError.prototype);
+  }
+};
+var FakexyNetworkError = class _FakexyNetworkError extends FakexyError {
+  constructor(message, url, cause) {
+    super(message);
+    this.url = url;
+    this.cause = cause;
+    this.name = "FakexyNetworkError";
+    Object.setPrototypeOf(this, _FakexyNetworkError.prototype);
+  }
+};
+var FakexyHttpError = class _FakexyHttpError extends FakexyError {
+  constructor(message, status, statusText, url) {
+    super(message);
+    this.status = status;
+    this.statusText = statusText;
+    this.url = url;
+    this.name = "FakexyHttpError";
+    Object.setPrototypeOf(this, _FakexyHttpError.prototype);
+  }
+};
+var FakexyParseError = class _FakexyParseError extends FakexyError {
+  constructor(message, url) {
+    super(message);
+    this.url = url;
+    this.name = "FakexyParseError";
+    Object.setPrototypeOf(this, _FakexyParseError.prototype);
+  }
+};
+var FakexyValidationError = class _FakexyValidationError extends FakexyError {
+  constructor(message, field, value) {
+    super(message);
+    this.field = field;
+    this.value = value;
+    this.name = "FakexyValidationError";
+    Object.setPrototypeOf(this, _FakexyValidationError.prototype);
+  }
+};
+
+// src/fetch.ts
+var DEFAULT_TIMEOUT = 1e4;
+var DEFAULT_USER_AGENT = "Mozilla/5.0 (compatible; fakexy-to-json/1.0; +https://github.com/MaxioN03/fakexy-to-json)";
+async function fetchHtml(url, options = {}) {
+  const timeout = options.timeout ?? DEFAULT_TIMEOUT;
+  const headers = {
+    "User-Agent": DEFAULT_USER_AGENT,
+    Accept: "text/html,application/xhtml+xml",
+    ...options.headers
+  };
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), timeout);
+  try {
+    const response = await fetch(url, {
+      headers,
+      signal: controller.signal
+    });
+    clearTimeout(timeoutId);
+    if (!response.ok) {
+      throw new FakexyHttpError(
+        `HTTP ${response.status}: ${response.statusText}`,
+        response.status,
+        response.statusText,
+        url
+      );
+    }
+    return await response.text();
+  } catch (err) {
+    clearTimeout(timeoutId);
+    if (err instanceof FakexyHttpError) {
+      throw err;
+    }
+    const cause = err instanceof Error ? err : new Error(String(err));
+    const message = cause.name === "AbortError" ? `Request timed out after ${timeout}ms` : `Network request failed: ${cause.message}`;
+    throw new FakexyNetworkError(message, url, cause);
+  }
+}
+
+// src/parse.ts
+var cheerio = __toESM(require("cheerio"));
+function normalizeKey(label) {
+  return label.trim().toLowerCase().replace(/\s+/g, "_").replace(/[\/\-]/g, "_").replace(/_+/g, "_").replace(/^_|_$/g, "");
+}
+var LABEL_MAP = {
+  street: "street",
+  street_address: "street",
+  address: "street",
+  city: "city",
+  city_town: "city",
+  "city/town": "city",
+  state: "region",
+  state_province_region: "region",
+  "state/province/region": "region",
+  region: "region",
+  zip: "zipcode",
+  zip_postal_code: "zipcode",
+  "zip/postal_code": "zipcode",
+  zipcode: "zipcode",
+  postal_code: "zipcode",
+  phone: "phone",
+  phone_number: "phone",
+  country: "country",
+  latitude: "latitude",
+  longitude: "longitude",
+  full_name: "name",
+  name: "name",
+  gender: "gender",
+  birthday: "birthday",
+  birth_date: "birthday",
+  social_security_number: "ssn",
+  ssn: "ssn",
+  credit_card_brand: "brand",
+  brand: "brand",
+  credit_card_number: "number",
+  number: "number",
+  expire: "expire",
+  expiration: "expire",
+  cvv: "cvv"
+};
+function parseTablesToObject(html, url) {
+  const $ = cheerio.load(html);
+  const result = {};
+  $("table tr").each((_, row) => {
+    const cells = $(row).find("td, th").map((__, el) => $(el).text().trim()).get();
+    if (cells.length >= 2) {
+      const label = cells[0];
+      const value = cells[1];
+      if (label && value) {
+        const key = normalizeKey(label);
+        const canonicalKey = LABEL_MAP[key] ?? key;
+        result[canonicalKey] = value;
+      }
+    } else if (cells.length === 1) {
+    }
+  });
+  if (Object.keys(result).length === 0) {
+    throw new FakexyParseError(
+      "Could not parse any data from the page. The site structure may have changed.",
+      url
+    );
+  }
+  return result;
+}
+
+// src/url.ts
+var BASE_URL = "https://www.fakexy.com/";
+var SUPPORTED_COUNTRIES = [
+  "ar",
+  "au",
+  "bd",
+  "be",
+  "br",
+  "ca",
+  "cn",
+  "cz",
+  "fr",
+  "de",
+  "gr",
+  "hu",
+  "in",
+  "id",
+  "ir",
+  "it",
+  "jp",
+  "my",
+  "mx",
+  "np",
+  "nl",
+  "ng",
+  "pe",
+  "ph",
+  "pl",
+  "pt",
+  "ro",
+  "ru",
+  "sa",
+  "sg",
+  "kr",
+  "es",
+  "se",
+  "th",
+  "tr",
+  "ug",
+  "ua",
+  "uk",
+  "us",
+  "vn"
+];
+var SUPPORTED_CREDIT_CARD_BRANDS = [
+  "visa",
+  "mastercard",
+  "amex",
+  "discover"
+];
+function buildAddressUrl(countryCode, stateCode) {
+  const code = (countryCode ?? "us").toLowerCase();
+  if (stateCode) {
+    return `${BASE_URL}${code}-fake-address-generator-${stateCode.toLowerCase()}`;
+  }
+  return `${BASE_URL}fake-address-generator-${code}`;
+}
+function buildProfileUrl(countryCode, stateCode) {
+  const code = (countryCode ?? "us").toLowerCase();
+  if (stateCode) {
+    return `${BASE_URL}${code}-fake-name-generator-${stateCode.toLowerCase()}`;
+  }
+  return `${BASE_URL}fake-name-generator-${code}`;
+}
+function buildCreditCardUrl(brand) {
+  const b = (brand ?? "visa").toLowerCase();
+  return `${BASE_URL}fake-creditcard-generator-${b}`;
+}
+
+// src/generators/address.ts
+function mapRawToAddress(raw) {
+  const result = {
+    street: raw.street ?? raw.address ?? "",
+    city: raw.city ?? "",
+    region: raw.region ?? raw.state ?? "",
+    zipcode: raw.zipcode ?? raw.zip ?? raw.postal_code ?? "",
+    phone: raw.phone ?? raw.phone_number ?? "",
+    country: raw.country ?? ""
+  };
+  if (raw.latitude) result.latitude = raw.latitude;
+  if (raw.longitude) result.longitude = raw.longitude;
+  if (raw.name || raw.full_name) {
+    result.person = {
+      name: raw.name ?? raw.full_name ?? "",
+      gender: raw.gender ?? "",
+      birthday: raw.birthday ?? raw.birth_date ?? "",
+      ssn: raw.ssn ?? raw.social_security_number ?? ""
+    };
+  }
+  if (raw.brand || raw.number) {
+    result.creditcard = {
+      brand: raw.brand ?? raw.credit_card_brand ?? "",
+      number: raw.number ?? raw.credit_card_number ?? "",
+      expire: raw.expire ?? raw.expiration ?? "",
+      cvv: raw.cvv ?? ""
+    };
+  }
+  return result;
+}
+function parseAddressFromHtml(html, url) {
+  const raw = parseTablesToObject(html, url);
+  return mapRawToAddress(raw);
+}
+async function getAddress(options) {
+  const url = buildAddressUrl(options?.countryCode, options?.stateCode);
+  const html = await fetchHtml(url, {
+    headers: options?.headers,
+    timeout: options?.timeout
+  });
+  return parseAddressFromHtml(html, url);
+}
+
+// src/generators/profile.ts
+function mapRawToPerson(raw) {
+  return {
+    name: raw.name ?? raw.full_name ?? "",
+    gender: raw.gender ?? "",
+    birthday: raw.birthday ?? raw.birth_date ?? "",
+    ssn: raw.ssn ?? raw.social_security_number ?? ""
+  };
+}
+async function getProfile(options) {
+  const url = buildProfileUrl(options?.countryCode, options?.stateCode);
+  const html = await fetchHtml(url, {
+    headers: options?.headers,
+    timeout: options?.timeout
+  });
+  const raw = parseTablesToObject(html, url);
+  return mapRawToPerson(raw);
+}
+
+// src/generators/creditcard.ts
+function mapRawToCreditCard(raw) {
+  return {
+    brand: raw.brand ?? raw.credit_card_brand ?? "",
+    number: raw.number ?? raw.credit_card_number ?? "",
+    expire: raw.expire ?? raw.expiration ?? "",
+    cvv: raw.cvv ?? ""
+  };
+}
+async function getCreditCard(options) {
+  const url = buildCreditCardUrl(options?.brand);
+  const html = await fetchHtml(url, {
+    headers: options?.headers,
+    timeout: options?.timeout
+  });
+  const raw = parseTablesToObject(html, url);
+  return mapRawToCreditCard(raw);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FakexyError,
+  FakexyHttpError,
+  FakexyNetworkError,
+  FakexyParseError,
+  FakexyValidationError,
+  SUPPORTED_COUNTRIES,
+  SUPPORTED_CREDIT_CARD_BRANDS,
+  buildAddressUrl,
+  buildCreditCardUrl,
+  buildProfileUrl,
+  getAddress,
+  getCreditCard,
+  getProfile,
+  parseAddressFromHtml
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/fetch.ts","../src/parse.ts","../src/url.ts","../src/generators/address.ts","../src/generators/profile.ts","../src/generators/creditcard.ts"],"sourcesContent":["/**\n * fakexy-to-json\n *\n * Fetch and parse fakexy.com data to JSON.\n * Supports fake addresses, profiles, and credit cards by country.\n *\n * @packageDocumentation\n */\n\nexport { getAddress, parseAddressFromHtml } from './generators/address.js';\nexport { getProfile } from './generators/profile.js';\nexport { getCreditCard } from './generators/creditcard.js';\n\nexport {\n  FakexyError,\n  FakexyNetworkError,\n  FakexyHttpError,\n  FakexyParseError,\n  FakexyValidationError,\n} from './errors.js';\n\nexport {\n  buildAddressUrl,\n  buildProfileUrl,\n  buildCreditCardUrl,\n  SUPPORTED_COUNTRIES,\n  SUPPORTED_CREDIT_CARD_BRANDS,\n} from './url.js';\n\nexport type {\n  AddressResult,\n  PersonResult,\n  CreditCardResult,\n  AddressOptions,\n  ProfileOptions,\n  CreditCardOptions,\n  BaseOptions,\n} from './types.js';\n\nexport type { SupportedCountryCode, SupportedCreditCardBrand } from './url.js';\n","/**\n * Base error class for all fakexy-to-json errors.\n */\nexport class FakexyError extends Error {\n  override name = 'FakexyError';\n\n  constructor(message: string) {\n    super(message);\n    Object.setPrototypeOf(this, FakexyError.prototype);\n  }\n}\n\n/**\n * Thrown when a network request fails (fetch error, timeout).\n */\nexport class FakexyNetworkError extends FakexyError {\n  override name = 'FakexyNetworkError';\n\n  constructor(\n    message: string,\n    public readonly url: string,\n    public readonly cause?: Error,\n  ) {\n    super(message);\n    Object.setPrototypeOf(this, FakexyNetworkError.prototype);\n  }\n}\n\n/**\n * Thrown when the server returns an error status (403, 404, 5xx).\n */\nexport class FakexyHttpError extends FakexyError {\n  override name = 'FakexyHttpError';\n\n  constructor(\n    message: string,\n    public readonly status: number,\n    public readonly statusText: string,\n    public readonly url: string,\n  ) {\n    super(message);\n    Object.setPrototypeOf(this, FakexyHttpError.prototype);\n  }\n}\n\n/**\n * Thrown when the HTML structure has changed and cannot be parsed.\n */\nexport class FakexyParseError extends FakexyError {\n  override name = 'FakexyParseError';\n\n  constructor(\n    message: string,\n    public readonly url?: string,\n  ) {\n    super(message);\n    Object.setPrototypeOf(this, FakexyParseError.prototype);\n  }\n}\n\n/**\n * Thrown when options are invalid (e.g. invalid countryCode, brand).\n */\nexport class FakexyValidationError extends FakexyError {\n  override name = 'FakexyValidationError';\n\n  constructor(\n    message: string,\n    public readonly field: string,\n    public readonly value: unknown,\n  ) {\n    super(message);\n    Object.setPrototypeOf(this, FakexyValidationError.prototype);\n  }\n}\n","import { FakexyHttpError, FakexyNetworkError } from './errors.js';\n\nconst DEFAULT_TIMEOUT = 10000;\nconst DEFAULT_USER_AGENT =\n  'Mozilla/5.0 (compatible; fakexy-to-json/1.0; +https://github.com/MaxioN03/fakexy-to-json)';\n\nexport interface FetchOptions {\n  headers?: Record<string, string>;\n  timeout?: number;\n}\n\n/**\n * Fetch HTML from a URL with timeout and custom headers.\n * @throws {FakexyNetworkError} When fetch fails or times out\n * @throws {FakexyHttpError} When response status is not ok (4xx, 5xx)\n */\nexport async function fetchHtml(\n  url: string,\n  options: FetchOptions = {},\n): Promise<string> {\n  const timeout = options.timeout ?? DEFAULT_TIMEOUT;\n  const headers: Record<string, string> = {\n    'User-Agent': DEFAULT_USER_AGENT,\n    Accept: 'text/html,application/xhtml+xml',\n    ...options.headers,\n  };\n\n  const controller = new AbortController();\n  const timeoutId = setTimeout(() => controller.abort(), timeout);\n\n  try {\n    const response = await fetch(url, {\n      headers,\n      signal: controller.signal,\n    });\n    clearTimeout(timeoutId);\n\n    if (!response.ok) {\n      throw new FakexyHttpError(\n        `HTTP ${response.status}: ${response.statusText}`,\n        response.status,\n        response.statusText,\n        url,\n      );\n    }\n\n    return await response.text();\n  } catch (err) {\n    clearTimeout(timeoutId);\n\n    if (err instanceof FakexyHttpError) {\n      throw err;\n    }\n\n    const cause = err instanceof Error ? err : new Error(String(err));\n    const message =\n      cause.name === 'AbortError'\n        ? `Request timed out after ${timeout}ms`\n        : `Network request failed: ${cause.message}`;\n\n    throw new FakexyNetworkError(message, url, cause);\n  }\n}\n","import * as cheerio from 'cheerio';\nimport { FakexyParseError } from './errors.js';\n\n/**\n * Normalize a label to a consistent key format.\n */\nfunction normalizeKey(label: string): string {\n  return label\n    .trim()\n    .toLowerCase()\n    .replace(/\\s+/g, '_')\n    .replace(/[\\/\\-]/g, '_')\n    .replace(/_+/g, '_')\n    .replace(/^_|_$/g, '');\n}\n\n/**\n * Map common fakexy.com label variations to our canonical keys.\n */\nconst LABEL_MAP: Record<string, string> = {\n  street: 'street',\n  street_address: 'street',\n  address: 'street',\n  city: 'city',\n  city_town: 'city',\n  'city/town': 'city',\n  state: 'region',\n  state_province_region: 'region',\n  'state/province/region': 'region',\n  region: 'region',\n  zip: 'zipcode',\n  zip_postal_code: 'zipcode',\n  'zip/postal_code': 'zipcode',\n  zipcode: 'zipcode',\n  postal_code: 'zipcode',\n  phone: 'phone',\n  phone_number: 'phone',\n  country: 'country',\n  latitude: 'latitude',\n  longitude: 'longitude',\n  full_name: 'name',\n  name: 'name',\n  gender: 'gender',\n  birthday: 'birthday',\n  birth_date: 'birthday',\n  social_security_number: 'ssn',\n  ssn: 'ssn',\n  credit_card_brand: 'brand',\n  brand: 'brand',\n  credit_card_number: 'number',\n  number: 'number',\n  expire: 'expire',\n  expiration: 'expire',\n  cvv: 'cvv',\n};\n\n/**\n * Extract key-value pairs from HTML tables.\n * fakexy.com uses tables with label (th/td) and value (td) cells.\n */\nexport function parseTablesToObject(\n  html: string,\n  url?: string,\n): Record<string, string> {\n  const $ = cheerio.load(html);\n  const result: Record<string, string> = {};\n\n  $('table tr').each((_, row) => {\n    const cells = $(row)\n      .find('td, th')\n      .map((__, el) => $(el).text().trim())\n      .get();\n\n    if (cells.length >= 2) {\n      const label = cells[0];\n      const value = cells[1];\n      if (label && value) {\n        const key = normalizeKey(label);\n        const canonicalKey = LABEL_MAP[key] ?? key;\n        result[canonicalKey] = value;\n      }\n    } else if (cells.length === 1) {\n      // Some rows might have single cell - skip or use as key for next row\n      // For now we skip\n    }\n  });\n\n  if (Object.keys(result).length === 0) {\n    throw new FakexyParseError(\n      'Could not parse any data from the page. The site structure may have changed.',\n      url,\n    );\n  }\n\n  return result;\n}\n","const BASE_URL = 'https://www.fakexy.com/';\n\n/**\n * Supported country codes for fakexy.com generators.\n * Based on the site's URL structure.\n */\nexport const SUPPORTED_COUNTRIES = [\n  'ar',\n  'au',\n  'bd',\n  'be',\n  'br',\n  'ca',\n  'cn',\n  'cz',\n  'fr',\n  'de',\n  'gr',\n  'hu',\n  'in',\n  'id',\n  'ir',\n  'it',\n  'jp',\n  'my',\n  'mx',\n  'np',\n  'nl',\n  'ng',\n  'pe',\n  'ph',\n  'pl',\n  'pt',\n  'ro',\n  'ru',\n  'sa',\n  'sg',\n  'kr',\n  'es',\n  'se',\n  'th',\n  'tr',\n  'ug',\n  'ua',\n  'uk',\n  'us',\n  'vn',\n] as const;\n\nexport type SupportedCountryCode = (typeof SUPPORTED_COUNTRIES)[number];\n\n/**\n * Supported credit card brands.\n */\nexport const SUPPORTED_CREDIT_CARD_BRANDS = [\n  'visa',\n  'mastercard',\n  'amex',\n  'discover',\n] as const;\n\nexport type SupportedCreditCardBrand =\n  (typeof SUPPORTED_CREDIT_CARD_BRANDS)[number];\n\n/**\n * Build URL for address generator.\n */\nexport function buildAddressUrl(\n  countryCode?: string,\n  stateCode?: string,\n): string {\n  const code = (countryCode ?? 'us').toLowerCase();\n  if (stateCode) {\n    // US and UK use regional URLs: us-fake-address-generator-ca, uk-fake-address-generator-south-humberside\n    return `${BASE_URL}${code}-fake-address-generator-${stateCode.toLowerCase()}`;\n  }\n  return `${BASE_URL}fake-address-generator-${code}`;\n}\n\n/**\n * Build URL for profile/name generator.\n */\nexport function buildProfileUrl(\n  countryCode?: string,\n  stateCode?: string,\n): string {\n  const code = (countryCode ?? 'us').toLowerCase();\n  if (stateCode) {\n    return `${BASE_URL}${code}-fake-name-generator-${stateCode.toLowerCase()}`;\n  }\n  return `${BASE_URL}fake-name-generator-${code}`;\n}\n\n/**\n * Build URL for credit card generator.\n */\nexport function buildCreditCardUrl(brand?: string): string {\n  const b = (brand ?? 'visa').toLowerCase();\n  return `${BASE_URL}fake-creditcard-generator-${b}`;\n}\n","import { fetchHtml } from '../fetch.js';\nimport { parseTablesToObject } from '../parse.js';\nimport { buildAddressUrl } from '../url.js';\nimport type { AddressOptions, AddressResult } from '../types.js';\n\nfunction mapRawToAddress(raw: Record<string, string>): AddressResult {\n  const result: AddressResult = {\n    street: raw.street ?? raw.address ?? '',\n    city: raw.city ?? '',\n    region: raw.region ?? raw.state ?? '',\n    zipcode: raw.zipcode ?? raw.zip ?? raw.postal_code ?? '',\n    phone: raw.phone ?? raw.phone_number ?? '',\n    country: raw.country ?? '',\n  };\n\n  if (raw.latitude) result.latitude = raw.latitude;\n  if (raw.longitude) result.longitude = raw.longitude;\n\n  if (raw.name || raw.full_name) {\n    result.person = {\n      name: raw.name ?? raw.full_name ?? '',\n      gender: raw.gender ?? '',\n      birthday: raw.birthday ?? raw.birth_date ?? '',\n      ssn: raw.ssn ?? raw.social_security_number ?? '',\n    };\n  }\n\n  if (raw.brand || raw.number) {\n    result.creditcard = {\n      brand: raw.brand ?? raw.credit_card_brand ?? '',\n      number: raw.number ?? raw.credit_card_number ?? '',\n      expire: raw.expire ?? raw.expiration ?? '',\n      cvv: raw.cvv ?? '',\n    };\n  }\n\n  return result;\n}\n\n/**\n * Parses address HTML from fakexy.com into AddressResult.\n * Use when you have HTML from a fetch (e.g. from page context).\n */\nexport function parseAddressFromHtml(\n  html: string,\n  url?: string,\n): AddressResult {\n  const raw = parseTablesToObject(html, url);\n  return mapRawToAddress(raw);\n}\n\n/**\n * Fetches a fake address from fakexy.com for the given country.\n *\n * @param options - Country code and optional state/region\n * @returns Parsed address with street, city, zip, phone, and optionally person/creditcard\n * @throws {FakexyNetworkError} When the request fails\n * @throws {FakexyHttpError} When the server returns an error status\n * @throws {FakexyParseError} When the page structure has changed\n */\nexport async function getAddress(\n  options?: AddressOptions,\n): Promise<AddressResult> {\n  const url = buildAddressUrl(options?.countryCode, options?.stateCode);\n  const html = await fetchHtml(url, {\n    headers: options?.headers,\n    timeout: options?.timeout,\n  });\n  return parseAddressFromHtml(html, url);\n}\n","import { fetchHtml } from '../fetch.js';\nimport { parseTablesToObject } from '../parse.js';\nimport { buildProfileUrl } from '../url.js';\nimport type { PersonResult, ProfileOptions } from '../types.js';\n\nfunction mapRawToPerson(raw: Record<string, string>): PersonResult {\n  return {\n    name: raw.name ?? raw.full_name ?? '',\n    gender: raw.gender ?? '',\n    birthday: raw.birthday ?? raw.birth_date ?? '',\n    ssn: raw.ssn ?? raw.social_security_number ?? '',\n  };\n}\n\n/**\n * Fetches a fake person profile from fakexy.com.\n *\n * @param options - Country code and optional state (for US)\n * @returns Parsed profile with name, gender, birthday, SSN\n * @throws {FakexyNetworkError} When the request fails\n * @throws {FakexyHttpError} When the server returns an error status\n * @throws {FakexyParseError} When the page structure has changed\n */\nexport async function getProfile(\n  options?: ProfileOptions,\n): Promise<PersonResult> {\n  const url = buildProfileUrl(options?.countryCode, options?.stateCode);\n  const html = await fetchHtml(url, {\n    headers: options?.headers,\n    timeout: options?.timeout,\n  });\n  const raw = parseTablesToObject(html, url);\n  return mapRawToPerson(raw);\n}\n","import { fetchHtml } from '../fetch.js';\nimport { parseTablesToObject } from '../parse.js';\nimport { buildCreditCardUrl } from '../url.js';\nimport type { CreditCardOptions, CreditCardResult } from '../types.js';\n\nfunction mapRawToCreditCard(raw: Record<string, string>): CreditCardResult {\n  return {\n    brand: raw.brand ?? raw.credit_card_brand ?? '',\n    number: raw.number ?? raw.credit_card_number ?? '',\n    expire: raw.expire ?? raw.expiration ?? '',\n    cvv: raw.cvv ?? '',\n  };\n}\n\n/**\n * Fetches a fake credit card from fakexy.com.\n *\n * @param options - Card brand (visa, mastercard, etc.)\n * @returns Parsed credit card with brand, number, expire, cvv\n * @throws {FakexyNetworkError} When the request fails\n * @throws {FakexyHttpError} When the server returns an error status\n * @throws {FakexyParseError} When the page structure has changed\n */\nexport async function getCreditCard(\n  options?: CreditCardOptions,\n): Promise<CreditCardResult> {\n  const url = buildCreditCardUrl(options?.brand);\n  const html = await fetchHtml(url, {\n    headers: options?.headers,\n    timeout: options?.timeout,\n  });\n  const raw = parseTablesToObject(html, url);\n  return mapRawToCreditCard(raw);\n}\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -0,0 +1,315 @@
+// src/errors.ts
+var FakexyError = class _FakexyError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "FakexyError";
+    Object.setPrototypeOf(this, _FakexyError.prototype);
+  }
+};
+var FakexyNetworkError = class _FakexyNetworkError extends FakexyError {
+  constructor(message, url, cause) {
+    super(message);
+    this.url = url;
+    this.cause = cause;
+    this.name = "FakexyNetworkError";
+    Object.setPrototypeOf(this, _FakexyNetworkError.prototype);
+  }
+};
+var FakexyHttpError = class _FakexyHttpError extends FakexyError {
+  constructor(message, status, statusText, url) {
+    super(message);
+    this.status = status;
+    this.statusText = statusText;
+    this.url = url;
+    this.name = "FakexyHttpError";
+    Object.setPrototypeOf(this, _FakexyHttpError.prototype);
+  }
+};
+var FakexyParseError = class _FakexyParseError extends FakexyError {
+  constructor(message, url) {
+    super(message);
+    this.url = url;
+    this.name = "FakexyParseError";
+    Object.setPrototypeOf(this, _FakexyParseError.prototype);
+  }
+};
+var FakexyValidationError = class _FakexyValidationError extends FakexyError {
+  constructor(message, field, value) {
+    super(message);
+    this.field = field;
+    this.value = value;
+    this.name = "FakexyValidationError";
+    Object.setPrototypeOf(this, _FakexyValidationError.prototype);
+  }
+};
+
+// src/fetch.ts
+var DEFAULT_TIMEOUT = 1e4;
+var DEFAULT_USER_AGENT = "Mozilla/5.0 (compatible; fakexy-to-json/1.0; +https://github.com/MaxioN03/fakexy-to-json)";
+async function fetchHtml(url, options = {}) {
+  const timeout = options.timeout ?? DEFAULT_TIMEOUT;
+  const headers = {
+    "User-Agent": DEFAULT_USER_AGENT,
+    Accept: "text/html,application/xhtml+xml",
+    ...options.headers
+  };
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), timeout);
+  try {
+    const response = await fetch(url, {
+      headers,
+      signal: controller.signal
+    });
+    clearTimeout(timeoutId);
+    if (!response.ok) {
+      throw new FakexyHttpError(
+        `HTTP ${response.status}: ${response.statusText}`,
+        response.status,
+        response.statusText,
+        url
+      );
+    }
+    return await response.text();
+  } catch (err) {
+    clearTimeout(timeoutId);
+    if (err instanceof FakexyHttpError) {
+      throw err;
+    }
+    const cause = err instanceof Error ? err : new Error(String(err));
+    const message = cause.name === "AbortError" ? `Request timed out after ${timeout}ms` : `Network request failed: ${cause.message}`;
+    throw new FakexyNetworkError(message, url, cause);
+  }
+}
+
+// src/parse.ts
+import * as cheerio from "cheerio";
+function normalizeKey(label) {
+  return label.trim().toLowerCase().replace(/\s+/g, "_").replace(/[\/\-]/g, "_").replace(/_+/g, "_").replace(/^_|_$/g, "");
+}
+var LABEL_MAP = {
+  street: "street",
+  street_address: "street",
+  address: "street",
+  city: "city",
+  city_town: "city",
+  "city/town": "city",
+  state: "region",
+  state_province_region: "region",
+  "state/province/region": "region",
+  region: "region",
+  zip: "zipcode",
+  zip_postal_code: "zipcode",
+  "zip/postal_code": "zipcode",
+  zipcode: "zipcode",
+  postal_code: "zipcode",
+  phone: "phone",
+  phone_number: "phone",
+  country: "country",
+  latitude: "latitude",
+  longitude: "longitude",
+  full_name: "name",
+  name: "name",
+  gender: "gender",
+  birthday: "birthday",
+  birth_date: "birthday",
+  social_security_number: "ssn",
+  ssn: "ssn",
+  credit_card_brand: "brand",
+  brand: "brand",
+  credit_card_number: "number",
+  number: "number",
+  expire: "expire",
+  expiration: "expire",
+  cvv: "cvv"
+};
+function parseTablesToObject(html, url) {
+  const $ = cheerio.load(html);
+  const result = {};
+  $("table tr").each((_, row) => {
+    const cells = $(row).find("td, th").map((__, el) => $(el).text().trim()).get();
+    if (cells.length >= 2) {
+      const label = cells[0];
+      const value = cells[1];
+      if (label && value) {
+        const key = normalizeKey(label);
+        const canonicalKey = LABEL_MAP[key] ?? key;
+        result[canonicalKey] = value;
+      }
+    } else if (cells.length === 1) {
+    }
+  });
+  if (Object.keys(result).length === 0) {
+    throw new FakexyParseError(
+      "Could not parse any data from the page. The site structure may have changed.",
+      url
+    );
+  }
+  return result;
+}
+
+// src/url.ts
+var BASE_URL = "https://www.fakexy.com/";
+var SUPPORTED_COUNTRIES = [
+  "ar",
+  "au",
+  "bd",
+  "be",
+  "br",
+  "ca",
+  "cn",
+  "cz",
+  "fr",
+  "de",
+  "gr",
+  "hu",
+  "in",
+  "id",
+  "ir",
+  "it",
+  "jp",
+  "my",
+  "mx",
+  "np",
+  "nl",
+  "ng",
+  "pe",
+  "ph",
+  "pl",
+  "pt",
+  "ro",
+  "ru",
+  "sa",
+  "sg",
+  "kr",
+  "es",
+  "se",
+  "th",
+  "tr",
+  "ug",
+  "ua",
+  "uk",
+  "us",
+  "vn"
+];
+var SUPPORTED_CREDIT_CARD_BRANDS = [
+  "visa",
+  "mastercard",
+  "amex",
+  "discover"
+];
+function buildAddressUrl(countryCode, stateCode) {
+  const code = (countryCode ?? "us").toLowerCase();
+  if (stateCode) {
+    return `${BASE_URL}${code}-fake-address-generator-${stateCode.toLowerCase()}`;
+  }
+  return `${BASE_URL}fake-address-generator-${code}`;
+}
+function buildProfileUrl(countryCode, stateCode) {
+  const code = (countryCode ?? "us").toLowerCase();
+  if (stateCode) {
+    return `${BASE_URL}${code}-fake-name-generator-${stateCode.toLowerCase()}`;
+  }
+  return `${BASE_URL}fake-name-generator-${code}`;
+}
+function buildCreditCardUrl(brand) {
+  const b = (brand ?? "visa").toLowerCase();
+  return `${BASE_URL}fake-creditcard-generator-${b}`;
+}
+
+// src/generators/address.ts
+function mapRawToAddress(raw) {
+  const result = {
+    street: raw.street ?? raw.address ?? "",
+    city: raw.city ?? "",
+    region: raw.region ?? raw.state ?? "",
+    zipcode: raw.zipcode ?? raw.zip ?? raw.postal_code ?? "",
+    phone: raw.phone ?? raw.phone_number ?? "",
+    country: raw.country ?? ""
+  };
+  if (raw.latitude) result.latitude = raw.latitude;
+  if (raw.longitude) result.longitude = raw.longitude;
+  if (raw.name || raw.full_name) {
+    result.person = {
+      name: raw.name ?? raw.full_name ?? "",
+      gender: raw.gender ?? "",
+      birthday: raw.birthday ?? raw.birth_date ?? "",
+      ssn: raw.ssn ?? raw.social_security_number ?? ""
+    };
+  }
+  if (raw.brand || raw.number) {
+    result.creditcard = {
+      brand: raw.brand ?? raw.credit_card_brand ?? "",
+      number: raw.number ?? raw.credit_card_number ?? "",
+      expire: raw.expire ?? raw.expiration ?? "",
+      cvv: raw.cvv ?? ""
+    };
+  }
+  return result;
+}
+function parseAddressFromHtml(html, url) {
+  const raw = parseTablesToObject(html, url);
+  return mapRawToAddress(raw);
+}
+async function getAddress(options) {
+  const url = buildAddressUrl(options?.countryCode, options?.stateCode);
+  const html = await fetchHtml(url, {
+    headers: options?.headers,
+    timeout: options?.timeout
+  });
+  return parseAddressFromHtml(html, url);
+}
+
+// src/generators/profile.ts
+function mapRawToPerson(raw) {
+  return {
+    name: raw.name ?? raw.full_name ?? "",
+    gender: raw.gender ?? "",
+    birthday: raw.birthday ?? raw.birth_date ?? "",
+    ssn: raw.ssn ?? raw.social_security_number ?? ""
+  };
+}
+async function getProfile(options) {
+  const url = buildProfileUrl(options?.countryCode, options?.stateCode);
+  const html = await fetchHtml(url, {
+    headers: options?.headers,
+    timeout: options?.timeout
+  });
+  const raw = parseTablesToObject(html, url);
+  return mapRawToPerson(raw);
+}
+
+// src/generators/creditcard.ts
+function mapRawToCreditCard(raw) {
+  return {
+    brand: raw.brand ?? raw.credit_card_brand ?? "",
+    number: raw.number ?? raw.credit_card_number ?? "",
+    expire: raw.expire ?? raw.expiration ?? "",
+    cvv: raw.cvv ?? ""
+  };
+}
+async function getCreditCard(options) {
+  const url = buildCreditCardUrl(options?.brand);
+  const html = await fetchHtml(url, {
+    headers: options?.headers,
+    timeout: options?.timeout
+  });
+  const raw = parseTablesToObject(html, url);
+  return mapRawToCreditCard(raw);
+}
+export {
+  FakexyError,
+  FakexyHttpError,
+  FakexyNetworkError,
+  FakexyParseError,
+  FakexyValidationError,
+  SUPPORTED_COUNTRIES,
+  SUPPORTED_CREDIT_CARD_BRANDS,
+  buildAddressUrl,
+  buildCreditCardUrl,
+  buildProfileUrl,
+  getAddress,
+  getCreditCard,
+  getProfile,
+  parseAddressFromHtml
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/fetch.ts","../src/parse.ts","../src/url.ts","../src/generators/address.ts","../src/generators/profile.ts","../src/generators/creditcard.ts"],"sourcesContent":["/**\n * Base error class for all fakexy-to-json errors.\n */\nexport class FakexyError extends Error {\n  override name = 'FakexyError';\n\n  constructor(message: string) {\n    super(message);\n    Object.setPrototypeOf(this, FakexyError.prototype);\n  }\n}\n\n/**\n * Thrown when a network request fails (fetch error, timeout).\n */\nexport class FakexyNetworkError extends FakexyError {\n  override name = 'FakexyNetworkError';\n\n  constructor(\n    message: string,\n    public readonly url: string,\n    public readonly cause?: Error,\n  ) {\n    super(message);\n    Object.setPrototypeOf(this, FakexyNetworkError.prototype);\n  }\n}\n\n/**\n * Thrown when the server returns an error status (403, 404, 5xx).\n */\nexport class FakexyHttpError extends FakexyError {\n  override name = 'FakexyHttpError';\n\n  constructor(\n    message: string,\n    public readonly status: number,\n    public readonly statusText: string,\n    public readonly url: string,\n  ) {\n    super(message);\n    Object.setPrototypeOf(this, FakexyHttpError.prototype);\n  }\n}\n\n/**\n * Thrown when the HTML structure has changed and cannot be parsed.\n */\nexport class FakexyParseError extends FakexyError {\n  override name = 'FakexyParseError';\n\n  constructor(\n    message: string,\n    public readonly url?: string,\n  ) {\n    super(message);\n    Object.setPrototypeOf(this, FakexyParseError.prototype);\n  }\n}\n\n/**\n * Thrown when options are invalid (e.g. invalid countryCode, brand).\n */\nexport class FakexyValidationError extends FakexyError {\n  override name = 'FakexyValidationError';\n\n  constructor(\n    message: string,\n    public readonly field: string,\n    public readonly value: unknown,\n  ) {\n    super(message);\n    Object.setPrototypeOf(this, FakexyValidationError.prototype);\n  }\n}\n","import { FakexyHttpError, FakexyNetworkError } from './errors.js';\n\nconst DEFAULT_TIMEOUT = 10000;\nconst DEFAULT_USER_AGENT =\n  'Mozilla/5.0 (compatible; fakexy-to-json/1.0; +https://github.com/MaxioN03/fakexy-to-json)';\n\nexport interface FetchOptions {\n  headers?: Record<string, string>;\n  timeout?: number;\n}\n\n/**\n * Fetch HTML from a URL with timeout and custom headers.\n * @throws {FakexyNetworkError} When fetch fails or times out\n * @throws {FakexyHttpError} When response status is not ok (4xx, 5xx)\n */\nexport async function fetchHtml(\n  url: string,\n  options: FetchOptions = {},\n): Promise<string> {\n  const timeout = options.timeout ?? DEFAULT_TIMEOUT;\n  const headers: Record<string, string> = {\n    'User-Agent': DEFAULT_USER_AGENT,\n    Accept: 'text/html,application/xhtml+xml',\n    ...options.headers,\n  };\n\n  const controller = new AbortController();\n  const timeoutId = setTimeout(() => controller.abort(), timeout);\n\n  try {\n    const response = await fetch(url, {\n      headers,\n      signal: controller.signal,\n    });\n    clearTimeout(timeoutId);\n\n    if (!response.ok) {\n      throw new FakexyHttpError(\n        `HTTP ${response.status}: ${response.statusText}`,\n        response.status,\n        response.statusText,\n        url,\n      );\n    }\n\n    return await response.text();\n  } catch (err) {\n    clearTimeout(timeoutId);\n\n    if (err instanceof FakexyHttpError) {\n      throw err;\n    }\n\n    const cause = err instanceof Error ? err : new Error(String(err));\n    const message =\n      cause.name === 'AbortError'\n        ? `Request timed out after ${timeout}ms`\n        : `Network request failed: ${cause.message}`;\n\n    throw new FakexyNetworkError(message, url, cause);\n  }\n}\n","import * as cheerio from 'cheerio';\nimport { FakexyParseError } from './errors.js';\n\n/**\n * Normalize a label to a consistent key format.\n */\nfunction normalizeKey(label: string): string {\n  return label\n    .trim()\n    .toLowerCase()\n    .replace(/\\s+/g, '_')\n    .replace(/[\\/\\-]/g, '_')\n    .replace(/_+/g, '_')\n    .replace(/^_|_$/g, '');\n}\n\n/**\n * Map common fakexy.com label variations to our canonical keys.\n */\nconst LABEL_MAP: Record<string, string> = {\n  street: 'street',\n  street_address: 'street',\n  address: 'street',\n  city: 'city',\n  city_town: 'city',\n  'city/town': 'city',\n  state: 'region',\n  state_province_region: 'region',\n  'state/province/region': 'region',\n  region: 'region',\n  zip: 'zipcode',\n  zip_postal_code: 'zipcode',\n  'zip/postal_code': 'zipcode',\n  zipcode: 'zipcode',\n  postal_code: 'zipcode',\n  phone: 'phone',\n  phone_number: 'phone',\n  country: 'country',\n  latitude: 'latitude',\n  longitude: 'longitude',\n  full_name: 'name',\n  name: 'name',\n  gender: 'gender',\n  birthday: 'birthday',\n  birth_date: 'birthday',\n  social_security_number: 'ssn',\n  ssn: 'ssn',\n  credit_card_brand: 'brand',\n  brand: 'brand',\n  credit_card_number: 'number',\n  number: 'number',\n  expire: 'expire',\n  expiration: 'expire',\n  cvv: 'cvv',\n};\n\n/**\n * Extract key-value pairs from HTML tables.\n * fakexy.com uses tables with label (th/td) and value (td) cells.\n */\nexport function parseTablesToObject(\n  html: string,\n  url?: string,\n): Record<string, string> {\n  const $ = cheerio.load(html);\n  const result: Record<string, string> = {};\n\n  $('table tr').each((_, row) => {\n    const cells = $(row)\n      .find('td, th')\n      .map((__, el) => $(el).text().trim())\n      .get();\n\n    if (cells.length >= 2) {\n      const label = cells[0];\n      const value = cells[1];\n      if (label && value) {\n        const key = normalizeKey(label);\n        const canonicalKey = LABEL_MAP[key] ?? key;\n        result[canonicalKey] = value;\n      }\n    } else if (cells.length === 1) {\n      // Some rows might have single cell - skip or use as key for next row\n      // For now we skip\n    }\n  });\n\n  if (Object.keys(result).length === 0) {\n    throw new FakexyParseError(\n      'Could not parse any data from the page. The site structure may have changed.',\n      url,\n    );\n  }\n\n  return result;\n}\n","const BASE_URL = 'https://www.fakexy.com/';\n\n/**\n * Supported country codes for fakexy.com generators.\n * Based on the site's URL structure.\n */\nexport const SUPPORTED_COUNTRIES = [\n  'ar',\n  'au',\n  'bd',\n  'be',\n  'br',\n  'ca',\n  'cn',\n  'cz',\n  'fr',\n  'de',\n  'gr',\n  'hu',\n  'in',\n  'id',\n  'ir',\n  'it',\n  'jp',\n  'my',\n  'mx',\n  'np',\n  'nl',\n  'ng',\n  'pe',\n  'ph',\n  'pl',\n  'pt',\n  'ro',\n  'ru',\n  'sa',\n  'sg',\n  'kr',\n  'es',\n  'se',\n  'th',\n  'tr',\n  'ug',\n  'ua',\n  'uk',\n  'us',\n  'vn',\n] as const;\n\nexport type SupportedCountryCode = (typeof SUPPORTED_COUNTRIES)[number];\n\n/**\n * Supported credit card brands.\n */\nexport const SUPPORTED_CREDIT_CARD_BRANDS = [\n  'visa',\n  'mastercard',\n  'amex',\n  'discover',\n] as const;\n\nexport type SupportedCreditCardBrand =\n  (typeof SUPPORTED_CREDIT_CARD_BRANDS)[number];\n\n/**\n * Build URL for address generator.\n */\nexport function buildAddressUrl(\n  countryCode?: string,\n  stateCode?: string,\n): string {\n  const code = (countryCode ?? 'us').toLowerCase();\n  if (stateCode) {\n    // US and UK use regional URLs: us-fake-address-generator-ca, uk-fake-address-generator-south-humberside\n    return `${BASE_URL}${code}-fake-address-generator-${stateCode.toLowerCase()}`;\n  }\n  return `${BASE_URL}fake-address-generator-${code}`;\n}\n\n/**\n * Build URL for profile/name generator.\n */\nexport function buildProfileUrl(\n  countryCode?: string,\n  stateCode?: string,\n): string {\n  const code = (countryCode ?? 'us').toLowerCase();\n  if (stateCode) {\n    return `${BASE_URL}${code}-fake-name-generator-${stateCode.toLowerCase()}`;\n  }\n  return `${BASE_URL}fake-name-generator-${code}`;\n}\n\n/**\n * Build URL for credit card generator.\n */\nexport function buildCreditCardUrl(brand?: string): string {\n  const b = (brand ?? 'visa').toLowerCase();\n  return `${BASE_URL}fake-creditcard-generator-${b}`;\n}\n","import { fetchHtml } from '../fetch.js';\nimport { parseTablesToObject } from '../parse.js';\nimport { buildAddressUrl } from '../url.js';\nimport type { AddressOptions, AddressResult } from '../types.js';\n\nfunction mapRawToAddress(raw: Record<string, string>): AddressResult {\n  const result: AddressResult = {\n    street: raw.street ?? raw.address ?? '',\n    city: raw.city ?? '',\n    region: raw.region ?? raw.state ?? '',\n    zipcode: raw.zipcode ?? raw.zip ?? raw.postal_code ?? '',\n    phone: raw.phone ?? raw.phone_number ?? '',\n    country: raw.country ?? '',\n  };\n\n  if (raw.latitude) result.latitude = raw.latitude;\n  if (raw.longitude) result.longitude = raw.longitude;\n\n  if (raw.name || raw.full_name) {\n    result.person = {\n      name: raw.name ?? raw.full_name ?? '',\n      gender: raw.gender ?? '',\n      birthday: raw.birthday ?? raw.birth_date ?? '',\n      ssn: raw.ssn ?? raw.social_security_number ?? '',\n    };\n  }\n\n  if (raw.brand || raw.number) {\n    result.creditcard = {\n      brand: raw.brand ?? raw.credit_card_brand ?? '',\n      number: raw.number ?? raw.credit_card_number ?? '',\n      expire: raw.expire ?? raw.expiration ?? '',\n      cvv: raw.cvv ?? '',\n    };\n  }\n\n  return result;\n}\n\n/**\n * Parses address HTML from fakexy.com into AddressResult.\n * Use when you have HTML from a fetch (e.g. from page context).\n */\nexport function parseAddressFromHtml(\n  html: string,\n  url?: string,\n): AddressResult {\n  const raw = parseTablesToObject(html, url);\n  return mapRawToAddress(raw);\n}\n\n/**\n * Fetches a fake address from fakexy.com for the given country.\n *\n * @param options - Country code and optional state/region\n * @returns Parsed address with street, city, zip, phone, and optionally person/creditcard\n * @throws {FakexyNetworkError} When the request fails\n * @throws {FakexyHttpError} When the server returns an error status\n * @throws {FakexyParseError} When the page structure has changed\n */\nexport async function getAddress(\n  options?: AddressOptions,\n): Promise<AddressResult> {\n  const url = buildAddressUrl(options?.countryCode, options?.stateCode);\n  const html = await fetchHtml(url, {\n    headers: options?.headers,\n    timeout: options?.timeout,\n  });\n  return parseAddressFromHtml(html, url);\n}\n","import { fetchHtml } from '../fetch.js';\nimport { parseTablesToObject } from '../parse.js';\nimport { buildProfileUrl } from '../url.js';\nimport type { PersonResult, ProfileOptions } from '../types.js';\n\nfunction mapRawToPerson(raw: Record<string, string>): PersonResult {\n  return {\n    name: raw.name ?? raw.full_name ?? '',\n    gender: raw.gender ?? '',\n    birthday: raw.birthday ?? raw.birth_date ?? '',\n    ssn: raw.ssn ?? raw.social_security_number ?? '',\n  };\n}\n\n/**\n * Fetches a fake person profile from fakexy.com.\n *\n * @param options - Country code and optional state (for US)\n * @returns Parsed profile with name, gender, birthday, SSN\n * @throws {FakexyNetworkError} When the request fails\n * @throws {FakexyHttpError} When the server returns an error status\n * @throws {FakexyParseError} When the page structure has changed\n */\nexport async function getProfile(\n  options?: ProfileOptions,\n): Promise<PersonResult> {\n  const url = buildProfileUrl(options?.countryCode, options?.stateCode);\n  const html = await fetchHtml(url, {\n    headers: options?.headers,\n    timeout: options?.timeout,\n  });\n  const raw = parseTablesToObject(html, url);\n  return mapRawToPerson(raw);\n}\n","import { fetchHtml } from '../fetch.js';\nimport { parseTablesToObject } from '../parse.js';\nimport { buildCreditCardUrl } from '../url.js';\nimport type { CreditCardOptions, CreditCardResult } from '../types.js';\n\nfunction mapRawToCreditCard(raw: Record<string, string>): CreditCardResult {\n  return {\n    brand: raw.brand ?? raw.credit_card_brand ?? '',\n    number: raw.number ?? raw.credit_card_number ?? '',\n    expire: raw.expire ?? raw.expiration ?? '',\n    cvv: raw.cvv ?? '',\n  };\n}\n\n/**\n * Fetches a fake credit card from fakexy.com.\n *\n * @param options - Card brand (visa, mastercard, etc.)\n * @returns Parsed credit card with brand, number, expire, cvv\n * @throws {FakexyNetworkError} When the request fails\n * @throws {FakexyHttpError} When the server returns an error status\n * @throws {FakexyParseError} When the page structure has changed\n */\nexport async function getCreditCard(\n  options?: CreditCardOptions,\n): Promise<CreditCardResult> {\n  const url = buildCreditCardUrl(options?.brand);\n  const html = await fetchHtml(url, {\n    headers: options?.headers,\n    timeout: options?.timeout,\n  });\n  const raw = parseTablesToObject(html, url);\n  return mapRawToCreditCard(raw);\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "fakexy-to-json",
+  "version": "1.0.0",
+  "description": "Fetch and parse fakexy.com data to JSON. Fake addresses, profiles, credit cards by country.",
+  "keywords": [
+    "fakexy",
+    "fake-address",
+    "fake-address-generator",
+    "fake-data",
+    "fake-names",
+    "fake-creditcard",
+    "faker",
+    "mock",
+    "mocked"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MaxioN03/fakexy-to-json.git"
+  },
+  "license": "MIT",
+  "author": "",
+  "homepage": "https://github.com/MaxioN03/fakexy-to-json#readme",
+  "bugs": {
+    "url": "https://github.com/MaxioN03/fakexy-to-json/issues"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "cheerio": "^1.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.2"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}