@fz-firefly/unplugin 0.0.0-stage → 0.2.1

package/dist/vite.js

@@ -0,0 +1,68 @@
+import { n as buildInlineScript, t as runSourcemapUpload } from "./run-C7OeN-YM.js";
+import { resolve } from "node:path";
+// src/vite.ts
+/**
+* Firefly Vite 插件。
+*
+* - `sourcemap.generate: true` 时自动设置 `build.sourcemap = true`
+* - `closeBundle` 后扫描并上传 source map
+* - 只处理 build，不影响 dev server
+*/
+function fireflyVite(options = {}) {
+	var _options$sourcemap;
+	const sourcemap = options.sourcemap === false ? null : (_options$sourcemap = options.sourcemap) !== null && _options$sourcemap !== void 0 ? _options$sourcemap : null;
+	let resolvedConfig = null;
+	return {
+		name: "firefly",
+		apply: "build",
+		config() {
+			if (!(sourcemap === null || sourcemap === void 0 ? void 0 : sourcemap.generate)) return void 0;
+			return { build: { sourcemap: true } };
+		},
+		configResolved(config) {
+			resolvedConfig = config;
+		},
+		transformIndexHtml: {
+			order: "pre",
+			handler() {
+				const code = buildInlineScript(options);
+				if (!code) return void 0;
+				return [{
+					tag: "script",
+					attrs: {
+						"data-firefly-inline": "",
+						...options.script && options.script.nonce ? { nonce: options.script.nonce } : {}
+					},
+					children: code,
+					injectTo: "head-prepend"
+				}];
+			}
+		},
+		async closeBundle() {
+			var _sourcemap$platform, _sourcemap$base, _sourcemap$sourceRoot;
+			if (!sourcemap || !resolvedConfig) return;
+			const root = resolvedConfig.root;
+			const outDir = resolve(root, resolvedConfig.build.outDir);
+			const platform = (_sourcemap$platform = sourcemap.platform) !== null && _sourcemap$platform !== void 0 ? _sourcemap$platform : process.env.UNI_PLATFORM;
+			const mapDirs = [
+				sourcemap.mapDir,
+				platform ? resolve(outDir, "..", ".sourcemap", platform) : "",
+				outDir
+			].filter((value) => Boolean(value));
+			await runSourcemapUpload({
+				options,
+				sourcemap,
+				outDir,
+				mapDirs,
+				base: (_sourcemap$base = sourcemap.base) !== null && _sourcemap$base !== void 0 ? _sourcemap$base : resolvedConfig.base,
+				mode: resolvedConfig.mode,
+				isWatch: resolvedConfig.build.watch != null,
+				context: root,
+				sourceRoot: (_sourcemap$sourceRoot = sourcemap.sourceRoot) !== null && _sourcemap$sourceRoot !== void 0 ? _sourcemap$sourceRoot : root
+			});
+		}
+	};
+}
+export { fireflyVite as default, fireflyVite };
+
+//# sourceMappingURL=vite.js.map

package/dist/webpack.cjs

