@shipfox/api-integration-linear-dto 12.0.0 → 14.0.0

package/.turbo/turbo-build.log

@@ -1,2 +1,2 @@
 $ shipfox-swc
-Successfully compiled: 2 files with swc (272.68ms)
+Successfully compiled: 3 files with swc (362.77ms)

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @shipfox/api-integration-linear-dto
 
+## 14.0.0
+
+### Minor Changes
+
+- 2323e2e: Adds event catalog exports to the Linear, Slack, and Jira DTO packages.
+
+### Patch Changes
+
+- Updated dependencies [18e9bad]
+- Updated dependencies [c44641f]
+- Updated dependencies [1b71a66]
+  - @shipfox/api-integration-core-dto@14.0.0
+
+## 12.2.0
+
+### Patch Changes
+
+- Updated dependencies [7901a60]
+  - @shipfox/api-integration-core-dto@12.2.0
+
 ## 12.0.0
 
 ### Patch Changes

package/dist/event-catalog.d.ts

@@ -0,0 +1,23 @@
+export declare const linearEventCatalog: {
+    readonly provider: 'Linear';
+    readonly events: readonly ({
+        name: string;
+        summary: string;
+        emittedWhen: string;
+        payloadKind: 'raw-provider';
+        payloadDocUrl: string;
+    } | {
+        summary: 'A Linear agent session is created.';
+        emittedWhen: 'Linear creates an agent session after a user mentions or delegates to the app.';
+        name: "agentSession.created" | "agentSession.prompted";
+        payloadKind: 'raw-provider';
+        payloadDocUrl: string;
+    } | {
+        summary: 'A user adds a prompt to a Linear agent session.';
+        emittedWhen: 'Linear sends an AgentSessionEvent webhook with the prompted action.';
+        name: "agentSession.created" | "agentSession.prompted";
+        payloadKind: 'raw-provider';
+        payloadDocUrl: string;
+    })[];
+};
+//# sourceMappingURL=event-catalog.d.ts.map

package/dist/event-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-catalog.d.ts","sourceRoot":"","sources":["../src/event-catalog.ts"],"names":[],"mappings":"AAyCA,eAAO,MAAM,kBAAkB;uBACnB,QAAQ;;;;;qBAOC,cAAc;;;iBAvBtB,oCAAoC;qBAChC,gFAAgF;;qBA6B9E,cAAc;;;iBA1BpB,iDAAiD;qBAC7C,qEAAqE;;qBAyBnE,cAAc;;;CAIW,CAAC"}

package/dist/event-catalog.js

@@ -0,0 +1,48 @@
+import { linearAgentSessionWebhookEventNames, linearWebhookActions, linearWebhookResourceTypes } from './schemas/index.js';
+const linearWebhookDocsUrl = 'https://linear.app/developers/webhooks';
+const linearAgentInteractionDocsUrl = 'https://linear.app/developers/agent-interaction';
+const resourceLabels = {
+    Issue: 'issue',
+    Comment: 'comment',
+    IssueLabel: 'issue label',
+    Project: 'project',
+    Cycle: 'cycle'
+};
+const dataEventSummaryByAction = {
+    create: 'is created.',
+    update: 'changes.',
+    remove: 'is removed.'
+};
+const agentSessionDetails = {
+    'agentSession.created': {
+        summary: 'A Linear agent session is created.',
+        emittedWhen: 'Linear creates an agent session after a user mentions or delegates to the app.'
+    },
+    'agentSession.prompted': {
+        summary: 'A user adds a prompt to a Linear agent session.',
+        emittedWhen: 'Linear sends an AgentSessionEvent webhook with the prompted action.'
+    }
+};
+export const linearEventCatalog = {
+    provider: 'Linear',
+    events: [
+        ...linearWebhookResourceTypes.flatMap((type)=>linearWebhookActions.map((action)=>({
+                    name: `${type}.${action}`,
+                    summary: dataEventSummary(resourceLabels[type], action),
+                    emittedWhen: `Linear sends a webhook for ${type} with the ${action} action.`,
+                    payloadKind: 'raw-provider',
+                    payloadDocUrl: linearWebhookDocsUrl
+                }))),
+        ...linearAgentSessionWebhookEventNames.map((name)=>({
+                name,
+                ...agentSessionDetails[name],
+                payloadKind: 'raw-provider',
+                payloadDocUrl: linearAgentInteractionDocsUrl
+            }))
+    ]
+};
+function dataEventSummary(resource, action) {
+    return `A Linear ${resource} ${dataEventSummaryByAction[action]}`;
+}
+
+//# sourceMappingURL=event-catalog.js.map

