ali-skills 0.0.21 → 0.0.23

package/node_modules/@ali/o2-open-client/lib/node/help.js

@@ -0,0 +1,100 @@
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = exports.extractEagleEyeTraceHeader = exports.handleResponse = exports.DEFAULT_CLIENT = exports.DEFAULT_UA = void 0;
+const os = require("os");
+const constant_1 = require("../common/constant");
+const format_1 = require("../common/format");
+exports.DEFAULT_UA = `O2 (${os.platform()}; ${os.arch()}) ` +
+    `Node.js/${process.version} Core`;
+exports.DEFAULT_CLIENT = `Node.js(${process.version}), @ali/o2-open-client`;
+function handleResponse(response, body, ctx, isEscape) {
+    const contentType = response.headers['content-type'] || '';
+    const statusCode = response.statusCode;
+    const headers = response.headers;
+    const requestId = isEscape ? 'escape' : headers && headers[constant_1.H_REQ_ID];
+    // JSON
+    if (contentType.startsWith('application/json')) {
+        // No Content
+        if (statusCode === 204) {
+            return format_1.format204(body);
+        }
+        let result;
+        let res_format;
+        try {
+            result = JSON.parse(body.toString());
+            if (typeof ctx.resultFormatCallback == 'function') {
+                res_format = ctx.resultFormatCallback(result);
+            }
+            else {
+                res_format = format_1.format(result);
+            }
+            // result = format(result);
+            res_format.requestId = requestId;
+            res_format.httpCode = statusCode;
+        }
+        catch (err) {
+            err.name = 'FormatError';
+            err.message = 'parse response to json error';
+            err.body = body;
+            throw err;
+        }
+        return res_format;
+    }
+    else if (contentType.startsWith('text/html')) {
+        let res_format = format_1.format({
+            error: 'upstream service error',
+            code: 'upstream.error'
+        });
+        res_format.requestId = requestId;
+        res_format.httpCode = statusCode;
+        return res_format;
+    }
+    else {
+        let res_format = format_1.format({
+            error: `unknown error: ${body}`,
+            code: 'unknown.error'
+        });
+        res_format.requestId = requestId;
+        res_format.httpCode = statusCode;
+        return res_format;
+    }
+}
+exports.handleResponse = handleResponse;
+// 提取请求上下文中trace header
+function extractEagleEyeTraceHeader() {
+    const H_TRACEID = 'eagleeye-traceid';
+    const H_RPCID = 'eagleeye-rpcid';
+    const defaultHeader = {
+        [H_TRACEID]: '',
+        [H_RPCID]: ''
+    };
+    try {
+        // 默认需接入@ali/db-tracer
+        const ctx = global.asyncLocalStorage && (typeof global.asyncLocalStorage.getStore === 'function') && global.asyncLocalStorage.getStore() || null;
+        if (!ctx) {
+            return defaultHeader;
+        }
+        const opts = {
+            childOf: null
+        };
+        if (ctx && ctx.tracer) {
+            opts.childOf = ctx.tracer.context;
+        }
+        const span = ctx.app.eagleeye.tracer.startSpan('http-client', opts);
+        const traceCtx = span && span.context();
+        const rpcid = traceCtx && traceCtx.rpcId || '0';
+        return {
+            [H_TRACEID]: ctx.get(H_TRACEID),
+            [H_RPCID]: rpcid
+        };
+    }
+    catch (e) {
+        return defaultHeader;
+    }
+}
+exports.extractEagleEyeTraceHeader = extractEagleEyeTraceHeader;
+exports.logger = {
+    error: (msg, err) => {
+        console.error(`[o2-open-client] ${msg}`, err);
+    }
+};

package/node_modules/@ali/o2-open-client/lib/node/index.d.ts

