@idevconn/create-icore 0.5.2 → 0.6.0

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

@@ -1,8 +1,11 @@
 import { randomUUID } from 'node:crypto';
 import { runAuthContract } from '@icore/shared/testing';
-import { FirebaseAuthStrategy } from '../firebase-auth.strategy';
-import { createMockIdentityToolkit, type MockHandle } from '../testing/mock-identity-toolkit';
-import { createMockAdminAuth } from '../testing/mock-admin-auth';
+import {
+  FirebaseAuthStrategy,
+  createMockIdentityToolkit,
+  type MockHandle,
+  createMockAdminAuth,
+} from '@icore/auth-firebase';
 
 const toolkits = new WeakMap<FirebaseAuthStrategy, MockHandle>();
 

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

@@ -1,6 +1,9 @@
 import { runAuthContract } from '@icore/shared/testing';
-import { SupabaseAuthStrategy } from '../supabase-auth.strategy';
-import { createMockSupabaseClient, type MockSupabaseClient } from '../testing/mock-supabase';
+import {
+  SupabaseAuthStrategy,
+  createMockSupabaseClient,
+  type MockSupabaseClient,
+} from '@icore/auth-supabase';
 
 const mocks = new WeakMap<SupabaseAuthStrategy, MockSupabaseClient>();
 

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

@@ -1,6 +1,5 @@
 import { runDBContract } from '@icore/shared/testing';
