Release 1.2.0

.github/workflows/pub_dev_publish.yml

@@ -0,0 +1,55 @@
+# DO NOT RUN THIS MANUALLY - THIS GETS RUN AS PART OF A DIFFERENT GH ACTIONS SCRIPT
+
+name: Publish Release to Pub.dev
+on:
+  push:
+    tags:
+      - '[0-9]+.[0-9]+.[0-9]+*'
+
+env:
+  FLUTTER_VERSION: 3.16.1
+
+jobs:
+  Release-It-To-The-People:
+    runs-on: macos-13
+    environment: live_pub_dev
+    permissions: 
+      id-token: write
+      contents: read
+    steps:
+      - name: "Test Release Check"
+        id: test-release-check
+        run: |
+          if [[ ${{ github.repository_owner }} == *"ololabs-playground"* ]]
+          then
+            echo "is-test=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "is-test=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: "Checkout Project"
+        uses: actions/checkout@v3
+
+      - name: Setup Flutter
+        uses: flutter-actions/[email protected]
+        with:
+          channel: stable
+          version: ${{ env.FLUTTER_VERSION }}
+
+      - name: "Install Flutter Dependencies"
+        run: | 
+          flutter pub get
+
+      - name: "Publish Dry Run"
+        if: ${{ steps.test-release-check.outputs.is-test == 'true' }}
+        run: |
+          flutter pub publish --dry-run
+
+      - name: "Pub.dev Token Authentication"
+        if: ${{ steps.test-release-check.outputs.is-test == 'false' }}
+        uses: dart-lang/setup-dart@v1
+
+      - name: "Publish Release"
+        if: ${{ steps.test-release-check.outputs.is-test == 'false' }}
+        run: flutter pub publish --force
+

CHANGELOG.md