@@ -0,0 +1,170 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+const require_run = require("./run-Bp9vcqXk.cjs");
+let node_path = require("node:path");
+// src/webpack.ts
+const PLUGIN_NAME = "FireflyWebpackPlugin";
+/** 同一个 build_id 只真正上传一次，避免 Taro 多 compiler 重复上传。 */
+const uploadedBuildIds = /* @__PURE__ */ new Set();
+const uploadingBuildIds = /* @__PURE__ */ new Map();
+/**
+* Firefly webpack 插件。
+*
+* 兼容 webpack 4 / 5：只依赖 compiler.options 和 afterEmit hook，
+* 不直接 import webpack，避免不同版本的类型冲突。
+*/
+var FireflyWebpackPlugin = class {
+	constructor(options = {}) {
+		this.options = options;
+	}
+	apply(compiler) {
+		var _this$options$sourcem;
+		if (this.options.script) this.installInlineScript(compiler, this.options.script);
+		const sourcemap = this.options.sourcemap === false ? null : (_this$options$sourcem = this.options.sourcemap) !== null && _this$options$sourcem !== void 0 ? _this$options$sourcem : null;
+		if (sourcemap === null || sourcemap === void 0 ? void 0 : sourcemap.generate) {
+			process.env.SOURCEMAP = "true";
+			if (!compiler.options.devtool) compiler.options.devtool = "source-map";
+		}
+		if (!sourcemap) return;
+		if (Boolean(process.env.TARO_ENV) && compiler.hooks.shutdown) {
+			compiler.hooks.shutdown.tapPromise(PLUGIN_NAME, async () => {
+				await this.uploadOnce(compiler, {}, sourcemap);
+			});
+			return;
+		}
+		compiler.hooks.afterEmit.tapPromise(PLUGIN_NAME, async (compilation) => {
+			if (compilation.errors && compilation.errors.length > 0) return;
+			await this.uploadOnce(compiler, compilation, sourcemap);
+		});
+	}
+	/** 把浏览器 SDK 以 inline script 注入 HTML 产物。 */
+	installInlineScript(compiler, script) {
+		var _compiler$webpack;
+		const code = require_run.buildInlineScript(this.options);
+		if (!code) return;
+		const inject = (compilation) => {
+			try {
+				this.injectInlineAssets(compilation, code, script.nonce, compiler);
+			} catch (error) {
+				console.warn(`[firefly] 内联 SDK 注入失败：${error instanceof Error ? error.message : String(error)}`);
+			}
+		};
+		if (compiler.hooks.compilation && ((_compiler$webpack = compiler.webpack) === null || _compiler$webpack === void 0 || (_compiler$webpack = _compiler$webpack.Compilation) === null || _compiler$webpack === void 0 ? void 0 : _compiler$webpack.PROCESS_ASSETS_STAGE_REPORT) !== void 0) {
+			compiler.hooks.compilation.tap(PLUGIN_NAME, (compilation) => {
+				var _compilation$hooks, _compiler$webpack2;
+				(_compilation$hooks = compilation.hooks) === null || _compilation$hooks === void 0 || (_compilation$hooks = _compilation$hooks.processAssets) === null || _compilation$hooks === void 0 || _compilation$hooks.tap({
+					name: `${PLUGIN_NAME}:inline-script`,
+					stage: (_compiler$webpack2 = compiler.webpack) === null || _compiler$webpack2 === void 0 || (_compiler$webpack2 = _compiler$webpack2.Compilation) === null || _compiler$webpack2 === void 0 ? void 0 : _compiler$webpack2.PROCESS_ASSETS_STAGE_REPORT
+				}, () => inject(compilation));
+			});
+			return;
+		}
+		if (!compiler.hooks.emit) {
+			console.warn("[firefly] 跳过内联 SDK：当前 webpack 没有 emit hook");
+			return;
+		}
+		compiler.hooks.emit.tapAsync({
+			name: `${PLUGIN_NAME}:inline-script`,
+			stage: 1e4
+		}, (compilation, callback) => {
+			inject(compilation);
+			callback();
+		});
+	}
+	/** 只修改 HTML asset；没有 HTML 时静默跳过（多 compiler 构建很常见）。 */
+	injectInlineAssets(compilation, code, nonce, compiler) {
+		const assets = compilation.assets;
+		if (!assets) return;
+		const htmlNames = Object.keys(assets).filter((name) => /\.html?$/i.test(name));
+		for (const name of htmlNames) {
+			const asset = assets[name];
+			if (!asset || typeof asset.source !== "function") continue;
+			const html = asset.source().toString();
+			const next = require_run.injectInlineScriptHtml(html, code, nonce);
+			if (next === html) continue;
+			const source = this.createAsset(next, compiler);
+			if (compilation.updateAsset) compilation.updateAsset(name, source);
+			else assets[name] = source;
+		}
+	}
+	/** 兼容 webpack 4 / 5 的 RawSource。 */
+	createAsset(content, compiler) {
+		var _compiler$webpack3;
+		const RawSource = (_compiler$webpack3 = compiler.webpack) === null || _compiler$webpack3 === void 0 || (_compiler$webpack3 = _compiler$webpack3.sources) === null || _compiler$webpack3 === void 0 ? void 0 : _compiler$webpack3.RawSource;
+		if (RawSource) return new RawSource(content);
+		return {
+			source: () => content,
+			size: () => Buffer.byteLength(content)
+		};
+	}
+	/** 同一个 build_id 在多个 compiler 之间只允许一个上传任务。 */
+	async uploadOnce(compiler, compilation, sourcemap) {
+		var _this$options$buildId, _this$options$release, _this$options$dist;
+		const buildId = (_this$options$buildId = this.options.buildId) === null || _this$options$buildId === void 0 ? void 0 : _this$options$buildId.trim();
+		const key = buildId ? `${(_this$options$release = this.options.release) !== null && _this$options$release !== void 0 ? _this$options$release : ""}\u0000${(_this$options$dist = this.options.dist) !== null && _this$options$dist !== void 0 ? _this$options$dist : ""}\u0000${buildId}` : "";
+		if (key) {
+			if (uploadedBuildIds.has(key)) return;
+			const running = uploadingBuildIds.get(key);
+			if (running) return running;
+		}
+		const task = (async () => {
+			await this.upload(compiler, compilation, sourcemap);
+			if (key) uploadedBuildIds.add(key);
+		})();
+		if (key) uploadingBuildIds.set(key, task);
+		try {
+			await task;
+		} finally {
+			if (key) uploadingBuildIds.delete(key);
+		}
+	}
+	async upload(compiler, compilation, sourcemap) {
+		var _compiler$options$con, _ref, _sourcemap$outDir, _compilation$outputOp, _compiler$options$out, _sourcemap$platform, _compiler$options$out2, _sourcemap$base, _sourcemap$sourceRoot;
+		const context = (_compiler$options$con = compiler.options.context) !== null && _compiler$options$con !== void 0 ? _compiler$options$con : process.cwd();
+		const rawOutDir = (_ref = (_sourcemap$outDir = sourcemap.outDir) !== null && _sourcemap$outDir !== void 0 ? _sourcemap$outDir : (_compilation$outputOp = compilation.outputOptions) === null || _compilation$outputOp === void 0 ? void 0 : _compilation$outputOp.path) !== null && _ref !== void 0 ? _ref : (_compiler$options$out = compiler.options.output) === null || _compiler$options$out === void 0 ? void 0 : _compiler$options$out.path;
+		if (!rawOutDir) {
+			if (sourcemap.log !== false) console.warn("[firefly] 跳过 sourcemap 上传：找不到 webpack output.path");
+			return;
+		}
+		const outDir = (0, node_path.resolve)(context, rawOutDir);
+		const platform = (_sourcemap$platform = sourcemap.platform) !== null && _sourcemap$platform !== void 0 ? _sourcemap$platform : process.env.UNI_PLATFORM;
+		const mapDirs = [
+			sourcemap.mapDir,
+			platform ? (0, node_path.resolve)(outDir, "..", ".sourcemap", platform) : "",
+			outDir
+		].filter((value) => Boolean(value));
+		const publicPath = (_compiler$options$out2 = compiler.options.output) === null || _compiler$options$out2 === void 0 ? void 0 : _compiler$options$out2.publicPath;
+		const base = (_sourcemap$base = sourcemap.base) !== null && _sourcemap$base !== void 0 ? _sourcemap$base : typeof publicPath === "string" ? publicPath : void 0;
+		await require_run.runSourcemapUpload({
+			options: this.options,
+			sourcemap,
+			outDir,
+			mapDirs,
+			base,
+			mode: compiler.options.mode,
+			isWatch: compiler.watchMode === true,
+			context,
+			sourceRoot: (_sourcemap$sourceRoot = sourcemap.sourceRoot) !== null && _sourcemap$sourceRoot !== void 0 ? _sourcemap$sourceRoot : context
+		});
+	}
+};
+/**
+* 创建 webpack 插件。
+*
+* 用法：
+* ```js
+* const { fireflyWebpack } = require('@fz-firefly/unplugin/webpack')
+* plugins: [fireflyWebpack({ endpoint, release, dist, sourcemap: { token } })]
+* ```
+*/
+function fireflyWebpack(options = {}) {
+	if (options.sourcemap && options.sourcemap.generate) process.env.SOURCEMAP = "true";
+	return new FireflyWebpackPlugin(options);
+}
+exports.FireflyWebpackPlugin = FireflyWebpackPlugin;
+exports.default = fireflyWebpack;
+exports.fireflyWebpack = fireflyWebpack;
+
+//# sourceMappingURL=webpack.cjs.map

