aws-delivlib 15.2.0 → 15.3.0

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.
Files changed (108) hide show
  1. package/lib/auto-build.d.ts +7 -1
  2. package/lib/auto-build.js +2 -1
  3. package/lib/custom-resource-handlers/src/certificate-signing-request.tsbuildinfo +1 -1
  4. package/lib/custom-resource-handlers/src/pgp-secret.tsbuildinfo +1 -1
  5. package/lib/custom-resource-handlers/src/private-key.tsbuildinfo +1 -1
  6. package/lib/package-integrity/handler/validate.bundle.js +23640 -19373
  7. package/lib/publishing/github/node_modules/.yarn-integrity +4 -4
  8. package/lib/publishing/github/node_modules/@types/aws-lambda/README.md +1 -1
  9. package/lib/publishing/github/node_modules/@types/aws-lambda/package.json +2 -2
  10. package/lib/publishing/github/node_modules/@types/aws-lambda/trigger/cognito-user-pool-trigger/inbound-federation.d.ts +40 -0
  11. package/lib/publishing/github/node_modules/@types/aws-lambda/trigger/cognito-user-pool-trigger/index.d.ts +3 -1
  12. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/README.md +1 -1
  13. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/assert/strict.d.ts +0 -46
  14. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/assert.d.ts +2 -7
  15. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/async_hooks.d.ts +126 -38
  16. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/buffer.buffer.d.ts +1 -1
  17. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/buffer.d.ts +0 -45
  18. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/child_process.d.ts +5 -67
  19. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/cluster.d.ts +0 -54
  20. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/console.d.ts +0 -58
  21. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/constants.d.ts +0 -6
  22. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/crypto.d.ts +14 -21
  23. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/dgram.d.ts +0 -27
  24. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/diagnostics_channel.d.ts +0 -24
  25. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/dns/promises.d.ts +0 -6
  26. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/dns.d.ts +0 -46
  27. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/domain.d.ts +0 -16
  28. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/events.d.ts +12 -58
  29. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/fs/promises.d.ts +150 -11
  30. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/fs.d.ts +132 -28
  31. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/http.d.ts +23 -43
  32. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/http2.d.ts +16 -11
  33. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/https.d.ts +0 -5
  34. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/index.d.ts +2 -0
  35. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/inspector/promises.d.ts +0 -6
  36. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/inspector.d.ts +45 -5
  37. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/inspector.generated.d.ts +583 -403
  38. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/module.d.ts +1 -65
  39. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/net.d.ts +57 -20
  40. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/os.d.ts +0 -9
  41. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/package.json +4 -4
  42. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/path.d.ts +0 -9
  43. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/perf_hooks.d.ts +0 -31
  44. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/process.d.ts +75 -32
  45. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/punycode.d.ts +0 -28
  46. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/querystring.d.ts +0 -13
  47. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/quic.d.ts +2 -15
  48. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/readline/promises.d.ts +0 -3
  49. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/readline.d.ts +1 -35
  50. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/repl.d.ts +15 -10
  51. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/sea.d.ts +0 -115
  52. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/sqlite.d.ts +182 -69
  53. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/stream/consumers.d.ts +81 -5
  54. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/stream/iter.d.ts +301 -0
  55. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/stream/web.d.ts +7 -3
  56. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/stream.d.ts +42 -28
  57. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/string_decoder.d.ts +0 -40
  58. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/test/reporters.d.ts +1 -38
  59. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/test.d.ts +153 -113
  60. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/timers/promises.d.ts +0 -15
  61. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/timers.d.ts +0 -10
  62. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/tls.d.ts +20 -25
  63. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/trace_events.d.ts +0 -94
  64. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/ts5.6/buffer.buffer.d.ts +1 -1
  65. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/ts5.6/index.d.ts +2 -0
  66. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/ts5.7/index.d.ts +2 -0
  67. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/tty.d.ts +0 -25
  68. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/url.d.ts +49 -12
  69. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/util.d.ts +27 -12
  70. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/v8.d.ts +9 -12
  71. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/vm.d.ts +55 -127
  72. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/wasi.d.ts +0 -71
  73. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/web-globals/fetch.d.ts +15 -0
  74. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/worker_threads.d.ts +15 -61
  75. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/zlib/iter.d.ts +131 -0
  76. package/lib/publishing/github/node_modules/@types/jsonwebtoken/node_modules/@types/node/zlib.d.ts +68 -97
  77. package/lib/publishing/github/node_modules/semver/README.md +22 -6
  78. package/lib/publishing/github/node_modules/semver/bin/semver.js +15 -11
  79. package/lib/publishing/github/node_modules/semver/classes/range.js +7 -0
  80. package/lib/publishing/github/node_modules/semver/functions/diff.js +1 -1
  81. package/lib/publishing/github/node_modules/semver/functions/truncate.js +48 -0
  82. package/lib/publishing/github/node_modules/semver/index.js +2 -0
  83. package/lib/publishing/github/node_modules/semver/internal/re.js +3 -3
  84. package/lib/publishing/github/node_modules/semver/package.json +4 -4
  85. package/lib/publishing/github/node_modules/semver/range.bnf +5 -4
  86. package/lib/publishing/github/node_modules/semver/ranges/subset.js +3 -3
  87. package/lib/publishing/github/node_modules/undici-types/agent.d.ts +1 -1
  88. package/lib/publishing/github/node_modules/undici-types/api.d.ts +2 -2
  89. package/lib/publishing/github/node_modules/undici-types/balanced-pool.d.ts +2 -1
  90. package/lib/publishing/github/node_modules/undici-types/cache-interceptor.d.ts +7 -0
  91. package/lib/publishing/github/node_modules/undici-types/client.d.ts +16 -1
  92. package/lib/publishing/github/node_modules/undici-types/connector.d.ts +4 -2
  93. package/lib/publishing/github/node_modules/undici-types/diagnostics-channel.d.ts +2 -2
  94. package/lib/publishing/github/node_modules/undici-types/dispatcher.d.ts +20 -17
  95. package/lib/publishing/github/node_modules/undici-types/errors.d.ts +17 -1
  96. package/lib/publishing/github/node_modules/undici-types/fetch.d.ts +4 -4
  97. package/lib/publishing/github/node_modules/undici-types/formdata.d.ts +1 -1
  98. package/lib/publishing/github/node_modules/undici-types/h2c-client.d.ts +1 -1
  99. package/lib/publishing/github/node_modules/undici-types/index.d.ts +12 -1
  100. package/lib/publishing/github/node_modules/undici-types/interceptors.d.ts +43 -2
  101. package/lib/publishing/github/node_modules/undici-types/package.json +1 -1
  102. package/lib/publishing/github/node_modules/undici-types/pool.d.ts +1 -1
  103. package/lib/publishing/github/node_modules/undici-types/readable.d.ts +2 -2
  104. package/lib/publishing/github/node_modules/undici-types/round-robin-pool.d.ts +41 -0
  105. package/lib/publishing/github/node_modules/undici-types/socks5-proxy-agent.d.ts +25 -0
  106. package/lib/publishing/github/node_modules/undici-types/webidl.d.ts +6 -0
  107. package/lib/publishing/github/node_modules/undici-types/websocket.d.ts +11 -9
  108. package/package.json +28 -14
