@nextsparkjs/theme-default 0.1.0-beta.21 → 0.1.0-beta.24

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 NextSpark
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextsparkjs/theme-default",
-  "version": "0.1.0-beta.21",
+  "version": "0.1.0-beta.24",
   "private": false,
   "type": "module",
   "main": "./config/theme.config.ts",
@@ -9,7 +9,7 @@
   ],
   "dependencies": {},
   "peerDependencies": {
-    "@nextsparkjs/core": "workspace:*",
+    "@nextsparkjs/core": "0.1.0-beta.24",
     "@tanstack/react-query": "^5.0.0",
     "lucide-react": "^0.539.0",
     "next": "^15.0.0",
@@ -23,4 +23,4 @@
     "type": "theme",
     "name": "default"
   }
-}
+}

package/tests/cypress/support/e2e.ts

@@ -0,0 +1,89 @@
+/**
+ * Cypress E2E Support File for Theme
+ *
+ * This file is used when running tests in npm mode (outside monorepo).
+ * In monorepo mode, the core support file is used instead via cypress.config.ts.
+ *
+ * For documentation video commands, install cypress-slow-down:
+ *   pnpm add -D cypress-slow-down
+ *   Then uncomment the doc-commands import below.
+ */
+
+import '@testing-library/cypress/add-commands'
+
+// Import @cypress/grep for test filtering by tags
+import registerCypressGrep from '@cypress/grep'
+registerCypressGrep()
+
+// Doc commands are optional (require cypress-slow-down)
+// Uncomment if you have cypress-slow-down installed:
+// import './doc-commands'
+
+// Global error handling
+Cypress.on('uncaught:exception', (err) => {
+  // Ignore React hydration errors
+  if (err.message.includes('Hydration')) {
+    return false
+  }
+  // Ignore ResizeObserver errors
+  if (err.message.includes('ResizeObserver')) {
+    return false
+  }
+  return true
+})
+
+// Global before hook
+beforeEach(() => {
+  cy.clearCookies()
+  cy.clearLocalStorage()
+})
+
+// Type declarations for @cypress/grep and custom commands
+declare global {
+  namespace Cypress {
+    interface Chainable {
+      /**
+       * Custom command to make API requests with better error handling
+       */
+      apiRequest(options: Partial<Cypress.RequestOptions>): Chainable<Cypress.Response<any>>
+
+      /**
+       * Login command for authenticated tests
+       */
+      login(email: string, password: string): Chainable<void>
+    }
+    interface SuiteConfigOverrides {
+      tags?: string | string[]
+    }
+    interface TestConfigOverrides {
+      tags?: string | string[]
+    }
+  }
+}
+
+// Custom API request command
+Cypress.Commands.add('apiRequest', (options) => {
+  const defaultOptions = {
+    failOnStatusCode: false,
+    timeout: 15000,
+    headers: {
+      'Content-Type': 'application/json',
+      ...options.headers
+    }
+  }
+  return cy.request({
+    ...defaultOptions,
+    ...options
+  })
+})
+
+// Login command for authenticated tests
+Cypress.Commands.add('login', (email: string, password: string) => {
+  cy.session([email, password], () => {
+    cy.visit('/login')
+    cy.get('[data-testid="email-input"], input[name="email"]').type(email)
+    cy.get('[data-testid="password-input"], input[name="password"]').type(password)
+    cy.get('[data-testid="submit-button"], button[type="submit"]').click()
+    cy.url().should('include', '/dashboard')
+  })
+})

package/tests/cypress.config.ts

@@ -1,41 +1,55 @@
 /**
  * Cypress Configuration for Default Theme
  *
- * This config is theme-specific and used by scripts/cy.mjs.
+ * This config works in both monorepo and npm mode.
  * Run with: NEXT_PUBLIC_ACTIVE_THEME=default pnpm cy:open
  */
 
 import { defineConfig } from 'cypress'
 import path from 'path'
 import fs from 'fs'
+import { fileURLToPath } from 'url'
+
+// ESM-compatible __dirname
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
 
 // Paths relative to this config file
 const themeRoot = path.resolve(__dirname, '..')
 const projectRoot = path.resolve(__dirname, '../../../..')
 const narrationsOutputDir = path.join(__dirname, 'cypress/videos/narrations')
 
+// Detect if running in npm mode (no packages/core folder) vs monorepo
+const isNpmMode = !fs.existsSync(path.join(projectRoot, 'packages/core'))
+
 // Load environment variables
 import dotenv from 'dotenv'
 dotenv.config({ path: path.join(projectRoot, '.env') })
 