package/dist/webpack.d.cts

@@ -0,0 +1,91 @@
+import { a as FireflyWebpackOptions } from "./options-Dn99v-iv.cjs";
+interface WebpackOutputLike {
+  path?: string;
+  publicPath?: string | ((...args: unknown[]) => string);
+}
+interface WebpackCompilerLike {
+  options: {
+    output?: WebpackOutputLike;
+    mode?: string;
+    devtool?: string | false;
+    context?: string;
+  };
+  webpack?: {
+    sources?: {
+      RawSource?: new (value: string) => unknown;
+    };
+    Compilation?: {
+      PROCESS_ASSETS_STAGE_REPORT?: number;
+    };
+  };
+  hooks: {
+    afterEmit: {
+      tapPromise(name: string, handler: (compilation: WebpackCompilationLike) => Promise<void>): void;
+    };
+    compilation?: {
+      tap(name: string, handler: (compilation: WebpackCompilationLike) => void): void;
+    };
+    emit?: {
+      tapAsync(options: {
+        name: string;
+        stage?: number;
+      }, handler: (compilation: WebpackCompilationLike, callback: (error?: Error | null) => void) => void): void;
+    };
+    shutdown?: {
+      tapPromise(name: string, handler: () => Promise<void>): void;
+    };
+  };
+  watchMode?: boolean;
+}
+interface WebpackAssetLike {
+  source(): string | Buffer;
+  size?(): number;
+}
+interface WebpackCompilationLike {
+  errors?: unknown[];
+  assets?: Record<string, WebpackAssetLike>;
+  outputOptions?: {
+    path?: string;
+  };
+  hooks?: {
+    processAssets?: {
+      tap(options: {
+        name: string;
+        stage?: number;
+      }, handler: (assets: Record<string, WebpackAssetLike>) => void): void;
+    };
+  };
+  updateAsset?: (name: string, source: unknown) => void;
+}
+/**
+ * Firefly webpack 插件。
+ *
+ * 兼容 webpack 4 / 5：只依赖 compiler.options 和 afterEmit hook，
+ * 不直接 import webpack，避免不同版本的类型冲突。
+ */
+export declare class FireflyWebpackPlugin {
+  private readonly options;
+  constructor(options?: FireflyWebpackOptions);
+  apply(compiler: WebpackCompilerLike): void;
+  /** 把浏览器 SDK 以 inline script 注入 HTML 产物。 */
+  private installInlineScript;
+  /** 只修改 HTML asset；没有 HTML 时静默跳过（多 compiler 构建很常见）。 */
+  private injectInlineAssets;
+  /** 兼容 webpack 4 / 5 的 RawSource。 */
+  private createAsset;
+  /** 同一个 build_id 在多个 compiler 之间只允许一个上传任务。 */
+  private uploadOnce;
+  private upload;
+}
+/**
+ * 创建 webpack 插件。
+ *
+ * 用法：
+ * ```js
+ * const { fireflyWebpack } = require('@fz-firefly/unplugin/webpack')
+ * plugins: [fireflyWebpack({ endpoint, release, dist, sourcemap: { token } })]
+ * ```
+ */
+export declare function fireflyWebpack(options?: FireflyWebpackOptions): FireflyWebpackPlugin;
+export { fireflyWebpack as default };
+//# sourceMappingURL=webpack.d.cts.map

