@pittaj/contracts 1.2.2

package/dist/company/dtos/CreatedCompanyDTO.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @fileoverview DTO de respuesta después de crear una empresa.
+ *
+ * Define la estructura de datos que el backend devuelve
+ * después de crear exitosamente una empresa (POST /companies).
+ *
+ * @module Contracts/Company/DTOs
+ * @version 1.0.0
+ * @since 11-11-2025
+ */
+/**
+ * DTO de respuesta después de POST /companies.
+ *
+ * Contiene los datos esenciales de la empresa recién creada.
+ *
+ * @example
+ * ```typescript
+ * const createdCompany: CreatedCompanyDTO = {
+ *   id: '550e8400-e29b-41d4-a716-446655440000',
+ *   name: 'Tienda El Sol',
+ *   legalName: 'Comercializadora El Sol S.A.',
+ *   taxId: '1792146739001',
+ *   isDefault: true,
+ *   isActive: true,
+ *   createdAt: '2025-11-11T10:00:00Z',
+ *   version: 1,
+ * };
+ * ```
+ */
+export interface CreatedCompanyDTO {
+    /**
+     * ID único de la empresa (UUID v4).
+     */
+    readonly id: string;
+    /**
+     * Nombre comercial de la empresa.
+     */
+    readonly name: string;
+    /**
+     * Nombre legal completo (Razón Social).
+     */
+    readonly legalName: string;
+    /**
+     * Identificación fiscal (RUC, NIF, RFC, EIN).
+     */
+    readonly taxId: string;
+    /**
+     * Indica si es la empresa por defecto del tenant.
+     */
+    readonly isDefault: boolean;
+    /**
+     * Indica si la empresa está activa.
+     *
+     * Por defecto es true al crear.
+     */
+    readonly isActive: boolean;
+    /**
+     * Fecha de creación (ISO 8601).
+     */
+    readonly createdAt: string;
+    /**
+     * ID del usuario que creó este registro (UUID).
+     */
+    readonly createdBy?: string;
+    /**
+     * Versión para optimistic locking.
+     *
+     * Siempre es 1 al crear.
+     */
+    readonly version: number;
+}
+//# sourceMappingURL=CreatedCompanyDTO.d.ts.map

package/dist/company/dtos/CreatedCompanyDTO.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreatedCompanyDTO.d.ts","sourceRoot":"","sources":["../../../src/company/dtos/CreatedCompanyDTO.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B"}

package/dist/company/dtos/CreatedCompanyDTO.js

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview DTO de respuesta después de crear una empresa.
+ *
+ * Define la estructura de datos que el backend devuelve
+ * después de crear exitosamente una empresa (POST /companies).
+ *
+ * @module Contracts/Company/DTOs
+ * @version 1.0.0
+ * @since 11-11-2025
+ */
+export {};
+//# sourceMappingURL=CreatedCompanyDTO.js.map

package/dist/company/dtos/CreatedCompanyDTO.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreatedCompanyDTO.js","sourceRoot":"","sources":["../../../src/company/dtos/CreatedCompanyDTO.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/company/dtos/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview Barrel export para DTOs de Company.
+ * @module Contracts/Company/DTOs
+ * @version 1.0.0
+ * @since 11-11-2025
+ */
+export type { CompanyDTO } from './CompanyDTO';
+export type { CreatedCompanyDTO } from './CreatedCompanyDTO';
+//# sourceMappingURL=index.d.ts.map

package/dist/company/dtos/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/company/dtos/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/company/dtos/index.js

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Barrel export para DTOs de Company.
+ * @module Contracts/Company/DTOs
+ * @version 1.0.0
+ * @since 11-11-2025
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/company/dtos/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/company/dtos/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/company/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Barrel export para módulo Company.
+ * @module Contracts/Company
+ */
+export * from './schemas';
+export * from './responses';
+//# sourceMappingURL=index.d.ts.map

package/dist/company/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/company/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}

package/dist/company/index.js

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Barrel export para módulo Company.
+ * @module Contracts/Company
+ */
+export * from './schemas';
+export * from './responses';
+//# sourceMappingURL=index.js.map

package/dist/company/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/company/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}

package/dist/company/responses/CompanyResponse.d.ts

