@homedev/objector 0.0.20 → 0.0.22
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 +8 -2
- package/package.json +1 -1
package/dist/index.js
CHANGED
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
import
|
|
1
|
+
import v from"path";import L from"fs/promises";import z 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(!z.isAbsolute(T)&&F?.dirs)W.push(...F.dirs);for(let B of W){let I=z.join(B,T);if(await d(I))return z.resolve(I)}throw new Error(`File not found: "${T}"`)})(),M=await L.readFile(C),O=z.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
|
|
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 f=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 f(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 D from"fs/promises";import k from"path";import p from"yaml";import X from"path";var y=(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 r{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(y(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){for(let F of this.getOutputs()){let E=k.join(T??".",F.name),C=k.dirname(E);try{await D.mkdir(C,{recursive:!0})}catch(M){throw new Error(`Failed to created target directory "${C}" for output "${E}": ${M.message}`)}try{switch(F.type){case"yaml":await D.writeFile(E,p.stringify(F.value));break;case"json":await D.writeFile(E,JSON.stringify(F.value));break;default:await D.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,r as Objector,G as NavigateResult,R as NavigateAction};
|
package/dist/objector.d.ts
CHANGED
|
@@ -135,16 +135,22 @@ export declare class Objector {
|
|
|
135
135
|
keys(keys: FieldProcessorMap): this;
|
|
136
136
|
sources(sources: FieldProcessorMap): this;
|
|
137
137
|
variables(vars: Record<string, any>): this;
|
|
138
|
-
output(
|
|
138
|
+
output(o: ObjectorOutput): this;
|
|
139
139
|
defaultProcessors(): this;
|
|
140
140
|
alias(name: string, o: any): this;
|
|
141
141
|
getAlias(name: string): any;
|
|
142
|
-
getOutputs():
|
|
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
145
|
writeOutputs(targetDirectory?: string): Promise<void>;
|
|
146
146
|
}
|
|
147
147
|
|
|
148
|
+
declare interface ObjectorOutput {
|
|
149
|
+
name: string;
|
|
150
|
+
type?: string;
|
|
151
|
+
value: any;
|
|
152
|
+
}
|
|
153
|
+
|
|
148
154
|
/**
|
|
149
155
|
* @public
|
|
150
156
|
* @param root
|