@craft-ts/core 0.7.0-beta.13

package/src/lib/server.js

@@ -0,0 +1,266 @@
+import { requiresClientContext, } from './server-function';
+import { craftHandshakeName } from './craft-handshake';
+export class ServerFunctionInputError extends Error {
+    code = 'CRAFT_SERVER_FUNCTION_INPUT_INVALID';
+    id;
+    issues;
+    constructor(id, issues) {
+        super(`CRAFT_SERVER_FUNCTION_INPUT_INVALID: Invalid input for server function "${id}": ${issues
+            .map((issue) => issue.message)
+            .join(', ')}`);
+        this.id = id;
+        this.issues = issues;
+        this.name = 'ServerFunctionInputError';
+    }
+}
+/**
+ * Contexte client refusé. Distinct de `ServerFunctionInputError` à dessein :
+ * dans les journaux, une donnée métier invalide et un contexte navigateur
+ * invalide ne racontent pas la même histoire.
+ */
+export class ServerFunctionClientContextError extends Error {
+    code = 'CRAFT_SERVER_FUNCTION_CLIENT_CONTEXT_INVALID';
+    id;
+    issues;
+    constructor(id, issues) {
+        super(`CRAFT_SERVER_FUNCTION_CLIENT_CONTEXT_INVALID: Invalid client context for server function "${id}": ${issues
+            .map((issue) => issue.message)
+            .join(', ')}`);
+        this.id = id;
+        this.issues = issues;
+        this.name = 'ServerFunctionClientContextError';
+    }
+}
+export class ServerFunctionProtocolError extends Error {
+    code = 'CRAFT_SERVER_FUNCTION_PROTOCOL_UNSUPPORTED';
+    constructor(version) {
+        super(`CRAFT_SERVER_FUNCTION_PROTOCOL_UNSUPPORTED: unsupported server function protocol version ${JSON.stringify(version)}. This registry speaks version 1 (and the version-less legacy format).`);
+        this.name = 'ServerFunctionProtocolError';
+    }
+}
+export class ServerFunctionPermissionError extends Error {
+    code = 'CRAFT_SERVER_FUNCTION_PERMISSION_DENIED';
+    id;
+    permission;
+    constructor(id, permission, reason) {
+        super(`CRAFT_SERVER_FUNCTION_PERMISSION_DENIED: Server function "${id}" requires permission "${permission}": ${reason}`);
+        this.id = id;
+        this.permission = permission;
+        this.name = 'ServerFunctionPermissionError';
+    }
+}
+export class ServerFunctionOutputError extends Error {
+    code = 'CRAFT_SERVER_FUNCTION_OUTPUT_INVALID';
+    id;
+    issues;
+    constructor(id, issues) {
+        super(`CRAFT_SERVER_FUNCTION_OUTPUT_INVALID: Invalid output for server function "${id}": ${issues
+            .map((issue) => issue.message)
+            .join(', ')}`);
+        this.id = id;
+        this.issues = issues;
+        this.name = 'ServerFunctionOutputError';
+    }
+}
+export function createServer(options) {
+    const byId = new Map();
+    for (const definition of options.functions) {
+        if (byId.has(definition.contract.id)) {
+            throw new Error(`Duplicate server function id "${definition.contract.id}" in server registry.`);
+        }
+        byId.set(definition.contract.id, definition);
+    }
+    const invoke = async (id, input, clientContext) => {
+        const definition = byId.get(id);
+        if (!definition) {
+            throw new Error(`Server function "${id}" is not registered.`);
+        }
+        await checkServerFunctionPermissions(definition, options.checkPermission);
+        const invoked = definition.invoke(await parseServerFunctionInput(definition, input), options.runtime, await parseServerFunctionClientContext(definition, clientContext));
+        // Portable definitions keep their opaque program intact until the adapter
+        // sees it. Legacy definitions retain the historical behaviour where a
+        // Promise returned by the handler is awaited before execute(value).
+        const program = definition.programMode === 'portable' ? invoked : await invoked;
+        const executed = options.execute
+            ? await options.execute(program)
+            : await program;
+        return parseServerFunctionOutput(definition.contract, executed);
+    };
+    return {
+        functions: options.functions,
+        invoke,
+        async handle(request) {
+            if (request.method !== 'POST') {
+                return new Response('Method Not Allowed', { status: 405 });
+            }
+            const body = (await request.json());
+            if (!isRecord(body) || typeof body['id'] !== 'string') {
+                return new Response('Invalid server function request', { status: 400 });
+            }
+            try {
+                assertSupportedProtocol(body['protocolVersion']);
+                const result = await invoke(body['id'], body['input'], body['context']);
+                return Response.json(result);
+            }
+            catch (error) {
+                if (error instanceof ServerFunctionPermissionError) {
+                    return Response.json({ error: { message: error.message } }, { status: 403 });
+                }
+                if (error instanceof ServerFunctionInputError ||
+                    error instanceof ServerFunctionClientContextError) {
+                    return Response.json({ error: { message: error.message, issues: error.issues } }, { status: 400 });
+                }
+                if (error instanceof ServerFunctionProtocolError) {
+                    return Response.json({ error: { message: error.message } }, { status: 400 });
+                }
+                const failure = toServerFunctionFailure(error);
+                if (failure) {
+                    return Response.json({ error: failure }, { status: serverFunctionFailureStatus(failure) });
+                }
+                return Response.json({
+                    error: {
+                        message: error instanceof Error ? error.message : String(error),
+                    },
+                }, { status: 500 });
+            }
+        },
+    };
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+async function checkServerFunctionPermissions(definition, checkPermission) {
+    const id = definition.contract.id;
+    for (const pipe of definition.pipes) {
+        if (pipe.kind !== 'server-permission' || !pipe.permission)
+            continue;
+        if (!checkPermission) {
+            throw new ServerFunctionPermissionError(id, pipe.permission, 'no permission checker is configured on the server registry.');
+        }
+        if (!(await checkPermission(pipe.permission, { id }))) {
+            throw new ServerFunctionPermissionError(id, pipe.permission, 'denied.');
+        }
+    }
+}
+/**
+ * Standard Schema ne sait pas fusionner deux schémas : on valide donc l'input
+ * brut avec chacun d'eux, puis on fusionne les sorties. Un schéma de middleware
+ * doit par conséquent ignorer les clés en trop, ce qui est le comportement par
+ * défaut d'un `Schema.Struct`.
+ */
+async function parseServerFunctionInput(definition, input) {
+    const contract = definition.contract;
+    const schemas = definition.inputSchemas ?? [
+        contract.input,
+    ];
+    if (schemas.length === 1) {
+        return validateInputSchema(contract.id, schemas[0], input);
+    }
+    const merged = {};
+    for (const schema of schemas) {
+        const value = await validateInputSchema(contract.id, schema, input);
+        if (!isRecord(value)) {
+            throw new Error(`CRAFT_SERVER_FUNCTION_INPUT_NOT_MERGEABLE: Server function "${contract.id}" combines several input schemas, so each one must produce an object.`);
+        }
+        Object.assign(merged, value);
+    }
+    return merged;
+}
+async function validateInputSchema(id, schema, input) {
+    const result = await schema['~standard'].validate(input);
+    if (result.issues) {
+        throw new ServerFunctionInputError(id, result.issues);
+    }
+    return result.value;
+}
+function assertSupportedProtocol(version) {
+    if (version === undefined || version === 1)
+        return;
+    throw new ServerFunctionProtocolError(version);
+}
+/**
+ * Valide le contexte envoyé par le navigateur.
+ *
+ * Deux canaux, tous deux issus du client et tous deux traités comme non
+ * fiables : le schéma `clientContext` du contrat (ce que la chaîne de
+ * middleware client publie), et les valeurs de chaque `requireClientDI(...)`.
+ * Rien n'est fusionné dans le contexte de confiance produit par les middleware
+ * serveur : le résultat vit dans son propre champ, `clientContext`.
+ */
+async function parseServerFunctionClientContext(definition, raw) {
+    if (!requiresClientContext(definition))
+        return undefined;
+    const id = definition.contract.id;
+    if (raw === undefined || raw === null) {
+        throw new ServerFunctionClientContextError(id, [
+            {
+                message: 'the function declares a client context but the request carried none.',
+            },
+        ]);
+    }
+    if (!isRecord(raw)) {
+        throw new ServerFunctionClientContextError(id, [
+            { message: 'the client context must be an object.' },
+        ]);
+    }
+    const validated = {};
+    for (const schema of definition.clientContextSchemas ?? []) {
+        const result = await schema['~standard'].validate(raw);
+        if (result.issues) {
+            // Nommer le handshake fautif quand il y en a un : dans un journal, savoir
+            // *quel* accord n'a pas été tenu vaut mieux que la seule liste des clés.
+            const handshake = craftHandshakeName(schema);
+            throw new ServerFunctionClientContextError(id, handshake === undefined
+                ? result.issues
+                : result.issues.map((issue) => ({
+                    message: `handshake "${handshake}": ${issue.message}`,
+                })));
+        }
+        if (!isRecord(result.value)) {
+            throw new ServerFunctionClientContextError(id, [
+                { message: 'a client context schema must produce an object.' },
+            ]);
+        }
+        Object.assign(validated, result.value);
+    }
+    return validated;
+}
+/**
+ * Sérialise un échec métier tagué (`Data.TaggedError` et assimilés) en objet
+ * transportable. Effect rejette avec l'erreur elle-même, il n'y a donc pas de
+ * `Cause` à déballer ici, et le core reste sans dépendance runtime sur Effect.
+ */
+export function toServerFunctionFailure(error) {
+    if (typeof error !== 'object' || error === null)
+        return undefined;
+    const tag = error._tag;
+    if (typeof tag !== 'string')
+        return undefined;
+    const failure = { _tag: tag };
+    for (const key of Object.getOwnPropertyNames(error)) {
+        if (key === 'stack' || key === '_tag')
+            continue;
+        failure[key] = error[key];
+    }
+    return failure;
+}
+function serverFunctionFailureStatus(failure) {
+    const status = failure['status'] ??
+        (isRecord(failure['payload']) ? failure['payload']['status'] : undefined);
+    return typeof status === 'number' &&
+        Number.isInteger(status) &&
+        status >= 400 &&
+        status <= 599
+        ? status
+        : 422;
+}
+async function parseServerFunctionOutput(contract, output) {
+    if (!contract.output)
+        return output;
+    const result = await contract.output['~standard'].validate(output);
+    if (result.issues) {
+        throw new ServerFunctionOutputError(contract.id, result.issues);
+    }
+    return result.value;
+}
+//# sourceMappingURL=server.js.map

package/src/lib/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/server.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ServerFunctionContract } from './server-function-contract';\nimport {\n  requiresClientContext,\n  type ServerFunctionDefinition,\n  type ServerFunctionRuntime,\n} from './server-function';\nimport type { CraftSchema } from './schema-validation';\nimport { craftHandshakeName } from './craft-handshake';\n\nexport type ServerFunctionServerOptions = {\n  readonly runtime?: ServerFunctionRuntime;\n  readonly execute?: (value: unknown) => unknown | Promise<unknown>;\n  /**\n   * Évalue une permission déclarée par `requireServerPermission(...)`.\n   *\n   * Le registre échoue en fermeture : une server function qui déclare une\n   * permission sans que ce contrôle soit configuré est rejetée, plutôt que\n   * d'exposer silencieusement une déclaration qui ne vérifie rien.\n   */\n  readonly checkPermission?: (\n    permission: string,\n    context: { readonly id: string },\n  ) => boolean | Promise<boolean>;\n};\n\nexport class ServerFunctionInputError extends Error {\n  readonly code = 'CRAFT_SERVER_FUNCTION_INPUT_INVALID';\n  readonly id: string;\n  readonly issues: readonly { readonly message: string }[];\n\n  constructor(id: string, issues: readonly { readonly message: string }[]) {\n    super(\n      `CRAFT_SERVER_FUNCTION_INPUT_INVALID: Invalid input for server function \"${id}\": ${issues\n        .map((issue) => issue.message)\n        .join(', ')}`,\n    );\n    this.id = id;\n    this.issues = issues;\n    this.name = 'ServerFunctionInputError';\n  }\n}\n\n/**\n * Contexte client refusé. Distinct de `ServerFunctionInputError` à dessein :\n * dans les journaux, une donnée métier invalide et un contexte navigateur\n * invalide ne racontent pas la même histoire.\n */\nexport class ServerFunctionClientContextError extends Error {\n  readonly code = 'CRAFT_SERVER_FUNCTION_CLIENT_CONTEXT_INVALID';\n  readonly id: string;\n  readonly issues: readonly { readonly message: string }[];\n\n  constructor(id: string, issues: readonly { readonly message: string }[]) {\n    super(\n      `CRAFT_SERVER_FUNCTION_CLIENT_CONTEXT_INVALID: Invalid client context for server function \"${id}\": ${issues\n        .map((issue) => issue.message)\n        .join(', ')}`,\n    );\n    this.id = id;\n    this.issues = issues;\n    this.name = 'ServerFunctionClientContextError';\n  }\n}\n\nexport class ServerFunctionProtocolError extends Error {\n  readonly code = 'CRAFT_SERVER_FUNCTION_PROTOCOL_UNSUPPORTED';\n\n  constructor(version: unknown) {\n    super(\n      `CRAFT_SERVER_FUNCTION_PROTOCOL_UNSUPPORTED: unsupported server function protocol version ${JSON.stringify(version)}. This registry speaks version 1 (and the version-less legacy format).`,\n    );\n    this.name = 'ServerFunctionProtocolError';\n  }\n}\n\nexport class ServerFunctionPermissionError extends Error {\n  readonly code = 'CRAFT_SERVER_FUNCTION_PERMISSION_DENIED';\n  readonly id: string;\n  readonly permission: string;\n\n  constructor(id: string, permission: string, reason: string) {\n    super(\n      `CRAFT_SERVER_FUNCTION_PERMISSION_DENIED: Server function \"${id}\" requires permission \"${permission}\": ${reason}`,\n    );\n    this.id = id;\n    this.permission = permission;\n    this.name = 'ServerFunctionPermissionError';\n  }\n}\n\nexport class ServerFunctionOutputError extends Error {\n  readonly code = 'CRAFT_SERVER_FUNCTION_OUTPUT_INVALID';\n  readonly id: string;\n  readonly issues: readonly { readonly message: string }[];\n\n  constructor(id: string, issues: readonly { readonly message: string }[]) {\n    super(\n      `CRAFT_SERVER_FUNCTION_OUTPUT_INVALID: Invalid output for server function \"${id}\": ${issues\n        .map((issue) => issue.message)\n        .join(', ')}`,\n    );\n    this.id = id;\n    this.issues = issues;\n    this.name = 'ServerFunctionOutputError';\n  }\n}\n\nexport type Server = {\n  readonly functions: readonly ServerFunctionDefinition<any, any, any>[];\n  readonly invoke: (\n    id: string,\n    input: unknown,\n    /** Contexte brut envoyé par le navigateur, validé avant tout usage. */\n    clientContext?: unknown,\n  ) => Promise<unknown>;\n  readonly handle: (request: Request) => Promise<Response>;\n};\n\nexport function createServer(\n  options: ServerFunctionServerOptions & {\n    readonly functions: readonly ServerFunctionDefinition<any, any, any>[];\n  },\n): Server {\n  const byId = new Map<string, ServerFunctionDefinition<any, any, any>>();\n  for (const definition of options.functions) {\n    if (byId.has(definition.contract.id)) {\n      throw new Error(\n        `Duplicate server function id \"${definition.contract.id}\" in server registry.`,\n      );\n    }\n    byId.set(definition.contract.id, definition);\n  }\n\n  const invoke = async (\n    id: string,\n    input: unknown,\n    clientContext?: unknown,\n  ): Promise<unknown> => {\n    const definition = byId.get(id);\n    if (!definition) {\n      throw new Error(`Server function \"${id}\" is not registered.`);\n    }\n    await checkServerFunctionPermissions(definition, options.checkPermission);\n    const invoked = definition.invoke(\n      await parseServerFunctionInput(definition, input),\n      options.runtime,\n      await parseServerFunctionClientContext(definition, clientContext),\n    );\n    // Portable definitions keep their opaque program intact until the adapter\n    // sees it. Legacy definitions retain the historical behaviour where a\n    // Promise returned by the handler is awaited before execute(value).\n    const program =\n      definition.programMode === 'portable' ? invoked : await invoked;\n    const executed = options.execute\n      ? await options.execute(program)\n      : await program;\n    return parseServerFunctionOutput(definition.contract, executed);\n  };\n\n  return {\n    functions: options.functions,\n    invoke,\n    async handle(request) {\n      if (request.method !== 'POST') {\n        return new Response('Method Not Allowed', { status: 405 });\n      }\n      const body = (await request.json()) as unknown;\n      if (!isRecord(body) || typeof body['id'] !== 'string') {\n        return new Response('Invalid server function request', { status: 400 });\n      }\n      try {\n        assertSupportedProtocol(body['protocolVersion']);\n        const result = await invoke(\n          body['id'] as string,\n          body['input'],\n          body['context'],\n        );\n        return Response.json(result);\n      } catch (error) {\n        if (error instanceof ServerFunctionPermissionError) {\n          return Response.json(\n            { error: { message: error.message } },\n            { status: 403 },\n          );\n        }\n        if (\n          error instanceof ServerFunctionInputError ||\n          error instanceof ServerFunctionClientContextError\n        ) {\n          return Response.json(\n            { error: { message: error.message, issues: error.issues } },\n            { status: 400 },\n          );\n        }\n        if (error instanceof ServerFunctionProtocolError) {\n          return Response.json(\n            { error: { message: error.message } },\n            { status: 400 },\n          );\n        }\n        const failure = toServerFunctionFailure(error);\n        if (failure) {\n          return Response.json(\n            { error: failure },\n            { status: serverFunctionFailureStatus(failure) },\n          );\n        }\n        return Response.json(\n          {\n            error: {\n              message: error instanceof Error ? error.message : String(error),\n            },\n          },\n          { status: 500 },\n        );\n      }\n    },\n  };\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n\nexport type { ServerFunctionContract };\n\nasync function checkServerFunctionPermissions(\n  definition: ServerFunctionDefinition<any, any, any, any>,\n  checkPermission: ServerFunctionServerOptions['checkPermission'],\n): Promise<void> {\n  const id = definition.contract.id as string;\n  for (const pipe of definition.pipes as readonly {\n    kind?: string;\n    permission?: string;\n  }[]) {\n    if (pipe.kind !== 'server-permission' || !pipe.permission) continue;\n    if (!checkPermission) {\n      throw new ServerFunctionPermissionError(\n        id,\n        pipe.permission,\n        'no permission checker is configured on the server registry.',\n      );\n    }\n    if (!(await checkPermission(pipe.permission, { id }))) {\n      throw new ServerFunctionPermissionError(id, pipe.permission, 'denied.');\n    }\n  }\n}\n\n/**\n * Standard Schema ne sait pas fusionner deux schémas : on valide donc l'input\n * brut avec chacun d'eux, puis on fusionne les sorties. Un schéma de middleware\n * doit par conséquent ignorer les clés en trop, ce qui est le comportement par\n * défaut d'un `Schema.Struct`.\n */\nasync function parseServerFunctionInput(\n  definition: ServerFunctionDefinition<any, any, any, any>,\n  input: unknown,\n): Promise<unknown> {\n  const contract = definition.contract as ServerFunctionContract;\n  const schemas: readonly CraftSchema[] = definition.inputSchemas ?? [\n    contract.input,\n  ];\n  if (schemas.length === 1) {\n    return validateInputSchema(contract.id, schemas[0], input);\n  }\n\n  const merged: Record<string, unknown> = {};\n  for (const schema of schemas) {\n    const value = await validateInputSchema(contract.id, schema, input);\n    if (!isRecord(value)) {\n      throw new Error(\n        `CRAFT_SERVER_FUNCTION_INPUT_NOT_MERGEABLE: Server function \"${contract.id}\" combines several input schemas, so each one must produce an object.`,\n      );\n    }\n    Object.assign(merged, value);\n  }\n  return merged;\n}\n\nasync function validateInputSchema(\n  id: string,\n  schema: CraftSchema,\n  input: unknown,\n): Promise<unknown> {\n  const result = await schema['~standard'].validate(input);\n  if (result.issues) {\n    throw new ServerFunctionInputError(id, result.issues);\n  }\n  return result.value;\n}\n\nfunction assertSupportedProtocol(version: unknown): void {\n  if (version === undefined || version === 1) return;\n  throw new ServerFunctionProtocolError(version);\n}\n\n/**\n * Valide le contexte envoyé par le navigateur.\n *\n * Deux canaux, tous deux issus du client et tous deux traités comme non\n * fiables : le schéma `clientContext` du contrat (ce que la chaîne de\n * middleware client publie), et les valeurs de chaque `requireClientDI(...)`.\n * Rien n'est fusionné dans le contexte de confiance produit par les middleware\n * serveur : le résultat vit dans son propre champ, `clientContext`.\n */\nasync function parseServerFunctionClientContext(\n  definition: ServerFunctionDefinition<any, any, any, any>,\n  raw: unknown,\n): Promise<Record<string, unknown> | undefined> {\n  if (!requiresClientContext(definition)) return undefined;\n  const id = definition.contract.id as string;\n  if (raw === undefined || raw === null) {\n    throw new ServerFunctionClientContextError(id, [\n      {\n        message:\n          'the function declares a client context but the request carried none.',\n      },\n    ]);\n  }\n  if (!isRecord(raw)) {\n    throw new ServerFunctionClientContextError(id, [\n      { message: 'the client context must be an object.' },\n    ]);\n  }\n\n  const validated: Record<string, unknown> = {};\n  for (const schema of definition.clientContextSchemas ?? []) {\n    const result = await schema['~standard'].validate(raw);\n    if (result.issues) {\n      // Nommer le handshake fautif quand il y en a un : dans un journal, savoir\n      // *quel* accord n'a pas été tenu vaut mieux que la seule liste des clés.\n      const handshake = craftHandshakeName(schema);\n      throw new ServerFunctionClientContextError(\n        id,\n        handshake === undefined\n          ? result.issues\n          : result.issues.map((issue) => ({\n              message: `handshake \"${handshake}\": ${issue.message}`,\n            })),\n      );\n    }\n    if (!isRecord(result.value)) {\n      throw new ServerFunctionClientContextError(id, [\n        { message: 'a client context schema must produce an object.' },\n      ]);\n    }\n    Object.assign(validated, result.value);\n  }\n\n  return validated;\n}\n\nexport type ServerFunctionFailure = {\n  readonly _tag: string;\n  readonly [key: string]: unknown;\n};\n\n/**\n * Sérialise un échec métier tagué (`Data.TaggedError` et assimilés) en objet\n * transportable. Effect rejette avec l'erreur elle-même, il n'y a donc pas de\n * `Cause` à déballer ici, et le core reste sans dépendance runtime sur Effect.\n */\nexport function toServerFunctionFailure(\n  error: unknown,\n): ServerFunctionFailure | undefined {\n  if (typeof error !== 'object' || error === null) return undefined;\n  const tag = (error as { _tag?: unknown })._tag;\n  if (typeof tag !== 'string') return undefined;\n\n  const failure: Record<string, unknown> = { _tag: tag };\n  for (const key of Object.getOwnPropertyNames(error)) {\n    if (key === 'stack' || key === '_tag') continue;\n    failure[key] = (error as Record<string, unknown>)[key];\n  }\n  return failure as ServerFunctionFailure;\n}\n\nfunction serverFunctionFailureStatus(failure: ServerFunctionFailure): number {\n  const status =\n    failure['status'] ??\n    (isRecord(failure['payload']) ? failure['payload']['status'] : undefined);\n  return typeof status === 'number' &&\n    Number.isInteger(status) &&\n    status >= 400 &&\n    status <= 599\n    ? status\n    : 422;\n}\n\nasync function parseServerFunctionOutput(\n  contract: ServerFunctionContract,\n  output: unknown,\n): Promise<unknown> {\n  if (!contract.output) return output;\n  const result = await contract.output['~standard'].validate(output);\n  if (result.issues) {\n    throw new ServerFunctionOutputError(contract.id, result.issues);\n  }\n  return result.value;\n}\n"]}

package/src/lib/setup-craft-service-test.d.ts

@@ -0,0 +1,90 @@
+import { type CraftInjector, type CraftProvider } from './host/craft-injector';
+import type { BrandedServiceProvider, CraftServiceProvider, GetServiceDependencies, GetServiceReferenceOutput, ResolvedServiceOutput, ServiceBindings, ServiceMetaData, ServiceReference } from './craft-service';
+import type { CallableShell, ConcreteServiceScope, DependencyNodeScope, DependencyTreeChildren, FlattenDependencyTree, RequirementScope, RootExposureKey, Simplify } from './craft-service.shared';
+type GetServiceDependenciesTree<Target extends ServiceReference> = Target extends ServiceMetaData<any, any, any, any, infer Dependencies, any, any, any, any, any, boolean> ? Dependencies : GetServiceDependencies<Target>;
+type ServiceDependencyChildren<Target extends ServiceReference> = GetServiceDependenciesTree<Target> extends {
+    dependencies: infer Dependencies extends object;
+} ? Dependencies : {};
+type FlattenedServiceTestingDependencyTree<Target extends ServiceReference> = FlattenDependencyTree<ServiceDependencyChildren<Target>>;
+type DependencyNodeDerivedPropertiesUsed<Node> = Node extends {
+    derivedPropertiesUsed: infer Used extends object;
+} ? Used : {};
+type RequiredUsedMockImplementation<UsedProperties extends object> = Simplify<{
+    [Key in Extract<keyof UsedProperties, string>]-?: Key extends RootExposureKey ? UsedProperties[Key] extends (...args: any[]) => any ? CallableShell<UsedProperties[Key]> : never : UsedProperties[Key];
+}>;
+type MockImplementation<Output> = Simplify<(Output extends object ? Partial<{
+    [Key in Extract<keyof Output, string>]: Output[Key];
+}> : {}) & (Output extends (...args: any[]) => any ? {
+    $self?: CallableShell<Output>;
+} : {})>;
+type DerivedMockImplementationForNode<Node> = Simplify<Record<string, unknown> & RequiredUsedMockImplementation<DependencyNodeDerivedPropertiesUsed<Node>>>;
+type MockImplementationForNode<Node> = Simplify<[
+    keyof DependencyNodeDerivedPropertiesUsed<Node>
+] extends [never] ? Record<string, unknown> : DerivedMockImplementationForNode<Node>>;
+type PublicMockShape<Implementation> = Implementation extends object ? Omit<Implementation, RootExposureKey> : {};
+type MockRootCallable<Implementation> = NonNullable<Implementation> extends {
+    $self: infer Root extends (...args: any[]) => any;
+} ? CallableShell<Root> : never;
+type MockPublicValueFromImplementation<Implementation> = [
+    Implementation
+] extends [undefined] ? {} : [MockRootCallable<Implementation>] extends [never] ? PublicMockShape<NonNullable<Implementation>> : MockRootCallable<Implementation> & PublicMockShape<NonNullable<Implementation>>;
+type ImplicitMockServiceOverride<Implementation extends object> = {
+    readonly kind: 'mock';
+    readonly implementation: Implementation;
+    readonly reference?: undefined;
+};
+type ExplicitMockServiceOverride<Reference extends ServiceReference = ServiceReference, Implementation extends object = object> = {
+    readonly kind: 'mock';
+    readonly reference: Reference;
+    readonly implementation: Implementation;
+};
+type AnyMockServiceOverride = ImplicitMockServiceOverride<any> | ExplicitMockServiceOverride<any, any>;
+type OverrideForDependencyNode<Name extends string, Node> = ImplicitMockServiceOverride<MockImplementationForNode<Node>> | ExplicitMockServiceOverride<ServiceReference<Name, Extract<DependencyNodeScope<Node>, ConcreteServiceScope>>, MockImplementationForNode<Node>> | (DependencyNodeScope<Node> extends RequirementScope ? BrandedServiceProvider<Name, Extract<DependencyNodeScope<Node>, RequirementScope>> : never);
+type MissingCoverageForTree<Tree extends object, Overrides> = {
+    [Name in Extract<keyof Tree, string>]: MissingCoverageForNode<Name, Tree[Name], Overrides>;
+}[Extract<keyof Tree, string>];
+type OverrideAtPath<Overrides, Name extends string> = Name extends keyof Overrides ? NonNullable<Overrides[Name]> : never;
+type InvalidOverrideEntry<Target extends ServiceReference, Name extends string, Override> = [NonNullable<Override>] extends [never] ? never : Name extends keyof FlattenedServiceTestingDependencyTree<Target> ? NonNullable<Override> extends OverrideForDependencyNode<Name, FlattenedServiceTestingDependencyTree<Target>[Name]> ? never : Name : Name;
+type InvalidOverrideEntries<Target extends ServiceReference, Overrides> = {
+    [Name in Extract<keyof Overrides, string>]: InvalidOverrideEntry<Target, Name, Overrides[Name]>;
+}[Extract<keyof Overrides, string>];
+type AssertValidServiceTestOverrides<Target extends ServiceReference, Overrides> = [InvalidOverrideEntries<Target, Overrides>] extends [never] ? {} : {
+    ERROR_invalid_service_test_overrides: InvalidOverrideEntries<Target, Overrides>;
+};
+type MissingCoverageForNode<Name extends string, Node, Overrides> = [
+    OverrideAtPath<Overrides, Name>
+] extends [never] ? DependencyNodeScope<Node> extends RequirementScope ? Name : MissingCoverageForTree<DependencyTreeChildren<Node>, Overrides> : OverrideAtPath<Overrides, Name> extends AnyMockServiceOverride ? never : OverrideAtPath<Overrides, Name> extends BrandedServiceProvider<Name, RequirementScope> ? MissingCoverageForTree<DependencyTreeChildren<Node>, Overrides> : DependencyNodeScope<Node> extends RequirementScope ? Name : MissingCoverageForTree<DependencyTreeChildren<Node>, Overrides>;
+type AssertServiceTestCoverage<Target extends ServiceReference, Overrides> = [
+    MissingCoverageForTree<ServiceDependencyChildren<Target>, Overrides>
+] extends [never] ? {} : {
+    ERROR_missing_service_test_overrides: MissingCoverageForTree<ServiceDependencyChildren<Target>, Overrides>;
+};
+type ResolvedMockValueForNode<_Node, Override> = Override extends ImplicitMockServiceOverride<infer Implementation> ? MockPublicValueFromImplementation<Implementation> : Override extends ExplicitMockServiceOverride<any, infer Implementation> ? MockPublicValueFromImplementation<Implementation> : never;
+type ExtractMockOverride<Override> = Extract<NonNullable<Override>, AnyMockServiceOverride>;
+type CreateAngularTestMocks<Target extends ServiceReference, Overrides> = Simplify<{
+    [Name in keyof Overrides as [ExtractMockOverride<Overrides[Name]>] extends [
+        never
+    ] ? never : Name]: Name extends keyof FlattenedServiceTestingDependencyTree<Target> ? ResolvedMockValueForNode<FlattenedServiceTestingDependencyTree<Target>[Name], ExtractMockOverride<Overrides[Name]>> : never;
+}>;
+export declare function mock<Implementation extends object>(implementation: Implementation): ImplicitMockServiceOverride<Implementation>;
+export declare function mock<Reference extends ServiceReference, Implementation extends MockImplementation<GetServiceReferenceOutput<Reference>>>(reference: Reference, implementation: Implementation): ExplicitMockServiceOverride<Reference, Implementation>;
+/** Flush queued microtasks and the host effect scheduler without TestBed.tick(). */
+export declare function flushCraftTest(injector: CraftInjector): Promise<void>;
+export declare function setupCraftServiceTest(): {
+    injector: CraftInjector;
+};
+export declare function setupCraftServiceTest(options: {
+    providers: readonly CraftProvider[];
+}): {
+    injector: CraftInjector;
+};
+export declare function setupCraftServiceTest<Target extends ServiceReference, const Overrides extends Record<string, unknown>, Bindings extends ServiceBindings<Target> | undefined = undefined>(target: Target, overrides: Overrides & AssertValidServiceTestOverrides<Target, Overrides> & AssertServiceTestCoverage<Target, Overrides>, options?: {
+    bindings?: Bindings;
+    providers?: CraftServiceProvider[];
+}): {
+    sut: ResolvedServiceOutput<Target, Bindings>;
+    mocks: CreateAngularTestMocks<Target, Overrides>;
+    injector: CraftInjector;
+};
+export {};
+//# sourceMappingURL=setup-craft-service-test.d.ts.map

package/src/lib/setup-craft-service-test.d.ts.map

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

package/src/lib/setup-craft-service-test.js

@@ -0,0 +1,193 @@
+import { createEnvironmentInjector, ErrorHandler, getCraftRootDefaultProviders, inject, Injector, runInInjectionContext, ɵEffectScheduler, ɵINJECTOR_SCOPE, } from './host/craft-compat';
+import { createExposedServiceValue, getServiceMetaData, SERVICE_RUNTIME_OVERRIDES, } from './craft-service';
+import { CRAFT_SERVICE_PROVIDER_BRAND } from './craft-service.shared';
+import { ɵcraftInjectorFromHost } from './host/craft-injector-host';
+import { createCraftInjector, } from './host/craft-injector';
+import { APP_SNAPSHOT_REGISTRY, AppSnapshotRegistry } from './take-app-snapshot';
+function createMockPublicValue(implementation) {
+    return implementation === undefined
+        ? {}
+        : createExposedServiceValue(implementation);
+}
+function getProviderOverrideMeta(value) {
+    if (typeof value !== 'object' ||
+        value === null ||
+        !(CRAFT_SERVICE_PROVIDER_BRAND in value)) {
+        return undefined;
+    }
+    return Reflect.get(value, CRAFT_SERVICE_PROVIDER_BRAND);
+}
+function assertOverrideReferenceName(name, reference) {
+    const metaData = getServiceMetaData(reference);
+    if (metaData.name !== name) {
+        throw new Error(`Test override "${name}" does not match craftService/toCraftService reference "${metaData.name}".`);
+    }
+}
+function assertProviderOverrideName(name, provider) {
+    const metaData = getProviderOverrideMeta(provider);
+    if (!metaData) {
+        throw new Error(`Expected a raw provider returned by provide${name}(...).`);
+    }
+    if (metaData.name !== name) {
+        throw new Error(`Test override "${name}" does not match provider value for "${metaData.name}".`);
+    }
+}
+function isMockServiceOverride(override) {
+    return (typeof override === 'object' &&
+        override !== null &&
+        'kind' in override &&
+        override.kind === 'mock');
+}
+export function mock(referenceOrImplementation, implementation) {
+    if (implementation === undefined) {
+        return {
+            kind: 'mock',
+            implementation: referenceOrImplementation,
+        };
+    }
+    return {
+        kind: 'mock',
+        reference: referenceOrImplementation,
+        implementation: implementation,
+    };
+}
+/**
+ * Sets up a `craftService` or `toCraftService` in an isolated injector with
+ * typed dependency coverage.
+ *
+ * `setupCraftServiceTest` reads the runtime metadata attached to an inject helper
+ * or a metadata object and instantiates the target inside an isolated injection
+ * context. Its type system checks the dependency tree so required child services
+ * are either:
+ *
+ * - mocked through `mock(...)`
+ * - covered by the real raw provider returned by `provideX(...)`
+ * - or pruned by mocking one of their ancestors
+ *
+ * Global dependencies remain optional to override, but can still be mocked. For
+ * real Angular providers such as `provideRouter(...)`, use the `options.providers`
+ * array.
+ *
+ * The returned `sut` is the fully injected service output. The returned `mocks`
+ * object contains the public mock values actually injected into the test tree.
+ *
+ * @example
+ * Mock a required child service
+ * ```ts
+ * const { sut, mocks } = setupCraftServiceTest(CounterExtended, {
+ *   Counter: mock({
+ *     $self: vi.fn(() => 41),
+ *     increment: vi.fn(),
+ *   }),
+ * });
+ *
+ * sut.incrementCounter();
+ * expect(mocks.Counter.increment).toHaveBeenCalledTimes(1);
+ * ```
+ *
+ * @example
+ * Use the real router while keeping explicit Angular providers in the test setup
+ * ```ts
+ * const { sut } = setupCraftServiceTest(Navigation, {}, {
+ *   providers: [provideRouter([])],
+ * });
+ * ```
+ *
+ * @example
+ * Force explicit coverage for a manually provided dependency
+ * ```ts
+ * const { sut } = setupCraftServiceTest(Navigation, {
+ *   Router: provideAppRouter(),
+ * });
+ * ```
+ */
+function createAngularHostCraftInjector(extraProviders = []) {
+    const environmentInjector = createEnvironmentInjector([
+        ...getCraftRootDefaultProviders(),
+        { provide: ɵINJECTOR_SCOPE, useValue: 'root' },
+        { provide: ErrorHandler, useClass: ErrorHandler },
+        { provide: APP_SNAPSHOT_REGISTRY, useValue: new AppSnapshotRegistry() },
+        ...extraProviders,
+    ], Injector.NULL, 'setupCraftServiceTest');
+    return {
+        environmentInjector,
+        injector: ɵcraftInjectorFromHost(environmentInjector),
+    };
+}
+/** Flush queued microtasks and the host effect scheduler without TestBed.tick(). */
+export async function flushCraftTest(injector) {
+    const flushScheduler = () => {
+        injector.run(() => {
+            inject(ɵEffectScheduler).flush();
+        });
+    };
+    for (let index = 0; index < 5; index += 1) {
+        flushScheduler();
+        await Promise.resolve();
+    }
+    flushScheduler();
+}
+export function setupCraftServiceTest(targetOrOptions, overrides, options) {
+    if (arguments.length === 0) {
+        return {
+            injector: createAngularHostCraftInjector().injector,
+        };
+    }
+    if (arguments.length === 1) {
+        const nativeOptions = targetOrOptions;
+        return {
+            injector: createCraftInjector(nativeOptions.providers),
+        };
+    }
+    const target = targetOrOptions;
+    const internalMetaData = getServiceMetaData(target);
+    const providers = [...(options?.providers ?? [])];
+    const runtimeOverrides = new Map();
+    const mocks = {};
+    const hasExplicitTargetProvider = providers.some((provider) => getProviderOverrideMeta(provider)?.name === internalMetaData.name);
+    if (internalMetaData.providedIn === 'toProvide' ||
+        internalMetaData.providedIn === 'manuallyProvidedAtRoot') {
+        if (!('provide' in internalMetaData) ||
+            typeof internalMetaData.provide !== 'function') {
+            throw new Error(`Missing provide helper for craftService/toCraftService "${internalMetaData.name}" in setupCraftServiceTest.`);
+        }
+        if (!hasExplicitTargetProvider) {
+            if (Reflect.get(internalMetaData, 'usesProvidedInput') === true) {
+                throw new Error(`setupCraftServiceTest requires an explicit provider for "${internalMetaData.name}" because it uses $provided.`);
+            }
+            providers.push(internalMetaData.provide());
+        }
+    }
+    for (const [name, override] of Object.entries(overrides ?? {})) {
+        if (!override) {
+            continue;
+        }
+        if (!isMockServiceOverride(override)) {
+            assertProviderOverrideName(name, override);
+            providers.push(override);
+            continue;
+        }
+        if (override.reference) {
+            assertOverrideReferenceName(name, override.reference);
+        }
+        const publicValue = createMockPublicValue(override.implementation);
+        runtimeOverrides.set(name, {
+            kind: 'useValue',
+            value: publicValue,
+        });
+        mocks[name] = publicValue;
+    }
+    providers.push({
+        provide: SERVICE_RUNTIME_OVERRIDES,
+        useValue: runtimeOverrides,
+    });
+    const { environmentInjector, injector } = createAngularHostCraftInjector(providers);
+    return injector.run(() => runInInjectionContext(environmentInjector, () => ({
+        sut: options?.bindings === undefined
+            ? internalMetaData.inject()
+            : internalMetaData.inject(options.bindings),
+        mocks,
+        injector,
+    })));
+}
+//# sourceMappingURL=setup-craft-service-test.js.map