@sprucelabs/spruce-cli 20.0.0 → 20.0.2

package/build/utilities/introspection.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"introspection.utility.js","names":["_lodash","_interopRequireDefault","require","tsutils","_interopRequireWildcard","ts","_getRequireWildcardCache","e","WeakMap","r","t","__esModule","_typeof","has","get","n","__proto__","a","Object","defineProperty","getOwnPropertyDescriptor","u","hasOwnProperty","call","i","set","_createForOfIteratorHelper","o","allowArrayLike","it","Symbol","iterator","Array","isArray","_unsupportedIterableToArray","length","F","s","done","value","_e","f","TypeError","normalCompletion","didErr","err","step","next","_e2","minLen","_arrayLikeToArray","prototype","toString","slice","constructor","name","from","test","arr","len","arr2","serializeSymbol","options","checker","symbol","doc","getName","documentation","displayPartsToString","getDocumentationComment","valueDeclaration","type","typeToString","getTypeOfSymbolAtLocation","serializeSignature","signature","parameters","map","p","returnType","getReturnType","introspectionUtil","introspect","tsFiles","filePaths","program","createProgram","getTypeChecker","introspects","_loop","tsFile","sourceFile","getSourceFile","results","classes","interfaces","_","includes","fileName","forEachChild","node","isClassDeclaration","getSymbolAtLocation","_parentClassSymbol","_parentClassSymbol2","_details$constructors","details","constructorType","parentClassSymbol","heritageClauses","getTypeAtLocation","types","getSymbol","parentClassName","text","parentClassPath","parent","replace","isAbstractClass","isModifierFlagSet","ModifierFlags","Abstract","constructors","getConstructSignatures","push","className","classPath","staticProperties","pluckStaticProperties","optionsInterfaceName","isAbstract","isInterfaceDeclaration","interfaceName","_default","exports","staticProps","_iterator","members","_step","_member$name","_member$initializer","member","escapedText","initializer"],"sources":["../../src/utilities/introspection.utility.ts"],"sourcesContent":["import _ from 'lodash'\nimport * as tsutils from 'tsutils'\nimport * as ts from 'typescript'\n\nexport interface IntrospectionClass {\n\tclassName: string\n\tclassPath: string\n\tparentClassName: string | undefined\n\tparentClassPath: string | undefined\n\toptionsInterfaceName: string | undefined\n\tisAbstract: boolean\n\tstaticProperties: StaticProperties\n}\n\ntype StaticProperties = Record<string, any>\n\ninterface IntrospectionInterface {\n\tinterfaceName: string\n}\n\nexport interface Introspection {\n\tclasses: IntrospectionClass[]\n\tinterfaces: IntrospectionInterface[]\n}\n\ninterface DocEntry {\n\tname?: string\n\tfileName?: string\n\tdocumentation?: string\n\ttype?: string\n\tconstructors?: DocEntry[]\n\tparameters?: DocEntry[]\n\treturnType?: string\n}\n\nconst serializeSymbol = (options: {\n\tchecker: ts.TypeChecker\n\tsymbol: ts.Symbol\n}): DocEntry => {\n\tconst { checker, symbol } = options\n\tconst doc: DocEntry = {\n\t\tname: symbol.getName(),\n\t\tdocumentation: ts.displayPartsToString(\n\t\t\tsymbol.getDocumentationComment(checker)\n\t\t),\n\t}\n\n\tif (symbol.valueDeclaration) {\n\t\tdoc.type = checker.typeToString(\n\t\t\tchecker.getTypeOfSymbolAtLocation(symbol, symbol.valueDeclaration)\n\t\t)\n\t}\n\n\treturn doc\n}\n\nconst serializeSignature = (options: {\n\tchecker: ts.TypeChecker\n\tsignature: ts.Signature\n}) => {\n\tconst { checker, signature } = options\n\treturn {\n\t\tparameters: signature.parameters.map((p) =>\n\t\t\tserializeSymbol({ symbol: p, checker })\n\t\t),\n\t\treturnType: checker.typeToString(signature.getReturnType()),\n\t\tdocumentation: ts.displayPartsToString(\n\t\t\tsignature.getDocumentationComment(checker)\n\t\t),\n\t}\n}\n\nconst introspectionUtil = {\n\tintrospect(tsFiles: string[]): Introspection[] {\n\t\tconst filePaths = tsFiles\n\t\tconst program = ts.createProgram(filePaths, {})\n\t\tconst checker = program.getTypeChecker()\n\n\t\t// for building results\n\t\tconst introspects: Introspection[] = []\n\n\t\tfor (let i = 0; i < filePaths.length; i += 1) {\n\t\t\tconst tsFile = filePaths[i]\n\t\t\tconst sourceFile = program.getSourceFile(tsFile)\n\t\t\tconst results: Introspection = { classes: [], interfaces: [] }\n\t\t\tif (sourceFile && _.includes(filePaths, sourceFile.fileName)) {\n\t\t\t\tts.forEachChild(sourceFile, (node) => {\n\t\t\t\t\t// if this is a class declaration\n\t\t\t\t\tif (ts.isClassDeclaration(node) && node.name) {\n\t\t\t\t\t\tconst symbol = checker.getSymbolAtLocation(node.name)\n\n\t\t\t\t\t\tif (symbol?.valueDeclaration) {\n\t\t\t\t\t\t\tconst details = serializeSymbol({ checker, symbol })\n\t\t\t\t\t\t\t// Get the construct signatures\n\t\t\t\t\t\t\tconst constructorType = checker.getTypeOfSymbolAtLocation(\n\t\t\t\t\t\t\t\tsymbol,\n\t\t\t\t\t\t\t\tsymbol.valueDeclaration\n\t\t\t\t\t\t\t)\n\n\t\t\t\t\t\t\tlet parentClassSymbol: ts.Symbol | undefined\n\t\t\t\t\t\t\tif (node.heritageClauses && node.heritageClauses[0]) {\n\t\t\t\t\t\t\t\tparentClassSymbol = checker\n\t\t\t\t\t\t\t\t\t.getTypeAtLocation(node.heritageClauses[0].types[0])\n\t\t\t\t\t\t\t\t\t.getSymbol()\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\tconst parentClassName =\n\t\t\t\t\t\t\t\t// @ts-ignore\n\t\t\t\t\t\t\t\tparentClassSymbol?.valueDeclaration?.name?.text\n\t\t\t\t\t\t\t// @ts-ignore\n\t\t\t\t\t\t\tconst parentClassPath = parentClassSymbol?.parent\n\t\t\t\t\t\t\t\t?.getName()\n\t\t\t\t\t\t\t\t.replace('\"', '')\n\n\t\t\t\t\t\t\tconst isAbstractClass = tsutils.isModifierFlagSet(\n\t\t\t\t\t\t\t\tnode,\n\t\t\t\t\t\t\t\tts.ModifierFlags.Abstract\n\t\t\t\t\t\t\t)\n\t\t\t\t\t\t\tdetails.constructors = constructorType\n\t\t\t\t\t\t\t\t.getConstructSignatures()\n\t\t\t\t\t\t\t\t.map((s) => serializeSignature({ signature: s, checker }))\n\n\t\t\t\t\t\t\tresults.classes.push({\n\t\t\t\t\t\t\t\tclassName: node.name.text,\n\t\t\t\t\t\t\t\tclassPath: sourceFile.fileName,\n\t\t\t\t\t\t\t\tparentClassName,\n\t\t\t\t\t\t\t\tparentClassPath,\n\t\t\t\t\t\t\t\tstaticProperties: pluckStaticProperties(node),\n\t\t\t\t\t\t\t\toptionsInterfaceName:\n\t\t\t\t\t\t\t\t\tdetails.constructors?.[0].parameters?.[0]?.type,\n\t\t\t\t\t\t\t\tisAbstract: isAbstractClass,\n\t\t\t\t\t\t\t})\n\t\t\t\t\t\t}\n\t\t\t\t\t} else if (ts.isInterfaceDeclaration(node)) {\n\t\t\t\t\t\tresults.interfaces.push({\n\t\t\t\t\t\t\tinterfaceName: node.name.text,\n\t\t\t\t\t\t})\n\t\t\t\t\t}\n\t\t\t\t})\n\t\t\t}\n\n\t\t\tintrospects.push(results)\n\t\t}\n\n\t\treturn introspects\n\t},\n}\n\nexport default introspectionUtil\n\nfunction pluckStaticProperties(node: ts.ClassDeclaration): StaticProperties {\n\tconst staticProps: StaticProperties = {}\n\n\tfor (const member of node.members) {\n\t\t//@ts-ignore\n\t\tconst name = member.name?.escapedText\n\t\t//@ts-ignore\n\t\tconst value = member.initializer?.text\n\n\t\tif (name && value) {\n\t\t\tstaticProps[name] = value\n\t\t}\n\t}\n\n\treturn staticProps\n}\n"],"mappings":";;;;;;;;AAAA,IAAAA,OAAA,GAAAC,sBAAA,CAAAC,OAAA;AACA,IAAAC,OAAA,GAAAC,uBAAA,CAAAF,OAAA;AACA,IAAAG,EAAA,GAAAD,uBAAA,CAAAF,OAAA;AAAgC,SAAAI,yBAAAC,CAAA,6BAAAC,OAAA,mBAAAC,CAAA,OAAAD,OAAA,IAAAE,CAAA,OAAAF,OAAA,YAAAF,wBAAA,YAAAA,yBAAAC,CAAA,WAAAA,CAAA,GAAAG,CAAA,GAAAD,CAAA,KAAAF,CAAA;AAAA,SAAAH,wBAAAG,CAAA,EAAAE,CAAA,SAAAA,CAAA,IAAAF,CAAA,IAAAA,CAAA,CAAAI,UAAA,SAAAJ,CAAA,eAAAA,CAAA,gBAAAK,OAAA,CAAAL,CAAA,0BAAAA,CAAA,sBAAAA,CAAA,QAAAG,CAAA,GAAAJ,wBAAA,CAAAG,CAAA,OAAAC,CAAA,IAAAA,CAAA,CAAAG,GAAA,CAAAN,CAAA,UAAAG,CAAA,CAAAI,GAAA,CAAAP,CAAA,OAAAQ,CAAA,KAAAC,SAAA,UAAAC,CAAA,GAAAC,MAAA,CAAAC,cAAA,IAAAD,MAAA,CAAAE,wBAAA,WAAAC,CAAA,IAAAd,CAAA,oBAAAc,CAAA,OAAAC,cAAA,CAAAC,IAAA,CAAAhB,CAAA,EAAAc,CAAA,SAAAG,CAAA,GAAAP,CAAA,GAAAC,MAAA,CAAAE,wBAAA,CAAAb,CAAA,EAAAc,CAAA,UAAAG,CAAA,KAAAA,CAAA,CAAAV,GAAA,IAAAU,CAAA,CAAAC,GAAA,IAAAP,MAAA,CAAAC,cAAA,CAAAJ,CAAA,EAAAM,CAAA,EAAAG,CAAA,IAAAT,CAAA,CAAAM,CAAA,IAAAd,CAAA,CAAAc,CAAA,YAAAN,CAAA,cAAAR,CAAA,EAAAG,CAAA,IAAAA,CAAA,CAAAe,GAAA,CAAAlB,CAAA,EAAAQ,CAAA,GAAAA,CAAA;AAAA,SAAAW,2BAAAC,CAAA,EAAAC,cAAA,QAAAC,EAAA,UAAAC,MAAA,oBAAAH,CAAA,CAAAG,MAAA,CAAAC,QAAA,KAAAJ,CAAA,qBAAAE,EAAA,QAAAG,KAAA,CAAAC,OAAA,CAAAN,CAAA,MAAAE,EAAA,GAAAK,2BAAA,CAAAP,CAAA,MAAAC,cAAA,IAAAD,CAAA,WAAAA,CAAA,CAAAQ,MAAA,qBAAAN,EAAA,EAAAF,CAAA,GAAAE,EAAA,MAAAL,CAAA,UAAAY,CAAA,YAAAA,EAAA,eAAAC,CAAA,EAAAD,CAAA,EAAArB,CAAA,WAAAA,EAAA,QAAAS,CAAA,IAAAG,CAAA,CAAAQ,MAAA,WAAAG,IAAA,mBAAAA,IAAA,SAAAC,KAAA,EAAAZ,CAAA,CAAAH,CAAA,UAAAjB,CAAA,WAAAA,EAAAiC,EAAA,UAAAA,EAAA,KAAAC,CAAA,EAAAL,CAAA,gBAAAM,SAAA,iJAAAC,gBAAA,SAAAC,MAAA,UAAAC,GAAA,WAAAR,CAAA,WAAAA,EAAA,IAAAR,EAAA,GAAAA,EAAA,CAAAN,IAAA,CAAAI,CAAA,MAAAZ,CAAA,WAAAA,EAAA,QAAA+B,IAAA,GAAAjB,EAAA,CAAAkB,IAAA,IAAAJ,gBAAA,GAAAG,IAAA,CAAAR,IAAA,SAAAQ,IAAA,KAAAvC,CAAA,WAAAA,EAAAyC,GAAA,IAAAJ,MAAA,SAAAC,GAAA,GAAAG,GAAA,KAAAP,CAAA,WAAAA,EAAA,eAAAE,gBAAA,IAAAd,EAAA,oBAAAA,EAAA,8BAAAe,MAAA,QAAAC,GAAA;AAAA,SAAAX,4BAAAP,CAAA,EAAAsB,MAAA,SAAAtB,CAAA,qBAAAA,CAAA,sBAAAuB,iBAAA,CAAAvB,CAAA,EAAAsB,MAAA,OAAAlC,CAAA,GAAAG,MAAA,CAAAiC,SAAA,CAAAC,QAAA,CAAA7B,IAAA,CAAAI,CAAA,EAAA0B,KAAA,aAAAtC,CAAA,iBAAAY,CAAA,CAAA2B,WAAA,EAAAvC,CAAA,GAAAY,CAAA,CAAA2B,WAAA,CAAAC,IAAA,MAAAxC,CAAA,cAAAA,CAAA,mBAAAiB,KAAA,CAAAwB,IAAA,CAAA7B,CAAA,OAAAZ,CAAA,+DAAA0C,IAAA,CAAA1C,CAAA,UAAAmC,iBAAA,CAAAvB,CAAA,EAAAsB,MAAA;AAAA,SAAAC,kBAAAQ,GAAA,EAAAC,GAAA,QAAAA,GAAA,YAAAA,GAAA,GAAAD,GAAA,CAAAvB,MAAA,EAAAwB,GAAA,GAAAD,GAAA,CAAAvB,MAAA,WAAAX,CAAA,MAAAoC,IAAA,OAAA5B,KAAA,CAAA2B,GAAA,GAAAnC,CAAA,GAAAmC,GAAA,EAAAnC,CAAA,IAAAoC,IAAA,CAAApC,CAAA,IAAAkC,GAAA,CAAAlC,CAAA,UAAAoC,IAAA;AAiChC,IAAMC,eAAe,GAAG,SAAlBA,eAAeA,CAAIC,OAGxB,EAAe;EACf,IAAQC,OAAO,GAAaD,OAAO,CAA3BC,OAAO;IAAEC,MAAM,GAAKF,OAAO,CAAlBE,MAAM;EACvB,IAAMC,GAAa,GAAG;IACrBV,IAAI,EAAES,MAAM,CAACE,OAAO,CAAC,CAAC;IACtBC,aAAa,EAAE9D,EAAE,CAAC+D,oBAAoB,CACrCJ,MAAM,CAACK,uBAAuB,CAACN,OAAO,CACvC;EACD,CAAC;EAED,IAAIC,MAAM,CAACM,gBAAgB,EAAE;IAC5BL,GAAG,CAACM,IAAI,GAAGR,OAAO,CAACS,YAAY,CAC9BT,OAAO,CAACU,yBAAyB,CAACT,MAAM,EAAEA,MAAM,CAACM,gBAAgB,CAClE,CAAC;EACF;EAEA,OAAOL,GAAG;AACX,CAAC;AAED,IAAMS,kBAAkB,GAAG,SAArBA,kBAAkBA,CAAIZ,OAG3B,EAAK;EACL,IAAQC,OAAO,GAAgBD,OAAO,CAA9BC,OAAO;IAAEY,SAAS,GAAKb,OAAO,CAArBa,SAAS;EAC1B,OAAO;IACNC,UAAU,EAAED,SAAS,CAACC,UAAU,CAACC,GAAG,CAAC,UAACC,CAAC;MAAA,OACtCjB,eAAe,CAAC;QAAEG,MAAM,EAAEc,CAAC;QAAEf,OAAO,EAAPA;MAAQ,CAAC,CAAC;IAAA,CACxC,CAAC;IACDgB,UAAU,EAAEhB,OAAO,CAACS,YAAY,CAACG,SAAS,CAACK,aAAa,CAAC,CAAC,CAAC;IAC3Db,aAAa,EAAE9D,EAAE,CAAC+D,oBAAoB,CACrCO,SAAS,CAACN,uBAAuB,CAACN,OAAO,CAC1C;EACD,CAAC;AACF,CAAC;AAED,IAAMkB,iBAAiB,GAAG;EACzBC,UAAU,WAAAA,WAACC,OAAiB,EAAmB;IAC9C,IAAMC,SAAS,GAAGD,OAAO;IACzB,IAAME,OAAO,GAAGhF,EAAE,CAACiF,aAAa,CAACF,SAAS,EAAE,CAAC,CAAC,CAAC;IAC/C,IAAMrB,OAAO,GAAGsB,OAAO,CAACE,cAAc,CAAC,CAAC;;IAExC;IACA,IAAMC,WAA4B,GAAG,EAAE;IAAA,IAAAC,KAAA,YAAAA,MAAA,EAEO;MAC7C,IAAMC,MAAM,GAAGN,SAAS,CAAC5D,CAAC,CAAC;MAC3B,IAAMmE,UAAU,GAAGN,OAAO,CAACO,aAAa,CAACF,MAAM,CAAC;MAChD,IAAMG,OAAsB,GAAG;QAAEC,OAAO,EAAE,EAAE;QAAEC,UAAU,EAAE;MAAG,CAAC;MAC9D,IAAIJ,UAAU,IAAIK,kBAAC,CAACC,QAAQ,CAACb,SAAS,EAAEO,UAAU,CAACO,QAAQ,CAAC,EAAE;QAC7D7F,EAAE,CAAC8F,YAAY,CAACR,UAAU,EAAE,UAACS,IAAI,EAAK;UACrC;UACA,IAAI/F,EAAE,CAACgG,kBAAkB,CAACD,IAAI,CAAC,IAAIA,IAAI,CAAC7C,IAAI,EAAE;YAC7C,IAAMS,MAAM,GAAGD,OAAO,CAACuC,mBAAmB,CAACF,IAAI,CAAC7C,IAAI,CAAC;YAErD,IAAIS,MAAM,aAANA,MAAM,eAANA,MAAM,CAAEM,gBAAgB,EAAE;cAAA,IAAAiC,kBAAA,EAAAC,mBAAA,EAAAC,qBAAA;cAC7B,IAAMC,OAAO,GAAG7C,eAAe,CAAC;gBAAEE,OAAO,EAAPA,OAAO;gBAAEC,MAAM,EAANA;cAAO,CAAC,CAAC;cACpD;cACA,IAAM2C,eAAe,GAAG5C,OAAO,CAACU,yBAAyB,CACxDT,MAAM,EACNA,MAAM,CAACM,gBACR,CAAC;cAED,IAAIsC,iBAAwC;cAC5C,IAAIR,IAAI,CAACS,eAAe,IAAIT,IAAI,CAACS,eAAe,CAAC,CAAC,CAAC,EAAE;gBACpDD,iBAAiB,GAAG7C,OAAO,CACzB+C,iBAAiB,CAACV,IAAI,CAACS,eAAe,CAAC,CAAC,CAAC,CAACE,KAAK,CAAC,CAAC,CAAC,CAAC,CACnDC,SAAS,CAAC,CAAC;cACd;cAEA,IAAMC,eAAe,GACpB;cAAA,CAAAV,kBAAA,GACAK,iBAAiB,cAAAL,kBAAA,gBAAAA,kBAAA,GAAjBA,kBAAA,CAAmBjC,gBAAgB,cAAAiC,kBAAA,gBAAAA,kBAAA,GAAnCA,kBAAA,CAAqChD,IAAI,cAAAgD,kBAAA,uBAAzCA,kBAAA,CAA2CW,IAAI;cAChD;cACA,IAAMC,eAAe,IAAAX,mBAAA,GAAGI,iBAAiB,cAAAJ,mBAAA,gBAAAA,mBAAA,GAAjBA,mBAAA,CAAmBY,MAAM,cAAAZ,mBAAA,uBAAzBA,mBAAA,CACrBtC,OAAO,CAAC,CAAC,CACVmD,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC;cAElB,IAAMC,eAAe,GAAGnH,OAAO,CAACoH,iBAAiB,CAChDnB,IAAI,EACJ/F,EAAE,CAACmH,aAAa,CAACC,QAClB,CAAC;cACDf,OAAO,CAACgB,YAAY,GAAGf,eAAe,CACpCgB,sBAAsB,CAAC,CAAC,CACxB9C,GAAG,CAAC,UAACxC,CAAC;gBAAA,OAAKqC,kBAAkB,CAAC;kBAAEC,SAAS,EAAEtC,CAAC;kBAAE0B,OAAO,EAAPA;gBAAQ,CAAC,CAAC;cAAA,EAAC;cAE3D8B,OAAO,CAACC,OAAO,CAAC8B,IAAI,CAAC;gBACpBC,SAAS,EAAEzB,IAAI,CAAC7C,IAAI,CAAC2D,IAAI;gBACzBY,SAAS,EAAEnC,UAAU,CAACO,QAAQ;gBAC9Be,eAAe,EAAfA,eAAe;gBACfE,eAAe,EAAfA,eAAe;gBACfY,gBAAgB,EAAEC,qBAAqB,CAAC5B,IAAI,CAAC;gBAC7C6B,oBAAoB,GAAAxB,qBAAA,GACnBC,OAAO,CAACgB,YAAY,cAAAjB,qBAAA,gBAAAA,qBAAA,GAApBA,qBAAA,CAAuB,CAAC,CAAC,CAAC7B,UAAU,cAAA6B,qBAAA,gBAAAA,qBAAA,GAApCA,qBAAA,CAAuC,CAAC,CAAC,cAAAA,qBAAA,uBAAzCA,qBAAA,CAA2ClC,IAAI;gBAChD2D,UAAU,EAAEZ;cACb,CAAC,CAAC;YACH;UACD,CAAC,MAAM,IAAIjH,EAAE,CAAC8H,sBAAsB,CAAC/B,IAAI,CAAC,EAAE;YAC3CP,OAAO,CAACE,UAAU,CAAC6B,IAAI,CAAC;cACvBQ,aAAa,EAAEhC,IAAI,CAAC7C,IAAI,CAAC2D;YAC1B,CAAC,CAAC;UACH;QACD,CAAC,CAAC;MACH;MAEA1B,WAAW,CAACoC,IAAI,CAAC/B,OAAO,CAAC;IAC1B,CAAC;IA7DD,KAAK,IAAIrE,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAG4D,SAAS,CAACjD,MAAM,EAAEX,CAAC,IAAI,CAAC;MAAAiE,KAAA;IAAA;IA+D5C,OAAOD,WAAW;EACnB;AACD,CAAC;AAAA,IAAA6C,QAAA,GAAAC,OAAA,cAEcrD,iBAAiB;AAEhC,SAAS+C,qBAAqBA,CAAC5B,IAAyB,EAAoB;EAC3E,IAAMmC,WAA6B,GAAG,CAAC,CAAC;EAAA,IAAAC,SAAA,GAAA9G,0BAAA,CAEnB0E,IAAI,CAACqC,OAAO;IAAAC,KAAA;EAAA;IAAjC,KAAAF,SAAA,CAAAnG,CAAA,MAAAqG,KAAA,GAAAF,SAAA,CAAAzH,CAAA,IAAAuB,IAAA,GAAmC;MAAA,IAAAqG,YAAA,EAAAC,mBAAA;MAAA,IAAxBC,MAAM,GAAAH,KAAA,CAAAnG,KAAA;MAChB;MACA,IAAMgB,IAAI,IAAAoF,YAAA,GAAGE,MAAM,CAACtF,IAAI,cAAAoF,YAAA,uBAAXA,YAAA,CAAaG,WAAW;MACrC;MACA,IAAMvG,KAAK,IAAAqG,mBAAA,GAAGC,MAAM,CAACE,WAAW,cAAAH,mBAAA,uBAAlBA,mBAAA,CAAoB1B,IAAI;MAEtC,IAAI3D,IAAI,IAAIhB,KAAK,EAAE;QAClBgG,WAAW,CAAChF,IAAI,CAAC,GAAGhB,KAAK;MAC1B;IACD;EAAC,SAAAM,GAAA;IAAA2F,SAAA,CAAAjI,CAAA,CAAAsC,GAAA;EAAA;IAAA2F,SAAA,CAAA/F,CAAA;EAAA;EAED,OAAO8F,WAAW;AACnB","ignoreList":[]}
+{"version":3,"file":"introspection.utility.js","names":["_path","require","_spruceSkillUtils","_lodash","_interopRequireDefault","tsutils","_interopRequireWildcard","ts","_getRequireWildcardCache","e","WeakMap","r","t","__esModule","_typeof","has","get","n","__proto__","a","Object","defineProperty","getOwnPropertyDescriptor","u","hasOwnProperty","call","i","set","_createForOfIteratorHelper","o","allowArrayLike","it","Symbol","iterator","Array","isArray","_unsupportedIterableToArray","length","F","s","done","value","_e","f","TypeError","normalCompletion","didErr","err","step","next","_e2","minLen","_arrayLikeToArray","prototype","toString","slice","constructor","name","from","test","arr","len","arr2","serializeSymbol","options","checker","symbol","doc","getName","documentation","displayPartsToString","getDocumentationComment","valueDeclaration","type","typeToString","getTypeOfSymbolAtLocation","serializeSignature","signature","parameters","map","p","returnType","getReturnType","introspectionUtil","introspect","tsFiles","_this","filePaths","program","createProgram","getTypeChecker","introspects","_loop","tsFile","sourceFile","getSourceFile","results","classes","interfaces","_","includes","fileName","hasClassDefinition","exports","getExports","firstExport","declaration","getClassDeclarationFromImportedFile","dirname","_results$classes","_results$interfaces","_getDeclarationsFromN","getDeclarationsFromNode","push","apply","_toConsumableArray2","_firstExport$exportCl","className","exportClause","elements","propertyName","text","classPath","isAbstract","optionsInterfaceName","undefined","parentClassName","parentClassPath","staticProperties","forEachChild","node","_results$classes2","_results$interfaces2","_getDeclarationsFromN2","traverse","isExportDeclaration","exportDeclaration","dirName","isNamedExports","_iterator","_step","_loop2","element","moduleSpecifier","diskUtil","resolveFile","replace","v","declarationSourceFile","isClassDeclaration","_iterator2","getChildren","_step2","child","result","_ret","hasClass","_default","getSymbolAtLocation","_parentClassSymbol","_parentClassSymbol2","_details$constructors","details","constructorType","parentClassSymbol","heritageClauses","getTypeAtLocation","types","getSymbol","parent","isAbstractClass","isModifierFlagSet","ModifierFlags","Abstract","constructors","getConstructSignatures","pluckStaticProperties","isInterfaceDeclaration","interfaceName","staticProps","_iterator3","members","_step3","_member$name","_member$initializer","member","escapedText","initializer"],"sources":["../../src/utilities/introspection.utility.ts"],"sourcesContent":["import { dirname } from 'path'\nimport { diskUtil } from '@sprucelabs/spruce-skill-utils'\nimport _ from 'lodash'\nimport * as tsutils from 'tsutils'\nimport * as ts from 'typescript'\n\nconst serializeSymbol = (options: {\n\tchecker: ts.TypeChecker\n\tsymbol: ts.Symbol\n}): DocEntry => {\n\tconst { checker, symbol } = options\n\tconst doc: DocEntry = {\n\t\tname: symbol.getName(),\n\t\tdocumentation: ts.displayPartsToString(\n\t\t\tsymbol.getDocumentationComment(checker)\n\t\t),\n\t}\n\n\tif (symbol.valueDeclaration) {\n\t\tdoc.type = checker.typeToString(\n\t\t\tchecker.getTypeOfSymbolAtLocation(symbol, symbol.valueDeclaration)\n\t\t)\n\t}\n\n\treturn doc\n}\n\nconst serializeSignature = (options: {\n\tchecker: ts.TypeChecker\n\tsignature: ts.Signature\n}) => {\n\tconst { checker, signature } = options\n\treturn {\n\t\tparameters: signature.parameters.map((p) =>\n\t\t\tserializeSymbol({ symbol: p, checker })\n\t\t),\n\t\treturnType: checker.typeToString(signature.getReturnType()),\n\t\tdocumentation: ts.displayPartsToString(\n\t\t\tsignature.getDocumentationComment(checker)\n\t\t),\n\t}\n}\n\nconst introspectionUtil = {\n\tintrospect(tsFiles: string[]): Introspection[] {\n\t\tconst filePaths = tsFiles\n\t\tconst program = ts.createProgram(filePaths, {})\n\t\tconst checker = program.getTypeChecker()\n\n\t\t// for building results\n\t\tconst introspects: Introspection[] = []\n\n\t\tfor (let i = 0; i < filePaths.length; i += 1) {\n\t\t\tconst tsFile = filePaths[i]\n\t\t\tconst sourceFile = program.getSourceFile(tsFile)\n\t\t\tconst results: Introspection = { classes: [], interfaces: [] }\n\t\t\tif (sourceFile && _.includes(filePaths, sourceFile.fileName)) {\n\t\t\t\tif (!this.hasClassDefinition(sourceFile)) {\n\t\t\t\t\tconst exports = this.getExports(sourceFile)\n\t\t\t\t\tconst firstExport = exports[0]\n\t\t\t\t\tif (firstExport) {\n\t\t\t\t\t\tconst declaration = this.getClassDeclarationFromImportedFile(\n\t\t\t\t\t\t\tfirstExport,\n\t\t\t\t\t\t\tdirname(tsFile),\n\t\t\t\t\t\t\tprogram\n\t\t\t\t\t\t)\n\n\t\t\t\t\t\tif (declaration) {\n\t\t\t\t\t\t\tconst { classes, interfaces } = getDeclarationsFromNode(\n\t\t\t\t\t\t\t\tdeclaration,\n\t\t\t\t\t\t\t\tchecker,\n\t\t\t\t\t\t\t\tsourceFile\n\t\t\t\t\t\t\t)\n\t\t\t\t\t\t\tresults.classes.push(...classes)\n\t\t\t\t\t\t\tresults.interfaces.push(...interfaces)\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t// must have imported from somewhere else (another node module)\n\t\t\t\t\t\t\tconst className = //@ts-ignore\n\t\t\t\t\t\t\t\tfirstExport.exportClause?.elements?.[0]?.propertyName?.text\n\n\t\t\t\t\t\t\tif (className) {\n\t\t\t\t\t\t\t\tresults.classes.push({\n\t\t\t\t\t\t\t\t\tclassName,\n\t\t\t\t\t\t\t\t\tclassPath: tsFile,\n\t\t\t\t\t\t\t\t\tisAbstract: false,\n\t\t\t\t\t\t\t\t\toptionsInterfaceName: undefined,\n\t\t\t\t\t\t\t\t\tparentClassName: undefined,\n\t\t\t\t\t\t\t\t\tparentClassPath: undefined,\n\t\t\t\t\t\t\t\t\tstaticProperties: {},\n\t\t\t\t\t\t\t\t})\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t} else {\n\t\t\t\t\tts.forEachChild(sourceFile, (node) => {\n\t\t\t\t\t\tconst { classes, interfaces } = getDeclarationsFromNode(\n\t\t\t\t\t\t\tnode,\n\t\t\t\t\t\t\tchecker,\n\t\t\t\t\t\t\tsourceFile\n\t\t\t\t\t\t)\n\n\t\t\t\t\t\tresults.classes.push(...classes)\n\t\t\t\t\t\tresults.interfaces.push(...interfaces)\n\t\t\t\t\t})\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tintrospects.push(results)\n\t\t}\n\n\t\treturn introspects\n\t},\n\n\tgetExports(sourceFile: ts.SourceFile): ts.Node[] {\n\t\tconst exports: ts.Node[] = []\n\n\t\tconst traverse = (node: ts.Node) => {\n\t\t\tif (ts.isExportDeclaration(node)) {\n\t\t\t\texports.push(node)\n\t\t\t}\n\n\t\t\tts.forEachChild(node, traverse)\n\t\t}\n\n\t\ttraverse(sourceFile)\n\n\t\treturn exports\n\t},\n\n\tgetClassDeclarationFromImportedFile(\n\t\texportDeclaration: ts.Node,\n\t\tdirName: string,\n\t\tprogram: ts.Program\n\t): ts.ClassDeclaration | undefined {\n\t\tif (!ts.isExportDeclaration(exportDeclaration)) {\n\t\t\treturn undefined\n\t\t}\n\n\t\tconst exportClause = exportDeclaration.exportClause\n\t\tif (!exportClause || !ts.isNamedExports(exportClause)) {\n\t\t\treturn undefined\n\t\t}\n\n\t\tfor (const element of exportClause.elements) {\n\t\t\tif (element.propertyName) {\n\t\t\t\tconst propertyName = element.propertyName.text\n\t\t\t\tconst moduleSpecifier = (\n\t\t\t\t\texportDeclaration.moduleSpecifier as ts.StringLiteral\n\t\t\t\t).text\n\n\t\t\t\tconst sourceFile = diskUtil.resolveFile(\n\t\t\t\t\tdirName,\n\t\t\t\t\tmoduleSpecifier.replace(/^\\.\\//, '')\n\t\t\t\t)\n\n\t\t\t\tif (!sourceFile) {\n\t\t\t\t\treturn undefined\n\t\t\t\t}\n\n\t\t\t\t// Load the source file containing the class declaration\n\t\t\t\tconst declarationSourceFile = program.getSourceFile(sourceFile)\n\t\t\t\tif (!declarationSourceFile) {\n\t\t\t\t\treturn undefined\n\t\t\t\t}\n\n\t\t\t\tconst traverse = (node: ts.Node): ts.ClassDeclaration | undefined => {\n\t\t\t\t\tif (\n\t\t\t\t\t\tts.isClassDeclaration(node) &&\n\t\t\t\t\t\tnode.name &&\n\t\t\t\t\t\tnode.name.text === propertyName\n\t\t\t\t\t) {\n\t\t\t\t\t\treturn node\n\t\t\t\t\t}\n\n\t\t\t\t\tfor (const child of node.getChildren(declarationSourceFile)) {\n\t\t\t\t\t\tconst result = traverse(child)\n\t\t\t\t\t\tif (result) {\n\t\t\t\t\t\t\treturn result\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\treturn undefined\n\t\t\t\t}\n\n\t\t\t\treturn traverse(declarationSourceFile)\n\t\t\t}\n\t\t}\n\n\t\treturn undefined\n\t},\n\n\thasClassDefinition(sourceFile: ts.SourceFile): boolean {\n\t\tlet hasClass = false\n\n\t\tconst traverse = (node: ts.Node) => {\n\t\t\tif (ts.isClassDeclaration(node)) {\n\t\t\t\thasClass = true\n\t\t\t}\n\n\t\t\tif (!hasClass) {\n\t\t\t\tts.forEachChild(node, traverse)\n\t\t\t}\n\t\t}\n\n\t\ttraverse(sourceFile)\n\n\t\treturn hasClass\n\t},\n}\n\nexport default introspectionUtil\n\nfunction getDeclarationsFromNode(\n\tnode: ts.Node,\n\tchecker: ts.TypeChecker,\n\tsourceFile: ts.SourceFile\n) {\n\tconst classes: IntrospectionClass[] = []\n\tconst interfaces: IntrospectionInterface[] = []\n\n\t// if this is a class declaration\n\tif (ts.isClassDeclaration(node) && node.name) {\n\t\tconst symbol = checker.getSymbolAtLocation(node.name)\n\n\t\tif (symbol?.valueDeclaration) {\n\t\t\tconst details = serializeSymbol({ checker, symbol })\n\t\t\t// Get the construct signatures\n\t\t\tconst constructorType = checker.getTypeOfSymbolAtLocation(\n\t\t\t\tsymbol,\n\t\t\t\tsymbol.valueDeclaration\n\t\t\t)\n\n\t\t\tlet parentClassSymbol: ts.Symbol | undefined\n\t\t\tif (node.heritageClauses && node.heritageClauses[0]) {\n\t\t\t\tparentClassSymbol = checker\n\t\t\t\t\t.getTypeAtLocation(node.heritageClauses[0].types[0])\n\t\t\t\t\t.getSymbol()\n\t\t\t}\n\n\t\t\tconst parentClassName =\n\t\t\t\t// @ts-ignore\n\t\t\t\tparentClassSymbol?.valueDeclaration?.name?.text\n\t\t\t// @ts-ignore\n\t\t\tconst parentClassPath = parentClassSymbol?.parent\n\t\t\t\t?.getName()\n\t\t\t\t.replace('\"', '')\n\n\t\t\tconst isAbstractClass = tsutils.isModifierFlagSet(\n\t\t\t\tnode,\n\t\t\t\tts.ModifierFlags.Abstract\n\t\t\t)\n\t\t\tdetails.constructors = constructorType\n\t\t\t\t.getConstructSignatures()\n\t\t\t\t.map((s) => serializeSignature({ signature: s, checker }))\n\n\t\t\tclasses.push({\n\t\t\t\tclassName: node.name.text,\n\t\t\t\tclassPath: sourceFile.fileName,\n\t\t\t\tparentClassName,\n\t\t\t\tparentClassPath,\n\t\t\t\tstaticProperties: pluckStaticProperties(node),\n\t\t\t\toptionsInterfaceName: details.constructors?.[0].parameters?.[0]?.type,\n\t\t\t\tisAbstract: isAbstractClass,\n\t\t\t})\n\t\t}\n\t} else if (ts.isInterfaceDeclaration(node)) {\n\t\tinterfaces.push({\n\t\t\tinterfaceName: node.name.text,\n\t\t})\n\t}\n\treturn { classes, interfaces }\n}\n\nfunction pluckStaticProperties(node: ts.ClassDeclaration): StaticProperties {\n\tconst staticProps: StaticProperties = {}\n\n\tfor (const member of node.members) {\n\t\t//@ts-ignore\n\t\tconst name = member.name?.escapedText\n\t\t//@ts-ignore\n\t\tconst value = member.initializer?.text\n\n\t\tif (name && value) {\n\t\t\tstaticProps[name] = value\n\t\t}\n\t}\n\n\treturn staticProps\n}\n\nexport interface IntrospectionClass {\n\tclassName: string\n\tclassPath: string\n\tparentClassName: string | undefined\n\tparentClassPath: string | undefined\n\toptionsInterfaceName: string | undefined\n\tisAbstract: boolean\n\tstaticProperties: StaticProperties\n}\n\ntype StaticProperties = Record<string, any>\n\ninterface IntrospectionInterface {\n\tinterfaceName: string\n}\n\nexport interface Introspection {\n\tclasses: IntrospectionClass[]\n\tinterfaces: IntrospectionInterface[]\n}\n\ninterface DocEntry {\n\tname?: string\n\tfileName?: string\n\tdocumentation?: string\n\ttype?: string\n\tconstructors?: DocEntry[]\n\tparameters?: DocEntry[]\n\treturnType?: string\n}\n"],"mappings":"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","ignoreList":[]}

