@nkootstra/block-kit 0.0.1 → 0.1.0

package/dist/transport.d.ts

@@ -0,0 +1,50 @@
+
+import { N as BlockKitProviderProps, ht as ViewResponseAction } from "./index-BV_5_J_Q.js";
+//#region src/interactivity/transport.d.ts
+export interface InteractionResult {
+  ok: boolean;
+  status: number;
+  /** Parsed `response_action` body, when the app replied with one (view_submission acks). */
+  responseAction?: ViewResponseAction;
+  /** The raw parsed (or, if not JSON, raw text) response body. */
+  raw?: unknown;
+}
+/** Encodes a payload the way Slack does: `application/x-www-form-urlencoded` `payload=<json>`. */
+export declare function encodeInteraction(payload: unknown): string;
+/** Reads an app's reply to an interaction: JSON when it parses, text otherwise. */
+export declare function readInteractionResponse(res: Response): Promise<InteractionResult>;
+/** Thrown by `onSubmit`/`onOptions` when the app couldn't be reached or didn't answer 2xx. */
+export declare class InteractionError extends Error {
+  readonly result?: InteractionResult | undefined;
+  constructor(message: string, result?: InteractionResult | undefined);
+}
+export interface HttpTransportOptions {
+  /**
+   * Where payloads are POSTed, in Slack's wire format but unsigned: a relay made with
+   * `createInteractionRelay` (which signs and forwards them), or an app that doesn't verify
+   * signatures (e.g. Bolt with `signatureVerification: false`).
+   */
+  url: string;
+  headers?: HeadersInit;
+  /** Injectable for tests; defaults to the global `fetch`. */
+  fetch?: typeof fetch;
+  /** Called with every payload sent and the app's reply. */
+  onResponse?: (payload: unknown, result: InteractionResult) => void;
+  /** Called when a payload couldn't be delivered or the app answered with a non-2xx status. */
+  onError?: (payload: unknown, error: InteractionError) => void;
+}
+/** The `BlockKitProvider` callbacks that deliver interactions, ready to spread onto it. */
+export type InteractionTransport = Required<Pick<BlockKitProviderProps, "onPayload" | "onSubmit" | "onClose" | "onOptions">>;
+/**
+ * Sends every interaction a `BlockKitProvider` produces to an app over HTTP, in place of the
+ * local handlers: `block_actions` and `view_closed` are fire-and-forget, a `view_submission`'s
+ * `response_action` ack is applied to the modal, and a `block_suggestion`'s reply fills the
+ * external select.
+ *
+ * ```tsx
+ * <BlockKitProvider {...httpTransport({ url: "/slack/relay" })}>
+ * ```
+ */
+export declare function httpTransport(options: HttpTransportOptions): InteractionTransport;
+//#endregion
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.js