-// Server port (from .env or default 5173)
-const port = process.env.PORT || 5173
+// Server port (from .env or default 3000)
+const port = process.env.PORT || 3000
 
 export default defineConfig({
   e2e: {
     // Base URL for the application
     baseUrl: `http://localhost:${port}`,
 
-    // Spec patterns: core tests + theme tests
-    specPattern: [
-      // Core tests (always included)
-      path.join(projectRoot, 'packages/core/tests/cypress/e2e/core/**/*.cy.{js,ts}'),
-      // Theme-specific tests
-      path.join(__dirname, 'cypress/e2e/**/*.cy.{js,ts}'),
-    ],
-
-    // Support file (shared across themes)
-    supportFile: path.join(projectRoot, 'packages/core/tests/cypress/support/e2e.ts'),
+    // Spec patterns: theme tests (core tests only in monorepo)
+    specPattern: isNpmMode
+      ? [
+          // npm mode: only theme tests
+          path.join(__dirname, 'cypress/e2e/**/*.cy.{js,ts}'),
+        ]
+      : [
+          // Monorepo: core tests + theme tests
+          path.join(projectRoot, 'packages/core/tests/cypress/e2e/core/**/*.cy.{js,ts}'),
+          path.join(__dirname, 'cypress/e2e/**/*.cy.{js,ts}'),
+        ],
+
+    // Support file (theme-local in npm mode, core in monorepo)
+    supportFile: isNpmMode
+      ? path.join(__dirname, 'cypress/support/e2e.ts')
+      : path.join(projectRoot, 'packages/core/tests/cypress/support/e2e.ts'),
 
     // Fixtures folder (theme-specific)
     fixturesFolder: path.join(__dirname, 'cypress/fixtures'),
@@ -96,15 +110,16 @@ export default defineConfig({
       grepOmitFiltered: true,
     },
 
-    setupNodeEvents(on, config) {
+    async setupNodeEvents(on, config) {
       // Allure plugin setup (allure-cypress)
-      const { allureCypress } = require('allure-cypress/reporter')
+      const { allureCypress } = await import('allure-cypress/reporter')
       allureCypress(on, config, {
         resultsDir: path.join(__dirname, 'cypress/allure-results'),
       })
 
       // @cypress/grep plugin for test filtering by tags
-      require('@cypress/grep/src/plugin')(config)
+      const grepPlugin = await import('@cypress/grep/src/plugin.js')
+      ;(grepPlugin.default || grepPlugin)(config)
 
       // Documentation video tasks
       on('task', {

package/tests/jest/__mocks__/jose.js

@@ -0,0 +1,22 @@
+/**
+ * Mock for jose package
+ * Resolves ES module import issues in Jest tests
+ */
+
+module.exports = {
+  jwtVerify: jest.fn(),
+  SignJWT: jest.fn().mockImplementation(() => ({
+    setProtectedHeader: jest.fn().mockReturnThis(),
+    setIssuedAt: jest.fn().mockReturnThis(),
+    setExpirationTime: jest.fn().mockReturnThis(),
+    sign: jest.fn().mockResolvedValue('mock-jwt-token')
+  })),
+  importJWK: jest.fn(),
+  generateSecret: jest.fn(),
+  createRemoteJWKSet: jest.fn(),
+  errors: {
+    JWTExpired: class JWTExpired extends Error {},
+    JWTInvalid: class JWTInvalid extends Error {},
+    JWTClaimValidationFailed: class JWTClaimValidationFailed extends Error {}
+  }
+}

package/tests/jest/__mocks__/next-server.js

@@ -0,0 +1,56 @@
+/**
+ * Mock for next/server
+ * Provides NextRequest and NextResponse mocks for API testing
+ */
+
+class MockNextRequest {
+  constructor(url, options = {}) {
+    this.url = url
+    this.method = options.method || 'GET'
+    this.headers = new Map(Object.entries(options.headers || {}))
+    this._body = options.body
+  }
+
+  async json() {
+    if (!this._body) return {}
+    try {
+      return typeof this._body === 'string' ? JSON.parse(this._body) : this._body
+    } catch {
+      throw new SyntaxError('Invalid JSON')
+    }
+  }
+
+  async text() {
+    return this._body || ''
+  }
+}
+
+class MockNextResponse {
+  constructor(body, options = {}) {
+    this.body = body
+    this.status = options.status || 200
+    this.statusText = options.statusText || 'OK'
+    this.headers = new Map(Object.entries(options.headers || {}))
+  }
+
+  async json() {
+    if (!this.body) return {}
+    try {
+      return typeof this.body === 'string' ? JSON.parse(this.body) : this.body
+    } catch {
+      throw new SyntaxError('Invalid JSON')
+    }
+  }
+
+  static json(data, options = {}) {
+    return new MockNextResponse(data, {
+      ...options,
+      headers: { 'Content-Type': 'application/json', ...options.headers }
+    })
+  }
+}
+
+module.exports = {
+  NextRequest: MockNextRequest,
+  NextResponse: MockNextResponse
+}

package/tests/jest/jest.config.cjs

@@ -0,0 +1,127 @@
+/**
+ * Jest Configuration for Default Theme
+ *
+ * This config works in both monorepo and npm mode.
+ * Run with: pnpm test:theme
+ */
+
+const path = require('path')
+const fs = require('fs')
+
+// Paths relative to this config file
+const themeTestsRoot = __dirname
+const themeRoot = path.resolve(__dirname, '../..')
+
+// In monorepo: themes/default/tests/jest -> apps/dev (via symlink in contents/)
+// In npm mode: contents/themes/default/tests/jest -> project root (5 levels up)
+const monorepoRepoRoot = path.resolve(__dirname, '../../../..')
+const npmModeRoot = path.resolve(__dirname, '../../../../..')
+
+// Detect if running in npm mode (no packages/core folder) vs monorepo
+const isNpmMode = !fs.existsSync(path.join(monorepoRepoRoot, 'packages/core'))
+
+// In monorepo, use apps/dev as rootDir since contents/ symlinks to themes/
+const monorepoAppRoot = path.join(monorepoRepoRoot, 'apps/dev')
+const projectRoot = isNpmMode ? npmModeRoot : monorepoAppRoot
+
+// Module name mapper based on mode
+const moduleNameMapper = isNpmMode
+  ? {
+      // NPM mode: resolve from node_modules
+      '^@nextsparkjs/core/(.*)$': '@nextsparkjs/core/$1',
+      '^@nextsparkjs/core$': '@nextsparkjs/core',
+      '^@/contents/(.*)$': '<rootDir>/contents/$1',
+      '^@/entities/(.*)$': '<rootDir>/contents/entities/$1',
+      '^@/plugins/(.*)$': '<rootDir>/contents/plugins/$1',
+      '^@/themes/(.*)$': '<rootDir>/contents/themes/$1',
+      '^@/(.*)$': '<rootDir>/$1',
+      // Mocks from theme-local folder
+      'next/server': path.join(themeTestsRoot, '__mocks__/next-server.js'),
+      '^jose$': path.join(themeTestsRoot, '__mocks__/jose.js'),
+      '^jose/(.*)$': path.join(themeTestsRoot, '__mocks__/jose.js'),
+    }
+  : {
+      // Monorepo mode: resolve from packages/core/src (rootDir is apps/dev)
+      '^@nextsparkjs/core/(.*)$': '<rootDir>/../../packages/core/src/$1',
+      '^@nextsparkjs/core$': '<rootDir>/../../packages/core/src',
+      '^@/contents/(.*)$': '<rootDir>/contents/$1',
+      '^@/entities/(.*)$': '<rootDir>/contents/entities/$1',
+      '^@/plugins/(.*)$': '<rootDir>/contents/plugins/$1',
+      '^@/themes/(.*)$': '<rootDir>/contents/themes/$1',
+      '^@/(.*)$': '<rootDir>/$1',
+      // Mocks from core
+      'next/server': '<rootDir>/../../packages/core/tests/jest/__mocks__/next-server.js',
+      '^jose$': '<rootDir>/../../packages/core/tests/jest/__mocks__/jose.js',
+      '^jose/(.*)$': '<rootDir>/../../packages/core/tests/jest/__mocks__/jose.js',
+    }
+
+// Setup files based on mode
+const setupFilesAfterEnv = isNpmMode
+  ? [
+      // NPM mode: use theme's local setup only (it includes everything needed)
+      path.join(themeTestsRoot, 'setup.ts'),
+    ]
+  : [
+      // Monorepo mode: use local core setup (rootDir is apps/dev)
+      '<rootDir>/../../packages/core/tests/jest/setup.ts',
+    ]
+
+/** @type {import('jest').Config} */
+module.exports = {
+  displayName: 'theme-default',
+  rootDir: projectRoot,
+
+  // Use roots to explicitly set test location (handles symlinks better)
+  roots: [themeTestsRoot],
+
+  // Test file patterns
+  testMatch: [
+    '**/*.{test,spec}.{js,ts,tsx}',
+  ],
+  testPathIgnorePatterns: [
+    '<rootDir>/node_modules/',
+    '<rootDir>/.next/',
+  ],
+
+  // Preset and environment
+  preset: 'ts-jest',
+  testEnvironment: 'jsdom',
+
+  // Module resolution
+  moduleNameMapper,
+
+  // Setup files
+  setupFilesAfterEnv,
+
+  // Transform configuration
+  transform: {
+    '^.+\\.(ts|tsx)$': ['ts-jest', {
+      tsconfig: path.join(projectRoot, 'tsconfig.json'),
+    }],
+  },
+
+  // Transform ignore patterns - allow TypeScript from core's jest-setup
+  transformIgnorePatterns: [
+    'node_modules/(?!(uncrypto|better-auth|@noble|.*jose.*|remark.*|unified.*|@nextsparkjs/core/tests|.*\\.mjs$))',
+    'node_modules/\\.pnpm/(?!(.*uncrypto.*|.*better-auth.*|.*@noble.*|.*jose.*|.*remark.*|.*unified.*|@nextsparkjs.*core.*tests|.*\\.mjs$))',
+  ],
+
+  // File extensions
+  moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json'],
+
+  // Test timeout
+  testTimeout: 10000,
+
+  // Verbose output
+  verbose: true,
+
+  // Force exit after tests complete
+  forceExit: true,
+
+  // Disable watchman for symlink support
+  watchman: false,
+
+  // Coverage output directory
+  coverageDirectory: path.join(themeTestsRoot, 'coverage'),
+  coverageReporters: ['text', 'lcov', 'html'],
+}