@astrale-os/kernel-protocol 0.5.0-beta.71 → 0.5.0-beta.72

package/dist/release/legacy/publication.js

@@ -1,124 +0,0 @@
-import * as portable from '@astrale-os/kernel-dsl/value';
-import { admitDigest } from '../digest.js';
-import { servedUrl } from '../issuer.js';
-import { admitServedContent } from '../served.js';
-import { deepFreeze } from '../shape.js';
-import { exact, fail, record, withPublicationError } from './error.js';
-import { computeEtag } from './etag.js';
-import { decodeLegacyRequirements, encodeLegacyRequirements } from './profiles.js';
-/**
- * @deprecated Path of the v2/v3 Publication; use the release `PATH` (`release.json`) from
- * `@astrale-os/kernel-protocol/release` (added with `DomainRelease` v4).
- */
-export const PATH = '/.well-known/astrale/domain.json';
-/**
- * @deprecated Media type of Publication v3; use the release `MEDIA_TYPE` from
- * `@astrale-os/kernel-protocol/release` (added with `DomainRelease` v4).
- */
-export const MEDIA_TYPE = 'application/vnd.astrale.domain-publication+json;v=3';
-/**
- * @deprecated Media type of Publication v2; use the release `MEDIA_TYPE` from
- * `@astrale-os/kernel-protocol/release` (added with `DomainRelease` v4).
- */
-export const LEGACY_MEDIA_TYPE = 'application/vnd.astrale.domain-publication+json;v=2';
-/**
- * Select the media type of one v2 or v3 Publication.
- *
- * @deprecated Serves and retains v2/v3 Publications only; use the release `MEDIA_TYPE` from
- * `@astrale-os/kernel-protocol/release` (added with `DomainRelease` v4), the one media type of a
- * release.
- */
-export function mediaType(input) {
-    return input.version === 2 ? LEGACY_MEDIA_TYPE : MEDIA_TYPE;
-}
-/**
- * Resolve the canonical Publication URL beneath one exact HTTP(S) serving issuer.
- *
- * @deprecated Locates the v2/v3 Publication; use the release `url` (`release.json`) from
- * `@astrale-os/kernel-protocol/release` (added with `DomainRelease` v4).
- */
-export function url(input) {
-    return withPublicationError(() => servedUrl(input, PATH));
-}
-/**
- * @deprecated Seals a v2/v3 Publication; use the release `seal` from
- * `@astrale-os/kernel-protocol/release` (added with `DomainRelease` v4).
- */
-export function seal(input) {
-    return withPublicationError(() => {
-        const canonical = withoutEtag(acceptPublication({ ...input, etag: 'canonicalizing' }, 'seal'));
-        return acceptPublication({ ...canonical, etag: computeEtag(canonical) }, 'canonical');
-    });
-}
-/**
- * @deprecated Admits a v2/v3 Publication; use the release `accept` from
- * `@astrale-os/kernel-protocol/release` (added with `DomainRelease` v4).
- */
-export function accept(input) {
-    return withPublicationError(() => {
-        const publication = acceptPublication(input, 'wire');
-        if (publication.etag !== computeEtag(withoutEtag(publication))) {
-            fail('PUBLICATION_ETAG_MISMATCH', 'Publication ETag does not match its canonical content.');
-        }
-        return publication;
-    });
-}
-/**
- * @deprecated Encodes a v2/v3 Publication byte-identically to its accepted wire form; use the
- * release `encode` from `@astrale-os/kernel-protocol/release` (added with `DomainRelease` v4).
- */
-export function encode(input) {
-    const wire = input.version === 2
-        ? { ...input, requirements: encodeLegacyRequirements(input.requirements) }
-        : input;
-    return portable.json.encode(wire);
-}
-function acceptPublication(input, mode) {
-    const value = record(input, 'PUBLICATION_INVALID', 'Expected a Publication object.');
-    exact(value, [
-        'format',
-        'version',
-        'origin',
-        'identity',
-        'etag',
-        'schema',
-        'requirements',
-        'manifest',
-        'bindings',
-        'routes',
-        'delivery',
-    ], 'PUBLICATION_INVALID');
-    if (value.format !== 'astrale.domain.publication' ||
-        (value.version !== 2 && value.version !== 3)) {
-        fail('PUBLICATION_INVALID', 'Unsupported Publication format or version.');
-    }
-    // Version 2 is read-only: retained Publications keep their exact bytes and ETag, but no new one
-    // is sealed.
-    if (value.version !== 3 && mode === 'seal') {
-        fail('PUBLICATION_INVALID', 'Only Publication version 3 can be sealed.');
-    }
-    const served = admitServedContent(value, {
-        views: mode === 'seal' ? 'canonicalize' : 'admit',
-        ...(value.version === 2 && mode === 'wire' ? { requirements: decodeLegacyRequirements } : {}),
-    });
-    const admittedEtag = mode === 'wire' ? admitDigest(value.etag) : value.etag;
-    if (typeof admittedEtag !== 'string')
-        fail('PUBLICATION_INVALID', 'Publication ETag is missing.');
-    return deepFreeze({
-        format: 'astrale.domain.publication',
-        version: value.version,
-        origin: served.origin,
-        identity: served.identity,
-        etag: admittedEtag,
-        schema: served.schema,
-        requirements: served.requirements,
-        ...(served.manifest === undefined ? {} : { manifest: served.manifest }),
-        bindings: served.bindings,
-        routes: served.routes,
-        ...(served.delivery === undefined ? {} : { delivery: served.delivery }),
-    });
-}
-function withoutEtag(input) {
-    const { etag: _etag, ...content } = input;
-    return content;
-}

