@into-cps-association/libms 0.4.5 → 0.5.0

package/DEVELOPER.md

@@ -37,12 +37,54 @@ APOLLO_PATH='/lib'
 GRAPHQL_PLAYGROUND='true'
 ```
 
+Here is another with `git` mode.
+
+```ini
+PORT='4001'
+MODE='git'
+LOCAL_PATH ='/Users/<Username>/DTaaS/files'
+LOG_LEVEL='debug'
+APOLLO_PATH='/lib'
+GRAPHQL_PLAYGROUND='true'
+
+GIT_USER1_REPO_URL='<git repo url>'
+GIT_USER1_API_TOKEN='<TOKEN>'
+...
+GIT_USERX_REPO_URL='<git repo url>'
+GIT_USERX_API_TOKEN='<TOKEN>'
+```
+
+
 ## Service Endpoint
 
 The URL endpoint for this microservice is located at: `localhost:PORT/lib`
 
 The [API](./API.md) page shows sample queries and responses.
 
+## Manual testing
+
+As of now, some features require manual testing or attention.
+
+### CloudCMD (a npm package dependency)
+
+Due to how CloudCMD works,
+it is required to manually run `yarn test:http` with `LOCAL_PATH` both as an
+absolute path and local path. For example, the manual tests
+need to be done with the following `LOCAL_PATH` values.
+
+| OS      | Absolute Path                 | Relative Path |
+| ------- | ----------------------------- | ------------- |
+| Windows | C:\DTaaS\files                | ..\..\files  |
+| Linux   | /Users/\<Username\>/DTaaS/files | ../../files   |
+
+### PM2
+
+the pm2 might not close spawned processes correctly,
+therefore please use the following command to kill a process.
+`pm2 del <id>`.
+
+**NOTE:** to see the processes spawned by pm2 use `pm2 list`
+
 ## :package: :ship: Packages
 
 ### Docker images
@@ -86,6 +128,44 @@ with publishing **libms npm package** in local computer.
 Application of the advice given on that page for **libms** will require
 running the following commands.
 
+## Use in Docker Environment
+
+### Adjust Configuration (Optional)
+
+The microservices require configuration and the docker version
+of the microservices uses the configuration
+file available in `config/.env.default`.
+
+Please add a `.env` file with the environment variables for
+the docker compose file to use.
+e.g.
+
+```sh
+PORT='4001'
+MODE='local'
+LOCAL_PATH='..\..\files'
+```
+
+### Use
+
+The commands to start and stop the appliation are:
+
+**NOTE**: the docker compose file is located in the `servers/lib` directory.
+
+```bash
+docker compose -f compose.lib.dev.yml up -d
+```
+
+This command brings up the lib docker container and makes
+the website available at <http://localhost:4001>.
+The `config/.env.default` file is used as the microservice configuration.
+If the configuration values are changed, please restart the container.
+
+```bash
+docker compose -f compose.lib.dev.yml down
+docker compose -f compose.lib.dev.yml up -d
+```
+
 ### Publish
 
 ```bash

package/DOCKER.md

