dougong 0.8.3 → 0.9.0

package/dist/contracts/contract-registry.d.ts

@@ -0,0 +1,18 @@
+import { ContractIdentity, ContractKind } from './contracts.js';
+export declare class ContractRegistry {
+    #private;
+    assertKinds(kinds: ReadonlyMap<string, ContractKind>): void;
+    assertCompatible(contract: ContractIdentity): void;
+    remember(contract: ContractIdentity): void;
+    writer(candidateKinds: ReadonlyMap<string, ContractKind>): ContractRegistryWriter;
+    commit(kinds: ReadonlyMap<string, ContractKind>): void;
+}
+export declare class ContractRegistryWriter {
+    #private;
+    constructor(registry: ContractRegistry, candidateKinds: ReadonlyMap<string, ContractKind>);
+    remember(contract: ContractIdentity): void;
+    commit(): void;
+    discard(): void;
+}
+export declare function rememberContractKind(kinds: Map<string, ContractKind>, contract: ContractIdentity): void;
+//# sourceMappingURL=contract-registry.d.ts.map

package/dist/contracts/contract-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-registry.d.ts","sourceRoot":"","sources":["../../src/contracts/contract-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAKrE,qBAAa,gBAAgB;;IAG3B,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC;IAIpD,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB;IAI3C,QAAQ,CAAC,QAAQ,EAAE,gBAAgB;IAInC,MAAM,CAAC,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC;IAIxD,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC;CAIhD;AAWD,qBAAa,sBAAsB;;gBAGrB,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC;IAKzF,QAAQ,CAAC,QAAQ,EAAE,gBAAgB;IAenC,MAAM;IAON,OAAO;CAGR;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,QAAQ,EAAE,gBAAgB,QAGhG"}

package/dist/contracts/contracts.d.ts

@@ -0,0 +1,51 @@
+declare const contractBrand: unique symbol;
+declare const contractValueSlot: unique symbol;
+declare const optionalBrand: unique symbol;
+interface ContractValueSlot<T> {
+    readonly value: T;
+    readonly accept: (value: T) => void;
+}
+export type ContractKind = "service" | "extensionPoint" | "event";
+export interface ContractIdentity {
+    readonly id: string;
+    readonly kind: ContractKind;
+}
+interface ContractBrand {
+    readonly [contractBrand]: true;
+}
+interface Contract<T, Kind extends ContractKind> extends ContractIdentity, ContractBrand {
+    readonly kind: Kind;
+    readonly [contractValueSlot]: ContractValueSlot<T>;
+}
+interface ServiceIdentity extends ContractIdentity, ContractBrand {
+    readonly kind: "service";
+}
+interface ExtensionPointIdentity extends ContractIdentity, ContractBrand {
+    readonly kind: "extensionPoint";
+}
+export interface Service<T> extends Contract<T, "service"> {
+}
+export interface ExtensionPoint<T> extends Contract<T, "extensionPoint"> {
+}
+export interface Event<T> extends Contract<T, "event"> {
+}
+interface OptionalServiceIdentity {
+    readonly [optionalBrand]: true;
+    readonly kind: "optional";
+    readonly service: ServiceIdentity;
+}
+export interface OptionalService<T> extends OptionalServiceIdentity {
+    readonly service: Service<T>;
+    readonly [contractValueSlot]: ContractValueSlot<T>;
+}
+export type Requirement = ServiceIdentity | ExtensionPointIdentity | OptionalServiceIdentity;
+export type ContractValue<T> = T extends Contract<infer Value, ContractKind> ? Value : never;
+export declare function normalizeContract<T extends ContractIdentity>(value: T, expected?: ContractKind, message?: string): T;
+export declare function normalizeContract(value: unknown, expected?: ContractKind, message?: string): ContractIdentity;
+export declare function service<T>(id: string): Service<T>;
+export declare function event<T>(id: string): Event<T>;
+export declare function extensionPoint<T>(id: string): ExtensionPoint<T>;
+export declare function optional<T>(token: Service<T>): OptionalService<T>;
+export declare function normalizeRequirement(value: unknown, message?: string, optionalMessage?: string): Requirement;
+export {};
+//# sourceMappingURL=contracts.d.ts.map

package/dist/contracts/contracts.d.ts.map

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

package/dist/contracts/errors.d.ts

