zai-fca 1.0.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Potentially problematic release.
This version of zai-fca might be problematic. Click here for more details.
- package/.cache/replit/env/latest +56 -0
- package/.cache/replit/env/latest.json +1 -0
- package/.cache/replit/modules/nodejs-20.res +1 -0
- package/.cache/replit/modules/replit.res +1 -0
- package/.cache/replit/modules.stamp +0 -0
- package/.cache/typescript/5.6/node_modules/.package-lock.json +178 -0
- package/.cache/typescript/5.6/node_modules/@types/bluebird/LICENSE +21 -0
- package/.cache/typescript/5.6/node_modules/@types/bluebird/README.md +15 -0
- package/.cache/typescript/5.6/node_modules/@types/bluebird/index.d.ts +1365 -0
- package/.cache/typescript/5.6/node_modules/@types/bluebird/package.json +25 -0
- package/.cache/typescript/5.6/node_modules/@types/caseless/LICENSE +21 -0
- package/.cache/typescript/5.6/node_modules/@types/caseless/README.md +48 -0
- package/.cache/typescript/5.6/node_modules/@types/caseless/index.d.ts +29 -0
- package/.cache/typescript/5.6/node_modules/@types/caseless/package.json +35 -0
- package/.cache/typescript/5.6/node_modules/@types/mocha/LICENSE +21 -0
- package/.cache/typescript/5.6/node_modules/@types/mocha/README.md +15 -0
- package/.cache/typescript/5.6/node_modules/@types/mocha/index.d.ts +2929 -0
- package/.cache/typescript/5.6/node_modules/@types/mocha/package.json +56 -0
- package/.cache/typescript/5.6/node_modules/@types/node/LICENSE +21 -0
- package/.cache/typescript/5.6/node_modules/@types/node/README.md +15 -0
- package/.cache/typescript/5.6/node_modules/@types/node/assert/strict.d.ts +8 -0
- package/.cache/typescript/5.6/node_modules/@types/node/assert.d.ts +1040 -0
- package/.cache/typescript/5.6/node_modules/@types/node/async_hooks.d.ts +541 -0
- package/.cache/typescript/5.6/node_modules/@types/node/buffer.buffer.d.ts +385 -0
- package/.cache/typescript/5.6/node_modules/@types/node/buffer.d.ts +1933 -0
- package/.cache/typescript/5.6/node_modules/@types/node/child_process.d.ts +1549 -0
- package/.cache/typescript/5.6/node_modules/@types/node/cluster.d.ts +579 -0
- package/.cache/typescript/5.6/node_modules/@types/node/compatibility/disposable.d.ts +16 -0
- package/.cache/typescript/5.6/node_modules/@types/node/compatibility/index.d.ts +9 -0
- package/.cache/typescript/5.6/node_modules/@types/node/compatibility/indexable.d.ts +23 -0
- package/.cache/typescript/5.6/node_modules/@types/node/compatibility/iterators.d.ts +21 -0
- package/.cache/typescript/5.6/node_modules/@types/node/console.d.ts +452 -0
- package/.cache/typescript/5.6/node_modules/@types/node/constants.d.ts +19 -0
- package/.cache/typescript/5.6/node_modules/@types/node/crypto.d.ts +4475 -0
- package/.cache/typescript/5.6/node_modules/@types/node/dgram.d.ts +596 -0
- package/.cache/typescript/5.6/node_modules/@types/node/diagnostics_channel.d.ts +554 -0
- package/.cache/typescript/5.6/node_modules/@types/node/dns/promises.d.ts +476 -0
- package/.cache/typescript/5.6/node_modules/@types/node/dns.d.ts +865 -0
- package/.cache/typescript/5.6/node_modules/@types/node/dom-events.d.ts +124 -0
- package/.cache/typescript/5.6/node_modules/@types/node/domain.d.ts +170 -0
- package/.cache/typescript/5.6/node_modules/@types/node/events.d.ts +931 -0
- package/.cache/typescript/5.6/node_modules/@types/node/fs/promises.d.ts +1275 -0
- package/.cache/typescript/5.6/node_modules/@types/node/fs.d.ts +4396 -0
- package/.cache/typescript/5.6/node_modules/@types/node/globals.d.ts +566 -0
- package/.cache/typescript/5.6/node_modules/@types/node/globals.typedarray.d.ts +21 -0
- package/.cache/typescript/5.6/node_modules/@types/node/http.d.ts +1958 -0
- package/.cache/typescript/5.6/node_modules/@types/node/http2.d.ts +2558 -0
- package/.cache/typescript/5.6/node_modules/@types/node/https.d.ts +543 -0
- package/.cache/typescript/5.6/node_modules/@types/node/index.d.ts +92 -0
- package/.cache/typescript/5.6/node_modules/@types/node/inspector.d.ts +3966 -0
- package/.cache/typescript/5.6/node_modules/@types/node/module.d.ts +402 -0
- package/.cache/typescript/5.6/node_modules/@types/node/net.d.ts +1001 -0
- package/.cache/typescript/5.6/node_modules/@types/node/os.d.ts +495 -0
- package/.cache/typescript/5.6/node_modules/@types/node/package.json +220 -0
- package/.cache/typescript/5.6/node_modules/@types/node/path.d.ts +200 -0
- package/.cache/typescript/5.6/node_modules/@types/node/perf_hooks.d.ts +965 -0
- package/.cache/typescript/5.6/node_modules/@types/node/process.d.ts +1963 -0
- package/.cache/typescript/5.6/node_modules/@types/node/punycode.d.ts +117 -0
- package/.cache/typescript/5.6/node_modules/@types/node/querystring.d.ts +153 -0
- package/.cache/typescript/5.6/node_modules/@types/node/readline/promises.d.ts +162 -0
- package/.cache/typescript/5.6/node_modules/@types/node/readline.d.ts +589 -0
- package/.cache/typescript/5.6/node_modules/@types/node/repl.d.ts +430 -0
- package/.cache/typescript/5.6/node_modules/@types/node/sea.d.ts +153 -0
- package/.cache/typescript/5.6/node_modules/@types/node/sqlite.d.ts +213 -0
- package/.cache/typescript/5.6/node_modules/@types/node/stream/consumers.d.ts +12 -0
- package/.cache/typescript/5.6/node_modules/@types/node/stream/promises.d.ts +90 -0
- package/.cache/typescript/5.6/node_modules/@types/node/stream/web.d.ts +609 -0
- package/.cache/typescript/5.6/node_modules/@types/node/stream.d.ts +1726 -0
- package/.cache/typescript/5.6/node_modules/@types/node/string_decoder.d.ts +67 -0
- package/.cache/typescript/5.6/node_modules/@types/node/test.d.ts +2248 -0
- package/.cache/typescript/5.6/node_modules/@types/node/timers/promises.d.ts +97 -0
- package/.cache/typescript/5.6/node_modules/@types/node/timers.d.ts +240 -0
- package/.cache/typescript/5.6/node_modules/@types/node/tls.d.ts +1226 -0
- package/.cache/typescript/5.6/node_modules/@types/node/trace_events.d.ts +197 -0
- package/.cache/typescript/5.6/node_modules/@types/node/ts5.6/buffer.buffer.d.ts +385 -0
- package/.cache/typescript/5.6/node_modules/@types/node/ts5.6/globals.typedarray.d.ts +19 -0
- package/.cache/typescript/5.6/node_modules/@types/node/ts5.6/index.d.ts +92 -0
- package/.cache/typescript/5.6/node_modules/@types/node/tty.d.ts +208 -0
- package/.cache/typescript/5.6/node_modules/@types/node/url.d.ts +972 -0
- package/.cache/typescript/5.6/node_modules/@types/node/util.d.ts +2371 -0
- package/.cache/typescript/5.6/node_modules/@types/node/v8.d.ts +808 -0
- package/.cache/typescript/5.6/node_modules/@types/node/vm.d.ts +976 -0
- package/.cache/typescript/5.6/node_modules/@types/node/wasi.d.ts +181 -0
- package/.cache/typescript/5.6/node_modules/@types/node/worker_threads.d.ts +745 -0
- package/.cache/typescript/5.6/node_modules/@types/node/zlib.d.ts +539 -0
- package/.cache/typescript/5.6/node_modules/@types/node-cron/LICENSE +21 -0
- package/.cache/typescript/5.6/node_modules/@types/node-cron/README.md +76 -0
- package/.cache/typescript/5.6/node_modules/@types/node-cron/index.d.ts +57 -0
- package/.cache/typescript/5.6/node_modules/@types/node-cron/package.json +50 -0
- package/.cache/typescript/5.6/node_modules/@types/npmlog/LICENSE +21 -0
- package/.cache/typescript/5.6/node_modules/@types/npmlog/README.md +15 -0
- package/.cache/typescript/5.6/node_modules/@types/npmlog/index.d.ts +84 -0
- package/.cache/typescript/5.6/node_modules/@types/npmlog/package.json +32 -0
- package/.cache/typescript/5.6/node_modules/@types/request/LICENSE +21 -0
- package/.cache/typescript/5.6/node_modules/@types/request/README.md +15 -0
- package/.cache/typescript/5.6/node_modules/@types/request/index.d.ts +395 -0
- package/.cache/typescript/5.6/node_modules/@types/request/package.json +70 -0
- package/.cache/typescript/5.6/node_modules/@types/tough-cookie/LICENSE +21 -0
- package/.cache/typescript/5.6/node_modules/@types/tough-cookie/README.md +15 -0
- package/.cache/typescript/5.6/node_modules/@types/tough-cookie/index.d.ts +321 -0
- package/.cache/typescript/5.6/node_modules/@types/tough-cookie/package.json +35 -0
- package/.cache/typescript/5.6/node_modules/asynckit/LICENSE +21 -0
- package/.cache/typescript/5.6/node_modules/asynckit/README.md +233 -0
- package/.cache/typescript/5.6/node_modules/asynckit/bench.js +76 -0
- package/.cache/typescript/5.6/node_modules/asynckit/index.js +6 -0
- package/.cache/typescript/5.6/node_modules/asynckit/lib/abort.js +29 -0
- package/.cache/typescript/5.6/node_modules/asynckit/lib/async.js +34 -0
- package/.cache/typescript/5.6/node_modules/asynckit/lib/defer.js +26 -0
- package/.cache/typescript/5.6/node_modules/asynckit/lib/iterate.js +75 -0
- package/.cache/typescript/5.6/node_modules/asynckit/lib/readable_asynckit.js +91 -0
- package/.cache/typescript/5.6/node_modules/asynckit/lib/readable_parallel.js +25 -0
- package/.cache/typescript/5.6/node_modules/asynckit/lib/readable_serial.js +25 -0
- package/.cache/typescript/5.6/node_modules/asynckit/lib/readable_serial_ordered.js +29 -0
- package/.cache/typescript/5.6/node_modules/asynckit/lib/state.js +37 -0
- package/.cache/typescript/5.6/node_modules/asynckit/lib/streamify.js +141 -0
- package/.cache/typescript/5.6/node_modules/asynckit/lib/terminator.js +29 -0
- package/.cache/typescript/5.6/node_modules/asynckit/package.json +63 -0
- package/.cache/typescript/5.6/node_modules/asynckit/parallel.js +43 -0
- package/.cache/typescript/5.6/node_modules/asynckit/serial.js +17 -0
- package/.cache/typescript/5.6/node_modules/asynckit/serialOrdered.js +75 -0
- package/.cache/typescript/5.6/node_modules/asynckit/stream.js +21 -0
- package/.cache/typescript/5.6/node_modules/combined-stream/License +19 -0
- package/.cache/typescript/5.6/node_modules/combined-stream/Readme.md +138 -0
- package/.cache/typescript/5.6/node_modules/combined-stream/lib/combined_stream.js +208 -0
- package/.cache/typescript/5.6/node_modules/combined-stream/package.json +25 -0
- package/.cache/typescript/5.6/node_modules/combined-stream/yarn.lock +17 -0
- package/.cache/typescript/5.6/node_modules/delayed-stream/License +19 -0
- package/.cache/typescript/5.6/node_modules/delayed-stream/Makefile +7 -0
- package/.cache/typescript/5.6/node_modules/delayed-stream/Readme.md +141 -0
- package/.cache/typescript/5.6/node_modules/delayed-stream/lib/delayed_stream.js +107 -0
- package/.cache/typescript/5.6/node_modules/delayed-stream/package.json +27 -0
- package/.cache/typescript/5.6/node_modules/form-data/License +19 -0
- package/.cache/typescript/5.6/node_modules/form-data/Readme.md +350 -0
- package/.cache/typescript/5.6/node_modules/form-data/index.d.ts +51 -0
- package/.cache/typescript/5.6/node_modules/form-data/lib/browser.js +2 -0
- package/.cache/typescript/5.6/node_modules/form-data/lib/form_data.js +484 -0
- package/.cache/typescript/5.6/node_modules/form-data/lib/populate.js +10 -0
- package/.cache/typescript/5.6/node_modules/form-data/package.json +72 -0
- package/.cache/typescript/5.6/node_modules/mime-db/HISTORY.md +507 -0
- package/.cache/typescript/5.6/node_modules/mime-db/LICENSE +23 -0
- package/.cache/typescript/5.6/node_modules/mime-db/README.md +100 -0
- package/.cache/typescript/5.6/node_modules/mime-db/db.json +8519 -0
- package/.cache/typescript/5.6/node_modules/mime-db/index.js +12 -0
- package/.cache/typescript/5.6/node_modules/mime-db/package.json +60 -0
- package/.cache/typescript/5.6/node_modules/mime-types/HISTORY.md +397 -0
- package/.cache/typescript/5.6/node_modules/mime-types/LICENSE +23 -0
- package/.cache/typescript/5.6/node_modules/mime-types/README.md +113 -0
- package/.cache/typescript/5.6/node_modules/mime-types/index.js +188 -0
- package/.cache/typescript/5.6/node_modules/mime-types/package.json +44 -0
- package/.cache/typescript/5.6/node_modules/safe-buffer/LICENSE +21 -0
- package/.cache/typescript/5.6/node_modules/safe-buffer/README.md +584 -0
- package/.cache/typescript/5.6/node_modules/safe-buffer/index.d.ts +187 -0
- package/.cache/typescript/5.6/node_modules/safe-buffer/index.js +65 -0
- package/.cache/typescript/5.6/node_modules/safe-buffer/package.json +51 -0
- package/.cache/typescript/5.6/node_modules/types-registry/README.md +2 -0
- package/.cache/typescript/5.6/node_modules/types-registry/index.json +1 -0
- package/.cache/typescript/5.6/node_modules/types-registry/package.json +20 -0
- package/.cache/typescript/5.6/node_modules/undici-types/LICENSE +21 -0
- package/.cache/typescript/5.6/node_modules/undici-types/README.md +6 -0
- package/.cache/typescript/5.6/node_modules/undici-types/agent.d.ts +31 -0
- package/.cache/typescript/5.6/node_modules/undici-types/api.d.ts +43 -0
- package/.cache/typescript/5.6/node_modules/undici-types/balanced-pool.d.ts +29 -0
- package/.cache/typescript/5.6/node_modules/undici-types/cache.d.ts +36 -0
- package/.cache/typescript/5.6/node_modules/undici-types/client.d.ts +108 -0
- package/.cache/typescript/5.6/node_modules/undici-types/connector.d.ts +34 -0
- package/.cache/typescript/5.6/node_modules/undici-types/content-type.d.ts +21 -0
- package/.cache/typescript/5.6/node_modules/undici-types/cookies.d.ts +28 -0
- package/.cache/typescript/5.6/node_modules/undici-types/diagnostics-channel.d.ts +66 -0
- package/.cache/typescript/5.6/node_modules/undici-types/dispatcher.d.ts +255 -0
- package/.cache/typescript/5.6/node_modules/undici-types/env-http-proxy-agent.d.ts +21 -0
- package/.cache/typescript/5.6/node_modules/undici-types/errors.d.ts +149 -0
- package/.cache/typescript/5.6/node_modules/undici-types/eventsource.d.ts +61 -0
- package/.cache/typescript/5.6/node_modules/undici-types/fetch.d.ts +209 -0
- package/.cache/typescript/5.6/node_modules/undici-types/file.d.ts +39 -0
- package/.cache/typescript/5.6/node_modules/undici-types/filereader.d.ts +54 -0
- package/.cache/typescript/5.6/node_modules/undici-types/formdata.d.ts +108 -0
- package/.cache/typescript/5.6/node_modules/undici-types/global-dispatcher.d.ts +9 -0
- package/.cache/typescript/5.6/node_modules/undici-types/global-origin.d.ts +7 -0
- package/.cache/typescript/5.6/node_modules/undici-types/handlers.d.ts +15 -0
- package/.cache/typescript/5.6/node_modules/undici-types/header.d.ts +4 -0
- package/.cache/typescript/5.6/node_modules/undici-types/index.d.ts +71 -0
- package/.cache/typescript/5.6/node_modules/undici-types/interceptors.d.ts +17 -0
- package/.cache/typescript/5.6/node_modules/undici-types/mock-agent.d.ts +50 -0
- package/.cache/typescript/5.6/node_modules/undici-types/mock-client.d.ts +25 -0
- package/.cache/typescript/5.6/node_modules/undici-types/mock-errors.d.ts +12 -0
- package/.cache/typescript/5.6/node_modules/undici-types/mock-interceptor.d.ts +93 -0
- package/.cache/typescript/5.6/node_modules/undici-types/mock-pool.d.ts +25 -0
- package/.cache/typescript/5.6/node_modules/undici-types/package.json +55 -0
- package/.cache/typescript/5.6/node_modules/undici-types/patch.d.ts +33 -0
- package/.cache/typescript/5.6/node_modules/undici-types/pool-stats.d.ts +19 -0
- package/.cache/typescript/5.6/node_modules/undici-types/pool.d.ts +39 -0
- package/.cache/typescript/5.6/node_modules/undici-types/proxy-agent.d.ts +28 -0
- package/.cache/typescript/5.6/node_modules/undici-types/readable.d.ts +60 -0
- package/.cache/typescript/5.6/node_modules/undici-types/retry-agent.d.ts +8 -0
- package/.cache/typescript/5.6/node_modules/undici-types/retry-handler.d.ts +116 -0
- package/.cache/typescript/5.6/node_modules/undici-types/util.d.ts +18 -0
- package/.cache/typescript/5.6/node_modules/undici-types/webidl.d.ts +222 -0
- package/.cache/typescript/5.6/node_modules/undici-types/websocket.d.ts +150 -0
- package/.cache/typescript/5.6/package-lock.json +190 -0
- package/.cache/typescript/5.6/package.json +1 -0
- package/.replit +4 -0
- package/.upm/store.json +1 -0
- package/LICENSE +21 -0
- package/README.md +289 -0
- package/index.js +460 -0
- package/package.json +45 -0
- package/src/Screenshot.js +83 -0
- package/src/addExternalModule.js +25 -0
- package/src/addUserToGroup.js +115 -0
- package/src/changeAdminStatus.js +103 -0
- package/src/changeArchivedStatus.js +55 -0
- package/src/changeAvatar.js +136 -0
- package/src/changeAvatarV2.js +86 -0
- package/src/changeAvt.js +85 -0
- package/src/changeBio.js +76 -0
- package/src/changeBlockedStatus.js +49 -0
- package/src/changeBlockedStatusMqtt.js +80 -0
- package/src/changeCover.js +72 -0
- package/src/changeGroupImage.js +135 -0
- package/src/changeName.js +79 -0
- package/src/changeNickname.js +59 -0
- package/src/changeThreadColor.js +65 -0
- package/src/changeThreadEmoji.js +55 -0
- package/src/changeUsername.js +59 -0
- package/src/createCommentPost.js +230 -0
- package/src/createNewGroup.js +88 -0
- package/src/createPoll.js +71 -0
- package/src/createPost.js +276 -0
- package/src/deleteMessage.js +56 -0
- package/src/deleteThread.js +56 -0
- package/src/editMessage.js +59 -0
- package/src/editMessageOld.js +67 -0
- package/src/follow.js +74 -0
- package/src/forwardAttachment.js +60 -0
- package/src/getAccess.js +112 -0
- package/src/getAvatarUser.js +78 -0
- package/src/getCurrentUserID.js +7 -0
- package/src/getEmojiUrl.js +29 -0
- package/src/getFriendsList.js +83 -0
- package/src/getMessage.js +835 -0
- package/src/getRegion.js +7 -0
- package/src/getThreadHistory.js +680 -0
- package/src/getThreadHistoryDeprecated.js +71 -0
- package/src/getThreadInfo.js +232 -0
- package/src/getThreadInfoDeprecated.js +56 -0
- package/src/getThreadList.js +213 -0
- package/src/getThreadListDeprecated.js +46 -0
- package/src/getThreadPictures.js +59 -0
- package/src/getUID.js +119 -0
- package/src/getUserID.js +61 -0
- package/src/getUserInfo.js +66 -0
- package/src/handleFriendRequest.js +46 -0
- package/src/handleMessageRequest.js +47 -0
- package/src/httpGet.js +49 -0
- package/src/httpPost.js +48 -0
- package/src/listenMqtt.js +827 -0
- package/src/listenMqtt.txt +827 -0
- package/src/logout.js +75 -0
- package/src/markAsDelivered.js +47 -0
- package/src/markAsRead.js +70 -0
- package/src/markAsReadAll.js +40 -0
- package/src/markAsSeen.js +48 -0
- package/src/muteThread.js +45 -0
- package/src/postFormData.txt +46 -0
- package/src/refreshFb_dtsg.js +89 -0
- package/src/removeUserFromGroup.js +79 -0
- package/src/resolvePhotoUrl.js +45 -0
- package/src/searchForThread.js +53 -0
- package/src/searchStickers.js +53 -0
- package/src/sendMessage.js +329 -0
- package/src/sendMessageMqtt.js +322 -0
- package/src/sendTypingIndicator.js +101 -0
- package/src/sendTypingIndicatorV2.js +28 -0
- package/src/setMessageReaction.js +122 -0
- package/src/setMessageReactionMqtt.js +62 -0
- package/src/setPostReaction.js +112 -0
- package/src/setProfileGuard.js +45 -0
- package/src/setStoryReaction.js +64 -0
- package/src/setTitle.js +90 -0
- package/src/shareContact.js +110 -0
- package/src/shareLink.js +59 -0
- package/src/stopListenMqtt.js +23 -0
- package/src/threadColors.js +131 -0
- package/src/unfriend.js +52 -0
- package/src/unsendMessage.js +45 -0
- package/src/uploadAttachment.js +94 -0
- package/test/example-config.json +18 -0
- package/test/test-page.js +140 -0
- package/test/test.js +385 -0
- package/utils.js +2876 -0
| @@ -0,0 +1,543 @@ | |
| 1 | 
            +
            /**
         | 
| 2 | 
            +
             * HTTPS is the HTTP protocol over TLS/SSL. In Node.js this is implemented as a
         | 
| 3 | 
            +
             * separate module.
         | 
| 4 | 
            +
             * @see [source](https://github.com/nodejs/node/blob/v22.x/lib/https.js)
         | 
| 5 | 
            +
             */
         | 
