@asaidimu/hestia 1.0.0 → 1.0.2

package/index.mjs

@@ -0,0 +1,8 @@
+import{createNetworkClient as e}from"@asaidimu/network-client";import{Errors as t,SystemError as n}from"@asaidimu/utils-error";import{DELETE_SYMBOL as r,ReactiveDataStore as i}from"@asaidimu/utils-store";import{Debouncer as a}from"@asaidimu/utils-sync";import{createMatcher as o,createSorter as s}from"@asaidimu/query";async function c(e){try{return(await e.clone().json())?.error??null}catch{return null}}function l(e,t){if(t)return new n({code:t.code??`UNKNOWN`,message:t.message??`Unknown error`,issues:t.details?.issues});let r=e.error?.message;if(typeof r==`object`&&r){let e=r;return new n({code:e.code??`UNKNOWN`,message:e.message??`Unknown error`})}return new n({code:`UNKNOWN`,message:r??`Unknown error`})}function u(e){return t.notFound(e)}function d(e){return t.permissionDenied(e)}function f(e){return t.internalError(e)}var p=class{data;status;constructor(e,t){this.data=e,this.status=t}},m=class{baseUrl;apiPrefix;tokens;onAuthStateChanged;raw;refreshing=null;refreshFailed=!1;constructor(t,n,r,i){this.baseUrl=t,this.apiPrefix=n,this.tokens=r,this.onAuthStateChanged=i,this.raw=e({baseUrl:t,defaultResponseType:`json`,defaultBodyType:`json`,interceptors:{request:[e=>{let t=this.tokens.token(`access`);return t&&(e.headers.Authorization=`Bearer ${t}`),e}]}})}base(){return this.baseUrl}prefix(){return this.apiPrefix}canonicalPath(e){let t=e.replace(/^\/+/,``);if(this.apiPrefix){let e=this.apiPrefix.replace(/^\/+/,``),n=RegExp(`^${e}/?`);return t=t.replace(n,``),`${e}/${t}`}return t}async storeTokens(e,t){this.refreshFailed=!1,await this.tokens.setTokens(e,t??``)}async refreshToken(){if(this.refreshing)return this.refreshing;this.refreshing=this.doRefresh();try{await this.refreshing}finally{this.refreshing=null,this.onAuthStateChanged&&this.onAuthStateChanged()}}async doRefresh(){let e=this.tokens.token(`refresh`),t=e?{refresh_token:e}:{},r=await this.raw.patch(this.canonicalPath(`/system/auth/session`),t);if(!r.success||!r.data)throw this.tokens.clear(),this.refreshFailed=!0,new n({code:`AUTH-002-UNAUTH`,message:`Token refresh failed`});let{access:i,refresh:a}=r.data.data.token;this.refreshFailed=!1,await this.tokens.setTokens(i,a)}async request(e,t,r,i){let a=this.canonicalPath(t),o={};i?.headers&&(o.headers=i.headers),i?.responseType&&(o.responseType=i.responseType),i?.bodyType&&(o.bodyType=i.bodyType),i?.signal&&(o.signal=i.signal);let s;if(e===`GET`)s=await this.raw.get(a,o);else{let t=i?.bodyType?{type:i.bodyType}:void 0;s=await this.raw[e.toLowerCase()](a,r,o,t)}if(s.success||s.status===204)return new p(s.data,s.status);if((s.status===401||s.status===403)&&!t.includes(`/system/auth/token`)&&!t.includes(`/system/auth/session`)){if(i?.headers?.[`X-API-Key`])throw new n({code:`AUTH-003-APIKEY`,message:`API key is invalid or expired`});if(this.refreshFailed)throw this.tokens.clear(),this.onAuthStateChanged?.(),new n({code:`AUTH-002-UNAUTH`,message:`Session expired`});try{await this.refreshToken()}catch{throw this.tokens.clear(),this.onAuthStateChanged?.(),new n({code:`AUTH-002-UNAUTH`,message:`Session expired`})}let t=this.tokens.token(`access`),c={...o};if(t&&(c.headers={...o.headers??{},Authorization:`Bearer ${t}`}),e===`GET`)s=await this.raw.get(a,c);else{let t=i?.bodyType?{type:i.bodyType}:void 0;s=await this.raw[e.toLowerCase()](a,r,c,t)}if(s.success||s.status===204)return new p(s.data,s.status)}let u=s.raw?await c(s.raw):null;throw l(s,u)}async get(e,t){return this.request(`GET`,e,void 0,t)}async post(e,t,n){return this.request(`POST`,e,t,n)}async patch(e,t,n){return this.request(`PATCH`,e,t,n)}async put(e,t,n){return this.request(`PUT`,e,t,n)}async delete(e,t,n){return this.request(`DELETE`,e,t,n)}async openStream(e,t,r){let i=async a=>{let o=this.tokens.token(`access`),s=!!r?.headers?.[`X-API-Key`],c={Accept:`text/event-stream`,...o&&!s?{Authorization:`Bearer ${o}`}:{},...r?.headers??{}},l=`${this.baseUrl.replace(/\/+$/,``)}/${this.canonicalPath(e)}`,u;try{u=await fetch(l,{method:`GET`,headers:c,signal:r?.signal})}catch(e){if(e instanceof Error&&e.name===`AbortError`){t.onClose?.();return}t.onError?.(e instanceof Error?e:Error(String(e)));return}if(u.status===401&&!a&&!s){try{await this.refreshToken()}catch{this.tokens.clear(),this.onAuthStateChanged?.(),t.onError?.(new n({code:`AUTH-002-UNAUTH`,message:`Session expired`}));return}return i(!0)}if(!u.ok||!u.body){t.onError?.(Error(`Stream request failed with status ${u.status}`));return}t.onOpen?.();let d=u.body.getReader(),f=new TextDecoder,p=``;try{for(;;){let{done:e,value:n}=await d.read();if(e)break;p+=f.decode(n,{stream:!0});let r=p.indexOf(`
+
+`);for(;r!==-1;){let e=p.slice(0,r);p=p.slice(r+2);let n=e.split(`
+`).filter(e=>e.startsWith(`data:`)).map(e=>e.slice(5).trim());n.length>0&&t.onMessage(n.join(`
+`)),r=p.indexOf(`
+
+`)}}}catch(e){e instanceof Error&&e.name===`AbortError`||t.onError?.(e instanceof Error?e:Error(String(e)))}finally{t.onClose?.()}};return i(!1)}};const h={data:[],loading:!0,page:{number:1,size:20,count:0,total:0,pages:1}};function g(e,t,n,i){let o=n.page??1,s=n.size??20,c=n.sort,l=n.filter,u=new a({delay:50}),d=`${e}_pager_state_`;t.set({[d]:{data:[],loading:!1,error:r,page:{number:1,size:20,count:0,total:0,pages:1}}});let f=e=>{let t=e?.page??o,n=e?.size??s,r={pagination:{type:`offset`,offset:(t-1)*n,limit:n}},i=e?.sort??c;i&&(r.sort=Array.isArray(i)?i:[i]);let a=e?.filter??l;return a&&(r.filters=a),r},p=async e=>(await t.set({[d]:{loading:!0,error:r}}),await new Promise(n=>{n(u.do(async()=>{requestIdleCallback(()=>{requestIdleCallback(async()=>{try{let n=await i(f(e));await t.set({[d]:n})}catch(e){await t.set({[d]:{...h,error:e}})}finally{await t.set({[d]:{loading:!1}})}})})}))})),m=t.select(e=>e[d]),g=m.subscribe(()=>{});return{page:()=>m.get()??h,navigate:async e=>{if(e<1)throw Error(`Page number must be >= 1`);o=e,await p({page:e})},resize:async(e,t)=>{if(e<1)throw Error(`Page size must be >= 1`);s=e,o=t,await p()},sort:async e=>{c=Array.isArray(e)?e:[e],o=1,await p()},filter:async e=>{l=e,o=1,await p()},refresh:async e=>{await Promise.all([new Promise(t=>setTimeout(t,e?.delay||0)),p(e)])},subscribe:e=>m.subscribe(e),invalidate:async()=>{await t.set({[d]:r}),g()},id:()=>d}}var _=class{client;collectionName;defaultLimit;pagerOptions={};pager;constructor(e,t,n=50){this.client=e,this.collectionName=t,this.defaultLimit=n,this.pager=g(t,new i({}),this.pagerOptions,e=>this.find(e))}name(){return this.collectionName}get queryPath(){return`/system/collections/document/${encodeURIComponent(this.collectionName)}/query`}get documentsPath(){return`/system/collections/document/${encodeURIComponent(this.collectionName)}`}documentPath(e){return`${this.documentsPath}/${encodeURIComponent(e)}`}async find(e){let t=await this.client.post(this.queryPath,e??{}),n=t.data?.data??[];return{data:n,loading:!1,page:t.data?.metadata?.page??{number:1,size:n.length,count:n.length,total:n.length,pages:1},error:null}}async read(e){try{return(await this.client.get(this.documentPath(e))).data?.data}catch(e){if(e?.code===`SYNC-001-NF`||e?.code===`NOT_FOUND`)return;throw e}}async create(e){return(await this.client.post(this.documentsPath,e.data)).data.data}async update(e){let t=e.options;return(await this.client.patch(this.documentPath(t),e.data)).data.data}async delete(e){await this.client.delete(this.documentPath(e))}async list(e){return this.find(e??{pagination:{type:`offset`,offset:0,limit:this.defaultLimit}})}async upload(e){throw Error(`Upload not supported for collections`)}async subscribe(e,t){throw Error(`Subscription not implemented for dynamic collections`)}async notify(e){throw Error(`Notify not implemented for dynamic collections`)}stream(e,t){throw Error(`Stream not supported for collections`)}page(e){return this.pager}},v=class{client;provider;constructor(e,t){this.client=e,this.provider=t}async health(){return(await this.client.get(`/system/core/health`)).data.data}async login(e,t){let n=(await this.client.post(`/system/auth/session`,{email:e,password:t})).data.data;return this.provider.setIdentity(n.user),this.client.storeTokens(n.token.access,n.token.refresh),n}async register(e,t,n){return(await this.client.post(`/system/auth/user`,{email:e,password:t,name:n})).data.data}async refresh(e){let t=e?{refresh_token:e}:{};return(await this.client.patch(`/system/auth/session`,t)).data.data.token}async logout(){let e=this.provider.token(`refresh`),t=e?{refresh_token:e}:{};await this.client.delete(`/system/auth/session`,t),await this.provider.clear()}async requestPasswordReset(e){await this.client.post(`/system/auth/password`,{email:e})}async confirmPasswordReset(e,t){await this.client.patch(`/system/auth/password`,{password:t,token:e},{headers:{Authorization:`Bearer ${e}`}})}async bootstrap(e,t,n){await this.client.patch(`/system/auth/bootstrap`,{password:t,email:n},{headers:{"X-API-Key":e}})}},y=class{client;pagerOptions={};pager;constructor(e){this.client=e,this.pager=g(`users`,new i({}),this.pagerOptions,e=>this.find(e))}name(){return`users`}async find(e){let t=await this.client.post(`/system/users/user/query`,e??{}),n=t.data?.data??[];return{data:n,loading:!1,page:t.data?.metadata?.page??{number:1,size:n.length,count:n.length,total:n.length,pages:1}}}async list(e){return this.find(e??{pagination:{type:`offset`,offset:0,limit:50}})}async read(e){try{return(await this.client.get(`/system/users/user/${encodeURIComponent(e)}`)).data?.data}catch(e){if(e?.code===`SYNC-001-NF`)return;throw e}}async update(e){let t=e.options;return(await this.client.patch(`/system/users/user/${encodeURIComponent(t)}`,e.data)).data.data}async delete(e){await this.client.delete(`/system/users/user/${encodeURIComponent(e)}`)}async create(e){throw Error(`User creation requires email/password/name, use register endpoint`)}async upload(e){throw Error(`Upload not supported for users`)}async subscribe(e,t){throw Error(`Subscription not supported for users`)}async notify(e){throw Error(`Notify not supported for users`)}stream(e,t){throw Error(`Stream not supported for users`)}page(e){return this.pager}async changePassword(e,t,n){await this.client.patch(`/system/users/password/${encodeURIComponent(e)}`,{current:t,new:n})}},b=class{client;pager;constructor(e){this.client=e,this.pager=g(`_api_key_`,new i({}),{},e=>this.find(e))}basePath=`/system/apikeys/key`;async find(e){let t=await this.client.get(this.basePath),n=t.data?.data??[];return{data:n,loading:!1,page:t.data?.metadata?.page??{number:1,size:n.length,count:n.length,total:n.length,pages:1}}}async list(e){return e?this.find(e):this.find()}async read(e){try{return(await this.client.get(`${this.basePath}/${encodeURIComponent(e)}`)).data?.data}catch(e){if(e?.code===`SYNC-001-NF`||e?.code===`INTERNAL_ERROR`&&typeof e?.message==`string`&&e.message.includes(`not found`))return;throw e}}async create(e){return(await this.client.post(this.basePath,e.data)).data.data}async update(e){let t=e.options;return(await this.client.patch(`${this.basePath}/${encodeURIComponent(t)}`,e.data)).data.data}async delete(e){await this.client.delete(`${this.basePath}/${encodeURIComponent(e)}`)}async upload(e){throw Error(`Upload not supported for API keys`)}async subscribe(e,t){throw Error(`Subscription not supported for API keys`)}async notify(e){throw Error(`Notify not supported for API keys`)}stream(e,t){throw Error(`Stream not supported for API keys`)}page(e){return this.pager}async rotate(e){return(await this.client.post(`${this.basePath}/${encodeURIComponent(e)}`)).data.data}},x=class{client;pager;operationsPath=`/system/policies/operation`;rulesPath=`/system/policies/rule`;constructor(e){this.client=e,this.pager=g(`policies`,new i({}),{},e=>this.find(e))}async collectionQuery(e,t){let n=await this.client.post(`/system/collections/document/${encodeURIComponent(e)}/query`,t??{}),r=n.data?.data??[];return{data:r,loading:!1,page:n.data?.metadata?.page??{number:1,size:r.length,count:r.length,total:r.length,pages:1},error:null}}async find(e){return this.collectionQuery(`_operation_policy_`,e)}async list(e){return this.find(e??{pagination:{type:`offset`,offset:0,limit:50}})}async read(e){try{return(await this.client.get(`${this.operationsPath}/${encodeURIComponent(e)}`)).data?.data}catch(e){if(e?.code===`SYNC-001-NF`||e?.code===`NOT_FOUND`||e?.code===`INTERNAL_ERROR`&&typeof e?.message==`string`&&e.message.includes(`not found`))return;throw e}}async create(e){let t=e.data.name;if(!t)throw Error(`Operation name is required for create`);return(await this.client.patch(`${this.operationsPath}/${encodeURIComponent(t)}`,e.data)).data.data}async update(e){let t=e.options;if(!t)throw Error(`Operation name is required for update`);return(await this.client.patch(`${this.operationsPath}/${encodeURIComponent(t)}`,e.data)).data.data}async delete(e){await this.client.delete(`${this.operationsPath}/${encodeURIComponent(e)}`)}async upsertOperation(e,t){return(await this.client.patch(`${this.operationsPath}/${encodeURIComponent(e)}`,t)).data.data}async getRule(e){try{return(await this.client.get(`${this.rulesPath}/${encodeURIComponent(e)}`)).data?.data}catch(e){if(e?.code===`SYNC-001-NF`||e?.code===`NOT_FOUND`||e?.code===`INTERNAL_ERROR`&&typeof e?.message==`string`&&e.message.includes(`not found`))return;throw e}}async upsertRule(e,t){return(await this.client.patch(`${this.rulesPath}/${encodeURIComponent(e)}`,t)).data.data}async deleteRule(e){await this.client.delete(`${this.rulesPath}/${encodeURIComponent(e)}`)}async listRules(e){return this.collectionQuery(`_iam_rule_`,e)}async validateRule(e){return(await this.client.post(`${this.rulesPath}/validate`,{expression:e})).data?.data?.valid??!1}async reload(){return(await this.client.get(`${this.rulesPath}/reload`)).data.data}async upload(e){throw Error(`Upload not supported for policies`)}async subscribe(e,t){throw Error(`Subscription not supported for policies`)}async notify(e){throw Error(`Notify not supported for policies`)}stream(e,t){throw Error(`Stream not supported for policies`)}page(e){return this.pager}},S=class{client;baseUrl;pagerOptions={};pager;apiPrefix;constructor(e,t,n=`/api`){this.client=e,this.baseUrl=t,this.apiPrefix=n,this.pager=g(`_audit_log_`,new i({}),this.pagerOptions,e=>this.find(e))}async find(e){let t=await this.client.post(`/system/audit/log/query`,e??{}),n=t.data?.data??[];return{data:n,loading:!1,page:t.data?.metadata?.page??{number:1,size:n.length,count:n.length,total:n.length,pages:1},error:null}}async list(e){return this.find(e??{pagination:{type:`offset`,offset:0,limit:50}})}async read(e){throw Error(`Read by ID not supported for audit logs; use find with filters`)}async create(e){throw Error(`Audit logs are write-only; entries are created by the system`)}async update(e){throw Error(`Audit logs are append-only; updates are not allowed`)}async delete(e){throw Error(`Audit logs are append-only; deletion is not allowed`)}async upload(e){throw Error(`Upload not supported for audit logs`)}async subscribe(e,t){throw Error(`Use stream() for real-time audit log entries`)}async notify(e){throw Error(`Notify not supported for audit logs`)}stream(e,t){let n=this.getStreamUrl(),r=null,i=`active`,a=null,o=async function*(){let e=[];r=new EventSource(n,{withCredentials:!0}),r.onmessage=t=>{for(let n of t.data.split(`
+`)){let t=n.trim();if(t)try{let n=JSON.parse(t);n?.data&&e.push(n.data)}catch{}}e.length>0&&a&&(a(),a=null)},r.onerror=()=>{i===`active`&&(i=`completed`),a&&=(a(),null)};try{for(;i===`active`;)e.length>0?yield e.shift():await new Promise(t=>{a=t,e.length>0&&(t(),a=null)})}finally{r?.close(),a&&=(a(),null),i===`active`&&(i=`completed`)}};return{stream:()=>o(),cancel:()=>{i===`active`&&(i=`cancelled`,r?.close())},status:()=>i}}page(e){return this.pager}getStreamUrl(){return`${this.baseUrl}${this.apiPrefix}/system/audit/log/stream`}};function C(e){return{_id_:e.key,_metadata_:{checksum:``,created:e.created_at,updated:e.updated_at??e.created_at,version:1},...e}}function w(e){return{number:1,size:e.length,count:e.length,total:e.length,pages:1}}var T=class{client;ns;pagerOptions={};pager;prefixFilter=``;constructor(e,t){this.client=e,this.ns=t,this.pager=g(`blobs_${t}`,new i({}),this.pagerOptions,e=>this.find(e))}name(){return this.ns}setPrefix(e){this.prefixFilter=e}basePath(){return`/system/blobs/blob/${encodeURIComponent(this.ns)}`}async find(e){let t=this.prefixFilter||e?.prefix||``,n=e?.limit??e?.pagination?.limit??0,r={};t&&(r.prefix=t),n&&(r.limit=n);let i=(await this.client.post(`${this.basePath()}/query`,r)).data?.data?.blobs??[];return{data:i.map(C),loading:!1,page:w(i),error:void 0}}async read(e){try{let t=await this.client.get(`${this.basePath()}/${encodeURIComponent(e)}`);return t.data?.data?C(t.data.data):void 0}catch(e){if(e?.code===`SYNC-001-NF`||e?.code===`INTERNAL_ERROR`&&typeof e?.message==`string`&&e.message.includes(`not found`))return;throw e}}async create(e){throw Error(`Use upload() to create blobs`)}async update(e){let t=e.options?.key;if(!t)throw Error(`options.key is required for blob update`);return C((await this.client.patch(`${this.basePath()}/${encodeURIComponent(t)}`,{custom:e.data})).data.data)}async delete(e){await this.client.delete(`${this.basePath()}/${encodeURIComponent(e)}`)}async list(e){return this.find(e??{})}async upload(e){let t=e.options?.key;if(!t)throw Error(`options.key is required for blob upload`);let n={},r=e.options?.contentType||e.file.type;return r&&(n[`Content-Type`]=r),C((await this.client.post(`${this.basePath()}/${encodeURIComponent(t)}`,e.file,{headers:n,bodyType:`blob`})).data.data)}async subscribe(e,t){throw Error(`Subscription not supported for blobs`)}async notify(e){throw Error(`Notify not supported for blobs`)}stream(e,t){throw Error(`Stream not supported for blobs`)}page(e){return this.pager}async download(e){let t=(await this.client.get(`${this.basePath()}/${encodeURIComponent(e)}`,{responseType:`blob`})).data;return{data:t,contentType:t.type}}},E=class{client;apiPrefix;constructor(e,t=`/api`){this.client=e,this.apiPrefix=t}nsBase=`/system/blobs`;async namespaces(){return(await this.client.post(`${this.nsBase}/namespace/query`)).data?.data?.namespaces??[]}async createNamespace(e){return(await this.client.post(`${this.nsBase}/namespace`,e)).data.data}async deleteNamespace(e){await this.client.delete(`${this.nsBase}/namespace/${encodeURIComponent(e)}`)}blob(e,t){return`${this.client.base()}${this.apiPrefix}${this.nsBase}/blob/${encodeURIComponent(e)}/${encodeURIComponent(t)}`}namespace(e){return new T(this.client,e)}},D=class{client;constructor(e){this.client=e}async find(e){let t=((await this.client.get(`/system/collections/collection`)).data?.data??[]).map(e=>({_id_:e.name,_metadata_:{checksum:``,created:e.created,updated:e.updated,version:1},name:e.name,schema:e.schema,created:e.created,updated:e.updated}));return{data:t,loading:!1,page:{number:1,size:t.length,count:t.length,total:t.length,pages:1}}}async read(e){try{let t=await this.client.get(`/system/collections/collection/${encodeURIComponent(e)}`);if(!t.data)return;let n=t.data.data;return{_id_:n.name,_metadata_:{checksum:``,created:n.created,updated:n.updated,version:1},name:n.name,schema:n.schema,created:n.created,updated:n.updated}}catch(e){if(e?.code===`SYNC-001-NF`)return;throw e}}async create(e){return(await this.client.post(`/system/collections/collection`,e.data)).data.data}async update(e){throw Error(`Collection update not implemented`)}async delete(e){await this.client.delete(`/system/collections/collection/${encodeURIComponent(e)}`)}async list(e){return this.find()}async upload(e){throw Error(`Upload not supported for collections`)}async subscribe(e,t){throw Error(`Subscription not supported for collections`)}async notify(e){throw Error(`Notify not supported for collections`)}stream(e,t){throw Error(`Stream not supported for collections`)}page(e){throw Error(`Pagination not supported for collection metadata; use documents(name)`)}documents(e){return new _(this.client,e)}},O=class{client;constructor(e){this.client=e}async find(e){let t=(await this.client.get(`/system/core/docs`)).data?.data??[];return{data:t,loading:!1,page:{number:1,size:t.length,count:t.length,total:t.length,pages:1}}}async read(e){throw Error(`Read by ID not supported for capabilities; use find()`)}async create(e){throw Error(`Capabilities are read-only`)}async update(e){throw Error(`Capabilities are read-only`)}async delete(e){throw Error(`Capabilities are read-only`)}async list(e){return this.find()}async upload(e){throw Error(`Upload not supported for capabilities`)}async subscribe(e,t){throw Error(`Subscription not supported for capabilities`)}async notify(e){throw Error(`Notify not supported for capabilities`)}stream(e,t){throw Error(`Stream not supported for capabilities`)}page(e){throw Error(`Pagination not supported for capabilities`)}},k=class{store;client;auth;users;keys;policies;logs;collections;blobs;capabilities;tokenProvider;onAuthStateChanged;constructor(e){this.store=new i({access:null,refresh:null,identity:null},e.persistence);let t={identity:()=>this.store.get().identity,token:e=>this.store.get()[e],setTokens:async(e,t)=>void await this.store.set({access:e,refresh:t}),setIdentity:async e=>void await this.store.set({identity:e}),clear:async()=>void await this.store.set({access:null,refresh:null})},n=e.apiPrefix??`/api`;this.tokenProvider=t,this.client=new m(e.baseUrl,n,t,()=>this.onAuthStateChanged?.()),this.auth=new v(this.client,t),this.users=new y(this.client),this.keys=new b(this.client),this.policies=new x(this.client),this.logs=new S(this.client,e.baseUrl,n),this.collections=new D(this.client),this.blobs=new E(this.client,n),this.capabilities=new O(this.client)}onAuthStateChange(e){this.onAuthStateChanged=e}authenticated(){return this.tokenProvider.token(`access`)!==null}collection(e){return this.collections.documents(e)}};function A(e){let t=`${e.collectionName}_array_pager_state_`,n=new i({}),a=[...e.initialData??[]],c=`collection`,l,u=e.page??1,d=e.size??20,f=[],p,m,{match:h}=o(e.customFunctions??{}),{sort:g}=s(),_=n.select(e=>e[t]),v={data:[],loading:!0,error:void 0,page:{number:1,size:d,count:0,total:0,pages:1}},y=()=>({filters:p,sort:f,pagination:{type:`offset`,offset:(u-1)*d,limit:d}}),b=async(r=!0)=>{if(e.fetch){if(m=void 0,r){let e=_.get()??v;await n.set({[t]:{...e,loading:!0,error:void 0}})}try{let t=y(),n=await e.fetch(t);c=n.scope,l=n.total,a=n.replace?[...n.data]:[...a,...n.data]}catch(e){m=e}}let i=x(e.fetch?r:!1);await n.set({[t]:i})},x=e=>{let t=[...a];if(c===`collection`){p&&(t=t.filter(e=>h(e,p))),f.length>0&&(t=g(t,f));let n=t.length,r=Math.ceil(n/d)||1;u>r&&(u=r),u<1&&(u=1);let i=(u-1)*d,a=t.slice(i,i+d);return{data:a,loading:e,error:m,page:{number:u,size:d,count:a.length,total:n,pages:r}}}let n=l??t.length,r=Math.ceil(n/d)||1;return{data:t,loading:e,error:m,page:{number:u,size:d,count:t.length,total:n,pages:r}}};return b(!0),{id:()=>t,page:()=>_.get()??v,navigate:async e=>{if(e<1)throw Error(`Page number must be >= 1`);u=e,await b(!0)},resize:async(e,t)=>{if(e<1)throw Error(`Page size must be >= 1`);d=e,u=t,await b(!0)},sort:async e=>{f=Array.isArray(e)?e:[e],u=1,await b(!0)},filter:async e=>{p=e,u=1,await b(!0)},refresh:async e=>{let r=_.get()??v;await n.set({[t]:{...r,loading:!0}});let i=e?.delay??600;await Promise.all([new Promise(e=>setTimeout(e,i)),b(!1)]);let a=_.get()??v;await n.set({[t]:{...a,loading:!1}})},subscribe:e=>_.subscribe(t=>{e(t)}),invalidate:async()=>{await n.set({[t]:r}),a=[]}}}export{T as BlobNamespace,v as HestiaAuth,E as HestiaBlobClient,k as HestiaClient,_ as HestiaCollection,D as HestiaCollections,b as HestiaKeyStore,S as HestiaLogs,m as HestiaNetworkClient,x as HestiaPolicies,p as HestiaResponse,y as HestiaUsers,A as createArrayPager,g as createPagedController,f as internalError,u as notFound,c as parseErrorBody,d as permissionDenied,l as toSystemError};

