backprompter-server-sdk 0.1.0

package/README.md

@@ -0,0 +1,36 @@
+# Backprompter Server SDK
+
+Node.js SDK for server-to-server calls to Backprompter using API keys.
+
+## Install
+
+```bash
+npm install backprompter-server-sdk
+```
+
+## Quick Start
+
+```js
+import BackprompterServer from 'backprompter-server-sdk';
+
+const bp = new BackprompterServer({
+  apiKey: process.env.BACKPROMPTER_API_KEY,
+  tenantId: process.env.BACKPROMPTER_APP_KEY,
+  backendUrl: process.env.BACKPROMPTER_BACKEND_URL
+});
+
+const result = await bp.run({
+  agentId: 'your-agent-name',
+  userPrompt: 'Summarize this support ticket.',
+  conversationHistory: [],
+  profileString: 'Enterprise customer'
+});
+
+console.log(result.response);
+```
+
+## Notes
+
+- Requires Node.js 18+ (uses built-in fetch).
+- Uses `x-bp-api-key` authentication.
+- `tenantId` can be passed in constructor or per-call (`run({ tenantId })`).

package/index.js

@@ -0,0 +1,131 @@
+const DEFAULT_BACKEND_URL = 'https://backprompter-us-628834831216.us-central1.run.app';
+const LOCAL_BACKEND_URL = 'http://localhost:8080';
+
+function normalizeBackendUrl(url) {
+  const raw = String(url || '').trim();
+  return raw ? raw.replace(/\/+$/, '') : '';
+}
+
+function assertFetchAvailable() {
+  if (typeof fetch !== 'function') {
+    throw new Error('BackprompterServer: fetch is not available. Use Node 18+ runtime.');
+  }
+}
+
+function getErrorMessage(status, payload) {
+  if (payload && typeof payload === 'object') {
+    if (typeof payload.error === 'string' && payload.error.trim()) return payload.error;
+    if (typeof payload.message === 'string' && payload.message.trim()) return payload.message;
+  }
+  return `HTTP ${status}`;
+}
+
+export default class BackprompterServer {
+  constructor({ apiKey, tenantId, backendUrl } = {}) {
+    this._apiKey = apiKey ? String(apiKey).trim() : '';
+    this._tenantId = tenantId ? String(tenantId).trim() : '';
+    this._backendUrl = normalizeBackendUrl(backendUrl || DEFAULT_BACKEND_URL);
+    if (!this._backendUrl) throw new Error('BackprompterServer: backendUrl cannot be empty.');
+  }
+
+  static get DEFAULT_BACKEND_URL() {
+    return DEFAULT_BACKEND_URL;
+  }
+
+  static get LOCAL_BACKEND_URL() {
+    return LOCAL_BACKEND_URL;
+  }
+
+  setApiKey(apiKey) {
+    this._apiKey = String(apiKey || '').trim();
+    return this._apiKey;
+  }
+
+  setTenantId(tenantId) {
+    this._tenantId = String(tenantId || '').trim();
+    return this._tenantId;
+  }
+
+  setBackendUrl(url) {
+    const normalized = normalizeBackendUrl(url);
+    if (!normalized) throw new Error('BackprompterServer: backendUrl cannot be empty.');
+    this._backendUrl = normalized;
+    return this._backendUrl;
+  }
+
+  setEnvironment(env) {
+    const normalizedEnv = String(env || '').trim().toLowerCase();
+    if (normalizedEnv === 'local') return this.setBackendUrl(LOCAL_BACKEND_URL);
+    if (normalizedEnv === 'production' || normalizedEnv === 'prod') return this.setBackendUrl(DEFAULT_BACKEND_URL);
+    throw new Error("BackprompterServer: setEnvironment expects 'local' or 'production'.");
+  }
+
+  getBackendUrl() {
+    return this._backendUrl;
+  }
+
+  async run({
+    userPrompt,
+    agentId,
+    conversationHistory = [],
+    profileString = '',
+    fileInputs = [],
+    urlInputs = [],
+    contextLimit,
+    maxTokens,
+    genDiff,
+    baseText,
+    ragCharBudget,
+    tenantId,
+    apiKey
+  } = {}) {
+    const resolvedApiKey = String(apiKey || this._apiKey || '').trim();
+    if (!resolvedApiKey) throw new Error('BackprompterServer: apiKey is required.');
+    if (!userPrompt) throw new Error('BackprompterServer: userPrompt is required.');
+
+    const resolvedTenantId = tenantId || this._tenantId || undefined;
+    const body = {
+      tenant_id: resolvedTenantId,
+      agent_id: agentId,
+      user_prompt: userPrompt,
+      conversation_history: Array.isArray(conversationHistory) ? conversationHistory : [],
+      profileString: String(profileString || ''),
+      file_inputs: Array.isArray(fileInputs) ? fileInputs : [],
+      url_inputs: Array.isArray(urlInputs) ? urlInputs : []
+    };
+
+    if (contextLimit !== undefined) body.context_limit = contextLimit;
+    if (maxTokens !== undefined) body.max_tokens = maxTokens;
+    if (genDiff !== undefined) body.gen_diff = genDiff;
+    if (baseText !== undefined) body.base_text = baseText;
+    if (ragCharBudget !== undefined) body.rag_char_budget = ragCharBudget;
+
+    return this._apiFetchWithApiKey('/public/run', resolvedApiKey, {
+      method: 'POST',
+      body: JSON.stringify(body)
+    });
+  }
+
+  async _apiFetchWithApiKey(path, apiKey, options = {}) {
+    assertFetchAvailable();
+
+    const base = this._backendUrl;
+    const requestPath = String(path || '').startsWith('/') ? String(path || '') : `/${String(path || '')}`;
+    const url = `${base}${requestPath}`;
+
+    const response = await fetch(url, {
+      ...options,
+      headers: {
+        'Content-Type': 'application/json',
+        'x-bp-api-key': apiKey,
+        ...(options.headers || {})
+      }
+    });
+
+    const payload = await response.json().catch(() => ({}));
+    if (!response.ok) {
+      throw new Error(getErrorMessage(response.status, payload));
+    }
+    return payload;
+  }
+}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "backprompter-server-sdk",
+  "version": "0.1.0",
+  "description": "Backprompter server-side SDK for Node.js backends",
+  "type": "module",
+  "main": "index.js",
+  "exports": {
+    ".": "./index.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "backprompter",
+    "sdk",
+    "server",
+    "node"
+  ],
+  "license": "MIT"
+}