@ctc-front/build-meta 0.0.0-stage → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+## 0.2.0
+
+- Vite 插件将构建元数据以内联 `<meta name="ctc-build-meta">` 注入构建 HTML，不再生成独立 `log.ico`。
+- CLI 和 Node API 保留独立 `log.ico` 文件输出，避免影响非 Vite 构建流程。
+- 补齐 Vite、Vue CLI/Webpack、CLI 和 Node API 的接入示例及迁移说明。
+
+## 0.1.1
+
+- 修复 `remoteUrl` 暴露 Git 服务 IP、域名和端口的问题，现在仅保留仓库路径。
+
+## 0.1.0
+
+- 提供与前端技术栈无关的构建元数据采集、编码、解码和文件生成能力。
+- 提供可选 Vite 插件与命令行入口。
+- 默认生成 `log.ico`，沿用 `c` → `ctcFront` 的可逆编码协议。
+- 构建元数据不包含邮箱，并对 Git remote 中的协议、凭据、Token 和 `.git` 后缀做脱敏。

package/LICENSE

@@ -0,0 +1,8 @@
+UNLICENSED
+
+Copyright (c) CTC Front Team. All rights reserved.
+
+This package is published on the public npm registry by CTC Front. Public
+availability does not grant an open-source license or authorize modification,
+redistribution, or use outside projects approved by CTC Front. All other rights
+are reserved.

package/README.md

@@ -1,3 +1,161 @@
-# Temporary Holding Version
+# @ctc-front/build-meta
 
-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.
+统一采集、编码并输出 CTC Front Web 项目的构建元数据。包本身不依赖 Vue、Vite 或 Webpack；Vite 项目通过 `@ctc-front/build-meta/vite` 使用可选适配层。
+
+本包配置为公开发布至 npmjs 的 `@ctc-front` scope。安装方式：`pnpm add -D @ctc-front/build-meta`。在仓库根目录运行 `pnpm pack:build-meta` 仍可生成用于本地验证的 `.tgz`。
+
+## 新项目：Vite（Vue 3）
+
+Vite 项目使用包提供的插件，在 production build 时把元数据内联到 HTML。先安装开发依赖：
+
+```bash
+pnpm add -D @ctc-front/build-meta
+```
+
+然后在 `vite.config.ts` 中配置：
+
+```ts
+import { buildMetaPlugin } from '@ctc-front/build-meta/vite'
+import { name, title, version } from './package.json'
+
+export default {
+  plugins: [buildMetaPlugin({ name, title, version })],
+}
+```
+
+入口 HTML 中不需要额外写模板代码；构建后可在部署页面的浏览器控制台读取 meta 标签。完整接入示例见仓库内 [`examples/build-meta`](../../examples/build-meta/README.md)；项目级说明可查看 `ctc-fe-web-starter/docs/build-meta.md`。
+
+执行 Vite production build 后，插件会把编码后的元数据作为以下 `<meta>` 标签插入到每个 HTML 入口的 `<head>`，不会另外生成 `log.ico`：
+
+```html
+<meta name="ctc-build-meta" content="编码后的版本信息" />
+```
+
+插件不要求入口文件必须叫 `index.html`。Vite 实际处理的每个 HTML 入口都会注入，例如 `admin.html` 或配置的自定义 HTML 入口也可以使用。若项目没有任何 HTML 入口（例如仅打包 JavaScript 的 library mode），`transformIndexHtml` 不会执行，插件不会注入标签，也不会因此让构建失败。
+
+这种情况下，如果仍需输出元数据，可使用 CLI 或 Node API 生成独立 `log.ico`；如果消费者必须从 HTML 读取，则需要提供一个 HTML 入口，或在业务构建中自行决定元数据的承载方式。
+
+在浏览器控制台读取并还原信息：
+
+```js
+const encoded = document.querySelector('meta[name="ctc-build-meta"]')?.content
+if (encoded) {
+  const normalized = encoded.replace(/ctcFront/g, 'c')
+  const meta = JSON.parse(decodeURIComponent(atob(normalized)))
+  console.table(meta)
+}
+```
+
+此处采用 URI 编码后再 Base64 的内容格式；`ctcFront` 替换仅为可逆的兼容编码，不是加密或访问控制。内联只取消独立 `log.ico` 文件，不会隐藏 HTML 中的元数据。不得将密钥、Token 或其他不应公开的敏感信息放入这些字段。
+
+## 老项目：Vue CLI / Webpack（Vue 2）
+
+老项目不使用 Vite 插件。通过包根入口的 Node API 在 Webpack 构建配置阶段采集并编码元数据，再由 `HtmlWebpackPlugin` 模板写入 HTML。先安装开发依赖：
+
+```bash
+npm install --save-dev @ctc-front/build-meta
+```
+
+然后在 `vue.config.js` 中配置：
+
+```js
+const { collectBuildMeta, encodeBuildMeta } = require('@ctc-front/build-meta')
+const { name, title, version } = require('./package.json')
+
+// 放在现有的 chainWebpack(config) 配置中
+if (process.env.NODE_ENV === 'production') {
+  config.plugin('html').tap((args) => {
+    args[0].ctcBuildMeta = encodeBuildMeta(
+      collectBuildMeta({ name, title, version, cwd: __dirname }),
+    ).version
+    return args
+  })
+}
+```
+
+然后在 `public/index.html` 的 `<head>` 中加入 HtmlWebpackPlugin/EJS 模板片段：
+
+```html
+<% if (htmlWebpackPlugin.options.ctcBuildMeta) { %>
+<meta name="ctc-build-meta" content="<%= htmlWebpackPlugin.options.ctcBuildMeta %>" />
+<% } %>
+```
+
+这段逻辑只在生产构建时写入标签；开发服务器不注入。构建后检查实际输出的 HTML（Vue CLI 项目的输出目录由 `outputDir` 决定），读取方式与上面的 Vite 项目相同。老项目不需要也不应安装 `vite` 或使用 `@ctc-front/build-meta/vite`。项目级迁移说明可查看 `ctc-startup-web/docs/build-meta.md`。
+
+## 元数据格式与隐私
+
+编码前的数据结构：
+
+```ts
+interface BuildMeta {
+  schemaVersion: 1
+  name: string
+  projectName: string
+  version: string
+  remoteUrl: string
+  buildDate: string
+  user: string
+  lastCommitLog: string
+  lastCommitHash: string
+  lastCommitDate: string
+}
+```
+
+元数据不包含构建者邮箱。`remoteUrl` 只保留仓库路径，例如 `project/front/demo`；协议、域名、IP、端口、用户名、密码、Token 和 `.git` 后缀都会被移除。构建目录不是 Git 仓库或 Git 信息缺失时，对应字段使用 `unknown` 或 `detached`，不会中断打包。
+
+## CLI 与 Node API：独立文件模式
+
+Vite 插件改为 HTML 内联；CLI 和 Node API 为兼容现有自动化流程，仍可生成独立 `log.ico` 文件。
+
+CLI：
+
+```bash
+ctc-build-meta generate --out-dir dist
+ctc-build-meta decode ./dist/log.ico
+```
+
+`generate` 默认读取当前目录 `package.json` 中的 `name`、`title` 和 `version`。
+
+Node API：
+
+```ts
+import { decodeBuildMeta, generateBuildMeta } from '@ctc-front/build-meta'
+
+const result = generateBuildMeta({
+  name: 'example-web',
+  title: '示例系统',
+  version: '1.0.0',
+  outDir: './dist',
+})
+
+console.log(decodeBuildMeta(result.artifact))
+```
+
+## 从旧 Vite 产物迁移
+
+旧版本的 Vite 插件在 `outDir` 生成 `log.ico`。新版本改为在 HTML 中输出 `meta[name="ctc-build-meta"]`，不再提供该文件。若应用代码或构建检查脚本仍在 `fetch('/log.ico')` 或检查 `dist/log.ico`，需要改为读取 HTML meta 标签。
+
+```js
+const encoded = document.querySelector('meta[name="ctc-build-meta"]')?.content
+if (!encoded) throw new Error('Build metadata is missing from this HTML entry')
+const meta = JSON.parse(decodeURIComponent(atob(encoded.replace(/ctcFront/g, 'c'))))
+```
+
+这段代码应在承载应用的 HTML 页面中执行；不必假定页面文件名是 `index.html`。如果构建产物没有 HTML，页面端自然也没有可读取的 meta 标签。
+
+## 本地开发
+
+在仓库根目录运行：
+
+```bash
+pnpm build:build-meta
+pnpm --filter @ctc-front/build-meta test
+pnpm --filter @ctc-front/build-meta pack:check
+```
+
+生产构建默认关闭 sourcemap。
+
+## 版本与发布
+
+包版本以 `packages/build-meta/package.json` 为准，当前为 `0.2.0`。本版本将 Vite 插件行为改为内联 HTML meta；CLI 与 Node API 仍生成独立 `log.ico`。npm 上是否已提供该版本，以 registry 查询结果为准；需要生成可安装 tarball 时，在仓库根目录执行 `pnpm pack:build-meta`，产物位于 `artifacts/`。