package/package.json

@@ -1,43 +1,50 @@
 {
   "name": "@asaidimu/hestia",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "TypeScript client SDK for the Hestia platform — auth, collections, API keys, policies, audit logs, blobs, and capabilities",
   "type": "module",
-  "module": "index.ts",
-  "main": "index.ts",
-  "types": "index.ts",
-  "scripts": {
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:browser": "vitest --browser --run"
+  "main": "./index.cjs",
+  "module": "./index.mjs",
+  "types": "./index.d.mts",
+  "exports": {
+    ".": {
+      "types": {
+        "import": "./index.d.mts",
+        "require": "./index.d.cts"
+      },
+      "import": "./index.mjs",
+      "require": "./index.cjs"
+    }
   },
   "files": [
-    "*.ts",
-    "*/**/*.ts",
-    "!*.test.ts",
-    "!*/**/*.test.ts"
+    "./*"
   ],
+  "keywords": [
+    "typescript"
+  ],
+  "author": "Saidimu <47994458+asaidimu@users.noreply.github.com>",
+  "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/asaidimu/hestia.git"
   },
-  "license": "MIT",
-  "author": "Asaidimu <dev@asaidimu.com>",
+  "bugs": {
+    "url": "git+https://github.com/asaidimu/hestia/issues"
+  },
+  "homepage": "https://github.com/asaidimu/hestia#readme",
   "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "tag": "latest",
     "access": "public"
   },
