@12-apps/forms-core 1.4.0 → 1.4.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@12-apps/forms-core",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "license": "MIT",
   "type": "module",
   "description": "Pure, framework-agnostic form primitives — field validators, the Result type, and createServerAction. Zero dependencies, consumed from source by @12-apps/ui and apps.",
@@ -15,7 +15,7 @@
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
-    "@12-apps/typescript-config": "^1.5.0",
+    "@12-apps/typescript-config": "^1.5.2",
     "typescript": "^5.9.2",
     "vitest": "^3.2.4"
   },
@@ -34,6 +34,14 @@
     "prisma",
     "*.js",
     "*.mjs",
-    "*.md"
+    "*.md",
+    "!eslint.config.js",
+    "!**/__tests__/**",
+    "!**/tests/**",
+    "!**/*.test.*",
+    "!**/*.spec.*",
+    "!**/*.stories.*",
+    "!**/*.test-story.*",
+    "!**/test-helpers.*"
   ]
 }

package/src/br.spec.ts

@@ -1,173 +0,0 @@
-import { describe, expect, it } from 'vitest';
-
-import {
-  cep,
-  CEP_PATTERN,
-  cepDigits,
-  cnpj,
-  cnpjChars,
-  formatCep,
-  formatCnpj,
-  isUf,
-  isValidCep,
-  isValidCnpj,
-  UF_LIST,
-} from './br';
-
-/**
- * `11.222.333/0001-81` is the canonical all-numeric fixture; `12.ABC.345/01DE-35`
- * is Receita Federal's own alphanumeric example (IN 2.229/2024).
- */
-const VALID_NUMERIC = '11.222.333/0001-81';
-const VALID_ALPHANUMERIC = '12.ABC.345/01DE-35';
-
-describe('forms-core/br', () => {
-  describe('UF_LIST / isUf', () => {
-    it('holds the 27 federative units', () => {
-      expect(UF_LIST).toHaveLength(27);
-      expect(new Set(UF_LIST).size).toBe(27);
-    });
-
-    it('accepts a real UF and rejects anything else', () => {
-      expect(isUf('SP')).toBe(true);
-      expect(isUf('sp')).toBe(false);
-      expect(isUf('XX')).toBe(false);
-    });
-  });
-
-  describe('cepDigits', () => {
-    it('keeps only digits, capped at eight', () => {
-      expect(cepDigits('01310-100')).toBe('01310100');
-      expect(cepDigits('01310100999')).toBe('01310100');
-      expect(cepDigits('abc')).toBe('');
-    });
-  });
-
-  describe('formatCep', () => {
-    it('inserts the hyphen once the sixth digit arrives', () => {
-      expect(formatCep('01310')).toBe('01310');
-      expect(formatCep('013101')).toBe('01310-1');
-      expect(formatCep('01310100')).toBe('01310-100');
-    });
-
-    it('is idempotent and forgiving of messy input', () => {
-      expect(formatCep(formatCep('01310100'))).toBe('01310-100');
-      expect(formatCep('01.310-100')).toBe('01310-100');
-    });
-
-    it('produces a value matching CEP_PATTERN once complete', () => {
-      expect(CEP_PATTERN.test(formatCep('01310100'))).toBe(true);
-    });
-  });
-
-  describe('isValidCep', () => {
-    it('accepts a complete CEP in either shape', () => {
-      expect(isValidCep('01310100')).toBe(true);
-      expect(isValidCep('01310-100')).toBe(true);
-    });
-
-    it('rejects an incomplete or oversized CEP', () => {
-      expect(isValidCep('0131010')).toBe(false);
-      expect(isValidCep('')).toBe(false);
-    });
-  });
-
-  describe('cep validator', () => {
-    it('treats empty as valid (the field is optional)', () => {
-      expect(cep()('')).toBeUndefined();
-      expect(cep()('   ')).toBeUndefined();
-    });
-
-    it('returns a message for a malformed CEP', () => {
-      expect(cep()('123')).toBeTruthy();
-      expect(cep('Informe o CEP')('123')).toBe('Informe o CEP');
-    });
-
-    it('returns undefined for a well-formed CEP', () => {
-      expect(cep()('01310-100')).toBeUndefined();
-    });
-  });
-
-  describe('cnpjChars', () => {
-    it('strips punctuation, uppercases and keeps letters', () => {
-      expect(cnpjChars(VALID_NUMERIC)).toBe('11222333000181');
-      expect(cnpjChars('12.abc.345/01de-35')).toBe('12ABC34501DE35');
-    });
-
-    it('caps at fourteen characters', () => {
-      expect(cnpjChars('11222333000181999')).toHaveLength(14);
-    });
-  });
-
-  describe('formatCnpj', () => {
-    it('masks progressively as characters arrive', () => {
-      expect(formatCnpj('11')).toBe('11');
-      expect(formatCnpj('11222')).toBe('11.222');
-      expect(formatCnpj('11222333')).toBe('11.222.333');
-      expect(formatCnpj('112223330001')).toBe('11.222.333/0001');
-      expect(formatCnpj('11222333000181')).toBe(VALID_NUMERIC);
-    });
-
-    it('masks an alphanumeric CNPJ', () => {
-      expect(formatCnpj('12ABC34501DE35')).toBe(VALID_ALPHANUMERIC);
-      expect(formatCnpj('12abc34501de35')).toBe(VALID_ALPHANUMERIC);
-    });
-
-    it('is idempotent', () => {
-      expect(formatCnpj(VALID_NUMERIC)).toBe(VALID_NUMERIC);
-      expect(formatCnpj(VALID_ALPHANUMERIC)).toBe(VALID_ALPHANUMERIC);
-    });
-
-    it('never lets a letter into the check-digit positions', () => {
-      expect(formatCnpj('12ABC34501DEXY')).toBe('12.ABC.345/01DE-');
-    });
-  });
-
-  describe('isValidCnpj', () => {
-    it('accepts an all-numeric CNPJ, masked or bare', () => {
-      expect(isValidCnpj(VALID_NUMERIC)).toBe(true);
-      expect(isValidCnpj('11222333000181')).toBe(true);
-    });
-
-    it("accepts Receita Federal's alphanumeric example", () => {
-      expect(isValidCnpj(VALID_ALPHANUMERIC)).toBe(true);
-      expect(isValidCnpj('12abc34501de35')).toBe(true);
-    });
-
-    it('rejects a wrong check digit', () => {
-      expect(isValidCnpj('11222333000182')).toBe(false);
-      expect(isValidCnpj('12ABC34501DE36')).toBe(false);
-    });
-
-    it('rejects a repeated-character sequence', () => {
-      expect(isValidCnpj('00000000000000')).toBe(false);
-      expect(isValidCnpj('11111111111111')).toBe(false);
-    });
-
-    it('rejects the wrong length', () => {
-      expect(isValidCnpj('')).toBe(false);
-      expect(isValidCnpj('1122233300018')).toBe(false);
-    });
-
-    it('rejects letters in the check-digit positions', () => {
-      expect(isValidCnpj('12ABC34501DEAB')).toBe(false);
-    });
-  });
-
-  describe('cnpj validator', () => {
-    it('treats empty as valid (the field is optional)', () => {
-      expect(cnpj()('')).toBeUndefined();
-      expect(cnpj()('   ')).toBeUndefined();
-    });
-
-    it('returns a message for an invalid CNPJ', () => {
-      expect(cnpj()('11222333000182')).toBeTruthy();
-      expect(cnpj('Confira o CNPJ')('123')).toBe('Confira o CNPJ');
-    });
-
-    it('returns undefined for a valid CNPJ', () => {
-      expect(cnpj()(VALID_NUMERIC)).toBeUndefined();
-      expect(cnpj()(VALID_ALPHANUMERIC)).toBeUndefined();
-    });
-  });
-});

