@vibesdotdev/integrations-digitalocean 0.0.0-stage → 1.0.0-rc.1

package/dist/client/factory.js

@@ -0,0 +1,220 @@
+import { CapabilityError, CaughtFailureSchema, settle } from '@vibesdotdev/kernel';
+import { BaseRuntimeClient } from '@vibesdotdev/kernel/client';
+import { getVibesSecretsClient } from '@vibesdotdev/secrets/client';
+import { CredentialUseBindingSchema } from '@vibesdotdev/secrets/schemas';
+import { loadDigitalOceanCredentialSettings } from "../config/digitalocean.config.descriptor.js";
+import { DigitalOceanCredentialUseOutcomeSchema, DigitalOceanSpacesCredentialUseOutcomeSchema } from "../schemas/control-plane.js";
+import { DigitalOceanCredentialUseReadSchema, DigitalOceanCredentialUseRequestSchema, DigitalOceanCredentialProvenanceSchema, DigitalOceanModelAuthenticatedRequestSchema, DigitalOceanModelCredentialProvenanceSchema, DigitalOceanSpacesCredentialUseRequestSchema } from "../schemas/credential-use.js";
+import { DigitalOceanControlPlaneClient } from "./control-plane.js";
+import { DigitalOceanAppsClient } from "../apps/api-client.js";
+import { DigitalOceanDropletsClient } from "../droplets/index.js";
+import { DigitalOceanStorageClient } from "../storage/index.js";
+import { DigitalOceanKubernetesClient } from "../kubernetes/index.js";
+import { DigitalOceanDatabasesClient } from "../databases/index.js";
+import { DigitalOceanAppDeployClient } from "../apps/deploy-client.js";
+import { requireApiToken } from "../credentials/index.js";
+/** Only confirmed absence advances to the next candidate; every other refusal propagates. */
+function isConfirmedAbsence(failure) {
+    return (failure instanceof CapabilityError &&
+        failure.code === 'NOT_FOUND' &&
+        failure.reason === 'credential-not-set');
+}
+/** The refusal when no candidate held the credential: the references tried, never a value. */
+function credentialMissing(candidates) {
+    const references = candidates.map((candidate) => 'reference' in candidate ? candidate.reference : candidate);
+    return new CapabilityError('No DigitalOcean credential candidate is set.', 'AUTH_REQUIRED', {
+        reason: 'digitalocean-credential-missing',
+        recoveryHint: 'Store the credential through secrets/store, or compose its reference in the credential-use settings.',
+        details: {
+            candidates: references.map(({ key, store }) => ({ key, store }))
+        }
+    });
+}
+async function sendWithCredentialReferences(runtime, request, candidates) {
+    const secrets = await getVibesSecretsClient(runtime);
+    for (const candidate of candidates) {
+        const presenceInput = {
+            key: candidate.reference.key,
+            store: candidate.reference.store
+        };
+        if (request.operation !== undefined)
+            presenceInput.operation = request.operation;
+        const presence = await settle(() => secrets.checkCredentialPresence(presenceInput));
+        if (!presence.ok) {
+            const failure = CaughtFailureSchema.parse(presence.cause);
+            if (!isConfirmedAbsence(failure))
+                throw failure;
+            continue;
+        }
+        const additionalBindings = request.options.credentialBindings;
+        const options = additionalBindings === undefined
+            ? {
+                ...request.options,
+                credential: candidate.reference
+            }
+            : {
+                ...request.options,
+                credentialBindings: [
+                    ...additionalBindings,
+                    CredentialUseBindingSchema.parse({
+                        kind: 'header',
+                        candidates: [candidate.reference],
+                        header: 'Authorization',
+                        prefix: 'Bearer '
+                    })
+                ]
+            };
+        const authenticatedInput = {
+            url: request.url,
+            options
+        };
+        if (request.signal !== undefined)
+            authenticatedInput.signal = request.signal;
+        if (request.operation !== undefined)
+            authenticatedInput.operation = request.operation;
+        const attempt = await settle(() => secrets.sendAuthenticatedRequest(authenticatedInput));
+        if (attempt.ok)
+            return { response: attempt.value, provenance: candidate.provenance };
+        throw CaughtFailureSchema.parse(attempt.cause);
+    }
+    throw credentialMissing(candidates.map(({ reference }) => reference));
+}
+/** The runtime owns this semantic factory and the lifetime of its clients. */
+export class DigitalOceanClientFactory extends BaseRuntimeClient {
+    async sendAuthenticatedRequest(input) {
+        const parsed = DigitalOceanCredentialUseRequestSchema.safeParse(input);
+        if (!parsed.success) {
+            throw new CapabilityError('DigitalOcean authenticated request is invalid.', 'INVALID_INPUT', {
+                reason: 'digitalocean-credential-use-invalid',
+                retryable: false,
+                details: { issueCount: parsed.error.issues.length }
+            });
+        }
+        const settings = await loadDigitalOceanCredentialSettings(this.runtime);
+        const candidates = parsed.data.candidates ?? settings.apiTokenCandidates;
+        return sendWithCredentialReferences(this.runtime, {
+            url: parsed.data.url,
+            options: parsed.data.options,
+            signal: parsed.data.signal,
+            operation: parsed.data.operation
+        }, candidates.map((candidate) => ({
+            reference: candidate.reference,
+            provenance: DigitalOceanCredentialProvenanceSchema.parse(candidate)
+        })));
+    }
+    /**
+     * Send a provider request through the configured ordered model-key references.
+     * Secrets resolves each reference, binds bearer authority and sends the request.
+     */
+    async sendModelAuthenticatedRequest(input) {
+        const parsed = DigitalOceanModelAuthenticatedRequestSchema.safeParse(input);
+        if (!parsed.success) {
+            throw new CapabilityError('DigitalOcean model request is invalid.', 'INVALID_INPUT', {
+                reason: 'digitalocean-credential-use-invalid',
+                retryable: false,
+                details: { issueCount: parsed.error.issues.length }
+            });
+        }
+        const settings = await loadDigitalOceanCredentialSettings(this.runtime);
+        const candidates = settings.modelAccessKeyCandidates.map((reference) => ({
+            reference,
+            provenance: DigitalOceanModelCredentialProvenanceSchema.parse({
+                reference,
+                kind: 'model-access-key'
+            })
+        }));
+        return sendWithCredentialReferences(this.runtime, parsed.data, candidates);
+    }
+    /**
+     * Read one credential through its ordered references. The value is resolved by
+     * the Secrets store owner and never returned: the caller receives the selected
+     * complete reference and the environment it answered for.
+     */
+    async useCredential(input) {
+        const parsed = DigitalOceanCredentialUseReadSchema.safeParse(input);
+        if (!parsed.success) {
+            throw new CapabilityError('DigitalOcean credential use read is invalid.', 'INVALID_INPUT', {
+                reason: 'digitalocean-credential-use-invalid',
+                retryable: false,
+                details: { issueCount: parsed.error.issues.length }
+            });
+        }
+        const settings = await loadDigitalOceanCredentialSettings(this.runtime);
+        const candidates = parsed.data.candidates ?? settings.modelAccessKeyCandidates;
+        const outcome = await this.findCredential(candidates);
+        if (outcome !== undefined)
+            return outcome;
+        throw credentialMissing(candidates);
+    }
+    /** Resolve ordered candidates while preserving every non-absence refusal. */
+    async findCredential(candidates) {
+        const environment = this.runtime.scope.qualifiers.environmentTier;
+        if (environment === undefined) {
+            throw new CapabilityError('No environment tier is declared, so no credential can be used.', 'INTERNAL', {
+                reason: 'digitalocean-credential-environment-undeclared',
+                retryable: false
+            });
+        }
+        for (const reference of candidates) {
+            const attempt = await settle(() => this.checkCredentialPresence(reference));
+            if (!attempt.ok) {
+                const failure = CaughtFailureSchema.parse(attempt.cause);
+                if (!isConfirmedAbsence(failure))
+                    throw failure;
+                continue;
+            }
+            if (!attempt.value)
+                continue;
+            return DigitalOceanCredentialUseOutcomeSchema.parse({ reference, environment });
+        }
+        return undefined;
+    }
+    /**
+     * Use a Spaces key pair. Each half resolves through its own ordered references;
+     * the outcome names both selected references and whether both halves were
+     * present, so a caller can act on a partial pair without ever holding a value.
+     */
+    async useSpacesCredentials(input) {
+        const parsed = DigitalOceanSpacesCredentialUseRequestSchema.safeParse(input);
+        if (!parsed.success) {
+            throw new CapabilityError('DigitalOcean Spaces credential use is invalid.', 'INVALID_INPUT', {
+                reason: 'digitalocean-credential-use-invalid',
+                retryable: false,
+                details: { issueCount: parsed.error.issues.length }
+            });
+        }
+        const settings = await loadDigitalOceanCredentialSettings(this.runtime);
+        const accessKeyIdCandidates = parsed.data.accessKeyId.candidates ?? settings.spacesAccessKeyIdCandidates;
+        const secretAccessKeyCandidates = parsed.data.secretAccessKey.candidates ?? settings.spacesSecretKeyCandidates;
+        const [accessKeyId, secretAccessKey] = await Promise.all([
+            this.findCredential(accessKeyIdCandidates),
+            this.findCredential(secretAccessKeyCandidates)
+        ]);
+        return DigitalOceanSpacesCredentialUseOutcomeSchema.parse({ accessKeyId, secretAccessKey });
+    }
+    /** Availability checks ask Secrets for value-free presence, never resolve a value. */
+    async checkCredentialPresence(reference) {
+        const secrets = await getVibesSecretsClient(this.runtime);
+        await secrets.checkCredentialPresence({ key: reference.key, store: reference.store });
+        return true;
+    }
+    create(token) {
+        const controlPlane = new DigitalOceanControlPlaneClient({
+            runtime: this.runtime,
+            credentialRuntime: this.runtime,
+            token: requireApiToken(token)
+        });
+        return {
+            controlPlane,
+            apps: new DigitalOceanAppsClient(controlPlane),
+            droplets: new DigitalOceanDropletsClient(controlPlane),
+            storage: new DigitalOceanStorageClient(controlPlane),
+            kubernetes: new DigitalOceanKubernetesClient(controlPlane),
+            databases: new DigitalOceanDatabasesClient(controlPlane)
+        };
+    }
+    createAppDeploy(options) {
+        return new DigitalOceanAppDeployClient(undefined, undefined, this.runtime, options);
+    }
+}
+//# sourceMappingURL=factory.js.map

