@hs-x/cli 0.3.7 → 0.4.1

package/dist/dev/managed-session.d.ts

@@ -0,0 +1,124 @@
+import type { DevEvent } from './event-bus.js';
+export type ManagedDevSessionState = 'starting' | 'ready' | 'stopping' | 'stopped' | 'failed';
+export interface ManagedDevSessionRecord {
+    readonly schemaVersion: 1;
+    readonly sessionId: string;
+    readonly state: ManagedDevSessionState;
+    readonly generation: number;
+    readonly pid: number;
+    /** Opaque OS process-start identity used to reject PID reuse. */
+    readonly processStartedAt?: string;
+    readonly root: string;
+    /** Private, mode-0600 restart contract. Never include in rendered output. */
+    readonly launchArgv: readonly string[];
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly readyAt?: string;
+    readonly stoppedAt?: string;
+    readonly error?: string;
+    readonly projectAccountId?: number;
+    readonly testingAccountId?: number;
+    readonly components?: readonly string[];
+    readonly devPort?: number;
+    readonly logPort?: number;
+    readonly stdoutPath: string;
+    readonly stderrPath: string;
+    readonly eventsPath: string;
+}
+export type PublicManagedDevSession = Omit<ManagedDevSessionRecord, 'launchArgv'> & {
+    readonly running: boolean;
+};
+export interface ManagedDevSessionGuard {
+    readonly expectedGeneration?: number;
+    readonly expectedPid?: number;
+    readonly expectedStates?: readonly ManagedDevSessionState[];
+}
+export interface ManagedDevSessionRestartGuard {
+    readonly expectedGeneration: number;
+    readonly expectedPid: number;
+    readonly expectedStates: readonly ManagedDevSessionState[];
+}
+export interface ManagedDevLifecycleEvent {
+    readonly schema_version: 1;
+    readonly session_id: string;
+    readonly generation: number;
+    readonly ts: string;
+    readonly type: 'lifecycle';
+    readonly state: ManagedDevSessionState;
+    readonly message?: string;
+}
+export interface ManagedDevLogEvent {
+    readonly schema_version: 1;
+    readonly session_id: string;
+    readonly generation: number;
+    readonly ts: string;
+    readonly type: 'log';
+    readonly lane: DevEvent['lane'];
+    readonly level: DevEvent['level'];
+    readonly message: string;
+    readonly source?: string;
+    readonly fields?: Record<string, unknown>;
+}
+export type ManagedDevStoredEvent = ManagedDevLifecycleEvent | ManagedDevLogEvent;
+export interface ManagedDevEventMatch {
+    /** Byte offset immediately after this event. Pass it back as --cursor. */
+    readonly cursor: number;
+    readonly event: ManagedDevStoredEvent;
+}
+export interface ManagedDevEventFilter {
+    readonly lanes?: ReadonlySet<DevEvent['lane']>;
+    readonly levels?: ReadonlySet<DevEvent['level']>;
+    readonly search?: string;
+    readonly since?: number;
+}
+export interface ManagedDevEventWriter {
+    log(event: DevEvent): void;
+    lifecycle(state: ManagedDevSessionState, message?: string): void;
+    close(): Promise<void>;
+}
+export declare function managedDevSessionPaths(sessionId: string): {
+    readonly directory: string;
+    readonly record: string;
+    readonly events: string;
+    readonly stdout: string;
+    readonly stderr: string;
+};
+export declare function createManagedDevSession(input: {
+    readonly root: string;
+    readonly launchArgv: readonly string[];
+    readonly sessionId?: string;
+}): Promise<ManagedDevSessionRecord>;
+export declare function readManagedDevSession(sessionId: string): Promise<ManagedDevSessionRecord>;
+export declare function updateManagedDevSession(sessionId: string, update: (current: ManagedDevSessionRecord) => ManagedDevSessionRecord, guard?: ManagedDevSessionGuard): Promise<ManagedDevSessionRecord>;
+export declare function setManagedDevSessionPid(sessionId: string, pid: number, guard?: ManagedDevSessionGuard): Promise<ManagedDevSessionRecord>;
+export declare function prepareManagedDevSessionRestart(sessionId: string, guard: ManagedDevSessionRestartGuard): Promise<ManagedDevSessionRecord>;
+export declare function markManagedDevSessionReady(sessionId: string, details?: {
+    readonly projectAccountId?: number;
+    readonly testingAccountId?: number;
+    readonly components?: readonly string[];
+    readonly devPort?: number;
+    readonly logPort?: number;
+}): Promise<ManagedDevSessionRecord>;
+export declare function markManagedDevSessionState(sessionId: string, state: 'stopping' | 'stopped' | 'failed', message?: string, guard?: ManagedDevSessionGuard): Promise<ManagedDevSessionRecord>;
+export declare function waitForManagedDevSessionOwner(sessionId: string, pid?: number, timeoutMs?: number): Promise<ManagedDevSessionRecord>;
+export declare function reconcileManagedDevSession(sessionId: string): Promise<ManagedDevSessionRecord>;
+export declare function publicManagedDevSession(session: ManagedDevSessionRecord): Promise<PublicManagedDevSession>;
+export declare function createManagedDevEventWriter(session: ManagedDevSessionRecord): ManagedDevEventWriter;
+export declare function readManagedDevEvents(input: {
+    readonly session: ManagedDevSessionRecord;
+    readonly cursor?: number;
+    readonly limit?: number;
+    readonly filter?: ManagedDevEventFilter;
+}): Promise<{
+    readonly events: readonly ManagedDevEventMatch[];
+    readonly nextCursor: number;
+    readonly endCursor: number;
+}>;
+export declare function managedDevProcessMatches(session: ManagedDevSessionRecord): Promise<boolean>;
+export declare function stopManagedDevSessionProcess(sessionId: string, input?: {
+    readonly force?: boolean;
+    readonly timeoutMs?: number;
+}): Promise<ManagedDevSessionRecord>;
+export declare function isProcessAlive(pid: number): Promise<boolean>;
+export declare function fileSize(path: string): Promise<number>;
+//# sourceMappingURL=managed-session.d.ts.map