package/src/serverAction.spec.ts

@@ -1,136 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-
-import {
-  ActionError,
-  createServerAction,
-  email,
-  err,
-  ok,
-  required,
-} from './index';
-
-describe('forms-core/result', () => {
-  describe('ok', () => {
-    it('returns the success shape wrapping the data', () => {
-      expect(ok(42)).toEqual({ ok: true, data: 42 });
-    });
-  });
-
-  describe('err', () => {
-    it('returns the error shape wrapping the message', () => {
-      expect(err('bad')).toEqual({ ok: false, error: 'bad' });
-    });
-
-    it('includes fieldErrors when provided', () => {
-      expect(err('bad name', { name: 'bad name' })).toEqual({
-        ok: false,
-        error: 'bad name',
-        fieldErrors: { name: 'bad name' },
-      });
-    });
-  });
-});
-
-describe('forms-core/createServerAction', () => {
-  const schema = { email: [required(), email()] };
-
-  it('returns ok and calls the handler exactly once on valid input', async () => {
-    const handler = vi.fn(async (input: { email: string }) => input.email);
-    const action = createServerAction(schema, handler);
-
-    const result = await action({ email: 'a@b.com' });
-
-    expect(result).toEqual({ ok: true, data: 'a@b.com' });
-    expect(handler).toHaveBeenCalledTimes(1);
-  });
-
-  it('returns err and never calls the handler on invalid input', async () => {
-    const handler = vi.fn(async (input: { email: string }) => input.email);
-    const action = createServerAction(schema, handler);
-
-    const result = await action({ email: '' });
-
-    expect(result.ok).toBe(false);
-    if (!result.ok) {
-      expect(typeof result.error).toBe('string');
-      expect(result.error).toBeTruthy();
-    }
-    expect(handler).not.toHaveBeenCalled();
-  });
-
-  it('maps a throwing handler to a generic err with no stack trace leak', async () => {
-    const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => undefined);
-    const secret = 'INTERNAL_STACK_DETAIL';
-    const handler = vi.fn(async () => {
-      throw new Error(secret);
-    });
-    const action = createServerAction(schema, handler);
-
-    const result = await action({ email: 'a@b.com' });
-
-    expect(result.ok).toBe(false);
-    if (!result.ok) {
-      expect(typeof result.error).toBe('string');
-      expect(result.error).toBeTruthy();
-      expect(result.error).not.toContain(secret);
-      expect(result.error).not.toContain('at ');
-    }
-    // The real cause is logged server-side for diagnosis, never returned.
-    expect(errorSpy).toHaveBeenCalled();
-    errorSpy.mockRestore();
-  });
-
-  it('passes through the message of a thrown ActionError verbatim', async () => {
-    const handler = vi.fn(async () => {
-      throw new ActionError('A product with this name already exists.');
-    });
-    const action = createServerAction(schema, handler);
-
-    const result = await action({ email: 'a@b.com' });
-
-    expect(result).toEqual({
-      ok: false,
-      error: 'A product with this name already exists.',
-    });
-  });
-
-  it('attributes a validation failure to the offending field', async () => {
-    const handler = vi.fn(async (input: { email: string }) => input.email);
-    const action = createServerAction(schema, handler);
-
-    const result = await action({ email: '' });
-
-    expect(result.ok).toBe(false);
-    if (!result.ok) {
-      expect(result.fieldErrors).toEqual({ email: result.error });
-    }
-    expect(handler).not.toHaveBeenCalled();
-  });
-
-  it('surfaces an ActionError field as fieldErrors so the form can highlight it', async () => {
-    const handler = vi.fn(async () => {
-      throw new ActionError('Já existe um produto com esse nome.', 'name');
-    });
-    const action = createServerAction(schema, handler);
-
-    const result = await action({ email: 'a@b.com' });
-
-    expect(result).toEqual({
-      ok: false,
-      error: 'Já existe um produto com esse nome.',
-      fieldErrors: { name: 'Já existe um produto com esse nome.' },
-    });
-  });
-
-  it('passes an ActionError fieldErrors map straight through (multi-field)', async () => {
-    const fieldErrors = { 'sku:ABC': 'ABC já usado', 'sku:XYZ': 'XYZ já usado' };
-    const handler = vi.fn(async () => {
-      throw new ActionError('SKUs duplicados.', undefined, fieldErrors);
-    });
-    const action = createServerAction(schema, handler);
-
-    const result = await action({ email: 'a@b.com' });
-
-    expect(result).toEqual({ ok: false, error: 'SKUs duplicados.', fieldErrors });
-  });
-});

