@shohaghinfo/aerojs 0.4.0 → 0.4.1

package/dist/auth/guards/session-guard.d.ts

@@ -1,8 +1,7 @@
 /**
  * @file session-guard.ts
  * @description Server-side Session Authentication Guard for AeroJS.
- * Handles cashier terminal sessions, doctor portal logins, and multi-shift management.
- * Hospital use-case: Cashier logs in → session tagged with Shift_Session_ID + Terminal_ID.
+ * Handles web portal logins, user state persistence, and session fixation prevention.
  */
 import type { AeroContext } from '../../core/context.js';
 import type { GuardContract, AuthUser, LoginOptions } from './guard.js';
@@ -38,12 +37,11 @@ export declare class SessionGuard implements GuardContract {
     silentCheck(): Promise<boolean>;
     /**
      * Logs a user into the session.
-     * Hospital use: cashier.login(user, { remember: false }) — terminates on browser close.
+     * Example: ctx.auth.use('session').login(user, { remember: true });
      */
     login(user: AuthUser, options?: LoginOptions): Promise<void>;
     /**
      * Logs the authenticated user out and destroys their session.
-     * Hospital use: cashier shift end → session destroyed, terminal freed.
      */
     logout(): Promise<void>;
     /**

package/dist/auth/guards/session-guard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-guard.d.ts","sourceRoot":"","sources":["../../../src/auth/guards/session-guard.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAIvE,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,KAAK,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;CAC7D;AAED,qBAAa,YAAa,YAAW,aAAa;IAChD,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoD;IAC7E,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,GAAG,CAAc;gBAEb,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,kBAAkB;IAO1E,IAAI,IAAI,QAAQ,GAAG,IAAI;IAIvB,KAAK,IAAI,OAAO;IAIvB;;OAEG;IACU,YAAY,IAAI,OAAO,CAAC,QAAQ,CAAC;IAuB9C;;OAEG;IACU,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAS5C;;;OAGG;IACU,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAc7E;;;OAGG;IACU,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAOpC;;;OAGG;IACU,OAAO,CAClB,IAAI,EAAE,QAAQ,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,EACrC,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,OAAO,CAAC;CASpB"}
+{"version":3,"file":"session-guard.d.ts","sourceRoot":"","sources":["../../../src/auth/guards/session-guard.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAIvE,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,KAAK,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;CAC7D;AAED,qBAAa,YAAa,YAAW,aAAa;IAChD,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoD;IAC7E,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,GAAG,CAAc;gBAEb,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,kBAAkB;IAO1E,IAAI,IAAI,QAAQ,GAAG,IAAI;IAIvB,KAAK,IAAI,OAAO;IAIvB;;OAEG;IACU,YAAY,IAAI,OAAO,CAAC,QAAQ,CAAC;IAuB9C;;OAEG;IACU,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAS5C;;;OAGG;IACU,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAc7E;;OAEG;IACU,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAOpC;;;OAGG;IACU,OAAO,CAClB,IAAI,EAAE,QAAQ,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,EACrC,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,OAAO,CAAC;CASpB"}

package/dist/auth/guards/session-guard.js

@@ -1,8 +1,7 @@
 /**
  * @file session-guard.ts
  * @description Server-side Session Authentication Guard for AeroJS.
- * Handles cashier terminal sessions, doctor portal logins, and multi-shift management.
- * Hospital use-case: Cashier logs in → session tagged with Shift_Session_ID + Terminal_ID.
+ * Handles web portal logins, user state persistence, and session fixation prevention.
  */
 import { UnauthorizedError, ForbiddenError } from '../../core/errors.js';
 import { hash, hashVerify } from '../../security/hash.js';
@@ -61,7 +60,7 @@ export class SessionGuard {
     }
     /**
      * Logs a user into the session.
-     * Hospital use: cashier.login(user, { remember: false }) — terminates on browser close.
+     * Example: ctx.auth.use('session').login(user, { remember: true });
      */
     async login(user, options = {}) {
         await this.session.put(this.userKey, { id: user.id });
@@ -76,7 +75,6 @@ export class SessionGuard {
     }
     /**
      * Logs the authenticated user out and destroys their session.
-     * Hospital use: cashier shift end → session destroyed, terminal freed.
      */
     async logout() {
         await this.session.forget(this.userKey);

package/dist/auth/guards/session-guard.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-guard.js","sourceRoot":"","sources":["../../../src/auth/guards/session-guard.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-guard.js","sourceRoot":"","sources":["../../../src/auth/guards/session-guard.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAe1D,MAAM,OAAO,YAAY;IACf,KAAK,GAAoB,IAAI,CAAC;IAC9B,QAAQ,GAAG,KAAK,CAAC;IACR,OAAO,CAAS;IAChB,QAAQ,CAAoD;IACrE,OAAO,CAAiB;IACxB,GAAG,CAAc;IAEzB,YAAY,GAAgB,EAAE,OAAuB,EAAE,MAA0B;QAC/E,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,WAAW,CAAC;QAC7C,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAClC,CAAC;IAEM,IAAI;QACT,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAEM,KAAK;QACV,OAAO,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC;IAC7B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,YAAY;QACvB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,iBAAiB,CAAC,sCAAsC,CAAC,CAAC;YACrF,OAAO,IAAI,CAAC,KAAK,CAAC;QACpB,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAA0B,IAAI,CAAC,OAAO,CAAC,CAAC;QAElF,IAAI,CAAC,WAAW,EAAE,EAAE,EAAE,CAAC;YACrB,MAAM,IAAI,iBAAiB,CAAC,mCAAmC,CAAC,CAAC;QACnE,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACxC,MAAM,IAAI,iBAAiB,CAAC,wCAAwC,CAAC,CAAC;QACxE,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,WAAW;QACtB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,KAAK,CAAC,IAAc,EAAE,UAAwB,EAAE;QAC3D,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAEtD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,MAAM,QAAQ,GAAG,OAAO,CAAC,gBAAgB,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,UAAU;YAC1E,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACzC,CAAC;QAED,oDAAoD;QACpD,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;IACvB,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,MAAM;QACjB,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxC,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;IACxB,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,OAAO,CAClB,IAAqC,EACrC,aAAqB,EACrB,UAAwB,EAAE;QAE1B,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QAC7D,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QAEzB,gCAAgC;QAChC,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,IAAI,CAAC;QAC5C,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/auth/policy.js

@@ -20,7 +20,7 @@ export class PolicyEngine {
     async check(user, module, action, resource) {
         if (!user)
             return false;
-        // Check wildcard action for module (e.g. 'Patient:*')
+        // Check wildcard action for module (e.g. 'Post:*')
         const wildcardKey = `${module}:*`;
         if (this.policies.has(wildcardKey)) {
             const fn = this.policies.get(wildcardKey);

package/dist/auth/policy.js.map

@@ -1 +1 @@
-{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/auth/policy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAInD,MAAM,OAAO,YAAY;IACf,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;IAErD;;;OAGG;IACI,MAAM,CAAC,YAAoB,EAAE,QAAwB;QAC1D,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,KAAK,CAAC,IAAS,EAAE,MAAc,EAAE,MAAc,EAAE,QAAc;QAC1E,IAAI,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QAExB,sDAAsD;QACtD,MAAM,WAAW,GAAG,GAAG,MAAM,IAAI,CAAC;QAClC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YACnC,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAE,CAAC;YAC3C,IAAI,MAAM,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC;gBAAE,OAAO,IAAI,CAAC;QAC5C,CAAC;QAED,wBAAwB;QACxB,MAAM,GAAG,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;YACnC,OAAO,MAAM,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAClC,CAAC;QAED,oCAAoC;QACpC,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,MAAM,MAAM,GAAG,UAAU,GAAQ;QAC/B,kDAAkD;QAClD,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,cAAc,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC;IACxD,CAAC,CAAC;IACD,MAAc,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;IACtC,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/auth/policy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAInD,MAAM,OAAO,YAAY;IACf,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;IAErD;;;OAGG;IACI,MAAM,CAAC,YAAoB,EAAE,QAAwB;QAC1D,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,KAAK,CAAC,IAAS,EAAE,MAAc,EAAE,MAAc,EAAE,QAAc;QAC1E,IAAI,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QAExB,mDAAmD;QACnD,MAAM,WAAW,GAAG,GAAG,MAAM,IAAI,CAAC;QAClC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YACnC,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAE,CAAC;YAC3C,IAAI,MAAM,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC;gBAAE,OAAO,IAAI,CAAC;QAC5C,CAAC;QAED,wBAAwB;QACxB,MAAM,GAAG,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;YACnC,OAAO,MAAM,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAClC,CAAC;QAED,oCAAoC;QACpC,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,MAAM,MAAM,GAAG,UAAU,GAAQ;QAC/B,kDAAkD;QAClD,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,cAAc,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC;IACxD,CAAC,CAAC;IACD,MAAc,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;IACtC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cli/commands/make.js

@@ -220,7 +220,7 @@ export function makePolicy(name, targetDir = 'app/policies') {
   }
 
   public create(user: any): boolean {
-    return user.role === 'admin' || user.role === 'doctor';
+    return user.role === 'admin' || user.role === 'editor';
   }
 
   public update(user: any, resource: any): boolean {

package/dist/cli/runner.js

@@ -250,7 +250,7 @@ Options:
 
 Available Commands:
   init [dir]                 Scaffold a complete production AeroJS application
-  new <name> [--template]    Create a new AeroJS app (api-starter, react-inertia, vue-inertia, hospital-erp)
+  new <name> [--template]    Create a new AeroJS app (api-starter, react-inertia, vue-inertia, fullstack)
 
   make:controller <name>     Create a new RESTful controller class
   make:model <name> [-m]     Create a new Active Record Model (optionally with migration)

package/dist/database/model-hooks.d.ts

@@ -4,11 +4,11 @@
  * @poppinss/hooks pattern. Supports multiple handlers per event, async execution,
  * decorator-based registration, and one-time hooks.
  *
- * Hospital use:
- *   @beforeSave()  → auto hash password before every save
- *   @beforeCreate() → generate MRN (Medical Record Number)
- *   @afterCreate() → send welcome SMS to new patient
- *   @beforeDelete() → block hard-delete on financial records
+ * Typical use-cases:
+ *   @beforeSave()   → auto-hash password before saving
+ *   @beforeCreate() → generate unique reference code or UUID
+ *   @afterCreate()  → dispatch UserRegistered domain event or send welcome notification
+ *   @beforeDelete() → block deletion or enforce soft-delete policy
  *   @afterUpdate()  → write immutable audit trail
  */
 export type ModelHookEvent = 'beforeCreate' | 'afterCreate' | 'beforeSave' | 'afterSave' | 'beforeUpdate' | 'afterUpdate' | 'beforeDelete' | 'afterDelete' | 'beforeFind' | 'afterFind' | 'beforeFetch' | 'afterFetch';

package/dist/database/model-hooks.js

@@ -4,11 +4,11 @@
  * @poppinss/hooks pattern. Supports multiple handlers per event, async execution,
  * decorator-based registration, and one-time hooks.
  *
- * Hospital use:
- *   @beforeSave()  → auto hash password before every save
- *   @beforeCreate() → generate MRN (Medical Record Number)
- *   @afterCreate() → send welcome SMS to new patient
- *   @beforeDelete() → block hard-delete on financial records
+ * Typical use-cases:
+ *   @beforeSave()   → auto-hash password before saving
+ *   @beforeCreate() → generate unique reference code or UUID
+ *   @afterCreate()  → dispatch UserRegistered domain event or send welcome notification
+ *   @beforeDelete() → block deletion or enforce soft-delete policy
  *   @afterUpdate()  → write immutable audit trail
  */
 // ─── Hook Registry ────────────────────────────────────────────────────────────
@@ -69,22 +69,22 @@ export function getHookRegistry(ModelClass) {
  * as a lifecycle hook handler.
  *
  * @example
- * class Patient extends Model {
+ * class User extends Model {
  *   @beforeCreate()
- *   public static generateMrn(instance: Patient) {
- *     instance.mrn = `AKMMCH-${Date.now()}`;
+ *   public static generateUuid(instance: User) {
+ *     instance.uuid = crypto.randomUUID();
  *   }
  *
  *   @beforeSave()
- *   public static async hashPassword(instance: Patient) {
+ *   public static async hashPassword(instance: User) {
  *     if (instance.$dirty.password) {
  *       instance.password = await hash(instance.password);
  *     }
  *   }
  *
  *   @beforeDelete()
- *   public static blockHardDelete(_instance: Patient) {
- *     throw new Error('Hard delete not allowed. Use patient.void() instead.');
+ *   public static enforceSoftDelete(_instance: User) {
+ *     // Enforce soft-delete logic
  *   }
  * }
  */

package/dist/database/model.d.ts

@@ -10,12 +10,12 @@
  *  🆕 NEW: $dirty tracking (know exactly what changed)
  *  🆕 NEW: $original + isDirty(field) helpers
  *
- * Hospital uses:
- *   - Doctor ↔ Specialization (manyToMany via doctor_specializations)
- *   - Hospital → Wards → Beds (hasManyThrough)
- *   - Patient.query().active().opd().byBranch(1).paginate(1, 20)
- *   - @beforeCreate() → generate MRN
- *   - @beforeDelete() → block hard-delete on medical records
+ * Examples:
+ *   - User ↔ Role (manyToMany via user_roles)
+ *   - Country → Users → Posts (hasManyThrough)
+ *   - User.query().active().verified().byRole('admin').paginate(1, 20)
+ *   - @beforeCreate() → generate UUID or reference code
+ *   - @beforeDelete() → enforce audit retention policy
  */
 import { type DatabaseAdapter } from './connection.js';
 export interface RelationDefinition {
@@ -71,13 +71,7 @@ export declare class Relation implements PromiseLike<any> {
  * Computed properties are derived from other attributes (not stored in DB).
  *
  * @example
- * class Patient extends Model {
- *   @computed()
- *   get age(): number {
- *     const dob = new Date(this.date_of_birth);
- *     return Math.floor((Date.now() - dob.getTime()) / (365.25 * 24 * 3600 * 1000));
- *   }
- *
+ * class User extends Model {
  *   @computed()
  *   get fullName(): string {
  *     return `${this.first_name} ${this.last_name}`;
@@ -90,7 +84,7 @@ export declare function computed(): PropertyDecorator;
  * The attribute is stored encrypted in the database, but read and manipulated as plaintext in application code.
  *
  * @example
- * class Patient extends Model {
+ * class AccountRecord extends Model {
  *   @encrypted()
  *   public ssn!: string;
  * }
@@ -118,8 +112,8 @@ export declare class Model {
      * Global query scopes automatically applied to every query.
      *
      * @example
-     * class Patient extends Model {
-     *   public static override globalScopes = [BranchScope, ActiveScope];
+     * class User extends Model {
+     *   public static override globalScopes = [TenantScope, ActiveScope];
      * }
      */
     static globalScopes: Array<(qb: any, ctx?: any) => void>;
@@ -147,32 +141,22 @@ export declare class Model {
      * ManyToMany Relationship via a pivot table.
      *
      * @example
-     * // Doctor ↔ Specialization (pivot: doctor_specializations)
-     * public specializations() {
-     *   return this.manyToMany(Specialization, {
-     *     pivotTable: 'doctor_specializations',
-     *     pivotForeignKey: 'doctor_id',
-     *     pivotRelatedKey: 'specialization_id',
-     *     pivotColumns: ['certified_at'], // extra pivot columns
-     *   });
-     * }
-     *
-     * // Patient ↔ ICD-11 Diagnosis (pivot: patient_diagnoses)
-     * public diagnoses() {
-     *   return this.manyToMany(Diagnosis, {
-     *     pivotTable: 'patient_diagnoses',
-     *     pivotForeignKey: 'patient_id',
-     *     pivotRelatedKey: 'diagnosis_code',
+     * // User ↔ Role (pivot: user_roles)
+     * public roles() {
+     *   return this.manyToMany(Role, {
+     *     pivotTable: 'user_roles',
+     *     pivotForeignKey: 'user_id',
+     *     pivotRelatedKey: 'role_id',
+     *     pivotColumns: ['assigned_at'], // extra pivot columns
      *   });
      * }
      *
-     * // OT Surgery ↔ Surgeon team (pivot: ot_surgery_doctors)
-     * public surgeons() {
-     *   return this.manyToMany(Doctor, {
-     *     pivotTable: 'ot_surgery_doctors',
-     *     pivotForeignKey: 'surgery_id',
-     *     pivotRelatedKey: 'doctor_id',
-     *     pivotColumns: ['role'], // primary_surgeon, assistant, anesthesiologist
+     * // Article ↔ Tag (pivot: article_tags)
+     * public tags() {
+     *   return this.manyToMany(Tag, {
+     *     pivotTable: 'article_tags',
+     *     pivotForeignKey: 'article_id',
+     *     pivotRelatedKey: 'tag_id',
      *   });
      * }
      */
@@ -181,19 +165,19 @@ export declare class Model {
      * HasManyThrough Relationship.
      *
      * @example
-     * // Hospital has many Beds through Wards
-     * public beds() {
-     *   return this.hasManyThrough(Bed, Ward, {
-     *     foreignKey: 'hospital_id',       // FK on Ward pointing to Hospital
-     *     throughForeignKey: 'ward_id',    // FK on Bed pointing to Ward
+     * // Country has many Posts through Users
+     * public posts() {
+     *   return this.hasManyThrough(Post, User, {
+     *     foreignKey: 'country_id',       // FK on User pointing to Country
+     *     throughForeignKey: 'user_id',   // FK on Post pointing to User
      *   });
      * }
      *
-     * // Country has many Patients through Hospitals
-     * public patients() {
-     *   return this.hasManyThrough(Patient, Hospital, {
-     *     foreignKey: 'country_id',
-     *     throughForeignKey: 'hospital_id',
+     * // Organization has many Tasks through Projects
+     * public tasks() {
+     *   return this.hasManyThrough(Task, Project, {
+     *     foreignKey: 'organization_id',
+     *     throughForeignKey: 'project_id',
      *   });
      * }
      */
@@ -202,27 +186,27 @@ export declare class Model {
      * Attach related records to the ManyToMany pivot table.
      *
      * @example
-     * // Attach specializations to doctor
-     * await doctor.attach('specializations', [1, 3, 5]);
+     * // Attach roles to user
+     * await user.attach('roles', [1, 3, 5]);
      *
-     * // Attach with pivot data (e.g. certified_at date)
-     * await doctor.attach('specializations', { 1: { certified_at: '2024-01-01' } });
+     * // Attach with pivot data (e.g. assigned_at date)
+     * await user.attach('roles', { 1: { assigned_at: '2024-01-01' } });
      */
     attach(relationName: string, idsOrMap: number[] | string[] | Record<string | number, Record<string, any>>, connectionOrAdapter?: string | DatabaseAdapter): Promise<void>;
     /**
      * Detach related records from the ManyToMany pivot table.
      *
      * @example
-     * await doctor.detach('specializations', [3]); // detach specific
-     * await doctor.detach('specializations');       // detach all
+     * await user.detach('roles', [3]); // detach specific
+     * await user.detach('roles');       // detach all
      */
     detach(relationName: string, ids?: number[] | string[], connectionOrAdapter?: string | DatabaseAdapter): Promise<void>;
     /**
      * Sync pivot table — detach all then re-attach.
      *
      * @example
-     * // Sync a doctor's specializations (replaces all existing)
-     * await doctor.sync('specializations', [1, 3, 5]);
+     * // Sync user's roles (replaces all existing)
+     * await user.sync('roles', [1, 3, 5]);
      */
     sync(relationName: string, idsOrMap: number[] | string[] | Record<string | number, Record<string, any>>, connectionOrAdapter?: string | DatabaseAdapter): Promise<void>;
     /**
@@ -263,8 +247,8 @@ export declare class Model {
      * Update or create a record.
      *
      * @example
-     * await Patient.updateOrCreate(
-     *   { mrn: 'AKMMCH-2024-0001' },
+     * await User.updateOrCreate(
+     *   { email: 'user@example.com' },
      *   { name: 'Rahim', phone: '01700000000' }
      * );
      */

package/dist/database/model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/database/model.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/database/model.ts"],"names":[],"mappings":"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"}

package/dist/database/model.js

@@ -11,12 +11,12 @@ import { TenancyContext } from '../tenancy/tenant.js';
  *  🆕 NEW: $dirty tracking (know exactly what changed)
  *  🆕 NEW: $original + isDirty(field) helpers
  *
- * Hospital uses:
- *   - Doctor ↔ Specialization (manyToMany via doctor_specializations)
- *   - Hospital → Wards → Beds (hasManyThrough)
- *   - Patient.query().active().opd().byBranch(1).paginate(1, 20)
- *   - @beforeCreate() → generate MRN
- *   - @beforeDelete() → block hard-delete on medical records
+ * Examples:
+ *   - User ↔ Role (manyToMany via user_roles)
+ *   - Country → Users → Posts (hasManyThrough)
+ *   - User.query().active().verified().byRole('admin').paginate(1, 20)
+ *   - @beforeCreate() → generate UUID or reference code
+ *   - @beforeDelete() → enforce audit retention policy
  */
 import { Database } from './connection.js';
 import { QueryBuilder } from './query-builder.js';
@@ -162,13 +162,7 @@ export class Relation {
  * Computed properties are derived from other attributes (not stored in DB).
  *
  * @example
- * class Patient extends Model {
- *   @computed()
- *   get age(): number {
- *     const dob = new Date(this.date_of_birth);
- *     return Math.floor((Date.now() - dob.getTime()) / (365.25 * 24 * 3600 * 1000));
- *   }
- *
+ * class User extends Model {
  *   @computed()
  *   get fullName(): string {
  *     return `${this.first_name} ${this.last_name}`;
@@ -189,7 +183,7 @@ export function computed() {
  * The attribute is stored encrypted in the database, but read and manipulated as plaintext in application code.
  *
  * @example
- * class Patient extends Model {
+ * class AccountRecord extends Model {
  *   @encrypted()
  *   public ssn!: string;
  * }
@@ -261,8 +255,8 @@ export class Model {
      * Global query scopes automatically applied to every query.
      *
      * @example
-     * class Patient extends Model {
-     *   public static override globalScopes = [BranchScope, ActiveScope];
+     * class User extends Model {
+     *   public static override globalScopes = [TenantScope, ActiveScope];
      * }
      */
     static globalScopes = [];
@@ -395,32 +389,22 @@ export class Model {
      * ManyToMany Relationship via a pivot table.
      *
      * @example
-     * // Doctor ↔ Specialization (pivot: doctor_specializations)
-     * public specializations() {
-     *   return this.manyToMany(Specialization, {
-     *     pivotTable: 'doctor_specializations',
-     *     pivotForeignKey: 'doctor_id',
-     *     pivotRelatedKey: 'specialization_id',
-     *     pivotColumns: ['certified_at'], // extra pivot columns
-     *   });
-     * }
-     *
-     * // Patient ↔ ICD-11 Diagnosis (pivot: patient_diagnoses)
-     * public diagnoses() {
-     *   return this.manyToMany(Diagnosis, {
-     *     pivotTable: 'patient_diagnoses',
-     *     pivotForeignKey: 'patient_id',
-     *     pivotRelatedKey: 'diagnosis_code',
+     * // User ↔ Role (pivot: user_roles)
+     * public roles() {
+     *   return this.manyToMany(Role, {
+     *     pivotTable: 'user_roles',
+     *     pivotForeignKey: 'user_id',
+     *     pivotRelatedKey: 'role_id',
+     *     pivotColumns: ['assigned_at'], // extra pivot columns
      *   });
      * }
      *
-     * // OT Surgery ↔ Surgeon team (pivot: ot_surgery_doctors)
-     * public surgeons() {
-     *   return this.manyToMany(Doctor, {
-     *     pivotTable: 'ot_surgery_doctors',
-     *     pivotForeignKey: 'surgery_id',
-     *     pivotRelatedKey: 'doctor_id',
-     *     pivotColumns: ['role'], // primary_surgeon, assistant, anesthesiologist
+     * // Article ↔ Tag (pivot: article_tags)
+     * public tags() {
+     *   return this.manyToMany(Tag, {
+     *     pivotTable: 'article_tags',
+     *     pivotForeignKey: 'article_id',
+     *     pivotRelatedKey: 'tag_id',
      *   });
      * }
      */
@@ -446,19 +430,19 @@ export class Model {
      * HasManyThrough Relationship.
      *
      * @example
-     * // Hospital has many Beds through Wards
-     * public beds() {
-     *   return this.hasManyThrough(Bed, Ward, {
-     *     foreignKey: 'hospital_id',       // FK on Ward pointing to Hospital
-     *     throughForeignKey: 'ward_id',    // FK on Bed pointing to Ward
+     * // Country has many Posts through Users
+     * public posts() {
+     *   return this.hasManyThrough(Post, User, {
+     *     foreignKey: 'country_id',       // FK on User pointing to Country
+     *     throughForeignKey: 'user_id',   // FK on Post pointing to User
      *   });
      * }
      *
-     * // Country has many Patients through Hospitals
-     * public patients() {
-     *   return this.hasManyThrough(Patient, Hospital, {
-     *     foreignKey: 'country_id',
-     *     throughForeignKey: 'hospital_id',
+     * // Organization has many Tasks through Projects
+     * public tasks() {
+     *   return this.hasManyThrough(Task, Project, {
+     *     foreignKey: 'organization_id',
+     *     throughForeignKey: 'project_id',
      *   });
      * }
      */
@@ -482,11 +466,11 @@ export class Model {
      * Attach related records to the ManyToMany pivot table.
      *
      * @example
-     * // Attach specializations to doctor
-     * await doctor.attach('specializations', [1, 3, 5]);
+     * // Attach roles to user
+     * await user.attach('roles', [1, 3, 5]);
      *
-     * // Attach with pivot data (e.g. certified_at date)
-     * await doctor.attach('specializations', { 1: { certified_at: '2024-01-01' } });
+     * // Attach with pivot data (e.g. assigned_at date)
+     * await user.attach('roles', { 1: { assigned_at: '2024-01-01' } });
      */
     async attach(relationName, idsOrMap, connectionOrAdapter) {
         const rel = this[relationName]();
@@ -515,8 +499,8 @@ export class Model {
      * Detach related records from the ManyToMany pivot table.
      *
      * @example
-     * await doctor.detach('specializations', [3]); // detach specific
-     * await doctor.detach('specializations');       // detach all
+     * await user.detach('roles', [3]); // detach specific
+     * await user.detach('roles');       // detach all
      */
     async detach(relationName, ids, connectionOrAdapter) {
         const rel = this[relationName]();
@@ -535,8 +519,8 @@ export class Model {
      * Sync pivot table — detach all then re-attach.
      *
      * @example
-     * // Sync a doctor's specializations (replaces all existing)
-     * await doctor.sync('specializations', [1, 3, 5]);
+     * // Sync user's roles (replaces all existing)
+     * await user.sync('roles', [1, 3, 5]);
      */
     async sync(relationName, idsOrMap, connectionOrAdapter) {
         await this.detach(relationName, undefined, connectionOrAdapter);
@@ -862,8 +846,8 @@ export class Model {
      * Update or create a record.
      *
      * @example
-     * await Patient.updateOrCreate(
-     *   { mrn: 'AKMMCH-2024-0001' },
+     * await User.updateOrCreate(
+     *   { email: 'user@example.com' },
      *   { name: 'Rahim', phone: '01700000000' }
      * );
      */