@joystick.js/db-canary 0.0.0-canary.2250 → 0.0.0-canary.2252

package/dist/server/lib/operations/create_index.js

@@ -1 +1 @@
-import{create_index as a}from"../index_manager.js";import n from"../logger.js";const{create_context_logger:u}=n("create_index"),p=async(r,e,t,c={})=>{const s=u();if(!r)throw new Error("Database name is required");if(!e)throw new Error("Collection name is required");if(!t)throw new Error("Field name is required");try{const o=await a(r,e,t,c),i=o.operation_type||"created",d=i==="created"?"created":i==="updated"?"updated":"already exists";return s.info(`Index ${d} successfully`,{database:r,collection:e,field:t,options:c,operation_type:i}),{...o,message:`Index ${d} on ${r}.${e}.${t}`}}catch(o){throw s.error("Failed to create/upsert index",{database:r,collection:e,field:t,error:o.message}),o}};var g=p;export{g as default};
+import{create_index as d}from"../index_manager.js";import _ from"../logger.js";const{create_context_logger:u}=_("create_index"),l=e=>{if(!e)throw new Error("Database name is required")},p=e=>{if(!e)throw new Error("Collection name is required")},x=e=>{if(!e)throw new Error("Field name is required")},f=(e,r,t)=>{l(e),p(r),x(t)},g=e=>{switch(e){case"created":return"created";case"updated":return"updated";default:return"already exists"}},w=(e,r,t,o)=>`Index ${e} on ${r}.${t}.${o}`,h=(e,r,t,o,c,s,a)=>{e.info(`Index ${r} successfully`,{database:t,collection:o,field:c,options:s,operation_type:a})},v=(e,r,t,o,c)=>{e.error("Failed to create/upsert index",{database:r,collection:t,field:o,error:c.message})},y=(e,r)=>({...e,message:r}),$=async(e,r,t,o={})=>{const c=u();f(e,r,t);try{const s=await d(e,r,t,o),a=s.operation_type||"created",n=g(a),i=w(n,e,r,t);return h(c,n,e,r,t,o,a),y(s,i)}catch(s){throw v(c,e,r,t,s),s}};var b=$;export{b as default};

package/dist/server/lib/operations/delete_many.js

@@ -1 +1 @@
-import{get_database as _}from"../query_engine.js";import{update_indexes_on_delete as w}from"../index_manager.js";import{get_write_queue as p}from"../write_queue.js";import g from"../logger.js";const{create_context_logger:y}=g("delete_many"),b=(t,e)=>{if(!e||Object.keys(e).length===0)return!0;for(const[r,o]of Object.entries(e))if(t[r]!==o)return!1;return!0},h=async(t,e,r,o={})=>{const s=y();if(!t)throw new Error("Database name is required");if(!e)throw new Error("Collection name is required");if(!r||typeof r!="object")throw new Error("Filter must be a valid object");const{limit:n}=o;if(n!==void 0&&(typeof n!="number"||n<0))throw new Error("Limit must be a non-negative number");const c=_();let i=0;const d=[];await c.transaction(()=>{const a=`${t}:${e}:`,l=c.getRange({start:a,end:a+"\xFF"});for(const{key:f,value:m}of l){if(n!==void 0&&i>=n)break;try{const u=JSON.parse(m);b(u,r)&&(c.remove(f),d.push(u),i++)}catch{continue}}});for(const a of d)await w(t,e,a);return s.info("Delete many operation completed",{database:t,collection:e,deleted_count:i,limit:n||"none"}),{acknowledged:!0,deleted_count:i,operation_time:new Date().toISOString()}},k=async(t,e,r,o={})=>await p().enqueue_write_operation(()=>h(t,e,r,o),{operation:"delete_many",database:t,collection:e,filter_keys:Object.keys(r||{}),limit:o.limit});var O=k;export{O as default};
+import{get_database as l}from"../query_engine.js";import{update_indexes_on_delete as m}from"../index_manager.js";import{get_write_queue as f}from"../write_queue.js";import p from"../logger.js";const{create_context_logger:y}=p("delete_many"),w=e=>{if(!e)throw new Error("Database name is required")},g=e=>{if(!e)throw new Error("Collection name is required")},b=e=>{if(!e||typeof e!="object")throw new Error("Filter must be a valid object")},h=e=>{if(e!==void 0&&(typeof e!="number"||e<0))throw new Error("Limit must be a non-negative number")},v=(e,t,n,r)=>{w(e),g(t),b(n),h(r.limit)},k=(e,t,n)=>e[t]===n,q=(e,t)=>{if(!t||Object.keys(t).length===0)return!0;for(const[n,r]of Object.entries(t))if(!k(e,n,r))return!1;return!0},x=e=>{try{return JSON.parse(e)}catch{return null}},j=(e,t)=>t!==void 0&&e>=t,O=(e,t,n,r,a)=>{let o=0;const c=[],s=`${t}:${n}:`,i=e.getRange({start:s,end:s+"\xFF"});for(const{key:d,value:u}of i){if(j(o,a))break;const _=x(u);_&&q(_,r)&&(e.remove(d),c.push(_),o++)}return{deleted_count:o,deleted_documents:c}},E=async(e,t,n)=>{for(const r of n)await m(e,t,r)},D=(e,t,n,r,a)=>{e.info("Delete many operation completed",{database:t,collection:n,deleted_count:r,limit:a||"none"})},F=()=>new Date().toISOString(),S=e=>({acknowledged:!0,deleted_count:e,operation_time:F()}),$=(e,t,n,r)=>({operation:"delete_many",database:e,collection:t,filter_keys:Object.keys(n||{}),limit:r}),C=async(e,t,n,r={})=>{const a=y();v(e,t,n,r);const{limit:o}=r,c=l(),s=await c.transaction(()=>O(c,e,t,n,o)),{deleted_count:i,deleted_documents:d}=s;return await E(e,t,d),D(a,e,t,i,o),S(i)},I=async(e,t,n,r={})=>{const a=f(),o=$(e,t,n,r.limit);return await a.enqueue_write_operation(()=>C(e,t,n,r),o)};var z=I;export{z as default};

package/dist/server/lib/operations/delete_one.js

