@shipfox/api-integration-core-dto 9.0.2 → 12.2.0

package/dist/webhooks.d.ts

@@ -4,14 +4,15 @@ export declare const WEBHOOK_MAX_RAW_BODY_BYTES: number;
 export declare const WEBHOOK_MAX_SERIALIZED_REQUEST_BYTES: number;
 export declare const WEBHOOK_MAX_HEADER_BYTES: number;
 export declare const WEBHOOK_MAX_RAW_QUERY_STRING_LENGTH: number;
-export declare const webhookRouteIds: readonly ["github", "gitea", "linear", "sentry", "slack.event", "slack.command", "webhook.connection"];
+export declare const webhookRouteIds: readonly ["github", "gitea", "linear", "sentry", "slack.event", "slack.command", "webhook.connection", "jira"];
 export declare const webhookRouteIdSchema: z.ZodEnum<{
-    github: "github";
     gitea: "gitea";
+    github: "github";
+    jira: "jira";
     linear: "linear";
     sentry: "sentry";
-    "slack.event": "slack.event";
     "slack.command": "slack.command";
+    "slack.event": "slack.event";
     "webhook.connection": "webhook.connection";
 }>;
 export type WebhookRouteId = z.infer<typeof webhookRouteIdSchema>;
@@ -31,12 +32,12 @@ export declare const storedWebhookRequestSchema: z.ZodDiscriminatedUnion<[z.ZodO
         data: z.ZodString;
     }, z.core.$strict>;
     route_id: z.ZodEnum<{
-        github: "github";
         gitea: "gitea";
+        github: "github";
         linear: "linear";
         sentry: "sentry";
-        "slack.event": "slack.event";
         "slack.command": "slack.command";
+        "slack.event": "slack.event";
     }>;
     path_parameters: z.ZodObject<{}, z.core.$strict>;
 }, z.core.$strict>, z.ZodObject<{
@@ -54,6 +55,21 @@ export declare const storedWebhookRequestSchema: z.ZodDiscriminatedUnion<[z.ZodO
     path_parameters: z.ZodObject<{
         connection_id: z.ZodString;
     }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    request_id: z.ZodString;
+    received_at: z.ZodString;
+    method: z.ZodLiteral<"POST">;
+    raw_query_string: z.ZodString;
+    headers: z.ZodRecord<z.ZodString, z.ZodString>;
+    body: z.ZodObject<{
+        encoding: z.ZodLiteral<"base64">;
+        data: z.ZodString;
+    }, z.core.$strict>;
+    route_id: z.ZodLiteral<"jira">;
+    path_parameters: z.ZodObject<{
+        connection_id: z.ZodString;
+    }, z.core.$strict>;
 }, z.core.$strict>], "route_id">;
 export type StoredWebhookRequest = z.infer<typeof storedWebhookRequestSchema>;
 export declare const webhookProcessingResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -66,25 +82,32 @@ export declare const webhookProcessingResultSchema: z.ZodDiscriminatedUnion<[z.Z
 }, z.core.$strict>, z.ZodObject<{
     outcome: z.ZodLiteral<"discarded">;
     reason: z.ZodEnum<{
-        missing_required_input: "missing_required_input";
+        connection_unavailable: "connection_unavailable";
         invalid_signature: "invalid_signature";
-        stale_at_receipt: "stale_at_receipt";
         malformed_payload: "malformed_payload";
+        missing_required_input: "missing_required_input";
+        stale_at_receipt: "stale_at_receipt";
         unsupported_event: "unsupported_event";
-        connection_unavailable: "connection_unavailable";
     }>;
     deliveryId: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>], "outcome">;
 export type WebhookProcessingResult = z.infer<typeof webhookProcessingResultSchema>;
