docugate 0.4.1 → 0.4.2

package/README.md

@@ -147,7 +147,7 @@ On Pro it carries on:
 7. Asks where the API console sends requests from: the reader's browser, or through DocuGate with no CORS setup.
 8. Switches on API keys, with a scope per OpenAPI tag to start from, makes the verify secret, offers to put it in `.env` when git ignores that file, and prints the lines your Express, Hono or Fastify backend needs.
 
-Everything it sets stays editable in the space's settings on [trydocugate.site](https://www.trydocugate.site/dashboard).
+Everything it sets stays editable in the space's settings on [trydocugate.site](https://trydocugate.site/dashboard).
 
 ## Docs that keep up with your code
 
@@ -412,11 +412,11 @@ cd server && npx docugate connect   # pick the project, or start a new one
 cd ../public && npx docugate connect # pick the same project
 ```
 
-The first codebase's docs sit at the top of the project's space; each one after it gets a section named after what it is (`frontend/`, `backend/`), so two pages with the same name cannot clash. A docs folder the space already reads is not added twice. Change the sections, or add repositories by hand, in a space's settings on [trydocugate.site](https://www.trydocugate.site/dashboard). Feeding one project from several codebases needs Pro or an organization plan.
+The first codebase's docs sit at the top of the project's space; each one after it gets a section named after what it is (`frontend/`, `backend/`), so two pages with the same name cannot clash. A docs folder the space already reads is not added twice. Change the sections, or add repositories by hand, in a space's settings on [trydocugate.site](https://trydocugate.site/dashboard). Feeding one project from several codebases needs Pro or an organization plan.
 
 Run `init` and `check` in each repository that contributes docs, and answer the role question in each: the tour lives in the frontend, and its `source` lines can point into the backend. Every one gets its own `docugate.json`, naming its own docs folder. `check` reads the repository it is run in, which is why its 300-page limit is per repository rather than per space.
 
-See [Merging repositories](https://www.trydocugate.site/docs/merging-repositories).
+See [Merging repositories](https://trydocugate.site/docs/merging-repositories).
 
 ---
 
@@ -471,7 +471,7 @@ const verdict = await verifyKey(key, { secret: process.env.DOCUGATE_VERIFY_SECRE
 if (!verdict.valid) return deny(verdict.code) // REVOKED, EXPIRED, USAGE_EXCEEDED, ...
 ```
 
