> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kvant.sbs/jeston/llms.txt
> Use this file to discover all available pages before exploring further.

# Release checks

# Release checks

***

## Operations · Release checks

> **Operational objective** — Turn a source change into a release only after code, artifacts, compatibility, and provenance agree.

A release gate that protects users from broken types, missing files, and unsupported runtime behavior.

### Key concepts

<Columns cols={3}>
  <Card title="Source" icon="sparkles">
    Tests green
  </Card>

  <Card title="Artifact" icon="shield-check">
    Files present
  </Card>

  <Card title="Consumer" icon="gauge-high">
    Import works
  </Card>
</Columns>

### Operational surface

```mermaid placement="top-right" theme={null}
flowchart LR
    change[Change] --> types[Typecheck]
    types --> tests[Tests]
    tests --> build[Build]
    build --> pack[Pack inspection]
    pack --> consumer[Consumer smoke test]
    consumer --> publish[Publish]
```

### Evidence over assumption

| Signal   | Healthy interpretation | Action when it degrades   |
| -------- | ---------------------- | ------------------------- |
| Source   | Tests green            | Behavior is acceptable.   |
| Artifact | Files present          | Package is usable.        |
| Consumer | Import works           | Public surface is real.   |
| Publish  | Trusted workflow       | Provenance is controlled. |

### Operational context

Publishing is the last step of a chain; it should not be the first place a package is tested as a consumer would use it.

> **Operator's principle**
>
> A release is ready when a clean consumer can use the artifact, not when the repository can build itself.

### Implementation notes

| Engineering move       | Guidance                                                                  |
| ---------------------- | ------------------------------------------------------------------------- |
| **Check source**       | Run formatting, typecheck, tests, and security checks.                    |
| **Check artifact**     | Inspect files, exports, declarations, and package metadata.               |
| **Check consumer use** | Install the tarball into a clean project and import public APIs.          |
| **Check provenance**   | Use the intended Node version, OIDC workflow, and release tag or trigger. |

### Decision lens

| Mode                   | Practical emphasis                            |
| ---------------------- | --------------------------------------------- |
| **Pull request**       | Fast feedback and no publication.             |
| **Release candidate**  | Full matrix and package consumer test.        |
| **Production publish** | Protected environment and auditable workflow. |

## Related topics

<Columns cols={3}>
  * [scale-balanced · **Review support matrix**](/jeston/jeston/reference/compatibility) — Read the focused guide for this boundary.
  * [terminal · **Automate checks**](/jeston/jeston/reference/cli) — Read the focused guide for this boundary.
  * [cloud-arrow-up · **Deploy the artifact**](/jeston/jeston/operations/deployment) — Read the focused guide for this boundary.
</Columns>

## References

[1]: https://github.com/jeffersoncampos12p-dev/jeston "Jeston source repository"

[2]: https://www.npmjs.com/package/@kvantjs/jeston "Jeston package on npm"

[3]: https://nodejs.org/api/http.html "Node.js HTTP API"

[4]: https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal "AbortSignal Web API"

[5]: https://react.dev/reference/react-dom/server "React server rendering APIs"

[6]: https://www.typescriptlang.org/docs/handbook/intro.html "TypeScript handbook"