@w6w/cli 0.9.15 → 0.9.16

package/dist/src/commands/auth.js

@@ -0,0 +1,112 @@
+/**
+ * `w6w auth login | logout | status` — the stored API token.
+ *
+ * Declared in `endpoints.json` `cli.commands[]` (CLI-only: no API operation sits
+ * behind them) and routed like any other group. None of them touches the
+ * network, and none ever prints a token.
+ *
+ * The token is **bound to the base URL it is saved for**. All three commands
+ * resolve that URL through the one resolver in `src/client.ts`
+ * ({@linkcode resolveSettings}), the same code a real command uses, so
+ * `auth status` reports exactly what the next command will do.
+ *
+ * `login` takes the token as a positional (`w6w auth login <token>`) or from
+ * standard input (`w6w auth login -`, or no argument with piped input). The
+ * stdin form is the safer one: a positional lands in shell history and in the
+ * process list. `login` never stores the global `--token` or `W6W_TOKEN` — they
+ * are overrides, not credentials to save.
+ *
+ * @module
+ */
+import { ConfigError } from "@w6w/sdk";
+import { ENV_TOKEN, isUnsendable, resolveSettings } from "../client.js";
+import { serializeConfig } from "../config-store.js";
+import { noExtraArguments, usageError } from "./shared.js";
+/** The base URL these commands act on: flag > env > stored > default, never the token sources. */
+function resolveBase(context) {
+    const { globals } = context.invocation;
+    return resolveSettings({ ...globals, token: undefined }, (name) => (name === ENV_TOKEN ? undefined : context.env(name)), context.stored);
+}
+/** `"****"` plus the last four characters of a long-enough token, else just `"****"`. */
+function mask(token) {
+    return token.length >= 12 ? `****${token.slice(-4)}` : "****";
+}
+function requirePath(context) {
+    const path = context.store.path;
+    if (path === undefined) {
+        throw new ConfigError("w6w cannot tell where to keep its config: neither XDG_CONFIG_HOME (an absolute path) " +
+            "nor HOME is set. Nothing was saved.");
+    }
+    return path;
+}
+const login = async (context) => {
+    noExtraArguments(context, 1);
+    const positional = context.invocation.positionals[0];
+    let token;
+    if (positional === "-" || (positional === undefined && !context.stdin.isTerminal())) {
+        // One trailing newline is the shell's, not the token's.
+        token = (await context.stdin.read()).replace(/\r?\n$/, "");
+    }
+    else if (positional === undefined) {
+        throw usageError(context, "`auth login` needs a token. Pass it as an argument, or pipe it in: " +
+            "`printf '%s' \"$TOKEN\" | w6w auth login -`.");
+    }
+    else {
+        token = positional;
+    }
+    if (token.trim().length === 0) {
+        throw usageError(context, "The token is empty; nothing was saved.");
+    }
+    if (isUnsendable(token)) {
+        throw usageError(context, "The token contains a character that cannot be sent in an HTTP header " +
+            "(a control character); nothing was saved.");
+    }
+    const { baseUrl } = resolveBase(context);
+    const path = requirePath(context);
+    const next = {
+        version: 1,
+        baseUrl,
+        hosts: { ...context.stored.hosts, [baseUrl]: { token } },
+    };
+    await context.store.write(serializeConfig(next));
+    context.out.emit({ baseUrl, configPath: path }, () => `Saved the API token for ${baseUrl} in ${path}.`);
+};
+const logout = async (context) => {
+    noExtraArguments(context, 0);
+    const { baseUrl } = resolveBase(context);
+    const had = Object.hasOwn(context.stored.hosts, baseUrl);
+    if (had) {
+        requirePath(context);
+        const hosts = { ...context.stored.hosts };
+        delete hosts[baseUrl];
+        await context.store.write(serializeConfig({ version: 1, baseUrl: context.stored.baseUrl, hosts }));
+    }
+    context.out.emit({ baseUrl, removed: had }, () => had
+        ? `Removed the stored API token for ${baseUrl}.`
+        : `No stored API token for ${baseUrl}; nothing to remove.`);
+};
+const status = (context) => {
+    noExtraArguments(context, 0);
+    const settings = resolveSettings(context.invocation.globals, context.env, context.stored);
+    const payload = {
+        baseUrl: settings.baseUrl,
+        baseUrlSource: settings.baseUrlSource,
+        tokenSource: settings.tokenSource ?? null,
+        tokenMasked: settings.token === undefined ? null : mask(settings.token),
+        configPath: context.store.path ?? null,
+    };
+    context.out.emit(payload, (styles) => [
+        `${styles.bold("base URL")}  ${payload.baseUrl} (${payload.baseUrlSource})`,
+        `${styles.bold("token")}     ${payload.tokenSource === null
+            ? "none — run `w6w auth login`"
+            : `${payload.tokenMasked} (${payload.tokenSource})`}`,
+        `${styles.bold("config")}    ${payload.configPath ?? "(no config directory)"}`,
+    ].join("\n"));
+};
+/** The three `w6w auth` commands. */
+export const AUTH_COMMANDS = {
+    "auth login": login,
+    "auth logout": logout,
+    "auth status": status,
+};
+//# sourceMappingURL=auth.js.map