@@ -47,12 +47,12 @@
47
47
  "@octokit/webhooks-methods@^3.0.0": "https://registry.yarnpkg.com/@octokit/webhooks-methods/-/webhooks-methods-3.0.3.tgz#2648668d34fe44e437eca90c9031d0f3cb759c77",
48
48
  "@octokit/webhooks-types@6.11.0": "https://registry.yarnpkg.com/@octokit/webhooks-types/-/webhooks-types-6.11.0.tgz#1fb903bff3f2883490d6ba88d8cb8f8a55f68176",
49
49
  "@octokit/webhooks@^10.0.0": "https://registry.yarnpkg.com/@octokit/webhooks/-/webhooks-10.9.2.tgz#1b1e79a70fa5b22a3149b18432cbf3f39dbcb544",
50
- "@types/aws-lambda@^8.10.83": "https://registry.yarnpkg.com/@types/aws-lambda/-/aws-lambda-8.10.160.tgz#7a3afdd919d730e4e2be7239d0af5f36a8b0ce1e",
50
+ "@types/aws-lambda@^8.10.83": "https://registry.yarnpkg.com/@types/aws-lambda/-/aws-lambda-8.10.161.tgz#36d95723ec46d3d555bf0684f83cf4d4369a28ad",
51
51
  "@types/btoa-lite@^1.0.0": "https://registry.yarnpkg.com/@types/btoa-lite/-/btoa-lite-1.0.2.tgz#82bb6aab00abf7cff3ca2825abe010c0cd536ae5",
52
52
  "@types/changelog-parser@^2.8.1": "https://registry.yarnpkg.com/@types/changelog-parser/-/changelog-parser-2.8.4.tgz#45d70417e742ac3bc6bef3786aa453e1f1d63ecc",
53
53
  "@types/jsonwebtoken@^9.0.0": "https://registry.yarnpkg.com/@types/jsonwebtoken/-/jsonwebtoken-9.0.10.tgz#a7932a47177dcd4283b6146f3bd5c26d82647f09",
54
54
  "@types/ms@*": "https://registry.yarnpkg.com/@types/ms/-/ms-2.1.0.tgz#052aa67a48eccc4309d7f0191b7e41434b90bb78",
55
- "@types/node@*": "https://registry.yarnpkg.com/@types/node/-/node-25.2.0.tgz#015b7d228470c1dcbfc17fe9c63039d216b4d782",
55
+ "@types/node@*": "https://registry.yarnpkg.com/@types/node/-/node-25.9.1.tgz#3bda556db500ae4319c08e7fc9ab94f19013ba0b",
56
56
  "@types/node@^14": "https://registry.yarnpkg.com/@types/node/-/node-14.18.63.tgz#1788fa8da838dbb5f9ea994b834278205db6ca2b",
57
57
  "aggregate-error@^3.1.0": "https://registry.yarnpkg.com/aggregate-error/-/aggregate-error-3.1.0.tgz#92670ff50f5359bdb7a3e0d40d0ec30c5737687a",
