@neontechspace/fluxerly 1000.0.0-nightly.12

package/dist/index.d.ts

@@ -0,0 +1,228 @@
+/**
+ * Build a Fluxer bot with JavaScript or TypeScript.
+ * Import from @neontechspace/fluxerly and call its methods directly
+ *
+ * @example
+ * ```ts
+ * import { runBot } from "@neontechspace/fluxerly"
+ *
+ * // A failed run is logged and sets process.exitCode, and Ctrl+C stops the bot cleanly, so the returned Result needs
+ * // no further handling here
+ * await runBot({
+ *     token: process.env.FLUXER_BOT_TOKEN,
+ *     commands: { prefix: "!", commands: { ping: { execute: ({ reply }) => reply("Pong!") } } },
+ * })
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { createClient, orThrow } from "@neontechspace/fluxerly"
+ *
+ * await using client = createClient({ token: process.env.FLUXER_BOT_TOKEN })
+ *
+ * client.on("messageCreate", (message) =>
+ *     message.content === "!ping" ? client.messages.reply(message, "Pong!") : undefined,
+ * )
+ *
+ * // Run connects, recovers and stays pending until the client ends, and await using shuts it down afterwards
+ * orThrow(await client.run())
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { permissionBits, colors, text } from "@neontechspace/fluxerly"
+ *
+ * export function pureHelpersExample(bits: bigint, content: string) {
+ *     return {
+ *         required: permissionBits.from(["ManageRoles", "ManageMessages"]),
+ *         missing: permissionBits.missing(bits, ["ManageRoles", "ManageMessages"]),
+ *         inspection: permissionBits.inspect(bits),
+ *         color: colors.parse("#ff8800"),
+ *         chunks: text.split(content, { maxLength: 2_000 }),
+ *     }
+ * }
+ * ```
+ *
+ * @remarks
+ * This default API also includes webhooks, OAuth and local helpers, without requiring an Effect runtime.
+ * Network and other I/O operations return ResultAsync, which starts when called, not when awaited.
+ * Await it to get a Result: If isErr() is true, read error for the expected failure, otherwise read value.
+ * Call orThrow to get the value and throw the error instead, and return a Result from a handler to report its failure.
+ * Methods returning AsyncIterable start work when a for await loop pulls its first item.
+ * Local work returns plain values: Creating clients and routers, registering handlers, cache lookups and pure helpers.
+ * Misuse of those, such as invalid options or a missing token, throws ConfigurationError or the helper's own error at once.
+ * Unexpected SDK or cleanup failures throw or reject with SdkDefect.
+ * Use `await using` or try/finally to release client resources even when work fails
+ *
+ * The [glossary](https://preview.fluxerly.neontechspace.com/docs/latest/glossary/) defines terms such as guild, gateway,
+ * shard, frozen snapshot and uncertain write
+ *
+ * Coding agents: read node_modules/@neontechspace/fluxerly/agents/AGENTS.md before writing code with this package
+ *
+ * @packageDocumentation
+ */
+import "./internal/node-version.js";
+export { MemberChunkError } from "./member-chunks.js";
+export type { MemberChunk, MemberChunkQuery, MemberChunkFailure, MemberChunkOptions, DefaultMemberChunkOptions, } from "./member-chunks.js";
+export { CountOperationError } from "./counts.js";
+export type { CountOperation, CountOperationFailure, CountOperationOptions, DefaultCountOperationOptions, GuildCount, GuildCountsResult, ChannelMemberCount, ChannelMemberCountsResult, } from "./counts.js";
+export type { ColorInput, RgbColor } from "./colors.js";
+export type { TextSplitOptions } from "./text.js";
+export { AssetFormats, AssetUrlError } from "./assets.js";
+export type { AssetFormat, AssetUrlOptions, StickerAssetUrlOptions } from "./assets.js";
+export { HelperError, TimestampStyles } from "./helpers.js";
+export type { ChannelLinkTarget, CustomEmojiMarkup, InstallationLinkOptions, Mention, PermissionName, PermissionBitInspection, TimestampMarkup, TimestampStyle, } from "./helpers.js";
+export type { GuildListQuery, GuildListSummary } from "./guilds.js";
+export type { GuildIterationQuery } from "./pagination.js";
+export { GuildMemberJoinSourceTypes } from "./member-search.js";
+export type { GuildMemberJoinSourceType } from "./member-search.js";
+export type { PermissionInput, PermissionTarget } from "./permissions.js";
+export { hierarchy } from "./role-hierarchy.js";
+export type { HierarchyHelpers, RoleHierarchyInput } from "./role-hierarchy.js";
+export { BotApplicationOperationError } from "./application.js";
+export type { BotApplication, BotApplicationOperation, BotApplicationOperationFailure, BotApplicationOperationOptions, DefaultBotApplicationOperationOptions, } from "./application.js";
+export type { MemberSearchQuery, MemberSearchPage, MemberSearchHit, MemberSearchIterationLimits, } from "./member-search.js";
+export type { MessageSearchAuthorType, MessageSearchChannel, MessageSearchContentType, MessageSearchContext, MessageSearchEmbedType, MessageSearchIndexingPage, MessageSearchIterationLimits, MessageSearchOptions, MessageSearchPage, MessageSearchQuery, MessageSearchResultsPage, DefaultMessageSearchOptions, } from "./message-search.js";
+export type { DiscoveryApplication, DiscoveryApplicationInput, DiscoveryApplicationEdit, DiscoveryCategory, DiscoverySearchPage, DiscoverySearchQuery, DiscoveryStatus, } from "./discovery.js";
+export type { DiscoveryCategoryCount, DiscoveryGuild } from "./discovery.js";
+export { DiscoveryCategories } from "./discovery.js";
+export type { AuditLogEntry, AuditLogPage, AuditLogQuery, AuditLogIterationQuery } from "./audit-logs.js";
+export type { GuildCreate, GuildHealthUpdate, GuildEmojisUpdate, GuildStickersUpdate, GuildLifecycleEvents, WebhooksUpdate, InviteDeleteEvent, GuildAuditLogEntryCreate, } from "./events.js";
+export { AuditLogActions } from "./audit-logs.js";
+export type { AuditLogActionType, AuditLogPermissionsDiff, AuditLogChangeValue, AuditLogChange, AuditLogOptions, AuditLogWebhook, } from "./audit-logs.js";
+export type { GuildEdit, GuildVanityUrl, GuildVanityUrlUsage } from "./guilds.js";
+export { GuildSystemChannelFlags, GuildDefaultMessageNotifications, GuildVerificationLevels, GuildMfaLevels, GuildExplicitContentFilters, GuildContentWarningLevels, GuildSplashCardAlignments, GuildFeatureToggles, } from "./guilds.js";
+export type { GuildSystemChannelFlag, GuildDefaultMessageNotification, GuildVerificationLevel, GuildMfaLevel, GuildExplicitContentFilter, GuildContentWarningLevel, GuildSplashCardAlignment, GuildFeatureToggle, } from "./guilds.js";
+export type { Invite, InviteCreate, InviteMetadata } from "./invites.js";
+export type { GuildEmoji, GuildSticker, ExpressionReference, ExpressionMetadata, ExpressionSourceGuild, EmojiCreate, EmojiEdit, StickerCreate, StickerEdit, ExpressionBatch, ExpressionDeleteOptions, DefaultExpressionDeleteOptions, } from "./expressions.js";
+export { PresenceError } from "./presence.js";
+export type { PresenceInput, PresenceStatus, CustomStatusInput, CustomStatusEmoji, PresenceFailure, } from "./presence.js";
+export type { MemberProfileEdit, MemberMentionPreference } from "./guilds.js";
+export { GuildMemberProfileFlags, MemberMentionPreferences } from "./guilds.js";
+export { UserOperationError } from "./users.js";
+export type { User, UserProfile, UserProfileFields, UserProfileQuery, DirectMessageChannel, DirectMessageGroupEdit, DirectMessageLatestMessages, DirectMessageRecipientChange, UserOperation, UserOperationFailure, UserOperationOptions, DefaultUserOperationOptions, } from "./users.js";
+export { WebhookOperationError, WebhookType } from "./webhooks.js";
+export type { Webhook, WebhookBase, IncomingWebhook, ChannelFollowerWebhook, UnknownWebhook, WebhookSourceGuild, WebhookSourceChannel, WebhookCredentials, CreatedWebhook, WebhookCreate, WebhookEdit, WebhookTokenEdit, WebhookMessageInput, WebhookMessageReference, WebhookReplyReference, WebhookForwardReference, WebhookMessageEdit, WebhookClientOptions, WebhookOperation, WebhookOperationOptions, DefaultWebhookOperationOptions, WebhookOperationFailure, } from "./webhooks.js";
+export { PaginationError } from "./pagination.js";
+export type { PaginationQuery, HistoryIterationQuery, UserIterationQuery, PinIterationQuery, PaginationOperation, } from "./pagination.js";
+export type { EmbedInput, EmbedAuthorInput, EmbedFooterInput, EmbedMediaInput, EmbedFieldInput, Embed, EmbedChild, EmbedAuthor, EmbedProvider, EmbedFooter, EmbedMedia, EmbedField, } from "./embeds.js";
+export type { MessageBody } from "./messages.js";
+export { AttachmentDownloadError, AttachmentRefreshError } from "./attachments.js";
+export type { Attachment, AttachmentBytesInput, AttachmentDownloadFailure, AttachmentDownloadOptions, AttachmentFileInput, AttachmentFileSource, AttachmentInput, AttachmentRefreshFailure, AttachmentRefreshOperation, AttachmentRefreshOptions, AttachmentReference, AttachmentStreamInput, AttachmentStreamReadResult, AttachmentStreamReader, AttachmentStreamReaderOptions, AttachmentStreamSource, DefaultAttachmentDownloadOptions, DefaultAttachmentRefreshOptions, DefaultAttachmentStreamOptions, RefreshedAttachmentUrl, } from "./attachments.js";
+export type { ReactionEmojiInput, ReactionUsersQuery, ReactionUsersPage, ReactionUser, ReactionEmoji, ReactionTarget, MessageReaction, MessageReactionBatch, MessageReactionEmojiRemoval, } from "./reactions.js";
+export { CriticalWorkerStoppedError } from "./bot-runner.js";
+export type { RunBotOptions } from "./bot-runner.js";
+export { OAuthOperationError, OAuthScopes } from "./oauth.js";
+export type { OAuthAuthorizationInput, OAuthActiveIntrospection, OAuthConnection, OAuthCodeExchangeInput, OAuthConfig, OAuthIdentity, OAuthInactiveIntrospection, OAuthIntrospection, OAuthOperation, OAuthOperationFailure, OAuthOperationOptions, OAuthPkce, OAuthScope, OAuthTokens, DefaultOAuthOperationOptions, } from "./oauth.js";
+export { builders, EmbedBuilder, MessageBuilder } from "./builders.js";
+export type { EmbedFieldOptions, MissingMessageBody } from "./builders.js";
+export type { CommandArgumentSchema, CommandArgumentMetadata, CommandArgumentMention, CommandArgumentType, CommandArgumentDescriptor, CommandArgumentUser, CommandArgumentChannel, CommandArgumentRole, CommandArgumentText, CommandArgumentInteger, CommandArgumentNumber, CommandArgumentBoolean, CommandArgumentId, CommandArgumentChoice, CommandArgumentUserSelection, CommandArgumentChannelSelection, CommandArgumentRoleSelection, CommandArgumentMember, CommandArgumentDuration, CommandArgumentCustom, CommandArgumentValues, CommandArgumentValue, CommandArgumentRejectionReason, } from "./command-arguments.js";
+export type { CommandContextHelpOptions, CommandHelpOptions } from "./command-help.js";
+export type { CommandCooldownClaim, CommandCooldownRequest, CommandCooldownPer, PrefixCommandGuardResult, PrefixCommandPrefixValue, PrefixCommandParsing, MemoryCooldownOptions, PrefixCommandDefinition, PrefixCommandGroupDefinition, PrefixCommandGroupMetadata, PrefixCommandRegistrationOptions, PrefixCommandMetadata, PrefixCommandParse, PrefixCommandParseInput, PrefixCommandParseRejection, PrefixCommandPrefix, PrefixCommandRejection, PrefixCommandUnmatched, PrefixCommandsOptions, } from "./commands.js";
+export type { DefaultCooldownStore, MemoryCooldownStore, DefaultPrefixCommand, DefaultPrefixCommandContext, DefaultPrefixCommandExecutionContext, DefaultPrefixCommandCooldown, DefaultPrefixCommandUnmatchedContext, DefaultPrefixCommandsOptions, DefaultPrefixCommandGuard, DefaultPrefixCommandMiddleware, DefaultPrefixCommandRejectionFeedback, DefaultPrefixCommandRouter, } from "./default-commands.js";
+export { SupervisorChildError, SupervisorError } from "./supervisor.js";
+export type { SupervisorAssignment, SupervisorAssignmentOptions, SupervisorChildDiagnostics, SupervisorChildOptions, SupervisorChildSharding, SupervisorChildState, SupervisorChildStatus, SupervisorFileUrl, SupervisorIdentifyOptions, SupervisorOptions, SupervisorRestartOptions, SupervisorState, SupervisorStatus, SupervisorWaitOptions, } from "./supervisor.js";
+export type { DefaultSupervisor, DefaultSupervisorChildContext, DefaultSupervisorChildOptions, DefaultSupervisorTools, } from "./default-supervisor.js";
+export type { ClientCounters, ErrorInfo, LogCategory, LogLevel, LoggingOptions, LogLevelSettings, LogRecord, LogSink, LogThreshold, } from "./logging.js";
+export type { HandlerObservation, Observation, Observer, RateLimitObservation, ReconnectObservation, RestObservation, ResumeObservation, } from "./observer.js";
+export type { FailureKind, FailureMessageReference, FailureReport } from "./failures.js";
+export { describeError, errors } from "./error-tools.js";
+export type { DescribeErrorOptions, ErrorTools } from "./error-tools.js";
+export type { MessageCacheSettings, MessageCacheOptions } from "./cache.js";
+export type { ResourceCacheSettings } from "./cache.js";
+export { ChannelOperationError, ChannelType } from "./channels.js";
+export type { PermissionOverwrite, GuildChannel, GuildChannelBase, GuildTextChannelBase, GuildTextChannel, GuildAnnouncementChannel, GuildVoiceChannel, GuildCategoryChannel, GuildLinkChannel, GuildUnknownChannel, ChannelCreateBase, TextChannelCreate, AnnouncementChannelCreate, VoiceChannelCreate, CategoryChannelCreate, LinkChannelCreate, ChannelCreate, ChannelEdit, ChannelPosition, ChannelFollowInput, FollowedChannel, ChannelFollowerStats, GuildChannelUpdateBulk, ChannelOperation, ChannelOperationFailure, ChannelOperationOptions, DefaultChannelOperationOptions, ChannelAuditOperationOptions, DefaultChannelAuditOperationOptions, } from "./channels.js";
+export { ChannelFlags, ForumLayout, ForumSortOrder, ThreadAutoArchiveMinutes, isThreadChannel } from "./channels.js";
+export type { GuildThreadChannelBase, GuildAnnouncementThreadChannel, GuildPublicThreadChannel, GuildPrivateThreadChannel, GuildThreadChannel, ThreadMembership, ThreadMember, GuildForumChannelBase, GuildForumChannel, GuildMediaChannel, ForumTag, ForumDefaultReaction, } from "./channels.js";
+export type { Threads } from "./api/default/threads.js";
+export type { ThreadCreate, ThreadFromMessageCreate, ForumPostMessage, ForumPostCreate, ForumPost, ThreadEdit, ArchivedThreadScope, ArchivedThreadQuery, ArchivedThreadPage, ThreadSearchQuery, ThreadSearchIndexingPage, ThreadSearchResultsPage, ThreadSearchPage, ThreadMemberQuery, ThreadMemberPageQuery, ThreadMemberIterationQuery, } from "./threads.js";
+export type { ThreadParentDefaults, ForumTagInput, ForumDefaultReactionInput, ForumChannelCreateBase, ForumChannelCreate, MediaChannelCreate, } from "./channels.js";
+export type { WebhookForumPostOptions, WebhookMessageOperationOptions, DefaultWebhookMessageOperationOptions, } from "./webhooks.js";
+export type { ThreadCreateEvent, ThreadDeletion, ThreadListSync, ThreadMembersUpdate } from "./events.js";
+export { GuildOperationError, Permissions } from "./guilds.js";
+export type { Guild, GuildDeletion, GuildRole, GuildRoleUpdateBulk, RoleReference, RolePosition, RoleHoistPosition, RoleCreate, RoleEdit, GuildMember, MemberReference, VoiceConnectionReference, VoiceMuteInput, VoiceDeafenInput, MemberQuery, GuildOperation, GuildOperationFailure, GuildOperationOptions, DefaultGuildOperationOptions, CanManageOptions, DefaultCanManageOptions, GuildAuditOperationOptions, DefaultGuildAuditOperationOptions, } from "./guilds.js";
+export type { BanInput, GuildBan, ModerationOptions, DefaultModerationOptions, TimeoutOptions, DefaultTimeoutOptions, } from "./guilds.js";
+export type { MessagePinsQuery, MessagePinsPage, MessagePin, ChannelPinsUpdate } from "./pins.js";
+export type { ReactionCollectorOptions, DefaultReactionCollectorOptions, ReactionCollectorResult, } from "./collectors.js";
+export { CollectorError } from "./collectors.js";
+export type { CollectorOptions, DefaultCollectorOptions, CollectorResult, CollectorFailure } from "./collectors.js";
+export type { PageInput, PageTurners, PaginateOptions, DefaultPaginateOptions, ChannelPaginateOptions, DefaultChannelPaginateOptions, PaginateResult, PaginateFailure, } from "./reaction-pages.js";
+export { EventOverflowError, EventReadBusyError, MessageError, MessageOperationError } from "./message-errors.js";
+export { EventWaitError } from "./message-errors.js";
+export type { EventWaitFailure } from "./message-errors.js";
+export type { EventWaitOptions } from "./events.js";
+export type { ApiErrorCode, ApiErrorDetail, ApiProviderCode, ApiValidationCode, ApiValidationErrorDetail, } from "./api-errors.js";
+export type { InputValidationConstraint, InputValidationDetail } from "./input-validation.js";
+export { MessageCleanupError } from "./message-cleanup.js";
+export { MessageFlags, MessageType } from "./messages.js";
+export type { EventReadError, SendError, MessageOperationFailure } from "./message-errors.js";
+export type { MessageCleanupBatch, MessageCleanupErrorReason, MessageCleanupFailure, MessageCleanupFailureMetadata, MessageCleanupOptions, MessageCleanupOutcome, MessageCleanupPlan, MessageCleanupProgress, MessageCleanupReport, MessageCleanupSelection, MessageCleanupStopReason, DefaultMessageCleanupOptions, } from "./message-cleanup.js";
+export type { Message, MessageCore, MessageField, MessageFields, SelectedMessage, ForwardMessageInput, MessageSnapshot, MessageFlag, MessageSticker, MessageUser, ReferencedMessage, MessageChannelMention, MessageReactionEmoji, MessageReactionSummary, MessageContextReference, CrosspostSource, CrosspostSourceGuild, MessageHistoryQuery, MessageDeletion, MessageBulkDeletion, MessageReference, MessageInput, MessageNonce, ReplyInput, AllowedMentions, SendOptions, DefaultSendOptions, EditMessageInput, MessageOperationOptions, DefaultMessageOperationOptions, MessageAuditOperationOptions, DefaultMessageAuditOperationOptions, OwnMessageDeletionOptions, DefaultOwnMessageDeletionOptions, } from "./messages.js";
+export type { EventBufferOptions, HandlerOptions, EventMap, EventName, RawDispatch, TypingStart, PresenceUpdate, ObservedPresenceStatus, ObservedCustomStatus, ObservedCustomStatusEmoji, PresenceUpdateBulk, VoiceState, VoiceStateSnapshot, } from "./events.js";
+export type { CacheDiagnostic, CacheEntriesOptions, CachedResources, CacheKind, ClientDiagnostics, ClientOptions, ConnectionRecoveryOptions, ConnectionState, OperationSignal, OperationOptions, ScheduleOptions, ShutdownOptions, } from "./client.js";
+export type { InstanceDomainMigration, InstanceEndpoints, InstanceOptions, InstanceResolveError, InstanceResolveOptions, ResolvedInstance, } from "./instance.js";
+export { ApplicationError, AuthenticationError, ShardConnectionError, CancelledError, ClientBusyError, ClientClosedError, ConfigurationError, ConnectionError, ConnectionTimeoutError, FluxerlyError, RateLimitError, SdkDefect, } from "./errors.js";
+export type { ConnectError, ConnectionFailure, DefectReason, FluxerlyErrorJson, FluxerlyErrorOptions, OperationErrorOptions, OperationOutcome, OperationReason, } from "./errors.js";
+export type { ShardingOptions, ShardRecoveryDiagnostic, ShardState } from "./sharding.js";
+export type { CallCreate, CallDelete, CallUpdate, CallVoiceState, EntranceSoundPlay, EventContext, EventInvocation, EventInvocationOf, } from "./events.js";
+export type { CacheChange, CacheObserverOptions } from "./cache.js";
+export type { IdentifyCoordinator, SessionSnapshot, SessionStore } from "./sharding.js";
+export { fileSessionStore } from "./sharding.js";
+export type { GatewayOptions } from "./client.js";
+export type { EventMiddleware, MiddlewareRegistration } from "./api/default/events.js";
+export type { CacheObserver } from "./api/default/cache.js";
+export { oauth } from "./api/default/oauth.js";
+export type { OAuthClient } from "./api/default/oauth.js";
+export { format, snowflakes, display, permissionBits, colors, text, links, assets } from "./api/default/helpers.js";
+export { commands } from "./api/default/commands.js";
+export { supervisor } from "./api/default/supervisor.js";
+export type { Subscription, EventSubscription, EventHandlerOptions, DefaultEventWaitOptions, StateObserver, } from "./api/default/events.js";
+export type { Attachments } from "./api/default/attachments.js";
+export type { Messages } from "./api/default/messages.js";
+export type { Collector, ReactionCollector } from "./api/default/collectors.js";
+export type { AuditLogs } from "./api/default/audit-logs.js";
+export type { Invites } from "./api/default/invites.js";
+export type { Emojis } from "./api/default/emojis.js";
+export type { Stickers } from "./api/default/stickers.js";
+export type { Discovery } from "./api/default/discovery.js";
+export type { Guilds } from "./api/default/guilds.js";
+export type { Channels } from "./api/default/channels.js";
+export type { Members } from "./api/default/members.js";
+export type { PermissionHelpers } from "./api/default/permissions.js";
+export type { Roles } from "./api/default/roles.js";
+export type { Webhooks } from "./api/default/webhooks.js";
+export { createWebhookClient } from "./api/default/webhook-client.js";
+export type { WebhookClient } from "./api/default/webhook-client.js";
+export type { ClientCache } from "./api/default/cache.js";
+export type { RestRequests } from "./api/default/rest.js";
+export type { GatewayCommands } from "./api/default/gateway.js";
+export type { ClientLogging } from "./api/default/logging.js";
+export { RestRequestError } from "./rest.js";
+export type { DefaultRestRequest, RestOperation, RestOptions, RestRequest, RestRequestFailure, RestResponse, TransportOptions, WebSocketLike, WebSocketOptions, } from "./rest.js";
+export { GatewaySendError } from "./gateway.js";
+export type { GatewaySendFailure } from "./gateway.js";
+export { createClient } from "./api/default/client.js";
+export type { Client, ScheduledTask } from "./api/default/client.js";
+export type { Instance, DefaultInstanceResolveOptions } from "./api/default/instance.js";
+export type { Presence } from "./api/default/presence.js";
+export type { CurrentBotApplication } from "./api/default/application.js";
+export type { Users } from "./api/default/users.js";
+export type { DirectMessages } from "./api/default/direct-messages.js";
+export { runBot } from "./api/default/bot.js";
+export type { BotCommandsOptions, BotEventContext, BotEventHandler, BotEventOptions, BotEvents, BotOptions, } from "./api/default/bot.js";
+export { guards } from "./api/default/guards.js";
+export type { DefaultGuards } from "./api/default/guards.js";
+export type { DisplayHelpers, FormatHelpers, LinkHelpers, PermissionBitHelpers, SnowflakeHelpers } from "./helpers.js";
+export type { AssetHelpers } from "./assets.js";
+export type { ColorHelpers } from "./colors.js";
+export type { TextHelpers } from "./text.js";
+export type { AuditLogFilter, AuditLogIterationQueryBase, AuditLogQueryBase } from "./audit-logs.js";
+export type { CommandArgumentOptionalValue } from "./command-arguments.js";
+export type { EditMessageOptions, MessageContent } from "./messages.js";
+export type { WebhookMessageOptions } from "./webhooks.js";
+export type { ErrorMatchHandlers } from "./error-tools.js";
+export type { DefaultCommands, DefaultPrefixCommandBatch } from "./default-commands.js";
+export type { Operation } from "./errors.js";
+export { orThrow } from "./api/default/results.js";
+export type { Result, ResultAsync } from "neverthrow";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,109 @@
+/**
+ * Build a Fluxer bot with JavaScript or TypeScript.
+ * Import from @neontechspace/fluxerly and call its methods directly
+ *
+ * @example
+ * ```ts
+ * import { runBot } from "@neontechspace/fluxerly"
+ *
+ * // A failed run is logged and sets process.exitCode, and Ctrl+C stops the bot cleanly, so the returned Result needs
+ * // no further handling here
+ * await runBot({
+ *     token: process.env.FLUXER_BOT_TOKEN,
+ *     commands: { prefix: "!", commands: { ping: { execute: ({ reply }) => reply("Pong!") } } },
+ * })
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { createClient, orThrow } from "@neontechspace/fluxerly"
+ *
+ * await using client = createClient({ token: process.env.FLUXER_BOT_TOKEN })
+ *
+ * client.on("messageCreate", (message) =>
+ *     message.content === "!ping" ? client.messages.reply(message, "Pong!") : undefined,
+ * )
+ *
+ * // Run connects, recovers and stays pending until the client ends, and await using shuts it down afterwards
+ * orThrow(await client.run())
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { permissionBits, colors, text } from "@neontechspace/fluxerly"
+ *
+ * export function pureHelpersExample(bits: bigint, content: string) {
+ *     return {
+ *         required: permissionBits.from(["ManageRoles", "ManageMessages"]),
+ *         missing: permissionBits.missing(bits, ["ManageRoles", "ManageMessages"]),
+ *         inspection: permissionBits.inspect(bits),
+ *         color: colors.parse("#ff8800"),
+ *         chunks: text.split(content, { maxLength: 2_000 }),
+ *     }
+ * }
+ * ```
+ *
+ * @remarks
+ * This default API also includes webhooks, OAuth and local helpers, without requiring an Effect runtime.
+ * Network and other I/O operations return ResultAsync, which starts when called, not when awaited.
+ * Await it to get a Result: If isErr() is true, read error for the expected failure, otherwise read value.
+ * Call orThrow to get the value and throw the error instead, and return a Result from a handler to report its failure.
+ * Methods returning AsyncIterable start work when a for await loop pulls its first item.
+ * Local work returns plain values: Creating clients and routers, registering handlers, cache lookups and pure helpers.
+ * Misuse of those, such as invalid options or a missing token, throws ConfigurationError or the helper's own error at once.
+ * Unexpected SDK or cleanup failures throw or reject with SdkDefect.
+ * Use `await using` or try/finally to release client resources even when work fails
+ *
+ * The [glossary](https://preview.fluxerly.neontechspace.com/docs/latest/glossary/) defines terms such as guild, gateway,
+ * shard, frozen snapshot and uncertain write
+ *
+ * Coding agents: read node_modules/@neontechspace/fluxerly/agents/AGENTS.md before writing code with this package
+ *
+ * @packageDocumentation
+ */
+// Checked first, so an unsupported Node.js version fails with a clear message before any other SDK code runs
+import "./internal/node-version.js";
+export { MemberChunkError } from "./member-chunks.js";
+export { CountOperationError } from "./counts.js";
+export { AssetFormats, AssetUrlError } from "./assets.js";
+export { HelperError, TimestampStyles } from "./helpers.js";
+export { GuildMemberJoinSourceTypes } from "./member-search.js";
+export { hierarchy } from "./role-hierarchy.js";
+export { BotApplicationOperationError } from "./application.js";
+export { DiscoveryCategories } from "./discovery.js";
+export { AuditLogActions } from "./audit-logs.js";
+export { GuildSystemChannelFlags, GuildDefaultMessageNotifications, GuildVerificationLevels, GuildMfaLevels, GuildExplicitContentFilters, GuildContentWarningLevels, GuildSplashCardAlignments, GuildFeatureToggles, } from "./guilds.js";
+export { PresenceError } from "./presence.js";
+export { GuildMemberProfileFlags, MemberMentionPreferences } from "./guilds.js";
+export { UserOperationError } from "./users.js";
+export { WebhookOperationError, WebhookType } from "./webhooks.js";
+export { PaginationError } from "./pagination.js";
+export { AttachmentDownloadError, AttachmentRefreshError } from "./attachments.js";
+export { CriticalWorkerStoppedError } from "./bot-runner.js";
+export { OAuthOperationError, OAuthScopes } from "./oauth.js";
+export { builders, EmbedBuilder, MessageBuilder } from "./builders.js";
+export { SupervisorChildError, SupervisorError } from "./supervisor.js";
+export { describeError, errors } from "./error-tools.js";
+export { ChannelOperationError, ChannelType } from "./channels.js";
+export { ChannelFlags, ForumLayout, ForumSortOrder, ThreadAutoArchiveMinutes, isThreadChannel } from "./channels.js";
+// Thread permissions: Permission inputs for threads
+export { GuildOperationError, Permissions } from "./guilds.js";
+export { CollectorError } from "./collectors.js";
+export { EventOverflowError, EventReadBusyError, MessageError, MessageOperationError } from "./message-errors.js";
+export { EventWaitError } from "./message-errors.js";
+export { MessageCleanupError } from "./message-cleanup.js";
+export { MessageFlags, MessageType } from "./messages.js";
+export { ApplicationError, AuthenticationError, ShardConnectionError, CancelledError, ClientBusyError, ClientClosedError, ConfigurationError, ConnectionError, ConnectionTimeoutError, FluxerlyError, RateLimitError, SdkDefect, } from "./errors.js";
+export { fileSessionStore } from "./sharding.js";
+export { oauth } from "./api/default/oauth.js";
+export { format, snowflakes, display, permissionBits, colors, text, links, assets } from "./api/default/helpers.js";
+export { commands } from "./api/default/commands.js";
+export { supervisor } from "./api/default/supervisor.js";
+export { createWebhookClient } from "./api/default/webhook-client.js";
+export { RestRequestError } from "./rest.js";
+export { GatewaySendError } from "./gateway.js";
+export { createClient } from "./api/default/client.js";
+export { runBot } from "./api/default/bot.js";
+export { guards } from "./api/default/guards.js";
+export { orThrow } from "./api/default/results.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/input-validation.d.ts