package/dist/src/commands/auth.js.map

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

package/dist/src/commands/index.d.ts

@@ -29,6 +29,7 @@ export { APP_COMMANDS } from "./apps.ts";
 export { DASHBOARD_COMMANDS } from "./dashboard.ts";
 export { PROJECT_COMMANDS } from "./projects.ts";
 export { RELIABILITY_COMMANDS } from "./reliability.ts";
+export { AUTH_COMMANDS } from "./auth.ts";
 /** Every wired command, keyed by canonical command path. */
 export declare const COMMANDS: CommandRegistry;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAepD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,4DAA4D;AAC5D,eAAO,MAAM,QAAQ,EAAE,eActB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAgBpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,4DAA4D;AAC5D,eAAO,MAAM,QAAQ,EAAE,eAetB,CAAC"}

package/dist/src/commands/index.js

@@ -28,6 +28,7 @@ import { APP_COMMANDS } from "./apps.js";
 import { DASHBOARD_COMMANDS } from "./dashboard.js";
 import { PROJECT_COMMANDS } from "./projects.js";
 import { RELIABILITY_COMMANDS } from "./reliability.js";
+import { AUTH_COMMANDS } from "./auth.js";
 export { DOCUMENT_COMMANDS } from "./documents.js";
 export { VAR_COMMANDS } from "./vars.js";
 export { ME_COMMANDS } from "./me.js";
@@ -41,6 +42,7 @@ export { APP_COMMANDS } from "./apps.js";
 export { DASHBOARD_COMMANDS } from "./dashboard.js";
 export { PROJECT_COMMANDS } from "./projects.js";
 export { RELIABILITY_COMMANDS } from "./reliability.js";
