boostr/dist/services/sub.js

Build and deploy your Layr apps

import { BaseService } from './base.js';
export class Subservice extends BaseService {
    constructor({ name, ...otherAttributes }) {
        super(otherAttributes);
        this._dependencies = [];
        this._dependents = [];
        this._name = name;
    }
    getName() {
        return this._name;
    }
    getApplicationService() {
        return this._applicationService;
    }
    registerDependency(service) {
        this._dependencies.push(service);
        service._dependents.push(this);
    }
    getDependencies() {
        return this._dependencies;
    }
    getDependents() {
        return this._dependents;
    }
    parseConfigURL() {
        const directory = this.getDirectory();
        const config = this.getConfig();
        const { protocol, hostname, port, pathname } = this._parseConfigURL();
        if (config.platform === 'local') {
            if (protocol !== 'http:') {
                this.throwError(`The 'url' property in the configuration should start with 'http://' (directory: '${directory}')`);
            }
            if (hostname !== 'localhost') {
                this.throwError(`The host of the 'url' property in the configuration should be 'localhost' (directory: '${directory}')`);
            }
            if (!port) {
                this.throwError(`The 'url' property in the configuration should specify a port (directory: '${directory}')`);
            }
            if (pathname !== '/') {
                this.throwError(`The path of the 'url' property in the configuration should be '/' (directory: '${directory}')`);
            }
        }
        else {
            if (protocol !== 'https:') {
                this.throwError(`The 'url' property in the configuration should start with 'https://' (directory: '${directory}')`);
            }
            if (hostname === 'localhost') {
                this.throwError(`The host of the 'url' property in the configuration should not be 'localhost' (directory: '${directory}')`);
            }
            if (port) {
                this.throwError(`The 'url' property in the configuration should not specify a port (directory: '${directory}')`);
            }
            if (pathname !== '/') {
                this.throwError(`The path of the 'url' property in the configuration should be '/' (directory: '${directory}')`);
            }
        }
        return { protocol, hostname, port, pathname };
    }
    _parseConfigURL() {
        const directory = this.getDirectory();
        const config = this.getConfig();
        if (!config.url) {
            this.throwError(`A 'url' property is required in the configuration (directory: '${directory}')`);
        }
        let url;
        try {
            url = new URL(config.url);
        }
        catch {
            this.throwError(`An error occurred while parsing the 'url' property in the configuration (directory: '${directory}')`);
        }
        const { protocol, hostname, port: portString, pathname } = url;
        const port = Number(portString);
        return { protocol, hostname, port, pathname };
    }
    async start() {
        await super.start();
        await this.startDependencies();
    }
    async startDependencies() {
        for (const service of this.getDependencies()) {
            if (!service._hasBeenStarted) {
                await service.start();
            }
        }
    }
    async stopDependencies() {
        for (const service of this.getDependencies()) {
            if (!service._hasBeenStopped) {
                await service.stop();
            }
        }
    }
    async deploy({ skipServiceNames = [] } = {}) {
        await super.deploy({ skipServiceNames });
        for (const service of this.getDependencies()) {
            if (!service._hasBeenDeployed) {
                await service.deploy({ skipServiceNames });
            }
        }
    }
}
Subservice.isRoot = false;
// === Commands ===
Subservice.commands = {
    ...BaseService.commands,
    install: {
        ...BaseService.commands.install,
        description: 'Installs all the npm dependencies used by your service.',
        examples: ['boostr {{serviceName}} install']
    },
    update: {
        ...BaseService.commands.update,
        description: 'Updates all the npm dependencies used by your service.',
        examples: ['boostr {{serviceName}} update', 'boostr {{serviceName}} update --save']
    },
    check: {
        ...BaseService.commands.check,
        description: 'Checks the TypeScript code of your service.',
        examples: ['boostr {{serviceName}} check']
    },
    build: {
        ...BaseService.commands.build,
        description: 'Builds runnable artifacts from the source code of your service.',
        examples: ['boostr {{serviceName}} build']
    },
    test: {
        ...BaseService.commands.test,
        description: 'Tests your service.',
        examples: ['boostr {{serviceName}} test']
    },
    start: {
        ...BaseService.commands.start,
        description: 'Starts your service (and the services it depends on) in development mode.',
        examples: ['boostr {{serviceName}} start']
    },
    deploy: {
        ...BaseService.commands.deploy,
        description: 'Deploys your service (and the services it depends on) to the specified stage.',
        examples: [
            'boostr {{serviceName}} deploy --production',
            'boostr {{serviceName}} deploy --staging --skip=legacyBackend'
        ]
    },
    config: {
        ...BaseService.commands.config,
        description: 'Displays your service configuration.',
        examples: ['boostr {{serviceName}} config']
    },
    exec: {
        ...BaseService.commands.exec,
        description: 'Executes any shell command in your service directory.',
        examples: [
            'boostr {{serviceName}} exec -- npm install lodash',
            'boostr {{serviceName}} exec -- npm version patch --no-git-tag-version',
            'boostr {{serviceName}} exec --stage=staging -- npm run myscript'
        ]
    }
};
//# sourceMappingURL=sub.js.map