@@ -0,0 +1,79 @@
+/**
+ * @fileoverview DTO de respuesta para Company (GET endpoints).
+ *
+ * Define la estructura de datos que el backend envía al frontend
+ * cuando se consulta información de empresas.
+ *
+ * @module Contracts/Company/DTOs
+ * @version 1.0.0
+ * @since 11-11-2025
+ */
+/**
+ * DTO de respuesta para consultas de empresas.
+ *
+ * Usado en:
+ * - GET /companies (lista)
+ * - GET /companies/:id (detalle)
+ * - PUT /companies/:id (respuesta después de update)
+ *
+ * @example
+ * ```typescript
+ * const company: CompanyResponse = {
+ *   id: '550e8400-e29b-41d4-a716-446655440000',
+ *   name: 'Tienda El Sol',
+ *   legalName: 'Comercializadora El Sol S.A.',
+ *   taxId: '1792146739001',
+ *   isDefault: true,
+ *   isActive: true,
+ *   createdAt: '2025-11-11T10:00:00Z',
+ *   version: 1,
+ * };
+ * ```
+ */
+export interface CompanyResponse {
+    /**
+     * ID único de la empresa (UUID v4).
+     */
+    readonly id: string;
+    /**
+     * Nombre comercial de la empresa.
+     */
+    readonly name: string;
+    /**
+     * Nombre legal completo (Razón Social).
+     */
+    readonly legalName: string;
+    /**
+     * Identificación fiscal (RUC, NIF, RFC, EIN).
+     */
+    readonly taxId: string;
+    /**
+     * Indica si es la empresa por defecto del tenant.
+     */
+    readonly isDefault: boolean;
+    /**
+     * Indica si la empresa está activa.
+     */
+    readonly isActive: boolean;
+    /**
+     * Fecha de creación (ISO 8601).
+     */
+    readonly createdAt: string;
+    /**
+     * ID del usuario que creó este registro (UUID).
+     */
+    readonly createdBy?: string;
+    /**
+     * Fecha de última actualización (ISO 8601).
+     */
+    readonly updatedAt?: string;
+    /**
+     * ID del usuario que actualizó este registro (UUID).
+     */
+    readonly updatedBy?: string;
+    /**
+     * Versión para optimistic locking.
+     */
+    readonly version: number;
+}
+//# sourceMappingURL=CompanyResponse.d.ts.map

package/dist/company/responses/CompanyResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompanyResponse.d.ts","sourceRoot":"","sources":["../../../src/company/responses/CompanyResponse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B"}

package/dist/company/responses/CompanyResponse.js

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview DTO de respuesta para Company (GET endpoints).
+ *
+ * Define la estructura de datos que el backend envía al frontend
+ * cuando se consulta información de empresas.
+ *
+ * @module Contracts/Company/DTOs
+ * @version 1.0.0
+ * @since 11-11-2025
+ */
+export {};
+//# sourceMappingURL=CompanyResponse.js.map

package/dist/company/responses/CompanyResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompanyResponse.js","sourceRoot":"","sources":["../../../src/company/responses/CompanyResponse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/company/responses/CreateCompanyResponse.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @fileoverview DTO de respuesta después de crear una empresa.
+ *
+ * Define la estructura de datos que el backend devuelve
+ * después de crear exitosamente una empresa (POST /companies).
+ *
+ * @module Contracts/Company/DTOs
+ * @version 1.0.0
+ * @since 11-11-2025
+ */
+/**
+ * DTO de respuesta después de POST /companies.
+ *
+ * Contiene los datos esenciales de la empresa recién creada.
+ *
+ * @example
+ * ```typescript
+ * const createdCompany: CreateCompanyResponse = {
+ *   id: '550e8400-e29b-41d4-a716-446655440000',
+ *   name: 'Tienda El Sol',
+ *   legalName: 'Comercializadora El Sol S.A.',
+ *   taxId: '1792146739001',
+ *   isDefault: true,
+ *   isActive: true,
+ *   createdAt: '2025-11-11T10:00:00Z',
+ *   version: 1,
+ * };
+ * ```
+ */
+export interface CreateCompanyResponse {
+    /**
+     * ID único de la empresa (UUID v4).
+     */
+    readonly id: string;
+    /**
+     * Nombre comercial de la empresa.
+     */
+    readonly name: string;
+    /**
+     * Nombre legal completo (Razón Social).
+     */
+    readonly legalName: string;
+    /**
+     * Identificación fiscal (RUC, NIF, RFC, EIN).
+     */
+    readonly taxId: string;
+    /**
+     * Indica si es la empresa por defecto del tenant.
+     */
+    readonly isDefault: boolean;
+    /**
+     * Indica si la empresa está activa.
+     *
+     * Por defecto es true al crear.
+     */
+    readonly isActive: boolean;
+    /**
+     * Fecha de creación (ISO 8601).
+     */
+    readonly createdAt: string;
+    /**
+     * ID del usuario que creó este registro (UUID).
+     */
+    readonly createdBy?: string;
+    /**
+     * Versión para optimistic locking.
+     *
+     * Siempre es 1 al crear.
+     */
+    readonly version: number;
+}
+//# sourceMappingURL=CreateCompanyResponse.d.ts.map

