Error Reference

All errors reported by NeoSyringe — in the IDE, the CLI, and at build time.

Error Codes

Code	Type	Where reported
9995	missing	Missing dependency not registered
9996	cycle	Circular dependency between services
9997	type-mismatch	Provider incompatible with token type
9998	duplicate	Token registered more than once

---

Missing Injection (9995)

A service requires a dependency that is not registered in the container.

Missing injection: 'IDatabase' required by 'UserService' is not registered in this builder nor its parents/extends

Fix: Register the missing token in the same container, a parent container, or a partial extended by this container.

export const container = defineBuilderConfig({
  injections: [
    { token: useInterface<IDatabase>(), provider: PostgresDatabase }, // ← add this
    { token: UserService }
  ]
});

---

Circular Dependency (9996)

Two or more services depend on each other, forming a cycle.

Circular dependency detected: ServiceA -> ServiceB -> ServiceA

Fix: Introduce an intermediate abstraction or restructure the dependency direction. Circular dependencies are always a design issue — there is no runtime workaround.

---

Type Mismatch (9997)

Several situations produce this error:

Provider does not implement the interface

Type mismatch: Provider 'LogService' is not assignable to token type 'IUserRepository'.

Fix: Use a provider that implements the token's interface.

---

useValue with a primitive type

useValue cannot be used with primitive type 'string'.
Use useProperty<string>(TargetClass, 'paramName') instead.

Fix: Use useProperty for string, number, and boolean values.

// ❌
{ token: useInterface<string>(), useValue: 'http://localhost' }

// ✅
const apiUrl = useProperty<string>(ApiService, 'apiUrl');
{ token: apiUrl, provider: () => 'http://localhost' }

---

useValue with a class token

useValue cannot be used with a class token. Use provider: MyClass to register a class.

Fix: Use provider instead of useValue for class tokens.

---

Async factory with lifecycle: 'transient'

Async factory for 'IDatabase' cannot use lifecycle: 'transient'.
Async factories are pre-initialized once in initialize() and must be singletons.

Fix: Remove lifecycle: 'transient' — async factories are always singleton.

// ❌
{ token: useInterface<IDatabase>(), provider: async () => createPool(), useFactory: true, lifecycle: 'transient' }

// ✅
{ token: useInterface<IDatabase>(), provider: async () => createPool(), useFactory: true }

---

Duplicate Registration (9998)

A token is registered more than once in the same scope.

Internal duplicate

Duplicate registration: 'UserService' is already registered.

Fix: Remove the duplicate, or use scoped: true if you intentionally want to override a parent token.

---

Duplicate with parent container

Duplicate registration: 'AuthService' is already registered in parent container 'legacy'.

Fix: Use scoped: true to mark the override as intentional.

{ token: AuthService, provider: NewAuthService, scoped: true }

---

Duplicate with partial (extends)

Duplicate registration: 'LoggerService' is already registered in partial 'sharedPartial'.

Fix: Remove the registration from the local container — it is already provided by the extended partial.

---

Mixed multi and non-multi for the same token

Token 'IPlugin' is registered both with and without 'multi: true'.
All registrations for a token must consistently use multi: true or not at all.

Fix: Decide whether the token is multi or single, and apply multi: true (or not) consistently to all registrations.