@countrydataapi/sdk 1.0.0

package/dist/index.mjs

@@ -0,0 +1,400 @@
+// src/resources/countries.ts
+var Countries = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Get all countries
+   * @example
+   * const countries = await api.countries.getAll({ lang: 'es', limit: 50 });
+   */
+  async getAll(options) {
+    return this.http.get("/v1/countries/all", options);
+  }
+  /**
+   * Get country by name
+   * @example
+   * const spain = await api.countries.getByName({ name: 'Spain' });
+   */
+  async getByName(options) {
+    return this.http.get("/v1/countries/name", options);
+  }
+  /**
+   * Get country by ISO code (alpha-2, alpha-3, numeric, or CIOC)
+   * @example
+   * const spain = await api.countries.getByCode({ code: 'ES' });
+   */
+  async getByCode(options) {
+    return this.http.get("/v1/countries/code", options);
+  }
+  /**
+   * Get countries by region
+   * @example
+   * const european = await api.countries.getByRegion({ region: 'Europe' });
+   */
+  async getByRegion(options) {
+    return this.http.get("/v1/countries/region", options);
+  }
+  /**
+   * Get countries by currency code
+   * @example
+   * const euroCountries = await api.countries.getByCurrency({ currency: 'EUR' });
+   */
+  async getByCurrency(options) {
+    return this.http.get("/v1/countries/currency", options);
+  }
+  /**
+   * Get countries by language
+   * @example
+   * const spanishSpeaking = await api.countries.getByLanguage({ language: 'spa' });
+   */
+  async getByLanguage(options) {
+    return this.http.get("/v1/countries/language", options);
+  }
+  /**
+   * Get countries by timezone
+   * @example
+   * const utcCountries = await api.countries.getByTimezone({ timezone: 'UTC' });
+   */
+  async getByTimezone(options) {
+    return this.http.get("/v1/countries/timezone", options);
+  }
+  /**
+   * Get countries by state
+   * @example
+   * const countries = await api.countries.getByState({ state: 'California' });
+   */
+  async getByState(options) {
+    return this.http.get("/v1/countries/state", options);
+  }
+  /**
+   * Get countries by city
+   * @example
+   * const countries = await api.countries.getByCity({ city: 'Madrid' });
+   */
+  async getByCity(options) {
+    return this.http.get("/v1/countries/city", options);
+  }
+  /**
+   * Get countries by zip code
+   * @example
+   * const countries = await api.countries.getByZipCode({ zipCode: '28001' });
+   */
+  async getByZipCode(options) {
+    return this.http.get("/v1/countries/zipCode", options);
+  }
+};
+
+// src/resources/states.ts
+var States = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Get all states
+   * @example
+   * const states = await api.states.getAll({ lang: 'es' });
+   */
+  async getAll(options) {
+    return this.http.get("/v1/states/all", options);
+  }
+  /**
+   * Get state by name
+   * @example
+   * const state = await api.states.getByName({ state: 'Madrid' });
+   */
+  async getByName(options) {
+    return this.http.get("/v1/states/", options);
+  }
+  /**
+   * Get states by country
+   * @example
+   * const spanishStates = await api.states.getByCountry({ country: 'Spain' });
+   */
+  async getByCountry(options) {
+    return this.http.get("/v1/states/country", options);
+  }
+  /**
+   * Get states by city
+   * @example
+   * const states = await api.states.getByCity({ city: 'Madrid' });
+   */
+  async getByCity(options) {
+    return this.http.get("/v1/states/city", options);
+  }
+  /**
+   * Get states by zipcode
+   * @example
+   * const states = await api.states.getByZipcode({ zipcode: '28001' });
+   */
+  async getByZipcode(options) {
+    return this.http.get("/v1/states/zipcode", options);
+  }
+};
+
+// src/resources/cities.ts
+var Cities = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Get all cities
+   * @example
+   * const cities = await api.cities.getAll({ lang: 'es', limitToken: 100 });
+   */
+  async getAll(options) {
+    return this.http.get("/v1/cities/all", options);
+  }
+  /**
+   * Get city by name or ID
+   * @example
+   * const city = await api.cities.get({ city: 'Madrid' });
+   */
+  async get(options) {
+    return this.http.get("/v1/cities/", options);
+  }
+  /**
+   * Get cities by country
+   * @example
+   * const cities = await api.cities.getByCountry({ country: 'Spain' });
+   */
+  async getByCountry(options) {
+    return this.http.get("/v1/cities/country", options);
+  }
+  /**
+   * Get cities by state
+   * @example
+   * const cities = await api.cities.getByState({ state: 'Madrid' });
+   */
+  async getByState(options) {
+    return this.http.get("/v1/cities/state", options);
+  }
+};
+
+// src/resources/zipcodes.ts
+var Zipcodes = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Get all zipcodes
+   * @example
+   * const zipcodes = await api.zipcodes.getAll({ limitToken: 100 });
+   */
+  async getAll(options) {
+    return this.http.get("/v1/zipcodes/all", options);
+  }
+  /**
+   * Get zipcodes by state
+   * @example
+   * const zipcodes = await api.zipcodes.getByState({ state: 'Madrid' });
+   */
+  async getByState(options) {
+    return this.http.get("/v1/zipcodes/state", options);
+  }
+  /**
+   * Get zipcodes by country
+   * @example
+   * const zipcodes = await api.zipcodes.getByCountry({ country: 'Spain' });
+   */
+  async getByCountry(options) {
+    return this.http.get("/v1/zipcodes/country", options);
+  }
+  /**
+   * Get zipcodes by region
+   * @example
+   * const zipcodes = await api.zipcodes.getByRegion({ region: 'Europe' });
+   */
+  async getByRegion(options) {
+    return this.http.get("/v1/zipcodes/region", options);
+  }
+};
+
+// src/resources/select.ts
+var Select = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Get countries optimized for select/dropdown (costs 1 token)
+   * @example
+   * const countries = await api.select.countries({ lang: 'es' });
+   */
+  async countries(options) {
+    return this.http.get("/v1/select/countries", options);
+  }
+  /**
+   * Get states for a country optimized for select/dropdown (costs 1 token)
+   * @example
+   * const states = await api.select.states({ country: 'ES' });
+   */
+  async states(options) {
+    return this.http.get("/v1/select/states", options);
+  }
+  /**
+   * Get cities for a state optimized for select/dropdown (costs 1 token)
+   * @example
+   * const cities = await api.select.cities({ state: 'Madrid', country: 'ES' });
+   */
+  async cities(options) {
+    return this.http.get("/v1/select/cities", options);
+  }
+};
+
+// src/utils/errors.ts
+var CountryDataApiError = class extends Error {
+  constructor(message, statusCode, response) {
+    super(message);
+    this.statusCode = statusCode;
+    this.response = response;
+    this.name = "CountryDataApiError";
+  }
+};
+var AuthenticationError = class extends CountryDataApiError {
+  constructor(message = "Invalid API key") {
+    super(message, 401);
+    this.name = "AuthenticationError";
+  }
+};
+var RateLimitError = class extends CountryDataApiError {
+  constructor(message = "Rate limit exceeded") {
+    super(message, 429);
+    this.name = "RateLimitError";
+  }
+};
+var InsufficientTokensError = class extends CountryDataApiError {
+  constructor(message = "No remaining tokens available") {
+    super(message, 402);
+    this.name = "InsufficientTokensError";
+  }
+};
+var ValidationError = class extends CountryDataApiError {
+  constructor(message) {
+    super(message, 400);
+    this.name = "ValidationError";
+  }
+};
+
+// src/utils/http.ts
+var HttpClient = class {
+  constructor(config) {
+    this.config = config;
+  }
+  async get(endpoint, params) {
+    const url = this.buildUrl(endpoint, params);
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+    try {
+      const response = await fetch(url, {
+        method: "GET",
+        headers: {
+          "Accept": "application/json"
+        },
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      const data = await response.json();
+      if (!response.ok) {
+        this.handleError(response.status, data);
+      }
+      if (data.error) {
+        this.handleApiError(data);
+      }
+      return data;
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error instanceof CountryDataApiError) {
+        throw error;
+      }
+      if (error instanceof Error) {
+        if (error.name === "AbortError") {
+          throw new CountryDataApiError("Request timeout", 408);
+        }
+        throw new CountryDataApiError(error.message);
+      }
+      throw new CountryDataApiError("Unknown error occurred");
+    }
+  }
+  buildUrl(endpoint, params) {
+    const url = new URL(endpoint, this.config.baseUrl);
+    url.searchParams.set("apikey", this.config.apiKey);
+    if (params) {
+      for (const [key, value] of Object.entries(params)) {
+        if (value !== void 0 && value !== null) {
+          url.searchParams.set(key, String(value));
+        }
+      }
+    }
+    return url.toString();
+  }
+  handleError(statusCode, data) {
+    const message = data?.message || "Request failed";
+    switch (statusCode) {
+      case 401:
+        throw new AuthenticationError(message);
+      case 402:
+        throw new InsufficientTokensError(message);
+      default:
+        throw new CountryDataApiError(message, statusCode, data);
+    }
+  }
+  handleApiError(data) {
+    const message = data.message || "API error";
+    if (message.includes("Invalid API key")) {
+      throw new AuthenticationError(message);
+    }
+    if (message.includes("No remaining tokens")) {
+      throw new InsufficientTokensError(message);
+    }
+    throw new CountryDataApiError(message);
+  }
+};
+
+// src/client.ts
+var CountryDataApi = class {
+  /**
+   * Create a new Country Data API client
+   * @example
+   * const api = new CountryDataApi({ apiKey: 'your-api-key' });
+   * const countries = await api.countries.getAll({ lang: 'es' });
+   */
+  constructor(config) {
+    if (!config.apiKey) {
+      throw new Error("API key is required");
+    }
+    this.config = {
+      apiKey: config.apiKey,
+      baseUrl: config.baseUrl ?? "https://api.countrydataapi.com",
+      timeout: config.timeout ?? 3e4,
+      defaultLanguage: config.defaultLanguage ?? "en"
+    };
+    this.http = new HttpClient({
+      apiKey: this.config.apiKey,
+      baseUrl: this.config.baseUrl,
+      timeout: this.config.timeout
+    });
+    this.countries = new Countries(this.http);
+    this.states = new States(this.http);
+    this.cities = new Cities(this.http);
+    this.zipcodes = new Zipcodes(this.http);
+    this.select = new Select(this.http);
+  }
+  /**
+   * Get remaining tokens for your API key
+   * @example
+   * const status = await api.getStatus();
+   * console.log(`Remaining tokens: ${status.remainingTokens}`);
+   */
+  async getStatus() {
+    return this.http.get("/v1/status");
+  }
+};
+export {
+  AuthenticationError,
+  CountryDataApi,
+  CountryDataApiError,
+  InsufficientTokensError,
+  RateLimitError,
+  ValidationError
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/countries.ts","../src/resources/states.ts","../src/resources/cities.ts","../src/resources/zipcodes.ts","../src/resources/select.ts","../src/utils/errors.ts","../src/utils/http.ts","../src/client.ts"],"sourcesContent":["/**\r\n * Countries resource for Country Data API SDK\r\n */\r\n\r\nimport type { Country, ApiResponse, RequestOptions } from '../types';\r\nimport type { HttpClient } from '../utils/http';\r\n\r\nexport interface GetCountryByNameOptions extends RequestOptions {\r\n  name: string;\r\n}\r\n\r\nexport interface GetCountryByCodeOptions extends RequestOptions {\r\n  code: string;\r\n}\r\n\r\nexport interface GetCountriesByRegionOptions extends RequestOptions {\r\n  region: string;\r\n}\r\n\r\nexport interface GetCountriesByCurrencyOptions extends RequestOptions {\r\n  currency: string;\r\n}\r\n\r\nexport interface GetCountriesByLanguageOptions extends RequestOptions {\r\n  language: string;\r\n}\r\n\r\nexport interface GetCountriesByTimezoneOptions extends RequestOptions {\r\n  timezone: string;\r\n}\r\n\r\nexport interface GetCountriesByStateOptions extends RequestOptions {\r\n  state: string;\r\n}\r\n\r\nexport interface GetCountriesByCityOptions extends RequestOptions {\r\n  city: string;\r\n}\r\n\r\nexport interface GetCountriesByZipCodeOptions extends RequestOptions {\r\n  zipCode: string;\r\n}\r\n\r\nexport class Countries {\r\n  constructor(private readonly http: HttpClient) {}\r\n\r\n  /**\r\n   * Get all countries\r\n   * @example\r\n   * const countries = await api.countries.getAll({ lang: 'es', limit: 50 });\r\n   */\r\n  async getAll(options?: RequestOptions): Promise<ApiResponse<Country>> {\r\n    return this.http.get<ApiResponse<Country>>('/v1/countries/all', options);\r\n  }\r\n\r\n  /**\r\n   * Get country by name\r\n   * @example\r\n   * const spain = await api.countries.getByName({ name: 'Spain' });\r\n   */\r\n  async getByName(options: GetCountryByNameOptions): Promise<ApiResponse<Country>> {\r\n    return this.http.get<ApiResponse<Country>>('/v1/countries/name', options);\r\n  }\r\n\r\n  /**\r\n   * Get country by ISO code (alpha-2, alpha-3, numeric, or CIOC)\r\n   * @example\r\n   * const spain = await api.countries.getByCode({ code: 'ES' });\r\n   */\r\n  async getByCode(options: GetCountryByCodeOptions): Promise<ApiResponse<Country>> {\r\n    return this.http.get<ApiResponse<Country>>('/v1/countries/code', options);\r\n  }\r\n\r\n  /**\r\n   * Get countries by region\r\n   * @example\r\n   * const european = await api.countries.getByRegion({ region: 'Europe' });\r\n   */\r\n  async getByRegion(options: GetCountriesByRegionOptions): Promise<ApiResponse<Country>> {\r\n    return this.http.get<ApiResponse<Country>>('/v1/countries/region', options);\r\n  }\r\n\r\n  /**\r\n   * Get countries by currency code\r\n   * @example\r\n   * const euroCountries = await api.countries.getByCurrency({ currency: 'EUR' });\r\n   */\r\n  async getByCurrency(options: GetCountriesByCurrencyOptions): Promise<ApiResponse<Country>> {\r\n    return this.http.get<ApiResponse<Country>>('/v1/countries/currency', options);\r\n  }\r\n\r\n  /**\r\n   * Get countries by language\r\n   * @example\r\n   * const spanishSpeaking = await api.countries.getByLanguage({ language: 'spa' });\r\n   */\r\n  async getByLanguage(options: GetCountriesByLanguageOptions): Promise<ApiResponse<Country>> {\r\n    return this.http.get<ApiResponse<Country>>('/v1/countries/language', options);\r\n  }\r\n\r\n  /**\r\n   * Get countries by timezone\r\n   * @example\r\n   * const utcCountries = await api.countries.getByTimezone({ timezone: 'UTC' });\r\n   */\r\n  async getByTimezone(options: GetCountriesByTimezoneOptions): Promise<ApiResponse<Country>> {\r\n    return this.http.get<ApiResponse<Country>>('/v1/countries/timezone', options);\r\n  }\r\n\r\n  /**\r\n   * Get countries by state\r\n   * @example\r\n   * const countries = await api.countries.getByState({ state: 'California' });\r\n   */\r\n  async getByState(options: GetCountriesByStateOptions): Promise<ApiResponse<Country>> {\r\n    return this.http.get<ApiResponse<Country>>('/v1/countries/state', options);\r\n  }\r\n\r\n  /**\r\n   * Get countries by city\r\n   * @example\r\n   * const countries = await api.countries.getByCity({ city: 'Madrid' });\r\n   */\r\n  async getByCity(options: GetCountriesByCityOptions): Promise<ApiResponse<Country>> {\r\n    return this.http.get<ApiResponse<Country>>('/v1/countries/city', options);\r\n  }\r\n\r\n  /**\r\n   * Get countries by zip code\r\n   * @example\r\n   * const countries = await api.countries.getByZipCode({ zipCode: '28001' });\r\n   */\r\n  async getByZipCode(options: GetCountriesByZipCodeOptions): Promise<ApiResponse<Country>> {\r\n    return this.http.get<ApiResponse<Country>>('/v1/countries/zipCode', options);\r\n  }\r\n}\r\n","/**\r\n * States resource for Country Data API SDK\r\n */\r\n\r\nimport type { State, ApiResponse, RequestOptions } from '../types';\r\nimport type { HttpClient } from '../utils/http';\r\n\r\nexport interface GetStateByNameOptions extends RequestOptions {\r\n  state: string;\r\n}\r\n\r\nexport interface GetStatesByCountryOptions extends RequestOptions {\r\n  country: string;\r\n}\r\n\r\nexport interface GetStatesByCityOptions extends RequestOptions {\r\n  city: string;\r\n}\r\n\r\nexport interface GetStatesByZipcodeOptions extends RequestOptions {\r\n  zipcode: string;\r\n}\r\n\r\nexport class States {\r\n  constructor(private readonly http: HttpClient) {}\r\n\r\n  /**\r\n   * Get all states\r\n   * @example\r\n   * const states = await api.states.getAll({ lang: 'es' });\r\n   */\r\n  async getAll(options?: RequestOptions & { limitStates?: number }): Promise<ApiResponse<State>> {\r\n    return this.http.get<ApiResponse<State>>('/v1/states/all', options);\r\n  }\r\n\r\n  /**\r\n   * Get state by name\r\n   * @example\r\n   * const state = await api.states.getByName({ state: 'Madrid' });\r\n   */\r\n  async getByName(options: GetStateByNameOptions): Promise<ApiResponse<State>> {\r\n    return this.http.get<ApiResponse<State>>('/v1/states/', options);\r\n  }\r\n\r\n  /**\r\n   * Get states by country\r\n   * @example\r\n   * const spanishStates = await api.states.getByCountry({ country: 'Spain' });\r\n   */\r\n  async getByCountry(options: GetStatesByCountryOptions): Promise<ApiResponse<State>> {\r\n    return this.http.get<ApiResponse<State>>('/v1/states/country', options);\r\n  }\r\n\r\n  /**\r\n   * Get states by city\r\n   * @example\r\n   * const states = await api.states.getByCity({ city: 'Madrid' });\r\n   */\r\n  async getByCity(options: GetStatesByCityOptions): Promise<ApiResponse<State>> {\r\n    return this.http.get<ApiResponse<State>>('/v1/states/city', options);\r\n  }\r\n\r\n  /**\r\n   * Get states by zipcode\r\n   * @example\r\n   * const states = await api.states.getByZipcode({ zipcode: '28001' });\r\n   */\r\n  async getByZipcode(options: GetStatesByZipcodeOptions): Promise<ApiResponse<State>> {\r\n    return this.http.get<ApiResponse<State>>('/v1/states/zipcode', options);\r\n  }\r\n}\r\n","/**\r\n * Cities resource for Country Data API SDK\r\n */\r\n\r\nimport type { City, ApiResponse, RequestOptions } from '../types';\r\nimport type { HttpClient } from '../utils/http';\r\n\r\nexport interface GetCityOptions extends RequestOptions {\r\n  city: string;\r\n}\r\n\r\nexport interface GetCitiesByCountryOptions extends RequestOptions {\r\n  country: string;\r\n}\r\n\r\nexport interface GetCitiesByStateOptions extends RequestOptions {\r\n  state: string;\r\n}\r\n\r\nexport class Cities {\r\n  constructor(private readonly http: HttpClient) {}\r\n\r\n  /**\r\n   * Get all cities\r\n   * @example\r\n   * const cities = await api.cities.getAll({ lang: 'es', limitToken: 100 });\r\n   */\r\n  async getAll(options?: RequestOptions): Promise<ApiResponse<City>> {\r\n    return this.http.get<ApiResponse<City>>('/v1/cities/all', options);\r\n  }\r\n\r\n  /**\r\n   * Get city by name or ID\r\n   * @example\r\n   * const city = await api.cities.get({ city: 'Madrid' });\r\n   */\r\n  async get(options: GetCityOptions): Promise<ApiResponse<City>> {\r\n    return this.http.get<ApiResponse<City>>('/v1/cities/', options);\r\n  }\r\n\r\n  /**\r\n   * Get cities by country\r\n   * @example\r\n   * const cities = await api.cities.getByCountry({ country: 'Spain' });\r\n   */\r\n  async getByCountry(options: GetCitiesByCountryOptions): Promise<ApiResponse<City>> {\r\n    return this.http.get<ApiResponse<City>>('/v1/cities/country', options);\r\n  }\r\n\r\n  /**\r\n   * Get cities by state\r\n   * @example\r\n   * const cities = await api.cities.getByState({ state: 'Madrid' });\r\n   */\r\n  async getByState(options: GetCitiesByStateOptions): Promise<ApiResponse<City>> {\r\n    return this.http.get<ApiResponse<City>>('/v1/cities/state', options);\r\n  }\r\n}\r\n","/**\r\n * Zipcodes resource for Country Data API SDK\r\n */\r\n\r\nimport type { ApiResponse, RequestOptions } from '../types';\r\nimport type { HttpClient } from '../utils/http';\r\n\r\nexport interface GetZipcodesByStateOptions extends RequestOptions {\r\n  state: string;\r\n}\r\n\r\nexport interface GetZipcodesByCountryOptions extends RequestOptions {\r\n  country: string;\r\n}\r\n\r\nexport interface GetZipcodesByRegionOptions extends RequestOptions {\r\n  region: string;\r\n}\r\n\r\nexport class Zipcodes {\r\n  constructor(private readonly http: HttpClient) {}\r\n\r\n  /**\r\n   * Get all zipcodes\r\n   * @example\r\n   * const zipcodes = await api.zipcodes.getAll({ limitToken: 100 });\r\n   */\r\n  async getAll(options?: RequestOptions): Promise<ApiResponse<string>> {\r\n    return this.http.get<ApiResponse<string>>('/v1/zipcodes/all', options);\r\n  }\r\n\r\n  /**\r\n   * Get zipcodes by state\r\n   * @example\r\n   * const zipcodes = await api.zipcodes.getByState({ state: 'Madrid' });\r\n   */\r\n  async getByState(options: GetZipcodesByStateOptions): Promise<ApiResponse<string>> {\r\n    return this.http.get<ApiResponse<string>>('/v1/zipcodes/state', options);\r\n  }\r\n\r\n  /**\r\n   * Get zipcodes by country\r\n   * @example\r\n   * const zipcodes = await api.zipcodes.getByCountry({ country: 'Spain' });\r\n   */\r\n  async getByCountry(options: GetZipcodesByCountryOptions): Promise<ApiResponse<string>> {\r\n    return this.http.get<ApiResponse<string>>('/v1/zipcodes/country', options);\r\n  }\r\n\r\n  /**\r\n   * Get zipcodes by region\r\n   * @example\r\n   * const zipcodes = await api.zipcodes.getByRegion({ region: 'Europe' });\r\n   */\r\n  async getByRegion(options: GetZipcodesByRegionOptions): Promise<ApiResponse<string>> {\r\n    return this.http.get<ApiResponse<string>>('/v1/zipcodes/region', options);\r\n  }\r\n}\r\n","/**\r\n * Select resource for Country Data API SDK\r\n * Optimized endpoints for dropdowns (costs only 1 token)\r\n */\r\n\r\nimport type { SelectCountry, SelectState, SelectCity, ApiResponse, Language } from '../types';\r\nimport type { HttpClient } from '../utils/http';\r\n\r\nexport interface SelectCountriesOptions {\r\n  lang?: Language;\r\n  [key: string]: unknown;\r\n}\r\n\r\nexport interface SelectStatesOptions {\r\n  country: string;\r\n  lang?: Language;\r\n  [key: string]: unknown;\r\n}\r\n\r\nexport interface SelectCitiesOptions {\r\n  state: string;\r\n  country?: string;\r\n  lang?: Language;\r\n  [key: string]: unknown;\r\n}\r\n\r\nexport class Select {\r\n  constructor(private readonly http: HttpClient) {}\r\n\r\n  /**\r\n   * Get countries optimized for select/dropdown (costs 1 token)\r\n   * @example\r\n   * const countries = await api.select.countries({ lang: 'es' });\r\n   */\r\n  async countries(options?: SelectCountriesOptions): Promise<ApiResponse<SelectCountry>> {\r\n    return this.http.get<ApiResponse<SelectCountry>>('/v1/select/countries', options);\r\n  }\r\n\r\n  /**\r\n   * Get states for a country optimized for select/dropdown (costs 1 token)\r\n   * @example\r\n   * const states = await api.select.states({ country: 'ES' });\r\n   */\r\n  async states(options: SelectStatesOptions): Promise<ApiResponse<SelectState>> {\r\n    return this.http.get<ApiResponse<SelectState>>('/v1/select/states', options);\r\n  }\r\n\r\n  /**\r\n   * Get cities for a state optimized for select/dropdown (costs 1 token)\r\n   * @example\r\n   * const cities = await api.select.cities({ state: 'Madrid', country: 'ES' });\r\n   */\r\n  async cities(options: SelectCitiesOptions): Promise<ApiResponse<SelectCity>> {\r\n    return this.http.get<ApiResponse<SelectCity>>('/v1/select/cities', options);\r\n  }\r\n}\r\n","/**\r\n * Error classes for Country Data API SDK\r\n */\r\n\r\nexport class CountryDataApiError extends Error {\r\n  constructor(\r\n    message: string,\r\n    public readonly statusCode?: number,\r\n    public readonly response?: unknown\r\n  ) {\r\n    super(message);\r\n    this.name = 'CountryDataApiError';\r\n  }\r\n}\r\n\r\nexport class AuthenticationError extends CountryDataApiError {\r\n  constructor(message: string = 'Invalid API key') {\r\n    super(message, 401);\r\n    this.name = 'AuthenticationError';\r\n  }\r\n}\r\n\r\nexport class RateLimitError extends CountryDataApiError {\r\n  constructor(message: string = 'Rate limit exceeded') {\r\n    super(message, 429);\r\n    this.name = 'RateLimitError';\r\n  }\r\n}\r\n\r\nexport class InsufficientTokensError extends CountryDataApiError {\r\n  constructor(message: string = 'No remaining tokens available') {\r\n    super(message, 402);\r\n    this.name = 'InsufficientTokensError';\r\n  }\r\n}\r\n\r\nexport class ValidationError extends CountryDataApiError {\r\n  constructor(message: string) {\r\n    super(message, 400);\r\n    this.name = 'ValidationError';\r\n  }\r\n}\r\n","/**\r\n * HTTP client for Country Data API SDK\r\n */\r\n\r\nimport { CountryDataApiError, AuthenticationError, InsufficientTokensError } from './errors';\r\n\r\nexport interface HttpClientConfig {\r\n  apiKey: string;\r\n  baseUrl: string;\r\n  timeout: number;\r\n}\r\n\r\nexport class HttpClient {\r\n  private readonly config: HttpClientConfig;\r\n\r\n  constructor(config: HttpClientConfig) {\r\n    this.config = config;\r\n  }\r\n\r\n  async get<T>(endpoint: string, params?: Record<string, unknown>): Promise<T> {\r\n    const url = this.buildUrl(endpoint, params);\r\n\r\n    const controller = new AbortController();\r\n    const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);\r\n\r\n    try {\r\n      const response = await fetch(url, {\r\n        method: 'GET',\r\n        headers: {\r\n          'Accept': 'application/json',\r\n        },\r\n        signal: controller.signal,\r\n      });\r\n\r\n      clearTimeout(timeoutId);\r\n\r\n      const data = await response.json();\r\n\r\n      if (!response.ok) {\r\n        this.handleError(response.status, data);\r\n      }\r\n\r\n      if (data.error) {\r\n        this.handleApiError(data);\r\n      }\r\n\r\n      return data as T;\r\n    } catch (error) {\r\n      clearTimeout(timeoutId);\r\n\r\n      if (error instanceof CountryDataApiError) {\r\n        throw error;\r\n      }\r\n\r\n      if (error instanceof Error) {\r\n        if (error.name === 'AbortError') {\r\n          throw new CountryDataApiError('Request timeout', 408);\r\n        }\r\n        throw new CountryDataApiError(error.message);\r\n      }\r\n\r\n      throw new CountryDataApiError('Unknown error occurred');\r\n    }\r\n  }\r\n\r\n  private buildUrl(endpoint: string, params?: Record<string, unknown>): string {\r\n    const url = new URL(endpoint, this.config.baseUrl);\r\n\r\n    // Always add API key\r\n    url.searchParams.set('apikey', this.config.apiKey);\r\n\r\n    if (params) {\r\n      for (const [key, value] of Object.entries(params)) {\r\n        if (value !== undefined && value !== null) {\r\n          url.searchParams.set(key, String(value));\r\n        }\r\n      }\r\n    }\r\n\r\n    return url.toString();\r\n  }\r\n\r\n  private handleError(statusCode: number, data: unknown): never {\r\n    const message = (data as { message?: string })?.message || 'Request failed';\r\n\r\n    switch (statusCode) {\r\n      case 401:\r\n        throw new AuthenticationError(message);\r\n      case 402:\r\n        throw new InsufficientTokensError(message);\r\n      default:\r\n        throw new CountryDataApiError(message, statusCode, data);\r\n    }\r\n  }\r\n\r\n  private handleApiError(data: { error: boolean; message: string }): never {\r\n    const message = data.message || 'API error';\r\n\r\n    if (message.includes('Invalid API key')) {\r\n      throw new AuthenticationError(message);\r\n    }\r\n\r\n    if (message.includes('No remaining tokens')) {\r\n      throw new InsufficientTokensError(message);\r\n    }\r\n\r\n    throw new CountryDataApiError(message);\r\n  }\r\n}\r\n","/**\r\n * Main client for Country Data API SDK\r\n */\r\n\r\nimport { Countries } from './resources/countries';\r\nimport { States } from './resources/states';\r\nimport { Cities } from './resources/cities';\r\nimport { Zipcodes } from './resources/zipcodes';\r\nimport { Select } from './resources/select';\r\nimport { HttpClient } from './utils/http';\r\nimport type { Language, StatusResponse } from './types';\r\n\r\nexport interface CountryDataApiConfig {\r\n  /**\r\n   * Your API key from countrydataapi.com\r\n   */\r\n  apiKey: string;\r\n  /**\r\n   * Base URL for the API (default: https://api.countrydataapi.com)\r\n   */\r\n  baseUrl?: string;\r\n  /**\r\n   * Request timeout in milliseconds (default: 30000)\r\n   */\r\n  timeout?: number;\r\n  /**\r\n   * Default language for responses (default: 'en')\r\n   */\r\n  defaultLanguage?: Language;\r\n}\r\n\r\nexport class CountryDataApi {\r\n  private readonly http: HttpClient;\r\n  private readonly config: Required<CountryDataApiConfig>;\r\n\r\n  /**\r\n   * Countries resource - query country data\r\n   */\r\n  public readonly countries: Countries;\r\n\r\n  /**\r\n   * States resource - query state/province data\r\n   */\r\n  public readonly states: States;\r\n\r\n  /**\r\n   * Cities resource - query city data\r\n   */\r\n  public readonly cities: Cities;\r\n\r\n  /**\r\n   * Zipcodes resource - query postal code data\r\n   */\r\n  public readonly zipcodes: Zipcodes;\r\n\r\n  /**\r\n   * Select resource - optimized endpoints for dropdowns (1 token each)\r\n   */\r\n  public readonly select: Select;\r\n\r\n  /**\r\n   * Create a new Country Data API client\r\n   * @example\r\n   * const api = new CountryDataApi({ apiKey: 'your-api-key' });\r\n   * const countries = await api.countries.getAll({ lang: 'es' });\r\n   */\r\n  constructor(config: CountryDataApiConfig) {\r\n    if (!config.apiKey) {\r\n      throw new Error('API key is required');\r\n    }\r\n\r\n    this.config = {\r\n      apiKey: config.apiKey,\r\n      baseUrl: config.baseUrl ?? 'https://api.countrydataapi.com',\r\n      timeout: config.timeout ?? 30000,\r\n      defaultLanguage: config.defaultLanguage ?? 'en',\r\n    };\r\n\r\n    this.http = new HttpClient({\r\n      apiKey: this.config.apiKey,\r\n      baseUrl: this.config.baseUrl,\r\n      timeout: this.config.timeout,\r\n    });\r\n\r\n    this.countries = new Countries(this.http);\r\n    this.states = new States(this.http);\r\n    this.cities = new Cities(this.http);\r\n    this.zipcodes = new Zipcodes(this.http);\r\n    this.select = new Select(this.http);\r\n  }\r\n\r\n  /**\r\n   * Get remaining tokens for your API key\r\n   * @example\r\n   * const status = await api.getStatus();\r\n   * console.log(`Remaining tokens: ${status.remainingTokens}`);\r\n   */\r\n  async getStatus(): Promise<StatusResponse> {\r\n    return this.http.get<StatusResponse>('/v1/status');\r\n  }\r\n}\r\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@countrydataapi/sdk",
+  "version": "1.0.0",
+  "description": "Official TypeScript/JavaScript SDK for Country Data API - Access countries, states, cities, and postal codes worldwide",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run build",
+    "test": "vitest",
+    "test:coverage": "vitest --coverage",
+    "lint": "eslint src --ext .ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "countries",
+    "states",
+    "cities",
+    "zipcodes",
+    "postal-codes",
+    "geography",
+    "api",
+    "rest",
+    "sdk",
+    "typescript",
+    "javascript"
+  ],
+  "author": "Country Data API <support@countrydataapi.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/countrydataapi/country-data-api-sdk"
+  },
+  "homepage": "https://countrydataapi.com",
+  "bugs": {
+    "url": "https://github.com/countrydataapi/country-data-api-sdk/issues"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "rimraf": "^5.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  }
+}