dart_tefip 1.3.0

Dart SDK for TEF IP API terminal integration and usage

1.3.0

Added

• notification endpoint — POST /notification via tefip.notification.post(request: NotificationRequestModel(...))
• NotificationRequestModel with fields title and message
• TefIPTransactionType.money — tPag code '01'
• TefIPSalePaymentType.money — tPag code '01'
• SaleStartRequestModel.total — optional total amount displayed on the sale screen
• SaleCouponModel.discounts and SaleCouponModel.additions — lists of applied discounts and additions

Changed

• TefIPSalePaymentType now uses numeric tPag codes ('01', '03', '04', '05', '17', '99') instead of string names ('credit', 'debit', etc.) — existing JSON serialization is affected
• SaleMutationResponseModel removed — sale mutation endpoints now return the correct model directly:
  • saleItem.post/patch → SaleItemModel
  • saleItem.delete/cancel → SaleCouponModel
  • salePayment.post/patch → SalePaymentModel
  • salePayment.delete → SaleCouponModel
  • saleDiscount.post/patch → SaleDiscountModel
  • saleAddition.post/patch → SaleAdditionModel
  • sale.post/patch → SaleCouponModel

1.2.2

Fixed

• Removed discount: double? and addition: double? from SaleStartRequestModel — use saleDiscount and saleAddition endpoints instead
• saleDiscount.clear() was calling DELETE /sale/discount instead of DELETE /sale/discount/clear
• saleAddition.clear() was calling DELETE /sale/addition instead of DELETE /sale/addition/clear

Added

• TefIPEndpoints.saleDiscountClear — constant for DELETE /sale/discount/clear
• TefIPEndpoints.saleAdditionClear — constant for DELETE /sale/addition/clear

Documentation

• README: added missing saleDiscount.patch() and saleDiscount.delete() examples
• README: added full saleAddition CRUD examples (post, patch, delete, clear)
• README: added Logs section (getAll, stream, downloadZip)

1.2.1

Added

• DELETE /sale/clear via sale.clear()
• DELETE /sale/payment/clear via salePayment.clear()
• saleDiscount and saleAddition endpoint clients with full CRUD

Fixed

• Binary-safe ZIP parsing for log.downloadZip()

1.2.0

Added

• GET /logs endpoint — log.getAll({level, source, dateFrom, dateTo, limit, search, includeDetails}) returns List<LogModel>
• GET /logs/zip/download endpoint — log.downloadZip({...}) returns raw Uint8List ZIP archive
• GET /logs/stream endpoint — log.stream() returns Stream<LogModel> SSE real-time feed
• New LogModel with fields: id, level, source, message, details, createdAt
• New TefIPLogLevel enum: fatal, error, warning, info, trace, path, debug
• New TefIPLogSource enum: app, router, http
• TefIpUrlBuilder.build() now accepts optional queryParams for filtered GET requests
• TefIPNetworkingClient.stream<T>() for SSE streaming support

1.1.2

Added

• GET /sale endpoint — sale.get() returns a SaleCouponModel snapshot of the active sale
• DELETE /sale/item/clear endpoint — saleItem.clear() removes all items from the current sale at once
• discount: double? and addition: double? fields on SaleStartRequestModel — sale-level discount and surcharge that affect the final total
• New SaleCouponModel response model with sale, items, payments, and summary fields
• New SaleSummaryModel with computed totals: subtotal, surcharge, discount, itemDiscount, itemAddition, total

Notes

• Item-level discount/addition on SaleItemModel remain visual only and do not affect sale totals

1.1.1

Added

• txid: String? on TransactionModel — PIX transaction ID returned by the acquirer; present only when type == pix, null for credit/debit
• cAut: String? on TransactionModel — authorization code returned by the acquirer; present for credit/debit, null for PIX
• txid: String?, cAut: String?, cnpj: String?, tBand: String?, tPag: String? on TransactionResponseModel — model now fully mirrors dj_pay_interface.TransactionResponse

Changed

• Brand references renamed from "TefIP" to "TEF IP"

1.1.0

Added