| 6 | 
            +
            declare module "https" {
         | 
| 7 | 
            +
                import { Duplex } from "node:stream";
         | 
| 8 | 
            +
                import * as tls from "node:tls";
         | 
| 9 | 
            +
                import * as http from "node:http";
         | 
| 10 | 
            +
                import { URL } from "node:url";
         | 
| 11 | 
            +
                type ServerOptions<
         | 
| 12 | 
            +
                    Request extends typeof http.IncomingMessage = typeof http.IncomingMessage,
         | 
| 13 | 
            +
                    Response extends typeof http.ServerResponse<InstanceType<Request>> = typeof http.ServerResponse,
         | 
| 14 | 
            +
                > = tls.SecureContextOptions & tls.TlsOptions & http.ServerOptions<Request, Response>;
         | 
| 15 | 
            +
                type RequestOptions =
         | 
| 16 | 
            +
                    & http.RequestOptions
         | 
| 17 | 
            +
                    & tls.SecureContextOptions
         | 
| 18 | 
            +
                    & {
         | 
| 19 | 
            +
                        checkServerIdentity?: typeof tls.checkServerIdentity | undefined;
         | 
| 20 | 
            +
                        rejectUnauthorized?: boolean | undefined; // Defaults to true
         | 
| 21 | 
            +
                        servername?: string | undefined; // SNI TLS Extension
         | 
| 22 | 
            +
                    };
         | 
| 23 | 
            +
                interface AgentOptions extends http.AgentOptions, tls.ConnectionOptions {
         | 
| 24 | 
            +
                    maxCachedSessions?: number | undefined;
         | 
| 25 | 
            +
                }
         | 
| 26 | 
            +
                /**
         | 
| 27 | 
            +
                 * An `Agent` object for HTTPS similar to `http.Agent`. See {@link request} for more information.
         | 
| 28 | 
            +
                 * @since v0.4.5
         | 
| 29 | 
            +
                 */
         | 
| 30 | 
            +
                class Agent extends http.Agent {
         | 
| 31 | 
            +
                    constructor(options?: AgentOptions);
         | 
| 32 | 
            +
                    options: AgentOptions;
         | 
| 33 | 
            +
                }
         | 
| 34 | 
            +
                interface Server<
         | 
| 35 | 
            +
                    Request extends typeof http.IncomingMessage = typeof http.IncomingMessage,
         | 
| 36 | 
            +
                    Response extends typeof http.ServerResponse<InstanceType<Request>> = typeof http.ServerResponse,
         | 
| 37 | 
            +
                > extends http.Server<Request, Response> {}
         | 
| 38 | 
            +
                /**
         | 
| 39 | 
            +
                 * See `http.Server` for more information.
         | 
| 40 | 
            +
                 * @since v0.3.4
         | 
| 41 | 
            +
                 */
         | 
| 42 | 
            +
                class Server<
         | 
| 43 | 
            +
                    Request extends typeof http.IncomingMessage = typeof http.IncomingMessage,
         | 
| 44 | 
            +
                    Response extends typeof http.ServerResponse<InstanceType<Request>> = typeof http.ServerResponse,
         | 
| 45 | 
            +
                > extends tls.Server {
         | 
| 46 | 
            +
                    constructor(requestListener?: http.RequestListener<Request, Response>);
         | 
| 47 | 
            +
                    constructor(
         | 
| 48 | 
            +
                        options: ServerOptions<Request, Response>,
         | 
| 49 | 
            +
                        requestListener?: http.RequestListener<Request, Response>,
         | 
| 50 | 
            +
                    );
         | 
| 51 | 
            +
                    /**
         | 
| 52 | 
            +
                     * Closes all connections connected to this server.
         | 
| 53 | 
            +
                     * @since v18.2.0
         | 
| 54 | 
            +
                     */
         | 
| 55 | 
            +
                    closeAllConnections(): void;
         | 
| 56 | 
            +
                    /**
         | 
| 57 | 
            +
                     * Closes all connections connected to this server which are not sending a request or waiting for a response.
         | 
| 58 | 
            +
                     * @since v18.2.0
         | 
| 59 | 
            +
                     */
         | 
| 60 | 
            +
                    closeIdleConnections(): void;
         | 
| 61 | 
            +
                    addListener(event: string, listener: (...args: any[]) => void): this;
         | 
| 62 | 
            +
                    addListener(event: "keylog", listener: (line: Buffer, tlsSocket: tls.TLSSocket) => void): this;
         | 
| 63 | 
            +
                    addListener(
         | 
| 64 | 
            +
                        event: "newSession",
         | 
| 65 | 
            +
                        listener: (sessionId: Buffer, sessionData: Buffer, callback: (err: Error, resp: Buffer) => void) => void,
         | 
| 66 | 
            +
                    ): this;
         | 
| 67 | 
            +
                    addListener(
         | 
| 68 | 
            +
                        event: "OCSPRequest",
         | 
| 69 | 
            +
                        listener: (
         | 
| 70 | 
            +
                            certificate: Buffer,
         | 
| 71 | 
            +
                            issuer: Buffer,
         | 
| 72 | 
            +
                            callback: (err: Error | null, resp: Buffer) => void,
         | 
| 73 | 
            +
                        ) => void,
         | 
| 74 | 
            +
                    ): this;
         | 
| 75 | 
            +
                    addListener(
         | 
| 76 | 
            +
                        event: "resumeSession",
         | 
| 77 | 
            +
                        listener: (sessionId: Buffer, callback: (err: Error, sessionData: Buffer) => void) => void,
         | 
| 78 | 
            +
                    ): this;
         | 
| 79 | 
            +
                    addListener(event: "secureConnection", listener: (tlsSocket: tls.TLSSocket) => void): this;
         | 
| 80 | 
            +
                    addListener(event: "tlsClientError", listener: (err: Error, tlsSocket: tls.TLSSocket) => void): this;
         | 
| 81 | 
            +
                    addListener(event: "close", listener: () => void): this;
         | 
| 82 | 
            +
                    addListener(event: "connection", listener: (socket: Duplex) => void): this;
         | 
| 83 | 
            +
                    addListener(event: "error", listener: (err: Error) => void): this;
         | 
| 84 | 
            +
                    addListener(event: "listening", listener: () => void): this;
         | 
| 85 | 
            +
                    addListener(event: "checkContinue", listener: http.RequestListener<Request, Response>): this;
         | 
| 86 | 
            +
                    addListener(event: "checkExpectation", listener: http.RequestListener<Request, Response>): this;
         | 
| 87 | 
            +
                    addListener(event: "clientError", listener: (err: Error, socket: Duplex) => void): this;
         | 
| 88 | 
            +
                    addListener(
         | 
| 89 | 
            +
                        event: "connect",
         | 
| 90 | 
            +
                        listener: (req: InstanceType<Request>, socket: Duplex, head: Buffer) => void,
         | 
| 91 | 
            +
                    ): this;
         | 
| 92 | 
            +
                    addListener(event: "request", listener: http.RequestListener<Request, Response>): this;
         | 
| 93 | 
            +
                    addListener(
         | 
| 94 | 
            +
                        event: "upgrade",
         | 
| 95 | 
            +
                        listener: (req: InstanceType<Request>, socket: Duplex, head: Buffer) => void,
         | 
| 96 | 
            +
                    ): this;
         | 
| 97 | 
            +
                    emit(event: string, ...args: any[]): boolean;
         | 
| 98 | 
            +
                    emit(event: "keylog", line: Buffer, tlsSocket: tls.TLSSocket): boolean;
         | 
| 99 | 
            +
                    emit(
         | 
| 100 | 
            +
                        event: "newSession",
         | 
| 101 | 
            +
                        sessionId: Buffer,
         | 
| 102 | 
            +
                        sessionData: Buffer,
         | 
| 103 | 
            +
                        callback: (err: Error, resp: Buffer) => void,
         | 
| 104 | 
            +
                    ): boolean;
         | 
| 105 | 
            +
                    emit(
         | 
| 106 | 
            +
                        event: "OCSPRequest",
         | 
| 107 | 
            +
                        certificate: Buffer,
         | 
| 108 | 
            +
                        issuer: Buffer,
         | 
| 109 | 
            +
                        callback: (err: Error | null, resp: Buffer) => void,
         | 
| 110 | 
            +
                    ): boolean;
         | 
| 111 | 
            +
                    emit(event: "resumeSession", sessionId: Buffer, callback: (err: Error, sessionData: Buffer) => void): boolean;
         | 
| 112 | 
            +
                    emit(event: "secureConnection", tlsSocket: tls.TLSSocket): boolean;
         | 
| 113 | 
            +
                    emit(event: "tlsClientError", err: Error, tlsSocket: tls.TLSSocket): boolean;
         | 
| 114 | 
            +
                    emit(event: "close"): boolean;
         | 
| 115 | 
            +
                    emit(event: "connection", socket: Duplex): boolean;
         | 
| 116 | 
            +
                    emit(event: "error", err: Error): boolean;
         | 
| 117 | 
            +
                    emit(event: "listening"): boolean;
         | 
| 118 | 
            +
                    emit(
         | 
| 119 | 
            +
                        event: "checkContinue",
         | 
| 120 | 
            +
                        req: InstanceType<Request>,
         | 
| 121 | 
            +
                        res: InstanceType<Response>,
         | 
| 122 | 
            +
                    ): boolean;
         | 
| 123 | 
            +
                    emit(
         | 
| 124 | 
            +
                        event: "checkExpectation",
         | 
| 125 | 
            +
                        req: InstanceType<Request>,
         | 
| 126 | 
            +
                        res: InstanceType<Response>,
         | 
| 127 | 
            +
                    ): boolean;
         | 
| 128 | 
            +
                    emit(event: "clientError", err: Error, socket: Duplex): boolean;
         | 
| 129 | 
            +
                    emit(event: "connect", req: InstanceType<Request>, socket: Duplex, head: Buffer): boolean;
         | 
| 130 | 
            +
                    emit(
         | 
| 131 | 
            +
                        event: "request",
         | 
| 132 | 
            +
                        req: InstanceType<Request>,
         | 
| 133 | 
            +
                        res: InstanceType<Response>,
         | 
| 134 | 
            +
                    ): boolean;
         | 
| 135 | 
            +
                    emit(event: "upgrade", req: InstanceType<Request>, socket: Duplex, head: Buffer): boolean;
         | 
| 136 | 
            +
                    on(event: string, listener: (...args: any[]) => void): this;
         | 
| 137 | 
            +
                    on(event: "keylog", listener: (line: Buffer, tlsSocket: tls.TLSSocket) => void): this;
         | 
| 138 | 
            +
                    on(
         | 
| 139 | 
            +
                        event: "newSession",
         | 
| 140 | 
            +
                        listener: (sessionId: Buffer, sessionData: Buffer, callback: (err: Error, resp: Buffer) => void) => void,
         | 
| 141 | 
            +
                    ): this;
         | 
| 142 | 
            +
                    on(
         | 
| 143 | 
            +
                        event: "OCSPRequest",
         | 
| 144 | 
            +
                        listener: (
         | 
| 145 | 
            +
                            certificate: Buffer,
         | 
| 146 | 
            +
                            issuer: Buffer,
         | 
| 147 | 
            +
                            callback: (err: Error | null, resp: Buffer) => void,
         | 
| 148 | 
            +
                        ) => void,
         | 
| 149 | 
            +
                    ): this;
         | 
| 150 | 
            +
                    on(
         | 
| 151 | 
            +
                        event: "resumeSession",
         | 
| 152 | 
            +
                        listener: (sessionId: Buffer, callback: (err: Error, sessionData: Buffer) => void) => void,
         | 
| 153 | 
            +
                    ): this;
         | 
| 154 | 
            +
                    on(event: "secureConnection", listener: (tlsSocket: tls.TLSSocket) => void): this;
         | 
| 155 | 
            +
                    on(event: "tlsClientError", listener: (err: Error, tlsSocket: tls.TLSSocket) => void): this;
         | 
| 156 | 
            +
                    on(event: "close", listener: () => void): this;
         | 
| 157 | 
            +
                    on(event: "connection", listener: (socket: Duplex) => void): this;
         | 
| 158 | 
            +
                    on(event: "error", listener: (err: Error) => void): this;
         | 
| 159 | 
            +
                    on(event: "listening", listener: () => void): this;
         | 
| 160 | 
            +
                    on(event: "checkContinue", listener: http.RequestListener<Request, Response>): this;
         | 
| 161 | 
            +
                    on(event: "checkExpectation", listener: http.RequestListener<Request, Response>): this;
         | 
| 162 | 
            +
                    on(event: "clientError", listener: (err: Error, socket: Duplex) => void): this;
         | 
| 163 | 
            +
                    on(event: "connect", listener: (req: InstanceType<Request>, socket: Duplex, head: Buffer) => void): this;
         | 
| 164 | 
            +
                    on(event: "request", listener: http.RequestListener<Request, Response>): this;
         | 
| 165 | 
            +
                    on(event: "upgrade", listener: (req: InstanceType<Request>, socket: Duplex, head: Buffer) => void): this;
         | 
| 166 | 
            +
                    once(event: string, listener: (...args: any[]) => void): this;
         | 
| 167 | 
            +
                    once(event: "keylog", listener: (line: Buffer, tlsSocket: tls.TLSSocket) => void): this;
         | 
| 168 | 
            +
                    once(
         | 
| 169 | 
            +
                        event: "newSession",
         | 
| 170 | 
            +
                        listener: (sessionId: Buffer, sessionData: Buffer, callback: (err: Error, resp: Buffer) => void) => void,
         | 
| 171 | 
            +
                    ): this;
         | 
| 172 | 
            +
                    once(
         | 
| 173 | 
            +
                        event: "OCSPRequest",
         | 
| 174 | 
            +
                        listener: (
         | 
| 175 | 
            +
                            certificate: Buffer,
         | 
| 176 | 
            +
                            issuer: Buffer,
         | 
| 177 | 
            +
                            callback: (err: Error | null, resp: Buffer) => void,
         | 
| 178 | 
            +
                        ) => void,
         | 
| 179 | 
            +
                    ): this;
         | 
| 180 | 
            +
                    once(
         | 
| 181 | 
            +
                        event: "resumeSession",
         | 
| 182 | 
            +
                        listener: (sessionId: Buffer, callback: (err: Error, sessionData: Buffer) => void) => void,
         | 
| 183 | 
            +
                    ): this;
         | 
| 184 | 
            +
                    once(event: "secureConnection", listener: (tlsSocket: tls.TLSSocket) => void): this;
         | 
| 185 | 
            +
                    once(event: "tlsClientError", listener: (err: Error, tlsSocket: tls.TLSSocket) => void): this;
         | 
| 186 | 
            +
                    once(event: "close", listener: () => void): this;
         | 
| 187 | 
            +
                    once(event: "connection", listener: (socket: Duplex) => void): this;
         | 
| 188 | 
            +
                    once(event: "error", listener: (err: Error) => void): this;
         | 
| 189 | 
            +
                    once(event: "listening", listener: () => void): this;
         | 
| 190 | 
            +
                    once(event: "checkContinue", listener: http.RequestListener<Request, Response>): this;
         | 
| 191 | 
            +
                    once(event: "checkExpectation", listener: http.RequestListener<Request, Response>): this;
         | 
| 192 | 
            +
                    once(event: "clientError", listener: (err: Error, socket: Duplex) => void): this;
         | 
| 193 | 
            +
                    once(event: "connect", listener: (req: InstanceType<Request>, socket: Duplex, head: Buffer) => void): this;
         | 
| 194 | 
            +
                    once(event: "request", listener: http.RequestListener<Request, Response>): this;
         | 
| 195 | 
            +
                    once(event: "upgrade", listener: (req: InstanceType<Request>, socket: Duplex, head: Buffer) => void): this;
         | 
| 196 | 
            +
                    prependListener(event: string, listener: (...args: any[]) => void): this;
         | 
| 197 | 
            +
                    prependListener(event: "keylog", listener: (line: Buffer, tlsSocket: tls.TLSSocket) => void): this;
         | 
| 198 | 
            +
                    prependListener(
         | 
| 199 | 
            +
                        event: "newSession",
         | 
| 200 | 
            +
                        listener: (sessionId: Buffer, sessionData: Buffer, callback: (err: Error, resp: Buffer) => void) => void,
         | 
| 201 | 
            +
                    ): this;
         | 
| 202 | 
            +
                    prependListener(
         | 
| 203 | 
            +
                        event: "OCSPRequest",
         | 
| 204 | 
            +
                        listener: (
         | 
| 205 | 
            +
                            certificate: Buffer,
         | 
| 206 | 
            +
                            issuer: Buffer,
         | 
| 207 | 
            +
                            callback: (err: Error | null, resp: Buffer) => void,
         | 
| 208 | 
            +
                        ) => void,
         | 
| 209 | 
            +
                    ): this;
         | 
| 210 | 
            +
                    prependListener(
         | 
| 211 | 
            +
                        event: "resumeSession",
         | 
| 212 | 
            +
                        listener: (sessionId: Buffer, callback: (err: Error, sessionData: Buffer) => void) => void,
         | 
| 213 | 
            +
                    ): this;
         | 
| 214 | 
            +
                    prependListener(event: "secureConnection", listener: (tlsSocket: tls.TLSSocket) => void): this;
         | 
| 215 | 
            +
                    prependListener(event: "tlsClientError", listener: (err: Error, tlsSocket: tls.TLSSocket) => void): this;
         | 
| 216 | 
            +
                    prependListener(event: "close", listener: () => void): this;
         | 
| 217 | 
            +
                    prependListener(event: "connection", listener: (socket: Duplex) => void): this;
         | 
| 218 | 
            +
                    prependListener(event: "error", listener: (err: Error) => void): this;
         | 
| 219 | 
            +
                    prependListener(event: "listening", listener: () => void): this;
         | 
| 220 | 
            +
                    prependListener(event: "checkContinue", listener: http.RequestListener<Request, Response>): this;
         | 
| 221 | 
            +
                    prependListener(event: "checkExpectation", listener: http.RequestListener<Request, Response>): this;
         | 
| 222 | 
            +
                    prependListener(event: "clientError", listener: (err: Error, socket: Duplex) => void): this;
         | 
| 223 | 
            +
                    prependListener(
         | 
| 224 | 
            +
                        event: "connect",
         | 
| 225 | 
            +
                        listener: (req: InstanceType<Request>, socket: Duplex, head: Buffer) => void,
         | 
| 226 | 
            +
                    ): this;
         | 
| 227 | 
            +
                    prependListener(event: "request", listener: http.RequestListener<Request, Response>): this;
         | 
| 228 | 
            +
                    prependListener(
         | 
| 229 | 
            +
                        event: "upgrade",
         | 
| 230 | 
            +
                        listener: (req: InstanceType<Request>, socket: Duplex, head: Buffer) => void,
         | 
| 231 | 
            +
                    ): this;
         | 
| 232 | 
            +
                    prependOnceListener(event: string, listener: (...args: any[]) => void): this;
         | 
| 233 | 
            +
                    prependOnceListener(event: "keylog", listener: (line: Buffer, tlsSocket: tls.TLSSocket) => void): this;
         | 
| 234 | 
            +
                    prependOnceListener(
         | 
| 235 | 
            +
                        event: "newSession",
         | 
| 236 | 
            +
                        listener: (sessionId: Buffer, sessionData: Buffer, callback: (err: Error, resp: Buffer) => void) => void,
         | 
| 237 | 
            +
                    ): this;
         | 
| 238 | 
            +
                    prependOnceListener(
         | 
| 239 | 
            +
                        event: "OCSPRequest",
         | 
| 240 | 
            +
                        listener: (
         | 
| 241 | 
            +
                            certificate: Buffer,
         | 
| 242 | 
            +
                            issuer: Buffer,
         | 
| 243 | 
            +
                            callback: (err: Error | null, resp: Buffer) => void,
         | 
| 244 | 
            +
                        ) => void,
         | 
| 245 | 
            +
                    ): this;
         | 
| 246 | 
            +
                    prependOnceListener(
         | 
| 247 | 
            +
                        event: "resumeSession",
         | 
| 248 | 
            +
                        listener: (sessionId: Buffer, callback: (err: Error, sessionData: Buffer) => void) => void,
         | 
| 249 | 
            +
                    ): this;
         | 
| 250 | 
            +
                    prependOnceListener(event: "secureConnection", listener: (tlsSocket: tls.TLSSocket) => void): this;
         | 
| 251 | 
            +
                    prependOnceListener(event: "tlsClientError", listener: (err: Error, tlsSocket: tls.TLSSocket) => void): this;
         | 
| 252 | 
            +
                    prependOnceListener(event: "close", listener: () => void): this;
         | 
| 253 | 
            +
                    prependOnceListener(event: "connection", listener: (socket: Duplex) => void): this;
         | 
| 254 | 
            +
                    prependOnceListener(event: "error", listener: (err: Error) => void): this;
         | 
| 255 | 
            +
                    prependOnceListener(event: "listening", listener: () => void): this;
         | 
| 256 | 
            +
                    prependOnceListener(event: "checkContinue", listener: http.RequestListener<Request, Response>): this;
         | 
| 257 | 
            +
                    prependOnceListener(event: "checkExpectation", listener: http.RequestListener<Request, Response>): this;
         | 
| 258 | 
            +
                    prependOnceListener(event: "clientError", listener: (err: Error, socket: Duplex) => void): this;
         | 
| 259 | 
            +
                    prependOnceListener(
         | 
| 260 | 
            +
                        event: "connect",
         | 
| 261 | 
            +
                        listener: (req: InstanceType<Request>, socket: Duplex, head: Buffer) => void,
         | 
| 262 | 
            +
                    ): this;
         | 
| 263 | 
            +
                    prependOnceListener(event: "request", listener: http.RequestListener<Request, Response>): this;
         | 
| 264 | 
            +
                    prependOnceListener(
         | 
| 265 | 
            +
                        event: "upgrade",
         | 
| 266 | 
            +
                        listener: (req: InstanceType<Request>, socket: Duplex, head: Buffer) => void,
         | 
| 267 | 
            +
                    ): this;
         | 
| 268 | 
            +
                }
         | 
| 269 | 
            +
                /**
         | 
| 270 | 
            +
                 * ```js
         | 
| 271 | 
            +
                 * // curl -k https://localhost:8000/
         | 
| 272 | 
            +
                 * import https from 'node:https';
         | 
| 273 | 
            +
                 * import fs from 'node:fs';
         | 
| 274 | 
            +
                 *
         | 
| 275 | 
            +
                 * const options = {
         | 
| 276 | 
            +
                 *   key: fs.readFileSync('test/fixtures/keys/agent2-key.pem'),
         | 
| 277 | 
            +
                 *   cert: fs.readFileSync('test/fixtures/keys/agent2-cert.pem'),
         | 
| 278 | 
            +
                 * };
         | 
| 279 | 
            +
                 *
         | 
| 280 | 
            +
                 * https.createServer(options, (req, res) => {
         | 
| 281 | 
            +
                 *   res.writeHead(200);
         | 
| 282 | 
            +
                 *   res.end('hello world\n');
         | 
| 283 | 
            +
                 * }).listen(8000);
         | 
| 284 | 
            +
                 * ```
         | 
| 285 | 
            +
                 *
         | 
| 286 | 
            +
                 * Or
         | 
| 287 | 
            +
                 *
         | 
| 288 | 
            +
                 * ```js
         | 
| 289 | 
            +
                 * import https from 'node:https';
         | 
| 290 | 
            +
                 * import fs from 'node:fs';
         | 
| 291 | 
            +
                 *
         | 
| 292 | 
            +
                 * const options = {
         | 
| 293 | 
            +
                 *   pfx: fs.readFileSync('test/fixtures/test_cert.pfx'),
         | 
| 294 | 
            +
                 *   passphrase: 'sample',
         | 
| 295 | 
            +
                 * };
         | 
| 296 | 
            +
                 *
         | 
| 297 | 
            +
                 * https.createServer(options, (req, res) => {
         | 
| 298 | 
            +
                 *   res.writeHead(200);
         | 
| 299 | 
            +
                 *   res.end('hello world\n');
         | 
| 300 | 
            +
                 * }).listen(8000);
         | 
| 301 | 
            +
                 * ```
         | 
| 302 | 
            +
                 * @since v0.3.4
         | 
| 303 | 
            +
                 * @param options Accepts `options` from `createServer`, `createSecureContext` and `createServer`.
         | 
| 304 | 
            +
                 * @param requestListener A listener to be added to the `'request'` event.
         | 
| 305 | 
            +
                 */
         | 
| 306 | 
            +
                function createServer<
         | 
| 307 | 
            +
                    Request extends typeof http.IncomingMessage = typeof http.IncomingMessage,
         | 
| 308 | 
            +
                    Response extends typeof http.ServerResponse<InstanceType<Request>> = typeof http.ServerResponse,
         | 
| 309 | 
            +
                >(requestListener?: http.RequestListener<Request, Response>): Server<Request, Response>;
         | 
| 310 | 
            +
                function createServer<
         | 
| 311 | 
            +
                    Request extends typeof http.IncomingMessage = typeof http.IncomingMessage,
         | 
| 312 | 
            +
                    Response extends typeof http.ServerResponse<InstanceType<Request>> = typeof http.ServerResponse,
         | 
| 313 | 
            +
                >(
         | 
| 314 | 
            +
                    options: ServerOptions<Request, Response>,
         | 
| 315 | 
            +
                    requestListener?: http.RequestListener<Request, Response>,
         | 
| 316 | 
            +
                ): Server<Request, Response>;
         | 
| 317 | 
            +
                /**
         | 
| 318 | 
            +
                 * Makes a request to a secure web server.
         | 
| 319 | 
            +
                 *
         | 
| 320 | 
            +
                 * The following additional `options` from `tls.connect()` are also accepted: `ca`, `cert`, `ciphers`, `clientCertEngine`, `crl`, `dhparam`, `ecdhCurve`, `honorCipherOrder`, `key`, `passphrase`,
         | 
| 321 | 
            +
                 * `pfx`, `rejectUnauthorized`, `secureOptions`, `secureProtocol`, `servername`, `sessionIdContext`, `highWaterMark`.
         | 
| 322 | 
            +
                 *
         | 
| 323 | 
            +
                 * `options` can be an object, a string, or a `URL` object. If `options` is a
         | 
| 324 | 
            +
                 * string, it is automatically parsed with `new URL()`. If it is a `URL` object, it will be automatically converted to an ordinary `options` object.
         | 
| 325 | 
            +
                 *
         | 
| 326 | 
            +
                 * `https.request()` returns an instance of the `http.ClientRequest` class. The `ClientRequest` instance is a writable stream. If one needs to
         | 
| 327 | 
            +
                 * upload a file with a POST request, then write to the `ClientRequest` object.
         | 
| 328 | 
            +
                 *
         | 
| 329 | 
            +
                 * ```js
         | 
| 330 | 
            +
                 * import https from 'node:https';
         | 
| 331 | 
            +
                 *
         | 
| 332 | 
            +
                 * const options = {
         | 
| 333 | 
            +
                 *   hostname: 'encrypted.google.com',
         | 
| 334 | 
            +
                 *   port: 443,
         | 
| 335 | 
            +
                 *   path: '/',
         | 
| 336 | 
            +
                 *   method: 'GET',
         | 
| 337 | 
            +
                 * };
         | 
| 338 | 
            +
                 *
         | 
| 339 | 
            +
                 * const req = https.request(options, (res) => {
         | 
| 340 | 
            +
                 *   console.log('statusCode:', res.statusCode);
         | 
| 341 | 
            +
                 *   console.log('headers:', res.headers);
         | 
| 342 | 
            +
                 *
         | 
| 343 | 
            +
                 *   res.on('data', (d) => {
         | 
| 344 | 
            +
                 *     process.stdout.write(d);
         | 
| 345 | 
            +
                 *   });
         | 
| 346 | 
            +
                 * });
         | 
| 347 | 
            +
                 *
         | 
| 348 | 
            +
                 * req.on('error', (e) => {
         | 
| 349 | 
            +
                 *   console.error(e);
         | 
| 350 | 
            +
                 * });
         | 
| 351 | 
            +
                 * req.end();
         | 
| 352 | 
            +
                 * ```
         | 
| 353 | 
            +
                 *
         | 
| 354 | 
            +
                 * Example using options from `tls.connect()`:
         | 
| 355 | 
            +
                 *
         | 
| 356 | 
            +
                 * ```js
         | 
| 357 | 
            +
                 * const options = {
         | 
| 358 | 
            +
                 *   hostname: 'encrypted.google.com',
         | 
| 359 | 
            +
                 *   port: 443,
         | 
| 360 | 
            +
                 *   path: '/',
         | 
| 361 | 
            +
                 *   method: 'GET',
         | 
| 362 | 
            +
                 *   key: fs.readFileSync('test/fixtures/keys/agent2-key.pem'),
         | 
| 363 | 
            +
                 *   cert: fs.readFileSync('test/fixtures/keys/agent2-cert.pem'),
         | 
| 364 | 
            +
                 * };
         | 
| 365 | 
            +
                 * options.agent = new https.Agent(options);
         | 
| 366 | 
            +
                 *
         | 
| 367 | 
            +
                 * const req = https.request(options, (res) => {
         | 
| 368 | 
            +
                 *   // ...
         | 
| 369 | 
            +
                 * });
         | 
| 370 | 
            +
                 * ```
         | 
| 371 | 
            +
                 *
         | 
| 372 | 
            +
                 * Alternatively, opt out of connection pooling by not using an `Agent`.
         | 
| 373 | 
            +
                 *
         | 
| 374 | 
            +
                 * ```js
         | 
| 375 | 
            +
                 * const options = {
         | 
| 376 | 
            +
                 *   hostname: 'encrypted.google.com',
         | 
| 377 | 
            +
                 *   port: 443,
         | 
| 378 | 
            +
                 *   path: '/',
         | 
| 379 | 
            +
                 *   method: 'GET',
         | 
| 380 | 
            +
                 *   key: fs.readFileSync('test/fixtures/keys/agent2-key.pem'),
         | 
| 381 | 
            +
                 *   cert: fs.readFileSync('test/fixtures/keys/agent2-cert.pem'),
         | 
| 382 | 
            +
                 *   agent: false,
         | 
| 383 | 
            +
                 * };
         | 
| 384 | 
            +
                 *
         | 
| 385 | 
            +
                 * const req = https.request(options, (res) => {
         | 
| 386 | 
            +
                 *   // ...
         | 
| 387 | 
            +
                 * });
         | 
| 388 | 
            +
                 * ```
         | 
| 389 | 
            +
                 *
         | 
| 390 | 
            +
                 * Example using a `URL` as `options`:
         | 
| 391 | 
            +
                 *
         | 
| 392 | 
            +
                 * ```js
         | 
| 393 | 
            +
                 * const options = new URL('https://abc:xyz@example.com');
         | 
| 394 | 
            +
                 *
         | 
| 395 | 
            +
                 * const req = https.request(options, (res) => {
         | 
| 396 | 
            +
                 *   // ...
         | 
| 397 | 
            +
                 * });
         | 
| 398 | 
            +
                 * ```
         | 
| 399 | 
            +
                 *
         | 
| 400 | 
            +
                 * Example pinning on certificate fingerprint, or the public key (similar to`pin-sha256`):
         | 
| 401 | 
            +
                 *
         | 
| 402 | 
            +
                 * ```js
         | 
| 403 | 
            +
                 * import tls from 'node:tls';
         | 
| 404 | 
            +
                 * import https from 'node:https';
         | 
| 405 | 
            +
                 * import crypto from 'node:crypto';
         | 
| 406 | 
            +
                 *
         | 
| 407 | 
            +
                 * function sha256(s) {
         | 
| 408 | 
            +
                 *   return crypto.createHash('sha256').update(s).digest('base64');
         | 
| 409 | 
            +
                 * }
         | 
| 410 | 
            +
                 * const options = {
         | 
| 411 | 
            +
                 *   hostname: 'github.com',
         | 
| 412 | 
            +
                 *   port: 443,
         | 
| 413 | 
            +
                 *   path: '/',
         | 
| 414 | 
            +
                 *   method: 'GET',
         | 
| 415 | 
            +
                 *   checkServerIdentity: function(host, cert) {
         | 
| 416 | 
            +
                 *     // Make sure the certificate is issued to the host we are connected to
         | 
| 417 | 
            +
                 *     const err = tls.checkServerIdentity(host, cert);
         | 
| 418 | 
            +
                 *     if (err) {
         | 
| 419 | 
            +
                 *       return err;
         | 
| 420 | 
            +
                 *     }
         | 
| 421 | 
            +
                 *
         | 
| 422 | 
            +
                 *     // Pin the public key, similar to HPKP pin-sha256 pinning
         | 
| 423 | 
            +
                 *     const pubkey256 = 'pL1+qb9HTMRZJmuC/bB/ZI9d302BYrrqiVuRyW+DGrU=';
         | 
| 424 | 
            +
                 *     if (sha256(cert.pubkey) !== pubkey256) {
         | 
| 425 | 
            +
                 *       const msg = 'Certificate verification error: ' +
         | 
| 426 | 
            +
                 *         `The public key of '${cert.subject.CN}' ` +
         | 
| 427 | 
            +
                 *         'does not match our pinned fingerprint';
         | 
| 428 | 
            +
                 *       return new Error(msg);
         | 
| 429 | 
            +
                 *     }
         | 
| 430 | 
            +
                 *
         | 
| 431 | 
            +
                 *     // Pin the exact certificate, rather than the pub key
         | 
| 432 | 
            +
                 *     const cert256 = '25:FE:39:32:D9:63:8C:8A:FC:A1:9A:29:87:' +
         | 
| 433 | 
            +
                 *       'D8:3E:4C:1D:98:DB:71:E4:1A:48:03:98:EA:22:6A:BD:8B:93:16';
         | 
| 434 | 
            +
                 *     if (cert.fingerprint256 !== cert256) {
         | 
| 435 | 
            +
                 *       const msg = 'Certificate verification error: ' +
         | 
| 436 | 
            +
                 *         `The certificate of '${cert.subject.CN}' ` +
         | 
| 437 | 
            +
                 *         'does not match our pinned fingerprint';
         | 
| 438 | 
            +
                 *       return new Error(msg);
         | 
| 439 | 
            +
                 *     }
         | 
| 440 | 
            +
                 *
         | 
| 441 | 
            +
                 *     // This loop is informational only.
         | 
| 442 | 
            +
                 *     // Print the certificate and public key fingerprints of all certs in the
         | 
| 443 | 
            +
                 *     // chain. Its common to pin the public key of the issuer on the public
         | 
| 444 | 
            +
                 *     // internet, while pinning the public key of the service in sensitive
         | 
| 445 | 
            +
                 *     // environments.
         | 
| 446 | 
            +
                 *     do {
         | 
| 447 | 
            +
                 *       console.log('Subject Common Name:', cert.subject.CN);
         | 
| 448 | 
            +
                 *       console.log('  Certificate SHA256 fingerprint:', cert.fingerprint256);
         | 
| 449 | 
            +
                 *
         | 
| 450 | 
            +
                 *       hash = crypto.createHash('sha256');
         | 
| 451 | 
            +
                 *       console.log('  Public key ping-sha256:', sha256(cert.pubkey));
         | 
| 452 | 
            +
                 *
         | 
| 453 | 
            +
                 *       lastprint256 = cert.fingerprint256;
         | 
| 454 | 
            +
                 *       cert = cert.issuerCertificate;
         | 
| 455 | 
            +
                 *     } while (cert.fingerprint256 !== lastprint256);
         | 
| 456 | 
            +
                 *
         | 
| 457 | 
            +
                 *   },
         | 
| 458 | 
            +
                 * };
         | 
| 459 | 
            +
                 *
         | 
| 460 | 
            +
                 * options.agent = new https.Agent(options);
         | 
| 461 | 
            +
                 * const req = https.request(options, (res) => {
         | 
| 462 | 
            +
                 *   console.log('All OK. Server matched our pinned cert or public key');
         | 
| 463 | 
            +
                 *   console.log('statusCode:', res.statusCode);
         | 
| 464 | 
            +
                 *   // Print the HPKP values
         | 
| 465 | 
            +
                 *   console.log('headers:', res.headers['public-key-pins']);
         | 
| 466 | 
            +
                 *
         | 
| 467 | 
            +
                 *   res.on('data', (d) => {});
         | 
| 468 | 
            +
                 * });
         | 
| 469 | 
            +
                 *
         | 
| 470 | 
            +
                 * req.on('error', (e) => {
         | 
| 471 | 
            +
                 *   console.error(e.message);
         | 
| 472 | 
            +
                 * });
         | 
| 473 | 
            +
                 * req.end();
         | 
| 474 | 
            +
                 * ```
         | 
| 475 | 
            +
                 *
         | 
| 476 | 
            +
                 * Outputs for example:
         | 
| 477 | 
            +
                 *
         | 
| 478 | 
            +
                 * ```text
         | 
| 479 | 
            +
                 * Subject Common Name: github.com
         | 
| 480 | 
            +
                 *   Certificate SHA256 fingerprint: 25:FE:39:32:D9:63:8C:8A:FC:A1:9A:29:87:D8:3E:4C:1D:98:DB:71:E4:1A:48:03:98:EA:22:6A:BD:8B:93:16
         | 
| 481 | 
            +
                 *   Public key ping-sha256: pL1+qb9HTMRZJmuC/bB/ZI9d302BYrrqiVuRyW+DGrU=
         | 
| 482 | 
            +
                 * Subject Common Name: DigiCert SHA2 Extended Validation Server CA
         | 
| 483 | 
            +
                 *   Certificate SHA256 fingerprint: 40:3E:06:2A:26:53:05:91:13:28:5B:AF:80:A0:D4:AE:42:2C:84:8C:9F:78:FA:D0:1F:C9:4B:C5:B8:7F:EF:1A
         | 
| 484 | 
            +
                 *   Public key ping-sha256: RRM1dGqnDFsCJXBTHky16vi1obOlCgFFn/yOhI/y+ho=
         | 
| 485 | 
            +
                 * Subject Common Name: DigiCert High Assurance EV Root CA
         | 
| 486 | 
            +
                 *   Certificate SHA256 fingerprint: 74:31:E5:F4:C3:C1:CE:46:90:77:4F:0B:61:E0:54:40:88:3B:A9:A0:1E:D0:0B:A6:AB:D7:80:6E:D3:B1:18:CF
         | 
| 487 | 
            +
                 *   Public key ping-sha256: WoiWRyIOVNa9ihaBciRSC7XHjliYS9VwUGOIud4PB18=
         | 
| 488 | 
            +
                 * All OK. Server matched our pinned cert or public key
         | 
| 489 | 
            +
                 * statusCode: 200
         | 
| 490 | 
            +
                 * headers: max-age=0; pin-sha256="WoiWRyIOVNa9ihaBciRSC7XHjliYS9VwUGOIud4PB18="; pin-sha256="RRM1dGqnDFsCJXBTHky16vi1obOlCgFFn/yOhI/y+ho=";
         | 
| 491 | 
            +
                 * pin-sha256="k2v657xBsOVe1PQRwOsHsw3bsGT2VzIqz5K+59sNQws="; pin-sha256="K87oWBWM9UZfyddvDfoxL+8lpNyoUB2ptGtn0fv6G2Q="; pin-sha256="IQBnNBEiFuhj+8x6X8XLgh01V9Ic5/V3IRQLNFFc7v4=";
         | 
| 492 | 
            +
                 * pin-sha256="iie1VXtL7HzAMF+/PVPR9xzT80kQxdZeJ+zduCB3uj0="; pin-sha256="LvRiGEjRqfzurezaWuj8Wie2gyHMrW5Q06LspMnox7A="; includeSubDomains
         | 
| 493 | 
            +
                 * ```
         | 
| 494 | 
            +
                 * @since v0.3.6
         | 
| 495 | 
            +
                 * @param options Accepts all `options` from `request`, with some differences in default values:
         | 
| 496 | 
            +
                 */
         | 
| 497 | 
            +
                function request(
         | 
| 498 | 
            +
                    options: RequestOptions | string | URL,
         | 
| 499 | 
            +
                    callback?: (res: http.IncomingMessage) => void,
         | 
| 500 | 
            +
                ): http.ClientRequest;
         | 
| 501 | 
            +
                function request(
         | 
| 502 | 
            +
                    url: string | URL,
         | 
| 503 | 
            +
                    options: RequestOptions,
         | 
| 504 | 
            +
                    callback?: (res: http.IncomingMessage) => void,
         | 
| 505 | 
            +
                ): http.ClientRequest;
         | 
| 506 | 
            +
                /**
         | 
| 507 | 
            +
                 * Like `http.get()` but for HTTPS.
         | 
| 508 | 
            +
                 *
         | 
| 509 | 
            +
                 * `options` can be an object, a string, or a `URL` object. If `options` is a
         | 
| 510 | 
            +
                 * string, it is automatically parsed with `new URL()`. If it is a `URL` object, it will be automatically converted to an ordinary `options` object.
         | 
| 511 | 
            +
                 *
         | 
| 512 | 
            +
                 * ```js
         | 
| 513 | 
            +
                 * import https from 'node:https';
         | 
| 514 | 
            +
                 *
         | 
| 515 | 
            +
                 * https.get('https://encrypted.google.com/', (res) => {
         | 
| 516 | 
            +
                 *   console.log('statusCode:', res.statusCode);
         | 
| 517 | 
            +
                 *   console.log('headers:', res.headers);
         | 
| 518 | 
            +
                 *
         | 
| 519 | 
            +
                 *   res.on('data', (d) => {
         | 
| 520 | 
            +
                 *     process.stdout.write(d);
         | 
| 521 | 
            +
                 *   });
         | 
| 522 | 
            +
                 *
         | 
| 523 | 
            +
                 * }).on('error', (e) => {
         | 
| 524 | 
            +
                 *   console.error(e);
         | 
| 525 | 
            +
                 * });
         | 
| 526 | 
            +
                 * ```
         | 
| 527 | 
            +
                 * @since v0.3.6
         | 
| 528 | 
            +
                 * @param options Accepts the same `options` as {@link request}, with the `method` always set to `GET`.
         | 
| 529 | 
            +
                 */
         | 
| 530 | 
            +
                function get(
         | 
| 531 | 
            +
                    options: RequestOptions | string | URL,
         | 
| 532 | 
            +
                    callback?: (res: http.IncomingMessage) => void,
         | 
| 533 | 
            +
                ): http.ClientRequest;
         | 
| 534 | 
            +
                function get(
         | 
| 535 | 
            +
                    url: string | URL,
         | 
| 536 | 
            +
                    options: RequestOptions,
         | 
| 537 | 
            +
                    callback?: (res: http.IncomingMessage) => void,
         | 
| 538 | 
            +
                ): http.ClientRequest;
         | 
| 539 | 
            +
                let globalAgent: Agent;
         | 
| 540 | 
            +
            }
         | 
