startx 0.9.1 → 0.9.4

package/apps/core-server/package.json

@@ -20,8 +20,8 @@
 		"test": "vitest run"
 	},
 	"dependencies": {
-		"@repo/constants": "workspace:^",
-		"@repo/db": "workspace:^",
+		"constants": "workspace:^",
+		"@db/drizzle": "workspace:^",
 		"@repo/mail": "workspace:^",
 		"@repo/lib": "workspace:^",
 		"@repo/redis": "workspace:^",
@@ -56,7 +56,8 @@
 		],
 		"requiredDeps": [
 			"@repo/env",
-			"@repo/logger"
+			"@repo/logger",
+			"@repo/lib"
 		],
 		"requiredDevDeps": [
 			"typescript-config",

package/apps/core-server/src/events/index.ts

@@ -1,37 +1,37 @@
-type ServerEvent = {
-	server: Array<() => void>;
-	db: Array<() => void>;
-	redis: Array<() => void>;
+import { IEvent } from "@repo/lib/events";
+import { logger } from "@repo/logger";
+type ServerEventMap = {
+	server: string;
+	db: string;
+	redis: string;
 };
 
-export class ServerEvents {
-	static events: ServerEvent = {
-		server: [],
-		db: [],
-		redis: [],
-	};
+const serverBus = new IEvent<ServerEventMap>();
 
+export class ServerEvents {
 	static onServerReady(fn: () => void) {
-		ServerEvents.events.server.push(fn);
+		serverBus.on("server", fn);
 	}
 
-	static emitServerReady() {
-		ServerEvents.events.server.forEach(fn => fn());
+	static emitServerReady(message?: string) {
+		serverBus.emit("server", message ?? "Server ready");
 	}
 
 	static onDBReady(fn: () => void) {
-		ServerEvents.events.db.push(fn);
+		serverBus.on("db", fn);
 	}
 
-	static emitDBReady() {
-		ServerEvents.events.db.forEach(fn => fn());
+	static emitDBReady(message?: string) {
+		serverBus.emit("db", message ?? "Database ready");
 	}
 
 	static onRedisReady(fn: () => void) {
-		ServerEvents.events.redis.push(fn);
+		serverBus.on("redis", fn);
 	}
 
-	static emitRedisReady() {
-		ServerEvents.events.redis.forEach(fn => fn());
+	static emitRedisReady(message?: string) {
+		serverBus.emit("redis", message ?? "Redis ready");
 	}
 }
+
+serverBus.onEvery(e => logger.info(`${e.event}: ${e.payload}`));

package/apps/core-server/src/index.ts

@@ -1,9 +1,7 @@
 import { ENV } from "@repo/env";
-import { logger } from "@repo/logger";
 import { ServerEvents } from "./events/index.js";
 import { app } from "./routes/server.js";
 
 app.listen(ENV.PORT, () => {
-	ServerEvents.emitServerReady();
-	logger.info(`Server started on port ${ENV.PORT}`);
+	ServerEvents.emitServerReady(`Server listening on port ${ENV.PORT}`);
 });

package/apps/startx-cli/dist/index.mjs

@@ -200,4 +200,4 @@ $&`).replace(/(?:^|\n)([\t ].*)(?:([\n\t ]*)\n(?![\n\t ]))?/g,`$1$2`).replace(/\
 `+t:``),o=Math.floor(n.length/i)-this.cursorPos.rows+(t?Ty(t):0);o>0&&(a+=by(o)),a+=Sy(this.cursorPos.cols),this.write(xy(this.extraLinesUnderPrompt)+wy(this.height)+a),this.extraLinesUnderPrompt=o,this.height=Ty(a)}checkCursorPos(){let e=this.rl.getCursorPos();e.cols!==this.cursorPos.cols&&(this.write(Sy(e.cols)),this.cursorPos=e)}done({clearContent:e}){this.rl.setPrompt(``);let t=xy(this.extraLinesUnderPrompt);t+=e?wy(this.height):`
 `,t+=`\x1B[?25h`,this.write(t),this.rl.close()}},Oy=class extends Promise{static withResolver(){let e,t;return{promise:new Promise((n,r)=>{e=n,t=r}),resolve:e,reject:t}}},ky=b(iy(),1);const Ay=globalThis.setImmediate;function jy(){let e=Error.prepareStackTrace,t=[];try{Error.prepareStackTrace=(e,n)=>{let r=n.slice(1);return t=r,r},Error().stack}catch{return t}return Error.prepareStackTrace=e,t}function My(e){let t=jy();return(n,r={})=>{let{input:i=process.stdin,signal:a}=r,o=new Set,c=new ky.default;c.pipe(r.output??process.stdout),c.mute();let l=u.createInterface({terminal:!0,input:i,output:c}),d=new Dy(l),{promise:f,resolve:p,reject:m}=Oy.withResolver(),h=()=>m(new Q_);if(a){let e=()=>m(new Z_({cause:a.reason}));if(a.aborted)return e(),Object.assign(f,{cancel:h});a.addEventListener(`abort`,e),o.add(()=>a.removeEventListener(`abort`,e))}o.add(gy((e,t)=>{m(new $_(`User force closed the prompt with ${e} ${t}`))}));let g=()=>m(new $_(`User force closed the prompt with SIGINT`));return l.on(`SIGINT`,g),o.add(()=>l.removeListener(`SIGINT`,g)),iv(l,a=>{let u=s.bind(()=>uv.clearAll());l.on(`close`,u),o.add(()=>l.removeListener(`close`,u));let g=()=>{let r=()=>d.checkCursorPos();l.input.on(`keypress`,r),o.add(()=>l.input.removeListener(`keypress`,r)),a(()=>{try{let r=e(n,e=>{setImmediate(()=>p(e))});if(r===void 0){let e=t[1]?.getFileName();throw Error(`Prompt functions must return a string.\n    at ${e}`)}let[i,a]=typeof r==`string`?[r]:r;d.render(i,a),uv.run()}catch(e){m(e)}})};return`readableFlowing`in i?Ay(g):g(),Object.assign(f.then(e=>(uv.clearAll(),e),e=>{throw uv.clearAll(),e}).finally(()=>{o.forEach(e=>e()),d.done({clearContent:!!r.clearPromptOnDone}),c.end()}).then(()=>f),{cancel:h})})}}var $=class{separator=l(`dim`,Array.from({length:15}).join(vv.line));type=`separator`;constructor(e){e&&(this.separator=e)}static isSeparator(e){return!!(e&&typeof e==`object`&&`type`in e&&e.type===`separator`)}};const Ny={icon:{checked:l(`green`,vv.circleFilled),unchecked:vv.circle,cursor:vv.pointer,disabledChecked:l(`green`,vv.circleDouble),disabledUnchecked:`-`},style:{disabled:e=>l(`dim`,e),renderSelectedChoices:e=>e.map(e=>e.short).join(`, `),description:e=>l(`cyan`,e),keysHelpTip:e=>e.map(([e,t])=>`${l(`bold`,e)} ${l(`dim`,t)}`).join(l(`dim`,` • `))},i18n:{disabledError:`This option is disabled and cannot be toggled.`},keybindings:[]};function Py(e){return!$.isSeparator(e)&&!e.disabled}function Fy(e){return!$.isSeparator(e)}function Iy(e){return!$.isSeparator(e)&&e.checked}function Ly(e){return Py(e)?{...e,checked:!e.checked}:e}function Ry(e){return function(t){return Py(t)?{...t,checked:e}:t}}function zy(e){return e.map(e=>{if($.isSeparator(e))return e;if(typeof e==`string`)return{value:e,name:e,short:e,checkedName:e,disabled:!1,checked:!1};let t=e.name??String(e.value),n={value:e.value,name:t,short:e.short??t,checkedName:e.checkedName??t,disabled:e.disabled??!1,checked:e.checked??!1};return e.description&&(n.description=e.description),n})}var By=My((e,t)=>{let{pageSize:n=7,loop:r=!0,required:i,validate:a=()=>!0}=e,o={all:`a`,invert:`i`,...e.shortcuts},s=Sv(Ny,e.theme),{keybindings:c}=s,[l,u]=Q(`idle`),d=Cv({status:l,theme:s}),[f,p]=Q(zy(e.choices)),m=wv(()=>{let e=f.findIndex(Fy),t=f.findLastIndex(Fy);if(e===-1)throw new tv(`[checkbox prompt] No selectable choices. All choices are disabled.`);return{first:e,last:t}},[f]),[h,g]=Q(m.first),[_,v]=Q();Ev(async e=>{if(X_(e)){let e=f.filter(Iy),n=await a([...e]);i&&!e.length?v(`At least one choice must be selected`):n===!0?(u(`done`),t(e.map(e=>e.value))):v(n||`You must select a valid value`)}else if(W_(e,c)||G_(e,c)){if(_&&v(void 0),r||W_(e,c)&&h!==m.first||G_(e,c)&&h!==m.last){let t=W_(e,c)?-1:1,n=h;do n=(n+t+f.length)%f.length;while(!Fy(f[n]));g(n)}}else if(K_(e)){let e=f[h];e&&!$.isSeparator(e)&&(e.disabled?v(s.i18n.disabledError):(v(void 0),p(f.map((e,t)=>t===h?Ly(e):e))))}else if(e.name===o.all){let e=f.some(e=>Py(e)&&!e.checked);p(f.map(Ry(e)))}else if(e.name===o.invert)p(f.map(Ly));else if(Y_(e)){let t=Number(e.name)-1,n=-1,r=f.findIndex(e=>$.isSeparator(e)?!1:(n++,n===t)),i=f[r];i&&Py(i)&&(g(r),p(f.map((e,t)=>t===r?Ly(e):e)))}});let y=s.style.message(e.message,l),b,x=ry({items:f,active:h,renderItem({item:e,isActive:t}){if($.isSeparator(e))return` ${e.separator}`;let n=t?s.icon.cursor:` `;if(e.disabled){let t=typeof e.disabled==`string`?e.disabled:`(disabled)`,r=e.checked?s.icon.disabledChecked:s.icon.disabledUnchecked;return s.style.disabled(`${n}${r} ${e.name} ${t}`)}t&&(b=e.description);let r=e.checked?s.icon.checked:s.icon.unchecked,i=e.checked?e.checkedName:e.name;return(t?s.style.highlight:e=>e)(`${n}${r} ${i}`)},pageSize:n,loop:r});if(l===`done`){let e=f.filter(Iy);return[d,y,s.style.answer(s.style.renderSelectedChoices(e,f))].filter(Boolean).join(` `)}let S=[[`↑↓`,`navigate`],[`space`,`select`]];o.all&&S.push([o.all,`all`]),o.invert&&S.push([o.invert,`invert`]),S.push([`⏎`,`submit`]);let C=s.style.keysHelpTip(S);return`${[[d,y].filter(Boolean).join(` `),x,` `,b?s.style.description(b):``,_?s.style.error(_):``,C].filter(Boolean).join(`
 `).trimEnd()}${yy}`});const Vy={validationFailureMode:`keep`};var Hy=My((e,t)=>{let{prefill:n=`tab`}=e,r=Sv(Vy,e.theme),[i,a]=Q(`idle`),[o,s]=Q(String(e.default??``)),[c,l]=Q(),[u,d]=Q(``),f=Cv({status:i,theme:r});async function p(t){let{required:n,pattern:r,patternError:i=`Invalid input`}=e;return n&&!t?`You must provide a value`:r&&!r.test(t)?i:typeof e.validate==`function`?await e.validate(t)||`You must provide a valid value`:!0}Ev(async(e,n)=>{if(i===`idle`)if(X_(e)){let e=u||o;a(`loading`);let i=await p(e);i===!0?(d(e),a(`done`),t(e)):(r.validationFailureMode===`clear`?d(``):n.write(u),l(i),a(`idle`))}else q_(e)&&!u?s(``):J_(e)&&!u?(s(``),n.clearLine(0),n.write(o),d(o)):(d(n.line),l(void 0))}),dv(e=>{n===`editable`&&o&&(e.write(o),d(o))},[]);let m=r.style.message(e.message,i),h=u;typeof e.transformer==`function`?h=e.transformer(u,{isFinal:i===`done`}):i===`done`&&(h=r.style.answer(u));let g;o&&i!==`done`&&!u&&(g=r.style.defaultAnswer(o));let _=``;return c&&(_=r.style.error(c)),[[f,m,g,h].filter(e=>e!==void 0).join(` `),_]});const Uy={icon:{cursor:vv.pointer},style:{disabled:e=>l(`dim`,e),description:e=>l(`cyan`,e),keysHelpTip:e=>e.map(([e,t])=>`${l(`bold`,e)} ${l(`dim`,t)}`).join(l(`dim`,` • `))},i18n:{disabledError:`This option is disabled and cannot be selected.`},indexMode:`hidden`,keybindings:[]};function Wy(e){return!$.isSeparator(e)&&!e.disabled}function Gy(e){return!$.isSeparator(e)}function Ky(e){return e.map(e=>{if($.isSeparator(e))return e;if(typeof e!=`object`||!e||!(`value`in e)){let t=String(e);return{value:e,name:t,short:t,disabled:!1}}let t=e.name??String(e.value),n={value:e.value,name:t,short:e.short??t,disabled:e.disabled??!1};return e.description&&(n.description=e.description),n})}var qy=My((e,t)=>{let{loop:n=!0,pageSize:r=7}=e,i=Sv(Uy,e.theme),{keybindings:a}=i,[o,s]=Q(`idle`),c=Cv({status:o,theme:i}),l=Tv(),u=!a.includes(`vim`),d=wv(()=>Ky(e.choices),[e.choices]),f=wv(()=>{let e=d.findIndex(Gy),t=d.findLastIndex(Gy);if(e===-1)throw new tv(`[select prompt] No selectable choices. All choices are disabled.`);return{first:e,last:t}},[d]),p=wv(()=>`default`in e?d.findIndex(t=>Wy(t)&&t.value===e.default):-1,[e.default,d]),[m,h]=Q(p===-1?f.first:p),g=d[m],[_,v]=Q();Ev((e,r)=>{if(clearTimeout(l.current),_&&v(void 0),X_(e))g.disabled?v(i.i18n.disabledError):(s(`done`),t(g.value));else if(W_(e,a)||G_(e,a)){if(r.clearLine(0),n||W_(e,a)&&m!==f.first||G_(e,a)&&m!==f.last){let t=W_(e,a)?-1:1,n=m;do n=(n+t+d.length)%d.length;while(!Gy(d[n]));h(n)}}else if(Y_(e)&&!Number.isNaN(Number(r.line))){let e=Number(r.line)-1,t=-1,n=d.findIndex(n=>$.isSeparator(n)?!1:(t++,t===e)),i=d[n];i!=null&&Wy(i)&&h(n),l.current=setTimeout(()=>{r.clearLine(0)},700)}else if(q_(e))r.clearLine(0);else if(u){let e=r.line.toLowerCase(),t=d.findIndex(t=>$.isSeparator(t)||!Wy(t)?!1:t.name.toLowerCase().startsWith(e));t!==-1&&h(t),l.current=setTimeout(()=>{r.clearLine(0)},700)}}),dv(()=>()=>{clearTimeout(l.current)},[]);let y=i.style.message(e.message,o),b=i.style.keysHelpTip([[`↑↓`,`navigate`],[`⏎`,`select`]]),x=0,S=ry({items:d,active:m,renderItem({item:e,isActive:t,index:n}){if($.isSeparator(e))return x++,` ${e.separator}`;let r=t?i.icon.cursor:` `,a=i.indexMode===`number`?`${n+1-x}. `:``;if(e.disabled){let n=typeof e.disabled==`string`?e.disabled:`(disabled)`,r=t?i.icon.cursor:`-`;return i.style.disabled(`${r} ${a}${e.name} ${n}`)}return(t?i.style.highlight:e=>e)(`${r} ${a}${e.name}`)},pageSize:r,loop:n});if(o===`done`)return[c,y,i.style.answer(g.short)].filter(Boolean).join(` `);let{description:C}=g;return`${[[c,y].filter(Boolean).join(` `),S,` `,C?i.style.description(C):``,_?i.style.error(_):``,b].filter(Boolean).join(`
-`).trimEnd()}${yy}`}),Jy=class{static async getText(e){let{message:t,schema:n,default:r}=e,i;if(n&&r!==void 0){let e=n.safeParse(r);e.success&&(i=e.data)}else !n&&r!==void 0&&(i=r);if(n&&n instanceof Af)return await qy({message:t,choices:n.options.map(e=>({value:e})),default:i});let a=await Hy({message:t,default:i,validate:e=>{if(!n)return!0;let t=e;if(n instanceof Dd){if(e.trim()===``)return`Input cannot be empty`;let n=Number(e);if(Number.isNaN(n))return`Please enter a valid number`;t=n}let r=n.safeParse(t);return r.success?!0:r.error.issues[0]?.message??`Invalid input`}});if(!n)return a;let o=n instanceof Dd?Number(a):a;return n.parse(o)}static async choose(e){let{message:t,options:n,mode:r=`single`,default:i,includeAllOption:a=!1,required:o=!1}=e,s=`__all__`,c=r===`single`?[i]:[...i||[]],l=[...r===`multiple`&&a?[{name:`All`,value:s,checked:c.includes(s)}]:[],...n.map(e=>({name:e,value:e,checked:c.includes(e)}))];if(r===`multiple`){let e=await By({message:t,choices:l,validate:e=>o&&e.length===0?`You must select at least one option.`:!0});return a&&e.includes(s)?n:e}return await qy({message:t,choices:n.map(e=>({name:e,value:e})),default:typeof i==`string`?i:void 0})}},Yy=class e{static command=new hg(`init`).argument(`[projectName]`).option(`-d, --dir <path>`,`workspace directory`).action(e.run.bind(e));static async run(e,t){let n=await z_.getPackageList(),r=n.filter(e=>e.type===`apps`&&e.packageJson?.startx?.mode!==`silent`),i=await this.getPrefs({projectName:e,options:t,projects:r}),a=n.filter(e=>e.type!==`apps`),o=await this.getConfigPrefs({selectedApps:i.selectedApps,packages:a}),s=await this.getPackagesPrefs({selectedPackages:o.selectedConfigs,packages:a,tags:o.gTags}),c=[...s.gTags,`runnable`];await this.installWorkspace({name:i.projectName,tags:[...c,`runnable`],dir:i.directory});let l=[...s.selectedPackages,...i.selectedApps];await Promise.all(l.map(async e=>{let t={},n=new Set(s.gTags);e.packageJson?.startx?.mode===`standalone`&&n.add(`runnable`),e.type===`apps`&&(n.add(`runnable`),s.selectedPackages.filter(t=>t.type!==`packages`||t.packageJson?.startx?.mode===`standalone`?!1:t.packageJson?.startx?.iTags?.every(t=>e.packageJson?.startx?.gTags?.includes(t))).forEach(e=>{let n=e.packageJson?.name||e.name;t[n]=`workspace:^`})),await this.installPackage({pkg:e,directory:i.directory,tags:Array.from(n),dependencies:t})}))}static async getPrefs(e){let n=await Jy.getText({message:`Project name`,name:`projectName`,default:e.projectName,schema:Gp.string().min(1,`Package name is required`).max(214,`Package name too long`).regex(/^(?:@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/,`Invalid package name`)});if(e.projects.length===0)throw Error(`No apps found to install.`);let r=z_.getDirectory(),i=e.options.dir?t.resolve(r.workspace,e.options.dir):t.join(r.workspace,n),a=await Jy.choose({message:`Select apps to install`,options:e.projects.map(e=>e.name),includeAllOption:!0,mode:`multiple`,required:!0});return{projectName:n,directory:{workspace:i,template:r.template},selectedApps:e.projects.filter(e=>a.includes(e.name))}}static async getConfigPrefs(e){let t=new Set([`common`]),n=new Map;this.getGlobalTags({pkgs:e.selectedApps}).forEach(e=>t.add(e)),this.getPackageDeps({allPkgs:e.packages,pkgs:e.selectedApps}).forEach(e=>n.set(e.name,e));let r=e.packages.filter(e=>e.type!==`configs`||e.packageJson?.startx?.mode===`silent`||n.has(e.name)?!1:e.packageJson?.startx?.iTags?.every(e=>t.has(e))??!0);if(r.length>0){let e=await Jy.choose({message:`Select configs to install`,options:r.map(e=>e.name),includeAllOption:!0,mode:`multiple`,required:!1});r.filter(t=>e.includes(t.name)).forEach(e=>n.set(e.name,e))}return t.has(`node`)&&(await Jy.choose({message:`Select formatter`,options:[`prettier + biome`,`prettier`],mode:`single`,default:`prettier`,required:!0})===`prettier`||t.add(`biome`),t.add(`prettier`)),this.getPackageDeps({allPkgs:e.packages,pkgs:Array.from(n.values())}).forEach(e=>n.set(e.name,e)),this.getGlobalTags({pkgs:Array.from(n.values())}).forEach(e=>t.add(e)),{gTags:Array.from(t),selectedConfigs:Array.from(n.values())}}static async getPackagesPrefs(e){let t=new Set(e.tags),n=new Map(e.selectedPackages.map(e=>[e.name,e])),r=e.packages.filter(e=>e.type!==`packages`||e.packageJson?.startx?.mode===`silent`||n.has(e.name)?!1:e.packageJson?.startx?.iTags?.every(e=>t.has(e))??!1);if(r.length>0){let e=await Jy.choose({message:`Select packages to install`,options:r.map(e=>e.name),includeAllOption:!0,mode:`multiple`,required:!1});r.filter(t=>e.includes(t.name)).forEach(e=>n.set(e.name,e))}return this.getPackageDeps({allPkgs:e.packages,pkgs:Array.from(n.values())}).forEach(e=>n.set(e.name,e)),this.getGlobalTags({pkgs:Array.from(n.values())}).forEach(e=>t.add(e)),{gTags:Array.from(t),selectedPackages:Array.from(n.values())}}static async installPackage(e){if(!e.pkg.packageJson)throw Error(`Missing package.json for ${e.pkg.name}`);let n=new Set([...e.tags,...e.pkg.packageJson.startx?.tags||[]]),r=e.pkg.packageJson.startx?.ignore||[];r.includes(`eslint-config`)&&n.delete(`eslint`),r.includes(`vitest-config`)&&n.delete(`vitest`);let{packageJson:i,isWorkspace:a}=U_.handlePackageJson({app:e.pkg.packageJson,tags:Array.from(n),name:e.pkg.name,dependencies:e.dependencies});if(a)throw Error(`Cannot install workspace as a package: ${e.pkg.name}`);let o=t.join(e.directory.workspace,e.pkg.relativePath),s=t.join(e.pkg.path);await I_.writeJSONFile({dir:o,file:`package`,content:i}),await this.copyValidatedFilesFromFolder(s,o,n),await I_.copyDirectory({from:t.join(s,`src`),to:t.join(o,`src`),exclude:n.has(`vitest`)?void 0:/\.test\.tsx?$/}),tg.info(`Successfully installed ${e.pkg.name}`)}static async installWorkspace(e){let t=await z_.parsePackageJson({dir:e.dir.template}),n=await z_.parsePackageJson({dir:e.dir.template,file:`startx`});if(!t)throw Error(`Failed to parse root package.json`);t.dependencies={...t.dependencies,...n?.dependencies||{}},t.devDependencies={...t.devDependencies,...n?.devDependencies||{}};let{packageJson:r}=U_.handlePackageJson({app:t,tags:[`root`,...e.tags],name:e.name});await I_.writeJSONFile({dir:e.dir.workspace,file:`package`,content:r}),await this.copyValidatedFilesFromFolder(e.dir.template,e.dir.workspace,new Set([`root`,...e.tags]))}static getPackageDeps(e){let t=new Map(e.pkgs.map(e=>[e.name,e]));return Array.from(t.values()).forEach(n=>{[...n.packageJson?.startx?.requiredDeps||[],...n.packageJson?.startx?.requiredDevDeps||[]].forEach(n=>{let r=e.allPkgs.find(e=>e.packageJson?.name===n);r&&t.set(r.name,r)})}),e.pkgs.forEach(e=>t.delete(e.name)),Array.from(t.values())}static getGlobalTags(e){let t=new Set(e.gTags||[]);return e.pkgs.forEach(e=>{e.packageJson?.startx?.gTags?.forEach(e=>t.add(e))}),Array.from(t)}static async copyValidatedFilesFromFolder(e,n,r){let i=await I_.listFiles({dir:e}).catch(()=>[]);for(let a of i){let i=L_[a];if(!(i&&!i.tags.every(e=>r.has(e))))try{await I_.copyFile({from:t.join(e,a),to:t.join(n,a)})}catch(e){tg.error(`Failed to copy file ${a}:`,e)}}}},Xy=`0.9.1`;const Zy=new hg;Zy.name(`startx`).description(`StartX CLI - Your all in one monorepo startup tool.`).version(Xy),Zy.command(`ping`).action(()=>{tg.info(`pong`)}),Zy.addCommand(Yy.command),Zy.parse(process.argv);export{};
+`).trimEnd()}${yy}`}),Jy=class{static async getText(e){let{message:t,schema:n,default:r}=e,i;if(n&&r!==void 0){let e=n.safeParse(r);e.success&&(i=e.data)}else !n&&r!==void 0&&(i=r);if(n&&n instanceof Af)return await qy({message:t,choices:n.options.map(e=>({value:e})),default:i});let a=await Hy({message:t,default:i,validate:e=>{if(!n)return!0;let t=e;if(n instanceof Dd){if(e.trim()===``)return`Input cannot be empty`;let n=Number(e);if(Number.isNaN(n))return`Please enter a valid number`;t=n}let r=n.safeParse(t);return r.success?!0:r.error.issues[0]?.message??`Invalid input`}});if(!n)return a;let o=n instanceof Dd?Number(a):a;return n.parse(o)}static async choose(e){let{message:t,options:n,mode:r=`single`,default:i,includeAllOption:a=!1,required:o=!1}=e,s=`__all__`,c=r===`single`?[i]:[...i||[]],l=[...r===`multiple`&&a?[{name:`All`,value:s,checked:c.includes(s)}]:[],...n.map(e=>({name:e,value:e,checked:c.includes(e)}))];if(r===`multiple`){let e=await By({message:t,choices:l,validate:e=>o&&e.length===0?`You must select at least one option.`:!0});return a&&e.includes(s)?n:e}return await qy({message:t,choices:n.map(e=>({name:e,value:e})),default:typeof i==`string`?i:void 0})}},Yy=class e{static command=new hg(`init`).argument(`[projectName]`).option(`-d, --dir <path>`,`workspace directory`).action(e.run.bind(e));static async run(e,t){let n=await z_.getPackageList(),r=n.filter(e=>e.type===`apps`&&e.packageJson?.startx?.mode!==`silent`),i=await this.getPrefs({projectName:e,options:t,projects:r}),a=n.filter(e=>e.type!==`apps`),o=await this.getConfigPrefs({selectedApps:i.selectedApps,packages:a}),s=await this.getPackagesPrefs({selectedPackages:o.selectedConfigs,packages:a,tags:o.gTags}),c=[...s.gTags,`runnable`];await this.installWorkspace({name:i.projectName,tags:[...c,`runnable`],dir:i.directory});let l=[...s.selectedPackages,...i.selectedApps];await Promise.all(l.map(async e=>{let t={},n=new Set(s.gTags);e.packageJson?.startx?.mode===`standalone`&&n.add(`runnable`),e.type===`apps`&&(n.add(`runnable`),s.selectedPackages.filter(t=>t.type!==`packages`||t.packageJson?.startx?.mode===`standalone`?!1:t.packageJson?.startx?.iTags?.every(t=>e.packageJson?.startx?.gTags?.includes(t))).forEach(e=>{let n=e.packageJson?.name||e.name;t[n]=`workspace:^`})),await this.installPackage({pkg:e,directory:i.directory,tags:Array.from(n),dependencies:t})}))}static async getPrefs(e){let n=await Jy.getText({message:`Project name`,name:`projectName`,default:e.projectName,schema:Gp.string().min(1,`Package name is required`).max(214,`Package name too long`).regex(/^(?:@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/,`Invalid package name`)});if(e.projects.length===0)throw Error(`No apps found to install.`);let r=z_.getDirectory(),i=e.options.dir?t.resolve(r.workspace,e.options.dir):t.join(r.workspace,n),a=await Jy.choose({message:`Select apps to install`,options:e.projects.map(e=>e.name),includeAllOption:!0,mode:`multiple`,required:!0});return{projectName:n,directory:{workspace:i,template:r.template},selectedApps:e.projects.filter(e=>a.includes(e.name))}}static async getConfigPrefs(e){let t=new Set([`common`]),n=new Map;this.getGlobalTags({pkgs:e.selectedApps}).forEach(e=>t.add(e)),this.getPackageDeps({allPkgs:e.packages,pkgs:e.selectedApps}).forEach(e=>n.set(e.name,e));let r=e.packages.filter(e=>e.type!==`configs`||e.packageJson?.startx?.mode===`silent`||n.has(e.name)?!1:e.packageJson?.startx?.iTags?.every(e=>t.has(e))??!0);if(r.length>0){let e=await Jy.choose({message:`Select configs to install`,options:r.map(e=>e.name),includeAllOption:!0,mode:`multiple`,required:!1});r.filter(t=>e.includes(t.name)).forEach(e=>n.set(e.name,e))}return t.has(`node`)&&(await Jy.choose({message:`Select formatter`,options:[`prettier + biome`,`prettier`],mode:`single`,default:`prettier`,required:!0})===`prettier`||t.add(`biome`),t.add(`prettier`)),this.getPackageDeps({allPkgs:e.packages,pkgs:Array.from(n.values())}).forEach(e=>n.set(e.name,e)),this.getGlobalTags({pkgs:Array.from(n.values())}).forEach(e=>t.add(e)),{gTags:Array.from(t),selectedConfigs:Array.from(n.values())}}static async getPackagesPrefs(e){let t=new Set(e.tags),n=new Map(e.selectedPackages.map(e=>[e.name,e])),r=e.packages.filter(e=>e.type!==`packages`||e.packageJson?.startx?.mode===`silent`||n.has(e.name)?!1:e.packageJson?.startx?.iTags?.every(e=>t.has(e))??!1);if(r.length>0){let e=await Jy.choose({message:`Select packages to install`,options:r.map(e=>e.name),includeAllOption:!0,mode:`multiple`,required:!1});r.filter(t=>e.includes(t.name)).forEach(e=>n.set(e.name,e))}return this.getPackageDeps({allPkgs:e.packages,pkgs:Array.from(n.values())}).forEach(e=>n.set(e.name,e)),this.getGlobalTags({pkgs:Array.from(n.values())}).forEach(e=>t.add(e)),{gTags:Array.from(t),selectedPackages:Array.from(n.values())}}static async installPackage(e){if(!e.pkg.packageJson)throw Error(`Missing package.json for ${e.pkg.name}`);let n=new Set([...e.tags,...e.pkg.packageJson.startx?.tags||[]]),r=e.pkg.packageJson.startx?.ignore||[];r.includes(`eslint-config`)&&n.delete(`eslint`),r.includes(`vitest-config`)&&n.delete(`vitest`);let{packageJson:i,isWorkspace:a}=U_.handlePackageJson({app:e.pkg.packageJson,tags:Array.from(n),name:e.pkg.name,dependencies:e.dependencies});if(a)throw Error(`Cannot install workspace as a package: ${e.pkg.name}`);let o=t.join(e.directory.workspace,e.pkg.relativePath),s=t.join(e.pkg.path);await I_.writeJSONFile({dir:o,file:`package`,content:i}),await this.copyValidatedFilesFromFolder(s,o,n),await I_.copyDirectory({from:t.join(s,`src`),to:t.join(o,`src`),exclude:n.has(`vitest`)?void 0:/\.test\.tsx?$/}),tg.info(`Successfully installed ${e.pkg.name}`)}static async installWorkspace(e){let t=await z_.parsePackageJson({dir:e.dir.template}),n=await z_.parsePackageJson({dir:e.dir.template,file:`startx`});if(!t)throw Error(`Failed to parse root package.json`);t.dependencies={...t.dependencies,...n?.dependencies||{}},t.devDependencies={...t.devDependencies,...n?.devDependencies||{}};let{packageJson:r}=U_.handlePackageJson({app:t,tags:[`root`,...e.tags],name:e.name});await I_.writeJSONFile({dir:e.dir.workspace,file:`package`,content:r}),await this.copyValidatedFilesFromFolder(e.dir.template,e.dir.workspace,new Set([`root`,...e.tags]))}static getPackageDeps(e){let t=new Map(e.pkgs.map(e=>[e.name,e]));return Array.from(t.values()).forEach(n=>{[...n.packageJson?.startx?.requiredDeps||[],...n.packageJson?.startx?.requiredDevDeps||[]].forEach(n=>{let r=e.allPkgs.find(e=>e.packageJson?.name===n);r&&t.set(r.name,r)})}),e.pkgs.forEach(e=>t.delete(e.name)),Array.from(t.values())}static getGlobalTags(e){let t=new Set(e.gTags||[]);return e.pkgs.forEach(e=>{e.packageJson?.startx?.gTags?.forEach(e=>t.add(e))}),Array.from(t)}static async copyValidatedFilesFromFolder(e,n,r){let i=await I_.listFiles({dir:e}).catch(()=>[]);for(let a of i){let i=L_[a];if(!(i&&!i.tags.every(e=>r.has(e))))try{await I_.copyFile({from:t.join(e,a),to:t.join(n,a)})}catch(e){tg.error(`Failed to copy file ${a}:`,e)}}}},Xy=`0.9.4`;const Zy=new hg;Zy.name(`startx`).description(`StartX CLI - Your all in one monorepo startup tool.`).version(Xy),Zy.command(`ping`).action(()=>{tg.info(`pong`)}),Zy.addCommand(Yy.command),Zy.parse(process.argv);export{};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "startx",
   "description": "",
-  "version": "0.9.1",
+  "version": "0.9.4",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/avinashid/startx.git"

package/packages/{@repo/db → @db/drizzle}/package.json

@@ -1,5 +1,5 @@
 {
-	"name": "@repo/db",
+	"name": "@db/drizzle",
 	"version": "0.0.0",
 	"private": true,
 	"type": "module",

package/packages/@db/sqlite/package.json

@@ -0,0 +1,47 @@
+{
+	"name": "@db/sqlite",
+	"version": "0.0.0",
+	"private": true,
+	"type": "module",
+	"exports": "./src/index.ts",
+	"scripts": {
+		"clean": "rimraf dist .turbo",
+		"watch:dev": "pnpm watch",
+		"typecheck": "tsc --noEmit",
+		"format": "biome format --write .",
+		"format:check": "biome ci .",
+		"lint": "eslint .",
+		"lint:fix": "eslint . --fix",
+		"watch": "tsc -p tsconfig.build.json --watch"
+	},
+	"devDependencies": {
+		"typescript-config": "workspace:*",
+		"vitest-config": "workspace:*",
+		"@types/better-sqlite3": "catalog:",
+		"eslint-config": "workspace:*"
+	},
+	"dependencies": {
+		"better-sqlite3": "catalog:",
+		"xlsx": "catalog:",
+		"@repo/env": "workspace:*",
+		"@repo/logger": "workspace:*"
+	},
+	"startx": {
+		"iTags": [
+			"node",
+			"backend"
+		],
+		"gTags": [
+			"db"
+		],
+		"tags": [
+			"sqlite"
+		],
+		"requiredDeps": [
+			"@repo/logger"
+		],
+		"requiredDevDeps": [
+			"typescript-config"
+		]
+	}
+}

package/packages/@db/sqlite/src/index.ts

@@ -0,0 +1,2 @@
+export * from "./lib/sqlite-client.js";
+export * from "./lib/sqlite-convertor.js";

package/packages/@db/sqlite/src/lib/sqlite-client.ts

@@ -0,0 +1,146 @@
+import { logger } from "@repo/logger";
+import Database from "better-sqlite3";
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+class SqliteManager {
+	private static connections: Map<string, Database.Database> = new Map();
+
+	static getDb(dbPath: string): Database.Database {
+		const resolvedPath = path.resolve(dbPath);
+
+		if (!this.connections.has(resolvedPath)) {
+			const dir = path.dirname(resolvedPath);
+			if (!fs.existsSync(dir)) {
+				fs.mkdirSync(dir, { recursive: true });
+			}
+
+			const db = new Database(resolvedPath);
+			db.pragma("journal_mode = WAL");
+			db.pragma("synchronous = NORMAL");
+			logger.info(`Connected to SQLite database at ${resolvedPath}`);
+			this.connections.set(resolvedPath, db);
+		}
+		return this.connections.get(resolvedPath)!;
+	}
+
+	static closeDb(dbPath: string): void {
+		const resolvedPath = path.resolve(dbPath);
+		const db = this.connections.get(resolvedPath);
+
+		if (db) {
+			db.close();
+			this.connections.delete(resolvedPath);
+			logger.warn(`SQLite connection for ${resolvedPath} closed.`);
+		}
+	}
+}
+
+interface TableInfoRow {
+	cid: number;
+	name: string;
+	type: string;
+	notnull: number;
+	dflt_value: string | null;
+	pk: number;
+}
+
+export class SqliteModule {
+	public db: Database.Database;
+	private dbPath: string;
+
+	constructor(dbPath: string = path.resolve(__dirname, "db-files", "app.db")) {
+		this.dbPath = path.resolve(dbPath);
+		this.db = SqliteManager.getDb(this.dbPath);
+	}
+
+	private escapeId(identifier: string): string {
+		return `"${identifier.replace(/"/g, '""')}"`;
+	}
+
+	createTable(tableName: string, schema: Record<string, string>): void {
+		const safeTable = this.escapeId(tableName);
+		const columns = Object.entries(schema)
+			.map(([col, type]) => `${this.escapeId(col)} ${type}`)
+			.join(", ");
+
+		const sql = `CREATE TABLE IF NOT EXISTS ${safeTable} (${columns});`;
+		this.db.prepare(sql).run();
+		logger.info(`Table '${tableName}' is ready.`);
+	}
+
+	insert(tableName: string, row: Record<string, any>): void {
+		const safeTable = this.escapeId(tableName);
+		const cols = Object.keys(row)
+			.map(c => this.escapeId(c))
+			.join(", ");
+		const placeholders = Object.keys(row)
+			.map(() => "?")
+			.join(", ");
+		const values = Object.values(row);
+
+		const sql = `INSERT INTO ${safeTable} (${cols}) VALUES (${placeholders});`;
+		this.db.prepare(sql).run(...values);
+	}
+
+	readAll<T = unknown>(tableName: string): T[] {
+		const safeTable = this.escapeId(tableName);
+		return this.db.prepare(`SELECT * FROM ${safeTable};`).all() as T[];
+	}
+
+	readOne<T = unknown>(tableName: string, where: string, params: any[] = []): T | undefined {
+		const safeTable = this.escapeId(tableName);
+		return this.db.prepare(`SELECT * FROM ${safeTable} WHERE ${where} LIMIT 1;`).get(...params) as T | undefined;
+	}
+
+	update(tableName: string, updates: Record<string, any>, where: string, params: any[] = []): void {
+		const safeTable = this.escapeId(tableName);
+		const setClause = Object.keys(updates)
+			.map(k => `${this.escapeId(k)} = ?`)
+			.join(", ");
+		const values = [...Object.values(updates), ...params];
+
+		const sql = `UPDATE ${safeTable} SET ${setClause} WHERE ${where};`;
+		this.db.prepare(sql).run(...values);
+	}
+
+	delete(tableName: string, where: string, params: any[] = []): void {
+		const safeTable = this.escapeId(tableName);
+		const sql = `DELETE FROM ${safeTable} WHERE ${where};`;
+		this.db.prepare(sql).run(...params);
+	}
+
+	listTables(): string[] {
+		const rows = this.db
+			.prepare(`SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%';`)
+			.all() as Array<{ name: string }>;
+		return rows.map(r => r.name);
+	}
+
+	getTableSchema(tableName: string): string | string[] {
+		const exists = this.db
+			.prepare(`SELECT 1 FROM sqlite_master WHERE type='table' AND name = ? LIMIT 1;`)
+			.get(tableName);
+
+		if (!exists) {
+			logger.warn(`Table not found when fetching schema.`);
+			return [];
+		}
+
+		const safeName = tableName.replace(/"/g, '""');
+		const rows = this.db.prepare(`PRAGMA table_info("${safeName}");`).all() as TableInfoRow[];
+
+		const header = ["cid", "name", "type", "notnull", "default_value", "primary_key"];
+		const content = rows.map(r => `${r.cid} ${r.name} ${r.type} ${!!r.notnull} ${r.dflt_value} ${!!r.pk}`);
+
+		return [header.join(" "), ...content].join("\n");
+	}
+
+	close(): void {
+		SqliteManager.closeDb(this.dbPath);
+	}
+}

package/packages/@db/sqlite/src/lib/sqlite-convertor.ts

@@ -0,0 +1,235 @@
+import fs from "node:fs";
+import * as XLSX from "xlsx";
+import { SqliteModule } from "./sqlite-client.js";
+
+export type InferredKind = "INTEGER" | "REAL" | "BOOLEAN" | "DATE" | "DATETIME" | "TEXT";
+
+export interface ColumnDef {
+	name: string;
+	original: string;
+	kind: InferredKind;
+}
+
+const snake = (s: string) =>
+	s
+		.trim()
+		.replace(/\s+/g, "_")
+		.replace(/[^A-Za-z0-9_]/g, "_")
+		.replace(/__+/g, "_")
+		.replace(/^_+|_+$/g, "")
+		.toLowerCase();
+
+function uniqueNames(headers: string[]): string[] {
+	const used = new Map<string, number>();
+	return headers.map(h => {
+		let base = snake(h || "col");
+		if (!base) base = "col";
+		let name = base;
+		let i = 1;
+		while (used.has(name)) {
+			name = `${base}_${++i}`;
+		}
+		used.set(name, 1);
+		return name;
+	});
+}
+
+function isBooleanish(v: unknown): boolean {
+	if (typeof v === "boolean") return true;
+	if (typeof v === "number") return v === 0 || v === 1;
+	if (typeof v === "string") {
+		const s = v.trim().toLowerCase();
+		return ["true", "false", "yes", "no", "y", "n", "0", "1"].includes(s);
+	}
+	return false;
+}
+
+function toBoolean(v: unknown): boolean | null {
+	if (v == null || v === "") return null;
+	if (typeof v === "boolean") return v;
+	if (typeof v === "number") return v !== 0;
+	if (typeof v === "string") {
+		const s = v.trim().toLowerCase();
+		return ["true", "yes", "y", "1"].includes(s) ? true : ["false", "no", "n", "0"].includes(s) ? false : null;
+	}
+	return null;
+}
+
+function isExcelDate(d: unknown): d is Date {
+	return d instanceof Date && !isNaN(d.getTime());
+}
+
+function looksLikeDateString(s: string): boolean {
+	return (
+		/^(\d{4}-\d{2}-\d{2})(?:[ T]\d{2}:\d{2}:\d{2}(?:\.\d+)?Z?)?$/.test(s) ||
+		/^(\d{1,2})[\/-](\d{1,2})[\/-](\d{2,4})(?:\s+\d{1,2}:\d{2}(?::\d{2})?)?$/.test(s)
+	);
+}
+
+function parseDateFlexible(v: unknown): Date | null {
+	if (v == null || v === "") return null;
+	if (isExcelDate(v)) return v;
+	if (typeof v === "number") {
+		if (v > 1e12) return new Date(v);
+		if (v > 1e9) return new Date(v * 1000);
+		const excelEpoch = new Date(Date.UTC(1899, 11, 30));
+		const ms = excelEpoch.getTime() + v * 24 * 60 * 60 * 1000;
+		const d = new Date(ms);
+		return isNaN(d.getTime()) ? null : d;
+	}
+	if (typeof v === "string" && looksLikeDateString(v.trim())) {
+		const d = new Date(v);
+		return isNaN(d.getTime()) ? null : d;
+	}
+	return null;
+}
+
+function inferKind(values: unknown[]): InferredKind {
+	const nonNull = values.filter(v => v !== undefined && v !== null && v !== "");
+	if (nonNull.length === 0) return "TEXT";
+
+	const allDates = nonNull.every(v => isExcelDate(v) || parseDateFlexible(v) !== null);
+	if (allDates) {
+		const anyHasTime = nonNull.some(v => {
+			const d = isExcelDate(v) ? v : parseDateFlexible(v);
+			if (!d) return false;
+			return d.getUTCHours() !== 0 || d.getUTCMinutes() !== 0 || d.getUTCSeconds() !== 0;
+		});
+		return anyHasTime ? "DATETIME" : "DATE";
+	}
+
+	const allBool = nonNull.every(isBooleanish);
+	if (allBool) return "BOOLEAN";
+
+	const allNumbers = nonNull.every(v => typeof v === "number" || (!isNaN(Number(v)) && String(v).trim() !== ""));
+	if (allNumbers) {
+		const anyFloat = nonNull.some(v => String(v).includes("."));
+		return anyFloat ? "REAL" : "INTEGER";
+	}
+
+	return "TEXT";
+}
+
+function coerceValue(kind: InferredKind, v: unknown, dateAs: "TEXT" | "INTEGER" | "REAL"): unknown {
+	if (v === undefined || v === null || v === "") return null;
+	switch (kind) {
+		case "BOOLEAN": {
+			const b = toBoolean(v);
+			return b === null ? null : b ? 1 : 0;
+		}
+		case "INTEGER": {
+			const n = Number(v);
+			return isFinite(n) ? Math.trunc(n) : null;
+		}
+		case "REAL": {
+			const n = Number(v);
+			return isFinite(n) ? n : null;
+		}
+		case "DATE":
+		case "DATETIME": {
+			const d = isExcelDate(v) ? v : parseDateFlexible(v);
+			if (!d) return null;
+			if (dateAs === "TEXT") return kind === "DATE" ? d.toISOString().slice(0, 10) : d.toISOString();
+			if (dateAs === "INTEGER") return Math.floor(d.getTime() / 1000);
+			return d.getTime();
+		}
+		default:
+			return JSON.stringify(v);
+	}
+}
+
+export class ExcelToSqlite {
+	static importSheetFromFile(
+		filePath: string,
+		dbPath: string,
+		tableName: string,
+		sheetName?: string,
+		drop = false,
+		headerRow = 1,
+		dateAs: "TEXT" | "INTEGER" | "REAL" = "TEXT"
+	) {
+		const workbook = XLSX.read(fs.readFileSync(filePath), {
+			type: "buffer",
+			cellDates: true,
+			raw: false,
+		});
+		return this.importSheetFromWorkbook(workbook, dbPath, tableName, sheetName, drop, headerRow, dateAs);
+	}
+
+	static importSheetFromBuffer(
+		buffer: Buffer,
+		dbPath: string,
+		tableName: string,
+		sheetName?: string,
+		drop = false,
+		headerRow = 1,
+		dateAs: "TEXT" | "INTEGER" | "REAL" = "TEXT"
+	) {
+		const workbook = XLSX.read(buffer, {
+			type: "buffer",
+			cellDates: true,
+			raw: false,
+		});
+		return this.importSheetFromWorkbook(workbook, dbPath, tableName, sheetName, drop, headerRow, dateAs);
+	}
+
+	private static importSheetFromWorkbook(
+		workbook: XLSX.WorkBook,
+		dbPath: string,
+		tableName: string,
+		sheetName?: string,
+		drop = false,
+		headerRow = 1,
+		dateAs: "TEXT" | "INTEGER" | "REAL" = "TEXT"
+	) {
+		const sheet = sheetName || workbook.SheetNames[0];
+		const worksheet = workbook.Sheets[sheet];
+		if (!worksheet) throw new Error(`Sheet not found: ${sheet}`);
+
+		const rows: any[] = XLSX.utils.sheet_to_json(worksheet, {
+			header: 1,
+			defval: "",
+			blankrows: false,
+			raw: false,
+		});
+		if (rows.length < headerRow) throw new Error(`Sheet has no header at row ${headerRow}`);
+
+		const header = (rows[headerRow - 1] as unknown[]).map(v => JSON.stringify(v ?? "").trim());
+		const dataRows = rows
+			.slice(headerRow)
+			.filter(r => Array.isArray(r) && r.some(c => c !== "" && c !== null && c !== undefined));
+
+		const sanitizedNames = uniqueNames(header);
+		const columns: ColumnDef[] = sanitizedNames.map((name, idx) => {
+			const colValues = dataRows.map(r => r[idx]);
+			return {
+				name,
+				original: header[idx] || name,
+				kind: inferKind(colValues),
+			};
+		});
+
+		const tblName = snake(tableName || sheet);
+		const columnDecls = columns.map(c => `"${c.name}" ${c.kind}`);
+		const ddl = `CREATE TABLE IF NOT EXISTS "${tblName}" ( ${columnDecls.join(", ")} );`;
+
+		const db = new SqliteModule(dbPath);
+
+		const tx = db.db.transaction(() => {
+			if (drop) db.db.prepare(`DROP TABLE IF EXISTS "${tblName}";`).run();
+			db.db.prepare(ddl).run();
+			if (dataRows.length === 0) return;
+
+			const placeholders = columns.map(() => "?").join(",");
+			const insertSql = `INSERT INTO "${tblName}" (${columns.map(c => `"${c.name}"`).join(", ")}) VALUES (${placeholders});`;
+			const stmt = db.db.prepare(insertSql);
+			for (const row of dataRows) {
+				const values = columns.map((c, idx) => coerceValue(c.kind, row[idx], dateAs));
+				stmt.run(values);
+			}
+		});
+
+		tx();
+		return { tableName: tblName, columns };
+	}
+}

package/packages/@db/sqlite/tsconfig.json

@@ -0,0 +1,13 @@
+{
+	"extends": "typescript-config/tsconfig.common.json",
+	"compilerOptions": {
+		"rootDir": ".",
+		"types": ["node"],
+		"baseUrl": "src",
+		"tsBuildInfoFile": "dist/typecheck.tsbuildinfo",
+		"experimentalDecorators": true,
+		"emitDecoratorMetadata": true,
+		"allowSyntheticDefaultImports": true
+	},
+	"include": ["src/**/*.ts"]
+}

package/packages/@repo/lib/src/events/i-event.ts

@@ -0,0 +1,59 @@
+type IEventWithPayload<T extends Record<string, unknown>> = {
+	[K in keyof T]: { event: K; payload: T[K] };
+}[keyof T];
+
+export class IEvent<T extends Record<string, unknown>> {
+	private listeners: { [K in keyof T]?: Array<(payload: T[K]) => void> } = {};
+	private onceListeners: { [K in keyof T]?: Array<(payload: T[K]) => void> } = {};
+	private everyListeners: Array<(e: IEventWithPayload<T>) => void> = [];
+
+	on<K extends keyof T>(event: K, handler: (payload: T[K]) => void) {
+		(this.listeners[event] ||= []).push(handler);
+		return () => this.off(event, handler);
+	}
+
+	once<K extends keyof T>(event: K, handler: (payload: T[K]) => void) {
+		(this.onceListeners[event] ||= []).push(handler);
+		return () => this.off(event, handler);
+	}
+
+	off<K extends keyof T>(event: K, handler: (payload: T[K]) => void) {
+		if (this.listeners[event]) {
+			this.listeners[event] = this.listeners[event].filter(fn => fn !== handler);
+		}
+		if (this.onceListeners[event]) {
+			this.onceListeners[event] = this.onceListeners[event].filter(fn => fn !== handler);
+		}
+	}
+
+	onEvery(handler: (e: IEventWithPayload<T>) => void) {
+		this.everyListeners.push(handler);
+		return () => {
+			this.everyListeners = this.everyListeners.filter(h => h !== handler);
+		};
+	}
+
+	emit<K extends keyof T>(event: K, payload: T[K]) {
+		const everyList = [...this.everyListeners];
+		for (const h of everyList) {
+			h({ event, payload } as IEventWithPayload<T>);
+		}
+
+		const list = this.listeners[event];
+		if (list) {
+			for (const h of [...list]) h(payload);
+		}
+
+		const onceList = this.onceListeners[event];
+		if (onceList && onceList.length > 0) {
+			this.onceListeners[event] = [];
+			for (const h of [...onceList]) h(payload);
+		}
+	}
+
+	emitOnce<K extends keyof T>(event: K, payload: T[K]) {
+		this.emit(event, payload);
+		this.listeners[event] = [];
+		this.onceListeners[event] = [];
+	}
+}

package/packages/@repo/lib/src/events/index.ts

@@ -0,0 +1 @@
+export * from "./i-event.js";

package/packages/@repo/mail/src/emails/admin/OtpEmail.tsx

@@ -13,7 +13,7 @@ import {
 	Text,
 } from "@react-email/components";
 import React from "react";
-export function VerifyEmailOtp({ verificationCode = "596853" }: { verificationCode: string }) {
+export default function VerifyEmailOtp({ verificationCode = "596853" }: { verificationCode: string }) {
 	return (
 		<Html>
 			<Head>

package/packages/@repo/mail/src/emails/emails.ts

@@ -1 +1,2 @@
-export * from "./admin/OtpEmail.js";
+import VerifyEmailOtp from "./admin/OtpEmail.js";
+export { VerifyEmailOtp };

package/packages/constants/eslint.config.ts

@@ -0,0 +1,4 @@
+import { baseConfig } from "eslint-config/base";
+import { extend } from "eslint-config/extend";
+
+export default extend(baseConfig);

package/packages/{@repo/constants → constants}/package.json

@@ -1,5 +1,5 @@
 {
-	"name": "@repo/constants",
+	"name": "constants",
 	"version": "0.12.0",
 	"type": "module",
 

package/packages/constants/vitest.config.ts

@@ -0,0 +1,3 @@
+import vitestConfig from "vitest-config/node";
+
+export default vitestConfig;

package/pnpm-workspace.yaml

@@ -1,7 +1,7 @@
 packages:
   - "apps/*"
   - "packages/*"
-  - "packages/@repo/*"
+  - "packages/*/*"
   - "configs/*"
 
 catalog:
@@ -23,6 +23,7 @@ catalog:
   axios: ^1.13.6
   date-fns: ^4.1.0
   nanoid: ^5.1.6
+  xlsx: ^0.18.5
 
   # testing
   vitest: ^4.0.18
@@ -66,9 +67,11 @@ catalog:
   drizzle-orm: ^0.45.1
   drizzle-kit: ^0.31.10
   pg: ^8.19.0
+  better-sqlite3: ^12.9.0
 
   # db types
   "@types/pg": ^8.10.0
+  "@types/better-sqlite3": ^7.6.13
 
   # lib
   "@aws-sdk/client-s3": ^3.39.0