@aloma.io/integration-sdk 3.8.54 → 3.8.56

package/examples/companies-resource.mts

@@ -1,310 +0,0 @@
-import {AbstractController} from '@aloma.io/integration-sdk';
-
-export default class Controller extends AbstractController {
-  
-  /**
- * Retrieve a batch of companies
- *
- * Retrieve a batch of companies by ID (`companyId`) or by a unique property (`idProperty`). You can specify what is returned using the `properties` query parameter.
- *
- * @param {boolean} archived (optional) - Whether to return only results that have been archived. [query]
- *
- * @param {Object} body (required) - Request body
- *
- * @returns {Promise<Object>} POST /crm/v3/objects/companies/batch/read response
-   */
-  async read(archived?: any, body?: any) {
-    const url = '/crm/v3/objects/companies/batch/read';
-    const options: any = {
-      method: 'POST',
-      params: {},
-      body,
-    };
-
-    // Add query parameters
-    if (archived !== undefined) {
-      options.params.archived = archived;
-    }
-
-    return this.api.fetch(url, options);
-  }
-
-  /**
- * Retrieve companies
- *
- * Retrieve all companies, using query parameters to control the information that gets returned.
- *
- * @param {integer} limit (optional) - The maximum number of results to display per page. [query]
- * @param {string} after (optional) - The paging cursor token of the last successfully read resource will be returned as the `paging.next.after` JSON property of a paged response containing more results. [query]
- * @param {array} properties (optional) - A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. [query]
- * @param {array} propertiesWithHistory (optional) - A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. Usage of this parameter will reduce the maximum number of companies that can be read by a single request. [query]
- * @param {array} associations (optional) - A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. [query]
- * @param {boolean} archived (optional) - Whether to return only results that have been archived. [query]
- *
- * @returns {Promise<Object>} GET /crm/v3/objects/companies response
-   */
-  async getPage(limit?: any, after?: any, properties?: any, propertiesWithHistory?: any, associations?: any, archived?: any) {
-    const url = '/crm/v3/objects/companies';
-    const options: any = {
-      method: 'GET',
-      params: {},
-    };
-
-    // Add query parameters
-    if (limit !== undefined) {
-      options.params.limit = limit;
-    }
-    if (after !== undefined) {
-      options.params.after = after;
-    }
-    if (properties !== undefined) {
-      options.params.properties = properties;
-    }
-    if (propertiesWithHistory !== undefined) {
-      options.params.propertiesWithHistory = propertiesWithHistory;
-    }
-    if (associations !== undefined) {
-      options.params.associations = associations;
-    }
-    if (archived !== undefined) {
-      options.params.archived = archived;
-    }
-
-    return this.api.fetch(url, options);
-  }
-
-  /**
- * Create a company
- *
- * Create a single company. Include a `properties` object to define [property values](https://developers.hubspot.com/docs/guides/api/crm/properties) for the company, along with an `associations` array to define [associations](https://developers.hubspot.com/docs/guides/api/crm/associations/associations-v4) with other CRM records.
- *
- * @param {Object} body (required) - Request body
- *
- * @returns {Promise<Object>} POST /crm/v3/objects/companies response
-   */
-  async create(body?: any) {
-    const url = '/crm/v3/objects/companies';
-    const options: any = {
-      method: 'POST',
-      body,
-    };
-
-    return this.api.fetch(url, options);
-  }
-
-  /**
- * Search for companies
- *
- * Search for companies by filtering on properties, searching through associations, and sorting results. Learn more about [CRM search](https://developers.hubspot.com/docs/guides/api/crm/search#make-a-search-request).
- *
- * @param {Object} body (required) - Request body
- *
- * @returns {Promise<Object>} POST /crm/v3/objects/companies/search response
-   */
-  async doSearch(body?: any) {
-    const url = '/crm/v3/objects/companies/search';
-    const options: any = {
-      method: 'POST',
-      body,
-    };
-
-    return this.api.fetch(url, options);
-  }
-
-  /**
- * Retrieve a company
- *
- * Retrieve a company by its ID (`companyId`) or by a unique property (`idProperty`). You can specify what is returned using the `properties` query parameter.
- *
- * @param {string} companyId (required) - The ID of the company [path]
- * @param {array} properties (optional) - A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. [query]
- * @param {array} propertiesWithHistory (optional) - A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. [query]
- * @param {array} associations (optional) - A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. [query]
- * @param {boolean} archived (optional) - Whether to return only results that have been archived. [query]
- * @param {string} idProperty (optional) - The name of a property whose values are unique for this object [query]
- *
- * @returns {Promise<Object>} GET /crm/v3/objects/companies/{companyId} response
-   */
-  async getById(companyId: string, properties?: any, propertiesWithHistory?: any, associations?: any, archived?: any, idProperty?: any) {
-    // Build URL with path parameters
-    let url = '/crm/v3/objects/companies/{companyId}';
-    if (companyId) {
-      url = url.replace('{companyId}', companyId);
-    }
-
-    const options: any = {
-      method: 'GET',
-      params: {},
-    };
-
-    // Add query parameters
-    if (properties !== undefined) {
-      options.params.properties = properties;
-    }
-    if (propertiesWithHistory !== undefined) {
-      options.params.propertiesWithHistory = propertiesWithHistory;
-    }
-    if (associations !== undefined) {
-      options.params.associations = associations;
-    }
-    if (archived !== undefined) {
-      options.params.archived = archived;
-    }
-    if (idProperty !== undefined) {
-      options.params.idProperty = idProperty;
-    }
-
-    return this.api.fetch(url, options);
-  }
-
-  /**
- * Update a company
- *
- * Update a company by ID (`companyId`) or unique property value (`idProperty`). Provided property values will be overwritten. Read-only and non-existent properties will result in an error. Properties values can be cleared by passing an empty string.
- *
- * @param {string} companyId (required) [path]
- * @param {string} idProperty (optional) - The name of a property whose values are unique for this object [query]
- *
- * @param {Object} body (required) - Request body
- *
- * @returns {Promise<Object>} PATCH /crm/v3/objects/companies/{companyId} response
-   */
-  async update(companyId: string, idProperty?: any, body?: any) {
-    // Build URL with path parameters
-    let url = '/crm/v3/objects/companies/{companyId}';
-    if (companyId) {
-      url = url.replace('{companyId}', companyId);
-    }
-
-    const options: any = {
-      method: 'PATCH',
-      params: {},
-      body,
-    };
-
-    // Add query parameters
-    if (idProperty !== undefined) {
-      options.params.idProperty = idProperty;
-    }
-
-    return this.api.fetch(url, options);
-  }
-
-  /**
- * Archive a company
- *
- * Delete a company by ID. Deleted companies can be restored within 90 days of deletion. Learn more about [restoring records](https://knowledge.hubspot.com/records/restore-deleted-records).
- *
- * @param {string} companyId (required) [path]
- *
- * @returns {Promise<Object>} DELETE /crm/v3/objects/companies/{companyId} response
-   */
-  async archive(companyId: string) {
-    // Build URL with path parameters
-    let url = '/crm/v3/objects/companies/{companyId}';
-    if (companyId) {
-      url = url.replace('{companyId}', companyId);
-    }
-
-    const options: any = {
-      method: 'DELETE',
-    };
-
-    return this.api.fetch(url, options);
-  }
-
-  /**
- * Create or update a batch of companies by unique property values
- *
- * Create or update companies identified by a unique property value as specified by the `idProperty` query parameter. `idProperty` query param refers to a property whose values are unique for the object.
- *
- * @param {Object} body (required) - Request body
- *
- * @returns {Promise<Object>} POST /crm/v3/objects/companies/batch/upsert response
-   */
-  async upsert(body?: any) {
-    const url = '/crm/v3/objects/companies/batch/upsert';
-    const options: any = {
-      method: 'POST',
-      body,
-    };
-
-    return this.api.fetch(url, options);
-  }
-
-  /**
- * Create a batch of companies
- *
- * Create a batch of companies. The `inputs` array can contain a `properties` object to define property values for each company, along with an `associations` array to define [associations](https://developers.hubspot.com/docs/guides/api/crm/associations/associations-v4) with other CRM records.
- *
- * @param {Object} body (required) - Request body
- *
- * @returns {Promise<Object>} POST /crm/v3/objects/companies/batch/create response
-   */
-  async create(body?: any) {
-    const url = '/crm/v3/objects/companies/batch/create';
-    const options: any = {
-      method: 'POST',
-      body,
-    };
-
-    return this.api.fetch(url, options);
-  }
-
-  /**
- * Update a batch of companies
- *
- * Update a batch of companies by ID.
- *
- * @param {Object} body (required) - Request body
- *
- * @returns {Promise<Object>} POST /crm/v3/objects/companies/batch/update response
-   */
-  async update(body?: any) {
-    const url = '/crm/v3/objects/companies/batch/update';
-    const options: any = {
-      method: 'POST',
-      body,
-    };
-
-    return this.api.fetch(url, options);
-  }
-
-  /**
- * Archive a batch of companies
- *
- * Delete a batch of companies by ID. Deleted companies can be restored within 90 days of deletion. Learn more about [restoring records](https://knowledge.hubspot.com/records/restore-deleted-records).
- *
- * @param {Object} body (required) - Request body
- *
- * @returns {Promise<Object>} POST /crm/v3/objects/companies/batch/archive response
-   */
-  async archive(body?: any) {
-    const url = '/crm/v3/objects/companies/batch/archive';
-    const options: any = {
-      method: 'POST',
-      body,
-    };
-
-    return this.api.fetch(url, options);
-  }
-
-  /**
- * Merge two companies
- *
- * Merge two company records. Learn more about [merging records](https://knowledge.hubspot.com/records/merge-records).
- *
- * @param {Object} body (required) - Request body
- *
- * @returns {Promise<Object>} POST /crm/v3/objects/companies/merge response
-   */
-  async merge(body?: any) {
-    const url = '/crm/v3/objects/companies/merge';
-    const options: any = {
-      method: 'POST',
-      body,
-    };
-
-    return this.api.fetch(url, options);
-  }
-}

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');
-  }
-}