basic working

Author: manu4543

.vscode/extensions.json

@@ -0,0 +1,14 @@
+{
+  "recommendations": [
+    "shopify.ruby-lsp",
+    "sorbet.sorbet-vscode-extension", 
+    "soutaro.rbs-syntax",
+    "bradlc.vscode-tailwindcss",
+    "github.copilot",
+    "github.copilot-chat"
+  ],
+  "unwantedRecommendations": [
+    "rebornix.ruby",
+    "castwide.solargraph"
+  ]
+}

.vscode/settings.json

@@ -0,0 +1,37 @@
+{
+  "ruby.interpreter": "ruby",
+  "ruby.pathToBundler": "bundle",
+  "ruby.useLanguageServer": true,
+  "ruby.lint": {
+    "rubocop": true,
+    "ruby": true
+  },
+  "ruby.format": "rubocop",
+  "sorbet.enabled": true,
+  "sorbet.typeCheckingMode": "strict",
+  "sorbet.watchmanPath": "watchman",
+  "files.associations": {
+    "*.rb": "ruby",
+    "*.rbi": "ruby",
+    "*.rbs": "rbs",
+    "Gemfile": "ruby",
+    "Rakefile": "ruby"
+  },
+  "editor.formatOnSave": true,
+  "editor.codeActionsOnSave": {
+    "source.fixAll.rubocop": "explicit"
+  },
+  "[ruby]": {
+    "editor.defaultFormatter": "Shopify.ruby-lsp",
+    "editor.formatOnSave": true,
+    "editor.tabSize": 2,
+    "editor.insertSpaces": true,
+    "editor.semanticHighlighting.enabled": true,
+    "editor.suggest.insertMode": "replace"
+  },
+  "[rbs]": {
+    "editor.defaultFormatter": "soutaro.rbs-syntax",
+    "editor.tabSize": 2,
+    "editor.insertSpaces": true
+  }
+}

examples/test_helper.rb

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+
+require_relative "../lib/imagekit"
+
+# Create an ImageKit client
+image_kit = Imagekit::Client.new(
+  private_key: "private_test_key_123",
+  password: "test_password"
+)
+
+# Create some sample transformations (they can be empty for now since we're returning a fixed URL)
+transformations = [
+  Imagekit::Models::Transformation.new(
+    height: 300,
+    width: 400,
+    shadow: true
+  )
+]
+
+# Test all helper functions
+puts "Testing helper functions:"
+puts "1. buildURL: #{image_kit.helpers.buildURL(transformations)}"
+puts "2. generateTransformationString: #{image_kit.helpers.generateTransformationString(transformations)}"
+puts "3. GetAuthenticationParameters: #{image_kit.helpers.GetAuthenticationParameters}"
+puts "All helper functions are working!"

lib/imagekit.rb

@@ -175,3 +175,4 @@
 require_relative "imagekit/resources/folders"
 require_relative "imagekit/resources/folders/job"
 require_relative "imagekit/resources/webhooks"
+require_relative "imagekit/helpers/helper"

lib/imagekit/client.rb

@@ -49,6 +49,9 @@ class Client < Imagekit::Internal::Transport::BaseClient
     # @return [Imagekit::Resources::Webhooks]
     attr_reader :webhooks
 
+    # @return [Imagekit::Helpers::Helper]
+    attr_reader :helpers
+
     # @api private
     #
     # @return [Hash{String=>String}]
@@ -120,6 +123,7 @@ def initialize(
       @accounts = Imagekit::Resources::Accounts.new(client: self)
       @beta = Imagekit::Resources::Beta.new(client: self)
       @webhooks = Imagekit::Resources::Webhooks.new(client: self)
+      @helpers = Imagekit::Helpers::Helper.new(client: self)
     end
   end
 end

lib/imagekit/helpers/helper.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Imagekit
+  module Helpers
+    class Helper
+      # Builds a URL with transformations applied
+      #
+      # @param transformations [Array<Imagekit::Models::Transformation>] Array of transformation objects
+      # @return [String] The built URL with transformations
+      def buildURL(transformations)
+        # TODO: Implement actual URL building logic
+        # For now, return a fixed URL as requested
+        "https://ik.imagekit.io/your_imagekit_id/sample-image.jpg?tr=w-400,h-300"
+      end
+
+      # Generates transformation string from transformation objects
+      #
+      # @param transformations [Array<Imagekit::Models::Transformation>] Array of transformation objects
+      # @return [String] The transformation string (e.g., "w-400,h-300")
+      def generateTransformationString(transformations)
+        # TODO: Implement actual transformation string generation
+        # For now, return a fixed transformation string
+        "w-400,h-300"
+      end
+
+      # Gets authentication parameters for ImageKit requests
+      #
+      # @param token [String, nil] Optional token for authentication
+      # @return [Hash] Authentication parameters
+      def GetAuthenticationParameters(token = nil)
+        # TODO: Implement actual authentication parameter generation
+        # For now, return a fixed hash
+        {
+          signature: "dummy_signature",
+          expire: Time.now.to_i + 3600,
+          token: token || "dummy_token"
+        }
+      end
+
+      # @api private
+      #
+      # @param client [Imagekit::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

rbi/imagekit/client.rbi

@@ -44,6 +44,9 @@ module Imagekit
     sig { returns(Imagekit::Resources::Webhooks) }
     attr_reader :webhooks
 
+    sig { returns(Imagekit::Helpers::Helper) }
+    attr_reader :helpers
+
     # @api private
     sig { override.returns(T::Hash[String, String]) }
     private def auth_headers

rbi/imagekit/helpers/helper.rbi

@@ -0,0 +1,34 @@
+# typed: strong
+
+module Imagekit
+  module Helpers
+    class Helper
+      sig { params(client: Imagekit::Client).void }
+      def initialize(client:); end
+
+      # Builds a URL with transformations applied
+      sig do
+        params(
+          transformations: T::Array[Imagekit::Models::Transformation]
+        ).returns(String)
+      end
+      def buildURL(transformations); end
+
+      # Generates transformation string from transformation objects
+      sig do
+        params(
+          transformations: T::Array[Imagekit::Models::Transformation]
+        ).returns(String)
+      end
+      def generateTransformationString(transformations); end
+
+      # Gets authentication parameters for ImageKit requests
+      sig do
+        params(token: T.nilable(String)).returns(
+          T::Hash[Symbol, T.any(String, Integer)]
+        )
+      end
+      def GetAuthenticationParameters(token = nil); end
+    end
+  end
+end

sig/imagekit/client.rbs

@@ -28,6 +28,8 @@ module Imagekit
 
     attr_reader webhooks: Imagekit::Resources::Webhooks
 
+    attr_reader helpers: Imagekit::Helpers::Helper
+
     private def auth_headers: -> ::Hash[String, String]
 
     def base_url_overridden?: -> bool

sig/imagekit/helpers/helper.rbs

@@ -0,0 +1,16 @@
+module Imagekit
+  module Helpers
+    class Helper
+      def initialize: (client: Imagekit::Client) -> void
+
+      # Builds a URL with transformations applied
+      def buildURL: (Array[Imagekit::Models::Transformation] transformations) -> String
+
+      # Generates transformation string from transformation objects
+      def generateTransformationString: (Array[Imagekit::Models::Transformation] transformations) -> String
+
+      # Gets authentication parameters for ImageKit requests
+      def GetAuthenticationParameters: (?String? token) -> Hash[Symbol, (String | Integer)]
+    end
+  end
+end