apogeoapi 1.0.0

package/dist/clients/api-keys.client.d.ts

@@ -0,0 +1,90 @@
+import { HttpClient } from '../utils/http-client';
+import { ApiKey, CreateApiKeyDto, UpdateApiKeyDto } from '../types';
+/**
+ * ApiKeysClient - Handles API key management
+ *
+ * @example
+ * ```typescript
+ * const apiKeys = new ApiKeysClient(httpClient);
+ *
+ * // Create new API key
+ * const newKey = await apiKeys.create({
+ *   name: 'Production Key',
+ *   expiresAt: new Date('2025-12-31')
+ * });
+ * console.log('Your API key:', newKey.key); // Save this!
+ *
+ * // List all keys
+ * const keys = await apiKeys.list();
+ *
+ * // Revoke a key
+ * await apiKeys.update(keyId, { isActive: false });
+ * ```
+ */
+export declare class ApiKeysClient {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * List all API keys for the current user
+     *
+     * Note: The actual key value is only shown once during creation
+     *
+     * @returns Array of API keys (without key values)
+     */
+    list(): Promise<ApiKey[]>;
+    /**
+     * Get specific API key by ID
+     *
+     * @param id - API key ID
+     * @returns API key data
+     */
+    get(id: string): Promise<ApiKey>;
+    /**
+     * Create a new API key
+     *
+     * **Important:** The full key value is only returned once.
+     * Save it immediately!
+     *
+     * @param data - API key creation data (name, expiresAt)
+     * @returns Newly created API key with full key value
+     */
+    create(data: CreateApiKeyDto): Promise<ApiKey>;
+    /**
+     * Update API key
+     *
+     * Can update name or activate/deactivate the key
+     *
+     * @param id - API key ID
+     * @param data - Update data (name, isActive)
+     * @returns Updated API key
+     */
+    update(id: string, data: UpdateApiKeyDto): Promise<ApiKey>;
+    /**
+     * Delete API key permanently
+     *
+     * **Warning:** This action is irreversible
+     *
+     * @param id - API key ID
+     * @returns Success response
+     */
+    delete(id: string): Promise<{
+        message: string;
+    }>;
+    /**
+     * Deactivate (revoke) an API key without deleting it
+     *
+     * This is safer than deletion as it can be reactivated later
+     *
+     * @param id - API key ID
+     * @returns Updated API key
+     */
+    revoke(id: string): Promise<ApiKey>;
+    /**
+     * Reactivate a previously revoked API key
+     *
+     * @param id - API key ID
+     * @returns Updated API key
+     */
+    activate(id: string): Promise<ApiKey>;
+}
+//# sourceMappingURL=api-keys.client.d.ts.map

package/dist/clients/api-keys.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-keys.client.d.ts","sourceRoot":"","sources":["../../src/clients/api-keys.client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC;;;;;;OAMG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAI/B;;;;;OAKG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAItC;;;;;;;;OAQG;IACG,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAIpD;;;;;;;;OAQG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAIhE;;;;;;;OAOG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAItD;;;;;;;OAOG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIzC;;;;;OAKG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAG5C"}

