@9d9/pulsemcp-core

Core utilities for PulseMCP — a Model Context Protocol automation framework.

Install

npm install @9d9/pulsemcp-core

Usage

import { ok, err, retry, withTimeout, EventEmitter, createTask, DefaultLogger } from "@9d9/pulsemcp-core";

// Result pattern
const result = ok(42);
if (result.ok) console.log(result.value);

// Retry with exponential backoff
const data = await retry(() => fetchData(), { maxAttempts: 3 });

// Timeout wrapper
const response = await withTimeout(fetch(url), 5000);

// Event system
const emitter = new EventEmitter();
emitter.on("task:complete", (data) => console.log(data));
emitter.emit("task:complete", { id: "123" });

API

Result Helpers

• ok(value) — Create a success result
• err(code, message, details?) — Create an error result

Async Utilities

• sleep(ms) — Promise-based delay
• withTimeout(promise, ms) — Reject after timeout
• retry(fn, opts?) — Retry with exponential backoff

Task Management

• createTask(name, data?) — Create a new task with auto-generated ID
• generateId(prefix?) — Generate unique IDs

Events

• EventEmitter — Simple pub/sub with on(), off(), emit()

Logging

• DefaultLogger — Console logger with log levels (debug/info/warn/error)

Utilities

• validateNotNull(value, name) — Null check with descriptive error
• formatDuration(ms) — Human-readable duration string

License

MIT © 9d9 LLC