rbxts-orchestra 0.1.0-dev.0

package/bin/run

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+require('../dist/run')

package/dist/run.js

@@ -0,0 +1,195 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// bin/run.ts
+var import_yargs = __toESM(require("yargs"));
+
+// package.json
+var package_default = {
+  name: "rbxts-orchestra",
+  version: "0.1.0",
+  description: "A build orchestrator.",
+  main: "src/index.ts",
+  bin: {
+    orchestra: "./bin/run"
+  },
+  directories: {
+    lib: "src",
+    bin: "bin"
+  },
+  files: [
+    "dist",
+    "bin/run"
+  ],
+  scripts: {
+    build: "tsup-node && tsc",
+    "build:watch": "tsup-node --watch",
+    clean: "rimraf dist",
+    compile: "tsc",
+    format: "prettier . --check",
+    "format:fix": "prettier . --write",
+    lint: "eslint .",
+    "lint:fix": "eslint . --fix",
+    start: "ts-node ./bin/run.ts",
+    "start:node": "node ./bin/run",
+    prepublish: "npm run build"
+  },
+  devDependencies: {
+    "@tsconfig/node20": "^20.1.4",
+    "@types/node": "^20.12.12",
+    "@types/yargs": "^17.0.32",
+    eslint: "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-prettier": "^5.5.4",
+    "eslint-plugin-unused-imports": "^4.3.0",
+    prettier: "^3.7.4",
+    rimraf: "^5.0.7",
+    "ts-node": "^10.9.2",
+    tsup: "^8.0.2",
+    typescript: "^5.5.3",
+    "typescript-eslint": "^8.51.0"
+  },
+  dependencies: {
+    consola: "^3.2.3",
+    picocolors: "^1.0.1",
+    yargs: "^17.7.2",
+    jiti: "^2.6.1"
+  }
+};
+
+// src/commands/runScript.ts
+var runScript_exports = {};
+__export(runScript_exports, {
+  builder: () => builder,
+  command: () => command,
+  describe: () => describe,
+  handler: () => handler
+});
+var import_node_path = require("path");
+var process2 = __toESM(require("process"));
+
+// src/logger.ts
+var import_consola = require("consola");
+var logger = (0, import_consola.createConsola)({});
+
+// src/orchestra/config.ts
+function resolveValue(value, orchestra) {
+  return typeof value === "function" ? value(orchestra) : value;
+}
+
+// src/orchestra/orchestra.ts
+var import_assert = __toESM(require("assert"));
+var import_jiti = require("jiti");
+var import_path = require("path");
+var jiti = (0, import_jiti.createJiti)(__filename);
+var ORCHESTRA_CONFIG_FILENAME = "orchestra.config.ts";
+var Orchestra = class _Orchestra {
+  constructor(config) {
+    this.config = config;
+    for (const [environmentName, environmentConfig] of Object.entries(config.environments)) {
+      if (this.environment) continue;
+      const NODE_ENV = process.env.NODE_ENV ?? "unknown";
+      if (environmentConfig.default) {
+        this.environment = environmentName;
+      } else if (NODE_ENV == environmentConfig.nodeEnv) {
+        this.environment = environmentName;
+      }
+    }
+    (0, import_assert.default)(this.environment, `Orchestra confiag is invalid, no default or otherwise valid environments provided`);
+  }
+  static async fromDirectory(directoryPath) {
+    return await _Orchestra.fromFileConfig((0, import_path.resolve)(directoryPath, ORCHESTRA_CONFIG_FILENAME));
+  }
+  static async fromFileConfig(filePath) {
+    const config = await jiti.import((0, import_path.resolve)(filePath), {
+      default: true
+    });
+    return new _Orchestra(config);
+  }
+  environment;
+  async runScripts(scriptName, argv2) {
+    await this.resolveConfig(this.config.scripts?.prepare)?.(this, void 0, argv2);
+    await this.resolveConfig(this.config.scripts?.[scriptName])?.(this, void 0, argv2);
+    for (const place of this.config.places) {
+      await this.resolveConfig(place.scripts[scriptName])?.(this, place, argv2);
+    }
+  }
+  resolveConfig(config) {
+    return resolveValue(config, this);
+  }
+};
+
+// src/commands/runScript.ts
+var command = "run <script>";
+var describe = "Runs build scripts for all orchestrated places.";
+function builder(yargs2) {
+  return yargs2.positional("script", {
+    type: "string",
+    description: "script name"
+  }).option("config", {
+    type: "string",
+    alias: "c",
+    description: "Path to the orchestra config file",
+    default: `${ORCHESTRA_CONFIG_FILENAME}`
+  }).coerce("config", (value) => {
+    if ((0, import_node_path.isAbsolute)(value)) {
+      return value;
+    }
+    return (0, import_node_path.join)(process2.cwd(), value);
+  });
+}
+async function handler(argv2) {
+  const delimiterIndex = process2.argv.findIndex((arg) => arg == "--");
+  const delimitedArgv = delimiterIndex !== -1 ? process2.argv.slice(delimiterIndex + 1) : void 0;
+  const orchestra = await Orchestra.fromFileConfig(argv2.config).catch(() => {
+    logger.error(`Failed to find config file at ${argv2.config}`);
+    process2.exit(1);
+  });
+  await orchestra.runScripts(argv2.script, delimitedArgv).catch((code) => {
+    logger.error(`Failed to run script: exit code ${code}`);
+  });
+}
+
+// src/commands/index.ts
+var commands = [runScript_exports];
+
+// src/helpers/release.ts
+var import_child_process = require("child_process");
+
+// src/helpers/script.ts
+var import_child_process2 = require("child_process");
+var import_path2 = require("path");
+
+// bin/run.ts
+var run = (0, import_yargs.default)(process.argv.slice(2));
+run.usage(`orchestra v${package_default.version}`);
+for (const command2 of commands) {
+  run.command(command2);
+}
+run.demandCommand(1, "You need at least one command before moving on").help().argv;