package/src/validators.spec.ts

@@ -1,78 +0,0 @@
-import { describe, expect, it } from 'vitest';
-
-import { email, min, minLength, required, validateFields } from './validators';
-
-describe('forms-core/validators', () => {
-  describe('required', () => {
-    it('returns an error message for an empty string', () => {
-      const result = required()('');
-      expect(typeof result).toBe('string');
-      expect(result).toBeTruthy();
-    });
-
-    it('returns undefined for a non-empty value', () => {
-      expect(required()('hello')).toBeUndefined();
-    });
-
-    it('supports a custom message', () => {
-      expect(required('Campo obrigatório')('')).toBe('Campo obrigatório');
-    });
-  });
-
-  describe('email', () => {
-    it('returns an error message for a malformed address', () => {
-      const result = email()('not-an-email');
-      expect(typeof result).toBe('string');
-      expect(result).toBeTruthy();
-    });
-
-    it('returns undefined for a valid address', () => {
-      expect(email()('a@b.com')).toBeUndefined();
-    });
-
-    it('supports a custom message', () => {
-      expect(email('E-mail inválido')('bad')).toBe('E-mail inválido');
-    });
-  });
-
-  describe('minLength / min', () => {
-    it('returns an error message when the value is shorter than the minimum', () => {
-      const result = minLength(3)('ab');
-      expect(typeof result).toBe('string');
-      expect(result).toBeTruthy();
-    });
-
-    it('returns undefined when the value meets the minimum length', () => {
-      expect(minLength(3)('abc')).toBeUndefined();
-    });
-
-    it('exposes min as an alias of minLength', () => {
-      expect(min).toBe(minLength);
-      expect(min(3)('ab')).toBeTruthy();
-      expect(min(3)('abc')).toBeUndefined();
-    });
-
-    it('supports a custom message', () => {
-      expect(minLength(3, 'Muito curto')('ab')).toBe('Muito curto');
-    });
-  });
-
-  describe('validateFields', () => {
-    it('returns an entry per failing field using the first failing validator', () => {
-      const requiredMsg = required()('') as string;
-      const errors = validateFields(
-        { email: '' },
-        { email: [required(), email()] },
-      );
-      expect(errors).toEqual({ email: requiredMsg });
-    });
-
-    it('returns an empty object when all fields are valid', () => {
-      const errors = validateFields(
-        { email: 'a@b.com' },
-        { email: [required(), email()] },
-      );
-      expect(errors).toEqual({});
-    });
-  });
-});