@things-factory/integration-base 9.0.0-beta.8 → 9.0.0

package/dist-server/service/connection/connection-type.js

@@ -9,14 +9,16 @@ const env_1 = require("@things-factory/env");
 const shell_1 = require("@things-factory/shell");
 const engine_1 = require("../../engine");
 const proxy_connector_1 = require("../../engine/connector/proxy-connector");
+const ORMCONFIG = env_1.config.get('ormconfig', {});
+const DATABASE_TYPE = ORMCONFIG.type;
 var ConnectionStatus;
 (function (ConnectionStatus) {
     ConnectionStatus["CONNECTED"] = "CONNECTED";
-    ConnectionStatus["DISCONNECTED"] = "DISCONNECTED";
+    ConnectionStatus["DISCONNECTED"] = "DISCONNECTED"; // Represents a terminated or inactive connection.
 })(ConnectionStatus || (exports.ConnectionStatus = ConnectionStatus = {}));
 (0, type_graphql_1.registerEnumType)(ConnectionStatus, {
     name: 'ConnectionStatus',
-    description: 'state enumeration of a connection'
+    description: 'Enumeration of possible states for a connection.'
 });
 let Connection = class Connection {
     /**
@@ -26,14 +28,10 @@ let Connection = class Connection {
     async connect() {
         const { type, edge } = this;
         const connector = edge ? proxy_connector_1.ProxyConnector.instance : engine_1.ConnectionManager.getConnector(type);
-        var params = {};
-        try {
-            params = JSON.parse(this.params || '{}');
-        }
-        catch (ex) {
-            env_1.logger.error(`connection '${this.name}' params should be JSON format`, ex);
-        }
-        await connector.connect(Object.assign(Object.assign({}, this), { params }));
+        await connector.connect({
+            ...this,
+            params: this.params || {}
+        });
     }
     /**
      * @brief Asynchronous method to disconnect the connection.
@@ -52,12 +50,12 @@ let Connection = class Connection {
 exports.Connection = Connection;
 tslib_1.__decorate([
     (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
-    (0, type_graphql_1.Field)(type => type_graphql_1.ID),
+    (0, type_graphql_1.Field)(type => type_graphql_1.ID, { description: 'Unique identifier for the connection.' }),
     tslib_1.__metadata("design:type", String)
 ], Connection.prototype, "id", void 0);
 tslib_1.__decorate([
     (0, typeorm_1.ManyToOne)(type => shell_1.Domain),
-    (0, type_graphql_1.Field)(type => shell_1.Domain, { nullable: true }),
+    (0, type_graphql_1.Field)(type => shell_1.Domain, { nullable: true, description: 'The domain to which this connection belongs.' }),
     tslib_1.__metadata("design:type", shell_1.Domain
     /**
      * Stores the ID of the associated Domain.
@@ -70,24 +68,24 @@ tslib_1.__decorate([
 ], Connection.prototype, "domainId", void 0);
 tslib_1.__decorate([
     (0, typeorm_1.Column)(),
-    (0, type_graphql_1.Field)(),
+    (0, type_graphql_1.Field)({ description: 'The name of the connection.' }),
     tslib_1.__metadata("design:type", String)
 ], Connection.prototype, "name", void 0);
 tslib_1.__decorate([
     (0, typeorm_1.Column)({
         nullable: true
     }),
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'A detailed description of the connection.' }),
     tslib_1.__metadata("design:type", String)
 ], Connection.prototype, "description", void 0);
 tslib_1.__decorate([
     (0, typeorm_1.Column)(),
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The type of the connection (e.g., tcp, http, mqtt).' }),
     tslib_1.__metadata("design:type", String)
 ], Connection.prototype, "type", void 0);
 tslib_1.__decorate([
     (0, typeorm_1.ManyToOne)(type => auth_base_1.Appliance, { nullable: true }),
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The edge appliance that delegates this connection, if any.' }),
     tslib_1.__metadata("design:type", auth_base_1.Appliance
     /**
      * Stores the ID of the Appliance who delegate the connection.
@@ -100,26 +98,45 @@ tslib_1.__decorate([
 ], Connection.prototype, "edgeId", void 0);
 tslib_1.__decorate([
     (0, typeorm_1.Column)(),
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The endpoint URL or address for the connection.' }),
     tslib_1.__metadata("design:type", String)
 ], Connection.prototype, "endpoint", void 0);
 tslib_1.__decorate([
     (0, typeorm_1.Column)({ nullable: true }),
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)({
+        nullable: true,
+        description: 'Indicates whether the connection is currently active and should be maintained.'
+    }),
     tslib_1.__metadata("design:type", Boolean)
 ], Connection.prototype, "active", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The current status of the connection (e.g., CONNECTED, DISCONNECTED).' }),
     tslib_1.__metadata("design:type", String)
 ], Connection.prototype, "state", void 0);
 tslib_1.__decorate([
-    (0, typeorm_1.Column)({ nullable: true }),
-    (0, type_graphql_1.Field)({ nullable: true }),
-    tslib_1.__metadata("design:type", String)
+    (0, typeorm_1.Column)({
+        type: DATABASE_TYPE == 'postgres' ? 'varchar' : 'simple-json',
+        nullable: true,
+        transformer: DATABASE_TYPE == 'postgres'
+            ? {
+                to: (value) => JSON.stringify(value),
+                from: (value) => {
+                    try {
+                        return JSON.parse(value);
+                    }
+                    catch (error) {
+                        return null;
+                    }
+                }
+            }
+            : undefined
+    }),
+    (0, type_graphql_1.Field)(type => shell_1.ScalarObject, { nullable: true, description: 'A key-value map of parameters for the connection.' }),
+    tslib_1.__metadata("design:type", Object)
 ], Connection.prototype, "params", void 0);
 tslib_1.__decorate([
     (0, typeorm_1.CreateDateColumn)(),
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The timestamp when the connection was created.' }),
     tslib_1.__metadata("design:type", Date
     /**
      * The date and time when the connection was last updated.
@@ -128,7 +145,7 @@ tslib_1.__decorate([
 ], Connection.prototype, "createdAt", void 0);
 tslib_1.__decorate([
     (0, typeorm_1.UpdateDateColumn)(),
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The timestamp when the connection was last updated.' }),
     tslib_1.__metadata("design:type", Date
     /**
      * Many-to-One relationship with the User entity who created the connection. Optional field.
@@ -137,7 +154,7 @@ tslib_1.__decorate([
 ], Connection.prototype, "updatedAt", void 0);
 tslib_1.__decorate([
     (0, typeorm_1.ManyToOne)(type => auth_base_1.User, { nullable: true }),
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The user who created the connection.' }),
     tslib_1.__metadata("design:type", auth_base_1.User
     /**
      * Stores the ID of the User who created the connection.
@@ -150,7 +167,7 @@ tslib_1.__decorate([
 ], Connection.prototype, "creatorId", void 0);
 tslib_1.__decorate([
     (0, typeorm_1.ManyToOne)(type => auth_base_1.User, { nullable: true }),
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The user who last updated the connection.' }),
     tslib_1.__metadata("design:type", auth_base_1.User
     /**
      * Stores the ID of the User who last updated the connection.
@@ -165,130 +182,133 @@ tslib_1.__decorate([
 exports.Connection = Connection = tslib_1.__decorate([
     (0, typeorm_1.Entity)(),
     (0, typeorm_1.Index)('ix_connection_0', (connection) => [connection.domain, connection.name], { unique: true }),
-    (0, type_graphql_1.ObjectType)()
+    (0, type_graphql_1.ObjectType)({ description: 'Represents a configured connection to an external system or service.' })
 ], Connection);
 let ConnectionState = class ConnectionState {
 };
 exports.ConnectionState = ConnectionState;
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)(type => shell_1.Domain),
+    (0, type_graphql_1.Field)(type => shell_1.Domain, { description: 'The domain of the connection.' }),
     tslib_1.__metadata("design:type", shell_1.Domain)
 ], ConnectionState.prototype, "domain", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The unique identifier of the connection.' }),
     tslib_1.__metadata("design:type", String)
 ], ConnectionState.prototype, "id", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The name of the connection.' }),
     tslib_1.__metadata("design:type", String)
 ], ConnectionState.prototype, "name", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The description of the connection.' }),
     tslib_1.__metadata("design:type", String)
 ], ConnectionState.prototype, "description", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The type of the connection.' }),
     tslib_1.__metadata("design:type", String)
 ], ConnectionState.prototype, "type", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)(type => auth_base_1.Appliance, { nullable: true }),
+    (0, type_graphql_1.Field)(type => auth_base_1.Appliance, { nullable: true, description: 'The edge appliance associated with the connection.' }),
     tslib_1.__metadata("design:type", auth_base_1.Appliance)
 ], ConnectionState.prototype, "edge", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The current status of the connection.' }),
     tslib_1.__metadata("design:type", String)
 ], ConnectionState.prototype, "state", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The timestamp when this state was recorded.' }),
     tslib_1.__metadata("design:type", Date)
 ], ConnectionState.prototype, "timestamp", void 0);
 exports.ConnectionState = ConnectionState = tslib_1.__decorate([
-    (0, type_graphql_1.ObjectType)()
+    (0, type_graphql_1.ObjectType)({ description: 'Represents the state of a connection at a point in time.' })
 ], ConnectionState);
 let NewConnection = class NewConnection {
 };
 exports.NewConnection = NewConnection;
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)(),
+    (0, type_graphql_1.Field)({ description: 'The name for the new connection.' }),
     tslib_1.__metadata("design:type", String)
 ], NewConnection.prototype, "name", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'A detailed description for the new connection.' }),
     tslib_1.__metadata("design:type", String)
 ], NewConnection.prototype, "description", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The type of the new connection (e.g., tcp, http, mqtt).' }),
     tslib_1.__metadata("design:type", String)
 ], NewConnection.prototype, "type", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)(type => shell_1.ObjectRef, { nullable: true }),
+    (0, type_graphql_1.Field)(type => shell_1.ObjectRef, { nullable: true, description: 'Reference to the edge appliance for the new connection.' }),
     tslib_1.__metadata("design:type", auth_base_1.Appliance)
 ], NewConnection.prototype, "edge", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The endpoint URL or address for the new connection.' }),
     tslib_1.__metadata("design:type", String)
 ], NewConnection.prototype, "endpoint", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true }),
-    tslib_1.__metadata("design:type", String)
+    (0, type_graphql_1.Field)(type => shell_1.ScalarObject, { nullable: true, description: 'A key-value map of parameters for the new connection.' }),
+    tslib_1.__metadata("design:type", Object)
 ], NewConnection.prototype, "params", void 0);
 exports.NewConnection = NewConnection = tslib_1.__decorate([
-    (0, type_graphql_1.InputType)()
+    (0, type_graphql_1.InputType)({ description: 'Input for creating a new connection.' })
 ], NewConnection);
 let ConnectionPatch = class ConnectionPatch {
 };
 exports.ConnectionPatch = ConnectionPatch;
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)(type => type_graphql_1.ID, { nullable: true }),
+    (0, type_graphql_1.Field)(type => type_graphql_1.ID, { nullable: true, description: 'The unique identifier of the connection to update.' }),
     tslib_1.__metadata("design:type", String)
 ], ConnectionPatch.prototype, "id", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The new name for the connection.' }),
     tslib_1.__metadata("design:type", String)
 ], ConnectionPatch.prototype, "name", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The new description for the connection.' }),
     tslib_1.__metadata("design:type", String)
 ], ConnectionPatch.prototype, "description", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The new type for the connection.' }),
     tslib_1.__metadata("design:type", String)
 ], ConnectionPatch.prototype, "type", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)(type => shell_1.ObjectRef, { nullable: true }),
+    (0, type_graphql_1.Field)(type => shell_1.ObjectRef, { nullable: true, description: 'The new edge appliance for the connection.' }),
     tslib_1.__metadata("design:type", auth_base_1.Appliance)
 ], ConnectionPatch.prototype, "edge", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The new endpoint for the connection.' }),
     tslib_1.__metadata("design:type", String)
 ], ConnectionPatch.prototype, "endpoint", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The new active status for the connection.' }),
     tslib_1.__metadata("design:type", Boolean)
 ], ConnectionPatch.prototype, "active", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true }),
-    tslib_1.__metadata("design:type", String)
+    (0, type_graphql_1.Field)(type => shell_1.ScalarObject, { nullable: true, description: 'The new parameters for the connection.' }),
+    tslib_1.__metadata("design:type", Object)
 ], ConnectionPatch.prototype, "params", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)({
+        nullable: true,
+        description: 'A flag indicating whether the connection is being created, updated, or deleted.'
+    }),
     tslib_1.__metadata("design:type", String)
 ], ConnectionPatch.prototype, "cuFlag", void 0);
 exports.ConnectionPatch = ConnectionPatch = tslib_1.__decorate([
-    (0, type_graphql_1.InputType)()
+    (0, type_graphql_1.InputType)({ description: 'Input for updating (patching) an existing connection.' })
 ], ConnectionPatch);
 let ConnectionList = class ConnectionList {
 };
 exports.ConnectionList = ConnectionList;
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)(type => [Connection]),
+    (0, type_graphql_1.Field)(type => [Connection], { description: 'The list of connection items.' }),
     tslib_1.__metadata("design:type", Array)
 ], ConnectionList.prototype, "items", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)(type => type_graphql_1.Int),
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'The total number of connections.' }),
     tslib_1.__metadata("design:type", Number)
 ], ConnectionList.prototype, "total", void 0);
 exports.ConnectionList = ConnectionList = tslib_1.__decorate([
-    (0, type_graphql_1.ObjectType)()
+    (0, type_graphql_1.ObjectType)({ description: 'A paginated list of connections.' })
 ], ConnectionList);
 //# sourceMappingURL=connection-type.js.map

package/dist-server/service/connection/connection-type.js.map

@@ -1 +1 @@
-{"version":3,"file":"connection-type.js","sourceRoot":"","sources":["../../../server/service/connection/connection-type.ts"],"names":[],"mappings":"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","sourcesContent":["import { Field, ID, InputType, Int, ObjectType, registerEnumType } from 'type-graphql'\nimport {\n  Column,\n  CreateDateColumn,\n  Entity,\n  Index,\n  ManyToOne,\n  PrimaryGeneratedColumn,\n  RelationId,\n  UpdateDateColumn\n} from 'typeorm'\n\nimport { User, Appliance } from '@things-factory/auth-base'\nimport { logger } from '@things-factory/env'\nimport { Domain, ObjectRef } from '@things-factory/shell'\n\nimport { ConnectionManager } from '../../engine'\nimport { ProxyConnector } from '../../engine/connector/proxy-connector'\n\nexport enum ConnectionStatus {\n  CONNECTED = 'CONNECTED',\n  DISCONNECTED = 'DISCONNECTED'\n}\n\nregisterEnumType(ConnectionStatus, {\n  name: 'ConnectionStatus',\n  description: 'state enumeration of a connection'\n})\n\n@Entity()\n@Index('ix_connection_0', (connection: Connection) => [connection.domain, connection.name], { unique: true })\n@ObjectType()\nexport class Connection {\n  /**\n   * Unique identifier for the connection, generated in UUID format.\n   */\n  @PrimaryGeneratedColumn('uuid')\n  @Field(type => ID)\n  readonly id: string\n\n  /**\n   * Many-to-One relationship with the Domain entity.\n   */\n  @ManyToOne(type => Domain)\n  @Field(type => Domain, { nullable: true })\n  domain: Domain\n\n  /**\n   * Stores the ID of the associated Domain.\n   */\n  @RelationId((connection: Connection) => connection.domain)\n  domainId: string\n\n  /**\n   * The name of the connection.\n   */\n  @Column()\n  @Field()\n  name: string\n\n  /**\n   * Optional description for the connection.\n   */\n  @Column({\n    nullable: true\n  })\n  @Field({ nullable: true })\n  description: string\n\n  /**\n   * The type of the connection.\n   */\n  @Column()\n  @Field({ nullable: true })\n  type: string\n\n  /**\n   * Many-to-One relationship with the Appliance entity which delegate the connection. Optional field.\n   */\n  @ManyToOne(type => Appliance, { nullable: true })\n  @Field({ nullable: true })\n  edge: Appliance\n\n  /**\n   * Stores the ID of the Appliance who delegate the connection.\n   */\n  @RelationId((connection: Connection) => connection.edge)\n  edgeId: string\n\n  /**\n   * The endpoint for the connection.\n   */\n  @Column()\n  @Field({ nullable: true })\n  endpoint: string\n\n  /**\n   * Indicates the active status of the connection.\n   */\n  @Column({ nullable: true })\n  @Field({ nullable: true })\n  active: boolean\n\n  /**\n   * The status of the connection, using the ConnectionStatus type.\n   */\n  @Field({ nullable: true })\n  state: ConnectionStatus\n\n  /**\n   * Additional parameters for the connection, stored as a JSON string.\n   */\n  @Column({ nullable: true })\n  @Field({ nullable: true })\n  params: string\n\n  /**\n   * The date and time when the connection was created.\n   */\n  @CreateDateColumn()\n  @Field({ nullable: true })\n  createdAt: Date\n\n  /**\n   * The date and time when the connection was last updated.\n   */\n  @UpdateDateColumn()\n  @Field({ nullable: true })\n  updatedAt: Date\n\n  /**\n   * Many-to-One relationship with the User entity who created the connection. Optional field.\n   */\n  @ManyToOne(type => User, { nullable: true })\n  @Field({ nullable: true })\n  creator: User\n\n  /**\n   * Stores the ID of the User who created the connection.\n   */\n  @RelationId((connection: Connection) => connection.creator)\n  creatorId: string\n\n  /**\n   * Many-to-One relationship with the User entity who last updated the connection.\n   * Optional field.\n   */\n  @ManyToOne(type => User, { nullable: true })\n  @Field({ nullable: true })\n  updater: User\n\n  /**\n   * Stores the ID of the User who last updated the connection.\n   *\n   */\n  @RelationId((connection: Connection) => connection.updater)\n  updaterId: string\n\n  /**\n   * Asynchronous method to establish the connection.\n   *\n   */\n  async connect() {\n    const { type, edge } = this\n    const connector = edge ? ProxyConnector.instance : ConnectionManager.getConnector(type)\n    var params = {}\n\n    try {\n      params = JSON.parse(this.params || '{}')\n    } catch (ex) {\n      logger.error(`connection '${this.name}' params should be JSON format`, ex)\n    }\n\n    await connector.connect({\n      ...this,\n      params\n    })\n  }\n\n  /**\n   * @brief Asynchronous method to disconnect the connection.\n   *\n   */\n  async disconnect() {\n    try {\n      const { type, edge } = this\n      const connector = edge ? ProxyConnector.instance : ConnectionManager.getConnector(type)\n      await connector.disconnect(this)\n    } finally {\n    }\n  }\n}\n\n/**\n * Connection의 params의 원 타입과 사용 시에 타입 불일치로 인해 임시적으로 생성한 타입으로\n * 추후, 타입 일치를 통해서 제거할 예정임.\n *\n */\nexport interface InputConnection extends Connection {\n  params: any\n}\n\n@ObjectType()\nexport class ConnectionState {\n  @Field(type => Domain)\n  domain?: Domain\n\n  @Field({ nullable: true })\n  id?: string\n\n  @Field({ nullable: true })\n  name?: string\n\n  @Field({ nullable: true })\n  description?: string\n\n  @Field({ nullable: true })\n  type?: string\n\n  @Field(type => Appliance, { nullable: true })\n  edge?: Appliance\n\n  @Field({ nullable: true })\n  state?: ConnectionStatus\n\n  @Field({ nullable: true })\n  timestamp?: Date\n}\n\n@InputType()\nexport class NewConnection {\n  @Field()\n  name: string\n\n  @Field({ nullable: true })\n  description?: string\n\n  @Field({ nullable: true })\n  type?: string\n\n  @Field(type => ObjectRef, { nullable: true })\n  edge?: Appliance\n\n  @Field({ nullable: true })\n  endpoint?: string\n\n  @Field({ nullable: true })\n  params?: string\n}\n\n@InputType()\nexport class ConnectionPatch {\n  @Field(type => ID, { nullable: true })\n  id: string\n\n  @Field({ nullable: true })\n  name?: string\n\n  @Field({ nullable: true })\n  description?: string\n\n  @Field({ nullable: true })\n  type?: string\n\n  @Field(type => ObjectRef, { nullable: true })\n  edge?: Appliance\n\n  @Field({ nullable: true })\n  endpoint?: string\n\n  @Field({ nullable: true })\n  active?: boolean\n\n  @Field({ nullable: true })\n  params?: string\n\n  @Field({ nullable: true })\n  cuFlag?: string\n}\n\n@ObjectType()\nexport class ConnectionList {\n  @Field(type => [Connection])\n  items: Connection[]\n\n  @Field(type => Int)\n  total: number\n}\n"]}
+{"version":3,"file":"connection-type.js","sourceRoot":"","sources":["../../../server/service/connection/connection-type.ts"],"names":[],"mappings":"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","sourcesContent":["import { Field, ID, InputType, Int, ObjectType, registerEnumType } from 'type-graphql'\nimport {\n  Column,\n  CreateDateColumn,\n  Entity,\n  Index,\n  ManyToOne,\n  PrimaryGeneratedColumn,\n  RelationId,\n  UpdateDateColumn\n} from 'typeorm'\n\nimport { User, Appliance } from '@things-factory/auth-base'\nimport { config } from '@things-factory/env'\nimport { Domain, ObjectRef, ScalarObject } from '@things-factory/shell'\n\nimport { ConnectionManager } from '../../engine'\nimport { ProxyConnector } from '../../engine/connector/proxy-connector'\n\nconst ORMCONFIG = config.get('ormconfig', {})\nconst DATABASE_TYPE = ORMCONFIG.type\n\nexport enum ConnectionStatus {\n  CONNECTED = 'CONNECTED', // Represents an active, established connection.\n  DISCONNECTED = 'DISCONNECTED' // Represents a terminated or inactive connection.\n}\n\nregisterEnumType(ConnectionStatus, {\n  name: 'ConnectionStatus',\n  description: 'Enumeration of possible states for a connection.'\n})\n\n@Entity()\n@Index('ix_connection_0', (connection: Connection) => [connection.domain, connection.name], { unique: true })\n@ObjectType({ description: 'Represents a configured connection to an external system or service.' })\nexport class Connection {\n  /**\n   * Unique identifier for the connection, generated in UUID format.\n   */\n  @PrimaryGeneratedColumn('uuid')\n  @Field(type => ID, { description: 'Unique identifier for the connection.' })\n  readonly id: string\n\n  /**\n   * Many-to-One relationship with the Domain entity.\n   */\n  @ManyToOne(type => Domain)\n  @Field(type => Domain, { nullable: true, description: 'The domain to which this connection belongs.' })\n  domain: Domain\n\n  /**\n   * Stores the ID of the associated Domain.\n   */\n  @RelationId((connection: Connection) => connection.domain)\n  domainId: string\n\n  /**\n   * The name of the connection.\n   */\n  @Column()\n  @Field({ description: 'The name of the connection.' })\n  name: string\n\n  /**\n   * Optional description for the connection.\n   */\n  @Column({\n    nullable: true\n  })\n  @Field({ nullable: true, description: 'A detailed description of the connection.' })\n  description: string\n\n  /**\n   * The type of the connection.\n   */\n  @Column()\n  @Field({ nullable: true, description: 'The type of the connection (e.g., tcp, http, mqtt).' })\n  type: string\n\n  /**\n   * Many-to-One relationship with the Appliance entity which delegate the connection. Optional field.\n   */\n  @ManyToOne(type => Appliance, { nullable: true })\n  @Field({ nullable: true, description: 'The edge appliance that delegates this connection, if any.' })\n  edge: Appliance\n\n  /**\n   * Stores the ID of the Appliance who delegate the connection.\n   */\n  @RelationId((connection: Connection) => connection.edge)\n  edgeId: string\n\n  /**\n   * The endpoint for the connection.\n   */\n  @Column()\n  @Field({ nullable: true, description: 'The endpoint URL or address for the connection.' })\n  endpoint: string\n\n  /**\n   * Indicates the active status of the connection.\n   */\n  @Column({ nullable: true })\n  @Field({\n    nullable: true,\n    description: 'Indicates whether the connection is currently active and should be maintained.'\n  })\n  active: boolean\n\n  /**\n   * The status of the connection, using the ConnectionStatus type.\n   */\n  @Field({ nullable: true, description: 'The current status of the connection (e.g., CONNECTED, DISCONNECTED).' })\n  state: ConnectionStatus\n\n  /**\n   * Additional parameters for the connection, stored as a JSON string.\n   *\n   * [Caution]\n   * 이 컬럼타입은 postgres 데이터베이스에서는 varchar 타입을 유지한다.\n   * 이는 데이터베이스 타입을 변경하면 기존 데이터가 손실될 수 있기 때문이다.\n   * 'simple-json' 타입으로 변경 전에 postgres 데이타베이스에 이미 varchar 타입으로 사용한 사례가 많기 때문이다.\n   */\n  @Column({\n    type: DATABASE_TYPE == 'postgres' ? 'varchar' : 'simple-json',\n    nullable: true,\n    transformer:\n      DATABASE_TYPE == 'postgres'\n        ? {\n            to: (value: any) => JSON.stringify(value),\n            from: (value: string) => {\n              try {\n                return JSON.parse(value)\n              } catch (error) {\n                return null\n              }\n            }\n          }\n        : undefined\n  })\n  @Field(type => ScalarObject, { nullable: true, description: 'A key-value map of parameters for the connection.' })\n  params: { [key: string]: any }\n\n  /**\n   * The date and time when the connection was created.\n   */\n  @CreateDateColumn()\n  @Field({ nullable: true, description: 'The timestamp when the connection was created.' })\n  createdAt: Date\n\n  /**\n   * The date and time when the connection was last updated.\n   */\n  @UpdateDateColumn()\n  @Field({ nullable: true, description: 'The timestamp when the connection was last updated.' })\n  updatedAt: Date\n\n  /**\n   * Many-to-One relationship with the User entity who created the connection. Optional field.\n   */\n  @ManyToOne(type => User, { nullable: true })\n  @Field({ nullable: true, description: 'The user who created the connection.' })\n  creator: User\n\n  /**\n   * Stores the ID of the User who created the connection.\n   */\n  @RelationId((connection: Connection) => connection.creator)\n  creatorId: string\n\n  /**\n   * Many-to-One relationship with the User entity who last updated the connection.\n   * Optional field.\n   */\n  @ManyToOne(type => User, { nullable: true })\n  @Field({ nullable: true, description: 'The user who last updated the connection.' })\n  updater: User\n\n  /**\n   * Stores the ID of the User who last updated the connection.\n   *\n   */\n  @RelationId((connection: Connection) => connection.updater)\n  updaterId: string\n\n  /**\n   * Asynchronous method to establish the connection.\n   *\n   */\n  async connect() {\n    const { type, edge } = this\n    const connector = edge ? ProxyConnector.instance : ConnectionManager.getConnector(type)\n\n    await connector.connect({\n      ...this,\n      params: this.params || {}\n    })\n  }\n\n  /**\n   * @brief Asynchronous method to disconnect the connection.\n   *\n   */\n  async disconnect() {\n    try {\n      const { type, edge } = this\n      const connector = edge ? ProxyConnector.instance : ConnectionManager.getConnector(type)\n      await connector.disconnect(this)\n    } finally {\n    }\n  }\n}\n\n/**\n * Connection의 params의 원 타입과 사용 시에 타입 불일치로 인해 임시적으로 생성한 타입으로\n * 추후, 타입 일치를 통해서 제거할 예정임.\n *\n */\nexport interface InputConnection extends Connection {\n  params: any\n}\n\n@ObjectType({ description: 'Represents the state of a connection at a point in time.' })\nexport class ConnectionState {\n  @Field(type => Domain, { description: 'The domain of the connection.' })\n  domain?: Domain\n\n  @Field({ nullable: true, description: 'The unique identifier of the connection.' })\n  id?: string\n\n  @Field({ nullable: true, description: 'The name of the connection.' })\n  name?: string\n\n  @Field({ nullable: true, description: 'The description of the connection.' })\n  description?: string\n\n  @Field({ nullable: true, description: 'The type of the connection.' })\n  type?: string\n\n  @Field(type => Appliance, { nullable: true, description: 'The edge appliance associated with the connection.' })\n  edge?: Appliance\n\n  @Field({ nullable: true, description: 'The current status of the connection.' })\n  state?: ConnectionStatus\n\n  @Field({ nullable: true, description: 'The timestamp when this state was recorded.' })\n  timestamp?: Date\n}\n\n@InputType({ description: 'Input for creating a new connection.' })\nexport class NewConnection {\n  @Field({ description: 'The name for the new connection.' })\n  name: string\n\n  @Field({ nullable: true, description: 'A detailed description for the new connection.' })\n  description?: string\n\n  @Field({ nullable: true, description: 'The type of the new connection (e.g., tcp, http, mqtt).' })\n  type?: string\n\n  @Field(type => ObjectRef, { nullable: true, description: 'Reference to the edge appliance for the new connection.' })\n  edge?: Appliance\n\n  @Field({ nullable: true, description: 'The endpoint URL or address for the new connection.' })\n  endpoint?: string\n\n  @Field(type => ScalarObject, { nullable: true, description: 'A key-value map of parameters for the new connection.' })\n  params?: { [key: string]: any }\n}\n\n@InputType({ description: 'Input for updating (patching) an existing connection.' })\nexport class ConnectionPatch {\n  @Field(type => ID, { nullable: true, description: 'The unique identifier of the connection to update.' })\n  id: string\n\n  @Field({ nullable: true, description: 'The new name for the connection.' })\n  name?: string\n\n  @Field({ nullable: true, description: 'The new description for the connection.' })\n  description?: string\n\n  @Field({ nullable: true, description: 'The new type for the connection.' })\n  type?: string\n\n  @Field(type => ObjectRef, { nullable: true, description: 'The new edge appliance for the connection.' })\n  edge?: Appliance\n\n  @Field({ nullable: true, description: 'The new endpoint for the connection.' })\n  endpoint?: string\n\n  @Field({ nullable: true, description: 'The new active status for the connection.' })\n  active?: boolean\n\n  @Field(type => ScalarObject, { nullable: true, description: 'The new parameters for the connection.' })\n  params?: { [key: string]: any }\n\n  @Field({\n    nullable: true,\n    description: 'A flag indicating whether the connection is being created, updated, or deleted.'\n  })\n  cuFlag?: string\n}\n\n@ObjectType({ description: 'A paginated list of connections.' })\nexport class ConnectionList {\n  @Field(type => [Connection], { description: 'The list of connection items.' })\n  items: Connection[]\n\n  @Field(type => Int, { description: 'The total number of connections.' })\n  total: number\n}\n"]}