@@ -0,0 +1,51 @@
+/** Identifies why the SDK rejected an input before sending a request. The rule may concern its type, allowed range, format or relationship to another field.
+ * These categories do not describe Fluxer errors and are not ready-made messages for users
+ *
+ * @category Errors
+ */
+export type InputValidationConstraint = "required" | "type" | "format" | "range" | "length" | "allowedValue" | "allowedFields" | "relationship" | "unique" | "size";
+/**
+ * Describes why the SDK rejected an input without keeping the rejected value.
+ * Read this detail from an operation error's inputValidation field when it is non-null.
+ * The path names the input field, constraint names the rule, and explanation describes what the SDK accepts.
+ * The SDK reports the first failure it can describe, not every invalid field.
+ * Paths and explanations are SDK-authored, with no rejected values or provider responses.
+ * Every operation input, query and options object rejects keys it does not support before sending, with constraint
+ * allowedFields. The explanation names the key when it is a short identifier, such as a misspelled field name,
+ * suggests the closest supported key and lists the supported keys.
+ * Write application-specific user-facing messages rather than displaying this diagnostic as application copy
+ *
+ * @example
+ * ```ts
+ * import type { InputValidationDetail, MessageOperationFailure } from "@neontechspace/fluxerly"
+ * export function readInputValidation(error: MessageOperationFailure): InputValidationDetail | null {
+ *     return error._tag === "MessageOperationError" ? error.inputValidation : null
+ * }
+ * ```
+ *
+ * @category Errors
+ */
+export interface InputValidationDetail {
+    /** Field or input path the SDK identified as invalid, without copying arbitrary caller keys */
+    readonly path: string;
+    /** Kind of rule the input failed, suitable for application-specific error handling */
+    readonly constraint: InputValidationConstraint;
+    /** Fixed SDK explanation of the accepted input, not the rejected value or ready-made application text */
+    readonly explanation: string;
+}
+/** @internal */
+export declare class InputValidationFailure {
+    readonly detail: InputValidationDetail;
+    constructor(detail: InputValidationDetail);
+}
+/** @internal */
+export declare function inputValidationFailure(path: string, constraint: InputValidationConstraint, explanation: string): InputValidationFailure;
+/** @internal */
+export declare function freezeInputValidationDetail(detail: InputValidationDetail | null): InputValidationDetail | null;
+/**
+ * @internal Reject the first own key of value that keys does not list, naming it with the closest supported key.
+ * Each validator keeps its supported keys beside it. The path names the containing object, such as input or options,
+ * and subject describes it in lowercase with its article, such as "the history query"
+ */
+export declare function unsupportedKeyFailure(value: object, keys: readonly string[], path: string, subject: string): InputValidationFailure | undefined;
+//# sourceMappingURL=input-validation.d.ts.map