package/dist/src/commands/index.d.ts

@@ -0,0 +1,2 @@
+import * as run from "./runScript";
+export declare const commands: (typeof run)[];

package/dist/src/commands/index.js

@@ -0,0 +1,3 @@
+import * as run from "./runScript";
+export const commands = [run];
+//# sourceMappingURL=index.js.map

package/dist/src/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,aAAa,CAAC;AAEnC,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC"}

package/dist/src/commands/runScript.d.ts

@@ -0,0 +1,10 @@
+import { ArgumentsCamelCase, Argv } from "yargs";
+interface RunArgv {
+    script: string;
+    config: string;
+}
+export declare const command = "run <script>";
+export declare const describe = "Runs build scripts for all orchestrated places.";
+export declare function builder(yargs: Argv<RunArgv>): Argv;
+export declare function handler(argv: ArgumentsCamelCase<RunArgv>): Promise<void>;
+export {};

package/dist/src/commands/runScript.js

@@ -0,0 +1,37 @@
+import { isAbsolute, join } from "node:path";
+import * as process from "node:process";
+import { logger } from "../logger";
+import { Orchestra, ORCHESTRA_CONFIG_FILENAME } from "../orchestra";
+export const command = "run <script>";
+export const describe = "Runs build scripts for all orchestrated places.";
+export function builder(yargs) {
+    return yargs
+        .positional("script", {
+        type: "string",
+        description: "script name",
+    })
+        .option("config", {
+        type: "string",
+        alias: "c",
+        description: "Path to the orchestra config file",
+        default: `${ORCHESTRA_CONFIG_FILENAME}`,
+    })
+        .coerce("config", (value) => {
+        if (isAbsolute(value)) {
+            return value;
+        }
+        return join(process.cwd(), value);
+    });
+}
+export async function handler(argv) {
+    const delimiterIndex = process.argv.findIndex((arg) => arg == "--");
+    const delimitedArgv = delimiterIndex !== -1 ? process.argv.slice(delimiterIndex + 1) : undefined;
+    const orchestra = await Orchestra.fromFileConfig(argv.config).catch(() => {
+        logger.error(`Failed to find config file at ${argv.config}`);
+        process.exit(1);
+    });
+    await orchestra.runScripts(argv.script, delimitedArgv).catch((code) => {
+        logger.error(`Failed to run script: exit code ${code}`);
+    });
+}
+//# sourceMappingURL=runScript.js.map

