@extrahorizon/exh-cli 1.5.0

package/build/commands/templates/util/readTemplateFiles.d.ts

@@ -0,0 +1,3 @@
+export declare function readTemplateFiles(targetFolder: string): Promise<{}>;
+export declare function readTemplateJson(fileName: string): Promise<any>;
+export declare function readTemplateFolder(subFolder: string): Promise<any>;

package/build/commands/templates/util/readTemplateFiles.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readTemplateFolder = exports.readTemplateJson = exports.readTemplateFiles = void 0;
+const fs = require("fs/promises");
+const path = require("path");
+const utils_1 = require("./utils");
+async function readTemplateFiles(targetFolder) {
+    const fileNames = await (0, utils_1.listFolderContent)(targetFolder);
+    const templateFilesByName = {};
+    for (const fileName of fileNames) {
+        const filePath = path.join(targetFolder, fileName);
+        if ((await fs.stat(filePath)).isDirectory()) {
+            templateFilesByName[fileName] = await readTemplateFolder(filePath);
+        }
+        else if (fileName.endsWith('.json')) {
+            const templateName = (0, utils_1.removeFileNameExtension)(fileName);
+            templateFilesByName[templateName] = await readTemplateJson(filePath);
+        }
+    }
+    return templateFilesByName;
+}
+exports.readTemplateFiles = readTemplateFiles;
+async function readTemplateJson(fileName) {
+    return (0, utils_1.readJsonFile)(fileName);
+}
+exports.readTemplateJson = readTemplateJson;
+async function readTemplateFolder(subFolder) {
+    const templateFile = await readTemplateJson(path.join(subFolder, 'template.json'));
+    const templateFields = await readTemplateFolderFieldFiles(subFolder);
+    if (!templateFile.fields) {
+        templateFile.fields = templateFields;
+    }
+    else {
+        templateFile.fields = {
+            ...templateFile.fields,
+            ...templateFields,
+        };
+    }
+    return templateFile;
+}
+exports.readTemplateFolder = readTemplateFolder;
+async function readTemplateFolderFieldFiles(subFolder) {
+    const templateFields = {};
+    const folderFileNames = await (0, utils_1.listFolderContent)(subFolder);
+    const fieldFileNames = folderFileNames.filter((fileName) => fileName !== 'template.json');
+    for (const fieldFileName of fieldFileNames) {
+        const fieldName = (0, utils_1.removeFileNameExtension)(fieldFileName);
+        const fieldContent = await (0, utils_1.readTextFile)(path.join(subFolder, fieldFileName));
+        templateFields[fieldName] = fieldContent;
+    }
+    return templateFields;
+}

package/build/commands/templates/util/templateService.d.ts

@@ -0,0 +1,8 @@
+import { OAuth1Client } from '@extrahorizon/javascript-sdk';
+export declare class TemplateService {
+    private sdk;
+    constructor(sdk: OAuth1Client);
+    byName(name: string): Promise<import("@extrahorizon/javascript-sdk").TemplateOut>;
+    update(name: string, data: any): Promise<import("@extrahorizon/javascript-sdk").TemplateOut>;
+    create(data: any): Promise<import("@extrahorizon/javascript-sdk").TemplateOut>;
+}

package/build/commands/templates/util/templateService.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TemplateService = void 0;
+class TemplateService {
+    constructor(sdk) {
+        this.sdk = sdk;
+    }
+    async byName(name) {
+        return this.sdk.templates.findByName(name);
+    }
+    async update(name, data) {
+        return this.sdk.templates.update(name, data);
+    }
+    async create(data) {
+        return this.sdk.templates.create(data);
+    }
+}
+exports.TemplateService = TemplateService;

package/build/commands/templates/util/uploadTemplate.d.ts

@@ -0,0 +1,2 @@
+import { TemplateService } from './templateService';
+export declare function uploadTemplate(service: TemplateService, template: any): Promise<void>;

