@neontechspace/fluxerly 1000.0.0-nightly.12

package/dist/testing.d.ts

@@ -0,0 +1,258 @@
+/**
+ * Test Fluxer bots built with the default API without a network, a token or a Fluxer account.
+ * Import from @neontechspace/fluxerly/testing in application tests
+ *
+ * @example
+ * ```ts
+ * import assert from "node:assert/strict"
+ * import { createTestClient } from "@neontechspace/fluxerly/testing"
+ *
+ * await using test = createTestClient()
+ * const replies = test.rest.respond("POST /channels/:id/messages", { body: test.fixtures.message({ content: "Pong!" }) })
+ * test.client.on("messageCreate", (message) =>
+ *     message.content === "!ping" ? test.client.messages.reply(message, { content: "Pong!" }) : undefined,
+ * )
+ * await test.ready()
+ * test.emit("MESSAGE_CREATE", test.fixtures.message({ content: "!ping" }))
+ * // Handlers run after emit returns, so wait for the reply before asserting on it
+ * const request = await replies.next()
+ * assert.equal((request.body as { content?: unknown }).content, "Pong!")
+ *
+ * // A message the bot ignores sends nothing, which idle confirms without a fixed sleep
+ * test.emit("MESSAGE_CREATE", test.fixtures.message({ content: "hello" }))
+ * await test.idle()
+ * assert.equal(replies.requests().length, 1)
+ * ```
+ *
+ * @remarks
+ * A test client is a real client from createClient whose HTTP and WebSocket traffic goes to an in-memory transport
+ * through the transport option. Events therefore pass through the SDK's own decoders, caches, handlers and logging.
+ * The fake gateway speaks protocol v1: It sends HELLO, answers Identify with READY and Resume with RESUMED, acknowledges
+ * heartbeats and delivers emitted dispatches with increasing sequence numbers. The fake HTTP side serves hosted Fluxer's
+ * discovery document, with presigned uploads off so attachments arrive as one multipart request, answers requests from
+ * registered responses and records every request without its Authorization header.
+ * Message sends and edits without a registered response receive an echoed bot message, and other unmatched requests
+ * receive a Fluxer-shaped 404 and a testing.unmatchedRequest Warn record.
+ * Waits such as idle and TestRoute.next have no deadline unless timeoutMs is passed, so the test runner's timeout
+ * bounds a test that hangs.
+ * Log records go to logs() and to any sinks in the logging option instead of the console.
+ * Shutdown stops the client and closes the transport, leaving no sockets, timers or listeners behind, and rejects when
+ * a handler or command failed without an onError hook and the test did not read that failure from failures()
+ *
+ * @packageDocumentation
+ */
+import "./internal/node-version.js";
+import type { ClientCounters, LogRecord } from "./logging.js";
+import type { ClientOptions, OperationOptions } from "./client.js";
+import type { Message, MessageCore, MessageFields, SelectedMessage } from "./messages.js";
+import { type Client } from "./api/default/client.js";
+import { type BotOptions } from "./api/default/bot.js";
+import type { CommandArgumentSchema } from "./command-arguments.js";
+import type { TestDisconnectOptions, TestEmitOptions, TestGatewayCommand, TestRequest, TestRest, TestSayOptions, TestSettings, TestWaitOptions } from "./internal/testing/types.js";
+import type { Fixtures, WireMessage } from "./internal/testing/fixtures.js";
+export { createFixtures, fixtures, fixtureToken, type Fixtures, type WireChannel, type WireForumChannel, type WireGuild, type WireGuildCreate, type WireGuildCreateOverrides, type WireMember, type WireMessage, type WireOverrides, type WireRole, type WireThread, type WireUser, } from "./internal/testing/fixtures.js";
+export type { TestRequest, TestRequestFile, TestRequestMatcher, TestResponder, TestResponse, TestRest, TestRoute, } from "./internal/testing/types.js";
+export type { TestDisconnectOptions, TestEmitOptions, TestGatewayCommand, TestSayOptions, TestSettings, TestWaitOptions, } from "./internal/testing/types.js";
+export { TestTimeoutError, UnhandledTestFailuresError } from "./internal/testing/errors.js";
+/**
+ * Options for createTestClient: Every createClient option except token, transport and instance, plus test settings.
+ * The token defaults to the fixture token, the transport is always the in-memory test transport and the instance is
+ * always hosted Fluxer served from memory
+ *
+ * @category Testing
+ */
+export type TestClientOptions<F extends MessageFields | undefined = undefined> = Omit<ClientOptions<F>, "token" | "transport" | "instance"> & TestSettings;
+/**
+ * A real default-API client connected to an in-memory Fluxer, with controls for driving and inspecting it.
+ * Controls throw ConfigurationError for misuse, such as emitting before ready, and ClientClosedError after shutdown
+ *
+ * @category Testing
+ */
+export interface TestClient<M extends MessageCore = Message> extends AsyncDisposable {
+    /** The client under test, created with createClient. Use it exactly as in the application */
+    readonly client: Client<M>;
+    /** A fixture set of its own, whose IDs do not depend on other tests. READY reports its botUser() by default */
+    readonly fixtures: Fixtures;
+    /** Register the HTTP responses the fake Fluxer API returns */
+    readonly rest: TestRest;
+    /**
+     * Connect the client to the test gateway and resolve once every shard it owns is READY, like client.connect.
+     * Calling it again while connected resolves without opening another socket. With gateway.ignoredEvents set to "auto",
+     * register handlers before this call, because Identify chooses the session's filtering from those registrations.
+     * The promise rejects with the connect failure, such as ConnectionError when a handler closed the connection,
+     * so a failed start fails the test
+     */
+    ready(options?: OperationOptions): Promise<void>;
+    /**
+     * Deliver one gateway dispatch to a connected shard synchronously, with the next sequence number.
+     * The type is the Fluxer wire dispatch name, such as MESSAGE_CREATE or GUILD_MEMBER_ADD, and the payload is the wire
+     * body in snake_case, so it passes through the SDK's real decoders, cache updates and handlers.
+     * Handlers run afterwards on their own schedule. Register client.waitFor before emitting to await delivery.
+     * Unknown types are delivered too unless explicitly suppressed, and malformed payloads follow the client's
+     * gateway.onMalformedDispatch policy.
+     * Throws ConfigurationError without consuming a sequence when the session's Identify filtering would suppress the
+     * dispatch. Suppressed MESSAGE_CREATE still arrives for a direct bot mention, @here or @everyone. Role-only mentions,
+     * direct-message delivery and bot authorship alone do not exempt it. Generated MESSAGE_REACTION_ADD_MANY is gated by
+     * MESSAGE_REACTION_ADD, not its generated name. Register handlers before ready when gateway.ignoredEvents is "auto",
+     * or remove the source type from the explicit list (use [] to disable suppression). Resume keeps the current list.
+     * READY and RESUMED are reserved for the handshake. Throws ConfigurationError before ready or for a shard this
+     * client does not own
+     */
+    emit(type: string, payload: unknown, options?: TestEmitOptions): void;
+    /**
+     * Close one shard's connection from the gateway side with a close code. The SDK then recovers as it would
+     * against Fluxer, resuming with RESUMED for a resumable code, or ends the connection lifetime for a fatal one.
+     * Throws ConfigurationError when that shard is not connected
+     */
+    disconnect(options?: TestDisconnectOptions): void;
+    /** HTTP requests the client sent so far, in order, excluding the discovery bootstrap and without credentials */
+    requests(): readonly TestRequest[];
+    /** Gateway commands the client sent so far, in order, with tokens redacted */
+    commands(): readonly TestGatewayCommand[];
+    /**
+     * Log records the client produced so far, in order, at the logging option's level and categories, default Info.
+     * The records also reach any sinks in the logging option. Nothing is printed to the console
+     */
+    logs(): readonly LogRecord[];
+    /** The client's running totals, the same as client.diagnostics().counters */
+    counters(): ClientCounters;
+    /**
+     * Error records of failures no application code handled so far, in order, such as an event handler, command or
+     * client.schedule task run that threw or returned a failed Result while no onError hook was registered, whether the
+     * error came from the application or from a Fluxer rejection. Assert expected failures here, because
+     * shutdown rejects for unhandled failures that failures() has not returned.
+     * Failures are captured whatever the logging level, categories and deduplication, so each one appears here and
+     * counts for shutdown even when logs() leaves it out
+     */
+    failures(): readonly LogRecord[];
+    /**
+     * Resolve once the client has settled: No event handler or command is running or has a received event waiting for
+     * it, no client.schedule task run is running, no REST request is queued or waiting for its test response, and no new
+     * log record, request or gateway command appeared for a few event loop turns. Use it after emit to assert that the
+     * bot did nothing, or before inspecting results.
+     * Open waits and collectors do not count as work, and onError hooks are not awaited. A scheduled task waiting for its
+     * time does not count either, so advance the clock that drives the client's timers to run it.
+     * Without timeoutMs the wait has no SDK deadline, so the test runner's own timeout ends a test whose client never
+     * settles. With timeoutMs the promise rejects with TestTimeoutError when the client is still busy after it.
+     * It rejects with ClientClosedError after shutdown. Invalid options throw ConfigurationError.
+     * The wait's own timers, including timeoutMs, stay real when a test fakes timers.
+     * The SDK runs on setImmediate, so fake timers must leave it real, otherwise idle rejects with ConfigurationError
+     * instead of settling while no handler can run
+     */
+    idle(options?: TestWaitOptions): Promise<void>;
+    /**
+     * Shut the client down, then close the test transport. Resolves after both finish and can be called again.
+     * Rejects with SdkDefect when client cleanup fails, and otherwise with UnhandledTestFailuresError when application
+     * code failed without a handler and failures() did not return that failure, so a broken handler fails the test.
+     * Each failure is reported once, so a later call resolves.
+     * Disposal with `await using` calls it
+     */
+    shutdown(): Promise<void>;
+}
+/**
+ * Create a real default-API client wired to an in-memory Fluxer for application tests.
+ * Creation opens no connection and starts no timers. Call ready to connect, and shutdown or `await using` to clean up.
+ * The gateway enforces gateway.ignoredEvents, so register handlers before ready when automatic filtering is enabled
+ *
+ * @remarks
+ * Invalid options throw ConfigurationError as createClient does, and supplying transport or instance also throws
+ * ConfigurationError because the test transport owns both. The hint for a misspelled key suggests the closest key a
+ * test client accepts
+ *
+ * @example
+ * ```ts
+ * import { createTestClient } from "@neontechspace/fluxerly/testing"
+ *
+ * export async function greetingTest() {
+ *     await using test = createTestClient({ cache: { members: true } })
+ *     const joined = test.client.waitFor("guildMemberAdd")
+ *     await test.ready()
+ *     test.emit("GUILD_MEMBER_ADD", test.fixtures.member())
+ *     const member = await joined
+ *     return member.isOk() && test.client.members.get(member.value) !== undefined
+ * }
+ * ```
+ *
+ * @category Testing
+ */
+export declare function createTestClient<const F extends MessageFields | undefined = undefined>(options?: TestClientOptions<F>): TestClient<SelectedMessage<F>>;
+/**
+ * Options for createTestBot: The runBot options object of the bot under test, plus test settings.
+ * The signal, processSignals, reportFailure and drainMs settings are accepted and ignored, so the bot's own options object can be
+ * passed unchanged. An undefined token, such as an unset environment variable, uses the fixture token. Transport and
+ * instance belong to the test client
+ *
+ * @category Testing
+ */
+export type TestBotOptions<F extends MessageFields | undefined = undefined, S extends Readonly<Record<string, unknown>> = Readonly<Record<string, CommandArgumentSchema | undefined>>> = Omit<BotOptions<F, S>, "token" | "transport" | "instance"> & Omit<TestSettings, "token"> & {
+    /** Token passed to the client, never sent anywhere. Omit it or pass undefined to use the fixture token */
+    readonly token?: string | undefined;
+};
+/**
+ * A test client running a bot written for runBot, with say to talk to the bot as a user would
+ *
+ * @category Testing
+ */
+export interface TestBot<M extends MessageCore = Message> extends TestClient<M> {
+    /**
+     * Deliver a message with this content from a human user, wait until the bot has settled as idle does, and resolve
+     * with the messages the bot sent meanwhile, in send order, or an empty list when it sent nothing. Call ready first.
+     * Each entry is a message send (POST /channels/:id/messages) in wire shape, built from the request body with the
+     * fields the automatic reply echoes, so it shows what the bot sent even when a rest.respond handler answered.
+     * Edits, reactions and other requests are not included, and remain visible through requests().
+     * The message comes from the fixture set's default human author in its default channel and community, and
+     * options.message replaces any of those wire fields. Like idle, say has no deadline unless options.timeoutMs is
+     * set, then rejects with TestTimeoutError when the bot is still busy after it, and rejects with ClientClosedError
+     * after shutdown. It throws ConfigurationError for content that is not a string, invalid options, before ready and
+     * when gateway filtering would suppress the message, as emit does
+     *
+     * @example
+     * ```ts
+     * import assert from "node:assert/strict"
+     * import { createTestBot } from "@neontechspace/fluxerly/testing"
+     *
+     * await using test = createTestBot({
+     *     commands: { prefix: "!", commands: { ping: { execute: ({ reply }) => reply("Pong!") } } },
+     * })
+     * await test.ready()
+     * const [reply] = await test.say("!ping")
+     * assert.equal(reply?.content, "Pong!")
+     * assert.deepEqual(await test.say("hello"), [])
+     * ```
+     */
+    say(content: string, options?: TestSayOptions): Promise<readonly WireMessage[]>;
+}
+/**
+ * Create a test client that runs a bot written for runBot: Its events, ignoreBots setting, commands and setup callback,
+ * with the same handler contexts, delivery defaults and command router as runBot. Handlers and commands are registered at once,
+ * and ready runs setup before connecting, as runBot does, so a test drives the bot exactly as Fluxer would.
+ * The setup signal aborts when shutdown starts.
+ * It returns the controls of createTestClient plus say, and shutdown or `await using` cleans it up. Automatic gateway
+ * filtering sees the bot's handlers, commands and setup registrations, and emit rejects dispatches that list suppresses
+ *
+ * @remarks
+ * Invalid options throw ConfigurationError, as runBot does, and a commands register callback that throws throws its
+ * ApplicationError. A failed setup rejects ready with ApplicationError whose source is "runBot setup", and setup runs
+ * at most once however often ready is called. The runBot supervision of a stopped subscription does not apply in tests
+ *
+ * @example
+ * ```ts
+ * import assert from "node:assert/strict"
+ * import { createTestBot } from "@neontechspace/fluxerly/testing"
+ *
+ * await using test = createTestBot({
+ *     commands: { prefix: "!", commands: { ping: { execute: ({ reply }) => reply("Pong!") } } },
+ * })
+ * await test.ready()
+ * // The test transport answers the reply with an echoed message, so no rest.respond fixture is needed
+ * const replies = await test.say("!ping")
+ * assert.deepEqual(
+ *     replies.map((message) => message.content),
+ *     ["Pong!"],
+ * )
+ * ```
+ *
+ * @category Testing
+ */
+export declare function createTestBot<const F extends MessageFields | undefined = undefined, const S extends Readonly<Record<string, unknown>> = Readonly<Record<string, CommandArgumentSchema | undefined>>>(options: TestBotOptions<F, S>): TestBot<SelectedMessage<F>>;
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

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

