@cardanowall/poe-standard 0.2.0 → 0.4.0

package/dist/index.d.cts

@@ -1,60 +1,6 @@
-export { Argon2idParams, Argon2idParamsSchema, ChunkedBytesArray, ChunkedBytesArraySchema, EXTENSION_KEY_COMPANION_RE, EXTENSION_KEY_VENDOR_RE, EncryptionEnvelope, EncryptionEnvelopeSchema, HashDigestSchema, HashesMap, HashesMapSchema, ItemEntry, ItemEntrySchema, MerkleCommit, MerkleCommitSchema, PassphraseBlock, PassphraseBlockSchema, PoeRecord, PoeRecordSchema, SigEntry, SigEntrySchema, Slot, SlotSchema, Supersedes, SupersedesSchema, TOP_LEVEL_BASE_KEYS, UriChunkArray, UriChunkArraySchema, VersionLiteralSchema, isExtensionKey } from './schema.cjs';
+export { Argon2idParams, Argon2idParamsSchema, EXTENSION_KEY_COMPANION_RE, EXTENSION_KEY_VENDOR_RE, EncOpaque, EncOpaqueSchema, EncScheme1, EncScheme1Schema, EncryptionEnvelope, EncryptionEnvelopeSchema, HashDigestSchema, HashesMap, HashesMapSchema, ItemEntry, ItemEntrySchema, MerkleCommit, MerkleCommitSchema, PassphraseBlock, PassphraseBlockSchema, PoeRecord, PoeRecordSchema, SigEntry, SigEntrySchema, Slot, SlotSchema, Supersedes, SupersedesSchema, TOP_LEVEL_BASE_KEYS, Uri, UriSchema, VersionLiteralSchema, isExtensionKey } from './schema.cjs';
 export { encodePoeRecord, encodeRecordBodyForSigning } from './encoder.cjs';
-export { ValidateResult, ValidationIssue, validateCidProfile, validatePoeRecord } from './validator.cjs';
-export { ERROR_CODES, ErrorCode, SEVERITY, STRUCTURAL_ERROR_CODES, Severity, StructuralErrorCode, VERIFIER_ERROR_CODES, VerifierErrorCode, severityOf } from './error-codes.cjs';
+export { Label309ReassemblyResult, TRANSPORT_CHUNK_MAX_BYTES, chunkRecordBody, encodeLabel309Value, reassembleLabel309Value } from './carriage.cjs';
+export { Argon2ParamsCeiling, DEFAULT_PASSPHRASE_PARAMS_CEILING, ValidationIssue, ValidationResult, ValidatorOptions, ValidatorRole, validateCidProfile, validatePoeRecord } from './validator.cjs';
+export { CARRIAGE_ERROR_CODES, DUAL_SEVERITY_CODES, ERROR_CODES, ERROR_CODE_PART, ErrorCode, ErrorCodePart, SEVERITY, STRUCTURAL_ERROR_CODES, Severity, StructuralErrorCode, VERIFIER_ERROR_CODES, VerifierErrorCode, errorCodeRegistryIndex, severityOf } from './error-codes.cjs';
 import 'zod';
