@neontechspace/fluxerly 1000.0.0-nightly.12

package/dist/api/default/webhook-client.d.ts

@@ -0,0 +1,149 @@
+import { type IncomingWebhook, type WebhookTokenEdit, type WebhookMessageInput, type WebhookMessageEdit, type WebhookClientOptions, type WebhookOperationFailure, type DefaultWebhookMessageOperationOptions } from "#sdk/webhooks";
+import { ResultAsync } from "neverthrow";
+import { CancelledError, ConfigurationError } from "#sdk/errors";
+import type { Message, DefaultMessageOperationOptions } from "#sdk/messages";
+import { type Instance } from "./instance.js";
+/**
+ * Send and manage messages with one incoming webhook's token, without a bot token or gateway.
+ * Follower webhooks have no exposed token and Fluxer rejects their token-authenticated operations with UNKNOWN_WEBHOOK.
+ * Create this with createWebhookClient and always await shutdown when finished
+ *
+ * @remarks
+ * No cache or persistent token store is created, and other clients' caches are not updated.
+ * Calls start immediately and return ResultAsync for expected successes and failures.
+ * The default 30,000 ms total deadline includes capacity, rate-limit, retry and HTTP waits.
+ * Confirmed HTTP 429 responses use this client's shared rate-limit state as described on Client.
+ * Abort cancels only the operation and waits for request and body cleanup, without reversing remote changes.
+ * Errors include safe categories and status, not token-bearing paths or response bodies.
+ * Successful JSON is capped at 16 MiB before parsing, not total memory.
+ * A failed response after sending a write leaves an uncertain result and is not retried automatically.
+ * Unexpected SDK or cleanup failures reject with SdkDefect.
+ * Cleanup failure stops retries and keeps safe details of any accompanying operation failure or cancellation
+ *
+ * @category Invites and webhooks
+ */
+export interface WebhookClient extends AsyncDisposable {
+    /**
+     * The webhook's decimal ID, without its token or a token-bearing URL
+     */
+    readonly id: string;
+    /**
+     * Resolve this webhook client's selected instance and get pure URL helpers for it
+     */
+    readonly instance: Instance;
+    /**
+     * Fetch this incoming webhook's current metadata using its token, not bot authentication.
+     * Creator and private fields are not retained
+     */
+    fetch(options?: DefaultMessageOperationOptions): ResultAsync<IncomingWebhook, WebhookOperationFailure | CancelledError | ConfigurationError>;
+    /**
+     * Change this webhook's name or avatar using its token and return metadata without credentials.
+     * To move it to another channel, use a bot client's webhooks.edit.
+     * A failed or cancelled write can still have applied.
+     * This method does not close the client
+     */
+    edit(input: WebhookTokenEdit, options?: DefaultMessageOperationOptions): ResultAsync<IncomingWebhook, WebhookOperationFailure | CancelledError | ConfigurationError>;
+    /**
+     * Delete this webhook remotely using its token, succeeding after HTTP 204.
+     * This does not close the client or release its local credential reference.
+     * Later requests normally fail with notFound because the token was revoked.
+     * Call shutdown separately to release the client's local resources
+     */
+    delete(options?: DefaultMessageOperationOptions): ResultAsync<void, WebhookOperationFailure | CancelledError | ConfigurationError>;
+    /**
+     * Send a webhook message and return the created message after Fluxer's HTTP response.
+     * A plain string sends only that text, as shorthand for `{ content }`.
+     * The SDK uses wait=true, and mentions are disabled by default.
+     * A supplied nonce requests best-effort duplicate suppression for five minutes, not exactly-once delivery.
+     * Without a nonce, none is sent unless a forward source supplies one, and a nonce on both the message and its forward source fails before dispatch.
+     * Reply references can include files.
+     * Forward references preserve only the source snapshot and reject new content or uploads
+     *
+     * Set threadId to post into an existing thread. In a forum or media channel, set threadName, with optional
+     * appliedTagIds, to start a new post instead. The result is then the post's first message, whose channelId is the
+     * new post's ID. See WebhookMessageInput for the rules that the SDK checks before dispatch
+     *
+     * Each attachment supplies data bytes, a sized Blob or File source, or a finite stream with its exact size.
+     * Metadata and data bytes are copied when execution starts, before waiting.
+     * File and stream sources are read when the multipart upload begins, without copying or spooling.
+     * Keep file data stable, and supply a fresh stream for each operation because a stream is consumed at most once and must deliver exactly its declared size.
+     * Cleanup cancels unfinished readers and awaits lock release, without closing caller paths or FileHandles.
+     * Multipart file uploads are streamed with a maximum of 50 MiB per file and share the configured upload-byte budget.
+     * An attachment:// image or thumbnail URL must match one new upload whose filename maps to an image or video MIME type.
+     * The flags input accepts only MessageFlags.SuppressEmbeds and MessageFlags.SuppressNotifications.
+     * Crossposted, IsCrosspost and SourceMessageDeleted are server-managed.
+     * Those bits and VoiceMessage fail locally before dispatch
+     *
+     * A failure with an unknown outcome can leave the message posted and is never replayed automatically.
+     * A confirmed inline HTTP 429 can replay copied data bytes, but file and stream inputs fail with rateLimit without being reopened or reread
+     */
+    send(input: WebhookMessageInput | string, options?: DefaultMessageOperationOptions): ResultAsync<Message, WebhookOperationFailure | CancelledError | ConfigurationError>;
+    /**
+     * Fetch a message authored by this webhook in its current channel, using a decimal message ID.
+     * For a message in a thread, including a forum post, set options.threadId to the thread's ID.
+     * Eligible transient read failures have bounded retries
+     */
+    fetchMessage(messageId: string, options?: DefaultWebhookMessageOperationOptions): ResultAsync<Message, WebhookOperationFailure | CancelledError | ConfigurationError>;
+    /**
+     * Change this webhook's message and return its updated snapshot.
+     * A plain string replaces only the text, as shorthand for `{ content }`.
+     * Omitted fields stay unchanged.
+     * Mentions default off and attachments cannot be replaced.
+     * A flags-only edit replaces only MessageFlags.SuppressEmbeds and MessageFlags.SuppressNotifications, and 0 clears them.
+     * Crossposted, IsCrosspost and SourceMessageDeleted are server-managed.
+     * Those bits and VoiceMessage fail locally before dispatch.
+     * Embed input cannot resolve existing file references.
+     * For a message in a thread, including a forum post, set options.threadId to the thread's ID
+     */
+    editMessage(messageId: string, input: WebhookMessageEdit | string, options?: DefaultWebhookMessageOperationOptions): ResultAsync<Message, WebhookOperationFailure | CancelledError | ConfigurationError>;
+    /**
+     * Delete this webhook's message, succeeding with no value after HTTP 204.
+     * For a message in a thread, including a forum post, set options.threadId to the thread's ID.
+     * Success does not prove the message previously existed.
+     * A failure with an unknown outcome can leave the message deleted
+     */
+    deleteMessage(messageId: string, options?: DefaultWebhookMessageOperationOptions): ResultAsync<void, WebhookOperationFailure | CancelledError | ConfigurationError>;
+    /**
+     * Permanently stop this local client, reject new work, cancel active work and await transport cleanup.
+     * The client's token reference is released, but the remote webhook and caller-held credentials remain.
+     * Concurrent calls wait for the same pending cleanup.
+     * No expected failure is returned
+     *
+     * @remarks
+     * Unexpected cleanup failures reject with SdkDefect
+     */
+    shutdown(): ResultAsync<void, never>;
+    /**
+     * Shut down this client and wait for cleanup, as `await using` does at the end of a block.
+     * Unexpected cleanup failures reject with SdkDefect, as shutdown does
+     */
+    [Symbol.asyncDispose](): Promise<void>;
+}
+/**
+ * Create a client that uses one webhook's token rather than bot authentication.
+ * Pass { id, token } or the credentials returned by a bot client's webhooks.create.
+ * Creation is synchronous, validates locally and makes no request.
+ * It copies the credential into a separate reference that hides the token when displayed.
+ * Reuse one client per credential to share its request limits and rate waits.
+ * The default instance is hosted Fluxer.
+ * A self-hosted instance can be selected explicitly.
+ * No token store or gateway is created.
+ * Always await shutdown when finished, or declare the client with `await using` as in the example.
+ * Invalid settings throw ConfigurationError.
+ * Unexpected creation failures throw SdkDefect. A throwing option getter or revealToken uses code application.defect
+ * with the thrown value as its cause
+ *
+ * @example
+ * ```ts
+ * import { createWebhookClient } from "@neontechspace/fluxerly"
+ * export async function webhookExample(id: string, token: string) {
+ *     await using webhook = createWebhookClient({ id, token })
+ *     const message = await webhook.send({ content: "Deploying…" })
+ *     return message.isErr() ? message : await webhook.editMessage(message.value.id, { content: "Deployed" })
+ * }
+ * ```
+ *
+ * @category Invites and webhooks
+ */
+export declare function createWebhookClient(options: WebhookClientOptions): WebhookClient;
+//# sourceMappingURL=webhook-client.d.ts.map

