@arandevcode/opencode-quota-extended 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 arandevcode
+
+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-es.md

@@ -0,0 +1,153 @@
+<p align="center">
+  <img src="images/opencode_quota_extended_sidebar.png" alt="Barra lateral TUI" width="420">
+  <br>
+  <sub><em>-sidebar example-</em></sub>
+</p>
+
+# @arandevcode/opencode-quota-extended
+
+> 🇬🇧 Also available in [English](README.md)
+
+Tarjetas de uso de cuota para la barra lateral TUI — barras de progreso por ventana con colores de semáforo para OpenAI, GitHub Copilot y OpenCode Go.
+
+- Barra de progreso para cada ventana de cuota (5h móvil, semanal, mensual, code review...)
+- Muestra cuándo se reinicia — tiempo restante y fecha exacta
+- Indicador de salud por colores (verde = ok, naranja = advertencia, rojo = crítico)
+- OpenCode Go capable!
+
+Inspirado por [`@slkiser/opencode-quota`](https://github.com/slkiser/opencode-quota). Ambos coexisten sin conflicto.
+
+<br>
+<p align="center">🐟  <em>&ldquo;Quien quiera peces que se moje el culo&rdquo;</em>  <sub>— para mi padre, que me enseñó a arremangarme y hacer que las cosas pasen</sub>
+</p>
+
+<p align="center">
+  <a href="https://buymeacoffee.com/arandevcode"><strong>☕ Invítame un café</strong></a>
+  <br>
+  <sub><a href="https://github.com/sponsors/arandevcode">❤️ Sponsor en GitHub</a></sub>
+</p>
+
+## Instalación
+
+```sh
+opencode plugin @arandevcode/opencode-quota-extended
+```
+
+O instala desde GitHub para seguir el desarrollo más reciente:
+
+```json
+// ~/.config/opencode/opencode.json
+{
+  "plugin": [
+    "https://github.com/arandevcode/opencode-plugins/tree/main/opencode-quota-extended"
+  ]
+}
+```
+
+## CLI
+
+Visualiza la cuota desde la terminal sin abrir el TUI:
+
+```sh
+npx opencode-quota            # ejecutar vía npm (sin instalar)
+opencode-quota                # si está instalado globalmente
+node bin/quota.mjs            # desde el directorio del repo (sin build)
+npm run quota                 # desde el directorio del repo
+```
+
+<p align="center">
+  <img src="images/opencode_quota_extended_cli.png" alt="Salida CLI" width="620">
+  <br>
+  <sub><em>-cli example-</em></sub>
+</p>
+
+Colores de semáforo: verde (ok), naranja (advertencia), rojo (error).
+
+## Configuración
+
+Archivo sidecar opcional en `~/.config/opencode/opencode-quota-extended.json`:
+
+| Campo | Tipo | Por defecto | Descripción |
+|---|---|---|---|
+| `enabledProviders` | string[] | `["openai","github-copilot","opencode-go"]` | Proveedores a consultar |
+| `refreshIntervalMs` | int | `60000` | Intervalo de sondeo |
+| `cardsSidebar.order` | int | `145` | Posición en la barra lateral (menor = más arriba) |
+
+## Más Información
+
+### Cómo funciona
+
+Registra un plugin TUI que renderiza un panel `sidebar_content` en la posición 145, mostrando tarjetas de cuota para cada proveedor activo. Cada proveedor obtiene datos de cuota independientemente desde su propia API.
+
+| Proveedor | Ventanas | Fuente de autenticación |
+|---|---|---|
+| **OpenAI** | 5h móvil, Semanal, Code Review | `auth.json` → entrada `openai` / `chatgpt` |
+| **GitHub Copilot** | Solicitudes Premium (ventana única) | `auth.json` → entrada `github-copilot` |
+| **OpenCode Go** | 5h, Semanal, Mensual | Archivo de configuración o vars de entorno |
+
+Colores de semáforo: ≥50% verde (`accent`), 25-49% amarillo (`warning`), <25% rojo (`error`).
+
+### Autenticación
+
+Lee credenciales del archivo de autenticación de OpenCode (`~/.local/share/opencode/auth.json`). **No** almacena, solicita ni distribuye secretos.
+
+**OpenCode Go** requiere configuración adicional — es un poco tricky porque no hay API oficial todavía.
+
+Crea `~/.config/opencode/opencode-quota/opencode-go.json`:
+
+```json
+{
+  "workspaceId": "wrk_abc123...",
+  "authCookie": "Fe26.2..."
+}
+```
+
+| Campo | Descripción | Cómo obtenerlo |
+|---|---|---|
+| `workspaceId` | ID de tu workspace en OpenCode | Entra en [opencode.ai/go](https://opencode.ai/go). La URL es `https://opencode.ai/workspace/wrk_XXX/go` — copia la parte `wrk_XXX`. |
+| `authCookie` | Cookie de sesión para autenticación | Abre DevTools (F12) → Application → Cookies → `opencode.ai` → busca la cookie `auth` (empieza con `Fe26.2...`). O ejecuta en la consola: `document.cookie.match(/(?:^\|;\s*)auth=([^;]+)/)?.[1]` |
+
+**Setup automatizado** (recomendado):
+```sh
+npm run setup
+```
+Te solicita ambos valores y crea el archivo automáticamente. También muestra un bookmarklet que puedes arrastrar a la barra de favoritos y pinchar en opencode.ai para extraer la auth cookie con un clic.
+
+**Consejo:** mantén una pestaña del navegador con sesión iniciada en opencode.ai mientras usas este plugin — la auth cookie puede expirar.
+
+### Relación con [`@slkiser/opencode-quota`](https://github.com/slkiser/opencode-quota)
+
+**Sin dependencia.** Ambos plugins obtienen cuota independientemente y renderizan sus propios paneles laterales. Puedes tener uno, ambos o ninguno — no interfieren.
+
+### Solución de problemas
+
+- **El panel no aparece**: `grep '@arandevcode/opencode-quota-extended' ~/.local/share/opencode/log/*.log`
+- **OpenCode Go muestra "skipped"**: confirma que el archivo sidecar o vars de entorno están configurados
+- **Bug antiguo de pinning `@opentui/solid`**: actualiza a `^0.4.1` y reinstala limpio (`rm -rf node_modules && npm ci`)
+
+### Desarrollo
+
+```sh
+npm run build        # compilar TS + copiar assets TUI
+npm run build:watch  # modo watch
+npm test             # vitest
+npm run typecheck    # type-check sin emitir
+```
+
+### Estructura del proyecto
+
+```
+src/
+  index.ts            # Plugin module (entrada server)
+  server.ts           # Plugin server (mínimo, sin herramientas)
+  tui.tsx             # Plugin TUI: slot sidebar_content
+  config/             # defaults, schema, loader
+  lib/                # types, auth, http, formatting, credential resolver
+  providers/          # openai.ts, copilot.ts, opencode-go.ts, registry.ts
+  ui/                 # SidebarPanel, cards, progress-bar
+tests/                # tests unitarios vitest
+```
+
+## Licencia
+
+MIT

package/README.md

@@ -0,0 +1,154 @@
+<p align="center">
+  <img src="images/opencode_quota_extended_sidebar.png" alt="TUI sidebar" width="420">
+  <br>
+  <sub><em>-sidebar example-</em></sub>
+</p>
+
+# @arandevcode/opencode-quota-extended
+
+> 🇪🇸 Also available in [Spanish](README-es.md)
+
+Quota usage cards for the TUI sidebar — per-window progress bars with traffic-light colors for OpenAI, GitHub Copilot, and OpenCode Go.
+
+- Progress bar for each quota window (5h rolling, weekly, monthly, code review...)
+- Shows when it resets — time remaining and exact date
+- Color-coded health indication (green = ok, orange = warning, red = critical)
+- OpenCode Go capable!
+
+Heavily inspired by [`@slkiser/opencode-quota`](https://github.com/slkiser/opencode-quota). Both coexist without conflict.
+
+<br>
+<p align="center">🐟 <em>&ldquo;Quien quiera peces que se moje el culo&rdquo;</em> >
+  <em>&ldquo;If you want fish, get your ass wet&rdquo;</em>  <sub>— for my father, who taught me to roll up my sleeves and get it done</sub>
+</p>
+
+<p align="center">
+  <a href="https://buymeacoffee.com/arandevcode"><strong>☕ Buy me a coffee</strong></a>
+  <br>
+  <sub><a href="https://github.com/sponsors/arandevcode">❤️ Sponsor on GitHub</a></sub>
+</p>
+
+## Install
+
+```sh
+opencode plugin @arandevcode/opencode-quota-extended
+```
+
+Or install from GitHub source to follow latest development:
+
+```json
+// ~/.config/opencode/opencode.json
+{
+  "plugin": [
+    "https://github.com/arandevcode/opencode-plugins/tree/main/opencode-quota-extended"
+  ]
+}
+```
+
+## CLI
+
+View quota from the terminal without opening the TUI:
+
+```sh
+npx opencode-quota            # run via npm (no install)
+opencode-quota                # if installed globally
+node bin/quota.mjs            # from the repo directory (no build needed)
+npm run quota                 # from the repo directory
+```
+
+<p align="center">
+  <img src="images/opencode_quota_extended_cli.png" alt="CLI output" width="620">
+  <br>
+  <sub><em>-cli example-</em></sub>
+</p>
+
+Traffic-light colors: green (ok), orange (warning), red (error).
+
+## Configuration
+
+Optional sidecar at `~/.config/opencode/opencode-quota-extended.json`:
+
+| Field | Type | Default | Description |
+|---|---|---|---|
+| `enabledProviders` | string[] | `["openai","github-copilot","opencode-go"]` | Providers to fetch |
+| `refreshIntervalMs` | int | `60000` | Polling interval |
+| `cardsSidebar.order` | int | `145` | Sidebar position (lower = higher) |
+
+## More Information
+
+### How it works
+
+Registers a TUI plugin that renders a `sidebar_content` panel at order 145, showing quota cards for every enabled provider. Each provider fetches quota data independently from its own API.
+
+| Provider | Windows | Auth source |
+|---|---|---|
+| **OpenAI** | 5h rolling, Weekly, Code Review | `auth.json` → `openai` / `chatgpt` entry |
+| **GitHub Copilot** | Premium requests (single window) | `auth.json` → `github-copilot` entry |
+| **OpenCode Go** | 5h, Weekly, Monthly | Config file or env vars |
+
+Traffic-light colors: ≥50% green (`accent`), 25-49% yellow (`warning`), <25% red (`error`).
+
+### Authentication
+
+Reads credentials from OpenCode's runtime auth file (`~/.local/share/opencode/auth.json`). Does **not** store, prompt for, or distribute secrets.
+
+**OpenCode Go** requires additional setup — it's a bit tricky because there's no official API yet.
+
+Create `~/.config/opencode/opencode-quota/opencode-go.json`:
+
+```json
+{
+  "workspaceId": "wrk_abc123...",
+  "authCookie": "Fe26.2..."
+}
+```
+
+| Field | Description | How to get it |
+|---|---|---|
+| `workspaceId` | Your OpenCode workspace ID | Log in at [opencode.ai/go](https://opencode.ai/go). The URL is `https://opencode.ai/workspace/wrk_XXX/go` — copy the `wrk_XXX` part. |
+| `authCookie` | Session cookie for auth | Open DevTools (F12) → Application → Cookies → `opencode.ai` → find the `auth` cookie (starts with `Fe26.2...`). Or run this in the console: `document.cookie.match(/(?:^\|;\s*)auth=([^;]+)/)?.[1]` |
+
+**Automated setup** (recommended):
+```sh
+npm run setup
+```
+This prompts for both values and creates the file for you. It also prints a bookmarklet you can drag to your bookmarks bar and click while on opencode.ai to extract the auth cookie with one click.
+
+**Tip:** keep a browser tab logged into opencode.ai while using this plugin — the auth cookie may expire.
+
+### Relationship with [`@slkiser/opencode-quota`](https://github.com/slkiser/opencode-quota)
+
+**No dependency.** Both plugins fetch quota independently and render their own sidebar panels. You can have one, both, or none — they do not interfere.
+
+### Troubleshooting
+
+- **Panel doesn't appear**: `grep '@arandevcode/opencode-quota-extended' ~/.local/share/opencode/log/*.log`
+- **OpenCode Go shows "skipped"**: confirm sidecar file or env vars are set
+- **Old `@opentui/solid` pinning bug**: update to `^0.4.1` and clean-install (`rm -rf node_modules && npm ci`)
+
+### Development
+
+```sh
+npm run build        # compile TS + copy TUI assets
+npm run build:watch  # watch mode
+npm test             # vitest
+npm run typecheck    # type-check without emitting
+```
+
+### Project structure
+
+```
+src/
+  index.ts            # Plugin module (server entry)
+  server.ts           # Server plugin (minimal, no tools)
+  tui.tsx             # TUI plugin: sidebar_content slot
+  config/             # defaults, schema, loader
+  lib/                # types, auth, http, formatting, credential resolver
+  providers/          # openai.ts, copilot.ts, opencode-go.ts, registry.ts
+  ui/                 # SidebarPanel, cards, progress-bar
+tests/                # vitest unit tests
+```
+
+## License
+
+MIT

package/bin/quota.mjs

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+
+import { fileURLToPath } from "url";
+import { dirname } from "path";
+import { loadCardsConfig } from "../dist/config/loader.js";
+import { collectSnapshot } from "../dist/providers/registry.js";
+import { renderProgressBar, trafficLight } from "../dist/ui/progress-bar.js";
+import { formatResetCombined } from "../dist/lib/reset-format.js";
+
+const INDENT = 4;
+
+const COLORS = {
+  ok: "\x1b[38;2;107;131;35m",
+  warning: "\x1b[38;2;255;165;0m",
+  error: "\x1b[38;2;255;107;107m",
+};
+const RESET = "\x1b[0m";
+const BOLD = "\x1b[1m";
+const DIM = "\x1b[2m";
+
+function stripAnsi(s) {
+  return s.replace(/\x1b\[[0-9;]*m/g, "");
+}
+function cols() {
+  return process.stdout.columns ?? 80;
+}
+function usedPct(pct) {
+  return `${Math.round(100 - pct)}% used`;
+}
+function windowLabel(window) {
+  if (
+    typeof window.remaining === "number" &&
+    typeof window.total === "number" &&
+    Number.isFinite(window.remaining) &&
+    Number.isFinite(window.total)
+  ) {
+    return `${window.remaining}/${window.total}`;
+  }
+  return window.label;
+}
+function padRight(left, right) {
+  const gap = Math.max(2, cols() - INDENT - stripAnsi(left).length - stripAnsi(right).length);
+  return left + " ".repeat(gap) + right;
+}
+
+async function main() {
+  const __dirname = dirname(fileURLToPath(import.meta.url));
+
+  const loadResult = await loadCardsConfig();
+  const config = loadResult.config;
+  const barWidth = cols() - INDENT;
+
+  console.log(`\n${BOLD}Quota${RESET}\n`);
+
+  const snapshot = await collectSnapshot(config);
+
+  for (const provider of snapshot.providers) {
+    if (provider.status === "skipped") continue;
+
+    if (provider.status === "no-auth") {
+      console.log(`  ${BOLD}${provider.label}${RESET}  ${DIM}no auth${RESET}`);
+      continue;
+    }
+
+    if (provider.status === "error") {
+      console.log(
+        `  ${BOLD}${provider.label}${RESET}  ${COLORS.error}${provider.error ?? "error"}${RESET}`,
+      );
+      continue;
+    }
+
+    if (provider.windows.length === 0) {
+      console.log(`  ${BOLD}${provider.label}${RESET}  ${DIM}no data${RESET}`);
+      continue;
+    }
+
+    console.log(`  ${BOLD}${provider.label}${RESET}`);
+
+    for (const [i, win] of provider.windows.entries()) {
+      if (i > 0) console.log();
+      const pct = win.percentRemaining;
+      const light = trafficLight(pct);
+      const color = COLORS[light];
+      const bar = renderProgressBar(pct, barWidth);
+      const resetT = formatResetCombined(win.resetTimeIso);
+      const resetStyle = resetT ? (light === "error" ? `${color}${resetT}${RESET}` : `${DIM}${resetT}${RESET}`) : "";
+
+      const labelStr = windowLabel(win);
+      console.log(" ".repeat(INDENT) + padRight(labelStr, resetStyle));
+      console.log(" ".repeat(INDENT) + color + bar.filled + bar.empty + RESET);
+      const combined = `${usedPct(pct)} / `;
+      const leftStr = `${pct}% left`;
+      const pad = Math.max(0, cols() - INDENT - stripAnsi(combined + leftStr).length);
+      console.log(" ".repeat(INDENT + pad) + combined + color + leftStr + RESET);
+    }
+    console.log();
+  }
+
+  console.log(`${DIM}Generated at: ${snapshot.generatedAt}${RESET}`);
+}
+
+main().catch((err) => {
+  console.error("Error:", err.message);
+  process.exit(1);
+});

package/dist/config/defaults.d.ts

@@ -0,0 +1,16 @@
+export interface CardsPluginConfig {
+    enabled: boolean;
+    enabledProviders: Array<"openai" | "github-copilot" | "opencode-go">;
+    refreshIntervalMs: number;
+    requestTimeoutMs: number;
+    opencodeGoTimeoutMs: number;
+    showOnlyMultiWindow: boolean;
+    cardsSidebar: {
+        enabled: boolean;
+        order: number;
+    };
+    opencodeGoWindows: Array<"5h" | "weekly" | "monthly">;
+}
+export declare const DEFAULT_CONFIG: CardsPluginConfig;
+export declare const SIDECAR_FILENAME = "opencode-quota-extended.json";
+//# sourceMappingURL=defaults.d.ts.map

package/dist/config/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB,EAAE,KAAK,CAAC,QAAQ,GAAG,gBAAgB,GAAG,aAAa,CAAC,CAAC;IACrE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,YAAY,EAAE;QACZ,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,iBAAiB,EAAE,KAAK,CAAC,IAAI,GAAG,QAAQ,GAAG,SAAS,CAAC,CAAC;CACvD;AAED,eAAO,MAAM,cAAc,EAAE,iBAY5B,CAAC;AAEF,eAAO,MAAM,gBAAgB,iCAAiC,CAAC"}

package/dist/config/defaults.js

@@ -0,0 +1,15 @@
+export const DEFAULT_CONFIG = {
+    enabled: true,
+    enabledProviders: ["openai", "github-copilot", "opencode-go"],
+    refreshIntervalMs: 60_000,
+    requestTimeoutMs: 8_000,
+    opencodeGoTimeoutMs: 10_000,
+    showOnlyMultiWindow: false,
+    cardsSidebar: {
+        enabled: true,
+        order: 145,
+    },
+    opencodeGoWindows: ["5h", "weekly", "monthly"],
+};
+export const SIDECAR_FILENAME = "opencode-quota-extended.json";
+//# sourceMappingURL=defaults.js.map

package/dist/config/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,MAAM,cAAc,GAAsB;IAC/C,OAAO,EAAE,IAAI;IACb,gBAAgB,EAAE,CAAC,QAAQ,EAAE,gBAAgB,EAAE,aAAa,CAAC;IAC7D,iBAAiB,EAAE,MAAM;IACzB,gBAAgB,EAAE,KAAK;IACvB,mBAAmB,EAAE,MAAM;IAC3B,mBAAmB,EAAE,KAAK;IAC1B,YAAY,EAAE;QACZ,OAAO,EAAE,IAAI;QACb,KAAK,EAAE,GAAG;KACX;IACD,iBAAiB,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC;CAC/C,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,8BAA8B,CAAC"}

package/dist/config/index.html

@@ -0,0 +1,26 @@
+<!DOCTYPE HTML>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<title>Directory listing for /opencode-personal-projects/opencode-quota-extended/dist/config/</title>
+</head>
+<body>
+<h1>Directory listing for /opencode-personal-projects/opencode-quota-extended/dist/config/</h1>
+<hr>
+<ul>
+<li><a href="defaults.d.ts">defaults.d.ts</a></li>
+<li><a href="defaults.d.ts.map">defaults.d.ts.map</a></li>
+<li><a href="defaults.js">defaults.js</a></li>
+<li><a href="defaults.js.map">defaults.js.map</a></li>
+<li><a href="loader.d.ts">loader.d.ts</a></li>
+<li><a href="loader.d.ts.map">loader.d.ts.map</a></li>
+<li><a href="loader.js">loader.js</a></li>
+<li><a href="loader.js.map">loader.js.map</a></li>
+<li><a href="schema.d.ts">schema.d.ts</a></li>
+<li><a href="schema.d.ts.map">schema.d.ts.map</a></li>
+<li><a href="schema.js">schema.js</a></li>
+<li><a href="schema.js.map">schema.js.map</a></li>
+</ul>
+<hr>
+</body>
+</html>

package/dist/config/loader.d.ts

@@ -0,0 +1,10 @@
+import { type CardsPluginConfig } from "./defaults.js";
+export type LoadConfigSource = "defaults" | "cwd" | "opencode-config" | "xdg-config" | "xdg-config-fallback" | "env-override";
+export interface LoadConfigResult {
+    config: CardsPluginConfig;
+    source: LoadConfigSource;
+    path: string | null;
+    error?: string;
+}
+export declare function loadCardsConfig(): Promise<LoadConfigResult>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAMA,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,eAAe,CAAC;AAGvB,MAAM,MAAM,gBAAgB,GACxB,UAAU,GACV,KAAK,GACL,iBAAiB,GACjB,YAAY,GACZ,qBAAqB,GACrB,cAAc,CAAC;AAEnB,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,MAAM,EAAE,gBAAgB,CAAC;IACzB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA8CD,wBAAsB,eAAe,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAsDjE"}

package/dist/config/loader.js

@@ -0,0 +1,89 @@
+import { access, readFile } from "fs/promises";
+import { homedir } from "os";
+import { join } from "path";
+import { xdgConfig } from "xdg-basedir";
+import { DEFAULT_CONFIG, SIDECAR_FILENAME, } from "./defaults.js";
+import { parseCardsConfig } from "./schema.js";
+function getOpencodeConfigDir() {
+    if (process.env.OPENCODE_CONFIG_DIR) {
+        return process.env.OPENCODE_CONFIG_DIR;
+    }
+    if (xdgConfig) {
+        return join(xdgConfig, "opencode");
+    }
+    return join(homedir(), ".config", "opencode");
+}
+async function fileExists(filePath) {
+    try {
+        await access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function tryLoad(filePath, source) {
+    try {
+        const raw = await readFile(filePath, "utf8");
+        const parsed = JSON.parse(raw);
+        const config = parseCardsConfig(parsed);
+        return { ok: true, result: { config, source, path: filePath } };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { ok: false, error: `${source}: ${message}` };
+    }
+}
+export async function loadCardsConfig() {
+    const errors = [];
+    const candidates = [];
+    const envPath = process.env.OPENCODE_QUOTA_CARDS_CONFIG;
+    if (envPath) {
+        candidates.push({ path: envPath, source: "env-override" });
+    }
+    candidates.push({
+        path: join(process.cwd(), SIDECAR_FILENAME),
+        source: "cwd",
+    });
+    const opencodeConfigDir = getOpencodeConfigDir();
+    if (opencodeConfigDir) {
+        candidates.push({
+            path: join(opencodeConfigDir, SIDECAR_FILENAME),
+            source: "opencode-config",
+        });
+    }
+    if (xdgConfig) {
+        candidates.push({
+            path: join(xdgConfig, SIDECAR_FILENAME),
+            source: "xdg-config",
+        });
+    }
+    else {
+        candidates.push({
+            path: join(homedir(), ".config", SIDECAR_FILENAME),
+            source: "xdg-config-fallback",
+        });
+    }
+    for (const candidate of candidates) {
+        if (!(await fileExists(candidate.path)))
+            continue;
+        const attempt = await tryLoad(candidate.path, candidate.source);
+        if (attempt.ok) {
+            if (errors.length > 0) {
+                return { ...attempt.result, error: errors.join("; ") };
+            }
+            return attempt.result;
+        }
+        errors.push(attempt.error);
+    }
+    if (errors.length > 0) {
+        return {
+            config: DEFAULT_CONFIG,
+            source: "defaults",
+            path: null,
+            error: errors.join("; "),
+        };
+    }
+    return { config: DEFAULT_CONFIG, source: "defaults", path: null };
+}
+//# sourceMappingURL=loader.js.map

package/dist/config/loader.js.map

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

package/dist/config/schema.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Zod schemas for validating the plugin sidecar configuration file.
+ *
+ * The root schema `cardsConfigSchema` uses `.passthrough()` to allow
+ * documentation keys prefixed with `_` (e.g. `_comment`).
+ */
+import { z } from "zod";
+import type { CardsPluginConfig } from "./defaults.js";
+export declare const WindowIdForOpenCodeGo: z.ZodEnum<{
+    "5h": "5h";
+    weekly: "weekly";
+    monthly: "monthly";
+}>;
+export declare const cardsConfigSchema: z.ZodType<CardsPluginConfig>;
+export declare function parseCardsConfig(input: unknown): CardsPluginConfig;
+//# sourceMappingURL=schema.d.ts.map

package/dist/config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAIvD,eAAO,MAAM,qBAAqB;;;;EAAsC,CAAC;AAkBzE,eAAO,MAAM,iBAAiB,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CACU,CAAC;AAEtE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAElE"}

package/dist/config/schema.js

@@ -0,0 +1,28 @@
+/**
+ * Zod schemas for validating the plugin sidecar configuration file.
+ *
+ * The root schema `cardsConfigSchema` uses `.passthrough()` to allow
+ * documentation keys prefixed with `_` (e.g. `_comment`).
+ */
+import { z } from "zod";
+const providerIdSchema = z.enum(["openai", "github-copilot", "opencode-go"]);
+export const WindowIdForOpenCodeGo = z.enum(["5h", "weekly", "monthly"]);
+const cardsSidebarSchema = z.object({
+    enabled: z.boolean(),
+    order: z.number().int(),
+});
+const cardsConfigBaseSchema = z.object({
+    enabled: z.boolean(),
+    enabledProviders: z.array(providerIdSchema).min(1),
+    refreshIntervalMs: z.coerce.number().int().positive(),
+    requestTimeoutMs: z.coerce.number().int().positive(),
+    opencodeGoTimeoutMs: z.coerce.number().int().positive(),
+    showOnlyMultiWindow: z.boolean(),
+    cardsSidebar: cardsSidebarSchema,
+    opencodeGoWindows: z.array(WindowIdForOpenCodeGo).min(1),
+});
+export const cardsConfigSchema = cardsConfigBaseSchema.passthrough();
+export function parseCardsConfig(input) {
+    return cardsConfigSchema.parse(input);
+}
+//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,gBAAgB,EAAE,aAAa,CAAC,CAAC,CAAC;AAE7E,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;AAEzE,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;CACxB,CAAC,CAAC;AAEH,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAClD,iBAAiB,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACrD,gBAAgB,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACpD,mBAAmB,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACvD,mBAAmB,EAAE,CAAC,CAAC,OAAO,EAAE;IAChC,YAAY,EAAE,kBAAkB;IAChC,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACzD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAC5B,qBAAqB,CAAC,WAAW,EAAkC,CAAC;AAEtE,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC"}