package/dist/input-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-validation.d.ts","sourceRoot":"","sources":["../src/input-validation.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAC/B,UAAU,GACV,MAAM,GACN,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,cAAc,GACd,eAAe,GACf,cAAc,GACd,QAAQ,GACR,MAAM,CAAA;AAEZ;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,qBAAqB;IAClC,+FAA+F;IAC/F,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,sFAAsF;IACtF,QAAQ,CAAC,UAAU,EAAE,yBAAyB,CAAA;IAC9C,yGAAyG;IACzG,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC/B;AAED,gBAAgB;AAChB,qBAAa,sBAAsB;IACnB,QAAQ,CAAC,MAAM,EAAE,qBAAqB;IAAlD,YAAqB,MAAM,EAAE,qBAAqB,EAAI;CACzD;AAED,gBAAgB;AAChB,wBAAgB,sBAAsB,CAClC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,yBAAyB,EACrC,WAAW,EAAE,MAAM,GACpB,sBAAsB,CAExB;AAED,gBAAgB;AAChB,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI,GAAG,qBAAqB,GAAG,IAAI,CAI9G;AAKD;;;;GAIG;AACH,wBAAgB,qBAAqB,CACjC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GAChB,sBAAsB,GAAG,SAAS,CAUpC"}

package/dist/input-validation.js

