@skalfa/skalfa-api-core 1.0.3 → 1.0.8

package/src/auth/helpers/get-user-permissions.ts

@@ -0,0 +1,15 @@
+import { db } from '@skalfa/skalfa-orm'
+
+export async function getUserPermissions(userId: number): Promise<string[]> {
+  const roleIds = await db("user_roles").where("user_id", userId).pluck("role_id")
+
+  if (roleIds.length === 0) return []
+
+  const rows = await db("permissions").whereIn("role_id", roleIds).pluck("permissions")
+
+  return Array.from(
+    new Set(
+      rows.flatMap((p: any) => p ?? [])
+    )
+  )
+}

package/src/auth/helpers/index.ts

@@ -0,0 +1,3 @@
+export * from './generate-agent-id'
+export * from './get-request-ip'
+export * from './get-user-permissions'

package/src/auth/list-user-sessions.ts

@@ -0,0 +1,11 @@
+import { db } from '@skalfa/skalfa-orm'
+
+export async function listUserSessions(userId: number, currentTokenId?: number) {
+  const rows = await db("user_access_tokens").select(["id", "agent", "created_at", "last_used_at", "last_used_ip","expired_at"]).where("user_id", userId).orderBy("last_used_at", "desc")
+
+  return rows.map((r: any) => ({
+    ...r,
+    is_active  : r.revoked_at  ===  null,
+    is_current : r.id          ===  currentTokenId,
+  }))
+}

package/src/auth/revalidate-user-permissions-by-role.ts

@@ -0,0 +1,13 @@
+import { db } from '@skalfa/skalfa-orm'
+import { registry } from '@utils/registry'
+
+export async function revalidateUserPermissionsByRole(roleId: number) {
+  const userIds = await db("user_roles").where("role_id", roleId).pluck("user_id")
+
+  const queue = registry.get('queue')
+  if (queue) {
+    for (const userId of userIds) {
+      await queue.add("auth:revalidate-permission", { userId })
+    }
+  }
+}

package/src/auth/revalidate-user-permissions.ts

@@ -0,0 +1,26 @@
+import { db } from '@skalfa/skalfa-orm'
+import { registry } from '@utils/registry'
+import { AUTH_CACHE } from './auth'
+import { getUserPermissions } from './helpers'
+
+export async function revalidateUserPermissions(userId: number) {
+  const permissions = await getUserPermissions(userId)
+
+  const tokenIds = await db("user_access_tokens").where("user_id", userId).pluck("id")
+
+  if (tokenIds.length === 0) return
+
+  await db("user_access_tokens").whereIn("id", tokenIds).update({
+    permissions  :  JSON.stringify(permissions),
+    updated_at   :  new Date(),
+  })
+
+  if (AUTH_CACHE) {
+    const redis = registry.get('redis')
+    if (redis) {
+      await Promise.all(
+        tokenIds.map((id: any) => redis.del(`auth:token:${id}`))
+      )
+    }
+  }
+}

package/src/auth/revoke-access-token.ts

@@ -0,0 +1,5 @@
+import { db } from '@skalfa/skalfa-orm'
+
+export async function revokeAccessToken(id: number) {
+  return db.table('user_access_tokens').where("id", id).delete()
+}

package/src/auth/verify-access-token.ts

