George Lambert
ddf772454b
Some checks are pending
offline / test (push) Waiting to run
Persist account-balance books; edge caches prepaid from books. Add zappier-identity, verae-nats-accounts, verae-jobs-events, verae-access-staff, zapier-decisions. Edge binds loopback; lan-134 stays off; HTTP services prefer local spawn.
47 lines
2.1 KiB
Markdown
47 lines
2.1 KiB
Markdown
# `verae-fleet/machines`
|
||
|
||
**Package:** `verae-fleet`
|
||
**Source:** `packages/verae-fleet/src/machines.js`
|
||
**Lines:** 116
|
||
|
||
## What this module is
|
||
|
||
Implementation module in `verae-fleet`. The tables below are extracted from the source (signatures + JSDoc).
|
||
|
||
## Exports
|
||
|
||
`defaultMachines`, `loadMachines`, `normalizeMachine`, `upsertMachine`, `canHost`, `pickMachine`, `saveOverlay`
|
||
|
||
## Types / interfaces / classes
|
||
|
||
_None extracted._
|
||
|
||
## Functions
|
||
|
||
| Name | Parameters | Param types (JSDoc) | Returns | Calls (same file / helpers) |
|
||
|------|------------|---------------------|---------|-----------------------------|
|
||
| `defaultMachines` | `(none)` | — | `unknown` | see Call graph |
|
||
| `loadMachines` | `root, overlayPath` | — | `unknown` | see Call graph |
|
||
| `normalizeMachine` | `m` | — | `unknown` | see Call graph |
|
||
| `upsertMachine` | `list, spec` | — | `unknown` | see Call graph |
|
||
| `canHost` | `machine, serviceId, role` | — | `unknown` | see Call graph |
|
||
| `pickMachine` | `machines, instances, serviceId, role, exclude = [], opts = {}` | machines: `object[]`, serviceId: `string`, role: `string` | `unknown` | see Call graph |
|
||
| `saveOverlay` | `overlayPath, machines` | — | `unknown` | see Call graph |
|
||
|
||
## What it imports / requires
|
||
|
||
- `node:fs`
|
||
- `node:path`
|
||
|
||
## Call graph (identifiers invoked)
|
||
|
||
`defaultMachines`, `plane`, `loadMachines`, `join`, `existsSync`, `parse`, `readFileSync`, `isArray`, `upsertMachine`, `assign`, `map`, `normalizeMachine`, `trim`, `findIndex`, `push`, `canHost`, `includes`, `capacity`, `pickMachine`, `filter`, `has`, `sort`, `localeCompare`, `find`, `saveOverlay`, `mkdirSync`, `dirname`, `writeFileSync`, `stringify`
|
||
|
||
Each identifier is a call site in this file. Follow the import list to see the defining module; open that module’s MD for parameter and return types.
|
||
|
||
## Return values (how to read this)
|
||
|
||
- HTTP route handlers return Express `res.json(...)` bodies (see route docs).
|
||
- Zapier `perform` functions return a **single object** (creates) or an **array** (triggers/searches).
|
||
- Pricing functions return integer **cents** on `Quote.totalCents`.
|
||
|