blitzreels 0.1.4 → 0.1.6

package/dist/cli-command-routing.js

@@ -0,0 +1,236 @@
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+import { CliUsageError } from "./cli-errors.js";
+import { commandLabel, commandsEqual, flagsForCommand, GLOBAL_FLAGS, suggestCommandSpecs, suggestValues, } from "./command-metadata.js";
+import { COMMAND_SPECS } from "./command-registry.js";
+export function parseArgs({ argv }) {
+    const command = [];
+    const flags = {};
+    for (let index = 0; index < argv.length; index++) {
+        const value = argv[index];
+        if (value === undefined) {
+            continue;
+        }
+        if (!value.startsWith("--")) {
+            command.push(value);
+            continue;
+        }
+        const [rawKey, inlineValue] = value.slice(2).split("=", 2);
+        const key = rawKey ?? "";
+        if (inlineValue !== undefined) {
+            flags[key] = inlineValue;
+            continue;
+        }
+        const next = argv[index + 1];
+        if (next !== undefined && !next.startsWith("--")) {
+            flags[key] = next;
+            index++;
+            continue;
+        }
+        flags[key] = true;
+    }
+    return { command, flags };
+}
+export function validateParsedArgs({ parsed }) {
+    const spec = findCommandSpec({ command: parsed.command });
+    if (!spec) {
+        throw buildUnknownCommandError({ command: parsed.command });
+    }
+    const allowedFlags = new Set([
+        ...GLOBAL_FLAGS,
+        ...spec.flags.map((flag) => flag.name),
+    ]);
+    for (const flag of Object.keys(parsed.flags)) {
+        if (!allowedFlags.has(flag)) {
+            throw buildUnknownFlagError({ spec, flag });
+        }
+    }
+    if (getBooleanFlag({ flags: parsed.flags, name: "dry-run" })) {
+        if (!spec.dryRunSupported) {
+            throw new CliUsageError({
+                code: "unsupported_dry_run",
+                message: "--dry-run is not supported for this command.",
+                usage: spec.usage,
+            });
+        }
+    }
+}
+export function validateSafeInputs({ parsed }) {
+    for (const [name, value] of Object.entries(parsed.flags)) {
+        if (typeof value !== "string") {
+            continue;
+        }
+        rejectControlChars({ name, value });
+        if (isIdLikeFlag({ name })) {
+            rejectUnsafeId({ name, value });
+        }
+        if (name === "url") {
+            rejectUnsafeUrl({ name, value });
+        }
+        if (name === "output") {
+            rejectUnsafeOutputPath({ value });
+        }
+    }
+}
+export function findCommandSpec({ command, }) {
+    return COMMAND_SPECS.find((spec) => commandsEqual(spec.command, command));
+}
+export function findGroupCommandSpecs({ command, }) {
+    if (command.length === 0) {
+        return [];
+    }
+    return COMMAND_SPECS.filter((spec) => commandsEqual(spec.command.slice(0, command.length), command));
+}
+export function printCommandOrGroupHelpOrThrow({ command, }) {
+    const spec = findCommandSpec({ command });
+    if (spec) {
+        printCommandHelp({ spec });
+        return;
+    }
+    const groupSpecs = findGroupCommandSpecs({ command });
+    if (groupSpecs.length > 0) {
+        printGroupHelp({ command, specs: groupSpecs });
+        return;
+    }
+    throw buildUnknownCommandError({ command });
+}
+export function printHelp() {
+    console.log(`blitzreels
+
+Usage:
+${COMMAND_SPECS.map((spec) => `  ${spec.usage}`).join("\n")}
+
+Global flags:
+  --api-key KEY
+  --base-url URL
+  --json
+`);
+}
+export function buildUnknownCommandError({ command, }) {
+    const suggestions = suggestCommands({ command }).map((spec) => spec.usage);
+    return new CliUsageError({
+        code: "unknown_command",
+        message: `Unknown command: ${commandLabel({ command })}`,
+        suggestions,
+        usage: suggestions[0],
+    });
+}
+export function usageForCurrentCommand() {
+    const parsed = parseArgs({ argv: process.argv.slice(2) });
+    return findCommandSpec({ command: parsed.command })?.usage;
+}
+function printCommandHelp({ spec }) {
+    const flags = flagsForCommand({ spec, includeHidden: false });
+    console.log(`Usage:
+  ${spec.usage}
+
+Description:
+  ${spec.description}
+
+Flags:
+${flags
+        .map((flag) => {
+        const required = flag.required ? " required" : "";
+        const values = flag.enum ? ` (${flag.enum.join("|")})` : "";
+        const defaultValue = flag.default === undefined ? "" : ` default=${String(flag.default)}`;
+        return `  --${flag.name} ${flag.type}${required}${values}${defaultValue}  ${flag.description}`;
+    })
+        .join("\n")}
+
+Examples:
+${spec.examples.map((example) => `  ${example}`).join("\n")}
+`);
+}
+function printGroupHelp({ command, specs, }) {
+    const label = commandLabel({ command });
+    console.log(`blitzreels ${label}
+
+Available commands:
+${specs.map((spec) => `  ${spec.usage}`).join("\n")}
+
+Examples:
+${specs
+        .slice(0, 4)
+        .flatMap((spec) => spec.examples.slice(0, 1))
+        .map((example) => `  ${example}`)
+        .join("\n")}
+`);
+}
+function buildUnknownFlagError({ spec, flag, }) {
+    const flags = [
+        ...new Set([
+            ...spec.flags.map((candidate) => candidate.name),
+            ...GLOBAL_FLAGS,
+        ]),
+    ];
+    const suggestions = suggestValues({ value: flag, candidates: flags }).map((candidate) => `--${candidate}`);
+    return new CliUsageError({
+        code: "unknown_flag",
+        message: `Unknown flag --${flag} for \`${commandLabel({ command: spec.command })}\`.`,
+        suggestions,
+        usage: spec.usage,
+    });
+}
+function suggestCommands({ command }) {
+    return suggestCommandSpecs({ command, specs: COMMAND_SPECS });
+}
+function getBooleanFlag({ flags, name, }) {
+    return flags[name] === true || flags[name] === "true";
+}
+function rejectControlChars({ name, value, }) {
+    if (Array.from(value).some((character) => {
+        const code = character.charCodeAt(0);
+        return code < 32 || code === 127;
+    })) {
+        throw new CliUsageError({
+            code: "unsafe_input",
+            message: `--${name} contains control characters.`,
+        });
+    }
+}
+function isIdLikeFlag({ name }) {
+    return name === "id" || name.endsWith("-id") || name.endsWith("-ids");
+}
+function rejectUnsafeId({ name, value, }) {
+    if (/[?#%]/.test(value)) {
+        throw new CliUsageError({
+            code: "unsafe_input",
+            message: `--${name} must be an ID, not a URL or encoded path.`,
+        });
+    }
+}
+function rejectUnsafeUrl({ name, value, }) {
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        throw new CliUsageError({
+            code: "unsafe_input",
+            message: `--${name} must be a valid URL.`,
+        });
+    }
+    if (url.protocol !== "http:" && url.protocol !== "https:") {
+        throw new CliUsageError({
+            code: "unsafe_input",
+            message: `--${name} must use http or https.`,
+        });
+    }
+    if (url.username || url.password) {
+        throw new CliUsageError({
+            code: "unsafe_input",
+            message: `--${name} must not include embedded credentials.`,
+        });
+    }
+}
+function rejectUnsafeOutputPath({ value }) {
+    const outputPath = resolve(value);
+    const sensitiveDirs = [join(homedir(), ".ssh"), join(homedir(), ".gnupg")];
+    if (sensitiveDirs.some((dir) => outputPath.startsWith(`${dir}/`) || outputPath === dir)) {
+        throw new CliUsageError({
+            code: "unsafe_input",
+            message: "--output cannot write into sensitive home directories.",
+        });
+    }
+}
+//# sourceMappingURL=cli-command-routing.js.map

