synthetic-search 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 synthetic-search 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/README.md

@@ -0,0 +1,125 @@
+# synthetic-search
+
+A user-facing CLI for Synthetic web search, quotas, and local credential management.
+
+## Features
+
+- Search the public web with Synthetic (`/v2/search`)
+- View account usage and limits (`/v2/quotas`)
+- Interactive local auth setup (`auth login` / `auth logout` / `auth status`)
+- Readable terminal output by default
+- `--json` output mode for scripts and automation
+- Tolerant JSON parsing for malformed control characters in API responses
+
+## Requirements
+
+- Node.js 18+
+- Synthetic API key
+
+## Installation
+
+```bash
+npm install -g synthetic-search
+```
+
+Or run directly with `npx`:
+
+```bash
+npx -y synthetic-search --help
+```
+
+## Authentication
+
+`SYNTHETIC_API_KEY` always takes priority over saved config.
+
+### Environment variable (recommended for CI)
+
+```bash
+export SYNTHETIC_API_KEY=your_api_key_here
+```
+
+### Saved local config
+
+```bash
+synthetic-search auth login
+```
+
+This validates the key via `GET /v2/quotas` before saving.
+
+Skip validation:
+
+```bash
+synthetic-search auth login --no-validate
+```
+
+Check status:
+
+```bash
+synthetic-search auth status
+```
+
+Remove saved key:
+
+```bash
+synthetic-search auth logout
+synthetic-search auth logout --force
+```
+
+## Usage
+
+### Search
+
+Root command and subcommand are equivalent:
+
+```bash
+synthetic-search latest model context protocol news
+synthetic-search search latest model context protocol news
+```
+
+Read query from piped stdin:
+
+```bash
+echo "latest ai safety research" | synthetic-search search
+```
+
+JSON output:
+
+```bash
+synthetic-search search "latest mcp updates" --json
+```
+
+Client-side result limit:
+
+```bash
+synthetic-search search "latest mcp updates" --limit 2
+```
+
+### Quotas
+
+```bash
+synthetic-search quotas
+synthetic-search quotas --json
+```
+
+## API Endpoints
+
+- `POST https://api.synthetic.new/v2/search`
+- `GET https://api.synthetic.new/v2/quotas`
+
+## Development
+
+```bash
+npm install
+npm run test
+npm run build
+```
+
+Run in dev mode:
+
+```bash
+npm run dev -- search "latest llm tooling"
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { type FetchLike } from "./lib/client.js";
+type ReadableLike = AsyncIterable<Uint8Array | string> & {
+    isTTY?: boolean;
+};
+type WritableLike = {
+    write: (chunk: string) => unknown;
+    isTTY?: boolean;
+    columns?: number;
+};
+export type CliIO = {
+    stdin: ReadableLike;
+    stdout: WritableLike;
+    stderr: WritableLike;
+};
+type PromptApi = {
+    password: (options: {
+        message: string;
+        mask?: string;
+    }) => Promise<string>;
+    confirm: (options: {
+        message: string;
+        default?: boolean;
+    }) => Promise<boolean>;
+};
+export type RunCliOptions = {
+    io?: CliIO;
+    env?: NodeJS.ProcessEnv;
+    fetchImpl?: FetchLike;
+    configDir?: string;
+    prompts?: Partial<PromptApi>;
+};
+type CommandContext = {
+    io: CliIO;
+    env: NodeJS.ProcessEnv;
+    fetchImpl: FetchLike;
+    configDir?: string;
+    prompts: PromptApi;
+};
+export declare function createProgram(context: CommandContext): Command;
+export declare function runCli(argv?: string[], options?: RunCliOptions): Promise<number>;
+export {};

package/dist/index.js

@@ -0,0 +1,288 @@
+#!/usr/bin/env node
+import { confirm as promptConfirm, password as promptPassword } from "@inquirer/prompts";
+import { Command, CommanderError } from "commander";
+import { pathToFileURL } from "node:url";
+import { deleteSavedApiKey, hasSavedApiKey, maskApiKey, resolveCredentials, saveApiKey, } from "./lib/auth.js";
+import { getQuotas, search } from "./lib/client.js";
+import { SyntheticCliError, SyntheticUsageError, getErrorMessage } from "./lib/errors.js";
+import { renderQuotasText, renderSearchResultsText, writeJson, writeJsonError } from "./lib/output.js";
+const DEFAULT_PROMPTS = {
+    password: (options) => promptPassword(options),
+    confirm: (options) => promptConfirm(options),
+};
+function routeRootToSearch(argv) {
+    const firstArg = argv[0];
+    if (firstArg === undefined) {
+        return ["search"];
+    }
+    if (["search", "quotas", "auth", "help"].includes(firstArg)) {
+        return argv;
+    }
+    if (["--help", "-h", "--version", "-V"].includes(firstArg)) {
+        return argv;
+    }
+    if (firstArg.startsWith("-")) {
+        return ["search", ...argv];
+    }
+    return ["search", ...argv];
+}
+function wantsJsonOutput(argv) {
+    return argv.includes("--json");
+}
+function toOutputWidth(stdout) {
+    const columns = stdout.columns;
+    if (typeof columns === "number" && Number.isFinite(columns) && columns > 20) {
+        return columns;
+    }
+    return 80;
+}
+function isInteractive(io) {
+    return Boolean(io.stdin.isTTY && io.stdout.isTTY);
+}
+function parseLimit(limitValue) {
+    if (limitValue === undefined) {
+        return undefined;
+    }
+    const parsed = Number.parseInt(limitValue, 10);
+    if (!Number.isInteger(parsed) || parsed <= 0) {
+        throw new SyntheticUsageError("--limit must be a positive integer.");
+    }
+    return parsed;
+}
+async function readQueryFromInput(queryParts, stdin) {
+    if (queryParts.length > 0) {
+        const joinedQuery = queryParts.join(" ").trim();
+        return joinedQuery || null;
+    }
+    if (stdin.isTTY) {
+        return null;
+    }
+    let body = "";
+    for await (const chunk of stdin) {
+        body += typeof chunk === "string" ? chunk : Buffer.from(chunk).toString("utf8");
+    }
+    const trimmed = body.trim();
+    return trimmed || null;
+}
+function resolveApiKey(context) {
+    const resolved = resolveCredentials({
+        env: context.env,
+        configDir: context.configDir,
+    });
+    if (!resolved.apiKey) {
+        throw new SyntheticCliError("No Synthetic API key configured. Set SYNTHETIC_API_KEY or run `synthetic-search auth login`.");
+    }
+    return resolved.apiKey;
+}
+function applyLimit(items, limit) {
+    if (limit === undefined) {
+        return items;
+    }
+    return items.slice(0, limit);
+}
+async function runSearchCommand(queryParts, options, command, context) {
+    const query = await readQueryFromInput(queryParts, context.io.stdin);
+    if (!query) {
+        throw new SyntheticUsageError(`Query is required.\n\n${command.helpInformation()}`);
+    }
+    const limit = parseLimit(options.limit);
+    const apiKey = resolveApiKey(context);
+    const results = applyLimit(await search(query, apiKey, context.fetchImpl), limit);
+    if (options.json) {
+        writeJson(context.io.stdout, { results });
+        return;
+    }
+    context.io.stdout.write(`${renderSearchResultsText(results, toOutputWidth(context.io.stdout))}\n`);
+}
+async function runQuotasCommand(options, context) {
+    const apiKey = resolveApiKey(context);
+    const quotas = await getQuotas(apiKey, context.fetchImpl);
+    if (options.json) {
+        writeJson(context.io.stdout, quotas);
+        return;
+    }
+    context.io.stdout.write(`${renderQuotasText(quotas)}\n`);
+}
+async function runAuthLoginCommand(options, context) {
+    if (!isInteractive(context.io)) {
+        throw new SyntheticUsageError("auth login requires an interactive terminal.");
+    }
+    const apiKey = (await context.prompts.password({
+        message: "Enter your Synthetic API key",
+        mask: "*",
+    })).trim();
+    if (!apiKey) {
+        throw new SyntheticUsageError("API key cannot be empty.");
+    }
+    if (options.validate) {
+        try {
+            await getQuotas(apiKey, context.fetchImpl);
+        }
+        catch (error) {
+            throw new SyntheticCliError(`API key validation failed: ${getErrorMessage(error)}`);
+        }
+    }
+    saveApiKey(apiKey, { configDir: context.configDir });
+    context.io.stdout.write(options.validate ? "API key saved after validation.\n" : "API key saved without validation.\n");
+}
+async function runAuthLogoutCommand(options, context) {
+    if (!hasSavedApiKey({ configDir: context.configDir })) {
+        context.io.stdout.write("No saved API key found.\n");
+        return;
+    }
+    if (!options.force) {
+        if (!isInteractive(context.io)) {
+            throw new SyntheticUsageError("Use --force to logout in non-interactive mode.");
+        }
+        const confirmed = await context.prompts.confirm({
+            message: "Remove the saved Synthetic API key?",
+            default: false,
+        });
+        if (!confirmed) {
+            context.io.stdout.write("Logout cancelled.\n");
+            return;
+        }
+    }
+    deleteSavedApiKey({ configDir: context.configDir });
+    context.io.stdout.write("Saved API key removed.\n");
+}
+async function runAuthStatusCommand(context) {
+    const credentials = resolveCredentials({
+        env: context.env,
+        configDir: context.configDir,
+    });
+    if (credentials.source === "none" || !credentials.apiKey) {
+        context.io.stdout.write("Credential source: not configured\n");
+        return;
+    }
+    context.io.stdout.write(`Credential source: ${credentials.source}\n`);
+    context.io.stdout.write(`API key: ${maskApiKey(credentials.apiKey)}\n`);
+    try {
+        const quotas = await getQuotas(credentials.apiKey, context.fetchImpl);
+        context.io.stdout.write("Validation: ok\n");
+        context.io.stdout.write(`${renderQuotasText(quotas)}\n`);
+    }
+    catch (error) {
+        context.io.stdout.write("Validation: failed\n");
+        throw new SyntheticCliError(`Credential validation failed: ${getErrorMessage(error)}`);
+    }
+}
+function registerSearchCommand(command, context) {
+    command
+        .argument("[query...]", "Search query")
+        .option("--json", "Output results as JSON")
+        .option("--limit <n>", "Limit number of results")
+        .action(async (queryParts, options, cmd) => {
+        await runSearchCommand(Array.isArray(queryParts) ? queryParts : [], options, cmd, context);
+    });
+}
+export function createProgram(context) {
+    const program = new Command();
+    program
+        .name("synthetic-search")
+        .description("Search the public web with Synthetic and inspect account quotas.");
+    registerSearchCommand(program.command("search").description("Search the public web with Synthetic."), context);
+    program
+        .command("quotas")
+        .description("Show current Synthetic quota usage.")
+        .option("--json", "Output quotas as JSON")
+        .action(async (options) => {
+        await runQuotasCommand(options, context);
+    });
+    const authCommand = program.command("auth").description("Manage Synthetic API credentials.");
+    authCommand
+        .command("login")
+        .description("Save an API key after optional validation.")
+        .option("--no-validate", "Skip live validation against /v2/quotas")
+        .action(async (options) => {
+        await runAuthLoginCommand(options, context);
+    });
+    authCommand
+        .command("logout")
+        .description("Remove the saved API key.")
+        .option("--force", "Skip confirmation prompt")
+        .action(async (options) => {
+        await runAuthLogoutCommand(options, context);
+    });
+    authCommand
+        .command("status")
+        .description("Show credential source and validation status.")
+        .action(async () => {
+        await runAuthStatusCommand(context);
+    });
+    program.showHelpAfterError();
+    return program;
+}
+export async function runCli(argv = process.argv.slice(2), options = {}) {
+    const io = options.io ??
+        {
+            stdin: process.stdin,
+            stdout: process.stdout,
+            stderr: process.stderr,
+        };
+    const env = options.env ?? process.env;
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const jsonMode = wantsJsonOutput(argv);
+    const context = {
+        io,
+        env,
+        fetchImpl,
+        configDir: options.configDir,
+        prompts: {
+            ...DEFAULT_PROMPTS,
+            ...options.prompts,
+        },
+    };
+    const program = createProgram(context);
+    program.configureOutput({
+        writeOut: (text) => {
+            io.stdout.write(text);
+        },
+        writeErr: (text) => {
+            if (!jsonMode) {
+                io.stderr.write(text);
+            }
+        },
+    });
+    program.exitOverride();
+    try {
+        const routedArgv = routeRootToSearch(argv);
+        await program.parseAsync(routedArgv, { from: "user" });
+        return 0;
+    }
+    catch (error) {
+        if (error instanceof CommanderError) {
+            if (error.exitCode !== 0 && jsonMode) {
+                writeJsonError(io.stderr, error.message);
+            }
+            return error.exitCode;
+        }
+        const message = getErrorMessage(error);
+        if (jsonMode) {
+            writeJsonError(io.stderr, message);
+        }
+        else {
+            io.stderr.write(`${message}\n`);
+        }
+        if (error instanceof SyntheticCliError) {
+            return error.exitCode;
+        }
+        return 1;
+    }
+}
+function isDirectExecution() {
+    const entry = process.argv[1];
+    if (!entry) {
+        return false;
+    }
+    return pathToFileURL(entry).href === import.meta.url;
+}
+if (isDirectExecution()) {
+    runCli().then((exitCode) => {
+        process.exitCode = exitCode;
+    }, (error) => {
+        process.stderr.write(`${getErrorMessage(error)}\n`);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACzF,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,UAAU,GACX,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,EAAkB,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC1F,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAwDvG,MAAM,eAAe,GAAc;IACjC,QAAQ,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC;IAC9C,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC;CAC7C,CAAC;AAEF,SAAS,iBAAiB,CAAC,IAAc;IACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAEzB,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpB,CAAC;IAED,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,eAAe,CAAC,IAAc;IACrC,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,aAAa,CAAC,MAAoB;IACzC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAE/B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,EAAE,EAAE,CAAC;QAC5E,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,aAAa,CAAC,EAAS;IAC9B,OAAO,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,UAAU,CAAC,UAA8B;IAChD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAE/C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,mBAAmB,CAAC,qCAAqC,CAAC,CAAC;IACvE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,UAAoB,EAAE,KAAmB;IACzE,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAChD,OAAO,WAAW,IAAI,IAAI,CAAC;IAC7B,CAAC;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,IAAI,GAAG,EAAE,CAAC;IAEd,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAChC,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAClF,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAE5B,OAAO,OAAO,IAAI,IAAI,CAAC;AACzB,CAAC;AAED,SAAS,aAAa,CAAC,OAAuB;IAC5C,MAAM,QAAQ,GAAG,kBAAkB,CAAC;QAClC,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,SAAS,EAAE,OAAO,CAAC,SAAS;KAC7B,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACrB,MAAM,IAAI,iBAAiB,CACzB,8FAA8F,CAC/F,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC,MAAM,CAAC;AACzB,CAAC;AAED,SAAS,UAAU,CAAI,KAAU,EAAE,KAAyB;IAC1D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,UAAoB,EACpB,OAA6B,EAC7B,OAAgB,EAChB,OAAuB;IAEvB,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IAErE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,mBAAmB,CAAC,yBAAyB,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC;IAElF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC1C,OAAO;IACT,CAAC;IAED,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,uBAAuB,CAAC,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;AACrG,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,OAA6B,EAAE,OAAuB;IACpF,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAE1D,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACrC,OAAO;IACT,CAAC;IAED,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED,KAAK,UAAU,mBAAmB,CAChC,OAAgC,EAChC,OAAuB;IAEvB,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,mBAAmB,CAAC,8CAA8C,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,MAAM,GAAG,CACb,MAAM,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;QAC7B,OAAO,EAAE,8BAA8B;QACvC,IAAI,EAAE,GAAG;KACV,CAAC,CACH,CAAC,IAAI,EAAE,CAAC;IAET,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,mBAAmB,CAAC,0BAA0B,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,iBAAiB,CAAC,8BAA8B,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IAED,UAAU,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAErD,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CACrB,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAC,CAAC,qCAAqC,CAC/F,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,oBAAoB,CACjC,OAAiC,EACjC,OAAuB;IAEvB,IAAI,CAAC,cAAc,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC;QACtD,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;QACrD,OAAO;IACT,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,mBAAmB,CAAC,gDAAgD,CAAC,CAAC;QAClF,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;YAC9C,OAAO,EAAE,qCAAqC;YAC9C,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;YAC/C,OAAO;QACT,CAAC;IACH,CAAC;IAED,iBAAiB,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACpD,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;AACtD,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAC,OAAuB;IACzD,MAAM,WAAW,GAAG,kBAAkB,CAAC;QACrC,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,SAAS,EAAE,OAAO,CAAC,SAAS;KAC7B,CAAC,CAAC;IAEH,IAAI,WAAW,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;QACzD,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAC/D,OAAO;IACT,CAAC;IAED,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,WAAW,CAAC,MAAM,IAAI,CAAC,CAAC;IACtE,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAExE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAEtE,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAC5C,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAChD,MAAM,IAAI,iBAAiB,CAAC,iCAAiC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACzF,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAgB,EAAE,OAAuB;IACtE,OAAO;SACJ,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC;SACtC,MAAM,CAAC,QAAQ,EAAE,wBAAwB,CAAC;SAC1C,MAAM,CAAC,aAAa,EAAE,yBAAyB,CAAC;SAChD,MAAM,CAAC,KAAK,EAAE,UAAgC,EAAE,OAA6B,EAAE,GAAY,EAAE,EAAE;QAC9F,MAAM,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAC7F,CAAC,CAAC,CAAC;AACP,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAuB;IACnD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,kBAAkB,CAAC;SACxB,WAAW,CAAC,kEAAkE,CAAC,CAAC;IAEnF,qBAAqB,CACnB,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,uCAAuC,CAAC,EAC9E,OAAO,CACR,CAAC;IAEF,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,qCAAqC,CAAC;SAClD,MAAM,CAAC,QAAQ,EAAE,uBAAuB,CAAC;SACzC,MAAM,CAAC,KAAK,EAAE,OAA6B,EAAE,EAAE;QAC9C,MAAM,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEL,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,mCAAmC,CAAC,CAAC;IAE7F,WAAW;SACR,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,4CAA4C,CAAC;SACzD,MAAM,CAAC,eAAe,EAAE,yCAAyC,CAAC;SAClE,MAAM,CAAC,KAAK,EAAE,OAAgC,EAAE,EAAE;QACjD,MAAM,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEL,WAAW;SACR,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,2BAA2B,CAAC;SACxC,MAAM,CAAC,SAAS,EAAE,0BAA0B,CAAC;SAC7C,MAAM,CAAC,KAAK,EAAE,OAAiC,EAAE,EAAE;QAClD,MAAM,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEL,WAAW;SACR,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,+CAA+C,CAAC;SAC5D,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEL,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAE7B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,OAAiB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EACtC,UAAyB,EAAE;IAE3B,MAAM,EAAE,GACN,OAAO,CAAC,EAAE;QACT;YACC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM,EAAE,OAAO,CAAC,MAAM;SACb,CAAC;IAEd,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;IAC7C,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAEvC,MAAM,OAAO,GAAmB;QAC9B,EAAE;QACF,GAAG;QACH,SAAS;QACT,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,OAAO,EAAE;YACP,GAAG,eAAe;YAClB,GAAG,OAAO,CAAC,OAAO;SACnB;KACF,CAAC;IAEF,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IAEvC,OAAO,CAAC,eAAe,CAAC;QACtB,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;YACjB,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;QACD,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;YACjB,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,CAAC,YAAY,EAAE,CAAC;IAEvB,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACvD,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;YACpC,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC,IAAI,QAAQ,EAAE,CAAC;gBACrC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YAC3C,CAAC;YAED,OAAO,KAAK,CAAC,QAAQ,CAAC;QACxB,CAAC;QAED,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QAEvC,IAAI,QAAQ,EAAE,CAAC;YACb,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,CAAC;aAAM,CAAC;YACN,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;QAClC,CAAC;QAED,IAAI,KAAK,YAAY,iBAAiB,EAAE,CAAC;YACvC,OAAO,KAAK,CAAC,QAAQ,CAAC;QACxB,CAAC;QAED,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB;IACxB,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAE9B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;AACvD,CAAC;AAED,IAAI,iBAAiB,EAAE,EAAE,CAAC;IACxB,MAAM,EAAE,CAAC,IAAI,CACX,CAAC,QAAQ,EAAE,EAAE;QACX,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC9B,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;QACR,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/lib/auth.d.ts

@@ -0,0 +1,11 @@
+import type { ResolvedCredentials } from "../types.js";
+export type AuthOptions = {
+    env?: NodeJS.ProcessEnv;
+    configDir?: string;
+};
+export declare function resolveCredentials(options?: AuthOptions): ResolvedCredentials;
+export declare function getSavedApiKey(options?: AuthOptions): string | null;
+export declare function saveApiKey(apiKey: string, options?: AuthOptions): void;
+export declare function deleteSavedApiKey(options?: AuthOptions): boolean;
+export declare function hasSavedApiKey(options?: AuthOptions): boolean;
+export declare function maskApiKey(apiKey: string): string;

package/dist/lib/auth.js

@@ -0,0 +1,74 @@
+import Conf from "conf";
+import { SyntheticUsageError } from "./errors.js";
+function createStore(configDir) {
+    return new Conf({
+        projectName: "synthetic-search",
+        cwd: configDir,
+    });
+}
+function normalizeKey(value) {
+    return value.trim();
+}
+export function resolveCredentials(options = {}) {
+    const env = options.env ?? process.env;
+    const envApiKey = env.SYNTHETIC_API_KEY?.trim();
+    if (envApiKey) {
+        return {
+            source: "env",
+            apiKey: envApiKey,
+        };
+    }
+    const savedApiKey = getSavedApiKey(options);
+    if (savedApiKey) {
+        return {
+            source: "config",
+            apiKey: savedApiKey,
+        };
+    }
+    return {
+        source: "none",
+        apiKey: null,
+    };
+}
+export function getSavedApiKey(options = {}) {
+    const store = createStore(options.configDir);
+    const value = store.get("apiKey");
+    if (typeof value !== "string") {
+        return null;
+    }
+    const normalized = normalizeKey(value);
+    return normalized || null;
+}
+export function saveApiKey(apiKey, options = {}) {
+    const normalized = normalizeKey(apiKey);
+    if (!normalized) {
+        throw new SyntheticUsageError("API key cannot be empty.");
+    }
+    const store = createStore(options.configDir);
+    store.set("apiKey", normalized);
+}
+export function deleteSavedApiKey(options = {}) {
+    const store = createStore(options.configDir);
+    if (!store.has("apiKey")) {
+        return false;
+    }
+    store.delete("apiKey");
+    return true;
+}
+export function hasSavedApiKey(options = {}) {
+    const store = createStore(options.configDir);
+    return store.has("apiKey");
+}
+export function maskApiKey(apiKey) {
+    const normalized = normalizeKey(apiKey);
+    if (!normalized) {
+        return "(empty)";
+    }
+    if (normalized.length <= 8) {
+        const first = normalized[0] ?? "";
+        const last = normalized.at(-1) ?? "";
+        return `${first}***${last}`;
+    }
+    return `${normalized.slice(0, 4)}...${normalized.slice(-4)}`;
+}
+//# sourceMappingURL=auth.js.map

package/dist/lib/auth.js.map

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

package/dist/lib/client.d.ts

@@ -0,0 +1,4 @@
+import type { SyntheticQuotas, SyntheticSearchResult } from "../types.js";
+export type FetchLike = typeof fetch;
+export declare function search(query: string, apiKey: string, fetchImpl?: FetchLike): Promise<SyntheticSearchResult[]>;
+export declare function getQuotas(apiKey: string, fetchImpl?: FetchLike): Promise<SyntheticQuotas>;

package/dist/lib/client.js

@@ -0,0 +1,163 @@
+import { SyntheticApiError, SyntheticCliError, getErrorMessage } from "./errors.js";
+import { parseSyntheticJson, truncateText, tryParseSyntheticJson } from "./json.js";
+const SYNTHETIC_SEARCH_URL = "https://api.synthetic.new/v2/search";
+const SYNTHETIC_QUOTAS_URL = "https://api.synthetic.new/v2/quotas";
+const MAX_TEXT_LENGTH = 2000;
+function normalizeResult(rawResult) {
+    if (typeof rawResult !== "object" || rawResult === null) {
+        return null;
+    }
+    const result = rawResult;
+    const url = typeof result.url === "string" ? result.url : null;
+    const title = typeof result.title === "string" ? result.title : null;
+    const text = typeof result.text === "string" ? result.text : null;
+    const published = typeof result.published === "string" ? result.published : null;
+    if (!url || !title || !text) {
+        return null;
+    }
+    return {
+        url,
+        title,
+        text: truncateText(text, MAX_TEXT_LENGTH),
+        published,
+    };
+}
+function formatApiError(status, bodyText) {
+    const body = bodyText.trim();
+    if (!body) {
+        return `Synthetic API request failed with status ${status}.`;
+    }
+    const parsed = tryParseSyntheticJson(body);
+    if (parsed) {
+        const message = typeof parsed.error === "string"
+            ? parsed.error
+            : typeof parsed.message === "string"
+                ? parsed.message
+                : null;
+        if (message) {
+            return `Synthetic API request failed with status ${status}: ${message}`;
+        }
+    }
+    return `Synthetic API request failed with status ${status}: ${truncateText(body, 400)}`;
+}
+function coerceNumber(value) {
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return value;
+    }
+    if (typeof value === "string" && value.trim()) {
+        const parsed = Number(value);
+        if (Number.isFinite(parsed)) {
+            return parsed;
+        }
+    }
+    return null;
+}
+function coerceString(value) {
+    if (typeof value === "string" && value.trim()) {
+        return value;
+    }
+    return null;
+}
+function getNestedRecords(raw) {
+    const records = [raw];
+    for (const key of ["quota", "quotas", "subscription", "plan", "data"]) {
+        const candidate = raw[key];
+        if (typeof candidate === "object" && candidate !== null && !Array.isArray(candidate)) {
+            records.push(candidate);
+        }
+    }
+    return records;
+}
+function pickNumber(records, keys) {
+    for (const record of records) {
+        for (const key of keys) {
+            const value = coerceNumber(record[key]);
+            if (value !== null) {
+                return value;
+            }
+        }
+    }
+    return null;
+}
+function pickString(records, keys) {
+    for (const record of records) {
+        for (const key of keys) {
+            const value = coerceString(record[key]);
+            if (value !== null) {
+                return value;
+            }
+        }
+    }
+    return null;
+}
+function normalizeQuotas(rawValue) {
+    if (typeof rawValue !== "object" || rawValue === null || Array.isArray(rawValue)) {
+        throw new SyntheticCliError("Synthetic API quotas response did not include a valid JSON object.");
+    }
+    const raw = rawValue;
+    const records = getNestedRecords(raw);
+    const limit = pickNumber(records, ["limit", "request_limit", "requests_limit", "quota_limit"]);
+    const requestsUsed = pickNumber(records, [
+        "requests_used",
+        "requestsUsed",
+        "used",
+        "usage",
+        "request_count",
+    ]);
+    const remaining = pickNumber(records, ["remaining", "requests_remaining", "requestsRemaining"]);
+    const renewsAt = pickString(records, ["renews_at", "renewsAt", "reset_at", "resetAt", "resets_at"]) ?? null;
+    if (limit === null || requestsUsed === null || remaining === null) {
+        throw new SyntheticCliError("Synthetic API quotas response did not include valid limit, requests used, and remaining values.");
+    }
+    return {
+        limit,
+        requestsUsed,
+        remaining,
+        renewsAt,
+    };
+}
+async function syntheticFetch(url, init, fetchImpl) {
+    let response;
+    try {
+        response = await fetchImpl(url, init);
+    }
+    catch (error) {
+        throw new SyntheticApiError(`Synthetic API request failed: ${getErrorMessage(error)}`);
+    }
+    const rawText = await response.text();
+    return { response, rawText };
+}
+export async function search(query, apiKey, fetchImpl = fetch) {
+    const { response, rawText } = await syntheticFetch(SYNTHETIC_SEARCH_URL, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${apiKey}`,
+        },
+        body: JSON.stringify({ query }),
+    }, fetchImpl);
+    if (!response.ok) {
+        throw new SyntheticApiError(formatApiError(response.status, rawText), response.status);
+    }
+    const parsed = parseSyntheticJson(rawText);
+    if (!Array.isArray(parsed.results)) {
+        throw new SyntheticCliError("Synthetic API response did not include a valid results array.");
+    }
+    return parsed.results
+        .map((result) => normalizeResult(result))
+        .filter((result) => result !== null);
+}
+export async function getQuotas(apiKey, fetchImpl = fetch) {
+    const { response, rawText } = await syntheticFetch(SYNTHETIC_QUOTAS_URL, {
+        method: "GET",
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+        },
+    }, fetchImpl);
+    if (!response.ok) {
+        throw new SyntheticApiError(formatApiError(response.status, rawText), response.status);
+    }
+    const parsed = parseSyntheticJson(rawText);
+    return normalizeQuotas(parsed);
+}
+//# sourceMappingURL=client.js.map