-export interface CreateStoredWebhookRequestInput {
+interface CreateStoredWebhookRequestInputBase {
     requestId: string;
     routeId: WebhookRouteId;
     receivedAt: string;
     rawQueryString: string;
     headers: Record<string, string>;
     body: Uint8Array;
-    connectionId?: string | undefined;
 }
+type ConnectionScopedWebhookRouteId = 'webhook.connection' | 'jira';
+export type CreateStoredWebhookRequestInput = (CreateStoredWebhookRequestInputBase & {
+    routeId: ConnectionScopedWebhookRouteId;
+    connectionId: string;
+}) | (CreateStoredWebhookRequestInputBase & {
+    routeId: Exclude<WebhookRouteId, ConnectionScopedWebhookRouteId>;
+    connectionId?: never;
+});
 export declare function encodeWebhookBody(body: Uint8Array): string;
 export declare function decodeWebhookBody(body: z.infer<typeof webhookBodySchema>): Uint8Array;
 export declare function createStoredWebhookRequest(input: CreateStoredWebhookRequestInput): StoredWebhookRequest;

package/dist/webhooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../src/webhooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,eAAO,MAAM,8BAA8B,EAAG,CAAU,CAAC;AACzD,eAAO,MAAM,0BAA0B,QAAa,CAAC;AACrD,eAAO,MAAM,oCAAoC,QAAc,CAAC;AAChE,eAAO,MAAM,wBAAwB,QAAY,CAAC;AAClD,eAAO,MAAM,mCAAmC,QAAW,CAAC;AAW5D,eAAO,MAAM,eAAe,wGAA8D,CAAC;AAE3F,eAAO,MAAM,oBAAoB;;;;;;;;EAA0B,CAAC;AAC5D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AA4BlE,QAAA,MAAM,iBAAiB;;;kBAYpB,CAAC;AA6BJ,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAGrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;+BAuBxC,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF,MAAM,WAAW,+BAA+B;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,cAAc,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,UAAU,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CA0B1D;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,GAAG,UAAU,CAyBrF;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,+BAA+B,GACrC,oBAAoB,CAetB"}
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../src/webhooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,eAAO,MAAM,8BAA8B,EAAG,CAAU,CAAC;AACzD,eAAO,MAAM,0BAA0B,QAAa,CAAC;AACrD,eAAO,MAAM,oCAAoC,QAAc,CAAC;AAChE,eAAO,MAAM,wBAAwB,QAAY,CAAC;AAClD,eAAO,MAAM,mCAAmC,QAAW,CAAC;AAW5D,eAAO,MAAM,eAAe,gHAAsE,CAAC;AAEnG,eAAO,MAAM,oBAAoB;;;;;;;;;EAA0B,CAAC;AAC5D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AA4BlE,QAAA,MAAM,iBAAiB;;;kBAYpB,CAAC;AAoCJ,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAIrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;+BAuBxC,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF,UAAU,mCAAmC;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,cAAc,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,KAAK,8BAA8B,GAAG,oBAAoB,GAAG,MAAM,CAAC;AAEpE,MAAM,MAAM,+BAA+B,GACvC,CAAC,mCAAmC,GAAG;IACrC,OAAO,EAAE,8BAA8B,CAAC;IACxC,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC,GACF,CAAC,mCAAmC,GAAG;IACrC,OAAO,EAAE,OAAO,CAAC,cAAc,EAAE,8BAA8B,CAAC,CAAC;IACjE,YAAY,CAAC,EAAE,KAAK,CAAC;CACtB,CAAC,CAAC;AAEP,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CA0B1D;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,GAAG,UAAU,CAyBrF;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,+BAA+B,GACrC,oBAAoB,CAiBtB"}

package/dist/webhooks.js

@@ -14,7 +14,8 @@ const standardWebhookRouteIds = [
 ];
 export const webhookRouteIds = [
     ...standardWebhookRouteIds,
-    'webhook.connection'
+    'webhook.connection',
+    'jira'
 ];
 export const webhookRouteIdSchema = z.enum(webhookRouteIds);
 const base64Pattern = /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/;
@@ -53,9 +54,14 @@ const genericWebhookRouteRequestSchema = storedWebhookRequestBaseSchema.extend({
     route_id: z.literal('webhook.connection'),
     path_parameters: connectionPathParametersSchema
 }).strict();
+const jiraWebhookRouteRequestSchema = storedWebhookRequestBaseSchema.extend({
+    route_id: z.literal('jira'),
+    path_parameters: connectionPathParametersSchema
+}).strict();
 export const storedWebhookRequestSchema = z.discriminatedUnion('route_id', [
     standardWebhookRouteRequestSchema,
-    genericWebhookRouteRequestSchema
+    genericWebhookRouteRequestSchema,
+    jiraWebhookRouteRequestSchema
 ]);
 export const webhookProcessingResultSchema = z.discriminatedUnion('outcome', [
     z.object({
@@ -112,7 +118,7 @@ export function decodeWebhookBody(body) {
     return output;
 }
 export function createStoredWebhookRequest(input) {
-    const pathParameters = input.routeId === 'webhook.connection' ? {
+    const pathParameters = input.routeId === 'webhook.connection' || input.routeId === 'jira' ? {
         connection_id: input.connectionId
     } : {};
     return storedWebhookRequestSchema.parse({

package/dist/webhooks.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/webhooks.ts"],"sourcesContent":["import {z} from 'zod';\n\nexport const WEBHOOK_REQUEST_SCHEMA_VERSION = 1 as const;\nexport const WEBHOOK_MAX_RAW_BODY_BYTES = 512 * 1024;\nexport const WEBHOOK_MAX_SERIALIZED_REQUEST_BYTES = 1024 * 1024;\nexport const WEBHOOK_MAX_HEADER_BYTES = 64 * 1024;\nexport const WEBHOOK_MAX_RAW_QUERY_STRING_LENGTH = 8 * 1024;\n\nconst standardWebhookRouteIds = [\n  'github',\n  'gitea',\n  'linear',\n  'sentry',\n  'slack.event',\n  'slack.command',\n] as const;\n\nexport const webhookRouteIds = [...standardWebhookRouteIds, 'webhook.connection'] as const;\n\nexport const webhookRouteIdSchema = z.enum(webhookRouteIds);\nexport type WebhookRouteId = z.infer<typeof webhookRouteIdSchema>;\n\nconst base64Pattern = /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/;\n\nfunction decodedBase64Length(value: string): number {\n  const paddingLength = value.endsWith('==') ? 2 : value.endsWith('=') ? 1 : 0;\n\n  return (value.length / 4) * 3 - paddingLength;\n}\n\nfunction headersByteLength(headers: Record<string, string>): number {\n  return new TextEncoder().encode(JSON.stringify(headers)).byteLength;\n}\n\nconst webhookHeadersSchema = z\n  .record(z.string(), z.string().max(8 * 1024))\n  .refine(\n    (headers) =>\n      Object.keys(headers).every(\n        (name) => name === name.toLowerCase() && name.length > 0 && name.length <= 128,\n      ),\n    'Webhook header names must be lowercase and at most 128 characters',\n  )\n  .refine(\n    (headers) => headersByteLength(headers) <= WEBHOOK_MAX_HEADER_BYTES,\n    `Webhook headers must serialize to at most ${WEBHOOK_MAX_HEADER_BYTES} bytes`,\n  );\n\nconst webhookBodySchema = z\n  .object({\n    encoding: z.literal('base64'),\n    data: z\n      .string()\n      .max(Math.ceil(WEBHOOK_MAX_RAW_BODY_BYTES / 3) * 4)\n      .regex(base64Pattern),\n  })\n  .strict()\n  .refine(\n    (body) => decodedBase64Length(body.data) <= WEBHOOK_MAX_RAW_BODY_BYTES,\n    `Webhook bodies must decode to at most ${WEBHOOK_MAX_RAW_BODY_BYTES} bytes`,\n  );\n\nconst storedWebhookRequestBaseSchema = z.object({\n  schema_version: z.literal(WEBHOOK_REQUEST_SCHEMA_VERSION),\n  request_id: z.string().uuid(),\n  received_at: z.string().datetime({offset: true}),\n  method: z.literal('POST'),\n  raw_query_string: z.string().max(WEBHOOK_MAX_RAW_QUERY_STRING_LENGTH),\n  headers: webhookHeadersSchema,\n  body: webhookBodySchema,\n});\n\nconst emptyPathParametersSchema = z.object({}).strict();\nconst connectionPathParametersSchema = z.object({connection_id: z.string().uuid()}).strict();\n\nconst standardWebhookRouteRequestSchema = storedWebhookRequestBaseSchema\n  .extend({\n    route_id: z.enum(standardWebhookRouteIds),\n    path_parameters: emptyPathParametersSchema,\n  })\n  .strict();\n\nconst genericWebhookRouteRequestSchema = storedWebhookRequestBaseSchema\n  .extend({\n    route_id: z.literal('webhook.connection'),\n    path_parameters: connectionPathParametersSchema,\n  })\n  .strict();\n\nexport const storedWebhookRequestSchema = z.discriminatedUnion('route_id', [\n  standardWebhookRouteRequestSchema,\n  genericWebhookRouteRequestSchema,\n]);\nexport type StoredWebhookRequest = z.infer<typeof storedWebhookRequestSchema>;\n\nexport const webhookProcessingResultSchema = z.discriminatedUnion('outcome', [\n  z\n    .object({\n      outcome: z.literal('processed'),\n      deliveryId: z.string().min(1).optional(),\n      challenge: z.string().min(1).optional(),\n    })\n    .strict(),\n  z.object({outcome: z.literal('duplicate'), deliveryId: z.string().min(1)}).strict(),\n  z\n    .object({\n      outcome: z.literal('discarded'),\n      reason: z.enum([\n        'missing_required_input',\n        'invalid_signature',\n        'stale_at_receipt',\n        'malformed_payload',\n        'unsupported_event',\n        'connection_unavailable',\n      ]),\n      deliveryId: z.string().min(1).optional(),\n    })\n    .strict(),\n]);\nexport type WebhookProcessingResult = z.infer<typeof webhookProcessingResultSchema>;\n\nexport interface CreateStoredWebhookRequestInput {\n  requestId: string;\n  routeId: WebhookRouteId;\n  receivedAt: string;\n  rawQueryString: string;\n  headers: Record<string, string>;\n  body: Uint8Array;\n  connectionId?: string | undefined;\n}\n\nexport function encodeWebhookBody(body: Uint8Array): string {\n  let encoded = '';\n\n  for (let index = 0; index < body.length; index += 3) {\n    const first = body[index] ?? 0;\n    const second = body[index + 1];\n    const third = body[index + 2];\n    const combined = (first << 16) | ((second ?? 0) << 8) | (third ?? 0);\n\n    encoded += 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/'[\n      (combined >> 18) & 63\n    ];\n    encoded += 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/'[\n      (combined >> 12) & 63\n    ];\n    encoded +=\n      second === undefined\n        ? '='\n        : 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/'[(combined >> 6) & 63];\n    encoded +=\n      third === undefined\n        ? '='\n        : 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/'[combined & 63];\n  }\n\n  return encoded;\n}\n\nexport function decodeWebhookBody(body: z.infer<typeof webhookBodySchema>): Uint8Array {\n  const output = new Uint8Array(decodedBase64Length(body.data));\n  let outputIndex = 0;\n\n  for (let index = 0; index < body.data.length; index += 4) {\n    const chunk = body.data.slice(index, index + 4);\n    const values = chunk\n      .split('')\n      .map((character) =>\n        character === '='\n          ? 0\n          : 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/'.indexOf(character),\n      );\n    const first = values[0] ?? 0;\n    const second = values[1] ?? 0;\n    const third = values[2] ?? 0;\n    const fourth = values[3] ?? 0;\n    const combined = (first << 18) | (second << 12) | (third << 6) | fourth;\n\n    output[outputIndex++] = (combined >> 16) & 255;\n    if (chunk[2] !== '=') output[outputIndex++] = (combined >> 8) & 255;\n    if (chunk[3] !== '=') output[outputIndex++] = combined & 255;\n  }\n\n  return output;\n}\n\nexport function createStoredWebhookRequest(\n  input: CreateStoredWebhookRequestInput,\n): StoredWebhookRequest {\n  const pathParameters =\n    input.routeId === 'webhook.connection' ? {connection_id: input.connectionId} : {};\n\n  return storedWebhookRequestSchema.parse({\n    schema_version: WEBHOOK_REQUEST_SCHEMA_VERSION,\n    request_id: input.requestId,\n    route_id: input.routeId,\n    received_at: input.receivedAt,\n    method: 'POST',\n    path_parameters: pathParameters,\n    raw_query_string: input.rawQueryString,\n    headers: input.headers,\n    body: {encoding: 'base64', data: encodeWebhookBody(input.body)},\n  });\n}\n"],"names":["z","WEBHOOK_REQUEST_SCHEMA_VERSION","WEBHOOK_MAX_RAW_BODY_BYTES","WEBHOOK_MAX_SERIALIZED_REQUEST_BYTES","WEBHOOK_MAX_HEADER_BYTES","WEBHOOK_MAX_RAW_QUERY_STRING_LENGTH","standardWebhookRouteIds","webhookRouteIds","webhookRouteIdSchema","enum","base64Pattern","decodedBase64Length","value","paddingLength","endsWith","length","headersByteLength","headers","TextEncoder","encode","JSON","stringify","byteLength","webhookHeadersSchema","record","string","max","refine","Object","keys","every","name","toLowerCase","webhookBodySchema","object","encoding","literal","data","Math","ceil","regex","strict","body","storedWebhookRequestBaseSchema","schema_version","request_id","uuid","received_at","datetime","offset","method","raw_query_string","emptyPathParametersSchema","connectionPathParametersSchema","connection_id","standardWebhookRouteRequestSchema","extend","route_id","path_parameters","genericWebhookRouteRequestSchema","storedWebhookRequestSchema","discriminatedUnion","webhookProcessingResultSchema","outcome","deliveryId","min","optional","challenge","reason","encodeWebhookBody","encoded","index","first","second","third","combined","undefined","decodeWebhookBody","output","Uint8Array","outputIndex","chunk","slice","values","split","map","character","indexOf","fourth","createStoredWebhookRequest","input","pathParameters","routeId","connectionId","parse","requestId","receivedAt","rawQueryString"],"mappings":"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"}
+{"version":3,"sources":["../src/webhooks.ts"],"sourcesContent":["import {z} from 'zod';\n\nexport const WEBHOOK_REQUEST_SCHEMA_VERSION = 1 as const;\nexport const WEBHOOK_MAX_RAW_BODY_BYTES = 512 * 1024;\nexport const WEBHOOK_MAX_SERIALIZED_REQUEST_BYTES = 1024 * 1024;\nexport const WEBHOOK_MAX_HEADER_BYTES = 64 * 1024;\nexport const WEBHOOK_MAX_RAW_QUERY_STRING_LENGTH = 8 * 1024;\n\nconst standardWebhookRouteIds = [\n  'github',\n  'gitea',\n  'linear',\n  'sentry',\n  'slack.event',\n  'slack.command',\n] as const;\n\nexport const webhookRouteIds = [...standardWebhookRouteIds, 'webhook.connection', 'jira'] as const;\n\nexport const webhookRouteIdSchema = z.enum(webhookRouteIds);\nexport type WebhookRouteId = z.infer<typeof webhookRouteIdSchema>;\n\nconst base64Pattern = /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/;\n\nfunction decodedBase64Length(value: string): number {\n  const paddingLength = value.endsWith('==') ? 2 : value.endsWith('=') ? 1 : 0;\n\n  return (value.length / 4) * 3 - paddingLength;\n}\n\nfunction headersByteLength(headers: Record<string, string>): number {\n  return new TextEncoder().encode(JSON.stringify(headers)).byteLength;\n}\n\nconst webhookHeadersSchema = z\n  .record(z.string(), z.string().max(8 * 1024))\n  .refine(\n    (headers) =>\n      Object.keys(headers).every(\n        (name) => name === name.toLowerCase() && name.length > 0 && name.length <= 128,\n      ),\n    'Webhook header names must be lowercase and at most 128 characters',\n  )\n  .refine(\n    (headers) => headersByteLength(headers) <= WEBHOOK_MAX_HEADER_BYTES,\n    `Webhook headers must serialize to at most ${WEBHOOK_MAX_HEADER_BYTES} bytes`,\n  );\n\nconst webhookBodySchema = z\n  .object({\n    encoding: z.literal('base64'),\n    data: z\n      .string()\n      .max(Math.ceil(WEBHOOK_MAX_RAW_BODY_BYTES / 3) * 4)\n      .regex(base64Pattern),\n  })\n  .strict()\n  .refine(\n    (body) => decodedBase64Length(body.data) <= WEBHOOK_MAX_RAW_BODY_BYTES,\n    `Webhook bodies must decode to at most ${WEBHOOK_MAX_RAW_BODY_BYTES} bytes`,\n  );\n\nconst storedWebhookRequestBaseSchema = z.object({\n  schema_version: z.literal(WEBHOOK_REQUEST_SCHEMA_VERSION),\n  request_id: z.string().uuid(),\n  received_at: z.string().datetime({offset: true}),\n  method: z.literal('POST'),\n  raw_query_string: z.string().max(WEBHOOK_MAX_RAW_QUERY_STRING_LENGTH),\n  headers: webhookHeadersSchema,\n  body: webhookBodySchema,\n});\n\nconst emptyPathParametersSchema = z.object({}).strict();\nconst connectionPathParametersSchema = z.object({connection_id: z.string().uuid()}).strict();\n\nconst standardWebhookRouteRequestSchema = storedWebhookRequestBaseSchema\n  .extend({\n    route_id: z.enum(standardWebhookRouteIds),\n    path_parameters: emptyPathParametersSchema,\n  })\n  .strict();\n\nconst genericWebhookRouteRequestSchema = storedWebhookRequestBaseSchema\n  .extend({\n    route_id: z.literal('webhook.connection'),\n    path_parameters: connectionPathParametersSchema,\n  })\n  .strict();\n\nconst jiraWebhookRouteRequestSchema = storedWebhookRequestBaseSchema\n  .extend({\n    route_id: z.literal('jira'),\n    path_parameters: connectionPathParametersSchema,\n  })\n  .strict();\n\nexport const storedWebhookRequestSchema = z.discriminatedUnion('route_id', [\n  standardWebhookRouteRequestSchema,\n  genericWebhookRouteRequestSchema,\n  jiraWebhookRouteRequestSchema,\n]);\nexport type StoredWebhookRequest = z.infer<typeof storedWebhookRequestSchema>;\n\nexport const webhookProcessingResultSchema = z.discriminatedUnion('outcome', [\n  z\n    .object({\n      outcome: z.literal('processed'),\n      deliveryId: z.string().min(1).optional(),\n      challenge: z.string().min(1).optional(),\n    })\n    .strict(),\n  z.object({outcome: z.literal('duplicate'), deliveryId: z.string().min(1)}).strict(),\n  z\n    .object({\n      outcome: z.literal('discarded'),\n      reason: z.enum([\n        'missing_required_input',\n        'invalid_signature',\n        'stale_at_receipt',\n        'malformed_payload',\n        'unsupported_event',\n        'connection_unavailable',\n      ]),\n      deliveryId: z.string().min(1).optional(),\n    })\n    .strict(),\n]);\nexport type WebhookProcessingResult = z.infer<typeof webhookProcessingResultSchema>;\n\ninterface CreateStoredWebhookRequestInputBase {\n  requestId: string;\n  routeId: WebhookRouteId;\n  receivedAt: string;\n  rawQueryString: string;\n  headers: Record<string, string>;\n  body: Uint8Array;\n}\n\ntype ConnectionScopedWebhookRouteId = 'webhook.connection' | 'jira';\n\nexport type CreateStoredWebhookRequestInput =\n  | (CreateStoredWebhookRequestInputBase & {\n      routeId: ConnectionScopedWebhookRouteId;\n      connectionId: string;\n    })\n  | (CreateStoredWebhookRequestInputBase & {\n      routeId: Exclude<WebhookRouteId, ConnectionScopedWebhookRouteId>;\n      connectionId?: never;\n    });\n\nexport function encodeWebhookBody(body: Uint8Array): string {\n  let encoded = '';\n\n  for (let index = 0; index < body.length; index += 3) {\n    const first = body[index] ?? 0;\n    const second = body[index + 1];\n    const third = body[index + 2];\n    const combined = (first << 16) | ((second ?? 0) << 8) | (third ?? 0);\n\n    encoded += 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/'[\n      (combined >> 18) & 63\n    ];\n    encoded += 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/'[\n      (combined >> 12) & 63\n    ];\n    encoded +=\n      second === undefined\n        ? '='\n        : 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/'[(combined >> 6) & 63];\n    encoded +=\n      third === undefined\n        ? '='\n        : 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/'[combined & 63];\n  }\n\n  return encoded;\n}\n\nexport function decodeWebhookBody(body: z.infer<typeof webhookBodySchema>): Uint8Array {\n  const output = new Uint8Array(decodedBase64Length(body.data));\n  let outputIndex = 0;\n\n  for (let index = 0; index < body.data.length; index += 4) {\n    const chunk = body.data.slice(index, index + 4);\n    const values = chunk\n      .split('')\n      .map((character) =>\n        character === '='\n          ? 0\n          : 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/'.indexOf(character),\n      );\n    const first = values[0] ?? 0;\n    const second = values[1] ?? 0;\n    const third = values[2] ?? 0;\n    const fourth = values[3] ?? 0;\n    const combined = (first << 18) | (second << 12) | (third << 6) | fourth;\n\n    output[outputIndex++] = (combined >> 16) & 255;\n    if (chunk[2] !== '=') output[outputIndex++] = (combined >> 8) & 255;\n    if (chunk[3] !== '=') output[outputIndex++] = combined & 255;\n  }\n\n  return output;\n}\n\nexport function createStoredWebhookRequest(\n  input: CreateStoredWebhookRequestInput,\n): StoredWebhookRequest {\n  const pathParameters =\n    input.routeId === 'webhook.connection' || input.routeId === 'jira'\n      ? {connection_id: input.connectionId}\n      : {};\n\n  return storedWebhookRequestSchema.parse({\n    schema_version: WEBHOOK_REQUEST_SCHEMA_VERSION,\n    request_id: input.requestId,\n    route_id: input.routeId,\n    received_at: input.receivedAt,\n    method: 'POST',\n    path_parameters: pathParameters,\n    raw_query_string: input.rawQueryString,\n    headers: input.headers,\n    body: {encoding: 'base64', data: encodeWebhookBody(input.body)},\n  });\n}\n"],"names":["z","WEBHOOK_REQUEST_SCHEMA_VERSION","WEBHOOK_MAX_RAW_BODY_BYTES","WEBHOOK_MAX_SERIALIZED_REQUEST_BYTES","WEBHOOK_MAX_HEADER_BYTES","WEBHOOK_MAX_RAW_QUERY_STRING_LENGTH","standardWebhookRouteIds","webhookRouteIds","webhookRouteIdSchema","enum","base64Pattern","decodedBase64Length","value","paddingLength","endsWith","length","headersByteLength","headers","TextEncoder","encode","JSON","stringify","byteLength","webhookHeadersSchema","record","string","max","refine","Object","keys","every","name","toLowerCase","webhookBodySchema","object","encoding","literal","data","Math","ceil","regex","strict","body","storedWebhookRequestBaseSchema","schema_version","request_id","uuid","received_at","datetime","offset","method","raw_query_string","emptyPathParametersSchema","connectionPathParametersSchema","connection_id","standardWebhookRouteRequestSchema","extend","route_id","path_parameters","genericWebhookRouteRequestSchema","jiraWebhookRouteRequestSchema","storedWebhookRequestSchema","discriminatedUnion","webhookProcessingResultSchema","outcome","deliveryId","min","optional","challenge","reason","encodeWebhookBody","encoded","index","first","second","third","combined","undefined","decodeWebhookBody","output","Uint8Array","outputIndex","chunk","slice","values","split","map","character","indexOf","fourth","createStoredWebhookRequest","input","pathParameters","routeId","connectionId","parse","requestId","receivedAt","rawQueryString"],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@shipfox/api-integration-core-dto",
   "license": "MIT",
-  "version": "9.0.2",
+  "version": "12.2.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ShipfoxHQ/shipfox.git",
@@ -23,7 +23,7 @@
   },
   "dependencies": {
     "zod": "^4.4.3",
-    "@shipfox/inter-module": "0.2.2"
+    "@shipfox/inter-module": "0.2.3"
   },
   "imports": {
     "#*": "./dist/*"

package/src/events.test.ts

@@ -1,11 +1,22 @@
 import {
+  INTEGRATION_CONNECTION_AVAILABLE,
   INTEGRATION_EVENT_RECEIVED,
   INTEGRATION_SOURCE_COMMIT_PUSHED,
+  INTEGRATION_SOURCE_REPOSITORY_UPDATED,
+  integrationConnectionAvailableSchema,
   integrationEventReceivedSchema,
   integrationSourceCommitPushedSchema,
+  integrationSourceRepositoryUpdatedSchema,
   integrationsEventSchemas,
 } from './events.js';
 
+const validConnectionAvailable = {
+  provider: 'linear',
+  workspaceId: 'ws-1',
+  connectionId: 'conn-1',
+  slug: 'linear_shipfox',
+};
+
 const validEventReceived = {
   provider: 'github',
   source: 'github',
@@ -33,6 +44,34 @@ const validCommitPushed = {
   },
 };
 
+const validRepositoryUpdated = {
+  provider: 'github',
+  workspaceId: 'ws-1',
+  connectionId: 'conn-1',
+  deliveryId: 'delivery-1',
+  receivedAt: '2026-06-21T00:00:00.000Z',
+  repository: {
+    externalRepositoryId: 'github:42',
+    owner: 'acme',
+    name: 'platform-renamed',
+    defaultBranch: 'main',
+  },
+};
+
+describe('integrationConnectionAvailableSchema', () => {
+  it('parses a valid connection-available payload unchanged', () => {
+    expect(integrationConnectionAvailableSchema.parse(validConnectionAvailable)).toEqual(
+      validConnectionAvailable,
+    );
+  });
+
+  it('rejects a payload without a connection slug', () => {
+    const {slug: _slug, ...withoutSlug} = validConnectionAvailable;
+
+    expect(() => integrationConnectionAvailableSchema.parse(withoutSlug)).toThrow();
+  });
+});
+
 describe('integrationSourceCommitPushedSchema', () => {
   it('parses a valid commit-pushed payload unchanged', () => {
     const result = integrationSourceCommitPushedSchema.parse(validCommitPushed);
@@ -98,12 +137,33 @@ describe('integrationEventReceivedSchema', () => {
   });
 });
 
+describe('integrationSourceRepositoryUpdatedSchema', () => {
+  it('parses a valid repository identity update unchanged', () => {
+    const result = integrationSourceRepositoryUpdatedSchema.parse(validRepositoryUpdated);
+
+    expect(result).toEqual(validRepositoryUpdated);
+  });
+
+  it('rejects a payload missing repository identity', () => {
+    const {repository: _repository, ...withoutRepository} = validRepositoryUpdated;
+
+    const parse = () => integrationSourceRepositoryUpdatedSchema.parse(withoutRepository);
+
+    expect(parse).toThrow();
+  });
+});
+
 describe('integrationsEventSchemas', () => {
   it('registers every integration publisher event type', () => {
     const registeredTypes = Object.keys(integrationsEventSchemas).sort();
 
     expect(registeredTypes).toEqual(
-      [INTEGRATION_EVENT_RECEIVED, INTEGRATION_SOURCE_COMMIT_PUSHED].sort(),
+      [
+        INTEGRATION_CONNECTION_AVAILABLE,
+        INTEGRATION_EVENT_RECEIVED,
+        INTEGRATION_SOURCE_COMMIT_PUSHED,
+        INTEGRATION_SOURCE_REPOSITORY_UPDATED,
+      ].sort(),
     );
   });
 });

package/src/events.ts

@@ -1,6 +1,7 @@
 import {z} from 'zod';
 
 export const INTEGRATION_EVENT_RECEIVED = 'integrations.event.received' as const;
+export const INTEGRATION_CONNECTION_AVAILABLE = 'integrations.connection.available' as const;
 
 const nonEmptyStringSchema = z.string().nonempty();
 const isoDateTimeSchema = z.string().datetime();
@@ -22,6 +23,16 @@ export const integrationEventReceivedSchema = z.object({
 });
 export type IntegrationEventReceivedEvent = z.infer<typeof integrationEventReceivedSchema>;
 
+export const integrationConnectionAvailableSchema = z.object({
+  provider: nonEmptyStringSchema,
+  workspaceId: nonEmptyStringSchema,
+  connectionId: nonEmptyStringSchema,
+  slug: nonEmptyStringSchema,
+});
+export type IntegrationConnectionAvailableEvent = z.infer<
+  typeof integrationConnectionAvailableSchema
+>;
+
 // A source-control push, normalized by the producing provider and carried by
 // `INTEGRATION_SOURCE_COMMIT_PUSHED` for domain consumers.
 export const sourcePushSchema = z.object({
@@ -51,6 +62,32 @@ export type IntegrationSourceCommitPushedEvent = z.infer<
   typeof integrationSourceCommitPushedSchema
 >;
 
+export const sourceRepositoryIdentitySchema = z.object({
+  externalRepositoryId: nonEmptyStringSchema,
+  owner: nonEmptyStringSchema,
+  name: nonEmptyStringSchema,
+  defaultBranch: nonEmptyStringSchema,
+});
+export type SourceRepositoryIdentity = z.infer<typeof sourceRepositoryIdentitySchema>;
+
+export const INTEGRATION_SOURCE_REPOSITORY_UPDATED =
+  'integrations.source_control.repository_updated' as const;
+
+// Typed, provider-agnostic source-control event. The producing provider owns the
+// translation from its raw webhook into this shape, so domain consumers never decode
+// provider payloads.
+export const integrationSourceRepositoryUpdatedSchema = z.object({
+  provider: nonEmptyStringSchema,
+  workspaceId: nonEmptyStringSchema,
+  connectionId: nonEmptyStringSchema,
+  deliveryId: nonEmptyStringSchema,
+  receivedAt: isoDateTimeSchema,
+  repository: sourceRepositoryIdentitySchema,
+});
+export type IntegrationSourceRepositoryUpdatedEvent = z.infer<
+  typeof integrationSourceRepositoryUpdatedSchema
+>;
+
 export interface SentryIssuePayload {
   action: SentryIssueAction;
   issueId: string;
@@ -81,11 +118,15 @@ export const SENTRY_ISSUE_ACTIONS = [
 export type SentryIssueAction = (typeof SENTRY_ISSUE_ACTIONS)[number];
 
 export interface IntegrationsEventMap {
+  [INTEGRATION_CONNECTION_AVAILABLE]: IntegrationConnectionAvailableEvent;
   [INTEGRATION_EVENT_RECEIVED]: IntegrationEventReceivedEvent;
   [INTEGRATION_SOURCE_COMMIT_PUSHED]: IntegrationSourceCommitPushedEvent;
+  [INTEGRATION_SOURCE_REPOSITORY_UPDATED]: IntegrationSourceRepositoryUpdatedEvent;
 }
 
 export const integrationsEventSchemas = {
+  [INTEGRATION_CONNECTION_AVAILABLE]: integrationConnectionAvailableSchema,
   [INTEGRATION_EVENT_RECEIVED]: integrationEventReceivedSchema,
   [INTEGRATION_SOURCE_COMMIT_PUSHED]: integrationSourceCommitPushedSchema,
+  [INTEGRATION_SOURCE_REPOSITORY_UPDATED]: integrationSourceRepositoryUpdatedSchema,
 } satisfies Record<keyof IntegrationsEventMap, z.ZodType>;

package/src/inter-module.test.ts

@@ -1,6 +1,32 @@
 import {integrationsInterModuleContract} from './inter-module.js';
 
 describe('integrationsInterModuleContract', () => {
+  test('accepts a nullable normalized trigger reference', () => {
+    const result = integrationsInterModuleContract.methods.resolveTriggerReference.output.parse({
+      externalRepositoryId: 'github:42',
+      ref: 'refs/heads/main',
+      commit: 'a'.repeat(40),
+      actor: 'octocat',
+    });
+
+    expect(result?.externalRepositoryId).toBe('github:42');
+    expect(result?.actor).toBe('octocat');
+    expect(
+      integrationsInterModuleContract.methods.resolveTriggerReference.output.parse(null),
+    ).toBeNull();
+  });
+
+  test('accepts a reference from a payload that named no actor', () => {
+    const result = integrationsInterModuleContract.methods.resolveTriggerReference.output.parse({
+      externalRepositoryId: 'github:42',
+      ref: 'refs/heads/main',
+      commit: 'a'.repeat(40),
+      actor: null,
+    });
+
+    expect(result?.actor).toBeNull();
+  });
+
   test('accepts a source repository lookup through the producer contract', () => {
     const result = integrationsInterModuleContract.methods.resolveSourceRepository.output.parse({
       connection: {
@@ -23,6 +49,22 @@ describe('integrationsInterModuleContract', () => {
     expect(result.repository.fullName).toBe('shipfox/project');
   });
 
+  test('accepts a workspace-scoped connection lookup through the producer contract', () => {
+    const input = integrationsInterModuleContract.methods.resolveConnection.input.parse({
+      workspaceId: '00000000-0000-4000-8000-000000000001',
+      slug: 'github-main',
+    });
+    const output = integrationsInterModuleContract.methods.resolveConnection.output.parse({
+      id: '00000000-0000-4000-8000-000000000002',
+      provider: 'github',
+      slug: 'github-main',
+    });
+
+    expect(input.slug).toBe('github-main');
+    expect(output?.id).toBe('00000000-0000-4000-8000-000000000002');
+    expect(integrationsInterModuleContract.methods.resolveConnection.output.parse(null)).toBeNull();
+  });
+
   test.each([
     ['connection-not-found', {connectionId: '00000000-0000-4000-8000-000000000001'}],
     ['provider-unavailable', {provider: 'github'}],

package/src/inter-module.ts

@@ -4,6 +4,7 @@ import {z} from 'zod';
 const id = z.string().uuid();
 const provider = z.string().min(1);
 const capability = z.enum(['source_control', 'agent_tools']);
+const connection = z.object({id, provider, slug: z.string().min(1)});
 const repository = z.object({
   externalRepositoryId: z.string(),
   owner: z.string(),
@@ -14,6 +15,12 @@ const repository = z.object({
   cloneUrl: z.string(),
   htmlUrl: z.string(),
 });
+const triggerReference = z.object({
+  externalRepositoryId: z.string(),
+  ref: z.string(),
+  commit: z.string(),
+  actor: z.string().nullable(),
+});
 const sourceInput = z.object({workspaceId: id, connectionId: id, externalRepositoryId: z.string()});
 const providerError = z.object({
   reason: z.string(),
@@ -35,7 +42,16 @@ export const integrationsInterModuleContract = defineInterModuleContract({
   methods: {
     resolveSourceRepository: {
       input: sourceInput,
-      output: z.object({connection: z.object({id, provider, slug: z.string()}), repository}),
+      output: z.object({connection, repository}),
+      errors: sourceErrors,
+    },
+    resolveConnection: {
+      input: z.object({workspaceId: id, slug: z.string().min(1)}),
+      output: connection.nullable(),
+    },
+    resolveTriggerReference: {
+      input: z.object({workspaceId: id, connectionId: id, payload: z.unknown()}),
+      output: triggerReference.nullable(),
       errors: sourceErrors,
     },
     listSourceFiles: {

package/src/webhooks.test.ts

@@ -90,6 +90,24 @@ describe('storedWebhookRequestSchema', () => {
     expect(storedWebhookRequestSchema.safeParse(withoutConnectionId).success).toBe(false);
   });
 
+  it('requires and round-trips a connection identifier for Jira requests', () => {
+    const request = createStoredWebhookRequest({
+      requestId,
+      routeId: 'jira',
+      receivedAt,
+      rawQueryString: '',
+      headers: {authorization: 'Bearer token'},
+      body: new Uint8Array([1, 2, 3]),
+      connectionId: 'c0a8012e-0b6d-4d8f-8d5c-6d74102602b0',
+    });
+
+    expect(request.path_parameters.connection_id).toBe('c0a8012e-0b6d-4d8f-8d5c-6d74102602b0');
+    expect(storedWebhookRequestSchema.parse(JSON.parse(JSON.stringify(request)))).toEqual(request);
+    expect(storedWebhookRequestSchema.safeParse({...request, path_parameters: {}}).success).toBe(
+      false,
+    );
+  });
+
   it('keeps the maximum-size fixture below the SQS message limit', () => {
     const fixture = createMaximumSizeStoredWebhookRequestFixture();
     const serializedSize = new TextEncoder().encode(JSON.stringify(fixture)).byteLength;

package/src/webhooks.ts

@@ -15,7 +15,7 @@ const standardWebhookRouteIds = [
   'slack.command',
 ] as const;
 
-export const webhookRouteIds = [...standardWebhookRouteIds, 'webhook.connection'] as const;
+export const webhookRouteIds = [...standardWebhookRouteIds, 'webhook.connection', 'jira'] as const;
 
 export const webhookRouteIdSchema = z.enum(webhookRouteIds);
 export type WebhookRouteId = z.infer<typeof webhookRouteIdSchema>;
@@ -87,9 +87,17 @@ const genericWebhookRouteRequestSchema = storedWebhookRequestBaseSchema
   })
   .strict();
 
+const jiraWebhookRouteRequestSchema = storedWebhookRequestBaseSchema
+  .extend({
+    route_id: z.literal('jira'),
+    path_parameters: connectionPathParametersSchema,
+  })
+  .strict();
+
 export const storedWebhookRequestSchema = z.discriminatedUnion('route_id', [
   standardWebhookRouteRequestSchema,
   genericWebhookRouteRequestSchema,
+  jiraWebhookRouteRequestSchema,
 ]);
 export type StoredWebhookRequest = z.infer<typeof storedWebhookRequestSchema>;
 
@@ -119,16 +127,27 @@ export const webhookProcessingResultSchema = z.discriminatedUnion('outcome', [
 ]);
 export type WebhookProcessingResult = z.infer<typeof webhookProcessingResultSchema>;
 
-export interface CreateStoredWebhookRequestInput {
+interface CreateStoredWebhookRequestInputBase {
   requestId: string;
   routeId: WebhookRouteId;
   receivedAt: string;
   rawQueryString: string;
   headers: Record<string, string>;
   body: Uint8Array;
-  connectionId?: string | undefined;
 }
 
+type ConnectionScopedWebhookRouteId = 'webhook.connection' | 'jira';
+
+export type CreateStoredWebhookRequestInput =
+  | (CreateStoredWebhookRequestInputBase & {
+      routeId: ConnectionScopedWebhookRouteId;
+      connectionId: string;
+    })
+  | (CreateStoredWebhookRequestInputBase & {
+      routeId: Exclude<WebhookRouteId, ConnectionScopedWebhookRouteId>;
+      connectionId?: never;
+    });
+
 export function encodeWebhookBody(body: Uint8Array): string {
   let encoded = '';
 
@@ -188,7 +207,9 @@ export function createStoredWebhookRequest(
   input: CreateStoredWebhookRequestInput,
 ): StoredWebhookRequest {
   const pathParameters =
-    input.routeId === 'webhook.connection' ? {connection_id: input.connectionId} : {};
+    input.routeId === 'webhook.connection' || input.routeId === 'jira'
+      ? {connection_id: input.connectionId}
+      : {};
 
   return storedWebhookRequestSchema.parse({
     schema_version: WEBHOOK_REQUEST_SCHEMA_VERSION,