package/dist/clients/api-keys.client.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiKeysClient = void 0;
+/**
+ * ApiKeysClient - Handles API key management
+ *
+ * @example
+ * ```typescript
+ * const apiKeys = new ApiKeysClient(httpClient);
+ *
+ * // Create new API key
+ * const newKey = await apiKeys.create({
+ *   name: 'Production Key',
+ *   expiresAt: new Date('2025-12-31')
+ * });
+ * console.log('Your API key:', newKey.key); // Save this!
+ *
+ * // List all keys
+ * const keys = await apiKeys.list();
+ *
+ * // Revoke a key
+ * await apiKeys.update(keyId, { isActive: false });
+ * ```
+ */
+class ApiKeysClient {
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * List all API keys for the current user
+     *
+     * Note: The actual key value is only shown once during creation
+     *
+     * @returns Array of API keys (without key values)
+     */
+    async list() {
+        return this.http.get('/api-keys');
+    }
+    /**
+     * Get specific API key by ID
+     *
+     * @param id - API key ID
+     * @returns API key data
+     */
+    async get(id) {
+        return this.http.get(`/api-keys/${id}`);
+    }
+    /**
+     * Create a new API key
+     *
+     * **Important:** The full key value is only returned once.
+     * Save it immediately!
+     *
+     * @param data - API key creation data (name, expiresAt)
+     * @returns Newly created API key with full key value
+     */
+    async create(data) {
+        return this.http.post('/api-keys', data);
+    }
+    /**
+     * Update API key
+     *
+     * Can update name or activate/deactivate the key
+     *
+     * @param id - API key ID
+     * @param data - Update data (name, isActive)
+     * @returns Updated API key
+     */
+    async update(id, data) {
+        return this.http.put(`/api-keys/${id}`, data);
+    }
+    /**
+     * Delete API key permanently
+     *
+     * **Warning:** This action is irreversible
+     *
+     * @param id - API key ID
+     * @returns Success response
+     */
+    async delete(id) {
+        return this.http.delete(`/api-keys/${id}`);
+    }
+    /**
+     * Deactivate (revoke) an API key without deleting it
+     *
+     * This is safer than deletion as it can be reactivated later
+     *
+     * @param id - API key ID
+     * @returns Updated API key
+     */
+    async revoke(id) {
+        return this.update(id, { isActive: false });
+    }
+    /**
+     * Reactivate a previously revoked API key
+     *
+     * @param id - API key ID
+     * @returns Updated API key
+     */
+    async activate(id) {
+        return this.update(id, { isActive: true });
+    }
+}
+exports.ApiKeysClient = ApiKeysClient;
+//# sourceMappingURL=api-keys.client.js.map

package/dist/clients/api-keys.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-keys.client.js","sourceRoot":"","sources":["../../src/clients/api-keys.client.ts"],"names":[],"mappings":";;;AAGA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAa,aAAa;IACxB,YAAoB,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAExC;;;;;;OAMG;IACH,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAW,WAAW,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAS,aAAa,EAAE,EAAE,CAAC,CAAC;IAClD,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM,CAAC,IAAqB;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAS,WAAW,EAAE,IAAI,CAAC,CAAC;IACnD,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,IAAqB;QAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAS,aAAa,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAsB,aAAa,EAAE,EAAE,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,EAAU;QACvB,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;CACF;AAnFD,sCAmFC"}

package/dist/clients/auth.client.d.ts

@@ -0,0 +1,63 @@
+import { HttpClient } from '../utils/http-client';
+import { RegisterDto, LoginDto, AuthResponse, RefreshTokenDto, User } from '../types';
+/**
+ * AuthClient - Handles authentication operations
+ *
+ * @example
+ * ```typescript
+ * const auth = new AuthClient(httpClient);
+ *
+ * // Register new user
+ * const { user, access_token } = await auth.register({
+ *   email: 'user@example.com',
+ *   password: 'securePassword123',
+ *   username: 'johndoe'
+ * });
+ *
+ * // Login
+ * const tokens = await auth.login({
+ *   email: 'user@example.com',
+ *   password: 'securePassword123'
+ * });
+ *
+ * // Refresh token
+ * const newTokens = await auth.refreshToken({ refresh_token: 'xxx' });
+ * ```
+ */
+export declare class AuthClient {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * Register a new user
+     *
+     * @param data - Registration data (email, password, username)
+     * @returns Auth response with user data and tokens
+     */
+    register(data: RegisterDto): Promise<AuthResponse>;
+    /**
+     * Login with email and password
+     *
+     * @param data - Login credentials (email, password)
+     * @returns Auth response with user data and tokens
+     */
+    login(data: LoginDto): Promise<AuthResponse>;
+    /**
+     * Refresh access token using refresh token
+     *
+     * @param data - Refresh token data
+     * @returns New auth tokens
+     */
+    refreshToken(data: RefreshTokenDto): Promise<AuthResponse>;
+    /**
+     * Get current user profile
+     *
+     * @returns Current user data
+     */
+    getProfile(): Promise<User>;
+    /**
+     * Logout (client-side token removal)
+     * Note: Backend doesn't have logout endpoint (JWT is stateless)
+     */
+    logout(): void;
+}
+//# sourceMappingURL=auth.client.d.ts.map