-  "devDependencies": {
-    "@types/bun": "latest",
-    "vitest": "^4.1.10"
-  },
-  "peerDependencies": {
-    "typescript": "^5"
-  },
   "dependencies": {
     "@asaidimu/network-client": "^2.0.0",
+    "@asaidimu/query": "^1.0.0",
     "@asaidimu/utils-artifacts": "^8.2.25",
     "@asaidimu/utils-error": "^1.1.10",
+    "@asaidimu/utils-schema": "^1.0.10",
     "@asaidimu/utils-store": "^10.2.18",
+    "@asaidimu/utils-sync": "^2.3.0",
     "uuid": "^14.0.1"
   }
 }

package/auth/store.ts

@@ -1,75 +0,0 @@
-import { HestiaNetworkClient, IdentityProvider } from "../core/client";
-import type { LoginResult, ServerHealth, TokenPair } from "./types";
-
-export class HestiaAuth {
-  constructor(
-    private client: HestiaNetworkClient,
-    private provider: IdentityProvider,
-  ) {}
-
-  async health(): Promise<ServerHealth> {
-    const res = await this.client.get<{ data: ServerHealth }>("/system/core/health");
-    return res.data!.data;
-  }
-
-  async login(email: string, password: string): Promise<LoginResult> {
-    const res = await this.client.post<{ data: LoginResult }>(
-      "/system/auth/session",
-      { email, password },
-    );
-    const result = res.data!.data;
-    this.provider.setIdentity(result.user);
-    this.client.storeTokens(result.token.access, result.token.refresh);
-    return result;
-  }
-
-  async register(
-    email: string,
-    password: string,
-    name: string,
-  ): Promise<{ _id_: string; email: string; name: string }> {
-    const res = await this.client.post<{
-      data: { _id_: string; email: string; name: string, scopes:string };
-    }>("/system/auth/user", { email, password, name });
-    return res.data!.data;
-  }
-
-  async refresh(refreshToken?: string): Promise<TokenPair> {
-    const body = refreshToken ? { refresh_token: refreshToken } : {};
-    const res = await this.client.patch<{ data: { token: TokenPair } }>(
-      "/system/auth/session",
-      body,
-    );
-    return res.data!.data.token;
-  }
-
-  async logout(): Promise<void> {
-    const refresh = this.provider.token("refresh");
-    const body = refresh ? { refresh_token: refresh } : {};
-    await this.client.delete("/system/auth/session", body);
-    await this.provider.clear();
-  }
-
-  async requestPasswordReset(email: string): Promise<void> {
-    await this.client.post("/system/auth/password", { email });
-  }
-
-  async confirmPasswordReset(
-    resetToken: string,
-    password: string,
-  ): Promise<void> {
-    await this.client.patch(
-      "/system/auth/password",
-      { password, token:resetToken },
-      { headers: { Authorization: `Bearer ${resetToken}` } },
-    );
-  }
-
-  async bootstrap(key: string, password: string, email: string): Promise<void> {
-    await this.client.patch(
-      "/system/auth/bootstrap",
-      { password, email },
-      { headers: { "X-API-Key": key } },
-    );
-  }
-}

