patron-oop 1.43.0 → 1.45.0

package/test-utils/debounce.ts

@@ -0,0 +1,11 @@
+export function debounce(wait: number, func: any) {
+  let timeout: number;
+
+  return function (...args: any[]) {
+    clearTimeout(timeout);
+
+    timeout = setTimeout(() => {
+      func(...args);
+    }, wait);
+  };
+}

package/test-utils/id.ts

@@ -0,0 +1 @@
+export const id = (v: unknown) => v;

package/test-utils/wait.ts

@@ -1,3 +1,6 @@
-export const wait = (ms: number) => new Promise(resolve => {
-    setTimeout(() => { resolve(1) }, ms);
-})
+export const wait = (ms: number) =>
+  new Promise((resolve) => {
+    setTimeout(() => {
+      resolve(1);
+    }, ms);
+  });

package/src/Guest/GuestAware.test.ts

@@ -1,13 +0,0 @@
-import { expect, test } from "vitest";
-import { GuestAware } from "./GuestAware";
-import { give } from "./Guest";
-
-test("GuestAware.test", () => {
-  const aware = new GuestAware((guest) => {
-    give(111, guest);
-  });
-
-  aware.value((value) => {
-    expect(value).toBe(111);
-  });
-});

package/src/Guest/GuestAware.ts

@@ -1,59 +0,0 @@
-import { GuestType } from "./Guest";
-
-export type GuestAwareExecutorType<T> = (guest: GuestType<T>) => unknown;
-
-export interface GuestAwareObjectType<T> {
-  value: GuestAwareExecutorType<T>;
-}
-
-export type GuestAwareType<T = any> =
-  | GuestAwareExecutorType<T>
-  | GuestAwareObjectType<T>;
-
-/**
- * @url https://kosukhin.github.io/patron.site/#/utils/give
- */
-export function value<T>(guestAware: GuestAwareType<T>, guest: GuestType<T>) {
-  if (guestAware === undefined) {
-    throw new Error("value didnt receive guestAware argument");
-  }
-  if (guest === undefined) {
-    throw new Error("value didnt receive guest argument");
-  }
-  if (typeof guestAware === "function") {
-    return guestAware(guest);
-  } else {
-    return guestAware.value(guest);
-  }
-}
-
-/**
- * @url https://kosukhin.github.io/patron.site/#/utils/is-guest-aware
- */
-export function isGuestAware(
-  mbGuestAware: any,
-): mbGuestAware is GuestAwareType {
-  if (mbGuestAware === undefined) {
-    throw new Error("isGuestAware didnt receive mbGuestAware argument");
-  }
-  return (
-    typeof mbGuestAware === "function" ||
-    typeof mbGuestAware?.value === "function"
-  );
-}
-
-/**
- * @url https://kosukhin.github.io/patron.site/#/guest/guest-aware
- */
-export class GuestAware<T = any> implements GuestAwareObjectType<T> {
-  public constructor(private guestAware: GuestAwareType<T>) {
-    if (guestAware === undefined) {
-      throw new Error("GuestAware constructor didnt receive executor function");
-    }
-  }
-
-  public value(guest: GuestType<T>): GuestType<T> {
-    value(this.guestAware, guest);
-    return guest;
-  }
-}

package/src/Guest/GuestAwareActive.test.ts

@@ -1,12 +0,0 @@
-import { GuestAwareActive } from "./GuestAwareActive";
-import { expect, test } from "vitest";
-
-test("GuestAwareActive.test", () => {
-  const active = new GuestAwareActive<number, number>((config, source) => {
-    source.give(config * 3);
-  });
-
-  active.do(4).value((v) => {
-    expect(v).toBe(12);
-  });
-});

package/src/Guest/GuestAwareActive.ts