@@ -1 +1 @@
-import{get_database as _}from"../query_engine.js";import{update_indexes_on_delete as p}from"../index_manager.js";import{get_write_queue as w}from"../write_queue.js";import g from"../logger.js";const{create_context_logger:b}=g("delete_one"),m=(t,e)=>{if(!e||Object.keys(e).length===0)return!0;for(const[r,o]of Object.entries(e))if(t[r]!==o)return!1;return!0},y=async(t,e,r,o={})=>{const u=b();if(!t)throw new Error("Database name is required");if(!e)throw new Error("Collection name is required");if(!r||typeof r!="object")throw new Error("Filter must be a valid object");const n=_();let i=0,c=null;return await n.transaction(()=>{const a=`${t}:${e}:`,l=n.getRange({start:a,end:a+"\xFF"});for(const{key:d,value:f}of l)try{const s=JSON.parse(f);if(m(s,r)){n.remove(d),c=s,i=1;break}}catch{continue}}),c&&await p(t,e,c),u.info("Delete operation completed",{database:t,collection:e,deleted_count:i}),{acknowledged:!0,deleted_count:i}},h=async(t,e,r,o={})=>await w().enqueue_write_operation(()=>y(t,e,r,o),{operation:"delete_one",database:t,collection:e,filter_keys:Object.keys(r||{})});var v=h;export{v as default};
+import{get_database as _}from"../query_engine.js";import{update_indexes_on_delete as u}from"../index_manager.js";import{get_write_queue as f}from"../write_queue.js";import p from"../logger.js";const{create_context_logger:m}=p("delete_one"),w=e=>{if(!e)throw new Error("Database name is required")},g=e=>{if(!e)throw new Error("Collection name is required")},y=e=>{if(!e||typeof e!="object")throw new Error("Filter must be a valid object")},v=(e,t,o)=>{w(e),g(t),y(o)},b=(e,t,o)=>e[t]===o,h=(e,t)=>{if(!t||Object.keys(t).length===0)return!0;for(const[o,r]of Object.entries(t))if(!b(e,o,r))return!1;return!0},k=e=>{try{return JSON.parse(e)}catch{return null}},q=(e,t,o,r)=>{let a=0,n=null;const c=`${t}:${o}:`,s=e.getRange({start:c,end:c+"\xFF"});for(const{key:i,value:d}of s){const l=k(d);if(l&&h(l,r)){e.remove(i),n=l,a=1;break}}return{deleted_count:a,deleted_document:n}},x=async(e,t,o)=>{o&&await u(e,t,o)},j=(e,t,o,r)=>{e.info("Delete operation completed",{database:t,collection:o,deleted_count:r})},O=e=>({acknowledged:!0,deleted_count:e}),E=(e,t,o)=>({operation:"delete_one",database:e,collection:t,filter_keys:Object.keys(o||{})}),F=async(e,t,o,r={})=>{const a=m();v(e,t,o);const n=_(),c=await n.transaction(()=>q(n,e,t,o)),{deleted_count:s,deleted_document:i}=c;return await x(e,t,i),j(a,e,t,s),O(s)},D=async(e,t,o,r={})=>{const a=f(),n=E(e,t,o);return await a.enqueue_write_operation(()=>F(e,t,o,r),n)};var R=D;export{R as default};

package/dist/server/lib/operations/find.js

