@neontechspace/fluxerly 1000.0.0-nightly.12

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

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

package/dist/api/effect/messages.js

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

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

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

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

@@ -0,0 +1,148 @@
+import type { GuildListQuery, GuildListSummary } from "#sdk/guilds";
+import * as Effect from "effect/Effect";
+import * as Scope from "effect/Scope";
+import { type OAuthPkce, type OAuthAuthorizationInput, type OAuthConnection, type OAuthCodeExchangeInput, type OAuthConfig, type OAuthIdentity, type OAuthIntrospection, type OAuthOperationFailure, type OAuthTokens, type OAuthOperationOptions } from "#sdk/oauth";
+/**
+ * Use OAuth to access a user's Fluxer account with their consent and a server-held client secret.
+ * The scope that creates this client shuts it down
+ *
+ * The application handles consent, browser callbacks, state checks, token storage and refresh coordination
+ *
+ * The client keeps a copy of the secret until shutdown and runs at most eight operations at once.
+ * While eight are running, another operation fails at once with OAuthOperationError reason busy instead of waiting.
+ * Response bodies are capped at 1 MiB. Requests never retry automatically.
+ * Discovery throttling fails with OAuthOperationError reason rateLimit, outcome notDispatched, status 429 and the server's retryAfterMs when available
+ *
+ * Expected failures use Effect's error channel. Interruption and cleanup defects remain in Cause.
+ * Response and discovery cleanup faults keep their original values as Cause defects, and describeError masks credential patterns in them
+ *
+ * Operation input properties are read during execution, with throwing accessors retained as defects
+ *
+ * @category OAuth
+ */
+export interface OAuthClient {
+    /**
+     * 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?: OAuthOperationOptions): Effect.Effect<string, OAuthOperationFailure>;
+    /**
+     * 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?: OAuthOperationOptions): Effect.Effect<OAuthTokens, OAuthOperationFailure>;
+    /**
+     * 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?: OAuthOperationOptions): Effect.Effect<OAuthTokens, OAuthOperationFailure>;
+    /**
+     * 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?: OAuthOperationOptions): Effect.Effect<void, OAuthOperationFailure>;
+    /**
+     * 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?: OAuthOperationOptions): Effect.Effect<OAuthIdentity, OAuthOperationFailure>;
+    /**
+     * 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?: OAuthOperationOptions): Effect.Effect<readonly GuildListSummary[], OAuthOperationFailure>;
+    /**
+     * 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?: OAuthOperationOptions): Effect.Effect<readonly OAuthConnection[], OAuthOperationFailure>;
+    /**
+     * 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?: OAuthOperationOptions): Effect.Effect<OAuthIntrospection, OAuthOperationFailure>;
+    /**
+     * 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 defects remain in the affected Effect's Cause
+     */
+    shutdown(): Effect.Effect<void>;
+}
+/**
+ * Create a server-side OAuth client, or generate an S256 PKCE challenge for an authorization request.
+ * The create method returns an Effect that requires Scope. Invalid configuration is misuse and dies with ConfigurationError.
+ * The application owns consent, callback correlation, state validation, token storage, installation policy and coordinated refresh
+ *
+ * @example
+ * ```ts
+ * import { Effect } from "effect"
+ * import { oauth, OAuthScopes } from "@neontechspace/fluxerly/effect"
+ *
+ * export const oauthEffectExample = Effect.scoped(
+ *     Effect.gen(function* () {
+ *         const client = yield* oauth.create({ clientId: "123", clientSecret: "server-held-secret" })
+ *         const pkce = oauth.createPkce()
+ *         return yield* client.authorizationUrl({
+ *             redirectUri: "https://app.example.test/oauth/callback",
+ *             scopes: [OAuthScopes.Identify, OAuthScopes.Bot],
+ *             state: "caller-correlated-state",
+ *             codeChallenge: pkce.challenge,
+ *             guildId: "456",
+ *             permissions: 0n,
+ *         })
+ *     }),
+ * )
+ * ```
+ *
+ * @category OAuth
+ */
+export declare const oauth: Readonly<{
+    /** Create the OAuth client when this Effect executes, without making a request.
+     * Invalid client credentials or instance settings are misuse and die with ConfigurationError. Unexpected failures remain defects in the Cause.
+     * Scope closure calls shutdown
+     */
+    create: (config: OAuthConfig) => Effect.Effect<OAuthClient, never, Scope.Scope>;
+    /**
+     * 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/effect/oauth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.d.ts","sourceRoot":"","sources":["../../../src/api/effect/oauth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACnE,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,EAEH,KAAK,SAAS,EACd,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAChB,KAAK,qBAAqB,EAC7B,MAAM,YAAY,CAAA;AAGnB;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,WAAW;IACxB;;;;;;;OAOG;IACH,gBAAgB,CACZ,KAAK,EAAE,uBAAuB,EAC9B,OAAO,CAAC,EAAE,qBAAqB,GAChC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAA;IAC/C;;;;;;;OAOG;IACH,YAAY,CACR,KAAK,EAAE,sBAAsB,EAC7B,OAAO,CAAC,EAAE,qBAAqB,GAChC,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,qBAAqB,CAAC,CAAA;IACpD;;;;;;;;OAQG;IACH,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,qBAAqB,CAAC,CAAA;IACjH;;;;;OAKG;IACH,MAAM,CACF,KAAK,EAAE;QACH,0EAA0E;QAC1E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;QACtB,8FAA8F;QAC9F,QAAQ,CAAC,aAAa,CAAC,EAAE,cAAc,GAAG,eAAe,CAAA;KAC5D,EACD,OAAO,CAAC,EAAE,qBAAqB,GAChC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAA;IAC7C;;;;;;OAMG;IACH,aAAa,CACT,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,qBAAqB,GAChC,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,qBAAqB,CAAC,CAAA;IACtD;;;;;;;OAOG;IACH,WAAW,CACP,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAChC,MAAM,CAAC,MAAM,CAAC,SAAS,gBAAgB,EAAE,EAAE,qBAAqB,CAAC,CAAA;IACpE;;;;;OAKG;IACH,gBAAgB,CACZ,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,qBAAqB,GAChC,MAAM,CAAC,MAAM,CAAC,SAAS,eAAe,EAAE,EAAE,qBAAqB,CAAC,CAAA;IACnE;;;;;OAKG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,qBAAqB,CAAC,CAAA;IACpH;;;;;;;;OAQG;IACH,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,KAAK,EAAE,QAAQ,CAAC;IACzB;;;OAGG;IACH,MAAM,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IAC/E;;;;;OAKG;IACH,UAAU,EAAE,MAAM,SAAS,CAAA;CAC9B,CA2BC,CAAA"}

package/dist/api/effect/oauth.js

@@ -0,0 +1,51 @@
+import * as Effect from "effect/Effect";
+import * as Scope from "effect/Scope";
+import { createPkce, } from "#sdk/oauth";
+import { makeOAuthOwner } from "#sdk/internal/oauth";
+/**
+ * Create a server-side OAuth client, or generate an S256 PKCE challenge for an authorization request.
+ * The create method returns an Effect that requires Scope. Invalid configuration is misuse and dies with ConfigurationError.
+ * The application owns consent, callback correlation, state validation, token storage, installation policy and coordinated refresh
+ *
+ * @example
+ * ```ts
+ * import { Effect } from "effect"
+ * import { oauth, OAuthScopes } from "@neontechspace/fluxerly/effect"
+ *
+ * export const oauthEffectExample = Effect.scoped(
+ *     Effect.gen(function* () {
+ *         const client = yield* oauth.create({ clientId: "123", clientSecret: "server-held-secret" })
+ *         const pkce = oauth.createPkce()
+ *         return yield* client.authorizationUrl({
+ *             redirectUri: "https://app.example.test/oauth/callback",
+ *             scopes: [OAuthScopes.Identify, OAuthScopes.Bot],
+ *             state: "caller-correlated-state",
+ *             codeChallenge: pkce.challenge,
+ *             guildId: "456",
+ *             permissions: 0n,
+ *         })
+ *     }),
+ * )
+ * ```
+ *
+ * @category OAuth
+ */
+export const oauth = Object.freeze({
+    create: (config) => Effect.gen(function* () {
+        const owner = yield* makeOAuthOwner(config, Scope.makeUnsafe(), true).pipe(Effect.orDie);
+        yield* Effect.addFinalizer(() => owner.shutdown());
+        return Object.freeze({
+            authorizationUrl: (input, options) => owner.authorizationUrl(input, options),
+            exchangeCode: (input, options) => owner.exchangeCode(input, options),
+            refresh: (refreshToken, options) => owner.refresh(refreshToken, options),
+            revoke: (input, options) => owner.revoke(input, options),
+            fetchIdentity: (accessToken, options) => owner.fetchIdentity(accessToken, options),
+            fetchGuilds: (accessToken, query, options) => owner.fetchGuilds(accessToken, query, options),
+            fetchConnections: (accessToken, options) => owner.fetchConnections(accessToken, options),
+            introspect: (token, options) => owner.introspect(token, options),
+            shutdown: () => owner.shutdown(),
+        });
+    }),
+    createPkce,
+});
+//# sourceMappingURL=oauth.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.js","sourceRoot":"","sources":["../../../src/api/effect/oauth.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,EACH,UAAU,GAWb,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AA2HpD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,MAAM,KAAK,GAab,MAAM,CAAC,MAAM,CAAC;IACf,MAAM,EAAE,CAAC,MAAmB,EAAkD,EAAE,CAC5E,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAChB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACxF,KAAK,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAA;QAClD,OAAO,MAAM,CAAC,MAAM,CAAC;YACjB,gBAAgB,EAAE,CAAC,KAA8B,EAAE,OAA+B,EAAE,EAAE,CAClF,KAAK,CAAC,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC;YAC1C,YAAY,EAAE,CAAC,KAA6B,EAAE,OAA+B,EAAE,EAAE,CAC7E,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC;YACtC,OAAO,EAAE,CAAC,YAAoB,EAAE,OAA+B,EAAE,EAAE,CAC/D,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC;YACxC,MAAM,EAAE,CACJ,KAA4F,EAC5F,OAA+B,EACjC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC;YACjC,aAAa,EAAE,CAAC,WAAmB,EAAE,OAA+B,EAAE,EAAE,CACpE,KAAK,CAAC,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC;YAC7C,WAAW,EAAE,CAAC,WAAmB,EAAE,KAAsB,EAAE,OAA+B,EAAE,EAAE,CAC1F,KAAK,CAAC,WAAW,CAAC,WAAW,EAAE,KAAK,EAAE,OAAO,CAAC;YAClD,gBAAgB,EAAE,CAAC,WAAmB,EAAE,OAA+B,EAAE,EAAE,CACvE,KAAK,CAAC,gBAAgB,CAAC,WAAW,EAAE,OAAO,CAAC;YAChD,UAAU,EAAE,CAAC,KAAa,EAAE,OAA+B,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC;YAChG,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE;SACnC,CAAC,CAAA;IACN,CAAC,CAAC;IACN,UAAU;CACb,CAAC,CAAA"}

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

@@ -0,0 +1,41 @@
+import type { PermissionInput, PermissionTarget } from "#sdk/permissions";
+import type { GuildOperationFailure, GuildOperationOptions } from "#sdk/guilds";
+import type * as Effect from "effect/Effect";
+import type { ChannelOperationFailure } from "#sdk/channels";
+/** Calculate permission bits from supplied snapshots or freshly fetched resources.
+ * These results do not account for timeouts or role hierarchy and do not prove an action will succeed
+ *
+ * @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, as in the default API, because the calculation is pure
+     */
+    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?: GuildOperationOptions): Effect.Effect<bigint, GuildOperationFailure | ChannelOperationFailure>;
+}
+//# sourceMappingURL=permissions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../../src/api/effect/permissions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACzE,OAAO,KAAK,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAC/E,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAA;AAC5C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAE5D;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAC9B;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAAA;IACzC;;;;;;;;;;;OAWG;IACH,KAAK,CACD,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,qBAAqB,GAChC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,GAAG,uBAAuB,CAAC,CAAA;CAC5E"}