package/dist/api/default/webhook-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-client.d.ts","sourceRoot":"","sources":["../../../src/api/default/webhook-client.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,qCAAqC,EAC7C,MAAM,eAAe,CAAA;AAatB,OAAO,EAAM,WAAW,EAAE,MAAM,YAAY,CAAA;AAE5C,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAa,MAAM,aAAa,CAAA;AAC3E,OAAO,KAAK,EAAE,OAAO,EAAE,8BAA8B,EAAE,MAAM,eAAe,CAAA;AAC5E,OAAO,EAAE,KAAK,QAAQ,EAAsC,MAAM,eAAe,CAAA;AAGjF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,aAAc,SAAQ,eAAe;IAClD;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B;;;OAGG;IACH,KAAK,CACD,OAAO,CAAC,EAAE,8BAA8B,GACzC,WAAW,CAAC,eAAe,EAAE,uBAAuB,GAAG,cAAc,GAAG,kBAAkB,CAAC,CAAA;IAC9F;;;;;OAKG;IACH,IAAI,CACA,KAAK,EAAE,gBAAgB,EACvB,OAAO,CAAC,EAAE,8BAA8B,GACzC,WAAW,CAAC,eAAe,EAAE,uBAAuB,GAAG,cAAc,GAAG,kBAAkB,CAAC,CAAA;IAC9F;;;;;OAKG;IACH,MAAM,CACF,OAAO,CAAC,EAAE,8BAA8B,GACzC,WAAW,CAAC,IAAI,EAAE,uBAAuB,GAAG,cAAc,GAAG,kBAAkB,CAAC,CAAA;IACnF;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,IAAI,CACA,KAAK,EAAE,mBAAmB,GAAG,MAAM,EACnC,OAAO,CAAC,EAAE,8BAA8B,GACzC,WAAW,CAAC,OAAO,EAAE,uBAAuB,GAAG,cAAc,GAAG,kBAAkB,CAAC,CAAA;IACtF;;;;OAIG;IACH,YAAY,CACR,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,qCAAqC,GAChD,WAAW,CAAC,OAAO,EAAE,uBAAuB,GAAG,cAAc,GAAG,kBAAkB,CAAC,CAAA;IACtF;;;;;;;;;;OAUG;IACH,WAAW,CACP,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,kBAAkB,GAAG,MAAM,EAClC,OAAO,CAAC,EAAE,qCAAqC,GAChD,WAAW,CAAC,OAAO,EAAE,uBAAuB,GAAG,cAAc,GAAG,kBAAkB,CAAC,CAAA;IACtF;;;;;OAKG;IACH,aAAa,CACT,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,qCAAqC,GAChD,WAAW,CAAC,IAAI,EAAE,uBAAuB,GAAG,cAAc,GAAG,kBAAkB,CAAC,CAAA;IACnF;;;;;;;;OAQG;IACH,QAAQ,IAAI,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IACpC;;;OAGG;IACH,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CA0EhF"}

