@develit-io/backend-sdk 12.6.1 → 12.7.1

package/dist/index.d.mts

@@ -9,6 +9,7 @@ export { ContentfulStatusCode as InternalResponseStatus } from 'hono/utils/http-
 import { Queue, MessageBatch } from '@cloudflare/workers-types';
 import { BatchItem } from 'drizzle-orm/batch';
 import { DrizzleD1Database } from 'drizzle-orm/d1';
+export { E as ErrorReportContext, a as ErrorReporter, r as reportError, s as setErrorReporter } from './shared/backend-sdk.D6_sG5co.mjs';
 
 declare const ENVIRONMENT: string[];
 
@@ -1020,6 +1021,7 @@ interface InternalError {
     status: InternalErrorResponseStatus;
     code: string;
     message: string;
+    cause?: Error;
 }
 interface IRPCResponse<T> {
     status: ContentfulStatusCode;

package/dist/index.d.ts

@@ -9,6 +9,7 @@ export { ContentfulStatusCode as InternalResponseStatus } from 'hono/utils/http-
 import { Queue, MessageBatch } from '@cloudflare/workers-types';
 import { BatchItem } from 'drizzle-orm/batch';
 import { DrizzleD1Database } from 'drizzle-orm/d1';
+export { E as ErrorReportContext, a as ErrorReporter, r as reportError, s as setErrorReporter } from './shared/backend-sdk.D6_sG5co.js';
 
 declare const ENVIRONMENT: string[];
 
@@ -1020,6 +1021,7 @@ interface InternalError {
     status: InternalErrorResponseStatus;
     code: string;
     message: string;
+    cause?: Error;
 }
 interface IRPCResponse<T> {
     status: ContentfulStatusCode;

package/dist/index.mjs

@@ -6,6 +6,8 @@ import { COUNTRY_CODES_2, CURRENCY_CODES, BANK_CODES } from '@develit-io/general
 import { createInsertSchema as createInsertSchema$1, createSelectSchema as createSelectSchema$1 } from 'drizzle-orm/zod';
 import { z as z$1 } from 'zod';
 import * as z from 'zod/v4/core';
+import { i as isInternalError, c as createInternalError, t as toErrorStatus, r as reportError } from './shared/backend-sdk.e9CWR7-E.mjs';
+export { s as setErrorReporter } from './shared/backend-sdk.e9CWR7-E.mjs';
 import Cloudflare from 'cloudflare';
 import { parse } from 'comment-json';
 import crypto$1 from 'node:crypto';
@@ -283,23 +285,6 @@ const paginationSchema = new z.$ZodObject({
   }
 });
 
-const createInternalError = (error, details) => {
-  return {
-    status: details?.status || 500,
-    code: details?.code || "UNKNOWN_ERROR",
-    message: details?.message || (error instanceof Error ? error.message : "An unexpected error occurred.")
-  };
-};
-const isInternalError = (error) => {
-  return typeof error === "object" && error !== null && "message" in error && "code" in error;
-};
-const toErrorStatus = (status) => {
-  if (status >= 400 && status < 600) {
-    return status;
-  }
-  return 500;
-};
-
 const REDACTED = "[REDACTED]";
 const DEFAULT_SENSITIVE_KEYS = [
   "password",
@@ -980,6 +965,12 @@ function cloudflareQueue(options) {
   };
 }
 
+const composeLogEntry = (worker, identifier, data) => ({
+  entrypoint: worker.name,
+  action: worker.action,
+  identifier,
+  data: serializeLog(data)
+});
 function develitWorker(Worker) {
   class DevelitWorker extends Worker {
     name = "not-set";
@@ -1002,7 +993,9 @@ function develitWorker(Worker) {
         throw RPCResponse.validationError(parseError);
       }
       if (!parseResult.data) {
-        throw createInternalError({
+        throw createInternalError(null, {
+          status: 400,
+          code: "DEFORMED_ACTION_INPUT",
           message: "The provided input could not be processed."
         });
       }
@@ -1010,12 +1003,7 @@ function develitWorker(Worker) {
     }
     log(data, identifier) {
       const name = identifier ?? `${this.name}:${this.action}:log`;
-      console.log(name, {
-        entrypoint: this.name,
-        action: this.action,
-        identifier: name,
-        data: serializeLog(data)
-      });
+      console.log(name, composeLogEntry(this, name, data));
     }
     transformLogData(data) {
       return data;
@@ -1048,10 +1036,12 @@ function develitWorker(Worker) {
       );
     }
     logError(error) {
-      this.log(
-        this.transformLogData(error),
-        `${this.name}:${this.action}:error`
+      const name = `${this.name}:${this.action}:error`;
+      console.error(
+        name,
+        composeLogEntry(this, name, this.transformLogData(error))
       );
+      reportError(error, { service: this.name, action: this.action });
     }
     async pushToQueue(queue, message) {
       return pushToQueue(queue, message);
@@ -1070,4 +1060,4 @@ function develitWorker(Worker) {
   return DevelitWorker;
 }
 
-export { DLQ_ALERT_DEFAULT_MAX_INTERVAL, DLQ_ALERT_DEFAULT_MIN_SIZE, DatabaseTransaction, ENVIRONMENT, RPCResponse, USER_ROLES, action, asNonEmpty, bankAccount, bankAccountMetadataSchema, base, bicSchema, buildDlqAlert, buildMultiFilterConditions, buildRangeFilterConditions, buildSearchConditions, calculateExponentialBackoff, chunkQueueMessages, cloudflareQueue, composeWranglerBase, createAuditLogWriter, createInsertSchema, createInternalError, createPatchSchema, createSelectSchema, createUpdateSchema, defineCommand, derivePortFromId, develitWorker, durableObjectNamespaceIdFromName, first, firstOrError, getD1Credentials, getDrizzleD1Config, getLocalD1DatabaseIdFromWrangler, getSecret, handleAction, handleDlqBatch, ibanSchema, isDlqQueue, isInternalError, nullToOptional, optionalToNull, paginationQuerySchema, paginationSchema, parseDlqAlertRecipients, pushToQueue, queryInChunks, redact, resolveColumn, service, shouldAlertDlq, structuredAddressSchema, useFetch, useResult, useResultSync, workflowInstanceStatusSchema };
+export { DLQ_ALERT_DEFAULT_MAX_INTERVAL, DLQ_ALERT_DEFAULT_MIN_SIZE, DatabaseTransaction, ENVIRONMENT, RPCResponse, USER_ROLES, action, asNonEmpty, bankAccount, bankAccountMetadataSchema, base, bicSchema, buildDlqAlert, buildMultiFilterConditions, buildRangeFilterConditions, buildSearchConditions, calculateExponentialBackoff, chunkQueueMessages, cloudflareQueue, composeWranglerBase, createAuditLogWriter, createInsertSchema, createInternalError, createPatchSchema, createSelectSchema, createUpdateSchema, defineCommand, derivePortFromId, develitWorker, durableObjectNamespaceIdFromName, first, firstOrError, getD1Credentials, getDrizzleD1Config, getLocalD1DatabaseIdFromWrangler, getSecret, handleAction, handleDlqBatch, ibanSchema, isDlqQueue, isInternalError, nullToOptional, optionalToNull, paginationQuerySchema, paginationSchema, parseDlqAlertRecipients, pushToQueue, queryInChunks, redact, reportError, resolveColumn, service, shouldAlertDlq, structuredAddressSchema, useFetch, useResult, useResultSync, workflowInstanceStatusSchema };

package/dist/sentry.d.mts

@@ -0,0 +1,23 @@
+import * as Sentry from '@sentry/cloudflare';
+import { CloudflareOptions } from '@sentry/cloudflare';
+import { a as ErrorReporter } from './shared/backend-sdk.D6_sG5co.mjs';
+
+type ServiceEntrypoint = Parameters<typeof Sentry.withSentry>[1];
+type DurableObjectClass = Parameters<typeof Sentry.instrumentDurableObjectWithSentry>[1];
+type WorkflowClass = Parameters<typeof Sentry.instrumentWorkflowWithSentry>[1];
+declare const instrumentService: <T extends ServiceEntrypoint>(Service: T) => T;
+declare const instrumentDurableObject: <T extends DurableObjectClass>(DurableObject: T) => T;
+declare const instrumentWorkflow: <T extends WorkflowClass>(Workflow: T) => T;
+
+type SentryEnv = {
+    ENVIRONMENT?: string;
+    SENTRY_DSN?: string;
+    CF_VERSION_METADATA?: {
+        id: string;
+    };
+};
+declare const sentryOptions: (env: SentryEnv) => CloudflareOptions;
+
+declare const reportServiceErrorToSentry: ErrorReporter;
+
+export { instrumentDurableObject, instrumentService, instrumentWorkflow, reportServiceErrorToSentry, sentryOptions };

package/dist/sentry.d.ts

@@ -0,0 +1,23 @@
+import * as Sentry from '@sentry/cloudflare';
+import { CloudflareOptions } from '@sentry/cloudflare';
+import { a as ErrorReporter } from './shared/backend-sdk.D6_sG5co.js';
+
+type ServiceEntrypoint = Parameters<typeof Sentry.withSentry>[1];
+type DurableObjectClass = Parameters<typeof Sentry.instrumentDurableObjectWithSentry>[1];
+type WorkflowClass = Parameters<typeof Sentry.instrumentWorkflowWithSentry>[1];
+declare const instrumentService: <T extends ServiceEntrypoint>(Service: T) => T;
+declare const instrumentDurableObject: <T extends DurableObjectClass>(DurableObject: T) => T;
+declare const instrumentWorkflow: <T extends WorkflowClass>(Workflow: T) => T;
+
+type SentryEnv = {
+    ENVIRONMENT?: string;
+    SENTRY_DSN?: string;
+    CF_VERSION_METADATA?: {
+        id: string;
+    };
+};
+declare const sentryOptions: (env: SentryEnv) => CloudflareOptions;
+
+declare const reportServiceErrorToSentry: ErrorReporter;
+
+export { instrumentDurableObject, instrumentService, instrumentWorkflow, reportServiceErrorToSentry, sentryOptions };

package/dist/sentry.mjs

@@ -0,0 +1,92 @@
+import * as Sentry from '@sentry/cloudflare';
+import { i as isInternalError, U as UNKNOWN_ERROR_CODE, s as setErrorReporter } from './shared/backend-sdk.e9CWR7-E.mjs';
+
+const isNonRetryableError = (error) => error instanceof Error && error.name === "NonRetryableError";
+const isFinalAttempt = ({ attempt, config }) => typeof config?.retries?.limit !== "number" || attempt > config.retries.limit;
+const captureNonRetryable = (callback) => async (ctx) => {
+  try {
+    return await callback(ctx);
+  } catch (error) {
+    if (isNonRetryableError(error) && !isFinalAttempt(ctx)) {
+      Sentry.captureException(error, {
+        mechanism: { handled: true, type: "auto.faas.cloudflare.workflow" }
+      });
+    }
+    throw error;
+  }
+};
+const reportNonRetryableStepErrors = (step) => new Proxy(step, {
+  get(target, prop, receiver) {
+    if (prop !== "do") return Reflect.get(target, prop, receiver);
+    return (name, configOrCallback, callbackOrRollback, ...rest) => typeof configOrCallback === "function" ? Reflect.apply(target.do, target, [
+      name,
+      captureNonRetryable(configOrCallback),
+      callbackOrRollback,
+      ...rest
+    ]) : Reflect.apply(target.do, target, [
+      name,
+      configOrCallback,
+      callbackOrRollback && captureNonRetryable(callbackOrRollback),
+      ...rest
+    ]);
+  }
+});
+
+const sentryOptions = (env) => ({
+  dsn: env.SENTRY_DSN,
+  environment: env.ENVIRONMENT,
+  release: env.CF_VERSION_METADATA?.id,
+  enabled: Boolean(env.SENTRY_DSN),
+  tracesSampleRate: env.ENVIRONMENT === "production" ? 0.1 : 0.2,
+  dataCollection: {
+    userInfo: false,
+    cookies: false,
+    httpHeaders: { request: { allow: ["user-agent"] }, response: false },
+    httpBodies: [],
+    urlQueryParams: false
+  },
+  integrations: (defaults) => defaults.filter(({ name }) => name !== "Console")
+});
+
+const reportServiceErrorToSentry = (error, { service, action }) => {
+  const status = isInternalError(error) ? error.status : 500;
+  if (status < 500) return;
+  const logged = error;
+  const code = logged.code ?? UNKNOWN_ERROR_CODE;
+  const message = logged.message ?? `${service}:${action} failed`;
+  const thrown = error instanceof Error ? error : logged.cause instanceof Error ? logged.cause : void 0;
+  Sentry.captureException(thrown ?? new Error(message), {
+    tags: {
+      service,
+      action,
+      error_code: code,
+      error_status: String(status)
+    },
+    extra: { code, message, status },
+    fingerprint: thrown ? void 0 : ["service-error", service, action, code]
+  });
+};
+
+const instrumentService = (Service) => {
+  setErrorReporter(reportServiceErrorToSentry);
+  return Sentry.withSentry(sentryOptions, Service);
+};
+const instrumentDurableObject = (DurableObject) => {
+  setErrorReporter(reportServiceErrorToSentry);
+  return Sentry.instrumentDurableObjectWithSentry(sentryOptions, DurableObject);
+};
+const withNonRetryableStepReporting = (Workflow) => {
+  const Base = Workflow;
+  class NonRetryableStepReportingWorkflow extends Base {
+    run(...[event, step]) {
+      return super.run(event, reportNonRetryableStepErrors(step));
+    }
+  }
+  return NonRetryableStepReportingWorkflow;
+};
+const instrumentWorkflow = (Workflow) => Sentry.instrumentWorkflowWithSentry(
+  sentryOptions,
+  withNonRetryableStepReporting(Workflow)
+);
+
+export { instrumentDurableObject, instrumentService, instrumentWorkflow, reportServiceErrorToSentry, sentryOptions };

package/dist/shared/backend-sdk.D6_sG5co.d.mts

@@ -0,0 +1,10 @@
+type ErrorReportContext = {
+    service: string;
+    action: string;
+};
+type ErrorReporter = (error: object, context: ErrorReportContext) => void;
+declare const setErrorReporter: (reporter: ErrorReporter | undefined) => void;
+declare const reportError: (error: object, context: ErrorReportContext) => void;
+
+export { reportError as r, setErrorReporter as s };
+export type { ErrorReportContext as E, ErrorReporter as a };

package/dist/shared/backend-sdk.D6_sG5co.d.ts

@@ -0,0 +1,10 @@
+type ErrorReportContext = {
+    service: string;
+    action: string;
+};
+type ErrorReporter = (error: object, context: ErrorReportContext) => void;
+declare const setErrorReporter: (reporter: ErrorReporter | undefined) => void;
+declare const reportError: (error: object, context: ErrorReportContext) => void;
+
+export { reportError as r, setErrorReporter as s };
+export type { ErrorReportContext as E, ErrorReporter as a };

package/dist/shared/backend-sdk.e9CWR7-E.mjs

@@ -0,0 +1,39 @@
+const UNKNOWN_ERROR_CODE = "UNKNOWN_ERROR";
+const createInternalError = (error, details) => {
+  const internalError = {
+    status: details?.status || 500,
+    code: details?.code || UNKNOWN_ERROR_CODE,
+    message: details?.message || (error instanceof Error ? error.message : "An unexpected error occurred.")
+  };
+  if (error instanceof Error) {
+    Object.defineProperty(internalError, "cause", {
+      value: error,
+      enumerable: false
+    });
+  }
+  return internalError;
+};
+const isInternalError = (error) => {
+  return typeof error === "object" && error !== null && "message" in error && "code" in error;
+};
+const toErrorStatus = (status) => {
+  if (status >= 400 && status < 600) {
+    return status;
+  }
+  return 500;
+};
+
+let errorReporter;
+const setErrorReporter = (reporter) => {
+  errorReporter = reporter;
+};
+const reportError = (error, context) => {
+  if (!errorReporter) return;
+  try {
+    errorReporter(error, context);
+  } catch (reporterError) {
+    console.error("Error reporter failed", reporterError);
+  }
+};
+
+export { UNKNOWN_ERROR_CODE as U, createInternalError as c, isInternalError as i, reportError as r, setErrorReporter as s, toErrorStatus as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@develit-io/backend-sdk",
-  "version": "12.6.1",
+  "version": "12.7.1",
   "description": "Develit Backend SDK",
   "author": "Develit.io",
   "license": "ISC",
@@ -32,6 +32,11 @@
       "import": "./dist/utils/signature.util.mjs",
       "default": "./dist/utils/signature.util.mjs"
     },
+    "./sentry": {
+      "types": "./dist/sentry.d.ts",
+      "import": "./dist/sentry.mjs",
+      "default": "./dist/sentry.mjs"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -46,11 +51,18 @@
   "peerDependencies": {
     "@develit-io/general-codes": "^1.19.2",
     "drizzle-orm": "^1.0.0-rc.1",
+    "@sentry/cloudflare": "^11.9.0",
     "hono": "^4.12.7",
     "zod": "^4.3.6"
   },
+  "peerDependenciesMeta": {
+    "@sentry/cloudflare": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@packages/shared": "workspace:*",
+    "@sentry/cloudflare": "11.9.0",
     "drizzle-orm": "1.0.0-rc.1"
   }
 }