QueueHyperlinkDefinition<Id, T, E, EEnqueue, R>Canonical queue declaration.
export type type QueueHyperlinkDefinition<
Id extends string,
T,
E = never,
EEnqueue = never,
R = never
> = Context.Service<
Id,
EngineQueueHandle<T, E, EEnqueue, R, void>
> &
QueueHyperlinkMetadata<Id, T, E, EEnqueue, R>
Canonical queue declaration.
QueueHyperlinkDefinition<
function (type parameter) Id in type QueueHyperlinkDefinition<Id extends string, T, E = never, EEnqueue = never, R = never>Id extends string,
function (type parameter) T in type QueueHyperlinkDefinition<Id extends string, T, E = never, EEnqueue = never, R = never>T,
function (type parameter) E in type QueueHyperlinkDefinition<Id extends string, T, E = never, EEnqueue = never, R = never>E = never,
function (type parameter) EEnqueue in type QueueHyperlinkDefinition<Id extends string, T, E = never, EEnqueue = never, R = never>EEnqueue = never,
function (type parameter) R in type QueueHyperlinkDefinition<Id extends string, T, E = never, EEnqueue = never, R = never>R = never,
> = import ContextContext.interface Service<in out Identifier, in out Shape>Context key with helper methods for working with a service.
Details
context creates a one-service Context, use and useSync retrieve the
service from the current Effect context before applying a function, and of
is a type-level helper for service values.
Example (Defining a service key)
import { Context } from "effect"
// Define an identifier for a database service
const Database = Context.Service<{ query: (sql: string) => string }>(
"Database"
)
// The key can be used to store and retrieve services
const context = Context.make(Database, { query: (sql) => `Result: ${sql}` })
Creates a Context service key.
When to use
Use when you need to define a context service key for a dependency that must
be provided by the surrounding context.
Details
Call Context.Service("Key") for a function-style key, or use the two-stage
form Context.Service<Self, Shape>()("Key") for class-style service
declarations. The returned key can be yielded as an Effect and passed to
Context.make, Context.add, and the Context getter functions.
Gotchas
The string key is the runtime identity of the service. Reusing the same key
string for unrelated services makes them occupy the same slot in a
Context.
Example (Creating service keys)
import { Context } from "effect"
// Create a simple service
const Database = Context.Service<{
query: (sql: string) => string
}>("Database")
// Create a service class
class Config extends Context.Service<Config, {
port: number
}>()("Config") {}
// Use the services to create contexts
const db = Context.make(Database, {
query: (sql) => `Result: ${sql}`
})
const config = Context.make(Config, { port: 8080 })
Namespace containing utility types for Context service keys.
Example (Extracting service types)
import { Context } from "effect"
const Database = Context.Service<{
query: (sql: string) => string
}>("Database")
// Extract service type from a key
type DatabaseService = Context.Service.Shape<typeof Database>
// Extract identifier type from a key
type DatabaseId = Context.Service.Identifier<typeof Database>
Service<function (type parameter) Id in type QueueHyperlinkDefinition<Id extends string, T, E = never, EEnqueue = never, R = never>Id, type EngineQueueHandle<
T,
E = never,
EEnqueue = never,
R = never,
A = void
> = QueueHandleApi<T, E, EEnqueue, R, A> &
QueueHandlePhantomWorkerFailures<E>
Priority queue surface for yield*able queue services (T, E, enqueue errors EEnqueue, requirements R last).
EngineQueueHandle<function (type parameter) T in type QueueHyperlinkDefinition<Id extends string, T, E = never, EEnqueue = never, R = never>T, function (type parameter) E in type QueueHyperlinkDefinition<Id extends string, T, E = never, EEnqueue = never, R = never>E, function (type parameter) EEnqueue in type QueueHyperlinkDefinition<Id extends string, T, E = never, EEnqueue = never, R = never>EEnqueue, function (type parameter) R in type QueueHyperlinkDefinition<Id extends string, T, E = never, EEnqueue = never, R = never>R>> &
interface QueueHyperlinkMetadata<Id extends string, T, E = never, EEnqueue = never, R = never>Queue declaration metadata for
QueueHyperlinkDefinition
and
QueueHyperlinkServiceDefinition
.
QueueHyperlinkMetadata<function (type parameter) Id in type QueueHyperlinkDefinition<Id extends string, T, E = never, EEnqueue = never, R = never>Id, function (type parameter) T in type QueueHyperlinkDefinition<Id extends string, T, E = never, EEnqueue = never, R = never>T, function (type parameter) E in type QueueHyperlinkDefinition<Id extends string, T, E = never, EEnqueue = never, R = never>E, function (type parameter) EEnqueue in type QueueHyperlinkDefinition<Id extends string, T, E = never, EEnqueue = never, R = never>EEnqueue, function (type parameter) R in type QueueHyperlinkDefinition<Id extends string, T, E = never, EEnqueue = never, R = never>R>;