Function validateListRef

server/src/training-agent/task-handlers.ts:111–133

(ref: unknown, pathLabel: string)

const MAX_TOKEN_LEN = 4096;

function validateListRef(ref: unknown, pathLabel: string): { ref?: ListReference; error?: TaskError } {
  if (ref === undefined || ref === null) return {};
  if (typeof ref !== 'object' || Array.isArray(ref)) {
    return { error: { code: 'VALIDATION_ERROR', message: `${pathLabel}: must be an object with agent_url and list_id`, field: pathLabel } };
  }
  const r = ref as Record<string, unknown>;
  const agent_url = r.agent_url;
  const list_id = r.list_id;
  const auth_token = r.auth_token;
  if (typeof agent_url !== 'string' || agent_url.length === 0 || agent_url.length > MAX_URL_LEN) {
    return { error: { code: 'VALIDATION_ERROR', message: `${pathLabel}.agent_url: must be a non-empty string up to ${MAX_URL_LEN} chars`, field: `${pathLabel}.agent_url` } };
  }
  if (!/^https?:\/\//i.test(agent_url)) {
    return { error: { code: 'VALIDATION_ERROR', message: `${pathLabel}.agent_url: must use http:// or https://`, field: `${pathLabel}.agent_url` } };
  }
  if (typeof list_id !== 'string' || list_id.length === 0 || list_id.length > MAX_ID_LEN) {
    return { error: { code: 'VALIDATION_ERROR', message: `${pathLabel}.list_id: must be a non-empty string up to ${MAX_ID_LEN} chars`, field: `${pathLabel}.list_id` } };
  }
  if (auth_token !== undefined && (typeof auth_token !== 'string' || auth_token.length > MAX_TOKEN_LEN)) {
    return { error: { code: 'VALIDATION_ERROR', message: `${pathLabel}.auth_token: must be a string up to ${MAX_TOKEN_LEN} chars`, field: `${pathLabel}.auth_token` } };
  }
  return { ref: { agent_url, list_id, ...(typeof auth_token === 'string' && { auth_token }) } };
}

function validateTargeting(t: unknown, pathLabel: string): { targeting?: PackageTargeting; errors: TaskError[] } {
  if (t === undefined || t === null) return { errors: [] };