package/auth/types.ts

@@ -1,38 +0,0 @@
-import { UserIdentity } from "../system/identity/types"
-
-export interface TokenPair {
-  access: string
-  refresh: string
-  type: string
-  validity: number
-}
-
-export interface LoginResult {
-  token: TokenPair
-  user: UserIdentity
-}
-
-export interface ServerHealth {
-  bootstrapped: boolean
-  ok: boolean
-}
-
-export interface LoginRequest {
-  email: string
-  password: string
-}
-
-export interface RegisterRequest {
-  email: string
-  password: string
-  name: string
-}
-
-export interface RefreshRequest {
-  refresh_token: string
-}
-
-export interface BootstrapPasswordRequest {
-  password: string
-  email: string
-}

package/blobs/store.ts

@@ -1,208 +0,0 @@
-import type { QueryDSL } from "@asaidimu/query";
-import { ReactiveDataStore } from "@asaidimu/utils-store";
-import { HestiaNetworkClient } from "../core/client";
-import { createPagedController } from "../core/pager";
-import type { Page, PagedData } from "../core/types";
-import type {
-    BlobDocument,
-    BlobMeta,
-    CreateNamespaceRequest,
-    ListBlobsRequest,
-    NamespaceInfo,
-} from "./types";
-
-function asDoc(b: BlobMeta): BlobDocument {
-  return {
-    _id_: b.key,
-    _metadata_: {
-      checksum: "",
-      created: b.created_at,
-      updated: b.updated_at ?? b.created_at,
-      version: 1,
-    },
-    ...b,
-  };
-}
-
-function pageMeta<T extends Record<string,any>>(items: T[]): Page<T>["page"] {
-  return {
-    number: 1,
-    size: items.length,
-    count: items.length,
-    total: items.length,
-    pages: 1,
-  };
-}
-
-/**
- * Namespace-scoped blob facade shaped like HestiaCollection.
- * Wraps blob CRUD behind a DocumentStore-compatible interface
- * so you can use DataTable + PagedData.
- */
-export class BlobNamespace {
-  private pagerOptions = {};
-  private pager: PagedData<BlobMeta>;
-  private prefixFilter = "";
-
-  constructor(
-    private client: HestiaNetworkClient,
-    private ns: string,
-  ) {
-    this.pager = createPagedController<BlobMeta>(
-      `blobs_${ns}`,
-      new ReactiveDataStore<any>({}),
-      this.pagerOptions,
-      (query) => this.find(query),
-    );
-  }
-
-  name() {
-    return this.ns;
-  }
-
-  setPrefix(prefix: string) {
-    this.prefixFilter = prefix;
-  }
-
-  private basePath() {
-    return `/system/blobs/blob/${encodeURIComponent(this.ns)}`;
-  }
-
-  async find(query?: QueryDSL<BlobMeta>): Promise<Page<BlobMeta>> {
-    const prefix = this.prefixFilter || (query as any)?.prefix || "";
-    const limit =
-      (query as any)?.limit ?? query?.pagination?.limit ?? 0;
-
-    const req: ListBlobsRequest = {};
-    if (prefix) req.prefix = prefix;
-    if (limit) req.limit = limit;
-
-    const res = await this.client.post<{
-      data: { blobs: BlobMeta[] };
-    }>(`${this.basePath()}/query`, req);
-
-    const items = res.data?.data?.blobs ?? [];
-    return { data: items.map(asDoc), loading: false, page: pageMeta(items), error: undefined };
-  }
-
-  async head(key: string): Promise<BlobDocument | undefined> {
-    try {
-      const res = await this.client.get<{ data: BlobMeta }>(
-        `${this.basePath()}/${encodeURIComponent(key)}`,
-      );
-      if (!res.data?.data) return undefined;
-      return asDoc(res.data.data);
-    } catch (err: any) {
-      if (
-        err?.code === "SYNC-001-NF" ||
-        (err?.code === "INTERNAL_ERROR" &&
-          typeof err?.message === "string" &&
-          err.message.includes("not found"))
-      )
-        return undefined;
-      throw err;
-    }
-  }
-
-  async upload(
-    key: string,
-    data: Blob,
-    contentType?: string,
-  ): Promise<BlobDocument> {
-    const headers: Record<string, string> = {};
-    const ct = contentType || data.type;
-    if (ct) headers["Content-Type"] = ct;
-
-    const res = await this.client.post<{ data: BlobMeta }>(
-      `${this.basePath()}/${encodeURIComponent(key)}`,
-      data,
-      { headers, bodyType: "blob" },
-    );
-    return asDoc(res.data!.data);
-  }
-
-  async download(
-    key: string,
-  ): Promise<{ data: Blob; contentType: string }> {
-    const res = await this.client.get<Blob>(
-      `${this.basePath()}/${encodeURIComponent(key)}`,
-      { responseType: "blob" },
-    );
-    const blob = res.data!;
-    return { data: blob, contentType: blob.type };
-  }
-
-  async updateMetadata(key: string, custom: Record<string, any>): Promise<BlobMeta> {
-    const res = await this.client.patch<{ data: BlobMeta }>(
-      `${this.basePath()}/${encodeURIComponent(key)}`,
-      { custom },
-    );
-    return res.data!.data;
-  }
-
-  async delete(key: string): Promise<void> {
-    await this.client.delete(
-      `${this.basePath()}/${encodeURIComponent(key)}`,
-    );
-  }
-
-  async list(): Promise<BlobMeta[]> {
-    const res = await this.client.post<{
-      data: { blobs: BlobMeta[] };
-    }>(`${this.basePath()}/query`, {});
-    return res.data?.data?.blobs ?? [];
-  }
-
-  page(): PagedData<BlobMeta> {
-    return this.pager;
-  }
-}
-
-/**
- * Top-level blob client. Entry point for all blob operations.
- *
- * Usage:
- *   client.blobs.listNamespaces()
- *   const ns = client.blobs.namespace("my-bucket")
- *   ns.find({ prefix: "images/" })
- *   ns.upload("logo.png", file)
- *   const { data } = await ns.download("logo.png")
- */
-export class HestiaBlobClient {
-  constructor(private client: HestiaNetworkClient) {}
-
-  private nsBase = "/system/blobs";
-
-  // ── Namespace operations ──────────────────────────────────────────────
-
-  async namespaces(): Promise<NamespaceInfo[]> {
-    const res = await this.client.post<{
-      data: { namespaces: NamespaceInfo[] };
-    }>(`${this.nsBase}/namespace/query`);
-    return res.data?.data?.namespaces ?? [];
-  }
-
-  async createNamespace(data: CreateNamespaceRequest): Promise<NamespaceInfo> {
-    const res = await this.client.post<{ data: NamespaceInfo }>(
-      `${this.nsBase}/namespace`,
-      data,
-    );
-    return res.data!.data;
-  }
-
-  async deleteNamespace(ns: string): Promise<void> {
-    await this.client.delete(
-      `${this.nsBase}/namespace/${encodeURIComponent(ns)}`,
-    );
-  }
-
-
-  blob(namespace: string, key:string) {
-      return `${this.client.base()}${this.nsBase}/blob/${encodeURIComponent(namespace)}/${encodeURIComponent(key)}`
-  }
-  // ── Namespace-scoped facade ───────────────────────────────────────────
-
-  namespace(ns: string): BlobNamespace {
-    return new BlobNamespace(this.client, ns);
-  }
-}

