@brokr/sdk 1.0.0 → 2.1.0

package/dist/files.js

@@ -0,0 +1,428 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/files/client.ts
+var client_exports = {};
+__export(client_exports, {
+  BrokrFilesClient: () => BrokrFilesClient
+});
+module.exports = __toCommonJS(client_exports);
+
+// src/fix-registry.ts
+var FIX_REGISTRY = {
+  AUTH_TOKEN_INVALID: [
+    "\u2192 Run `brokr env pull --stack <name>` to refresh your token",
+    "\u2192 Or run `brokr link account` to re-authenticate"
+  ].join("\n"),
+  AUTH_SESSION_EXPIRED: [
+    "\u2192 Run `brokr link account` to re-authenticate"
+  ].join("\n"),
+  BROKR_TOKEN_MISSING: [
+    "\u2192 Run `brokr env pull --stack <name>` to sync your environment",
+    "\u2192 Or add BROKR_TOKEN to your .env.local manually"
+  ].join("\n"),
+  DATABASE_PROVISION_FAILED: [
+    "\u2192 Run `brokr status <stack>` to check current state",
+    "\u2192 Run `brokr retry <stack>` to re-trigger provisioning"
+  ].join("\n"),
+  DATABASE_QUOTA_REACHED: [
+    "\u2192 Upgrade your plan or delete unused databases",
+    "\u2192 Check usage at brokr.sh/billing"
+  ].join("\n"),
+  DATABASE_HEALTH_TIMEOUT: [
+    "\u2192 Run `brokr status <stack>` to check database state",
+    "\u2192 If persistent, check provider status page"
+  ].join("\n"),
+  DEPLOYMENT_FAILED: [
+    "\u2192 Run `brokr logs --stack <name>` to see build logs",
+    "\u2192 Fix the build error and run `brokr deploy`"
+  ].join("\n"),
+  DEPLOYMENT_RATE_LIMITED: [
+    "\u2192 Wait a minute and retry",
+    "\u2192 Vercel rate limits apply per project"
+  ].join("\n"),
+  REPO_ALREADY_EXISTS: [
+    "\u2192 Use a different stack name",
+    "\u2192 Or run `brokr status <stack>` to check the existing stack"
+  ].join("\n"),
+  REPO_CREATE_FAILED: [
+    "\u2192 Check your GitHub connection: `brokr link account`",
+    "\u2192 Ensure the Brokr GitHub App is installed"
+  ].join("\n"),
+  EMAIL_DOMAIN_FAILED: [
+    "\u2192 Check DNS records are propagated",
+    "\u2192 Run `brokr status <stack>` for details"
+  ].join("\n"),
+  DNS_RECORD_FAILED: [
+    "\u2192 Check Cloudflare dashboard for zone status",
+    "\u2192 Retry with `brokr retry <stack>`"
+  ].join("\n"),
+  INSUFFICIENT_CREDITS: [
+    "\u2192 Top up credits at brokr.sh/billing",
+    "\u2192 Or run `brokr billing topup`"
+  ].join("\n"),
+  AI_BUDGET_EXCEEDED: [
+    "\u2192 Top up credits at brokr.sh/billing",
+    "\u2192 Or run `brokr billing topup`"
+  ].join("\n"),
+  AI_PROVIDER_UNAVAILABLE: [
+    "\u2192 The AI provider is temporarily down",
+    "\u2192 Retry in a few seconds \u2014 this is usually transient"
+  ].join("\n"),
+  AI_MODEL_NOT_FOUND: [
+    "\u2192 Check the model name in your configuration",
+    "\u2192 See available models at brokr.sh/docs/ai-models"
+  ].join("\n"),
+  ENV_VAR_MISSING: [
+    "\u2192 Run `brokr env pull --stack <name>` to sync environment",
+    "\u2192 Check required vars in your template README"
+  ].join("\n"),
+  STACK_LIMIT_REACHED: [
+    "\u2192 Delete unused stacks with `brokr delete <stack>`",
+    "\u2192 Or upgrade your plan at brokr.sh/billing"
+  ].join("\n"),
+  STACK_NOT_FOUND: [
+    "\u2192 Check the stack name: `brokr list`",
+    "\u2192 Create a new stack: `brokr create --name <name>`"
+  ].join("\n"),
+  RATE_LIMITED: [
+    "\u2192 Wait a moment and retry",
+    "\u2192 If persistent, check brokr.sh/status"
+  ].join("\n"),
+  GATEWAY_AUTH_FAILED: [
+    "\u2192 Your BROKR_TOKEN may be expired",
+    "\u2192 Run `brokr env pull --stack <name>` to refresh"
+  ].join("\n"),
+  BROKR_TOKEN_INVALID: [
+    "\u2192 Your BROKR_TOKEN has expired or been revoked",
+    "\u2192 Run `brokr env pull --stack <name>` to get a fresh token"
+  ].join("\n"),
+  AI_STREAM_ERROR: [
+    "\u2192 The AI stream was interrupted",
+    "\u2192 Retry the request \u2014 this is usually transient"
+  ].join("\n"),
+  EMAIL_SEND_FAILED: [
+    "\u2192 Email delivery failed",
+    "\u2192 Check that your domain DNS is verified: `brokr status <stack>`"
+  ].join("\n"),
+  EMAIL_NOT_CONFIGURED: [
+    "\u2192 Email is not set up for this stack",
+    "\u2192 Add email capability: `brokr add email --stack <name>`"
+  ].join("\n"),
+  EMAIL_INVALID_FROM: [
+    "\u2192 The from address must match your verified domain",
+    "\u2192 Check your domain: `brokr status <stack>`"
+  ].join("\n"),
+  STORAGE_UPLOAD_FAILED: [
+    "\u2192 File upload failed",
+    "\u2192 Check file size limits and retry"
+  ].join("\n"),
+  STORAGE_NOT_FOUND: [
+    "\u2192 The requested file does not exist",
+    "\u2192 Check the key and try again"
+  ].join("\n"),
+  PAYMENTS_NOT_CONFIGURED: [
+    "\u2192 Payments are not set up for this stack",
+    "\u2192 Run `brokr payments sync` to configure Stripe"
+  ].join("\n"),
+  PAYMENTS_FAILED: [
+    "\u2192 Payment processing failed",
+    "\u2192 Check your Stripe dashboard for details"
+  ].join("\n"),
+  GATEWAY_INTERNAL: [
+    "\u2192 The Brokr gateway encountered an internal error",
+    "\u2192 Check brokr.sh/status for service health"
+  ].join("\n"),
+  UPSTREAM_ERROR: [
+    "\u2192 An upstream service is temporarily unavailable",
+    "\u2192 Retry in a few seconds \u2014 this is usually transient"
+  ].join("\n"),
+  NETWORK_ERROR: [
+    "\u2192 Could not reach the Brokr gateway",
+    "\u2192 Check your internet connection",
+    "\u2192 Check brokr.sh/status for service health"
+  ].join("\n"),
+  TIMEOUT: [
+    "\u2192 Request timed out",
+    "\u2192 Retry \u2014 if persistent, check brokr.sh/status"
+  ].join("\n")
+};
+
+// src/errors.ts
+var BrokrError = class extends Error {
+  constructor(message, code, capability, retryable = false, errorCode, requestId, hint) {
+    super(message);
+    this.code = code;
+    this.capability = capability;
+    this.retryable = retryable;
+    this.errorCode = errorCode;
+    this.requestId = requestId;
+    this.hint = hint;
+    this.name = "BrokrError";
+  }
+  /** Multi-line terminal fix block — looked up from error code. */
+  get fix() {
+    if (!this.errorCode) return void 0;
+    return FIX_REGISTRY[this.errorCode];
+  }
+  /** Documentation URL for this error code. */
+  get docsUrl() {
+    if (!this.errorCode) return void 0;
+    return `https://brokr.sh/errors/${this.errorCode.toLowerCase().replace(/_/g, "-")}`;
+  }
+  /** Safe message for end users — zero technical language. */
+  toUserMessage() {
+    switch (this.code) {
+      case "RATE_LIMITED":
+        return "Please wait a moment and try again.";
+      case "TIMEOUT":
+        return "The request took too long. Please try again.";
+      case "NETWORK_ERROR":
+        return "Connection issue. Check your internet and try again.";
+      case "BROKR_TOKEN_MISSING":
+        return "App is not connected to Brokr. Contact the developer.";
+      case "BROKR_TOKEN_INVALID":
+        return "Session expired. Please refresh.";
+      case "AI_BUDGET_EXCEEDED":
+        return "AI usage limit reached. The developer needs to add credits.";
+      case "AI_PROVIDER_UNAVAILABLE":
+        return "AI service is temporarily down. Please retry shortly.";
+      case "AI_PROVIDER_RATE_LIMITED":
+        return "Too many AI requests. Please wait a moment.";
+      case "INSUFFICIENT_CREDITS":
+        return "Not enough credits. Please top up your balance.";
+      case "STORAGE_UPLOAD_FAILED":
+        return "File upload failed. Please try again.";
+      case "STORAGE_NOT_FOUND":
+        return "File not found.";
+      case "EMAIL_SEND_FAILED":
+        return "Email could not be sent. Please try again.";
+      case "EMAIL_NOT_CONFIGURED":
+        return "Email is not set up for this app.";
+      case "PAYMENTS_NOT_CONFIGURED":
+        return "Payments are not configured. Contact the developer.";
+      case "PAYMENTS_FAILED":
+        return "Payment processing failed. Please try again.";
+      case "NOT_FOUND":
+        return "The requested resource was not found.";
+      case "VALIDATION_ERROR":
+        return "Invalid input. Please check your data and try again.";
+      default:
+        return "Something went wrong. We're looking into it.";
+    }
+  }
+  toString() {
+    return `${this.name} [${this.errorCode ?? this.code}]: ${this.message}`;
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      code: this.code,
+      errorCode: this.errorCode,
+      message: this.message,
+      capability: this.capability,
+      retryable: this.retryable,
+      requestId: this.requestId,
+      hint: this.hint,
+      component: this.component
+    };
+  }
+};
+var BrokrAuthError = class extends BrokrError {
+  constructor(message, code) {
+    super(message, code, "auth", false);
+    this.name = "BrokrAuthError";
+  }
+};
+var BrokrRateLimitError = class extends BrokrError {
+  constructor(message, retryAfter, capability) {
+    super(message, "RATE_LIMITED", capability, true);
+    this.retryAfter = retryAfter;
+    this.name = "BrokrRateLimitError";
+  }
+};
+var BrokrNetworkError = class extends BrokrError {
+  constructor(message, capability) {
+    super(message, "NETWORK_ERROR", capability, true);
+    this.name = "BrokrNetworkError";
+  }
+};
+var BrokrTimeoutError = class extends BrokrError {
+  constructor(message, capability) {
+    super(message, "TIMEOUT", capability, true);
+    this.name = "BrokrTimeoutError";
+  }
+};
+
+// src/gateway.ts
+var FETCH_TIMEOUT_MS = 3e4;
+function requireToken(token, capability) {
+  if (!token) {
+    let hint = "brokr env pull --stack <name>";
+    try {
+      if (typeof process !== "undefined") {
+        const fs = require("fs");
+        const path = require("path");
+        const brokrFile = path.join(process.cwd(), ".brokr");
+        if (fs.existsSync(brokrFile)) {
+          const data = JSON.parse(fs.readFileSync(brokrFile, "utf8"));
+          if (data?.stackName) hint = `brokr env pull --stack ${data.stackName}`;
+        }
+      }
+    } catch {
+    }
+    throw new BrokrAuthError(
+      `BROKR_TOKEN is not set. Run: ${hint}`,
+      "BROKR_TOKEN_MISSING"
+    );
+  }
+}
+async function gatewayFetch(gatewayUrl, token, path, body, capability) {
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+  let res;
+  try {
+    res = await fetch(`${gatewayUrl}${path}`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", Authorization: `Bearer ${token}` },
+      body: JSON.stringify(body),
+      signal: controller.signal
+    });
+  } catch (err) {
+    if (err instanceof Error && err.name === "AbortError") {
+      throw new BrokrTimeoutError(
+        `Request timed out after ${FETCH_TIMEOUT_MS / 1e3}s`,
+        capability
+      );
+    }
+    throw new BrokrNetworkError(
+      "Could not reach Brokr gateway. Check your network.",
+      capability
+    );
+  } finally {
+    clearTimeout(timeout);
+  }
+  if (res.status === 429) {
+    const rawRetryAfter = parseInt(res.headers.get("Retry-After") ?? "60", 10);
+    const retryAfter = Number.isFinite(rawRetryAfter) ? rawRetryAfter : 60;
+    const data = await res.json().catch(() => ({}));
+    const errorMsg = typeof data.error === "string" ? data.error : `Rate limited (retry after ${retryAfter}s)`;
+    throw new BrokrRateLimitError(
+      errorMsg,
+      retryAfter,
+      capability
+    );
+  }
+  if (res.status === 401) {
+    throw new BrokrAuthError("Invalid or expired BROKR_TOKEN.", "BROKR_TOKEN_INVALID");
+  }
+  if (!res.ok) {
+    const body2 = await res.json().catch(() => ({}));
+    const errObj = typeof body2.error === "object" && body2.error !== null ? body2.error : void 0;
+    const errorData = body2.data ?? errObj?.data ?? body2;
+    const errorCode = errorData.errorCode ?? body2.code;
+    const hint = errorData.hint;
+    const requestId = errorData.requestId ?? res.headers.get("x-request-id");
+    const retryable = errorData.retryable;
+    const errorStr = typeof body2.error === "string" ? body2.error : void 0;
+    const message = body2.message ?? errObj?.message ?? errorStr ?? `${capability} request failed (HTTP ${res.status})`;
+    throw new BrokrError(
+      message,
+      errorCode ?? `${capability.toUpperCase()}_FAILED`,
+      capability,
+      retryable ?? false,
+      errorCode ?? void 0,
+      requestId ?? void 0,
+      hint ?? void 0
+    );
+  }
+  try {
+    return await res.json();
+  } catch {
+    throw new BrokrError(
+      `${capability} returned invalid response (expected JSON).`,
+      `${capability.toUpperCase()}_INVALID_RESPONSE`,
+      capability,
+      true
+    );
+  }
+}
+
+// src/files/client.ts
+var BrokrFilesClient = class {
+  constructor(_token, _gatewayUrl, _storage) {
+    this._token = _token;
+    this._gatewayUrl = _gatewayUrl;
+    this._storage = _storage;
+  }
+  /**
+   * Upload a file and trigger server-side AI processing.
+   * Returns the storage key plus any extracted description/text.
+   */
+  async process(params) {
+    requireToken(this._token, "files");
+    const uploaded = await this._storage.upload({
+      file: params.file,
+      path: params.fileName,
+      contentType: params.purpose === "text-extraction" ? "application/pdf" : void 0
+    });
+    const result = await gatewayFetch(
+      this._gatewayUrl,
+      this._token,
+      "/v1/files/process",
+      { key: uploaded.key, purpose: params.purpose ?? "general" },
+      "files"
+    );
+    return {
+      key: uploaded.key,
+      description: result.description,
+      text: result.text
+    };
+  }
+  /**
+   * Get an AI-generated description of an already-uploaded file.
+   */
+  async describe(key) {
+    requireToken(this._token, "files");
+    return gatewayFetch(
+      this._gatewayUrl,
+      this._token,
+      "/v1/files/describe",
+      { key },
+      "files"
+    );
+  }
+  /**
+   * Extract text from a PDF or image (OCR).
+   */
+  async getText(key) {
+    requireToken(this._token, "files");
+    return gatewayFetch(
+      this._gatewayUrl,
+      this._token,
+      "/v1/files/text",
+      { key },
+      "files"
+    );
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BrokrFilesClient
+});