@homedev/objector 0.0.23 → 0.0.24
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.js +2 -2
- package/dist/objector.d.ts +7 -1
- package/package.json +1 -1
package/dist/index.js
CHANGED
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
import v from"path";import
|
|
1
|
+
import v from"path";import L from"fs/promises";import D from"path";import N from"yaml";var d=async(T)=>{try{return await L.access(T,L.constants.R_OK),!0}catch{return!1}},S=async(T,F)=>{let C=await(async()=>{let W=[""];if(!D.isAbsolute(T)&&F?.dirs)W.push(...F.dirs);for(let B of W){let I=D.join(B,T);if(await d(I))return D.resolve(I)}throw new Error(`File not found: "${T}"`)})(),M=await L.readFile(C),O=D.dirname(C),j={"[.](yml|yaml)$":N.parse,"[.]json$":JSON.parse,...F?.parsers},$=Object.entries(j).find((W)=>C.match(W[0]));if(!$)throw new Error(`Unhandled file type: ${T}`);return{content:$[1](M.toString()),fullPath:C,folderPath:O}};var P=async(T,F)=>{for(let E of T){let C=F?.root?v.join(F.root,E):E,M=await S(C,F?.loadOptions);if(F?.loaded)await F.loaded(M)}};var _=(T,F,E)=>{for(let C of Object.keys(F)){if(T[C]===void 0)continue;let M=F[C],O=T[C];if(typeof O!==typeof M||Array.isArray(O)!==Array.isArray(M)){let $=E?.mismatch?.(C,O,M,T,F);if($!==void 0){F[C]=$;continue}throw new Error(`Type mismatch: ${C}`)}let j=E?.mode?.(C,O,M,T,F)??"merge";switch(j){case"source":F[C]=O;continue;case"target":continue;case"skip":delete F[C],delete T[C];continue;case"merge":break;default:throw new Error(`Unknown merge mode: ${j}`)}if(typeof O==="object")if(Array.isArray(O))M.push(...O);else{if(E?.navigate?.(C,O,M,T,F)===!1)continue;_(O,M,E)}else{if(O===M)continue;let $=E?.conflict?.(C,O,M,T,F);F[C]=$===void 0?M:$}}for(let C of Object.keys(T))if(F[C]===void 0)F[C]=T[C]};var R;((O)=>{O[O.Continue=0]="Continue";O[O.Skip=1]="Skip";O[O.ReplaceItem=2]="ReplaceItem";O[O.ReplaceParent=3]="ReplaceParent";O[O.DeleteParent=4]="DeleteParent"})(R||={});class G{action;by;constructor(T,F){this.action=T;this.by=F}static ReplaceParent(T){return new G(3,T)}static ReplaceItem(T){return new G(2,T)}static Skip(){return new G(1)}static Continue(){return new G(0)}static DeleteParent(){return new G(4)}}var w=async(T,F)=>{let E=async(M)=>{for(let[O,j]of Object.entries(M.value)){let $=await C({key:O,value:j,path:M.path,parent:M.value});switch($.action){case 3:if(!M.key)throw new Error("Cannot replace root");M.parent[M.key]=$.by;return;case 2:M.value[O]=$.by;break;case 1:return;case 4:delete M.parent[M.key];return}}},C=async(M)=>{let O=M.key?await F(M):{action:0};if(O.action===0){if(M.value&&typeof M.value==="object"){if(M.key)M.path.push(M.key);if(await E(M),M.key)M.path.pop()}}return O};await C({key:null,value:T,path:[],parent:null})};import h from"yaml";var b=(T,F="name")=>Object.entries(T).map(([E,C])=>({[F]:E,...C})),TF=(T,F="name")=>Object.fromEntries(T.map((E)=>[E[F],E])),A=(T,F="name")=>Object.fromEntries(T.map((E)=>{let{[F]:C,...M}=E;return[C,M]}));var V=(T,F,E="(",C=")")=>{let M=0,O="",j=[];for(let $ of T){if(O+=$,$===E)M++;if($===C)M--;if(M===0&&$===F)j.push(O.slice(0,-1)),O=""}if(O)j.push(O);return j};var g=(T,F,E,C)=>{if(F.startsWith("{")){let j=F.substring(1,F.length-1),$=H(E,j,C).toString();return H(T,$,C)}let M=/^\[([^=\]]*)([=]*)([^\]]*)\]$/.exec(F);if(M){let[j,$,q,W]=M;if(Array.isArray(T))switch(q){case"==":case"=":return T.find((B)=>B[$.trim()]==W.trim())}}let O=/^([^[\]]*)\[([^\]]*)]/.exec(F);if(O)return T[O[1]][O[2]];return T[F]},H=(T,F,E)=>{let C=void 0,M=void 0;F??="";let O=(B)=>B?.endsWith("?")?[B.substring(0,B.length-1),!0]:[B,!1],j=(B,I)=>{let[Q,z]=O(I.pop());if(Q){let K=g(B,Q,T,E);if(K===void 0){if(z)return;throw new Error(`Unknown path element: "${Q}" in "${F}"`)}return C=B,M=Q,j(K,I)}if(E?.set&&M)C[M]=E?.set;return B},$=V(F,E?.separator??".","{","}"),q=$.length>0&&$[$.length-1].startsWith("?=")?$.pop()?.substring(2):void 0;$.reverse();let W=j(T,$);if(W===void 0)return q;switch(E?.format){case"list":return b(W,E?.key);case"object":return A(W,E?.key);case"json":return JSON.stringify(W);case"yaml":return h.stringify(W);case"join":{let B=Array.isArray(W)?W:b(W),[,I,Q]=E?.key?.match(/([^|]*)?(?:\|(.*))?/)??[];return B.map((z)=>I?z[I]:z).join(Q?.replaceAll("\\n",`
|
|
2
2
|
`)??`
|
|
3
|
-
`)}default:return W}};var
|
|
3
|
+
`)}default:return W}};var Y=async(T,F,E,C)=>{let M,O=[],j=F;if(!C.sources)return;let $=(q)=>{let W=C.sources[q.key];if(W===void 0)return H(E,q.key);else{if(q.arg&&q.arg[0]==="{")q.arg=H(E,q.arg.substr(1,q.arg.length-2));return W({groups:q,arg:q.arg,path:T,value:j,root:E,key:q.key,options:C})}};if(j=j.replaceAll(C.sourcesMatcher??/\$\((?<key>[^:)]*)(?::(?<arg>[^)]*))?\)/g,(q,...W)=>{if(M)return q;let B=$(W[W.length-1]);if(B instanceof Promise)return`ð[${O.push(B)}]ñ`;if(typeof B==="object")return M=B,q;return B??""}),M)j=await M;else if(O.length){let q=await Promise.all(O);j=q.find((W)=>typeof W==="object")??j.replaceAll(/\xf0\[(\d+)]\xf1/g,(W,B)=>q[+B-1])}if(j===null)return G.DeleteParent();if(j===F)return G.Continue();return G.ReplaceItem(j)};var y=async(T,F,E,C)=>{if(!C.keys)return;let M=(C?.keysMatcher??/^\.(?<key>.*)/).exec(T.key)?.groups;if(M){if(C.keys[M.key]){if(typeof T.value==="string"){let $=await Y(F,T.value,E,C);if($.by)T.value=$.by}else await U(T.value,C);let O={arg:T.value,groups:M,path:F,value:T.value,root:E,parent:T.parent,key:T.key,file:C?.file,options:C},j=await C.keys[M.key](O);if(j===null)return G.DeleteParent();if(j===void 0)return G.Continue();return G.ReplaceParent(j)}}};var U=async(T,F)=>w(T,async(E)=>{let C=[...E.path,E.key].join(".");if(F.filters&&!F.filters.some((O)=>O.test(C)))return G.Continue();let M=async(O)=>{let j=await Y(C,O,{...T,...F.root},F);if(j.action===2&&typeof j.by==="string"){let $=await M(j.by);if($.by)return $}return j};return await y(E,C,{...T,...F.root},F)??(typeof E.value==="string"?await M(E.value):G.Continue())});var J=(T,F)=>{let E=/^(?<path>[^@>]*)?(?:@(?<from>[^>]*))?(?:>(?<format>[^|]*)(?:\|(?<key>.*))?)?$/.exec(T)?.groups;if(!E)throw new Error(`Invalid reference: "${T}"`);let{from:C,path:M,format:O,key:j}=E;if(!C)return H(F.root,M,{format:O,key:j});if(F.async===!1){if(!F.load)throw new Error("No load function defined");return H(F.load(C),M,{format:O,key:j})}else return(F.load??S)(C).then(($)=>H($,M,{format:O,key:j}))};var LF=async(T,F)=>{let E=[];return await w(T,(C)=>{if(F([...C.path,C.key].join("."),C.value))E.push(C.value);return G.Continue()}),E};import Z from"fs/promises";import k from"path";import r from"yaml";import X from"path";var f=(T)=>{return{load:async(F)=>{for(let{file:E,alias:C}of Array.isArray(F.value)?F.value:[F.value]){if(!E)throw new Error("File reference required");await T.load(E,C??E,F.file&&X.dirname(F.file))}delete F.parent[F.key]},include:(F)=>T.load(F.value,void 0,F.file&&X.dirname(F.file)),from:async(F)=>{let E=await J(F.value,{root:F.root,load:(C)=>T.load(C,void 0,F.file&&X.dirname(F.file))});if(F.parent.content){if(Array.isArray(F.parent.content)&&Array.isArray(E))return[...E,...F.parent.content];return T.merge(E,F.parent.content),F.parent.content}return E},concat:async(F)=>{let E=[];for(let C of Array.isArray(F.value)?F.value:[F.value])E.push(...await J(C,{root:F.root,load:(M)=>T.load(M,void 0,F.file&&X.dirname(F.file))}));return E.filter((C)=>C!==void 0)},extends:async(F)=>{for(let E of Array.isArray(F.value)?F.value:[F.value])T.merge(await J(E,{root:F.root,load:(C)=>T.load(C,void 0,F.file&&X.dirname(F.file))}),F.parent);delete F.parent[F.key]},alias:(F)=>{T.alias(F.value,F.parent),delete F.parent[F.key]},if:(F)=>{if(!F.value)return null;delete F.parent[F.key]},output:(F)=>{delete F.parent[F.key];for(let E of Array.isArray(F.value)?F.value:[F.value])if(typeof E==="string")T.output({name:E,value:F.parent});else T.output({...E,value:E.value??F.parent})},each:async(F)=>{delete F.parent[F.key];let E=Array.isArray(F.value)?F.value:await J(F.value,{root:F.root,load:(M)=>T.load(M,void 0,F.file&&X.dirname(F.file))}),C=[];if(!Array.isArray(E))throw new Error("source must be a list");for(let M=0;M<E.length;M++){let O=JSON.parse(JSON.stringify(F.parent));await U(O,{...F.options,root:{...F.root,item:E[M],this:O,index:M}}),C.push(O)}return C}}};import n from"fs/promises";var m=(T)=>{return{include:(F)=>T.load(F.arg),file:(F)=>n.readFile(F.arg).then((E)=>E.toString()),env:(F)=>process.env[F.arg],ref:(F)=>J(F.arg,{root:F.root,load:(E)=>T.load(E)})}};class p{options={load:{dirs:[]},merge:{},include:{},fields:{},includeKey:"includes",mergeKey:".merge",outputs:[]};cache={};includeDirectory(...T){return this.options.load.dirs??=[],this.options.load.dirs.push(...T),this}keys(T){return this.options.fields.keys={...this.options.fields.keys,...T},this}sources(T){return this.options.fields.sources={...this.options.fields.sources,...T},this}variables(T){return this.options.variables={...this.options.variables,...T},this}output(T){return this.options.outputs??=[],this.options.outputs.push(T),this}defaultProcessors(){return this.sources(m(this)).keys(f(this))}alias(T,F){return this.cache[T]=F,this}getAlias(T){return this.cache[T]}getOutputs(){return this.options.outputs??[]}async load(T,F,E){if(this.cache[T])return this.cache[T];let C=E?[E]:[];this.options.load.dirs&&C.push(...this.options.load.dirs);let M=await S(T,{...this.options.load,dirs:C});if(!M.content)return null;if(F)this.cache[F]=M.content;if(this.options.includeKey&&M.content[this.options.includeKey])await P(M.content[this.options.includeKey],{root:M.folderPath,loaded:(O)=>{if(this.options.mergeKey&&O.content)_(O.content,M.content,{mode:(j,$,q)=>q[this.options.mergeKey],...this.options.merge})},loadOptions:this.options.load,...this.options.include}),delete M.content[this.options.includeKey];return await U(M.content,{...this.options.fields,file:M.fullPath,root:{...this.options.fields.root,...this.options.variables}}),M.content}merge(T,F){_(T,F,{mode:(E,C,M)=>M[this.options.mergeKey],...this.options.merge})}async writeOutputs(T){if(T?.targetDirectory&&T?.removeFirst)try{await Z.rm(T?.targetDirectory,{recursive:!0,force:!0})}catch(F){throw new Error(`Failed to clean the output directory: ${F.message}`)}for(let F of this.getOutputs()){let E=k.join(T?.targetDirectory??".",F.name),C=k.dirname(E);if(T?.writing?.(F)===!1)continue;try{await Z.mkdir(C,{recursive:!0})}catch(M){throw new Error(`Failed to create target directory "${C}" for output "${E}": ${M.message}`)}try{switch(F.type){case"yaml":await Z.writeFile(E,r.stringify(F.value));break;case"json":await Z.writeFile(E,JSON.stringify(F.value));break;default:await Z.writeFile(E,F.value.toString())}}catch(M){throw new Error(`Failed to write output "${E}": ${M.message}`)}}}}export{TF as toObjectWithKey,A as toObject,b as toList,J as select,P as processIncludes,U as processFields,w as navigate,_ as merge,S as load,LF as find,p as Objector,G as NavigateResult,R as NavigateAction};
|
package/dist/objector.d.ts
CHANGED
|
@@ -142,7 +142,7 @@ export declare class Objector {
|
|
|
142
142
|
getOutputs(): ObjectorOutput[];
|
|
143
143
|
load<T = any>(fileName: string, alias?: string, cwd?: string): Promise<T | null>;
|
|
144
144
|
merge(source: any, target: any): void;
|
|
145
|
-
writeOutputs(
|
|
145
|
+
writeOutputs(options?: WriteOutputsOption): Promise<void>;
|
|
146
146
|
}
|
|
147
147
|
|
|
148
148
|
declare interface ObjectorOutput {
|
|
@@ -188,4 +188,10 @@ export declare const toObject: <T>(from: any[], key?: string) => T;
|
|
|
188
188
|
|
|
189
189
|
export declare const toObjectWithKey: <T>(from: any[], key?: string) => T;
|
|
190
190
|
|
|
191
|
+
declare interface WriteOutputsOption {
|
|
192
|
+
targetDirectory?: string;
|
|
193
|
+
removeFirst?: boolean;
|
|
194
|
+
writing?: (output: ObjectorOutput) => boolean | undefined | void;
|
|
195
|
+
}
|
|
196
|
+
|
|
191
197
|
export { }
|