• New displayPop endpoint (POST /display/pop) to close the current display overlay
• New salePayment.patch and salePayment.delete methods — full CRUD for sale payments
• New saleItem.patch and saleItem.delete methods — full CRUD for sale items
• New sale.patch method to update sale metadata at any point during the sale flow

Changed

• SaleItemModel.id and SalePaymentModel.id are now optional (String?) — backend manages IDs internally
• Removed SaleCreatedResponse model (sale creation now returns SuccessResponseModel)
• SaleStartRequestModel no longer exposes an id field

Testing

• Added extensive unit tests for all models: SaleItem, SalePayment, SaleStartRequest, SaleActionRequest, SaleMutationResponse, SuccessResponse, Transaction, TransactionRequest, AskFormRequest, AskOption, AskParameters, AskQuestion, AskSingleQuestionRequest, DisplayCarouselRequest, DisplayTextRequest
• Added tests for enums (TefIPTransactionType, all other enums), converters (details, images, transaction type, unix datetime), exceptions, endpoint constants, and header builder
• Added tests for new displayPop and salePayment endpoints

1.0.8

Added

• New TefIPSale endpoint for sale management (start, cancel, finalize, items, payments)
• New models: SaleStartRequest, SaleActionRequest, SaleCreatedResponse, SaleMutationResponse, SaleItem, SalePayment
• New enum TefIPSalePaymentType for sale payment types
• New tests for all sale endpoints

Fixed

• Authentication header construction error in TefIPHeadersBuilder
• Updated example/bin/main.dart to reflect correct SDK usage

Improved

• Refactored TefIPNetworkingClient with better error handling
• Updated Ask models (ask_parameters, answer) with improved structure
• General documentation and configuration updates (README.md, CLAUDE.md)

1.0.7

• Refactored TefIPTransactionType enum to carry the tPag code as a field (tPag) with a fromTPag() factory method
• Updated TefIPTransactionTypeConverter to use fromTPag() for deserialization and object.tPag for serialization (instead of object.name)
• Updated TransactionRequestModel to serialize/deserialize the transaction type under the tPag JSON key (instead of type)

1.0.6

• Updated TefIPTransactionTypeConverter to accept tPag numerical codes (03, 04, 17, 99) instead of alphabetic codes (CC, CD, PX, XX)
• Updated TefIPTransactionType @JsonValue annotations to use tPag numerical codes
• Fixed AnswerModel.displayValue parsing using @JsonKey(readValue:) instead of manual JSON manipulation in fromJson

1.0.5

• Added askCancel endpoint to cancel ongoing questions
• Refactored question models (AnswerModel, AskQuestionModel, AskParametersModel)
• Removed legacy models (QuestionOptionModel, QuestionRequestModel, QuestionResponseModel)

1.0.4

• Refactored QuestionResponseModel to use freezed
• Updated QuestionResponseModel to abstract class with factory constructor
• Updated TefIpAsk.post return type from SuccessResponseModel to QuestionResponseModel
• Updated networking layer success parser to map response into QuestionResponseModel

1.0.3

• Updated project README.md

1.0.2

• Updated project description in pubspec.yaml

1.0.1

• Added example/README.md with usage instructions
• Updated repository link in the main README.md

1.0.0

• Initial stable release of dart_tefip
• Full support for TEF IP terminal communication
• Transaction endpoints:
  • PIX
  • Credit
  • Debit
  • Transaction query (single and list)
  • Reversal
• Terminal endpoints:
  • Info
  • Status
  • Restart (Android/iOS only – returns 403 otherwise)
• Printing endpoints:
  • Print text
  • Print image
  • Print XML
• Display endpoints:
  • Display text
  • Display image
  • Display carousel
  • Clear display
• Question endpoint for terminal input
• Centralized networking layer (TefIPNetworkingClient)
  • GET
  • GET list
  • POST
  • Optional raw response handling
• Configurable base URL (TefIPConfigs.baseUrl)
• Configurable request timeout (TefIPConfigs.requestsTimeOut)
• Structured exception handling:
  • TefIPRequestException
  • TefIPUnexpectedException
• Strongly typed request and response models
• Platform-aware HTTP client abstraction (IO/Web)
• Unit test coverage for endpoints and networking layer