@goodandready/dsh-subscriptions 0.6.0 → 0.6.2

package/lib/history.js

@@ -2,9 +2,9 @@ import { mkdirSync, readFileSync, writeFileSync } from 'node:fs'
 import { join } from 'node:path'
 import { homedir } from 'node:os'
 
-// #65: история запросов и стоимости. Хранится в
-// ~/.dsh/storages/dsh-subscriptions/history.json (JSON-массив, новые сверху).
-// Все IO best-effort и синхронные: сбой записи не должен ронять харнесс.
+// #65: request and cost history. Stored in
+// ~/.dsh/storages/dsh-subscriptions/history.json (JSON array, newest first).
+// All IO is best-effort and synchronous: a write failure must never crash the harness.
 
 export const DEFAULT_HISTORY_DIR = join(homedir(), '.dsh', 'storages', 'dsh-subscriptions')
 
@@ -42,7 +42,7 @@ export class HistoryStore {
     } catch { /* best-effort */ }
   }
 
-  /** Добавить одну запись. Возвращает длину истории. */
+  /** Add one entry. Returns the history length. */
   add(entry) {
     if (!entry || typeof entry !== 'object') return this.rows.length
     this.rows.unshift({ ts: Date.now(), ...entry })
@@ -51,7 +51,7 @@ export class HistoryStore {
     return this.rows.length
   }
 
-  /** Последние N записей (новые сверху). */
+  /** Last N entries (newest first). */
   recent(n) {
     return this.rows.slice(0, n)
   }

package/lib/http.js

@@ -80,3 +80,10 @@ export function safeJsonHandler(fn) {
     }
   }
 }
+
+export function escapeHtml(text) {
+  return String(text)
+    .replace(/&/g, '&')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+}

package/lib/images.js

@@ -1,26 +1,26 @@
-// Генерация картинок на подписке.
+// Image generation on a subscription.
 //
-// Здесь только протокол: куда идти, что послать и как прочитать ответ. Всё
-// остальное — сохранение файла, вложение в разговор, карточка — дело плагина
-// генерации; этот плагин лишь одалживает свой аккаунт.
+// This module only implements the protocol: where to go, what to send and how to read the response. Everything
+// else - saving the file, attaching it to the conversation, the card - is the job of the generation
+// plugin; this plugin only lends its account.
 //
-// Токен наружу не отдаётся: плагин объявляет службу внутри процесса, а не
-// маршрут в сети. Харнесс на этой машине доступен без пароля, и ручка,
-// раздающая живой токен подписки, была бы дырой пошире тех, что мы закрывали.
+// The token never leaves the process: the plugin exposes an in-process service, not
+// a network route. The harness on this machine is reachable without a password, and an endpoint
+// handing out a live subscription token would be a wider hole than the ones we already closed.
 
-/** Куда уходит запрос у подписки ChatGPT. */
+/** Where the ChatGPT subscription request goes. */
 export const CODEX_URL = 'https://chatgpt.com/backend-api/codex/images/generations'
-/** Модель, которую отдаёт этот адрес. */
+/** The model served by this endpoint. */
 export const CODEX_MODEL = 'gpt-image-2'
-/** Куда уходит запрос у подписки Grok. */
+/** Where the Grok subscription request goes. */
 export const GROK_URL = 'https://api.x.ai/v1/images/generations'
-/** Модель, которую отдаёт этот адрес. */
+/** The model served by this endpoint. */
 export const GROK_MODEL = 'grok-imagine-image-2.0'
 
-/** Размеры, которые понимает ChatGPT. */
+/** Sizes understood by ChatGPT. */
 export const SIZES = ['1024x1024', '1024x1536', '1536x1024', 'auto']
 
