vindi-rails-engines 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c338b9c48768fa14df28c2a9a80eebb9df434761f290ad13238ee2bd356eb69e
+  data.tar.gz: c0fc63e9050e804ca08128032937ef984f0f24ca02f742f8f436bc931b0e0961
+SHA512:
+  metadata.gz: 291d5f38a07ddb1845bdf5e045095286a2b047653680d567c35ca0504de8de8ae6035a19018f7085e2d84b739edcfd81b19c8cc1b714c21cbac0bfe9bf4523a1
+  data.tar.gz: 90f00aeee250ac82f02a1ec835260219faf67f6dfbb3ad930517aa555a2db0fb0a638f94628b06a5da452295f3d9ae6408a8e5fa551c3b4fab0a74e86105c5bc

data/README.md

@@ -0,0 +1,37 @@
+# Vindi Rails Engines
+
+[Leia em Português (README.pt-BR.md)](./README.pt-BR.md)
+
+An extension gem for the [vindi-rails](https://github.com/wesleyskap/vindi-rails) core SDK, providing mountable frontend checkouts, HTML views, and Stimulus JS credit card tokenization components using Vindi's public keys encryption.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'vindi-rails-engines'
+```
+
+## Features & Usage
+
+### 1. Checkout UI Setup
+Copy Stimulus JS tokenization components and checkout form partial views to your application:
+```bash
+bundle exec rails generate vindi:checkout
+```
+This generates:
+- Checkout view form partial (`app/views/vindi/checkout/_form.html.erb`)
+- Stimulus controller (`app/javascript/controllers/vindi_checkout_controller.js`)
+
+### 2. Environment Setup
+Configure your public key in your environment file:
+```bash
+ENV["VINDI_PUBLIC_KEY"] = "YOUR_PUBLIC_KEY"
+```
+
+## Running Tests
+
+To run the Minitest suite:
+```bash
+bundle exec rake test
+```

data/lib/generators/vindi/checkout_generator.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+
+module Vindi
+  module Generators
+    class CheckoutGenerator < ::Rails::Generators::Base
+      source_root File.expand_path("templates", __dir__)
+
+      desc "Copies Vindi checkout Stimulus JS and view templates to your Rails application."
+
+      def copy_checkout_templates
+        copy_file "_form.html.erb", "app/views/vindi/checkout/_form.html.erb"
+        copy_file "checkout_controller.js", "app/javascript/controllers/vindi_checkout_controller.js"
+      end
+    end
+  end
+end

data/lib/generators/vindi/templates/_form.html.erb

@@ -0,0 +1,39 @@
+<!-- Vindi PCI-Compliant Checkout Form -->
+<%= form_with url: checkout_path, local: true, data: { controller: "vindi-checkout" } do |f| %>
+  <!-- Vindi Public Key configured in environment -->
+  <input type="hidden" id="vindi-public-key" value="<%= ENV['VINDI_PUBLIC_KEY'] %>" data-vindi-checkout-target="publicKey">
+
+  <div class="form-group">
+    <label for="card_holder">Cardholder Name</label>
+    <input type="text" id="card_holder" class="form-control" data-vindi-checkout-target="holderName" placeholder="JOHN DOE" required>
+  </div>
+
+  <div class="form-group">
+    <label for="card_number">Card Number</label>
+    <input type="text" id="card_number" class="form-control" data-vindi-checkout-target="cardNumber" placeholder="4111 1111 1111 1111" required>
+  </div>
+
+  <div class="form-row">
+    <div class="form-group col-md-6">
+      <label for="card_expiry">Expiration Date</label>
+      <input type="text" id="card_expiry" class="form-control" data-vindi-checkout-target="expiry" placeholder="MM/YYYY" required>
+    </div>
+
+    <div class="form-group col-md-6">
+      <label for="card_cvv">CVV</label>
+      <input type="password" id="card_cvv" class="form-control" data-vindi-checkout-target="cvv" placeholder="123" required>
+    </div>
+  </div>
+
+  <!-- Hidden field to store the encrypted card token returned by Vindi -->
+  <%= f.hidden_field :payment_profile_token, data: { vindi_checkout_target: "tokenInput" } %>
+
+  <div class="form-group mt-3">
+    <button type="submit" class="btn btn-primary btn-block" data-action="click->vindi-checkout#tokenizeCard">
+      Pay Securely
+    </button>
+  </div>
+<% end %>
+
+<!-- Load Vindi Tokenizer JS Library -->
+<script src="https://sandbox-gp.vindi.com.br/assets/vindi.js"></script>

data/lib/generators/vindi/templates/checkout_controller.js

@@ -0,0 +1,29 @@
+import { Controller } from "@hotwired/stimulus"
+
+// Connects to data-controller="vindi-checkout"
+export default class extends Controller {
+  static targets = [ "publicKey", "holderName", "cardNumber", "expiry", "cvv", "tokenInput" ]
+
+  tokenizeCard(event) {
+    event.preventDefault()
+    
+    const vindi = new Vindi(this.publicKeyTarget.value)
+    
+    const cardData = {
+      holder_name: this.holderNameTarget.value,
+      card_number: this.cardNumberTarget.value.replace(/\s+/g, ''),
+      card_expiration: this.expiryTarget.value,
+      card_cvv: this.cvvTarget.value
+    }
+
+    vindi.createToken(cardData)
+      .then((response) => {
+        // Set the token into the hidden field and submit the form
+        this.tokenInputTarget.value = response.token
+        this.element.submit()
+      })
+      .catch((error) => {
+        alert("Payment Error: " + error.message)
+      })
+  }
+}

data/lib/vindi/engines/engine.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Vindi
+  class Engine < ::Rails::Engine
+    isolate_namespace Vindi
+  end
+end

data/lib/vindi/engines/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Vindi
+  module Engines
+    VERSION = "0.1.0"
+  end
+end

data/lib/vindi-rails-engines.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require "vindi"
+require_relative "vindi/engines/version"
+require_relative "vindi/engines/engine" if defined?(Rails)
+
+module Vindi
+  module Engines
+    class Error < StandardError; end
+  end
+end

metadata

@@ -0,0 +1,109 @@
+--- !ruby/object:Gem::Specification
+name: vindi-rails-engines
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Wesley Lima
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-06-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: vindi-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Encapsulates reusable front-end screens, checkout templates, and credit
+  card tokenization components.
+email:
+- wesleyskap@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/generators/vindi/checkout_generator.rb
+- lib/generators/vindi/templates/_form.html.erb
+- lib/generators/vindi/templates/checkout_controller.js
+- lib/vindi-rails-engines.rb
+- lib/vindi/engines/engine.rb
+- lib/vindi/engines/version.rb
+homepage: https://github.com/wesleyskap/vindi-rails
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/wesleyskap/vindi-rails
+  source_code_uri: https://github.com/wesleyskap/vindi-rails
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Rails mountable UI Engines for Vindi checkout and payment screens.
+test_files: []