@@ -1 +1 @@
-import{get_database as D,build_collection_key as q}from"../query_engine.js";import{can_use_index as J,find_documents_by_index as v}from"../index_manager.js";import{record_query as N,record_index_usage as F}from"../auto_index_manager.js";import S from"../logger.js";const{create_context_logger:R}=S("find"),C=(n,r)=>{const o=r.split(".");let t=n;for(const e of o){if(t==null)return;t=t[e]}return t},P=(n,r)=>{const o=r.split(".");let t=n;for(let e=0;e<o.length;e++){if(t==null||typeof t!="object")return!1;if(e===o.length-1)return t.hasOwnProperty(o[e]);t=t[o[e]]}return!1},b=(n,r)=>{if(!r||Object.keys(r).length===0)return!0;if(r.$or&&Array.isArray(r.$or)){if(!r.$or.some(e=>b(n,e)))return!1;const t={...r};return delete t.$or,Object.keys(t).length>0?b(n,t):!0}for(const[o,t]of Object.entries(r)){const e=C(n,o);if(typeof t=="object"&&t!==null&&!Array.isArray(t))for(const[i,s]of Object.entries(t))switch(i){case"$eq":if(e!==s)return!1;break;case"$ne":if(e===s)return!1;break;case"$gt":if(e<=s)return!1;break;case"$gte":if(e<s)return!1;break;case"$lt":if(e>=s)return!1;break;case"$lte":if(e>s)return!1;break;case"$in":if(!Array.isArray(s)||!s.includes(e))return!1;break;case"$nin":if(!Array.isArray(s)||s.includes(e))return!1;break;case"$exists":const c=P(n,o);if(s&&!c||!s&&c)return!1;break;case"$regex":const u=t.$options||"";if(!new RegExp(s,u).test(e))return!1;break;case"$options":break;default:throw new Error(`Unsupported query operator: ${i}`)}else if(e!==t)return!1}return!0},U=(n,r)=>{if(!r||Object.keys(r).length===0)return n;const o=Object.values(r).some(e=>e===1||e===!0),t={};if(o){t._id=n._id;for(const[e,i]of Object.entries(r))e==="_id"&&(i===0||i===!1)?delete t._id:(i===1||i===!0)&&(t[e]=n[e])}else{Object.assign(t,n);for(const[e,i]of Object.entries(r))(i===0||i===!1)&&delete t[e]}return t},z=(n,r)=>!r||Object.keys(r).length===0?n:n.sort((o,t)=>{for(const[e,i]of Object.entries(r)){const s=o[e],c=t[e];if(s===c)continue;if(s===void 0)return 1;if(c===void 0)return-1;const u=s<c?-1:s>c?1:0;return i===-1?-u:u}return 0}),B=async(n,r,o={},t={})=>{const e=R();if(!n)throw new Error("Database name is required");if(!r)throw new Error("Collection name is required");const i=D(),{projection:s,sort:c,limit:u,skip:k=0}=t,E=Date.now();try{let d=[],_=!1,$=null;const O=J(n,r,o);if(O){const{field:f,operators:h}=O,a=o[f];if($=f,typeof a=="object"&&a!==null&&!Array.isArray(a)){for(const l of h)if(a[l]!==void 0){const p=v(n,r,f,l,a[l]);if(p){_=!0,F(n,r,f);for(const m of p){const x=q(n,r,m),y=i.get(x);if(y){const A=JSON.parse(y);b(A,o)&&d.push(A)}}break}}}else if(h.includes("eq")){const l=v(n,r,f,"eq",a);if(l){_=!0,F(n,r,f);for(const p of l){const m=q(n,r,p),x=i.get(m);if(x){const y=JSON.parse(x);b(y,o)&&d.push(y)}}}}}if(!_){const f=`${n}:${r}:`,h=i.getRange({start:f,end:f+"\xFF"});for(const{key:a,value:l}of h){const p=JSON.parse(l);b(p,o)&&d.push(p)}}let g=z(d,c);k>0&&(g=g.slice(k)),u&&u>0&&(g=g.slice(0,u));const j=g.map(f=>U(f,s)),w=Date.now()-E;try{N(r,o,w,_,$)}catch(f){e.warn("Failed to record query for auto-indexing",{error:f.message})}return e.info("Find operation completed",{database:n,collection:r,documents_found:j.length,total_matching:d.length,used_index:_,indexed_field:$,execution_time_ms:w}),j}catch(d){throw e.error("Failed to find documents",{database:n,collection:r,error:d.message}),d}};var L=B;export{L as default};
+import{get_database as O,build_collection_key as F}from"../query_engine.js";import{can_use_index as E,find_documents_by_index as x}from"../index_manager.js";import{record_query as D,record_index_usage as J}from"../auto_index_manager.js";import N from"../logger.js";const{create_context_logger:R}=N("find"),m=r=>r.split("."),b=r=>r==null,S=(r,e)=>{const t=[];for(let n=0;n<r.length;n++){const s=r[n];if(typeof s=="object"&&s!==null){const o=j(s,e);o!==void 0&&(Array.isArray(o)?t.push(...o):t.push(o))}}return t.length>0?t:void 0},j=(r,e)=>{const t=m(e);let n=r;for(let s=0;s<t.length;s++){const o=t[s];if(b(n))return;if(n=n[o],Array.isArray(n)&&s<t.length-1){const i=t.slice(s+1).join(".");return S(n,i)}}return n},C=(r,e)=>r.hasOwnProperty(e),P=(r,e)=>{const t=m(e);let n=r;for(let s=0;s<t.length;s++){if(b(n)||typeof n!="object")return!1;if(s===t.length-1)return C(n,t[s]);n=n[t[s]]}return!1},k=(r,e)=>r.includes(e),p=(r,e,t)=>{for(let n=0;n<r.length;n++)if(t(r[n],e))return!0;return!1},$=(r,e)=>Array.isArray(r)?k(r,e):r===e,U=(r,e)=>Array.isArray(r)?!k(r,e):r!==e,z=(r,e)=>Array.isArray(r)?p(r,e,(t,n)=>t>n):r>e,B=(r,e)=>Array.isArray(r)?p(r,e,(t,n)=>t>=n):r>=e,G=(r,e)=>Array.isArray(r)?p(r,e,(t,n)=>t<n):r<e,H=(r,e)=>Array.isArray(r)?p(r,e,(t,n)=>t<=n):r<=e,I=(r,e)=>Array.isArray(e)?Array.isArray(r)?p(r,e,(t,n)=>n.includes(t)):e.includes(r):!1,K=(r,e)=>{if(!Array.isArray(e))return!1;if(Array.isArray(r)){for(let t=0;t<r.length;t++)if(e.includes(r[t]))return!1;return!0}return!e.includes(r)},L=(r,e,t)=>{const n=P(r,e);return t?n:!n},M=(r,e,t="")=>{const n=new RegExp(e,t);return Array.isArray(r)?p(r,n,(s,o)=>typeof s=="string"&&o.test(s)):n.test(r)},Q=(r,e,t,n)=>{for(const[s,o]of Object.entries(n))switch(s){case"$eq":if(!$(t,o))return!1;break;case"$ne":if(!U(t,o))return!1;break;case"$gt":if(!z(t,o))return!1;break;case"$gte":if(!B(t,o))return!1;break;case"$lt":if(!G(t,o))return!1;break;case"$lte":if(!H(t,o))return!1;break;case"$in":if(!I(t,o))return!1;break;case"$nin":if(!K(t,o))return!1;break;case"$exists":if(!L(r,e,o))return!1;break;case"$regex":const i=n.$options||"";if(!M(t,o,i))return!1;break;case"$options":break;default:throw new Error(`Unsupported query operator: ${s}`)}return!0},T=(r,e)=>{for(let t=0;t<e.length;t++)if(y(r,e[t]))return!0;return!1},y=(r,e)=>{if(!e||Object.keys(e).length===0)return!0;if(e.$or&&Array.isArray(e.$or)){if(!T(r,e.$or))return!1;const t={...e};return delete t.$or,Object.keys(t).length>0?y(r,t):!0}for(const[t,n]of Object.entries(e)){const s=j(r,t);if(typeof n=="object"&&n!==null&&!Array.isArray(n)){if(!Q(r,t,s,n))return!1}else if(!$(s,n))return!1}return!0},V=r=>Object.values(r).some(e=>e===1||e===!0),W=(r,e)=>{const t={_id:r._id};for(const[n,s]of Object.entries(e))n==="_id"&&(s===0||s===!1)?delete t._id:(s===1||s===!0)&&(t[n]=r[n]);return t},X=(r,e)=>{const t={...r};for(const[n,s]of Object.entries(e))(s===0||s===!1)&&delete t[n];return t},Y=(r,e)=>!e||Object.keys(e).length===0?r:V(e)?W(r,e):X(r,e),Z=(r,e,t)=>{if(r===e)return 0;if(r===void 0)return 1;if(e===void 0)return-1;const n=r<e?-1:r>e?1:0;return t===-1?-n:n},v=(r,e)=>!e||Object.keys(e).length===0?r:r.sort((t,n)=>{for(const[s,o]of Object.entries(e)){const i=Z(t[s],n[s],o);if(i!==0)return i}return 0}),rr=(r,e)=>{if(!r)throw new Error("Database name is required");if(!e)throw new Error("Collection name is required")},er=(r,e,t,n,s)=>{const{field:o,operators:i}=s,c=n[o],_=[];J(e,t,o);let a=null;if(typeof c=="object"&&c!==null&&!Array.isArray(c)){for(const f of i)if(c[f]!==void 0){a=x(e,t,o,f,c[f]);break}}else i.includes("eq")&&(a=x(e,t,o,"eq",c));if(a)for(const f of a){const u=F(e,t,f),l=r.get(u);if(l){const d=JSON.parse(l);y(d,n)&&_.push(d)}}return _},tr=(r,e,t,n)=>{const s=[],o=`${e}:${t}:`,i=r.getRange({start:o,end:o+"\xFF"});for(const{key:c,value:_}of i){const a=JSON.parse(_);y(a,n)&&s.push(a)}return s},nr=(r,e,t)=>{let n=r;return e>0&&(n=n.slice(e)),t&&t>0&&(n=n.slice(0,t)),n},sr=(r,e,t,n,s,o)=>{try{D(e,t,n,s,o)}catch(i){r.warn("Failed to record query for auto-indexing",{error:i.message})}},or=(r,e,t,n,s,o,i,c)=>{r.info("Find operation completed",{database:e,collection:t,documents_found:n,total_matching:s,used_index:o,indexed_field:i,execution_time_ms:c})},ir=async(r,e,t={},n={})=>{const s=R();rr(r,e);const o=O(),{projection:i,sort:c,limit:_,skip:a=0}=n,f=Date.now();try{let u=[],l=!1,d=null;const g=E(r,e,t);g&&(d=g.field,u=er(o,r,e,t,g),l=u.length>0),l||(u=tr(o,r,e,t));const q=v(u,c),h=nr(q,a,_).map(w=>Y(w,i)),A=Date.now()-f;return sr(s,e,t,A,l,d),or(s,r,e,h.length,u.length,l,d,A),h}catch(u){throw s.error("Failed to find documents",{database:r,collection:e,error:u.message}),u}};var _r=ir;export{_r as default};