package/dist/cli-command-routing.js.map

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

package/dist/cli-errors.d.ts

@@ -0,0 +1,31 @@
+export type CliExitCode = 1 | 2 | 3 | 4 | 5 | 6 | 7;
+export type CliErrorContract = {
+    code: string;
+    exitCode: CliExitCode;
+    retryable: boolean;
+};
+export declare class CliUsageError extends Error {
+    code: string;
+    suggestions: string[];
+    usage: string | undefined;
+    constructor({ code, message, suggestions, usage, }: {
+        code: string;
+        message: string;
+        suggestions?: string[];
+        usage?: string;
+    });
+}
+export declare class CliOperationError extends Error {
+    code: string;
+    exitCode: CliExitCode;
+    retryable: boolean;
+    suggestions: string[];
+    constructor({ code, exitCode, message, retryable, suggestions, }: {
+        code: string;
+        exitCode: CliExitCode;
+        message: string;
+        retryable: boolean;
+        suggestions?: string[];
+    });
+}
+//# sourceMappingURL=cli-errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-errors.d.ts","sourceRoot":"","sources":["../src/cli-errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEpD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,WAAW,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,qBAAa,aAAc,SAAQ,KAAK;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEd,EACV,IAAI,EACJ,OAAO,EACP,WAAgB,EAChB,KAAK,GACN,EAAE;QACD,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB;CAOF;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,WAAW,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;gBAEV,EACV,IAAI,EACJ,QAAQ,EACR,OAAO,EACP,SAAS,EACT,WAAgB,GACjB,EAAE;QACD,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,WAAW,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,OAAO,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;KACxB;CAQF"}

