@alienplatform/sdk 1.3.3

package/.turbo/turbo-build.log

@@ -0,0 +1,27 @@
+
+> @alienplatform/sdk@1.3.3 build /home/runner/work/alien/alien/packages/sdk
+> tsdown && tsc --emitDeclarationOnly
+
+ℹ tsdown v0.13.5 powered by rolldown v1.0.0-rc.15
+ℹ Using tsdown config: /home/runner/work/alien/alien/packages/sdk/tsdown.config.ts
+ℹ entry: src/index.ts, src/commands/index.ts
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ Cleaning 80 files
+Warning: Invalid input options (1 issue found)
+- For the "define". Invalid key: Expected never but received "define". 
+ℹ dist/index.js           1333.83 kB
+ℹ dist/commands/index.js    12.03 kB │ gzip:  3.11 kB
+ℹ dist/dist.js             226.66 kB │ gzip: 45.87 kB
+ℹ 3 files, total: 1572.52 kB
+../../node_modules/.pnpm/@protobufjs+inquire@1.1.0/node_modules/@protobufjs/inquire/index.js (12:18) [EVAL] Warning: Use of direct `eval` function is strongly discouraged as it poses security risks and may cause issues with minification.
+    ╭─[ ../../node_modules/.pnpm/@protobufjs+inquire@1.1.0/node_modules/@protobufjs/inquire/index.js:12:19 ]
+    │
+ 12 │         var mod = eval("quire".replace(/^/,"re"))(moduleName); // eslint-disable-line no-eval
+    │                   ──┬─  
+    │                     ╰─── Use of direct `eval` here.
+    │ 
+    │ Help: Consider using indirect eval. For more information, check the documentation: https://rolldown.rs/guide/troubleshooting#avoiding-direct-eval
+────╯
+
+✔ Build complete in 98ms

package/AGENTS.md

@@ -0,0 +1,70 @@
+# @alienplatform/sdk
+
+TypeScript SDK for Alien bindings. Provides gRPC clients for Storage, KV, Queue, Vault, Build, ArtifactRegistry, Function, and ServiceAccount.
+
+## Commands
+
+```bash
+pnpm generate  # Regenerate TypeScript from Proto
+pnpm build     # Build the package
+pnpm test:ts   # Type check
+```
+
+## Type Architecture
+
+```
+┌─────────────────┐
+│   Rust Types    │  ← Source of truth (alien-core)
+└────────┬────────┘
+         │
+    ┌────┴────┐
+    ▼         ▼
+┌───────┐  ┌───────────┐
+│ Proto │  │ OpenAPI   │
+│ (wire)│  │ (schema)  │
+└───┬───┘  └─────┬─────┘
+    │            │
+    ▼            ▼
+┌─────────┐  ┌────────────┐
+│ts-proto │  │ Kubb/Zod   │
+│(internal)│  │(@alien/core)│ ← Public API types
+└────┬────┘  └──────┬─────┘
+     │              │
+     └──────┬───────┘
+            ▼
+   Transform proto → core types
+   in binding implementations
+```
+
+**Key principle:** Domain types (`BuildStatus`, `StorageEvent`, etc.) come from `@alienplatform/core`. Proto types are internal - used only for gRPC wire format. Bindings transform proto ↔ public types.
+
+## Package Structure
+
+```
+src/
+├── generated/        # Auto-generated from Proto (DO NOT EDIT)
+├── bindings/         # Individual binding clients (see bindings/AGENTS.md)
+├── context.ts        # AlienContext - main entry point
+├── events.ts         # Event handlers (storage, cron, queue)
+├── types.ts          # SDK-specific types (options, results)
+└── index.ts          # Public exports
+```
+
+## Proto Definitions
+
+Protos live in `crates/alien-bindings/proto/`. When modified:
+
+1. Run `pnpm generate` in this package
+2. Update binding implementations to match new proto types
+3. Verify TypeScript matches Rust behavior (see `src/bindings/AGENTS.md`)
+
+## Adding New Bindings
+
+1. Add proto in `crates/alien-bindings/proto/`
+2. Run `pnpm generate`
+3. Create binding in `src/bindings/<name>.ts`
+4. Add types to `src/types.ts` (public API) 
+5. Export from `src/bindings/index.ts` and `src/index.ts`
+6. Add accessor method to `AlienContext`
+
+See `src/bindings/AGENTS.md` for implementation guidelines.

