@blyp/core

中文文档

0.1.36发布于 2026/10/23MITTypeScriptESM + CJS构建来源已验证近 30 天下载 1931

一个具有 Bun-First 运行时间检测和 TypeScript 支持的高性能,模块化的日志器. 建于皮诺上,并支援了爱丽西亚,浩诺,快通,快通,雀巢JS,Next.js App路由器,Farm.js,React路由器,Astro,Nitro,Nuxt,TanStack Start,SolidStart,和S

文档目录15 节

要点
安装
快开始
结构化日志
框架实例
农场.js
更好的认证
办事员
更多特性
文档
发展
许可证
无存储摄入量
操作连接器可靠性
S3 存储

布莱普·洛格

布莱普 是一个独立的应用程序和现代网络框架的 TypeScript 日志 . 它给你结构化的日志,框架适配器,客户端对服务器日志摄取,以及可选的连接器,而不将根的README变成完整的手册.

要点

在独立的应用程序中或与框架适配器一起使用.
使用 createStructuredLog。。。 .
在日志到达输出或下游汇之前修改共同的秘密.
从浏览器和博览会的应用程序进入您的后端流的浏览日志 .
将日志转发给可选的连接器,如"新遗物","后霍格","更好的堆栈","哨兵","Databuddy",命名为"HTTP端点","OTLP"等目标.
为 Bun- first 设置所建,支持支持的节点运行时间 .
完整 TypeScript 支持整个主包和子路径导出.

安装

bun add @blyp/core

npm install @blyp/core | pnpm add @blyp/core | yarn add @blyp/core

如果您使用 Expo 日志, 请同时安装 expo-network。。。 .

npx expo install expo-network

快开始

import { logger } from '@blyp/core';

logger.info('Server started', { port: 3000 });
logger.success('Connected to database');
logger.error('Payment failed', { orderId: 'ord_123' });

结构化日志

import { createStructuredLog } from '@blyp/core';

const log = createStructuredLog('checkout', {
  service: 'web-api',
  level: 'info',
  timestamp: new Date().toISOString(),
});

log.set({
  user: { id: 1, plan: 'pro' },
  cart: { items: 3, total: 9999 },
});

log.info('checkout started');
log.emit({ status: 200 });

内部框架处理器, createStructuredLog(...) 自动绑定在活动请求日志中。最终结构化记录在调用时被写入 .emit()。。。 .

框架实例

Blyp支持Elysia,Hono,快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活快活活快活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活.

import { Elysia } from 'elysia';
import { createLogger } from '@blyp/core/elysia';

const app = new Elysia()
  .use(createLogger({ level: 'info', autoLogging: true }))
  .get('/', () => 'Hello World')
  .listen(3000);

见框架集成文件用于完整的适配器矩阵和特定框架实例.

农场.js

// farm.config.ts
import { defineConfig } from '@farm.js/core';
import { blypPlugin } from '@blyp/core/farmjs';

export default defineConfig({
  plugins: [blypPlugin()],
});

// src/app/api/products/route.ts
import { logger } from '@blyp/core/farmjs';

export async function GET() {
  logger.info('loaded products');
  return Response.json({ ok: true });
}

该插件会自动记录请求,出错,选定的Farm生命周期事件,浏览器导航和性能遥测,浏览器出错等. 它目前支持Farm的节点和Bun服务器运行时间.

更好的认证

更好的Auth可以作为真正的Better Auth插件被附加,然后被Blip框架适配器再用来请求浓缩.

import { betterAuth } from 'better-auth';
import { blyp } from '@blyp/core/better-auth';

export const auth = betterAuth({
  plugins: [
    blyp({
      clientLogging: true,
    }),
  ],
});

import { createLogger } from '@blyp/core/nextjs';
import { auth } from './auth';

export const nextLogger = createLogger({
  auth: {
    betterAuth: auth,
  },
});

import { createAuthClient } from 'better-auth/client';
import { blypClient } from '@blyp/core/better-auth';

export const authClient = createAuthClient({
  plugins: [blypClient()],
});

const logger = authClient.blyp.createLogger();
logger.info('mounted');

办事员

办事员通过布莱普共享的服务器认证配置而不是插件进行集成. Blyp 用 @clerk/backend,使每个服务器日志记录上的认证状态正常化,并在客户端登录者将浏览器日志身份发布到 Blip 端点时从服务器上获取 /blyp/log。。。 .

import { clerk, createClerkClientLogger } from '@blyp/core/clerk';
import { createLogger } from '@blyp/core/nextjs';

export const nextLogger = createLogger({
  auth: {
    clerk: clerk({
      secretKey: process.env.CLERK_SECRET_KEY!,
      publishableKey: process.env.NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY!,
      jwtKey: process.env.CLERK_JWT_KEY,
      authorizedParties: ['https://app.example.com'],
    }),
  },
  clientLogging: {
    path: '/blyp/log',
  },
});

export const clientLogger = createClerkClientLogger({
  endpoint: '/blyp/log',
});

