nupp.runtime.services.digest

Canonical nupp.digest API 1 provider catalog.

Setup imports service here and selects an implementation before requiring nupp.digest. Importing this declaration does not load storage or algorithms. A provider supplies an algorithms map keyed by canonical algorithm name. Each descriptor's name agrees with its key, and each create returns independent owned state. An explicitly selected catalog replaces matching built-in algorithms and may add names; other built-in algorithms remain available. Without selection the facade uses the built-in catalog. Discovery order never selects a provider.

The facade validates and retains descriptors while requiring the module. Lookup, listing, and context creation then use cached descriptors without SPI resolution. Provider state processes chunks incrementally and retains neither input nor output spans. Cleanup consumes state without suspension. Reuse these canonical State and Algorithm identities, including ownership and borrowing signatures. Finalization writes exactly digestSize bytes into the caller's output span. The facade closes state on successful or failed finalization. Standard digest names retain their standard output sizes. MD5 and SHA-1 support interoperability; applications requiring collision resistance must choose an appropriate digest.

interface Algorithm
    readonly name: string
    readonly digestSize: integer
    create: function(self: Algorithm): State
end

create: function(self: Algorithm): State

name: string

digestSize: integer

interface Provider
    readonly algorithms: {[string]: Algorithm}
end

algorithms: {[string]: Algorithm}

affine interface State is nupp.Closeable
    terminal close: nosuspend function(takes self: State): nil
    update: function(exclusive self: State, borrows bytes: ByteSpan): nil
    finish: function(exclusive self: State, exclusive destination: ByteWriteSpan): nil
end

close: nosuspend function(takes self: State): nil

update: function(exclusive self: State, borrows bytes: ByteSpan): nil

finish: function(exclusive self: State, exclusive destination: ByteWriteSpan): nil

const service: services.Service<Provider>