package/dist/lib/client.js.map

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

package/dist/lib/errors.d.ts

@@ -0,0 +1,12 @@
+export declare class SyntheticCliError extends Error {
+    readonly exitCode: number;
+    constructor(message: string, exitCode?: number);
+}
+export declare class SyntheticUsageError extends SyntheticCliError {
+    constructor(message: string);
+}
+export declare class SyntheticApiError extends SyntheticCliError {
+    readonly status: number | null;
+    constructor(message: string, status?: number | null);
+}
+export declare function getErrorMessage(error: unknown): string;

package/dist/lib/errors.js

@@ -0,0 +1,29 @@
+export class SyntheticCliError extends Error {
+    exitCode;
+    constructor(message, exitCode = 1) {
+        super(message);
+        this.name = "SyntheticCliError";
+        this.exitCode = exitCode;
+    }
+}
+export class SyntheticUsageError extends SyntheticCliError {
+    constructor(message) {
+        super(message, 1);
+        this.name = "SyntheticUsageError";
+    }
+}
+export class SyntheticApiError extends SyntheticCliError {
+    status;
+    constructor(message, status = null) {
+        super(message, 1);
+        this.name = "SyntheticApiError";
+        this.status = status;
+    }
+}
+export function getErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,QAAQ,CAAS;IAE1B,YAAY,OAAe,EAAE,QAAQ,GAAG,CAAC;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,iBAAiB;IACxD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,iBAAiB;IAC7C,MAAM,CAAgB;IAE/B,YAAY,OAAe,EAAE,SAAwB,IAAI;QACvD,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}

