@aloma.io/integration-sdk 3.8.52 → 3.8.54

package/examples/complete-example.sh

@@ -0,0 +1,116 @@
+#!/bin/bash
+
+# Complete Example: Generate a Multi-Resource HubSpot Connector
+# This script demonstrates how to create a connector with multiple resources
+
+set -e  # Exit on error
+
+echo "🚀 Generating Multi-Resource HubSpot Connector"
+echo "=============================================="
+echo ""
+
+# Step 1: Generate the main project with Companies resource
+echo "📦 Step 1: Creating project with Companies resource..."
+npx @aloma.io/integration-sdk@latest from-openapi "HubSpot" \
+  --connector-id "hubspot-connector" \
+  --spec hubspot-companies.json \
+  --out src/resources/companies.mts \
+  --resource CompaniesResource \
+  --no-build
+
+cd HubSpot
+
+echo ""
+echo "✅ Project created with CompaniesResource"
+echo ""
+
+# Step 2: Generate additional resources (if you have the specs)
+# Uncomment these when you have the OpenAPI specs
+
+# echo "📦 Step 2: Adding Deals resource..."
+# node <<EOF
+# import {OpenAPIToConnector} from '@aloma.io/integration-sdk';
+# import fs from 'fs';
+# 
+# const specContent = fs.readFileSync('../hubspot-deals.json', 'utf-8');
+# const spec = OpenAPIToConnector.parseSpec(specContent);
+# const generator = new OpenAPIToConnector(spec, 'HubSpot Deals');
+# const code = generator.generateResourceClass('DealsResource');
+# fs.writeFileSync('src/resources/deals.mts', code);
+# console.log('✅ Generated DealsResource');
+# EOF
+
+# echo ""
+# echo "📦 Step 3: Adding Contacts resource..."
+# node <<EOF
+# import {OpenAPIToConnector} from '@aloma.io/integration-sdk';
+# import fs from 'fs';
+# 
+# const specContent = fs.readFileSync('../hubspot-contacts.json', 'utf-8');
+# const spec = OpenAPIToConnector.parseSpec(specContent);
+# const generator = new OpenAPIToConnector(spec, 'HubSpot Contacts');
+# const code = generator.generateResourceClass('ContactsResource');
+# fs.writeFileSync('src/resources/contacts.mts', code);
+# console.log('✅ Generated ContactsResource');
+# EOF
+
+# Step 3: Create the main controller
+echo "📝 Step 3: Creating main controller..."
+
+cat > src/controller/index.mts << 'EOF'
+import {AbstractController} from '@aloma.io/integration-sdk';
+import CompaniesResource from '../resources/companies.mts';
+// import DealsResource from '../resources/deals.mts';
+// import ContactsResource from '../resources/contacts.mts';
+
+export default class Controller extends AbstractController {
+  companies: CompaniesResource;
+  // deals: DealsResource;
+  // contacts: ContactsResource;
+
+  constructor(fetcher: any) {
+    super(fetcher);
+    
+    // Each resource extends AbstractController and has access to this.api
+    this.companies = new CompaniesResource(fetcher);
+    // this.deals = new DealsResource(fetcher);
+    // this.contacts = new ContactsResource(fetcher);
+  }
+}
+EOF
+
+echo "✅ Main controller created"
+echo ""
+
+# Step 4: Install dependencies and build
+echo "📦 Step 4: Installing dependencies..."
+yarn --ignore-engines
+
+echo ""
+echo "🔨 Step 5: Building project..."
+yarn build
+
+echo ""
+echo "✅ Success! Your multi-resource connector is ready!"
+echo ""
+echo "📁 Project structure:"
+echo "   HubSpot/"
+echo "   ├── src/"
+echo "   │   ├── controller/"
+echo "   │   │   └── index.mts          # Main controller"
+echo "   │   └── resources/"
+echo "   │       └── companies.mts      # CompaniesResource"
+echo "   │       # └── deals.mts         # (when added)"
+echo "   │       # └── contacts.mts      # (when added)"
+echo ""
+echo "💡 Usage:"
+echo "   await controller.companies.create({ name: 'Acme Corp' });"
+echo "   await controller.companies.getPage(10);"
+echo "   await controller.companies.getById('12345');"
+echo ""
+echo "📝 Next steps:"
+echo "   1. Add more resources (deals, contacts, etc.)"
+echo "   2. Edit .env and insert the registration token"
+echo "   3. Run: yarn start"
+echo ""
+

package/examples/create-hubspot-connector.sh

@@ -0,0 +1,33 @@
+#!/bin/bash
+
+# Create HubSpot v2 Multi-Resource Connector
+# This script demonstrates how to create a multi-resource connector with multiple OpenAPI specifications
+
+echo "🚀 Creating HubSpot v2 Multi-Resource Connector..."
+
+# Create the multi-resource connector with all 3 resources
+npx @aloma.io/integration-sdk@latest create-multi-resource "HubSpot-v2" \
+  --connector-id "hubspot-123" \
+  --resources "CompaniesResource:examples/hubspot-companies.json,ContactsResource:examples/hubspot-contacts.json,ListsResource:examples/hubspot-lists.json" \
+  --base-url "https://api.hubapi.com" \
+  --no-build
+
+echo "✅ HubSpot v2 connector created successfully!"
+echo ""
+echo "📁 Generated structure:"
+echo "├── src/controller/index.mts (main controller)"
+echo "├── src/resources/companies.mts (CompaniesResource)"
+echo "├── src/resources/contacts.mts (ContactsResource)"
+echo "└── src/resources/lists.mts (ListsResource)"
+echo ""
+echo "🔧 Next steps:"
+echo "1.) cd HubSpot-v2"
+echo "2.) yarn --ignore-engines"
+echo "3.) yarn build"
+echo "4.) Add to workspace and configure .env"
+echo "5.) yarn start"
+echo ""
+echo "💡 Usage examples:"
+echo "await controller.companies.create({ body: { properties: { name: 'Acme Corp' } } });"
+echo "await controller.contacts.getPage({ limit: 10 });"
+echo "await controller.lists.getAll({ limit: 50 });"