| 541 | 
            +
            declare module "node:https" {
         | 
| 542 | 
            +
                export * from "https";
         | 
| 543 | 
            +
            }
         | 
| @@ -0,0 +1,92 @@ | |
| 1 | 
            +
            /**
         | 
| 2 | 
            +
             * License for programmatically and manually incorporated
         | 
| 3 | 
            +
             * documentation aka. `JSDoc` from https://github.com/nodejs/node/tree/master/doc
         | 
| 4 | 
            +
             *
         | 
| 5 | 
            +
             * Copyright Node.js contributors. All rights reserved.
         | 
| 6 | 
            +
             * Permission is hereby granted, free of charge, to any person obtaining a copy
         | 
| 7 | 
            +
             * of this software and associated documentation files (the "Software"), to
         | 
| 8 | 
            +
             * deal in the Software without restriction, including without limitation the
         | 
| 9 | 
            +
             * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
         | 
| 10 | 
            +
             * sell copies of the Software, and to permit persons to whom the Software is
         | 
| 11 | 
            +
             * furnished to do so, subject to the following conditions:
         | 
| 12 | 
            +
             *
         | 
| 13 | 
            +
             * The above copyright notice and this permission notice shall be included in
         | 
| 14 | 
            +
             * all copies or substantial portions of the Software.
         | 
| 15 | 
            +
             *
         | 
| 16 | 
            +
             * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
         | 
| 17 | 
            +
             * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
         | 
| 18 | 
            +
             * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
         | 
| 19 | 
            +
             * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
         | 
| 20 | 
            +
             * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
         | 
| 21 | 
            +
             * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
         | 
| 22 | 
            +
             * IN THE SOFTWARE.
         | 
| 23 | 
            +
             */
         | 
