@cerbos/core/src/internal.ts

Common types used by the Cerbos client libraries

import type { DescMethod } from "@bufbuild/protobuf";

export {
  auditTrailFromProtobuf,
  checkInputFromProtobuf,
  checkOutputFromProtobuf,
  planResourcesInputFromProtobuf,
  planResourcesOutputFromProtobuf,
  policyFromProtobuf,
  requestContextFromProtobuf,
  requireField,
  translateEnum,
  unexpected,
  valuesFromProtobuf,
} from "./convert/fromProtobuf.js";
export { policyToProtobuf, valuesToProtobuf } from "./convert/toProtobuf.js";
export * from "./errors/internal.js";
export type { ErrorDetails } from "./errors/response.js";
export { AbstractErrorResponse } from "./errors/response.js";
export * from "./transport.js";

/** @inline */
export type Optional<T> = { [K in keyof T]?: T[K] | undefined };

/** @internal */
export function cancelBody(response: Response): void {
  response.body?.cancel().catch(() => {
    // ignore failure to cancel
  });
}

/** @internal */
export function isObject(value: unknown): value is Record<string, unknown> {
  return typeof value === "object" && value !== null && !Array.isArray(value);
}

/** @internal */
export function methodName(method: DescMethod): string {
  return `${method.parent.typeName}/${method.name}`;
}

/** @internal */
export function userAgent(
  customUserAgent: string | undefined,
  defaultUserAgent: string,
): string {
  if (!customUserAgent) {
    return defaultUserAgent;
  }

  return `${customUserAgent} ${defaultUserAgent}`;
}