package/dist/event-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/event-catalog.ts"],"sourcesContent":["import type {IntegrationEventCatalog} from '@shipfox/api-integration-core-dto';\nimport {\n  linearAgentSessionWebhookEventNames,\n  linearWebhookActions,\n  linearWebhookResourceTypes,\n} from './schemas/index.js';\n\nconst linearWebhookDocsUrl = 'https://linear.app/developers/webhooks';\nconst linearAgentInteractionDocsUrl = 'https://linear.app/developers/agent-interaction';\n\nconst resourceLabels = {\n  Issue: 'issue',\n  Comment: 'comment',\n  IssueLabel: 'issue label',\n  Project: 'project',\n  Cycle: 'cycle',\n} as const satisfies Record<(typeof linearWebhookResourceTypes)[number], string>;\n\nconst dataEventSummaryByAction = {\n  create: 'is created.',\n  update: 'changes.',\n  remove: 'is removed.',\n} as const satisfies Record<(typeof linearWebhookActions)[number], string>;\n\nconst agentSessionDetails = {\n  'agentSession.created': {\n    summary: 'A Linear agent session is created.',\n    emittedWhen: 'Linear creates an agent session after a user mentions or delegates to the app.',\n  },\n  'agentSession.prompted': {\n    summary: 'A user adds a prompt to a Linear agent session.',\n    emittedWhen: 'Linear sends an AgentSessionEvent webhook with the prompted action.',\n  },\n} as const satisfies Record<\n  (typeof linearAgentSessionWebhookEventNames)[number],\n  {\n    summary: string;\n    emittedWhen: string;\n  }\n>;\n\nexport const linearEventCatalog = {\n  provider: 'Linear',\n  events: [\n    ...linearWebhookResourceTypes.flatMap((type) =>\n      linearWebhookActions.map((action) => ({\n        name: `${type}.${action}`,\n        summary: dataEventSummary(resourceLabels[type], action),\n        emittedWhen: `Linear sends a webhook for ${type} with the ${action} action.`,\n        payloadKind: 'raw-provider' as const,\n        payloadDocUrl: linearWebhookDocsUrl,\n      })),\n    ),\n    ...linearAgentSessionWebhookEventNames.map((name) => ({\n      name,\n      ...agentSessionDetails[name],\n      payloadKind: 'raw-provider' as const,\n      payloadDocUrl: linearAgentInteractionDocsUrl,\n    })),\n  ],\n} as const satisfies IntegrationEventCatalog;\n\nfunction dataEventSummary(resource: string, action: (typeof linearWebhookActions)[number]): string {\n  return `A Linear ${resource} ${dataEventSummaryByAction[action]}`;\n}\n"],"names":["linearAgentSessionWebhookEventNames","linearWebhookActions","linearWebhookResourceTypes","linearWebhookDocsUrl","linearAgentInteractionDocsUrl","resourceLabels","Issue","Comment","IssueLabel","Project","Cycle","dataEventSummaryByAction","create","update","remove","agentSessionDetails","summary","emittedWhen","linearEventCatalog","provider","events","flatMap","type","map","action","name","dataEventSummary","payloadKind","payloadDocUrl","resource"],"mappings":"AACA,SACEA,mCAAmC,EACnCC,oBAAoB,EACpBC,0BAA0B,QACrB,qBAAqB;AAE5B,MAAMC,uBAAuB;AAC7B,MAAMC,gCAAgC;AAEtC,MAAMC,iBAAiB;IACrBC,OAAO;IACPC,SAAS;IACTC,YAAY;IACZC,SAAS;IACTC,OAAO;AACT;AAEA,MAAMC,2BAA2B;IAC/BC,QAAQ;IACRC,QAAQ;IACRC,QAAQ;AACV;AAEA,MAAMC,sBAAsB;IAC1B,wBAAwB;QACtBC,SAAS;QACTC,aAAa;IACf;IACA,yBAAyB;QACvBD,SAAS;QACTC,aAAa;IACf;AACF;AAQA,OAAO,MAAMC,qBAAqB;IAChCC,UAAU;IACVC,QAAQ;WACHlB,2BAA2BmB,OAAO,CAAC,CAACC,OACrCrB,qBAAqBsB,GAAG,CAAC,CAACC,SAAY,CAAA;oBACpCC,MAAM,GAAGH,KAAK,CAAC,EAAEE,QAAQ;oBACzBR,SAASU,iBAAiBrB,cAAc,CAACiB,KAAK,EAAEE;oBAChDP,aAAa,CAAC,2BAA2B,EAAEK,KAAK,UAAU,EAAEE,OAAO,QAAQ,CAAC;oBAC5EG,aAAa;oBACbC,eAAezB;gBACjB,CAAA;WAECH,oCAAoCuB,GAAG,CAAC,CAACE,OAAU,CAAA;gBACpDA;gBACA,GAAGV,mBAAmB,CAACU,KAAK;gBAC5BE,aAAa;gBACbC,eAAexB;YACjB,CAAA;KACD;AACH,EAA6C;AAE7C,SAASsB,iBAAiBG,QAAgB,EAAEL,MAA6C;IACvF,OAAO,CAAC,SAAS,EAAEK,SAAS,CAAC,EAAElB,wBAAwB,CAACa,OAAO,EAAE;AACnE"}

