Stable errors and recovery

Solved outcome

What this enables

Recover safely without turning a successful retry, server response, or error descriptor into proof authority.

Installed identity

@receiz/sdk

Version

124.1.0

Package SHA-256

479d52f4c2215b05377ac557a62427abae9c16347e5341201b72699311afd7ac

Record source

node_modules/@receiz/sdk/docs/errors-and-repair.md

Exact form

Signature or request

describeReceizError(error) => receiz.sdk.error.v1

Stable recovery

Failures

Permanent anchor · #stable-errors-descriptor

Descriptor

Use describeReceizError(error) only to project an installed error descriptor. Preserve the exact code, rail, retryability, suggested repair, and authority boundary; the descriptor is not proof.

Permanent anchor · #stable-errors-failure-classes

Failure classes

Distinguish artifact input, verification, admission, authority, capability, history, idempotency, atomic commit, HTTP, and webhook mechanics by the exact installed codes published below.

Permanent anchor · #stable-errors-retry-policy

Retry policy

Retry only when the installed descriptor says the failed mechanic is retryable. Reuse an idempotency identity only within its declared retry boundary and never convert retry success into proof authority.

Permanent anchor · #stable-errors-secret-redaction

Secret redaction

Never log access tokens, webhook secrets, private identity keys, passphrases, recovery material, or full private proof payloads. Preserve safe code and rail fields for repair.

Permanent anchor · #stable-errors-recovery-table

Recovery table

Every published code on this page is byte-present in its named installed source. Where a source declares no stable code, the page says so instead of inventing one.

Permanent anchor · #stable-errors-end-to-end-example

End-to-end example

The example branches on the actual verification status union; it does not read nonexistent ok or code fields from the union.

Copyable path

Authenticated SDK issuance → Verify → inspect receipt

import { createReceizClient } from "@receiz/sdk";

// Begin with the complete proof object already held by the person or runtime.
const encoded = process.env.RECEIZ_ARTIFACT_BASE64;
if (!encoded) throw new Error("RECEIZ_ARTIFACT_BASE64 is required");
const artifactBytes = Uint8Array.from(Buffer.from(encoded, "base64"));

// Local verification is account-free and precedes every transport projection.
const receiz = createReceizClient();
const verification = await receiz.verification.verifyArtifact(artifactBytes);
if (verification.status !== "verified-artifact") {
  throw new Error(`Artifact verification status: ${verification.status}`);
}
console.log(verification.status);