@astrale-os/kernel-protocol 0.5.0-beta.3 → 0.5.0-beta.31

package/dist/publication/index.d.ts

@@ -1,14 +1,17 @@
-export { MEDIA_TYPE, PATH, url, seal, accept, encode, acceptBundle, decodeBundle, type Publication, } from './publication.js';
+export { MEDIA_TYPE, PATH, url, seal, accept, acceptStored, encode, type Publication, type StoredPublication, } from './publication.js';
+export { acceptBundle, decodeBundle } from './bundle-admission.js';
 export { BUNDLE_MEDIA_TYPE, describeBundle, type BundleDescriptor } from './bundle.js';
+export { verifyBundleBytes } from './bundle-evidence.js';
 export type { Content } from './content.js';
+export type { Declaration, DeliveryDeclaration } from './declaration.js';
+export { placeDelivery } from './delivery-declaration.js';
 export type { Etag, Sha256Digest } from './etag.js';
 export { PublicationError, type PublicationErrorCode } from './error.js';
 export * as delivery from './delivery/index.js';
 export type { Authentication as DeliveryAuthentication, Endpoint as DeliveryEndpoint, } from './delivery-endpoint.js';
 export type { Manifest } from './manifest.js';
-export { ClassOperationOrder, admitRequirements, validateRequirements, type CapabilityAdminRequirements, type CapabilityRequirements, type ClassCapabilityRequirement, type ClassOperation, type NonEmpty, type PublicationRequirements, } from './requirements.js';
+export { ClassOperationOrder, admitRequirements, validateRequirements, type CapabilityAuthorityRequirements, type CapabilityProfileRequirement, type CapabilityRequirements, type ClassCapabilityRequirement, type ClassOperation, type NonEmpty, type PublicationRequirements, } from './requirements.js';
 export { acceptReference, compareReference, compareReferences, matchesReference, reference, type PublicationRef, type PublicationReferenceRelation, } from './reference.js';
-export type { BodyPick, CredentialSource, HttpMethod, HttpRoute, RouteBody, RouteHeaders, SingleCredentialSource, } from './route.js';
+export type { BodyPick, CredentialSource, HttpMethod, HttpRoute, HttpRouteDeclaration, RouteBody, RouteHeaders, SingleCredentialSource, } from './route.js';
 export type { Schema } from './schema.js';
-export { acceptInvocationEndpoints, type CallableBinding, type InvocationEndpoints, type ViewBinding, } from './bindings/index.js';
-//# sourceMappingURL=index.d.ts.map
+export { acceptInvocationEndpoints, type CallableBinding, type IframeRequirements, type InvocationEndpoints, type ViewBinding, } from './bindings/index.js';

package/dist/publication/index.js

@@ -1,8 +1,10 @@
-export { MEDIA_TYPE, PATH, url, seal, accept, encode, acceptBundle, decodeBundle, } from './publication.js';
+export { MEDIA_TYPE, PATH, url, seal, accept, acceptStored, encode, } from './publication.js';
+export { acceptBundle, decodeBundle } from './bundle-admission.js';
 export { BUNDLE_MEDIA_TYPE, describeBundle } from './bundle.js';
+export { verifyBundleBytes } from './bundle-evidence.js';
+export { placeDelivery } from './delivery-declaration.js';
 export { PublicationError } from './error.js';
 export * as delivery from './delivery/index.js';
 export { ClassOperationOrder, admitRequirements, validateRequirements, } from './requirements.js';
 export { acceptReference, compareReference, compareReferences, matchesReference, reference, } from './reference.js';
 export { acceptInvocationEndpoints, } from './bindings/index.js';
-//# sourceMappingURL=index.js.map

package/dist/publication/manifest.d.ts

@@ -1,7 +1,6 @@
-import { Ref } from '@astrale-os/kernel-dsl/v1';
+import { type ViewRef } from '@astrale-os/kernel-dsl/v1/addressing';
 export interface Manifest {
     readonly logo?: string;
-    readonly entrypoint?: Ref.View;
+    readonly entrypoint?: ViewRef;
 }
 export declare function admitManifest(input: unknown): Manifest | undefined;
-//# sourceMappingURL=manifest.d.ts.map

package/dist/publication/manifest.js

