@aloma.io/integration-sdk 3.8.54 → 3.8.56

package/test/verify-scenarios.mjs

@@ -0,0 +1,298 @@
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { OpenAPIToConnector } from '../build/openapi-to-connector.mjs';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// Colors for output
+const colors = {
+  green: '\x1b[32m',
+  red: '\x1b[31m',
+  yellow: '\x1b[33m',
+  reset: '\x1b[0m',
+  cyan: '\x1b[36m'
+};
+
+let passed = 0;
+let failed = 0;
+
+function test(name, fn) {
+  try {
+    console.log(`${colors.cyan}Running: ${name}${colors.reset}`);
+    fn();
+    console.log(`${colors.green}✓ PASS: ${name}${colors.reset}\n`);
+    passed++;
+  } catch (error) {
+    console.log(`${colors.red}✗ FAIL: ${name}${colors.reset}`);
+    console.log(`${colors.red}  Error: ${error.message}${colors.reset}\n`);
+    failed++;
+  }
+}
+
+function expect(actual) {
+  return {
+    toEqual: (expected) => {
+      if (actual !== expected) {
+        throw new Error(`Expected:\n${expected.slice(0, 200)}...\n\nActual:\n${actual.slice(0, 200)}...`);
+      }
+    },
+    toInclude: (expected) => {
+      if (!actual.includes(expected)) {
+        throw new Error(`Expected output to include: "${expected}"\n\nActual output snippet: "${actual.slice(0, 500)}..."`);
+      }
+    },
+    toNotInclude: (expected) => {
+      if (actual.includes(expected)) {
+        throw new Error(`Expected output to NOT include: "${expected}"\n\nBut it was found in the output.`);
+      }
+    }
+  };
+}
+
+// Helper function to normalize output
+const normalizeOutput = (output) => output
+  .replace(/\r\n/g, '\n')
+  .trim();
+
+console.log(`${colors.yellow}🧪 Running Scenario Fixture Tests${colors.reset}\n`);
+
+// Test 1: Simple Scenario
+test('Simple Scenario - should generate expected output', () => {
+  // Read input spec
+  const specPath = path.join(__dirname, 'scenarios/simple/simple-api.json');
+  const specContent = fs.readFileSync(specPath, 'utf-8');
+  const spec = OpenAPIToConnector.parseSpec(specContent);
+  
+  // Read expected output
+  const expectedPath = path.join(__dirname, 'scenarios/simple/expected-controller.mts');
+  const expectedOutput = fs.readFileSync(expectedPath, 'utf-8');
+  
+  // Generate actual output
+  const generator = new OpenAPIToConnector(spec, 'simple-test');
+  const actualOutput = generator.generateController();
+  
+  // Compare outputs
+  expect(normalizeOutput(actualOutput)).toEqual(normalizeOutput(expectedOutput));
+});
+
+// Test 2: Simple Scenario - Methods without options
+test('Simple Scenario - methods without options should be clean', () => {
+  const specPath = path.join(__dirname, 'scenarios/simple/simple-api.json');
+  const specContent = fs.readFileSync(specPath, 'utf-8');
+  const spec = OpenAPIToConnector.parseSpec(specContent);
+  
+  const generator = new OpenAPIToConnector(spec, 'simple-test');
+  const actualOutput = generator.generateController();
+  
+  expect(actualOutput).toInclude('async getProducts() {');
+  expect(actualOutput).toInclude('async createProduct(options:');
+});
+
+// Test 3: Complex Scenario - Main Controller
+test('Complex Scenario - main controller should generate expected output', () => {
+  const productsSpecPath = path.join(__dirname, 'scenarios/complex/specs/products.json');
+  const ordersSpecPath = path.join(__dirname, 'scenarios/complex/specs/orders.json');
+  const productsSpecContent = fs.readFileSync(productsSpecPath, 'utf-8');
+  const ordersSpecContent = fs.readFileSync(ordersSpecPath, 'utf-8');
+  
+  const productsSpec = OpenAPIToConnector.parseSpec(productsSpecContent);
+  const ordersSpec = OpenAPIToConnector.parseSpec(ordersSpecContent);
+  
+  const expectedPath = path.join(__dirname, 'scenarios/complex/expected/controller.mts');
+  const expectedOutput = fs.readFileSync(expectedPath, 'utf-8');
+  
+  const resources = [
+    { className: 'ProductsResource', fileName: 'products' },
+    { className: 'OrdersResource', fileName: 'orders' }
+  ];
+  const resourceSpecs = [
+    { fileName: 'products', spec: productsSpec },
+    { fileName: 'orders', spec: ordersSpec }
+  ];
+  
+  const mainGenerator = new OpenAPIToConnector(productsSpec, 'test-shop-temp');
+  const actualOutput = mainGenerator.generateMainController(resources, resourceSpecs);
+  
+  expect(normalizeOutput(actualOutput)).toEqual(normalizeOutput(expectedOutput));
+});
+
+// Test 4: Complex Scenario - Products Resource
+test('Complex Scenario - products resource should generate expected output', () => {
+  const specPath = path.join(__dirname, 'scenarios/complex/specs/products.json');
+  const specContent = fs.readFileSync(specPath, 'utf-8');
+  const spec = OpenAPIToConnector.parseSpec(specContent);
+  
+  const expectedPath = path.join(__dirname, 'scenarios/complex/expected/products-resource.mts');
+  const expectedOutput = fs.readFileSync(expectedPath, 'utf-8');
+  
+  const generator = new OpenAPIToConnector(spec, 'test-shop');
+  const actualOutput = generator.generateResourceClass('ProductsResource');
+  
+  expect(normalizeOutput(actualOutput)).toEqual(normalizeOutput(expectedOutput));
+});
+
+// Test 5: Complex Scenario - Orders Resource
+test('Complex Scenario - orders resource should generate expected output', () => {
+  const specPath = path.join(__dirname, 'scenarios/complex/specs/orders.json');
+  const specContent = fs.readFileSync(specPath, 'utf-8');
+  const spec = OpenAPIToConnector.parseSpec(specContent);
+  
+  const expectedPath = path.join(__dirname, 'scenarios/complex/expected/orders-resource.mts');
+  const expectedOutput = fs.readFileSync(expectedPath, 'utf-8');
+  
+  const generator = new OpenAPIToConnector(spec, 'test-shop');
+  const actualOutput = generator.generateResourceClass('OrdersResource');
+  
+  expect(normalizeOutput(actualOutput)).toEqual(normalizeOutput(expectedOutput));
+});
+
+// Test 6: TypeScript Interface Generation
+test('TypeScript interfaces should be generated correctly', () => {
+  const specPath = path.join(__dirname, 'scenarios/complex/specs/products.json');
+  const specContent = fs.readFileSync(specPath, 'utf-8');
+  const spec = OpenAPIToConnector.parseSpec(specContent);
+  
+  const generator = new OpenAPIToConnector(spec, 'test-shop');
+  const actualOutput = generator.generateResourceClass('ProductsResource');
+  
+  expect(actualOutput).toInclude('export interface Product {');
+  expect(actualOutput).toInclude('export interface ProductList {');
+  expect(actualOutput).toInclude('export interface CreateProductRequest {');
+  expect(actualOutput).toInclude('Promise<ProductList>');
+  expect(actualOutput).toInclude('Promise<Product>');
+});
+
+// Test 7: Path Parameters and Options
+test('Path parameters and options should be handled correctly', () => {
+  const specPath = path.join(__dirname, 'scenarios/complex/specs/orders.json');
+  const specContent = fs.readFileSync(specPath, 'utf-8');
+  const spec = OpenAPIToConnector.parseSpec(specContent);
+  
+  const generator = new OpenAPIToConnector(spec, 'test-shop');
+  const actualOutput = generator.generateResourceClass('OrdersResource');
+  
+  expect(actualOutput).toInclude('export function getOrder(this: any, orderId: string)');
+  expect(actualOutput).toInclude('export function updateOrderStatus(this: any, orderId: string, options');
+  expect(actualOutput).toInclude('export function cancelOrder(this: any, orderId: string)');
+});
+
+// Test 8: Exposed Methods in Main Controller
+test('Exposed methods should be present in main controller', () => {
+  const productsSpecPath = path.join(__dirname, 'scenarios/complex/specs/products.json');
+  const ordersSpecPath = path.join(__dirname, 'scenarios/complex/specs/orders.json');
+  const productsSpecContent = fs.readFileSync(productsSpecPath, 'utf-8');
+  const ordersSpecContent = fs.readFileSync(ordersSpecPath, 'utf-8');
+  
+  const productsSpec = OpenAPIToConnector.parseSpec(productsSpecContent);
+  const ordersSpec = OpenAPIToConnector.parseSpec(ordersSpecContent);
+  
+  const resources = [
+    { className: 'ProductsResource', fileName: 'products' },
+    { className: 'OrdersResource', fileName: 'orders' }
+  ];
+  const resourceSpecs = [
+    { fileName: 'products', spec: productsSpec },
+    { fileName: 'orders', spec: ordersSpec }
+  ];
+  
+  const mainGenerator = new OpenAPIToConnector(productsSpec, 'test-shop');
+  const actualOutput = mainGenerator.generateMainController(resources, resourceSpecs);
+  
+  expect(actualOutput).toInclude('async productsGetProducts(');
+  expect(actualOutput).toInclude('async productsCreateProduct(');
+  expect(actualOutput).toInclude('async productsGetProduct(');
+  expect(actualOutput).toInclude('async productsUpdateProduct(');
+  expect(actualOutput).toInclude('async productsDeleteProduct(');
+  
+  expect(actualOutput).toInclude('async ordersGetOrders(');
+  expect(actualOutput).toInclude('async ordersCreateOrder(');
+  expect(actualOutput).toInclude('async ordersGetOrder(');
+  expect(actualOutput).toInclude('async ordersUpdateOrderStatus(');
+  expect(actualOutput).toInclude('async ordersCancelOrder(');
+  
+  expect(actualOutput).toInclude('this.bindResourceFunctions(\'products\', productsFunctions);');
+  expect(actualOutput).toInclude('this.bindResourceFunctions(\'orders\', ordersFunctions);');
+});
+
+// Test 9: Schema Name Sanitization
+test('Schema names should be sanitized correctly', () => {
+  const testSpec = {
+    openapi: '3.0.0',
+    info: { title: 'Test API', version: '1.0.0' },
+    paths: {
+      '/test': {
+        get: {
+          operationId: 'testOperation',
+          responses: {
+            '200': {
+              description: 'Success',
+              content: {
+                'application/json': {
+                  schema: {
+                    '$ref': '#/components/schemas/Complex.Name.With.Dots'
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    components: {
+      schemas: {
+        'Complex.Name.With.Dots': {
+          type: 'object',
+          properties: {
+            id: { type: 'string' },
+            name: { type: 'string' }
+          }
+        }
+      }
+    }
+  };
+
+  const generator = new OpenAPIToConnector(testSpec, 'test');
+  const output = generator.generateController();
+  
+  expect(output).toInclude('export interface Complex_Name_With_Dots {');
+  expect(output).toNotInclude('export interface Complex.Name.With.Dots {');
+  expect(output).toInclude('Promise<Complex_Name_With_Dots>');
+});
+
+// Test 10: No Options Parameter for Simple Methods
+test('Simple methods should not have options parameter', () => {
+  const simpleSpec = {
+    openapi: '3.0.0',
+    info: { title: 'Simple API', version: '1.0.0' },
+    paths: {
+      '/simple': {
+        get: {
+          operationId: 'getSimple',
+          responses: { '200': { description: 'Success' } }
+        }
+      }
+    }
+  };
+
+  const generator = new OpenAPIToConnector(simpleSpec, 'test');
+  const output = generator.generateController();
+  
+  expect(output).toInclude('async getSimple() {');
+  expect(output).toNotInclude('options = options || {}');
+  expect(output).toNotInclude('headers: options');
+});
+
+// Print final results
+console.log(`${colors.yellow}📊 Test Results:${colors.reset}`);
+console.log(`${colors.green}✓ Passed: ${passed}${colors.reset}`);
+console.log(`${colors.red}✗ Failed: ${failed}${colors.reset}`);
+
+if (failed === 0) {
+  console.log(`\n${colors.green}🎉 All tests passed!${colors.reset}`);
+  process.exit(0);
+} else {
+  console.log(`\n${colors.red}❌ Some tests failed!${colors.reset}`);
+  process.exit(1);
+}

package/examples/api-without-servers.json

@@ -1,32 +0,0 @@
-{
-  "openapi": "3.0.0",
-  "info": {
-    "title": "Test API",
-    "version": "1.0.0",
-    "description": "API without servers definition"
-  },
-  "paths": {
-    "/users": {
-      "get": {
-        "summary": "List users",
-        "operationId": "listUsers",
-        "parameters": [
-          {
-            "name": "limit",
-            "in": "query",
-            "schema": {
-              "type": "integer"
-            },
-            "description": "Maximum number of users"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Success"
-          }
-        }
-      }
-    }
-  }
-}
-

package/examples/companies-resource-class.mts

@@ -1,310 +0,0 @@
-import {AbstractController} from '@aloma.io/integration-sdk';
-
-export default class CompaniesResource 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);
-  }
-}