package/bin/ctc-build-meta.cjs

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/* global process */
+
+void import('../dist/cli.js')
+  .then(({ runCli }) => runCli(process.argv.slice(2)))
+  .catch((error) => {
+    const message = error instanceof Error ? error.message : String(error)
+    process.stderr.write(`[build-meta] ${message}\n`)
+    process.exitCode = 1
+  })

package/dist/cli.cjs

@@ -0,0 +1,58 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_generate = require("./generate-CQvoIMfu.cjs");
+let node_fs = require("node:fs");
+node_fs = require_generate.__toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = require_generate.__toESM(node_path, 1);
+//#region src/cli.ts
+function readOption(args, name) {
+	const index = args.indexOf(name);
+	if (index < 0) return void 0;
+	const value = args[index + 1];
+	if (!value || value.startsWith("--")) throw new TypeError(`${name} requires a value.`);
+	return value;
+}
+function readPackageMetadata(cwd) {
+	const source = JSON.parse(node_fs.default.readFileSync(node_path.default.join(cwd, "package.json"), "utf8"));
+	if (!source || typeof source !== "object") throw new TypeError("Invalid package.json.");
+	const value = source;
+	if (typeof value.name !== "string" || typeof value.version !== "string") throw new TypeError("package.json must contain name and version.");
+	return {
+		name: value.name,
+		title: typeof value.title === "string" ? value.title : value.name,
+		version: value.version
+	};
+}
+function generate(args) {
+	var _readOption;
+	const cwd = node_path.default.resolve((_readOption = readOption(args, "--cwd")) !== null && _readOption !== void 0 ? _readOption : process.cwd());
+	const project = readPackageMetadata(cwd);
+	const outDir = readOption(args, "--out-dir");
+	if (!outDir) throw new TypeError("generate requires --out-dir <directory>.");
+	const title = readOption(args, "--title");
+	const result = require_generate.generateBuildMeta({
+		...project,
+		cwd,
+		outDir,
+		...title ? { title } : {}
+	});
+	process.stdout.write(`[build-meta] ${result.filePath}\n`);
+}
+function decode(args) {
+	const filePath = args[0];
+	if (!filePath) throw new TypeError("decode requires a log.ico path.");
+	const source = node_fs.default.readFileSync(node_path.default.resolve(filePath), "utf8");
+	process.stdout.write(`${JSON.stringify(require_generate.decodeBuildMeta(source), null, 2)}\n`);
+}
+function printHelp() {
+	process.stdout.write("Usage:\n  ctc-build-meta generate --out-dir <directory> [--title <title>]\n  ctc-build-meta decode <log.ico>\n");
+}
+function runCli(args) {
+	const [command, ...rest] = args;
+	if (command === "generate") return generate(rest);
+	if (command === "decode") return decode(rest);
+	if (command === void 0 || command === "--help" || command === "-h") return printHelp();
+	throw new TypeError(`Unknown command: ${command}`);
+}
+//#endregion
+exports.runCli = runCli;

