tina4ruby 3.2.1 → 3.9.2

data/lib/tina4/public/js/tina4js.min.js

@@ -0,0 +1,47 @@
+"use strict";var Tina4=(()=>{var H=Object.defineProperty;var pe=Object.getOwnPropertyDescriptor;var ge=Object.getOwnPropertyNames;var he=Object.prototype.hasOwnProperty;var me=(e,n)=>{for(var t in n)H(e,t,{get:n[t],enumerable:!0})},ye=(e,n,t,o)=>{if(n&&typeof n=="object"||typeof n=="function")for(let r of ge(n))!he.call(e,r)&&r!==t&&H(e,r,{get:()=>n[r],enumerable:!(o=pe(n,r))||o.enumerable});return e};var ve=e=>ye(H({},"__esModule",{value:!0}),e);var Ae={};me(Ae,{Tina4Element:()=>I,api:()=>ie,batch:()=>q,computed:()=>z,effect:()=>m,html:()=>X,isSignal:()=>w,navigate:()=>L,pwa:()=>le,route:()=>oe,router:()=>re,signal:()=>h,ws:()=>ue});var C=null,_=null,M=null;function b(e){M=e}function J(){return M}var B=null,V=null;var N=0,P=new Set;function h(e,n){let t=e,o=new Set,r={_t4:!0,get value(){if(C&&(o.add(C),_)){let a=C;_.push(()=>o.delete(a))}return t},set value(a){if(Object.is(a,t))return;let i=t;if(t=a,r._debugInfo&&r._debugInfo.updateCount++,V&&V(r,i,a),N>0)for(let s of o)P.add(s);else{let s;for(let c of[...o])try{c()}catch(l){s===void 0&&(s=l)}if(s!==void 0)throw s}},_subscribe(a){return o.add(a),()=>{o.delete(a)}},peek(){return t}};return B&&(r._debugInfo={label:n,createdAt:Date.now(),updateCount:0,subs:o},B(r,n)),r}function z(e){let n=h(void 0);return m(()=>{n.value=e()}),{_t4:!0,get value(){return n.value},set value(t){throw new Error("[tina4] computed signals are read-only")},_subscribe(t){return n._subscribe(t)},peek(){return n.peek()}}}function m(e){let n=!1,t=[],o=()=>{if(n)return;for(let s of t)s();t=[];let a=C,i=_;C=o,_=t;try{e()}finally{C=a,_=i}};o();let r=()=>{n=!0;for(let a of t)a();t=[]};return M&&M.push(r),r}function q(e){N++;try{e()}finally{if(N--,N===0){let n=[...P];P.clear();let t;for(let o of n)try{o()}catch(r){t===void 0&&(t=r)}if(t!==void 0)throw t}}}function w(e){return e!==null&&typeof e=="object"&&e._t4===!0}var Q=new WeakMap,D="t4:";function X(e,...n){let t=Q.get(e);if(!t){t=document.createElement("template");let i="";for(let s=0;s<e.length;s++)i+=e[s],s<n.length&&(Te(i)?i+=`__t4_${s}__`:i+=`<!--${D}${s}-->`);t.innerHTML=i,Q.set(e,t)}let o=t.content.cloneNode(!0),r=be(o);for(let{marker:i,index:s}of r)ke(i,n[s]);let a=we(o);for(let i of a)Ce(i,n);return o}function be(e){let n=[];return W(e,t=>{if(t.nodeType===8){let o=t.data;if(o&&o.startsWith(D)){let r=parseInt(o.slice(D.length),10);n.push({marker:t,index:r})}}}),n}function we(e){let n=[];return W(e,t=>{t.nodeType===1&&n.push(t)}),n}function W(e,n){let t=e.childNodes;for(let o=0;o<t.length;o++){let r=t[o];n(r),W(r,n)}}function ke(e,n){let t=e.parentNode;if(t)if(w(n)){let o=document.createTextNode("");t.replaceChild(o,e),m(()=>{o.data=String(n.value??"")})}else if(typeof n=="function"){let o=document.createComment("");t.replaceChild(o,e);let r=[],a=[];m(()=>{for(let d of a)d();a=[];let i=[],s=J();b(i);let c=n();b(s),a=i;for(let d of r)d.parentNode?.removeChild(d);r=[];let l=F(c),f=o.parentNode;if(f)for(let d of l)f.insertBefore(d,o),r.push(d)})}else if(Y(n))t.replaceChild(n,e);else if(n instanceof Node)t.replaceChild(n,e);else if(Array.isArray(n)){let o=document.createDocumentFragment();for(let r of n){let a=F(r);for(let i of a)o.appendChild(i)}t.replaceChild(o,e)}else{let o=document.createTextNode(String(n??""));t.replaceChild(o,e)}}function Ce(e,n){let t=[];for(let o of Array.from(e.attributes)){let r=o.name,a=o.value;if(r.startsWith("@")){let s=r.slice(1),c=a.match(/__t4_(\d+)__/);if(c){let l=n[parseInt(c[1],10)];typeof l=="function"&&e.addEventListener(s,f=>q(()=>l(f)))}t.push(r);continue}if(r.startsWith("?")){let s=r.slice(1),c=a.match(/__t4_(\d+)__/);if(c){let l=n[parseInt(c[1],10)];if(w(l)){let f=l;m(()=>{f.value?e.setAttribute(s,""):e.removeAttribute(s)})}else typeof l=="function"?m(()=>{l()?e.setAttribute(s,""):e.removeAttribute(s)}):l&&e.setAttribute(s,"")}t.push(r);continue}if(r.startsWith(".")){let s=r.slice(1),c=a.match(/__t4_(\d+)__/);if(c){let l=n[parseInt(c[1],10)];w(l)?m(()=>{e[s]=l.value}):e[s]=l}t.push(r);continue}let i=a.match(/__t4_(\d+)__/);if(i){let s=n[parseInt(i[1],10)];if(w(s)){let c=s;m(()=>{e.setAttribute(r,String(c.value??""))})}else typeof s=="function"?m(()=>{e.setAttribute(r,String(s()??""))}):e.setAttribute(r,String(s??""))}}for(let o of t)e.removeAttribute(o)}function F(e){if(e==null||e===!1)return[];if(Y(e))return Array.from(e.childNodes);if(e instanceof Node)return[e];if(Array.isArray(e)){let n=[];for(let t of e)n.push(...F(t));return n}return[document.createTextNode(String(e))]}function Y(e){return e!=null&&typeof e=="object"&&e.nodeType===11}function Te(e){let n=!1,t=!1,o=!1;for(let r=0;r<e.length;r++){let a=e[r];a==="<"&&!n&&!t&&(o=!0),a===">"&&!n&&!t&&(o=!1),o&&(a==='"'&&!n&&(t=!t),a==="'"&&!t&&(n=!n))}return o}var Z=null,ee=null;var I=class extends HTMLElement{constructor(){super();this._props={};this._rendered=!1;let t=this.constructor;this._root=t.shadow?this.attachShadow({mode:"open"}):this;for(let[o,r]of Object.entries(t.props))this._props[o]=h(this._coerce(this.getAttribute(o),r))}static{this.props={}}static{this.styles=""}static{this.shadow=!0}static get observedAttributes(){return Object.keys(this.props)}connectedCallback(){if(this._rendered)return;this._rendered=!0;let t=this.constructor;if(t.styles&&t.shadow&&this._root instanceof ShadowRoot){let r=document.createElement("style");r.textContent=t.styles,this._root.appendChild(r)}let o=this.render();o&&this._root.appendChild(o),this.onMount(),Z&&Z(this)}disconnectedCallback(){this.onUnmount(),ee&&ee(this)}attributeChangedCallback(t,o,r){let i=this.constructor.props[t];i&&this._props[t]&&(this._props[t].value=this._coerce(r,i))}prop(t){if(!this._props[t])throw new Error(`[tina4] Prop '${t}' not declared in static props of <${this.tagName.toLowerCase()}>`);return this._props[t]}emit(t,o){this.dispatchEvent(new CustomEvent(t,{bubbles:!0,composed:!0,...o}))}onMount(){}onUnmount(){}_coerce(t,o){return o===Boolean?t!==null:o===Number?t!==null?Number(t):0:t??""}};var U=[],T=null,S="history",_e=!1,E=[],O=[],te=0;function oe(e,n){let t=[],o;e==="*"?o=".*":o=e.replace(/\{(\w+)\}/g,(a,i)=>(t.push(i),"([^/]+)"));let r=new RegExp(`^${o}$`);typeof n=="function"?U.push({pattern:e,regex:r,paramNames:t,handler:n}):U.push({pattern:e,regex:r,paramNames:t,handler:n.handler,guard:n.guard})}function L(e,n){if(S==="hash")if(n?.replace){let t=new URL(location.href);t.hash="#"+e,history.replaceState(null,"",t.toString()),R()}else location.hash="#"+e;else n?.replace?history.replaceState(null,"",e):history.pushState(null,"",e),R()}function R(){if(!T)return;let e=performance.now(),n=++te,t=S==="hash"?location.hash.slice(1)||"/":location.pathname;for(let o of U){let r=t.match(o.regex);if(!r)continue;let a={};if(o.paramNames.forEach((c,l)=>{a[c]=decodeURIComponent(r[l+1])}),o.guard){let c=o.guard();if(c===!1)return;if(typeof c=="string"){L(c,{replace:!0});return}}for(let c of O)c();O=[],T.innerHTML="";let i=[];b(i);let s=o.handler(a);if(s instanceof Promise)s.then(c=>{if(b(null),n!==te){for(let f of i)f();return}ne(T,c),O=i;let l=performance.now()-e;for(let f of E)f({path:t,params:a,pattern:o.pattern,durationMs:l})});else{b(null),ne(T,s),O=i;let c=performance.now()-e;for(let l of E)l({path:t,params:a,pattern:o.pattern,durationMs:c})}return}}function ne(e,n){n instanceof DocumentFragment||n instanceof Node?e.replaceChildren(n):typeof n=="string"?e.innerHTML=n:n!=null&&e.replaceChildren(document.createTextNode(String(n)))}var re={start(e){if(T=document.querySelector(e.target),!T)throw new Error(`[tina4] Router target '${e.target}' not found in DOM`);S=e.mode??"history",_e=!0,window.addEventListener("popstate",R),S==="hash"&&window.addEventListener("hashchange",R),document.addEventListener("click",n=>{if(n.metaKey||n.ctrlKey||n.shiftKey||n.altKey)return;let t=n.target.closest("a[href]");if(!t||t.origin!==location.origin||t.hasAttribute("target")||t.hasAttribute("download")||t.getAttribute("rel")?.includes("external"))return;n.preventDefault();let o=S==="hash"?t.getAttribute("href"):t.pathname;L(o)}),R()},on(e,n){return E.push(n),()=>{let t=E.indexOf(n);t>=0&&E.splice(t,1)}}};var y={baseUrl:"",auth:!1,tokenKey:"tina4_token",headers:{}},j=[],K=[],Se=0;function se(){try{return localStorage.getItem(y.tokenKey)}catch{return null}}function Ee(e){try{localStorage.setItem(y.tokenKey,e)}catch{}}async function x(e,n,t,o){let r={method:e,headers:{"Content-Type":"application/json",...y.headers}};if(y.auth){let d=se();d&&(r.headers.Authorization=`Bearer ${d}`)}if(t!==void 0&&e!=="GET"){let d=typeof t=="object"&&t!==null?{...t}:t;if(y.auth&&typeof d=="object"&&d!==null){let p=se();p&&(d.formToken=p)}r.body=JSON.stringify(d)}if(o?.headers&&Object.assign(r.headers,o.headers),o?.params){let d=Object.entries(o.params).map(([p,v])=>`${encodeURIComponent(p)}=${encodeURIComponent(String(v))}`).join("&");n+=(n.includes("?")?"&":"?")+d}let a=y.baseUrl+n;r._url=a,r._requestId=++Se;for(let d of j){let p=d(r);p&&(r=p)}let i=await fetch(a,r),s=i.headers.get("FreshToken");s&&Ee(s);let c=i.headers.get("Content-Type")??"",l;c.includes("json")?l=await i.json():l=await i.text();let f={status:i.status,data:l,ok:i.ok,headers:i.headers,_requestId:r._requestId};for(let d of K){let p=d(f);p&&(f=p)}if(!i.ok)throw f;return f.data}var ie={configure(e){Object.assign(y,e)},get(e,n){return x("GET",e,void 0,n)},post(e,n,t){return x("POST",e,n,t)},put(e,n,t){return x("PUT",e,n,t)},patch(e,n,t){return x("PATCH",e,n,t)},delete(e,n){return x("DELETE",e,void 0,n)},intercept(e,n){e==="request"?j.push(n):K.push(n)},_reset(){y.baseUrl="",y.auth=!1,y.tokenKey="tina4_token",y.headers={},j.length=0,K.length=0}};function ae(e){let n=e.cacheStrategy??"network-first",t=JSON.stringify(e.precache??[]),o=e.offlineRoute?`'${e.offlineRoute}'`:"null";return`
+const CACHE = 'tina4-v1';
+const PRECACHE = ${t};
+const OFFLINE = ${o};
+
+self.addEventListener('install', (e) => {
+  e.waitUntil(
+    caches.open(CACHE).then((c) => c.addAll(PRECACHE)).then(() => self.skipWaiting())
+  );
+});
+
+self.addEventListener('activate', (e) => {
+  e.waitUntil(self.clients.claim());
+});
+
+self.addEventListener('fetch', (e) => {
+  const req = e.request;
+  if (req.method !== 'GET') return;
+
+  ${n==="cache-first"?`
+  e.respondWith(
+    caches.match(req).then((cached) => cached || fetch(req).then((res) => {
+      const clone = res.clone();
+      caches.open(CACHE).then((c) => c.put(req, clone));
+      return res;
+    })).catch(() => OFFLINE ? caches.match(OFFLINE) : new Response('Offline', { status: 503 }))
+  );`:n==="stale-while-revalidate"?`
+  e.respondWith(
+    caches.match(req).then((cached) => {
+      const fetched = fetch(req).then((res) => {
+        caches.open(CACHE).then((c) => c.put(req, res.clone()));
+        return res;
+      });
+      return cached || fetched;
+    }).catch(() => OFFLINE ? caches.match(OFFLINE) : new Response('Offline', { status: 503 }))
+  );`:`
+  e.respondWith(
+    fetch(req).then((res) => {
+      const clone = res.clone();
+      caches.open(CACHE).then((c) => c.put(req, clone));
+      return res;
+    }).catch(() => caches.match(req).then((cached) =>
+      cached || (OFFLINE ? caches.match(OFFLINE) : new Response('Offline', { status: 503 }))
+    ))
+  );`}
+});
+`.trim()}function ce(e){let n={name:e.name,short_name:e.shortName??e.name,start_url:"/",display:e.display??"standalone",background_color:e.backgroundColor??"#ffffff",theme_color:e.themeColor??"#000000"};return e.icon&&(n.icons=[{src:e.icon,sizes:"192x192",type:"image/png"},{src:e.icon,sizes:"512x512",type:"image/png"}]),n}var le={register(e){let n=ce(e),t=new Blob([JSON.stringify(n)],{type:"application/json"}),o=document.createElement("link");o.rel="manifest",o.href=URL.createObjectURL(t),document.head.appendChild(o);let r=document.querySelector('meta[name="theme-color"]');if(r||(r=document.createElement("meta"),r.name="theme-color",document.head.appendChild(r)),r.content=e.themeColor??"#000000","serviceWorker"in navigator){let a=ae(e),i=new Blob([a],{type:"text/javascript"}),s=URL.createObjectURL(i);navigator.serviceWorker.register(s).catch(c=>{console.warn("[tina4] Service worker registration failed:",c)})}},generateServiceWorker(e){return ae(e)},generateManifest(e){return ce(e)}};var Re={reconnect:!0,reconnectDelay:1e3,reconnectMaxDelay:3e4,reconnectAttempts:1/0,protocols:[]};function xe(e,n={}){let t={...Re,...n},o=h("connecting"),r=h(!1),a=h(null),i=h(null),s=h(0),c={message:[],open:[],close:[],error:[]},l=null,f=!1,d=t.reconnectDelay,p=null,v=0;function de(u){if(typeof u!="string")return u;try{return JSON.parse(u)}catch{return u}}function $(){o.value=v>0?"reconnecting":"connecting";try{l=new WebSocket(e,t.protocols)}catch{o.value="closed",r.value=!1;return}l.onopen=()=>{o.value="open",r.value=!0,i.value=null,v=0,d=t.reconnectDelay,s.value=0;for(let u of c.open)u()},l.onmessage=u=>{let g=de(u.data);a.value=g;for(let k of c.message)k(g)},l.onclose=u=>{o.value="closed",r.value=!1;for(let g of c.close)g(u.code,u.reason);!f&&t.reconnect&&v<t.reconnectAttempts&&fe()},l.onerror=u=>{i.value=u;for(let g of c.error)g(u)}}function fe(){v++,s.value=v,o.value="reconnecting",p=setTimeout(()=>{p=null,$()},d),d=Math.min(d*2,t.reconnectMaxDelay)}let G={status:o,connected:r,lastMessage:a,error:i,reconnectCount:s,send(u){if(!l||l.readyState!==WebSocket.OPEN)throw new Error("[tina4] WebSocket is not connected");let g=typeof u=="string"?u:JSON.stringify(u);l.send(g)},on(u,g){return c[u].push(g),()=>{let k=c[u],A=k.indexOf(g);A>=0&&k.splice(A,1)}},pipe(u,g){let k=A=>{u.value=g(A,u.value)};return G.on("message",k)},close(u,g){f=!0,p&&(clearTimeout(p),p=null),l&&l.close(u??1e3,g??""),o.value="closed",r.value=!1}};return $(),G}var ue={connect:xe};return ve(Ae);})();

