@craft-ts/core 0.7.0-beta.13

package/src/lib/craft-guard-runtime.js

@@ -0,0 +1,195 @@
+import { runInInjectionContext } from './host/craft-compat';
+import { isCraftException } from './craft-exception';
+import { craftExceptionOutcomeApi, } from './craft-route-exceptions';
+import { isGenerator } from './craft-generator-runtime';
+import { driveCraftProgramAsync, pumpCraftProgramSync, } from './craft-program-runtime';
+import { executeCraftRouterTrace } from './craft-router-trace';
+const GUARD_INVALID_YIELD_ERROR_MESSAGE = 'craft route guards can only yield craftService dependencies, exposed dependency helpers, or an craftUntilSettled/craftUntilDefined await request.';
+const GUARD_PUMP_OPTIONS = {
+    invalidYieldErrorMessage: GUARD_INVALID_YIELD_ERROR_MESSAGE,
+};
+/**
+ * Evaluates a guard generator **synchronously** for the reactive `phase: 'active'`
+ * re-check. Pumping the generator reads the craft signals it yields synchronously,
+ * so an enclosing `effect` tracks them; a settled `craftUntilSettled` resolves on the
+ * fast path, while a not-yet-settled await yields `'pending'` (no suspension).
+ */
+export function evaluateCraftGuardSync(iterator, injector) {
+    const step = executeCraftRouterTrace(injector, {
+        kind: 'routeStage',
+        phase: 'run',
+        stage: 'guard',
+        routePhase: 'active',
+    }, () => runInInjectionContext(injector, () => pumpCraftProgramSync(iterator, injector, GUARD_PUMP_OPTIONS)));
+    if (step.kind === 'await') {
+        return { kind: 'pending' };
+    }
+    if (step.kind === 'shortCircuit') {
+        return { kind: 'exception', exception: step.exception };
+    }
+    return isCraftException(step.value)
+        ? { kind: 'exception', exception: step.value }
+        : { kind: 'valid', value: step.value };
+}
+function mapOutcome(outcome, exception) {
+    switch (outcome.kind) {
+        case 'redirect':
+            return { kind: 'redirect', target: outcome.target };
+        case 'render':
+            return { kind: 'render', component: outcome.component, exception };
+        case 'global':
+            return { kind: 'global', exception };
+        case 'stay':
+            return { kind: 'stay' };
+        case 'noop':
+            return { kind: 'noop' };
+    }
+}
+// Resolves one exception through `handleExceptions`. A generator handler (it
+// `yield*`s craft services before its outcome) is delegated to so its yields
+// reach the driver, exactly like a generator guard/resolve stage.
+function* resolveRouteException(exception, router, handleExceptions, phase) {
+    const handler = handleExceptions[exception._tag];
+    if (!handler) {
+        // No handler for this code — surface as a thrown error (the outlet defaults
+        // unhandled errors to the global error component).
+        return { kind: 'thrownError', error: exception };
+    }
+    const context = {
+        ...craftExceptionOutcomeApi,
+        exception,
+        payload: exception.payload,
+        phase,
+        router: router,
+        createUrlTree: router.createUrlTree.bind(router),
+        navigate: router.navigate.bind(router),
+        navigateByUrl: router.navigateByUrl.bind(router),
+    };
+    const result = handler(context);
+    if (!isGenerator(result)) {
+        throw new Error('Route exception handlers must be wrapped with craftExceptionHandler(function* (...) {}).');
+    }
+    const outcome = yield* result;
+    return mapOutcome(outcome, exception);
+}
+// Drives any composing generator (guard, resolve, or exception handler) to a
+// settled step, going async only across real `craftUntilSettled`/`craftUntilDefined`
+// awaits — reusing the same pump/await plumbing as the synchronous re-check.
+async function driveStageToSettled(iterator, injector) {
+    const first = runInInjectionContext(injector, () => pumpCraftProgramSync(iterator, injector, GUARD_PUMP_OPTIONS));
+    return driveCraftProgramAsync(iterator, injector, first, GUARD_PUMP_OPTIONS);
+}
+async function resolveExceptionOutcomeInternal(exception, injector, router, handleExceptions, phase) {
+    const iterator = resolveRouteException(exception, router, handleExceptions, phase);
+    const first = runInInjectionContext(injector, () => pumpCraftProgramSync(iterator, injector, GUARD_PUMP_OPTIONS));
+    if (first.kind === 'await') {
+        throw new Error('Route exception handlers cannot suspend with craftUntilSettled/craftUntilDefined.');
+    }
+    // A handler that itself short-circuited (rare) cannot be handled again —
+    // surface it as a thrown error.
+    return first.kind === 'shortCircuit'
+        ? { kind: 'thrownError', error: first.exception }
+        : first.value;
+}
+async function resolveExceptionOutcome(exception, injector, router, handleExceptions, phase) {
+    return executeCraftRouterTrace(injector, {
+        kind: 'routeStage',
+        phase: 'run',
+        stage: 'exceptionHandler',
+        routePhase: phase,
+        url: router.url ?? '',
+    }, () => resolveExceptionOutcomeInternal(exception, injector, router, handleExceptions, phase));
+}
+// Drives one data stage (guard or resolve): either it yields an outcome to
+// short-circuit the whole chain (an exception was handled), or it produces the
+// stage's success data.
+async function driveDataStage(iterator, injector, router, handleExceptions, phase) {
+    const settled = await driveStageToSettled(iterator, injector);
+    // A stage may signal an exception by throwing (`CraftGenShortCircuit`) or by
+    // returning a bare `craftException` — handle both (mirrors the handler path).
+    const exception = settled.kind === 'shortCircuit'
+        ? settled.exception
+        : isCraftException(settled.value)
+            ? settled.value
+            : undefined;
+    if (exception) {
+        return {
+            outcome: await resolveExceptionOutcome(exception, injector, router, handleExceptions, phase),
+        };
+    }
+    return { data: settled.kind === 'done' ? settled.value : undefined };
+}
+async function driveTracedDataStage(stage, iterator, injector, router, handleExceptions, phase) {
+    return executeCraftRouterTrace(injector, {
+        kind: 'routeStage',
+        phase: 'run',
+        stage,
+        routePhase: phase,
+        url: router.url ?? '',
+    }, () => driveDataStage(iterator, injector, router, handleExceptions, phase));
+}
+/**
+ * Drives a route's `canActivate` → `resolve` chain to a {@link RouteChainOutcome}.
+ *
+ * `phase` is `'enter'` for the initial activation and `'active'` for a reactive
+ * guard re-evaluation; it is forwarded to each exception handler so a handler can
+ * react differently (e.g. a softer redirect on session expiry).
+ */
+async function runCraftRouteChainAsyncInternal(steps, injector, router, handleExceptions, phase = 'enter') {
+    try {
+        if (steps.match) {
+            const result = await driveTracedDataStage('match', steps.match, injector, router, handleExceptions, phase);
+            // `canMatch` only gates: an exception short-circuits the chain; its
+            // success value is discarded (no data path).
+            if ('outcome' in result) {
+                return result.outcome;
+            }
+            if (result.data === false) {
+                return { kind: 'stay' };
+            }
+        }
+        let guardData;
+        if (steps.guard) {
+            const result = await driveTracedDataStage('guard', steps.guard, injector, router, handleExceptions, phase);
+            if ('outcome' in result) {
+                return result.outcome;
+            }
+            if (result.data === false) {
+                return { kind: 'stay' };
+            }
+            guardData = result.data;
+        }
+        let resolveData;
+        if (steps.resolve) {
+            const result = await driveTracedDataStage('resolve', steps.resolve, injector, router, handleExceptions, phase);
+            if ('outcome' in result) {
+                return result.outcome;
+            }
+            resolveData = result.data;
+        }
+        return { kind: 'data', guardData, resolveData };
+    }
+    catch (error) {
+        // A rethrown `craftException` (e.g. the generic `HttpError`) routes through
+        // `handleExceptions` when a matching handler exists; anything else (a real
+        // error, or an unhandled code) becomes a thrown error → global by default.
+        if (isCraftException(error) && handleExceptions[error._tag]) {
+            try {
+                return await resolveExceptionOutcome(error, injector, router, handleExceptions, phase);
+            }
+            catch (handlerError) {
+                return { kind: 'thrownError', error: handlerError };
+            }
+        }
+        return { kind: 'thrownError', error };
+    }
+}
+export function runCraftRouteChainAsync(steps, injector, router, handleExceptions, phase = 'enter') {
+    return executeCraftRouterTrace(injector, {
+        kind: 'routeChain',
+        phase: 'run',
+        routePhase: phase,
+        url: router.url ?? '',
+    }, () => runCraftRouteChainAsyncInternal(steps, injector, router, handleExceptions, phase));
+}
+//# sourceMappingURL=craft-guard-runtime.js.map