@@ -1,42 +0,0 @@
-import { SourceType } from "../Source/Source";
-import { SourceEmpty } from "../Source/SourceEmpty";
-import { GuestType } from "./Guest";
-import { GuestAwareObjectType } from "./GuestAware";
-
-/**
- * @url https://kosukhin.github.io/patron.site/#/utils/action-type
- */
-export interface ActionType<P = any> {
-  do(config: P): this;
-}
-
-export interface GuestAwareAcitveType<R = unknown, T = unknown>
-  extends GuestAwareObjectType<T>,
-    ActionType<R> {}
-
-/**
- * @url https://kosukhin.github.io/patron.site/#/guest/guest-aware-active
- */
-export class GuestAwareActive<R, T> implements GuestAwareAcitveType<R, T> {
-  private source = new SourceEmpty<T>();
-
-  public constructor(
-    private configExecutor: (config: R, source: SourceType<T>) => void,
-  ) {
-    if (configExecutor === undefined) {
-      throw new Error(
-        "GuestAwareActive constructor didnt receive executor function",
-      );
-    }
-  }
-
-  public do(config: R): this {
-    this.configExecutor(config, this.source);
-    return this;
-  }
-
-  public value(guest: GuestType<T>): this {
-    this.source.value(guest);
-    return this;
-  }
-}

package/src/Guest/GuestAwareAll._asArray.test.ts

@@ -1,19 +0,0 @@
-import { expect, test } from "vitest";
-import { GuestAwareAll } from "./GuestAwareAll";
-import { Source } from "../Source/Source";
-import { Patron } from "../Patron/Patron";
-
-test("GuestAwareAll._asArray.test", () => {
-  const one = new Source(1);
-  const two = new Source(2);
-  const all = new GuestAwareAll<[number, number]>();
-
-  one.value(new Patron(all.guestKey("0")));
-  two.value(new Patron(all.guestKey("1")));
-
-  all.valueArray(
-    new Patron((value) => {
-      expect(JSON.stringify(value)).toBe("[1,2]");
-    }),
-  );
-});

package/src/Guest/GuestAwareAll._twoValuesAfter.test.ts

@@ -1,16 +0,0 @@
-import { expect, test } from "vitest";
-import { Source } from "../Source/Source";
-import { GuestAwareAll } from "./GuestAwareAll";
-
-test("GuestAwareAll._twoValuesAfter.test", () => {
-  const one = new Source(1);
-  const two = new Source(2);
-  const all = new GuestAwareAll<{ one: number; two: number }>(["one", "two"]);
-
-  all.value((value) => {
-    expect(Object.values(value).join()).toBe("1,2");
-  });
-
-  one.value(all.guestKey("one"));
-  two.value(all.guestKey("two"));
-});

package/src/Guest/GuestAwareAll._twoValuesBefore.test.ts

@@ -1,16 +0,0 @@
-import { expect, test } from "vitest";
-import { Source } from "../Source/Source";
-import { GuestAwareAll } from "./GuestAwareAll";
-
-test("GuestAwareAll._twoValuesBefore.test", () => {
-  const one = new Source(1);
-  const two = new Source(2);
-  const all = new GuestAwareAll<{ one: number; two: number }>();
-
-  one.value(all.guestKey("one"));
-  two.value(all.guestKey("two"));
-
-  all.value((value) => {
-    expect(Object.values(value).join()).toBe("1,2");
-  });
-});

package/src/Guest/GuestAwareAll._withPatron.test.ts

@@ -1,22 +0,0 @@
-import { expect, test } from "vitest";
-import { GuestAwareAll } from "./GuestAwareAll";
-import { Source } from "../Source/Source";
-import { Patron } from "../Patron/Patron";
-
-test("GuestAwareAll._withPatron.test", () => {
-  const one = new Source(1);
-  const two = new Source(2);
-  const all = new GuestAwareAll<{ one: number; two: number }>();
-
-  one.value(new Patron(all.guestKey("one")));
-  two.value(new Patron(all.guestKey("two")));
-
-  one.give(3);
-  one.give(4);
-
-  all.value(
-    new Patron((value: Record<string, unknown>) => {
-      expect(Object.values(value).length).toBe(2);
-    }),
-  );
-});

package/src/Guest/GuestAwareMap.defered.test.ts

