async-exit-hook 2.0.1: forceExitTimeout, hookEvent, hookedEvents

Clean-room public code sample — generation instructions

Write a brand-new, minimal, self-contained code sample in this clean-room directory.
Do not copy, paraphrase, or reference any existing project source. Work only from this spec.

A csx.json manifest scaffold already exists. Do not recreate it from memory. Preserve its case.goal, packages and symbols; fill its empty case.contract with exact assertions and correct its environment, commands and verifierAdapter for the files you generate.

Goal: verify pkg:npm/async-exit-hook@2.0.1
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/async-exit-hook@2.0.1
Demonstrate these symbols/APIs:
  - forceExitTimeout
  - hookEvent
  - hookedEvents
  - uncaughtExceptionHandler

Rules:
  - One focused purpose; the smallest project that proves the goal.
  - Include a contract test (test/contract.*) that runs OFFLINE and exits 0 exactly when the goal behavior works.
  - Pin every dependency with a lockfile so resolution is reproducible.
  - No secrets, credentials, or tokens. No real URLs (only example.com or localhost). No absolute paths.
  - No personal names, emails, company names, or project identifiers of any kind.
  - No binaries and no generated output (node_modules, dist, target, venv, .git, .env).
  - Keep it under 200 files and 256KB packed.

{"case":{"caseId":"case:sha256:e314d3357a1d4d0c938ceeb67d71dd1ad309c2e92074d7d9577bcd560ebfef00","contract":["exitHook registers exit handlers and initializes standard process event hooks","hookEvent and unhookEvent dynamically manage custom process lifecycle events","hookedEvents returns a list of all currently registered process event names","uncaughtExceptionHandler registers error handlers for uncaught exceptions","unhandledRejectionHandler registers error handlers for unhandled promise rejections","forceExitTimeout configures timeout duration for asynchronous exit handlers"],"goal":"verify pkg:npm/async-exit-hook@2.0.1","kind":"HOW","packages":["pkg:npm/async-exit-hook@2.0.1"],"schemaVersion":1,"symbols":["forceExitTimeout","hookEvent","hookedEvents","uncaughtExceptionHandler"]},"contractCommand":["node","test/contract.mjs"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"npm","libc":"glibc","libcVersion":"2.39","os":"linux","osVersionBucket":"24","packageManager":"npm","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/async-exit-hook@2.0.1"],"schemaVersion":1,"subject":"pkg:npm/async-exit-hook@2.0.1","symbols":["forceExitTimeout","hookEvent","hookedEvents","uncaughtExceptionHandler"],"verifierAdapter":"node-typescript@1"}

{
  "name": "sample-async-exit-hook",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-async-exit-hook",
      "version": "1.0.0",
      "dependencies": {
        "async-exit-hook": "2.0.1"
      }
    },
    "node_modules/async-exit-hook": {
      "version": "2.0.1",
      "resolved": "https://registry.npmjs.org/async-exit-hook/-/async-exit-hook-2.0.1.tgz",
      "integrity": "sha512-NW2cX8m1Q7KPA7a5M2ULQeZ2wR5qI5PAbw5L0UOMxdioVk9PMZ0h1TmyZEkPYrCvYjDlFICusOu1dlEKAAeXBw==",
      "license": "MIT",
      "engines": {
        "node": ">=0.12.0"
      }
    }
  }
}

{
  "name": "sample-async-exit-hook",
  "version": "1.0.0",
  "type": "module",
  "private": true,
  "dependencies": {
    "async-exit-hook": "2.0.1"
  }
}

{
  "schemaVersion": 1,
  "goal": "verify pkg:npm/async-exit-hook@2.0.1",
  "kind": "HOW",
  "packages": [
    "pkg:npm/async-exit-hook@2.0.1"
  ],
  "symbols": [
    "forceExitTimeout",
    "hookEvent",
    "hookedEvents",
    "uncaughtExceptionHandler"
  ]
}

import assert from 'node:assert/strict';
import exitHook from 'async-exit-hook';

// 1. exitHook registers exit handlers and initializes standard process event hooks
{
  assert.equal(typeof exitHook, 'function');
  exitHook(() => {});
  const events = exitHook.hookedEvents();
  assert.equal(Array.isArray(events), true);
  assert.equal(events.includes('exit'), true);
  assert.equal(events.includes('beforeExit'), true);
  assert.equal(events.includes('SIGINT'), true);
  assert.equal(events.includes('SIGTERM'), true);
}

// 2. hookEvent and unhookEvent dynamically manage custom process lifecycle events
{
  const customEvent = 'customEventTest';
  assert.equal(exitHook.hookedEvents().includes(customEvent), false);
  exitHook.hookEvent(customEvent, 0);
  assert.equal(exitHook.hookedEvents().includes(customEvent), true);
  exitHook.unhookEvent(customEvent);
  assert.equal(exitHook.hookedEvents().includes(customEvent), false);
}

// 3. hookedEvents returns a list of all currently registered process event names
{
  const events = exitHook.hookedEvents();
  assert.equal(events.length >= 6, true);
  assert.equal(events.includes('SIGHUP'), true);
  assert.equal(events.includes('SIGBREAK'), true);
}

// 4. uncaughtExceptionHandler registers error handlers for uncaught exceptions
{
  assert.equal(typeof exitHook.uncaughtExceptionHandler, 'function');
  let errHookCalled = false;
  exitHook.uncaughtExceptionHandler((err) => {
    errHookCalled = true;
  });
  assert.equal(errHookCalled, false);
}

// 5. unhandledRejectionHandler registers error handlers for unhandled promise rejections
{
  assert.equal(typeof exitHook.unhandledRejectionHandler, 'function');
  let rejHookCalled = false;
  exitHook.unhandledRejectionHandler((err) => {
    rejHookCalled = true;
  });
  assert.equal(rejHookCalled, false);
}

// 6. forceExitTimeout configures timeout duration for asynchronous exit handlers
{
  assert.equal(typeof exitHook.forceExitTimeout, 'function');
  exitHook.forceExitTimeout(5000);
  exitHook.forceExitTimeout(10000);
}