package/src/lib/craft-guard-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-guard-runtime.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-guard-runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import { Injector, runInInjectionContext } from './host/craft-compat';\nimport type { CraftRouter, CraftUrlTree } from './craft-router';\n\ntype CraftRouteRouterLike = {\n  readonly url?: string;\n  createUrlTree: (...args: any[]) => unknown;\n  navigate: (...args: any[]) => Promise<boolean>;\n  navigateByUrl: (...args: any[]) => Promise<boolean>;\n};\nimport { isCraftException, type AnyCraftException } from './craft-exception';\nimport {\n  craftExceptionOutcomeApi,\n  type CraftExceptionComponentInput,\n  type CraftExceptionHandlerContext,\n  type CraftExceptionOutcome,\n  type CraftRoutePhase,\n} from './craft-route-exceptions';\nimport { isGenerator } from './craft-generator-runtime';\nimport {\n  driveCraftProgramAsync,\n  pumpCraftProgramSync,\n  type CraftProgramPumpOptions,\n  type CraftProgramSettledStep,\n} from './craft-program-runtime';\nimport { executeCraftRouterTrace } from './craft-router-trace';\n\nconst GUARD_INVALID_YIELD_ERROR_MESSAGE =\n  'craft route guards can only yield craftService dependencies, exposed dependency helpers, or an craftUntilSettled/craftUntilDefined await request.';\n\nconst GUARD_PUMP_OPTIONS: CraftProgramPumpOptions = {\n  invalidYieldErrorMessage: GUARD_INVALID_YIELD_ERROR_MESSAGE,\n};\n\n/**\n * The result of a synchronous guard re-evaluation (reactive \"live\" guards):\n * - `valid` — the guard passed without producing an exception;\n * - `exception` — the guard short-circuited / returned a `craftException`;\n * - `pending` — the guard suspended on a not-yet-settled `craftUntilSettled` (cannot be\n *   resolved synchronously) — the reactive check treats this as \"still valid\".\n */\nexport type CraftGuardSyncResult =\n  | { kind: 'valid'; value: unknown }\n  | { kind: 'exception'; exception: AnyCraftException }\n  | { kind: 'pending' };\n\n/**\n * Evaluates a guard generator **synchronously** for the reactive `phase: 'active'`\n * re-check. Pumping the generator reads the craft signals it yields synchronously,\n * so an enclosing `effect` tracks them; a settled `craftUntilSettled` resolves on the\n * fast path, while a not-yet-settled await yields `'pending'` (no suspension).\n */\nexport function evaluateCraftGuardSync(\n  iterator: Generator<unknown, unknown, unknown>,\n  injector: Injector,\n): CraftGuardSyncResult {\n  const step = executeCraftRouterTrace(\n    injector,\n    {\n      kind: 'routeStage',\n      phase: 'run',\n      stage: 'guard',\n      routePhase: 'active',\n    },\n    () =>\n      runInInjectionContext(injector, () =>\n        pumpCraftProgramSync(iterator, injector, GUARD_PUMP_OPTIONS),\n      ),\n  );\n\n  if (step.kind === 'await') {\n    return { kind: 'pending' };\n  }\n\n  if (step.kind === 'shortCircuit') {\n    return { kind: 'exception', exception: step.exception };\n  }\n\n  return isCraftException(step.value)\n    ? { kind: 'exception', exception: step.value }\n    : { kind: 'valid', value: step.value };\n}\n\n// ---------------------------------------------------------------------------\n// Non-blocking route chain driver.\n//\n// Drives a route's `canActivate` → `resolve` chain *after* the URL has committed\n// (the `CraftRouterOutlet` calls this), routing any `craftException` through the\n// route's exhaustive `handleExceptions` map to a {@link RouteChainOutcome}.\n// It never returns a `GuardResult`/`Observable` — the outlet owns rendering, and\n// mounts the target only on `'data'`/`'noop'`.\n// ---------------------------------------------------------------------------\n\n/** The settled result of a route's guard/resolve chain, consumed by the outlet. */\nexport type RouteChainOutcome =\n  | { kind: 'data'; guardData: unknown; resolveData: unknown }\n  | { kind: 'redirect'; target: CraftUrlTree | string }\n  | {\n      kind: 'render';\n      component: CraftExceptionComponentInput;\n      exception: AnyCraftException;\n    }\n  | { kind: 'global'; exception: AnyCraftException }\n  | { kind: 'stay' }\n  | { kind: 'noop' }\n  | { kind: 'thrownError'; error: unknown };\n\nexport type CraftRouteExceptionHandler = (\n  context: CraftExceptionHandlerContext<AnyCraftException>,\n) => Generator<unknown, CraftExceptionOutcome, unknown>;\n\n/** Runtime view of a route's `handleExceptions`, keyed by exception code. */\nexport type CraftRouteExceptionHandlerMap = Record<\n  string,\n  CraftRouteExceptionHandler | undefined\n>;\n\nexport interface CraftRouteChainSteps {\n  /** `canMatch` generator — run first; its success value is discarded. */\n  match?: Generator<unknown, unknown, unknown>;\n  /** `canActivate` generator — its success value is the route's guarded data. */\n  guard?: Generator<unknown, unknown, unknown>;\n  /** `resolve` generator — its success value is the route's resolved data. */\n  resolve?: Generator<unknown, unknown, unknown>;\n}\n\nfunction mapOutcome(\n  outcome: CraftExceptionOutcome,\n  exception: AnyCraftException,\n): RouteChainOutcome {\n  switch (outcome.kind) {\n    case 'redirect':\n      return { kind: 'redirect', target: outcome.target };\n    case 'render':\n      return { kind: 'render', component: outcome.component, exception };\n    case 'global':\n      return { kind: 'global', exception };\n    case 'stay':\n      return { kind: 'stay' };\n    case 'noop':\n      return { kind: 'noop' };\n  }\n}\n\n// Resolves one exception through `handleExceptions`. A generator handler (it\n// `yield*`s craft services before its outcome) is delegated to so its yields\n// reach the driver, exactly like a generator guard/resolve stage.\nfunction* resolveRouteException(\n  exception: AnyCraftException,\n  router: CraftRouteRouterLike,\n  handleExceptions: CraftRouteExceptionHandlerMap,\n  phase: CraftRoutePhase,\n): Generator<unknown, RouteChainOutcome, unknown> {\n  const handler = handleExceptions[exception._tag];\n\n  if (!handler) {\n    // No handler for this code — surface as a thrown error (the outlet defaults\n    // unhandled errors to the global error component).\n    return { kind: 'thrownError', error: exception };\n  }\n\n  const context: CraftExceptionHandlerContext<AnyCraftException> = {\n    ...craftExceptionOutcomeApi,\n    exception,\n    payload: exception.payload,\n    phase,\n    router: router as CraftRouter,\n    createUrlTree: router.createUrlTree.bind(\n      router,\n    ) as CraftRouter['createUrlTree'],\n    navigate: router.navigate.bind(router) as CraftRouter['navigate'],\n    navigateByUrl: router.navigateByUrl.bind(\n      router,\n    ) as CraftRouter['navigateByUrl'],\n  };\n\n  const result = handler(context);\n  if (!isGenerator(result)) {\n    throw new Error(\n      'Route exception handlers must be wrapped with craftExceptionHandler(function* (...) {}).',\n    );\n  }\n  const outcome = yield* result;\n\n  return mapOutcome(outcome, exception);\n}\n\n// Drives any composing generator (guard, resolve, or exception handler) to a\n// settled step, going async only across real `craftUntilSettled`/`craftUntilDefined`\n// awaits — reusing the same pump/await plumbing as the synchronous re-check.\nasync function driveStageToSettled(\n  iterator: Generator<unknown, unknown, unknown>,\n  injector: Injector,\n): Promise<CraftProgramSettledStep> {\n  const first = runInInjectionContext(injector, () =>\n    pumpCraftProgramSync(iterator, injector, GUARD_PUMP_OPTIONS),\n  );\n\n  return driveCraftProgramAsync(iterator, injector, first, GUARD_PUMP_OPTIONS);\n}\n\nasync function resolveExceptionOutcomeInternal(\n  exception: AnyCraftException,\n  injector: Injector,\n  router: CraftRouteRouterLike,\n  handleExceptions: CraftRouteExceptionHandlerMap,\n  phase: CraftRoutePhase,\n): Promise<RouteChainOutcome> {\n  const iterator = resolveRouteException(\n    exception,\n    router,\n    handleExceptions,\n    phase,\n  );\n  const first = runInInjectionContext(injector, () =>\n    pumpCraftProgramSync(iterator, injector, GUARD_PUMP_OPTIONS),\n  );\n\n  if (first.kind === 'await') {\n    throw new Error(\n      'Route exception handlers cannot suspend with craftUntilSettled/craftUntilDefined.',\n    );\n  }\n\n  // A handler that itself short-circuited (rare) cannot be handled again —\n  // surface it as a thrown error.\n  return first.kind === 'shortCircuit'\n    ? { kind: 'thrownError', error: first.exception }\n    : (first.value as RouteChainOutcome);\n}\n\nasync function resolveExceptionOutcome(\n  exception: AnyCraftException,\n  injector: Injector,\n  router: CraftRouteRouterLike,\n  handleExceptions: CraftRouteExceptionHandlerMap,\n  phase: CraftRoutePhase,\n): Promise<RouteChainOutcome> {\n  return executeCraftRouterTrace(\n    injector,\n    {\n      kind: 'routeStage',\n      phase: 'run',\n      stage: 'exceptionHandler',\n      routePhase: phase,\n      url: router.url ?? '',\n    },\n    () =>\n      resolveExceptionOutcomeInternal(\n        exception,\n        injector,\n        router,\n        handleExceptions,\n        phase,\n      ),\n  );\n}\n\n// Drives one data stage (guard or resolve): either it yields an outcome to\n// short-circuit the whole chain (an exception was handled), or it produces the\n// stage's success data.\nasync function driveDataStage(\n  iterator: Generator<unknown, unknown, unknown>,\n  injector: Injector,\n  router: CraftRouteRouterLike,\n  handleExceptions: CraftRouteExceptionHandlerMap,\n  phase: CraftRoutePhase,\n): Promise<{ outcome: RouteChainOutcome } | { data: unknown }> {\n  const settled = await driveStageToSettled(iterator, injector);\n\n  // A stage may signal an exception by throwing (`CraftGenShortCircuit`) or by\n  // returning a bare `craftException` — handle both (mirrors the handler path).\n  const exception =\n    settled.kind === 'shortCircuit'\n      ? settled.exception\n      : isCraftException(settled.value)\n        ? settled.value\n        : undefined;\n\n  if (exception) {\n    return {\n      outcome: await resolveExceptionOutcome(\n        exception,\n        injector,\n        router,\n        handleExceptions,\n        phase,\n      ),\n    };\n  }\n\n  return { data: settled.kind === 'done' ? settled.value : undefined };\n}\n\nasync function driveTracedDataStage(\n  stage: 'match' | 'guard' | 'resolve',\n  iterator: Generator<unknown, unknown, unknown>,\n  injector: Injector,\n  router: CraftRouteRouterLike,\n  handleExceptions: CraftRouteExceptionHandlerMap,\n  phase: CraftRoutePhase,\n): Promise<{ outcome: RouteChainOutcome } | { data: unknown }> {\n  return executeCraftRouterTrace(\n    injector,\n    {\n      kind: 'routeStage',\n      phase: 'run',\n      stage,\n      routePhase: phase,\n      url: router.url ?? '',\n    },\n    () => driveDataStage(iterator, injector, router, handleExceptions, phase),\n  );\n}\n\n/**\n * Drives a route's `canActivate` → `resolve` chain to a {@link RouteChainOutcome}.\n *\n * `phase` is `'enter'` for the initial activation and `'active'` for a reactive\n * guard re-evaluation; it is forwarded to each exception handler so a handler can\n * react differently (e.g. a softer redirect on session expiry).\n */\nasync function runCraftRouteChainAsyncInternal(\n  steps: CraftRouteChainSteps,\n  injector: Injector,\n  router: CraftRouteRouterLike,\n  handleExceptions: CraftRouteExceptionHandlerMap,\n  phase: CraftRoutePhase = 'enter',\n): Promise<RouteChainOutcome> {\n  try {\n    if (steps.match) {\n      const result = await driveTracedDataStage(\n        'match',\n        steps.match,\n        injector,\n        router,\n        handleExceptions,\n        phase,\n      );\n\n      // `canMatch` only gates: an exception short-circuits the chain; its\n      // success value is discarded (no data path).\n      if ('outcome' in result) {\n        return result.outcome;\n      }\n      if (result.data === false) {\n        return { kind: 'stay' };\n      }\n    }\n\n    let guardData: unknown;\n\n    if (steps.guard) {\n      const result = await driveTracedDataStage(\n        'guard',\n        steps.guard,\n        injector,\n        router,\n        handleExceptions,\n        phase,\n      );\n\n      if ('outcome' in result) {\n        return result.outcome;\n      }\n\n      if (result.data === false) {\n        return { kind: 'stay' };\n      }\n\n      guardData = result.data;\n    }\n\n    let resolveData: unknown;\n\n    if (steps.resolve) {\n      const result = await driveTracedDataStage(\n        'resolve',\n        steps.resolve,\n        injector,\n        router,\n        handleExceptions,\n        phase,\n      );\n\n      if ('outcome' in result) {\n        return result.outcome;\n      }\n\n      resolveData = result.data;\n    }\n\n    return { kind: 'data', guardData, resolveData };\n  } catch (error) {\n    // A rethrown `craftException` (e.g. the generic `HttpError`) routes through\n    // `handleExceptions` when a matching handler exists; anything else (a real\n    // error, or an unhandled code) becomes a thrown error → global by default.\n    if (isCraftException(error) && handleExceptions[error._tag]) {\n      try {\n        return await resolveExceptionOutcome(\n          error,\n          injector,\n          router,\n          handleExceptions,\n          phase,\n        );\n      } catch (handlerError) {\n        return { kind: 'thrownError', error: handlerError };\n      }\n    }\n\n    return { kind: 'thrownError', error };\n  }\n}\n\nexport function runCraftRouteChainAsync(\n  steps: CraftRouteChainSteps,\n  injector: Injector,\n  router: CraftRouteRouterLike,\n  handleExceptions: CraftRouteExceptionHandlerMap,\n  phase: CraftRoutePhase = 'enter',\n): Promise<RouteChainOutcome> {\n  return executeCraftRouterTrace(\n    injector,\n    {\n      kind: 'routeChain',\n      phase: 'run',\n      routePhase: phase,\n      url: router.url ?? '',\n    },\n    () =>\n      runCraftRouteChainAsyncInternal(\n        steps,\n        injector,\n        router,\n        handleExceptions,\n        phase,\n      ),\n  );\n}\n"]}