package/dist/client/factory.js.map

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

package/dist/client/helpers.d.ts

@@ -0,0 +1,5 @@
+import type { RuntimeRef, VibesRuntime } from '@vibesdotdev/kernel';
+import type { DigitalOceanClientFactory } from './factory.ts';
+export declare function getDigitalOceanClientFactory(runtime: RuntimeRef): Promise<DigitalOceanClientFactory>;
+export declare function tryGetDigitalOceanClientFactory(runtime: VibesRuntime): DigitalOceanClientFactory | undefined;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/client/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/client/helpers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAE9D,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,UAAU,sCAE/D;AACD,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,YAAY,yCAEpE"}

package/dist/client/helpers.js

@@ -0,0 +1,8 @@
+import { getVibesClient, tryGetVibesClient } from '@vibesdotdev/kernel/client';
+export function getDigitalOceanClientFactory(runtime) {
+    return getVibesClient('digitalocean-client-factory', runtime);
+}
+export function tryGetDigitalOceanClientFactory(runtime) {
+    return tryGetVibesClient('digitalocean-client-factory', runtime);
+}
+//# sourceMappingURL=helpers.js.map

package/dist/client/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/client/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAI/E,MAAM,UAAU,4BAA4B,CAAC,OAAmB;IAC/D,OAAO,cAAc,CAA4B,6BAA6B,EAAE,OAAO,CAAC,CAAC;AAC1F,CAAC;AACD,MAAM,UAAU,+BAA+B,CAAC,OAAqB;IACpE,OAAO,iBAAiB,CAA4B,6BAA6B,EAAE,OAAO,CAAC,CAAC;AAC7F,CAAC"}

