@stambha/pagination 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mivaya
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,106 @@
+# @stambha/pagination
+
+**Embed pagination** with prev / next / dismiss buttons — built on Stambha **Signals** (`stambha:` custom ids).
+
+Part of [**Stambha plugins**](https://github.com/Mivaya/Stambha-plugins) · requires [`@stambha/core`](https://github.com/Mivaya/Stambha) `^1.2.0`
+
+---
+
+## Install
+
+```bash
+pnpm add @stambha/pagination @stambha/core
+```
+
+Requires **Node.js 20+**.
+
+---
+
+## Quick start
+
+Register the signal once (loader or manual register), then create a paginator from a command:
+
+```ts
+// src/signals/PaginationSignal.ts — or register in setup
+import { PaginationSignal } from "@stambha/pagination";
+// Piece loader discovers classes under src/signals/ when named accordingly.
+export { PaginationSignal };
+```
+
+```ts
+import { Command, type CommandContext, ok, type Registry } from "@stambha/core";
+import { createPaginator } from "@stambha/pagination";
+
+export class HelpPagesCommand extends Command {
+  constructor(registry: Registry<Command>) {
+    super(registry, {
+      name: "pages",
+      description: "Show a multi-page help embed",
+      kinds: ["slash", "prefix"],
+    });
+  }
+
+  async execute(ctx: CommandContext) {
+    const paginator = await createPaginator({
+      userId: ctx.userId,
+      pages: [
+        { embeds: [{ title: "Page 1", description: "Getting started" }] },
+        { embeds: [{ title: "Page 2", description: "Commands" }] },
+        { embeds: [{ title: "Page 3", description: "Deployment" }] },
+      ],
+    });
+
+    await ctx.reply(paginator.message());
+    return ok(undefined);
+  }
+}
+```
+
+Ensure `attachStambhaClient(hub, client, { signals: true })` (default) so button clicks route to `PaginationSignal`.
+
+Custom ids look like:
+
+```text
+stambha:pagination:next:<sessionId>
+```
+
+---
+
+## Key exports
+
+| Export | Purpose |
+|--------|---------|
+| `createPaginator` | Create a session and build the initial `ReplyPayload` |
+| `PaginationSignal` | Handles prev / next / dismiss clicks |
+| `Page`, `PaginatorOptions` | Types |
+
+### Options
+
+| Option | Default | Notes |
+|--------|---------|--------|
+| `pages` | required | Array or async resolver |
+| `userId` | unset | Lock controls to the invoker |
+| `timeoutMs` | `300000` | Session TTL (5 minutes) |
+| `wrap` | `false` | Cycle at ends; otherwise disable prev/next |
+| `labels` | Prev / Next / Dismiss | Button labels |
+| `startAt` | `0` | Initial page index |
+
+Page turns prefer Discord **UPDATE_MESSAGE** (interaction callback type 7) when `client.restPort` is set. Otherwise they fall back to `SignalContext.reply`.
+
+---
+
+## Related packages
+
+| Package | Role |
+|---------|------|
+| [`@stambha/core`](https://github.com/mivaya/Stambha/tree/main/packages/core) | Signals, `ReplyPayload`, client |
+| [`@stambha/gateway`](https://github.com/mivaya/Stambha/tree/main/packages/gateway) | `attachStambhaClient` routing |
+
+---
+
+## Development
+
+```bash
+pnpm --filter @stambha/pagination build
+pnpm --filter @stambha/pagination test
+```

package/dist/index.cjs

@@ -0,0 +1,306 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  PAGINATION_SIGNAL_NAME: () => PAGINATION_SIGNAL_NAME,
+  PaginationSignal: () => PaginationSignal,
+  buildDismissPayload: () => buildDismissPayload,
+  buildPagePayload: () => buildPagePayload,
+  clearSessions: () => clearSessions,
+  createPaginator: () => createPaginator,
+  getSession: () => getSession,
+  paginationCustomId: () => paginationCustomId,
+  paginationSuffix: () => paginationSuffix,
+  parsePaginationSuffix: () => parsePaginationSuffix,
+  sessionCount: () => sessionCount
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/ids.ts
+var PAGINATION_SIGNAL_NAME = "pagination";
+var ACTION_SET = /* @__PURE__ */ new Set(["prev", "next", "dismiss"]);
+function paginationCustomId(action, sessionId) {
+  return `stambha:${PAGINATION_SIGNAL_NAME}:${action}:${sessionId}`;
+}
+function paginationSuffix(action, sessionId) {
+  return `${action}:${sessionId}`;
+}
+function parsePaginationSuffix(suffix) {
+  const sep = suffix.indexOf(":");
+  if (sep <= 0) return null;
+  const action = suffix.slice(0, sep);
+  const sessionId = suffix.slice(sep + 1);
+  if (!sessionId || !ACTION_SET.has(action)) return null;
+  return { action, sessionId };
+}
+
+// src/components.ts
+var BUTTON = 2;
+var ACTION_ROW = 1;
+var STYLE_SECONDARY = 2;
+var STYLE_DANGER = 4;
+function buildPagePayload(page, options) {
+  const { sessionId, index, pageCount, labels, wrap } = options;
+  const atStart = index <= 0;
+  const atEnd = index >= pageCount - 1;
+  const prevDisabled = !wrap && atStart;
+  const nextDisabled = !wrap && atEnd;
+  const prev = {
+    type: BUTTON,
+    style: STYLE_SECONDARY,
+    label: labels.prev,
+    custom_id: paginationCustomId("prev", sessionId)
+  };
+  if (prevDisabled) prev.disabled = true;
+  const next = {
+    type: BUTTON,
+    style: STYLE_SECONDARY,
+    label: labels.next,
+    custom_id: paginationCustomId("next", sessionId)
+  };
+  if (nextDisabled) next.disabled = true;
+  const dismiss = {
+    type: BUTTON,
+    style: STYLE_DANGER,
+    label: labels.dismiss,
+    custom_id: paginationCustomId("dismiss", sessionId)
+  };
+  const row = {
+    type: ACTION_ROW,
+    components: [prev, next, dismiss]
+  };
+  const payload = {
+    components: [row]
+  };
+  if (page.content !== void 0) payload.content = page.content;
+  if (page.embeds !== void 0) payload.embeds = page.embeds;
+  return payload;
+}
+function buildDismissPayload(page) {
+  const payload = {
+    components: []
+  };
+  if (page.content !== void 0) payload.content = page.content;
+  if (page.embeds !== void 0) payload.embeds = page.embeds;
+  return payload;
+}
+
+// src/pageAt.ts
+function pageAt(pages, index) {
+  return pages[index] ?? pages[0] ?? {};
+}
+
+// src/session.ts
+var import_node_crypto = require("crypto");
+var sessions = /* @__PURE__ */ new Map();
+function createSessionId() {
+  return (0, import_node_crypto.randomBytes)(6).toString("base64url");
+}
+function setSession(id, session) {
+  sessions.set(id, session);
+}
+function getSession(id) {
+  const session = sessions.get(id);
+  if (!session) return void 0;
+  if (Date.now() > session.expiresAt) {
+    sessions.delete(id);
+    return void 0;
+  }
+  return session;
+}
+function deleteSession(id) {
+  sessions.delete(id);
+}
+function touchSession(id) {
+  const session = getSession(id);
+  if (!session) return void 0;
+  session.expiresAt = Date.now() + session.timeoutMs;
+  return session;
+}
+function clearSessions() {
+  sessions.clear();
+}
+function sessionCount() {
+  return sessions.size;
+}
+
+// src/createPaginator.ts
+var DEFAULT_TIMEOUT_MS = 5 * 6e4;
+var DEFAULT_LABELS = {
+  prev: "Prev",
+  next: "Next",
+  dismiss: "Dismiss"
+};
+function resolveLabels(labels) {
+  return {
+    prev: labels?.prev ?? DEFAULT_LABELS.prev,
+    next: labels?.next ?? DEFAULT_LABELS.next,
+    dismiss: labels?.dismiss ?? DEFAULT_LABELS.dismiss
+  };
+}
+async function resolvePages(pages) {
+  const resolved = typeof pages === "function" ? await pages() : pages;
+  const list = [...resolved];
+  if (list.length === 0) {
+    throw new Error("@stambha/pagination: pages must be a non-empty array");
+  }
+  return list;
+}
+async function createPaginator(options) {
+  const pages = await resolvePages(options.pages);
+  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  const wrap = options.wrap ?? false;
+  const labels = resolveLabels(options.labels);
+  const startAt = options.startAt ?? 0;
+  const index = Math.min(Math.max(0, startAt), pages.length - 1);
+  const sessionId = createSessionId();
+  const session = {
+    pages,
+    index,
+    expiresAt: Date.now() + timeoutMs,
+    wrap,
+    labels,
+    timeoutMs,
+    ...options.userId !== void 0 ? { userId: options.userId } : {}
+  };
+  setSession(sessionId, session);
+  return {
+    sessionId,
+    get index() {
+      return session.index;
+    },
+    get pageCount() {
+      return pages.length;
+    },
+    message() {
+      const page = pageAt(pages, session.index);
+      return buildPagePayload(page, {
+        sessionId,
+        index: session.index,
+        pageCount: pages.length,
+        labels,
+        wrap
+      });
+    }
+  };
+}
+
+// src/PaginationSignal.ts
+var import_core2 = require("@stambha/core");
+
+// src/respond.ts
+var import_core = require("@stambha/core");
+async function respondWithPage(ctx, restPort, payload) {
+  const raw = ctx.raw;
+  const id = raw?.id ?? null;
+  const token = raw?.token ?? null;
+  if (restPort && id && token) {
+    await restPort.request({
+      method: "POST",
+      route: `/interactions/${id}/${token}/callback`,
+      body: {
+        type: 7,
+        data: (0, import_core.normalizeReplyData)(payload)
+      }
+    });
+    return;
+  }
+  await ctx.reply(payload);
+}
+
+// src/PaginationSignal.ts
+var PaginationSignal = class extends import_core2.Signal {
+  constructor(registry) {
+    super(registry, {
+      name: PAGINATION_SIGNAL_NAME,
+      types: ["button"]
+    });
+  }
+  async run(ctx) {
+    const parsed = import_core2.Signal.parseCustomId(ctx.customId);
+    if (!parsed || parsed.name !== PAGINATION_SIGNAL_NAME) return;
+    const parts = parsePaginationSuffix(parsed.suffix);
+    if (!parts) {
+      await ctx.replyEphemeral("This pagination control is invalid.");
+      return;
+    }
+    const session = getSession(parts.sessionId);
+    if (!session) {
+      await ctx.replyEphemeral("This paginator has expired. Run the command again.");
+      return;
+    }
+    if (session.userId !== void 0 && session.userId !== ctx.userId) {
+      await ctx.replyEphemeral("Only the user who opened this paginator can use it.");
+      return;
+    }
+    const restPort = this.client.restPort;
+    const pageCount = session.pages.length;
+    if (parts.action === "dismiss") {
+      const page2 = pageAt(session.pages, session.index);
+      deleteSession(parts.sessionId);
+      await respondWithPage(ctx, restPort, buildDismissPayload(page2));
+      return;
+    }
+    let nextIndex = session.index;
+    if (parts.action === "prev") {
+      if (session.wrap) {
+        nextIndex = (session.index - 1 + pageCount) % pageCount;
+      } else if (session.index > 0) {
+        nextIndex = session.index - 1;
+      }
+    } else if (parts.action === "next") {
+      if (session.wrap) {
+        nextIndex = (session.index + 1) % pageCount;
+      } else if (session.index < pageCount - 1) {
+        nextIndex = session.index + 1;
+      }
+    }
+    session.index = nextIndex;
+    touchSession(parts.sessionId);
+    const page = pageAt(session.pages, session.index);
+    await respondWithPage(
+      ctx,
+      restPort,
+      buildPagePayload(page, {
+        sessionId: parts.sessionId,
+        index: session.index,
+        pageCount,
+        labels: session.labels,
+        wrap: session.wrap
+      })
+    );
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PAGINATION_SIGNAL_NAME,
+  PaginationSignal,
+  buildDismissPayload,
+  buildPagePayload,
+  clearSessions,
+  createPaginator,
+  getSession,
+  paginationCustomId,
+  paginationSuffix,
+  parsePaginationSuffix,
+  sessionCount
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/ids.ts","../src/components.ts","../src/pageAt.ts","../src/session.ts","../src/createPaginator.ts","../src/PaginationSignal.ts","../src/respond.ts"],"sourcesContent":["export { buildDismissPayload, buildPagePayload } from \"./components.js\";\nexport { createPaginator } from \"./createPaginator.js\";\nexport {\n  PAGINATION_SIGNAL_NAME,\n  paginationCustomId,\n  paginationSuffix,\n  parsePaginationSuffix,\n} from \"./ids.js\";\nexport { PaginationSignal } from \"./PaginationSignal.js\";\nexport { clearSessions, getSession, sessionCount } from \"./session.js\";\nexport type {\n  Page,\n  PaginationAction,\n  PaginationSession,\n  Paginator,\n  PaginatorLabels,\n  PaginatorOptions,\n  ResolvedPaginatorLabels,\n} from \"./types.js\";\n","import type { PaginationAction } from \"./types.js\";\n\nexport const PAGINATION_SIGNAL_NAME = \"pagination\";\n\nconst ACTION_SET = new Set<PaginationAction>([\"prev\", \"next\", \"dismiss\"]);\n\n/** Build a routable custom id: `stambha:pagination:{action}:{sessionId}`. */\nexport function paginationCustomId(action: PaginationAction, sessionId: string): string {\n  return `stambha:${PAGINATION_SIGNAL_NAME}:${action}:${sessionId}`;\n}\n\n/** Suffix passed to {@link Signal.customId} / returned by {@link Signal.parseCustomId}. */\nexport function paginationSuffix(action: PaginationAction, sessionId: string): string {\n  return `${action}:${sessionId}`;\n}\n\nexport function parsePaginationSuffix(\n  suffix: string,\n): { action: PaginationAction; sessionId: string } | null {\n  const sep = suffix.indexOf(\":\");\n  if (sep <= 0) return null;\n  const action = suffix.slice(0, sep);\n  const sessionId = suffix.slice(sep + 1);\n  if (!sessionId || !ACTION_SET.has(action as PaginationAction)) return null;\n  return { action: action as PaginationAction, sessionId };\n}\n","import type { ReplyPayload } from \"@stambha/core\";\nimport { paginationCustomId } from \"./ids.js\";\nimport type { Page, ResolvedPaginatorLabels } from \"./types.js\";\n\nconst BUTTON = 2;\nconst ACTION_ROW = 1;\nconst STYLE_SECONDARY = 2;\nconst STYLE_DANGER = 4;\n\ninterface ButtonComponent {\n  type: number;\n  style: number;\n  label: string;\n  custom_id: string;\n  disabled?: boolean;\n}\n\ninterface ActionRow {\n  type: number;\n  components: ButtonComponent[];\n}\n\nexport function buildPagePayload(\n  page: Page,\n  options: {\n    sessionId: string;\n    index: number;\n    pageCount: number;\n    labels: ResolvedPaginatorLabels;\n    wrap: boolean;\n  },\n): ReplyPayload {\n  const { sessionId, index, pageCount, labels, wrap } = options;\n  const atStart = index <= 0;\n  const atEnd = index >= pageCount - 1;\n\n  const prevDisabled = !wrap && atStart;\n  const nextDisabled = !wrap && atEnd;\n\n  const prev: ButtonComponent = {\n    type: BUTTON,\n    style: STYLE_SECONDARY,\n    label: labels.prev,\n    custom_id: paginationCustomId(\"prev\", sessionId),\n  };\n  if (prevDisabled) prev.disabled = true;\n\n  const next: ButtonComponent = {\n    type: BUTTON,\n    style: STYLE_SECONDARY,\n    label: labels.next,\n    custom_id: paginationCustomId(\"next\", sessionId),\n  };\n  if (nextDisabled) next.disabled = true;\n\n  const dismiss: ButtonComponent = {\n    type: BUTTON,\n    style: STYLE_DANGER,\n    label: labels.dismiss,\n    custom_id: paginationCustomId(\"dismiss\", sessionId),\n  };\n\n  const row: ActionRow = {\n    type: ACTION_ROW,\n    components: [prev, next, dismiss],\n  };\n\n  const payload: ReplyPayload = {\n    components: [row],\n  };\n  if (page.content !== undefined) payload.content = page.content;\n  if (page.embeds !== undefined) payload.embeds = page.embeds;\n  return payload;\n}\n\n/** Same page content with controls removed (dismiss). */\nexport function buildDismissPayload(page: Page): ReplyPayload {\n  const payload: ReplyPayload = {\n    components: [],\n  };\n  if (page.content !== undefined) payload.content = page.content;\n  if (page.embeds !== undefined) payload.embeds = page.embeds;\n  return payload;\n}\n","import type { Page } from \"./types.js\";\n\n/** Sessions always have ≥1 page; return a safe page for the index. */\nexport function pageAt(pages: readonly Page[], index: number): Page {\n  return pages[index] ?? pages[0] ?? {};\n}\n","import { randomBytes } from \"node:crypto\";\nimport type { PaginationSession } from \"./types.js\";\n\nconst sessions = new Map<string, PaginationSession>();\n\n/** Create a short opaque session id (fits Discord custom_id limits). */\nexport function createSessionId(): string {\n  return randomBytes(6).toString(\"base64url\");\n}\n\nexport function setSession(id: string, session: PaginationSession): void {\n  sessions.set(id, session);\n}\n\nexport function getSession(id: string): PaginationSession | undefined {\n  const session = sessions.get(id);\n  if (!session) return undefined;\n  if (Date.now() > session.expiresAt) {\n    sessions.delete(id);\n    return undefined;\n  }\n  return session;\n}\n\nexport function deleteSession(id: string): void {\n  sessions.delete(id);\n}\n\n/** Touch TTL after a successful interaction. */\nexport function touchSession(id: string): PaginationSession | undefined {\n  const session = getSession(id);\n  if (!session) return undefined;\n  session.expiresAt = Date.now() + session.timeoutMs;\n  return session;\n}\n\n/** Test helper — clear all sessions. */\nexport function clearSessions(): void {\n  sessions.clear();\n}\n\n/** Test helper — current session count (includes unexpired only when read via get). */\nexport function sessionCount(): number {\n  return sessions.size;\n}\n","import type { ReplyPayload } from \"@stambha/core\";\nimport { buildPagePayload } from \"./components.js\";\nimport { pageAt } from \"./pageAt.js\";\nimport { createSessionId, setSession } from \"./session.js\";\nimport type { Page, Paginator, PaginatorOptions, ResolvedPaginatorLabels } from \"./types.js\";\n\nconst DEFAULT_TIMEOUT_MS = 5 * 60_000;\n\nconst DEFAULT_LABELS: ResolvedPaginatorLabels = {\n  prev: \"Prev\",\n  next: \"Next\",\n  dismiss: \"Dismiss\",\n};\n\nfunction resolveLabels(labels?: PaginatorOptions[\"labels\"]): ResolvedPaginatorLabels {\n  return {\n    prev: labels?.prev ?? DEFAULT_LABELS.prev,\n    next: labels?.next ?? DEFAULT_LABELS.next,\n    dismiss: labels?.dismiss ?? DEFAULT_LABELS.dismiss,\n  };\n}\n\nasync function resolvePages(pages: PaginatorOptions[\"pages\"]): Promise<Page[]> {\n  const resolved = typeof pages === \"function\" ? await pages() : pages;\n  const list = [...resolved];\n  if (list.length === 0) {\n    throw new Error(\"@stambha/pagination: pages must be a non-empty array\");\n  }\n  return list;\n}\n\n/**\n * Create an in-memory paginator session and return a helper that builds the\n * initial message payload (page content + prev/next/dismiss buttons).\n */\nexport async function createPaginator(options: PaginatorOptions): Promise<Paginator> {\n  const pages = await resolvePages(options.pages);\n  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n  const wrap = options.wrap ?? false;\n  const labels = resolveLabels(options.labels);\n  const startAt = options.startAt ?? 0;\n  const index = Math.min(Math.max(0, startAt), pages.length - 1);\n  const sessionId = createSessionId();\n\n  const session = {\n    pages,\n    index,\n    expiresAt: Date.now() + timeoutMs,\n    wrap,\n    labels,\n    timeoutMs,\n    ...(options.userId !== undefined ? { userId: options.userId } : {}),\n  };\n  setSession(sessionId, session);\n\n  return {\n    sessionId,\n    get index() {\n      return session.index;\n    },\n    get pageCount() {\n      return pages.length;\n    },\n    message(): ReplyPayload {\n      const page = pageAt(pages, session.index);\n      return buildPagePayload(page, {\n        sessionId,\n        index: session.index,\n        pageCount: pages.length,\n        labels,\n        wrap,\n      });\n    },\n  };\n}\n","import { type Registry, Signal, type SignalContext } from \"@stambha/core\";\nimport { buildDismissPayload, buildPagePayload } from \"./components.js\";\nimport { PAGINATION_SIGNAL_NAME, parsePaginationSuffix } from \"./ids.js\";\nimport { pageAt } from \"./pageAt.js\";\nimport { respondWithPage } from \"./respond.js\";\nimport { deleteSession, getSession, touchSession } from \"./session.js\";\n\n/**\n * Signal piece that handles `stambha:pagination:{action}:{sessionId}` button clicks.\n * Register under `src/signals/` (or construct and `registries.signals.register`).\n */\nexport class PaginationSignal extends Signal {\n  constructor(registry: Registry<Signal>) {\n    super(registry, {\n      name: PAGINATION_SIGNAL_NAME,\n      types: [\"button\"],\n    });\n  }\n\n  async run(ctx: SignalContext): Promise<void> {\n    const parsed = Signal.parseCustomId(ctx.customId);\n    if (!parsed || parsed.name !== PAGINATION_SIGNAL_NAME) return;\n\n    const parts = parsePaginationSuffix(parsed.suffix);\n    if (!parts) {\n      await ctx.replyEphemeral(\"This pagination control is invalid.\");\n      return;\n    }\n\n    const session = getSession(parts.sessionId);\n    if (!session) {\n      await ctx.replyEphemeral(\"This paginator has expired. Run the command again.\");\n      return;\n    }\n\n    if (session.userId !== undefined && session.userId !== ctx.userId) {\n      await ctx.replyEphemeral(\"Only the user who opened this paginator can use it.\");\n      return;\n    }\n\n    const restPort = this.client.restPort;\n    const pageCount = session.pages.length;\n\n    if (parts.action === \"dismiss\") {\n      const page = pageAt(session.pages, session.index);\n      deleteSession(parts.sessionId);\n      await respondWithPage(ctx, restPort, buildDismissPayload(page));\n      return;\n    }\n\n    let nextIndex = session.index;\n    if (parts.action === \"prev\") {\n      if (session.wrap) {\n        nextIndex = (session.index - 1 + pageCount) % pageCount;\n      } else if (session.index > 0) {\n        nextIndex = session.index - 1;\n      }\n    } else if (parts.action === \"next\") {\n      if (session.wrap) {\n        nextIndex = (session.index + 1) % pageCount;\n      } else if (session.index < pageCount - 1) {\n        nextIndex = session.index + 1;\n      }\n    }\n\n    session.index = nextIndex;\n    touchSession(parts.sessionId);\n\n    const page = pageAt(session.pages, session.index);\n    await respondWithPage(\n      ctx,\n      restPort,\n      buildPagePayload(page, {\n        sessionId: parts.sessionId,\n        index: session.index,\n        pageCount,\n        labels: session.labels,\n        wrap: session.wrap,\n      }),\n    );\n  }\n}\n","import {\n  normalizeReplyData,\n  type ReplyPayload,\n  type RestPort,\n  type SignalContext,\n} from \"@stambha/core\";\n\ninterface InteractionRaw {\n  id?: string | null;\n  token?: string | null;\n}\n\n/**\n * Prefer Discord interaction callback type 7 (UPDATE_MESSAGE) via {@link RestPort}.\n * Falls back to {@link SignalContext.reply} (type 4) when REST is unavailable.\n */\nexport async function respondWithPage(\n  ctx: SignalContext,\n  restPort: RestPort | null,\n  payload: ReplyPayload,\n): Promise<void> {\n  const raw = ctx.raw as InteractionRaw | null | undefined;\n  const id = raw?.id ?? null;\n  const token = raw?.token ?? null;\n\n  if (restPort && id && token) {\n    await restPort.request({\n      method: \"POST\",\n      route: `/interactions/${id}/${token}/callback`,\n      body: {\n        type: 7,\n        data: normalizeReplyData(payload),\n      },\n    });\n    return;\n  }\n\n  await ctx.reply(payload);\n}\n"],"mappings":"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","names":["import_core","page"]}

package/dist/index.d.cts

@@ -0,0 +1,95 @@
+import { ReplyPayload, Signal, Registry, SignalContext } from '@stambha/core';
+
+/** One page of content shown by the paginator (components are owned by the package). */
+interface Page {
+    content?: string;
+    embeds?: readonly unknown[];
+}
+type PaginationAction = "prev" | "next" | "dismiss";
+interface PaginatorLabels {
+    prev?: string;
+    next?: string;
+    dismiss?: string;
+}
+interface ResolvedPaginatorLabels {
+    prev: string;
+    next: string;
+    dismiss: string;
+}
+interface PaginatorOptions {
+    /** Static pages or a resolver invoked once when the paginator is created. */
+    pages: readonly Page[] | (() => readonly Page[] | Promise<readonly Page[]>);
+    /** When set, only this user may click the buttons. */
+    userId?: string;
+    /** Session TTL in milliseconds (default 5 minutes). */
+    timeoutMs?: number;
+    labels?: PaginatorLabels;
+    /** Zero-based start index (default 0). */
+    startAt?: number;
+    /**
+     * When true, prev/next wrap around the ends.
+     * When false (default), buttons at the ends are disabled.
+     */
+    wrap?: boolean;
+}
+interface Paginator {
+    readonly sessionId: string;
+    /** Current zero-based page index. */
+    readonly index: number;
+    /** Total page count. */
+    readonly pageCount: number;
+    /** Build a {@link ReplyPayload} for the current page (content/embeds + buttons). */
+    message(): ReplyPayload;
+}
+interface PaginationSession {
+    pages: Page[];
+    index: number;
+    userId?: string;
+    expiresAt: number;
+    wrap: boolean;
+    labels: ResolvedPaginatorLabels;
+    timeoutMs: number;
+}
+
+declare function buildPagePayload(page: Page, options: {
+    sessionId: string;
+    index: number;
+    pageCount: number;
+    labels: ResolvedPaginatorLabels;
+    wrap: boolean;
+}): ReplyPayload;
+/** Same page content with controls removed (dismiss). */
+declare function buildDismissPayload(page: Page): ReplyPayload;
+
+/**
+ * Create an in-memory paginator session and return a helper that builds the
+ * initial message payload (page content + prev/next/dismiss buttons).
+ */
+declare function createPaginator(options: PaginatorOptions): Promise<Paginator>;
+
+declare const PAGINATION_SIGNAL_NAME = "pagination";
+/** Build a routable custom id: `stambha:pagination:{action}:{sessionId}`. */
+declare function paginationCustomId(action: PaginationAction, sessionId: string): string;
+/** Suffix passed to {@link Signal.customId} / returned by {@link Signal.parseCustomId}. */
+declare function paginationSuffix(action: PaginationAction, sessionId: string): string;
+declare function parsePaginationSuffix(suffix: string): {
+    action: PaginationAction;
+    sessionId: string;
+} | null;
+
+/**
+ * Signal piece that handles `stambha:pagination:{action}:{sessionId}` button clicks.
+ * Register under `src/signals/` (or construct and `registries.signals.register`).
+ */
+declare class PaginationSignal extends Signal {
+    constructor(registry: Registry<Signal>);
+    run(ctx: SignalContext): Promise<void>;
+}
+
+declare function getSession(id: string): PaginationSession | undefined;
+/** Test helper — clear all sessions. */
+declare function clearSessions(): void;
+/** Test helper — current session count (includes unexpired only when read via get). */
+declare function sessionCount(): number;
+
+export { PAGINATION_SIGNAL_NAME, type Page, type PaginationAction, type PaginationSession, PaginationSignal, type Paginator, type PaginatorLabels, type PaginatorOptions, type ResolvedPaginatorLabels, buildDismissPayload, buildPagePayload, clearSessions, createPaginator, getSession, paginationCustomId, paginationSuffix, parsePaginationSuffix, sessionCount };

package/dist/index.d.ts

@@ -0,0 +1,95 @@
+import { ReplyPayload, Signal, Registry, SignalContext } from '@stambha/core';
+
+/** One page of content shown by the paginator (components are owned by the package). */
+interface Page {
+    content?: string;
+    embeds?: readonly unknown[];
+}
+type PaginationAction = "prev" | "next" | "dismiss";
+interface PaginatorLabels {
+    prev?: string;
+    next?: string;
+    dismiss?: string;
+}
+interface ResolvedPaginatorLabels {
+    prev: string;
+    next: string;
+    dismiss: string;
+}
+interface PaginatorOptions {
+    /** Static pages or a resolver invoked once when the paginator is created. */
+    pages: readonly Page[] | (() => readonly Page[] | Promise<readonly Page[]>);
+    /** When set, only this user may click the buttons. */
+    userId?: string;
+    /** Session TTL in milliseconds (default 5 minutes). */
+    timeoutMs?: number;
+    labels?: PaginatorLabels;
+    /** Zero-based start index (default 0). */
+    startAt?: number;
+    /**
+     * When true, prev/next wrap around the ends.
+     * When false (default), buttons at the ends are disabled.
+     */
+    wrap?: boolean;
+}
+interface Paginator {
+    readonly sessionId: string;
+    /** Current zero-based page index. */
+    readonly index: number;
+    /** Total page count. */
+    readonly pageCount: number;
+    /** Build a {@link ReplyPayload} for the current page (content/embeds + buttons). */
+    message(): ReplyPayload;
+}
+interface PaginationSession {
+    pages: Page[];
+    index: number;
+    userId?: string;
+    expiresAt: number;
+    wrap: boolean;
+    labels: ResolvedPaginatorLabels;
+    timeoutMs: number;
+}
+
+declare function buildPagePayload(page: Page, options: {
+    sessionId: string;
+    index: number;
+    pageCount: number;
+    labels: ResolvedPaginatorLabels;
+    wrap: boolean;
+}): ReplyPayload;
+/** Same page content with controls removed (dismiss). */
+declare function buildDismissPayload(page: Page): ReplyPayload;
+
+/**
+ * Create an in-memory paginator session and return a helper that builds the
+ * initial message payload (page content + prev/next/dismiss buttons).
+ */
+declare function createPaginator(options: PaginatorOptions): Promise<Paginator>;
+
+declare const PAGINATION_SIGNAL_NAME = "pagination";
+/** Build a routable custom id: `stambha:pagination:{action}:{sessionId}`. */
+declare function paginationCustomId(action: PaginationAction, sessionId: string): string;
+/** Suffix passed to {@link Signal.customId} / returned by {@link Signal.parseCustomId}. */
+declare function paginationSuffix(action: PaginationAction, sessionId: string): string;
+declare function parsePaginationSuffix(suffix: string): {
+    action: PaginationAction;
+    sessionId: string;
+} | null;
+
+/**
+ * Signal piece that handles `stambha:pagination:{action}:{sessionId}` button clicks.
+ * Register under `src/signals/` (or construct and `registries.signals.register`).
+ */
+declare class PaginationSignal extends Signal {
+    constructor(registry: Registry<Signal>);
+    run(ctx: SignalContext): Promise<void>;
+}
+
+declare function getSession(id: string): PaginationSession | undefined;
+/** Test helper — clear all sessions. */
+declare function clearSessions(): void;
+/** Test helper — current session count (includes unexpired only when read via get). */
+declare function sessionCount(): number;
+
+export { PAGINATION_SIGNAL_NAME, type Page, type PaginationAction, type PaginationSession, PaginationSignal, type Paginator, type PaginatorLabels, type PaginatorOptions, type ResolvedPaginatorLabels, buildDismissPayload, buildPagePayload, clearSessions, createPaginator, getSession, paginationCustomId, paginationSuffix, parsePaginationSuffix, sessionCount };

package/dist/index.js

@@ -0,0 +1,271 @@
+// src/ids.ts
+var PAGINATION_SIGNAL_NAME = "pagination";
+var ACTION_SET = /* @__PURE__ */ new Set(["prev", "next", "dismiss"]);
+function paginationCustomId(action, sessionId) {
+  return `stambha:${PAGINATION_SIGNAL_NAME}:${action}:${sessionId}`;
+}
+function paginationSuffix(action, sessionId) {
+  return `${action}:${sessionId}`;
+}
+function parsePaginationSuffix(suffix) {
+  const sep = suffix.indexOf(":");
+  if (sep <= 0) return null;
+  const action = suffix.slice(0, sep);
+  const sessionId = suffix.slice(sep + 1);
+  if (!sessionId || !ACTION_SET.has(action)) return null;
+  return { action, sessionId };
+}
+
+// src/components.ts
+var BUTTON = 2;
+var ACTION_ROW = 1;
+var STYLE_SECONDARY = 2;
+var STYLE_DANGER = 4;
+function buildPagePayload(page, options) {
+  const { sessionId, index, pageCount, labels, wrap } = options;
+  const atStart = index <= 0;
+  const atEnd = index >= pageCount - 1;
+  const prevDisabled = !wrap && atStart;
+  const nextDisabled = !wrap && atEnd;
+  const prev = {
+    type: BUTTON,
+    style: STYLE_SECONDARY,
+    label: labels.prev,
+    custom_id: paginationCustomId("prev", sessionId)
+  };
+  if (prevDisabled) prev.disabled = true;
+  const next = {
+    type: BUTTON,
+    style: STYLE_SECONDARY,
+    label: labels.next,
+    custom_id: paginationCustomId("next", sessionId)
+  };
+  if (nextDisabled) next.disabled = true;
+  const dismiss = {
+    type: BUTTON,
+    style: STYLE_DANGER,
+    label: labels.dismiss,
+    custom_id: paginationCustomId("dismiss", sessionId)
+  };
+  const row = {
+    type: ACTION_ROW,
+    components: [prev, next, dismiss]
+  };
+  const payload = {
+    components: [row]
+  };
+  if (page.content !== void 0) payload.content = page.content;
+  if (page.embeds !== void 0) payload.embeds = page.embeds;
+  return payload;
+}
+function buildDismissPayload(page) {
+  const payload = {
+    components: []
+  };
+  if (page.content !== void 0) payload.content = page.content;
+  if (page.embeds !== void 0) payload.embeds = page.embeds;
+  return payload;
+}
+
+// src/pageAt.ts
+function pageAt(pages, index) {
+  return pages[index] ?? pages[0] ?? {};
+}
+
+// src/session.ts
+import { randomBytes } from "crypto";
+var sessions = /* @__PURE__ */ new Map();
+function createSessionId() {
+  return randomBytes(6).toString("base64url");
+}
+function setSession(id, session) {
+  sessions.set(id, session);
+}
+function getSession(id) {
+  const session = sessions.get(id);
+  if (!session) return void 0;
+  if (Date.now() > session.expiresAt) {
+    sessions.delete(id);
+    return void 0;
+  }
+  return session;
+}
+function deleteSession(id) {
+  sessions.delete(id);
+}
+function touchSession(id) {
+  const session = getSession(id);
+  if (!session) return void 0;
+  session.expiresAt = Date.now() + session.timeoutMs;
+  return session;
+}
+function clearSessions() {
+  sessions.clear();
+}
+function sessionCount() {
+  return sessions.size;
+}
+
+// src/createPaginator.ts
+var DEFAULT_TIMEOUT_MS = 5 * 6e4;
+var DEFAULT_LABELS = {
+  prev: "Prev",
+  next: "Next",
+  dismiss: "Dismiss"
+};
+function resolveLabels(labels) {
+  return {
+    prev: labels?.prev ?? DEFAULT_LABELS.prev,
+    next: labels?.next ?? DEFAULT_LABELS.next,
+    dismiss: labels?.dismiss ?? DEFAULT_LABELS.dismiss
+  };
+}
+async function resolvePages(pages) {
+  const resolved = typeof pages === "function" ? await pages() : pages;
+  const list = [...resolved];
+  if (list.length === 0) {
+    throw new Error("@stambha/pagination: pages must be a non-empty array");
+  }
+  return list;
+}
+async function createPaginator(options) {
+  const pages = await resolvePages(options.pages);
+  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  const wrap = options.wrap ?? false;
+  const labels = resolveLabels(options.labels);
+  const startAt = options.startAt ?? 0;
+  const index = Math.min(Math.max(0, startAt), pages.length - 1);
+  const sessionId = createSessionId();
+  const session = {
+    pages,
+    index,
+    expiresAt: Date.now() + timeoutMs,
+    wrap,
+    labels,
+    timeoutMs,
+    ...options.userId !== void 0 ? { userId: options.userId } : {}
+  };
+  setSession(sessionId, session);
+  return {
+    sessionId,
+    get index() {
+      return session.index;
+    },
+    get pageCount() {
+      return pages.length;
+    },
+    message() {
+      const page = pageAt(pages, session.index);
+      return buildPagePayload(page, {
+        sessionId,
+        index: session.index,
+        pageCount: pages.length,
+        labels,
+        wrap
+      });
+    }
+  };
+}
+
+// src/PaginationSignal.ts
+import { Signal } from "@stambha/core";
+
+// src/respond.ts
+import {
+  normalizeReplyData
+} from "@stambha/core";
+async function respondWithPage(ctx, restPort, payload) {
+  const raw = ctx.raw;
+  const id = raw?.id ?? null;
+  const token = raw?.token ?? null;
+  if (restPort && id && token) {
+    await restPort.request({
+      method: "POST",
+      route: `/interactions/${id}/${token}/callback`,
+      body: {
+        type: 7,
+        data: normalizeReplyData(payload)
+      }
+    });
+    return;
+  }
+  await ctx.reply(payload);
+}
+
+// src/PaginationSignal.ts
+var PaginationSignal = class extends Signal {
+  constructor(registry) {
+    super(registry, {
+      name: PAGINATION_SIGNAL_NAME,
+      types: ["button"]
+    });
+  }
+  async run(ctx) {
+    const parsed = Signal.parseCustomId(ctx.customId);
+    if (!parsed || parsed.name !== PAGINATION_SIGNAL_NAME) return;
+    const parts = parsePaginationSuffix(parsed.suffix);
+    if (!parts) {
+      await ctx.replyEphemeral("This pagination control is invalid.");
+      return;
+    }
+    const session = getSession(parts.sessionId);
+    if (!session) {
+      await ctx.replyEphemeral("This paginator has expired. Run the command again.");
+      return;
+    }
+    if (session.userId !== void 0 && session.userId !== ctx.userId) {
+      await ctx.replyEphemeral("Only the user who opened this paginator can use it.");
+      return;
+    }
+    const restPort = this.client.restPort;
+    const pageCount = session.pages.length;
+    if (parts.action === "dismiss") {
+      const page2 = pageAt(session.pages, session.index);
+      deleteSession(parts.sessionId);
+      await respondWithPage(ctx, restPort, buildDismissPayload(page2));
+      return;
+    }
+    let nextIndex = session.index;
+    if (parts.action === "prev") {
+      if (session.wrap) {
+        nextIndex = (session.index - 1 + pageCount) % pageCount;
+      } else if (session.index > 0) {
+        nextIndex = session.index - 1;
+      }
+    } else if (parts.action === "next") {
+      if (session.wrap) {
+        nextIndex = (session.index + 1) % pageCount;
+      } else if (session.index < pageCount - 1) {
+        nextIndex = session.index + 1;
+      }
+    }
+    session.index = nextIndex;
+    touchSession(parts.sessionId);
+    const page = pageAt(session.pages, session.index);
+    await respondWithPage(
+      ctx,
+      restPort,
+      buildPagePayload(page, {
+        sessionId: parts.sessionId,
+        index: session.index,
+        pageCount,
+        labels: session.labels,
+        wrap: session.wrap
+      })
+    );
+  }
+};
+export {
+  PAGINATION_SIGNAL_NAME,
+  PaginationSignal,
+  buildDismissPayload,
+  buildPagePayload,
+  clearSessions,
+  createPaginator,
+  getSession,
+  paginationCustomId,
+  paginationSuffix,
+  parsePaginationSuffix,
+  sessionCount
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ids.ts","../src/components.ts","../src/pageAt.ts","../src/session.ts","../src/createPaginator.ts","../src/PaginationSignal.ts","../src/respond.ts"],"sourcesContent":["import type { PaginationAction } from \"./types.js\";\n\nexport const PAGINATION_SIGNAL_NAME = \"pagination\";\n\nconst ACTION_SET = new Set<PaginationAction>([\"prev\", \"next\", \"dismiss\"]);\n\n/** Build a routable custom id: `stambha:pagination:{action}:{sessionId}`. */\nexport function paginationCustomId(action: PaginationAction, sessionId: string): string {\n  return `stambha:${PAGINATION_SIGNAL_NAME}:${action}:${sessionId}`;\n}\n\n/** Suffix passed to {@link Signal.customId} / returned by {@link Signal.parseCustomId}. */\nexport function paginationSuffix(action: PaginationAction, sessionId: string): string {\n  return `${action}:${sessionId}`;\n}\n\nexport function parsePaginationSuffix(\n  suffix: string,\n): { action: PaginationAction; sessionId: string } | null {\n  const sep = suffix.indexOf(\":\");\n  if (sep <= 0) return null;\n  const action = suffix.slice(0, sep);\n  const sessionId = suffix.slice(sep + 1);\n  if (!sessionId || !ACTION_SET.has(action as PaginationAction)) return null;\n  return { action: action as PaginationAction, sessionId };\n}\n","import type { ReplyPayload } from \"@stambha/core\";\nimport { paginationCustomId } from \"./ids.js\";\nimport type { Page, ResolvedPaginatorLabels } from \"./types.js\";\n\nconst BUTTON = 2;\nconst ACTION_ROW = 1;\nconst STYLE_SECONDARY = 2;\nconst STYLE_DANGER = 4;\n\ninterface ButtonComponent {\n  type: number;\n  style: number;\n  label: string;\n  custom_id: string;\n  disabled?: boolean;\n}\n\ninterface ActionRow {\n  type: number;\n  components: ButtonComponent[];\n}\n\nexport function buildPagePayload(\n  page: Page,\n  options: {\n    sessionId: string;\n    index: number;\n    pageCount: number;\n    labels: ResolvedPaginatorLabels;\n    wrap: boolean;\n  },\n): ReplyPayload {\n  const { sessionId, index, pageCount, labels, wrap } = options;\n  const atStart = index <= 0;\n  const atEnd = index >= pageCount - 1;\n\n  const prevDisabled = !wrap && atStart;\n  const nextDisabled = !wrap && atEnd;\n\n  const prev: ButtonComponent = {\n    type: BUTTON,\n    style: STYLE_SECONDARY,\n    label: labels.prev,\n    custom_id: paginationCustomId(\"prev\", sessionId),\n  };\n  if (prevDisabled) prev.disabled = true;\n\n  const next: ButtonComponent = {\n    type: BUTTON,\n    style: STYLE_SECONDARY,\n    label: labels.next,\n    custom_id: paginationCustomId(\"next\", sessionId),\n  };\n  if (nextDisabled) next.disabled = true;\n\n  const dismiss: ButtonComponent = {\n    type: BUTTON,\n    style: STYLE_DANGER,\n    label: labels.dismiss,\n    custom_id: paginationCustomId(\"dismiss\", sessionId),\n  };\n\n  const row: ActionRow = {\n    type: ACTION_ROW,\n    components: [prev, next, dismiss],\n  };\n\n  const payload: ReplyPayload = {\n    components: [row],\n  };\n  if (page.content !== undefined) payload.content = page.content;\n  if (page.embeds !== undefined) payload.embeds = page.embeds;\n  return payload;\n}\n\n/** Same page content with controls removed (dismiss). */\nexport function buildDismissPayload(page: Page): ReplyPayload {\n  const payload: ReplyPayload = {\n    components: [],\n  };\n  if (page.content !== undefined) payload.content = page.content;\n  if (page.embeds !== undefined) payload.embeds = page.embeds;\n  return payload;\n}\n","import type { Page } from \"./types.js\";\n\n/** Sessions always have ≥1 page; return a safe page for the index. */\nexport function pageAt(pages: readonly Page[], index: number): Page {\n  return pages[index] ?? pages[0] ?? {};\n}\n","import { randomBytes } from \"node:crypto\";\nimport type { PaginationSession } from \"./types.js\";\n\nconst sessions = new Map<string, PaginationSession>();\n\n/** Create a short opaque session id (fits Discord custom_id limits). */\nexport function createSessionId(): string {\n  return randomBytes(6).toString(\"base64url\");\n}\n\nexport function setSession(id: string, session: PaginationSession): void {\n  sessions.set(id, session);\n}\n\nexport function getSession(id: string): PaginationSession | undefined {\n  const session = sessions.get(id);\n  if (!session) return undefined;\n  if (Date.now() > session.expiresAt) {\n    sessions.delete(id);\n    return undefined;\n  }\n  return session;\n}\n\nexport function deleteSession(id: string): void {\n  sessions.delete(id);\n}\n\n/** Touch TTL after a successful interaction. */\nexport function touchSession(id: string): PaginationSession | undefined {\n  const session = getSession(id);\n  if (!session) return undefined;\n  session.expiresAt = Date.now() + session.timeoutMs;\n  return session;\n}\n\n/** Test helper — clear all sessions. */\nexport function clearSessions(): void {\n  sessions.clear();\n}\n\n/** Test helper — current session count (includes unexpired only when read via get). */\nexport function sessionCount(): number {\n  return sessions.size;\n}\n","import type { ReplyPayload } from \"@stambha/core\";\nimport { buildPagePayload } from \"./components.js\";\nimport { pageAt } from \"./pageAt.js\";\nimport { createSessionId, setSession } from \"./session.js\";\nimport type { Page, Paginator, PaginatorOptions, ResolvedPaginatorLabels } from \"./types.js\";\n\nconst DEFAULT_TIMEOUT_MS = 5 * 60_000;\n\nconst DEFAULT_LABELS: ResolvedPaginatorLabels = {\n  prev: \"Prev\",\n  next: \"Next\",\n  dismiss: \"Dismiss\",\n};\n\nfunction resolveLabels(labels?: PaginatorOptions[\"labels\"]): ResolvedPaginatorLabels {\n  return {\n    prev: labels?.prev ?? DEFAULT_LABELS.prev,\n    next: labels?.next ?? DEFAULT_LABELS.next,\n    dismiss: labels?.dismiss ?? DEFAULT_LABELS.dismiss,\n  };\n}\n\nasync function resolvePages(pages: PaginatorOptions[\"pages\"]): Promise<Page[]> {\n  const resolved = typeof pages === \"function\" ? await pages() : pages;\n  const list = [...resolved];\n  if (list.length === 0) {\n    throw new Error(\"@stambha/pagination: pages must be a non-empty array\");\n  }\n  return list;\n}\n\n/**\n * Create an in-memory paginator session and return a helper that builds the\n * initial message payload (page content + prev/next/dismiss buttons).\n */\nexport async function createPaginator(options: PaginatorOptions): Promise<Paginator> {\n  const pages = await resolvePages(options.pages);\n  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n  const wrap = options.wrap ?? false;\n  const labels = resolveLabels(options.labels);\n  const startAt = options.startAt ?? 0;\n  const index = Math.min(Math.max(0, startAt), pages.length - 1);\n  const sessionId = createSessionId();\n\n  const session = {\n    pages,\n    index,\n    expiresAt: Date.now() + timeoutMs,\n    wrap,\n    labels,\n    timeoutMs,\n    ...(options.userId !== undefined ? { userId: options.userId } : {}),\n  };\n  setSession(sessionId, session);\n\n  return {\n    sessionId,\n    get index() {\n      return session.index;\n    },\n    get pageCount() {\n      return pages.length;\n    },\n    message(): ReplyPayload {\n      const page = pageAt(pages, session.index);\n      return buildPagePayload(page, {\n        sessionId,\n        index: session.index,\n        pageCount: pages.length,\n        labels,\n        wrap,\n      });\n    },\n  };\n}\n","import { type Registry, Signal, type SignalContext } from \"@stambha/core\";\nimport { buildDismissPayload, buildPagePayload } from \"./components.js\";\nimport { PAGINATION_SIGNAL_NAME, parsePaginationSuffix } from \"./ids.js\";\nimport { pageAt } from \"./pageAt.js\";\nimport { respondWithPage } from \"./respond.js\";\nimport { deleteSession, getSession, touchSession } from \"./session.js\";\n\n/**\n * Signal piece that handles `stambha:pagination:{action}:{sessionId}` button clicks.\n * Register under `src/signals/` (or construct and `registries.signals.register`).\n */\nexport class PaginationSignal extends Signal {\n  constructor(registry: Registry<Signal>) {\n    super(registry, {\n      name: PAGINATION_SIGNAL_NAME,\n      types: [\"button\"],\n    });\n  }\n\n  async run(ctx: SignalContext): Promise<void> {\n    const parsed = Signal.parseCustomId(ctx.customId);\n    if (!parsed || parsed.name !== PAGINATION_SIGNAL_NAME) return;\n\n    const parts = parsePaginationSuffix(parsed.suffix);\n    if (!parts) {\n      await ctx.replyEphemeral(\"This pagination control is invalid.\");\n      return;\n    }\n\n    const session = getSession(parts.sessionId);\n    if (!session) {\n      await ctx.replyEphemeral(\"This paginator has expired. Run the command again.\");\n      return;\n    }\n\n    if (session.userId !== undefined && session.userId !== ctx.userId) {\n      await ctx.replyEphemeral(\"Only the user who opened this paginator can use it.\");\n      return;\n    }\n\n    const restPort = this.client.restPort;\n    const pageCount = session.pages.length;\n\n    if (parts.action === \"dismiss\") {\n      const page = pageAt(session.pages, session.index);\n      deleteSession(parts.sessionId);\n      await respondWithPage(ctx, restPort, buildDismissPayload(page));\n      return;\n    }\n\n    let nextIndex = session.index;\n    if (parts.action === \"prev\") {\n      if (session.wrap) {\n        nextIndex = (session.index - 1 + pageCount) % pageCount;\n      } else if (session.index > 0) {\n        nextIndex = session.index - 1;\n      }\n    } else if (parts.action === \"next\") {\n      if (session.wrap) {\n        nextIndex = (session.index + 1) % pageCount;\n      } else if (session.index < pageCount - 1) {\n        nextIndex = session.index + 1;\n      }\n    }\n\n    session.index = nextIndex;\n    touchSession(parts.sessionId);\n\n    const page = pageAt(session.pages, session.index);\n    await respondWithPage(\n      ctx,\n      restPort,\n      buildPagePayload(page, {\n        sessionId: parts.sessionId,\n        index: session.index,\n        pageCount,\n        labels: session.labels,\n        wrap: session.wrap,\n      }),\n    );\n  }\n}\n","import {\n  normalizeReplyData,\n  type ReplyPayload,\n  type RestPort,\n  type SignalContext,\n} from \"@stambha/core\";\n\ninterface InteractionRaw {\n  id?: string | null;\n  token?: string | null;\n}\n\n/**\n * Prefer Discord interaction callback type 7 (UPDATE_MESSAGE) via {@link RestPort}.\n * Falls back to {@link SignalContext.reply} (type 4) when REST is unavailable.\n */\nexport async function respondWithPage(\n  ctx: SignalContext,\n  restPort: RestPort | null,\n  payload: ReplyPayload,\n): Promise<void> {\n  const raw = ctx.raw as InteractionRaw | null | undefined;\n  const id = raw?.id ?? null;\n  const token = raw?.token ?? null;\n\n  if (restPort && id && token) {\n    await restPort.request({\n      method: \"POST\",\n      route: `/interactions/${id}/${token}/callback`,\n      body: {\n        type: 7,\n        data: normalizeReplyData(payload),\n      },\n    });\n    return;\n  }\n\n  await ctx.reply(payload);\n}\n"],"mappings":"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","names":["page"]}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@stambha/pagination",
+  "version": "1.0.0",
+  "description": "Embed pagination with prev/next/dismiss buttons for Stambha Signals",
+  "author": "Mivaya",
+  "license": "MIT",
+  "homepage": "https://github.com/Mivaya/Stambha-plugins/tree/main/packages/pagination#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Mivaya/Stambha-plugins.git",
+    "directory": "packages/pagination"
+  },
+  "bugs": {
+    "url": "https://github.com/Mivaya/Stambha/issues"
+  },
+  "keywords": [
+    "discord",
+    "discord-bot",
+    "stambha",
+    "pagination",
+    "signals",
+    "embeds"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "@stambha/core": "^1.2.0"
+  },
+  "devDependencies": {
+    "@stambha/core": "^1.2.0",
+    "@types/node": "^22.13.4",
+    "tsup": "^8.3.6",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.5"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}