package/dist/cli.d.cts

@@ -0,0 +1,3 @@
+//#region src/cli.d.ts
+export declare function runCli(args: readonly string[]): void;
+//#endregion

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+//#region src/cli.d.ts
+export declare function runCli(args: readonly string[]): void;
+//#endregion

package/dist/cli.js

@@ -0,0 +1,55 @@
+import { i as decodeBuildMeta, n as generateBuildMeta } from "./generate-BlU9oOSR.js";
+import fs from "node:fs";
+import path from "node:path";
+//#region src/cli.ts
+function readOption(args, name) {
+	const index = args.indexOf(name);
+	if (index < 0) return void 0;
+	const value = args[index + 1];
+	if (!value || value.startsWith("--")) throw new TypeError(`${name} requires a value.`);
+	return value;
+}
+function readPackageMetadata(cwd) {
+	const source = JSON.parse(fs.readFileSync(path.join(cwd, "package.json"), "utf8"));
+	if (!source || typeof source !== "object") throw new TypeError("Invalid package.json.");
+	const value = source;
+	if (typeof value.name !== "string" || typeof value.version !== "string") throw new TypeError("package.json must contain name and version.");
+	return {
+		name: value.name,
+		title: typeof value.title === "string" ? value.title : value.name,
+		version: value.version
+	};
+}
+function generate(args) {
+	var _readOption;
+	const cwd = path.resolve((_readOption = readOption(args, "--cwd")) !== null && _readOption !== void 0 ? _readOption : process.cwd());
+	const project = readPackageMetadata(cwd);
+	const outDir = readOption(args, "--out-dir");
+	if (!outDir) throw new TypeError("generate requires --out-dir <directory>.");
+	const title = readOption(args, "--title");
+	const result = generateBuildMeta({
+		...project,
+		cwd,
+		outDir,
+		...title ? { title } : {}
+	});
+	process.stdout.write(`[build-meta] ${result.filePath}\n`);
+}
+function decode(args) {
+	const filePath = args[0];
+	if (!filePath) throw new TypeError("decode requires a log.ico path.");
+	const source = fs.readFileSync(path.resolve(filePath), "utf8");
+	process.stdout.write(`${JSON.stringify(decodeBuildMeta(source), null, 2)}\n`);
+}
+function printHelp() {
+	process.stdout.write("Usage:\n  ctc-build-meta generate --out-dir <directory> [--title <title>]\n  ctc-build-meta decode <log.ico>\n");
+}
+function runCli(args) {
+	const [command, ...rest] = args;
+	if (command === "generate") return generate(rest);
+	if (command === "decode") return decode(rest);
+	if (command === void 0 || command === "--help" || command === "-h") return printHelp();
+	throw new TypeError(`Unknown command: ${command}`);
+}
+//#endregion
+export { runCli };

package/dist/generate-BlU9oOSR.js

