@syncular/testkit 0.0.0 → 0.0.2-136

package/dist/http-fixtures.d.ts

@@ -0,0 +1,57 @@
+import { ClientTableRegistry, enqueueOutboxCommit, type SyncClientDb, type SyncOnceOptions, type SyncOnceResult, type SyncPullOnceOptions, type SyncPullResponse, type SyncPushOnceOptions, type SyncPushOnceResult } from '@syncular/client';
+import type { SyncTransport } from '@syncular/core';
+import { type ServerSyncDialect, type ServerTableHandler, type SyncCoreDb } from '@syncular/server';
+import { type CreateSyncRoutesOptions } from '@syncular/server-hono';
+import { Hono } from 'hono';
+import type { Kysely } from 'kysely';
+import { createNodeHonoServer } from './hono-node-server';
+export type HttpServerDialect = 'sqlite' | 'pglite';
+export type HttpClientDialect = 'bun-sqlite' | 'pglite';
+export interface HttpServerFixture<DB extends SyncCoreDb> {
+    db: Kysely<DB>;
+    dialect: ServerSyncDialect;
+    app: Hono;
+    httpServer: ReturnType<typeof createNodeHonoServer>;
+    baseUrl: string;
+    destroy: () => Promise<void>;
+}
+export interface CreateHttpServerFixtureOptions<DB extends SyncCoreDb> {
+    serverDialect: HttpServerDialect;
+    createTables: (db: Kysely<DB>) => Promise<void>;
+    handlers: ServerTableHandler<DB>[];
+    authenticate: CreateSyncRoutesOptions<DB>['authenticate'];
+    sync?: CreateSyncRoutesOptions<DB>['sync'];
+    routePath?: string;
+    cors?: boolean;
+    corsAllowMethods?: string;
+    corsAllowHeaders?: string;
+    corsMaxAgeSeconds?: number;
+}
+export interface HttpClientFixture<DB extends SyncClientDb> {
+    db: Kysely<DB>;
+    transport: SyncTransport;
+    handlers: ClientTableRegistry<DB>;
+    actorId: string;
+    clientId: string;
+    enqueue: (args: Parameters<typeof enqueueOutboxCommit<DB>>[1]) => Promise<{
+        id: string;
+        clientCommitId: string;
+    }>;
+    push: (options?: Omit<SyncPushOnceOptions, 'clientId' | 'actorId'>) => Promise<SyncPushOnceResult>;
+    pull: (options: Omit<SyncPullOnceOptions, 'clientId' | 'actorId'>) => Promise<SyncPullResponse>;
+    syncOnce: (options: Omit<SyncOnceOptions, 'clientId' | 'actorId'>) => Promise<SyncOnceResult>;
+    destroy: () => Promise<void>;
+}
+export interface CreateHttpClientFixtureOptions<DB extends SyncClientDb> {
+    clientDialect: HttpClientDialect;
+    baseUrl: string;
+    actorId: string;
+    clientId: string;
+    createTables: (db: Kysely<DB>) => Promise<void>;
+    registerHandlers: (handlers: ClientTableRegistry<DB>) => void;
+    fetch?: typeof globalThis.fetch;
+    getHeaders?: () => Record<string, string>;
+}
+export declare function createHttpServerFixture<DB extends SyncCoreDb>(options: CreateHttpServerFixtureOptions<DB>): Promise<HttpServerFixture<DB>>;
+export declare function createHttpClientFixture<DB extends SyncClientDb>(options: CreateHttpClientFixtureOptions<DB>): Promise<HttpClientFixture<DB>>;
+//# sourceMappingURL=http-fixtures.d.ts.map

package/dist/http-fixtures.d.ts.map

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

package/dist/http-fixtures.js

