Erster Docker-Stand

_node_modules/effect/dist/esm/FiberSet.js

@@ -0,0 +1,289 @@
+/**
+ * @since 2.0.0
+ */
+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, constVoid, dual } from "./Function.js";
+import * as HashSet from "./HashSet.js";
+import * as Inspectable from "./Inspectable.js";
+import * as Iterable from "./Iterable.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/FiberSet");
+/**
+ * @since 2.0.0
+ * @categories refinements
+ */
+export const isFiberSet = u => Predicate.hasProperty(u, TypeId);
+const Proto = {
+  [TypeId]: TypeId,
+  [Symbol.iterator]() {
+    if (this.state._tag === "Closed") {
+      return Iterable.empty();
+    }
+    return this.state.backing[Symbol.iterator]();
+  },
+  toString() {
+    return Inspectable.format(this.toJSON());
+  },
+  toJSON() {
+    return {
+      _id: "FiberMap",
+      state: this.state
+    };
+  },
+  [Inspectable.NodeInspectSymbol]() {
+    return this.toJSON();
+  },
+  pipe() {
+    return pipeArguments(this, arguments);
+  }
+};
+const unsafeMake = (backing, deferred) => {
+  const self = Object.create(Proto);
+  self.state = {
+    _tag: "Open",
+    backing
+  };
+  self.deferred = deferred;
+  return self;
+};
+/**
+ * A FiberSet can be used to store a collection of fibers.
+ * When the associated Scope is closed, all fibers in the set will be interrupted.
+ *
+ * You can add fibers to the set using `FiberSet.add` or `FiberSet.run`, and the fibers will
+ * be automatically removed from the FiberSet when they complete.
+ *
+ * @example
+ * ```ts
+ * import { Effect, FiberSet } from "effect"
+ *
+ * Effect.gen(function*() {
+ *   const set = yield* FiberSet.make()
+ *
+ *   // run some effects and add the fibers to the set
+ *   yield* FiberSet.run(set, Effect.never)
+ *   yield* FiberSet.run(set, Effect.never)
+ *
+ *   yield* Effect.sleep(1000)
+ * }).pipe(
+ *   Effect.scoped // The fibers 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(new Set(), deferred)), set => Effect.withFiberRuntime(parent => {
+  const state = set.state;
+  if (state._tag === "Closed") return Effect.void;
+  set.state = {
+    _tag: "Closed"
+  };
+  const fibers = state.backing;
+  return Fiber.interruptAllAs(fibers, FiberId.combine(parent.id(), internalFiberId)).pipe(Effect.intoDeferred(set.deferred));
+}));
+/**
+ * Create an Effect run function that is backed by a FiberSet.
+ *
+ * @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 FiberSet.
+ *
+ * @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
+});
+/**
+ * Add a fiber to the FiberSet. When the fiber completes, it will be removed.
+ *
+ * @since 2.0.0
+ * @categories combinators
+ */
+export const unsafeAdd = /*#__PURE__*/dual(args => isFiberSet(args[0]), (self, fiber, options) => {
+  if (self.state._tag === "Closed") {
+    fiber.unsafeInterruptAsFork(FiberId.combine(options?.interruptAs ?? FiberId.none, internalFiberId));
+    return;
+  } else if (self.state.backing.has(fiber)) {
+    return;
+  }
+  self.state.backing.add(fiber);
+  fiber.addObserver(exit => {
+    if (self.state._tag === "Closed") {
+      return;
+    }
+    self.state.backing.delete(fiber);
+    if (Exit.isFailure(exit) && (options?.propagateInterruption === true ? !isInternalInterruption(exit.cause) : !Cause.isInterruptedOnly(exit.cause))) {
+      Deferred.unsafeDone(self.deferred, exit);
+    }
+  });
+});
+/**
+ * Add a fiber to the FiberSet. When the fiber completes, it will be removed.
+ *
+ * @since 2.0.0
+ * @categories combinators
+ */
+export const add = /*#__PURE__*/dual(args => isFiberSet(args[0]), (self, fiber, options) => Effect.fiberIdWith(fiberId => Effect.sync(() => unsafeAdd(self, fiber, {
+  ...options,
+  interruptAs: fiberId
+}))));
+/**
+ * @since 2.0.0
+ * @categories combinators
+ */
+export const clear = self => Effect.withFiberRuntime(clearFiber => {
+  if (self.state._tag === "Closed") {
+    return Effect.void;
+  }
+  return Effect.forEach(self.state.backing, fiber =>
+  // will be removed by the observer
+  Fiber.interruptAs(fiber, FiberId.combine(clearFiber.id(), internalFiberId)));
+});
+const constInterruptedFiber = /*#__PURE__*/function () {
+  let fiber = undefined;
+  return () => {
+    if (fiber === undefined) {
+      fiber = Effect.runFork(Effect.interrupt);
+    }
+    return fiber;
+  };
+}();
+/**
+ * Fork an Effect and add the forked fiber to the FiberSet.
+ * When the fiber completes, it will be removed from the FiberSet.
+ *
+ * @since 2.0.0
+ * @categories combinators
+ */
+export const run = function () {
+  const self = arguments[0];
+  if (!Effect.isEffect(arguments[1])) {
+    const options = arguments[1];
+    return effect => runImpl(self, effect, options);
+  }
+  return runImpl(self, arguments[1], arguments[2]);
+};
+const runImpl = (self, effect, options) => Effect.fiberIdWith(fiberId => {
+  if (self.state._tag === "Closed") {
+    return Effect.sync(constInterruptedFiber);
+  }
+  return Effect.tap(Effect.forkDaemon(effect), fiber => unsafeAdd(self, fiber, {
+    ...options,
+    interruptAs: fiberId
+  }));
+});
+/**
+ * Capture a Runtime and use it to fork Effect's, adding the forked fibers to the FiberSet.
+ *
+ * @example
+ * ```ts
+ * import { Context, Effect, FiberSet } from "effect"
+ *
+ * interface Users {
+ *   readonly _: unique symbol
+ * }
+ * const Users = Context.GenericTag<Users, {
+ *    getAll: Effect.Effect<Array<unknown>>
+ * }>("Users")
+ *
+ * Effect.gen(function*() {
+ *   const set = yield* FiberSet.make()
+ *   const run = yield* FiberSet.runtime(set)<Users>()
+ *
+ *   // run some effects and add the fibers to the set
+ *   run(Effect.andThen(Users, _ => _.getAll))
+ * }).pipe(
+ *   Effect.scoped // The fibers 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();
+    }
+    const fiber = runFork(effect, options);
+    unsafeAdd(self, fiber);
+    return fiber;
+  };
+});
+/**
+ * Capture a Runtime and use it to fork Effect's, adding the forked fibers to the FiberSet.
+ *
+ * The returned run function will return Promise's.
+ *
+ * @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));
+  }
+})));
+/**
+ * @since 2.0.0
+ * @categories combinators
+ */
+export const size = self => Effect.sync(() => self.state._tag === "Closed" ? 0 : self.state.backing.size);
+/**
+ * Join all fibers in the FiberSet. If any of the Fiber's in the set 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, FiberSet } from "effect";
+ *
+ * Effect.gen(function* (_) {
+ *   const set = yield* _(FiberSet.make());
+ *   yield* _(FiberSet.add(set, Effect.runFork(Effect.fail("error"))));
+ *
+ *   // parent fiber will fail with "error"
+ *   yield* _(FiberSet.join(set));
+ * });
+ * ```
+ */
+export const join = self => Deferred.await(self.deferred);
+/**
+ * Wait until the fiber set is empty.
+ *
+ * @since 3.13.0
+ * @categories combinators
+ */
+export const awaitEmpty = self => Effect.whileLoop({
+  while: () => self.state._tag === "Open" && self.state.backing.size > 0,
+  body: () => Fiber.await(Iterable.unsafeHead(self)),
+  step: constVoid
+});
+//# sourceMappingURL=FiberSet.js.map