@latte-macchiat-io/latte-payload 1.0.1

package/tests/unit/utils/slugify.spec.ts

@@ -0,0 +1,185 @@
+import { describe, expect, it } from 'vitest';
+import { slugify } from '@/utils/slugify';
+
+describe('slugify utility', () => {
+  describe('basic functionality', () => {
+    it('should convert string to lowercase slug', () => {
+      expect(slugify('Hello World')).toBe('hello-world');
+    });
+
+    it('should handle empty strings', () => {
+      expect(slugify('')).toBe('');
+    });
+
+    it('should handle undefined (uses default empty string)', () => {
+      expect(slugify(undefined as any)).toBe('');
+    });
+
+    it('should trim whitespace by default', () => {
+      expect(slugify('  hello  ')).toBe('hello');
+    });
+
+    it('should replace spaces with hyphens', () => {
+      expect(slugify('hello world test')).toBe('hello-world-test');
+    });
+
+    it('should handle multiple consecutive spaces', () => {
+      expect(slugify('hello    world')).toBe('hello-world');
+    });
+  });
+
+  describe('special character removal', () => {
+    it('should remove question marks', () => {
+      expect(slugify('Hello?')).toBe('hello');
+    });
+
+    it('should remove exclamation marks', () => {
+      expect(slugify('Hello!')).toBe('hello');
+    });
+
+    it('should remove parentheses', () => {
+      expect(slugify('Hello (World)')).toBe('hello-world');
+    });
+
+    it('should remove quotes', () => {
+      expect(slugify('Hello \'World\' "Test"')).toBe('hello-world-test');
+    });
+
+    it('should remove or replace special characters', () => {
+      expect(slugify('a*b+c~d.e(f)g\'h"i!j:k@l')).toBe('abcdefghijkl');
+      // Note: slugify converts some chars to words (< = less, > = greater, & = and, | = or, % = percent, $ = dollar)
+      const result = slugify('a<b>c&d|e%f$g');
+      expect(result).toContain('a');
+      expect(result).toContain('g');
+      // Just verify it's a valid slug
+      expect(result).toMatch(/^[a-z0-9-]+$/);
+    });
+
+    it('should keep alphanumeric characters', () => {
+      expect(slugify('abc123xyz')).toBe('abc123xyz');
+    });
+
+    it('should handle accented characters', () => {
+      expect(slugify('Café')).toBe('cafe');
+      expect(slugify('naïve')).toBe('naive');
+    });
+  });
+
+  describe('options: trim', () => {
+    it('should trim when trim is true', () => {
+      expect(slugify('  hello  ', { trim: true })).toBe('hello');
+    });
+
+    it('should not trim when trim is false', () => {
+      const result = slugify('  hello  ', { trim: false });
+      expect(result).not.toBe('hello');
+      expect(result).toMatch(/hello/);
+    });
+
+    it('should trim by default', () => {
+      expect(slugify('  hello  ')).toBe('hello');
+    });
+  });
+
+  describe('options: lower', () => {
+    it('should convert to lowercase when lower is true', () => {
+      expect(slugify('HELLO WORLD', { lower: true })).toBe('hello-world');
+    });
+
+    it('should preserve case when lower is false', () => {
+      expect(slugify('HELLO WORLD', { lower: false })).toBe('HELLO-WORLD');
+    });
+
+    it('should convert to lowercase by default', () => {
+      expect(slugify('HELLO WORLD')).toBe('hello-world');
+    });
+  });
+
+  describe('options: locale', () => {
+    it('should handle French locale', () => {
+      expect(slugify('Café', { locale: 'fr' })).toBe('cafe');
+    });
+
+    it('should handle German locale with umlauts', () => {
+      // Note: slugify may transliterate differently depending on locale
+      const result = slugify('Über', { locale: 'de' });
+      expect(result).toMatch(/^(uber|ueber)$/); // Can be either depending on transliteration
+    });
+
+    it('should work without locale option', () => {
+      expect(slugify('Café')).toBe('cafe');
+    });
+  });
+
+  describe('options: remove (custom removal pattern)', () => {
+    it('should use custom remove pattern', () => {
+      // The remove option removes characters before slugification
+      const result = slugify('a@b#c', { remove: /@/g });
+      expect(result).toContain('b');
+      expect(result).not.toContain('@');
+      // Note: custom remove doesn't override default behavior, it adds to it
+      // The # may or may not be present depending on how the library processes it
+    });
+
+    it('should remove multiple custom characters', () => {
+      const result = slugify('a@b@c', { remove: /@/g });
+      expect(result).not.toContain('@');
+      expect(result).toMatch(/^[a-z0-9-]+$/);
+    });
+
+    it('should remove specified pattern', () => {
+      // Custom remove pattern removes the specified characters
+      const result = slugify('a@b#c', { remove: /@/g });
+      expect(result).not.toContain('@');
+      // # is handled by default remove pattern
+    });
+  });
+
+  describe('combined options', () => {
+    it('should handle multiple options together', () => {
+      expect(
+        slugify('  Café WORLD!  ', {
+          trim: true,
+          lower: true,
+          locale: 'fr',
+        })
+      ).toBe('cafe-world');
+    });
+
+    it('should handle trim=false and lower=false', () => {
+      const result = slugify('  HELLO  ', { trim: false, lower: false });
+      expect(result).toMatch(/HELLO/);
+    });
+  });
+
+  describe('edge cases', () => {
+    it('should handle single character', () => {
+      expect(slugify('a')).toBe('a');
+    });
+
+    it('should handle numbers only', () => {
+      expect(slugify('123')).toBe('123');
+    });
+
+    it('should handle hyphenated strings', () => {
+      expect(slugify('hello-world')).toBe('hello-world');
+    });
+
+    it('should handle underscores', () => {
+      expect(slugify('hello_world')).toBe('hello_world');
+    });
+
+    it('should handle mixed case with numbers', () => {
+      expect(slugify('Test123ABC')).toBe('test123abc');
+    });
+
+    it('should handle strings with only special characters', () => {
+      expect(slugify('!!!')).toBe('');
+    });
+
+    it('should handle long strings', () => {
+      const long = 'a'.repeat(100);
+      expect(slugify(long)).toBe(long);
+    });
+  });
+});