package/dist/clients/auth.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.client.d.ts","sourceRoot":"","sources":["../../src/clients/auth.client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EACL,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,IAAI,EACL,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,UAAU;IACT,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC;;;;;OAKG;IACG,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAIxD;;;;;OAKG;IACG,KAAK,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC;IAWlD;;;;;OAKG;IACG,YAAY,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC;IAWhE;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;;OAGG;IACH,MAAM,IAAI,IAAI;CAGf"}

package/dist/clients/auth.client.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuthClient = void 0;
+/**
+ * AuthClient - Handles authentication operations
+ *
+ * @example
+ * ```typescript
+ * const auth = new AuthClient(httpClient);
+ *
+ * // Register new user
+ * const { user, access_token } = await auth.register({
+ *   email: 'user@example.com',
+ *   password: 'securePassword123',
+ *   username: 'johndoe'
+ * });
+ *
+ * // Login
+ * const tokens = await auth.login({
+ *   email: 'user@example.com',
+ *   password: 'securePassword123'
+ * });
+ *
+ * // Refresh token
+ * const newTokens = await auth.refreshToken({ refresh_token: 'xxx' });
+ * ```
+ */
+class AuthClient {
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Register a new user
+     *
+     * @param data - Registration data (email, password, username)
+     * @returns Auth response with user data and tokens
+     */
+    async register(data) {
+        return this.http.post('/auth/register', data);
+    }
+    /**
+     * Login with email and password
+     *
+     * @param data - Login credentials (email, password)
+     * @returns Auth response with user data and tokens
+     */
+    async login(data) {
+        const response = await this.http.post('/auth/login', data);
+        // Auto-update token in http client
+        if (response.access_token) {
+            this.http.setToken(response.access_token);
+        }
+        return response;
+    }
+    /**
+     * Refresh access token using refresh token
+     *
+     * @param data - Refresh token data
+     * @returns New auth tokens
+     */
+    async refreshToken(data) {
+        const response = await this.http.post('/auth/refresh', data);
+        // Auto-update token in http client
+        if (response.access_token) {
+            this.http.setToken(response.access_token);
+        }
+        return response;
+    }
+    /**
+     * Get current user profile
+     *
+     * @returns Current user data
+     */
+    async getProfile() {
+        return this.http.get('/auth/profile');
+    }
+    /**
+     * Logout (client-side token removal)
+     * Note: Backend doesn't have logout endpoint (JWT is stateless)
+     */
+    logout() {
+        this.http.setToken('');
+    }
+}
+exports.AuthClient = AuthClient;
+//# sourceMappingURL=auth.client.js.map

package/dist/clients/auth.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.client.js","sourceRoot":"","sources":["../../src/clients/auth.client.ts"],"names":[],"mappings":";;;AASA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAa,UAAU;IACrB,YAAoB,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAExC;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,IAAiB;QAC9B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAe,gBAAgB,EAAE,IAAI,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAK,CAAC,IAAc;QACxB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAe,aAAa,EAAE,IAAI,CAAC,CAAC;QAEzE,mCAAmC;QACnC,IAAI,QAAQ,CAAC,YAAY,EAAE,CAAC;YAC1B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QAC5C,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,YAAY,CAAC,IAAqB;QACtC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAe,eAAe,EAAE,IAAI,CAAC,CAAC;QAE3E,mCAAmC;QACnC,IAAI,QAAQ,CAAC,YAAY,EAAE,CAAC;YAC1B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QAC5C,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAO,eAAe,CAAC,CAAC;IAC9C,CAAC;IAED;;;OAGG;IACH,MAAM;QACJ,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACzB,CAAC;CACF;AA/DD,gCA+DC"}

package/dist/clients/billing.client.d.ts