package/LICENSE.md

@@ -0,0 +1,105 @@
+# Functional Source License, Version 1.1, Apache 2.0 Future License
+
+## Abbreviation
+
+FSL-1.1-Apache-2.0
+
+## Notice
+
+Copyright 2026 Alien Software, Inc.
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
+EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the Apache License, Version 2.0 that is effective on the second anniversary of
+the date we make the Software available. On or after that date, you may use the
+Software under the Apache License, Version 2.0, in which case the following
+will apply:
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+this file except in compliance with the License.
+
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed
+under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+CONDITIONS OF ANY KIND, either express or implied. See the License for the
+specific language governing permissions and limitations under the License.

package/dist/bindings/artifact-registry.d.ts

@@ -0,0 +1,88 @@
+/**
+ * ArtifactRegistry binding implementation.
+ *
+ * Provides container image repository management.
+ */
+import { type Channel } from "nice-grpc";
+import type { ArtifactRegistryCredentials, ArtifactRegistryPermissions, CrossAccountAccess, CrossAccountPermissions, RepositoryInfo } from "../types.js";
+/**
+ * ArtifactRegistry binding for container repository management.
+ *
+ * @example
+ * ```typescript
+ * import { artifactRegistry } from "@alienplatform/sdk"
+ *
+ * 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)
+ * ```
+ */
+export 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;
+}
+//# sourceMappingURL=artifact-registry.d.ts.map

package/dist/bindings/artifact-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-registry.d.ts","sourceRoot":"","sources":["../../src/bindings/artifact-registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAgB,MAAM,WAAW,CAAA;AAYtD,OAAO,KAAK,EACV,2BAA2B,EAC3B,2BAA2B,EAE3B,kBAAkB,EAClB,uBAAuB,EACvB,cAAc,EACf,MAAM,aAAa,CAAA;AAQpB;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;gBAExB,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM;IAKjD;;;;;OAKG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAejE;;;;;OAKG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAe5D;;;;;OAKG;IACG,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAetF;;;;;OAKG;IACG,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAezF;;;;;OAKG;IACG,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAe7E;;;;;;;OAOG;IACG,mBAAmB,CACvB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,2BAA2B,EACxC,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,2BAA2B,CAAC;IAiBvC;;;;OAIG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBrD,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,oBAAoB;IAQ5B,OAAO,CAAC,yBAAyB;IA0BjC,OAAO,CAAC,2BAA2B;IA6BnC,OAAO,CAAC,gCAAgC;IAYxC,OAAO,CAAC,yBAAyB;IASjC,OAAO,CAAC,yBAAyB;CAQlC"}

package/dist/bindings/build.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Build binding implementation.
+ *
+ * Provides build execution capabilities.
+ */
+import { type Channel } from "nice-grpc";
+import type { BuildExecution, BuildStartConfig } from "../types.js";
+/**
+ * Build binding for executing build operations.
+ *
+ * @example
+ * ```typescript
+ * import { build } from "@alienplatform/sdk"
+ *
+ * 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)
+ * ```
+ */
+export 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;
+}
+//# sourceMappingURL=build.d.ts.map

package/dist/bindings/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/bindings/build.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,KAAK,OAAO,EAAgB,MAAM,WAAW,CAAA;AAUtD,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAqBnE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,KAAK;IAChB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;gBAExB,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM;IAKjD;;;;;OAKG;IACG,KAAK,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC;IAiB9D;;;;;OAKG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAezD;;;;OAIG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc1C;;;;;;OAMG;IACG,iBAAiB,CACrB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GACxD,OAAO,CAAC,cAAc,CAAC;IAyB1B,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,kBAAkB;CAQ3B"}

package/dist/bindings/function.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Function binding implementation.
+ *
+ * Provides direct function-to-function invocation.
+ */
+import { type Channel } from "nice-grpc";
+import type { FunctionInvokeRequest, FunctionInvokeResponse } from "../types.js";
+/**
+ * Function binding for direct function invocation.
+ *
+ * @example
+ * ```typescript
+ * import { func } from "@alienplatform/sdk"
+ *
+ * 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()
+ * ```
+ */
+export 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>;
+}
+//# sourceMappingURL=function.d.ts.map

