@profullstack/readm3 0.3.0 → 0.5.0

package/README.md

@@ -1,6 +1,6 @@
 # readm3
 
-A terminal markdown reader and editor. File browser on the left, the rendered
+Markdown editing and sharing for people and teams, with a terminal reader and editor. File browser on the left, the rendered
 document on the right, and nothing else in the way. Press `e` to edit the file
 you are looking at, `esc` to see it rendered again.
 
@@ -113,8 +113,8 @@ and add a paragraph, not a replacement for your editor. `$EDITOR` is still
 
 ## What it renders
 
-Parsing is [marked](https://github.com/markedjs/marked) — CommonMark and GFM,
-zero dependencies of its own — so readm3 has two dependencies in total.
+Parsing is [marked](https://github.com/markedjs/marked) — CommonMark and GFM.
+The terminal UI uses HQTUI; the cloud tools use the official MCP SDK.
 
 Headings, **bold**, *italic*, `inline code`, links, reference links, bare URLs,
 fenced and indented code blocks with a language label, ordered and unordered
@@ -215,14 +215,106 @@ Windows Terminal.
 ```bash
 bun install
 bun src/cli.ts .     # run it against its own repo
-bun test test/       # 68 tests, no TTY needed
+bun test ./test       # 68 tests, no TTY needed
 npm test             # the same tests on node
 bun run typecheck
 bun run build
 ```
 
+## Shared documents, organizations, and teams
+
+Read and edit online at https://readm3.com/viewer, and manage your account at
+https://readm3.com/admin. Create private Markdown files, share view or edit links,
+add named collaborators, and grant access to an organization or team. Every link
+opens in read mode. File owners manage permissions and deletion; editors save new
+versions; the super administrator can manage every user's documents.
+
+Every online save creates an immutable version with a short ID and SHA-256 checksum.
+Stale saves are rejected so concurrent edits cannot silently overwrite each other.
+Owners can restore prior versions, pin links to a version, and revoke links.
+
+```sh
+readm3 login --token-stdin             # token from /admin → API tokens
+readm3 orgs list
+readm3 share README.md --org ORG_ID    # view link by default
+readm3 docs update DOC_ID notes.md --base VERSION_ID
+readm3 docs history DOC_ID
+readm3 mcp                            # stdio MCP, same account permissions
+```
+
+The REST API is at `/api/v1`, with all operations also available through
+`POST /api/v1/actions` and `readm3 cloud OPERATION --args JSON`.
+Full permissions, accounts, CLI, API, and MCP documentation: https://readm3.com/sharing.
+
+## Web reader
+
+Open https://readm3.com/viewer for the same two-pane Markdown reader in your browser.
+Open local files or a folder, drop Markdown files into the window, open a raw URL or
+GitHub file link, or start a new note. The explorer filters files, prunes hidden and
+build directories, and sorts README first. All nine themes and Markdown flavors use
+the same renderer as the terminal.
+
+Press `/` to filter, `e` to edit, `Escape` to return to reading, and `?` for shortcuts.
+`Ctrl+S` / `⌘S` downloads the current Markdown. Files and edits are saved in IndexedDB
+on this device; originals on disk are never overwritten. Reopening a file adds a copy
+so an existing draft is preserved. Clearing browser site data removes the workspace.
+
+Install through your browser’s app menu, or Share → Add to Home Screen on iOS.
+After the first visit, the application and saved workspace work offline. Remote URLs
+need a connection and a host that permits browser access (CORS); files are fetched
+directly with no credentials or server proxy. Local files are uploaded only when you explicitly choose Share → Save online.
+
+Imports are limited to 4 MB per file, 20 MB per workspace, and 1,000 files.
+
 ## The website
 
+### Accounts
+
+Open https://readm3.com/account to create an email-verified account or sign in.
+The email link expires after 15 minutes and works once. A confirmation button
+prevents email scanners from consuming links. Accounts are created only after
+verification; returning users sign in to the same identity. Account settings
+include display name, sign out, and sign out on all devices.
+
+The server stores accounts, hashed sessions, verification challenges, and rate
+limits in SQLite. Set `READM3_DB` to a persistent volume path (production uses
+`/data/readm3.sqlite`), `READM3_URL` to the canonical public origin,
+`READM3_MAIL_FROM` to a verified sender, and `RESEND_API_KEY` to an email-sending key.
+Missing or failed mail delivery returns an error; verification links are never
+printed to logs. Production cookies are Secure, HttpOnly, SameSite=Lax, and
+host-scoped. The account page and APIs are excluded from offline caches.
+
+On Railway, attach a volume at `/data`, keep a single replica, and set
+`RAILWAY_RUN_UID=0` for the root-owned volume. Back up the volume before changing
+the account schema. The local reader remains usable without an account.
+
+```bash
+bun run test:accounts  # account security tests and browser signup flow
+```
+
+The account service is `server/accounts.ts`. It can accept an existing Bun SQLite
+`Database` so workspace APIs share the same `users` and `sessions` tables.
+`account_emails` holds the verified identity associated with each user ID.
+Use `Accounts.authenticate(token)` or `Accounts.requireAccount(request)` when
+authorizing organization, team, role, or API-token operations: these methods
+reject sessions whose user has no verified email. Browser sessions use
+`__Host-readm3_session` over HTTPS and `readm3_session` on localhost.
+Do not enable a separate unverified registration or password-recovery path.
+
+| Endpoint | Purpose |
+| --- | --- |
+| `POST /api/auth/email` | Send a sign-in link for an email address |
+| `POST /api/auth/preview` | Show the email associated with an unconsumed link |
+| `POST /api/auth/verify` | Consume the link and set a browser session |
+| `GET /api/auth/session` | Return the verified account, or `null` |
+| `POST /api/auth/profile` | Update the current account's display name |
+| `POST /api/auth/logout` | Revoke the current session |
+| `POST /api/auth/logout-all` | Revoke all sessions belonging to the account |
+
+POST requests require JSON and an `Origin` matching `READM3_URL`.
+
+### Building and serving
+
 [readm3.com](https://readm3.com) is built from this repository by `site/build.ts`,
 which renders every document on the page through `renderMarkdown` and takes every
 color from a real HQTUI theme. There is no second implementation to keep in sync:
@@ -231,8 +323,111 @@ change the parser and the site changes with it.
 ```bash
 bun run site:build   # writes site/dist
 bun run site:start   # serves it on $PORT, default 3000
+bun x playwright install chromium  # once, for browser checks
+bun run test:site    # imports, editing, persistence, offline PWA, and mobile layout
 ```
 
+The site build bundles `site/viewer.ts` for browsers, generates content-addressed
+assets, and precaches the viewer shell through a service worker scoped to `/viewer`.
+Updates wait until the reader chooses **Update available**; drafts are saved before
+reloading. The web viewer does not load the marketing site’s third-party scripts.
+
+## Hosting shared documents
+
+The web server uses Bun and SQLite. Set `READM3_DB` to a database file on persistent
+storage, and `READM3_URL` to the public HTTPS origin. The Docker image uses
+`/data/readm3.sqlite`; mount a volume at `/data`. On Railway set `RAILWAY_RUN_UID=0`
+for access to the mounted volume. Use one service replica for SQLite and configure
+volume backups in the hosting platform.
+
+Set `READM3_ADMIN_BOOTSTRAP_SECRET` to a random secret. Sign in at `/account` as
+the intended super administrator, then open `/admin#claim=YOUR_SECRET`. This is a
+one-time claim stored in the database. Never publish this URL; remove the environment
+secret after claiming. Email sign-in never grants administrator access by itself.
+
+Accounts use verified email sign-in and HttpOnly cookies. API tokens and share
+capabilities are stored as SHA-256 hashes. Shared documents are not cached in the
+PWA or saved in the browser's local workspace, so revocation applies to future access.
+
+```sh
+bun run test:server  # auth, roles, version history, persistence, CLI and MCP
+bun run test:site    # local/offline reader plus browser sharing and admin workflows
+```
+
+## Workspace and settings sync
+
+Sign in with verified email at `/account`, then create a personal API token in `/admin`. The PWA's **Sync** button saves or loads
+your local Markdown workspace and reader preferences on that same account. Shared
+documents continue to use their own document permissions and version history.
+Local files are uploaded only when you choose **Save to account**, `readm3 save`,
+or a sharing action. Sync requires a connection; the local reader still works offline.
+
+The CLI, document commands, and MCP use one credential file, `cloud.json`, under
+`$XDG_CONFIG_HOME/readm3` (normally `~/.config/readm3`). It is written with mode
+0600. Login verifies the account; logout removes the local credential. Revoke a token
+in `/admin` to invalidate remote copies. Tokens can also be created and revoked from the account page.
+
+```sh
+readm3 login --token-stdin               # paste a token, then Ctrl+D
+readm3 whoami
+readm3 settings --theme nord --flavor github
+readm3 save ./notes                      # explicitly import and save Markdown
+readm3 sync status
+readm3 sync revisions
+readm3 load --dry-run                    # inspect the incoming changes
+readm3 load ./downloaded-notes           # load and export into a new directory
+readm3 load --force                      # replace local conflicts, with backups
+readm3 logout
+```
+
+For self-hosting, set `READM3_URL` to the server origin, or set `READM3_API_URL` to
+its API base such as `http://127.0.0.1:3000/api/v1`. `READM3_TOKEN` supplies a token
+without writing it to disk. `READM3_CONFIG_DIR` selects an isolated client directory.
+HTTPS is required except on localhost. A saved token is never sent to a different
+server merely because an environment variable changed.
+
+Sync uses `@profullstack/synconfig`, the same package used by moshcode. Only
+`settings.json` (theme and flavor) and `workspace.json` (the explicitly imported
+workspace) are allowed. Credentials, local revision markers, and backups are excluded.
+Running `save` without a path saves those local files; it does not scan the current
+directory. Running `load` without an output directory updates those files, and loaded
+preferences apply to subsequent terminal reader invocations.
+
+Each account keeps ten revisions. Saves carry the last loaded revision and reject
+concurrent changes; a new device starts at revision 0. Loads refuse to replace
+conflicting local edits, including on a device that has never synced. `--force`
+explicitly overrides a conflict. Replaced local files receive numbered `.bak-NNN`
+backups. Browser replacements receive backups in IndexedDB, accessible through
+**Sync → Local backups** for download or restoration. Clearing browser site data
+also removes those local backups. Sync supports the browser's workspace limits:
+1,000 Markdown files, 4 MB per file, and 20 MB of source in total.
+
+The authenticated API exposes:
+
+| Endpoint | Purpose |
+| --- | --- |
+| `GET /api/v1/me` | Current account; `user: null` when signed out |
+| `GET /api/v1/settings` | Latest snapshot, digest, and revision; 404 when empty |
+| `PUT /api/v1/settings` | Save `{ snapshot, ifRevision }`; 409 on a conflict |
+| `GET /api/v1/settings/revisions` | The last ten revision summaries |
+
+`/api/v1/synconfig` is an alias for the settings endpoints. A snapshot is
+`{ version: 1, host, app, files: { "settings.json": { content: "{...}" } } }`.
+`workspace.json` uses `{ name, active, documents: [{ path, source }] }` inside its
+JSON content string. Send `ifRevision: 0` for a first save, the revision last loaded
+for subsequent saves, or `null` for an explicitly forced save. API callers use
+`Authorization: Bearer TOKEN`; browser callers use the same account's HTTP-only
+session cookie and same-origin requests. Account responses are never cached offline.
+
+Start MCP with `readm3 mcp`. Alongside the document and organization tools, it exposes
+`settings_get`, `settings_save`, and `settings_revisions`. `settings_save` requires
+a nonnegative `ifRevision` and uses the same validation and conflict checks as the API.
+
+Run `bun run test:server` for account/sync integration checks and `bun run test:site`
+for browser checks. The server needs Bun and a persistent `READM3_DB` SQLite path;
+in the container this defaults to `/data/readm3.sqlite`, so mount persistent storage
+at `/data`. Set `READM3_URL` to the public origin for browser origin checks.
+
 ## License
 
 MIT.

package/dist/account.d.ts

@@ -0,0 +1,27 @@
+export interface AccountUser {
+    id: string;
+    username: string;
+    displayName: string;
+}
+export interface Credentials {
+    api: string;
+    token: string;
+    user: AccountUser;
+    expiresAt?: string;
+}
+export declare const configDir: () => string;
+export declare function apiUrl(value?: string): string;
+export declare function writeConfig(name: string, value: unknown, root?: string): void;
+export declare function storedCredentials(root?: string): Credentials | undefined;
+export declare class ApiError extends Error {
+    status: number;
+    body: Record<string, unknown>;
+    constructor(status: number, message: string, body: Record<string, unknown>);
+}
+export declare function accountClient(options: {
+    api: string;
+    token?: string;
+    fetchImpl?: typeof fetch;
+}): <T = Record<string, unknown>>(path: string, method?: string, body?: unknown) => Promise<T>;
+export declare function credentials(root?: string): Promise<Credentials>;
+//# sourceMappingURL=account.d.ts.map

package/dist/account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../src/account.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE;AAClF,MAAM,WAAW,WAAW;IAAG,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE;AAClG,eAAO,MAAM,SAAS,cAAmH,CAAC;AAC1I,wBAAgB,MAAM,CAAC,KAAK,SAAgJ,GAAG,MAAM,CAIpL;AACD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,SAAc,QAO3E;AACD,wBAAgB,iBAAiB,CAAC,IAAI,SAAc,GAAG,WAAW,GAAG,SAAS,CAK7E;AACD,qBAAa,QAAS,SAAQ,KAAK;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAClB,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAC3E;AACD,wBAAgB,aAAa,CAAC,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CAAE,IAEhE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,MAAM,EAAE,eAAc,EAAE,OAAO,OAAO,KAAG,OAAO,CAAC,CAAC,CAAC,CAUrH;AACD,wBAAsB,WAAW,CAAC,IAAI,SAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CAU1E"}

package/dist/account.js

@@ -0,0 +1,59 @@
+import { chmodSync, existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+export const configDir = () => process.env.READM3_CONFIG_DIR || join(process.env.XDG_CONFIG_HOME || join(homedir(), ".config"), "readm3");
+export function apiUrl(value = process.env.READM3_API_URL || (process.env.READM3_URL ? `${process.env.READM3_URL.replace(/\/+$/, "")}/api/v1` : "https://readm3.com/api/v1")) {
+    const url = new URL(value);
+    if (url.username || url.password || url.search || url.hash || !(url.protocol === "https:" || (url.protocol === "http:" && ["localhost", "127.0.0.1", "[::1]"].includes(url.hostname))))
+        throw new Error("Use an HTTPS API URL (HTTP is allowed on localhost).");
+    return url.href.replace(/\/+$/, "");
+}
+export function writeConfig(name, value, root = configDir()) {
+    mkdirSync(root, { recursive: true, mode: 0o700 });
+    const path = join(root, name);
+    const temp = `${path}.${process.pid}.${crypto.randomUUID()}.tmp`;
+    writeFileSync(temp, JSON.stringify(value, null, 2) + "\n", { mode: 0o600 });
+    renameSync(temp, path);
+    chmodSync(path, 0o600);
+}
+export function storedCredentials(root = configDir()) {
+    const path = join(root, "cloud.json");
+    if (!existsSync(path))
+        return;
+    const value = JSON.parse(readFileSync(path, "utf8"));
+    return { ...value, api: apiUrl(value.api || (value.url ? `${value.url}/api/v1` : undefined)) };
+}
+export class ApiError extends Error {
+    status;
+    body;
+    constructor(status, message, body) { super(message); this.status = status; this.body = body; }
+}
+export function accountClient(options) {
+    const base = apiUrl(options.api);
+    return async function request(path, method = "GET", body) {
+        const response = await (options.fetchImpl || fetch)(`${base}${path}`, {
+            method, redirect: "error", signal: AbortSignal.timeout(30_000),
+            headers: { accept: "application/json", ...(options.token ? { authorization: `Bearer ${options.token}` } : {}), ...(body === undefined ? {} : { "content-type": "application/json" }) },
+            ...(body === undefined ? {} : { body: JSON.stringify(body) }),
+        });
+        const data = await response.json();
+        if (!response.ok)
+            throw new ApiError(response.status, String(data.error || `HTTP ${response.status}`), data);
+        return data;
+    };
+}
+export async function credentials(root = configDir()) {
+    const saved = storedCredentials(root);
+    const token = process.env.READM3_TOKEN || saved?.token;
+    if (!token)
+        throw new Error("Sign in with `readm3 login` first, or set READM3_TOKEN and READM3_API_URL.");
+    // Never send a saved token to a different server because an environment variable changed.
+    const api = apiUrl(process.env.READM3_API_URL || (process.env.READM3_URL ? `${process.env.READM3_URL.replace(/\/+$/, "")}/api/v1` : saved?.api));
+    if (!process.env.READM3_TOKEN && saved && api !== saved.api)
+        throw new Error("The API changed. Sign in to this server first.");
+    const { user } = await accountClient({ api, token })("/me");
+    if (!user)
+        throw new Error("Session expired or revoked. Run `readm3 login`.");
+    return { api, token, user };
+}
+//# sourceMappingURL=account.js.map

package/dist/account.js.map

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

package/dist/cli.d.ts

@@ -1,6 +1,6 @@
 import { type ColorMode } from "./print.ts";
 import { type ViewerOptions } from "./viewer.ts";
-export declare const VERSION = "0.3.0";
+export declare const VERSION = "0.5.0";
 /** The help text, exported so a test can hold it to the flags it documents. */
 export declare const USAGE: string;
 export interface ParsedArgs extends ViewerOptions {

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAQA,OAAO,EAA8B,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAO,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAEtD,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,+EAA+E;AAC/E,eAAO,MAAM,KAAK,QA0CjB,CAAC;AAEF,MAAM,WAAW,UAAW,SAAQ,aAAa;IAC/C,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;IACjB,uDAAuD;IACvD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAID,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA6GpD;AAED,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAwChF"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAQA,OAAO,EAA8B,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAO,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAGtD,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,+EAA+E;AAC/E,eAAO,MAAM,KAAK,QA2CH,CAAC;AAEhB,MAAM,WAAW,UAAW,SAAQ,aAAa;IAC/C,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;IACjB,uDAAuD;IACvD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAID,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA6GpD;AAED,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAoDhF"}

package/dist/cli.js

@@ -8,7 +8,8 @@ import { themeList } from "@profullstack/hqtui";
 import { FLAVORS, isFlavor } from "./flavors.js";
 import { printDocument, COLOR_MODES } from "./print.js";
 import { run } from "./viewer.js";
-export const VERSION = "0.3.0";
+import { isCloudCommand, cloudMain, CLOUD_USAGE } from "./cloud-cli.js";
+export const VERSION = "0.5.0";
 /** The help text, exported so a test can hold it to the flags it documents. */
 export const USAGE = `readm3 — a terminal markdown reader and editor
 
@@ -52,7 +53,8 @@ Editing
   ctrl+a ctrl+e  line start / end      ctrl+u   kill to start of line
   ctrl+arrow     move by word          enter    split, continuing a list
   ctrl+g         keys for editing      tab      indent two spaces
-`;
+
+${CLOUD_USAGE}`;
 class UsageError extends Error {
 }
 export function parseArgs(argv) {
@@ -169,6 +171,13 @@ export function parseArgs(argv) {
     return parsed;
 }
 export async function main(argv = process.argv.slice(2)) {
+    const { accountCommand } = await import("./sync-cli.js");
+    if (await accountCommand(argv))
+        return;
+    if (isCloudCommand(argv[0])) {
+        await cloudMain(argv);
+        return;
+    }
     let args;
     try {
         args = parseArgs(argv);
@@ -182,7 +191,8 @@ export async function main(argv = process.argv.slice(2)) {
         throw error;
     }
     if (args.help) {
-        process.stdout.write(USAGE);
+        const { ACCOUNT_USAGE } = await import("./sync-cli.js");
+        process.stdout.write(USAGE + "\n" + ACCOUNT_USAGE);
         return;
     }
     if (args.version) {
@@ -190,6 +200,10 @@ export async function main(argv = process.argv.slice(2)) {
         return;
     }
     if (args.print) {
+        const { localSettings } = await import("./settings-sync.js");
+        const settings = localSettings();
+        args.theme ??= settings.theme;
+        args.flavor ??= settings.flavor;
         printDocument({
             path: args.open,
             width: args.sidebar,
@@ -205,6 +219,10 @@ export async function main(argv = process.argv.slice(2)) {
         process.exitCode = 1;
         return;
     }
+    const { localSettings } = await import("./settings-sync.js");
+    const settings = localSettings();
+    args.theme ??= settings.theme;
+    args.flavor ??= settings.flavor;
     await run(args);
 }
 // Running the source directly (`bun src/cli.ts`, `node src/cli.ts`) should start

package/dist/cli.js.map

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

package/dist/cloud-cli.d.ts

@@ -0,0 +1,4 @@
+export declare const CLOUD_USAGE = "Shared Markdown\n  readm3 login --token-stdin              Save a personal API token securely\n  readm3 logout                           Remove the local token\n  readm3 share FILE --org ID [--role view|edit]\n  readm3 docs list [--org ID] [--search TEXT] [--limit N] [--offset N]\n  readm3 docs get ID [--raw]\n  readm3 docs create FILE --org ID [--title NAME]\n  readm3 docs update ID FILE --base VERSION\n  readm3 docs delete ID\n  readm3 docs history ID\n  readm3 docs restore ID --version VERSION --base CURRENT\n  readm3 docs share ID [--role view|edit] [--version VERSION]\n  readm3 docs revoke ID --share SHARE_ID\n  readm3 docs transfer ID --username USERNAME\n  readm3 shared get URL [--raw]\n  readm3 shared update URL FILE --base VERSION\n  readm3 orgs list | create --name NAME | update ID --name NAME | delete ID\n  readm3 teams list --org ID | create --org ID --name NAME\n  readm3 members list --org ID\n  readm3 cloud OPERATION --args '{\"key\":\"value\"}'\n  readm3 mcp                              Start the stdio MCP server\n\nFILE may be - for stdin. --raw prints Markdown; other results are JSON.\nREADM3_URL selects a self-hosted server; READM3_TOKEN supplies an API token.\nView links cannot write. Edit links can save versions. Owners administer files.\nUse readm3 cloud for the full API, including team membership and permissions.\n";
+export declare function isCloudCommand(command: string | undefined): boolean;
+export declare function cloudMain(argv: string[]): Promise<void>;
+//# sourceMappingURL=cloud-cli.d.ts.map

package/dist/cloud-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-cli.d.ts","sourceRoot":"","sources":["../src/cloud-cli.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,WAAW,m1CA0BvB,CAAC;AAaF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,WAEzD;AACD,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,iBAiJ7C"}

package/dist/cloud-cli.js

@@ -0,0 +1,192 @@
+import { readFileSync } from "node:fs";
+import { basename } from "node:path";
+import { cloudAction, cloudConfig, cloudRequest, clearCloudConfig, saveCloudConfig, sharedLocation, } from "./cloud-client.js";
+export const CLOUD_USAGE = `Shared Markdown
+  readm3 login --token-stdin              Save a personal API token securely
+  readm3 logout                           Remove the local token
+  readm3 share FILE --org ID [--role view|edit]
+  readm3 docs list [--org ID] [--search TEXT] [--limit N] [--offset N]
+  readm3 docs get ID [--raw]
+  readm3 docs create FILE --org ID [--title NAME]
+  readm3 docs update ID FILE --base VERSION
+  readm3 docs delete ID
+  readm3 docs history ID
+  readm3 docs restore ID --version VERSION --base CURRENT
+  readm3 docs share ID [--role view|edit] [--version VERSION]
+  readm3 docs revoke ID --share SHARE_ID
+  readm3 docs transfer ID --username USERNAME
+  readm3 shared get URL [--raw]
+  readm3 shared update URL FILE --base VERSION
+  readm3 orgs list | create --name NAME | update ID --name NAME | delete ID
+  readm3 teams list --org ID | create --org ID --name NAME
+  readm3 members list --org ID
+  readm3 cloud OPERATION --args '{"key":"value"}'
+  readm3 mcp                              Start the stdio MCP server
+
+FILE may be - for stdin. --raw prints Markdown; other results are JSON.
+READM3_URL selects a self-hosted server; READM3_TOKEN supplies an API token.
+View links cannot write. Edit links can save versions. Owners administer files.
+Use readm3 cloud for the full API, including team membership and permissions.
+`;
+const commands = new Set([
+    "login",
+    "logout",
+    "share",
+    "docs",
+    "shared",
+    "orgs",
+    "teams",
+    "members",
+    "cloud",
+    "mcp",
+]);
+export function isCloudCommand(command) {
+    return !!command && commands.has(command);
+}
+export async function cloudMain(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        process.stdout.write(CLOUD_USAGE);
+        return;
+    }
+    const command = argv[0];
+    if (command === "mcp") {
+        const { runMcp } = await import("./mcp.js");
+        await runMcp();
+        return;
+    }
+    const flags = {};
+    const positional = [];
+    for (let i = 1; i < argv.length; i++) {
+        const value = argv[i];
+        if (value.startsWith("--")) {
+            const name = value.slice(2);
+            if (["raw", "token-stdin", "json"].includes(name))
+                flags[name] = "true";
+            else {
+                if (!argv[i + 1] || argv[i + 1].startsWith("--"))
+                    throw new Error(`${value} needs a value.`);
+                flags[name] = argv[++i];
+            }
+        }
+        else
+            positional.push(value);
+    }
+    const output = (value) => process.stdout.write(JSON.stringify(value, null, 2) + "\n");
+    const fileSource = (file) => {
+        if (!file)
+            throw new Error("A Markdown file is required.");
+        const value = readFileSync(file === "-" ? 0 : file, "utf8");
+        if (Buffer.byteLength(value) > 1024 * 1024)
+            throw new Error("Shared documents are limited to 1 MB.");
+        return value;
+    };
+    if (command === "login") {
+        if (!flags["token-stdin"])
+            throw new Error("Use --token-stdin and paste the API token, then end input (Ctrl+D). Tokens are created at /admin.");
+        const token = readFileSync(0, "utf8").trim();
+        if (!token)
+            throw new Error("No token supplied.");
+        const config = cloudConfig(token);
+        const user = await cloudAction("account_me", {}, config);
+        saveCloudConfig(config);
+        output({ signedIn: true, user });
+        return;
+    }
+    if (command === "logout") {
+        clearCloudConfig();
+        output({
+            signedOut: true,
+            note: "Revoke the token in /admin to invalidate other copies.",
+        });
+        return;
+    }
+    if (command === "cloud") {
+        if (!positional[0])
+            throw new Error(CLOUD_USAGE);
+        const args = flags.args ? JSON.parse(flags.args) : {};
+        output(await cloudAction(positional[0], args));
+        return;
+    }
+    if (command === "shared") {
+        const [verb, url, file] = positional;
+        if (!["get", "update"].includes(verb))
+            throw new Error("Use shared get or shared update.");
+        if (!url)
+            throw new Error("A shared document URL is required.");
+        const { token, config } = sharedLocation(url);
+        const result = await cloudRequest(`shared/${token}`, verb === "update" ? "PATCH" : "GET", verb === "update"
+            ? { source: fileSource(file), baseVersion: flags.base }
+            : undefined, config);
+        if (!["get", "update"].includes(verb))
+            throw new Error("Use shared get or shared update.");
+        if (flags.raw)
+            process.stdout.write(result.version.source);
+        else
+            output(result);
+        return;
+    }
+    const args = {};
+    const names = {
+        org: "orgId",
+        team: "teamId",
+        base: "baseVersion",
+        version: "versionId",
+        share: "shareId",
+        user: "userId",
+    };
+    for (const [name, value] of Object.entries(flags))
+        if (!["raw", "json"].includes(name))
+            args[names[name] || name] = value;
+    if (command === "share") {
+        const file = positional[0];
+        const doc = await cloudAction("documents_create", {
+            ...args,
+            title: flags.title || basename(file || "Document.md"),
+            source: fileSource(file),
+        });
+        output(await cloudAction("shares_create", {
+            documentId: doc.id,
+            role: flags.role || "view",
+        }));
+        return;
+    }
+    const [verb, identifier, file] = positional;
+    if (command === "docs") {
+        const operations = {
+            list: "documents_list",
+            get: "documents_get",
+            create: "documents_create",
+            update: "documents_update",
+            delete: "documents_delete",
+            history: "versions_list",
+            restore: "versions_restore",
+            share: "shares_create",
+            revoke: "shares_revoke",
+            transfer: "documents_transfer",
+        };
+        const op = operations[verb];
+        if (!op)
+            throw new Error(CLOUD_USAGE);
+        if (verb === "create") {
+            args.source = fileSource(identifier);
+            args.title = flags.title || basename(identifier || "Document.md");
+        }
+        else if (verb !== "list")
+            args.documentId = identifier;
+        if (verb === "update")
+            args.source = fileSource(file);
+        const result = await cloudAction(op, args);
+        if (flags.raw && result.version)
+            process.stdout.write(result.version.source);
+        else
+            output(result);
+        return;
+    }
+    const prefix = command === "orgs" ? "organizations" : command;
+    if (!["list", "create", "update", "delete", "remove"].includes(verb))
+        throw new Error(CLOUD_USAGE);
+    if (identifier)
+        args[command === "orgs" ? "orgId" : command === "teams" ? "teamId" : "userId"] = identifier;
+    output(await cloudAction(`${prefix}_${verb}`, args));
+}
+//# sourceMappingURL=cloud-cli.js.map