@@ -0,0 +1,107 @@
+import { ClientTableRegistry, enqueueOutboxCommit, ensureClientSyncSchema, syncOnce, syncPullOnce, syncPushOnce, } from '@syncular/client';
+import { createBunSqliteDb } from '@syncular/dialect-bun-sqlite';
+import { createPgliteDb } from '@syncular/dialect-pglite';
+import { ensureSyncSchema, } from '@syncular/server';
+import { createPostgresServerDialect } from '@syncular/server-dialect-postgres';
+import { createSqliteServerDialect } from '@syncular/server-dialect-sqlite';
+import { createSyncRoutes, } from '@syncular/server-hono';
+import { createHttpTransport } from '@syncular/transport-http';
+import { Hono } from 'hono';
+import { createNodeHonoServer } from './hono-node-server.js';
+export async function createHttpServerFixture(options) {
+    const db = options.serverDialect === 'pglite'
+        ? createPgliteDb()
+        : createBunSqliteDb({ path: ':memory:' });
+    const dialect = options.serverDialect === 'pglite'
+        ? createPostgresServerDialect()
+        : createSqliteServerDialect();
+    await ensureSyncSchema(db, dialect);
+    if (dialect.ensureConsoleSchema) {
+        await dialect.ensureConsoleSchema(db);
+    }
+    await options.createTables(db);
+    const app = new Hono();
+    const routePath = options.routePath ?? '/sync';
+    const syncRoutes = createSyncRoutes({
+        db,
+        dialect,
+        handlers: options.handlers,
+        authenticate: options.authenticate,
+        sync: options.sync,
+    });
+    app.route(routePath, syncRoutes);
+    const httpServer = createNodeHonoServer(app, {
+        cors: options.cors,
+        corsAllowMethods: options.corsAllowMethods,
+        corsAllowHeaders: options.corsAllowHeaders,
+        corsMaxAgeSeconds: options.corsMaxAgeSeconds,
+    });
+    await new Promise((resolve) => {
+        httpServer.listen(0, resolve);
+    });
+    const address = httpServer.address();
+    const port = typeof address === 'object' && address ? address.port : 0;
+    return {
+        db,
+        dialect,
+        app,
+        httpServer,
+        baseUrl: `http://localhost:${port}`,
+        destroy: async () => {
+            await new Promise((resolve, reject) => {
+                httpServer.close((err) => {
+                    if (err) {
+                        reject(err);
+                        return;
+                    }
+                    resolve();
+                });
+            });
+            await db.destroy();
+        },
+    };
+}
+export async function createHttpClientFixture(options) {
+    const db = options.clientDialect === 'pglite'
+        ? createPgliteDb()
+        : createBunSqliteDb({ path: ':memory:' });
+    await ensureClientSyncSchema(db);
+    await options.createTables(db);
+    const handlers = new ClientTableRegistry();
+    options.registerHandlers(handlers);
+    const transport = createHttpTransport({
+        baseUrl: options.baseUrl,
+        getHeaders: options.getHeaders ??
+            (() => ({
+                'x-actor-id': options.actorId,
+            })),
+        ...(options.fetch ? { fetch: options.fetch } : {}),
+    });
+    return {
+        db,
+        transport,
+        handlers,
+        actorId: options.actorId,
+        clientId: options.clientId,
+        enqueue: (args) => enqueueOutboxCommit(db, args),
+        push: (pushOptions) => syncPushOnce(db, transport, {
+            clientId: options.clientId,
+            actorId: options.actorId,
+            plugins: pushOptions?.plugins,
+        }),
+        pull: (pullOptions) => syncPullOnce(db, transport, handlers, {
+            ...pullOptions,
+            clientId: options.clientId,
+            actorId: options.actorId,
+        }),
+        syncOnce: (syncOptions) => syncOnce(db, transport, handlers, {
+            ...syncOptions,
+            clientId: options.clientId,
+            actorId: options.actorId,
+        }),
+        destroy: async () => {
+            await db.destroy();
+        },
+    };
+}
+//# sourceMappingURL=http-fixtures.js.map

package/dist/http-fixtures.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from './assertions';
+export * from './faults';
+export * from './fixtures';
+export * from './hono-node-server';
+export * from './http-fixtures';
+export * from './project-scoped-tasks';
+export * from './runtime-process';
+export * from './sync-http';
+export * from './sync-response';
+//# 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,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+export * from './assertions.js';
+export * from './faults.js';
+export * from './fixtures.js';
+export * from './hono-node-server.js';
+export * from './http-fixtures.js';
+export * from './project-scoped-tasks.js';
+export * from './runtime-process.js';
+export * from './sync-http.js';
+export * from './sync-response.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,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC"}

