p-map 7.1.1: pMapSettledKeyed

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 p-map.pMapSettledKeyed in pkg:npm/p-map@7.1.1
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/p-map@7.1.1
Demonstrate these symbols/APIs:
  - p-map.pMapSettledKeyed

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:8656a4ada89f81a529c6bb9b9a12e436c9fd8f17c37f2926022c79660862f283","contract":["pMapSettledKeyed(objectInput, mapper, { concurrency: 2 }) resolves to a null-prototype object mapping each kept key to { status: 'fulfilled', value } or { status: 'rejected', reason }","When an input entry promise rejects, pMapSettledKeyed records { status: 'rejected', reason } for that key without invoking mapper","Returning pMapSkip from mapper omits that key from the returned object without shifting subsequent keys","pMapSettledKeyed(mapInput, mapper, { concurrency: 1 }) returns a Map and stops at the first key returning pMapStop while preserving earlier settled entries","pMapSettledKeyed(null, mapper) rejects with TypeError"],"goal":"verify p-map.pMapSettledKeyed in pkg:npm/p-map@7.1.1","kind":"HOW","packages":["pkg:npm/p-map@7.1.1"],"schemaVersion":1,"symbols":["p-map.pMapSettledKeyed"]},"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/p-map@7.1.1"],"schemaVersion":1,"subject":"pkg:npm/p-map@7.1.1","symbols":["p-map.pMapSettledKeyed"],"verifierAdapter":"node-typescript@1"}

{
  "name": "p-map-settled-keyed-sample",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "p-map-settled-keyed-sample",
      "version": "1.0.0",
      "dependencies": {
        "p-map": "7.1.1"
      }
    },
    "node_modules/p-map": {
      "version": "7.1.1",
      "resolved": "https://registry.npmjs.org/p-map/-/p-map-7.1.1.tgz",
      "integrity": "sha512-6Lh3jQPLthYujSrlw6ccWXBGZTkoTCz27Hd92g79LH/kjAbgoEu0t442cCCNbegPSJsA0lwDX8z0bcKtkpA32g==",
      "license": "MIT",
      "engines": {
        "node": ">=18"
      },
      "funding": {
        "url": "https://github.com/sponsors/sindresorhus"
      }
    }
  }
}

{
  "name": "p-map-settled-keyed-sample",
  "version": "1.0.0",
  "private": true,
  "type": "module",
  "scripts": {
    "test": "node test/contract.mjs"
  },
  "dependencies": {
    "p-map": "7.1.1"
  }
}

{
  "schemaVersion": 1,
  "goal": "verify p-map.pMapSettledKeyed in pkg:npm/p-map@7.1.1",
  "kind": "HOW",
  "packages": [
    "pkg:npm/p-map@7.1.1"
  ],
  "symbols": [
    "p-map.pMapSettledKeyed"
  ]
}

import assert from 'node:assert/strict';
import { pMapSettledKeyed, pMapSkip, pMapStop } from 'p-map';

const mapperError = new Error('mapper failure');
const inputError = new Error('input rejection');

// 1. Plain object input: fulfilled, mapper error, rejected input promise, and pMapSkip
const objectInput = {
  ok: Promise.resolve(10),
  failMapper: 20,
  failInput: Promise.reject(inputError),
  skipMe: 30,
  afterSkip: 40,
};

const mappedKeys = [];
const objResult = await pMapSettledKeyed(
  objectInput,
  async (value, key) => {
    mappedKeys.push(key);
    if (key === 'failMapper') {
      throw mapperError;
    }
    if (key === 'skipMe') {
      return pMapSkip;
    }
    return `${key}:${value * 2}`;
  },
  { concurrency: 2 }
);

assert.equal(Object.getPrototypeOf(objResult), null);
assert.deepEqual(Object.keys(objResult), ['ok', 'failMapper', 'failInput', 'afterSkip']);
assert.equal('skipMe' in objResult, false);
assert.equal(mappedKeys.includes('failInput'), false);
assert.deepEqual(objResult.ok, { status: 'fulfilled', value: 'ok:20' });
assert.deepEqual(objResult.failMapper, { status: 'rejected', reason: mapperError });
assert.deepEqual(objResult.failInput, { status: 'rejected', reason: inputError });
assert.deepEqual(objResult.afterSkip, { status: 'fulfilled', value: 'afterSkip:80' });

// 2. Map input and pMapStop early termination
const mapInput = new Map([
  ['first', 1],
  ['second', 2],
  ['stopHere', 3],
  ['later', 4],
]);

const mapResult = await pMapSettledKeyed(
  mapInput,
  async (value, key) => {
    if (key === 'second') {
      throw mapperError;
    }
    if (key === 'stopHere') {
      return pMapStop;
    }
    return value * 10;
  },
  { concurrency: 1 }
);

assert.equal(mapResult instanceof Map, true);
assert.deepEqual([...mapResult.keys()], ['first', 'second']);
assert.deepEqual(mapResult.get('first'), { status: 'fulfilled', value: 10 });
assert.deepEqual(mapResult.get('second'), { status: 'rejected', reason: mapperError });
assert.equal(mapResult.has('stopHere'), false);
assert.equal(mapResult.has('later'), false);

// 3. Invalid input rejects with TypeError
await assert.rejects(
  () => pMapSettledKeyed(null, v => v),
  { name: 'TypeError' }
);