kotanipay-sdk 1.0.0

package/README.md

@@ -0,0 +1,329 @@
+# KotaniPay TypeScript/JavaScript SDK
+
+Official TypeScript/JavaScript SDK for the KotaniPay API. Simplify crypto-to-mobile money transactions across Africa.
+
+## Features
+
+- 🚀 **TypeScript Support** - Full type definitions included
+- 🔐 **Authentication Management** - Magic link login flow
+- 📱 **Mobile Money** - Create and manage mobile money customers
+- 🏢 **Integrator Management** - Create and manage integrator accounts
+- 🛡️ **Error Handling** - Comprehensive error types and validation
+- 🌍 **Multi-Environment** - Sandbox and production support
+
+## Installation
+
+```bash
+npm install @kotanipay/sdk
+```
+
+```bash
+yarn add @kotanipay/sdk
+```
+
+## Quick Start
+
+```typescript
+import { KotaniPayClient } from '@kotanipay/sdk';
+
+// Initialize client
+const client = new KotaniPayClient({
+  environment: 'sandbox' // or 'production'
+});
+
+// Create integrator (no auth required)
+const integrator = await client.integrator.create({
+  organization: 'My Company',
+  product_name: 'My Product',
+  first_name: 'John',
+  last_name: 'Doe',
+  email: 'john@company.com',
+  phone: '+1234567890',
+  country_code: 'US'
+});
+
+// Start authentication flow
+await client.auth.login('john@company.com');
+// User receives magic link in email...
+
+// After user clicks magic link, set session
+client.initializeWithSession(sessionData);
+
+// Generate API key
+const apiKey = await client.auth.generateApiKey();
+client.initializeWithApiKey(apiKey.key);
+
+// Create mobile money customer
+const customer = await client.mobileMoney.createCustomer({
+  phone_number: '+254700123456',
+  country_code: 'KEN',
+  network: 'MPESA',
+  account_name: 'John Doe'
+});
+```
+
+## Authentication Flow
+
+KotaniPay uses a magic link authentication system:
+
+1. **Send Magic Link**: Call `client.auth.login(email)`
+2. **User Action**: User clicks verification link in email
+3. **Get Session Data**: Copy JSON response from browser
+4. **Initialize Session**: Call `client.initializeWithSession(sessionData)`
+5. **Generate API Key**: Call `client.auth.generateApiKey()`
+6. **Ready**: Use authenticated endpoints
+
+### Example Session Data
+
+When user clicks the magic link, they'll see JSON like this:
+
+```json
+{
+  "success": true,
+  "message": "ok",
+  "data": {
+    "user_id": "66262fda6c7024bcf925636f",
+    "session_id": "8d1d3429b8075d53993c58a3a1b3bcec",
+    "token_id": "PrsCEicJ",
+    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
+    "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
+  }
+}
+```
+
+Pass the `data` object to `initializeWithSession()`.
+
+## API Reference
+
+### Client Initialization
+
+```typescript
+const client = new KotaniPayClient({
+  environment: 'sandbox' | 'production',
+  timeout?: number,
+  apiKey?: string // Optional: for direct API key usage
+});
+```
+
+### Integrator Management
+
+```typescript
+// Create integrator (no auth required)
+await client.integrator.create({
+  organization: string,
+  product_name: string,
+  first_name: string,
+  last_name: string,
+  email: string,
+  phone: string,
+  country_code: string
+});
+
+// Get integrator by ID (requires auth)
+await client.integrator.getById(id);
+```
+
+### Authentication
+
+```typescript
+// Send magic link
+await client.auth.login(email);
+
+// Set session after magic link click
+client.initializeWithSession(sessionData);
+
+// Generate API key
+await client.auth.generateApiKey();
+
+// Set API key directly
+client.initializeWithApiKey(apiKey);
+
+// Check authentication status
+client.isAuthenticated();
+```
+
+### Mobile Money
+
+```typescript
+// Create customer (requires auth)
+await client.mobileMoney.createCustomer({
+  phone_number: string,
+  country_code: 'GHA' | 'KEN' | 'ZAC' | 'CIV' | ...,
+  network?: 'MPESA' | 'MTN' | 'AIRTEL' | ...,
+  account_name?: string
+});
+
+// Get all customers (requires auth)
+await client.mobileMoney.getAllCustomers();
+
+// Get customer by ID (requires auth)
+await client.mobileMoney.getCustomerById(id);
+```
+
+## Supported Countries & Networks
+
+### Countries
+
+- 🇬🇭 Ghana (GHA)
+- 🇰🇪 Kenya (KEN)
+- 🇿🇦 South Africa (ZAC)
+- 🇨🇮 Ivory Coast (CIV)
+- 🇿🇲 Zambia (ZMB)
+- And more...
+
+### Networks
+
+- M-Pesa
+- MTN Mobile Money
+- Airtel Money
+- Vodafone Cash
+- Tigo Pesa
+- Orange Money
+
+## Error Handling
+
+```typescript
+import { ValidationError, AuthenticationError, KotaniPayError } from '@kotanipay/sdk';
+
+try {
+  await client.mobileMoney.createCustomer(customerData);
+} catch (error) {
+  if (error instanceof ValidationError) {
+    console.log('Validation error:', error.message);
+  } else if (error instanceof AuthenticationError) {
+    console.log('Auth error:', error.message);
+  } else if (error instanceof KotaniPayError) {
+    console.log('API error:', error.message, error.statusCode);
+  }
+}
+```
+
+## Environment Variables
+
+For server-side usage, you can set:
+
+```bash
+KOTANIPAY_API_KEY=your-api-key
+KOTANIPAY_ENVIRONMENT=sandbox
+```
+
+## Examples
+
+### React Integration
+
+```typescript
+import React, { useState } from 'react';
+import { KotaniPayClient } from '@kotanipay/sdk';
+
+function PaymentComponent() {
+  const [client] = useState(() => new KotaniPayClient({
+    environment: 'sandbox'
+  }));
+  
+  const [authStatus, setAuthStatus] = useState('idle');
+
+  const handleLogin = async (email: string) => {
+    try {
+      setAuthStatus('sending');
+      await client.auth.login(email);
+      setAuthStatus('waiting'); // Wait for user to click magic link
+    } catch (error) {
+      setAuthStatus('error');
+    }
+  };
+
+  const handleSessionData = async (sessionData: any) => {
+    try {
+      client.initializeWithSession(sessionData);
+      const apiKey = await client.auth.generateApiKey();
+      client.initializeWithApiKey(apiKey.key);
+      setAuthStatus('authenticated');
+    } catch (error) {
+      setAuthStatus('error');
+    }
+  };
+
+  return (
+    <div>
+      {authStatus === 'idle' && (
+        <button onClick={() => handleLogin('user@example.com')}>
+          Login with Email
+        </button>
+      )}
+      {authStatus === 'waiting' && (
+        <div>
+          <p>Magic link sent! Check your email.</p>
+          <textarea 
+            placeholder="Paste session data here..."
+            onChange={(e) => {
+              try {
+                const data = JSON.parse(e.target.value);
+                handleSessionData(data.data);
+              } catch {}
+            }}
+          />
+        </div>
+      )}
+      {authStatus === 'authenticated' && (
+        <p>Ready to make payments!</p>
+      )}
+    </div>
+  );
+}
+```
+
+### Node.js Integration
+
+```typescript
+import { KotaniPayClient } from '@kotanipay/sdk';
+
+const client = new KotaniPayClient({
+  environment: 'sandbox',
+  apiKey: process.env.KOTANIPAY_API_KEY // If you already have an API key
+});
+
+async function processPayment() {
+  try {
+    // Create customer
+    const customer = await client.mobileMoney.createCustomer({
+      phone_number: '+254700123456',
+      country_code: 'KEN',
+      network: 'MPESA'
+    });
+    
+    console.log('Customer created:', customer);
+    return customer;
+  } catch (error) {
+    console.error('Payment failed:', error);
+    throw error;
+  }
+}
+```
+
+## Contributing
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.
+
+## Support
+
+- 📧 **Email**: support@kotanipay.com
+- 📖 **Documentation**: https://docs.kotanipay.com
+- 🐛 **Issues**: https://github.com/kotanipay/sdk-typescript/issues
+
+## Changelog
+
+### v1.0.0
+
+- Initial release
+- Magic link authentication
+- Integrator management
+- Mobile money customer management
+- TypeScript support

