@automagik/omni 2.260910.8 → 2.260910.9

package/dist/server/index.js

@@ -37101,6 +37101,12 @@ function resolveTemplatePath(path, context2) {
   const specialValue = resolveSpecialValue(trimmed, root, rest, context2);
   if (specialValue !== undefined)
     return specialValue;
+  if (trimmed === "payload_json")
+    return JSON.stringify(context2.payload);
+  if (trimmed === "event_json") {
+    const { id = null, type = null, timestamp = null, metadata = null } = context2.event ?? {};
+    return JSON.stringify({ id, type, timestamp, metadata, payload: context2.payload });
+  }
   if (root === "payload")
     return rest ? getNestedValue(context2.payload, rest) : context2.payload;
   if (root === "env")
@@ -251638,7 +251644,7 @@ var init_sentry_scrub = __esm(() => {
 var require_package7 = __commonJS((exports, module) => {
   module.exports = {
     name: "@omni/api",
-    version: "2.260910.8",
+    version: "2.260910.9",
     private: true,
     type: "module",
     exports: {
@@ -313265,6 +313271,7 @@ var init_scopes = __esm(() => {
     "GET /events/schemas": "events:read",
     "GET /events/schemas/:eventType": "events:read",
     "POST /events/schemas": "events:write",
+    "POST /events/schemas/:eventType/validate": "events:read",
     "GET /events/consumers/:name": "events:read",
     "POST /events/consumers": "events:write",
     "DELETE /events/consumers/:name": "events:write",
@@ -314279,6 +314286,7 @@ var init_route_ownership = __esm(() => {
     "POST /api/v2/events/consumers/:name/ack",
     "POST /api/v2/events/consumers/:name/pull",
     "POST /api/v2/events/schemas",
+    "POST /api/v2/events/schemas/:eventType/validate",
     "POST /api/v2/events/search",
     "POST /api/v2/events/trigger",
     "POST /api/v2/instances",
@@ -371217,6 +371225,11 @@ class EventSchemaService {
     const verdict = validateEventPayload(row.schema, payload);
     return { registered: true, valid: verdict.valid, errors: verdict.errors };
   }
+  async validatePayload(eventType, payload) {
+    const row = await this.getByTypeOrThrow(eventType);
+    const verdict = validateEventPayload(row.schema, payload);
+    return { eventType: row.eventType, version: row.version, enabled: row.enabled, ...verdict };
+  }
   async lookupForGate(eventType) {
     const cached = this.gateCache.get(eventType);
     if (cached && cached.expiresAt > Date.now()) {
@@ -376026,6 +376039,7 @@ class WebhookService {
     if (this.eventBus) {
       const result = await this.eventBus.publishGeneric(eventType, payload, {
         correlationId: metadata?.correlationId,
+        causationId: metadata?.causationId,
         instanceId: metadata?.instanceId,
         source: "manual-trigger"
       });
@@ -376395,14 +376409,38 @@ function handleDatabaseError(c, error3) {
   }
   return null;
 }
-function handleUnknownError(c, error3) {
-  const message2 = error3 instanceof Error ? error3.message : "An unexpected error occurred";
+function describeDbError(error3) {
+  const driver2 = unwrapDbError(error3);
+  const rawCode = driver2 instanceof Error ? driver2.code : undefined;
+  const driverCode = typeof rawCode === "string" ? rawCode : undefined;
+  const isDriverError = driver2 instanceof Error && (driver2.name === "PostgresError" || driverCode !== undefined && PG_CONNECTION_CODES.has(driverCode));
+  if (!(error3 instanceof DrizzleQueryError) && !isDriverError)
+    return null;
+  const connection2 = driverCode !== undefined && (PG_CONNECTION_CODES.has(driverCode) || driverCode.startsWith("08"));
+  return {
+    code: connection2 ? ERROR_CODES.DB_CONNECTION_FAILED : ERROR_CODES.DB_QUERY_FAILED,
+    query: error3 instanceof DrizzleQueryError ? error3.query : undefined,
+    driverCode,
+    driverMessage: driver2 instanceof Error ? driver2.message : String(driver2)
+  };
+}
+function safeErrorMessage(error3, fallback = "Unknown error") {
+  const db2 = describeDbError(error3);
+  if (db2)
+    return db2.code === ERROR_CODES.DB_CONNECTION_FAILED ? "Database unavailable" : "Database query failed";
+  return error3 instanceof Error ? error3.message : fallback;
+}
+function handleGenericDbError(c, info2) {
   return c.json({
     error: {
-      code: "INTERNAL_ERROR",
-      message: message2
+      code: info2.code,
+      message: info2.code === ERROR_CODES.DB_CONNECTION_FAILED ? "Database unavailable" : "Database query failed",
+      retryable: true
     }
-  }, 500);
+  }, ERROR_STATUS_MAP[info2.code]);
+}
+function handleUnknownError(c) {
+  return c.json({ error: { code: "INTERNAL_ERROR", message: "Internal server error" } }, 500);
 }
 function routeError(c, error3) {
   if (error3 instanceof ZodError) {
@@ -376434,7 +376472,10 @@ function routeError(c, error3) {
     if (dbResult)
       return dbResult;
   }
-  return handleUnknownError(c, error3);
+  const dbInfo = describeDbError(error3);
+  if (dbInfo)
+    return handleGenericDbError(c, dbInfo);
+  return handleUnknownError(c);
 }
 function isCodeClientError(code) {
   if (PG_CLIENT_ERROR_CODES.has(code))
@@ -376463,7 +376504,7 @@ function isClientError(error3) {
   }
   return false;
 }
-var log114, SENSITIVE_KEYS2, ERROR_STATUS_MAP, CHANNEL_ERROR_MAP, PG_CLIENT_ERROR_CODES, errorHandler2 = (error3, c) => {
+var log114, SENSITIVE_KEYS2, ERROR_STATUS_MAP, CHANNEL_ERROR_MAP, PG_CONNECTION_CODES, PG_CLIENT_ERROR_CODES, errorHandler2 = (error3, c) => {
   const requestId = c.get("requestId") ?? "unknown";
   if (isClientError(error3)) {
     log114.debug("Client error", {
@@ -376471,9 +376512,12 @@ var log114, SENSITIVE_KEYS2, ERROR_STATUS_MAP, CHANNEL_ERROR_MAP, PG_CLIENT_ERRO
       error: error3 instanceof Error ? error3.message : String(error3)
     });
   } else {
+    const dbInfo = describeDbError(error3);
     log114.error("Server error", {
       requestId,
-      error: error3 instanceof Error ? error3.message : String(error3),
+      error: dbInfo ? `${dbInfo.code}: ${dbInfo.driverMessage}` : error3 instanceof Error ? error3.message : String(error3),
+      dbCode: dbInfo?.driverCode,
+      query: dbInfo?.query,
       stack: error3 instanceof Error ? error3.stack : undefined
     });
     withScope2((scope) => {
@@ -376489,7 +376533,13 @@ var log114, SENSITIVE_KEYS2, ERROR_STATUS_MAP, CHANNEL_ERROR_MAP, PG_CLIENT_ERRO
           scope.setExtra("error.context", error3.context);
         }
       }
-      captureException(error3);
+      if (dbInfo) {
+        scope.setTag("error.code", dbInfo.code);
+        scope.setExtra("db.query", dbInfo.query);
+        captureException(unwrapDbError(error3));
+      } else {
+        captureException(error3);
+      }
     });
   }
   return routeError(c, error3);
@@ -376498,6 +376548,7 @@ var init_error3 = __esm(() => {
   init_src();
   init_src5();
   init_esm6();
+  init_drizzle_orm();
   init_http_exception();
   init_zod();
   log114 = createLogger("api:error");
@@ -376575,6 +376626,17 @@ var init_error3 = __esm(() => {
     SLACK_DM_REJECTED: { status: 403, message: "Slack DM was rejected by the recipient." },
     SLACK_UNKNOWN_ERROR: { status: 502, message: "An unexpected Slack error occurred." }
   };
+  PG_CONNECTION_CODES = new Set([
+    "CONNECT_TIMEOUT",
+    "CONNECTION_CLOSED",
+    "CONNECTION_DESTROYED",
+    "CONNECTION_ENDED",
+    "ECONNREFUSED",
+    "ECONNRESET",
+    "ETIMEDOUT",
+    "ENOTFOUND",
+    "EPIPE"
+  ]);
   PG_CLIENT_ERROR_CODES = new Set(["23505", "23503"]);
 });
 
@@ -376819,7 +376881,7 @@ var import__package2, healthLog, VERSION5, startTime2, healthRoutes, getHealth =
     dbCheck = {
       status: "error",
       latency: Date.now() - dbStart,
-      error: error3 instanceof Error ? error3.message : "Unknown error"
+      error: safeErrorMessage(error3)
     };
   }
   let natsCheck;
@@ -376851,6 +376913,7 @@ var init_health2 = __esm(() => {
   init_src5();
   init_drizzle_orm();
   init_dist2();
+  init_error3();
   import__package2 = __toESM(require_package7(), 1);
   healthLog = createLogger("health");
   VERSION5 = import__package2.default.version;
@@ -380031,6 +380094,8 @@ var init_event_ops2 = __esm(() => {
 function registerEventSchemaSchemas(registry4) {
   registry4.register("EventSchema", EventSchemaSchema);
   registry4.register("RegisterEventSchemaRequest", RegisterEventSchemaSchema);
+  registry4.register("ValidateEventPayloadRequest", ValidateEventPayloadSchema);
+  registry4.register("EventPayloadValidation", EventPayloadValidationSchema);
   registry4.registerPath({
     method: "get",
     path: "/events/schemas",
@@ -380089,8 +380154,30 @@ function registerEventSchemaSchemas(registry4) {
       }
     }
   });
+  registry4.registerPath({
+    method: "post",
+    path: "/events/schemas/{eventType}/validate",
+    operationId: "validateEventPayload",
+    tags: ["Events"],
+    summary: "Validate a payload against a registered event schema (dry run)",
+    description: "Check a payload against the registered schema with the same validator and error strings as the " + "webhook ingress and emit_event gates, without publishing an event or writing anything (no dead letter). " + "Returns 200 whether the payload is valid or not; read the `valid` flag and `errors`.",
+    request: {
+      params: exports_external.object({ eventType: exports_external.string().openapi({ description: "Event type (e.g. custom.github.push)" }) }),
+      body: { content: { "application/json": { schema: ValidateEventPayloadSchema } } }
+    },
+    responses: {
+      200: {
+        description: "Validation verdict",
+        content: { "application/json": { schema: exports_external.object({ data: EventPayloadValidationSchema }) } }
+      },
+      404: {
+        description: "No schema registered for this type",
+        content: { "application/json": { schema: ErrorSchema } }
+      }
+    }
+  });
 }
-var EVENT_TYPE_PATTERN, EventSchemaSchema, RegisterEventSchemaSchema;
+var EVENT_TYPE_PATTERN, EventSchemaSchema, RegisterEventSchemaSchema, ValidateEventPayloadSchema, EventPayloadValidationSchema;
 var init_event_schemas2 = __esm(() => {
   init_zod_openapi();
   init_common4();
@@ -380111,6 +380198,16 @@ var init_event_schemas2 = __esm(() => {
     description: exports_external.string().max(1000).optional().openapi({ description: "Description" }),
     enabled: exports_external.boolean().optional().openapi({ description: "Whether the validation gate is active (default true)" })
   });
+  ValidateEventPayloadSchema = exports_external.object({
+    payload: exports_external.unknown().openapi({ description: "The event payload to validate (any JSON value)" })
+  }).refine((body) => ("payload" in body), { message: "payload is required", path: ["payload"] });
+  EventPayloadValidationSchema = exports_external.object({
+    eventType: exports_external.string().openapi({ description: "Event type the payload was checked against" }),
+    version: exports_external.number().int().openapi({ description: "Schema revision used" }),
+    enabled: exports_external.boolean().openapi({ description: "Whether the gate is active for this type (a disabled schema is still checked)" }),
+    valid: exports_external.boolean().openapi({ description: "True when the payload satisfies the schema" }),
+    errors: exports_external.array(exports_external.string()).openapi({ description: "Violations as `instancePath: message`, identical to the ingress gate; empty when valid" })
+  });
 });
 
 // ../api/src/schemas/openapi/events.ts
@@ -383269,6 +383366,7 @@ var init_webhooks2 = __esm(() => {
     eventType: exports_external.string().min(1).openapi({ description: "Event type (must start with custom.)" }),
     payload: exports_external.record(exports_external.string(), exports_external.unknown()).openapi({ description: "Event payload" }),
     correlationId: exports_external.string().optional().openapi({ description: "Correlation ID" }),
+    causationId: exports_external.string().uuid().optional().openapi({ description: "Parent event ID; stamps causationId so the emission is parented in the causality tree" }),
     instanceId: exports_external.string().uuid().optional().openapi({ description: "Instance ID for context" })
   });
   WebhookReceiveResponseSchema = exports_external.object({
@@ -386509,6 +386607,7 @@ var init_event_ops3 = __esm(() => {
   init_dist6();
   init_dist2();
   init_zod();
+  init_error3();
   init_date_query();
   init_api_keys();
   eventOpsRoutes = new Hono2;
@@ -386546,6 +386645,8 @@ var init_event_ops3 = __esm(() => {
       const session3 = await services.eventOps.startReplay(options);
       return c.json({ data: session3 }, 202);
     } catch (err2) {
+      if (describeDbError(err2))
+        throw err2;
       return c.json({ error: String(err2) }, 400);
     }
   });
@@ -386608,6 +386709,13 @@ var init_event_schemas3 = __esm(() => {
     const data = await services.eventSchemas.register(input);
     return c.json({ data }, 201);
   });
+  eventSchemasRoutes.post("/events/schemas/:eventType/validate", zValidator("json", ValidateEventPayloadSchema), async (c) => {
+    const eventType = c.req.param("eventType");
+    const { payload } = c.req.valid("json");
+    const services = c.get("services");
+    const data = await services.eventSchemas.validatePayload(eventType, payload);
+    return c.json({ data });
+  });
 });
 
 // ../api/src/routes/v2/events.ts
@@ -394987,6 +395095,7 @@ var init_scheduled_messages2 = __esm(() => {
   init_src();
   init_dist2();
   init_zod();
+  init_error3();
   init_scheduled_messages();
   scheduledMessagesRoutes = new Hono2;
   scheduleSchema = exports_external.object({
@@ -395019,7 +395128,7 @@ var init_scheduled_messages2 = __esm(() => {
         throw error3;
       throw new OmniError({
         code: ERROR_CODES.UNKNOWN,
-        message: error3 instanceof Error ? error3.message : String(error3),
+        message: safeErrorMessage(error3, String(error3)),
         recoverable: false,
         cause: error3 instanceof Error ? error3 : undefined
       });
@@ -395855,6 +395964,7 @@ var init_voice2 = __esm(() => {
   init_src2();
   init_dist2();
   init_zod();
+  init_error3();
   voiceRoutes = new Hono2;
   joinSchema = exports_external.object({
     instanceId: exports_external.string().min(1),
@@ -395890,7 +396000,7 @@ var init_voice2 = __esm(() => {
         }
       }, 201);
     } catch (err2) {
-      return c.json({ error: { code: "VOICE_JOIN_FAILED", message: String(err2) } }, 500);
+      return c.json({ error: { code: "VOICE_JOIN_FAILED", message: safeErrorMessage(err2) } }, 500);
     }
   });
   voiceRoutes.post("/leave", zValidator("json", leaveSchema), async (c) => {
@@ -395907,7 +396017,7 @@ var init_voice2 = __esm(() => {
       }
       return c.json({ success: true });
     } catch (err2) {
-      return c.json({ error: { code: "VOICE_LEAVE_FAILED", message: String(err2) } }, 500);
+      return c.json({ error: { code: "VOICE_LEAVE_FAILED", message: safeErrorMessage(err2) } }, 500);
     }
   });
   voiceRoutes.get("/sessions", async (c) => {
@@ -396042,10 +396152,11 @@ var init_webhooks3 = __esm(() => {
     eventType: exports_external.string().min(1).refine((t) => t.startsWith("custom."), { message: 'Event type must start with "custom."' }).describe("Event type (must be custom.*)"),
     payload: exports_external.record(exports_external.string(), exports_external.unknown()).describe("Event payload"),
     correlationId: exports_external.string().optional().describe("Optional correlation ID"),
+    causationId: exports_external.string().uuid().optional().describe("Optional parent event ID (causality tree, #1072)"),
     instanceId: exports_external.string().uuid().optional().describe("Optional instance ID for context")
   });
   webhooksRoutes.post("/events/trigger", zValidator("json", triggerEventSchema), async (c) => {
-    const { eventType, payload, correlationId, instanceId } = c.req.valid("json");
+    const { eventType, payload, correlationId, causationId, instanceId } = c.req.valid("json");
     const services = c.get("services");
     const apiKey = c.get("apiKey");
     if (instanceId && apiKey && !ApiKeyService.instanceAllowed(apiKey.instanceIds, instanceId)) {
@@ -396053,6 +396164,7 @@ var init_webhooks3 = __esm(() => {
     }
     const result = await services.webhooks.trigger(eventType, payload, {
       correlationId,
+      causationId,
       instanceId
     });
     return c.json(result, 201);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automagik/omni",
-  "version": "2.260910.8",
+  "version": "2.260910.9",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/automagik-dev/omni.git",