package/package.json

@@ -17,7 +17,7 @@
     ]
   },
   "license": "MIT",
-  "version": "20.0.0",
+  "version": "20.0.2",
   "bin": {
     "spruce": "./build/index.js"
   },
@@ -75,24 +75,24 @@
     "@babel/plugin-proposal-decorators": "^7.24.1",
     "@babel/runtime": "^7.24.1",
     "@jest/reporters": "^29.7.0",
-    "@sprucelabs/error": "^5.1.79",
-    "@sprucelabs/globby": "^1.0.21",
-    "@sprucelabs/heartwood-view-controllers": "^109.5.0",
-    "@sprucelabs/jest-json-reporter": "^7.0.186",
-    "@sprucelabs/mercury-client": "^41.0.346",
-    "@sprucelabs/mercury-event-emitter": "^41.0.346",
-    "@sprucelabs/mercury-types": "^46.0.266",
-    "@sprucelabs/schema": "^29.4.28",
-    "@sprucelabs/spruce-core-schemas": "^39.0.262",
-    "@sprucelabs/spruce-event-utils": "^38.1.6",
-    "@sprucelabs/spruce-skill-utils": "^30.3.24",
-    "@sprucelabs/spruce-templates": "^20.0.0",
+    "@sprucelabs/error": "^5.1.89",
+    "@sprucelabs/globby": "^1.0.22",
+    "@sprucelabs/heartwood-view-controllers": "^109.7.12",
+    "@sprucelabs/jest-json-reporter": "^7.0.193",
+    "@sprucelabs/mercury-client": "^41.0.360",
+    "@sprucelabs/mercury-event-emitter": "^41.0.360",
+    "@sprucelabs/mercury-types": "^46.0.278",
+    "@sprucelabs/schema": "^29.4.38",
+    "@sprucelabs/spruce-core-schemas": "^39.0.272",
+    "@sprucelabs/spruce-event-utils": "^38.1.18",
+    "@sprucelabs/spruce-skill-utils": "^30.4.4",
+    "@sprucelabs/spruce-templates": "^20.0.2",
     "@typescript-eslint/eslint-plugin": "^5.27.1",
     "@typescript-eslint/parser": "^5.27.1",
     "cfonts": "^3.2.0",
     "chalk": "4.1.2",
     "chokidar": "^3.6.0",
