@paralect/hive 0.1.50-alpha.0 → 0.1.50-alpha.2

package/starter/package.json

@@ -4,6 +4,10 @@
   "description": "Koa api",
   "private": false,
   "main": "src/app.js",
+  "imports": {
+    "#hive/*": "./src/*",
+    "#hive": "./src/index.js"
+  },
   "author": "Paralect",
   "license": "MIT",
   "keywords": [
@@ -18,7 +22,7 @@
   "scripts": {
     "build-assets": "mjml ./src/assets/emails/*.mjml -o ./src/assets/emails/dist/",
     "build-emails": "babel src/emails --out-dir src/emails/compiled",
-    "dev": "tsx --watch src/app.js",
+    "dev": "tsx --watch --import ./register.mjs src/app.js",
     "init-project": "./bin/init-project.sh",
     "start": "tsx src/app.js",
     "migrate": "node ./src/migrator.js",
@@ -31,6 +35,7 @@
     "@koa/cors": "5.0.0",
     "@koa/multer": "3.0.2",
     "@koa/router": "12.0.1",
+    "@paralect/hive": "^0.1.50-alpha.0",
     "@paralect/node-mongo": "3.2.0",
     "@react-email/components": "^0.0.21",
     "@react-email/render": "^0.0.16",
@@ -95,4 +100,4 @@
       "npm run lint"
     ]
   }
-}
+}

package/starter/register.mjs

@@ -0,0 +1,6 @@
+import { register } from 'node:module';
+import { pathToFileURL } from 'node:url';
+
+console.log('[register] Registering custom loader...');
+register('./loader.mjs', pathToFileURL('./'));
+console.log('[register] Custom loader registered');

package/starter/src/app-config/index.js

@@ -2,6 +2,9 @@ import _ from 'lodash';
 import fs from "fs";
 import dotenv from "dotenv";
 import appConfig from "./app.js";
+import { getDirname } from '#hive/helpers/esm';
+
+const __dirname = getDirname(import.meta.url);
 
 dotenv.config({ path: `${__dirname}/.env` });
 dotenv.config({ path: `${__dirname}/.env.app` });

package/starter/src/app.js

@@ -1,31 +1,27 @@
-
-import appModulePath from "app-module-path";
-appModulePath.addPath(__dirname);
-
-if (process.env.HIVE_SRC) {
-  appModulePath.addPath(process.env.HIVE_SRC);
-}
+// Module resolution:
+// #hive/... → .hive/src/... (framework code, via package.json imports)
+// #root/... → HIVE_SRC/... (user code, via custom loader)
 
 import Koa from "koa";
 import http from "http";
-import config from "app-config";
-import logger from "logger";
+import config from "#hive/app-config";
+import logger from "#hive/logger";
 import cors from "@koa/cors";
 import helmet from "koa-helmet";
 import qs from "koa-qs";
 import bodyParser from "koa-bodyparser";
 
 import requestLogger from "koa-logger";
-import db from "db";
-import socketIo from "socketIo";
+import db from "#hive/db";
+import socketIo from "#hive/socketIo";
 import mount from "koa-mount";
