@3-/srv 0.0.1 → 0.1.10

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @3-/srv
+
+## 0.1.10
+
+### Patch Changes
+
+- 初始化 changesets 工作流

package/README.md

@@ -1,41 +1,15 @@
-[‼️]: ✏️README.mdt
-
 # @3-/srv
 
-返回值
-
-    如果函数，会被传入 res ，可以 res.writeStatus(status).end(r)
-
-    如果不是 undefined ，会被 msgpack pack
-
-post,put
-
-如果 content_type.endsWith '/json'
-
-    body 如果 length > 1
-
-    会被 json parse
-
-    如果是一个数组 会 f.apply opt, body
-
-    否则会 f.call opt, body
-
-否则如果 body 有的长度 f.call opt, body
+跨平台系统服务注册与管理入口。
 
-[test/main.coffee](./test/main.coffee) :
+本模块为门面（Facade）包。它通过识别当前的 `process.platform`，在运行时动态桥接调用底层具体的系统服务控制器模块予以实施：
 
-```coffee
-#!/usr/bin/env coffee
-```
+- **macOS**：委派至 `@3-/srv-darwin` (LaunchAgent `user` 域守护后台进程)
+- **Linux**：委派至 `@3-/srv-linux` (systemd `user` 级自启服务)
+- **Windows**：委派至 `@3-/srv-win32` (schtasks `ONLOGON` 事件监听触发器)
 
-output :
+## 特性
 
-```
-/test
-→ http://127.0.0.1:3223
-uWS.App {}
-post test
-post test
-post test
-post test
-```
+- 采用硬编码重构锁定基于不同操作系统的底层 `zx` 命令行解释器（macOS/Linux 固定映射 `bash`，Windows 固定使用原生的 `cmd.exe`），彻底阻断各个服务器环境衍生出的默认终端歧义与未知注入。
+- 保证包含绝大宽度全角字符、特殊空格、多语系中文字符的路径均能在底层完美被逃逸和吞咽执行。
+- 尽可能挖掘与降级免管理员（无 `sudo`）权限下最早启动系统常驻进程的能力，做到极度平滑的静默代码部署。

package/bun.lock

@@ -0,0 +1,30 @@
+{
+  "lockfileVersion": 1,
+  "configVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "@3-/srv",
+      "dependencies": {
+        "zx": "^8.8.5",
+      },
+      "optionalDependencies": {
+        "@3-/srv-darwin": "file:../darwin",
+        "@3-/srv-linux": "file:../linux",
+        "@3-/srv-win32": "file:../win32",
+      },
+    },
+  },
+  "packages": {
+    "@3-/srv-darwin": ["@3-/srv-darwin@file:../darwin", { "dependencies": { "@3-/srv-obj-replace": "file:../obj_replace", "zx": "^8.8.5" } }],
+
+    "@3-/srv-linux": ["@3-/srv-linux@file:../linux", { "dependencies": { "@3-/srv-obj-replace": "file:../obj_replace", "zx": "^8.8.5" } }],
+
+    "@3-/srv-win32": ["@3-/srv-win32@file:../win32", { "dependencies": { "zx": "^8.8.5" } }],
+
+    "zx": ["zx@8.8.5", "", { "bin": { "zx": "build/cli.js" } }, "sha512-SNgDF5L0gfN7FwVOdEFguY3orU5AkfFZm9B5YSHog/UDHv+lvmd82ZAsOenOkQixigwH2+yyH198AwNdKhj+RA=="],
+
+    "@3-/srv-darwin/@3-/srv-obj-replace": ["@3-/srv-obj-replace@file:../obj_replace", {}],
+
+    "@3-/srv-linux/@3-/srv-obj-replace": ["@3-/srv-obj-replace@file:../obj_replace", {}],
+  }
+}

package/install.js

@@ -0,0 +1,5 @@
+export default async (config) => {
+  const { platform } = process,
+    { default: install } = await import(`@3-/srv-${platform}/install.js`);
+  await install(config);
+};

package/package.json

@@ -1 +1,22 @@
-{"name":"@3-/srv","version":"0.0.1","repository":"https://github.com/3TiSite/node.git","homepage":"https://github.com/3TiSite/node/tree/main/srv","author":"3Ti.Site@gmail.com","license":"Apache-2.0","exports":{".":"./index.js","./*":"./*"},"files":["./*"],"type":"module","dependencies":{"@3-/msgpack":"^0.0.2","tough-cookie":"^4.1.3","uWebSockets":"^0.0.1"}}
+{
+  "name": "@3-/srv",
+  "version": "0.1.10",
+  "type": "module",
+  "exports": {
+    "./install.js": "./install.js",
+    "./uninstall.js": "./uninstall.js"
+  },
+  "optionalDependencies": {
+    "@3-/srv-darwin": "file:../darwin",
+    "@3-/srv-linux": "file:../linux",
+    "@3-/srv-win32": "file:../win32"
+  },
+  "dependencies": {
+    "zx": "^8.8.5"
+  },
+  "repository": "https://github.com/i18n-site/lib/tree/dev",
+  "homepage": "https://github.com/i18n-site/lib/tree/dev",
+  "bugs": {
+    "url": "https://github.com/i18n-site/lib/issues"
+  }
+}

