@fougere/core 0.1.0-alpha.0

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+export { createApp } from './bootstrap.js';
+export { boot } from './boot.js';
+export { orderSeeds, runSeeds } from './seed.js';
+export { defineFougere } from './define.js';
+export { loadConfig, loadCascadedConfig, loadFrondConfigs, mergeGlobal, mergeConfig, configForFrond, resolveConfig, type FougereConfig, type ResolvedConfig } from './config-loader.js';
+export { defineFrond, loadFrondConfig, type FrondConfig, type OperationOverride } from './frond-config.js';
+export { buildGraph, clusterEntities, suggestSplit, type EntityNode, type DomainCluster } from './graph.js';
+export { Crud } from './crud.js';
+export type { CrudOps, CrudOpName, CrudViews, CrudConstructor } from './crud.js';
+export { Presenter, getPresenterTarget, getPresenterFields, getPresenterViews } from './presenter.js';
+export type { PresenterViews } from './presenter.js';
+export { Collector, getCollectorTarget } from './collector.js';
+export { computeBindingPlan, resolveArgs } from './binding.js';
+export type { BindingPlan, ParamBinding, ParamSource, CollectorResolver } from './binding.js';
+export type { InvocationContext } from './invocation.js';
+export { EMPTY_INVOCATION } from './invocation.js';
+export { isReadOp, resolveIsReadOp } from './operation.js';
+export type { OperationContract, OperationsMap } from './operation.js';
+export { scanProject, frondAliases, FROND_DIRS, toRegistrationName, setModuleLoader, type ModuleLoader } from './scanner.js';
+export { runMiddlewares, FougereError, ErrorCode } from './middleware.js';
+export { createLocalRunner, createAppRunner, identityCardOf, RPC_ENTITY } from './call.js';
+export { facadeKeyOf, contractsKeyOf } from './call.js';
+export { type Emit, type Fact, emitKeyOf, factOfEmitKey, factsAnnouncedBy } from './emit.js';
+export { resolveContracts } from './operation.js';
+export type { FrondCall, Transport, IdentityCard, CardOp, Facade } from './call.js';
+export { callValueOf } from './contract.js';
+export type { CallValue } from './contract.js';
+export type { OperationContext, AppNext, AppMiddleware, FougereErrorOptions } from './middleware.js';
+export { toHttpError, toPublicError, httpStatusFor } from './errors.js';
+export { loggerMiddleware } from './middleware/logger.js';
+export { errorMiddleware } from './middleware/error-handler.js';
+export { Logger } from './builtins/logger.js';
+export { Config } from './builtins/config.js';
+export type { EntityOrm, OrmFactory, ListOptions, ListResult } from './orm.js';
+export { LIST_OPTION_KEYS, assertListOptions } from './orm.js';
+export type { App, CreateAppOptions, ScanResult, ScanDiagnostic, FrondDescriptor, FrondSource, ProviderEntry, EntityEntry, HandlerEntry, SeedEntry, SeedFactory, PresenterEntry, PresenterFieldMeta, CollectorEntry, AuthConfig, AuthContext, AuthRuntime, } from './types.js';
+export { ormKeyOf } from './orm.js';
+export { presenterKeyOf } from './presenter.js';
+export { collectorKeyOf } from './collector.js';
+export { Repository, getRepositoryTarget, repositoryKeyOf, type RepositoryOf, type RepositoryConstructor } from './repository.js';
+export { verify, assertSplittable, type Violation } from './verify.js';
+export { crossFrondImports, type CrossFrondImport } from './imports.js';
+//# 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,37 @@
+export { createApp } from './bootstrap.js';
+export { boot } from './boot.js';
+export { orderSeeds, runSeeds } from './seed.js';
+export { defineFougere } from './define.js';
+export { loadConfig, loadCascadedConfig, loadFrondConfigs, mergeGlobal, mergeConfig, configForFrond, resolveConfig } from './config-loader.js';
+export { defineFrond, loadFrondConfig } from './frond-config.js';
+export { buildGraph, clusterEntities, suggestSplit } from './graph.js';
+export { Crud } from './crud.js';
+export { Presenter, getPresenterTarget, getPresenterFields, getPresenterViews } from './presenter.js';
+export { Collector, getCollectorTarget } from './collector.js';
+export { computeBindingPlan, resolveArgs } from './binding.js';
+export { EMPTY_INVOCATION } from './invocation.js';
+export { isReadOp, resolveIsReadOp } from './operation.js';
+export { scanProject, frondAliases, FROND_DIRS, toRegistrationName, setModuleLoader } from './scanner.js';
+export { runMiddlewares, FougereError, ErrorCode } from './middleware.js';
+export { createLocalRunner, createAppRunner, identityCardOf, RPC_ENTITY } from './call.js';
+// The container keys, exported so any reader asks the same question the bootstrap
+// answers. A second reader that respells one looks in the wrong place and reports
+// nothing found — which is indistinguishable from nothing wrong.
+export { facadeKeyOf, contractsKeyOf } from './call.js';
+export { emitKeyOf, factOfEmitKey, factsAnnouncedBy } from './emit.js';
+export { resolveContracts } from './operation.js';
+export { callValueOf } from './contract.js';
+export { toHttpError, toPublicError, httpStatusFor } from './errors.js';
+export { loggerMiddleware } from './middleware/logger.js';
+export { errorMiddleware } from './middleware/error-handler.js';
+export { Logger } from './builtins/logger.js';
+export { Config } from './builtins/config.js';
+export { LIST_OPTION_KEYS, assertListOptions } from './orm.js';
+export { ormKeyOf } from './orm.js';
+export { presenterKeyOf } from './presenter.js';
+export { collectorKeyOf } from './collector.js';
+export { Repository, getRepositoryTarget, repositoryKeyOf } from './repository.js';
+export { verify, assertSplittable } from './verify.js';
+// Same question as verify(), answered from the source text instead of the model.
+export { crossFrondImports } from './imports.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAA2C,MAAM,oBAAoB,CAAC;AACxL,OAAO,EAAE,WAAW,EAAE,eAAe,EAA4C,MAAM,mBAAmB,CAAC;AAC3G,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAuC,MAAM,YAAY,CAAC;AAC5G,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEtG,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,eAAe,EAAqB,MAAM,cAAc,CAAC;AAC7H,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC3F,kFAAkF;AAClF,kFAAkF;AAClF,iEAAiE;AACjE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EAAwB,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7F,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAoB/D,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,eAAe,EAAiD,MAAM,iBAAiB,CAAC;AAClI,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAkB,MAAM,aAAa,CAAC;AACvE,iFAAiF;AACjF,OAAO,EAAE,iBAAiB,EAAyB,MAAM,cAAc,CAAC"}