package/build/commands/templates/util/uploadTemplate.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uploadTemplate = void 0;
+async function uploadTemplate(service, template) {
+    const existingTemplate = await service.byName(template.name);
+    try {
+        if (!existingTemplate) {
+            console.log(`Creating new template '${template.name}'`);
+            await service.create(template);
+        }
+        else {
+            console.log(`Updating existing template '${template.name}'`);
+            await service.update(existingTemplate.id, template);
+        }
+    }
+    catch (err) {
+        throw new Error(`Error creating or updating template: ${JSON.stringify(err.response)}`);
+    }
+}
+exports.uploadTemplate = uploadTemplate;

package/build/commands/templates/util/utils.d.ts

@@ -0,0 +1,4 @@
+export declare function listFolderContent(path: string): Promise<string[]>;
+export declare function readJsonFile(path: string): Promise<any>;
+export declare function readTextFile(path: string): Promise<string>;
+export declare function removeFileNameExtension(fileName: string): string;

package/build/commands/templates/util/utils.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeFileNameExtension = exports.readTextFile = exports.readJsonFile = exports.listFolderContent = void 0;
+const promises_1 = require("fs/promises");
+async function listFolderContent(path) {
+    return await (0, promises_1.readdir)(path);
+}
+exports.listFolderContent = listFolderContent;
+async function readJsonFile(path) {
+    const file = await readTextFile(path);
+    return JSON.parse(file);
+}
+exports.readJsonFile = readJsonFile;
+async function readTextFile(path) {
+    const fileBuffer = await (0, promises_1.readFile)(path);
+    return fileBuffer.toString();
+}
+exports.readTextFile = readTextFile;
+function removeFileNameExtension(fileName) {
+    return fileName.split('.')[0];
+}
+exports.removeFileNameExtension = removeFileNameExtension;

package/build/commands/templates.d.ts

@@ -0,0 +1,5 @@
+/// <reference types="yargs" />
+export declare const command = "templates <command>";
+export declare const desc = "Manage templates";
+export declare const builder: (yargs: any) => import("yargs").Argv<{}>;
+export declare const handler: () => void;

package/build/commands/templates.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handler = exports.builder = exports.desc = exports.command = void 0;
+const util_1 = require("../helpers/util");
+exports.command = 'templates <command>';
+exports.desc = 'Manage templates';
+const builder = (yargs) => (0, util_1.epilogue)(yargs).commandDir('templates');
+exports.builder = builder;
+const handler = () => { };
+exports.handler = handler;

package/build/constants.d.ts

@@ -0,0 +1,13 @@
+export declare const EXH_CONFIG_FILE_DIR: string;
+export declare const EXH_CONFIG_FILE: string;
+export declare const runtimeChoices: string[];
+export declare const limits: {
+    time: {
+        min: number;
+        max: number;
+    };
+    memory: {
+        min: number;
+        max: number;
+    };
+};

package/build/constants.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.limits = exports.runtimeChoices = exports.EXH_CONFIG_FILE = exports.EXH_CONFIG_FILE_DIR = void 0;
+const os_1 = require("os");
+const path = require("path");
+exports.EXH_CONFIG_FILE_DIR = path.join((0, os_1.homedir)(), '/.exh');
+exports.EXH_CONFIG_FILE = `${exports.EXH_CONFIG_FILE_DIR}/credentials`;
+exports.runtimeChoices = [
+    'nodejs16.x',
+    'nodejs18.x',
+    'nodejs20.x',
+    'python3.8',
+    'python3.9',
+    'python3.10',
+    'python3.11',
+    'python3.12',
+    'java8.al2',
+    'java11',
+    'java17',
+    'java21',
+    'dotnet6',
+    'dotnet7',
+    'dotnet8',
+    'ruby3.2',
+    'provided.al2',
+    'provided.al2023',
+];
+exports.limits = {
+    time: {
+        min: 3,
+        max: 900,
+    },
+    memory: {
+        min: 128,
+        max: 10240,
+    },
+};

