@pasosdejesus/m 0.15.0

package/dist/templates/apps/nextjs/package.json.hbs

@@ -0,0 +1,48 @@
+
+{
+  "name": "{{name}}",
+  "version": "0.0.0",
+  "description": "{{description}}",
+  "type": "module",
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint",
+    "test": "dotenv -e ../.env.test -- vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "@pasosdejesus/m": "gitlab:pasosdejesus/m",
+    "dotenv": "^17.4.2",
+    "kysely-postgres-js": "3.0.0",
+    "next": "15.5.12",
+    "pg": "8.17.2",
+    "react": "19.2.7",
+    "react-dom": "19.2.7"
+  },
+  "devDependencies": {
+    "@testing-library/react": "16.3.2",
+    "@types/node": "20.19.30",
+    "@types/react": "^19.2.15",
+    "@types/react-dom": "^19.2.3",
+    "autoprefixer": "^10.5.0",
+    "dotenv-cli": "^7.4.4",
+    "jsdom": "^29.1.1",
+    "kysely": "0.27.6",
+    "kysely-codegen": "0.19.0",
+    "kysely-ctl": "0.20.0",
+    "next-auth": "4.24.13",
+    "postcss": "^8.5.15",
+    "siwe": "2.3.2",
+    "tailwindcss": "3.4.19",
+    "typescript": "5.9.3",
+    "viem": "^2.51.0",
+    "vitest": "2.1.9",
+    "wagmi": "2.19.5"
+  },
+  "packageManager": "pnpm@10.34.5"
+}

package/dist/templates/apps/nextjs/pnpm-workspace.yaml

@@ -0,0 +1,13 @@
+allowBuilds:
+  '@pasosdejesus/m': true
+  bufferutil: true
+  esbuild: true
+  keccak: true
+  sharp: true
+  utf-8-validate: true
+
+overrides:
+  '@parcel/watcher': npm:@parcel/watcher-wasm
+  rollup: npm:@rollup/wasm-node
+  lightningcss: npm:lightningcss-wasm
+  '@tailwindcss/oxide': npm:@tailwindcss/oxide-wasm32-wasi

package/dist/templates/apps/nextjs/postcss.config.mjs

@@ -0,0 +1,6 @@
+export default {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {},
+  },
+};

package/dist/templates/apps/nextjs/tailwind.config.js

@@ -0,0 +1,11 @@
+/** @type {import('tailwindcss').Config} */
+export default {
+  content: [
+    "./app/**/*.{js,ts,jsx,tsx,mdx}",
+    "./src/**/*.{js,ts,jsx,tsx,mdx}",
+  ],
+  theme: {
+    extend: {},
+  },
+  plugins: [],
+};

package/dist/templates/apps/nextjs/tests/helpers.ts

