wowsql-sdk 1.3.0 → 3.0.1

data/lib/wowsql/table.rb

@@ -9,22 +9,34 @@ module WOWSQL
     end
 
     # Start a query with column selection.
-    # 
+    #
     # @param columns [Array<String>] Column(s) to select
     # @return [QueryBuilder] QueryBuilder for chaining
     def select(*columns)
       QueryBuilder.new(@client, @table_name).select(*columns)
     end
 
+    # Start a query with a filter.
+    #
+    # @param column [String, Hash] Column name or filter hash
+    # @param operator [String, nil] Operator
+    # @param value [Object] Filter value
+    # @param logical_op [String] "AND" or "OR"
+    # @return [QueryBuilder] QueryBuilder for chaining
+    def filter(column, operator = nil, value = nil, logical_op: 'AND')
+      QueryBuilder.new(@client, @table_name).filter(column, operator, value, logical_op: logical_op)
+    end
+
     # Get all records with optional filters.
-    # 
+    #
+    # @param options [Hash, nil] Query options
     # @return [Hash] Query response
-    def get
-      QueryBuilder.new(@client, @table_name).get
+    def get(options = nil)
+      QueryBuilder.new(@client, @table_name).get(options)
     end
 
     # Get a single record by ID.
-    # 
+    #
     # @param record_id [Object] Record ID
     # @return [Hash] Record data
     def get_by_id(record_id)
@@ -32,7 +44,7 @@ module WOWSQL
     end
 
     # Create a new record.
-    # 
+    #
     # @param data [Hash] Record data
     # @return [Hash] Create response with new record ID
     def create(data)
@@ -40,15 +52,59 @@ module WOWSQL
     end
 
     # Insert a new record (alias for create).
-    # 
+    #
     # @param data [Hash] Record data
     # @return [Hash] Create response with new record ID
     def insert(data)
       create(data)
     end
 
+    # Insert multiple records.
+    #
+    # Attempts a single batch POST first. Falls back to individual
+    # inserts if the server does not support batch creation.
+    #
+    # @param records [Array<Hash>] List of record hashes
+    # @return [Array<Hash>] List of create responses
+    def bulk_insert(records)
+      return [] if records.nil? || records.empty?
+
+      begin
+        result = @client.request('POST', "/#{@table_name}", nil, records)
+        result.is_a?(Array) ? result : [result]
+      rescue StandardError
+        records.map { |record| create(record) }
+      end
+    end
+
+    # Insert or update based on conflict column.
+    #
+    # Uses PostgreSQL ON CONFLICT (upsert). Falls back to
+    # get-then-insert/update when the backend doesn't expose
+    # a native upsert endpoint.
+    #
+    # @param data [Hash] Record data (must include the conflict column)
+    # @param on_conflict [String] Column to check for conflicts (default: "id")
+    # @return [Hash] Create or update response
+    def upsert(data, on_conflict: 'id')
+      conflict_value = data[on_conflict] || data[on_conflict.to_sym]
+      return create(data) if conflict_value.nil?
+
+      existing = QueryBuilder.new(@client, @table_name).eq(on_conflict, conflict_value).first
+      if existing
+        update_data = data.reject { |k, _| k.to_s == on_conflict }
+        if update_data.empty?
+          { 'message' => 'No changes', 'affected_rows' => 0 }
+        else
+          update(conflict_value, update_data)
+        end
+      else
+        create(data)
+      end
+    end
+
     # Update a record by ID.
-    # 
+    #
     # @param record_id [Object] Record ID
     # @param data [Hash] Data to update
     # @return [Hash] Update response
@@ -57,12 +113,57 @@ module WOWSQL
     end
 
     # Delete a record by ID.
-    # 
+    #
     # @param record_id [Object] Record ID
     # @return [Hash] Delete response
     def delete(record_id)
       @client.request('DELETE', "/#{@table_name}/#{record_id}", nil, nil)
     end
+
+    # ── Convenience shortcuts ──────────────────────────────────
+
+    def eq(column, value)
+      QueryBuilder.new(@client, @table_name).eq(column, value)
+    end
+
+    def neq(column, value)
+      QueryBuilder.new(@client, @table_name).neq(column, value)
+    end
+
+    def gt(column, value)
+      QueryBuilder.new(@client, @table_name).gt(column, value)
+    end
+
+    def gte(column, value)
+      QueryBuilder.new(@client, @table_name).gte(column, value)
+    end
+
+    def lt(column, value)
+      QueryBuilder.new(@client, @table_name).lt(column, value)
+    end
+
+    def lte(column, value)
+      QueryBuilder.new(@client, @table_name).lte(column, value)
+    end
+
+    def order_by(column, direction = 'asc')
+      QueryBuilder.new(@client, @table_name).order_by(column, direction)
+    end
+
+    # Get total record count for this table.
+    #
+    # @return [Integer]
+    def count
+      QueryBuilder.new(@client, @table_name).count
+    end
+
+    # Paginate all records in this table.
+    #
+    # @param page [Integer] Page number (1-indexed)
+    # @param per_page [Integer] Records per page
+    # @return [Hash]
+    def paginate(page: 1, per_page: 20)
+      QueryBuilder.new(@client, @table_name).paginate(page: page, per_page: per_page)
+    end
   end
 end
-

data/lib/wowsql/version.rb

@@ -1,4 +1,4 @@
 module WOWSQL
-  VERSION = "1.0.0"
+  VERSION = "3.0.1"
 end
 

data/lib/wowsql.rb

@@ -4,8 +4,8 @@ require_relative 'wowsql/client'
 require_relative 'wowsql/table'
 require_relative 'wowsql/query_builder'
 require_relative 'wowsql/auth'
+require_relative 'wowsql/storage'
+require_relative 'wowsql/schema'
 
 module WOWSQL
-  # Main module for WOWSQL SDK
 end
-

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: wowsql-sdk
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 3.0.1
 platform: ruby
 authors:
 - WOWSQL Team
@@ -23,6 +23,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: faraday-multipart
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: json
   requirement: !ruby/object:Gem::Requirement
@@ -65,8 +79,8 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '13.0'
-description: Official Ruby client library for WOWSQL - MySQL Backend-as-a-Service
-  with S3 Storage
+description: Official Ruby client library for WOWSQL - PostgreSQL Backend-as-a-Service
+  with Object Storage
 email:
 - support@wowsql.com
 executables: []
@@ -81,6 +95,7 @@ files:
 - lib/wowsql/client.rb
 - lib/wowsql/exceptions.rb
 - lib/wowsql/query_builder.rb
+- lib/wowsql/schema.rb
 - lib/wowsql/storage.rb
 - lib/wowsql/table.rb
 - lib/wowsql/version.rb
@@ -104,6 +119,6 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 4.0.2
 specification_version: 4
-summary: Official Ruby client library for WOWSQL - MySQL Backend-as-a-Service with
-  S3 Storage
+summary: Official Ruby client library for WOWSQL - PostgreSQL Backend-as-a-Service
+  with Object Storage
 test_files: []