backlex 0.0.1 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 01f91fb97df5e3be829a139e6f6b8ca5ed6db3ff6964e23fbe98993f88aaca36
-  data.tar.gz: 9846419c9ad1c7b62322a311538a2c88e0dbd2aa579f418c865602d07c268fcf
+  metadata.gz: bba9b8d247e2372b316c0b7acc4a2301a6be7dc905640b0711d7ca6d11720a32
+  data.tar.gz: 64e10d54b9861177832c9eee721aec82350aa595a0b7aaaa881cdc619f3ddfe4
 SHA512:
-  metadata.gz: 9253fd5739603b9ae274ef5d80a401d7b2e18a88cffe9aaeec8fd25407be4a128cac8ae4d81fc73bb76a73ae58a19d0106300305bb271cf3df779cebc0654886
-  data.tar.gz: 56c161ee05698e5c476bb8bd1c17975baf6bd4d937e6bf1793e61241030707909c55cf0fb7cfd147a3dbf2fae4a99a5432f31a2b5d6fe2f1e4bcb94a0d50eecc
+  metadata.gz: 671cc7adec723956b25e58ac83c5b50042f96b7a280e7531f8534b472ec62d69fd859c4cee3c07c0333541457ed80a725d04b68526d164810f66f6058286bdae
+  data.tar.gz: 4364e6edbf173987962ceb830df6e8f3c5207c7346ea9963aa06d338056707fc4213f8bf912ebada7cf871f3fc8bb07ac4fe61dc65bb5d2af16351aaa08b6718

data/README.md

@@ -9,7 +9,7 @@ Part of backlex's multi-language SDK effort; follows the **hybrid** model:
 hand-written ergonomic layer here, optional OpenAPI-generated models underneath.
 
 ```bash
-gem install backlex   # not yet published
+gem install backlex
 ```
 
 ## Quickstart

data/lib/backlex/client.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "net/http"
+require "securerandom"
 require "uri"
 require "json"
 
@@ -12,12 +13,25 @@ module Backlex
     attr_reader :workspace
     attr_accessor :app_token
 
-    def initialize(url, api_key: nil, workspace: nil, token: nil, tenant: nil)
+    # Act inside a specific organization (slug or id) from here on, so `$org.id`
+    # in permission rules resolves without threading it through every call.
+    attr_accessor :org
+
+    def initialize(url, api_key: nil, workspace: nil, token: nil, tenant: nil, org: nil, tracing: true)
       @url = url.chomp("/")
       @api_key = api_key
       @workspace = workspace
       @app_token = token
       @tenant = tenant
+      @org = org
+      @tracing = tracing
+    end
+
+    # A W3C traceparent: 00-<32-hex trace id>-<16-hex span id>-01. Mirrors
+    # packages/client/src/trace.ts, which is what the API parses. Fresh per
+    # request — a span id reused across calls collapses them into one span.
+    def self.make_traceparent
+      "00-#{SecureRandom.hex(16)}-#{SecureRandom.hex(8)}-01"
     end
 
     # CRUD handle for a collection.
@@ -80,6 +94,8 @@ module Backlex
       res.body
     end
 
+    # The one chokepoint every request path goes through (data, storage,
+    # realtime) — a header added here reaches every call.
     def auth_header(req)
       if @api_key
         req["Authorization"] = "Bearer #{@api_key}"
@@ -87,6 +103,10 @@ module Backlex
         req["Authorization"] = "Bearer #{@app_token}"
       end
       req["X-Backlex-Tenant"] = @tenant if @tenant
+      req["X-Backlex-Org"] = @org if @org
+      # Without this a call never appears in the admin Traces panel and cannot
+      # be stitched to the server spans it triggers.
+      req["traceparent"] = self.class.make_traceparent if @tracing
     end
 
     # Serialize a ListQuery hash into a URL query string (mirrors buildSearch in

data/lib/backlex.rb

@@ -6,7 +6,7 @@
 #   client = Backlex::Client.new("https://api.example.com", api_key: "pak_...")
 #   posts = client.from("posts").query.where(Backlex::Filter.eq("published", true)).list
 module Backlex
-  VERSION = "0.0.1"
+  VERSION = "0.1.0"
 end
 
 require_relative "backlex/error"

metadata

@@ -1,18 +1,18 @@
 --- !ruby/object:Gem::Specification
 name: backlex
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.0
 platform: ruby
 authors:
 - backlex
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-17 00:00:00.000000000 Z
+date: 2026-08-26 00:00:00.000000000 Z
 dependencies: []
 description: A thin, typed wrapper over the backlex REST + SSE API. Zero runtime dependencies
   (stdlib net/http + json).
-email: 
+email:
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -34,7 +34,7 @@ licenses:
 metadata:
   documentation_uri: https://backlex.com/docs/client-sdks
   source_code_uri: https://github.com/backlex/backlex
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -49,8 +49,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3.1
-signing_key: 
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
 summary: Official Ruby client for the backlex API (CRUD, query builder, auth, realtime,
   storage).