@idevconn/create-icore 0.7.2 → 0.9.0

package/templates/apps/templates/client-mui/src/components/layout/LayoutSider.tsx

@@ -4,9 +4,17 @@ import PersonOutlineIcon from '@mui/icons-material/PersonOutline';
 import NoteOutlinedIcon from '@mui/icons-material/NoteOutlined';
 import { Link, useRouterState } from '@tanstack/react-router';
 import { useTranslation } from 'react-i18next';
+import type { ReactNode } from 'react';
+import { NAV_CONFIG, type NavItem } from '@/nav.config';
 
 const DRAWER_WIDTH = 220;
 
+const ICONS: Record<NavItem['iconName'], ReactNode> = {
+  dashboard: <DashboardOutlinedIcon />,
+  notes: <NoteOutlinedIcon />,
+  profile: <PersonOutlineIcon />,
+};
+
 export function LayoutSider() {
   const { t } = useTranslation();
   const pathname = useRouterState({ select: (s) => s.location.pathname });
@@ -25,26 +33,17 @@ export function LayoutSider() {
       }}
     >
       <List>
-        <ListItemButton component={Link} to="/dashboard" selected={pathname === '/dashboard'}>
-          <ListItemIcon>
-            <DashboardOutlinedIcon />
-          </ListItemIcon>
-          <ListItemText primary={t('nav.dashboard')} />
-        </ListItemButton>
-
-        <ListItemButton component={Link} to="/notes" selected={pathname.includes('/notes')}>
-          <ListItemIcon>
-            <NoteOutlinedIcon />
-          </ListItemIcon>
-          <ListItemText primary={t('notes.title')} />
-        </ListItemButton>
-
-        <ListItemButton component={Link} to="/profile" selected={pathname === '/profile'}>
-          <ListItemIcon>
-            <PersonOutlineIcon />
-          </ListItemIcon>
-          <ListItemText primary={t('nav.profile')} />
-        </ListItemButton>
+        {NAV_CONFIG.map(({ to, iconName, labelKey, exact }) => (
+          <ListItemButton
+            key={to}
+            component={Link}
+            to={to}
+            selected={exact ? pathname === to : pathname.includes(to)}
+          >
+            <ListItemIcon>{ICONS[iconName]}</ListItemIcon>
+            <ListItemText primary={t(labelKey)} />
+          </ListItemButton>
+        ))}
       </List>
     </Drawer>
   );

package/templates/apps/templates/client-mui/src/nav.config.ts

@@ -0,0 +1,17 @@
+/**
+ * Sidebar navigation. UI-agnostic: each LayoutSider maps `iconName` to its own
+ * icon library. Generated by create-icore from a base (dashboard + profile) plus
+ * the chosen features' contributions (e.g. notes when example=notes).
+ */
+export interface NavItem {
+  to: string;
+  labelKey: string;
+  iconName: 'dashboard' | 'notes' | 'profile';
+  exact?: boolean;
+}
+
+export const NAV_CONFIG: NavItem[] = [
+  { to: '/dashboard', labelKey: 'nav.dashboard', iconName: 'dashboard', exact: true },
+  { to: '/notes', labelKey: 'nav.notes', iconName: 'notes' },
+  { to: '/profile', labelKey: 'nav.profile', iconName: 'profile' },
+];

package/templates/apps/templates/client-shadcn/src/components/layout/LayoutSider.tsx

@@ -2,12 +2,13 @@ import { useState } from 'react';
 import { Link } from '@tanstack/react-router';
 import { useTranslation } from 'react-i18next';
 import { ChevronLeft, ChevronRight, LayoutDashboard, StickyNote, User } from 'lucide-react';
+import { NAV_CONFIG, type NavItem } from '@/nav.config';
 