package/dist/api/default/webhook-client.js

@@ -0,0 +1,69 @@
+import {} from "#sdk/webhooks";
+import { makeWebhookClient, webhookTokenFetch, webhookTokenEdit, webhookTokenDelete, webhookSend, webhookMessageFetch, webhookMessageEdit, webhookMessageDelete, } from "#sdk/internal/webhooks";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import { ok, ResultAsync } from "neverthrow";
+import { causeReasons } from "#sdk/internal/defects";
+import { CancelledError, ConfigurationError, SdkDefect } from "#sdk/errors";
+import {} from "./instance.js";
+import { executeOperation, fromExit } from "#sdk/internal/binding/execute";
+/**
+ * Create a client that uses one webhook's token rather than bot authentication.
+ * Pass { id, token } or the credentials returned by a bot client's webhooks.create.
+ * Creation is synchronous, validates locally and makes no request.
+ * It copies the credential into a separate reference that hides the token when displayed.
+ * Reuse one client per credential to share its request limits and rate waits.
+ * The default instance is hosted Fluxer.
+ * A self-hosted instance can be selected explicitly.
+ * No token store or gateway is created.
+ * Always await shutdown when finished, or declare the client with `await using` as in the example.
+ * Invalid settings throw ConfigurationError.
+ * Unexpected creation failures throw SdkDefect. A throwing option getter or revealToken uses code application.defect
+ * with the thrown value as its cause
+ *
+ * @example
+ * ```ts
+ * import { createWebhookClient } from "@neontechspace/fluxerly"
+ * export async function webhookExample(id: string, token: string) {
+ *     await using webhook = createWebhookClient({ id, token })
+ *     const message = await webhook.send({ content: "Deploying…" })
+ *     return message.isErr() ? message : await webhook.editMessage(message.value.id, { content: "Deployed" })
+ * }
+ * ```
+ *
+ * @category Invites and webhooks
+ */
+export function createWebhookClient(options) {
+    const result = fromExit(Effect.runSyncExit(makeWebhookClient(options)), "createWebhookClient");
+    if (result.isErr()) {
+        if (result.error instanceof ConfigurationError)
+            throw result.error;
+        throw new SdkDefect("createWebhookClient", [{ kind: "Failure", failure: result.error }]);
+    }
+    const owner = result.value;
+    const execute = executeOperation;
+    const shutdown = () => new ResultAsync(Effect.runPromiseExit(owner.shutdown()).then((exit) => {
+        const result = fromExit(exit, "shutdown");
+        if (result.isErr())
+            throw new SdkDefect("shutdown", Exit.isFailure(exit) ? causeReasons(exit.cause) : []);
+        return ok(undefined);
+    }));
+    return Object.freeze({
+        id: owner.id,
+        instance: Object.freeze({
+            resolve: (options) => execute(owner.instance.resolveInfo(options), "instance.resolve", options),
+        }),
+        fetch: (options) => execute(owner.run("webhooks.fetchToken", () => webhookTokenFetch(owner.id), options), "webhooks.fetchToken", options),
+        edit: (input, options) => execute(owner.run("webhooks.editToken", () => webhookTokenEdit(owner.id, input), options), "webhooks.editToken", options),
+        delete: (options) => execute(owner.run("webhooks.deleteToken", () => webhookTokenDelete(owner.id), options), "webhooks.deleteToken", options),
+        send: (input, options) => execute(owner.run("webhooks.send", () => webhookSend(owner.id, input), options), "webhooks.send", options),
+        fetchMessage: (id, options) => execute(owner.run("webhooks.fetchMessage", () => webhookMessageFetch(owner.id, id, options), options), "webhooks.fetchMessage", options),
+        editMessage: (id, input, options) => execute(owner.run("webhooks.editMessage", () => webhookMessageEdit(owner.id, id, input, options), options), "webhooks.editMessage", options),
+        deleteMessage: (id, options) => execute(owner.run("webhooks.deleteMessage", () => webhookMessageDelete(owner.id, id, options), options), "webhooks.deleteMessage", options),
+        shutdown,
+        [Symbol.asyncDispose]: async () => {
+            await shutdown();
+        },
+    });
+}
+//# sourceMappingURL=webhook-client.js.map

