@homedev/objector 0.0.6 → 0.0.7

package/dist/index.js

@@ -1 +1 @@
-import z from"path";import B from"fs/promises";import j from"path";import Z from"yaml";var $=async(d)=>{try{return await B.access(d,B.constants.R_OK),!0}catch{return!1}},H=async(d,P)=>{let C=await(async()=>{let w=[""];if(!j.isAbsolute(d)&&P?.dirs)w.push(...P.dirs);for(let X of w){let G=j.join(X,d);if(await $(G))return j.resolve(G)}throw new Error(`File not found: "${d}"`)})(),F=await B.readFile(C),M=j.dirname(C),T={"[.](yml|yaml)$":Z.parse,"[.]json$":JSON.parse,...P?.parsers},U=Object.entries(T).find((w)=>C.match(w[0]));if(!U)throw new Error(`Unhandled file type: ${d}`);return{content:U[1](F.toString()),fullPath:C,folderPath:M}};var h=async(d,P)=>{for(let O of d){let C=P?.root?z.join(P.root,O):O,F=await H(C,P?.loadOptions);if(P?.loaded)await P.loaded(F)}};var D=(d,P,O)=>{for(let C of Object.keys(P)){if(d[C]===void 0)continue;let F=P[C],M=d[C];if(typeof M!==typeof F||Array.isArray(M)!==Array.isArray(F)){let U=O?.mismatch?.(C,M,F,d,P);if(U!==void 0){P[C]=U;continue}throw new Error(`Type mismatch: ${C}`)}let T=O?.mode?.(C,M,F,d,P)??"merge";switch(T){case"source":P[C]=M;continue;case"target":continue;case"skip":delete P[C],delete d[C];continue;case"merge":break;default:throw new Error(`Unknown merge mode: ${T}`)}if(typeof M==="object")if(Array.isArray(M))F.push(...M);else{if(O?.navigate?.(C,M,F,d,P)===!1)continue;D(M,F,O)}else{if(M===F)continue;let U=O?.conflict?.(C,M,F,d,P);P[C]=U===void 0?F:U}}for(let C of Object.keys(d))if(P[C]===void 0)P[C]=d[C]};var L;((F)=>{F[F.Continue=0]="Continue";F[F.Skip=1]="Skip";F[F.ReplaceItem=2]="ReplaceItem";F[F.ReplaceParent=3]="ReplaceParent"})(L||={});class E{action;by;constructor(d,P){this.action=d;this.by=P}static ReplaceParent(d){return new E(3,d)}static ReplaceItem(d){return new E(2,d)}static Skip(){return new E(1)}static Continue(){return new E(0)}}var q=async(d,P)=>{let O=async(F)=>{for(let[M,T]of Object.entries(F.value)){let U=await C({key:M,value:T,path:F.path,parent:F.value});switch(U.action){case 3:if(!F.key)throw new Error("Cannot remplace root");F.parent[F.key]=U.by;return;case 2:F.value[M]=U.by;break;case 1:return}}},C=async(F)=>{let M=F.key?await P(F):{action:0};if(M.action===0){if(F.value&&typeof F.value==="object"){if(F.key)F.path.push(F.key);if(await O(F),F.key)F.path.pop()}}return M};await C({key:null,value:d,path:[],parent:null})};var J=async(d,P,O,C,F)=>{for(let M of F?.functions??[]){let T=M[0].exec(O.value);if(T){let[,U,...I]=T;if(M[1][U])return E.ReplaceItem(await M[1][U]({args:I,path:P,value:d.value,root:C,key:U}))}}};var Q=async(d,P,O,C)=>{for(let F of C?.keys??[]){let M=F[0].exec(d.key);if(M){let[,T,...U]=M;if(F[1][T]){let I={args:U,path:P,value:d.value,root:O,parent:d.parent,key:d.key},w=await F[1][T](I);return w===void 0?E.Continue():E.ReplaceParent(w)}}}};var S=(d,P,O,C)=>{for(let F of C?.sources??[])P.value=P.value.replaceAll(F[0],(M,T,...U)=>F[1][T]?.({args:U,path:d,value:P.value,root:O,key:T})??M)};var W=(d,P)=>{for(let[O,C]of P?.variables??[])d.value=d.value.replaceAll(O,(F,M)=>C[M]??F)};var e=async(d,P)=>q(d,async(O)=>{let C=[...O.path,O.key].join(".");if(P?.filters){if(!P.filters.some((M)=>M.test(C)))return E.Continue()}let F=await Q(O,C,d,P);if(F)return F;if(typeof O.value==="string"){let M={value:O.value};return S(C,M,d,P),W(M,P),await J(O,C,M,d,P)??(O.value!==M.value?E.ReplaceItem(M.value):E.Continue())}return E.Continue()});var Y=(d,P)=>{let O=/^\[([^=\]]*)([=]*)([^\]]*)\]$/.exec(P);if(O){let[C,F,M,T]=O;if(Array.isArray(d))switch(M){case"==":case"=":return d.find((U)=>U[F.trim()]==T.trim())}}return d[P]},dF=(d,P,O)=>{let C=void 0,F=void 0,M=(T,U)=>{let I=U.pop();if(I){let w=Y(T,I);if(!w)throw new Error(`Unknown path element: "${I}" in "${P}"`);return C=T,F=I,M(w,U)}if(O&&F)C[F]=O;return T};return M(d,P.split(".").reverse())};var MF=async(d,P)=>{let O=[];return await q(d,(C)=>{if(P([...C.path,C.key].join("."),C.value))O.push(C.value);return E.Continue()}),O};export{dF as select,h as processIncludes,e as processFields,q as navigate,D as merge,H as load,MF as find,E as NavigateResult,L as NavigateAction};
+import K from"path";import G from"fs/promises";import W from"path";import z from"yaml";var D=async(d)=>{try{return await G.access(d,G.constants.R_OK),!0}catch{return!1}},q=async(d,P)=>{let C=await(async()=>{let j=[""];if(!W.isAbsolute(d)&&P?.dirs)j.push(...P.dirs);for(let I of j){let H=W.join(I,d);if(await D(H))return W.resolve(H)}throw new Error(`File not found: "${d}"`)})(),F=await G.readFile(C),T=W.dirname(C),U={"[.](yml|yaml)$":z.parse,"[.]json$":JSON.parse,...P?.parsers},M=Object.entries(U).find((j)=>C.match(j[0]));if(!M)throw new Error(`Unhandled file type: ${d}`);return{content:M[1](F.toString()),fullPath:C,folderPath:T}};var V=async(d,P)=>{for(let O of d){let C=P?.root?K.join(P.root,O):O,F=await q(C,P?.loadOptions);if(P?.loaded)await P.loaded(F)}};var L=(d,P,O)=>{for(let C of Object.keys(P)){if(d[C]===void 0)continue;let F=P[C],T=d[C];if(typeof T!==typeof F||Array.isArray(T)!==Array.isArray(F)){let M=O?.mismatch?.(C,T,F,d,P);if(M!==void 0){P[C]=M;continue}throw new Error(`Type mismatch: ${C}`)}let U=O?.mode?.(C,T,F,d,P)??"merge";switch(U){case"source":P[C]=T;continue;case"target":continue;case"skip":delete P[C],delete d[C];continue;case"merge":break;default:throw new Error(`Unknown merge mode: ${U}`)}if(typeof T==="object")if(Array.isArray(T))F.push(...T);else{if(O?.navigate?.(C,T,F,d,P)===!1)continue;L(T,F,O)}else{if(T===F)continue;let M=O?.conflict?.(C,T,F,d,P);P[C]=M===void 0?F:M}}for(let C of Object.keys(d))if(P[C]===void 0)P[C]=d[C]};var Y;((F)=>{F[F.Continue=0]="Continue";F[F.Skip=1]="Skip";F[F.ReplaceItem=2]="ReplaceItem";F[F.ReplaceParent=3]="ReplaceParent"})(Y||={});class E{action;by;constructor(d,P){this.action=d;this.by=P}static ReplaceParent(d){return new E(3,d)}static ReplaceItem(d){return new E(2,d)}static Skip(){return new E(1)}static Continue(){return new E(0)}}var B=async(d,P)=>{let O=async(F)=>{for(let[T,U]of Object.entries(F.value)){let M=await C({key:T,value:U,path:F.path,parent:F.value});switch(M.action){case 3:if(!F.key)throw new Error("Cannot remplace root");F.parent[F.key]=M.by;return;case 2:F.value[T]=M.by;break;case 1:return}}},C=async(F)=>{let T=F.key?await P(F):{action:0};if(T.action===0){if(F.value&&typeof F.value==="object"){if(F.key)F.path.push(F.key);if(await O(F),F.key)F.path.pop()}}return T};await C({key:null,value:d,path:[],parent:null})};var J=async(d,P,O,C,F)=>{for(let T of F?.functions??[]){let U=T[0].exec(O.value);if(U){let[,M,...w]=U;if(T[1][M])return E.ReplaceItem(await T[1][M]({args:w,path:P,value:d.value,root:C,key:M}))}}};var Q=async(d,P,O,C)=>{for(let F of C?.keys??[]){let T=F[0].exec(d.key);if(T){let[,U,...M]=T;if(F[1][U]){let w={args:M,path:P,value:d.value,root:O,parent:d.parent,key:d.key},j=await F[1][U](w);return j===void 0?E.Continue():E.ReplaceParent(j)}}}};var S=(d,P,O,C)=>{for(let F of C?.sources??[])P.value=P.value.replaceAll(F[0],(T,U,...M)=>F[1][U]?.({args:M,path:d,value:P.value,root:O,key:U})??T)};var X=(d,P)=>{for(let[O,C]of P?.variables??[])d.value=d.value.replaceAll(O,(F,T)=>C[T]??F)};var PF=async(d,P)=>B(d,async(O)=>{let C=[...O.path,O.key].join(".");if(P?.filters){if(!P.filters.some((T)=>T.test(C)))return E.Continue()}let F=await Q(O,C,d,P);if(F)return F;if(typeof O.value==="string"){let T={value:O.value};return S(C,T,d,P),X(T,P),await J(O,C,T,d,P)??(O.value!==T.value?E.ReplaceItem(T.value):E.Continue())}return E.Continue()});import _ from"yaml";var Z=(d,P="name")=>Object.entries(d).map(([O,C])=>({[P]:O,...C})),TF=(d,P="name")=>Object.fromEntries(d.map((O)=>[O[P],O])),$=(d,P="name")=>Object.fromEntries(d.map((O)=>{let{[P]:C,...F}=O;return[C,F]}));var b=(d,P)=>{let O=/^\[([^=\]]*)([=]*)([^\]]*)\]$/.exec(P);if(O){let[F,T,U,M]=O;if(Array.isArray(d))switch(U){case"==":case"=":return d.find((w)=>w[T.trim()]==M.trim())}}let C=/^([^[\]]*)\[([^\]]*)]/.exec(P);if(C)return d[C[1]][C[2]];return d[P]},x=(d,P,O)=>{let C=void 0,F=void 0,T=(M,w)=>{let j=w.pop();if(j){let I=b(M,j);if(!I)throw new Error(`Unknown path element: "${j}" in "${P}"`);return C=M,F=j,T(I,w)}if(O?.set&&F)C[F]=O?.set;return M},U=T(d,P.split(O?.separator??".").reverse());switch(O?.format){case"list":return Z(U,O?.key);case"object":return $(U,O?.key);case"json":return JSON.stringify(U);case"yaml":return _.stringify(U);default:return U}},wF=async(d,P)=>{let O=/^(?<path>[^@>]*)?(?:@(?<from>[^>]*))?(?:>(?<format>[^|]*)(?:\|(?<key>.*))?)?$/.exec(d)?.groups;if(!O)throw new Error(`Invalid reference: "${d}"`);let{from:C,path:F,format:T,key:U}=O,M=C?await(P.load??q)(C):P.root;return x(M,F,{format:T,key:U})};var qF=async(d,P)=>{let O=[];return await B(d,(C)=>{if(P([...C.path,C.key].join("."),C.value))O.push(C.value);return E.Continue()}),O};export{TF as toObjectWithKey,$ as toObject,Z as toList,x as selectPath,wF as select,V as processIncludes,PF as processFields,B as navigate,L as merge,q as load,qF as find,E as NavigateResult,Y as NavigateAction};

package/dist/objector.d.ts

@@ -152,6 +152,18 @@ export declare interface ProcessFieldsOptions {
  */
 export declare const processIncludes: (includes: string[], options?: IncludeOptions) => Promise<void>;
 
+export declare const select: (at: string, options: {
+    root?: any;
+    load?: (from: string) => Promise<any>;
+}) => Promise<any>;
+
+export declare interface SelectOptions {
+    set?: any;
+    format?: string;
+    key?: string;
+    separator?: string;
+}
+
 /**
  * @public
  * @param from
@@ -159,6 +171,12 @@ export declare const processIncludes: (includes: string[], options?: IncludeOpti
  * @param set
  * @returns
  */
-export declare const select: <T = any>(from: any, path: string, set?: any) => T;
+export declare const selectPath: <T = any>(from: any, path: string, options?: SelectOptions) => T;
+
+export declare const toList: <T>(from: any, key?: string) => T[];
+
+export declare const toObject: <T>(from: any[], key?: string) => T;
+
+export declare const toObjectWithKey: <T>(from: any[], key?: string) => T;
 
 export { }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@homedev/objector",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "description": "object extensions for YAML/JSON",
   "author": "julzor",
   "license": "ISC",