alepha/src/lock/core/__tests__/$lock.middleware.spec.ts

Easy-to-use modern TypeScript framework for building many kind of applications.

import { $pipeline, Alepha } from "alepha";
import { describe, test } from "vitest";
import { LockAcquireError } from "../errors/LockAcquireError.ts";
import { AlephaLock } from "../index.ts";
import { $lock } from "../primitives/$lock.ts";

describe("$lock middleware", () => {
  test("executes handler when lock is available", async ({ expect }) => {
    const alepha = Alepha.create().with(AlephaLock);

    class TestService {
      fn = $pipeline({
        use: [$lock({ name: "test-lock" })],
        handler: async () => "ok",
      });
    }

    const svc = alepha.inject(TestService);
    await alepha.start();

    expect(await svc.fn()).toBe("ok");

    await alepha.stop();
  });

  test("passes handler arguments through", async ({ expect }) => {
    const alepha = Alepha.create().with(AlephaLock);

    class TestService {
      fn = $pipeline({
        use: [$lock({ name: "test-args-lock" })],
        handler: async (a: number, b: number) => a + b,
      });
    }

    const svc = alepha.inject(TestService);
    await alepha.start();

    expect(await svc.fn(3, 4)).toBe(7);

    await alepha.stop();
  });

  test("supports dynamic lock names", async ({ expect }) => {
    const alepha = Alepha.create().with(AlephaLock);

    class TestService {
      fn = $pipeline({
        use: [$lock({ name: (id: string) => `resource:${id}` })],
        handler: async (id: string) => `processed:${id}`,
      });
    }

    const svc = alepha.inject(TestService);
    await alepha.start();

    expect(await svc.fn("abc")).toBe("processed:abc");

    await alepha.stop();
  });

  test("throws LockAcquireError when lock is held (wait=false)", async ({
    expect,
  }) => {
    const alepha = Alepha.create().with(AlephaLock);
    const { LockProvider } = await import("../providers/LockProvider.ts");

    class TestService {
      fn = $pipeline({
        use: [$lock({ name: "held-lock" })],
        handler: async () => "should-not-run",
      });
    }

    const lockProvider = alepha.inject(LockProvider);
    const svc = alepha.inject(TestService);
    await alepha.start();

    // Pre-acquire the lock
    await lockProvider.set(
      "held-lock",
      "other-id,2026-01-01T00:00:00Z",
      true,
      60000,
    );

    await expect(svc.fn()).rejects.toThrowError(LockAcquireError);

    await alepha.stop();
  });

  test("has middleware metadata", ({ expect }) => {
    const alepha = Alepha.create().with(AlephaLock);

    class TestService {
      fn = $pipeline({
        use: [$lock({ name: "meta-lock" })],
        handler: async () => "ok",
      });
    }

    const svc = alepha.inject(TestService);
    const meta = svc.fn.middlewares;
    expect(meta).toHaveLength(1);
    expect(meta[0].name).toBe("$lock");
  });
});