npm - @harpy-js/core - Versions diffs - 0.4.7 - Mend

@harpy-js/core 0.4.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (147) hide show

package/README.md +326 -0
package/dist/cli.d.ts +12 -0
package/dist/cli.js +53 -0
package/dist/client/Link.d.ts +5 -0
package/dist/client/Link.js +62 -0
package/dist/client/__tests__/getActiveItemId.test.d.ts +1 -0
package/dist/client/__tests__/getActiveItemId.test.js +38 -0
package/dist/client/getActiveItemId.d.ts +7 -0
package/dist/client/getActiveItemId.js +55 -0
package/dist/client/use-i18n.d.ts +7 -0
package/dist/client/use-i18n.js +64 -0
package/dist/core/__tests__/component-analyzer.test.d.ts +1 -0
package/dist/core/__tests__/component-analyzer.test.js +151 -0
package/dist/core/__tests__/hydration-manifest.test.d.ts +1 -0
package/dist/core/__tests__/hydration-manifest.test.js +211 -0
package/dist/core/__tests__/jsx.engine.test.d.ts +1 -0
package/dist/core/__tests__/jsx.engine.test.js +118 -0
package/dist/core/app-setup.d.ts +7 -0
package/dist/core/app-setup.js +79 -0
package/dist/core/auto-register.module.d.ts +9 -0
package/dist/core/auto-register.module.js +18 -0
package/dist/core/auto-wrap-middleware.d.ts +4 -0
package/dist/core/auto-wrap-middleware.js +130 -0
package/dist/core/client-component-wrapper.d.ts +5 -0
package/dist/core/client-component-wrapper.js +37 -0
package/dist/core/client-hydration.d.ts +2 -0
package/dist/core/client-hydration.js +93 -0
package/dist/core/client-wrapper-browser.d.ts +2 -0
package/dist/core/client-wrapper-browser.js +22 -0
package/dist/core/component-analyzer.d.ts +4 -0
package/dist/core/component-analyzer.js +98 -0
package/dist/core/component-auto-wrapper.d.ts +2 -0
package/dist/core/component-auto-wrapper.js +63 -0
package/dist/core/component-client-wrapper.d.ts +4 -0
package/dist/core/component-client-wrapper.js +80 -0
package/dist/core/hydration-generator.d.ts +2 -0
package/dist/core/hydration-generator.js +98 -0
package/dist/core/hydration-manifest.d.ts +7 -0
package/dist/core/hydration-manifest.js +83 -0
package/dist/core/hydration.d.ts +16 -0
package/dist/core/hydration.js +72 -0
package/dist/core/jsx.engine.d.ts +9 -0
package/dist/core/jsx.engine.js +161 -0
package/dist/core/live-reload-client.js +32 -0
package/dist/core/live-reload.controller.d.ts +10 -0
package/dist/core/live-reload.controller.js +38 -0
package/dist/core/navigation.service.d.ts +18 -0
package/dist/core/navigation.service.js +206 -0
package/dist/core/router.module.d.ts +2 -0
package/dist/core/router.module.js +21 -0
package/dist/core/static-assets.controller.d.ts +4 -0
package/dist/core/static-assets.controller.js +51 -0
package/dist/core/types/nav.types.d.ts +22 -0
package/dist/core/types/nav.types.js +2 -0
package/dist/core/views/layout.d.ts +8 -0
package/dist/core/views/layout.js +35 -0
package/dist/decorators/jsx.decorator.d.ts +26 -0
package/dist/decorators/jsx.decorator.js +10 -0
package/dist/decorators/layout.decorator.d.ts +4 -0
package/dist/decorators/layout.decorator.js +29 -0
package/dist/i18n/__tests__/i18n.helper.test.d.ts +1 -0
package/dist/i18n/__tests__/i18n.helper.test.js +105 -0
package/dist/i18n/__tests__/i18n.interceptor.test.d.ts +1 -0
package/dist/i18n/__tests__/i18n.interceptor.test.js +195 -0
package/dist/i18n/__tests__/i18n.module.test.d.ts +1 -0
package/dist/i18n/__tests__/i18n.module.test.js +83 -0
package/dist/i18n/__tests__/i18n.service.test.d.ts +1 -0
package/dist/i18n/__tests__/i18n.service.test.js +109 -0
package/dist/i18n/__tests__/t.test.d.ts +1 -0
package/dist/i18n/__tests__/t.test.js +66 -0
package/dist/i18n/i18n-module.options.d.ts +10 -0
package/dist/i18n/i18n-module.options.js +4 -0
package/dist/i18n/i18n-switcher.controller.d.ts +12 -0
package/dist/i18n/i18n-switcher.controller.js +80 -0
package/dist/i18n/i18n-types.d.ts +8 -0
package/dist/i18n/i18n-types.js +2 -0
package/dist/i18n/i18n.helper.d.ts +14 -0
package/dist/i18n/i18n.helper.js +70 -0
package/dist/i18n/i18n.interceptor.d.ts +9 -0
package/dist/i18n/i18n.interceptor.js +99 -0
package/dist/i18n/i18n.module.d.ts +5 -0
package/dist/i18n/i18n.module.js +51 -0
package/dist/i18n/i18n.service.d.ts +12 -0
package/dist/i18n/i18n.service.js +61 -0
package/dist/i18n/index.d.ts +10 -0
package/dist/i18n/index.js +20 -0
package/dist/i18n/locale.decorator.d.ts +1 -0
package/dist/i18n/locale.decorator.js +8 -0
package/dist/i18n/t.d.ts +3 -0
package/dist/i18n/t.js +16 -0
package/dist/index.d.ts +19 -0
package/dist/index.js +40 -0
package/package.json +79 -0
package/scripts/analyze-styles.ts +124 -0
package/scripts/auto-wrap-exports.ts +239 -0
package/scripts/build-css.ts +38 -0
package/scripts/build-hydration.ts +313 -0
package/scripts/build-page-styles.ts +43 -0
package/scripts/copy-assets.ts +34 -0
package/scripts/dev.sh +3 -0
package/scripts/dev.ts +257 -0
package/src/cli.ts +71 -0
package/src/client/Link.tsx +62 -0
package/src/client/__tests__/getActiveItemId.test.ts +49 -0
package/src/client/getActiveItemId.ts +54 -0
package/src/client/use-i18n.ts +111 -0
package/src/core/__tests__/component-analyzer.test.ts +141 -0
package/src/core/__tests__/hydration-manifest.test.ts +223 -0
package/src/core/__tests__/jsx.engine.test.ts +137 -0
package/src/core/app-setup.ts +114 -0
package/src/core/auto-register.module.ts +30 -0
package/src/core/auto-wrap-middleware.ts +165 -0
package/src/core/client-component-wrapper.ts +72 -0
package/src/core/client-hydration.tsx +99 -0
package/src/core/client-wrapper-browser.ts +40 -0
package/src/core/component-analyzer.ts +89 -0
package/src/core/component-auto-wrapper.ts +68 -0
package/src/core/component-client-wrapper.ts +112 -0
package/src/core/hydration-generator.ts +94 -0
package/src/core/hydration-manifest.ts +79 -0
package/src/core/hydration.ts +70 -0
package/src/core/jsx.engine.ts +205 -0
package/src/core/live-reload-client.js +32 -0
package/src/core/live-reload.controller.ts +55 -0
package/src/core/navigation.service.ts +257 -0
package/src/core/router.module.ts +9 -0
package/src/core/static-assets.controller.ts +19 -0
package/src/core/types/nav.types.ts +53 -0
package/src/core/views/layout.tsx +61 -0
package/src/decorators/jsx.decorator.ts +49 -0
package/src/decorators/layout.decorator.ts +66 -0
package/src/i18n/__tests__/i18n.helper.test.ts +126 -0
package/src/i18n/__tests__/i18n.interceptor.test.ts +229 -0
package/src/i18n/__tests__/i18n.module.test.ts +98 -0
package/src/i18n/__tests__/i18n.service.test.ts +129 -0
package/src/i18n/__tests__/t.test.ts +88 -0
package/src/i18n/i18n-module.options.ts +53 -0
package/src/i18n/i18n-switcher.controller.ts +99 -0
package/src/i18n/i18n-types.ts +56 -0
package/src/i18n/i18n.helper.ts +75 -0
package/src/i18n/i18n.interceptor.ts +114 -0
package/src/i18n/i18n.module.ts +45 -0
package/src/i18n/i18n.service.ts +95 -0
package/src/i18n/index.ts +37 -0
package/src/i18n/locale.decorator.ts +10 -0
package/src/i18n/t.ts +62 -0
package/src/index.ts +31 -0