package/dist-server/service/connector/connector-query.d.ts

@@ -1,6 +1,9 @@
 import { ConnectorList, ConnectorType } from './connector-type';
+/**
+ * @description Provides GraphQL resolvers for connector types.
+ */
 export declare class ConnectorQuery {
-    connection(name: string, context: ResolverContext): Promise<ConnectorType>;
+    connector(name: string, context: ResolverContext): Promise<ConnectorType>;
     connectors(): Promise<ConnectorList>;
     connectorByConnection(connectionName: string, context: ResolverContext): Promise<ConnectorType>;
 }

package/dist-server/service/connector/connector-query.js

@@ -7,8 +7,11 @@ const shell_1 = require("@things-factory/shell");
 const connection_manager_1 = require("../../engine/connection-manager");
 const connection_type_1 = require("../connection/connection-type");
 const connector_type_1 = require("./connector-type");
+/**
+ * @description Provides GraphQL resolvers for connector types.
+ */
 let ConnectorQuery = class ConnectorQuery {
-    async connection(name, context) {
+    async connector(name, context) {
         // @ts-ignore
         const { description, help, parameterSpec, taskPrefixes } = connection_manager_1.ConnectionManager.getConnector(name) || {};
         return {
@@ -50,21 +53,21 @@ let ConnectorQuery = class ConnectorQuery {
 };
 exports.ConnectorQuery = ConnectorQuery;
 tslib_1.__decorate([
-    (0, type_graphql_1.Query)(returns => connector_type_1.ConnectorType, { description: 'To fetch a connector' }),
+    (0, type_graphql_1.Query)(returns => connector_type_1.ConnectorType, { description: 'Fetches a single connector type by its name.' }),
     tslib_1.__param(0, (0, type_graphql_1.Arg)('name')),
     tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
     tslib_1.__metadata("design:type", Function),
     tslib_1.__metadata("design:paramtypes", [String, Object]),
     tslib_1.__metadata("design:returntype", Promise)
-], ConnectorQuery.prototype, "connection", null);
+], ConnectorQuery.prototype, "connector", null);
 tslib_1.__decorate([
-    (0, type_graphql_1.Query)(returns => connector_type_1.ConnectorList, { description: 'To fetch multiple connector' }),
+    (0, type_graphql_1.Query)(returns => connector_type_1.ConnectorList, { description: 'Fetches a list of all available connector types.' }),
     tslib_1.__metadata("design:type", Function),
     tslib_1.__metadata("design:paramtypes", []),
     tslib_1.__metadata("design:returntype", Promise)
 ], ConnectorQuery.prototype, "connectors", null);
 tslib_1.__decorate([
-    (0, type_graphql_1.Query)(returns => connector_type_1.ConnectorType, { description: 'To fetch the connector from a connection' }),
+    (0, type_graphql_1.Query)(returns => connector_type_1.ConnectorType, { description: 'Fetches the connector type associated with a specific connection.' }),
     tslib_1.__param(0, (0, type_graphql_1.Arg)('connectionName')),
     tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
     tslib_1.__metadata("design:type", Function),

package/dist-server/service/connector/connector-query.js.map

@@ -1 +1 @@
-{"version":3,"file":"connector-query.js","sourceRoot":"","sources":["../../../server/service/connector/connector-query.ts"],"names":[],"mappings":";;;;AAAA,+CAAwD;AAExD,iDAAqD;AAErD,wEAAmE;AACnE,mEAA0D;AAC1D,qDAA+D;AAGxD,IAAM,cAAc,GAApB,MAAM,cAAc;IAEnB,AAAN,KAAK,CAAC,UAAU,CAAc,IAAY,EAAS,OAAwB;QACzE,aAAa;QACb,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE,YAAY,EAAE,GAAG,sCAAiB,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;QAErG,OAAO;YACL,IAAI;YACJ,WAAW;YACX,IAAI;YACJ,aAAa;YACb,YAAY,EAAE,YAAY,IAAI,EAAE;SACjC,CAAA;IACH,CAAC;IAGK,AAAN,KAAK,CAAC,UAAU;QACd,IAAI,UAAU,GAAG,sCAAiB,CAAC,aAAa,EAAE,CAAA;QAClD,IAAI,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;aAChC,GAAG,CAAC,IAAI,CAAC,EAAE;YACV,IAAI,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;YAChC,OAAO;gBACL,IAAI;gBACJ,WAAW,EAAE,SAAS,CAAC,WAAW;gBAClC,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,aAAa,EAAE,SAAS,CAAC,aAAa;gBACtC,YAAY,EAAE,SAAS,CAAC,YAAY,IAAI,EAAE;aAC3C,CAAA;QACH,CAAC,CAAC;aACD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACb,OAAO,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QACjC,CAAC,CAAC,CAAA;QAEJ,OAAO;YACL,KAAK;YACL,KAAK,EAAE,KAAK,CAAC,MAAM;SACpB,CAAA;IACH,CAAC;IAGK,AAAN,KAAK,CAAC,qBAAqB,CACF,cAAsB,EACtC,OAAwB;QAE/B,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;QAEhC,IAAI,UAAU,GAAG,MAAM,IAAA,qBAAa,EAAC,4BAAU,CAAC,CAAC,OAAO,CAAC;YACvD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE;SAC3D,CAAC,CAAA;QAEF,OAAO,UAAU,IAAK,sCAAiB,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,CAAS,CAAA;IAC/E,CAAC;CACF,CAAA;AApDY,wCAAc;AAEnB;IADL,IAAA,oBAAK,EAAC,OAAO,CAAC,EAAE,CAAC,8BAAa,EAAE,EAAE,WAAW,EAAE,sBAAsB,EAAE,CAAC;IACvD,mBAAA,IAAA,kBAAG,EAAC,MAAM,CAAC,CAAA;IAAgB,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;gDAWjD;AAGK;IADL,IAAA,oBAAK,EAAC,OAAO,CAAC,EAAE,CAAC,8BAAa,EAAE,EAAE,WAAW,EAAE,6BAA6B,EAAE,CAAC;;;;gDAsB/E;AAGK;IADL,IAAA,oBAAK,EAAC,OAAO,CAAC,EAAE,CAAC,8BAAa,EAAE,EAAE,WAAW,EAAE,0CAA0C,EAAE,CAAC;IAE1F,mBAAA,IAAA,kBAAG,EAAC,gBAAgB,CAAC,CAAA;IACrB,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;2DASP;yBAnDU,cAAc;IAD1B,IAAA,uBAAQ,EAAC,8BAAa,CAAC;GACX,cAAc,CAoD1B","sourcesContent":["import { Arg, Ctx, Query, Resolver } from 'type-graphql'\n\nimport { getRepository } from '@things-factory/shell'\n\nimport { ConnectionManager } from '../../engine/connection-manager'\nimport { Connection } from '../connection/connection-type'\nimport { ConnectorList, ConnectorType } from './connector-type'\n\n@Resolver(ConnectorType)\nexport class ConnectorQuery {\n  @Query(returns => ConnectorType, { description: 'To fetch a connector' })\n  async connection(@Arg('name') name: string, @Ctx() context: ResolverContext): Promise<ConnectorType> {\n    // @ts-ignore\n    const { description, help, parameterSpec, taskPrefixes } = ConnectionManager.getConnector(name) || {}\n\n    return {\n      name,\n      description,\n      help,\n      parameterSpec,\n      taskPrefixes: taskPrefixes || []\n    }\n  }\n\n  @Query(returns => ConnectorList, { description: 'To fetch multiple connector' })\n  async connectors(): Promise<ConnectorList> {\n    var connectors = ConnectionManager.getConnectors()\n    var items = Object.keys(connectors)\n      .map(name => {\n        var connector = connectors[name]\n        return {\n          name,\n          description: connector.description,\n          help: connector.help,\n          parameterSpec: connector.parameterSpec,\n          taskPrefixes: connector.taskPrefixes || []\n        }\n      })\n      .sort((x, y) => {\n        return x.name < y.name ? -1 : 1\n      })\n\n    return {\n      items,\n      total: items.length\n    }\n  }\n\n  @Query(returns => ConnectorType, { description: 'To fetch the connector from a connection' })\n  async connectorByConnection(\n    @Arg('connectionName') connectionName: string,\n    @Ctx() context: ResolverContext\n  ): Promise<ConnectorType> {\n    const { domain } = context.state\n\n    var connection = await getRepository(Connection).findOne({\n      where: { domain: { id: domain.id }, name: connectionName }\n    })\n\n    return connection && (ConnectionManager.getConnector(connection.type) as any)\n  }\n}\n"]}
+{"version":3,"file":"connector-query.js","sourceRoot":"","sources":["../../../server/service/connector/connector-query.ts"],"names":[],"mappings":";;;;AAAA,+CAAwD;AAExD,iDAAqD;AAErD,wEAAmE;AACnE,mEAA0D;AAC1D,qDAA+D;AAE/D;;GAEG;AAEI,IAAM,cAAc,GAApB,MAAM,cAAc;IAEnB,AAAN,KAAK,CAAC,SAAS,CAAc,IAAY,EAAS,OAAwB;QACxE,aAAa;QACb,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE,YAAY,EAAE,GAAG,sCAAiB,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;QAErG,OAAO;YACL,IAAI;YACJ,WAAW;YACX,IAAI;YACJ,aAAa;YACb,YAAY,EAAE,YAAY,IAAI,EAAE;SACjC,CAAA;IACH,CAAC;IAGK,AAAN,KAAK,CAAC,UAAU;QACd,IAAI,UAAU,GAAG,sCAAiB,CAAC,aAAa,EAAE,CAAA;QAClD,IAAI,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;aAChC,GAAG,CAAC,IAAI,CAAC,EAAE;YACV,IAAI,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;YAChC,OAAO;gBACL,IAAI;gBACJ,WAAW,EAAE,SAAS,CAAC,WAAW;gBAClC,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,aAAa,EAAE,SAAS,CAAC,aAAa;gBACtC,YAAY,EAAE,SAAS,CAAC,YAAY,IAAI,EAAE;aAC3C,CAAA;QACH,CAAC,CAAC;aACD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACb,OAAO,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QACjC,CAAC,CAAC,CAAA;QAEJ,OAAO;YACL,KAAK;YACL,KAAK,EAAE,KAAK,CAAC,MAAM;SACpB,CAAA;IACH,CAAC;IAGK,AAAN,KAAK,CAAC,qBAAqB,CACF,cAAsB,EACtC,OAAwB;QAE/B,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;QAEhC,IAAI,UAAU,GAAG,MAAM,IAAA,qBAAa,EAAC,4BAAU,CAAC,CAAC,OAAO,CAAC;YACvD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE;SAC3D,CAAC,CAAA;QAEF,OAAO,UAAU,IAAK,sCAAiB,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,CAAS,CAAA;IAC/E,CAAC;CACF,CAAA;AApDY,wCAAc;AAEnB;IADL,IAAA,oBAAK,EAAC,OAAO,CAAC,EAAE,CAAC,8BAAa,EAAE,EAAE,WAAW,EAAE,8CAA8C,EAAE,CAAC;IAChF,mBAAA,IAAA,kBAAG,EAAC,MAAM,CAAC,CAAA;IAAgB,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;+CAWhD;AAGK;IADL,IAAA,oBAAK,EAAC,OAAO,CAAC,EAAE,CAAC,8BAAa,EAAE,EAAE,WAAW,EAAE,kDAAkD,EAAE,CAAC;;;;gDAsBpG;AAGK;IADL,IAAA,oBAAK,EAAC,OAAO,CAAC,EAAE,CAAC,8BAAa,EAAE,EAAE,WAAW,EAAE,mEAAmE,EAAE,CAAC;IAEnH,mBAAA,IAAA,kBAAG,EAAC,gBAAgB,CAAC,CAAA;IACrB,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;2DASP;yBAnDU,cAAc;IAD1B,IAAA,uBAAQ,EAAC,8BAAa,CAAC;GACX,cAAc,CAoD1B","sourcesContent":["import { Arg, Ctx, Query, Resolver } from 'type-graphql'\n\nimport { getRepository } from '@things-factory/shell'\n\nimport { ConnectionManager } from '../../engine/connection-manager'\nimport { Connection } from '../connection/connection-type'\nimport { ConnectorList, ConnectorType } from './connector-type'\n\n/**\n * @description Provides GraphQL resolvers for connector types.\n */\n@Resolver(ConnectorType)\nexport class ConnectorQuery {\n  @Query(returns => ConnectorType, { description: 'Fetches a single connector type by its name.' })\n  async connector(@Arg('name') name: string, @Ctx() context: ResolverContext): Promise<ConnectorType> {\n    // @ts-ignore\n    const { description, help, parameterSpec, taskPrefixes } = ConnectionManager.getConnector(name) || {}\n\n    return {\n      name,\n      description,\n      help,\n      parameterSpec,\n      taskPrefixes: taskPrefixes || []\n    }\n  }\n\n  @Query(returns => ConnectorList, { description: 'Fetches a list of all available connector types.' })\n  async connectors(): Promise<ConnectorList> {\n    var connectors = ConnectionManager.getConnectors()\n    var items = Object.keys(connectors)\n      .map(name => {\n        var connector = connectors[name]\n        return {\n          name,\n          description: connector.description,\n          help: connector.help,\n          parameterSpec: connector.parameterSpec,\n          taskPrefixes: connector.taskPrefixes || []\n        }\n      })\n      .sort((x, y) => {\n        return x.name < y.name ? -1 : 1\n      })\n\n    return {\n      items,\n      total: items.length\n    }\n  }\n\n  @Query(returns => ConnectorType, { description: 'Fetches the connector type associated with a specific connection.' })\n  async connectorByConnection(\n    @Arg('connectionName') connectionName: string,\n    @Ctx() context: ResolverContext\n  ): Promise<ConnectorType> {\n    const { domain } = context.state\n\n    var connection = await getRepository(Connection).findOne({\n      where: { domain: { id: domain.id }, name: connectionName }\n    })\n\n    return connection && (ConnectionManager.getConnector(connection.type) as any)\n  }\n}\n"]}

package/dist-server/service/connector/connector-type.js

@@ -8,40 +8,43 @@ let ConnectorType = class ConnectorType {
 };
 exports.ConnectorType = ConnectorType;
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)(),
+    (0, type_graphql_1.Field)({ description: 'The unique name of the connector type.' }),
     tslib_1.__metadata("design:type", String)
 ], ConnectorType.prototype, "name", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'A brief description of the connector.' }),
     tslib_1.__metadata("design:type", String)
 ], ConnectorType.prototype, "description", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'A URL or text providing more detailed help information.' }),
     tslib_1.__metadata("design:type", String)
 ], ConnectorType.prototype, "help", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)(type => [property_spec_1.PropertySpec], { nullable: true }),
