@daiso-tech/core 0.14.0 → 0.15.0

package/dist/types/utilities/async/retry-iterable/retry-iterable.d.ts

@@ -1,86 +0,0 @@
-import type { RetrySettings } from "../../../utilities/async/retry/_module";
-/**
- * The <i>retryIterable</i> function will retry each iteration of {@link AsyncIterable} if it throws an error until given <i>settings.maxAttempts</i>.
- * You can add timeout for each retry by passing <i>settings.retryTimeout</i> and <i>settings.abortSignal</i> for aborting it on your own.
- * You can also customize the retry policy by passing <i>settings.retryPolicy</i> and custom backof policy by passing <i>settings.backoffPolicy</i>.
- * @group Async utilities
- * @throws {AsyncError} {@link AsyncError}
- * @throws {AbortAsyncError} {@link AbortAsyncError}
- * @throws {RetryAsyncError} {@link RetryAsyncError}
- * @throws {TimeoutAsyncError} {@link TimeoutAsyncError}
- * @example
- * ```ts
- * import { retryIterable, TimeSpan, exponentialBackoffPolicy } from "@daiso-tech/core";
- *
- * const iterable: AsyncIterable<void> = {
- *   async *[Symbol.asyncIterator]() {
- *     yield 1;
- *     throw new Error("My error mesasge");
- *   }
- * }
- *
- * (async () => {
- *   // Will throw RetryAsyncError after failing 4:th attempt
- *   for await (const item of retryIterable(iterable, {
- *     // You can choose the max retry attempts
- *     maxAttempts: 4,
- *     // You can provide a custom backoff policy
- *     backoffPolicy: exponentialBackoffPolicy(),
- *     // You can choose what error to retry, this function will retry all errors thrown
- *     retryPolicy: () => true,
- *     // You can provide a timeout for each retry
- *     retryTimeout: TimeSpan.fromMilliseconds(60_000),
- *   })) {
- *     console.log(item)
- *   }
- * })();
- * ```
- * @example with abortSignal
- * ```ts
- * import { retryIterable, TimeSpan } from "@daiso-tech/core";
- *
- * const iterable: AsyncIterable<void> = {
- *   async *[Symbol.asyncIterator]() {
- *     yield 1;
- *     throw new Error("My error mesasge");
- *   }
- * }
- *
- * (async () => {
- *   const abortController = new AbortController();
- *   abortController.abort("My abort message");
- *
- *   // Will be aborted by throwing AbortAsyncError
- *   for await (const item of retry(iterable, {
- *     abortSignal: abortController.signal
- *   })) {
- *     console.log(item)
- *   }
- * })();
- * ```
- * @example with abortSignal
- * ```ts
- * import { retryIterable, TimeSpan } from "@daiso-tech/core";
- *
- * class ErrorA extends Error {};
- * class ErrorB extends Error {};
- *
- * const iterable: AsyncIterable<void> = {
- *   async *[Symbol.asyncIterator]() {
- *     yield 1;
- *     throw new ErrorB("My error mesasge");
- *   }
- * }
- *
- *
- * (async () => {
- *   // Will not retry and ErrorB will be thrown
- *   for await (const item of retry(iterable, {
- *     retryPolicy: error => error instanceof ErrorA
- *   })) {
- *     console.log(item)
- *   }
- * })();
- * ```
- */
-export declare function retryIterable<TValue>(iterable: AsyncIterable<TValue>, settings?: RetrySettings): AsyncIterable<TValue>;

package/dist/types/utilities/async/timeout/_module.d.ts

@@ -1 +0,0 @@
-export * from "../../../utilities/async/timeout/timeout";

package/dist/types/utilities/async/timeout/timeout.d.ts

@@ -1,40 +0,0 @@
-/**
- * @module Utilities
- */
-import { LazyPromise } from "../../../utilities/async/lazy-promise/_module";
-import type { TimeSpan } from "../../../utilities/_module";
-/**
- * The <i>timeout</i> function makes a <i>{@link PromiseLike}</i> object abort after a given <i>time</i> and you can also abort it on your own by passing <i>abortSignal</i>.
- * @group Async utilities
- * @throws {AsyncError} {@link AsyncError}
- * @throws {AbortAsyncError} {@link AbortAsyncError}
- * @throws {TimeoutAsyncError} {@link TimeoutAsyncError}
- * @example
- * ```ts
- * import { timeout, delay, TimeSpan } from "@daiso-tech/core";
- *
- * (async () => {
- *   // Will throw an AbortAsyncError
- *   await timeout(async () => {
- *     await delay(TimeSpan.fromSeconds(10));
- *   }, TimeSpan.fromSeconds(5));
- * })();
- * ```
- * @example with abortSignal
- * ```ts
- * import { timeout, delay, TimeSpan } from "@daiso-tech/core";
- *
- * const abortController = new AbortController();
- * setTimeout(() => {
- *   abortController.abort("My abort error");
- * }, TimeSpan.fromSeconds(1));
- *
- * (async () => {
- *   // Will abort after 1 second by throwing AbortAsyncError
- *   await timeout(async () => {
- *     await delay(TimeSpan.fromSeconds(10));
- *   }, TimeSpan.fromSeconds(5), abortController.signal);
- * })();
- * ```
- */
-export declare function timeout<TValue>(asyncFn: () => PromiseLike<TValue>, time: TimeSpan, abortSignal?: AbortSignal): LazyPromise<TValue>;

