@volcengine/tls-observer-opencode-install 0.0.3

package/CHANGELOG.md

@@ -0,0 +1,19 @@
+# @volcengine/tls-observer-opencode-install
+
+## 0.0.3
+
+### Patch Changes
+
+- 公网发包
+
+## 0.0.2
+
+### Patch Changes
+
+- 安装包更新
+
+## 0.0.1
+
+### Patch Changes
+
+- TLS 可观测

package/LICENCE

@@ -0,0 +1,13 @@
+# Copyright 2023 Beijing Volcano Engine Technology Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.

package/README.md

@@ -0,0 +1,64 @@
+# TLS Observer OpenCode Installer
+
+一键安装 `@volcengine/tls-observer-opencode` 到 OpenCode 全局插件目录。
+
+## 安装
+
+```bash
+npm exec -y \
+  --package=@volcengine/tls-observer-opencode-install -- \
+  tls-observer-opencode-install
+```
+
+安装器默认从 registry 下载插件 `@latest`。使用 beta：
+
+```bash
+npm exec -y \
+  --package=@volcengine/tls-observer-opencode-install -- \
+  tls-observer-opencode-install --beta
+```
+
+`--plugin-version <version>` 可以指定精确版本或 dist-tag，并覆盖 `--beta`。
+
+## 安装结果
+
+- 插件入口：`~/.config/opencode/plugins/tls-observer-opencode.js`
+- 插件运行时：`~/.config/opencode/plugins/tls-observer-opencode`
+- TLS env：`~/.config/opencode/tls-observer-opencode.env`
+- 运行数据：`~/.config/opencode/plugins/data/tls-observer-opencode`
+
+OpenCode 会自动加载 `~/.config/opencode/plugins/` 下的本地插件文件。安装器不会修改
+`~/.config/opencode/config.json`，也不会写入 `OPENCODE_TLS_ENV_FILE`；运行时默认读取
+`~/.config/opencode/tls-observer-opencode.env`。
+
+如果旧版本安装器曾在 `~/.config/opencode/config.json` 中写入非法的 `plugins` / `env`
+键，新安装器会在安装时移除这两个键，保留其他配置。
+
+## 非交互安装
+
+```bash
+npm exec -y \
+  --package=@volcengine/tls-observer-opencode-install -- \
+  tls-observer-opencode-install \
+  --non-interactive \
+  --force \
+  --trace-topic-id <trace-topic-id> \
+  --api-key <api-key>
+```
+
+TLS Region 默认是 `cn-beijing`，TLS Producer endpoint 会自动生成为 `tls-cn-beijing.volces.com`。如需切换 Region，使用 `--region <region>`；如需单独覆盖 endpoint，使用 `--tls-endpoint <host>`。旧的 `--otel-endpoint` 仅保留兼容。
+
+AK/SK 模式将 `--api-key` 替换为 `--ak`、`--sk`，并可提供 `--project-name`、`--app-name` 自动准备 TLS LogApp。若未传 `--trace-topic-id`，安装器会从 LogApp 关联资源中发现 `trace` topic，并写入 `OPENCODE_TLS_TRACE_TOPIC_ID`。
+
+## 本地开发
+
+```bash
+emo run build --filter @volcengine/tls-observer-opencode
+emo run check --filter @volcengine/tls-observer-opencode-install
+emo run build --filter @volcengine/tls-observer-opencode-install
+
+OPENCODE_PLUGIN_SOURCE="$PWD/packages/opencode" \
+node packages/opencode-install/bin/tls-observer-opencode-install.mjs --force
+```
+
+安装器会读取源码包的 `publishConfig.directory`，因此本地开发与正式发布都会使用构建生成的 `dist-package`。

package/bin/tls-observer-opencode-install.mjs

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import { run } from '../dist/index.js';
+
+export { run } from '../dist/index.js';
+
+run().catch((error) => {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exit(1);
+});

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { run } from './installer/installer-runner.js';