@daiso-tech/core 0.40.0 → 0.41.0

package/dist/semaphore/implementations/test-utilities/database-semaphore-adapter.test-suite.js

@@ -0,0 +1,536 @@
+/**
+ * @module Semaphore
+ */
+import {} from "vitest";
+import {} from "../../../semaphore/contracts/_module-exports.js";
+import { TimeSpan } from "../../../time-span/implementations/_module-exports.js";
+/**
+ * The `databaseSemaphoreAdapterTestSuite` function simplifies the process of testing your custom implementation of {@link IDatabaseSemaphoreAdapter | `IDatabaseSemaphoreAdapter`} with `vitest`.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/test-utilities"`
+ * @group Utilities
+ * @example
+ * ```ts
+ * import { afterEach, beforeEach, describe, expect, test } from "vitest";
+ * import { databaseSemaphoreAdapterTestSuite } from "@daiso-tech/core/semaphore/test-utilities";
+ * import { LibsqlSemaphoreAdapter } from "@daiso-tech/core/semaphore/adapters";
+ * import { type Client, createClient } from "@libsql/client";
+ *
+ * describe("class: LibsqlSemaphoreAdapter", () => {
+ *     let client: Client;
+ *     beforeEach(() => {
+ *         client = createClient({
+ *             url: ":memory:",
+ *         });
+ *     });
+ *     afterEach(() => {
+ *         client.close();
+ *     });
+ *     databaseSemaphoreAdapterTestSuite({
+ *         createAdapter: async () => {
+ *             const semaphoreAdapter = new LibsqlSemaphoreAdapter({
+ *                database: client,
+ *                 tableName: "custom_table",
+ *                 shouldRemoveExpiredKeys: false,
+ *             });
+ *             await semaphoreAdapter.init();
+ *             return semaphoreAdapter;
+ *         },
+ *         test,
+ *         beforeEach,
+ *         expect,
+ *         describe,
+ *     });
+ * });
+ * ```
+ */
+export function databaseSemaphoreAdapterTestSuite(settings) {
+    const { expect, test, createAdapter, describe, beforeEach } = settings;
+    let adapter;
+    describe("Reusable tests:", () => {
+        beforeEach(async () => {
+            adapter = await createAdapter();
+        });
+        describe("method: transaction findSemaphore", () => {
+            test("Should return null when key doesnt exists", async () => {
+                const key = "a";
+                const limit = 2;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSemaphore(key, limit);
+                });
+                const noneExistingKey = "b";
+                const result = await adapter.transaction(async (trx) => {
+                    return await trx.findSemaphore(noneExistingKey);
+                });
+                expect(result).toBeNull();
+            });
+            test("Should return ISemaphoreData when key exists", async () => {
+                const key = "a";
+                const limit = 2;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSemaphore(key, limit);
+                });
+                const result = await adapter.transaction(async (trx) => {
+                    return await trx.findSemaphore(key);
+                });
+                expect(result).toEqual({ limit });
+            });
+        });
+        describe("method: transaction findSlots", () => {
+            test("Should return empty array when key doesnt exists", async () => {
+                const key = "a";
+                const limit = 2;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSemaphore(key, limit);
+                });
+                const noneExistingKey = "b";
+                const result = await adapter.transaction(async (trx) => {
+                    return await trx.findSlots(noneExistingKey);
+                });
+                expect(result).toEqual([]);
+            });
+            test("Should return empty array when key exists and has no slots", async () => {
+                const key = "a";
+                const limit = 2;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSemaphore(key, limit);
+                });
+                const result = await adapter.transaction(async (trx) => {
+                    return await trx.findSlots(key);
+                });
+                expect(result).toEqual([]);
+            });
+            test("Should not return empty array when key exists and has no slots", async () => {
+                const key = "a";
+                const limit = 2;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSemaphore(key, limit);
+                });
+                const slotId1 = "1";
+                const expiration1 = null;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSlot(key, slotId1, expiration1);
+                });
+                const slotId2 = "2";
+                const expiration2 = null;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSlot(key, slotId2, expiration2);
+                });
+                const result = await adapter.transaction(async (trx) => {
+                    return await trx.findSlots(key);
+                });
+                expect(result).toEqual([
+                    {
+                        id: slotId1,
+                        expiration: expiration1,
+                    },
+                    {
+                        id: slotId2,
+                        expiration: expiration2,
+                    },
+                ]);
+            });
+        });
+        describe("method: transaction upsertSemaphore", () => {
+            test("Should insert when key doesnt exists exists", async () => {
+                const key = "a";
+                const limit = 2;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSemaphore(key, limit);
+                });
+                const result = await adapter.transaction(async (trx) => {
+                    return await trx.findSemaphore(key);
+                });
+                expect(result).toEqual({ limit });
+            });
+            test("Should update when key exists exists", async () => {
+                const key = "a";
+                const limit = 2;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSemaphore(key, limit);
+                });
+                const newLimit = 4;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSemaphore(key, newLimit);
+                });
+                const result = await adapter.transaction(async (trx) => {
+                    return await trx.findSemaphore(key);
+                });
+                expect(result).toEqual({
+                    limit: newLimit,
+                });
+            });
+        });
+        describe("method: transaction upsertSlot", () => {
+            test("Should insert when key doesnt exists exists", async () => {
+                const key = "a";
+                const limit = 2;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSemaphore(key, limit);
+                });
+                const slotId = "a";
+                const expiration = null;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSlot(key, slotId, expiration);
+                });
+                const slot = await adapter.transaction(async (trx) => {
+                    const slots = await trx.findSlots(key);
+                    return slots.find((slot) => slot.id === slotId);
+                });
+                expect(slot).toEqual({
+                    expiration,
+                    id: slotId,
+                });
+            });
+            test("Should update when key exists exists", async () => {
+                const key = "a";
+                const limit = 2;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSemaphore(key, limit);
+                });
+                const slotId1 = "1";
+                const expiration1 = null;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSlot(key, slotId1, expiration1);
+                });
+                const slotId2 = "2";
+                const expiration2 = TimeSpan.fromMilliseconds(100).toEndDate();
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSlot(key, slotId2, expiration2);
+                });
+                const slot = await adapter.transaction(async (trx) => {
+                    const slots = await trx.findSlots(key);
+                    return slots.find((slot) => slot.id === slotId2);
+                });
+                expect(slot).toEqual({
+                    expiration: expiration2,
+                    id: slotId2,
+                });
+            });
+        });
+        describe("method: removeSlot", () => {
+            test("Should return null when key doesnt exists", async () => {
+                const key = "a";
+                const slotId = "b";
+                const limit = 2;
+                const expiration = null;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSemaphore(key, limit);
+                });
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSlot(key, slotId, expiration);
+                });
+                const noneExistingKey = "c";
+                const result = await adapter.removeSlot(noneExistingKey, slotId);
+                expect(result).toBeNull();
+            });
+            test("Should return null when slotId doesnt exists", async () => {
+                const key = "a";
+                const slotId = "b";
+                const limit = 2;
+                const expiration = null;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSemaphore(key, limit);
+                });
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSlot(key, slotId, expiration);
+                });
+                const noneExistingSlotId = "c";
+                const result = await adapter.removeSlot(key, noneExistingSlotId);
+                expect(result).toBeNull();
+            });
+            test("Should return expiration as null when key and slotId exists", async () => {
+                const key = "a";
+                const slotId = "b";
+                const limit = 2;
+                const expiration = null;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSemaphore(key, limit);
+                });
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSlot(key, slotId, expiration);
+                });
+                const result = await adapter.removeSlot(key, slotId);
+                expect(result).toEqual({
+                    expiration,
+                });
+            });
+            test("Should return expiration as date when key and slotId exists", async () => {
+                const key = "a";
+                const slotId = "b";
+                const limit = 2;
+                const expiration = TimeSpan.fromMilliseconds(100).toEndDate();
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSemaphore(key, limit);
+                });
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSlot(key, slotId, expiration);
+                });
+                const result = await adapter.removeSlot(key, slotId);
+                expect(result).toEqual({
+                    expiration,
+                });
+            });
+            test("Should remove slot when key and slotId exists", async () => {
+                const key = "a";
+                const slotId = "b";
+                const limit = 2;
+                const expiration = null;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSemaphore(key, limit);
+                });
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSlot(key, slotId, expiration);
+                });
+                await adapter.removeSlot(key, slotId);
+                const slot = await adapter.transaction(async (trx) => {
+                    const slots = await trx.findSlots(key);
+                    return slots.find((slot) => slot.id === slotId);
+                });
+                expect(slot).toBeUndefined();
+            });
+            test("Should not remove slot when key exists and slotId does not exists", async () => {
+                const key = "a";
+                const slotId = "b";
+                const limit = 2;
+                const expiration = null;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSemaphore(key, limit);
+                });
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSlot(key, slotId, expiration);
+                });
+                const noneExistingSlotId = "c";
+                await adapter.removeSlot(key, noneExistingSlotId);
+                const slot = await adapter.transaction(async (trx) => {
+                    const slots = await trx.findSlots(key);
+                    return slots.find((slot) => slot.id === slotId);
+                });
+                expect(slot).toEqual({
+                    id: slotId,
+                    expiration,
+                });
+            });
+        });
+        describe("method: removeAllSlots", () => {
+            test("Should return empty array when key doesnt exists", async () => {
+                const key = "a";
+                const slotId = "b";
+                const limit = 2;
+                const expiration = null;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSemaphore(key, limit);
+                });
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSlot(key, slotId, expiration);
+                });
+                const noneExistingKey = "c";
+                const result = await adapter.removeAllSlots(noneExistingKey);
+                expect(result).toEqual([]);
+            });
+            test("Should return empty array when key exists and has no slots", async () => {
+                const key = "a";
+                const limit = 2;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSemaphore(key, limit);
+                });
+                const result = await adapter.removeAllSlots(key);
+                expect(result).toEqual([]);
+            });
+            test("Should return array with 2 items when key exists and has slots", async () => {
+                const key = "a";
+                const limit = 2;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSemaphore(key, limit);
+                });
+                const slotId1 = "b";
+                const expiration1 = null;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSlot(key, slotId1, expiration1);
+                });
+                const slotId2 = "c";
+                const expiration2 = TimeSpan.fromMilliseconds(10).toEndDate();
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSlot(key, slotId2, expiration2);
+                });
+                const result = await adapter.removeAllSlots(key);
+                expect(result).toEqual([
+                    {
+                        expiration: expiration1,
+                    },
+                    {
+                        expiration: expiration2,
+                    },
+                ]);
+            });
+            test("Should remove all items when key exists and has slots", async () => {
+                const key = "a";
+                const limit = 2;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSemaphore(key, limit);
+                });
+                const slotId1 = "b";
+                const expiration1 = null;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSlot(key, slotId1, expiration1);
+                });
+                const slotId2 = "c";
+                const expiration2 = TimeSpan.fromMilliseconds(10).toEndDate();
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSlot(key, slotId2, expiration2);
+                });
+                await adapter.removeAllSlots(key);
+                const slots = await adapter.transaction(async (trx) => {
+                    return await trx.findSlots(key);
+                });
+                expect(slots).toEqual([]);
+            });
+        });
+        describe("method: updateExpiration", () => {
+            test("Should return 0 when semaphore key doesnt exists", async () => {
+                const key = "a";
+                const limit = 2;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSemaphore(key, limit);
+                });
+                const slotId1 = "1";
+                const expiration = TimeSpan.fromMilliseconds(50).toEndDate();
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSlot(key, slotId1, expiration);
+                });
+                const newExpiration = TimeSpan.fromMilliseconds(100).toEndDate();
+                const noneExistingKey = "b";
+                const result1 = await adapter.updateExpiration(noneExistingKey, slotId1, newExpiration);
+                expect(result1).toBe(0);
+            });
+            test("Should return 0 when slot doesnt exists", async () => {
+                const key = "a";
+                const limit = 2;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSemaphore(key, limit);
+                });
+                const slotId1 = "1";
+                const expiration = TimeSpan.fromMilliseconds(50).toEndDate();
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSlot(key, slotId1, expiration);
+                });
+                const newExpiration = TimeSpan.fromMilliseconds(100).toEndDate();
+                const noneExistingSlotId = "b";
+                const result1 = await adapter.updateExpiration(key, noneExistingSlotId, newExpiration);
+                expect(result1).toBe(0);
+            });
+            test("Should return 0 when slot is expired", async () => {
+                const key = "a";
+                const limit = 2;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSemaphore(key, limit);
+                });
+                const slotId1 = "1";
+                const expiration = TimeSpan.fromMilliseconds(50).toStartDate();
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSlot(key, slotId1, expiration);
+                });
+                const newExpiration = TimeSpan.fromMilliseconds(100).toEndDate();
+                const result1 = await adapter.updateExpiration(key, slotId1, newExpiration);
+                expect(result1).toBe(0);
+            });
+            test("Should return 0 when slot is unexpireable", async () => {
+                const key = "a";
+                const limit = 2;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSemaphore(key, limit);
+                });
+                const slotId1 = "1";
+                const expiration = null;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSlot(key, slotId1, expiration);
+                });
+                const newExpiration = TimeSpan.fromMilliseconds(100).toEndDate();
+                const result1 = await adapter.updateExpiration(key, slotId1, newExpiration);
+                expect(result1).toBe(0);
+            });
+            test("Should return number greater than 0 when slot is unexpired", async () => {
+                const key = "a";
+                const limit = 2;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSemaphore(key, limit);
+                });
+                const slotId1 = "1";
+                const expiration = TimeSpan.fromMilliseconds(50);
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSlot(key, slotId1, expiration.toEndDate());
+                });
+                const newExpiration = TimeSpan.fromMilliseconds(100);
+                const result1 = await adapter.updateExpiration(key, slotId1, newExpiration.toEndDate());
+                expect(result1).toBeGreaterThan(0);
+            });
+            test("Should not update expiration when slot is expired", async () => {
+                const key = "a";
+                const limit = 2;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSemaphore(key, limit);
+                });
+                const slotId1 = "1";
+                const expiration = TimeSpan.fromMilliseconds(50).toStartDate();
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSlot(key, slotId1, expiration);
+                });
+                const newExpiration = TimeSpan.fromMilliseconds(100).toEndDate();
+                await adapter.updateExpiration(key, slotId1, newExpiration);
+                const slot = await adapter.transaction(async (trx) => {
+                    const slots = await trx.findSlots(key);
+                    return slots.find((slot) => slot.id === slotId1);
+                });
+                expect(slot).toEqual({
+                    id: slotId1,
+                    expiration,
+                });
+            });
+            test("Should not update expiration when slot is unexpireable", async () => {
+                const key = "a";
+                const limit = 2;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSemaphore(key, limit);
+                });
+                const slotId1 = "1";
+                const expiration = null;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSlot(key, slotId1, expiration);
+                });
+                const newExpiration = TimeSpan.fromMilliseconds(100).toEndDate();
+                await adapter.updateExpiration(key, slotId1, newExpiration);
+                const slot = await adapter.transaction(async (trx) => {
+                    const slots = await trx.findSlots(key);
+                    return slots.find((slot) => slot.id === slotId1);
+                });
+                expect(slot).toEqual({
+                    id: slotId1,
+                    expiration,
+                });
+            });
+            test("Should update expiration when slot is unexpired", async () => {
+                const key = "a";
+                const limit = 2;
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSemaphore(key, limit);
+                });
+                const slotId1 = "1";
+                const expiration = TimeSpan.fromMilliseconds(50).toEndDate();
+                await adapter.transaction(async (trx) => {
+                    await trx.upsertSlot(key, slotId1, expiration);
+                });
+                const newExpiration = TimeSpan.fromMilliseconds(100).toEndDate();
+                await adapter.updateExpiration(key, slotId1, newExpiration);
+                const slot = await adapter.transaction(async (trx) => {
+                    const slots = await trx.findSlots(key);
+                    return slots.find((slot) => slot.id === slotId1);
+                });
+                expect(slot).toEqual({
+                    id: slotId1,
+                    expiration: newExpiration,
+                });
+            });
+        });
+    });
+}
+//# sourceMappingURL=database-semaphore-adapter.test-suite.js.map

