@acarmisc/backstage-plugin-litellm-backend 0.28.0 → 0.30.0

package/dist/keySnippets.d.ts

@@ -0,0 +1,8 @@
+/** Starter-snippet tabs the key dialog can show, in default order. */
+export declare const KEY_SNIPPET_TABS: readonly ["office365", "opencode", "claude-code", "pi", "openai", "curl"];
+export type KeySnippetTab = (typeof KEY_SNIPPET_TABS)[number];
+/**
+ * Reads litellm.display.keySnippets. Omitted means every tab in default order.
+ * Throws at startup on an empty, unknown or duplicated list so a typo fails loudly.
+ */
+export declare function parseKeySnippetTabs(raw: string[] | undefined): KeySnippetTab[];

package/dist/keySnippets.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KEY_SNIPPET_TABS = void 0;
+exports.parseKeySnippetTabs = parseKeySnippetTabs;
+/** Starter-snippet tabs the key dialog can show, in default order. */
+exports.KEY_SNIPPET_TABS = ['office365', 'opencode', 'claude-code', 'pi', 'openai', 'curl'];
+/**
+ * Reads litellm.display.keySnippets. Omitted means every tab in default order.
+ * Throws at startup on an empty, unknown or duplicated list so a typo fails loudly.
+ */
+function parseKeySnippetTabs(raw) {
+    if (raw === undefined)
+        return [...exports.KEY_SNIPPET_TABS];
+    if (raw.length === 0) {
+        throw new Error('litellm.display.keySnippets must list at least one tab');
+    }
+    const allowed = exports.KEY_SNIPPET_TABS;
+    const unknown = raw.filter(tab => !allowed.includes(tab));
+    if (unknown.length > 0) {
+        throw new Error(`litellm.display.keySnippets: unknown tab(s) ${unknown.join(', ')}. Allowed: ${exports.KEY_SNIPPET_TABS.join(', ')}`);
+    }
+    if (new Set(raw).size !== raw.length) {
+        throw new Error('litellm.display.keySnippets lists a tab more than once');
+    }
+    return raw;
+}

package/dist/openapi.js

@@ -69,6 +69,8 @@ exports.openApiSpec = {
                                         display: { type: 'object', properties: {
                                                 hideTeamBudgetForMembers: { type: 'boolean' },
                                                 hideTeamBudgetForManagers: { type: 'boolean' },
+                                                serviceKeyPrefixes: { type: 'array', items: { type: 'string' } },
+                                                keySnippets: { type: 'array', items: { type: 'string', enum: ['office365', 'opencode', 'claude-code', 'pi', 'openai', 'curl'] } },
                                             } },
                                     } } } },
                     },

package/dist/router.js

@@ -42,6 +42,7 @@ const catalog_client_1 = require("@backstage/catalog-client");
 const client_1 = require("./client");
 const provisioning_1 = require("./provisioning");
 Object.defineProperty(exports, "ProvisioningError", { enumerable: true, get: function () { return provisioning_1.ProvisioningError; } });
+const keySnippets_1 = require("./keySnippets");
 const backstage_plugin_litellm_common_1 = require("@acarmisc/backstage-plugin-litellm-common");
 const teamAdmin_1 = require("./teamAdmin");
 const teamBudgetVisibility_1 = require("./teamBudgetVisibility");
@@ -71,6 +72,12 @@ async function createRouter(options) {
     const publicBaseUrl = config.getOptionalString('litellm.publicBaseUrl') ?? null;
     // Support contact for unprovisioned users (optional).
     const supportContact = config.getOptionalString('litellm.supportContact');
+    // Alias prefixes of system/service keys the frontend hides by default.
+    const serviceKeyPrefixes = (config.getOptionalStringArray('litellm.display.serviceKeyPrefixes') ?? [])
+        .map(p => p.trim())
+        .filter(p => p.length > 0);
+    // Starter-snippet tabs shown after key generation, in order (display-only).
+    const keySnippets = (0, keySnippets_1.parseKeySnippetTabs)(config.getOptionalStringArray('litellm.display.keySnippets'));
     const baseClient = options.client ?? new client_1.LiteLLMClient({ baseUrl, masterKey });
     // Wrap client with userInfoCache. TTL is configurable (default 10s, 0 disables).
     const userInfoCacheTtlSeconds = config.getOptionalNumber('litellm.cache.userInfoTtlSeconds') ?? 10;
@@ -134,6 +141,8 @@ async function createRouter(options) {
         baseUrl,
         publicBaseUrl,
         supportContact,
+        serviceKeyPrefixes,
+        keySnippets,
         userIdDomain,
         provisioningEnabled,
         provisioningDefaults,

package/dist/routes/config.js

@@ -35,6 +35,8 @@ function registerConfigRoutes(router, ctx) {
             display: {
                 hideTeamBudgetForMembers: ctx.teamBudgetVisibility.hideTeamBudgetForMembers,
                 hideTeamBudgetForManagers: ctx.teamBudgetVisibility.hideTeamBudgetForManagers,
+                serviceKeyPrefixes: ctx.serviceKeyPrefixes,
+                keySnippets: ctx.keySnippets,
             },
         });
     });

package/dist/routes/context.d.ts

@@ -5,6 +5,7 @@ import { CatalogClient } from '@backstage/catalog-client';
 import { LiteLLMClient } from '../client';
 import { ProvisioningDefaults, RoleConfig, VirtualKey, TeamInfo } from '../types';
 import { TeamAdminConfig } from '../teamAdmin';
+import type { KeySnippetTab } from '../keySnippets';
 import type { KeyValidationConfig } from '@acarmisc/backstage-plugin-litellm-common';
 import { TeamBudgetVisibility } from '../teamBudgetVisibility';
 import { OpencodeConfig } from '../opencode';
@@ -23,6 +24,10 @@ export interface RouterContext {
     baseUrl: string;
     publicBaseUrl: string | null;
     supportContact: string | undefined;
+    /** Key-alias prefixes treated as service keys by the frontend (display-only). */
+    serviceKeyPrefixes: string[];
+    /** Starter-snippet tabs the key dialog shows, in order (display-only). */
+    keySnippets: KeySnippetTab[];
     userIdDomain: string | undefined;
     provisioningEnabled: boolean;
     provisioningDefaults: ProvisioningDefaults;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acarmisc/backstage-plugin-litellm-backend",
-  "version": "0.28.0",
+  "version": "0.30.0",
   "description": "The Backstage backend plugin for LiteLLM governance",
   "backstage": {
     "role": "backend-plugin",