@@ -0,0 +1,84 @@
+
+//#region src/interactivity/transport.ts
+/** Encodes a payload the way Slack does: `application/x-www-form-urlencoded` `payload=<json>`. */
+function encodeInteraction(payload) {
+	return `payload=${encodeURIComponent(JSON.stringify(payload))}`;
+}
+/** Reads an app's reply to an interaction: JSON when it parses, text otherwise. */
+async function readInteractionResponse(res) {
+	const text = await res.text();
+	let raw;
+	if (text) try {
+		raw = JSON.parse(text);
+	} catch {
+		raw = text;
+	}
+	return {
+		ok: res.ok,
+		status: res.status,
+		responseAction: isViewResponseAction(raw) ? raw : void 0,
+		raw
+	};
+}
+function isViewResponseAction(value) {
+	return typeof value === "object" && value !== null && "response_action" in value && typeof value.response_action === "string";
+}
+/** Thrown by `onSubmit`/`onOptions` when the app couldn't be reached or didn't answer 2xx. */
+var InteractionError = class extends Error {
+	result;
+	constructor(message, result) {
+		super(message);
+		this.result = result;
+		this.name = "InteractionError";
+	}
+};
+/**
+* Sends every interaction a `BlockKitProvider` produces to an app over HTTP, in place of the
+* local handlers: `block_actions` and `view_closed` are fire-and-forget, a `view_submission`'s
+* `response_action` ack is applied to the modal, and a `block_suggestion`'s reply fills the
+* external select.
+*
+* ```tsx
+* <BlockKitProvider {...httpTransport({ url: "/slack/relay" })}>
+* ```
+*/
+function httpTransport(options) {
+	const send = async (payload) => {
+		const doFetch = options.fetch ?? fetch;
+		let result;
+		try {
+			result = await readInteractionResponse(await doFetch(options.url, {
+				method: "POST",
+				headers: {
+					"content-type": "application/x-www-form-urlencoded",
+					...Object.fromEntries(new Headers(options.headers))
+				},
+				body: encodeInteraction(payload)
+			}));
+		} catch (cause) {
+			const error = new InteractionError(`Couldn't reach ${options.url}: ${cause instanceof Error ? cause.message : String(cause)}`);
+			options.onError?.(payload, error);
+			throw error;
+		}
+		options.onResponse?.(payload, result);
+		if (!result.ok) {
+			const error = new InteractionError(`${options.url} answered ${result.status}`, result);
+			options.onError?.(payload, error);
+			throw error;
+		}
+		return result;
+	};
+	const fireAndForget = (payload) => {
+		send(payload).catch(() => {});
+	};
+	return {
+		onPayload: fireAndForget,
+		onClose: fireAndForget,
+		onSubmit: async (payload) => (await send(payload)).responseAction,
+		onOptions: async (payload) => (await send(payload)).raw
+	};
+}
+//#endregion
+export { InteractionError, encodeInteraction, httpTransport, readInteractionResponse };
+
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","names":[],"sources":["../src/interactivity/transport.ts"],"sourcesContent":["import type { BlockKitProviderProps, OptionsResponse, ViewResponseAction } from \"../index\";\n\n// Browser-safe: no Node imports here, so `@nkootstra/block-kit/transport` can be\n// bundled into a page. Signing lives in `sign.ts`/`relay.ts`, which only run on a server.\n\nexport interface InteractionResult {\n  ok: boolean;\n  status: number;\n  /** Parsed `response_action` body, when the app replied with one (view_submission acks). */\n  responseAction?: ViewResponseAction;\n  /** The raw parsed (or, if not JSON, raw text) response body. */\n  raw?: unknown;\n}\n\n/** Encodes a payload the way Slack does: `application/x-www-form-urlencoded` `payload=<json>`. */\nexport function encodeInteraction(payload: unknown): string {\n  return `payload=${encodeURIComponent(JSON.stringify(payload))}`;\n}\n\n/** Reads an app's reply to an interaction: JSON when it parses, text otherwise. */\nexport async function readInteractionResponse(res: Response): Promise<InteractionResult> {\n  const text = await res.text();\n  let raw: unknown;\n  if (text) {\n    try {\n      raw = JSON.parse(text);\n    } catch {\n      raw = text;\n    }\n  }\n  return {\n    ok: res.ok,\n    status: res.status,\n    responseAction: isViewResponseAction(raw) ? raw : undefined,\n    raw,\n  };\n}\n\nfunction isViewResponseAction(value: unknown): value is ViewResponseAction {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"response_action\" in value &&\n    typeof (value as { response_action: unknown }).response_action === \"string\"\n  );\n}\n\n/** Thrown by `onSubmit`/`onOptions` when the app couldn't be reached or didn't answer 2xx. */\nexport class InteractionError extends Error {\n  constructor(\n    message: string,\n    readonly result?: InteractionResult,\n  ) {\n    super(message);\n    this.name = \"InteractionError\";\n  }\n}\n\nexport interface HttpTransportOptions {\n  /**\n   * Where payloads are POSTed, in Slack's wire format but unsigned: a relay made with\n   * `createInteractionRelay` (which signs and forwards them), or an app that doesn't verify\n   * signatures (e.g. Bolt with `signatureVerification: false`).\n   */\n  url: string;\n  headers?: HeadersInit;\n  /** Injectable for tests; defaults to the global `fetch`. */\n  fetch?: typeof fetch;\n  /** Called with every payload sent and the app's reply. */\n  onResponse?: (payload: unknown, result: InteractionResult) => void;\n  /** Called when a payload couldn't be delivered or the app answered with a non-2xx status. */\n  onError?: (payload: unknown, error: InteractionError) => void;\n}\n\n/** The `BlockKitProvider` callbacks that deliver interactions, ready to spread onto it. */\nexport type InteractionTransport = Required<\n  Pick<BlockKitProviderProps, \"onPayload\" | \"onSubmit\" | \"onClose\" | \"onOptions\">\n>;\n\n/**\n * Sends every interaction a `BlockKitProvider` produces to an app over HTTP, in place of the\n * local handlers: `block_actions` and `view_closed` are fire-and-forget, a `view_submission`'s\n * `response_action` ack is applied to the modal, and a `block_suggestion`'s reply fills the\n * external select.\n *\n * ```tsx\n * <BlockKitProvider {...httpTransport({ url: \"/slack/relay\" })}>\n * ```\n */\nexport function httpTransport(options: HttpTransportOptions): InteractionTransport {\n  const send = async (payload: unknown): Promise<InteractionResult> => {\n    const doFetch = options.fetch ?? fetch;\n    let result: InteractionResult;\n    try {\n      result = await readInteractionResponse(\n        await doFetch(options.url, {\n          method: \"POST\",\n          headers: {\n            \"content-type\": \"application/x-www-form-urlencoded\",\n            ...Object.fromEntries(new Headers(options.headers)),\n          },\n          body: encodeInteraction(payload),\n        }),\n      );\n    } catch (cause) {\n      const error = new InteractionError(\n        `Couldn't reach ${options.url}: ${cause instanceof Error ? cause.message : String(cause)}`,\n      );\n      options.onError?.(payload, error);\n      throw error;\n    }\n    options.onResponse?.(payload, result);\n    if (!result.ok) {\n      const error = new InteractionError(`${options.url} answered ${result.status}`, result);\n      options.onError?.(payload, error);\n      throw error;\n    }\n    return result;\n  };\n  // Nothing awaits these; failures are reported through `onError` instead.\n  const fireAndForget = (payload: unknown) => {\n    send(payload).catch(() => {});\n  };\n\n  return {\n    onPayload: fireAndForget,\n    onClose: fireAndForget,\n    onSubmit: async (payload) => (await send(payload)).responseAction,\n    onOptions: async (payload) => (await send(payload)).raw as OptionsResponse,\n  };\n}\n"],"mappings":";;;AAeA,SAAgB,kBAAkB,SAA0B;CAC1D,OAAO,WAAW,mBAAmB,KAAK,UAAU,OAAO,CAAC;AAC9D;;AAGA,eAAsB,wBAAwB,KAA2C;CACvF,MAAM,OAAO,MAAM,IAAI,KAAK;CAC5B,IAAI;CACJ,IAAI,MACF,IAAI;EACF,MAAM,KAAK,MAAM,IAAI;CACvB,QAAQ;EACN,MAAM;CACR;CAEF,OAAO;EACL,IAAI,IAAI;EACR,QAAQ,IAAI;EACZ,gBAAgB,qBAAqB,GAAG,IAAI,MAAM,KAAA;EAClD;CACF;AACF;AAEA,SAAS,qBAAqB,OAA6C;CACzE,OACE,OAAO,UAAU,YACjB,UAAU,QACV,qBAAqB,SACrB,OAAQ,MAAuC,oBAAoB;AAEvE;;AAGA,IAAa,mBAAb,cAAsC,MAAM;CAG/B;CAFX,YACE,SACA,QACA;EACA,MAAM,OAAO;EAFJ,KAAA,SAAA;EAGT,KAAK,OAAO;CACd;AACF;;;;;;;;;;;AAiCA,SAAgB,cAAc,SAAqD;CACjF,MAAM,OAAO,OAAO,YAAiD;EACnE,MAAM,UAAU,QAAQ,SAAS;EACjC,IAAI;EACJ,IAAI;GACF,SAAS,MAAM,wBACb,MAAM,QAAQ,QAAQ,KAAK;IACzB,QAAQ;IACR,SAAS;KACP,gBAAgB;KAChB,GAAG,OAAO,YAAY,IAAI,QAAQ,QAAQ,OAAO,CAAC;IACpD;IACA,MAAM,kBAAkB,OAAO;GACjC,CAAC,CACH;EACF,SAAS,OAAO;GACd,MAAM,QAAQ,IAAI,iBAChB,kBAAkB,QAAQ,IAAI,IAAI,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GACzF;GACA,QAAQ,UAAU,SAAS,KAAK;GAChC,MAAM;EACR;EACA,QAAQ,aAAa,SAAS,MAAM;EACpC,IAAI,CAAC,OAAO,IAAI;GACd,MAAM,QAAQ,IAAI,iBAAiB,GAAG,QAAQ,IAAI,YAAY,OAAO,UAAU,MAAM;GACrF,QAAQ,UAAU,SAAS,KAAK;GAChC,MAAM;EACR;EACA,OAAO;CACT;CAEA,MAAM,iBAAiB,YAAqB;EAC1C,KAAK,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC;CAC9B;CAEA,OAAO;EACL,WAAW;EACX,SAAS;EACT,UAAU,OAAO,aAAa,MAAM,KAAK,OAAO,EAAA,CAAG;EACnD,WAAW,OAAO,aAAa,MAAM,KAAK,OAAO,EAAA,CAAG;CACtD;AACF"}