@@ -0,0 +1,193 @@
+import fs from "node:fs";
+import path from "node:path";
+import { execFileSync } from "node:child_process";
+//#region src/codec.ts
+const OBFUSCATED_CHARACTER = "ctcFront";
+const STRING_FIELDS = [
+	"name",
+	"projectName",
+	"version",
+	"remoteUrl",
+	"buildDate",
+	"user",
+	"lastCommitLog",
+	"lastCommitHash",
+	"lastCommitDate"
+];
+function isRecord(value) {
+	return typeof value === "object" && value !== null;
+}
+function parseArtifact(value) {
+	const parsed = typeof value === "string" ? JSON.parse(value) : value;
+	if (!isRecord(parsed) || typeof parsed.version !== "string") throw new TypeError("Build meta artifact must contain a string version field.");
+	return { version: parsed.version };
+}
+function isBuildMeta(value) {
+	if (!isRecord(value) || value.schemaVersion !== 1) return false;
+	return STRING_FIELDS.every((field) => typeof value[field] === "string");
+}
+function encodeBuildMeta(meta) {
+	return { version: Buffer.from(encodeURIComponent(JSON.stringify(meta)), "utf8").toString("base64").replace(/c/gu, OBFUSCATED_CHARACTER) };
+}
+function decodeBuildMeta(value) {
+	const encoded = parseArtifact(value).version.replace(/ctcFront/gu, "c");
+	const decoded = JSON.parse(decodeURIComponent(Buffer.from(encoded, "base64").toString()));
+	if (!isBuildMeta(decoded)) throw new TypeError("Unsupported build meta schema.");
+	return decoded;
+}
+function serializeBuildMetaArtifact(artifact) {
+	return JSON.stringify(artifact, null, 2);
+}
+//#endregion
+//#region src/date.ts
+const UNKNOWN_VALUE$2 = "unknown";
+function pad(value) {
+	return String(value).padStart(2, "0");
+}
+function formatBuildDate(value) {
+	const date = value instanceof Date ? value : new Date(value);
+	if (Number.isNaN(date.getTime())) return UNKNOWN_VALUE$2;
+	return `${`${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`} ${`${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}`}`;
+}
+//#endregion
+//#region src/repository.ts
+const UNKNOWN_VALUE$1 = "unknown";
+const SUPPORTED_PROTOCOLS = /* @__PURE__ */ new Set([
+	"git:",
+	"http:",
+	"https:",
+	"ssh:"
+]);
+function removeGitSuffix(value) {
+	return value.replace(/\/+$/u, "").replace(/\.git$/u, "");
+}
+function removeQueryAndFragment(value) {
+	var _value$split$;
+	return (_value$split$ = value.split(/[?#]/u, 1)[0]) !== null && _value$split$ !== void 0 ? _value$split$ : "";
+}
+function normalizeRepositoryPath(value) {
+	const normalized = removeGitSuffix(removeQueryAndFragment(value).replace(/^[\\/]+/u, ""));
+	return normalized.length > 0 ? normalized : void 0;
+}
+function sanitizeUrl(value) {
+	try {
+		var _normalizeRepositoryP;
+		const url = new URL(value);
+		if (!SUPPORTED_PROTOCOLS.has(url.protocol) || url.host.length === 0) return UNKNOWN_VALUE$1;
+		return (_normalizeRepositoryP = normalizeRepositoryPath(url.pathname)) !== null && _normalizeRepositoryP !== void 0 ? _normalizeRepositoryP : UNKNOWN_VALUE$1;
+	} catch (_unused) {
+		return;
+	}
+}
+function sanitizeScpLike(value) {
+	const match = /^(?:[^@\s]+@)?([^:\s]+):(.+)$/u.exec(value);
+	if (!(match === null || match === void 0 ? void 0 : match[1]) || !match[2] || match[2].includes("@")) return void 0;
+	return normalizeRepositoryPath(match[2]);
+}
+function sanitizeRepositoryUrl(value) {
+	var _ref, _sanitizeUrl;
+	const trimmed = value.trim();
+	if (trimmed.length === 0) return UNKNOWN_VALUE$1;
+	return (_ref = (_sanitizeUrl = sanitizeUrl(trimmed)) !== null && _sanitizeUrl !== void 0 ? _sanitizeUrl : sanitizeScpLike(trimmed)) !== null && _ref !== void 0 ? _ref : UNKNOWN_VALUE$1;
+}
+//#endregion
+//#region src/git.ts
+const UNKNOWN_VALUE = "unknown";
+function execGit(args, cwd, fallback = UNKNOWN_VALUE) {
+	try {
+		const value = execFileSync("git", args, {
+			cwd,
+			encoding: "utf8",
+			stdio: [
+				"ignore",
+				"pipe",
+				"ignore"
+			]
+		}).trim();
+		return value.length > 0 ? value : fallback;
+	} catch (_unused) {
+		return fallback;
+	}
+}
+function resolveBranch(cwd) {
+	var _ref, _process$env$CI_COMMI;
+	const gitBranch = execGit(["branch", "--show-current"], cwd, "");
+	return ((_ref = (_process$env$CI_COMMI = process.env.CI_COMMIT_REF_NAME) !== null && _process$env$CI_COMMI !== void 0 ? _process$env$CI_COMMI : process.env.GITHUB_REF_NAME) !== null && _ref !== void 0 ? _ref : gitBranch) || "detached";
+}
+function collectGitMetadata(cwd, remoteUrl) {
+	const resolvedRemote = remoteUrl !== null && remoteUrl !== void 0 ? remoteUrl : execGit([
+		"config",
+		"--get",
+		"remote.origin.url"
+	], cwd);
+	return {
+		branch: resolveBranch(cwd),
+		commitDate: formatBuildDate(execGit([
+			"show",
+			"-s",
+			"--format=%cI"
+		], cwd)),
+		commitHash: execGit([
+			"show",
+			"-s",
+			"--format=%H"
+		], cwd),
+		commitLog: execGit([
+			"show",
+			"-s",
+			"--format=%s"
+		], cwd),
+		remoteUrl: sanitizeRepositoryUrl(resolvedRemote),
+		user: execGit(["config", "user.name"], cwd)
+	};
+}
+//#endregion
+//#region src/generate.ts
+const DEFAULT_FILE_NAME = "log.ico";
+function assertProjectConfig(options) {
+	if ([
+		options.name,
+		options.title,
+		options.version
+	].some((value) => value.trim().length === 0)) throw new TypeError("Build meta name, title and version must be non-empty strings.");
+}
+function resolveOutputFile(options) {
+	var _options$cwd, _options$fileName;
+	const cwd = path.resolve((_options$cwd = options.cwd) !== null && _options$cwd !== void 0 ? _options$cwd : process.cwd());
+	const outDir = path.resolve(cwd, options.outDir);
+	const filePath = path.resolve(outDir, (_options$fileName = options.fileName) !== null && _options$fileName !== void 0 ? _options$fileName : DEFAULT_FILE_NAME);
+	const relativePath = path.relative(outDir, filePath);
+	if (relativePath.startsWith("..") || path.isAbsolute(relativePath)) throw new TypeError("Build meta fileName must stay inside outDir.");
+	return filePath;
+}
+function collectBuildMeta(options) {
+	var _options$cwd2;
+	assertProjectConfig(options);
+	const git = collectGitMetadata(path.resolve((_options$cwd2 = options.cwd) !== null && _options$cwd2 !== void 0 ? _options$cwd2 : process.cwd()), options.remoteUrl);
+	return {
+		schemaVersion: 1,
+		name: options.name,
+		projectName: options.title,
+		version: options.version,
+		remoteUrl: git.remoteUrl,
+		buildDate: formatBuildDate(/* @__PURE__ */ new Date()),
+		user: git.user,
+		lastCommitLog: git.commitLog,
+		lastCommitHash: `${options.name}/${git.branch}/${git.commitHash}`,
+		lastCommitDate: git.commitDate
+	};
+}
+function generateBuildMeta(options) {
+	const meta = collectBuildMeta(options);
+	const artifact = encodeBuildMeta(meta);
+	const filePath = resolveOutputFile(options);
+	fs.mkdirSync(path.dirname(filePath), { recursive: true });
+	fs.writeFileSync(filePath, serializeBuildMetaArtifact(artifact));
+	return {
+		artifact,
+		filePath,
+		meta
+	};
+}
+//#endregion
+export { encodeBuildMeta as a, decodeBuildMeta as i, generateBuildMeta as n, serializeBuildMetaArtifact as o, sanitizeRepositoryUrl as r, collectBuildMeta as t };

package/dist/generate-CQvoIMfu.cjs

@@ -0,0 +1,258 @@
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+let node_fs = require("node:fs");
+node_fs = __toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = __toESM(node_path, 1);
+let node_child_process = require("node:child_process");
+//#region src/codec.ts
+const OBFUSCATED_CHARACTER = "ctcFront";
+const STRING_FIELDS = [
+	"name",
+	"projectName",
+	"version",
+	"remoteUrl",
+	"buildDate",
+	"user",
+	"lastCommitLog",
+	"lastCommitHash",
+	"lastCommitDate"
+];
+function isRecord(value) {
+	return typeof value === "object" && value !== null;
+}
+function parseArtifact(value) {
+	const parsed = typeof value === "string" ? JSON.parse(value) : value;
+	if (!isRecord(parsed) || typeof parsed.version !== "string") throw new TypeError("Build meta artifact must contain a string version field.");
+	return { version: parsed.version };
+}
+function isBuildMeta(value) {
+	if (!isRecord(value) || value.schemaVersion !== 1) return false;
+	return STRING_FIELDS.every((field) => typeof value[field] === "string");
+}
+function encodeBuildMeta(meta) {
+	return { version: Buffer.from(encodeURIComponent(JSON.stringify(meta)), "utf8").toString("base64").replace(/c/gu, OBFUSCATED_CHARACTER) };
+}
+function decodeBuildMeta(value) {
+	const encoded = parseArtifact(value).version.replace(/ctcFront/gu, "c");
+	const decoded = JSON.parse(decodeURIComponent(Buffer.from(encoded, "base64").toString()));
+	if (!isBuildMeta(decoded)) throw new TypeError("Unsupported build meta schema.");
+	return decoded;
+}
+function serializeBuildMetaArtifact(artifact) {
+	return JSON.stringify(artifact, null, 2);
+}
+//#endregion
+//#region src/date.ts
+const UNKNOWN_VALUE$2 = "unknown";
+function pad(value) {
+	return String(value).padStart(2, "0");
+}
+function formatBuildDate(value) {
+	const date = value instanceof Date ? value : new Date(value);
+	if (Number.isNaN(date.getTime())) return UNKNOWN_VALUE$2;
+	return `${`${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`} ${`${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}`}`;
+}
+//#endregion
+//#region src/repository.ts
+const UNKNOWN_VALUE$1 = "unknown";
+const SUPPORTED_PROTOCOLS = /* @__PURE__ */ new Set([
+	"git:",
+	"http:",
+	"https:",
+	"ssh:"
+]);
+function removeGitSuffix(value) {
+	return value.replace(/\/+$/u, "").replace(/\.git$/u, "");
+}
+function removeQueryAndFragment(value) {
+	var _value$split$;
+	return (_value$split$ = value.split(/[?#]/u, 1)[0]) !== null && _value$split$ !== void 0 ? _value$split$ : "";
+}
+function normalizeRepositoryPath(value) {
+	const normalized = removeGitSuffix(removeQueryAndFragment(value).replace(/^[\\/]+/u, ""));
+	return normalized.length > 0 ? normalized : void 0;
+}
+function sanitizeUrl(value) {
+	try {
+		var _normalizeRepositoryP;
+		const url = new URL(value);
+		if (!SUPPORTED_PROTOCOLS.has(url.protocol) || url.host.length === 0) return UNKNOWN_VALUE$1;
+		return (_normalizeRepositoryP = normalizeRepositoryPath(url.pathname)) !== null && _normalizeRepositoryP !== void 0 ? _normalizeRepositoryP : UNKNOWN_VALUE$1;
+	} catch (_unused) {
+		return;
+	}
+}
+function sanitizeScpLike(value) {
+	const match = /^(?:[^@\s]+@)?([^:\s]+):(.+)$/u.exec(value);
+	if (!(match === null || match === void 0 ? void 0 : match[1]) || !match[2] || match[2].includes("@")) return void 0;
+	return normalizeRepositoryPath(match[2]);
+}
+function sanitizeRepositoryUrl(value) {
+	var _ref, _sanitizeUrl;
+	const trimmed = value.trim();
+	if (trimmed.length === 0) return UNKNOWN_VALUE$1;
+	return (_ref = (_sanitizeUrl = sanitizeUrl(trimmed)) !== null && _sanitizeUrl !== void 0 ? _sanitizeUrl : sanitizeScpLike(trimmed)) !== null && _ref !== void 0 ? _ref : UNKNOWN_VALUE$1;
+}
+//#endregion
+//#region src/git.ts
+const UNKNOWN_VALUE = "unknown";
+function execGit(args, cwd, fallback = UNKNOWN_VALUE) {
+	try {
+		const value = (0, node_child_process.execFileSync)("git", args, {
+			cwd,
+			encoding: "utf8",
+			stdio: [
+				"ignore",
+				"pipe",
+				"ignore"
+			]
+		}).trim();
+		return value.length > 0 ? value : fallback;
+	} catch (_unused) {
+		return fallback;
+	}
+}
+function resolveBranch(cwd) {
+	var _ref, _process$env$CI_COMMI;
+	const gitBranch = execGit(["branch", "--show-current"], cwd, "");
+	return ((_ref = (_process$env$CI_COMMI = process.env.CI_COMMIT_REF_NAME) !== null && _process$env$CI_COMMI !== void 0 ? _process$env$CI_COMMI : process.env.GITHUB_REF_NAME) !== null && _ref !== void 0 ? _ref : gitBranch) || "detached";
+}
+function collectGitMetadata(cwd, remoteUrl) {
+	const resolvedRemote = remoteUrl !== null && remoteUrl !== void 0 ? remoteUrl : execGit([
+		"config",
+		"--get",
+		"remote.origin.url"
+	], cwd);
+	return {
+		branch: resolveBranch(cwd),
+		commitDate: formatBuildDate(execGit([
+			"show",
+			"-s",
+			"--format=%cI"
+		], cwd)),
+		commitHash: execGit([
+			"show",
+			"-s",
+			"--format=%H"
+		], cwd),
+		commitLog: execGit([
+			"show",
+			"-s",
+			"--format=%s"
+		], cwd),
+		remoteUrl: sanitizeRepositoryUrl(resolvedRemote),
+		user: execGit(["config", "user.name"], cwd)
+	};
+}
+//#endregion
+//#region src/generate.ts
+const DEFAULT_FILE_NAME = "log.ico";
+function assertProjectConfig(options) {
+	if ([
+		options.name,
+		options.title,
+		options.version
+	].some((value) => value.trim().length === 0)) throw new TypeError("Build meta name, title and version must be non-empty strings.");
+}
+function resolveOutputFile(options) {
+	var _options$cwd, _options$fileName;
+	const cwd = node_path.default.resolve((_options$cwd = options.cwd) !== null && _options$cwd !== void 0 ? _options$cwd : process.cwd());
+	const outDir = node_path.default.resolve(cwd, options.outDir);
+	const filePath = node_path.default.resolve(outDir, (_options$fileName = options.fileName) !== null && _options$fileName !== void 0 ? _options$fileName : DEFAULT_FILE_NAME);
+	const relativePath = node_path.default.relative(outDir, filePath);
+	if (relativePath.startsWith("..") || node_path.default.isAbsolute(relativePath)) throw new TypeError("Build meta fileName must stay inside outDir.");
+	return filePath;
+}
+function collectBuildMeta(options) {
+	var _options$cwd2;
+	assertProjectConfig(options);
+	const git = collectGitMetadata(node_path.default.resolve((_options$cwd2 = options.cwd) !== null && _options$cwd2 !== void 0 ? _options$cwd2 : process.cwd()), options.remoteUrl);
+	return {
+		schemaVersion: 1,
+		name: options.name,
+		projectName: options.title,
+		version: options.version,
+		remoteUrl: git.remoteUrl,
+		buildDate: formatBuildDate(/* @__PURE__ */ new Date()),
+		user: git.user,
+		lastCommitLog: git.commitLog,
+		lastCommitHash: `${options.name}/${git.branch}/${git.commitHash}`,
+		lastCommitDate: git.commitDate
+	};
+}
+function generateBuildMeta(options) {
+	const meta = collectBuildMeta(options);
+	const artifact = encodeBuildMeta(meta);
+	const filePath = resolveOutputFile(options);
+	node_fs.default.mkdirSync(node_path.default.dirname(filePath), { recursive: true });
+	node_fs.default.writeFileSync(filePath, serializeBuildMetaArtifact(artifact));
+	return {
+		artifact,
+		filePath,
+		meta
+	};
+}
+//#endregion
+Object.defineProperty(exports, "__toESM", {
+	enumerable: true,
+	get: function() {
+		return __toESM;
+	}
+});
+Object.defineProperty(exports, "collectBuildMeta", {
+	enumerable: true,
+	get: function() {
+		return collectBuildMeta;
+	}
+});
+Object.defineProperty(exports, "decodeBuildMeta", {
+	enumerable: true,
+	get: function() {
+		return decodeBuildMeta;
+	}
+});
+Object.defineProperty(exports, "encodeBuildMeta", {
+	enumerable: true,
+	get: function() {
+		return encodeBuildMeta;
+	}
+});
+Object.defineProperty(exports, "generateBuildMeta", {
+	enumerable: true,
+	get: function() {
+		return generateBuildMeta;
+	}
+});
+Object.defineProperty(exports, "sanitizeRepositoryUrl", {
+	enumerable: true,
+	get: function() {
+		return sanitizeRepositoryUrl;
+	}
+});
+Object.defineProperty(exports, "serializeBuildMetaArtifact", {
+	enumerable: true,
+	get: function() {
+		return serializeBuildMetaArtifact;
+	}
+});

package/dist/index.cjs

@@ -0,0 +1,8 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_generate = require("./generate-CQvoIMfu.cjs");
+exports.collectBuildMeta = require_generate.collectBuildMeta;
+exports.decodeBuildMeta = require_generate.decodeBuildMeta;
+exports.encodeBuildMeta = require_generate.encodeBuildMeta;
+exports.generateBuildMeta = require_generate.generateBuildMeta;
+exports.sanitizeRepositoryUrl = require_generate.sanitizeRepositoryUrl;
+exports.serializeBuildMetaArtifact = require_generate.serializeBuildMetaArtifact;

package/dist/index.d.cts

@@ -0,0 +1,14 @@
+import { a as BuildMetaPluginOptions, i as BuildMetaOptions, n as BuildMetaArtifact, o as BuildMetaProject, r as BuildMetaCollectOptions, s as BuildMetaResult, t as BuildMeta } from "./types-DHl2uQY2.cjs";
+//#region src/codec.d.ts
+export declare function encodeBuildMeta(meta: BuildMeta): BuildMetaArtifact;
+export declare function decodeBuildMeta(value: string | BuildMetaArtifact): BuildMeta;
+export declare function serializeBuildMetaArtifact(artifact: BuildMetaArtifact): string;
+//#endregion
+//#region src/generate.d.ts
+export declare function collectBuildMeta(options: BuildMetaCollectOptions): BuildMeta;
+export declare function generateBuildMeta(options: BuildMetaOptions): BuildMetaResult;
+//#endregion
+//#region src/repository.d.ts
+export declare function sanitizeRepositoryUrl(value: string): string;
+//#endregion
+export type { BuildMeta, BuildMetaArtifact, BuildMetaCollectOptions, BuildMetaOptions, BuildMetaPluginOptions, BuildMetaProject, BuildMetaResult };

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+import { a as BuildMetaPluginOptions, i as BuildMetaOptions, n as BuildMetaArtifact, o as BuildMetaProject, r as BuildMetaCollectOptions, s as BuildMetaResult, t as BuildMeta } from "./types-DHl2uQY2.js";
+//#region src/codec.d.ts
+export declare function encodeBuildMeta(meta: BuildMeta): BuildMetaArtifact;
+export declare function decodeBuildMeta(value: string | BuildMetaArtifact): BuildMeta;
+export declare function serializeBuildMetaArtifact(artifact: BuildMetaArtifact): string;
+//#endregion
+//#region src/generate.d.ts
+export declare function collectBuildMeta(options: BuildMetaCollectOptions): BuildMeta;
+export declare function generateBuildMeta(options: BuildMetaOptions): BuildMetaResult;
+//#endregion
+//#region src/repository.d.ts
+export declare function sanitizeRepositoryUrl(value: string): string;
+//#endregion
+export type { BuildMeta, BuildMetaArtifact, BuildMetaCollectOptions, BuildMetaOptions, BuildMetaPluginOptions, BuildMetaProject, BuildMetaResult };

package/dist/index.js

@@ -0,0 +1,2 @@
+import { a as encodeBuildMeta, i as decodeBuildMeta, n as generateBuildMeta, o as serializeBuildMetaArtifact, r as sanitizeRepositoryUrl, t as collectBuildMeta } from "./generate-BlU9oOSR.js";
+export { collectBuildMeta, decodeBuildMeta, encodeBuildMeta, generateBuildMeta, sanitizeRepositoryUrl, serializeBuildMetaArtifact };

package/dist/types-DHl2uQY2.d.cts

@@ -0,0 +1,41 @@
+//#region src/types.d.ts
+interface BuildMetaProject {
+  name: string;
+  title: string;
+  version: string;
+}
+interface BuildMeta {
+  schemaVersion: 1;
+  name: string;
+  projectName: string;
+  version: string;
+  remoteUrl: string;
+  buildDate: string;
+  user: string;
+  lastCommitLog: string;
+  lastCommitHash: string;
+  lastCommitDate: string;
+}
+interface BuildMetaArtifact {
+  version: string;
+}
+interface BuildMetaCollectOptions extends BuildMetaProject {
+  cwd?: string;
+  remoteUrl?: string;
+}
+interface BuildMetaOptions extends BuildMetaCollectOptions {
+  fileName?: string;
+  outDir: string;
+}
+interface BuildMetaResult {
+  artifact: BuildMetaArtifact;
+  filePath: string;
+  meta: BuildMeta;
+}
+interface BuildMetaPluginOptions extends BuildMetaProject {
+  cwd?: string;
+  fileName?: string;
+  remoteUrl?: string;
+}
+//#endregion
+export { BuildMetaPluginOptions as a, BuildMetaOptions as i, BuildMetaArtifact as n, BuildMetaProject as o, BuildMetaCollectOptions as r, BuildMetaResult as s, BuildMeta as t };

package/dist/types-DHl2uQY2.d.ts

@@ -0,0 +1,41 @@
+//#region src/types.d.ts
+interface BuildMetaProject {
+  name: string;
+  title: string;
+  version: string;
+}
+interface BuildMeta {
+  schemaVersion: 1;
+  name: string;
+  projectName: string;
+  version: string;
+  remoteUrl: string;
+  buildDate: string;
+  user: string;
+  lastCommitLog: string;
+  lastCommitHash: string;
+  lastCommitDate: string;
+}
+interface BuildMetaArtifact {
+  version: string;
+}
+interface BuildMetaCollectOptions extends BuildMetaProject {
+  cwd?: string;
+  remoteUrl?: string;
+}
+interface BuildMetaOptions extends BuildMetaCollectOptions {
+  fileName?: string;
+  outDir: string;
+}
+interface BuildMetaResult {
+  artifact: BuildMetaArtifact;
+  filePath: string;
+  meta: BuildMeta;
+}
+interface BuildMetaPluginOptions extends BuildMetaProject {
+  cwd?: string;
+  fileName?: string;
+  remoteUrl?: string;
+}
+//#endregion
+export { BuildMetaPluginOptions as a, BuildMetaOptions as i, BuildMetaArtifact as n, BuildMetaProject as o, BuildMetaCollectOptions as r, BuildMetaResult as s, BuildMeta as t };

package/dist/vite.cjs

@@ -0,0 +1,43 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_generate = require("./generate-CQvoIMfu.cjs");
+let node_path = require("node:path");
+node_path = require_generate.__toESM(node_path, 1);
+//#region src/vite.ts
+function buildMetaPlugin(options) {
+	var _options$cwd;
+	let cwd = node_path.default.resolve((_options$cwd = options.cwd) !== null && _options$cwd !== void 0 ? _options$cwd : process.cwd());
+	let artifact;
+	let logged = false;
+	return {
+		name: "ctc-build-meta",
+		apply: "build",
+		configResolved(config) {
+			var _options$cwd2;
+			cwd = node_path.default.resolve((_options$cwd2 = options.cwd) !== null && _options$cwd2 !== void 0 ? _options$cwd2 : config.root);
+		},
+		transformIndexHtml: {
+			order: "post",
+			handler() {
+				var _artifact;
+				(_artifact = artifact) !== null && _artifact !== void 0 || (artifact = require_generate.encodeBuildMeta(require_generate.collectBuildMeta({
+					...options,
+					cwd
+				})));
+				if (!logged) {
+					process.stdout.write("[build-meta] metadata injected into HTML\n");
+					logged = true;
+				}
+				return [{
+					tag: "meta",
+					attrs: {
+						name: "ctc-build-meta",
+						content: artifact.version
+					},
+					injectTo: "head-prepend"
+				}];
+			}
+		}
+	};
+}
+//#endregion
+exports.buildMetaPlugin = buildMetaPlugin;

package/dist/vite.d.cts

@@ -0,0 +1,26 @@
+import { a as BuildMetaPluginOptions } from "./types-DHl2uQY2.cjs";
+//#region src/vite.d.ts
+interface ResolvedViteConfig {
+  build: {
+    outDir: string;
+  };
+  root: string;
+}
+export interface BuildMetaVitePlugin {
+  apply: "build";
+  transformIndexHtml: {
+    handler(): Array<{
+      attrs: {
+        content: string;
+        name: "ctc-build-meta";
+      };
+      injectTo: "head-prepend";
+      tag: "meta";
+    }>;
+    order: "post";
+  };
+  configResolved(config: ResolvedViteConfig): void;
+  name: "ctc-build-meta";
+}
+export declare function buildMetaPlugin(options: BuildMetaPluginOptions): BuildMetaVitePlugin;
+//#endregion

package/dist/vite.d.ts

@@ -0,0 +1,26 @@
+import { a as BuildMetaPluginOptions } from "./types-DHl2uQY2.js";
+//#region src/vite.d.ts
+interface ResolvedViteConfig {
+  build: {
+    outDir: string;
+  };
+  root: string;
+}
+export interface BuildMetaVitePlugin {
+  apply: "build";
+  transformIndexHtml: {
+    handler(): Array<{
+      attrs: {
+        content: string;
+        name: "ctc-build-meta";
+      };
+      injectTo: "head-prepend";
+      tag: "meta";
+    }>;
+    order: "post";
+  };
+  configResolved(config: ResolvedViteConfig): void;
+  name: "ctc-build-meta";
+}
+export declare function buildMetaPlugin(options: BuildMetaPluginOptions): BuildMetaVitePlugin;
+//#endregion

package/dist/vite.js

@@ -0,0 +1,41 @@
+import { a as encodeBuildMeta, t as collectBuildMeta } from "./generate-BlU9oOSR.js";
+import path from "node:path";
+//#region src/vite.ts
+function buildMetaPlugin(options) {
+	var _options$cwd;
+	let cwd = path.resolve((_options$cwd = options.cwd) !== null && _options$cwd !== void 0 ? _options$cwd : process.cwd());
+	let artifact;
+	let logged = false;
+	return {
+		name: "ctc-build-meta",
+		apply: "build",
+		configResolved(config) {
+			var _options$cwd2;
+			cwd = path.resolve((_options$cwd2 = options.cwd) !== null && _options$cwd2 !== void 0 ? _options$cwd2 : config.root);
+		},
+		transformIndexHtml: {
+			order: "post",
+			handler() {
+				var _artifact;
+				(_artifact = artifact) !== null && _artifact !== void 0 || (artifact = encodeBuildMeta(collectBuildMeta({
+					...options,
+					cwd
+				})));
+				if (!logged) {
+					process.stdout.write("[build-meta] metadata injected into HTML\n");
+					logged = true;
+				}
+				return [{
+					tag: "meta",
+					attrs: {
+						name: "ctc-build-meta",
+						content: artifact.version
+					},
+					injectTo: "head-prepend"
+				}];
+			}
+		}
+	};
+}
+//#endregion
+export { buildMetaPlugin };

package/package.json

@@ -1,6 +1,69 @@
 {
   "name": "@ctc-front/build-meta",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "CTC Front 团队统一构建元数据生成工具",
+  "license": "UNLICENSED",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./vite": {
+      "import": {
+        "types": "./dist/vite.d.ts",
+        "default": "./dist/vite.js"
+      },
+      "require": {
+        "types": "./dist/vite.d.cts",
+        "default": "./dist/vite.cjs"
+      }
+    }
+  },
+  "bin": {
+    "ctc-build-meta": "./bin/ctc-build-meta.cjs"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "CHANGELOG.md",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=14"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@types/node": "24.10.1",
+    "acorn": "6.4.2",
+    "publint": "0.3.24",
+    "tsdown": "0.23.0",
+    "typescript": "5.9.3",
+    "vitest": "5.0.2"
+  },
+  "scripts": {
+    "dev": "tsdown --watch",
+    "build": "tsdown",
+    "lint": "eslint .",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "compat:node14": "node ./scripts/check-node14-syntax.mjs",
+    "pack:check": "publint && pnpm compat:node14 && pnpm pack --dry-run",
+    "check": "pnpm lint && pnpm typecheck && pnpm test && pnpm build && pnpm pack:check"
+  }
 }