Добавлена ДБ
This commit is contained in:
Georgiy Syralev
309
node_modules/effect/dist/esm/FiberHandle.js
generated
vendored
Normal file
309
node_modules/effect/dist/esm/FiberHandle.js
generated
vendored
Normal file
@@ -0,0 +1,309 @@
|
||||
import * as Cause from "./Cause.js";
|
||||
import * as Deferred from "./Deferred.js";
|
||||
import * as Effect from "./Effect.js";
|
||||
import * as Exit from "./Exit.js";
|
||||
import * as Fiber from "./Fiber.js";
|
||||
import * as FiberId from "./FiberId.js";
|
||||
import { constFalse, dual } from "./Function.js";
|
||||
import * as HashSet from "./HashSet.js";
|
||||
import * as Inspectable from "./Inspectable.js";
|
||||
import * as Option from "./Option.js";
|
||||
import { pipeArguments } from "./Pipeable.js";
|
||||
import * as Predicate from "./Predicate.js";
|
||||
import * as Runtime from "./Runtime.js";
|
||||
/**
|
||||
* @since 2.0.0
|
||||
* @categories type ids
|
||||
*/
|
||||
export const TypeId = /*#__PURE__*/Symbol.for("effect/FiberHandle");
|
||||
/**
|
||||
* @since 2.0.0
|
||||
* @categories refinements
|
||||
*/
|
||||
export const isFiberHandle = u => Predicate.hasProperty(u, TypeId);
|
||||
const Proto = {
|
||||
[TypeId]: TypeId,
|
||||
toString() {
|
||||
return Inspectable.format(this.toJSON());
|
||||
},
|
||||
toJSON() {
|
||||
return {
|
||||
_id: "FiberHandle",
|
||||
state: this.state
|
||||
};
|
||||
},
|
||||
[Inspectable.NodeInspectSymbol]() {
|
||||
return this.toJSON();
|
||||
},
|
||||
pipe() {
|
||||
return pipeArguments(this, arguments);
|
||||
}
|
||||
};
|
||||
const unsafeMake = deferred => {
|
||||
const self = Object.create(Proto);
|
||||
self.state = {
|
||||
_tag: "Open",
|
||||
fiber: undefined
|
||||
};
|
||||
self.deferred = deferred;
|
||||
return self;
|
||||
};
|
||||
/**
|
||||
* A FiberHandle can be used to store a single fiber.
|
||||
* When the associated Scope is closed, the contained fiber will be interrupted.
|
||||
*
|
||||
* You can add a fiber to the handle using `FiberHandle.run`, and the fiber will
|
||||
* be automatically removed from the FiberHandle when it completes.
|
||||
*
|
||||
* @example
|
||||
* ```ts
|
||||
* import { Effect, FiberHandle } from "effect"
|
||||
*
|
||||
* Effect.gen(function*() {
|
||||
* const handle = yield* FiberHandle.make()
|
||||
*
|
||||
* // run some effects
|
||||
* yield* FiberHandle.run(handle, Effect.never)
|
||||
* // this will interrupt the previous fiber
|
||||
* yield* FiberHandle.run(handle, Effect.never)
|
||||
*
|
||||
* yield* Effect.sleep(1000)
|
||||
* }).pipe(
|
||||
* Effect.scoped // The fiber will be interrupted when the scope is closed
|
||||
* )
|
||||
* ```
|
||||
*
|
||||
* @since 2.0.0
|
||||
* @categories constructors
|
||||
*/
|
||||
export const make = () => Effect.acquireRelease(Effect.map(Deferred.make(), deferred => unsafeMake(deferred)), handle => Effect.withFiberRuntime(parent => {
|
||||
const state = handle.state;
|
||||
if (state._tag === "Closed") return Effect.void;
|
||||
handle.state = {
|
||||
_tag: "Closed"
|
||||
};
|
||||
return state.fiber ? Effect.intoDeferred(Effect.asVoid(Fiber.interruptAs(state.fiber, FiberId.combine(parent.id(), internalFiberId))), handle.deferred) : Deferred.done(handle.deferred, Exit.void);
|
||||
}));
|
||||
/**
|
||||
* Create an Effect run function that is backed by a FiberHandle.
|
||||
*
|
||||
* @since 2.0.0
|
||||
* @categories constructors
|
||||
*/
|
||||
export const makeRuntime = () => Effect.flatMap(make(), self => runtime(self)());
|
||||
/**
|
||||
* Create an Effect run function that is backed by a FiberHandle.
|
||||
*
|
||||
* @since 3.13.0
|
||||
* @categories constructors
|
||||
*/
|
||||
export const makeRuntimePromise = () => Effect.flatMap(make(), self => runtimePromise(self)());
|
||||
const internalFiberIdId = -1;
|
||||
const internalFiberId = /*#__PURE__*/FiberId.make(internalFiberIdId, 0);
|
||||
const isInternalInterruption = /*#__PURE__*/Cause.reduceWithContext(undefined, {
|
||||
emptyCase: constFalse,
|
||||
failCase: constFalse,
|
||||
dieCase: constFalse,
|
||||
interruptCase: (_, fiberId) => HashSet.has(FiberId.ids(fiberId), internalFiberIdId),
|
||||
sequentialCase: (_, left, right) => left || right,
|
||||
parallelCase: (_, left, right) => left || right
|
||||
});
|
||||
/**
|
||||
* Set the fiber in a FiberHandle. When the fiber completes, it will be removed from the FiberHandle.
|
||||
* If a fiber is already running, it will be interrupted unless `options.onlyIfMissing` is set.
|
||||
*
|
||||
* @since 2.0.0
|
||||
* @categories combinators
|
||||
*/
|
||||
export const unsafeSet = /*#__PURE__*/dual(args => isFiberHandle(args[0]), (self, fiber, options) => {
|
||||
if (self.state._tag === "Closed") {
|
||||
fiber.unsafeInterruptAsFork(FiberId.combine(options?.interruptAs ?? FiberId.none, internalFiberId));
|
||||
return;
|
||||
} else if (self.state.fiber !== undefined) {
|
||||
if (options?.onlyIfMissing === true) {
|
||||
fiber.unsafeInterruptAsFork(FiberId.combine(options?.interruptAs ?? FiberId.none, internalFiberId));
|
||||
return;
|
||||
} else if (self.state.fiber === fiber) {
|
||||
return;
|
||||
}
|
||||
self.state.fiber.unsafeInterruptAsFork(FiberId.combine(options?.interruptAs ?? FiberId.none, internalFiberId));
|
||||
self.state.fiber = undefined;
|
||||
}
|
||||
self.state.fiber = fiber;
|
||||
fiber.addObserver(exit => {
|
||||
if (self.state._tag === "Open" && fiber === self.state.fiber) {
|
||||
self.state.fiber = undefined;
|
||||
}
|
||||
if (Exit.isFailure(exit) && (options?.propagateInterruption === true ? !isInternalInterruption(exit.cause) : !Cause.isInterruptedOnly(exit.cause))) {
|
||||
Deferred.unsafeDone(self.deferred, exit);
|
||||
}
|
||||
});
|
||||
});
|
||||
/**
|
||||
* Set the fiber in the FiberHandle. When the fiber completes, it will be removed from the FiberHandle.
|
||||
* If a fiber already exists in the FiberHandle, it will be interrupted unless `options.onlyIfMissing` is set.
|
||||
*
|
||||
* @since 2.0.0
|
||||
* @categories combinators
|
||||
*/
|
||||
export const set = /*#__PURE__*/dual(args => isFiberHandle(args[0]), (self, fiber, options) => Effect.fiberIdWith(fiberId => Effect.sync(() => unsafeSet(self, fiber, {
|
||||
interruptAs: fiberId,
|
||||
onlyIfMissing: options?.onlyIfMissing,
|
||||
propagateInterruption: options?.propagateInterruption
|
||||
}))));
|
||||
/**
|
||||
* Retrieve the fiber from the FiberHandle.
|
||||
*
|
||||
* @since 2.0.0
|
||||
* @categories combinators
|
||||
*/
|
||||
export const unsafeGet = self => self.state._tag === "Closed" ? Option.none() : Option.fromNullable(self.state.fiber);
|
||||
/**
|
||||
* Retrieve the fiber from the FiberHandle.
|
||||
*
|
||||
* @since 2.0.0
|
||||
* @categories combinators
|
||||
*/
|
||||
export const get = self => Effect.suspend(() => unsafeGet(self));
|
||||
/**
|
||||
* @since 2.0.0
|
||||
* @categories combinators
|
||||
*/
|
||||
export const clear = self => Effect.uninterruptibleMask(restore => Effect.withFiberRuntime(fiber => {
|
||||
if (self.state._tag === "Closed" || self.state.fiber === undefined) {
|
||||
return Effect.void;
|
||||
}
|
||||
return Effect.zipRight(restore(Fiber.interruptAs(self.state.fiber, FiberId.combine(fiber.id(), internalFiberId))), Effect.sync(() => {
|
||||
if (self.state._tag === "Open") {
|
||||
self.state.fiber = undefined;
|
||||
}
|
||||
}));
|
||||
}));
|
||||
const constInterruptedFiber = /*#__PURE__*/function () {
|
||||
let fiber = undefined;
|
||||
return () => {
|
||||
if (fiber === undefined) {
|
||||
fiber = Effect.runFork(Effect.interrupt);
|
||||
}
|
||||
return fiber;
|
||||
};
|
||||
}();
|
||||
/**
|
||||
* Run an Effect and add the forked fiber to the FiberHandle.
|
||||
* When the fiber completes, it will be removed from the FiberHandle.
|
||||
*
|
||||
* @since 2.0.0
|
||||
* @categories combinators
|
||||
*/
|
||||
export const run = function () {
|
||||
const self = arguments[0];
|
||||
if (Effect.isEffect(arguments[1])) {
|
||||
return runImpl(self, arguments[1], arguments[2]);
|
||||
}
|
||||
const options = arguments[1];
|
||||
return effect => runImpl(self, effect, options);
|
||||
};
|
||||
const runImpl = (self, effect, options) => Effect.fiberIdWith(fiberId => {
|
||||
if (self.state._tag === "Closed") {
|
||||
return Effect.interrupt;
|
||||
} else if (self.state.fiber !== undefined && options?.onlyIfMissing === true) {
|
||||
return Effect.sync(constInterruptedFiber);
|
||||
}
|
||||
return Effect.tap(Effect.forkDaemon(effect), fiber => unsafeSet(self, fiber, {
|
||||
...options,
|
||||
interruptAs: fiberId
|
||||
}));
|
||||
});
|
||||
/**
|
||||
* Capture a Runtime and use it to fork Effect's, adding the forked fibers to the FiberHandle.
|
||||
*
|
||||
* @example
|
||||
* ```ts
|
||||
* import { Context, Effect, FiberHandle } from "effect"
|
||||
*
|
||||
* interface Users {
|
||||
* readonly _: unique symbol
|
||||
* }
|
||||
* const Users = Context.GenericTag<Users, {
|
||||
* getAll: Effect.Effect<Array<unknown>>
|
||||
* }>("Users")
|
||||
*
|
||||
* Effect.gen(function*() {
|
||||
* const handle = yield* FiberHandle.make()
|
||||
* const run = yield* FiberHandle.runtime(handle)<Users>()
|
||||
*
|
||||
* // run an effect and set the fiber in the handle
|
||||
* run(Effect.andThen(Users, _ => _.getAll))
|
||||
*
|
||||
* // this will interrupt the previous fiber
|
||||
* run(Effect.andThen(Users, _ => _.getAll))
|
||||
* }).pipe(
|
||||
* Effect.scoped // The fiber will be interrupted when the scope is closed
|
||||
* )
|
||||
* ```
|
||||
*
|
||||
* @since 2.0.0
|
||||
* @categories combinators
|
||||
*/
|
||||
export const runtime = self => () => Effect.map(Effect.runtime(), runtime => {
|
||||
const runFork = Runtime.runFork(runtime);
|
||||
return (effect, options) => {
|
||||
if (self.state._tag === "Closed") {
|
||||
return constInterruptedFiber();
|
||||
} else if (self.state.fiber !== undefined && options?.onlyIfMissing === true) {
|
||||
return constInterruptedFiber();
|
||||
}
|
||||
const fiber = runFork(effect, options);
|
||||
unsafeSet(self, fiber, options);
|
||||
return fiber;
|
||||
};
|
||||
});
|
||||
/**
|
||||
* Capture a Runtime and use it to fork Effect's, adding the forked fibers to the FiberHandle.
|
||||
*
|
||||
* The returned run function will return Promise's that will resolve when the
|
||||
* fiber completes.
|
||||
*
|
||||
* @since 3.13.0
|
||||
* @categories combinators
|
||||
*/
|
||||
export const runtimePromise = self => () => Effect.map(runtime(self)(), runFork => (effect, options) => new Promise((resolve, reject) => runFork(effect, options).addObserver(exit => {
|
||||
if (Exit.isSuccess(exit)) {
|
||||
resolve(exit.value);
|
||||
} else {
|
||||
reject(Cause.squash(exit.cause));
|
||||
}
|
||||
})));
|
||||
/**
|
||||
* If any of the Fiber's in the handle terminate with a failure,
|
||||
* the returned Effect will terminate with the first failure that occurred.
|
||||
*
|
||||
* @since 2.0.0
|
||||
* @categories combinators
|
||||
* @example
|
||||
* ```ts
|
||||
* import { Effect, FiberHandle } from "effect";
|
||||
*
|
||||
* Effect.gen(function* (_) {
|
||||
* const handle = yield* _(FiberHandle.make());
|
||||
* yield* _(FiberHandle.set(handle, Effect.runFork(Effect.fail("error"))));
|
||||
*
|
||||
* // parent fiber will fail with "error"
|
||||
* yield* _(FiberHandle.join(handle));
|
||||
* });
|
||||
* ```
|
||||
*/
|
||||
export const join = self => Deferred.await(self.deferred);
|
||||
/**
|
||||
* Wait for the fiber in the FiberHandle to complete.
|
||||
*
|
||||
* @since 3.13.0
|
||||
* @categories combinators
|
||||
*/
|
||||
export const awaitEmpty = self => Effect.suspend(() => {
|
||||
if (self.state._tag === "Closed" || self.state.fiber === undefined) {
|
||||
return Effect.void;
|
||||
}
|
||||
return Fiber.await(self.state.fiber);
|
||||
});
|
||||
//# sourceMappingURL=FiberHandle.js.map
|
||||
Reference in New Issue
Block a user