package/dist/types/utilities/async/timeout-iterable/_module.d.ts

@@ -1 +0,0 @@
-export * from "../../../utilities/async/timeout-iterable/timeout-iterable";

package/dist/types/utilities/async/timeout-iterable/timeout-iterable.d.ts

@@ -1,64 +0,0 @@
-/**
- * @module Utilities
- */
-import type { TimeSpan } from "../../../utilities/_module";
-/**
- * The <i>timeoutIterable</i> function makes a <i>{@link AsyncIterable}</i> abort after a given <i>time</i> and you can also abort it on your own by passing <i>abortSignal</i>.
- * @group Async utilities
- * @throws {AsyncError} {@link AsyncError}
- * @throws {AbortAsyncError} {@link AbortAsyncError}
- * @example
- * ```ts
- * import { timeoutIterable, delayIterable, TimeSpan } from "@daiso-tech/core";
- *
- * const iterable: AsyncIterable<void> = delayIterable({
- *   async *[Symbol.asyncIterator]() {
- *     yield 1;
- *     yield 2;
- *     yield 3;
- *     yield 4;
- *     yield 5;
- *     yield 6;
- *     yield 7;
- *     yield 8;
- *   }
- * }, TimeSpan.fromSeconds(1));
- *
- * (async () => {
- *   // Will throw an AbortAsyncError
- *   for (const item of timeoutIterable(iterable, TimeSpan.fromSeconds(5))) {
- *     console.log(item);
- *   }
- * })();
- * ```
- * @example with abortSignal
- * ```ts
- * import { timeoutIterable, delay, TimeSpan } from "@daiso-tech/core";
- *
- * const iterable: AsyncIterable<void> = delayIterable({
- *   async *[Symbol.asyncIterator]() {
- *     yield 1;
- *     yield 2;
- *     yield 3;
- *     yield 4;
- *     yield 5;
- *     yield 6;
- *     yield 7;
- *     yield 8;
- *   }
- * }, TimeSpan.fromSeconds(1));
- *
- * const abortController = new AbortController();
- * setTimeout(() => {
- *  abortController.abort("My abort message");
- * }, TimeSpan.fromSeconds(3));
- *
- * (async () => {
- *   // Will abort after 3 second by throwing AbortAsyncError
- *   for (const item of timeoutIterable(iterable, TimeSpan.fromSeconds(5), abortController.signal)) {
- *     console.log(item);
- *   }
- * })();
- * ```
- */
-export declare function timeoutIterable<TValue>(iterable: AsyncIterable<TValue>, time: TimeSpan, abortSignal?: AbortSignal): AsyncIterable<TValue>;

package/dist/types/utilities/backof-policies/_module.d.ts

@@ -1,5 +0,0 @@
-export { type BackoffPolicy } from "../../utilities/backof-policies/_shared";
-export * from "../../utilities/backof-policies/constant-backoff-policy/_module";
-export * from "../../utilities/backof-policies/exponential-backoff-policy/_module";
-export * from "../../utilities/backof-policies/linear-backoff-policy/_module";
-export * from "../../utilities/backof-policies/polynomial-backoff-policy/_module";

package/dist/types/utilities/backof-policies/constant-backoff-policy/_module.d.ts

@@ -1 +0,0 @@
-export * from "../../../utilities/backof-policies/constant-backoff-policy/constant-backoff-policy";

package/dist/types/utilities/backof-policies/exponential-backoff-policy/_module.d.ts

@@ -1 +0,0 @@
-export * from "../../../utilities/backof-policies/exponential-backoff-policy/exponential-backoff-policy";

package/dist/types/utilities/backof-policies/linear-backoff-policy/_module.d.ts

@@ -1 +0,0 @@
-export * from "../../../utilities/backof-policies/linear-backoff-policy/linear-backoff-policy";

package/dist/types/utilities/backof-policies/polynomial-backoff-policy/_module.d.ts

@@ -1 +0,0 @@
-export * from "../../../utilities/backof-policies/polynomial-backoff-policy/polynomial-backoff-policy";

package/dist/types/utilities/validation/_module.d.ts

@@ -1,32 +0,0 @@
-/**
- * @module Utilities
- */
-import { type ZodSchema, type infer as Infer } from "zod";
-/**
- * @group Validation
- */
-export declare class ValidationError extends Error {
-    constructor(message: string, cause: unknown);
-}
-/**
- * @group Validation
- * @throws {ValidationError} {@link ValidationError}
- */
-export type Validator<TType> = (value: unknown) => TType;
-/**
- * @group Validation
- * @example
- * ```ts
- * import { zodValidator } from "@daiso-tech/core";
- * import { z } from "zod";
- *
- * const validator = zodValidator(z.string().trim());
- *
- * // Will throw error
- * validator(2);
- *
- * const validatedValue = validator(" a ");
- * // Will be "a"
- * ```
- */
-export declare function zodValidator<TSchema extends ZodSchema>(schema: TSchema): Validator<Infer<TSchema>>;