@timbra-ec/types 0.1.0

package/src/product.ts

@@ -0,0 +1,16 @@
+/** Product or service in a business catalog */
+export interface Product {
+  id: string
+  organizationId: string
+  codigoPrincipal: string
+  descripcion: string
+  precioUnitario: number
+  codigoPorcentajeIva: string // '0', '2', '3', '4', '5', '8' — SRI Ficha Tecnica v2.30 Tabla 17
+  detallesAdicionales?: { nombre: string; valor: string }[]
+  iceCodigoPorcentaje?: string
+  iceTarifa?: number
+  activo: boolean
+  lastUsedAt?: string
+  createdAt: string
+  updatedAt: string
+}

package/src/schemas/client.schema.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod'
+
+export const createClientSchema = z.object({
+  tipoIdentificacion: z.enum(['04', '05', '06', '07', '08']),
+  identificacion: z.string().min(1).max(20),
+  razonSocial: z.string().min(1).max(300),
+  nombreComercial: z.string().max(300).optional(),
+  direccion: z.string().max(300).optional(),
+  email: z.string().email(),
+  telefono: z.string().max(20).optional(),
+  tags: z.array(z.string()).optional(),
+  notes: z.string().max(500).optional(),
+})
+
+export type CreateClientInput = z.infer<typeof createClientSchema>

package/src/schemas/invoice.schema.ts

@@ -0,0 +1,56 @@
+import { z } from 'zod'
+
+export const invoiceItemSchema = z.object({
+  codigoPrincipal: z.string().max(25),
+  descripcion: z.string().min(1).max(300),
+  cantidad: z.number().positive(),
+  precioUnitario: z.number().nonnegative(),
+  descuento: z.number().nonnegative().default(0),
+  codigoPorcentajeIva: z.enum(['0', '2', '3', '4', '5', '8']),
+  iceCodigoPorcentaje: z.string().max(4).optional(),
+  iceTarifa: z.number().nonnegative().optional(),
+  detallesAdicionales: z
+    .array(z.object({ nombre: z.string().min(1).max(100), valor: z.string().min(1).max(300) }))
+    .max(3)
+    .optional(),
+})
+
+/** Valid SRI payment method codes — Ficha Tecnica v2.30, Formas de Pago Vigentes */
+export const SRI_PAYMENT_CODES = ['01', '15', '16', '17', '18', '19', '20', '21'] as const
+
+export type SriPaymentCode = (typeof SRI_PAYMENT_CODES)[number]
+
+export const paymentDetailSchema = z.object({
+  formaPago: z.enum(SRI_PAYMENT_CODES),
+  total: z.number().positive(),
+  plazo: z.number().nonnegative().optional(),
+  unidadTiempo: z.string().optional(),
+})
+
+export const createInvoiceSchema = z.object({
+  // Buyer
+  tipoIdentificacionComprador: z.enum(['04', '05', '06', '07', '08']),
+  identificacionComprador: z.string().min(1).max(20),
+  razonSocialComprador: z.string().min(1).max(300),
+  emailComprador: z.string().email().optional(),
+  telefonoComprador: z.string().optional(),
+
+  // Date
+  fechaEmision: z.string().regex(/^\d{2}\/\d{2}\/\d{4}$/, 'Format: dd/MM/yyyy'),
+
+  // Items
+  items: z.array(invoiceItemSchema).min(1),
+
+  // Payment
+  pagos: z.array(paymentDetailSchema).min(1),
+
+  // Optional
+  propina: z.number().nonnegative().default(0),
+  infoAdicional: z.record(z.string()).optional(),
+
+  // Delivery preferences
+  sendEmail: z.boolean().default(true),
+  sendWhatsApp: z.boolean().default(false),
+})
+
+export type CreateInvoiceInput = z.infer<typeof createInvoiceSchema>

package/src/sri.ts

@@ -0,0 +1,54 @@
+import type { SriAuthStatus } from './invoice'
+
+/** SRI SOAP reception response */
+export interface SriRecepcionResponse {
+  estado: 'RECIBIDA' | 'DEVUELTA'
+  comprobantes: {
+    claveAcceso: string
+    mensajes: SriMensaje[]
+  }[]
+}
+
+/** SRI SOAP authorization response */
+export interface SriAutorizacionResponse {
+  estado: SriAuthStatus
+  numeroAutorizacion: string
+  fechaAutorizacion: string
+  ambiente: string
+  comprobante: string // the authorized XML as string
+  mensajes: SriMensaje[]
+}
+
+/** SRI error/warning message */
+export interface SriMensaje {
+  identificador: string
+  mensaje: string
+  informacionAdicional?: string
+  tipo: 'ERROR' | 'ADVERTENCIA' | 'INFORMATIVO'
+}
+
+/** Common SRI error codes */
+export const SRI_ERROR_CODES = {
+  CLAVE_REGISTRADA: '35',
+  FECHA_NO_CORRESPONDE: '43',
+  RUC_INACTIVO: '46',
+  TOTAL_INCORRECTO: '65',
+  CERTIFICADO_INVALIDO: '70',
+  FIRMA_NO_VALIDA: '72',
+} as const
+
+/** SRI environment URLs */
+export const SRI_URLS = {
+  TEST: {
+    RECEPCION:
+      'https://celcer.sri.gob.ec/comprobantes-electronicos-ws/RecepcionComprobantesOffline?wsdl',
+    AUTORIZACION:
+      'https://celcer.sri.gob.ec/comprobantes-electronicos-ws/AutorizacionComprobantesOffline?wsdl',
+  },
+  PRODUCTION: {
+    RECEPCION:
+      'https://cel.sri.gob.ec/comprobantes-electronicos-ws/RecepcionComprobantesOffline?wsdl',
+    AUTORIZACION:
+      'https://cel.sri.gob.ec/comprobantes-electronicos-ws/AutorizacionComprobantesOffline?wsdl',
+  },
+} as const

package/src/user.ts

@@ -0,0 +1,43 @@
+/** User roles in the system */
+export type UserRole = 'owner' | 'accountant' | 'employee'
+
+/** RIMPE regime type */
+export type RimpeRegime = 'emprendedor' | 'negocio_popular' | null
+
+/** Organization (a business entity with a RUC) */
+export interface Organization {
+  id: string
+  ruc: string
+  razonSocial: string
+  nombreComercial?: string
+  direccionMatriz: string
+  estab: string // default '001'
+  ptoEmi: string // default '001'
+  obligadoContabilidad: boolean
+  regimenRimpe: RimpeRegime
+  ambiente: '1' | '2' // 1=pruebas, 2=produccion
+  preciosIncluyenIva: boolean
+  contactEmail?: string
+  logoUrl?: string
+  createdAt: string
+  updatedAt: string
+}
+
+/** Organization membership (user <-> org relationship) */
+export interface OrgMember {
+  id: string
+  userId: string
+  organizationId: string
+  role: UserRole
+  createdAt: string
+}
+
+/** User profile */
+export interface UserProfile {
+  id: string
+  email: string
+  nombreCompleto: string
+  telefono?: string
+  createdAt: string
+  updatedAt: string
+}

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "@timbra-ec/config-ts/library.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src"]
+}