package/dist/server/lib/operations/find_one.js

@@ -1 +1 @@
-import{get_database as q,build_collection_key as j}from"../query_engine.js";import{can_use_index as v,find_documents_by_index as m}from"../index_manager.js";import{record_query as D,record_index_usage as A}from"../auto_index_manager.js";import E from"../logger.js";const{create_context_logger:F}=E("find_one"),N=(o,t)=>{const n=t.split(".");let r=o;for(const e of n){if(r==null)return;r=r[e]}return r},J=(o,t)=>{const n=t.split(".");let r=o;for(let e=0;e<n.length;e++){if(r==null||typeof r!="object")return!1;if(e===n.length-1)return r.hasOwnProperty(n[e]);r=r[n[e]]}return!1},p=(o,t)=>{if(!t||Object.keys(t).length===0)return!0;if(t.$or&&Array.isArray(t.$or)){if(!t.$or.some(e=>p(o,e)))return!1;const r={...t};return delete r.$or,Object.keys(r).length>0?p(o,r):!0}for(const[n,r]of Object.entries(t)){const e=N(o,n);if(typeof r=="object"&&r!==null&&!Array.isArray(r))for(const[i,s]of Object.entries(r))switch(i){case"$eq":if(e!==s)return!1;break;case"$ne":if(e===s)return!1;break;case"$gt":if(e<=s)return!1;break;case"$gte":if(e<s)return!1;break;case"$lt":if(e>=s)return!1;break;case"$lte":if(e>s)return!1;break;case"$in":if(!Array.isArray(s)||!s.includes(e))return!1;break;case"$nin":if(!Array.isArray(s)||s.includes(e))return!1;break;case"$exists":const x=J(o,n);if(s&&!x||!s&&x)return!1;break;case"$regex":const k=r.$options||"";if(!new RegExp(s,k).test(e))return!1;break;case"$options":break;default:throw new Error(`Unsupported query operator: ${i}`)}else if(e!==r)return!1}return!0},S=(o,t)=>{if(!t||Object.keys(t).length===0)return o;const n=Object.values(t).some(e=>e===1||e===!0),r={};if(n){r._id=o._id;for(const[e,i]of Object.entries(t))e==="_id"&&(i===0||i===!1)?delete r._id:(i===1||i===!0)&&(r[e]=o[e])}else{Object.assign(r,o);for(const[e,i]of Object.entries(t))(i===0||i===!1)&&delete r[e]}return r},R=async(o,t,n={},r={})=>{const e=F();if(!o)throw new Error("Database name is required");if(!t)throw new Error("Collection name is required");const i=q(),{projection:s,sort:x}=r,k=Date.now();try{let f=null,a=!1,g=null;const O=v(o,t,n);if(O){const{field:c,operators:y}=O,d=n[c];if(g=c,typeof d=="object"&&d!==null&&!Array.isArray(d)){for(const u of y)if(d[u]!==void 0){const l=m(o,t,c,u,d[u]);if(l&&l.length>0){a=!0,A(o,t,c);for(const $ of l){const b=j(o,t,$),_=i.get(b);if(_)try{const w=JSON.parse(_);if(p(w,n)){f=w;break}}catch{continue}}break}}}else if(y.includes("eq")){const u=m(o,t,c,"eq",d);if(u&&u.length>0){a=!0,A(o,t,c);for(const l of u){const $=j(o,t,l),b=i.get($);if(b)try{const _=JSON.parse(b);if(p(_,n)){f=_;break}}catch{continue}}}}}if(!a){const c=`${o}:${t}:`,y=i.getRange({start:c,end:c+"\xFF"});for(const{key:d,value:u}of y)try{const l=JSON.parse(u);if(p(l,n)){f=l;break}}catch{continue}}const h=Date.now()-k;try{D(t,n,h,a,g)}catch(c){e.warn("Failed to record query for auto-indexing",{error:c.message})}if(f){const c=S(f,s);return e.info("Document found",{database:o,collection:t,document_id:f._id,used_index:a,indexed_field:g,execution_time_ms:h}),c}return e.info("No document found",{database:o,collection:t,used_index:a,indexed_field:g,execution_time_ms:h}),null}catch(f){throw e.error("Failed to find document",{database:o,collection:t,error:f.message}),f}};var B=R;export{B as default};
+import{get_database as k,build_collection_key as m}from"../query_engine.js";import{can_use_index as q,find_documents_by_index as p}from"../index_manager.js";import{record_query as w,record_index_usage as O}from"../auto_index_manager.js";import D from"../logger.js";const{create_context_logger:E}=D("find_one"),g=r=>r.split("."),h=r=>r==null,F=(r,e)=>r.slice(e+1).join("."),N=(r,e)=>{const t=[];for(let n=0;n<r.length;n++){const o=r[n];if(typeof o=="object"&&o!==null){const s=A(o,e);s!==void 0&&(Array.isArray(s)?t.push(...s):t.push(s))}}return t.length>0?t:void 0},A=(r,e)=>{const t=g(e);let n=r;for(let o=0;o<t.length;o++){const s=t[o];if(h(n))return;if(n=n[s],Array.isArray(n)&&o<t.length-1){const c=F(t,o);return N(n,c)}}return n},R=(r,e)=>r.hasOwnProperty(e),C=(r,e)=>{const t=g(e);let n=r;for(let o=0;o<t.length;o++){if(h(n)||typeof n!="object")return!1;if(o===t.length-1)return R(n,t[o]);n=n[t[o]]}return!1},x=(r,e)=>r.includes(e),y=(r,e,t)=>{for(let n=0;n<r.length;n++)if(t(r[n],e))return!0;return!1},b=(r,e)=>Array.isArray(r)?x(r,e):r===e,J=(r,e)=>Array.isArray(r)?!x(r,e):r!==e,P=(r,e)=>Array.isArray(r)?y(r,e,(t,n)=>t>n):r>e,S=(r,e)=>Array.isArray(r)?y(r,e,(t,n)=>t>=n):r>=e,U=(r,e)=>Array.isArray(r)?y(r,e,(t,n)=>t<n):r<e,z=(r,e)=>Array.isArray(r)?y(r,e,(t,n)=>t<=n):r<=e,B=(r,e)=>Array.isArray(e)?Array.isArray(r)?y(r,e,(t,n)=>n.includes(t)):e.includes(r):!1,G=(r,e)=>{if(!Array.isArray(e))return!1;if(Array.isArray(r)){for(let t=0;t<r.length;t++)if(e.includes(r[t]))return!1;return!0}return!e.includes(r)},H=(r,e,t)=>{const n=C(r,e);return t?n:!n},I=(r,e,t="")=>{const n=new RegExp(e,t);return Array.isArray(r)?y(r,n,(o,s)=>typeof o=="string"&&s.test(o)):n.test(r)},K=(r,e,t,n)=>{for(const[o,s]of Object.entries(n))switch(o){case"$eq":if(!b(t,s))return!1;break;case"$ne":if(!J(t,s))return!1;break;case"$gt":if(!P(t,s))return!1;break;case"$gte":if(!S(t,s))return!1;break;case"$lt":if(!U(t,s))return!1;break;case"$lte":if(!z(t,s))return!1;break;case"$in":if(!B(t,s))return!1;break;case"$nin":if(!G(t,s))return!1;break;case"$exists":if(!H(r,e,s))return!1;break;case"$regex":const c=n.$options||"";if(!I(t,s,c))return!1;break;case"$options":break;default:throw new Error(`Unsupported query operator: ${o}`)}return!0},L=(r,e)=>{for(let t=0;t<e.length;t++)if(d(r,e[t]))return!0;return!1},d=(r,e)=>{if(!e||Object.keys(e).length===0)return!0;if(e.$or&&Array.isArray(e.$or)){if(!L(r,e.$or))return!1;const t={...e};return delete t.$or,Object.keys(t).length>0?d(r,t):!0}for(const[t,n]of Object.entries(e)){const o=A(r,t);if(typeof n=="object"&&n!==null&&!Array.isArray(n)){if(!K(r,t,o,n))return!1}else if(!b(o,n))return!1}return!0},M=r=>Object.values(r).some(e=>e===1||e===!0),Q=(r,e)=>{const t={_id:r._id};for(const[n,o]of Object.entries(e))n==="_id"&&(o===0||o===!1)?delete t._id:(o===1||o===!0)&&(t[n]=r[n]);return t},T=(r,e)=>{const t={...r};for(const[n,o]of Object.entries(e))(o===0||o===!1)&&delete t[n];return t},V=(r,e)=>!e||Object.keys(e).length===0?r:M(e)?Q(r,e):T(r,e),W=(r,e)=>{if(!r)throw new Error("Database name is required");if(!e)throw new Error("Collection name is required")},$=r=>{try{return JSON.parse(r)}catch{return null}},X=(r,e,t,n,o)=>{const{field:s,operators:c}=o,a=n[s];O(e,t,s);let i=null;if(typeof a=="object"&&a!==null&&!Array.isArray(a)){for(const u of c)if(a[u]!==void 0){i=p(e,t,s,u,a[u]);break}}else c.includes("eq")&&(i=p(e,t,s,"eq",a));if(i&&i.length>0)for(const u of i){const l=m(e,t,u),_=r.get(l);if(_){const f=$(_);if(f&&d(f,n))return f}}return null},Y=(r,e,t,n)=>{const o=`${e}:${t}:`,s=r.getRange({start:o,end:o+"\xFF"});for(const{key:c,value:a}of s){const i=$(a);if(i&&d(i,n))return i}return null},Z=(r,e,t,n,o,s)=>{try{w(e,t,n,o,s)}catch(c){r.warn("Failed to record query for auto-indexing",{error:c.message})}},v=(r,e,t,n,o,s,c)=>{r.info("Document found",{database:e,collection:t,document_id:n,used_index:o,indexed_field:s,execution_time_ms:c})},rr=(r,e,t,n,o,s)=>{r.info("No document found",{database:e,collection:t,used_index:n,indexed_field:o,execution_time_ms:s})},er=async(r,e,t={},n={})=>{const o=E();W(r,e);const s=k(),{projection:c}=n,a=Date.now();try{let i=null,u=!1,l=null;const _=q(r,e,t);_&&(l=_.field,i=X(s,r,e,t,_),u=i!==null),u||(i=Y(s,r,e,t));const f=Date.now()-a;if(Z(o,e,t,f,u,l),i){const j=V(i,c);return v(o,r,e,i._id,u,l,f),j}return rr(o,r,e,u,l,f),null}catch(i){throw o.error("Failed to find document",{database:r,collection:e,error:i.message}),i}};var ir=er;export{ir as default};

