@avirajkhare/agent-commerce-bridge

Paperclip plugin: Commerce console (tenant, Paperclip bridge, wallets, intents) + sidebar + dashboard widget; worker proxies /v1/* on your Commerce origin and GET …/v1/paperclip/ping for health.

Install (Paperclip board)

Plugins → Install → package name:

@avirajkhare/agent-commerce-bridge

Or local path to this directory after pnpm build (absolute path on the server).

Then set instance config: commerce_api_base_url, commerce_tenant_api_key.

For http://127.0.0.1:… (or other private IPs): Paperclip blocks plugin outbound HTTP to private ranges except in local_trusted deployment mode (default local dev). In authenticated mode, set PAPERCLIP_PLUGIN_HTTP_ALLOW_PRIVATE_TARGETS=true on the server if you need a local Commerce URL.

Stable plugin id: avirajkhare.agent-commerce-bridge.

Develop (monorepo)

pnpm --filter @avirajkhare/agent-commerce-bridge build
pnpm --filter @avirajkhare/agent-commerce-bridge test

Publish to npm (scope @avirajkhare)

From repo root:

pnpm install
pnpm --filter @avirajkhare/agent-commerce-bridge build
pnpm --filter @avirajkhare/agent-commerce-bridge test
npm login
pnpm publish --filter @avirajkhare/agent-commerce-bridge --access public --no-git-checks

Prerequisites:

1. npm whoami shows you are logged in as a user who can publish @avirajkhare/* (create the org on npmjs.com or link the scope if first time).
2. Bump version in package.json before each new publish.

prepack runs pnpm run build so the published tarball always includes dist/worker.js. files is ["dist", "README.md"].

Build note: @paperclipai/plugin-sdk is a devDependency (worker/UI bundles do not require it at install time). Publish with pnpm publish --filter @avirajkhare/agent-commerce-bridge --access public --no-git-checks from the repo root after npm login.

Build options

• pnpm build — esbuild via @paperclipai/plugin-sdk/bundlers
• pnpm build:rollup — rollup preset