@serveryyswys/node.operit 0.0.0-stage → 0.1.2

package/dist/lib/zlib-types.d.ts

@@ -0,0 +1,12 @@
+/**
+ * zlib 的公开类型。
+ *
+ * 独立成文件的原因与 path-types 相同：zlib.ts 用 `export =` 导出模块本体，
+ * 无法再导出类型，而 index.ts 聚合时需要这些名字是"可命名"的。
+ */
+export interface DeflateOptions {
+    /** 0 = 不压缩（stored）；1..9 越大越慢，未实现动态 Huffman，压缩率低于 zlib。 */
+    level?: number;
+    /** 仅用于与 Node 的签名兼容；本实现总是按 32K 窗口处理。 */
+    windowBits?: number;
+}

package/dist/lib/zlib-types.js

@@ -0,0 +1,2 @@
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/module.d.ts

@@ -0,0 +1,8 @@
+declare function isBuiltin(name: unknown): boolean;
+declare function createRequire(): never;
+declare const api: {
+    builtinModules: string[];
+    isBuiltin: typeof isBuiltin;
+    createRequire: typeof createRequire;
+};
+export = api;

package/dist/module.js

@@ -0,0 +1,72 @@
+'use strict';
+/**
+ * module 模块（只取在 Operit 里说得通的部分）。
+ *
+ * 提供：
+ *   - builtinModules：**与 BUILTINS.json 的键逐字一致**（包含尚未实现的那些，
+ *     因为 isBuiltin 回答的是"这是不是一个 Node 内建名"，不是"我们实现了没有"）。
+ *     测试里会断言两者同步，防止改契约表时漏改这里；
+ *   - isBuiltin()：认 'node:' 前缀；
+ *   - createRequire()：显式抛 ONJ_UNSUPPORTED。
+ *
+ * createRequire 为什么不做：它依赖 node_modules 逐级查找与 main/exports 解析，
+ * 而 Operit 的 require 两样都没有（见 BUILTINS.json 的 packing 段）。
+ * 与其给一个"看起来像但解析不出东西"的 require，不如明确拒绝。
+ *
+ * Module 类、_resolveFilename 等内部接口不提供。
+ */
+const errors_1 = require("./lib/errors");
+const builtinModules = [
+    'assert',
+    'assert/strict',
+    'async_hooks',
+    'buffer',
+    'child_process',
+    'cluster',
+    'constants',
+    'crypto',
+    'dns',
+    'events',
+    'fs',
+    'fs/promises',
+    'http',
+    'https',
+    'inspector',
+    'module',
+    'net',
+    'os',
+    'path',
+    'path/posix',
+    'path/win32',
+    'perf_hooks',
+    'process',
+    'querystring',
+    'readline',
+    'repl',
+    'stream',
+    'stream/promises',
+    'string_decoder',
+    'timers',
+    'timers/promises',
+    'tty',
+    'url',
+    'util',
+    'vm',
+    'worker_threads',
+    'zlib'
+];
+function isBuiltin(name) {
+    const text = String(name);
+    const bare = text.indexOf('node:') === 0 ? text.slice(5) : text;
+    return builtinModules.indexOf(bare) >= 0;
+}
+function createRequire() {
+    throw (0, errors_1.onjError)('ONJ_UNSUPPORTED', 'module.createRequire() 依赖 node_modules 逐级查找与 main/exports 解析，Operit 的 require 两者都没有；' +
+        '打包期由 OperitPackageManager 把裸名重写成相对路径。');
+}
+const api = {
+    builtinModules: builtinModules,
+    isBuiltin: isBuiltin,
+    createRequire: createRequire
+};
+module.exports = api;

package/dist/os.d.ts

