@ah-monica/cloudflare 0.1.0 → 0.2.0

package/README.md

@@ -49,6 +49,24 @@ handlerで送信完了を処理結果に含めたい場合は、直接`await`し
 await monica.captureException(error, { tags: { trigger: "scheduled" } });
 ```
 
+## 送信が拒否されたとき
+
+`422`（envelope schema 不正）のとき、既定で`console.warn`へ1行出す（Workersのログに出る）。
+
+```
+monica: ingest rejected the envelope with 422 (invalid_envelope): 1 issue(s); $.items[0].request.method: Invalid type: Expected string
+```
+
+出力先を変える場合は`onDiagnostic`を渡す。`null`を渡すと何も出さない。
+`flush()`の戻り値の`status` / `issues` / `error`からも取得できる。
+
+`401`（鍵の失効・種別違い）を受けると、そのclientからは以後1回もPOSTしない。
+`flush()`の戻り値の`stopped: true`と次の1行で分かる。
+
+```
+monica: ingest rejected the envelope with 401 (invalid_key); no further envelopes will be sent
+```
+
 ## PII方針
 
 SDKは、例外message、stack、request、contextがPIIかどうかを推測せず、自動除去も

package/dist/client.js

@@ -1,4 +1,5 @@
 import { createCoreClient, createFetchTransport, } from "@ah-monica/core";
+import { SDK_VERSION } from "./version.js";
 const DEFAULT_FLUSH_TIMEOUT_MS = 2_000;
 const DEFAULT_MAX_CAUSE_DEPTH = 10;
 const DEFAULT_MAX_STACK_FRAMES = 200;
@@ -16,12 +17,13 @@ export function createCloudflareClient(options) {
             fetch: options.fetch,
             maxRetries: options.maxRetries ?? 0,
             requestTimeoutMs: options.requestTimeoutMs,
+            onDiagnostic: options.onDiagnostic,
         }),
         environment: options.environment,
         release: options.release,
         sampleRate: options.sampleRate,
         beforeSend: options.beforeSend,
-        sdk: { name: "@ah-monica/cloudflare", version: "0.1.0" },
+        sdk: { name: "@ah-monica/cloudflare", version: SDK_VERSION },
     });
     async function captureAndFlush(input, hint) {
         try {
@@ -86,7 +88,7 @@ function contextValues(context) {
             ? { breadcrumbs: context.breadcrumbs.map((breadcrumb) => ({ ...breadcrumb })) }
             : {}),
         ...(context.request ? { request: cloneRequest(context.request) } : {}),
-        ...(context.fingerprint ? { fingerprint: [...context.fingerprint] } : {}),
+        ...(context.fingerprint?.length ? { fingerprint: [...context.fingerprint] } : {}),
     };
 }
 function cloneRequest(request) {

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export { createCloudflareClient } from "./client.js";
 export type { CloudflareCaptureContext, CloudflareClientOptions, MonicaCloudflareClient, WaitUntilContext, } from "./types.js";
-export type { BeforeSend, FlushResult, MonicaBreadcrumb, MonicaErrorItem, MonicaItem, MonicaLevel, MonicaRequest, MonicaUser, } from "@ah-monica/core";
+export type { BeforeSend, FlushResult, MonicaBreadcrumb, MonicaErrorItem, MonicaItem, MonicaLevel, MonicaRequest, MonicaUser, TransportDiagnostic, TransportDiagnosticHandler, } from "@ah-monica/core";

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import type { BeforeSend, FetchLike, FlushResult, MonicaBreadcrumb, MonicaLevel, MonicaRequest, MonicaUser } from "@ah-monica/core";
+import type { BeforeSend, FetchLike, FlushResult, MonicaBreadcrumb, MonicaLevel, MonicaRequest, MonicaUser, TransportDiagnosticHandler } from "@ah-monica/core";
 export interface CloudflareClientOptions {
     dsn: string;
     environment: string;
@@ -9,6 +9,11 @@ export interface CloudflareClientOptions {
     maxRetries?: number;
     maxCauseDepth?: number;
     maxStackFrames?: number;
+    /**
+     * ingest が envelope を拒否したときの診断の受け取り先。既定は `console.warn` に
+     * 1 行出す（422 の `issues` の path を含む）。`null` を渡すと何も出さない。
+     */
+    onDiagnostic?: TransportDiagnosticHandler | null;
     /**
      * The application owns PII removal. MONICA does not infer which values are PII.
      * Return null to discard an event or return a sanitized event to send it.

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+/** package.json の version と同じ値。bun run version X.Y.Z が書き換える */
+export declare const SDK_VERSION = "0.2.0";

package/dist/version.js

@@ -0,0 +1,2 @@
+/** package.json の version と同じ値。bun run version X.Y.Z が書き換える */
+export const SDK_VERSION = "0.2.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ah-monica/cloudflare",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Cloudflare Workers adapter for sending application errors to MONICA",
   "license": "Apache-2.0",
   "type": "module",
@@ -26,11 +26,11 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Accel-Hack/monica.git",
-    "directory": "sdk/typescript/cloudflare"
+    "url": "git+https://github.com/Accel-Hack/monica-sdk-js.git",
+    "directory": "cloudflare"
   },
   "dependencies": {
-    "@ah-monica/core": "0.1.0"
+    "@ah-monica/core": "0.2.0"
   },
   "devDependencies": {
     "@types/bun": "^1.2.21",