@go-labs-sg/bb 2.20.0 → 2.24.1

package/dist/runtime/confirmation.js

@@ -1,76 +0,0 @@
-import { CliRuntimeError } from "./error.js";
-const effectLabels = {
-    "state-change": "changes Budget Builder state",
-    email: "sends email",
-    "external-write": "writes to an external system",
-    delete: "deletes data",
-    "financial-write": "creates or changes financial records",
-};
-const isEffectAllowed = (effect, permissions) => {
-    switch (effect) {
-        case "state-change":
-            return permissions.allowStateChange === true;
-        case "email":
-            return permissions.allowEmail === true;
-        case "external-write":
-            return permissions.allowExternalWrite === true;
-        case "delete":
-            return permissions.allowDelete === true;
-        case "financial-write":
-            return permissions.allowFinancialWrite === true;
-    }
-};
-const uniqueEffects = (effects) => [...new Set(effects)];
-export const getRequiredEffectPermissions = (effects, permissions) => uniqueEffects(effects).filter((effect) => !isEffectAllowed(effect, permissions));
-export const formatConfirmationPreview = (request) => [
-    "Budget Builder workflow preview",
-    `Action: ${request.action}`,
-    `Target: ${request.target?.trim() || "not specified"}`,
-    `Effects: ${uniqueEffects(request.effects)
-        .map((effect) => effectLabels[effect])
-        .join("; ") || "none"}`,
-    ...(request.details === undefined ? [] : [`Details: ${request.details}`]),
-].join("\n");
-export const confirmSensitiveCommand = async (runtime, request) => {
-    const requiredPermissions = getRequiredEffectPermissions(request.effects, request.permissions);
-    if (request.effects.length === 0) {
-        return { confirmed: true, requiredPermissions };
-    }
-    const target = request.target?.trim();
-    if (!runtime.isTTY) {
-        if (target === undefined) {
-            throw new CliRuntimeError("CONFIRMATION_REQUIRED", "Non-interactive sensitive commands require an explicit target.", {
-                details: {
-                    action: request.action,
-                    effects: requiredPermissions,
-                    missingFlags: requiredPermissions.map((effect) => `--allow-${effect}`),
-                    target: "required",
-                },
-            });
-        }
-        if (requiredPermissions.length === 0) {
-            return { confirmed: true, requiredPermissions };
-        }
-        const missing = requiredPermissions.map((effect) => `--allow-${effect}`);
-        throw new CliRuntimeError("CONFIRMATION_REQUIRED", "Non-interactive sensitive commands require an explicit target and all applicable allow flags.", {
-            details: {
-                action: request.action,
-                effects: requiredPermissions,
-                missingFlags: missing,
-            },
-        });
-    }
-    if (requiredPermissions.length === 0) {
-        return { confirmed: true, requiredPermissions };
-    }
-    const preview = formatConfirmationPreview(request);
-    runtime.stderr.write(`${preview}\n`);
-    if (runtime.prompt === undefined) {
-        throw new CliRuntimeError("CONFIRMATION_REQUIRED", "This command needs an interactive confirmation prompt.");
-    }
-    const answer = await runtime.prompt("Type CONFIRM to continue: ");
-    if (answer !== "CONFIRM") {
-        throw new CliRuntimeError("ABORTED", "Command aborted by user.");
-    }
-    return { confirmed: true, preview, requiredPermissions };
-};

package/dist/runtime/error.js

