@astrale-os/kernel-core 0.9.0-beta.9 → 0.9.0

package/dist/auth/grant/unresolved/admission.js

@@ -1,17 +1,17 @@
 import { AuthValueError } from '../../error.js';
-import { EXPRESSION_DEPTH_LIMIT, EXPRESSION_OPERAND_LIMIT, } from '../../expression/normalization/index.js';
-import { CREDENTIAL_BYTES_LIMIT, CREDENTIAL_NESTING_DEPTH_LIMIT } from './limits.js';
-/** Admit the exact bounded unresolved Grant wire language. */
+import { CREDENTIAL_BYTES_LIMIT } from './limits.js';
+const COMPOUND = new Set(['union', 'intersect', 'exclude']);
+/**
+ * Admit the exact version-1 unresolved Grant claim: exactly one `self` or one credential leaf.
+ * Compound structure is refused before any nested credential could be verified.
+ */
 export function acceptUnresolved(input) {
     try {
         const value = record(input, '');
         exact(value, ['expr', 'v'], '');
         if (data(value, 'v', '/v') !== 1)
             invalid('/v', 'Unsupported unresolved Grant version');
-        return Object.freeze({
-            v: 1,
-            expr: expression(data(value, 'expr', '/expr'), '/expr', 0, 0, new WeakSet()),
-        });
+        return Object.freeze({ v: 1, expr: leaf(data(value, 'expr', '/expr'), '/expr') });
     }
     catch (cause) {
         if (cause instanceof AuthValueError)
@@ -21,61 +21,29 @@ export function acceptUnresolved(input) {
         });
     }
 }