package/build/exh.d.ts

@@ -0,0 +1,3 @@
+import { OAuth1Client } from '@extrahorizon/javascript-sdk';
+export declare function sdkInitOnly(apiHost: string, consumerKey: string, consumerSecret: string): OAuth1Client;
+export declare function sdkAuth(): Promise<OAuth1Client>;

package/build/exh.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sdkAuth = exports.sdkInitOnly = void 0;
+const fs = require("fs");
+const javascript_sdk_1 = require("@extrahorizon/javascript-sdk");
+const constants_1 = require("./constants");
+let sdk = null;
+function sdkInitOnly(apiHost, consumerKey, consumerSecret) {
+    sdk = (0, javascript_sdk_1.createOAuth1Client)({
+        consumerKey,
+        consumerSecret,
+        host: apiHost,
+    });
+    return sdk;
+}
+exports.sdkInitOnly = sdkInitOnly;
+async function sdkAuth() {
+    let credentials = {};
+    let haveCredFile = false;
+    const needed = ['API_HOST', 'API_OAUTH_CONSUMER_KEY', 'API_OAUTH_CONSUMER_SECRET', 'API_OAUTH_TOKEN', 'API_OAUTH_TOKEN_SECRET'];
+    const error = missing => {
+        let message = 'Failed to retrieve all credentials. ';
+        if (!haveCredFile) {
+            message += 'Couldn\'t open ~/.exh/credentials. ';
+        }
+        if (missing.length) {
+            message += `Missing properties: ${missing.join(',')}`;
+        }
+        throw new Error(message);
+    };
+    try {
+        const credentialsFile = fs.readFileSync(constants_1.EXH_CONFIG_FILE, 'utf-8');
+        haveCredFile = true;
+        credentials = credentialsFile
+            .split(/\r?\n/).map(l => l.split(/=/)).filter(i => i.length === 2)
+            .reduce((r, v) => { r[v[0].trim()] = v[1].trim(); return r; }, {});
+        for (const k of Object.keys(credentials)) {
+            if (!process.env[k]) {
+                process.env[k] = credentials[k];
+            }
+        }
+    }
+    catch (err) { }
+    needed.forEach(v => { credentials[v] = process.env[v] ?? credentials[v]; });
+    const missingProperties = needed.filter(p => credentials[p] === undefined);
+    if (missingProperties.length) {
+        error(missingProperties);
+    }
+    sdk = (0, javascript_sdk_1.createOAuth1Client)({
+        consumerKey: credentials.API_OAUTH_CONSUMER_KEY,
+        consumerSecret: credentials.API_OAUTH_CONSUMER_SECRET,
+        host: credentials.API_HOST,
+    });
+    try {
+        await sdk.auth.authenticate({
+            token: credentials.API_OAUTH_TOKEN,
+            tokenSecret: credentials.API_OAUTH_TOKEN_SECRET,
+        });
+    }
+    catch (err) {
+        throw new Error(`Failed to authenticate. All credentials found but some might be wrong or no longer valid.\nError was: "${err}"`);
+    }
+    return sdk;
+}
+exports.sdkAuth = sdkAuth;

package/build/helpers/error.d.ts

@@ -0,0 +1,2 @@
+export declare class CommandError extends Error {
+}

package/build/helpers/error.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommandError = void 0;
+class CommandError extends Error {
+}
+exports.CommandError = CommandError;

package/build/helpers/repoConfig.d.ts

@@ -0,0 +1,2 @@
+export declare const REPO_CONFIG_FILE = "repo-config.json";
+export declare function getRepoConfig(targetPath: string, validate: boolean): Promise<any>;