package/dist/testing.js

@@ -0,0 +1,202 @@
+/**
+ * Test Fluxer bots built with the default API without a network, a token or a Fluxer account.
+ * Import from @neontechspace/fluxerly/testing in application tests
+ *
+ * @example
+ * ```ts
+ * import assert from "node:assert/strict"
+ * import { createTestClient } from "@neontechspace/fluxerly/testing"
+ *
+ * await using test = createTestClient()
+ * const replies = test.rest.respond("POST /channels/:id/messages", { body: test.fixtures.message({ content: "Pong!" }) })
+ * test.client.on("messageCreate", (message) =>
+ *     message.content === "!ping" ? test.client.messages.reply(message, { content: "Pong!" }) : undefined,
+ * )
+ * await test.ready()
+ * test.emit("MESSAGE_CREATE", test.fixtures.message({ content: "!ping" }))
+ * // Handlers run after emit returns, so wait for the reply before asserting on it
+ * const request = await replies.next()
+ * assert.equal((request.body as { content?: unknown }).content, "Pong!")
+ *
+ * // A message the bot ignores sends nothing, which idle confirms without a fixed sleep
+ * test.emit("MESSAGE_CREATE", test.fixtures.message({ content: "hello" }))
+ * await test.idle()
+ * assert.equal(replies.requests().length, 1)
+ * ```
+ *
+ * @remarks
+ * A test client is a real client from createClient whose HTTP and WebSocket traffic goes to an in-memory transport
+ * through the transport option. Events therefore pass through the SDK's own decoders, caches, handlers and logging.
+ * The fake gateway speaks protocol v1: It sends HELLO, answers Identify with READY and Resume with RESUMED, acknowledges
+ * heartbeats and delivers emitted dispatches with increasing sequence numbers. The fake HTTP side serves hosted Fluxer's
+ * discovery document, with presigned uploads off so attachments arrive as one multipart request, answers requests from
+ * registered responses and records every request without its Authorization header.
+ * Message sends and edits without a registered response receive an echoed bot message, and other unmatched requests
+ * receive a Fluxer-shaped 404 and a testing.unmatchedRequest Warn record.
+ * Waits such as idle and TestRoute.next have no deadline unless timeoutMs is passed, so the test runner's timeout
+ * bounds a test that hangs.
+ * Log records go to logs() and to any sinks in the logging option instead of the console.
+ * Shutdown stops the client and closes the transport, leaving no sockets, timers or listeners behind, and rejects when
+ * a handler or command failed without an onError hook and the test did not read that failure from failures()
+ *
+ * @packageDocumentation
+ */
+// Checked first, so an unsupported Node.js version fails with a clear message before any other SDK code runs
+import "./internal/node-version.js";
+import { createClient } from "./api/default/client.js";
+import { installTestBot } from "./api/default/bot.js";
+import { clientServices } from "./internal/client-registry.js";
+import { ConfigurationError } from "./errors.js";
+import { checkTestOptionKeys, TestHarness } from "./internal/testing/harness.js";
+import { botOptionKeys } from "./internal/bot-runner.js";
+export { createFixtures, fixtures, fixtureToken, } from "./internal/testing/fixtures.js";
+export { TestTimeoutError, UnhandledTestFailuresError } from "./internal/testing/errors.js";
+/**
+ * Create a real default-API client wired to an in-memory Fluxer for application tests.
+ * Creation opens no connection and starts no timers. Call ready to connect, and shutdown or `await using` to clean up.
+ * The gateway enforces gateway.ignoredEvents, so register handlers before ready when automatic filtering is enabled
+ *
+ * @remarks
+ * Invalid options throw ConfigurationError as createClient does, and supplying transport or instance also throws
+ * ConfigurationError because the test transport owns both. The hint for a misspelled key suggests the closest key a
+ * test client accepts
+ *
+ * @example
+ * ```ts
+ * import { createTestClient } from "@neontechspace/fluxerly/testing"
+ *
+ * export async function greetingTest() {
+ *     await using test = createTestClient({ cache: { members: true } })
+ *     const joined = test.client.waitFor("guildMemberAdd")
+ *     await test.ready()
+ *     test.emit("GUILD_MEMBER_ADD", test.fixtures.member())
+ *     const member = await joined
+ *     return member.isOk() && test.client.members.get(member.value) !== undefined
+ * }
+ * ```
+ *
+ * @category Testing
+ */
+export function createTestClient(options = {}) {
+    return openTestClient(options).test;
+}
+/** The client's work in progress that idle and say wait for, including scheduled task runs and queued handler events */
+function clientWork(client) {
+    return () => {
+        const services = clientServices(client);
+        const handlers = services?.events.drainState();
+        return {
+            diagnostics: client.diagnostics(),
+            runningTasks: services?.tasks.running ?? 0,
+            pendingHandlers: handlers === undefined ? 0 : handlers.running + handlers.waiting,
+        };
+    };
+}
+/** Create a test client together with the harness that createTestBot also drives */
+function openTestClient(options) {
+    const harness = new TestHarness(options);
+    const client = createClient(harness.clientOptions(options));
+    clientServices(client).logging.errorTap = harness.captureError;
+    let closing;
+    const shutdown = async () => {
+        closing ??= (async () => {
+            try {
+                await client.shutdown();
+            }
+            finally {
+                harness.close();
+            }
+        })();
+        await closing;
+        harness.checkFailures();
+    };
+    const test = Object.freeze({
+        client,
+        fixtures: harness.fixtures,
+        rest: Object.freeze({ respond: harness.http.respond.bind(harness.http) }),
+        ready: async (options) => {
+            const connected = await client.connect(options);
+            if (connected.isErr())
+                throw connected.error;
+        },
+        emit: (type, payload, options) => harness.gateway.emit(type, payload, options),
+        disconnect: (options) => harness.gateway.disconnect(options),
+        requests: () => harness.http.requests(),
+        commands: () => harness.gateway.commands(),
+        logs: () => harness.logs(),
+        failures: () => harness.failures(),
+        idle: (options) => harness.idle(clientWork(client), options),
+        counters: () => client.diagnostics().counters,
+        shutdown,
+        [Symbol.asyncDispose]: shutdown,
+    });
+    return { test, harness };
+}
+/**
+ * Create a test client that runs a bot written for runBot: Its events, ignoreBots setting, commands and setup callback,
+ * with the same handler contexts, delivery defaults and command router as runBot. Handlers and commands are registered at once,
+ * and ready runs setup before connecting, as runBot does, so a test drives the bot exactly as Fluxer would.
+ * The setup signal aborts when shutdown starts.
+ * It returns the controls of createTestClient plus say, and shutdown or `await using` cleans it up. Automatic gateway
+ * filtering sees the bot's handlers, commands and setup registrations, and emit rejects dispatches that list suppresses
+ *
+ * @remarks
+ * Invalid options throw ConfigurationError, as runBot does, and a commands register callback that throws throws its
+ * ApplicationError. A failed setup rejects ready with ApplicationError whose source is "runBot setup", and setup runs
+ * at most once however often ready is called. The runBot supervision of a stopped subscription does not apply in tests
+ *
+ * @example
+ * ```ts
+ * import assert from "node:assert/strict"
+ * import { createTestBot } from "@neontechspace/fluxerly/testing"
+ *
+ * await using test = createTestBot({
+ *     commands: { prefix: "!", commands: { ping: { execute: ({ reply }) => reply("Pong!") } } },
+ * })
+ * await test.ready()
+ * // The test transport answers the reply with an echoed message, so no rest.respond fixture is needed
+ * const replies = await test.say("!ping")
+ * assert.deepEqual(
+ *     replies.map((message) => message.content),
+ *     ["Pong!"],
+ * )
+ * ```
+ *
+ * @category Testing
+ */
+export function createTestBot(options) {
+    if (typeof options !== "object" || options === null || Array.isArray(options))
+        throw new ConfigurationError("configuration", "Bot options must be an object");
+    checkTestOptionKeys(options, botOptionKeys);
+    const { events, ignoreBots, commands, setup, token, signal: _signal, processSignals: _processSignals, reportFailure: _reportFailure, drainMs: _drainMs, ...clientOptions } = options;
+    const { test, harness } = openTestClient({
+        ...clientOptions,
+        ...(token === undefined ? {} : { token }),
+    });
+    let runSetup;
+    try {
+        runSetup = installTestBot(test.client, { events, ignoreBots, commands, setup });
+    }
+    catch (error) {
+        // The client owns no socket yet, and its cleanup failure is logged by the client, as runBot does
+        void test
+            .shutdown()
+            .then(undefined, (defect) => clientServices(test.client)?.logging.outputFailure(defect));
+        throw error;
+    }
+    // Shutdown aborts the setup signal before stopping the client, as runBot does when the bot begins stopping
+    const stopping = new AbortController();
+    let setupDone;
+    const ready = async (readyOptions) => {
+        setupDone ??= runSetup(stopping.signal);
+        await setupDone;
+        await test.ready(readyOptions);
+    };
+    const shutdown = () => {
+        stopping.abort();
+        return test.shutdown();
+    };
+    const say = (content, sayOptions) => harness.say(clientWork(test.client), content, sayOptions);
+    return Object.freeze({ ...test, ready, say, shutdown, [Symbol.asyncDispose]: shutdown });
+}
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

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