@@ -0,0 +1,48 @@
+import { IResponse_DTO } from '../common/format';
+export interface ITokenConfig {
+    env: 'pre' | 'prod' | 'daily';
+    token: string;
+    opts?: {
+        fromOXS: boolean;
+        [key: string]: any;
+    };
+    resultFormatCallback?: Function;
+}
+export interface IEscapeConfig {
+    /** 强制关闭逃逸能力，关闭后不再初始化 configClient，也不再拉取逃逸相关配置 */
+    disableEscape?: boolean;
+}
+export interface IAKConfig {
+    env: 'pre' | 'prod' | 'daily';
+    accessKeyId: string;
+    accessKeySecret: string;
+    opts?: {
+        fromOXS: boolean;
+        [key: string]: any;
+    };
+    resultFormatCallback?: Function;
+}
+export declare class O2Client {
+    env: string;
+    accessKeyId: string;
+    accessKeySecret: string;
+    token: string;
+    opts: any;
+    resultFormatCallback: Function;
+    private endpoint;
+    private host;
+    private keepAliveAgent;
+    private defaultQuery;
+    private configClient;
+    private serviceMeta;
+    private disableEscape;
+    constructor(config: Partial<ITokenConfig & IAKConfig & IEscapeConfig>);
+    private buildHeaders;
+    private signature;
+    private buildAuthorization;
+    private request;
+    put<T>(path: string, query: object, body: object | string, headers?: object, options?: object): Promise<IResponse_DTO<T>>;
+    post<T>(path: string, query: object, body: object | string, headers?: object, options?: object): Promise<IResponse_DTO<T>>;
+    get<T>(path: string, query?: object, headers?: object, options?: object): Promise<IResponse_DTO<T>>;
+    delete<T>(path: string, query: object, headers?: object, options?: object): Promise<IResponse_DTO<T>>;
+}

package/node_modules/@ali/o2-open-client/lib/node/index.js

