@shipfox/api-integration-linear 2.0.0

package/dist/db/schema/installations.d.ts

@@ -0,0 +1,186 @@
+import type { LinearInstallation } from '#db/installations.js';
+export declare const linearInstallations: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "installations";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "installations";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        connectionId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "connection_id";
+            tableName: "installations";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        organizationId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "organization_id";
+            tableName: "installations";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        organizationUrlKey: import("drizzle-orm/pg-core").PgColumn<{
+            name: "organization_url_key";
+            tableName: "installations";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        appUserId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "app_user_id";
+            tableName: "installations";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        scopes: import("drizzle-orm/pg-core").PgColumn<{
+            name: "scopes";
+            tableName: "installations";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: string[];
+            driverParam: unknown;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: string[];
+        }>;
+        tokenExpiresAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "token_expires_at";
+            tableName: "installations";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        status: import("drizzle-orm/pg-core").PgColumn<{
+            name: "status";
+            tableName: "installations";
+            dataType: "string";
+            columnType: "PgText";
+            data: import("#db/installations.js").LinearInstallationStatus;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: import("#db/installations.js").LinearInstallationStatus;
+        }>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "installations";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        updatedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "updated_at";
+            tableName: "installations";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+export type LinearInstallationDb = typeof linearInstallations.$inferSelect;
+export type LinearInstallationCreateDb = typeof linearInstallations.$inferInsert;
+export declare function toLinearInstallation(row: LinearInstallationDb): LinearInstallation;
+//# sourceMappingURL=installations.d.ts.map

package/dist/db/schema/installations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installations.d.ts","sourceRoot":"","sources":["../../../src/db/schema/installations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AAG7D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkB/B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,OAAO,mBAAmB,CAAC,YAAY,CAAC;AAC3E,MAAM,MAAM,0BAA0B,GAAG,OAAO,mBAAmB,CAAC,YAAY,CAAC;AAEjF,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,oBAAoB,GAAG,kBAAkB,CAalF"}

package/dist/db/schema/installations.js

@@ -0,0 +1,40 @@
+import { uuidv7PrimaryKey } from '@shipfox/node-drizzle';
+import { jsonb, text, timestamp, uniqueIndex, uuid } from 'drizzle-orm/pg-core';
+import { pgTable } from './common.js';
+export const linearInstallations = pgTable('installations', {
+    id: uuidv7PrimaryKey(),
+    connectionId: uuid('connection_id').notNull(),
+    organizationId: text('organization_id').notNull(),
+    organizationUrlKey: text('organization_url_key').notNull(),
+    appUserId: text('app_user_id').notNull(),
+    scopes: jsonb('scopes').notNull().$type(),
+    tokenExpiresAt: timestamp('token_expires_at', {
+        withTimezone: true
+    }),
+    status: text('status').notNull().$type(),
+    createdAt: timestamp('created_at', {
+        withTimezone: true
+    }).notNull().defaultNow(),
+    updatedAt: timestamp('updated_at', {
+        withTimezone: true
+    }).notNull().defaultNow()
+}, (table)=>[
+        uniqueIndex('integrations_linear_installations_connection_unique').on(table.connectionId),
+        uniqueIndex('integrations_linear_installations_organization_unique').on(table.organizationId)
+    ]);
+export function toLinearInstallation(row) {
+    return {
+        id: row.id,
+        connectionId: row.connectionId,
+        organizationId: row.organizationId,
+        organizationUrlKey: row.organizationUrlKey,
+        appUserId: row.appUserId,
+        scopes: row.scopes,
+        tokenExpiresAt: row.tokenExpiresAt,
+        status: row.status,
+        createdAt: row.createdAt,
+        updatedAt: row.updatedAt
+    };
+}
+
+//# sourceMappingURL=installations.js.map

package/dist/db/schema/installations.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/db/schema/installations.ts"],"sourcesContent":["import {uuidv7PrimaryKey} from '@shipfox/node-drizzle';\nimport {jsonb, text, timestamp, uniqueIndex, uuid} from 'drizzle-orm/pg-core';\nimport type {LinearInstallation} from '#db/installations.js';\nimport {pgTable} from './common.js';\n\nexport const linearInstallations = pgTable(\n  'installations',\n  {\n    id: uuidv7PrimaryKey(),\n    connectionId: uuid('connection_id').notNull(),\n    organizationId: text('organization_id').notNull(),\n    organizationUrlKey: text('organization_url_key').notNull(),\n    appUserId: text('app_user_id').notNull(),\n    scopes: jsonb('scopes').notNull().$type<string[]>(),\n    tokenExpiresAt: timestamp('token_expires_at', {withTimezone: true}),\n    status: text('status').notNull().$type<LinearInstallation['status']>(),\n    createdAt: timestamp('created_at', {withTimezone: true}).notNull().defaultNow(),\n    updatedAt: timestamp('updated_at', {withTimezone: true}).notNull().defaultNow(),\n  },\n  (table) => [\n    uniqueIndex('integrations_linear_installations_connection_unique').on(table.connectionId),\n    uniqueIndex('integrations_linear_installations_organization_unique').on(table.organizationId),\n  ],\n);\n\nexport type LinearInstallationDb = typeof linearInstallations.$inferSelect;\nexport type LinearInstallationCreateDb = typeof linearInstallations.$inferInsert;\n\nexport function toLinearInstallation(row: LinearInstallationDb): LinearInstallation {\n  return {\n    id: row.id,\n    connectionId: row.connectionId,\n    organizationId: row.organizationId,\n    organizationUrlKey: row.organizationUrlKey,\n    appUserId: row.appUserId,\n    scopes: row.scopes,\n    tokenExpiresAt: row.tokenExpiresAt,\n    status: row.status,\n    createdAt: row.createdAt,\n    updatedAt: row.updatedAt,\n  };\n}\n"],"names":["uuidv7PrimaryKey","jsonb","text","timestamp","uniqueIndex","uuid","pgTable","linearInstallations","id","connectionId","notNull","organizationId","organizationUrlKey","appUserId","scopes","$type","tokenExpiresAt","withTimezone","status","createdAt","defaultNow","updatedAt","table","on","toLinearInstallation","row"],"mappings":"AAAA,SAAQA,gBAAgB,QAAO,wBAAwB;AACvD,SAAQC,KAAK,EAAEC,IAAI,EAAEC,SAAS,EAAEC,WAAW,EAAEC,IAAI,QAAO,sBAAsB;AAE9E,SAAQC,OAAO,QAAO,cAAc;AAEpC,OAAO,MAAMC,sBAAsBD,QACjC,iBACA;IACEE,IAAIR;IACJS,cAAcJ,KAAK,iBAAiBK,OAAO;IAC3CC,gBAAgBT,KAAK,mBAAmBQ,OAAO;IAC/CE,oBAAoBV,KAAK,wBAAwBQ,OAAO;IACxDG,WAAWX,KAAK,eAAeQ,OAAO;IACtCI,QAAQb,MAAM,UAAUS,OAAO,GAAGK,KAAK;IACvCC,gBAAgBb,UAAU,oBAAoB;QAACc,cAAc;IAAI;IACjEC,QAAQhB,KAAK,UAAUQ,OAAO,GAAGK,KAAK;IACtCI,WAAWhB,UAAU,cAAc;QAACc,cAAc;IAAI,GAAGP,OAAO,GAAGU,UAAU;IAC7EC,WAAWlB,UAAU,cAAc;QAACc,cAAc;IAAI,GAAGP,OAAO,GAAGU,UAAU;AAC/E,GACA,CAACE,QAAU;QACTlB,YAAY,uDAAuDmB,EAAE,CAACD,MAAMb,YAAY;QACxFL,YAAY,yDAAyDmB,EAAE,CAACD,MAAMX,cAAc;KAC7F,EACD;AAKF,OAAO,SAASa,qBAAqBC,GAAyB;IAC5D,OAAO;QACLjB,IAAIiB,IAAIjB,EAAE;QACVC,cAAcgB,IAAIhB,YAAY;QAC9BE,gBAAgBc,IAAId,cAAc;QAClCC,oBAAoBa,IAAIb,kBAAkB;QAC1CC,WAAWY,IAAIZ,SAAS;QACxBC,QAAQW,IAAIX,MAAM;QAClBE,gBAAgBS,IAAIT,cAAc;QAClCE,QAAQO,IAAIP,MAAM;QAClBC,WAAWM,IAAIN,SAAS;QACxBE,WAAWI,IAAIJ,SAAS;IAC1B;AACF"}

package/dist/index.d.ts

@@ -0,0 +1,53 @@
+import { type LinearApiClient } from '#api/client.js';
+import { config } from '#config.js';
+import { LinearAgentToolsProvider } from '#core/agent-tools-provider.js';
+import type { LinearTokenStore } from '#core/tokens.js';
+import { closeDb, db } from '#db/db.js';
+import { getLinearInstallationByConnectionId } from '#db/installations.js';
+import { migrationsPath } from '#db/migrations.js';
+import { type CreateLinearIntegrationRoutesOptions } from '#presentation/routes/install.js';
+import { type CreateLinearWebhookRoutesOptions } from '#presentation/routes/webhooks.js';
+export type { LinearProvider } from '@shipfox/api-integration-linear-dto';
+export type { LinearApiClient, LinearAuthorization, LinearIdentity } from '#api/client.js';
+export { createLinearApiClient } from '#api/client.js';
+export type { LinearAgentToolCatalogEntry, LinearAgentToolCategory, LinearAgentToolId, LinearAgentToolRequiredScope, } from '#core/agent-tools.js';
+export { linearAgentToolCatalog, linearAgentToolSelectionCatalog, } from '#core/agent-tools.js';
+export { type DisconnectLinearInstallationParams, disconnectLinearInstallation, } from '#core/disconnect.js';
+export { LinearAccessTokenMissingError, LinearAuthorizationScopeMismatchError, LinearConnectionAlreadyLinkedError, LinearConnectionNotFoundError, LinearInstallationAlreadyLinkedError, LinearInstallStateActorMismatchError, LinearInstallStateError, LinearIntegrationProviderError, LinearOAuthCallbackError, LinearTokenUnrefreshableError, } from '#core/errors.js';
+export type { ConnectLinearInstallationInput, HandleLinearCallbackParams } from '#core/install.js';
+export { handleLinearCallback, handleLinearOAuthCallbackError } from '#core/install.js';
+export { assertLinearAuthorizationScopes, formatLinearOAuthScopes, LINEAR_OAUTH_SCOPES, } from '#core/scopes.js';
+export type { LinearInstallStateClaims } from '#core/state.js';
+export { signLinearInstallState, verifyLinearInstallState } from '#core/state.js';
+export type { CreateLinearTokenStoreParams, GetLinearAccessTokenParams, LinearConnectionResolverResult, LinearSecretsStore, LinearTokenStore, StoreLinearTokensParams, } from '#core/tokens.js';
+export { createLinearTokenStore, linearSecretsNamespace, } from '#core/tokens.js';
+export type { HandleLinearWebhookOutcome, HandleLinearWebhookParams } from '#core/webhook.js';
+export { handleLinearWebhook } from '#core/webhook.js';
+export type { LinearInstallation, LinearInstallationStatus, UpdateLinearInstallationTokenExpiryParams, UpsertLinearInstallationParams, } from '#db/installations.js';
+export { getLinearInstallationByConnectionId, getLinearInstallationByOrganizationId, markLinearInstallationRevoked, updateLinearInstallationTokenExpiry, upsertLinearInstallation, withLinearRefreshLock, } from '#db/installations.js';
+export { type CreateLinearE2eRoutesOptions, createLinearE2eRoutes, } from '#presentation/e2eRoutes/index.js';
+export { closeDb, config, db, migrationsPath };
+export interface CreateLinearIntegrationProviderOptions {
+    linear?: LinearApiClient | undefined;
+    agentTools?: {
+        tokenStore: Pick<LinearTokenStore, 'getAccessToken'>;
+        endpoint?: string | URL | undefined;
+        callTimeoutMs?: number | undefined;
+    } | undefined;
+    getLinearInstallationByConnectionId?: typeof getLinearInstallationByConnectionId | undefined;
+    routes?: (Omit<CreateLinearIntegrationRoutesOptions, 'linear' | 'connectionCapabilities'> & Partial<CreateLinearWebhookRoutesOptions>) | undefined;
+}
+export declare function createLinearIntegrationProvider(options?: CreateLinearIntegrationProviderOptions): {
+    provider: string;
+    displayName: string;
+    adapters: {
+        agent_tools: LinearAgentToolsProvider;
+    } | {
+        agent_tools?: never;
+    };
+    connectionExternalUrl(connection: {
+        id: string;
+    }): Promise<string | undefined>;
+    routes: import("@shipfox/node-fastify").RouteGroup[];
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,56 @@
+import { LINEAR_PROVIDER } from '@shipfox/api-integration-linear-dto';
+import { createLinearApiClient } from '#api/client.js';
+import { config } from '#config.js';
+import { LinearAgentToolsProvider } from '#core/agent-tools-provider.js';
+import { closeDb, db } from '#db/db.js';
+import { getLinearInstallationByConnectionId } from '#db/installations.js';
+import { migrationsPath } from '#db/migrations.js';
+import { createLinearIntegrationRoutes } from '#presentation/routes/install.js';
+import { createLinearWebhookRoutes } from '#presentation/routes/webhooks.js';
+export { createLinearApiClient } from '#api/client.js';
+export { linearAgentToolCatalog, linearAgentToolSelectionCatalog } from '#core/agent-tools.js';
+export { disconnectLinearInstallation } from '#core/disconnect.js';
+export { LinearAccessTokenMissingError, LinearAuthorizationScopeMismatchError, LinearConnectionAlreadyLinkedError, LinearConnectionNotFoundError, LinearInstallationAlreadyLinkedError, LinearInstallStateActorMismatchError, LinearInstallStateError, LinearIntegrationProviderError, LinearOAuthCallbackError, LinearTokenUnrefreshableError } from '#core/errors.js';
+export { handleLinearCallback, handleLinearOAuthCallbackError } from '#core/install.js';
+export { assertLinearAuthorizationScopes, formatLinearOAuthScopes, LINEAR_OAUTH_SCOPES } from '#core/scopes.js';
+export { signLinearInstallState, verifyLinearInstallState } from '#core/state.js';
+export { createLinearTokenStore, linearSecretsNamespace } from '#core/tokens.js';
+export { handleLinearWebhook } from '#core/webhook.js';
+export { getLinearInstallationByConnectionId, getLinearInstallationByOrganizationId, markLinearInstallationRevoked, updateLinearInstallationTokenExpiry, upsertLinearInstallation, withLinearRefreshLock } from '#db/installations.js';
+export { createLinearE2eRoutes } from '#presentation/e2eRoutes/index.js';
+export { closeDb, config, db, migrationsPath };
+export function createLinearIntegrationProvider(options = {}) {
+    const linear = options.linear ?? createLinearApiClient();
+    const getInstallationByConnectionId = options.getLinearInstallationByConnectionId ?? getLinearInstallationByConnectionId;
+    const adapters = options.agentTools ? {
+        agent_tools: new LinearAgentToolsProvider(options.agentTools)
+    } : {};
+    const routes = options.routes ? [
+        createLinearIntegrationRoutes({
+            linear,
+            connectionCapabilities: adapters.agent_tools ? [
+                'agent_tools'
+            ] : [],
+            ...options.routes
+        })
+    ] : [];
+    if (options.routes && hasLinearWebhookRoutesOptions(options.routes)) {
+        routes.push(createLinearWebhookRoutes(options.routes));
+    }
+    return {
+        provider: LINEAR_PROVIDER,
+        displayName: 'Linear',
+        adapters,
+        async connectionExternalUrl (connection) {
+            const installation = await getInstallationByConnectionId(connection.id);
+            if (!installation?.organizationUrlKey) return undefined;
+            return `https://linear.app/${encodeURIComponent(installation.organizationUrlKey)}/settings`;
+        },
+        routes
+    };
+}
+function hasLinearWebhookRoutesOptions(routes) {
+    return routes.coreDb !== undefined && routes.publishIntegrationEventReceived !== undefined && routes.recordDeliveryOnly !== undefined && routes.getIntegrationConnectionById !== undefined;
+}
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import {LINEAR_PROVIDER} from '@shipfox/api-integration-linear-dto';\nimport {createLinearApiClient, type LinearApiClient} from '#api/client.js';\nimport {config} from '#config.js';\nimport {LinearAgentToolsProvider} from '#core/agent-tools-provider.js';\nimport type {LinearTokenStore} from '#core/tokens.js';\nimport {closeDb, db} from '#db/db.js';\nimport {getLinearInstallationByConnectionId} from '#db/installations.js';\nimport {migrationsPath} from '#db/migrations.js';\nimport {\n  type CreateLinearIntegrationRoutesOptions,\n  createLinearIntegrationRoutes,\n} from '#presentation/routes/install.js';\nimport {\n  type CreateLinearWebhookRoutesOptions,\n  createLinearWebhookRoutes,\n} from '#presentation/routes/webhooks.js';\n\nexport type {LinearProvider} from '@shipfox/api-integration-linear-dto';\nexport type {LinearApiClient, LinearAuthorization, LinearIdentity} from '#api/client.js';\nexport {createLinearApiClient} from '#api/client.js';\nexport type {\n  LinearAgentToolCatalogEntry,\n  LinearAgentToolCategory,\n  LinearAgentToolId,\n  LinearAgentToolRequiredScope,\n} from '#core/agent-tools.js';\nexport {\n  linearAgentToolCatalog,\n  linearAgentToolSelectionCatalog,\n} from '#core/agent-tools.js';\nexport {\n  type DisconnectLinearInstallationParams,\n  disconnectLinearInstallation,\n} from '#core/disconnect.js';\nexport {\n  LinearAccessTokenMissingError,\n  LinearAuthorizationScopeMismatchError,\n  LinearConnectionAlreadyLinkedError,\n  LinearConnectionNotFoundError,\n  LinearInstallationAlreadyLinkedError,\n  LinearInstallStateActorMismatchError,\n  LinearInstallStateError,\n  LinearIntegrationProviderError,\n  LinearOAuthCallbackError,\n  LinearTokenUnrefreshableError,\n} from '#core/errors.js';\nexport type {ConnectLinearInstallationInput, HandleLinearCallbackParams} from '#core/install.js';\nexport {handleLinearCallback, handleLinearOAuthCallbackError} from '#core/install.js';\nexport {\n  assertLinearAuthorizationScopes,\n  formatLinearOAuthScopes,\n  LINEAR_OAUTH_SCOPES,\n} from '#core/scopes.js';\nexport type {LinearInstallStateClaims} from '#core/state.js';\nexport {signLinearInstallState, verifyLinearInstallState} from '#core/state.js';\nexport type {\n  CreateLinearTokenStoreParams,\n  GetLinearAccessTokenParams,\n  LinearConnectionResolverResult,\n  LinearSecretsStore,\n  LinearTokenStore,\n  StoreLinearTokensParams,\n} from '#core/tokens.js';\nexport {\n  createLinearTokenStore,\n  linearSecretsNamespace,\n} from '#core/tokens.js';\nexport type {HandleLinearWebhookOutcome, HandleLinearWebhookParams} from '#core/webhook.js';\nexport {handleLinearWebhook} from '#core/webhook.js';\nexport type {\n  LinearInstallation,\n  LinearInstallationStatus,\n  UpdateLinearInstallationTokenExpiryParams,\n  UpsertLinearInstallationParams,\n} from '#db/installations.js';\nexport {\n  getLinearInstallationByConnectionId,\n  getLinearInstallationByOrganizationId,\n  markLinearInstallationRevoked,\n  updateLinearInstallationTokenExpiry,\n  upsertLinearInstallation,\n  withLinearRefreshLock,\n} from '#db/installations.js';\nexport {\n  type CreateLinearE2eRoutesOptions,\n  createLinearE2eRoutes,\n} from '#presentation/e2eRoutes/index.js';\nexport {closeDb, config, db, migrationsPath};\n\nexport interface CreateLinearIntegrationProviderOptions {\n  linear?: LinearApiClient | undefined;\n  agentTools?:\n    | {\n        tokenStore: Pick<LinearTokenStore, 'getAccessToken'>;\n        endpoint?: string | URL | undefined;\n        callTimeoutMs?: number | undefined;\n      }\n    | undefined;\n  getLinearInstallationByConnectionId?: typeof getLinearInstallationByConnectionId | undefined;\n  routes?:\n    | (Omit<CreateLinearIntegrationRoutesOptions, 'linear' | 'connectionCapabilities'> &\n        Partial<CreateLinearWebhookRoutesOptions>)\n    | undefined;\n}\n\nexport function createLinearIntegrationProvider(\n  options: CreateLinearIntegrationProviderOptions = {},\n) {\n  const linear = options.linear ?? createLinearApiClient();\n  const getInstallationByConnectionId =\n    options.getLinearInstallationByConnectionId ?? getLinearInstallationByConnectionId;\n  const adapters = options.agentTools\n    ? {\n        agent_tools: new LinearAgentToolsProvider(options.agentTools),\n      }\n    : {};\n\n  const routes = options.routes\n    ? [\n        createLinearIntegrationRoutes({\n          linear,\n          connectionCapabilities: adapters.agent_tools ? ['agent_tools'] : [],\n          ...options.routes,\n        }),\n      ]\n    : [];\n  if (options.routes && hasLinearWebhookRoutesOptions(options.routes)) {\n    routes.push(createLinearWebhookRoutes(options.routes));\n  }\n\n  return {\n    provider: LINEAR_PROVIDER,\n    displayName: 'Linear',\n    adapters,\n    async connectionExternalUrl(connection: {id: string}): Promise<string | undefined> {\n      const installation = await getInstallationByConnectionId(connection.id);\n      if (!installation?.organizationUrlKey) return undefined;\n      return `https://linear.app/${encodeURIComponent(installation.organizationUrlKey)}/settings`;\n    },\n    routes,\n  };\n}\n\nfunction hasLinearWebhookRoutesOptions(\n  routes: Partial<CreateLinearWebhookRoutesOptions>,\n): routes is CreateLinearWebhookRoutesOptions {\n  return (\n    routes.coreDb !== undefined &&\n    routes.publishIntegrationEventReceived !== undefined &&\n    routes.recordDeliveryOnly !== undefined &&\n    routes.getIntegrationConnectionById !== undefined\n  );\n}\n"],"names":["LINEAR_PROVIDER","createLinearApiClient","config","LinearAgentToolsProvider","closeDb","db","getLinearInstallationByConnectionId","migrationsPath","createLinearIntegrationRoutes","createLinearWebhookRoutes","linearAgentToolCatalog","linearAgentToolSelectionCatalog","disconnectLinearInstallation","LinearAccessTokenMissingError","LinearAuthorizationScopeMismatchError","LinearConnectionAlreadyLinkedError","LinearConnectionNotFoundError","LinearInstallationAlreadyLinkedError","LinearInstallStateActorMismatchError","LinearInstallStateError","LinearIntegrationProviderError","LinearOAuthCallbackError","LinearTokenUnrefreshableError","handleLinearCallback","handleLinearOAuthCallbackError","assertLinearAuthorizationScopes","formatLinearOAuthScopes","LINEAR_OAUTH_SCOPES","signLinearInstallState","verifyLinearInstallState","createLinearTokenStore","linearSecretsNamespace","handleLinearWebhook","getLinearInstallationByOrganizationId","markLinearInstallationRevoked","updateLinearInstallationTokenExpiry","upsertLinearInstallation","withLinearRefreshLock","createLinearE2eRoutes","createLinearIntegrationProvider","options","linear","getInstallationByConnectionId","adapters","agentTools","agent_tools","routes","connectionCapabilities","hasLinearWebhookRoutesOptions","push","provider","displayName","connectionExternalUrl","connection","installation","id","organizationUrlKey","undefined","encodeURIComponent","coreDb","publishIntegrationEventReceived","recordDeliveryOnly","getIntegrationConnectionById"],"mappings":"AAAA,SAAQA,eAAe,QAAO,sCAAsC;AACpE,SAAQC,qBAAqB,QAA6B,iBAAiB;AAC3E,SAAQC,MAAM,QAAO,aAAa;AAClC,SAAQC,wBAAwB,QAAO,gCAAgC;AAEvE,SAAQC,OAAO,EAAEC,EAAE,QAAO,YAAY;AACtC,SAAQC,mCAAmC,QAAO,uBAAuB;AACzE,SAAQC,cAAc,QAAO,oBAAoB;AACjD,SAEEC,6BAA6B,QACxB,kCAAkC;AACzC,SAEEC,yBAAyB,QACpB,mCAAmC;AAI1C,SAAQR,qBAAqB,QAAO,iBAAiB;AAOrD,SACES,sBAAsB,EACtBC,+BAA+B,QAC1B,uBAAuB;AAC9B,SAEEC,4BAA4B,QACvB,sBAAsB;AAC7B,SACEC,6BAA6B,EAC7BC,qCAAqC,EACrCC,kCAAkC,EAClCC,6BAA6B,EAC7BC,oCAAoC,EACpCC,oCAAoC,EACpCC,uBAAuB,EACvBC,8BAA8B,EAC9BC,wBAAwB,EACxBC,6BAA6B,QACxB,kBAAkB;AAEzB,SAAQC,oBAAoB,EAAEC,8BAA8B,QAAO,mBAAmB;AACtF,SACEC,+BAA+B,EAC/BC,uBAAuB,EACvBC,mBAAmB,QACd,kBAAkB;AAEzB,SAAQC,sBAAsB,EAAEC,wBAAwB,QAAO,iBAAiB;AAShF,SACEC,sBAAsB,EACtBC,sBAAsB,QACjB,kBAAkB;AAEzB,SAAQC,mBAAmB,QAAO,mBAAmB;AAOrD,SACE1B,mCAAmC,EACnC2B,qCAAqC,EACrCC,6BAA6B,EAC7BC,mCAAmC,EACnCC,wBAAwB,EACxBC,qBAAqB,QAChB,uBAAuB;AAC9B,SAEEC,qBAAqB,QAChB,mCAAmC;AAC1C,SAAQlC,OAAO,EAAEF,MAAM,EAAEG,EAAE,EAAEE,cAAc,GAAE;AAkB7C,OAAO,SAASgC,gCACdC,UAAkD,CAAC,CAAC;IAEpD,MAAMC,SAASD,QAAQC,MAAM,IAAIxC;IACjC,MAAMyC,gCACJF,QAAQlC,mCAAmC,IAAIA;IACjD,MAAMqC,WAAWH,QAAQI,UAAU,GAC/B;QACEC,aAAa,IAAI1C,yBAAyBqC,QAAQI,UAAU;IAC9D,IACA,CAAC;IAEL,MAAME,SAASN,QAAQM,MAAM,GACzB;QACEtC,8BAA8B;YAC5BiC;YACAM,wBAAwBJ,SAASE,WAAW,GAAG;gBAAC;aAAc,GAAG,EAAE;YACnE,GAAGL,QAAQM,MAAM;QACnB;KACD,GACD,EAAE;IACN,IAAIN,QAAQM,MAAM,IAAIE,8BAA8BR,QAAQM,MAAM,GAAG;QACnEA,OAAOG,IAAI,CAACxC,0BAA0B+B,QAAQM,MAAM;IACtD;IAEA,OAAO;QACLI,UAAUlD;QACVmD,aAAa;QACbR;QACA,MAAMS,uBAAsBC,UAAwB;YAClD,MAAMC,eAAe,MAAMZ,8BAA8BW,WAAWE,EAAE;YACtE,IAAI,CAACD,cAAcE,oBAAoB,OAAOC;YAC9C,OAAO,CAAC,mBAAmB,EAAEC,mBAAmBJ,aAAaE,kBAAkB,EAAE,SAAS,CAAC;QAC7F;QACAV;IACF;AACF;AAEA,SAASE,8BACPF,MAAiD;IAEjD,OACEA,OAAOa,MAAM,KAAKF,aAClBX,OAAOc,+BAA+B,KAAKH,aAC3CX,OAAOe,kBAAkB,KAAKJ,aAC9BX,OAAOgB,4BAA4B,KAAKL;AAE5C"}

package/dist/presentation/dto/integrations.d.ts

@@ -0,0 +1,17 @@
+import type { IntegrationCapability, IntegrationConnection } from '@shipfox/api-integration-core-dto';
+export declare function toIntegrationConnectionDto(connection: IntegrationConnection, params: {
+    capabilities: IntegrationCapability[];
+}): {
+    created_at: string;
+    updated_at: string;
+    external_url?: string;
+    id: string;
+    workspace_id: string;
+    provider: string;
+    external_account_id: string;
+    slug: string;
+    display_name: string;
+    lifecycle_status: import("@shipfox/api-integration-core-dto").IntegrationConnectionLifecycleStatus;
+    capabilities: IntegrationCapability[];
+};
+//# sourceMappingURL=integrations.d.ts.map

package/dist/presentation/dto/integrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrations.d.ts","sourceRoot":"","sources":["../../../src/presentation/dto/integrations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,qBAAqB,EAAE,qBAAqB,EAAC,MAAM,mCAAmC,CAAC;AAGpG,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,qBAAqB,EACjC,MAAM,EAAE;IAAC,YAAY,EAAE,qBAAqB,EAAE,CAAA;CAAC;;;;;;;;;;;;EAGhD"}

package/dist/presentation/dto/integrations.js

@@ -0,0 +1,6 @@
+import { toIntegrationConnectionDto as toCoreIntegrationConnectionDto } from '@shipfox/api-integration-core-dto';
+export function toIntegrationConnectionDto(connection, params) {
+    return toCoreIntegrationConnectionDto(connection, params);
+}
+
+//# sourceMappingURL=integrations.js.map

package/dist/presentation/dto/integrations.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/presentation/dto/integrations.ts"],"sourcesContent":["import type {IntegrationCapability, IntegrationConnection} from '@shipfox/api-integration-core-dto';\nimport {toIntegrationConnectionDto as toCoreIntegrationConnectionDto} from '@shipfox/api-integration-core-dto';\n\nexport function toIntegrationConnectionDto(\n  connection: IntegrationConnection,\n  params: {capabilities: IntegrationCapability[]},\n) {\n  return toCoreIntegrationConnectionDto(connection, params);\n}\n"],"names":["toIntegrationConnectionDto","toCoreIntegrationConnectionDto","connection","params"],"mappings":"AACA,SAAQA,8BAA8BC,8BAA8B,QAAO,oCAAoC;AAE/G,OAAO,SAASD,2BACdE,UAAiC,EACjCC,MAA+C;IAE/C,OAAOF,+BAA+BC,YAAYC;AACpD"}

package/dist/presentation/e2eRoutes/create-connection.d.ts

@@ -0,0 +1,16 @@
+import type { IntegrationCapability, IntegrationConnection } from '@shipfox/api-integration-core-dto';
+import type { ConnectLinearInstallationInput } from '#core/install.js';
+import type { LinearTokenStore } from '#core/tokens.js';
+export interface CreateE2eLinearConnectionRouteOptions {
+    tokenStore: Pick<LinearTokenStore, 'storeTokens'>;
+    getExistingLinearConnection: (input: {
+        organizationId: string;
+    }) => Promise<IntegrationConnection<'linear'> | undefined>;
+    connectLinearInstallation: (input: ConnectLinearInstallationInput) => Promise<IntegrationConnection<'linear'>>;
+    disconnectLinearInstallation: (input: {
+        connectionId: string;
+    }) => Promise<void>;
+    connectionCapabilities: IntegrationCapability[];
+}
+export declare function createE2eLinearConnectionRoute(options: CreateE2eLinearConnectionRouteOptions): import("@shipfox/node-fastify").RouteDefinition;
+//# sourceMappingURL=create-connection.d.ts.map

package/dist/presentation/e2eRoutes/create-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-connection.d.ts","sourceRoot":"","sources":["../../../src/presentation/e2eRoutes/create-connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,qBAAqB,EAAE,qBAAqB,EAAC,MAAM,mCAAmC,CAAC;AAOpG,OAAO,KAAK,EAAC,8BAA8B,EAAC,MAAM,kBAAkB,CAAC;AACrE,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,iBAAiB,CAAC;AAGtD,MAAM,WAAW,qCAAqC;IACpD,UAAU,EAAE,IAAI,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC;IAClD,2BAA2B,EAAE,CAAC,KAAK,EAAE;QACnC,cAAc,EAAE,MAAM,CAAC;KACxB,KAAK,OAAO,CAAC,qBAAqB,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC,CAAC;IAC3D,yBAAyB,EAAE,CACzB,KAAK,EAAE,8BAA8B,KAClC,OAAO,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9C,4BAA4B,EAAE,CAAC,KAAK,EAAE;QAAC,YAAY,EAAE,MAAM,CAAA;KAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E,sBAAsB,EAAE,qBAAqB,EAAE,CAAC;CACjD;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,qCAAqC,mDA+C5F"}

package/dist/presentation/e2eRoutes/create-connection.js

@@ -0,0 +1,64 @@
+import { createE2eLinearConnectionBodySchema, createE2eLinearConnectionResponseSchema } from '@shipfox/api-integration-linear-dto';
+import { ClientError, defineRoute } from '@shipfox/node-fastify';
+import { logger } from '@shipfox/node-opentelemetry';
+import { toIntegrationConnectionDto } from '#presentation/dto/integrations.js';
+export function createE2eLinearConnectionRoute(options) {
+    return defineRoute({
+        method: 'POST',
+        path: '/linear-connections',
+        description: 'Create a synthetic Linear connection for E2E tests.',
+        schema: {
+            body: createE2eLinearConnectionBodySchema,
+            response: {
+                201: createE2eLinearConnectionResponseSchema
+            }
+        },
+        handler: async (request, reply)=>{
+            const body = request.body;
+            const existing = await options.getExistingLinearConnection({
+                organizationId: body.organization_id
+            });
+            if (existing && existing.workspaceId !== body.workspace_id) {
+                throw new ClientError('Linear organization is already connected to another workspace', 'linear-connection-workspace-mismatch', {
+                    status: 409
+                });
+            }
+            const connection = existing ?? await options.connectLinearInstallation({
+                workspaceId: body.workspace_id,
+                organizationId: body.organization_id,
+                organizationUrlKey: body.organization_url_key,
+                appUserId: body.app_user_id,
+                scopes: body.scopes,
+                tokenExpiresAt: null,
+                displayName: body.display_name
+            });
+            try {
+                await options.tokenStore.storeTokens({
+                    connectionId: connection.id,
+                    accessToken: body.access_token
+                });
+            } catch (error) {
+                if (!existing) await bestEffortDisconnectLinearInstallation(options, connection.id);
+                throw error;
+            }
+            reply.code(201);
+            return toIntegrationConnectionDto(connection, {
+                capabilities: options.connectionCapabilities
+            });
+        }
+    });
+}
+async function bestEffortDisconnectLinearInstallation(options, connectionId) {
+    try {
+        await options.disconnectLinearInstallation({
+            connectionId
+        });
+    } catch (error) {
+        logger().warn({
+            err: error,
+            connectionId
+        }, 'Linear E2E connection compensation failed after token storage rejection');
+    }
+}
+
+//# sourceMappingURL=create-connection.js.map

package/dist/presentation/e2eRoutes/create-connection.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/presentation/e2eRoutes/create-connection.ts"],"sourcesContent":["import type {IntegrationCapability, IntegrationConnection} from '@shipfox/api-integration-core-dto';\nimport {\n  createE2eLinearConnectionBodySchema,\n  createE2eLinearConnectionResponseSchema,\n} from '@shipfox/api-integration-linear-dto';\nimport {ClientError, defineRoute} from '@shipfox/node-fastify';\nimport {logger} from '@shipfox/node-opentelemetry';\nimport type {ConnectLinearInstallationInput} from '#core/install.js';\nimport type {LinearTokenStore} from '#core/tokens.js';\nimport {toIntegrationConnectionDto} from '#presentation/dto/integrations.js';\n\nexport interface CreateE2eLinearConnectionRouteOptions {\n  tokenStore: Pick<LinearTokenStore, 'storeTokens'>;\n  getExistingLinearConnection: (input: {\n    organizationId: string;\n  }) => Promise<IntegrationConnection<'linear'> | undefined>;\n  connectLinearInstallation: (\n    input: ConnectLinearInstallationInput,\n  ) => Promise<IntegrationConnection<'linear'>>;\n  disconnectLinearInstallation: (input: {connectionId: string}) => Promise<void>;\n  connectionCapabilities: IntegrationCapability[];\n}\n\nexport function createE2eLinearConnectionRoute(options: CreateE2eLinearConnectionRouteOptions) {\n  return defineRoute({\n    method: 'POST',\n    path: '/linear-connections',\n    description: 'Create a synthetic Linear connection for E2E tests.',\n    schema: {\n      body: createE2eLinearConnectionBodySchema,\n      response: {201: createE2eLinearConnectionResponseSchema},\n    },\n    handler: async (request, reply) => {\n      const body = request.body;\n      const existing = await options.getExistingLinearConnection({\n        organizationId: body.organization_id,\n      });\n      if (existing && existing.workspaceId !== body.workspace_id) {\n        throw new ClientError(\n          'Linear organization is already connected to another workspace',\n          'linear-connection-workspace-mismatch',\n          {status: 409},\n        );\n      }\n      const connection =\n        existing ??\n        (await options.connectLinearInstallation({\n          workspaceId: body.workspace_id,\n          organizationId: body.organization_id,\n          organizationUrlKey: body.organization_url_key,\n          appUserId: body.app_user_id,\n          scopes: body.scopes,\n          tokenExpiresAt: null,\n          displayName: body.display_name,\n        }));\n\n      try {\n        await options.tokenStore.storeTokens({\n          connectionId: connection.id,\n          accessToken: body.access_token,\n        });\n      } catch (error) {\n        if (!existing) await bestEffortDisconnectLinearInstallation(options, connection.id);\n        throw error;\n      }\n\n      reply.code(201);\n      return toIntegrationConnectionDto(connection, {capabilities: options.connectionCapabilities});\n    },\n  });\n}\n\nasync function bestEffortDisconnectLinearInstallation(\n  options: CreateE2eLinearConnectionRouteOptions,\n  connectionId: string,\n): Promise<void> {\n  try {\n    await options.disconnectLinearInstallation({connectionId});\n  } catch (error) {\n    logger().warn(\n      {err: error, connectionId},\n      'Linear E2E connection compensation failed after token storage rejection',\n    );\n  }\n}\n"],"names":["createE2eLinearConnectionBodySchema","createE2eLinearConnectionResponseSchema","ClientError","defineRoute","logger","toIntegrationConnectionDto","createE2eLinearConnectionRoute","options","method","path","description","schema","body","response","handler","request","reply","existing","getExistingLinearConnection","organizationId","organization_id","workspaceId","workspace_id","status","connection","connectLinearInstallation","organizationUrlKey","organization_url_key","appUserId","app_user_id","scopes","tokenExpiresAt","displayName","display_name","tokenStore","storeTokens","connectionId","id","accessToken","access_token","error","bestEffortDisconnectLinearInstallation","code","capabilities","connectionCapabilities","disconnectLinearInstallation","warn","err"],"mappings":"AACA,SACEA,mCAAmC,EACnCC,uCAAuC,QAClC,sCAAsC;AAC7C,SAAQC,WAAW,EAAEC,WAAW,QAAO,wBAAwB;AAC/D,SAAQC,MAAM,QAAO,8BAA8B;AAGnD,SAAQC,0BAA0B,QAAO,oCAAoC;AAc7E,OAAO,SAASC,+BAA+BC,OAA8C;IAC3F,OAAOJ,YAAY;QACjBK,QAAQ;QACRC,MAAM;QACNC,aAAa;QACbC,QAAQ;YACNC,MAAMZ;YACNa,UAAU;gBAAC,KAAKZ;YAAuC;QACzD;QACAa,SAAS,OAAOC,SAASC;YACvB,MAAMJ,OAAOG,QAAQH,IAAI;YACzB,MAAMK,WAAW,MAAMV,QAAQW,2BAA2B,CAAC;gBACzDC,gBAAgBP,KAAKQ,eAAe;YACtC;YACA,IAAIH,YAAYA,SAASI,WAAW,KAAKT,KAAKU,YAAY,EAAE;gBAC1D,MAAM,IAAIpB,YACR,iEACA,wCACA;oBAACqB,QAAQ;gBAAG;YAEhB;YACA,MAAMC,aACJP,YACC,MAAMV,QAAQkB,yBAAyB,CAAC;gBACvCJ,aAAaT,KAAKU,YAAY;gBAC9BH,gBAAgBP,KAAKQ,eAAe;gBACpCM,oBAAoBd,KAAKe,oBAAoB;gBAC7CC,WAAWhB,KAAKiB,WAAW;gBAC3BC,QAAQlB,KAAKkB,MAAM;gBACnBC,gBAAgB;gBAChBC,aAAapB,KAAKqB,YAAY;YAChC;YAEF,IAAI;gBACF,MAAM1B,QAAQ2B,UAAU,CAACC,WAAW,CAAC;oBACnCC,cAAcZ,WAAWa,EAAE;oBAC3BC,aAAa1B,KAAK2B,YAAY;gBAChC;YACF,EAAE,OAAOC,OAAO;gBACd,IAAI,CAACvB,UAAU,MAAMwB,uCAAuClC,SAASiB,WAAWa,EAAE;gBAClF,MAAMG;YACR;YAEAxB,MAAM0B,IAAI,CAAC;YACX,OAAOrC,2BAA2BmB,YAAY;gBAACmB,cAAcpC,QAAQqC,sBAAsB;YAAA;QAC7F;IACF;AACF;AAEA,eAAeH,uCACblC,OAA8C,EAC9C6B,YAAoB;IAEpB,IAAI;QACF,MAAM7B,QAAQsC,4BAA4B,CAAC;YAACT;QAAY;IAC1D,EAAE,OAAOI,OAAO;QACdpC,SAAS0C,IAAI,CACX;YAACC,KAAKP;YAAOJ;QAAY,GACzB;IAEJ;AACF"}

package/dist/presentation/e2eRoutes/index.d.ts

@@ -0,0 +1,5 @@
+import type { RouteGroup } from '@shipfox/node-fastify';
+import { type CreateE2eLinearConnectionRouteOptions } from './create-connection.js';
+export type CreateLinearE2eRoutesOptions = CreateE2eLinearConnectionRouteOptions;
+export declare function createLinearE2eRoutes(options: CreateLinearE2eRoutesOptions): RouteGroup;
+//# sourceMappingURL=index.d.ts.map

package/dist/presentation/e2eRoutes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/presentation/e2eRoutes/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,uBAAuB,CAAC;AACtD,OAAO,EACL,KAAK,qCAAqC,EAE3C,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,4BAA4B,GAAG,qCAAqC,CAAC;AAEjF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG,UAAU,CAKvF"}

package/dist/presentation/e2eRoutes/index.js

@@ -0,0 +1,11 @@
+import { createE2eLinearConnectionRoute } from './create-connection.js';
+export function createLinearE2eRoutes(options) {
+    return {
+        prefix: '/integrations',
+        routes: [
+            createE2eLinearConnectionRoute(options)
+        ]
+    };
+}
+
+//# sourceMappingURL=index.js.map

package/dist/presentation/e2eRoutes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/presentation/e2eRoutes/index.ts"],"sourcesContent":["import type {RouteGroup} from '@shipfox/node-fastify';\nimport {\n  type CreateE2eLinearConnectionRouteOptions,\n  createE2eLinearConnectionRoute,\n} from './create-connection.js';\n\nexport type CreateLinearE2eRoutesOptions = CreateE2eLinearConnectionRouteOptions;\n\nexport function createLinearE2eRoutes(options: CreateLinearE2eRoutesOptions): RouteGroup {\n  return {\n    prefix: '/integrations',\n    routes: [createE2eLinearConnectionRoute(options)],\n  };\n}\n"],"names":["createE2eLinearConnectionRoute","createLinearE2eRoutes","options","prefix","routes"],"mappings":"AACA,SAEEA,8BAA8B,QACzB,yBAAyB;AAIhC,OAAO,SAASC,sBAAsBC,OAAqC;IACzE,OAAO;QACLC,QAAQ;QACRC,QAAQ;YAACJ,+BAA+BE;SAAS;IACnD;AACF"}

package/dist/presentation/routes/errors.d.ts

@@ -0,0 +1,2 @@
+export declare function linearRouteErrorHandler(error: unknown): never;
+//# sourceMappingURL=errors.d.ts.map

package/dist/presentation/routes/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/presentation/routes/errors.ts"],"names":[],"mappings":"AAqBA,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAsC7D"}

package/dist/presentation/routes/errors.js

@@ -0,0 +1,65 @@
+import { ConnectionSlugConflictError } from '@shipfox/api-integration-core-dto';
+import { ClientError } from '@shipfox/node-fastify';
+import { LinearAuthorizationScopeMismatchError, LinearConnectionAlreadyLinkedError, LinearInstallationAlreadyLinkedError, LinearInstallStateActorMismatchError, LinearInstallStateError, LinearIntegrationProviderError, LinearOAuthCallbackError } from '#core/errors.js';
+function providerStatus(reason) {
+    if (reason === 'rate-limited') return 429;
+    if (reason === 'timeout' || reason === 'provider-unavailable') return 503;
+    return 422;
+}
+export function linearRouteErrorHandler(error) {
+    if (error instanceof LinearInstallStateError) {
+        throw new ClientError(error.message, 'invalid-linear-install-state', {
+            status: 400
+        });
+    }
+    if (error instanceof LinearInstallStateActorMismatchError) {
+        throw new ClientError(error.message, 'linear-install-state-actor-mismatch', {
+            status: 403
+        });
+    }
+    if (error instanceof LinearInstallationAlreadyLinkedError) {
+        throw new ClientError(error.message, 'linear-installation-already-linked', {
+            status: 409
+        });
+    }
+    if (error instanceof LinearConnectionAlreadyLinkedError) {
+        throw new ClientError(error.message, 'linear-connection-already-linked', {
+            status: 409
+        });
+    }
+    if (error instanceof LinearAuthorizationScopeMismatchError) {
+        throw new ClientError(error.message, 'linear-authorization-scope-mismatch', {
+            status: 422,
+            details: {
+                missing_scopes: error.missingScopes
+            }
+        });
+    }
+    if (error instanceof LinearOAuthCallbackError) {
+        throw new ClientError(error.message, 'linear-oauth-callback-error', {
+            status: 422,
+            details: {
+                error: error.providerError,
+                ...error.providerDescription ? {
+                    error_description: error.providerDescription
+                } : {}
+            }
+        });
+    }
+    if (error instanceof ConnectionSlugConflictError) {
+        throw new ClientError(error.message, 'slug-conflict', {
+            status: 409
+        });
+    }
+    if (error instanceof LinearIntegrationProviderError) {
+        throw new ClientError(error.message, error.reason, {
+            details: {
+                retry_after_seconds: error.retryAfterSeconds
+            },
+            status: providerStatus(error.reason)
+        });
+    }
+    throw error;
+}
+
+//# sourceMappingURL=errors.js.map

package/dist/presentation/routes/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/presentation/routes/errors.ts"],"sourcesContent":["import {\n  ConnectionSlugConflictError,\n  type IntegrationProviderErrorReason,\n} from '@shipfox/api-integration-core-dto';\nimport {ClientError} from '@shipfox/node-fastify';\nimport {\n  LinearAuthorizationScopeMismatchError,\n  LinearConnectionAlreadyLinkedError,\n  LinearInstallationAlreadyLinkedError,\n  LinearInstallStateActorMismatchError,\n  LinearInstallStateError,\n  LinearIntegrationProviderError,\n  LinearOAuthCallbackError,\n} from '#core/errors.js';\n\nfunction providerStatus(reason: IntegrationProviderErrorReason): number {\n  if (reason === 'rate-limited') return 429;\n  if (reason === 'timeout' || reason === 'provider-unavailable') return 503;\n  return 422;\n}\n\nexport function linearRouteErrorHandler(error: unknown): never {\n  if (error instanceof LinearInstallStateError) {\n    throw new ClientError(error.message, 'invalid-linear-install-state', {status: 400});\n  }\n  if (error instanceof LinearInstallStateActorMismatchError) {\n    throw new ClientError(error.message, 'linear-install-state-actor-mismatch', {status: 403});\n  }\n  if (error instanceof LinearInstallationAlreadyLinkedError) {\n    throw new ClientError(error.message, 'linear-installation-already-linked', {status: 409});\n  }\n  if (error instanceof LinearConnectionAlreadyLinkedError) {\n    throw new ClientError(error.message, 'linear-connection-already-linked', {status: 409});\n  }\n  if (error instanceof LinearAuthorizationScopeMismatchError) {\n    throw new ClientError(error.message, 'linear-authorization-scope-mismatch', {\n      status: 422,\n      details: {missing_scopes: error.missingScopes},\n    });\n  }\n  if (error instanceof LinearOAuthCallbackError) {\n    throw new ClientError(error.message, 'linear-oauth-callback-error', {\n      status: 422,\n      details: {\n        error: error.providerError,\n        ...(error.providerDescription ? {error_description: error.providerDescription} : {}),\n      },\n    });\n  }\n  if (error instanceof ConnectionSlugConflictError) {\n    throw new ClientError(error.message, 'slug-conflict', {status: 409});\n  }\n  if (error instanceof LinearIntegrationProviderError) {\n    throw new ClientError(error.message, error.reason, {\n      details: {retry_after_seconds: error.retryAfterSeconds},\n      status: providerStatus(error.reason),\n    });\n  }\n  throw error;\n}\n"],"names":["ConnectionSlugConflictError","ClientError","LinearAuthorizationScopeMismatchError","LinearConnectionAlreadyLinkedError","LinearInstallationAlreadyLinkedError","LinearInstallStateActorMismatchError","LinearInstallStateError","LinearIntegrationProviderError","LinearOAuthCallbackError","providerStatus","reason","linearRouteErrorHandler","error","message","status","details","missing_scopes","missingScopes","providerError","providerDescription","error_description","retry_after_seconds","retryAfterSeconds"],"mappings":"AAAA,SACEA,2BAA2B,QAEtB,oCAAoC;AAC3C,SAAQC,WAAW,QAAO,wBAAwB;AAClD,SACEC,qCAAqC,EACrCC,kCAAkC,EAClCC,oCAAoC,EACpCC,oCAAoC,EACpCC,uBAAuB,EACvBC,8BAA8B,EAC9BC,wBAAwB,QACnB,kBAAkB;AAEzB,SAASC,eAAeC,MAAsC;IAC5D,IAAIA,WAAW,gBAAgB,OAAO;IACtC,IAAIA,WAAW,aAAaA,WAAW,wBAAwB,OAAO;IACtE,OAAO;AACT;AAEA,OAAO,SAASC,wBAAwBC,KAAc;IACpD,IAAIA,iBAAiBN,yBAAyB;QAC5C,MAAM,IAAIL,YAAYW,MAAMC,OAAO,EAAE,gCAAgC;YAACC,QAAQ;QAAG;IACnF;IACA,IAAIF,iBAAiBP,sCAAsC;QACzD,MAAM,IAAIJ,YAAYW,MAAMC,OAAO,EAAE,uCAAuC;YAACC,QAAQ;QAAG;IAC1F;IACA,IAAIF,iBAAiBR,sCAAsC;QACzD,MAAM,IAAIH,YAAYW,MAAMC,OAAO,EAAE,sCAAsC;YAACC,QAAQ;QAAG;IACzF;IACA,IAAIF,iBAAiBT,oCAAoC;QACvD,MAAM,IAAIF,YAAYW,MAAMC,OAAO,EAAE,oCAAoC;YAACC,QAAQ;QAAG;IACvF;IACA,IAAIF,iBAAiBV,uCAAuC;QAC1D,MAAM,IAAID,YAAYW,MAAMC,OAAO,EAAE,uCAAuC;YAC1EC,QAAQ;YACRC,SAAS;gBAACC,gBAAgBJ,MAAMK,aAAa;YAAA;QAC/C;IACF;IACA,IAAIL,iBAAiBJ,0BAA0B;QAC7C,MAAM,IAAIP,YAAYW,MAAMC,OAAO,EAAE,+BAA+B;YAClEC,QAAQ;YACRC,SAAS;gBACPH,OAAOA,MAAMM,aAAa;gBAC1B,GAAIN,MAAMO,mBAAmB,GAAG;oBAACC,mBAAmBR,MAAMO,mBAAmB;gBAAA,IAAI,CAAC,CAAC;YACrF;QACF;IACF;IACA,IAAIP,iBAAiBZ,6BAA6B;QAChD,MAAM,IAAIC,YAAYW,MAAMC,OAAO,EAAE,iBAAiB;YAACC,QAAQ;QAAG;IACpE;IACA,IAAIF,iBAAiBL,gCAAgC;QACnD,MAAM,IAAIN,YAAYW,MAAMC,OAAO,EAAED,MAAMF,MAAM,EAAE;YACjDK,SAAS;gBAACM,qBAAqBT,MAAMU,iBAAiB;YAAA;YACtDR,QAAQL,eAAeG,MAAMF,MAAM;QACrC;IACF;IACA,MAAME;AACR"}