@fougere/core 0.19.1-alpha.0 → 0.20.0-alpha.0

package/src/SourceConfig.ts

@@ -1,10 +1,8 @@
+import type { FougereSources } from './FougereSources.js';
 import type { NameOf } from './NameOf.js';
 
-/** What a config file can carry about a source — values, never a live driver. */
-export interface SourceConfig {
-  /** The adapter that realizes it. Absent means the conventional one. */
-  source?: NameOf<'source'>;
-  /** The entities whose rows live here. Absent on the default source: it holds the rest. */
-  entities?: string[];
-  [key: string]: unknown;
-}
+/** One entry of `sources:` — what its type admits, and the entities whose rows live there. */
+export type SourceConfig = FougereSources[keyof FougereSources] & {
+  /** Absent on the default source: it holds the rest. */
+  entities?: NameOf<'entity'>[];
+};

package/src/boot/App.ts

@@ -7,6 +7,7 @@ import type { EffectiveOperationsMap } from '../EffectiveOperationsMap.js';
 import type { DispatchObserver } from '../dispatch/DispatchObserver.js';
 import type { DispatchPort } from '../dispatch/DispatchPort.js';
 import type { Storage } from '../storage/Storage.js';
+import type { ProtocolConfig } from '../Protocol.js';
 
 /** The App object returned by createApp(). */
 export interface App extends DispatchPort {
@@ -14,8 +15,8 @@ export interface App extends DispatchPort {
   local: DispatchPort;
   /** Root container with builtins + frond scopes. */
   container: Container;
-  /** Which protocol adapters this app declared, from `fougere.config.ts`. */
-  adapters: Record<string, boolean | undefined>;
+  /** The protocols this app serves, from `fougere.config.ts`. */
+  protocols: ProtocolConfig;
   /** Where a call goes, as the config declared it — frond name to address. */
   remotes: Readonly<Record<string, string>>;
   /** Discovered fronds metadata. */

package/src/boot/CreateAppOptions.ts

@@ -1,4 +1,5 @@
 import type { Container } from '@fougere/container';
+import type { ProtocolConfig } from '../Protocol.js';
 import type { FrondDescriptor } from '../descriptor/FrondDescriptor.js';
 import type { FrondsStated } from '../FrondsStated.js';
 import type { ScanResult } from '../scan.js';
@@ -75,8 +76,8 @@ export interface CreateAppOptions {
    * here — a storage connection is the one case today.
    */
   onDispose?: () => Promise<void> | void;
-  /** Which protocol adapters this app serves — see `FougereConfig.adapters`. */
-  adapters?: Record<string, boolean | undefined>;
+  /** The protocols this app serves — see `FougereConfig.protocols`. */
+  protocols?: ProtocolConfig;
   /** Carries an announced fact out of this process — a broker, a queue, a log. */
   onEmit?: (fact: string, payload: unknown) => void | Promise<void>;
 }

package/src/boot/bootstrap.ts

@@ -1,4 +1,5 @@
 import { createContainer, type Container } from '@fougere/container';
+import { servedProtocols } from './protocols.js';
 import { unregistered } from './unregistered.js';
 import { lowerFirst, type SchemaView } from '@fougere/schema';
 
@@ -151,7 +152,7 @@ async function readFronds(
   const operationModel = resolveEffectiveOperations(ordered, {
     diagnostics,
     remotes: options.remotes,
-    adapters: options.adapters,
+    protocols: servedProtocols(options.protocols),
   });
   const scanMs = (performance.now() - scanStart).toFixed(0);
   log.info(`read ${ordered.length} frond(s) in ${scanMs}ms`
@@ -382,7 +383,7 @@ function hostingFor(
 
   const hosting: Hosting = {
     hostedHere: (entity) => !(options.remotes && (frondOf.get(entity) ?? '') in options.remotes),
-    sourceOf: (name) => options.sourceOf?.(name) ?? 'db',
+    sourceOf: (name) => options.sourceOf?.(name) ?? 'default',
     enforces: (source, constraint) => options.enforces?.(source, constraint) ?? false,
     storageOf,
     entities: () => entityByName,
@@ -725,7 +726,7 @@ export async function createApp(options: CreateAppOptions): Promise<App> {
     const app: App = {
       container,
       fronds,
-      adapters: options.adapters ?? {},
+      protocols: options.protocols ?? {},
       // As DECLARED, beside what the runtime observes — the two disagree exactly when something is misconfigured.
       remotes: Object.freeze({ ...options.remotes }),
       dispatch: (call) => dispatcher.dispatch(call),

package/src/boot/install.ts

@@ -212,7 +212,7 @@ function registerStorages(
   const release = releasing(assembly.hosting);
   for (const entity of frond.entities) {
     const key = storageKeyOf(entity.name);
-    const source = options.sourceOf?.(entity.name) ?? 'db';
+    const source = options.sourceOf?.(entity.name) ?? 'default';
     if (declares(entity.entityClass, 'unique') && options.enforces?.(source, 'unique') === false) {
       unenforced.push(`${entity.name} in '${source}'`);
     }

package/src/boot/protocols.ts

@@ -0,0 +1,13 @@
+import { JsonSchemaValidator, SchemaError, dotted, type JsonSchema } from '@fougere/schema';
+import { Protocols, type ProtocolConfig } from '../Protocol.js';
+
+/** Each protocol named in `protocols:` — served by an imported adapter, and judged by its format. */
+export function servedProtocols(protocols: ProtocolConfig | undefined): ProtocolConfig {
+  for (const [name, options] of Object.entries(protocols ?? {})) {
+    const type = Protocols.resolve(name, `protocols.${name}`);
+    const refusal = JsonSchemaValidator.of(type.format.schema as JsonSchema).refusalOf(options, [`protocols.${name}`]);
+    if (refusal) throw new SchemaError(`${dotted(refusal.path)}: ${refusal.message}`);
+  }
+
+  return protocols ?? {};
+}

package/src/boot/together.ts

@@ -225,7 +225,7 @@ export function registerFrames(
  * compensate a frame whose own engine holds transactions.
  */
 function frameOver(key: string, members: Members, scope: Container, world: FrameWorld): Frame {
-  const sources = new Set(members.entities.map((member) => world.sourceOf?.(member.name) ?? 'db'));
+  const sources = new Set(members.entities.map((member) => world.sourceOf?.(member.name) ?? 'default'));
   const validator = (storage: Storage, name: string, schema: SchemaView) =>
     new StorageGuard(schema.getFields(), name, {}, heldBy(schema, name, world.hosting), releasing(world.hosting)).guard(storage);
 
@@ -244,7 +244,7 @@ function frameOver(key: string, members: Members, scope: Container, world: Frame
   // write and replays the inverses itself. `validator` stays OUTSIDE `recording`, so a write the
   // entity refuses never enters the journal.
   const why = sources.size > 1
-    ? members.entities.map((one) => `${one.name} in '${world.sourceOf?.(one.name) ?? 'db'}'`).join(', ')
+    ? members.entities.map((one) => `${one.name} in '${world.sourceOf?.(one.name) ?? 'default'}'`).join(', ')
     : 'this storage hands out no transaction';
   world.log.info(`${key} — compensated: ${why} — no isolation`);
 

package/src/index.ts

@@ -4,7 +4,8 @@ export { orderSeeds, runSeeds, seeding } from './boot/seed.js';
 export { AppLifecycle, checking, migrating } from './boot/AppLifecycle.js';
 export type { Extension } from './boot/Extension.js';
 export { defineFougere } from './define.js';
-export type { AdapterConfig } from './AdapterConfig.js';
+export { Protocols, serves, type ProtocolConfig, type ProtocolType } from './Protocol.js';
+export type { FougereProtocols } from './FougereProtocols.js';
 export type { FougereConfig } from './FougereConfig.js';
 export { statesModule, type FrondsStated, type FrondStated } from './FrondsStated.js';
 export { statedFronds, type StatedFrond } from './StatedFrond.js';
@@ -133,7 +134,8 @@ export type { Constraint } from './Constraint.js';
 export type { Source } from './Source.js';
 export type { SourceConfig } from './SourceConfig.js';
 export { sourceViewOf, type SourceView } from './SourceView.js';
-export { Sources } from './Source.js';
+export { Sources, type SourceType } from './Source.js';
+export type { FougereSources } from './FougereSources.js';
 export { storageOver } from './storage/Store.js';
 export type { Store } from './storage/Store.js';
 export type { Values } from './storage/Values.js';

package/dist/AdapterConfig.d.ts

@@ -1,10 +0,0 @@
-/** Protocol adapters, by the name of the package that provides them. */
-export interface AdapterConfig {
-    /** `@fougere/adapter-rest` — REST under `/api/{frond}/{plural}`. */
-    rest?: boolean;
-    /** `@fougere/adapter-graphql` — a GraphQL schema over the same operations. */
-    graphql?: boolean;
-    /** A surface of your own; the framework only records that you declared it. */
-    [adapter: string]: boolean | undefined;
-}
-//# sourceMappingURL=AdapterConfig.d.ts.map

package/dist/AdapterConfig.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"AdapterConfig.d.ts","sourceRoot":"","sources":["../src/AdapterConfig.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,8EAA8E;IAC9E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8EAA8E;IAC9E,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CACxC"}

package/dist/AdapterConfig.js

@@ -1,3 +0,0 @@
-export {};
-// ── Loading ──────────────────────────────────────
-//# sourceMappingURL=AdapterConfig.js.map

package/dist/AdapterConfig.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"AdapterConfig.js","sourceRoot":"","sources":["../src/AdapterConfig.ts"],"names":[],"mappings":";AAUA,oDAAoD"}

package/src/AdapterConfig.ts

@@ -1,11 +0,0 @@
-/** Protocol adapters, by the name of the package that provides them. */
-export interface AdapterConfig {
-  /** `@fougere/adapter-rest` — REST under `/api/{frond}/{plural}`. */
-  rest?: boolean;
-  /** `@fougere/adapter-graphql` — a GraphQL schema over the same operations. */
-  graphql?: boolean;
-  /** A surface of your own; the framework only records that you declared it. */
-  [adapter: string]: boolean | undefined;
-}
-
-// ── Loading ──────────────────────────────────────