@@ -0,0 +1,34 @@
+import { unsupportedKeyHint } from "#sdk/internal/suggest";
+/** @internal */
+export class InputValidationFailure {
+    detail;
+    constructor(detail) {
+        this.detail = detail;
+    }
+}
+/** @internal */
+export function inputValidationFailure(path, constraint, explanation) {
+    return new InputValidationFailure(Object.freeze({ path, constraint, explanation }));
+}
+/** @internal */
+export function freezeInputValidationDetail(detail) {
+    return detail === null
+        ? null
+        : Object.freeze({ path: detail.path, constraint: detail.constraint, explanation: detail.explanation });
+}
+/** @internal Keys up to 64 characters that look like field names, so repeating one never copies arbitrary caller text */
+const nameableKey = /^[A-Za-z_$][\w$]{0,63}$/;
+/**
+ * @internal Reject the first own key of value that keys does not list, naming it with the closest supported key.
+ * Each validator keeps its supported keys beside it. The path names the containing object, such as input or options,
+ * and subject describes it in lowercase with its article, such as "the history query"
+ */
+export function unsupportedKeyFailure(value, keys, path, subject) {
+    const key = Object.keys(value).find((candidate) => !keys.includes(candidate));
+    if (key === undefined)
+        return undefined;
+    const option = path === "options" || path.endsWith(".options");
+    const unsupported = `Unsupported ${option ? "option" : "field"}${nameableKey.test(key) ? ` ${JSON.stringify(key)}` : ""}`;
+    return inputValidationFailure(path, "allowedFields", `${unsupported} in ${subject}. ${unsupportedKeyHint(key, keys, option ? "options" : "fields")}`);
+}
+//# sourceMappingURL=input-validation.js.map