package/dist/company/responses/CreateCompanyResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateCompanyResponse.d.ts","sourceRoot":"","sources":["../../../src/company/responses/CreateCompanyResponse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B"}

package/dist/company/responses/CreateCompanyResponse.js

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview DTO de respuesta después de crear una empresa.
+ *
+ * Define la estructura de datos que el backend devuelve
+ * después de crear exitosamente una empresa (POST /companies).
+ *
+ * @module Contracts/Company/DTOs
+ * @version 1.0.0
+ * @since 11-11-2025
+ */
+export {};
+//# sourceMappingURL=CreateCompanyResponse.js.map

package/dist/company/responses/CreateCompanyResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateCompanyResponse.js","sourceRoot":"","sources":["../../../src/company/responses/CreateCompanyResponse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/company/responses/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Barrel export para responses de Company.
+ * @module Contracts/Company/Responses
+ */
+export type { CompanyResponse } from './CompanyResponse';
+export type { CreateCompanyResponse } from './CreateCompanyResponse';
+//# sourceMappingURL=index.d.ts.map

package/dist/company/responses/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/company/responses/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/company/responses/index.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Barrel export para responses de Company.
+ * @module Contracts/Company/Responses
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/company/responses/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/company/responses/index.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/company/schemas/createCompany.schema.d.ts

@@ -0,0 +1,102 @@
+/**
+ * @fileoverview Schema Zod para validación de creación de empresa.
+ *
+ * Define las reglas de validación para el endpoint POST /companies:
+ * - Nombre comercial (2-100 caracteres)
+ * - Nombre legal completo (2-200 caracteres)
+ * - Tax ID válido (RUC, NIF, EIN, etc.)
+ * - Flag isDefault opcional
+ * - ID opcional para PWA offline-first
+ *
+ * @module Contracts/Company
+ * @version 1.0.0
+ * @since 11-11-2025
+ */
+import { z } from 'zod';
+/**
+ * Schema Zod para crear una empresa.
+ *
+ * Usado en POST /companies para validar el body del request.
+ *
+ * @example
+ * ```typescript
+ * import { CreateCompanySchema } from '@pittaj/lib-contracts';
+ *
+ * const result = CreateCompanySchema.safeParse(body);
+ * if (!result.success) {
+ *   return c.json({ errors: result.error.errors }, 400);
+ * }
+ * ```
+ */
+export declare const CreateCompanySchema: z.ZodObject<{
+    /**
+     * ID opcional de la empresa (UUID v4).
+     *
+     * Para soporte PWA offline-first:
+     * - Cliente genera UUID offline
+     * - Servidor respeta el ID del cliente
+     * - Si no se proporciona, servidor genera uno nuevo
+     */
+    id: z.ZodOptional<z.ZodString>;
+    /**
+     * Nombre comercial de la empresa.
+     *
+     * Requisitos:
+     * - Longitud: 2-100 caracteres
+     * - Usado para mostrar en UI
+     *
+     * @example "Tienda El Sol"
+     */
+    name: z.ZodString;
+    /**
+     * Nombre legal completo de la empresa.
+     *
+     * Requisitos:
+     * - Longitud: 2-200 caracteres
+     * - Nombre registrado legalmente (Razón Social)
+     *
+     * @example "Comercializadora El Sol S.A. de C.V."
+     */
+    legalName: z.ZodString;
+    /**
+     * Identificación fiscal (RUC, NIF, RFC, EIN, etc.).
+     *
+     * Requisitos:
+     * - Formato alfanumérico con guiones opcionales
+     * - Longitud: 8-20 caracteres
+     * - Único por tenant
+     *
+     * @example
+     * - Ecuador: "1792146739001" (RUC)
+     * - España: "12345678A" (NIF)
+     * - México: "ABC123456XYZ" (RFC)
+     * - USA: "12-3456789" (EIN)
+     */
+    taxId: z.ZodString;
+    /**
+     * Indica si es la empresa por defecto del tenant.
+     *
+     * Solo puede haber UNA empresa default por tenant.
+     * Si se marca otra como default, se desmarca la anterior.
+     *
+     * @default false
+     */
+    isDefault: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    legalName: string;
+    taxId: string;
+    isDefault: boolean;
+    id?: string | undefined;
+}, {
+    name: string;
+    legalName: string;
+    taxId: string;
+    id?: string | undefined;
+    isDefault?: boolean | undefined;
+}>;
+/**
+ * Tipo inferido del schema.
+ */
+export type CreateCompanyRequest = z.infer<typeof CreateCompanySchema>;
+//# sourceMappingURL=createCompany.schema.d.ts.map