-`verifyKey` answers for every key, valid or not, and throws a `KeyServiceError` only when it could not get an answer. By default every request asks DocuGate, which is what makes a revoked key stop at once; `cacheSeconds` trades that for speed, and `failOpen` decides what happens when DocuGate cannot be reached (by default, the request is refused). The options, the exact request, and what each result means are in [API keys](https://www.trydocugate.site/docs/api-keys).
+`verifyKey` answers for every key, valid or not, and throws a `KeyServiceError` only when it could not get an answer. By default every request asks DocuGate, which is what makes a revoked key stop at once; `cacheSeconds` trades that for speed, and `failOpen` decides what happens when DocuGate cannot be reached (by default, the request is refused). The options, the exact request, and what each result means are in [API keys](https://trydocugate.site/docs/api-keys).
 
 ---
 
@@ -488,7 +488,7 @@ One per repository, at its root.
 | `sync` | Settings for `docugate sync`; see [Docs that keep up with your code](#docs-that-keep-up-with-your-code). The DocuGate site ignores it. |
 | `sidebar` | File and folder names in the order the sidebar should show them. Orders this repository's own pages, not the whole space. |
 | `api.generate` | Defaults for `docugate openapi`. |
-| `api.spec` | Where the OpenAPI file is, for a repository that does not keep it at `openapi.json` in the root or the docs folder. DocuGate draws an [API reference](https://www.trydocugate.site/docs/api-reference) from it. |
+| `api.spec` | Where the OpenAPI file is, for a repository that does not keep it at `openapi.json` in the root or the docs folder. DocuGate draws an [API reference](https://trydocugate.site/docs/api-reference) from it. |
 
 ---
 

package/dist/api.js

@@ -22,7 +22,7 @@ export function detectAgent(env = process.env) {
     return 'Terminal';
 }
 /** Module-level default, captured at import time (used by CLI commands). */
-export const BASE_URL = process.env.DOCUGATE_URL ?? 'https://www.trydocugate.site';
+export const BASE_URL = process.env.DOCUGATE_URL ?? 'https://trydocugate.site';
 const ERROR_MESSAGES = {
     pro_required_sources: 'Connecting more than one repository to a space needs DocuGate Pro',
     space_limit: 'The free plan has one space. Connect this repository to it, or upgrade to Pro',
@@ -60,8 +60,18 @@ export async function apiFetch(path, init = {}) {
         headers['x-docugate-version'] = CLI_VERSION;
     }
     // Re-read the env at call time so tests that set DOCUGATE_URL after import work.
-    const base = process.env.DOCUGATE_URL ?? 'https://www.trydocugate.site';
-    const res = await fetch(`${base}${path}`, { ...init, headers });
+    const base = process.env.DOCUGATE_URL ?? 'https://trydocugate.site';
+    let res = await fetch(`${base}${path}`, { ...init, headers, redirect: 'manual' });
+    // fetch drops the Authorization header when a redirect changes host, so a
+    // move between www.trydocugate.site and trydocugate.site read as signed out.
+    // Followed here instead, once, and only between two names of the same site.
+    const moved = res.status >= 301 && res.status <= 308 ? res.headers.get('location') : null;
+    if (moved) {
+        const to = new URL(moved, base);
+        const bare = (host) => host.replace(/^www\./, '');
+        if (to.protocol === 'https:' && bare(to.host) === bare(new URL(base).host))
+            res = await fetch(to, { ...init, headers, redirect: 'manual' });
+    }
     // Renew token if the server sent a fresh one.
     const renewed = res.headers.get('x-docugate-token');
     if (renewed && !envToken)

package/dist/cli.js

@@ -23,7 +23,7 @@ import { startTourServer } from './tour-server.js';
 import { login, clearCredentials, loadCredentials } from './auth.js';
 import { BASE_URL, getSession } from './api.js';
 import { dim, gold, green, hint, isMintty, plural, red, suggest, yellow } from './ui.js';
-const SITE = 'https://www.trydocugate.site';
+const SITE = 'https://trydocugate.site';
 /** True while the launch menu is running: its commands do not print their own "Next". */
 let inMenu = false;
 function fail(message, tip) {

package/dist/developers.js

@@ -13,7 +13,7 @@ import { bold, dim, gold, green, plural, yellow } from './ui.js';
 // console sends requests, switches on API keys and hands over the verify
 // secret with the lines the backend needs. Every step says what it is about to
 // do, and nothing that already exists is overwritten.
-const SITE = 'https://www.trydocugate.site';
+const SITE = 'https://trydocugate.site';
 /** Folders never worth walking for a spec. */
 const SKIP = new Set(['node_modules', '.git', 'dist', 'build', '.next', 'out', 'coverage', 'vendor', '.venv', 'venv', 'target']);
 /** File names that are, by convention, an API description. */

package/dist/init.js

@@ -480,7 +480,7 @@ export async function initFlow(root, options = {}) {
         saveRole(root, role);
     }
     // ── Step 3: sign in and connect this repository ───────────────────────────
-    const BASE_URL = options.baseUrl ?? process.env.DOCUGATE_URL ?? 'https://www.trydocugate.site';
+    const BASE_URL = options.baseUrl ?? process.env.DOCUGATE_URL ?? 'https://trydocugate.site';
     let connectError;
     // In CI (no TTY) skip sign-in entirely (hint already printed in the early-return branch above).
     if (!io.isTTY) {

package/dist/keys/core.js

@@ -9,7 +9,7 @@ import { looksLikeKey } from './format.js';
  * request. This file is that question and what to do with the answer. The
  * adapters for Express, Hono and Fastify are a few lines on top of it.
  */
-const DEFAULT_BASE_URL = 'https://www.trydocugate.site';
+const DEFAULT_BASE_URL = 'https://trydocugate.site';
 /** DocuGate could not be asked, or refused to answer. Never means a key is bad. */
 export class KeyServiceError extends Error {
     constructor(message, options) {

package/dist/project.js

@@ -18,7 +18,7 @@ import { bold, dim, green, plural, red, yellow } from './ui.js';
 export const PROJECT_TYPES = ['frontend', 'backend', 'serverless', 'monorepo'];
 export const FREQUENCIES = ['push', 'daily', 'weekly', 'off'];
 const TOKENS_FILE = () => join(process.env.DOCUGATE_HOME ?? join(homedir(), '.docugate'), 'projects.json');
-const base = () => process.env.DOCUGATE_URL ?? 'https://www.trydocugate.site';
+const base = () => process.env.DOCUGATE_URL ?? 'https://trydocugate.site';
 function readTokens() {
     try {
         return JSON.parse(readFileSync(TOKENS_FILE(), 'utf8'));

package/dist/sync/run.js

@@ -90,7 +90,7 @@ export async function runSync(root, options = {}, deps = {}) {
     writeSyncState(root, { lastSha: changes.to, lastRunAt: (deps.now ?? new Date()).toISOString() });
     if (options.pr) {
         const prFn = deps.prFn ?? defaultPr({ git, env });
-        const siteUrl = env.DOCUGATE_URL ?? 'https://www.trydocugate.site';
+        const siteUrl = env.DOCUGATE_URL ?? 'https://trydocugate.site';
         result.pr = await prFn({
             root,
             title: `docs: sync with code changes (${changes.commits.length} commit${changes.commits.length === 1 ? '' : 's'})`,

package/dist/tour-server.js

@@ -104,7 +104,7 @@ export function publishedDocsUrl(root) {
     const space = loadConfig(root).config.space;
     if (!space || !/^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/.test(space))
         return undefined;
-    return `${process.env.DOCUGATE_URL ?? 'https://www.trydocugate.site'}/${space}`;
+    return `${process.env.DOCUGATE_URL ?? 'https://trydocugate.site'}/${space}`;
 }
 function handleGetEvents(req, res, root) {
     const tourDir = join(root, '.docugate', 'tour');
@@ -379,13 +379,13 @@ export function startTourServer(root, port) {
                 // Somebody opened the tour server itself. Say what it is and where to go.
                 const screens = loadTours(root).length;
                 res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
-                res.end(`<!doctype html><html lang="en"><head><meta charset="utf-8"><title>DocuGate tour server</title>
-<style>body{margin:0;min-height:100vh;display:grid;place-items:center;background:#0F1014;color:#F5F0E3;font:15px/1.6 system-ui,sans-serif}
-main{max-width:440px;padding:32px;border:1px solid #25273a;border-radius:16px;background:#15173a}
-h1{font-size:20px;margin:0 0 8px}p{margin:0 0 12px;color:#aaa597}b{color:#F4C43F;font-weight:600}
-.dot{display:inline-block;width:8px;height:8px;border-radius:50%;background:#45d483;margin-right:8px}</style></head>
-<body><main><h1><span class="dot"></span>The DocuGate tour server is running</h1>
-<p>This is not a page to open. It feeds the Tour button in your app (${screens} screen${screens === 1 ? '' : 's'} in <b>.docugate/tour/</b>).</p>
+                res.end(`<!doctype html><html lang="en"><head><meta charset="utf-8"><title>DocuGate tour server</title>
+<style>body{margin:0;min-height:100vh;display:grid;place-items:center;background:#0F1014;color:#F5F0E3;font:15px/1.6 system-ui,sans-serif}
+main{max-width:440px;padding:32px;border:1px solid #25273a;border-radius:16px;background:#15173a}
+h1{font-size:20px;margin:0 0 8px}p{margin:0 0 12px;color:#aaa597}b{color:#F4C43F;font-weight:600}
+.dot{display:inline-block;width:8px;height:8px;border-radius:50%;background:#45d483;margin-right:8px}</style></head>
+<body><main><h1><span class="dot"></span>The DocuGate tour server is running</h1>
+<p>This is not a page to open. It feeds the Tour button in your app (${screens} screen${screens === 1 ? '' : 's'} in <b>.docugate/tour/</b>).</p>
 <p>Open <b>your app</b> instead, for example <b>http://localhost:5173</b> or <b>http://localhost:3000</b>. The Tour button is in the bottom-right corner.</p></main></body></html>`);
             }
             else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docugate",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "Command-line tools for DocuGate: set up, check and prepare the documentation DocuGate reads straight from your repository. Also checks DocuGate API keys from Express, Hono and Fastify.",
   "type": "module",
   "bin": {