package/dist/api/default/webhook-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-client.js","sourceRoot":"","sources":["../../../src/api/default/webhook-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAQN,MAAM,eAAe,CAAA;AACtB,OAAO,EACH,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,GACvB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAA;AACnC,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACpD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE3E,OAAO,EAAqD,MAAM,eAAe,CAAA;AACjF,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAA;AA2I1E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAA6B;IAC7D,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,EAAE,qBAAqB,CAAC,CAAA;IAC9F,IAAI,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;QACjB,IAAI,MAAM,CAAC,KAAK,YAAY,kBAAkB;YAAE,MAAM,MAAM,CAAC,KAAK,CAAA;QAClE,MAAM,IAAI,SAAS,CAAC,qBAAqB,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;IAC5F,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAA;IAC1B,MAAM,OAAO,GAAG,gBAAgB,CAAA;IAChC,MAAM,QAAQ,GAAG,GAAG,EAAE,CAClB,IAAI,WAAW,CACX,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QAClD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;QACzC,IAAI,MAAM,CAAC,KAAK,EAAE;YACd,MAAM,IAAI,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;QACzF,OAAO,EAAE,CAAC,SAAS,CAAC,CAAA;IACxB,CAAC,CAAC,CACL,CAAA;IACL,OAAO,MAAM,CAAC,MAAM,CAAC;QACjB,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC;YACpB,OAAO,EAAE,CAAC,OAAuC,EAAE,EAAE,CACjD,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,kBAAkB,EAAE,OAAO,CAAC;SAChF,CAAC;QACF,KAAK,EAAE,CAAC,OAAwC,EAAE,EAAE,CAChD,OAAO,CACH,KAAK,CAAC,GAAG,CAAC,qBAAqB,EAAE,GAAG,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,EAC5E,qBAAqB,EACrB,OAAO,CACV;QACL,IAAI,EAAE,CAAC,KAAuB,EAAE,OAAwC,EAAE,EAAE,CACxE,OAAO,CACH,KAAK,CAAC,GAAG,CAAC,oBAAoB,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,EACjF,oBAAoB,EACpB,OAAO,CACV;QACL,MAAM,EAAE,CAAC,OAAwC,EAAE,EAAE,CACjD,OAAO,CACH,KAAK,CAAC,GAAG,CAAC,sBAAsB,EAAE,GAAG,EAAE,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,EAC9E,sBAAsB,EACtB,OAAO,CACV;QACL,IAAI,EAAE,CAAC,KAAmC,EAAE,OAAwC,EAAE,EAAE,CACpF,OAAO,CACH,KAAK,CAAC,GAAG,CAAC,eAAe,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,EACvE,eAAe,EACf,OAAO,CACV;QACL,YAAY,EAAE,CAAC,EAAU,EAAE,OAA+C,EAAE,EAAE,CAC1E,OAAO,CACH,KAAK,CAAC,GAAG,CAAC,uBAAuB,EAAE,GAAG,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAC7F,uBAAuB,EACvB,OAAO,CACV;QACL,WAAW,EAAE,CACT,EAAU,EACV,KAAkC,EAClC,OAA+C,EACjD,EAAE,CACA,OAAO,CACH,KAAK,CAAC,GAAG,CAAC,sBAAsB,EAAE,GAAG,EAAE,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAClG,sBAAsB,EACtB,OAAO,CACV;QACL,aAAa,EAAE,CAAC,EAAU,EAAE,OAA+C,EAAE,EAAE,CAC3E,OAAO,CACH,KAAK,CAAC,GAAG,CAAC,wBAAwB,EAAE,GAAG,EAAE,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAC/F,wBAAwB,EACxB,OAAO,CACV;QACL,QAAQ;QACR,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,KAAK,IAAI,EAAE;YAC9B,MAAM,QAAQ,EAAE,CAAA;QACpB,CAAC;KACJ,CAAC,CAAA;AACN,CAAC"}