@@ -0,0 +1,113 @@
+# Olo Pay Flutter SDK Changelog
+
+## v1.2.0 (Aug 20, 2024)
+
+### Updates
+- `CardDetailsSingleLineTextField`: Added ability to set alignment of the built in error message with `errorAlignment`
+- `CardDetailsSingleLineTextField`: Changed default `maxHeight` to `45`
+- `CardDetailsSingleLineTextField`: Changed default `errorMarginTop` to `8.0`
+- Deprecated `ErrorCodes.missingParameter`: All previous usages have changed to `ErrorCodes.InvalidParameter`
+- Introduce `CvvTextField` widget for CVV tokenization.
+
+### Dependency Updates
+- Native SDKs
+    - Updated to use [Olo Pay Android SDK v3.1.1](https://github.com/ololabs/olo-pay-android-sdk-releases/releases/tag/3.1.1)
+    - Updated to use [Olo Pay iOS SDK v4.0.2](https://github.com/ololabs/olo-pay-ios-sdk-releases/releases/tag/4.0.2)
+
+- Android Project
+    - Updated to Gradle v8.2
+    - Updated to Java v17
+    - Updated to `com.android.tools.build:gradle:8.2.2`
+    - Updated to `androidx.core:core-ktx:1.13.1`
+    - Updated to `org.jetbrains.kotlinx:kotlinx-coroutines-android:1.8.1`
+    - Updated to `com.google.android.material:material:1.12.0`
+
+### Bug Fixes
+- `CardDetailsSingleLineTextField`: Fix bug causing slight difference between the default input text error state color and the default error message color.
+- `CardDetailsSingleLineTextField`: Fixed constraints so that the text input widget height properly expands/shrinks to match the height specified by the constructor parameters
+
+## v1.1.0 (Mar 26, 2024) - First Public Release
+
+### Breaking Changes
+- `OloPaySetupParameters`: Removed `freshSetup` parameter
+
+### Updates
+- `CardDetailsSingleLineTextField`: Added built-in error message label to automatically display error messages
+- `CardDetailsSingleLineTextField`: Added `errorStyles` property to style the built-in error message label
+- `CardDetailsSingleLineTextField`: Added `displayErrorMessages` property to control visibility of the error message label
+- `CardDetailsSingleLineTextField`: Added custom error message support via the `customErrorMessages` property
+- `CardDetailsSingleLineTextField`: Added support for custom fonts via `TextStyles`
+- `CardDetailsSingleLineTextField`: Fixed issue on iOS sometimes causing duplicate error messages to display
+- `OloPaySdk`: Added `getFontNames()` for help with debugging custom font issues on iOS
+- `OloPaySdk`: Changed `isDigitalWalletReady()` on iOS so it returns false if the SDK isn't initialized to align with Android behavior
+- `TextStyles`: Added `fontAsset` and `iOSFontName` properties
+
+## v1.0.1 (Feb 7, 2024)
+
+### Bug Fixes
+- `CardDetailsSingleLineTextField`: Fix small edge case preventing `textStyles` and `paddingStyles` from respecting theme values
+- `CardType`: Fix typo causing Mastercard cards to map to `CardType.unknown`
+
+### Updates
+- `TextStyles`: Fixed incorrect documentation for `merge()`
+- `TextStyles`: Added `defaultCursorColor` property
+
+## v1.0.0 (Jan 26, 2024)
+
+### Updates
+- ReadMe updates
+
+## v0.3.0 (Jan 17, 2024)
+
+### Breaking Changes
+- Consolidate import statements so only one is required
+- Renamed classes and types for clarity
+    - `PaymentCardDetailsSingleLineWidget` --> `CardDetailsSingleLineTextField`
+    - `PaymentCardDetailsSingleLineWidgetController` --> `CardDetailsSingleLineTextFieldController`
+    - `PaymentCardDetailsSingleLineWidgetControllerCreated` --> `CardDetailsSingleLineTextFieldControllerCreated`
+    - `PaymentCardDetailsSingleLineWidgetOnErrorMessageChanged` --> `CardDetailsErrorMessageChanged`
+    - `PaymentCardDetailsSingleLineWidgetOnInputChanged` --> `CardDetailsInputChanged`
+    - `PaymentCardDetailsSingleLineWidgetOnValidStateChanged` --> `CardDetailsValidStateChanged`
+    - `PaymentCardDetailsSingleLineWidgetOnFocusChanged` --> `CardDetailsFocusChanged`
+- `PaymentMethod.cardType`: Changed type from `String` to `CardType`
+- Updated all data classes to use `final` properties and `const` constructors
+    - `OloPaySetupParameters`
+    - `GooglePaySetupParameters`
+    - `ApplePaySetupParameters`
+    - `DigitalWalletPaymentParameters`
+    - `GooglePayVendorParameters`
+    - `PaymentMethod`
+    - `CardFieldState`
+    - `Hints`
+    - `TextStyles`
+    - `BackgroundStyles`
+    - `PaddingStyles`
+
+### Updates
+- Change minimum iOS version to iOS 13
+- `CardDetailsSingleLineTextField`: Add support for light/dark themes
+- `CardDetailsSingleLineTextField`: Add explicit default styles
+- `CardDetailsSingleLineTextField`: Add support for updating styles based on state changes
+
+
+## v0.2.0 (Dec 21, 2023)
+
+### Breaking Changes
+- `OloPaySdk.initializeOloPay()`: Changed from positional to named parameters
+- `PaymentCardDetailsSingleLineWidgetControllerCreated`: Moved typedef to `data_types.dart`
+- `PaymentCardDetailsSingleLineWidget`: Changed `onControllerCreated` to a required parameter
+
+### Updates
+- `PaymentCardDetailsSingleLineWidget`: Background and text styling support
+- `PaymentCardDetailsSingleLineWidget`: Added event handlers for error message changes, valid state changes, and input changes
+- `PaymentCardDetailsSingleLineWigetController`: Additional methods for controlling/interacting with the widget
+- Digital Wallet Support (Apple Pay & Google Pay)
+
+
+## v0.1.0 (Dec 11, 2023)
+
+### Initial Release
+- Use `PaymentCardDetailsSingleLineWidget` to display a single line card input widget 
+- Use `PaymentCardDetailsSingleLineWidgetController.createPaymentMethod` to create a payment method based on user-entered card details
+- Uses [Olo Pay Android SDK v3.0.0](https://github.com/ololabs/olo-pay-android-sdk-releases/releases/tag/v3.0.0-full)
+- Uses [Olo Pay iOS SDK v4.0.0](https://github.com/ololabs/olo-pay-ios-sdk-releases/releases/tag/v4.0.0)

LICENSE

@@ -0,0 +1,10 @@
+**Olo Pay Software Development Kit License Agreement**
+
+Copyright © 2022 Olo Inc.  All rights reserved.
+
+Subject to the terms and conditions of the license, you are hereby granted a non-exclusive, worldwide, royalty-free license to (a) copy and modify the software in source code or binary form for your use in connection with the software services and interfaces provided by Olo, and (b) redistribute unmodified copies of the software to third parties.  The above copyright notice and this license shall be included in or with all copies or substantial portions of the software.
+
+Your use of this software is subject to the Olo APIs Terms of Use, available at https://www.olo.com/api-usage-terms. This license does not grant you permission to use the trade names, trademarks, service marks, or product names of Olo, except as required for reasonable and customary use in describing the origin of the software and reproducing the content of this license.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+