package/dist/project-scoped-tasks.d.ts

@@ -0,0 +1,40 @@
+import { type SyncOperation, type SyncSubscriptionRequest } from '@syncular/core';
+import type { ServerTableHandler, SyncCoreDb } from '@syncular/server';
+import type { Kysely } from 'kysely';
+export interface ProjectScopedTasksRow {
+    id: string;
+    title: string;
+    completed: number;
+    user_id: string;
+    project_id: string;
+    server_version: number;
+}
+export interface ProjectScopedTasksDb extends SyncCoreDb {
+    tasks: ProjectScopedTasksRow;
+}
+export declare const PROJECT_SCOPED_TASKS_DDL = "\n  CREATE TABLE IF NOT EXISTS tasks (\n    id TEXT PRIMARY KEY,\n    title TEXT NOT NULL DEFAULT '',\n    completed INTEGER NOT NULL DEFAULT 0,\n    user_id TEXT NOT NULL,\n    project_id TEXT NOT NULL,\n    server_version INTEGER NOT NULL DEFAULT 1\n  )\n";
+export interface ProjectScopedTasksHandlerOptions {
+    projectScopeCount?: number;
+}
+export declare function ensureProjectScopedTasksTable<DB extends SyncCoreDb & {
+    tasks: ProjectScopedTasksRow;
+}>(db: Kysely<DB>): Promise<void>;
+export declare function createProjectScopedTasksHandler<DB extends SyncCoreDb & {
+    tasks: ProjectScopedTasksRow;
+}>(options?: ProjectScopedTasksHandlerOptions): ServerTableHandler<DB>;
+export interface CreateProjectScopedTasksSubscriptionOptions {
+    id?: string;
+    userId: string;
+    projectId?: string;
+    cursor?: number;
+}
+export declare function createProjectScopedTasksSubscription(options: CreateProjectScopedTasksSubscriptionOptions): SyncSubscriptionRequest;
+export interface CreateProjectScopedTaskUpsertOperationOptions {
+    taskId: string;
+    title: string;
+    completed?: number;
+    projectId?: string;
+    baseVersion?: number | null;
+}
+export declare function createProjectScopedTaskUpsertOperation(options: CreateProjectScopedTaskUpsertOperationOptions): SyncOperation;
+//# sourceMappingURL=project-scoped-tasks.d.ts.map

package/dist/project-scoped-tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-scoped-tasks.d.ts","sourceRoot":"","sources":["../src/project-scoped-tasks.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC7B,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAGV,kBAAkB,EAClB,UAAU,EACX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGrC,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oBAAqB,SAAQ,UAAU;IACtD,KAAK,EAAE,qBAAqB,CAAC;CAC9B;AAED,eAAO,MAAM,wBAAwB,sQASpC,CAAC;AAEF,MAAM,WAAW,gCAAgC;IAC/C,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAoBD,wBAAsB,6BAA6B,CACjD,EAAE,SAAS,UAAU,GAAG;IAAE,KAAK,EAAE,qBAAqB,CAAA;CAAE,EACxD,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/B;AAED,wBAAgB,+BAA+B,CAC7C,EAAE,SAAS,UAAU,GAAG;IAAE,KAAK,EAAE,qBAAqB,CAAA;CAAE,EACxD,OAAO,GAAE,gCAAqC,GAAG,kBAAkB,CAAC,EAAE,CAAC,CA0OxE;AAED,MAAM,WAAW,2CAA2C;IAC1D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,2CAA2C,GACnD,uBAAuB,CAWzB;AAED,MAAM,WAAW,6CAA6C;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,wBAAgB,sCAAsC,CACpD,OAAO,EAAE,6CAA6C,GACrD,aAAa,CAYf"}

package/dist/project-scoped-tasks.js

