seamless-cli 0.2.0

package/LICENSE

@@ -0,0 +1,79 @@
+GNU AFFERO GENERAL PUBLIC LICENSE
+Version 3, 19 November 2007
+
+Copyright (C) 2007 Free Software Foundation, Inc.
+<https://fsf.org/>
+Everyone is permitted to copy and distribute verbatim copies
+of this license document, but changing it is not allowed.
+
+This license is identical to the GNU General Public License, except that it also
+ensures that software running as a network service makes its source code
+available to users.
+
+---
+
+TERMS AND CONDITIONS
+
+0. Definitions.
+
+“This License” refers to version 3 of the GNU Affero General Public License.
+
+“Copyright” also means copyright-like laws that apply to other kinds of works,
+such as semiconductor masks.
+
+The “Program” refers to any copyrightable work licensed under this License.
+Each licensee is addressed as “you”.
+
+To “modify” a work means to copy from or adapt all or part of the work in a
+fashion requiring copyright permission, other than the making of an exact copy.
+
+To “propagate” a work means to do anything with it that, without permission,
+would make you directly or secondarily liable for infringement under applicable
+copyright law, except executing it on a computer or modifying a private copy.
+
+To “convey” a work means any kind of propagation that enables other parties to
+make or receive copies.
+
+An interactive user interface displays “Appropriate Legal Notices” to the extent
+that it includes a convenient and prominently visible feature that displays an
+appropriate copyright notice, and tells the user that there is no warranty for
+the work (except to the extent that warranties are provided), that licensees may
+convey the work under this License, and how to view a copy of this License.
+
+---
+
+13. Remote Network Interaction; Use with the GNU General Public License.
+
+Notwithstanding any other provision of this License, if you modify the Program,
+your modified version must prominently offer all users interacting with it
+remotely through a computer network an opportunity to receive the Corresponding
+Source of your version by providing access to the Corresponding Source from a
+network server at no charge, through some standard or customary means of
+facilitating copying of software.
+
+---
+
+15. Disclaimer of Warranty.
+
+THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
+EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER
+PARTIES PROVIDE THE PROGRAM “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER
+EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+
+---
+
+16. Limitation of Liability.
+
+IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY
+COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS
+PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,
+INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE
+THE PROGRAM.
+
+---
+
+END OF TERMS AND CONDITIONS
+
+You should have received a copy of the GNU Affero General Public License along
+with this program. If not, see <https://www.gnu.org/licenses/>.

package/LICENSE.md

@@ -0,0 +1,26 @@
+# License
+
+Seamless CLI ("seamless-cli") is licensed under the **GNU Affero General Public License v3.0 (AGPL-3.0-only)**.
+
+- SPDX: `AGPL-3.0-only`
+
+## What this means (high level)
+
+- You are free to **use**, **modify**, and **self-host** this software.
+- If you **modify** this software and **run it as a network service** (for example, hosting it for others to use), you must **make the complete corresponding source code of your modified version available** to users of that service, under the AGPL.
+
+This summary is not legal advice and does not replace the license text.
+
+## Full license text
+
+The full license text is available here:
+
+- https://www.gnu.org/licenses/agpl-3.0.html
+
+You should include a copy of the AGPLv3 license in your distribution. If this repository does not contain the full license text yet, add it as `LICENSE` or `LICENSE.txt` (recommended), and keep this `LICENSE.md` as the human-friendly summary.
+
+## Commercial licensing
+
+If you would like to embed Seamless Auth API into a proprietary product, redistribute it under different terms, or offer it as a managed service without AGPL obligations, commercial licensing may be available.
+
+Contact: support@seamlessauth.com

package/README.md

