@serveryyswys/node.operit 0.1.3 → 0.1.5

package/BUILTINS.json

@@ -17,11 +17,13 @@
   "builtins": {
     "path": {
       "subpath": "path",
-      "status": "ready"
+      "status": "ready",
+      "note": "与 Node 对拍通过；见 README 的对应说明。"
     },
     "path/posix": {
       "subpath": "path/posix",
-      "status": "ready"
+      "status": "ready",
+      "note": "与 Node 对拍通过；见 README 的对应说明。"
     },
     "path/win32": {
       "subpath": "path/win32",
@@ -165,27 +167,33 @@
     },
     "vm": {
       "status": "unsupported",
-      "reason": "QuickJS 运行时未暴露独立上下文创建能力。"
+      "note": "QuickJS 运行时未暴露独立上下文创建能力。",
+      "subpath": "vm"
     },
     "worker_threads": {
       "status": "unsupported",
-      "reason": "QuickJS 运行时为单线程解释器，无 worker 能力。"
+      "note": "QuickJS 运行时为单线程解释器，无 worker 能力。",
+      "subpath": "worker_threads"
     },
     "cluster": {
       "status": "unsupported",
-      "reason": "依赖 worker_threads。"
+      "note": "依赖 worker_threads。",
+      "subpath": "cluster"
     },
     "async_hooks": {
       "status": "unsupported",
-      "reason": "QuickJS 未暴露异步资源跟踪钩子。"
+      "note": "QuickJS 未暴露异步资源跟踪钩子。",
+      "subpath": "async_hooks"
     },
     "inspector": {
       "status": "unsupported",
-      "reason": "无 V8 inspector 协议。"
+      "note": "无 V8 inspector 协议。",
+      "subpath": "inspector"
     },
     "repl": {
       "status": "unsupported",
-      "reason": "无 stdin/stdout 终端语义。"
+      "note": "无 stdin/stdout 终端语义。",
+      "subpath": "repl"
     },
     "tty": {
       "subpath": "tty",

package/dist/buffer.d.ts

@@ -57,4 +57,11 @@ export declare const kMaxLength: number;
 export declare const INSPECT_MAX_BYTES = 50;
 /** 把普通 Uint8Array 变成 Buffer 实例（不改内容、不拷贝）。 */
 export declare function wrap(source: Uint8Array): Buffer;
+/**
+ * Node 的 buffer **模块**把这些直接挂在模块上（不只是挂在 Buffer 类上）。
+ * 包写 `require('buffer').SlowBuffer` 是能拿到的，所以两边都要有。
+ */
+export declare const SlowBuffer: typeof Buffer;
+/** 需要 ICU 字符集转换，运行时没有 —— 显式拒绝而不是静默返回空 Buffer。 */
+export declare function transcode(): never;
 export default Buffer;

package/dist/buffer.js

@@ -33,8 +33,10 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.INSPECT_MAX_BYTES = exports.kMaxLength = exports.constants = exports.Buffer = void 0;
+exports.SlowBuffer = exports.INSPECT_MAX_BYTES = exports.kMaxLength = exports.constants = exports.Buffer = void 0;
 exports.wrap = wrap;
+exports.transcode = transcode;
+const unsupportedNodeBuiltin = require("./unsupported");
 /**
  * Node Buffer 的移植。
  *
@@ -498,6 +500,18 @@ function checkOffset(offset, size, length) {
     }
     return offset;
 }
+/**
+ * Node 的 Buffer.SlowBuffer：历史别名，等价于 Buffer 本身。
+ * 放在可枚举化那一遍**之前**，这样它和别的静态成员一样可枚举。
+ */
+Buffer.SlowBuffer = Buffer;
+/**
+ * Node 的 Buffer.transcode 做的是 ICU 字符集转换，运行时没有 ICU。
+ * 显式抛 ONJ_UNSUPPORTED，而不是给一个静默返回空 Buffer 的实现。
+ */
+Buffer.transcode = function transcode() {
+    return unsupportedNodeBuiltin('Buffer.transcode');
+};
 /**
  * 把静态成员补成**可枚举的自有属性**。
  *
@@ -521,4 +535,13 @@ for (const staticKey of Object.getOwnPropertyNames(Buffer)) {
         });
     }
 }
+/**
+ * Node 的 buffer **模块**把这些直接挂在模块上（不只是挂在 Buffer 类上）。
+ * 包写 `require('buffer').SlowBuffer` 是能拿到的，所以两边都要有。
+ */
+exports.SlowBuffer = Buffer;
+/** 需要 ICU 字符集转换，运行时没有 —— 显式拒绝而不是静默返回空 Buffer。 */
+function transcode() {
+    return unsupportedNodeBuiltin('Buffer.transcode');
+}
 exports.default = Buffer;

package/dist/crypto.d.ts

@@ -42,6 +42,11 @@ declare function createVerify(): never;
 declare function generateKeyPairSync(): never;
 declare function createDiffieHellman(): never;
 declare const crypto: {
+    webcrypto: {
+        getRandomValues<T extends ArrayBufferView>(array: T): T;
+        randomUUID: typeof randomUUID;
+        subtle: Record<string | symbol, unknown>;
+    };
     createHash: typeof createHash;
     createHmac: typeof createHmac;
     randomBytes: typeof randomBytes;

package/dist/crypto.js

@@ -287,7 +287,31 @@ const constants = {
     SSL_OP_NO_SSLv3: 0,
     SSL_OP_NO_TLSv1: 0
 };
+/**
+ * Web Crypto 的最小可用面。
+ *
+ * getRandomValues / randomUUID 是真实现的（走同一条强随机源）；
+ * subtle 整个是"存在但每个操作都显式拒绝"—— 运行时不提供 WebCrypto 的算法实现，
+ * 给一个看起来像但结果不对的契约比明确报错更糟。
+ */
+const webcrypto = {
+    getRandomValues(array) {
+        const bytes = randomBytes(array.length);
+        array.set(bytes);
+        return array;
+    },
+    randomUUID: randomUUID,
+    subtle: new Proxy({}, {
+        get(_target, property) {
+            if (property === Symbol.toStringTag || property === 'then' || property === 'toJSON' || property === 'inspect') {
+                return undefined;
+            }
+            throw unsupported('crypto.webcrypto.subtle.' + String(property));
+        }
+    })
+};
 const crypto = {
+    webcrypto: webcrypto,
     createHash: createHash,
     createHmac: createHmac,
     randomBytes: randomBytes,

package/dist/fs.d.ts

@@ -115,6 +115,13 @@ declare function createReadStream(target: unknown, options?: ReadStreamOptions):
  */
 declare function createWriteStream(target: unknown, options?: WriteStreamOptions): WriteStreamLike;
 declare const fs: {
+    /**
+     * `require('fs').promises` —— 与 fs/promises 子路径**同一个对象**。
+     *
+     * 用惰性 getter 而不是直接 require：fs/promises 自己也 require fs，直接写会成环。
+     * getter 在对象字面量里是可枚举的，所以 for...in 探测（safer-buffer 那种）也能看到它。
+     */
+    readonly promises: unknown;
     readFileSync: typeof readFileSync;
     writeFileSync: typeof writeFileSync;
     appendFileSync: typeof appendFileSync;

package/dist/fs.js

@@ -882,6 +882,15 @@ const constants = {
     S_IXOTH: 1
 };
 const fs = {
+    /**
+     * `require('fs').promises` —— 与 fs/promises 子路径**同一个对象**。
+     *
+     * 用惰性 getter 而不是直接 require：fs/promises 自己也 require fs，直接写会成环。
+     * getter 在对象字面量里是可枚举的，所以 for...in 探测（safer-buffer 那种）也能看到它。
+     */
+    get promises() {
+        return require('./fs/promises');
+    },
     readFileSync: readFileSync,
     writeFileSync: writeFileSync,
     appendFileSync: appendFileSync,

package/dist/index.d.ts

@@ -27,6 +27,7 @@ declare const api: {
         stripVTControlCharacters: (value: string) => string;
         isDeepStrictEqual: (left: unknown, right: unknown) => boolean;
         types: {
+            isAnyArrayBuffer: (value: unknown) => boolean;
             isDate: (value: unknown) => boolean;
             isRegExp: (value: unknown) => boolean;
             isArray: (value: unknown) => boolean;
@@ -71,6 +72,7 @@ declare const api: {
         finished: (stream: unknown) => Promise<void>;
     };
     fs: {
+        readonly promises: unknown;
         readFileSync: (target: unknown, options?: unknown) => string | bufferModule.Buffer;
         writeFileSync: (target: unknown, data: unknown, options?: unknown) => void;
         appendFileSync: (target: unknown, data: unknown, options?: unknown) => void;
@@ -592,6 +594,11 @@ declare const api: {
         eventNames(): (string | symbol)[];
     };
     crypto: {
+        webcrypto: {
+            getRandomValues<T extends ArrayBufferView>(array: T): T;
+            randomUUID: () => string;
+            subtle: Record<string | symbol, unknown>;
+        };
         createHash: (algorithm: string, options?: {
             outputLength?: number;
         }) => {
@@ -664,6 +671,38 @@ declare const api: {
         };
     };
     zlib: {
+        Zlib: {
+            new (options?: import("./lib/zlib-types").DeflateOptions): unknown;
+            prototype: object;
+        };
+        Deflate: {
+            new (options?: import("./lib/zlib-types").DeflateOptions): unknown;
+            prototype: object;
+        };
+        Inflate: {
+            new (options?: import("./lib/zlib-types").DeflateOptions): unknown;
+            prototype: object;
+        };
+        DeflateRaw: {
+            new (options?: import("./lib/zlib-types").DeflateOptions): unknown;
+            prototype: object;
+        };
+        InflateRaw: {
+            new (options?: import("./lib/zlib-types").DeflateOptions): unknown;
+            prototype: object;
+        };
+        Gzip: {
+            new (options?: import("./lib/zlib-types").DeflateOptions): unknown;
+            prototype: object;
+        };
+        Gunzip: {
+            new (options?: import("./lib/zlib-types").DeflateOptions): unknown;
+            prototype: object;
+        };
+        Unzip: {
+            new (options?: import("./lib/zlib-types").DeflateOptions): unknown;
+            prototype: object;
+        };
         deflateSync: (input: unknown, options?: import("./lib/zlib-types").DeflateOptions) => bufferModule.Buffer;
         inflateSync: (input: unknown) => bufferModule.Buffer;
         deflateRawSync: (input: unknown, options?: import("./lib/zlib-types").DeflateOptions) => bufferModule.Buffer;
@@ -2693,6 +2732,7 @@ declare const api: {
         timeStamp: () => void;
     };
     'util/types': {
+        isAnyArrayBuffer: (value: unknown) => boolean;
         isDate: (value: unknown) => boolean;
         isRegExp: (value: unknown) => boolean;
         isArray: (value: unknown) => boolean;
@@ -2722,6 +2762,7 @@ declare const api: {
         stripVTControlCharacters: (value: string) => string;
         isDeepStrictEqual: (left: unknown, right: unknown) => boolean;
         types: {
+            isAnyArrayBuffer: (value: unknown) => boolean;
             isDate: (value: unknown) => boolean;
             isRegExp: (value: unknown) => boolean;
             isArray: (value: unknown) => boolean;

package/dist/index.js

@@ -51,7 +51,7 @@ const diagnosticsChannelModule = require("./diagnostics_channel");
 const streamConsumersModule = require("./stream/consumers");
 const v8Module = require("./v8");
 const api = {
-    version: '0.1.3',
+    version: '0.1.5',
     path: pathModule,
     'path/posix': pathPosixModule,
     'path/win32': pathWin32Module,

package/dist/util/types.d.ts

@@ -1,4 +1,5 @@
 declare const _default: {
+    isAnyArrayBuffer: (value: unknown) => boolean;
     isDate: (value: unknown) => boolean;
     isRegExp: (value: unknown) => boolean;
     isArray: (value: unknown) => boolean;

package/dist/util.d.ts

@@ -43,6 +43,7 @@ declare const util: {
     stripVTControlCharacters: typeof stripVTControlCharacters;
     isDeepStrictEqual: typeof isDeepStrictEqual;
     types: {
+        isAnyArrayBuffer: (value: unknown) => boolean;
         isDate: (value: unknown) => boolean;
         isRegExp: (value: unknown) => boolean;
         isArray: (value: unknown) => boolean;

package/dist/util.js

@@ -428,6 +428,10 @@ function stripVTControlCharacters(value) {
     return String(value).replace(/\u001b\[[0-9;]*m/g, '');
 }
 const types = {
+    isAnyArrayBuffer: function (value) {
+        return value instanceof ArrayBuffer ||
+            (typeof SharedArrayBuffer !== 'undefined' && value instanceof SharedArrayBuffer);
+    },
     isDate: function (value) {
         return value instanceof Date;
     },

package/dist/zlib.d.ts

@@ -18,7 +18,29 @@ declare function deflateRawAsync(input: unknown, options?: DeflateOptions | Node
 declare function inflateRawAsync(input: unknown, options?: NodeCallback, callback?: NodeCallback): void;
 declare function gzip(input: unknown, options?: DeflateOptions | NodeCallback, callback?: NodeCallback): void;
 declare function gunzip(input: unknown, options?: NodeCallback, callback?: NodeCallback): void;
+/**
+ * zlib 的**类**导出。
+ *
+ * 为什么必须有：`util.inherits(X, zlib.Zlib)` 是流式压缩库的经典写法（pngjs 等），
+ * 拿到 undefined 就会抛 "The superConstructor argument must be a function."；
+ * `new zlib.Gzip()` 也很常见。这里把它们补成可用的构造器。
+ *
+ * 实现方式是"构造器返回现成的流实例"：new 时返回 makeZlibStream 的产物，
+ * 同时给原型挂上 Transform.prototype，这样 util.inherits 与 instanceof 都成立。
+ */
+type ZlibConstructor = {
+    new (options?: DeflateOptions): unknown;
+    prototype: object;
+};
 declare const zlib: {
+    Zlib: ZlibConstructor;
+    Deflate: ZlibConstructor;
+    Inflate: ZlibConstructor;
+    DeflateRaw: ZlibConstructor;
+    InflateRaw: ZlibConstructor;
+    Gzip: ZlibConstructor;
+    Gunzip: ZlibConstructor;
+    Unzip: ZlibConstructor;
     deflateSync: typeof deflateSync;
     inflateSync: typeof inflateSync;
     deflateRawSync: typeof deflateRawSync;

package/dist/zlib.js

@@ -345,7 +345,32 @@ const constants = {
     Z_MAX_WINDOWBITS: 15,
     Z_DEFAULT_WINDOWBITS: 15
 };
+function makeZlibClass(mode, direction, label) {
+    const klass = function Zlib(options) {
+        return makeZlibStream(mode, direction, options);
+    };
+    klass.prototype = Object.create(streamModule.Transform.prototype);
+    Object.defineProperty(klass, 'name', { value: label, configurable: true });
+    return klass;
+}
+const DeflateClass = makeZlibClass('zlib', 'compress', 'Deflate');
+const InflateClass = makeZlibClass('zlib', 'decompress', 'Inflate');
+const DeflateRawClass = makeZlibClass('raw', 'compress', 'DeflateRaw');
+const InflateRawClass = makeZlibClass('raw', 'decompress', 'InflateRaw');
+const GzipClass = makeZlibClass('gzip', 'compress', 'Gzip');
+const GunzipClass = makeZlibClass('gzip', 'decompress', 'Gunzip');
+const UnzipClass = makeZlibClass('auto', 'decompress', 'Unzip');
+/** 基类：Node 里 Zlib 是所有压缩流的父类，子类继承它。这里给一个等价的 deflate 基类。 */
+const ZlibClass = makeZlibClass('zlib', 'compress', 'Zlib');
 const zlib = {
+    Zlib: ZlibClass,
+    Deflate: DeflateClass,
+    Inflate: InflateClass,
+    DeflateRaw: DeflateRawClass,
+    InflateRaw: InflateRawClass,
+    Gzip: GzipClass,
+    Gunzip: GunzipClass,
+    Unzip: UnzipClass,
     deflateSync: deflateSync,
     inflateSync: inflateSync,
     deflateRawSync: deflateRawSync,

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@serveryyswys/node.operit",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "为 Operit 的 CommonJS 运行时补齐 Node 核心能力（fs / path / os / buffer / ...）",
   "license": "Apache-2.0",
   "author": "serveryyswys",
+  "type": "commonjs",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {