Skip to main content Link Search Menu Expand Document (external link)
effect

Resolver overview

Added in v1.0.0

Table of contents

requests

SqlRequest (interface)

Signature

export interface SqlRequest<T extends string, A, E> extends Request.Request<A, E | ParseError> {
  readonly _tag: T
  readonly spanLink: Tracer.SpanLink
  readonly input: unknown
}

Added in v1.0.0

resolvers

SqlResolver (interface)

Signature

export interface SqlResolver<T extends string, I, A, E, R>
  extends RequestResolver.RequestResolver<SqlRequest<T, A, E>> {
  readonly execute: (input: I) => Effect.Effect<A, E | ParseError, R>
  readonly makeExecute: (
    resolver: RequestResolver.RequestResolver<SqlRequest<T, A, E>>
  ) => (input: I) => Effect.Effect<A, E | ParseError, R>
  readonly cachePopulate: (id: I, result: A) => Effect.Effect<void, ParseError, R>
  readonly cacheInvalidate: (id: I) => Effect.Effect<void, ParseError, R>
  readonly request: (input: I) => Effect.Effect<SqlRequest<T, A, E>, ParseError, R>
}

Added in v1.0.0

findById

Create a resolver that resolves results by id.

Signature

export declare const findById: <T extends string, I, II, RI, A, IA, Row, E, RA = never, R = never>(
  tag: T,
  options:
    | {
        readonly Id: Schema.Schema<I, II, RI>
        readonly Result: Schema.Schema<A, IA>
        readonly ResultId: (result: Types.NoInfer<A>, row: Types.NoInfer<Row>) => II
        readonly execute: (requests: Types.NoInfer<II>[]) => Effect.Effect<readonly Row[], E>
        readonly withContext?: false | undefined
      }
    | {
        readonly Id: Schema.Schema<I, II, RI>
        readonly Result: Schema.Schema<A, IA, RA>
        readonly ResultId: (result: Types.NoInfer<A>, row: Types.NoInfer<Row>) => II
        readonly execute: (requests: Types.NoInfer<II>[]) => Effect.Effect<readonly Row[], E, R>
        readonly withContext: true
      }
) => Effect.Effect<SqlResolver<T, I, Option.Option<A>, E, RI>, never, RA | R>

Added in v1.0.0

grouped

Create a resolver the can return multiple results for a single request.

Results are grouped by a common key extracted from the request and result.

Signature

export declare const grouped: <T extends string, I, II, K, RI, A, IA, Row, E, RA = never, R = never>(
  tag: T,
  options:
    | {
        readonly Request: Schema.Schema<I, II, RI>
        readonly RequestGroupKey: (request: Types.NoInfer<II>) => K
        readonly Result: Schema.Schema<A, IA>
        readonly ResultGroupKey: (result: Types.NoInfer<A>, row: Types.NoInfer<Row>) => K
        readonly execute: (requests: Types.NoInfer<II>[]) => Effect.Effect<readonly Row[], E>
        readonly withContext?: false | undefined
      }
    | {
        readonly Request: Schema.Schema<I, II, RI>
        readonly RequestGroupKey: (request: Types.NoInfer<II>) => K
        readonly Result: Schema.Schema<A, IA, RA>
        readonly ResultGroupKey: (result: Types.NoInfer<A>, row: Types.NoInfer<Row>) => K
        readonly execute: (requests: Types.NoInfer<II>[]) => Effect.Effect<readonly Row[], E, R>
        readonly withContext: true
      }
) => Effect.Effect<SqlResolver<T, I, A[], E, RI>, never, RA | R>

Added in v1.0.0

ordered

Create a resolver for a sql query with a request schema and a result schema.

The request schema is used to validate the input of the query. The result schema is used to validate the output of the query.

Results are mapped to the requests in order, so the length of the results must match the length of the requests.

Signature

export declare const ordered: <T extends string, I, II, RI, A, IA, _, E, RA = never, R = never>(
  tag: T,
  options:
    | {
        readonly Request: Schema.Schema<I, II, RI>
        readonly Result: Schema.Schema<A, IA>
        readonly execute: (requests: Types.NoInfer<II>[]) => Effect.Effect<readonly _[], E>
        readonly withContext?: false | undefined
      }
    | {
        readonly Request: Schema.Schema<I, II, RI>
        readonly Result: Schema.Schema<A, IA, RA>
        readonly execute: (requests: Types.NoInfer<II>[]) => Effect.Effect<readonly _[], E, R>
        readonly withContext: true
      }
) => Effect.Effect<SqlResolver<T, I, A, E | ResultLengthMismatch, RI>, never, RA | R>

Added in v1.0.0

void

Create a resolver that performs side effects.

Signature

export declare const void: <T extends string, I, II, RI, E, R = never>(tag: T, options: { readonly Request: Schema.Schema<I, II, RI>; readonly execute: (requests: Types.NoInfer<II>[]) => Effect.Effect<readonly unknown[], E>; readonly withContext?: false | undefined; } | { readonly Request: Schema.Schema<I, II, RI>; readonly execute: (requests: Types.NoInfer<II>[]) => Effect.Effect<readonly unknown[], E, R>; readonly withContext: true; }) => Effect.Effect<SqlResolver<T, I, void, E, RI>, never, R>

Added in v1.0.0