package/dist/web-api.d.ts

@@ -0,0 +1,45 @@
+
+import { z as Resolvers } from "./index-BV_5_J_Q.js";
+import { WebClient } from "@slack/web-api";
+//#region src/web-api/resolvers.d.ts
+interface WebApiResolversOptions {
+  /**
+   * Milliseconds to coalesce `user`/`channel` lookups requested in quick succession (e.g. every
+   * mention in a long message) before firing the batch of requests concurrently. Default 20.
+   */
+  batchWindowMs?: number;
+}
+interface WebApiResolvers extends Resolvers {
+  /**
+   * Registers a listener called whenever a previously-unresolved id finishes looking up (whether
+   * it resolved to a name or turned out to be unknown). Returns an unsubscribe function. Since the
+   * resolver functions themselves are synchronous, a consumer re-renders by subscribing and
+   * forcing an update — see `useWebApiResolvers`.
+   */
+  subscribe(listener: () => void): () => void;
+}
+/**
+ * Builds `Resolvers` (see `context.tsx`) backed by the real Slack Web API
+ * or an emulator's implementation of it: `users.info`, `conversations.info`, and `usergroups.list`
+ * for usergroups (there is no per-id usergroup lookup in the Web API, so the whole list is fetched
+ * once and cached).
+ *
+ * The resolver functions are synchronous — `(id) => string | undefined` — so a lookup that hasn't
+ * completed yet returns `undefined` immediately and schedules a background fetch; call `subscribe`
+ * (or the `useWebApiResolvers` hook) to be notified when it completes so the tree can re-render
+ * with the resolved name.
+ */
+export declare function createWebApiResolvers(client: WebClient, opts?: WebApiResolversOptions): WebApiResolvers;
+//#endregion
+//#region src/web-api/useWebApiResolvers.d.ts
+/**
+ * `createWebApiResolvers`, wired up to re-render the calling component whenever a lookup
+ * completes. Pass the returned resolvers straight to `<BlockKitProvider resolvers={...}>`.
+ *
+ * `opts` is only read when `client` (identity) changes, matching `createWebApiResolvers` being
+ * called once per client rather than on every render.
+ */
+export declare function useWebApiResolvers(client: WebClient, opts?: WebApiResolversOptions): WebApiResolvers;
+//#endregion
+export type { WebApiResolvers, WebApiResolversOptions };
+//# sourceMappingURL=web-api.d.ts.map