package/dist/webpack.d.ts

@@ -0,0 +1,91 @@
+import { a as FireflyWebpackOptions } from "./options-Dn99v-iv.js";
+interface WebpackOutputLike {
+  path?: string;
+  publicPath?: string | ((...args: unknown[]) => string);
+}
+interface WebpackCompilerLike {
+  options: {
+    output?: WebpackOutputLike;
+    mode?: string;
+    devtool?: string | false;
+    context?: string;
+  };
+  webpack?: {
+    sources?: {
+      RawSource?: new (value: string) => unknown;
+    };
+    Compilation?: {
+      PROCESS_ASSETS_STAGE_REPORT?: number;
+    };
+  };
+  hooks: {
+    afterEmit: {
+      tapPromise(name: string, handler: (compilation: WebpackCompilationLike) => Promise<void>): void;
+    };
+    compilation?: {
+      tap(name: string, handler: (compilation: WebpackCompilationLike) => void): void;
+    };
+    emit?: {
+      tapAsync(options: {
+        name: string;
+        stage?: number;
+      }, handler: (compilation: WebpackCompilationLike, callback: (error?: Error | null) => void) => void): void;
+    };
+    shutdown?: {
+      tapPromise(name: string, handler: () => Promise<void>): void;
+    };
+  };
+  watchMode?: boolean;
+}
+interface WebpackAssetLike {
+  source(): string | Buffer;
+  size?(): number;
+}
+interface WebpackCompilationLike {
+  errors?: unknown[];
+  assets?: Record<string, WebpackAssetLike>;
+  outputOptions?: {
+    path?: string;
+  };
+  hooks?: {
+    processAssets?: {
+      tap(options: {
+        name: string;
+        stage?: number;
+      }, handler: (assets: Record<string, WebpackAssetLike>) => void): void;
+    };
+  };
+  updateAsset?: (name: string, source: unknown) => void;
+}
+/**
+ * Firefly webpack 插件。
+ *
+ * 兼容 webpack 4 / 5：只依赖 compiler.options 和 afterEmit hook，
+ * 不直接 import webpack，避免不同版本的类型冲突。
+ */
+export declare class FireflyWebpackPlugin {
+  private readonly options;
+  constructor(options?: FireflyWebpackOptions);
+  apply(compiler: WebpackCompilerLike): void;
+  /** 把浏览器 SDK 以 inline script 注入 HTML 产物。 */
+  private installInlineScript;
+  /** 只修改 HTML asset；没有 HTML 时静默跳过（多 compiler 构建很常见）。 */
+  private injectInlineAssets;
+  /** 兼容 webpack 4 / 5 的 RawSource。 */
+  private createAsset;
+  /** 同一个 build_id 在多个 compiler 之间只允许一个上传任务。 */
+  private uploadOnce;
+  private upload;
+}
+/**
+ * 创建 webpack 插件。
+ *
+ * 用法：
+ * ```js
+ * const { fireflyWebpack } = require('@fz-firefly/unplugin/webpack')
+ * plugins: [fireflyWebpack({ endpoint, release, dist, sourcemap: { token } })]
+ * ```
+ */
+export declare function fireflyWebpack(options?: FireflyWebpackOptions): FireflyWebpackPlugin;
+export { fireflyWebpack as default };
+//# sourceMappingURL=webpack.d.ts.map