package/dist/text.d.ts

@@ -0,0 +1,38 @@
+import { type Result } from "neverthrow";
+import { HelperError } from "./helpers.js";
+/**
+ * Choose the largest piece `text.split` may return. Supply a limit explicitly. This helper does not discover a server's message limit
+ *
+ * @category Builders and formatting
+ */
+export interface TextSplitOptions {
+    /** Maximum `string.length` of each piece, a positive safe integer with no default. Most emoji count as two or more units */
+    readonly maxLength: number;
+}
+/**
+ * Methods of the text helper, which splits long strings into bounded pieces
+ *
+ * @category Builders and formatting
+ */
+export type TextHelpers = Readonly<{
+    /**
+     * Split text into a frozen array of pieces, each with `string.length` at most `options.maxLength` UTF-16 units.
+     * Prefer the last newline within a full piece, then the last whitespace, otherwise split a long word.
+     * Whitespace stays in the preceding piece, so joining with an empty separator reconstructs the exact input.
+     * Empty text gives []
+     *
+     * No trimming, prefix or suffix insertion, Markdown repair, message-length lookup or remote request occurs.
+     * The two UTF-16 units of a single Unicode code point stay together.
+     * A visible character made of multiple code points, such as a base character with combining marks or a joined emoji, may still be split.
+     * Throws HelperError for invalid text or options, lone surrogates, or a ceiling too small for a surrogate pair.
+     * Input and returned pieces are application-owned, and result size is proportional to the supplied text
+     */
+    split(content: string, options: TextSplitOptions): readonly string[];
+}>;
+/** Break long text into smaller strings for later sending or display. No message is sent.
+ * The split method returns the pieces directly and throws HelperError for invalid text or options
+ */
+export declare const text: TextHelpers;
+/** Split text with the public split rules, returning invalid input as an Err for SDK callers that map it to their own error */
+export declare function splitText(content: string, options: TextSplitOptions): Result<readonly string[], HelperError>;
+//# sourceMappingURL=text.d.ts.map

