@alienplatform/core 1.3.5 → 1.4.0

package/dist/tests/index.d.ts

@@ -12,6 +12,7 @@ declare function getStackState(): {
       status: "pending" | "provisioning" | "provision-failed" | "running" | "updating" | "update-failed" | "deleting" | "delete-failed" | "deleted" | "refresh-failed";
       type: string;
       _internal?: any;
+      controllerPlatform?: "aws" | "gcp" | "azure" | "kubernetes" | "local" | "test" | null | undefined;
       dependencies?: {
         id: string;
         type: string;
@@ -26,7 +27,6 @@ declare function getStackState(): {
         httpStatusCode?: number | null | undefined;
         source?: any;
       } | null | undefined;
-      isExternallyProvisioned?: boolean | undefined;
       lastFailedState?: any;
       lifecycle?: "frozen" | "live" | null | undefined;
       outputs?: {

package/dist/tests/index.js

@@ -1,4 +1,4 @@
-import { gt as StackStateSchema } from "../stack.js";
+import { di as StackStateSchema } from "../stack.js";
 //#region src/tests/index.ts
 function getStackState() {
 	return StackStateSchema.parse(JSON.parse(process.env.ALIEN_STACK_STATE));

package/dist/tests/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/tests/index.ts"],"sourcesContent":["import { StackStateSchema } from \"../stack.js\"\n\n// Utility to get stack state in an Alien integration test\nexport function getStackState() {\n  return StackStateSchema.parse(JSON.parse(process.env.ALIEN_STACK_STATE!))\n}\n"],"mappings":";;AAGA,SAAgB,gBAAgB;AAC9B,QAAO,iBAAiB,MAAM,KAAK,MAAM,QAAQ,IAAI,kBAAmB,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/tests/index.ts"],"sourcesContent":["import { StackStateSchema } from \"../stack.js\"\n\n// Utility to get stack state in an Alien integration test\nexport function getStackState() {\n  return StackStateSchema.parse(JSON.parse(process.env.ALIEN_STACK_STATE!))\n}\n"],"mappings":";;AAGA,SAAgB,gBAAgB;CAC9B,OAAO,iBAAiB,MAAM,KAAK,MAAM,QAAQ,IAAI,iBAAkB,CAAC;AAC1E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alienplatform/core",
-  "version": "1.3.5",
+  "version": "1.4.0",
   "type": "module",
   "exports": {
     ".": {

package/src/__tests__/__snapshots__/stack.test.ts.snap

@@ -28,6 +28,7 @@ exports[`ArtifactRegistry resource configuration > can be used in stack permissi
           "image": "docker.io/library/rust:latest",
           "type": "image",
         },
+        "commandsEnabled": false,
         "environment": {},
         "id": "registry-user",
         "ingress": "private",
@@ -35,7 +36,8 @@ exports[`ArtifactRegistry resource configuration > can be used in stack permissi
         "memoryMb": 256,
         "permissions": "execution",
         "timeoutSeconds": 180,
-        "type": "function",
+        "triggers": [],
+        "type": "worker",
       },
       "dependencies": [],
       "lifecycle": "live",
@@ -98,7 +100,7 @@ exports[`Permissions system > creates a stack with custom permission sets 1`] =
     "management": {
       "extend": {
         "*": [
-          "function/management",
+          "worker/management",
         ],
       },
     },
@@ -134,20 +136,22 @@ exports[`Permissions system > creates a stack with custom permission sets 1`] =
     },
   },
   "resources": {
-    "test-function": {
+    "test-worker": {
       "config": {
         "code": {
           "image": "docker.io/library/rust:latest",
           "type": "image",
         },
+        "commandsEnabled": false,
         "environment": {},
-        "id": "test-function",
+        "id": "test-worker",
         "ingress": "private",
         "links": [],
         "memoryMb": 256,
         "permissions": "execution",
         "timeoutSeconds": 180,
-        "type": "function",
+        "triggers": [],
+        "type": "worker",
       },
       "dependencies": [],
       "lifecycle": "live",
@@ -163,7 +167,7 @@ exports[`Stack builder validation > builds and validates a complex stack with pe
     "management": {
       "extend": {
         "*": [
-          "function/management",
+          "worker/management",
           "storage/management",
         ],
       },
@@ -191,16 +195,17 @@ exports[`Stack builder validation > builds and validates a complex stack with pe
       "dependencies": [],
       "lifecycle": "frozen",
     },
-    "my-test-function": {
+    "my-test-worker": {
       "config": {
         "code": {
           "image": "docker.io/library/rust:latest",
           "type": "image",
         },
+        "commandsEnabled": false,
         "environment": {
           "RUST_LOG": "info,alien_runtime_test_server=debug,alien_runtime=debug",
         },
-        "id": "my-test-function",
+        "id": "my-test-worker",
         "ingress": "public",
         "links": [
           {
@@ -211,7 +216,8 @@ exports[`Stack builder validation > builds and validates a complex stack with pe
         "memoryMb": 512,
         "permissions": "execution",
         "timeoutSeconds": 30,
-        "type": "function",
+        "triggers": [],
+        "type": "worker",
       },
       "dependencies": [],
       "lifecycle": "live",
@@ -294,27 +300,27 @@ exports[`Stack builder validation > builds and validates a stack with Build and
 }
 `;
 
-exports[`Stack builder validation > builds and validates a stack with function source 1`] = `
+exports[`Stack builder validation > builds and validates a stack with worker source 1`] = `
 {
   "id": "my-source-stack",
   "permissions": {
     "management": {
       "extend": {
         "*": [
-          "function/management",
+          "worker/management",
         ],
       },
     },
     "profiles": {
       "execution": {
         "*": [
-          "function/execute",
+          "worker/execute",
         ],
       },
     },
   },
   "resources": {
-    "my-source-function": {
+    "my-source-worker": {
       "config": {
         "code": {
           "src": "./app",
@@ -323,14 +329,16 @@ exports[`Stack builder validation > builds and validates a stack with function s
           },
           "type": "source",
         },
+        "commandsEnabled": false,
         "environment": {},
-        "id": "my-source-function",
+        "id": "my-source-worker",
         "ingress": "private",
         "links": [],
         "memoryMb": 256,
         "permissions": "execution",
         "timeoutSeconds": 15,
-        "type": "function",
+        "triggers": [],
+        "type": "worker",
       },
       "dependencies": [],
       "lifecycle": "live",

package/src/__tests__/error.test.ts

@@ -332,7 +332,7 @@ describe("AlienError.from() with random JS objects", async () => {
 
     expect(alienError.code).toBe("GENERIC_ERROR")
     expect(alienError.context?.errorType).toBe("Function")
-    // Note: Functions get serialized differently by serialize-error
+    // Note: JS functions get serialized differently by serialize-error
   })
 })
 

package/src/__tests__/stack.test.ts

@@ -1,18 +1,37 @@
 import { describe, expect, it } from "vitest"
 
-import { FunctionSchema } from "../generated/index.js"
+import { WorkerSchema } from "../generated/index.js"
 import * as alien from "../index.js"
 
-// Shared image URI for functions in tests
+// Shared image URI for workers in tests
 const SHARED_IMAGE = "docker.io/library/rust:latest"
 
 describe("Stack builder validation", () => {
+  it("builds a stateful container with persistent storage options", () => {
+    const postgres = new alien.Container("postgres")
+      .code({ type: "image", image: "postgres:16-alpine" })
+      .cpu(0.5)
+      .memory("512Mi")
+      .port(5432)
+      .permissions("database")
+      .persistentStorage("20Gi", {
+        mountPath: "/var/lib/postgresql/data",
+      })
+      .build()
+
+    expect(postgres.config.stateful).toBe(true)
+    expect(postgres.config.persistentStorage).toEqual({
+      size: "20Gi",
+      mountPath: "/var/lib/postgresql/data",
+    })
+  })
+
   it("builds and validates a complex stack with permissions", () => {
     // Storage bucket
     const storage = new alien.Storage("my-test-bucket").publicRead(true).build()
 
-    // Main application function with permissions
-    const func = new alien.Function("my-test-function")
+    // Main application worker with permissions
+    const worker = new alien.Worker("my-test-worker")
       .code({ type: "image", image: SHARED_IMAGE })
       .memoryMb(512)
       .timeoutSeconds(30)
@@ -26,7 +45,7 @@ describe("Stack builder validation", () => {
 
     const stack = new alien.Stack("my-test-stack")
       .add(storage, "frozen")
-      .add(func, "live")
+      .add(worker, "live")
       .permissions({
         profiles: {
           execution: {
@@ -36,7 +55,7 @@ describe("Stack builder validation", () => {
         },
         management: {
           extend: {
-            "*": ["function/management", "storage/management"],
+            "*": ["worker/management", "storage/management"],
           },
         },
       })
@@ -45,7 +64,7 @@ describe("Stack builder validation", () => {
     // Basic assertions
     expect(stack.id).toBe("my-test-stack")
     expect(stack.resources).toHaveProperty("my-test-bucket")
-    expect(stack.resources).toHaveProperty("my-test-function")
+    expect(stack.resources).toHaveProperty("my-test-worker")
     expect(stack.permissions?.profiles).toHaveProperty("execution")
     expect(stack.permissions?.management).toHaveProperty("extend")
 
@@ -112,8 +131,8 @@ describe("Stack builder validation", () => {
     expect(stack).toMatchSnapshot()
   })
 
-  it("builds and validates a stack with function source", () => {
-    const funcWithSource = new alien.Function("my-source-function")
+  it("builds and validates a stack with worker source", () => {
+    const workerWithSource = new alien.Worker("my-source-worker")
       .code({
         type: "source",
         src: "./app",
@@ -126,27 +145,27 @@ describe("Stack builder validation", () => {
       .build()
 
     const stack = new alien.Stack("my-source-stack")
-      .add(funcWithSource, "live")
+      .add(workerWithSource, "live")
       .permissions({
         profiles: {
           execution: {
-            "*": ["function/execute"],
+            "*": ["worker/execute"],
           },
         },
         management: {
           extend: {
-            "*": ["function/management"],
+            "*": ["worker/management"],
           },
         },
       })
       .build()
 
     expect(stack.id).toBe("my-source-stack")
-    expect(stack.resources).toHaveProperty("my-source-function")
-    const resourceInStack = stack.resources["my-source-function"]
+    expect(stack.resources).toHaveProperty("my-source-worker")
+    const resourceInStack = stack.resources["my-source-worker"]
     expect(resourceInStack).toBeDefined()
-    const functionConfigFromStack = FunctionSchema.parse(resourceInStack!.config)
-    expect(functionConfigFromStack.code.type).toBe("source")
+    const workerConfigFromStack = WorkerSchema.parse(resourceInStack!.config)
+    expect(workerConfigFromStack.code.type).toBe("source")
 
     expect(stack).toMatchSnapshot()
   })
@@ -170,15 +189,15 @@ describe("Permissions system", () => {
       },
     }
 
-    // Create a function with permissions
-    const func = new alien.Function("test-function")
+    // Create a worker with permissions
+    const worker = new alien.Worker("test-worker")
       .code({ type: "image", image: SHARED_IMAGE })
       .permissions("execution")
       .build()
 
     // Create stack with both string and custom permission sets
     const stack = new alien.Stack("permissions-stack")
-      .add(func, "live")
+      .add(worker, "live")
       .permissions({
         profiles: {
           execution: {
@@ -187,7 +206,7 @@ describe("Permissions system", () => {
         },
         management: {
           extend: {
-            "*": ["function/management"],
+            "*": ["worker/management"],
           },
         },
       })
@@ -195,7 +214,7 @@ describe("Permissions system", () => {
 
     // Verify the stack is properly configured
     expect(stack.id).toBe("permissions-stack")
-    expect(stack.resources).toHaveProperty("test-function")
+    expect(stack.resources).toHaveProperty("test-worker")
     expect(stack.permissions?.profiles).toHaveProperty("execution")
     expect(stack.permissions?.management).toHaveProperty("extend")
 
@@ -282,14 +301,14 @@ describe("ArtifactRegistry resource configuration", () => {
   it("can be used in stack permissions", () => {
     const registry = new alien.ArtifactRegistry("protected-registry").build()
 
-    const func = new alien.Function("registry-user")
+    const worker = new alien.Worker("registry-user")
       .code({ type: "image", image: SHARED_IMAGE })
       .permissions("execution")
       .build()
 
     const stack = new alien.Stack("registry-stack")
       .add(registry, "frozen")
-      .add(func, "live")
+      .add(worker, "live")
       .permissions({
         profiles: {
           execution: {

package/src/container.ts

@@ -5,6 +5,7 @@ import {
   type ContainerGpuSpec,
   ContainerSchema,
   type HealthCheck,
+  type PersistentStorage,
   type ResourceSpec,
   type ResourceType,
 } from "./generated/index.js"
@@ -32,12 +33,21 @@ export {
   ContainerAutoscalingSchema,
 } from "./generated/index.js"
 
+export interface PersistentStorageOptions {
+  /**
+   * Mount path inside the container.
+   *
+   * Defaults to `/data`.
+   */
+  mountPath?: string
+}
+
 /**
  * Represents a long-running container workload.
  *
  * Containers run on compute instances (EC2, GCE, Azure VMs) and are orchestrated
- * by Horizon. They're designed for always-on workloads like web services, APIs,
- * databases, and background workers.
+ * by the managed container backend. They're designed for always-on workloads
+ * like web services, APIs, databases, and background workers.
  */
 export class Container {
   private _config: Partial<ContainerConfig> = {
@@ -45,7 +55,7 @@ export class Container {
     ports: [],
     environment: {},
     stateful: false,
-    // cluster is optional - if not set, ContainerClusterMutation will auto-assign
+    // cluster is optional - if not set, ComputeClusterMutation will auto-assign
   }
 
   /**
@@ -67,7 +77,7 @@ export class Container {
 
   /**
    * Sets the container cluster this container runs on.
-   * @param clusterId The ContainerCluster resource ID.
+   * @param clusterId The ComputeCluster resource ID.
    * @returns The Container builder instance.
    */
   public cluster(clusterId: string): this {
@@ -280,16 +290,19 @@ export class Container {
   }
 
   /**
-   * Configures persistent storage (requires stateful=true).
+   * Configures persistent storage and marks the container stateful.
    * Data survives container restarts.
    * @param size Storage size (e.g., "100Gi", "500Gi", "1Ti").
+   * @param options Optional mount path.
    * @returns The Container builder instance.
    */
-  public persistentStorage(size: string): this {
-    this._config.persistentStorage = {
+  public persistentStorage(size: string, options: PersistentStorageOptions = {}): this {
+    const persistentStorage: PersistentStorage = {
       size,
-      mountPath: "/data",
+      mountPath: options.mountPath ?? "/data",
     }
+
+    this._config.persistentStorage = persistentStorage
     this._config.stateful = true
     return this
   }

package/src/daemon.ts

@@ -0,0 +1,170 @@
+import {
+  type DaemonCode,
+  type Daemon as DaemonConfig,
+  DaemonSchema,
+  type ResourceSpec,
+  type ResourceType,
+} from "./generated/index.js"
+import { Resource } from "./resource.js"
+
+export type {
+  Daemon as DaemonConfig,
+  DaemonCode,
+  DaemonOutputs,
+  ResourceSpec,
+} from "./generated/index.js"
+export {
+  DaemonCodeSchema,
+  DaemonSchema as DaemonConfigSchema,
+  DaemonOutputsSchema,
+} from "./generated/index.js"
+
+/**
+ * Represents a resident process that runs once per eligible machine or node.
+ *
+ * Daemons are intended for long-lived background processes such as endpoint
+ * agents and local side services.
+ */
+export class Daemon {
+  private _config: Partial<DaemonConfig> = {
+    links: [],
+    environment: {},
+    cpu: { min: "0.1", desired: "0.1" },
+    memory: { min: "128Mi", desired: "128Mi" },
+  }
+
+  /**
+   * Creates a new Daemon builder.
+   * @param id Identifier for the daemon. Must contain only alphanumeric characters, hyphens, and underscores ([A-Za-z0-9-_]). Maximum 64 characters.
+   */
+  constructor(id: string) {
+    this._config.id = id
+  }
+
+  /**
+   * Returns a ResourceType representing any daemon resource.
+   * Used for creating permission targets that apply to all daemon resources.
+   * @returns The "daemon" resource type.
+   */
+  public static any(): ResourceType {
+    return "daemon"
+  }
+
+  /**
+   * Sets the code for the daemon, either a pre-built image or source code to be built.
+   * @param code The daemon code configuration.
+   * @returns The Daemon builder instance.
+   */
+  public code(code: DaemonCode): this {
+    this._config.code = code
+    return this
+  }
+
+  /**
+   * Sets the ComputeCluster this daemon runs on for AWS/GCP/Azure deployments.
+   * Kubernetes and Local deployments ignore this field.
+   */
+  public cluster(clusterId: string): this {
+    this._config.cluster = clusterId
+    return this
+  }
+
+  /**
+   * Sets CPU resources for each daemon instance.
+   */
+  public cpu(value: number | ResourceSpec): this {
+    if (typeof value === "number") {
+      this._config.cpu = { min: value.toString(), desired: value.toString() }
+    } else {
+      this._config.cpu = value
+    }
+    return this
+  }
+
+  /**
+   * Sets memory resources for each daemon instance.
+   */
+  public memory(size: string): this {
+    this._config.memory = { min: size, desired: size }
+    return this
+  }
+
+  /**
+   * Sets the backend pool/capacity group for daemon placement.
+   */
+  public pool(pool: string): this {
+    this._config.pool = pool
+    return this
+  }
+
+  /**
+   * Overrides the image default command.
+   */
+  public command(command: string[]): this {
+    this._config.command = command
+    return this
+  }
+
+  /**
+   * Sets key-value pairs as environment variables for the daemon.
+   * @param env A map of environment variable names to their values.
+   * @returns The Daemon builder instance.
+   */
+  public environment(env: Record<string, string>): this {
+    this._config.environment = env
+    return this
+  }
+
+  /**
+   * Links another resource to this daemon.
+   * This makes the linked resource accessible to the daemon, often by injecting
+   * environment variables or granting permissions.
+   * @param resource The resource to link.
+   * @returns The Daemon builder instance.
+   */
+  public link(resource: Resource): this {
+    if (!this._config.links) {
+      this._config.links = []
+    }
+    this._config.links.push(resource.ref())
+    return this
+  }
+
+  /**
+   * Assigns a permission profile to this daemon.
+   * The profile defines the permissions granted to this daemon when interacting
+   * with other cloud resources.
+   * @param permissions The permission profile name.
+   * @returns The Daemon builder instance.
+   */
+  public permissions(permissions: string): this {
+    this._config.permissions = permissions
+    return this
+  }
+
+  /**
+   * Enables or disables the Commands protocol for the daemon.
+   * When enabled, the runtime polls the manager for pending commands and executes registered handlers.
+   * Default: false.
+   * @param enabled Whether to enable commands for this daemon.
+   * @returns The Daemon builder instance.
+   */
+  public commandsEnabled(enabled: boolean): this {
+    this._config.commandsEnabled = enabled
+    return this
+  }
+
+  /**
+   * Builds and validates the daemon configuration.
+   * @returns An immutable Resource representing the configured daemon.
+   * @throws Error if the daemon configuration is invalid.
+   */
+  public build(): Resource {
+    const config = DaemonSchema.parse(this._config)
+
+    return new Resource({
+      type: "daemon",
+      ...config,
+    })
+  }
+}

package/src/error.ts

@@ -88,7 +88,7 @@ export interface AlienErrorMetadata<TContext extends z.ZodTypeAny> {
   internal: boolean
   /** HTTP status code for API responses */
   httpStatusCode?: number
-  /** Function to generate human-readable error message from context */
+  /** Worker to generate human-readable error message from context */
   message: (context: z.infer<TContext>) => string
 }
 
@@ -315,7 +315,7 @@ export class AlienError<TContext extends z.ZodTypeAny = z.ZodAny> extends Error
       return "undefined"
     }
 
-    // Try to get constructor name first (for Arrays, Functions, custom classes, etc.)
+    // Try to get constructor name first (for Arrays, Workers, custom classes, etc.)
     if (error?.constructor?.name) {
       return error.constructor.name
     }