package/dist/company/schemas/createCompany.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createCompany.schema.d.ts","sourceRoot":"","sources":["../../../src/company/schemas/createCompany.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAexB;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,mBAAmB;IAC9B;;;;;;;OAOG;;IAGH;;;;;;;;OAQG;;IAMH;;;;;;;;OAQG;;IAMH;;;;;;;;;;;;;OAaG;;IAMH;;;;;;;OAOG;;;;;;;;;;;;;;EAEH,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/company/schemas/createCompany.schema.js

@@ -0,0 +1,107 @@
+/**
+ * @fileoverview Schema Zod para validación de creación de empresa.
+ *
+ * Define las reglas de validación para el endpoint POST /companies:
+ * - Nombre comercial (2-100 caracteres)
+ * - Nombre legal completo (2-200 caracteres)
+ * - Tax ID válido (RUC, NIF, EIN, etc.)
+ * - Flag isDefault opcional
+ * - ID opcional para PWA offline-first
+ *
+ * @module Contracts/Company
+ * @version 1.0.0
+ * @since 11-11-2025
+ */
+import { z } from 'zod';
+/**
+ * Regex para validar Tax ID.
+ *
+ * Acepta formatos comunes:
+ * - RUC (Ecuador): 13 dígitos
+ * - NIF (España): 8 dígitos + letra
+ * - RFC (México): 12-13 caracteres alfanuméricos
+ * - EIN (USA): XX-XXXXXXX
+ *
+ * Formato general: Alfanumérico con guiones opcionales
+ */
+const TAX_ID_REGEX = /^[A-Z0-9-]{8,20}$/i;
+/**
+ * Schema Zod para crear una empresa.
+ *
+ * Usado en POST /companies para validar el body del request.
+ *
+ * @example
+ * ```typescript
+ * import { CreateCompanySchema } from '@pittaj/lib-contracts';
+ *
+ * const result = CreateCompanySchema.safeParse(body);
+ * if (!result.success) {
+ *   return c.json({ errors: result.error.errors }, 400);
+ * }
+ * ```
+ */
+export const CreateCompanySchema = z.object({
+    /**
+     * ID opcional de la empresa (UUID v4).
+     *
+     * Para soporte PWA offline-first:
+     * - Cliente genera UUID offline
+     * - Servidor respeta el ID del cliente
+     * - Si no se proporciona, servidor genera uno nuevo
+     */
+    id: z.string().uuid().optional(),
+    /**
+     * Nombre comercial de la empresa.
+     *
+     * Requisitos:
+     * - Longitud: 2-100 caracteres
+     * - Usado para mostrar en UI
+     *
+     * @example "Tienda El Sol"
+     */
+    name: z.string()
+        .min(2, 'El nombre debe tener al menos 2 caracteres')
+        .max(100, 'El nombre no puede exceder 100 caracteres')
+        .trim(),
+    /**
+     * Nombre legal completo de la empresa.
+     *
+     * Requisitos:
+     * - Longitud: 2-200 caracteres
+     * - Nombre registrado legalmente (Razón Social)
+     *
+     * @example "Comercializadora El Sol S.A. de C.V."
+     */
+    legalName: z.string()
+        .min(2, 'El nombre legal debe tener al menos 2 caracteres')
+        .max(200, 'El nombre legal no puede exceder 200 caracteres')
+        .trim(),
+    /**
+     * Identificación fiscal (RUC, NIF, RFC, EIN, etc.).
+     *
+     * Requisitos:
+     * - Formato alfanumérico con guiones opcionales
+     * - Longitud: 8-20 caracteres
+     * - Único por tenant
+     *
+     * @example
+     * - Ecuador: "1792146739001" (RUC)
+     * - España: "12345678A" (NIF)
+     * - México: "ABC123456XYZ" (RFC)
+     * - USA: "12-3456789" (EIN)
+     */
+    taxId: z.string()
+        .regex(TAX_ID_REGEX, 'Tax ID debe ser alfanumérico (8-20 caracteres)')
+        .trim()
+        .toUpperCase(),
+    /**
+     * Indica si es la empresa por defecto del tenant.
+     *
+     * Solo puede haber UNA empresa default por tenant.
+     * Si se marca otra como default, se desmarca la anterior.
+     *
+     * @default false
+     */
+    isDefault: z.boolean().optional().default(false),
+});
+//# sourceMappingURL=createCompany.schema.js.map