package/dist/release/legacy/reference.d.ts

@@ -1,47 +0,0 @@
-import type { Revision } from '@astrale-os/kernel-dsl/v1/addressing';
-import { type Key } from '@astrale-os/kernel-dsl/v1/addressing';
-import type { Etag } from './etag.js';
-import type { Publication } from './publication.js';
-/**
- * Compact untrusted projection that witnesses one exact Publication.
- *
- * @deprecated Witnesses a v2/v3 Publication; use `ReleaseRef` from
- * `@astrale-os/kernel-protocol/release` (added with `DomainRelease` v4).
- */
-export interface PublicationRef {
-    readonly origin: Key.Origin;
-    readonly identity: Publication['identity'];
-    readonly revision: Revision;
-    readonly etag: Etag;
-}
-/**
- * @deprecated Relation between two `PublicationRef`s; use `ReleaseReferenceRelation` from
- * `@astrale-os/kernel-protocol/release` (added with `DomainRelease` v4).
- */
-export type PublicationReferenceRelation = 'exact' | 'same-schema' | 'schema-drift' | 'identity-drift' | 'origin-drift';
-/**
- * @deprecated Projects a v2/v3 Publication; use the release `reference` from
- * `@astrale-os/kernel-protocol/release` (added with `DomainRelease` v4).
- */
-export declare function reference(input: Publication): PublicationRef;
-/**
- * @deprecated Admits a v2/v3 Publication reference; use the release `acceptReference` from
- * `@astrale-os/kernel-protocol/release` (added with `DomainRelease` v4).
- */
-export declare function acceptReference(input: unknown): PublicationRef;
-/**
- * @deprecated Classifies two `PublicationRef`s; use the release `compareReferences` from
- * `@astrale-os/kernel-protocol/release` (added with `DomainRelease` v4).
- */
-export declare function compareReferences(input: PublicationRef, expected: PublicationRef): PublicationReferenceRelation;
-/**
- * @deprecated Compares a v2/v3 Publication with a `PublicationRef`; use
- * `compareReferences(reference(release), expected)` from `@astrale-os/kernel-protocol/release`
- * (added with `DomainRelease` v4).
- */
-export declare function compareReference(input: Publication, expected: PublicationRef): PublicationReferenceRelation;
-/**
- * @deprecated Matches a v2/v3 Publication with a `PublicationRef`; use the release
- * `matchesReference` from `@astrale-os/kernel-protocol/release` (added with `DomainRelease` v4).
- */
-export declare function matchesReference(input: Publication, expected: PublicationRef): boolean;

package/dist/release/legacy/reference.js