@@ -0,0 +1,80 @@
+export interface CpuInfo {
+    model: string;
+    speed: number;
+    times: {
+        user: number;
+        nice: number;
+        sys: number;
+        idle: number;
+        irq: number;
+    };
+}
+export interface NetworkInterfaceInfo {
+    address: string;
+    family: string;
+    internal: boolean;
+}
+export declare const EOL = "\n";
+export declare function platform(): string;
+export declare function arch(): string;
+export declare function machine(): string;
+export declare function type(): string;
+export declare function release(): string;
+export declare function version(): string;
+export declare function endianness(): string;
+export declare function hostname(): string;
+export declare function tmpdir(): string;
+/** Android 没有用户 home；按已安装包都可见的公共目录取 /sdcard。 */
+export declare function homedir(): string;
+export declare function availableParallelism(): number;
+export declare function cpus(): CpuInfo[];
+/** JVM 堆上限，不是物理内存总量。 */
+export declare function totalmem(): number;
+/** JVM 堆空闲量，不是系统可用内存。 */
+export declare function freemem(): number;
+export declare function loadavg(): number[];
+export declare function uptime(): number;
+export interface UserInfo {
+    uid: number;
+    gid: number;
+    username: string;
+    homedir: string;
+    shell: string;
+}
+export declare function userInfo(): UserInfo;
+/** 通过 NetworkInterface 的 Enumeration 逐个展开；Java 侧没有直接可用的集合视图。 */
+export declare function networkInterfaces(): Record<string, NetworkInterfaceInfo[]>;
+/** Node 的 os.devNull 是字符串属性，不是函数。 */
+export declare const devNull = "/dev/null";
+/** 进程优先级在 Android 上由调度器策略决定，Node 的 niceness 语义不成立。 */
+export declare function getPriority(): number;
+export declare function setPriority(): void;
+export declare const constants: {
+    signals: {
+        SIGHUP: number;
+        SIGINT: number;
+        SIGQUIT: number;
+        SIGILL: number;
+        SIGTRAP: number;
+        SIGABRT: number;
+        SIGBUS: number;
+        SIGFPE: number;
+        SIGKILL: number;
+        SIGUSR1: number;
+        SIGSEGV: number;
+        SIGUSR2: number;
+        SIGPIPE: number;
+        SIGALRM: number;
+        SIGTERM: number;
+        SIGWINCH: number;
+    };
+    errno: Record<string, number>;
+    priority: {
+        PRIORITY_LOW: number;
+        PRIORITY_BELOW_NORMAL: number;
+        PRIORITY_NORMAL: number;
+        PRIORITY_ABOVE_NORMAL: number;
+        PRIORITY_HIGH: number;
+        PRIORITY_HIGHEST: number;
+    };
+};

package/dist/os.js