@@ -0,0 +1,295 @@
+# Overview
+
+The **libms microservice** is a simplified file manager providing graphQL API.
+It has two features:
+
+* provide a listing of directory contents.
+* transfer a file to user.
+
+## Use in Docker Environment
+
+### Create Docker Compose File
+
+Create an empty file named `compose.lib.yml` and copy
+the following into the file:
+
+```yml
+services:
+  libms:
+    image: intocps/libms:latest
+    restart: unless-stopped
+    volumes:
+      - ./files:/dtaas/libms/files
+    ports:
+      - "4001:4001"
+```
+
+### Create Files Directory
+
+The **libms microservice** serves files available from
+`files` directory.
+So, create a directory named `files` with the following structure:
+
+```text
+files/
+  data/
+  digital_twins/
+  functions/
+  models/
+  tools/
+  common/
+    data/
+    functions/
+    models/
+    tools/
+```
+
+Please create this `files` directory
+in the same file system location as that of the `compose.lib.yml` file.
+
+### Run
+
+Use the following commands to start and stop the container respectively:
+
+```bash
+docker compose -f compose.lib.yml up -d
+docker compose -f compose.lib.yml down
+```
+
+The lib microservice website will become available at <http://localhost:4001>.
+
+## Application Programming Interface (API)
+
+The lib microservice application provides services at
+two end points:
+
+### HTTP protocol
+
+**URL:** `localhost:4001/lib/files`
+
+The regular file upload and download options become available
+via web browser.
+
+### GraphQL protocol
+
+**URL:** `localhost:4001/lib`
+
+<details>
+<summary>GraphQL API details</summary>
+The lib microservice takes two distinct GraphQL queries.
+
+#### Directory Listing
+
+This query receives directory path and provides list of files
+in that directory. A sample query and response are given here.
+
+``` graphql
+query {
+  listDirectory(path: ".") {
+    repository {
+      tree {
+        blobs {
+          edges {
+            node {
+              name
+              type
+            }
+          }
+        }
+        trees {
+          edges {
+            node {
+              name
+              type
+            }
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+``` graphql
+{
+  "data": {
+    "listDirectory": {
+      "repository": {
+        "tree": {
+          "blobs": {
+            "edges": []
+          },
+          "trees": {
+            "edges": [
+              {
+                "node": {
+                  "name": "common",
+                  "type": "tree"
+                }
+              },
+              {
+                "node": {
+                  "name": "data",
+                  "type": "tree"
+                }
+              },
+              {
+                "node": {
+                  "name": "digital twins",
+                  "type": "tree"
+                }
+              },
+              {
+                "node": {
+                  "name": "functions",
+                  "type": "tree"
+                }
+              },
+              {
+                "node": {
+                  "name": "models",
+                  "type": "tree"
+                }
+              },
+              {
+                "node": {
+                  "name": "tools",
+                  "type": "tree"
+                }
+              }
+            ]
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+#### Fetch a File
+
+This query receives directory path and send the file contents to user in response.
+
+To check this query, create a file `files/data/welcome.txt`
+with content of `hello world`.
+
+A sample query and response are given here.
+
+```graphql
+query {
+  readFile(path: "data/welcome.txt") {
+    repository {
+      blobs {
+        nodes {
+          name
+          rawBlob
+          rawTextBlob
+        }
+      }
+    }
+  }
+}
+```
+
+```graphql
+{
+  "data": {
+    "readFile": {
+      "repository": {
+        "blobs": {
+          "nodes": [
+            {
+              "name": "welcome.txt",
+              "rawBlob": "hello world",
+              "rawTextBlob": "hello world"
+            }
+          ]
+        }
+      }
+    }
+  }
+}
+```
+
+### Direct HTTP API Calls in lieu of GraphQL API Calls
+
+The lib microservice also supports making API calls using HTTP POST requests.
+Simply send a POST request to the URL endpoint with the GraphQL query in
+the request body. Make sure to set the Content-Type header to
+"application/json".
+
+The easiest way to perform HTTP requests is to use
+[HTTPie](https://github.com/httpie/desktop/releases)
+desktop application.
+You can download the Ubuntu AppImage and run it. Select the following options:
+
+```txt
+Method: POST
+URL: localhost:4001
+Body: <<copy the json code from examples below>>
+Content Type: text/json
+```
+
+Here are examples of the HTTP requests and responses for the HTTP API calls.
+
+#### Directory listing
+
+<!-- markdownlint-disable MD013 -->
+
+```http
+POST /lib HTTP/1.1
+Host: localhost:4001
+Content-Type: application/json
+Content-Length: 388
+
+{
+   "query":"query {\n  listDirectory(path: \".\") {\n    repository {\n      tree {\n        blobs {\n          edges {\n            node {\n              name\n              type\n            }\n          }\n        }\n        trees {\n          edges {\n            node {\n              name\n              type\n            }\n          }\n        }\n      }\n    }\n  }\n}"
+}
+```
+
+This HTTP POST request will generate the following HTTP response message.
+
+```http
+HTTP/1.1 200 OK
+Access-Control-Allow-Origin: *
+Connection: close
+Content-Length: 306
+Content-Type: application/json; charset=utf-8
+Date: Tue, 26 Sep 2023 20:26:49 GMT
+X-Powered-By: Express
+
+{"data":{"listDirectory":{"repository":{"tree":{"blobs":{"edges":[]},"trees":{"edges":[{"node":{"name":"data","type":"tree"}},{"node":{"name":"digital twins","type":"tree"}},{"node":{"name":"functions","type":"tree"}},{"node":{"name":"models","type":"tree"}},{"node":{"name":"tools","type":"tree"}}]}}}}}}
+```
+
+#### Fetch a file
+
+This query receives directory path and send the file contents to user in response.
+
+To check this query, create a file `files/data/welcome.txt`
+with content of `hello world`.
+
+```http
+POST /lib HTTP/1.1
+Host: localhost:4001
+Content-Type: application/json
+Content-Length: 217
+
+{
+   "query":"query {\n  readFile(path: \"data/welcome.txt\") {\n    repository {\n      blobs {\n        nodes {\n          name\n          rawBlob\n          rawTextBlob\n        }\n      }\n    }\n  }\n}"
+}
+```
+
+```http
+HTTP/1.1 200 OK
+Access-Control-Allow-Origin: *
+Connection: close
+Content-Length: 134
+Content-Type: application/json; charset=utf-8
+Date: Wed, 27 Sep 2023 09:17:18 GMT
+X-Powered-By: Express
+
+{"data":{"readFile":{"repository":{"blobs":{"nodes":[{"name":"welcome.txt","rawBlob":"hello world","rawTextBlob":"hello world"}]}}}}}
+```
+
+<!-- markdownlint-enable MD013 -->
+</details>

package/README.md

@@ -52,6 +52,14 @@ LOCAL_PATH ='/Users/<Username>/DTaaS/files'
 LOG_LEVEL='debug'
 APOLLO_PATH='/lib' or ''
 GRAPHQL_PLAYGROUND='false' or 'true'
+
+#Only needed if git mode
+GIT_USER1_REPO_URL='<git repo url>'
+GIT_USER1_API_TOKEN='<TOKEN>'
+...
+GIT_USERX_REPO_URL='<git repo url>'
+GIT_USERX_API_TOKEN='<TOKEN>'
+
 ```
 
 The `LOCAL_PATH` variable is the absolute filepath to the

package/compose.lib.dev.yml

@@ -0,0 +1,9 @@
+services:
+  libms:
+    build:
+      context: ../../
+      dockerfile: ./docker/libms.dockerfile
+    volumes:
+      - ${LOCAL_PATH}:/dtaas/libms/files
+    ports:
+      - ${PORT}:4001

package/compose.lib.yml

@@ -0,0 +1,8 @@
+services:
+  libms:
+    image: intocps/libms:latest
+    restart: unless-stopped
+    volumes:
+      - ./files:/dtaas/libms/files
+    ports:
+      - "4001:4001"

package/dist/src/app.module.d.ts

@@ -1 +1,2 @@
-export default class AppModule {}
+export default class AppModule {
+}

package/dist/src/app.module.js

@@ -1,36 +1,34 @@
-"use strict";
 var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
     var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
     if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-Object.defineProperty(exports, "__esModule", { value: true });
-const config_1 = require("@nestjs/config");
-const common_1 = require("@nestjs/common");
-const graphql_1 = require("@nestjs/graphql");
-const apollo_1 = require("@nestjs/apollo");
-const path_1 = require("path");
-const files_module_1 = require("./files/files.module");
+import { ConfigModule, ConfigService } from '@nestjs/config';
+import { Module } from '@nestjs/common';
+import { GraphQLModule } from '@nestjs/graphql';
+import { ApolloDriver } from '@nestjs/apollo';
+import { join } from 'path';
+import FilesModule from './files/files.module.js';
 let AppModule = class AppModule {
 };
 AppModule = __decorate([
-    (0, common_1.Module)({
+    Module({
         imports: [
-            config_1.ConfigModule.forRoot({
+            ConfigModule.forRoot({
                 isGlobal: true,
             }),
-            graphql_1.GraphQLModule.forRootAsync({
-                driver: apollo_1.ApolloDriver,
+            GraphQLModule.forRootAsync({
+                driver: ApolloDriver,
                 useFactory: (configService) => ({
-                    autoSchemaFile: (0, path_1.join)(process.cwd(), 'src/schema.gql'),
+                    autoSchemaFile: join(process.cwd(), 'src/schema.gql'),
                     path: configService.get('APOLLO_PATH'),
                 }),
-                inject: [config_1.ConfigService],
+                inject: [ConfigService],
             }),
-            files_module_1.default,
+            FilesModule,
         ],
     })
 ], AppModule);
-exports.default = AppModule;
+export default AppModule;
 //# sourceMappingURL=app.module.js.map

package/dist/src/app.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"app.module.js","sourceRoot":"","sources":["../../src/app.module.ts"],"names":[],"mappings":";;;;;;;;AAAA,2CAA6D;AAC7D,2CAAwC;AACxC,6CAAgD;AAChD,2CAA8C;AAC9C,+BAA4B;AAC5B,uDAA+C;AAkBhC,IAAM,SAAS,GAAf,MAAM,SAAS;CAAG,CAAA;AAAZ,SAAS;IAhB7B,IAAA,eAAM,EAAC;QACN,OAAO,EAAE;YACP,qBAAY,CAAC,OAAO,CAAC;gBACnB,QAAQ,EAAE,IAAI;aACf,CAAC;YACF,uBAAa,CAAC,YAAY,CAAC;gBACzB,MAAM,EAAE,qBAAY;gBACpB,UAAU,EAAE,CAAC,aAA4B,EAAE,EAAE,CAAC,CAAC;oBAC7C,cAAc,EAAE,IAAA,WAAI,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,gBAAgB,CAAC;oBACrD,IAAI,EAAE,aAAa,CAAC,GAAG,CAAS,aAAa,CAAC;iBAC/C,CAAC;gBACF,MAAM,EAAE,CAAC,sBAAa,CAAC;aACxB,CAAC;YACF,sBAAW;SACZ;KACF,CAAC;GACmB,SAAS,CAAG;kBAAZ,SAAS"}
+{"version":3,"file":"app.module.js","sourceRoot":"","sources":["../../src/app.module.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,WAAW,MAAM,yBAAyB,CAAC;AAkBnC,IAAM,SAAS,GAAf,MAAM,SAAS;CAAG,CAAA;AAAZ,SAAS;IAhB7B,MAAM,CAAC;QACN,OAAO,EAAE;YACP,YAAY,CAAC,OAAO,CAAC;gBACnB,QAAQ,EAAE,IAAI;aACf,CAAC;YACF,aAAa,CAAC,YAAY,CAAC;gBACzB,MAAM,EAAE,YAAY;gBACpB,UAAU,EAAE,CAAC,aAA4B,EAAE,EAAE,CAAC,CAAC;oBAC7C,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,gBAAgB,CAAC;oBACrD,IAAI,EAAE,aAAa,CAAC,GAAG,CAAS,aAAa,CAAC;iBAC/C,CAAC;gBACF,MAAM,EAAE,CAAC,aAAa,CAAC;aACxB,CAAC;YACF,WAAW;SACZ;KACF,CAAC;GACmB,SAAS,CAAG;eAAZ,SAAS"}

package/dist/src/bootstrap.d.ts

@@ -1,7 +1,7 @@
 type BootstrapOptions = {
-  config?: string;
-  httpServer?: string;
-  runHelp?: CallableFunction;
+    config?: string;
+    httpServer?: string;
+    runHelp?: CallableFunction;
 };
 export default function bootstrap(options?: BootstrapOptions): Promise<void>;
 export {};

package/dist/src/bootstrap.js

@@ -1,16 +1,14 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const core_1 = require("@nestjs/core");
-const config_1 = require("@nestjs/config");
-const dotenv = require("dotenv");
-const app_module_1 = require("./app.module");
-const cloudcmd_1 = require("./cloudcmd/cloudcmd");
-async function bootstrap(options) {
+import { NestFactory } from '@nestjs/core';
+import { ConfigService } from '@nestjs/config';
+import * as dotenv from 'dotenv';
+import AppModule from './app.module.js';
+import cloudCMD from './cloudcmd/cloudcmd.js';
+export default async function bootstrap(options) {
     const configFile = dotenv.config({
         path: options?.config ?? '.env',
         override: true,
     });
-    if (configFile.error) {
+    if (configFile.error && process.env.LOCAL_PATH === undefined) {
         console.error(configFile.error);
         if (options.runHelp) {
             options.runHelp();
@@ -19,13 +17,15 @@ async function bootstrap(options) {
             process.exit(1);
         }
     }
-    const app = await core_1.NestFactory.create(app_module_1.default);
-    const configService = app.get(config_1.ConfigService);
+    const app = await NestFactory.create(AppModule);
+    const configService = app.get(ConfigService);
     const port = configService.get('PORT');
+    const localPath = configService.get('LOCAL_PATH');
+    const mode = configService.get('MODE');
+    console.log(`\x1b[32mStarting libms in \x1b[33m${mode} \x1b[32mmode, serving files from \x1b[34m${localPath} \x1b[32mon port \x1b[35m${port}\x1b[0m`);
     if (options.httpServer) {
-        (0, cloudcmd_1.default)(app, options.httpServer, configService.get('LOCAL_PATH'));
+        cloudCMD(app, options.httpServer, configService.get('LOCAL_PATH'));
     }
     await app.listen(port);
 }
-exports.default = bootstrap;
 //# sourceMappingURL=bootstrap.js.map

package/dist/src/bootstrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../src/bootstrap.ts"],"names":[],"mappings":";;AAAA,uCAA2C;AAC3C,2CAA+C;AAC/C,iCAAiC;AACjC,6CAAqC;AACrC,kDAA2C;AAQ5B,KAAK,UAAU,SAAS,CAAC,OAA0B;IAChE,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC;QAC/B,IAAI,EAAE,OAAO,EAAE,MAAM,IAAI,MAAM;QAC/B,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;IACH,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;QAErB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,kBAAW,CAAC,MAAM,CAAC,oBAAS,CAAC,CAAC;IAChD,MAAM,aAAa,GAAG,GAAG,CAAC,GAAG,CAAC,sBAAa,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAS,MAAM,CAAC,CAAC;IAE/C,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,IAAA,kBAAQ,EAAC,GAAG,EAAE,OAAO,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,CAAS,YAAY,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAxBD,4BAwBC"}
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../src/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,SAAS,MAAM,iBAAiB,CAAC;AACxC,OAAO,QAAQ,MAAM,wBAAwB,CAAC;AAQ9C,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,SAAS,CAAC,OAA0B;IAChE,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC;QAC/B,IAAI,EAAE,OAAO,EAAE,MAAM,IAAI,MAAM;QAC/B,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;IACH,IAAI,UAAU,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QAE7D,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAChD,MAAM,aAAa,GAAG,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAS,MAAM,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,CAAS,YAAY,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAS,MAAM,CAAC,CAAC;IAE/C,OAAO,CAAC,GAAG,CAAC,qCAAqC,IAAI,6CAA6C,SAAS,4BAA4B,IAAI,SAAS,CAAC,CAAC;IAEtJ,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,CAAS,YAAY,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC"}

package/dist/src/cloudcmd/cloudcmd.d.ts

@@ -1,7 +1,3 @@
 import { INestApplication } from '@nestjs/common';
-declare const runCloudCMD: (
-  app: INestApplication,
-  optionsPath: string,
-  filesPath: string,
-) => void;
+declare const runCloudCMD: (app: INestApplication, optionsPath: string, filesPath: string) => void;
 export default runCloudCMD;

package/dist/src/cloudcmd/cloudcmd.js

@@ -1,16 +1,22 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const socket_io_1 = require("socket.io");
-const cloudcmd = require("cloudcmd");
-const path_1 = require("path");
+import { Server } from 'socket.io';
+import cloudcmd from 'cloudcmd';
+import { join, relative } from 'path';
+const isWindowsAbsolutePath = (filesPath) => filesPath.includes(':');
 const runCloudCMD = (app, optionsPath, filesPath) => {
     const { createConfigManager } = cloudcmd;
     const configManager = createConfigManager({
-        configPath: (0, path_1.join)(process.cwd(), optionsPath),
+        configPath: join(process.cwd(), optionsPath),
     });
-    configManager('root', filesPath);
+    if (isWindowsAbsolutePath(filesPath)) {
+        const workDir = process.cwd();
+        const relativePath = relative(workDir, filesPath);
+        configManager('root', relativePath);
+    }
+    else {
+        configManager('root', filesPath);
+    }
     const server = app.getHttpServer();
-    const socket = new socket_io_1.Server(server, {
+    const socket = new Server(server, {
         path: `${configManager('prefix')}/socket.io`,
     });
     app.use(configManager('prefix'), cloudcmd({
@@ -18,5 +24,5 @@ const runCloudCMD = (app, optionsPath, filesPath) => {
         socket,
     }));
 };
-exports.default = runCloudCMD;
+export default runCloudCMD;
 //# sourceMappingURL=cloudcmd.js.map

package/dist/src/cloudcmd/cloudcmd.js.map

@@ -1 +1 @@
-{"version":3,"file":"cloudcmd.js","sourceRoot":"","sources":["../../../src/cloudcmd/cloudcmd.ts"],"names":[],"mappings":";;AACA,yCAAmC;AACnC,qCAAqC;AACrC,+BAA4B;AAE5B,MAAM,WAAW,GAAG,CAClB,GAAqB,EACrB,WAAmB,EACnB,SAAiB,EACjB,EAAE;IACF,MAAM,EAAE,mBAAmB,EAAE,GAAG,QAAQ,CAAC;IACzC,MAAM,aAAa,GAAG,mBAAmB,CAAC;QACxC,UAAU,EAAE,IAAA,WAAI,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,CAAC;KAC7C,CAAC,CAAC;IAEH,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAEjC,MAAM,MAAM,GAAG,GAAG,CAAC,aAAa,EAAE,CAAC;IAEnC,MAAM,MAAM,GAAG,IAAI,kBAAM,CAAC,MAAM,EAAE;QAChC,IAAI,EAAE,GAAG,aAAa,CAAC,QAAQ,CAAC,YAAY;KAC7C,CAAC,CAAC;IACH,GAAG,CAAC,GAAG,CACL,aAAa,CAAC,QAAQ,CAAC,EACvB,QAAQ,CAAC;QACP,aAAa;QACb,MAAM;KACP,CAAC,CACH,CAAC;AACJ,CAAC,CAAC;AAEF,kBAAe,WAAW,CAAC"}
+{"version":3,"file":"cloudcmd.js","sourceRoot":"","sources":["../../../src/cloudcmd/cloudcmd.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAEtC,MAAM,qBAAqB,GAAG,CAAC,SAAiB,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AAE7E,MAAM,WAAW,GAAG,CAClB,GAAqB,EACrB,WAAmB,EACnB,SAAiB,EACjB,EAAE;IACF,MAAM,EAAE,mBAAmB,EAAE,GAAG,QAAQ,CAAC;IACzC,MAAM,aAAa,GAAG,mBAAmB,CAAC;QACxC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,CAAC;KAC7C,CAAC,CAAC;IAEH,IAAI,qBAAqB,CAAC,SAAS,CAAC,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC9B,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAClD,aAAa,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACtC,CAAC;SAAM,CAAC;QACN,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,CAAC,aAAa,EAAE,CAAC;IAEnC,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE;QAChC,IAAI,EAAE,GAAG,aAAa,CAAC,QAAQ,CAAC,YAAY;KAC7C,CAAC,CAAC;IACH,GAAG,CAAC,GAAG,CACL,aAAa,CAAC,QAAQ,CAAC,EACvB,QAAQ,CAAC;QACP,aAAa;QACb,MAAM;KACP,CAAC,CACH,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,WAAW,CAAC"}

package/dist/src/enums/config-mode.enum.d.ts

@@ -0,0 +1,4 @@
+export declare enum CONFIG_MODE {
+    GIT = "git",
+    LOCAL = "local"
+}

package/dist/src/enums/config-mode.enum.js

@@ -0,0 +1,6 @@
+export var CONFIG_MODE;
+(function (CONFIG_MODE) {
+    CONFIG_MODE["GIT"] = "git";
+    CONFIG_MODE["LOCAL"] = "local";
+})(CONFIG_MODE || (CONFIG_MODE = {}));
+//# sourceMappingURL=config-mode.enum.js.map

package/dist/src/enums/config-mode.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-mode.enum.js","sourceRoot":"","sources":["../../../src/enums/config-mode.enum.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,WAGX;AAHD,WAAY,WAAW;IACrB,0BAAW,CAAA;IACX,8BAAe,CAAA;AACjB,CAAC,EAHW,WAAW,KAAX,WAAW,QAGtB"}

package/dist/src/files/files-service.factory.d.ts

@@ -0,0 +1,5 @@
+import { ConfigService } from '@nestjs/config';
+import { IFilesService } from './interfaces/files.service.interface.js';
+export default class FilesServiceFactory {
+    static create(configService: ConfigService, fileServices: IFilesService[]): IFilesService;
+}

package/dist/src/files/files-service.factory.js

@@ -0,0 +1,22 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { Injectable } from '@nestjs/common';
+let FilesServiceFactory = class FilesServiceFactory {
+    static create(configService, fileServices) {
+        const mode = configService.get('MODE');
+        const service = fileServices.find((s) => s.getMode() == mode);
+        if (service == undefined) {
+            throw new Error(`Invalid MODE: ${mode}`);
+        }
+        return service;
+    }
+};
+FilesServiceFactory = __decorate([
+    Injectable()
+], FilesServiceFactory);
+export default FilesServiceFactory;
+//# sourceMappingURL=files-service.factory.js.map

package/dist/src/files/files-service.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files-service.factory.js","sourceRoot":"","sources":["../../../src/files/files-service.factory.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAK7B,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IACtC,MAAM,CAAC,MAAM,CACX,aAA4B,EAC5B,YAA6B;QAE7B,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAS,MAAM,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,CAAC;QAE9D,IAAI,OAAO,IAAI,SAAS,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF,CAAA;AAboB,mBAAmB;IADvC,UAAU,EAAE;GACQ,mBAAmB,CAavC;eAboB,mBAAmB"}

package/dist/src/files/files.module.d.ts

@@ -1 +1,2 @@
-export default class FilesModule {}
+export default class FilesModule {
+}