s3arch 0.0.4 → 0.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5b5d2b31636cdd8dd3d02bfd8140a82263f462207bf80525ef55167e1267a057
-  data.tar.gz: 8cfa541ae296debeb4ca01737673733805b81268a415280241a57eaba1f22821
+  metadata.gz: f15baec2213fb6a5cee584447843884e1b9aa5e1bf650d500c53cd6c17e69539
+  data.tar.gz: d00b7d3345ebf462c5ef0a450452502a818c2dd6969c34e82bfc5d763dc9cd7f
 SHA512:
-  metadata.gz: fd0c3fabee28274d50d46951fde563bc9196263d59174ee87047bdb8a06d7ae1ee7964ae82d431c6c22ee875e40512918a01c6110292d0a0d06c89e54201e25e
-  data.tar.gz: '008755884d519604931a7ccfebff4492c0308900230d5e9cd535aa452afb9e7a48d9274c04b15867b2bfd3bbe031aeb2ae08d1c2b6ffdf8759a7a90518ce7b60'
+  metadata.gz: 3fd7108161529a4d4d23ffcd49e483d944064ea6364438470f65859c86382f43a611e6867a4d69981772c76bc6e244d306a256dbb1ac6607622cf787d78551e9
+  data.tar.gz: a9895ba3ef76d2720330633cc6eeb44e6d70d9a2461d4602eea136d8de19f4032397e1195dba91c1d0160a95a19bc69ec8123d2dd25581683da47a547717cd3e

data/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## [0.0.5] - 2025-06-12
+
+### Added
+
+- `S3arch::Dashboard` — mountable Rack application for viewing index stats (records, versions, owner counts)
+- `S3arch::Dashboard::Application` — ERB-rendered HTML dashboard with mobile-friendly layout
+- `S3arch::Holster` — Belt holster integration for convention-over-configuration mounting
+- `S3arch::Routes` — Dispatcher mount DSL compatibility (`#routes` method)
+- `S3arch::Web` — lightweight Rack entry point for Lambda integration
+- `S3archController` — Belt controller for dashboard with Cognito auth gate
+- `Configuration#dashboard_auth` — configurable authentication for dashboard access
+- localStorage-based auth for CloudFront same-origin serving
+
+### Changed
+
+- Dashboard renders HTML via ERB instead of JSON
+- Scientific notation fix for large record/version numbers in dashboard
+
 ## [0.0.4] - 2025-06-09
 
 ### Fixed

data/infrastructure/routes.tf.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+TerraDispatch.routes.draw do
+  namespace :s3arch, auth: :cognito, tables: [:search_indexes] do
+    get '/', action: 'index'
+    post '/rebuild', action: 'rebuild'
+  end
+end

data/infrastructure/schema.tf.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+TerraDispatch.schema.define do
+  # S3arch does not define request/response models yet.
+  # The search_indexes table is provisioned by s3arch's own Terraform module.
+end

data/lambda/controllers/s3arch_controller.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+require 'aws-sdk-dynamodb'
+
+class S3archController < BeltController::Base
+  def index
+    owners = fetch_owners
+    success_response(owners: owners)
+  rescue StandardError => e
+    error_response("Failed to load owners: #{e.message}", 500)
+  end
+
+  def rebuild
+    owner_id = params['owner_id']&.strip
+    return error_response('owner_id is required', 400) if owner_id.nil? || owner_id.empty?
+
+    handler = S3arch.configuration.rebuild_handler
+    if handler
+      handler.call(owner_id)
+    else
+      S3arch::Indexer.new.rebuild(owner_id)
+    end
+    success_response(status: 'ok', owner_id: owner_id)
+  rescue StandardError => e
+    error_response("Failed to rebuild index: #{e.message}", 500)
+  end
+
+  private
+
+  def fetch_owners
+    dynamodb = Aws::DynamoDB::Client.new
+    config = S3arch.configuration
+    items = []
+    scan_params = { table_name: config.version_table }
+
+    loop do
+      result = dynamodb.scan(scan_params)
+      items.concat(result.items)
+      break unless result.last_evaluated_key
+
+      scan_params[:exclusive_start_key] = result.last_evaluated_key
+    end
+
+    owners = items.map do |item|
+      {
+        owner_id: item[config.owner_key] || item.values.first,
+        version: item['version'],
+        record_count: item['record_count'],
+        updated_at: item['updated_at']
+      }
+    end
+    owners.sort_by { |o| o[:updated_at].to_s }.reverse
+  end
+end

data/lib/s3arch/configuration.rb

@@ -42,6 +42,11 @@ module S3arch
     # Searcher settings
     attr_accessor :version_ttl, :max_results, :max_cached_dbs, :ephemeral_storage_mb
 
+    # Custom rebuild handler — proc/lambda that receives owner_id.
+    # When set, the controller uses this instead of calling Indexer.new.rebuild directly.
+    # Useful for triggering rebuilds via Lambda invocation instead of in-process.
+    attr_accessor :rebuild_handler
+
     def initialize
       @owner_key = 'user_id'
       @searchable_fields = %w[name description]

data/lib/s3arch/routes.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module S3arch
+  # Lightweight route manifest for Dispatcher mount DSL.
+  # No heavy dependencies — safe to load in parse-only contexts.
+  module Routes
+    def self.routes
+      [
+        { method: :get, path: '/' },
+        { method: :post, path: '/rebuild' }
+      ]
+    end
+  end
+end

data/lib/s3arch/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module S3arch
-  VERSION = '0.0.4'
+  VERSION = '0.0.6'
 end

data/lib/s3arch/web.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+# Lightweight S3arch load for web/API contexts (no SQLite dependency).
+# Provides configuration and routes only.
+require_relative 'version'
+require_relative 'configuration'
+require_relative 'routes'
+
+module S3arch
+  class Error < StandardError; end
+
+  class << self
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configure
+      yield(configuration)
+    end
+
+    def reset_configuration!
+      @configuration = Configuration.new
+    end
+  end
+end

data/lib/s3arch.rb

@@ -6,6 +6,7 @@ require_relative 's3arch/tokenizer'
 require_relative 's3arch/indexer'
 require_relative 's3arch/searcher'
 require_relative 's3arch/handler'
+require_relative 's3arch/routes'
 
 module S3arch
   class Error < StandardError; end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: s3arch
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.0.6
 platform: ruby
 authors:
 - Adam Dalton
@@ -64,6 +64,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: sqlite3
   requirement: !ruby/object:Gem::Requirement
@@ -78,8 +92,8 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.0'
-description: Per-owner SQLite FTS5 indexes stored on S3, queried from Lambda /tmp.
-  DynamoDB source records are indexed via streams, with version tracking and LRU caching.
+description: Per-owner SQLite FTS5 indexes stored on S3, queried from Lambda /tmp
+  with version tracking.
 email:
 - adam@stowzilla.com
 executables: []
@@ -90,13 +104,18 @@ files:
 - LICENSE.txt
 - README.md
 - certs/stowzilla.pem
+- infrastructure/routes.tf.rb
+- infrastructure/schema.tf.rb
+- lambda/controllers/s3arch_controller.rb
 - lib/s3arch.rb
 - lib/s3arch/configuration.rb
 - lib/s3arch/handler.rb
 - lib/s3arch/indexer.rb
+- lib/s3arch/routes.rb
 - lib/s3arch/searcher.rb
 - lib/s3arch/tokenizer.rb
 - lib/s3arch/version.rb
+- lib/s3arch/web.rb
 homepage: https://github.com/stowzilla/s3arch
 licenses:
 - MIT