package/dist/web-api.js

@@ -0,0 +1,121 @@
+
+import { useEffect, useMemo, useState } from "react";
+//#region src/web-api/resolvers.ts
+/**
+* Builds `Resolvers` (see `context.tsx`) backed by the real Slack Web API
+* or an emulator's implementation of it: `users.info`, `conversations.info`, and `usergroups.list`
+* for usergroups (there is no per-id usergroup lookup in the Web API, so the whole list is fetched
+* once and cached).
+*
+* The resolver functions are synchronous — `(id) => string | undefined` — so a lookup that hasn't
+* completed yet returns `undefined` immediately and schedules a background fetch; call `subscribe`
+* (or the `useWebApiResolvers` hook) to be notified when it completes so the tree can re-render
+* with the resolved name.
+*/
+function createWebApiResolvers(client, opts = {}) {
+	const batchWindowMs = opts.batchWindowMs ?? 20;
+	const cache = /* @__PURE__ */ new Map();
+	const inflight = /* @__PURE__ */ new Set();
+	const queues = /* @__PURE__ */ new Map([["user", /* @__PURE__ */ new Set()], ["channel", /* @__PURE__ */ new Set()]]);
+	const timers = /* @__PURE__ */ new Map();
+	const listeners = /* @__PURE__ */ new Set();
+	let usergroupsLoaded = false;
+	let usergroupsLoading;
+	function notify() {
+		for (const listener of listeners) listener();
+	}
+	function cacheKey(kind, id) {
+		return `${kind}:${id}`;
+	}
+	function lookup(kind, id) {
+		const key = cacheKey(kind, id);
+		if (cache.has(key)) return cache.get(key) ?? void 0;
+		schedule(kind, id);
+	}
+	function schedule(kind, id) {
+		const key = cacheKey(kind, id);
+		if (inflight.has(key)) return;
+		inflight.add(key);
+		queues.get(kind)?.add(id);
+		if (!timers.has(kind)) timers.set(kind, setTimeout(() => {
+			timers.delete(kind);
+			flush(kind);
+		}, batchWindowMs));
+	}
+	async function flush(kind) {
+		const queue = queues.get(kind);
+		const ids = queue ? [...queue] : [];
+		queue?.clear();
+		await Promise.all(ids.map((id) => fetchOne(kind, id)));
+	}
+	async function fetchOne(kind, id) {
+		const key = cacheKey(kind, id);
+		try {
+			const name = kind === "user" ? await fetchUserName(id) : await fetchChannelName(id);
+			cache.set(key, name ?? null);
+		} catch {
+			cache.set(key, null);
+		} finally {
+			inflight.delete(key);
+			notify();
+		}
+	}
+	async function fetchUserName(id) {
+		const user = (await client.users.info({ user: id })).user;
+		return user?.profile?.display_name || user?.profile?.real_name || user?.real_name || user?.name || void 0;
+	}
+	async function fetchChannelName(id) {
+		const name = (await client.conversations.info({ channel: id })).channel?.name;
+		return name ? `#${name}` : void 0;
+	}
+	function loadUsergroups() {
+		if (usergroupsLoaded || usergroupsLoading) return;
+		usergroupsLoading = (async () => {
+			try {
+				const res = await client.usergroups.list({});
+				for (const group of res.usergroups ?? []) {
+					if (!group.id) continue;
+					const name = group.handle ? `@${group.handle}` : group.name ?? void 0;
+					cache.set(cacheKey("usergroup", group.id), name ?? null);
+				}
+			} catch {} finally {
+				usergroupsLoaded = true;
+				usergroupsLoading = void 0;
+				notify();
+			}
+		})();
+	}
+	function lookupUsergroup(id) {
+		const key = cacheKey("usergroup", id);
+		if (cache.has(key)) return cache.get(key) ?? void 0;
+		loadUsergroups();
+	}
+	return {
+		user: (id) => lookup("user", id),
+		channel: (id) => lookup("channel", id),
+		usergroup: (id) => lookupUsergroup(id),
+		subscribe(listener) {
+			listeners.add(listener);
+			return () => listeners.delete(listener);
+		}
+	};
+}
+//#endregion
+//#region src/web-api/useWebApiResolvers.ts
+/**
+* `createWebApiResolvers`, wired up to re-render the calling component whenever a lookup
+* completes. Pass the returned resolvers straight to `<BlockKitProvider resolvers={...}>`.
+*
+* `opts` is only read when `client` (identity) changes, matching `createWebApiResolvers` being
+* called once per client rather than on every render.
+*/
+function useWebApiResolvers(client, opts) {
+	const resolvers = useMemo(() => createWebApiResolvers(client, opts), [client]);
+	const [, forceUpdate] = useState(0);
+	useEffect(() => resolvers.subscribe(() => forceUpdate((v) => v + 1)), [resolvers]);
+	return resolvers;
+}
+//#endregion
+export { createWebApiResolvers, useWebApiResolvers };
+
+//# sourceMappingURL=web-api.js.map