package/dist/lib/json.d.ts

@@ -0,0 +1,4 @@
+export declare function truncateText(value: string, maxLength: number): string;
+export declare function sanitizeJsonResponse(rawText: string): string;
+export declare function parseSyntheticJson<T>(rawText: string): T;
+export declare function tryParseSyntheticJson<T>(rawText: string): T | null;

package/dist/lib/json.js

@@ -0,0 +1,76 @@
+import { SyntheticCliError } from "./errors.js";
+export function truncateText(value, maxLength) {
+    if (value.length <= maxLength) {
+        return value;
+    }
+    return `${value.slice(0, maxLength - 3)}...`;
+}
+function escapeJsonControlCharacter(charCode) {
+    switch (charCode) {
+        case 0x08:
+            return "\\b";
+        case 0x09:
+            return "\\t";
+        case 0x0a:
+            return "\\n";
+        case 0x0c:
+            return "\\f";
+        case 0x0d:
+            return "\\r";
+        default:
+            return `\\u${charCode.toString(16).padStart(4, "0")}`;
+    }
+}
+export function sanitizeJsonResponse(rawText) {
+    let sanitized = "";
+    let inString = false;
+    let isEscaping = false;
+    for (const char of rawText) {
+        const charCode = char.charCodeAt(0);
+        if (!inString) {
+            if (char === '"') {
+                inString = true;
+            }
+            sanitized += char;
+            continue;
+        }
+        if (isEscaping) {
+            sanitized += char;
+            isEscaping = false;
+            continue;
+        }
+        if (char === "\\") {
+            sanitized += char;
+            isEscaping = true;
+            continue;
+        }
+        if (char === '"') {
+            sanitized += char;
+            inString = false;
+            continue;
+        }
+        if (charCode <= 0x1f) {
+            sanitized += escapeJsonControlCharacter(charCode);
+            continue;
+        }
+        sanitized += char;
+    }
+    return sanitized;
+}
+export function parseSyntheticJson(rawText) {
+    try {
+        return JSON.parse(sanitizeJsonResponse(rawText));
+    }
+    catch (error) {
+        throw new SyntheticCliError(`Synthetic API returned malformed JSON that could not be parsed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+export function tryParseSyntheticJson(rawText) {
+    try {
+        return JSON.parse(sanitizeJsonResponse(rawText));
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=json.js.map

package/dist/lib/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/lib/json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,SAAiB;IAC3D,IAAI,KAAK,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC;AAC/C,CAAC;AAED,SAAS,0BAA0B,CAAC,QAAgB;IAClD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,IAAI;YACP,OAAO,KAAK,CAAC;QACf,KAAK,IAAI;YACP,OAAO,KAAK,CAAC;QACf,KAAK,IAAI;YACP,OAAO,KAAK,CAAC;QACf,KAAK,IAAI;YACP,OAAO,KAAK,CAAC;QACf,KAAK,IAAI;YACP,OAAO,KAAK,CAAC;QACf;YACE,OAAO,MAAM,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IAC1D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,IAAI,SAAS,GAAG,EAAE,CAAC;IACnB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,UAAU,GAAG,KAAK,CAAC;IAEvB,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAEpC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACjB,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC;YAED,SAAS,IAAI,IAAI,CAAC;YAClB,SAAS;QACX,CAAC;QAED,IAAI,UAAU,EAAE,CAAC;YACf,SAAS,IAAI,IAAI,CAAC;YAClB,UAAU,GAAG,KAAK,CAAC;YACnB,SAAS;QACX,CAAC;QAED,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,SAAS,IAAI,IAAI,CAAC;YAClB,UAAU,GAAG,IAAI,CAAC;YAClB,SAAS;QACX,CAAC;QAED,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,SAAS,IAAI,IAAI,CAAC;YAClB,QAAQ,GAAG,KAAK,CAAC;YACjB,SAAS;QACX,CAAC;QAED,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;YACrB,SAAS,IAAI,0BAA0B,CAAC,QAAQ,CAAC,CAAC;YAClD,SAAS;QACX,CAAC;QAED,SAAS,IAAI,IAAI,CAAC;IACpB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAI,OAAe;IACnD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAM,CAAC;IACxD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,iBAAiB,CACzB,mEACE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,EAAE,CACH,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAI,OAAe;IACtD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAM,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/lib/output.d.ts

@@ -0,0 +1,8 @@
+import type { SyntheticQuotas, SyntheticSearchResult } from "../types.js";
+export type WritableLike = {
+    write: (chunk: string) => unknown;
+};
+export declare function renderSearchResultsText(results: SyntheticSearchResult[], width?: number): string;
+export declare function renderQuotasText(quotas: SyntheticQuotas): string;
+export declare function writeJson(stdout: WritableLike, value: unknown): void;
+export declare function writeJsonError(stderr: WritableLike, message: string): void;

package/dist/lib/output.js

@@ -0,0 +1,53 @@
+import { truncateText } from "./json.js";
+function wrapText(text, width) {
+    const safeWidth = Math.max(width, 20);
+    const words = text.split(/\s+/).filter(Boolean);
+    if (words.length === 0) {
+        return "";
+    }
+    const lines = [];
+    let line = words[0] ?? "";
+    for (let i = 1; i < words.length; i += 1) {
+        const word = words[i];
+        if (`${line} ${word}`.length > safeWidth) {
+            lines.push(line);
+            line = word;
+            continue;
+        }
+        line = `${line} ${word}`;
+    }
+    lines.push(line);
+    return lines.join("\n");
+}
+export function renderSearchResultsText(results, width = 80) {
+    if (results.length === 0) {
+        return "No results found.";
+    }
+    const blocks = results.map((result, index) => {
+        const lines = [`${index + 1}. ${result.title}`, result.url];
+        if (result.published) {
+            lines.push(`Published: ${result.published}`);
+        }
+        const snippet = truncateText(result.text.replace(/\s+/g, " ").trim(), 320);
+        if (snippet) {
+            lines.push(wrapText(snippet, width));
+        }
+        return lines.join("\n");
+    });
+    return blocks.join("\n\n");
+}
+export function renderQuotasText(quotas) {
+    return [
+        `Limit: ${quotas.limit}`,
+        `Requests used: ${quotas.requestsUsed}`,
+        `Remaining: ${quotas.remaining}`,
+        `Renews at: ${quotas.renewsAt ?? "unknown"}`,
+    ].join("\n");
+}
+export function writeJson(stdout, value) {
+    stdout.write(`${JSON.stringify(value, null, 2)}\n`);
+}
+export function writeJsonError(stderr, message) {
+    stderr.write(`${JSON.stringify({ error: message })}\n`);
+}
+//# sourceMappingURL=output.js.map

package/dist/lib/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/lib/output.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAMzC,SAAS,QAAQ,CAAC,IAAY,EAAE,KAAa;IAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEhD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAE1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAW,CAAC;QAEhC,IAAI,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,IAAI,GAAG,IAAI,CAAC;YACZ,SAAS;QACX,CAAC;QAED,IAAI,GAAG,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEjB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAgC,EAAE,KAAK,GAAG,EAAE;IAClF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QAC3C,MAAM,KAAK,GAAa,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;QAEtE,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;QAE3E,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QACvC,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAuB;IACtD,OAAO;QACL,UAAU,MAAM,CAAC,KAAK,EAAE;QACxB,kBAAkB,MAAM,CAAC,YAAY,EAAE;QACvC,cAAc,MAAM,CAAC,SAAS,EAAE;QAChC,cAAc,MAAM,CAAC,QAAQ,IAAI,SAAS,EAAE;KAC7C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,MAAoB,EAAE,KAAc;IAC5D,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAoB,EAAE,OAAe;IAClE,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;AAC1D,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,20 @@
+export type SyntheticSearchResult = {
+    url: string;
+    title: string;
+    text: string;
+    published: string | null;
+};
+export type SyntheticSearchResponse = {
+    results?: unknown;
+};
+export type SyntheticQuotas = {
+    limit: number;
+    requestsUsed: number;
+    remaining: number;
+    renewsAt: string | null;
+};
+export type CredentialSource = "env" | "config" | "none";
+export type ResolvedCredentials = {
+    source: CredentialSource;
+    apiKey: string | null;
+};

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "synthetic-search",
+  "version": "1.0.0",
+  "description": "Command-line client for Synthetic web search and quotas.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "synthetic-search": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "test": "tsx --test test/*.test.ts",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "synthetic",
+    "search",
+    "cli",
+    "web-search",
+    "quotas"
+  ],
+  "dependencies": {
+    "@inquirer/prompts": "^7.8.0",
+    "commander": "^12.1.0",
+    "conf": "^13.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.3.0",
+    "tsx": "^4.20.5",
+    "typescript": "^5.9.2"
+  }
+}