package/build/helpers/repoConfig.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRepoConfig = exports.REPO_CONFIG_FILE = void 0;
+const fs = require("fs/promises");
+const ospath = require("path");
+const chalk = require("chalk");
+exports.REPO_CONFIG_FILE = 'repo-config.json';
+async function getDefaultConfig(targetPath) {
+    const config = {};
+    const sections = ['schemas', 'templates', 'tasks'];
+    for (const s of sections) {
+        try {
+            await fs.access(ospath.join(targetPath, s));
+            config[s] = [s];
+        }
+        catch (err) {
+            continue;
+        }
+    }
+    return config;
+}
+async function validateRepoConfig(targetPath, config) {
+    const checkDirAccess = async (basePath, paths) => {
+        const result = [];
+        if (!Array.isArray(paths)) {
+            throw new Error('Not an array');
+        }
+        for (const p of paths) {
+            try {
+                await fs.access(ospath.join(basePath, p));
+            }
+            catch (err) {
+                console.log(chalk.yellow(`Warning: '${p}' directory not found`));
+                continue;
+            }
+            if (!(await fs.stat(ospath.join(basePath, p))).isDirectory()) {
+                throw new Error(`${p} is not a directory`);
+            }
+            result.push(p);
+        }
+        return result;
+    };
+    const newConfig = { ...config };
+    for (const [key] of Object.entries(config)) {
+        newConfig[key] = await checkDirAccess(targetPath, config[key]);
+    }
+    return newConfig;
+}
+async function getRepoConfig(targetPath, validate) {
+    let cfg = await getDefaultConfig(targetPath);
+    try {
+        cfg = JSON.parse((await fs.readFile(ospath.join(targetPath, exports.REPO_CONFIG_FILE))).toString());
+    }
+    catch (err) { }
+    if (validate) {
+        return await validateRepoConfig(targetPath, cfg);
+    }
+    return cfg;
+}
+exports.getRepoConfig = getRepoConfig;

package/build/helpers/util.d.ts

@@ -0,0 +1,3 @@
+import * as yargs from 'yargs';
+export declare function epilogue(y: yargs.Argv): yargs.Argv;
+export declare function asyncExec(cmd: string): Promise<string>;

package/build/helpers/util.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asyncExec = exports.epilogue = void 0;
+const child_process_1 = require("child_process");
+const chalk = require("chalk");
+const error_1 = require("./error");
+function epilogue(y) {
+    return y.epilogue('Visit https://docs.extrahorizon.com/extrahorizon-cli/ for more information.').fail((msg, err, argv) => {
+        if (err && err instanceof error_1.CommandError) {
+            console.log(err.message);
+            process.exit(1);
+        }
+        if (err) {
+            console.log(chalk.red(err.message));
+        }
+        else {
+            console.log(chalk.red(msg));
+        }
+        console.log('\nUsage:');
+        console.log(argv.help());
+        process.exit(1);
+    });
+}
+exports.epilogue = epilogue;
+async function asyncExec(cmd) {
+    return new Promise((res, rej) => {
+        (0, child_process_1.exec)(cmd, (err, stdout) => {
+            if (err) {
+                rej(err);
+                return;
+            }
+            res(stdout);
+        });
+    });
+}
+exports.asyncExec = asyncExec;

package/build/index.d.ts

@@ -0,0 +1,2 @@
+#! /usr/bin/env node
+export {};

package/build/index.js

@@ -0,0 +1,33 @@
+#! /usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tty = require("tty");
+const lodash_1 = require("lodash");
+const yargs = require("yargs");
+const helpers_1 = require("yargs/helpers");
+const exh_1 = require("./exh");
+function checkVersion() {
+    const pkg = require('../package.json');
+    const updateNotifier = require('update-notifier');
+    const notifier = updateNotifier({ pkg, updateCheckInterval: 0 });
+    notifier.notify();
+}
+checkVersion();
+yargs((0, helpers_1.hideBin)(process.argv))
+    .middleware(async (argv) => {
+    const isTTY = tty.isatty(process.stdout.fd);
+    if ((0, lodash_1.isEqual)(argv._, ['login']) ||
+        (0, lodash_1.isEqual)(argv._, ['data', 'schemas', 'verify']) ||
+        (0, lodash_1.isEqual)(argv._, ['tasks', 'create-repo']) ||
+        process.env.NO_SDK) {
+        return { sdk: 'no-sdk', isTTY };
+    }
+    const sdk = await (0, exh_1.sdkAuth)();
+    return { sdk, isTTY };
+})
+    .commandDir('commands')
+    .scriptName('exh')
+    .strict()
+    .demandCommand(1)
+    .completion('generate_completion', false)
+    .parse();

