pipework 0.7.12 → 0.7.17

package/dist/request/context/guard.js

@@ -0,0 +1,35 @@
+import { InvariantViolation } from '../../invariants/assert.js';
+export function verifyTransactionBinding(ctx, bound, dbName) {
+    if (bound.nonce !== ctx._nonce) {
+        throw new InvariantViolation('context-nonce-mismatch', {
+            message: `The transaction for database "${dbName}" was created in a different AsyncLocalStorage ` +
+                'context than the one currently active. This usually means Node.js swapped async contexts ' +
+                'between concurrent requests — a known ALS bug that can cause cross-tenant data leaks.',
+            transactionNonce: bound.nonce,
+            contextNonce: ctx._nonce,
+            database: dbName,
+            contextTenant: ctx.tenant,
+            requestId: ctx.requestId,
+        });
+    }
+    if (bound.tenant !== ctx.tenant) {
+        throw new InvariantViolation('tenant-context-mismatch', {
+            message: `The transaction for database "${dbName}" was created for tenant "${bound.tenant}" ` +
+                `but the current context has tenant "${ctx.tenant}". This indicates an AsyncLocalStorage ` +
+                'context swap that would cause writes to go to the wrong tenant.\n\n' +
+                '  In tests, use withFlow({ tenant }, fn) to run tenant-scoped code:\n\n' +
+                "    import { withFlow, asTenant } from 'pipework/test'\n\n" +
+                "    withFlow({ auth: asTenant('tenant-1'), tenant: 'tenant-1' }, async () => {\n" +
+                '      // pipe() and useTestDb() work correctly here\n' +
+                '    })',
+            transactionTenant: bound.tenant,
+            contextTenant: ctx.tenant,
+            database: dbName,
+            requestId: ctx.requestId,
+        });
+    }
+}
+export function bindTransaction(ctx, dbName, drizzle) {
+    return { drizzle, nonce: ctx._nonce, tenant: ctx.tenant };
+}
+//# sourceMappingURL=guard.js.map

package/dist/request/context/guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.js","sourceRoot":"","sources":["../../../src/request/context/guard.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAE/D,MAAM,UAAU,wBAAwB,CACtC,GAAS,EACT,KAAuB,EACvB,MAAc;IAEd,IAAI,KAAK,CAAC,KAAK,KAAK,GAAG,CAAC,MAAM,EAAE,CAAC;QAC/B,MAAM,IAAI,kBAAkB,CAAC,wBAAwB,EAAE;YACrD,OAAO,EACL,iCAAiC,MAAM,iDAAiD;gBACxF,2FAA2F;gBAC3F,uFAAuF;YACzF,gBAAgB,EAAE,KAAK,CAAC,KAAK;YAC7B,YAAY,EAAE,GAAG,CAAC,MAAM;YACxB,QAAQ,EAAE,MAAM;YAChB,aAAa,EAAE,GAAG,CAAC,MAAM;YACzB,SAAS,EAAE,GAAG,CAAC,SAAS;SACzB,CAAC,CAAA;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,CAAC;QAChC,MAAM,IAAI,kBAAkB,CAAC,yBAAyB,EAAE;YACtD,OAAO,EACL,iCAAiC,MAAM,6BAA6B,KAAK,CAAC,MAAM,IAAI;gBACpF,uCAAuC,GAAG,CAAC,MAAM,yCAAyC;gBAC1F,qEAAqE;gBACrE,yEAAyE;gBACzE,4DAA4D;gBAC5D,kFAAkF;gBAClF,uDAAuD;gBACvD,QAAQ;YACV,iBAAiB,EAAE,KAAK,CAAC,MAAM;YAC/B,aAAa,EAAE,GAAG,CAAC,MAAM;YACzB,QAAQ,EAAE,MAAM;YAChB,SAAS,EAAE,GAAG,CAAC,SAAS;SACzB,CAAC,CAAA;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,GAAS,EACT,MAAc,EACd,OAAW;IAEX,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAA;AAC3D,CAAC"}