@@ -0,0 +1,56 @@
+import bcrypt from "bcrypt";
+import { db } from '@skalfa/skalfa-orm'
+import { registry } from '@utils/registry'
+import { AUTH_CACHE, AUTH_CACHE_TTL } from './auth'
+import { generateAgentId, getRequestIp } from './helpers'
+
+export async function verifyAccessToken(token: string, req?: Request) {
+  if (!token.includes("|")) return null
+
+  const [tokenId, plain]  =  token.split("|", 2)
+  const agent             =  req ? generateAgentId(req) : ""
+  const ip                =  req ? getRequestIp(req) : ""
+
+  const cacheKey = `auth:token:${tokenId}`
+
+  if (AUTH_CACHE) {
+    const redis = registry.get('redis')
+    if (redis) {
+      const cached = await redis.get(cacheKey)
+      if (cached) {
+        const session = JSON.parse(cached)
+        if (session.agent !== agent) return null
+        return session
+      }
+    }
+  }
+
+  const tokenRecord = await db("user_access_tokens").where("id", tokenId).first()
+
+  if (!tokenRecord) return null
+  if (tokenRecord.agent !== agent) return null
+
+  const valid = await bcrypt.compare(plain, tokenRecord.token)
+  if (!valid) return null
+
+  await db("user_access_tokens").where("id", tokenRecord.id).update({ last_used_at: new Date(), last_used_ip: ip })
+
+  const user = await db("users").where("id", tokenRecord.user_id).first()
+
+  if (AUTH_CACHE) {
+    const redis = registry.get('redis')
+    if (redis) {
+      await redis.setex(
+        cacheKey,
+        AUTH_CACHE_TTL,
+        JSON.stringify({
+          user         :  user,
+          agent        :  tokenRecord.agent,
+          permissions  :  tokenRecord.permission,
+        })
+      )
+    }
+  }
+
+  return { user, token: tokenRecord, permissions: tokenRecord.permission }
+}

package/src/auth/verify-user-mail-token.ts

@@ -0,0 +1,24 @@
+import crypto from 'crypto'
+import { db } from '@skalfa/skalfa-orm'
+
+export async function verifyUserMailToken(userId: number, token: string) {
+  const hashedToken = crypto.createHash("sha256").update(token).digest("hex");
+
+  const record = await db.table("user_mail_tokens")
+    .where("user_id", userId)
+    .whereNull("used_at")
+    .orderBy("id", "desc")
+    .first();
+
+  if (!record) return false
+
+  if (record.token !== hashedToken) return false;
+
+  const createdAt = new Date(record.created_at);
+  const now = new Date();
+  const diffMinutes = (now.getTime() - createdAt.getTime()) / (1000 * 60);
+
+  if (diffMinutes > 10) return false;
+
+  return true;
+}

package/src/commands/cli.ts

@@ -2,22 +2,19 @@ import fs from "fs";
 import path from "path";
 import { Command } from "commander";
 
-// Basic commands (always available)
 import { makeControllerCommand } from "./make/basic-controller";
-import { makeLightControllerCommand } from "./make/light-controller";
+import { makeSkalfaControllerCommand } from "./make/skalfa-controller";
 import { barrelsCommand, watchBarrelsCommand } from "./runner/barrels";
-
-// ORM commands (optional)
 import { makeModelCommand } from "./make/basic-model";
 import { makeSeederCommand } from "./make/basic-seeder";
 import { makeMigrationCommand } from "./make/basic-migration";
-import { makeLightModelCommand } from "./make/light-model";
+import { makeSkalfaModelCommand } from "./make/skalfa-model";
 import { makeBlueprintCommand } from "./make/blueprint";
+import { makeResourceCommand } from "./make/resource";
 import { migrateCommand, migrateFreshCommand } from "./runner/migration";
 import { seederCommand } from "./runner/seeder";
 import { blueprintCommand } from "./runner/blueprint/runner";
-
-// Extension-specific commands
+import { generateDocsCommand } from "./runner/generate-docs";
 import { makeQueueCommand } from "./make/queue";
 import { makeMailCommand } from "./make/mail";
 import { makeNotificationCommand } from "./make/notification";