data/lib/tina4/query_builder.rb

@@ -0,0 +1,374 @@
+# frozen_string_literal: true
+
+module Tina4
+  # QueryBuilder — Fluent SQL query builder.
+  #
+  # Usage:
+  #   # Standalone
+  #   result = Tina4::QueryBuilder.from("users", db: db)
+  #     .select("id", "name")
+  #     .where("active = ?", [1])
+  #     .order_by("name ASC")
+  #     .limit(10)
+  #     .get
+  #
+  #   # From ORM model
+  #   result = User.query
+  #     .where("age > ?", [18])
+  #     .order_by("name")
+  #     .get
+  #
+  class QueryBuilder
+    def initialize(table, db: nil)
+      @table = table
+      @db = db
+      @columns = ["*"]
+      @wheres = []
+      @params = []
+      @joins = []
+      @group_by_cols = []
+      @havings = []
+      @having_params = []
+      @order_by_cols = []
+      @limit_val = nil
+      @offset_val = nil
+    end
+
+    # Create a QueryBuilder for a table.
+    #
+    # @param table_name [String] The database table name.
+    # @param db [Object, nil] Optional database connection.
+    # @return [QueryBuilder]
+    def self.from(table_name, db: nil)
+      new(table_name, db: db)
+    end
+
+    # Set the columns to select.
+    #
+    # @param columns [Array<String>] Column names.
+    # @return [self]
+    def select(*columns)
+      @columns = columns unless columns.empty?
+      self
+    end
+
+    # Add a WHERE condition with AND.
+    #
+    # @param condition [String] SQL condition with ? placeholders.
+    # @param params [Array] Parameter values.
+    # @return [self]
+    def where(condition, params = [])
+      @wheres << ["AND", condition]
+      @params.concat(params)
+      self
+    end
+
+    # Add a WHERE condition with OR.
+    #
+    # @param condition [String] SQL condition with ? placeholders.
+    # @param params [Array] Parameter values.
+    # @return [self]
+    def or_where(condition, params = [])
+      @wheres << ["OR", condition]
+      @params.concat(params)
+      self
+    end
+
+    # Add an INNER JOIN.
+    #
+    # @param table [String] Table to join.
+    # @param on_clause [String] Join condition.
+    # @return [self]
+    def join(table, on_clause)
+      @joins << "INNER JOIN #{table} ON #{on_clause}"
+      self
+    end
+
+    # Add a LEFT JOIN.
+    #
+    # @param table [String] Table to join.
+    # @param on_clause [String] Join condition.
+    # @return [self]
+    def left_join(table, on_clause)
+      @joins << "LEFT JOIN #{table} ON #{on_clause}"
+      self
+    end
+
+    # Add a GROUP BY column.
+    #
+    # @param column [String] Column name.
+    # @return [self]
+    def group_by(column)
+      @group_by_cols << column
+      self
+    end
+
+    # Add a HAVING clause.
+    #
+    # @param expression [String] HAVING expression with ? placeholders.
+    # @param params [Array] Parameter values.
+    # @return [self]
+    def having(expression, params = [])
+      @havings << expression
+      @having_params.concat(params)
+      self
+    end
+
+    # Add an ORDER BY clause.
+    #
+    # @param expression [String] Column and direction (e.g. "name ASC").
+    # @return [self]
+    def order_by(expression)
+      @order_by_cols << expression
+      self
+    end
+
+    # Set LIMIT and optional OFFSET.
+    #
+    # @param count [Integer] Maximum rows to return.
+    # @param offset [Integer, nil] Number of rows to skip.
+    # @return [self]
+    def limit(count, offset = nil)
+      @limit_val = count
+      @offset_val = offset unless offset.nil?
+      self
+    end
+
+    # Build and return the SQL string without executing.
+    #
+    # @return [String] The constructed SQL query.
+    def to_sql
+      sql = "SELECT #{@columns.join(', ')} FROM #{@table}"
+
+      sql += " #{@joins.join(' ')}" unless @joins.empty?
+
+      sql += " WHERE #{build_where}" unless @wheres.empty?
+
+      sql += " GROUP BY #{@group_by_cols.join(', ')}" unless @group_by_cols.empty?
+
+      sql += " HAVING #{@havings.join(' AND ')}" unless @havings.empty?
+
+      sql += " ORDER BY #{@order_by_cols.join(', ')}" unless @order_by_cols.empty?
+
+      sql
+    end
+
+    # Execute the query and return the database result.
+    #
+    # @return [Object] The result from db.fetch.
+    def get
+      ensure_db!
+      sql = to_sql
+      all_params = @params + @having_params
+
+      @db.fetch(
+        sql,
+        all_params.empty? ? [] : all_params,
+        limit: @limit_val || 100,
+        offset: @offset_val || 0
+      )
+    end
+
+    # Execute the query and return a single row.
+    #
+    # @return [Hash, nil] A single row hash, or nil.
+    def first
+      ensure_db!
+      sql = to_sql
+      all_params = @params + @having_params
+
+      @db.fetch_one(sql, all_params.empty? ? [] : all_params)
+    end
+
+    # Execute the query and return the row count.
+    #
+    # @return [Integer] Number of matching rows.
+    def count
+      ensure_db!
+
+      # Build a count query by replacing columns
+      original = @columns
+      @columns = ["COUNT(*) as cnt"]
+      sql = to_sql
+      @columns = original
+
+      all_params = @params + @having_params
+
+      row = @db.fetch_one(sql, all_params.empty? ? [] : all_params)
+      return 0 if row.nil?
+
+      # Handle case-insensitive column names
+      (row["cnt"] || row["CNT"] || row[:cnt] || row[:CNT] || 0).to_i
+    end
+
+    # Check whether any matching rows exist.
+    #
+    # @return [Boolean]
+    def exists?
+      count > 0
+    end
+
+    # Convert the fluent builder state into a MongoDB-compatible query hash.
+    #
+    # @return [Hash] with keys :filter, :projection, :sort, :limit, :skip (only non-empty).
+    def to_mongo
+      result = {}
+
+      # -- projection --
+      if @columns != ["*"]
+        result[:projection] = @columns.each_with_object({}) { |col, h| h[col.strip] = 1 }
+      end
+
+      # -- filter --
+      unless @wheres.empty?
+        param_index = 0
+        and_conditions = []
+        or_conditions = []
+
+        @wheres.each_with_index do |(connector, condition), i|
+          mongo_cond, param_index = parse_condition_to_mongo(condition, param_index)
+          if i == 0 || connector == "AND"
+            and_conditions << mongo_cond
+          else
+            or_conditions << mongo_cond
+          end
+        end
+
+        if or_conditions.any?
+          and_merged = merge_mongo_conditions(and_conditions)
+          all_branches = [and_merged] + or_conditions
+          result[:filter] = { "$or" => all_branches }
+        else
+          result[:filter] = merge_mongo_conditions(and_conditions)
+        end
+      end
+
+      # -- sort --
+      unless @order_by_cols.empty?
+        sort = {}
+        @order_by_cols.each do |expr|
+          parts = expr.strip.split(/\s+/)
+          field = parts[0]
+          direction = (parts[1] && parts[1].upcase == "DESC") ? -1 : 1
+          sort[field] = direction
+        end
+        result[:sort] = sort
+      end
+
+      # -- limit / skip --
+      result[:limit] = @limit_val unless @limit_val.nil?
+      result[:skip] = @offset_val unless @offset_val.nil?
+
+      result
+    end
+
+    private
+
+    # Parse a single SQL condition into a MongoDB filter hash.
+    #
+    # @return [Array(Hash, Integer)] [mongo_condition, updated_param_index]
+    def parse_condition_to_mongo(condition, param_index)
+      cond = condition.strip
+
+      # IS NOT NULL
+      if cond.match?(/\A(\w+)\s+IS\s+NOT\s+NULL\z/i)
+        field = cond.match(/\A(\w+)/)[1]
+        return [{ field => { "$exists" => true, "$ne" => nil } }, param_index]
+      end
+
+      # IS NULL
+      if cond.match?(/\A(\w+)\s+IS\s+NULL\z/i)
+        field = cond.match(/\A(\w+)/)[1]
+        return [{ field => { "$exists" => false } }, param_index]
+      end
+
+      # NOT IN
+      if (m = cond.match(/\A(\w+)\s+NOT\s+IN\s*\(\s*\?\s*\)\z/i))
+        val = @params[param_index]
+        values = val.is_a?(Array) ? val : [val]
+        return [{ m[1] => { "$nin" => values } }, param_index + 1]
+      end
+
+      # IN
+      if (m = cond.match(/\A(\w+)\s+IN\s*\(\s*\?\s*\)\z/i))
+        val = @params[param_index]
+        values = val.is_a?(Array) ? val : [val]
+        return [{ m[1] => { "$in" => values } }, param_index + 1]
+      end
+
+      # LIKE
+      if (m = cond.match(/\A(\w+)\s+LIKE\s+\?\z/i))
+        val = (@params[param_index] || "").to_s
+        pattern = val.gsub("%", ".*").gsub("_", ".")
+        return [{ m[1] => { "$regex" => pattern, "$options" => "i" } }, param_index + 1]
+      end
+
+      # Comparison operators: >=, <=, <>, !=, >, <, =
+      if (m = cond.match(/\A(\w+)\s*(>=|<=|<>|!=|>|<|=)\s*\?\z/))
+        field = m[1]
+        op = m[2]
+        val = @params[param_index]
+
+        op_map = {
+          "=" => nil, "!=" => "$ne", "<>" => "$ne",
+          ">" => "$gt", ">=" => "$gte",
+          "<" => "$lt", "<=" => "$lte"
+        }
+
+        mongo_op = op_map[op]
+        if mongo_op.nil?
+          return [{ field => val }, param_index + 1]
+        end
+        return [{ field => { mongo_op => val } }, param_index + 1]
+      end
+
+      # Fallback
+      [{ "$where" => cond }, param_index]
+    end
+
+    # Merge multiple single-field mongo condition hashes into one.
+    # Uses $and if field keys conflict.
+    def merge_mongo_conditions(conditions)
+      return conditions[0] if conditions.size == 1
+
+      merged = {}
+      has_conflict = false
+
+      conditions.each do |cond|
+        cond.each do |key, val|
+          if merged.key?(key)
+            has_conflict = true
+            break
+          end
+          merged[key] = val
+        end
+        break if has_conflict
+      end
+
+      return { "$and" => conditions } if has_conflict
+
+      merged
+    end
+
+    # Build the WHERE clause from accumulated conditions.
+    def build_where
+      parts = []
+      @wheres.each_with_index do |(connector, condition), index|
+        if index == 0
+          parts << condition
+        else
+          parts << "#{connector} #{condition}"
+        end
+      end
+      parts.join(" ")
+    end
+
+    # Ensure a database connection is available.
+    def ensure_db!
+      return unless @db.nil?
+
+      @db = Tina4.database if defined?(Tina4.database) && Tina4.database
+      raise "QueryBuilder: No database connection provided." if @db.nil?
+    end
+  end
+end