package/dist/client/index.d.ts

@@ -0,0 +1,12 @@
+export { DIGITALOCEAN_CONTROL_PLANE_BASE_URL, DIGITALOCEAN_INFERENCE_BASE_URL, doFetch, type DoFetchContext, type DoFetchImpl, type DoFetchRequest } from './do-fetch.ts';
+export type { DigitalOceanErrorBody } from './errors.ts';
+export { collectPaginated, paginate, type DoListLinks, type DoListMeta, type DoListResponse, type CollectOptions, type PaginateOptions } from './paginated.ts';
+export { computeRetryDelay, defaultIsRetryable, resolveRetryOptions, withRetry, type ResolvedRetryOptions, type RetryOptions } from './retry.ts';
+export { DigitalOceanControlPlaneClient, DigitalOceanPaginatedClient, type DigitalOceanControlPlaneClientOptions } from './control-plane.ts';
+export { digitalOceanApiError, digitalOceanNetworkError, digitalOceanHttpStatus } from './errors.ts';
+export { getDigitalOceanClientFactory, tryGetDigitalOceanClientFactory } from './helpers.ts';
+export type { DigitalOceanClientFactory } from './factory.ts';
+export * from '../schemas/control-plane.ts';
+export * from '../schemas/credential-use.ts';
+export * from '../schemas/http.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,mCAAmC,EACnC,+BAA+B,EAC/B,OAAO,EACP,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD,OAAO,EACN,gBAAgB,EAChB,QAAQ,EACR,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACN,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,SAAS,EACT,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACN,8BAA8B,EAC9B,2BAA2B,EAC3B,KAAK,qCAAqC,EAC1C,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrG,OAAO,EAAE,4BAA4B,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAC;AAC7F,YAAY,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAC9D,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,10 @@
+export { DIGITALOCEAN_CONTROL_PLANE_BASE_URL, DIGITALOCEAN_INFERENCE_BASE_URL, doFetch } from "./do-fetch.js";
+export { collectPaginated, paginate } from "./paginated.js";
+export { computeRetryDelay, defaultIsRetryable, resolveRetryOptions, withRetry } from "./retry.js";
+export { DigitalOceanControlPlaneClient, DigitalOceanPaginatedClient } from "./control-plane.js";
+export { digitalOceanApiError, digitalOceanNetworkError, digitalOceanHttpStatus } from "./errors.js";
+export { getDigitalOceanClientFactory, tryGetDigitalOceanClientFactory } from "./helpers.js";
+export * from "../schemas/control-plane.js";
+export * from "../schemas/credential-use.js";
+export * from "../schemas/http.js";
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,mCAAmC,EACnC,+BAA+B,EAC/B,OAAO,EAIP,MAAM,eAAe,CAAC;AAIvB,OAAO,EACN,gBAAgB,EAChB,QAAQ,EAMR,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACN,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,SAAS,EAGT,MAAM,YAAY,CAAC;AAEpB,OAAO,EACN,8BAA8B,EAC9B,2BAA2B,EAE3B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrG,OAAO,EAAE,4BAA4B,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAC;AAE7F,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC"}