package/dist/src/commands/runScript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runScript.js","sourceRoot":"","sources":["../../../src/commands/runScript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AAGxC,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAOpE,MAAM,CAAC,MAAM,OAAO,GAAG,cAAc,CAAC;AACtC,MAAM,CAAC,MAAM,QAAQ,GAAG,iDAAiD,CAAC;AAE1E,MAAM,UAAU,OAAO,CAAC,KAAoB;IAC3C,OAAO,KAAK;SACV,UAAU,CAAC,QAAQ,EAAE;QACrB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,aAAa;KAC1B,CAAC;SACD,MAAM,CAAC,QAAQ,EAAE;QACjB,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,GAAG;QACV,WAAW,EAAE,mCAAmC;QAChD,OAAO,EAAE,GAAG,yBAAyB,EAAE;KACvC,CAAC;SACD,MAAM,CAAC,QAAQ,EAAE,CAAC,KAAa,EAAE,EAAE;QACnC,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,KAAK,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAiC;IAC9D,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;IACpE,MAAM,aAAa,GAAG,cAAc,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACjG,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;QACxE,MAAM,CAAC,KAAK,CAAC,iCAAiC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE;QACrE,MAAM,CAAC,KAAK,CAAC,mCAAmC,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/helpers/release.d.ts

@@ -0,0 +1,16 @@
+import { Environments, Value } from "src/orchestra";
+export declare function semverString<E extends Environments>(
+/**
+ * The base semver string (e.g `1.0.0`)
+ */
+baseSemver: string, 
+/**
+ * A list of environments in which to include the short hash of the
+ * currently checked out commit in the semver string
+ */
+commitHashEnvironments?: (keyof E)[], 
+/**
+ * A list of environments in which to include the name of the
+ * local user in the semver string
+ */
+userEnvironments?: (keyof E)[]): Value<E, string>;

package/dist/src/helpers/release.js

@@ -0,0 +1,42 @@
+import { execSync } from "child_process";
+export function semverString(
+/**
+ * The base semver string (e.g `1.0.0`)
+ */
+baseSemver, 
+/**
+ * A list of environments in which to include the short hash of the
+ * currently checked out commit in the semver string
+ */
+commitHashEnvironments, 
+/**
+ * A list of environments in which to include the name of the
+ * local user in the semver string
+ */
+userEnvironments) {
+    return (orchestra) => {
+        let shortCommitHash, localUsername;
+        try {
+            localUsername = execSync("whoami", {
+                stdio: "pipe",
+            })
+                .toString()
+                .trim();
+            shortCommitHash = execSync("git rev-parse --short HEAD", {
+                stdio: "pipe",
+            })
+                .toString()
+                .trim();
+        }
+        catch { }
+        let semver = baseSemver;
+        if (localUsername && userEnvironments?.includes(orchestra.environment)) {
+            semver += `-${localUsername}`;
+        }
+        if (shortCommitHash && commitHashEnvironments?.includes(orchestra.environment)) {
+            semver += `+${shortCommitHash}`;
+        }
+        return semver;
+    };
+}
+//# sourceMappingURL=release.js.map

package/dist/src/helpers/release.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release.js","sourceRoot":"","sources":["../../../src/helpers/release.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,MAAM,UAAU,YAAY;AAC3B;;GAEG;AACH,UAAkB;AAClB;;;GAGG;AACH,sBAAoC;AACpC;;;GAGG;AACH,gBAA8B;IAE9B,OAAO,CAAC,SAAS,EAAE,EAAE;QACpB,IAAI,eAAe,EAAE,aAAa,CAAC;QACnC,IAAI,CAAC;YACJ,aAAa,GAAG,QAAQ,CAAC,QAAQ,EAAE;gBAClC,KAAK,EAAE,MAAM;aACb,CAAC;iBACA,QAAQ,EAAE;iBACV,IAAI,EAAE,CAAC;YACT,eAAe,GAAG,QAAQ,CAAC,4BAA4B,EAAE;gBACxD,KAAK,EAAE,MAAM;aACb,CAAC;iBACA,QAAQ,EAAE;iBACV,IAAI,EAAE,CAAC;QACV,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;QACV,IAAI,MAAM,GAAG,UAAU,CAAC;QAExB,IAAI,aAAa,IAAI,gBAAgB,EAAE,QAAQ,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC;YACxE,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QAC/B,CAAC;QACD,IAAI,eAAe,IAAI,sBAAsB,EAAE,QAAQ,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC;YAChF,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;QACjC,CAAC;QAED,OAAO,MAAM,CAAC;IACf,CAAC,CAAC;AACH,CAAC"}