package/dist/input-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-validation.js","sourceRoot":"","sources":["../src/input-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAiD1D,gBAAgB;AAChB,MAAM,OAAO,sBAAsB;IACV,MAAM;IAA3B,YAAqB,MAA6B;sBAA7B,MAAM;IAA0B,CAAC;CACzD;AAED,gBAAgB;AAChB,MAAM,UAAU,sBAAsB,CAClC,IAAY,EACZ,UAAqC,EACrC,WAAmB;IAEnB,OAAO,IAAI,sBAAsB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC,CAAA;AACvF,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,2BAA2B,CAAC,MAAoC;IAC5E,OAAO,MAAM,KAAK,IAAI;QAClB,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAA;AAC9G,CAAC;AAED,yHAAyH;AACzH,MAAM,WAAW,GAAG,yBAAyB,CAAA;AAE7C;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACjC,KAAa,EACb,IAAuB,EACvB,IAAY,EACZ,OAAe;IAEf,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAA;IAC7E,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IACvC,MAAM,MAAM,GAAG,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;IAC9D,MAAM,WAAW,GAAG,eAAe,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;IACzH,OAAO,sBAAsB,CACzB,IAAI,EACJ,eAAe,EACf,GAAG,WAAW,OAAO,OAAO,KAAK,kBAAkB,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAClG,CAAA;AACL,CAAC"}