@@ -1,92 +0,0 @@
-import { AuthValueError } from '@astrale-os/kernel-core/auth/error';
-import { accept as acceptIssuerId } from '@astrale-os/kernel-core/auth/issuer';
-import { patterns } from '@astrale-os/kernel-dsl/v1/addressing';
-import { admitDigest } from '../digest.js';
-import { deepFreeze } from '../shape.js';
-import { exact, fail, record, withPublicationError } from './error.js';
-/**
- * @deprecated Projects a v2/v3 Publication; use the release `reference` from
- * `@astrale-os/kernel-protocol/release` (added with `DomainRelease` v4).
- */
-export function reference(input) {
-    return deepFreeze({
-        origin: input.origin,
-        identity: { ...input.identity },
-        revision: input.schema.revision,
-        etag: input.etag,
-    });
-}
-/**
- * @deprecated Admits a v2/v3 Publication reference; use the release `acceptReference` from
- * `@astrale-os/kernel-protocol/release` (added with `DomainRelease` v4).
- */
-export function acceptReference(input) {
-    return withPublicationError(() => admitReference(input));
-}
-function admitReference(input) {
-    const value = record(input, 'PUBLICATION_INVALID', 'Publication reference is invalid.');
-    exact(value, ['origin', 'identity', 'revision', 'etag'], 'PUBLICATION_INVALID');
-    if (typeof value.origin !== 'string' || !patterns.origin.test(value.origin)) {
-        fail('PUBLICATION_INVALID', 'Publication reference origin is invalid.');
-    }
-    const origin = value.origin;
-    const identity = record(value.identity, 'PUBLICATION_INVALID', 'Publication reference identity is invalid.');
-    exact(identity, ['issuer', 'subject'], 'PUBLICATION_INVALID');
-    const issuer = acceptIssuer(identity.issuer);
-    if (identity.subject !== origin) {
-        fail('PUBLICATION_INVALID', 'Publication reference subject must equal its root origin.');
-    }
-    if (typeof value.revision !== 'string' || !patterns.revision.test(value.revision)) {
-        fail('PUBLICATION_INVALID', 'Publication reference revision is invalid.');
-    }
-    return deepFreeze({
-        origin,
-        identity: { issuer, subject: origin },
-        revision: value.revision,
-        etag: admitDigest(value.etag),
-    });
-}
-/**
- * @deprecated Classifies two `PublicationRef`s; use the release `compareReferences` from
- * `@astrale-os/kernel-protocol/release` (added with `DomainRelease` v4).
- */
-export function compareReferences(input, expected) {
-    if (input.origin !== expected.origin)
-        return 'origin-drift';
-    if (input.identity.issuer !== expected.identity.issuer ||
-        input.identity.subject !== expected.identity.subject) {
-        return 'identity-drift';
-    }
-    if (input.revision !== expected.revision)
-        return 'schema-drift';
-    return input.etag === expected.etag ? 'exact' : 'same-schema';
-}
-/**
- * @deprecated Compares a v2/v3 Publication with a `PublicationRef`; use
- * `compareReferences(reference(release), expected)` from `@astrale-os/kernel-protocol/release`
- * (added with `DomainRelease` v4).
- */
-export function compareReference(input, expected) {
-    return compareReferences(reference(input), expected);
-}
-/**
- * @deprecated Matches a v2/v3 Publication with a `PublicationRef`; use the release
- * `matchesReference` from `@astrale-os/kernel-protocol/release` (added with `DomainRelease` v4).
- */
-export function matchesReference(input, expected) {
-    return compareReference(input, expected) === 'exact';
-}
-function acceptIssuer(input) {
-    if (typeof input !== 'string') {
-        fail('PUBLICATION_INVALID', 'Publication reference issuer is invalid.');
-    }
-    try {
-        return acceptIssuerId(input);
-    }
-    catch (cause) {
-        if (cause instanceof AuthValueError) {
-            return fail('PUBLICATION_INVALID', 'Publication reference issuer is invalid.', cause);
-        }
-        throw cause;
-    }
-}

package/dist/release/legacy/requirements.d.ts