@@ -0,0 +1,250 @@
+'use strict';
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.O2Client = void 0;
+const assert = require("assert");
+const url = require("url");
+const querystring = require("querystring");
+const debug = require("debug");
+const kitx = require("kitx");
+const httpx = require("httpx");
+const help_1 = require("./help");
+const constant_1 = require("../common/constant");
+const token_handler_1 = require("./token-handler");
+const escape_1 = require("./escape");
+const config_1 = require("./config");
+const nodeDeb = debug('sdk:node:index');
+function keyLowerify(headers) {
+    const keys = Object.keys(headers);
+    const newHeaders = {};
+    for (let i = 0; i < keys.length; i++) {
+        const key = keys[i];
+        newHeaders[key.toLowerCase()] = headers[key];
+    }
+    return newHeaders;
+}
+function buildStringToSign(method, uriPattern, headers) {
+    const nonce = headers['x-sdk-nonce'] || '';
+    const date = headers['Date'] || '';
+    const header = `${method}\n${nonce}\n${date}\n${uriPattern}`;
+    return header;
+}
+;
+;
+;
+class O2Client {
+    constructor(config) {
+        var _a;
+        const configName = config.accessKeyId || config.token;
+        this.disableEscape = Boolean(config.disableEscape);
+        const fromOXS = (_a = config.opts) === null || _a === void 0 ? void 0 : _a.fromOXS;
+        if (config.env == 'pre') {
+            this.env = config.env;
+            // 支持来自 OXS 区的请求
+            this.endpoint = fromOXS ? 'https://pre-oapi-o2.aliyun-inc.com' : 'https://pre-oapi.o2.alibaba-inc.com';
+            if (!this.disableEscape) {
+                this.configClient = new config_1.ConfigClient({
+                    name: configName,
+                    endpoint: fromOXS ? 'https://open-o2.aliyun-inc.com' : 'https://pre-open.o2.alibaba-inc.com'
+                });
+            }
+        }
+        else if (config.env == 'daily') {
+            this.env = config.env;
+            this.endpoint = 'https://oapi-def.taobao.net';
+            if (!this.disableEscape) {
+                this.configClient = new config_1.ConfigClient({
+                    name: configName,
+                });
+            }
+        }
+        else {
+            this.env = 'prod';
+            this.endpoint = fromOXS ? 'https://oapi-o2.aliyun-inc.com' : 'https://oapi.o2.alibaba-inc.com';
+            if (!this.disableEscape) {
+                this.configClient = new config_1.ConfigClient({
+                    name: configName,
+                    endpoint: fromOXS ? 'https://open-o2.aliyun-inc.com' : 'https://open.o2.alibaba-inc.com'
+                });
+            }
+        }
+        if (config.accessKeyId && config.accessKeySecret) {
+            this.accessKeyId = config.accessKeyId;
+            this.accessKeySecret = config.accessKeySecret;
+        }
+        else if (config.token) {
+            this.token = config.token;
+        }
+        else {
+            assert(null, 'must pass "config.accessKeyId and config.accessKeyId or config.token"');
+        }
+        this.opts = config.opts || {
+            timeout: 10000 // 默认超时10s
+        };
+        this.resultFormatCallback = config.resultFormatCallback;
+        this.host = url.parse(this.endpoint).hostname;
+        this.defaultQuery = {
+            Format: 'json',
+        };
+        const httpModule = this.endpoint.startsWith('https://') ? require('https') : require('http');
+        this.keepAliveAgent = new httpModule.Agent({
+            keepAlive: true,
+            keepAliveMsecs: 5000,
+            // 日常域名的证书不被系统信任
+            rejectUnauthorized: false
+        });
+        if (!this.disableEscape) {
+            this.configClient.getServiceMeta().then((meta) => {
+                this.serviceMeta = meta;
+            }).catch((e) => {
+                help_1.logger.error('getServiceMeta error', e);
+            });
+        }
+    }
+    buildHeaders() {
+        const now = new Date();
+        const defaultHeaders = {
+            accept: 'application/json',
+            Date: now.toGMTString(),
+            host: this.host,
+            'user-agent': help_1.DEFAULT_UA,
+            'x-sdk-client': help_1.DEFAULT_CLIENT,
+            'x-sdk-nonce': kitx.makeNonce(),
+            'content-type': 'application/json'
+        };
+        return defaultHeaders;
+    }
+    signature(stringToSign) {
+        const utf8Buff = Buffer.from(stringToSign, 'utf8');
+        return kitx.sha1(utf8Buff, this.accessKeySecret, 'base64');
+    }
+    buildAuthorization(stringToSign) {
+        return encodeURIComponent(`${this.accessKeyId}:${this.signature(stringToSign)}`);
+    }
+    request(method, uriPattern, query = {}, body = '', headers = {}, opts = {}) {
+        return __awaiter(this, void 0, void 0, function* () {
+            query = Object.assign({}, this.defaultQuery, query);
+            const traceHeader = help_1.extractEagleEyeTraceHeader();
+            let mixHeaders = Object.assign({}, this.buildHeaders(), keyLowerify(headers), traceHeader);
+            if (typeof body == 'object') {
+                body = JSON.stringify(body);
+            }
+            const postBody = Buffer.from(body, 'utf8');
+            mixHeaders['content-length'] = postBody.length;
+            // 必须是application/json
+            // mixHeaders['content-type'] = 'application/json';
+            mixHeaders['x-sdk-path'] = uriPattern;
+            mixHeaders['x-sdk-method'] = method.toUpperCase();
+            // header中有ticket而query中没有ticket，热切换时需保障query中存在ticket，在业务服务侧验证身份
+            if (mixHeaders['sso_ticket'] && !query['SSO_TICKET']) {
+                query['SSO_TICKET'] = mixHeaders['sso_ticket'];
+            }
+            // 开放接口，走ak认证鉴权
+            if (!query['SSO_TICKET'] && !mixHeaders['sso_ticket']) {
+                mixHeaders[constant_1.OPEN_API] = 'true';
+            }
+            // client_token认证
+            if (this.token) {
+                mixHeaders[constant_1.CLIENT_TOKEN] = this.token;
+                token_handler_1.processToken(this.token, uriPattern, mixHeaders, query);
+            }
+            else {
+                // AK认证
+                query.AccessKeyId = encodeURIComponent(this.accessKeyId);
+                const stringToSign = buildStringToSign(method, uriPattern, mixHeaders);
+                mixHeaders['x-sdk-authorization'] = this.buildAuthorization(stringToSign);
+            }
+            let url = `${this.endpoint}${uriPattern}`;
+            if (Object.keys(query).length) {
+                url += `?${querystring.stringify(query)}`;
+            }
+            const options = Object.assign({
+                method,
+                agent: this.keepAliveAgent,
+                headers: mixHeaders,
+                data: postBody
+            }, this.opts, opts);
+            let rawData = null;
+            let result = null;
+            // 热切换判断
+            const switchCheck = this.disableEscape ? false : yield escape_1.hotSwitchCheck(this.configClient);
+            // 非热切换的正常场景
+            if (!switchCheck) {
+                result = yield httpx.request(url, options).then((response) => {
+                    return httpx.read(response, 'utf8').then((body) => {
+                        rawData = body;
+                        // Return raw body
+                        if (opts.rawBody) {
+                            return body;
+                        }
+                        return help_1.handleResponse(response, body, this);
+                    });
+                }).catch((e) => {
+                    help_1.logger.error('request error', e);
+                });
+                // 请求被catch时，result为空
+                if (result) {
+                    result.rawData = rawData;
+                }
+                nodeDeb('origin result', result, rawData);
+            }
+            // 热切换或者满足逃逸特殊条件的逃逸
+            const escapeReason = {
+                code: escape_1.ESCAPE_ERR_CODE.HOT_SWITCH
+            };
+            if (switchCheck || (!this.disableEscape && escape_1.maybeEscape(result, rawData, escapeReason))) {
+                const preResult = escape_1.preEscapeWork(this.serviceMeta, this.env, uriPattern, escapeReason);
+                // 不满足逃逸前提，返回原错误
+                if (preResult && preResult.resultNo == 1) {
+                    return result;
+                }
+                nodeDeb(`启动逃逸...`);
+                // host头会替换url的host
+                delete mixHeaders.host;
+                const escapeOptions = Object.assign({}, {
+                    method,
+                    agent: this.keepAliveAgent,
+                    headers: Object.assign({}, mixHeaders, keyLowerify(headers), {
+                        [constant_1.H_CREADENTIAL]: this.accessKeyId || this.token,
+                        [constant_1.H_POP_VER]: preResult.data.popVer,
+                        // 逃逸流量标识，authPlugin认证需要
+                        [constant_1.H_ESCAPE_STATE]: 'true',
+                        // 兼容
+                        'is-open': query['SSO_TICKET'] ? '' : 'true',
+                        'pop-open-sess': this.accessKeyId || this.token,
+                        'content-type': 'application/json',
+                    }),
+                    data: postBody
+                }, this.opts, opts);
+                let escapeUrl = `${preResult.data.uri}`;
+                if (Object.keys(query).length) {
+                    escapeUrl += `?${querystring.stringify(query)}`;
+                }
+                const escapeResult = yield escape_1.doExc.bind(this, this.env, escapeUrl, escapeOptions)();
+                return escapeResult;
+            }
+            return result;
+        });
+    }
+    put(path, query, body, headers, options) {
+        return this.request('PUT', path, query, body, headers || {}, options);
+    }
+    post(path, query, body, headers, options) {
+        return this.request('POST', path, query, body, headers || {}, options);
+    }
+    get(path, query, headers, options) {
+        return this.request('GET', path, query, '', headers || {}, options);
+    }
+    delete(path, query, headers, options) {
+        return this.request('DELETE', path, query, '', headers || {}, options);
+    }
+}
+exports.O2Client = O2Client;

