@shipfox/api-integration-spi 1.1.0 → 2.0.0

package/.turbo/turbo-build.log

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

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # @shipfox/api-integration-spi
 
+## 2.0.0
+
+### Major Changes
+
+- 18e9bad: Adds source-control ref resolution that pins branch and tag names to commits.
+
+### Minor Changes
+
+- 1b71a66: Exposes each provider's event catalog and the fixed-event providers on the integration validation context. Every provider now refuses the reserved `manual` and `cron` connection slugs.
+
+### Patch Changes
+
+- Updated dependencies [18e9bad]
+- Updated dependencies [c44641f]
+- Updated dependencies [1b71a66]
+  - @shipfox/api-integration-core-dto@14.0.0
+
+## 1.1.1
+
+### Patch Changes
+
+- f2b20af: Preserve GitHub provider rejection details and classify terminal agent-tool failures without reporting them as provider outages.
+
 ## 1.1.0
 
 ### Minor Changes

package/dist/contracts.d.ts

@@ -37,6 +37,13 @@ export interface ResolveRepositoryInput<Connection extends IntegrationConnection
     connection: Connection;
     externalRepositoryId: string;
 }
+export interface ResolveRefInput<Connection extends IntegrationConnection = IntegrationConnection> extends ResolveRepositoryInput<Connection> {
+    ref: string;
+}
+export interface ResolvedRef {
+    ref: string;
+    commit: string;
+}
 export interface FileSnapshot {
     path: string;
     ref: string;
@@ -96,6 +103,11 @@ export interface SourceControlProvider<Connection extends IntegrationConnection
     listFiles(input: ListFilesInput<Connection>): Promise<FilePage>;
     fetchFile(input: FetchFileInput<Connection>): Promise<FileSnapshot>;
     resolveTriggerReference(payload: unknown): TriggerReference | null;
+    /**
+     * Pins a branch or tag name to the commit it currently points at.
+     * The snapshot can become unreachable before a caller uses it.
+     */
+    resolveRef(input: ResolveRefInput<Connection>): Promise<ResolvedRef>;
     createCheckoutSpec?(input: CreateCheckoutSpecInput<Connection>): Promise<CheckoutSpec>;
 }
 export type AgentToolSensitivity = 'read' | 'write';
