@alienplatform/sdk 1.14.1 → 2.0.1

package/dist/worker-runtime/registry.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Worker handler registries — the facade's protocol-only surface.
+ *
+ * `command`, `onStorageEvent`, `onCronEvent`, `onQueueMessage`, and `waitUntil`
+ * register into these in-memory maps; {@link runWorker} (in `./index.ts`) reads
+ * them to register handlers with the runtime and dispatch tasks. There is no
+ * gRPC here — this module is what the facade root re-exports, so the facade
+ * bundle stays free of Worker-protocol dependencies.
+ *
+ * The `@alienplatform/sdk` root (`dist/index.js`) and the
+ * `@alienplatform/sdk/worker-runtime` subpath (`dist/worker-runtime/index.js`)
+ * are separate entry bundles. A user's app registers handlers by importing the
+ * root; the generated bootstrap drives them by importing the subpath. For those
+ * two bundles to observe the SAME registration state, the maps are stored on
+ * `globalThis` under a shared `Symbol.for` key rather than as ordinary
+ * module-level state (which would be duplicated per bundle).
+ */
+import type { QueueMessage, ScheduledEvent, StorageEvent, StorageEventType } from "@alienplatform/core";
+export type { StorageEvent, StorageEventType, ScheduledEvent, QueueMessage };
+/**
+ * Cron/scheduled event with schedule info.
+ */
+export interface CronEvent extends ScheduledEvent {
+    /** Schedule name */
+    scheduleName: string;
+}
+/**
+ * Queue message event with queue context.
+ */
+export 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;
+    /** Platform-specific message attributes */
+    attributes?: {
+        [key: string]: string;
+    };
+}
+/**
+ * Per-invocation metadata passed to a Worker command handler alongside its
+ * params. Mirrors the pull receiver's context: `attempt > 1` means
+ * redelivery (at-least-once semantics), and `deadline` bounds execution.
+ */
+export interface WorkerCommandContext {
+    /** Unique command identifier. */
+    commandId: string;
+    /** Delivery attempt, starting at 1. */
+    attempt: number;
+    /** Deadline for completion, when the sender set one. */
+    deadline?: Date;
+}
+/**
+ * Command definition.
+ */
+export interface CommandDefinition {
+    /** Command name */
+    name: string;
+    /** Handler function that receives params and returns a result */
+    handler: (params: unknown, context: WorkerCommandContext) => Promise<unknown>;
+}
+/**
+ * Event handler registration.
+ */
+export interface EventRegistration {
+    /** Handler ID */
+    id: string;
+    /** Event type */
+    type: "storage" | "cron" | "queue";
+    /** Source filter (bucket name, queue name, etc.) */
+    source: string;
+    /** Optional prefix filter (for storage events) */
+    prefix?: string;
+}
+/** A single registered event handler. */
+export interface EventHandlerEntry {
+    registration: EventRegistration;
+    handler: (event: unknown) => Promise<void>;
+}
+/**
+ * A tracked `waitUntil` background task.
+ */
+export interface TaskTracker {
+    /** Unique task ID */
+    id: string;
+    /** Task promise */
+    promise: Promise<unknown>;
+    /** When the task was registered */
+    registeredAt: Date;
+    /** Whether the task has completed */
+    completed: boolean;
+    /** Error if the task failed */
+    error?: Error;
+}
+/**
+ * Register a command handler.
+ *
+ * The handler receives the decoded params and, optionally, a
+ * {@link WorkerCommandContext} with `commandId`, `attempt`, and `deadline` —
+ * use `attempt` to make redeliveries idempotent (at-least-once semantics).
+ *
+ * @param name - Command name
+ * @param handler - Handler that receives params (and optionally the context)
+ *
+ * @example
+ * ```typescript
+ * import { command } from "@alienplatform/sdk"
+ *
+ * command("echo", async ({ message }: { message: string }, { attempt }) => {
+ *   return { message, attempt, timestamp: new Date().toISOString() }
+ * })
+ * ```
+ */
+export declare function command<TParams = unknown, TResult = unknown>(name: string, handler: (params: TParams, context: WorkerCommandContext) => Promise<TResult>): void;
+/** Get all registered commands. @internal */
+export declare function getCommands(): Map<string, CommandDefinition>;
+/** Execute a registered command by name. @internal */
+export declare function runCommand(name: string, params: unknown, context: WorkerCommandContext): Promise<unknown>;
+/**
+ * Register a storage event handler.
+ *
+ * @param bucket - Bucket name (or `"*"` for all buckets)
+ * @param handler - Handler function for storage events
+ * @param options - Handler options
+ * @returns Unsubscribe function
+ */
+export declare function onStorageEvent(bucket: string, handler: (event: StorageEvent) => Promise<void>, options?: {
+    prefix?: string;
+}): () => void;
+/**
+ * Register a cron/scheduled event handler.
+ *
+ * @param scheduleName - Schedule name (or `"*"` for all schedules)
+ * @param handler - Handler function for scheduled events
+ * @returns Unsubscribe function
+ */
+export declare function onCronEvent(scheduleName: string, handler: (event: CronEvent) => Promise<void>): () => void;
+/**
+ * Register a queue message handler.
+ *
+ * @param queueName - Queue name (or `"*"` for all queues)
+ * @param handler - Handler function for queue messages
+ * @returns Unsubscribe function
+ */
+export declare function onQueueMessage<T = unknown>(queueName: string, handler: (message: QueueMessageEvent<T>) => Promise<void>): () => void;
+/** Get all registered event handlers. @internal */
+export declare function getEventHandlers(): Map<string, EventHandlerEntry>;
+/**
+ * Register a background task to continue after the response.
+ *
+ * The runtime waits for all registered tasks to complete before shutting down.
+ * This is the protocol-only registrar: it tracks the promise and (inside a
+ * running Worker) notifies the runtime via the installed hook. The gRPC drain
+ * coordination lives in {@link runWorker}.
+ *
+ * @param promise - The promise to track
+ */
+export declare function waitUntil(promise: Promise<unknown>): void;
+/** Install the runtime's task-registered hook. @internal */
+export declare function setOnTaskRegistered(hook: ((tracker: TaskTracker) => void) | undefined): void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/worker-runtime/registry.d.ts.map

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