package/dist/api/default/webhooks.d.ts

@@ -0,0 +1,62 @@
+import type { Webhook, CreatedWebhook, WebhookCreate, WebhookEdit, WebhookOperationFailure, DefaultWebhookOperationOptions } from "#sdk/webhooks";
+import type { ResultAsync } from "neverthrow";
+import type { CancelledError, ConfigurationError } from "#sdk/errors";
+/**
+ * Manage webhooks with this bot's credentials, without connecting the gateway.
+ * Use createWebhookClient for a separate client that sends using a webhook's own token.
+ * Metadata excludes tokens.
+ * There is no webhook cache or hidden credential storage.
+ * The default total deadline, rest.defaultTimeoutMs (30,000 ms unless configured), includes capacity, rate-limit and retry waits.
+ * Eligible reads have bounded retries.
+ * Writes retry only confirmed rate-limit rejection.
+ * Success JSON is limited to 16 MiB before parsing, not total memory.
+ * Malformed or larger successes return reason response.
+ * After dispatch, a failed response can leave the write applied and is not retried automatically.
+ * Abort returns CancelledError after cleanup.
+ * Unexpected failures reject with SdkDefect.
+ * Client shutdown rejects new work and waits for active request cleanup.
+ * Separate clients do not coordinate rate limits
+ *
+ * @category Invites and webhooks
+ */
+export interface Webhooks {
+    /**
+     * Create an incoming webhook in a text, voice or announcement channel using the bot's permissions.
+     * The result separates metadata from redacted credentials, which expose the token only through revealToken.
+     * Credentials passed to createWebhookClient must remain private.
+     * An unknown outcome may have left the webhook created
+     */
+    create(channelId: string, input: WebhookCreate, options?: DefaultWebhookOperationOptions): ResultAsync<CreatedWebhook, WebhookOperationFailure | CancelledError | ConfigurationError>;
+    /**
+     * Fetch incoming, follower or unknown-kind metadata by decimal ID, discarding any returned token.
+     * Follower sources are present only while they exist and the original creator can view them.
+     * Missing source metadata does not prove deletion. A missing webhook fails with reason notFound
+     */
+    fetch(id: string, options?: DefaultWebhookOperationOptions): ResultAsync<Webhook, WebhookOperationFailure | CancelledError | ConfigurationError>;
+    /**
+     * List the channel's accessible incoming, follower and unknown-kind webhook metadata without pagination.
+     * No tokens are retained and no webhook cache is filled
+     */
+    fetchForChannel(channelId: string, options?: DefaultWebhookOperationOptions): ResultAsync<readonly Webhook[], WebhookOperationFailure | CancelledError | ConfigurationError>;
+    /**
+     * List the community's accessible incoming, follower and unknown-kind webhook metadata.
+     * Fluxer permissions determine visibility.
+     * Concurrent changes mean this is not a stable snapshot
+     */
+    fetchForGuild(guildId: string, options?: DefaultWebhookOperationOptions): ResultAsync<readonly Webhook[], WebhookOperationFailure | CancelledError | ConfigurationError>;
+    /**
+     * Change the supplied incoming or follower webhook settings, including its destination channel.
+     * Followers can be renamed or moved to a text channel in the same community, but an avatar change fails
+     * with field avatar and Fluxer code INVALID_FORMAT. Incoming webhooks allow text, voice or announcement destinations.
+     * Moving emits Webhooks Update for the old and new channel. The SDK does not synthesize those events.
+     * Returned metadata excludes credentials. A failed response does not guarantee the changes were rolled back
+     */
+    edit(id: string, input: WebhookEdit, options?: DefaultWebhookOperationOptions): ResultAsync<Webhook, WebhookOperationFailure | CancelledError | ConfigurationError>;
+    /**
+     * Delete an incoming webhook and revoke its credential, or delete a follower webhook to unfollow its source.
+     * Existing webhook messages remain. Fluxer emits Webhooks Update for the destination channel.
+     * The SDK does not synthesize that event. A failure does not restore a deleted follow or revoked credential
+     */
+    delete(id: string, options?: DefaultWebhookOperationOptions): ResultAsync<void, WebhookOperationFailure | CancelledError | ConfigurationError>;
+}
+//# sourceMappingURL=webhooks.d.ts.map