package/dist/cli-errors.js

@@ -0,0 +1,27 @@
+export class CliUsageError extends Error {
+    code;
+    suggestions;
+    usage;
+    constructor({ code, message, suggestions = [], usage, }) {
+        super(message);
+        this.name = "CliUsageError";
+        this.code = code;
+        this.suggestions = suggestions;
+        this.usage = usage;
+    }
+}
+export class CliOperationError extends Error {
+    code;
+    exitCode;
+    retryable;
+    suggestions;
+    constructor({ code, exitCode, message, retryable, suggestions = [], }) {
+        super(message);
+        this.name = "CliOperationError";
+        this.code = code;
+        this.exitCode = exitCode;
+        this.retryable = retryable;
+        this.suggestions = suggestions;
+    }
+}
+//# sourceMappingURL=cli-errors.js.map

package/dist/cli-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-errors.js","sourceRoot":"","sources":["../src/cli-errors.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,IAAI,CAAS;IACb,WAAW,CAAW;IACtB,KAAK,CAAqB;IAE1B,YAAY,EACV,IAAI,EACJ,OAAO,EACP,WAAW,GAAG,EAAE,EAChB,KAAK,GAMN;QACC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,IAAI,CAAS;IACb,QAAQ,CAAc;IACtB,SAAS,CAAU;IACnB,WAAW,CAAW;IAEtB,YAAY,EACV,IAAI,EACJ,QAAQ,EACR,OAAO,EACP,SAAS,EACT,WAAW,GAAG,EAAE,GAOjB;QACC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;CACF"}

package/dist/cli-flag-reader.d.ts

