@monarkmarkets/api-client 1.0.2 → 1.0.3

package/README.md

@@ -0,0 +1,157 @@
+# @monarkmarkets/api-client
+
+This package provides a TypeScript client for interacting with the Monark Markets API.
+
+## Installation
+
+```bash
+npm install @monarkmarkets/api-client
+```
+
+## Usage
+
+To use this client, you'll need to set up a simple proxy server that forwards requests to the Monark API with the appropriate authentication.
+
+### Important: API Proxy Server Requirement
+
+This client requires a server running under the `/api` path that forwards requests to the Monark API with authentication. This proxy server:
+
+1. Injects authentication credentials
+2. Forwards all requests to the Monark API
+3. Returns the responses to the client
+
+## Setting up a Proxy Server
+
+Below is an example of a minimal Express.js server that forwards requests to the Monark API:
+
+```javascript
+// server.js
+import express from 'express';
+import axios from "axios";
+import * as dotenv from 'dotenv';
+dotenv.config();
+
+const app = express();
+
+const API_BASE_URL = process.env.API_BASE_URL || 'https://demo-api.monark-markets.com';
+const AUTH_TOKEN = process.env.AUTH_TOKEN;
+
+// Parse JSON payloads
+app.use(express.json());
+
+// API router for forwarding requests
+const apiRouter = express.Router();
+
+apiRouter.use('*', async (req, res) => {
+  try {
+    // Build the target URL by combining base URL and original path
+    let targetUrl = `${API_BASE_URL}${req.originalUrl}`;
+    targetUrl = targetUrl.replace("/api/", "/");
+
+    // Forward the request to the target API
+    const response = await axios({
+      method: req.method,
+      url: targetUrl,
+      data: req.body,
+      headers: {
+        // Add the authorization header
+        'Authorization': `Bearer ${AUTH_TOKEN}`
+      },
+      // Forward query parameters
+      params: req.query,
+      // Handle binary responses
+      responseType: 'arraybuffer'
+    });
+
+    // Set response headers
+    Object.entries(response.headers).forEach(([key, value]) => {
+      // Skip Transfer-Encoding header to prevent conflicts with Express
+      if (key.toLowerCase() !== 'transfer-encoding') {
+        res.set(key, value);
+      }
+    });
+
+    // Send response
+    res.status(response.status).send(response.data);
+
+  } catch (error) {
+    // Handle errors from the target API
+    if (error.response) {
+      res.status(error.response.status).send(error.response.data);
+    } else {
+      res.status(500).json({
+        error: 'Internal Server Error',
+        message: error.message
+      });
+    }
+  }
+});
+
+// Mount API router - all API routes will be prefixed with /api
+app.use('/api', apiRouter);
+
+const PORT = process.env.PORT || 3000;
+app.listen(PORT, () => {
+  console.log(`API proxy server running on port ${PORT}`);
+});
+```
+
+### Environment Variables
+
+Create a `.env` file in your project root:
+
+```env
+API_BASE_URL=https://demo-api.monark-markets.com
+AUTH_TOKEN=your_auth_token_here
+```
+
+## Using the Client
+
+```typescript
+import { Client } from '@monarkmarkets/api-client';
+
+// Initialize the client with the proxy API URL
+const client = new Client('/api');
+
+// Example: Get all PreIPOCompanies
+async function getAllPreIPOCompanies() {
+  try {
+    // You can add optional parameters for search, pagination, etc.
+    const result = await client.preIpoCompany2(
+      undefined, // searchTerm (optional)
+      undefined, // sortOrder (optional)
+      1,         // page
+      10         // pageSize
+    );
+    
+    console.log(`Found ${result.pagination?.totalRecords || 0} companies`);
+    console.log('Companies:', result.items);
+    
+    return result;
+  } catch (error) {
+    console.error('Error fetching PreIPO companies:', error);
+    throw error;
+  }
+}
+
+// Call the function
+getAllPreIPOCompanies();
+```
+
+## Authentication
+
+The API client itself doesn't handle authentication. Instead, authentication happens at the proxy server level by including the `AUTH_TOKEN` in the forwarded requests.
+
+## API Methods
+
+The client provides methods for all API endpoints in the Monark API. Some examples include:
+
+- `preIpoCompany2()` - Get all PreIPO companies
+- `preIpoCompany(id)` - Get a PreIPO company by ID
+- `indicationOfInterestPOST(body)` - Create an indication of interest
+- `investorGET(id)` - Get investor information
+- And many more...
+
+For the full list of available methods, refer to the TypeScript definitions in the client code.
+
+The full API documentation can be found here: <https://api-docs.monark-markets.com/>

package/dist/index.d.ts

@@ -1 +1 @@
-export * from './Client';
+export * from './Client.js';

package/dist/index.js

@@ -1 +1 @@
-export * from './Client';
+export * from './Client.js';

package/package.json

@@ -1,25 +1,25 @@
-{
-  "name": "@monarkmarkets/api-client",
-  "version": "1.0.2",
-  "main": "dist/index.js",
-  "module": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "type": "module",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "require": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Monark-Markets/ui-components.git"
-  },
-  "scripts": {
-    "build": "tsc"
-  },
-  "devDependencies": {
-    "typescript": "^5.7.3"
-  }
+{
+  "name": "@monarkmarkets/api-client",
+  "version": "1.0.3",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Monark-Markets/ui-components.git"
+  },
+  "scripts": {
+    "build": "tsc"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.3"
+  }
 }