package/dist/instance.d.ts

@@ -0,0 +1,101 @@
+import type { AssetHelpers } from "./assets.js";
+import type { LinkHelpers } from "./helpers.js";
+/**
+ * Connect a client to a selected Fluxer server instead of the hosted default.
+ * Omit the whole option to use hosted Fluxer.
+ * When an operation first needs service addresses, the SDK reads `/.well-known/fluxer` from that server without credentials.
+ * It retains the resolved endpoints for this client's lifetime without background refresh
+ *
+ * Select only a trusted instance, since its advertised API and gateway origins can receive this client's credential.
+ * Discovery follows at most three validated unauthenticated redirects.
+ * Requests that send credentials do not follow redirects
+ *
+ * @category Options
+ */
+export interface InstanceOptions {
+    /** Absolute HTTPS root URL that publishes `/.well-known/fluxer`, such as https://fluxer.example.
+     * A path beyond /, query, fragment or embedded credentials is invalid.
+     * HTTP requires allowInsecure, and omitting the whole instance option selects hosted Fluxer
+     */
+    readonly url: string;
+    /** Permit HTTP and WS endpoints only for an explicitly selected local or self-hosted instance. Defaults to false */
+    readonly allowInsecure?: boolean;
+}
+/** Set how long an explicit instance.resolve call may spend finding the server's addresses.
+ * The deadline covers discovery work, but the SDK still waits for owned response cleanup before completing
+ *
+ * @category Options
+ */
+export interface InstanceResolveOptions {
+    /** Time allowed to find service addresses, in milliseconds. Use an integer from 1–2,147,483,647. Default 30,000.
+     * Includes bootstrap redirects and document reads, but required cleanup can take longer
+     */
+    readonly timeoutMs?: number;
+}
+/** Where the selected Fluxer instance hosts its services, validated from its discovery document.
+ * Services may use different origins, which selecting that instance trusts
+ *
+ * @category Client and lifecycle
+ */
+export interface InstanceEndpoints {
+    /** Public HTTP API base. The SDK appends its documented `/v1` route once, preserving any advertised prefix */
+    readonly apiPublic: string;
+    /** Gateway WebSocket base. The SDK adds its required protocol query without deriving another host */
+    readonly gateway: string;
+    /** Public media base for instance-specific generated asset URLs */
+    readonly media: string;
+    /** Static CDN base for instance-specific generated default-asset URLs */
+    readonly staticCdn: string;
+    /** Web application base for instance-specific generated navigation and installation links */
+    readonly webapp: string;
+    /** Invite base for instance-specific invite and vanity URLs */
+    readonly invite: string;
+}
+/**
+ * The selected server's service addresses and matching URL helpers.
+ * This frozen result is retained for one client, not refreshed on each later resolve.
+ * Use assets and links to build URLs for this instance rather than the hosted default.
+ * These helpers make no requests, inspect no credentials and do not refresh discovery or change caches
+ *
+ * @category Client and lifecycle
+ */
+export interface ResolvedInstance {
+    /** Provider code-version indicator from discovery. It is not an API path version */
+    readonly apiCodeVersion: number;
+    /** Exact validated service bases from discovery */
+    readonly endpoints: InstanceEndpoints;
+    /** Whether this instance advertises temporary upload URLs for attachment transfers */
+    readonly presignedAttachmentUploads: boolean;
+    /** Pure asset URL helpers bound to this instance's media and static-CDN bases.
+     * They follow the assets namespace's input-field and fallback rules, return URLs directly and throw AssetUrlError for invalid input
+     */
+    readonly assets: AssetHelpers;
+    /** Pure application-link helpers bound to this instance's web application base.
+     * They return URLs directly, throw HelperError for invalid input and perform no navigation or access check
+     */
+    readonly links: LinkHelpers;
+    /** The web domain migration that discovery announced, or null when the instance announced none.
+     * Links and OAuth URLs always use the discovered web application base in endpoints, so they follow a migrated domain
+     */
+    readonly domainMigration: InstanceDomainMigration | null;
+}
+/** A web domain migration announced by instance discovery, such as hosted Fluxer moving its web app to a new domain.
+ * The SDK records an enabled migration at Info when a client first resolves the instance. It changes no endpoint itself
+ *
+ * @category Client and lifecycle
+ */
+export interface InstanceDomainMigration {
+    /** Whether the instance switched the migration on */
+    readonly enabled: boolean;
+    /** Share of signed-out web visitors moved to the new domain, in basis points from 0 through 10,000, or null when not supplied */
+    readonly anonymousRolloutBasisPoints: number | null;
+    /** Whether standalone app installs are forwarded to the new domain, or null when not supplied */
+    readonly standaloneForwarding: boolean | null;
+}
+/** Expected instance-resolution failures, including invalid options, connection trouble, deadline expiry, rate limits and client closure.
+ * Default API calls add CancelledError, while native interruption remains in the Effect cause
+ *
+ * @category Errors
+ */
+export type InstanceResolveError = import("./errors.js").ConnectionError | import("./errors.js").ConnectionTimeoutError | import("./errors.js").RateLimitError | import("./errors.js").ClientClosedError | import("./errors.js").ConfigurationError;
+//# sourceMappingURL=instance.d.ts.map