package/dist/client/paginated.d.ts

@@ -0,0 +1,19 @@
+import type * as z from 'zod/v4';
+import type { DoFetchContext, DoFetchRequest } from './do-fetch.ts';
+export type { DoListResponse, DoListLinks, DoListMeta } from '../schemas/control-plane.ts';
+import type { DoListResponse } from '../schemas/control-plane.ts';
+export interface PaginateOptions<T extends DoListResponse> {
+    path: string;
+    request?: Omit<DoFetchRequest, 'method' | 'body' | 'json'>;
+    perPage?: number;
+    maxPages?: number;
+    schema: z.ZodType<T>;
+    extract: (page: NoInfer<T>) => readonly unknown[] | null | undefined;
+}
+export interface CollectOptions<T extends DoListResponse, Item> extends PaginateOptions<T> {
+    itemSchema: z.ZodType<Item>;
+    extract: (page: NoInfer<T>) => readonly Item[] | null | undefined;
+}
+export declare function paginate<T extends DoListResponse>(context: DoFetchContext, options: PaginateOptions<T>): AsyncGenerator<T, void, void>;
+export declare function collectPaginated<T extends DoListResponse, Item>(context: DoFetchContext, options: CollectOptions<T, Item>): Promise<Item[]>;
+//# sourceMappingURL=paginated.d.ts.map

