stactics 0.1.0 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 10a190f7f56568230486fd936c573f32110f9cbe7eed13c8e7263cad64b06165
-  data.tar.gz: 17910e95c4eb977cae2978d6e67ed47850455fdb0cfb1955ae1fa9f893abd0d0
+  metadata.gz: 84a94414829842ff1955f19025ea0d34a51d9b2fbfa8e5e03c8f447f8d05e974
+  data.tar.gz: ffe47369d3eed9549f493f5bb36d81b9bc800655950a771d07c8b95f68b9e6b3
 SHA512:
-  metadata.gz: 0dcb4e90d26597d7552de8b20573c3019c0e5af7c4ecd7c5cc4e11dfdefe365ed8329ade5a65da43cf5d05c078e2457fdd38ff7324103e74a54c9808840f82c5
-  data.tar.gz: 39a6570935436fd733d2377470abc9c46ede156ee52f92d1dfe6561ffd1a22ee2f22098c50f1a0b6ae8095683b4f987bc04f7fdf3e2d4e609aa3587a87ebca29
+  metadata.gz: f21fa7be0ec81f703edb58b2109297854aee86d0d7e0a8479b1501b4270763a7f4b28cbc1c22643e3938801bb1ac58414c9c6fa1b2b55c00a0fe328582ede477
+  data.tar.gz: d958833a18efe4f336aa97cb1fa31e83c233ee94a3f5aa28c8f8e2aaf4c5d37dc2665f2654f6c1caf5c672874493bb9e1fe0857230e3154444919ac49ba91893

data/README.md

@@ -9,9 +9,62 @@ client.track(
   "signup",
   user_id: "user_123",
   email: "founder@example.com",
+  display_name: "Sam Founder",
   environment: "production",
   metadata: { plan: "free" }
 )
+
+client.track(
+  "login",
+  user_id: "user_123",
+  email: "founder@example.com",
+  display_name: "Sam Founder",
+  device_id: "install_abc",
+  platform: "web"
+)
+
+client.track(
+  "purchase",
+  user_id: "user_123",
+  account_id: "team_123",
+  amount_cents: 1299,
+  currency: "AUD",
+  metadata: { transaction_id: "txn_123", product_id: "pro_monthly" }
+)
+
+client.track(
+  "screen_viewed",
+  user_id: "user_123",
+  platform: "web",
+  metadata: { path: "/dashboard" }
+)
+
+client.track(
+  "error",
+  user_id: "user_123",
+  platform: "web",
+  metadata: { error: "Payment provider timeout", context: "checkout" }
+)
 ```
 
 Use a `sk_...` key for server-side Ruby apps.
+
+Submit form values without retrieving form definitions through the SDK:
+
+```ruby
+client.submit_form(
+  "contact",
+  {
+    name: "Ada Founder",
+    email: "ada@example.com",
+    message: "I would like to discuss a technical collaboration.",
+    consent: true
+  },
+  source: "ruby",
+  external_user_id: "visitor_123"
+)
+```
+
+Form field keys are preserved rather than converted to event-style snake case.
+
+For revenue events, send both `amount_cents` and `currency`. Put transaction IDs, product IDs, screen names, feature names, error details, and notification details in `metadata`.

data/lib/stactics/client.rb

@@ -14,6 +14,7 @@ module Stactics
   end
 
   Result = Struct.new(:accepted?, :accepted_count, :body, keyword_init: true)
+  FormSubmissionResult = Struct.new(:accepted?, :submission_id, :submitted_at, :message, :body, keyword_init: true)
 
   class Client
     def initialize(api_key:, host: DEFAULT_HOST, timeout: 5, transport: nil)
@@ -35,6 +36,24 @@ module Stactics
       request("/v1/events/batch", payload)
     end
 
+    def submit_form(form_key, values, source: nil, external_user_id: nil)
+      raise ArgumentError, "form_key is required" if form_key.to_s.strip.empty?
+      raise ArgumentError, "values must be a hash" unless values.is_a?(Hash)
+
+      payload = { "values" => stringify_form_values(values) }
+      payload["source"] = source unless source.nil?
+      payload["external_user_id"] = external_user_id unless external_user_id.nil?
+      result = request("/v1/forms/#{URI.encode_www_form_component(form_key.to_s)}/submissions", payload)
+
+      FormSubmissionResult.new(
+        accepted?: result.accepted?,
+        submission_id: result.body["submission_id"],
+        submitted_at: result.body["submitted_at"],
+        message: result.body["message"],
+        body: result.body
+      )
+    end
+
     private
 
     def request(path, payload)
@@ -92,6 +111,19 @@ module Stactics
       end
     end
 
+    def stringify_form_values(value)
+      case value
+      when Hash
+        value.each_with_object({}) do |(key, nested_value), memo|
+          memo[key.to_s] = stringify_form_values(nested_value)
+        end
+      when Array
+        value.map { |item| stringify_form_values(item) }
+      else
+        value
+      end
+    end
+
     def camel_or_symbol_to_snake(key)
       key.to_s
          .gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2')

data/lib/stactics/version.rb

@@ -1,3 +1,3 @@
 module Stactics
-  VERSION = "0.1.0"
+  VERSION = "0.1.3"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: stactics
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.3
 platform: ruby
 authors:
 - Nexu Industries
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-17 00:00:00.000000000 Z
+date: 2026-07-17 00:00:00.000000000 Z
 dependencies: []
 description: Track analytics events from Ruby and Rails apps with Stactics.
 email: