# @fjall/deploy-core

Shared deployment engine for Fjall. Used by both `@fjall/cli` and the Fjall webapp deployment worker to provide a single source of truth for build, synth, and deploy orchestration across CDK stacks.

Provides `AwsProvider`, `FrameworkBuilder`, `StepRegistry`, and the `DeployCallbacks` contract. Pure orchestration — environment-agnostic and free of UI concerns.

## Installation

```bash
npm install @fjall/deploy-core
```

## Subpath exports

```typescript
import type { AwsProvider } from "@fjall/deploy-core/aws";
import type { FrameworkBuilder } from "@fjall/deploy-core/types";
import { StepRegistry } from "@fjall/deploy-core/steps";
```

See [docs.fjall.io](https://docs.fjall.io) for full usage.

## Breaking changes

Majors are documented in the release notes on
[docs.fjall.io](https://docs.fjall.io). From 13.0.0 the destruction gate's stateful-resource oracle
also covers log groups, secrets, KMS keys, hosted zones and Cognito user
pools — deletes and replacements of those types stop at the gate (exit 4)
until consented with `--remediate`.

## Licence

Proprietary — see [LICENSE](./LICENSE).