package/src/lib/craft-handshake.d.ts

@@ -0,0 +1,35 @@
+import type { CraftSchema } from './schema-validation';
+export declare const CRAFT_HANDSHAKE: unique symbol;
+/**
+ * Un nom sur lequel les deux côtés de la frontière se mettent d'accord.
+ *
+ * `craftUnique` dit « ce nom apparaît exactement une fois ». Ce n'est pas le
+ * bon prédicat ici : un identifiant de server function, ou la forme d'un
+ * contexte client, **doit** apparaître des deux côtés, puisque les deux
+ * fichiers ne peuvent pas s'importer. `craftHandshake` dit l'inverse — « ce
+ * nom a un pendant en face » — et c'est ça que la règle d'architecture vérifie.
+ *
+ * Déclaré une fois dans un module partagé, il est référencé par le serveur et
+ * par le client. Deux conséquences :
+ *
+ * - la chaîne n'existe qu'à un seul endroit du dépôt, donc l'égalité des deux
+ *   côtés devient une vérification TypeScript et non un rattrapage a posteriori ;
+ * - quand il porte un schéma, les deux côtés partagent le **même** schéma :
+ *   ils ne peuvent plus diverger.
+ */
+export type CraftHandshakeName<Name extends string = string> = Name & {
+    readonly [CRAFT_HANDSHAKE]: Name;
+};
+export type CraftHandshakeSchema<Name extends string = string, Schema extends CraftSchema = CraftSchema> = Schema & {
+    readonly [CRAFT_HANDSHAKE]: Name;
+};
+export type AnyCraftHandshake = CraftHandshakeName<string> | CraftHandshakeSchema<string, CraftSchema>;
+/** Identité partagée : l'id d'une server function, nommé une seule fois. */
+export declare function craftHandshake<const Name extends string>(name: Name): CraftHandshakeName<Name>;
+/** Forme partagée : un schéma de contexte client, écrit une seule fois. */
+export declare function craftHandshake<const Name extends string, Schema extends CraftSchema>(name: Name, schema: Schema): CraftHandshakeSchema<Name, Schema>;
+export declare function isCraftHandshake(value: unknown): value is AnyCraftHandshake;
+/** Le nom d'un handshake porté par une valeur, quand il y en a un. */
+export declare function craftHandshakeName(value: unknown): string | undefined;
+export declare function assertHandshakeName(name: string): void;
+//# sourceMappingURL=craft-handshake.d.ts.map