package/src/core/views/layout.tsx ADDED Viewed

@@ -0,0 +1,61 @@
+import React from "react";
+import type { JsxLayoutProps } from "../jsx.engine";
+export default function DefaultLayout({
+  children,
+  meta,
+  hydrationScripts,
+}: JsxLayoutProps & {
+  hydrationScripts?: Array<{ componentName: string; path: string }>;
+}) {
+  const title = meta?.title ?? "My App";
+  const description = meta?.description ?? "Default app description";
+  const canonical = meta?.canonical ?? "https://example.com";
+  const og = meta?.openGraph ?? {};
+  const twitter = meta?.twitter ?? {};
+  // Use hydration scripts passed from the engine if available
+  const chunkScripts = hydrationScripts || [];
+  return (
+    <html lang="en">
+      <head>
+        <title>{title}</title>
+        <meta charSet="utf-8" />
+        <meta name="viewport" content="width=device-width, initial-scale=1" />
+        <link rel="stylesheet" href="/styles/styles.css" />
+        <meta name="description" content={description} />
+        <link rel="canonical" href={canonical} />
+        {/* Open Graph tags */}
+        {og.title && <meta property="og:title" content={og.title} />}
+        {og.description && (
+          <meta property="og:description" content={og.description} />
+        )}
+        {og.type && <meta property="og:type" content={og.type} />}
+        {og.image && <meta property="og:image" content={og.image} />}
+        {og.url && <meta property="og:url" content={og.url} />}
+        {/* Twitter cards */}
+        {twitter.card && <meta name="twitter:card" content={twitter.card} />}
+        {twitter.title && <meta name="twitter:title" content={twitter.title} />}
+        {twitter.description && (
+          <meta name="twitter:description" content={twitter.description} />
+        )}
+        {twitter.image && <meta name="twitter:image" content={twitter.image} />}
+      </head>
+      <body className="bg-slate-50">
+        <main id="body" className="min-h-screen">
+          {children}
+        </main>
+        {/* Auto-injected hydration scripts at end of body to ensure DOM is ready */}
+        {chunkScripts.map((script) => (
+          <script key={script.componentName} src={script.path}></script>
+        ))}
+      </body>
+    </html>
+  );
+}