| 24 | 
            +
             | 
| 25 | 
            +
            // NOTE: These definitions support Node.js and TypeScript 5.7+.
         | 
| 26 | 
            +
             | 
| 27 | 
            +
            // Reference required TypeScript libs:
         | 
| 28 | 
            +
            /// <reference lib="es2020" />
         | 
| 29 | 
            +
             | 
| 30 | 
            +
            // TypeScript backwards-compatibility definitions:
         | 
| 31 | 
            +
            /// <reference path="compatibility/index.d.ts" />
         | 
| 32 | 
            +
             | 
| 33 | 
            +
            // Definitions specific to TypeScript 5.7+:
         | 
| 34 | 
            +
            /// <reference path="globals.typedarray.d.ts" />
         | 
| 35 | 
            +
            /// <reference path="buffer.buffer.d.ts" />
         | 
| 36 | 
            +
             | 
| 37 | 
            +
            // Definitions for Node.js modules that are not specific to any version of TypeScript:
         | 
| 38 | 
            +
            /// <reference path="globals.d.ts" />
         | 
| 39 | 
            +
            /// <reference path="assert.d.ts" />
         | 
| 40 | 
            +
            /// <reference path="assert/strict.d.ts" />
         | 
| 41 | 
            +
            /// <reference path="async_hooks.d.ts" />
         | 