@@ -1,30 +0,0 @@
-import type { schema } from '@astrale-os/kernel-dsl/v1';
-import * as requirements from '../requirements.js';
-/** @deprecated Use `NonEmpty` from `@astrale-os/kernel-protocol/release`. */
-export type NonEmpty<Value> = requirements.NonEmpty<Value>;
-/** @deprecated Use `ClassOperation` from `@astrale-os/kernel-protocol/release`. */
-export type ClassOperation = requirements.ClassOperation;
-/** @deprecated Use `ClassCapabilityRequirement` from `@astrale-os/kernel-protocol/release`. */
-export type ClassCapabilityRequirement = requirements.ClassCapabilityRequirement;
-/** @deprecated Use `CapabilityAuthorityRequirements` from `@astrale-os/kernel-protocol/release`. */
-export type CapabilityAuthorityRequirements = requirements.CapabilityAuthorityRequirements;
-/** @deprecated Use `CapabilityRequirements` from `@astrale-os/kernel-protocol/release`. */
-export type CapabilityRequirements = requirements.CapabilityRequirements;
-/** @deprecated Use `CoreCapabilityRequirement` from `@astrale-os/kernel-protocol/release`. */
-export type CoreCapabilityRequirement = requirements.CoreCapabilityRequirement;
-/** @deprecated Use `Requirements` from `@astrale-os/kernel-protocol/release`. */
-export type PublicationRequirements = requirements.Requirements;
-/**
- * Admit the exact closed canonical requirements object used by Publication v3.
- *
- * @deprecated Use `admitRequirements` from `@astrale-os/kernel-protocol/release`, which reports
- * `ReleaseError`.
- */
-export declare function admitRequirements(input: unknown): PublicationRequirements;
-/**
- * Bind explicit capability targets to exact functional dependencies in the bundle closure.
- *
- * @deprecated Use `validateRequirements` from `@astrale-os/kernel-protocol/release`, which reports
- * `ReleaseError`.
- */
-export declare function validateRequirements(root: schema.DomainSchema, closure: readonly schema.DomainSchema[], input: PublicationRequirements): void;

package/dist/release/legacy/requirements.js

@@ -1,20 +0,0 @@
-import * as requirements from '../requirements.js';
-import { withPublicationError } from './error.js';
-/**
- * Admit the exact closed canonical requirements object used by Publication v3.
- *
- * @deprecated Use `admitRequirements` from `@astrale-os/kernel-protocol/release`, which reports
- * `ReleaseError`.
- */
-export function admitRequirements(input) {
-    return withPublicationError(() => requirements.admitRequirements(input));
-}
-/**
- * Bind explicit capability targets to exact functional dependencies in the bundle closure.
- *
- * @deprecated Use `validateRequirements` from `@astrale-os/kernel-protocol/release`, which reports
- * `ReleaseError`.
- */
-export function validateRequirements(root, closure, input) {
-    withPublicationError(() => requirements.validateRequirements(root, closure, input));
-}

package/dist/routes/legacy/index.d.ts

@@ -1,29 +0,0 @@
-/**
- * Native routes bound to a v2/v3 Publication and its ETag. Binding also reserves `release.json`
- * to prevent routes from shadowing the release document.
- * Superseded by release-based Tables and routing from `@astrale-os/kernel-protocol/routes`.
- *
- * Short-term consumers: every destination sealed from a v2/v3 Publication, the legacy stable
- * Workers and the SDK's v3 seal and preflight (`legacy.bind`, `legacy.verifyTable`,
- * `legacy.Table`, adopted at its Kernel pin bump), and the Server's Publication-backed native
- * routes (`server/routes/routes.ts`, `server/release/legacy/`) that serve them.
- *
- * Removal, in a separate breaking release: the conditions of `protocol/release/legacy/index.ts`
- * hold (no stable Worker serves a v2/v3 document, no installation pins one) and every supported
- * client relays `Via`. Then delete, in the same PR:
- * - this folder with its tests and laws, the `legacy` namespace and `HTTP_ROUTE_PUBLICATION`
- *   re-export of `routes/index.ts`, and the `./routes/legacy` subpaths (source and `dist`) of
- *   `protocol/package.json`;
- * - the projection branch of the canonical `decodeRouting` (`routing.ts`) with
- *   `ServedReferences.projection`, so stale reports the release digest as `current`, and the
- *   projection vectors of TEST-DECODES-ROUTING-BY-SERVED-REFERENCE;
- * - the Publication-backed native routes of the Server (`server/routes/routes.ts`,
- *   `server/release/legacy/`, and #508 in `server/invocation/legacy/`), which read this module;
- * - rebase `protocol/__tests__/publication-routes.test.ts`, which exercises the shared compile,
- *   placement and reservation laws through this Table, on the release Table;
- * - `ServedReferences.projection` from law PROTOCOL-LEGACY-WIRE-FIELDS and its test.
- * The shared entry mechanics (`entries.ts`, `header.ts`) and `reservation.ts` stay: they carry no
- * document label.
- */
-export { acceptTable, bind, verifyTable, type Table } from './table.js';
-export { decode, decodeRouting, HTTP_ROUTE_PUBLICATION } from './routing.js';

package/dist/routes/legacy/index.js