@@ -1,4 +1,4 @@
-import { Ref } from '@astrale-os/kernel-dsl/v1';
+import { acceptDefinitionRef } from '@astrale-os/kernel-dsl/v1/addressing';
 import { exact, record } from './content.js';
 import { fail } from './error.js';
 export function admitManifest(input) {
@@ -11,16 +11,20 @@ export function admitManifest(input) {
     }
     let entrypoint;
     if (value.entrypoint !== undefined) {
-        if (typeof value.entrypoint !== 'string' ||
-            !Ref.isDefinition(value.entrypoint) ||
-            !value.entrypoint.startsWith('view.')) {
+        let ref;
+        try {
+            ref = acceptDefinitionRef(value.entrypoint);
+        }
+        catch (cause) {
+            return fail('PUBLICATION_INVALID', 'Manifest entrypoint must be a root View reference.', cause);
+        }
+        if (ref.kind !== 'view') {
             fail('PUBLICATION_INVALID', 'Manifest entrypoint must be a root View reference.');
         }
-        entrypoint = value.entrypoint;
+        entrypoint = ref;
     }
     return Object.freeze({
         ...(value.logo === undefined ? {} : { logo: value.logo }),
         ...(entrypoint === undefined ? {} : { entrypoint }),
     });
 }
-//# sourceMappingURL=manifest.js.map

package/dist/publication/publication.d.ts

@@ -1,5 +1,5 @@
-import * as auth from '@astrale-os/kernel-core/auth';
-import { Key, bundle as dslBundle } from '@astrale-os/kernel-dsl/v1';
+import { type IssuerId } from '@astrale-os/kernel-core/auth/issuer';
+import { Key } from '@astrale-os/kernel-dsl/v1/addressing';
 import type { CallableBinding, ViewBinding } from './bindings/index.js';
 import type { Content } from './content.js';
 import type { Endpoint as DeliveryEndpoint } from './delivery-endpoint.js';
@@ -17,7 +17,7 @@ export interface Publication {
     readonly version: 2;
     readonly origin: Key.Origin;
     readonly identity: {
-        readonly issuer: auth.IssuerId;
+        readonly issuer: IssuerId;
         readonly subject: string;
     };
     readonly etag: Etag;
@@ -31,9 +31,16 @@ export interface Publication {
     readonly routes: readonly HttpRoute[];
     readonly delivery?: DeliveryEndpoint;
 }
+/** Canonical semantic Publication plus its exact coordinate in durable storage. */
+export interface StoredPublication {
+    readonly publication: Publication;
+    readonly deployedEtag: Etag;
+}
 export declare function seal(input: Content): Publication;
 export declare function accept(input: unknown): Publication;
+/**
+ * Admit a canonical Publication retained before the admin-to-authority vocabulary cutover.
+ * Network admission remains strict; this one-way reader exists only for already-trusted storage.
+ */
+export declare function acceptStored(input: unknown): StoredPublication;
 export declare function encode(input: Publication): Uint8Array;
-export declare function acceptBundle(input: Publication, artifact: unknown): dslBundle.Bundle;
-export declare function decodeBundle(input: Publication, bytes: Uint8Array): dslBundle.Bundle;
-//# sourceMappingURL=publication.d.ts.map

package/dist/publication/publication.js

@@ -1,14 +1,15 @@
-import * as auth from '@astrale-os/kernel-core/auth';
-import { Key, Ref, bundle as dslBundle, schema as dslSchema, } from '@astrale-os/kernel-dsl/v1';
+import { AuthValueError } from '@astrale-os/kernel-core/auth/error';
+import { accept as acceptIssuerId } from '@astrale-os/kernel-core/auth/issuer';
+import { Key, patterns } from '@astrale-os/kernel-dsl/v1/addressing';
 import * as portable from '@astrale-os/kernel-dsl/value';
 import { admitCallableBinding, admitViewBinding } from './bindings/index.js';
-import { acceptBundleValue, decodeBundleValue, verifyBundleBytes } from './bundle.js';
+import { canonicalizeViewBinding } from './bindings/view.js';
 import { array, deepFreeze, exact, record, unique } from './content.js';
 import { admitEndpoint as admitDeliveryEndpoint } from './delivery-endpoint.js';
 import { fail } from './error.js';
 import { admitDigest, computeEtag } from './etag.js';
 import { admitManifest } from './manifest.js';
-import { admitRequirements, validateRequirements } from './requirements.js';
+import { admitRequirements } from './requirements.js';
 import { admitRoute } from './route.js';
 import { admitSchema } from './schema.js';
 export const PATH = '/.well-known/astrale/domain.json';
@@ -33,7 +34,8 @@ export function url(input) {
     return `${admitted.replace(/\/+$/u, '')}${PATH}`;
 }
 export function seal(input) {
-    return acceptPublication({ ...input, etag: computeEtag(input) }, false);
+    const canonical = withoutEtag(acceptPublication({ ...input, etag: 'canonicalizing' }, false, true));
+    return acceptPublication({ ...canonical, etag: computeEtag(canonical) }, false);
 }
 export function accept(input) {
     const publication = acceptPublication(input, true);
@@ -42,21 +44,44 @@ export function accept(input) {
     }
     return publication;
 }
+/**
+ * Admit a canonical Publication retained before the admin-to-authority vocabulary cutover.
+ * Network admission remains strict; this one-way reader exists only for already-trusted storage.
+ */
+export function acceptStored(input) {
+    try {
+        const publication = accept(input);
+        return deepFreeze({ publication, deployedEtag: publication.etag });
+    }
+    catch (currentFailure) {
+        const value = record(input, 'PUBLICATION_INVALID', 'Expected a Publication object.');
+        const requirements = record(value.requirements, 'PUBLICATION_INVALID', 'Publication requirements are invalid.');
+        const capabilities = record(requirements.capabilities, 'PUBLICATION_INVALID', 'Publication capability requirements are invalid.');
+        if (capabilities.admin === undefined)
+            throw currentFailure;
+        if (capabilities.authority !== undefined) {
+            fail('PUBLICATION_INVALID', 'Publication cannot mix admin and authority requirements.');
+        }
+        const { etag, ...content } = value;
+        const admittedEtag = admitDigest(etag);
+        if (admittedEtag !== computeEtag(content)) {
+            fail('PUBLICATION_ETAG_MISMATCH', 'Publication ETag does not match its canonical content.');
+        }
+        const { admin, ...currentCapabilities } = capabilities;
+        const admitted = acceptPublication({
+            ...value,
+            requirements: {
+                ...requirements,
+                capabilities: { ...currentCapabilities, authority: admin },
+            },
+        }, true);
+        return deepFreeze({ publication: seal(withoutEtag(admitted)), deployedEtag: admittedEtag });
+    }
+}
 export function encode(input) {
     return portable.json.encode(input);
 }
-export function acceptBundle(input, artifact) {
-    const accepted = acceptBundleValue(artifact);
-    verifyBundleBytes(input, dslBundle.encode(accepted));
-    validateBundleInventory(input, accepted);
-    return accepted;
-}
-export function decodeBundle(input, bytes) {
-    const decoded = decodeBundleValue(input, bytes);
-    validateBundleInventory(input, decoded);
-    return decoded;
-}
-function acceptPublication(input, requireEtag) {
+function acceptPublication(input, requireEtag, canonicalizeViews = false) {
     const value = record(input, 'PUBLICATION_INVALID', 'Expected a Publication object.');
     exact(value, [
         'format',
@@ -74,7 +99,7 @@ function acceptPublication(input, requireEtag) {
     if (value.format !== 'astrale.domain.publication' || value.version !== 2) {
         fail('PUBLICATION_INVALID', 'Unsupported Publication format or version.');
     }
-    if (typeof value.origin !== 'string' || !dslSchema.patterns.origin.test(value.origin)) {
+    if (typeof value.origin !== 'string' || !patterns.origin.test(value.origin)) {
         fail('PUBLICATION_INVALID', 'Publication origin is invalid.');
     }
     const origin = value.origin;
@@ -91,7 +116,7 @@ function acceptPublication(input, requireEtag) {
     exact(bindingSet, ['callables', 'views'], 'PUBLICATION_BINDING_INVALID');
     const callables = array(bindingSet.callables, 'PUBLICATION_BINDING_INVALID').map((entry) => admitCallableBinding(entry, origin));
     unique(callables.map(({ callable }) => callable), 'PUBLICATION_BINDING_INVALID', 'callable binding');
-    const views = array(bindingSet.views, 'PUBLICATION_VIEW_INVALID').map((entry) => admitViewBinding(entry, origin));
+    const views = array(bindingSet.views, 'PUBLICATION_VIEW_INVALID').map((entry) => canonicalizeViews ? canonicalizeViewBinding(entry, origin) : admitViewBinding(entry, origin));
     unique(views.map(({ view }) => view), 'PUBLICATION_VIEW_INVALID', 'View binding');
     const routes = array(value.routes, 'PUBLICATION_ROUTE_INVALID').map((entry) => admitRoute(entry, origin));
     unique(routes.map(({ name }) => name), 'PUBLICATION_ROUTE_INVALID', 'route name');
@@ -101,7 +126,10 @@ function acceptPublication(input, requireEtag) {
         }
     }
     if (manifest?.entrypoint !== undefined) {
-        const key = Key.of(origin, manifest.entrypoint);
+        if (manifest.entrypoint.origin !== origin) {
+            fail('PUBLICATION_VIEW_INVALID', 'Manifest entrypoint must belong to the root origin.');
+        }
+        const key = Key.of(manifest.entrypoint);
         if (!views.some(({ view }) => view === key)) {
             fail('PUBLICATION_VIEW_INVALID', 'Manifest entrypoint must have a published View binding.');
         }
@@ -124,60 +152,12 @@ function acceptPublication(input, requireEtag) {
         ...(delivery === undefined ? {} : { delivery }),
     });
 }
-function validateBundleInventory(publication, bundle) {
-    const root = bundle.root;
-    if (root.origin !== publication.origin ||
-        dslSchema.revision(root) !== publication.schema.revision) {
-        fail('PUBLICATION_INVALID', 'Bundle root does not match the Publication schema.');
-    }
-    validateRequirements(root, bundle.closure, publication.requirements);
-    const callables = concreteCallables(root);
-    const publishedCallables = new Set(publication.bindings.callables.map(({ callable }) => callable));
-    if (publishedCallables.size !== callables.size ||
-        [...callables].some((key) => !publishedCallables.has(key))) {
-        fail('PUBLICATION_BINDING_INVALID', 'Callable bindings must exhaust the root Domain.');
-    }
-    const views = new Set(Object.keys(root.views).map((name) => Key.of(root.origin, Ref.definition('view', name))));
-    const publishedViews = new Set(publication.bindings.views.map(({ view }) => view));
-    if (publishedViews.size !== views.size || [...views].some((key) => !publishedViews.has(key))) {
-        fail('PUBLICATION_VIEW_INVALID', 'View bindings must exhaust the root Domain.');
-    }
-    if (publication.manifest?.entrypoint !== undefined &&
-        root.views[Ref.member(publication.manifest.entrypoint)] === undefined) {
-        fail('PUBLICATION_INVALID', 'Manifest entrypoint does not exist in the root schema.');
-    }
-    for (const route of publication.routes) {
-        if (!callables.has(route.callable)) {
-            fail('PUBLICATION_ROUTE_INVALID', `Route ${route.name} names an unknown callable.`);
-        }
-    }
-}
-function concreteCallables(root) {
-    const result = new Set();
-    for (const name of Object.keys(root.functions)) {
-        result.add(Key.of(root.origin, Ref.definition('function', name)));
-    }
-    addConcreteMethods(result, root.origin, 'class', root.classes);
-    addConcreteMethods(result, root.origin, 'interface', root.interfaces);
-    return result;
-}
-function addConcreteMethods(result, origin, kind, definitions) {
-    for (const [owner, declaration] of Object.entries(definitions)) {
-        if (declaration.family !== 'node')
-            continue;
-        for (const [name, method] of Object.entries(declaration.methods)) {
-            if (method.inheritance === 'abstract')
-                continue;
-            result.add(Key.of(origin, Ref.method(Ref.definition(kind, owner), name)));
-        }
-    }
-}
 function admitIssuer(input) {
     try {
-        return auth.issuer.accept(String(input));
+        return acceptIssuerId(String(input));
     }
     catch (cause) {
-        if (cause instanceof auth.AuthValueError) {
+        if (cause instanceof AuthValueError) {
             return fail('PUBLICATION_INVALID', 'Publication issuer is invalid.', cause);
         }
         throw cause;
@@ -187,4 +167,3 @@ function withoutEtag(input) {
     const { etag: _etag, ...content } = input;
     return content;
 }
-//# sourceMappingURL=publication.js.map

package/dist/publication/reference.d.ts

@@ -1,11 +1,12 @@
-import { schema as dslSchema, type Key } from '@astrale-os/kernel-dsl/v1';
+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. */
 export interface PublicationRef {
     readonly origin: Key.Origin;
     readonly identity: Publication['identity'];
-    readonly revision: dslSchema.Revision;
+    readonly revision: Revision;
     readonly etag: Etag;
 }
 export type PublicationReferenceRelation = 'exact' | 'same-schema' | 'schema-drift' | 'identity-drift' | 'origin-drift';
@@ -14,4 +15,3 @@ export declare function acceptReference(input: unknown): PublicationRef;
 export declare function compareReferences(input: PublicationRef, expected: PublicationRef): PublicationReferenceRelation;
 export declare function compareReference(input: Publication, expected: PublicationRef): PublicationReferenceRelation;
 export declare function matchesReference(input: Publication, expected: PublicationRef): boolean;
-//# sourceMappingURL=reference.d.ts.map

package/dist/publication/reference.js

@@ -1,5 +1,6 @@
-import * as auth from '@astrale-os/kernel-core/auth';
-import { schema as dslSchema } from '@astrale-os/kernel-dsl/v1';
+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 { deepFreeze, exact, record } from './content.js';
 import { fail } from './error.js';
 import { admitDigest } from './etag.js';
@@ -14,7 +15,7 @@ export function reference(input) {
 export function acceptReference(input) {
     const value = record(input, 'PUBLICATION_INVALID', 'Publication reference is invalid.');
     exact(value, ['origin', 'identity', 'revision', 'etag'], 'PUBLICATION_INVALID');
-    if (typeof value.origin !== 'string' || !dslSchema.patterns.origin.test(value.origin)) {
+    if (typeof value.origin !== 'string' || !patterns.origin.test(value.origin)) {
         fail('PUBLICATION_INVALID', 'Publication reference origin is invalid.');
     }
     const origin = value.origin;
@@ -24,7 +25,7 @@ export function acceptReference(input) {
     if (identity.subject !== origin) {
         fail('PUBLICATION_INVALID', 'Publication reference subject must equal its root origin.');
     }
-    if (typeof value.revision !== 'string' || !dslSchema.patterns.revision.test(value.revision)) {
+    if (typeof value.revision !== 'string' || !patterns.revision.test(value.revision)) {
         fail('PUBLICATION_INVALID', 'Publication reference revision is invalid.');
     }
     return deepFreeze({
@@ -56,13 +57,12 @@ function acceptIssuer(input) {
         fail('PUBLICATION_INVALID', 'Publication reference issuer is invalid.');
     }
     try {
-        return auth.issuer.accept(input);
+        return acceptIssuerId(input);
     }
     catch (cause) {
-        if (cause instanceof auth.AuthValueError) {
+        if (cause instanceof AuthValueError) {
             return fail('PUBLICATION_INVALID', 'Publication reference issuer is invalid.', cause);
         }
         throw cause;
     }
 }
-//# sourceMappingURL=reference.js.map

package/dist/publication/requirements.d.ts

@@ -1,20 +1,29 @@
-import type { AuthorityOperation } from '@astrale-os/kernel-core/schema';
-import type { Key as SemanticKey, schema } from '@astrale-os/kernel-dsl/v1';
+import type { AuthorityOperation } from '@astrale-os/kernel-core/schema/authority/operation';
+import type { schema as schemaLanguage } from '@astrale-os/kernel-dsl/v1';
+import type { ClassRef, CoreRef, Key as SemanticKey } from '@astrale-os/kernel-dsl/v1/addressing';
 export type NonEmpty<Value> = readonly [Value, ...Value[]];
 export declare const ClassOperationOrder: readonly ["create", "read", "traverse", "update", "delete"];
 export type ClassOperation = (typeof ClassOperationOrder)[number];
 export interface ClassCapabilityRequirement {
-    readonly class: schema.ClassRef;
+    readonly class: ClassRef;
     readonly operations: NonEmpty<ClassOperation>;
 }
-export interface CapabilityAdminRequirements {
+export interface CapabilityAuthorityRequirements {
     readonly grant?: NonEmpty<AuthorityOperation>;
     readonly revoke?: NonEmpty<AuthorityOperation>;
 }
 export interface CapabilityRequirements {
     readonly functions?: NonEmpty<SemanticKey.Callable>;
     readonly classes?: NonEmpty<ClassCapabilityRequirement>;
-    readonly admin?: CapabilityAdminRequirements;
+    readonly authority?: CapabilityAuthorityRequirements;
+    readonly profiles?: NonEmpty<CapabilityProfileRequirement>;
+}
+/** Installation-owned authority materialized onto one local Core Identity. */
+export interface CapabilityProfileRequirement {
+    readonly subject: CoreRef;
+    readonly functions?: NonEmpty<SemanticKey.Callable>;
+    readonly classes?: NonEmpty<ClassCapabilityRequirement>;
+    readonly authority?: CapabilityAuthorityRequirements;
 }
 export interface PublicationRequirements {
     readonly capabilities: CapabilityRequirements;
@@ -22,5 +31,4 @@ export interface PublicationRequirements {
 /** Admit the exact closed Publication v2 requirements object. */
 export declare function admitRequirements(input: unknown): PublicationRequirements;
 /** Bind explicit capability targets to exact functional dependencies in the bundle closure. */
-export declare function validateRequirements(root: schema.DomainSchema, closure: readonly schema.DomainSchema[], requirements: PublicationRequirements): void;
-//# sourceMappingURL=requirements.d.ts.map
+export declare function validateRequirements(root: schemaLanguage.DomainSchema, closure: readonly schemaLanguage.DomainSchema[], requirements: PublicationRequirements): void;