package/src/lib/craft-handshake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-handshake.d.ts","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-handshake.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,eAAe,eAA2B,CAAC;AAExD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,kBAAkB,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM,IAAI,IAAI,GAAG;IACpE,QAAQ,CAAC,CAAC,eAAe,CAAC,EAAE,IAAI,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,oBAAoB,CAC9B,IAAI,SAAS,MAAM,GAAG,MAAM,EAC5B,MAAM,SAAS,WAAW,GAAG,WAAW,IACtC,MAAM,GAAG;IACX,QAAQ,CAAC,CAAC,eAAe,CAAC,EAAE,IAAI,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GACzB,kBAAkB,CAAC,MAAM,CAAC,GAC1B,oBAAoB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAE9C,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,KAAK,CAAC,IAAI,SAAS,MAAM,EACtD,IAAI,EAAE,IAAI,GACT,kBAAkB,CAAC,IAAI,CAAC,CAAC;AAC5B,2EAA2E;AAC3E,wBAAgB,cAAc,CAC5B,KAAK,CAAC,IAAI,SAAS,MAAM,EACzB,MAAM,SAAS,WAAW,EAC1B,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAiBlE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAM3E;AAED,sEAAsE;AACtE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAMrE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAMtD"}

package/src/lib/craft-handshake.js