-import get from "resources/health/endpoints/get";
+import get from "#hive/resources/health/endpoints/get";
 
 const main = async () => {
   await config.init();
   await db.init();
 
-  const routes = (await import("routes")).default;
+  const routes = (await import("#hive/routes")).default;
   const scheduler = (await import("./scheduler")).default;
 
   process.on("unhandledRejection", (reason, p) => {
@@ -59,7 +55,7 @@ const main = async () => {
     console.log(`Api server listening on ${config.port}, in ${process.env.NODE_ENV} mode and ${process.env.APP_ENV} environment`);
   });
 
-  scheduler();
+  await scheduler();
 
   await socketIo(server);
 };

package/starter/src/autoMap/addHandlers.js

@@ -1,9 +1,9 @@
 import _ from "lodash";
-import db from "db";
-import ifUpdated from "helpers/db/ifUpdated";
+import db from "#hive/db";
+import ifUpdated from "#hive/helpers/db/ifUpdated";
 import schemaMappings from "./schemaMappings";
 import getDependentFields from './getDependentFields';
-import isZodArray from "helpers/isZodArray";
+import isZodArray from "#hive/helpers/isZodArray";
 
 const updatedSchemaMappings = (() => {
   const result = {};

package/starter/src/autoMap/getDependentFields.js

@@ -1,6 +1,6 @@
 import _ from 'lodash';
 import { z } from 'zod';
-import isZodArray from "helpers/isZodArray";
+import isZodArray from "#hive/helpers/isZodArray";
 
 const getZodKeys = schema => {
   // make sure schema is not null or undefined

package/starter/src/autoMap/mapSchema.js

@@ -1,9 +1,9 @@
 import _ from "lodash";
-import db from "db";
+import db from "#hive/db";
 
 import schemaMappings from "./schemaMappings";
 import getDependentFields from './getDependentFields';
-import isZodArray from "helpers/isZodArray";
+import isZodArray from "#hive/helpers/isZodArray";
 
 const schemaMappingService = db.services.schemaMappings;
 

package/starter/src/bullMqBus.js

@@ -1,4 +1,4 @@
-import config from 'app-config';
+import config from '#hive/app-config';
 import bullMq from './bullMq';
 const queue = bullMq.Queue(`database-${config.env}`);
 

package/starter/src/bullMqWrapper.js

@@ -1,4 +1,4 @@
-import config from 'app-config';
+import config from '#hive/app-config';
 import { Queue, Worker } from 'bullMq';
 
 let connectionOpts = {

package/starter/src/db.js

@@ -1,10 +1,11 @@
 import fs from "fs";
 import _ from "lodash";
-import getSchemas from "helpers/getSchemas";
-import getResources from "helpers/getResources";
-import importHandlers from "helpers/importHandlers";
-import config from "app-config";
-import { connect } from "lib/node-mongo";
+import getSchemas from "#hive/helpers/getSchemas";
+import getResources from "#hive/helpers/getResources";
+import importHandlers from "#hive/helpers/importHandlers";
+
+import config from "#hive/app-config";
+import { connect } from "#hive/lib/node-mongo/src/index.js";
 
 const db = connect(config.mongoUri);
 
@@ -39,14 +40,14 @@ db.init = async () => {
 
   const resourcePaths = await getResources();
 
-  setTimeout(() => {
-    _.each(resourcePaths, ({ name }) => {
-      importHandlers(name)
-    });
+  setTimeout(async () => {
+    for (const { name } of resourcePaths) {
+      await importHandlers(name);
+    }
   }, 0);
 
-  (await import("autoMap/addHandlers")).default();
-  (await import("autoMap/mapSchema")).default();
+  (await import("#hive/autoMap/addHandlers")).default();
+  (await import("#hive/autoMap/mapSchema")).default();
 };
 
 export default db;

package/starter/src/helpers/esm.js

@@ -0,0 +1,56 @@
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { readdirSync } from 'fs';
+
+/**
+ * Get __dirname equivalent for ESM modules
+ * Usage: const __dirname = getDirname(import.meta.url);
+ */
+export const getDirname = (importMetaUrl) => {
+  return dirname(fileURLToPath(importMetaUrl));
+};
+
+/**
+ * Get __filename equivalent for ESM modules
+ * Usage: const __filename = getFilename(import.meta.url);
+ */
+export const getFilename = (importMetaUrl) => {
+  return fileURLToPath(importMetaUrl);
+};
+
+/**
+ * ESM replacement for require-dir
+ * Imports all JS files from a directory
+ * 
+ * @param {string} dirPath - Directory path to import from
+ * @param {object} options - Options
+ * @param {function} options.mapValue - Function to call for each imported module (module, name) => any
+ * @param {function} options.filter - Function to filter files (filename) => boolean
+ * @returns {Promise<object>} - Object with filename (without ext) as key and module as value
+ */
+export const importDir = async (dirPath, options = {}) => {
+  const { mapValue, filter = (f) => f.endsWith('.js') } = options;
+
+  const files = readdirSync(dirPath).filter(filter);
+  const modules = {};
+
+  for (const file of files) {
+    const filePath = join(dirPath, file);
+    const moduleName = file.replace(/\.[^.]+$/, ''); // Remove extension
+
+    try {
+      const module = await import(filePath);
+      const value = module.default || module;
+
+      if (mapValue) {
+        modules[moduleName] = mapValue(value, moduleName);
+      } else {
+        modules[moduleName] = value;
+      }
+    } catch (err) {
+      console.error(`[importDir] Failed to import ${filePath}:`, err.message);
+    }
+  }
+
+  return modules;
+};

package/starter/src/helpers/getMiddlewares.js

@@ -1,6 +1,9 @@
 import _ from 'lodash';
 import path from 'path';
 import fs from 'fs';
+import { getDirname } from '#hive/helpers/esm';
+
+const __dirname = getDirname(import.meta.url);
 
 const {
   promises: { readdir },

package/starter/src/helpers/getResourceEndpoints.js

@@ -1,5 +1,8 @@
 import fs from 'fs';
 import _ from 'lodash';
+import { getDirname } from '#hive/helpers/esm';
+
+const __dirname = getDirname(import.meta.url);
 
 const {
   promises: { readdir },

package/starter/src/helpers/getResources.js

@@ -1,6 +1,9 @@
 import _ from 'lodash';
 import path from 'path';
 import fs from 'fs';
+import { getDirname } from '#hive/helpers/esm';
+
+const __dirname = getDirname(import.meta.url);
 
 const {
   promises: { readdir },

package/starter/src/helpers/getSchemas.js

@@ -1,6 +1,9 @@
 import _ from 'lodash';
 import fs, { promises } from "fs";
 import getResources from "./getResources.js";
+import { getDirname } from '#hive/helpers/esm';
+
+const __dirname = getDirname(import.meta.url);
 
 const {
   promises: { readdir },

package/starter/src/helpers/importHandlers.js

@@ -1,29 +1,20 @@
 import fs from 'fs';
 import _ from 'lodash';
-import requireDir from "require-dir";
+import { getDirname, importDir } from '#hive/helpers/esm';
 
-export default (resourceName) => {
-  if (fs.existsSync(`${process.env.HIVE_SRC}/resources/${resourceName}/handlers`)) {
-    requireDir(`${process.env.HIVE_SRC}/resources/${resourceName}/handlers`, {
-      mapValue: (handler, handlerName) => {
-        console.log(
-          `[handlers] Registering handler ${handlerName}`
-        );
+const __dirname = getDirname(import.meta.url);
+
+export default async (resourceName) => {
+  const mapValue = (handler, handlerName) => {
+    console.log(`[handlers] Registering handler ${handlerName}`);
+    return handler;
+  };
 
-        return handler;
-      },
-    });
+  if (fs.existsSync(`${process.env.HIVE_SRC}/resources/${resourceName}/handlers`)) {
+    await importDir(`${process.env.HIVE_SRC}/resources/${resourceName}/handlers`, { mapValue });
   }
 
   if (fs.existsSync(`${__dirname}/../resources/${resourceName}/handlers`)) {
-    requireDir(`${__dirname}/../resources/${resourceName}/handlers`, {
-      mapValue: (handler, handlerName) => {
-        console.log(
-          `[handlers] Registering handler ${handlerName}`
-        );
-
-        return handler;
-      },
-    });
+    await importDir(`${__dirname}/../resources/${resourceName}/handlers`, { mapValue });
   }
 };

package/starter/src/ioEmitter.js

@@ -1,4 +1,4 @@
-import config from 'app-config';
+import config from '#hive/app-config';
 import { Emitter } from '@socket.io/redis-emitter';
 import { createClient } from 'redis';
 

package/starter/src/logger.js

@@ -1,5 +1,5 @@
 import winston from 'winston';
-import config from 'app-config';
+import config from '#hive/app-config';
 import fs from 'fs';
 
 const colorizer = winston.format.colorize();

package/starter/src/middlewares/attachUser.js

@@ -1,5 +1,5 @@
-import db from 'db';
-import config from 'app-config';
+import db from '#hive/db';
+import config from '#hive/app-config';
 
 const userService = db.services.users;
 const tokenService = db.services.tokens;

package/starter/src/middlewares/global/tryToAttachUser.js

@@ -1,4 +1,4 @@
-import db from 'db';
+import db from '#hive/db';
 const userService = db.services.users;
 const tokenService = db.services.tokens;
 

package/starter/src/middlewares/shouldExist.js

@@ -1,4 +1,4 @@
-import db from 'db';
+import db from '#hive/db';
 
 function singularize(word) {
   const endings = {

package/starter/src/middlewares/shouldNotExist.js

@@ -1,5 +1,5 @@
 import _ from 'lodash';
-import db from 'db';
+import db from '#hive/db';
 
 export default (
   resourceName,

package/starter/src/migrations/migration.service.js

@@ -1,8 +1,11 @@
-import db from "db";
+import db from "#hive/db";
 import fs from "fs";
 import path from "path";
 import _ from "lodash";
 import validateSchema from "./migrations.schema";
+import { getDirname } from '#hive/helpers/esm';
+
+const __dirname = getDirname(import.meta.url);
 
 const service = db.createService("__migrationVersion", {
   validate: validateSchema,

package/starter/src/migrations/migrations-log/migration-log.schema.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import dbSchema from 'helpers/schema/db.schema';
+import dbSchema from '#hive/helpers/schema/db.schema';
 
 export default dbSchema.extend({
   startTime: z.date(),

package/starter/src/migrations/migrations-log/migration-log.service.js

@@ -1,4 +1,4 @@
-import db from 'db';
+import db from '#hive/db';
 import validateSchema from './migration-log.schema.js';
 
 const service = db.createService("__migrationLog", {

package/starter/src/migrations/migrations.schema.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import dbSchema from 'helpers/schema/db.schema';
+import dbSchema from '#hive/helpers/schema/db.schema';
 
 export default dbSchema.extend({
   version: z.number(),

package/starter/src/migrations/migrator.js

@@ -1,6 +1,6 @@
 import 'moment-duration-format';
 import moment from 'moment';
-import logger from 'logger';
+import logger from '#hive/logger';
 import migrationLogService from './migrations-log/migration-log.service';
 import migrationService from './migration.service';
 

package/starter/src/migrator.js

@@ -1,4 +1,3 @@
-import appModulePath from "app-module-path";
-import migrator from "migrations/migrator";
-appModulePath.addPath(__dirname);
+import migrator from "#hive/migrations/migrator";
+
 migrator.exec();

package/starter/src/resources/schemaMappings/schemaMappings.schema.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import dbSchema from 'helpers/schema/db.schema';
+import dbSchema from '#hive/helpers/schema/db.schema';
 
 export default dbSchema.extend({
   mappings: z.object({}),

package/starter/src/resources/tokens/methods/setToken.js

@@ -1,4 +1,4 @@
-import db from 'db';
+import db from '#hive/db';
 const tokenService = db.services.tokens;
 
 export default async () => {

package/starter/src/resources/tokens/methods/storeToken.js

@@ -1,10 +1,10 @@
-import db from 'db';
+import db from '#hive/db';
 import crypto from 'crypto';
 import util from 'util';
 
 const randomBytes = util.promisify(crypto.randomBytes, crypto);
 
-import setCookie from 'services/setCookie';
+import setCookie from '#hive/services/setCookie';
 
 const tokenService = db.services.tokens;
 

package/starter/src/resources/tokens/tokens.schema.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import dbSchema from 'helpers/schema/db.schema';
+import dbSchema from '#hive/helpers/schema/db.schema';
 
 export default dbSchema.extend({
   user: z.object({

package/starter/src/resources/users/endpoints/getCurrentUser.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import isAuthorized from 'middlewares/isAuthorized';
+import isAuthorized from '#hive/middlewares/isAuthorized';
 
 export const handler = async (ctx) => {
   ctx.body = ctx.state.user;

package/starter/src/resources/users/endpoints/getUserProfile.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import db from 'db';
+import db from '#hive/db';
 
 const userService = db.services.users;
 

package/starter/src/resources/users/methods/ensureUserCreated.js

@@ -1,4 +1,4 @@
-import db from 'db';
+import db from '#hive/db';
 import _ from 'lodash';
 import slug from 'slug';
 

package/starter/src/resources/users/users.schema.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import dbSchema from 'helpers/schema/db.schema';
+import dbSchema from '#hive/helpers/schema/db.schema';
 
 const users = dbSchema.extend({
   email: z.string().email(),

package/starter/src/routes/index.js

@@ -1,16 +1,16 @@
 import _ from "lodash";
-import getResources from "helpers/getResources";
-import getMiddlewares from "helpers/getMiddlewares";
-import getResourceEndpoints from "helpers/getResourceEndpoints";
+import getResources from "#hive/helpers/getResources";
+import getMiddlewares from "#hive/helpers/getMiddlewares";
+import getResourceEndpoints from "#hive/helpers/getResourceEndpoints";
 import mount from "koa-mount";
 import Router from "@koa/router";
-import validate from "middlewares/validate";
-import db from "db";
-import tryToAttachUser from "middlewares/global/tryToAttachUser";
+import validate from "#hive/middlewares/validate";
+import db from "#hive/db";
+import tryToAttachUser from "#hive/middlewares/global/tryToAttachUser";
 import attachCustomErrors from "./middlewares/attachCustomErrors";
 import routeErrorHandler from "./middlewares/routeErrorHandler";
-import isAuthorized from "middlewares/isAuthorized";
-import config from 'app-config';
+import isAuthorized from "#hive/middlewares/isAuthorized";
+import config from '#hive/app-config';
 
 const requestLogService = db.createService("_request_logs");
 

package/starter/src/routes/middlewares/routeErrorHandler.js

@@ -1,4 +1,4 @@
-import logger from 'logger';
+import logger from '#hive/logger';
 
 const routeErrorHandler = async (ctx, next) => {
   try {

package/starter/src/scheduler.js

@@ -2,17 +2,19 @@ import path from 'path';
 import fs from 'fs';
 import moment from 'moment';
 import schedule from 'node-schedule';
-import requireDir from 'require-dir';
+import { getDirname, importDir } from '#hive/helpers/esm';
 
-export default () => {
+const __dirname = getDirname(import.meta.url);
+
+export default async () => {
   const paths = [path.resolve(__dirname, './scheduler/handlers')];
   if (process.env.HIVE_SRC) {
     paths.push(path.resolve(process.env.HIVE_SRC, './scheduler/handlers'))
   }
 
-  paths.forEach((pathName) => {
+  for (const pathName of paths) {
     if (fs.existsSync(pathName)) {
-      requireDir(pathName, {
+      await importDir(pathName, {
         mapValue: (handler, handlerName) => {
           console.log(
             `[scheduler] Registering handler ${handlerName} with cron ${handler.cron}`
@@ -20,13 +22,14 @@ export default () => {
 
           schedule.scheduleJob(handler.cron, () => {
             console.log(
-              `[scheduler] ${moment().format()} executing ${handlerName} with cron ${handler.cron
-              }`
+              `[scheduler] ${moment().format()} executing ${handlerName} with cron ${handler.cron}`
             );
             handler.handler();
           });
+          
+          return handler;
         },
       });
     }
-  });
+  }
 }

package/starter/src/services/emailService.js

@@ -1,4 +1,4 @@
-import config from 'app-config';
+import config from '#hive/app-config';
 import nodemailer from 'nodemailer';
 
 config.assert('smtp');

package/starter/src/services/setCookie.js

@@ -1,7 +1,7 @@
 import psl from 'psl';
 import url from 'url';
-import { env } from 'app-config';
-import { webUri } from 'app-config';
+import { env } from '#hive/app-config';
+import { webUri } from '#hive/app-config';
 
 let cookiesDomain;
 

package/starter/src/socketIo.js

@@ -1,9 +1,9 @@
-import db from 'db';
+import db from '#hive/db';
 import { Server } from 'socket.io';
 import { createClient } from 'redis';
 import { createAdapter } from '@socket.io/redis-adapter';
-import config from 'app-config';
-import logger from 'logger';
+import config from '#hive/app-config';
+import logger from '#hive/logger';
 
 export default (server) => {
   const io = new Server(server);