@@ -0,0 +1,61 @@
+import type { CliFlagReader, Flags } from "./cli-types.js";
+export declare function createFlagReader({ flags }: {
+    flags: Flags;
+}): CliFlagReader;
+export declare function getStringFlag({ flags, name, }: {
+    flags: Flags;
+    name: string;
+}): string | undefined;
+export declare function requireStringFlag({ flags, name, }: {
+    flags: Flags;
+    name: string;
+}): string;
+export declare function getBooleanFlag({ flags, name, }: {
+    flags: Flags;
+    name: string;
+}): boolean;
+export declare function getOptionalBooleanFlag({ flags, name, }: {
+    flags: Flags;
+    name: string;
+}): boolean | undefined;
+export declare function getNumberFlag({ flags, name, }: {
+    flags: Flags;
+    name: string;
+}): number | undefined;
+export declare function parseNullableNumberFlag({ flags, name, }: {
+    flags: Flags;
+    name: string;
+}): number | null | undefined;
+export declare function parseJsonObjectFlag({ flags, name, }: {
+    flags: Flags;
+    name: string;
+}): Record<string, unknown> | undefined;
+export declare function parseJsonArrayFlag({ flags, name, fileName, }: {
+    flags: Flags;
+    name: string;
+    fileName: string | undefined;
+}): unknown[] | undefined;
+export declare function parseNullableJsonObjectFlag({ flags, name, }: {
+    flags: Flags;
+    name: string;
+}): Record<string, unknown> | null | undefined;
+export declare function jsonFileFlagName({ name, }: {
+    name: string;
+}): string | undefined;
+export declare function parseCsvFlag({ flags, name, }: {
+    flags: Flags;
+    name: string;
+}): string[] | undefined;
+export declare function parseCsvRequiredFlag({ flags, name, }: {
+    flags: Flags;
+    name: string;
+}): string[];
+export declare function parseNullableStringFlag({ flags, name, }: {
+    flags: Flags;
+    name: string;
+}): string | null | undefined;
+export declare function parseStringRecordFlag({ flags, name, }: {
+    flags: Flags;
+    name: string;
+}): Record<string, string> | undefined;
+//# sourceMappingURL=cli-flag-reader.d.ts.map

package/dist/cli-flag-reader.d.ts.map

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

package/dist/cli-flag-reader.js