@@ -1,46 +0,0 @@
-import { wait } from "./../../test-utils/wait";
-import { Private } from "../Private/Private";
-import { afterEach, beforeEach, expect, test, vi } from "vitest";
-import { Source } from "../Source/Source";
-import { give, GuestType } from "./Guest";
-import { GuestAware, GuestAwareType, value } from "./GuestAware";
-import { GuestAwareMap } from "./GuestAwareMap";
-import { GuestCast } from "./GuestCast";
-
-beforeEach(() => {
-  vi.useFakeTimers({ shouldAdvanceTime: true });
-});
-
-afterEach(() => {
-  vi.runOnlyPendingTimers();
-  vi.useRealTimers();
-});
-
-function x2(baseNumber: GuestAwareType<number>) {
-  return (guest: GuestType<number>) => {
-    value(
-      baseNumber,
-      new GuestCast(guest, (v) => {
-        give(v * 2, guest);
-      }),
-    );
-    return guest;
-  };
-}
-
-test("GuestAwareMap.defered.test", async () => {
-  const guestAwareOf = (val: number) =>
-    new GuestAware(async (guest) => {
-      await wait(5);
-      give(val, guest);
-    });
-  const source = new Source([1, 2, 3, 9].map(guestAwareOf));
-  const guestMapped = new GuestAwareMap(source, new Private(x2));
-  const callFn = vi.fn();
-  guestMapped.value((v) => {
-    expect(v.join()).toBe("2,4,6,18");
-    callFn();
-  });
-  await wait(50);
-  expect(callFn).toBeCalled();
-});

package/src/Guest/GuestAwareMap.fn.test.ts

@@ -1,27 +0,0 @@
-import { Private } from "../Private/Private";
-import { expect, test } from "vitest";
-import { Source } from "../Source/Source";
-import { give, GuestType } from "./Guest";
-import { GuestAwareType, value } from "./GuestAware";
-import { GuestAwareMap } from "./GuestAwareMap";
-import { GuestCast } from "./GuestCast";
-
-function x2(baseNumber: GuestAwareType<number>) {
-  return (guest: GuestType<number>) => {
-    value(
-      baseNumber,
-      new GuestCast(<GuestType>guest, (v) => {
-        give(v * 2, guest);
-      }),
-    );
-    return guest;
-  };
-}
-
-test("GuestAwareMap.test", () => {
-  const source = new Source([1, 2, 3, 9]);
-  const guestMapped = new GuestAwareMap(source, new Private(x2));
-  guestMapped.value((v) => {
-    expect(v.join()).toBe("2,4,6,18");
-  });
-});

package/src/Guest/GuestAwareMap.test.ts

@@ -1,29 +0,0 @@
-import { expect, test } from "vitest";
-import { give, GuestType } from "./Guest";
-import { GuestAwareObjectType, GuestAwareType, value } from "./GuestAware";
-import { GuestAwareMap } from "./GuestAwareMap";
-import { GuestCast } from "./GuestCast";
-import { Source } from "../Source/Source";
-import { PrivateClass } from "../Private/PrivateClass";
-
-class X2 implements GuestAwareObjectType<number> {
-  public constructor(private baseNumber: GuestAwareType<number>) {}
-
-  public value(guest: GuestType<number>) {
-    value(
-      this.baseNumber,
-      new GuestCast(<GuestType>guest, (v) => {
-        give(v * 2, guest);
-      }),
-    );
-    return this;
-  }
-}
-
-test("GuestAwareMap.test", () => {
-  const source = new Source([1, 2, 3, 9]);
-  const guestMapped = new GuestAwareMap(source, new PrivateClass(X2));
-  guestMapped.value((v) => {
-    expect(v.join()).toBe("2,4,6,18");
-  });
-});

package/src/Guest/GuestAwareMap.ts