package/dist/web-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-api.js","names":[],"sources":["../src/web-api/resolvers.ts","../src/web-api/useWebApiResolvers.ts"],"sourcesContent":["import type { WebClient } from \"@slack/web-api\";\nimport type { Resolvers } from \"../index\";\n\nexport interface WebApiResolversOptions {\n  /**\n   * Milliseconds to coalesce `user`/`channel` lookups requested in quick succession (e.g. every\n   * mention in a long message) before firing the batch of requests concurrently. Default 20.\n   */\n  batchWindowMs?: number;\n}\n\nexport interface WebApiResolvers extends Resolvers {\n  /**\n   * Registers a listener called whenever a previously-unresolved id finishes looking up (whether\n   * it resolved to a name or turned out to be unknown). Returns an unsubscribe function. Since the\n   * resolver functions themselves are synchronous, a consumer re-renders by subscribing and\n   * forcing an update — see `useWebApiResolvers`.\n   */\n  subscribe(listener: () => void): () => void;\n}\n\ntype Kind = \"user\" | \"channel\" | \"usergroup\";\n\n/**\n * Builds `Resolvers` (see `context.tsx`) backed by the real Slack Web API\n * or an emulator's implementation of it: `users.info`, `conversations.info`, and `usergroups.list`\n * for usergroups (there is no per-id usergroup lookup in the Web API, so the whole list is fetched\n * once and cached).\n *\n * The resolver functions are synchronous — `(id) => string | undefined` — so a lookup that hasn't\n * completed yet returns `undefined` immediately and schedules a background fetch; call `subscribe`\n * (or the `useWebApiResolvers` hook) to be notified when it completes so the tree can re-render\n * with the resolved name.\n */\nexport function createWebApiResolvers(\n  client: WebClient,\n  opts: WebApiResolversOptions = {},\n): WebApiResolvers {\n  const batchWindowMs = opts.batchWindowMs ?? 20;\n\n  // `undefined` = not yet looked up, `null` = looked up and unknown/failed, `string` = resolved.\n  const cache = new Map<string, string | null>();\n  const inflight = new Set<string>();\n  const queues = new Map<Kind, Set<string>>([\n    [\"user\", new Set()],\n    [\"channel\", new Set()],\n  ]);\n  const timers = new Map<Kind, ReturnType<typeof setTimeout>>();\n  const listeners = new Set<() => void>();\n\n  let usergroupsLoaded = false;\n  let usergroupsLoading: Promise<void> | undefined;\n\n  function notify() {\n    for (const listener of listeners) listener();\n  }\n\n  function cacheKey(kind: Kind, id: string) {\n    return `${kind}:${id}`;\n  }\n\n  function lookup(kind: \"user\" | \"channel\", id: string): string | undefined {\n    const key = cacheKey(kind, id);\n    if (cache.has(key)) return cache.get(key) ?? undefined;\n    schedule(kind, id);\n    return undefined;\n  }\n\n  function schedule(kind: \"user\" | \"channel\", id: string) {\n    const key = cacheKey(kind, id);\n    if (inflight.has(key)) return;\n    inflight.add(key);\n    const queue = queues.get(kind);\n    queue?.add(id);\n    if (!timers.has(kind)) {\n      timers.set(\n        kind,\n        setTimeout(() => {\n          timers.delete(kind);\n          void flush(kind);\n        }, batchWindowMs),\n      );\n    }\n  }\n\n  async function flush(kind: \"user\" | \"channel\") {\n    const queue = queues.get(kind);\n    const ids = queue ? [...queue] : [];\n    queue?.clear();\n    // Fired concurrently (the Web API has no bulk users.info/conversations.info), rather than\n    // waiting on each lookup one at a time.\n    await Promise.all(ids.map((id) => fetchOne(kind, id)));\n  }\n\n  async function fetchOne(kind: \"user\" | \"channel\", id: string) {\n    const key = cacheKey(kind, id);\n    try {\n      const name = kind === \"user\" ? await fetchUserName(id) : await fetchChannelName(id);\n      cache.set(key, name ?? null);\n    } catch {\n      // Unknown id, revoked token, rate limit, or an emulator that doesn't implement the method:\n      // treat it the same as \"unknown\" rather than throwing out of a render-time resolver.\n      cache.set(key, null);\n    } finally {\n      inflight.delete(key);\n      notify();\n    }\n  }\n\n  async function fetchUserName(id: string): Promise<string | undefined> {\n    const res = await client.users.info({ user: id });\n    const user = res.user;\n    return (\n      user?.profile?.display_name ||\n      user?.profile?.real_name ||\n      user?.real_name ||\n      user?.name ||\n      undefined\n    );\n  }\n\n  async function fetchChannelName(id: string): Promise<string | undefined> {\n    const res = await client.conversations.info({ channel: id });\n    const name = res.channel?.name;\n    return name ? `#${name}` : undefined;\n  }\n\n  function loadUsergroups(): void {\n    if (usergroupsLoaded || usergroupsLoading) return;\n    usergroupsLoading = (async () => {\n      try {\n        const res = await client.usergroups.list({});\n        for (const group of res.usergroups ?? []) {\n          if (!group.id) continue;\n          const name = group.handle ? `@${group.handle}` : (group.name ?? undefined);\n          cache.set(cacheKey(\"usergroup\", group.id), name ?? null);\n        }\n      } catch {\n        // Several emulators (and workspaces without Enterprise Grid) don't implement\n        // usergroups.list; leave usergroup ids unresolved rather than failing the whole surface.\n      } finally {\n        usergroupsLoaded = true;\n        usergroupsLoading = undefined;\n        notify();\n      }\n    })();\n  }\n\n  function lookupUsergroup(id: string): string | undefined {\n    const key = cacheKey(\"usergroup\", id);\n    if (cache.has(key)) return cache.get(key) ?? undefined;\n    loadUsergroups();\n    return undefined;\n  }\n\n  return {\n    user: (id) => lookup(\"user\", id),\n    channel: (id) => lookup(\"channel\", id),\n    usergroup: (id) => lookupUsergroup(id),\n    subscribe(listener) {\n      listeners.add(listener);\n      return () => listeners.delete(listener);\n    },\n  };\n}\n","import type { WebClient } from \"@slack/web-api\";\nimport { useEffect, useMemo, useState } from \"react\";\nimport {\n  createWebApiResolvers,\n  type WebApiResolvers,\n  type WebApiResolversOptions,\n} from \"./resolvers\";\n\n/**\n * `createWebApiResolvers`, wired up to re-render the calling component whenever a lookup\n * completes. Pass the returned resolvers straight to `<BlockKitProvider resolvers={...}>`.\n *\n * `opts` is only read when `client` (identity) changes, matching `createWebApiResolvers` being\n * called once per client rather than on every render.\n */\nexport function useWebApiResolvers(\n  client: WebClient,\n  opts?: WebApiResolversOptions,\n): WebApiResolvers {\n  // `opts` is a snapshot taken at creation time, like `client`: intentionally excluded below.\n  // oxlint-disable-next-line react-hooks/exhaustive-deps\n  const resolvers = useMemo(() => createWebApiResolvers(client, opts), [client]);\n  const [, forceUpdate] = useState(0);\n\n  useEffect(() => resolvers.subscribe(() => forceUpdate((v) => v + 1)), [resolvers]);\n\n  return resolvers;\n}\n"],"mappings":"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"}