package/dist/index.d.ts

@@ -1,2 +1,3 @@
+export * from './event-catalog.js';
 export * from './schemas/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,3 +1,4 @@
+export * from './event-catalog.js';
 export * from './schemas/index.js';
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from './schemas/index.js';\n"],"names":[],"mappings":"AAAA,cAAc,qBAAqB"}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from './event-catalog.js';\nexport * from './schemas/index.js';\n"],"names":[],"mappings":"AAAA,cAAc,qBAAqB;AACnC,cAAc,qBAAqB"}

package/dist/schemas/index.d.ts

@@ -1,11 +1,11 @@
 import { z } from 'zod';
 export declare const LINEAR_PROVIDER = "linear";
 export type LinearProvider = typeof LINEAR_PROVIDER;
-export declare const linearWebhookResourceTypes: readonly ["Issue", "Comment", "IssueLabel", "Project", "Cycle"];
-export declare const linearWebhookActions: readonly ["create", "update", "remove"];
-export declare const linearAgentSessionWebhookActions: readonly ["created", "prompted"];
+export declare const linearWebhookResourceTypes: readonly ['Issue', 'Comment', 'IssueLabel', 'Project', 'Cycle'];
+export declare const linearWebhookActions: readonly ['create', 'update', 'remove'];
+export declare const linearAgentSessionWebhookActions: readonly ['created', 'prompted'];
 export declare const linearAgentSessionWebhookEventNames: ("agentSession.created" | "agentSession.prompted")[];