@@ -0,0 +1,245 @@
+import { isRecord, } from '@syncular/core';
+import { sql } from 'kysely';
+export const PROJECT_SCOPED_TASKS_DDL = `
+  CREATE TABLE IF NOT EXISTS tasks (
+    id TEXT PRIMARY KEY,
+    title TEXT NOT NULL DEFAULT '',
+    completed INTEGER NOT NULL DEFAULT 0,
+    user_id TEXT NOT NULL,
+    project_id TEXT NOT NULL,
+    server_version INTEGER NOT NULL DEFAULT 1
+  )
+`;
+function parseProjectScopedTaskPayload(payload) {
+    if (!isRecord(payload)) {
+        return {};
+    }
+    return {
+        title: typeof payload.title === 'string' ? payload.title : undefined,
+        completed: typeof payload.completed === 'number' ? payload.completed : undefined,
+        project_id: typeof payload.project_id === 'string' ? payload.project_id : undefined,
+    };
+}
+export async function ensureProjectScopedTasksTable(db) {
+    await sql.raw(PROJECT_SCOPED_TASKS_DDL).execute(db);
+}
+export function createProjectScopedTasksHandler(options = {}) {
+    const projectScopeCount = Math.max(1, options.projectScopeCount ?? 100);
+    return {
+        table: 'tasks',
+        scopePatterns: ['user:{user_id}:project:{project_id}'],
+        async resolveScopes(ctx) {
+            return {
+                user_id: ctx.actorId,
+                project_id: Array.from({ length: projectScopeCount }, (_, index) => `p${index}`),
+            };
+        },
+        extractScopes(row) {
+            return {
+                user_id: String(row.user_id ?? ''),
+                project_id: String(row.project_id ?? ''),
+            };
+        },
+        async snapshot(ctx) {
+            const userIdValue = ctx.scopeValues.user_id;
+            const projectIdValue = ctx.scopeValues.project_id;
+            const userId = Array.isArray(userIdValue) ? userIdValue[0] : userIdValue;
+            const projectId = Array.isArray(projectIdValue)
+                ? projectIdValue[0]
+                : projectIdValue;
+            if (!userId || userId !== ctx.actorId) {
+                return { rows: [], nextCursor: null };
+            }
+            if (!projectId) {
+                return { rows: [], nextCursor: null };
+            }
+            const pageSize = Math.max(1, Math.min(10_000, ctx.limit));
+            const cursor = ctx.cursor;
+            const cursorFilter = cursor && cursor.length > 0
+                ? sql `and ${sql.ref('id')} > ${sql.val(cursor)}`
+                : sql ``;
+            const result = await sql `
+        select id, title, completed, user_id, project_id, server_version
+        from tasks
+        where user_id = ${sql.val(userId)}
+          and project_id = ${sql.val(projectId)}
+        ${cursorFilter}
+        order by id asc
+        limit ${sql.val(pageSize + 1)}
+      `.execute(ctx.db);
+            const rows = result.rows;
+            const hasMore = rows.length > pageSize;
+            const pageRows = hasMore ? rows.slice(0, pageSize) : rows;
+            const nextCursor = hasMore
+                ? (pageRows[pageRows.length - 1]?.id ?? null)
+                : null;
+            return {
+                rows: pageRows,
+                nextCursor: typeof nextCursor === 'string' && nextCursor.length > 0
+                    ? nextCursor
+                    : null,
+            };
+        },
+        async applyOperation(ctx, op, opIndex) {
+            if (op.table !== 'tasks') {
+                return {
+                    result: {
+                        opIndex,
+                        status: 'error',
+                        error: `UNKNOWN_TABLE:${op.table}`,
+                        code: 'UNKNOWN_TABLE',
+                        retriable: false,
+                    },
+                    emittedChanges: [],
+                };
+            }
+            if (op.op === 'delete') {
+                const existingResult = await sql `
+          select id, project_id from tasks
+          where id = ${sql.val(op.row_id)} and user_id = ${sql.val(ctx.actorId)}
+          limit 1
+        `.execute(ctx.trx);
+                const existing = existingResult.rows[0];
+                if (!existing) {
+                    return { result: { opIndex, status: 'applied' }, emittedChanges: [] };
+                }
+                await sql `
+          delete from tasks
+          where id = ${sql.val(op.row_id)} and user_id = ${sql.val(ctx.actorId)}
+        `.execute(ctx.trx);
+                const emitted = {
+                    table: 'tasks',
+                    row_id: op.row_id,
+                    op: 'delete',
+                    row_json: null,
+                    row_version: null,
+                    scopes: { user_id: ctx.actorId, project_id: existing.project_id },
+                };
+                return {
+                    result: { opIndex, status: 'applied' },
+                    emittedChanges: [emitted],
+                };
+            }
+            const payload = parseProjectScopedTaskPayload(op.payload);
+            const existingResult = await sql `
+        select id, title, completed, project_id, server_version
+        from tasks
+        where id = ${sql.val(op.row_id)} and user_id = ${sql.val(ctx.actorId)}
+        limit 1
+      `.execute(ctx.trx);
+            const existing = existingResult.rows[0];
+            if (existing &&
+                op.base_version != null &&
+                existing.server_version !== op.base_version) {
+                return {
+                    result: {
+                        opIndex,
+                        status: 'conflict',
+                        message: `Version conflict: server=${existing.server_version}, base=${op.base_version}`,
+                        server_version: existing.server_version,
+                        server_row: {
+                            id: existing.id,
+                            title: existing.title,
+                            completed: existing.completed,
+                            user_id: ctx.actorId,
+                            project_id: existing.project_id,
+                            server_version: existing.server_version,
+                        },
+                    },
+                    emittedChanges: [],
+                };
+            }
+            const projectId = payload.project_id ?? existing?.project_id;
+            if (!projectId) {
+                return {
+                    result: {
+                        opIndex,
+                        status: 'error',
+                        error: 'MISSING_PROJECT_ID',
+                        code: 'INVALID_REQUEST',
+                        retriable: false,
+                    },
+                    emittedChanges: [],
+                };
+            }
+            if (existing) {
+                const nextVersion = existing.server_version + 1;
+                await sql `
+          update tasks set
+            title = ${sql.val(payload.title ?? existing.title)},
+            completed = ${sql.val(payload.completed ?? existing.completed)},
+            server_version = ${sql.val(nextVersion)}
+          where id = ${sql.val(op.row_id)} and user_id = ${sql.val(ctx.actorId)}
+        `.execute(ctx.trx);
+            }
+            else {
+                await sql `
+          insert into tasks (id, title, completed, user_id, project_id, server_version)
+          values (
+            ${sql.val(op.row_id)},
+            ${sql.val(payload.title ?? '')},
+            ${sql.val(payload.completed ?? 0)},
+            ${sql.val(ctx.actorId)},
+            ${sql.val(projectId)},
+            ${sql.val(1)}
+          )
+        `.execute(ctx.trx);
+            }
+            const updatedResult = await sql `
+        select id, title, completed, user_id, project_id, server_version
+        from tasks
+        where id = ${sql.val(op.row_id)} and user_id = ${sql.val(ctx.actorId)}
+        limit 1
+      `.execute(ctx.trx);
+            const updated = updatedResult.rows[0];
+            if (!updated) {
+                throw new Error('TASKS_ROW_NOT_FOUND');
+            }
+            const emitted = {
+                table: 'tasks',
+                row_id: op.row_id,
+                op: 'upsert',
+                row_json: {
+                    id: updated.id,
+                    title: updated.title,
+                    completed: updated.completed,
+                    user_id: updated.user_id,
+                    project_id: updated.project_id,
+                    server_version: updated.server_version,
+                },
+                row_version: updated.server_version,
+                scopes: { user_id: ctx.actorId, project_id: updated.project_id },
+            };
+            return {
+                result: { opIndex, status: 'applied' },
+                emittedChanges: [emitted],
+            };
+        },
+    };
+}
+export function createProjectScopedTasksSubscription(options) {
+    return {
+        id: options.id ?? 'sub-tasks',
+        table: 'tasks',
+        scopes: {
+            user_id: options.userId,
+            project_id: options.projectId ?? 'p0',
+        },
+        cursor: options.cursor ?? 0,
+        bootstrapState: null,
+    };
+}
+export function createProjectScopedTaskUpsertOperation(options) {
+    return {
+        table: 'tasks',
+        row_id: options.taskId,
+        op: 'upsert',
+        payload: {
+            title: options.title,
+            completed: options.completed ?? 0,
+            project_id: options.projectId ?? 'p0',
+        },
+        base_version: options.baseVersion ?? null,
+    };
+}
+//# sourceMappingURL=project-scoped-tasks.js.map

