stub-auth 0.1.0

package/LICENSE

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

@@ -0,0 +1,60 @@
+# stub-auth
+
+[![npm version](https://img.shields.io/npm/v/stub-auth.svg)](https://www.npmjs.com/package/stub-auth)
+[![npm downloads](https://img.shields.io/npm/dm/stub-auth.svg)](https://www.npmjs.com/package/stub-auth)
+[![CI status](https://github.com/intisy/stub-auth/actions/workflows/publish.yml/badge.svg)](https://github.com/intisy/stub-auth/actions/workflows/publish.yml)
+
+A stub AI-provider driver for [`core-auth`](https://github.com/intisy/core-auth). It returns canned,
+valid Anthropic Messages API responses (JSON or SSE) so the auth pipeline — discovery, routing, and
+the per-app adapters in Claude Code and OpenCode — can be validated end to end without contacting any
+real provider. It is also the reference **example** for building new provider plugins: define
+`{ id, label, models, handle }`, let core-auth do the rest.
+
+## Under-the-Hood Architecture
+
+```mermaid
+flowchart LR
+  A[cc / oc chat] --> B[core-auth / loader proxy]
+  B --> C{active provider}
+  C -->|stub| D[driver.handle]
+  D -->|stream?| E[canned SSE]
+  D -->|else| F[canned JSON]
+  E --> A
+  F --> A
+```
+
+## Structure
+
+- `src/driver.ts` — the provider: `id`/`label`/`models` + `handle()` returning the canned response.
+- `src/index.ts` — OpenCode entry (`defineProvider(driver).opencode`).
+- `src/handler.ts` — Claude entry (the named `handle` the loader proxy calls).
+- `dist/` — esbuild bundles core-auth in, producing self-contained `index.js` + `handler.js`.
+
+## Installation
+
+### Via plugin-updater (primary)
+
+```bash
+npx -y plugin-updater@latest add https://github.com/intisy/stub-auth
+```
+
+Then pick **Stub** in the loader's Providers tab (`cc auth`) / `oc auth login`.
+
+### Via npm
+
+```bash
+npm install stub-auth
+```
+
+## Configuration
+
+`stub-auth` has no settings of its own. The active provider is stored by the loader; OpenCode selects
+it via `oc auth login` + a `stub/...` model.
+
+## Logging
+
+Request routing is logged by the loader/core-auth under `<configDir>/logs/YYYY-MM-DD/`.
+
+## License
+
+MIT

package/dist/handler.js

@@ -0,0 +1,54 @@
+// src/driver.ts
+var STUB_TEXT = "Hello from stub-auth \u2014 the core-auth pipeline works end to end.";
+function stubText(model) {
+  return STUB_TEXT + " (served by " + model + ")";
+}
+function jsonBody(model) {
+  return {
+    id: "msg_stub_0001",
+    type: "message",
+    role: "assistant",
+    model,
+    content: [{ type: "text", text: stubText(model) }],
+    stop_reason: "end_turn",
+    stop_sequence: null,
+    usage: { input_tokens: 1, output_tokens: 12 }
+  };
+}
+function sse(event, data) {
+  return "event: " + event + "\ndata: " + JSON.stringify(data) + "\n\n";
+}
+function streamBody(model) {
+  const msg = { id: "msg_stub_0001", type: "message", role: "assistant", model, content: [], stop_reason: null, stop_sequence: null, usage: { input_tokens: 1, output_tokens: 0 } };
+  return sse("message_start", { type: "message_start", message: msg }) + sse("content_block_start", { type: "content_block_start", index: 0, content_block: { type: "text", text: "" } }) + sse("content_block_delta", { type: "content_block_delta", index: 0, delta: { type: "text_delta", text: stubText(model) } }) + sse("content_block_stop", { type: "content_block_stop", index: 0 }) + sse("message_delta", { type: "message_delta", delta: { stop_reason: "end_turn", stop_sequence: null }, usage: { output_tokens: 12 } }) + sse("message_stop", { type: "message_stop" });
+}
+var driver = {
+  id: "stub",
+  label: "Stub",
+  opencodeProvider: "stub",
+  opencodeNpm: "@ai-sdk/anthropic",
+  // a few models so the Claude model-mapping is demonstrable
+  models: {
+    "stub-model": { name: "Stub Default" },
+    "stub-pro": { name: "Stub Pro" },
+    "stub-fast": { name: "Stub Fast" }
+  },
+  async handle(request, ctx) {
+    let body = {};
+    try {
+      body = await request.clone().json();
+    } catch {
+    }
+    const model = ctx && ctx.model || body.model || "stub-model";
+    if (body.stream) {
+      return new Response(streamBody(model), { status: 200, headers: { "content-type": "text/event-stream" } });
+    }
+    return new Response(JSON.stringify(jsonBody(model)), { status: 200, headers: { "content-type": "application/json" } });
+  }
+};
+
+// src/handler.ts
+var handle = driver.handle;
+export {
+  handle
+};

package/dist/index.js

@@ -0,0 +1,174 @@
+// core-auth/dist/opencode.js
+import { existsSync as existsSync4, readFileSync as readFileSync2, writeFileSync as writeFileSync2, mkdirSync as mkdirSync3 } from "fs";
+import { join as join4, dirname, resolve } from "path";
+import { homedir as homedir2 } from "os";
+
+// core-auth/dist/env.js
+import { existsSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+function getConfigDir() {
+  return process.env.HUB_CONFIG_DIR || (existsSync(join(homedir(), ".claude")) ? join(homedir(), ".claude") : join(homedir(), ".config", "opencode"));
+}
+
+// core-auth/dist/log.js
+import { existsSync as existsSync3, mkdirSync as mkdirSync2, appendFileSync } from "fs";
+import { join as join3 } from "path";
+
+// core-auth/dist/config.js
+import { existsSync as existsSync2, readFileSync, writeFileSync, mkdirSync } from "fs";
+import { join as join2 } from "path";
+function paths() {
+  const dir = getConfigDir();
+  return { preferred: join2(dir, "config", "core-auth.json"), fallback: join2(dir, "core-auth.json") };
+}
+function readConfig() {
+  const { preferred, fallback } = paths();
+  const p = existsSync2(preferred) ? preferred : existsSync2(fallback) ? fallback : null;
+  try {
+    return p ? JSON.parse(readFileSync(p, "utf8")) : {};
+  } catch {
+    return {};
+  }
+}
+
+// core-auth/dist/log.js
+var START_TIME = (/* @__PURE__ */ new Date()).toISOString().replace(/:/g, "-").split(".")[0];
+function log(message) {
+  if (readConfig().logging === false)
+    return;
+  try {
+    const dateStr = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+    const dir = join3(getConfigDir(), "logs", dateStr);
+    if (!existsSync3(dir))
+      mkdirSync2(dir, { recursive: true });
+    appendFileSync(join3(dir, "core-auth-" + START_TIME + ".log"), "[" + (/* @__PURE__ */ new Date()).toISOString() + "] " + message + "\n");
+  } catch {
+  }
+}
+
+// core-auth/dist/opencode.js
+function opencodeConfigPath() {
+  const override = (process.env.OPENCODE_CONFIG || "").trim();
+  if (override)
+    return resolve(override);
+  const base = process.env.XDG_CONFIG_HOME || join4(homedir2(), ".config");
+  const dir = join4(base, "opencode");
+  const jsonc = join4(dir, "opencode.jsonc");
+  const json = join4(dir, "opencode.json");
+  return existsSync4(jsonc) ? jsonc : json;
+}
+function stripJsonc(text) {
+  return text.replace(/\\"|"(?:\\"|[^"])*"|(\/\/.*|\/\*[\s\S]*?\*\/)/g, (match, group) => group ? "" : match).replace(/,(\s*[}\]])/g, "$1");
+}
+function mergeModels(opencodeProvider, models, npm) {
+  const path = opencodeConfigPath();
+  let config = {};
+  try {
+    if (existsSync4(path))
+      config = JSON.parse(stripJsonc(readFileSync2(path, "utf8")));
+  } catch {
+  }
+  if (!config.$schema)
+    config.$schema = "https://opencode.ai/config.json";
+  config.provider = config.provider || {};
+  config.provider[opencodeProvider] = config.provider[opencodeProvider] || {};
+  if (npm)
+    config.provider[opencodeProvider].npm = npm;
+  const existing = config.provider[opencodeProvider].models || {};
+  config.provider[opencodeProvider].models = { ...existing, ...models };
+  try {
+    if (!existsSync4(dirname(path)))
+      mkdirSync3(dirname(path), { recursive: true });
+    writeFileSync2(path, JSON.stringify(config, null, 2), "utf8");
+  } catch (e) {
+    log("opencode model merge failed: " + (e && e.message));
+  }
+}
+function createOpencodePlugin(def) {
+  const opencodeProvider = def.opencodeProvider || "anthropic";
+  return async function() {
+    try {
+      mergeModels(opencodeProvider, def.models || {}, def.opencodeNpm);
+    } catch {
+    }
+    return {
+      auth: {
+        provider: opencodeProvider,
+        methods: [{ label: def.label + " (via core-auth)", type: "api" }],
+        loader: async function() {
+          return {
+            apiKey: def.id,
+            fetch: function(input, init) {
+              return def.handle(new Request(input, init), { configDir: getConfigDir(), log });
+            }
+          };
+        }
+      }
+    };
+  };
+}
+
+// core-auth/dist/provider.js
+function defineProvider(def) {
+  return {
+    def,
+    handle: (request, ctx) => def.handle(request, ctx || { configDir: getConfigDir(), log }),
+    opencode: createOpencodePlugin(def)
+  };
+}
+
+// src/driver.ts
+var STUB_TEXT = "Hello from stub-auth \u2014 the core-auth pipeline works end to end.";
+function stubText(model) {
+  return STUB_TEXT + " (served by " + model + ")";
+}
+function jsonBody(model) {
+  return {
+    id: "msg_stub_0001",
+    type: "message",
+    role: "assistant",
+    model,
+    content: [{ type: "text", text: stubText(model) }],
+    stop_reason: "end_turn",
+    stop_sequence: null,
+    usage: { input_tokens: 1, output_tokens: 12 }
+  };
+}
+function sse(event, data) {
+  return "event: " + event + "\ndata: " + JSON.stringify(data) + "\n\n";
+}
+function streamBody(model) {
+  const msg = { id: "msg_stub_0001", type: "message", role: "assistant", model, content: [], stop_reason: null, stop_sequence: null, usage: { input_tokens: 1, output_tokens: 0 } };
+  return sse("message_start", { type: "message_start", message: msg }) + sse("content_block_start", { type: "content_block_start", index: 0, content_block: { type: "text", text: "" } }) + sse("content_block_delta", { type: "content_block_delta", index: 0, delta: { type: "text_delta", text: stubText(model) } }) + sse("content_block_stop", { type: "content_block_stop", index: 0 }) + sse("message_delta", { type: "message_delta", delta: { stop_reason: "end_turn", stop_sequence: null }, usage: { output_tokens: 12 } }) + sse("message_stop", { type: "message_stop" });
+}
+var driver = {
+  id: "stub",
+  label: "Stub",
+  opencodeProvider: "stub",
+  opencodeNpm: "@ai-sdk/anthropic",
+  // a few models so the Claude model-mapping is demonstrable
+  models: {
+    "stub-model": { name: "Stub Default" },
+    "stub-pro": { name: "Stub Pro" },
+    "stub-fast": { name: "Stub Fast" }
+  },
+  async handle(request, ctx) {
+    let body = {};
+    try {
+      body = await request.clone().json();
+    } catch {
+    }
+    const model = ctx && ctx.model || body.model || "stub-model";
+    if (body.stream) {
+      return new Response(streamBody(model), { status: 200, headers: { "content-type": "text/event-stream" } });
+    }
+    return new Response(JSON.stringify(jsonBody(model)), { status: 200, headers: { "content-type": "application/json" } });
+  }
+};
+
+// src/index.ts
+var StubProvider = defineProvider(driver).opencode;
+export {
+  StubProvider
+};

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "stub-auth",
+  "version": "0.1.0",
+  "description": "Stub AI provider driver for core-auth — canned responses to validate the auth pipeline; the reference example for building provider plugins.",
+  "main": "dist/index.js",
+  "type": "module",
+  "license": "MIT",
+  "author": "intisy",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/intisy/stub-auth.git"
+  },
+  "keywords": ["core-auth", "provider", "stub", "auth", "example"],
+  "files": ["dist/", "README.md", "LICENSE"],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "claudeHub": {
+    "authProviders": [
+      {
+        "name": "stub",
+        "handler": "dist/handler.js",
+        "models": [
+          { "id": "stub-model", "name": "Stub Default" },
+          { "id": "stub-pro", "name": "Stub Pro" },
+          { "id": "stub-fast", "name": "Stub Fast" }
+        ]
+      }
+    ]
+  },
+  "scripts": {
+    "build": "npx tsc --project core-auth/tsconfig.json && npx esbuild src/index.ts --bundle --platform=node --format=esm --outfile=dist/index.js && npx esbuild src/handler.ts --bundle --platform=node --format=esm --outfile=dist/handler.js",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.14",
+    "@types/node": "^25.9.1",
+    "esbuild": "^0.25.0",
+    "typescript": "^6.0.3"
+  }
+}