-export declare const linearWebhookEventNames: readonly ("agentSession.created" | "agentSession.prompted" | "Issue.create" | "Issue.update" | "Issue.remove" | "Comment.create" | "Comment.update" | "Comment.remove" | "IssueLabel.create" | "IssueLabel.update" | "IssueLabel.remove" | "Project.create" | "Project.update" | "Project.remove" | "Cycle.create" | "Cycle.update" | "Cycle.remove")[];
+export declare const linearWebhookEventNames: readonly ("Comment.create" | "Comment.remove" | "Comment.update" | "Cycle.create" | "Cycle.remove" | "Cycle.update" | "Issue.create" | "Issue.remove" | "Issue.update" | "IssueLabel.create" | "IssueLabel.remove" | "IssueLabel.update" | "Project.create" | "Project.remove" | "Project.update" | "agentSession.created" | "agentSession.prompted")[];
 export type LinearWebhookResourceType = (typeof linearWebhookResourceTypes)[number];
 export type LinearWebhookAction = (typeof linearWebhookActions)[number];
 export type LinearAgentSessionWebhookAction = (typeof linearAgentSessionWebhookActions)[number];
@@ -35,15 +35,15 @@ export type LinearAgentSessionWebhookEnvelopeDto = z.infer<typeof linearAgentSes
 export declare const linearWebhookEnvelopeSchema: z.ZodUnion<readonly [z.ZodObject<{
     action: z.ZodEnum<{
         create: "create";
-        update: "update";
         remove: "remove";
+        update: "update";
     }>;
     type: z.ZodEnum<{
-        Issue: "Issue";
         Comment: "Comment";
+        Cycle: "Cycle";
+        Issue: "Issue";
         IssueLabel: "IssueLabel";
         Project: "Project";
-        Cycle: "Cycle";
     }>;
     organizationId: z.ZodString;
     webhookTimestamp: z.ZodNumber;
@@ -100,13 +100,13 @@ export declare const linearCallbackResponseSchema: z.ZodObject<{
     slug: z.ZodString;
     display_name: z.ZodString;
     lifecycle_status: z.ZodEnum<{
-        error: "error";
         active: "active";
         disabled: "disabled";
+        error: "error";
     }>;
     capabilities: z.ZodArray<z.ZodEnum<{
-        source_control: "source_control";
         agent_tools: "agent_tools";
+        source_control: "source_control";
     }>>;
     external_url: z.ZodOptional<z.ZodString>;
     created_at: z.ZodString;
@@ -131,13 +131,13 @@ export declare const createE2eLinearConnectionResponseSchema: z.ZodObject<{
     slug: z.ZodString;
     display_name: z.ZodString;
     lifecycle_status: z.ZodEnum<{
-        error: "error";
         active: "active";
         disabled: "disabled";
+        error: "error";
     }>;
     capabilities: z.ZodArray<z.ZodEnum<{
-        source_control: "source_control";
         agent_tools: "agent_tools";
+        source_control: "source_control";
     }>>;
     external_url: z.ZodOptional<z.ZodString>;
     created_at: z.ZodString;

package/dist/schemas/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,eAAO,MAAM,eAAe,WAAW,CAAC;AAExC,MAAM,MAAM,cAAc,GAAG,OAAO,eAAe,CAAC;AAEpD,eAAO,MAAM,0BAA0B,iEAM7B,CAAC;AACX,eAAO,MAAM,oBAAoB,yCAA0C,CAAC;AAC5E,eAAO,MAAM,gCAAgC,kCAAmC,CAAC;AAKjF,eAAO,MAAM,mCAAmC,sDAE/C,CAAC;AACF,eAAO,MAAM,uBAAuB,yVAG1B,CAAC;AAEX,MAAM,MAAM,yBAAyB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AACpF,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AACxE,MAAM,MAAM,+BAA+B,GAAG,CAAC,OAAO,gCAAgC,CAAC,CAAC,MAAM,CAAC,CAAC;AAChG,MAAM,MAAM,kCAAkC,GAC5C,CAAC,OAAO,mCAAmC,CAAC,CAAC,MAAM,CAAC,CAAC;AACvD,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAoB9E,eAAO,MAAM,2CAA2C;;;;;;;iBAOtD,CAAC;AACH,MAAM,MAAM,wCAAwC,GAAG,CAAC,CAAC,KAAK,CAC5D,OAAO,2CAA2C,CACnD,CAAC;AAEF,eAAO,MAAM,uCAAuC;;;;;;;;;;iBAGhD,CAAC;AACL,MAAM,MAAM,oCAAoC,GAAG,CAAC,CAAC,KAAK,CACxD,OAAO,uCAAuC,CAC/C,CAAC;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;mBAGtC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEnF,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;mBAG1C,CAAC;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAE3F,eAAO,MAAM,6BAA6B;;iBAExC,CAAC;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEvF,eAAO,MAAM,iCAAiC;;iBAE5C,CAAC;AACH,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE/F,eAAO,MAAM,yBAAyB;;;;;;;mBAUpC,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE/E,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;iBAAiC,CAAC;AAC3E,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAErF,eAAO,MAAM,mCAAmC;;;;;;;;iBAQ9C,CAAC;AACH,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAEnG,eAAO,MAAM,uCAAuC;;;;;;;;;;;;;;;;;;;iBAAiC,CAAC;AACtF,MAAM,MAAM,oCAAoC,GAAG,CAAC,CAAC,KAAK,CACxD,OAAO,uCAAuC,CAC/C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,eAAO,MAAM,eAAe,WAAW,CAAC;AAExC,MAAM,MAAM,cAAc,GAAG,OAAO,eAAe,CAAC;AAEpD,eAAO,MAAM,0BAA0B,YACrC,OAAO,EACP,SAAS,EACT,YAAY,EACZ,SAAS,EACT,OAAO,CACC,CAAC;AACX,eAAO,MAAM,oBAAoB,YAAI,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAC;AAC5E,eAAO,MAAM,gCAAgC,YAAI,SAAS,EAAE,UAAU,CAAU,CAAC;AAKjF,eAAO,MAAM,mCAAmC,sDAE/C,CAAC;AACF,eAAO,MAAM,uBAAuB,yVAG1B,CAAC;AAEX,MAAM,MAAM,yBAAyB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AACpF,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AACxE,MAAM,MAAM,+BAA+B,GAAG,CAAC,OAAO,gCAAgC,CAAC,CAAC,MAAM,CAAC,CAAC;AAChG,MAAM,MAAM,kCAAkC,GAC5C,CAAC,OAAO,mCAAmC,CAAC,CAAC,MAAM,CAAC,CAAC;AACvD,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAoB9E,eAAO,MAAM,2CAA2C;;;;;;;iBAOtD,CAAC;AACH,MAAM,MAAM,wCAAwC,GAAG,CAAC,CAAC,KAAK,CAC5D,OAAO,2CAA2C,CACnD,CAAC;AAEF,eAAO,MAAM,uCAAuC;;;;;;;;;;iBAGhD,CAAC;AACL,MAAM,MAAM,oCAAoC,GAAG,CAAC,CAAC,KAAK,CACxD,OAAO,uCAAuC,CAC/C,CAAC;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;mBAGtC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEnF,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;mBAG1C,CAAC;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAE3F,eAAO,MAAM,6BAA6B;;iBAExC,CAAC;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEvF,eAAO,MAAM,iCAAiC;;iBAE5C,CAAC;AACH,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE/F,eAAO,MAAM,yBAAyB;;;;;;;mBAUpC,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE/E,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;iBAAiC,CAAC;AAC3E,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAErF,eAAO,MAAM,mCAAmC;;;;;;;;iBAQ9C,CAAC;AACH,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAEnG,eAAO,MAAM,uCAAuC;;;;;;;;;;;;;;;;;;;iBAAiC,CAAC;AACtF,MAAM,MAAM,oCAAoC,GAAG,CAAC,CAAC,KAAK,CACxD,OAAO,uCAAuC,CAC/C,CAAC"}