@neontechspace/fluxerly 1000.0.0-nightly.12

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

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

package/dist/api/default/messages.js

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

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

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

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

@@ -0,0 +1,168 @@
+import type { GuildListQuery, GuildListSummary } from "#sdk/guilds";
+import { ResultAsync } from "neverthrow";
+import { type OAuthPkce, type OAuthAuthorizationInput, type OAuthConnection, type OAuthCodeExchangeInput, type OAuthConfig, type OAuthIdentity, type OAuthIntrospection, type OAuthOperationFailure, type OAuthTokens, type DefaultOAuthOperationOptions } from "#sdk/oauth";
+import { CancelledError, ConfigurationError } from "#sdk/errors";
+/**
+ * Use a standalone OAuth client to exchange authorization codes, refresh or revoke tokens, and read delegated user data.
+ * This confidential client requires a server-held client secret, not a bot token.
+ * It does not open a browser, handle callbacks, compare state, store tokens or run a gateway.
+ * The application owns those steps and coordinates refreshes
+ *
+ * @remarks
+ * The secret is copied until shutdown.
+ * Calls start immediately and return ResultAsync.
+ * At most eight operations run at once.
+ * While eight are running, another operation fails at once with OAuthOperationError reason busy instead of waiting.
+ * The timeoutMs option defaults to 30,000 for discovery and the operation, with request cleanup awaited afterward.
+ * Responses are capped at 1 MiB and requests are never retried automatically.
+ * Discovery throttling returns OAuthOperationError with reason rateLimit, outcome notDispatched, status 429 and the server's retryAfterMs when available
+ *
+ * Expected failures return Err.
+ * A throw while reading input or option properties rejects with SdkDefect code application.defect and the thrown value
+ * as its cause, and unexpected cleanup failures reject with SdkDefect.
+ * It keeps the original cleanup failure, never response text, and its message and toJSON mask credential patterns
+ *
+ * @category OAuth
+ */
+export interface OAuthClient extends AsyncDisposable {
+    /**
+     * Build an authorization URL for the selected instance using its discovered web application URL, including its path.
+     * Supply the redirect URI, scopes, caller-generated state and S256 PKCE challenge, which binds the callback code to the private verifier.
+     * The application must retain state correlation and the PKCE verifier.
+     * Bot community and permission parameters are consent hints, not proof of installation or authorization.
+     * This returns the URL without opening it.
+     * Network failures retain only sanitized transport facts in cause
+     */
+    authorizationUrl(input: OAuthAuthorizationInput, options?: DefaultOAuthOperationOptions): ResultAsync<string, OAuthOperationFailure | CancelledError | ConfigurationError>;
+    /**
+     * Exchange the code from an authorization callback for access and refresh tokens.
+     * Supply the matching redirect URI and PKCE verifier.
+     * The application must store the returned tokens.
+     * After dispatch, cancellation or a lost response cannot tell whether Fluxer consumed the one-use code.
+     * Do not retry that exchange when its outcome is unknown.
+     * Network failures retain only sanitized transport facts in cause
+     */
+    exchangeCode(input: OAuthCodeExchangeInput, options?: DefaultOAuthOperationOptions): ResultAsync<OAuthTokens, OAuthOperationFailure | CancelledError | ConfigurationError>;
+    /**
+     * Exchange a refresh token for a new access and refresh token pair.
+     * Form tokens must contain 1–256 well-formed UTF-16 units without surrounding whitespace, U+000C or U+202E.
+     * Invalid values fail locally rather than being normalized, and this also applies to revoke and introspect tokens.
+     * Fluxer rotates refresh tokens.
+     * The application must coordinate refreshes and atomically replace both stored tokens after success, so it never stores a mixed pair.
+     * A refresh with an unknown outcome must not be retried, because it may have rotated the token.
+     * Network failures retain only sanitized transport facts in cause
+     */
+    refresh(refreshToken: string, options?: DefaultOAuthOperationOptions): ResultAsync<OAuthTokens, OAuthOperationFailure | CancelledError | ConfigurationError>;
+    /**
+     * Revoke an access or refresh token, with an optional token-type hint.
+     * The token and hint are captured once when execution starts, then validated and transmitted from that snapshot.
+     * A lost response can still mean the token was revoked.
+     * Network failures retain only sanitized transport facts in cause
+     */
+    revoke(input: {
+        /** Access or refresh token to invalidate. Keep this secret out of logs */
+        readonly token: string;
+        /** Identify the token as an access token or a refresh token. Omit when the kind is unknown */
+        readonly tokenTypeHint?: "access_token" | "refresh_token";
+    }, options?: DefaultOAuthOperationOptions): ResultAsync<void, OAuthOperationFailure | CancelledError | ConfigurationError>;
+    /**
+     * Fetch the delegated user's identity with an access token granted the identify scope.
+     * Additional identity fields depend on the token's scopes.
+     * The access token is not retained by this client.
+     * Failures identify a read in details.read, so errors.isRetryable can classify transient failures without implying a token change.
+     * Requests are not retried automatically, and network causes retain only sanitized transport facts
+     */
+    fetchIdentity(accessToken: string, options?: DefaultOAuthOperationOptions): ResultAsync<OAuthIdentity, OAuthOperationFailure | CancelledError | ConfigurationError>;
+    /**
+     * Fetch one bounded page of the delegated user's community memberships.
+     * Use an access token with Fluxer's guilds scope.
+     * Optionally supply pagination settings in GuildListQuery, where limit defaults to 200 and accepts 1–200, and before and after are mutually exclusive cursors.
+     * This uses bearer authentication with the supplied access token, never the bot token.
+     * Failures identify a read in details.read for errors.isRetryable. Requests are not retried automatically,
+     * and network causes retain only sanitized transport facts
+     */
+    fetchGuilds(accessToken: string, query?: GuildListQuery, options?: DefaultOAuthOperationOptions): ResultAsync<readonly GuildListSummary[], OAuthOperationFailure | CancelledError | ConfigurationError>;
+    /**
+     * Fetch the delegated user's full connections list with a connections-scoped access token.
+     * The client neither creates, verifies, reorders nor retains those connections.
+     * Failures identify a read in details.read for errors.isRetryable. Requests are not retried automatically,
+     * and network causes retain only sanitized transport facts
+     */
+    fetchConnections(accessToken: string, options?: DefaultOAuthOperationOptions): ResultAsync<readonly OAuthConnection[], OAuthOperationFailure | CancelledError | ConfigurationError>;
+    /**
+     * Inspect an access or refresh token using this client's ID and secret through HTTP Basic authentication.
+     * An inactive result does not explain expiry or revocation, prove token ownership or establish whether it ever existed.
+     * Failures identify a read in details.read for errors.isRetryable. Requests are not retried automatically,
+     * and network causes retain only sanitized transport facts
+     */
+    introspect(token: string, options?: DefaultOAuthOperationOptions): ResultAsync<OAuthIntrospection, OAuthOperationFailure | CancelledError | ConfigurationError>;
+    /**
+     * Permanently stop OAuth work, reject new work, release the client's copied secret and abort active requests.
+     * Shutdown waits for fetch and response-reader cleanup.
+     * A response-cleanup failure in an active operation fails that operation, while shutdown waits for it and may itself succeed.
+     * A failure in shutdown's own discovery cleanup fails shutdown
+     *
+     * @remarks
+     * Those 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 confidential OAuth clients and generate PKCE values for authorization-code flows.
+ * Use these helpers on a trusted server where the client secret is not exposed to a browser
+ *
+ * @remarks
+ * The application handles browser navigation, callbacks, state correlation, consent and token storage.
+ * It also decides installation policy and coordinates refreshes.
+ * The create method returns the client synchronously without making a request, and throws ConfigurationError for invalid settings.
+ * The createPkce method returns a new verifier and S256 challenge for the same authorization flow.
+ * PKCE links authorization to the code exchange using a private random verifier and its public SHA-256 hash challenge.
+ * Keep the verifier private and send only the challenge to authorizationUrl
+ *
+ * @example
+ * ```ts
+ * import { oauth, OAuthScopes } from "@neontechspace/fluxerly"
+ *
+ * export async function oauthExample(clientId: string, clientSecret: string, redirectUri: string, state: string) {
+ *     const client = oauth.create({ clientId, clientSecret })
+ *     try {
+ *         const pkce = oauth.createPkce()
+ *         return await client.authorizationUrl({
+ *             redirectUri,
+ *             scopes: [OAuthScopes.Identify, OAuthScopes.Bot],
+ *             state,
+ *             codeChallenge: pkce.challenge,
+ *             guildId: "456",
+ *             permissions: 0n,
+ *         })
+ *     } finally {
+ *         await client.shutdown()
+ *     }
+ * }
+ * ```
+ *
+ * @category OAuth
+ */
+export declare const oauth: Readonly<{
+    /**
+     * Create a standalone OAuth client with a clientId and server-held clientSecret.
+     * Creation checks configuration synchronously without requests and copies the secret until shutdown.
+     * Invalid settings throw ConfigurationError.
+     * Unexpected creation failures throw SdkDefect with operation oauth.create and without configuration details.
+     * A throwing configuration getter uses code application.defect with the thrown value as its cause
+     */
+    create(config: OAuthConfig): OAuthClient;
+    /**
+     * Generate a private verifier and matching S256 challenge for one authorization-code flow.
+     * Send challenge to authorizationUrl and keep verifier privately for exchangeCode.
+     * This synchronous helper returns the values immediately, without a request or token storage.
+     * It does not generate or verify the callback's state value
+     */
+    createPkce: () => OAuthPkce;
+}>;
+//# sourceMappingURL=oauth.d.ts.map

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

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

package/dist/api/default/oauth.js

@@ -0,0 +1,84 @@
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Scope from "effect/Scope";
+import { ok, ResultAsync } from "neverthrow";
+import { causeReasons, suspendInput } from "#sdk/internal/defects";
+import { createPkce, } from "#sdk/oauth";
+import { makeOAuthOwner } from "#sdk/internal/oauth";
+import { CancelledError, ConfigurationError, SdkDefect } from "#sdk/errors";
+import { executeOperation, fromExit } from "#sdk/internal/binding/execute";
+function oauthOwnerOptions(options) {
+    if (Array.isArray(options))
+        return options;
+    if (typeof options !== "object" || options === null || !("signal" in options))
+        return options;
+    const { signal: _signal, ...ownerOptions } = options;
+    return ownerOptions;
+}
+/**
+ * Create confidential OAuth clients and generate PKCE values for authorization-code flows.
+ * Use these helpers on a trusted server where the client secret is not exposed to a browser
+ *
+ * @remarks
+ * The application handles browser navigation, callbacks, state correlation, consent and token storage.
+ * It also decides installation policy and coordinates refreshes.
+ * The create method returns the client synchronously without making a request, and throws ConfigurationError for invalid settings.
+ * The createPkce method returns a new verifier and S256 challenge for the same authorization flow.
+ * PKCE links authorization to the code exchange using a private random verifier and its public SHA-256 hash challenge.
+ * Keep the verifier private and send only the challenge to authorizationUrl
+ *
+ * @example
+ * ```ts
+ * import { oauth, OAuthScopes } from "@neontechspace/fluxerly"
+ *
+ * export async function oauthExample(clientId: string, clientSecret: string, redirectUri: string, state: string) {
+ *     const client = oauth.create({ clientId, clientSecret })
+ *     try {
+ *         const pkce = oauth.createPkce()
+ *         return await client.authorizationUrl({
+ *             redirectUri,
+ *             scopes: [OAuthScopes.Identify, OAuthScopes.Bot],
+ *             state,
+ *             codeChallenge: pkce.challenge,
+ *             guildId: "456",
+ *             permissions: 0n,
+ *         })
+ *     } finally {
+ *         await client.shutdown()
+ *     }
+ * }
+ * ```
+ *
+ * @category OAuth
+ */
+export const oauth = Object.freeze({
+    create(config) {
+        const scope = Scope.makeUnsafe();
+        const created = fromExit(Effect.runSyncExit(makeOAuthOwner(config, scope)), "oauth.create");
+        if (created.isErr())
+            throw created.error;
+        const owner = created.value;
+        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({
+            authorizationUrl: (input, options) => executeOperation(suspendInput(() => owner.authorizationUrl(input, oauthOwnerOptions(options))), "oauth.authorizationUrl", options),
+            exchangeCode: (input, options) => executeOperation(suspendInput(() => owner.exchangeCode(input, oauthOwnerOptions(options))), "oauth.exchangeCode", options),
+            refresh: (refreshToken, options) => executeOperation(suspendInput(() => owner.refresh(refreshToken, oauthOwnerOptions(options))), "oauth.refresh", options),
+            revoke: (input, options) => executeOperation(suspendInput(() => owner.revoke(input, oauthOwnerOptions(options))), "oauth.revoke", options),
+            fetchIdentity: (accessToken, options) => executeOperation(suspendInput(() => owner.fetchIdentity(accessToken, oauthOwnerOptions(options))), "oauth.fetchIdentity", options),
+            fetchGuilds: (accessToken, query, options) => executeOperation(suspendInput(() => owner.fetchGuilds(accessToken, query, oauthOwnerOptions(options))), "oauth.fetchGuilds", options),
+            fetchConnections: (accessToken, options) => executeOperation(suspendInput(() => owner.fetchConnections(accessToken, oauthOwnerOptions(options))), "oauth.fetchConnections", options),
+            introspect: (token, options) => executeOperation(suspendInput(() => owner.introspect(token, oauthOwnerOptions(options))), "oauth.introspect", options),
+            shutdown,
+            [Symbol.asyncDispose]: async () => {
+                await shutdown();
+            },
+        });
+    },
+    createPkce,
+});
+//# sourceMappingURL=oauth.js.map

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

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

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

@@ -0,0 +1,44 @@
+import type { PermissionInput, PermissionTarget } from "#sdk/permissions";
+import type { ResultAsync } from "neverthrow";
+import type { ChannelOperationFailure } from "#sdk/channels";
+import type { GuildOperationFailure, DefaultGuildOperationOptions } from "#sdk/guilds";
+import type { CancelledError, ConfigurationError } from "#sdk/errors";
+/**
+ * Calculate permission flags from supplied data or fresh reads.
+ * A permission value alone does not determine channel visibility, role hierarchy, timeouts or authorization for an action
+ *
+ * @category Roles and permissions
+ */
+export interface PermissionHelpers {
+    /**
+     * Calculate permission flags from supplied guild, member, role and optional channel data.
+     * No request or cache read is made, and connection state is irrelevant, including after client shutdown.
+     * The bigint result ranges from 0n through 18_446_744_073_709_551_615n and preserves unknown flags.
+     * Community owner or base Administrator gets all flags.
+     * Otherwise the calculation applies everyone, combined roles, then member overwrites.
+     * Only the target channel's stored overwrites are used, not its parent category's.
+     * A thread uses the overwrites of the parentChannel supplied with it, then grants SendMessages exactly when
+     * SendMessagesInThreads is granted, as Fluxer does. A thread without its parentChannel, or with any other channel as
+     * parentChannel, is rejected.
+     * Missing or inconsistent input is misuse and throws GuildOperationError for permissions.calculate with reason input in both APIs
+     *
+     * @remarks
+     * Returns the value synchronously.
+     * Unexpected failures throw SdkDefect
+     */
+    calculate(input: PermissionInput): bigint;
+    /**
+     * Fetch guild, member, role and optional channel data, then calculate their permission flags.
+     * No gateway connection or cache-first lookup is needed.
+     * A thread channel adds a read of its parent channel, and the result follows Fluxer's thread rule as in calculate.
+     * Underlying reads can enter enabled caches, but the calculated result is not cached.
+     * The sequential reads are separate observations, so the result does not guarantee a later action will succeed.
+     * The default deadline, rest.defaultTimeoutMs (30,000 ms unless configured), covers the whole helper with shared read retries and awaited cancellation cleanup.
+     * Invalid target or deadline fails with permissions.fetch reason input.
+     * Resource errors keep their GuildOperationError or ChannelOperationError.
+     * A channel from another community fails instead of mixing guild data.
+     * Client closure fails with ClientClosedError
+     */
+    fetch(target: PermissionTarget, options?: DefaultGuildOperationOptions): ResultAsync<bigint, GuildOperationFailure | ChannelOperationFailure | CancelledError | ConfigurationError>;
+}
+//# sourceMappingURL=permissions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../../src/api/default/permissions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAC5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAA;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAErE;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAC9B;;;;;;;;;;;;;;;OAeG;IACH,SAAS,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAAA;IACzC;;;;;;;;;;;OAWG;IACH,KAAK,CACD,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,4BAA4B,GACvC,WAAW,CAAC,MAAM,EAAE,qBAAqB,GAAG,uBAAuB,GAAG,cAAc,GAAG,kBAAkB,CAAC,CAAA;CAChH"}

package/dist/api/default/permissions.js

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

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

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

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

@@ -0,0 +1,88 @@
+import type { PresenceInput, PresenceFailure } from "#sdk/presence";
+import type { Result } from "neverthrow";
+/**
+ * Set the bot's displayed status or request updates for selected community members.
+ * Outgoing status is sent to live shards assigned to this client, at least four seconds apart per shard.
+ * Member selections use separate bounded gateway requests.
+ * Neither operation has a provider acknowledgement or recipient-delivery guarantee.
+ * The SDK does not fetch membership or filter out self.
+ * Fluxer decides access and which updates are visible
+ *
+ * @category Client and lifecycle
+ */
+export interface Presence {
+    /**
+     * Set the bot's requested status and optional custom status, including before connecting.
+     * The input is validated and frozen when the call runs.
+     * Omitted customStatus keeps the previous request, and null clears it.
+     * Expired custom statuses are not restored after reconnect.
+     * Each shard retains at most one unsent status update, replacing it with the latest intent even while gateway pacing waits.
+     * The four-second interval starts when an update reaches the socket, not when it is queued.
+     * Success means the request was accepted locally and scheduled for each shard, not acknowledged by Fluxer.
+     * Shutdown releases this intent and its timer
+     *
+     * @remarks
+     * Returns a Result synchronously.
+     * A throwing input getter throws SdkDefect with code application.defect and the thrown value as its cause, and other
+     * unexpected failures throw SdkDefect with code sdk.defect
+     *
+     * @example
+     * ```ts
+     * import { MemberMentionPreferences, type Client } from "@neontechspace/fluxerly"
+     * export async function botProfileExample(client: Client, guildId: string) {
+     *     const presence = client.presence.set({ status: "online", customStatus: { text: "Ready", emoji: { name: "🌱" } } })
+     *     if (presence.isErr()) return presence
+     *     return client.members.editSelf(guildId, { nickname: "Support", mentionFlags: MemberMentionPreferences.PreferNoMention })
+     * }
+     * ```
+     */
+    set(input: PresenceInput): Result<void, PresenceFailure>;
+    /**
+     * Request presence updates for selected members in one community.
+     * Register a presenceUpdate listener, then pass accessible non-self member IDs.
+     * Pass [] to clear the selection.
+     * Closing the listener does not clear it.
+     * No full-member subscription, member lookup or presence cache is created, and Fluxer remains authoritative for access and filtering.
+     * The community must belong to a shard assigned to this client, or the call fails with PresenceError reason input
+     *
+     * Inputs are copied and retained when the call runs.
+     * Up to 1,000 distinct decimal IDs are accepted, but the full UTF-8 gateway frame must fit 4,096 bytes.
+     * Long IDs therefore reduce the effective per-community maximum.
+     * The client retains selections for at most 100 communities and 10,000 IDs.
+     * Clearing an unsent selection withdraws its queued command and releases its slot immediately.
+     * Changes to a selection that has not reached the socket replace that unsent request.
+     * Clearing a selection already sent keeps one bounded session slot until fresh Identify or confirmed community leave, because a local socket write cannot confirm that Fluxer applied a clear
+     *
+     * After READY or RESUMED, the latest selection or clear is combined and sent at most once per 125 ms per shard.
+     * This interval starts at actual socket transmission, and at most one member-selection command waits per shard.
+     * Sending the same list again deliberately requests a refresh.
+     * A matching guild creation also retries the latest selection or a previously sent clear.
+     * None of these attempts guarantees an event or proves provider acceptance.
+     * Initial state and transitions can be missed during recovery.
+     * Loss of shared channel visibility can remove the provider subscription, so resend the selection after access returns.
+     * Clear explicitly or shut down the client to release local intent.
+     * Input or limit failures fail with PresenceError, and closing clients fail with ClientClosedError.
+     * The community and member IDs must be positive decimal strings without leading zeros, no greater than 9223372036854775807.
+     * The member IDs are copied once, and that copy is validated and subscribed
+     *
+     * @remarks
+     * Returns a Result synchronously.
+     * A throwing ID getter throws SdkDefect with code application.defect and the thrown value as its cause, and other
+     * unexpected failures throw SdkDefect with code sdk.defect
+     *
+     * @example
+     * ```ts
+     * import type { Client } from "@neontechspace/fluxerly"
+     * export function watchSelectedMember(client: Client, guildId: string, memberId: string) {
+     *     const subscription = client.on("presenceUpdate", (presence) => {
+     *         if (presence.guildId === guildId && presence.userId === memberId) void presence.status
+     *     })
+     *     const selected = client.presence.setMembers(guildId, [memberId])
+     *     if (selected.isErr()) subscription.close()
+     *     return selected.map(() => subscription)
+     * }
+     * ```
+     */
+    setMembers(guildId: string, memberIds: readonly string[]): Result<void, PresenceFailure>;
+}
+//# sourceMappingURL=presence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../../../src/api/default/presence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAExC;;;;;;;;;GASG;AACH,MAAM,WAAW,QAAQ;IACrB;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,GAAG,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAAC,IAAI,EAAE,eAAe,CAAC,CAAA;IACxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6CG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,eAAe,CAAC,CAAA;CAC3F"}

package/dist/api/default/presence.js

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

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

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

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

@@ -0,0 +1,28 @@
+import type { ResultAsync } from "neverthrow";
+import type { CancelledError, ConfigurationError } from "#sdk/errors";
+import type { DefaultRestRequest, RestRequestFailure, RestResponse } from "#sdk/rest";
+/**
+ * Send requests to Fluxer API routes that the SDK does not wrap, with the client's bot credential and its REST scheduler.
+ * Calls start immediately, need no gateway connection and default to the client's rest.defaultTimeoutMs deadline.
+ * Abort waits for cleanup and returns CancelledError. Unexpected failures reject with SdkDefect
+ *
+ * @category Client and lifecycle
+ */
+export interface RestRequests {
+    /**
+     * Send one request to a route under /v1 and resolve with its status, lower-case headers and parsed JSON body.
+     * The request waits in the client's queue and learned rate-limit windows like wrapped operations, and fails at once
+     * with reason rateLimit and the remaining wait as retryAfterMs when a window outlasts the deadline. A 429 is waited
+     * out and sent again while the deadline allows. A GET is also retried at most twice after a network error, including
+     * a connection lost while the response body arrives, or HTTP 500, 502, 503 or 504. Another method is never sent
+     * again after an uncertain outcome.
+     * Invalid input fails with RestRequestError reason input before any request, a non-2xx status fails with its status
+     * and sanitized apiError, and closure fails with ClientClosedError. Message and resource caches are not updated.
+     * Percent-encoded unreserved letters cannot bypass the reserved /v1 prefix or token-webhook route checks, which remain case-sensitive.
+     * Network causes retain sanitized transport facts, not raw errors. Unknown uppercase provider codes remain in details.providerCode,
+     * including on HTTP 429 when its wait exceeds the deadline.
+     * Logs, metrics and spans name only the route template, never the query, body or response
+     */
+    request<T = unknown>(input: DefaultRestRequest): ResultAsync<RestResponse<T>, RestRequestFailure | CancelledError | ConfigurationError>;
+}
+//# sourceMappingURL=rest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rest.d.ts","sourceRoot":"","sources":["../../../src/api/default/rest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAErF;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IACzB;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,CAAC,GAAG,OAAO,EACf,KAAK,EAAE,kBAAkB,GAC1B,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,kBAAkB,GAAG,cAAc,GAAG,kBAAkB,CAAC,CAAA;CAC5F"}

package/dist/api/default/rest.js

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

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

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

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

@@ -0,0 +1,31 @@
+import type { Result } from "neverthrow";
+/**
+ * Return the value of an Ok result, or throw the error of an Err result.
+ * Use it where a failure should end the surrounding function, such as a command handler whose thrown error is
+ * reported with the command name, or a startup script that should stop with the SDK's message and hint.
+ * The thrown value is the operation's own error, so its message, hint, code and cause remain available
+ *
+ * @remarks
+ * A ResultAsync, or any promise of a Result, returns a Promise that resolves with the value or rejects with the error.
+ * Keep checking isErr() where the application must recover from a particular failure instead
+ *
+ * @example
+ * ```ts
+ * import { orThrow, type Client } from "@neontechspace/fluxerly"
+ *
+ * export async function greet(client: Client, channelId: string) {
+ *     const message = orThrow(await client.messages.send(channelId, { content: "Hello" }))
+ *     return orThrow(client.messages.edit(message, { content: "Hello again" }))
+ * }
+ * ```
+ *
+ * @category Errors
+ */
+export declare function orThrow<T, E>(result: Result<T, E>): T;
+/**
+ * Wait for a ResultAsync, or any promise of a Result, and resolve with its value or reject with its error
+ *
+ * @category Errors
+ */
+export declare function orThrow<T, E>(result: PromiseLike<Result<T, E>>): Promise<T>;
+//# sourceMappingURL=results.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"results.d.ts","sourceRoot":"","sources":["../../../src/api/default/results.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAExC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAA;AACtD;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA"}

package/dist/api/default/results.js

@@ -0,0 +1,14 @@
+export function orThrow(result) {
+    if (isPromiseLike(result))
+        return Promise.resolve(result).then(unwrap);
+    return unwrap(result);
+}
+function unwrap(result) {
+    if (result.isErr())
+        throw result.error;
+    return result.value;
+}
+function isPromiseLike(value) {
+    return typeof value.then === "function";
+}
+//# sourceMappingURL=results.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"results.js","sourceRoot":"","sources":["../../../src/api/default/results.ts"],"names":[],"mappings":"AA+BA,MAAM,UAAU,OAAO,CAAO,MAAgD;IAC1E,IAAI,aAAa,CAAC,MAAM,CAAC;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACtE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAA;AACzB,CAAC;AAED,SAAS,MAAM,CAAO,MAAoB;IACtC,IAAI,MAAM,CAAC,KAAK,EAAE;QAAE,MAAM,MAAM,CAAC,KAAK,CAAA;IACtC,OAAO,MAAM,CAAC,KAAK,CAAA;AACvB,CAAC;AAED,SAAS,aAAa,CAAI,KAAyB;IAC/C,OAAO,OAAQ,KAA4B,CAAC,IAAI,KAAK,UAAU,CAAA;AACnE,CAAC"}