package/dist/server/lib/operations/insert_one.js

@@ -1 +1 @@
-import{get_database as _,generate_document_id as a,build_collection_key as w}from"../query_engine.js";import{update_indexes_on_insert as f}from"../index_manager.js";import{get_write_queue as l}from"../write_queue.js";import g from"../logger.js";const{create_context_logger:p}=g("insert_one"),m=async(t,r,e,n={})=>{const s=p();if(!t)throw new Error("Database name is required");if(!r)throw new Error("Collection name is required");if(!e||typeof e!="object")throw new Error("Document must be a valid object");const i=_(),o=e._id||a(),u=w(t,r,o),c={...e,_id:o,_created_at:new Date().toISOString(),_updated_at:new Date().toISOString()};let d=null;return await i.transaction(()=>{if(i.get(u))throw new Error(`Document with _id ${o} already exists`);i.put(u,JSON.stringify(c)),d=c}),await f(t,r,d),s.info("Document inserted successfully",{database:t,collection:r,document_id:o}),{acknowledged:!0,inserted_id:o}},y=async(t,r,e,n={})=>{if(!t)throw new Error("Database name is required");if(!r)throw new Error("Collection name is required");if(!e||typeof e!="object")throw new Error("Document must be a valid object");return await l().enqueue_write_operation(()=>m(t,r,e,n),{operation:"insert_one",database:t,collection:r,document_id:e._id||"auto-generated"})};var x=y;export{x as default};
+import{get_database as u,generate_document_id as p,build_collection_key as m}from"../query_engine.js";import{update_indexes_on_insert as w}from"../index_manager.js";import{get_write_queue as g}from"../write_queue.js";import l from"../logger.js";const{create_context_logger:f}=l("insert_one"),x=t=>{if(!t)throw new Error("Database name is required")},h=t=>{if(!t)throw new Error("Collection name is required")},q=t=>{if(!t||typeof t!="object")throw new Error("Document must be a valid object")},_=(t,e,r)=>{x(t),h(e),q(r)},y=()=>new Date().toISOString(),v=t=>{const e=t._id||p(),r=y();return{...t,_id:e,_created_at:r,_updated_at:r}},c=(t,e,r)=>{if(t.get(e))throw new Error(`Document with _id ${r} already exists`)},D=(t,e,r)=>(c(t,e,r._id),t.transaction(()=>{c(t,e,r._id),t.put(e,JSON.stringify(r))}),r),E=(t,e,r,n)=>{t.info("Document inserted successfully",{database:e,collection:r,document_id:n})},S=t=>({acknowledged:!0,inserted_id:t}),b=(t,e,r)=>({operation:"insert_one",database:t,collection:e,document_id:r._id||"auto-generated"}),j=async(t,e,r,n={})=>{const i=f();_(t,e,r);const s=u(),o=v(r),a=m(t,e,o._id),d=D(s,a,o);return await w(t,e,d),E(i,t,e,o._id),S(o._id)},k=async(t,e,r,n={})=>{_(t,e,r);const i=g(),s=b(t,e,r);return await i.enqueue_write_operation(()=>j(t,e,r,n),s)};var N=k;export{N as default};