package/dist/instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../src/instance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE/C;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAe;IAC5B;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,oHAAoH;IACpH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CACnC;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACnC;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAC9B,8GAA8G;IAC9G,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,qGAAqG;IACrG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,yEAAyE;IACzE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,6FAA6F;IAC7F,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAC1B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC7B,oFAAoF;IACpF,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAA;IACrC,sFAAsF;IACtF,QAAQ,CAAC,0BAA0B,EAAE,OAAO,CAAA;IAC5C;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;IAC7B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAC3B;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,uBAAuB,GAAG,IAAI,CAAA;CAC3D;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACpC,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,iIAAiI;IACjI,QAAQ,CAAC,2BAA2B,EAAE,MAAM,GAAG,IAAI,CAAA;IACnD,iGAAiG;IACjG,QAAQ,CAAC,oBAAoB,EAAE,OAAO,GAAG,IAAI,CAAA;CAChD;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAC1B,OAAO,aAAa,EAAE,eAAe,GACrC,OAAO,aAAa,EAAE,sBAAsB,GAC5C,OAAO,aAAa,EAAE,cAAc,GACpC,OAAO,aAAa,EAAE,iBAAiB,GACvC,OAAO,aAAa,EAAE,kBAAkB,CAAA"}

package/dist/instance.js

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

package/dist/instance.js.map

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