@timbra-ec/types 0.1.0-dev.20260403050717

package/dist/schemas/invoice.schema.js

@@ -0,0 +1,44 @@
+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'];
+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),
+});
+//# sourceMappingURL=invoice.schema.js.map

package/dist/schemas/invoice.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice.schema.js","sourceRoot":"","sources":["../../src/schemas/invoice.schema.ts"],"names":[],"mappings":"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"}

package/dist/sri.d.ts

@@ -0,0 +1,46 @@
+import type { SriAuthStatus } from './invoice.js';
+/** 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;
+    mensajes: SriMensaje[];
+}
+/** SRI error/warning message */
+export interface SriMensaje {
+    identificador: string;
+    mensaje: string;
+    informacionAdicional?: string;
+    tipo: 'ERROR' | 'ADVERTENCIA' | 'INFORMATIVO';
+}
+/** Common SRI error codes */
+export declare const SRI_ERROR_CODES: {
+    readonly CLAVE_REGISTRADA: "35";
+    readonly FECHA_NO_CORRESPONDE: "43";
+    readonly RUC_INACTIVO: "46";
+    readonly TOTAL_INCORRECTO: "65";
+    readonly CERTIFICADO_INVALIDO: "70";
+    readonly FIRMA_NO_VALIDA: "72";
+};
+/** SRI environment URLs */
+export declare const SRI_URLS: {
+    readonly TEST: {
+        readonly RECEPCION: "https://celcer.sri.gob.ec/comprobantes-electronicos-ws/RecepcionComprobantesOffline?wsdl";
+        readonly AUTORIZACION: "https://celcer.sri.gob.ec/comprobantes-electronicos-ws/AutorizacionComprobantesOffline?wsdl";
+    };
+    readonly PRODUCTION: {
+        readonly RECEPCION: "https://cel.sri.gob.ec/comprobantes-electronicos-ws/RecepcionComprobantesOffline?wsdl";
+        readonly AUTORIZACION: "https://cel.sri.gob.ec/comprobantes-electronicos-ws/AutorizacionComprobantesOffline?wsdl";
+    };
+};
+//# sourceMappingURL=sri.d.ts.map

package/dist/sri.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sri.d.ts","sourceRoot":"","sources":["../src/sri.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEjD,kCAAkC;AAClC,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,UAAU,GAAG,UAAU,CAAA;IAC/B,YAAY,EAAE;QACZ,WAAW,EAAE,MAAM,CAAA;QACnB,QAAQ,EAAE,UAAU,EAAE,CAAA;KACvB,EAAE,CAAA;CACJ;AAED,sCAAsC;AACtC,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,aAAa,CAAA;IACrB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,iBAAiB,EAAE,MAAM,CAAA;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,UAAU,EAAE,CAAA;CACvB;AAED,gCAAgC;AAChC,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,IAAI,EAAE,OAAO,GAAG,aAAa,GAAG,aAAa,CAAA;CAC9C;AAED,6BAA6B;AAC7B,eAAO,MAAM,eAAe;;;;;;;CAOlB,CAAA;AAEV,2BAA2B;AAC3B,eAAO,MAAM,QAAQ;;;;;;;;;CAaX,CAAA"}

package/dist/sri.js

@@ -0,0 +1,21 @@
+/** 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',
+};
+/** 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',
+    },
+};
+//# sourceMappingURL=sri.js.map

package/dist/sri.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sri.js","sourceRoot":"","sources":["../src/sri.ts"],"names":[],"mappings":"AA6BA,6BAA6B;AAC7B,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,gBAAgB,EAAE,IAAI;IACtB,oBAAoB,EAAE,IAAI;IAC1B,YAAY,EAAE,IAAI;IAClB,gBAAgB,EAAE,IAAI;IACtB,oBAAoB,EAAE,IAAI;IAC1B,eAAe,EAAE,IAAI;CACb,CAAA;AAEV,2BAA2B;AAC3B,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,IAAI,EAAE;QACJ,SAAS,EACP,0FAA0F;QAC5F,YAAY,EACV,6FAA6F;KAChG;IACD,UAAU,EAAE;QACV,SAAS,EACP,uFAAuF;QACzF,YAAY,EACV,0FAA0F;KAC7F;CACO,CAAA"}

package/dist/user.d.ts

@@ -0,0 +1,41 @@
+/** 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;
+    ptoEmi: string;
+    obligadoContabilidad: boolean;
+    regimenRimpe: RimpeRegime;
+    ambiente: '1' | '2';
+    preciosIncluyenIva: boolean;
+    telefono?: string;
+    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;
+}
+//# sourceMappingURL=user.d.ts.map

package/dist/user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../src/user.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,YAAY,GAAG,UAAU,CAAA;AAE1D,wBAAwB;AACxB,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,iBAAiB,GAAG,IAAI,CAAA;AAElE,kDAAkD;AAClD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,WAAW,EAAE,MAAM,CAAA;IACnB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,eAAe,EAAE,MAAM,CAAA;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,oBAAoB,EAAE,OAAO,CAAA;IAC7B,YAAY,EAAE,WAAW,CAAA;IACzB,QAAQ,EAAE,GAAG,GAAG,GAAG,CAAA;IACnB,kBAAkB,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,0DAA0D;AAC1D,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,MAAM,CAAA;IACtB,IAAI,EAAE,QAAQ,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,mBAAmB;AACnB,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,cAAc,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB"}

package/dist/user.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=user.js.map

package/dist/user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.js","sourceRoot":"","sources":["../src/user.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@timbra-ec/types",
+  "version": "0.1.0-dev.20260403050717",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/timbra-ec/timbra-app.git",
+    "directory": "packages/types"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.2"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "lint": "echo 'no lint configured yet'"
+  }
+}

package/src/client.ts

@@ -0,0 +1,30 @@
+/** SRI identification type codes */
+export const ID_TYPES = {
+  RUC: '04',
+  CEDULA: '05',
+  PASAPORTE: '06',
+  CONSUMIDOR_FINAL: '07',
+  EXTERIOR: '08',
+} as const
+
+export type IdTypeCode = (typeof ID_TYPES)[keyof typeof ID_TYPES]
+
+/** Client / customer of a business */
+export interface Client {
+  id: string
+  organizationId: string
+  tipoIdentificacion: IdTypeCode
+  identificacion: string
+  razonSocial: string
+  nombreComercial?: string
+  direccion?: string
+  email?: string
+  telefono?: string
+  tags?: string[]
+  notes?: string
+  preferredPaymentMethod?: string
+  sendEmailDefault: boolean
+  sendWhatsappDefault: boolean
+  createdAt: string
+  updatedAt: string
+}

