apogeoapi 1.0.0

package/dist/index.js

@@ -0,0 +1,157 @@
+"use strict";
+/**
+ * @geo-api/sdk - Official TypeScript SDK for Geo API
+ *
+ * Professional geographic data API with comprehensive country, state, and city information.
+ *
+ * @example
+ * ```typescript
+ * import { GeoAPI } from '@geo-api/sdk';
+ *
+ * // Initialize with API key
+ * const client = new GeoAPI({
+ *   apiKey: 'geoapi_live_xxxxx',
+ *   baseURL: 'https://api.yourcompany.com/v1'
+ * });
+ *
+ * // Use the API
+ * const countries = await client.geo.getCountries();
+ * const usage = await client.account.getDashboard();
+ * ```
+ *
+ * @packageDocumentation
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebhooksClient = exports.BillingClient = exports.ApiKeysClient = exports.AccountClient = exports.GeoClient = exports.AuthClient = exports.GeoAPI = void 0;
+const http_client_1 = require("./utils/http-client");
+const auth_client_1 = require("./clients/auth.client");
+const geo_client_1 = require("./clients/geo.client");
+const account_client_1 = require("./clients/account.client");
+const api_keys_client_1 = require("./clients/api-keys.client");
+const billing_client_1 = require("./clients/billing.client");
+const webhooks_client_1 = require("./clients/webhooks.client");
+/**
+ * Main SDK class
+ *
+ * Provides access to all API modules:
+ * - `auth` - Authentication (login, register, refresh token)
+ * - `geo` - Geography data (countries, states, cities)
+ * - `account` - User account management
+ * - `apiKeys` - API keys CRUD
+ * - `billing` - Subscription and billing
+ * - `webhooks` - Webhook management
+ *
+ * @example
+ * ```typescript
+ * const client = new GeoAPI({
+ *   apiKey: 'geoapi_live_xxxxx'
+ * });
+ *
+ * // Get countries
+ * const countries = await client.geo.getCountries();
+ *
+ * // Login
+ * const { access_token } = await client.auth.login({
+ *   email: 'user@example.com',
+ *   password: 'password123'
+ * });
+ *
+ * // Get dashboard
+ * const dashboard = await client.account.getDashboard();
+ * ```
+ */
+class GeoAPI {
+    /**
+     * Create a new Geo API client
+     *
+     * @param config - SDK configuration
+     *
+     * @example
+     * ```typescript
+     * // With API key (recommended for client-side)
+     * const client = new GeoAPI({
+     *   apiKey: 'geoapi_live_xxxxx'
+     * });
+     *
+     * // With JWT token (for server-side after login)
+     * const client = new GeoAPI({
+     *   token: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'
+     * });
+     *
+     * // With custom configuration
+     * const client = new GeoAPI({
+     *   apiKey: 'geoapi_live_xxxxx',
+     *   baseURL: 'https://api.yourcompany.com/v1',
+     *   timeout: 30000,
+     *   retries: 3,
+     *   debug: true
+     * });
+     * ```
+     */
+    constructor(config) {
+        // Validate config
+        if (!config.apiKey && !config.token) {
+            throw new Error('GeoAPI SDK requires either apiKey or token for authentication');
+        }
+        // Initialize HTTP client
+        this.httpClient = new http_client_1.HttpClient(config);
+        // Initialize all clients
+        this.auth = new auth_client_1.AuthClient(this.httpClient);
+        this.geo = new geo_client_1.GeoClient(this.httpClient);
+        this.account = new account_client_1.AccountClient(this.httpClient);
+        this.apiKeys = new api_keys_client_1.ApiKeysClient(this.httpClient);
+        this.billing = new billing_client_1.BillingClient(this.httpClient);
+        this.webhooks = new webhooks_client_1.WebhooksClient(this.httpClient);
+    }
+    /**
+     * Update authentication token
+     *
+     * Useful after login or token refresh
+     *
+     * @param token - New JWT token
+     */
+    setToken(token) {
+        this.httpClient.setToken(token);
+    }
+    /**
+     * Update API key
+     *
+     * @param apiKey - New API key
+     */
+    setApiKey(apiKey) {
+        this.httpClient.setApiKey(apiKey);
+    }
+}
+exports.GeoAPI = GeoAPI;
+// Export all types
+__exportStar(require("./types"), exports);
+// Export individual clients for advanced use cases
+var auth_client_2 = require("./clients/auth.client");
+Object.defineProperty(exports, "AuthClient", { enumerable: true, get: function () { return auth_client_2.AuthClient; } });
+var geo_client_2 = require("./clients/geo.client");
+Object.defineProperty(exports, "GeoClient", { enumerable: true, get: function () { return geo_client_2.GeoClient; } });
+var account_client_2 = require("./clients/account.client");
+Object.defineProperty(exports, "AccountClient", { enumerable: true, get: function () { return account_client_2.AccountClient; } });
+var api_keys_client_2 = require("./clients/api-keys.client");
+Object.defineProperty(exports, "ApiKeysClient", { enumerable: true, get: function () { return api_keys_client_2.ApiKeysClient; } });
+var billing_client_2 = require("./clients/billing.client");
+Object.defineProperty(exports, "BillingClient", { enumerable: true, get: function () { return billing_client_2.BillingClient; } });
+var webhooks_client_2 = require("./clients/webhooks.client");
+Object.defineProperty(exports, "WebhooksClient", { enumerable: true, get: function () { return webhooks_client_2.WebhooksClient; } });
+// Default export
+exports.default = GeoAPI;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;;;;;;;;;;;;;;;AAEH,qDAAiD;AACjD,uDAAmD;AACnD,qDAAiD;AACjD,6DAAyD;AACzD,+DAA0D;AAC1D,6DAAyD;AACzD,+DAA2D;AAG3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAa,MAAM;IAiCjB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,YAAY,MAAiB;QAC3B,kBAAkB;QAClB,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,+DAA+D,CAChE,CAAC;QACJ,CAAC;QAED,yBAAyB;QACzB,IAAI,CAAC,UAAU,GAAG,IAAI,wBAAU,CAAC,MAAM,CAAC,CAAC;QAEzC,yBAAyB;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,wBAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5C,IAAI,CAAC,GAAG,GAAG,IAAI,sBAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1C,IAAI,CAAC,OAAO,GAAG,IAAI,8BAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,OAAO,GAAG,IAAI,+BAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,OAAO,GAAG,IAAI,8BAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ,GAAG,IAAI,gCAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACtD,CAAC;IAED;;;;;;OAMG;IACI,QAAQ,CAAC,KAAa;QAC3B,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACI,SAAS,CAAC,MAAc;QAC7B,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;CACF;AAnGD,wBAmGC;AAED,mBAAmB;AACnB,0CAAwB;AAExB,mDAAmD;AACnD,qDAAmD;AAA1C,yGAAA,UAAU,OAAA;AACnB,mDAAiD;AAAxC,uGAAA,SAAS,OAAA;AAClB,2DAAyD;AAAhD,+GAAA,aAAa,OAAA;AACtB,6DAA0D;AAAjD,gHAAA,aAAa,OAAA;AACtB,2DAAyD;AAAhD,+GAAA,aAAa,OAAA;AACtB,6DAA2D;AAAlD,iHAAA,cAAc,OAAA;AAEvB,iBAAiB;AACjB,kBAAe,MAAM,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,243 @@
+/**
+ * Type definitions for Geo API SDK
+ */
+export type Tier = 'free' | 'starter' | 'professional' | 'enterprise';
+export type UserRole = 'user' | 'admin';
+export type WebhookEvent = 'usage.quota_warning' | 'usage.quota_exceeded' | 'subscription.created' | 'subscription.updated' | 'subscription.canceled';
+export interface User {
+    id: string;
+    email: string;
+    username: string;
+    role: UserRole;
+    tier: Tier;
+    monthlyQuota: number;
+    requestsThisMonth: number;
+    lastQuotaReset: Date;
+    isActive: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface RegisterDto {
+    email: string;
+    password: string;
+    username: string;
+}
+export interface LoginDto {
+    email: string;
+    password: string;
+}
+export interface AuthResponse {
+    user: {
+        id: string;
+        email: string;
+        username: string;
+        role: UserRole;
+        tier: Tier;
+    };
+    access_token: string;
+    refresh_token: string;
+}
+export interface RefreshTokenDto {
+    refresh_token: string;
+}
+export interface ApiKey {
+    id: string;
+    key: string;
+    name: string;
+    isActive: boolean;
+    lastUsedAt: Date | null;
+    expiresAt: Date | null;
+    createdAt: Date;
+}
+export interface CreateApiKeyDto {
+    name: string;
+    expiresAt?: Date;
+}
+export interface UpdateApiKeyDto {
+    name?: string;
+    isActive?: boolean;
+}
+export interface Country {
+    id: number;
+    name: string;
+    iso2: string;
+    iso3: string;
+    capital: string;
+    region: string;
+    subregion: string;
+    currency: string;
+    phoneCode: string;
+    latitude: number;
+    longitude: number;
+    emoji: string;
+}
+export interface State {
+    id: number;
+    name: string;
+    stateCode: string;
+    latitude: number;
+    longitude: number;
+    countryId: number;
+    country?: Country;
+}
+export interface City {
+    id: number;
+    name: string;
+    latitude: number;
+    longitude: number;
+    stateId: number;
+    countryId: number;
+    state?: State;
+    country?: Country;
+}
+export interface GeoSearchParams {
+    query: string;
+    limit?: number;
+    offset?: number;
+    type?: 'country' | 'state' | 'city';
+}
+export interface AccountDashboard {
+    user: {
+        id: string;
+        email: string;
+        username: string;
+        tier: Tier;
+        createdAt: Date;
+    };
+    subscription: {
+        tier: Tier;
+        status: string;
+        currentPeriodEnd: Date | null;
+        cancelAtPeriodEnd: boolean;
+    };
+    usage: {
+        requestsThisMonth: number;
+        monthlyQuota: number;
+        remaining: number;
+        usagePercentage: number;
+        lastQuotaReset: Date;
+    };
+    limits: {
+        quota: number;
+        rateLimit: number;
+        maxApiKeys: number;
+        overageAllowed: boolean;
+        price: number;
+    };
+    apiKeys: {
+        active: number;
+        max: number;
+    };
+}
+export interface UpdateProfileDto {
+    username?: string;
+    email?: string;
+}
+export interface ChangePasswordDto {
+    currentPassword: string;
+    newPassword: string;
+}
+export interface BillingPortalResponse {
+    url: string;
+}
+export interface CheckoutSessionResponse {
+    sessionId: string;
+    url: string;
+}
+export interface Invoice {
+    id: string;
+    amount: number;
+    currency: string;
+    status: string;
+    created: Date;
+    invoice_pdf: string;
+}
+export interface Webhook {
+    id: string;
+    url: string;
+    events: WebhookEvent[];
+    secret: string;
+    isActive: boolean;
+    createdAt: Date;
+}
+export interface CreateWebhookDto {
+    url: string;
+    events: WebhookEvent[];
+}
+export interface UpdateWebhookDto {
+    url?: string;
+    events?: WebhookEvent[];
+    isActive?: boolean;
+}
+export interface WebhookLog {
+    id: string;
+    webhookId: string;
+    event: WebhookEvent;
+    payload: any;
+    statusCode: number;
+    success: boolean;
+    createdAt: Date;
+}
+export interface UsageStats {
+    date: Date;
+    requests: number;
+}
+export interface UsageQuery {
+    startDate?: Date;
+    endDate?: Date;
+    groupBy?: 'day' | 'month';
+}
+export interface SDKConfig {
+    /**
+     * API Key for authentication (preferred)
+     */
+    apiKey?: string;
+    /**
+     * JWT token for authentication (alternative)
+     */
+    token?: string;
+    /**
+     * Base URL of the API
+     * @default "https://api.yourcompany.com/v1"
+     */
+    baseURL?: string;
+    /**
+     * Request timeout in milliseconds
+     * @default 30000
+     */
+    timeout?: number;
+    /**
+     * Number of retry attempts on failure
+     * @default 3
+     */
+    retries?: number;
+    /**
+     * Enable debug logging
+     * @default false
+     */
+    debug?: boolean;
+}
+export interface APIError {
+    statusCode: number;
+    message: string;
+    error?: string;
+    timestamp: string;
+    path: string;
+}
+export declare class GeoAPIError extends Error {
+    statusCode: number;
+    response?: APIError | undefined;
+    constructor(message: string, statusCode: number, response?: APIError | undefined);
+}
+export interface PaginatedResponse<T> {
+    data: T[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+export interface SuccessResponse<T = any> {
+    success: boolean;
+    data: T;
+    message?: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/types/index.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * Type definitions for Geo API SDK
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GeoAPIError = void 0;
+class GeoAPIError extends Error {
+    constructor(message, statusCode, response) {
+        super(message);
+        this.statusCode = statusCode;
+        this.response = response;
+        this.name = 'GeoAPIError';
+    }
+}
+exports.GeoAPIError = GeoAPIError;
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AA0RH,MAAa,WAAY,SAAQ,KAAK;IACpC,YACE,OAAe,EACR,UAAkB,EAClB,QAAmB;QAE1B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,eAAU,GAAV,UAAU,CAAQ;QAClB,aAAQ,GAAR,QAAQ,CAAW;QAG1B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AATD,kCASC"}

package/dist/utils/http-client.d.ts

@@ -0,0 +1,43 @@
+import { AxiosRequestConfig } from 'axios';
+import { SDKConfig } from '../types';
+/**
+ * Base HTTP client with retry logic and error handling
+ */
+export declare class HttpClient {
+    private client;
+    private config;
+    constructor(config: SDKConfig);
+    /**
+     * Handle and transform API errors
+     */
+    private handleError;
+    /**
+     * Update authentication token
+     */
+    setToken(token: string): void;
+    /**
+     * Update API key
+     */
+    setApiKey(apiKey: string): void;
+    /**
+     * GET request
+     */
+    get<T = any>(url: string, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * POST request
+     */
+    post<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * PUT request
+     */
+    put<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * DELETE request
+     */
+    delete<T = any>(url: string, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * PATCH request
+     */
+    patch<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
+}
+//# sourceMappingURL=http-client.d.ts.map

package/dist/utils/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/utils/http-client.ts"],"names":[],"mappings":"AAAA,OAAc,EAAiB,kBAAkB,EAA6B,MAAM,OAAO,CAAC;AAE5F,OAAO,EAAE,SAAS,EAAyB,MAAM,UAAU,CAAC;AAE5D;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAY;gBAEd,MAAM,EAAE,SAAS;IAgF7B;;OAEG;IACH,OAAO,CAAC,WAAW;IAqBnB;;OAEG;IACI,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIpC;;OAEG;IACI,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAItC;;OAEG;IACU,GAAG,CAAC,CAAC,GAAG,GAAG,EACtB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,CAAC,CAAC;IAKb;;OAEG;IACU,IAAI,CAAC,CAAC,GAAG,GAAG,EACvB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,GAAG,EACV,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,CAAC,CAAC;IAKb;;OAEG;IACU,GAAG,CAAC,CAAC,GAAG,GAAG,EACtB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,GAAG,EACV,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,CAAC,CAAC;IAKb;;OAEG;IACU,MAAM,CAAC,CAAC,GAAG,GAAG,EACzB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,CAAC,CAAC;IAKb;;OAEG;IACU,KAAK,CAAC,CAAC,GAAG,GAAG,EACxB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,GAAG,EACV,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,CAAC,CAAC;CAId"}

package/dist/utils/http-client.js

@@ -0,0 +1,140 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+const axios_retry_1 = __importDefault(require("axios-retry"));
+const types_1 = require("../types");
+/**
+ * Base HTTP client with retry logic and error handling
+ */
+class HttpClient {
+    constructor(config) {
+        this.config = {
+            baseURL: config.baseURL || 'https://api.yourcompany.com/v1',
+            timeout: config.timeout || 30000,
+            retries: config.retries || 3,
+            debug: config.debug || false,
+            ...config,
+        };
+        // Create axios instance
+        this.client = axios_1.default.create({
+            baseURL: this.config.baseURL,
+            timeout: this.config.timeout,
+            headers: {
+                'Content-Type': 'application/json',
+                'User-Agent': '@geo-api/sdk/1.0.0',
+            },
+        });
+        // Setup retry logic with exponential backoff
+        (0, axios_retry_1.default)(this.client, {
+            retries: this.config.retries,
+            retryDelay: axios_retry_1.default.exponentialDelay,
+            retryCondition: (error) => {
+                // Retry on network errors or 5xx server errors
+                return (axios_retry_1.default.isNetworkOrIdempotentRequestError(error) ||
+                    (error.response?.status || 0) >= 500);
+            },
+            onRetry: (retryCount, error, requestConfig) => {
+                if (this.config.debug) {
+                    console.log(`[SDK] Retry attempt ${retryCount} for ${requestConfig.url}`, error.message);
+                }
+            },
+        });
+        // Setup request interceptor for authentication
+        this.client.interceptors.request.use((config) => {
+            // Add API Key if provided
+            if (this.config.apiKey) {
+                config.headers['X-API-Key'] = this.config.apiKey;
+            }
+            // Add JWT token if provided
+            if (this.config.token) {
+                config.headers['Authorization'] = `Bearer ${this.config.token}`;
+            }
+            if (this.config.debug) {
+                console.log(`[SDK] ${config.method?.toUpperCase()} ${config.url}`);
+            }
+            return config;
+        }, (error) => {
+            return Promise.reject(error);
+        });
+        // Setup response interceptor for error handling
+        this.client.interceptors.response.use((response) => {
+            if (this.config.debug) {
+                console.log(`[SDK] Response ${response.status} from ${response.config.url}`);
+            }
+            return response;
+        }, (error) => {
+            return Promise.reject(this.handleError(error));
+        });
+    }
+    /**
+     * Handle and transform API errors
+     */
+    handleError(error) {
+        if (error.response) {
+            // Server responded with error status
+            const { status, data } = error.response;
+            return new types_1.GeoAPIError(data?.message || error.message, status, data);
+        }
+        else if (error.request) {
+            // Request was made but no response received
+            return new types_1.GeoAPIError('No response from server. Please check your network connection.', 0);
+        }
+        else {
+            // Something else happened
+            return new types_1.GeoAPIError(error.message, 0);
+        }
+    }
+    /**
+     * Update authentication token
+     */
+    setToken(token) {
+        this.config.token = token;
+    }
+    /**
+     * Update API key
+     */
+    setApiKey(apiKey) {
+        this.config.apiKey = apiKey;
+    }
+    /**
+     * GET request
+     */
+    async get(url, config) {
+        const response = await this.client.get(url, config);
+        return response.data;
+    }
+    /**
+     * POST request
+     */
+    async post(url, data, config) {
+        const response = await this.client.post(url, data, config);
+        return response.data;
+    }
+    /**
+     * PUT request
+     */
+    async put(url, data, config) {
+        const response = await this.client.put(url, data, config);
+        return response.data;
+    }
+    /**
+     * DELETE request
+     */
+    async delete(url, config) {
+        const response = await this.client.delete(url, config);
+        return response.data;
+    }
+    /**
+     * PATCH request
+     */
+    async patch(url, data, config) {
+        const response = await this.client.patch(url, data, config);
+        return response.data;
+    }
+}
+exports.HttpClient = HttpClient;
+//# sourceMappingURL=http-client.js.map

package/dist/utils/http-client.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "apogeoapi",
+  "version": "1.0.0",
+  "description": "Official TypeScript/JavaScript SDK for ApogeoAPI — IP geolocation, countries, cities, and exchange rates",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "geolocation",
+    "ip",
+    "countries",
+    "states",
+    "cities",
+    "exchange-rates",
+    "api",
+    "sdk",
+    "typescript"
+  ],
+  "author": "ApogeoAPI <support@apogeoapi.com>",
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.6.2",
+    "axios-retry": "^4.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.5",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/APOGEOAPI/apogeoapi-js"
+  },
+  "bugs": {
+    "url": "https://github.com/APOGEOAPI/apogeoapi-js/issues"
+  },
+  "homepage": "https://apogeoapi.com"
+}