| 42 | 
            +
            /// <reference path="buffer.d.ts" />
         | 
| 43 | 
            +
            /// <reference path="child_process.d.ts" />
         | 
| 44 | 
            +
            /// <reference path="cluster.d.ts" />
         | 
| 45 | 
            +
            /// <reference path="console.d.ts" />
         | 
| 46 | 
            +
            /// <reference path="constants.d.ts" />
         | 
| 47 | 
            +
            /// <reference path="crypto.d.ts" />
         | 
| 48 | 
            +
            /// <reference path="dgram.d.ts" />
         | 
| 49 | 
            +
            /// <reference path="diagnostics_channel.d.ts" />
         | 
| 50 | 
            +
            /// <reference path="dns.d.ts" />
         | 
| 51 | 
            +
            /// <reference path="dns/promises.d.ts" />
         | 
| 52 | 
            +
            /// <reference path="dns/promises.d.ts" />
         | 
| 53 | 
            +
            /// <reference path="domain.d.ts" />
         | 
| 54 | 
            +
            /// <reference path="dom-events.d.ts" />
         | 
| 55 | 
            +
            /// <reference path="events.d.ts" />
         | 
| 56 | 
            +
            /// <reference path="fs.d.ts" />
         | 
| 57 | 
            +
            /// <reference path="fs/promises.d.ts" />
         | 