-    "cli-table3": "^0.6.3",
+    "cli-table3": "^0.6.4",
     "commander": "7.2.0",
     "emphasize": "4.2.0",
     "fs-extra": "^11.2.0",
@@ -109,20 +109,20 @@
     "terminal-kit": "sprucelabsai/terminal-kit",
     "tree-kill": "^1.2.2",
     "tsutils": "^3.21.0",
-    "typescript": "^5.4.2",
+    "typescript": "^5.4.3",
     "uuid": "^9.0.1"
   },
   "devDependencies": {
-    "@sprucelabs/data-stores": "^26.4.56",
+    "@sprucelabs/data-stores": "^26.4.67",
     "@sprucelabs/jest-sheets-reporter": "^3.0.26",
-    "@sprucelabs/mercury-core-events": "^22.2.50",
-    "@sprucelabs/resolve-path-aliases": "^1.1.290",
-    "@sprucelabs/spruce-conversation-plugin": "^60.1.301",
-    "@sprucelabs/spruce-deploy-plugin": "^60.1.301",
-    "@sprucelabs/spruce-store-plugin": "^60.1.301",
-    "@sprucelabs/spruce-test-fixtures": "^60.1.301",
-    "@sprucelabs/test": "^8.0.44",
-    "@sprucelabs/test-utils": "^4.0.126",
+    "@sprucelabs/mercury-core-events": "^22.2.63",
+    "@sprucelabs/resolve-path-aliases": "^1.1.294",
+    "@sprucelabs/spruce-conversation-plugin": "^61.1.8",
+    "@sprucelabs/spruce-deploy-plugin": "^61.1.8",
+    "@sprucelabs/spruce-store-plugin": "^61.1.8",
+    "@sprucelabs/spruce-test-fixtures": "^61.1.8",
+    "@sprucelabs/test": "^8.0.47",
+    "@sprucelabs/test-utils": "^4.0.136",
     "@types/blessed": "^0.1.25",
     "@types/eslint": "^8.56.6",
     "@types/fs-extra": "^11.0.4",
@@ -135,7 +135,7 @@
     "@types/semver": "^7.5.8",
     "@types/sha1": "^1.1.5",
     "@types/slug": "^5.0.8",
-    "@types/superagent": "^8.1.4",
+    "@types/superagent": "^8.1.6",
     "@types/terminal-kit": "^2.5.6",
     "@types/uuid": "^9.0.8",
     "chokidar-cli": "^3.0.0",
@@ -153,7 +153,7 @@
     "ps-node": "^0.1.6",
     "ts-jest": "^29.1.2",
     "ts-node": "^10.9.2",
-    "tsc-watch": "^6.0.4",
+    "tsc-watch": "^6.1.0",
     "tsconfig-paths": "^4.2.0"
   },
   "testSkillCache": {
@@ -590,5 +590,5 @@
       "terminal-kit"
     ]
   },