-
-/**
- * Split a logical byte string into ≤ 64-byte CBOR-bytes chunks
- * (`bytes-chunk-array`). Always returns a non-empty array.
- *
- * For empty inputs, returns `[<empty>]` so the caller's schema gate fails
- * later via `CHUNK_TOO_LARGE` (zero-length chunks are rejected). Real callers
- * feed COSE_Sign1 / cbor<COSE_Key> byte strings, which are never empty.
- */
-declare function chunkBytes(value: Uint8Array): Uint8Array[];
-/**
- * Reverse of {@link chunkBytes}: concatenate chunked bytes (`sigs[i].cose_sign1`,
- * `sigs[i].cose_key`) into a single buffer for downstream CBOR/COSE decode.
- * The validator-layer schema enforces the per-chunk size + non-empty-array
- * invariants before this helper runs, so it makes no length checks.
- */
-declare function bytesChunkArrayConcat(chunks: ReadonlyArray<Uint8Array>): Uint8Array;
-type ReconstructUriResult = {
-    ok: true;
-    uri: string;
-} | {
-    ok: false;
-    code: 'INVALID_URI';
-    reason: string;
-};
-/**
- * Reconstruct a chunked URI (`uri-chunk-array`) into its logical string.
- *
- * The chunks arrive as JS strings produced by the canonical-CBOR decoder,
- * which already rejects any non-UTF-8 `tstr` (surfacing it upstream as
- * `MALFORMED_CBOR`) — so by the time this helper runs the only structural
- * task left is to byte-concatenate and decode. We re-encode each chunk to its
- * UTF-8 bytes, concatenate, and decode the whole with `{ fatal: true }`. A
- * conformant producer never splits a multi-byte codepoint across chunks (the
- * Cardano 64-byte cap is applied on codepoint boundaries), so this decode
- * succeeds for every well-formed record; the `INVALID_URI` branch is the
- * residual guard for a byte sequence that does not reconstruct to valid UTF-8.
- *
- * Per-scheme shape validation (the IPFS CID profile) and absolute-URI /
- * fragment-identifier / scheme-set checks fire in `validator.ts`, NOT here —
- * this helper is structural-only.
- */
-declare function reconstructChunkedUri(chunks: ReadonlyArray<string>): ReconstructUriResult;
-/**
- * Chunk a URI string into `[ tstr .size (1..64) ]`, splitting on UTF-8 byte
- * boundaries so no multi-byte codepoint straddles a chunk.
- *
- * For pure-ASCII URIs (the common `ar://`, `ipfs://` cases) this collapses
- * to plain 64-byte byte-slice chunks. For URIs with non-ASCII path components
- * (rare but possible — RFC 3986 §2.5 IRIs / percent-encoded UTF-8) the
- * algorithm rewinds to the nearest codepoint boundary at each chunk break.
- */
-declare function chunkUri(uri: string): string[];
-
-export { type ReconstructUriResult, bytesChunkArrayConcat, chunkBytes, chunkUri, reconstructChunkedUri };

package/dist/index.d.ts

@@ -1,60 +1,6 @@
-export { Argon2idParams, Argon2idParamsSchema, ChunkedBytesArray, ChunkedBytesArraySchema, EXTENSION_KEY_COMPANION_RE, EXTENSION_KEY_VENDOR_RE, EncryptionEnvelope, EncryptionEnvelopeSchema, HashDigestSchema, HashesMap, HashesMapSchema, ItemEntry, ItemEntrySchema, MerkleCommit, MerkleCommitSchema, PassphraseBlock, PassphraseBlockSchema, PoeRecord, PoeRecordSchema, SigEntry, SigEntrySchema, Slot, SlotSchema, Supersedes, SupersedesSchema, TOP_LEVEL_BASE_KEYS, UriChunkArray, UriChunkArraySchema, VersionLiteralSchema, isExtensionKey } from './schema.js';
+export { Argon2idParams, Argon2idParamsSchema, EXTENSION_KEY_COMPANION_RE, EXTENSION_KEY_VENDOR_RE, EncOpaque, EncOpaqueSchema, EncScheme1, EncScheme1Schema, EncryptionEnvelope, EncryptionEnvelopeSchema, HashDigestSchema, HashesMap, HashesMapSchema, ItemEntry, ItemEntrySchema, MerkleCommit, MerkleCommitSchema, PassphraseBlock, PassphraseBlockSchema, PoeRecord, PoeRecordSchema, SigEntry, SigEntrySchema, Slot, SlotSchema, Supersedes, SupersedesSchema, TOP_LEVEL_BASE_KEYS, Uri, UriSchema, VersionLiteralSchema, isExtensionKey } from './schema.js';
 export { encodePoeRecord, encodeRecordBodyForSigning } from './encoder.js';
