@adriangalilea/utils 0.4.1 → 0.6.0

package/dist/bot/kit.js

@@ -0,0 +1,52 @@
+import { Plugin } from 'gramio';
+import { kev } from '../platform/kev.js';
+export const gracefulStart = async (bot, opts = {}) => {
+    const log = opts.log === false ? () => { } : (opts.log ?? ((m) => console.log(m)));
+    const forceMs = opts.forceExitAfterMs ?? 10_000;
+    let stopping = false;
+    const stop = async (signal) => {
+        if (stopping)
+            return;
+        stopping = true;
+        log(`[bot] ${signal} received, shutting down…`);
+        const force = setTimeout(() => {
+            console.error(`[bot] forced exit after ${forceMs}ms`);
+            process.exit(1);
+        }, forceMs);
+        force.unref?.();
+        try {
+            await bot.stop();
+            await opts.onShutdown?.();
+            log('[bot] shutdown clean');
+        }
+        catch (e) {
+            console.error('[bot] shutdown error', e);
+        }
+        finally {
+            clearTimeout(force);
+            process.exit(opts.exitCode ?? 0);
+        }
+    };
+    process.on('SIGINT', () => void stop('SIGINT'));
+    process.on('SIGTERM', () => void stop('SIGTERM'));
+    await bot.start();
+};
+export const adminContext = (opts = {}) => {
+    // KEV resolves: process.env → .env (project + monorepo, auto-discovered) → fallback.
+    // Cached after first read. `kev.int` panics on non-int strings, so a malformed
+    // env var screams immediately rather than producing NaN downstream.
+    const adminId = kev.int('TELEGRAM_ADMIN_ID', opts.adminId ?? 0);
+    if (!adminId) {
+        throw new Error('adminContext: TELEGRAM_ADMIN_ID not set and no adminId fallback. ' +
+            'Get your Telegram id from @UserIDentifyBot.');
+    }
+    return new Plugin('@adriangalilea/utils/bot/admin')
+        .decorate({ adminId })
+        .derive((ctx) => ({
+        // `senderId` is provided by gramio's SenderMixin. It's `undefined` on
+        // service-style events without an actor; the strict equality below
+        // gives `false` in that case, which is the right answer.
+        isAdmin: 'senderId' in ctx && ctx.senderId === adminId,
+    }));
+};
+//# sourceMappingURL=kit.js.map

package/dist/bot/kit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kit.js","sourceRoot":"","sources":["../../src/bot/kit.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAA;AAexC,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAChC,GAAW,EACX,OAA6B,EAAE,EAChB,EAAE;IACjB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACjF,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,IAAI,MAAM,CAAA;IAE/C,IAAI,QAAQ,GAAG,KAAK,CAAA;IAEpB,MAAM,IAAI,GAAG,KAAK,EAAE,MAAc,EAAE,EAAE;QACpC,IAAI,QAAQ;YAAE,OAAM;QACpB,QAAQ,GAAG,IAAI,CAAA;QACf,GAAG,CAAC,SAAS,MAAM,2BAA2B,CAAC,CAAA;QAE/C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,OAAO,CAAC,KAAK,CAAC,2BAA2B,OAAO,IAAI,CAAC,CAAA;YACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC,EAAE,OAAO,CAAC,CAAA;QACX,KAAK,CAAC,KAAK,EAAE,EAAE,CAAA;QAEf,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;YAChB,MAAM,IAAI,CAAC,UAAU,EAAE,EAAE,CAAA;YACzB,GAAG,CAAC,sBAAsB,CAAC,CAAA;QAC7B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,CAAC,CAAC,CAAA;QAC1C,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAA;QAClC,CAAC;IACH,CAAC,CAAA;IAED,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC/C,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAA;IAEjD,MAAM,GAAG,CAAC,KAAK,EAAE,CAAA;AACnB,CAAC,CAAA;AASD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAA4B,EAAE,EAAE,EAAE;IAC7D,qFAAqF;IACrF,+EAA+E;IAC/E,oEAAoE;IACpE,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,mBAAmB,EAAE,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,CAAA;IAE/D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,mEAAmE;YACjE,6CAA6C,CAChD,CAAA;IACH,CAAC;IAED,OAAO,IAAI,MAAM,CAAC,gCAAgC,CAAC;SAChD,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;SACrB,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAChB,sEAAsE;QACtE,mEAAmE;QACnE,yDAAyD;QACzD,OAAO,EAAE,UAAU,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO;KACvD,CAAC,CAAC,CAAA;AACP,CAAC,CAAA"}

