npm - @shipfox/api-integration-spi - Versions diffs - 1.0.1 → 1.1.0 - Mend

@shipfox/api-integration-spi 1.0.1 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/.turbo/turbo-build.log +1 -1
package/CHANGELOG.md +6 -0
package/dist/contracts.d.ts +4 -0
package/dist/contracts.d.ts.map +1 -1
package/dist/contracts.js.map +1 -1
package/dist/tsconfig.test.tsbuildinfo +1 -1
package/package.json +1 -1
package/src/contracts.ts +6 -0
package/tsconfig.build.tsbuildinfo +1 -1

package/.turbo/turbo-build.log CHANGED Viewed

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

package/CHANGELOG.md CHANGED Viewed

@@ -1,5 +1,11 @@
 # @shipfox/api-integration-spi
+## 1.1.0
+### Minor Changes
+- e0110fe: Adds Jira webhook renewal and disconnect deregistration support.
 ## 1.0.1
 ### Patch Changes

package/dist/contracts.d.ts CHANGED Viewed

@@ -159,6 +159,10 @@ export interface IntegrationProvider<ProviderKind extends IntegrationProviderKin
     adapters?: IntegrationProviderAdapters<Connection> | undefined;
     routes?: Route[] | undefined;
     connectionExternalUrl?(connection: Connection): Promise<string | undefined>;
+    /** Prepares provider-owned remote cleanup and returns a callback for after local deletion commits. */
+    deleteConnectionRemoteResources?(connection: Connection): Promise<(() => Promise<void>) | undefined>;
+    /** Serializes connection deletion with provider operations that can recreate remote resources. */
+    withConnectionDeletionLock?(connection: Connection, fn: () => Promise<void>): Promise<void>;
     deleteConnectionRecords?(connection: Connection, options: {
         tx: unknown;
     }): Promise<void>;

package/dist/contracts.d.ts.map CHANGED Viewed

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