@@ -0,0 +1,79 @@
+import { HttpClient } from '../utils/http-client';
+import { BillingPortalResponse, CheckoutSessionResponse, Invoice, Tier } from '../types';
+/**
+ * BillingClient - Handles subscription and billing operations
+ *
+ * @example
+ * ```typescript
+ * const billing = new BillingClient(httpClient);
+ *
+ * // Upgrade to Professional tier
+ * const checkout = await billing.createCheckoutSession('professional');
+ * window.location.href = checkout.url; // Redirect to Stripe
+ *
+ * // Access billing portal
+ * const portal = await billing.createPortalSession();
+ * window.location.href = portal.url; // Manage subscription
+ *
+ * // Get invoices
+ * const invoices = await billing.getInvoices();
+ * ```
+ */
+export declare class BillingClient {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * Create Stripe Checkout session for subscription upgrade
+     *
+     * Returns a URL to redirect the user to Stripe Checkout
+     *
+     * @param tier - Target tier ('starter', 'professional', 'enterprise')
+     * @param successUrl - URL to redirect after successful payment (optional)
+     * @param cancelUrl - URL to redirect if user cancels (optional)
+     * @returns Checkout session with redirect URL
+     */
+    createCheckoutSession(tier: Exclude<Tier, 'free'>, successUrl?: string, cancelUrl?: string): Promise<CheckoutSessionResponse>;
+    /**
+     * Create Stripe Customer Portal session
+     *
+     * Returns a URL to redirect the user to Stripe Customer Portal
+     * where they can manage their subscription, payment methods, and view invoices
+     *
+     * @param returnUrl - URL to return to after portal session (optional)
+     * @returns Portal session with redirect URL
+     */
+    createPortalSession(returnUrl?: string): Promise<BillingPortalResponse>;
+    /**
+     * Get all invoices for the current user
+     *
+     * @param limit - Maximum number of invoices to return (optional)
+     * @returns Array of invoices
+     */
+    getInvoices(limit?: number): Promise<Invoice[]>;
+    /**
+     * Get specific invoice by ID
+     *
+     * @param invoiceId - Stripe invoice ID
+     * @returns Invoice data
+     */
+    getInvoice(invoiceId: string): Promise<Invoice>;
+    /**
+     * Cancel subscription at end of current billing period
+     *
+     * User will keep access until period ends, then downgrade to free tier
+     *
+     * @returns Success response
+     */
+    cancelSubscription(): Promise<{
+        message: string;
+    }>;
+    /**
+     * Reactivate a canceled subscription before period ends
+     *
+     * @returns Success response
+     */
+    reactivateSubscription(): Promise<{
+        message: string;
+    }>;
+}
+//# sourceMappingURL=billing.client.d.ts.map

package/dist/clients/billing.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.client.d.ts","sourceRoot":"","sources":["../../src/clients/billing.client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,OAAO,EACP,IAAI,EACL,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC;;;;;;;;;OASG;IACG,qBAAqB,CACzB,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,EAC3B,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,uBAAuB,CAAC;IAWnC;;;;;;;;OAQG;IACG,mBAAmB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAU7E;;;;;OAKG;IACG,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAOrD;;;;;OAKG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrD;;;;;;OAMG;IACG,kBAAkB,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAIxD;;;;OAIG;IACG,sBAAsB,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAK7D"}