package/dist/bot/llm-stream.d.ts

@@ -0,0 +1,84 @@
+/**
+ * LLM streaming output for GramIO bots.
+ *
+ * Sends a placeholder, then debounces `editMessageText` calls as the
+ * LLM produces chunks. Markdown is parsed locally with
+ * `markdownToFormattable` — invalid markup degrades to plain text
+ * instead of failing (Telegram's `parse_mode` would reject the whole
+ * message). Splits at 4000 chars by promoting the next chunk to a
+ * fresh message at a paragraph/line/word boundary.
+ *
+ * Peer deps: `gramio`, `@gramio/format`, `marked`.
+ *
+ * @example
+ * import { Bot } from 'gramio'
+ * import { llmStream } from '@adriangalilea/utils/bot/llm-stream'
+ * import Anthropic from '@anthropic-ai/sdk'
+ *
+ * const claude = new Anthropic()
+ * const bot = new Bot(process.env.BOT_TOKEN!)
+ *   .extend(llmStream())
+ *   .on('message', async (ctx) => {
+ *     const stream = ctx.startStream()
+ *     const sse = await claude.messages.stream({
+ *       model: 'claude-opus-4-5',
+ *       max_tokens: 1024,
+ *       messages: [{ role: 'user', content: ctx.text ?? '' }],
+ *     })
+ *     for await (const chunk of sse) {
+ *       if (chunk.type === 'content_block_delta' && chunk.delta.type === 'text_delta') {
+ *         await stream.append(chunk.delta.text)
+ *       }
+ *     }
+ *     await stream.end()
+ *   })
+ *
+ * bot.start()
+ */
+import { Plugin } from 'gramio';
+export type StreamOptions = {
+    /** Debounce window between edits, in ms. Default 800. */
+    debounceMs?: number;
+    /** Initial placeholder shown until the first chunk arrives. Default "…". */
+    placeholder?: string;
+    /** Parse buffer as markdown. Default true. Set false for plain text streaming. */
+    markdown?: boolean;
+    /** Called on edit/send errors after internal recovery (rate limits, etc.). */
+    onError?: (err: unknown) => void;
+};
+export declare class MarkdownStreamer {
+    private buffer;
+    private currentMessageId?;
+    private firstSendPromise?;
+    private debounceTimer?;
+    private inFlight;
+    private dirty;
+    private ended;
+    private chatId;
+    private bot;
+    private opts;
+    constructor(ctx: {
+        chat: {
+            id: number;
+        };
+        bot: MarkdownStreamer['bot'];
+    }, opts: StreamOptions);
+    /** Append a chunk. Schedules a debounced edit. */
+    append(text: string): Promise<void>;
+    /** Flush any pending edit and close the stream. Idempotent. */
+    end(): Promise<void>;
+    private scheduleFlush;
+    private flushNow;
+}
+/**
+ * GramIO plugin. Adds `ctx.startStream(opts?)` on every message context.
+ *
+ * Defaults set here apply to every stream; per-call options in
+ * `ctx.startStream({...})` override them.
+ */
+export declare const llmStream: (defaults?: StreamOptions) => Plugin<{}, import("gramio").DeriveDefinitions & {
+    message: {
+        startStream: (opts?: StreamOptions) => MarkdownStreamer;
+    };
+}, {}>;
+//# sourceMappingURL=llm-stream.d.ts.map

package/dist/bot/llm-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-stream.d.ts","sourceRoot":"","sources":["../../src/bot/llm-stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAM/B,MAAM,MAAM,aAAa,GAAG;IAC1B,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAA;CACjC,CAAA;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,gBAAgB,CAAC,CAAQ;IACjC,OAAO,CAAC,gBAAgB,CAAC,CAAe;IACxC,OAAO,CAAC,aAAa,CAAC,CAA+B;IACrD,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,KAAK,CAAQ;IAErB,OAAO,CAAC,MAAM,CAAQ;IAItB,OAAO,CAAC,GAAG,CAYV;IACD,OAAO,CAAC,IAAI,CAAyB;gBAGnC,GAAG,EAAE;QAAE,IAAI,EAAE;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,GAAG,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAA;KAAE,EAC3D,IAAI,EAAE,aAAa;IAYrB,kDAAkD;IAC5C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8CzC,+DAA+D;IACzD,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAW1B,OAAO,CAAC,aAAa;YAaP,QAAQ;CAmCvB;AAED;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,WAAU,aAAkB;;6BAI9B,aAAa;;MAEhC,CAAA"}

