promigence 0.1.0-beta.12

package/dist/sdk/caller.js

@@ -0,0 +1,47 @@
+export const CALLER_HEADER = "promigence-caller";
+export const CALLER_ENV = "PROMIGENCE_CALLER";
+export const CALLER_NAME_RE = /^[a-z0-9][a-z0-9._-]{0,31}$/;
+export const CALLER_VERSION_RE = /^[A-Za-z0-9.+_~-]{0,31}$/;
+export const RESERVED_CALLERS = [
+    "cli", "harbor", "inspect", "e2b-compat", "computesdk", "mcp",
+];
+let globalCaller;
+let defaultCaller;
+export function callerToken(name, version) {
+    const n = typeof name === "string" ? name.trim().toLowerCase() : "";
+    if (!CALLER_NAME_RE.test(n))
+        return undefined;
+    const v = typeof version === "string" ? version.trim() : "";
+    if (!v || !CALLER_VERSION_RE.test(v))
+        return n;
+    return `${n}/${v}`;
+}
+export function parseCallerToken(raw) {
+    if (typeof raw !== "string")
+        return undefined;
+    const t = raw.trim();
+    if (!t)
+        return undefined;
+    const slash = t.indexOf("/");
+    return slash < 0 ? callerToken(t) : callerToken(t.slice(0, slash), t.slice(slash + 1));
+}
+export function setCaller(name, version, options) {
+    const token = callerToken(name, version);
+    if (options?.default)
+        defaultCaller = token;
+    else
+        globalCaller = token;
+}
+export function getCaller() {
+    return globalCaller ?? parseCallerToken(process.env[CALLER_ENV]) ?? defaultCaller;
+}
+export function clearCaller() {
+    globalCaller = undefined;
+    defaultCaller = undefined;
+}
+export function resolveCaller(explicit) {
+    return parseCallerToken(explicit) ?? getCaller();
+}
+export function userAgentWithCaller(userAgent, caller) {
+    return caller ? `${userAgent} (${caller})` : userAgent;
+}