@toa.io/bridges.bash 0.24.0-alpha.22

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@toa.io/bridges.bash",
+  "version": "0.24.0-alpha.22",
+  "description": "Toa Bash Bridge",
+  "author": "temich <tema.gurtovoy@gmail.com>",
+  "homepage": "https://github.com/toa-io/toa#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/toa-io/toa.git"
+  },
+  "bugs": {
+    "url": "https://github.com/toa-io/toa/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "transpiled/index.js",
+  "types": "transpiled/index.d.ts",
+  "scripts": {
+    "transpile": "tsc"
+  },
+  "jest": {
+    "preset": "ts-jest",
+    "testEnvironment": "node"
+  }
+}

package/readme.md

@@ -0,0 +1,16 @@
+# Bash bridge
+
+Allows implementing operations in Bash.
+
+Input must be an object which properties will be passed to the script as named arguments with values
+converted to strings.
+Output is a string being the standard output of the script.
+
+If the script exits with a non-zero status code,
+the operation will return an `Error` with the message being the standard error output of the script.
+
+Operations cannot have access to the state or context. Basically,
+only [computations](/documentation/design.md#special-types) are possible.
+
+> While theoretically this bridge may find some use, it is mainly a demonstration of language
+> interoperability.

package/source/Algorithm.ts

@@ -0,0 +1,34 @@
+import util from 'node:util'
+import process from 'node:child_process'
+import { Connector } from '@toa.io/core'
+import type { bridges, Reply } from '@toa.io/core'
+
+const exec = util.promisify(process.exec)
+
+export class Algorithm extends Connector implements bridges.Algorithm {
+  private readonly path: string
+
+  public constructor (path: string) {
+    super()
+    this.path = path
+  }
+
+  public async mount (): Promise<void> {
+
+  }
+
+  public async execute (input: object): Promise<Reply> {
+    const args = Object.entries(input).map(([key, value]) => `--${key} ${value}`).join(' ')
+    const command = `${this.path}${args === '' ? '' : ` ${args}`}`
+
+    try {
+      const result = await exec(command)
+
+      return { output: result.stdout.trim() }
+    } catch (error: any) {
+      const message: string | undefined = error.stderr?.trim()
+
+      return { output: new Error(message) }
+    }
+  }
+}

package/source/Factory.ts

@@ -0,0 +1,12 @@
+import { join } from 'node:path'
+import { Algorithm } from './Algorithm'
+import { DIR, EXT } from './const'
+import type { bridges } from '@toa.io/core'
+
+export class Factory implements bridges.Factory {
+  public algorithm (root: string, name: string): bridges.Algorithm {
+    const path = join(root, DIR, name + EXT)
+
+    return new Algorithm(path)
+  }
+}

package/source/const.ts

@@ -0,0 +1,2 @@
+export const DIR = 'operations'
+export const EXT = '.sh'

package/source/define.ts

@@ -0,0 +1,36 @@
+import * as fs from 'node:fs/promises'
+import { join, extname } from 'node:path'
+import { DIR, EXT } from './const'
+import type { component } from '@toa.io/norm'
+
+export async function operations (root: string): Promise<component.Operations> {
+  const path = join(root, DIR)
+  const names = await list(path)
+
+  const promises = names
+    .map(async (name) => operation(root, name))
+
+  const operations = await Promise.all(promises)
+
+  return operations.reduce<component.Operations>((acc, operation, index) => {
+    acc[names[index]] = operation
+
+    return acc
+  }, {})
+}
+
+export async function operation (root: string, name: string): Promise<component.Operation> {
+  const path = join(root, DIR, name + EXT)
+
+  await fs.access(path, fs.constants.F_OK)
+
+  return { type: 'computation' }
+}
+
+async function list (path: string): Promise<string[]> {
+  const files = await fs.readdir(path)
+
+  return files
+    .filter((file) => extname(file) === EXT)
+    .map((file) => file.slice(0, -EXT.length))
+}

package/source/index.ts

@@ -0,0 +1,2 @@
+export { Factory } from './Factory'
+export * as define from './define'

package/transpiled/Algorithm.d.ts

@@ -0,0 +1,8 @@
+import { Connector } from '@toa.io/core';
+import type { bridges, Reply } from '@toa.io/core';
+export declare class Algorithm extends Connector implements bridges.Algorithm {
+    private readonly path;
+    constructor(path: string);
+    mount(): Promise<void>;
+    execute(input: object): Promise<Reply>;
+}

package/transpiled/Algorithm.js

@@ -0,0 +1,33 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Algorithm = void 0;
+const node_util_1 = __importDefault(require("node:util"));
+const node_child_process_1 = __importDefault(require("node:child_process"));
+const core_1 = require("@toa.io/core");
+const exec = node_util_1.default.promisify(node_child_process_1.default.exec);
+class Algorithm extends core_1.Connector {
+    path;
+    constructor(path) {
+        super();
+        this.path = path;
+    }
+    async mount() {
+    }
+    async execute(input) {
+        const args = Object.entries(input).map(([key, value]) => `--${key} ${value}`).join(' ');
+        const command = `${this.path}${args === '' ? '' : ` ${args}`}`;
+        try {
+            const result = await exec(command);
+            return { output: result.stdout.trim() };
+        }
+        catch (error) {
+            const message = error.stderr?.trim();
+            return { output: new Error(message) };
+        }
+    }
+}
+exports.Algorithm = Algorithm;
+//# sourceMappingURL=Algorithm.js.map

package/transpiled/Algorithm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Algorithm.js","sourceRoot":"","sources":["../source/Algorithm.ts"],"names":[],"mappings":";;;;;;AAAA,0DAA4B;AAC5B,4EAAwC;AACxC,uCAAwC;AAGxC,MAAM,IAAI,GAAG,mBAAI,CAAC,SAAS,CAAC,4BAAO,CAAC,IAAI,CAAC,CAAA;AAEzC,MAAa,SAAU,SAAQ,gBAAS;IACrB,IAAI,CAAQ;IAE7B,YAAoB,IAAY;QAC9B,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAEM,KAAK,CAAC,KAAK;IAElB,CAAC;IAEM,KAAK,CAAC,OAAO,CAAE,KAAa;QACjC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACvF,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,EAAE,CAAA;QAE9D,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAA;YAElC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAA;QACzC,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,OAAO,GAAuB,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,CAAA;YAExD,OAAO,EAAE,MAAM,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAA;QACvC,CAAC;IACH,CAAC;CACF;AA1BD,8BA0BC"}

package/transpiled/Factory.d.ts

@@ -0,0 +1,4 @@
+import type { bridges } from '@toa.io/core';
+export declare class Factory implements bridges.Factory {
+    algorithm(root: string, name: string): bridges.Algorithm;
+}

package/transpiled/Factory.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Factory = void 0;
+const node_path_1 = require("node:path");
+const Algorithm_1 = require("./Algorithm");
+const const_1 = require("./const");
+class Factory {
+    algorithm(root, name) {
+        const path = (0, node_path_1.join)(root, const_1.DIR, name + const_1.EXT);
+        return new Algorithm_1.Algorithm(path);
+    }
+}
+exports.Factory = Factory;
+//# sourceMappingURL=Factory.js.map

package/transpiled/Factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Factory.js","sourceRoot":"","sources":["../source/Factory.ts"],"names":[],"mappings":";;;AAAA,yCAAgC;AAChC,2CAAuC;AACvC,mCAAkC;AAGlC,MAAa,OAAO;IACX,SAAS,CAAE,IAAY,EAAE,IAAY;QAC1C,MAAM,IAAI,GAAG,IAAA,gBAAI,EAAC,IAAI,EAAE,WAAG,EAAE,IAAI,GAAG,WAAG,CAAC,CAAA;QAExC,OAAO,IAAI,qBAAS,CAAC,IAAI,CAAC,CAAA;IAC5B,CAAC;CACF;AAND,0BAMC"}

package/transpiled/const.d.ts

@@ -0,0 +1,2 @@
+export declare const DIR = "operations";
+export declare const EXT = ".sh";

package/transpiled/const.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXT = exports.DIR = void 0;
+exports.DIR = 'operations';
+exports.EXT = '.sh';
+//# sourceMappingURL=const.js.map

package/transpiled/const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"const.js","sourceRoot":"","sources":["../source/const.ts"],"names":[],"mappings":";;;AAAa,QAAA,GAAG,GAAG,YAAY,CAAA;AAClB,QAAA,GAAG,GAAG,KAAK,CAAA"}