-/** Grok мыслит не размерами, а соотношением сторон. */
+/** Grok thinks in aspect ratios, not sizes. */
 const GROK_ASPECT = {
   '1024x1024': '1:1',
   '1024x1536': '2:3',
@@ -30,7 +30,7 @@ const GROK_ASPECT = {
 
 export function codexBody({ prompt, size, quality }) {
   const text = String(prompt || '').trim()
-  if (!text) throw new Error('нужен непустой запрос')
+  if (!text) throw new Error('prompt must be a non-empty string')
   return {
     prompt: text,
     model: CODEX_MODEL,
@@ -41,8 +41,8 @@ export function codexBody({ prompt, size, quality }) {
 
 export function grokBody({ prompt, size, quality }) {
   const text = String(prompt || '').trim()
-  if (!text) throw new Error('нужен непустой запрос')
-  // У Grok качество всего двух ступеней: высокое складывается со средним.
+  if (!text) throw new Error('prompt must be a non-empty string')
+  // Grok has only two quality tiers: high is composed from medium.
   const level = quality === 'low' ? 'low'
     : (quality === 'medium' || quality === 'high') ? 'medium'
       : undefined
@@ -55,7 +55,7 @@ export function grokBody({ prompt, size, quality }) {
   }
 }
 
-/** Разбор ответа: обе стороны отвечают одинаково. */
+/** Response parsing: both sides reply in the same shape. */
 export function parseImages(payload) {
   const body = payload && typeof payload === 'object' ? payload : {}
   const rows = Array.isArray(body.data) ? body.data : []
@@ -70,15 +70,15 @@ export function parseImages(payload) {
         : {}),
     })
   }
-  if (!images.length) throw new Error('в ответе нет картинок')
+  if (!images.length) throw new Error('response contains no images')
   return images
 }
 
 /**
- * Один запрос к нужному адресу с заголовками этого провайдера.
+ * One request to the right endpoint with this provider's headers.
  *
  * @param options {{provider, prompt, size, quality, session, fetchImpl, signal}}
- *   session — уже освежённый блок токенов: accessToken и, для ChatGPT, accountId.
+ *   session - already refreshed token block: accessToken and, for ChatGPT, accountId.
  */
 export async function generateOnce(options) {
   const { provider, session, fetchImpl, signal } = options
@@ -88,7 +88,7 @@ export async function generateOnce(options) {
   const headers = isCodex
     ? {
       authorization: `Bearer ${session.accessToken}`,
-      // ChatGPT различает аккаунты отдельным заголовком, без него отвечает отказом.
+      // ChatGPT distinguishes accounts with a separate header; without it the request is rejected.
       'chatgpt-account-id': session.accountId || '',
       originator: 'codex_cli_rs',
       'content-type': 'application/json',

package/lib/index.js

@@ -61,8 +61,8 @@ export function apply(ctx, config) {
     })
   })
 
-  // Регистрация кастомных вендоров из Config. Вызывается при старте и при
-  // каждой смене конфига (replace) — реестр пересобирается с нуля.
+  // Registering custom vendors from Config. Runs at startup and on
+  // every config change (replace) - the registry is rebuilt from scratch.
   function syncCustomVendors() {
     let profiles
     try {
@@ -104,7 +104,7 @@ export function apply(ctx, config) {
     onLimitNotice: (provider, ref, win, threshold) => {
       if (!live().notifyLimits) return
       const label = win.ru || win.en || win.id
-      try { ctx.log && ctx.log.warn && ctx.log.warn(`[dsh-subscriptions] ${provider} ${ref}: лимит ${label} на ${threshold}%`) } catch {}
+      try { ctx.log && ctx.log.warn && ctx.log.warn(`[dsh-subscriptions] ${provider} ${ref}: limit ${label} at ${threshold}%`) } catch {}
       try { ctx.emit && ctx.emit('subscriptions.limit-notice', { provider, ref, window: win.id, usedPercent: win.usedPercent, threshold }) } catch {}
     },
   })
@@ -141,7 +141,7 @@ export function apply(ctx, config) {
     if (!cfg.ollamaFallback || !models.length) throw err
     const model = cfg.ollamaFallbackModel || models[0].id
     try { ctx.emit && ctx.emit('subscriptions.ollama-fallback', { provider, model, reason: err && err.code || 'EXHAUSTED' }) } catch {}
-    try { ctx.log && ctx.log.warn && ctx.log.warn(`[dsh-subscriptions] ${provider}: все аккаунты исчерпаны (${err && err.code || 'EXHAUSTED'}), откат на ollama/${model}`) } catch {}
+    try { ctx.log && ctx.log.warn && ctx.log.warn(`[dsh-subscriptions] ${provider}: all accounts exhausted (${err && err.code || 'EXHAUSTED'}), откат на ollama/${model}`) } catch {}
     try {
       recordHistory({
         provider: 'ollama',
@@ -181,15 +181,15 @@ export function apply(ctx, config) {
     hideDeprecatedModels: () => !!live().hideDeprecatedModels,
   })
 
-  // Служба генерации картинок на подписке.
+  // Subscription-backed image generation service.
   //
-  // Наружу отдаётся действие, а не токен: маршрут в сети раздавал бы живой
-  // ключ доступа каждому, кто дотянется до харнесса, а служба живёт внутри
-  // процесса и видна только другим плагинам. Обновлением токена по-прежнему
-  // занимается один хозяин — этот плагин.
+  // An action is exposed, not a token: a network route would hand a live
+  // access key to anyone reaching the harness, while the service lives inside
+  // the process and is visible only to sibling plugins. Token refresh stays
+  // with a single owner - this plugin.
   ctx.effect(() => ctx.provide('subscriptions', subscriptions), 'dsh-subscriptions: subscriptions service')
   ctx.effect(() => ctx.provide('subscriptionImages', {
-    /** Провайдеры, у которых есть вход прямо сейчас. */
+    /** Providers with an active session right now. */
     async available() {
       const logged = await store.loggedInProviders()
       return ['codex', 'grok'].filter((name) => logged && logged[name])
@@ -202,13 +202,13 @@ export function apply(ctx, config) {
     async generate(request) {
       const provider = request && request.provider
       if (provider !== 'codex' && provider !== 'grok') {
-        throw new Error(`неизвестный провайдер подписки: ${provider}`)
+        throw new Error(`unknown subscription provider: ${provider}`)
       }
       const accounts = await store.listAccounts(provider)
       const slot = (accounts || []).find((row) => row && row.ref)
-      if (!slot) throw new Error(`нет входа в ${provider}: войдите в разделе «Подписки»`)
+      if (!slot) throw new Error(`not logged in to ${provider}: sign in in the Subscriptions section`)
       const raw = await store.resolveRaw(slot.ref)
-      if (!raw) throw new Error(`нет входа в ${provider}: войдите в разделе «Подписки»`)
+      if (!raw) throw new Error(`not logged in to ${provider}: sign in in the Subscriptions section`)
       const session = await store.ensureFresh(provider, parseBlob(raw), slot.ref)
       return generateOnce({
         provider,
@@ -220,7 +220,7 @@ export function apply(ctx, config) {
         signal: request.signal,
       })
     },
-  }), 'dsh-subscriptions: служба генерации картинок')
+  }), 'dsh-subscriptions: image generation service')
   const pending = new Map()
   const adapter = new SubscriptionAdapter({
     listAccounts: (provider) => store.listAccounts(provider),
@@ -466,8 +466,8 @@ export function apply(ctx, config) {
   ctx.effect(() => {
     syncAdapter().catch(() => { /* first paint */ })
     syncOllama().catch(() => { /* first paint */ })
-    // #75: eager refresh usage на старте, чтобы windows (5h/7d) появились в blob сразу
-    // и активная подписка в чипе сразу показывала 5h/7d/..., а не ждала probeInterval.
+    // #75: eager usage refresh at startup so the windows (5h/7d) land in the blob immediately
+    // and the active subscription chip shows 5h/7d/... right away instead of waiting for probeInterval.
     const eager = async () => {
       try {
         for (const slot of normalizeSlots(live().slots)) {
@@ -516,9 +516,9 @@ export function apply(ctx, config) {
     return () => clear(id)
   }, 'dsh-subscriptions: refresh ahead')
 
-  // Фоновый health-check: раз в N минут прогоняет дешёвый check по всем
-  // подключённым аккаунтам. Мёртвые помечаются через describeRef, cooldown
-  // не ставится (как в /check).
+  // Background health-check: every N minutes runs a cheap check across all
+  // connected accounts. Dead ones are flagged via describeRef, no cooldown
+  // is set (same as /check).
   ctx.effect(() => {
     const tick = async () => {
       const cfg = live()

package/lib/loopback.js

@@ -1,21 +1,21 @@
 import http from 'node:http'
 
-// #89: временный loopback-сервер для перехвата OAuth callback.
-// Слушает на зарегистрированном у провайдера redirect_uri (порт фиксирован
-// вендором: codex localhost:1455, grok 127.0.0.1:56121). Принимает GET с
-// code/state, отдаёт HTML-страницу и завершается после первого запроса.
+// #89: temporary loopback server to catch the OAuth callback.
+// Listens on the redirect_uri registered with the provider (vendor-fixed
+// port: codex localhost:1455, grok 127.0.0.1:56121). Accepts a GET with
+// code/state, serves an HTML page and shuts down after the first request.
 
 const OK_HTML = '<!doctype html><meta charset="utf-8"><title>Subscriptions</title><p>Signed in. You can close this tab and return to Settings.</p>'
 const ERR_HTML = '<!doctype html><meta charset="utf-8"><title>Subscriptions</title><p>Login failed. Return to Settings and paste the redirected URL.</p>'
 
 /**
- * Поднять loopback-сервер и дождаться callback.
+ * Start the loopback server and wait for the callback.
  * @param {object} opts
- * @param {string} opts.redirectUri  зарегистрированный redirect_uri (localhost/127.0.0.1)
- * @param {number} opts.timeoutMs    время жизни сервера
+ * @param {string} opts.redirectUri  registered redirect_uri (localhost/127.0.0.1)
+ * @param {number} opts.timeoutMs    server lifetime
  * @param {(query: URLSearchParams) => Promise<string>} opts.onCode
- *        вызывается с query callback-запроса; возвращает HTML для браузера.
- *        Бросок исключения = ошибка авторизации (отдаётся ERR_HTML).
+ *        called with the callback request query; returns HTML for the browser.
+ *        Throwing means an authorization error (ERR_HTML is served).
  * @returns {Promise<{url: string, close: () => void}>}
  */
 export function startLoopback({ redirectUri, timeoutMs = 10 * 60 * 1000, onCode }) {
@@ -30,7 +30,7 @@ export function startLoopback({ redirectUri, timeoutMs = 10 * 60 * 1000, onCode
   const promise = new Promise((resolve, reject) => {
     const server = http.createServer((req, res) => {
       const url = new URL(req.url || '/', `http://127.0.0.1:${port}`)
-      // Провайдер может редиректить на путь с suffix (например /auth/callback/extra)
+      // The provider may redirect to a suffixed path (e.g. /auth/callback/extra)
       if (!url.pathname.startsWith(path)) {
         res.writeHead(404, { 'Content-Type': 'text/html; charset=utf-8' })
         res.end(ERR_HTML)

package/lib/ratelimit.js

@@ -212,7 +212,7 @@ export function formatQuota(q) {
   if (!q) return ""
   const parts = []
   if (q.remaining!=null && q.limit!=null) parts.push(q.remaining+"/"+q.limit)
-  else if (q.remaining!=null) parts.push("осталось "+q.remaining)
-  if (q.resetAt) parts.push("сброс "+new Date(q.resetAt).toLocaleString())
+  else if (q.remaining!=null) parts.push("left "+q.remaining)
+  if (q.resetAt) parts.push("reset "+new Date(q.resetAt).toLocaleString())
   return parts.join(" · ")
 }

package/lib/refs.js

@@ -1,4 +1,4 @@
-// Встроенные провайдеры + динамические из Config.customVendors.
+// Built-in providers + dynamic ones from Config.customVendors.
 export const BUILTIN_PROVIDERS = Object.freeze([
   'codex',
   'claude',
@@ -8,6 +8,14 @@ export const BUILTIN_PROVIDERS = Object.freeze([
   'glm',
   'cursor',
   'kiro',
+  'copilot',
+  'qwen',
+  'ernie',
+  'spark',
+  'jetbrains',
+  'perplexity',
+  'replit',
+  'cody',
 ])
 
 const dynamicIds = new Set()