package/dist/api/default/webhooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../../src/api/default/webhooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,OAAO,EACP,cAAc,EACd,aAAa,EACb,WAAW,EACX,uBAAuB,EACvB,8BAA8B,EACjC,MAAM,eAAe,CAAA;AACtB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAErE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,QAAQ;IACrB;;;;;OAKG;IACH,MAAM,CACF,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE,8BAA8B,GACzC,WAAW,CAAC,cAAc,EAAE,uBAAuB,GAAG,cAAc,GAAG,kBAAkB,CAAC,CAAA;IAC7F;;;;OAIG;IACH,KAAK,CACD,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,8BAA8B,GACzC,WAAW,CAAC,OAAO,EAAE,uBAAuB,GAAG,cAAc,GAAG,kBAAkB,CAAC,CAAA;IACtF;;;OAGG;IACH,eAAe,CACX,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,8BAA8B,GACzC,WAAW,CAAC,SAAS,OAAO,EAAE,EAAE,uBAAuB,GAAG,cAAc,GAAG,kBAAkB,CAAC,CAAA;IACjG;;;;OAIG;IACH,aAAa,CACT,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,8BAA8B,GACzC,WAAW,CAAC,SAAS,OAAO,EAAE,EAAE,uBAAuB,GAAG,cAAc,GAAG,kBAAkB,CAAC,CAAA;IACjG;;;;;;OAMG;IACH,IAAI,CACA,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,WAAW,EAClB,OAAO,CAAC,EAAE,8BAA8B,GACzC,WAAW,CAAC,OAAO,EAAE,uBAAuB,GAAG,cAAc,GAAG,kBAAkB,CAAC,CAAA;IACtF;;;;OAIG;IACH,MAAM,CACF,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,8BAA8B,GACzC,WAAW,CAAC,IAAI,EAAE,uBAAuB,GAAG,cAAc,GAAG,kBAAkB,CAAC,CAAA;CACtF"}

package/dist/api/default/webhooks.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=webhooks.js.map

package/dist/api/default/webhooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../../../src/api/default/webhooks.ts"],"names":[],"mappings":""}

package/dist/api/effect/application.d.ts

@@ -0,0 +1,29 @@
+import type { BotApplication, BotApplicationOperationFailure, BotApplicationOperationOptions } from "#sdk/application";
+import type * as Effect from "effect/Effect";
+/** Read the application associated with this bot token through GET `/oauth2/applications/@me`.
+ * No gateway connection is required.
+ * Effects start when executed and can be run again, using the caller's services, the client's default deadline (rest.defaultTimeoutMs, 30,000 ms unless configured) and at most two transient read retries.
+ * Returns a frozen set of documented application fields, including the owner's user ID, without caching. Other owner details, redirect URIs, verification keys, client secrets, and nested bot fields are never exposed.
+ * Fluxer remains authoritative for application visibility and installability. This read neither manages an application nor opens an authorization page.
+ * Input, HTTP, and malformed-response failures use BotApplicationOperationError. Closure uses ClientClosedError. Interruption and defects remain in the Cause
+ *
+ * @example
+ * ```ts
+ * import { Effect } from "effect"
+ * import { links, type Client } from "@neontechspace/fluxerly/effect"
+ * export const applicationExample = (client: Client) => Effect.gen(function* () {
+ *     const application = yield* client.application.fetch()
+ *     return links.installation(application.id, { permissions: 0n })
+ * })
+ * ```
+ *
+ * @category Client and lifecycle
+ */
+export interface CurrentBotApplication {
+    /**
+     * Fetch this bot token's application data from /oauth2/applications/@me.
+     * Only the documented fields are returned, frozen, without cache storage, gateway events, owner profile lookup or follow-up requests
+     */
+    fetch(options?: BotApplicationOperationOptions): Effect.Effect<BotApplication, BotApplicationOperationFailure>;
+}
+//# sourceMappingURL=application.d.ts.map

package/dist/api/effect/application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../../../src/api/effect/application.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,8BAA8B,EAAE,8BAA8B,EAAE,MAAM,kBAAkB,CAAA;AACtH,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAA;AAE5C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,qBAAqB;IAClC;;;OAGG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,8BAA8B,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,8BAA8B,CAAC,CAAA;CACjH"}

package/dist/api/effect/application.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=application.js.map

package/dist/api/effect/application.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application.js","sourceRoot":"","sources":["../../../src/api/effect/application.ts"],"names":[],"mappings":""}

package/dist/api/effect/attachments.d.ts