+export { AUTH_COMMANDS } from "./auth.js";
 /** Every wired command, keyed by canonical command path. */
 export const COMMANDS = {
     ...DOCUMENT_COMMANDS,
@@ -56,5 +58,6 @@ export const COMMANDS = {
     ...DASHBOARD_COMMANDS,
     ...PROJECT_COMMANDS,
     ...RELIABILITY_COMMANDS,
+    ...AUTH_COMMANDS,
 };
 //# sourceMappingURL=index.js.map

package/dist/src/commands/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,4DAA4D;AAC5D,MAAM,CAAC,MAAM,QAAQ,GAAoB;IACvC,GAAG,iBAAiB;IACpB,GAAG,YAAY;IACf,GAAG,WAAW;IACd,GAAG,mBAAmB;IACtB,GAAG,iBAAiB;IACpB,GAAG,iBAAiB;IACpB,GAAG,kBAAkB;IACrB,GAAG,YAAY;IACf,GAAG,aAAa;IAChB,GAAG,YAAY;IACf,GAAG,kBAAkB;IACrB,GAAG,gBAAgB;IACnB,GAAG,oBAAoB;CACxB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,4DAA4D;AAC5D,MAAM,CAAC,MAAM,QAAQ,GAAoB;IACvC,GAAG,iBAAiB;IACpB,GAAG,YAAY;IACf,GAAG,WAAW;IACd,GAAG,mBAAmB;IACtB,GAAG,iBAAiB;IACpB,GAAG,iBAAiB;IACpB,GAAG,kBAAkB;IACrB,GAAG,YAAY;IACf,GAAG,aAAa;IAChB,GAAG,YAAY;IACf,GAAG,kBAAkB;IACrB,GAAG,gBAAgB;IACnB,GAAG,oBAAoB;IACvB,GAAG,aAAa;CACjB,CAAC"}

package/dist/src/config-store.d.ts

@@ -0,0 +1,86 @@
+/**
+ * The per-user config file `w6w auth login` writes, and the rules for it.
+ *
+ * Everything here is **pure**: where the file lives, what a valid file looks
+ * like, how it is parsed and serialised. The one thing that touches a disk is
+ * the {@linkcode ConfigStore} a caller injects — the real one lives in
+ * `src/store-fs.ts`, the only module that does file I/O, and the default
+ * ({@linkcode NO_STORE}) is "nothing stored, nowhere to store it", so a test that
+ * wires nothing never sees a real home directory.
+ *
+ * ```json
+ * {"version":1,"baseUrl":"https://api.w6w.io","hosts":{"https://api.w6w.io":{"token":"…"}}}
+ * ```
+ *
+ * `hosts` is keyed by the canonical base URL (the SDK's `joinBaseUrl` form), and a
+ * token is only ever looked up by exact key — that binding is what stops a token
+ * saved for one host from being sent to another.
+ *
+ * @module
+ */
+import type { EnvReader } from "./client.ts";
+/** What the file holds, once validated. */
+export interface StoredConfig {
+    readonly version: 1;
+    /** The base URL the last `auth login` targeted. Canonical. */
+    readonly baseUrl: string;
+    /** Token per canonical base URL. */
+    readonly hosts: Readonly<Record<string, {
+        readonly token: string;
+    }>>;
+}
+/** Nothing stored. The value used when the file does not exist. */
+export declare const NO_CONFIG: StoredConfig;
+/**
+ * Where the config text lives. The only seam to a disk.
+ *
+ * `read` answers `undefined` for a file that does not exist (nothing stored);
+ * any other failure throws. `write` replaces the file atomically and leaves it
+ * `0600` in a `0700` directory (best-effort on Windows).
+ */
+export interface ConfigStore {
+    /** Absolute path of the file, or `undefined` where none can be resolved. */
+    readonly path: string | undefined;
+    read(): Promise<string | undefined>;
+    write(text: string): Promise<void>;
+}
+/** Standard input, as the `auth login` command needs it. Injected; never read ambiently. */
+export interface StdinSource {
+    /** Whether input is an interactive terminal (then `auth login` never reads it). */
+    isTerminal(): boolean;
+    /** Everything on standard input. */
+    read(): Promise<string>;
+}
+/** The default stdin: an interactive terminal with nothing on it, so nothing is ever read. */
+export declare const NO_STDIN: StdinSource;
+/** The default store: nothing stored, nowhere to store it, no I/O. */
+export declare const NO_STORE: ConfigStore;
+/**
+ * The config file's path, from the environment alone.
+ *
+ * - Windows: `%APPDATA%\w6w\config.json`.
+ * - Elsewhere: `$XDG_CONFIG_HOME/w6w/config.json` when that is set, non-blank and
+ *   **absolute** (the XDG spec says a relative value is ignored), else
+ *   `$HOME/.config/w6w/config.json`.
+ * - Otherwise `undefined`: nothing can be stored.
+ *
+ * @param env - The environment seam (not `os.homedir`: tests substitute it).
+ * @param platform - `"win32"` for Windows; anything else is POSIX-like.
+ */
+export declare function configPath(env: EnvReader, platform: string): string | undefined;
+/**
+ * Validate the file's text.
+ *
+ * @throws {ConfigError} Naming `path` and the kind of problem; never the content.
+ */
+export declare function parseConfig(text: string, path: string | undefined): StoredConfig;
+/** The file's text for a config: exactly the pinned shape, newline-terminated. */
+export declare function serializeConfig(config: StoredConfig): string;
+/**
+ * Read and validate the store.
+ *
+ * @returns {@linkcode NO_CONFIG} for a missing file.
+ * @throws {ConfigError} For an unreadable or malformed one.
+ */
+export declare function loadConfig(store: ConfigStore): Promise<StoredConfig>;
+//# sourceMappingURL=config-store.d.ts.map

package/dist/src/config-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-store.d.ts","sourceRoot":"","sources":["../../src/config-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;CACtE;AAED,mEAAmE;AACnE,eAAO,MAAM,SAAS,EAAE,YAAqD,CAAC;AAE9E;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,IAAI,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACpC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED,4FAA4F;AAC5F,MAAM,WAAW,WAAW;IAC1B,mFAAmF;IACnF,UAAU,IAAI,OAAO,CAAC;IACtB,oCAAoC;IACpC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACzB;AAED,8FAA8F;AAC9F,eAAO,MAAM,QAAQ,EAAE,WAAyE,CAAC;AAEjG,sEAAsE;AACtE,eAAO,MAAM,QAAQ,EAAE,WAStB,CAAC;AAMF;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAiB/E;AAeD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAmBhF;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAG5D;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAU1E"}

package/dist/src/config-store.js

@@ -0,0 +1,129 @@
+/**
+ * The per-user config file `w6w auth login` writes, and the rules for it.
+ *
+ * Everything here is **pure**: where the file lives, what a valid file looks
+ * like, how it is parsed and serialised. The one thing that touches a disk is
+ * the {@linkcode ConfigStore} a caller injects — the real one lives in
+ * `src/store-fs.ts`, the only module that does file I/O, and the default
+ * ({@linkcode NO_STORE}) is "nothing stored, nowhere to store it", so a test that
+ * wires nothing never sees a real home directory.
+ *
+ * ```json
+ * {"version":1,"baseUrl":"https://api.w6w.io","hosts":{"https://api.w6w.io":{"token":"…"}}}
+ * ```
+ *
+ * `hosts` is keyed by the canonical base URL (the SDK's `joinBaseUrl` form), and a
+ * token is only ever looked up by exact key — that binding is what stops a token
+ * saved for one host from being sent to another.
+ *
+ * @module
+ */
+import { ConfigError } from "@w6w/sdk";
+/** Nothing stored. The value used when the file does not exist. */
+export const NO_CONFIG = { version: 1, baseUrl: "", hosts: {} };
+/** The default stdin: an interactive terminal with nothing on it, so nothing is ever read. */
+export const NO_STDIN = { isTerminal: () => true, read: () => Promise.resolve("") };
+/** The default store: nothing stored, nowhere to store it, no I/O. */
+export const NO_STORE = {
+    path: undefined,
+    read: () => Promise.resolve(undefined),
+    write: () => Promise.reject(new ConfigError("There is nowhere to store the token: no per-user config directory resolved.")),
+};
+function isAbsolutePath(path) {
+    return path.startsWith("/") || /^[A-Za-z]:[\\/]/.test(path) || path.startsWith("\\\\");
+}
+/**
+ * The config file's path, from the environment alone.
+ *
+ * - Windows: `%APPDATA%\w6w\config.json`.
+ * - Elsewhere: `$XDG_CONFIG_HOME/w6w/config.json` when that is set, non-blank and
+ *   **absolute** (the XDG spec says a relative value is ignored), else
+ *   `$HOME/.config/w6w/config.json`.
+ * - Otherwise `undefined`: nothing can be stored.
+ *
+ * @param env - The environment seam (not `os.homedir`: tests substitute it).
+ * @param platform - `"win32"` for Windows; anything else is POSIX-like.
+ */
+export function configPath(env, platform) {
+    const pick = (name) => {
+        const value = env(name);
+        return value === undefined || value.trim().length === 0 ? undefined : value;
+    };
+    if (platform === "win32") {
+        const appData = pick("APPDATA");
+        return appData === undefined
+            ? undefined
+            : `${appData.replace(/[\\/]+$/, "")}\\w6w\\config.json`;
+    }
+    const xdg = pick("XDG_CONFIG_HOME");
+    if (xdg !== undefined && isAbsolutePath(xdg)) {
+        return `${xdg.replace(/\/+$/, "")}/w6w/config.json`;
+    }
+    const home = pick("HOME");
+    return home === undefined ? undefined : `${home.replace(/\/+$/, "")}/.config/w6w/config.json`;
+}
+function malformed(path, why) {
+    // The message names the file and the reason class — never the file's content,
+    // which holds tokens.
+    return new ConfigError(`The w6w config file ${path ?? "(unknown path)"} is unreadable or malformed (${why}). ` +
+        "Fix or delete it; w6w will not repair or overwrite it.");
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * Validate the file's text.
+ *
+ * @throws {ConfigError} Naming `path` and the kind of problem; never the content.
+ */
+export function parseConfig(text, path) {
+    let data;
+    try {
+        data = JSON.parse(text);
+    }
+    catch {
+        throw malformed(path, "not valid JSON");
+    }
+    if (!isRecord(data))
+        throw malformed(path, "not a JSON object");
+    if (data.version !== 1)
+        throw malformed(path, "unsupported version");
+    if (typeof data.baseUrl !== "string")
+        throw malformed(path, "`baseUrl` is not a string");
+    if (!isRecord(data.hosts))
+        throw malformed(path, "`hosts` is not an object");
+    const hosts = {};
+    for (const [key, entry] of Object.entries(data.hosts)) {
+        if (!isRecord(entry) || typeof entry.token !== "string") {
+            throw malformed(path, "a host entry has no string `token`");
+        }
+        hosts[key] = { token: entry.token };
+    }
+    return { version: 1, baseUrl: data.baseUrl, hosts };
+}
+/** The file's text for a config: exactly the pinned shape, newline-terminated. */
+export function serializeConfig(config) {
+    return JSON.stringify({ version: 1, baseUrl: config.baseUrl, hosts: config.hosts }, null, 2) +
+        "\n";
+}
+/**
+ * Read and validate the store.
+ *
+ * @returns {@linkcode NO_CONFIG} for a missing file.
+ * @throws {ConfigError} For an unreadable or malformed one.
+ */
+export async function loadConfig(store) {
+    let text;
+    try {
+        text = await store.read();
+    }
+    catch (error) {
+        if (error instanceof ConfigError)
+            throw error;
+        throw malformed(store.path, "could not be read");
+    }
+    if (text === undefined)
+        return NO_CONFIG;
+    return parseConfig(text, store.path);
+}
+//# sourceMappingURL=config-store.js.map

package/dist/src/config-store.js.map

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

package/dist/src/help.generated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"help.generated.d.ts","sourceRoot":"","sources":["../../src/help.generated.ts"],"names":[],"mappings":"AAiBA,0DAA0D;AAC1D,MAAM,WAAW,SAAS;IACxB,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,iDAAiD;AACjD,MAAM,WAAW,WAAW;IAC1B,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC;IACpB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,4EAA4E;AAC5E,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,gDAAgD;IAChD,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,8BAA8B;AAC9B,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,4EAA4E;AAC5E,eAAO,MAAM,SAAS,EAAE,QAulFvB,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,aAAa,EAAE,MAAM,EAAE,EA0OnC,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,UAAU,EAAE,YAAY,EAqBpC,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,MAAU,CAAC;AACtC,eAAO,MAAM,UAAU,EAAE,MAAU,CAAC;AACpC,eAAO,MAAM,cAAc,EAAE,MAAU,CAAC;AACxC,eAAO,MAAM,gBAAgB,EAAE,MAAU,CAAC;AAE1C,wEAAwE;AACxE,eAAO,MAAM,YAAY,EAAE,cAAc,EAA0B,CAAC"}
+{"version":3,"file":"help.generated.d.ts","sourceRoot":"","sources":["../../src/help.generated.ts"],"names":[],"mappings":"AAiBA,0DAA0D;AAC1D,MAAM,WAAW,SAAS;IACxB,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,iDAAiD;AACjD,MAAM,WAAW,WAAW;IAC1B,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC;IACpB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,4EAA4E;AAC5E,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,gDAAgD;IAChD,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,8BAA8B;AAC9B,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,4EAA4E;AAC5E,eAAO,MAAM,SAAS,EAAE,QAusFvB,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,aAAa,EAAE,MAAM,EAAE,EAsPnC,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,UAAU,EAAE,YAAY,EAqBpC,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,MAAU,CAAC;AACtC,eAAO,MAAM,UAAU,EAAE,MAAU,CAAC;AACpC,eAAO,MAAM,cAAc,EAAE,MAAU,CAAC;AACxC,eAAO,MAAM,gBAAgB,EAAE,MAAU,CAAC;AAE1C,wEAAwE;AACxE,eAAO,MAAM,YAAY,EAAE,cAAc,EAA0B,CAAC"}

package/dist/src/help.generated.js

@@ -2587,6 +2587,114 @@ export const HELP_TREE = {
                 "w6w reliability list --project prj_01HQ8N --apps sendgrid,slack",
             ],
         },