package/src/ice.ts

@@ -0,0 +1,71 @@
+/** SRI ICE (Impuesto a los Consumos Especiales) tax categories.
+ *  codigo = '3' (ICE) per SRI ficha tecnica.
+ *  Rates are approximate — consult SRI tables for current values. */
+
+export interface IceCategory {
+  codigo: '3'
+  codigoPorcentaje: string
+  descripcion: string
+  tarifa: number
+}
+
+/**
+ * Common ICE categories. codigoPorcentaje values align with SRI Anexo 7.
+ * Not exhaustive — covers the most common product types that carry ICE.
+ */
+export const ICE_CATEGORIES: IceCategory[] = [
+  { codigo: '3', codigoPorcentaje: '3011', descripcion: 'Bebidas alcoholicas', tarifa: 75 },
+  { codigo: '3', codigoPorcentaje: '3021', descripcion: 'Cerveza artesanal', tarifa: 20 },
+  { codigo: '3', codigoPorcentaje: '3023', descripcion: 'Cerveza industrial', tarifa: 75 },
+  { codigo: '3', codigoPorcentaje: '3031', descripcion: 'Cigarrillos', tarifa: 150 },
+  { codigo: '3', codigoPorcentaje: '3041', descripcion: 'Bebidas gaseosas', tarifa: 10 },
+  {
+    codigo: '3',
+    codigoPorcentaje: '3051',
+    descripcion: 'Bebidas energizantes',
+    tarifa: 10,
+  },
+  {
+    codigo: '3',
+    codigoPorcentaje: '3072',
+    descripcion: 'Vehiculos motorizados (hasta 20k)',
+    tarifa: 5,
+  },
+  {
+    codigo: '3',
+    codigoPorcentaje: '3073',
+    descripcion: 'Vehiculos motorizados (20k-30k)',
+    tarifa: 10,
+  },
+  {
+    codigo: '3',
+    codigoPorcentaje: '3074',
+    descripcion: 'Vehiculos motorizados (30k-40k)',
+    tarifa: 15,
+  },
+  {
+    codigo: '3',
+    codigoPorcentaje: '3075',
+    descripcion: 'Vehiculos motorizados (40k-50k)',
+    tarifa: 20,
+  },
+  {
+    codigo: '3',
+    codigoPorcentaje: '3076',
+    descripcion: 'Vehiculos motorizados (50k-60k)',
+    tarifa: 25,
+  },
+  {
+    codigo: '3',
+    codigoPorcentaje: '3077',
+    descripcion: 'Vehiculos motorizados (60k-70k)',
+    tarifa: 30,
+  },
+  { codigo: '3', codigoPorcentaje: '3092', descripcion: 'Perfumes y aguas de tocador', tarifa: 20 },
+  { codigo: '3', codigoPorcentaje: '3610', descripcion: 'Fundas plasticas', tarifa: 0.04 },
+]
+
+/** Lookup an ICE category by codigoPorcentaje */
+export function getIceCategory(codigoPorcentaje: string): IceCategory | undefined {
+  return ICE_CATEGORIES.find((c) => c.codigoPorcentaje === codigoPorcentaje)
+}

package/src/index.ts

@@ -0,0 +1,15 @@
+// @timbra-ec/types — Shared type definitions and Zod schemas
+// This package is the stability anchor for the entire monorepo.
+// All other packages depend on these types.
+
+// Re-export all types
+export * from './invoice.js'
+export * from './client.js'
+export * from './product.js'
+export * from './user.js'
+export * from './sri.js'
+export * from './ice.js'
+
+// Re-export schemas
+export * from './schemas/invoice.schema.js'
+export * from './schemas/client.schema.js'

