@saws/cli 2.0.0-beta.2 → 2.0.0-beta.3

package/src/commands/host/index.ts

@@ -0,0 +1,18 @@
+import { Command } from "commander";
+import { configureHostCommand } from "./command.js";
+
+export const createCommand = () =>
+  new Command("host")
+    .description("configure deployment hosts")
+    .addCommand(
+      new Command("configure")
+        .description("bootstrap a deployment user and apply host security policy")
+        .argument("[name]", "host name; optional when exactly one host exists")
+        .requiredOption(
+          "--user <bootstrap-user>",
+          "existing SSH account used for initial configuration",
+        )
+        .option("--config <path>", "path to saws.ts")
+        .option("--dry-run", "describe configuration without making changes")
+        .action(configureHostCommand),
+    );

package/src/commands/init/command.ts

@@ -0,0 +1,28 @@
+import path from "node:path";
+import fs from "node:fs/promises";
+import { findServiceDefinition, getSawsConfig } from "@saws/core";
+import { installDependencies } from "@saws/core/utils/dependency-management";
+import { createFileIfNotExists } from "@saws/core/utils/create-file-if-not-exists";
+import { sawsTsTemplate } from "./templates/saws-ts.template.js";
+import { tsconfigJsonTemplate } from "./templates/tsconfig-json.template.js";
+import { gitignoreTemplate } from "./templates/gitignore.template.js";
+
+export const initCommand = async (serviceName?: string, configPath?: string) => {
+  if (serviceName != null) {
+    const serviceDefinition = await getSawsConfig(configPath);
+    await findServiceDefinition(serviceDefinition, serviceName).init();
+    return;
+  }
+
+  const name = path.parse(path.resolve(".")).name;
+
+  // not used for now
+  await installDependencies([]);
+  await installDependencies(["@saws/core", "typescript", "@tsconfig/node26"], {
+    development: true,
+  });
+
+  await fs.writeFile("./tsconfig.json", tsconfigJsonTemplate(), {});
+  await createFileIfNotExists("./saws.ts", sawsTsTemplate({ name }));
+  await createFileIfNotExists("./.gitignore", gitignoreTemplate());
+};

package/src/commands/init/index.ts

@@ -0,0 +1,8 @@
+import { Command } from "commander";
+import { initCommand } from "./command.js";
+
+export const createCommand = () =>
+  new Command("init")
+    .argument("[service]", "name of the service to initialize")
+    .argument("[config]", "path to service definition")
+    .action(initCommand);

package/src/commands/init/templates/gitignore.template.ts

@@ -0,0 +1,4 @@
+export const gitignoreTemplate = () => `node_modules
+.saws/saws-*-local-output.json
+.saws/.secrets
+.DS_Store`;

package/src/commands/init/templates/saws-ts.template.ts

@@ -0,0 +1,8 @@
+export const sawsTsTemplate = ({ name }: { name: string }) =>
+  `import { ServiceDefinition } from "@saws/core";
+
+export default new ServiceDefinition({
+  name: "${name}",
+  dependencies: [],
+});
+`;

package/src/commands/init/templates/tsconfig-json.template.ts

@@ -0,0 +1,4 @@
+export const tsconfigJsonTemplate = () => /* json */ `{
+  "extends": "@tsconfig/node26/tsconfig.json",
+  "files": []
+}`;

package/src/commands/secrets/command.ts

@@ -0,0 +1,42 @@
+import { getSawsConfigModule, SecretsManager, type GlobalSecrets } from "@saws/core";
+
+export interface SecretsCommandOptions {
+  config?: string;
+  stage?: string;
+  global?: boolean;
+  set?: string;
+  get?: boolean;
+}
+
+export async function secretsCommand(name: string, options: SecretsCommandOptions) {
+  const value = options.set;
+  if (options.get && value != null) {
+    throw new Error("secrets accepts only one of --get or --set <value>");
+  }
+  if (!options.get && value == null) {
+    throw new Error("secrets requires either --get or --set <value>");
+  }
+
+  if (!options.global) {
+    process.env.STAGE = options.stage ?? "local";
+  }
+
+  const config = await getSawsConfigModule(options.config);
+  const manager = config.secrets;
+  if (!(manager instanceof SecretsManager)) {
+    throw new Error('saws.ts must export a SecretsManager instance named "secrets"');
+  }
+
+  const secrets: SecretsManager | GlobalSecrets = options.global ? manager.global : manager;
+
+  if (options.get) {
+    console.log(await secrets.get(name));
+    return;
+  }
+
+  if (value == null) {
+    throw new Error("secrets requires --set <value>");
+  }
+  await secrets.set(name, value);
+  console.log("Set secret");
+}

package/src/commands/secrets/index.ts

@@ -0,0 +1,13 @@
+import { Command } from "commander";
+import { secretsCommand } from "./command.js";
+
+export const createCommand = () =>
+  new Command("secrets")
+    .description("get or set encrypted project secrets")
+    .argument("<name>", "secret name")
+    .option("--stage <string>", "stage for a stage-scoped secret", "local")
+    .option("--global", "use the global secret scope")
+    .option("--set <string>", "set the secret value")
+    .option("--get", "get the secret value")
+    .option("--config <string>", "path to service definition")
+    .action(secretsCommand);

package/src/hosts.ts

