nodecommons-esm-app 0.0.2

package/dist/apps/commons-bare.app.d.mts

@@ -0,0 +1,19 @@
+import { ICommonsStateful, ECommonsRunState } from 'tscommons-esm-async';
+import { CommonsArgs } from 'nodecommons-esm-cli';
+export declare function assertSet(property: unknown, name: string): asserts property;
+export declare class CommonsBareApp implements ICommonsStateful {
+    private args;
+    private state;
+    private aborted;
+    private error;
+    constructor();
+    protected getArgs(): CommonsArgs;
+    isAborted(): boolean;
+    abort(): void;
+    getState(): ECommonsRunState;
+    getError(): Error | undefined;
+    protected init(): Promise<void>;
+    protected run(): Promise<void>;
+    protected shutdown(): Promise<void>;
+    start(): Promise<void>;
+}

package/dist/apps/commons-bare.app.mjs

@@ -0,0 +1,64 @@
+import { ECommonsRunState } from 'tscommons-esm-async';
+import { CommonsArgs, commonsOutputAlert, commonsOutputDebug, commonsOutputError } from 'nodecommons-esm-cli';
+import { commonsGracefulAbortAddCallback, commonsGracefulAbortRemoveCallback } from 'nodecommons-esm-process';
+export function assertSet(property, name) {
+    if (!property)
+        throw new Error(`ASSERTION FAIL: ${name} has not been set.`);
+}
+export class CommonsBareApp {
+    args;
+    state;
+    aborted = false;
+    error;
+    constructor() {
+        this.args = new CommonsArgs();
+        this.state = ECommonsRunState.PRE;
+    }
+    getArgs() {
+        return this.args;
+    }
+    isAborted() {
+        return this.aborted;
+    }
+    abort() {
+        this.aborted = true;
+    }
+    getState() {
+        return this.state;
+    }
+    getError() {
+        return this.error;
+    }
+    async init() {
+        const gracefulAbortId = commonsGracefulAbortAddCallback(() => {
+            commonsGracefulAbortRemoveCallback(gracefulAbortId);
+            commonsOutputAlert('SIGINT abort flag is set. Aborting application.');
+            this.abort();
+        });
+    }
+    async run() {
+        // to be overridden if desired
+    }
+    async shutdown() {
+        commonsOutputDebug('Shutting down CommonsAppBare');
+        // to be overridden if desired
+    }
+    async start() {
+        try {
+            await this.init();
+            this.state = ECommonsRunState.RUNNING;
+            await this.run();
+            if (this.isAborted())
+                this.state = ECommonsRunState.ABORTED;
+            else
+                this.state = ECommonsRunState.COMPLETED;
+            await this.shutdown();
+        }
+        catch (e) {
+            this.state = ECommonsRunState.ERROR;
+            this.error = e;
+            commonsOutputError(`Application error: ${this.error.message}`);
+        }
+    }
+}
+//# sourceMappingURL=commons-bare.app.mjs.map