package/dist/request/context/index.d.ts

@@ -0,0 +1,5 @@
+export type { Flow, RequestMetadata, BoundTransaction } from './types.js';
+export { flowStorage, getContext, requireContext, runInContext } from './store.js';
+export { createRequestContext, createJobContext, createTestContext, type CreateRequestContextOptions, type CreateJobContextOptions } from './create.js';
+export { verifyTransactionBinding, bindTransaction } from './guard.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/request/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/request/context/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AACzE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAClF,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,KAAK,2BAA2B,EAAE,KAAK,uBAAuB,EAAE,MAAM,aAAa,CAAA;AACvJ,OAAO,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA"}

package/dist/request/context/index.js

@@ -0,0 +1,4 @@
+export { flowStorage, getContext, requireContext, runInContext } from './store.js';
+export { createRequestContext, createJobContext, createTestContext } from './create.js';
+export { verifyTransactionBinding, bindTransaction } from './guard.js';
+//# sourceMappingURL=index.js.map

package/dist/request/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/request/context/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAClF,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,iBAAiB,EAAkE,MAAM,aAAa,CAAA;AACvJ,OAAO,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA"}

package/dist/request/context/store.d.ts

@@ -0,0 +1,7 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import type { Flow } from './types.js';
+export declare const flowStorage: AsyncLocalStorage<Flow<unknown>>;
+export declare function getContext<TAuth = unknown>(): Flow<TAuth> | undefined;
+export declare function requireContext<TAuth = unknown>(): Flow<TAuth>;
+export declare function runInContext<T>(ctx: Flow, fn: () => T): T;
+//# sourceMappingURL=store.d.ts.map

package/dist/request/context/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/request/context/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAEtC,eAAO,MAAM,WAAW,kCAAgC,CAAA;AAExD,wBAAgB,UAAU,CAAC,KAAK,GAAG,OAAO,KAAK,IAAI,CAAC,KAAK,CAAC,GAAG,SAAS,CAErE;AAED,wBAAgB,cAAc,CAAC,KAAK,GAAG,OAAO,KAAK,IAAI,CAAC,KAAK,CAAC,CAU7D;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEzD"}

package/dist/request/context/store.js

@@ -0,0 +1,18 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+export const flowStorage = new AsyncLocalStorage();
+export function getContext() {
+    return flowStorage.getStore();
+}
+export function requireContext() {
+    const ctx = flowStorage.getStore();
+    if (!ctx) {
+        throw new Error('[pipework] No active context. db() must be called within a request handler, job, or test.\n\n' +
+            '  Hint: If you need a connection outside of a managed context (migrations, seeds),\n' +
+            '  use instance.pool.getOrCreate(config.database("name")).drizzle instead.\n');
+    }
+    return ctx;
+}
+export function runInContext(ctx, fn) {
+    return flowStorage.run(ctx, fn);
+}
+//# sourceMappingURL=store.js.map

package/dist/request/context/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../src/request/context/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAGpD,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,iBAAiB,EAAQ,CAAA;AAExD,MAAM,UAAU,UAAU;IACxB,OAAO,WAAW,CAAC,QAAQ,EAA6B,CAAA;AAC1D,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,MAAM,GAAG,GAAG,WAAW,CAAC,QAAQ,EAA6B,CAAA;IAC7D,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,+FAA+F;YAC/F,sFAAsF;YACtF,6EAA6E,CAC9E,CAAA;IACH,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,MAAM,UAAU,YAAY,CAAI,GAAS,EAAE,EAAW;IACpD,OAAO,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;AACjC,CAAC"}

package/dist/request/context/types.d.ts