+        {
+            "name": "auth",
+            "summary": "Save, remove and inspect the stored API token",
+            "headline": "save, remove and inspect the stored API token",
+            "usage": "w6w auth <command> [options]",
+            "commands": [
+                {
+                    "operation": "auth.login",
+                    "path": [
+                        "auth",
+                        "login",
+                    ],
+                    "name": "login",
+                    "aliases": [],
+                    "summary": "Save an API token for a base URL so later commands authenticate from it.",
+                    "short": "Save an API token for a base URL so later commands authenticate from it",
+                    "headline": "save an API token for a base URL so later commands authenticate from it",
+                    "usage": "w6w auth login [<token>] [options]",
+                    "naming": "w6w auth login [<token>]",
+                    "status": "live",
+                    "params": [
+                        {
+                            "name": "token",
+                            "kind": "argument",
+                            "display": "<token>",
+                            "description": "The API token to save, or `-` to read it from standard input (default when input is piped)",
+                            "required": false,
+                        },
+                        {
+                            "name": "json",
+                            "kind": "flag",
+                            "display": "--json",
+                            "description": "Output raw JSON instead of a table",
+                            "required": false,
+                        },
+                    ],
+                    "examples": [
+                        "printf '%s' \"$W6W_TOKEN\" | w6w auth login -",
+                        "w6w auth login <token>",
+                        "w6w auth login - --base-url https://w6w.example.com",
+                    ],
+                    "notes": [],
+                },
+                {
+                    "operation": "auth.logout",
+                    "path": [
+                        "auth",
+                        "logout",
+                    ],
+                    "name": "logout",
+                    "aliases": [],
+                    "summary": "Remove the stored API token for a base URL.",
+                    "short": "Remove the stored API token for a base URL",
+                    "headline": "remove the stored API token for a base URL",
+                    "usage": "w6w auth logout [options]",
+                    "naming": "w6w auth logout",
+                    "status": "live",
+                    "params": [
+                        {
+                            "name": "json",
+                            "kind": "flag",
+                            "display": "--json",
+                            "description": "Output raw JSON instead of a table",
+                            "required": false,
+                        },
+                    ],
+                    "examples": [
+                        "w6w auth logout",
+                        "w6w auth logout --base-url https://w6w.example.com",
+                    ],
+                    "notes": [],
+                },
+                {
+                    "operation": "auth.status",
+                    "path": [
+                        "auth",
+                        "status",
+                    ],
+                    "name": "status",
+                    "aliases": [],
+                    "summary": "Show the resolved base URL, where it came from, and whether a token is available.",
+                    "short": "Show the resolved base URL, where it came from, and whether a token is available",
+                    "headline": "show the resolved base URL, where it came from, and whether a token is available",
+                    "usage": "w6w auth status [options]",
+                    "naming": "w6w auth status",
+                    "status": "live",
+                    "params": [
+                        {
+                            "name": "json",
+                            "kind": "flag",
+                            "display": "--json",
+                            "description": "Output raw JSON instead of a table",
+                            "required": false,
+                        },
+                    ],
+                    "examples": [
+                        "w6w auth status",
+                        "w6w auth status --json",
+                    ],
+                    "notes": [],
+                },
+            ],
+            "options": [],
+            "examples": [
+                "w6w auth status",
+                "printf '%s' \"$W6W_TOKEN\" | w6w auth login -",
+            ],
+        },
     ],
     "globalFlags": [
         {
@@ -2595,7 +2703,7 @@ export const HELP_TREE = {
             "type": "string",
             "env": "W6W_BASE_URL",
             "display": "--base-url <url>",
-            "description": "API base URL (env: W6W_BASE_URL)",
+            "description": "API base URL (default: https://api.w6w.io) (env: W6W_BASE_URL)",
         },
         {
             "name": "--token",
@@ -2603,7 +2711,7 @@ export const HELP_TREE = {
             "type": "string",
             "env": "W6W_TOKEN",
             "display": "--token <token>",
-            "description": "API token (env: W6W_TOKEN)",
+            "description": "API token (or save one: w6w auth login) (env: W6W_TOKEN)",
         },
         {
             "name": "--json",
@@ -2882,6 +2990,18 @@ export const COMMAND_PATHS = [
         "reliability",
         "members",
     ],
+    [
+        "auth",
+        "login",
+    ],
+    [
+        "auth",
+        "logout",
+    ],
+    [
+        "auth",
+        "status",
+    ],
 ];
 /** The exit-code contract, verbatim from the shared contract's `cli.exitCodes`. */
 export const EXIT_CODES = [