| 58 | 
            +
            /// <reference path="http.d.ts" />
         | 
| 59 | 
            +
            /// <reference path="http2.d.ts" />
         | 
| 60 | 
            +
            /// <reference path="https.d.ts" />
         | 
| 61 | 
            +
            /// <reference path="inspector.d.ts" />
         | 
| 62 | 
            +
            /// <reference path="module.d.ts" />
         | 
| 63 | 
            +
            /// <reference path="net.d.ts" />
         | 
| 64 | 
            +
            /// <reference path="os.d.ts" />
         | 
| 65 | 
            +
            /// <reference path="path.d.ts" />
         | 
| 66 | 
            +
            /// <reference path="perf_hooks.d.ts" />
         | 
| 67 | 
            +
            /// <reference path="process.d.ts" />
         | 
| 68 | 
            +
            /// <reference path="punycode.d.ts" />
         | 
| 69 | 
            +
            /// <reference path="querystring.d.ts" />
         | 
| 70 | 
            +
            /// <reference path="readline.d.ts" />
         | 
| 71 | 
            +
            /// <reference path="readline/promises.d.ts" />
         | 
| 72 | 
            +
            /// <reference path="repl.d.ts" />
         | 
| 73 | 
            +
            /// <reference path="sea.d.ts" />
         | 