package/src/decorators/jsx.decorator.ts ADDED Viewed

@@ -0,0 +1,49 @@
+import { RENDER_METADATA } from "@nestjs/common/constants";
+import { JsxLayout } from "../core/jsx.engine";
+export interface MetaOptions {
+  title?: string;
+  description?: string;
+  canonical?: string;
+  openGraph?: {
+    title?: string;
+    description?: string;
+    type?: string;
+    image?: string;
+    url?: string;
+  };
+  twitter?: {
+    card?: string;
+    title?: string;
+    description?: string;
+    image?: string;
+  };
+}
+export interface RenderOptions {
+  layout?: JsxLayout;
+  bootstrapScripts?: string[];
+  meta?: MetaResolver;
+}
+export type MetaResolver<T = any> =
+  | MetaOptions
+  | ((req: any, data: T) => MetaOptions | Promise<MetaOptions>);
+export function JsxRender<T>(
+  template: (data: T) => React.JSX.Element,
+  options: RenderOptions = {},
+): MethodDecorator {
+  return (
+    target: object,
+    key: string | symbol,
+    descriptor: TypedPropertyDescriptor<any>,
+  ) => {
+    Reflect.defineMetadata(
+      RENDER_METADATA,
+      [template, options],
+      descriptor.value,
+    );
+    return descriptor;
+  };
+}