package/dist/webpack.js

@@ -0,0 +1,164 @@
+import { n as buildInlineScript, r as injectInlineScriptHtml, t as runSourcemapUpload } from "./run-C7OeN-YM.js";
+import { resolve } from "node:path";
+// src/webpack.ts
+const PLUGIN_NAME = "FireflyWebpackPlugin";
+/** 同一个 build_id 只真正上传一次，避免 Taro 多 compiler 重复上传。 */
+const uploadedBuildIds = /* @__PURE__ */ new Set();
+const uploadingBuildIds = /* @__PURE__ */ new Map();
+/**
+* Firefly webpack 插件。
+*
+* 兼容 webpack 4 / 5：只依赖 compiler.options 和 afterEmit hook，
+* 不直接 import webpack，避免不同版本的类型冲突。
+*/
+var FireflyWebpackPlugin = class {
+	constructor(options = {}) {
+		this.options = options;
+	}
+	apply(compiler) {
+		var _this$options$sourcem;
+		if (this.options.script) this.installInlineScript(compiler, this.options.script);
+		const sourcemap = this.options.sourcemap === false ? null : (_this$options$sourcem = this.options.sourcemap) !== null && _this$options$sourcem !== void 0 ? _this$options$sourcem : null;
+		if (sourcemap === null || sourcemap === void 0 ? void 0 : sourcemap.generate) {
+			process.env.SOURCEMAP = "true";
+			if (!compiler.options.devtool) compiler.options.devtool = "source-map";
+		}
+		if (!sourcemap) return;
+		if (Boolean(process.env.TARO_ENV) && compiler.hooks.shutdown) {
+			compiler.hooks.shutdown.tapPromise(PLUGIN_NAME, async () => {
+				await this.uploadOnce(compiler, {}, sourcemap);
+			});
+			return;
+		}
+		compiler.hooks.afterEmit.tapPromise(PLUGIN_NAME, async (compilation) => {
+			if (compilation.errors && compilation.errors.length > 0) return;
+			await this.uploadOnce(compiler, compilation, sourcemap);
+		});
+	}
+	/** 把浏览器 SDK 以 inline script 注入 HTML 产物。 */
+	installInlineScript(compiler, script) {
+		var _compiler$webpack;
+		const code = buildInlineScript(this.options);
+		if (!code) return;
+		const inject = (compilation) => {
+			try {
+				this.injectInlineAssets(compilation, code, script.nonce, compiler);
+			} catch (error) {
+				console.warn(`[firefly] 内联 SDK 注入失败：${error instanceof Error ? error.message : String(error)}`);
+			}
+		};
+		if (compiler.hooks.compilation && ((_compiler$webpack = compiler.webpack) === null || _compiler$webpack === void 0 || (_compiler$webpack = _compiler$webpack.Compilation) === null || _compiler$webpack === void 0 ? void 0 : _compiler$webpack.PROCESS_ASSETS_STAGE_REPORT) !== void 0) {
+			compiler.hooks.compilation.tap(PLUGIN_NAME, (compilation) => {
+				var _compilation$hooks, _compiler$webpack2;
+				(_compilation$hooks = compilation.hooks) === null || _compilation$hooks === void 0 || (_compilation$hooks = _compilation$hooks.processAssets) === null || _compilation$hooks === void 0 || _compilation$hooks.tap({
+					name: `${PLUGIN_NAME}:inline-script`,
+					stage: (_compiler$webpack2 = compiler.webpack) === null || _compiler$webpack2 === void 0 || (_compiler$webpack2 = _compiler$webpack2.Compilation) === null || _compiler$webpack2 === void 0 ? void 0 : _compiler$webpack2.PROCESS_ASSETS_STAGE_REPORT
+				}, () => inject(compilation));
+			});
+			return;
+		}
+		if (!compiler.hooks.emit) {
+			console.warn("[firefly] 跳过内联 SDK：当前 webpack 没有 emit hook");
+			return;
+		}
+		compiler.hooks.emit.tapAsync({
+			name: `${PLUGIN_NAME}:inline-script`,
+			stage: 1e4
+		}, (compilation, callback) => {
+			inject(compilation);
+			callback();
+		});
+	}
+	/** 只修改 HTML asset；没有 HTML 时静默跳过（多 compiler 构建很常见）。 */
+	injectInlineAssets(compilation, code, nonce, compiler) {
+		const assets = compilation.assets;
+		if (!assets) return;
+		const htmlNames = Object.keys(assets).filter((name) => /\.html?$/i.test(name));
+		for (const name of htmlNames) {
+			const asset = assets[name];
+			if (!asset || typeof asset.source !== "function") continue;
+			const html = asset.source().toString();
+			const next = injectInlineScriptHtml(html, code, nonce);
+			if (next === html) continue;
+			const source = this.createAsset(next, compiler);
+			if (compilation.updateAsset) compilation.updateAsset(name, source);
+			else assets[name] = source;
+		}
+	}
+	/** 兼容 webpack 4 / 5 的 RawSource。 */
+	createAsset(content, compiler) {
+		var _compiler$webpack3;
+		const RawSource = (_compiler$webpack3 = compiler.webpack) === null || _compiler$webpack3 === void 0 || (_compiler$webpack3 = _compiler$webpack3.sources) === null || _compiler$webpack3 === void 0 ? void 0 : _compiler$webpack3.RawSource;
+		if (RawSource) return new RawSource(content);
+		return {
+			source: () => content,
+			size: () => Buffer.byteLength(content)
+		};
+	}
+	/** 同一个 build_id 在多个 compiler 之间只允许一个上传任务。 */
+	async uploadOnce(compiler, compilation, sourcemap) {
+		var _this$options$buildId, _this$options$release, _this$options$dist;
+		const buildId = (_this$options$buildId = this.options.buildId) === null || _this$options$buildId === void 0 ? void 0 : _this$options$buildId.trim();
+		const key = buildId ? `${(_this$options$release = this.options.release) !== null && _this$options$release !== void 0 ? _this$options$release : ""}\u0000${(_this$options$dist = this.options.dist) !== null && _this$options$dist !== void 0 ? _this$options$dist : ""}\u0000${buildId}` : "";
+		if (key) {
+			if (uploadedBuildIds.has(key)) return;
+			const running = uploadingBuildIds.get(key);
+			if (running) return running;
+		}
+		const task = (async () => {
+			await this.upload(compiler, compilation, sourcemap);
+			if (key) uploadedBuildIds.add(key);
+		})();
+		if (key) uploadingBuildIds.set(key, task);
+		try {
+			await task;
+		} finally {
+			if (key) uploadingBuildIds.delete(key);
+		}
+	}
+	async upload(compiler, compilation, sourcemap) {
+		var _compiler$options$con, _ref, _sourcemap$outDir, _compilation$outputOp, _compiler$options$out, _sourcemap$platform, _compiler$options$out2, _sourcemap$base, _sourcemap$sourceRoot;
+		const context = (_compiler$options$con = compiler.options.context) !== null && _compiler$options$con !== void 0 ? _compiler$options$con : process.cwd();
+		const rawOutDir = (_ref = (_sourcemap$outDir = sourcemap.outDir) !== null && _sourcemap$outDir !== void 0 ? _sourcemap$outDir : (_compilation$outputOp = compilation.outputOptions) === null || _compilation$outputOp === void 0 ? void 0 : _compilation$outputOp.path) !== null && _ref !== void 0 ? _ref : (_compiler$options$out = compiler.options.output) === null || _compiler$options$out === void 0 ? void 0 : _compiler$options$out.path;
+		if (!rawOutDir) {
+			if (sourcemap.log !== false) console.warn("[firefly] 跳过 sourcemap 上传：找不到 webpack output.path");
+			return;
+		}
+		const outDir = resolve(context, rawOutDir);
+		const platform = (_sourcemap$platform = sourcemap.platform) !== null && _sourcemap$platform !== void 0 ? _sourcemap$platform : process.env.UNI_PLATFORM;
+		const mapDirs = [
+			sourcemap.mapDir,
+			platform ? resolve(outDir, "..", ".sourcemap", platform) : "",
+			outDir
+		].filter((value) => Boolean(value));
+		const publicPath = (_compiler$options$out2 = compiler.options.output) === null || _compiler$options$out2 === void 0 ? void 0 : _compiler$options$out2.publicPath;
+		const base = (_sourcemap$base = sourcemap.base) !== null && _sourcemap$base !== void 0 ? _sourcemap$base : typeof publicPath === "string" ? publicPath : void 0;
+		await runSourcemapUpload({
+			options: this.options,
+			sourcemap,
+			outDir,
+			mapDirs,
+			base,
+			mode: compiler.options.mode,
+			isWatch: compiler.watchMode === true,
+			context,
+			sourceRoot: (_sourcemap$sourceRoot = sourcemap.sourceRoot) !== null && _sourcemap$sourceRoot !== void 0 ? _sourcemap$sourceRoot : context
+		});
+	}
+};
+/**
+* 创建 webpack 插件。
+*
+* 用法：
+* ```js
+* const { fireflyWebpack } = require('@fz-firefly/unplugin/webpack')
+* plugins: [fireflyWebpack({ endpoint, release, dist, sourcemap: { token } })]
+* ```
+*/
+function fireflyWebpack(options = {}) {
+	if (options.sourcemap && options.sourcemap.generate) process.env.SOURCEMAP = "true";
+	return new FireflyWebpackPlugin(options);
+}
+export { FireflyWebpackPlugin, fireflyWebpack as default, fireflyWebpack };
+
+//# sourceMappingURL=webpack.js.map

package/package.json

@@ -1,6 +1,59 @@
 {
   "name": "@fz-firefly/unplugin",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.1",
+  "description": "萤火虫 SDK 的构建插件：webpack 4/5 source map 生成开关、扫描与自动上传。",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./webpack": {
+      "types": "./dist/webpack.d.ts",
+      "import": "./dist/webpack.js",
+      "require": "./dist/webpack.cjs"
+    },
+    "./vite": {
+      "types": "./dist/vite.d.ts",
+      "import": "./dist/vite.js",
+      "require": "./dist/vite.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.map"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "vite": ">=4",
+    "webpack": ">=4"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    },
+    "webpack": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsdown": "0.23.2",
+    "typescript": "^5.6.0",
+    "vite": "^8.0.0",
+    "vitest": "^5.0.5",
+    "webpack": "^5.0.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
 }