[johnnyeric]

Summary

Add an unused enqueueUsage helper that sends the complete shared usage event to the authenticated usage-ingest endpoint. Missing endpoint or dedicated publisher secret returns disabled without network activity. A single request has a two-second timeout; only HTTP 202 returns accepted. Failures report only the usage ID and a categorical reason.

Verification

• Called the helper with synthetic data against the actual locally configured Worker; received HTTP 202 and one local queue receipt with an identical payload and ID.
• Called the helper with configuration absent; observed disabled, zero network calls and no additional queue receipt. Closed the fixture and confirmed its port was released.

Visual Changes

N/A

Reviewer Notes

The helper has no gateway callers. Queue acceptance does not establish billing completion; this change adds no consumer or inference/billing integration.

Validation: 12 focused Jest cases, shared-package and gateway typechecks, scoped type-aware lint, formatting and diff checks. Cases cover dedicated authentication, exact payload preservation, missing/malformed configuration, non-202 responses, a real stalled HTTP request and rejected response-body cleanup. Failure logs require exactly one safe warning; negative controls adding URL/secret warnings on HTTP refusal or timeout fail the tests.

[kilo-code-bot]

Code Review Summary

Status: No Issues Found | Recommendation: Merge

Files Reviewed (4 files)

• ENVIRONMENT.md
• packages/web-shared/src/lib/ai-gateway/usage-publisher.test.ts
• packages/web-shared/src/lib/ai-gateway/usage-publisher.ts
• packages/web-shared/src/lib/config.server.ts

---

_{Reviewed by deepseek-v4.1-flash · Input: 71K · Output: 17.7K · Cached: 738K}

_{Review guidance: REVIEW.md from base branch main}