package/dist/src/helpers/script.d.ts

@@ -0,0 +1,14 @@
+import { Environments, Script, Value } from "../orchestra/config";
+interface SpawnConfig {
+    /**
+     * Whether to wait until the process exits before continuing to the next script
+     */
+    waitForExit: boolean;
+    /**
+     * Whether to ignore a non-zero exit code
+     */
+    ignoreNonZeroExitCode: boolean;
+}
+export declare function sh<E extends Environments>(cmd: string, config?: Partial<SpawnConfig>): Value<E, Script<E>>;
+export declare function script<E extends Environments>(path: string, config?: Partial<SpawnConfig>): Value<E, Script<E>>;
+export {};

package/dist/src/helpers/script.js

@@ -0,0 +1,46 @@
+import { spawn } from "child_process";
+import { resolve } from "path";
+import { val } from "../orchestra/config";
+const DEFAULT_SPAWN_CONFIG = {
+    waitForExit: true,
+    ignoreNonZeroExitCode: false,
+};
+function generateEnv(orchestra, place) {
+    return {
+        ...process.env,
+        ORCHESTRA_DIR: resolve("."),
+        RELEASE_NUMBER: orchestra.resolveConfig(orchestra.config.releaseNumber),
+        RELEASE_NAME: orchestra.resolveConfig(orchestra.config.releaseName),
+        PLACE_ID: place && orchestra.resolveConfig(place.placeId)?.toString(),
+        EXPERIENCE_ID: place && orchestra.resolveConfig(place.experienceId)?.toString(),
+    };
+}
+export function sh(cmd, config = {}) {
+    const fullConfig = {
+        ...DEFAULT_SPAWN_CONFIG,
+        ...config,
+    };
+    return val((orchestra, place, argv = []) => {
+        return new Promise((resolvePromise, reject) => {
+            const child = spawn(`${cmd}`, argv, {
+                cwd: place ? resolve(orchestra.resolveConfig(place.rootDir)) : undefined,
+                stdio: "inherit",
+                env: generateEnv(orchestra, place),
+            });
+            if (fullConfig.waitForExit) {
+                child.on("exit", (code) => {
+                    if (code !== 0 && !fullConfig.ignoreNonZeroExitCode)
+                        reject(code);
+                    resolvePromise();
+                });
+            }
+            else {
+                resolvePromise();
+            }
+        });
+    });
+}
+export function script(path, config = {}) {
+    return sh(`${resolve(path)}`, config);
+}
+//# sourceMappingURL=script.js.map

package/dist/src/helpers/script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"script.js","sourceRoot":"","sources":["../../../src/helpers/script.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,OAAO,EAAqC,GAAG,EAAS,MAAM,qBAAqB,CAAC;AAcpF,MAAM,oBAAoB,GAAgB;IACzC,WAAW,EAAE,IAAI;IACjB,qBAAqB,EAAE,KAAK;CAC5B,CAAC;AAEF,SAAS,WAAW,CACnB,SAAuB,EACvB,KAAsB;IAEtB,OAAO;QACN,GAAG,OAAO,CAAC,GAAG;QACd,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC;QAC3B,cAAc,EAAE,SAAS,CAAC,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC;QACvE,YAAY,EAAE,SAAS,CAAC,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC;QACnE,QAAQ,EAAE,KAAK,IAAI,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE;QACrE,aAAa,EAAE,KAAK,IAAI,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE;KAC/E,CAAC;AACH,CAAC;AAED,MAAM,UAAU,EAAE,CAAyB,GAAW,EAAE,SAA+B,EAAE;IACxF,MAAM,UAAU,GAAG;QAClB,GAAG,oBAAoB;QACvB,GAAG,MAAM;KACT,CAAC;IAEF,OAAO,GAAG,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,GAAG,EAAE,EAAE,EAAE;QAC1C,OAAO,IAAI,OAAO,CAAC,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE;YAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,GAAG,EAAE,EAAE,IAAI,EAAE;gBACnC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;gBACxE,KAAK,EAAE,SAAS;gBAChB,GAAG,EAAE,WAAW,CAAC,SAAS,EAAE,KAAK,CAAC;aAClC,CAAC,CAAC;YAEH,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC;gBAC5B,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;oBACzB,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,qBAAqB;wBAAE,MAAM,CAAC,IAAI,CAAC,CAAC;oBAClE,cAAc,EAAE,CAAC;gBAClB,CAAC,CAAC,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACP,cAAc,EAAE,CAAC;YAClB,CAAC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC;AACD,MAAM,UAAU,MAAM,CAAyB,IAAY,EAAE,SAA+B,EAAE;IAC7F,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;AACvC,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./commands";
+export * from "./orchestra";
+export * from "./helpers/release";
+export * from "./helpers/script";

package/dist/src/index.js

@@ -0,0 +1,5 @@
+export * from "./commands";
+export * from "./orchestra";
+export * from "./helpers/release";
+export * from "./helpers/script";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}