package/dist/api/effect/permissions.js

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

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

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

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

@@ -0,0 +1,83 @@
+import type { PresenceInput, PresenceFailure } from "#sdk/presence";
+import type * as Effect from "effect/Effect";
+/** Set the bot's status or select community members whose presence updates the bot should receive.
+ * The client retains these requests in memory, not across process restarts.
+ * Outgoing status updates send to every live locally owned shard and are spaced by at least four seconds per shard. Member selections are separate bounded gateway presence requests.
+ * No provider acknowledgement or recipient-delivery guarantee is available. The SDK performs no remote membership lookup or self filtering. Fluxer owns access and filtering
+ *
+ * @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
+     * Unexpected defects remain in the Effect cause
+     *
+     * @example
+     * ```ts
+     * import { Effect } from "effect"
+     * import { MemberMentionPreferences, type Client } from "@neontechspace/fluxerly/effect"
+     * export const botProfileExample = (client: Client, guildId: string) => Effect.gen(function* () {
+     *     yield* client.presence.set({ status: "online", customStatus: { text: "Ready", emoji: { name: "🌱" } } })
+     *     return yield* client.members.editSelf(guildId, { nickname: "Support", mentionFlags: MemberMentionPreferences.PreferNoMention })
+     * })
+     * ```
+     */
+    set(input: PresenceInput): Effect.Effect<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
+     * Unexpected defects remain in the Effect cause
+     *
+     * @example
+     * ```ts
+     * import { Effect } from "effect"
+     * import type { Client } from "@neontechspace/fluxerly/effect"
+     * export const watchSelectedMember = (client: Client, guildId: string, memberId: string) => Effect.gen(function* () {
+     *     const subscription = yield* client.on("presenceUpdate", (presence) =>
+     *         Effect.sync(() => { if (presence.guildId === guildId && presence.userId === memberId) void presence.status }),
+     *     )
+     *     return yield* client.presence.setMembers(guildId, [memberId]).pipe(
+     *         Effect.as(subscription),
+     *         Effect.onError(() => subscription.close()),
+     *     )
+     * })
+     * ```
+     */
+    setMembers(guildId: string, memberIds: readonly string[]): Effect.Effect<void, PresenceFailure>;
+}
+//# sourceMappingURL=presence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../../../src/api/effect/presence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACnE,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAA;AAE5C;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACrB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,GAAG,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAAC,CAAA;IAC/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6CG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAAC,CAAA;CAClG"}

