littlefish_payments_cloud_pos 3.0.1

Cloud POS payment gateway — enables push-to-terminal card payments via the Cloud POS API. Self-contained package with API client, polling, and UI.

3.0.1

• Update a dependency to the latest release.

3.0.0

Note: This release has breaking changes.

• BREAKING FEAT(payments): thread currency symbol through refund and withdrawal too.
• BREAKING FEAT(payments): thread tenant currency symbol through gateways for display.

2.4.22

• Update a dependency to the latest release.

2.4.21

• FIX(deps-ci): update core packages.

2.4.20

• FIX(deps-ci): update core packages.

2.4.19

• Update a dependency to the latest release.

2.4.18

• Update a dependency to the latest release.

2.4.17

• Update a dependency to the latest release.

2.4.16

• Update a dependency to the latest release.

2.4.15

• Update a dependency to the latest release.

2.4.14

• Update a dependency to the latest release.

2.4.13

• REFACTOR(cloudpos): centralise base URL normalisation in client and reporter.

2.4.12

• FIX(cloudpos): fix receiver state machine transitions and status mapping.
• FIX(cloudpos): add mounted guard before restarting poll in catch block.
• FIX(cloudpos): restart periodic polling when immediate poll fails.
• FIX(cloudpos): add 'Cancelled' case to status parser.
• FIX(cloudpos): align _pollImmediately with _onRealtimeUpdate behaviour.
• FIX(cloudpos): add lifecycle observer to CloudPosPaymentPage.

2.4.11

• Update a dependency to the latest release.

2.4.10

• FIX(cloudpos): add immediate status poll on foreground resume.

2.4.9

• FIX(littlefish_payments_cloud_pos): address publish validation issue.

2.4.8

• FIX: add background fetch guard to debounce TerminalStatusChanged API calls.
• FIX(cloudpos): add retry button to error view and user-friendly error messages.
• FIX: add LoggerService to BLoC and clear stale _selectedTerminal on multi-terminal transition.
• FIX: preserve terminal list on background refresh error, wrap split-layout in BlocBuilder.
• FIX: resolve _selectedTerminal null crash in split-layout and remove side-effect from BlocBuilder.
• FIX(cloudpos): eliminate constant refresh on Select Terminal page by adopting BLoC.

2.4.7

• FIX(deps-ci): update core packages.

2.4.6

• Update a dependency to the latest release.

2.4.5

• FIX(deps-ci): update core packages.

2.4.4

• FIX(deps-ci): update core packages.

2.4.3

• FIX(deps-ci): update core packages.

2.4.2

• Update a dependency to the latest release.

2.4.1

• Update a dependency to the latest release.

2.4.0

• FIX: add customer fields to CloudPosTransactionConfig and trace logs.
• FEAT: pass customer data through CloudPOS staging pipeline.

2.3.2

• FIX: Add finaliseTransaction to CloudPosPaymentPage via _popWithResult.
• FIX: Handle 'completed' status in payment page and gateway _mapToPaymentResult.
• FIX: Route 'completed' status to success path, update progress view.
• FIX: Map approved→completed for finalise, add state guards.

2.3.1

• REFACTOR: decouple cardEnabled from CloudPOSPaymentGateway via TerminalRegistrationOverrides.

2.3.0

• FEAT(cloud-pos): handle 409 terminal-busy and 422 duplicate-order from stage endpoint.

2.2.0

• FIX: add terminalBusy case to _mapToPaymentResult in both payment page and gateway.
• FEAT(cloud_pos): handle terminal-busy (409) on client side.

2.1.0

• FIX: move event registrations before try-catch to avoid Dart on
• FIX: make BLoC logger nullable for test safety, remove residual debugPrint.
• FEAT(cloud_pos): add missing fields to CloudPosTransactionConfig and instrument field tracing.

2.0.1

• Update a dependency to the latest release.

2.0.0

Note: This release has breaking changes.

• BREAKING FEAT: add additionalInfo parameter to PaymentGateway interface.

1.4.1

• FIX(deps-ci): update core packages.

1.4.0

• FEAT: thread totalTaxMinorUnits and taxInclusive through Cloud POS staging pipeline.

1.3.0

• FEAT(cloud_pos): pass items, sellerName, sellerId through stageTransaction.

1.2.1

• Update a dependency to the latest release.

1.2.0

• FIX(littlefish_payments_cloud_pos): Corrected handling transaction push successpath on originating device.
• FEAT(littlefish_payments_cloud_pos): adjusted ui components for the success path.

1.1.1

• Update a dependency to the latest release.

1.1.0