package/dist/clients/billing.client.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BillingClient = void 0;
+/**
+ * BillingClient - Handles subscription and billing operations
+ *
+ * @example
+ * ```typescript
+ * const billing = new BillingClient(httpClient);
+ *
+ * // Upgrade to Professional tier
+ * const checkout = await billing.createCheckoutSession('professional');
+ * window.location.href = checkout.url; // Redirect to Stripe
+ *
+ * // Access billing portal
+ * const portal = await billing.createPortalSession();
+ * window.location.href = portal.url; // Manage subscription
+ *
+ * // Get invoices
+ * const invoices = await billing.getInvoices();
+ * ```
+ */
+class BillingClient {
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Create Stripe Checkout session for subscription upgrade
+     *
+     * Returns a URL to redirect the user to Stripe Checkout
+     *
+     * @param tier - Target tier ('starter', 'professional', 'enterprise')
+     * @param successUrl - URL to redirect after successful payment (optional)
+     * @param cancelUrl - URL to redirect if user cancels (optional)
+     * @returns Checkout session with redirect URL
+     */
+    async createCheckoutSession(tier, successUrl, cancelUrl) {
+        const body = { tier };
+        if (successUrl)
+            body.successUrl = successUrl;
+        if (cancelUrl)
+            body.cancelUrl = cancelUrl;
+        return this.http.post('/billing/create-checkout-session', body);
+    }
+    /**
+     * Create Stripe Customer Portal session
+     *
+     * Returns a URL to redirect the user to Stripe Customer Portal
+     * where they can manage their subscription, payment methods, and view invoices
+     *
+     * @param returnUrl - URL to return to after portal session (optional)
+     * @returns Portal session with redirect URL
+     */
+    async createPortalSession(returnUrl) {
+        const body = {};
+        if (returnUrl)
+            body.returnUrl = returnUrl;
+        return this.http.post('/billing/create-portal-session', body);
+    }
+    /**
+     * Get all invoices for the current user
+     *
+     * @param limit - Maximum number of invoices to return (optional)
+     * @returns Array of invoices
+     */
+    async getInvoices(limit) {
+        const params = {};
+        if (limit)
+            params.limit = limit;
+        return this.http.get('/billing/invoices', { params });
+    }
+    /**
+     * Get specific invoice by ID
+     *
+     * @param invoiceId - Stripe invoice ID
+     * @returns Invoice data
+     */
+    async getInvoice(invoiceId) {
+        return this.http.get(`/billing/invoices/${invoiceId}`);
+    }
+    /**
+     * Cancel subscription at end of current billing period
+     *
+     * User will keep access until period ends, then downgrade to free tier
+     *
+     * @returns Success response
+     */
+    async cancelSubscription() {
+        return this.http.post('/billing/cancel-subscription');
+    }
+    /**
+     * Reactivate a canceled subscription before period ends
+     *
+     * @returns Success response
+     */
+    async reactivateSubscription() {
+        return this.http.post('/billing/reactivate-subscription');
+    }
+}
+exports.BillingClient = BillingClient;
+//# sourceMappingURL=billing.client.js.map

package/dist/clients/billing.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.client.js","sourceRoot":"","sources":["../../src/clients/billing.client.ts"],"names":[],"mappings":";;;AAQA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAa,aAAa;IACxB,YAAoB,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAExC;;;;;;;;;OASG;IACH,KAAK,CAAC,qBAAqB,CACzB,IAA2B,EAC3B,UAAmB,EACnB,SAAkB;QAElB,MAAM,IAAI,GAAQ,EAAE,IAAI,EAAE,CAAC;QAC3B,IAAI,UAAU;YAAE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7C,IAAI,SAAS;YAAE,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAE1C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CACnB,kCAAkC,EAClC,IAAI,CACL,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,mBAAmB,CAAC,SAAkB;QAC1C,MAAM,IAAI,GAAQ,EAAE,CAAC;QACrB,IAAI,SAAS;YAAE,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAE1C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CACnB,gCAAgC,EAChC,IAAI,CACL,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,WAAW,CAAC,KAAc;QAC9B,MAAM,MAAM,GAAQ,EAAE,CAAC;QACvB,IAAI,KAAK;YAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;QAEhC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAY,mBAAmB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACnE,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,UAAU,CAAC,SAAiB;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAU,qBAAqB,SAAS,EAAE,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,kBAAkB;QACtB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAsB,8BAA8B,CAAC,CAAC;IAC7E,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,sBAAsB;QAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CACnB,kCAAkC,CACnC,CAAC;IACJ,CAAC;CACF;AA3FD,sCA2FC"}

package/dist/clients/geo.client.d.ts