@@ -1,29 +0,0 @@
-/**
- * Native routes bound to a v2/v3 Publication and its ETag. Binding also reserves `release.json`
- * to prevent routes from shadowing the release document.
- * Superseded by release-based Tables and routing from `@astrale-os/kernel-protocol/routes`.
- *
- * Short-term consumers: every destination sealed from a v2/v3 Publication, the legacy stable
- * Workers and the SDK's v3 seal and preflight (`legacy.bind`, `legacy.verifyTable`,
- * `legacy.Table`, adopted at its Kernel pin bump), and the Server's Publication-backed native
- * routes (`server/routes/routes.ts`, `server/release/legacy/`) that serve them.
- *
- * Removal, in a separate breaking release: the conditions of `protocol/release/legacy/index.ts`
- * hold (no stable Worker serves a v2/v3 document, no installation pins one) and every supported
- * client relays `Via`. Then delete, in the same PR:
- * - this folder with its tests and laws, the `legacy` namespace and `HTTP_ROUTE_PUBLICATION`
- *   re-export of `routes/index.ts`, and the `./routes/legacy` subpaths (source and `dist`) of
- *   `protocol/package.json`;
- * - the projection branch of the canonical `decodeRouting` (`routing.ts`) with
- *   `ServedReferences.projection`, so stale reports the release digest as `current`, and the
- *   projection vectors of TEST-DECODES-ROUTING-BY-SERVED-REFERENCE;
- * - the Publication-backed native routes of the Server (`server/routes/routes.ts`,
- *   `server/release/legacy/`, and #508 in `server/invocation/legacy/`), which read this module;
- * - rebase `protocol/__tests__/publication-routes.test.ts`, which exercises the shared compile,
- *   placement and reservation laws through this Table, on the release Table;
- * - `ServedReferences.projection` from law PROTOCOL-LEGACY-WIRE-FIELDS and its test.
- * The shared entry mechanics (`entries.ts`, `header.ts`) and `reservation.ts` stay: they carry no
- * document label.
- */
-export { acceptTable, bind, verifyTable } from './table.js';
-export { decode, decodeRouting, HTTP_ROUTE_PUBLICATION } from './routing.js';

package/dist/routes/legacy/routing.d.ts

@@ -1,24 +0,0 @@
-import type { Domain } from '@astrale-os/kernel-dsl/v1';
-import type { PublicationVia } from '../../invocation/index.js';
-import type { PublicationRef } from '../../release/legacy/reference.js';
-import type { HttpRequest, Invocation } from '../request.js';
-import type { Route } from '../table.js';
-/**
- * The If-Match header native routing reads, named for the Publication ETag it carried.
- *
- * @deprecated Successor: `HTTP_ROUTE_DIGEST`, the same header named for the routed digest.
- */
-export declare const HTTP_ROUTE_PUBLICATION: "if-match";
-/**
- * Decode only the native strong If-Match representation of Publication routing, served by a
- * v3-input destination; a mismatched ETag is invalid here because the Server answers stale first.
- *
- * @deprecated Successor: `decodeRouting`, which serves a release and its v3 projection.
- */
-export declare function decodeRouting(input: Pick<HttpRequest, 'headers'>, publication: PublicationRef): PublicationVia | undefined;
-/**
- * Decode one native route request served by a v3-input destination.
- *
- * @deprecated Successor: `decode`, which serves a release and its v3 projection.
- */
-export declare function decode(entry: Route, request: HttpRequest, domain: Domain, served: PublicationRef): Invocation;

package/dist/routes/legacy/routing.js