package/dist/apps/commons-bare.app.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"commons-bare.app.mjs","sourceRoot":"","sources":["../../src/apps/commons-bare.app.mts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEzE,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9G,OAAO,EAAE,+BAA+B,EAAE,kCAAkC,EAAE,MAAM,yBAAyB,CAAC;AAE9G,MAAM,UAAU,SAAS,CACvB,QAAiB,EACjB,IAAY;IAEb,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,oBAAoB,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,OAAO,cAAc;IAClB,IAAI,CAAc;IAElB,KAAK,CAAmB;IACxB,OAAO,GAAY,KAAK,CAAC;IACzB,KAAK,CAAkB;IAE/B;QACC,IAAI,CAAC,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC;QAE9B,IAAI,CAAC,KAAK,GAAG,gBAAgB,CAAC,GAAG,CAAC;IACnC,CAAC;IAES,OAAO;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC;IAClB,CAAC;IAEM,SAAS;QACf,OAAO,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;IAEM,KAAK;QACX,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACrB,CAAC;IAEM,QAAQ;QACd,OAAO,IAAI,CAAC,KAAK,CAAC;IACnB,CAAC;IAEM,QAAQ;QACd,OAAO,IAAI,CAAC,KAAK,CAAC;IACnB,CAAC;IAES,KAAK,CAAC,IAAI;QACnB,MAAM,eAAe,GAAW,+BAA+B,CAAC,GAAS,EAAE;YAC1E,kCAAkC,CAAC,eAAe,CAAC,CAAC;YAEpD,kBAAkB,CAAC,iDAAiD,CAAC,CAAC;YACtE,IAAI,CAAC,KAAK,EAAE,CAAC;QACd,CAAC,CAAC,CAAC;IACJ,CAAC;IAES,KAAK,CAAC,GAAG;QAClB,8BAA8B;IAC/B,CAAC;IACS,KAAK,CAAC,QAAQ;QACvB,kBAAkB,CAAC,8BAA8B,CAAC,CAAC;QAEnD,8BAA8B;IAC/B,CAAC;IAEM,KAAK,CAAC,KAAK;QACjB,IAAI,CAAC;YACJ,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YAElB,IAAI,CAAC,KAAK,GAAG,gBAAgB,CAAC,OAAO,CAAC;YACtC,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;YAEjB,IAAI,IAAI,CAAC,SAAS,EAAE;gBAAE,IAAI,CAAC,KAAK,GAAG,gBAAgB,CAAC,OAAO,CAAC;;gBACvD,IAAI,CAAC,KAAK,GAAG,gBAAgB,CAAC,SAAS,CAAC;YAE7C,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;QACvB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACZ,IAAI,CAAC,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC;YACpC,IAAI,CAAC,KAAK,GAAG,CAAU,CAAC;YACxB,kBAAkB,CAAC,sBAAsB,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAChE,CAAC;IACF,CAAC;CACD"}

package/dist/apps/commons.app.d.mts

@@ -0,0 +1,26 @@
+import { TEncodedObject, TPropertyObject } from 'tscommons-esm-core';
+import { CommonsConfig } from 'tscommons-esm-config';
+import { CommonsArgs } from 'nodecommons-esm-cli';
+import { CommonsConfigFile } from 'nodecommons-esm-config';
+import { ICommonsPackageJson } from '../interfaces/icommons-package-json.mjs';
+import { CommonsBareApp } from './commons-bare.app.mjs';
+export declare class CommonsApp extends CommonsBareApp {
+    private name;
+    protected configFile?: string | undefined;
+    private configPath?;
+    static getConfigPaths(name?: string, args?: CommonsArgs, argsKey?: string, envVar?: string, configFile?: string): string[];
+    protected config: CommonsConfig | CommonsConfigFile;
+    private configPaths;
+    constructor(name: string, configFile?: string | undefined, configPath?: string | undefined, // NB, a direct path, not the name of the args parameter
+    envVar?: string, argsKey?: string, allowNoConfig?: boolean);
+    getConfigArea(area: string, optional?: boolean): TPropertyObject;
+    setConfigArea<T extends TEncodedObject>(area: string, config: T): void;
+    protected locateConfigFile(file: string): string;
+    loadRawJsonConfigFile(file: string): unknown;
+    loadConfigFile(file: string): CommonsConfigFile;
+    saveConfig(): void;
+    getPackageJson(): ICommonsPackageJson | undefined;
+    installSystemd(command: string, description: string, group?: string, autoJoinGroup?: boolean, restart?: string, restartSec?: number, autoEnable?: boolean, autoStart?: boolean, systemdServiceName?: string): void;
+    uninstallSystemd(group?: string, systemdServiceName?: string): void;
+    autoSystemd(command: string, description: string, group?: string, autoJoinGroup?: boolean, restart?: string, restartSec?: number, autoEnable?: boolean, autoStart?: boolean, systemdServiceName?: string): void | never;
+}

package/dist/apps/commons.app.mjs