package/src/decorators/layout.decorator.ts ADDED Viewed

@@ -0,0 +1,66 @@
+import { JsxLayout } from "../core/jsx.engine";
+export const LAYOUT_METADATA = "harpy:layout";
+/**
+ * Decorator to specify a custom layout for a controller or route handler
+ * @param layout - The layout component to use
+ *
+ * @example
+ * // Apply to entire controller
+ * @Controller('auth')
+ * @WithLayout(AuthLayout)
+ * export class AuthController { }
+ *
+ * @example
+ * // Apply to specific route
+ * @Get('profile')
+ * @WithLayout(DashboardLayout)
+ * @JsxRender(ProfileView)
+ * getProfile() { }
+ */
+export function WithLayout(
+  layout: JsxLayout,
+): ClassDecorator & MethodDecorator {
+  return (
+    target: any,
+    propertyKey?: string | symbol,
+    descriptor?: PropertyDescriptor,
+  ) => {
+    if (propertyKey && descriptor) {
+      // Method decorator - applied to route handler
+      Reflect.defineMetadata(LAYOUT_METADATA, layout, descriptor.value);
+      return descriptor;
+    } else {
+      // Class decorator - applied to controller
+      Reflect.defineMetadata(LAYOUT_METADATA, layout, target);
+      return target;
+    }
+  };
+}
+/**
+ * Get the layout for a specific handler or controller
+ */
+export function getLayoutForHandler(
+  handler: Function,
+  controllerClass: Function,
+): JsxLayout | undefined {
+  // Check method-level layout first (highest priority)
+  const methodLayout = Reflect.getMetadata(LAYOUT_METADATA, handler);
+  if (methodLayout) {
+    return methodLayout;
+  }
+  // Fall back to controller-level layout
+  const controllerLayout = Reflect.getMetadata(
+    LAYOUT_METADATA,
+    controllerClass,
+  );
+  if (controllerLayout) {
+    return controllerLayout;
+  }
+  // No layout specified
+  return undefined;
+}

package/src/i18n/__tests__/i18n.helper.test.ts ADDED Viewed