@@ -0,0 +1,31 @@
+import { execSync } from 'child_process';
+
+/**
+ * Check if psql command is available in the system PATH
+ * @returns boolean true if psql is available, false otherwise
+ */
+export function psqlAvailable(): boolean {
+  try {
+    execSync('which psql', { stdio: 'ignore' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Check if all prerequisites for database integration tests are met:
+ * 1. PostgreSQL superuser credentials are configured in environment
+ * 2. psql command-line tool is available in PATH
+ * @returns boolean true if database tests can run, false otherwise
+ */
+export function canRunDbTests(): boolean {
+  const superuserConfigured = process.env.PG_SUPERUSER && process.env.PG_SUPERUSER_PASSWORD !== undefined;
+  return superuserConfigured && psqlAvailable();
+}
+
+/**
+ * Skip condition for database integration tests
+ * Use as: const dbTest = canRunDbTests() ? describe : describe.skip;
+ */
+export const dbTest = canRunDbTests() ? describe : describe.skip;

package/dist/templates/apps/nextjs/tests/index.test.ts

@@ -0,0 +1,7 @@
+import { describe, it, expect } from 'vitest';
+
+describe('Example Suite', () => {
+  it('should pass this example test', () => {
+    expect(true).toBe(true);
+  });
+});

package/dist/templates/apps/nextjs/tests/setup-env.ts.hbs

@@ -0,0 +1,8 @@
+import dotenv from 'dotenv';
+import path from 'path';
+
+const testdir = process.env.TEST_DIR || 'tests/ordered';
+const envPath = path.resolve(process.cwd(), '.env.test');
+dotenv.config({ path: envPath });
+
+console.log(`Usando entorno de ${envPath}`);

package/dist/templates/apps/nextjs/tests/test-utils.example.test.ts

@@ -0,0 +1,168 @@
+/**
+ * Example test file demonstrating how to use @pasosdejesus/m test-utils
+ *
+ * This file shows practical examples of mocking different parts of a Next.js + Hardhat application.
+ * Include it in your project as a reference when writing tests.
+ *
+ * "Y todo lo que hagáis, hacedlo de corazón, como para el Señor y no para los hombres" (Colosenses 3:23)
+ */
+
+import { describe, it, expect, beforeEach, beforeAll, afterAll, vi } from 'vitest';
+import { createFsMocks } from '@pasosdejesus/m/test-utils/fs-mocks';
+import { createMockKysely } from '@pasosdejesus/m/test-utils/kysely-mocks';
+import { createAuthMocks } from '@pasosdejesus/m/test-utils/rainbowkit-mocks';
+import { viemMocks } from '@pasosdejesus/m/test-utils/viem-mocks';
+// radix-mocks is a side-effect import that mocks radix-ui components globally
+import '@pasosdejesus/m/test-utils/radix-mocks';
+
+describe('Example: Using test-utils in your project', () => {
+  // Example 1: Mocking filesystem operations
+  describe('fs-mocks: Mocking filesystem', () => {
+    let fsMocks;
+
+    beforeAll(() => {
+      fsMocks = createFsMocks();
+      fsMocks.setupFsMocks();
+    });
+
+    afterAll(() => {
+      vi.clearAllMocks();
+    });
+
+    it('should mock readFile operations', () => {
+      // Setup mock to return specific content
+      fsMocks.mockReadFile.mockResolvedValue('{"data": "test"}');
+
+      // In your actual code, this would be called by the function you're testing
+      // Example: await readFile('/config.json', 'utf-8')
+      // The mock will return the content we set above
+      expect(fsMocks.mockReadFile).toBeDefined();
+    });
+
+    it('should mock readFile with custom content', () => {
+      const customFsMocks = createFsMocks({
+        readFileContent: '# Custom content',
+      });
+      // The mock is already configured with the custom content
+      expect(customFsMocks.mockReadFile).toBeDefined();
+    });
+  });
+
+  // Example 2: Mocking database operations with Kysely
+  describe('kysely-mocks: Mocking database queries', () => {
+    let dbMocks;
+
+    beforeAll(() => {
+      dbMocks = createMockKysely();
+      dbMocks.setupMocks();
+      dbMocks.setupCommonResponses();
+    });
+
+    it('should mock SELECT queries', () => {
+      // Configure mock to return specific data
+      dbMocks.mockExecuteTakeFirst.mockResolvedValue({ id: 1, name: 'John' });
+
+      // In your actual code, when a Kysely query executes, it will use the mock
+      // Example: await db.selectFrom('users').selectAll().executeTakeFirst()
+      // The mock will return { id: 1, name: 'John' }
+      expect(dbMocks.mockExecuteTakeFirst).toBeDefined();
+    });
+
+    it('should mock INSERT queries', () => {
+      dbMocks.mockExecute.mockResolvedValue([{ id: 3, name: 'Bob' }]);
+      expect(dbMocks.mockExecute).toBeDefined();
+    });
+  });
+
+  // Example 3: Mocking authentication and wallet state
+  describe('rainbowkit-mocks: Mocking authentication', () => {
+    let authMocks;
+
+    beforeAll(() => {
+      authMocks = createAuthMocks({
+        address: '0x1234567890123456789012345678901234567890',
+        isConnected: true,
+        chainId: 1,
+      });
+      authMocks.setupMocks();
+      authMocks.setupDefaultImplementations();
+    });
+
+    it('should mock useAccount hook', () => {
+      // The mock is already configured with the address above
+      // In your React component test, useAccount() will return the mocked data
+      expect(authMocks.mocks.mockUseAccount).toBeDefined();
+    });
+
+    it('should mock useSession hook', () => {
+      expect(authMocks.mocks.mockUseSession).toBeDefined();
+    });
+
+    it('should update configuration dynamically', () => {
+      authMocks.updateConfig({ isConnected: false });
+      // Now useAccount() will return isConnected: false
+      expect(authMocks.updateConfig).toBeDefined();
+    });
+  });
+
+  // Example 4: Mocking blockchain interactions
+  describe('viem-mocks: Mocking blockchain', () => {
+    beforeAll(() => {
+      // viemMocks are already defined, no setup needed
+    });
+
+    it('should mock public client', () => {
+      // Configure the mock
+      viemMocks.createPublicClient.mockReturnValue({
+        getBlockNumber: vi.fn().mockResolvedValue(123456n),
+      });
+
+      const client = viemMocks.createPublicClient();
+      expect(client.getBlockNumber).toBeDefined();
+      expect(viemMocks.createPublicClient).toHaveBeenCalled();
+    });
+
+    it('should mock wallet client', () => {
+      viemMocks.createWalletClient.mockReturnValue({
+        sendTransaction: vi.fn().mockResolvedValue('0xabc...'),
+      });
+
+      const client = viemMocks.createWalletClient();
+      expect(client.sendTransaction).toBeDefined();
+    });
+  });
+
+  // Example 5: Cleanup and teardown
+  describe('Setup and teardown patterns', () => {
+    let fsMocks;
+
+    beforeEach(() => {
+      fsMocks = createFsMocks();
+      fsMocks.setupFsMocks();
+    });
+
+    afterEach(() => {
+      vi.clearAllMocks();
+    });
+
+    it('should demonstrate proper mock cleanup', () => {
+      fsMocks.mockReadFile.mockResolvedValue('test');
+      // Test that mock can be called
+      expect(fsMocks.mockReadFile).toBeDefined();
+    });
+  });
+});
+
+// Helper: TypeScript types for the mocks (for reference)
+/**
+ * Type imports for reference (not executed):
+ *
+ * import type {
+ *   FsMocks,
+ *   MockKysely,
+ *   AuthMocks,
+ *   ViemMocks
+ * } from '@pasosdejesus/m/test-utils';
+ *
+ * These types are automatically available when you import the mocks.
+ */

package/dist/templates/apps/nextjs/tsconfig.json

@@ -0,0 +1,44 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "outDir": "./dist",
+    "rootDir": ".",
+    "baseUrl": ".",
+    "paths": {
+      "@/*": [
+        "./*"
+      ]
+    },
+    "lib": [
+      "dom",
+      "dom.iterable",
+      "esnext"
+    ],
+    "allowJs": true,
+    "noEmit": true,
+    "incremental": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ]
+  },
+  "include": [
+    "src/**/*.ts",
+    "app/**/*.ts",
+    "app/**/*.tsx",
+    ".next/types/**/*.ts"
+  ],
+  "exclude": [
+    "node_modules"
+  ]
+}

package/dist/templates/apps/nextjs/tsconfig.test.json

@@ -0,0 +1,38 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./*"]
+    },
+    "types": ["@testing-library/jest-dom", "vitest", "vitest/globals"]
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    "types/**/*.d.ts",
+    "**/*.test.ts",
+    "**/*.test.tsx",
+    "vitest.setup.ts"
+  ],
+  "exclude": [
+    "node_modules"
+  ]
+}