package/dist/project-scoped-tasks.js.map

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

package/dist/runtime-process.d.ts

@@ -0,0 +1,11 @@
+import type { ChildProcess } from 'node:child_process';
+export interface WaitForJsonPortOptions {
+    timeoutMs?: number;
+    processName?: string;
+}
+export declare function waitForJsonPortFromStdout(process: ChildProcess, options?: WaitForJsonPortOptions): Promise<number>;
+export interface StopChildProcessOptions {
+    gracePeriodMs?: number;
+}
+export declare function stopChildProcess(process: ChildProcess, options?: StopChildProcessOptions): Promise<void>;
+//# sourceMappingURL=runtime-process.d.ts.map

package/dist/runtime-process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-process.d.ts","sourceRoot":"","sources":["../src/runtime-process.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,MAAM,CAAC,CAiFjB;AAED,MAAM,WAAW,uBAAuB;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,IAAI,CAAC,CAgCf"}

package/dist/runtime-process.js

@@ -0,0 +1,92 @@
+export async function waitForJsonPortFromStdout(process, options = {}) {
+    const timeoutMs = options.timeoutMs ?? 30_000;
+    const processName = options.processName ?? 'Child process';
+    return new Promise((resolve, reject) => {
+        const stdout = process.stdout;
+        const stderr = process.stderr;
+        if (!stdout || !stderr) {
+            reject(new Error(`${processName} has no stdout/stderr pipes`));
+            return;
+        }
+        let stdoutBuffer = '';
+        let stderrBuffer = '';
+        const cleanup = () => {
+            clearTimeout(timeout);
+            stdout.off('data', onStdoutData);
+            stderr.off('data', onStderrData);
+            process.off('exit', onExit);
+        };
+        const resolvePort = (port) => {
+            cleanup();
+            resolve(port);
+        };
+        const rejectWith = (error) => {
+            cleanup();
+            reject(error);
+        };
+        const onStdoutData = (chunk) => {
+            stdoutBuffer += chunk.toString();
+            const lines = stdoutBuffer.split('\n');
+            stdoutBuffer = lines.pop() ?? '';
+            for (const line of lines) {
+                const trimmed = line.trim();
+                if (!trimmed) {
+                    continue;
+                }
+                try {
+                    const parsed = JSON.parse(trimmed);
+                    if (parsed.port && parsed.port > 0) {
+                        resolvePort(parsed.port);
+                        return;
+                    }
+                }
+                catch {
+                    // keep reading until a valid JSON line is emitted
+                }
+            }
+        };
+        const onStderrData = (chunk) => {
+            stderrBuffer += chunk.toString();
+        };
+        const onExit = (code, signal) => {
+            rejectWith(new Error(`${processName} exited before reporting port (code=${String(code)} signal=${String(signal)})\nstderr: ${stderrBuffer}`));
+        };
+        const timeout = setTimeout(() => {
+            rejectWith(new Error(`${processName} startup timed out after ${timeoutMs}ms\nstderr: ${stderrBuffer}`));
+        }, timeoutMs);
+        stdout.on('data', onStdoutData);
+        stderr.on('data', onStderrData);
+        process.on('exit', onExit);
+    });
+}
+export async function stopChildProcess(process, options = {}) {
+    if (process.exitCode != null) {
+        return;
+    }
+    const gracePeriodMs = options.gracePeriodMs ?? 5000;
+    try {
+        process.kill('SIGTERM');
+    }
+    catch {
+        return;
+    }
+    await new Promise((resolve) => {
+        const onExit = () => {
+            clearTimeout(timeout);
+            process.off('exit', onExit);
+            resolve();
+        };
+        const timeout = setTimeout(() => {
+            try {
+                process.kill('SIGKILL');
+            }
+            catch {
+                // ignore
+            }
+            process.off('exit', onExit);
+            resolve();
+        }, gracePeriodMs);
+        process.on('exit', onExit);
+    });
+}
+//# sourceMappingURL=runtime-process.js.map

package/dist/runtime-process.js.map

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