@mantajs/test-utils 0.2.0-beta.0

package/dist/core-types.d.ts

@@ -0,0 +1,369 @@
+export type MantaErrorType = 'NOT_FOUND' | 'INVALID_DATA' | 'UNAUTHORIZED' | 'FORBIDDEN' | 'DUPLICATE_ERROR' | 'CONFLICT' | 'NOT_ALLOWED' | 'UNEXPECTED_STATE' | 'DB_ERROR' | 'UNKNOWN_MODULES' | 'INVALID_STATE' | 'NOT_IMPLEMENTED' | 'RESOURCE_EXHAUSTED';
+export declare class MantaError extends Error {
+    readonly type: MantaErrorType;
+    readonly code?: string;
+    readonly date: Date;
+    readonly __isMantaError: true;
+    constructor(type: MantaErrorType, message: string, options?: {
+        code?: string;
+    });
+    static is(err: unknown): err is MantaError;
+}
+export declare class PermanentSubscriberError extends Error {
+    readonly cause: Error;
+    readonly __isPermanentSubscriber: true;
+    constructor(cause: Error);
+}
+export declare function permanentSubscriberFailure(error: Error): PermanentSubscriberError;
+export type ServiceLifetime = 'SINGLETON' | 'SCOPED' | 'TRANSIENT';
+export interface AuthContext {
+    id: string;
+    type: string;
+    email?: string;
+    auth_identity_id?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface Message<T = unknown> {
+    eventName: string;
+    data: T;
+    metadata: {
+        auth_context?: AuthContext;
+        eventGroupId?: string;
+        transactionId?: string;
+        timestamp: number;
+        idempotencyKey?: string;
+        source?: string;
+    };
+}
+export interface Context {
+    transactionManager?: unknown;
+    manager?: unknown;
+    isolationLevel?: string;
+    enableNestedTransactions?: boolean;
+    eventGroupId?: string;
+    transactionId?: string;
+    runId?: string;
+    requestId?: string;
+    messageAggregator?: IMessageAggregator;
+    idempotencyKey?: string;
+    isCancelling?: boolean;
+    auth_context?: AuthContext;
+}
+export interface StepExecutionContext {
+    container: MantaApp;
+    metadata: {
+        attempt: number;
+        idempotencyKey: string;
+        action: 'invoke' | 'compensate';
+    };
+    context: Context;
+}
+export interface JobResult {
+    status: 'success' | 'failure' | 'skipped';
+    data?: unknown;
+    error?: MantaError;
+    duration_ms: number;
+}
+export interface JobExecution {
+    job_name: string;
+    started_at: Date;
+    finished_at: Date;
+    status: 'success' | 'failure' | 'skipped';
+    error?: string;
+    attempt: number;
+}
+export interface MantaErrorResponse {
+    type: string;
+    message: string;
+    code?: string;
+    details?: unknown;
+    stack?: string;
+}
+export interface RelationPagination {
+    [relationName: string]: {
+        limit?: number;
+        offset?: number;
+    };
+}
+export interface CursorPagination {
+    cursor?: string;
+    limit: number;
+    direction: 'forward' | 'backward';
+}
+export interface WorkflowLifecycleEvent {
+    type: 'STEP_SUCCESS' | 'STEP_FAILURE' | 'FINISH' | 'COMPENSATE_BEGIN' | 'COMPENSATE_END';
+    workflowId: string;
+    transactionId: string;
+    stepId?: string;
+    result?: unknown;
+    error?: MantaError;
+    status?: string;
+}
+export interface AuthCredentials {
+    bearer?: string;
+    apiKey?: string;
+    sessionId?: string;
+}
+export interface SessionOptions {
+    ttl?: number;
+}
+export interface TransactionOptions {
+    isolationLevel?: 'READ UNCOMMITTED' | 'READ COMMITTED' | 'REPEATABLE READ' | 'SERIALIZABLE';
+    transaction?: unknown;
+    enableNestedTransactions?: boolean;
+}
+export interface DatabaseConfig {
+    url: string;
+    pool?: {
+        min?: number;
+        max?: number;
+        idleTimeout?: number;
+    };
+    ssl?: boolean;
+}
+export interface GroupStatus {
+    exists: boolean;
+    eventCount: number;
+    createdAt: number;
+    ttlRemainingMs?: number;
+}
+/** SPEC-001 — MantaApp (replaces IContainer) */
+export interface MantaApp<TModules extends Record<string, unknown> = Record<string, unknown>, TWorkflows extends Record<string, (...args: unknown[]) => Promise<unknown>> = Record<string, (...args: unknown[]) => Promise<unknown>>> {
+    id: string;
+    modules: TModules;
+    workflows: TWorkflows;
+    resolve<T = unknown>(key: string): T;
+    dispose(): Promise<void>;
+}
+/** SPEC-064/077 — Cache */
+export interface ICachePort {
+    get(key: string): Promise<string | null>;
+    set(key: string, data: string, ttl?: number): Promise<void>;
+    invalidate(key: string): Promise<void>;
+    clear(): Promise<void>;
+}
+/** SPEC-034 — Event Bus */
+export interface IEventBusPort {
+    emit(event: Message | Message[], options?: {
+        groupId?: string;
+    }): Promise<void>;
+    subscribe(eventName: string, handler: (event: Message) => Promise<void> | void, options?: {
+        subscriberId?: string;
+    }): void;
+    unsubscribe(subscriberId: string): void;
+    releaseGroupedEvents(eventGroupId: string): Promise<void>;
+    clearGroupedEvents(eventGroupId: string): Promise<void>;
+    addInterceptor(fn: (message: Message, context?: {
+        isGrouped?: boolean;
+        eventGroupId?: string;
+    }) => Promise<void> | void): void;
+    removeInterceptor(fn: (message: Message, context?: {
+        isGrouped?: boolean;
+        eventGroupId?: string;
+    }) => Promise<void> | void): void;
+    onGroupCreated?(handler: (eventGroupId: string, eventCount: number) => void): void;
+    onGroupReleased?(handler: (eventGroupId: string, eventCount: number) => void): void;
+    onGroupCleared?(handler: (eventGroupId: string, eventCount: number, reason: 'explicit' | 'ttl') => void): void;
+    getGroupStatus?(eventGroupId: string): GroupStatus | null;
+}
+/** SPEC-066/089/090 — Locking */
+export interface ILockingPort {
+    execute<T>(keys: string[], job: () => Promise<T>, options?: {
+        timeout?: number;
+    }): Promise<T>;
+    acquire(keys: string | string[], options?: {
+        ownerId?: string;
+        expire?: number;
+    }): Promise<boolean>;
+    release(keys: string | string[], options?: {
+        ownerId?: string;
+    }): Promise<void>;
+    releaseAll(options?: {
+        ownerId?: string;
+    }): Promise<void>;
+}
+/** SPEC-056 — Database */
+export interface IDatabasePort {
+    initialize(config: DatabaseConfig): Promise<void>;
+    dispose(): Promise<void>;
+    healthCheck(): Promise<boolean>;
+    getClient(): unknown;
+    getPool(): unknown;
+    /** Execute raw parameterized SQL. Use $1, $2 placeholders. Escape hatch for complex queries. */
+    raw<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<T[]>;
+    transaction<T>(fn: (tx: unknown) => Promise<T>, options?: TransactionOptions): Promise<T>;
+    introspect?(): Promise<unknown>;
+}
+/** SPEC-126 — Repository */
+export interface IRepository<T = unknown> {
+    find(options?: {
+        where?: Record<string, unknown>;
+        withDeleted?: boolean;
+        limit?: number;
+        offset?: number;
+        order?: Record<string, 'ASC' | 'DESC'>;
+        cursor?: CursorPagination;
+    }): Promise<T[]>;
+    findAndCount(options?: Record<string, unknown>): Promise<[T[], number]>;
+    create(data: Record<string, unknown> | Record<string, unknown>[]): Promise<T | T[]>;
+    update(data: Record<string, unknown> | Record<string, unknown>[]): Promise<T | T[]>;
+    delete(ids: string | string[]): Promise<void>;
+    softDelete(ids: string | string[]): Promise<Record<string, string[]>>;
+    restore(ids: string | string[]): Promise<void>;
+    serialize(data: unknown, options?: unknown): Promise<unknown>;
+    upsertWithReplace(data: Record<string, unknown>[], replaceFields?: string[], conflictTarget?: string[]): Promise<T[]>;
+    transaction<TManager = unknown>(task: (transactionManager: TManager) => Promise<unknown>, options?: TransactionOptions): Promise<unknown>;
+}
+/** SPEC-063 — Job Scheduler */
+export interface IJobSchedulerPort {
+    register(name: string, schedule: string, handler: (app: MantaApp) => Promise<JobResult>, options?: {
+        concurrency?: 'allow' | 'forbid';
+        numberOfExecutions?: number;
+        retry?: {
+            maxRetries: number;
+            backoff?: 'fixed' | 'exponential';
+            delay?: number;
+        };
+    }): void;
+    runJob(name: string): Promise<JobResult>;
+    getJobHistory(jobName: string, limit?: number): Promise<JobExecution[]>;
+}
+/** SPEC-065/080/081 — File */
+export interface IFilePort {
+    upload(key: string, data: Buffer | ReadableStream, contentType?: string): Promise<{
+        key: string;
+        url: string;
+    }>;
+    delete(key: string | string[]): Promise<void>;
+    getPresignedDownloadUrl(key: string): Promise<string>;
+    getPresignedUploadUrl?(key: string): Promise<string>;
+    getDownloadStream(key: string): Promise<ReadableStream>;
+    getAsBuffer(key: string): Promise<Buffer>;
+    list(prefix?: string): Promise<string[]>;
+    getUploadStream?(key: string): Promise<{
+        stream: WritableStream;
+        done: Promise<void>;
+    }>;
+}
+/** SPEC-067/082 — Logger */
+export interface ILoggerPort {
+    error(msg: string, ...args: unknown[]): void;
+    warn(msg: string, ...args: unknown[]): void;
+    info(msg: string, ...args: unknown[]): void;
+    http(msg: string, ...args: unknown[]): void;
+    verbose(msg: string, ...args: unknown[]): void;
+    debug(msg: string, ...args: unknown[]): void;
+    silly(msg: string, ...args: unknown[]): void;
+    panic(data: unknown): void;
+    activity(msg: string): string;
+    progress(id: string, msg: string): void;
+    success(id: string, msg: string): void;
+    failure(id: string, msg: string): void;
+    shouldLog(level: string): boolean;
+    setLogLevel(level: string): void;
+    unsetLogLevel(): void;
+}
+/** SPEC-049 — Auth (crypto pure) */
+export interface IAuthPort {
+    verifyJwt(token: string): AuthContext | null;
+    verifyApiKey(key: string): AuthContext | null;
+    createJwt(payload: AuthContext, options?: {
+        expiresIn?: string | number;
+    }): string;
+}
+/** SPEC-050 — Auth Module Service (business logic + sessions) */
+export interface IAuthModuleService {
+    authenticate(data: Record<string, unknown>): Promise<AuthContext | null>;
+    register(data: Record<string, unknown>): Promise<{
+        authIdentity: unknown;
+    }>;
+    validateCallback(data: Record<string, unknown>): Promise<AuthContext | null>;
+    createSession(authContext: AuthContext, options?: SessionOptions): Promise<{
+        sessionId: string;
+        expiresAt: Date;
+    }>;
+    destroySession(sessionId: string): Promise<void>;
+    verifySession(sessionId: string): Promise<AuthContext | null>;
+}
+/** SPEC-049b — Auth Gateway */
+export interface IAuthGateway {
+    authenticate(credentials: AuthCredentials): Promise<AuthContext | null>;
+}
+/** SPEC-018 — Message Aggregator */
+export interface IMessageAggregator {
+    save(messages: Message[]): void;
+    getMessages(options?: {
+        groupBy?: string;
+        sortBy?: string;
+    }): Message[];
+    clearMessages(): void;
+}
+/** SPEC-097 — Notification */
+export interface INotificationPort {
+    send(notification: {
+        to: string;
+        channel: string;
+        from?: string;
+        replyTo?: string | string[];
+        subject?: string;
+        html?: string;
+        text?: string;
+        headers?: Record<string, string>;
+        tags?: Array<{
+            name: string;
+            value: string;
+        }>;
+        idempotency_key?: string;
+    }): Promise<{
+        status: 'SUCCESS' | 'FAILURE' | 'PENDING';
+        id?: string;
+        error?: Error;
+    }>;
+    sendBatch?(notifications: Array<Parameters<INotificationPort['send']>[0]>): Promise<Array<Awaited<ReturnType<INotificationPort['send']>>>>;
+    list?(): Promise<unknown[]>;
+    retrieve?(id: string): Promise<unknown | null>;
+}
+/** SPEC-039 — HTTP Port (simplified for testing) */
+export interface IHttpPort {
+    registerRoute(method: string, path: string, handler: (req: Request) => Promise<Response> | Response): void;
+    handleRequest(req: Request): Promise<Response>;
+}
+export interface DmlProperty {
+    type: string;
+    nullable?: boolean;
+    default?: unknown;
+    index?: boolean | string;
+    unique?: boolean | string;
+    primaryKey?: boolean;
+    computed?: boolean;
+    searchable?: boolean;
+    translatable?: boolean;
+}
+export interface DmlRelation {
+    type: 'hasOne' | 'hasOneWithFK' | 'belongsTo' | 'hasMany' | 'manyToMany';
+    target: () => unknown;
+    options?: Record<string, unknown>;
+}
+export interface DmlEntity {
+    name: string;
+    tableName?: string;
+    schema: Record<string, DmlProperty | DmlRelation>;
+    cascades?: {
+        delete?: string[];
+        detach?: string[];
+    };
+    indexes?: Array<{
+        on: string[];
+        unique?: boolean;
+        where?: string | Record<string, unknown>;
+        name?: string;
+        type?: string;
+    }>;
+    checks?: Array<{
+        name?: string;
+        expression: string | ((columns: Record<string, string>) => string);
+    }>;
+}
+export declare function deriveWorkflowTransactionId(workflowId: string, event: Message): string;
+export declare function mapExternalError(error: Error, context?: string): MantaError;
+//# sourceMappingURL=core-types.d.ts.map

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

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

package/dist/core-types.js

@@ -0,0 +1,44 @@
+// @mantajs/core — Port interfaces and framework types
+// This file defines the contracts. Adapters implement them. Tests assert against them.
+export class MantaError extends Error {
+    type;
+    code;
+    date;
+    __isMantaError = true;
+    constructor(type, message, options) {
+        super(message);
+        this.type = type;
+        this.code = options?.code;
+        this.date = new Date();
+        this.name = 'MantaError';
+    }
+    static is(err) {
+        return (typeof err === 'object' && err !== null && '__isMantaError' in err && err.__isMantaError === true);
+    }
+}
+export class PermanentSubscriberError extends Error {
+    cause;
+    __isPermanentSubscriber = true;
+    constructor(cause) {
+        super(cause.message);
+        this.cause = cause;
+        this.name = 'PermanentSubscriberError';
+    }
+}
+export function permanentSubscriberFailure(error) {
+    return new PermanentSubscriberError(error);
+}
+// =============================================================================
+// Utility exports
+// =============================================================================
+export function deriveWorkflowTransactionId(workflowId, event) {
+    if (event.metadata.idempotencyKey) {
+        return `${workflowId}:${event.metadata.idempotencyKey}`;
+    }
+    return `${workflowId}:${crypto.randomUUID()}`;
+}
+export function mapExternalError(error, context) {
+    const message = context ? `${context}: ${error.message}` : error.message;
+    return new MantaError('UNEXPECTED_STATE', message);
+}
+//# sourceMappingURL=core-types.js.map

package/dist/core-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-types.js","sourceRoot":"","sources":["../src/core-types.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,uFAAuF;AAqBvF,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,IAAI,CAAgB;IACpB,IAAI,CAAS;IACb,IAAI,CAAM;IACV,cAAc,GAAG,IAAa,CAAA;IAEvC,YAAY,IAAoB,EAAE,OAAe,EAAE,OAA2B;QAC5E,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,CAAA;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAA;QACtB,IAAI,CAAC,IAAI,GAAG,YAAY,CAAA;IAC1B,CAAC;IAED,MAAM,CAAC,EAAE,CAAC,GAAY;QACpB,OAAO,CACL,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,gBAAgB,IAAI,GAAG,IAAK,GAAkB,CAAC,cAAc,KAAK,IAAI,CAClH,CAAA;IACH,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IAErB;IADnB,uBAAuB,GAAG,IAAa,CAAA;IAChD,YAA4B,KAAY;QACtC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QADM,UAAK,GAAL,KAAK,CAAO;QAEtC,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAA;IACxC,CAAC;CACF;AAED,MAAM,UAAU,0BAA0B,CAAC,KAAY;IACrD,OAAO,IAAI,wBAAwB,CAAC,KAAK,CAAC,CAAA;AAC5C,CAAC;AAyWD,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF,MAAM,UAAU,2BAA2B,CAAC,UAAkB,EAAE,KAAc;IAC5E,IAAI,KAAK,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC;QAClC,OAAO,GAAG,UAAU,IAAI,KAAK,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAA;IACzD,CAAC;IACD,OAAO,GAAG,UAAU,IAAI,MAAM,CAAC,UAAU,EAAE,EAAE,CAAA;AAC/C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAY,EAAE,OAAgB;IAC7D,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAA;IACxE,OAAO,IAAI,UAAU,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAA;AACpD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,127 @@
+export type { AuthContext, AuthCredentials, Context, CursorPagination, DatabaseConfig, EnvProfile, GeneratedSchema, GroupStatus, IAnalyticsProvider, IAuthGateway, IAuthModuleService, IAuthPort, ICachePort, IDatabasePort, IEventBusPort, IFilePort, IHttpPort, IJobSchedulerPort, ILockingPort, ILoggerPort, IMessageAggregator, INotificationPort, IRepository, IRepositoryFactory, ISchemaGenerator, ISearchProvider, JobExecution, JobResult, LogEntry, MantaApp, MantaConfig, MantaErrorResponse, MantaErrorType, Message, ParsedDmlEntity, ParsedDmlIndex, ParsedDmlProperty, ParsedDmlRelation, PresetAdapterEntry, PresetDefinition, ProjectConfig, RequestContext, SessionOptions, TestAuthConfig, TransactionOptions, WorkflowLifecycleEvent, } from '@mantajs/core';
+export { ConfigManager, ContainerRegistrationKeys, createApp, defineConfig, FlagRouter, generateDrizzleSchema, InMemoryCacheAdapter, InMemoryDatabaseAdapter, InMemoryEventBusAdapter, InMemoryFileAdapter, InMemoryHttpAdapter, InMemoryJobScheduler, InMemoryLockingAdapter, InMemoryNotificationAdapter, InMemoryRepository, InMemoryRepositoryFactory, InMemoryTransaction, MantaError, MessageAggregator, MockAuthGateway, MockAuthModuleService, MockAuthPort, makeIdempotent, PermanentSubscriberError, parseDmlEntity, permanentSubscriberFailure, runInRequestContext, TestLogger, } from '@mantajs/core';
+import type { Context, MantaApp, Message, RequestContext, TestAuthConfig } from '@mantajs/core';
+import { MockAuthGateway, MockAuthModuleService, MockAuthPort, TestLogger } from '@mantajs/core';
+interface TestAppOptions {
+    overrides?: Partial<Record<string, unknown>>;
+}
+/**
+ * Creates a MantaApp with all in-memory adapters for testing.
+ */
+export declare function createTestApp(options?: TestAppOptions): MantaApp<Record<string, unknown>>;
+/**
+ * Silent logger that captures all output for assertions.
+ */
+export declare function createTestLogger(): TestLogger;
+interface TestAuthResult {
+    authPort: MockAuthPort;
+    authModuleService: MockAuthModuleService;
+    authGateway: MockAuthGateway;
+}
+/**
+ * Mock IAuthPort + IAuthModuleService with configurable responses.
+ */
+export declare function createTestAuth(config?: TestAuthConfig): TestAuthResult;
+/**
+ * Resets all in-memory adapters in the app.
+ * Call in `afterEach` for isolation between tests.
+ */
+export declare function resetAll(app: MantaApp): Promise<void>;
+export interface TestDb {
+    withRollback<T>(fn: (tx: unknown) => Promise<T>): Promise<T>;
+    cleanup(): Promise<void>;
+}
+/**
+ * Creates an in-memory test database with rollback-per-test isolation.
+ */
+export declare function createTestDb(_options?: {
+    schema?: unknown[];
+}): Promise<TestDb>;
+export interface EventSpy {
+    received(eventName: string): boolean;
+    payloads(eventName: string): Message[];
+    count(eventName: string): number;
+    all(): Array<{
+        name: string;
+        payload: Message;
+        timestamp: number;
+    }>;
+    reset(): void;
+}
+/**
+ * Intercepts all events emitted via IEventBusPort for assertion.
+ * Non-intrusive — real subscribers still receive events.
+ */
+export declare function spyOnEvents(app: MantaApp): EventSpy;
+/**
+ * Creates a minimal valid Context (SPEC-060) for testing.
+ */
+export declare function createTestContext(overrides?: Partial<Context>): Context;
+export interface MigrationTestContext {
+    defineDml(entities: unknown[]): void;
+    generate(): Promise<{
+        sql: string;
+    }>;
+    migrate(): Promise<void>;
+    diff(): Promise<{
+        differences: Array<{
+            table: string;
+            column?: string;
+            action: string;
+            warning?: string;
+        }>;
+    }>;
+    rollback(): Promise<void>;
+    cleanup(): Promise<void>;
+}
+/**
+ * Stub for migration testing context. Requires PG local.
+ */
+export declare function createMigrationTestContext(_options?: Record<string, unknown>): Promise<MigrationTestContext>;
+export interface ScopeLeakChecker {
+    /** Track an object (scope, context) that should be GC'd after the test */
+    track(scope: object): void;
+    /** Verify all tracked objects were garbage collected */
+    verify(): Promise<void>;
+}
+/**
+ * Asserts that no scope references are leaked after a test.
+ * Tracks WeakRef to scope/context objects and verifies they are GC'd.
+ *
+ * Requires Node with --expose-gc flag for reliable results.
+ * Without GC access, verify() is a no-op (no false positives).
+ *
+ * @example
+ * const leak = assertNoScopeLeak(app)
+ * const ctx = createTestContext()
+ * leak.track(ctx)
+ * // ... test code that should release ctx ...
+ * await leak.verify()
+ */
+export declare function assertNoScopeLeak(_app: MantaApp): ScopeLeakChecker;
+/**
+ * Creates a scoped execution context using AsyncLocalStorage.
+ * Useful for testing SCOPED services that require an active request context.
+ *
+ * Wraps the callback in runInRequestContext from @mantajs/core so that
+ * getRequestContext() returns a valid RequestContext inside the callback.
+ *
+ * @example
+ * await withScope(app, async (scope) => {
+ *   // getRequestContext() returns { requestId: scope.requestId }
+ *   const svc = app.modules.stats
+ *   await svc.increment('counter')
+ * })
+ */
+export declare function withScope<T>(_app: MantaApp, fn: (scope: RequestContext) => Promise<T>): Promise<T>;
+/**
+ * Validates that a value can be safely serialized for workflow checkpoints.
+ * Throws MantaError if the value contains BigInt, Map, Set, Buffer, or Function.
+ *
+ * @example
+ * validateSerializability({ count: 42, name: 'ok' }) // passes
+ * validateSerializability({ m: new Map() })           // throws
+ */
+export declare function validateSerializability(value: unknown, path?: string): void;
+export { deriveWorkflowTransactionId, mapExternalError } from './core-types';
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,378 @@
+// =============================================================================
+// @mantajs/test-utils — Test helpers ONLY
+// =============================================================================
+//
+// All adapter implementations live in @mantajs/core/adapters.
+// This package re-exports them for backward compatibility and provides
+// test-only helpers (createTestApp, spyOnEvents, resetAll, etc.).
+//
+// References: TEST_STRATEGY.md Section 4 (§4.1 → §4.12)
+// =============================================================================
+// Re-export everything from @mantajs/core so tests can import from @mantajs/test-utils
+export { ConfigManager, ContainerRegistrationKeys, 
+// App
+createApp, 
+// Config
+defineConfig, FlagRouter, generateDrizzleSchema, 
+// Adapters (re-exported from @mantajs/core)
+InMemoryCacheAdapter, InMemoryDatabaseAdapter, InMemoryEventBusAdapter, InMemoryFileAdapter, InMemoryHttpAdapter, InMemoryJobScheduler, InMemoryLockingAdapter, InMemoryNotificationAdapter, InMemoryRepository, InMemoryRepositoryFactory, InMemoryTransaction, 
+// Types & errors
+MantaError, 
+// Events
+MessageAggregator, MockAuthGateway, MockAuthModuleService, MockAuthPort, 
+// Subscriber utilities
+makeIdempotent, PermanentSubscriberError, 
+// DML Generator
+parseDmlEntity, permanentSubscriberFailure, 
+// Request context
+runInRequestContext, TestLogger, } from '@mantajs/core';
+import { createApp, InMemoryCacheAdapter, InMemoryEventBusAdapter, InMemoryFileAdapter, InMemoryLockingAdapter, MantaError, MessageAggregator, MockAuthGateway, MockAuthModuleService, MockAuthPort, runInRequestContext, TestLogger, } from '@mantajs/core';
+/**
+ * Creates a MantaApp with all in-memory adapters for testing.
+ */
+export function createTestApp(options) {
+    const eventBus = new InMemoryEventBusAdapter();
+    const logger = new TestLogger();
+    const cache = new InMemoryCacheAdapter();
+    const locking = new InMemoryLockingAdapter();
+    const file = new InMemoryFileAdapter();
+    const builder = createApp({
+        infra: { eventBus, logger, cache, locking, file, db: {} },
+    });
+    // Register overrides as modules if provided
+    if (options?.overrides) {
+        for (const [key, value] of Object.entries(options.overrides)) {
+            if (value !== undefined)
+                builder.registerModule(key, value);
+        }
+    }
+    return builder.build();
+}
+// =============================================================================
+// §4.3 — createTestLogger
+// =============================================================================
+/**
+ * Silent logger that captures all output for assertions.
+ */
+export function createTestLogger() {
+    return new TestLogger();
+}
+/**
+ * Mock IAuthPort + IAuthModuleService with configurable responses.
+ */
+export function createTestAuth(config) {
+    const authPort = new MockAuthPort(config);
+    const authModuleService = new MockAuthModuleService(config);
+    const authGateway = new MockAuthGateway(authPort, authModuleService);
+    return { authPort, authModuleService, authGateway };
+}
+// =============================================================================
+// §4.5 — resetAll (accepts MantaApp)
+// =============================================================================
+/**
+ * Resets all in-memory adapters in the app.
+ * Call in `afterEach` for isolation between tests.
+ */
+export async function resetAll(app) {
+    const resettables = [
+        'ICachePort',
+        'IEventBusPort',
+        'ILoggerPort',
+        'IFilePort',
+        'INotificationPort',
+        'IJobSchedulerPort',
+        'IAuthModuleService',
+        'IHttpPort',
+        'IRepository',
+    ];
+    for (const key of resettables) {
+        try {
+            const svc = app.resolve(key);
+            if (svc && typeof svc._reset === 'function') {
+                ;
+                svc._reset();
+            }
+            else if (svc && typeof svc.clear === 'function') {
+                await svc.clear();
+            }
+        }
+        catch {
+            // Service not registered — skip
+        }
+    }
+}
+import { generateDrizzleSchema, InMemoryTransaction, parseDmlEntity } from '@mantajs/core';
+/**
+ * Creates an in-memory test database with rollback-per-test isolation.
+ */
+export async function createTestDb(_options) {
+    const tables = new Map();
+    const schema = new Map();
+    let disposed = false;
+    return {
+        async withRollback(fn) {
+            if (disposed) {
+                throw new MantaError('INVALID_STATE', 'Database has been disposed');
+            }
+            const snapshot = new Map();
+            for (const [name, rows] of tables) {
+                const rowsCopy = new Map();
+                for (const [id, row] of rows) {
+                    rowsCopy.set(id, { ...row });
+                }
+                snapshot.set(name, rowsCopy);
+            }
+            const schemaCopy = new Map(schema);
+            const tx = new InMemoryTransaction(snapshot, schemaCopy);
+            return fn(tx);
+        },
+        async cleanup() {
+            disposed = true;
+            tables.clear();
+            schema.clear();
+        },
+    };
+}
+/**
+ * Intercepts all events emitted via IEventBusPort for assertion.
+ * Non-intrusive — real subscribers still receive events.
+ */
+export function spyOnEvents(app) {
+    const captured = [];
+    const bus = app.resolve('IEventBusPort');
+    const interceptor = (message) => {
+        captured.push({ name: message.eventName, payload: message, timestamp: Date.now() });
+    };
+    bus.addInterceptor(interceptor);
+    return {
+        received(eventName) {
+            return captured.some((e) => e.name === eventName);
+        },
+        payloads(eventName) {
+            return captured.filter((e) => e.name === eventName).map((e) => e.payload);
+        },
+        count(eventName) {
+            return captured.filter((e) => e.name === eventName).length;
+        },
+        all() {
+            return [...captured];
+        },
+        reset() {
+            captured.length = 0;
+        },
+    };
+}
+// =============================================================================
+// §4.8 — createTestContext
+// =============================================================================
+/**
+ * Creates a minimal valid Context (SPEC-060) for testing.
+ */
+export function createTestContext(overrides) {
+    return {
+        transactionManager: undefined,
+        manager: undefined,
+        isolationLevel: 'READ COMMITTED',
+        enableNestedTransactions: false,
+        eventGroupId: undefined,
+        transactionId: undefined,
+        requestId: crypto.randomUUID(),
+        messageAggregator: new MessageAggregator(),
+        idempotencyKey: crypto.randomUUID(),
+        isCancelling: false,
+        auth_context: undefined,
+        ...overrides,
+    };
+}
+/**
+ * Stub for migration testing context. Requires PG local.
+ */
+export async function createMigrationTestContext(_options) {
+    let entities = [];
+    let generatedSchemas = [];
+    let migratedSchemas = [];
+    let generatedSql = '';
+    return {
+        defineDml(dmlEntities) {
+            entities = dmlEntities;
+            generatedSchemas = entities.map((e) => generateDrizzleSchema(parseDmlEntity(e)));
+        },
+        async generate() {
+            const sqlParts = [];
+            for (let i = 0; i < entities.length; i++) {
+                const entity = entities[i];
+                const schema = generatedSchemas[i];
+                const tableName = `${entity.name.toLowerCase()}s`;
+                const cols = Object.entries(schema.columns)
+                    .map(([name, col]) => `  "${name}" ${col.type}${col.notNull ? ' NOT NULL' : ''}`)
+                    .join(',\n');
+                sqlParts.push(`CREATE TABLE IF NOT EXISTS "${tableName}" (\n${cols}\n);`);
+                for (const idx of schema.indexes) {
+                    const using = idx.using ? ` USING ${idx.using}` : '';
+                    const where = idx.where ? ` WHERE ${idx.where}` : '';
+                    sqlParts.push(`CREATE INDEX "${idx.name}" ON "${tableName}"${using} (${idx.columns.map((c) => `"${c}"`).join(', ')})${where};`);
+                }
+            }
+            generatedSql = sqlParts.join('\n\n');
+            return { sql: generatedSql };
+        },
+        async migrate() {
+            migratedSchemas = generatedSchemas.map((s) => ({
+                columns: { ...s.columns },
+                relations: { ...s.relations },
+                indexes: [...s.indexes],
+                checks: [...s.checks],
+            }));
+        },
+        async diff() {
+            const differences = [];
+            for (let i = 0; i < entities.length; i++) {
+                const entity = entities[i];
+                const tableName = `${entity.name.toLowerCase()}s`;
+                const expected = generatedSchemas[i];
+                if (i >= migratedSchemas.length) {
+                    for (const colName of Object.keys(expected.columns)) {
+                        differences.push({ table: tableName, column: colName, action: 'CREATE' });
+                    }
+                    continue;
+                }
+                const migrated = migratedSchemas[i];
+                for (const [colName, colDef] of Object.entries(expected.columns)) {
+                    if (!migrated.columns[colName]) {
+                        differences.push({ table: tableName, column: colName, action: 'CREATE' });
+                    }
+                    else if (migrated.columns[colName].type !== colDef.type) {
+                        differences.push({
+                            table: tableName,
+                            column: colName,
+                            action: 'ALTER',
+                            warning: `unsafe type change from ${migrated.columns[colName].type} to ${colDef.type}`,
+                        });
+                    }
+                }
+            }
+            return { differences };
+        },
+        async rollback() {
+            if (migratedSchemas.length === 0 && generatedSql === '') {
+                throw new MantaError('NOT_FOUND', 'No rollback file found');
+            }
+            migratedSchemas = [];
+        },
+        async cleanup() {
+            entities = [];
+            generatedSchemas = [];
+            migratedSchemas = [];
+            generatedSql = '';
+        },
+    };
+}
+/**
+ * Asserts that no scope references are leaked after a test.
+ * Tracks WeakRef to scope/context objects and verifies they are GC'd.
+ *
+ * Requires Node with --expose-gc flag for reliable results.
+ * Without GC access, verify() is a no-op (no false positives).
+ *
+ * @example
+ * const leak = assertNoScopeLeak(app)
+ * const ctx = createTestContext()
+ * leak.track(ctx)
+ * // ... test code that should release ctx ...
+ * await leak.verify()
+ */
+export function assertNoScopeLeak(_app) {
+    const scopeRefs = [];
+    return {
+        track(scope) {
+            scopeRefs.push(new WeakRef(scope));
+        },
+        async verify() {
+            // Without --expose-gc, we cannot force GC — skip to avoid false positives
+            if (!globalThis.gc)
+                return;
+            globalThis.gc();
+            // Give GC a tick to finalize
+            await new Promise((r) => setTimeout(r, 50));
+            globalThis.gc();
+            const leaked = scopeRefs.filter((ref) => ref.deref() !== undefined);
+            if (leaked.length > 0) {
+                throw new MantaError('INVALID_STATE', `Scope leak detected: ${leaked.length} scope(s) not garbage collected`);
+            }
+        },
+    };
+}
+// =============================================================================
+// §4.10 — withScope
+// =============================================================================
+/**
+ * Creates a scoped execution context using AsyncLocalStorage.
+ * Useful for testing SCOPED services that require an active request context.
+ *
+ * Wraps the callback in runInRequestContext from @mantajs/core so that
+ * getRequestContext() returns a valid RequestContext inside the callback.
+ *
+ * @example
+ * await withScope(app, async (scope) => {
+ *   // getRequestContext() returns { requestId: scope.requestId }
+ *   const svc = app.modules.stats
+ *   await svc.increment('counter')
+ * })
+ */
+export async function withScope(_app, fn) {
+    const ctx = {
+        requestId: crypto.randomUUID(),
+    };
+    return runInRequestContext(ctx, () => fn(ctx));
+}
+// =============================================================================
+// §4.11 — validateSerializability (WS-08/WS-09/WS-10)
+// =============================================================================
+/**
+ * Validates that a value can be safely serialized for workflow checkpoints.
+ * Throws MantaError if the value contains BigInt, Map, Set, Buffer, or Function.
+ *
+ * @example
+ * validateSerializability({ count: 42, name: 'ok' }) // passes
+ * validateSerializability({ m: new Map() })           // throws
+ */
+export function validateSerializability(value, path = '') {
+    if (value === null || value === undefined)
+        return;
+    if (typeof value === 'bigint') {
+        throw new MantaError('INVALID_DATA', `Non-serializable value at ${path || 'root'}: BigInt`);
+    }
+    if (value instanceof Map) {
+        throw new MantaError('INVALID_DATA', `Non-serializable value at ${path || 'root'}: Map`);
+    }
+    if (value instanceof Set) {
+        throw new MantaError('INVALID_DATA', `Non-serializable value at ${path || 'root'}: Set`);
+    }
+    if (typeof Buffer !== 'undefined' && Buffer.isBuffer(value)) {
+        throw new MantaError('INVALID_DATA', `Non-serializable value at ${path || 'root'}: Buffer`);
+    }
+    if (typeof value === 'function') {
+        throw new MantaError('INVALID_DATA', `Non-serializable value at ${path || 'root'}: Function`);
+    }
+    if (value instanceof Date) {
+        // Dates are JSON-serializable (toJSON → ISO string)
+        return;
+    }
+    if (Array.isArray(value)) {
+        value.forEach((item, i) => {
+            validateSerializability(item, `${path}[${i}]`);
+        });
+        return;
+    }
+    if (typeof value === 'object') {
+        for (const [key, val] of Object.entries(value)) {
+            validateSerializability(val, path ? `${path}.${key}` : key);
+        }
+    }
+}
+// =============================================================================
+// §4.12 — deriveWorkflowTransactionId & mapExternalError
+// =============================================================================
+// Re-export from core-types (standalone contract definitions)
+export { deriveWorkflowTransactionId, mapExternalError } from './core-types';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/pg.d.ts

@@ -0,0 +1,15 @@
+export declare const TEST_DB_URL: string;
+/**
+ * Creates an isolated test database.
+ * Each test file gets its own database for parallel execution.
+ */
+export declare function createTestDatabase(name?: string): Promise<{
+    url: string;
+    cleanup: () => Promise<void>;
+}>;
+/**
+ * Waits for PostgreSQL to be accessible.
+ * Used in globalSetup for integration tests.
+ */
+export declare function waitForPg(maxRetries?: number): Promise<void>;
+//# sourceMappingURL=pg.d.ts.map

package/dist/pg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg.d.ts","sourceRoot":"","sources":["../src/pg.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,WAAW,QAA0E,CAAA;AAElG;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/D,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B,CAAC,CA6BD;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,UAAU,SAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB9D"}

package/dist/pg.js

@@ -0,0 +1,71 @@
+// Test utility for PostgreSQL integration tests
+// Creates isolated databases per test file for parallel execution.
+//
+// TEST_DATABASE_URL is the BOOTSTRAP connection used to CREATE/DROP per-test
+// databases — not the test database itself. It must point to a DB that always
+// exists on the target server. `postgres` is the conventional admin DB on any
+// PostgreSQL install, so we default to that.
+//
+// Consumers of this module (integration tests, runtime smoke, build-start smoke)
+// MUST import from here and MUST NOT redeclare their own TEST_DATABASE_URL
+// default — see BACKLOG BC-F21 for the rationale.
+export const TEST_DB_URL = process.env.TEST_DATABASE_URL || 'postgresql://localhost:5432/postgres';
+/**
+ * Creates an isolated test database.
+ * Each test file gets its own database for parallel execution.
+ */
+export async function createTestDatabase(name) {
+    // Dynamic import to avoid requiring pg for unit tests
+    const { default: pg } = await import('pg');
+    const { Client } = pg;
+    const dbName = name || `test_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+    const client = new Client({ connectionString: TEST_DB_URL });
+    await client.connect();
+    await client.query(`DROP DATABASE IF EXISTS "${dbName}"`);
+    await client.query(`CREATE DATABASE "${dbName}"`);
+    await client.end();
+    const url = TEST_DB_URL.replace(/\/[^/]+$/, `/${dbName}`);
+    return {
+        url,
+        cleanup: async () => {
+            const c = new Client({ connectionString: TEST_DB_URL });
+            await c.connect();
+            // Kill active connections before dropping
+            await c.query(`
+        SELECT pg_terminate_backend(pid)
+        FROM pg_stat_activity
+        WHERE datname = '${dbName}' AND pid <> pg_backend_pid()
+      `);
+            await c.query(`DROP DATABASE IF EXISTS "${dbName}"`);
+            await c.end();
+        },
+    };
+}
+/**
+ * Waits for PostgreSQL to be accessible.
+ * Used in globalSetup for integration tests.
+ */
+export async function waitForPg(maxRetries = 30) {
+    const { default: pg } = await import('pg');
+    const { Client } = pg;
+    for (let i = 0; i < maxRetries; i++) {
+        const client = new Client({ connectionString: TEST_DB_URL });
+        try {
+            await client.connect();
+            await client.query('SELECT 1');
+            await client.end();
+            return;
+        }
+        catch {
+            try {
+                await client.end();
+            }
+            catch {
+                /* ignore */
+            }
+            await new Promise((r) => setTimeout(r, 1000));
+        }
+    }
+    throw new Error(`PostgreSQL not reachable at ${TEST_DB_URL} after ${maxRetries}s`);
+}
+//# sourceMappingURL=pg.js.map

package/dist/pg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg.js","sourceRoot":"","sources":["../src/pg.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,mEAAmE;AACnE,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,8EAA8E;AAC9E,6CAA6C;AAC7C,EAAE;AACF,iFAAiF;AACjF,2EAA2E;AAC3E,kDAAkD;AAElD,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,sCAAsC,CAAA;AAElG;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAa;IAIpD,sDAAsD;IACtD,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAA;IAC1C,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,CAAA;IAErB,MAAM,MAAM,GAAG,IAAI,IAAI,QAAQ,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAA;IACrF,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAC,CAAA;IAC5D,MAAM,MAAM,CAAC,OAAO,EAAE,CAAA;IACtB,MAAM,MAAM,CAAC,KAAK,CAAC,4BAA4B,MAAM,GAAG,CAAC,CAAA;IACzD,MAAM,MAAM,CAAC,KAAK,CAAC,oBAAoB,MAAM,GAAG,CAAC,CAAA;IACjD,MAAM,MAAM,CAAC,GAAG,EAAE,CAAA;IAElB,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,MAAM,EAAE,CAAC,CAAA;IAEzD,OAAO;QACL,GAAG;QACH,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAC,CAAA;YACvD,MAAM,CAAC,CAAC,OAAO,EAAE,CAAA;YACjB,0CAA0C;YAC1C,MAAM,CAAC,CAAC,KAAK,CAAC;;;2BAGO,MAAM;OAC1B,CAAC,CAAA;YACF,MAAM,CAAC,CAAC,KAAK,CAAC,4BAA4B,MAAM,GAAG,CAAC,CAAA;YACpD,MAAM,CAAC,CAAC,GAAG,EAAE,CAAA;QACf,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,UAAU,GAAG,EAAE;IAC7C,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAA;IAC1C,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,CAAA;IAErB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAC,CAAA;QAC5D,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,OAAO,EAAE,CAAA;YACtB,MAAM,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;YAC9B,MAAM,MAAM,CAAC,GAAG,EAAE,CAAA;YAClB,OAAM;QACR,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,GAAG,EAAE,CAAA;YACpB,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;YACD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;QAC/C,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,+BAA+B,WAAW,UAAU,UAAU,GAAG,CAAC,CAAA;AACpF,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@mantajs/test-utils",
+  "version": "0.2.0-beta.0",
+  "description": "Test helpers and in-memory adapters for the Manta framework",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./core-types": {
+      "types": "./dist/core-types.d.ts",
+      "import": "./dist/core-types.js",
+      "default": "./dist/core-types.js"
+    },
+    "./pg": {
+      "types": "./dist/pg.d.ts",
+      "import": "./dist/pg.js",
+      "default": "./dist/pg.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "pg": "^8.13.0",
+    "@mantajs/core": "0.2.0-beta.0"
+  },
+  "devDependencies": {
+    "@types/pg": "^8.11.10",
+    "typescript": "^5.4.0"
+  },
+  "peerDependencies": {
+    "vitest": "^2.0.0"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit"
+  }
+}