@@ -0,0 +1,53 @@
+import { StandardSchemaV1 } from '@standard-schema/spec';
+export interface ErrorDetails {
+    readonly outcome?: "rejected" | "restored" | "quarantined";
+    readonly phase?: string;
+    readonly installation?: string;
+    readonly contract?: string;
+    readonly dependencyPath?: ReadonlyArray<string>;
+    readonly affectedInstallations?: ReadonlyArray<string>;
+    readonly stateRevision?: number;
+    readonly expectedRevision?: number;
+}
+export declare class DougongError<Code extends string = string> extends Error {
+    name: string;
+    readonly code: Code;
+    readonly details: ErrorDetails;
+    constructor(code: Code, message: string, options?: ErrorOptions & {
+        readonly details?: ErrorDetails;
+    });
+}
+export declare function quarantinedHost(revision: number): DougongError<"HOST_QUARANTINED">;
+export interface ErrorSnapshot {
+    readonly name: string;
+    readonly message: string;
+    readonly code?: string;
+    readonly stack?: string;
+    readonly cause?: ErrorSnapshot;
+    readonly errors?: ReadonlyArray<ErrorSnapshot>;
+    readonly details?: ErrorDetails;
+    readonly fields?: Readonly<Record<string, string | ReadonlyArray<string>>>;
+    readonly issues?: ReadonlyArray<{
+        readonly message: string;
+        readonly path?: ReadonlyArray<string | number>;
+    }>;
+    readonly truncated?: true;
+}
+export declare class RecordedFailure extends Error {
+    #private;
+    readonly name = "RecordedFailure";
+    readonly code: string | undefined;
+    get snapshot(): ErrorSnapshot;
+    constructor(error: unknown, fields?: ReadonlyArray<string>);
+}
+export declare function isError(value: unknown): value is Error;
+export declare function normalizeFailure(error: unknown, code: string, message: string): Error;
+export declare function isCancellationReason(signal: AbortSignal, error: unknown): boolean;
+export declare class ConfigurationValidationError extends DougongError {
+    name: string;
+    readonly issues: ReadonlyArray<StandardSchemaV1.Issue>;
+    constructor(issues: ReadonlyArray<StandardSchemaV1.Issue>, options?: ErrorOptions & {
+        readonly details?: ErrorDetails;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/contracts/errors.d.ts.map

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

package/dist/contracts/logging.d.ts

@@ -0,0 +1,16 @@
+import { disposeSymbol, Disposable } from './resource.js';
+export interface Logger {
+    readonly debug: (message: unknown, ...details: unknown[]) => void;
+    readonly info: (message: unknown, ...details: unknown[]) => void;
+    readonly warn: (message: unknown, ...details: unknown[]) => void;
+    readonly error: (message: unknown, ...details: unknown[]) => void;
+}
+export declare function captureLogger(value: unknown): Logger;
+export declare function isLogger(value: unknown): value is Logger;
+export declare class ScopedLogger implements Disposable {
+    #private;
+    readonly handle: Logger;
+    constructor(logger: Logger, metadata: Readonly<Record<string, unknown>>);
+    [disposeSymbol](): void;
+}
+//# sourceMappingURL=logging.d.ts.map

package/dist/contracts/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/contracts/logging.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAC/D,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAClE,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACjE,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACjE,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACnE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAepD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAOxD;AAED,qBAAa,YAAa,YAAW,UAAU;;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAKpB;gBAIS,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAIvE,CAAC,aAAa,CAAC;CAYhB"}

package/dist/contracts/resource.d.ts

@@ -0,0 +1,14 @@
+export type Awaitable<T> = T | PromiseLike<T>;
+export { assertPromiseRuntime, resolveDisposalSymbol, asyncDisposeSymbol, disposeSymbol, } from '../internal/disposal-runtime.js';
+export interface Disposable {
+    [Symbol.dispose](): void;
+}
+export interface AsyncDisposable {
+    [Symbol.asyncDispose](): PromiseLike<void>;
+}
+export type Resource = Disposable | AsyncDisposable;
+export interface Publication extends Disposable {
+    publish(): void;
+}
+export declare function captureDisposer(resource: Resource): () => Awaitable<void>;
+//# sourceMappingURL=resource.d.ts.map

package/dist/contracts/resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../src/contracts/resource.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;AAE9C,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,GACd,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,UAAU;IACzB,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;CAC5C;AAED,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,eAAe,CAAC;AAEpD,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC7C,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAmBzE"}

package/dist/contracts/status.d.ts

@@ -0,0 +1,3 @@
+export type HostStatus = "stopped" | "starting" | "running" | "changing" | "stopping" | "quarantined";
+export type InstallationState = "pending" | "stopped" | "running" | "changing" | "removed" | "quarantined";
+//# sourceMappingURL=status.d.ts.map

package/dist/contracts/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/contracts/status.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GACpB,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,aAAa,CAAC;AAC/E,MAAM,MAAM,iBAAiB,GAC3B,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,aAAa,CAAC"}

package/dist/contributions/contribution-store.d.ts

@@ -0,0 +1,50 @@
+import { ContractIdentity, ExtensionPoint, Requirement } from '../contracts/contracts.js';
+import { Lifetime, LifetimeOwnership } from '../lifetime/lifetime.js';
+import { disposeSymbol, Disposable, Publication, Awaitable } from '../contracts/resource.js';
+import { SnapshotView } from '../observation/snapshot-view.js';
+export interface Contribution<T> extends Disposable {
+    readonly update: (value: T) => void;
+}
+export interface ContributionView<T> extends SnapshotView<ReadonlyArray<string>> {
+    use<Result>(id: string, callback: (value: T) => Awaitable<Result>): Promise<Result>;
+}
+export interface ContributionOperations {
+    add<T>(token: ExtensionPoint<T>, key: string, value: T, options?: LifetimeOwnership): Contribution<T>;
+}
+type ExtensionPointIdentity = Extract<Requirement, {
+    readonly kind: "extensionPoint";
+}>;
+declare class ContributionRecord<T> implements Publication {
+    #private;
+    readonly handle: Contribution<T>;
+    constructor(store: ContributionStore<T>, id: string, initialValue: T, owner: Lifetime, detachFromOwner: () => void);
+    publish(): void;
+    use<Result>(callback: (value: T) => Awaitable<Result>): Promise<Result>;
+    update(value: T): void;
+    [disposeSymbol](): void;
+}
+export declare class ContributionStore<T> {
+    #private;
+    constructor(invalidate: (store: ContributionStore<unknown>) => void, report: (error: unknown) => void, releaseIfUnused: (store: ContributionStore<unknown>) => void);
+    stage(installationId: string, key: string, value: T, owner: Lifetime, remember?: () => void): Contribution<T>;
+    view(own: (resource: Disposable) => () => void, owner?: Lifetime): ContributionView<T>;
+    hostView(): ContributionView<T>;
+    use<Result>(id: string, callback: (value: T) => Awaitable<Result>): Promise<Result>;
+    snapshot(): readonly string[];
+    subscribe(listener: () => void, own?: (resource: Disposable) => () => void): Disposable;
+    publishClaim(id: string, contribution: ContributionRecord<T>): void;
+    valueChanged(id: string, contribution: ContributionRecord<T>): void;
+    removeContribution(id: string, contribution: ContributionRecord<T>): void;
+    publishSnapshot(): void;
+}
+export declare class ContributionRegistry {
+    #private;
+    constructor(report: (error: unknown) => void);
+    get<T = unknown>(token: ExtensionPointIdentity): ContributionStore<T>;
+    view<T = unknown>(token: ExtensionPointIdentity, owner?: Lifetime): ContributionView<T>;
+    scope(owner: Lifetime, installationId: string, remember: (token: ContractIdentity) => void): ContributionOperations;
+    beginBatch(): void;
+    endBatch(): void;
+}
+export {};
+//# sourceMappingURL=contribution-store.d.ts.map

package/dist/contributions/contribution-store.d.ts.map

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

package/dist/events/event-hub.d.ts

@@ -0,0 +1,27 @@
+import { ContractIdentity, Event } from '../contracts/contracts.js';
+import { Lifetime, LifetimeOwnership } from '../lifetime/lifetime.js';
+import { disposeSymbol, Disposable, Publication } from '../contracts/resource.js';
+export type EventListener<T> = (payload: T) => unknown;
+export type EventArguments<T> = [T] extends [void] ? [payload?: T] : [payload: T];
+export interface EventOperations {
+    on<T>(token: Event<T>, listener: EventListener<T>, options?: LifetimeOwnership): Disposable;
+    emit<T>(token: Event<T>, ...payload: EventArguments<T>): Promise<void>;
+}
+declare class ListenerRegistration<T> implements Publication {
+    #private;
+    readonly handle: Disposable;
+    constructor(hub: EventHub, eventId: string, listener: EventListener<T>, owner: Lifetime, detach: () => void);
+    publish(): void;
+    invoke(payload: T): Promise<unknown>;
+    [disposeSymbol](): void;
+}
+export declare class EventHub {
+    #private;
+    scope(owner: Lifetime, remember: (token: ContractIdentity) => void): EventOperations;
+    stage<T>(eventId: string, listener: EventListener<T>, owner: Lifetime): Disposable;
+    add<T>(eventId: string, registration: ListenerRegistration<T>): void;
+    delete<T>(eventId: string, registration: ListenerRegistration<T>): void;
+    emit<T>(eventId: string, payload: T): Promise<void>;
+}
+export {};
+//# sourceMappingURL=event-hub.d.ts.map

package/dist/events/event-hub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-hub.d.ts","sourceRoot":"","sources":["../../src/events/event-hub.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,gBAAgB,EAAE,KAAK,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAEjG,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5F,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC;AACvD,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AAElF,MAAM,WAAW,eAAe;IAC9B,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,UAAU,CAAC;IAC5F,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxE;AASD,cAAM,oBAAoB,CAAC,CAAC,CAAE,YAAW,WAAW;;IAGlD,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;gBAG1B,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE,MAAM,IAAI;IAOpB,OAAO;IAMP,MAAM,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAOpC,CAAC,aAAa,CAAC;CAOhB;AAmDD,qBAAa,QAAQ;;IAGnB,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,eAAe;IAIpF,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,GAAG,UAAU;IAKlF,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAM7D,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAO1D,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAgB1D"}

package/dist/execution/engine.d.ts

@@ -0,0 +1,26 @@
+import { Service, OptionalService, ExtensionPoint } from '../contracts/contracts.js';
+import { Plan } from '../composition/plan.js';
+import { ApplyResult, HostOptions } from './host-api.js';
+import { ChangeSet, Group, Installation } from '../composition/declarations.js';
+import { HostStatus } from '../contracts/status.js';
+import { HostSnapshot } from '../inspection/diagnostics.js';
+import { Awaitable } from '../contracts/resource.js';
+export declare class Engine {
+    #private;
+    readonly name: string;
+    constructor(options?: HostOptions);
+    get status(): HostStatus;
+    get stateRevision(): number;
+    get diagnostics(): import('../index.js').SnapshotView<HostSnapshot>;
+    installation(id: string): Installation | undefined;
+    group(id: string): Group | undefined;
+    explain(id: string): readonly import('../index.js').BindingReport[];
+    change(): ChangeSet;
+    plan(change: ChangeSet, signal?: AbortSignal): Promise<Plan>;
+    apply(plan: Plan): Promise<ApplyResult>;
+    start(): Promise<ApplyResult>;
+    stop(): Promise<ApplyResult>;
+    use<T, Result>(requirement: Service<T> | OptionalService<T>, callback: (value: T | undefined) => Awaitable<Result>): Promise<Result>;
+    contributions<T>(point: ExtensionPoint<T>): import('../index.js').ContributionView<T>;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/execution/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/execution/engine.ts"],"names":[],"mappings":"AAQA,OAAO,EAGL,KAAK,OAAO,EACZ,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAmBnC,OAAO,EAGL,KAAK,IAAI,EAEV,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACrF,OAAO,KAAK,EAAE,UAAU,EAAqB,MAAM,wBAAwB,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAwB,MAAM,8BAA8B,CAAC;AACvF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AA0C1D,qBAAa,MAAM;;IACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAkBV,OAAO,GAAE,WAAgB;IAiFrC,IAAI,MAAM,IAAI,UAAU,CAEvB;IACD,IAAI,aAAa,WAEhB;IACD,IAAI,WAAW,qDAEd;IAED,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIlD,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAIpC,OAAO,CAAC,EAAE,EAAE,MAAM;IAMlB,MAAM,IAAI,SAAS;IAcb,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAkClE,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC;IAKvC,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC;IAG7B,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC;IAI5B,GAAG,CAAC,CAAC,EAAE,MAAM,EACX,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,EAC5C,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,SAAS,KAAK,SAAS,CAAC,MAAM,CAAC,GACpD,OAAO,CAAC,MAAM,CAAC;IA2BlB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC;CA4kB1C"}

package/dist/execution/host-api.d.ts

@@ -0,0 +1,43 @@
+import { ChangeSet, Group, Installation, InitialInstallation } from '../composition/declarations.js';
+import { HostStatus } from '../contracts/status.js';
+import { Logger } from '../contracts/logging.js';
+import { Service, OptionalService, ExtensionPoint } from '../contracts/contracts.js';
+import { ContributionView } from '../contributions/contribution-store.js';
+import { SnapshotView } from '../observation/snapshot-view.js';
+import { HostSnapshot } from '../inspection/diagnostics.js';
+import { Awaitable } from '../contracts/resource.js';
+import { Plan, BindingReport } from '../composition/plan.js';
+export interface HostOptions {
+    readonly name?: string;
+    readonly installations?: ReadonlyArray<InitialInstallation>;
+    readonly groups?: ReadonlyArray<{
+        readonly id: string;
+        readonly parentId?: string;
+    }>;
+    readonly logger?: Logger;
+    readonly onError?: (error: unknown) => Awaitable<void>;
+    readonly shutdownTimeoutMilliseconds?: number;
+}
+export interface ApplyResult {
+    readonly stateRevision: number;
+    readonly affectedInstallations: ReadonlyArray<string>;
+}
+export interface Host {
+    readonly name: string;
+    readonly status: HostStatus;
+    readonly stateRevision: number;
+    readonly diagnostics: SnapshotView<HostSnapshot>;
+    change(): ChangeSet;
+    plan(change: ChangeSet, signal?: AbortSignal): Promise<Plan>;
+    apply(plan: Plan): Promise<ApplyResult>;
+    start(): Promise<ApplyResult>;
+    stop(): Promise<ApplyResult>;
+    use<T, Result>(service: Service<T>, callback: (value: T) => Awaitable<Result>): Promise<Result>;
+    use<T, Result>(service: OptionalService<T>, callback: (value: T | undefined) => Awaitable<Result>): Promise<Result>;
+    contributions<T>(point: ExtensionPoint<T>): ContributionView<T>;
+    installation(id: string): Installation | undefined;
+    group(id: string): Group | undefined;
+    explain(installationId: string): ReadonlyArray<BindingReport>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+//# sourceMappingURL=host-api.d.ts.map

package/dist/execution/host-api.d.ts.map

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

package/dist/execution/host.d.ts

@@ -0,0 +1,3 @@
+import { Host, HostOptions } from './host-api.js';
+export declare function createHost(options?: HostOptions): Host;
+//# sourceMappingURL=host.d.ts.map

package/dist/execution/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/execution/host.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEvD,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI,CA6BtD"}

package/dist/execution/instance.d.ts

@@ -0,0 +1,33 @@
+import { ContractRegistryWriter } from '../contracts/contract-registry.js';
+import { Logger } from '../contracts/logging.js';
+import { EventHub } from '../events/event-hub.js';
+import { ContributionRegistry } from '../contributions/contribution-store.js';
+import { Lifetime } from '../lifetime/lifetime.js';
+import { InstallationRecord, InstallationDeclaration } from '../composition/installation.js';
+import { Awaitable } from '../contracts/resource.js';
+export interface InstanceEnvironment {
+    readonly hostName: string;
+    readonly logger: Logger;
+    readonly report: (error: unknown) => void;
+    readonly changed: () => void;
+    readonly events: EventHub;
+    readonly contributions: ContributionRegistry;
+    readonly contracts: ContractRegistryWriter;
+    readonly startupSignal: AbortSignal;
+    readonly shutdownTimeoutMilliseconds: number | undefined;
+}
+export declare class Instance {
+    #private;
+    readonly installation: InstallationRecord;
+    readonly declaration: InstallationDeclaration;
+    readonly generation: number;
+    private readonly environment;
+    readonly lifetime: Lifetime;
+    constructor(installation: InstallationRecord, declaration: InstallationDeclaration, generation: number, environment: InstanceEnvironment);
+    prepare(dependencies: Readonly<Record<string, unknown>>, configuration: unknown): Promise<void>;
+    read(serviceId: string): unknown;
+    use<T, Result>(serviceId: string, callback: (value: T) => Awaitable<Result>): Promise<Result>;
+    publish(): void;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=instance.d.ts.map

package/dist/execution/instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../../src/execution/instance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAEhF,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AACnF,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAGlG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,oBAAoB,CAAC;IAC7C,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAC;IAC3C,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC;IACpC,QAAQ,CAAC,2BAA2B,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1D;AAED,qBAAa,QAAQ;;IAKjB,QAAQ,CAAC,YAAY,EAAE,kBAAkB;IACzC,QAAQ,CAAC,WAAW,EAAE,uBAAuB;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAP9B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;gBAIjB,YAAY,EAAE,kBAAkB,EAChC,WAAW,EAAE,uBAAuB,EACpC,UAAU,EAAE,MAAM,EACV,WAAW,EAAE,mBAAmB;IAa7C,OAAO,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO;IA4CrF,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAMhC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,SAAS,CAAC,MAAM,CAAC;IAI3E,OAAO;IAKD,OAAO;CAOd"}

package/dist/index.d.ts

@@ -1,4 +1,18 @@
-export * from '@dougongjs/core';
-export * from '@dougongjs/platform';
-export { batch, computed, observe, signal, type ObservationOwner, type ObservationTask, type Observer, type Readable, type ReadonlySignal, type Signal, } from '@dougongjs/reactive';
+export { service, extensionPoint, event, optional, type ContractKind, type ContractValue, type Service, type ExtensionPoint, type Event, type OptionalService, type Requirement, } from './contracts/contracts.js';
+export { createHost } from './execution/host.js';
+export type { Host, HostOptions, ApplyResult } from './execution/host-api.js';
+export type { HostStatus, InstallationState } from './contracts/status.js';
+export type { ChangeSet, Group, Installation, InstallationOptions, InstallationUpdate, InstallationOrigin, InitialInstallation, } from './composition/declarations.js';
+export { definePlugin, type Plugin, type AnyPlugin, type PluginContext, type Requirements, type Provisions, type ResolvedRequirement, type ResolvedRequirements, type ProvidedServices, type InstanceMetadata, } from './composition/plugin.js';
+export { captureConfiguration, type ConfigurationValue } from './composition/configuration.js';
+export { describePlugin, type PluginDescriptor, type PluginConfigurationDescriptor, type PluginDescriptionOptions, } from './composition/plugin-description.js';
+export type { Plan, PlanReport, BindingReport, ImpactReason, PlanOperation, DeclarationSnapshot, } from './composition/plan.js';
+export type { HostSnapshot, InstallationSnapshot, GroupSnapshot, } from './inspection/diagnostics.js';
+export type { SnapshotView } from './observation/snapshot-view.js';
+export type { LifetimeContext, ChildLifetime, LifetimeOwnership, Task, Cleanup, BackgroundTask, LifetimePhase, LifetimeSnapshot, UnresolvedObligation, } from './lifetime/lifetime.js';
+export type { Contribution, ContributionView, ContributionOperations, } from './contributions/contribution-store.js';
+export type { EventListener, EventOperations, EventArguments } from './events/event-hub.js';
+export { isLogger, type Logger } from './contracts/logging.js';
+export { DougongError, ConfigurationValidationError, RecordedFailure, isError, isCancellationReason, type ErrorSnapshot, type ErrorDetails, } from './contracts/errors.js';
+export { disposeSymbol, asyncDisposeSymbol, type Disposable, type AsyncDisposable, type Resource, type Awaitable, } from './contracts/resource.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,OAAO,EACL,KAAK,EACL,QAAQ,EACR,OAAO,EACP,MAAM,EACN,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,MAAM,GACZ,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,cAAc,EACd,KAAK,EACL,QAAQ,EACR,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,OAAO,EACZ,KAAK,cAAc,EACnB,KAAK,KAAK,EACV,KAAK,eAAe,EACpB,KAAK,WAAW,GACjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC9E,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC3E,YAAY,EACV,SAAS,EACT,KAAK,EACL,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,YAAY,EACZ,KAAK,MAAM,EACX,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,KAAK,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAC/F,OAAO,EACL,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,6BAA6B,EAClC,KAAK,wBAAwB,GAC9B,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EACV,IAAI,EACJ,UAAU,EACV,aAAa,EACb,YAAY,EACZ,aAAa,EACb,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,aAAa,GACd,MAAM,6BAA6B,CAAC;AACrC,YAAY,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,YAAY,EACV,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,IAAI,EACJ,OAAO,EACP,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,EAAE,QAAQ,EAAE,KAAK,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EACL,YAAY,EACZ,4BAA4B,EAC5B,eAAe,EACf,OAAO,EACP,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,YAAY,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,QAAQ,EACb,KAAK,SAAS,GACf,MAAM,yBAAyB,CAAC"}