package/node_modules/@ali/o2-open-client/lib/node/token-handler.d.ts

@@ -0,0 +1 @@
+export declare function processToken(token: any, path: any, header: any, query: any): void;

package/node_modules/@ali/o2-open-client/lib/node/token-handler.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.processToken = void 0;
+const constant_1 = require("../common/constant");
+function processToken(token, path, header, query) {
+    let ms = path && path.match(constant_1.ESCAPE_REG);
+    let appName = ms && ms.length && ms[2];
+    if (!appName) {
+        ms = path && path.match(constant_1.ESCAPE_NONSTANDARD_REG);
+        appName = ms && ms.length && ms[1];
+        if (!appName) {
+            return;
+        }
+    }
+    const item = constant_1.TOKEN_MAP[appName];
+    if (item) {
+        if (item.type == 'header') {
+            header[item.name] = token;
+        }
+        else if (item.type == 'query') {
+            query[item.name] = token;
+        }
+    }
+}
+exports.processToken = processToken;

package/node_modules/@ali/o2-open-client/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@ali/o2-open-client",
+  "version": "0.2.0",
+  "description": "O2开放平台SDK",
+  "main": "./lib/index.js",
+  "scripts": {
+    "build": "tsc && tsc -p tsconfig.es.json",
+    "build:b": "browserify devs/b.js > devs/b.bundle.js",
+    "clean": "rm -rf ./node_modules build",
+    "pretest": "tsc",
+    "test": "playwright test"
+  },
+  "keywords": [
+    "def-gw",
+    "sdk"
+  ],
+  "author": "yuxiu",
+  "publishConfig": {
+    "registry": "https://registry.anpm.alibaba-inc.com"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.32.0",
+    "@types/node": "^16.9.1",
+    "browserify": "^17.0.0",
+    "mini-types": "^0.1.4",
+    "playwright": "^1.32.0",
+    "should": "^13.2.3",
+    "ts-node": "^10.3.0",
+    "typescript": "^3.9.7"
+  },
+  "husky": {
+    "hooks": {
+      "pre-commit": "npm run lint"
+    }
+  },
+  "dependencies": {
+    "cluster-client": "^3.4.0",
+    "debug": "^4.3.3",
+    "heartbeats": "^5.0.1",
+    "httpx": "^2.2.7",
+    "ip": "^1.1.5",
+    "kitx": "^2.1.0",
+    "sdk-base": "^4.2.1"
+  },
+  "repository": "git@gitlab.alibaba-inc.com:def-open/o2-open-sdk.git"
+}