@@ -0,0 +1,243 @@
+import * as os from 'os';
+import * as nodePath from 'path';
+import { commonsStringKebabCase, commonsStringSnakeCase, commonsTypeIsObject } from 'tscommons-esm-core';
+import { CommonsConfig } from 'tscommons-esm-config';
+import { commonsEnvGetStringOrUndefined, commonsOutputAlert, commonsOutputDebug, commonsOutputDoing, commonsOutputError, commonsOutputFail, commonsOutputSuccess } from 'nodecommons-esm-cli';
+import { commonsFileCwdRelativeOrAbsolutePath, commonsFileIsDirectory, commonsFileIsFile, commonsFileReadJsonFile, commonsFileRootRelativePath } from 'nodecommons-esm-file';
+import { CommonsConfigFile } from 'nodecommons-esm-config';
+import { commonsSystemdInstall, commonsSystemdUninstall } from 'nodecommons-esm-process';
+import { isICommonsPackageJson } from '../interfaces/icommons-package-json.mjs';
+import { CommonsBareApp } from './commons-bare.app.mjs';
+// we're doing this in here rather than in a nodecommons-process or similar, as it's very bespoke to this code
+var ESimplifiedPlatform;
+(function (ESimplifiedPlatform) {
+    ESimplifiedPlatform["POSIX"] = "posix";
+    ESimplifiedPlatform["WIN32"] = "win32";
+})(ESimplifiedPlatform || (ESimplifiedPlatform = {}));
+// we're doing this in here rather than in a nodecommons-process or similar, as it's very bespoke to this code
+function simplifiedPlatform() {
+    switch (os.platform()) {
+        case 'aix':
+        case 'android':
+        case 'darwin':
+        case 'freebsd':
+        case 'linux':
+        case 'netbsd':
+        case 'openbsd':
+        case 'sunos':
+            return ESimplifiedPlatform.POSIX;
+        case 'win32':
+        case 'cygwin':
+            return ESimplifiedPlatform.WIN32;
+        default:
+            throw new Error('OS platform not supported for CommonsFile');
+    }
+}
+export class CommonsApp extends CommonsBareApp {
+    name;
+    configFile;
+    configPath;
+    static getConfigPaths(name, args, argsKey = 'config-path', envVar, configFile) {
+        const attempts = [];
+        if (args) {
+            const path = args.getFirstValueOrUndefined(argsKey);
+            if (path !== undefined)
+                attempts.push(path);
+        }
+        if (!envVar && name) {
+            envVar = `${commonsStringSnakeCase(name).toUpperCase()}_CONFIG`;
+            commonsOutputDebug(`Calculated environment variable for config is ${envVar}`);
+        }
+        if (envVar) {
+            const env = commonsEnvGetStringOrUndefined(envVar);
+            if (env !== undefined)
+                attempts.push(env);
+        }
+        const relative = commonsFileCwdRelativeOrAbsolutePath('config');
+        if (commonsFileIsDirectory(relative))
+            attempts.push(relative);
+        if (name) {
+            switch (simplifiedPlatform()) {
+                case ESimplifiedPlatform.POSIX: {
+                    const etc = commonsFileCwdRelativeOrAbsolutePath(`/etc/${name}`);
+                    commonsOutputDebug(`Calculated /etc path for config is ${etc}`);
+                    if (commonsFileIsDirectory(etc))
+                        attempts.push(etc);
+                    const home = nodePath.join(os.homedir(), `.${name}`);
+                    commonsOutputDebug(`Calculated $HOME path for config is ${home}`);
+                    if (commonsFileIsDirectory(home))
+                        attempts.push(home);
+                    break;
+                }
+                case ESimplifiedPlatform.WIN32:
+                    // not implemented for win32 yet
+                    break;
+            }
+        }
+        if (configFile) {
+            // derive the configPath from the configFile absolute path
+            const parts = configFile.split(nodePath.sep);
+            parts.pop();
+            const result = parts.join(nodePath.sep);
+            if (commonsFileIsDirectory(result))
+                attempts.push(result);
+        }
+        if (name) {
+            const localNodeModulesConfig = commonsFileRootRelativePath(nodePath.join('node_modules', name, 'config'));
+            commonsOutputDebug(`Calculated cwd node_modules path for config is ${localNodeModulesConfig}`);
+            if (commonsFileIsDirectory(localNodeModulesConfig))
+                attempts.push(localNodeModulesConfig);
+            const globalNodeModulesConfig = commonsFileRootRelativePath('config');
+            commonsOutputDebug(`Calculated global node_modules path for config is ${globalNodeModulesConfig}`);
+            if (commonsFileIsDirectory(globalNodeModulesConfig))
+                attempts.push(globalNodeModulesConfig);
+        }
+        commonsOutputDebug(`Searching for config in paths: ${attempts.join('; ')}`);
+        return attempts;
+    }
+    config;
+    configPaths;
+    constructor(name, configFile, configPath, // NB, a direct path, not the name of the args parameter
+    envVar, argsKey = 'config-path', allowNoConfig = false) {
+        super();
+        this.name = name;
+        this.configFile = configFile;
+        this.configPath = configPath;
+        const c = this.getArgs().getFirstValueOrUndefined('config');
+        if (c)
+            this.configFile = c;
+        if (!this.configFile) {
+            this.configFile = `${commonsStringKebabCase(this.name)}.json`;
+        }
+        if (this.configPath) {
+            this.configPaths = [this.configPath];
+        }
+        else {
+            this.configPaths = CommonsApp.getConfigPaths(this.name, this.getArgs(), argsKey, envVar, this.configFile);
+            if (this.configPaths.length === 0 && !allowNoConfig)
+                throw new Error('Unable to derive config path');
+        }
+        if (this.configPaths.length === 0 && allowNoConfig) {
+            this.config = new CommonsConfig({});
+        }
+        else {
+            this.config = this.loadConfigFile(this.configFile);
+        }
+    }
+    getConfigArea(area, optional = false) {
+        const result = this.config.getObject(area, optional ? {} : undefined);
+        if (!commonsTypeIsObject(result))
+            throw new Error('Invalid config area');
+        return result;
+    }
+    setConfigArea(area, config) {
+        this.config.setObject(area, config);
+    }
+    locateConfigFile(file) {
+        const asAbsolute = commonsFileCwdRelativeOrAbsolutePath(file);
+        if (file === asAbsolute)
+            return file;
+        for (const path of this.configPaths) {
+            //const p: string = /^\//.test(path) ? path : commonsFileRootRelativePath(path);
+            const attempt = nodePath.join(path, file);
+            commonsOutputDebug(`Looking for config file at ${attempt}`);
+            if (commonsFileIsFile(attempt)) {
+                commonsOutputDebug('Found config file.');
+                return attempt;
+            }
+        }
+        throw new Error(`Unable to locate config file ${file} at any config path location`);
+    }
+    loadRawJsonConfigFile(file) {
+        const location = this.locateConfigFile(file);
+        return commonsFileReadJsonFile(location);
+    }
+    loadConfigFile(file) {
+        const location = this.locateConfigFile(file);
+        return new CommonsConfigFile(location);
+    }
+    saveConfig() {
+        if (!(this.config instanceof CommonsConfigFile))
+            throw new Error('Cannot save to a non-file based config');
+        this.config.save();
+    }
+    getPackageJson() {
+        const attempts = [];
+        const relative = commonsFileCwdRelativeOrAbsolutePath('package.json');
+        if (commonsFileIsFile(relative))
+            attempts.push(relative);
+        const localNodeModulesPackage = commonsFileRootRelativePath(nodePath.join('node_modules', this.name, 'package.json'));
+        commonsOutputDebug(`Calculated cwd node_modules path for package.json is ${localNodeModulesPackage}`);
+        if (commonsFileIsFile(localNodeModulesPackage))
+            attempts.push(localNodeModulesPackage);
+        const globalNodeModulesPackage = commonsFileRootRelativePath('package.json');
+        commonsOutputDebug(`Calculated global node_modules path for package.json is ${globalNodeModulesPackage}`);
+        if (commonsFileIsFile(globalNodeModulesPackage))
+            attempts.push(globalNodeModulesPackage);
+        if (attempts.length === 0) {
+            commonsOutputAlert('package.json could not be located');
+            return undefined;
+        }
+        const first = attempts.shift();
+        commonsOutputDebug(`Found package.json in path: ${first}`);
+        const attempt = commonsFileReadJsonFile(first);
+        if (!isICommonsPackageJson(attempt))
+            return undefined;
+        return attempt;
+    }
+    installSystemd(command, description, group, autoJoinGroup = false, restart = 'always', restartSec = 5, autoEnable = true, autoStart = false, systemdServiceName) {
+        switch (simplifiedPlatform()) {
+            case ESimplifiedPlatform.POSIX: {
+                const etcConfig = new CommonsConfigFile(`/etc/${this.name}/${this.name}.json`);
+                etcConfig.cloneConfig(this.config);
+                commonsSystemdInstall(systemdServiceName === undefined ? this.name : systemdServiceName, command, description, etcConfig, undefined, undefined, group, autoJoinGroup, restart, restartSec, autoEnable, autoStart);
+                break;
+            }
+            case ESimplifiedPlatform.WIN32:
+                throw new Error('Systemd not supported under win32');
+        }
+    }
+    uninstallSystemd(group, systemdServiceName) {
+        switch (simplifiedPlatform()) {
+            case ESimplifiedPlatform.POSIX:
+                commonsSystemdUninstall(systemdServiceName === undefined ? this.name : systemdServiceName, group);
+                break;
+            case ESimplifiedPlatform.WIN32:
+                throw new Error('Systemd not supported under win32');
+        }
+    }
+    autoSystemd(command, description, group, autoJoinGroup = false, restart = 'always', restartSec = 5, autoEnable = true, autoStart = false, systemdServiceName) {
+        const direction = this.getArgs().getFirstValueOrUndefined('systemd');
+        if (!direction)
+            return;
+        switch (direction) {
+            case 'install':
+                commonsOutputDoing('Installing systemd service');
+                try {
+                    this.installSystemd(command, description, group, autoJoinGroup, restart, restartSec, autoEnable, autoStart, systemdServiceName);
+                    commonsOutputSuccess();
+                }
+                catch (e) {
+                    commonsOutputFail(e.message);
+                    commonsOutputError(e.message);
+                }
+                break;
+            case 'uninstall':
+                commonsOutputDoing('Uninstalling systemd service');
+                try {
+                    this.uninstallSystemd();
+                    commonsOutputSuccess();
+                }
+                catch (e) {
+                    commonsOutputFail(e.message);
+                    commonsOutputError(e.message);
+                }
+                break;
+            default:
+                commonsOutputError('Unknown command for --systemd. Use either install or uninstall');
+                process.exit(1);
+        }
+        process.exit(0);
+    }
+}
+//# sourceMappingURL=commons.app.mjs.map