package/uninstall.js

@@ -0,0 +1,5 @@
+export default async (config) => {
+  const { platform } = process,
+    { default: uninstall } = await import(`@3-/srv-${platform}/uninstall.js`);
+  await uninstall(config);
+};

package/br.js

@@ -1,37 +0,0 @@
-var brCompress;
-
-import {
-  brotliCompress
-} from 'zlib';
-
-import {
-  promisify
-} from 'util';
-
-brCompress = promisify(brotliCompress);
-
-export default async(res, status, accept_encoding, content_type, bin) => {
-  var br, content_encoding, length;
-  ({length} = bin);
-  if (bin.length > 512) {
-    if (accept_encoding != null ? accept_encoding.includes('br') : void 0) {
-      br = (await brCompress(bin));
-      if ((20 + br.length) < length) { // 因为 Content-Encoding: br 是 20 字节
-        content_encoding = 'br';
-        bin = br;
-      }
-    }
-  }
-  if (!res.aborted) {
-    res.cork(() => {
-      res.writeStatus(status);
-      if (content_type) {
-        res.writeHeader('Content-Type', content_type);
-      }
-      if (content_encoding) {
-        res.writeHeader('Content-Encoding', content_encoding);
-      }
-      res.end(br);
-    });
-  }
-};

package/index.js

@@ -1,116 +0,0 @@
-var bind;
-
-import uWebSockets from 'uWebSockets';
-
-import {
-  pack
-} from '@3-/msgpack';
-
-import br from './br.js';
-
-import {
-  Cookie
-} from 'tough-cookie';
-
-({PORT} = process.env);
-
-export var OK = '200';
-
-export var NOT_FOUND = '404';
-
-export var PORT = +PORT;
-
-bind = (ws, name, func) => {
-  console.log('/' + name);
-  ws.any('/' + name, async(res, req) => {
-    var accept_encoding, accept_language, body, content_type, cookie, err, method, opt, r, res_content_type, status, url;
-    method = req.getMethod();
-    url = req.getUrl();
-    content_type = req.getHeader('content-type');
-    accept_language = req.getHeader('accept-language');
-    cookie = req.getHeader('cookie');
-    if (cookie) {
-      cookie = Cookie.parse(cookie);
-    }
-    accept_encoding = req.getHeader('accept-encoding');
-    opt = {content_type, accept_language, method, url, cookie};
-    if (accept_encoding) {
-      opt.accept_encoding = accept_encoding.split(',').map((i) => {
-        return i.trim();
-      });
-    }
-    try {
-      switch (method) {
-        case 'post':
-        case 'put':
-          res.onAborted(() => {
-            res.aborted = true;
-          });
-          body = (await new Promise((resolve) => {
-            var li;
-            li = [];
-            res.onData((buf, isLast) => {
-              if (buf.byteLength > 0) {
-                li.push(Buffer.from(buf));
-              }
-              if (isLast) {
-                if (li.length > 0) {
-                  li = Buffer.concat(li);
-                }
-                resolve(li);
-              }
-            });
-          }));
-      }
-      if (body && body.length > 0) {
-        if (content_type.endsWith('/json')) {
-          body = JSON.parse(body);
-          if (Array.isArray(body)) {
-            r = (await func.apply(opt, body));
-          } else {
-            r = (await func.call(opt, body));
-          }
-        } else {
-          r = (await func.call(opt, body));
-        }
-      } else {
-        r = (await func.call(opt));
-      }
-      if (r instanceof Function) {
-        await r(res);
-      } else {
-        if (r === void 0) {
-          r = '';
-        } else {
-          r = pack(r);
-          res_content_type = 'm';
-        }
-      }
-      status = OK;
-    } catch (error) {
-      err = error;
-      status = '500';
-      r = '' + err;
-      console.error(method, url, err);
-    }
-    console.log(status, method, name);
-    br(res, status, accept_encoding, res_content_type, r);
-  });
-};
-
-export default (route) => {
-  var f, name, ref, ws, x;
-  ws = uWebSockets.App({});
-  ref = Object.entries(route);
-  for (x of ref) {
-    [name, f] = x;
-    bind(ws, name, f);
-  }
-  return ws.any('/*', (res, req) => {
-    console.log(NOT_FOUND, req.getMethod(), req.getUrl());
-    // https://unetworking.github.io/uWebSockets.js/generated/interfaces/HttpRequest.html#getMethod
-    res.writeStatus(NOT_FOUND).end('');
-  }).listen(PORT, () => {
-    console.log('→ http://127.0.0.1:' + PORT);
-  });
-};