见全员集成文件用于 Next.js, Express, React Router, 以及机器认证的示例.

文档

发展

bun install
bun run test
bun run build
bun run type-check

许可证

麻省理工学院

无存储摄入量

使用 destination: 'none' 来通过启用的连接器或OTLP转发日志,而无需本地日志文件、数据库存储或磁盘队列。需要至少一个已配置的连接器,摄入的客户端日志必须选择一个已准备好的目标. 见配置和客户端示例。。。 .

操作连接器可靠性

见霍格后/哨兵合同, (中文(简体) ), 公布的一揽子调查,以及 CarsXE 迁移实例用于结构化错误,核实身份,最后的负载隐私,有界限的冲洗和无持久性操作. 运行 npm run test:packed-connectors 在孤立的Node CommunityJS/ESM应用程序中验证装有真实SDK的打包包.

S3 存储

设定 destination: 's3' 在 AWS S3 、 Cloudflare R2 或 MinIO 中存储压缩日志批次,并在 Studio 中浏览,并明确允许阅读。内存缓冲是默认的;持久的SQLite spolling是可选的. 见 S3 存储和工作室用于配置、权限、恢复和提供者验证状态.

版本与发布记录

@blyp/core 共发布 15 个版本，首次发布于 2026/03/17；过去 12 个月发布了 15 个版本。最新版本附带 npm provenance 构建来源证明，可追溯到公开的 CI 构建记录。

版本	发布日期	距今
`0.1.36`latest	2026/10/23	16 天前
`0.1.35`	2026/10/22	17 天前
`0.1.34`	2026/10/19	20 天前
`0.1.32`	2026/10/14	25 天前
`0.1.31`	2026/10/13	26 天前
`0.1.30`	2026/08/29	2 个月前

关于 @blyp/core 的常见问题

@blyp/core 是什么？

如何安装 @blyp/core？

在项目目录运行 npm install @blyp/core，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：typescript（^5）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

@blyp/core 支持 TypeScript 吗？

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

@blyp/core 支持 ESM 还是 CommonJS？

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

@blyp/core 可以商用吗？

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

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

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

@blyp/core 还在维护吗？

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

npm install @blyp/core

pnpmpnpm add @blyp/core
yarnyarn add @blyp/core
bunbun add @blyp/core

peer 依赖ai ^6 || ^7可选eve ~0.80.1可选hono ^4可选next ^15 || ^16可选nuxt ^4可选rxjs ^7可选astro ^6可选agents ~0.30.0可选convex >=1.39.0可选elysia ^1.4.27可选express ^5可选fastify ^5可选nitropack ^2可选typescript ^5better-auth ^1.6.5可选drizzle-orm ^0.36 || ^0.37 || ^0.38 || ^0.39 || ^0.40可选@nestjs/core ^10 || ^11可选@sentry/node ^10可选posthog-node ^5可选react-router ^7可选@farm.js/core >=0.1.0-beta.40 <0.2.0可选@logtail/node ^0.5可选@sveltejs/kit ^2可选@clerk/backend ^2可选@databuddy/sdk ^2可选@nestjs/common ^10 || ^11可选@prisma/client ^5 || ^6可选@solidjs/start ^1可选@workos-inc/node ^7可选@aws-sdk/client-s3 ^3.1155.0可选@better-agent/core ^0.1.0-beta.1可选@opentelemetry/api ^1可选@opentelemetry/core ^2可选@tanstack/react-start ^1可选@newrelic/browser-agent ^1可选@opentelemetry/api-logs ^0.206可选@opentelemetry/sdk-logs ^0.206可选@nestjs/platform-express ^10 || ^11可选@nestjs/platform-fastify ^10 || ^11可选@opentelemetry/resources ^2可选@opentelemetry/sdk-metrics ^2可选newrelic-react-native-agent ^1可选@opentelemetry/sdk-trace-base ^2可选@opentelemetry/sdk-trace-node ^2可选@opentelemetry/otlp-transformer 0.206.0可选@opentelemetry/context-async-hooks ^2可选@opentelemetry/exporter-logs-otlp-http ^0.206可选@opentelemetry/exporter-logs-otlp-proto ^0.206可选@opentelemetry/exporter-trace-otlp-proto ^0.206可选@opentelemetry/exporter-metrics-otlp-proto ^0.206可选

npm 7+ 与 pnpm 8+ 会自动安装必需的 peer 依赖，Yarn 需手动安装。

在你的项目目录中运行此命令。

近 30 天下载

1,931

约 1931 次日均 64 次

统计周期 2026/10/09 – 2026/11/07
数据来自 npm 官方下载统计，今天更新

最新版本0.1.36发布于 16 天前

开源许可MIT宽松许可

包体积7.4 MB336 个文件 · 解压后

运行依赖5 个另有 50 个 peer 依赖

模块格式ESM + CJS

TypeScript自带类型

发布版本15 个近 12 个月 15 个

首次发布2026/03/177 个月前

元数据更新2026/10/23

每一个软件包背后，
都有分享与创造的人。