package/dist/apps/commons.app.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"commons.app.mjs","sourceRoot":"","sources":["../../src/apps/commons.app.mts"],"names":[],"mappings":"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"}

package/dist/index.d.mts

@@ -0,0 +1,4 @@
+import { assertSet, CommonsBareApp } from './apps/commons-bare.app.mjs';
+import { CommonsApp } from './apps/commons.app.mjs';
+import { TCommonsDependencies, isTCommonsDependencies, ICommonsPackageJson, isICommonsPackageJson } from './interfaces/icommons-package-json.mjs';
+export { assertSet, CommonsBareApp, CommonsApp, TCommonsDependencies, isTCommonsDependencies, ICommonsPackageJson, isICommonsPackageJson };

package/dist/index.mjs

@@ -0,0 +1,5 @@
+import { assertSet, CommonsBareApp } from './apps/commons-bare.app.mjs';
+import { CommonsApp } from './apps/commons.app.mjs';
+import { isTCommonsDependencies, isICommonsPackageJson } from './interfaces/icommons-package-json.mjs';
+export { assertSet, CommonsBareApp, CommonsApp, isTCommonsDependencies, isICommonsPackageJson };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAEL,sBAAsB,EAEtB,qBAAqB,EACtB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACN,SAAS,EACT,cAAc,EACd,UAAU,EAEV,sBAAsB,EAEtB,qBAAqB,EACrB,CAAC"}