package/dist/worker-runtime/service-definitions.d.ts

@@ -0,0 +1,12 @@
+import { type WorkerProtocolGeneration } from "./channel.js";
+import { ControlServiceDefinition } from "./generated/control.js";
+import { WaitUntilServiceDefinition } from "./generated/wait_until.js";
+export type ControlService = Omit<typeof ControlServiceDefinition, "fullName"> & {
+    readonly fullName: string;
+};
+export type WaitUntilService = Omit<typeof WaitUntilServiceDefinition, "fullName"> & {
+    readonly fullName: string;
+};
+export declare function getControlServiceDefinition(generation?: WorkerProtocolGeneration): ControlService;
+export declare function getWaitUntilServiceDefinition(generation?: WorkerProtocolGeneration): WaitUntilService;
+//# sourceMappingURL=service-definitions.d.ts.map

package/dist/worker-runtime/service-definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-definitions.d.ts","sourceRoot":"","sources":["../../src/worker-runtime/service-definitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,wBAAwB,EAAyB,MAAM,cAAc,CAAA;AACnF,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAA;AACjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AAEtE,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,wBAAwB,EAAE,UAAU,CAAC,GAAG;IAC/E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,0BAA0B,EAAE,UAAU,CAAC,GAAG;IACnF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B,CAAA;AAYD,wBAAgB,2BAA2B,CACzC,UAAU,GAAE,wBAA6D,GACxE,cAAc,CAEhB;AAED,wBAAgB,6BAA6B,CAC3C,UAAU,GAAE,wBAA6D,GACxE,gBAAgB,CAElB"}

package/dist/worker-runtime/wait-until-manager.d.ts

@@ -0,0 +1,34 @@
+/**
+ * WaitUntil coordination.
+ *
+ * The facade's {@link waitUntil} registrar (in `./registry.ts`) tracks promises
+ * with no gRPC. This manager is the runtime half: it notifies the runtime each
+ * time a background task is registered.
+ *
+ * Graceful drain-on-shutdown (waiting for tracked tasks to settle before the
+ * process exits) is a planned future feature; the runtime-side drain protocol
+ * (WaitForDrainSignal/NotifyDrainComplete) exists in the generated client but
+ * is not yet wired here.
+ */
+import { type Channel } from "nice-grpc";
+import type { getWaitUntilServiceDefinition } from "./service-definitions.js";
+/**
+ * WaitUntil manager for coordinating background tasks with the runtime.
+ *
+ * @internal
+ */
+export declare class WaitUntilManager {
+    private readonly client;
+    private readonly applicationId;
+    constructor(channel: Channel, applicationId: string, service: ReturnType<typeof getWaitUntilServiceDefinition>);
+    /**
+     * Install this manager as the registry's task-registered hook so each
+     * `waitUntil` call notifies the runtime that a background task exists.
+     */
+    install(): void;
+    /**
+     * Notify the runtime that a new background task was registered.
+     */
+    notifyTaskRegistered(description?: string): Promise<void>;
+}
+//# sourceMappingURL=wait-until-manager.d.ts.map

package/dist/worker-runtime/wait-until-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-until-manager.d.ts","sourceRoot":"","sources":["../../src/worker-runtime/wait-until-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAgB,MAAM,WAAW,CAAA;AAItD,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAA;AAE7E;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAQ;gBAGpC,OAAO,EAAE,OAAO,EAChB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,UAAU,CAAC,OAAO,6BAA6B,CAAC;IAM3D;;;OAGG;IACH,OAAO,IAAI,IAAI;IAQf;;OAEG;IACG,oBAAoB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAQhE"}

package/package.json