package/build/repositories/dispatchers.d.ts

@@ -0,0 +1,8 @@
+import { ActionCreation, ActionUpdate, DispatcherCreation, DispatcherUpdate, OAuth1Client, ObjectId, RQLString } from '@extrahorizon/javascript-sdk';
+export declare function create(sdk: OAuth1Client, data: DispatcherCreation): Promise<import("@extrahorizon/javascript-sdk").Dispatcher>;
+export declare function findAll(sdk: OAuth1Client, rql?: RQLString): Promise<import("@extrahorizon/javascript-sdk").Dispatcher[]>;
+export declare function update(sdk: OAuth1Client, dispatcherId: ObjectId, data: DispatcherUpdate): Promise<import("@extrahorizon/javascript-sdk").AffectedRecords>;
+export declare function remove(sdk: OAuth1Client, dispatcherId: ObjectId): Promise<import("@extrahorizon/javascript-sdk").AffectedRecords>;
+export declare function createAction(sdk: OAuth1Client, dispatcherId: ObjectId, data: ActionCreation): Promise<import("@extrahorizon/javascript-sdk").Action>;
+export declare function updateAction(sdk: OAuth1Client, dispatcherId: ObjectId, actionId: ObjectId, data: ActionUpdate): Promise<import("@extrahorizon/javascript-sdk").AffectedRecords>;
+export declare function removeAction(sdk: OAuth1Client, dispatcherId: ObjectId, actionId: ObjectId): Promise<import("@extrahorizon/javascript-sdk").AffectedRecords>;

package/build/repositories/dispatchers.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeAction = exports.updateAction = exports.createAction = exports.remove = exports.update = exports.findAll = exports.create = void 0;
+async function create(sdk, data) {
+    return await sdk.dispatchers.create(data);
+}
+exports.create = create;
+async function findAll(sdk, rql) {
+    return await sdk.dispatchers.findAll({ rql });
+}
+exports.findAll = findAll;
+async function update(sdk, dispatcherId, data) {
+    return await sdk.dispatchers.update(dispatcherId, data);
+}
+exports.update = update;
+async function remove(sdk, dispatcherId) {
+    return await sdk.dispatchers.remove(dispatcherId);
+}
+exports.remove = remove;
+async function createAction(sdk, dispatcherId, data) {
+    return await sdk.dispatchers.actions.create(dispatcherId, data);
+}
+exports.createAction = createAction;
+async function updateAction(sdk, dispatcherId, actionId, data) {
+    return await sdk.dispatchers.actions.update(dispatcherId, actionId, data);
+}
+exports.updateAction = updateAction;
+async function removeAction(sdk, dispatcherId, actionId) {
+    return await sdk.dispatchers.actions.remove(dispatcherId, actionId);
+}
+exports.removeAction = removeAction;

package/build/repositories/functions.d.ts

@@ -0,0 +1,24 @@
+import { OAuth1Client } from '@extrahorizon/javascript-sdk';
+import { permissionModes } from '../commands/tasks/taskConfig';
+export interface FunctionCreation {
+    name: string;
+    description: string;
+    entryPoint: string;
+    code: string;
+    runtime: string;
+    timeLimit?: number;
+    memoryLimit?: number;
+    environmentVariables?: Record<string, any>;
+    executionOptions?: {
+        permissionMode: permissionModes;
+    };
+    retryPolicy?: {
+        enabled: boolean;
+        errorsToRetry: string[];
+    };
+}
+export declare function find(sdk: OAuth1Client): Promise<any>;
+export declare function findByName(sdk: OAuth1Client, name: string): Promise<any>;
+export declare function create(sdk: OAuth1Client, data: FunctionCreation): Promise<any>;
+export declare function update(sdk: OAuth1Client, data: FunctionCreation): Promise<any>;
+export declare function remove(sdk: OAuth1Client, name: string): Promise<any>;

