@paradigma-inc/flywheel 0.1.35 → 0.1.52

package/src/runtime/vendor/flywheel-cli-dist/grammar/globals.js

@@ -0,0 +1,117 @@
+import { CliUsageError } from '../errors.js';
+export const GLOBAL_FLAG_NAMES = new Set([
+    'env',
+    'format',
+    'debug',
+    'verbose',
+    'help',
+    'schema',
+    'out',
+    'open',
+    'no-retry',
+    'retry-max',
+    'wait',
+    'wait-timeout',
+    'allow-self',
+    'idempotency-key',
+    'timeout',
+    'force',
+    'yes',
+]);
+function asString(key, value) {
+    if (typeof value !== 'string') {
+        throw new CliUsageError(`invalid --${key}: expected a value`);
+    }
+    return value;
+}
+function asBoolean(key, value) {
+    // Bare flag (e.g. `--force`) arrives as boolean `true` from the grammar
+    // parser. Explicit string values must be exactly `true` or `false` —
+    // accepting other strings like `no`, `yes`, `0`, `1` silently enabled
+    // safety-gated flows when callers typo'd or templated the wrong literal.
+    if (typeof value === 'boolean') {
+        return value;
+    }
+    if (value === 'true')
+        return true;
+    if (value === 'false')
+        return false;
+    throw new CliUsageError(`invalid --${key}=${value}: boolean globals accept only bare flag, true, or false`);
+}
+function asInt(key, value, bounds) {
+    if (typeof value !== 'string') {
+        throw new CliUsageError(`invalid --${key}: expected an integer`);
+    }
+    const parsed = Number.parseInt(value, 10);
+    if (Number.isNaN(parsed) || String(parsed) !== value) {
+        throw new CliUsageError(`invalid --${key}: expected an integer`);
+    }
+    if (bounds?.min !== undefined && parsed < bounds.min) {
+        throw new CliUsageError(`invalid --${key}: minimum is ${bounds.min}`);
+    }
+    if (bounds?.max !== undefined && parsed > bounds.max) {
+        throw new CliUsageError(`invalid --${key}: maximum is ${bounds.max}`);
+    }
+    return parsed;
+}
+export function extractGlobals(params) {
+    const globals = {};
+    const handlerParams = {};
+    const flagNames = [];
+    for (const [key, value] of Object.entries(params)) {
+        if (!GLOBAL_FLAG_NAMES.has(key)) {
+            handlerParams[key] = value;
+            flagNames.push(key);
+            continue;
+        }
+        switch (key) {
+            case 'env':
+                globals.env = asString(key, value);
+                break;
+            case 'debug':
+                globals.debug = asBoolean(key, value);
+                break;
+            case 'verbose':
+                globals.verbose = asBoolean(key, value);
+                break;
+            case 'out':
+                globals.outPath = asString(key, value);
+                break;
+            case 'open':
+                globals.open = asBoolean(key, value);
+                break;
+            case 'no-retry':
+                globals.retryEnabled = !asBoolean(key, value);
+                break;
+            case 'retry-max':
+                globals.retryMax = asInt(key, value, { min: 1, max: 5 });
+                break;
+            case 'wait':
+                globals.wait = asBoolean(key, value);
+                break;
+            case 'wait-timeout':
+                globals.waitTimeoutS = asInt(key, value, { min: 10, max: 3600 });
+                break;
+            case 'allow-self':
+                globals.allowSelf = asBoolean(key, value);
+                break;
+            case 'idempotency-key':
+                globals.idempotencyKey = asString(key, value);
+                break;
+            case 'timeout':
+                globals.timeoutS = asInt(key, value, { min: 1, max: 86_400 });
+                break;
+            case 'force':
+                globals.force = asBoolean(key, value);
+                break;
+            case 'yes':
+                globals.yes = asBoolean(key, value);
+                break;
+            default:
+                // known global but no specific parse; skip
+                break;
+        }
+    }
+    return { globals, handlerParams, flagNames };
+}
+//# sourceMappingURL=globals.js.map

