autotel-cloudflare 2.17.0 → 2.17.1

package/bin/intent.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+// Auto-generated by @tanstack/intent setup
+// Exposes the intent end-user CLI for consumers of this library.
+// Commit this file, then add to your package.json:
+//   "bin": { "intent": "./bin/intent.js" }
+await import('@tanstack/intent/intent-library')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autotel-cloudflare",
-  "version": "2.17.0",
+  "version": "2.17.1",
   "description": "The #1 OpenTelemetry package for Cloudflare Workers - complete bindings coverage, native CF OTel integration, advanced sampling",
   "type": "module",
   "main": "./dist/index.js",
@@ -51,7 +51,10 @@
   "files": [
     "dist",
     "src",
-    "README.md"
+    "README.md",
+    "skills",
+    "!skills/_artifacts",
+    "bin"
   ],
   "keywords": [
     "opentelemetry",
@@ -72,16 +75,17 @@
   "license": "MIT",
   "dependencies": {
     "@opentelemetry/api": "^1.9.0",
-    "@opentelemetry/resources": "^2.5.1",
-    "autotel-edge": "3.15.0"
+    "@opentelemetry/resources": "^2.6.0",
+    "@tanstack/intent": "^0.0.13",
+    "autotel-edge": "3.15.1"
   },
   "peerDependencies": {
-    "@cloudflare/workers-types": "^4.20260302.0"
+    "@cloudflare/workers-types": "^4.20260307.1"
   },
   "devDependencies": {
-    "@cloudflare/workers-types": "^4.20260302.0",
-    "@opentelemetry/context-async-hooks": "^2.5.1",
-    "@types/node": "^25.3.3",
+    "@cloudflare/workers-types": "^4.20260307.1",
+    "@opentelemetry/context-async-hooks": "^2.6.0",
+    "@types/node": "^25.3.5",
     "rimraf": "^6.1.3",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
@@ -97,6 +101,9 @@
     "url": "https://github.com/jagreehal/autotel/issues"
   },
   "homepage": "https://github.com/jagreehal/autotel/tree/main/packages/autotel-cloudflare#readme",
+  "bin": {
+    "intent": "./bin/intent.js"
+  },
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",

package/skills/autotel-cloudflare/SKILL.md

@@ -0,0 +1,79 @@
+---
+name: autotel-cloudflare
+description: >
+  OpenTelemetry for Cloudflare Workers. Instrument handlers, bindings (KV, R2, D1, AI, Vectorize, Queues, Durable Objects), and global fetch/cache. Multiple API styles for compatibility.
+type: integration
+library: autotel-cloudflare
+library_version: "2.17.0"
+sources:
+  - jagreehal/autotel:packages/autotel-cloudflare/CLAUDE.md
+---
+
+# autotel-cloudflare
+
+Complete OpenTelemetry for Cloudflare Workers. Three API styles, full bindings coverage.
+
+## Quick Start — pick one style
+
+### Style 1: instrument() (recommended)
+
+```typescript
+import { instrument, instrumentKV } from 'autotel-cloudflare';
+
+export default instrument(
+  {
+    async fetch(req, env, ctx) {
+      const kv = instrumentKV(env.MY_KV, { name: 'my-kv' });
+      const val = await kv.get('key'); // traced automatically
+      return new Response(val);
+    },
+  },
+  { service: { name: 'my-worker' } },
+);
+```
+
+### Style 2: wrapModule()
+
+```typescript
+import { wrapModule } from 'autotel-cloudflare';
+
+export default wrapModule(
+  { service: { name: 'my-worker' } },
+  { async fetch(req, env, ctx) { return new Response('OK'); } },
+);
+```
+
+### Style 3: Functional (from autotel-edge)
+
+```typescript
+import { trace } from 'autotel-cloudflare';
+export default { fetch: trace(async (req) => new Response('OK')) };
+```
+
+## Bindings Instrumentation
+
+Every Cloudflare binding has a wrapper. Each creates spans for all operations.
+
+| Binding | Wrapper | Import |
+|---------|---------|--------|
+| KV | `instrumentKV(env.KV, { name })` | `autotel-cloudflare` or `/bindings` |
+| R2 | `instrumentR2(env.BUCKET, { name })` | same |
+| D1 | `instrumentD1(env.DB, { name })` | same |
+| Service Binding | `instrumentServiceBinding(env.SVC, { name })` | same |
+| Workers AI | `instrumentAI(env.AI)` | same |
+| Vectorize | `instrumentVectorize(env.INDEX, { name })` | same |
+| Hyperdrive | `instrumentHyperdrive(env.HD, { name })` | same |
+| Queue Producer | `instrumentQueueProducer(env.QUEUE, { name })` | same |
+| Durable Objects | `instrumentDO(DOClass)` or `wrapDurableObject(config, DOClass)` | same |
+
+Or use `instrumentBindings(env)` to auto-instrument all bindings at once.
+
+## Handler Types
+
+`instrument()` and `wrapModule()` automatically trace: `fetch`, `scheduled`, `queue`, `email`.
+
+## Common Mistakes
+
+- Do NOT call `instrumentKV()` etc. outside the handler — bindings aren't available at module scope.
+- Do NOT use `await import()` for dynamic imports — use autotel's `safeRequire` helpers.
+- Use `autotel-cloudflare/bindings` for tree-shaking if you only need binding wrappers.