syntropy 0.34.4 → 0.36.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6db3fba37a6c6dbc673424d2f68a83164b5a802e569862cfc6757aa128b454a2
-  data.tar.gz: c447710a87fd8c9833e6a677488c6be8cdc441fa5f0e5aa1729c223316e0af54
+  metadata.gz: f92ed1375642f12fb92654d872bfde1d07c7ad74be97507af3c1616390b6ce14
+  data.tar.gz: 5072d514bc07149f1d26bc900bcc9379970ebbbaf1b88eaa23933189fb684b37
 SHA512:
-  metadata.gz: 3858b134e15456c71cfd2639c588c98014837aa5a695f1c32a5f1bd4438d4da3a3c82fd9a4e9955396e6827e3e6d49f95ec5116b3ccce77cf856173b7ef0c746
-  data.tar.gz: 86297d5dc498b1130f66039e3792ea06bc51848f66002c231af13b38e2efa6c2f3f274ac3a22c9b3f8172a9e72c6b1f3ebabcb7fb296c2eb6792bee03659a98d
+  metadata.gz: f77aed02801a7b1c10f67a5ed7fbac9196580bd482c19ca660c81beaf5f2adcba86047635e35f9750d003538b12401962888193c058fbc3023ae88eae9038506
+  data.tar.gz: f923ab3aa4e535d5a85a563acf7f97534639ca1ed3d02e2c2b94d9cecef57e06cefc3a72a1ca782d0118b012189298bc3c743b017c0ee2d06be8bbf55d03dc89

data/CHANGELOG.md

@@ -1,3 +1,13 @@
+# 0.36.0 2026-06-04
+
+- Rename `DB` to `Storage`
+- Add `PreparedQuery`, `KVStore`
+
+# 0.35.0 2026-06-04
+
+- Add `syntropy new` command
+- Finalize work on new app template
+
 # 0.34.4 2026-06-03
 
 - Really fix running test in watch mode with docker compose

data/TODO.md

@@ -40,8 +40,6 @@
 - [v] Frontend part of JSON API
 - [v] Auto-refresh page when file changes
 - [ ] SQLite database capabilities
-  - [ ] Model API + tools
-    - [ ] Do we need/want migrations?
   - [ ] Stores
     - [ ] KV store (with TTL)
 - [v] Examples

data/bin/syntropy

@@ -11,5 +11,5 @@ cmd = 'help' if cmd !~ /^[a-z]+$/
 fn = cmd_fn(cmd)
 fn = cmd_fn('help') if !File.file?(fn)
 
-puts SYNTROPY_BANNER
+# puts SYNTROPY_BANNER
 require(fn)

data/cmd/console.rb

@@ -15,7 +15,7 @@ env = {
 }
 
 parser = OptionParser.new do |o|
-  o.banner = 'Usage: syntropy serve [options]'
+  o.banner = 'Usage: syntropy console [options]'
 
   o.on('-a', '--app PATH', 'Set app directory (default: ./app') do |path|
     env[:app_root] = path

data/{examples → cmd/new}/template/.gitignore