@@ -0,0 +1,28 @@
+import type { DB } from '../../data/db/index.js';
+import type { Manifold } from '../../core/pipework.js';
+/** A transaction bound to a specific context nonce and tenant — defense-in-depth against ALS context swaps. */
+export interface BoundTransaction {
+    readonly drizzle: DB;
+    readonly nonce: string;
+    readonly tenant: string | null;
+}
+/** The AsyncLocalStorage context — carries requestId, auth, tenant, active transactions, and a nonce for integrity checks. */
+export interface Flow<TAuth = unknown> {
+    readonly instance: Manifold;
+    readonly requestId: string;
+    readonly _nonce: string;
+    readonly auth: TAuth | null;
+    readonly tenant: string | null;
+    readonly metadata: RequestMetadata | null;
+    readonly jobType: string | null;
+    readonly transactions: Map<string, BoundTransaction>;
+}
+/** HTTP request metadata stored in a Flow — method, path, trace ID, session ID. */
+export interface RequestMetadata {
+    readonly method: string;
+    readonly path: string;
+    readonly startedAt: number;
+    readonly traceId: string;
+    readonly sessionId: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/request/context/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/request/context/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,wBAAwB,CAAA;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAEtD,+GAA+G;AAC/G,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAA;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B;AAED,8HAA8H;AAC9H,MAAM,WAAW,IAAI,CAAC,KAAK,GAAG,OAAO;IACnC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAA;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;CACrD;AAED,mFAAmF;AACnF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAClC"}

package/dist/request/context/types.js

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

package/dist/request/context/types.js.map

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

package/dist/request/di/builder.d.ts

@@ -0,0 +1,73 @@
+import type { Schema, Infer } from '../../data/schema/types.js';
+import type { DB } from '../../data/db/index.js';
+import type { Handler, HttpMethod, RouteMeta, AuthRequirement, PermissionMeta, JobRetryConfig } from './types.js';
+import type { ResourceOperations, Resource, PaginationConfig } from '../fixture/types.js';
+import type { HttpRequest, HttpResponse } from '../http/types.js';
+interface BuilderState {
+    databases: string[];
+    requiresAuth: boolean;
+    authRequirement: AuthRequirement;
+    inputSchema: Schema | null;
+    outputSchemas: Map<number, Schema>;
+    querySchema: Schema | null;
+    paramsSchema: Schema | null;
+    route: RouteMeta | null;
+    isJob: boolean;
+    jobType: string | null;
+    jobRetry: JobRetryConfig | null;
+    jobTimeout: number | null;
+    permission: PermissionMeta | null;
+    pagination: PaginationConfig | null;
+    wantsRequest: boolean;
+    wantsResponse: boolean;
+    wantsRawBody: boolean;
+}
+export declare class Builder<TDeps extends Record<string, unknown>> {
+    private readonly state;
+    constructor(state?: Partial<BuilderState>);
+    use(): Builder<TDeps & {
+        db: DB;
+    }>;
+    use<N extends string>(name: N): Builder<TDeps & Record<N, DB>>;
+    auth<TAuth>(): Builder<TDeps & {
+        auth: TAuth;
+    }>;
+    authOptional<TAuth>(): Builder<TDeps & {
+        auth: TAuth | null;
+    }>;
+    public(): Builder<TDeps>;
+    input<T extends Schema>(schema: T): Builder<TDeps & {
+        input: Infer<T>;
+    }>;
+    query<T extends Schema>(schema: T): Builder<TDeps & {
+        query: Infer<T>;
+    }>;
+    params<T extends Schema>(schema: T): Builder<TDeps & {
+        params: Infer<T>;
+    }>;
+    output<T extends Schema>(schema: T): Builder<TDeps>;
+    output<T extends Schema>(status: number, schema: T): Builder<TDeps>;
+    route(method: HttpMethod, path: string): Builder<TDeps>;
+    job(type?: string): Builder<TDeps>;
+    retry(config: JobRetryConfig): Builder<TDeps>;
+    timeout(ms: number): Builder<TDeps>;
+    permission(resource: string, action: string, scope?: string): Builder<TDeps>;
+    paginate(config?: {
+        defaultLimit?: number;
+        maxLimit?: number;
+    }): Builder<TDeps>;
+    request(): Builder<TDeps & {
+        request: HttpRequest;
+    }>;
+    response(): Builder<TDeps & {
+        response: HttpResponse;
+    }>;
+    rawBody(): Builder<TDeps & {
+        rawBody: Buffer;
+    }>;
+    fixture<TAuth>(name: string, operations: ResourceOperations<TAuth>): Resource<TAuth>;
+    fit<TReturn>(fn: (deps: TDeps) => Promise<TReturn>): Handler<TDeps, TReturn>;
+}
+export declare function createBuilder(): Builder<Record<string, never>>;
+export {};
+//# sourceMappingURL=builder.d.ts.map

package/dist/request/di/builder.d.ts.map

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

package/dist/request/di/builder.js

@@ -0,0 +1,189 @@
+import { DEFAULT_DB } from './types.js';
+import { buildResource } from '../fixture/builder.js';
+export class Builder {
+    state;
+    constructor(state) {
+        this.state = {
+            databases: state?.databases ?? [],
+            requiresAuth: state?.requiresAuth ?? false,
+            authRequirement: state?.authRequirement ?? 'none',
+            inputSchema: state?.inputSchema ?? null,
+            outputSchemas: state?.outputSchemas ?? new Map(),
+            querySchema: state?.querySchema ?? null,
+            paramsSchema: state?.paramsSchema ?? null,
+            route: state?.route ?? null,
+            isJob: state?.isJob ?? false,
+            jobType: state?.jobType ?? null,
+            jobRetry: state?.jobRetry ?? null,
+            jobTimeout: state?.jobTimeout ?? null,
+            permission: state?.permission ?? null,
+            pagination: state?.pagination ?? null,
+            wantsRequest: state?.wantsRequest ?? false,
+            wantsResponse: state?.wantsResponse ?? false,
+            wantsRawBody: state?.wantsRawBody ?? false,
+        };
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    use(name) {
+        const sentinel = name ?? DEFAULT_DB;
+        return new Builder({
+            ...this.state,
+            databases: [...this.state.databases, sentinel],
+        });
+    }
+    auth() {
+        return new Builder({
+            ...this.state,
+            requiresAuth: true,
+            authRequirement: 'required',
+        });
+    }
+    authOptional() {
+        return new Builder({
+            ...this.state,
+            requiresAuth: false,
+            authRequirement: 'optional',
+        });
+    }
+    public() {
+        return new Builder({
+            ...this.state,
+            requiresAuth: false,
+            authRequirement: 'none',
+        });
+    }
+    input(schema) {
+        return new Builder({
+            ...this.state,
+            inputSchema: schema,
+        });
+    }
+    query(schema) {
+        return new Builder({
+            ...this.state,
+            querySchema: schema,
+        });
+    }
+    params(schema) {
+        return new Builder({
+            ...this.state,
+            paramsSchema: schema,
+        });
+    }
+    output(statusOrSchema, maybeSchema) {
+        const schemas = new Map(this.state.outputSchemas);
+        if (typeof statusOrSchema === 'number') {
+            schemas.set(statusOrSchema, maybeSchema);
+        }
+        else {
+            schemas.set(200, statusOrSchema);
+        }
+        return new Builder({
+            ...this.state,
+            outputSchemas: schemas,
+        });
+    }
+    route(method, path) {
+        return new Builder({
+            ...this.state,
+            route: { method, path },
+        });
+    }
+    job(type) {
+        return new Builder({
+            ...this.state,
+            isJob: true,
+            jobType: type ?? null,
+        });
+    }
+    retry(config) {
+        return new Builder({
+            ...this.state,
+            jobRetry: config,
+        });
+    }
+    timeout(ms) {
+        return new Builder({
+            ...this.state,
+            jobTimeout: ms,
+        });
+    }
+    permission(resource, action, scope) {
+        const perm = scope !== undefined
+            ? { resource, action, scope }
+            : { resource, action };
+        return new Builder({
+            ...this.state,
+            permission: perm,
+        });
+    }
+    paginate(config = {}) {
+        return new Builder({
+            ...this.state,
+            pagination: {
+                defaultLimit: config.defaultLimit ?? 20,
+                maxLimit: config.maxLimit ?? 100,
+            },
+        });
+    }
+    request() {
+        return new Builder({
+            ...this.state,
+            wantsRequest: true,
+        });
+    }
+    response() {
+        return new Builder({
+            ...this.state,
+            wantsResponse: true,
+        });
+    }
+    rawBody() {
+        return new Builder({
+            ...this.state,
+            wantsRawBody: true,
+        });
+    }
+    fixture(name, operations) {
+        const dbName = this.state.databases[0];
+        if (dbName === undefined) {
+            throw new Error(`[pipework] .fixture("${name}") requires a database. Call .use("dbName") before .fixture().`);
+        }
+        return buildResource(name, operations, {
+            database: dbName,
+            authRequirement: this.state.authRequirement,
+            permission: this.state.permission,
+            pagination: this.state.pagination,
+        });
+    }
+    fit(fn) {
+        const meta = {
+            databases: this.state.databases,
+            requiresAuth: this.state.requiresAuth,
+            authRequirement: this.state.authRequirement,
+            inputSchema: this.state.inputSchema,
+            outputSchemas: this.state.outputSchemas,
+            querySchema: this.state.querySchema,
+            paramsSchema: this.state.paramsSchema,
+            route: this.state.route,
+            isJob: this.state.isJob,
+            jobType: this.state.jobType,
+            jobRetry: this.state.jobRetry,
+            jobTimeout: this.state.jobTimeout,
+            permission: this.state.permission,
+            wantsRequest: this.state.wantsRequest,
+            wantsResponse: this.state.wantsResponse,
+            wantsRawBody: this.state.wantsRawBody,
+        };
+        return {
+            async execute(deps) {
+                return fn(deps);
+            },
+            meta,
+        };
+    }
+}
+export function createBuilder() {
+    return new Builder();
+}
+//# sourceMappingURL=builder.js.map

package/dist/request/di/builder.js.map

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

package/dist/request/di/index.d.ts

@@ -0,0 +1,6 @@
+export declare const fitting: import("./builder.js").Builder<Record<string, never>>;
+export { createBuilder, Builder } from './builder.js';
+export { resolveAndExecute, type ResolveOptions } from './resolve.js';
+export { DEFAULT_DB } from './types.js';
+export type { Handler, HandlerMeta, RouteMeta, HttpMethod, InferDeps, InferReturn, DatabaseDeps } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/request/di/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/request/di/index.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,OAAO,uDAAkB,CAAA;AAEtC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACrD,OAAO,EAAE,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACvC,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA"}

package/dist/request/di/index.js

@@ -0,0 +1,6 @@
+import { createBuilder } from './builder.js';
+export const fitting = createBuilder();
+export { createBuilder, Builder } from './builder.js';
+export { resolveAndExecute } from './resolve.js';
+export { DEFAULT_DB } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/request/di/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/request/di/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAE5C,MAAM,CAAC,MAAM,OAAO,GAAG,aAAa,EAAE,CAAA;AAEtC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACrD,OAAO,EAAE,iBAAiB,EAAuB,MAAM,cAAc,CAAA;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA"}

package/dist/request/di/resolve.d.ts

@@ -0,0 +1,9 @@
+import type { Handler } from './types.js';
+import type { HttpRequest, HttpResponse } from '../http/types.js';
+export interface ResolveOptions {
+    readonly request?: HttpRequest;
+    readonly response?: HttpResponse;
+    readonly rawBody?: Buffer;
+}
+export declare function resolveAndExecute<TDeps extends Record<string, unknown>, TReturn>(handler: Handler<TDeps, TReturn>, rawInput?: unknown, rawQuery?: unknown, rawParams?: unknown, options?: ResolveOptions): Promise<TReturn>;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/request/di/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/request/di/resolve.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAOjE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAA;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAA;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,wBAAsB,iBAAiB,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EACpF,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,EAChC,QAAQ,CAAC,EAAE,OAAO,EAClB,QAAQ,CAAC,EAAE,OAAO,EAClB,SAAS,CAAC,EAAE,OAAO,EACnB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,OAAO,CAAC,CA+FlB"}

package/dist/request/di/resolve.js

@@ -0,0 +1,90 @@
+import { DEFAULT_DB } from './types.js';
+import { requireContext } from '../context/store.js';
+import { verifyTransactionBinding } from '../context/guard.js';
+import { UnauthorizedError, ValidationError } from '../../core/errors/index.js';
+import { parse } from '../../data/schema/parse.js';
+import { createScopedDb, createTenantGuardDb } from '../../auth/tenant/scoped-db.js';
+export async function resolveAndExecute(handler, rawInput, rawQuery, rawParams, options) {
+    const ctx = requireContext();
+    const deps = {};
+    for (const dbName of handler.meta.databases) {
+        const isDefault = dbName === DEFAULT_DB;
+        const resolvedName = isDefault ? ctx.instance.config.defaultDatabaseName() : dbName;
+        const depKey = isDefault ? 'db' : dbName;
+        const dbConfig = ctx.instance.config.database(resolvedName);
+        const bound = ctx.transactions.get(resolvedName);
+        let rawDb;
+        if (bound) {
+            verifyTransactionBinding(ctx, bound, resolvedName);
+            rawDb = bound.drizzle;
+        }
+        else {
+            const conn = ctx.instance.pool.getOrCreate(dbConfig);
+            rawDb = conn.drizzle;
+        }
+        deps[depKey] = ctx.tenant !== null ? createScopedDb(rawDb, ctx.tenant) : createTenantGuardDb(rawDb);
+    }
+    if (handler.meta.requiresAuth) {
+        if (ctx.auth === null) {
+            throw new UnauthorizedError();
+        }
+        deps['auth'] = ctx.auth;
+    }
+    else if (handler.meta.authRequirement === 'optional') {
+        deps['auth'] = ctx.auth;
+    }
+    if (handler.meta.inputSchema) {
+        deps['input'] = parse(handler.meta.inputSchema, rawInput);
+    }
+    if (handler.meta.querySchema) {
+        deps['query'] = parse(handler.meta.querySchema, rawQuery);
+    }
+    if (handler.meta.paramsSchema) {
+        deps['params'] = parse(handler.meta.paramsSchema, rawParams);
+    }
+    if (handler.meta.wantsRequest) {
+        if (options?.request === undefined) {
+            throw new ValidationError('Handler declared .request() but no HTTP request is available.\n\n' +
+                '  This handler requires an HTTP context. It cannot be invoked as a background job\n' +
+                '  or via direct resolveAndExecute() without providing a request object.\n');
+        }
+        deps['request'] = options.request;
+    }
+    if (handler.meta.wantsResponse) {
+        if (options?.response === undefined) {
+            throw new ValidationError('Handler declared .response() but no HTTP response is available.\n\n' +
+                '  This handler requires an HTTP context. It cannot be invoked as a background job\n' +
+                '  or via direct resolveAndExecute() without providing a response object.\n');
+        }
+        deps['response'] = options.response;
+    }
+    if (handler.meta.wantsRawBody) {
+        if (options?.rawBody === undefined) {
+            throw new ValidationError('Handler declared .rawBody() but no raw body is available.\n\n' +
+                '  Raw body capture requires an HTTP context with body content.\n' +
+                '  This handler cannot be invoked as a background job or via GET requests\n' +
+                '  without providing a raw body buffer.\n');
+        }
+        deps['rawBody'] = options.rawBody;
+    }
+    const result = await handler.execute(deps);
+    if (handler.meta.outputSchemas.size > 0) {
+        if (isHandlerResponse(result)) {
+            const response = result;
+            const bodySchema = handler.meta.outputSchemas.get(response.status);
+            if (bodySchema) {
+                return { status: response.status, body: parse(bodySchema, response.body) };
+            }
+            return result;
+        }
+        const defaultSchema = handler.meta.outputSchemas.get(200);
+        if (defaultSchema) {
+            return parse(defaultSchema, result);
+        }
+    }
+    return result;
+}
+function isHandlerResponse(value) {
+    return value !== null && typeof value === 'object' && 'status' in value && typeof value['status'] === 'number';
+}
+//# sourceMappingURL=resolve.js.map

package/dist/request/di/resolve.js.map

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

package/dist/request/di/types.d.ts

@@ -0,0 +1,56 @@
+import type { Schema } from '../../data/schema/types.js';
+import type { DB } from '../../data/db/index.js';
+import type { BackoffConfig } from '../../async/jobs/queue.js';
+/** The default database name constant ('default') used when pipe() is called without a name argument. */
+export declare const DEFAULT_DB: "__pipework_default__";
+/** Auth requirement level for a handler — 'required', 'optional', or 'public'. */
+export type AuthRequirement = 'required' | 'optional' | 'none';
+/** Permission requirement attached to a handler — resource, action, scope. */
+export interface PermissionMeta {
+    readonly resource: string;
+    readonly action: string;
+    readonly scope?: string;
+}
+/** Retry configuration for job handlers — maxAttempts, backoff strategy, delay. */
+export interface JobRetryConfig {
+    readonly attempts: number;
+    readonly backoff?: BackoffConfig;
+}
+/** Metadata attached to a handler — route info, auth requirements, input/output schemas, database names. */
+export interface HandlerMeta {
+    readonly databases: readonly string[];
+    readonly requiresAuth: boolean;
+    readonly authRequirement: AuthRequirement;
+    readonly inputSchema: Schema | null;
+    readonly outputSchemas: ReadonlyMap<number, Schema>;
+    readonly querySchema: Schema | null;
+    readonly paramsSchema: Schema | null;
+    readonly route: RouteMeta | null;
+    readonly isJob: boolean;
+    readonly jobType: string | null;
+    readonly jobRetry: JobRetryConfig | null;
+    readonly jobTimeout: number | null;
+    readonly permission: PermissionMeta | null;
+    readonly wantsRequest: boolean;
+    readonly wantsResponse: boolean;
+    readonly wantsRawBody: boolean;
+}
+/** HTTP route metadata — method, path, and registered middleware. */
+export interface RouteMeta {
+    readonly method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    readonly path: string;
+}
+/** HTTP method literal type — 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'. */
+export type HttpMethod = RouteMeta['method'];
+/** A resolved handler produced by fitting().fit() — carries metadata, dependencies, and the handler function. */
+export interface Handler<TDeps extends Record<string, unknown>, TReturn> {
+    execute(deps: TDeps): Promise<TReturn>;
+    readonly meta: HandlerMeta;
+}
+/** Extracts the dependency type from a Handler — InferDeps<typeof myHandler> gives you the deps object shape. */
+export type InferDeps<H> = H extends Handler<infer D, unknown> ? D : never;
+/** Extracts the return type from a Handler — InferReturn<typeof myHandler> gives you the resolved return type. */
+export type InferReturn<H> = H extends Handler<Record<string, unknown>, infer R> ? R : never;
+/** Map of database names to their resolved DB instances for a handler. */
+export type DatabaseDeps<N extends string> = Record<N, DB>;
+//# sourceMappingURL=types.d.ts.map

package/dist/request/di/types.d.ts.map

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

package/dist/request/di/types.js

@@ -0,0 +1,3 @@
+/** The default database name constant ('default') used when pipe() is called without a name argument. */
+export const DEFAULT_DB = '__pipework_default__';
+//# sourceMappingURL=types.js.map

package/dist/request/di/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/request/di/types.ts"],"names":[],"mappings":"AAIA,yGAAyG;AACzG,MAAM,CAAC,MAAM,UAAU,GAAG,sBAA+B,CAAA"}

package/dist/request/fitting/namespace.d.ts

@@ -0,0 +1,3 @@
+/** DI handler builder — chain .use(), .auth(), .input(), .route(), .fit() to build type-safe handlers with automatic dependency injection. */
+export declare const fitting: () => import("../di/builder.js").Builder<Record<string, never>>;
+//# sourceMappingURL=namespace.d.ts.map