-export { ValidateResult, ValidationIssue, validateCidProfile, validatePoeRecord } from './validator.js';
-export { ERROR_CODES, ErrorCode, SEVERITY, STRUCTURAL_ERROR_CODES, Severity, StructuralErrorCode, VERIFIER_ERROR_CODES, VerifierErrorCode, severityOf } from './error-codes.js';
+export { Label309ReassemblyResult, TRANSPORT_CHUNK_MAX_BYTES, chunkRecordBody, encodeLabel309Value, reassembleLabel309Value } from './carriage.js';
+export { Argon2ParamsCeiling, DEFAULT_PASSPHRASE_PARAMS_CEILING, ValidationIssue, ValidationResult, ValidatorOptions, ValidatorRole, validateCidProfile, validatePoeRecord } from './validator.js';
+export { CARRIAGE_ERROR_CODES, DUAL_SEVERITY_CODES, ERROR_CODES, ERROR_CODE_PART, ErrorCode, ErrorCodePart, SEVERITY, STRUCTURAL_ERROR_CODES, Severity, StructuralErrorCode, VERIFIER_ERROR_CODES, VerifierErrorCode, errorCodeRegistryIndex, severityOf } from './error-codes.js';
 import 'zod';
-
-/**
- * Split a logical byte string into ≤ 64-byte CBOR-bytes chunks
- * (`bytes-chunk-array`). Always returns a non-empty array.
- *
- * For empty inputs, returns `[<empty>]` so the caller's schema gate fails
- * later via `CHUNK_TOO_LARGE` (zero-length chunks are rejected). Real callers
- * feed COSE_Sign1 / cbor<COSE_Key> byte strings, which are never empty.
- */
-declare function chunkBytes(value: Uint8Array): Uint8Array[];
-/**
- * Reverse of {@link chunkBytes}: concatenate chunked bytes (`sigs[i].cose_sign1`,
- * `sigs[i].cose_key`) into a single buffer for downstream CBOR/COSE decode.
- * The validator-layer schema enforces the per-chunk size + non-empty-array
- * invariants before this helper runs, so it makes no length checks.
- */
-declare function bytesChunkArrayConcat(chunks: ReadonlyArray<Uint8Array>): Uint8Array;
-type ReconstructUriResult = {
-    ok: true;
-    uri: string;
-} | {
-    ok: false;
-    code: 'INVALID_URI';
-    reason: string;
-};
-/**
- * Reconstruct a chunked URI (`uri-chunk-array`) into its logical string.
- *
- * The chunks arrive as JS strings produced by the canonical-CBOR decoder,
- * which already rejects any non-UTF-8 `tstr` (surfacing it upstream as
- * `MALFORMED_CBOR`) — so by the time this helper runs the only structural
- * task left is to byte-concatenate and decode. We re-encode each chunk to its
- * UTF-8 bytes, concatenate, and decode the whole with `{ fatal: true }`. A
- * conformant producer never splits a multi-byte codepoint across chunks (the
- * Cardano 64-byte cap is applied on codepoint boundaries), so this decode
- * succeeds for every well-formed record; the `INVALID_URI` branch is the
- * residual guard for a byte sequence that does not reconstruct to valid UTF-8.
- *
- * Per-scheme shape validation (the IPFS CID profile) and absolute-URI /
- * fragment-identifier / scheme-set checks fire in `validator.ts`, NOT here —
- * this helper is structural-only.
- */
-declare function reconstructChunkedUri(chunks: ReadonlyArray<string>): ReconstructUriResult;
-/**
- * Chunk a URI string into `[ tstr .size (1..64) ]`, splitting on UTF-8 byte
- * boundaries so no multi-byte codepoint straddles a chunk.
- *
- * For pure-ASCII URIs (the common `ar://`, `ipfs://` cases) this collapses
- * to plain 64-byte byte-slice chunks. For URIs with non-ASCII path components
- * (rare but possible — RFC 3986 §2.5 IRIs / percent-encoded UTF-8) the
- * algorithm rewinds to the nearest codepoint boundary at each chunk break.
- */
-declare function chunkUri(uri: string): string[];
-
-export { type ReconstructUriResult, bytesChunkArrayConcat, chunkBytes, chunkUri, reconstructChunkedUri };