+    (0, type_graphql_1.Field)(type => [property_spec_1.PropertySpec], {
+        nullable: true,
+        description: 'A list of parameters required to configure this connector type.'
+    }),
     tslib_1.__metadata("design:type", Array)
 ], ConnectorType.prototype, "parameterSpec", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)(type => [String], { nullable: true }),
+    (0, type_graphql_1.Field)(type => [String], { nullable: true, description: 'A list of task prefixes that this connector can handle.' }),
     tslib_1.__metadata("design:type", Array)
 ], ConnectorType.prototype, "taskPrefixes", void 0);
 exports.ConnectorType = ConnectorType = tslib_1.__decorate([
-    (0, type_graphql_1.ObjectType)()
+    (0, type_graphql_1.ObjectType)({ description: 'Describes a type of connector, which handles communication for a specific protocol.' })
 ], ConnectorType);
 let ConnectorList = class ConnectorList {
 };
 exports.ConnectorList = ConnectorList;
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)(type => [ConnectorType]),
+    (0, type_graphql_1.Field)(type => [ConnectorType], { description: 'The list of connector type items.' }),
     tslib_1.__metadata("design:type", Array)
 ], ConnectorList.prototype, "items", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)(type => type_graphql_1.Int),
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'The total number of connector types.' }),
     tslib_1.__metadata("design:type", Number)
 ], ConnectorList.prototype, "total", void 0);
 exports.ConnectorList = ConnectorList = tslib_1.__decorate([
-    (0, type_graphql_1.ObjectType)()
+    (0, type_graphql_1.ObjectType)({ description: 'A paginated list of connector types.' })
 ], ConnectorList);
 //# sourceMappingURL=connector-type.js.map

