@xeno-js/shared 0.1.0

package/dist/infrastructure/auth/__tests__/supabase-auth.service.test.js

@@ -0,0 +1,128 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { AppError } from '../../../domain';
+import { ERROR_CODES, STATUS_CODES } from '../../../shared';
+import { SupabaseAuthService } from '../supabase-auth.service';
+describe('SupabaseAuthService', () => {
+    const getUserMock = vi.fn();
+    const getSessionMock = vi.fn();
+    const mapMock = vi.fn();
+    let mockSupabaseClient;
+    let mockMapper;
+    let mockSessionMapper;
+    let sut;
+    const config = {
+        redirectTo: undefined,
+    };
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockSupabaseClient = {
+            auth: {
+                getUser: getUserMock,
+                getSession: getSessionMock,
+            },
+        };
+        mockMapper = {
+            map: mapMock,
+        };
+        mockSessionMapper = {
+            map: mapMock,
+        };
+        sut = new SupabaseAuthService(mockSupabaseClient, mockMapper, mockSessionMapper, config);
+    });
+    // ─── Test Suite: authenticate ──────────────────────────────────────────────
+    describe('authenticate', () => {
+        const fakeToken = 'valid-supabase-jwt-token';
+        it('should return a failed Result containing a standardized AppError when Supabase auth returns an error', async () => {
+            // Arrange
+            const supabaseError = { message: 'Auth token has expired' };
+            getUserMock.mockResolvedValue({
+                data: { user: null },
+                error: supabaseError,
+            });
+            // Act
+            const result = await sut.authenticate(fakeToken);
+            // Assert
+            expect(getUserMock).toHaveBeenCalledOnce();
+            expect(getUserMock).toHaveBeenCalledWith(fakeToken);
+            expect(result.isOk()).toBe(false);
+            const error = result.getErrorOrThrow();
+            expect(error).toBeInstanceOf(AppError);
+            expect(error.code).toBe(ERROR_CODES.AUTHENTICATION_FAILED);
+            expect(error.status).toBe(STATUS_CODES.UNAUTHORIZED);
+        });
+        it('should fall back to "Unknown error" when Supabase error message is missing or undefined', async () => {
+            // Arrange
+            getUserMock.mockResolvedValue({
+                data: { user: null },
+                error: { message: undefined },
+            });
+            // Act
+            const result = await sut.authenticate(fakeToken);
+            // Assert
+            expect(result.isOk()).toBe(false);
+        });
+        it('should return a failed Result if Supabase returns no error but the user object is undefined', async () => {
+            // Arrange
+            getUserMock.mockResolvedValue({
+                data: { user: null },
+                error: null,
+            });
+            // Act
+            const result = await sut.authenticate(fakeToken);
+            // Assert
+            expect(result.isOk()).toBe(false);
+        });
+        it('should map the user to claims and return a successful Result when authentication succeeds', async () => {
+            // Arrange
+            const fakeUser = { id: 'usr-456', email: 'user@Xeno.it' };
+            const expectedClaims = {
+                sub: 'usr-456',
+                email: 'admin@example.com',
+                name: 'admin',
+                tenantId: 'tenant-789',
+                roles: ['USER'],
+                permissions: ['read:items'],
+            };
+            getUserMock.mockResolvedValue({
+                data: { user: fakeUser },
+                error: null,
+            });
+            mapMock.mockReturnValue(expectedClaims);
+            // Act
+            const result = await sut.authenticate(fakeToken);
+            // Assert
+            expect(getUserMock).toHaveBeenCalledWith(fakeToken);
+            expect(mapMock).toHaveBeenCalledOnce();
+            expect(mapMock).toHaveBeenCalledWith(fakeUser);
+            expect(result.isOk()).toBe(true);
+            expect(result.getValueOrThrow()).toEqual(expectedClaims);
+        });
+    });
+    // ─── Test Suite: isAuthenticated ───────────────────────────────────────────
+    describe('isAuthenticated', () => {
+        it('should return true when an active session exists in Supabase context', async () => {
+            // Arrange
+            const fakeSession = { id: 'session-active-abc' };
+            getSessionMock.mockResolvedValue({
+                data: { session: fakeSession },
+            });
+            // Act
+            const isAuth = await sut.isAuthenticated();
+            // Assert
+            expect(getSessionMock).toHaveBeenCalledOnce();
+            expect(isAuth).toBe(true);
+        });
+        it('should return false when session is null or undefined', async () => {
+            // Arrange
+            getSessionMock.mockResolvedValue({
+                data: { session: null },
+            });
+            // Act
+            const isAuth = await sut.isAuthenticated();
+            // Assert
+            expect(getSessionMock).toHaveBeenCalledOnce();
+            expect(isAuth).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=supabase-auth.service.test.js.map

package/dist/infrastructure/auth/__tests__/supabase-auth.service.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supabase-auth.service.test.js","sourceRoot":"","sources":["../../../../src/infrastructure/auth/__tests__/supabase-auth.service.test.ts"],"names":[],"mappings":"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"}

package/dist/infrastructure/auth/index.d.ts

@@ -0,0 +1,3 @@
+export * from './storage';
+export * from './supabase-auth.service';
+//# sourceMappingURL=index.d.ts.map

package/dist/infrastructure/auth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/auth/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,yBAAyB,CAAA"}

package/dist/infrastructure/auth/index.js

@@ -0,0 +1,3 @@
+export * from './storage';
+export * from './supabase-auth.service';
+//# sourceMappingURL=index.js.map

package/dist/infrastructure/auth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/infrastructure/auth/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,yBAAyB,CAAA"}

package/dist/infrastructure/auth/storage/cookie.storage.d.ts

@@ -0,0 +1,4 @@
+import type { IStorage } from '../../../domain';
+import type { CookieOptions } from '../../../shared';
+export declare const createCookieStorage: (opts: CookieOptions) => IStorage;
+//# sourceMappingURL=cookie.storage.d.ts.map

package/dist/infrastructure/auth/storage/cookie.storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookie.storage.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/auth/storage/cookie.storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAG7C,eAAO,MAAM,mBAAmB,GAAI,MAAM,aAAa,KAAG,QAoBxD,CAAA"}

package/dist/infrastructure/auth/storage/cookie.storage.js

@@ -0,0 +1,31 @@
+import { Guards } from '../../../shared';
+export const createCookieStorage = (opts) => ({
+    getItem: (key) => {
+        if (!Guards.isDefined(document))
+            return null;
+        const match = new RegExp(`(^| )${encodeURIComponent(key)}=([^;]+)`).exec(document.cookie);
+        return Guards.isDefined(match) ? decodeURIComponent(match[2]) : null;
+    },
+    setItem: (key, value) => {
+        if (!Guards.isDefined(document))
+            return;
+        let cookieSuffix = '';
+        if (Guards.isDefined(opts.path))
+            cookieSuffix += `; path=${opts.path}`;
+        if (Guards.isDefined(opts.maxAge))
+            cookieSuffix += `; max-age=${opts.maxAge}`;
+        if (Guards.isDefined(opts.domain))
+            cookieSuffix += `; domain=${opts.domain}`;
+        if (Guards.isDefined(opts.secure))
+            cookieSuffix += `; Secure`;
+        if (Guards.isDefined(opts.sameSite))
+            cookieSuffix += `; SameSite=${opts.sameSite}`;
+        document.cookie = `${encodeURIComponent(key)}=${encodeURIComponent(value)}${cookieSuffix}`;
+    },
+    removeItem: (key) => {
+        if (!Guards.isDefined(document))
+            return;
+        document.cookie = `${encodeURIComponent(key)}=; path=${opts.path ?? '/'}; expires=Thu, 01 Jan 1970 00:00:00 GMT`;
+    },
+});
+//# sourceMappingURL=cookie.storage.js.map

package/dist/infrastructure/auth/storage/cookie.storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookie.storage.js","sourceRoot":"","sources":["../../../../src/infrastructure/auth/storage/cookie.storage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEjC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,IAAmB,EAAY,EAAE,CAAC,CAAC;IACrE,OAAO,EAAE,CAAC,GAAW,EAAiB,EAAE;QACtC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAA;QAC5C,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,QAAQ,kBAAkB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;QACzF,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACtE,CAAC;IACD,OAAO,EAAE,CAAC,GAAW,EAAE,KAAa,EAAQ,EAAE;QAC5C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC;YAAE,OAAM;QACvC,IAAI,YAAY,GAAG,EAAE,CAAA;QACrB,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,YAAY,IAAI,UAAU,IAAI,CAAC,IAAI,EAAE,CAAA;QACtE,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,YAAY,IAAI,aAAa,IAAI,CAAC,MAAM,EAAE,CAAA;QAC7E,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,YAAY,IAAI,YAAY,IAAI,CAAC,MAAM,EAAE,CAAA;QAC5E,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,YAAY,IAAI,UAAU,CAAA;QAC7D,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,YAAY,IAAI,cAAc,IAAI,CAAC,QAAQ,EAAE,CAAA;QAClF,QAAQ,CAAC,MAAM,GAAG,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,KAAK,CAAC,GAAG,YAAY,EAAE,CAAA;IAC5F,CAAC;IACD,UAAU,EAAE,CAAC,GAAW,EAAQ,EAAE;QAChC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC;YAAE,OAAM;QACvC,QAAQ,CAAC,MAAM,GAAG,GAAG,kBAAkB,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,IAAI,IAAI,GAAG,yCAAyC,CAAA;IAClH,CAAC;CACF,CAAC,CAAA"}

package/dist/infrastructure/auth/storage/index.d.ts

@@ -0,0 +1,4 @@
+export * from './cookie.storage';
+export * from './memory.storage';
+export * from './storage.utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/infrastructure/auth/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/auth/storage/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA"}

package/dist/infrastructure/auth/storage/index.js

@@ -0,0 +1,4 @@
+export * from './cookie.storage';
+export * from './memory.storage';
+export * from './storage.utils';
+//# sourceMappingURL=index.js.map

package/dist/infrastructure/auth/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/infrastructure/auth/storage/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA"}

package/dist/infrastructure/auth/storage/memory.storage.d.ts

@@ -0,0 +1,3 @@
+import type { IStorage } from '../../../domain';
+export declare const createMemoryStorage: () => IStorage;
+//# sourceMappingURL=memory.storage.d.ts.map

package/dist/infrastructure/auth/storage/memory.storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.storage.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/auth/storage/memory.storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAGxC,eAAO,MAAM,mBAAmB,QAAO,QAWtC,CAAA"}

package/dist/infrastructure/auth/storage/memory.storage.js

@@ -0,0 +1,14 @@
+// infrastructure/auth/memory-storage.adapter.ts
+export const createMemoryStorage = () => {
+    const store = new Map();
+    return {
+        getItem: (key) => store.get(key) ?? null,
+        setItem: (key, value) => {
+            store.set(key, value);
+        },
+        removeItem: (key) => {
+            store.delete(key);
+        },
+    };
+};
+//# sourceMappingURL=memory.storage.js.map

package/dist/infrastructure/auth/storage/memory.storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.storage.js","sourceRoot":"","sources":["../../../../src/infrastructure/auth/storage/memory.storage.ts"],"names":[],"mappings":"AAEA,gDAAgD;AAChD,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAa,EAAE;IAChD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAA;IACvC,OAAO;QACL,OAAO,EAAE,CAAC,GAAW,EAAiB,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI;QAC/D,OAAO,EAAE,CAAC,GAAW,EAAE,KAAa,EAAQ,EAAE;YAC5C,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QACvB,CAAC;QACD,UAAU,EAAE,CAAC,GAAW,EAAQ,EAAE;YAChC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACnB,CAAC;KACF,CAAA;AACH,CAAC,CAAA"}

package/dist/infrastructure/auth/storage/storage.utils.d.ts

@@ -0,0 +1,10 @@
+import type { IStorage } from '../../../domain';
+import type { CookieOptions, Optional } from '../../../shared';
+export declare const StorageHelper: Readonly<{
+    readonly create: (opts: {
+        type: Optional<"local" | "session" | "memory" | "cookie">;
+        storage: Optional<IStorage>;
+        cookieOpts: Optional<CookieOptions>;
+    }) => Optional<IStorage>;
+}>;
+//# sourceMappingURL=storage.utils.d.ts.map

package/dist/infrastructure/auth/storage/storage.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.utils.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/auth/storage/storage.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAMvD,eAAO,MAAM,aAAa;4BACX;QACX,IAAI,EAAE,QAAQ,CAAC,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAAA;QACzD,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAA;QAC3B,UAAU,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAA;KACpC,KAAG,QAAQ,CAAC,QAAQ,CAAC;EAgBb,CAAA"}

package/dist/infrastructure/auth/storage/storage.utils.js

@@ -0,0 +1,22 @@
+import { Guards } from '../../../shared';
+import { createCookieStorage } from './cookie.storage';
+import { createMemoryStorage } from './memory.storage';
+export const StorageHelper = Object.freeze({
+    create(opts) {
+        switch (opts.type) {
+            case 'memory':
+                return createMemoryStorage();
+            case 'cookie':
+                if (!Guards.isDefined(opts.cookieOpts))
+                    throw new Error('At least ');
+                return createCookieStorage(opts.cookieOpts);
+            case 'session':
+                return sessionStorage;
+            case 'local':
+                return localStorage;
+            default:
+                return opts.storage;
+        }
+    },
+});
+//# sourceMappingURL=storage.utils.js.map

package/dist/infrastructure/auth/storage/storage.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.utils.js","sourceRoot":"","sources":["../../../../src/infrastructure/auth/storage/storage.utils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAEtD,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;IACzC,MAAM,CAAC,IAIN;QACC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,QAAQ;gBACX,OAAO,mBAAmB,EAAE,CAAA;YAC9B,KAAK,QAAQ;gBACX,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,CAAA;gBACpE,OAAO,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;YAC7C,KAAK,SAAS;gBACZ,OAAO,cAAc,CAAA;YACvB,KAAK,OAAO;gBACV,OAAO,YAAY,CAAA;YAErB;gBACE,OAAO,IAAI,CAAC,OAAO,CAAA;QACvB,CAAC;IACH,CAAC;CACO,CAAC,CAAA"}

package/dist/infrastructure/auth/supabase-auth.service.d.ts

@@ -0,0 +1,31 @@
+import type { Provider, Session as SupabaseSession, SupabaseClient, User } from '@supabase/supabase-js';
+import type { IAuthService, IBaseAuthService, IBaseMapper, ResultType } from '../../domain';
+import type { AuthClaims, Maybe, Optional, Session } from '../../shared';
+/**
+ * @description The SupabaseAuthService class is responsible for handling authentication-related operations using a SupabaseClient instance. It implements the IAuthService interface, providing methods to check if a user is authenticated and to retrieve authentication claims from a given token. The authenticate method interacts with the Supabase authentication API to fetch user information based on the provided token, while the isAuthenticated method checks if there is an active session. The class also includes error handling to create standardized authentication errors when necessary.
+ *
+ * @author Xeno
+ * @version 1.0.0
+ * @since 2025-09-30
+ * @link https://github.com/xeno-js/xeno-js
+ */
+export declare class SupabaseAuthService implements IBaseAuthService, IAuthService {
+    private readonly _supabase;
+    private readonly _mapper;
+    private readonly _sessionMapper;
+    private readonly _opts;
+    constructor(_supabase: SupabaseClient, _mapper: IBaseMapper<User, AuthClaims>, _sessionMapper: IBaseMapper<SupabaseSession, Session>, _opts: {
+        redirectTo: Optional<string>;
+    });
+    authenticate(token: string): Promise<ResultType<AuthClaims>>;
+    isAuthenticated(): Promise<boolean>;
+    exchangeCodeForSession(code: string): Promise<ResultType<Optional<Session>>>;
+    signInWithProvider(provider: Provider): Promise<ResultType<{
+        url: string;
+    }>>;
+    getSession(): Promise<ResultType<Maybe<Session>>>;
+    getUser(): Promise<ResultType<Maybe<AuthClaims>>>;
+    signOut(): Promise<ResultType<void>>;
+    getSessionToken(): Promise<ResultType<Optional<string>>>;
+}
+//# sourceMappingURL=supabase-auth.service.d.ts.map

package/dist/infrastructure/auth/supabase-auth.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supabase-auth.service.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/auth/supabase-auth.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,OAAO,IAAI,eAAe,EAC1B,cAAc,EACd,IAAI,EACL,MAAM,uBAAuB,CAAA;AAE9B,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAEvF,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAGpE;;;;;;;GAOG;AACH,qBAAa,mBAAoB,YAAW,gBAAgB,EAAE,YAAY;IAEtE,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAHL,SAAS,EAAE,cAAc,EACzB,OAAO,EAAE,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,EACtC,cAAc,EAAE,WAAW,CAAC,eAAe,EAAE,OAAO,CAAC,EACrD,KAAK,EAAE;QAAE,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;KAAE;IAG7C,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAc5D,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAKnC,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAc5E,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAe5E,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAajD,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;IAWjD,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAQpC,eAAe,IAAI,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;CAQtE"}

package/dist/infrastructure/auth/supabase-auth.service.js

@@ -0,0 +1,90 @@
+import { AppError, Result } from '../../domain';
+import { Guards } from '../../shared';
+/**
+ * @description The SupabaseAuthService class is responsible for handling authentication-related operations using a SupabaseClient instance. It implements the IAuthService interface, providing methods to check if a user is authenticated and to retrieve authentication claims from a given token. The authenticate method interacts with the Supabase authentication API to fetch user information based on the provided token, while the isAuthenticated method checks if there is an active session. The class also includes error handling to create standardized authentication errors when necessary.
+ *
+ * @author Xeno
+ * @version 1.0.0
+ * @since 2025-09-30
+ * @link https://github.com/xeno-js/xeno-js
+ */
+export class SupabaseAuthService {
+    _supabase;
+    _mapper;
+    _sessionMapper;
+    _opts;
+    constructor(_supabase, _mapper, _sessionMapper, _opts) {
+        this._supabase = _supabase;
+        this._mapper = _mapper;
+        this._sessionMapper = _sessionMapper;
+        this._opts = _opts;
+    }
+    async authenticate(token) {
+        const { data, error } = await this._supabase.auth.getUser(token);
+        if (Guards.isDefined(error) || !Guards.isDefined(data.user)) {
+            return Result.fail(AppError.authFailed('SupabaseAuthenticationService', error?.message ?? 'Unknown error'));
+        }
+        const user = data.user;
+        const claims = this._mapper.map(user);
+        return Result.ok(claims);
+    }
+    async isAuthenticated() {
+        const session = await this._supabase.auth.getSession();
+        return Guards.isDefined(session.data.session);
+    }
+    async exchangeCodeForSession(code) {
+        const { data, error } = await this._supabase.auth.exchangeCodeForSession(code);
+        if (Guards.isDefined(error) || !Guards.isDefined(data.session))
+            return Result.fail(AppError.authFailed('SupabaseAuthenticationService', error?.message ?? 'Unknown error'));
+        const session = data.session;
+        if (Guards.isDefined(session))
+            return Result.ok(this._sessionMapper.map(session));
+        return Result.ok();
+    }
+    async signInWithProvider(provider) {
+        const { data, error } = await this._supabase.auth.signInWithOAuth({
+            provider,
+            options: { redirectTo: this._opts.redirectTo },
+        });
+        if (Guards.isDefined(error) || Guards.isNullOrEmpty(data.url)) {
+            return Result.fail(AppError.authFailed('SupabaseFrontendAuthService', error?.message ?? 'Unexpected error'));
+        }
+        return Result.ok({ url: data.url });
+    }
+    async getSession() {
+        const { data, error } = await this._supabase.auth.getSession();
+        if (Guards.isDefined(error)) {
+            return Result.fail(AppError.authFailed('SupabaseFrontendAuthService', error.message));
+        }
+        const session = data.session;
+        if (Guards.isDefined(session))
+            return Result.ok(this._sessionMapper.map(data.session));
+        return Result.ok();
+    }
+    async getUser() {
+        const { data, error } = await this._supabase.auth.getUser();
+        if (Guards.isDefined(error)) {
+            return Result.fail(AppError.authFailed('SupabaseFrontendAuthService', error.message));
+        }
+        const user = data.user;
+        if (Guards.isDefined(user))
+            return Result.ok(this._mapper.map(user));
+        return Result.ok();
+    }
+    async signOut() {
+        const { error } = await this._supabase.auth.signOut();
+        if (Guards.isDefined(error)) {
+            return Result.fail(AppError.authFailed('SupabaseFrontendAuthService', error.message));
+        }
+        return Result.ok();
+    }
+    async getSessionToken() {
+        const sessionResult = await this.getSession();
+        if (!sessionResult.isOk()) {
+            return Result.fail(sessionResult.getErrorOrThrow());
+        }
+        const session = sessionResult.getValueOrThrow();
+        return Result.ok(session?.accessToken);
+    }
+}
+//# sourceMappingURL=supabase-auth.service.js.map

package/dist/infrastructure/auth/supabase-auth.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supabase-auth.service.js","sourceRoot":"","sources":["../../../src/infrastructure/auth/supabase-auth.service.ts"],"names":[],"mappings":"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"}

package/dist/infrastructure/cache/__tests__/in-memory.cache.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=in-memory.cache.test.d.ts.map

package/dist/infrastructure/cache/__tests__/in-memory.cache.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.cache.test.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/cache/__tests__/in-memory.cache.test.ts"],"names":[],"mappings":""}

package/dist/infrastructure/cache/__tests__/in-memory.cache.test.js

@@ -0,0 +1,69 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { InMemoryCache } from '../in-memory.cache';
+describe('InMemoryCache', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+        vi.setSystemTime(new Date('2026-01-01T00:00:00.000Z'));
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it('returns undefined for missing keys in get', async () => {
+        const cache = new InMemoryCache();
+        await expect(cache.get('missing')).resolves.toBeUndefined();
+    });
+    it('stores and retrieves values without ttl', async () => {
+        const cache = new InMemoryCache();
+        const value = { user: 'alice', roles: ['admin'] };
+        await cache.set('k1', value, undefined);
+        await expect(cache.get('k1')).resolves.toEqual(value);
+        await expect(cache.has('k1')).resolves.toBe(true);
+    });
+    it('expires entries based on ttl and deletes expired entries on get', async () => {
+        const cache = new InMemoryCache();
+        await cache.set('k-exp', { ok: true }, 1);
+        await expect(cache.get('k-exp')).resolves.toEqual({ ok: true });
+        vi.advanceTimersByTime(1001);
+        await expect(cache.get('k-exp')).resolves.toBeUndefined();
+        await expect(cache.has('k-exp')).resolves.toBe(false);
+    });
+    it('setIfAbsent returns true and stores when key is absent', async () => {
+        const cache = new InMemoryCache();
+        await expect(cache.setIfAbsent('new-key', { n: 1 }, undefined)).resolves.toBe(true);
+        await expect(cache.get('new-key')).resolves.toEqual({ n: 1 });
+    });
+    it('setIfAbsent returns false and does not overwrite existing value', async () => {
+        const cache = new InMemoryCache();
+        await cache.set('key', { n: 1 }, undefined);
+        await expect(cache.setIfAbsent('key', { n: 2 }, undefined)).resolves.toBe(false);
+        await expect(cache.get('key')).resolves.toEqual({ n: 1 });
+    });
+    it('remove deletes key and has returns false', async () => {
+        const cache = new InMemoryCache();
+        await cache.set('to-remove', { ok: true }, undefined);
+        await cache.remove('to-remove');
+        await expect(cache.has('to-remove')).resolves.toBe(false);
+        await expect(cache.get('to-remove')).resolves.toBeUndefined();
+    });
+    it('clear removes all entries', async () => {
+        const cache = new InMemoryCache();
+        await cache.set('a', 1, undefined);
+        await cache.set('b', 2, undefined);
+        await cache.clear();
+        await expect(cache.has('a')).resolves.toBe(false);
+        await expect(cache.has('b')).resolves.toBe(false);
+    });
+    it('has returns false and evicts when key is expired', async () => {
+        const cache = new InMemoryCache();
+        await cache.set('ttl-key', { v: 1 }, 1);
+        vi.advanceTimersByTime(1001);
+        await expect(cache.has('ttl-key')).resolves.toBe(false);
+        await expect(cache.get('ttl-key')).resolves.toBeUndefined();
+    });
+    it('serializes primitive values and returns parsed value in get', async () => {
+        const cache = new InMemoryCache();
+        await cache.set('num', 123, undefined);
+        await expect(cache.get('num')).resolves.toBe(123);
+    });
+});
+//# sourceMappingURL=in-memory.cache.test.js.map

package/dist/infrastructure/cache/__tests__/in-memory.cache.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.cache.test.js","sourceRoot":"","sources":["../../../../src/infrastructure/cache/__tests__/in-memory.cache.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAExE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAA;QAClB,EAAE,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,0BAA0B,CAAC,CAAC,CAAA;IACxD,CAAC,CAAC,CAAA;IAEF,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,aAAa,EAAE,CAAA;IACpB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,KAAK,GAAG,IAAI,aAAa,EAAE,CAAA;QAEjC,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAA;IAC7D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,KAAK,GAAG,IAAI,aAAa,EAAE,CAAA;QACjC,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,CAAA;QAEjD,MAAM,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,CAAA;QAEvC,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,CAAe,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QACnE,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACnD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,KAAK,GAAG,IAAI,aAAa,EAAE,CAAA;QAEjC,MAAM,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,CAAA;QACzC,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,CAAkB,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;QAEhF,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAA;QAE5B,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAA;QACzD,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACvD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACtE,MAAM,KAAK,GAAG,IAAI,aAAa,EAAE,CAAA;QAEjC,MAAM,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACnF,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,CAAgB,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IAC9E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,KAAK,GAAG,IAAI,aAAa,EAAE,CAAA;QAEjC,MAAM,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,CAAC,CAAA;QAC3C,MAAM,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAChF,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,CAAgB,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IAC1E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,KAAK,GAAG,IAAI,aAAa,EAAE,CAAA;QAEjC,MAAM,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,SAAS,CAAC,CAAA;QACrD,MAAM,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;QAE/B,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACzD,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAA;IAC/D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE;QACzC,MAAM,KAAK,GAAG,IAAI,aAAa,EAAE,CAAA;QAEjC,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,SAAS,CAAC,CAAA;QAClC,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,SAAS,CAAC,CAAA;QAClC,MAAM,KAAK,CAAC,KAAK,EAAE,CAAA;QAEnB,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACjD,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACnD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,KAAK,GAAG,IAAI,aAAa,EAAE,CAAA;QAEjC,MAAM,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;QACvC,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAA;QAE5B,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACvD,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAA;IAC7D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,KAAK,GAAG,IAAI,aAAa,EAAE,CAAA;QAEjC,MAAM,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,SAAS,CAAC,CAAA;QAEtC,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,CAAS,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC3D,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/infrastructure/cache/in-memory.cache.d.ts

@@ -0,0 +1,34 @@
+import type { ICache, Optional } from '@xeno-js/shared';
+/**
+ * @description The InMemoryCache class provides an implementation of the ICache interface using an in-memory Map to store cached values. This class allows for storing, retrieving, and managing cached values in memory, supporting features such as time-to-live (TTL) for cache entries and atomic operations for setting values only if they do not already exist. The InMemoryCache class is a simple and efficient caching solution for scenarios where a lightweight, in-memory cache is sufficient, such as during development or for caching non-critical data that does not require persistence across application restarts.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+export declare class InMemoryCache implements ICache {
+    private _cache;
+    /**
+     * @description Constructs a new instance of the InMemoryCache class, which initializes an internal Map to store cached values. The Map is used to associate cache keys with their corresponding values and expiration times, allowing for efficient retrieval and management of cached data. The constructor does not take any parameters, as the in-memory cache is self-contained and does not require external dependencies or configuration.
+     * @param _cache An optional Map instance to use as the underlying storage for the cache. If not provided, a new Map will be created to store cached values.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    constructor(_cache?: Map<string, {
+        value: string;
+        expiresAt: Optional<number>;
+    }>);
+    get<T>(key: string): Promise<Optional<T>>;
+    set<T>(key: string, value: T, ttl: Optional<number>): Promise<void>;
+    setIfAbsent<T>(key: string, value: T, ttl: Optional<number>): Promise<boolean>;
+    remove(key: string): Promise<void>;
+    has(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=in-memory.cache.d.ts.map

package/dist/infrastructure/cache/in-memory.cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.cache.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/cache/in-memory.cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAGvD;;;;;;;;KAQK;AACL,qBAAa,aAAc,YAAW,MAAM;IAYxC,OAAO,CAAC,MAAM;IAXhB;;;;;;;;;OASG;gBAEO,MAAM,GAAE,GAAG,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;KAAE,CAAa;IAG5E,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAYzC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnE,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ9E,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAGpC"}

package/dist/infrastructure/cache/in-memory.cache.js

@@ -0,0 +1,66 @@
+import { Guards, StringHelper } from '@xeno-js/shared';
+/**
+ * @description The InMemoryCache class provides an implementation of the ICache interface using an in-memory Map to store cached values. This class allows for storing, retrieving, and managing cached values in memory, supporting features such as time-to-live (TTL) for cache entries and atomic operations for setting values only if they do not already exist. The InMemoryCache class is a simple and efficient caching solution for scenarios where a lightweight, in-memory cache is sufficient, such as during development or for caching non-critical data that does not require persistence across application restarts.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+export class InMemoryCache {
+    _cache;
+    /**
+     * @description Constructs a new instance of the InMemoryCache class, which initializes an internal Map to store cached values. The Map is used to associate cache keys with their corresponding values and expiration times, allowing for efficient retrieval and management of cached data. The constructor does not take any parameters, as the in-memory cache is self-contained and does not require external dependencies or configuration.
+     * @param _cache An optional Map instance to use as the underlying storage for the cache. If not provided, a new Map will be created to store cached values.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    constructor(_cache = new Map()) {
+        this._cache = _cache;
+    }
+    async get(key) {
+        const entry = this._cache.get(key);
+        if (!Guards.isDefined(entry)) {
+            return undefined;
+        }
+        if (Guards.isDefined(entry.expiresAt) && entry.expiresAt < Date.now()) {
+            this._cache.delete(key);
+            return undefined;
+        }
+        return JSON.parse(entry.value);
+    }
+    async set(key, value, ttl) {
+        const expiresAt = Guards.isDefined(ttl) ? Date.now() + ttl * 1000 : undefined;
+        this._cache.set(key, { value: StringHelper.safeStringify(value), expiresAt });
+    }
+    async setIfAbsent(key, value, ttl) {
+        if (this._cache.has(key)) {
+            return false;
+        }
+        await this.set(key, value, ttl);
+        return true;
+    }
+    async remove(key) {
+        this._cache.delete(key);
+    }
+    async has(key) {
+        const entry = this._cache.get(key);
+        if (!Guards.isDefined(entry)) {
+            return false;
+        }
+        if (Guards.isDefined(entry.expiresAt) && entry.expiresAt < Date.now()) {
+            this._cache.delete(key);
+            return false;
+        }
+        return true;
+    }
+    async clear() {
+        this._cache.clear();
+    }
+}
+//# sourceMappingURL=in-memory.cache.js.map