package/src/runtime/vendor/flywheel-cli-dist/grammar/globals.js.map

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

package/src/runtime/vendor/flywheel-cli-dist/grammar/parse.d.ts

@@ -0,0 +1,17 @@
+export type OutputFormat = 'json' | 'tsv' | 'csv' | 'table';
+export interface ParsedCliArgs {
+    command: string;
+    format: OutputFormat;
+    formatExplicit: boolean;
+    params: Record<string, string | boolean>;
+}
+export interface UsageError {
+    ok: false;
+    exitCode: 1;
+    message: string;
+}
+export interface ParsedSuccess extends ParsedCliArgs {
+    ok: true;
+}
+export type ParseResult = ParsedSuccess | UsageError;
+export declare function parseCliArgs(argv: string[]): ParseResult;

package/src/runtime/vendor/flywheel-cli-dist/grammar/parse.js

@@ -0,0 +1,102 @@
+const COMMAND_TOKEN_PATTERN = /^[a-z][a-z-]*(?::[a-z][a-z-]*)*$/;
+const FLAG_NAME_PATTERN = /^[a-z][a-z0-9_-]*$/i;
+const FORMAT_VALUES = new Set(['json', 'tsv', 'csv', 'table']);
+const LEGACY_MIGRATION_MESSAGE = "legacy argument syntax 'key=value' is no longer supported; use --key=value";
+function invalidArgument(token) {
+    return {
+        ok: false,
+        exitCode: 1,
+        message: `invalid argument: ${token}`,
+    };
+}
+function legacyGrammarError() {
+    return {
+        ok: false,
+        exitCode: 1,
+        message: LEGACY_MIGRATION_MESSAGE,
+    };
+}
+export function parseCliArgs(argv) {
+    if (argv.length === 0) {
+        return {
+            ok: false,
+            exitCode: 1,
+            message: 'usage: flywheel <command> [options]',
+        };
+    }
+    const [command, ...tokens] = argv;
+    if (!COMMAND_TOKEN_PATTERN.test(command)) {
+        return {
+            ok: false,
+            exitCode: 1,
+            message: `unknown command: ${command}`,
+        };
+    }
+    let format = 'json';
+    let formatExplicit = false;
+    const params = {};
+    for (let index = 0; index < tokens.length; index += 1) {
+        const token = tokens[index];
+        // `-h` is the sole short-flag shorthand: binds identically to `--help`.
+        // Accepted only when it appears as a standalone top-level flag; when a
+        // preceding `--flag` is waiting for a value the space-separated bind
+        // below consumes `-h` as that value instead (because `-h` does not
+        // start with `--` — the flag-boundary marker).
+        if (token === '-h') {
+            params.help = true;
+            continue;
+        }
+        if (token === '--format') {
+            const next = tokens[index + 1];
+            if (!next || !FORMAT_VALUES.has(next)) {
+                return invalidArgument('--format');
+            }
+            format = next;
+            formatExplicit = true;
+            index += 1;
+            continue;
+        }
+        if (token.startsWith('--format=')) {
+            const value = token.slice('--format='.length);
+            if (!FORMAT_VALUES.has(value)) {
+                return invalidArgument(token);
+            }
+            format = value;
+            formatExplicit = true;
+            continue;
+        }
+        if (token.startsWith('--')) {
+            const rest = token.slice(2);
+            if (rest.includes('=')) {
+                const separatorIndex = rest.indexOf('=');
+                const key = rest.slice(0, separatorIndex);
+                const value = rest.slice(separatorIndex + 1);
+                if (!key || !FLAG_NAME_PATTERN.test(key) || !value) {
+                    return invalidArgument(token);
+                }
+                params[key] = value;
+                continue;
+            }
+            if (!rest || !FLAG_NAME_PATTERN.test(rest)) {
+                return invalidArgument(token);
+            }
+            const next = tokens[index + 1];
+            if (next === undefined || next.startsWith('--')) {
+                params[rest] = true;
+                continue;
+            }
+            params[rest] = next;
+            index += 1;
+            continue;
+        }
+        return legacyGrammarError();
+    }
+    return {
+        ok: true,
+        command,
+        format,
+        formatExplicit,
+        params,
+    };
+}
+//# sourceMappingURL=parse.js.map