package/node_modules/@ali/o2-open-client/playwright.config.ts

@@ -0,0 +1,54 @@
+import type { PlaywrightTestConfig } from '@playwright/test';
+import { devices } from '@playwright/test';
+
+/**
+ * See https://playwright.dev/docs/test-configuration.
+ */
+const config: PlaywrightTestConfig = {
+  // testIgnore: '*node.spec.ts',
+  testDir: './test',
+  /* Maximum time one test can run for. */
+  timeout: 30 * 1000,
+  expect: {
+    /**
+     * Maximum time expect() should wait for the condition to be met.
+     * For example in `await expect(locator).toHaveText();`
+     */
+    timeout: 5000,
+  },
+  /* Run tests in files in parallel */
+  fullyParallel: true,
+  /* Fail the build on CI if you accidentally left test.only in the source code. */
+  // forbidOnly: !!process.env.CI,
+  // /* Retry on CI only */
+  // retries: process.env.CI ? 2 : 0,
+  // /* Opt out of parallel tests on CI. */
+  // workers: process.env.CI ? 1 : undefined,
+  /* Reporter to use. See https://playwright.dev/docs/test-reporters */
+  reporter: [
+    ['html', { open: 'never' }],
+  ],
+  /* Shared settings for all the projects below. See https://playwright.dev/docs/api/class-testoptions. */
+  use: {
+    /* Maximum time each action such as `click()` can take. Defaults to 0 (no limit). */
+    actionTimeout: 30000,
+    /* Base URL to use in actions like `await page.goto('/')`. */
+    // baseURL: 'http://localhost:3000',
+
+    /* Collect trace when retrying the failed test. See https://playwright.dev/docs/trace-viewer */
+    trace: 'on',
+    // video: 'on',
+  },
+
+  /* Configure projects for major browsers */
+  projects: [
+    {
+      name: 'chromium',
+      use: {
+        ...devices['Desktop Chrome'],
+      },
+    },
+  ],
+};
+
+export default config;

package/node_modules/@ali/o2-open-client/tsconfig.es.json

@@ -0,0 +1,31 @@
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "outDir": "./es/",
+    "declaration": true,
+    "module": "ES6",
+    "target": "es2015",
+    "jsx": "preserve",
+    "jsxFactory": "createElement",
+    "moduleResolution": "node",
+    "alwaysStrict": true,
+    "sourceMap": false,
+    "allowSyntheticDefaultImports": true,
+    "suppressImplicitAnyIndexErrors": true,
+    "removeComments": false,
+    "preserveConstEnums": true,
+    "experimentalDecorators": true,
+    "noImplicitReturns": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": false,
+    "noImplicitAny": false,
+    "noImplicitThis": false,
+    // "resolveJsonModule": true,
+    "paths": {
+      "src": ["./src"],
+    },
+    "types": ["node", "./typings"]
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "lib"]
+}

