@flareapp/core

中文文档

2.13.0发布于 2026/09/17MITTypeScriptESM + CJS近 30 天下载 3.4万

Environment-agnostic core for the Flare JS SDK

@flareapp/core

Environment-agnostic core for the Flare JavaScript SDK. Most users want @flareapp/js (browser) or @flareapp/node (Node.js servers). This package is the shared base that both consume.

Public and stable, versioned in lockstep with @flareapp/js (2.x). Intended for third-party Flare integrators who need to build against the same primitives the official SDKs use.

Surface

Flare — the core class. Takes three optional injection points: ScopeProvider, ContextCollector, FileReader.
Logger — structured logging (flare.logger). Eight syslog levels, opt-in via enableLogs; owns the log buffer, batching policy, and OTel envelope. A FlushScheduler seam is injected per platform.
Scope, GlobalScopeProvider, ScopeProvider — per-call mutable state.
FileReader, NullFileReader — source-snippet reading abstraction.
Api — the HTTP client used to send reports and logs.
Types: Config, Report, Attributes, Glow, StackFrame, etc.
Util: redactUrlQuery, resolveDenylist, convertToError, DEFAULT_URL_DENYLIST.

See docs/superpowers/specs/2026-05-28-nodejs-sdk-design.md in the monorepo for the architectural contract.

版本与发布记录

@flareapp/core 共发布 16 个版本，首次发布于 2026/06/02；过去 12 个月发布了 16 个版本。

版本	发布日期	距今
`2.13.0`latest	2026/09/17	1 个月前
`2.12.2`	2026/09/14	2 个月前
`2.12.1`	2026/09/11	2 个月前
`2.12.0`	2026/09/02	2 个月前
`2.11.0`	2026/08/27	2 个月前
`2.10.0`	2026/08/26	2 个月前

关于 @flareapp/core 的常见问题

@flareapp/core 是什么？

Environment-agnostic core for the Flare JS SDK

如何安装 @flareapp/core？

在项目目录运行 npm install @flareapp/core，或使用 pnpm add / yarn add / bun add。

@flareapp/core 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

@flareapp/core 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require() 都可以使用，打包工具会自动选择合适的版本。

@flareapp/core 可以商用吗？

@flareapp/core 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

@flareapp/core 的下载量有多少？

根据 npm 官方下载统计，@flareapp/core 在 2026/10/15 – 2026/11/13 这 30 天内被下载 34,217 次，日均约 1,141 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

@flareapp/core 还在维护吗？

最新版本 2.13.0 发布于 2026/09/17（1 个月前）；至今共发布 16 个版本，其中过去 12 个月发布了 16 个；首次发布于 2026/06/02。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。