-  "gitHead": "6ce648b69a4074011d7ddc9ee029b81984b03b5f"
+  "gitHead": "2bde52b4518eb67898a35fc8eca9c9667e72337a"
 }

package/src/__tests__/behavioral/EnablingAndDisablingCache.test.ts

@@ -41,6 +41,7 @@ export default class EnablingAndDisablingCacheTest extends AbstractCliTest {
 	protected static async returnsErrorWhenDockerNotEnabled() {
 		CommandService.fakeCommand(/npm config/gis, {
 			code: 1,
+			stderr: 'which',
 		})
 
 		const results = await this.Action('cache', 'enable').execute({})

package/src/__tests__/behavioral/upgrading/UpgradingASkill5.test.ts

@@ -170,7 +170,7 @@ export default class UpgradingASkill5Test extends AbstractCliTest {
 	}
 
 	private static Settings() {
-		return this.Service('eventSettings')
+		return this.Service('eventCache')
 	}
 }
 

package/src/__tests__/behavioral/views/CreatingASkillView.test.ts

@@ -255,7 +255,7 @@ import { vcDiskUtil } from '@sprucelabs/spruce-test-fixtures'
 AuthenticatorImpl.setStorage(new StubStorage())
 
 const vcFactory = ViewControllerFactory.Factory({
-	controllerMap: vcDiskUtil.loadViewControllersAndBuildMap('testing-views', __dirname),
+	controllerMap: vcDiskUtil.loadViewControllersAndBuildMap('testing-views', __dirname).map,
 	device: {} as any,
 	connectToApi: async () => {
 		return 'yes' as any

package/src/__tests__/behavioral/views/plugins/CreatingAViewPlugin.test.ts

@@ -95,6 +95,59 @@ export default class CreatingAViewPluginTest extends AbstractSkillTest {
 		this.assertCombinedFileIncludes('heartwood(vcs, pluginsByName)')
 	}
 
+	@test()
+	protected static async viewPluginCanImportAnotherViewPlugin() {
+		this.writeFile('export class ExternalViewPlugin {}', 'external.ts')
+		this.writeFile(
+			`export { ExternalViewPlugin as default } from './external'`,
+			'actual.view.plugin.ts'
+		)
+
+		await this.syncViews()
+
+		const expected = `export const pluginsByName = {
+	actual: ExternalViewPlugin,
+	aThird: AThirdViewPlugin,
+	another: AnotherViewPlugin,
+	test: TestViewPlugin,
+	testCamel: TestCamelViewPlugin,
+}
+`
+
+		this.assertCombinedFileIncludes(expected)
+	}
+
+	@test()
+	protected static async canImportPluginFromExternalLibrary() {
+		this.writeFile(
+			"export { CardViewController as default } from '@sprucelabs/heartwood-view-controllers'",
+			'card.view.plugin.ts'
+		)
+
+		await this.syncViews()
+
+		const expected = `export const pluginsByName = {
+	actual: ExternalViewPlugin,
+	card: CardViewController,
+	aThird: AThirdViewPlugin,
+	another: AnotherViewPlugin,
+	test: TestViewPlugin,
+	testCamel: TestCamelViewPlugin,
+}
+`
+		this.assertCombinedFileIncludes(expected)
+	}
+
+	private static async syncViews() {
+		await this.Action('view', 'sync').execute({})
+	}
+
+	private static writeFile(content: string, fileName: string) {
+		const actualPlugiContent = content
+		const actualDestination = this.resolvePath('src', fileName)
+		diskUtil.writeFile(actualDestination, actualPlugiContent)
+	}
+
 	private static assertCombinedFileIncludes(expected: string) {
 		const combined = this.getPathToCombinedViewsFile()
 		const contents = diskUtil.readFile(combined)

package/src/__tests__/implementation/EventCacheService.test.ts

@@ -0,0 +1,38 @@
+import {
+	HASH_SPRUCE_DIR,
+	SettingsService,
+	diskUtil,
+} from '@sprucelabs/spruce-skill-utils'
+import { assert, test } from '@sprucelabs/test-utils'
+import EventCacheService from '../../features/event/services/EventCacheService'
+import ServiceFactory from '../../services/ServiceFactory'
+import AbstractCliTest from '../../tests/AbstractCliTest'
+
+export default class EventCacheServiceTest extends AbstractCliTest {
+	@test()
+	protected static async writesToHashSpruceCacheJson() {
+		ServiceFactory.serviceClassOverides['eventCache'] = SpyEventCacheService
+		ServiceFactory.serviceClassOverides['settings'] = SpySettingsService
+
+		const settings = this.Service('eventCache') as SpyEventCacheService
+		const expected = diskUtil.resolvePath(
+			this.cwd,
+			HASH_SPRUCE_DIR,
+			'event-cache.json'
+		)
+		const actual = settings.getCacheFilePath()
+		assert.isEqual(actual, expected)
+	}
+}
+
+class SpyEventCacheService extends EventCacheService {
+	public getCacheFilePath() {
+		return (this.settings as SpySettingsService).getSettingsPath()
+	}
+}
+
+class SpySettingsService extends SettingsService<string> {
+	public getSettingsPath() {
+		return super.getSettingsPath()
+	}
+}

package/src/errors/SpruceError.ts

@@ -235,7 +235,9 @@ export default class SpruceError extends AbstractSpruceError<ErrorOptions> {
 				break
 
 			case 'DOCKER_NOT_STARTED':
-				message = 'Docker has not been started! Start it and try again!'
+				message =
+					'Docker has not been started (or you are trying to run this command in a monorepo)! Start it and try again (or move out of a monorepo)! Originial error:\n\n' +
+					options.originalError?.stack
 				break
 
 			case 'SCHEMA_TEMPLATE_ITEM_BUILDING_FAILED':

package/src/features/cache/actions/EnableAction.ts

@@ -36,9 +36,11 @@ export default class EnableCacheAction extends AbstractAction<OptionsSchema> {
 			}
 		} catch (err: any) {
 			let error = err
+
 			if (err.options?.cmd?.includes('which')) {
 				error = new SpruceError({
 					code: 'MISSING_DEPENDENCIES',
+					originalError: err,
 					dependencies: [
 						{
 							name: 'Docker',
@@ -47,7 +49,10 @@ export default class EnableCacheAction extends AbstractAction<OptionsSchema> {
 					],
 				})
 			} else {
-				error = new SpruceError({ code: 'DOCKER_NOT_STARTED' })
+				error = new SpruceError({
+					code: 'DOCKER_NOT_STARTED',
+					originalError: err,
+				})
 			}
 
 			return {

package/src/features/event/EventFeature.ts

@@ -94,7 +94,7 @@ export default class EventFeature extends AbstractFeature {
 		}
 
 		if (featureCode === 'node' || featureCode === 'upgrade') {
-			const settings = this.Service('eventSettings')
+			const settings = this.Service('eventCache')
 			settings.clearListenerCache()
 		}
 
@@ -177,7 +177,7 @@ export default class EventFeature extends AbstractFeature {
 	private async handleDidFetchSchemas(payload: { schemas?: Schema[] | null }) {
 		const isInstalled = await this.features.isInstalled(this.code)
 
-		const lastSync = this.Service('eventSettings').getLastSyncOptions()
+		const lastSync = this.Service('eventCache').getLastSyncOptions()
 
 		if (lastSync && isInstalled) {
 			const writer = this.getEventContractBuilder()

package/src/features/event/actions/SyncAction.ts

@@ -25,7 +25,7 @@ export default class SyncAction extends AbstractAction<OptionsSchema> {
 			}
 		}
 
-		this.Service('eventSettings').setLastSyncOptions(options)
+		this.Service('eventCache').setLastSyncCache(options)
 
 		const schemaSyncResults = await this.Action('schema', 'sync').execute({})
 

package/src/features/event/services/{EventSettingsService.ts → EventCacheService.ts}

@@ -1,16 +1,18 @@
 import { SettingsService } from '@sprucelabs/spruce-skill-utils'
 
-export default class EventSettingsService {
-	private settings: SettingsService<string>
+export default class EventCacheService {
+	protected settings: SettingsService<string>
+
 	public constructor(settings: SettingsService) {
 		this.settings = settings
+		this.settings.setFile('event-cache.json')
 	}
 
 	public getLastSyncOptions() {
 		return this.settings.get('events.lastSync')
 	}
 
-	public setLastSyncOptions(options: {
+	public setLastSyncCache(options: {
 		shouldSyncOnlyCoreEvents?: boolean | null
 	}) {
 		this.settings.set('events.lastSync', options)

package/src/features/node/actions/UpgradeAction.ts

@@ -7,10 +7,6 @@ import actionUtil from '../../../utilities/action.utility'
 import AbstractAction from '../../AbstractAction'
 import { FeatureActionResponse } from '../../features.types'
 
-type OptionsSchema =
-	SpruceSchemas.SpruceCli.v2020_07_22.UpgradeSkillOptionsSchema
-type Options = SchemaValues<OptionsSchema>
-
 export default class UpgradeAction extends AbstractAction<OptionsSchema> {
 	public invocationMessage = 'Upgrading your skill... 💪'
 	public optionsSchema = upgradeSkillActionSchema
@@ -77,3 +73,7 @@ export default class UpgradeAction extends AbstractAction<OptionsSchema> {
 		})
 	}
 }
+
+type OptionsSchema =
+	SpruceSchemas.SpruceCli.v2020_07_22.UpgradeSkillOptionsSchema
+type Options = SchemaValues<OptionsSchema>

package/src/features/universalFileDescriptions.ts

@@ -14,7 +14,7 @@ const universalFileDescriptions: FileDescription[] = [
 	{
 		path: '.gitignore',
 		description: 'The usual suspects.',
-		shouldOverwriteWhenChanged: false,
+		shouldOverwriteWhenChanged: true,
 	},
 	{
 		path: '.npmignore',

package/src/features/view/actions/SyncAction.ts

@@ -49,6 +49,8 @@ export default class SyncAction extends AbstractAction<OptionsSchema> {
 					viewPluginItems.push(plugin)
 				} else if (svc) {
 					svcTemplateItems.push(svc)
+				} else {
+					throw new Error('Unexpected class type.')
 				}
 			}
 		})

package/src/services/ServiceFactory.ts

@@ -3,7 +3,7 @@ import {
 	EnvService,
 	AuthService,
 } from '@sprucelabs/spruce-skill-utils'
-import EventSettingsService from '../features/event/services/EventSettingsService'
+import EventCacheService from '../features/event/services/EventCacheService'
 import RemoteService from '../features/event/services/RemoteService'
 import { FeatureCode } from '../features/features.types'
 import SchemaService from '../features/schema/services/SchemaService'
@@ -19,10 +19,12 @@ import TypeCheckerService from './TypeCheckerService'
 export default class ServiceFactory {
 	public static serviceClassOverides: Record<string, any> = {}
 
+	public static setServiceClass(name: Service, Class: any) {
+		this.serviceClassOverides[name] = Class
+	}
+
 	public Service<S extends Service>(cwd: string, type: S): ServiceMap[S] {
-		if (ServiceFactory.serviceClassOverides[type]) {
-			return new ServiceFactory.serviceClassOverides[type](cwd) as ServiceMap[S]
-		}
+		const Class = ServiceFactory.serviceClassOverides[type] as any
 
 		switch (type) {
 			case 'auth':
@@ -55,7 +57,8 @@ export default class ServiceFactory {
 					this.buildImportService(cwd)
 				) as ServiceMap[S]
 			case 'settings':
-				return new SettingsService<FeatureCode>(cwd) as ServiceMap[S]
+				//@ts-ignore
+				return new (Class ?? SettingsService)<FeatureCode>(cwd) as ServiceMap[S]
 			case 'dependency':
 				return new DependencyService(
 					new SettingsService<FeatureCode>(cwd)
@@ -69,8 +72,8 @@ export default class ServiceFactory {
 					new LintService(cwd, () => this.Service(cwd, 'command'))
 				) as ServiceMap[S]
 			}
-			case 'eventSettings':
-				return new EventSettingsService(
+			case 'eventCache':
+				return new (Class ?? EventCacheService)(
 					new SettingsService(cwd)
 				) as ServiceMap[S]
 			default:
@@ -107,7 +110,7 @@ export interface ServiceMap {
 	env: EnvService
 	auth: AuthService
 	remote: RemoteService
-	eventSettings: EventSettingsService
+	eventCache: EventCacheService
 	dependency: DependencyService
 }