package/src/runtime/vendor/flywheel-cli-dist/grammar/parse.js.map

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

package/src/runtime/vendor/flywheel-cli-dist/http/client.d.ts

@@ -0,0 +1,75 @@
+import { type ExitCode } from '../exit-codes.js';
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+export interface CliHttpErrorRequest {
+    method: string;
+    path: string;
+    requestId?: string;
+}
+export declare class CliHttpError extends Error {
+    readonly exitCode: ExitCode;
+    readonly status?: number;
+    readonly body?: unknown;
+    readonly request?: CliHttpErrorRequest;
+    constructor(message: string, exitCode: ExitCode, status?: number, body?: unknown, request?: CliHttpErrorRequest);
+}
+type Transport = (input: URL | RequestInfo, init?: RequestInit) => Promise<Response>;
+interface HttpClientOptions {
+    baseUrl: string;
+    apiKey?: string;
+    transport?: Transport;
+    cliVersion?: string;
+    commandName?: string;
+    flagNames?: string[];
+    invocationId?: string;
+    wrapperStep?: string;
+    exitIntent?: number;
+    retryMax?: number;
+    retryEnabled?: boolean;
+    retrySleep?: (ms: number) => Promise<void>;
+    debug?: boolean;
+    debugLog?: (line: string) => void;
+    timeoutMs?: number;
+    /**
+     * Caller-supplied Idempotency-Key. When set, every non-GET request that
+     * does not pass `skipIdempotency` uses this value verbatim instead of a
+     * freshly-generated UUID. Wired from the top-level `--idempotency-key`
+     * global so retries across process invocations land on the same server
+     * idempotency slot.
+     */
+    idempotencyKey?: string;
+}
+export interface RequestOptions {
+    body?: unknown;
+    query?: Record<string, string | number | boolean>;
+    /** Override wrapper step for this single request (for multi-step wrappers). */
+    wrapperStep?: string;
+    /** Override exit intent for this single request. */
+    exitIntent?: number;
+    /** Skip automatic Idempotency-Key. Used for PUT to pre-signed URLs. */
+    skipIdempotency?: boolean;
+    /** Extra headers (e.g., Content-Type overrides). */
+    extraHeaders?: Record<string, string>;
+    /** Raw body bypass (e.g., Buffer for signed URL PUT). If set, body is ignored. */
+    rawBody?: BodyInit;
+    /** Skip auth header (e.g., when PUTting to signed URLs). */
+    skipAuth?: boolean;
+    /** Do not parse JSON response; return the Response object. */
+    rawResponse?: boolean;
+}
+export interface RawExternalOptions {
+    rawBody?: BodyInit;
+    extraHeaders?: Record<string, string>;
+}
+export interface HttpClient {
+    requestJson<T>(method: HttpMethod, path: string, options?: RequestOptions): Promise<T>;
+    /** Raw response for binary downloads (streams, PDF). */
+    requestRaw(method: HttpMethod, path: string, options?: RequestOptions): Promise<Response>;
+    /**
+     * Send a request to an absolute external URL (e.g. a signed storage URL).
+     * Bypasses baseUrl concatenation, Authorization, Idempotency-Key, and every
+     * X-Flywheel-Cli-* header. Single attempt, no retry.
+     */
+    requestRawExternal(method: HttpMethod, absoluteUrl: string, options?: RawExternalOptions): Promise<Response>;
+}
+export declare function createHttpClient(options: HttpClientOptions): HttpClient;
+export {};