package/dist/interfaces/icommons-package-json.d.mts

@@ -0,0 +1,12 @@
+export type TCommonsDependencies = {
+    [name: string]: string;
+};
+export declare function isTCommonsDependencies(test: any): test is TCommonsDependencies;
+export interface ICommonsPackageJson {
+    name: string;
+    version: string;
+    description?: string;
+    dependencies?: TCommonsDependencies;
+    devDependencies?: TCommonsDependencies;
+}
+export declare function isICommonsPackageJson(test: any): test is ICommonsPackageJson;

package/dist/interfaces/icommons-package-json.mjs

@@ -0,0 +1,18 @@
+import { commonsTypeHasPropertyString, commonsTypeHasPropertyStringOrUndefined, commonsTypeHasPropertyTOrUndefined, commonsTypeIsStringPropertyObjectT } from 'tscommons-esm-core';
+export function isTCommonsDependencies(test) {
+    return commonsTypeIsStringPropertyObjectT(test);
+}
+export function isICommonsPackageJson(test) {
+    if (!commonsTypeHasPropertyString(test, 'name'))
+        return false;
+    if (!commonsTypeHasPropertyString(test, 'version'))
+        return false;
+    if (!commonsTypeHasPropertyStringOrUndefined(test, 'description'))
+        return false;
+    if (!commonsTypeHasPropertyTOrUndefined(test, 'dependencies', isTCommonsDependencies))
+        return false;
+    if (!commonsTypeHasPropertyTOrUndefined(test, 'devDependencies', isTCommonsDependencies))
+        return false;
+    return true;
+}
+//# sourceMappingURL=icommons-package-json.mjs.map