package/build/repositories/functions.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.remove = exports.update = exports.create = exports.findByName = exports.find = void 0;
+async function find(sdk) {
+    const response = await sdk.raw.get('/tasks/v1/functions');
+    return response.data.data;
+}
+exports.find = find;
+async function findByName(sdk, name) {
+    const response = await sdk.raw.get(`/tasks/v1/functions/${name}`);
+    return response.data;
+}
+exports.findByName = findByName;
+async function create(sdk, data) {
+    const response = await sdk.raw.post('/tasks/v1/functions', data);
+    return response.data;
+}
+exports.create = create;
+async function update(sdk, data) {
+    const response = await sdk.raw.put(`/tasks/v1/functions/${data.name}`, data);
+    return response.data;
+}
+exports.update = update;
+async function remove(sdk, name) {
+    const response = await sdk.raw.delete(`/tasks/v1/functions/${name}`);
+    return response.data;
+}
+exports.remove = remove;

package/build/repositories/schemas.d.ts

@@ -0,0 +1,44 @@
+import { OAuth1Client, ObjectId } from '@extrahorizon/javascript-sdk';
+interface Transition {
+    name: string;
+    type: string;
+    fromStatuses: string[];
+    toStatus: string;
+    conditions: {
+        type: string;
+    };
+    actions: {
+        type: string;
+    };
+    afterActions: {
+        type: string;
+    };
+}
+export declare function remove(sdk: OAuth1Client, schemaId: ObjectId): Promise<import("@extrahorizon/javascript-sdk").AffectedRecords>;
+export declare function disable(sdk: OAuth1Client, schemaId: ObjectId): Promise<import("@extrahorizon/javascript-sdk").AffectedRecords>;
+export declare function fetchSchemaByName(sdk: OAuth1Client, name: string): Promise<import("@extrahorizon/javascript-sdk").Schema>;
+export declare function createSchema(sdk: OAuth1Client, name: string, description: string): Promise<import("@extrahorizon/javascript-sdk").Schema>;
+export declare function updateSchema(sdk: OAuth1Client, id: string, data: any): Promise<import("@extrahorizon/javascript-sdk").AffectedRecords>;
+export declare function createProperty(sdk: OAuth1Client, id: string, data: {
+    name: string;
+    configuration: {
+        type: string;
+    };
+}): Promise<any>;
+export declare function updateProperty(sdk: OAuth1Client, id: string, path: string, data: {
+    name: string;
+    configuration: {
+        type: string;
+    };
+}): Promise<any>;
+export declare function deleteProperty(sdk: OAuth1Client, id: string, path: string): Promise<any>;
+export declare function createStatus(sdk: OAuth1Client, id: string, name: string, data: object): Promise<any>;
+export declare function updateStatus(sdk: OAuth1Client, id: string, name: string, data: object): Promise<any>;
+export declare function deleteStatus(sdk: OAuth1Client, id: string, name: string): Promise<any>;
+export declare function updateCreationTransition(sdk: OAuth1Client, id: string, data: Transition): Promise<any>;
+export declare function createTransition(sdk: OAuth1Client, id: string, data: Transition): Promise<any>;
+export declare function updateTransition(sdk: OAuth1Client, schemaId: string, transitionId: string, data: Transition): Promise<any>;
+export declare function deleteTransition(sdk: OAuth1Client, schemaId: string, transitionId: string): Promise<any>;
+export declare function createIndex(sdk: OAuth1Client, schemaId: string, index: any): Promise<any>;
+export declare function deleteIndex(sdk: OAuth1Client, schemaId: string, indexId: string): Promise<any>;
+export {};