package/dist/company/schemas/createCompany.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createCompany.schema.js","sourceRoot":"","sources":["../../../src/company/schemas/createCompany.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;GAUG;AACH,MAAM,YAAY,GAAG,oBAAoB,CAAC;AAE1C;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C;;;;;;;OAOG;IACH,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IAEhC;;;;;;;;OAQG;IACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;SACb,GAAG,CAAC,CAAC,EAAE,4CAA4C,CAAC;SACpD,GAAG,CAAC,GAAG,EAAE,2CAA2C,CAAC;SACrD,IAAI,EAAE;IAET;;;;;;;;OAQG;IACH,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;SAClB,GAAG,CAAC,CAAC,EAAE,kDAAkD,CAAC;SAC1D,GAAG,CAAC,GAAG,EAAE,iDAAiD,CAAC;SAC3D,IAAI,EAAE;IAET;;;;;;;;;;;;;OAaG;IACH,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;SACd,KAAK,CAAC,YAAY,EAAE,gDAAgD,CAAC;SACrE,IAAI,EAAE;SACN,WAAW,EAAE;IAEhB;;;;;;;OAOG;IACH,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACjD,CAAC,CAAC"}

package/dist/company/schemas/getCompanies.schema.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @fileoverview Schema Zod para validación de consulta de empresas.
+ *
+ * Define las reglas de validación para el endpoint GET /companies:
+ * - Filtro por estado activo (opcional)
+ *
+ * @module Contracts/Company
+ * @version 1.0.0
+ * @since 11-11-2025
+ */
+import { z } from 'zod';
+/**
+ * Schema Zod para query params de GET /companies.
+ *
+ * Usado para validar los parámetros de consulta.
+ *
+ * @example
+ * ```typescript
+ * import { GetCompaniesSchema } from '@pittaj/lib-contracts';
+ *
+ * // GET /companies?onlyActive=true
+ * const query = GetCompaniesSchema.parse(c.req.query());
+ * ```
+ */
+export declare const GetCompaniesSchema: z.ZodObject<{
+    /**
+     * Filtrar solo empresas activas.
+     *
+     * Si es true, solo retorna empresas con isActive=true.
+     * Si es false o no se proporciona, retorna todas.
+     *
+     * @default false
+     */
+    onlyActive: z.ZodPipeline<z.ZodEffects<z.ZodOptional<z.ZodString>, boolean, string | undefined>, z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    onlyActive: boolean;
+}, {
+    onlyActive?: string | undefined;
+}>;
+/**
+ * Tipo inferido del schema.
+ */
+export type GetCompaniesQuery = z.infer<typeof GetCompaniesSchema>;
+//# sourceMappingURL=getCompanies.schema.d.ts.map

package/dist/company/schemas/getCompanies.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCompanies.schema.d.ts","sourceRoot":"","sources":["../../../src/company/schemas/getCompanies.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kBAAkB;IAC7B;;;;;;;OAOG;;;;;;EAMH,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/company/schemas/getCompanies.schema.js

@@ -0,0 +1,40 @@
+/**
+ * @fileoverview Schema Zod para validación de consulta de empresas.
+ *
+ * Define las reglas de validación para el endpoint GET /companies:
+ * - Filtro por estado activo (opcional)
+ *
+ * @module Contracts/Company
+ * @version 1.0.0
+ * @since 11-11-2025
+ */
+import { z } from 'zod';
+/**
+ * Schema Zod para query params de GET /companies.
+ *
+ * Usado para validar los parámetros de consulta.
+ *
+ * @example
+ * ```typescript
+ * import { GetCompaniesSchema } from '@pittaj/lib-contracts';
+ *
+ * // GET /companies?onlyActive=true
+ * const query = GetCompaniesSchema.parse(c.req.query());
+ * ```
+ */
+export const GetCompaniesSchema = z.object({
+    /**
+     * Filtrar solo empresas activas.
+     *
+     * Si es true, solo retorna empresas con isActive=true.
+     * Si es false o no se proporciona, retorna todas.
+     *
+     * @default false
+     */
+    onlyActive: z
+        .string()
+        .optional()
+        .transform((val) => val === 'true')
+        .pipe(z.boolean()),
+});
+//# sourceMappingURL=getCompanies.schema.js.map

package/dist/company/schemas/getCompanies.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCompanies.schema.js","sourceRoot":"","sources":["../../../src/company/schemas/getCompanies.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC;;;;;;;OAOG;IACH,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,MAAM,CAAC;SAClC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;CACrB,CAAC,CAAC"}