package/blobs/types.ts

@@ -1,28 +0,0 @@
-import type { Document } from "../core/types"
-
-export interface NamespaceInfo {
-  id: string
-  display_name: string
-}
-
-export interface BlobMeta {
-  key: string
-  namespace_id: string
-  content_type: string
-  size: number
-  created_at: string
-  updated_at?: string
-  custom?: Record<string, any>
-}
-
-export type BlobDocument = Document<BlobMeta>
-
-export interface ListBlobsRequest {
-  prefix?: string
-  limit?: number
-}
-
-export interface CreateNamespaceRequest {
-  display_name?: string
-  ns?: string
-}

package/collections/store.ts

@@ -1,59 +0,0 @@
-import { HestiaNetworkClient } from "../core/client"
-import { HestiaCollection } from "../core/collection"
-import type { Document } from "../core/types"
-import type { CollectionMeta } from "./types"
-
-export class HestiaCollections {
-  constructor(private client: HestiaNetworkClient) {}
-
-  async list(): Promise<{ collections: CollectionMeta[]; total: number }> {
-    const res = await this.client.get<{
-      data: { name: string; schema: any; created: string; updated: string }[]
-    }>("/system/collections/collection")
-    const items = res.data?.data ?? []
-    return {
-      collections: items.map((i) => ({
-        name: i.name,
-        schema: i.schema,
-        created: i.created,
-        updated: i.updated,
-      })),
-      total: items.length,
-    }
-  }
-
-  async read(name: string): Promise<CollectionMeta | undefined> {
-    try {
-      const res = await this.client.get<{ data: { name: string; schema: any; created: string; updated: string } }>(
-        `/system/collections/collection/${encodeURIComponent(name)}`,
-      )
-      if (!res.data) return undefined
-      return res.data.data
-    } catch (err: any) {
-      if (err?.code === "SYNC-001-NF") return undefined
-      throw err
-    }
-  }
-
-  async create(schema: any): Promise<Document<{ schema: any }>> {
-    const res = await this.client.post<{ data: Document<{ schema: any }> }>("/system/collections/collection", schema)
-    return res.data!.data
-  }
-
-  async update(name: string, schema: any): Promise<Document<{ schema: any }>> {
-      throw new Error("Method not implemented")
-    // const res = await this.client.patch<{ data: Document<{ schema: any }> }>(
-    //   `/api/admin/collections/${encodeURIComponent(name)}`,
-    //   schema,
-    // )
-    // return res.data!.data
-  }
-
-  async delete(name: string): Promise<void> {
-    await this.client.delete(`/system/collections/collection/${encodeURIComponent(name)}`)
-  }
-
-  documents<T extends Record<string, any>>(collectionName: string): HestiaCollection<T> {
-    return new HestiaCollection<T>(this.client,collectionName)
-  }
-}

