@byfriends/oauth 0.1.0

package/LICENSE

@@ -0,0 +1,28 @@
+BYF PROPRIETARY LICENSE
+
+Copyright (c) 2026-2027 ByronFinn
+
+Permission is hereby granted to copy and redistribute this software in its
+unmodified form, without charge. This permission does not extend to modified
+versions of the software.
+
+Local modification of this software for personal use is permitted, provided
+that such modifications are not distributed to third parties.
+
+Restrictions:
+1. You may NOT redistribute modified versions of this software.
+2. You may NOT use this software for commercial purposes.
+3. You may NOT sublicense, sell, or offer this software as a service.
+
+This software is source-available but NOT open source. The source code is
+made publicly visible for review purposes only.
+
+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.
+
+For questions about licensing, contact: https://github.com/ByronFinn/byf/issues

package/README.md

@@ -0,0 +1,11 @@
+# @byfriends/oauth
+
+Authentication utilities for BYF.
+
+Part of the [BYF](https://github.com/ByronFinn/byf) monorepo.
+
+See the main repository for documentation, issues, and contribution guidelines.
+
+## License
+
+Proprietary — see the root LICENSE file.

package/dist/index.d.mts

@@ -0,0 +1,59 @@
+//#region src/provider-config.d.ts
+interface ModelInfo {
+  readonly id: string;
+  readonly contextLength: number;
+  readonly supportsReasoning: boolean;
+  readonly supportsReasoningEffort?: boolean | undefined;
+  readonly reasoningEffortKey?: string | undefined;
+  readonly supportsImageIn: boolean;
+  readonly supportsVideoIn: boolean;
+  readonly supportsToolUse?: boolean | undefined;
+  readonly displayName?: string | undefined;
+}
+interface ModelAlias {
+  provider: string;
+  model: string;
+  maxContextSize: number;
+  capabilities?: string[] | undefined;
+  displayName?: string | undefined;
+  readonly [key: string]: unknown;
+}
+interface ProviderConfig {
+  type: string;
+  baseUrl?: string | undefined;
+  apiKey?: string | undefined;
+  readonly [key: string]: unknown;
+}
+interface ServicesConfig {
+  readonly [key: string]: unknown;
+}
+interface ConfigShape {
+  providers: Record<string, ProviderConfig | Record<string, unknown>>;
+  models?: Record<string, ModelAlias | Record<string, unknown>> | undefined;
+  defaultModel?: string | undefined;
+  defaultThinking?: boolean | undefined;
+  services?: ServicesConfig | undefined;
+  [key: string]: unknown;
+}
+declare class ProviderApiError extends Error {
+  readonly status: number;
+  constructor(message: string, status: number);
+}
+declare function fetchModels(baseUrl: string, apiKey: string, fetchImpl?: typeof fetch, signal?: AbortSignal): Promise<ModelInfo[]>;
+declare function filterModelsByPrefix(models: ModelInfo[], prefixes?: readonly string[] | undefined): ModelInfo[];
+declare function capabilitiesForModel(model: ModelInfo): string[] | undefined;
+interface ApplyProviderResult {
+  readonly defaultModel: string;
+  readonly defaultThinking: boolean;
+}
+declare function applyProviderConfig(config: ConfigShape, options: {
+  readonly name: string;
+  readonly baseUrl: string;
+  readonly apiKey: string;
+  readonly models: readonly ModelInfo[];
+  readonly selectedModel: ModelInfo;
+  readonly thinking: boolean;
+}): ApplyProviderResult;
+declare function removeProviderConfig(config: ConfigShape, providerName: string): void;
+//#endregion
+export { type ApplyProviderResult, type ConfigShape, type ModelAlias, type ModelInfo, ProviderApiError, type ProviderConfig, type ServicesConfig, applyProviderConfig, capabilitiesForModel, fetchModels, filterModelsByPrefix, removeProviderConfig };

package/dist/index.mjs

@@ -0,0 +1,174 @@
+//#region src/utils.ts
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//#endregion
+//#region src/api-error.ts
+const DIRECT_ERROR_KEYS = [
+	"error_description",
+	"message",
+	"detail"
+];
+const NESTED_ERROR_KEYS = [
+	"message",
+	"error_description",
+	"detail",
+	"code",
+	"type"
+];
+function extractApiErrorMessage(value) {
+	if (Array.isArray(value)) {
+		for (const item of value) {
+			const message = extractApiErrorMessage(item);
+			if (message !== void 0) return message;
+		}
+		return;
+	}
+	if (!isRecord(value)) return void 0;
+	for (const key of DIRECT_ERROR_KEYS) {
+		const message = stringField(value, key);
+		if (message !== void 0) return message;
+	}
+	const error = value["error"];
+	const errorString = nonEmptyString(error);
+	if (errorString !== void 0) return errorString;
+	if (isRecord(error)) for (const key of NESTED_ERROR_KEYS) {
+		const message = stringField(error, key);
+		if (message !== void 0) return message;
+	}
+	const errors = value["errors"];
+	if (Array.isArray(errors)) for (const item of errors) {
+		const message = extractApiErrorMessage(item);
+		if (message !== void 0) return message;
+	}
+}
+async function readApiErrorMessage(response, fallback) {
+	let parsed;
+	try {
+		parsed = await response.json();
+	} catch {
+		return fallback;
+	}
+	return extractApiErrorMessage(parsed) ?? fallback;
+}
+function stringField(record, key) {
+	return nonEmptyString(record[key]);
+}
+function nonEmptyString(value) {
+	if (typeof value !== "string") return void 0;
+	const trimmed = value.trim();
+	return trimmed.length > 0 ? trimmed : void 0;
+}
+//#endregion
+//#region src/provider-config.ts
+var ProviderApiError = class extends Error {
+	status;
+	constructor(message, status) {
+		super(message);
+		this.status = status;
+	}
+};
+function toModelInfo(item) {
+	if (!isRecord(item) || typeof item["id"] !== "string" || item["id"].length === 0) return;
+	const rawContextLength = Number(item["context_length"]);
+	const contextLength = Number.isInteger(rawContextLength) && rawContextLength > 0 ? rawContextLength : 2e5;
+	const displayName = item["display_name"];
+	const normalizedDisplayName = typeof displayName === "string" && displayName.length > 0 ? displayName : void 0;
+	const supportsToolUse = Object.hasOwn(item, "supports_tool_use") ? Boolean(item["supports_tool_use"]) : true;
+	const reasoningEffortKey = firstNonEmptyString(item, [
+		"reasoning_effort_key",
+		"thinking_effort_key",
+		"reasoning_effort_param",
+		"thinking_effort_param"
+	]);
+	const supportsReasoningEffort = Object.hasOwn(item, "supports_reasoning_effort") ? Boolean(item["supports_reasoning_effort"]) : reasoningEffortKey !== void 0;
+	return {
+		id: item["id"],
+		contextLength,
+		supportsReasoning: Object.hasOwn(item, "supports_reasoning") ? Boolean(item["supports_reasoning"]) : true,
+		supportsReasoningEffort,
+		reasoningEffortKey,
+		supportsImageIn: Boolean(item["supports_image_in"]),
+		supportsVideoIn: Boolean(item["supports_video_in"]),
+		supportsToolUse,
+		displayName: normalizedDisplayName
+	};
+}
+function firstNonEmptyString(source, keys) {
+	for (const key of keys) {
+		const value = source[key];
+		if (typeof value !== "string") continue;
+		const normalized = value.trim();
+		if (normalized.length > 0) return normalized;
+	}
+}
+async function fetchModels(baseUrl, apiKey, fetchImpl = fetch, signal) {
+	const res = await fetchImpl(`${baseUrl.replace(/\/+$/, "")}/models`, {
+		headers: {
+			Authorization: `Bearer ${apiKey}`,
+			Accept: "application/json"
+		},
+		signal
+	});
+	if (!res.ok) throw new ProviderApiError(await readApiErrorMessage(res, `Failed to list models (HTTP ${res.status}).`), res.status);
+	const payload = await res.json();
+	if (!isRecord(payload) || !Array.isArray(payload["data"])) throw new Error(`Unexpected models response for ${baseUrl}.`);
+	return payload["data"].map((item) => toModelInfo(item)).filter((item) => item !== void 0);
+}
+function filterModelsByPrefix(models, prefixes) {
+	if (!prefixes || prefixes.length === 0) return models;
+	return models.filter((m) => prefixes.some((p) => m.id.startsWith(p)));
+}
+function capabilitiesForModel(model) {
+	const caps = /* @__PURE__ */ new Set();
+	if (model.supportsReasoning) caps.add("thinking");
+	if (model.supportsReasoningEffort === true) caps.add("thinking_effort");
+	if (model.supportsImageIn) caps.add("image_in");
+	if (model.supportsVideoIn) caps.add("video_in");
+	if (model.supportsToolUse ?? true) caps.add("tool_use");
+	return caps.size > 0 ? [...caps] : void 0;
+}
+function applyProviderConfig(config, options) {
+	const providerKey = options.name;
+	const modelKey = `${providerKey}/${options.selectedModel.id}`;
+	config.providers[providerKey] = {
+		type: "openai-completions",
+		baseUrl: options.baseUrl,
+		apiKey: options.apiKey,
+		thinkingEffortKey: options.selectedModel.reasoningEffortKey
+	};
+	const existingModels = config.models ?? {};
+	for (const [key, model] of Object.entries(existingModels)) if (isRecord(model) && model["provider"] === providerKey) delete existingModels[key];
+	for (const model of options.models) {
+		const aliasKey = `${providerKey}/${model.id}`;
+		existingModels[aliasKey] = {
+			provider: providerKey,
+			model: model.id,
+			maxContextSize: model.contextLength,
+			capabilities: capabilitiesForModel(model),
+			displayName: model.displayName
+		};
+	}
+	config.models = existingModels;
+	config.defaultModel = modelKey;
+	config.defaultThinking = options.thinking;
+	return {
+		defaultModel: modelKey,
+		defaultThinking: options.thinking
+	};
+}
+function removeProviderConfig(config, providerName) {
+	delete config.providers[providerName];
+	let removedDefault = false;
+	const existingModels = config.models ?? {};
+	for (const [key, model] of Object.entries(existingModels)) {
+		if (!isRecord(model) || model["provider"] !== providerName) continue;
+		delete existingModels[key];
+		if (config.defaultModel === key) removedDefault = true;
+	}
+	config.models = existingModels;
+	if (removedDefault) config.defaultModel = void 0;
+	if (config["defaultProvider"] === providerName) config["defaultProvider"] = void 0;
+}
+//#endregion
+export { ProviderApiError, applyProviderConfig, capabilitiesForModel, fetchModels, filterModelsByPrefix, removeProviderConfig };

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@byfriends/oauth",
+  "version": "0.1.0",
+  "description": "Custom OAuth provider configuration for BYF",
+  "license": "Proprietary",
+  "author": "ByronFinn",
+  "homepage": "https://github.com/ByronFinn/byf",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ByronFinn/byf.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ByronFinn/byf/issues"
+  },
+  "keywords": [
+    "byf",
+    "oauth",
+    "provider",
+    "custom-provider",
+    "model-config"
+  ],
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "imports": {
+    "#/*": [
+      "./src/*.ts",
+      "./src/*/index.ts"
+    ]
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "clean": "rm -rf dist"
+  }
+}