a3s-flow 0.13.1

Durable workflow engine and Rust SDK for A3S
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166

name: CI

on:
  push:
    branches:
      - main
  pull_request:
    branches:
      - main

permissions:
  contents: read

concurrency:
  group: ci-${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
  cancel-in-progress: true

env:
  CARGO_TERM_COLOR: always

jobs:
  quality:
    name: Rust quality
    runs-on: ubuntu-24.04
    steps:
      - name: Checkout
        uses: actions/checkout@v5

      - name: Install Rust
        uses: dtolnay/rust-toolchain@stable
        with:
          components: clippy,rustfmt

      - name: Cache Cargo
        uses: Swatinem/rust-cache@v2

      - name: Check formatting
        run: cargo fmt --all -- --check

      - name: Run Clippy
        run: cargo clippy --all-targets --all-features -- -D warnings

      - name: Test default features
        run: cargo test --all-targets

      - name: Test minimal features
        run: cargo test --all-targets --no-default-features

      - name: Test SQLite only
        run: cargo test --all-targets --no-default-features --features sqlite

      - name: Test A3S Boot only
        run: cargo test --all-targets --no-default-features --features boot

      - name: Test SQLite and native TypeScript
        run: cargo test --all-targets --no-default-features --features sqlite,native-ts

      - name: Test A3S Boot with ORM storage
        run: cargo test --all-targets --no-default-features --features boot,sqlite

      - name: Test A3S Event integration
        run: cargo test --all-targets --no-default-features --features a3s-event

      - name: Build documentation
        env:
          RUSTDOCFLAGS: -D warnings
        run: cargo doc --all-features --no-deps

      - name: Verify package contents
        env:
          # Avoid placing a nested packaged workspace inside rust-cache's target tree.
          CARGO_TARGET_DIR: ${{ runner.temp }}/a3s-flow-package-target
        run: cargo package --locked

  api-compatibility:
    name: Public API compatibility
    runs-on: ubuntu-24.04
    steps:
      - name: Checkout
        uses: actions/checkout@v5

      - name: Check released API compatibility
        uses: obi1kenobi/cargo-semver-checks-action@v2
        with:
          feature-group: all-features

  native-ts-platform:
    name: Native TypeScript (${{ matrix.name }})
    strategy:
      fail-fast: false
      matrix:
        include:
          - name: Linux
            os: ubuntu-24.04
            compiler: target/debug/a3s-flow-native-compiler
          - name: Windows
            os: windows-latest
            compiler: target/debug/a3s-flow-native-compiler.exe
    runs-on: ${{ matrix.os }}
    steps:
      - name: Checkout
        uses: actions/checkout@v5

      - name: Install Rust
        uses: dtolnay/rust-toolchain@stable

      - name: Install Bun
        id: setup-bun
        uses: oven-sh/setup-bun@0c5077e51419868618aeaa5fe8019c62421857d6 # v2.2.0
        with:
          bun-version: 1.3.14

      - name: Cache Cargo
        uses: Swatinem/rust-cache@v2
        with:
          key: native-ts-${{ matrix.os }}

      - name: Build the installable compiler
        run: cargo build --bin a3s-flow-native-compiler

      - name: Run the real Bun compiler and workflow smoke test
        env:
          A3S_FLOW_BUN: ${{ steps.setup-bun.outputs.bun-path }}
          A3S_FLOW_NATIVE_TS_COMPILER: ${{ github.workspace }}/${{ matrix.compiler }}
        run: >-
          cargo test --test native_ts_bun_smoke --features native-ts --
          --ignored --exact native_ts_compiler_executes_real_bun_workflow

  postgres:
    name: PostgreSQL 17
    runs-on: ubuntu-24.04
    services:
      postgres:
        image: postgres:17
        env:
          POSTGRES_DB: a3s_flow
          POSTGRES_PASSWORD: a3s_flow
          POSTGRES_USER: a3s_flow
        options: >-
          --health-cmd "pg_isready -U a3s_flow -d a3s_flow"
          --health-interval 5s
          --health-timeout 5s
          --health-retries 12
        ports:
          - 5432:5432
    env:
      A3S_FLOW_POSTGRES_URL: postgres://a3s_flow:a3s_flow@127.0.0.1:5432/a3s_flow
    steps:
      - name: Checkout
        uses: actions/checkout@v5

      - name: Install Rust
        uses: dtolnay/rust-toolchain@stable

      - name: Cache Cargo
        uses: Swatinem/rust-cache@v2
        with:
          key: postgres

      - name: Run the all-feature real PostgreSQL suite
        run: cargo test --all-targets --all-features -- --test-threads=1

      - name: Run PostgreSQL durability examples
        run: |
          cargo run --quiet --features postgres --example postgres_durability
          cargo run --quiet --features postgres --example postgres_task_queue_durability