• REFACTOR: convert ButtonPrimary to StatelessWidget, remove redundant foundation.dart import.
• REFACTOR: remove unused isOnline parameter from _buildLeadingIcon.
• REFACTOR: clean up CloudPos terminal tile — remove Online label, status dot, fix title.
• FIX: address review feedback — extract ExitConfirmationDialog, fix preferredSize, replace nested Scaffold with ColoredBox, remove dead onBackPressed.
• FIX: show single terminal confirmation view instead of auto-staging.
• FIX: add mounted guard in addPostFrameCallback for _initTerminalSelection.
• FIX(cloudpos): add timedOut to isTerminal so polling stops on timeout.
• FIX: pass BuildContext and theme to all payment channels, use UnsupportedError for CloudPOS.
• FIX: add error feedback, loading indicator, and diagnostics to CloudPos terminal refresh.
• FIX: resolve bloc_test version conflict with flutter_bloc ^9.1.1.
• FIX: use consistent businessId and preserve search query on status change.
• FIX: cancel debounce timer on clear, render custom suffixIcon.
• FIX: address Devin Review bugs - clear button setState, double-fire onFieldSubmitted, initialValue overwrite.
• FIX: handle timedOut status explicitly and extract shared fetch helper.
• FIX: add missing color_palette.dart import for toColor() extension.
• FIX(cloudpos): stub processWithdrawByAmount with graceful PaymentResult.failed.
• FIX: prevent trailing newline in subtitle when model is empty.
• FIX: address review comments - add maxLines:1 to title, eliminate double DI lookup.
• FIX: guard onTap behind isOnline to prevent tapping offline terminals.
• FIX: add proper type for colorPalette in _buildLeadingIcon.
• FIX: replace non-existent secondarySurface with secondary on ColorPalette.
• FIX: remove close button, use scaffold back navigation with onBackPressed for cancel.
• FIX: add expand: false to terminal selector cancel button for consistency.
• FIX: make showRetry and showControls mutually exclusive.
• FIX: use maxLines 1 in horizontal layout to match ButtonPrimary.
• FIX: add missing PaymentProviderType import in CloudPos gateway.
• FIX: add missing material.dart import for MaterialPageRoute in CloudPos gateway.
• FIX: remove re-export of abstract base from barrel file.
• FIX: preserve timeout stopwatch on non-terminal SignalR updates.
• FIX: wrap _isRefreshingTerminals in setState for proper UI rebuild.
• FIX: refresh terminal list when switching back to selection phase.
• FIX: include targetTerminalId in transaction payload.
• FIX: correct PaymentResult constructor usage in CloudPos gateway.
• FIX: exclude originating terminal from terminal selection list.
• FIX: correct border radius logic — always apply shape, use widget.radius when custom.
• FIX: add null check for icon in vertical layout to avoid empty widget.
• FIX: address Devin Review bugs — add isTerminal guard, _hasPopped double-pop prevention, fix copyWith statusMessage.
• FIX: use maxLines parameter for PrimaryButtonTextSize.small instead of hardcoded 1.
• FIX: include transactionPayload in stageTransaction request and fix originatingTerminalId.
• FIX: respect disabled state for icon foreground in icon-only mode.
• FIX: correct terminalName property and abandon transaction on terminal switch.
• FEAT: add BottomControls component for CloudPos (Stage 2.d + 2.e).
• FEAT: add CloudPosButtonSecondary component (Stage 2.c).
• FEAT(cloudpos): address red screen and enhance ui.
• FEAT: integrate ButtonPrimary into CloudPosProgressView and CloudPosTerminalSelector.
• FEAT: Cloud POS Phase 2 — Flutter payment gateway package.
• FEAT: add CloudPosAppScaffold, CloudPosCustomAppBar, KeyboardDismissalUtility and use scaffold in CloudPosPaymentPage.
• FEAT: add CloudPos state views — No Terminals, Pushing Sale, Transaction Failed, Loading, Error (Stage 3.c).
• FEAT: clone ButtonPrimary component for CloudPos with ThemeManager theming.
• FEAT: add onExitRequested callback and enableExitConfirmation bool to CloudPosAppScaffold.
• FEAT: wire BottomControls into CloudPosPaymentPage terminal selection phase.
• FEAT: move Cancel to BottomControls, remove from terminal selector.
• FEAT: add CloudPosTerminalStatusNotifier and refresh terminal list on status change.
• FEAT: add CloudPosTerminalTile to payment package (Stage 2.f).
• FEAT: add CloudPosSearchTextField component (Stage 2.g).
• FEAT: add CloudPosRealtimeNotifier bridge — connect SignalR updateSalesV1 to CloudPosPaymentPage.
• FEAT: Phase 2 logging — add LoggerService structured logs alongside debugPrint (Stage A).
• FEAT: add pushed and failed statuses to CloudPosTransactionStatus.
• FEAT: add CloudPos BLoC foundation — Terminal List + Transaction (Stages 3.a + 3.b).
• FEAT: add CloudPosTerminalSelectionPage + barrel exports (Stages 3.d + 3.e).
• FEAT: replace dark overlay and bare spinners with consistent CloudPosLoadingView.
• FEAT: add CloudPosSingleTerminalConfirmationView widget (Stage 4.b).
• FEAT: register CloudPOSPaymentGateway in PaymentManager.
• FEAT: add CloudPosTerminalListSingleTerminal state and ShowAllTerminals event (Stage 4.a).
• FEAT: wire up CloudPos payment gateway with Navigator pattern.
• FEAT: add single-terminal routing logic and barrel export (Stages 4.c + 4.d).
• FEAT(cloudpos): responsive layouts.
• FEAT: add debugPrint logging to ThemeSettings fallback catch block.
• DOCS: add README.md for littlefish_payments_cloud_pos package.

1.0.0

• Initial release of Cloud POS payment gateway package
• CloudPosApiClient for backend API communication
• CloudPOSPaymentGateway extending PaymentGateway
• Models: CloudPosProvider, CloudPosTransaction, CloudPosTerminal, CloudPosStatus
• Polling-based transaction status monitoring
• Terminal selector and progress presentation widgets