package/dist/invocation.d.ts

@@ -0,0 +1,20 @@
+/**
+ * InvocationContext — unified cross-transport context.
+ *
+ * Every bridge (REST, GraphQL, Nuxt, CLI, event bus) produces an
+ * InvocationContext before calling a handler facade. The binding
+ * algorithm uses it to resolve handler parameters by type.
+ */
+export interface InvocationContext {
+    /** Named path/route params (URL segments, CLI positional args). */
+    params: Record<string, string>;
+    /** Query-string params (CLI flags, search params). */
+    query: Record<string, string>;
+    /** Payload (HTTP body, event payload, CLI stdin). */
+    body: unknown;
+    /** State deposited by middlewares (auth, session, tenant). */
+    state: Record<string, unknown>;
+}
+/** Empty context for programmatic / test calls. */
+export declare const EMPTY_INVOCATION: InvocationContext;
+//# sourceMappingURL=invocation.d.ts.map

package/dist/invocation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocation.d.ts","sourceRoot":"","sources":["../src/invocation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,qDAAqD;IACrD,IAAI,EAAE,OAAO,CAAC;IACd,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,mDAAmD;AACnD,eAAO,MAAM,gBAAgB,EAAE,iBAK9B,CAAC"}

package/dist/invocation.js

@@ -0,0 +1,15 @@
+/**
+ * InvocationContext — unified cross-transport context.
+ *
+ * Every bridge (REST, GraphQL, Nuxt, CLI, event bus) produces an
+ * InvocationContext before calling a handler facade. The binding
+ * algorithm uses it to resolve handler parameters by type.
+ */
+/** Empty context for programmatic / test calls. */
+export const EMPTY_INVOCATION = {
+    params: {},
+    query: {},
+    body: undefined,
+    state: {},
+};
+//# sourceMappingURL=invocation.js.map