@@ -1,45 +0,0 @@
-import { decodeInvocation } from '../decode.js';
-import { fail } from '../error.js';
-import { acceptIssuerHeader, reservedHeader, strongDigest } from '../header.js';
-import { HTTP_ROUTE_DIGEST, HTTP_ROUTE_ISSUER } from '../routing.js';
-/**
- * The If-Match header native routing reads, named for the Publication ETag it carried.
- *
- * @deprecated Successor: `HTTP_ROUTE_DIGEST`, the same header named for the routed digest.
- */
-export const HTTP_ROUTE_PUBLICATION = HTTP_ROUTE_DIGEST;
-/**
- * Decode only the native strong If-Match representation of Publication routing, served by a
- * v3-input destination; a mismatched ETag is invalid here because the Server answers stale first.
- *
- * @deprecated Successor: `decodeRouting`, which serves a release and its v3 projection.
- */
-export function decodeRouting(input, publication) {
-    const encodedEtag = reservedHeader(input.headers, HTTP_ROUTE_DIGEST);
-    const encodedIssuer = reservedHeader(input.headers, HTTP_ROUTE_ISSUER);
-    if (encodedEtag === undefined && encodedIssuer === undefined)
-        return undefined;
-    if (encodedEtag === undefined || encodedIssuer === undefined) {
-        fail('NATIVE_ROUTE_ROUTING_INVALID', `${HTTP_ROUTE_DIGEST} and ${HTTP_ROUTE_ISSUER} must occur together.`);
-    }
-    const etag = strongDigest(encodedEtag);
-    if (etag === undefined) {
-        fail('NATIVE_ROUTE_ROUTING_INVALID', 'If-Match must contain exactly one strong quoted Publication ETag.');
-    }
-    if (etag !== publication.etag) {
-        fail('NATIVE_ROUTE_ROUTING_INVALID', 'If-Match does not name the compiled Publication.');
-    }
-    return Object.freeze({
-        kind: 'via',
-        publication,
-        issuer: acceptIssuerHeader(encodedIssuer, HTTP_ROUTE_ISSUER),
-    });
-}
-/**
- * Decode one native route request served by a v3-input destination.
- *
- * @deprecated Successor: `decode`, which serves a release and its v3 projection.
- */
-export function decode(entry, request, domain, served) {
-    return decodeInvocation(entry, request, domain, (input) => decodeRouting(input, served));
-}

package/dist/routes/legacy/table.d.ts

@@ -1,34 +0,0 @@
-import type { Domain } from '@astrale-os/kernel-dsl/v1';
-import type { Publication } from '../../release/legacy/publication.js';
-import type { PublicationRef } from '../../release/legacy/reference.js';
-import type { Plan } from '../plan.js';
-import type { Route } from '../table.js';
-/**
- * Serving proof tied to one exact v2/v3 Publication and its resolved Domain.
- *
- * @deprecated Successor: `Table`, bound to the `ReleaseRef` of a `DomainRelease`.
- */
-export interface Table {
-    readonly publication: PublicationRef;
-    readonly entries: readonly Route[];
-}
-/**
- * Bind one Plan to an exact placed Publication and matching resolved Domain. Like the release
- * Table, it also reserves `release.json`, so a v3 Domain cannot claim the document a v4 Kernel
- * reads first.
- *
- * @deprecated Successor: `bind`, which binds a `DomainRelease`.
- */
-export declare function bind(plan: Plan, deployed: Publication, domain: Domain, publicUrl?: string): Table;
-/**
- * Admit one emitted portable Publication Table before Server composition.
- *
- * @deprecated Successor: `acceptTable`, which admits a release Table.
- */
-export declare function acceptTable(input: unknown): Table;
-/**
- * Verify exact Publication bytes and callable meaning before Server trusts one Table.
- *
- * @deprecated Successor: `verifyTable`, which verifies a release Table.
- */
-export declare function verifyTable(table: Table, deployed: Publication, domain: Pick<Domain, 'origin' | 'revision' | 'callable'>): Table;

package/dist/routes/legacy/table.js

@@ -1,50 +0,0 @@
-import { withPublicationError } from '../../release/legacy/error.js';
-import { acceptReference, compareReferences, reference } from '../../release/legacy/reference.js';
-import { acceptEntries, placedEntries, placementMismatch, sameServedWire, tableObject, verifyMeaning, } from '../entries.js';
-import { fail } from '../error.js';
-import { rejectReserved } from '../reservation.js';
-/**
- * Bind one Plan to an exact placed Publication and matching resolved Domain. Like the release
- * Table, it also reserves `release.json`, so a v3 Domain cannot claim the document a v4 Kernel
- * reads first.
- *
- * @deprecated Successor: `bind`, which binds a `DomainRelease`.
- */
-export function bind(plan, deployed, domain, publicUrl = deployed.identity.issuer) {
-    const mismatch = placementMismatch(plan, deployed, domain, publicUrl);
-    if (mismatch === 'identity') {
-        fail('NATIVE_ROUTE_BINDING_INVALID', 'Route Plan, Publication, and Domain identity differ.');
-    }
-    if (mismatch === 'routes') {
-        fail('NATIVE_ROUTE_BINDING_INVALID', 'Publication routes differ from the placed Route Plan.');
-    }
-    const entries = placedEntries(plan, deployed);
-    withPublicationError(() => rejectReserved(deployed, entries));
-    return Object.freeze({ publication: reference(deployed), entries });
-}
-/**
- * Admit one emitted portable Publication Table before Server composition.
- *
- * @deprecated Successor: `acceptTable`, which admits a release Table.
- */
-export function acceptTable(input) {
-    const value = tableObject(input, ['publication', 'entries']);
-    const publication = acceptReference(value.publication);
-    return Object.freeze({
-        publication,
-        entries: withPublicationError(() => acceptEntries(value.entries, publication.origin)),
-    });
-}
-/**
- * Verify exact Publication bytes and callable meaning before Server trusts one Table.
- *
- * @deprecated Successor: `verifyTable`, which verifies a release Table.
- */
-export function verifyTable(table, deployed, domain) {
-    if (compareReferences(table.publication, reference(deployed)) !== 'exact' ||
-        !sameServedWire(table.entries, deployed, domain)) {
-        fail('NATIVE_ROUTE_BINDING_INVALID', 'Route Table evidence differs from its Publication.');
-    }
-    verifyMeaning(table.entries, domain);
-    return table;
-}

