Skip to content
Burrow0.1.0

Burrow

Cloudflare Artifacts repositories and Git transport, configured by your host with explicit metadata and token cleanup.

QuickstartAPI reference
  • @fungi.computer/burrow
  • v0.1.0
  • MIT

Fastest path

  1. Install

    Add it to your project with npm, pnpm, Yarn or Bun.

    TERMINAL
    npm install @fungi.computer/burrow

  2. List repositories through a local provider

    Use the REST namespace with a fake provider; no Cloudflare request or credential leaves the example.

    home.ts
    import { createArtifactsRestNamespace } from "@fungi.computer/burrow";
    

    // Local provider fixture: this example never contacts Cloudflare.
    const namespace = createArtifactsRestNamespace({
      accountId: "example-account",
      namespace: "default",
      apiToken: "example-only",
      fetch: async () =>
        Response.json({
          success: true,
          errors: [],
          result: [
            {
              id: "repository-notes",
              name: "notes",
              default_branch: "main",
              remote:
                "https://example.artifacts.cloudflare.net/git/default/notes.git",
              status: "ready",
            },
          ],
          result_info: { total_pages: 1, total_count: 1 },
        }),
    });
    

    const { repos } = await namespace.list();
    console.log(repos.map((repository) => repository.name)); // ["notes"]