@vornrun/connector-sdk 0.7.0-beta.12 → 0.7.0-beta.14

package/dist/{packaging-DFTuP4fr.d.ts → check-Hw1F1a5z.d.ts}

@@ -1,49 +1,3 @@
-/**
- * Surviving an upstream's bad minute.
- *
- * Every connector eventually meets the same three answers — a rate limit, a
- * gateway that briefly forgot how to work, a socket that died mid-call — and
- * every author writes the same retry loop for them, usually without the one
- * part that matters: only repeating calls that are safe to repeat. Doing it
- * here means a connector gets it by saying nothing at all.
- */
-interface RetryPolicy {
-    /** Total tries, including the first. Defaults to 3. */
-    attempts?: number;
-    /** First backoff step; each retry doubles it. Defaults to 250ms. */
-    baseDelayMs?: number;
-    /** Ceiling for any single wait, including one the server asked for. */
-    maxDelayMs?: number;
-}
-interface ResilientFetchOptions {
-    fetchImpl: typeof fetch;
-    /**
-     * Whether repeating the call is safe. A read always is; a write is only when
-     * the action said so, because retrying a `create` invents a second one.
-     */
-    retryable: boolean;
-    retry?: RetryPolicy;
-    /** Replaced in tests so backoff costs no real time. */
-    sleep?: (ms: number) => Promise<void>;
-}
-/**
- * How long the server asked us to wait, in milliseconds.
- *
- * `Retry-After` is either a count of seconds or an HTTP date; both are common
- * enough that reading only one of them is how a connector ends up hammering a
- * rate limiter it was politely asked to back off from.
- */
-declare function retryAfterMs(header: string | null, now: number): number | undefined;
-/** The wait before try number `attempt`, counting the first try as zero. */
-declare function backoffMs(attempt: number, policy?: RetryPolicy): number;
-/**
- * Wrap a fetch so it retries what is worth retrying.
- *
- * The wrapper is the value handed to actions as `context.fetch`, so a
- * hand-written action and a declared request are equally protected.
- */
-declare function resilientFetch(options: ResilientFetchOptions): typeof fetch;
-
 /**
  * Author-facing types for Vorn connectors.
  *
@@ -519,6 +473,80 @@ interface Connector extends ConnectorDefinition {
     readonly actions: ActionDefinition[];
 }
 
+/**
+ * What a connector must be true of as a *package*, rather than as a definition.
+ *
+ * Both `check` and `pack` ask these questions — check to fail a pull request
+ * early, pack to refuse an artifact — so they live here rather than in either,
+ * and neither imports the other.
+ */
+/** Largest pack Vorn will install, matched by the server's own verification. */
+declare const MAX_PACK_BYTES: number;
+interface BundleRequest {
+    contents: string;
+    resolveDir: string;
+}
+interface BundleOutput {
+    code: string;
+    /** Specifiers the bundler left for the runtime to resolve. */
+    external: string[];
+}
+/** Reject a source package whose install would run code on the user's machine. */
+declare function lifecycleScriptFindings(pkg: unknown): CheckFinding[];
+/** Specifiers left outside a bundle, which would need a registry at launch. */
+declare function bundleDependencyFindings(external: string[]): CheckFinding[];
+declare function bundledRequireFindings(code: string): CheckFinding[];
+/** Nearest package.json at or above a directory, or undefined when there is none. */
+declare function readNearestPackageJson(fromDir: string): Record<string, unknown> | undefined;
+/** The bundler `pack` uses, shared so `check` gates on the same answer. */
+declare function esbuildBundle(request: BundleRequest): Promise<BundleOutput>;
+
+/**
+ * Surviving an upstream's bad minute.
+ *
+ * Every connector eventually meets the same three answers — a rate limit, a
+ * gateway that briefly forgot how to work, a socket that died mid-call — and
+ * every author writes the same retry loop for them, usually without the one
+ * part that matters: only repeating calls that are safe to repeat. Doing it
+ * here means a connector gets it by saying nothing at all.
+ */
+interface RetryPolicy {
+    /** Total tries, including the first. Defaults to 3. */
+    attempts?: number;
+    /** First backoff step; each retry doubles it. Defaults to 250ms. */
+    baseDelayMs?: number;
+    /** Ceiling for any single wait, including one the server asked for. */
+    maxDelayMs?: number;
+}
+interface ResilientFetchOptions {
+    fetchImpl: typeof fetch;
+    /**
+     * Whether repeating the call is safe. A read always is; a write is only when
+     * the action said so, because retrying a `create` invents a second one.
+     */
+    retryable: boolean;
+    retry?: RetryPolicy;
+    /** Replaced in tests so backoff costs no real time. */
+    sleep?: (ms: number) => Promise<void>;
+}
+/**
+ * How long the server asked us to wait, in milliseconds.
+ *
+ * `Retry-After` is either a count of seconds or an HTTP date; both are common
+ * enough that reading only one of them is how a connector ends up hammering a
+ * rate limiter it was politely asked to back off from.
+ */
+declare function retryAfterMs(header: string | null, now: number): number | undefined;
+/** The wait before try number `attempt`, counting the first try as zero. */
+declare function backoffMs(attempt: number, policy?: RetryPolicy): number;
+/**
+ * Wrap a fetch so it retries what is worth retrying.
+ *
+ * The wrapper is the value handed to actions as `context.fetch`, so a
+ * hand-written action and a declared request are equally protected.
+ */
+declare function resilientFetch(options: ResilientFetchOptions): typeof fetch;
+
 interface PollPage {
     items: NormalizedItem[];
     nextCursor?: string;
@@ -763,7 +791,7 @@ declare function createConnectorHarness(connector: Connector, harnessOptions?: H
  * named check owns is a compile error rather than a receipt quietly vouching
  * for a check whose failure nothing was watching.
  */
-type CheckCode = 'missing-description' | 'auth-undeclared' | 'auth-probe-missing' | 'secret-not-marked' | 'action-no-outputs' | 'input-type-unsupported' | 'missing-idempotent' | 'unverifiable' | 'sample-unusable' | 'poll-failed' | 'no-items' | 'no-cursor' | 'cursor-rejected' | 'redelivers-items' | 'stuck-cursor' | 'lifecycle-scripts' | 'keywords-missing' | 'runtime-dependencies' | 'mock-action-failed' | 'mock-network-escape' | 'mock-not-observed' | 'preflight-failed' | 'live-action-failed' | 'pack-too-large';
+type CheckCode = 'missing-description' | 'auth-undeclared' | 'auth-probe-missing' | 'secret-not-marked' | 'action-no-outputs' | 'input-type-unsupported' | 'missing-idempotent' | 'unverifiable' | 'sample-unusable' | 'poll-failed' | 'no-items' | 'no-cursor' | 'cursor-rejected' | 'redelivers-items' | 'stuck-cursor' | 'lifecycle-scripts' | 'keywords-missing' | 'runtime-dependencies' | 'mock-action-failed' | 'mock-network-escape' | 'mock-not-observed' | 'preflight-failed' | 'live-action-failed' | 'pack-launch' | 'pack-too-large';
 interface CheckFinding {
     /** `error` means the connector will misbehave in Vorn; `warn` is advisory. */
     level: 'error' | 'warn';
@@ -852,31 +880,4 @@ declare function runConformance(connector: Connector, options?: CheckOptions): P
 /** Render findings for a terminal. Returns an empty string when all clear. */
 declare function formatFindings(findings: CheckFinding[]): string;
 
-/**
- * What a connector must be true of as a *package*, rather than as a definition.
- *
- * Both `check` and `pack` ask these questions — check to fail a pull request
- * early, pack to refuse an artifact — so they live here rather than in either,
- * and neither imports the other.
- */
-/** Largest pack Vorn will install, matched by the server's own verification. */
-declare const MAX_PACK_BYTES: number;
-interface BundleRequest {
-    contents: string;
-    resolveDir: string;
-}
-interface BundleOutput {
-    code: string;
-    /** Specifiers the bundler left for the runtime to resolve. */
-    external: string[];
-}
-/** Reject a source package whose install would run code on the user's machine. */
-declare function lifecycleScriptFindings(pkg: unknown): CheckFinding[];
-/** Specifiers left outside a bundle, which would need a registry at launch. */
-declare function bundleDependencyFindings(external: string[]): CheckFinding[];
-/** Nearest package.json at or above a directory, or undefined when there is none. */
-declare function readNearestPackageJson(fromDir: string): Record<string, unknown> | undefined;
-/** The bundler `pack` uses, shared so `check` gates on the same answer. */
-declare function esbuildBundle(request: BundleRequest): Promise<BundleOutput>;
-
-export { type StatusSuggestion as $, type ActionRequest as A, type BundleRequest as B, type ConnectorDefinition as C, type DedupeStrategy as D, MAX_PACK_BYTES as E, type FetchContext as F, MAX_POLL_PAGES as G, type HarnessOptions as H, type MockCall as I, type MockRoute as J, MockRouteMissError as K, type MockRun as L, MANIFEST_TOOL as M, type NormalizedItem as N, OPTIONS_TOOL as O, type PollContext as P, type OptionsContext as Q, type OptionsLoader as R, PREFLIGHT_TOOL as S, type TriggerDefinition as T, type PaginationStrategy as U, type PollPage as V, type PreflightResult as W, type ResilientFetchOptions as X, type RetryPolicy as Y, type RunActionOptions as Z, type RunPollOptions as _, type BundleOutput as a, backoffMs as a0, bundleDependencyFindings as a1, checkConnector as a2, connectionSetup as a3, connectorManifest as a4, createConnectorHarness as a5, drainPoll as a6, esbuildBundle as a7, escapedMockHttp as a8, formatFindings as a9, lifecycleScriptFindings as aa, pollToolName as ab, readNearestPackageJson as ac, resilientFetch as ad, retryAfterMs as ae, runAction as af, runConformance as ag, runOptions as ah, runPoll as ai, withMockHttp as aj, type Connector as b, type ConnectorConfig as c, type PollOutcome as d, type ConnectorItem as e, type PostReceiveOp as f, type CheckFinding as g, type ActionContext as h, type ActionDefinition as i, type ActionInputField as j, type ActionInputOption as k, type ActionInputType as l, type ActionOutputField as m, type AuthRung as n, CHECK_OWNERS as o, type CheckCode as p, type CheckOptions as q, type ConformanceRun as r, type ConnectionSetup as s, type ConnectorAuth as t, type ConnectorConfigField as u, type ConnectorHarness as v, type ConnectorIcon as w, type ConnectorManifest as x, type ConnectorVerification as y, type DefaultWorkflow as z };
+export { type StatusSuggestion as $, type ActionRequest as A, type BundleRequest as B, type CheckFinding as C, type DedupeStrategy as D, MAX_PACK_BYTES as E, type FetchContext as F, MAX_POLL_PAGES as G, type HarnessOptions as H, type MockCall as I, type MockRoute as J, MockRouteMissError as K, type MockRun as L, MANIFEST_TOOL as M, type NormalizedItem as N, OPTIONS_TOOL as O, type PollContext as P, type OptionsContext as Q, type OptionsLoader as R, PREFLIGHT_TOOL as S, type TriggerDefinition as T, type PaginationStrategy as U, type PollPage as V, type PreflightResult as W, type ResilientFetchOptions as X, type RetryPolicy as Y, type RunActionOptions as Z, type RunPollOptions as _, type BundleOutput as a, backoffMs as a0, bundleDependencyFindings as a1, bundledRequireFindings as a2, checkConnector as a3, connectionSetup as a4, connectorManifest as a5, createConnectorHarness as a6, drainPoll as a7, esbuildBundle as a8, escapedMockHttp as a9, formatFindings as aa, lifecycleScriptFindings as ab, pollToolName as ac, readNearestPackageJson as ad, resilientFetch as ae, retryAfterMs as af, runAction as ag, runConformance as ah, runOptions as ai, runPoll as aj, withMockHttp as ak, type ConnectorDefinition as b, type Connector as c, type ConnectorConfig as d, type PollOutcome as e, type ConnectorItem as f, type PostReceiveOp as g, type ActionContext as h, type ActionDefinition as i, type ActionInputField as j, type ActionInputOption as k, type ActionInputType as l, type ActionOutputField as m, type AuthRung as n, CHECK_OWNERS as o, type CheckCode as p, type CheckOptions as q, type ConformanceRun as r, type ConnectionSetup as s, type ConnectorAuth as t, type ConnectorConfigField as u, type ConnectorHarness as v, type ConnectorIcon as w, type ConnectorManifest as x, type ConnectorVerification as y, type DefaultWorkflow as z };