package/dist/client/paginated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginated.d.ts","sourceRoot":"","sources":["../../src/client/paginated.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,CAAC,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpE,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC3F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,cAAc;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACrB,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,SAAS,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC;CACrE;AACD,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,cAAc,EAAE,IAAI,CAAE,SAAQ,eAAe,CAAC,CAAC,CAAC;IACzF,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC;CAClE;AAED,wBAAuB,QAAQ,CAAC,CAAC,SAAS,cAAc,EACvD,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAClD,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CA8B/B;AAED,wBAAsB,gBAAgB,CAAC,CAAC,SAAS,cAAc,EAAE,IAAI,EACpE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,EAAE,IAAI,CAAC,GACvD,OAAO,CAAC,IAAI,EAAE,CAAC,CAYjB"}

package/dist/client/paginated.js

@@ -0,0 +1,56 @@
+import { CapabilityError, settleNow } from '@vibesdotdev/kernel';
+import { doFetch, digitalOceanRequestUrl } from "./do-fetch.js";
+import { DigitalOceanListSchema, PaginationSettingsSchema } from "../schemas/control-plane.js";
+export async function* paginate(context, options) {
+    const parsedSettings = PaginationSettingsSchema.safeParse(options);
+    if (!parsedSettings.success)
+        throw new CapabilityError('DigitalOcean pagination settings are invalid.', 'INVALID_INPUT', {
+            reason: 'digitalocean-pagination-invalid', cause: parsedSettings.error
+        });
+    const settings = parsedSettings.data;
+    let url = digitalOceanRequestUrl(context.baseUrl, options.path);
+    if (!url.searchParams.has('per_page'))
+        url.searchParams.set('per_page', String(settings.perPage));
+    let pages = 0;
+    while (url) {
+        const page = await doFetch(context, url.href, options.request ?? {}, options.schema);
+        const envelope = DigitalOceanListSchema.safeParse(page);
+        if (!envelope.success)
+            throw new CapabilityError('DigitalOcean pagination response is invalid.', 'UNAVAILABLE', {
+                reason: 'digitalocean-response-invalid', retryable: false, cause: envelope.error
+            });
+        yield page;
+        pages += 1;
+        if (settings.maxPages !== undefined && pages >= settings.maxPages)
+            return;
+        const next = envelope.data.links?.pages?.next;
+        if (!next)
+            return;
+        if (next.startsWith('/') || URL.canParse(next)) {
+            url = digitalOceanRequestUrl(context.baseUrl, next);
+        }
+        else {
+            const resolved = settleNow(() => new URL(next, url).href);
+            if (!resolved.ok)
+                throw new CapabilityError('DigitalOcean pagination URL is invalid.', 'INVALID_INPUT', {
+                    reason: 'digitalocean-url-invalid', cause: resolved.cause
+                });
+            url = digitalOceanRequestUrl(context.baseUrl, resolved.value);
+        }
+    }
+}
+export async function collectPaginated(context, options) {
+    const out = [];
+    for await (const page of paginate(context, options)) {
+        for (const item of options.extract(page) ?? []) {
+            const parsed = options.itemSchema.safeParse(item);
+            if (!parsed.success)
+                throw new CapabilityError('DigitalOcean collection item is invalid.', 'UNAVAILABLE', {
+                    reason: 'digitalocean-response-invalid', retryable: false, cause: parsed.error
+                });
+            out.push(parsed.data);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=paginated.js.map

package/dist/client/paginated.js.map

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

package/dist/client/retry.d.ts

@@ -0,0 +1,34 @@
+import { type CaughtFailure, type VibesRuntime } from '@vibesdotdev/kernel';
+export interface RetryOptions {
+    maxAttempts?: number;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+    signal?: AbortSignal;
+    sleep?: (ms: number, signal?: AbortSignal) => Promise<void>;
+    isRetryable?: (error: CaughtFailure) => boolean;
+    onRetry?: (info: {
+        attempt: number;
+        delayMs: number;
+        error: CaughtFailure;
+    }) => void;
+}
+export interface ResolvedRetryOptions {
+    maxAttempts: number;
+    baseDelayMs: number;
+    maxDelayMs: number;
+    signal?: AbortSignal;
+    sleep: (ms: number, signal?: AbortSignal) => Promise<void>;
+    isRetryable: (error: CaughtFailure) => boolean;
+    onRetry?: (info: {
+        attempt: number;
+        delayMs: number;
+        error: CaughtFailure;
+    }) => void;
+}
+export type RetryRuntime = Pick<VibesRuntime, 'lifecycle'>;
+export declare function defaultIsRetryable(error: CaughtFailure): boolean;
+export declare function resolveRetryOptions(runtime: RetryRuntime, opts?: RetryOptions): ResolvedRetryOptions;
+export declare function computeRetryDelay(attempt: number, error: CaughtFailure, opts: ResolvedRetryOptions, random?: () => number): number;
+/** Bounded request attempts; all waiting and cancellation belong to the handed lifecycle. */
+export declare function withRetry<T>(runtime: RetryRuntime, run: (attempt: number) => Promise<T>, options?: RetryOptions, random?: () => number): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/client/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/client/retry.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAIrG,MAAM,WAAW,YAAY;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC;IAChD,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,aAAa,CAAC;KAAE,KAAK,IAAI,CAAC;CACtF;AACD,MAAM,WAAW,oBAAoB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,WAAW,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC;IAC/C,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,aAAa,CAAC;KAAE,KAAK,IAAI,CAAC;CACtF;AACD,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;AAE3D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAGhE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,GAAE,YAAiB,GAAG,oBAAoB,CAYxG;AAED,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,oBAAoB,EACjE,MAAM,GAAE,MAAM,MAAoB,GAChC,MAAM,CAOR;AAED,6FAA6F;AAC7F,wBAAsB,SAAS,CAAC,CAAC,EAChC,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAC3D,OAAO,GAAE,YAAiB,EAAE,MAAM,GAAE,MAAM,MAAoB,GAC5D,OAAO,CAAC,CAAC,CAAC,CAmBZ"}

package/dist/client/retry.js

@@ -0,0 +1,53 @@
+import { CapabilityError, settle } from '@vibesdotdev/kernel';
+import { RetrySettingsSchema } from "../schemas/control-plane.js";
+import { digitalOceanHttpStatus } from "./errors.js";
+export function defaultIsRetryable(error) {
+    return error instanceof CapabilityError &&
+        ['digitalocean-http-failed', 'digitalocean-network-failed'].includes(error.reason) && error.retryable;
+}
+export function resolveRetryOptions(runtime, opts = {}) {
+    const settings = RetrySettingsSchema.safeParse(opts);
+    if (!settings.success) {
+        throw new CapabilityError('DigitalOcean retry settings are invalid.', 'INVALID_INPUT', {
+            reason: 'digitalocean-retry-invalid', cause: settings.error
+        });
+    }
+    return {
+        ...settings.data, signal: opts.signal,
+        sleep: opts.sleep ?? ((ms, signal) => runtime.lifecycle.delay(ms, signal)),
+        isRetryable: opts.isRetryable ?? defaultIsRetryable, onRetry: opts.onRetry
+    };
+}
+export function computeRetryDelay(attempt, error, opts, random = Math.random) {
+    if (digitalOceanHttpStatus(error) === 429 && error instanceof CapabilityError) {
+        const hint = error.details?.retryAfterMs;
+        if (Number.isFinite(hint) && Number(hint) >= 0)
+            return Number(hint);
+    }
+    const exp = Math.min(opts.maxDelayMs, opts.baseDelayMs * 2 ** (attempt - 1));
+    return Math.floor(random() * exp);
+}
+/** Bounded request attempts; all waiting and cancellation belong to the handed lifecycle. */
+export async function withRetry(runtime, run, options = {}, random = Math.random) {
+    const opts = resolveRetryOptions(runtime, options);
+    const signal = opts.signal
+        ? AbortSignal.any([opts.signal, runtime.lifecycle.signal])
+        : runtime.lifecycle.signal;
+    for (let attempt = 1;; attempt += 1) {
+        if (signal.aborted) {
+            throw new CapabilityError('DigitalOcean request cancelled.', 'CANCELLED', {
+                reason: 'digitalocean-request-cancelled', cause: signal.reason
+            });
+        }
+        const result = await settle(() => run(attempt));
+        if (result.ok)
+            return result.value;
+        const failure = result.cause;
+        if (signal.aborted || attempt >= opts.maxAttempts || !opts.isRetryable(failure))
+            throw failure;
+        const delayMs = computeRetryDelay(attempt, failure, opts, random);
+        opts.onRetry?.({ attempt, delayMs, error: failure });
+        await opts.sleep(delayMs, signal);
+    }
+}
+//# sourceMappingURL=retry.js.map

package/dist/client/retry.js.map

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