@seamward/cli 0.1.0-alpha.10

package/dist/existing-webhook-binding.js

@@ -0,0 +1,196 @@
+import ts from "typescript";
+function scriptKind(file) {
+    if (/\.tsx$/i.test(file))
+        return ts.ScriptKind.TSX;
+    if (/\.jsx$/i.test(file))
+        return ts.ScriptKind.JSX;
+    if (/\.[cm]?js$/i.test(file))
+        return ts.ScriptKind.JS;
+    return ts.ScriptKind.TS;
+}
+function lineOf(source, node) {
+    return source.getLineAndCharacterOfPosition(node.getStart(source)).line + 1;
+}
+function webhookRouteCall(source, line, targetHint) {
+    const routeCalls = [];
+    const visit = (node) => {
+        if (!ts.isCallExpression(node)) {
+            ts.forEachChild(node, visit);
+            return;
+        }
+        if (ts.isPropertyAccessExpression(node.expression) &&
+            ["delete", "get", "patch", "post", "put"].includes(node.expression.name.text)) {
+            routeCalls.push(node);
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(source);
+    const normalizedHint = targetHint ? normalizeRoute(targetHint) : null;
+    const lineMatch = routeCalls.find((call) => lineOf(source, call) === line);
+    if (lineMatch)
+        return lineMatch;
+    if (!normalizedHint)
+        return null;
+    const routeMatches = routeCalls.filter((call) => normalizeRoute(literalText(call.arguments[0]) ?? "") === normalizedHint);
+    return routeMatches.length === 1 ? routeMatches[0] : null;
+}
+function normalizeRoute(value) {
+    if (!value)
+        return "";
+    try {
+        return new URL(value).pathname || "/";
+    }
+    catch {
+        return value;
+    }
+}
+function literalText(node) {
+    return node &&
+        (ts.isStringLiteral(node) || ts.isNoSubstitutionTemplateLiteral(node))
+        ? node.text
+        : null;
+}
+function routeTemplateValue(metadata) {
+    if (!metadata || !ts.isObjectLiteralExpression(metadata))
+        return null;
+    for (const property of metadata.properties) {
+        if (ts.isPropertyAssignment(property) &&
+            ((ts.isIdentifier(property.name) &&
+                property.name.text === "routeTemplate") ||
+                (ts.isStringLiteral(property.name) &&
+                    property.name.text === "routeTemplate"))) {
+            return property.initializer;
+        }
+        if (ts.isShorthandPropertyAssignment(property) &&
+            property.name.text === "routeTemplate") {
+            return property.name;
+        }
+    }
+    return null;
+}
+function isObserveWebhookCall(call) {
+    return (ts.isPropertyAccessExpression(call.expression) &&
+        call.expression.name.text === "observeWebhook");
+}
+function containsBoundObserveWebhook(node, target, routeParameter) {
+    let found = false;
+    const visit = (candidate) => {
+        if (found)
+            return;
+        if (ts.isCallExpression(candidate) && isObserveWebhookCall(candidate)) {
+            const routeValue = routeTemplateValue(candidate.arguments[0]);
+            if (literalText(routeValue ?? undefined) === target ||
+                (routeParameter &&
+                    routeValue &&
+                    ts.isIdentifier(routeValue) &&
+                    routeValue.text === routeParameter)) {
+                found = true;
+                return;
+            }
+        }
+        ts.forEachChild(candidate, visit);
+    };
+    visit(node);
+    return found;
+}
+function referencedIdentifiers(node) {
+    const identifiers = new Set();
+    const visit = (candidate) => {
+        if (ts.isIdentifier(candidate))
+            identifiers.add(candidate.text);
+        ts.forEachChild(candidate, visit);
+    };
+    visit(node);
+    return identifiers;
+}
+function namedVariableInitializers(source, names) {
+    const declarations = [];
+    const visit = (node) => {
+        if (ts.isVariableDeclaration(node) &&
+            ts.isIdentifier(node.name) &&
+            names.has(node.name.text) &&
+            node.initializer) {
+            declarations.push({
+                name: node.name.text,
+                initializer: node.initializer,
+            });
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(source);
+    return declarations;
+}
+function namedFunctions(source, name) {
+    const declarations = [];
+    const visit = (node) => {
+        if (ts.isFunctionDeclaration(node) &&
+            node.name?.text === name &&
+            node.body) {
+            declarations.push(node);
+        }
+        if (ts.isVariableDeclaration(node) &&
+            ts.isIdentifier(node.name) &&
+            node.name.text === name &&
+            node.initializer &&
+            (ts.isArrowFunction(node.initializer) ||
+                ts.isFunctionExpression(node.initializer))) {
+            declarations.push(node.initializer);
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(source);
+    return declarations;
+}
+function factoryBindsRoute(source, initializer, target) {
+    if (!ts.isIdentifier(initializer.expression))
+        return null;
+    if (literalText(initializer.arguments[0]) !== target)
+        return null;
+    const factoryName = initializer.expression.text;
+    for (const factory of namedFunctions(source, factoryName)) {
+        const routeParameter = factory.parameters[0]?.name;
+        if (!routeParameter ||
+            !ts.isIdentifier(routeParameter) ||
+            !factory.body ||
+            !containsBoundObserveWebhook(factory.body, target, routeParameter.text)) {
+            continue;
+        }
+        return factoryName;
+    }
+    return null;
+}
+export function findExistingWebhookBinding(input) {
+    const source = ts.createSourceFile(input.file, input.content, ts.ScriptTarget.Latest, true, scriptKind(input.file));
+    const routeCall = webhookRouteCall(source, input.line, input.targetHint);
+    if (!routeCall)
+        return null;
+    const target = literalText(routeCall.arguments[0]);
+    const handler = routeCall.arguments.at(-1);
+    if (!target || !handler)
+        return null;
+    if (containsBoundObserveWebhook(handler, target)) {
+        return {
+            marker: `existing collector backed for ${JSON.stringify(target)} via handler`,
+        };
+    }
+    const identifiers = referencedIdentifiers(handler);
+    for (const declaration of namedVariableInitializers(source, identifiers)) {
+        if (ts.isCallExpression(declaration.initializer) &&
+            isObserveWebhookCall(declaration.initializer) &&
+            containsBoundObserveWebhook(declaration.initializer, target)) {
+            return {
+                marker: `existing collector backed for ${JSON.stringify(target)} via ${declaration.name}`,
+            };
+        }
+        if (ts.isCallExpression(declaration.initializer)) {
+            const factoryName = factoryBindsRoute(source, declaration.initializer, target);
+            if (factoryName) {
+                return {
+                    marker: `existing collector backed for ${JSON.stringify(target)} via ${declaration.name}:${factoryName}`,
+                };
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=existing-webhook-binding.js.map

package/dist/existing-webhook-binding.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { discoverSources, scanProject, type ContractArtifact, type DiscoveryConfidence, type DiscoveryDirection, type DiscoveryFinding, type DiscoveryKind, type DiscoveryLanguage, type DiscoveryProtocol, type DiscoveryResult, type ScanProjectOptions, type SourceInput, } from "./discovery.js";
+export { applySetupPlan, completedSetupActionIds, createSetupPlan, discoverIntegrationScopes, discoverIntegrationGroups, isAutomaticIntegrationGroup, inspectSetupPlanFiles, inspectSetupActionEvidence, inspectSetupCompletionState, inspectSetupIntegrationBinding, inspectSetupRemoteLifecycle, operatorReviewableSetupActions, recordSourceBackedSetupEvidence, recordSetupIntegrationBinding, registeredContractVersionIdForFile, registeredContractVersionIdsForPlan, resetSetupCompletionState, setupCompletionStateFingerprint, setupInstrumentationMarker, supportedCollectorVersion, reviewSetupActions, type ApplySetupOptions, type ApplySetupResult, type GeneratedFile, type IntegrationProtocol, type IntegrationScope, type IntegrationGroup, type PackageManager, type RuntimeTarget, type ReviewSetupActionsResult, type SetupCompletionState, type SetupFileInspection, type SetupAction, type SetupActionCompletion, type SetupActionEvidenceInspection, type SetupActionEvidenceStatus, type SetupImplementationFileEvidence, type SetupVerificationEvidence, type SetupActionMode, type SetupActionType, type SetupPlan, type SetupPlanOptions, type SetupRemoteLifecycleState, } from "./setup-plan.js";
+export { checkFirstSetupObservation, type CheckFirstSetupObservationOptions, type FirstSetupObservationResult, } from "./observation-sync.js";
+export { SeamwardRemoteApiError, type SeamwardRemoteApiErrorCode, } from "./remote-api.js";
+export { applyLocalSetupBatch, createLocalSetupEngine, readSetupPlan, readSetupPlans, retireLocalSetupBindings, verifySetup, LocalSetupEngineError, type LocalSetupEngine, type LocalSetupEngineOptions, type LocalApplyResult, type SetupAnalysis, type SetupSelection, type SetupVerification, } from "./setup-engine.js";
+export { readProjectMetadata, type ProjectMetadata, } from "./project-metadata.js";
+export { activateContractVersion, activatePlanContractVersion, previewPlanContract, previewPlanContractActivation, readContractStatus, readMatchingActivePlanContract, reconcileActivePlanContract, registerPlanContracts, validatePlanContractActivation, type ContractActivationOptions, type ContractActivationResult, type PlanContractActivationOptions, type ContractRegistration, type ContractRegistrationOptions, type ContractRegistrationResult, type ContractStatusResult, type ContractVersionStatus, type JsonSchemaOperationBinding, type MatchingActivePlanContractOptions, type PlanContractStatusOptions, type PlanContractActivationPreview, } from "./contract-sync.js";
+export { parseConnectionKey, type ParsedConnectionKey, } from "./connection-key.js";
+export { cliVersion } from "./version.js";

package/dist/index.js

@@ -0,0 +1,10 @@
+export { discoverSources, scanProject, } from "./discovery.js";
+export { applySetupPlan, completedSetupActionIds, createSetupPlan, discoverIntegrationScopes, discoverIntegrationGroups, isAutomaticIntegrationGroup, inspectSetupPlanFiles, inspectSetupActionEvidence, inspectSetupCompletionState, inspectSetupIntegrationBinding, inspectSetupRemoteLifecycle, operatorReviewableSetupActions, recordSourceBackedSetupEvidence, recordSetupIntegrationBinding, registeredContractVersionIdForFile, registeredContractVersionIdsForPlan, resetSetupCompletionState, setupCompletionStateFingerprint, setupInstrumentationMarker, supportedCollectorVersion, reviewSetupActions, } from "./setup-plan.js";
+export { checkFirstSetupObservation, } from "./observation-sync.js";
+export { SeamwardRemoteApiError, } from "./remote-api.js";
+export { applyLocalSetupBatch, createLocalSetupEngine, readSetupPlan, readSetupPlans, retireLocalSetupBindings, verifySetup, LocalSetupEngineError, } from "./setup-engine.js";
+export { readProjectMetadata, } from "./project-metadata.js";
+export { activateContractVersion, activatePlanContractVersion, previewPlanContract, previewPlanContractActivation, readContractStatus, readMatchingActivePlanContract, reconcileActivePlanContract, registerPlanContracts, validatePlanContractActivation, } from "./contract-sync.js";
+export { parseConnectionKey, } from "./connection-key.js";
+export { cliVersion } from "./version.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,WAAW,GAWZ,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,eAAe,EACf,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,EAC3B,qBAAqB,EACrB,0BAA0B,EAC1B,2BAA2B,EAC3B,8BAA8B,EAC9B,2BAA2B,EAC3B,8BAA8B,EAC9B,+BAA+B,EAC/B,6BAA6B,EAC7B,kCAAkC,EAClC,mCAAmC,EACnC,yBAAyB,EACzB,+BAA+B,EAC/B,0BAA0B,EAC1B,yBAAyB,EACzB,kBAAkB,GAuBnB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,0BAA0B,GAG3B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,sBAAsB,GAEvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,aAAa,EACb,cAAc,EACd,wBAAwB,EACxB,WAAW,EACX,qBAAqB,GAOtB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,mBAAmB,GAEpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,mBAAmB,EACnB,6BAA6B,EAC7B,kBAAkB,EAClB,8BAA8B,EAC9B,2BAA2B,EAC3B,qBAAqB,EACrB,8BAA8B,GAa/B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,kBAAkB,GAEnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/observation-sync.d.ts

@@ -0,0 +1,28 @@
+import { type SetupPlan } from "./setup-plan.js";
+export type FirstSetupObservationResult = {
+    status: "source_verification_required";
+} | {
+    status: "contract_activation_required";
+} | {
+    status: "waiting";
+    integrationId: string;
+    checkedFrom: string;
+} | {
+    status: "observed";
+    integrationId: string;
+    observation: {
+        id: string;
+        receivedAt: string;
+    };
+    scope: "integration_connection";
+    recorded: boolean;
+};
+export interface CheckFirstSetupObservationOptions {
+    apiKey: string;
+    connectionKey: string;
+    endpoint?: string;
+    fetchFn?: typeof fetch;
+    timeoutMs?: number;
+    write?: boolean;
+}
+export declare function checkFirstSetupObservation(plan: SetupPlan, root: string, options: CheckFirstSetupObservationOptions): Promise<FirstSetupObservationResult>;

package/dist/observation-sync.js

@@ -0,0 +1,101 @@
+import { parseConnectionKey } from "./connection-key.js";
+import { remoteInvalidResponse, remoteNetworkError, remoteResponseError, } from "./remote-api.js";
+import { readContractStatus } from "./contract-sync.js";
+import { inspectSetupActionEvidence, inspectSetupRemoteLifecycle, recordFirstSetupObservation, } from "./setup-plan.js";
+function managementEndpoint(value) {
+    const url = new URL(value);
+    const loopback = ["localhost", "127.0.0.1", "::1"].includes(url.hostname);
+    if (url.protocol !== "https:" && !(url.protocol === "http:" && loopback)) {
+        throw new Error("Management API must use HTTPS unless it is local");
+    }
+    url.pathname = url.pathname.replace(/\/$/, "");
+    url.search = "";
+    url.hash = "";
+    return url.toString().replace(/\/$/, "");
+}
+function laterTimestamp(left, right) {
+    return right && Date.parse(right) > Date.parse(left) ? right : left;
+}
+export async function checkFirstSetupObservation(plan, root, options) {
+    if (!options.apiKey || !options.connectionKey) {
+        throw new Error("A Connection key and scoped API key are required");
+    }
+    const evidence = await inspectSetupActionEvidence(plan, root);
+    const instrumentationEvidence = evidence.filter(({ actionType }) => actionType === "instrument_operation");
+    if (instrumentationEvidence.length === 0 ||
+        instrumentationEvidence.some(({ status, recordedAt }) => status !== "source_verified" || !recordedAt)) {
+        return { status: "source_verification_required" };
+    }
+    const sourceEvidence = instrumentationEvidence
+        .map((action) => action.recordedAt)
+        .sort()
+        .at(-1);
+    if (!sourceEvidence)
+        return { status: "source_verification_required" };
+    const contractActions = evidence.filter(({ actionType }) => actionType === "register_contract");
+    const lifecycle = await inspectSetupRemoteLifecycle(plan, root);
+    if (contractActions.length > 0 && !lifecycle.activation) {
+        return { status: "contract_activation_required" };
+    }
+    if (contractActions.length > 0 && lifecycle.activation) {
+        const status = await readContractStatus({
+            apiKey: options.apiKey,
+            connectionKey: options.connectionKey,
+            ...(options.endpoint ? { endpoint: options.endpoint } : {}),
+            ...(options.fetchFn ? { fetchFn: options.fetchFn } : {}),
+            ...(options.timeoutMs ? { timeoutMs: options.timeoutMs } : {}),
+        });
+        if (status.activeContractVersionId !== lifecycle.activation.contractVersionId) {
+            return { status: "contract_activation_required" };
+        }
+    }
+    const checkedFrom = laterTimestamp(sourceEvidence, lifecycle.activation?.recordedAt);
+    const { integrationId } = parseConnectionKey(options.connectionKey);
+    const query = new URLSearchParams({
+        integrationId,
+        from: checkedFrom,
+        limit: "1",
+        sortBy: "receivedAt",
+        sortOrder: "asc",
+    });
+    const endpoint = managementEndpoint(options.endpoint ?? "https://api.seamward.com");
+    let response;
+    try {
+        response = await (options.fetchFn ?? fetch)(`${endpoint}/v1/observations?${query}`, {
+            headers: { authorization: `Bearer ${options.apiKey}` },
+            signal: AbortSignal.timeout(options.timeoutMs ?? 15_000),
+        });
+    }
+    catch {
+        throw remoteNetworkError();
+    }
+    if (response.status !== 200)
+        throw await remoteResponseError(response);
+    const payload = (await response.json());
+    if (!Array.isArray(payload.observations)) {
+        throw remoteInvalidResponse();
+    }
+    const observation = payload.observations[0];
+    if (!observation)
+        return { status: "waiting", integrationId, checkedFrom };
+    if (typeof observation.id !== "string" ||
+        typeof observation.receivedAt !== "string" ||
+        !Number.isFinite(Date.parse(observation.receivedAt))) {
+        throw remoteInvalidResponse();
+    }
+    if (options.write) {
+        await recordFirstSetupObservation(plan, root, {
+            integrationId,
+            observationId: observation.id,
+            receivedAt: observation.receivedAt,
+        });
+    }
+    return {
+        status: "observed",
+        integrationId,
+        observation: { id: observation.id, receivedAt: observation.receivedAt },
+        scope: "integration_connection",
+        recorded: options.write === true,
+    };
+}
+//# sourceMappingURL=observation-sync.js.map

package/dist/observation-sync.js.map

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

package/dist/project-metadata.d.ts

@@ -0,0 +1,7 @@
+import type { PackageManager, RuntimeTarget } from "./setup-plan.js";
+export interface ProjectMetadata {
+    projectName: string;
+    packageManager: PackageManager;
+    runtimeTarget: RuntimeTarget;
+}
+export declare function readProjectMetadata(root: string): Promise<ProjectMetadata>;

package/dist/project-metadata.js

@@ -0,0 +1,104 @@
+import { access, readFile } from "node:fs/promises";
+import path from "node:path";
+import { parse as parseYaml } from "yaml";
+async function exists(file) {
+    try {
+        await access(file);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function pnpmWorkspaceContainsMultipleServices(root) {
+    const workspaceFile = path.join(root, "pnpm-workspace.yaml");
+    if (!(await exists(workspaceFile)))
+        return false;
+    try {
+        const parsed = parseYaml(await readFile(workspaceFile, "utf8"));
+        if (!Array.isArray(parsed?.packages) || parsed.packages.length === 0) {
+            return true;
+        }
+        return parsed.packages.some((entry) => typeof entry !== "string" || ![".", "./"].includes(entry.trim()));
+    }
+    catch {
+        return true;
+    }
+}
+export async function readProjectMetadata(root) {
+    let projectName = path.basename(root);
+    let runtimeTarget = "unknown";
+    let packageDocument;
+    try {
+        packageDocument = JSON.parse(await readFile(path.join(root, "package.json"), "utf8"));
+    }
+    catch {
+        // A package manifest is optional for discovery-only and non-Node projects.
+    }
+    const workspaceMarkers = ["lerna.json", "rush.json", "go.work"];
+    let pythonWorkspace = false;
+    try {
+        pythonWorkspace = /^\[tool\.uv\.workspace\]\s*$/m.test(await readFile(path.join(root, "pyproject.toml"), "utf8"));
+    }
+    catch {
+        // Python projects do not require a pyproject file.
+    }
+    if (packageDocument?.workspaces ||
+        pythonWorkspace ||
+        (await pnpmWorkspaceContainsMultipleServices(root)) ||
+        (await Promise.all(workspaceMarkers.map((file) => exists(path.join(root, file))))).some(Boolean)) {
+        throw new Error("A workspace root contains multiple services. Run Seamward from one service directory");
+    }
+    if (packageDocument) {
+        if (typeof packageDocument.name === "string" &&
+            packageDocument.name.trim()) {
+            projectName = packageDocument.name.trim();
+        }
+        const dependencies = {
+            ...packageDocument.dependencies,
+            ...packageDocument.devDependencies,
+        };
+        const serverPackages = [
+            "@nestjs/core",
+            "@types/node",
+            "express",
+            "fastify",
+            "hapi",
+            "koa",
+        ];
+        const nodeDeclared = typeof packageDocument.engines?.node === "string" ||
+            serverPackages.some((name) => typeof dependencies[name] === "string");
+        const edgePackages = [
+            "@cloudflare/workers-types",
+            "@vercel/edge",
+            "edge-runtime",
+            "workerd",
+            "wrangler",
+        ];
+        const edgeMarkers = [
+            "deno.json",
+            "deno.jsonc",
+            "wrangler.json",
+            "wrangler.jsonc",
+            "wrangler.toml",
+        ];
+        const edgeTarget = edgePackages.some((name) => typeof dependencies[name] === "string") ||
+            (await Promise.all(edgeMarkers.map((file) => exists(path.join(root, file))))).some(Boolean);
+        const browserTarget = packageDocument.browser !== undefined &&
+            packageDocument.browser !== false;
+        if (!browserTarget && !edgeTarget && nodeDeclared) {
+            runtimeTarget =
+                packageDocument.type === "module" ? "node-esm" : "node-commonjs";
+        }
+    }
+    const packageManager = (await exists(path.join(root, "pnpm-lock.yaml")))
+        ? "pnpm"
+        : (await exists(path.join(root, "yarn.lock")))
+            ? "yarn"
+            : (await exists(path.join(root, "bun.lockb"))) ||
+                (await exists(path.join(root, "bun.lock")))
+                ? "bun"
+                : "npm";
+    return { projectName, packageManager, runtimeTarget };
+}
+//# sourceMappingURL=project-metadata.js.map

package/dist/project-metadata.js.map

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

package/dist/remote-api.d.ts

@@ -0,0 +1,10 @@
+export type SeamwardRemoteApiErrorCode = "authentication_required" | "insufficient_scope" | "not_found" | "contract_activation_conflict" | "integration_scope_mismatch" | "contract_version_conflict" | "remote_conflict" | "rate_limited" | "service_unavailable" | "remote_request_failed" | "remote_response_invalid";
+export declare class SeamwardRemoteApiError extends Error {
+    readonly code: SeamwardRemoteApiErrorCode;
+    readonly retryable: boolean;
+    readonly status: number | null;
+    constructor(code: SeamwardRemoteApiErrorCode, retryable: boolean, status: number | null);
+}
+export declare function remoteResponseError(response: Response): Promise<SeamwardRemoteApiError>;
+export declare function remoteNetworkError(): SeamwardRemoteApiError;
+export declare function remoteInvalidResponse(): SeamwardRemoteApiError;

package/dist/remote-api.js

@@ -0,0 +1,61 @@
+export class SeamwardRemoteApiError extends Error {
+    code;
+    retryable;
+    status;
+    constructor(code, retryable, status) {
+        super(code);
+        this.code = code;
+        this.retryable = retryable;
+        this.status = status;
+        this.name = "SeamwardRemoteApiError";
+    }
+}
+async function stableResponseCode(response) {
+    try {
+        const body = (await response.json());
+        return typeof body.error === "string" &&
+            /^[a-z0-9_]{1,80}$/.test(body.error)
+            ? body.error
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function remoteResponseError(response) {
+    const stableCode = await stableResponseCode(response);
+    if (response.status === 401) {
+        return new SeamwardRemoteApiError("authentication_required", false, 401);
+    }
+    if (response.status === 403) {
+        return new SeamwardRemoteApiError("insufficient_scope", false, 403);
+    }
+    if (response.status === 404) {
+        return new SeamwardRemoteApiError("not_found", false, 404);
+    }
+    if (response.status === 409) {
+        if (stableCode === "integration_scope_mismatch") {
+            return new SeamwardRemoteApiError("integration_scope_mismatch", false, 409);
+        }
+        if (stableCode === "contract_version_conflict") {
+            return new SeamwardRemoteApiError("contract_version_conflict", false, 409);
+        }
+        return new SeamwardRemoteApiError(stableCode === "active_contract_conflict"
+            ? "contract_activation_conflict"
+            : "remote_conflict", false, 409);
+    }
+    if (response.status === 429) {
+        return new SeamwardRemoteApiError("rate_limited", true, 429);
+    }
+    if (response.status >= 500) {
+        return new SeamwardRemoteApiError("service_unavailable", true, response.status);
+    }
+    return new SeamwardRemoteApiError("remote_request_failed", false, response.status);
+}
+export function remoteNetworkError() {
+    return new SeamwardRemoteApiError("service_unavailable", true, null);
+}
+export function remoteInvalidResponse() {
+    return new SeamwardRemoteApiError("remote_response_invalid", false, null);
+}
+//# sourceMappingURL=remote-api.js.map

package/dist/remote-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-api.js","sourceRoot":"","sources":["../src/remote-api.ts"],"names":[],"mappings":"AAaA,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAEpC;IACA;IACA;IAHX,YACW,IAAgC,EAChC,SAAkB,EAClB,MAAqB;QAE9B,KAAK,CAAC,IAAI,CAAC,CAAC;QAJH,SAAI,GAAJ,IAAI,CAA4B;QAChC,cAAS,GAAT,SAAS,CAAS;QAClB,WAAM,GAAN,MAAM,CAAe;QAG9B,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,KAAK,UAAU,kBAAkB,CAAC,QAAkB;IAClD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAwB,CAAC;QAC5D,OAAO,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ;YACnC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;YACpC,CAAC,CAAC,IAAI,CAAC,KAAK;YACZ,CAAC,CAAC,IAAI,CAAC;IACX,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,QAAkB;IAElB,MAAM,UAAU,GAAG,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACtD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,OAAO,IAAI,sBAAsB,CAAC,yBAAyB,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,OAAO,IAAI,sBAAsB,CAAC,oBAAoB,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,OAAO,IAAI,sBAAsB,CAAC,WAAW,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,IAAI,UAAU,KAAK,4BAA4B,EAAE,CAAC;YAChD,OAAO,IAAI,sBAAsB,CAC/B,4BAA4B,EAC5B,KAAK,EACL,GAAG,CACJ,CAAC;QACJ,CAAC;QACD,IAAI,UAAU,KAAK,2BAA2B,EAAE,CAAC;YAC/C,OAAO,IAAI,sBAAsB,CAC/B,2BAA2B,EAC3B,KAAK,EACL,GAAG,CACJ,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,sBAAsB,CAC/B,UAAU,KAAK,0BAA0B;YACvC,CAAC,CAAC,8BAA8B;YAChC,CAAC,CAAC,iBAAiB,EACrB,KAAK,EACL,GAAG,CACJ,CAAC;IACJ,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,OAAO,IAAI,sBAAsB,CAAC,cAAc,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;QAC3B,OAAO,IAAI,sBAAsB,CAC/B,qBAAqB,EACrB,IAAI,EACJ,QAAQ,CAAC,MAAM,CAChB,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,sBAAsB,CAC/B,uBAAuB,EACvB,KAAK,EACL,QAAQ,CAAC,MAAM,CAChB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,sBAAsB,CAAC,qBAAqB,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,IAAI,sBAAsB,CAAC,yBAAyB,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;AAC5E,CAAC"}