orbidicom 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OrbiDICOM contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/bin/orbidicom.mjs

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+import { parseArgs } from "../dist/args.js";
+import { serve, openBrowser } from "../dist/serve.js";
+
+const opts = parseArgs(process.argv.slice(2));
+
+if (opts.command === "serve") {
+  const { url } = await serve(opts);
+  if (opts.pacs) {
+    console.log(`OrbiDICOM running at ${url}`);
+    console.log(`  PACS:  ${opts.pacs}`);
+    if (opts.study) console.log(`  study: ${opts.study}`);
+    else console.log("  (append ?study=<StudyInstanceUID> or pass --study to open a study)");
+  } else {
+    console.log(`OrbiDICOM running at ${url} (local mode — drag in .dcm / .nii files)`);
+  }
+  if (opts.open) openBrowser(url);
+  console.log("Press Ctrl+C to stop.");
+} else if (opts.command === "init") {
+  console.log(
+    "Scaffolding is implemented in the CLI plan. For now: clone the repo and `make dev`.",
+  );
+} else if (opts.command === "ai") {
+  console.log("The AI assistant is implemented in the CLI plan (optional, BYO key).");
+} else {
+  console.log(`Unknown command: ${opts.command}`);
+  process.exit(1);
+}

package/dist/args.d.ts

@@ -0,0 +1,11 @@
+export type Command = "serve" | "init" | "ai" | "generate";
+export interface CliOptions {
+    command: Command;
+    pacs?: string;
+    study?: string;
+    auth?: "none" | "basic" | "bearer";
+    port: number;
+    open: boolean;
+    rest: string[];
+}
+export declare function parseArgs(argv: string[]): CliOptions;

package/dist/args.js

@@ -0,0 +1,40 @@
+const COMMANDS = new Set(["serve", "init", "ai", "generate"]);
+export function parseArgs(argv) {
+    const opts = { command: "serve", port: 4173, open: true, rest: [] };
+    let i = 0;
+    if (argv[0] && COMMANDS.has(argv[0])) {
+        opts.command = argv[0];
+        i = 1;
+    }
+    else if (argv[0] === "create") {
+        opts.command = "init";
+        i = 1;
+    }
+    for (; i < argv.length; i++) {
+        const a = argv[i];
+        switch (a) {
+            case "--pacs":
+                opts.pacs = argv[++i];
+                break;
+            case "--study":
+                opts.study = argv[++i];
+                break;
+            case "--auth":
+                opts.auth = argv[++i];
+                break;
+            case "--port":
+                opts.port = Number(argv[++i]);
+                break;
+            case "--open":
+                opts.open = true;
+                break;
+            case "--no-open":
+                opts.open = false;
+                break;
+            default:
+                if (a)
+                    opts.rest.push(a);
+        }
+    }
+    return opts;
+}

package/dist/config.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Generate the runtime `config.js` the served demo loads before its app module.
+ * Mirrors the container entrypoint (deploy/docker-entrypoint.d) so `npx orbidicom`
+ * and the Docker image produce an identical `window.__ORBIDICOM_CONFIG__` shape.
+ */
+export declare function configScript(opts: {
+    pacs?: string;
+    study?: string;
+}): string;

package/dist/config.js