@@ -0,0 +1,34 @@
+export const CRAFT_HANDSHAKE = Symbol('craftHandshake');
+export function craftHandshake(name, schema) {
+    assertHandshakeName(name);
+    if (schema === undefined) {
+        // Une primitive ne porte pas de propriété : le nom reste une chaîne nue au
+        // runtime, et c'est le graphe qui prouve la présence des deux côtés. Même
+        // compromis que `craftUnique`.
+        return name;
+    }
+    Object.defineProperty(schema, CRAFT_HANDSHAKE, {
+        value: name,
+        enumerable: false,
+        configurable: false,
+    });
+    return schema;
+}
+export function isCraftHandshake(value) {
+    return (value !== null &&
+        (typeof value === 'object' || typeof value === 'function') &&
+        CRAFT_HANDSHAKE in value);
+}
+/** Le nom d'un handshake porté par une valeur, quand il y en a un. */
+export function craftHandshakeName(value) {
+    if (!isCraftHandshake(value))
+        return undefined;
+    const name = value[CRAFT_HANDSHAKE];
+    return typeof name === 'string' ? name : undefined;
+}
+export function assertHandshakeName(name) {
+    if (!/^[A-Za-z][A-Za-z0-9._:-]*$/.test(name)) {
+        throw new Error(`Invalid handshake name "${name}". Use a stable dotted identifier, the same on both sides.`);
+    }
+}
+//# sourceMappingURL=craft-handshake.js.map