package/dist/templates/apps/nextjs/vitest.config.ts

@@ -0,0 +1,13 @@
+/// <reference types="vitest" />
+import { defineConfig } from 'vitest/config';
+
+const conditions = ['module-sync'];
+if (process.platform === 'openbsd') conditions.push('wasm');
+
+export default defineConfig({
+  test: {
+    globals: true,
+    restoreMocks: true,
+  },
+  resolve: { conditions },
+});

package/dist/test-utils/fs-mocks.d.ts

@@ -0,0 +1,32 @@
+/**
+ * File system mocking utilities for tests
+ *
+ * "Y todo lo que hagáis, hacedlo de corazón, como para el Señor y no para los hombres" (Colosenses 3:23)
+ */
+/**
+ * Creates mocks for fs/promises and node:fs/promises modules
+ *
+ * @param options Configuration options
+ * @returns Object with mock functions and setup/cleanup utilities
+ */
+export declare function createFsMocks(options?: {
+    readFileContent?: string;
+    readFileError?: Error;
+}): {
+    mockReadFile: import("vitest").Mock<(...args: any[]) => any>;
+    mockNodeReadFile: import("vitest").Mock<(...args: any[]) => any>;
+    /**
+     * Setup vi.mock calls for fs modules
+     * Call this in your test file's setup
+     */
+    setupFsMocks(): void;
+    /**
+     * Reset all mock implementations
+     */
+    resetFsMocks(): void;
+    /**
+     * Set common responses for fs mocks
+     */
+    setupCommonResponses(): void;
+};
+//# sourceMappingURL=fs-mocks.d.ts.map