package/dist/schema/installation/legacy/index.d.ts

@@ -1,39 +0,0 @@
-/**
- * Read-only decoders for the schema evidence of Hosts older than beta.127: MessagePack
- * installation v1 (`application/vnd.astrale.schema-installation.v1+msgpack`) and introspection v2
- * (`application/vnd.astrale.schema-introspection.v2+msgpack`). Each decodes its bytes into the same
- * wire value as the canonical JSON evidence and admits it with the canonical checks, so it returns
- * exactly the canonical `InstallResult` and introspection results. Nothing here encodes: Servers
- * emit only the canonical JSON evidence.
- *
- * @deprecated Use `installation.decode` / `installation.introspection.decode` with their
- * `MEDIA_TYPE`, the JSON evidence every Host from beta.127 serves.
- *
- * Short-term consumers, all through `@astrale-os/kernel-client` `SchemaApi`, which selects these
- * decoders by the received media type:
- * - Admin managing the 1Pact Host (Kernel beta.117) and the astrale Hosts on beta.121 and beta.126
- *   (`schema.inspect` before every Manager call, child `install`/`inspect`, `bundle` reads);
- * - the CLI used by 1Pact developers, and `adapter-astrale` 0.5.0-beta.148, which runs
- *   `astrale introspect` before every 1Pact deploy (`introspect`, `view`,
- *   `domain install --direct`, cold-cache `call`);
- * - the Console back-office (`schema.bundle` of every installed Domain);
- * - SDK Project tooling (`pnpm dev`, the Environment installation reconcile), which runs
- *   `astrale introspect` and `astrale domain install --direct` through that same CLI against our
- *   beta.121 and beta.126 Hosts.
- *
- * Removal, in a separate breaking release: once no supported Host is older than beta.127 (the
- * 1Pact Host upgraded; astrale-01, shared-01 and admin-users replaced or upgraded). Then delete, in
- * the same PR:
- * - this folder with its tests, golden evidence and laws, its `legacy/` entry in
- *   `../.spec/layout.ts`, and the `./schema/installation/legacy` subpaths (source and `dist`) of
- *   `protocol/package.json` with the `schema/installation/legacy/**` include of
- *   `protocol/tsconfig.json`;
- * - the legacy media-type branches of `client/schema/schema.ts` and
- *   `client/schema/introspection.ts`, and `client/schema/__tests__/legacy-evidence.test.ts`;
- * - the legacy paragraphs of `client/schema/.spec/architecture.md` and
- *   `../.spec/architecture.md`;
- * - the package-private exports of `../codec.ts` (`accept`) and `../introspection/codec.ts`
- *   (`acceptEvidence`, `admitLimits`, `admitRequest`), which return to module scope.
- */
-export { MEDIA_TYPE, decode } from './installation.js';
-export * as introspection from './introspection.js';

package/dist/schema/installation/legacy/index.js