@@ -1,48 +0,0 @@
-import { PrivateType } from "../Private/Private";
-import { give, GuestType } from "./Guest";
-import {
-  GuestAware,
-  GuestAwareObjectType,
-  GuestAwareType,
-  isGuestAware,
-  value,
-} from "./GuestAware";
-import { GuestAwareAll } from "./GuestAwareAll";
-import { GuestCast } from "./GuestCast";
-
-/**
- * @url https://kosukhin.github.io/patron.site/#/guest/guest-aware-map
- */
-export class GuestAwareMap<T, TG> implements GuestAwareObjectType<TG[]> {
-  public constructor(
-    private baseSource: GuestAwareType<T[]>,
-    private targetSource: PrivateType<GuestAwareType<TG>>,
-  ) {
-    if (baseSource === undefined) {
-      throw new Error("GuestAwareMap didnt receive baseSource argument");
-    }
-    if (targetSource === undefined) {
-      throw new Error("GuestAwareMap didnt receive targetSource argument");
-    }
-  }
-
-  public value(guest: GuestType<TG[]>) {
-    const all = new GuestAwareAll();
-    value(
-      this.baseSource,
-      new GuestCast(<GuestType>guest, (theValue) => {
-        theValue.forEach((val, index) => {
-          const valueSource = isGuestAware(val)
-            ? val
-            : new GuestAware((innerGuest) => {
-                give(val, innerGuest);
-              });
-          const targetSource = this.targetSource.get(valueSource);
-          value(targetSource, all.guestKey(index.toString()));
-        });
-      }),
-    );
-    all.valueArray(<GuestType>guest);
-    return this;
-  }
-}

package/src/Guest/GuestAwareRace.test.ts

@@ -1,46 +0,0 @@
-import { GuestAwareRace } from "./GuestAwareRace";
-import { afterEach, beforeEach, expect, test, vi } from "vitest";
-import { SourceEmpty } from "../Source/SourceEmpty";
-
-beforeEach(() => {
-  vi.useFakeTimers();
-});
-
-afterEach(() => {
-  vi.useRealTimers();
-});
-
-test("GuestAwareRace.test", async () => {
-  const sBuild = (result: number, delay: number) => {
-    const s = new SourceEmpty();
-
-    setTimeout(() => {
-      s.give(result);
-    }, delay);
-
-    return s;
-  };
-
-  const s2 = sBuild(2, 100);
-  const s1 = sBuild(1, 200);
-
-  const sAny = new GuestAwareRace([s1, s2]);
-
-  await vi.advanceTimersByTime(201);
-
-  sAny.value((v) => {
-    expect(v).toBe(1);
-  });
-
-  setTimeout(() => {
-    s1.give(3);
-    s2.give(4);
-  }, 300);
-
-  await vi.advanceTimersByTime(301);
-
-  sAny.value((v) => {
-    // ignores second value
-    expect(v).toBe(3);
-  });
-});

package/src/Guest/GuestAwareRace.ts

@@ -1,33 +0,0 @@
-import { give, GuestType } from "./Guest";
-import { GuestAwareObjectType, GuestAwareType, value } from "./GuestAware";
-import { GuestCast } from "./GuestCast";
-
-/**
- * @url https://kosukhin.github.io/patron.site/#/guest/guest-aware-race
- */
-export class GuestAwareRace<T> implements GuestAwareObjectType<T> {
-  public constructor(private guestAwares: GuestAwareType<T>[]) {
-    if (guestAwares === undefined) {
-      throw new Error("GuestAwareRace didnt receive guestAwares argument");
-    }
-  }
-
-  public value(guest: GuestType<T>): this {
-    let connectedWithGuestAware: GuestAwareType | null = null;
-    this.guestAwares.forEach((guestAware) => {
-      value(
-        guestAware,
-        new GuestCast(<GuestType>guest, (value) => {
-          if (
-            !connectedWithGuestAware ||
-            connectedWithGuestAware === guestAware
-          ) {
-            give(value as T, guest);
-            connectedWithGuestAware = guestAware;
-          }
-        }),
-      );
-    });
-    return this;
-  }
-}

package/src/Guest/GuestAwareSequence.defered.test.ts

