@crosshands/runtime 0.1.2

package/dist/bundle-lifecycle.js

@@ -0,0 +1,247 @@
+export class BundleLifecycleError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'BundleLifecycleError';
+    }
+}
+const REMOVABLE_CROSSHANDS_RESOURCES = new Set([
+    'broker-registration',
+    'ipc',
+    'cache',
+    'log',
+    'temporary-capture'
+]);
+export function planUninstall(resources) {
+    const remove = [];
+    const preserve = [];
+    const manual = [];
+    for (const resource of resources) {
+        if (resource.kind === 'permission') {
+            manual.push(resource);
+        }
+        else if (resource.owner === 'crosshands' &&
+            REMOVABLE_CROSSHANDS_RESOURCES.has(resource.kind)) {
+            remove.push(resource);
+        }
+        else {
+            preserve.push(resource);
+        }
+    }
+    return { remove, preserve, manual };
+}
+function validateCandidate(candidate) {
+    if (candidate.version.length === 0 ||
+        !Number.isSafeInteger(candidate.release) ||
+        candidate.release < 0) {
+        throw new BundleLifecycleError('bundle_version_mismatch', 'Bundle version is invalid');
+    }
+    if (candidate.manifestDigest.length === 0) {
+        throw new BundleLifecycleError('bundle_integrity', 'Bundle manifest digest is missing');
+    }
+    const required = new Set(candidate.requiredArtifacts);
+    const artifacts = new Map();
+    if (required.size !== candidate.requiredArtifacts.length) {
+        throw new BundleLifecycleError('bundle_incomplete', 'Required artifact names must be unique');
+    }
+    for (const artifact of candidate.artifacts) {
+        if (artifacts.has(artifact.name)) {
+            throw new BundleLifecycleError('bundle_incomplete', 'Bundle artifact names must be unique');
+        }
+        if (artifact.version !== candidate.version) {
+            throw new BundleLifecycleError('bundle_version_mismatch', `Artifact ${artifact.name} does not match bundle ${candidate.version}`);
+        }
+        if (artifact.expectedDigest.length === 0 ||
+            artifact.actualDigest !== artifact.expectedDigest ||
+            !artifact.trustVerified) {
+            throw new BundleLifecycleError('bundle_integrity', `Artifact ${artifact.name} failed integrity verification`);
+        }
+        artifacts.set(artifact.name, artifact);
+    }
+    const missing = [...required].filter((name) => !artifacts.has(name));
+    if (missing.length > 0) {
+        throw new BundleLifecycleError('bundle_incomplete', `Bundle is missing required artifacts: ${missing.join(', ')}`);
+    }
+    return Object.freeze({
+        ...candidate,
+        requiredArtifacts: Object.freeze([...candidate.requiredArtifacts]),
+        artifacts: Object.freeze(candidate.artifacts.map((artifact) => Object.freeze({ ...artifact })))
+    });
+}
+/**
+ * Coordinates installed bundle state. Filesystem/package-manager work is deliberately
+ * supplied by callers; this class owns only verification gates and atomic state changes.
+ */
+export class BundleLifecycle {
+    #bundles = new Map();
+    #clients = new Map();
+    #drainWaiters = new Set();
+    #phase = 'idle';
+    #activeVersion;
+    #mutationCount = 0;
+    #contextGeneration = 0;
+    get phase() {
+        return this.#phase;
+    }
+    get activeVersion() {
+        return this.#activeVersion;
+    }
+    get inFlightMutations() {
+        return this.#mutationCount;
+    }
+    stage(candidate) {
+        this.#assertNotBusy();
+        const verified = validateCandidate(candidate);
+        const existing = this.#bundles.get(verified.version);
+        if (existing !== undefined && existing.manifestDigest !== verified.manifestDigest) {
+            throw new BundleLifecycleError('bundle_integrity', `Version ${verified.version} is already staged with a different manifest`);
+        }
+        this.#bundles.set(verified.version, verified);
+        if (this.#phase === 'uninstalled')
+            this.#phase = 'idle';
+    }
+    bundle(version) {
+        return this.#bundles.get(version);
+    }
+    beginMutation() {
+        if (this.#phase !== 'running' || this.#activeVersion === undefined) {
+            throw new BundleLifecycleError('mutation_rejected', `Mutations are unavailable while lifecycle is ${this.#phase}`);
+        }
+        this.#mutationCount += 1;
+        let completed = false;
+        return () => {
+            if (completed)
+                return;
+            completed = true;
+            this.#mutationCount -= 1;
+            if (this.#mutationCount === 0) {
+                for (const resolve of this.#drainWaiters)
+                    resolve();
+                this.#drainWaiters.clear();
+            }
+        };
+    }
+    async activate(version, hooks = {}) {
+        this.#assertNotBusy();
+        const target = this.#requireBundle(version);
+        this.#assertAdjacentToActive(target);
+        this.#phase = 'draining';
+        await this.#waitForMutations();
+        try {
+            await hooks.beforeCommit?.();
+            this.#phase = 'activating';
+            // This synchronous assignment is the state-machine commit point. Callers map it
+            // to an atomic pointer/rename and must not mutate a bundle in place.
+            this.#activeVersion = target.version;
+            this.#contextGeneration += 1;
+            for (const [id, client] of this.#clients) {
+                this.#clients.set(id, { ...client, reconnectRequired: true });
+            }
+            await hooks.afterCommit?.();
+        }
+        finally {
+            this.#phase = this.#activeVersion === undefined ? 'idle' : 'running';
+        }
+    }
+    async rollback(version, hooks = {}) {
+        await this.activate(version, hooks);
+    }
+    connectClient(id, version) {
+        this.#assertClientCompatible(version);
+        const client = { id, version, reconnectRequired: false };
+        this.#clients.set(id, client);
+        return { ...client };
+    }
+    reconnectClient(id, version) {
+        if (!this.#clients.has(id)) {
+            throw new BundleLifecycleError('version_incompatible', `Client ${id} is not connected`);
+        }
+        return this.connectClient(id, version);
+    }
+    client(id) {
+        const client = this.#clients.get(id);
+        return client === undefined ? undefined : { ...client };
+    }
+    assertDispatchCompatible(versions) {
+        const active = this.#requireActive();
+        for (const [role, version] of [
+            ['broker', versions.broker],
+            ['provider', versions.provider],
+            ['payload', versions.payload]
+        ]) {
+            if (version !== active.version) {
+                throw new BundleLifecycleError('version_incompatible', `${role} ${version} must match active bundle ${active.version}`);
+            }
+        }
+        this.#assertClientCompatible(versions.client);
+    }
+    issueContext() {
+        this.#requireActive();
+        return { generation: this.#contextGeneration };
+    }
+    isContextCurrent(context) {
+        return this.#activeVersion !== undefined && context.generation === this.#contextGeneration;
+    }
+    async uninstall(resources, remove) {
+        this.#assertNotBusy();
+        const plan = planUninstall(resources);
+        this.#phase = 'draining';
+        await this.#waitForMutations();
+        this.#phase = 'uninstalling';
+        try {
+            await Promise.all(plan.remove.map((resource) => remove(resource)));
+        }
+        catch (error) {
+            this.#phase = this.#activeVersion === undefined ? 'idle' : 'running';
+            throw error;
+        }
+        this.#bundles.clear();
+        this.#clients.clear();
+        this.#activeVersion = undefined;
+        this.#contextGeneration += 1;
+        this.#phase = 'uninstalled';
+        return plan;
+    }
+    #assertNotBusy() {
+        if (this.#phase === 'draining' ||
+            this.#phase === 'activating' ||
+            this.#phase === 'uninstalling') {
+            throw new BundleLifecycleError('lifecycle_busy', `Lifecycle is already ${this.#phase}`);
+        }
+    }
+    #requireBundle(version) {
+        const bundle = this.#bundles.get(version);
+        if (bundle === undefined) {
+            throw new BundleLifecycleError('bundle_incomplete', `Bundle ${version} is not staged`);
+        }
+        return bundle;
+    }
+    #requireActive() {
+        if (this.#activeVersion === undefined) {
+            throw new BundleLifecycleError('bundle_incomplete', 'No bundle is active');
+        }
+        return this.#requireBundle(this.#activeVersion);
+    }
+    #assertAdjacentToActive(target) {
+        if (this.#activeVersion === undefined)
+            return;
+        const active = this.#requireActive();
+        if (Math.abs(target.release - active.release) > 1) {
+            throw new BundleLifecycleError('version_incompatible', `Bundle ${target.version} is outside the one-release compatibility window of ${active.version}`);
+        }
+    }
+    #assertClientCompatible(version) {
+        const active = this.#requireActive();
+        const client = this.#requireBundle(version);
+        if (Math.abs(client.release - active.release) > 1) {
+            throw new BundleLifecycleError('version_incompatible', `Client ${version} is outside the one-release compatibility window of ${active.version}`);
+        }
+    }
+    async #waitForMutations() {
+        if (this.#mutationCount === 0)
+            return;
+        await new Promise((resolve) => this.#drainWaiters.add(resolve));
+    }
+}
+//# sourceMappingURL=bundle-lifecycle.js.map