@@ -1,39 +0,0 @@
-/**
- * Read-only decoders for the schema evidence of Hosts older than beta.127: MessagePack
- * installation v1 (`application/vnd.astrale.schema-installation.v1+msgpack`) and introspection v2
- * (`application/vnd.astrale.schema-introspection.v2+msgpack`). Each decodes its bytes into the same
- * wire value as the canonical JSON evidence and admits it with the canonical checks, so it returns
- * exactly the canonical `InstallResult` and introspection results. Nothing here encodes: Servers
- * emit only the canonical JSON evidence.
- *
- * @deprecated Use `installation.decode` / `installation.introspection.decode` with their
- * `MEDIA_TYPE`, the JSON evidence every Host from beta.127 serves.
- *
- * Short-term consumers, all through `@astrale-os/kernel-client` `SchemaApi`, which selects these
- * decoders by the received media type:
- * - Admin managing the 1Pact Host (Kernel beta.117) and the astrale Hosts on beta.121 and beta.126
- *   (`schema.inspect` before every Manager call, child `install`/`inspect`, `bundle` reads);
- * - the CLI used by 1Pact developers, and `adapter-astrale` 0.5.0-beta.148, which runs
- *   `astrale introspect` before every 1Pact deploy (`introspect`, `view`,
- *   `domain install --direct`, cold-cache `call`);
- * - the Console back-office (`schema.bundle` of every installed Domain);
- * - SDK Project tooling (`pnpm dev`, the Environment installation reconcile), which runs
- *   `astrale introspect` and `astrale domain install --direct` through that same CLI against our
- *   beta.121 and beta.126 Hosts.
- *
- * Removal, in a separate breaking release: once no supported Host is older than beta.127 (the
- * 1Pact Host upgraded; astrale-01, shared-01 and admin-users replaced or upgraded). Then delete, in
- * the same PR:
- * - this folder with its tests, golden evidence and laws, its `legacy/` entry in
- *   `../.spec/layout.ts`, and the `./schema/installation/legacy` subpaths (source and `dist`) of
- *   `protocol/package.json` with the `schema/installation/legacy/**` include of
- *   `protocol/tsconfig.json`;
- * - the legacy media-type branches of `client/schema/schema.ts` and
- *   `client/schema/introspection.ts`, and `client/schema/__tests__/legacy-evidence.test.ts`;
- * - the legacy paragraphs of `client/schema/.spec/architecture.md` and
- *   `../.spec/architecture.md`;
- * - the package-private exports of `../codec.ts` (`accept`) and `../introspection/codec.ts`
- *   (`acceptEvidence`, `admitLimits`, `admitRequest`), which return to module scope.
- */
-export { MEDIA_TYPE, decode } from './installation.js';
-export * as introspection from './introspection.js';

package/dist/schema/installation/legacy/installation.d.ts

@@ -1,9 +0,0 @@
-import type { InstallResult } from '../result.js';
-/** @deprecated Read-only: Hosts older than beta.127 serve this; current Hosts serve `installation.MEDIA_TYPE`. */
-export declare const MEDIA_TYPE: 'application/vnd.astrale.schema-installation.v1+msgpack';
-/**
- * Decode version-one (MessagePack) installation evidence into the canonical result.
- *
- * @deprecated Read-only; use `installation.decode` with `installation.MEDIA_TYPE`.
- */
-export declare function decode(bytes: Uint8Array, maximumBytes: number): Promise<InstallResult>;

package/dist/schema/installation/legacy/installation.js

@@ -1,28 +0,0 @@
-import { accept as acceptValue, defaultLimits } from '@astrale-os/kernel-dsl/value';
-import { accept } from '../codec.js';
-import { decode as decodeMessagePack } from './msgpack.js';
-/** @deprecated Read-only: Hosts older than beta.127 serve this; current Hosts serve `installation.MEDIA_TYPE`. */
-export const MEDIA_TYPE = 'application/vnd.astrale.schema-installation.v1+msgpack';
-/**
- * Decode version-one (MessagePack) installation evidence into the canonical result.
- *
- * @deprecated Read-only; use `installation.decode` with `installation.MEDIA_TYPE`.
- */
-export async function decode(bytes, maximumBytes) {
-    if (!(bytes instanceof Uint8Array) ||
-        !Number.isSafeInteger(maximumBytes) ||
-        maximumBytes < 1 ||
-        bytes.byteLength > maximumBytes) {
-        throw new TypeError('Schema installation evidence is invalid or exceeds its bound.');
-    }
-    let value;
-    try {
-        value = acceptValue(decodeMessagePack(bytes, defaultLimits.maxDepth), {
-            limits: { maxBytes: maximumBytes },
-        });
-    }
-    catch (cause) {
-        throw new TypeError('Schema installation evidence is malformed.', { cause });
-    }
-    return accept(value);
-}