// Copyright 2017-2026 @pezkuwi/dev-test authors & contributors
// SPDX-License-Identifier: Apache-2.0

import { describe, it } from 'node:test';

import { enhanceObj } from '../util.js';

interface WrapOpts {
  only?: boolean;
  skip?: boolean;
  todo?: boolean;
}

type WrapFn = (name: string, options: { only?: boolean; skip?: boolean; timeout?: number; todo?: boolean; }, fn: () => void | Promise<void>) => void | Promise<void>;

type TestFn = (name: string, exec: () => void | Promise<void>, timeout?: number) => void;

export interface Describe extends TestFn {
  only: TestFn;
  skip: TestFn;
  todo: TestFn;
}

export interface It extends TestFn {
  only: TestFn;
  skip: TestFn;
  todo: TestFn;
}

const MINUTE = 60 * 1000;

/**
 * @internal
 *
 * Wraps either describe or it with relevant .only, .skip, .todo & .each helpers,
 * shimming it into a Jest-compatible environment.
 *
 * Describe and It have the same shape, so one return type serves both.
 */
function createWrapper (fn: WrapFn, defaultTimeout: number): Describe {
  const wrap = (opts: WrapOpts): TestFn => (name: string, exec: () => void | Promise<void>, timeout?: number) => fn(name, { ...opts, timeout: (timeout || defaultTimeout) }, exec) as unknown as void;

  // Ensure that we have consistent helpers on the function. These are not consistently
  // applied accross all node:test versions, latest has all, so always apply ours.
  // Instead of node:test options for e.g. timeout, we provide a Jest-compatible signature
  return enhanceObj(wrap({}), {
    only: wrap({ only: true }),
    skip: wrap({ skip: true }),
    todo: wrap({ todo: true })
  });
}

/**
 * This ensures that the describe and it functions match our actual usages.
 * This includes .only, .skip and .todo helpers (.each is not applied)
 **/
export function suite (): { describe: Describe; it: It } {
  return {
    describe: createWrapper(describe, 60 * MINUTE),
    it: createWrapper(it, 2 * MINUTE)
  };
}