@sentry/junior-plugin-api 0.106.0 → 0.107.0

package/dist/index.js

@@ -190,6 +190,16 @@ var subscribableResourceSchema = z3.object({
   supportedEvents: z3.array(z3.string().min(1)),
   type: z3.string().min(1)
 }).strict();
+var resourceEventSchema = z3.object({
+  eventKey: z3.string().min(1),
+  eventType: z3.string().min(1),
+  occurredAtMs: z3.number().finite(),
+  provider: z3.string().min(1),
+  resourceRef: z3.string().min(1),
+  terminal: z3.boolean().optional(),
+  trustedSummary: z3.string().min(1),
+  untrustedText: z3.string().optional()
+}).strict();
 
 // src/tasks.ts
 import { z as z4 } from "zod";
@@ -487,6 +497,7 @@ export {
   pluginToolErrorSchema,
   pluginToolResultSchema,
   promptMessageSchema,
+  resourceEventSchema,
   slackActorSchema,
   slackDestinationSchema,
   slackSourceSchema,

package/dist/operations.d.ts

@@ -2,6 +2,7 @@ import { z } from "zod";
 import type { PluginContext } from "./context";
 import type { Dispatch, DispatchOptions, DispatchResult } from "./dispatch";
 import type { PluginReadState, PluginState } from "./state";
+import type { ResourceEventPublisher } from "./resource-events";
 export interface HeartbeatHookContext extends PluginContext {
     agent: {
         dispatch(options: DispatchOptions): Promise<DispatchResult>;
@@ -71,6 +72,8 @@ export type PluginRouteApp = {
     fetch(request: Request, context?: PluginApiRouteRequestContext): Promise<Response> | Response;
 };
 export interface RouteRegistrationHookContext extends PluginContext {
+    /** Core-owned delivery boundary for provider webhook events. */
+    resourceEvents: ResourceEventPublisher;
 }
 export interface ApiRouteRegistrationHookContext extends PluginContext {
 }

package/dist/resource-events.d.ts

@@ -8,3 +8,18 @@ export declare const subscribableResourceSchema: z.ZodObject<{
     type: z.ZodString;
 }, z.core.$strict>;
 export type SubscribableResource = z.output<typeof subscribableResourceSchema>;
+export declare const resourceEventSchema: z.ZodObject<{
+    eventKey: z.ZodString;
+    eventType: z.ZodString;
+    occurredAtMs: z.ZodNumber;
+    provider: z.ZodString;
+    resourceRef: z.ZodString;
+    terminal: z.ZodOptional<z.ZodBoolean>;
+    trustedSummary: z.ZodString;
+    untrustedText: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ResourceEvent = z.output<typeof resourceEventSchema>;
+export interface ResourceEventPublisher {
+    /** Publish one normalized event whose provider matches the owning plugin name. */
+    publish(event: ResourceEvent): Promise<void>;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentry/junior-plugin-api",
-  "version": "0.106.0",
+  "version": "0.107.0",
   "private": false,
   "publishConfig": {
     "access": "public"

package/src/operations.ts

@@ -3,6 +3,7 @@ import type { PluginContext } from "./context";
 import type { Dispatch, DispatchOptions, DispatchResult } from "./dispatch";
 import { nonBlankStringSchema } from "./schemas";
 import type { PluginReadState, PluginState } from "./state";
+import type { ResourceEventPublisher } from "./resource-events";
 
 export interface HeartbeatHookContext extends PluginContext {
   agent: {
@@ -99,7 +100,10 @@ export type PluginRouteApp = {
   ): Promise<Response> | Response;
 };
 
-export interface RouteRegistrationHookContext extends PluginContext {}
+export interface RouteRegistrationHookContext extends PluginContext {
+  /** Core-owned delivery boundary for provider webhook events. */
+  resourceEvents: ResourceEventPublisher;
+}
 
 export interface ApiRouteRegistrationHookContext extends PluginContext {}
 

package/src/resource-events.ts

@@ -12,3 +12,23 @@ export const subscribableResourceSchema = z
   .strict();
 
 export type SubscribableResource = z.output<typeof subscribableResourceSchema>;
+
+export const resourceEventSchema = z
+  .object({
+    eventKey: z.string().min(1),
+    eventType: z.string().min(1),
+    occurredAtMs: z.number().finite(),
+    provider: z.string().min(1),
+    resourceRef: z.string().min(1),
+    terminal: z.boolean().optional(),
+    trustedSummary: z.string().min(1),
+    untrustedText: z.string().optional(),
+  })
+  .strict();
+
+export type ResourceEvent = z.output<typeof resourceEventSchema>;
+
+export interface ResourceEventPublisher {
+  /** Publish one normalized event whose provider matches the owning plugin name. */
+  publish(event: ResourceEvent): Promise<void>;
+}