package/dist/server/lib/operations/update_one.js

@@ -1 +1 @@
-import{get_database as m,build_collection_key as h,generate_document_id as S}from"../query_engine.js";import{update_indexes_on_update as $,update_indexes_on_insert as v}from"../index_manager.js";import{get_write_queue as q}from"../write_queue.js";import x from"../logger.js";const{create_context_logger:E}=x("update_one"),k=(o,t)=>{const e={...o};for(const[n,s]of Object.entries(t))switch(n){case"$set":Object.assign(e,s);break;case"$unset":for(const r of Object.keys(s))delete e[r];break;case"$inc":for(const[r,i]of Object.entries(s))e[r]=(e[r]||0)+i;break;case"$push":for(const[r,i]of Object.entries(s))Array.isArray(e[r])||(e[r]=[]),e[r].push(i);break;case"$pull":for(const[r,i]of Object.entries(s))Array.isArray(e[r])&&(e[r]=e[r].filter(c=>c!==i));break;default:throw new Error(`Unsupported update operator: ${n}`)}return e},J=(o,t)=>{if(!t||Object.keys(t).length===0)return!0;for(const[e,n]of Object.entries(t))if(o[e]!==n)return!1;return!0},N=async(o,t,e,n,s={})=>{const r=E();if(!o)throw new Error("Database name is required");if(!t)throw new Error("Collection name is required");if(!e||typeof e!="object")throw new Error("Filter must be a valid object");if(!n||typeof n!="object")throw new Error("Update must be a valid object");const i=m();let c=0,f=0,l=null,_=null,w=null,p=null;await i.transaction(()=>{const y=`${o}:${t}:`;let O=!1;const j=i.getRange({start:y,end:y+"\xFF"});for(const{key:a,value:b}of j){let u;try{u=JSON.parse(b)}catch{continue}if(J(u,e)){O=!0,c=1;const d=k(u,n);d._updated_at=new Date().toISOString(),JSON.stringify(u)!==JSON.stringify(d)&&(i.put(a,JSON.stringify(d)),_=u,w=d,f=1);break}}if(!O&&s.upsert){const a=S(),b=h(o,t,a),u={...e,_id:a,_created_at:new Date().toISOString(),_updated_at:new Date().toISOString()};p=k(u,n),i.put(b,JSON.stringify(p)),l=a,c=0,f=0}}),_&&w&&await $(o,t,_,w),p&&await v(o,t,p),r.info("Update operation completed",{database:o,collection:t,matched_count:c,modified_count:f,upserted_id:l});const g={acknowledged:!0,matched_count:c,modified_count:f};return l&&(g.upserted_id=l),g},A=async(o,t,e,n,s={})=>await q().enqueue_write_operation(()=>N(o,t,e,n,s),{operation:"update_one",database:o,collection:t,filter_keys:Object.keys(e||{})});var C=A;export{C as default};
+import{get_database as O,build_collection_key as v,generate_document_id as j}from"../query_engine.js";import{update_indexes_on_update as x,update_indexes_on_insert as $}from"../index_manager.js";import{get_write_queue as S}from"../write_queue.js";import q from"../logger.js";const{create_context_logger:E}=q("update_one"),J=(e,r)=>({...e,...r}),N=(e,r)=>{const t={...e};for(const o of Object.keys(r))delete t[o];return t},A=(e,r)=>{const t={...e};for(const[o,n]of Object.entries(r))t[o]=(t[o]||0)+n;return t},F=(e,r)=>{const t={...e};for(const[o,n]of Object.entries(r))Array.isArray(t[o])||(t[o]=[]),t[o]=[...t[o],n];return t},U=(e,r)=>{const t={...e};for(const[o,n]of Object.entries(r))Array.isArray(t[o])&&(t[o]=t[o].filter(a=>a!==n));return t},w=(e,r)=>{let t={...e};for(const[o,n]of Object.entries(r))switch(o){case"$set":t=J(t,n);break;case"$unset":t=N(t,n);break;case"$inc":t=A(t,n);break;case"$push":t=F(t,n);break;case"$pull":t=U(t,n);break;default:throw new Error(`Unsupported update operator: ${o}`)}return t},D=(e,r,t)=>e[r]===t,C=(e,r)=>{if(!r||Object.keys(r).length===0)return!0;for(const[t,o]of Object.entries(r))if(!D(e,t,o))return!1;return!0},I=e=>{if(!e)throw new Error("Database name is required")},R=e=>{if(!e)throw new Error("Collection name is required")},z=e=>{if(!e||typeof e!="object")throw new Error("Filter must be a valid object")},B=e=>{if(!e||typeof e!="object")throw new Error("Update must be a valid object")},G=(e,r,t,o)=>{I(e),R(r),z(t),B(o)},H=e=>{try{return JSON.parse(e)}catch{return null}},b=()=>new Date().toISOString(),K=e=>({...e,_updated_at:b()}),L=(e,r)=>JSON.stringify(e)!==JSON.stringify(r),M=(e,r)=>{const t=j(),o=b(),n={...e,_id:t,_created_at:o,_updated_at:o};return w(n,r)},P=(e,r,t,o,n,a)=>{let c=0,u=0,d=null,i=null,_=null,s=null;const l=`${r}:${t}:`;let f=!1;const g=e.getRange({start:l,end:l+"\xFF"});for(const{key:m,value:h}of g){const p=H(h);if(p&&C(p,o)){f=!0,c=1;const k=w(p,n),y=K(k);L(p,y)&&(e.put(m,JSON.stringify(y)),i=p,_=y,u=1);break}}if(!f&&a.upsert){s=M(o,n);const m=v(r,t,s._id);e.put(m,JSON.stringify(s)),d=s._id,c=0,u=0}return{matched_count:c,modified_count:u,upserted_id:d,old_document:i,new_document:_,upserted_document:s}},Q=async(e,r,t,o)=>{t&&o&&await x(e,r,t,o)},T=async(e,r,t)=>{t&&await $(e,r,t)},V=(e,r,t,o,n,a)=>{e.info("Update operation completed",{database:r,collection:t,matched_count:o,modified_count:n,upserted_id:a})},W=(e,r,t)=>{const o={acknowledged:!0,matched_count:e,modified_count:r};return t&&(o.upserted_id=t),o},X=(e,r,t)=>({operation:"update_one",database:e,collection:r,filter_keys:Object.keys(t||{})}),Y=async(e,r,t,o,n={})=>{const a=E();G(e,r,t,o);const c=O(),u=await c.transaction(()=>P(c,e,r,t,o,n)),{matched_count:d,modified_count:i,upserted_id:_,old_document:s,new_document:l,upserted_document:f}=u;return await Q(e,r,s,l),await T(e,r,f),V(a,e,r,d,i,_),W(d,i,_)},Z=async(e,r,t,o,n={})=>{const a=S(),c=X(e,r,t);return await a.enqueue_write_operation(()=>Y(e,r,t,o,n),c)};var nt=Z;export{nt as default};