-import { FirestoreDBStrategy } from '../firestore-db.strategy';
-import { createMockFirestore } from '../testing/mock-firestore';
+import { FirestoreDBStrategy, createMockFirestore } from '@icore/db-firestore';
 
 runDBContract('FirestoreDBStrategy', () => {
   const db = createMockFirestore();

package/templates/libs/db-strategies/supabase/src/lib/__tests__/supabase-db.contract.unit.test.ts

@@ -1,6 +1,5 @@
 import { runDBContract } from '@icore/shared/testing';
-import { SupabaseDBStrategy } from '../supabase-db.strategy';
-import { createMockSupabaseDB } from '../testing/mock-supabase-postgres';
+import { SupabaseDBStrategy, createMockSupabaseDB } from '@icore/db-supabase';
 
 runDBContract('SupabaseDBStrategy', () => {
   const client = createMockSupabaseDB();

package/templates/libs/shared/src/__tests__/cross-boundary.unit.test.ts

@@ -12,6 +12,7 @@
  * needing a full build.
  */
 import { readdir, readFile, stat } from 'node:fs/promises';
+import type { Dirent } from 'node:fs';
 import { join, resolve } from 'node:path';
 import { describe, expect, it } from 'vitest';
 
@@ -21,7 +22,7 @@ const ROOT = resolve(__dirname, '../../../../..');
 
 async function walkTs(dir: string): Promise<string[]> {
   const files: string[] = [];
-  let entries: Awaited<ReturnType<typeof readdir>>;
+  let entries: Dirent<string>[];
   try {
     entries = await readdir(dir, { withFileTypes: true });
   } catch {

package/templates/libs/shared/src/__tests__/transport.unit.test.ts

@@ -19,8 +19,8 @@ describe('buildTransport', () => {
   });
 
   it('defaults to TCP when ${PREFIX}_TRANSPORT is unset', () => {
-    process.env.AUTH_HOST = '127.0.0.1';
-    process.env.AUTH_PORT = '4001';
+    process.env['AUTH_HOST'] = '127.0.0.1';
+    process.env['AUTH_PORT'] = '4001';
     const opts = buildTransport('AUTH');
     expect(opts.transport).toBe(Transport.TCP);
     const tcp = opts.options as { host: string; port: number };
@@ -29,8 +29,8 @@ describe('buildTransport', () => {
   });
 
   it('selects Redis when ${PREFIX}_TRANSPORT=redis', () => {
-    process.env.AUTH_TRANSPORT = 'redis';
-    process.env.AUTH_REDIS_URL = 'redis://localhost:6379';
+    process.env['AUTH_TRANSPORT'] = 'redis';
+    process.env['AUTH_REDIS_URL'] = 'redis://localhost:6379';
     const opts = buildTransport('AUTH');
     expect(opts.transport).toBe(Transport.REDIS);
     const redis = opts.options as { url: string; retryAttempts: number; retryDelay: number };
@@ -42,8 +42,8 @@ describe('buildTransport', () => {
   });
 
   it('selects NATS when ${PREFIX}_TRANSPORT=nats', () => {
-    process.env.AUTH_TRANSPORT = 'nats';
-    process.env.AUTH_NATS_URL = 'nats://localhost:4222,nats://localhost:4223';
+    process.env['AUTH_TRANSPORT'] = 'nats';
+    process.env['AUTH_NATS_URL'] = 'nats://localhost:4222,nats://localhost:4223';
     const opts = buildTransport('AUTH');
     expect(opts.transport).toBe(Transport.NATS);
     const nats = opts.options as {
@@ -58,13 +58,52 @@ describe('buildTransport', () => {
     expect(nats.maxReconnectAttempts).toBe(-1);
   });
 
+  it('selects MQTT when ${PREFIX}_TRANSPORT=mqtt', () => {
+    process.env.AUTH_TRANSPORT = 'mqtt';
+    process.env.AUTH_MQTT_URL = 'mqtt://localhost:1883';
+    const opts = buildTransport('AUTH');
+    expect(opts.transport).toBe(Transport.MQTT);
+    expect((opts.options as { url: string }).url).toBe('mqtt://localhost:1883');
+  });
+
+  it('selects RMQ when ${PREFIX}_TRANSPORT=rmq', () => {
+    process.env.AUTH_TRANSPORT = 'rmq';
+    process.env.AUTH_RMQ_URL = 'amqp://localhost:5672';
+    process.env.AUTH_RMQ_QUEUE = 'auth_queue';
+    const opts = buildTransport('AUTH');
+    expect(opts.transport).toBe(Transport.RMQ);
+    const o = opts.options as { urls: string[]; queue: string };
+    expect(o.urls).toEqual(['amqp://localhost:5672']);
+    expect(o.queue).toBe('auth_queue');
+  });
+
+  it('selects Kafka when ${PREFIX}_TRANSPORT=kafka (brokers + derived ids)', () => {
+    process.env.AUTH_TRANSPORT = 'kafka';
+    process.env.AUTH_KAFKA_BROKERS = 'localhost:9092,localhost:9093';
+    const opts = buildTransport('AUTH');
+    expect(opts.transport).toBe(Transport.KAFKA);
+    const o = opts.options as {
+      client: { brokers: string[]; clientId: string };
+      consumer: { groupId: string };
+    };
+    expect(o.client.brokers).toEqual(['localhost:9092', 'localhost:9093']);
+    expect(o.client.clientId).toBe('auth-client'); // derived from prefix
+    expect(o.consumer.groupId).toBe('auth-consumer');
+  });
+
+  it('throws when a broker var is missing (rmq needs queue)', () => {
+    process.env.AUTH_TRANSPORT = 'rmq';
+    process.env.AUTH_RMQ_URL = 'amqp://localhost:5672';
+    expect(() => buildTransport('AUTH')).toThrow(/AUTH_RMQ_QUEUE/);
+  });
+
   it('throws on unknown transport', () => {
-    process.env.AUTH_TRANSPORT = 'sqs';
+    process.env['AUTH_TRANSPORT'] = 'sqs';
     expect(() => buildTransport('AUTH')).toThrow(/sqs/);
   });
 
   it('throws when a required env var is missing', () => {
-    process.env.AUTH_TRANSPORT = 'redis';
+    process.env['AUTH_TRANSPORT'] = 'redis';
     expect(() => buildTransport('AUTH')).toThrow(/AUTH_REDIS_URL/);
   });
 });

package/templates/libs/shared/src/abilities/subjects.ts

@@ -1,2 +1,13 @@
+import type { InferSubjects } from '@casl/ability';
+
 export type AbilityAction = 'manage' | 'create' | 'read' | 'update' | 'delete';
-export type AbilitySubject = 'all' | 'User' | 'Profile' | 'Note';
+
+// NoteSubject is the shaped object passed to subject('Note', { ... }) in tests
+// and on the frontend <Can>. Included in AbilitySubject so ability.can() accepts
+// tagged instances, not just the string name.
+export interface NoteSubject {
+  id: string;
+  ownerId: string;
+}
+
+export type AbilitySubject = InferSubjects<NoteSubject> | 'all' | 'User' | 'Profile' | 'Note';

package/templates/libs/shared/src/strategies/__tests__/fake-auth.contract.unit.test.ts

@@ -1,5 +1,5 @@
-import { FakeAuthStrategy } from '../fakes/fake-auth';
-import { runAuthContract } from './auth.contract.unit.test';
+import { FakeAuthStrategy } from '@icore/shared';
+import { runAuthContract } from '@icore/shared/testing';
 
 runAuthContract('FakeAuthStrategy', () => new FakeAuthStrategy(), {
   getMagicLinkToken: (strategy, email) =>

package/templates/libs/shared/src/strategies/__tests__/fake-db.contract.unit.test.ts

@@ -1,4 +1,4 @@
-import { FakeDBStrategy } from '../fakes/fake-db';
-import { runDBContract } from './db.contract.unit.test';
+import { FakeDBStrategy } from '@icore/shared';
+import { runDBContract } from '@icore/shared/testing';
 
 runDBContract('FakeDBStrategy', () => new FakeDBStrategy());

package/templates/libs/shared/src/strategies/__tests__/fake-storage.contract.unit.test.ts

@@ -1,4 +1,4 @@
-import { FakeStorageStrategy } from '../fakes/fake-storage';
-import { runStorageContract } from './storage.contract.unit.test';
+import { FakeStorageStrategy } from '@icore/shared';
+import { runStorageContract } from '@icore/shared/testing';
 
 runStorageContract('FakeStorageStrategy', () => new FakeStorageStrategy());

package/templates/libs/shared/src/transport.ts

@@ -10,6 +10,12 @@ function transportKeys(prefix: string, kind: string): string[] {
       return [`${prefix}_REDIS_URL`];
     case 'nats':
       return [`${prefix}_NATS_URL`];
+    case 'mqtt':
+      return [`${prefix}_MQTT_URL`];
+    case 'rmq':
+      return [`${prefix}_RMQ_URL`, `${prefix}_RMQ_QUEUE`];
+    case 'kafka':
+      return [`${prefix}_KAFKA_BROKERS`];
     default:
       return [];
   }
@@ -98,6 +104,41 @@ export function buildTransport(prefix: string): ClientOptions {
           reconnectTimeWait: 2000,
         },
       } as unknown as ClientOptions;
+    case 'mqtt':
+      // mqtt.js auto-reconnects (reconnectPeriod default) so a dropped broker
+      // re-attaches; a broker that's down on boot is handled by the
+      // bootstrapMicroservice() retry, same as nats.
+      return {
+        transport: Transport.MQTT,
+        options: {
+          url: required(`${prefix}_MQTT_URL`),
+        },
+      } as unknown as ClientOptions;
+    case 'rmq':
+      // amqp-connection-manager reconnects in the background; the initial
+      // connect failure is caught by bootstrapMicroservice() and retried.
+      return {
+        transport: Transport.RMQ,
+        options: {
+          urls: required(`${prefix}_RMQ_URL`).split(','),
+          queue: required(`${prefix}_RMQ_QUEUE`),
+          queueOptions: { durable: false },
+        },
+      } as unknown as ClientOptions;
+    case 'kafka':
+      // kafkajs retries broker connections internally; clientId defaults from
+      // the prefix, and the consumer needs a groupId.
+      return {
+        transport: Transport.KAFKA,
+        options: {
+          client: {
+            clientId:
+              process.env[`${prefix}_KAFKA_CLIENT_ID`]?.trim() || `${prefix.toLowerCase()}-client`,
+            brokers: required(`${prefix}_KAFKA_BROKERS`).split(','),
+          },
+          consumer: { groupId: `${prefix.toLowerCase()}-consumer` },
+        },
+      } as unknown as ClientOptions;
     default:
       throw new Error(`Unknown transport: ${kind}`);
   }

package/templates/libs/storage-strategies/cloudinary/src/lib/__tests__/cloudinary-storage.contract.unit.test.ts

@@ -1,6 +1,5 @@
 import { runStorageContract } from '@icore/shared/testing';
-import { CloudinaryStorageStrategy } from '../cloudinary-storage.strategy.js';
-import { createMockCloudinary } from '../testing/mock-cloudinary.js';
+import { CloudinaryStorageStrategy, createMockCloudinary } from '@icore/storage-cloudinary';
 
 runStorageContract('CloudinaryStorageStrategy', () => {
   const api = createMockCloudinary();

package/templates/libs/storage-strategies/firebase/src/lib/__tests__/firebase-storage.contract.unit.test.ts

@@ -1,6 +1,5 @@
 import { runStorageContract } from '@icore/shared/testing';
-import { FirebaseStorageStrategy } from '../firebase-storage.strategy.js';
-import { createMockFirebaseBucket } from '../testing/mock-firebase-storage.js';
+import { FirebaseStorageStrategy, createMockFirebaseBucket } from '@icore/storage-firebase';
 
 runStorageContract('FirebaseStorageStrategy', () => {
   const bucket = createMockFirebaseBucket('icore-uploads');

package/templates/libs/storage-strategies/supabase/src/lib/__tests__/supabase-storage.contract.unit.test.ts

@@ -1,6 +1,5 @@
 import { runStorageContract } from '@icore/shared/testing';
-import { SupabaseStorageStrategy } from '../supabase-storage.strategy';
-import { createMockSupabaseStorageClient } from '../testing/mock-supabase-storage';
+import { SupabaseStorageStrategy, createMockSupabaseStorageClient } from '@icore/storage-supabase';
 
 runStorageContract('SupabaseStorageStrategy', () => {
   const client = createMockSupabaseStorageClient('icore-uploads');

package/templates/libs/vite-plugins/src/index.d.mts

@@ -1,5 +1,5 @@
-import type { Plugin } from 'vite';
-import type { UserConfig } from 'vitest/config';
+import type { Plugin, UserConfig } from 'vite';
+import type { TestUserConfig } from 'vitest/config';
 
 export declare function noServerModulesPlugin(): Plugin;
 
@@ -18,10 +18,8 @@ export declare function commonManualChunks(
 export declare function commonTestConfig(
   name: string,
   coverageDir: string,
-): NonNullable<UserConfig['test']>;
+): NonNullable<TestUserConfig['test']>;
 
-export declare function commonServer(
-  port: number,
-): NonNullable<import('vite').UserConfig['server']>;
+export declare function commonServer(port: number): NonNullable<UserConfig['server']>;
 
-export declare function apiInfoPlugin(opts?: { proxyTarget?: string }): import('vite').Plugin;
+export declare function apiInfoPlugin(opts?: { proxyTarget?: string }): Plugin;

package/templates/libs/vite-plugins/src/index.mjs

@@ -88,7 +88,7 @@ export function commonManualChunks(uiChunkFn) {
  *
  * @param {string} name  - project name (e.g. 'client-shadcn')
  * @param {string} coverageDir - relative path to coverage output dir
- * @returns {import('vitest/config').UserConfig['test']}
+ * @returns {import('vitest/config').TestUserConfig['test']}
  */
 export function commonTestConfig(name, coverageDir) {
   return {

package/templates/libs/vite-plugins/tsconfig.json

@@ -1,7 +1,8 @@
 {
   "extends": "../../tsconfig.base.json",
   "compilerOptions": {
-    "module": "commonjs",
+    "module": "esnext",
+    "moduleResolution": "bundler",
     "forceConsistentCasingInFileNames": true,
     "strict": true,
     "importHelpers": true,