@@ -1,29 +1,35 @@
 {
   "name": "@alienplatform/sdk",
-  "version": "1.14.1",
+  "version": "2.0.1",
   "type": "module",
+  "files": [
+    "dist"
+  ],
   "exports": {
     ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./worker-runtime": {
+      "types": "./dist/worker-runtime/index.d.ts",
+      "import": "./dist/worker-runtime/index.js"
     },
-    "./commands": {
-      "import": "./dist/commands/index.js",
-      "types": "./dist/commands/index.d.ts"
+    "./native": {
+      "types": "./dist/native.d.ts",
+      "import": "./dist/native.js"
     }
   },
   "sideEffects": false,
   "keywords": [
     "alien",
     "sdk",
-    "bindings",
-    "commands",
-    "grpc"
+    "worker",
+    "bindings"
   ],
   "author": "Alien Software, Inc. <hi@alien.dev>",
   "license": "FSL-1.1-Apache-2.0",
   "homepage": "https://alien.dev",
-  "description": "TypeScript SDK for Alien — runtime bindings, command handlers, and command invocation",
+  "description": "TypeScript SDK for Alien Worker apps — handler APIs and re-exported binding factories",
   "repository": {
     "type": "git",
     "url": "https://github.com/alienplatform/alien.git",
@@ -33,11 +39,7 @@
     "access": "public"
   },
   "devDependencies": {
-    "@aws-sdk/client-secrets-manager": "^3.0.0",
-    "@azure/identity": "^4.0.0",
-    "@azure/keyvault-secrets": "^4.0.0",
     "@biomejs/biome": "^1.9.4",
-    "@google-cloud/secret-manager": "^5.0.0",
     "@types/node": "^24.0.15",
     "ts-proto": "^2.7.0",
     "tsdown": "^0.13.0",
@@ -48,33 +50,11 @@
   "dependencies": {
     "@bufbuild/protobuf": "^2.5.3",
     "@grpc/grpc-js": "^1.14.4",
-    "long": "^5.3.2",
     "nice-grpc": "^2.1.11",
     "nice-grpc-common": "^2.0.2",
-    "protobufjs": "^7.6.5",
-    "ts-pattern": "^5.7.1",
     "zod": "4.3.2",
-    "@alienplatform/core": "^1.14.1"
-  },
-  "peerDependencies": {
-    "@aws-sdk/client-secrets-manager": "^3.0.0",
-    "@azure/identity": "^4.0.0",
-    "@azure/keyvault-secrets": "^4.0.0",
-    "@google-cloud/secret-manager": "^5.0.0"
-  },
-  "peerDependenciesMeta": {
-    "@aws-sdk/client-secrets-manager": {
-      "optional": true
-    },
-    "@azure/identity": {
-      "optional": true
-    },
-    "@azure/keyvault-secrets": {
-      "optional": true
-    },
-    "@google-cloud/secret-manager": {
-      "optional": true
-    }
+    "@alienplatform/bindings": "^2.0.1",
+    "@alienplatform/core": "^2.0.1"
   },
   "scripts": {
     "build": "tsdown && tsc --emitDeclarationOnly",

package/.turbo/turbo-build.log

@@ -1,30 +0,0 @@
-
-> @alienplatform/sdk@1.14.1 build /home/runner/work/alien/alien/packages/sdk
-> tsdown && tsc --emitDeclarationOnly
-
-ℹ tsdown v0.13.5 powered by rolldown v1.1.4
-ℹ 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 97 files
-Warning: Invalid input options (1 issue found)
-- For the "define". Invalid key: Expected never but received "define". 
-ℹ dist/index.js                             468.18 kB │ gzip:  66.23 kB
-ℹ dist/commands/index.js                     12.03 kB │ gzip:   3.11 kB
-ℹ dist/src2.js                             3976.54 kB
-ℹ dist/src.js                               902.50 kB │ gzip: 180.01 kB
-ℹ dist/esm.js                               770.38 kB │ gzip: 156.72 kB
-ℹ dist/dist-cjs.js                          550.90 kB │ gzip: 107.14 kB
-ℹ dist/dist.js                              371.78 kB │ gzip:  69.89 kB
-ℹ dist/checksum.js                          240.44 kB │ gzip:  51.34 kB
-ℹ dist/esm2.js                              128.87 kB │ gzip:  25.10 kB
-ℹ dist/bearerTokenAuthenticationPolicy.js   111.58 kB │ gzip:  27.57 kB
-ℹ dist/es5.js                                52.89 kB │ gzip:   8.47 kB
-ℹ dist/dist2.js                              37.64 kB │ gzip:  10.53 kB
-ℹ dist/event-streams.js                      28.96 kB │ gzip:   6.35 kB
-ℹ dist/jws.js                                23.27 kB │ gzip:   5.32 kB
-ℹ dist/open.js                               15.30 kB │ gzip:   4.62 kB
-ℹ dist/rolldown-runtime.js                    1.89 kB │ gzip:   0.86 kB
-ℹ 16 files, total: 7693.17 kB
-✔ Build complete in 486ms

package/AGENTS.md

@@ -1,70 +0,0 @@
-# @alienplatform/sdk
-
-TypeScript SDK for Alien bindings. Provides gRPC clients for Storage, KV, Queue, Vault, Build, ArtifactRegistry, Worker, 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.