{"record":{"id":"39d4834f6449144e","repo":"JuliusBrussee/caveman","slug":"name-must-be-an-absolute-http-s-url","errorCode":null,"errorMessage":"${name} must be an absolute http(s) URL","messagePattern":"(.+?) must be an absolute http\\(s\\) URL","errorType":"validation","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"packages/sdk/typescript/src/index.ts","lineNumber":341,"sourceCode":"export type OTelSpan = {\n  name: string;\n  traceId: string;\n  spanId: string;\n  parentSpanId: string;\n  kind: number;\n  startTimeNs: number;\n  endTimeNs: number;\n  statusCode: number; // 0=unset, 1=ok, 2=error\n  attributes: Record<string, string | number | boolean>;\n};\n\nfunction normalizedServiceURL(value: string, name: \"baseURL\" | \"controlURL\"): string {\n  if (value.trim() !== value) throw new Error(`${name} must not contain surrounding whitespace`);\n  let parsed: URL;\n  try {\n    parsed = new URL(value);\n  } catch {\n    throw new Error(`${name} must be an absolute http(s) URL`);\n  }\n  if ((parsed.protocol !== \"http:\" && parsed.protocol !== \"https:\") || !parsed.hostname || parsed.username || parsed.password) {\n    throw new Error(`${name} must be an absolute http(s) URL without credentials`);\n  }\n  if (parsed.search || parsed.hash) throw new Error(`${name} must not contain a query or fragment`);\n  return value.replace(/\\/+$/, \"\");\n}\n\nexport class Cave {\n  readonly options: CaveOptions;\n\n  constructor(options: CaveOptions) {\n    if (!options.apiKey || !options.baseURL || !options.agent) throw new Error(\"apiKey, baseURL, and agent are required\");\n    if (options.timeoutMs !== undefined && (!Number.isSafeInteger(options.timeoutMs) || options.timeoutMs <= 0)) {\n      throw new Error(\"timeoutMs must be a positive integer\");\n    }\n    // CAVE_WORKFLOW lets a wrapper (`cave wrap --workflow x`) label every request\n    // from an SDK app without a code change. An explicit option always wins.","sourceCodeStart":323,"sourceCodeEnd":359,"githubUrl":"https://github.com/JuliusBrussee/caveman/blob/27d5a3981a347890211bb1bf2439e5c821a63bc9/packages/sdk/typescript/src/index.ts#L323-L359","documentation":"Error \"${name} must be an absolute http(s) URL\" thrown in JuliusBrussee/caveman.","triggerScenarios":"Thrown at packages/sdk/typescript/src/index.ts:341 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Use an absolute http(s) URL for the named option."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"27d5a3981a347890211bb1bf2439e5c821a63bc9","analyzedAt":"2026-08-15T09:26:11.751Z","schemaVersion":2},"datasetVersion":"2026-08-15T17:31:12.345Z"}