@@ -156,6 +168,13 @@ export interface WebhookRequestProcessor {
 export interface IntegrationProvider<ProviderKind extends IntegrationProviderKind = IntegrationProviderKind, Route = unknown, Connection extends IntegrationConnection<ProviderKind> = IntegrationConnection<ProviderKind>> {
     provider: ProviderKind;
     displayName: string;
+    /**
+     * The event names this provider documents for its handler.
+     * Provider-minted names are never treated as a closed set by validation; the
+     * catalog is a curated diagnostic aid and may omit provider events. Providers
+     * without a documented catalog, including built-in trigger sources, omit it.
+     */
+    eventCatalog?: import('@shipfox/api-integration-core-dto').IntegrationEventCatalog | undefined;
     adapters?: IntegrationProviderAdapters<Connection> | undefined;
     routes?: Route[] | undefined;
     connectionExternalUrl?(connection: Connection): Promise<string | undefined>;
@@ -172,11 +191,12 @@ export interface RegisteredIntegrationProvider<ProviderKind extends IntegrationP
     adapters: IntegrationProviderAdapters<Connection>;
     capabilities: IntegrationCapability[];
 }
-export type IntegrationProviderErrorReason = 'repository-not-found' | 'installation-not-found' | 'file-not-found' | 'access-denied' | 'rate-limited' | 'timeout' | 'provider-unavailable' | 'malformed-provider-response' | 'content-too-large' | 'too-many-files';
+export type IntegrationProviderErrorReason = 'repository-not-found' | 'installation-not-found' | 'file-not-found' | 'ref-not-found' | 'ref-invalid' | 'access-denied' | 'rate-limited' | 'timeout' | 'provider-unavailable' | 'provider-rejected' | 'malformed-provider-response' | 'content-too-large' | 'too-many-files';
 export declare class IntegrationProviderError extends Error {
     readonly reason: IntegrationProviderErrorReason;
     readonly retryAfterSeconds?: number | undefined;
-    constructor(reason: IntegrationProviderErrorReason, message: string, retryAfterSeconds?: number | undefined);
+    readonly status?: number | undefined;
+    constructor(reason: IntegrationProviderErrorReason, message: string, retryAfterSeconds?: number | undefined, status?: number | undefined);
 }
 export declare class ConnectionSlugConflictError extends Error {
     constructor(cause: unknown);
@@ -192,5 +212,14 @@ export declare function nonEmptyString(value: unknown): string | null;
 export declare function positiveInteger(value: unknown): number | null;
 /** Validates a provider ref before it is passed to a git operation. */
 export declare function isValidTriggerRef(ref: string): boolean;
+/**
+ * Validates a ref the platform may resolve to a commit: any safe git ref name
+ * except pull-request refs. Raw object ids do not satisfy the safe git ref
+ * name rules because valid refs must contain a slash. `refs/pull/N/head` can
+ * point at a fork and providers serve any commit in the repository network by
+ * SHA, so accepting names only keeps resolutions on refs a member pushed to
+ * the project repository.
+ */
+export declare function isValidResolvableRef(ref: string): boolean;
 export declare function isValidGitObjectId(value: string): boolean;
 //# sourceMappingURL=contracts.d.ts.map

package/dist/contracts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAC7C,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,GAAG,aAAa,CAAC;AACrE,MAAM,MAAM,oCAAoC,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;AAKnF,MAAM,WAAW,qBAAqB,CACpC,YAAY,SAAS,uBAAuB,GAAG,uBAAuB;IAEtE,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,YAAY,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,oCAAoC,CAAC;IACtD,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAEjF,MAAM,WAAW,kBAAkB;IACjC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,oBAAoB,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,kBAAkB,EAAE,CAAC;IACnC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB,CACpC,UAAU,SAAS,qBAAqB,GAAG,qBAAqB;IAEhE,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB,CACrC,UAAU,SAAS,qBAAqB,GAAG,qBAAqB;IAEhE,UAAU,EAAE,UAAU,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc,CAAC,UAAU,SAAS,qBAAqB,GAAG,qBAAqB,CAC9F,SAAQ,sBAAsB,CAAC,UAAU,CAAC;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc,CAAC,UAAU,SAAS,qBAAqB,GAAG,qBAAqB,CAC9F,SAAQ,sBAAsB,CAAC,UAAU,CAAC;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAC9C,SAAS,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;CAC3C;AAED,MAAM,WAAW,uBAAuB,CACtC,UAAU,SAAS,qBAAqB,GAAG,qBAAqB,CAChE,SAAQ,sBAAsB,CAAC,UAAU,CAAC;IAC1C,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,WAAW,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;CAC/C;AAED,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB,CACpC,UAAU,SAAS,qBAAqB,GAAG,qBAAqB;IAEhE,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACpF,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC1F,SAAS,CAAC,KAAK,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChE,SAAS,CAAC,KAAK,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACpE,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI,CAAC;IACnE,kBAAkB,CAAC,CAAC,KAAK,EAAE,uBAAuB,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACxF;AAED,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,OAAO,CAAC;AACpD,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1D,MAAM,WAAW,sBAAsB,CAAC,aAAa,GAAG,OAAO;IAC7D,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,oBAAoB,CAAC;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,aAAa,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB,CAAC,aAAa,GAAG,OAAO;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,oBAAoB,CAAC;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,aAAa,CAAC;IAC7B,WAAW,EAAE,mBAAmB,CAAC;IACjC,YAAY,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAC/C,OAAO,CAAC,EAAE,SAAS,sBAAsB,CAAC,aAAa,CAAC,EAAE,GAAG,SAAS,CAAC;CACxE;AAED,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,iBAAiB,GAAG,QAAQ,GAAG,YAAY,CAAC;AAE3F,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAClD;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,gBAAgB,CAAC,UAAU,GAAG,OAAO;IACpD,IAAI,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACrD,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,0BAA0B,CACzC,UAAU,SAAS,qBAAqB,GAAG,qBAAqB,EAChE,aAAa,GAAG,OAAO,EACvB,aAAa,GAAG,OAAO;IAEvB,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,SAAS,qBAAqB,CAAC,aAAa,CAAC,EAAE,CAAC;IACvD,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB,CACjC,UAAU,SAAS,qBAAqB,GAAG,qBAAqB,EAChE,aAAa,GAAG,OAAO,EACvB,aAAa,GAAG,OAAO,EACvB,UAAU,GAAG,OAAO;IAEpB,OAAO,IACH,SAAS,qBAAqB,CAAC,aAAa,CAAC,EAAE,GAC/C,OAAO,CAAC,SAAS,qBAAqB,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;IAC7D,gBAAgB,IAAI,yBAAyB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACnF,WAAW,CACT,KAAK,EAAE,0BAA0B,CAAC,UAAU,EAAE,aAAa,EAAE,aAAa,CAAC,GAC1E,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,2BAA2B,CAC1C,UAAU,SAAS,qBAAqB,GAAG,qBAAqB;IAEhE,cAAc,CAAC,EAAE,qBAAqB,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;IAC/D,WAAW,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;CAC1D;AAED,8DAA8D;AAC9D,MAAM,WAAW,uBAAuB;IACtC,OAAO,CACL,OAAO,EAAE,OAAO,mCAAmC,EAAE,oBAAoB,GACxE,OAAO,CAAC,OAAO,mCAAmC,EAAE,uBAAuB,CAAC,CAAC;CACjF;AAED,MAAM,WAAW,mBAAmB,CAClC,YAAY,SAAS,uBAAuB,GAAG,uBAAuB,EACtE,KAAK,GAAG,OAAO,EACf,UAAU,SAAS,qBAAqB,CAAC,YAAY,CAAC,GAAG,qBAAqB,CAAC,YAAY,CAAC;IAE5F,QAAQ,EAAE,YAAY,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,2BAA2B,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;IAC/D,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC;IAC7B,qBAAqB,CAAC,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC5E,sGAAsG;IACtG,+BAA+B,CAAC,CAC9B,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC9C,kGAAkG;IAClG,0BAA0B,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5F,uBAAuB,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE;QAAC,EAAE,EAAE,OAAO,CAAA;KAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxF,uBAAuB,CAAC,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjE;AAED,MAAM,WAAW,6BAA6B,CAC5C,YAAY,SAAS,uBAAuB,GAAG,uBAAuB,EACtE,KAAK,GAAG,OAAO,EACf,UAAU,SAAS,qBAAqB,CAAC,YAAY,CAAC,GAAG,qBAAqB,CAAC,YAAY,CAAC,CAC5F,SAAQ,mBAAmB,CAAC,YAAY,EAAE,KAAK,EAAE,UAAU,CAAC;IAC5D,QAAQ,EAAE,2BAA2B,CAAC,UAAU,CAAC,CAAC;IAClD,YAAY,EAAE,qBAAqB,EAAE,CAAC;CACvC;AAED,MAAM,MAAM,8BAA8B,GACtC,sBAAsB,GACtB,wBAAwB,GACxB,gBAAgB,GAChB,eAAe,GACf,cAAc,GACd,SAAS,GACT,sBAAsB,GACtB,6BAA6B,GAC7B,mBAAmB,GACnB,gBAAgB,CAAC;AAErB,qBAAa,wBAAyB,SAAQ,KAAK;aAE/B,MAAM,EAAE,8BAA8B;aAEtC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS;IAHxD,YACkB,MAAM,EAAE,8BAA8B,EACtD,OAAO,EAAE,MAAM,EACC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,EAIvD;CACF;AAED,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,YAAY,KAAK,EAAE,OAAO,EAGzB;CACF;AAED,eAAO,MAAM,yBAAyB,UAAY,CAAC;AAEnD,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,uBAAuB,EACjC,KAAK,EAAE,MAAM,GACZ,MAAM,CAER;AAED,wBAAgB,yBAAyB,CACvC,oBAAoB,EAAE,MAAM,EAC5B,gBAAgB,EAAE,uBAAuB,GACxC,MAAM,CAuBR;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CA2BtD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAEvE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAE5D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAE7D;AAED,uEAAuE;AACvE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEzD"}
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":"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"}

package/dist/contracts.js

@@ -1,8 +1,8 @@
 const GIT_OBJECT_ID_PATTERN = /^(?:[0-9a-f]{40}|[0-9a-f]{64})$/i;
 const ZERO_GIT_OBJECT_ID_PATTERN = /^0+$/;
 export class IntegrationProviderError extends Error {
-    constructor(reason, message, retryAfterSeconds){
-        super(message), this.reason = reason, this.retryAfterSeconds = retryAfterSeconds;
+    constructor(reason, message, retryAfterSeconds, status){
+        super(message), this.reason = reason, this.retryAfterSeconds = retryAfterSeconds, this.status = status;
         this.name = 'IntegrationProviderError';
     }
 }
@@ -64,6 +64,16 @@ export function positiveInteger(value) {
 /** Validates a provider ref before it is passed to a git operation. */ export function isValidTriggerRef(ref) {
     return isValidGitRefName(ref);
 }
+/**
+ * Validates a ref the platform may resolve to a commit: any safe git ref name
+ * except pull-request refs. Raw object ids do not satisfy the safe git ref
+ * name rules because valid refs must contain a slash. `refs/pull/N/head` can
+ * point at a fork and providers serve any commit in the repository network by
+ * SHA, so accepting names only keeps resolutions on refs a member pushed to
+ * the project repository.
+ */ export function isValidResolvableRef(ref) {
+    return isValidTriggerRef(ref) && !ref.startsWith('refs/pull/');
+}
 export function isValidGitObjectId(value) {
     return GIT_OBJECT_ID_PATTERN.test(value) && !ZERO_GIT_OBJECT_ID_PATTERN.test(value);
 }

package/dist/contracts.js.map

@@ -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  /** 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"}
+{"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 ResolveRefInput<Connection extends IntegrationConnection = IntegrationConnection>\n  extends ResolveRepositoryInput<Connection> {\n  ref: string;\n}\n\nexport interface ResolvedRef {\n  ref: string;\n  commit: 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  /**\n   * Pins a branch or tag name to the commit it currently points at.\n   * The snapshot can become unreachable before a caller uses it.\n   */\n  resolveRef(input: ResolveRefInput<Connection>): Promise<ResolvedRef>;\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  /**\n   * The event names this provider documents for its handler.\n   * Provider-minted names are never treated as a closed set by validation; the\n   * catalog is a curated diagnostic aid and may omit provider events. Providers\n   * without a documented catalog, including built-in trigger sources, omit it.\n   */\n  eventCatalog?: import('@shipfox/api-integration-core-dto').IntegrationEventCatalog | undefined;\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  | 'ref-not-found'\n  | 'ref-invalid'\n  | 'access-denied'\n  | 'rate-limited'\n  | 'timeout'\n  | 'provider-unavailable'\n  | 'provider-rejected'\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    public readonly status?: 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\n/**\n * Validates a ref the platform may resolve to a commit: any safe git ref name\n * except pull-request refs. Raw object ids do not satisfy the safe git ref\n * name rules because valid refs must contain a slash. `refs/pull/N/head` can\n * point at a fork and providers serve any commit in the repository network by\n * SHA, so accepting names only keeps resolutions on refs a member pushed to\n * the project repository.\n */\nexport function isValidResolvableRef(ref: string): boolean {\n  return isValidTriggerRef(ref) && !ref.startsWith('refs/pull/');\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","status","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","isValidResolvableRef","isValidGitObjectId","test"],"mappings":"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"}