@@ -0,0 +1,15 @@
+/** Strip characters that would break out of the JS string literals below.
+ *  Values are operator-supplied on the command line, so this is belt-and-braces. */
+function sanitize(v) {
+    return v.replace(/["\\\r\n]/g, "");
+}
+/**
+ * Generate the runtime `config.js` the served demo loads before its app module.
+ * Mirrors the container entrypoint (deploy/docker-entrypoint.d) so `npx orbidicom`
+ * and the Docker image produce an identical `window.__ORBIDICOM_CONFIG__` shape.
+ */
+export function configScript(opts) {
+    const pacsUrl = sanitize(opts.pacs ?? "");
+    const studyUid = sanitize(opts.study ?? "");
+    return `window.__ORBIDICOM_CONFIG__ = {\n  pacsUrl: "${pacsUrl}",\n  studyUid: "${studyUid}",\n};\n`;
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { parseArgs } from "./args";
+export type { CliOptions, Command } from "./args";
+export { serve, demoDistDir } from "./serve";

package/dist/index.js

@@ -0,0 +1,2 @@
+export { parseArgs } from "./args";
+export { serve, demoDistDir } from "./serve";

package/dist/serve.d.ts

@@ -0,0 +1,15 @@
+import type { CliOptions } from "./args";
+/**
+ * Resolve the prebuilt demo's directory. Published layout: the demo build is
+ * bundled into this package's `public/` (see scripts/bundle-demo.mjs). When
+ * running from the monorepo source, fall back to apps/demo/dist.
+ */
+export declare function demoDistDir(): string;
+export interface ServeHandle {
+    port: number;
+    url: string;
+    close: () => Promise<void>;
+}
+export declare function serve(opts: CliOptions, root?: string): Promise<ServeHandle>;
+/** Open a URL in the default browser (best-effort, never throws). */
+export declare function openBrowser(url: string): void;

package/dist/serve.js

@@ -0,0 +1,58 @@
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { createServer } from "node:http";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import sirv from "sirv";
+import { configScript } from "./config.js";
+/**
+ * Resolve the prebuilt demo's directory. Published layout: the demo build is
+ * bundled into this package's `public/` (see scripts/bundle-demo.mjs). When
+ * running from the monorepo source, fall back to apps/demo/dist.
+ */
+export function demoDistDir() {
+    const here = dirname(fileURLToPath(import.meta.url)); // …/packages/cli/dist
+    const bundled = resolve(here, "../public");
+    if (existsSync(join(bundled, "index.html")))
+        return bundled;
+    return resolve(here, "../../../apps/demo/dist"); // dev / monorepo fallback
+}
+export async function serve(opts, root = demoDistDir()) {
+    const handler = sirv(root, { single: true, dev: false });
+    const server = createServer((req, res) => {
+        const path = (req.url ?? "").split("?")[0];
+        // Inject runtime config so the static bundle connects to the chosen PACS
+        // without rebuilding — same role as config.js in the container image.
+        if (path === "/config.js") {
+            res.statusCode = 200;
+            res.setHeader("Content-Type", "application/javascript; charset=utf-8");
+            res.setHeader("Cache-Control", "no-store");
+            res.end(configScript(opts));
+            return;
+        }
+        handler(req, res, () => {
+            res.statusCode = 404;
+            res.end("Not found");
+        });
+    });
+    await new Promise((r) => server.listen(opts.port, r));
+    const addr = server.address();
+    const port = typeof addr === "object" && addr ? addr.port : opts.port;
+    return {
+        port,
+        url: `http://localhost:${port}/`,
+        close: () => new Promise((res, rej) => server.close((e) => (e ? rej(e) : res()))),
+    };
+}
+/** Open a URL in the default browser (best-effort, never throws). */
+export function openBrowser(url) {
+    const cmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
+    try {
+        const child = spawn(cmd, [url], { stdio: "ignore", detached: true, shell: cmd === "start" });
+        child.on("error", () => { });
+        child.unref();
+    }
+    catch {
+        /* headless / no browser — the printed URL is enough */
+    }
+}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "orbidicom",
+  "version": "0.1.0",
+  "description": "CLI for OrbiDICOM, a modern, mobile-responsive, multilingual, Kubernetes-ready (Helm chart included) open-source DICOM viewer: `npx orbidicom` to run locally or against any PACS.",
+  "license": "MIT",
+  "homepage": "https://github.com/docorbitapp/orbidicom#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/docorbitapp/orbidicom.git",
+    "directory": "packages/cli"
+  },
+  "bugs": "https://github.com/docorbitapp/orbidicom/issues",
+  "keywords": [
+    "dicom",
+    "dicomweb",
+    "viewer",
+    "cornerstone3d",
+    "pacs",
+    "cli"
+  ],
+  "type": "module",
+  "bin": {
+    "orbidicom": "./bin/orbidicom.mjs"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "bin",
+    "public"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "sirv": "^3.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0"
+  },
+  "scripts": {
+    "build": "tsc -b && node ./scripts/bundle-demo.mjs",
+    "test": "vitest run"
+  }
+}