package/dist/cjs/client/index.d.ts

@@ -0,0 +1,2 @@
+export * from './kotani-pay.client';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}

package/dist/cjs/client/index.js

@@ -0,0 +1,18 @@
+"use strict";
+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 });
+__exportStar(require("./kotani-pay.client"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC"}

package/dist/cjs/client/kotani-pay.client.d.ts

@@ -0,0 +1,42 @@
+import { IntegratorService } from '../modules/integrator';
+import { AuthService } from '../modules/auth';
+import { MobileMoneyService } from '../modules/mobile-money/mobile-money.service';
+import { KotaniPayConfig, AuthenticatedSession } from '../types';
+export declare class KotaniPayClient {
+    private httpClient;
+    integrator: IntegratorService;
+    auth: AuthService;
+    mobileMoney: MobileMoneyService;
+    constructor(config: KotaniPayConfig);
+    /**
+     * Initialize client with session data after user login
+     */
+    initializeWithSession(sessionData: AuthenticatedSession): void;
+    /**
+     * Initialize client with API key (for authenticated operations)
+     */
+    initializeWithApiKey(apiKey: string): void;
+    healthCheck(): Promise<{
+        status: string;
+        timestamp: string;
+    }>;
+    getConfig(): {
+        environment: string;
+        baseURL: string;
+    };
+    getVersion(): string;
+    /**
+     * Check if client is authenticated
+     */
+    isAuthenticated(): boolean;
+    /**
+     * Get authentication status with detailed info
+     */
+    getAuthStatus(): {
+        isAuthenticated: boolean;
+        hasSession: boolean;
+        hasApiKey: boolean;
+        tokenInfo?: any;
+    };
+}
+//# sourceMappingURL=kotani-pay.client.d.ts.map

package/dist/cjs/client/kotani-pay.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kotani-pay.client.d.ts","sourceRoot":"","sources":["../../../src/client/kotani-pay.client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAClF,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAEjE,qBAAa,eAAe;IAC1B,OAAO,CAAC,UAAU,CAAiB;IAC5B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,kBAAkB,CAAC;gBAE3B,MAAM,EAAE,eAAe;IAUnC;;OAEG;IACH,qBAAqB,CAAC,WAAW,EAAE,oBAAoB,GAAG,IAAI;IAI9D;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIpC,WAAW,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAKnE,SAAS,IAAI;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAIrD,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,aAAa,IAAI;QACf,eAAe,EAAE,OAAO,CAAC;QACzB,UAAU,EAAE,OAAO,CAAC;QACpB,SAAS,EAAE,OAAO,CAAC;QACnB,SAAS,CAAC,EAAE,GAAG,CAAC;KACjB;CAYF"}

package/dist/cjs/client/kotani-pay.client.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KotaniPayClient = void 0;
+const http_client_util_1 = require("../utils/http-client.util");
+const integrator_1 = require("../modules/integrator");
+const auth_1 = require("../modules/auth");
+const mobile_money_service_1 = require("../modules/mobile-money/mobile-money.service");
+class KotaniPayClient {
+    constructor(config) {
+        // Create HTTP client with config
+        this.httpClient = new http_client_util_1.HttpClientUtil(config);
+        // Initialize services
+        this.integrator = new integrator_1.IntegratorService(this.httpClient);
+        this.auth = new auth_1.AuthService(this.httpClient);
+        this.mobileMoney = new mobile_money_service_1.MobileMoneyService(this.httpClient);
+    }
+    /**
+     * Initialize client with session data after user login
+     */
+    initializeWithSession(sessionData) {
+        this.auth.setSession(sessionData);
+    }
+    /**
+     * Initialize client with API key (for authenticated operations)
+     */
+    initializeWithApiKey(apiKey) {
+        this.httpClient.setAuthToken(apiKey, 'Bearer');
+    }
+    async healthCheck() {
+        const response = await this.httpClient.get('/health');
+        return response;
+    }
+    getConfig() {
+        return this.httpClient.getConfig();
+    }
+    getVersion() {
+        return '1.0.0';
+    }
+    /**
+     * Check if client is authenticated
+     */
+    isAuthenticated() {
+        return this.auth.isAuthenticated() || !!this.httpClient.getAuthToken();
+    }
+    /**
+     * Get authentication status with detailed info
+     */
+    getAuthStatus() {
+        const hasSession = !!this.auth.getSession();
+        const hasApiKey = !!this.httpClient.getAuthToken();
+        const tokenInfo = this.auth.getTokenInfo ? this.auth.getTokenInfo() : null;
+        return {
+            isAuthenticated: this.isAuthenticated(),
+            hasSession,
+            hasApiKey,
+            tokenInfo
+        };
+    }
+}
+exports.KotaniPayClient = KotaniPayClient;
+//# sourceMappingURL=kotani-pay.client.js.map

package/dist/cjs/client/kotani-pay.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kotani-pay.client.js","sourceRoot":"","sources":["../../../src/client/kotani-pay.client.ts"],"names":[],"mappings":";;;AACA,gEAA2D;AAC3D,sDAA0D;AAC1D,0CAA8C;AAC9C,uFAAkF;AAGlF,MAAa,eAAe;IAM1B,YAAY,MAAuB;QACjC,iCAAiC;QACjC,IAAI,CAAC,UAAU,GAAG,IAAI,iCAAc,CAAC,MAAM,CAAC,CAAC;QAE7C,sBAAsB;QACtB,IAAI,CAAC,UAAU,GAAG,IAAI,8BAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,GAAG,IAAI,kBAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,CAAC,WAAW,GAAG,IAAI,yCAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACH,qBAAqB,CAAC,WAAiC;QACrD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,oBAAoB,CAAC,MAAc;QACjC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,WAAW;QACf,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAwC,SAAS,CAAC,CAAC;QAC7F,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC;IACrC,CAAC;IAED,UAAU;QACR,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC;IACzE,CAAC;IAED;;OAEG;IACH,aAAa;QAMX,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QAC5C,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC;QACnD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAE3E,OAAO;YACL,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE;YACvC,UAAU;YACV,SAAS;YACT,SAAS;SACV,CAAC;IACJ,CAAC;CACF;AAtED,0CAsEC"}

package/dist/cjs/exceptions/index.d.ts

@@ -0,0 +1,2 @@
+export * from './kotani-pay.exception';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/exceptions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/exceptions/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC"}

package/dist/cjs/exceptions/index.js

@@ -0,0 +1,18 @@
+"use strict";
+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 });
+__exportStar(require("./kotani-pay.exception"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/exceptions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/exceptions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAuC"}

package/dist/cjs/exceptions/kotani-pay.exception.d.ts

@@ -0,0 +1,31 @@
+export declare enum HttpStatus {
+    OK = 200,
+    CREATED = 201,
+    BAD_REQUEST = 400,
+    UNAUTHORIZED = 401,
+    FORBIDDEN = 403,
+    NOT_FOUND = 404,
+    INTERNAL_SERVER_ERROR = 500
+}
+export declare class KotaniPayException extends Error {
+    readonly status: HttpStatus;
+    readonly errorCode?: string;
+    readonly details?: any;
+    readonly timestamp: string;
+    constructor(message: string, status?: HttpStatus, errorCode?: string, details?: any);
+    toJSON(): {
+        name: string;
+        message: string;
+        status: HttpStatus;
+        errorCode: string | undefined;
+        details: any;
+        timestamp: string;
+    };
+}
+export declare class ValidationException extends KotaniPayException {
+    constructor(message: string, details?: any);
+}
+export declare class AuthenticationException extends KotaniPayException {
+    constructor(message?: string);
+}
+//# sourceMappingURL=kotani-pay.exception.d.ts.map

package/dist/cjs/exceptions/kotani-pay.exception.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kotani-pay.exception.d.ts","sourceRoot":"","sources":["../../../src/exceptions/kotani-pay.exception.ts"],"names":[],"mappings":"AAAA,oBAAY,UAAU;IACpB,EAAE,MAAM;IACR,OAAO,MAAM;IACb,WAAW,MAAM;IACjB,YAAY,MAAM;IAClB,SAAS,MAAM;IACf,SAAS,MAAM;IACf,qBAAqB,MAAM;CAC5B;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,SAAgB,MAAM,EAAE,UAAU,CAAC;IACnC,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnC,SAAgB,OAAO,CAAC,EAAE,GAAG,CAAC;IAC9B,SAAgB,SAAS,EAAE,MAAM,CAAC;gBAGhC,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,UAA6C,EACrD,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,GAAG;IAUf,MAAM;;;;;;;;CAUP;AAED,qBAAa,mBAAoB,SAAQ,kBAAkB;gBAC7C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAI3C;AAED,qBAAa,uBAAwB,SAAQ,kBAAkB;gBACjD,OAAO,GAAE,MAAgC;CAItD"}

package/dist/cjs/exceptions/kotani-pay.exception.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuthenticationException = exports.ValidationException = exports.KotaniPayException = exports.HttpStatus = void 0;
+var HttpStatus;
+(function (HttpStatus) {
+    HttpStatus[HttpStatus["OK"] = 200] = "OK";
+    HttpStatus[HttpStatus["CREATED"] = 201] = "CREATED";
+    HttpStatus[HttpStatus["BAD_REQUEST"] = 400] = "BAD_REQUEST";
+    HttpStatus[HttpStatus["UNAUTHORIZED"] = 401] = "UNAUTHORIZED";
+    HttpStatus[HttpStatus["FORBIDDEN"] = 403] = "FORBIDDEN";
+    HttpStatus[HttpStatus["NOT_FOUND"] = 404] = "NOT_FOUND";
+    HttpStatus[HttpStatus["INTERNAL_SERVER_ERROR"] = 500] = "INTERNAL_SERVER_ERROR";
+})(HttpStatus || (exports.HttpStatus = HttpStatus = {}));
+class KotaniPayException extends Error {
+    constructor(message, status = HttpStatus.INTERNAL_SERVER_ERROR, errorCode, details) {
+        super(message);
+        this.name = 'KotaniPayException';
+        this.status = status;
+        this.errorCode = errorCode;
+        this.details = details;
+        this.timestamp = new Date().toISOString();
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            status: this.status,
+            errorCode: this.errorCode,
+            details: this.details,
+            timestamp: this.timestamp,
+        };
+    }
+}
+exports.KotaniPayException = KotaniPayException;
+class ValidationException extends KotaniPayException {
+    constructor(message, details) {
+        super(message, HttpStatus.BAD_REQUEST, 'VALIDATION_ERROR', details);
+        this.name = 'ValidationException';
+    }
+}
+exports.ValidationException = ValidationException;
+class AuthenticationException extends KotaniPayException {
+    constructor(message = 'Authentication failed') {
+        super(message, HttpStatus.UNAUTHORIZED, 'AUTHENTICATION_ERROR');
+        this.name = 'AuthenticationException';
+    }
+}
+exports.AuthenticationException = AuthenticationException;
+//# sourceMappingURL=kotani-pay.exception.js.map

package/dist/cjs/exceptions/kotani-pay.exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kotani-pay.exception.js","sourceRoot":"","sources":["../../../src/exceptions/kotani-pay.exception.ts"],"names":[],"mappings":";;;AAAA,IAAY,UAQX;AARD,WAAY,UAAU;IACpB,yCAAQ,CAAA;IACR,mDAAa,CAAA;IACb,2DAAiB,CAAA;IACjB,6DAAkB,CAAA;IAClB,uDAAe,CAAA;IACf,uDAAe,CAAA;IACf,+EAA2B,CAAA;AAC7B,CAAC,EARW,UAAU,0BAAV,UAAU,QAQrB;AAED,MAAa,kBAAmB,SAAQ,KAAK;IAM3C,YACE,OAAe,EACf,SAAqB,UAAU,CAAC,qBAAqB,EACrD,SAAkB,EAClB,OAAa;QAEb,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,CAAC;IAED,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;IACJ,CAAC;CACF;AA9BD,gDA8BC;AAED,MAAa,mBAAoB,SAAQ,kBAAkB;IACzD,YAAY,OAAe,EAAE,OAAa;QACxC,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,WAAW,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;QACpE,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AALD,kDAKC;AAED,MAAa,uBAAwB,SAAQ,kBAAkB;IAC7D,YAAY,UAAkB,uBAAuB;QACnD,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,YAAY,EAAE,sBAAsB,CAAC,CAAC;QAChE,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AALD,0DAKC"}

package/dist/cjs/index.d.ts

@@ -0,0 +1,6 @@
+export { KotaniPayClient } from './client';
+export * from './modules';
+export * from './types';
+export * from './utils';
+export { KotaniPayClient as default } from './client';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,eAAe,IAAI,OAAO,EAAE,MAAM,UAAU,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,25 @@
+"use strict";
+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.default = exports.KotaniPayClient = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "KotaniPayClient", { enumerable: true, get: function () { return client_1.KotaniPayClient; } });
+__exportStar(require("./modules"), exports);
+__exportStar(require("./types"), exports);
+__exportStar(require("./utils"), exports);
+var client_2 = require("./client");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return client_2.KotaniPayClient; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,mCAA2C;AAAlC,yGAAA,eAAe,OAAA;AACxB,4CAA0B;AAC1B,0CAAwB;AACxB,0CAAwB;AAGxB,mCAAsD;AAA7C,iGAAA,eAAe,OAAW"}