package/src/invoice.ts

@@ -0,0 +1,137 @@
+import type { SriMensaje } from './sri.js'
+
+/** SRI Document type codes */
+export type DocumentTypeCode = '01' | '03' | '04' | '05' | '06' | '07'
+
+export const DOCUMENT_TYPES = {
+  FACTURA: '01',
+  LIQUIDACION_COMPRA: '03',
+  NOTA_CREDITO: '04',
+  NOTA_DEBITO: '05',
+  GUIA_REMISION: '06',
+  COMPROBANTE_RETENCION: '07',
+} as const
+
+/** SRI IVA rate codes */
+export const IVA_RATES = {
+  /** 0% IVA */
+  ZERO: { codigoPorcentaje: '0', tarifa: '0.00' },
+  /** 12% IVA (historical, pre-2024) */
+  TWELVE: { codigoPorcentaje: '2', tarifa: '12.00' },
+  /** 14% IVA (historical) */
+  FOURTEEN: { codigoPorcentaje: '3', tarifa: '14.00' },
+  /** 15% IVA (current since 2024) */
+  FIFTEEN: { codigoPorcentaje: '4', tarifa: '15.00' },
+  /** 5% IVA (special reduced rate) — SRI Ficha Tecnica v2.30 Tabla 17, code 5 */
+  FIVE: { codigoPorcentaje: '5', tarifa: '5.00' },
+  /** 8% IVA diferenciado (tourism, up to 12 days/year by executive decree) — SRI Tabla 17 code 8 */
+  EIGHT: { codigoPorcentaje: '8', tarifa: '8.00' },
+} as const
+
+/** Payment method codes — SRI Ficha Tecnica v2.30, Formas de Pago Vigentes */
+export const PAYMENT_METHODS = {
+  EFECTIVO: '01', // Sin utilizacion del sistema financiero
+  COMPENSACION_DEUDAS: '15',
+  TARJETA_DEBITO: '16',
+  DINERO_ELECTRONICO: '17',
+  TARJETA_PREPAGO: '18',
+  TARJETA_CREDITO: '19',
+  /** "Otros con utilizacion del sistema financiero" — covers bank transfers */
+  TRANSFERENCIA: '20',
+  ENDOSO_TITULOS: '21',
+} as const
+
+/** SRI environment */
+export type SriEnvironment = '1' | '2' // 1=pruebas, 2=produccion
+
+/** SRI emission type */
+export type EmissionType = '1' | '2' // 1=normal, 2=contingencia
+
+/** SRI authorization status */
+export type SriAuthStatus =
+  | 'PENDIENTE'
+  | 'RECIBIDA'
+  | 'DEVUELTA'
+  | 'AUTORIZADO'
+  | 'NO AUTORIZADO'
+  | 'EN PROCESO'
+  | 'ANULADO'
+  | 'FALLIDO'
+
+/** Invoice line item */
+export interface InvoiceItem {
+  codigoPrincipal: string
+  descripcion: string
+  cantidad: number
+  precioUnitario: number
+  descuento: number
+  precioTotalSinImpuesto: number
+  impuestos: {
+    codigo: string // '2' = IVA
+    codigoPorcentaje: string
+    tarifa: number
+    baseImponible: number
+    valor: number
+  }[]
+  detallesAdicionales?: { nombre: string; valor: string }[]
+}
+
+/** Payment detail */
+export interface PaymentDetail {
+  formaPago: string
+  total: number
+  plazo?: number
+  unidadTiempo?: string
+}
+
+/** Core invoice data */
+export interface Invoice {
+  id: string
+  organizationId: string
+  claveAcceso: string
+  codDoc: DocumentTypeCode
+  estab: string
+  ptoEmi: string
+  secuencial: string
+  fechaEmision: string
+  ambiente: SriEnvironment
+  tipoEmision: EmissionType
+
+  // Buyer
+  tipoIdentificacionComprador: string
+  identificacionComprador: string
+  razonSocialComprador: string
+
+  // Totals
+  totalSinImpuestos: number
+  totalDescuento: number
+  propina: number
+  importeTotal: number
+  moneda: string
+
+  // Details
+  items: InvoiceItem[]
+  pagos: PaymentDetail[]
+  infoAdicional?: Record<string, string>
+
+  // Status
+  sriStatus: SriAuthStatus
+  sriMensajes?: SriMensaje[]
+  numeroAutorizacion?: string
+  fechaAutorizacion?: string
+  authorizedXmlUrl?: string
+  ridePdfUrl?: string
+
+  /** Transport data for guia de remision (cod_doc='06'), stored as jsonb */
+  guiaData?: Record<string, unknown>
+  /** Fiscal period MM/YYYY for retenciones (cod_doc='07') */
+  periodoFiscal?: string
+
+  // Retry tracking
+  retryCount: number
+  retryAfter?: string
+  lastSriError?: string
+
+  createdAt: string
+  updatedAt: string
+}

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.js'
+
+/** 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,44 @@
+/** 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
+  telefono?: string
+  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"]
+}