@ah-monica/cloudflare 0.1.2 → 0.2.1

package/README.md

@@ -49,6 +49,33 @@ 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
+```
+
+`413`（body上限超過）を受けると`items`を半分に割って送り直す。SDKは契約（gzip後
+1 MiB）を下回るサイズしか送らないので、返るのは経路上のproxyやgatewayが契約より
+低い上限を持っているとき。分割して受理されても`flush()`の戻り値の`status`は`413`に
+なり、次の1行をtransportにつき1回だけ出す。
+
+```
+monica: ingest rejected the envelope with 413 (unknown); splitting and resending. A size limit on the path may be below the 1 MiB (gzip) contract
+```
+
 ## PII方針
 
 SDKは、例外message、stack、request、contextがPIIかどうかを推測せず、自動除去も

package/dist/client.js

@@ -17,6 +17,7 @@ export function createCloudflareClient(options) {
             fetch: options.fetch,
             maxRetries: options.maxRetries ?? 0,
             requestTimeoutMs: options.requestTimeoutMs,
+            onDiagnostic: options.onDiagnostic,
         }),
         environment: options.environment,
         release: options.release,

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

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

package/dist/version.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ah-monica/cloudflare",
-  "version": "0.1.2",
+  "version": "0.2.1",
   "description": "Cloudflare Workers adapter for sending application errors to MONICA",
   "license": "Apache-2.0",
   "type": "module",
@@ -30,7 +30,7 @@
     "directory": "cloudflare"
   },
   "dependencies": {
-    "@ah-monica/core": "0.1.2"
+    "@ah-monica/core": "0.2.1"
   },
   "devDependencies": {
     "@types/bun": "^1.2.21",