@@ -1,143 +0,0 @@
-const invocationErrorCodes = new Set([
-    "USAGE",
-    "VALIDATION",
-    "CONFIRMATION_REQUIRED",
-]);
-const trpcCodeMap = {
-    BAD_REQUEST: "VALIDATION",
-    CONFLICT: "CONFLICT",
-    FORBIDDEN: "AUTHORIZATION",
-    INTERNAL_SERVER_ERROR: "API",
-    METHOD_NOT_SUPPORTED: "API",
-    NOT_FOUND: "NOT_FOUND",
-    PARSE_ERROR: "VALIDATION",
-    PAYLOAD_TOO_LARGE: "VALIDATION",
-    PRECONDITION_FAILED: "CONFLICT",
-    TIMEOUT: "NETWORK",
-    TOO_MANY_REQUESTS: "API",
-    UNAUTHORIZED: "AUTHENTICATION",
-    UNPROCESSABLE_CONTENT: "VALIDATION",
-};
-const cliErrorCodes = new Set([
-    "USAGE",
-    "VALIDATION",
-    "CONFIRMATION_REQUIRED",
-    "AUTHENTICATION",
-    "AUTHORIZATION",
-    "NOT_FOUND",
-    "CONFLICT",
-    "API",
-    "NETWORK",
-    "ABORTED",
-    "INTERRUPTED",
-    "INTERNAL",
-]);
-export class CliRuntimeError extends Error {
-    code;
-    details;
-    requestId;
-    constructor(code, message, options = {}) {
-        super(message);
-        this.name = "CliRuntimeError";
-        this.code = code;
-        this.details = options.details;
-        this.requestId = options.requestId;
-    }
-}
-const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-const asNonEmptyString = (value) => typeof value === "string" && value.trim() !== "" ? value : undefined;
-const asDetails = (value) => {
-    if (!isRecord(value))
-        return undefined;
-    const details = {};
-    for (const [key, nestedValue] of Object.entries(value)) {
-        if (isJsonValue(nestedValue))
-            details[key] = nestedValue;
-    }
-    return Object.keys(details).length > 0 ? details : undefined;
-};
-const isJsonValue = (value) => {
-    if (value === null ||
-        typeof value === "string" ||
-        typeof value === "boolean" ||
-        typeof value === "number") {
-        return true;
-    }
-    if (Array.isArray(value))
-        return value.every(isJsonValue);
-    return isRecord(value) && Object.values(value).every(isJsonValue);
-};
-const mapErrorCode = (value) => {
-    if (typeof value !== "string")
-        return undefined;
-    if (cliErrorCodes.has(value))
-        return value;
-    if (value in trpcCodeMap)
-        return trpcCodeMap[value];
-    return undefined;
-};
-const networkMessagePattern = /\b(fetch failed|network error|unable to connect|econnrefused|econnreset|enotfound|etimedout|socket hang up)\b/i;
-const isNetworkError = (error, depth = 0) => {
-    if (depth > 3 || !isRecord(error))
-        return false;
-    const message = asNonEmptyString(error.message);
-    if (message !== undefined && networkMessagePattern.test(message))
-        return true;
-    const code = asNonEmptyString(error.code);
-    if (code !== undefined && networkMessagePattern.test(code))
-        return true;
-    return isNetworkError(error.cause, depth + 1);
-};
-/**
- * Maps local errors and the common tRPC client error shape into the stable
- * CLI contract without importing a transport-specific error class.
- */
-export const normalizeCliError = (error) => {
-    if (error instanceof CliRuntimeError) {
-        return {
-            code: error.code,
-            message: error.message,
-            ...(error.details === undefined ? {} : { details: error.details }),
-            ...(error.requestId === undefined ? {} : { requestId: error.requestId }),
-        };
-    }
-    if (isNetworkError(error)) {
-        return {
-            code: "NETWORK",
-            message: error instanceof Error
-                ? error.message
-                : "The Budget Builder API could not be reached.",
-        };
-    }
-    if (isRecord(error)) {
-        const data = isRecord(error.data) ? error.data : undefined;
-        const transportCode = mapErrorCode(data?.code ?? error.code);
-        if (error instanceof Error &&
-            data === undefined &&
-            transportCode === undefined) {
-            return { code: "INTERNAL", message: error.message };
-        }
-        const code = transportCode ?? "API";
-        const message = asNonEmptyString(error.message) ??
-            "The Budget Builder API request failed.";
-        const requestId = asNonEmptyString(data?.requestId) ??
-            asNonEmptyString(data?.requestID) ??
-            asNonEmptyString(error.requestId);
-        const details = asDetails(data?.details ?? error.details);
-        return {
-            code,
-            message,
-            ...(details === undefined ? {} : { details }),
-            ...(requestId === undefined ? {} : { requestId }),
-        };
-    }
-    if (error instanceof Error) {
-        return { code: "INTERNAL", message: error.message };
-    }
-    return { code: "INTERNAL", message: "An unexpected CLI error occurred." };
-};
-export const exitCodeForCliError = (error) => {
-    if (error.code === "INTERRUPTED")
-        return 130;
-    return invocationErrorCodes.has(error.code) ? 2 : 1;
-};

package/dist/runtime/index.js

@@ -1,6 +0,0 @@
-export { confirmSensitiveCommand, formatConfirmationPreview, getRequiredEffectPermissions, } from "./confirmation.js";
-export { CliRuntimeError, exitCodeForCliError, normalizeCliError, } from "./error.js";
-export { createSuccessEnvelope, emitCliDiagnostic, emitCliError, emitCliSuccess, } from "./output.js";
-export { createProcessRuntime } from "./process-runtime.js";
-export { sanitizeCliDiagnostic, sanitizeCliValue } from "./sanitize.js";
-export { clearActiveCliSession, confirmCurrentCommand, emitCommandError, emitCommandResult, getActiveCliSession, setActiveCliSession, } from "./session.js";

package/dist/runtime/output.js

@@ -1,36 +0,0 @@
-import { exitCodeForCliError, normalizeCliError } from "./error.js";
-import { sanitizeCliDiagnostic } from "./sanitize.js";
-const serialize = (value) => `${JSON.stringify(value, null, 2)}\n`;
-export const createSuccessEnvelope = (data, invocation) => ({
-    ok: true,
-    data,
-    meta: {
-        command: invocation.command,
-        cliVersion: invocation.cliVersion,
-        apiBaseUrl: invocation.apiBaseUrl,
-    },
-});
-export const emitCliSuccess = (runtime, invocation, data) => {
-    runtime.stdout.write(serialize(invocation.legacy ? data : createSuccessEnvelope(data, invocation)));
-    return 0;
-};
-export const emitCliError = (runtime, invocation, error) => {
-    const normalized = normalizeCliError(error);
-    if (invocation.legacy) {
-        runtime.stderr.write(serialize({ error: normalized.message }));
-    }
-    else {
-        const envelope = {
-            ok: false,
-            error: normalized,
-            meta: { command: invocation.command },
-        };
-        runtime.stderr.write(serialize(envelope));
-    }
-    return exitCodeForCliError(normalized);
-};
-export const emitCliDiagnostic = (runtime, invocation, diagnostic) => {
-    if (invocation.quiet || !invocation.debug)
-        return;
-    runtime.stderr.write(serialize(sanitizeCliDiagnostic(diagnostic)));
-};

