RupuBoundary

Capability protocol (propose → prepare → commit) that carries sealed evidence to an OCC write port — ETag, Dynamo conditional, SQL version.

Parte de la familia Rupu.

1.0.0 — API estable. Contrato: CONTRACT.md.

RupuBoundary no inventa concurrencia ni “resuelve freshness”. Estandariza cómo una decisión transporta evidencia hasta un write port que pueda hacerla valer. El TOCTOU entre re-observe y write lo cierra CAS / If-Match / ConditionExpression — no el core. Evidencia de generalidad: el mismo lifecycle aguanta ETag, Dynamo conditional writes y SQL OCC — sin verbos nuevos en el core.

decision → observe → check → witness
                │
                │  ...el mundo puede cambiar...
                ▼
         re-observe → fresh | stale → effect?

Install

Node.js 18+.

npm install rupu-boundary

Quick start

import {
  createBoundary,
  type BoundarySpec,
} from "rupu-boundary";

const refund = createBoundary({
  parse,
  spec: {
    observe,
    check,
    write,
  } satisfies BoundarySpec<I, S, W>,
});

const proposal = refund.propose(input);
const executable = await refund.prepare(proposal);
const result = await refund.commit(executable);

Adapters publicados (puertos inyectables; sin SDKs):

import { createEtagBoundary } from "rupu-boundary/etag";
import { createDynamoBoundary } from "rupu-boundary/dynamodb";
import { createSqlBoundary } from "rupu-boundary/sql";

Lifecycle

prepare = observe → check → seal(I, W)
commit  = re-observe → compare(W) → Stale | conditional write

| | | |---|---| | I | intent | | S | state para decidir | | W | witness para probar al commit |

RupuBoundary ≠ policy

Policy / authz   →  ¿está permitida la acción?
RupuBoundary     →  ¿la decisión sigue válida contra el estado actual?

Guarantees (T1) / límites

Ver CONTRACT.md. Resumen: Executable opaco y de un solo uso; conflicto de write es { tag: "Conflict" }; Coverage y atomicidad remota son del adapter; prepare abandonado → releaseExecutable.

Development

git clone https://github.com/EmanuelCorreaAR/rupu-boundary.git
cd rupu-boundary
npm install && npm test && npm run build

Status

1.0.0 — core estable (promoción desde 0.4.1, sin breaks); releaseExecutable solo en el entrypoint principal; adapters etag / dynamodb / sql.

Apoyar el proyecto

Si RupuBoundary te sirve, podés invitarme un cafecito: cafecito.app/emacorreadev

License

Apache License 2.0