edgebase_core 0.1.4

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 78a3ab9e340eb9af6f6c70dfd948ccb6d98fcc4c988e6ac93a000ed8ba710bd6
+  data.tar.gz: 3ee1516a0f6a6fb1d1f7a223651982b4d2a1637a44a59a2e57086a8a92517387
+SHA512:
+  metadata.gz: 8a8f7a3fac453938a11f8c23b00b2f65867fd206545e7f9d56e4776e21dda9e2c0f2b6ab68678be611e61fef98b132cab75cab9884c4204a3fc6d3c7972551e6
+  data.tar.gz: 0b790f1d2299d34614a74bcdb7ac6fb9766ae70f96acc3c2fe5c238d846c8ca64784a19e9b5f472b722fa7b7dd53d05c2c1cb2b9514d89c4c389eb97fcbaff09

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 melodysdreamj
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,77 @@
+# edgebase_core
+
+Shared low-level Ruby primitives for EdgeBase.
+
+`edgebase_core` is the foundation used by `edgebase_admin`. It provides the HTTP client, table query builder, storage helpers, field operation markers, error types, DB references, and document references used by higher-level SDKs.
+
+Most application code should install [`edgebase_admin`](https://rubygems.org/gems/edgebase_admin) instead. Use this package directly when you are building custom wrappers, generated bindings, or internal integrations.
+
+## Documentation Map
+
+Use this README for the fast overview, then jump into the docs when you need depth:
+
+- [SDK Overview](https://edgebase.fun/docs/sdks)
+  Install commands and the public SDK matrix
+- [Database Admin SDK](https://edgebase.fun/docs/database/admin-sdk)
+  Table queries, filters, pagination, batch writes, and raw SQL
+- [Storage](https://edgebase.fun/docs/storage/upload-download)
+  Uploads, downloads, metadata, and signed URLs
+- [Admin SDK Reference](https://edgebase.fun/docs/admin-sdk/reference)
+  Cross-language examples that sit on top of this core package
+
+## For AI Coding Assistants
+
+This package includes an `llms.txt` file for AI-assisted development.
+
+Use it when you want an agent or code assistant to:
+
+- keep Service Keys on the server
+- use the actual Ruby class and method names
+- avoid copying JavaScript promise-based examples into Ruby
+- remember which surfaces are low-level helpers versus admin-only clients
+
+You can find it:
+
+- in this repository: [llms.txt](https://github.com/edge-base/edgebase/blob/main/packages/sdk/ruby/packages/core/llms.txt)
+- in your environment after install, inside the `edgebase_core` package directory as `llms.txt`
+
+## Installation
+
+If you are working inside this repository, reference the package directly through Bundler path dependencies.
+
+## Quick Start
+
+```ruby
+require "edgebase_core"
+
+client = EdgebaseCore::HttpClient.new(
+  "https://your-project.edgebase.fun",
+  service_key: ENV.fetch("EDGEBASE_SERVICE_KEY")
+)
+
+storage = EdgebaseCore::StorageClient.new(client)
+bucket = storage.bucket("avatars")
+bucket.upload("user-1.jpg", "binary-data", content_type: "image/jpeg")
+
+marker = EdgebaseCore::FieldOps.increment(1)
+```
+
+## Included Surfaces
+
+- `EdgebaseCore::HttpClient`
+- `EdgebaseCore::DbRef`, `EdgebaseCore::DocRef`, `EdgebaseCore::TableRef`
+- `EdgebaseCore::StorageClient`, `EdgebaseCore::StorageBucket`
+- `EdgebaseCore::FieldOps.increment()` and `EdgebaseCore::FieldOps.delete_field`
+- `EdgebaseCore::ListResult`, `EdgebaseCore::BatchResult`, `EdgebaseCore::UpsertResult`
+- `EdgebaseCore::EdgeBaseError`
+
+## Choose The Right Package
+
+| Package | Use it for |
+| --- | --- |
+| `edgebase_core` | Low-level Ruby primitives for custom wrappers and internal integrations |
+| `edgebase_admin` | Trusted server-side code with Service Key access |
+
+## License
+
+MIT

data/lib/edgebase_core/context_manager.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module EdgebaseCore
+  # Thread-safe context storage for multi-tenancy.
+  class ContextManager
+    def initialize
+      @context = {}
+    end
+
+    def set_context(context)
+      # Filter out auth.id — server extracts from JWT only
+      @context = context.reject { |k, _| k == "auth.id" }
+    end
+
+    def get_context
+      @context.dup
+    end
+
+    def clear_context
+      @context = {}
+    end
+  end
+end

data/lib/edgebase_core/errors.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module EdgebaseCore
+  # Base error for all EdgeBase API errors.
+  class EdgeBaseError < StandardError
+    attr_reader :status_code, :message, :details
+
+    def initialize(status_code, message, details: nil)
+      @status_code = status_code
+      @message = message
+      @details = details
+      super(to_s)
+    end
+
+    def to_s
+      parts = ["EdgeBaseError(#{@status_code}): #{@message}"]
+      if @details
+        @details.each do |k, v|
+          parts << "  #{k}: #{Array(v).join(', ')}"
+        end
+      end
+      parts.join("\n")
+    end
+
+    # Create from API JSON response.
+    def self.from_json(data, status_code)
+      new(
+        status_code,
+        data["message"] || "Unknown error",
+        details: data["details"]
+      )
+    end
+  end
+
+  # Authentication-specific error.
+  class EdgeBaseAuthError < EdgeBaseError
+    def to_s
+      "EdgeBaseAuthError(#{@status_code}): #{@message}"
+    end
+  end
+end

data/lib/edgebase_core/field_ops.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module EdgebaseCore
+  # Atomic field operation markers ($op pattern — mirrors JS SDK, server op-parser.ts).
+  module FieldOps
+    # Increment a numeric field atomically.
+    #
+    #   doc_ref.update("views" => EdgebaseCore::FieldOps.increment(1))
+    #   doc_ref.update("score" => EdgebaseCore::FieldOps.increment(-5))
+    def self.increment(value = 1)
+      { "$op" => "increment", "value" => value }
+    end
+
+    # Delete a field from a document.
+    #
+    #   doc_ref.update("oldField" => EdgebaseCore::FieldOps.delete_field)
+    def self.delete_field
+      { "$op" => "deleteField" }
+    end
+  end
+end