package/dist/src/logger.d.ts

@@ -0,0 +1 @@
+export declare const logger: import("consola").ConsolaInstance;

package/dist/src/logger.js

@@ -0,0 +1,3 @@
+import { createConsola } from "consola";
+export const logger = createConsola({});
+//# sourceMappingURL=logger.js.map

package/dist/src/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,MAAM,CAAC,MAAM,MAAM,GAAG,aAAa,CAAC,EAAE,CAAC,CAAC"}

package/dist/src/orchestra/config.d.ts

@@ -0,0 +1,86 @@
+import { Orchestra } from "./orchestra";
+/**
+ * A value that is resolved using the Orchestra context
+ */
+export type Value<E extends Environments, T> = (orchestra: Orchestra<E>) => T;
+/**
+ * Allow either a raw value or a computed one
+ */
+export type MaybeValue<E extends Environments, T> = T | Value<E, T>;
+/**
+ * Resolve a MaybeValue at runtime
+ */
+export declare function resolveValue<E extends Environments, T>(value: MaybeValue<E, T>, orchestra: Orchestra<E>): T;
+/**
+ * Helper to wrap static values
+ */
+export declare function val<E extends Environments, T>(value: T): Value<E, T>;
+/**
+ * Environment-based value helper
+ */
+export declare function env<V extends Record<string, unknown>>(values: V): <E extends { [K in keyof V]: EnvironmentConfig; }>(orchestra: Orchestra<E>) => V[keyof V];
+export type Script<E extends Environments> = (orchestra: Orchestra<E>, place?: PlaceConfig<E>, argv?: string[]) => Promise<void> | void;
+/**
+ * A configuration for a place managed by an Orchestra
+ */
+export interface PlaceConfig<E extends Environments> {
+    rootDir: MaybeValue<E, string>;
+    placeId: MaybeValue<E, number>;
+    experienceId: MaybeValue<E, number>;
+    scripts: {
+        /**
+         * A callback that runs when this place is built by the Orchestra
+         */
+        [k: string]: MaybeValue<E, Script<E>>;
+    };
+}
+/**
+ * A configuration for a specific environment within an Orchestra
+ */
+export interface EnvironmentConfig {
+    /**
+     * Whether to use this environment as the default if no other environments are chosen
+     */
+    default?: boolean;
+    /**
+     * The NODE_ENV value that will result in this environment being chosen
+     */
+    nodeEnv?: string;
+}
+/**
+ * A list of environments available to an Orchestra
+ */
+export type Environments = {
+    [k: string]: EnvironmentConfig;
+};
+/**
+ * A configuration for an Orchestra
+ */
+export interface OrchestraConfig<E extends Environments> {
+    /**
+     * Semantic version
+     */
+    releaseNumber: string;
+    /**
+     * Human-friendly release name
+     */
+    releaseName: string;
+    /**
+     * Available environments
+     */
+    environments: E;
+    scripts?: {
+        /**
+         * Callback that runs before any scripts are run
+         */
+        prepare?: MaybeValue<E, Script<E>>;
+    } & Record<string, MaybeValue<E, Script<E>>>;
+    /**
+     * Places in this experience
+     */
+    places: [PlaceConfig<E>, ...PlaceConfig<E>[]];
+}
+/**
+ * Create an Orchestra config
+ */
+export declare function orchestraConfig<const E extends Environments>(experience: OrchestraConfig<E>): OrchestraConfig<E>;

