@yaebal/split 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 neverlane
+
+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,13 @@
+# @yaebal/split
+
+telegram's per-message text limit.
+
+## install
+
+```sh
+pnpm add @yaebal/split
+```
+
+---
+
+part of [**yaebal**](https://github.com/neverlane/yaebal) — a type-safe, runtime-agnostic Telegram Bot API framework. MIT.

package/lib/index.d.ts

@@ -0,0 +1,17 @@
+import type { Context, Message, Plugin } from "@yaebal/core";
+/** telegram's per-message text limit. */
+export declare const MAX_MESSAGE_LENGTH = 4096;
+/**
+ * split `text` into chunks no longer than `max`, preferring to break on newlines.
+ * a single line longer than `max` is hard-split. pure — exported for testing.
+ */
+export declare function split(text: string, max?: number): string[];
+export interface SplitControl {
+    /** send `text`, automatically split into telegram-sized chunks. */
+    sendLong(text: string, extra?: Record<string, unknown>): Promise<Message[]>;
+    /** reply with `text`, automatically split. */
+    replyLong(text: string, extra?: Record<string, unknown>): Promise<Message[]>;
+}
+/** adds `ctx.sendLong` / `ctx.replyLong` that split overlong text across messages. */
+export declare function splitter(max?: number): Plugin<Context, SplitControl>;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE7D,yCAAyC;AACzC,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC;;;GAGG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAqB,GAAG,MAAM,EAAE,CAgCtE;AAED,MAAM,WAAW,YAAY;IAC5B,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5E,8CAA8C;IAC9C,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;CAC7E;AAED,sFAAsF;AACtF,wBAAgB,QAAQ,CAAC,GAAG,SAAqB,GAAG,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,CAsBhF"}

package/lib/index.js

@@ -0,0 +1,57 @@
+/** telegram's per-message text limit. */
+export const MAX_MESSAGE_LENGTH = 4096;
+/**
+ * split `text` into chunks no longer than `max`, preferring to break on newlines.
+ * a single line longer than `max` is hard-split. pure — exported for testing.
+ */
+export function split(text, max = MAX_MESSAGE_LENGTH) {
+    if (text.length <= max)
+        return [text];
+    const chunks = [];
+    let current = "";
+    const flush = () => {
+        if (current.length > 0) {
+            chunks.push(current);
+            current = "";
+        }
+    };
+    for (const line of text.split("\n")) {
+        if (line.length > max) {
+            flush();
+            for (let i = 0; i < line.length; i += max)
+                chunks.push(line.slice(i, i + max));
+            continue;
+        }
+        const candidate = current.length > 0 ? `${current}\n${line}` : line;
+        if (candidate.length > max) {
+            flush();
+            current = line;
+        }
+        else {
+            current = candidate;
+        }
+    }
+    flush();
+    return chunks;
+}
+/** adds `ctx.sendLong` / `ctx.replyLong` that split overlong text across messages. */
+export function splitter(max = MAX_MESSAGE_LENGTH) {
+    return (composer) => composer.derive((ctx) => {
+        const control = {
+            async sendLong(text, extra) {
+                const out = [];
+                for (const part of split(text, max))
+                    out.push(await ctx.send(part, extra));
+                return out;
+            },
+            async replyLong(text, extra) {
+                const out = [];
+                for (const part of split(text, max))
+                    out.push(await ctx.reply(part, extra));
+                return out;
+            },
+        };
+        return control;
+    });
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,yCAAyC;AACzC,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEvC;;;GAGG;AACH,MAAM,UAAU,KAAK,CAAC,IAAY,EAAE,GAAG,GAAG,kBAAkB;IAC3D,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,MAAM,KAAK,GAAG,GAAG,EAAE;QAClB,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACrB,OAAO,GAAG,EAAE,CAAC;QACd,CAAC;IACF,CAAC,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YACvB,KAAK,EAAE,CAAC;YACR,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,GAAG;gBAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;YAE/E,SAAS;QACV,CAAC;QAED,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAEpE,IAAI,SAAS,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YAC5B,KAAK,EAAE,CAAC;YACR,OAAO,GAAG,IAAI,CAAC;QAChB,CAAC;aAAM,CAAC;YACP,OAAO,GAAG,SAAS,CAAC;QACrB,CAAC;IACF,CAAC;IAED,KAAK,EAAE,CAAC;IACR,OAAO,MAAM,CAAC;AACf,CAAC;AASD,sFAAsF;AACtF,MAAM,UAAU,QAAQ,CAAC,GAAG,GAAG,kBAAkB;IAChD,OAAO,CAAC,QAAQ,EAAE,EAAE,CACnB,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE;QACvB,MAAM,OAAO,GAAiB;YAC7B,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK;gBACzB,MAAM,GAAG,GAAc,EAAE,CAAC;gBAE1B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC;oBAAE,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;gBAE3E,OAAO,GAAG,CAAC;YACZ,CAAC;YACD,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK;gBAC1B,MAAM,GAAG,GAAc,EAAE,CAAC;gBAE1B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC;oBAAE,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;gBAE5E,OAAO,GAAG,CAAC;YACZ,CAAC;SACD,CAAC;QAEF,OAAO,OAAO,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/lib/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/lib/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":""}

package/lib/index.test.js

@@ -0,0 +1,26 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { split } from "./index.js";
+test("short text is returned as a single chunk", () => {
+    assert.deepEqual(split("hello"), ["hello"]);
+    assert.deepEqual(split(""), [""]);
+});
+test("splits on newlines, each chunk within the limit", () => {
+    const lines = Array.from({ length: 10 }, (_, i) => `line ${i} ${"x".repeat(40)}`);
+    const text = lines.join("\n");
+    const chunks = split(text, 100);
+    for (const c of chunks)
+        assert.ok(c.length <= 100, `chunk len ${c.length}`);
+    // rejoining preserves content (newline-joined chunks reconstruct the text)
+    assert.equal(chunks.join("\n"), text);
+});
+test("a single line longer than max is hard-split", () => {
+    const line = "a".repeat(250);
+    const chunks = split(line, 100);
+    assert.deepEqual(chunks, ["a".repeat(100), "a".repeat(100), "a".repeat(50)]);
+});
+test("does not split when exactly at the limit", () => {
+    const text = "a".repeat(100);
+    assert.deepEqual(split(text, 100), [text]);
+});
+//# sourceMappingURL=index.test.js.map

package/lib/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,IAAI,CAAC,0CAA0C,EAAE,GAAG,EAAE;IACrD,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5C,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACnC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,iDAAiD,EAAE,GAAG,EAAE;IAC5D,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAClF,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAEhC,KAAK,MAAM,CAAC,IAAI,MAAM;QAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,GAAG,EAAE,aAAa,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IAE5E,2EAA2E;IAC3E,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;AACvC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,6CAA6C,EAAE,GAAG,EAAE;IACxD,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAEhC,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9E,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,0CAA0C,EAAE,GAAG,EAAE;IACrD,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAE7B,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5C,CAAC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@yaebal/split",
+  "version": "0.0.1",
+  "description": "yaebal split — break long messages into Telegram-sized chunks.",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.js"
+    }
+  },
+  "files": [
+    "lib",
+    "src"
+  ],
+  "dependencies": {
+    "@yaebal/core": "0.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "latest"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "telegram",
+    "telegram-bot",
+    "yaebal",
+    "split",
+    "long-message"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/neverlane/yaebal",
+    "directory": "packages/split"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node --test lib"
+  }
+}

