@aloma.io/integration-sdk 3.8.53 → 3.8.55

package/examples/complete-example.sh

@@ -1,116 +0,0 @@
-#!/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

@@ -1,33 +0,0 @@
-#!/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 });"

package/examples/generate-connector.sh

@@ -1,35 +0,0 @@
-#!/bin/bash
-
-# Example script to generate a connector from OpenAPI specification
-# Usage: ./generate-connector.sh <connector-name> <openapi-file> [output-file]
-
-set -e
-
-CONNECTOR_NAME=${1:-"My API Connector"}
-OPENAPI_FILE=${2:-"./sample-api.yaml"}
-OUTPUT_FILE=${3:-"./generated-controller.mts"}
-
-echo "🚀 Generating connector: $CONNECTOR_NAME"
-echo "📄 OpenAPI spec: $OPENAPI_FILE"
-echo "📝 Output file: $OUTPUT_FILE"
-echo ""
-
-# Check if OpenAPI file exists
-if [ ! -f "$OPENAPI_FILE" ]; then
-    echo "❌ Error: OpenAPI file '$OPENAPI_FILE' not found"
-    exit 1
-fi
-
-# Generate the connector
-node ../build/openapi-to-connector.mjs generate \
-    --name "$CONNECTOR_NAME" \
-    --spec "$OPENAPI_FILE" \
-    --out "$OUTPUT_FILE"
-
-echo ""
-echo "✅ Success! Generated connector controller: $OUTPUT_FILE"
-echo ""
-echo "Next steps:"
-echo "1. Review the generated controller"
-echo "2. Implement the actual API calls in each method"
-echo "3. Add the controller to your Aloma connector project"

package/examples/generated-controller.mts

@@ -1,81 +0,0 @@
-import {AbstractController} from '@aloma.io/integration-sdk';
-
-export default class Controller extends AbstractController {
-  
-  /**
- * List all users
- * Retrieve a paginated list of all users in the system
- *
- * @param args - Request arguments
- * @param args.page - Page number for pagination
- * @param args.limit - Number of users per page
- * @returns Response data
-   */
-  async listUsers(args: any) {
-    // TODO: Implement GET /users
-    throw new Error('Method not implemented');
-  }
-
-  /**
- * Create a new user
- * Create a new user account in the system
- *
- * @param args.body - Request body
- * @returns Response data
-   */
-  async createUser(args: any) {
-    // TODO: Implement POST /users
-    throw new Error('Method not implemented');
-  }
-
-  /**
- * Get user by ID
- * Retrieve a specific user by their unique identifier
- *
- * @param args - Request arguments
- * @param args.id - Unique identifier of the user
- * @returns Response data
-   */
-  async getUserById(args: any) {
-    // TODO: Implement GET /users/{id}
-    throw new Error('Method not implemented');
-  }
-
-  /**
- * Update user
- * Update an existing user's information
- *
- * @param args - Request arguments
- * @param args.id - Unique identifier of the user
- *
- * @param args.body - Request body
- * @returns Response data
-   */
-  async updateUser(args: any) {
-    // TODO: Implement PUT /users/{id}
-    throw new Error('Method not implemented');
-  }
-
-  /**
- * Delete user
- * Permanently delete a user from the system
- *
- * @param args - Request arguments
- * @param args.id - Unique identifier of the user
- * @returns Response data
-   */
-  async deleteUser(args: any) {
-    // TODO: Implement DELETE /users/{id}
-    throw new Error('Method not implemented');
-  }
-
-  /**
- * Health check
- * Check the health status of the API
- * @returns Response data
-   */
-  async healthCheck(args: any) {
-    // TODO: Implement GET /health
-    throw new Error('Method not implemented');
-  }
-}