package/tsconfig.json

@@ -0,0 +1,31 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "allowJs": true,
+    "checkJs": false,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "jsx": "react-jsx",
+    "types": ["node"],
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/typedoc.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://typedoc.org/schema.json",
+  "name": "@latte-macchiat-io/latte-payload",
+  "entryPoints": ["src/index.ts"],
+  "out": "docs",
+  "readme": "README.md",
+  "tsconfig": "tsconfig.json",
+  "exclude": [
+    "**/*.spec.ts",
+    "**/*.test.ts",
+    "**/node_modules/**",
+    "**/dist/**",
+    "**/tests/**"
+  ],
+  "excludePrivate": true,
+  "excludeProtected": false,
+  "excludeInternal": true,
+  "includeVersion": true,
+  "sort": ["source-order"],
+  "categorizeByGroup": true,
+  "categoryOrder": [
+    "Collections",
+    "Globals",
+    "Access Control",
+    "Utilities",
+    "Components",
+    "Tasks",
+    "Types",
+    "*"
+  ],
+  "navigation": {
+    "includeCategories": true,
+    "includeGroups": true
+  },
+  "theme": "default",
+  "githubPages": false,
+  "hideGenerator": false,
+  "searchInComments": true,
+  "searchInDocuments": true
+}

package/vitest.config.ts

@@ -0,0 +1,31 @@
+import { defineConfig } from 'vitest/config';
+import path from 'path';
+
+export default defineConfig({
+  test: {
+    name: 'latte-payload-unit',
+    globals: true,
+    environment: 'node',
+    setupFiles: ['./tests/setup.ts'],
+    include: ['tests/unit/**/*.spec.ts'],
+    exclude: ['**/node_modules/**', '**/dist/**'],
+    coverage: {
+      provider: 'v8',
+      reporter: ['text', 'json', 'html', 'lcov'],
+      reportsDirectory: './coverage',
+      include: ['src/**/*.ts', 'src/**/*.tsx'],
+      exclude: ['src/**/*.d.ts', 'src/**/index.ts', 'src/types/**'],
+      thresholds: {
+        lines: 60,
+        functions: 60,
+        branches: 60,
+        statements: 60,
+      },
+    },
+  },
+  resolve: {
+    alias: {
+      '@': path.resolve(__dirname, './src'),
+    },
+  },
+});

package/vitest.integration.config.ts

@@ -0,0 +1,27 @@
+import { defineConfig } from 'vitest/config';
+import path from 'path';
+
+export default defineConfig({
+  test: {
+    name: 'latte-payload-integration',
+    globals: true,
+    environment: 'node',
+    setupFiles: ['./tests/setup.integration.ts'],
+    include: ['tests/integration/**/*.int.spec.ts'],
+    exclude: ['**/node_modules/**', '**/dist/**'],
+    testTimeout: 90000, // 90 seconds for Payload operations
+    hookTimeout: 90000,
+    fileParallelism: false, // Sequential execution for database tests
+    pool: 'forks',
+    poolOptions: {
+      forks: {
+        singleFork: true, // Single process to avoid database conflicts
+      },
+    },
+  },
+  resolve: {
+    alias: {
+      '@': path.resolve(__dirname, './src'),
+    },
+  },
+});