package/dist/bindings/function.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"function.d.ts","sourceRoot":"","sources":["../../src/bindings/function.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAgB,MAAM,WAAW,CAAA;AAMtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAEhF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;gBAExB,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM;IAKjD;;;;;OAKG;IACG,MAAM,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAwB7E;;;;;;;OAOG;IACG,UAAU,CAAC,QAAQ,EAAE,SAAS,GAAG,OAAO,EAC5C,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,QAAQ,EACd,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAChC,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB,GACA,OAAO,CAAC,SAAS,CAAC;IAsBrB;;;;;;;OAOG;IACG,GAAG,CAAC,SAAS,GAAG,OAAO,EAC3B,cAAc,EAAE,MAAM,EACtB,IAAI,SAAM,EACV,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAChC,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB,GACA,OAAO,CAAC,SAAS,CAAC;IAkBrB;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;CAa5C"}

package/dist/bindings/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Binding exports.
+ */
+export { Storage } from "./storage.js";
+export { Kv } from "./kv.js";
+export { Queue } from "./queue.js";
+export { Vault } from "./vault.js";
+export { Build } from "./build.js";
+export { ArtifactRegistry } from "./artifact-registry.js";
+export { FunctionBinding } from "./function.js";
+export { ServiceAccount } from "./service-account.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bindings/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/bindings/kv.d.ts

@@ -0,0 +1,113 @@
+/**
+ * KV binding implementation.
+ *
+ * Provides key-value storage operations with TTL support.
+ */
+import { type Channel } from "nice-grpc";
+import type { KvPutOptions, KvScanResult } from "../types.js";
+/**
+ * KV binding for key-value storage operations.
+ *
+ * @example
+ * ```typescript
+ * import { kv } from "@alienplatform/sdk"
+ *
+ * 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)
+ * }
+ * ```
+ */
+export 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>;
+}
+//# sourceMappingURL=kv.d.ts.map

package/dist/bindings/kv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kv.d.ts","sourceRoot":"","sources":["../../src/bindings/kv.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAgB,MAAM,WAAW,CAAA;AAMtD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,EAAE;IACb,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;gBAExB,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM;IAKjD;;;;;OAKG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAevD;;;;;OAKG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAKvD;;;;;OAKG;IACG,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAK/D;;;;;;;OAOG;IACG,GAAG,CACP,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,EACnC,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,OAAO,CAAC;IAgCnB;;;;OAIG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAcxC;;;;;OAKG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAe3C;;;;;;;;;;;;;;OAcG;IACI,IAAI,CACT,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3B,aAAa,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,CAAC;IAcpD;;;;;;;OAOG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAsBvF"}

package/dist/bindings/queue.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Queue binding implementation.
+ *
+ * Provides message queue operations for async task processing.
+ */
+import { type Channel } from "nice-grpc";
+import type { ReceivedQueueMessage } from "../types.js";
+/**
+ * Queue binding for message queue operations.
+ *
+ * @example
+ * ```typescript
+ * import { queue } from "@alienplatform/sdk"
+ *
+ * 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)
+ * }
+ * ```
+ */
+export 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;
+}
+//# sourceMappingURL=queue.d.ts.map

package/dist/bindings/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/bindings/queue.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAgB,MAAM,WAAW,CAAA;AAQtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAEvD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,KAAK;IAChB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;gBAExB,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM;IAKjD;;;;;OAKG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB9D;;;;;OAKG;IACG,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe9D;;;;;;OAMG;IACG,OAAO,CAAC,CAAC,GAAG,OAAO,EACvB,SAAS,EAAE,MAAM,EACjB,WAAW,SAAI,GACd,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC;IAgBrC;;;;;OAKG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAelE;;;;;;;;;;;;;OAaG;IACG,OAAO,CAAC,CAAC,GAAG,OAAO,EACvB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,EACtC,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GACjC,OAAO,CAAC,IAAI,CAAC;IAahB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,gBAAgB;CAgBzB"}