| 74 | 
            +
            /// <reference path="sqlite.d.ts" />
         | 
| 75 | 
            +
            /// <reference path="stream.d.ts" />
         | 
| 76 | 
            +
            /// <reference path="stream/promises.d.ts" />
         | 
| 77 | 
            +
            /// <reference path="stream/consumers.d.ts" />
         | 
| 78 | 
            +
            /// <reference path="stream/web.d.ts" />
         | 
| 79 | 
            +
            /// <reference path="string_decoder.d.ts" />
         | 
| 80 | 
            +
            /// <reference path="test.d.ts" />
         | 
| 81 | 
            +
            /// <reference path="timers.d.ts" />
         | 
| 82 | 
            +
            /// <reference path="timers/promises.d.ts" />
         | 
| 83 | 
            +
            /// <reference path="tls.d.ts" />
         | 
| 84 | 
            +
            /// <reference path="trace_events.d.ts" />
         | 
| 85 | 
            +
            /// <reference path="tty.d.ts" />
         | 
| 86 | 
            +
            /// <reference path="url.d.ts" />
         | 
| 87 | 
            +
            /// <reference path="util.d.ts" />
         | 
| 88 | 
            +
            /// <reference path="v8.d.ts" />
         | 
| 89 | 
            +
            /// <reference path="vm.d.ts" />
         | 
| 90 | 
            +
            /// <reference path="wasi.d.ts" />
         | 
| 91 | 
            +
            /// <reference path="worker_threads.d.ts" />
         | 
| 92 | 
            +
            /// <reference path="zlib.d.ts" />
         |