@picked/telemetry 0.0.101-next.2 → 0.0.101-next.3

package/README.md

@@ -1,38 +1,46 @@
 # @picked/telemetry
 
-A minimal OTLP/HTTP-JSON span emitter shared by the Picked SDK surfaces.
+The OpenTelemetry span emitter the Picked CLI and SDK use to report their own performance. An
+application does not need it.
+
+## Install
+
+```bash
+npm install @picked/telemetry
+```
 
 ## Usage
 
 ```typescript
 import { createSpanId, createTelemetryEmitter, createTraceId, toUnixNano } from '@picked/telemetry'
 
+const startedAt = Date.now()
 const emitter = createTelemetryEmitter({
-  endpoint: 'https://production.otel.picked.app/v1/traces',
-  resource: { 'service.name': 'picked-sdk' },
-  headers: { 'Picked-Telemetry': 'cli' },
+  endpoint: 'https://otel.example.com/v1/traces',
+  resource: { 'service.name': 'my-tool' },
 })
 
 emitter.record({
-  name: 'picked.start',
+  name: 'my-tool.run',
   traceId: createTraceId(),
   spanId: createSpanId(),
   startTimeUnixNano: toUnixNano(startedAt),
-  endTimeUnixNano: toUnixNano(finishedAt),
-  attributes: { 'picked.data.mode': 'api' },
+  endTimeUnixNano: toUnixNano(Date.now()),
+  attributes: {},
   status: 'ok',
 })
 
 await emitter.flush()
 ```
 
-## Constraints
+It sends OTLP/HTTP JSON with `fetch`, has no dependencies, and never throws: a failed batch is
+dropped.
+
+## Docs
+
+This package has no page of its own; it serves the Picked SDK and CLI.
 