-const NAV_ITEMS = [
-  { to: '/dashboard' as const, icon: LayoutDashboard, labelKey: 'nav.dashboard', exact: true },
-  { to: '/notes' as const, icon: StickyNote, labelKey: 'nav.notes', exact: false },
-  { to: '/profile' as const, icon: User, labelKey: 'nav.profile', exact: false },
-];
+const ICONS: Record<NavItem['iconName'], typeof LayoutDashboard> = {
+  dashboard: LayoutDashboard,
+  notes: StickyNote,
+  profile: User,
+};
 
 export function LayoutSider() {
   const { t } = useTranslation();
@@ -20,17 +21,20 @@ export function LayoutSider() {
       }`}
     >
       <nav className="flex flex-col gap-0.5 p-2 flex-1 pt-3">
-        {NAV_ITEMS.map(({ to, icon: Icon, labelKey, exact }) => (
-          <Link
-            key={to}
-            to={to}
-            activeOptions={{ exact }}
-            className="group flex items-center gap-3 rounded-md px-2.5 py-2 text-sm text-[--color-muted-foreground] transition-colors hover:bg-[--color-muted] hover:text-[--color-foreground] [&.active]:bg-[--color-primary]/10 [&.active]:text-[--color-primary] [&.active]:font-medium cursor-pointer"
-          >
-            <Icon size={16} className="shrink-0" />
-            {!collapsed && <span className="truncate">{t(labelKey)}</span>}
-          </Link>
-        ))}
+        {NAV_CONFIG.map(({ to, iconName, labelKey, exact }) => {
+          const Icon = ICONS[iconName];
+          return (
+            <Link
+              key={to}
+              to={to}
+              activeOptions={{ exact: exact ?? false }}
+              className="group flex items-center gap-3 rounded-md px-2.5 py-2 text-sm text-[--color-muted-foreground] transition-colors hover:bg-[--color-muted] hover:text-[--color-foreground] [&.active]:bg-[--color-primary]/10 [&.active]:text-[--color-primary] [&.active]:font-medium cursor-pointer"
+            >
+              <Icon size={16} className="shrink-0" />
+              {!collapsed && <span className="truncate">{t(labelKey)}</span>}
+            </Link>
+          );
+        })}
       </nav>
 
       <button

package/templates/apps/templates/client-shadcn/src/nav.config.ts

@@ -0,0 +1,17 @@
+/**
+ * Sidebar navigation. UI-agnostic: each LayoutSider maps `iconName` to its own
+ * icon library. Generated by create-icore from a base (dashboard + profile) plus
+ * the chosen features' contributions (e.g. notes when example=notes).
+ */
+export interface NavItem {
+  to: string;
+  labelKey: string;
+  iconName: 'dashboard' | 'notes' | 'profile';
+  exact?: boolean;
+}
+
+export const NAV_CONFIG: NavItem[] = [
+  { to: '/dashboard', labelKey: 'nav.dashboard', iconName: 'dashboard', exact: true },
+  { to: '/notes', labelKey: 'nav.notes', iconName: 'notes' },
+  { to: '/profile', labelKey: 'nav.profile', iconName: 'profile' },
+];

package/templates/libs/auth-strategies/firebase/eslint.config.mjs

@@ -12,6 +12,7 @@ export default [
             '{projectRoot}/eslint.config.{js,cjs,mjs,ts,cts,mts}',
             '{projectRoot}/vitest.config.{js,ts,mjs,mts}',
           ],
+          ignoredDependencies: ['@nestjs/testing', 'vitest'],
         },
       ],
     },

package/templates/libs/auth-strategies/firebase/package.json

@@ -6,10 +6,14 @@
   "main": "./src/index.js",
   "types": "./src/index.ts",
   "dependencies": {
+    "@icore/firebase-admin": "*",
     "@icore/shared": "*",
+    "@nestjs/common": "^11.1.24",
+    "@nestjs/config": "^4.0.4",
     "tslib": "^2.3.0"
   },
   "devDependencies": {
+    "@nestjs/testing": "^11.0.0",
     "vitest": "^4.0.0"
   }
 }

package/templates/libs/auth-strategies/firebase/src/index.ts

@@ -1,4 +1,5 @@
 export * from './lib/firebase-auth.strategy';
+export * from './lib/firebase-auth.module';
 export * from './lib/identity-toolkit.client';
 export * from './lib/testing/mock-identity-toolkit';
 export * from './lib/testing/mock-admin-auth';

package/templates/libs/auth-strategies/firebase/src/lib/__tests__/firebase-auth.module.unit.test.ts

@@ -0,0 +1,49 @@
+import { describe, it, expect, vi } from 'vitest';
+import { Test } from '@nestjs/testing';
+import { Global, Module } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import { FirebaseAuthModule, FIREBASE_AUTH_REQUIRED_ENV } from '../firebase-auth.module.js';
+
+// Mirrors the production setup where the auth MS registers a global
+// ConfigModule, so the dynamic module's useFactory can inject ConfigService.
+function globalConfig(get: (k: string) => string | undefined) {
+  @Global()
+  @Module({
+    providers: [
+      {
+        provide: ConfigService,
+        useValue: {
+          get,
+          getOrThrow: (k: string) => {
+            const v = get(k);
+            if (v === undefined) throw new Error(`missing ${k}`);
+            return v;
+          },
+        },
+      },
+    ],
+    exports: [ConfigService],
+  })
+  class StubConfigModule {}
+  return StubConfigModule;
+}
+
+describe('FirebaseAuthModule', () => {
+  it('requires the firebase-admin env plus the web api key', () => {
+    expect(FIREBASE_AUTH_REQUIRED_ENV).toContain('FIREBASE_WEB_API_KEY');
+    expect(FIREBASE_AUTH_REQUIRED_ENV).toContain('FB_ADMIN_PROJECT_ID');
+  });
+
+  it('falls back to the fake (dev) when env is missing, without touching firebase-admin', async () => {
+    process.env['NODE_ENV'] = 'development';
+    vi.spyOn(console, 'warn').mockImplementation(() => undefined);
+    const ref = await Test.createTestingModule({
+      imports: [globalConfig(() => undefined), FirebaseAuthModule.forRoot('.env')],
+    }).compile();
+    // Fake strategy still satisfies the AuthStrategy contract (has verifyToken).
+    expect(typeof (ref.get('AuthStrategy') as { verifyToken: unknown }).verifyToken).toBe(
+      'function',
+    );
+    delete process.env['NODE_ENV'];
+  });
+});

package/templates/libs/auth-strategies/firebase/src/lib/firebase-auth.module.ts

@@ -0,0 +1,41 @@
+import { Module, DynamicModule } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import { getFirebaseAdmin, FIREBASE_ADMIN_REQUIRED_ENV } from '@icore/firebase-admin';
+import { buildStrategyWithFallback, FakeAuthStrategy } from '@icore/shared';
+import type { AuthStrategy } from '@icore/shared';
+import { FirebaseAuthStrategy } from './firebase-auth.strategy';
+import { HttpIdentityToolkitClient } from './identity-toolkit.client';
+
+export const FIREBASE_AUTH_REQUIRED_ENV = [...FIREBASE_ADMIN_REQUIRED_ENV, 'FIREBASE_WEB_API_KEY'];
+
+@Module({})
+export class FirebaseAuthModule {
+  static forRoot(envPath: string): DynamicModule {
+    return {
+      module: FirebaseAuthModule,
+      providers: [
+        {
+          provide: 'AuthStrategy',
+          useFactory: (cfg: ConfigService): AuthStrategy =>
+            buildStrategyWithFallback<AuthStrategy>({
+              service: 'auth MS',
+              provider: 'firebase',
+              requiredEnv: FIREBASE_AUTH_REQUIRED_ENV,
+              cfg,
+              envPath,
+              build: () => {
+                const app = getFirebaseAdmin(cfg);
+                const identityToolkit = new HttpIdentityToolkitClient(
+                  cfg.getOrThrow<string>('FIREBASE_WEB_API_KEY'),
+                );
+                return new FirebaseAuthStrategy({ identityToolkit, adminAuth: app.auth() });
+              },
+              fake: () => new FakeAuthStrategy(),
+            }),
+          inject: [ConfigService],
+        },
+      ],
+      exports: ['AuthStrategy'],
+    };
+  }
+}

package/templates/libs/auth-strategies/firebase/tsconfig.json

@@ -3,6 +3,8 @@
   "compilerOptions": {
     "module": "node16",
     "moduleResolution": "node16",
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
     "forceConsistentCasingInFileNames": true,
     "strict": true,
     "importHelpers": true,

package/templates/libs/auth-strategies/mongodb/package.json

@@ -5,8 +5,15 @@
   "type": "commonjs",
   "main": "./src/index.js",
   "types": "./src/index.d.ts",
+  "devDependencies": {
+    "@types/bcrypt": "^6.0.0",
+    "@types/jsonwebtoken": "^9.0.10"
+  },
   "dependencies": {
-    "@icore/shared": "workspace:*",
+    "@icore/shared": "*",
+    "@nestjs/common": "^11.1.24",
+    "@nestjs/config": "^4.0.4",
+    "@nestjs/mongoose": "^11.0.4",
     "bcrypt": "^6.0.0",
     "jsonwebtoken": "^9.0.2",
     "mongodb-memory-server": "^11.2.0",

package/templates/libs/auth-strategies/mongodb/src/index.ts

@@ -1 +1,2 @@
 export * from './lib/mongodb-auth.strategy';
+export * from './lib/mongodb-auth.module';

package/templates/libs/auth-strategies/mongodb/src/lib/__tests__/mongodb-auth.module.unit.test.ts

@@ -0,0 +1,16 @@
+import { MongoDbAuthModule, MONGODB_AUTH_REQUIRED_ENV } from '../mongodb-auth.module';
+
+describe('MongoDbAuthModule', () => {
+  it('requires the mongo uri and jwt secret', () => {
+    expect(MONGODB_AUTH_REQUIRED_ENV).toEqual(['MONGODB_URI', 'JWT_SECRET']);
+  });
+
+  it('forRoot returns a DynamicModule that imports Mongoose and exports the AuthStrategy token', () => {
+    const dm = MongoDbAuthModule.forRoot('.env');
+    expect(dm.module).toBe(MongoDbAuthModule);
+    expect(dm.exports).toContain('AuthStrategy');
+    // Mongoose connection wiring is the module's own concern.
+    expect(Array.isArray(dm.imports)).toBe(true);
+    expect((dm.imports ?? []).length).toBeGreaterThan(0);
+  });
+});

package/templates/libs/auth-strategies/mongodb/src/lib/mongodb-auth.module.ts

@@ -0,0 +1,45 @@
+import { Module, DynamicModule } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import { MongooseModule, getConnectionToken } from '@nestjs/mongoose';
+import { Connection } from 'mongoose';
+import { buildStrategyWithFallback, FakeAuthStrategy } from '@icore/shared';
+import type { AuthStrategy } from '@icore/shared';
+import { MongoDbAuthStrategy } from './mongodb-auth.strategy';
+
+export const MONGODB_AUTH_REQUIRED_ENV = ['MONGODB_URI', 'JWT_SECRET'];
+
+@Module({})
+export class MongoDbAuthModule {
+  static forRoot(envPath: string): DynamicModule {
+    return {
+      module: MongoDbAuthModule,
+      imports: [
+        MongooseModule.forRootAsync({
+          useFactory: (cfg: ConfigService) => ({ uri: cfg.get<string>('MONGODB_URI') }),
+          inject: [ConfigService],
+        }),
+      ],
+      providers: [
+        {
+          provide: 'AuthStrategy',
+          useFactory: (cfg: ConfigService, connection: Connection): AuthStrategy =>
+            buildStrategyWithFallback<AuthStrategy>({
+              service: 'auth MS',
+              provider: 'mongodb',
+              requiredEnv: MONGODB_AUTH_REQUIRED_ENV,
+              cfg,
+              envPath,
+              build: () =>
+                new MongoDbAuthStrategy({
+                  connection,
+                  jwtSecret: cfg.getOrThrow<string>('JWT_SECRET'),
+                }),
+              fake: () => new FakeAuthStrategy(),
+            }),
+          inject: [ConfigService, getConnectionToken()],
+        },
+      ],
+      exports: ['AuthStrategy'],
+    };
+  }
+}

package/templates/libs/auth-strategies/mongodb/tsconfig.json

@@ -2,6 +2,8 @@
   "extends": "../../../tsconfig.base.json",
   "compilerOptions": {
     "module": "commonjs",
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
     "forceConsistentCasingInFileNames": true,
     "strict": true,
     "importHelpers": true,

package/templates/libs/auth-strategies/supabase/eslint.config.mjs

@@ -12,6 +12,7 @@ export default [
             '{projectRoot}/eslint.config.{js,cjs,mjs,ts,cts,mts}',
             '{projectRoot}/vitest.config.{js,ts,mjs,mts}',
           ],
+          ignoredDependencies: ['@nestjs/testing', 'vitest'],
         },
       ],
     },

package/templates/libs/auth-strategies/supabase/package.json

@@ -7,10 +7,13 @@
   "types": "./src/index.ts",
   "dependencies": {
     "@icore/shared": "*",
+    "@nestjs/common": "^11.1.24",
+    "@nestjs/config": "^4.0.4",
     "@supabase/supabase-js": "^2.0.0",
     "tslib": "^2.3.0"
   },
   "devDependencies": {
+    "@nestjs/testing": "^11.0.0",
     "vitest": "^4.0.0"
   }
 }

package/templates/libs/auth-strategies/supabase/src/index.ts

@@ -1,2 +1,3 @@
 export * from './lib/supabase-auth.strategy';
+export * from './lib/supabase-auth.module';
 export * from './lib/testing/mock-supabase';

package/templates/libs/auth-strategies/supabase/src/lib/__tests__/supabase-auth.module.unit.test.ts

@@ -0,0 +1,43 @@
+import { describe, it, expect } from 'vitest';
+import { Test } from '@nestjs/testing';
+import { Global, Module } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import { SupabaseAuthModule, SUPABASE_AUTH_REQUIRED_ENV } from '../supabase-auth.module.js';
+import { SupabaseAuthStrategy } from '../supabase-auth.strategy.js';
+
+// Mirrors the production setup where the auth MS registers a global
+// ConfigModule, so the dynamic module's useFactory can inject ConfigService.
+function globalConfig(env: Record<string, string | undefined>) {
+  @Global()
+  @Module({
+    providers: [
+      {
+        provide: ConfigService,
+        useValue: { get: (k: string) => env[k], getOrThrow: (k: string) => env[k] },
+      },
+    ],
+    exports: [ConfigService],
+  })
+  class StubConfigModule {}
+  return StubConfigModule;
+}
+
+function moduleWith(env: Record<string, string | undefined>) {
+  return Test.createTestingModule({
+    imports: [globalConfig(env), SupabaseAuthModule.forRoot('.env')],
+  }).compile();
+}
+
+describe('SupabaseAuthModule', () => {
+  it('exposes its required env', () => {
+    expect(SUPABASE_AUTH_REQUIRED_ENV).toEqual(['SUPABASE_URL', 'SUPABASE_SERVICE_ROLE_KEY']);
+  });
+
+  it('provides a real SupabaseAuthStrategy under the AuthStrategy token when env is present', async () => {
+    const ref = await moduleWith({
+      SUPABASE_URL: 'https://x.supabase.co',
+      SUPABASE_SERVICE_ROLE_KEY: 'svc',
+    });
+    expect(ref.get('AuthStrategy')).toBeInstanceOf(SupabaseAuthStrategy);
+  });
+});

package/templates/libs/auth-strategies/supabase/src/lib/supabase-auth.module.ts

@@ -0,0 +1,41 @@
+import { Module, DynamicModule } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import { createClient } from '@supabase/supabase-js';
+import { buildStrategyWithFallback, FakeAuthStrategy } from '@icore/shared';
+import type { AuthStrategy } from '@icore/shared';
+import { SupabaseAuthStrategy } from './supabase-auth.strategy';
+
+export const SUPABASE_AUTH_REQUIRED_ENV = ['SUPABASE_URL', 'SUPABASE_SERVICE_ROLE_KEY'];
+
+@Module({})
+export class SupabaseAuthModule {
+  static forRoot(envPath: string): DynamicModule {
+    return {
+      module: SupabaseAuthModule,
+      providers: [
+        {
+          provide: 'AuthStrategy',
+          useFactory: (cfg: ConfigService): AuthStrategy =>
+            buildStrategyWithFallback<AuthStrategy>({
+              service: 'auth MS',
+              provider: 'supabase',
+              requiredEnv: SUPABASE_AUTH_REQUIRED_ENV,
+              cfg,
+              envPath,
+              build: () =>
+                new SupabaseAuthStrategy({
+                  client: createClient(
+                    cfg.getOrThrow<string>('SUPABASE_URL'),
+                    cfg.getOrThrow<string>('SUPABASE_SERVICE_ROLE_KEY'),
+                    { auth: { autoRefreshToken: false, persistSession: false } },
+                  ),
+                }),
+              fake: () => new FakeAuthStrategy(),
+            }),
+          inject: [ConfigService],
+        },
+      ],
+      exports: ['AuthStrategy'],
+    };
+  }
+}

package/templates/libs/auth-strategies/supabase/tsconfig.json

@@ -3,6 +3,8 @@
   "compilerOptions": {
     "module": "node16",
     "moduleResolution": "node16",
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
     "forceConsistentCasingInFileNames": true,
     "strict": true,
     "importHelpers": true,

package/templates/libs/db-strategies/firestore/eslint.config.mjs

@@ -12,7 +12,7 @@ export default [
             '{projectRoot}/eslint.config.{js,cjs,mjs,ts,cts,mts}',
             '{projectRoot}/vitest.config.{js,ts,mjs,mts}',
           ],
-          ignoredDependencies: ['@icore/shared'],
+          ignoredDependencies: ['@icore/shared', '@nestjs/testing', 'vitest'],
         },
       ],
     },

package/templates/libs/db-strategies/firestore/package.json

@@ -6,10 +6,14 @@
   "main": "./src/index.js",
   "types": "./src/index.ts",
   "dependencies": {
+    "@icore/firebase-admin": "*",
     "@icore/shared": "*",
+    "@nestjs/common": "^11.1.24",
+    "@nestjs/config": "^4.0.4",
     "tslib": "^2.3.0"
   },
   "devDependencies": {
+    "@nestjs/testing": "^11.0.0",
     "vitest": "^4.0.0"
   }
 }

package/templates/libs/db-strategies/firestore/src/index.ts

@@ -1,2 +1,3 @@
 export * from './lib/firestore-db.strategy';
 export * from './lib/testing/mock-firestore';
+export * from './lib/firestore-db.module';

package/templates/libs/db-strategies/firestore/src/lib/__tests__/firestore-db.module.unit.test.ts

@@ -0,0 +1,37 @@
+import { describe, it, expect, vi } from 'vitest';
+import { Global, Module } from '@nestjs/common';
+import { Test } from '@nestjs/testing';
+import { ConfigService } from '@nestjs/config';
+import { FirestoreDbModule, FIRESTORE_DB_REQUIRED_ENV } from '../firestore-db.module.js';
+
+@Global()
+@Module({
+  providers: [
+    {
+      provide: ConfigService,
+      useValue: {
+        get: () => undefined,
+        getOrThrow: () => {
+          throw new Error('missing');
+        },
+      },
+    },
+  ],
+  exports: [ConfigService],
+})
+class StubConfigModule {}
+
+describe('FirestoreDbModule', () => {
+  it('requires the firebase-admin env', () => {
+    expect(FIRESTORE_DB_REQUIRED_ENV).toContain('FB_ADMIN_PROJECT_ID');
+  });
+  it('falls back to the fake (dev) when env missing, without touching firebase-admin', async () => {
+    process.env.NODE_ENV = 'development';
+    vi.spyOn(console, 'warn').mockImplementation(() => undefined);
+    const ref = await Test.createTestingModule({
+      imports: [StubConfigModule, FirestoreDbModule.forRoot('.env')],
+    }).compile();
+    expect(typeof (ref.get('DBStrategy') as { get: unknown }).get).toBe('function');
+    delete process.env.NODE_ENV;
+  });
+});

package/templates/libs/db-strategies/firestore/src/lib/firestore-db.module.ts

@@ -0,0 +1,41 @@
+import { Module, DynamicModule } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import { getFirebaseAdmin, FIREBASE_ADMIN_REQUIRED_ENV } from '@icore/firebase-admin';
+import { buildStrategyWithFallback, FakeDBStrategy } from '@icore/shared';
+import type { DBStrategy } from '@icore/shared';
+import { FirestoreDBStrategy } from './firestore-db.strategy';
+
+export const FIRESTORE_DB_REQUIRED_ENV = [...FIREBASE_ADMIN_REQUIRED_ENV];
+
+@Module({})
+export class FirestoreDbModule {
+  static forRoot(envPath: string): DynamicModule {
+    return {
+      module: FirestoreDbModule,
+      providers: [
+        {
+          provide: 'DBStrategy',
+          useFactory: (cfg: ConfigService): DBStrategy =>
+            buildStrategyWithFallback<DBStrategy>({
+              service: 'notes MS',
+              provider: 'firestore',
+              requiredEnv: FIRESTORE_DB_REQUIRED_ENV,
+              cfg,
+              envPath,
+              build: () => {
+                const app = getFirebaseAdmin(cfg);
+                return new FirestoreDBStrategy({
+                  db: app.firestore() as unknown as ConstructorParameters<
+                    typeof FirestoreDBStrategy
+                  >[0]['db'],
+                });
+              },
+              fake: () => new FakeDBStrategy(),
+            }),
+          inject: [ConfigService],
+        },
+      ],
+      exports: ['DBStrategy'],
+    };
+  }
+}

package/templates/libs/db-strategies/firestore/tsconfig.json

@@ -3,6 +3,8 @@
   "compilerOptions": {
     "module": "node16",
     "moduleResolution": "node16",
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
     "forceConsistentCasingInFileNames": true,
     "strict": true,
     "importHelpers": true,

package/templates/libs/db-strategies/mongodb/package.json

@@ -6,7 +6,10 @@
   "main": "./src/index.js",
   "types": "./src/index.d.ts",
   "dependencies": {
-    "@icore/shared": "workspace:*",
+    "@icore/shared": "*",
+    "@nestjs/common": "^11.1.24",
+    "@nestjs/config": "^4.0.4",
+    "@nestjs/mongoose": "^11.0.4",
     "mongodb-memory-server": "^11.2.0",
     "mongoose": "^9.6.3",
     "tslib": "^2.3.0"

package/templates/libs/db-strategies/mongodb/src/index.ts

@@ -1 +1,2 @@
 export * from './lib/mongodb-db.strategy';
+export * from './lib/mongodb-db.module';

package/templates/libs/db-strategies/mongodb/src/lib/__tests__/mongodb-db.module.unit.test.ts

@@ -0,0 +1,14 @@
+import { MongoDbDbModule, MONGODB_DB_REQUIRED_ENV } from '../mongodb-db.module';
+
+describe('MongoDbDbModule', () => {
+  it('requires the mongo uri', () => {
+    expect(MONGODB_DB_REQUIRED_ENV).toEqual(['MONGODB_URI']);
+  });
+  it('forRoot returns a DynamicModule importing Mongoose and exporting DBStrategy', () => {
+    const dm = MongoDbDbModule.forRoot('.env');
+    expect(dm.module).toBe(MongoDbDbModule);
+    expect(dm.exports).toContain('DBStrategy');
+    expect(Array.isArray(dm.imports)).toBe(true);
+    expect((dm.imports ?? []).length).toBeGreaterThan(0);
+  });
+});