Decorators

Decorators are the entry point for every Puls stack. They wire up credentials, trigger execution, and control lifecycle.

@Deploy

Instantiates the stack and calls deploy() on every resource.

// Bare - uses ambient env config
@Deploy()
class MyStack extends Stack { ... }

// With provider credentials
@Deploy({ proxmox: CONFIG.STAGING })
class MyStack extends Stack { ... }

// Dry run - prints plan, makes no API calls
@Deploy({ dryRun: true, proxmox: CONFIG.STAGING })
class MyStack extends Stack { ... }

Options

Key	Type	Description
dryRun	boolean	Print plan without applying changes
token	string	DigitalOcean API token
region	string	AWS region
proxmox	ProxmoxConfig	Full Proxmox connection config

@DryRun

Shorthand for @Deploy({ dryRun: true }). Accepts the same options.

@DryRun({ proxmox: CONFIG.STAGING })
class MyStack extends Stack { ... }

@Destroy

Instantiates the stack and calls destroy() on every resource in reverse order.

// Bare class decorator
@Destroy
class MyStack extends Stack { ... }

// With credentials
@Destroy({ proxmox: CONFIG.STAGING })
class MyStack extends Stack { ... }

// Property decorator - destroys one resource during a deploy
@Deploy({ proxmox: CONFIG.STAGING })
class MyStack extends Stack {
  @Destroy
  old = Proxmox.VM("ix-sto1-old01");

  new = Proxmox.VM("ix-sto1-new01")...;
}

@Protected resources are skipped during teardown - no API call is made.

@Protected

Marks a property so it cannot be modified or destroyed.

@Deploy({ proxmox: CONFIG.STAGING })
class MyStack extends Stack {
  @Protected
  db = Proxmox.VM("ix-sto1-db01")...;   // never touched by Destroy

  app = Proxmox.VM("ix-sto1-app01")...;  // normal lifecycle
}

When @Destroy runs the stack, protected resources are skipped with a log line:

   🔒 Skipping protected resource "db"

During @Deploy, protected resources are still discovered and reported - they just refuse destructive changes.