package/dist/bot/llm-stream.js

@@ -0,0 +1,201 @@
+/**
+ * LLM streaming output for GramIO bots.
+ *
+ * Sends a placeholder, then debounces `editMessageText` calls as the
+ * LLM produces chunks. Markdown is parsed locally with
+ * `markdownToFormattable` — invalid markup degrades to plain text
+ * instead of failing (Telegram's `parse_mode` would reject the whole
+ * message). Splits at 4000 chars by promoting the next chunk to a
+ * fresh message at a paragraph/line/word boundary.
+ *
+ * Peer deps: `gramio`, `@gramio/format`, `marked`.
+ *
+ * @example
+ * import { Bot } from 'gramio'
+ * import { llmStream } from '@adriangalilea/utils/bot/llm-stream'
+ * import Anthropic from '@anthropic-ai/sdk'
+ *
+ * const claude = new Anthropic()
+ * const bot = new Bot(process.env.BOT_TOKEN!)
+ *   .extend(llmStream())
+ *   .on('message', async (ctx) => {
+ *     const stream = ctx.startStream()
+ *     const sse = await claude.messages.stream({
+ *       model: 'claude-opus-4-5',
+ *       max_tokens: 1024,
+ *       messages: [{ role: 'user', content: ctx.text ?? '' }],
+ *     })
+ *     for await (const chunk of sse) {
+ *       if (chunk.type === 'content_block_delta' && chunk.delta.type === 'text_delta') {
+ *         await stream.append(chunk.delta.text)
+ *       }
+ *     }
+ *     await stream.end()
+ *   })
+ *
+ * bot.start()
+ */
+import { Plugin } from 'gramio';
+import { markdownToFormattable } from '@gramio/format/markdown';
+const MAX_LEN = 4000; // Telegram caps at 4096; leave headroom for entity offsets
+const DEFAULT_DEBOUNCE_MS = 800;
+export class MarkdownStreamer {
+    buffer = '';
+    currentMessageId;
+    firstSendPromise;
+    debounceTimer;
+    inFlight = false;
+    dirty = false;
+    ended = false;
+    chatId;
+    // Match gramio's `bot.api` shape structurally. `text` accepts string or any
+    // `Formattable` (from `@gramio/format`) — both stringify safely. We don't
+    // import gramio's full Bot type to keep the streamer testable in isolation.
+    bot;
+    opts;
+    constructor(ctx, opts) {
+        this.chatId = ctx.chat.id;
+        this.bot = ctx.bot;
+        this.opts = {
+            debounceMs: opts.debounceMs ?? DEFAULT_DEBOUNCE_MS,
+            placeholder: opts.placeholder ?? '…',
+            markdown: opts.markdown ?? true,
+            onError: opts.onError ?? ((e) => console.error('[llm-stream]', e)),
+        };
+    }
+    /** Append a chunk. Schedules a debounced edit. */
+    async append(text) {
+        if (this.ended)
+            throw new Error('stream already ended');
+        if (!text)
+            return;
+        // first chunk: send the placeholder so we have a message_id to edit.
+        // Serialized via firstSendPromise so concurrent appends don't double-send.
+        if (this.currentMessageId === undefined && !this.firstSendPromise) {
+            this.firstSendPromise = (async () => {
+                const sent = await this.bot.api.sendMessage({
+                    chat_id: this.chatId,
+                    text: this.opts.placeholder,
+                });
+                this.currentMessageId = sent.message_id;
+            })();
+        }
+        if (this.firstSendPromise)
+            await this.firstSendPromise;
+        // overflow: freeze current message at last good split, start a new one.
+        const next = this.buffer + text;
+        if (next.length > MAX_LEN) {
+            const splitAt = findSplit(next, MAX_LEN);
+            const head = next.slice(0, splitAt);
+            const tail = next.slice(splitAt).trimStart();
+            this.buffer = head;
+            this.dirty = true;
+            await this.flushNow(); // commits head into current message
+            this.buffer = '';
+            this.currentMessageId = undefined;
+            this.firstSendPromise = undefined;
+            this.dirty = false;
+            if (this.debounceTimer) {
+                clearTimeout(this.debounceTimer);
+                this.debounceTimer = undefined;
+            }
+            if (tail)
+                await this.append(tail);
+            return;
+        }
+        this.buffer = next;
+        this.dirty = true;
+        this.scheduleFlush();
+    }
+    /** Flush any pending edit and close the stream. Idempotent. */
+    async end() {
+        if (this.ended)
+            return;
+        this.ended = true;
+        if (this.debounceTimer) {
+            clearTimeout(this.debounceTimer);
+            this.debounceTimer = undefined;
+        }
+        while (this.inFlight)
+            await sleep(50);
+        if (this.dirty)
+            await this.flushNow();
+    }
+    scheduleFlush() {
+        if (this.debounceTimer)
+            return;
+        this.debounceTimer = setTimeout(async () => {
+            this.debounceTimer = undefined;
+            if (this.inFlight) {
+                this.scheduleFlush();
+                return;
+            }
+            await this.flushNow();
+            if (this.dirty && !this.ended)
+                this.scheduleFlush();
+        }, this.opts.debounceMs);
+    }
+    async flushNow() {
+        if (!this.dirty)
+            return;
+        if (this.currentMessageId === undefined) {
+            // No active message yet — likely the first send is still in flight
+            // or the recovery path cleared it. Caller's next append() will
+            // re-create one.
+            return;
+        }
+        this.inFlight = true;
+        this.dirty = false;
+        const snapshot = this.buffer;
+        try {
+            const payload = this.opts.markdown ? markdownToFormattable(snapshot) : snapshot;
+            await this.bot.api.editMessageText({
+                chat_id: this.chatId,
+                message_id: this.currentMessageId,
+                text: payload,
+            });
+        }
+        catch (e) {
+            const msg = String(e?.message ?? e);
+            if (msg.includes('message is not modified')) {
+                // identical content — fine
+            }
+            else if (msg.includes('message to edit not found')) {
+                // message gone (deleted by user, etc.) — restart with a fresh send
+                this.currentMessageId = undefined;
+                this.firstSendPromise = undefined;
+                this.dirty = true;
+            }
+            else {
+                this.dirty = true;
+                this.opts.onError(e);
+            }
+        }
+        finally {
+            this.inFlight = false;
+        }
+    }
+}
+/**
+ * GramIO plugin. Adds `ctx.startStream(opts?)` on every message context.
+ *
+ * Defaults set here apply to every stream; per-call options in
+ * `ctx.startStream({...})` override them.
+ */
+export const llmStream = (defaults = {}) => new Plugin('@adriangalilea/utils/bot/llm-stream').derive('message', (ctx) => ({
+    // gramio's `message` scope guarantees `ctx.chat`. `ctx.bot.api` is on
+    // every Context. Structural compat → no cast needed.
+    startStream: (opts = {}) => new MarkdownStreamer(ctx, { ...defaults, ...opts }),
+}));
+function findSplit(text, maxLen) {
+    // Prefer paragraph break, then line, then space. Reject splits in the
+    // first half — better to truncate at maxLen than to leave a stub.
+    for (const sep of ['\n\n', '\n', ' ']) {
+        const idx = text.lastIndexOf(sep, maxLen);
+        if (idx > maxLen / 2)
+            return idx;
+    }
+    return maxLen;
+}
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+//# sourceMappingURL=llm-stream.js.map