package/dist/src/orchestra/config.js

@@ -0,0 +1,27 @@
+/**
+ * Resolve a MaybeValue at runtime
+ */
+export function resolveValue(value, orchestra) {
+    return typeof value === "function" ? value(orchestra) : value;
+}
+/**
+ * Helper to wrap static values
+ */
+export function val(value) {
+    return () => value;
+}
+/**
+ * Environment-based value helper
+ */
+export function env(values) {
+    return (orchestra) => {
+        return values[orchestra.environment];
+    };
+}
+/**
+ * Create an Orchestra config
+ */
+export function orchestraConfig(experience) {
+    return experience;
+}
+//# sourceMappingURL=config.js.map

package/dist/src/orchestra/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/orchestra/config.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,MAAM,UAAU,YAAY,CAA4B,KAAuB,EAAE,SAAuB;IACvG,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAE,KAAqB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAChF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,GAAG,CAA4B,KAAQ;IACtD,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,GAAG,CAAoC,MAAS;IAC/D,OAAO,CAAkD,SAAuB,EAAc,EAAE;QAC/F,OAAO,MAAM,CAAC,SAAS,CAAC,WAAsB,CAAC,CAAC;IACjD,CAAC,CAAC;AACH,CAAC;AA8ED;;GAEG;AACH,MAAM,UAAU,eAAe,CAA+B,UAA8B;IAC3F,OAAO,UAAU,CAAC;AACnB,CAAC"}

package/dist/src/orchestra/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./config";
+export * from "./orchestra";

package/dist/src/orchestra/index.js

@@ -0,0 +1,3 @@
+export * from "./config";
+export * from "./orchestra";
+//# sourceMappingURL=index.js.map

package/dist/src/orchestra/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/orchestra/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}

package/dist/src/orchestra/orchestra.d.ts

@@ -0,0 +1,11 @@
+import { Environments, MaybeValue, OrchestraConfig } from "./config";
+export declare const ORCHESTRA_CONFIG_FILENAME = "orchestra.config.ts";
+export declare class Orchestra<E extends Environments> {
+    readonly config: OrchestraConfig<E>;
+    static fromDirectory(directoryPath: string): Promise<Orchestra<never>>;
+    static fromFileConfig(filePath: string): Promise<Orchestra<never>>;
+    readonly environment: keyof E;
+    constructor(config: OrchestraConfig<E>);
+    runScripts(scriptName: string, argv?: string[]): Promise<void>;
+    resolveConfig<T>(config: MaybeValue<E, T>): T;
+}

package/dist/src/orchestra/orchestra.js

@@ -0,0 +1,45 @@
+import assert from "assert";
+import { createJiti } from "jiti";
+import { resolve } from "path";
+import { resolveValue } from "./config";
+const jiti = createJiti(__filename);
+export const ORCHESTRA_CONFIG_FILENAME = "orchestra.config.ts";
+export class Orchestra {
+    config;
+    static async fromDirectory(directoryPath) {
+        return await Orchestra.fromFileConfig(resolve(directoryPath, ORCHESTRA_CONFIG_FILENAME));
+    }
+    static async fromFileConfig(filePath) {
+        const config = await jiti.import(resolve(filePath), {
+            default: true,
+        });
+        return new Orchestra(config);
+    }
+    environment;
+    constructor(config) {
+        this.config = config;
+        for (const [environmentName, environmentConfig] of Object.entries(config.environments)) {
+            if (this.environment)
+                continue;
+            const NODE_ENV = process.env.NODE_ENV ?? "unknown";
+            if (environmentConfig.default) {
+                this.environment = environmentName;
+            }
+            else if (NODE_ENV == environmentConfig.nodeEnv) {
+                this.environment = environmentName;
+            }
+        }
+        assert(this.environment, `Orchestra confiag is invalid, no default or otherwise valid environments provided`);
+    }
+    async runScripts(scriptName, argv) {
+        await this.resolveConfig(this.config.scripts?.prepare)?.(this, undefined, argv);
+        await this.resolveConfig(this.config.scripts?.[scriptName])?.(this, undefined, argv);
+        for (const place of this.config.places) {
+            await this.resolveConfig(place.scripts[scriptName])?.(this, place, argv);
+        }
+    }
+    resolveConfig(config) {
+        return resolveValue(config, this);
+    }
+}
+//# sourceMappingURL=orchestra.js.map

