@things-factory/integration-base 9.0.28 → 9.0.32

package/README.md

@@ -1,2 +1,513 @@
-# integration-service
- 
+# @things-factory/integration-base
+
+A comprehensive integration framework for the Things Factory ecosystem that enables seamless connectivity with external systems and services through scenario-driven automation.
+
+[![Version](https://img.shields.io/npm/v/@things-factory/integration-base.svg)](https://npmjs.org/package/@things-factory/integration-base)
+[![License](https://img.shields.io/npm/l/@things-factory/integration-base.svg)](https://github.com/hatiolab/things-factory/blob/main/packages/integration-base/LICENSE)
+
+## Overview
+
+The Integration Base module provides a robust, scenario-driven automation engine that enables complex integration workflows through a visual, step-based approach. It serves as the central nervous system for enterprise automation within the Things Factory framework.
+
+### Key Features
+
+- **Scenario Engine**: Visual workflow designer with 50+ built-in task types
+- **Multi-Protocol Support**: Database, HTTP/REST, GraphQL, MQTT, WebSocket integrations
+- **Headless Automation**: Web scraping and browser automation via Puppeteer
+- **Multi-Tenant Architecture**: Domain-based isolation with role-based access control
+- **Real-Time Monitoring**: GraphQL subscriptions for live status updates
+- **Scheduling System**: Cron-based automated execution with timezone support
+- **Edge Computing**: Distributed execution through edge appliances
+
+## Installation
+
+```bash
+npm install @things-factory/integration-base
+```
+
+## Quick Start
+
+### 1. Basic Scenario Configuration
+
+```typescript
+import { ScenarioEngine } from '@things-factory/integration-base'
+
+// Create a simple HTTP integration scenario
+const scenario = {
+  name: 'fetch-user-data',
+  description: 'Fetch user data from external API',
+  steps: [
+    {
+      name: 'fetch-users',
+      task: 'http-get',
+      connection: 'api-server',
+      params: {
+        path: '/api/users',
+        headers: { 'Authorization': 'Bearer ${token}' }
+      }
+    },
+    {
+      name: 'store-data',
+      task: 'database-query',
+      connection: 'main-db',
+      params: {
+        query: 'INSERT INTO users (id, name, email) VALUES (?, ?, ?)',
+        bindings: '${fetch-users.data}'
+      }
+    }
+  ]
+}
+```
+
+### 2. Connection Setup
+
+```typescript
+// Database connection
+const dbConnection = {
+  name: 'main-db',
+  type: 'postgresql-connector',
+  endpoint: 'postgresql://localhost:5432/mydb',
+  params: {
+    username: 'dbuser',
+    password: 'dbpass',
+    database: 'myapp'
+  }
+}
+
+// HTTP API connection
+const apiConnection = {
+  name: 'api-server',
+  type: 'http-connector',
+  endpoint: 'https://api.example.com',
+  params: {
+    timeout: 30000,
+    rejectUnauthorized: true
+  }
+}
+```
+
+## Supported Connectors
+
+### Database Connectors
+- **PostgreSQL** (`postgresql-connector`)
+- **MySQL** (`mysql-connector`) 
+- **Microsoft SQL Server** (`mssql-connector`)
+- **Oracle** (`oracle-connector`)
+- **SQLite** (`sqlite-connector`)
+
+### Communication Connectors
+- **HTTP/REST** (`http-connector`)
+- **GraphQL** (`graphql-connector`) - Apollo Client with OAuth2 support
+- **MQTT** (`mqtt-connector`) - Async message pub/sub
+- **WebSocket** (`socket-server`) - Raw TCP socket communication
+
+### Automation Connectors
+- **Headless Browser** (`headless-connector`) - Puppeteer-based web automation
+- **Python Runtime** (`pyrun-connector`) - Python script execution
+- **Operato Integration** (`operato-connector`) - Things Factory cross-instance
+
+### Utility Connectors
+- **Echo Service** (`echo-back-connector`) - Testing and debugging
+- **Proxy Connector** (`proxy-connector`) - Edge appliance delegation
+
+## Task Types
+
+### Data Operations
+- `database-query` - Execute SQL queries with parameter binding
+- `graphql-query` / `graphql-mutate` - GraphQL operations
+- `data-mapper` - Transform data structures
+- `jsonata` - JSONata transformations
+- `csv-readline` - CSV file processing
+
+### Communication Tasks
+- `http-get` / `http-post` / `http-put` / `http-patch` / `http-delete`
+- `headless-get` / `headless-post` / `headless-put` / `headless-patch` / `headless-delete`
+- `mqtt-publish` / `mqtt-subscribe`
+- `socket-listener` / `publish`
+
+### Control Flow
+- `goto` / `end` - Flow control
+- `switch-goto` / `switch-range-goto` - Conditional branching
+- `sub-scenario` - Nested scenario execution
+- `empty-check` - Validation tasks
+- `variables` - Variable management
+
+### Automation & Utility
+- `headless-scrap` - Web scraping
+- `pyrun-execute` - Python script execution
+- `sleep` / `random` - Utility functions
+- `script` - Custom JavaScript execution
+
+## Configuration
+
+### Environment Variables
+
+```bash
+# Database connection
+DB_HOST=localhost
+DB_PORT=5432
+DB_NAME=integration_db
+DB_USERNAME=user
+DB_PASSWORD=password
+
+# Headless browser pool
+HEADLESS_POOL_MIN=2
+HEADLESS_POOL_MAX=10
+
+# Logging
+DEBUG=things-factory:integration-base:*
+LOG_LEVEL=info
+```
+
+### Domain Configuration
+
+```typescript
+// Domain-specific environment variables
+const domainConfig = {
+  domain: 'tenant1.example.com',
+  envVars: [
+    { name: 'Connection::api-server::apiKey', value: 'secret-key-123' },
+    { name: 'Connection::database::password', value: 'encrypted-password' }
+  ]
+}
+```
+
+## API Reference
+
+### GraphQL Schema
+
+```graphql
+type Scenario {
+  id: String!
+  name: String!
+  description: String
+  active: Boolean!
+  schedule: String
+  timezone: String
+  steps: [Step!]!
+}
+
+type Connection {
+  id: String!
+  name: String!
+  type: String!
+  endpoint: String!
+  active: Boolean!
+  state: ConnectionStatus!
+}
+
+type ScenarioInstance {
+  id: String!
+  scenario: Scenario!
+  status: ScenarioStatus!
+  startedAt: String
+  finishedAt: String
+  result: JSON
+}
+```
+
+### REST API Endpoints
+
+```
+GET    /api/unstable/scenarios           # List scenarios
+POST   /api/unstable/scenarios           # Create scenario
+PUT    /api/unstable/scenarios/:id       # Update scenario
+DELETE /api/unstable/scenarios/:id       # Delete scenario
+
+GET    /api/unstable/scenario-instances  # List instances
+POST   /api/unstable/run-scenario        # Execute scenario
+POST   /api/unstable/start-scenario      # Start async scenario
+POST   /api/unstable/stop-scenario       # Stop running scenario
+```
+
+## Examples
+
+### Database Integration
+
+```typescript
+const databaseScenario = {
+  name: 'sync-customer-data',
+  steps: [
+    {
+      name: 'fetch-customers',
+      task: 'database-query',
+      connection: 'source-db',
+      params: {
+        query: 'SELECT * FROM customers WHERE updated_at > ?',
+        bindings: ['${lastSync}']
+      }
+    },
+    {
+      name: 'transform-data',
+      task: 'data-mapper',
+      params: {
+        mapping: {
+          customer_id: 'id',
+          full_name: 'name',
+          email_address: 'email'
+        }
+      }
+    },
+    {
+      name: 'insert-customers',
+      task: 'database-query',
+      connection: 'target-db',
+      params: {
+        query: 'INSERT INTO customers (id, name, email) VALUES ${fetch-customers.data}',
+        batchSize: 1000
+      }
+    }
+  ]
+}
+```
+
+### Web Scraping with Headless Browser
+
+```typescript
+const scrapingScenario = {
+  name: 'scrape-product-prices',
+  steps: [
+    {
+      name: 'login-to-site',
+      task: 'headless-post',
+      connection: 'ecommerce-site',
+      params: {
+        path: '/login',
+        contentType: 'application/json',
+        accessor: 'credentials'
+      }
+    },
+    {
+      name: 'scrape-products',
+      task: 'headless-scrap',
+      connection: 'ecommerce-site',
+      params: {
+        path: '/products',
+        selectors: [
+          { text: 'productName', value: '.product-title' },
+          { text: 'price', value: '.price-display' },
+          { text: 'availability', value: '.stock-status' }
+        ],
+        waitForSelectors: '.product-list',
+        waitForTimeout: 5000
+      }
+    },
+    {
+      name: 'save-results',
+      task: 'database-query',
+      connection: 'analytics-db',
+      params: {
+        query: 'INSERT INTO product_prices (name, price, availability, scraped_at) VALUES ${scrape-products.data}'
+      }
+    }
+  ]
+}
+```
+
+### MQTT Integration
+
+```typescript
+const mqttScenario = {
+  name: 'iot-data-processing',
+  steps: [
+    {
+      name: 'subscribe-sensors',
+      task: 'mqtt-subscribe',
+      connection: 'iot-broker',
+      params: {
+        topic: 'sensors/+/temperature',
+        qos: 1
+      }
+    },
+    {
+      name: 'validate-data',
+      task: 'empty-check',
+      params: {
+        accessor: 'temperature',
+        throwOnEmpty: true
+      }
+    },
+    {
+      name: 'store-reading',
+      task: 'database-query',
+      connection: 'timeseries-db',
+      params: {
+        query: 'INSERT INTO sensor_readings (sensor_id, temperature, timestamp) VALUES (?, ?, NOW())',
+        bindings: ['${deviceId}', '${temperature}']
+      }
+    },
+    {
+      name: 'alert-if-critical',
+      task: 'switch-range-goto',
+      params: {
+        value: '${temperature}',
+        cases: [
+          { min: 80, max: 999, goto: 'send-alert' }
+        ]
+      }
+    },
+    {
+      name: 'send-alert',
+      task: 'http-post',
+      connection: 'alert-service',
+      params: {
+        path: '/alerts',
+        contentType: 'application/json',
+        accessor: 'alertData'
+      }
+    }
+  ]
+}
+```
+
+## Scheduling
+
+Configure automated scenario execution using cron expressions:
+
+```typescript
+const scheduledScenario = {
+  name: 'daily-data-sync',
+  description: 'Sync data every day at 2 AM',
+  schedule: '0 2 * * *',  // Cron expression
+  timezone: 'Asia/Seoul',
+  active: true,
+  steps: [/* scenario steps */]
+}
+```
+
+## Security
+
+### Authentication & Authorization
+- **Role-based access control** (RBAC) integration
+- **Domain-based isolation** for multi-tenant environments
+- **OAuth2 authentication** for external GraphQL services
+- **Encrypted parameter storage** for sensitive configuration
+
+### Best Practices
+- Store sensitive data in domain environment variables
+- Use parameter encryption for passwords and API keys
+- Implement IP-based access control where needed
+- Regular security audits of scenario configurations
+
+## Monitoring & Debugging
+
+### Logging
+```bash
+# Enable debug logging
+DEBUG=things-factory:integration-base:* npm start
+
+# Specific component logging
+DEBUG=things-factory:integration-base:scenario-engine npm start
+DEBUG=things-factory:integration-base:connector:* npm start
+```
+
+### Real-time Monitoring
+```graphql
+# Subscribe to scenario status updates
+subscription {
+  scenarioInstanceStatusUpdated {
+    id
+    status
+    progress
+    result
+    error
+  }
+}
+
+# Subscribe to connection status
+subscription {
+  connectionStatusUpdated {
+    name
+    state
+    lastConnected
+  }
+}
+```
+
+## Development
+
+### Building from Source
+
+```bash
+# Clone the repository
+git clone https://github.com/hatiolab/things-factory.git
+cd things-factory/packages/integration-base
+
+# Install dependencies
+npm install
+
+# Build the module
+npm run build
+
+# Run tests
+npm test
+```
+
+### Creating Custom Connectors
+
+```typescript
+import { Connector } from '@things-factory/integration-base'
+
+export class CustomConnector implements Connector {
+  async connect(connection) {
+    // Implementation
+  }
+  
+  async disconnect(connection) {
+    // Cleanup
+  }
+  
+  get parameterSpec() {
+    return [
+      { type: 'string', name: 'apiKey', label: 'API Key' },
+      { type: 'number', name: 'timeout', label: 'Timeout (ms)' }
+    ]
+  }
+  
+  get taskPrefixes() {
+    return ['custom']
+  }
+}
+```
+
+### Creating Custom Tasks
+
+```typescript
+import { TaskRegistry } from '@things-factory/integration-base'
+
+async function CustomTask(step, context) {
+  const { params } = step
+  const { logger, data, domain } = context
+  
+  // Task implementation
+  return { data: result }
+}
+
+CustomTask.parameterSpec = [
+  { type: 'string', name: 'parameter1', label: 'Parameter 1' }
+]
+
+TaskRegistry.registerTaskHandler('custom-task', CustomTask)
+```
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests for new functionality
+5. Submit a pull request
+
+## License
+
+MIT © [Hatiolab](https://github.com/hatiolab)
+
+## Support
+
+- [Documentation](https://docs.things-factory.com/integration-base)
+- [Issue Tracker](https://github.com/hatiolab/things-factory/issues)
+- [Discussions](https://github.com/hatiolab/things-factory/discussions)
+
+---
+
+**Note**: This module is part of the Things Factory ecosystem. For complete setup and configuration, refer to the main [Things Factory documentation](https://docs.things-factory.com).

package/dist-server/engine/task/headless-delete.d.ts

@@ -0,0 +1 @@
+export {};

package/dist-server/engine/task/headless-delete.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const https_1 = tslib_1.__importDefault(require("https"));
+const url_1 = require("url");
+const task_registry_1 = require("../task-registry");
+const connection_manager_1 = require("../connection-manager");
+async function HeadlessDelete(step, { logger, data, domain }) {
+    const { connection: connectionName, params: stepOptions } = step;
+    const { headers: requestHeaders, path, queryParams } = stepOptions || {};
+    const connection = await connection_manager_1.ConnectionManager.getConnectionInstanceByName(domain, connectionName);
+    if (!connection) {
+        throw new Error(`Connection '${connectionName}' is not established.`);
+    }
+    const { endpoint, params: connectionParams, acquireSessionPage, releasePage } = connection;
+    const headers = {
+        ...requestHeaders
+    };
+    const options = {
+        method: 'DELETE',
+        headers
+    };
+    const { rejectUnauthorized } = connectionParams;
+    if (!rejectUnauthorized) {
+        const httpsAgent = new https_1.default.Agent({
+            rejectUnauthorized
+        });
+        options.agent = httpsAgent;
+    }
+    const page = await acquireSessionPage();
+    try {
+        page.on('console', async (msg) => {
+            console.log(`[browser ${msg.type()}] ${msg.text()}`);
+        });
+        page.on('requestfailed', request => {
+            console.log('Request failed:', request.url());
+        });
+        await page.goto(endpoint, { waitUntil: 'networkidle2' });
+        // URL 구성 - queryParams가 있으면 추가
+        let requestUrl = new url_1.URL(path, endpoint);
+        if (queryParams && typeof queryParams === 'object') {
+            Object.keys(queryParams).forEach(key => {
+                if (queryParams[key] !== null && queryParams[key] !== undefined) {
+                    requestUrl.searchParams.append(key, String(queryParams[key]));
+                }
+            });
+        }
+        const response = await page.evaluate(async (urlString, options) => {
+            const response = await fetch(urlString, options);
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+            }
+            const contentType = response.headers.get('content-type') || '';
+            if (contentType.includes('application/json')) {
+                return await response.json();
+            }
+            else if (contentType.includes('text/')) {
+                return await response.text();
+            }
+            else {
+                // 응답이 없는 경우 (204 No Content 등)
+                return null;
+            }
+        }, requestUrl.toString(), options);
+        return {
+            data: response
+        };
+    }
+    catch (error) {
+        logger.error('Error in HeadlessDelete:', error);
+        throw error;
+    }
+    finally {
+        await releasePage(page);
+    }
+}
+HeadlessDelete.parameterSpec = [
+    {
+        type: 'string',
+        name: 'path',
+        label: 'path'
+    },
+    {
+        type: 'http-headers',
+        name: 'headers',
+        label: 'headers'
+    },
+    {
+        type: 'options',
+        name: 'queryParams',
+        label: 'query-parameters'
+    }
+];
+task_registry_1.TaskRegistry.registerTaskHandler('headless-delete', HeadlessDelete);
+//# sourceMappingURL=headless-delete.js.map

package/dist-server/engine/task/headless-delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless-delete.js","sourceRoot":"","sources":["../../../server/engine/task/headless-delete.ts"],"names":[],"mappings":";;;AAAA,0DAAyB;AACzB,6BAAyB;AAEzB,oDAA+C;AAC/C,8DAAyD;AAEzD,KAAK,UAAU,cAAc,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;IAC1D,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,CAAA;IAChE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,WAAW,IAAI,EAAE,CAAA;IAExE,MAAM,UAAU,GAAG,MAAM,sCAAiB,CAAC,2BAA2B,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IAE9F,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,eAAe,cAAc,uBAAuB,CAAC,CAAA;IACvE,CAAC;IAED,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,WAAW,EAAE,GAAG,UAAU,CAAA;IAE1F,MAAM,OAAO,GAAG;QACd,GAAG,cAAc;KAClB,CAAA;IAED,MAAM,OAAO,GAAG;QACd,MAAM,EAAE,QAAQ;QAChB,OAAO;KACD,CAAA;IAER,MAAM,EAAE,kBAAkB,EAAE,GAAG,gBAAgB,CAAA;IAE/C,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxB,MAAM,UAAU,GAAG,IAAI,eAAK,CAAC,KAAK,CAAC;YACjC,kBAAkB;SACnB,CAAC,CAAA;QACF,OAAO,CAAC,KAAK,GAAG,UAAU,CAAA;IAC5B,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,kBAAkB,EAAE,CAAA;IAEvC,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,EAAC,GAAG,EAAC,EAAE;YAC7B,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;QACtD,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC,EAAE,CAAC,eAAe,EAAE,OAAO,CAAC,EAAE;YACjC,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;QAC/C,CAAC,CAAC,CAAA;QAEF,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAA;QAExD,+BAA+B;QAC/B,IAAI,UAAU,GAAG,IAAI,SAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;QACxC,IAAI,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;YACnD,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;gBACrC,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;oBAChE,UAAU,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;gBAC/D,CAAC;YACH,CAAC,CAAC,CAAA;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAClC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE;YAC3B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;YAEhD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAA;YACpE,CAAC;YAED,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAA;YAE9D,IAAI,WAAW,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;gBAC7C,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;YAC9B,CAAC;iBAAM,IAAI,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACzC,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;YAC9B,CAAC;iBAAM,CAAC;gBACN,+BAA+B;gBAC/B,OAAO,IAAI,CAAA;YACb,CAAC;QACH,CAAC,EACD,UAAU,CAAC,QAAQ,EAAE,EACrB,OAAO,CACR,CAAA;QAED,OAAO;YACL,IAAI,EAAE,QAAQ;SACf,CAAA;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAA;QAC/C,MAAM,KAAK,CAAA;IACb,CAAC;YAAS,CAAC;QACT,MAAM,WAAW,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;AACH,CAAC;AAED,cAAc,CAAC,aAAa,GAAG;IAC7B;QACE,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,MAAM;KACd;IACD;QACE,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;KACjB;IACD;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,kBAAkB;KAC1B;CACF,CAAA;AAED,4BAAY,CAAC,mBAAmB,CAAC,iBAAiB,EAAE,cAAc,CAAC,CAAA","sourcesContent":["import https from 'https'\nimport { URL } from 'url'\n\nimport { TaskRegistry } from '../task-registry'\nimport { ConnectionManager } from '../connection-manager'\n\nasync function HeadlessDelete(step, { logger, data, domain }) {\n  const { connection: connectionName, params: stepOptions } = step\n  const { headers: requestHeaders, path, queryParams } = stepOptions || {}\n\n  const connection = await ConnectionManager.getConnectionInstanceByName(domain, connectionName)\n\n  if (!connection) {\n    throw new Error(`Connection '${connectionName}' is not established.`)\n  }\n\n  const { endpoint, params: connectionParams, acquireSessionPage, releasePage } = connection\n\n  const headers = {\n    ...requestHeaders\n  }\n\n  const options = {\n    method: 'DELETE',\n    headers\n  } as any\n\n  const { rejectUnauthorized } = connectionParams\n\n  if (!rejectUnauthorized) {\n    const httpsAgent = new https.Agent({\n      rejectUnauthorized\n    })\n    options.agent = httpsAgent\n  }\n\n  const page = await acquireSessionPage()\n\n  try {\n    page.on('console', async msg => {\n      console.log(`[browser ${msg.type()}] ${msg.text()}`)\n    })\n\n    page.on('requestfailed', request => {\n      console.log('Request failed:', request.url())\n    })\n\n    await page.goto(endpoint, { waitUntil: 'networkidle2' })\n\n    // URL 구성 - queryParams가 있으면 추가\n    let requestUrl = new URL(path, endpoint)\n    if (queryParams && typeof queryParams === 'object') {\n      Object.keys(queryParams).forEach(key => {\n        if (queryParams[key] !== null && queryParams[key] !== undefined) {\n          requestUrl.searchParams.append(key, String(queryParams[key]))\n        }\n      })\n    }\n\n    const response = await page.evaluate(\n      async (urlString, options) => {\n        const response = await fetch(urlString, options)\n\n        if (!response.ok) {\n          throw new Error(`HTTP ${response.status}: ${response.statusText}`)\n        }\n\n        const contentType = response.headers.get('content-type') || ''\n        \n        if (contentType.includes('application/json')) {\n          return await response.json()\n        } else if (contentType.includes('text/')) {\n          return await response.text()\n        } else {\n          // 응답이 없는 경우 (204 No Content 등)\n          return null\n        }\n      },\n      requestUrl.toString(),\n      options\n    )\n\n    return {\n      data: response\n    }\n  } catch (error) {\n    logger.error('Error in HeadlessDelete:', error)\n    throw error\n  } finally {\n    await releasePage(page)\n  }\n}\n\nHeadlessDelete.parameterSpec = [\n  {\n    type: 'string',\n    name: 'path',\n    label: 'path'\n  },\n  {\n    type: 'http-headers',\n    name: 'headers',\n    label: 'headers'\n  },\n  {\n    type: 'options',\n    name: 'queryParams',\n    label: 'query-parameters'\n  }\n]\n\nTaskRegistry.registerTaskHandler('headless-delete', HeadlessDelete)"]}

package/dist-server/engine/task/headless-get.d.ts

@@ -0,0 +1 @@
+export {};