package/dist/bot/llm-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-stream.js","sourceRoot":"","sources":["../../src/bot/llm-stream.ts"],"names":[],"mappings":"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"}

package/dist/offensive.d.ts

@@ -1,29 +1,31 @@
 /**
- * OFFENSIVE PROGRAMMING PRIMITIVES
+ * Offensive programming primitives + typed boundary errors.
  *
- * "A confused program SHOULD scream" - John Carmack
+ * "A confused program SHOULD scream." — John Carmack
  *
  * Throw, always. An uncaught Panic crashes the process with a full stack trace.
  * Zero dependencies. Works identically in Node, Deno, Bun, and browsers.
  *
- * Four primitives:
- *   assert(cond, ...msg)   - invariant checking, narrows types
- *   panic(...msg)          - impossible state reached
- *   must(() => expr)       - unwrap-or-die for operations (sync + async)
- *   unwrap(value, ...msg)  - unwrap nullable values
+ * Fail-fast primitives (throw Panic — bugs in us):
+ *   assert(cond, ...msg)          invariant checking, narrows types via `asserts`
+ *   panic(...msg)                 impossible state reached
+ *   assertNever(value, ...msg)    exhaustiveness check — compile error on missed cases
+ *   must(() => expr)              unwrap-or-die for operations (sync + async)
+ *   unwrap(value, ...msg)         unwrap nullable T | null | undefined → T
  *
- * must() replaces the old try/catch/check pattern:
+ * Typed boundary errors (throw SourcedError — the external system failed):
+ *   SourcedError                  typed error with source/operation/status/context
+ *   isSourcedError(e, source?)    type guard for catch-site narrowing
  *
- *   // before: 5 lines
- *   try {
- *     const data = readFileSync(path, 'utf-8')
- *     return data
- *   } catch (err) {
- *     check(err)
- *   }
+ * Panics are bugs. SourcedErrors are boundary failures. Keep them separate at
+ * catch boundaries:
  *
- *   // after: 1 line
- *   return must(() => readFileSync(path, 'utf-8'))
+ *   try { await doWork() }
+ *   catch (e) {
+ *     if (e instanceof Panic) throw e            // bug in us — crash
+ *     if (isSourcedError(e, 'stripe')) { ... }   // stripe failed — handle
+ *     throw e                                    // unknown — re-throw
+ *   }
  */
 /**
  * Distinct error class for offensive programming failures.
@@ -61,6 +63,23 @@ export declare function assert(condition: boolean, ...msg: any[]): asserts condi
  * }
  */
 export declare function panic(...msg: any[]): never;