package/dist/dev/managed-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-session.d.ts","sourceRoot":"","sources":["../../src/dev/managed-session.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAW/C,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE9F,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,uBAAuB,EAAE,YAAY,CAAC,GAAG;IAClF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;CAC7D;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,SAAS,sBAAsB,EAAE,CAAC;CAC5D;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAC;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,MAAM,MAAM,qBAAqB,GAAG,wBAAwB,GAAG,kBAAkB,CAAC;AAElF,MAAM,WAAW,oBAAoB;IACnC,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;CACvC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC3B,SAAS,CAAC,KAAK,EAAE,sBAAsB,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG;IACzD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAUA;AAED,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B,GAAG,OAAO,CAAC,uBAAuB,CAAC,CA4BnC;AAED,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAc/F;AAED,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,uBAAuB,EACrE,KAAK,GAAE,sBAA2B,GACjC,OAAO,CAAC,uBAAuB,CAAC,CAIlC;AAkBD,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,GAAE,sBAA2B,GACjC,OAAO,CAAC,uBAAuB,CAAC,CAelC;AAED,wBAAsB,+BAA+B,CACnD,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,6BAA6B,GACnC,OAAO,CAAC,uBAAuB,CAAC,CAsBlC;AAED,wBAAsB,0BAA0B,CAC9C,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IACP,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CACtB,GACL,OAAO,CAAC,uBAAuB,CAAC,CA0BlC;AAED,wBAAsB,0BAA0B,CAC9C,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,EACxC,OAAO,CAAC,EAAE,MAAM,EAChB,KAAK,GAAE,sBAA2B,GACjC,OAAO,CAAC,uBAAuB,CAAC,CAkBlC;AAED,wBAAsB,6BAA6B,CACjD,SAAS,EAAE,MAAM,EACjB,GAAG,SAAc,EACjB,SAAS,SAAQ,GAChB,OAAO,CAAC,uBAAuB,CAAC,CAQlC;AAED,wBAAsB,0BAA0B,CAC9C,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,uBAAuB,CAAC,CAalC;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,uBAAuB,CAAC,CAGlC;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,uBAAuB,GAC/B,qBAAqB,CAoCvB;AAED,wBAAsB,oBAAoB,CAAC,KAAK,EAAE;IAChD,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC;CACzC,GAAG,OAAO,CAAC;IACV,QAAQ,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC,CAoCD;AAED,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC,CAMjG;AAyFD,wBAAsB,4BAA4B,CAChD,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACpE,OAAO,CAAC,uBAAuB,CAAC,CAwFlC;AAqBD,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQlE;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM5D"}