@major-tech/resource-client 0.1.1 → 0.1.3

package/README.md

@@ -18,7 +18,7 @@ pnpm install @major-tech/resource-client
 
 **PostgreSQL:**
 ```typescript
-import { PostgresResourceClient } from '@major/resource-client';
+import { PostgresResourceClient } from '@major-tech/resource-client';
 const client = new PostgresResourceClient({ baseUrl, applicationId, resourceId, majorJwtToken? });
 const res = await client.invoke('SELECT * FROM users WHERE id = $1', [123], 'fetch-user-by-id');
 // res.ok ? res.result.rows / res.result.rowsAffected : res.error.message
@@ -26,7 +26,7 @@ const res = await client.invoke('SELECT * FROM users WHERE id = $1', [123], 'fet
 
 **Custom API:**
 ```typescript
-import { CustomApiResourceClient } from '@major/resource-client';
+import { CustomApiResourceClient } from '@major-tech/resource-client';
 const client = new CustomApiResourceClient({ baseUrl, applicationId, resourceId });
 const res = await client.invoke('POST', '/v1/payments', 'create-payment', {
   query: { currency: 'USD' }, headers: { 'X-Custom': 'value' },
@@ -37,7 +37,7 @@ const res = await client.invoke('POST', '/v1/payments', 'create-payment', {
 
 **HubSpot:**
 ```typescript
-import { HubSpotResourceClient } from '@major/resource-client';
+import { HubSpotResourceClient } from '@major-tech/resource-client';
 const client = new HubSpotResourceClient({ baseUrl, applicationId, resourceId });
 const res = await client.invoke('GET', '/crm/v3/objects/contacts', 'fetch-contacts', { query: { limit: '10' } });
 // res.ok && res.result.body.kind === 'json' ? res.result.body.value : res.error
@@ -45,7 +45,7 @@ const res = await client.invoke('GET', '/crm/v3/objects/contacts', 'fetch-contac
 
 **S3:**
 ```typescript
-import { S3ResourceClient } from '@major/resource-client';
+import { S3ResourceClient } from '@major-tech/resource-client';
 const client = new S3ResourceClient({ baseUrl, applicationId, resourceId });
 const res = await client.invoke('ListObjectsV2', { Bucket: 'my-bucket', Prefix: 'uploads/' }, 'list-uploads');
 // res.ok ? res.result.data : res.error
@@ -55,7 +55,7 @@ const url = await client.invoke('GeneratePresignedUrl', { Bucket: 'my-bucket', K
 
 **Error Handling:**
 ```typescript
-import { ResourceInvokeError } from '@major/resource-client';
+import { ResourceInvokeError } from '@major-tech/resource-client';
 try { await client.invoke(...); }
 catch (e) { if (e instanceof ResourceInvokeError) { e.message, e.httpStatus, e.requestId } }
 ```
@@ -64,4 +64,27 @@ catch (e) { if (e instanceof ResourceInvokeError) { e.message, e.httpStatus, e.r
 
 **Types:** All exported: `BaseClientConfig`, `DatabaseInvokeResponse`, `ApiInvokeResponse`, `StorageInvokeResponse`, `HttpMethod`, `QueryParams`, `BodyPayload`, `S3Command`, etc.
 
+## 🛠️ CLI Tool - Generate Singleton Clients
+
+The package includes a CLI tool to generate pre-configured singleton clients for your resources:
+
+```bash
+# Add a resource
+npx major-client add "resource-123" "orders-db" "database-postgresql" "Orders database" "app-456"
+
+# List all resources
+npx major-client list
+
+# Remove a resource
+npx major-client remove "orders-db"
+```
+
+This generates TypeScript files in `src/clients/` that you can import:
+```typescript
+import { ordersDbClient } from './clients';
+const result = await ordersDbClient.invoke('SELECT * FROM orders', [], 'list-orders');
+```
+
+**Types:** `database-postgresql` | `api-custom` | `api-hubspot` | `storage-s3`
+
 MIT License

package/bin/generate-clients.mjs

@@ -0,0 +1,323 @@
+#!/usr/bin/env node
+/**
+ * CLI tool to generate singleton resource clients
+ * Part of @major-tech/resource-client
+ * 
+ * Usage:
+ *   npx @major-tech/resource-client add <resource_id> <name> <type> <description> <application_id>
+ *   npx @major-tech/resource-client remove <name>
+ *   npx @major-tech/resource-client list
+ * 
+ * Types: database-postgresql | api-hubspot | api-custom | storage-s3
+ * 
+ * Examples:
+ *   npx @major-tech/resource-client add "abc-123" "orders-db" "database-postgresql" "Orders database" "app-123"
+ *   npx @major-tech/resource-client add "xyz-789" "payment-api" "api-custom" "Payment API" "app-456"
+ *   npx @major-tech/resource-client remove "orders-db"
+ *   npx @major-tech/resource-client list
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// User's project root (where the command is run from)
+const projectRoot = process.cwd();
+const resourcesConfigPath = path.join(projectRoot, 'resources.json');
+const clientsDir = path.join(projectRoot, 'src', 'clients');
+
+/**
+ * Client template
+ */
+function clientTemplate(data) {
+  return `import { ${data.clientClass} } from '@major-tech/resource-client';
+
+/**
+ * ${data.description}
+ * 
+ * Type: ${data.type}
+ * Resource ID: ${data.resourceId}
+ * Application ID: ${data.applicationId}
+ * 
+ * DO NOT EDIT - Auto-generated by @major-tech/resource-client
+ */
+
+const BASE_URL = import.meta.env.MAJOR_API_BASE_URL || 'https://api.major.tech';
+const MAJOR_JWT_TOKEN = import.meta.env.MAJOR_JWT_TOKEN;
+
+class ${data.clientName}Singleton {
+  private static instance: ${data.clientClass} | null = null;
+
+  static getInstance(): ${data.clientClass} {
+    if (!${data.clientName}Singleton.instance) {
+      ${data.clientName}Singleton.instance = new ${data.clientClass}({
+        baseUrl: BASE_URL,
+        majorJwtToken: MAJOR_JWT_TOKEN,
+        applicationId: '${data.applicationId}',
+        resourceId: '${data.resourceId}',
+      });
+    }
+    return ${data.clientName}Singleton.instance;
+  }
+}
+
+export const ${data.clientName} = ${data.clientName}Singleton.getInstance();
+`;
+}
+
+/**
+ * Index template
+ */
+function indexTemplate(data) {
+  return `/**
+ * Auto-generated client exports
+ * DO NOT EDIT - Generated by @major-tech/resource-client
+ */
+
+${data.exports.join('\n')}
+`;
+}
+
+/**
+ * Load resources from JSON config file
+ */
+function loadResources() {
+  if (!fs.existsSync(resourcesConfigPath)) {
+    return [];
+  }
+  const content = fs.readFileSync(resourcesConfigPath, 'utf-8');
+  return JSON.parse(content);
+}
+
+/**
+ * Save resources to JSON config file
+ */
+function saveResources(resources) {
+  const dir = path.dirname(resourcesConfigPath);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+  fs.writeFileSync(resourcesConfigPath, JSON.stringify(resources, null, 2), 'utf-8');
+}
+
+/**
+ * Convert a resource name to a valid camelCase identifier
+ * e.g., "yo mama" -> "yoMama", "orders-db" -> "ordersDb"
+ */
+function toCamelCase(str) {
+  return str
+    .toLowerCase()
+    .replace(/[^a-z0-9]+(.)/g, (_, char) => char.toUpperCase())
+    .replace(/^[^a-z]+/, ''); // Remove leading non-letters
+}
+
+function getClientClass(type) {
+  const typeMap = {
+    'database-postgresql': 'PostgresResourceClient',
+    'api-custom': 'CustomApiResourceClient',
+    'api-hubspot': 'HubSpotResourceClient',
+    'storage-s3': 'S3ResourceClient',
+  };
+  return typeMap[type] || 'PostgresResourceClient';
+}
+
+function generateClientFile(resource) {
+  const clientName = toCamelCase(resource.name) + 'Client';
+  const clientClass = getClientClass(resource.type);
+
+  return clientTemplate({
+    clientClass,
+    description: resource.description,
+    type: resource.type,
+    resourceId: resource.id,
+    applicationId: resource.applicationId,
+    clientName,
+  });
+}
+
+function generateIndexFile(resources) {
+  if (resources.length === 0) {
+    return `// No clients configured\n`;
+  }
+
+  const exports = resources.map(resource => {
+    const clientName = toCamelCase(resource.name) + 'Client';
+    const fileName = toCamelCase(resource.name);
+    return `export { ${clientName} } from './${fileName}';`;
+  });
+
+  return indexTemplate({ exports });
+}
+
+function addResource(resourceId, name, type, description, applicationId) {
+  const validTypes = ['database-postgresql', 'api-hubspot', 'api-custom', 'storage-s3'];
+  if (!validTypes.includes(type)) {
+    console.error(`❌ Invalid type: ${type}`);
+    console.log(`   Valid types: ${validTypes.join(', ')}`);
+    process.exit(1);
+  }
+
+  if (!applicationId) {
+    console.error('❌ Application ID is required');
+    process.exit(1);
+  }
+
+  const resources = loadResources();
+  
+  const existing = resources.find(r => r.name === name);
+  if (existing) {
+    console.error(`❌ Resource with name "${name}" already exists`);
+    process.exit(1);
+  }
+  
+  const newResource = {
+    id: resourceId,
+    name,
+    type,
+    description,
+    applicationId
+  };
+  
+  resources.push(newResource);
+  saveResources(resources);
+  
+  console.log(`✅ Added resource: ${name}`);
+  console.log(`   Type: ${type}`);
+  console.log(`   ID: ${resourceId}`);
+  
+  regenerateClients(resources);
+}
+
+/**
+ * Remove a resource by name
+ */
+function removeResource(name) {
+  const resources = loadResources();
+  const index = resources.findIndex(r => r.name === name);
+  
+  if (index === -1) {
+    console.error(`❌ Resource "${name}" not found`);
+    process.exit(1);
+  }
+  
+  const removed = resources.splice(index, 1)[0];
+  saveResources(resources);
+  
+  console.log(`✅ Removed resource: ${removed.name}`);
+  console.log(`   ID: ${removed.id}`);
+  
+  regenerateClients(resources);
+}
+
+/**
+ * List all resources
+ */
+function listResources() {
+  const resources = loadResources();
+  
+  if (resources.length === 0) {
+    console.log('No resources configured');
+    return;
+  }
+  
+  console.log(`Resources (${resources.length}):\n`);
+  resources.forEach((r, idx) => {
+    console.log(`${idx + 1}. ${r.name} (${r.type})`);
+    console.log(`   ID: ${r.id}`);
+    console.log(`   Client: ${toCamelCase(r.name)}Client`);
+    console.log('');
+  });
+}
+
+/**
+ * Regenerate all client files
+ */
+function regenerateClients(resources) {
+  // Ensure clients directory exists
+  if (!fs.existsSync(clientsDir)) {
+    fs.mkdirSync(clientsDir, { recursive: true });
+  }
+
+  // Clear existing client files (except index.ts temporarily)
+  const existingFiles = fs.readdirSync(clientsDir).filter(f => f !== 'index.ts');
+  existingFiles.forEach(file => {
+    fs.unlinkSync(path.join(clientsDir, file));
+  });
+
+  // Generate individual client files
+  resources.forEach(resource => {
+    const fileName = toCamelCase(resource.name) + '.ts';
+    const filePath = path.join(clientsDir, fileName);
+    const code = generateClientFile(resource);
+    fs.writeFileSync(filePath, code, 'utf-8');
+  });
+
+  // Generate index file
+  const indexPath = path.join(clientsDir, 'index.ts');
+  const indexCode = generateIndexFile(resources);
+  fs.writeFileSync(indexPath, indexCode, 'utf-8');
+
+  console.log(`✅ Generated ${resources.length} client(s) in ${clientsDir}`);
+}
+
+/**
+ * Main execution
+ */
+function main() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+  
+  if (!command) {
+    console.log('Usage:');
+    console.log('  npx @major-tech/resource-client add <resource_id> <name> <type> <description> <application_id>');
+    console.log('  npx @major-tech/resource-client remove <name>');
+    console.log('  npx @major-tech/resource-client list');
+    console.log('\nTypes: database-postgresql | api-hubspot | api-custom | storage-s3');
+    return;
+  }
+  
+  switch (command) {
+    case 'add': {
+      const [, resourceId, name, type, description, applicationId] = args;
+      if (!resourceId || !name || !type || !description || !applicationId) {
+        console.error('❌ Missing arguments');
+        console.log('Usage: add <resource_id> <name> <type> <description> <application_id>');
+        process.exit(1);
+      }
+      addResource(resourceId, name, type, description, applicationId);
+      break;
+    }
+    
+    case 'remove': {
+      const [, name] = args;
+      if (!name) {
+        console.error('❌ Missing name');
+        process.exit(1);
+      }
+      removeResource(name);
+      break;
+    }
+    
+    case 'list': {
+      listResources();
+      break;
+    }
+    
+    case 'regenerate': {
+      const resources = loadResources();
+      regenerateClients(resources);
+      break;
+    }
+    
+    default: {
+      console.error(`❌ Unknown command: ${command}`);
+      process.exit(1);
+    }
+  }
+}
+
+main();
+

package/package.json

@@ -1,14 +1,18 @@
 {
   "name": "@major-tech/resource-client",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "TypeScript client library for invoking Major resources (PostgreSQL, Custom APIs, HubSpot, S3)",
   "type": "module",
   "sideEffects": false,
   "engines": {
     "node": ">=18.0.0"
   },
+  "bin": {
+    "major-client": "./bin/generate-clients.mjs"
+  },
   "files": [
     "dist",
+    "bin",
     "README.md",
     "LICENSE"
   ],