package/dist/test-utils/fs-mocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-mocks.d.ts","sourceRoot":"","sources":["../../src/test-utils/fs-mocks.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE;IACrC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,aAAa,CAAC,EAAE,KAAK,CAAA;CACjB;;;IAsBF;;;OAGG;;IAeH;;OAEG;;IAMH;;OAEG;;EAMN"}

package/dist/test-utils/fs-mocks.js

@@ -0,0 +1,63 @@
+/**
+ * File system mocking utilities for tests
+ *
+ * "Y todo lo que hagáis, hacedlo de corazón, como para el Señor y no para los hombres" (Colosenses 3:23)
+ */
+import { vi } from 'vitest';
+/**
+ * Creates mocks for fs/promises and node:fs/promises modules
+ *
+ * @param options Configuration options
+ * @returns Object with mock functions and setup/cleanup utilities
+ */
+export function createFsMocks(options = {}) {
+    const mockReadFile = vi.hoisted(() => vi.fn());
+    const mockNodeReadFile = vi.hoisted(() => vi.fn());
+    // Apply default implementations
+    if (options.readFileContent !== undefined) {
+        mockReadFile.mockResolvedValue(options.readFileContent);
+        mockNodeReadFile.mockResolvedValue(options.readFileContent);
+    }
+    else {
+        mockReadFile.mockResolvedValue('# Crossword Source\n\nTexto con blanks');
+        mockNodeReadFile.mockResolvedValue('# Crossword Source (node namespace)');
+    }
+    if (options.readFileError !== undefined) {
+        mockReadFile.mockRejectedValue(options.readFileError);
+        mockNodeReadFile.mockRejectedValue(options.readFileError);
+    }
+    return {
+        mockReadFile,
+        mockNodeReadFile,
+        /**
+         * Setup vi.mock calls for fs modules
+         * Call this in your test file's setup
+         */
+        setupFsMocks() {
+            vi.mock('fs/promises', async (importOriginal) => {
+                const actual = await importOriginal();
+                return {
+                    ...actual,
+                    readFile: mockReadFile,
+                };
+            });
+            vi.mock('node:fs/promises', () => ({
+                readFile: mockNodeReadFile,
+            }));
+        },
+        /**
+         * Reset all mock implementations
+         */
+        resetFsMocks() {
+            mockReadFile.mockReset();
+            mockNodeReadFile.mockReset();
+        },
+        /**
+         * Set common responses for fs mocks
+         */
+        setupCommonResponses() {
+            mockReadFile.mockResolvedValue('# Crossword Source\n\nTexto con blanks');
+            mockNodeReadFile.mockResolvedValue('# Crossword Source (node namespace)');
+        },
+    };
+}