package/dist/server/lib/send_response.js

@@ -1 +1 @@
-import{encode_message as r}from"./tcp_protocol.js";const t=(e,s={})=>{const o=r({ok:!0,data:s});e.write(o)},p=(e,s={})=>{const o=r({ok:!1,error:s});e.write(o)},d=(e,s="")=>{t(e,{message:s})};export{p as send_error,d as send_message,t as send_success};
+import{encode_message as n}from"./tcp_protocol.js";const t=e=>({ok:!0,data:e}),c=e=>({ok:!1,error:e}),r=(e,s)=>{const o=n(s);e.write(o)},_=(e,s={})=>{const o=t(s);r(e,o)},d=(e,s={})=>{const o=c(s);r(e,o)},a=(e,s="")=>{_(e,{message:s})};export{d as send_error,a as send_message,_ as send_success};

package/dist/server/lib/tcp_protocol.js

@@ -1 +1 @@
-import{encode as d,decode as m}from"msgpackr";import u from"./logger.js";const{create_context_logger:l}=u("tcp_protocol"),f=e=>{const s=l();try{const t=d(e,{useFloat32:!1,int64AsType:"number",mapsAsObjects:!0}),o=Buffer.allocUnsafe(4);o.writeUInt32BE(t.length,0);const c=Buffer.concat([o,t]);return s.debug("Message encoded",{payload_size:t.length,total_size:c.length}),c}catch(t){throw s.error("Failed to encode message",{error:t.message}),t}},i=()=>{let e=Buffer.alloc(0),s=null;const t=l();return{parse_messages:g=>{e=Buffer.concat([e,g]);const n=[];for(;e.length>0;){if(s===null){if(e.length<4)break;s=e.readUInt32BE(0),e=e.slice(4),t.debug("Length prefix read",{expected_length:s})}if(e.length<s)break;const r=e.slice(0,s);e=e.slice(s),s=null;try{const a=m(r,{useFloat32:!1,int64AsType:"number",mapsAsObjects:!0});n.push(a),t.debug("Message decoded",{message_size:r.length})}catch(a){throw t.error("Failed to decode message",{message_size:r.length,error:a.message,hex_data:r.toString("hex")}),new Error(`Invalid message format: ${a.message}`)}}return n},reset:()=>{e=Buffer.alloc(0),s=null,t.debug("Parser reset")}}};export{i as create_message_parser,f as encode_message};
+import{encode as d,decode as m}from"msgpackr";import i from"./logger.js";const{create_context_logger:l}=i("tcp_protocol"),_=()=>({useFloat32:!1,int64AsType:"number",mapsAsObjects:!0}),u=e=>{const s=Buffer.allocUnsafe(4);return s.writeUInt32BE(e,0),s},f=(e,s,t)=>{e.debug("Message encoded",{payload_size:s,total_size:t})},h=(e,s)=>{e.error("Failed to encode message",{error:s.message})},p=e=>{const s=l();try{const t=d(e,_()),r=u(t.length),o=Buffer.concat([r,t]);return f(s,t.length,o.length),o}catch(t){throw h(s,t),t}},b=e=>{if(e.length<4)return{expected_length:null,remaining_buffer:e};const s=e.readUInt32BE(0),t=e.slice(4);return{expected_length:s,remaining_buffer:t}},x=(e,s)=>{e.debug("Length prefix read",{expected_length:s})},B=(e,s)=>{const t=e.slice(0,s),r=e.slice(s);return{message_data:t,remaining_buffer:r}},k=e=>m(e,_()),w=(e,s)=>{e.debug("Message decoded",{message_size:s})},y=(e,s,t)=>{e.error("Failed to decode message",{message_size:s.length,error:t.message,hex_data:s.toString("hex")})},E=(e,s,t)=>{const{message_data:r,remaining_buffer:o}=B(e,s);try{const n=k(r);return w(t,r.length),{decoded_message:n,remaining_buffer:o}}catch(n){throw y(t,r,n),new Error(`Invalid message format: ${n.message}`)}},F=e=>{e.debug("Parser reset")},I=()=>{let e=Buffer.alloc(0),s=null;const t=l();return{parse_messages:n=>{e=Buffer.concat([e,n]);const a=[];for(;e.length>0;){if(s===null){const g=b(e);if(s=g.expected_length,e=g.remaining_buffer,s===null)break;x(t,s)}if(e.length<s)break;const c=E(e,s,t);a.push(c.decoded_message),e=c.remaining_buffer,s=null}return a},reset:()=>{e=Buffer.alloc(0),s=null,F(t)}}};export{I as create_message_parser,p as encode_message};

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@joystick.js/db-canary",
   "type": "module",