@@ -1,2 +1,3 @@
 Gemfile.lock
 storage/*
+vendor/bundle

data/cmd/new/template/Dockerfile

@@ -0,0 +1,25 @@
+FROM ruby:4.0-slim AS base
+WORKDIR /syntropy
+RUN apt-get update -qq && apt-get install -y \
+    curl \
+    build-essential \
+    libpq-dev \
+    libsqlite3-dev \
+    libssl-dev \
+    libyaml-dev \
+    pkg-config && \
+    rm -rf /var/lib/apt/lists /var/cache/apt/archives
+
+ENV BUNDLE_PATH="/usr/local/bundle"
+COPY Gemfile Gemfile.lock ./
+RUN bundle install
+
+RUN groupadd --system --gid 1000 syntropy && \
+    useradd syntropy --uid 1000 --gid 1000 --create-home --shell /bin/bash
+USER 1000:1000
+
+EXPOSE 1234
+
+# Start the main process
+# CMD ["bash"]
+CMD ["bundle", "exec", "syntropy", "serve"]

data/{examples → cmd/new}/template/Gemfile

@@ -1,3 +1,3 @@
 source 'https://gem.coop'
 
-gem 'syntropy', '~>0.34.3'
+gem 'syntropy', '~>0.36.0'

data/cmd/new/template/README.md

@@ -0,0 +1,40 @@
+# My awesome Syntropy app
+
+## Installation
+
+```bash
+$ bundle install
+```
+
+## Running the web server
+
+```bash
+$ bundle exec syntropy serve
+```
+
+## Starting the app console
+
+```bash
+$ bundle exec syntropy console
+```
+
+### Running tests
+
+```bash
+$ bundle exec syntropy tests
+```
+
+### Usage with Docker Compose
+
+You can also run the app on Docker Compose:
+
+```bash
+# run the app server
+$ docker compose up
+
+# run the console
+$ docker compose run --remove-orphans console
+
+# run tests
+$ docker compose run --remove-orphans test
+```

data/cmd/new/template/app/_lib/storage.rb

@@ -0,0 +1,13 @@
+export self
+
+def connection_pool
+  @connection_pool ||= Storage::ConnectionPool.new(@machine, @env[:config][:storage][:path], 4)
+end
+
+def schema
+  Storage::Schema.new(module_loader: @module_loader, schema_root: '_schema')
+end
+
+def migrate!
+  schema.apply(connection_pool)
+end

data/cmd/new/template/docker-compose.yml

@@ -0,0 +1,46 @@
+#version: "3.8"
+
+services:
+  app_server:
+    build: .
+    security_opt:
+      - seccomp:unconfined
+    volumes:
+      - .:/syntropy
+    ports:
+      - "1234:1234"
+    stop_signal: SIGINT
+    stop_grace_period: 10s
+    restart: always
+    healthcheck:
+      test: "curl 'http://localhost:1234/'"
+      interval: "30s"
+      timeout: "3s"
+      start_period: "5s"
+      retries: 3
+  console:
+    build: .
+    command: bundle exec syntropy console
+    stdin_open: true # docker run -i
+    tty: true
+    security_opt:
+      - seccomp:unconfined
+    profiles:
+      - dev
+    volumes:
+      - .:/syntropy
+    stop_signal: SIGINT
+    restart: never
+  test:
+    build: .
+    command: bundle exec syntropy test -w
+    stdin_open: true # docker run -i
+    tty: true
+    security_opt:
+      - seccomp:unconfined
+    profiles:
+      - dev
+    volumes:
+      - .:/syntropy
+    stop_signal: SIGINT
+    restart: never

data/cmd/new.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require 'optparse'
+require 'fileutils'
+
+parser = OptionParser.new do |o|
+  o.banner = 'Usage: syntropy new NAME [options]'
+
+  o.on('-h', '--help', 'Show this help message') do
+    puts o
+    exit
+  end
+end
+
+begin
+  parser.parse!
+rescue OptionParser::InvalidOption
+  puts parser
+  exit
+rescue StandardError => e
+  p e
+  puts e.message
+  puts e.backtrace.join("\n")
+  exit
+end
+
+path = ARGV.shift
+if !path
+  $stdout <<  'Please enter a name for your app: '
+  path = $stdin.gets
+end
+
+full_path = File.expand_path(path)
+puts "Creating app in #{full_path}"
+
+template_path = File.join(__dir__, 'new/template')
+
+begin
+  `mkdir -p "#{path}"`
+  `cp -r #{template_path}/* "#{path}/"`
+  puts "Your app is ready in #{path}"
+rescue => e
+  p e
+  p e.backtrace
+  exit(1)
+end

data/examples/blog/app/_lib/posts.rb

@@ -1,6 +1,6 @@
-DB = import '/_lib/database'
+Storage = import '/_lib/storage'
 
-class PostStore < Syntropy::DB::Store
+class PostStore < Syntropy::Storage::Store
   # @return [Integer] post id
   def create(title, body)
     query_single_value <<~SQL, title:, body:
@@ -46,4 +46,4 @@ class PostStore < Syntropy::DB::Store
   end
 end
 
-export PostStore.new(DB.connection_pool)
+export PostStore.new(Storage.connection_pool)

data/examples/blog/app/_lib/storage.rb

@@ -0,0 +1,13 @@
+export self
+
+def connection_pool
+  @connection_pool ||= Storage::ConnectionPool.new(@machine, @env[:config][:storage][:path], 4)
+end
+
+def schema
+  Storage::Schema.new(module_loader: @module_loader, schema_root: '_schema')
+end
+
+def migrate!
+  schema.apply(connection_pool)
+end

data/lib/syntropy/module_loader.rb

@@ -199,7 +199,8 @@ module Syntropy
       env[:logger]&.info(message: "Loaded module at #{fn}")
       m
     rescue SyntaxError => e
-      STDERR.puts("\n#{e.message}")
+      env[:logger]&.error(message: "Error while loading module at #{fn}", error: e)
+      STDERR.puts("\n#{e.message}") if !Syntropy.test_mode
 
       if (m = e.message.match(/^(.+)\: syntax/))
         location = m[1]
@@ -209,6 +210,9 @@ module Syntropy
       else
         raise e
       end
+    rescue => e
+      env[:logger]&.error(message: "Error while loading module at #{fn}", error: e)
+      raise e
     end
 
     # Initializes a module with the given environment hash.

data/lib/syntropy/{db → storage}/connection_pool.rb

@@ -3,7 +3,8 @@
 require 'extralite'
 
 module Syntropy
-  module DB
+  module Storage
+    # ConnectionPool implements concurrent access to an SQLite database.
     class ConnectionPool
       attr_reader :count
 

data/lib/syntropy/storage/kv_store.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+require 'syntropy/storage/store'
+
+module Syntropy
+  module Storage
+    # The KVStore class implements an SQLite-backed key-value store
+    class KVStore < Store
+      attr_reader :q_get, :q_set
+
+      def self.apply_schema(db, table_name)
+        db.execute <<~SQL
+          create table if not exists #{table_name} (key text primary key, value, expires float);
+          create index if not exists idx_#{table_name}_expires on #{table_name} (expires) where expires is not null;
+        SQL
+      end
+
+      def initialize(connection_pool, table_name)
+        super(connection_pool)
+        @table_name = table_name
+
+        setup_queries
+      end
+
+      def get(db, key)
+        db[@q_get].bind(key).next
+      end
+
+      def set(db, key, value)
+        db[@q_set].execute(key, value)
+      end
+
+      def setex(db, key, value, ttl)
+        db[@q_setex].execute(key, value, ttl ? Time.now.to_f + ttl : nil)
+      end
+
+      def sweep(db)
+        db[@q_sweep].execute(Time.now.to_f)
+      end
+
+      private
+
+      def setup_queries
+        @q_get = Storage.prepare_splat <<~SQL
+          select value from #{@table_name}
+          where key = ?
+        SQL
+
+        @q_set = Storage.prepare <<~SQL
+          insert into #{@table_name} (key, value)
+          values($1, $2)
+          on conflict (key) do update set value = $2, expires = null
+        SQL
+
+        @q_setex = Storage.prepare <<~SQL
+          insert into #{@table_name} (key, value, expires)
+          values($1, $2, $3)
+          on conflict (key) do update set value = $2, expires = $3
+        SQL
+
+        @q_sweep = Storage.prepare <<~SQL
+          delete from #{@table_name}
+          where expires < ?
+        SQL
+      end
+    end
+  end
+end

data/lib/syntropy/storage/prepared_query.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require 'extralite'
+
+module Syntropy
+  module Storage
+    class << self
+      def prepare(sql)
+        PreparedQuery.new(sql)
+      end
+
+      def prepare_splat(sql)
+        PreparedQuery.new(sql, :prepare_splat)
+      end
+    end
+
+    # Represents information about a prepared query
+    class PreparedQuery
+      attr_reader :sql, :mode
+
+      def initialize(sql, mode = :prepare)
+        @sql = sql
+        @mode = mode
+      end
+    end
+
+    # Extensions for Extralite::Database
+    module ExtraliteDatabaseExtensions
+      def [](pq)
+        (@prepared_queries ||= {})[pq] ||= send(pq.mode, pq.sql)
+      end
+    end
+
+    ::Extralite::Database.include(ExtraliteDatabaseExtensions)
+  end
+end

data/lib/syntropy/{db → storage}/schema.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module Syntropy
-  module DB
+  module Storage
     class Schema
       def initialize(module_loader: nil, schema_root: '_schema', &)
         @migrations = {}

data/lib/syntropy/{db → storage}/store.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module Syntropy
-  module DB
+  module Storage
     # The Store class represents a data store based on one or more tables, and
     # connected to a database connection pool.
     class Store

data/lib/syntropy/storage.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+require 'syntropy/storage/connection_pool'
+require 'syntropy/storage/schema'
+require 'syntropy/storage/store'
+require 'syntropy/storage/prepared_query'

data/lib/syntropy/test.rb

@@ -118,7 +118,7 @@ module Syntropy
       )
       @test_harness = Syntropy::TestHarness.new(@app)
 
-      @db = load_module('/_lib/database', raise_on_missing: false)
+      @db = load_module('/_lib/storage', raise_on_missing: false)
       @db&.migrate!
     end
 
@@ -241,3 +241,5 @@ module Syntropy
 
   Request.include TestRequestExtensions
 end
+
+Syntropy.test_mode = true

data/lib/syntropy/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Syntropy
-  VERSION = '0.34.4'
+  VERSION = '0.36.0'
 end

data/lib/syntropy.rb

@@ -9,9 +9,7 @@ require 'syntropy/logger'
 require 'syntropy/http'
 require 'syntropy/mime_types'
 require 'syntropy/app'
-require 'syntropy/db/connection_pool'
-require 'syntropy/db/schema'
-require 'syntropy/db/store'
+require 'syntropy/storage'
 require 'syntropy/errors'
 require 'syntropy/markdown'
 require 'syntropy/module_loader'
@@ -29,7 +27,7 @@ module Syntropy
   extend Utilities
 
   class << self
-    attr_accessor :machine, :dev_mode
+    attr_accessor :machine, :dev_mode, :test_mode
 
     # Runs the given block on a separate thread. Use this method for running
     # code that is not fiber-aware (i.e. does not use UringMachine).

data/test/{test_db_connection_pool.rb → test_connection_pool.rb}

@@ -2,11 +2,11 @@
 
 require_relative 'helper'
 
-class DBConnectionPoolTest < Minitest::Test
+class ConnectionPoolTest < Minitest::Test
   def setup
     @machine = UM.new
     @fn = "/tmp/#{rand(100000)}.db"
-    @cp = Syntropy::DB::ConnectionPool.new(@machine, @fn, 4)
+    @cp = Syntropy::Storage::ConnectionPool.new(@machine, @fn, 4)
 
     FileUtils.rm(@fn) rescue nil
     @standalone_db = Extralite::Database.new(@fn)
@@ -19,7 +19,7 @@ class DBConnectionPoolTest < Minitest::Test
     @cp.close
   end
 
-  def test_with_db
+  def test_connection_pool_with_db
     assert_equal 0, @cp.count
 
     @cp.with_db do |db|
@@ -74,7 +74,7 @@ class DBConnectionPoolTest < Minitest::Test
     assert_equal 4, @cp.count
   end
 
-  def test_with_db_reentrant
+  def test_connection_pool_with_db_reentrant
     dbs = @cp.with_db do |db1|
       @cp.with_db do |db2|
         [db1, db2]

data/test/test_kv_store.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+require_relative 'helper'
+require 'syntropy/storage/kv_store'
+
+class KVStoreTest < Minitest::Test
+  def setup
+    @machine = UM.new
+    @fn = "/tmp/#{rand(100000)}.db"
+    FileUtils.rm(@fn) rescue nil
+    @cp = Syntropy::Storage::ConnectionPool.new(@machine, @fn, 4)
+  end
+
+  def teardown
+    @cp.close
+  end
+
+  def test_connection_pool_prepare
+    pq = Syntropy::Storage.prepare('select ? as a, 42 as b')
+    assert_kind_of Syntropy::Storage::PreparedQuery, pq
+    assert_equal 'select ? as a, 42 as b', pq.sql
+    assert_equal :prepare, pq.mode
+
+    assert_kind_of Extralite::Query, @cp.with_db { it[pq] }
+    assert_equal [{ a: 'foo', b: 42 }], @cp.with_db { it[pq].bind('foo').to_a }
+  end
+
+  def test_connection_pool_prepare_splat
+    pq = Syntropy::Storage.prepare_splat('select ?')
+    assert_kind_of Syntropy::Storage::PreparedQuery, pq
+    assert_equal 'select ?', pq.sql
+    assert_equal :prepare_splat, pq.mode
+
+    assert_kind_of Extralite::Query, @cp.with_db { it[pq] }
+    assert_equal ['foo'], @cp.with_db { it[pq].bind('foo').to_a }
+  end
+
+  def test_kv_store_apply_schema
+    assert_respond_to Syntropy::Storage::KVStore, :apply_schema
+
+    assert_raises(Extralite::SQLError) { @cp.query('select * from kv') }
+    Syntropy::Storage::KVStore.apply_schema(@cp, 'kv')
+    assert_equal [], @cp.query('select * from kv')
+  end
+
+  def test_kv_store_get_set
+    Syntropy::Storage::KVStore.apply_schema(@cp, 'kv')
+    kv_store = Syntropy::Storage::KVStore.new(@cp, 'kv')
+
+    @cp.with_db do |db|
+      assert_nil kv_store.get(db, 'foo')
+      assert_nil kv_store.get(db, 'bar')
+
+      kv_store.set(db, 'foo', '123')
+
+      assert_equal '123', kv_store.get(db, 'foo')
+      assert_nil kv_store.get(db, 'bar')
+
+      kv_store.set(db, 'bar', '456')
+      assert_equal '123', kv_store.get(db, 'foo')
+      assert_equal '456', kv_store.get(db, 'bar')
+    end
+  end
+
+  def test_kv_store_setex_sweep
+    Syntropy::Storage::KVStore.apply_schema(@cp, 'kv')
+    kv_store = Syntropy::Storage::KVStore.new(@cp, 'kv')
+
+    @cp.with_db do |db|
+      kv_store.set(db, 'foo', '123')
+      kv_store.setex(db, 'bar', '456', 0.05)
+      assert_equal 0, kv_store.sweep(db)
+
+      assert_equal '123', kv_store.get(db, 'foo')
+      assert_equal '456', kv_store.get(db, 'bar')
+
+      sleep 0.1
+      assert_equal 1, kv_store.sweep(db)
+
+      assert_equal '123', kv_store.get(db, 'foo')
+      assert_nil kv_store.get(db, 'bar')
+    end
+  end
+end

data/test/{test_db_schema.rb → test_schema.rb}

@@ -2,12 +2,12 @@
 
 require_relative 'helper'
 
-class DBSchemaTest < Minitest::Test
+class SchemaTest < Minitest::Test
   def setup
     @machine = UM.new
     @fn = "/tmp/#{rand(100000)}.db"
     FileUtils.rm(@fn) rescue nil
-    @cp = Syntropy::DB::ConnectionPool.new(@machine, @fn, 4)
+    @cp = Syntropy::Storage::ConnectionPool.new(@machine, @fn, 4)
   end
 
   def teardown
@@ -15,7 +15,7 @@ class DBSchemaTest < Minitest::Test
   end
 
   def test_db_schema_initial
-    schema = Syntropy::DB::Schema.new do
+    schema = Syntropy::Storage::Schema.new do
       initial do |db|
         db.execute <<~SQL
           create table posts (
@@ -35,7 +35,7 @@ class DBSchemaTest < Minitest::Test
   end
 
   def test_db_schema_version_blocks
-    schema = Syntropy::DB::Schema.new do
+    schema = Syntropy::Storage::Schema.new do
       initial do |db|
         db.execute <<~SQL
           create table posts (
@@ -79,7 +79,7 @@ class DBSchemaTest < Minitest::Test
     module_loader = Syntropy::ModuleLoader.new({
       app_root: File.join(__dir__, 'fixtures/schema')
     })
-    schema = Syntropy::DB::Schema.new(module_loader:, schema_root: '/')
+    schema = Syntropy::Storage::Schema.new(module_loader:, schema_root: '/')
 
     assert_nil schema.current_version(@cp)
     schema.apply(@cp)

data/test/{test_db_store.rb → test_store.rb}

@@ -2,12 +2,12 @@
 
 require_relative 'helper'
 
-class DBStoreTest < Minitest::Test
+class StoreTest < Minitest::Test
   def setup
     @machine = UM.new
     @fn = "/tmp/#{rand(100000)}.db"
     FileUtils.rm(@fn) rescue nil
-    @cp = Syntropy::DB::ConnectionPool.new(@machine, @fn, 4)
+    @cp = Syntropy::Storage::ConnectionPool.new(@machine, @fn, 4)
   end
 
   def teardown
@@ -15,7 +15,7 @@ class DBStoreTest < Minitest::Test
   end
 
   def test_db_store
-    store = Syntropy::DB::Store.new(@cp)
+    store = Syntropy::Storage::Store.new(@cp)
 
     assert_equal [{a: 42}], store.query("select ? as a", 42)
     assert_equal({a: 42}, store.query_single_row("select ? as a", 42))

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: syntropy
 version: !ruby/object:Gem::Version
-  version: 0.34.4
+  version: 0.36.0
 platform: ruby
 authors:
 - Sharon Rosner
@@ -170,30 +170,23 @@ files:
 - cmd/_banner.rb
 - cmd/console.rb
 - cmd/help.rb
+- cmd/new.rb
+- cmd/new/template/.gitignore
+- cmd/new/template/Dockerfile
+- cmd/new/template/Gemfile
+- cmd/new/template/README.md
+- cmd/new/template/app/_layout/default.rb
+- cmd/new/template/app/_lib/storage.rb
+- cmd/new/template/app/_schema/2026-01-01-initial.rb
+- cmd/new/template/app/assets/style.css
+- cmd/new/template/app/index.rb
+- cmd/new/template/app/test.rb
+- cmd/new/template/config/development.rb
+- cmd/new/template/config/production.rb
+- cmd/new/template/config/test.rb
+- cmd/new/template/docker-compose.yml
+- cmd/new/template/test/test_app.rb
 - cmd/serve.rb
-- cmd/setup/template/site/.gitignore
-- cmd/setup/template/site/Dockerfile
-- cmd/setup/template/site/Gemfile
-- cmd/setup/template/site/README.md
-- cmd/setup/template/site/bin/console
-- cmd/setup/template/site/bin/restart
-- cmd/setup/template/site/bin/server
-- cmd/setup/template/site/bin/start
-- cmd/setup/template/site/bin/stop
-- cmd/setup/template/site/docker-compose.yml
-- cmd/setup/template/site/proxy/Dockerfile
-- cmd/setup/template/site/proxy/etc/Caddyfile
-- cmd/setup/template/site/proxy/etc/tls_auto
-- cmd/setup/template/site/proxy/etc/tls_cloudflare
-- cmd/setup/template/site/proxy/etc/tls_custom
-- cmd/setup/template/site/proxy/etc/tls_selfsigned
-- cmd/setup/template/site/site/_layout/default.rb
-- cmd/setup/template/site/site/about.md
-- cmd/setup/template/site/site/articles/cage.rb
-- cmd/setup/template/site/site/articles/index.rb
-- cmd/setup/template/site/site/assets/css/style.css
-- cmd/setup/template/site/site/assets/img/syntropy.png
-- cmd/setup/template/site/site/index.rb
 - cmd/test.rb
 - docker-compose.yml
 - examples/basic/bad.rb
@@ -206,8 +199,8 @@ files:
 - examples/basic/templates.rb
 - examples/blog/.gitignore
 - examples/blog/app/_layout/default.rb
-- examples/blog/app/_lib/database.rb
 - examples/blog/app/_lib/posts.rb
+- examples/blog/app/_lib/storage.rb
 - examples/blog/app/_schema/2026-01-01-initial.rb
 - examples/blog/app/assets/style.css
 - examples/blog/app/index.rb
@@ -235,18 +228,6 @@ files:
 - examples/mcp-oauth/app/signin.rb
 - examples/mcp-oauth/test/test_app.rb
 - examples/mcp-oauth/test/test_oauth.rb
-- examples/template/.gitignore
-- examples/template/Gemfile
-- examples/template/app/_layout/default.rb
-- examples/template/app/_lib/database.rb
-- examples/template/app/_schema/2026-01-01-initial.rb
-- examples/template/app/assets/style.css
-- examples/template/app/index.rb
-- examples/template/app/test.rb
-- examples/template/config/development.rb
-- examples/template/config/production.rb
-- examples/template/config/test.rb
-- examples/template/test/test_app.rb
 - lib/syntropy.rb
 - lib/syntropy/app.rb
 - lib/syntropy/applets/builtin/auto_refresh/watch.js
@@ -258,9 +239,6 @@ files:
 - lib/syntropy/applets/builtin/json_api.js
 - lib/syntropy/applets/builtin/ping.rb
 - lib/syntropy/applets/builtin/req.rb
-- lib/syntropy/db/connection_pool.rb
-- lib/syntropy/db/schema.rb
-- lib/syntropy/db/store.rb
 - lib/syntropy/dev_mode.rb
 - lib/syntropy/errors.rb
 - lib/syntropy/http.rb
@@ -284,6 +262,12 @@ files:
 - lib/syntropy/routing_tree.rb
 - lib/syntropy/session.rb
 - lib/syntropy/side_run.rb
+- lib/syntropy/storage.rb
+- lib/syntropy/storage/connection_pool.rb
+- lib/syntropy/storage/kv_store.rb
+- lib/syntropy/storage/prepared_query.rb
+- lib/syntropy/storage/schema.rb
+- lib/syntropy/storage/store.rb
 - lib/syntropy/test.rb
 - lib/syntropy/utils.rb
 - lib/syntropy/version.rb
@@ -336,23 +320,24 @@ files:
 - test/run.rb
 - test/test_app.rb
 - test/test_caching.rb
-- test/test_db_connection_pool.rb
-- test/test_db_schema.rb
-- test/test_db_store.rb
+- test/test_connection_pool.rb
 - test/test_errors.rb
 - test/test_http_client.rb
 - test/test_http_client_connection.rb
 - test/test_http_protocol.rb
 - test/test_http_server_connection.rb
 - test/test_json_api.rb
+- test/test_kv_store.rb
 - test/test_mock_adapter.rb
 - test/test_module_loader.rb
 - test/test_request.rb
 - test/test_request_session.rb
 - test/test_response.rb
 - test/test_routing_tree.rb
+- test/test_schema.rb
 - test/test_server.rb
 - test/test_side_run.rb
+- test/test_store.rb
 - test/test_test.rb
 homepage: https://github.com/digital-fabric/syntropy
 licenses:

data/cmd/setup/template/site/.gitignore

@@ -1,57 +0,0 @@
-*.gem
-*.rbc
-/.config
-/coverage/
-/InstalledFiles
-/pkg/
-/spec/reports/
-/spec/examples.txt
-/test/tmp/
-/test/version_tmp/
-/tmp/
-
-# Used by dotenv library to load environment variables.
-# .env
-
-# Ignore Byebug command history file.
-.byebug_history
-
-## Specific to RubyMotion:
-.dat*
-.repl_history
-build/
-*.bridgesupport
-build-iPhoneOS/
-build-iPhoneSimulator/
-
-## Specific to RubyMotion (use of CocoaPods):
-#
-# We recommend against adding the Pods directory to your .gitignore. However
-# you should judge for yourself, the pros and cons are mentioned at:
-# https://guides.cocoapods.org/using/using-cocoapods.html#should-i-check-the-pods-directory-into-source-control
-#
-# vendor/Pods/
-
-## Documentation cache and generated files:
-/.yardoc/
-/_yardoc/
-/doc/
-/rdoc/
-
-## Environment normalization:
-/.bundle/
-/vendor/bundle
-/lib/bundler/man/
-
-# for a library or gem, you might want to ignore these files since the code is
-# intended to run in multiple environments; otherwise, check them in:
-# Gemfile.lock
-# .ruby-version
-# .ruby-gemset
-
-# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
-.rvmrc
-
-# Used by RuboCop. Remote config files pulled in from inherit_from directive.
-# .rubocop-https?--*
-log

data/cmd/setup/template/site/Dockerfile

@@ -1,32 +0,0 @@
-ARG RUBY_BASE_IMAGE=ruby:3.4.1-alpine
-ARG GEM_CACHE_IMAGE=${RUBY_BASE_IMAGE}
-
-# base image
-FROM ${RUBY_BASE_IMAGE} AS base
-RUN apk add --update sqlite-dev openssl-dev tzdata bash curl zip git
-RUN apk add --update build-base
-RUN gem install bundler:2.6.9
-
-# gem cache
-FROM ${GEM_CACHE_IMAGE} AS gem-cache
-RUN mkdir -p /usr/local/bundle
-
-FROM base AS gems
-COPY --from=gem-cache /usr/local/bundle /usr/local/bundle
-COPY Gemfile Gemfile.lock ./
-RUN bundle install --jobs=4 --retry=5
-
-# Final backend image
-FROM base AS deploy
-
-RUN adduser -D app
-RUN chown app:app /home/app
-WORKDIR /home/app
-USER app
-
-RUN mkdir -p /tmp
-COPY --from=gems --chown=app:app /usr/local/bundle /usr/local/bundle
-
-EXPOSE 1234
-
-CMD ["bundle", "exec", "syntropy", "."]

data/cmd/setup/template/site/Gemfile

@@ -1,3 +0,0 @@
-source 'https://rubygems.org'
-
-gem 'syntropy', '0.3'

data/cmd/setup/template/site/docker-compose.yml

@@ -1,51 +0,0 @@
-services:
-  backend:
-    build: .
-    privileged: true
-    restart: always
-    ports:
-      - 127.0.0.1:1234:1234
-    # expose:
-    #   - 1234
-    volumes:
-      - .:/home/app
-    deploy:
-      # replicas: 1
-      resources:
-        limits:
-          memory: 500M
-    # restart: unless-stopped
-    logging:
-      driver: "json-file"
-      options:
-        max-size: "1M"
-        max-file: "10"
-
-    # healthcheck:
-    #   test: "curl 'http://localhost:1234/?q=ping'"
-    #   interval: "30s"
-    #   timeout: "3s"
-    #   start_period: "5s"
-    #   retries: 3
-
-  proxy:
-    depends_on:
-      - backend
-    build:
-      context: ./proxy
-      dockerfile: Dockerfile
-    restart: always
-    volumes:
-      - ./proxy/etc/Caddyfile:/etc/caddy/Caddyfile
-    ports:
-      - "80:80"
-      - "443:443"
-      - "443:443/udp"
-    # env_file:
-      # - ./conf/caddy.env
-      # - ./conf/caddy_sensitive.env
-    logging:
-      driver: "json-file"
-      options:
-        max-size: "1M"
-        max-file: "10"

data/cmd/setup/template/site/proxy/Dockerfile

@@ -1,5 +0,0 @@
-FROM caddy:2.10.0-builder AS builder
-RUN xcaddy build
-
-FROM caddy:2.10.0
-COPY --from=builder /usr/bin/caddy /usr/bin/caddy

data/cmd/setup/template/site/proxy/etc/Caddyfile

@@ -1,7 +0,0 @@
-localhost {
-  reverse_proxy noteflakescom-backend-1:1234
-}
-
-my-awesome-domain.com {
-  reverse_proxy noteflakescom-backend-1:1234
-}

data/cmd/setup/template/site/proxy/etc/tls_auto

@@ -1,2 +0,0 @@
-tls {$TLS_AUTO_EMAIL}
-

data/cmd/setup/template/site/proxy/etc/tls_cloudflare

@@ -1,4 +0,0 @@
-tls {
-	dns cloudflare {env.CLOUDFLARE_API_TOKEN}
-}
-

data/cmd/setup/template/site/proxy/etc/tls_custom

@@ -1 +0,0 @@
-tls {$TLS_CUSTOM_CERT} {$TLS_CUSTOM_KEY}

data/cmd/setup/template/site/proxy/etc/tls_selfsigned

@@ -1 +0,0 @@
-tls internal

data/cmd/setup/template/site/site/_layout/default.rb

@@ -1,11 +0,0 @@
-export templ { |*a, **b|
-  html {
-    head {
-      title 'My awesome Syntropy website'
-      link rel: 'stylesheet', type: 'text/css', href: '/assets/css/style.css'
-    }
-    body {
-      render_yield(*a, **b)
-    }
-  }
-}

data/cmd/setup/template/site/site/about.md

@@ -1,6 +0,0 @@
----
-layout: default
----
-# About my site
-
-Lorem ipsum my awesome site.

data/cmd/setup/template/site/site/articles/cage.rb

@@ -1,29 +0,0 @@
-layout = import('_layout/default')
-
-poem = [
-  "        in ten\xA0", 'M', 'inutes',
-  '                  ', 'C', 'ome back: you will',
-  'have taught me chi', 'N', 'ese',
-  '                (s', 'A', 'tie).',
-  '       shall I ret', 'U', 'rn the favor?',
-  '                  ', 'G', 'ive you',
-  '                ot', 'H', 'er lessons',
-  '                 (', 'T', 'ing!)?',
-  '                  ', 'O', 'r would you prefer',
-  '              sile', 'N', 'ce?',
-]
-
-export Papercraft.apply(layout) {
-  article(class: 'mesostic') {
-    h2 'For William McN. who studied with Ezra Pound'
-
-    content {
-      span(_for: poem) { text it }
-    }
-
-    author {
-      span "-\xA0"
-      a 'John cage', href: 'https://en.wikipedia.org/wiki/John_Cage'
-    }
-  }
-}

data/cmd/setup/template/site/site/articles/index.rb

@@ -1,3 +0,0 @@
-export templ {
-  h1 'Articles'
-}

data/cmd/setup/template/site/site/assets/css/style.css

@@ -1,40 +0,0 @@
-body {
-  font-family: sans-serif;
-}
-
-article.mesostic {
-  width: 600px;
-  margin: 2em auto;
-  font-size: 1.4em;
-
-  * {
-    font-family: monospace;
-  }
-
-  h2 {
-    text-align: center;
-  }
-
-  content {
-    display: grid;
-    margin: 2em 0;
-    grid-template-columns: 1fr auto 1fr;
-
-    span {
-      display: inline-block;
-    }
-    span:nth-child(3n + 1) {
-      text-align: right;
-    }
-
-    span:nth-child(3n + 2) {
-      text-align: center;
-      font-weight: bold;
-    }
-  }
-
-  author {
-    display: block;
-    text-align: right;
-  }
-}

data/cmd/setup/template/site/site/index.rb

@@ -1,15 +0,0 @@
-layout = import('_layout/default')
-
-export Papercraft.apply(layout) {
-  h1 'Hello from Syntropy'
-  p {
-    span "Here's an "
-    a 'about', href: 'about'
-    span ' page.'
-  }
-  p {
-    span "Here's an "
-    a 'article', href: 'articles/cage'
-    span ' page.'
-  }
-}

data/examples/blog/app/_lib/database.rb

@@ -1,13 +0,0 @@
-export self
-
-def connection_pool
-  @connection_pool ||= DB::ConnectionPool.new(@machine, @env[:config][:storage][:path], 4)
-end
-
-def schema
-  DB::Schema.new(module_loader: @module_loader, schema_root: '_schema')
-end
-
-def migrate!
-  schema.apply(connection_pool)
-end

data/examples/template/app/_lib/database.rb

@@ -1,13 +0,0 @@
-export self
-
-def connection_pool
-  @connection_pool ||= DB::ConnectionPool.new(@machine, @env[:config][:storage][:path], 4)
-end
-
-def schema
-  DB::Schema.new(module_loader: @module_loader, schema_root: '_schema')
-end
-
-def migrate!
-  schema.apply(connection_pool)
-end