package/dist/test-utils/i18n-mock.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Reusable mock for createComponentT from @pasosdejesus/m/i18n
+ *
+ * Usage in tests:
+ *
+ *   import { mockCreateComponentT } from '@pasosdejesus/m/test-utils/i18n-mock'
+ *   vi.mock('@/lib/hooks/useTranslation', () => ({ createComponentT: mockCreateComponentT }))
+ *
+ * This mock always returns English translations by default, so tests
+ * can check for 'Edit Profile', 'Save', etc. without modification.
+ *
+ * To test Spanish translations, pass a locale:
+ *
+ *   vi.mock('@/lib/hooks/useTranslation', () => ({
+ *     createComponentT: (lang: string) => mockCreateComponentT(lang),
+ *   }))
+ *   // mockCreateComponentT will use the actual translations object
+ *   // passed by the component, resolving to the correct locale
+ */
+export declare function mockCreateComponentT(locale?: string): (lang: string, translations: Record<string, Record<string, string>>) => (key: string, ...args: string[]) => string;
+//# sourceMappingURL=i18n-mock.d.ts.map

package/dist/test-utils/i18n-mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-mock.d.ts","sourceRoot":"","sources":["../../src/test-utils/i18n-mock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,MAAM,IAC1C,MAAM,MAAM,EAAE,cAAc,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,MAEhE,KAAK,MAAM,EAAE,GAAG,MAAM,MAAM,EAAE,YAMzC"}

package/dist/test-utils/i18n-mock.js

@@ -0,0 +1,29 @@
+/**
+ * Reusable mock for createComponentT from @pasosdejesus/m/i18n
+ *
+ * Usage in tests:
+ *
+ *   import { mockCreateComponentT } from '@pasosdejesus/m/test-utils/i18n-mock'
+ *   vi.mock('@/lib/hooks/useTranslation', () => ({ createComponentT: mockCreateComponentT }))
+ *
+ * This mock always returns English translations by default, so tests
+ * can check for 'Edit Profile', 'Save', etc. without modification.
+ *
+ * To test Spanish translations, pass a locale:
+ *
+ *   vi.mock('@/lib/hooks/useTranslation', () => ({
+ *     createComponentT: (lang: string) => mockCreateComponentT(lang),
+ *   }))
+ *   // mockCreateComponentT will use the actual translations object
+ *   // passed by the component, resolving to the correct locale
+ */
+export function mockCreateComponentT(locale) {
+    return (lang, translations) => {
+        const dict = translations[locale || lang || 'en'] || translations.en || {};
+        return (key, ...args) => {
+            let val = dict[key] || key;
+            args.forEach((arg, i) => { val = val.replace(`{{${i}}}`, arg); });
+            return val;
+        };
+    };
+}

package/dist/test-utils/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Common mocking utilities re-export index
+ *
+ * "Y todo lo que hagáis, hacedlo de corazón, como para el Señor y no para los hombres" (Colosenses 3:23)
+ */
+export * from './fs-mocks.js';
+export * from './kysely-mocks.js';
+export * from './radix-mocks.js';
+export * from './rainbowkit-mocks.js';
+export * from './viem-mocks.js';
+export * from './i18n-mock.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/test-utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/test-utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,cAAc,uBAAuB,CAAA;AACrC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA"}

package/dist/test-utils/index.js

@@ -0,0 +1,11 @@
+/**
+ * Common mocking utilities re-export index
+ *
+ * "Y todo lo que hagáis, hacedlo de corazón, como para el Señor y no para los hombres" (Colosenses 3:23)
+ */
+export * from './fs-mocks.js';
+export * from './kysely-mocks.js';
+export * from './radix-mocks.js';
+export * from './rainbowkit-mocks.js';
+export * from './viem-mocks.js';
+export * from './i18n-mock.js';