alien-core 1.2.1

Alien Developer Platform
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

# alien-core

Core types and abstractions for the Alien platform.

## Type Generation & Code Sync

Types in this crate are exported to TypeScript for use in `@alienplatform/core`.

### Quick Reference

```bash
# After modifying Rust types, regenerate TypeScript
pnpm generate  # Rust → OpenAPI → Zod schemas
pnpm build
```

### Architecture

```
Rust types (alien-core)
  ↓ schema_exporter.rs (utoipa)
OpenAPI JSON
  ↓ Kubb (packages/core/kubb.config.ts)
Zod schemas + TypeScript types
  ↓ Published as @alienplatform/core
```

### Adding New Types

1. **Define type in Rust** with `#[derive(Serialize, Deserialize)]` and `#[cfg_attr(feature = "openapi", derive(utoipa::ToSchema))]`
2. **Add to schema_exporter.rs**: Include in `#[openapi(components(schemas(...)))]` list
3. **Generate & export**: Run `pnpm generate && pnpm build` in `alien/`
4. **Export from TypeScript**: Add to `packages/core/src/index.ts` exports