package/dist/api/effect/presence.js

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

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

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

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

@@ -0,0 +1,27 @@
+import type * as Effect from "effect/Effect";
+import type { RestRequest, 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.
+ * Effects start when run, need no gateway connection and default to the client's rest.defaultTimeoutMs deadline.
+ * Interruption and unexpected faults remain in Cause rather than becoming RestRequestError
+ *
+ * @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: RestRequest): Effect.Effect<RestResponse<T>, RestRequestFailure>;
+}
+//# sourceMappingURL=rest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rest.d.ts","sourceRoot":"","sources":["../../../src/api/effect/rest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAA;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAE9E;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IACzB;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAA;CAC/F"}

package/dist/api/effect/rest.js

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

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

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

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

@@ -0,0 +1,104 @@
+import type { GuildRole, RoleReference, RolePosition, RoleHoistPosition, RoleCreate, RoleEdit, GuildOperationFailure, GuildOperationOptions, GuildAuditOperationOptions } from "#sdk/guilds";
+import type * as Effect from "effect/Effect";
+/** Read or change community roles, their permission bits and their ordering.
+ * Methods return Effects and share Guilds' HTTP concurrency limits, deadlines and read retries.
+ * Writes retry only confirmed 429 rejections.
+ * Fluxer enforces permissions and hierarchy, and the SDK does not predict permissions locally.
+ * Interruption waits for owned cleanup but cannot undo write requests already sent. Success is not a gateway acknowledgement.
+ * Expected failures use GuildOperationError or ClientClosedError. Defects and interruption retain Cause.
+ * Inputs are copied on execution, not Effect construction. Returned roles contain bigint permissions and require explicit JSON conversion.
+ * Every remote role mutation accepts GuildAuditOperationOptions. The fetchAll method rejects auditReason
+ *
+ * @category Roles and permissions
+ */
+export interface Roles {
+    /**
+     * Look up a role by decimal guildId and id in the enabled cache, including the everyone role.
+     * No request is made.
+     * The cache misses, stale-snapshot warnings, misuse and recency rules of guilds.get apply
+     */
+    get(role: RoleReference): Effect.Effect<GuildRole | undefined>;
+    /**
+     * Fetch the community's current role list, including everyone, in server order.
+     * This always reads remotely, without pagination or background refresh
+     */
+    fetchAll(guildId: string, options?: GuildOperationOptions): Effect.Effect<readonly GuildRole[], GuildOperationFailure>;
+    /**
+     * Create a role with a name, optional color and permission flags.
+     * The permissions input defaults to 0n, rather than copying the everyone role's grants.
+     * Supplied permissions must be from 0n through 9_223_372_036_854_775_807n.
+     * Explicit permissions use Fluxer's feature opt-in for ViewChannelMembers.
+     * The result reports the actual server grants, which can differ from the request.
+     * Use a separate edit to change hoist or mentionable settings.
+     * The application manages the created role afterward.
+     * After an unknown outcome, use fetchAll before deciding whether to create again
+     *
+     * @example
+     * ```ts
+     * import { Permissions, type Client } from "@neontechspace/fluxerly/effect"
+     * export const createRoleExample = (client: Client, guildId: string) =>
+     *     client.roles.create(guildId, {
+     *         name: "Readers",
+     *         permissions: Permissions.ViewChannel | Permissions.ReadMessageHistory,
+     *     })
+     * ```
+     */
+    create(guildId: string, input: RoleCreate, options?: GuildAuditOperationOptions): Effect.Effect<GuildRole, GuildOperationFailure>;
+    /**
+     * Change only supplied role fields and return the server's snapshot.
+     * Empty inputs and unknown fields fail locally.
+     * The permissions input replaces all raw grants rather than adding flags, and can set or clear ViewChannelMembers.
+     * The replacement must be from 0n through 9_223_372_036_854_775_807n, and larger received masks cannot be written unchanged.
+     * The everyone role accepts only color and permissions.
+     * Other supplied fields fail, even in a mixed input
+     */
+    edit(role: RoleReference, input: RoleEdit, options?: GuildAuditOperationOptions): Effect.Effect<GuildRole, GuildOperationFailure>;
+    /**
+     * Delete a role and remove its member assignments in Fluxer.
+     * The everyone role cannot be deleted.
+     * Fluxer removes the role from each member in separate writes before it deletes the role, and does not roll them back.
+     * A failure can leave the role in place after some members already lost it, so fetch the role and the affected members again before retrying.
+     * HTTP 204 succeeds with no value, without proving member-event delivery.
+     * Snapshots already returned to the caller remain unchanged
+     */
+    delete(role: RoleReference, options?: GuildAuditOperationOptions): Effect.Effect<void, GuildOperationFailure>;
+    /**
+     * Change role hierarchy positions using distinct role IDs and nonnegative safe-integer positions.
+     * The everyone role cannot move.
+     * HTTP 204 succeeds with no value and no new role list.
+     * Fluxer normalizes manageable positions, so use fetchAll if final order matters.
+     * This is not a transaction.
+     * A failure can leave partial changes, requiring a fresh read before recovery
+     */
+    reorder(guildId: string, positions: readonly RolePosition[], options?: GuildAuditOperationOptions): Effect.Effect<void, GuildOperationFailure>;
+    /**
+     * Set roles' display positions without changing their permission hierarchy or enabling hoist.
+     * Pass a nonempty list of distinct role IDs with integer hoistPosition values from -2,147,483,648 through 2,147,483,647.
+     * The everyone role is excluded.
+     * Fluxer checks ManageRoles and hierarchy.
+     * HTTP 204 succeeds with no value, not a role list.
+     * Successful writes and writes with unknown outcomes invalidate cached guild roles and conflicting pending reads.
+     * Failure or cancellation can leave partial changes.
+     * Refetch before deciding to replay
+     *
+     * @example
+     * ```ts
+     * import { type Client } from "@neontechspace/fluxerly/effect"
+     * export function orderRoleDisplay(client: Client, guildId: string, roleId: string) {
+     *     return client.roles.setHoistPositions(guildId, [{ id: roleId, hoistPosition: 0 }])
+     * }
+     * ```
+     */
+    setHoistPositions(guildId: string, positions: readonly RoleHoistPosition[], options?: GuildAuditOperationOptions): Effect.Effect<void, GuildOperationFailure>;
+    /**
+     * Clear display-position assignments across the community, including roles above the bot.
+     * Fluxer requires ManageRoles.
+     * Permission hierarchy and hoist flags remain unchanged.
+     * HTTP 204 succeeds with no value, not a role list.
+     * Changes are not transactional and a failure can be partial.
+     * Successful writes and writes with unknown outcomes invalidate cached guild roles.
+     * Refetch to resolve an unknown outcome
+     */
+    resetHoistPositions(guildId: string, options?: GuildAuditOperationOptions): Effect.Effect<void, GuildOperationFailure>;
+}
+//# sourceMappingURL=roles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"roles.d.ts","sourceRoot":"","sources":["../../../src/api/effect/roles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,SAAS,EACT,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,UAAU,EACV,QAAQ,EACR,qBAAqB,EACrB,qBAAqB,EACrB,0BAA0B,EAC7B,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAA;AAE5C;;;;;;;;;;GAUG;AACH,MAAM,WAAW,KAAK;IAClB;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC,CAAA;IAC9D;;;OAGG;IACH,QAAQ,CACJ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,qBAAqB,GAChC,MAAM,CAAC,MAAM,CAAC,SAAS,SAAS,EAAE,EAAE,qBAAqB,CAAC,CAAA;IAC7D;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CACF,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE,0BAA0B,GACrC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,qBAAqB,CAAC,CAAA;IAClD;;;;;;;OAOG;IACH,IAAI,CACA,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,QAAQ,EACf,OAAO,CAAC,EAAE,0BAA0B,GACrC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,qBAAqB,CAAC,CAAA;IAClD;;;;;;;OAOG;IACH,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,0BAA0B,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAA;IAC7G;;;;;;;OAOG;IACH,OAAO,CACH,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,YAAY,EAAE,EAClC,OAAO,CAAC,EAAE,0BAA0B,GACrC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAA;IAC7C;;;;;;;;;;;;;;;;;OAiBG;IACH,iBAAiB,CACb,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,iBAAiB,EAAE,EACvC,OAAO,CAAC,EAAE,0BAA0B,GACrC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAA;IAC7C;;;;;;;;OAQG;IACH,mBAAmB,CACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,0BAA0B,GACrC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAA;CAChD"}

