Interface IResourceDefinition<TConfig, TValue, TDependencies, TContext, THooks, TRegisterableItems, TMeta, TTags, TMiddleware>

interface IResourceDefinition<TConfig, TValue, TDependencies, TContext, THooks, TRegisterableItems, TMeta, TTags, TMiddleware> {
    [symbolFilePath]?: string;
    [symbolIndexResource]?: boolean;
    configSchema?: IValidationSchema<TConfig>;
    context?: (() => TContext);
    dependencies?: TDependencies | ((config: TConfig) => TDependencies);
    dispose?: ((this: any, value: TValue extends Promise<U>
        ? U
        : TValue, config: TConfig, dependencies: ResourceDependencyValuesType<TDependencies>, context: TContext) => Promise<void>);
    id: string;
    init?: ((config: HasInputContracts<[...TTags[], ...TMiddleware[]]> extends true
        ? IsUnspecified<TConfig> extends true
            ? InferInputOrViolationFromContracts<[...TTags[], ...TMiddleware[]]>
            : EnsureInputSatisfiesContracts<[...TTags[], ...TMiddleware[]], TConfig>
        : TConfig, dependencies: ResourceDependencyValuesType<TDependencies>, context: TContext) => HasOutputContracts<[...TTags[], ...TMiddleware[]]> extends true
        ? EnsureOutputSatisfiesContracts<[...TTags[], ...TMiddleware[]], TValue>
        : TValue);
    meta?: TMeta;
    middleware?: TMiddleware;
    overrides?: OverridableElements[];
    register?: RegisterableItems<T>[] | ((config: TConfig) => RegisterableItems<T>[]);
    resultSchema?: IValidationSchema<TValue extends Promise<U>
        ? U
        : TValue>;
    tags?: TTags;
}

Type Parameters

Hierarchy (view full)

Properties

[symbolFilePath]? [symbolIndexResource]? configSchema? context? dependencies? dispose? id init? meta? middleware? overrides? register? resultSchema? tags?

Properties

Optional[symbolFilePath]

[symbolFilePath]?: string

This is optional and used from an index resource to get the correct caller. This is the reason we allow it here as well.

Optional[symbolIndexResource]

[symbolIndexResource]?: boolean

This is used internally when creating index resources.

OptionalconfigSchema

configSchema?: IValidationSchema<TConfig>

Optional validation schema for runtime config validation. When provided, resource config will be validated when .with() is called.

Optionalcontext

context?: (() => TContext)

Create a private, mutable context shared between init and dispose.

Optionaldependencies

dependencies?: TDependencies | ((config: TConfig) => TDependencies)

Static or lazy dependency map. Receives config when provided.

Optionaldispose

dispose?: ((this: any, value: TValue extends Promise<U>
    ? U
    : TValue, config: TConfig, dependencies: ResourceDependencyValuesType<TDependencies>, context: TContext) => Promise<void>)

Clean-up function for the resource. This is called when the resource is no longer needed.

Type declaration

    • (this, value, config, dependencies, context): Promise<void>

    • Parameters

      Returns Promise<void>

      Promise

id

id: string

Stable identifier.

Optionalinit

init?: ((config: HasInputContracts<[...TTags[], ...TMiddleware[]]> extends true
    ? IsUnspecified<TConfig> extends true
        ? InferInputOrViolationFromContracts<[...TTags[], ...TMiddleware[]]>
        : EnsureInputSatisfiesContracts<[...TTags[], ...TMiddleware[]], TConfig>
    : TConfig, dependencies: ResourceDependencyValuesType<TDependencies>, context: TContext) => HasOutputContracts<[...TTags[], ...TMiddleware[]]> extends true
    ? EnsureOutputSatisfiesContracts<[...TTags[], ...TMiddleware[]], TValue>
    : TValue)

Initialize and return the resource value. Called once during boot.

Optionalmeta

meta?: TMeta

Optionalmiddleware

middleware?: TMiddleware

Middleware applied around init/dispose.

Optionaloverrides

overrides?: OverridableElements[]

Safe overrides to swap behavior while preserving identities. See README: Overrides.

Optionalregister

register?: RegisterableItems<T>[] | ((config: TConfig) => RegisterableItems<T>[])

Register other registerables (resources/tasks/middleware/events). Accepts a static array or a function of config to support dynamic wiring.

OptionalresultSchema

resultSchema?: IValidationSchema<TValue extends Promise<U>
    ? U
    : TValue>

Optional validation schema for the resource's resolved value. When provided, the value will be validated immediately after init resolves, without considering middleware.

Optionaltags

tags?: TTags

Settings

Member Visibility

On This Page

Properties