package/collections/types.ts

@@ -1,11 +0,0 @@
-import { SchemaDefinition } from "@asaidimu/utils-schema"
-import type { Document } from "../core/types"
-
-export interface CollectionMeta {
-  name: string
-  schema: SchemaDefinition
-  created: string
-  updated: string
-}
-
-export type CollectionDocument = Document<{ schema: any }>

package/container.ts

@@ -1,95 +0,0 @@
-import { ArtifactContainer } from "@asaidimu/utils-artifacts";
-import type { SimplePersistence } from "@asaidimu/utils-persistence";
-import { ReactiveDataStore } from "@asaidimu/utils-store";
-import { HestiaAuth } from "./auth/store";
-import { HestiaCollections } from "./collections/store";
-import {
-    HestiaNetworkClient,
-    type IdentityProvider,
-} from "./core/client";
-import { HestiaKeyStore } from "./system/api-keys/store";
-import { HestiaUsers } from "./system/identity/store";
-import { UserIdentity } from "./system/identity/types";
-import { HestiaLogs } from "./system/logs/store";
-import { HestiaPolicies } from "./system/policies/store";
-import { HestiaBlobClient } from "./blobs/store";
-import { HestiaCapabilities } from "./system/capabilities/store";
-
-export interface HestiaConfig {
-  baseUrl: string;
-  persistence?: SimplePersistence<AuthState>;
-}
-
-interface AuthState {
-  access: string | null;
-  refresh: string | null;
-  identity: UserIdentity | null;
-}
-
-type Registry = Record<string, any>;
-
-export class HestiaClient {
-  readonly store: ReactiveDataStore<AuthState>;
-  readonly container: ArtifactContainer<Registry, any>;
-  readonly client: HestiaNetworkClient;
-  readonly auth: HestiaAuth;
-  readonly users: HestiaUsers;
-  readonly keys: HestiaKeyStore;
-  readonly policies: HestiaPolicies;
-  readonly logs: HestiaLogs;
-  readonly collections: HestiaCollections;
-  readonly blobs: HestiaBlobClient;
-  readonly capabilities: HestiaCapabilities
-  private tokenProvider: IdentityProvider;
-
-  private onAuthStateChanged?: () => void;
-
-  constructor(config: HestiaConfig) {
-    this.store = new ReactiveDataStore<AuthState>(
-      { access: null, refresh: null, identity: null },
-      config.persistence,
-    );
-
-    this.container = new ArtifactContainer<Registry, any>(this.store);
-
-    const tokenProvider: IdentityProvider = {
-      identity: () => this.store.get().identity,
-      token: (key: "access" | "refresh") => this.store.get()[key],
-      setTokens: async (access: string, refresh: string) =>
-        void (await this.store.set({ access, refresh })),
-      setIdentity: async (identity) =>
-        void (await this.store.set({ identity })),
-      clear: async () =>
-        void (await this.store.set({ access: null, refresh: null })),
-    };
-
-    this.tokenProvider = tokenProvider;
-    this.client = new HestiaNetworkClient(config.baseUrl, tokenProvider, () =>
-      this.onAuthStateChanged?.(),
-    );
-
-    this.auth = new HestiaAuth(this.client, tokenProvider);
-    this.users = new HestiaUsers(this.client);
-    this.keys = new HestiaKeyStore(this.client,);
-    this.policies = new HestiaPolicies(this.client);
-    this.logs = new HestiaLogs(
-      this.client,
-      config.baseUrl,
-    );
-    this.collections = new HestiaCollections(this.client);
-    this.blobs = new HestiaBlobClient(this.client);
-    this.capabilities = new HestiaCapabilities(this.client)
-  }
-
-  onAuthStateChange(callback: () => void) {
-    this.onAuthStateChanged = callback;
-  }
-
-  authenticated(): boolean {
-    return this.tokenProvider.token("access") !== null;
-  }
-
-  collection<T extends Record<string, any>>(name: string) {
-    return this.collections.documents<T>(name);
-  }
-}