package/transpiled/define.d.ts

@@ -0,0 +1,3 @@
+import type { component } from '@toa.io/norm';
+export declare function operations(root: string): Promise<component.Operations>;
+export declare function operation(root: string, name: string): Promise<component.Operation>;

package/transpiled/define.js

@@ -0,0 +1,54 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.operation = exports.operations = void 0;
+const fs = __importStar(require("node:fs/promises"));
+const node_path_1 = require("node:path");
+const const_1 = require("./const");
+async function operations(root) {
+    const path = (0, node_path_1.join)(root, const_1.DIR);
+    const names = await list(path);
+    const promises = names
+        .map(async (name) => operation(root, name));
+    const operations = await Promise.all(promises);
+    return operations.reduce((acc, operation, index) => {
+        acc[names[index]] = operation;
+        return acc;
+    }, {});
+}
+exports.operations = operations;
+async function operation(root, name) {
+    const path = (0, node_path_1.join)(root, const_1.DIR, name + const_1.EXT);
+    await fs.access(path, fs.constants.F_OK);
+    return { type: 'computation' };
+}
+exports.operation = operation;
+async function list(path) {
+    const files = await fs.readdir(path);
+    return files
+        .filter((file) => (0, node_path_1.extname)(file) === const_1.EXT)
+        .map((file) => file.slice(0, -const_1.EXT.length));
+}
+//# sourceMappingURL=define.js.map