@@ -0,0 +1,126 @@
+import { Test, TestingModule } from "@nestjs/testing";
+import { I18nHelper } from "../i18n.helper";
+import { I18N_MODULE_OPTIONS } from "../i18n-module.options";
+import type { I18nModuleOptions } from "../i18n-module.options";
+describe("I18nHelper", () => {
+  let helper: I18nHelper;
+  const mockOptions: I18nModuleOptions = {
+    defaultLocale: "en",
+    locales: ["en", "fr", "es"],
+    urlPattern: "query",
+    translationsPath: "./dictionaries",
+    cookieName: "locale",
+    queryParam: "lang",
+  };
+  beforeEach(async () => {
+    const module: TestingModule = await Test.createTestingModule({
+      providers: [
+        I18nHelper,
+        {
+          provide: I18N_MODULE_OPTIONS,
+          useValue: mockOptions,
+        },
+      ],
+    }).compile();
+    helper = module.get<I18nHelper>(I18nHelper);
+  });
+  describe("buildLocaleUrl", () => {
+    describe("query pattern", () => {
+      it("should build URL with query parameter", () => {
+        const url = helper.buildLocaleUrl("fr", "/home");
+        expect(url).toBe("/home?lang=fr");
+      });
+      it("should preserve existing query parameters", () => {
+        const url = helper.buildLocaleUrl("fr", "/home", { page: "2" });
+        expect(url).toContain("lang=fr");
+        expect(url).toContain("page=2");
+      });
+      it("should replace existing lang parameter", () => {
+        const url = helper.buildLocaleUrl("fr", "/home", { lang: "en" });
+        expect(url).toBe("/home?lang=fr");
+      });
+    });
+    describe("header pattern", () => {
+      beforeEach(async () => {
+        const module: TestingModule = await Test.createTestingModule({
+          providers: [
+            I18nHelper,
+            {
+              provide: I18N_MODULE_OPTIONS,
+              useValue: { ...mockOptions, urlPattern: "header" },
+            },
+          ],
+        }).compile();
+        helper = module.get<I18nHelper>(I18nHelper);
+      });
+      it("should return path without query for header pattern", () => {
+        const url = helper.buildLocaleUrl("fr", "/home");
+        expect(url).toBe("/home");
+      });
+      it("should preserve existing query parameters", () => {
+        const url = helper.buildLocaleUrl("fr", "/home", { page: "2" });
+        expect(url).toBe("/home?page=2");
+      });
+    });
+  });
+  describe("setLocaleCookie", () => {
+    it("should set cookie with correct name and value", () => {
+      const mockRes = {
+        setCookie: jest.fn(),
+      };
+      helper.setLocaleCookie(mockRes, "fr");
+      expect(mockRes.setCookie).toHaveBeenCalledWith(
+        "locale",
+        "fr",
+        expect.objectContaining({
+          path: "/",
+          maxAge: 365 * 24 * 60 * 60,
+          httpOnly: false,
+          sameSite: "lax",
+        }),
+      );
+    });
+  });
+  describe("validateLocale", () => {
+    it("should return valid locale", () => {
+      expect(helper.validateLocale("fr")).toBe("fr");
+      expect(helper.validateLocale("es")).toBe("es");
+    });
+    it("should return default locale for invalid locale", () => {
+      expect(helper.validateLocale("de")).toBe("en");
+      expect(helper.validateLocale("invalid")).toBe("en");
+    });
+    it("should return default locale for empty string", () => {
+      expect(helper.validateLocale("")).toBe("en");
+    });
+  });
+  describe("getClientConfig", () => {
+    it("should return client configuration", () => {
+      const config = helper.getClientConfig();
+      expect(config).toEqual({
+        locales: ["en", "fr", "es"],
+        defaultLocale: "en",
+        urlPattern: "query",
+        queryParam: "lang",
+      });
+    });
+  });
+});

package/src/i18n/__tests__/i18n.interceptor.test.ts ADDED Viewed