package/dist/interfaces/icommons-package-json.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"icommons-package-json.mjs","sourceRoot":"","sources":["../../src/interfaces/icommons-package-json.mts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,uCAAuC,EACvC,kCAAkC,EAClC,kCAAkC,EACnC,MAAM,oBAAoB,CAAC;AAM5B,MAAM,UAAU,sBAAsB,CAAC,IAAS;IAC/C,OAAO,kCAAkC,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC;AAUD,MAAM,UAAU,qBAAqB,CAAC,IAAS;IAC9C,IAAI,CAAC,4BAA4B,CAAC,IAAI,EAAE,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9D,IAAI,CAAC,4BAA4B,CAAC,IAAI,EAAE,SAAS,CAAC;QAAE,OAAO,KAAK,CAAC;IACjE,IAAI,CAAC,uCAAuC,CAAC,IAAI,EAAE,aAAa,CAAC;QAAE,OAAO,KAAK,CAAC;IAChF,IAAI,CAAC,kCAAkC,CAAuB,IAAI,EAAE,cAAc,EAAE,sBAAsB,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1H,IAAI,CAAC,kCAAkC,CAAuB,IAAI,EAAE,iBAAiB,EAAE,sBAAsB,CAAC;QAAE,OAAO,KAAK,CAAC;IAE7H,OAAO,IAAI,CAAC;AACb,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+	"name": "nodecommons-esm-app",
+	"version": "0.0.2",
+	"description": "",
+	"scripts": {
+		"tsc": "./node_modules/typescript/bin/tsc",
+		"preprepare": "rm -rf ./dist; php ~/Dev/etim.php src/ && npm run tsc",
+		"publish-major": "rm -rf dist; npm run tsc && npx eslint . && npm run preprepare && npm version major && npm install && npm publish && git add . && git commit -m 'publish'",
+		"publish-minor": "rm -rf dist; npm run tsc && npx eslint . && npm run preprepare && npm version minor && npm install && npm publish && git add . && git commit -m 'publish'",
+		"publish-patch": "rm -rf dist; npm run tsc && npx eslint . && npm run preprepare && npm version patch && npm install && npm publish && git add . && git commit -m 'publish'"
+	},
+	"main": "dist/index.mjs",
+	"types": "dist/index.d.mjs",
+	"type": "module",
+	"author": "Pete Morris",
+	"license": "ISC",
+	"devDependencies": {
+		"@stylistic/eslint-plugin-ts": "^2.10.1",
+		"@types/node": "^22.9.0",
+		"eslint-plugin-import": "^2.31.0",
+		"eslint-plugin-prefer-arrow-functions": "^3.4.1",
+		"typescript": "^5.6.3",
+		"typescript-eslint": "^8.14.0"
+	},
+	"files": [
+		"dist/**/*"
+	],
+	"dependencies": {
+		"nodecommons-esm-cli": "^0.0.2",
+		"nodecommons-esm-config": "^0.0.2",
+		"nodecommons-esm-file": "^0.0.2",
+		"nodecommons-esm-process": "^0.0.2",
+		"tscommons-esm-async": "^0.0.2",
+		"tscommons-esm-config": "^0.0.2",
+		"tscommons-esm-core": "^0.0.2"
+	}
+}