@@ -0,0 +1,207 @@
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { usageForCurrentCommand } from "./cli-command-routing.js";
+import { CliUsageError } from "./cli-errors.js";
+export function createFlagReader({ flags }) {
+    return {
+        raw: flags,
+        string: ({ name }) => getStringFlag({ flags, name }),
+        requiredString: ({ name }) => requireStringFlag({ flags, name }),
+        boolean: ({ name }) => getBooleanFlag({ flags, name }),
+        optionalBoolean: ({ name }) => getOptionalBooleanFlag({ flags, name }),
+        number: ({ name }) => getNumberFlag({ flags, name }),
+        nullableNumber: ({ name }) => parseNullableNumberFlag({ flags, name }),
+        jsonObject: ({ name }) => parseJsonObjectFlag({ flags, name }),
+        jsonArray: ({ name, fileName }) => parseJsonArrayFlag({ flags, name, fileName }),
+        nullableJsonObject: ({ name }) => parseNullableJsonObjectFlag({ flags, name }),
+        csv: ({ name }) => parseCsvFlag({ flags, name }),
+        requiredCsv: ({ name }) => parseCsvRequiredFlag({ flags, name }),
+        nullableString: ({ name }) => parseNullableStringFlag({ flags, name }),
+        stringRecord: ({ name }) => parseStringRecordFlag({ flags, name }),
+    };
+}
+export function getStringFlag({ flags, name, }) {
+    const value = flags[name];
+    return typeof value === "string" ? value : undefined;
+}
+export function requireStringFlag({ flags, name, }) {
+    const value = getStringFlag({ flags, name });
+    if (!value) {
+        throw new CliUsageError({
+            code: "missing_required_flag",
+            message: `Missing required --${name}.`,
+            usage: usageForCurrentCommand(),
+        });
+    }
+    return value;
+}
+export function getBooleanFlag({ flags, name, }) {
+    return flags[name] === true || flags[name] === "true";
+}
+export function getOptionalBooleanFlag({ flags, name, }) {
+    if (!(name in flags)) {
+        return undefined;
+    }
+    return getBooleanFlag({ flags, name });
+}
+export function getNumberFlag({ flags, name, }) {
+    const value = getStringFlag({ flags, name });
+    if (value === undefined) {
+        return undefined;
+    }
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed)) {
+        throw new CliUsageError({
+            code: "invalid_flag_value",
+            message: `--${name} must be a number.`,
+            usage: usageForCurrentCommand(),
+        });
+    }
+    return parsed;
+}
+export function parseNullableNumberFlag({ flags, name, }) {
+    const value = getStringFlag({ flags, name });
+    if (value === undefined) {
+        return undefined;
+    }
+    if (value === "null") {
+        return null;
+    }
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed)) {
+        throw new Error(`--${name} must be a number or null.`);
+    }
+    return parsed;
+}
+export function parseJsonObjectFlag({ flags, name, }) {
+    const value = readJsonFlagValue({
+        flags,
+        name,
+        fileName: jsonFileFlagName({ name }),
+    });
+    if (value === undefined) {
+        return undefined;
+    }
+    const parsed = parseJsonFlagValue({
+        value: value.raw,
+        sourceName: value.sourceName,
+    });
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error(`${value.sourceName} must be a JSON object.`);
+    }
+    return parsed;
+}
+export function parseJsonArrayFlag({ flags, name, fileName, }) {
+    const value = readJsonFlagValue({ flags, name, fileName });
+    if (value === undefined) {
+        return undefined;
+    }
+    const parsed = parseJsonFlagValue({
+        value: value.raw,
+        sourceName: value.sourceName,
+    });
+    if (!Array.isArray(parsed)) {
+        throw new Error(`${value.sourceName} must be a JSON array.`);
+    }
+    return parsed;
+}
+export function parseNullableJsonObjectFlag({ flags, name, }) {
+    const value = readJsonFlagValue({
+        flags,
+        name,
+        fileName: jsonFileFlagName({ name }),
+    });
+    if (value === undefined) {
+        return undefined;
+    }
+    if (value.raw.trim() === "null") {
+        return null;
+    }
+    const parsed = parseJsonFlagValue({
+        value: value.raw,
+        sourceName: value.sourceName,
+    });
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error(`${value.sourceName} must be a JSON object or null.`);
+    }
+    return parsed;
+}
+export function jsonFileFlagName({ name, }) {
+    return name.endsWith("-json")
+        ? `${name.slice(0, -"json".length)}file`
+        : undefined;
+}
+export function parseCsvFlag({ flags, name, }) {
+    const value = getStringFlag({ flags, name });
+    if (value === undefined) {
+        return undefined;
+    }
+    return value
+        .split(",")
+        .map((item) => item.trim())
+        .filter((item) => item.length > 0);
+}
+export function parseCsvRequiredFlag({ flags, name, }) {
+    const parsed = parseCsvFlag({ flags, name });
+    if (parsed === undefined || parsed.length === 0) {
+        throw new Error(`Missing required --${name}.`);
+    }
+    return parsed;
+}
+export function parseNullableStringFlag({ flags, name, }) {
+    const value = getStringFlag({ flags, name });
+    if (value === undefined) {
+        return undefined;
+    }
+    if (value === "null") {
+        return null;
+    }
+    return value;
+}
+export function parseStringRecordFlag({ flags, name, }) {
+    const value = parseJsonObjectFlag({ flags, name });
+    if (value === undefined) {
+        return undefined;
+    }
+    for (const [key, item] of Object.entries(value)) {
+        if (typeof item !== "string") {
+            throw new Error(`--${name}.${key} must be a string.`);
+        }
+    }
+    return value;
+}
+function readJsonFlagValue({ flags, name, fileName, }) {
+    const inlineValue = getStringFlag({ flags, name });
+    const filePath = fileName === undefined
+        ? undefined
+        : getStringFlag({ flags, name: fileName });
+    if (inlineValue !== undefined && filePath !== undefined) {
+        throw new Error(`Use either --${name} or --${fileName}, not both.`);
+    }
+    if (inlineValue !== undefined) {
+        return { raw: inlineValue, sourceName: `--${name}` };
+    }
+    if (filePath === undefined) {
+        return undefined;
+    }
+    try {
+        return {
+            raw: readFileSync(resolve(filePath), "utf8"),
+            sourceName: `--${fileName}`,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Could not read --${fileName} file "${filePath}": ${message}`);
+    }
+}
+function parseJsonFlagValue({ value, sourceName, }) {
+    try {
+        return JSON.parse(value);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`${sourceName} contains invalid JSON: ${message}`);
+    }
+}
+//# sourceMappingURL=cli-flag-reader.js.map

package/dist/cli-flag-reader.js.map

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

package/dist/cli-http.d.ts

@@ -0,0 +1,6 @@
+export declare function readJsonResponse({ response, url, action, }: {
+    response: Response;
+    url: string;
+    action: string;
+}): Promise<unknown>;
+//# sourceMappingURL=cli-http.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-http.d.ts","sourceRoot":"","sources":["../src/cli-http.ts"],"names":[],"mappings":"AAAA,wBAAsB,gBAAgB,CAAC,EACrC,QAAQ,EACR,GAAG,EACH,MAAM,GACP,EAAE;IACD,QAAQ,EAAE,QAAQ,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,OAAO,CAAC,CAoBnB"}

package/dist/cli-http.js

@@ -0,0 +1,42 @@
+export async function readJsonResponse({ response, url, action, }) {
+    const contentType = response.headers.get("content-type") ?? "";
+    const text = await response.text();
+    const parsed = tryParseJson({ text });
+    if (parsed !== undefined) {
+        if (!response.ok) {
+            throw new Error(`${action} failed with ${response.status}: ${extractJsonErrorMessage({ value: parsed })}`);
+        }
+        return parsed;
+    }
+    const hint = contentType.includes("text/html")
+        ? "The server returned HTML instead of JSON. For production, deploy the BlitzReels web app with the CLI auth routes first. For local testing, pass --base-url http://localhost:3000/api/v1."
+        : "The server returned a non-JSON response.";
+    throw new Error(`${action} failed: ${url} returned ${response.status} ${contentType || "unknown content type"}. ${hint}`);
+}
+function tryParseJson({ text }) {
+    if (text.trim().length === 0) {
+        return null;
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+}
+function extractJsonErrorMessage({ value }) {
+    if (value && typeof value === "object") {
+        const record = value;
+        if (typeof record.error_description === "string") {
+            return record.error_description;
+        }
+        if (typeof record.error === "string") {
+            return record.error;
+        }
+        if (typeof record.message === "string") {
+            return record.message;
+        }
+    }
+    return JSON.stringify(value);
+}
+//# sourceMappingURL=cli-http.js.map

package/dist/cli-http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-http.js","sourceRoot":"","sources":["../src/cli-http.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,EACrC,QAAQ,EACR,GAAG,EACH,MAAM,GAKP;IACC,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;IAC/D,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,GAAG,MAAM,gBAAgB,QAAQ,CAAC,MAAM,KAAK,uBAAuB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,CAC1F,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,IAAI,GAAG,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC;QAC5C,CAAC,CAAC,0LAA0L;QAC5L,CAAC,CAAC,0CAA0C,CAAC;IAC/C,MAAM,IAAI,KAAK,CACb,GAAG,MAAM,YAAY,GAAG,aAAa,QAAQ,CAAC,MAAM,IAAI,WAAW,IAAI,sBAAsB,KAAK,IAAI,EAAE,CACzG,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,EAAE,IAAI,EAAoB;IAC9C,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,uBAAuB,CAAC,EAAE,KAAK,EAAsB;IAC5D,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,KAAgC,CAAC;QAChD,IAAI,OAAO,MAAM,CAAC,iBAAiB,KAAK,QAAQ,EAAE,CAAC;YACjD,OAAO,MAAM,CAAC,iBAAiB,CAAC;QAClC,CAAC;QACD,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACrC,OAAO,MAAM,CAAC,KAAK,CAAC;QACtB,CAAC;QACD,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACvC,OAAO,MAAM,CAAC,OAAO,CAAC;QACxB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC"}