+/**
+ * Exhaustiveness check — compile error if a switch/if misses a case.
+ * The `never` type means TS won't let you call this if all cases are handled.
+ * Add a new variant to a union → every assertNever site lights up at compile time.
+ *
+ * @example
+ * type Event = { kind: 'click' } | { kind: 'hover' } | { kind: 'scroll' }
+ * function handle(e: Event) {
+ *   switch (e.kind) {
+ *     case 'click': return handleClick()
+ *     case 'hover': return handleHover()
+ *     // forgot 'scroll' → TS error: Argument of type '{ kind: "scroll" }' not assignable to 'never'
+ *     default: assertNever(e)
+ *   }
+ * }
+ */
+export declare function assertNever(value: never, ...msg: any[]): never;
 /**
  * Must unwraps an operation that should never fail. Handles sync and async.
  *
@@ -85,11 +104,64 @@ export declare function must<T>(fn: () => T): T;
  * const el = unwrap(document.getElementById('app'))
  */
 export declare function unwrap<T>(value: T | null | undefined, ...msg: any[]): T;
+/**
+ * Typed error from a named external source with structured context.
+ *
+ * Raise at boundaries with the messy world (HTTP APIs, databases, external
+ * processes). Every SourcedError carries enough context to reconstruct the
+ * failure without a debugger.
+ *
+ * @example
+ * try {
+ *   return await stripe.charges.create({ customer, amount })
+ * } catch (e) {
+ *   throw new SourcedError({
+ *     source: 'stripe',
+ *     operation: 'charge_customer',
+ *     message: e instanceof Error ? e.message : String(e),
+ *     status: (e as any)?.statusCode,
+ *     cause: e,
+ *     context: { customer, amount },
+ *   })
+ * }
+ */
+export declare class SourcedError<S extends string = string> extends Error {
+    readonly source: S;
+    readonly operation: string;
+    readonly status?: number;
+    readonly context: Record<string, unknown>;
+    constructor(args: {
+        source: S;
+        operation: string;
+        message: string;
+        status?: number;
+        cause?: unknown;
+        context?: Record<string, unknown>;
+    });
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Type guard for SourcedError. Optionally narrows to a specific source.
+ *
+ * @example
+ * try { await charge(customer, amount) }
+ * catch (e) {
+ *   if (isSourcedError(e, 'stripe') && e.status === 402) {
+ *     // TS knows e.source === 'stripe' here
+ *     return 'card declined'
+ *   }
+ *   throw e
+ * }
+ */
+export declare function isSourcedError<S extends string>(e: unknown, source?: S): e is SourcedError<S>;
 export declare const offensive: {
     Panic: typeof Panic;
     assert: typeof assert;
     panic: typeof panic;
+    assertNever: typeof assertNever;
     must: typeof must;
     unwrap: typeof unwrap;
+    SourcedError: typeof SourcedError;
+    isSourcedError: typeof isSourcedError;
 };
 //# sourceMappingURL=offensive.d.ts.map

package/dist/offensive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"offensive.d.ts","sourceRoot":"","sources":["../src/offensive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH;;;;;;;;;;;;;GAaG;AACH,qBAAa,KAAM,SAAQ,KAAK;gBAClB,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,CAE3E;AAED;;;;;;;;;GASG;AACH,wBAAgB,KAAK,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,CAE1C;AAED;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;AACzD,wBAAgB,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAA;AAevC;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAGvE;AAED,eAAO,MAAM,SAAS;;;;;;CAMrB,CAAA"}
+{"version":3,"file":"offensive.d.ts","sourceRoot":"","sources":["../src/offensive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH;;;;;;;;;;;;;GAaG;AACH,qBAAa,KAAM,SAAQ,KAAK;gBAClB,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,CAE3E;AAED;;;;;;;;;GASG;AACH,wBAAgB,KAAK,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,CAE1C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,CAE9D;AAED;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;AACzD,wBAAgB,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAA;AAevC;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAGvE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,KAAK;IAChE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;IAClB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;gBAE7B,IAAI,EAAE;QAChB,MAAM,EAAE,CAAC,CAAA;QACT,SAAS,EAAE,MAAM,CAAA;QACjB,OAAO,EAAE,MAAM,CAAA;QACf,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAClC;IAUD,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAUlC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,CAE7F;AAED,eAAO,MAAM,SAAS;;;;;;;;;CASrB,CAAA"}

package/dist/offensive.js

@@ -1,29 +1,31 @@
 /**
- * OFFENSIVE PROGRAMMING PRIMITIVES
+ * Offensive programming primitives + typed boundary errors.
  *
- * "A confused program SHOULD scream" - John Carmack
+ * "A confused program SHOULD scream." — John Carmack
  *
  * Throw, always. An uncaught Panic crashes the process with a full stack trace.
  * Zero dependencies. Works identically in Node, Deno, Bun, and browsers.
  *
- * Four primitives:
- *   assert(cond, ...msg)   - invariant checking, narrows types
- *   panic(...msg)          - impossible state reached
- *   must(() => expr)       - unwrap-or-die for operations (sync + async)
- *   unwrap(value, ...msg)  - unwrap nullable values
+ * Fail-fast primitives (throw Panic — bugs in us):
+ *   assert(cond, ...msg)          invariant checking, narrows types via `asserts`
+ *   panic(...msg)                 impossible state reached
+ *   assertNever(value, ...msg)    exhaustiveness check — compile error on missed cases
+ *   must(() => expr)              unwrap-or-die for operations (sync + async)
+ *   unwrap(value, ...msg)         unwrap nullable T | null | undefined → T
  *
- * must() replaces the old try/catch/check pattern:
+ * Typed boundary errors (throw SourcedError — the external system failed):
+ *   SourcedError                  typed error with source/operation/status/context
+ *   isSourcedError(e, source?)    type guard for catch-site narrowing
  *
- *   // before: 5 lines
- *   try {
- *     const data = readFileSync(path, 'utf-8')
- *     return data
- *   } catch (err) {
- *     check(err)
- *   }
+ * Panics are bugs. SourcedErrors are boundary failures. Keep them separate at
+ * catch boundaries:
  *
- *   // after: 1 line
- *   return must(() => readFileSync(path, 'utf-8'))
+ *   try { await doWork() }
+ *   catch (e) {
+ *     if (e instanceof Panic) throw e            // bug in us — crash
+ *     if (isSourcedError(e, 'stripe')) { ... }   // stripe failed — handle
+ *     throw e                                    // unknown — re-throw
+ *   }
  */
 /**
  * Distinct error class for offensive programming failures.
@@ -69,6 +71,25 @@ export function assert(condition, ...msg) {
 export function panic(...msg) {
     throw new Panic(msg.join(' ') || 'panic');
 }
+/**
+ * Exhaustiveness check — compile error if a switch/if misses a case.
+ * The `never` type means TS won't let you call this if all cases are handled.
+ * Add a new variant to a union → every assertNever site lights up at compile time.
+ *
+ * @example
+ * type Event = { kind: 'click' } | { kind: 'hover' } | { kind: 'scroll' }
+ * function handle(e: Event) {
+ *   switch (e.kind) {
+ *     case 'click': return handleClick()
+ *     case 'hover': return handleHover()
+ *     // forgot 'scroll' → TS error: Argument of type '{ kind: "scroll" }' not assignable to 'never'
+ *     default: assertNever(e)
+ *   }
+ * }
+ */
+export function assertNever(value, ...msg) {
+    throw new Panic(msg.join(' ') || `assertNever: unexpected value: ${JSON.stringify(value)}`);
+}
 export function must(fn) {
     try {
         const result = fn();
@@ -101,11 +122,76 @@ export function unwrap(value, ...msg) {
         throw new Panic(msg.join(' ') || `unwrap: got ${value}`);
     return value;
 }
+/**
+ * Typed error from a named external source with structured context.
+ *
+ * Raise at boundaries with the messy world (HTTP APIs, databases, external
+ * processes). Every SourcedError carries enough context to reconstruct the
+ * failure without a debugger.
+ *
+ * @example
+ * try {
+ *   return await stripe.charges.create({ customer, amount })
+ * } catch (e) {
+ *   throw new SourcedError({
+ *     source: 'stripe',
+ *     operation: 'charge_customer',
+ *     message: e instanceof Error ? e.message : String(e),
+ *     status: (e as any)?.statusCode,
+ *     cause: e,
+ *     context: { customer, amount },
+ *   })
+ * }
+ */
+export class SourcedError extends Error {
+    source;
+    operation;
+    status;
+    context;
+    constructor(args) {
+        const status = args.status != null ? ` status=${args.status}` : '';
+        super(`[${args.source}:${args.operation}${status}] ${args.message}`, { cause: args.cause });
+        this.name = 'SourcedError';
+        this.source = args.source;
+        this.operation = args.operation;
+        this.status = args.status;
+        this.context = args.context ?? {};
+    }
+    toJSON() {
+        return {
+            source: this.source,
+            operation: this.operation,
+            status: this.status,
+            message: this.message,
+            context: this.context,
+            cause: this.cause instanceof Error ? this.cause.message : this.cause != null ? String(this.cause) : null,
+        };
+    }
+}
+/**
+ * Type guard for SourcedError. Optionally narrows to a specific source.
+ *
+ * @example
+ * try { await charge(customer, amount) }
+ * catch (e) {
+ *   if (isSourcedError(e, 'stripe') && e.status === 402) {
+ *     // TS knows e.source === 'stripe' here
+ *     return 'card declined'
+ *   }
+ *   throw e
+ * }
+ */
+export function isSourcedError(e, source) {
+    return e instanceof SourcedError && (source === undefined || e.source === source);
+}
 export const offensive = {
     Panic,
     assert,
     panic,
+    assertNever,
     must,
     unwrap,
+    SourcedError,
+    isSourcedError,
 };
 //# sourceMappingURL=offensive.js.map

package/dist/offensive.js.map

@@ -1 +1 @@
-{"version":3,"file":"offensive.js","sourceRoot":"","sources":["../src/offensive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,KAAM,SAAQ,KAAK;IAC9B,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,OAAO,CAAA;IACrB,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,UAAU,MAAM,CAAC,SAAkB,EAAE,GAAG,GAAU;IACtD,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,CAAA;AACtE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,KAAK,CAAC,GAAG,GAAU;IACjC,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,CAAA;AAC3C,CAAC;AAYD,MAAM,UAAU,IAAI,CAAI,EAAwB;IAC9C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,EAAE,EAAE,CAAA;QACnB,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;YAC9B,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;gBACtB,MAAM,IAAI,KAAK,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;YAC7D,CAAC,CAAC,CAAA;QACJ,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;IAC7D,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,MAAM,CAAI,KAA2B,EAAE,GAAG,GAAU;IAClE,IAAI,KAAK,IAAI,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,eAAe,KAAK,EAAE,CAAC,CAAA;IAC3E,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,KAAK;IACL,MAAM;IACN,KAAK;IACL,IAAI;IACJ,MAAM;CACP,CAAA"}
+{"version":3,"file":"offensive.js","sourceRoot":"","sources":["../src/offensive.ts"],"names":[],"mappings":"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"}