@appport/sdk 1.1.19 → 1.1.20

package/vendor/@appport/core/dist/application-implementation.js

@@ -0,0 +1,220 @@
+/**
+ * Application Implementations (F6)
+ *
+ * An implementation is the executable association between an application
+ * capability, a verified source connection, and an artifact. It carries no
+ * application identity and no authorization of its own.
+ *
+ * Runtime order is unchanged by F6:
+ *
+ *   discovery → compatibility → authorization → binding
+ *       → implementation selection → materialization → execution
+ *
+ * Implementation selection therefore requires an authorized binding, and the
+ * selection is revalidated against durable authority before materialization so
+ * a serialized binding can never turn eligibility into an in-memory assumption.
+ */
+import { randomUUID } from "node:crypto";
+import { capabilityCoverageKey } from "./appboundry-contract.js";
+import { sourceIsEligible } from "./application-source.js";
+import { assertBindingAuthoritative } from "./authority-attestation.js";
+import { assertIssuedAuthorizedBinding } from "./binding.js";
+export class ApplicationImplementationConflictError extends Error {
+    constructor(id) {
+        super(`Concurrent application implementation update rejected for "${id}"`);
+        this.name = "ApplicationImplementationConflictError";
+    }
+}
+export class MemoryApplicationImplementationStore {
+    #records = new Map();
+    async get(applicationId, implementationId) {
+        const found = this.#records.get(`${applicationId}:${implementationId}`);
+        return found && structuredClone(found);
+    }
+    async put(record, expectedSequence) {
+        const key = `${record.applicationId}:${record.id}`;
+        if (this.#records.get(key)?.sequence !== expectedSequence)
+            throw new ApplicationImplementationConflictError(record.id);
+        this.#records.set(key, structuredClone(record));
+    }
+    async list(applicationId) {
+        return [...this.#records.values()]
+            .filter((record) => !applicationId || record.applicationId === applicationId)
+            .map((record) => structuredClone(record))
+            .sort((left, right) => left.id.localeCompare(right.id));
+    }
+}
+const issuedSelections = new WeakSet();
+const selectionValidators = new WeakMap();
+/** Throws unless the selection was issued by ApplicationImplementationOperations. */
+export function assertIssuedImplementationSelection(selection) {
+    if (typeof selection !== "object" || selection === null || !issuedSelections.has(selection)) {
+        throw new Error("Implementation selection was not issued by application implementation authority");
+    }
+}
+/** Revalidate the selection against durable source/implementation authority. */
+export async function assertImplementationSelectionEligible(selection) {
+    assertIssuedImplementationSelection(selection);
+    await selectionValidators.get(selection)?.();
+}
+/** The artifact must be the exact artifact the selected implementation names. */
+export function assertArtifactMatchesSelection(selection, artifact) {
+    if (artifact.contentHash !== selection.artifactHash) {
+        throw new Error(`Artifact ${artifact.contentHash} is not the selected implementation artifact ${selection.artifactHash}`);
+    }
+    if (artifact.metadata.contractFingerprint !== selection.contractFingerprint) {
+        throw new Error("Artifact contract fingerprint does not match the selected implementation");
+    }
+}
+/** Registers, revalidates and selects implementations from verified sources. */
+export class ApplicationImplementationOperations {
+    store;
+    sources;
+    authority;
+    now;
+    constructor(store, sources, authority, now = () => new Date().toISOString()) {
+        this.store = store;
+        this.sources = sources;
+        this.authority = authority;
+        this.now = now;
+    }
+    /**
+     * Register an executable implementation for a verified source.
+     *
+     * The contract fingerprint is derived from authority, never accepted from the
+     * caller, and the capability must be covered by the source connection.
+     */
+    async register(input) {
+        const authoritative = await this.#authoritative(input.applicationId);
+        const source = await this.sources.get(input.applicationId, input.sourceConnectionId);
+        if (!source)
+            throw new Error(`Unknown application source "${input.sourceConnectionId}"`);
+        if (!sourceIsEligible(source, authoritative.fingerprint)) {
+            throw new Error(`Source "${source.id}" is not a verified implementation source (${source.status})`);
+        }
+        const key = capabilityCoverageKey(input.capability);
+        if (!source.coveredCapabilities.includes(key)) {
+            throw new Error(`Source "${source.id}" does not cover capability ${key}`);
+        }
+        if (typeof input.artifactHash !== "string" || !input.artifactHash.length) {
+            throw new Error("artifactHash must be a non-empty string");
+        }
+        const at = this.now();
+        const existing = (await this.store.list(input.applicationId)).find((record) => record.sourceConnectionId === source.id &&
+            capabilityCoverageKey(record.capability) === key &&
+            record.contractFingerprint === authoritative.fingerprint);
+        const record = {
+            id: existing?.id ?? `impl_${randomUUID()}`,
+            applicationId: input.applicationId,
+            sourceConnectionId: source.id,
+            capability: { name: input.capability.name, version: input.capability.version },
+            contractFingerprint: authoritative.fingerprint,
+            artifactHash: input.artifactHash,
+            status: "verified",
+            sequence: (existing?.sequence ?? 0) + 1,
+            createdAt: existing?.createdAt ?? at,
+            verifiedAt: at
+        };
+        await this.store.put(record, existing?.sequence);
+        return record;
+    }
+    /** Revoke an implementation without touching the application or its history. */
+    async revoke(applicationId, implementationId) {
+        const current = await this.store.get(applicationId, implementationId);
+        if (!current)
+            throw new Error(`Unknown implementation "${implementationId}"`);
+        if (current.status === "revoked")
+            return current;
+        const next = { ...current, status: "revoked", sequence: current.sequence + 1 };
+        await this.store.put(next, current.sequence);
+        return next;
+    }
+    /** Mark implementations of superseded contract revisions stale. */
+    async refresh(applicationId) {
+        const authoritative = await this.#authoritative(applicationId);
+        const refreshed = [];
+        for (const record of await this.store.list(applicationId)) {
+            if (record.status !== "verified" || record.contractFingerprint === authoritative.fingerprint) {
+                refreshed.push(record);
+                continue;
+            }
+            const next = { ...record, status: "stale", sequence: record.sequence + 1 };
+            await this.store.put(next, record.sequence);
+            refreshed.push(next);
+        }
+        return refreshed;
+    }
+    /**
+     * Implementations that may currently execute a capability, in deterministic
+     * order: source identity first, then implementation identity. Selection is
+     * never timing-dependent.
+     */
+    async eligible(applicationId, capability) {
+        const authoritative = await this.#authoritative(applicationId);
+        const sources = new Map((await this.sources.list(applicationId)).map((source) => [source.id, source]));
+        const key = capabilityCoverageKey(capability);
+        return (await this.store.list(applicationId))
+            .filter((record) => this.#eligible(record, sources.get(record.sourceConnectionId), authoritative.fingerprint, key))
+            .sort((left, right) => this.#order(left, right, sources));
+    }
+    /**
+     * Select an implementation for an authorized binding.
+     *
+     * Provider resolution has already chosen the *application*; this chooses an
+     * eligible source/artifact for it. Without an authorized, still-authoritative
+     * binding there is no selection and therefore no materialization.
+     */
+    async selectForBinding(binding, capability) {
+        assertIssuedAuthorizedBinding(binding);
+        await assertBindingAuthoritative(binding);
+        const applicationId = binding.provider.id;
+        const candidates = await this.eligible(applicationId, capability);
+        const chosen = candidates[0];
+        if (!chosen) {
+            throw new Error(`No eligible implementation for ${capabilityCoverageKey(capability)} of application "${applicationId}"`);
+        }
+        const selection = {
+            implementationId: chosen.id,
+            sourceConnectionId: chosen.sourceConnectionId,
+            applicationId,
+            capability: { name: capability.name, version: capability.version },
+            contractFingerprint: chosen.contractFingerprint,
+            artifactHash: chosen.artifactHash
+        };
+        issuedSelections.add(selection);
+        selectionValidators.set(selection, () => this.#assertStillEligible(selection));
+        return selection;
+    }
+    get = (applicationId, implementationId) => this.store.get(applicationId, implementationId);
+    list = (applicationId) => this.store.list(applicationId);
+    /** Re-read durable authority and confirm the selection is still executable. */
+    async #assertStillEligible(selection) {
+        const authoritative = await this.#authoritative(selection.applicationId);
+        const record = await this.store.get(selection.applicationId, selection.implementationId);
+        const source = await this.sources.get(selection.applicationId, selection.sourceConnectionId);
+        const key = capabilityCoverageKey(selection.capability);
+        if (!record || !this.#eligible(record, source, authoritative.fingerprint, key) || record.artifactHash !== selection.artifactHash) {
+            throw new Error(`Implementation "${selection.implementationId}" is no longer an eligible implementation`);
+        }
+    }
+    #eligible(record, source, authoritativeFingerprint, capabilityKey) {
+        return (record.status === "verified" &&
+            record.contractFingerprint === authoritativeFingerprint &&
+            capabilityCoverageKey(record.capability) === capabilityKey &&
+            !!source &&
+            sourceIsEligible(source, authoritativeFingerprint) &&
+            source.coveredCapabilities.includes(capabilityKey));
+    }
+    #order(left, right, sources) {
+        const leftSource = sources.get(left.sourceConnectionId)?.repositoryIdentity ?? left.sourceConnectionId;
+        const rightSource = sources.get(right.sourceConnectionId)?.repositoryIdentity ?? right.sourceConnectionId;
+        return leftSource.localeCompare(rightSource) || left.artifactHash.localeCompare(right.artifactHash) || left.id.localeCompare(right.id);
+    }
+    async #authoritative(applicationId) {
+        const authoritative = await this.authority.get(applicationId);
+        if (!authoritative)
+            throw new Error(`Unknown application "${applicationId}"`);
+        return authoritative;
+    }
+}
+//# sourceMappingURL=application-implementation.js.map

package/vendor/@appport/core/dist/application-implementation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-implementation.js","sourceRoot":"","sources":["../src/application-implementation.ts"],"names":[],"mappings":"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"}

package/vendor/@appport/core/dist/application-lifecycle.d.ts

@@ -0,0 +1,150 @@
+import { type ApplicationManifest } from "./manifest.js";
+import type { ApplicationRegistry } from "./registration.js";
+export type ApplicationLifecyclePhase = "DRAFT" | "VALIDATED" | "REGISTERED" | "ACTIVE" | "CHANGE_PROPOSED" | "RETIRED";
+export type LifecycleEventType = "DEFINED" | "VALIDATED" | "VALIDATION_FAILED" | "REGISTERED" | "CHANGE_PROPOSED" | "CHANGE_APPLIED" | "PROMOTED" | "RETIRED";
+export interface ContractValidation {
+    readonly validationId: string;
+    readonly fingerprint: string;
+    readonly valid: boolean;
+    readonly reasons: readonly string[];
+    readonly validatedAt: string;
+}
+export interface ContractRevision {
+    readonly revisionId: string;
+    readonly version: string;
+    readonly fingerprint: string;
+    readonly manifest: ApplicationManifest;
+    readonly disposition: "DRAFT" | "ACTIVE" | "SUPERSEDED";
+    readonly createdAt: string;
+}
+export interface PromotionRecord {
+    readonly promotionId: string;
+    readonly revisionId: string;
+    readonly fingerprint: string;
+    readonly promotedAt: string;
+}
+export interface LifecycleEvent {
+    readonly eventId: string;
+    readonly sequence: number;
+    readonly type: LifecycleEventType;
+    readonly from?: ApplicationLifecyclePhase;
+    readonly to: ApplicationLifecyclePhase;
+    readonly revisionId: string;
+    readonly fingerprint: string;
+    readonly occurredAt: string;
+}
+export interface ApplicationLifecycleRecord {
+    readonly applicationId: string;
+    readonly phase: ApplicationLifecyclePhase;
+    readonly sequence: number;
+    readonly pendingRevisionId: string;
+    readonly activeRevisionId?: string;
+    readonly registrationId?: string;
+    readonly revisions: readonly ContractRevision[];
+    readonly validations: readonly ContractValidation[];
+    readonly promotions: readonly PromotionRecord[];
+    readonly history: readonly LifecycleEvent[];
+    readonly updatedAt: string;
+}
+export interface ApplicationLifecycleStore {
+    get(applicationId: string): Promise<ApplicationLifecycleRecord | undefined>;
+    put(record: ApplicationLifecycleRecord, expectedSequence: number | undefined): Promise<void>;
+    list(): Promise<ApplicationLifecycleRecord[]>;
+}
+export declare class LifecycleConflictError extends Error {
+    constructor(id: string);
+}
+export declare class MemoryApplicationLifecycleStore implements ApplicationLifecycleStore {
+    private readonly records;
+    get(id: string): Promise<ApplicationLifecycleRecord | undefined>;
+    put(record: ApplicationLifecycleRecord, expected: number | undefined): Promise<void>;
+    list(): Promise<ApplicationLifecycleRecord[]>;
+}
+export interface LifecycleRegistrationGateway {
+    validate(revision: ContractRevision): Promise<{
+        valid: boolean;
+        reasons: readonly string[];
+    }>;
+    register(revision: ContractRevision): Promise<{
+        registrationId: string;
+    }>;
+    promote(revision: ContractRevision, registrationId: string): Promise<void>;
+    apply(revision: ContractRevision, registrationId: string): Promise<void>;
+    retire(applicationId: string, registrationId: string): Promise<void>;
+    promotionChecks(revision: ContractRevision): Promise<{
+        valid: boolean;
+        reasons: readonly string[];
+    }>;
+}
+/** Connects lifecycle commands to the existing authoritative registry boundary. */
+export declare class ApplicationRegistryLifecycleGateway implements LifecycleRegistrationGateway {
+    private readonly registry;
+    private readonly checks;
+    constructor(registry: ApplicationRegistry, checks?: (revision: ContractRevision) => Promise<{
+        valid: boolean;
+        reasons: readonly string[];
+    }>);
+    validate(revision: ContractRevision): Promise<{
+        valid: boolean;
+        reasons: readonly string[];
+    }>;
+    register(revision: ContractRevision): Promise<{
+        registrationId: string;
+    }>;
+    promote(revision: ContractRevision, registrationId: string): Promise<void>;
+    apply(revision: ContractRevision, registrationId: string): Promise<void>;
+    retire(applicationId: string, registrationId: string): Promise<void>;
+    promotionChecks(revision: ContractRevision): Promise<{
+        valid: boolean;
+        reasons: readonly string[];
+    }>;
+}
+/** The only command boundary allowed to manufacture authoritative lifecycle facts. */
+export declare class ApplicationLifecycleOperations {
+    private readonly store;
+    private readonly gateway;
+    private readonly now;
+    constructor(store: ApplicationLifecycleStore, gateway: LifecycleRegistrationGateway, now?: () => string);
+    define(manifest: ApplicationManifest): Promise<ApplicationLifecycleRecord>;
+    validate(id: string): Promise<ApplicationLifecycleRecord>;
+    register(id: string): Promise<ApplicationLifecycleRecord>;
+    promote(id: string): Promise<{
+        phase: "ACTIVE";
+        sequence: number;
+        activeRevisionId: string;
+        revisions: ContractRevision[];
+        promotions: PromotionRecord[];
+        history: LifecycleEvent[];
+        updatedAt: string;
+        applicationId: string;
+        pendingRevisionId: string;
+        registrationId?: string;
+        validations: readonly ContractValidation[];
+    }>;
+    proposeChange(id: string, manifest: ApplicationManifest): Promise<ApplicationLifecycleRecord>;
+    applyChange(id: string): Promise<{
+        phase: "ACTIVE";
+        sequence: number;
+        activeRevisionId: string;
+        revisions: ContractRevision[];
+        promotions: PromotionRecord[];
+        history: LifecycleEvent[];
+        updatedAt: string;
+        applicationId: string;
+        pendingRevisionId: string;
+        registrationId?: string;
+        validations: readonly ContractValidation[];
+    }>;
+    retire(id: string): Promise<ApplicationLifecycleRecord>;
+    get: (id: string) => Promise<ApplicationLifecycleRecord | undefined>;
+    list: () => Promise<ApplicationLifecycleRecord[]>;
+    private activate;
+    private advance;
+    private revision;
+    private event;
+    private required;
+    private expect;
+    private pending;
+    private active;
+}
+//# sourceMappingURL=application-lifecycle.d.ts.map

package/vendor/@appport/core/dist/application-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-lifecycle.d.ts","sourceRoot":"","sources":["../src/application-lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,MAAM,MAAM,yBAAyB,GAAG,OAAO,GAAG,WAAW,GAAG,YAAY,GAAG,QAAQ,GAAG,iBAAiB,GAAG,SAAS,CAAC;AACxH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,WAAW,GAAG,mBAAmB,GAAG,YAAY,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,UAAU,GAAG,SAAS,CAAC;AAC9J,MAAM,WAAW,kBAAkB;IAAG,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAAE;AAChM,MAAM,WAAW,gBAAgB;IAAG,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,GAAG,QAAQ,GAAG,YAAY,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAAE;AACvP,MAAM,WAAW,eAAe;IAAG,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAAE;AAC1J,MAAM,WAAW,cAAc;IAAG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,yBAAyB,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,yBAAyB,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAAE;AACtS,MAAM,WAAW,0BAA0B;IAAG,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,yBAAyB,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,eAAe,EAAE,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAAE;AAC/d,MAAM,WAAW,yBAAyB;IAAG,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,GAAG,SAAS,CAAC,CAAC;IAAC,GAAG,CAAC,MAAM,EAAE,0BAA0B,EAAE,gBAAgB,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,IAAI,IAAI,OAAO,CAAC,0BAA0B,EAAE,CAAC,CAAC;CAAE;AACxQ,qBAAa,sBAAuB,SAAQ,KAAK;gBAAe,EAAE,EAAE,MAAM;CAAwG;AAClL,qBAAa,+BAAgC,YAAW,yBAAyB;IAC/E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiD;IACnE,GAAG,CAAC,EAAE,EAAE,MAAM;IACd,GAAG,CAAC,MAAM,EAAE,0BAA0B,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS;IACpE,IAAI;CACX;AACD,MAAM,WAAW,4BAA4B;IAAG,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,KAAK,CAAC,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,eAAe,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CAAE;AAE7hB,mFAAmF;AACnF,qBAAa,mCAAoC,YAAW,4BAA4B;IAC1E,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAAuB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAtD,QAAQ,EAAE,mBAAmB,EAAmB,MAAM,GAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAA8C;IACzN,QAAQ,CAAC,QAAQ,EAAE,gBAAgB;eADmG,OAAO;iBAAW,SAAS,MAAM,EAAE;;IAEnK,QAAQ,CAAC,QAAQ,EAAE,gBAAgB;;;IACnC,OAAO,CAAC,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM;IAC1D,KAAK,CAAC,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM;IACxD,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM;IAC1D,eAAe,CAAC,QAAQ,EAAE,gBAAgB;eAN4F,OAAO;iBAAW,SAAS,MAAM,EAAE;;CAO1K;AAED,sFAAsF;AACtF,qBAAa,8BAA8B;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAA6B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAAgC,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAA9G,KAAK,EAAE,yBAAyB,EAAmB,OAAO,EAAE,4BAA4B,EAAmB,GAAG,eAAiC;IACtK,MAAM,CAAC,QAAQ,EAAE,mBAAmB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM;IACnB,OAAO,CAAC,EAAE,EAAE,MAAM;;;;;;;;uBA5B4C,MAAM;2BAAoG,MAAM;yBAAgE,MAAM;qBAAyE,SAAS,kBAAkB,EAAE;;IA6B1V,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB;IACvD,WAAW,CAAC,EAAE,EAAE,MAAM;;;;;;;;uBA9BwC,MAAM;2BAAoG,MAAM;yBAAgE,MAAM;qBAAyE,SAAS,kBAAkB,EAAE;;IA+B1V,MAAM,CAAC,EAAE,EAAE,MAAM;IACvB,GAAG,GAAI,IAAI,MAAM,qDAAwB;IAAC,IAAI,8CAA2B;YAC3D,QAAQ;YACR,OAAO;IACrB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,KAAK;YACC,QAAQ;IACtB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,MAAM;CACf"}

package/vendor/@appport/core/dist/application-lifecycle.js

@@ -0,0 +1,70 @@
+import { randomUUID } from "node:crypto";
+import { fingerprintManifest } from "./manifest.js";
+export class LifecycleConflictError extends Error {
+    constructor(id) { super(`Concurrent lifecycle update rejected for "${id}"`); this.name = "LifecycleConflictError"; }
+}
+export class MemoryApplicationLifecycleStore {
+    records = new Map();
+    async get(id) { const record = this.records.get(id); return record ? structuredClone(record) : undefined; }
+    async put(record, expected) { const current = this.records.get(record.applicationId); if (current?.sequence !== expected)
+        throw new LifecycleConflictError(record.applicationId); this.records.set(record.applicationId, structuredClone(record)); }
+    async list() { return [...this.records.values()].map(record => structuredClone(record)).sort((a, b) => a.applicationId.localeCompare(b.applicationId)); }
+}
+/** Connects lifecycle commands to the existing authoritative registry boundary. */
+export class ApplicationRegistryLifecycleGateway {
+    registry;
+    checks;
+    constructor(registry, checks = async () => ({ valid: true, reasons: [] })) {
+        this.registry = registry;
+        this.checks = checks;
+    }
+    validate(revision) { return this.checks(revision); }
+    async register(revision) { const state = await this.registry.registerWithValidation({ identity: revision.manifest.application, manifest: revision.manifest, fingerprint: revision.fingerprint, verification: { ready: true, errors: [], warnings: [], provides: revision.manifest.provides.map(item => ({ name: item.name, version: item.version })), requires: revision.manifest.requires.map(item => ({ name: item.name, version: item.version })), implementations: new Map(revision.manifest.provides.map(item => [`${item.name}@${item.version}`, "bound"])) } }); return { registrationId: state.registrationId }; }
+    async promote(revision, registrationId) { const current = await this.registry.get(revision.manifest.application.id); if (!current || current.registrationId !== registrationId)
+        throw new Error("Registration incarnation changed before promotion"); await this.registry.activate(current.id); }
+    async apply(revision, registrationId) { const current = await this.registry.get(revision.manifest.application.id); if (!current || current.registrationId !== registrationId)
+        throw new Error("Registration incarnation changed before applying lifecycle revision"); await this.register(revision); }
+    async retire(applicationId, registrationId) { const current = await this.registry.get(applicationId); if (!current || current.registrationId !== registrationId)
+        throw new Error("Registration incarnation changed before retirement"); await this.registry.retire(applicationId); }
+    promotionChecks(revision) { return this.checks(revision); }
+}
+/** The only command boundary allowed to manufacture authoritative lifecycle facts. */
+export class ApplicationLifecycleOperations {
+    store;
+    gateway;
+    now;
+    constructor(store, gateway, now = () => new Date().toISOString()) {
+        this.store = store;
+        this.gateway = gateway;
+        this.now = now;
+    }
+    async define(manifest) { if (await this.store.get(manifest.application.id))
+        throw new Error(`Application "${manifest.application.id}" already exists; propose a change`); const at = this.now(), revision = this.revision(manifest, at); const record = { applicationId: manifest.application.id, phase: "DRAFT", sequence: 1, pendingRevisionId: revision.revisionId, revisions: [revision], validations: [], promotions: [], history: [this.event(1, "DEFINED", undefined, "DRAFT", revision, at)], updatedAt: at }; await this.store.put(record, undefined); return record; }
+    async validate(id) { const current = await this.required(id); this.expect(current, ["DRAFT", "CHANGE_PROPOSED"]); const revision = this.pending(current), canonical = fingerprintManifest(revision.manifest), external = await this.gateway.validate(revision), reasons = [...(canonical === revision.fingerprint ? [] : ["Canonical contract fingerprint mismatch"]), ...external.reasons], valid = external.valid && canonical === revision.fingerprint, validation = { validationId: `val_${randomUUID()}`, fingerprint: revision.fingerprint, valid, reasons, validatedAt: this.now() }; return this.advance(current, valid ? "VALIDATED" : current.phase, valid ? "VALIDATED" : "VALIDATION_FAILED", revision, { validations: [...current.validations, validation] }); }
+    async register(id) { const current = await this.required(id); this.expect(current, ["VALIDATED"]); if (current.activeRevisionId)
+        throw new Error("An active application change must be applied, not registered again"); const revision = this.pending(current), registration = await this.gateway.register(revision); return this.advance(current, "REGISTERED", "REGISTERED", revision, { registrationId: registration.registrationId }); }
+    async promote(id) { const current = await this.required(id); this.expect(current, ["REGISTERED"]); return this.activate(current, "PROMOTED"); }
+    async proposeChange(id, manifest) { const current = await this.required(id); this.expect(current, ["ACTIVE"]); if (manifest.application.id !== id)
+        throw new Error("A change cannot alter application identity"); const revision = this.revision(manifest, this.now()); if (revision.fingerprint === this.active(current).fingerprint)
+        throw new Error("Proposed contract is identical to active contract"); return this.advance(current, "CHANGE_PROPOSED", "CHANGE_PROPOSED", revision, { pendingRevisionId: revision.revisionId, revisions: [...current.revisions, revision] }); }
+    async applyChange(id) { const current = await this.required(id); this.expect(current, ["VALIDATED"]); if (!current.activeRevisionId || !current.registrationId)
+        throw new Error("No active application exists for this change"); const revision = this.pending(current), checks = await this.gateway.promotionChecks(revision); if (!checks.valid)
+        throw new Error(`Promotion checks failed: ${checks.reasons.join("; ")}`); await this.gateway.apply(revision, current.registrationId); return this.activate(current, "CHANGE_APPLIED", checks); }
+    async retire(id) { const current = await this.required(id); this.expect(current, ["ACTIVE"]); if (!current.registrationId)
+        throw new Error("Cannot retire an unregistered application"); await this.gateway.retire(id, current.registrationId); return this.advance(current, "RETIRED", "RETIRED", this.active(current)); }
+    get = (id) => this.store.get(id);
+    list = () => this.store.list();
+    async activate(current, event, checked) { const revision = this.pending(current), checks = checked ?? await this.gateway.promotionChecks(revision); if (!checks.valid)
+        throw new Error("Promotion checks failed"); if (!current.registrationId)
+        throw new Error("Promotion requires an authoritative registration"); await this.gateway.promote(revision, current.registrationId); const at = this.now(), sequence = current.sequence + 1, revisions = current.revisions.map(item => item.revisionId === revision.revisionId ? { ...item, disposition: "ACTIVE" } : item.disposition === "ACTIVE" ? { ...item, disposition: "SUPERSEDED" } : item), promotion = { promotionId: `promo_${randomUUID()}`, revisionId: revision.revisionId, fingerprint: revision.fingerprint, promotedAt: at }, next = { ...current, phase: "ACTIVE", sequence, activeRevisionId: revision.revisionId, revisions, promotions: [...current.promotions, promotion], history: [...current.history, this.event(sequence, event, current.phase, "ACTIVE", revision, at)], updatedAt: at }; await this.store.put(next, current.sequence); return next; }
+    async advance(current, to, type, revision, patch = {}) { const at = this.now(), sequence = current.sequence + 1, next = { ...current, ...patch, phase: to, sequence, history: [...current.history, this.event(sequence, type, current.phase, to, revision, at)], updatedAt: at }; await this.store.put(next, current.sequence); return next; }
+    revision(manifest, at) { return { revisionId: `rev_${randomUUID()}`, version: manifest.application.version, fingerprint: fingerprintManifest(manifest), manifest, disposition: "DRAFT", createdAt: at }; }
+    event(sequence, type, from, to, revision, at) { return { eventId: `life_${randomUUID()}`, sequence, type, ...(from ? { from } : {}), to, revisionId: revision.revisionId, fingerprint: revision.fingerprint, occurredAt: at }; }
+    async required(id) { const value = await this.store.get(id); if (!value)
+        throw new Error(`Unknown application "${id}"`); return value; }
+    expect(record, phases) { if (!phases.includes(record.phase))
+        throw new Error(`Illegal lifecycle operation from ${record.phase}`); }
+    pending(record) { return record.revisions.find(item => item.revisionId === record.pendingRevisionId); }
+    active(record) { return record.revisions.find(item => item.revisionId === record.activeRevisionId); }
+}
+//# sourceMappingURL=application-lifecycle.js.map

package/vendor/@appport/core/dist/application-lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-lifecycle.js","sourceRoot":"","sources":["../src/application-lifecycle.ts"],"names":[],"mappings":"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"}

package/vendor/@appport/core/dist/application-package.d.ts

@@ -0,0 +1,105 @@
+import type { AuthoredApplication, CapabilityReference, VerificationIssue, VerificationResult } from "./assembly.js";
+import { type AppBoundryContractDocument } from "./appboundry-contract.js";
+import { type RuntimeImplementationManifest } from "./runtime-manifest.js";
+export declare const APPPORT_APPLICATION_PACKAGE_PROTOCOL: "AppPort/application-bundle/1";
+export declare const APPPORT_APPLICATION_PACKAGE_MANIFEST_FILE: "manifest";
+export declare const APPPORT_APPLICATION_PACKAGE_ARTIFACT_FILE: "application.wasm";
+export declare const APPPORT_APPLICATION_PACKAGE_IDENTITY_ALGORITHM: "sha256";
+export interface CreateApplicationPackageOptions {
+    /** Compiled WASM bytes that AppBoundry will execute from the `.app` bundle. */
+    readonly artifact: Uint8Array;
+    /** Stable identity of this runtime implementation, distinct from the application id. */
+    readonly implementationId?: string;
+    /** Optional source-attestation identity already established by AppBoundry. */
+    readonly sourceId?: string;
+    /** Contract revision to emit in the AppBoundry contract document. Defaults to 1. */
+    readonly contractRevision?: number;
+}
+export interface AppPortApplicationPackageManifest {
+    readonly protocol: typeof APPPORT_APPLICATION_PACKAGE_PROTOCOL;
+    readonly packageReference: string;
+    readonly packageIdentity: AppPortApplicationPackageIdentity;
+    readonly application: AppBoundryContractDocument["application"];
+    readonly appBoundryApplicationId: string;
+    readonly contractFingerprint: string;
+    readonly verification: AppPortApplicationPackageVerificationEvidence;
+    readonly artifact: {
+        readonly path: typeof APPPORT_APPLICATION_PACKAGE_ARTIFACT_FILE;
+        readonly format: "wasm/1";
+        readonly hash: string;
+    };
+    readonly contract: AppBoundryContractDocument;
+    readonly implementation: RuntimeImplementationManifest;
+    readonly immutable: true;
+}
+export interface AppPortApplicationPackageVerificationEvidence {
+    readonly protocol: "AppPort/application-package-verification/1";
+    readonly ready: true;
+    readonly errors: readonly [];
+    readonly warnings: readonly VerificationIssue[];
+    readonly provides: readonly CapabilityReference[];
+    readonly requires: readonly CapabilityReference[];
+    readonly implementations: readonly {
+        readonly capability: string;
+        readonly status: "bound";
+    }[];
+}
+export interface AppPortApplicationPackageIdentity {
+    readonly reference: string;
+    readonly algorithm: typeof APPPORT_APPLICATION_PACKAGE_IDENTITY_ALGORITHM;
+    readonly digest: string;
+    readonly contentAddress: `sha256:${string}`;
+    readonly immutable: true;
+}
+export interface AppPortApplicationPackageFile {
+    readonly path: typeof APPPORT_APPLICATION_PACKAGE_MANIFEST_FILE | typeof APPPORT_APPLICATION_PACKAGE_ARTIFACT_FILE;
+    readonly contents: string | Uint8Array;
+}
+export interface AppPortApplicationPackage {
+    readonly verification: VerificationResult;
+    readonly packageReference: string;
+    readonly packageIdentity: AppPortApplicationPackageIdentity;
+    readonly manifest: AppPortApplicationPackageManifest;
+    readonly contract: AppBoundryContractDocument;
+    readonly runtimeManifest: RuntimeImplementationManifest;
+    readonly contractFingerprint: string;
+    readonly artifactHash: string;
+    readonly files: readonly AppPortApplicationPackageFile[];
+}
+export interface ResolveApplicationPackageMetadataOptions {
+    readonly manifest: string | unknown;
+    readonly artifact: Uint8Array;
+}
+export interface ResolvedApplicationPackageMetadata {
+    readonly packageReference: string;
+    readonly packageIdentity: AppPortApplicationPackageIdentity;
+    readonly manifest: AppPortApplicationPackageManifest;
+    readonly contract: AppBoundryContractDocument;
+    readonly runtimeManifest: RuntimeImplementationManifest;
+    readonly contractFingerprint: string;
+    readonly artifactHash: string;
+    readonly verified: true;
+}
+/**
+ * Produce the canonical AppPort application package consumed by AppBoundry.
+ *
+ * The package is derived from the SDK application definition: verification must
+ * pass before any bundle manifest is emitted, the contract fingerprint is
+ * calculated from the canonical manifest, and runtime bindings are limited to
+ * AppBoundry's implementation coverage plus the WASM artifact hash.
+ */
+export declare function createApplicationPackage(application: AuthoredApplication, options: CreateApplicationPackageOptions): AppPortApplicationPackage;
+/** Build a canonical immutable `.app` manifest from verified contract, runtime, and artifact metadata. */
+export declare function createApplicationPackageManifest(contract: AppBoundryContractDocument, runtimeManifest: RuntimeImplementationManifest, artifactHash: string, verification?: AppPortApplicationPackageVerificationEvidence): AppPortApplicationPackageManifest;
+/** Canonical portable reference for an already-packaged AppPort application. */
+export declare function createApplicationPackageReference(application: {
+    readonly id: string;
+    readonly version: string;
+}): string;
+/** Inspect and verify the content-addressed identity declared by a package manifest. */
+export declare function inspectApplicationPackageIdentity(manifest: string | unknown): AppPortApplicationPackageIdentity;
+/** Resolve package metadata only after verifying manifest, identity, contract, runtime, and artifact bytes. */
+export declare function resolveApplicationPackageMetadata(options: ResolveApplicationPackageMetadataOptions): ResolvedApplicationPackageMetadata;
+/** Parse the `.app` manifest and reject mutable or self-inconsistent package metadata. */
+export declare function parseApplicationPackageManifest(input: string | unknown): AppPortApplicationPackageManifest;
+//# sourceMappingURL=application-package.d.ts.map

package/vendor/@appport/core/dist/application-package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-package.d.ts","sourceRoot":"","sources":["../src/application-package.ts"],"names":[],"mappings":"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"}