@@ -1,58 +0,0 @@
-import { GuestAwareSequence } from "./GuestAwareSequence";
-import { give } from "./Guest";
-import {
-  GuestAware,
-  GuestAwareObjectType,
-  GuestAwareType,
-  value,
-} from "./GuestAware";
-import { GuestCast } from "./GuestCast";
-import { GuestType } from "./Guest";
-import { afterEach, beforeEach, expect, test, vi } from "vitest";
-import { Source } from "../Source/Source";
-import { PrivateClass } from "../Private/PrivateClass";
-import { wait } from "../../test-utils/wait";
-
-beforeEach(() => {
-  vi.useFakeTimers({ shouldAdvanceTime: true });
-});
-
-afterEach(() => {
-  vi.runOnlyPendingTimers();
-  vi.useRealTimers();
-});
-
-class X2 implements GuestAwareObjectType<number> {
-  public constructor(private baseNumber: GuestAwareType<number>) {}
-
-  public value(guest: GuestType<number>) {
-    value(
-      this.baseNumber,
-      new GuestCast(<GuestType>guest, (v) => {
-        give(v * 2, guest);
-      }),
-    );
-    return this;
-  }
-}
-
-test("GuestAwareSequence.defered.test", async () => {
-  const guestAwareOf = (val: number) =>
-    new GuestAware((guest) => {
-      setTimeout(() => {
-        give(val, guest);
-      }, 10);
-    });
-  const source = new Source([1, 2, 3, 9].map(guestAwareOf));
-
-  const sequence = new GuestAwareSequence(source, new PrivateClass(X2));
-
-  const callFn = vi.fn();
-  sequence.value((v) => {
-    expect(v.join()).toBe("2,4,6,18");
-    callFn();
-  });
-
-  await wait(51);
-  expect(callFn).toBeCalled();
-});

package/src/Guest/GuestAwareSequence.test.ts

@@ -1,30 +0,0 @@
-import { GuestAwareSequence } from "./GuestAwareSequence";
-import { give } from "./Guest";
-import { GuestAwareObjectType, GuestAwareType, value } from "./GuestAware";
-import { GuestCast } from "./GuestCast";
-import { GuestType } from "./Guest";
-import { expect, test } from "vitest";
-import { Source } from "../Source/Source";
-import { PrivateClass } from "../Private/PrivateClass";
-
-class X2 implements GuestAwareObjectType<number> {
-  public constructor(private baseNumber: GuestAwareType<number>) {}
-
-  public value(guest: GuestType<number>) {
-    value(
-      this.baseNumber,
-      new GuestCast(<GuestType>guest, (v) => {
-        give(v * 2, guest);
-      }),
-    );
-    return this;
-  }
-}
-
-test("GuestAwareSequence.test", () => {
-  const source = new Source([1, 2, 3, 9]);
-  const guestMapped = new GuestAwareSequence(source, new PrivateClass(X2));
-  guestMapped.value((v) => {
-    expect(v.join()).toBe("2,4,6,18");
-  });
-});

package/src/Source/SourceEmpty.test.ts

@@ -1,20 +0,0 @@
-import { SourceEmpty } from "./SourceEmpty";
-import { expect, test } from "vitest";
-
-test("SourceEmpty.test", () => {
-  const source = new SourceEmpty<number>();
-  let accumulator = 0;
-
-  // Не вызывается потому что нет значения
-  source.value(() => {
-    accumulator += 100;
-  });
-
-  // Вызывается после прихода значения
-  source.give(200);
-  source.value((value) => {
-    accumulator += value;
-  });
-
-  expect(accumulator).toBe(200);
-});

package/src/Source/SourceEmpty.ts

@@ -1,31 +0,0 @@
-import { PatronPool } from "../Patron/PatronPool";
-import { GuestCast } from "../Guest/GuestCast";
-import { give, GuestType } from "./../Guest/Guest";
-import { Source, SourceType } from "./Source";
-
-/**
- * @url https://kosukhin.github.io/patron.site/#/source/source-empty
- */
-export class SourceEmpty<T> implements SourceType<T> {
-  private baseSource = new Source<T | null>(null);
-
-  public value(guest: GuestType<T>) {
-    this.baseSource.value(
-      new GuestCast(guest as GuestType, (value, options) => {
-        if (value !== null) {
-          give(value, guest, options);
-        }
-      }),
-    );
-    return this;
-  }
-
-  public give(value: T): this {
-    this.baseSource.give(value);
-    return this;
-  }
-
-  public pool(): PatronPool<T> {
-    return this.baseSource.pool();
-  }
-}