-- **No runtime dependencies, and none from `@opentelemetry/*`.** Enforced by
-  `src/package-safety.test.ts`.
-- **No Node built-ins.** The same test pins it, so the package bundles into a browser page.
-- **Nothing it does can surface to the host.** A blocked request, an offline machine, a
-  refused batch and a runtime without `fetch` all resolve quietly. A failed batch is
-  dropped rather than retried, which is what bounds the buffer on a long-lived page.
-- **`fetch` with `keepalive`, never `sendBeacon`.** `sendBeacon` cannot set request headers,
-  and the ingest-channel marker has to travel on the request.
+- **Web:** [Picked SDK](https://docs.picked.app/reference/sdk)
+- **Local:** `node_modules/picked/docs/reference/sdk/index.md`. The `picked` package carries every page under `node_modules/picked/docs/`.
+- **CLI:** `npx picked docs read /reference/sdk`. `npx picked docs list [words]` lists the pages.
+- **MCP:** call `read_picked_doc` with `{ "path": "/reference/sdk" }`; `list_picked_docs` lists the pages. Add the server with `claude mcp add --transport http picked https://api.picked.app/mcp`, or see [How to connect the MCP server](https://docs.picked.app/how-to/connect-the-mcp-server) for other tools.

package/dist/cjs/index.js

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=`@picked/telemetry`,t={unset:0,ok:1,error:2};function n(){return`0.0.101-next.2`}function r(e){return typeof e==`string`?{stringValue:e}:typeof e==`boolean`?{boolValue:e}:Number.isInteger(e)?{intValue:e.toString()}:{doubleValue:e}}function i(e){return Object.entries(e).map(([e,t])=>({key:e,value:r(t)}))}function a(e){return{traceId:e.traceId,spanId:e.spanId,...e.parentSpanId?{parentSpanId:e.parentSpanId}:{},name:e.name,kind:1,startTimeUnixNano:e.startTimeUnixNano,endTimeUnixNano:e.endTimeUnixNano,attributes:i(e.attributes),status:{code:t[e.status]}}}function o(t,r){return{resourceSpans:[{resource:{attributes:i(t)},scopeSpans:[{scope:{name:e,version:n()},spans:r.map(a)}]}]}}var s=`https://production.otel.picked.app/v1/traces`,c=50,l=3e3;function u(e){let t=e.endpoint??`https://production.otel.picked.app/v1/traces`,n=e.maxBatchSize??c,r=[];async function i(){if(r.length===0)return;let n=r;r=[];let i=globalThis.fetch;if(typeof i==`function`)try{await i(t,{method:`POST`,keepalive:!0,headers:{"Content-Type":`application/json`,...e.headers},body:JSON.stringify(o(e.resource,n)),signal:AbortSignal.timeout(l)})}catch{}}return{record:e=>{r.push(e),r.length>=n&&i()},flush:i,bufferedCount:()=>r.length}}var d=16,f=8;function p(e){let t=new Uint8Array(e);return crypto.getRandomValues(t),t.every(e=>e===0)&&(t[0]=1),t}function m(e){let t=``;for(let n of e)t+=n.toString(16).padStart(2,`0`);return t}function h(){return m(p(d))}function g(){return m(p(f))}function _(e,t,n){return`00-${e}-${t}-${n?`01`:`00`}`}var v=1000000n;function y(e){let t=Math.trunc(e),n=Math.round((e-t)*Number(v));return(BigInt(t)*v+BigInt(n)).toString()}exports.DEFAULT_TELEMETRY_ENDPOINT=s,exports.createSpanId=g,exports.createTelemetryEmitter=u,exports.createTraceId=h,exports.formatTraceparent=_,exports.toUnixNano=y;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=`@picked/telemetry`,t={unset:0,ok:1,error:2};function n(){return`0.0.101-next.3`}function r(e){return typeof e==`string`?{stringValue:e}:typeof e==`boolean`?{boolValue:e}:Number.isInteger(e)?{intValue:e.toString()}:{doubleValue:e}}function i(e){return Object.entries(e).map(([e,t])=>({key:e,value:r(t)}))}function a(e){return{traceId:e.traceId,spanId:e.spanId,...e.parentSpanId?{parentSpanId:e.parentSpanId}:{},name:e.name,kind:1,startTimeUnixNano:e.startTimeUnixNano,endTimeUnixNano:e.endTimeUnixNano,attributes:i(e.attributes),status:{code:t[e.status]}}}function o(t,r){return{resourceSpans:[{resource:{attributes:i(t)},scopeSpans:[{scope:{name:e,version:n()},spans:r.map(a)}]}]}}var s=`https://production.otel.picked.app/v1/traces`,c=50,l=3e3;function u(e){let t=e.endpoint??`https://production.otel.picked.app/v1/traces`,n=e.maxBatchSize??c,r=[];async function i(){if(r.length===0)return;let n=r;r=[];let i=globalThis.fetch;if(typeof i==`function`)try{await i(t,{method:`POST`,keepalive:!0,headers:{"Content-Type":`application/json`,...e.headers},body:JSON.stringify(o(e.resource,n)),signal:AbortSignal.timeout(l)})}catch{}}return{record:e=>{r.push(e),r.length>=n&&i()},flush:i,bufferedCount:()=>r.length}}var d=16,f=8;function p(e){let t=new Uint8Array(e);return crypto.getRandomValues(t),t.every(e=>e===0)&&(t[0]=1),t}function m(e){let t=``;for(let n of e)t+=n.toString(16).padStart(2,`0`);return t}function h(){return m(p(d))}function g(){return m(p(f))}function _(e,t,n){return`00-${e}-${t}-${n?`01`:`00`}`}var v=1000000n;function y(e){let t=Math.trunc(e),n=Math.round((e-t)*Number(v));return(BigInt(t)*v+BigInt(n)).toString()}exports.DEFAULT_TELEMETRY_ENDPOINT=s,exports.createSpanId=g,exports.createTelemetryEmitter=u,exports.createTraceId=h,exports.formatTraceparent=_,exports.toUnixNano=y;

package/dist/esm/index.js

@@ -5,7 +5,7 @@ var e = {
 	error: 2
 };
 function t() {
-	return "0.0.101-next.2";
+	return "0.0.101-next.3";
 }
 function n(e) {
 	return typeof e == "string" ? { stringValue: e } : typeof e == "boolean" ? { boolValue: e } : Number.isInteger(e) ? { intValue: e.toString() } : { doubleValue: e };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@picked/telemetry",
   "description": "Minimal OTLP/HTTP-JSON span emitter shared by the Picked SDK surfaces",
-  "version": "0.0.101-next.2",
+  "version": "0.0.101-next.3",
   "dependencies": {},
   "devDependencies": {
     "@repo/eslint-config": "workspace:*",