@xyit-team/wellspring-gateway 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hangzhou Xiangyuan Internet Technology Co., Ltd.
+
+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/README.md

@@ -1,3 +1,39 @@
-# Temporary Holding Version
+# @xyit-team/wellspring-gateway
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Wellspring 网关插件：统一入口（单端口 / 路由 / TLS / 统一登录）。
+
+当前是占位版本：网关实现待重写。仓库此前是 `wellspring-http`（插件 HTTP 服务托管层，
+已停止维护；旧包 `@xyit-team/wellspring-http` 用 `npm deprecate` 标记）。
+
+## 安装
+
+```bash
+wellspring plugin install npm:@xyit-team/wellspring-gateway
+# 或
+wellspring plugin install github:xyit-team/wellspring-gateway
+```
+
+## 开发
+
+目录只保留包身份与发布流程所需文件：`package.json`、插件入口 `index.ts`、README、LICENSE、
+`publish-npm.yml`。CI、构建脚本与消费者 SDK 在网关实现落地后补回。
+
+## 发布
+
+首次发布手动执行（包在 npm 上存在后才能配 Trusted Publishing）：
+
+```bash
+npm login
+npm publish --access public
+```
+
+配置 Trusted Publishing（需要 2FA）：
+
+```bash
+npm trust github @xyit-team/wellspring-gateway \
+  --repo xyit-team/wellspring-gateway \
+  --file publish-npm.yml \
+  --allow-publish
+```
+
+之后的版本：改 `package.json` 的 version → 提交 → 推同名 `v*` 标签，`publish-npm.yml` 自动发布。

package/index.ts

@@ -0,0 +1,14 @@
+import type { PluginApi } from "wellspring/api/host/index.ts"
+
+export function setup() {
+    return {
+        id: "wellspring-gateway",
+        name: "Wellspring Gateway",
+        description: "统一入口网关（占位版本）",
+        version: "0.1.0",
+        status: "ok" as const,
+        init: (api: PluginApi) => {
+            api.logger.info("wellspring-gateway 占位版本")
+        },
+    }
+}

package/package.json

@@ -1,6 +1,40 @@
 {
-  "name": "@xyit-team/wellspring-gateway",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+    "name": "@xyit-team/wellspring-gateway",
+    "version": "0.1.0",
+    "description": "Wellspring 网关插件：统一入口、路由、TLS 与登录（占位版本，实现待重写）",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/xyit-team/wellspring-gateway.git"
+    },
+    "homepage": "https://github.com/xyit-team/wellspring-gateway#readme",
+    "bugs": {
+        "url": "https://github.com/xyit-team/wellspring-gateway/issues"
+    },
+    "type": "module",
+    "main": "index.ts",
+    "engines": {
+        "node": ">=24"
+    },
+    "files": [
+        "index.ts",
+        "README.md",
+        "LICENSE"
+    ],
+    "wellspring": {
+        "apiVersion": 1,
+        "name": "wellspring-gateway",
+        "npm": "@xyit-team/wellspring-gateway",
+        "github": "xyit-team/wellspring-gateway",
+        "sandbox": {
+            "profile": "plugin",
+            "fs": {
+                "read": [],
+                "write": []
+            },
+            "hostApi": [
+                "logger"
+            ]
+        }
+    }
+}