-function expression(input, path, depth, credentialDepth, active) {
-    if (depth > EXPRESSION_DEPTH_LIMIT)
-        invalid(path, 'Identity expression exceeds its depth limit');
+function leaf(input, path) {
     const value = record(input, path);
-    if (active.has(value))
-        invalid(path, 'Cyclic Identity expressions are not supported');
-    active.add(value);
-    try {
-        const kind = data(value, 'kind', `${path}/kind`);
-        switch (kind) {
-            case 'identity': {
-                const hasSelf = own(value, 'self');
-                const hasCredential = own(value, 'credential');
-                if (hasSelf === hasCredential)
-                    invalid(path, 'Expected exactly one unresolved Identity leaf');
-                if (hasSelf) {
-                    exact(value, ['kind', 'self'], path);
-                    if (data(value, 'self', `${path}/self`) !== true)
-                        invalid(`${path}/self`, 'Expected true');
-                    return Object.freeze({ kind: 'identity', self: true });
-                }
-                exact(value, ['credential', 'kind'], path);
-                if (credentialDepth >= CREDENTIAL_NESTING_DEPTH_LIMIT) {
-                    invalid(`${path}/credential`, 'Credential nesting exceeds its limit');
-                }
-                return Object.freeze({
-                    kind: 'identity',
-                    credential: credential(data(value, 'credential', `${path}/credential`), `${path}/credential`),
-                });
-            }
-            case 'union':
-            case 'intersect': {
-                exact(value, ['kind', 'operands'], path);
-                const operands = list(data(value, 'operands', `${path}/operands`), `${path}/operands`, 2);
-                return Object.freeze({
-                    kind,
-                    operands: Object.freeze(operands.map((operand, index) => expression(operand, `${path}/operands/${index}`, depth + 1, credentialDepth, active))),
-                });
-            }
-            case 'exclude': {
-                exact(value, ['base', 'excluded', 'kind'], path);
-                const excluded = list(data(value, 'excluded', `${path}/excluded`), `${path}/excluded`, 1);
-                return Object.freeze({
-                    kind: 'exclude',
-                    base: expression(data(value, 'base', `${path}/base`), `${path}/base`, depth + 1, credentialDepth, active),
-                    excluded: Object.freeze(excluded.map((operand, index) => expression(operand, `${path}/excluded/${index}`, depth + 1, credentialDepth, active))),
-                });
-            }
-            default:
-                invalid(`${path}/kind`, 'Expected identity, union, intersect, or exclude');
-        }
+    const kind = data(value, 'kind', `${path}/kind`);
+    if (typeof kind === 'string' && COMPOUND.has(kind)) {
+        throw new AuthValueError('AUTH_GRANT_COMPOUND', 'Unresolved Grant must name exactly one Identity', path);
+    }
+    if (kind !== 'identity')
+        invalid(`${path}/kind`, 'Expected identity');
+    const hasSelf = own(value, 'self');
+    if (hasSelf === own(value, 'credential')) {
+        invalid(path, 'Expected exactly one unresolved Identity leaf');
     }
-    finally {
-        active.delete(value);
+    if (hasSelf) {
+        exact(value, ['kind', 'self'], path);
+        if (data(value, 'self', `${path}/self`) !== true)
+            invalid(`${path}/self`, 'Expected true');
+        return Object.freeze({ kind: 'identity', self: true });
     }
+    exact(value, ['credential', 'kind'], path);
+    return Object.freeze({
+        kind: 'identity',
+        credential: credential(data(value, 'credential', `${path}/credential`), `${path}/credential`),
+    });
 }
 function credential(input, path) {
     if (typeof input === 'string') {
@@ -120,14 +88,6 @@ function exact(input, expected, path) {
         invalid(path, `Expected exactly ${expected.join(', ')}`);
     }
 }
-function list(input, path, minimum) {
-    if (!Array.isArray(input) || input.length < minimum || input.length > EXPRESSION_OPERAND_LIMIT) {
-        invalid(path, `Expected ${minimum}-${EXPRESSION_OPERAND_LIMIT} operands`);
-    }
-    if (Object.keys(input).length !== input.length)
-        invalid(path, 'Expected a dense array');
-    return input;
-}
 function compare(left, right) {
     return left < right ? -1 : left > right ? 1 : 0;
 }

package/dist/auth/grant/unresolved/limits.d.ts

@@ -1,7 +1,5 @@
-export declare const CREDENTIAL_NESTING_DEPTH_LIMIT = 3;
 export declare const CREDENTIAL_BYTES_LIMIT: number;
 export declare const limits: {
-    readonly expressionDepth: 32;
-    readonly operandsPerExpression: 64;
-    readonly credentialNestingDepth: 3;
+    /** One nested Kernel delegation proof; proofs never nest further. */
+    readonly credentialNestingDepth: 1;
 };

package/dist/auth/grant/unresolved/limits.js

@@ -1,8 +1,4 @@
-import { EXPRESSION_DEPTH_LIMIT, EXPRESSION_OPERAND_LIMIT, } from '../../expression/normalization/index.js';
-export const CREDENTIAL_NESTING_DEPTH_LIMIT = 3;
 export const CREDENTIAL_BYTES_LIMIT = 64 * 1024;
 export const limits = Object.freeze({
-    expressionDepth: EXPRESSION_DEPTH_LIMIT,
-    operandsPerExpression: EXPRESSION_OPERAND_LIMIT,
-    credentialNestingDepth: CREDENTIAL_NESTING_DEPTH_LIMIT,
+    credentialNestingDepth: 1,
 });

package/dist/auth/identity/admission.js

@@ -7,11 +7,19 @@ import { accept as acceptIssuer } from '../issuer/index.js';
 export function accept(input) {
     try {
         const value = object(portable.accept(input), '');
-        exact(value, ['frozen', 'id', 'issuer', 'requiredClaims', 'subject'], '');
+        exact(value, ['frozen', 'id', 'iss', 'requiredClaims', 'sub'], '');
+        const hasIssuer = value.iss !== undefined;
+        const hasSubject = value.sub !== undefined;
+        if (hasIssuer !== hasSubject)
+            invalid('', 'Expected both iss and sub or neither');
         return Object.freeze({
             id: NodeId(text(value.id, '/id')),
-            issuer: acceptIssuer(text(value.issuer, '/issuer')),
-            subject: text(value.subject, '/subject'),
+            ...(hasIssuer
+                ? {
+                    iss: acceptIssuer(text(value.iss, '/iss')),
+                    sub: text(value.sub, '/sub'),
+                }
+                : {}),
             frozen: value.frozen === undefined ? false : boolean(value.frozen, '/frozen'),
             requiredClaims: constraints(value.requiredClaims, '/requiredClaims'),
         });

package/dist/auth/identity/identity.d.ts

@@ -4,11 +4,23 @@ import type { IssuerId } from '../issuer/index.js';
 /** Stable graph identity of one authenticated principal. */
 export type IdentityId = NodeId;
 export type Subject = string;
+/** One complete authentication assertion at an API boundary. */
+export interface Authentication {
+    readonly iss: IssuerId;
+    readonly sub: Subject;
+}
 /** Normalized Identity value used at authentication boundaries, not a complete graph Node. */
-export interface Identity {
+interface IdentityBase {
     readonly id: IdentityId;
-    readonly issuer: IssuerId;
-    readonly subject: Subject;
     readonly frozen: boolean;
     readonly requiredClaims: readonly ClaimConstraint[];
 }
+/** A stable principal with either both protected authentication facts or neither. */
+export type Identity = IdentityBase & ({
+    readonly iss?: never;
+    readonly sub?: never;
+} | {
+    readonly iss: IssuerId;
+    readonly sub: Subject;
+});
+export {};

package/dist/auth/identity/index.d.ts

@@ -1,3 +1,3 @@
 export { accept } from './admission.js';
 export { verify, verifyFrozen } from './verification.js';
-export type { Identity, IdentityId, Subject } from './identity.js';
+export type { Authentication, Identity, IdentityId, Subject } from './identity.js';

package/dist/auth/index.d.ts

@@ -1,16 +1,16 @@
 export { AuthValueError } from './error.js';
 export type { Attestation } from './attestation/index.js';
-export type { AuthorityExpr, AuthorityPredicate } from './authority/language/index.js';
+export type { AuthorityExpr, AuthorityPredicate, AuthorityProgram, PredicateRef, ClosedEdgeExtent, } from './authority/language/index.js';
 export type { ClaimConstraint } from './claims/index.js';
 export type { AuthenticationEvidence, AuthenticationMethod, CredentialAudience, CredentialInput, MintedCredential, UnverifiedCredential, VerifiedCredential, } from './credential/index.js';
 export type { AuthContext, Authenticated, CredentialContext } from './context/index.js';
 export type { Delegation, DelegationCredential } from './delegation/index.js';
 export type { IdentityExpr, SelfIdentityExpr, UnresolvedIdentityExpr } from './expression/index.js';
 export type { Grant, UnresolvedGrant } from './grant/index.js';
-export type { Identity, IdentityId, Subject } from './identity/index.js';
+export type { Authentication, Identity, IdentityId, Subject } from './identity/index.js';
 export type { IssuerId } from './issuer/index.js';
 export type { JsonWebKey, KeyId } from './jwk/index.js';
-export type { AssertedIdentityProvision, IdentityProvisionInput, ProvisionFingerprint, ProvisionRequest, ProvisionResult, ProvisionedIdentity, RequiredClaims, SelfIdentityProvision, } from './provision/index.js';
+export type { IdentityRegistration, RegisterFingerprint, RegisterFingerprintIdentity, RegisterFingerprintInput, RegisterRequest, RegisterResult, RegisteredIdentity, } from './register/index.js';
 export type { AuthenticationCandidate, AuthenticationTrust, StringPatternSet, TrustDecision, TrustRule, } from './trust/index.js';
 export * as attestation from './attestation/index.js';
 export * as authority from './authority/index.js';
@@ -22,5 +22,5 @@ export * as grant from './grant/index.js';
 export * as identity from './identity/index.js';
 export * as issuer from './issuer/index.js';
 export * as jwk from './jwk/index.js';
-export * as provision from './provision/index.js';
+export * as register from './register/index.js';
 export * as trust from './trust/index.js';

package/dist/auth/index.js

@@ -9,5 +9,5 @@ export * as grant from './grant/index.js';
 export * as identity from './identity/index.js';
 export * as issuer from './issuer/index.js';
 export * as jwk from './jwk/index.js';
-export * as provision from './provision/index.js';
+export * as register from './register/index.js';
 export * as trust from './trust/index.js';

package/dist/auth/jwk/index.d.ts

@@ -1,3 +1,3 @@
 export { acceptPublic } from './public-key.js';
-export { thumbprint } from './thumbprint.js';
+export { thumbprint, thumbprintMembers } from './thumbprint.js';
 export type { JsonWebKey, KeyId } from './public-key.js';

package/dist/auth/jwk/index.js

@@ -1,2 +1,2 @@
 export { acceptPublic } from './public-key.js';
-export { thumbprint } from './thumbprint.js';
+export { thumbprint, thumbprintMembers } from './thumbprint.js';

package/dist/auth/jwk/thumbprint.d.ts

@@ -1,3 +1,5 @@
 import type { JsonWebKey } from './public-key.js';
 /** Compute the RFC 7638 SHA-256 thumbprint of an admitted public key. */
 export declare function thumbprint(input: JsonWebKey): Promise<string>;
+/** Return the exact RFC 7638 members that identify one public key's cryptographic material. */
+export declare function thumbprintMembers(input: JsonWebKey): Readonly<Record<string, string>>;

package/dist/auth/jwk/thumbprint.js

@@ -1,19 +1,25 @@
 import { acceptPublic } from './public-key.js';
 /** Compute the RFC 7638 SHA-256 thumbprint of an admitted public key. */
 export async function thumbprint(input) {
-    const key = acceptPublic(input);
-    const canonical = JSON.stringify(members(key));
+    const canonical = JSON.stringify(thumbprintMembers(input));
     const digest = new Uint8Array(await crypto.subtle.digest('SHA-256', new TextEncoder().encode(canonical)));
     return base64url(digest);
 }
-function members(key) {
+/** Return the exact RFC 7638 members that identify one public key's cryptographic material. */
+export function thumbprintMembers(input) {
+    const key = acceptPublic(input);
     if (key.kty === 'EC') {
-        return { crv: key.crv, kty: key.kty, x: key.x, y: key.y };
+        return Object.freeze({
+            crv: key.crv,
+            kty: key.kty,
+            x: key.x,
+            y: key.y,
+        });
     }
     if (key.kty === 'RSA') {
-        return { e: key.e, kty: key.kty, n: key.n };
+        return Object.freeze({ e: key.e, kty: key.kty, n: key.n });
     }
-    return { crv: key.crv, kty: key.kty, x: key.x };
+    return Object.freeze({ crv: key.crv, kty: key.kty, x: key.x });
 }
 function base64url(input) {
     let binary = '';

package/dist/auth/register/fingerprint/fingerprint.d.ts

@@ -0,0 +1,25 @@
+import type { Authentication, IdentityId } from '../../identity/index.js';
+import type { JsonWebKey } from '../../jwk/index.js';
+declare const REGISTER_FINGERPRINT: unique symbol;
+/** Digest of the semantic request. Credential bytes and verifier evidence are excluded. */
+export type RegisterFingerprint = `sha256:${string}` & {
+    readonly [REGISTER_FINGERPRINT]: true;
+};
+export type RegisterFingerprintIdentity = {
+    readonly id: IdentityId;
+    readonly mode: 'external';
+    readonly authentication: Authentication;
+    readonly publicKey?: never;
+} | {
+    readonly id: IdentityId;
+    readonly mode: 'self';
+    readonly authentication: Authentication;
+    readonly publicKey: JsonWebKey;
+};
+export interface RegisterFingerprintInput {
+    readonly idempotencyKey: string;
+    readonly identities: readonly [RegisterFingerprintIdentity, ...RegisterFingerprintIdentity[]];
+}
+/** Compute a deterministic post-verification digest without retaining credential evidence. */
+export declare function fingerprint(input: RegisterFingerprintInput): Promise<RegisterFingerprint>;
+export {};

package/dist/auth/register/fingerprint/fingerprint.js

@@ -0,0 +1,31 @@
+import * as portable from '@astrale-os/kernel-dsl/value';
+import { thumbprint as jwkThumbprint } from '../../jwk/index.js';
+/** Compute a deterministic post-verification digest without retaining credential evidence. */
+export async function fingerprint(input) {
+    const identities = await Promise.all([...input.identities]
+        .sort((left, right) => compare(left.id, right.id))
+        .map(async (identity) => ({
+        id: identity.id,
+        mode: identity.mode,
+        iss: identity.authentication.iss,
+        sub: identity.authentication.sub,
+        ...(identity.mode === 'self' ? { publication: await publication(identity.publicKey) } : {}),
+    })));
+    const encoded = portable.json.encode(portable.accept({ version: 2, idempotencyKey: input.idempotencyKey, identities }));
+    const digest = await crypto.subtle.digest('SHA-256', Uint8Array.from(encoded).buffer);
+    return `sha256:${hex(new Uint8Array(digest))}`;
+}
+async function publication(publicKey) {
+    const thumbprint = await jwkThumbprint(publicKey);
+    return Object.freeze({
+        key: publicKey,
+        thumbprint,
+        slot: publicKey.kid === undefined ? `thumbprint:${thumbprint}` : `kid:${publicKey.kid}`,
+    });
+}
+function hex(input) {
+    return [...input].map((value) => value.toString(16).padStart(2, '0')).join('');
+}
+function compare(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}

package/dist/auth/register/fingerprint/index.d.ts

@@ -0,0 +1,2 @@
+export { fingerprint } from './fingerprint.js';
+export type { RegisterFingerprint, RegisterFingerprintIdentity, RegisterFingerprintInput, } from './fingerprint.js';

package/dist/auth/register/index.d.ts

@@ -0,0 +1,5 @@
+export { fingerprint } from './fingerprint/index.js';
+export type { RegisterFingerprint, RegisterFingerprintIdentity, RegisterFingerprintInput, } from './fingerprint/index.js';
+export { accept, isSelfIssuer, selfIssuer } from './request/index.js';
+export type { IdentityRegistration, RegisterRequest } from './request/index.js';
+export type { RegisteredIdentity, RegisterResult } from './result/index.js';

package/dist/auth/register/request/admission.d.ts

@@ -0,0 +1,3 @@
+import type { RegisterRequest } from './request.js';
+/** Admit unknown input into the exact immutable existing-target Register language. */
+export declare function accept(input: unknown): RegisterRequest;

package/dist/auth/register/request/admission.js

@@ -0,0 +1,103 @@
+import { NodeId } from '../../../graph/node/index.js';
+import { AuthValueError } from '../../error.js';
+import { acceptPublic } from '../../jwk/index.js';
+import { REGISTER_REQUEST_LIMITS } from './limits.js';
+const textEncoder = new TextEncoder();
+/** Admit unknown input into the exact immutable existing-target Register language. */
+export function accept(input) {
+    if (!isRecord(input))
+        invalid('', 'Expected a Register request object');
+    exact(input, ['idempotencyKey', 'identities'], '');
+    if (typeof input.idempotencyKey !== 'string' ||
+        input.idempotencyKey.length === 0 ||
+        input.idempotencyKey.length > REGISTER_REQUEST_LIMITS.idempotencyKeyCharacters ||
+        textEncoder.encode(input.idempotencyKey).byteLength >
+            REGISTER_REQUEST_LIMITS.idempotencyKeyBytes) {
+        invalid('/idempotencyKey', 'Expected a bounded non-empty idempotency key');
+    }
+    if (!Array.isArray(input.identities) ||
+        input.identities.length === 0 ||
+        input.identities.length > REGISTER_REQUEST_LIMITS.identities) {
+        invalid('/identities', 'Expected a bounded non-empty Identity register array');
+    }
+    const identities = input.identities
+        .map((candidate, index) => identityInput(candidate, `/identities/${index}`))
+        .sort((left, right) => compare(left.id, right.id));
+    for (let index = 1; index < identities.length; index += 1) {
+        if (identities[index - 1].id === identities[index].id) {
+            invalid(`/identities/${index}/id`, 'Duplicate Identity target');
+        }
+    }
+    return Object.freeze({
+        idempotencyKey: input.idempotencyKey,
+        identities: Object.freeze(identities),
+    });
+}
+function identityInput(input, path) {
+    if (!isRecord(input))
+        invalid(path, 'Expected an Identity register object');
+    if (input.mode !== 'external' && input.mode !== 'self') {
+        invalid(`${path}/mode`, 'Expected external or self');
+    }
+    exact(input, input.mode === 'self'
+        ? ['credential', 'id', 'mode', 'publicKey']
+        : ['credential', 'id', 'mode'], path);
+    let id;
+    try {
+        if (typeof input.id !== 'string')
+            throw new TypeError('IdentityId must be text.');
+        id = NodeId(input.id);
+    }
+    catch (cause) {
+        invalid(`${path}/id`, 'Expected an IdentityId', cause);
+    }
+    const credential = credentialInput(input.credential, `${path}/credential`);
+    if (input.mode === 'external') {
+        return Object.freeze({ id, mode: 'external', credential });
+    }
+    return Object.freeze({
+        id,
+        mode: 'self',
+        publicKey: publicJwk(input.publicKey, `${path}/publicKey`),
+        credential,
+    });
+}
+function credentialInput(input, path) {
+    if (typeof input === 'string') {
+        const bytes = textEncoder.encode(input).byteLength;
+        if (bytes === 0 || bytes > REGISTER_REQUEST_LIMITS.credentialBytes) {
+            invalid(path, `Credential must contain 1-${REGISTER_REQUEST_LIMITS.credentialBytes} bytes`);
+        }
+        return input;
+    }
+    if (!(input instanceof Uint8Array) ||
+        input.byteLength === 0 ||
+        input.byteLength > REGISTER_REQUEST_LIMITS.credentialBytes) {
+        invalid(path, `Credential must contain 1-${REGISTER_REQUEST_LIMITS.credentialBytes} bytes`);
+    }
+    return input.slice();
+}
+function publicJwk(input, path) {
+    try {
+        return acceptPublic(input);
+    }
+    catch (cause) {
+        invalid(path, 'Expected a thumbprintable public JWK', cause);
+    }
+}
+function exact(input, expected, path) {
+    const actual = Object.keys(input).sort(compare);
+    const wanted = [...expected].sort(compare);
+    if (actual.length !== wanted.length || actual.some((key, index) => key !== wanted[index])) {
+        invalid(path, `Expected exactly ${expected.join(', ')}`);
+    }
+}
+function isRecord(input) {
+    return input !== null && typeof input === 'object' && !Array.isArray(input);
+}
+function compare(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+function invalid(path, message, cause) {
+    throw new AuthValueError('AUTH_REGISTER_REQUEST_INVALID', message, path, cause === undefined ? undefined : { cause });
+}

package/dist/auth/register/request/index.d.ts

@@ -0,0 +1,3 @@
+export { accept } from './admission.js';
+export { isSelfIssuer, selfIssuer } from './self-issuer.js';
+export type { IdentityRegistration, RegisterRequest } from './request.js';

package/dist/auth/register/request/limits.d.ts

@@ -0,0 +1,6 @@
+export declare const REGISTER_REQUEST_LIMITS: Readonly<{
+    credentialBytes: number;
+    idempotencyKeyBytes: 1024;
+    idempotencyKeyCharacters: 256;
+    identities: 256;
+}>;

package/dist/auth/register/request/limits.js

@@ -0,0 +1,6 @@
+export const REGISTER_REQUEST_LIMITS = Object.freeze({
+    credentialBytes: 64 * 1024,
+    idempotencyKeyBytes: 1_024,
+    idempotencyKeyCharacters: 256,
+    identities: 256,
+});

package/dist/auth/register/request/request.d.ts

@@ -0,0 +1,19 @@
+import type { CredentialInput } from '../../credential/input/index.js';
+import type { IdentityId } from '../../identity/index.js';
+import type { JsonWebKey } from '../../jwk/index.js';
+export type IdentityRegistration = {
+    readonly id: IdentityId;
+    readonly mode: 'external';
+    readonly credential: CredentialInput;
+    readonly publicKey?: never;
+} | {
+    readonly id: IdentityId;
+    readonly mode: 'self';
+    readonly publicKey: JsonWebKey;
+    readonly credential: CredentialInput;
+};
+/** Claim credential-evidenced Authentication for existing Identity-bearing Nodes. */
+export interface RegisterRequest {
+    readonly idempotencyKey: string;
+    readonly identities: readonly [IdentityRegistration, ...IdentityRegistration[]];
+}

package/dist/auth/{provision → register}/request/self-issuer.d.ts

@@ -1,6 +1,6 @@
 import type { IssuerId } from '../../issuer/index.js';
 import type { JsonWebKey } from '../../jwk/index.js';
-/** Build the hosted issuer controlled by one self-provisioned public key. */
+/** Build the hosted issuer controlled by one self-registered public key. */
 export declare function selfIssuer(kernel: IssuerId, publicKey: JsonWebKey): Promise<IssuerId>;
 /** Whether an issuer is one exact key-bound issuer hosted by this Kernel. */
 export declare function isSelfIssuer(kernel: IssuerId, candidate: IssuerId): boolean;

package/dist/auth/{provision → register}/request/self-issuer.js

@@ -1,6 +1,6 @@
 import { accept as acceptIssuer } from '../../issuer/index.js';
 import { thumbprint } from '../../jwk/index.js';
-/** Build the hosted issuer controlled by one self-provisioned public key. */
+/** Build the hosted issuer controlled by one self-registered public key. */
 export async function selfIssuer(kernel, publicKey) {
     const base = String(kernel).replace(/\/+$/u, '');
     return acceptIssuer(`${base}/iss/${await thumbprint(publicKey)}`);

package/dist/auth/register/result/index.d.ts

@@ -0,0 +1 @@
+export type { RegisteredIdentity, RegisterResult } from './result.js';

package/dist/auth/register/result/result.d.ts

@@ -0,0 +1,10 @@
+import type { IdentityId, Subject } from '../../identity/index.js';
+import type { IssuerId } from '../../issuer/index.js';
+export interface RegisteredIdentity {
+    readonly id: IdentityId;
+    readonly iss: IssuerId;
+    readonly sub: Subject;
+}
+export interface RegisterResult {
+    readonly identities: readonly [RegisteredIdentity, ...RegisteredIdentity[]];
+}

package/dist/auth/register/result/result.js

@@ -0,0 +1 @@
+export {};

package/dist/callable/contract/body.d.ts

@@ -0,0 +1,10 @@
+/** One root invocation's already bounded, single-consumer binary request body. */
+export interface BinaryRequestBody {
+    readonly body: ReadableStream<Uint8Array>;
+    readonly length: number;
+}
+/** The streamed request ended early or exceeded its declared Content-Length. */
+export declare class BinaryBodyLengthError extends Error {
+    readonly name = "BinaryBodyLengthError";
+    constructor();
+}

package/dist/callable/contract/body.js

@@ -0,0 +1,7 @@
+/** The streamed request ended early or exceeded its declared Content-Length. */
+export class BinaryBodyLengthError extends Error {
+    name = 'BinaryBodyLengthError';
+    constructor() {
+        super('Binary request length mismatch.');
+    }
+}

package/dist/callable/contract/index.d.ts

@@ -1,5 +1,6 @@
 export type { CallOf } from './call.js';
+export { BinaryBodyLengthError, type BinaryRequestBody } from './body.js';
 export type { InputOf } from './input.js';
-export type { BinaryResult, OutputContractOf, OutputOf, TypedCallableOutput } from './output.js';
+export type { BinaryOutput, BinaryDeliveryBudget, BufferedBinaryResult, OutputContractOf, OutputOf, StreamingBinaryResult, TypedCallableOutput, } from './output.js';
 export type { CallableSignature } from './signature.js';
 export type { Callable, SignatureOf } from './witness.js';

package/dist/callable/contract/index.js

@@ -1 +1 @@
-export {};
+export { BinaryBodyLengthError } from './body.js';

package/dist/callable/contract/output.d.ts

@@ -1,9 +1,25 @@
 import type { SignatureOf } from './witness.js';
-export interface BinaryResult {
+/** Optional owner-selected lifetime for a large HTTP binary result. */
+export interface BinaryDeliveryBudget {
+    readonly maximumDurationMs: number;
+    readonly idleTimeoutMs: number;
+}
+export interface BufferedBinaryResult {
     readonly body: Uint8Array;
     readonly mediaType: string;
+    readonly status?: number;
+    readonly headers?: Readonly<Record<string, string>>;
+}
+export interface StreamingBinaryResult {
+    readonly body: AsyncIterable<Uint8Array>;
+    /** Exact byte length; HTTP aborts delivery if the stream differs. */
+    readonly length?: number;
+    readonly delivery?: BinaryDeliveryBudget;
+    readonly mediaType: string;
+    readonly status?: number;
     readonly headers?: Readonly<Record<string, string>>;
 }
+export type BinaryOutput = BufferedBinaryResult | StreamingBinaryResult;
 /** Output modes retained by a rich callable declaration. */
 export type TypedCallableOutput = {
     readonly mode: 'value';
@@ -24,4 +40,4 @@ export type OutputOf<Value> = OutputContractOf<Value> extends infer Output exten
     readonly item: infer Item;
 } ? AsyncIterable<Item> : Output extends {
     readonly mode: 'binary';
-} ? BinaryResult : never : never;
+} ? BinaryOutput : never : never;

package/dist/callable/index.d.ts

@@ -1,2 +1,3 @@
-export type { BinaryResult, Callable, CallableSignature, CallOf, InputOf, OutputContractOf, OutputOf, SignatureOf, TypedCallableOutput, } from './contract/index.js';
-export type { Call, CallableResult } from './invocation/index.js';
+export { BinaryBodyLengthError } from './contract/index.js';
+export type { BinaryOutput, BinaryDeliveryBudget, BinaryRequestBody, BufferedBinaryResult, Callable, CallableSignature, CallOf, InputOf, OutputContractOf, OutputOf, SignatureOf, StreamingBinaryResult, TypedCallableOutput, } from './contract/index.js';
+export { Target, targetPath, type Call, type CallableResult } from './invocation/index.js';

package/dist/callable/index.js

@@ -1 +1,2 @@
-export {};
+export { BinaryBodyLengthError } from './contract/index.js';
+export { Target, targetPath } from './invocation/index.js';