@@ -0,0 +1,84 @@
+import type * as Effect from "effect/Effect";
+import type * as Stream from "effect/Stream";
+import type { Attachment, AttachmentDownloadFailure, AttachmentDownloadOptions, AttachmentRefreshFailure, AttachmentRefreshOptions, RefreshedAttachmentUrl } from "#sdk/attachments";
+/** Refresh signed attachment URL strings explicitly, or download attachment bytes in one result or as chunks.
+ * Methods return Effects or Streams, do not need a gateway connection and use no cached bytes
+ *
+ * @category Messages
+ */
+export interface Attachments {
+    /**
+     * Ask Fluxer's bot-authenticated API to reissue signatures for 1 through 50 URL strings.
+     * Each string may contain at most 2,048 UTF-16 code units.
+     * Strings, duplicate entries and query parameters are sent unchanged
+     *
+     * The frozen result has one original and refreshed pair per input in the same order.
+     * A string outside this instance's attachment URL space is returned unchanged by Fluxer.
+     * Refreshing does not check attachment existence, community or channel membership, permission to download, or media availability
+     *
+     * This method never downloads media and sends the bot credential only to the selected instance's API, never to a requested or refreshed URL.
+     * The credentialed POST follows no redirect.
+     * Use download explicitly afterward for a returned URL that belongs to this instance
+     *
+     * The timeoutMs option defaults to the client's rest.defaultTimeoutMs, 30,000 unless configured, for endpoint discovery, waiting for a REST request slot, rate-limit waits and the limited response read.
+     * A confirmed 429 can retry after its required wait.
+     * A POST with an unknown outcome or a malformed success is not retried automatically.
+     * Cancellation affects only this refresh and waits for request cleanup.
+     * HTTP 404 cannot distinguish an older unsupported deployment from an unavailable route or denied access.
+     * No refresh happens automatically when reading messages or downloading attachments
+     */
+    refreshUrls(urls: readonly string[], options?: AttachmentRefreshOptions): Effect.Effect<readonly RefreshedAttachmentUrl[], AttachmentRefreshFailure>;
+    /**
+     * Download attachment.url into one Uint8Array.
+     * Pass maxBytes explicitly, from 1 through 52,428,800 bytes (50 MiB).
+     * The limit caps the returned bytes, not total memory, because response chunks can coexist with the packed result
+     *
+     * The URL must match this instance's discovered media /attachments/ path.
+     * The GET sends no Authorization header, follows no redirects, stores no cached copy and never falls back to proxyUrl.
+     * The timeoutMs option defaults to the client's rest.defaultTimeoutMs, 30,000 unless configured, for endpoint discovery, waiting for a media slot and downloading.
+     * By default four media downloads can run at once (rest.mediaConcurrency), separately from REST and uploads, without waiting for bot API rate limits.
+     * Cancellation waits for response-reader cleanup, but cannot undo bytes already received
+     *
+     * Size and expiry metadata do not prove that the URL is available or the bytes are safe.
+     * Expected failures contain a safe reason and status, including busy, without the URL or response body.
+     * Discovery and download transport failures retain a sanitized cause with a safe transport code when available, never the raw error
+     */
+    download(attachment: Attachment, options: AttachmentDownloadOptions): Effect.Effect<Uint8Array, AttachmentDownloadFailure>;
+    /**
+     * Read attachment.url as chunks without combining the file into one array.
+     * Pass maxBytes explicitly, from 1 through 52,428,800 bytes (50 MiB), for the total bytes delivered
+     *
+     * The first pull reads the inputs, resolves endpoints, waits for a media slot (four by default, rest.mediaConcurrency) and starts the GET.
+     * Media slots are separate from the REST and upload slots.
+     * Later pulls read at most one response chunk.
+     * No byte packing, spooling, automatic retry or durable storage is added
+     *
+     * The URL must match this instance's media /attachments/ path.
+     * The GET sends no Authorization header, follows no redirects, caches nothing and never uses proxyUrl.
+     * A Content-Length above maxBytes fails before any chunk, but actual byte counting is still enforced
+     *
+     * The result can be consumed only once.
+     * The timeoutMs option defaults to the client's rest.defaultTimeoutMs, 30,000 unless configured, for the whole download, including pauses between chunks.
+     * Ending consumption early, cancellation, failure and client shutdown cancel the body, wait for reader cleanup and release the media slot.
+     * Expected failures include safe local busy, network, response, limit and deadline reasons and client closure.
+     * Transport failures during discovery, opening or reading retain sanitized causes with safe transport codes when available, never raw errors.
+     * Size and expiry metadata do not establish availability or byte safety
+     *
+     * @remarks
+     * The Stream starts when consumed.
+     * Expected failures keep their native Effect causes, and scope interruption ends the download
+     *
+     * @example
+     * ```ts
+     * import { Effect, Stream } from "effect"
+     * import type { Attachment, Client } from "@neontechspace/fluxerly/effect"
+     * export function downloadChunks(client: Client, attachment: Attachment) {
+     *     return Stream.runForEach(client.attachments.stream(attachment, { maxBytes: 1_024 }), (chunk) =>
+     *         Effect.sync(() => void chunk),
+     *     )
+     * }
+     * ```
+     */
+    stream(attachment: Attachment, options: AttachmentDownloadOptions): Stream.Stream<Uint8Array, AttachmentDownloadFailure>;
+}
+//# sourceMappingURL=attachments.d.ts.map