@@ -0,0 +1,229 @@
+import { Test, TestingModule } from "@nestjs/testing";
+import { ExecutionContext, CallHandler } from "@nestjs/common";
+import { I18nInterceptor } from "../i18n.interceptor";
+import { I18N_MODULE_OPTIONS } from "../i18n-module.options";
+import type { I18nModuleOptions } from "../i18n-module.options";
+import { of } from "rxjs";
+describe("I18nInterceptor", () => {
+  let interceptor: I18nInterceptor;
+  const mockOptions: I18nModuleOptions = {
+    defaultLocale: "en",
+    locales: ["en", "fr", "es"],
+    urlPattern: "query",
+    translationsPath: "./dictionaries",
+    cookieName: "locale",
+    queryParam: "lang",
+  };
+  beforeEach(async () => {
+    const module: TestingModule = await Test.createTestingModule({
+      providers: [
+        I18nInterceptor,
+        {
+          provide: I18N_MODULE_OPTIONS,
+          useValue: mockOptions,
+        },
+      ],
+    }).compile();
+    interceptor = module.get<I18nInterceptor>(I18nInterceptor);
+  });
+  const createMockContext = (
+    request: any,
+    response?: any,
+  ): ExecutionContext => {
+    const mockResponse = response || {
+      header: jest.fn(),
+    };
+    return {
+      switchToHttp: () => ({
+        getRequest: () => request,
+        getResponse: () => mockResponse,
+        getNext: jest.fn(),
+      }),
+    } as any;
+  };
+  const createMockCallHandler = (): CallHandler => {
+    return {
+      handle: () => of({}),
+    } as any;
+  };
+  describe("Query pattern locale detection", () => {
+    it("should extract locale from query parameter", (done) => {
+      const mockRequest: any = {
+        query: { lang: "fr" },
+        headers: {},
+      };
+      const context = createMockContext(mockRequest);
+      const next = createMockCallHandler();
+      interceptor.intercept(context, next).subscribe(() => {
+        expect(mockRequest.locale).toBe("fr");
+        done();
+      });
+    });
+    it("should ignore invalid query locale", (done) => {
+      const mockRequest: any = {
+        query: { lang: "invalid" },
+        headers: {},
+      };
+      const context = createMockContext(mockRequest);
+      const next = createMockCallHandler();
+      interceptor.intercept(context, next).subscribe(() => {
+        expect(mockRequest.locale).toBe("en");
+        done();
+      });
+    });
+  });
+  describe("Cookie locale detection", () => {
+    it("should extract locale from cookie", (done) => {
+      const mockRequest: any = {
+        query: {},
+        headers: {
+          cookie: "locale=fr; other=value",
+        },
+      };
+      const context = createMockContext(mockRequest);
+      const next = createMockCallHandler();
+      interceptor.intercept(context, next).subscribe(() => {
+        expect(mockRequest.locale).toBe("fr");
+        done();
+      });
+    });
+    it("should ignore invalid cookie locale", (done) => {
+      const mockRequest: any = {
+        query: {},
+        headers: {
+          cookie: "locale=invalid",
+        },
+      };
+      const context = createMockContext(mockRequest);
+      const next = createMockCallHandler();
+      interceptor.intercept(context, next).subscribe(() => {
+        expect(mockRequest.locale).toBe("en");
+        done();
+      });
+    });
+  });
+  describe("Header locale detection", () => {
+    it("should extract locale from x-lang header when using header pattern", (done) => {
+      // Create interceptor with header pattern
+      const headerInterceptor = new I18nInterceptor({
+        ...mockOptions,
+        urlPattern: "header",
+      });
+      const mockRequest: any = {
+        query: {},
+        headers: {
+          "x-lang": "fr",
+        },
+      };
+      const context = createMockContext(mockRequest);
+      const next = createMockCallHandler();
+      headerInterceptor.intercept(context, next).subscribe(() => {
+        expect(mockRequest.locale).toBe("fr");
+        done();
+      });
+    });
+    it("should extract locale from accept-language header as fallback", (done) => {
+      const mockRequest: any = {
+        query: {},
+        headers: {
+          "accept-language": "fr-FR,fr;q=0.9,en;q=0.8",
+        },
+      };
+      const context = createMockContext(mockRequest);
+      const next = createMockCallHandler();
+      interceptor.intercept(context, next).subscribe(() => {
+        expect(mockRequest.locale).toBe("fr");
+        done();
+      });
+    });
+  });
+  describe("Locale priority", () => {
+    it("should prioritize query over cookie", (done) => {
+      const mockRequest: any = {
+        query: { lang: "es" },
+        headers: {
+          cookie: "locale=fr",
+        },
+      };
+      const context = createMockContext(mockRequest);
+      const next = createMockCallHandler();
+      interceptor.intercept(context, next).subscribe(() => {
+        expect(mockRequest.locale).toBe("es");
+        done();
+      });
+    });
+    it("should prioritize cookie over accept-language header", (done) => {
+      const mockRequest: any = {
+        query: {},
+        headers: {
+          cookie: "locale=fr",
+          "accept-language": "es-ES,es;q=0.9,en;q=0.8",
+        },
+      };
+      const context = createMockContext(mockRequest);
+      const next = createMockCallHandler();
+      interceptor.intercept(context, next).subscribe(() => {
+        expect(mockRequest.locale).toBe("fr");
+        done();
+      });
+    });
+    it("should fall back to default locale when nothing matches", (done) => {
+      const mockRequest: any = {
+        query: {},
+        headers: {},
+      };
+      const context = createMockContext(mockRequest);
+      const next = createMockCallHandler();
+      interceptor.intercept(context, next).subscribe(() => {
+        expect(mockRequest.locale).toBe("en");
+        done();
+      });
+    });
+    it("should set cookie when locale is found in URL", (done) => {
+      const mockResponse = {
+        header: jest.fn(),
+      };
+      const mockRequest: any = {
+        query: { lang: "fr" },
+        headers: {},
+      };
+      const context = createMockContext(mockRequest, mockResponse);
+      const next = createMockCallHandler();
+      interceptor.intercept(context, next).subscribe(() => {
+        expect(mockRequest.locale).toBe("fr");
+        expect(mockResponse.header).toHaveBeenCalledWith(
+          "Set-Cookie",
+          expect.stringContaining("locale=fr"),
+        );
+        done();
+      });
+    });
+  });
+});