package/dist/src/orchestra/orchestra.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestra.js","sourceRoot":"","sources":["../../../src/orchestra/orchestra.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,OAAO,EAA6C,YAAY,EAAE,MAAM,UAAU,CAAC;AAEnF,MAAM,IAAI,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;AAEpC,MAAM,CAAC,MAAM,yBAAyB,GAAG,qBAAqB,CAAC;AAE/D,MAAM,OAAO,SAAS;IAeO;IAdrB,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,aAAqB;QACtD,OAAO,MAAM,SAAS,CAAC,cAAc,CAAC,OAAO,CAAC,aAAa,EAAE,yBAAyB,CAAC,CAAC,CAAC;IAC1F,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,QAAgB;QAClD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;YACnD,OAAO,EAAE,IAAI;SACb,CAAC,CAAC;QAEH,OAAO,IAAI,SAAS,CAAC,MAAgC,CAAC,CAAC;IACxD,CAAC;IAEe,WAAW,CAAU;IAErC,YAA4B,MAA0B;QAA1B,WAAM,GAAN,MAAM,CAAoB;QACrD,KAAK,MAAM,CAAC,eAAe,EAAE,iBAAiB,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;YACxF,IAAI,IAAK,CAAC,WAAW;gBAAE,SAAS;YAChC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,SAAS,CAAC;YACnD,IAAI,iBAAiB,CAAC,OAAO,EAAE,CAAC;gBAC/B,IAAI,CAAC,WAAW,GAAG,eAAe,CAAC;YACpC,CAAC;iBAAM,IAAI,QAAQ,IAAI,iBAAiB,CAAC,OAAO,EAAE,CAAC;gBAClD,IAAI,CAAC,WAAW,GAAG,eAAe,CAAC;YACpC,CAAC;QACF,CAAC;QACD,MAAM,CAAC,IAAK,CAAC,WAAW,EAAE,mFAAmF,CAAC,CAAC;IAChH,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,UAAkB,EAAE,IAAe;QAC1D,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;QAEhF,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;QAErF,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACxC,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QAC1E,CAAC;IACF,CAAC;IAEM,aAAa,CAAI,MAAwB;QAC/C,OAAO,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;CACD"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "rbxts-orchestra",
+  "version": "0.1.0-dev.0",
+  "description": "A build orchestrator.",
+  "main": "src/index.ts",
+  "bin": {
+    "orchestra": "./bin/run"
+  },
+  "directories": {
+    "lib": "src",
+    "bin": "bin"
+  },
+  "files": [
+    "dist",
+    "bin/run"
+  ],
+  "scripts": {
+    "build": "tsup-node && tsc",
+    "build:watch": "tsup-node --watch",
+    "clean": "rimraf dist",
+    "compile": "tsc",
+    "format": "prettier . --check",
+    "format:fix": "prettier . --write",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "start": "ts-node ./bin/run.ts",
+    "start:node": "node ./bin/run",
+    "prepublish": "npm run build"
+  },
+  "devDependencies": {
+    "@tsconfig/node20": "^20.1.4",
+    "@types/node": "^20.12.12",
+    "@types/yargs": "^17.0.32",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-prettier": "^5.5.4",
+    "eslint-plugin-unused-imports": "^4.3.0",
+    "prettier": "^3.7.4",
+    "rimraf": "^5.0.7",
+    "ts-node": "^10.9.2",
+    "tsup": "^8.0.2",
+    "typescript": "^5.5.3",
+    "typescript-eslint": "^8.51.0"
+  },
+  "dependencies": {
+    "consola": "^3.2.3",
+    "picocolors": "^1.0.1",
+    "yargs": "^17.7.2",
+    "jiti": "^2.6.1"
+  }
+}

package/src/index.ts

@@ -0,0 +1,4 @@
+export * from "./commands";
+export * from "./orchestra";
+export * from "./helpers/release";
+export * from "./helpers/script";