package/src/index.test.ts

@@ -0,0 +1,32 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { split } from "./index.js";
+
+test("short text is returned as a single chunk", () => {
+	assert.deepEqual(split("hello"), ["hello"]);
+	assert.deepEqual(split(""), [""]);
+});
+
+test("splits on newlines, each chunk within the limit", () => {
+	const lines = Array.from({ length: 10 }, (_, i) => `line ${i} ${"x".repeat(40)}`);
+	const text = lines.join("\n");
+	const chunks = split(text, 100);
+
+	for (const c of chunks) assert.ok(c.length <= 100, `chunk len ${c.length}`);
+
+	// rejoining preserves content (newline-joined chunks reconstruct the text)
+	assert.equal(chunks.join("\n"), text);
+});
+
+test("a single line longer than max is hard-split", () => {
+	const line = "a".repeat(250);
+	const chunks = split(line, 100);
+
+	assert.deepEqual(chunks, ["a".repeat(100), "a".repeat(100), "a".repeat(50)]);
+});
+
+test("does not split when exactly at the limit", () => {
+	const text = "a".repeat(100);
+	
+	assert.deepEqual(split(text, 100), [text]);
+});

package/src/index.ts

@@ -0,0 +1,74 @@
+import type { Context, Message, Plugin } from "@yaebal/core";
+
+/** telegram's per-message text limit. */
+export const MAX_MESSAGE_LENGTH = 4096;
+
+/**
+ * split `text` into chunks no longer than `max`, preferring to break on newlines.
+ * a single line longer than `max` is hard-split. pure — exported for testing.
+ */
+export function split(text: string, max = MAX_MESSAGE_LENGTH): string[] {
+	if (text.length <= max) return [text];
+	const chunks: string[] = [];
+
+	let current = "";
+	const flush = () => {
+		if (current.length > 0) {
+			chunks.push(current);
+			current = "";
+		}
+	};
+
+	for (const line of text.split("\n")) {
+		if (line.length > max) {
+			flush();
+			for (let i = 0; i < line.length; i += max) chunks.push(line.slice(i, i + max));
+
+			continue;
+		}
+
+		const candidate = current.length > 0 ? `${current}\n${line}` : line;
+
+		if (candidate.length > max) {
+			flush();
+			current = line;
+		} else {
+			current = candidate;
+		}
+	}
+
+	flush();
+	return chunks;
+}
+
+export interface SplitControl {
+	/** send `text`, automatically split into telegram-sized chunks. */
+	sendLong(text: string, extra?: Record<string, unknown>): Promise<Message[]>;
+	/** reply with `text`, automatically split. */
+	replyLong(text: string, extra?: Record<string, unknown>): Promise<Message[]>;
+}
+
+/** adds `ctx.sendLong` / `ctx.replyLong` that split overlong text across messages. */
+export function splitter(max = MAX_MESSAGE_LENGTH): Plugin<Context, SplitControl> {
+	return (composer) =>
+		composer.derive((ctx) => {
+			const control: SplitControl = {
+				async sendLong(text, extra) {
+					const out: Message[] = [];
+
+					for (const part of split(text, max)) out.push(await ctx.send(part, extra));
+
+					return out;
+				},
+				async replyLong(text, extra) {
+					const out: Message[] = [];
+
+					for (const part of split(text, max)) out.push(await ctx.reply(part, extra));
+
+					return out;
+				},
+			};
+			
+			return control;
+		});
+}