package/dist/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../src/text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,EAAE,WAAW,EAAgB,MAAM,cAAc,CAAA;AAExD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC7B,4HAA4H;IAC5H,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC7B;AAED;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;IAC/B;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,SAAS,MAAM,EAAE,CAAA;CACvE,CAAC,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,IAAI,EAAE,WAEjB,CAAA;AAEF,+HAA+H;AAC/H,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAAC,SAAS,MAAM,EAAE,EAAE,WAAW,CAAC,CAiC5G"}

package/dist/text.js

@@ -0,0 +1,46 @@
+import { err, ok } from "neverthrow";
+import { HelperError, valueOrThrow } from "./helpers.js";
+/** Break long text into smaller strings for later sending or display. No message is sent.
+ * The split method returns the pieces directly and throws HelperError for invalid text or options
+ */
+export const text = Object.freeze({
+    split: (content, options) => valueOrThrow(splitText(content, options)),
+});
+/** Split text with the public split rules, returning invalid input as an Err for SDK callers that map it to their own error */
+export function splitText(content, options) {
+    if (typeof options !== "object" ||
+        options === null ||
+        Array.isArray(options) ||
+        Object.keys(options).some((key) => key !== "maxLength") ||
+        !Number.isSafeInteger(options.maxLength) ||
+        options.maxLength <= 0)
+        return err(new HelperError("text.split", "limit"));
+    if (typeof content !== "string" || !content.isWellFormed())
+        return err(new HelperError("text.split", "text"));
+    const chunks = [];
+    for (let start = 0; start < content.length;) {
+        let end = Math.min(start + options.maxLength, content.length);
+        const previous = content.charCodeAt(end - 1);
+        if (end < content.length && previous >= 0xd800 && previous <= 0xdbff)
+            end -= 1;
+        if (end === start)
+            return err(new HelperError("text.split", "limit"));
+        if (end < content.length) {
+            let wordEnd = 0;
+            let lineEnd = 0;
+            for (let index = end - 1; index >= start; index -= 1) {
+                if (content[index] === "\n") {
+                    lineEnd = index + 1;
+                    break;
+                }
+                if (wordEnd === 0 && /\s/u.test(content[index]))
+                    wordEnd = index + 1;
+            }
+            end = lineEnd || wordEnd || end;
+        }
+        chunks.push(content.slice(start, end));
+        start = end;
+    }
+    return ok(Object.freeze(chunks));
+}
+//# sourceMappingURL=text.js.map

