@dereekb/discord 13.33.0

package/index.esm.js

@@ -0,0 +1,789 @@
+import { lastValue, MS_IN_SECOND } from '@dereekb/util';
+import { fetchPageFactory, FetchResponseError, fetchJsonFunction, returnNullHandleFetchJsonParseErrorFunction, fetchApiFetchService } from '@dereekb/util/fetch';
+import { BaseError } from 'make-error';
+
+function _define_property$1(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _object_spread(target) {
+    for(var i = 1; i < arguments.length; i++){
+        var source = arguments[i] != null ? arguments[i] : {};
+        var ownKeys = Object.keys(source);
+        if (typeof Object.getOwnPropertySymbols === "function") {
+            ownKeys = ownKeys.concat(Object.getOwnPropertySymbols(source).filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(source, sym).enumerable;
+            }));
+        }
+        ownKeys.forEach(function(key) {
+            _define_property$1(target, key, source[key]);
+        });
+    }
+    return target;
+}
+function ownKeys(object, enumerableOnly) {
+    var keys = Object.keys(object);
+    if (Object.getOwnPropertySymbols) {
+        var symbols = Object.getOwnPropertySymbols(object);
+        keys.push.apply(keys, symbols);
+    }
+    return keys;
+}
+function _object_spread_props(target, source) {
+    source = source != null ? source : {};
+    if (Object.getOwnPropertyDescriptors) {
+        Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
+    } else {
+        ownKeys(Object(source)).forEach(function(key) {
+            Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
+        });
+    }
+    return target;
+}
+/**
+ * Default number of messages per page when fetching Discord channel messages.
+ */ var DEFAULT_DISCORD_MESSAGES_PER_PAGE = 100;
+/**
+ * Creates a page factory that wraps a Discord message fetch function with automatic cursor-based pagination.
+ *
+ * Discord paginates via `before`/`after` snowflake IDs. This factory automatically reads the last
+ * message's ID from each response and sets it as the `before` cursor for the next request.
+ * When the number of returned messages is less than the requested limit, pagination stops.
+ *
+ * @param input - The factory input configuration.
+ * @returns A page factory that produces iterable page fetchers.
+ *
+ * @example
+ * ```typescript
+ * const pageFactory = discordFetchMessagePageFactory({ fetch: fetchChannelMessages });
+ *
+ * const fetchPage = pageFactory({ limit: 50 });
+ * const firstPage = await fetchPage.fetchNext();
+ *
+ * if (firstPage.hasNext) {
+ *   const secondPage = await firstPage.fetchNext();
+ * }
+ * ```
+ */ function discordFetchMessagePageFactory(input) {
+    var _ref;
+    var fetch = input.fetch, config = input.config, defaults = input.defaults;
+    var readMessageId = (_ref = config === null || config === void 0 ? void 0 : config.readMessageId) !== null && _ref !== void 0 ? _ref : function(message) {
+        return message.id;
+    };
+    return fetchPageFactory(_object_spread_props(_object_spread({}, defaults), {
+        fetch: fetch,
+        readFetchPageResultInfo: function readFetchPageResultInfo(result) {
+            var count = result.data.length;
+            var nextCursor = count > 0 ? readMessageId(lastValue(result.data)) : undefined;
+            return {
+                hasNext: count > 0,
+                nextPageCursor: nextCursor
+            };
+        },
+        buildInputForNextPage: function buildInputForNextPage(pageResult, input, options) {
+            var _ref, _options_maxItemsPerPage, _ref1;
+            var _pageResult_result;
+            var nextCursor = pageResult.nextPageCursor;
+            var effectiveLimit = (_ref = (_options_maxItemsPerPage = options.maxItemsPerPage) !== null && _options_maxItemsPerPage !== void 0 ? _options_maxItemsPerPage : input.limit) !== null && _ref !== void 0 ? _ref : DEFAULT_DISCORD_MESSAGES_PER_PAGE;
+            var resultCount = (_ref1 = (_pageResult_result = pageResult.result) === null || _pageResult_result === void 0 ? void 0 : _pageResult_result.data.length) !== null && _ref1 !== void 0 ? _ref1 : 0;
+            var nextInput;
+            // Discord signals no more results when fewer items than the limit are returned
+            if (!nextCursor || resultCount < effectiveLimit) {
+                nextInput = undefined;
+            } else {
+                nextInput = _object_spread_props(_object_spread({}, input), {
+                    before: nextCursor,
+                    after: undefined,
+                    around: undefined,
+                    limit: effectiveLimit
+                });
+            }
+            return nextInput;
+        }
+    }));
+}
+
+/**
+ * The Discord REST API base, pinned to a version.
+ *
+ * Endpoint paths are appended to this base, so it intentionally carries no endpoint segment of its
+ * own. Discord requires an explicit version in the path; an unversioned base resolves to the oldest
+ * still-supported version.
+ */ var DISCORD_API_URL = 'https://discord.com/api/v10';
+
+/**
+ * Maps a {@link DiscordOAuthTokenResponse} to a {@link DiscordAccessToken}.
+ *
+ * @param response - The token response returned by the Discord token endpoint.
+ * @returns The equivalent DiscordAccessToken, with `expiresAt` resolved against the current time.
+ *
+ * @__NO_SIDE_EFFECTS__
+ */ function discordAccessTokenFromTokenResponse(response) {
+    var createdAt = Date.now();
+    var access_token = response.access_token, refresh_token = response.refresh_token, scope = response.scope, expires_in = response.expires_in;
+    var accessToken = {
+        accessToken: access_token,
+        refreshToken: refresh_token,
+        expiresIn: expires_in,
+        expiresAt: new Date(createdAt + expires_in * MS_IN_SECOND),
+        scope: scope !== null && scope !== void 0 ? scope : ''
+    };
+    return accessToken;
+}
+
+/**
+ * The Discord OAuth2 authorize URL the user's browser is redirected to.
+ *
+ * Note this is NOT under `/api`: Discord serves the consent screen from the site root, while the
+ * token endpoint lives under {@link DISCORD_API_URL}. It is therefore a full URL rather than a path
+ * relative to the API base.
+ */ var DISCORD_OAUTH_AUTHORIZE_URL = 'https://discord.com/oauth2/authorize';
+/**
+ * The Discord OAuth2 token endpoint path, relative to {@link DISCORD_API_URL}.
+ */ var DISCORD_OAUTH_TOKEN_PATH = '/oauth2/token';
+/**
+ * The Discord OAuth2 token revocation endpoint path, relative to {@link DISCORD_API_URL}.
+ */ var DISCORD_OAUTH_REVOKE_PATH = '/oauth2/token/revoke';
+/**
+ * Path of the endpoint returning the user an access token belongs to.
+ *
+ * Requires the `identify` scope.
+ */ var DISCORD_OAUTH_CURRENT_USER_PATH = '/users/@me';
+
+/**
+ * The `Content-Type` Discord's token endpoint requires.
+ *
+ * Discord rejects a JSON body outright, unlike Cal.com, which requires one.
+ *
+ * `@dereekb/util/oidc`'s `postTokenEndpoint` is the in-workspace precedent for this form-encoded
+ * shape and is deliberately NOT reused: its `exchangeAuthorizationCode` requires a PKCE
+ * `code_verifier`, it authenticates with `client_secret_post` rather than Basic, and it is
+ * discovery-driven. Discord is not an OIDC provider — there is no discovery document and no
+ * `id_token`.
+ */ var DISCORD_OAUTH_TOKEN_CONTENT_TYPE = 'application/x-www-form-urlencoded';
+/**
+ * Builds the HTTP Basic `Authorization` header value that authenticates the OAuth client.
+ *
+ * Discord accepts the client credentials as Basic auth rather than in the request body, which is why
+ * `client_id` / `client_secret` are absent from the exchange body below.
+ *
+ * Uses `btoa()` rather than `Buffer`, so this package stays usable outside Node — the same choice
+ * `@dereekb/util`'s PKCE helpers make.
+ *
+ * @param config - The client credentials to encode.
+ * @returns The `Authorization` header value, including the `Basic ` prefix.
+ *
+ * @__NO_SIDE_EFFECTS__
+ */ function discordOAuthBasicAuthorizationHeader(config) {
+    var credentials = "".concat(config.clientId, ":").concat(config.clientSecret);
+    return "Basic ".concat(btoa(credentials));
+}
+/**
+ * Exchanges an OAuth authorization code for access and refresh tokens.
+ *
+ * Discord requires `application/x-www-form-urlencoded` — a JSON body is rejected — and authenticates
+ * the client with HTTP Basic rather than credentials in the body. Both differ from Cal.com, which
+ * posts JSON with the credentials inline. The Basic header rides on the context's configured fetch.
+ *
+ * @param context - The Discord OAuth context providing the authenticated fetch.
+ * @returns Exchanges an authorization code for access and refresh tokens.
+ *
+ * @see https://docs.discord.com/developers/topics/oauth2
+ *
+ * @example
+ * ```ts
+ * const response = await exchangeAuthorizationCode(context)({
+ *   code: 'auth-code-from-redirect',
+ *   redirectUri: 'http://localhost:9901/oauth/discord/callback'
+ * });
+ * ```
+ */ function exchangeAuthorizationCode(context) {
+    return function(input) {
+        var body = new URLSearchParams({
+            grant_type: 'authorization_code',
+            code: input.code,
+            redirect_uri: input.redirectUri
+        });
+        var fetchJsonInput = {
+            method: 'POST',
+            body: body.toString()
+        };
+        return context.fetchJson(DISCORD_OAUTH_TOKEN_PATH, fetchJsonInput);
+    };
+}
+/**
+ * Refreshes an access token.
+ *
+ * Discord's refresh response carries a `refresh_token` of its own, so persist whatever comes back
+ * rather than assuming the sent one stays valid. That is correct for rotating and non-rotating
+ * providers alike.
+ *
+ * Reached through `DiscordUserExternalConnectionOAuthService.refreshCredentials`, which the external
+ * connection reader dispatches to when a user's stored Discord credentials are near expiration.
+ *
+ * @param context - The Discord OAuth context providing the authenticated fetch.
+ * @returns Refreshes an access token using the given refresh token.
+ *
+ * @see https://docs.discord.com/developers/topics/oauth2
+ */ function refreshAccessToken(context) {
+    return function(input) {
+        var body = new URLSearchParams({
+            grant_type: 'refresh_token',
+            refresh_token: input.refreshToken
+        });
+        var fetchJsonInput = {
+            method: 'POST',
+            body: body.toString()
+        };
+        return context.fetchJson(DISCORD_OAUTH_TOKEN_PATH, fetchJsonInput);
+    };
+}
+/**
+ * Reads the user an access token belongs to. Requires the `identify` scope.
+ *
+ * Bearer-authenticated with the USER's token, not Basic-authenticated with the client credentials, so
+ * the `Authorization` header is passed per-request to override the one on the context's fetch. A
+ * per-request header wins over the base header of the same name, which is what makes one configured
+ * fetch enough for both shapes.
+ *
+ * @param context - The Discord OAuth context providing the authenticated fetch.
+ * @returns Reads the Discord user the given access token belongs to.
+ *
+ * @see https://docs.discord.com/developers/resources/user
+ */ function readCurrentUser(context) {
+    return function(input) {
+        var fetchJsonInput = {
+            method: 'GET',
+            headers: {
+                Authorization: "Bearer ".concat(input.accessToken)
+            }
+        };
+        return context.fetchJson(DISCORD_OAUTH_CURRENT_USER_PATH, fetchJsonInput);
+    };
+}
+
+/**
+ * The Discord OAuth scopes this package models.
+ *
+ * A runtime list rather than a bare type union, so a configured scope can be validated instead of
+ * being passed through to the consent screen and refused there.
+ *
+ * Deliberately NOT Discord's full ~40-scope surface: only what a per-user account connect can
+ * legitimately ask for. Add a scope here when code actually uses it.
+ *
+ * @see https://docs.discord.com/developers/topics/oauth2
+ */ var ALL_DISCORD_OAUTH_SCOPES = [
+    'identify',
+    'email',
+    'guilds',
+    'connections'
+];
+/**
+ * Returns whether the input is a known {@link DiscordOAuthScope}.
+ *
+ * @param value - The value to check.
+ * @returns True when the value is a Discord OAuth scope this package models.
+ */ function isDiscordOAuthScope(value) {
+    return ALL_DISCORD_OAUTH_SCOPES.includes(value);
+}
+/**
+ * The delimiter used to join scopes in the `scope` query parameter.
+ *
+ * OAuth2 specifies a space-delimited list and Discord follows it. `URL.searchParams.set` handles the
+ * percent-encoding, so this stays a literal space.
+ */ var DISCORD_OAUTH_SCOPE_DELIMITER = ' ';
+/**
+ * The `response_type` used by the authorization-code flow.
+ */ var DISCORD_OAUTH_AUTHORIZE_RESPONSE_TYPE = 'code';
+/**
+ * Creates a {@link DiscordOAuthAuthorizeUrlFactory} that composes the Discord authorize URL a user's
+ * browser is redirected to in order to begin the authorization-code flow.
+ *
+ * The client id, redirect URI, and scopes are fixed by the config, since a consumer holds those
+ * constant and varies only the per-request `state`.
+ *
+ * @param config - The client id, redirect URI, and scopes to request.
+ * @returns A factory that builds an authorize URL for the given params.
+ *
+ * @see https://docs.discord.com/developers/topics/oauth2
+ *
+ * @example
+ * ```ts
+ * const authorizeUrlFactory = discordOAuthAuthorizeUrlFactory({
+ *   clientId: 'client-id',
+ *   redirectUri: 'http://localhost:9901/oauth/discord/callback',
+ *   scopes: ['identify']
+ * });
+ *
+ * const url = authorizeUrlFactory({ state: 'signed-state' });
+ * ```
+ *
+ * @__NO_SIDE_EFFECTS__
+ */ function discordOAuthAuthorizeUrlFactory(config) {
+    var clientId = config.clientId, redirectUri = config.redirectUri, scopes = config.scopes, inputAuthorizeUrl = config.authorizeUrl;
+    var authorizeUrl = inputAuthorizeUrl !== null && inputAuthorizeUrl !== void 0 ? inputAuthorizeUrl : DISCORD_OAUTH_AUTHORIZE_URL;
+    var scope = scopes.join(DISCORD_OAUTH_SCOPE_DELIMITER);
+    return function(params) {
+        var url = new URL(authorizeUrl);
+        var state = params === null || params === void 0 ? void 0 : params.state;
+        url.searchParams.set('client_id', clientId);
+        url.searchParams.set('redirect_uri', redirectUri);
+        url.searchParams.set('response_type', DISCORD_OAUTH_AUTHORIZE_RESPONSE_TYPE);
+        url.searchParams.set('scope', scope);
+        if (state != null) {
+            url.searchParams.set('state', state);
+        }
+        return url.toString();
+    };
+}
+
+function _assert_this_initialized(self) {
+    if (self === void 0) {
+        throw new ReferenceError("this hasn't been initialised - super() hasn't been called");
+    }
+    return self;
+}
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+    try {
+        var info = gen[key](arg);
+        var value = info.value;
+    } catch (error) {
+        reject(error);
+        return;
+    }
+    if (info.done) {
+        resolve(value);
+    } else {
+        Promise.resolve(value).then(_next, _throw);
+    }
+}
+function _async_to_generator(fn) {
+    return function() {
+        var self = this, args = arguments;
+        return new Promise(function(resolve, reject) {
+            var gen = fn.apply(self, args);
+            function _next(value) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+            }
+            function _throw(err) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+            }
+            _next(undefined);
+        });
+    };
+}
+function _call_super(_this, derived, args) {
+    derived = _get_prototype_of(derived);
+    return _possible_constructor_return(_this, _is_native_reflect_construct() ? Reflect.construct(derived, args || [], _get_prototype_of(_this).constructor) : derived.apply(_this, args));
+}
+function _class_call_check(instance, Constructor) {
+    if (!(instance instanceof Constructor)) {
+        throw new TypeError("Cannot call a class as a function");
+    }
+}
+function _defineProperties(target, props) {
+    for(var i = 0; i < props.length; i++){
+        var descriptor = props[i];
+        descriptor.enumerable = descriptor.enumerable || false;
+        descriptor.configurable = true;
+        if ("value" in descriptor) descriptor.writable = true;
+        Object.defineProperty(target, descriptor.key, descriptor);
+    }
+}
+function _create_class(Constructor, protoProps, staticProps) {
+    if (protoProps) _defineProperties(Constructor.prototype, protoProps);
+    return Constructor;
+}
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _get_prototype_of(o) {
+    _get_prototype_of = Object.setPrototypeOf ? Object.getPrototypeOf : function getPrototypeOf(o) {
+        return o.__proto__ || Object.getPrototypeOf(o);
+    };
+    return _get_prototype_of(o);
+}
+function _inherits(subClass, superClass) {
+    if (typeof superClass !== "function" && superClass !== null) {
+        throw new TypeError("Super expression must either be null or a function");
+    }
+    subClass.prototype = Object.create(superClass && superClass.prototype, {
+        constructor: {
+            value: subClass,
+            writable: true,
+            configurable: true
+        }
+    });
+    if (superClass) _set_prototype_of(subClass, superClass);
+}
+function _instanceof(left, right) {
+    "@swc/helpers - instanceof";
+    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
+        return !!right[Symbol.hasInstance](left);
+    } else {
+        return left instanceof right;
+    }
+}
+function _possible_constructor_return(self, call) {
+    if (call && (_type_of(call) === "object" || typeof call === "function")) {
+        return call;
+    }
+    return _assert_this_initialized(self);
+}
+function _set_prototype_of(o, p) {
+    _set_prototype_of = Object.setPrototypeOf || function setPrototypeOf(o, p) {
+        o.__proto__ = p;
+        return o;
+    };
+    return _set_prototype_of(o, p);
+}
+function _type_of(obj) {
+    "@swc/helpers - typeof";
+    return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
+}
+function _is_native_reflect_construct() {
+    try {
+        var result = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function() {}));
+    } catch (_) {}
+    return (_is_native_reflect_construct = function() {
+        return !!result;
+    })();
+}
+function _ts_generator(thisArg, body) {
+    var f, y, t, _ = {
+        label: 0,
+        sent: function() {
+            if (t[0] & 1) throw t[1];
+            return t[1];
+        },
+        trys: [],
+        ops: []
+    }, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype), d = Object.defineProperty;
+    return d(g, "next", {
+        value: verb(0)
+    }), d(g, "throw", {
+        value: verb(1)
+    }), d(g, "return", {
+        value: verb(2)
+    }), typeof Symbol === "function" && d(g, Symbol.iterator, {
+        value: function() {
+            return this;
+        }
+    }), g;
+    function verb(n) {
+        return function(v) {
+            return step([
+                n,
+                v
+            ]);
+        };
+    }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while(g && (g = 0, op[0] && (_ = 0)), _)try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [
+                op[0] & 2,
+                t.value
+            ];
+            switch(op[0]){
+                case 0:
+                case 1:
+                    t = op;
+                    break;
+                case 4:
+                    _.label++;
+                    return {
+                        value: op[1],
+                        done: false
+                    };
+                case 5:
+                    _.label++;
+                    y = op[1];
+                    op = [
+                        0
+                    ];
+                    continue;
+                case 7:
+                    op = _.ops.pop();
+                    _.trys.pop();
+                    continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+                        _ = 0;
+                        continue;
+                    }
+                    if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+                        _.label = op[1];
+                        break;
+                    }
+                    if (op[0] === 6 && _.label < t[1]) {
+                        _.label = t[1];
+                        t = op;
+                        break;
+                    }
+                    if (t && _.label < t[2]) {
+                        _.label = t[2];
+                        _.ops.push(op);
+                        break;
+                    }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop();
+                    continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) {
+            op = [
+                6,
+                e
+            ];
+            y = 0;
+        } finally{
+            f = t = 0;
+        }
+        if (op[0] & 5) throw op[1];
+        return {
+            value: op[0] ? op[1] : void 0,
+            done: true
+        };
+    }
+}
+/**
+ * Error code returned when a code or refresh token is invalid, expired, or was already spent.
+ */ var DISCORD_OAUTH_INVALID_GRANT_ERROR_CODE = 'invalid_grant';
+/**
+ * Error code returned when the requested scope set is not one the application may ask for.
+ */ var DISCORD_OAUTH_INVALID_SCOPE_ERROR_CODE = 'invalid_scope';
+/**
+ * An error reported by a Discord OAuth endpoint.
+ */ var DiscordOAuthError = /*#__PURE__*/ function(BaseError) {
+    _inherits(DiscordOAuthError, BaseError);
+    function DiscordOAuthError(error) {
+        _class_call_check(this, DiscordOAuthError);
+        var _this;
+        _this = _call_super(this, DiscordOAuthError, [
+            error.error_description ? "".concat(error.error, ": ").concat(error.error_description) : error.error
+        ]), _define_property(_this, "error", void 0);
+        _this.error = error;
+        return _this;
+    }
+    _create_class(DiscordOAuthError, [
+        {
+            key: "code",
+            get: function get() {
+                return this.error.error;
+            }
+        }
+    ]);
+    return DiscordOAuthError;
+}(BaseError);
+/**
+ * A {@link DiscordOAuthError} that retains the HTTP response it was parsed from.
+ */ var DiscordOAuthFetchResponseError = /*#__PURE__*/ function(DiscordOAuthError) {
+    _inherits(DiscordOAuthFetchResponseError, DiscordOAuthError);
+    function DiscordOAuthFetchResponseError(data, responseError) {
+        _class_call_check(this, DiscordOAuthFetchResponseError);
+        var _this;
+        _this = _call_super(this, DiscordOAuthFetchResponseError, [
+            data
+        ]), _define_property(_this, "data", void 0), _define_property(_this, "responseError", void 0);
+        _this.data = data;
+        _this.responseError = responseError;
+        return _this;
+    }
+    return DiscordOAuthFetchResponseError;
+}(DiscordOAuthError);
+/**
+ * Creates a {@link LogDiscordOAuthErrorFunction} that logs the error to the console.
+ *
+ * @param discordApiNamePrefix - Prefix to use when logging, e.g. `DiscordOAuth`.
+ * @returns A log function that prefixes each logged error.
+ *
+ * @__NO_SIDE_EFFECTS__
+ */ function logDiscordOAuthErrorFunction(discordApiNamePrefix) {
+    return function(error) {
+        if (_instanceof(error, DiscordOAuthFetchResponseError)) {
+            console.log("".concat(discordApiNamePrefix, "Error(").concat(error.responseError.response.status, "): "), {
+                error: error,
+                errorData: error.data
+            });
+        } else if (_instanceof(error, DiscordOAuthError)) {
+            console.log("".concat(discordApiNamePrefix, "Error(code:").concat(error.code, "): "), {
+                error: error
+            });
+        } else {
+            console.log("".concat(discordApiNamePrefix, "Error(name:").concat(error.name, "): "), {
+                error: error
+            });
+        }
+    };
+}
+var logDiscordOAuthErrorToConsole = logDiscordOAuthErrorFunction('DiscordOAuth');
+/**
+ * Parses a {@link FetchResponseError} from a Discord OAuth call into a typed error.
+ *
+ * @param responseError - The fetch response error to parse.
+ * @returns The parsed error, or undefined when the body carried no OAuth error to parse.
+ */ function parseDiscordOAuthError(responseError) {
+    return _async_to_generator(function() {
+        var data, result;
+        return _ts_generator(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    return [
+                        4,
+                        responseError.response.clone().json().catch(function() {
+                            return undefined;
+                        })
+                    ];
+                case 1:
+                    data = _state.sent();
+                    if (data === null || data === void 0 ? void 0 : data.error) {
+                        result = new DiscordOAuthFetchResponseError(data, responseError);
+                    }
+                    return [
+                        2,
+                        result
+                    ];
+            }
+        });
+    })();
+}
+/**
+ * Wraps a {@link ConfiguredFetch} so that Discord OAuth error responses surface as typed errors.
+ *
+ * @param fetch - The fetch to wrap.
+ * @param logError - Optional override of the error logging function.
+ * @returns The wrapped fetch.
+ *
+ * @__NO_SIDE_EFFECTS__
+ */ function handleDiscordOAuthErrorFetch(fetch) {
+    var logError = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : logDiscordOAuthErrorToConsole;
+    return function(x, y) {
+        return _async_to_generator(function() {
+            var e, error;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        _state.trys.push([
+                            0,
+                            2,
+                            ,
+                            5
+                        ]);
+                        return [
+                            4,
+                            fetch(x, y)
+                        ];
+                    case 1:
+                        return [
+                            2,
+                            _state.sent()
+                        ]; // await to catch thrown errors
+                    case 2:
+                        e = _state.sent();
+                        if (!_instanceof(e, FetchResponseError)) return [
+                            3,
+                            4
+                        ];
+                        return [
+                            4,
+                            parseDiscordOAuthError(e)
+                        ];
+                    case 3:
+                        error = _state.sent();
+                        if (error) {
+                            logError(error); // log before throwing
+                            throw error;
+                        }
+                        _state.label = 4;
+                    case 4:
+                        throw e;
+                    case 5:
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    };
+}
+
+/**
+ * Creates a {@link DiscordOAuthFactory} that produces configured Discord OAuth instances.
+ *
+ * There is no access-token cache or per-user token factory here, unlike `calcomOAuthFactory`: the
+ * external-connection framework stores each user's credentials itself, so the client only ever needs
+ * to make the calls it is asked to make.
+ *
+ * @param factoryConfig - Configuration including an optional fetch factory, fetch handler, and error logging.
+ * @returns A factory accepting a DiscordOAuthConfig and producing a DiscordOAuth instance.
+ *
+ * @__NO_SIDE_EFFECTS__
+ */ function discordOAuthFactory(factoryConfig) {
+    var fetchHandler = factoryConfig.fetchHandler, logDiscordOAuthErrorFunction = factoryConfig.logDiscordOAuthErrorFunction;
+    var _factoryConfig_fetchFactory = factoryConfig.fetchFactory, fetchFactory = _factoryConfig_fetchFactory === void 0 ? function(input) {
+        return fetchApiFetchService.makeFetch({
+            baseUrl: DISCORD_API_URL,
+            baseRequest: {
+                headers: {
+                    // the token endpoint's shape, since it is the only endpoint that posts a body. A
+                    // per-request header of the same name wins, which is how readCurrentUser swaps the
+                    // client's Basic credentials for the user's Bearer token.
+                    'Content-Type': DISCORD_OAUTH_TOKEN_CONTENT_TYPE,
+                    Authorization: discordOAuthBasicAuthorizationHeader(input.config)
+                }
+            },
+            fetchHandler: fetchHandler !== null && fetchHandler !== void 0 ? fetchHandler : undefined,
+            timeout: 20 * 1000,
+            requireOkResponse: true,
+            useTimeout: true // use timeout
+        });
+    } : _factoryConfig_fetchFactory;
+    return function(config) {
+        // a missing credential otherwise composes `client_id=undefined` on the authorize URL and fails at
+        // the consent screen rather than at startup
+        if (!config.clientId) {
+            throw new Error('DiscordOAuthConfig missing clientId.');
+        } else if (!config.clientSecret) {
+            throw new Error('DiscordOAuthConfig missing clientSecret.');
+        }
+        var baseFetch = fetchFactory({
+            config: config
+        });
+        var fetch = handleDiscordOAuthErrorFetch(baseFetch, logDiscordOAuthErrorFunction);
+        var fetchJson = fetchJsonFunction(fetch, {
+            handleFetchJsonParseErrorFunction: returnNullHandleFetchJsonParseErrorFunction
+        });
+        var oauthContext = {
+            fetch: fetch,
+            fetchJson: fetchJson,
+            config: config
+        };
+        var discordOAuth = {
+            oauthContext: oauthContext
+        };
+        return discordOAuth;
+    };
+}
+
+export { ALL_DISCORD_OAUTH_SCOPES, DEFAULT_DISCORD_MESSAGES_PER_PAGE, DISCORD_API_URL, DISCORD_OAUTH_AUTHORIZE_RESPONSE_TYPE, DISCORD_OAUTH_AUTHORIZE_URL, DISCORD_OAUTH_CURRENT_USER_PATH, DISCORD_OAUTH_INVALID_GRANT_ERROR_CODE, DISCORD_OAUTH_INVALID_SCOPE_ERROR_CODE, DISCORD_OAUTH_REVOKE_PATH, DISCORD_OAUTH_SCOPE_DELIMITER, DISCORD_OAUTH_TOKEN_CONTENT_TYPE, DISCORD_OAUTH_TOKEN_PATH, DiscordOAuthError, DiscordOAuthFetchResponseError, discordAccessTokenFromTokenResponse, discordFetchMessagePageFactory, discordOAuthAuthorizeUrlFactory, discordOAuthBasicAuthorizationHeader, discordOAuthFactory, exchangeAuthorizationCode, handleDiscordOAuthErrorFetch, isDiscordOAuthScope, logDiscordOAuthErrorFunction, logDiscordOAuthErrorToConsole, parseDiscordOAuthError, readCurrentUser, refreshAccessToken };