package/dist/invocation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocation.js","sourceRoot":"","sources":["../src/invocation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,mDAAmD;AACnD,MAAM,CAAC,MAAM,gBAAgB,GAAsB;IACjD,MAAM,EAAE,EAAE;IACV,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,EAAE;CACV,CAAC"}

package/dist/middleware/error-handler.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Error handler middleware — normalizes errors into FougereError.
+ */
+import type { AppMiddleware } from '../middleware.js';
+/**
+ * Create an error handler middleware that wraps thrown errors into FougereError.
+ *
+ * Errors that are already FougereError pass through unchanged.
+ *
+ * ```ts
+ * app.use(errorMiddleware())
+ * ```
+ */
+export declare function errorMiddleware(): AppMiddleware;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/middleware/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/middleware/error-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,IAAI,aAAa,CAe/C"}

package/dist/middleware/error-handler.js

@@ -0,0 +1,29 @@
+import { FougereError, ErrorCode } from '../middleware.js';
+/**
+ * Create an error handler middleware that wraps thrown errors into FougereError.
+ *
+ * Errors that are already FougereError pass through unchanged.
+ *
+ * ```ts
+ * app.use(errorMiddleware())
+ * ```
+ */
+export function errorMiddleware() {
+    return async (ctx, next) => {
+        try {
+            return await next();
+        }
+        catch (err) {
+            if (err instanceof FougereError)
+                throw err;
+            throw new FougereError({
+                code: ErrorCode.INTERNAL_ERROR,
+                message: err.message ?? 'Internal error',
+                entity: ctx.entity,
+                operation: ctx.operation,
+                cause: err,
+            });
+        }
+    };
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/middleware/error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../src/middleware/error-handler.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE3D;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QACzB,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,EAAE,CAAC;QACtB,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,IAAI,GAAG,YAAY,YAAY;gBAAE,MAAM,GAAG,CAAC;YAC3C,MAAM,IAAI,YAAY,CAAC;gBACrB,IAAI,EAAE,SAAS,CAAC,cAAc;gBAC9B,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,gBAAgB;gBACxC,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,KAAK,EAAE,GAAG;aACX,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/middleware/logger.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Logger middleware — logs every operation with timing.
+ */
+import type { AppMiddleware } from '../middleware.js';
+import type { Logger } from '../builtins/logger.js';
+/**
+ * Create a logger middleware that logs operation entry, exit, and errors.
+ *
+ * ```ts
+ * app.use(loggerMiddleware(app.resolve('logger')))
+ * ```
+ */
+export declare function loggerMiddleware(logger: Logger): AppMiddleware;
+//# sourceMappingURL=logger.d.ts.map

package/dist/middleware/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/middleware/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAe9D"}

package/dist/middleware/logger.js

@@ -0,0 +1,25 @@
+/**
+ * Create a logger middleware that logs operation entry, exit, and errors.
+ *
+ * ```ts
+ * app.use(loggerMiddleware(app.resolve('logger')))
+ * ```
+ */
+export function loggerMiddleware(logger) {
+    return async (ctx, next) => {
+        const start = performance.now();
+        logger.info(`${ctx.entity}.${ctx.operation}`);
+        try {
+            const result = await next();
+            const ms = (performance.now() - start).toFixed(1);
+            logger.info(`${ctx.entity}.${ctx.operation} (${ms}ms)`);
+            return result;
+        }
+        catch (err) {
+            const ms = (performance.now() - start).toFixed(1);
+            logger.error(`${ctx.entity}.${ctx.operation} (${ms}ms)`, err);
+            throw err;
+        }
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/middleware/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/middleware/logger.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,OAAO,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QACzB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;YAC5B,MAAM,EAAE,GAAG,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAClD,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,SAAS,KAAK,EAAE,KAAK,CAAC,CAAC;YACxD,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,EAAE,GAAG,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAClD,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,SAAS,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;YAC9D,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/middleware.d.ts

@@ -0,0 +1,75 @@
+/**
+ * App-level middleware — intercepts handler facade operations.
+ *
+ * Works regardless of entry point (HTTP, Nitro, event bus, CLI, tests).
+ */
+export interface OperationContext {
+    /** Entity name (e.g. 'product'). */
+    entity: string;
+    /** Operation name (e.g. 'create', 'findById', 'searchByTitle'). */
+    operation: string;
+    /** Arguments passed to the operation. */
+    args: unknown[];
+    /** Extensible bag — middlewares deposit data here (user, permissions, etc.). */
+    state: Record<string, unknown>;
+    /** Transport-agnostic invocation context (params, query, body, state). */
+    invocation?: import('./invocation.js').InvocationContext;
+}
+export type AppNext = () => Promise<unknown>;
+export type AppMiddleware = (ctx: OperationContext, next: AppNext) => Promise<unknown>;
+/** Semantic error codes — transport-agnostic. Each bridge maps them to its own format. */
+export declare enum ErrorCode {
+    VALIDATION_FAILED = "VALIDATION_FAILED",
+    BAD_REQUEST = "BAD_REQUEST",
+    UNAUTHORIZED = "UNAUTHORIZED",
+    FORBIDDEN = "FORBIDDEN",
+    NOT_FOUND = "NOT_FOUND",
+    GONE = "GONE",
+    CONFLICT = "CONFLICT",
+    LOCKED = "LOCKED",
+    METHOD_NOT_ALLOWED = "METHOD_NOT_ALLOWED",
+    PRECONDITION_FAILED = "PRECONDITION_FAILED",
+    PAYLOAD_TOO_LARGE = "PAYLOAD_TOO_LARGE",
+    UNPROCESSABLE_ENTITY = "UNPROCESSABLE_ENTITY",
+    TOO_MANY_REQUESTS = "TOO_MANY_REQUESTS",
+    REQUEST_TIMEOUT = "REQUEST_TIMEOUT",
+    INTERNAL_ERROR = "INTERNAL_ERROR",
+    NOT_IMPLEMENTED = "NOT_IMPLEMENTED",
+    BAD_GATEWAY = "BAD_GATEWAY",
+    SERVICE_UNAVAILABLE = "SERVICE_UNAVAILABLE",
+    GATEWAY_TIMEOUT = "GATEWAY_TIMEOUT"
+}
+export interface FougereErrorOptions {
+    code: ErrorCode;
+    message: string;
+    entity?: string;
+    operation?: string;
+    details?: unknown;
+    cause?: unknown;
+}
+export declare class FougereError extends Error {
+    readonly code: ErrorCode;
+    readonly entity?: string;
+    readonly operation?: string;
+    readonly details?: unknown;
+    constructor(options: FougereErrorOptions);
+    toJSON(): {
+        details?: {} | null | undefined;
+        operation?: string | undefined;
+        entity?: string | undefined;
+        code: ErrorCode;
+        message: string;
+    };
+    /**
+     * Dual of toJSON — rebuild a typed error from its wire form.
+     *
+     * Wire input is untrusted: an unknown code degrades to INTERNAL_ERROR
+     * (original code kept in details) instead of forging a fake semantic code.
+     */
+    static fromJSON(json: unknown): FougereError;
+}
+/**
+ * Execute a middleware chain (onion model) then the handler.
+ */
+export declare function runMiddlewares(middlewares: AppMiddleware[], ctx: OperationContext, handler: AppNext): Promise<unknown>;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,0EAA0E;IAC1E,UAAU,CAAC,EAAE,OAAO,iBAAiB,EAAE,iBAAiB,CAAC;CAC1D;AAED,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;AAC7C,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAIvF,0FAA0F;AAC1F,oBAAY,SAAS;IAEnB,iBAAiB,sBAAsB;IACvC,WAAW,gBAAgB;IAG3B,YAAY,iBAAiB;IAC7B,SAAS,cAAc;IAGvB,SAAS,cAAc;IACvB,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,kBAAkB,uBAAuB;IAGzC,mBAAmB,wBAAwB;IAC3C,iBAAiB,sBAAsB;IACvC,oBAAoB,yBAAyB;IAC7C,iBAAiB,sBAAsB;IACvC,eAAe,oBAAoB;IAGnC,cAAc,mBAAmB;IACjC,eAAe,oBAAoB;IACnC,WAAW,gBAAgB;IAC3B,mBAAmB,wBAAwB;IAC3C,eAAe,oBAAoB;CACpC;AAID,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEf,OAAO,EAAE,mBAAmB;IASxC,MAAM;;;;;;;IAUN;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,YAAY;CAW7C;AAID;;GAEG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,aAAa,EAAE,EAC5B,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,OAAO,CAAC,CASlB"}

package/dist/middleware.js

@@ -0,0 +1,89 @@
+/**
+ * App-level middleware — intercepts handler facade operations.
+ *
+ * Works regardless of entry point (HTTP, Nitro, event bus, CLI, tests).
+ */
+// ── ErrorCode ──────────────────────────────────
+/** Semantic error codes — transport-agnostic. Each bridge maps them to its own format. */
+export var ErrorCode;
+(function (ErrorCode) {
+    // Input
+    ErrorCode["VALIDATION_FAILED"] = "VALIDATION_FAILED";
+    ErrorCode["BAD_REQUEST"] = "BAD_REQUEST";
+    // Auth
+    ErrorCode["UNAUTHORIZED"] = "UNAUTHORIZED";
+    ErrorCode["FORBIDDEN"] = "FORBIDDEN";
+    // Resources
+    ErrorCode["NOT_FOUND"] = "NOT_FOUND";
+    ErrorCode["GONE"] = "GONE";
+    ErrorCode["CONFLICT"] = "CONFLICT";
+    ErrorCode["LOCKED"] = "LOCKED";
+    ErrorCode["METHOD_NOT_ALLOWED"] = "METHOD_NOT_ALLOWED";
+    // Limits
+    ErrorCode["PRECONDITION_FAILED"] = "PRECONDITION_FAILED";
+    ErrorCode["PAYLOAD_TOO_LARGE"] = "PAYLOAD_TOO_LARGE";
+    ErrorCode["UNPROCESSABLE_ENTITY"] = "UNPROCESSABLE_ENTITY";
+    ErrorCode["TOO_MANY_REQUESTS"] = "TOO_MANY_REQUESTS";
+    ErrorCode["REQUEST_TIMEOUT"] = "REQUEST_TIMEOUT";
+    // Server
+    ErrorCode["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+    ErrorCode["NOT_IMPLEMENTED"] = "NOT_IMPLEMENTED";
+    ErrorCode["BAD_GATEWAY"] = "BAD_GATEWAY";
+    ErrorCode["SERVICE_UNAVAILABLE"] = "SERVICE_UNAVAILABLE";
+    ErrorCode["GATEWAY_TIMEOUT"] = "GATEWAY_TIMEOUT";
+})(ErrorCode || (ErrorCode = {}));
+export class FougereError extends Error {
+    code;
+    entity;
+    operation;
+    details;
+    constructor(options) {
+        super(options.message, { cause: options.cause });
+        this.name = 'FougereError';
+        this.code = options.code;
+        this.entity = options.entity;
+        this.operation = options.operation;
+        this.details = options.details;
+    }
+    toJSON() {
+        return {
+            code: this.code,
+            message: this.message,
+            ...(this.entity && { entity: this.entity }),
+            ...(this.operation && { operation: this.operation }),
+            ...(this.details !== undefined && { details: this.details }),
+        };
+    }
+    /**
+     * Dual of toJSON — rebuild a typed error from its wire form.
+     *
+     * Wire input is untrusted: an unknown code degrades to INTERNAL_ERROR
+     * (original code kept in details) instead of forging a fake semantic code.
+     */
+    static fromJSON(json) {
+        const raw = (typeof json === 'object' && json !== null ? json : {});
+        const known = Object.values(ErrorCode).includes(raw.code);
+        return new FougereError({
+            code: known ? raw.code : ErrorCode.INTERNAL_ERROR,
+            message: typeof raw.message === 'string' ? raw.message : 'Unknown error',
+            entity: typeof raw.entity === 'string' ? raw.entity : undefined,
+            operation: typeof raw.operation === 'string' ? raw.operation : undefined,
+            details: known ? raw.details : { originalCode: raw.code, details: raw.details },
+        });
+    }
+}
+// ── Runner ──────────────────────────────────────
+/**
+ * Execute a middleware chain (onion model) then the handler.
+ */
+export function runMiddlewares(middlewares, ctx, handler) {
+    let index = 0;
+    const next = () => {
+        if (index < middlewares.length) {
+            return middlewares[index++](ctx, next);
+        }
+        return handler();
+    };
+    return next();
+}
+//# sourceMappingURL=middleware.js.map

package/dist/middleware.js.map

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

package/dist/operation.d.ts

@@ -0,0 +1,87 @@
+import type { SchemaLike } from '@fougere/schema';
+import type { BindingPlan } from './binding.js';
+import type { HandlerEntry, FrondDescriptor } from './types.js';
+import type { ParsedMethod, ParsedType, ParsedParam } from './handler-parser.js';
+/**
+ * The contract of one operation — everything the façade needs to serve a call.
+ *
+ * Produced two ways, indistinguishable once here: the scan DERIVES it from a
+ * method's parsed signature, a prefab handler DECLARES it outright. The façade
+ * consumes contracts and nothing else — it knows no operation by name, and a
+ * declared contract survives a scan that resolved nothing.
+ */
+export interface OperationContract {
+    /** Judged on the way in. The view carries its own mode (`partial()` → patch). */
+    input?: SchemaLike;
+    /** Projected on the way out. */
+    output?: SchemaLike;
+    /** Where each argument is read from in the invocation. */
+    binding?: BindingPlan;
+    /**
+     * The operation in words, for a caller that meets it over the wire and has to
+     * choose. Same three producers as the rest: the scan derives it from the method's
+     * doc comment, a prefab declares it, config states it and wins.
+     */
+    description?: string;
+    /**
+     * How MUCH comes back — the half of the return type that `output` cannot say.
+     *
+     * `output` is the shape of ONE row; it is silent on whether the op hands back one,
+     * several, or a page. The prefab knows (`list` returns a `ListResult`, `findById`
+     * returns `T | undefined`) and the card did not, so anything generating a signature
+     * from the card would have written `list(): Promise<Post[]>` — false, and a false
+     * signature is worse than none.
+     *
+     * `none` says there is no shaped output at all (a boolean, a void), not that the op
+     * returns nothing.
+     */
+    cardinality?: 'one' | 'maybe' | 'many' | 'page' | 'none';
+    /** The scan's raw material, when it produced this contract. `binding` wins. */
+    signature?: ParsedMethod;
+}
+/**
+ * Read an op's cardinality off its parsed return type.
+ *
+ * `Promise` is unwrapped first — it says when, not how much. `ListResult<T>` extends
+ * `Array<T>`, so it must be recognised BEFORE the array test or a page would read as
+ * a plain list and lose its `total`/`hasMore`.
+ */
+export declare function cardinalityOf(type: ParsedType | undefined): OperationContract['cardinality'];
+/** Map of operation name → its contract. */
+export type OperationsMap = Map<string, OperationContract>;
+export type { ParsedType, ParsedParam };
+/** Convention-based: returns true if the operation name implies a read (query/GET). */
+export declare function isReadOp(name: string): boolean;
+/**
+ * Resolve operation kind honoring per-op overrides (from frond.config.ts).
+ * Precedence: explicit override wins over convention.
+ */
+export declare function resolveIsReadOp(name: string, overrides?: Record<string, {
+    kind?: 'query' | 'command';
+}>): boolean;
+/**
+ * The contract of every operation a handler serves — the three producers, merged once.
+ *
+ * This lived inline in `buildFacade`, which made the façade the only thing that could
+ * answer "what is this op's contract, really?". Anything else asking — a checker, a
+ * client generator, a descriptor — had to redo the merge, and a second opinion that
+ * drifts reports nothing wrong while looking at the wrong thing.
+ *
+ * The order is a claim about authority, not a convenience:
+ *
+ *   1. a prefab DECLARES what it built (`Crud(E).__ops`) — runtime, so it survives a
+ *      scan that resolved nothing;
+ *   2. the scan DERIVES from source — a method written in this very file is the
+ *      author's own word and beats everything; a method it merely READ on a base
+ *      class is a guess about someone else's code, and yields to that code's own
+ *      declaration;
+ *   3. `frond.config.ts` STATES — the most explicit statement, made by whoever
+ *      assembles the app, and the only answer for an op inherited from an installed
+ *      base class the workspace-only scan cannot see. Merged per key, so stating a
+ *      `binding` alone does not erase an `input` the scan found.
+ *
+ * Pure: no container, no instance, no disk. The binding plan is resolved here, so
+ * nothing downstream ever meets an AST.
+ */
+export declare function resolveContracts(handler: Pick<HandlerEntry, 'ctor' | 'operations'>, overrides: FrondDescriptor['operationsOverrides'], collectorEntityNames: Set<string>): OperationsMap;
+//# sourceMappingURL=operation.d.ts.map

package/dist/operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation.d.ts","sourceRoot":"","sources":["../src/operation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEjF;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,iFAAiF;IACjF,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,gCAAgC;IAChC,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACzD,+EAA+E;IAC/E,SAAS,CAAC,EAAE,YAAY,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAQ5F;AAKD,4CAA4C;AAC5C,MAAM,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AAE3D,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;AAUxC,uFAAuF;AACvF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAAE,CAAC,GACzD,OAAO,CAIT;AAGD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY,CAAC,EAClD,SAAS,EAAE,eAAe,CAAC,qBAAqB,CAAC,EACjD,oBAAoB,EAAE,GAAG,CAAC,MAAM,CAAC,GAChC,aAAa,CA0Bf"}

package/dist/operation.js

@@ -0,0 +1,95 @@
+import { computeBindingPlan } from './binding.js';
+/**
+ * Read an op's cardinality off its parsed return type.
+ *
+ * `Promise` is unwrapped first — it says when, not how much. `ListResult<T>` extends
+ * `Array<T>`, so it must be recognised BEFORE the array test or a page would read as
+ * a plain list and lose its `total`/`hasMore`.
+ */
+export function cardinalityOf(type) {
+    if (!type)
+        return undefined;
+    const inner = type.name === 'Promise' ? type.generics?.[0] : type;
+    if (!inner)
+        return 'none';
+    if (inner.name === 'ListResult')
+        return 'page';
+    if (inner.array)
+        return 'many';
+    if (PRIMITIVE_RETURNS.has(inner.name))
+        return 'none';
+    return inner.nullable ? 'maybe' : 'one';
+}
+/** A return that carries no schema — the card has nothing to project onto it. */
+const PRIMITIVE_RETURNS = new Set(['boolean', 'string', 'number', 'void', 'undefined', 'unknown', 'any']);
+// ─── Operation intent (read vs write) ──────────
+// Naming convention for inferred handlers — scheduled to die with the
+// handler-kind plan (docs/notes/handler-kind.md). Lives here, NOT in
+// @fougere/schema: it is a runtime convention about operations, not a
+// schema concept.
+const READ_PREFIXES = ['list', 'find', 'get', 'search', 'count', 'exists', 'stats'];
+/** Convention-based: returns true if the operation name implies a read (query/GET). */
+export function isReadOp(name) {
+    return READ_PREFIXES.some((p) => name.startsWith(p));
+}
+/**
+ * Resolve operation kind honoring per-op overrides (from frond.config.ts).
+ * Precedence: explicit override wins over convention.
+ */
+export function resolveIsReadOp(name, overrides) {
+    const kind = overrides?.[name]?.kind;
+    if (kind)
+        return kind === 'query';
+    return isReadOp(name);
+}
+/**
+ * The contract of every operation a handler serves — the three producers, merged once.
+ *
+ * This lived inline in `buildFacade`, which made the façade the only thing that could
+ * answer "what is this op's contract, really?". Anything else asking — a checker, a
+ * client generator, a descriptor — had to redo the merge, and a second opinion that
+ * drifts reports nothing wrong while looking at the wrong thing.
+ *
+ * The order is a claim about authority, not a convenience:
+ *
+ *   1. a prefab DECLARES what it built (`Crud(E).__ops`) — runtime, so it survives a
+ *      scan that resolved nothing;
+ *   2. the scan DERIVES from source — a method written in this very file is the
+ *      author's own word and beats everything; a method it merely READ on a base
+ *      class is a guess about someone else's code, and yields to that code's own
+ *      declaration;
+ *   3. `frond.config.ts` STATES — the most explicit statement, made by whoever
+ *      assembles the app, and the only answer for an op inherited from an installed
+ *      base class the workspace-only scan cannot see. Merged per key, so stating a
+ *      `binding` alone does not erase an `input` the scan found.
+ *
+ * Pure: no container, no instance, no disk. The binding plan is resolved here, so
+ * nothing downstream ever meets an AST.
+ */
+export function resolveContracts(handler, overrides, collectorEntityNames) {
+    const declared = handler.ctor.__ops ?? {};
+    const contracts = new Map(Object.entries(declared));
+    for (const [opName, scanned] of handler.operations) {
+        if (scanned.signature?.inherited && opName in declared)
+            continue;
+        contracts.set(opName, {
+            ...scanned,
+            binding: scanned.binding
+                ?? (scanned.signature ? computeBindingPlan(scanned.signature.params, collectorEntityNames) : undefined),
+        });
+    }
+    for (const [opName, override] of Object.entries(overrides ?? {})) {
+        const { input, output, binding, description } = override;
+        if (input === undefined && output === undefined && binding === undefined && description === undefined)
+            continue;
+        contracts.set(opName, {
+            ...contracts.get(opName),
+            ...(input !== undefined && { input }),
+            ...(output !== undefined && { output }),
+            ...(binding !== undefined && { binding }),
+            ...(description !== undefined && { description }),
+        });
+    }
+    return contracts;
+}
+//# sourceMappingURL=operation.js.map

package/dist/operation.js.map

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