package/dist/semaphore/implementations/test-utilities/database-semaphore-adapter.test-suite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-semaphore-adapter.test-suite.js","sourceRoot":"","sources":["../../../../src/semaphore/implementations/test-utilities/database-semaphore-adapter.test-suite.ts"],"names":[],"mappings":"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"}

package/dist/semaphore/implementations/test-utilities/semaphore-adapter.test-suite.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @module Semaphore
+ */
+import { type TestAPI, type SuiteAPI, type ExpectStatic, type beforeEach } from "vitest";
+import { type ISemaphoreAdapter } from "../../../semaphore/contracts/_module-exports.js";
+import { type Promisable } from "../../../utilities/_module-exports.js";
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/test-utilities"`
+ * @group Utilities
+ */
+export type SemaphoreAdapterTestSuiteSettings = {
+    expect: ExpectStatic;
+    test: TestAPI;
+    describe: SuiteAPI;
+    beforeEach: typeof beforeEach;
+    createAdapter: () => Promisable<ISemaphoreAdapter>;
+};
+/**
+ * The `semaphoreAdapterTestSuite` function simplifies the process of testing your custom implementation of {@link ISemaphoreAdapter | `ISemaphoreAdapter`} with `vitest`.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/test-utilities"`
+ * @group Utilities
+ * @example
+ * ```ts
+ * import { afterEach, beforeEach, describe, expect, test } from "vitest";
+ * import { semaphoreAdapterTestSuite } from "@daiso-tech/core/semaphore/test-utilities";
+ * import { RedisSemaphoreAdapter } from "@daiso-tech/core/semaphore/adapters";
+ * import { Redis } from "ioredis";
+ * import {
+ *     RedisContainer,
+ *     type StartedRedisContainer,
+ * } from "@testcontainers/redis";
+ * import { TimeSpan } from "@daiso-tech/core/utilities";
+ *
+ * const timeout = TimeSpan.fromMinutes(2);
+ * describe("class: RedisSemaphoreAdapter", () => {
+ *     let client: Redis;
+ *     let startedContainer: StartedRedisContainer;
+ *     beforeEach(async () => {
+ *         startedContainer = await new RedisContainer("redis:7.4.2").start();
+ *         client = new Redis(startedContainer.getConnectionUrl());
+ *     }, timeout.toMilliseconds());
+ *     afterEach(async () => {
+ *         await client.quit();
+ *         await startedContainer.stop();
+ *     }, timeout.toMilliseconds());
+ *     semaphoreAdapterTestSuite({
+ *         createAdapter: () =>
+ *             new RedisSemaphoreAdapter(client),
+ *         test,
+ *         beforeEach,
+ *         expect,
+ *         describe,
+ *     });
+ * });
+ * ```
+ */
+export declare function semaphoreAdapterTestSuite(settings: SemaphoreAdapterTestSuiteSettings): void;