Interface IResource<TConfig, TValue, TDependencies, TContext, TMeta, TTags, TMiddleware>

interface IResource<TConfig, TValue, TDependencies, TContext, TMeta, TTags, TMiddleware> {
    [symbolFilePath]: string;
    [symbolIndexResource]: boolean;
    [symbolResource]: true;
    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;
    optional: (() => IOptionalDependency<IResource<TConfig, TValue, TDependencies, TContext, TMeta, TTags, TMiddleware>>);
    overrides: OverridableElements[];
    register: RegisterableItems<T>[] | ((config: TConfig) => RegisterableItems<T>[]);
    resultSchema?: IValidationSchema<TValue extends Promise<U>
        ? U
        : TValue>;
    tags: TTags;
    with(config: HasInputContracts<[...TTags[], ...TMiddleware[]]> extends true
        ? IsUnspecified<TConfig> extends true
            ? InferInputOrViolationFromContracts<[...TTags[], ...TMiddleware[]]>
            : TConfig
        : TConfig): IResourceWithConfig<TConfig, TValue, TDependencies, TContext, TMeta, TTags, TMiddleware>;
}

Type Parameters

Hierarchy (view full)

Properties

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

Methods

with

Properties

[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.

[symbolIndexResource]

[symbolIndexResource]: boolean

This is used internally when creating index resources.

[symbolResource]

[symbolResource]: true

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

middleware

middleware: TMiddleware

Middleware applied around init/dispose.

optional

optional: (() => IOptionalDependency<IResource<TConfig, TValue, TDependencies, TContext, TMeta, TTags, TMiddleware>>)

Return an optional dependency wrapper for this resource.

overrides

overrides: OverridableElements[]

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

register

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.

tags

tags: TTags

Methods

with

Settings

Member Visibility

On This Page

Properties
Methods