/* Copyright 2026 Marimo. All rights reserved. */
import { invariant } from "./invariant";
import { Logger } from "./Logger";

/**
 * Type-safe exhaustiveness check for discriminated unions.
 */
export function assertNever(x: never): never {
  invariant(false, `Unexpected object: ${x}`);
}

/**
 * Like assertNever, but logs the unexpected object to the console.
 * Useful for exhaustiveness checks but without throwing an error.
 */
export function logNever(x: never): void {
  Logger.warn(`Unexpected object: ${JSON.stringify(x)}`);
  // oxlint-ignore-next-line -- noVoidTypeReturn: function returns void but value is needed for exhaustiveness
  return x;
}