package/dist/api/effect/attachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../../../src/api/effect/attachments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAA;AAC5C,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAA;AAC5C,OAAO,KAAK,EACR,UAAU,EACV,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACzB,MAAM,kBAAkB,CAAA;AAEzB;;;;GAIG;AACH,MAAM,WAAW,WAAW;IACxB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,WAAW,CACP,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,CAAC,EAAE,wBAAwB,GACnC,MAAM,CAAC,MAAM,CAAC,SAAS,sBAAsB,EAAE,EAAE,wBAAwB,CAAC,CAAA;IAC7E;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CACJ,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,yBAAyB,GACnC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,yBAAyB,CAAC,CAAA;IACvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACH,MAAM,CACF,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,yBAAyB,GACnC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,yBAAyB,CAAC,CAAA;CAC1D"}

package/dist/api/effect/attachments.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=attachments.js.map

package/dist/api/effect/attachments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.js","sourceRoot":"","sources":["../../../src/api/effect/attachments.ts"],"names":[],"mappings":""}

package/dist/api/effect/audit-logs.d.ts

@@ -0,0 +1,42 @@
+import type { AuditLogEntry, AuditLogPage, AuditLogQuery, AuditLogIterationQuery } from "#sdk/audit-logs";
+import type * as Effect from "effect/Effect";
+import type * as Stream from "effect/Stream";
+import type { PaginationError } from "#sdk/pagination";
+import type { GuildOperationFailure, GuildOperationOptions } from "#sdk/guilds";
+/** Read a community's audit log as a page or a bounded sequence of entries.
+ * Fluxer requires ViewAuditLog. The SDK does not cache audit entries or connect the gateway.
+ * Eligible reads retry transient failures at most twice under the shared guild REST policy.
+ * Permission, malformed-response and input failures are typed GuildOperationError values.
+ * Effects start when executed and preserve the caller's services, unexpected faults and interruption cleanup.
+ * Closing clients fail with ClientClosedError. Audit records can change independently. This is not an archival snapshot
+ *
+ * @category Guilds and members
+ */
+export interface AuditLogs {
+    /**
+     * Fetch one filtered audit page with referenced users and webhook metadata that excludes tokens.
+     * Supply cursors and filters in AuditLogQuery.
+     * A deletion duration that cannot be represented as safe integer milliseconds fails with reason response, without returning a partial page.
+     * The returned page is frozen and remains in memory while the caller retains it
+     */
+    fetchPage(guildId: string, query: AuditLogQuery, options?: GuildOperationOptions): Effect.Effect<AuditLogPage, GuildOperationFailure>;
+    /**
+     * Read filtered audit entries newest first, buffering one page and never prefetching.
+     * The maxItems option is required.
+     * The pageSize option defaults to 50 and accepts 1–100, maxPages defaults to 100, and timeoutMs applies to each page.
+     * An empty page or maxItems ends the scan, not a short page.
+     * Invalid traversal input, a stalled cursor or reaching the page budget fails with PaginationError.
+     * Remote failures keep auditLogs.fetchPage's errors.
+     * Deletion durations are rounded to whole milliseconds, and one whose milliseconds are not a safe integer fails its page before that page's entries are delivered.
+     * Each consumption is independent, and client closure releases the page and fails the next pull.
+     * Already delivered entries remain with the caller, and concurrent changes can prevent a complete scan.
+     * Use fetchPage instead to also receive referenced users or webhooks
+     *
+     * @remarks
+     * The returned Stream reads pages only while it is consumed.
+     * Failures end the Stream in its error channel.
+     * Interruption waits for request cleanup, and ending consumption releases the buffered page
+     */
+    iterate(guildId: string, query: AuditLogIterationQuery, options?: GuildOperationOptions): Stream.Stream<AuditLogEntry, GuildOperationFailure | PaginationError>;
+}
+//# sourceMappingURL=audit-logs.d.ts.map

package/dist/api/effect/audit-logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-logs.d.ts","sourceRoot":"","sources":["../../../src/api/effect/audit-logs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AACzG,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAA;AAC5C,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAA;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAE/E;;;;;;;;GAQG;AACH,MAAM,WAAW,SAAS;IACtB;;;;;OAKG;IACH,SAAS,CACL,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE,qBAAqB,GAChC,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,qBAAqB,CAAC,CAAA;IACrD;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CACH,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,sBAAsB,EAC7B,OAAO,CAAC,EAAE,qBAAqB,GAChC,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,qBAAqB,GAAG,eAAe,CAAC,CAAA;CAC3E"}

package/dist/api/effect/audit-logs.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=audit-logs.js.map

package/dist/api/effect/audit-logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-logs.js","sourceRoot":"","sources":["../../../src/api/effect/audit-logs.ts"],"names":[],"mappings":""}