OpenParable
Skip to content
← Back to skills

Dependency Injection

Development
dependency-injection

Dependency Injection is an Agent Skill for development published in the trezor/trezor-suite repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Dependency Injection pattern for service definitions, factories, and composition roots. Use when working with packages that use the DI pattern.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/trezor/trezor-suite/blob/HEAD/skills/dependency-injection/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/dependency-injection, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Dependency injection

Some parts of the codebase use the Dependency Injection (DI) pattern. Instead of importing dependencies directly, pass them to the service as parameters. This allows better testability and separation of concerns.

Skill boundaries

Use this skill mainly for packages that directly mention this skill.

Service definition standard

The unified pattern for defining services is as follows.

Define in this order for consistency:

1: Service dependencies

Use the same key (serviceName) everywhere. This is important so Dep, Deps, and composition root wiring stay consistent.

export type ServiceNameDeps = OtherServiceDep | AnotherServiceDep;

2. Service shape:

export type ServiceParams = {
    id: string;
    // ...
};

// Usually a function, but it can also be an object with multiple methods.
export type ServiceName = (params: ServiceParams) => ServiceResult;

3. Dependency shape for other services:

export type ServiceNameDeps = {
    serviceName: ServiceName;
};

4. Service factory:

Do not repeat ServiceParams in factory ((params) only). It is inferred from ServiceName.

Service factory:

File shall be named: createServiceName.ts.

export const createServiceName =
    (deps: ServiceNameDeps): ServiceName =>
    params => {
        // params is inferred from ServiceName type
        return deps.serviceName(params);
    };

Composition root

This is the place where the tree of dependencies is created and wired together.

  • We have top-level composition roots for Desktop, Web, and Native.
  • There may be some module/package level composition roots. Think of them as simply another service factory, but the service in this case is the whole module/package.

Composition root:

// Composition root may have its own dependencies
type CompositionRootDeps = ADep;

export const createCompositionRoot = (deps: CompositionRootDeps) => {
    const otherService = createOtherService(deps);
    const serviceName = createServiceName({ otherService });

    return {
        serviceName, // expose only `serviceName`; `otherService` is module-private in this case
    };
};

React service selection

useServices accepts multiple selectors. Prefer one call with all needed selectors instead of multiple useServices calls when a component or hook needs several services.

const { serviceName, otherService } = useServices(selectServiceNameDep, selectOtherServiceDep);