@alienplatform/bindings 1.0.0 → 2.0.0

package/dist/index.d.ts

@@ -1,1770 +1,21 @@
-import * as _alienplatform_core0 from "@alienplatform/core";
-import { QueueMessage, ScheduledEvent, StorageEvent, StorageEvent as StorageEvent$1, StorageEventType } from "@alienplatform/core";
-import { Channel } from "nice-grpc";
-import * as z from "zod/v4";
-
-//#region src/bindings/storage.d.ts
-
 /**
- * Storage binding for object storage operations.
- *
- * @example
- * ```typescript
- * import { storage } from "@alienplatform/bindings"
- *
- * const bucket = storage("my-bucket")
- *
- * // Upload a file
- * await bucket.put("images/photo.jpg", imageData, { contentType: "image/jpeg" })
- *
- * // Download a file
- * const result = await bucket.get("images/photo.jpg")
- * console.log("Size:", result.meta.size)
- *
- * // List files
- * for await (const file of bucket.list("images/")) {
- *   console.log(file.location)
- * }
- *
- * // Generate a signed URL
- * const { url } = await bucket.signedUrl("images/photo.jpg", { operation: "get" })
- * ```
- */
-declare class Storage {
-  private readonly client;
-  private readonly bindingName;
-  constructor(channel: Channel, bindingName: string);
-  /**
-   * Get an object from storage.
-   *
-   * @param path - Path to the object
-   * @param options - Get options (range, conditionals)
-   * @returns Object data and metadata
-   */
-  get(path: string, options?: StorageGetOptions): Promise<StorageGetResult>;
-  /**
-   * Get an object as a UTF-8 string.
-   *
-   * @param path - Path to the object
-   * @param options - Get options
-   * @returns Object content as string
-   */
-  getText(path: string, options?: StorageGetOptions): Promise<string>;
-  /**
-   * Get an object and parse as JSON.
-   *
-   * @param path - Path to the object
-   * @param options - Get options
-   * @returns Parsed JSON content
-   */
-  getJson<T = unknown>(path: string, options?: StorageGetOptions): Promise<T>;
-  /**
-   * Put an object to storage.
-   *
-   * @param path - Path to store the object
-   * @param data - Object data
-   * @param options - Put options (content type, metadata)
-   */
-  put(path: string, data: Uint8Array | string | object, options?: StoragePutOptions): Promise<void>;
-  /**
-   * Put an object using streaming (for large files).
-   *
-   * @param path - Path to store the object
-   * @param chunks - Async iterable of data chunks
-   * @param options - Put options
-   */
-  putMultipart(path: string, chunks: AsyncIterable<Uint8Array>, options?: StoragePutOptions): Promise<void>;
-  /**
-   * Delete an object from storage.
-   *
-   * @param path - Path to the object
-   */
-  delete(path: string): Promise<void>;
-  /**
-   * List objects in storage.
-   *
-   * @param prefix - Optional prefix filter
-   * @param options - List options
-   * @returns Async iterable of object metadata
-   */
-  list(prefix?: string, options?: {
-    offset?: string;
-  }): AsyncIterable<StorageObjectMeta>;
-  /**
-   * List objects with delimiter (for directory-like listing).
-   *
-   * @param prefix - Optional prefix filter
-   * @returns List result with objects and common prefixes
-   */
-  listWithDelimiter(prefix?: string): Promise<StorageListResult>;
-  /**
-   * Get object metadata without downloading content.
-   *
-   * @param path - Path to the object
-   * @returns Object metadata
-   */
-  head(path: string): Promise<StorageObjectMeta>;
-  /**
-   * Check if an object exists.
-   *
-   * @param path - Path to the object
-   * @returns True if the object exists
-   */
-  exists(path: string): Promise<boolean>;
-  /**
-   * Get the base directory path for this storage binding.
-   *
-   * @returns Base directory path
-   */
-  getBaseDir(): Promise<string>;
-  /**
-   * Get the underlying URL for this storage binding.
-   *
-   * @returns Storage URL
-   */
-  getUrl(): Promise<string>;
-  /**
-   * Copy an object within the same storage binding.
-   *
-   * @param from - Source path
-   * @param to - Destination path
-   */
-  copy(from: string, to: string): Promise<void>;
-  /**
-   * Rename (move) an object within the same storage binding.
-   *
-   * @param from - Source path
-   * @param to - Destination path
-   */
-  rename(from: string, to: string): Promise<void>;
-  /**
-   * Copy an object only if the destination doesn't exist.
-   *
-   * @param from - Source path
-   * @param to - Destination path
-   */
-  copyIfNotExists(from: string, to: string): Promise<void>;
-  /**
-   * Rename (move) an object only if the destination doesn't exist.
-   *
-   * @param from - Source path
-   * @param to - Destination path
-   */
-  renameIfNotExists(from: string, to: string): Promise<void>;
-  /**
-   * Generate a signed URL for an object.
-   *
-   * @param path - Path to the object
-   * @param options - Signed URL options
-   * @returns Signed URL result
-   */
-  signedUrl(path: string, options: SignedUrlOptions): Promise<SignedUrlResult>;
-  private fromProtoMeta;
-}
-//#endregion
-//#region src/bindings/kv.d.ts
-/**
- * KV binding for key-value storage operations.
- *
- * @example
- * ```typescript
- * import { kv } from "@alienplatform/bindings"
- *
- * const cache = kv("my-cache")
- *
- * // Set a value
- * await cache.set("user:123", { name: "John", email: "john@example.com" })
- *
- * // Get a value
- * const user = await cache.getJson<User>("user:123")
- *
- * // Set with TTL (expires in 1 hour)
- * await cache.set("session:abc", sessionData, { ttlMs: 60 * 60 * 1000 })
- *
- * // Delete
- * await cache.delete("user:123")
- *
- * // Scan by prefix
- * for await (const { key, value } of cache.scan("user:")) {
- *   console.log(key, value)
- * }
- * ```
- */
-declare class Kv {
-  private readonly client;
-  private readonly bindingName;
-  constructor(channel: Channel, bindingName: string);
-  /**
-   * Get a value by key.
-   *
-   * @param key - Key to retrieve
-   * @returns Value as Uint8Array, or undefined if not found
-   */
-  get(key: string): Promise<Uint8Array | undefined>;
-  /**
-   * Get a value as a UTF-8 string.
-   *
-   * @param key - Key to retrieve
-   * @returns Value as string, or undefined if not found
-   */
-  getText(key: string): Promise<string | undefined>;
-  /**
-   * Get a value and parse as JSON.
-   *
-   * @param key - Key to retrieve
-   * @returns Parsed JSON value, or undefined if not found
-   */
-  getJson<T = unknown>(key: string): Promise<T | undefined>;
-  /**
-   * Set a value.
-   *
-   * @param key - Key to store
-   * @param value - Value to store (string, Uint8Array, or object for JSON)
-   * @param options - Optional put options (TTL, ifNotExists)
-   * @returns True if stored, false if ifNotExists was true and key already exists
-   */
-  set(key: string, value: string | Uint8Array | object, options?: KvPutOptions): Promise<boolean>;
-  /**
-   * Delete a key.
-   *
-   * @param key - Key to delete
-   */
-  delete(key: string): Promise<void>;
-  /**
-   * Check if a key exists.
-   *
-   * @param key - Key to check
-   * @returns True if the key exists
-   */
-  exists(key: string): Promise<boolean>;
-  /**
-   * Scan keys with a prefix.
-   *
-   * @param prefix - Prefix to scan for
-   * @param options - Optional scan options (limit)
-   * @returns Async iterable of key-value pairs
-   *
-   * @example
-   * ```typescript
-   * // Scan all users
-   * for await (const { key, value } of cache.scan("user:")) {
-   *   console.log(key, new TextDecoder().decode(value))
-   * }
-   * ```
-   */
-  scan(prefix: string, options?: {
-    limit?: number;
-  }): AsyncIterable<{
-    key: string;
-    value: Uint8Array;
-  }>;
-  /**
-   * Scan a single page of results.
-   *
-   * @param prefix - Prefix to scan for
-   * @param limit - Maximum items to return
-   * @param cursor - Pagination cursor
-   * @returns Scan result with items and next cursor
-   */
-  scanPage(prefix: string, limit?: number, cursor?: string): Promise<KvScanResult>;
-}
-//#endregion
-//#region src/bindings/queue.d.ts
-/**
- * Queue binding for message queue operations.
- *
- * @example
- * ```typescript
- * import { queue } from "@alienplatform/bindings"
- *
- * const tasks = queue("task-queue")
- *
- * // Send a message (JSON)
- * await tasks.send("process-image", { imageId: "123", format: "webp" })
- *
- * // Receive messages
- * const messages = await tasks.receive("process-image", 10)
- * for (const msg of messages) {
- *   await processImage(msg.payload)
- *   await tasks.ack("process-image", msg.receiptHandle)
- * }
- * ```
- */
-declare class Queue {
-  private readonly client;
-  private readonly bindingName;
-  constructor(channel: Channel, bindingName: string);
-  /**
-   * Send a message to a queue.
-   *
-   * @param queueName - Name of the queue
-   * @param payload - Message payload (object for JSON, string for text)
-   */
-  send(queueName: string, payload: unknown): Promise<void>;
-  /**
-   * Send a text message to a queue.
-   *
-   * @param queueName - Name of the queue
-   * @param text - Text message
-   */
-  sendText(queueName: string, text: string): Promise<void>;
-  /**
-   * Receive messages from a queue.
-   *
-   * @param queueName - Name of the queue
-   * @param maxMessages - Maximum number of messages to receive (1-10)
-   * @returns Array of messages with receipt handles
-   */
-  receive<T = unknown>(queueName: string, maxMessages?: number): Promise<ReceivedQueueMessage<T>[]>;
-  /**
-   * Acknowledge a message (remove it from the queue).
-   *
-   * @param queueName - Name of the queue
-   * @param receiptHandle - Receipt handle from the received message
-   */
-  ack(queueName: string, receiptHandle: string): Promise<void>;
-  /**
-   * Process messages from a queue with automatic acknowledgment.
-   *
-   * @param queueName - Name of the queue
-   * @param handler - Handler function for each message
-   * @param options - Processing options
-   *
-   * @example
-   * ```typescript
-   * await tasks.process("image-tasks", async (payload) => {
-   *   await processImage(payload.imageId)
-   * })
-   * ```
-   */
-  process<T = unknown>(queueName: string, handler: (payload: T) => Promise<void>, options?: {
-    maxMessages?: number;
-  }): Promise<void>;
-  private toProtoPayload;
-  private fromProtoMessage;
-}
-//#endregion
-//#region src/bindings/vault.d.ts
-/**
- * Vault binding for secret management operations.
- *
- * @example
- * ```typescript
- * import { vault } from "@alienplatform/bindings"
- *
- * const secrets = vault("app-secrets")
- *
- * // Get a secret
- * const apiKey = await secrets.get("API_KEY")
- *
- * // Set a secret
- * await secrets.set("DATABASE_URL", "postgres://...")
- *
- * // Delete a secret
- * await secrets.delete("OLD_KEY")
- * ```
- */
-declare class Vault {
-  private readonly client;
-  private readonly bindingName;
-  constructor(channel: Channel, bindingName: string);
-  /**
-   * Get a secret value.
-   *
-   * @param secretName - Name of the secret
-   * @returns Secret value
-   */
-  get(secretName: string): Promise<string>;
-  /**
-   * Get a secret as JSON.
-   *
-   * @param secretName - Name of the secret
-   * @returns Parsed JSON value
-   */
-  getJson<T = unknown>(secretName: string): Promise<T>;
-  /**
-   * Set a secret value.
-   *
-   * @param secretName - Name of the secret
-   * @param value - Secret value (string or object for JSON)
-   */
-  set(secretName: string, value: string | object): Promise<void>;
-  /**
-   * Delete a secret.
-   *
-   * @param secretName - Name of the secret to delete
-   */
-  delete(secretName: string): Promise<void>;
-  /**
-   * Check if a secret exists.
-   *
-   * @param secretName - Name of the secret
-   * @returns True if the secret exists
-   */
-  exists(secretName: string): Promise<boolean>;
-}
-//#endregion
-//#region src/bindings/build.d.ts
-/**
- * Build binding for executing build operations.
- *
- * @example
- * ```typescript
- * import { build } from "@alienplatform/bindings"
- *
- * const builder = build("my-builder")
- *
- * // Start a build
- * const execution = await builder.start({
- *   script: "npm run build",
- *   computeType: "medium",
- *   timeoutSeconds: 600,
- * })
- *
- * // Wait for completion
- * const result = await builder.waitForCompletion(execution.id)
- * console.log("Build status:", result.status)
- * ```
- */
-declare class Build {
-  private readonly client;
-  private readonly bindingName;
-  constructor(channel: Channel, bindingName: string);
-  /**
-   * Start a new build.
-   *
-   * @param config - Build configuration
-   * @returns Build execution information
-   */
-  start(config: BuildStartConfig): Promise<BuildExecution>;
-  /**
-   * Get the status of a build.
-   *
-   * @param buildId - Build execution ID
-   * @returns Build execution information
-   */
-  getStatus(buildId: string): Promise<BuildExecution>;
-  /**
-   * Stop a running build.
-   *
-   * @param buildId - Build execution ID
-   */
-  stop(buildId: string): Promise<void>;
-  /**
-   * Wait for a build to complete.
-   *
-   * @param buildId - Build execution ID
-   * @param options - Polling options
-   * @returns Final build execution information
-   */
-  waitForCompletion(buildId: string, options?: {
-    pollIntervalMs?: number;
-    timeoutMs?: number;
-  }): Promise<BuildExecution>;
-  private toProtoConfig;
-  private fromProtoExecution;
-}
-//#endregion
-//#region src/bindings/function.d.ts
-/**
- * Function binding for direct function invocation.
- *
- * @example
- * ```typescript
- * import { func } from "@alienplatform/bindings"
- *
- * const processor = func("image-processor")
- *
- * // Invoke with JSON body
- * const response = await processor.invokeJson("resize-image", {
- *   imageUrl: "https://...",
- *   width: 800,
- *   height: 600,
- * })
- *
- * // Get function URL
- * const url = await processor.getUrl()
- * ```
- */
-declare class FunctionBinding {
-  private readonly client;
-  private readonly bindingName;
-  constructor(channel: Channel, bindingName: string);
-  /**
-   * Invoke a function with raw request data.
-   *
-   * @param request - Invocation request
-   * @returns Function response
-   */
-  invoke(request: FunctionInvokeRequest): Promise<FunctionInvokeResponse>;
-  /**
-   * Invoke a function with a JSON body.
-   *
-   * @param targetFunction - Target function identifier
-   * @param body - JSON body
-   * @param options - Optional request options
-   * @returns Parsed JSON response
-   */
-  invokeJson<TRequest, TResponse = unknown>(targetFunction: string, body: TRequest, options?: {
-    method?: string;
-    path?: string;
-    headers?: Record<string, string>;
-    timeoutMs?: number;
-  }): Promise<TResponse>;
-  /**
-   * Invoke a function with GET request.
-   *
-   * @param targetFunction - Target function identifier
-   * @param path - Request path
-   * @param options - Optional request options
-   * @returns Parsed JSON response
-   */
-  get<TResponse = unknown>(targetFunction: string, path?: string, options?: {
-    headers?: Record<string, string>;
-    timeoutMs?: number;
-  }): Promise<TResponse>;
-  /**
-   * Get the public URL of the function.
-   *
-   * @returns Function URL if available
-   */
-  getUrl(): Promise<string | undefined>;
-}
-//#endregion
-//#region src/bindings/service-account.d.ts
-/**
- * ServiceAccount binding for identity and impersonation.
- *
- * @example
- * ```typescript
- * import { serviceAccount } from "@alienplatform/bindings"
- *
- * const sa = serviceAccount("deployment-account")
- *
- * // Get account info
- * const info = await sa.getInfo()
- * if (info.platform === "aws") {
- *   console.log("Role ARN:", info.roleArn)
- * }
- *
- * // Impersonate the service account
- * const config = await sa.impersonate({ durationSeconds: 3600 })
- * ```
- */
-declare class ServiceAccount {
-  private readonly client;
-  private readonly bindingName;
-  constructor(channel: Channel, bindingName: string);
-  /**
-   * Get information about the service account.
-   *
-   * @returns Platform-specific service account information
-   */
-  getInfo(): Promise<ServiceAccountInfo>;
-  /**
-   * Impersonate the service account.
-   *
-   * @param request - Impersonation options
-   * @returns Client configuration for the impersonated identity
-   */
-  impersonate(request?: ImpersonationRequest): Promise<unknown>;
-  private fromProtoInfo;
-}
-//#endregion
-//#region src/types.d.ts
-/**
- * Options for storage get operations.
- */
-interface StorageGetOptions {
-  /** Range start offset in bytes */
-  rangeStart?: number;
-  /** Range end offset in bytes */
-  rangeEnd?: number;
-  /** If-Match header value (ETag) */
-  ifMatch?: string;
-  /** If-None-Match header value (ETag) */
-  ifNoneMatch?: string;
-  /** If-Modified-Since timestamp */
-  ifModifiedSince?: Date;
-  /** If-Unmodified-Since timestamp */
-  ifUnmodifiedSince?: Date;
-}
-/**
- * Options for storage put operations.
- */
-interface StoragePutOptions {
-  /** Content type of the object */
-  contentType?: string;
-  /** Custom metadata */
-  metadata?: Record<string, string>;
-  /** Only write if the object doesn't already exist */
-  ifNotExists?: boolean;
-}
-/**
- * Object metadata from storage.
- */
-interface StorageObjectMeta {
-  /** Full path of the object */
-  location: string;
-  /** Last modified timestamp */
-  lastModified?: Date;
-  /** Object size in bytes */
-  size: number;
-  /** ETag (entity tag) for the object */
-  etag?: string;
-  /** Object version */
-  version?: string;
-}
-/**
- * Result of a storage get operation.
- */
-interface StorageGetResult {
-  /** Object metadata */
-  meta: StorageObjectMeta;
-  /** Object data as bytes */
-  data: Uint8Array;
-}
-/**
- * Result of a storage list operation with delimiter.
- */
-interface StorageListResult {
-  /** Common prefixes (directories) */
-  commonPrefixes: string[];
-  /** Object metadata entries */
-  objects: StorageObjectMeta[];
-}
-/**
- * Options for signed URL generation.
- */
-interface SignedUrlOptions {
-  /** Operation type: get (download), put (upload), or delete */
-  operation: "get" | "put" | "delete";
-  /** URL expiration duration in seconds */
-  expiresInSeconds?: number;
-  /** Content type for put operations */
-  contentType?: string;
-}
-/**
- * Result of signed URL generation.
- */
-interface SignedUrlResult {
-  /** The signed URL */
-  url: string;
-  /** URL expiration timestamp */
-  expiresAt?: Date;
-}
-/**
- * Options for KV put operations.
- */
-interface KvPutOptions {
-  /** Time-to-live in milliseconds */
-  ttlMs?: number;
-  /** Only write if the key doesn't exist */
-  ifNotExists?: boolean;
-}
-/**
- * Result of a KV scan operation.
- */
-interface KvScanResult {
-  /** Key-value pairs */
-  items: Array<{
-    key: string;
-    value: Uint8Array;
-  }>;
-  /** Cursor for next page */
-  nextCursor?: string;
-}
-/**
- * A message received from a queue via the Queue binding.
- * (Not to be confused with QueueMessage from @alienplatform/core which is used for event handlers)
- */
-interface ReceivedQueueMessage<T = unknown> {
-  /** Message payload */
-  payload: T;
-  /** Receipt handle for acknowledgment */
-  receiptHandle: string;
-}
-/**
- * Configuration for starting a build via the Build binding.
- * (SDK-specific - different from BuildConfig in core which is for resource definition)
- */
-interface BuildStartConfig {
-  /** Build script to execute */
-  script: string;
-  /** Environment variables */
-  environment?: Record<string, string>;
-  /** Compute type */
-  computeType?: _alienplatform_core0.ComputeType;
-  /** Timeout in seconds */
-  timeoutSeconds?: number;
-  /** Monitoring configuration */
-  monitoring?: {
-    endpoint: string;
-    headers?: Record<string, string>;
-    logsUri?: string;
-    tlsEnabled?: boolean;
-    tlsVerify?: boolean;
-  };
-}
-/**
- * Information about a build execution.
- */
-interface BuildExecution {
-  /** Build execution ID */
-  id: string;
-  /** Current status */
-  status: _alienplatform_core0.BuildStatus;
-  /** Start timestamp */
-  startTime?: Date;
-  /** End timestamp */
-  endTime?: Date;
-}
-/**
- * Permission levels for artifact registry access.
- */
-type ArtifactRegistryPermissions = "pull" | "push-pull";
-/**
- * Information about a repository.
- */
-interface RepositoryInfo {
-  /** Repository name */
-  name: string;
-  /** Repository URI */
-  uri: string;
-  /** Creation timestamp */
-  createdAt?: Date;
-}
-/**
- * Credentials for repository access.
- */
-interface ArtifactRegistryCredentials {
-  /** Username for authentication */
-  username: string;
-  /** Password/token for authentication */
-  password: string;
-  /** Credential expiration timestamp */
-  expiresAt?: Date;
-}
-/**
- * Types of compute services that can have cross-account access.
- */
-type ComputeServiceType = "function";
-/**
- * AWS-specific cross-account access configuration.
- */
-interface AwsCrossAccountAccess {
-  /** AWS account IDs that should have access */
-  accountIds: string[];
-  /** Types of compute services that should have access */
-  allowedServiceTypes: ComputeServiceType[];
-  /** Specific IAM role ARNs to grant access to */
-  roleArns: string[];
-}
-/**
- * GCP-specific cross-account access configuration.
- */
-interface GcpCrossAccountAccess {
-  /** GCP project numbers that should have access */
-  projectNumbers: string[];
-  /** Types of compute services that should have access */
-  allowedServiceTypes: ComputeServiceType[];
-  /** Additional service account emails to grant access to */
-  serviceAccountEmails: string[];
-}
-/**
- * Cross-account access configuration (discriminated union).
- */
-type CrossAccountAccess = {
-  type: "aws";
-  aws: AwsCrossAccountAccess;
-} | {
-  type: "gcp";
-  gcp: GcpCrossAccountAccess;
-};
-/**
- * Current cross-account access permissions.
- */
-interface CrossAccountPermissions {
-  /** Platform-specific access configuration */
-  access: CrossAccountAccess;
-  /** Timestamp when permissions were last updated (ISO8601 format) */
-  lastUpdated?: string;
-}
-/**
- * Request for function invocation.
- */
-interface FunctionInvokeRequest {
-  /** Target function identifier */
-  targetFunction: string;
-  /** HTTP method */
-  method: string;
-  /** Request path */
-  path: string;
-  /** Request headers */
-  headers?: Record<string, string>;
-  /** Request body */
-  body?: Uint8Array;
-  /** Timeout in milliseconds */
-  timeoutMs?: number;
-}
-/**
- * Response from function invocation.
- */
-interface FunctionInvokeResponse {
-  /** HTTP status code */
-  status: number;
-  /** Response headers */
-  headers: Record<string, string>;
-  /** Response body */
-  body: Uint8Array;
-}
-/**
- * AWS service account information.
- */
-interface AwsServiceAccountInfo {
-  platform: "aws";
-  roleName: string;
-  roleArn: string;
-}
-/**
- * GCP service account information.
- */
-interface GcpServiceAccountInfo {
-  platform: "gcp";
-  email: string;
-  uniqueId: string;
-}
-/**
- * Azure service account information.
- */
-interface AzureServiceAccountInfo {
-  platform: "azure";
-  clientId: string;
-  resourceId: string;
-  principalId: string;
-}
-/**
- * Platform-specific service account information.
- */
-type ServiceAccountInfo = AwsServiceAccountInfo | GcpServiceAccountInfo | AzureServiceAccountInfo;
-/**
- * Request for service account impersonation.
- */
-interface ImpersonationRequest {
-  /** Session name for AWS */
-  sessionName?: string;
-  /** Duration in seconds */
-  durationSeconds?: number;
-  /** OAuth scopes for GCP */
-  scopes?: string[];
-}
-/**
- * Configuration for connecting to the Alien bindings server.
- */
-interface AlienBindingsConfig {
-  /** gRPC server address */
-  grpcAddress?: string;
-}
-/**
- * Interface for the bindings provider.
- */
-interface AlienBindingsProvider {
-  /** Get a storage binding */
-  storage(name: string): Storage;
-  /** Get a KV binding */
-  kv(name: string): Kv;
-  /** Get a queue binding */
-  queue(name: string): Queue;
-  /** Get a vault binding */
-  vault(name: string): Vault;
-  /** Get a build binding */
-  build(name: string): Build;
-  /** Get an artifact registry binding */
-  artifactRegistry(name: string): ArtifactRegistry;
-  /** Get a function binding */
-  func(name: string): FunctionBinding;
-  /** Get a service account binding */
-  serviceAccount(name: string): ServiceAccount;
-}
-//#endregion
-//#region src/bindings/artifact-registry.d.ts
-/**
- * ArtifactRegistry binding for container repository management.
- *
- * @example
- * ```typescript
- * import { artifactRegistry } from "@alienplatform/bindings"
- *
- * const registry = artifactRegistry("my-registry")
- *
- * // Create a repository
- * const repo = await registry.createRepository("my-app")
- * console.log("Repository URI:", repo.uri)
- *
- * // Generate push credentials
- * const creds = await registry.generateCredentials("my-app", "push-pull")
- * console.log("Username:", creds.username)
- * ```
- */
-declare class ArtifactRegistry {
-  private readonly client;
-  private readonly bindingName;
-  constructor(channel: Channel, bindingName: string);
-  /**
-   * Create a repository.
-   *
-   * @param repoName - Name of the repository
-   * @returns Repository information
-   */
-  createRepository(repoName: string): Promise<RepositoryInfo>;
-  /**
-   * Get repository details.
-   *
-   * @param repoId - Repository ID
-   * @returns Repository information
-   */
-  getRepository(repoId: string): Promise<RepositoryInfo>;
-  /**
-   * Add cross-account access to a repository.
-   *
-   * @param repoId - Repository ID
-   * @param access - Cross-account access configuration
-   */
-  addCrossAccountAccess(repoId: string, access: CrossAccountAccess): Promise<void>;
-  /**
-   * Remove cross-account access from a repository.
-   *
-   * @param repoId - Repository ID
-   * @param access - Cross-account access configuration to remove
-   */
-  removeCrossAccountAccess(repoId: string, access: CrossAccountAccess): Promise<void>;
-  /**
-   * Get current cross-account access permissions for a repository.
-   *
-   * @param repoId - Repository ID
-   * @returns Current cross-account permissions
-   */
-  getCrossAccountAccess(repoId: string): Promise<CrossAccountPermissions>;
-  /**
-   * Generate credentials for repository access.
-   *
-   * @param repoId - Repository ID
-   * @param permissions - Permission level (pull or push-pull)
-   * @param ttlSeconds - Optional TTL in seconds
-   * @returns Repository credentials
-   */
-  generateCredentials(repoId: string, permissions: ArtifactRegistryPermissions, ttlSeconds?: number): Promise<ArtifactRegistryCredentials>;
-  /**
-   * Delete a repository.
-   *
-   * @param repoId - Repository ID
-   */
-  deleteRepository(repoId: string): Promise<void>;
-  private fromProtoResult;
-  private fromProtoCredentials;
-  private toProtoCrossAccountAccess;
-  private fromProtoCrossAccountAccess;
-  private fromProtoCrossAccountPermissions;
-  private computeServiceTypeToProto;
-  private protoToComputeServiceType;
-}
-//#endregion
-//#region src/events.d.ts
-/**
- * Cron/scheduled event with schedule info.
- * Extends ScheduledEvent with the schedule name.
- */
-interface CronEvent extends ScheduledEvent {
-  /** Schedule name */
-  scheduleName: string;
-}
-/**
- * Queue message event with queue context.
- */
-interface QueueMessageEvent<T = unknown> {
-  /** Message ID */
-  id: string;
-  /** Source queue name */
-  source: string;
-  /** Receipt handle for acknowledgment */
-  receiptHandle: string;
-  /** Message payload */
-  payload: T;
-  /** Delivery attempt count */
-  attemptCount: number;
-  /** Message timestamp */
-  timestamp: Date;
-}
-/**
- * Event handler registration.
- */
-
-//#endregion
-//#region src/context.d.ts
-/**
- * AlienContext provides the main entry point for accessing Alien bindings
- * and control plane functionality.
- *
- * @example
- * ```typescript
- * import { AlienContext } from "@alienplatform/bindings"
- *
- * // Create context from environment
- * const ctx = AlienContext.fromEnv()
- *
- * // Access bindings
- * const bucket = ctx.storage("my-bucket")
- * await bucket.put("hello.txt", "Hello, World!")
- *
- * // Register event handlers
- * ctx.onStorageEvent("uploads", async (event) => {
- *   console.log("File uploaded:", event.key)
- * })
- *
- * // Start the runtime
- * await ctx.run()
- * ```
- */
-declare class AlienContext implements AlienBindingsProvider {
-  private readonly channel;
-  private readonly instanceId;
-  private readonly bindingCache;
-  private eventLoop;
-  private waitUntilManager;
-  private constructor();
-  /**
-   * Create a context from environment variables.
-   *
-   * Reads the ALIEN_BINDINGS_GRPC_ADDRESS environment variable.
-   */
-  static fromEnv(): Promise<AlienContext>;
-  /**
-   * Create a context with explicit configuration.
-   */
-  static create(config: AlienBindingsConfig): Promise<AlienContext>;
-  /**
-   * Create a context for connecting to a remote agent.
-   *
-   * @param address - gRPC address of the remote agent
-   */
-  static forRemoteAgent(address: string): Promise<AlienContext>;
-  /**
-   * Get or create a cached binding instance.
-   */
-  private getBinding;
-  /**
-   * Get a storage binding.
-   *
-   * @param name - Binding name
-   * @returns Storage binding instance
-   */
-  storage(name: string): Storage;
-  /**
-   * Get a KV binding.
-   *
-   * @param name - Binding name
-   * @returns KV binding instance
-   */
-  kv(name: string): Kv;
-  /**
-   * Get a queue binding.
-   *
-   * @param name - Binding name
-   * @returns Queue binding instance
-   */
-  queue(name: string): Queue;
-  /**
-   * Get a vault binding.
-   *
-   * @param name - Binding name
-   * @returns Vault binding instance
-   */
-  vault(name: string): Vault;
-  /**
-   * Get a build binding.
-   *
-   * @param name - Binding name
-   * @returns Build binding instance
-   */
-  build(name: string): Build;
-  /**
-   * Get an artifact registry binding.
-   *
-   * @param name - Binding name
-   * @returns ArtifactRegistry binding instance
-   */
-  artifactRegistry(name: string): ArtifactRegistry;
-  /**
-   * Get a function binding.
-   *
-   * @param name - Binding name
-   * @returns Function binding instance
-   */
-  func(name: string): FunctionBinding;
-  /**
-   * Get a service account binding.
-   *
-   * @param name - Binding name
-   * @returns ServiceAccount binding instance
-   */
-  serviceAccount(name: string): ServiceAccount;
-  /**
-   * Register a storage event handler.
-   *
-   * @param bucket - Bucket name
-   * @param handler - Event handler
-   * @param options - Handler options
-   * @returns Unsubscribe function
-   */
-  onStorageEvent(bucket: string, handler: (event: StorageEvent$1) => Promise<void>, options?: {
-    prefix?: string;
-  }): () => void;
-  /**
-   * Register a cron event handler.
-   *
-   * @param schedule - Cron schedule expression
-   * @param handler - Event handler
-   * @returns Unsubscribe function
-   */
-  onCronEvent(schedule: string, handler: (event: CronEvent) => Promise<void>): () => void;
-  /**
-   * Register a queue message handler.
-   *
-   * @param queueName - Queue name
-   * @param handler - Message handler
-   * @returns Unsubscribe function
-   */
-  onQueueMessage<T = unknown>(queueName: string, handler: (message: QueueMessageEvent<T>) => Promise<void>): () => void;
-  /**
-   * Register an ARC command.
-   *
-   * @param name - Command name
-   * @param handler - Command handler that receives params and returns a result
-   */
-  command<TParams = unknown, TResult = unknown>(name: string, handler: (params: TParams) => Promise<TResult>): void;
-  /**
-   * Register an HTTP server with the control plane.
-   *
-   * @param port - Port the server is listening on
-   */
-  registerHttpServer(port: number): Promise<void>;
-  /**
-   * Register a background task.
-   *
-   * @param promise - The promise to track
-   */
-  waitUntil(promise: Promise<unknown>): void;
-  /**
-   * Start the Alien runtime.
-   *
-   * This initializes event handlers, registers with the control plane,
-   * and starts processing events.
-   */
-  run(): Promise<void>;
-  /**
-   * Stop the runtime gracefully.
-   */
-  shutdown(): Promise<void>;
-}
-//#endregion
-//#region src/global.d.ts
-/**
- * Get a storage binding.
- *
- * @param name - Binding name
- * @returns Storage binding instance
- *
- * @example
- * ```typescript
- * import { storage } from "@alienplatform/bindings"
- *
- * const bucket = await storage("my-bucket")
- * await bucket.put("hello.txt", "Hello, World!")
- * ```
- */
-declare function storage(name: string): Promise<Storage>;
-/**
- * Get a KV binding.
- *
- * @param name - Binding name
- * @returns KV binding instance
- *
- * @example
- * ```typescript
- * import { kv } from "@alienplatform/bindings"
- *
- * const cache = await kv("my-cache")
- * await cache.set("key", "value")
- * const value = await cache.getText("key")
- * ```
- */
-declare function kv(name: string): Promise<Kv>;
-/**
- * Get a queue binding.
- *
- * @param name - Binding name
- * @returns Queue binding instance
- *
- * @example
- * ```typescript
- * import { queue } from "@alienplatform/bindings"
- *
- * const tasks = await queue("task-queue")
- * await tasks.send("job-type", { jobId: "123" })
- * ```
- */
-declare function queue(name: string): Promise<Queue>;
-/**
- * Get a vault binding.
- *
- * @param name - Binding name
- * @returns Vault binding instance
- *
- * @example
- * ```typescript
- * import { vault } from "@alienplatform/bindings"
- *
- * const secrets = await vault("app-secrets")
- * const apiKey = await secrets.get("API_KEY")
- * ```
- */
-declare function vault(name: string): Promise<Vault>;
-/**
- * Get a build binding.
- *
- * @param name - Binding name
- * @returns Build binding instance
- *
- * @example
- * ```typescript
- * import { build } from "@alienplatform/bindings"
- *
- * const builder = await build("my-builder")
- * const execution = await builder.start({ script: "npm run build" })
- * ```
- */
-declare function build(name: string): Promise<Build>;
-/**
- * Get an artifact registry binding.
- *
- * @param name - Binding name
- * @returns ArtifactRegistry binding instance
- *
- * @example
- * ```typescript
- * import { artifactRegistry } from "@alienplatform/bindings"
- *
- * const registry = await artifactRegistry("my-registry")
- * const repo = await registry.createRepository("my-app")
- * ```
- */
-declare function artifactRegistry(name: string): Promise<ArtifactRegistry>;
-/**
- * Get a function binding.
- *
- * @param name - Binding name
- * @returns Function binding instance
- *
- * @example
- * ```typescript
- * import { func } from "@alienplatform/bindings"
- *
- * const processor = await func("image-processor")
- * const result = await processor.invokeJson("resize", { width: 800 })
- * ```
- */
-declare function func(name: string): Promise<FunctionBinding>;
-/**
- * Get a service account binding.
- *
- * @param name - Binding name
- * @returns ServiceAccount binding instance
- *
- * @example
- * ```typescript
- * import { serviceAccount } from "@alienplatform/bindings"
- *
- * const sa = await serviceAccount("deployment-account")
- * const info = await sa.getInfo()
- * ```
- */
-declare function serviceAccount(name: string): Promise<ServiceAccount>;
-/**
- * Register a storage event handler.
- *
- * @param bucket - Bucket name
- * @param handler - Event handler
- * @param options - Handler options
- * @returns Unsubscribe function
- *
- * @example
- * ```typescript
- * import { onStorageEvent } from "@alienplatform/bindings"
- *
- * onStorageEvent("uploads", async (event) => {
- *   console.log("File uploaded:", event.objectKey)
- * })
- * ```
- */
-declare function onStorageEvent(bucket: string, handler: (event: StorageEvent) => Promise<void>, options?: {
-  prefix?: string;
-}): () => void;
-/**
- * Register a cron event handler.
- *
- * @param schedule - Cron schedule expression
- * @param handler - Event handler
- * @returns Unsubscribe function
- *
- * @example
- * ```typescript
- * import { onCronEvent } from "@alienplatform/bindings"
- *
- * onCronEvent("0 * * * *", async (event) => {
- *   console.log("Hourly task running at:", event.timestamp)
- * })
- * ```
- */
-declare function onCronEvent(schedule: string, handler: (event: CronEvent) => Promise<void>): () => void;
-/**
- * Register a queue message handler.
- *
- * @param queueName - Queue name
- * @param handler - Message handler
- * @returns Unsubscribe function
- *
- * @example
- * ```typescript
- * import { onQueueMessage } from "@alienplatform/bindings"
- *
- * onQueueMessage("tasks", async (message) => {
- *   console.log("Processing:", message.payload)
- * })
- * ```
- */
-declare function onQueueMessage<T = unknown>(queueName: string, handler: (message: QueueMessageEvent<T>) => Promise<void>): () => void;
-/**
- * Register a CLI command.
- *
- * @param name - Command name
- * @param description - Command description
- * @param handler - Command handler
- *
- * @example
- * ```typescript
- * import { command } from "@alienplatform/bindings"
- *
- * command("migrate", "Run database migrations", async (args) => {
- *   await runMigrations()
- *   return 0
- * })
- * ```
- */
-declare function command(name: string, _description: string, handler: (args: string[]) => Promise<number>): void;
-/**
- * Register a background task to continue after the response.
- *
- * @param promise - The promise to track
- *
- * @example
- * ```typescript
- * import { waitUntil } from "@alienplatform/bindings"
- *
- * export default {
- *   async fetch(request: Request): Promise<Response> {
- *     waitUntil(sendAnalytics(request))
- *     return Response.json({ status: "ok" })
- *   }
- * }
- * ```
- */
-declare function waitUntil(promise: Promise<unknown>): void;
-//#endregion
-//#region src/errors.d.ts
-/**
- * Error thrown when the gRPC connection to the alien-runtime fails.
- */
-declare const GrpcConnectionError: {
-  metadata: _alienplatform_core0.AlienErrorMetadata<z.ZodObject<{
-    endpoint: z.ZodString;
-    reason: z.ZodString;
-  }, z.core.$strip>>;
-  contextSchema: z.ZodObject<{
-    endpoint: z.ZodString;
-    reason: z.ZodString;
-  }, z.core.$strip>;
-  create: (context: {
-    endpoint: string;
-    reason: string;
-  }) => _alienplatform_core0.AlienErrorDefinition<z.ZodObject<{
-    endpoint: z.ZodString;
-    reason: z.ZodString;
-  }, z.core.$strip>>;
-};
-/**
- * Error thrown when a gRPC call fails.
- */
-declare const GrpcCallError: {
-  metadata: _alienplatform_core0.AlienErrorMetadata<z.ZodObject<{
-    service: z.ZodString;
-    method: z.ZodString;
-    grpcCode: z.ZodString;
-    details: z.ZodString;
-  }, z.core.$strip>>;
-  contextSchema: z.ZodObject<{
-    service: z.ZodString;
-    method: z.ZodString;
-    grpcCode: z.ZodString;
-    details: z.ZodString;
-  }, z.core.$strip>;
-  create: (context: {
-    service: string;
-    method: string;
-    grpcCode: string;
-    details: string;
-  }) => _alienplatform_core0.AlienErrorDefinition<z.ZodObject<{
-    service: z.ZodString;
-    method: z.ZodString;
-    grpcCode: z.ZodString;
-    details: z.ZodString;
-  }, z.core.$strip>>;
-};
-/**
- * Error thrown when a binding is not found.
- */
-declare const BindingNotFoundError: {
-  metadata: _alienplatform_core0.AlienErrorMetadata<z.ZodObject<{
-    bindingName: z.ZodString;
-    bindingType: z.ZodString;
-  }, z.core.$strip>>;
-  contextSchema: z.ZodObject<{
-    bindingName: z.ZodString;
-    bindingType: z.ZodString;
-  }, z.core.$strip>;
-  create: (context: {
-    bindingName: string;
-    bindingType: string;
-  }) => _alienplatform_core0.AlienErrorDefinition<z.ZodObject<{
-    bindingName: z.ZodString;
-    bindingType: z.ZodString;
-  }, z.core.$strip>>;
-};
-/**
- * Error thrown when the AlienContext is not initialized.
- */
-declare const ContextNotInitializedError: {
-  metadata: _alienplatform_core0.AlienErrorMetadata<z.ZodObject<{
-    operation: z.ZodString;
-  }, z.core.$strip>>;
-  contextSchema: z.ZodObject<{
-    operation: z.ZodString;
-  }, z.core.$strip>;
-  create: (context: {
-    operation: string;
-  }) => _alienplatform_core0.AlienErrorDefinition<z.ZodObject<{
-    operation: z.ZodString;
-  }, z.core.$strip>>;
-};
-/**
- * Error thrown when a required environment variable is missing.
- */
-declare const MissingEnvVarError: {
-  metadata: _alienplatform_core0.AlienErrorMetadata<z.ZodObject<{
-    variable: z.ZodString;
-    description: z.ZodString;
-  }, z.core.$strip>>;
-  contextSchema: z.ZodObject<{
-    variable: z.ZodString;
-    description: z.ZodString;
-  }, z.core.$strip>;
-  create: (context: {
-    variable: string;
-    description: string;
-  }) => _alienplatform_core0.AlienErrorDefinition<z.ZodObject<{
-    variable: z.ZodString;
-    description: z.ZodString;
-  }, z.core.$strip>>;
-};
-/**
- * Error thrown when a storage object is not found.
- */
-declare const StorageObjectNotFoundError: {
-  metadata: _alienplatform_core0.AlienErrorMetadata<z.ZodObject<{
-    bindingName: z.ZodString;
-    path: z.ZodString;
-  }, z.core.$strip>>;
-  contextSchema: z.ZodObject<{
-    bindingName: z.ZodString;
-    path: z.ZodString;
-  }, z.core.$strip>;
-  create: (context: {
-    bindingName: string;
-    path: string;
-  }) => _alienplatform_core0.AlienErrorDefinition<z.ZodObject<{
-    bindingName: z.ZodString;
-    path: z.ZodString;
-  }, z.core.$strip>>;
-};
-/**
- * Error thrown when a storage precondition fails.
- */
-declare const StoragePreconditionError: {
-  metadata: _alienplatform_core0.AlienErrorMetadata<z.ZodObject<{
-    bindingName: z.ZodString;
-    path: z.ZodString;
-    condition: z.ZodString;
-  }, z.core.$strip>>;
-  contextSchema: z.ZodObject<{
-    bindingName: z.ZodString;
-    path: z.ZodString;
-    condition: z.ZodString;
-  }, z.core.$strip>;
-  create: (context: {
-    bindingName: string;
-    path: string;
-    condition: string;
-  }) => _alienplatform_core0.AlienErrorDefinition<z.ZodObject<{
-    bindingName: z.ZodString;
-    path: z.ZodString;
-    condition: z.ZodString;
-  }, z.core.$strip>>;
-};
-/**
- * Error thrown when a storage object already exists (for create mode).
- */
-declare const StorageObjectExistsError: {
-  metadata: _alienplatform_core0.AlienErrorMetadata<z.ZodObject<{
-    bindingName: z.ZodString;
-    path: z.ZodString;
-  }, z.core.$strip>>;
-  contextSchema: z.ZodObject<{
-    bindingName: z.ZodString;
-    path: z.ZodString;
-  }, z.core.$strip>;
-  create: (context: {
-    bindingName: string;
-    path: string;
-  }) => _alienplatform_core0.AlienErrorDefinition<z.ZodObject<{
-    bindingName: z.ZodString;
-    path: z.ZodString;
-  }, z.core.$strip>>;
-};
-/**
- * Error thrown when a KV key is not found.
- */
-declare const KvKeyNotFoundError: {
-  metadata: _alienplatform_core0.AlienErrorMetadata<z.ZodObject<{
-    bindingName: z.ZodString;
-    key: z.ZodString;
-  }, z.core.$strip>>;
-  contextSchema: z.ZodObject<{
-    bindingName: z.ZodString;
-    key: z.ZodString;
-  }, z.core.$strip>;
-  create: (context: {
-    bindingName: string;
-    key: string;
-  }) => _alienplatform_core0.AlienErrorDefinition<z.ZodObject<{
-    bindingName: z.ZodString;
-    key: z.ZodString;
-  }, z.core.$strip>>;
-};
-/**
- * Error thrown when a KV key is invalid.
- */
-declare const KvInvalidKeyError: {
-  metadata: _alienplatform_core0.AlienErrorMetadata<z.ZodObject<{
-    key: z.ZodString;
-    reason: z.ZodString;
-  }, z.core.$strip>>;
-  contextSchema: z.ZodObject<{
-    key: z.ZodString;
-    reason: z.ZodString;
-  }, z.core.$strip>;
-  create: (context: {
-    key: string;
-    reason: string;
-  }) => _alienplatform_core0.AlienErrorDefinition<z.ZodObject<{
-    key: z.ZodString;
-    reason: z.ZodString;
-  }, z.core.$strip>>;
-};
-/**
- * Error thrown when a KV value is invalid.
- */
-declare const KvInvalidValueError: {
-  metadata: _alienplatform_core0.AlienErrorMetadata<z.ZodObject<{
-    reason: z.ZodString;
-  }, z.core.$strip>>;
-  contextSchema: z.ZodObject<{
-    reason: z.ZodString;
-  }, z.core.$strip>;
-  create: (context: {
-    reason: string;
-  }) => _alienplatform_core0.AlienErrorDefinition<z.ZodObject<{
-    reason: z.ZodString;
-  }, z.core.$strip>>;
-};
-/**
- * Error thrown when a secret is not found.
- */
-declare const SecretNotFoundError: {
-  metadata: _alienplatform_core0.AlienErrorMetadata<z.ZodObject<{
-    bindingName: z.ZodString;
-    secretName: z.ZodString;
-  }, z.core.$strip>>;
-  contextSchema: z.ZodObject<{
-    bindingName: z.ZodString;
-    secretName: z.ZodString;
-  }, z.core.$strip>;
-  create: (context: {
-    bindingName: string;
-    secretName: string;
-  }) => _alienplatform_core0.AlienErrorDefinition<z.ZodObject<{
-    bindingName: z.ZodString;
-    secretName: z.ZodString;
-  }, z.core.$strip>>;
-};
-/**
- * Error thrown when a queue operation fails.
- */
-declare const QueueOperationError: {
-  metadata: _alienplatform_core0.AlienErrorMetadata<z.ZodObject<{
-    bindingName: z.ZodString;
-    queue: z.ZodString;
-    operation: z.ZodString;
-    reason: z.ZodString;
-  }, z.core.$strip>>;
-  contextSchema: z.ZodObject<{
-    bindingName: z.ZodString;
-    queue: z.ZodString;
-    operation: z.ZodString;
-    reason: z.ZodString;
-  }, z.core.$strip>;
-  create: (context: {
-    bindingName: string;
-    queue: string;
-    operation: string;
-    reason: string;
-  }) => _alienplatform_core0.AlienErrorDefinition<z.ZodObject<{
-    bindingName: z.ZodString;
-    queue: z.ZodString;
-    operation: z.ZodString;
-    reason: z.ZodString;
-  }, z.core.$strip>>;
-};
-/**
- * Error thrown when an event handler is already registered.
- */
-declare const EventHandlerAlreadyRegisteredError: {
-  metadata: _alienplatform_core0.AlienErrorMetadata<z.ZodObject<{
-    handlerType: z.ZodString;
-    resourceName: z.ZodString;
-  }, z.core.$strip>>;
-  contextSchema: z.ZodObject<{
-    handlerType: z.ZodString;
-    resourceName: z.ZodString;
-  }, z.core.$strip>;
-  create: (context: {
-    handlerType: string;
-    resourceName: string;
-  }) => _alienplatform_core0.AlienErrorDefinition<z.ZodObject<{
-    handlerType: z.ZodString;
-    resourceName: z.ZodString;
-  }, z.core.$strip>>;
-};
-/**
- * Error thrown when a command is already registered.
- */
-declare const CommandAlreadyRegisteredError: {
-  metadata: _alienplatform_core0.AlienErrorMetadata<z.ZodObject<{
-    commandName: z.ZodString;
-  }, z.core.$strip>>;
-  contextSchema: z.ZodObject<{
-    commandName: z.ZodString;
-  }, z.core.$strip>;
-  create: (context: {
-    commandName: string;
-  }) => _alienplatform_core0.AlienErrorDefinition<z.ZodObject<{
-    commandName: z.ZodString;
-  }, z.core.$strip>>;
-};
-/**
- * Error thrown when the binding configuration is invalid.
- */
-declare const InvalidBindingConfigError: {
-  metadata: _alienplatform_core0.AlienErrorMetadata<z.ZodObject<{
-    message: z.ZodString;
-    suggestion: z.ZodOptional<z.ZodString>;
-  }, z.core.$strip>>;
-  contextSchema: z.ZodObject<{
-    message: z.ZodString;
-    suggestion: z.ZodOptional<z.ZodString>;
-  }, z.core.$strip>;
-  create: (context: {
-    message: string;
-    suggestion?: string | undefined;
-  }) => _alienplatform_core0.AlienErrorDefinition<z.ZodObject<{
-    message: z.ZodString;
-    suggestion: z.ZodOptional<z.ZodString>;
-  }, z.core.$strip>>;
-};
-//#endregion
-//#region src/commands.d.ts
-/**
- * Command handling for Alien bindings.
- *
- * Provides ARC command registration and execution.
- */
-/**
- * Command definition.
- */
-interface CommandDefinition {
-  /** Command name */
-  name: string;
-  /** Handler function that receives params and returns a result */
-  handler: (params: unknown) => Promise<unknown>;
-}
-/**
- * Register an ARC command.
- *
- * @param name - Command name
- * @param handler - Command handler function that receives params and returns a result
- *
- * @example
- * ```typescript
- * import { command } from "@alienplatform/bindings"
- *
- * command("echo", async ({ message }: { message: string }) => {
- *   return {
- *     message,
- *     timestamp: new Date().toISOString(),
- *   }
- * })
- *
- * command("process-data", async ({ data }: { data: string[] }) => {
- *   const result = await processData(data)
- *   return { processed: result.length }
- * })
- * ```
- */
-
-/**
- * Get all registered commands.
- *
- * @internal
- */
-declare function getCommands(): Map<string, CommandDefinition>;
-/**
- * Execute an ARC command by name.
- *
- * @param name - Command name to execute
- * @param params - Command parameters
- * @returns Command result
- *
- * @internal
- */
-declare function runCommand(name: string, params: unknown): Promise<unknown>;
-//#endregion
-export { type AlienBindingsConfig, type AlienBindingsProvider, AlienContext, ArtifactRegistry, type ArtifactRegistryCredentials, type ArtifactRegistryPermissions, type AwsCrossAccountAccess, type AwsServiceAccountInfo, type AzureServiceAccountInfo, BindingNotFoundError, Build, type BuildExecution, type BuildStartConfig, CommandAlreadyRegisteredError, type CommandDefinition, type ComputeServiceType, ContextNotInitializedError, type CronEvent, type CrossAccountAccess, type CrossAccountPermissions, EventHandlerAlreadyRegisteredError, FunctionBinding, type FunctionInvokeRequest, type FunctionInvokeResponse, type GcpCrossAccountAccess, type GcpServiceAccountInfo, GrpcCallError, GrpcConnectionError, type ImpersonationRequest, InvalidBindingConfigError, Kv, KvInvalidKeyError, KvInvalidValueError, KvKeyNotFoundError, type KvPutOptions, type KvScanResult, MissingEnvVarError, Queue, type QueueMessage, type QueueMessageEvent, QueueOperationError, type ReceivedQueueMessage, type RepositoryInfo, type ScheduledEvent, SecretNotFoundError, ServiceAccount, type ServiceAccountInfo, type SignedUrlOptions, type SignedUrlResult, Storage, type StorageEvent, type StorageEventType, type StorageGetOptions, type StorageGetResult, type StorageListResult, StorageObjectExistsError, type StorageObjectMeta, StorageObjectNotFoundError, StoragePreconditionError, type StoragePutOptions, Vault, artifactRegistry, build, command, func, getCommands, kv, onCronEvent, onQueueMessage, onStorageEvent, queue, runCommand, serviceAccount, storage, vault, waitUntil };
+ * `@alienplatform/bindings` — direct TypeScript bindings for Alien storage, kv,
+ * queue, and vault, backed by an in-process napi-rs addon over the Rust
+ * `alien-bindings` crate.
+ *
+ * Constructing a factory (`storage("x")`, `kv("y")`, …) does no I/O and needs no
+ * addon; the native module loads on the first operation. The first operation
+ * against a binding with no `ALIEN_<NAME>_BINDING` in the environment throws
+ * {@link BindingNotConfiguredError}.
+ */
+/** Resolve the storage binding named `name`. */
+export declare const storage: (name: string) => import("./types.js").Storage;
+/** Resolve the key-value binding named `name`. */
+export declare const kv: (name: string) => import("./types.js").Kv;
+/** Resolve the queue binding named `name`. */
+export declare const queue: (name: string) => import("./types.js").Queue;
+/** Resolve the vault binding named `name`. */
+export declare const vault: (name: string) => import("./types.js").Vault;
+export { AlienError, BindingNotConfiguredError, defineError } from "./errors.js";
+export type { Kv, KvScanItem, KvScanResult, KvSetOptions, ObjectMeta, PresignedRequest, Queue, QueueMessage, SignedUrlMethod, SignedUrlOptions, Storage, Vault, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map