@fougere/core 0.8.3-alpha.0 → 0.8.4-alpha.0

package/src/dispatch/StorageGuard.ts

@@ -1,6 +1,6 @@
-import { Boundary, FieldSet, FieldValueValidator, InputRefusal, type Fields } from '@fougere/schema';
-import { COMPARISONS, comparisonOf, unknownIn } from '../criterion.js';
-import { assertListOptions } from '../storage.js';
+import { FieldSet, FieldValueValidator, InputRefusal, type Fields } from '@fougere/schema';
+import { COMPARISONS, comparisonOf, unknownIn } from '../storage/criterion.js';
+import { assertListOptions } from '../storage/port.js';
 import { ErrorCode, FougereError } from '../wire/errors.js';
 
 /** The gestures this guard grafts onto. */
@@ -70,7 +70,7 @@ export class StorageGuard {
     if (typeof list === 'function') {
       guarded.list = async function (...args: unknown[]) {
         const options = args[0] as { where?: Record<string, unknown> } | undefined;
-        assertListOptions(options, validation.entity);
+        assertListOptions(options, validation.entity, Object.keys(validation.fields));
         if (options?.where) args[0] = { ...options, where: validation.criteria(options.where) };
 
         return list.apply(this, args);
@@ -169,11 +169,7 @@ export class StorageGuard {
   /** One value against one field — validated, then decoded the way the wire hands it. */
   private value(field: Fields[string], asked: unknown): { value: unknown } | { error: string } {
     if (asked === null || asked === undefined) return { value: asked };
-    const checked = FieldValueValidator.of(field).validate(asked);
-    if ('error' in checked) return checked;
-    if (checked.value === null) return { value: null };
-
-    return Boundary.of(field).decode(checked.value);
+    return FieldValueValidator.of(field).parse(asked);
   }
 
   private validated<T>(value: T, operation: string, index?: number): T {
@@ -195,18 +191,9 @@ export class StorageGuard {
         parsed[key] = item;
         continue;
       }
-      const checked = FieldValueValidator.of(field).validate(item);
-      if ('error' in checked) {
-        errors.push(`${where}${key}: ${checked.error}`);
-        continue;
-      }
-      if (checked.value === null) {
-        parsed[key] = null;
-        continue;
-      }
-      const decoded = Boundary.of(field).decode(checked.value);
-      if ('error' in decoded) errors.push(`${where}${key}: ${decoded.error}`);
-      else parsed[key] = decoded.value;
+      const value = FieldValueValidator.of(field).parse(item);
+      if ('error' in value) errors.push(`${where}${key}: ${value.error}`);
+      else parsed[key] = value.value;
     }
 
     if (errors.length > 0) {

package/src/dispatch/presenterArguments.ts

@@ -1,24 +1,36 @@
-import { computeBindingPlan } from '../wire/binding.js';
+import { computeBindingPlan, type BindingPlan } from '../wire/binding.js';
 import type { InvocationContext } from '../wire/Invocation.js';
 import type { PresenterEntry } from '../descriptor/frond.js';
 import type { ArgumentResolver } from './ArgumentResolver.js';
 import type { PresenterArgs } from './PresenterExecutor.js';
 
+/**
+ * Where each computed field's extra arguments come from — read off the declaration, so a
+ * field that takes only the page is absent and asks for nothing.
+ */
+export function presenterPlans(
+  meta: PresenterEntry,
+  collectorTypes: Set<string>,
+): Map<string, BindingPlan> {
+  const plans = new Map<string, BindingPlan>();
+  for (const field of meta.fieldMeta) {
+    if (!field.params?.length) continue;
+    plans.set(field.name, computeBindingPlan(field.params, collectorTypes));
+  }
+
+  return plans;
+}
+
 /** The invocation-dependent arguments of every computed presenter field. */
 export async function presenterArguments(
-  meta: PresenterEntry,
+  plans: Map<string, BindingPlan>,
   invocation: InvocationContext,
   resolver: ArgumentResolver,
-  collectorTypes: Set<string>,
 ): Promise<PresenterArgs> {
   const argumentsByField: PresenterArgs = {};
 
-  for (const field of meta.fieldMeta) {
-    if (!field.params?.length) continue;
-    argumentsByField[field.name] = await resolver.resolve(
-      computeBindingPlan(field.params, collectorTypes),
-      invocation,
-    );
+  for (const [field, plan] of plans) {
+    argumentsByField[field] = await resolver.resolve(plan, invocation);
   }
 
   return argumentsByField;

package/src/dispatch/validateInput.ts

@@ -1,4 +1,4 @@
-import { InputValidator, type SchemaView } from '@fougere/schema';
+import { InputValidator, dotted, type SchemaView } from '@fougere/schema';
 import type { InvocationContext } from '../wire/Invocation.js';
 import { ErrorCode, FougereError } from '../wire/errors.js';
 
@@ -17,7 +17,7 @@ export function validateInput(
   if (!result.success) {
     throw new FougereError({
       code: ErrorCode.VALIDATION_FAILED,
-      message: result.errors.map((error) => `${error.path}: ${error.message}`).join(', '),
+      message: result.errors.map((error) => `${dotted(error.path)}: ${error.message}`).join(', '),
       details: result.errors,
       entity,
       operation,

package/src/effective-operation.ts

@@ -4,7 +4,8 @@ import { statementDrift } from './boot/statement-drift.js';
 import { computeBindingPlan, type BindingPlan } from './wire/binding.js';
 import { targetOf } from './prefab/prefab.js';
 import type { CollectorEntry, FrondDescriptor, HandlerEntry } from './descriptor/frond.js';
-import type { ScanDiagnostic } from './scan/result.js';
+import { servedSurfaces } from './descriptor/surface.js';
+import type { ScanDiagnostic } from './scan.js';
 import { verify } from './verify.js';
 import {
   inferOperationKind,
@@ -279,7 +280,7 @@ export function resolveEffectiveOperations(
             ...(remote ? { remote } : {}),
           },
           exposure: {
-            surfaces: surfacesOf(frond, handler),
+            surfaces: servedSurfaces(frond, handler).map((surface) => surface ?? 'default'),
             adapters: exposedAdapters(handler, options.adapters),
           },
           outputClosed: output.closed,
@@ -557,18 +558,6 @@ function effectiveOutput(
   return { ...(entity ? { schema: entity.entityClass } : {}), closed: false };
 }
 
-function surfacesOf(frond: FrondDescriptor, handler: HandlerEntry): string[] {
-  if (handler.surface) return [handler.surface];
-  const surfaces = ['default'];
-  for (const [surface, addresses] of Object.entries(frond.surfaces ?? {})) {
-    const dedicated = frond.handlers.some((candidate) =>
-      candidate.address === handler.address && candidate.surface === surface);
-    if (!dedicated && addresses.some((address) =>
-      address.toLowerCase() === handler.address.toLowerCase())) surfaces.push(surface);
-  }
-  return [surfaces[0]!, ...surfaces.slice(1).sort()];
-}
-
 function exposedAdapters(
   handler: HandlerEntry,
   adapters: Record<string, boolean | undefined> | undefined,

package/src/index.ts

@@ -73,7 +73,7 @@ export type {
   FrondCall, Transport, IdentityCard, CardOp, Facade, RpcAnswer,
   TopologyReport, FrondPlacement, Edge,
 } from './wire/call.js';
-export { type Emit, type Fact } from './emit.js';
+export { type Emit, type Fact } from './wire/emit.js';
 export { callValueOf } from './contract.js';
 export type { CallValue } from './contract.js';
 export { toHttpError, toPublicError } from './wire/http-error.js';
@@ -83,14 +83,18 @@ export type { LogLevel, LogRecord, LogSink } from './builtin/logger.js';
 // What a re-read config changes in a running process — and what it cannot.
 export { applyConfig, type ConfigApplication } from './boot/apply.js';
 export { Config } from './builtin/config.js';
-export type { Storage, StorageFactory, ListOptions, ListResult, Together } from './storage.js';
-export { togetherKeyOf, membersOfTogetherKey } from './storage.js';
+export type { Storage, StorageFactory, ListOptions, ListResult, Together } from './storage/port.js';
+export { togetherKeyOf, membersOfTogetherKey } from './storage/port.js';
 export type { Constraint, Source, SourceConfig, SourceView } from './source.js';
 export { Sources } from './source.js';
-export { storageOver } from './store.js';
-export type { Store, Values } from './store.js';
+export { storageOver } from './storage/store.js';
+export type { Store, Values } from './storage/store.js';
 export type { App, CreateAppOptions } from './boot/types.js';
-export type { ScanResult, ScanDiagnostic } from './scan/result.js';
+export type { ScanResult, ScanDiagnostic } from './scan.js';
+export {
+  type Conventions, type ConventionsInput, DEFAULT_CONVENTIONS,
+  resolveConventions, frondPackage, frondDirsOf, providerDirsOf,
+} from './conventions.js';
 export type {
   FrondDescriptor,
   FrondSource,
@@ -107,9 +111,6 @@ export type { AuthConfig, AuthContext, AuthRuntime } from './boot/auth.js';
 export { Fronds } from './descriptor/Fronds.js';
 export { verify, assertSplittable, type Violation } from './verify.js';
 // Same question as verify(), answered from the source text instead of the model.
-export type { CrossFrondImport } from './imports.js';
-export type { HandlerDeclaration } from './declarations.js';
-export type { OutsideConvention } from './placement.js';
 // Who is calling, established rather than accepted — the proof beside `state`'s claim.
 // `generateKeyPair` and `issueGrant` are NOT here: they make keys at a deployment and
 // need `node:crypto` for a gesture WebCrypto has no equal of. They sit on `/node`.

package/src/node.ts

@@ -1,21 +1,7 @@
-/** What Fougere does with a filesystem — the half of core that a Worker cannot run. */
-export { boot } from './boot/boot.js';
-
-export { scanProject, frondAliases, watchPathsOf } from './scan/scanner.js';
-export {
-  type Conventions, type ConventionsInput, DEFAULT_CONVENTIONS,
-  resolveConventions, frondPackage, frondDirsOf, providerDirsOf,
-} from './scan/conventions.js';
-export { RUNTIME_PACKAGES } from './scan/bundling.js';
-export { emitScan, type EmitOptions } from './scan/emit.js';
-export { emitStatement } from './scan/statement.js';
+/** What Fougere does with a filesystem, minus the scan — that is `@fougere/compiler`. */
 export { setModuleLoader, getModuleLoader } from './loader.js';
 export { loadConfig, loadCascadedConfig } from './config-loader.js';
-export { defineFrond } from './frond-config.js';
-export { crossFrondImports } from './imports.js';
-export { handlerDeclarations } from './declarations.js';
-export { outsideConventions } from './placement.js';
-export { adaptersOf } from './scan/adapters.js';
+export { defineFrond, loadFrondConfig } from './frond-config.js';
 
 // Making a key and binding a name to it happen once, at a deployment, on a machine with
 // a filesystem — the CLI speaking. Verifying happens per call, everywhere, and stays on

package/src/prefab/crud.ts

@@ -1,5 +1,5 @@
 import { lowerFirst, type EntityConstructor, type SchemaView } from '@fougere/schema';
-import type { Storage, ListOptions, ListResult } from '../storage.js';
+import type { Storage, ListOptions, ListResult } from '../storage/port.js';
 import type { OperationContract } from '../wire/operation.js';
 import { targetOf } from './prefab.js';
 

package/src/prefab/mirror.ts

@@ -1,26 +1,27 @@
-import { Lifecycle, type EntityConstructor, type Fields } from '@fougere/schema';
-import type { Storage } from '../storage.js';
+import type { EntityConstructor } from '@fougere/schema';
+import type { Storage } from '../storage/port.js';
 
-/** A paginated local copy of a source that cannot be queried directly. */
 /** What one refresh did — enough to log it, and to decide whether to run again. */
 export interface Refreshed {
   /** Instances written, counting a replaced one once. */
   written: number;
-  /** The age the pull was asked to start from — absent on the first ever run. */
+  /** The age the pull was asked to start from — absent when it asked for everything. */
   since?: Date;
   /** How long the whole pass took, pull included. */
   ms: number;
 }
 
+/** A paginated local copy of a source that cannot be queried directly. */
 export interface MirrorOf<T> {
-  /** The copy's own storage — where a page lands, and where its age is read. */
+  /** The copy's own storage — where a page lands. */
   storage: Storage<T>;
   /** Pages of rows to write. The one thing a mirror's author supplies. */
   pull(since?: Date): AsyncIterable<Partial<T>[]>;
-  /** Run one pass: read the high-water mark, pull from there, write each page. */
-  refresh(): Promise<Refreshed>;
-  /** When the freshest row here was written — `undefined` while the copy is empty. */
-  freshness(): Promise<Date | undefined>;
+  /**
+   * Pull from `since` and write every page. The mark is the CALLER's: only it knows
+   * whether a pass completed, and a pass that throws must not advance it.
+   */
+  refresh(since?: Date): Promise<Refreshed>;
 }
 
 export interface MirrorConstructor<T> {
@@ -31,16 +32,6 @@ export interface MirrorConstructor<T> {
 export function Mirror<E extends EntityConstructor>(shape: E): MirrorConstructor<InstanceType<E>> {
   type T = InstanceType<E>;
 
-  // Refuse an undated copy before it can be used as if it held live rows.
-  const declared = ageFieldOf(shape);
-  if (declared === undefined) {
-    throw new Error(
-      `Mirror(${(shape as { name?: string }).name ?? '?'}): the shape carries no \`updated()\` field — ` +
-      `a copy has to be able to say when it was pulled, and \`refresh\` reads its high-water mark from it.`,
-    );
-  }
-  const age: string = declared;
-
   abstract class MirrorBase implements MirrorOf<T> {
     static readonly __entity = shape;
 
@@ -48,35 +39,18 @@ export function Mirror<E extends EntityConstructor>(shape: E): MirrorConstructor
 
     abstract pull(since?: Date): AsyncIterable<Partial<T>[]>;
 
-    /** The freshest persisted stamp; no process-local freshness state is kept. */
-    async freshness(): Promise<Date | undefined> {
-      const [newest] = await this.storage.list({ orderBy: age, order: 'desc', limit: 1 });
-      const value = (newest as Record<string, unknown> | undefined)?.[age];
-      return value instanceof Date ? value : undefined;
-    }
-
-    async refresh(): Promise<Refreshed> {
+    async refresh(since?: Date): Promise<Refreshed> {
       const started = Date.now();
-      const since = await this.freshness();
       let written = 0;
       // Preserve the source's page boundaries: one page becomes one upsert.
       for await (const page of this.pull(since)) {
         if (page.length === 0) continue;
         written += await this.storage.upsertAll(page);
       }
+
       return { written, since, ms: Date.now() - started };
     }
   }
 
   return MirrorBase as unknown as MirrorConstructor<T>;
 }
-
-/** The field whose lifecycle stamps every update. */
-export function ageFieldOf(shape: unknown): string | undefined {
-  const fields = (shape as { getFields?: () => Fields }).getFields?.();
-  if (!fields) return undefined;
-  for (const [name, field] of Object.entries(fields)) {
-    if (Lifecycle.of(field).stampedOnUpdate) return name;
-  }
-  return undefined;
-}

package/src/prefab/repository.ts

@@ -1,5 +1,5 @@
 import { upperFirst, type EntityConstructor } from '@fougere/schema';
-import type { Storage, ListOptions, ListResult, SelectOption } from '../storage.js';
+import type { Storage, ListOptions, ListResult, SelectOption } from '../storage/port.js';
 import type { SchemaView } from '@fougere/schema';
 
 /** Repository(…entities) — who owns an entity's storage, and where its questions are named. */

package/src/{scan/result.ts → scan.ts}

@@ -1,4 +1,4 @@
-import type { Fronds } from '../descriptor/Fronds.js';
+import type { Fronds } from './descriptor/Fronds.js';
 
 /** Result of scanning a project directory. */
 /** Something the scan could NOT do — recorded instead of swallowed. */

package/src/source.ts

@@ -1,5 +1,5 @@
 import { Registry, Role, type SchemaView } from '@fougere/schema';
-import type { StorageFactory } from './storage.js';
+import type { StorageFactory } from './storage/port.js';
 
 /** A promise the judge at the door cannot keep, because it is about rows it never sees. */
 export type Constraint = 'unique';

package/src/{criterion.ts → storage/criterion.ts}

@@ -35,8 +35,8 @@ export type ComparisonName = (typeof COMPARISONS)[number];
  */
 export function comparisonOf(field: Field | undefined, asked: unknown): Comparison | undefined {
   if (asked === null || typeof asked !== 'object' || Array.isArray(asked)) return undefined;
-  // `Shapes.of` answers with `null` already taken out — `optional(json())` is an object.
-  if (!field || Shapes.of(field.shape).base?.type === 'object') return undefined;
+  // The type is read off the base, so `optional(json())` still answers `object`.
+  if (!field || Shapes.typeOf(field.shape) === 'object') return undefined;
 
   return asked as Comparison;
 }

package/src/{storage.ts → storage/port.ts}

@@ -45,15 +45,30 @@ const LIST_OPTION_KEYS = [
   'limit', 'offset', 'page', 'after', 'orderBy', 'order', 'count', 'where', 'select',
 ] as const;
 
-/** Refuse an option the port does not answer to, naming it and what was expected. */
-export function assertListOptions(options: object | undefined, entity: string): void {
+/**
+ * Refuse an option the port does not answer to, and an order by a field the entity does not
+ * declare — an unhonoured `orderBy` returns the page in whatever order the engine chose.
+ */
+export function assertListOptions(
+  options: object | undefined,
+  entity: string,
+  declared: readonly string[],
+): void {
   if (!options) return;
   const legal = new Set<string>(LIST_OPTION_KEYS);
   const strangers = Object.keys(options).filter((key) => !legal.has(key));
-  if (strangers.length === 0) return;
+  if (strangers.length > 0) {
+    throw new Error(
+      `${entity}.list(): unknown option ${strangers.map((s) => `\`${s}\``).join(', ')}. ` +
+      `Known options are ${LIST_OPTION_KEYS.join(', ')} — to filter, pass \`where: { ${strangers[0]}: … }\`.`,
+    );
+  }
+
+  const { orderBy } = options as ListOptions;
+  if (orderBy === undefined || declared.includes(orderBy)) return;
+
   throw new Error(
-    `${entity}.list(): unknown option ${strangers.map((s) => `\`${s}\``).join(', ')}. ` +
-    `Known options are ${LIST_OPTION_KEYS.join(', ')} — to filter, pass \`where: { ${strangers[0]}: … }\`.`,
+    `${entity}.list(): unknown orderBy \`${orderBy}\`. ${entity} declares ${declared.join(', ')}.`,
   );
 }
 

package/src/{store.ts → storage/store.ts}

@@ -1,7 +1,7 @@
 /** The thirteen gestures of {@link Storage}, derived from four. */
 import { applyCreate, applyUpdate, Lifecycle, Role, type SchemaView } from '@fougere/schema';
 import { comparisonOf, comparisonsIn, type Comparison } from './criterion.js';
-import type { Storage, StorageFactory } from './storage.js';
+import type { Storage, StorageFactory } from './port.js';
 
 /** One instance, as every realization hands it over. */
 export type Values = Record<string, unknown>;
@@ -47,11 +47,29 @@ export function storageOver(open: (entity: SchemaView, name: string) => Store):
         ? Object.fromEntries(Object.entries(values).filter(([key]) => selected.has(key)))
         : values);
 
+      // Same contract as SQL: the key and the creation stamps survive an overwrite.
+      // Named, and not reached through `this`: a caller may have wrapped these gestures,
+      // and a derived one that goes back through the front door is judged twice.
+      const upsert = async (input: Partial<Record<string, unknown>>): Promise<Values> => {
+        const values = applyCreate(fields, applyUpdate(fields, input));
+        const id = values[pk] as string | undefined;
+        if (id === undefined) throw new Error(`${name}.upsert(): no \`${pk}\` — an upsert needs the key it writes at.`);
+        const previous = await store.get(keyOf(id));
+        if (previous) {
+          for (const [key, field] of Object.entries(fields)) {
+            if (key === pk || Lifecycle.of(field).stampedOnce) values[key] = previous[key];
+          }
+        }
+        await store.set(keyOf(id), values);
+        return pick(values);
+      };
+
       return {
         client: store.client,
         async list(options?: any) {
           let items = await store.all();
           if (options?.where) items = items.filter((values) => matches(values, options.where));
+          if (options?.orderBy) items = sorted(items, options.orderBy, options.order);
           // Held before the page is cut, and after the filter: `total` answers "how many
           // match", which is what a paginator divides. Reading `store.size` at the end
           // answered a different question — everything the store holds, including the ones
@@ -104,22 +122,9 @@ export function storageOver(open: (entity: SchemaView, name: string) => Store):
           }
           return grouped;
         },
-        // Same contract as SQL: the key and the creation stamps survive an overwrite.
-        async upsert(input: Partial<Record<string, unknown>>) {
-          const values = applyCreate(fields, applyUpdate(fields, input));
-          const id = values[pk] as string | undefined;
-          if (id === undefined) throw new Error(`${name}.upsert(): no \`${pk}\` — an upsert needs the key it writes at.`);
-          const previous = await store.get(keyOf(id));
-          if (previous) {
-            for (const [key, field] of Object.entries(fields)) {
-              if (key === pk || Lifecycle.of(field).stampedOnce) values[key] = previous[key];
-            }
-          }
-          await store.set(keyOf(id), values);
-          return pick(values);
-        },
+        upsert,
         async upsertAll(inputs: readonly Partial<Record<string, unknown>>[]) {
-          for (const input of inputs) await this.upsert(input);
+          for (const input of inputs) await upsert(input);
           return inputs.length;
         },
         async create(input: Partial<Record<string, unknown>>) {
@@ -189,3 +194,17 @@ const ordered = (held: unknown, asked: unknown, holds: (a: number, b: number) =>
 /** What a Date and a number have in common, and a string keeps for itself. */
 const order = (value: unknown): number =>
   value instanceof Date ? value.getTime() : (value as number);
+
+/** The ORDER BY the engine would have compiled, answered over the rows the store held. */
+const sorted = (rows: Values[], field: string, direction: 'asc' | 'desc' | undefined): Values[] =>
+  [...rows].sort((left, right) =>
+    (direction === 'desc' ? -1 : 1) * rank(left[field], right[field]));
+
+/** A row that holds nothing sorts first, and two of them tie. */
+const rank = (left: unknown, right: unknown): number => {
+  if (left === null || left === undefined) return right === null || right === undefined ? 0 : -1;
+  if (right === null || right === undefined) return 1;
+  const [held, against] = [order(left), order(right)];
+
+  return held === against ? 0 : held < against ? -1 : 1;
+};

package/src/verify.ts

@@ -1,7 +1,7 @@
 import type { FrondDescriptor } from './descriptor/frond.js';
 import { lowerFirst } from '@fougere/schema';
 import { repositoryKeyOf } from './prefab/repository.js';
-import { storageKeyOf } from './storage.js';
+import { storageKeyOf } from './storage/port.js';
 import { presenterKeyOf } from './prefab/presenter.js';
 import { collectorKeyOf } from './prefab/collector.js';
 

package/src/wire/call.ts

@@ -1,6 +1,6 @@
 /** Call contract — a frond call is a value. */
 import { Card, type SchemaDescriptor } from '@fougere/schema';
-import { factsAnnouncedBy } from '../emit.js';
+import { factsAnnouncedBy } from './emit.js';
 import { Invocation, type InvocationContext, type PartialInvocation } from './Invocation.js';
 import type { RouteAddress } from './RouteAddress.js';
 import { FougereError, ErrorCode } from './errors.js';

package/src/wire/errors.ts

@@ -55,7 +55,7 @@ export class FougereError extends Error {
 
   constructor(options: FougereErrorOptions) {
     super(options.message, { cause: options.cause });
-    this.name = 'FougereError';
+    this.name = new.target.name;
     this.code = options.code;
     this.entity = options.entity;
     this.operation = options.operation;
@@ -97,7 +97,7 @@ export function validationErrorsOf(error: unknown): ValidationError[] | undefine
   const refusals = details.filter(
     (entry): entry is ValidationError =>
       typeof entry === 'object' && entry !== null
-      && typeof (entry as ValidationError).path === 'string'
+      && Array.isArray((entry as ValidationError).path)
       && typeof (entry as ValidationError).message === 'string',
   );
   return refusals.length === details.length ? refusals : undefined;

package/dist/boot/boot.d.ts

@@ -1,45 +0,0 @@
-import { type FougereConfig } from '../config-loader.js';
-import type { App, CreateAppOptions } from './types.js';
-import { type Extension } from './AppLifecycle.js';
-import type { Transport } from '../wire/call.js';
-import type { Container } from '@fougere/container';
-interface BootOptions {
-    /** Project root. Defaults to process.cwd(). */
-    root?: string;
-    /** Override config (merged with fougere.config.ts). */
-    config?: Partial<FougereConfig>;
-    /** Container factory. Required. */
-    createContainer: () => Container;
-    /** Only boot these fronds (by name). Absent = all. */
-    fronds?: string[];
-    /**
-     * Remote fronds — label → address. A declared remote wins over local
-     * presence (the frond runs elsewhere). Requires `remoteTransport`.
-     */
-    remotes?: Record<string, string>;
-    /** Builds the transport to reach `remotes`. Supplied by a layer-2 package. */
-    remoteTransport?: (url: string) => Transport;
-    /** Carries an announced fact out of this process. */
-    onEmit?: CreateAppOptions['onEmit'];
-    /**
-     * storage setup — returns the storage handle (db), an storageFactory, and its two halves.
-     * The `db` value is forwarded to the auth provider via AuthContext when `auth` is set.
-     */
-    db?: (config: FougereConfig) => {
-        db?: unknown;
-        storageFactory: CreateAppOptions['storageFactory'];
-        /** Bring the schema up to date — an extension's `up`, because it runs after the container. */
-        migrate?: (app: App) => Promise<void> | void;
-        /** Closes what the factory opened — `boot()` called it, so `boot()` releases it. */
-        close?: () => Promise<void>;
-    };
-    /**
-     * What this app takes on beyond its fronds. Appended after the framework's own, so a
-     * host adds to the ascent — or replaces a member of it by declaring the same name.
-     */
-    extensions?: readonly (Extension | undefined)[];
-}
-/** Boot a Fougere app from fougere.config.ts. */
-export declare function boot(options: BootOptions): Promise<App>;
-export {};
-//# sourceMappingURL=boot.d.ts.map

package/dist/boot/boot.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"boot.d.ts","sourceRoot":"","sources":["../../src/boot/boot.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGrE,OAAO,KAAK,EAAE,GAAG,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,UAAU,WAAW;IACnB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAChC,mCAAmC;IACnC,eAAe,EAAE,MAAM,SAAS,CAAC;IACjC,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,8EAA8E;IAC9E,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,SAAS,CAAC;IAC7C,qDAAqD;IACrD,MAAM,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACpC;;;OAGG;IACH,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK;QAC9B,EAAE,CAAC,EAAE,OAAO,CAAC;QACb,cAAc,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;QACnD,8FAA8F;QAC9F,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QAC7C,oFAAoF;QACpF,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;KAC7B,CAAC;IACF;;;OAGG;IACH,UAAU,CAAC,EAAE,SAAS,CAAC,SAAS,GAAG,SAAS,CAAC,EAAE,CAAC;CACjD;AAED,iDAAiD;AACjD,wBAAsB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CA4D7D"}

package/dist/boot/boot.js

@@ -1,63 +0,0 @@
-import { createApp } from './bootstrap.js';
-import { seeding } from './seed.js';
-import { scanProject } from '../scan/scanner.js';
-import { loadConfig } from '../config-loader.js';
-import { Logger } from '../builtin/logger.js';
-import { applyConfig } from './apply.js';
-import { migrating } from './AppLifecycle.js';
-/** Boot a Fougere app from fougere.config.ts. */
-export async function boot(options) {
-    const bootStart = performance.now();
-    const log = new Logger('boot');
-    const root = options.root ?? process.cwd();
-    log.info(`root: ${root}`);
-    log.debug('loading config');
-    const fileConfig = await loadConfig(root);
-    const config = { ...fileConfig, ...options.config };
-    // What this config changes in the process, said the same way at boot and at reload —
-    // there is one applier, and a host re-reading later calls the very same function.
-    applyConfig(config);
-    log.info('config loaded');
-    let dbSetup;
-    if (options.db) {
-        log.debug('initializing database');
-        dbSetup = options.db(config);
-        log.info('database initialized');
-    }
-    log.debug('creating app (scan + container)');
-    const app = await createApp({
-        // boot() lives on the Node entry, so boot() is what reads the disk. `createApp` is
-        // handed the answer and reaches for nothing.
-        scan: await scanProject(root, options.fronds, config.conventions),
-        createContainer: options.createContainer,
-        storageFactory: dbSetup?.storageFactory,
-        db: dbSetup?.db,
-        auth: config.auth,
-        remotes: options.remotes,
-        ports: config.ports,
-        // Read from the config for the same reason `ports` is, one line up: it is a fact the
-        // project states, not one the caller passes. Absent here, `serveRest` and
-        // `serveGraphQL` both answered `pass` on an app whose config declared them — the
-        // hosts got it right through their own boot (`app/shared/src/boot.ts`), and this
-        // path, the conventional one, served nothing.
-        adapters: config.adapters,
-        // boot() called the factory, so boot() owns closing what it opened. Not an extension:
-        // it was opened before the container existed, so it closes after the container goes.
-        onDispose: dbSetup?.close,
-        /**
-         * The whole ascent, in one ordered list — tables, then rows, then whatever the host takes on.
-         */
-        extensions: [
-            migrating(dbSetup?.migrate, (message) => log.warn(message)),
-            seeding((message) => log.debug(message)),
-            ...(options.extensions ?? []),
-        ],
-        onEmit: options.onEmit,
-        remoteTransport: options.remoteTransport,
-    });
-    log.info(`ascent: ${app.extensions().join(' → ') || 'nothing declared'}`);
-    const ms = (performance.now() - bootStart).toFixed(0);
-    log.info(`ready in ${ms}ms — ${app.fronds.length} frond(s)`);
-    return app;
-}
-//# sourceMappingURL=boot.js.map

package/dist/boot/boot.js.map

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

package/dist/criterion.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"criterion.d.ts","sourceRoot":"","sources":["../src/criterion.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,OAAO,EAAE,KAAK,KAAK,EAAU,MAAM,iBAAiB,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,wDAAwD;IACxD,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,eAAO,MAAM,WAAW,qFAAsF,CAAC;AAE/G,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAM7F;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,CAAC,cAAc,EAAE,OAAO,CAAC,EAAE,CAIjF;AAED,mFAAmF;AACnF,wBAAgB,SAAS,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,EAAE,CAE1D"}