package/dist/contracts.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/contracts.ts"],"sourcesContent":["export type IntegrationProviderKind = string;\nexport type IntegrationCapability = 'source_control' \| 'agent_tools';\nexport type IntegrationConnectionLifecycleStatus = 'active' \| 'disabled' \| 'error';\n\nconst GIT_OBJECT_ID_PATTERN = /^(?:[0-9a-f]{40}\|[0-9a-f]{64})$/i;\nconst ZERO_GIT_OBJECT_ID_PATTERN = /^0+$/;\n\nexport interface IntegrationConnection<\n ProviderKind extends IntegrationProviderKind = IntegrationProviderKind,\n> {\n id: string;\n workspaceId: string;\n provider: ProviderKind;\n externalAccountId: string;\n slug: string;\n displayName: string;\n lifecycleStatus: IntegrationConnectionLifecycleStatus;\n createdAt: Date;\n updatedAt: Date;\n}\n\nexport type RepositoryVisibility = 'public' \| 'private' \| 'internal' \| 'unknown';\n\nexport interface RepositorySnapshot {\n externalRepositoryId: string;\n owner: string;\n name: string;\n fullName: string;\n defaultBranch: string;\n visibility: RepositoryVisibility;\n cloneUrl: string;\n htmlUrl: string;\n}\n\nexport interface RepositoryPage {\n repositories: RepositorySnapshot[];\n nextCursor: string \| null;\n}\n\nexport interface ListRepositoriesInput<\n Connection extends IntegrationConnection = IntegrationConnection,\n> {\n connection: Connection;\n limit: number;\n cursor?: string \| undefined;\n search?: string \| undefined;\n}\n\nexport interface ResolveRepositoryInput<\n Connection extends IntegrationConnection = IntegrationConnection,\n> {\n connection: Connection;\n externalRepositoryId: string;\n}\n\nexport interface FileSnapshot {\n path: string;\n ref: string;\n content: string;\n}\n\nexport interface FileEntry {\n path: string;\n type: 'file';\n size: number \| null;\n}\n\nexport interface FilePage {\n files: FileEntry[];\n nextCursor: string \| null;\n}\n\nexport interface ListFilesInput<Connection extends IntegrationConnection = IntegrationConnection>\n extends ResolveRepositoryInput<Connection> {\n ref: string;\n prefix: string;\n limit: number;\n cursor?: string \| undefined;\n}\n\nexport interface FetchFileInput<Connection extends IntegrationConnection = IntegrationConnection>\n extends ResolveRepositoryInput<Connection> {\n ref: string;\n path: string;\n}\n\nexport interface CheckoutCredentials {\n username: string;\n token: string;\n expiresAt: Date;\n}\n\nexport interface CheckoutGitAuthor {\n name: string;\n email: string;\n}\n\nexport interface CheckoutPermissions {\n contents: 'read' \| 'write';\n}\n\nexport interface CheckoutSpec {\n repositoryUrl: string;\n ref: string;\n credentials?: CheckoutCredentials \| undefined;\n gitAuthor?: CheckoutGitAuthor \| undefined;\n}\n\nexport interface CreateCheckoutSpecInput<\n Connection extends IntegrationConnection = IntegrationConnection,\n> extends ResolveRepositoryInput<Connection> {\n ref?: string \| undefined;\n permissions?: CheckoutPermissions \| undefined;\n}\n\nexport interface TriggerReference {\n externalRepositoryId: string;\n ref: string;\n commit: string;\n /** Provider handle of whoever caused the event, when the payload names one. /\n actor: string \| null;\n}\n\nexport interface SourceControlProvider<\n Connection extends IntegrationConnection = IntegrationConnection,\n> {\n listRepositories(input: ListRepositoriesInput<Connection>): Promise<RepositoryPage>;\n resolveRepository(input: ResolveRepositoryInput<Connection>): Promise<RepositorySnapshot>;\n listFiles(input: ListFilesInput<Connection>): Promise<FilePage>;\n fetchFile(input: FetchFileInput<Connection>): Promise<FileSnapshot>;\n resolveTriggerReference(payload: unknown): TriggerReference \| null;\n createCheckoutSpec?(input: CreateCheckoutSpecInput<Connection>): Promise<CheckoutSpec>;\n}\n\nexport type AgentToolSensitivity = 'read' \| 'write';\nexport type AgentToolJsonSchema = Record<string, unknown>;\n\nexport interface AgentToolCatalogMethod<RequiredScope = unknown> {\n id: string;\n description: string;\n sensitivity: AgentToolSensitivity;\n sensitive: boolean;\n requiredScope: RequiredScope;\n}\n\nexport interface AgentToolCatalogEntry<RequiredScope = unknown> {\n id: string;\n description: string;\n sensitivity: AgentToolSensitivity;\n sensitive: boolean;\n requiredScope: RequiredScope;\n inputSchema: AgentToolJsonSchema;\n outputSchema?: AgentToolJsonSchema \| undefined;\n methods?: readonly AgentToolCatalogMethod<RequiredScope>[] \| undefined;\n}\n\nexport type AgentToolSelectorKind = 'family' \| 'family_wildcard' \| 'method' \| 'standalone';\n\nexport interface AgentToolSelector {\n readonly token: string;\n readonly kind: AgentToolSelectorKind;\n readonly sensitivity: AgentToolSensitivity;\n readonly sensitive: boolean;\n}\n\nexport interface AgentToolSelectionCatalog {\n readonly selectors: readonly AgentToolSelector[];\n}\n\nexport interface AgentToolCallInput {\n toolId: string;\n arguments: Record<string, unknown>;\n}\n\nexport interface AgentToolSession<CallResult = unknown> {\n call(input: AgentToolCallInput): Promise<CallResult>;\n close?(): Promise<void>;\n}\n\nexport interface OpenAgentToolsSessionInput<\n Connection extends IntegrationConnection = IntegrationConnection,\n RequiredScope = unknown,\n ProviderScope = unknown,\n> {\n connection: Connection;\n tools: readonly AgentToolCatalogEntry<RequiredScope>[];\n scope: ProviderScope;\n}\n\nexport interface AgentToolsProvider<\n Connection extends IntegrationConnection = IntegrationConnection,\n RequiredScope = unknown,\n ProviderScope = unknown,\n CallResult = unknown,\n> {\n catalog():\n \| readonly AgentToolCatalogEntry<RequiredScope>[]\n \| Promise<readonly AgentToolCatalogEntry<RequiredScope>[]>;\n selectionCatalog(): AgentToolSelectionCatalog \| Promise<AgentToolSelectionCatalog>;\n openSession(\n input: OpenAgentToolsSessionInput<Connection, RequiredScope, ProviderScope>,\n ): Promise<AgentToolSession<CallResult>>;\n}\n\nexport interface IntegrationProviderAdapters<\n Connection extends IntegrationConnection = IntegrationConnection,\n> {\n source_control?: SourceControlProvider<Connection> \| undefined;\n agent_tools?: AgentToolsProvider<Connection> \| undefined;\n}\n\n/* Processes one provider-neutral inbound webhook request. /\nexport interface WebhookRequestProcessor {\n process(\n request: import('@shipfox/api-integration-core-dto').StoredWebhookRequest,\n ): Promise<import('@shipfox/api-integration-core-dto').WebhookProcessingResult>;\n}\n\nexport interface IntegrationProvider<\n ProviderKind extends IntegrationProviderKind = IntegrationProviderKind,\n Route = unknown,\n Connection extends IntegrationConnection<ProviderKind> = IntegrationConnection<ProviderKind>,\n> {\n provider: ProviderKind;\n displayName: string;\n adapters?: IntegrationProviderAdapters<Connection> \| undefined;\n routes?: Route[] \| undefined;\n connectionExternalUrl?(connection: Connection): Promise<string \| undefined>;\n deleteConnectionRecords?(connection: Connection, options: {tx: unknown}): Promise<void>;\n deleteConnectionSecrets?(connection: Connection): Promise<void>;\n}\n\nexport interface RegisteredIntegrationProvider<\n ProviderKind extends IntegrationProviderKind = IntegrationProviderKind,\n Route = unknown,\n Connection extends IntegrationConnection<ProviderKind> = IntegrationConnection<ProviderKind>,\n> extends IntegrationProvider<ProviderKind, Route, Connection> {\n adapters: IntegrationProviderAdapters<Connection>;\n capabilities: IntegrationCapability[];\n}\n\nexport type IntegrationProviderErrorReason =\n \| 'repository-not-found'\n \| 'installation-not-found'\n \| 'file-not-found'\n \| 'access-denied'\n \| 'rate-limited'\n \| 'timeout'\n \| 'provider-unavailable'\n \| 'malformed-provider-response'\n \| 'content-too-large'\n \| 'too-many-files';\n\nexport class IntegrationProviderError extends Error {\n constructor(\n public readonly reason: IntegrationProviderErrorReason,\n message: string,\n public readonly retryAfterSeconds?: number \| undefined,\n ) {\n super(message);\n this.name = 'IntegrationProviderError';\n }\n}\n\nexport class ConnectionSlugConflictError extends Error {\n constructor(cause: unknown) {\n super('Could not allocate a unique integration connection slug. Try again.', {cause});\n this.name = 'ConnectionSlugConflictError';\n }\n}\n\nexport const MAX_REPOSITORY_FILE_BYTES = 1_000_000;\n\nexport function buildProviderRepositoryId(\n provider: IntegrationProviderKind,\n value: string,\n): string {\n return `${provider}:${value}`;\n}\n\nexport function parseProviderRepositoryId(\n externalRepositoryId: string,\n expectedProvider: IntegrationProviderKind,\n): string {\n const separatorIndex = externalRepositoryId.indexOf(':');\n if (separatorIndex <= 0) {\n throw new IntegrationProviderError(\n 'repository-not-found',\n `External repository id is missing a provider prefix: ${externalRepositoryId}`,\n );\n }\n const prefix = externalRepositoryId.slice(0, separatorIndex);\n const value = externalRepositoryId.slice(separatorIndex + 1);\n if (prefix !== expectedProvider) {\n throw new IntegrationProviderError(\n 'repository-not-found',\n `External repository id ${externalRepositoryId} is not owned by provider ${expectedProvider}`,\n );\n }\n if (!value) {\n throw new IntegrationProviderError(\n 'repository-not-found',\n `External repository id ${externalRepositoryId} is missing a provider-owned value`,\n );\n }\n return value;\n}\n\n/* Checks the constraints enforced by `git check-ref-format`. /\nexport function isValidGitRefName(ref: string): boolean {\n if (!ref \|\| ref === '@' \|\| ref.startsWith('-')) return false;\n if (\n !ref.includes('/') \|\|\n ref.startsWith('/') \|\|\n ref.endsWith('/') \|\|\n ref.includes('//') \|\|\n ref.includes('..') \|\|\n ref.includes('@{') \|\|\n ref.endsWith('.')\n ) {\n return false;\n }\n if (\n [...ref].some((character) => {\n const code = character.codePointAt(0) ?? 0;\n return code <= 0x20 \|\| code === 0x7f \|\| '~^:?[]\\\\'.includes(character);\n })\n ) {\n return false;\n }\n\n const components = ref.split('/');\n return components.every(\n (component) =>\n component.length > 0 && !component.startsWith('.') && !component.endsWith('.lock'),\n );\n}\n\nexport function isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === 'object' && value !== null;\n}\n\nexport function asRecord(value: unknown): Record<string, unknown> \| null {\n return isRecord(value) ? value : null;\n}\n\nexport function nonEmptyString(value: unknown): string \| null {\n return typeof value === 'string' && value.length > 0 ? value : null;\n}\n\nexport function positiveInteger(value: unknown): number \| null {\n return typeof value === 'number' && Number.isInteger(value) && value > 0 ? value : null;\n}\n\n/** Validates a provider ref before it is passed to a git operation. */\nexport function isValidTriggerRef(ref: string): boolean {\n return isValidGitRefName(ref);\n}\n\nexport function isValidGitObjectId(value: string): boolean {\n return GIT_OBJECT_ID_PATTERN.test(value) && !ZERO_GIT_OBJECT_ID_PATTERN.test(value);\n}\n"],"names":["GIT_OBJECT_ID_PATTERN","ZERO_GIT_OBJECT_ID_PATTERN","IntegrationProviderError","Error","reason","message","retryAfterSeconds","name","ConnectionSlugConflictError","cause","MAX_REPOSITORY_FILE_BYTES","buildProviderRepositoryId","provider","value","parseProviderRepositoryId","externalRepositoryId","expectedProvider","separatorIndex","indexOf","prefix","slice","isValidGitRefName","ref","startsWith","includes","endsWith","some","character","code","codePointAt","components","split","every","component","length","isRecord","asRecord","nonEmptyString","positiveInteger","Number","isInteger","isValidTriggerRef","isValidGitObjectId","test"],"mappings":"AAIA,MAAMA,wBAAwB;AAC9B,MAAMC,6BAA6B;AAwPnC,OAAO,MAAMC,iCAAiCC;IAC5C,YACE,AAAgBC,MAAsC,EACtDC,OAAe,EACf,AAAgBC,iBAAsC,CACtD;QACA,KAAK,CAACD,eAJUD,SAAAA,aAEAE,oBAAAA;QAGhB,IAAI,CAACC,IAAI,GAAG;IACd;AACF;AAEA,OAAO,MAAMC,oCAAoCL;IAC/C,YAAYM,KAAc,CAAE;QAC1B,KAAK,CAAC,uEAAuE;YAACA;QAAK;QACnF,IAAI,CAACF,IAAI,GAAG;IACd;AACF;AAEA,OAAO,MAAMG,4BAA4B,UAAU;AAEnD,OAAO,SAASC,0BACdC,QAAiC,EACjCC,KAAa;IAEb,OAAO,GAAGD,SAAS,CAAC,EAAEC,OAAO;AAC/B;AAEA,OAAO,SAASC,0BACdC,oBAA4B,EAC5BC,gBAAyC;IAEzC,MAAMC,iBAAiBF,qBAAqBG,OAAO,CAAC;IACpD,IAAID,kBAAkB,GAAG;QACvB,MAAM,IAAIf,yBACR,wBACA,CAAC,qDAAqD,EAAEa,sBAAsB;IAElF;IACA,MAAMI,SAASJ,qBAAqBK,KAAK,CAAC,GAAGH;IAC7C,MAAMJ,QAAQE,qBAAqBK,KAAK,CAACH,iBAAiB;IAC1D,IAAIE,WAAWH,kBAAkB;QAC/B,MAAM,IAAId,yBACR,wBACA,CAAC,uBAAuB,EAAEa,qBAAqB,0BAA0B,EAAEC,kBAAkB;IAEjG;IACA,IAAI,CAACH,OAAO;QACV,MAAM,IAAIX,yBACR,wBACA,CAAC,uBAAuB,EAAEa,qBAAqB,kCAAkC,CAAC;IAEtF;IACA,OAAOF;AACT;AAEA,+DAA+D,GAC/D,OAAO,SAASQ,kBAAkBC,GAAW;IAC3C,IAAI,CAACA,OAAOA,QAAQ,OAAOA,IAAIC,UAAU,CAAC,MAAM,OAAO;IACvD,IACE,CAACD,IAAIE,QAAQ,CAAC,QACdF,IAAIC,UAAU,CAAC,QACfD,IAAIG,QAAQ,CAAC,QACbH,IAAIE,QAAQ,CAAC,SACbF,IAAIE,QAAQ,CAAC,SACbF,IAAIE,QAAQ,CAAC,SACbF,IAAIG,QAAQ,CAAC,MACb;QACA,OAAO;IACT;IACA,IACE;WAAIH;KAAI,CAACI,IAAI,CAAC,CAACC;QACb,MAAMC,OAAOD,UAAUE,WAAW,CAAC,MAAM;QACzC,OAAOD,QAAQ,QAAQA,SAAS,QAAQ,YAAYJ,QAAQ,CAACG;IAC/D,IACA;QACA,OAAO;IACT;IAEA,MAAMG,aAAaR,IAAIS,KAAK,CAAC;IAC7B,OAAOD,WAAWE,KAAK,CACrB,CAACC,YACCA,UAAUC,MAAM,GAAG,KAAK,CAACD,UAAUV,UAAU,CAAC,QAAQ,CAACU,UAAUR,QAAQ,CAAC;AAEhF;AAEA,OAAO,SAASU,SAAStB,KAAc;IACrC,OAAO,OAAOA,UAAU,YAAYA,UAAU;AAChD;AAEA,OAAO,SAASuB,SAASvB,KAAc;IACrC,OAAOsB,SAAStB,SAASA,QAAQ;AACnC;AAEA,OAAO,SAASwB,eAAexB,KAAc;IAC3C,OAAO,OAAOA,UAAU,YAAYA,MAAMqB,MAAM,GAAG,IAAIrB,QAAQ;AACjE;AAEA,OAAO,SAASyB,gBAAgBzB,KAAc;IAC5C,OAAO,OAAOA,UAAU,YAAY0B,OAAOC,SAAS,CAAC3B,UAAUA,QAAQ,IAAIA,QAAQ;AACrF;AAEA,qEAAqE,GACrE,OAAO,SAAS4B,kBAAkBnB,GAAW;IAC3C,OAAOD,kBAAkBC;AAC3B;AAEA,OAAO,SAASoB,mBAAmB7B,KAAa;IAC9C,OAAOb,sBAAsB2C,IAAI,CAAC9B,UAAU,CAACZ,2BAA2B0C,IAAI,CAAC9B;AAC/E"}
1	+ {"version":3,"sources":["../src/contracts.ts"],"sourcesContent":["export type IntegrationProviderKind = string;\nexport type IntegrationCapability = 'source_control' \| 'agent_tools';\nexport type IntegrationConnectionLifecycleStatus = 'active' \| 'disabled' \| 'error';\n\nconst GIT_OBJECT_ID_PATTERN = /^(?:[0-9a-f]{40}\|[0-9a-f]{64})$/i;\nconst ZERO_GIT_OBJECT_ID_PATTERN = /^0+$/;\n\nexport interface IntegrationConnection<\n ProviderKind extends IntegrationProviderKind = IntegrationProviderKind,\n> {\n id: string;\n workspaceId: string;\n provider: ProviderKind;\n externalAccountId: string;\n slug: string;\n displayName: string;\n lifecycleStatus: IntegrationConnectionLifecycleStatus;\n createdAt: Date;\n updatedAt: Date;\n}\n\nexport type RepositoryVisibility = 'public' \| 'private' \| 'internal' \| 'unknown';\n\nexport interface RepositorySnapshot {\n externalRepositoryId: string;\n owner: string;\n name: string;\n fullName: string;\n defaultBranch: string;\n visibility: RepositoryVisibility;\n cloneUrl: string;\n htmlUrl: string;\n}\n\nexport interface RepositoryPage {\n repositories: RepositorySnapshot[];\n nextCursor: string \| null;\n}\n\nexport interface ListRepositoriesInput<\n Connection extends IntegrationConnection = IntegrationConnection,\n> {\n connection: Connection;\n limit: number;\n cursor?: string \| undefined;\n search?: string \| undefined;\n}\n\nexport interface ResolveRepositoryInput<\n Connection extends IntegrationConnection = IntegrationConnection,\n> {\n connection: Connection;\n externalRepositoryId: string;\n}\n\nexport interface FileSnapshot {\n path: string;\n ref: string;\n content: string;\n}\n\nexport interface FileEntry {\n path: string;\n type: 'file';\n size: number \| null;\n}\n\nexport interface FilePage {\n files: FileEntry[];\n nextCursor: string \| null;\n}\n\nexport interface ListFilesInput<Connection extends IntegrationConnection = IntegrationConnection>\n extends ResolveRepositoryInput<Connection> {\n ref: string;\n prefix: string;\n limit: number;\n cursor?: string \| undefined;\n}\n\nexport interface FetchFileInput<Connection extends IntegrationConnection = IntegrationConnection>\n extends ResolveRepositoryInput<Connection> {\n ref: string;\n path: string;\n}\n\nexport interface CheckoutCredentials {\n username: string;\n token: string;\n expiresAt: Date;\n}\n\nexport interface CheckoutGitAuthor {\n name: string;\n email: string;\n}\n\nexport interface CheckoutPermissions {\n contents: 'read' \| 'write';\n}\n\nexport interface CheckoutSpec {\n repositoryUrl: string;\n ref: string;\n credentials?: CheckoutCredentials \| undefined;\n gitAuthor?: CheckoutGitAuthor \| undefined;\n}\n\nexport interface CreateCheckoutSpecInput<\n Connection extends IntegrationConnection = IntegrationConnection,\n> extends ResolveRepositoryInput<Connection> {\n ref?: string \| undefined;\n permissions?: CheckoutPermissions \| undefined;\n}\n\nexport interface TriggerReference {\n externalRepositoryId: string;\n ref: string;\n commit: string;\n /** Provider handle of whoever caused the event, when the payload names one. /\n actor: string \| null;\n}\n\nexport interface SourceControlProvider<\n Connection extends IntegrationConnection = IntegrationConnection,\n> {\n listRepositories(input: ListRepositoriesInput<Connection>): Promise<RepositoryPage>;\n resolveRepository(input: ResolveRepositoryInput<Connection>): Promise<RepositorySnapshot>;\n listFiles(input: ListFilesInput<Connection>): Promise<FilePage>;\n fetchFile(input: FetchFileInput<Connection>): Promise<FileSnapshot>;\n resolveTriggerReference(payload: unknown): TriggerReference \| null;\n createCheckoutSpec?(input: CreateCheckoutSpecInput<Connection>): Promise<CheckoutSpec>;\n}\n\nexport type AgentToolSensitivity = 'read' \| 'write';\nexport type AgentToolJsonSchema = Record<string, unknown>;\n\nexport interface AgentToolCatalogMethod<RequiredScope = unknown> {\n id: string;\n description: string;\n sensitivity: AgentToolSensitivity;\n sensitive: boolean;\n requiredScope: RequiredScope;\n}\n\nexport interface AgentToolCatalogEntry<RequiredScope = unknown> {\n id: string;\n description: string;\n sensitivity: AgentToolSensitivity;\n sensitive: boolean;\n requiredScope: RequiredScope;\n inputSchema: AgentToolJsonSchema;\n outputSchema?: AgentToolJsonSchema \| undefined;\n methods?: readonly AgentToolCatalogMethod<RequiredScope>[] \| undefined;\n}\n\nexport type AgentToolSelectorKind = 'family' \| 'family_wildcard' \| 'method' \| 'standalone';\n\nexport interface AgentToolSelector {\n readonly token: string;\n readonly kind: AgentToolSelectorKind;\n readonly sensitivity: AgentToolSensitivity;\n readonly sensitive: boolean;\n}\n\nexport interface AgentToolSelectionCatalog {\n readonly selectors: readonly AgentToolSelector[];\n}\n\nexport interface AgentToolCallInput {\n toolId: string;\n arguments: Record<string, unknown>;\n}\n\nexport interface AgentToolSession<CallResult = unknown> {\n call(input: AgentToolCallInput): Promise<CallResult>;\n close?(): Promise<void>;\n}\n\nexport interface OpenAgentToolsSessionInput<\n Connection extends IntegrationConnection = IntegrationConnection,\n RequiredScope = unknown,\n ProviderScope = unknown,\n> {\n connection: Connection;\n tools: readonly AgentToolCatalogEntry<RequiredScope>[];\n scope: ProviderScope;\n}\n\nexport interface AgentToolsProvider<\n Connection extends IntegrationConnection = IntegrationConnection,\n RequiredScope = unknown,\n ProviderScope = unknown,\n CallResult = unknown,\n> {\n catalog():\n \| readonly AgentToolCatalogEntry<RequiredScope>[]\n \| Promise<readonly AgentToolCatalogEntry<RequiredScope>[]>;\n selectionCatalog(): AgentToolSelectionCatalog \| Promise<AgentToolSelectionCatalog>;\n openSession(\n input: OpenAgentToolsSessionInput<Connection, RequiredScope, ProviderScope>,\n ): Promise<AgentToolSession<CallResult>>;\n}\n\nexport interface IntegrationProviderAdapters<\n Connection extends IntegrationConnection = IntegrationConnection,\n> {\n source_control?: SourceControlProvider<Connection> \| undefined;\n agent_tools?: AgentToolsProvider<Connection> \| undefined;\n}\n\n/* Processes one provider-neutral inbound webhook request. /\nexport interface WebhookRequestProcessor {\n process(\n request: import('@shipfox/api-integration-core-dto').StoredWebhookRequest,\n ): Promise<import('@shipfox/api-integration-core-dto').WebhookProcessingResult>;\n}\n\nexport interface IntegrationProvider<\n ProviderKind extends IntegrationProviderKind = IntegrationProviderKind,\n Route = unknown,\n Connection extends IntegrationConnection<ProviderKind> = IntegrationConnection<ProviderKind>,\n> {\n provider: ProviderKind;\n displayName: string;\n adapters?: IntegrationProviderAdapters<Connection> \| undefined;\n routes?: Route[] \| undefined;\n connectionExternalUrl?(connection: Connection): Promise<string \| undefined>;\n /* Prepares provider-owned remote cleanup and returns a callback for after local deletion commits. /\n deleteConnectionRemoteResources?(\n connection: Connection,\n ): Promise<(() => Promise<void>) \| undefined>;\n /* Serializes connection deletion with provider operations that can recreate remote resources. /\n withConnectionDeletionLock?(connection: Connection, fn: () => Promise<void>): Promise<void>;\n deleteConnectionRecords?(connection: Connection, options: {tx: unknown}): Promise<void>;\n deleteConnectionSecrets?(connection: Connection): Promise<void>;\n}\n\nexport interface RegisteredIntegrationProvider<\n ProviderKind extends IntegrationProviderKind = IntegrationProviderKind,\n Route = unknown,\n Connection extends IntegrationConnection<ProviderKind> = IntegrationConnection<ProviderKind>,\n> extends IntegrationProvider<ProviderKind, Route, Connection> {\n adapters: IntegrationProviderAdapters<Connection>;\n capabilities: IntegrationCapability[];\n}\n\nexport type IntegrationProviderErrorReason =\n \| 'repository-not-found'\n \| 'installation-not-found'\n \| 'file-not-found'\n \| 'access-denied'\n \| 'rate-limited'\n \| 'timeout'\n \| 'provider-unavailable'\n \| 'malformed-provider-response'\n \| 'content-too-large'\n \| 'too-many-files';\n\nexport class IntegrationProviderError extends Error {\n constructor(\n public readonly reason: IntegrationProviderErrorReason,\n message: string,\n public readonly retryAfterSeconds?: number \| undefined,\n ) {\n super(message);\n this.name = 'IntegrationProviderError';\n }\n}\n\nexport class ConnectionSlugConflictError extends Error {\n constructor(cause: unknown) {\n super('Could not allocate a unique integration connection slug. Try again.', {cause});\n this.name = 'ConnectionSlugConflictError';\n }\n}\n\nexport const MAX_REPOSITORY_FILE_BYTES = 1_000_000;\n\nexport function buildProviderRepositoryId(\n provider: IntegrationProviderKind,\n value: string,\n): string {\n return `${provider}:${value}`;\n}\n\nexport function parseProviderRepositoryId(\n externalRepositoryId: string,\n expectedProvider: IntegrationProviderKind,\n): string {\n const separatorIndex = externalRepositoryId.indexOf(':');\n if (separatorIndex <= 0) {\n throw new IntegrationProviderError(\n 'repository-not-found',\n `External repository id is missing a provider prefix: ${externalRepositoryId}`,\n );\n }\n const prefix = externalRepositoryId.slice(0, separatorIndex);\n const value = externalRepositoryId.slice(separatorIndex + 1);\n if (prefix !== expectedProvider) {\n throw new IntegrationProviderError(\n 'repository-not-found',\n `External repository id ${externalRepositoryId} is not owned by provider ${expectedProvider}`,\n );\n }\n if (!value) {\n throw new IntegrationProviderError(\n 'repository-not-found',\n `External repository id ${externalRepositoryId} is missing a provider-owned value`,\n );\n }\n return value;\n}\n\n/* Checks the constraints enforced by `git check-ref-format`. /\nexport function isValidGitRefName(ref: string): boolean {\n if (!ref \|\| ref === '@' \|\| ref.startsWith('-')) return false;\n if (\n !ref.includes('/') \|\|\n ref.startsWith('/') \|\|\n ref.endsWith('/') \|\|\n ref.includes('//') \|\|\n ref.includes('..') \|\|\n ref.includes('@{') \|\|\n ref.endsWith('.')\n ) {\n return false;\n }\n if (\n [...ref].some((character) => {\n const code = character.codePointAt(0) ?? 0;\n return code <= 0x20 \|\| code === 0x7f \|\| '~^:?[]\\\\'.includes(character);\n })\n ) {\n return false;\n }\n\n const components = ref.split('/');\n return components.every(\n (component) =>\n component.length > 0 && !component.startsWith('.') && !component.endsWith('.lock'),\n );\n}\n\nexport function isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === 'object' && value !== null;\n}\n\nexport function asRecord(value: unknown): Record<string, unknown> \| null {\n return isRecord(value) ? value : null;\n}\n\nexport function nonEmptyString(value: unknown): string \| null {\n return typeof value === 'string' && value.length > 0 ? value : null;\n}\n\nexport function positiveInteger(value: unknown): number \| null {\n return typeof value === 'number' && Number.isInteger(value) && value > 0 ? value : null;\n}\n\n/** Validates a provider ref before it is passed to a git operation. */\nexport function isValidTriggerRef(ref: string): boolean {\n return isValidGitRefName(ref);\n}\n\nexport function isValidGitObjectId(value: string): boolean {\n return GIT_OBJECT_ID_PATTERN.test(value) && !ZERO_GIT_OBJECT_ID_PATTERN.test(value);\n}\n"],"names":["GIT_OBJECT_ID_PATTERN","ZERO_GIT_OBJECT_ID_PATTERN","IntegrationProviderError","Error","reason","message","retryAfterSeconds","name","ConnectionSlugConflictError","cause","MAX_REPOSITORY_FILE_BYTES","buildProviderRepositoryId","provider","value","parseProviderRepositoryId","externalRepositoryId","expectedProvider","separatorIndex","indexOf","prefix","slice","isValidGitRefName","ref","startsWith","includes","endsWith","some","character","code","codePointAt","components","split","every","component","length","isRecord","asRecord","nonEmptyString","positiveInteger","Number","isInteger","isValidTriggerRef","isValidGitObjectId","test"],"mappings":"AAIA,MAAMA,wBAAwB;AAC9B,MAAMC,6BAA6B;AA8PnC,OAAO,MAAMC,iCAAiCC;IAC5C,YACE,AAAgBC,MAAsC,EACtDC,OAAe,EACf,AAAgBC,iBAAsC,CACtD;QACA,KAAK,CAACD,eAJUD,SAAAA,aAEAE,oBAAAA;QAGhB,IAAI,CAACC,IAAI,GAAG;IACd;AACF;AAEA,OAAO,MAAMC,oCAAoCL;IAC/C,YAAYM,KAAc,CAAE;QAC1B,KAAK,CAAC,uEAAuE;YAACA;QAAK;QACnF,IAAI,CAACF,IAAI,GAAG;IACd;AACF;AAEA,OAAO,MAAMG,4BAA4B,UAAU;AAEnD,OAAO,SAASC,0BACdC,QAAiC,EACjCC,KAAa;IAEb,OAAO,GAAGD,SAAS,CAAC,EAAEC,OAAO;AAC/B;AAEA,OAAO,SAASC,0BACdC,oBAA4B,EAC5BC,gBAAyC;IAEzC,MAAMC,iBAAiBF,qBAAqBG,OAAO,CAAC;IACpD,IAAID,kBAAkB,GAAG;QACvB,MAAM,IAAIf,yBACR,wBACA,CAAC,qDAAqD,EAAEa,sBAAsB;IAElF;IACA,MAAMI,SAASJ,qBAAqBK,KAAK,CAAC,GAAGH;IAC7C,MAAMJ,QAAQE,qBAAqBK,KAAK,CAACH,iBAAiB;IAC1D,IAAIE,WAAWH,kBAAkB;QAC/B,MAAM,IAAId,yBACR,wBACA,CAAC,uBAAuB,EAAEa,qBAAqB,0BAA0B,EAAEC,kBAAkB;IAEjG;IACA,IAAI,CAACH,OAAO;QACV,MAAM,IAAIX,yBACR,wBACA,CAAC,uBAAuB,EAAEa,qBAAqB,kCAAkC,CAAC;IAEtF;IACA,OAAOF;AACT;AAEA,+DAA+D,GAC/D,OAAO,SAASQ,kBAAkBC,GAAW;IAC3C,IAAI,CAACA,OAAOA,QAAQ,OAAOA,IAAIC,UAAU,CAAC,MAAM,OAAO;IACvD,IACE,CAACD,IAAIE,QAAQ,CAAC,QACdF,IAAIC,UAAU,CAAC,QACfD,IAAIG,QAAQ,CAAC,QACbH,IAAIE,QAAQ,CAAC,SACbF,IAAIE,QAAQ,CAAC,SACbF,IAAIE,QAAQ,CAAC,SACbF,IAAIG,QAAQ,CAAC,MACb;QACA,OAAO;IACT;IACA,IACE;WAAIH;KAAI,CAACI,IAAI,CAAC,CAACC;QACb,MAAMC,OAAOD,UAAUE,WAAW,CAAC,MAAM;QACzC,OAAOD,QAAQ,QAAQA,SAAS,QAAQ,YAAYJ,QAAQ,CAACG;IAC/D,IACA;QACA,OAAO;IACT;IAEA,MAAMG,aAAaR,IAAIS,KAAK,CAAC;IAC7B,OAAOD,WAAWE,KAAK,CACrB,CAACC,YACCA,UAAUC,MAAM,GAAG,KAAK,CAACD,UAAUV,UAAU,CAAC,QAAQ,CAACU,UAAUR,QAAQ,CAAC;AAEhF;AAEA,OAAO,SAASU,SAAStB,KAAc;IACrC,OAAO,OAAOA,UAAU,YAAYA,UAAU;AAChD;AAEA,OAAO,SAASuB,SAASvB,KAAc;IACrC,OAAOsB,SAAStB,SAASA,QAAQ;AACnC;AAEA,OAAO,SAASwB,eAAexB,KAAc;IAC3C,OAAO,OAAOA,UAAU,YAAYA,MAAMqB,MAAM,GAAG,IAAIrB,QAAQ;AACjE;AAEA,OAAO,SAASyB,gBAAgBzB,KAAc;IAC5C,OAAO,OAAOA,UAAU,YAAY0B,OAAOC,SAAS,CAAC3B,UAAUA,QAAQ,IAAIA,QAAQ;AACrF;AAEA,qEAAqE,GACrE,OAAO,SAAS4B,kBAAkBnB,GAAW;IAC3C,OAAOD,kBAAkBC;AAC3B;AAEA,OAAO,SAASoB,mBAAmB7B,KAAa;IAC9C,OAAOb,sBAAsB2C,IAAI,CAAC9B,UAAU,CAACZ,2BAA2B0C,IAAI,CAAC9B;AAC/E"}