package/src/i18n/__tests__/i18n.module.test.ts ADDED Viewed

@@ -0,0 +1,98 @@
+import { Test, TestingModule } from "@nestjs/testing";
+import { I18nModule } from "../i18n.module";
+import { I18nService } from "../i18n.service";
+import { I18nHelper } from "../i18n.helper";
+import { I18nSwitcherController } from "../i18n-switcher.controller";
+import { I18N_MODULE_OPTIONS } from "../i18n-module.options";
+describe("I18nModule", () => {
+  it("should be defined", () => {
+    expect(I18nModule).toBeDefined();
+  });
+  describe("forRoot", () => {
+    it("should create a dynamic module with default options", async () => {
+      const module = I18nModule.forRoot({
+        defaultLocale: "en",
+        locales: ["en", "fr"],
+      });
+      expect(module.module).toBe(I18nModule);
+      expect(module.controllers).toContain(I18nSwitcherController);
+      expect(module.providers).toBeDefined();
+      expect(module.exports).toBeDefined();
+    });
+    it("should provide I18nService", async () => {
+      const testModule: TestingModule = await Test.createTestingModule({
+        imports: [
+          I18nModule.forRoot({
+            defaultLocale: "en",
+            locales: ["en", "fr"],
+          }),
+        ],
+      }).compile();
+      const service = await testModule.resolve<I18nService>(I18nService);
+      expect(service).toBeDefined();
+    });
+    it("should provide I18nHelper", async () => {
+      const testModule: TestingModule = await Test.createTestingModule({
+        imports: [
+          I18nModule.forRoot({
+            defaultLocale: "en",
+            locales: ["en", "fr"],
+          }),
+        ],
+      }).compile();
+      const helper = testModule.get<I18nHelper>(I18nHelper);
+      expect(helper).toBeDefined();
+    });
+    it("should apply default values for missing options", async () => {
+      const module = I18nModule.forRoot({
+        defaultLocale: "en",
+        locales: ["en"],
+      });
+      const optionsProvider = module.providers?.find(
+        (p: any) => p.provide === I18N_MODULE_OPTIONS,
+      ) as any;
+      expect(optionsProvider.useValue).toEqual({
+        defaultLocale: "en",
+        locales: ["en"],
+        urlPattern: "query",
+        translationsPath: "./dictionaries",
+        cookieName: "locale",
+        queryParam: "lang",
+      });
+    });
+    it("should preserve custom options", async () => {
+      const module = I18nModule.forRoot({
+        defaultLocale: "fr",
+        locales: ["fr", "en", "es"],
+        urlPattern: "header",
+        translationsPath: "../locales",
+        cookieName: "user_locale",
+        queryParam: "language",
+      });
+      const optionsProvider = module.providers?.find(
+        (p: any) => p.provide === I18N_MODULE_OPTIONS,
+      ) as any;
+      expect(optionsProvider.useValue).toEqual({
+        defaultLocale: "fr",
+        locales: ["fr", "en", "es"],
+        urlPattern: "header",
+        translationsPath: "../locales",
+        cookieName: "user_locale",
+        queryParam: "language",
+      });
+    });
+  });
+});