package/dist/api/effect/roles.js

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

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

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

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

@@ -0,0 +1,76 @@
+import * as Config from "effect/Config";
+import * as Context from "effect/Context";
+import * as Layer from "effect/Layer";
+import * as Redacted from "effect/Redacted";
+import { type Client, type ClientOptions } from "./client.js";
+/**
+ * Client settings for FluxerClient.layerConfig: The settings of createClient, where the token and any other top-level
+ * setting can instead be an Effect Config read when the layer is built.
+ * The token can be a Config of a Redacted or plain string, such as `Config.Redacted("FLUXER_BOT_TOKEN")`, or a Redacted
+ * or plain string. A Redacted token stays wrapped until it is passed to the client, and the client never logs it.
+ * Nested settings are not read from Config individually. Supply a Config of the whole top-level setting instead
+ *
+ * @category Client and lifecycle
+ */
+export type FluxerClientConfigOptions<E = never, R = never> = {
+    readonly [K in Exclude<keyof ClientOptions<E, R>, "token">]?: ClientOptions<E, R>[K] | Config.Config<ClientOptions<E, R>[K]>;
+} & {
+    /** Bot token, usually `Config.Redacted("FLUXER_BOT_TOKEN")`. A Config is read when the layer is built */
+    readonly token: Config.Config<Redacted.Redacted<string>> | Config.Config<string> | Redacted.Redacted<string> | string;
+};
+declare const FluxerClient_base: Context.ServiceClass<FluxerClient, "@neontechspace/fluxerly/FluxerClient", Client<import("../../messages.js").Message>>;
+/**
+ * Effect service holding one native client, for applications that assemble their program from Layers.
+ * Build it with FluxerClient.layer(options) or FluxerClient.layerConfig(options), and read it with
+ * `yield* FluxerClient` or FluxerClient.use.
+ * The layer creates the client in the layer's Scope and calls shutdown when that Scope closes, awaiting SDK cleanup.
+ * Building the layer does not connect the gateway or make a request. Register handlers first, then call client.connect()
+ * or client.run(), so no event arrives before its handler exists. HTTP operations work without connecting.
+ * Each build of the layer creates its own client. Provide one layer value to share its client, since Effect reuses a
+ * layer value within one provide.
+ * The service holds the full Message shape. For a messageFields selection, call createClient directly instead
+ * @example
+ * ```ts
+ * import { Config, Effect } from "effect"
+ * import { FluxerClient } from "@neontechspace/fluxerly/effect"
+ *
+ * const program = Effect.gen(function* () {
+ *     const client = yield* FluxerClient
+ *     yield* client.on("messageCreate", (message) =>
+ *         message.content === "!ping"
+ *             ? client.messages.reply(message, { content: "Pong!" }).pipe(Effect.asVoid)
+ *             : Effect.void,
+ *     )
+ *     yield* client.run()
+ * })
+ *
+ * export const main = program.pipe(
+ *     Effect.scoped,
+ *     Effect.provide(FluxerClient.layerConfig({ token: Config.Redacted("FLUXER_BOT_TOKEN") })),
+ * )
+ * ```
+ *
+ * @category Client and lifecycle
+ */
+export declare class FluxerClient extends FluxerClient_base {
+    /**
+     * Build the FluxerClient service from createClient settings.
+     * Invalid settings, including a missing or blank token, are misuse and the layer dies with ConfigurationError.
+     * Services required by the settings, such as those of an onError hook, become the layer's requirements, and native
+     * logging uses the Effect logger in effect where the layer is built.
+     * The client is created without connecting and is shut down when the layer's Scope closes
+     */
+    static layer<E = never, R = never>(options: ClientOptions<E, R>): Layer.Layer<FluxerClient, never, R>;
+    /**
+     * Build the FluxerClient service from settings that may be read from Effect Config, such as
+     * `{ token: Config.Redacted("FLUXER_BOT_TOKEN") }`.
+     * Config values are read from the current ConfigProvider, by default the process environment, when the layer is built.
+     * A missing or unparsable Config value fails the layer with ConfigError before any client exists.
+     * A token that is present but blank, or another invalid setting, is misuse and the layer dies with ConfigurationError,
+     * as in FluxerClient.layer. The token stays Redacted until the client receives it and is never logged.
+     * The client is created without connecting and is shut down when the layer's Scope closes
+     */
+    static layerConfig<E = never, R = never>(options: FluxerClientConfigOptions<E, R>): Layer.Layer<FluxerClient, Config.ConfigError, R>;
+}
+export {};
+//# sourceMappingURL=service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/api/effect/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AAEzC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAgB,KAAK,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3E;;;;;;;;GAQG;AACH,MAAM,MAAM,yBAAyB,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,KAAK,IAAI;IAC1D,QAAQ,EAAE,CAAC,IAAI,OAAO,CAAC,MAAM,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EACxD,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACrE,GAAG;IACA,yGAAyG;IACzG,QAAQ,CAAC,KAAK,EACV,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,CAAA;CAC5G,CAAA;;AAmBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,YAAa,SAAQ,iBAA+E;IAC7G;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC,CAEpG;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,KAAK,EACnC,OAAO,EAAE,yBAAyB,CAAC,CAAC,EAAE,CAAC,CAAC,GACzC,KAAK,CAAC,KAAK,CAAC,YAAY,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAIlD;CACJ"}