@@ -0,0 +1,247 @@
+'use strict';
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.constants = exports.devNull = exports.EOL = void 0;
+exports.platform = platform;
+exports.arch = arch;
+exports.machine = machine;
+exports.type = type;
+exports.release = release;
+exports.version = version;
+exports.endianness = endianness;
+exports.hostname = hostname;
+exports.tmpdir = tmpdir;
+exports.homedir = homedir;
+exports.availableParallelism = availableParallelism;
+exports.cpus = cpus;
+exports.totalmem = totalmem;
+exports.freemem = freemem;
+exports.loadavg = loadavg;
+exports.uptime = uptime;
+exports.userInfo = userInfo;
+exports.networkInterfaces = networkInterfaces;
+exports.getPriority = getPriority;
+exports.setPriority = setPriority;
+/**
+ * Node os 模块的移植。
+ *
+ * 取值全部来自 Android / Java 侧，因此与桌面 Node 的数值必然不同；
+ * 这里保证的是**形状与语义**（类型、单位、字段名）与 Node 一致，
+ * 以及每个近似值都在 README / BUILTINS.json 里写清楚。
+ *
+ * 已知近似：
+ *   - totalmem / freemem 取的是 JVM 堆上限与空闲量，不是物理内存
+ *   - cpus() 的 model 是 os.arch，speed 为 0，times 全 0
+ *   - homedir() 返回 /sdcard（Android 没有用户 home 概念）
+ *   - loadavg() 恒为 [0,0,0]
+ */
+const bridge = __importStar(require("./lib/bridge"));
+const paths = __importStar(require("./lib/paths"));
+const errors_1 = require("./lib/errors");
+function runtime() {
+    return bridge.callStatic('java.lang.Runtime', 'getRuntime', []);
+}
+function readProperty(name) {
+    const value = bridge.callStatic('java.lang.System', 'getProperty', [name]);
+    return typeof value === 'string' ? value : '';
+}
+/** Node 的 arch 命名与 Java 的 os.arch 不同，这里显式映射。 */
+function mapArch(javaArch) {
+    switch (javaArch) {
+        case 'aarch64':
+        case 'arm64':
+            return 'arm64';
+        case 'x86_64':
+        case 'amd64':
+            return 'x64';
+        case 'i386':
+        case 'i686':
+        case 'x86':
+            return 'ia32';
+        case 'arm':
+            return 'arm';
+        default:
+            return javaArch;
+    }
+}
+exports.EOL = '\n';
+function platform() {
+    return 'android';
+}
+function arch() {
+    return mapArch(readProperty('os.arch'));
+}
+function machine() {
+    return arch();
+}
+function type() {
+    return 'Linux';
+}
+function release() {
+    const value = bridge.getStaticField('android.os.Build$VERSION', 'RELEASE');
+    return typeof value === 'string' ? value : '';
+}
+function version() {
+    return readProperty('os.version');
+}
+function endianness() {
+    return 'LE';
+}
+function hostname() {
+    const local = bridge.callStatic('java.net.InetAddress', 'getLocalHost', []);
+    const name = bridge.callInstance(local, 'getHostName', []);
+    return typeof name === 'string' ? name : '';
+}
+function tmpdir() {
+    return paths.cacheDir();
+}
+/** Android 没有用户 home；按已安装包都可见的公共目录取 /sdcard。 */
+function homedir() {
+    return '/sdcard';
+}
+function availableParallelism() {
+    const value = bridge.callInstance(runtime(), 'availableProcessors', []);
+    const count = Number(value);
+    return isFinite(count) && count > 0 ? count : 1;
+}
+function cpus() {
+    const count = availableParallelism();
+    const model = readProperty('os.arch');
+    const out = [];
+    for (let i = 0; i < count; i += 1) {
+        out.push({
+            model: model,
+            speed: 0,
+            times: { user: 0, nice: 0, sys: 0, idle: 0, irq: 0 }
+        });
+    }
+    return out;
+}
+/** JVM 堆上限，不是物理内存总量。 */
+function totalmem() {
+    return Number(bridge.callInstance(runtime(), 'maxMemory', [])) || 0;
+}
+/** JVM 堆空闲量，不是系统可用内存。 */
+function freemem() {
+    return Number(bridge.callInstance(runtime(), 'freeMemory', [])) || 0;
+}
+function loadavg() {
+    return [0, 0, 0];
+}
+function uptime() {
+    const elapsed = Number(bridge.callStatic('android.os.SystemClock', 'elapsedRealtime', [])) || 0;
+    return Math.floor(elapsed / 1000);
+}
+function userInfo() {
+    return {
+        uid: -1,
+        gid: -1,
+        username: readProperty('user.name'),
+        homedir: homedir(),
+        shell: '/system/sh'
+    };
+}
+/** 通过 NetworkInterface 的 Enumeration 逐个展开；Java 侧没有直接可用的集合视图。 */
+function networkInterfaces() {
+    const out = {};
+    const interfaces = bridge.callStatic('java.net.NetworkInterface', 'getNetworkInterfaces', []);
+    if (interfaces === null || typeof interfaces !== 'object') {
+        return out;
+    }
+    while (bridge.normalizeBoolean(bridge.callInstance(interfaces, 'hasMoreElements', []))) {
+        const current = bridge.callInstance(interfaces, 'nextElement', []);
+        const name = String(bridge.callInstance(current, 'getName', []));
+        const addresses = [];
+        const enumeration = bridge.callInstance(current, 'getInetAddresses', []);
+        while (bridge.normalizeBoolean(bridge.callInstance(enumeration, 'hasMoreElements', []))) {
+            const address = bridge.callInstance(enumeration, 'nextElement', []);
+            const text = String(bridge.callInstance(address, 'getHostAddress', []));
+            addresses.push({
+                address: text,
+                family: text.indexOf(':') >= 0 ? 'IPv6' : 'IPv4',
+                internal: bridge.normalizeBoolean(bridge.callInstance(address, 'isLoopbackAddress', []))
+            });
+        }
+        out[name] = addresses;
+    }
+    return out;
+}
+/** Node 的 os.devNull 是字符串属性，不是函数。 */
+exports.devNull = '/dev/null';
+/** 进程优先级在 Android 上由调度器策略决定，Node 的 niceness 语义不成立。 */
+function getPriority() {
+    throw (0, errors_1.onjError)('ONJ_UNSUPPORTED', 'os.getPriority() 依赖 POSIX niceness，Android 上不成立。');
+}
+function setPriority() {
+    throw (0, errors_1.onjError)('ONJ_UNSUPPORTED', 'os.setPriority() 依赖 POSIX niceness，Android 上不成立。');
+}
+function buildPositiveErrno() {
+    const out = {};
+    const names = Object.keys(errors_1.ERRNO);
+    for (let i = 0; i < names.length; i += 1) {
+        out[names[i]] = Math.abs(errors_1.ERRNO[names[i]]);
+    }
+    return out;
+}
+exports.constants = {
+    signals: {
+        SIGHUP: 1,
+        SIGINT: 2,
+        SIGQUIT: 3,
+        SIGILL: 4,
+        SIGTRAP: 5,
+        SIGABRT: 6,
+        SIGBUS: 7,
+        SIGFPE: 8,
+        SIGKILL: 9,
+        SIGUSR1: 10,
+        SIGSEGV: 11,
+        SIGUSR2: 12,
+        SIGPIPE: 13,
+        SIGALRM: 14,
+        SIGTERM: 15,
+        SIGWINCH: 28
+    },
+    // Node 的 os.constants.errno 是正的，而 lib/errors 的 ERRNO 取负（对应 error.errno）
+    errno: buildPositiveErrno(),
+    priority: {
+        PRIORITY_LOW: 19,
+        PRIORITY_BELOW_NORMAL: 10,
+        PRIORITY_NORMAL: 0,
+        PRIORITY_ABOVE_NORMAL: -7,
+        PRIORITY_HIGH: -14,
+        PRIORITY_HIGHEST: -20
+    }
+};

package/dist/path/posix.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("../lib/path-types").PathModule;
+export = _default;

package/dist/path/posix.js

@@ -0,0 +1,7 @@
+'use strict';
+/**
+ * `path/posix` 子路径入口（Node 亦提供 `require('path/posix')`）。
+ * 这里只是把 path.ts 里的 posix 那一份单独暴露出来。
+ */
+const pathModule = require("../path");
+module.exports = pathModule.posix;

package/dist/path/win32.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("../lib/path-types").PathModule;
+export = _default;

package/dist/path/win32.js

@@ -0,0 +1,10 @@
+'use strict';
+/**
+ * `path/win32` 子路径入口（Node 亦提供 `require('path/win32')`）。
+ *
+ * 注意：BUILTINS.json 把本模块标为 partial —— 冒号歧义与 UNC 根这两类边缘
+ * 与 Node 存在已知偏差，详见 README「已知偏差」。Operit 平台是 android/linux，
+ * 该模块主要服务于解析 Windows 路径的三方库（如打包/归档类）。
+ */
+const pathModule = require("../path");
+module.exports = pathModule.win32;

package/dist/path.d.ts

@@ -0,0 +1,3 @@
+import type { PathModule } from './lib/path-types';
+declare const posix: PathModule;
+export = posix;