58
58
  "before-after-hook@^2.2.0": "https://registry.yarnpkg.com/before-after-hook/-/before-after-hook-2.2.3.tgz#c51e809c81a4e354084422b9b26bad88249c517c",
@@ -85,10 +85,10 @@
85
85
  "once@^1.4.0": "https://registry.yarnpkg.com/once/-/once-1.4.0.tgz#583b1aa775961d4b113ac17d9c50baef9dd76bd1",
86
86
  "remove-markdown@^0.2.2": "https://registry.yarnpkg.com/remove-markdown/-/remove-markdown-0.2.2.tgz#66b0ceeba9fb77ca9636bb1b0307ce21a32a12a6",
87
87
  "safe-buffer@^5.0.1": "https://registry.yarnpkg.com/safe-buffer/-/safe-buffer-5.2.1.tgz#1eaf9fa9bdb1fdd4ec75f58f9cdb4e6b7827eec6",
88
- "semver@^7.5.4": "https://registry.yarnpkg.com/semver/-/semver-7.7.3.tgz#4b5f4143d007633a8dc671cd0a6ef9147b8bb946",
88
+ "semver@^7.5.4": "https://registry.yarnpkg.com/semver/-/semver-7.8.1.tgz#bf4970b5e70fda0686363cc18bfe8805d5ed957e",
89
89
  "tr46@~0.0.3": "https://registry.yarnpkg.com/tr46/-/tr46-0.0.3.tgz#8184fd347dac9cdc185992f3a6622e14b9d9ab6a",
90
90
  "typescript@~4.9.4": "https://registry.yarnpkg.com/typescript/-/typescript-4.9.5.tgz#095979f9bcc0d09da324d58d03ce8f8374cbe65a",
91
- "undici-types@~7.16.0": "https://registry.yarnpkg.com/undici-types/-/undici-types-7.16.0.tgz#ffccdff36aea4884cbfce9a750a0580224f58a46",
91
+ "undici-types@>=7.24.0 <7.24.7": "https://registry.yarnpkg.com/undici-types/-/undici-types-7.24.6.tgz#61275b485d7fd4e9d269c7cf04ec2873c9cc0f91",
92
92
  "universal-github-app-jwt@^1.1.1": "https://registry.yarnpkg.com/universal-github-app-jwt/-/universal-github-app-jwt-1.2.0.tgz#1314cf2b2aff69d7ae998e8bff90d55a651d2949",
93
93
  "universal-user-agent@^6.0.0": "https://registry.yarnpkg.com/universal-user-agent/-/universal-user-agent-6.0.1.tgz#15f20f55da3c930c57bddbf1734c6654d5fd35aa",
94
94
  "webidl-conversions@^3.0.0": "https://registry.yarnpkg.com/webidl-conversions/-/webidl-conversions-3.0.1.tgz#24534275e2a7bc6be7bc86611cc16ae0a5654871",
@@ -8,7 +8,7 @@ This package contains type definitions for aws-lambda (http://docs.aws.amazon.co
8
8
  Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/aws-lambda.
9
9
 
10
10
  ### Additional Details
11
- * Last updated: Mon, 19 Jan 2026 22:02:04 GMT
11
+ * Last updated: Thu, 26 Feb 2026 18:14:19 GMT
12
12
  * Dependencies: none
13
13
 
14
14
  # Credits
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@types/aws-lambda",
3
- "version": "8.10.160",
3
+ "version": "8.10.161",
4
4
  "description": "TypeScript definitions for aws-lambda",
5
5
  "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/aws-lambda",
6
6
  "license": "MIT",
@@ -221,6 +221,6 @@
221
221
  "scripts": {},
222
222
  "dependencies": {},
223
223
  "peerDependencies": {},
224
- "typesPublisherContentHash": "1a51978997643b1f40693dbd614baa93ca58aac80816515d861af254782be0e5",
224
+ "typesPublisherContentHash": "27d4cf93e028357fae8dbd0b56c5cc7cec355e3ba1da224c53e2b497600a4d81",
225
225
  "typeScriptVersion": "5.2"
226
226
  }