package/dist/cjs/modules/auth/auth.service.d.ts

@@ -0,0 +1,37 @@
+import { HttpClientUtil } from '../../utils/http-client.util';
+import { LoginResponse, ApiKeyResponse, GenerateApiKeyRequest, AuthenticatedSession } from '../../types';
+export declare class AuthService {
+    private httpClient;
+    private session?;
+    constructor(httpClient: HttpClientUtil);
+    /**
+     * Login with email - sends login link to email
+     */
+    login(email: string): Promise<LoginResponse>;
+    /**
+     * Set session data after user clicks login link
+     */
+    setSession(sessionData: AuthenticatedSession): void;
+    /**
+     * Generate API key using the JWT token from login
+     */
+    generateApiKey(request?: GenerateApiKeyRequest): Promise<ApiKeyResponse>;
+    /**
+     * Refresh the JWT token using refresh token
+     */
+    refreshToken(): Promise<AuthenticatedSession>;
+    /**
+     * Get current session data
+     */
+    getSession(): AuthenticatedSession | undefined;
+    getTokenInfo(): any;
+    /**
+     * Check if user is authenticated
+     */
+    isAuthenticated(): boolean;
+    /**
+     * Logout and clear session
+     */
+    logout(): void;
+}
+//# sourceMappingURL=auth.service.d.ts.map

package/dist/cjs/modules/auth/auth.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.service.d.ts","sourceRoot":"","sources":["../../../../src/modules/auth/auth.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,EACL,aAAa,EAEb,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAErB,qBAAa,WAAW;IAGV,OAAO,CAAC,UAAU;IAF9B,OAAO,CAAC,OAAO,CAAC,CAAuB;gBAEnB,UAAU,EAAE,cAAc;IAE9C;;OAEG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAelD;;OAEG;IACH,UAAU,CAAC,WAAW,EAAE,oBAAoB,GAAG,IAAI;IAMnD;;OAEG;IACG,cAAc,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC;IAY9E;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAgBnD;;OAEG;IACH,UAAU,IAAI,oBAAoB,GAAG,SAAS;IAI7C,YAAY,IAAI,GAAG;IAIpB;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,MAAM,IAAI,IAAI;CAIf"}