package/dist/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../src/text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,EAAE,EAAe,MAAM,YAAY,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAiCxD;;GAEG;AACH,MAAM,CAAC,MAAM,IAAI,GAAgB,MAAM,CAAC,MAAM,CAAC;IAC3C,KAAK,EAAE,CAAC,OAAe,EAAE,OAAyB,EAAqB,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;CACtH,CAAC,CAAA;AAEF,+HAA+H;AAC/H,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,OAAyB;IAChE,IACI,OAAO,OAAO,KAAK,QAAQ;QAC3B,OAAO,KAAK,IAAI;QAChB,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QACtB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,WAAW,CAAC;QACvD,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,SAAS,CAAC;QACxC,OAAO,CAAC,SAAS,IAAI,CAAC;QAEtB,OAAO,GAAG,CAAC,IAAI,WAAW,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAA;IACtD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE;QAAE,OAAO,GAAG,CAAC,IAAI,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAA;IAC7G,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC;QAC1C,IAAI,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;QAC7D,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,CAAA;QAC5C,IAAI,GAAG,GAAG,OAAO,CAAC,MAAM,IAAI,QAAQ,IAAI,MAAM,IAAI,QAAQ,IAAI,MAAM;YAAE,GAAG,IAAI,CAAC,CAAA;QAC9E,IAAI,GAAG,KAAK,KAAK;YAAE,OAAO,GAAG,CAAC,IAAI,WAAW,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAA;QACrE,IAAI,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YACvB,IAAI,OAAO,GAAG,CAAC,CAAA;YACf,IAAI,OAAO,GAAG,CAAC,CAAA;YACf,KAAK,IAAI,KAAK,GAAG,GAAG,GAAG,CAAC,EAAE,KAAK,IAAI,KAAK,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;gBACnD,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;oBAC1B,OAAO,GAAG,KAAK,GAAG,CAAC,CAAA;oBACnB,MAAK;gBACT,CAAC;gBACD,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAE,CAAC;oBAAE,OAAO,GAAG,KAAK,GAAG,CAAC,CAAA;YACzE,CAAC;YACD,GAAG,GAAG,OAAO,IAAI,OAAO,IAAI,GAAG,CAAA;QACnC,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAA;QACtC,KAAK,GAAG,GAAG,CAAA;IACf,CAAC;IACD,OAAO,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAA;AACpC,CAAC"}