package/src/lib/craft-handshake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-handshake.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/craft-handshake.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;AA2CxD,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,MAAoB;IAC/D,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,2EAA2E;QAC3E,0EAA0E;QAC1E,+BAA+B;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,eAAe,EAAE;QAC7C,KAAK,EAAE,IAAI;QACX,UAAU,EAAE,KAAK;QACjB,YAAY,EAAE,KAAK;KACpB,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,CACL,KAAK,KAAK,IAAI;QACd,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC;QAC1D,eAAe,IAAI,KAAK,CACzB,CAAC;AACJ,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/C,MAAM,IAAI,GAAI,KAAiD,CAC7D,eAAe,CAChB,CAAC;IACF,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,IAAI,CAAC,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CACb,2BAA2B,IAAI,4DAA4D,CAC5F,CAAC;IACJ,CAAC;AACH,CAAC","sourcesContent":["import type { CraftSchema } from './schema-validation';\n\nexport const CRAFT_HANDSHAKE = Symbol('craftHandshake');\n\n/**\n * Un nom sur lequel les deux côtés de la frontière se mettent d'accord.\n *\n * `craftUnique` dit « ce nom apparaît exactement une fois ». Ce n'est pas le\n * bon prédicat ici : un identifiant de server function, ou la forme d'un\n * contexte client, **doit** apparaître des deux côtés, puisque les deux\n * fichiers ne peuvent pas s'importer. `craftHandshake` dit l'inverse — « ce\n * nom a un pendant en face » — et c'est ça que la règle d'architecture vérifie.\n *\n * Déclaré une fois dans un module partagé, il est référencé par le serveur et\n * par le client. Deux conséquences :\n *\n * - la chaîne n'existe qu'à un seul endroit du dépôt, donc l'égalité des deux\n *   côtés devient une vérification TypeScript et non un rattrapage a posteriori ;\n * - quand il porte un schéma, les deux côtés partagent le **même** schéma :\n *   ils ne peuvent plus diverger.\n */\nexport type CraftHandshakeName<Name extends string = string> = Name & {\n  readonly [CRAFT_HANDSHAKE]: Name;\n};\n\nexport type CraftHandshakeSchema<\n  Name extends string = string,\n  Schema extends CraftSchema = CraftSchema,\n> = Schema & {\n  readonly [CRAFT_HANDSHAKE]: Name;\n};\n\nexport type AnyCraftHandshake =\n  | CraftHandshakeName<string>\n  | CraftHandshakeSchema<string, CraftSchema>;\n\n/** Identité partagée : l'id d'une server function, nommé une seule fois. */\nexport function craftHandshake<const Name extends string>(\n  name: Name,\n): CraftHandshakeName<Name>;\n/** Forme partagée : un schéma de contexte client, écrit une seule fois. */\nexport function craftHandshake<\n  const Name extends string,\n  Schema extends CraftSchema,\n>(name: Name, schema: Schema): CraftHandshakeSchema<Name, Schema>;\nexport function craftHandshake(name: string, schema?: CraftSchema): unknown {\n  assertHandshakeName(name);\n  if (schema === undefined) {\n    // Une primitive ne porte pas de propriété : le nom reste une chaîne nue au\n    // runtime, et c'est le graphe qui prouve la présence des deux côtés. Même\n    // compromis que `craftUnique`.\n    return name;\n  }\n  Object.defineProperty(schema, CRAFT_HANDSHAKE, {\n    value: name,\n    enumerable: false,\n    configurable: false,\n  });\n  return schema;\n}\n\nexport function isCraftHandshake(value: unknown): value is AnyCraftHandshake {\n  return (\n    value !== null &&\n    (typeof value === 'object' || typeof value === 'function') &&\n    CRAFT_HANDSHAKE in value\n  );\n}\n\n/** Le nom d'un handshake porté par une valeur, quand il y en a un. */\nexport function craftHandshakeName(value: unknown): string | undefined {\n  if (!isCraftHandshake(value)) return undefined;\n  const name = (value as { readonly [CRAFT_HANDSHAKE]: unknown })[\n    CRAFT_HANDSHAKE\n  ];\n  return typeof name === 'string' ? name : undefined;\n}\n\nexport function assertHandshakeName(name: string): void {\n  if (!/^[A-Za-z][A-Za-z0-9._:-]*$/.test(name)) {\n    throw new Error(\n      `Invalid handshake name \"${name}\". Use a stable dotted identifier, the same on both sides.`,\n    );\n  }\n}\n"]}

package/src/lib/craft-http-client.d.ts

@@ -0,0 +1,236 @@
+import { type AnyCraftException, type CraftExceptionResult } from './craft-exception';
+import { type ServiceTrackingMetadata, type ServiceYieldRequest } from './craft-service';
+import type { CraftDecoder } from './craft-codec';
+declare const CRAFT_HTTP_CLIENT_SUCCESS_MARKER: unique symbol;
+declare const CRAFT_HTTP_CLIENT_EXCEPTIONS_MARKER: unique symbol;
+declare const CRAFT_HTTP_CLIENT_EXCEPTION_TYPE_DEPENDENCIES_MARKER: unique symbol;
+declare const CRAFT_HTTP_CLIENT_EXCEPTION_BODY_TYPE_MARKER: unique symbol;
+declare const CRAFT_HTTP_CLIENT_EXCEPTION_DEPENDENCIES_MARKER: unique symbol;
+declare const CRAFT_HTTP_CLIENT_EXCEPTION_DEPENDENCY_REQUEST_MARKER: unique symbol;
+export type CraftHttpClientParams = URLSearchParams | Readonly<Record<string, string | number | boolean | undefined>>;
+export type CraftHttpClientJsonOptions = {
+    headers?: Readonly<Record<string, string>>;
+    params?: CraftHttpClientParams;
+    signal?: AbortSignal;
+    timeout?: number;
+};
+export type CraftHttpClientJsonRequestOptions<Payload = unknown> = CraftHttpClientJsonOptions & {
+    payload?: Payload | null;
+};
+export type CraftHttpClientErrorResponse = {
+    error: unknown;
+    headers: Headers;
+    status: number;
+    statusText: string;
+    url: string;
+};
+export type CraftHttpClientErrorPayload = {
+    error: CraftHttpClientErrorResponse;
+    method: string;
+    url: string;
+};
+export type CraftHttpClientError = CraftExceptionResult<{
+    _tag: 'HttpError';
+    scope: 'HttpClient';
+    identifier?: string;
+}, CraftHttpClientErrorPayload>;
+export type CraftHttpResponseDecodeErrorPayload = {
+    method: string;
+    url: string;
+    response: unknown;
+    error: unknown;
+    issues?: unknown;
+};
+export type HttpResponseDecodeError = CraftExceptionResult<{
+    _tag: 'HttpResponseDecodeError';
+    scope: 'HttpClient';
+    identifier?: string;
+}, CraftHttpResponseDecodeErrorPayload>;
+type CraftHttpClientExceptionDependencyMode = 'read' | 'match';
+export type CraftHttpClientBodyExceptionDependency<Body = unknown> = {
+    source: 'body';
+    mode: 'read';
+    readonly [CRAFT_HTTP_CLIENT_EXCEPTION_BODY_TYPE_MARKER]?: Body;
+};
+export type CraftHttpClientExceptionDependency = {
+    source: 'status';
+    mode: CraftHttpClientExceptionDependencyMode;
+    expected?: number;
+} | {
+    source: 'code';
+    mode: CraftHttpClientExceptionDependencyMode;
+    expected?: unknown;
+} | {
+    source: 'content';
+    mode: CraftHttpClientExceptionDependencyMode;
+    expected?: string;
+} | CraftHttpClientBodyExceptionDependency | {
+    source: 'header';
+    mode: CraftHttpClientExceptionDependencyMode;
+    name: string;
+    expected?: string;
+};
+export type CraftHttpClientExceptionRuleDependencies = {
+    ruleIndex: number;
+    dependencies: readonly CraftHttpClientExceptionDependency[];
+};
+type CraftHttpClientExceptionDependencies = readonly CraftHttpClientExceptionRuleDependencies[];
+type CraftHttpClientExceptionDependenciesMetadata = {
+    value?: CraftHttpClientExceptionDependencies;
+    resolve: () => CraftHttpClientExceptionDependencies;
+};
+type CraftHttpClientExceptionDependencyRequest<Dependency extends CraftHttpClientExceptionDependency = CraftHttpClientExceptionDependency, Result = unknown> = Readonly<{
+    [CRAFT_HTTP_CLIENT_EXCEPTION_DEPENDENCY_REQUEST_MARKER]: true;
+    dependency: Dependency;
+    evaluate: (error: CraftHttpClientErrorResponse) => Result;
+    preview: () => Result;
+}>;
+type CraftHttpClientStatusExceptionHelper = {
+    (): Generator<CraftHttpClientExceptionDependencyRequest<{
+        source: 'status';
+        mode: 'read';
+    }, number>, number, unknown>;
+    <const Expected extends number>(expected: Expected): Generator<CraftHttpClientExceptionDependencyRequest<{
+        source: 'status';
+        mode: 'match';
+        expected: Expected;
+    }, Expected | undefined>, Expected | undefined, unknown>;
+};
+type CraftHttpClientCodeExceptionHelper = {
+    (): Generator<CraftHttpClientExceptionDependencyRequest<{
+        source: 'code';
+        mode: 'read';
+    }, unknown>, unknown, unknown>;
+    <const Expected>(expected: Expected): Generator<CraftHttpClientExceptionDependencyRequest<{
+        source: 'code';
+        mode: 'match';
+        expected: Expected;
+    }, Expected | undefined>, Expected | undefined, unknown>;
+};
+type CraftHttpClientContentExceptionHelper = {
+    (): Generator<CraftHttpClientExceptionDependencyRequest<{
+        source: 'content';
+        mode: 'read';
+    }, string | undefined>, string | undefined, unknown>;
+    <const Expected extends string>(expected: Expected): Generator<CraftHttpClientExceptionDependencyRequest<{
+        source: 'content';
+        mode: 'match';
+        expected: Expected;
+    }, Expected | undefined>, Expected | undefined, unknown>;
+};
+type CraftHttpClientHeaderExceptionHelper = {
+    <const HeaderName extends string>(name: HeaderName): Generator<CraftHttpClientExceptionDependencyRequest<{
+        source: 'header';
+        mode: 'read';
+        name: HeaderName;
+    }, string | undefined>, string | undefined, unknown>;
+    <const HeaderName extends string, const Expected extends string>(name: HeaderName, expected: Expected): Generator<CraftHttpClientExceptionDependencyRequest<{
+        source: 'header';
+        mode: 'match';
+        name: HeaderName;
+        expected: Expected;
+    }, Expected | undefined>, Expected | undefined, unknown>;
+};
+type CraftHttpClientExceptionRuleHelpers = Readonly<{
+    status: CraftHttpClientStatusExceptionHelper;
+    code: CraftHttpClientCodeExceptionHelper;
+    content: CraftHttpClientContentExceptionHelper;
+    body: <Body = unknown>() => Generator<CraftHttpClientExceptionDependencyRequest<CraftHttpClientBodyExceptionDependency<Body>, Body>, Body, unknown>;
+    header: CraftHttpClientHeaderExceptionHelper;
+}>;
+export type CraftHttpClientExceptionRule<CustomException extends AnyCraftException = AnyCraftException> = (helpers: CraftHttpClientExceptionRuleHelpers) => Generator<CraftHttpClientExceptionDependencyRequest<any, unknown>, CustomException | undefined | void, unknown>;
+type AttachCraftHttpClientExceptionDependencies<Exception, Dependencies> = Exception extends AnyCraftException ? Exception & {
+    readonly [CRAFT_HTTP_CLIENT_EXCEPTION_TYPE_DEPENDENCIES_MARKER]?: Dependencies;
+} : never;
+export type ExtractCraftHttpClientExceptionDependencies<Exception> = Exception extends {
+    readonly [CRAFT_HTTP_CLIENT_EXCEPTION_TYPE_DEPENDENCIES_MARKER]?: infer Dependencies;
+} ? Dependencies : never;
+export type ExtractCraftHttpClientExceptionBodyTypeFromDependency<Dependency> = Dependency extends {
+    readonly [CRAFT_HTTP_CLIENT_EXCEPTION_BODY_TYPE_MARKER]?: infer Body;
+} ? Body : never;
+export type ExtractCraftHttpClientExceptionBodyType<Exception> = ExtractCraftHttpClientExceptionBodyTypeFromDependency<Extract<ExtractCraftHttpClientExceptionDependencies<Exception>, {
+    source: 'body';
+}>>;
+type CraftHttpClientSuccessToken<Success> = {
+    readonly [CRAFT_HTTP_CLIENT_SUCCESS_MARKER]?: Success;
+};
+type CraftHttpClientDecodedSuccessToken<Success> = CraftHttpClientSuccessToken<Success> & {
+    readonly decoder: CraftDecoder<Success>;
+};
+type CraftHttpClientBaseConfig = Omit<CraftHttpClientJsonOptions, 'params'> & {
+    url: string;
+    params?: CraftHttpClientParams;
+    success: CraftHttpClientSuccessToken<unknown>;
+    exceptions?: readonly CraftHttpClientExceptionRule[];
+};
+type CraftHttpClientBodyConfig = CraftHttpClientBaseConfig & {
+    payload: unknown | null;
+};
+type CraftHttpClientRequestConfig = CraftHttpClientBaseConfig & {
+    method: string;
+    payload?: unknown | null;
+};
+type ExtractCraftHttpClientUrl<Config> = Config extends {
+    url: infer Url extends string;
+} ? Url : never;
+type ExtractCraftHttpClientMethod<Config> = Config extends {
+    method: infer Method extends string;
+} ? Method : never;
+type ExtractCraftHttpClientSuccess<Config> = Config extends {
+    success: CraftHttpClientSuccessToken<infer Success>;
+} ? Success : never;
+type ExtractCraftHttpClientResponseDecodeError<Config> = Config extends {
+    success: {
+        readonly decoder: CraftDecoder<any>;
+    };
+} ? HttpResponseDecodeError : never;
+type ExtractCraftHttpClientParams<Config> = Config extends {
+    params: infer Params;
+} ? Params : undefined;
+type ExtractCraftHttpClientPayload<Config> = Config extends {
+    payload: infer Payload;
+} ? Payload : undefined;
+type ExtractCraftHttpClientExceptionDependenciesFromYielded<Yielded> = Yielded extends CraftHttpClientExceptionDependencyRequest<infer Dependency, any> ? Dependency : never;
+type ExtractCraftHttpClientExceptionFromRule<Rule> = Rule extends (...args: any[]) => Generator<infer Yielded, infer CustomException, unknown> ? AttachCraftHttpClientExceptionDependencies<Extract<Exclude<CustomException, undefined | void>, AnyCraftException>, ExtractCraftHttpClientExceptionDependenciesFromYielded<Yielded>> : never;
+type ExtractCraftHttpClientExceptions<Config> = Config extends {
+    exceptions: ReadonlyArray<infer Rule>;
+} ? ExtractCraftHttpClientExceptionFromRule<Rule> : never;
+export type CraftHttpClientResolved<Success, CustomException extends AnyCraftException = never, ResponseDecodeException extends AnyCraftException = never> = Success | CustomException | ResponseDecodeException | CraftHttpClientError;
+export type CraftHttpClientResult<Success, CustomException extends AnyCraftException = never, ResponseDecodeException extends AnyCraftException = never> = Promise<CraftHttpClientResolved<Success, CustomException, ResponseDecodeException>>;
+export type CraftHttpRequest<Method extends string = string, Url extends string = string, Success = unknown, Params = undefined, Payload = undefined, CustomException extends AnyCraftException = never, ResponseDecodeException extends AnyCraftException = never> = (() => CraftHttpClientResult<Success, CustomException, ResponseDecodeException>) & Promise<CraftHttpClientResolved<Success, CustomException, ResponseDecodeException>> & {
+    readonly method: Method;
+    readonly url: Url;
+    readonly params: Params;
+    readonly payload: Payload;
+    readonly [CRAFT_HTTP_CLIENT_SUCCESS_MARKER]?: Success;
+    readonly [CRAFT_HTTP_CLIENT_EXCEPTIONS_MARKER]?: CustomException;
+    readonly [CRAFT_HTTP_CLIENT_EXCEPTION_DEPENDENCIES_MARKER]?: CraftHttpClientExceptionDependenciesMetadata;
+};
+type AnyCraftHttpRequest = CraftHttpRequest<string, string, unknown, unknown, unknown, AnyCraftException>;
+type CraftHttpTrackedRequest<Request extends AnyCraftHttpRequest> = ServiceYieldRequest<'global', Request, ServiceTrackingMetadata<'CraftHttpClient', 'global', Request, never, {
+    derivedPropertiesUsed: {
+        $self: Request;
+    };
+    derivedPropertiesExposed: {
+        $self: Request;
+    };
+}, never, true>>;
+type CraftHttpRequestFromConfig<Method extends string, Config extends CraftHttpClientBaseConfig> = CraftHttpRequest<Method, ExtractCraftHttpClientUrl<Config>, ExtractCraftHttpClientSuccess<Config>, ExtractCraftHttpClientParams<Config>, ExtractCraftHttpClientPayload<Config>, ExtractCraftHttpClientExceptions<Config>, ExtractCraftHttpClientResponseDecodeError<Config>>;
+type CraftHttpRequestFromRequestConfig<Config extends CraftHttpClientRequestConfig> = CraftHttpRequest<Uppercase<ExtractCraftHttpClientMethod<Config>>, ExtractCraftHttpClientUrl<Config>, ExtractCraftHttpClientSuccess<Config>, ExtractCraftHttpClientParams<Config>, ExtractCraftHttpClientPayload<Config>, ExtractCraftHttpClientExceptions<Config>, ExtractCraftHttpClientResponseDecodeError<Config>>;
+type CraftHttpClientBuilderHelpers = {
+    response: typeof response;
+};
+type CraftHttpClientDsl = {
+    get: <const Config extends CraftHttpClientBaseConfig>(build: (helpers: CraftHttpClientBuilderHelpers) => Config) => Generator<CraftHttpTrackedRequest<CraftHttpRequestFromConfig<'GET', Config>>, CraftHttpRequestFromConfig<'GET', Config>, unknown>;
+    delete: <const Config extends CraftHttpClientBaseConfig>(build: (helpers: CraftHttpClientBuilderHelpers) => Config) => Generator<CraftHttpTrackedRequest<CraftHttpRequestFromConfig<'DELETE', Config>>, CraftHttpRequestFromConfig<'DELETE', Config>, unknown>;
+    post: <const Config extends CraftHttpClientBodyConfig>(build: (helpers: CraftHttpClientBuilderHelpers) => Config) => Generator<CraftHttpTrackedRequest<CraftHttpRequestFromConfig<'POST', Config>>, CraftHttpRequestFromConfig<'POST', Config>, unknown>;
+    put: <const Config extends CraftHttpClientBodyConfig>(build: (helpers: CraftHttpClientBuilderHelpers) => Config) => Generator<CraftHttpTrackedRequest<CraftHttpRequestFromConfig<'PUT', Config>>, CraftHttpRequestFromConfig<'PUT', Config>, unknown>;
+    patch: <const Config extends CraftHttpClientBodyConfig>(build: (helpers: CraftHttpClientBuilderHelpers) => Config) => Generator<CraftHttpTrackedRequest<CraftHttpRequestFromConfig<'PATCH', Config>>, CraftHttpRequestFromConfig<'PATCH', Config>, unknown>;
+    request: <const Config extends CraftHttpClientRequestConfig>(build: (helpers: CraftHttpClientBuilderHelpers) => Config) => Generator<CraftHttpTrackedRequest<CraftHttpRequestFromRequestConfig<Config>>, CraftHttpRequestFromRequestConfig<Config>, unknown>;
+};
+export declare const CraftHttpClient: CraftHttpClientDsl;
+export declare function response<Success>(): CraftHttpClientSuccessToken<Success>;
+export declare function response<Success>(decoder: CraftDecoder<Success>): CraftHttpClientDecodedSuccessToken<Success>;
+export declare function getCraftHttpRequestExceptionDependencies(request: AnyCraftHttpRequest): CraftHttpClientExceptionDependencies;
+export {};
+//# sourceMappingURL=craft-http-client.d.ts.map

package/src/lib/craft-http-client.d.ts.map

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