@@ -0,0 +1,238 @@
+# Seamless CLI
+
+[![License: AGPL-3.0-only](https://img.shields.io/badge/License-AGPL3-yellow.svg)](LICENSE)
+[![npm version](https://img.shields.io/npm/v/seamless-cli.svg?style=flat)](https://www.npmjs.com/package/seamless-cli)
+
+Seamless CLI is a command-line tool for bootstrapping applications with Seamless Auth, an open source, passwordless authentication system.
+
+It guides you through creating a fully working authentication stack with a web app, API, and auth server that are already connected and ready to run.
+
+---
+
+## Getting started
+
+Run the CLI with `npx`:
+
+```bash
+npx seamless-cli init my-app
+```
+
+Or run it in your current directory:
+
+```bash
+npx seamless-cli init
+```
+
+You’ll be guided through a short setup process where you can choose:
+
+- Whether to create a web application
+- Whether to create an API server
+- How to run the auth server (local or Docker)
+- Whether to run everything with Docker
+
+---
+
+## What gets created
+
+Depending on your selections, the CLI generates a project like this:
+
+```text
+my-app/
+├─ auth/        # Seamless Auth server (optional)
+├─ web/         # React web application (optional)
+├─ api/         # Express API server (optional)
+├─ docker-compose.yml (optional)
+└─ README.md
+```
+
+All services are preconfigured to work together.
+
+- Web calls the API
+- API communicates with the auth server
+- Auth manages sessions and tokens
+
+No manual wiring is required.
+
+---
+
+## Running your project
+
+### Option 1: Docker
+
+If you choose Docker during setup:
+
+```bash
+docker compose up
+```
+
+This starts:
+
+- PostgreSQL
+- Auth server
+- API server
+- Web app
+
+All services are configured to communicate correctly inside the container network.
+
+---
+
+### Option 2: Local development
+
+If you choose to run locally:
+
+#### 1. Start PostgreSQL
+
+Make sure you have a local PostgreSQL instance running on port `5432`.
+
+---
+
+#### 2. Start the auth server
+
+```bash
+cd auth
+npm install
+
+npm run db:create
+npm run db:migrate
+
+npm run dev
+```
+
+---
+
+#### 3. Start the API
+
+```bash
+cd api
+npm install
+npm run dev
+```
+
+---
+
+#### 4. Start the web app
+
+```bash
+cd web
+npm install
+npm run dev
+```
+
+---
+
+## What is configured for you
+
+Seamless CLI handles the parts that are usually difficult to get right:
+
+- Shared API service tokens
+- JWT signing configuration
+- JWKS key generation for production mode
+- Cross-service environment variables
+- CORS and cookie-based session handling
+
+Everything is aligned across services so the system works immediately after setup.
+
+---
+
+## Included projects
+
+Seamless CLI pulls from the following repositories:
+
+- Seamless Auth API
+  [https://github.com/fells-code/seamless-auth-api](https://github.com/fells-code/seamless-auth-api)
+
+- Seamless Auth React Starter
+  [https://github.com/fells-code/seamless-auth-starter-react](https://github.com/fells-code/seamless-auth-starter-react)
+
+- Seamless Auth API Starter
+  [https://github.com/fells-code/seamless-auth-starter-express](https://github.com/fells-code/seamless-auth-starter-express)
+
+Each project can be used independently, but the CLI connects them into a working system.
+
+---
+
+## Documentation
+
+Full documentation is available at:
+
+[https://docs.seamlessauth.com](https://docs.seamlessauth.com)
+
+---
+
+## Philosophy
+
+Seamless Auth is built around a few principles:
+
+- Passwordless authentication only
+- No redirects or third-party auth providers
+- Self-hosted by default
+- Production-shaped local development
+- Explicit configuration over hidden behavior
+
+Seamless CLI exists to make this setup fast and repeatable.
+
+---
+
+## Requirements
+
+- Node.js 18 or newer
+- npm or pnpm
+- Docker (optional)
+
+---
+
+## Testing local CLI changes
+
+From the repository root, build the CLI and link the local package:
+
+```bash
+npm install
+npm run build
+npm link
+```
+
+Then run the linked command:
+
+```bash
+seamless --version
+seamless --help
+```
+
+When you are done testing, remove the global link:
+
+```bash
+npm unlink -g seamless-cli
+```
+
+To smoke test the package artifact before publishing:
+
+```bash
+npm run build
+TARBALL=$(npm pack --pack-destination /tmp)
+TEST_DIR=$(mktemp -d)
+
+cd "$TEST_DIR"
+npm install "/tmp/$TARBALL"
+npm exec -- seamless --version
+npm exec -- seamless --help
+```
+
+If npm cache permissions block local testing, use a writable temporary cache:
+
+```bash
+npm --cache /tmp/npm-cache exec -- seamless --version
+```
+
+---
+
+## License
+
+AGPL-3.0-only © 2026 Fells Code LLC
+
+This license ensures:
+
+- transparency of security-critical code
+- freedom to self-host and modify
+- sustainability of the managed service offering
+
+See `LICENSE` for details.

package/dist/commands/bootstrapAdmin.js

@@ -0,0 +1,96 @@
+import fs from "fs";
+import path from "path";
+import { intro, outro, text, confirm, spinner } from "@clack/prompts";
+import kleur from "kleur";
+import { resolveBootstrapSecret } from "../core/bootstrapSecret.js";
+function loadConfig() {
+    const configPath = path.join(process.cwd(), "seamless.config.json");
+    if (!fs.existsSync(configPath)) {
+        throw new Error("No seamless.config.json found. Run init first.");
+    }
+    return JSON.parse(fs.readFileSync(configPath, "utf-8"));
+}
+export async function runBootstrapAdmin(emailArg) {
+    intro("Seamless Auth Bootstrap");
+    const config = loadConfig();
+    let email = emailArg;
+    if (!email) {
+        email = (await text({
+            message: "Admin email address",
+            placeholder: "admin@example.com",
+            validate: (value) => {
+                if (!value || !value.includes("@")) {
+                    return "Enter a valid email address";
+                }
+            },
+        }));
+    }
+    const proceed = await confirm({
+        message: "Create bootstrap admin invite?",
+        initialValue: true,
+    });
+    if (!proceed) {
+        outro("Cancelled.");
+        return;
+    }
+    let apiUrl = process.env.SEAMLESS_API_URL;
+    if (!apiUrl) {
+        apiUrl = "http://localhost:3000";
+    }
+    let secret = resolveBootstrapSecret();
+    if (secret) {
+        console.log(kleur.gray("Using bootstrap secret from local environment"));
+    }
+    else {
+        console.log("");
+        console.log(kleur.yellow("No bootstrap secret detected automatically."));
+        console.log("This may happen if the project is not initialized locally or running in production.");
+        secret = (await text({
+            message: "Bootstrap secret",
+            placeholder: "Enter your bootstrap secret",
+            validate: (value) => {
+                if (!value)
+                    return "Bootstrap secret is required";
+            },
+        }));
+    }
+    const s = spinner();
+    s.start("Creating bootstrap invite...");
+    try {
+        const res = await fetch(`${apiUrl}/auth/internal/bootstrap/admin-invite`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${secret}`,
+            },
+            body: JSON.stringify({ email }),
+        });
+        const data = await res.json();
+        if (!res.ok) {
+            s.stop("Failed");
+            console.error(kleur.red("Error creating bootstrap invite"));
+            console.error(data);
+            process.exit(1);
+        }
+        s.stop("Done");
+        console.log("");
+        if (data?.data?.url) {
+            console.log(kleur.bold("Registration URL"));
+            console.log(kleur.cyan(data.data.url));
+        }
+        else {
+            console.log(kleur.green(`Invite sent to ${email}`));
+        }
+        console.log("");
+        console.log("Next step:");
+        console.log("The invited user must complete registration to receive admin access.");
+        outro("Bootstrap complete.");
+    }
+    catch (err) {
+        s.stop("Failed");
+        console.error(kleur.red("Unexpected error"));
+        console.error(err.message);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=bootstrapAdmin.js.map

package/dist/commands/bootstrapAdmin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrapAdmin.js","sourceRoot":"","sources":["../../src/commands/bootstrapAdmin.ts"],"names":[],"mappings":"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"}

package/dist/commands/check.js

@@ -0,0 +1,92 @@
+import fs from "fs";
+import path from "path";
+import { execSync } from "child_process";
+export async function runCheck() {
+    console.log("\nSeamless Check\n");
+    const root = process.cwd();
+    const configPath = path.join(root, "seamless.config.json");
+    if (!fs.existsSync(configPath)) {
+        console.log("✖ seamless.config.json not found");
+        console.log("→ Run: seamless init\n");
+        return;
+    }
+    console.log("✔ Config file found");
+    const config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+    checkStructure(root, config);
+    checkDocker();
+    checkCompose(root, config);
+    checkContainers();
+    await checkHealth();
+    console.log("\nCheck complete.\n");
+}
+function checkStructure(root, config) {
+    const services = config.services;
+    if (fs.existsSync(path.join(root, services.web.path))) {
+        console.log("✔ Web project detected");
+    }
+    else {
+        console.log("✖ Web project missing");
+    }
+    if (fs.existsSync(path.join(root, services.api.path))) {
+        console.log("✔ API project detected");
+    }
+    else {
+        console.log("✖ API project missing");
+    }
+}
+function checkDocker() {
+    try {
+        execSync("docker --version", { stdio: "ignore" });
+        console.log("✔ Docker is installed");
+    }
+    catch {
+        console.log("✖ Docker not found");
+        console.log("→ Install Docker: https://docs.docker.com/get-docker/");
+    }
+}
+function checkCompose(root, config) {
+    const composePath = path.join(root, config.docker.composeFile);
+    if (fs.existsSync(composePath)) {
+        console.log("✔ Docker Compose file found");
+    }
+    else {
+        console.log("✖ docker-compose.yml missing");
+    }
+}
+function checkContainers() {
+    try {
+        const output = execSync("docker ps --format '{{.Names}}'").toString();
+        if (!output.includes("api")) {
+            console.log("✖ API container not running");
+            console.log("→ Run: docker compose up\n");
+        }
+        else {
+            console.log("✔ Containers running");
+        }
+    }
+    catch {
+        console.log("✖ Failed to check containers");
+    }
+}
+async function checkHealth() {
+    const checks = [
+        { name: "API", url: "http://localhost:3000/" },
+        { name: "Auth", url: "http://localhost:5312/health/status" },
+        { name: "Admin", url: "http://localhost:5174" },
+    ];
+    for (const check of checks) {
+        try {
+            const res = await fetch(check.url);
+            if (res.ok) {
+                console.log(`✔ ${check.name} is healthy`);
+            }
+            else {
+                console.log(`✖ ${check.name} returned ${res.status}`);
+            }
+        }
+        catch {
+            console.log(`✖ ${check.name} not reachable`);
+        }
+    }
+}
+//# sourceMappingURL=check.js.map

package/dist/commands/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"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"}

package/dist/commands/contribute.js

@@ -0,0 +1,121 @@
+import fs from "fs";
+import path from "path";
+import kleur from "kleur";
+import * as p from "@clack/prompts";
+import { CONTRIBUTOR_COMPONENTS, formatPublicRef, resolveCloneSource, resolveWorkspaceDir, } from "../contributor/catalog.js";
+import { configureContributorWorkspace } from "../contributor/workspace.js";
+import { runContributorSetupPrompts } from "../prompts/contributeSetup.js";
+import { cloneRepo } from "../utils/repoUtils.js";
+import { runCommand } from "../core/exec.js";
+const WORKSPACE_MANIFEST = "seamless.workspace.json";
+export async function runContributeCommand(args) {
+    const subcommand = args[0] ?? "setup";
+    if (subcommand === "setup") {
+        await runContributorSetup(args[1]);
+        return;
+    }
+    if (subcommand === "start") {
+        await runContributorStart();
+        return;
+    }
+    throw new Error(`Unknown contribute subcommand: ${subcommand}`);
+}
+async function runContributorSetup(initialWorkspaceName) {
+    p.intro(kleur.cyan("Seamless Contributor Setup"));
+    const answers = await runContributorSetupPrompts(initialWorkspaceName);
+    const workspaceRoot = path.resolve(process.cwd(), answers.workspaceName);
+    ensureWorkspaceRoot(workspaceRoot);
+    const manifest = {
+        version: 1,
+        createdAt: new Date().toISOString(),
+        packageManager: "npm",
+        workspaceRoot,
+        components: [],
+    };
+    for (const component of CONTRIBUTOR_COMPONENTS) {
+        const mode = answers.localComponents.includes(component.id)
+            ? "local"
+            : "public";
+        const workspaceDir = resolveWorkspaceDir(component, mode);
+        const localPath = mode === "local" || component.publicSurface === "github-repo"
+            ? path.join(workspaceRoot, workspaceDir)
+            : undefined;
+        if (localPath) {
+            const cloneSource = resolveCloneSource(component);
+            await cloneRepo(cloneSource, localPath);
+        }
+        manifest.components.push({
+            id: component.id,
+            mode,
+            publicSurface: component.publicSurface,
+            publicRef: component.publicRef,
+            gitUrl: component.gitUrl,
+            localPath,
+            localPackages: component.localPackages,
+        });
+    }
+    const configuredManifest = configureContributorWorkspace(workspaceRoot, manifest);
+    fs.mkdirSync(workspaceRoot, { recursive: true });
+    fs.writeFileSync(path.join(workspaceRoot, WORKSPACE_MANIFEST), JSON.stringify(configuredManifest, null, 2) + "\n");
+    printContributorSetupOutput(workspaceRoot, configuredManifest);
+    p.outro(kleur.green("Contributor workspace provisioned"));
+}
+async function runContributorStart() {
+    const workspaceRoot = process.cwd();
+    const manifestPath = path.join(workspaceRoot, WORKSPACE_MANIFEST);
+    if (!fs.existsSync(manifestPath)) {
+        throw new Error(`Contributor manifest not found in current directory: ${WORKSPACE_MANIFEST}`);
+    }
+    await runCommand("docker", ["compose", "up", "--build"], workspaceRoot);
+}
+function ensureWorkspaceRoot(workspaceRoot) {
+    if (!fs.existsSync(workspaceRoot)) {
+        return;
+    }
+    const contents = fs.readdirSync(workspaceRoot);
+    if (contents.length > 0) {
+        throw new Error(`Workspace directory is not empty: ${workspaceRoot}`);
+    }
+}
+function printContributorSetupOutput(workspaceRoot, manifest) {
+    console.log("");
+    console.log(kleur.bold("Workspace"));
+    console.log(`  ${kleur.white("Directory:")} ${workspaceRoot}`);
+    console.log(`  ${kleur.white("Manifest:")} ${WORKSPACE_MANIFEST}`);
+    console.log(`  ${kleur.white("Package manager:")} npm`);
+    console.log(`  ${kleur.white("Docker Compose:")} ${manifest.docker?.composeFile ?? "docker-compose.yml"}`);
+    console.log("");
+    console.log(kleur.bold("Component plan"));
+    for (const component of manifest.components) {
+        const modeLabel = component.mode === "local"
+            ? kleur.green("local source")
+            : kleur.cyan(`public ${component.publicSurface}`);
+        console.log(`  • ${component.id} ${kleur.dim(`(${modeLabel})`)}`);
+        if (component.localPath) {
+            const relativePath = path.relative(workspaceRoot, component.localPath);
+            console.log(`    path: ${relativePath || "."}`);
+        }
+        else {
+            console.log(`    source: ${formatPublicRef(component.publicRef)}`);
+        }
+    }
+    if (manifest.packageLinks && manifest.packageLinks.length > 0) {
+        console.log("");
+        console.log(kleur.bold("Local package links"));
+        for (const link of manifest.packageLinks) {
+            console.log(`  • ${link.consumerComponentId} uses ${link.packageName} from ${link.targetPath}`);
+        }
+    }
+    if (manifest.warnings && manifest.warnings.length > 0) {
+        console.log("");
+        console.log(kleur.bold("Warnings"));
+        for (const warning of manifest.warnings) {
+            console.log(`  • ${kleur.yellow(warning)}`);
+        }
+    }
+    console.log("");
+    console.log(kleur.bold("Next step"));
+    console.log(`  cd ${workspaceRoot}`);
+    console.log("  docker compose up --build");
+}
+//# sourceMappingURL=contribute.js.map

package/dist/commands/contribute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contribute.js","sourceRoot":"","sources":["../../src/commands/contribute.ts"],"names":[],"mappings":"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"}