@@ -0,0 +1,21 @@
+import { Host, type ServiceDefinition } from "@saws/core";
+
+export function findConfiguredHosts(root: ServiceDefinition) {
+  const hosts = new Set<Host>();
+  const visited = new WeakSet<object>();
+
+  const visit = (value: unknown) => {
+    if (value == null || typeof value !== "object" || visited.has(value)) return;
+    visited.add(value);
+
+    if (value instanceof Host) {
+      hosts.add(value);
+      return;
+    }
+
+    for (const child of Object.values(value)) visit(child);
+  };
+
+  visit(root);
+  return [...hosts];
+}

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig-node.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "tsBuildInfoFile": "./dist/.tsbuildinfo",
+    "types": ["find-package-json"]
+  }
+}

package/dist/bin/saws.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"saws.d.ts","sourceRoot":"","sources":["../../src/bin/saws.ts"],"names":[],"mappings":""}

package/dist/commands/deploy/command.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/commands/deploy/command.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,EAAE,oBAAoB,iBA2B9B"}

package/dist/commands/deploy/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/deploy/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,eAAO,MAAM,aAAa,eAOA,CAAC"}

package/dist/commands/dev/command.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/commands/dev/command.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,EAAE,iBAAiB,iBAoD3B"}

package/dist/commands/dev/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/dev/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,eAAO,MAAM,aAAa,eAMH,CAAC"}

package/dist/commands/dev/tui/dev-tui.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dev-tui.d.ts","sourceRoot":"","sources":["../../../../src/commands/dev/tui/dev-tui.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAmB,cAAc,EAAE,MAAM,YAAY,CAAC;AAkBlE,qBAAa,MAAM;IACjB,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAiC;IAEjE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiC;IACtD,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;gBAErB,QAAQ,EAAE,MAAM,EAAE;IAQ9B,KAAK;IAkBL,IAAI;IAUJ,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,QAAQ,GAAG,QAAmB;IAStE,OAAO,CAAC,cAAc,CAqBpB;IAEF,OAAO,CAAC,MAAM;IAkBd,OAAO,CAAC,MAAM,CA6BZ;CACH"}

package/dist/commands/host/command.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/commands/host/command.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGvC,MAAM,WAAW,2BAA2B;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,EAAE,2BAA2B,iBAOrC;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM,QAmBtD"}

package/dist/commands/host/command.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=command.test.d.ts.map

package/dist/commands/host/command.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"command.test.d.ts","sourceRoot":"","sources":["../../../src/commands/host/command.test.ts"],"names":[],"mappings":""}

package/dist/commands/host/command.test.js

@@ -1,13 +0,0 @@
-import assert from "node:assert/strict";
-import test from "node:test";
-import { Host } from "@saws/host";
-import { selectHost } from "./command.js";
-const first = new Host({ name: "first", address: "first.example.test" });
-const second = new Host({ name: "second", address: "second.example.test" });
-test("selects the only configured host when its name is omitted", () => {
-    assert.equal(selectHost([first]), first);
-});
-test("requires a valid name when several hosts are configured", () => {
-    assert.throws(() => selectHost([second, first]), /Host name is required\. Available hosts: first, second/);
-    assert.throws(() => selectHost([first, second], "missing"), /Host "missing" was not found\. Available hosts: first, second/);
-});

package/dist/commands/host/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/host/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,eAAO,MAAM,aAAa,eAUrB,CAAC"}

package/dist/commands/init/command.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/commands/init/command.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,EAAE,kBAAkB,iBAiB5B"}

package/dist/commands/init/command.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=command.test.d.ts.map

package/dist/commands/init/command.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"command.test.d.ts","sourceRoot":"","sources":["../../../src/commands/init/command.test.ts"],"names":[],"mappings":""}

package/dist/commands/init/command.test.js

@@ -1,40 +0,0 @@
-import assert from "node:assert/strict";
-import { mkdtemp, readFile, writeFile } from "node:fs/promises";
-import os from "node:os";
-import path from "node:path";
-import test from "node:test";
-import { pathToFileURL } from "node:url";
-import { initCommand } from "./command.js";
-test("initializes only the selected service branch in dependency order", async () => {
-    const directory = await mkdtemp(path.join(os.tmpdir(), "saws-init-"));
-    const configPath = path.join(directory, "saws.mjs");
-    const packageUrl = pathToFileURL(path.resolve("../core/dist/index.js")).href;
-    await writeFile(configPath, `
-      import { appendFile } from "node:fs/promises";
-      import path from "node:path";
-      import { ServiceDefinition } from ${JSON.stringify(packageUrl)};
-
-      class InitializableService extends ServiceDefinition {
-        async onInit(context) {
-          await appendFile(path.join(context.rootDir, "initialized.txt"), this.name + "\\n");
-        }
-      }
-
-      const shared = new InitializableService({ name: "shared" });
-      const api = new InitializableService({
-        name: "api",
-        dependencies: [shared],
-      });
-      const worker = new InitializableService({ name: "worker" });
-
-      export default new InitializableService({
-        name: "app",
-        dependencies: [api, worker],
-      });
-    `);
-    await initCommand("api", undefined, {
-        config: configPath,
-        rootDir: directory,
-    });
-    assert.equal(await readFile(path.join(directory, "initialized.txt"), "utf8"), "shared\napi\n");
-});

package/dist/commands/init/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/init/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,eAAO,MAAM,aAAa,eAQF,CAAC"}

package/dist/commands/secrets/command.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/commands/secrets/command.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,qBAAqB,iBAkB/B"}

package/dist/commands/secrets/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/secrets/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,eAAO,MAAM,aAAa,eAOC,CAAC"}

package/dist/hosts.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hosts.d.ts","sourceRoot":"","sources":["../src/hosts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAClC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,UAkB1D"}