package/dist-server/service/connector/connector-type.js.map

@@ -1 +1 @@
-{"version":3,"file":"connector-type.js","sourceRoot":"","sources":["../../../server/service/connector/connector-type.ts"],"names":[],"mappings":";;;;AAAA,+CAAqD;AACrD,oDAA+C;AAGxC,IAAM,aAAa,GAAnB,MAAM,aAAa;CAezB,CAAA;AAfY,sCAAa;AAExB;IADC,IAAA,oBAAK,GAAE;;2CACI;AAGZ;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;kDACP;AAGnB;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;2CACb;AAGb;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,CAAC,4BAAY,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;oDACrB;AAG7B;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;mDACrB;wBAdZ,aAAa;IADzB,IAAA,yBAAU,GAAE;GACA,aAAa,CAezB;AAGM,IAAM,aAAa,GAAnB,MAAM,aAAa;CAMzB,CAAA;AANY,sCAAa;AAExB;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC;;4CACT;AAGtB;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,kBAAG,CAAC;;4CACN;wBALF,aAAa;IADzB,IAAA,yBAAU,GAAE;GACA,aAAa,CAMzB","sourcesContent":["import { ObjectType, Field, Int } from 'type-graphql'\nimport { PropertySpec } from '../property-spec'\n\n@ObjectType()\nexport class ConnectorType {\n  @Field()\n  name: string\n\n  @Field({ nullable: true })\n  description: string\n\n  @Field({ nullable: true })\n  help?: string\n\n  @Field(type => [PropertySpec], { nullable: true })\n  parameterSpec: PropertySpec[]\n\n  @Field(type => [String], { nullable: true })\n  taskPrefixes?: string[]\n}\n\n@ObjectType()\nexport class ConnectorList {\n  @Field(type => [ConnectorType])\n  items: ConnectorType[]\n\n  @Field(type => Int)\n  total: number\n}\n"]}
+{"version":3,"file":"connector-type.js","sourceRoot":"","sources":["../../../server/service/connector/connector-type.ts"],"names":[],"mappings":";;;;AAAA,+CAAqD;AACrD,oDAA+C;AAGxC,IAAM,aAAa,GAAnB,MAAM,aAAa;CAkBzB,CAAA;AAlBY,sCAAa;AAExB;IADC,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,wCAAwC,EAAE,CAAC;;2CACrD;AAGZ;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,uCAAuC,EAAE,CAAC;;kDAC7D;AAGnB;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,yDAAyD,EAAE,CAAC;;2CACrF;AAMb;IAJC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,CAAC,4BAAY,CAAC,EAAE;QAC7B,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,iEAAiE;KAC/E,CAAC;;oDAC2B;AAG7B;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,yDAAyD,EAAE,CAAC;;mDAC7F;wBAjBZ,aAAa;IADzB,IAAA,yBAAU,EAAC,EAAE,WAAW,EAAE,qFAAqF,EAAE,CAAC;GACtG,aAAa,CAkBzB;AAGM,IAAM,aAAa,GAAnB,MAAM,aAAa;CAMzB,CAAA;AANY,sCAAa;AAExB;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,CAAC,aAAa,CAAC,EAAE,EAAE,WAAW,EAAE,mCAAmC,EAAE,CAAC;;4CAC/D;AAGtB;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,kBAAG,EAAE,EAAE,WAAW,EAAE,sCAAsC,EAAE,CAAC;;4CAC/D;wBALF,aAAa;IADzB,IAAA,yBAAU,EAAC,EAAE,WAAW,EAAE,sCAAsC,EAAE,CAAC;GACvD,aAAa,CAMzB","sourcesContent":["import { ObjectType, Field, Int } from 'type-graphql'\nimport { PropertySpec } from '../property-spec'\n\n@ObjectType({ description: 'Describes a type of connector, which handles communication for a specific protocol.' })\nexport class ConnectorType {\n  @Field({ description: 'The unique name of the connector type.' })\n  name: string\n\n  @Field({ nullable: true, description: 'A brief description of the connector.' })\n  description: string\n\n  @Field({ nullable: true, description: 'A URL or text providing more detailed help information.' })\n  help?: string\n\n  @Field(type => [PropertySpec], {\n    nullable: true,\n    description: 'A list of parameters required to configure this connector type.'\n  })\n  parameterSpec: PropertySpec[]\n\n  @Field(type => [String], { nullable: true, description: 'A list of task prefixes that this connector can handle.' })\n  taskPrefixes?: string[]\n}\n\n@ObjectType({ description: 'A paginated list of connector types.' })\nexport class ConnectorList {\n  @Field(type => [ConnectorType], { description: 'The list of connector type items.' })\n  items: ConnectorType[]\n\n  @Field(type => Int, { description: 'The total number of connector types.' })\n  total: number\n}\n"]}