package/package.json

@@ -1,12 +1,74 @@
 {
   "name": "@nkootstra/block-kit",
-  "version": "0.0.1",
-  "description": "Placeholder that reserves the name for npm trusted publishing; use 0.1.0 or later.",
+  "version": "0.1.0",
+  "description": "Render Slack Block Kit JSON in React, pixel-for-pixel the way Slack does.",
+  "keywords": [
+    "block-kit",
+    "blocks",
+    "mrkdwn",
+    "react",
+    "renderer",
+    "slack"
+  ],
+  "homepage": "https://block-kit.kootstra.io",
+  "bugs": "https://github.com/nkootstra/block-kit/issues",
   "license": "MIT",
+  "author": "Niels Kootstra",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/nkootstra/block-kit.git",
     "directory": "packages/block-kit"
   },
-  "files": []
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": [
+    "*.css"
+  ],
+  "exports": {
+    ".": "./dist/index.js",
+    "./mrkdwn": "./dist/mrkdwn.js",
+    "./transport": "./dist/transport.js",
+    "./server": "./dist/server.js",
+    "./web-api": "./dist/web-api.js",
+    "./styles.css": "./dist/styles.css",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "test": "vitest run",
+    "type-check": "tsc --noEmit",
+    "prepublishOnly": "tsdown"
+  },
+  "dependencies": {
+    "@slack/types": "3.1.0",
+    "mdast-util-from-markdown": "^2.0.3",
+    "mdast-util-gfm": "^3.1.0",
+    "micromark-extension-gfm": "^3.0.0"
+  },
+  "devDependencies": {
+    "@slack/bolt": "^5.1.0",
+    "@slack/web-api": "^8.1.1",
+    "@testing-library/react": "16.3.3",
+    "@types/mdast": "^4.0.4",
+    "@types/react": "19.3.0",
+    "@types/react-dom": "19.3.0",
+    "jsdom": "30.1.1",
+    "tsdown": "0.23.0"
+  },
+  "peerDependencies": {
+    "@slack/web-api": ">=8.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@slack/web-api": {
+      "optional": true
+    }
+  }
 }