package/dist/runtime/process-runtime.js

@@ -1,28 +0,0 @@
-import { createInterface } from "node:readline/promises";
-export const createProcessRuntime = () => ({
-    stdout: {
-        write: (value) => {
-            process.stdout.write(value);
-        },
-    },
-    stderr: {
-        write: (value) => {
-            process.stderr.write(value);
-        },
-    },
-    isTTY: Boolean(process.stdin.isTTY && process.stderr.isTTY),
-    env: process.env,
-    prompt: async (message) => {
-        const prompt = createInterface({
-            input: process.stdin,
-            output: process.stderr,
-        });
-        try {
-            return await prompt.question(message);
-        }
-        finally {
-            prompt.close();
-        }
-    },
-    now: () => new Date(),
-});

package/dist/runtime/sanitize.js

@@ -1,50 +0,0 @@
-const sensitiveKeys = new Set([
-    "apikey",
-    "authorization",
-    "bb_api_key",
-    "password",
-    "paymentproof",
-    "paymentproofattachments",
-    "paymentproofpath",
-    "paymentreference",
-    "payload",
-    "proof",
-    "receipt",
-    "secret",
-    "token",
-]);
-const isPresignedUrl = (value) => typeof value === "string" &&
-    (/[?&]X-Amz-(?:Algorithm|Credential|Signature)=/i.test(value) ||
-        /[?&]X-Goog-(?:Algorithm|Credential|Signature)=/i.test(value));
-const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-export const sanitizeCliValue = (value, seen = new WeakSet()) => {
-    if (value === null ||
-        typeof value === "string" ||
-        typeof value === "boolean" ||
-        typeof value === "number") {
-        return isPresignedUrl(value) ? "[redacted]" : value;
-    }
-    if (typeof value === "bigint")
-        return value.toString();
-    if (value instanceof Date)
-        return value.toISOString();
-    if (typeof value !== "object" || value === null)
-        return String(value);
-    if (seen.has(value))
-        return "[circular]";
-    seen.add(value);
-    if (Array.isArray(value)) {
-        return value.map((item) => sanitizeCliValue(item, seen));
-    }
-    if (!isRecord(value))
-        return String(value);
-    return Object.fromEntries(Object.entries(value).map(([key, nestedValue]) => [
-        key,
-        sensitiveKeys.has(key.toLowerCase()) ||
-            key.toLowerCase().includes("secret") ||
-            key.toLowerCase().includes("password")
-            ? "[redacted]"
-            : sanitizeCliValue(nestedValue, seen),
-    ]));
-};
-export const sanitizeCliDiagnostic = (diagnostic) => sanitizeCliValue(diagnostic);

package/dist/runtime/session.js

@@ -1,50 +0,0 @@
-import { confirmSensitiveCommand } from "./confirmation.js";
-import { emitCliError, emitCliSuccess } from "./output.js";
-let activeSession;
-export const setActiveCliSession = (session) => {
-    activeSession = {
-        ...session,
-        confirmedEffects: new Set(),
-    };
-};
-export const clearActiveCliSession = () => {
-    activeSession = undefined;
-};
-export const getActiveCliSession = () => activeSession;
-const requireSession = () => {
-    if (activeSession === undefined) {
-        throw new Error("Budget Builder CLI runtime session is not configured.");
-    }
-    return activeSession;
-};
-const toJsonValue = (value) => {
-    const serialized = JSON.stringify(value, (_key, nestedValue) => typeof nestedValue === "bigint" ? nestedValue.toString() : nestedValue);
-    if (serialized === undefined)
-        return null;
-    return JSON.parse(serialized);
-};
-export const emitCommandResult = (data) => {
-    const session = requireSession();
-    return emitCliSuccess(session.runtime, session.invocation, toJsonValue(data));
-};
-export const emitCommandError = (error) => {
-    const session = requireSession();
-    return emitCliError(session.runtime, session.invocation, error);
-};
-export const confirmCurrentCommand = async (input) => {
-    const session = requireSession();
-    const effects = input.effects ?? session.effects;
-    const unconfirmedEffects = effects.filter((effect) => !session.confirmedEffects.has(effect));
-    if (unconfirmedEffects.length === 0)
-        return;
-    await confirmSensitiveCommand(session.runtime, {
-        action: input.action,
-        target: input.target,
-        details: input.details,
-        effects: unconfirmedEffects,
-        permissions: session.permissions,
-    });
-    for (const effect of unconfirmedEffects) {
-        session.confirmedEffects.add(effect);
-    }
-};

package/dist/runtime/types.js

@@ -1 +0,0 @@
-export {};