@@ -25,7 +22,6 @@ import { makeDaMigrationCommand } from "./make/da-migration";
 import { daMigrateCommand, daMigrateFreshCommand } from "./runner/da-migration";
 
 export function runCli() {
-  // Read package.json to dynamically detect installed extensions
   let dependencies: Record<string, string> = {};
   try {
     const pkgPath = path.join(process.cwd(), "package.json");
@@ -35,50 +31,44 @@ export function runCli() {
     }
   } catch {}
 
-  const hasOrm = !!dependencies["@skalfa/skalfa-orm"];
   const hasMail = !!dependencies["@skalfa/mail"] || !!dependencies["skalfa-mail"];
   const hasNotification = !!dependencies["@skalfa/notification"] || !!dependencies["skalfa-notification"];
   const hasQueue = !!dependencies["@skalfa/queue"] || !!dependencies["@skalfa/redis"] || !!dependencies["skalfa-queue"] || !!dependencies["skalfa-redis"];
   const hasDa = !!dependencies["@skalfa/da"] || !!dependencies["skalfa-da"] || !!dependencies["@clickhouse/client"];
 
   const program = new Command();
-  program.name("skalfa").description("Skalfa Local CLI").version("1.0.0");
+  program.name("skalfa").description("Skalfa-api CLI").version("1.0.0");
 
-  // 1. Add Core / Basic commands
-  program.addCommand(makeControllerCommand);
-  program.addCommand(makeLightControllerCommand);
   program.addCommand(barrelsCommand);
+
+  program.addCommand(makeControllerCommand);
+  program.addCommand(makeSkalfaControllerCommand);
   program.addCommand(watchBarrelsCommand);
+  program.addCommand(makeModelCommand);
+  program.addCommand(makeMigrationCommand);
+  program.addCommand(makeSeederCommand);
+  program.addCommand(makeSkalfaModelCommand);
+  program.addCommand(makeBlueprintCommand);
+  program.addCommand(makeResourceCommand);
 
-  // 2. Add ORM commands if installed
-  if (hasOrm) {
-    program.addCommand(makeModelCommand);
-    program.addCommand(makeMigrationCommand);
-    program.addCommand(makeSeederCommand);
-    program.addCommand(makeLightModelCommand);
-    program.addCommand(makeBlueprintCommand);
-    program.addCommand(migrateCommand);
-    program.addCommand(migrateFreshCommand);
-    program.addCommand(seederCommand);
-    program.addCommand(blueprintCommand);
-  }
+  program.addCommand(migrateCommand);
+  program.addCommand(migrateFreshCommand);
+  program.addCommand(seederCommand);
+  program.addCommand(blueprintCommand);
+  program.addCommand(generateDocsCommand);
 
-  // 3. Add Mail commands if installed
   if (hasMail) {
     program.addCommand(makeMailCommand);
   }
 
-  // 4. Add Notification commands if installed
   if (hasNotification) {
     program.addCommand(makeNotificationCommand);
   }
 
-  // 5. Add Queue commands if installed
   if (hasQueue) {
     program.addCommand(makeQueueCommand);
   }
 
-  // 6. Add Data Analytics / OLAP commands if installed
   if (hasDa) {
     program.addCommand(makeDaMigrationCommand);
     program.addCommand(daMigrateCommand);

package/src/commands/make/basic-controller.ts

@@ -4,6 +4,8 @@ import { Command } from "commander";
 import { conversion, logger } from "@utils";
 import { basicControllerStub } from "../stubs";
 
+
+
 // =====================================>
 // ## Command: make:controller
 // =====================================>
@@ -11,7 +13,7 @@ export const makeControllerCommand = new Command("make:controller")
   .argument("<name>", "Name of controller")
   .description("Create new controller")
   .action((controllerName) => {
-    const basePath = path.join(process.cwd(), "src", "controllers");
+    const basePath = path.join(process.cwd(), "app", "controllers");
     
     if (!controllerName || controllerName.trim() === "") {
       logger.error("Controller name invalid!");
@@ -41,7 +43,7 @@ export const makeControllerCommand = new Command("make:controller")
     
     let content = basicControllerStub;
     content = content.replace(/{{\s*name\s*}}/g, name || "");
- 
+
     writeFileSync(filePath, content);
   
     logger.info(`Controller ${controllerName} created!`);

package/src/commands/make/basic-migration.ts

@@ -4,6 +4,8 @@ import { Command } from "commander";
 import { conversion, logger } from "@utils";
 import { basicMigrationStub } from "../stubs";
 
+
+
 // =====================================>
 // ## Command: make:migration
 // =====================================>
@@ -13,8 +15,11 @@ export const makeMigrationCommand = new Command("make:migration")
   .description("Membuat file migration baru")
   .action((name, options) => {
     makeMigration(name, options);
+    process.exit(0);
   });
 
+
+
 // =====================================>
 // ## Command: migration helpers
 // =====================================>
@@ -28,7 +33,6 @@ export const makeMigration = (
 
   const baseDir = path.join(
     process.cwd(),
-    "src",
     "database",
     "migrations"
   );
@@ -66,8 +70,6 @@ export const makeMigration = (
   writeFileSync(filePath, content);
 
   logger.info(`Migration created: ${path.relative(baseDir, filePath)}`);
-
-  process.exit(0);
 };
 
 const migrationPrefixFile = (date: Date) => {

package/src/commands/make/basic-model.ts

@@ -4,6 +4,8 @@ import { Command } from "commander";
 import { conversion, logger } from "@utils";
 import { basicModelStub } from "../stubs";
 
+
+
 // =====================================>
 // ## Command: make:model
 // =====================================>
@@ -14,7 +16,7 @@ export const makeModelCommand = new Command("make:model")
     const name = conversion.strPascal(modelName);
     const filename = conversion.strSlug(modelName) + ".model.ts";
 
-    const filePath = path.join(process.cwd(), "src", "models", filename);
+    const filePath = path.join(process.cwd(), "app", "models", filename);
 
     if (!existsSync(path.dirname(filePath))) {
       mkdirSync(path.dirname(filePath), { recursive: true });

package/src/commands/make/basic-seeder.ts

@@ -4,6 +4,8 @@ import { Command } from "commander";
 import { conversion, logger } from "@utils";
 import { basicSeederStub } from "../stubs";
 
+
+
 // =====================================>
 // ## Command: make:seeder
 // =====================================>
@@ -21,7 +23,7 @@ export const makeSeeder = (seederName: string, model?: string) => {
   const filename = conversion.strSlug(seederName) + ".seeder.ts";
   const modelName = model || conversion.strPascal(seederName);
 
-  const dir = path.join(process.cwd(), "src", "database", "seeders");
+  const dir = path.join(process.cwd(), "database", "seeders");
   if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
 
   const filePath = path.join(dir, filename);

package/src/commands/make/blueprint.ts

@@ -4,6 +4,8 @@ import { Command } from "commander";
 import { conversion, logger } from "@utils";
 import { blueprintStub } from "../stubs";
 
+
+
 // =====================================>
 // ## Command: make:blueprint
 // =====================================>
@@ -11,7 +13,7 @@ export const makeBlueprintCommand = new Command("make:blueprint")
   .argument("<name>", "Name of blueprint")
   .description("Create new blueprint")
   .action((name) => {
-    const basePath = path.join(process.cwd(), "src", "blueprints");
+    const basePath = path.join(process.cwd(), "blueprints");
     
     if (!name || name.trim() === "") {
       logger.error("Blueprint name invalid!");

package/src/commands/make/da-migration.ts

@@ -4,10 +4,12 @@ import { Command } from "commander";
 import { logger } from "@utils";
 import { daMigrationStub } from "../stubs";
 
+
+
 // =====================================>
 // ## Command: make:da:migration
 // =====================================>
-export const makeDaMigrationCommand = new Command("make:da:migration")
+export const makeDaMigrationCommand = new Command("make:da-migration")
   .argument("<name>", "Nama migration")
   .option("--init", "Buat migration init (0000_00)")
   .description("Membuat file migration baru")
@@ -24,9 +26,8 @@ export const makeDaMigration = (
 
   const baseDir = path.join(
     process.cwd(),
-    "src",
-    "database",
-    "da.migrations"
+    "analytic",
+    "migrations"
   );
 
   let targetDir: string;
@@ -62,7 +63,7 @@ export const makeDaMigration = (
   writeFileSync(filePath, content);
 
   logger.info(
-    `DA Migration created: ${path.relative(baseDir, filePath)}`
+    `Analytics Migration created: ${path.relative(baseDir, filePath)}`
   );
 
   process.exit(0);

package/src/commands/make/mail.ts

@@ -4,6 +4,8 @@ import { Command } from "commander";
 import { conversion, logger } from "@utils";
 import { mailStub } from "../stubs";
 
+
+
 // =====================================>
 // ## Command: make:mail
 // =====================================>
@@ -11,8 +13,8 @@ export const makeMailCommand = new Command("make:mail")
   .argument("<name>", "Name of mail")
   .description("Create new mail")
   .action((name) => {
-    const basePath = path.join(process.cwd(), "src", "outputs", "mails");
-    const templatePath = path.join(process.cwd(), "src", "outputs", "mails", "templates");
+    const basePath = path.join(process.cwd(), "app", "outputs", "mails");
+    const templatePath = path.join(process.cwd(), "app", "outputs", "mails", "templates");
     
     if (!name || name.trim() === "") {
       logger.error("Mail name invalid!");

package/src/commands/make/notification.ts

@@ -4,6 +4,8 @@ import { Command } from "commander";
 import { conversion, logger } from "@utils";
 import { notificationStub } from "../stubs";
 
+
+
 // =====================================>
 // ## Command: make:notification
 // =====================================>
@@ -11,7 +13,7 @@ export const makeNotificationCommand = new Command("make:notification")
   .argument("<name>", "Name of notification")
   .description("Create new notification")
   .action((name) => {
-    const basePath = path.join(process.cwd(), "src", "outputs", "notifications");
+    const basePath = path.join(process.cwd(), "app", "outputs", "notifications");
     
     if (!name || name.trim() === "") {
       logger.error("Notification name invalid!");

package/src/commands/make/queue.ts

@@ -4,6 +4,8 @@ import { Command } from "commander";
 import { conversion, logger } from "@utils";
 import { queueStub } from "../stubs";
 
+
+
 // =====================================>
 // ## Command: make:queue
 // =====================================>
@@ -11,7 +13,7 @@ export const makeQueueCommand = new Command("make:queue")
   .argument("<name>", "Name of queue")
   .description("Create new queue")
   .action((name) => {
-    const basePath = path.join(process.cwd(), "src", "jobs", "queues");
+    const basePath = path.join(process.cwd(), "app", "jobs", "queues");
     
     if (!name || name.trim() === "") {
       logger.error("Queue name invalid!");

package/src/commands/make/resource.ts

@@ -0,0 +1,21 @@
+import { Command } from "commander";
+import { makeSkalfaModel } from "./skalfa-model";
+import { makeSkalfaController } from "./skalfa-controller";
+import { makeMigration } from "./basic-migration";
+import { makeSeeder } from "./basic-seeder";
+
+
+
+// =====================================>
+// ## Command: make:resource
+// =====================================>
+export const makeResourceCommand = new Command("make:resource")
+  .argument("<name>", "Name of resource")
+  .description("Create a new model, migration, seeder, and controller for a resource")
+  .action((name) => {
+    makeSkalfaModel(name);
+    makeSkalfaController(name);
+    makeMigration("create_" + name, { init: true });
+    makeSeeder(name);
+    process.exit(0);
+  });

package/src/commands/make/{light-controller.ts → skalfa-controller.ts}

@@ -2,22 +2,24 @@ import path from "path";
 import { writeFileSync, mkdirSync, existsSync } from "fs";
 import { Command } from "commander";
 import { conversion, logger } from "@utils";
-import { lightControllerStub } from "../stubs";
+import { skalfaControllerStub } from "../stubs";
+
+
 
 // =====================================>
-// ## Command: make:light-controller
+// ## Command: make:skafa-controller
 // =====================================>
-export const makeLightControllerCommand = new Command("make:light-controller")
+export const makeSkalfaControllerCommand = new Command("make:skalfa-controller")
   .argument("<name>", "Name of controller")
   .option("-m, --model <model>", "Attach model to controller")
-  .description("Make the Light Controller")
+  .description("Make the Skalfa Controller")
   .action((name, options) => {
-      makeLightController(name, options.model);
+      makeSkalfaController(name, options.model);
       process.exit(0);
   });
 
-export const makeLightController = (controllerName: string, modelName?: string) => {
-  const basePath = path.join(process.cwd(), "src", "controllers");
+export const makeSkalfaController = (controllerName: string, modelName?: string) => {
+  const basePath = path.join(process.cwd(), "app", "controllers");
 
   if (!controllerName || controllerName.trim() === "") {
     logger.error("Controller name invalid!");
@@ -46,7 +48,7 @@ export const makeLightController = (controllerName: string, modelName?: string)
     logger.info(`Create folder ${targetDir}...`);
   }
 
-  let stub = lightControllerStub;
+  let stub = skalfaControllerStub;
 
   stub = stub.replace(
     /{{\s*name\s*}}|{{\s*model\s*}}|{{\s*validations\s*}}|{{\s*marker\s*}}/g,

package/src/commands/make/{light-model.ts → skalfa-model.ts}

@@ -2,23 +2,25 @@ import path from "path";
 import { writeFileSync, mkdirSync, existsSync } from "fs";
 import { Command } from "commander";
 import { conversion, logger } from "@utils";
-import { makeLightController } from "./light-controller";
+import { makeSkalfaController } from "./skalfa-controller";
 import { makeMigration } from "./basic-migration";
 import { makeSeeder } from "./basic-seeder";
-import { lightModelStub } from "../stubs";
+import { skalfaModelStub } from "../stubs";
+
+
 
 // =====================================>
-// ## Command: make:light-model
+// ## Command: make:skalfa-model
 // =====================================>
-export const makeLightModelCommand = new Command("make:light-model")
+export const makeSkalfaModelCommand = new Command("make:skalfa-model")
   .argument("<name>", "Name of model")
   .option("-r", "Generate all resource (controller, migration, seeder)")
-  .description("Make the Light Model")
+  .description("Make the Skalfa Model")
   .action((name, options) => {
-    makeLightModel(name);
+    makeSkalfaModel(name);
 
     if (options.r) {
-      makeLightController(name);
+      makeSkalfaController(name);
       makeMigration("create_" + name, { init: true });
       makeSeeder(name);
     }
@@ -26,11 +28,11 @@ export const makeLightModelCommand = new Command("make:light-model")
     process.exit(0);
   });
 
-export const makeLightModel = (modelName: string) => {
+export const makeSkalfaModel = (modelName: string) => {
   const name = conversion.strPascal(modelName);
   const filename = conversion.strSlug(modelName) + ".model.ts";
 
-  const basePath = path.join(process.cwd(), "src", "models");
+  const basePath = path.join(process.cwd(), "app", "models");
 
   if (!existsSync(basePath)) {
     mkdirSync(basePath, { recursive: true });
@@ -43,7 +45,7 @@ export const makeLightModel = (modelName: string) => {
     return;
   }
 
-  let stub = lightModelStub;
+  let stub = skalfaModelStub;
 
   stub = stub
     .replace(/{{\s*name\s*}}/g, name)

package/src/commands/runner/barrels.ts

@@ -4,6 +4,8 @@ import { exec, execSync } from "child_process";
 import { Command } from "commander";
 import { logger } from "@utils";
 
+
+
 // =====================================>
 // ## Command: barrels (run once)
 // =====================================>
@@ -29,6 +31,8 @@ export const barrelsCommand = new Command("barrels")
     }
   });
 
+
+
 // =====================================>
 // ## Command: watch:barrels (file watcher)
 // =====================================>

package/src/commands/runner/blueprint/controller-generation.ts

@@ -2,7 +2,9 @@ import fs from "fs";
 import path from "path";
 import { conversion } from "@utils";
 import { resolveBlueprintPath } from "./runner";
-import { lightControllerStub, routeStub } from "../../stubs";
+import { skalfaControllerStub, routeStub } from "../../stubs";
+
+
 
 // ================================>
 // ## Command: Blueprint controller generation
@@ -31,7 +33,7 @@ export async function controllerGeneration(
     ...generateRelationValidations(relations)
   };
 
-  let stub = lightControllerStub;
+  let stub = skalfaControllerStub;
 
   stub = stub
     .replace(/{{\s*marker\s*}}/g, marker)

package/src/commands/runner/blueprint/documentation-generation.ts

@@ -5,6 +5,8 @@ import { conversion } from "@utils";
 const ERD_PATH = path.join(process.cwd(), "storage", "documentation", "entity");
 const API_PATH = path.join(process.cwd(), "storage", "documentation", "api");
 
+
+
 // =========================================>
 // ## Command: Blueprint documentation generation
 // =========================================>