@@ -0,0 +1,40 @@
1
+ import { Handler } from "../../handler";
2
+ import { BaseTriggerEvent, StringMap } from "./_common";
3
+
4
+ export type InboundFederationProviderType =
5
+ | "OIDC"
6
+ | "SAML"
7
+ | "Facebook"
8
+ | "Google"
9
+ | "SignInWithApple"
10
+ | "LoginWithAmazon";
11
+
12
+ /**
13
+ * @see https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-lambda-inbound-federation.html
14
+ */
15
+ export interface InboundFederationTriggerEvent extends BaseTriggerEvent<"InboundFederation_ExternalProvider"> {
16
+ request: {
17
+ providerName: string;
18
+ providerType: InboundFederationProviderType;
19
+ attributes: {
20
+ /** OAuth token response. Present for OIDC and social providers. */
21
+ tokenResponse?: StringMap | undefined;
22
+ /** Decoded JWT claims. Present for OIDC and social providers. */
23
+ idToken?: StringMap | undefined;
24
+ /** Extended profile info. Present for OIDC and social providers. */
25
+ userInfo?: StringMap | undefined;
26
+ /** SAML assertion attributes. Present for SAML providers. */
27
+ samlResponse?: StringMap | undefined;
28
+ };
29
+ };
30
+ response: {
31
+ /**
32
+ * User attributes to apply to the user profile.
33
+ * All attributes to be retained must be included; omitted attributes are dropped.
34
+ * Return an empty object `{}` to retain all original attributes unchanged.
35
+ */
36
+ userAttributesToMap: StringMap;
37
+ };
38
+ }
39
+
40
+ export type InboundFederationTriggerHandler = Handler<InboundFederationTriggerEvent>;
@@ -32,7 +32,8 @@ export interface CognitoUserPoolTriggerEvent {
32
32
  | "TokenGeneration_RefreshTokens"
33
33
  | "TokenGeneration_ClientCredentials"
34
34
  | "UserMigration_Authentication"
35
- | "UserMigration_ForgotPassword";
35
+ | "UserMigration_ForgotPassword"
36
+ | "InboundFederation_ExternalProvider";
36
37
  region: string;
37
38
  userPoolId: string;
38
39
  userName?: string | undefined;
@@ -119,6 +120,7 @@ export * from "./custom-email-sender";
119
120
  export * from "./custom-message";
120
121
  export * from "./custom-sms-sender";
121
122
  export * from "./define-auth-challenge";
123
+ export * from "./inbound-federation";
122
124
  export * from "./post-authentication";
123
125
  export * from "./post-confirmation";
124
126
  export * from "./pre-authentication";
@@ -8,7 +8,7 @@ This package contains type definitions for node (https://nodejs.org/).
8
8
  Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node.
9
9
 
10
10
  ### Additional Details
11
- * Last updated: Sun, 01 Feb 2026 15:38:50 GMT
11
+ * Last updated: Tue, 19 May 2026 17:48:56 GMT
12
12
  * Dependencies: [undici-types](https://npmjs.com/package/undici-types)
13
13
 
14
14
  # Credits
@@ -1,49 +1,3 @@
1
- /**
2
- * In strict assertion mode, non-strict methods behave like their corresponding
3
- * strict methods. For example, `assert.deepEqual()` will behave like
4
- * `assert.deepStrictEqual()`.
5
- *
6
- * In strict assertion mode, error messages for objects display a diff. In legacy
7
- * assertion mode, error messages for objects display the objects, often truncated.
8
- *
9
- * To use strict assertion mode:
10
- *
11
- * ```js
12
- * import { strict as assert } from 'node:assert';
13
- * ```
14
- *
15
- * ```js
16
- * import assert from 'node:assert/strict';
17
- * ```
18
- *
19
- * Example error diff:
20
- *
21
- * ```js
22
- * import { strict as assert } from 'node:assert';
23
- *
24
- * assert.deepEqual([[[1, 2, 3]], 4, 5], [[[1, 2, '3']], 4, 5]);
25
- * // AssertionError: Expected inputs to be strictly deep-equal:
26
- * // + actual - expected ... Lines skipped
27
- * //
28
- * // [
29
- * // [
30
- * // ...
31
- * // 2,
32
- * // + 3
33
- * // - '3'
34
- * // ],
35
- * // ...
36
- * // 5
37
- * // ]
38
- * ```
39
- *
40
- * To deactivate the colors, use the `NO_COLOR` or `NODE_DISABLE_COLORS`
41
- * environment variables. This will also deactivate the colors in the REPL. For
42
- * more on color support in terminal environments, read the tty
43
- * [`getColorDepth()`](https://nodejs.org/docs/latest-v25.x/api/tty.html#writestreamgetcolordepthenv) documentation.
44
- * @since v15.0.0
45
- * @see [source](https://github.com/nodejs/node/blob/v25.x/lib/assert/strict.js)
46
- */
47
1
  declare module "node:assert/strict" {
48
2
  import {
49
3
  Assert,
@@ -1,8 +1,3 @@
1
- /**
2
- * The `node:assert` module provides a set of assertion functions for verifying
3
- * invariants.
4
- * @see [source](https://github.com/nodejs/node/blob/v25.x/lib/assert.js)
5
- */
6
1
  declare module "node:assert" {
7
2
  import strict = require("node:assert/strict");
8
3
  /**
@@ -253,10 +248,10 @@ declare module "node:assert" {
253
248
  * import assert from 'node:assert/strict';
254
249
  *
255
250
  * // Using `assert()` works the same:
256
- * assert(0);
251
+ * assert(2 + 2 > 5);;
257
252
  * // AssertionError: The expression evaluated to a falsy value:
258
253
  * //
259
- * // assert(0)
254
+ * // assert(2 + 2 > 5)
260
255
  * ```
261
256
  * @since v0.1.21
262
257
  */
@@ -1,19 +1,3 @@
1
- /**
2
- * We strongly discourage the use of the `async_hooks` API.
3
- * Other APIs that can cover most of its use cases include:
4
- *
5
- * * [`AsyncLocalStorage`](https://nodejs.org/docs/latest-v25.x/api/async_context.html#class-asynclocalstorage) tracks async context
6
- * * [`process.getActiveResourcesInfo()`](https://nodejs.org/docs/latest-v25.x/api/process.html#processgetactiveresourcesinfo) tracks active resources
7
- *
8
- * The `node:async_hooks` module provides an API to track asynchronous resources.
9
- * It can be accessed using:
10
- *
11
- * ```js
12
- * import async_hooks from 'node:async_hooks';
13
- * ```
14
- * @experimental
15
- * @see [source](https://github.com/nodejs/node/blob/v25.x/lib/async_hooks.js)
16
- */
17
1
  declare module "node:async_hooks" {
18
2
  /**
19
3
  * ```js
@@ -123,37 +107,31 @@ declare module "node:async_hooks" {
123
107
  function triggerAsyncId(): number;
124
108
  interface HookCallbacks {
125
109
  /**
126
- * Called when a class is constructed that has the possibility to emit an asynchronous event.
127
- * @param asyncId A unique ID for the async resource
128
- * @param type The type of the async resource
129
- * @param triggerAsyncId The unique ID of the async resource in whose execution context this async resource was created
130
- * @param resource Reference to the resource representing the async operation, needs to be released during destroy
110
+ * The [`init` callback](https://nodejs.org/docs/latest-v25.x/api/async_hooks.html#initasyncid-type-triggerasyncid-resource).
131
111
  */
132
112
  init?(asyncId: number, type: string, triggerAsyncId: number, resource: object): void;
133
113
  /**
134
- * When an asynchronous operation is initiated or completes a callback is called to notify the user.
135
- * The before callback is called just before said callback is executed.
136
- * @param asyncId the unique identifier assigned to the resource about to execute the callback.
114
+ * The [`before` callback](https://nodejs.org/docs/latest-v25.x/api/async_hooks.html#beforeasyncid).
137
115
  */
138
116
  before?(asyncId: number): void;
139
117
  /**
140
- * Called immediately after the callback specified in `before` is completed.
141
- *
142
- * If an uncaught exception occurs during execution of the callback, then `after` will run after the `'uncaughtException'` event is emitted or a `domain`'s handler runs.
143
- * @param asyncId the unique identifier assigned to the resource which has executed the callback.
118
+ * The [`after` callback](https://nodejs.org/docs/latest-v25.x/api/async_hooks.html#afterasyncid).
144
119
  */
145
120
  after?(asyncId: number): void;
146
121
  /**
147
- * Called when a promise has resolve() called. This may not be in the same execution id
148
- * as the promise itself.
149
- * @param asyncId the unique id for the promise that was resolve()d.
122
+ * The [`promiseResolve` callback](https://nodejs.org/docs/latest-v25.x/api/async_hooks.html#promiseresolveasyncid).
150
123
  */
151
124
  promiseResolve?(asyncId: number): void;
152
125
  /**
153
- * Called after the resource corresponding to asyncId is destroyed
154
- * @param asyncId a unique ID for the async resource
126
+ * The [`destroy` callback](https://nodejs.org/docs/latest-v25.x/api/async_hooks.html#destroyasyncid).
155
127
  */
156
128
  destroy?(asyncId: number): void;
129
+ /**
130
+ * Whether the hook should track `Promise`s. Cannot be `false` if
131
+ * `promiseResolve` is set.
132
+ * @default true
133
+ */
134
+ trackPromises?: boolean | undefined;
157
135
  }
158
136
  interface AsyncHook {
159
137
  /**
@@ -174,7 +152,8 @@ declare module "node:async_hooks" {
174
152
  *
175
153
  * All callbacks are optional. For example, if only resource cleanup needs to
176
154
  * be tracked, then only the `destroy` callback needs to be passed. The
177
- * specifics of all functions that can be passed to `callbacks` is in the `Hook Callbacks` section.
155
+ * specifics of all functions that can be passed to `callbacks` is in the
156
+ * [Hook Callbacks](https://nodejs.org/docs/latest-v25.x/api/async_hooks.html#hook-callbacks) section.
178
157
  *
179
158
  * ```js
180
159
  * import { createHook } from 'node:async_hooks';
@@ -202,12 +181,13 @@ declare module "node:async_hooks" {
202
181
  * ```
203
182
  *
204
183
  * Because promises are asynchronous resources whose lifecycle is tracked
205
- * via the async hooks mechanism, the `init()`, `before()`, `after()`, and`destroy()` callbacks _must not_ be async functions that return promises.
184
+ * via the async hooks mechanism, the `init()`, `before()`, `after()`, and
185
+ * `destroy()` callbacks _must not_ be async functions that return promises.
206
186
  * @since v8.1.0
207
- * @param callbacks The `Hook Callbacks` to register
208
- * @return Instance used for disabling and enabling hooks
187
+ * @param options The [Hook Callbacks](https://nodejs.org/docs/latest-v25.x/api/async_hooks.html#hook-callbacks) to register
188
+ * @returns Instance used for disabling and enabling hooks
209
189
  */
210
- function createHook(callbacks: HookCallbacks): AsyncHook;
190
+ function createHook(options: HookCallbacks): AsyncHook;
211
191
  interface AsyncResourceOptions {
212
192
  /**
213
193
  * The ID of the execution context that created this async event.
@@ -511,6 +491,75 @@ declare module "node:async_hooks" {
511
491
  * @experimental
512
492
  */
513
493
  exit<R, TArgs extends any[]>(callback: (...args: TArgs) => R, ...args: TArgs): R;
494
+ /**
495
+ * Creates a disposable scope that enters the given store and automatically
496
+ * restores the previous store value when the scope is disposed. This method is
497
+ * designed to work with JavaScript's explicit resource management (`using` syntax).
498
+ *
499
+ * Example:
500
+ *
501
+ * ```js
502
+ * import { AsyncLocalStorage } from 'node:async_hooks';
503
+ *
504
+ * const asyncLocalStorage = new AsyncLocalStorage();
505
+ *
506
+ * {
507
+ * using _ = asyncLocalStorage.withScope('my-store');
508
+ * console.log(asyncLocalStorage.getStore()); // Prints: my-store
509
+ * }
510
+ *
511
+ * console.log(asyncLocalStorage.getStore()); // Prints: undefined
512
+ * ```
513
+ *
514
+ * The `withScope()` method is particularly useful for managing context in
515
+ * synchronous code where you want to ensure the previous store value is restored
516
+ * when exiting a block, even if an error is thrown.
517
+ *
518
+ * ```js
519
+ * import { AsyncLocalStorage } from 'node:async_hooks';
520
+ *
521
+ * const asyncLocalStorage = new AsyncLocalStorage();
522
+ *
523
+ * try {
524
+ * using _ = asyncLocalStorage.withScope('my-store');
525
+ * console.log(asyncLocalStorage.getStore()); // Prints: my-store
526
+ * throw new Error('test');
527
+ * } catch (e) {
528
+ * // Store is automatically restored even after error
529
+ * console.log(asyncLocalStorage.getStore()); // Prints: undefined
530
+ * }
531
+ * ```
532
+ *
533
+ * **Important:** When using `withScope()` in async functions before the first
534
+ * `await`, be aware that the scope change will affect the caller's context. The
535
+ * synchronous portion of an async function (before the first `await`) runs
536
+ * immediately when called, and when it reaches the first `await`, it returns the
537
+ * promise to the caller. At that point, the scope change becomes visible in the
538
+ * caller's context and will persist in subsequent synchronous code until something
539
+ * else changes the scope value. For async operations, prefer using `run()` which
540
+ * properly isolates context across async boundaries.
541
+ *
542
+ * ```js
543
+ * import { AsyncLocalStorage } from 'node:async_hooks';
544
+ *
545
+ * const asyncLocalStorage = new AsyncLocalStorage();
546
+ *
547
+ * async function example() {
548
+ * using _ = asyncLocalStorage.withScope('my-store');
549
+ * console.log(asyncLocalStorage.getStore()); // Prints: my-store
550
+ * await someAsyncOperation(); // Function pauses here and returns promise
551
+ * console.log(asyncLocalStorage.getStore()); // Prints: my-store
552
+ * }
553
+ *
554
+ * // Calling without await
555
+ * example(); // Synchronous portion runs, then pauses at first await
556
+ * // After the promise is returned, the scope 'my-store' is now active in caller!
557
+ * console.log(asyncLocalStorage.getStore()); // Prints: my-store (unexpected!)
558
+ * ```
559
+ * @since v25.9.0
560
+ * @experimental
561
+ */
562
+ withScope(store: T): RunScope;
514
563
  /**
515
564
  * Transitions into the context for the remainder of the current
516
565
  * synchronous execution and then persists the store through any following
@@ -553,6 +602,45 @@ declare module "node:async_hooks" {
553
602
  */
554
603
  enterWith(store: T): void;
555
604
  }
605
+ /**
606
+ * A disposable scope returned by `asyncLocalStorage.withScope()` that
607
+ * automatically restores the previous store value when disposed. This class
608
+ * implements the [Explicit Resource Management](https://github.com/tc39/proposal-explicit-resource-management) protocol and is designed to work
609
+ * with JavaScript's `using` syntax.
610
+ *
611
+ * The scope automatically restores the previous store value when the `using` block
612
+ * exits, whether through normal completion or by throwing an error.
613
+ * @since v25.9.0
614
+ * @experimental
615
+ */
616
+ interface RunScope extends Disposable {
617
+ /**
618
+ * Explicitly ends the scope and restores the previous store value. This method
619
+ * is idempotent: calling it multiple times has the same effect as calling it once.
620
+ *
621
+ * The `[Symbol.dispose]()` method defers to `dispose()`.
622
+ *
623
+ * If `withScope()` is called without the `using` keyword, `dispose()` must be
624
+ * called manually to restore the previous store value. Forgetting to call
625
+ * `dispose()` will cause the store value to persist for the remainder of the
626
+ * current execution context:
627
+ *
628
+ * ```js
629
+ * import { AsyncLocalStorage } from 'node:async_hooks';
630
+ *
631
+ * const storage = new AsyncLocalStorage();
632
+ *
633
+ * // Without using, the scope must be disposed manually
634
+ * const scope = storage.withScope('my-store');
635
+ * // storage.getStore() === 'my-store' here
636
+ *
637
+ * scope.dispose(); // Restore previous value
638
+ * // storage.getStore() === undefined here
639
+ * ```
640
+ * @since v25.9.0
641
+ */
642
+ dispose(): void;
643
+ }
556
644
  /**
557
645
  * @since v17.2.0, v16.14.0
558
646
  * @return A map of provider types to the corresponding numeric id.
@@ -174,7 +174,7 @@ declare module "node:buffer" {
174
174
  * If `totalLength` is not provided, it is calculated from the `Buffer` instances
175
175
  * in `list` by adding their lengths.
176
176
  *
177
- * If `totalLength` is provided, it is coerced to an unsigned integer. If the
177
+ * If `totalLength` is provided, it must be an unsigned integer. If the
178
178
  * combined length of the `Buffer`s in `list` exceeds `totalLength`, the result is
179
179
  * truncated to `totalLength`. If the combined length of the `Buffer`s in `list` is
180
180
  * less than `totalLength`, the remaining space is filled with zeros.
@@ -1,48 +1,3 @@
1
- /**
2
- * `Buffer` objects are used to represent a fixed-length sequence of bytes. Many
3
- * Node.js APIs support `Buffer`s.
4
- *
5
- * The `Buffer` class is a subclass of JavaScript's [`Uint8Array`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array) class and
6
- * extends it with methods that cover additional use cases. Node.js APIs accept
7
- * plain [`Uint8Array`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array) s wherever `Buffer`s are supported as well.
8
- *
9
- * While the `Buffer` class is available within the global scope, it is still
10
- * recommended to explicitly reference it via an import or require statement.
11
- *
12
- * ```js
13
- * import { Buffer } from 'node:buffer';
14
- *
15
- * // Creates a zero-filled Buffer of length 10.
16
- * const buf1 = Buffer.alloc(10);
17
- *
18
- * // Creates a Buffer of length 10,
19
- * // filled with bytes which all have the value `1`.
20
- * const buf2 = Buffer.alloc(10, 1);
21
- *
22
- * // Creates an uninitialized buffer of length 10.
23
- * // This is faster than calling Buffer.alloc() but the returned
24
- * // Buffer instance might contain old data that needs to be
25
- * // overwritten using fill(), write(), or other functions that fill the Buffer's
26
- * // contents.
27
- * const buf3 = Buffer.allocUnsafe(10);
28
- *
29
- * // Creates a Buffer containing the bytes [1, 2, 3].
30
- * const buf4 = Buffer.from([1, 2, 3]);
31
- *
32
- * // Creates a Buffer containing the bytes [1, 1, 1, 1] – the entries
33
- * // are all truncated using `(value &#x26; 255)` to fit into the range 0–255.
34
- * const buf5 = Buffer.from([257, 257.5, -255, '1']);
35
- *
36
- * // Creates a Buffer containing the UTF-8-encoded bytes for the string 'tést':
37
- * // [0x74, 0xc3, 0xa9, 0x73, 0x74] (in hexadecimal notation)
38
- * // [116, 195, 169, 115, 116] (in decimal notation)
39
- * const buf6 = Buffer.from('tést');
40
- *
41
- * // Creates a Buffer containing the Latin-1 bytes [0x74, 0xe9, 0x73, 0x74].
42
- * const buf7 = Buffer.from('tést', 'latin1');
43
- * ```
44
- * @see [source](https://github.com/nodejs/node/blob/v25.x/lib/buffer.js)
45
- */
46
1
  declare module "node:buffer" {
47
2
  import { ReadableStream } from "node:stream/web";
48
3
  /**
@@ -1,70 +1,3 @@
1
- /**
2
- * The `node:child_process` module provides the ability to spawn subprocesses in
3
- * a manner that is similar, but not identical, to [`popen(3)`](http://man7.org/linux/man-pages/man3/popen.3.html). This capability
4
- * is primarily provided by the {@link spawn} function:
5
- *
6
- * ```js
7
- * import { spawn } from 'node:child_process';
8
- * import { once } from 'node:events';
9
- * const ls = spawn('ls', ['-lh', '/usr']);
10
- *
11
- * ls.stdout.on('data', (data) => {
12
- * console.log(`stdout: ${data}`);
13
- * });
14
- *
15
- * ls.stderr.on('data', (data) => {
16
- * console.error(`stderr: ${data}`);
17
- * });
18
- *
19
- * const [code] = await once(ls, 'close');
20
- * console.log(`child process exited with code ${code}`);
21
- * ```
22
- *
23
- * By default, pipes for `stdin`, `stdout`, and `stderr` are established between
24
- * the parent Node.js process and the spawned subprocess. These pipes have
25
- * limited (and platform-specific) capacity. If the subprocess writes to
26
- * stdout in excess of that limit without the output being captured, the
27
- * subprocess blocks, waiting for the pipe buffer to accept more data. This is
28
- * identical to the behavior of pipes in the shell. Use the `{ stdio: 'ignore' }` option if the output will not be consumed.
29
- *
30
- * The command lookup is performed using the `options.env.PATH` environment
31
- * variable if `env` is in the `options` object. Otherwise, `process.env.PATH` is
32
- * used. If `options.env` is set without `PATH`, lookup on Unix is performed
33
- * on a default search path search of `/usr/bin:/bin` (see your operating system's
34
- * manual for execvpe/execvp), on Windows the current processes environment
35
- * variable `PATH` is used.
36
- *
37
- * On Windows, environment variables are case-insensitive. Node.js
38
- * lexicographically sorts the `env` keys and uses the first one that
39
- * case-insensitively matches. Only first (in lexicographic order) entry will be
40
- * passed to the subprocess. This might lead to issues on Windows when passing
41
- * objects to the `env` option that have multiple variants of the same key, such as `PATH` and `Path`.
42
- *
43
- * The {@link spawn} method spawns the child process asynchronously,
44
- * without blocking the Node.js event loop. The {@link spawnSync} function provides equivalent functionality in a synchronous manner that blocks
45
- * the event loop until the spawned process either exits or is terminated.
46
- *
47
- * For convenience, the `node:child_process` module provides a handful of
48
- * synchronous and asynchronous alternatives to {@link spawn} and {@link spawnSync}. Each of these alternatives are implemented on
49
- * top of {@link spawn} or {@link spawnSync}.
50
- *
51
- * * {@link exec}: spawns a shell and runs a command within that
52
- * shell, passing the `stdout` and `stderr` to a callback function when
53
- * complete.
54
- * * {@link execFile}: similar to {@link exec} except
55
- * that it spawns the command directly without first spawning a shell by
56
- * default.
57
- * * {@link fork}: spawns a new Node.js process and invokes a
58
- * specified module with an IPC communication channel established that allows
59
- * sending messages between parent and child.
60
- * * {@link execSync}: a synchronous version of {@link exec} that will block the Node.js event loop.
61
- * * {@link execFileSync}: a synchronous version of {@link execFile} that will block the Node.js event loop.
62
- *
63
- * For certain use cases, such as automating shell scripts, the `synchronous counterparts` may be more convenient. In many cases, however,
64
- * the synchronous methods can have significant impact on performance due to
65
- * stalling the event loop while spawned processes complete.
66
- * @see [source](https://github.com/nodejs/node/blob/v25.x/lib/child_process.js)
67
- */
68
1
  declare module "node:child_process" {
69
2
  import { NonSharedBuffer } from "node:buffer";
70
3
  import * as dgram from "node:dgram";
@@ -228,6 +161,11 @@ declare module "node:child_process" {
228
161
  /**
229
162
  * The `subprocess.exitCode` property indicates the exit code of the child process.
230
163
  * If the child process is still running, the field will be `null`.
164
+ *
165
+ * When the child process is terminated by a signal, `subprocess.exitCode` will be
166
+ * `null` and `subprocess.signalCode` will be set. To get the corresponding
167
+ * POSIX exit code, use
168
+ * `util.convertProcessSignalToExitCode(subprocess.signalCode)`.
231
169
  */
232
170
  readonly exitCode: number | null;
233
171
  /**
@@ -1,57 +1,3 @@
1
- /**
2
- * Clusters of Node.js processes can be used to run multiple instances of Node.js
3
- * that can distribute workloads among their application threads. When process isolation
4
- * is not needed, use the [`worker_threads`](https://nodejs.org/docs/latest-v25.x/api/worker_threads.html)
5
- * module instead, which allows running multiple application threads within a single Node.js instance.
6
- *
7
- * The cluster module allows easy creation of child processes that all share
8
- * server ports.
9
- *
10
- * ```js
11
- * import cluster from 'node:cluster';
12
- * import http from 'node:http';
13
- * import { availableParallelism } from 'node:os';
14
- * import process from 'node:process';
15
- *
16
- * const numCPUs = availableParallelism();
17
- *
18
- * if (cluster.isPrimary) {
19
- * console.log(`Primary ${process.pid} is running`);
20
- *
21
- * // Fork workers.
22
- * for (let i = 0; i < numCPUs; i++) {
23
- * cluster.fork();
24
- * }
25
- *
26
- * cluster.on('exit', (worker, code, signal) => {
27
- * console.log(`worker ${worker.process.pid} died`);
28
- * });
29
- * } else {
30
- * // Workers can share any TCP connection
31
- * // In this case it is an HTTP server
32
- * http.createServer((req, res) => {
33
- * res.writeHead(200);
34
- * res.end('hello world\n');
35
- * }).listen(8000);
36
- *
37
- * console.log(`Worker ${process.pid} started`);
38
- * }
39
- * ```
40
- *
41
- * Running Node.js will now share port 8000 between the workers:
42
- *
43
- * ```console
44
- * $ node server.js
45
- * Primary 3596 is running
46
- * Worker 4324 started
47
- * Worker 4520 started
48
- * Worker 6056 started
49
- * Worker 5644 started
50
- * ```
51
- *
52
- * On Windows, it is not yet possible to set up a named pipe server in a worker.
53
- * @see [source](https://github.com/nodejs/node/blob/v25.x/lib/cluster.js)
54
- */
55
1
  declare module "node:cluster" {
56
2
  import * as child_process from "node:child_process";
57
3
  import { EventEmitter, InternalEventEmitter } from "node:events";