@fungi.computer/burrow

中文文档
0.2.1发布于 2026/11/04MITTypeScriptES Module近 30 天下载 4491

配置了 Artifacts 仓库和 Git 协议所有者

中文使用文档
文档目录5 节
  1. REST运输
  2. 安装
  3. 快速启动
  4. 包装消费者证明
  5. 实例

布尔

Burrow将Cloudflare艺术包装.

@fungi.computer/burrow 是 Cloudflare 的配置寄存器所有者 术相. 配置 createCloudflareArtifacts 与工人的约束和 位于工人边界的出版商拥有的存储库元数据存储. 呼叫者 获得稳定的存储器身份, 只可请求 Git 智能- HTTP git 使用的操作:上传包装和接收包装的广告和 交换。 适配器持续了返回的确切元数据 create() 财务报告和审定财务报表 fork() 之前 Git/ 头操作使用已保存的远程 。 它治疗 get() 作为不透明方法处理的结果。 每个确切创建或 分叉结果及其初始代号, 保存在 D1 记录中, 重复撤销 从该记录,然后只宣传元数据 之后,确切的符号是不 时间更长 待决行不作为寄存器解决;成功 升职可以洗刷标志 软件包从不返回符号或符号 URL (中文(简体) ). 重复的叉子只有在出版商录制后才能恢复目的地 它从精确模板中创建了叉; 一个已有的目的地 没有那个记录 关闭.

Cloudflare的创建/叉调和第一个D1写法不能是原子. 如果 提供商回来后工人就停工了 但在待决的行被执行之前, 存储器可以保留而不记录元数据,其初始符号可能 保持活动。 不透明 get() 处理无法恢复该结果。 适配器 未关闭; 恢复需要支持的提供者元数据恢复路径或 这包外加防守手动清理.

App身份和团队授权 留在出版商,App Release,和Hub. 此软件包没有源文件 API, 也不决定谁可以使用一个 仓库.

readRefs(name) 返回时,通过同样方式发布参考名称和对象ID 短命读取所有者 readBranchHeads(name)后者保留 用于源头检查的仅分支散列投影。 两者均撤销 表示成功或失败.

REST运输

createArtifactsRestNamespace({ accountId, namespace, apiToken, fetch? }) 提供无法使用 Workers 绑定的仅主机命名空间。 用这个 与 createCloudflareArtifacts 和同一仓库元数据存储。 牡蛎 使用此运算器进行安装瞄准镜的 Git 绑定; 它没有单独的 REST客户端. 安装许可检查仍在牡蛎体内.

资源 get(name) 只创建名称地址控件. info() 和所有其他国家 处理操作可以重新调用服务商; 没有存在、结果或权限 缓存。 元数据所有者在接受前明确检测懒手柄 仓库存在/准备状态.

REST控制飞机的证书留在运输舱内。 拒绝请求 重新定向和HTTP响应失败,即使其信封声称成功. 对于新建或防御的目的地,运输需要完整 以一个有效的符号上市,取消该符号的标识,并验证其 激活前已取消状态 。 模糊或失败的校验只删除 并拒绝启动。 现有仓库 拒绝永远不会进入清理; 叉源永远不会被移除 。 App - faccing (英语) 寄存器结果既不包含符号,也不包含认证的 URL .

REST创建/叉和撤销是独立的提供商业务. 一个过程 它们之间的相撞可以离开一个没有记录的目的地;它必须关闭 重放,就像一个没有记录的 工人约束的创作。 没有猜测 指向ID 编码器和不清理另一个寄存器的指向符 .

安装

包装的消费者证明 证明Burrow是牡蛎运行时间依赖. 运行证明不会发布 npm 发布 .

根项导出配置的Artiffacts适配器和仅主机 REST 名称空间. @fungi.computer/burrow/cloudflare 并输出 Cloudflare 适配器及其元数据存储类型.

快速启动

配置主机边界的提供者命名空间和元数据存储 :

import {
  createCloudflareArtifacts,
  type CloudflareArtifactsOptions,
} from "@fungi.computer/burrow";

export async function openRepository(options: CloudflareArtifactsOptions) {
  const artifacts = createCloudflareArtifacts(options);
  return artifacts.resolveRepository("notes");
}

提供的元数据存储必须执行待处理记录和激活 上述合同。 保留仓库证书和提供者远程 在主机的构成.

包装消费者证明

盖起Burrow后,就跑 pnpm --dir packages/burrow run stranger 从 仓库根。 维护的检查员核实了确切的柏油球库存, 装入新鲜的 npm 消费者, 运行本地的假提供行为 汇编严格节点Next和 skipLibCheck: false。 无需Cloudflare请求.

实例

当地供应商的例子 通过 createArtifactsRestNamespace 使用假取来运输。 它没有运行 提供者访问或外部证书。 在建造了Burrow之后,运行它与:

pnpm exec tsx packages/burrow/docs/home.ts

上面的包装消费者证明还行使存储器解析和 通过"根"和"Cloudflare"的切入点来读取托肯清理.

版本与发布记录

@fungi.computer/burrow 共发布 6 个版本,首次发布于 2026/10/15;过去 12 个月发布了 6 个版本。

版本发布日期距今
0.2.1latest2026/11/0412 天前
0.2.02026/10/3016 天前
0.1.02026/10/2323 天前
0.0.22026/10/1730 天前
0.0.12026/10/151 个月前
0.0.0-stage2026/10/151 个月前

关于 @fungi.computer/burrow 的常见问题

@fungi.computer/burrow 是什么?

配置了 Artifacts 仓库和 Git 协议所有者

如何安装 @fungi.computer/burrow?

在项目目录运行 npm install @fungi.computer/burrow,或使用 pnpm add / yarn add / bun add。

@fungi.computer/burrow 支持 TypeScript 吗?

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

@fungi.computer/burrow 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@fungi.computer/burrow 可以商用吗?

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

@fungi.computer/burrow 的下载量有多少?

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

@fungi.computer/burrow 还在维护吗?

最新版本 0.2.1 发布于 2026/11/04(12 天前);至今共发布 6 个版本,其中过去 12 个月发布了 6 个;首次发布于 2026/10/15。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。