-  "version": "0.0.0-canary.2250",
-  "canary_version": "0.0.0-canary.2249",
+  "version": "0.0.0-canary.2252",
+  "canary_version": "0.0.0-canary.2251",
   "description": "JoystickDB - A minimalist database server for the Joystick framework",
   "main": "./dist/server/index.js",
   "scripts": {

package/src/client/database.js

@@ -1,165 +1,138 @@
+/**
+ * Creates admin request data for database operations.
+ * @param {string} admin_action - The admin action to perform
+ * @param {string} database_name - Name of the database
+ * @param {Object} additional_data - Additional data for the request
+ * @returns {Object} Admin request data object
+ */
+const create_admin_request_data = (admin_action, database_name, additional_data = {}) => ({
+  admin_action,
+  database: database_name,
+  ...additional_data
+});
+
+/**
+ * Creates admin request data for collection operations.
+ * @param {string} admin_action - The admin action to perform
+ * @param {string} database_name - Name of the database
+ * @param {string} collection_name - Name of the collection
+ * @param {Object} additional_data - Additional data for the request
+ * @returns {Object} Admin request data object
+ */
+const create_collection_admin_request_data = (admin_action, database_name, collection_name, additional_data = {}) => ({
+  admin_action,
+  database: database_name,
+  collection: collection_name,
+  ...additional_data
+});
+
+/**
+ * Sends admin request through client.
+ * @param {Object} client - The client instance
+ * @param {Object} request_data - Request data to send
+ * @returns {Promise<Object>} Admin operation result
+ */
+const send_admin_request = async (client, request_data) => {
+  return client.send_request('admin', request_data);
+};
+
 /**
  * Database interface for method chaining operations.
  * Provides a fluent API for database-level operations and collection access.
  */
 class Database {
-  /**
-   * Creates a new Database instance.
-   * @param {JoystickDBClient} client - The client instance
-   * @param {string} database_name - Name of the database
-   */
   constructor(client, database_name) {
     this.client = client;
     this.database_name = database_name;
   }
   
-  /**
-   * Returns a collection interface for method chaining operations.
-   * @param {string} collection_name - Collection name
-   * @returns {Collection} Collection interface instance
-   */
   collection(collection_name) {
-    // NOTE: Import Collection class dynamically to avoid circular dependency.
     const Collection = this.client.constructor.Collection;
     return new Collection(this.client, this.database_name, collection_name);
   }
   
-  /**
-   * Lists all collections in the database.
-   * @returns {Promise<Object>} Collections list
-   */
   async list_collections() {
-    return this.client.send_request('admin', { 
-      admin_action: 'list_collections',
-      database: this.database_name
-    });
+    const request_data = create_admin_request_data('list_collections', this.database_name);
+    return send_admin_request(this.client, request_data);
   }
   
-  /**
-   * Gets database-specific statistics.
-   * @returns {Promise<Object>} Database statistics
-   */
   async get_stats() {
-    return this.client.send_request('admin', { 
-      admin_action: 'get_database_stats',
-      database: this.database_name
-    });
+    const request_data = create_admin_request_data('get_database_stats', this.database_name);
+    return send_admin_request(this.client, request_data);
   }
   
-  /**
-   * Drops the entire database (admin operation).
-   * @returns {Promise<Object>} Drop database result
-   */
   async drop_database() {
-    return this.client.send_request('admin', { 
-      admin_action: 'drop_database',
-      database: this.database_name
-    });
+    const request_data = create_admin_request_data('drop_database', this.database_name);
+    return send_admin_request(this.client, request_data);
   }
   
-  /**
-   * Explicitly creates a collection in the database.
-   * @param {string} collection_name - Name of collection to create
-   * @param {Object} [options={}] - Collection creation options
-   * @returns {Promise<Object>} Create collection result
-   */
   async create_collection(collection_name, options = {}) {
-    return this.client.send_request('admin', { 
-      admin_action: 'create_collection',
-      database: this.database_name,
-      collection: collection_name,
-      options
-    });
+    const request_data = create_collection_admin_request_data(
+      'create_collection', 
+      this.database_name, 
+      collection_name, 
+      { options }
+    );
+    return send_admin_request(this.client, request_data);
   }
   
-  /**
-   * Lists all documents in a collection (admin operation).
-   * @param {string} collection_name - Name of collection
-   * @returns {Promise<Object>} List documents result
-   */
   async list_documents(collection_name) {
-    return this.client.send_request('admin', { 
-      admin_action: 'list_documents',
-      database: this.database_name,
-      collection: collection_name
-    });
+    const request_data = create_collection_admin_request_data(
+      'list_documents', 
+      this.database_name, 
+      collection_name
+    );
+    return send_admin_request(this.client, request_data);
   }
   
-  /**
-   * Gets a specific document by ID (admin operation).
-   * @param {string} collection_name - Name of collection
-   * @param {string} document_id - Document ID
-   * @returns {Promise<Object>} Get document result
-   */
   async get_document(collection_name, document_id) {
-    return this.client.send_request('admin', { 
-      admin_action: 'get_document',
-      database: this.database_name,
-      collection: collection_name,
-      document_id
-    });
+    const request_data = create_collection_admin_request_data(
+      'get_document', 
+      this.database_name, 
+      collection_name, 
+      { document_id }
+    );
+    return send_admin_request(this.client, request_data);
   }
   
-  /**
-   * Queries documents in a collection (admin operation).
-   * @param {string} collection_name - Name of collection
-   * @param {Object} filter - Query filter
-   * @returns {Promise<Object>} Query documents result
-   */
   async query_documents(collection_name, filter) {
-    return this.client.send_request('admin', { 
-      admin_action: 'query_documents',
-      database: this.database_name,
-      collection: collection_name,
-      filter
-    });
+    const request_data = create_collection_admin_request_data(
+      'query_documents', 
+      this.database_name, 
+      collection_name, 
+      { filter }
+    );
+    return send_admin_request(this.client, request_data);
   }
   
-  /**
-   * Inserts a document into a collection (admin operation).
-   * @param {string} collection_name - Name of collection
-   * @param {Object} document - Document to insert
-   * @returns {Promise<Object>} Insert document result
-   */
   async insert_document(collection_name, document) {
-    return this.client.send_request('admin', { 
-      admin_action: 'insert_document',
-      database: this.database_name,
-      collection: collection_name,
-      document
-    });
+    const request_data = create_collection_admin_request_data(
+      'insert_document', 
+      this.database_name, 
+      collection_name, 
+      { document }
+    );
+    return send_admin_request(this.client, request_data);
   }
   
-  /**
-   * Updates a document in a collection (admin operation).
-   * @param {string} collection_name - Name of collection
-   * @param {string} document_id - Document ID
-   * @param {Object} update - Update operations
-   * @returns {Promise<Object>} Update document result
-   */
   async update_document(collection_name, document_id, update) {
-    return this.client.send_request('admin', { 
-      admin_action: 'update_document',
-      database: this.database_name,
-      collection: collection_name,
-      document_id,
-      update
-    });
+    const request_data = create_collection_admin_request_data(
+      'update_document', 
+      this.database_name, 
+      collection_name, 
+      { document_id, update }
+    );
+    return send_admin_request(this.client, request_data);
   }
   
-  /**
-   * Deletes a document from a collection (admin operation).
-   * @param {string} collection_name - Name of collection
-   * @param {string} document_id - Document ID
-   * @returns {Promise<Object>} Delete document result
-   */
   async delete_document(collection_name, document_id) {
-    return this.client.send_request('admin', { 
-      admin_action: 'delete_document',
-      database: this.database_name,
-      collection: collection_name,
-      document_id
-    });
+    const request_data = create_collection_admin_request_data(
+      'delete_document', 
+      this.database_name, 
+      collection_name, 
+      { document_id }
+    );
+    return send_admin_request(this.client, request_data);
   }
 }