pipework 0.7.11 → 0.7.13

package/dist/core/surface/start.js

@@ -0,0 +1,64 @@
+import { validateSurfaces, validateNoJobTypeDuplicates } from './validate.js';
+import { getBaseLogger } from '../logging/index.js';
+export async function startSurfaces(context, config, surfaces) {
+    const logger = getBaseLogger();
+    validateSurfaces(config, surfaces);
+    validateNoJobTypeDuplicates(surfaces);
+    const handles = new Map();
+    const startOrder = [];
+    const entries = Object.entries(surfaces);
+    const scripts = entries.filter(([, s]) => s.kind === 'script');
+    const workers = entries.filter(([, s]) => s.kind === 'worker');
+    const httpSurfaces = entries.filter(([, s]) => s.kind === 'http');
+    const ordered = [...scripts, ...workers, ...httpSurfaces];
+    for (const [name, surface] of ordered) {
+        logger.info({ surface: name, kind: surface.kind }, `Starting surface "${name}"`);
+        try {
+            const handle = await surface.start(context);
+            handles.set(name, handle);
+            startOrder.push(name);
+            if (handle.address !== undefined) {
+                logger.info({ surface: name, address: handle.address }, `Surface "${name}" listening`);
+            }
+        }
+        catch (err) {
+            logger.error({ surface: name, err }, `Failed to start surface "${name}"`);
+            for (const started of startOrder.reverse()) {
+                try {
+                    await handles.get(started).stop();
+                }
+                catch (stopErr) {
+                    logger.error({ surface: started, err: stopErr }, `Failed to stop surface "${started}" during rollback`);
+                }
+            }
+            throw new Error(`[pipework] Failed to start surface "${name}".\n\n` +
+                `  ${err instanceof Error ? err.message : String(err)}\n\n` +
+                `  Surfaces that were started have been stopped.\n`);
+        }
+    }
+    return {
+        handles,
+        async stop() {
+            const stopOrder = [...startOrder].reverse();
+            const errors = [];
+            for (const name of stopOrder) {
+                const handle = handles.get(name);
+                if (handle === undefined)
+                    continue;
+                try {
+                    logger.info({ surface: name }, `Stopping surface "${name}"`);
+                    await handle.stop();
+                }
+                catch (err) {
+                    logger.error({ surface: name, err }, `Error stopping surface "${name}"`);
+                    errors.push({ name, error: err });
+                }
+            }
+            if (errors.length > 0) {
+                const details = errors.map(e => `  - ${e.name}: ${e.error instanceof Error ? e.error.message : String(e.error)}`).join('\n');
+                throw new Error(`[pipework] Errors occurred while stopping surfaces:\n\n${details}\n`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=start.js.map

package/dist/core/surface/start.js.map

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

package/dist/core/surface/types.d.ts

@@ -0,0 +1,118 @@
+import type { Handler } from '../../request/di/types.js';
+import type { Resource } from '../../request/fixture/types.js';
+import type { ServerConfig } from '../../request/http/types.js';
+import type { QueueConfig, BackoffConfig } from '../../async/jobs/queue.js';
+export type SurfaceKind = 'http' | 'worker' | 'script';
+export interface SurfaceManifest {
+    readonly databases: readonly string[];
+    readonly jobTypes: readonly string[];
+    readonly dependencies: Readonly<Record<string, string>>;
+}
+export interface SurfaceHandle {
+    readonly kind: SurfaceKind;
+    readonly address?: string;
+    stop(): Promise<void>;
+}
+export interface Surface {
+    readonly kind: SurfaceKind;
+    readonly manifest: SurfaceManifest;
+    start(context: SurfaceContext): Promise<SurfaceHandle>;
+}
+export interface SurfaceBuilder extends Surface {
+    dependencies(d: Record<string, string>): SurfaceBuilder;
+}
+export interface HttpSurfaceBuilder extends SurfaceBuilder {
+    test(context: SurfaceContext): Promise<TestClient>;
+}
+export interface TestClient {
+    inject(opts: import('../../request/http/types.js').InjectOptions): Promise<import('../../request/http/types.js').InjectResponse>;
+    close(): Promise<void>;
+}
+export interface SurfaceContext {
+    readonly config: {
+        readonly environment: string;
+        database(name?: string): {
+            readonly name: string;
+            readonly url: string;
+        };
+        databases(): ReadonlyMap<string, {
+            readonly name: string;
+        }>;
+        databaseNames(): readonly string[];
+        defaultDatabaseName(): string;
+        readonly observability: {
+            readonly slowQueryMs: number;
+            readonly logAllQueries: boolean;
+            readonly poolMetricsInterval: number;
+        };
+        readonly raw: unknown;
+    };
+    readonly env: Readonly<Record<string, unknown>>;
+    readonly pool: {
+        getOrCreate(config: {
+            readonly name: string;
+            readonly url: string;
+        }): {
+            readonly drizzle: import('../../data/db/index.js').DB;
+            close(): Promise<void>;
+        };
+        get(name: string): {
+            readonly drizzle: import('../../data/db/index.js').DB;
+            close(): Promise<void>;
+        } | undefined;
+        closeAll(): Promise<void>;
+        count(): number;
+    };
+    readonly isolation: {
+        markBegin(): void;
+        markEnd(): void;
+        assertClean(): void;
+    };
+    readonly connections: {
+        track(id: string, name: string, context: string): void;
+        release(id: string): void;
+        activeCount(): number;
+    };
+}
+export interface HttpSurfaceConfig {
+    readonly handlers?: readonly Handler<Record<string, unknown>, unknown>[];
+    readonly resources?: readonly Resource<unknown>[];
+    readonly port?: number;
+    readonly host?: string;
+    readonly auth?: ServerConfig['auth'];
+    readonly tenant?: ServerConfig['tenant'];
+    readonly cors?: ServerConfig['cors'];
+    readonly security?: ServerConfig['security'];
+    readonly rateLimit?: ServerConfig['rateLimit'];
+    readonly openapi?: ServerConfig['openapi'];
+    readonly rbac?: ServerConfig['rbac'];
+    readonly transactionPerRequest?: ServerConfig['transactionPerRequest'];
+    readonly transactionTimeoutMs?: ServerConfig['transactionTimeoutMs'];
+    readonly healthChecks?: ServerConfig['healthChecks'];
+    readonly logging?: ServerConfig['logging'];
+    readonly logger?: ServerConfig['logger'];
+    readonly trustProxy?: ServerConfig['trustProxy'];
+    readonly gracefulShutdownMs?: number;
+}
+export interface RetryConfig {
+    readonly attempts: number;
+    readonly backoff?: BackoffConfig;
+}
+export interface WorkerSurfaceConfig {
+    readonly jobs: readonly Handler<Record<string, unknown>, unknown>[];
+    readonly database?: string;
+    readonly concurrency?: number;
+    readonly pollIntervalMs?: number;
+    readonly queue?: QueueConfig;
+}
+export interface ScriptSurfaceConfig {
+    readonly databases?: readonly string[];
+    readonly run: (context: ScriptContext) => Promise<void>;
+}
+export interface ScriptContext {
+    readonly config: SurfaceContext['config'];
+    readonly env: SurfaceContext['env'];
+    readonly pool: SurfaceContext['pool'];
+}
+export type SurfaceMap = Record<string, Surface>;
+//# sourceMappingURL=types.d.ts.map

package/dist/core/surface/types.d.ts.map

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

package/dist/core/surface/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/surface/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/surface/types.ts"],"names":[],"mappings":""}

package/dist/core/surface/validate.d.ts

@@ -0,0 +1,7 @@
+import type { ResolvedConfig } from '../config/load.js';
+import type { SurfaceMap } from './types.js';
+import type { ValidationIssue } from '../validation/types.js';
+export declare function validateSurfaces(config: ResolvedConfig, surfaces: SurfaceMap): void;
+export declare function collectSurfaceIssues(surfaces: SurfaceMap, configuredDatabases: readonly string[], defaultDbAvailable: boolean): ValidationIssue[];
+export declare function validateNoJobTypeDuplicates(surfaces: SurfaceMap): void;
+//# sourceMappingURL=validate.d.ts.map

package/dist/core/surface/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/core/surface/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,KAAK,EAAW,UAAU,EAAE,MAAM,YAAY,CAAA;AAErD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAE7D,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,UAAU,GAAG,IAAI,CAoCnF;AAwBD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,UAAU,EACpB,mBAAmB,EAAE,SAAS,MAAM,EAAE,EACtC,kBAAkB,EAAE,OAAO,GAC1B,eAAe,EAAE,CAwDnB;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI,CAuBtE"}

package/dist/core/surface/validate.js

@@ -0,0 +1,121 @@
+import { DEFAULT_DB } from '../../request/di/types.js';
+export function validateSurfaces(config, surfaces) {
+    const problems = [];
+    const configuredDbs = new Set(config.databaseNames());
+    for (const [name, surface] of Object.entries(surfaces)) {
+        for (const db of surface.manifest.databases) {
+            if (db === DEFAULT_DB) {
+                if (configuredDbs.size > 1) {
+                    try {
+                        config.defaultDatabaseName();
+                    }
+                    catch {
+                        problems.push(`Surface "${name}" uses the default database, but multiple databases are configured.\n` +
+                            `    Configured: ${[...configuredDbs].join(', ')}\n` +
+                            `    Fix: Pass an explicit database name — e.g., surface.worker({ database: "${[...configuredDbs][0]}" })`);
+                    }
+                }
+            }
+            else if (!configuredDbs.has(db)) {
+                const available = [...configuredDbs].join(', ');
+                problems.push(`Surface "${name}" requires database "${db}" which is not configured.\n` +
+                    `    Configured databases: ${available || '(none)'}\n` +
+                    `    Fix: Add "${db}" to your databases config, or correct the name in the surface definition.`);
+            }
+        }
+        validateSurfaceKind(name, surface, problems);
+    }
+    if (problems.length > 0) {
+        throw new Error(`[pipework] Surface validation failed:\n\n${problems.map((p, i) => `  ${i + 1}. ${p}`).join('\n\n')}\n`);
+    }
+}
+function validateSurfaceKind(name, surface, problems) {
+    if (surface.kind === 'worker') {
+        if (surface.manifest.jobTypes.length === 0) {
+            problems.push(`Surface "${name}" is a worker with no job handlers.\n` +
+                '    Fix: Pass at least one job handler — surface.worker({ jobs: [myJob] })');
+        }
+        const seen = new Set();
+        for (const jobType of surface.manifest.jobTypes) {
+            if (seen.has(jobType)) {
+                problems.push(`Surface "${name}" has duplicate job type "${jobType}".\n` +
+                    '    Each job type must have exactly one handler.');
+            }
+            seen.add(jobType);
+        }
+    }
+}
+export function collectSurfaceIssues(surfaces, configuredDatabases, defaultDbAvailable) {
+    const issues = [];
+    const dbSet = new Set(configuredDatabases);
+    for (const [name, surface] of Object.entries(surfaces)) {
+        for (const db of surface.manifest.databases) {
+            if (db === DEFAULT_DB) {
+                if (!defaultDbAvailable) {
+                    issues.push({
+                        phase: 'surface',
+                        message: `"${name}" uses the default database, but multiple databases are configured: ${configuredDatabases.join(', ')}`,
+                    });
+                }
+            }
+            else if (!dbSet.has(db)) {
+                issues.push({
+                    phase: 'surface',
+                    message: `"${name}" requires database "${db}" which is not configured (available: ${configuredDatabases.join(', ')})`,
+                });
+            }
+        }
+        if (surface.kind === 'worker' && surface.manifest.jobTypes.length === 0) {
+            issues.push({
+                phase: 'surface',
+                message: `"${name}" is a worker with no job handlers`,
+            });
+        }
+        const seen = new Set();
+        for (const jobType of surface.manifest.jobTypes) {
+            if (seen.has(jobType)) {
+                issues.push({
+                    phase: 'surface',
+                    message: `"${name}" has duplicate job type "${jobType}"`,
+                });
+            }
+            seen.add(jobType);
+        }
+    }
+    const jobOwners = new Map();
+    for (const [name, surface] of Object.entries(surfaces)) {
+        for (const jobType of surface.manifest.jobTypes) {
+            const existing = jobOwners.get(jobType);
+            if (existing !== undefined) {
+                issues.push({
+                    phase: 'surface',
+                    message: `job type "${jobType}" handled by both "${existing}" and "${name}"`,
+                });
+            }
+            else {
+                jobOwners.set(jobType, name);
+            }
+        }
+    }
+    return issues;
+}
+export function validateNoJobTypeDuplicates(surfaces) {
+    const owners = new Map();
+    const problems = [];
+    for (const [name, surface] of Object.entries(surfaces)) {
+        for (const jobType of surface.manifest.jobTypes) {
+            const existing = owners.get(jobType);
+            if (existing !== undefined) {
+                problems.push(`Job type "${jobType}" is handled by both "${existing}" and "${name}".\n` +
+                    '    Each job type must be handled by exactly one worker surface.');
+            }
+            else {
+                owners.set(jobType, name);
+            }
+        }
+    }
+    if (problems.length > 0) {
+        throw new Error(`[pipework] Job type conflict:\n\n${problems.map((p, i) => `  ${i + 1}. ${p}`).join('\n\n')}\n`);
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/core/surface/validate.js.map

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

package/dist/core/surface/worker.d.ts

@@ -0,0 +1,3 @@
+import type { SurfaceBuilder, WorkerSurfaceConfig } from './types.js';
+export declare function createWorkerSurface(config: WorkerSurfaceConfig): SurfaceBuilder;
+//# sourceMappingURL=worker.d.ts.map

package/dist/core/surface/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../../src/core/surface/worker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAiB,mBAAmB,EAAkB,MAAM,YAAY,CAAA;AAQpG,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,cAAc,CA8F/E"}

package/dist/core/surface/worker.js

@@ -0,0 +1,151 @@
+import { randomUUID } from 'node:crypto';
+import { DEFAULT_DB } from '../../request/di/types.js';
+import { createQueue } from '../../async/jobs/queue.js';
+import { executeJob } from '../../async/jobs/execute.js';
+import { sql } from '../../data/db/sql.js';
+export function createWorkerSurface(config) {
+    const databases = collectWorkerDatabases(config);
+    const jobTypes = collectJobTypes(config.jobs);
+    validateJobHandlers(config.jobs);
+    const deps = {};
+    const surface = {
+        kind: 'worker',
+        manifest: { databases, jobTypes, dependencies: deps },
+        dependencies(d) {
+            Object.assign(deps, d);
+            return surface;
+        },
+        async start(context) {
+            const queue = createQueue(config.queue);
+            const dbName = config.database ?? context.config.defaultDatabaseName();
+            const dbConfig = context.config.database(dbName);
+            const conn = context.pool.getOrCreate(dbConfig);
+            const db = conn.drizzle;
+            await db.execute(sql `SELECT 1`);
+            const dispatch = buildDispatchTable(config.jobs);
+            const concurrency = config.concurrency ?? 1;
+            const pollIntervalMs = config.pollIntervalMs ?? 1000;
+            const shouldRun = { value: true };
+            const claimLoop = async () => {
+                const workerId = randomUUID();
+                while (shouldRun.value) {
+                    try {
+                        const claimed = await queue.claim(db, workerId);
+                        if (claimed === null) {
+                            await sleep(pollIntervalMs);
+                            continue;
+                        }
+                        const handler = dispatch.get(claimed.type);
+                        if (handler === undefined) {
+                            await queue.fail(db, claimed.id, new Error(`[pipework] No handler registered for job type "${claimed.type}".\n\n` +
+                                `  Registered types: ${[...dispatch.keys()].join(', ')}\n` +
+                                '  This job was enqueued with a type that no handler recognizes.\n'));
+                            continue;
+                        }
+                        const heartbeatInterval = setInterval(() => {
+                            void queue.heartbeat(db, claimed.id);
+                        }, 30_000);
+                        try {
+                            const timeoutMs = handler.meta.jobTimeout ?? undefined;
+                            const result = await executeWithTimeout(() => executeJob(handler, {
+                                instance: context,
+                                jobId: claimed.id,
+                                jobType: claimed.type,
+                                input: claimed.payload,
+                            }), timeoutMs, claimed.type, claimed.id);
+                            await queue.complete(db, claimed.id, result);
+                        }
+                        catch (err) {
+                            await queue.fail(db, claimed.id, err);
+                        }
+                        finally {
+                            clearInterval(heartbeatInterval);
+                        }
+                    }
+                    catch {
+                        await sleep(pollIntervalMs);
+                    }
+                }
+            };
+            const workers = Array.from({ length: concurrency }, () => claimLoop());
+            return {
+                kind: 'worker',
+                async stop() {
+                    shouldRun.value = false;
+                    await Promise.allSettled(workers);
+                },
+            };
+        },
+    };
+    return surface;
+}
+function buildDispatchTable(jobs) {
+    const table = new Map();
+    for (const job of jobs) {
+        const jobType = job.meta.jobType;
+        if (typeof jobType === 'string') {
+            table.set(jobType, job);
+        }
+    }
+    return table;
+}
+function validateJobHandlers(jobs) {
+    const seen = new Set();
+    for (const job of jobs) {
+        if (!job.meta.isJob || job.meta.jobType === null) {
+            throw new Error('[pipework] All handlers passed to surface.worker({ jobs }) must be created with .job("type-name").\n\n' +
+                '  Example:\n' +
+                '    fitting().use().job("send-email").input(schema).fit(handler)\n');
+        }
+        if (seen.has(job.meta.jobType)) {
+            throw new Error(`[pipework] Duplicate job type "${job.meta.jobType}" in worker surface.\n\n` +
+                '  Each job type must have exactly one handler. If you need multiple handlers,\n' +
+                '  create separate worker surfaces.\n');
+        }
+        seen.add(job.meta.jobType);
+    }
+}
+function collectWorkerDatabases(config) {
+    const dbs = new Set();
+    if (config.database !== undefined) {
+        dbs.add(config.database);
+    }
+    else {
+        dbs.add(DEFAULT_DB);
+    }
+    for (const job of config.jobs) {
+        for (const db of job.meta.databases) {
+            dbs.add(db);
+        }
+    }
+    return [...dbs];
+}
+function collectJobTypes(jobs) {
+    const types = [];
+    for (const j of jobs) {
+        if (typeof j.meta.jobType === 'string') {
+            types.push(j.meta.jobType);
+        }
+    }
+    return types;
+}
+async function executeWithTimeout(fn, timeoutMs, jobType, jobId) {
+    if (timeoutMs === undefined)
+        return fn();
+    const result = await Promise.race([
+        fn(),
+        new Promise((_, reject) => {
+            const timer = setTimeout(() => {
+                reject(new Error(`[pipework] Job "${jobType}" (${jobId}) timed out after ${timeoutMs}ms.\n\n` +
+                    '  The job handler did not complete within the configured timeout.\n' +
+                    '  Increase the timeout with .timeout(ms) or optimize the handler.\n'));
+            }, timeoutMs);
+            timer.unref();
+        }),
+    ]);
+    return result;
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=worker.js.map

package/dist/core/surface/worker.js.map

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

package/dist/core/validation/connectivity.d.ts

@@ -0,0 +1,4 @@
+import type { ValidationIssue } from './types.js';
+import type { ResolvedDatabase } from '../config/load.js';
+export declare function validateConnectivity(databases: ReadonlyMap<string, ResolvedDatabase>, timeoutMs?: number): Promise<ValidationIssue[]>;
+//# sourceMappingURL=connectivity.d.ts.map

package/dist/core/validation/connectivity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectivity.d.ts","sourceRoot":"","sources":["../../../src/core/validation/connectivity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEzD,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAChD,SAAS,SAAO,GACf,OAAO,CAAC,eAAe,EAAE,CAAC,CAgB5B"}

package/dist/core/validation/connectivity.js

@@ -0,0 +1,32 @@
+export async function validateConnectivity(databases, timeoutMs = 5000) {
+    const issues = [];
+    const checks = [...databases.entries()].map(async ([name, db]) => {
+        try {
+            await testConnection(db.url, timeoutMs);
+        }
+        catch (err) {
+            issues.push({
+                phase: 'database',
+                message: `cannot connect to database "${name}": ${err instanceof Error ? err.message : String(err)}`,
+            });
+        }
+    });
+    await Promise.all(checks);
+    return issues;
+}
+async function testConnection(url, timeoutMs) {
+    const { default: postgres } = await import('postgres');
+    const sql = postgres(url, {
+        max: 1,
+        idle_timeout: 1,
+        connect_timeout: Math.ceil(timeoutMs / 1000),
+        onnotice: () => { },
+    });
+    try {
+        await sql `SELECT 1`;
+    }
+    finally {
+        await sql.end({ timeout: 1 });
+    }
+}
+//# sourceMappingURL=connectivity.js.map

package/dist/core/validation/connectivity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectivity.js","sourceRoot":"","sources":["../../../src/core/validation/connectivity.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,SAAgD,EAChD,SAAS,GAAG,IAAI;IAEhB,MAAM,MAAM,GAAsB,EAAE,CAAA;IAEpC,MAAM,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE;QAC/D,IAAI,CAAC;YACH,MAAM,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;QACzC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC;gBACV,KAAK,EAAE,UAAU;gBACjB,OAAO,EAAE,+BAA+B,IAAI,MAAM,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;aACrG,CAAC,CAAA;QACJ,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACzB,OAAO,MAAM,CAAA;AACf,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,GAAW,EAAE,SAAiB;IAC1D,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAA;IAEtD,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE;QACxB,GAAG,EAAE,CAAC;QACN,YAAY,EAAE,CAAC;QACf,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAC5C,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC;KACnB,CAAC,CAAA;IAEF,IAAI,CAAC;QACH,MAAM,GAAG,CAAA,UAAU,CAAA;IACrB,CAAC;YAAS,CAAC;QACT,MAAM,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAA;IAC/B,CAAC;AACH,CAAC"}

package/dist/core/validation/doctrine.d.ts

@@ -0,0 +1,13 @@
+export interface DoctrineViolation {
+    readonly rule: string;
+    readonly file: string;
+    readonly line: number;
+    readonly message: string;
+}
+export interface DoctrineResult {
+    readonly violations: readonly DoctrineViolation[];
+    readonly scanned: number;
+}
+export declare function validateDoctrine(cwd: string, sourceFiles: readonly string[]): DoctrineResult;
+export declare function findSourceFiles(cwd: string, modulePaths: readonly string[]): string[];
+//# sourceMappingURL=doctrine.d.ts.map

package/dist/core/validation/doctrine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctrine.d.ts","sourceRoot":"","sources":["../../../src/core/validation/doctrine.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,EAAE,SAAS,iBAAiB,EAAE,CAAA;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,cAAc,CAmB5F;AAiGD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAUrF"}