servizehub 1.0.3 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 77e3e2da8a75ddc0ab89805b772214d58f81415bc264b025c79fb81fb1677af7
-  data.tar.gz: 0e3337c741f5ae796d80c6722ac5cf86725a7c46a1333d64ca9a85fa97518f7b
+  metadata.gz: 703bb932d579389a19ba02c1df3efe5f62194d2846d81dc0d327fcd56534c3f4
+  data.tar.gz: de1d3ded4f82b5d9de52c225da0a4d1aaf32d35f16ce11c614c0f27819bc89be
 SHA512:
-  metadata.gz: 85c96d41f1f00470aff1cf7a74f84d87c8708b5613d5fb21d32f72790740f1cadb68fdcea5ec6e1a5c6ee2ca5fb3f780a1edaa1b9501d3eca9bac47289668e9e
-  data.tar.gz: df38414d443644c58e404577026530435d36217e14f50f3f1afa7d20272a6762cbb11fa70550e2d175ae4dcc2ed852512b3fcfc9fb106a7f2800021e87222f6e
+  metadata.gz: 12d0866255dfb72862dc2268a28e6aff48cc0e3076c8e44fc633d5c5a47e5040a0f2af364611e74cbf586f6bc2039daeb36d408a36da58108fdf1207bb3a406f
+  data.tar.gz: d1335dd0ce59b5dd41caf1bcdfeca621e71dffdac984c0a0ca335dcec6c00e02e94b56bc480211b9500dee921dcba88c28ec41150e3867b15e756789b264eda0

data/README.md

@@ -0,0 +1,110 @@
+# ServizeHub SDK
+
+## Install
+Install using RubyGems:
+
+```bash
+gem install servizehub
+```
+
+Or add it to your `Gemfile`:
+
+```ruby
+gem "servizehub"
+```
+
+Requires Ruby 2.7+. The SDK uses only the standard library (`net/http`, `uri`, `json`, `date`) —
+no runtime dependencies.
+
+## Usage
+
+```ruby
+require "servizehub"
+
+client = Servizehub::Client.new("encryptedkey")
+
+response = client.send_booking(
+  date: "2026-04-15",
+  service_type: "Photography",
+  status: "available"
+)
+puts response
+```
+
+## Configuration
+
+| Argument   | Required | Default                                   | Description                                  |
+| ---------- | -------- | ----------------------------------------- | -------------------------------------------- |
+| `api_key`  | Yes      | —                                         | Your ServizeHub vendor API key.               |
+| `base_url:`| No       | `https://service.servizehub.com/external` | API base URL. Override to target another environment. |
+
+### Environments
+
+Leave `base_url:` out and the SDK talks to **production**:
+
+```ruby
+# production — https://service.servizehub.com/external
+client = Servizehub::Client.new("vnd_live_key")
+```
+
+Pass `base_url:` to point the SDK at another environment, such as **dev**:
+
+```ruby
+# dev — https://servizehubuserdev.notasco.in/external
+client = Servizehub::Client.new(
+  "vnd_test_key",
+  base_url: "https://servizehubuserdev.notasco.in/external"
+)
+```
+
+Notes:
+
+- `base_url:` is the full base **including** the `/external` path segment. Endpoints
+  are appended to it, e.g. `#{base_url}/capture-availability`.
+- Trailing slashes are stripped, so `.../external/` and `.../external` behave the same.
+- The default is exposed as `Servizehub::Client::DEFAULT_BASE_URL`, and the resolved
+  value as `client.base_url`.
+
+Keep the URL out of your source by reading it from the environment:
+
+```ruby
+client = Servizehub::Client.new(
+  ENV.fetch("SERVIZEHUB_API_KEY"),
+  base_url: ENV["SERVIZEHUB_BASE_URL"] # nil -> production
+)
+```
+
+## Methods
+
+### `send_booking(date:, service_type:, status:)`
+
+Sends a single availability update. `date` must be `YYYY-MM-DD` and `status` must be
+`available` or `unavailable`. Returns `{ statusCode:, data: }`, or a validation message
+string.
+
+### `send_multiple_bookings(bookings)`
+
+Sends an array of booking hashes and returns
+`{ message:, successfulBookings:, failedBookings: }`.
+
+```ruby
+response = client.send_multiple_bookings([
+  { date: "2026-04-15", service_type: "Photography", status: "available" },
+  { date: "2026-04-16", service_type: "Videography", status: "unavailable" }
+])
+```
+
+## Tests
+
+```bash
+rake test
+# or: ruby test/client_test.rb
+```
+
+Uses minitest with `Net::HTTP.start` stubbed — the suite makes no network calls.
+
+## 📩 License
+
+Created by Notasco Dev Team
+
+Happy Coding! 🎯

data/lib/servizehub/client.rb

@@ -5,15 +5,27 @@ require 'date'
 
 module Servizehub
   class Client
-    BASE_URL = "https://servizehubuserdev.notasco.in"
+    # Production API base URL, used when no base_url is supplied.
+    DEFAULT_BASE_URL = "https://service.servizehub.com/external"
 
-    def initialize(api_key)
+    attr_reader :base_url
+
+    # Omit base_url to hit production; pass it to target another
+    # environment, e.g. "https://servizehubuserdev.notasco.in/external".
+    def initialize(api_key, base_url: nil)
       raise ArgumentError, "API key is required" if api_key.nil? || api_key.empty?
       @api_key = api_key
+
+      resolved = base_url.nil? || base_url.empty? ? DEFAULT_BASE_URL : base_url
+      @base_url = resolved.sub(%r{/+\z}, "")
     end
 
     # Validate date format YYYY-MM-DD
+    # Date.strptime is lenient (it accepts "15-04-2026"), so the shape is
+    # checked with a strict regex before parsing.
     def valid_date?(date)
+      return false unless date.is_a?(String) && date.match?(/\A\d{4}-\d{2}-\d{2}\z/)
+
       Date.strptime(date, '%Y-%m-%d')
       true
     rescue ArgumentError
@@ -27,11 +39,11 @@ module Servizehub
       valid_statuses = ["available", "unavailable"]
       return "Invalid status value" unless valid_statuses.include?(status)
 
-      uri = URI.parse("#{BASE_URL}/external/capture-availability")
+      uri = URI.parse("#{@base_url}/capture-availability")
 
       request = Net::HTTP::Post.new(uri)
       request["Content-Type"] = "application/json"
-      request["servizhub-api-key"] = @api_key
+      request["servizehub-api-key"] = @api_key
 
       request.body = {
         date: date,

data/lib/servizehub/version.rb

@@ -1,3 +1,3 @@
-module Servizehub
-  VERSION = "1.0.3"
-end
+module Servizehub
+  VERSION = "1.1.0"
+end

metadata

@@ -1,19 +1,48 @@
 --- !ruby/object:Gem::Specification
 name: servizehub
 version: !ruby/object:Gem::Version
-  version: 1.0.3
+  version: 1.1.0
 platform: ruby
 authors:
 - Hariraghav S
 bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
-dependencies: []
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '13.0'
 description: Ruby SDK to sync data to ServizeHub.
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- README.md
 - lib/Servizehub.rb
 - lib/servizehub/client.rb
 - lib/servizehub/version.rb
@@ -34,7 +63,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 4.0.16
 specification_version: 4
 summary: Official Ruby SDK for ServizeHub
 test_files: []