package/transpiled/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../source/define.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,qDAAsC;AACtC,yCAAyC;AACzC,mCAAkC;AAG3B,KAAK,UAAU,UAAU,CAAE,IAAY;IAC5C,MAAM,IAAI,GAAG,IAAA,gBAAI,EAAC,IAAI,EAAE,WAAG,CAAC,CAAA;IAC5B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAA;IAE9B,MAAM,QAAQ,GAAG,KAAK;SACnB,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA;IAE7C,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IAE9C,OAAO,UAAU,CAAC,MAAM,CAAuB,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE;QACvE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,SAAS,CAAA;QAE7B,OAAO,GAAG,CAAA;IACZ,CAAC,EAAE,EAAE,CAAC,CAAA;AACR,CAAC;AAdD,gCAcC;AAEM,KAAK,UAAU,SAAS,CAAE,IAAY,EAAE,IAAY;IACzD,MAAM,IAAI,GAAG,IAAA,gBAAI,EAAC,IAAI,EAAE,WAAG,EAAE,IAAI,GAAG,WAAG,CAAC,CAAA;IAExC,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;IAExC,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,CAAA;AAChC,CAAC;AAND,8BAMC;AAED,KAAK,UAAU,IAAI,CAAE,IAAY;IAC/B,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAEpC,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,mBAAO,EAAC,IAAI,CAAC,KAAK,WAAG,CAAC;SACvC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,WAAG,CAAC,MAAM,CAAC,CAAC,CAAA;AAC9C,CAAC"}

package/transpiled/index.d.ts

@@ -0,0 +1,2 @@
+export { Factory } from './Factory';
+export * as define from './define';

package/transpiled/index.js

@@ -0,0 +1,30 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.define = exports.Factory = void 0;
+var Factory_1 = require("./Factory");
+Object.defineProperty(exports, "Factory", { enumerable: true, get: function () { return Factory_1.Factory; } });
+exports.define = __importStar(require("./define"));
+//# sourceMappingURL=index.js.map

package/transpiled/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../source/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,qCAAmC;AAA1B,kGAAA,OAAO,OAAA;AAChB,mDAAkC"}

package/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./transpiled"
+  },
+  "include": [
+    "source"
+  ],
+  "exclude": [
+    "**/*.test.ts"
+  ]
+}