package/dist/bundle-lifecycle.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from './broker/broker.js';
+export * from './bundle-lifecycle.js';
+export * from './ipc/endpoint.js';
+export * from './ipc/control-transport.js';
+export * from './ipc/framing.js';
+export * from './ipc/unix.js';
+export * from './ipc/windows.js';
+export * from './policy/policy.js';
+export * from './providers/supervisor.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,mBAAmB,CAAA;AACjC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA;AAClC,cAAc,2BAA2B,CAAA"}

package/dist/index.js

@@ -0,0 +1,10 @@
+export * from './broker/broker.js';
+export * from './bundle-lifecycle.js';
+export * from './ipc/endpoint.js';
+export * from './ipc/control-transport.js';
+export * from './ipc/framing.js';
+export * from './ipc/unix.js';
+export * from './ipc/windows.js';
+export * from './policy/policy.js';
+export * from './providers/supervisor.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,mBAAmB,CAAA;AACjC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA;AAClC,cAAc,2BAA2B,CAAA"}

package/dist/ipc/control-transport.d.ts

@@ -0,0 +1,59 @@
+import { type Socket } from 'node:net';
+import { type ContractVersions } from '@crosshands/contract';
+import type { BrokerEndpoint } from './endpoint.js';
+import { type WindowsPipeSecurityBackend } from './windows.js';
+export type LocalControlIdentity = {
+    osIdentity: string;
+    graphicalSessionId: string;
+};
+export type LocalControlHandshake = {
+    type: 'handshake';
+    requestId: string;
+    token: string;
+    versions: ContractVersions;
+    identity: LocalControlIdentity;
+};
+export interface LocalPeerAuthenticator {
+    authenticate(handshake: LocalControlHandshake, socket: Socket): Promise<boolean>;
+}
+export type LocalControlRequest = {
+    requestId: string;
+    payload: unknown;
+    deadlineAt: number;
+};
+export type LocalControlServerOptions = {
+    endpoint: BrokerEndpoint;
+    runtimeDirectory?: string;
+    tokenFile?: string;
+    identity: LocalControlIdentity;
+    handler: (request: LocalControlRequest) => Promise<unknown>;
+    authenticator?: LocalPeerAuthenticator;
+    windowsSecurity?: WindowsPipeSecurityBackend;
+    maxFrameBytes?: number;
+    maxFramesPerConnection?: number;
+    now?: () => number;
+};
+export declare class LocalControlServer {
+    #private;
+    constructor(options: LocalControlServerOptions);
+    get requestCount(): number;
+    start(): Promise<void>;
+    close(): Promise<void>;
+}
+export type LocalControlClientOptions = {
+    endpoint: BrokerEndpoint;
+    token: string;
+    versions: ContractVersions;
+    identity: LocalControlIdentity;
+    maxFrameBytes?: number;
+};
+export declare class LocalControlClient {
+    #private;
+    private constructor();
+    static connect(options: LocalControlClientOptions): Promise<LocalControlClient>;
+    request(payload: unknown, options: {
+        deadlineMs: number;
+    }): Promise<unknown>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=control-transport.d.ts.map

package/dist/ipc/control-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-transport.d.ts","sourceRoot":"","sources":["../../src/ipc/control-transport.ts"],"names":[],"mappings":"AAEA,OAAY,EAAE,KAAK,MAAM,EAAE,MAAM,UAAU,CAAA;AAE3C,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAA;AAE7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAGnD,OAAO,EAEL,KAAK,0BAA0B,EAEhC,MAAM,cAAc,CAAA;AAErB,MAAM,MAAM,oBAAoB,GAAG;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,kBAAkB,EAAE,MAAM,CAAA;CAC3B,CAAA;AAID,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,WAAW,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,QAAQ,EAAE,oBAAoB,CAAA;CAC/B,CAAA;AAED,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,SAAS,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACjF;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,EAAE,cAAc,CAAA;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,oBAAoB,CAAA;IAC9B,OAAO,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC3D,aAAa,CAAC,EAAE,sBAAsB,CAAA;IACtC,eAAe,CAAC,EAAE,0BAA0B,CAAA;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CACnB,CAAA;AA6ED,qBAAa,kBAAkB;;gBAWjB,OAAO,EAAE,yBAAyB;IAO9C,IAAI,YAAY,IAAI,MAAM,CAEzB;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiNtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAkB7B;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,EAAE,cAAc,CAAA;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,QAAQ,EAAE,oBAAoB,CAAA;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,qBAAa,kBAAkB;;IAa7B,OAAO;WAgBM,OAAO,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA0BrF,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAkEtE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}