@@ -0,0 +1,105 @@
+import { HttpClient } from '../utils/http-client';
+import { Country, State, City, GeoSearchParams, PaginatedResponse } from '../types';
+/**
+ * GeoClient - Handles geography data queries
+ *
+ * @example
+ * ```typescript
+ * const geo = new GeoClient(httpClient);
+ *
+ * // Get all countries
+ * const countries = await geo.getCountries();
+ *
+ * // Get country by ISO code
+ * const usa = await geo.getCountryByIso('US');
+ *
+ * // Get states of a country
+ * const usStates = await geo.getStates('US');
+ *
+ * // Search for cities
+ * const cities = await geo.searchCities({ query: 'New York', limit: 10 });
+ * ```
+ */
+export declare class GeoClient {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * Get all countries
+     *
+     * @param limit - Maximum number of results (optional)
+     * @param offset - Pagination offset (optional)
+     * @returns Array of countries
+     */
+    getCountries(limit?: number, offset?: number): Promise<Country[]>;
+    /**
+     * Get country by ISO2 code
+     *
+     * @param iso2 - ISO2 country code (e.g., 'US', 'CA', 'MX')
+     * @returns Country data
+     */
+    getCountryByIso(iso2: string): Promise<Country>;
+    /**
+     * Get states/provinces of a country
+     *
+     * @param countryIso2 - ISO2 country code
+     * @param limit - Maximum number of results (optional)
+     * @param offset - Pagination offset (optional)
+     * @returns Array of states
+     */
+    getStates(countryIso2: string, limit?: number, offset?: number): Promise<State[]>;
+    /**
+     * Get state by ID
+     *
+     * @param stateId - State ID
+     * @returns State data
+     */
+    getStateById(stateId: number): Promise<State>;
+    /**
+     * Get cities of a state
+     *
+     * @param stateId - State ID
+     * @param limit - Maximum number of results (optional)
+     * @param offset - Pagination offset (optional)
+     * @returns Array of cities
+     */
+    getCities(stateId: number, limit?: number, offset?: number): Promise<City[]>;
+    /**
+     * Get city by ID
+     *
+     * @param cityId - City ID
+     * @returns City data
+     */
+    getCityById(cityId: number): Promise<City>;
+    /**
+     * Search for countries, states, or cities
+     *
+     * @param params - Search parameters (query, limit, offset, type)
+     * @returns Paginated search results
+     */
+    search(params: GeoSearchParams): Promise<PaginatedResponse<any>>;
+    /**
+     * Search specifically for countries
+     *
+     * @param query - Search query
+     * @param limit - Maximum number of results (optional)
+     * @returns Array of matching countries
+     */
+    searchCountries(query: string, limit?: number): Promise<Country[]>;
+    /**
+     * Search specifically for states
+     *
+     * @param query - Search query
+     * @param limit - Maximum number of results (optional)
+     * @returns Array of matching states
+     */
+    searchStates(query: string, limit?: number): Promise<State[]>;
+    /**
+     * Search specifically for cities
+     *
+     * @param query - Search query
+     * @param limit - Maximum number of results (optional)
+     * @returns Array of matching cities
+     */
+    searchCities(query: string, limit?: number): Promise<City[]>;
+}
+//# sourceMappingURL=geo.client.d.ts.map

package/dist/clients/geo.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geo.client.d.ts","sourceRoot":"","sources":["../../src/clients/geo.client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EACL,OAAO,EACP,KAAK,EACL,IAAI,EACJ,eAAe,EACf,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,SAAS;IACR,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC;;;;;;OAMG;IACG,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAQvE;;;;;OAKG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrD;;;;;;;OAOG;IACG,SAAS,CACb,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,KAAK,EAAE,CAAC;IAWnB;;;;;OAKG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAInD;;;;;;;OAOG;IACG,SAAS,CACb,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,EAAE,CAAC;IAQlB;;;;;OAKG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD;;;;;OAKG;IACG,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAItE;;;;;;OAMG;IACG,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAMxE;;;;;;OAMG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAMnE;;;;;;OAMG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;CAKnE"}