package/node_modules/@ali/o2-open-client/tsconfig.json

@@ -0,0 +1,31 @@
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "outDir": "./lib/",
+    "declaration": true,
+    "module": "commonjs",
+    "target": "es2015",
+    "jsx": "preserve",
+    "jsxFactory": "createElement",
+    "moduleResolution": "node",
+    "alwaysStrict": true,
+    "sourceMap": false,
+    "allowSyntheticDefaultImports": true,
+    "suppressImplicitAnyIndexErrors": true,
+    "removeComments": false,
+    "preserveConstEnums": true,
+    "experimentalDecorators": true,
+    "noImplicitReturns": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": false,
+    "noImplicitAny": false,
+    "noImplicitThis": false,
+    // "resolveJsonModule": true,
+    "paths": {
+      "src": ["./src"],
+    },
+    "types": ["node", "./typings"]
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "lib", "src/browser/index.ts"]
+}

package/node_modules/@ali/o2-open-client/tsx2doc.config.js

@@ -0,0 +1,5 @@
+module.exports = {
+  file: "./src/index.ts",
+  output: process.cwd(),
+  outputName: 'README',
+}

package/node_modules/@ali/o2-open-client/typings/index.d.ts

@@ -0,0 +1,36 @@
+declare namespace O2Open {
+  type Options = {
+    version?: string,
+    timeout?: number
+    // ignoreBucAuth?: boolean
+  };
+
+  type RequestParams = {
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'HEAD',
+    path: string,
+    data?: object,
+    headers?: object,
+    opts?: Options,
+    body?: any,
+    query?: any
+  };
+
+  interface IO2ClientConfig {
+    env?: string;
+    timeout?: number;
+    resultFormatCallback?: Function;
+    opts?: {
+      fromOXS: boolean;
+      [key: string]: any;
+    };
+  }
+
+  interface O2ClientParams {
+    // ticket: string;
+    env?: string;
+    version?: string;
+    endpoint?: string;
+    timeout?: number;
+    resultFormatCallback?: Function;
+  }
+}

package/node_modules/@types/node/LICENSE

@@ -0,0 +1,21 @@
+    MIT License
+
+    Copyright (c) Microsoft Corporation.
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in all
+    copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+    SOFTWARE

package/node_modules/@types/node/README.md

@@ -0,0 +1,15 @@
+# Installation
+> `npm install --save @types/node`
+
+# Summary
+This package contains type definitions for node (https://nodejs.org/).
+
+# Details
+Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node/v20.
+
+### Additional Details
+ * Last updated: Fri, 03 Apr 2026 11:14:41 GMT
+ * Dependencies: [undici-types](https://npmjs.com/package/undici-types)
+
+# Credits
+These definitions were written by [Microsoft TypeScript](https://github.com/Microsoft), [Alberto Schiabel](https://github.com/jkomyno), [Andrew Makarov](https://github.com/r3nya), [Benjamin Toueg](https://github.com/btoueg), [David Junger](https://github.com/touffy), [Mohsen Azimi](https://github.com/mohsen1), [Nikita Galkin](https://github.com/galkin), [Sebastian Silbermann](https://github.com/eps1lon), [Wilco Bakker](https://github.com/WilcoBakker), [Marcin Kopacz](https://github.com/chyzwar), [Trivikram Kamat](https://github.com/trivikr), [Junxiao Shi](https://github.com/yoursunny), [Ilia Baryshnikov](https://github.com/qwelias), [ExE Boss](https://github.com/ExE-Boss), [Piotr Błażejewicz](https://github.com/peterblazejewicz), [Anna Henningsen](https://github.com/addaleax), [Victor Perin](https://github.com/victorperin), [NodeJS Contributors](https://github.com/NodeJS), [Linus Unnebäck](https://github.com/LinusU), [wafuwafu13](https://github.com/wafuwafu13), [Matteo Collina](https://github.com/mcollina), and [Dmitry Semigradsky](https://github.com/Semigradsky).