@aexhq/sdk 0.46.5-canary → 0.50.0

package/dist/downloads/download.js

@@ -0,0 +1,53 @@
+import { AexConfigError } from "../transport/errors.js";
+export const MAX_SINGLE_GET_BYTES = 5_000_000_000_000;
+export function planDownloadRanges(sizeBytes, selected) {
+    if (!Number.isSafeInteger(sizeBytes) || sizeBytes < 0)
+        throw new AexConfigError("invalid sizeBytes");
+    if (selected) {
+        if (!Number.isSafeInteger(selected.start) || !Number.isSafeInteger(selected.endExclusive)
+            || selected.start < 0 || selected.endExclusive <= selected.start || selected.endExclusive > sizeBytes) {
+            throw new AexConfigError("invalid half-open download range");
+        }
+        return [selected];
+    }
+    if (sizeBytes === 0)
+        return [];
+    const ranges = [];
+    for (let start = 0; start < sizeBytes; start += MAX_SINGLE_GET_BYTES) {
+        ranges.push({ start, endExclusive: Math.min(sizeBytes, start + MAX_SINGLE_GET_BYTES) });
+    }
+    return ranges;
+}
+export class Download {
+    grant;
+    #fetch;
+    constructor(grant, fetchLike = globalThis.fetch) {
+        this.grant = grant;
+        this.#fetch = fetchLike.bind(globalThis);
+    }
+    async bytes() {
+        if (Date.parse(this.grant.expiresAt) <= Date.now()) {
+            throw new AexConfigError("download grant expired");
+        }
+        const response = await this.#fetch(this.grant.url, {
+            ...(this.grant.headers ? { headers: this.grant.headers } : {}),
+            redirect: "error",
+        });
+        if (!response.ok)
+            throw new AexConfigError(`download failed with status ${response.status}`);
+        const bytes = new Uint8Array(await response.arrayBuffer());
+        if (bytes.byteLength !== this.grant.authorizedBytes) {
+            throw new AexConfigError(`download length mismatch: expected ${this.grant.authorizedBytes}, received ${bytes.byteLength}`);
+        }
+        if (this.grant.authorizedBytes === this.grant.sizeBytes) {
+            const digest = await crypto.subtle.digest("SHA-256", bytes);
+            const actual = Array.from(new Uint8Array(digest), (value) => value.toString(16).padStart(2, "0")).join("");
+            if (actual !== this.grant.sha256)
+                throw new AexConfigError("download digest mismatch");
+        }
+        return bytes;
+    }
+    async text() { return new TextDecoder().decode(await this.bytes()); }
+    async json() { return JSON.parse(await this.text()); }
+}
+//# sourceMappingURL=download.js.map

package/dist/downloads/download.js.map

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

package/dist/generated/errors.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The public error vocabulary, projected from the authored contract.
+ *
+ * `ERROR_METADATA` is keyed by `string` rather than by a closed union: a
+ * deployed platform can answer with a code newer than the installed SDK, and
+ * the transport decides what to construct from the lookup miss instead of
+ * failing to compile.
+ */
+export type ErrorClass = "auth" | "conflict" | "internal" | "not_found" | "precondition" | "quota" | "state" | "unavailable" | "validation";
+export declare const ERROR_METADATA: Readonly<Record<string, {
+    readonly class: ErrorClass;
+}>>;

package/dist/generated/errors.js

@@ -0,0 +1,81 @@
+// @generated by aex-contract-gen; DO NOT EDIT.
+// Contract digest: sha256:20d11fdca3dff3d75d7502a60456949b23e16df9094593f0c3f619368ab2218e
+export const ERROR_METADATA = Object.freeze({
+    unauthenticated: { class: "auth" },
+    forbidden: { class: "auth" },
+    insufficient_scope: { class: "auth" },
+    token_invalid: { class: "auth" },
+    token_revoked: { class: "auth" },
+    token_expired: { class: "auth" },
+    malformed_token: { class: "auth" },
+    authorization_pending: { class: "state" },
+    slow_down: { class: "quota" },
+    not_found: { class: "not_found" },
+    gone: { class: "not_found" },
+    idempotency_conflict: { class: "conflict" },
+    idempotency_in_flight: { class: "conflict" },
+    api_key_secret_unavailable: { class: "conflict" },
+    operation_idempotency_conflict: { class: "conflict" },
+    invalid_request: { class: "validation" },
+    invalid_scope: { class: "validation" },
+    invalid_cursor: { class: "validation" },
+    invalid_file_selection: { class: "validation" },
+    invalid_range: { class: "validation" },
+    unsupported_media_type: { class: "validation" },
+    payload_too_large: { class: "validation" },
+    limit_exceeded: { class: "quota" },
+    session_not_idle: { class: "state" },
+    workspace_activation_required: { class: "state" },
+    workspace_not_live: { class: "state" },
+    session_deleting: { class: "state" },
+    session_deleted: { class: "not_found" },
+    deletion_in_progress: { class: "conflict" },
+    resource_conflict: { class: "conflict" },
+    last_owner_required: { class: "state" },
+    operation_not_cancelable: { class: "state" },
+    approval_not_found: { class: "not_found" },
+    approval_already_resolved: { class: "conflict" },
+    approval_binding_changed: { class: "conflict" },
+    file_not_found: { class: "not_found" },
+    content_missing: { class: "state" },
+    export_not_found: { class: "not_found" },
+    export_not_ready: { class: "state" },
+    export_expired: { class: "not_found" },
+    export_revoked: { class: "not_found" },
+    export_capacity: { class: "unavailable" },
+    download_grant_expired: { class: "not_found" },
+    telemetry_payload_too_large: { class: "validation" },
+    invalid_telemetry: { class: "validation" },
+    telemetry_quota_exceeded: { class: "quota" },
+    telemetry_incomplete: { class: "state" },
+    unsupported_export_signal: { class: "validation" },
+    invalid_query: { class: "validation" },
+    telemetry_query_budget_exhausted: { class: "quota" },
+    invalid_metric_aggregation: { class: "validation" },
+    invalid_network_policy: { class: "validation" },
+    unsupported_package_ecosystem: { class: "validation" },
+    package_resolution_failed: { class: "state" },
+    package_artifact_unavailable: { class: "state" },
+    package_integrity_mismatch: { class: "state" },
+    unknown_provider: { class: "validation" },
+    unknown_model: { class: "validation" },
+    unqualified_provider_model: { class: "state" },
+    provider_credential_not_found: { class: "not_found" },
+    provider_credential_revoked: { class: "state" },
+    invalid_auto_topup_policy: { class: "validation" },
+    payment_method_required: { class: "state" },
+    authentication_unavailable: { class: "unavailable" },
+    account_paused: { class: "state" },
+    account_state_unavailable: { class: "unavailable" },
+    precondition_failed: { class: "precondition" },
+    wrong_workspace_region: { class: "conflict" },
+    observability_unavailable: { class: "unavailable" },
+    usage_unavailable: { class: "unavailable" },
+    rate_limited: { class: "quota" },
+    upstream_error: { class: "unavailable" },
+    workspace_provision_pending: { class: "unavailable" },
+    commit_outcome_unknown: { class: "unavailable" },
+    not_implemented: { class: "state" },
+    internal_error: { class: "internal" },
+});
+//# sourceMappingURL=errors.js.map

package/dist/generated/errors.js.map

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