@open-core/identity 1.2.2 → 1.2.4

package/dist/contracts.d.ts

@@ -45,7 +45,7 @@ export declare abstract class IdentityStore {
      * @param id - The internal account ID.
      * @param data - Partial object containing fields to update.
      */
-    abstract update(id: string, data: Partial<IdentityAccount>): Promise<void>;
+    abstract update(id: string | number, data: Partial<IdentityAccount>): Promise<void>;
     /**
      * Prohibits or allows an account from connecting.
      *
@@ -54,7 +54,7 @@ export declare abstract class IdentityStore {
      * @param reason - Optional explanation for the ban.
      * @param expiresAt - Optional expiration timestamp.
      */
-    abstract setBan(id: string, banned: boolean, reason?: string, expiresAt?: Date | null): Promise<void>;
+    abstract setBan(id: string | number, banned: boolean, reason?: string, expiresAt?: Date | null): Promise<void>;
 }
 /**
  * Persistence contract for security roles.
@@ -66,12 +66,12 @@ export declare abstract class IdentityStore {
  */
 export declare abstract class RoleStore {
     /**
-     * Retrieves a role definition by its technical name.
+     * Retrieves a role definition by its technical identifier.
      *
-     * @param name - Technical name (e.g., 'admin').
+     * @param id - Technical identifier (e.g., 'admin' or 1).
      * @returns A promise resolving to the role or null if not found.
      */
-    abstract findByName(name: string): Promise<IdentityRole | null>;
+    abstract findById(id: string | number): Promise<IdentityRole | null>;
     /**
      * Resolves the default role for newly connected accounts.
      *
@@ -87,7 +87,7 @@ export declare abstract class RoleStore {
     /**
      * Removes a role from the system.
      *
-     * @param name - Technical name of the role to delete.
+     * @param id - Technical identifier of the role to delete.
      */
-    abstract delete(name: string): Promise<void>;
+    abstract delete(id: string | number): Promise<void>;
 }

package/dist/providers/auth/credentials-auth.provider.js

@@ -12,7 +12,6 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 };
 import { injectable, inject } from "tsyringe";
 import { Server } from "@open-core/framework";
-import { v4 as uuidv4 } from "uuid";
 import { IDENTITY_OPTIONS } from "../../tokens";
 import { IdentityStore } from "../../contracts";
 import bcrypt from "bcryptjs";
@@ -68,8 +67,9 @@ let CredentialsAuthProvider = class CredentialsAuthProvider extends Server.AuthP
         if (this.isBanned(account)) {
             return { success: false, error: account.banReason ?? "Account is banned" };
         }
-        player.linkAccount(account.linkedId);
-        return { success: true, accountID: account.linkedId };
+        const accountIdStr = String(account.id);
+        player.linkAccount(accountIdStr);
+        return { success: true, accountID: accountIdStr };
     }
     /**
      * Registers a new account with a username and password.
@@ -95,11 +95,11 @@ let CredentialsAuthProvider = class CredentialsAuthProvider extends Server.AuthP
             username,
             passwordHash,
             identifier: primaryIdentifier,
-            linkedId: uuidv4(),
-            roleName: this.options.principal.defaultRole || "user",
+            roleId: this.options.principal.defaultRole || "user",
         });
-        player.linkAccount(account.linkedId);
-        return { success: true, accountID: account.linkedId, isNewAccount: true };
+        const accountIdStr = String(account.id);
+        player.linkAccount(accountIdStr);
+        return { success: true, accountID: accountIdStr, isNewAccount: true };
     }
     /**
      * Validates if the player's current linked account session is still active.
@@ -115,7 +115,7 @@ let CredentialsAuthProvider = class CredentialsAuthProvider extends Server.AuthP
         if (!account || this.isBanned(account)) {
             return { success: false, error: "Session invalid or account banned" };
         }
-        return { success: true, accountID: account.linkedId };
+        return { success: true, accountID: String(account.id) };
     }
     /**
      * Performs logout logic for the player.

package/dist/providers/auth/local-auth.provider.js

@@ -12,7 +12,6 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 };
 import { injectable, inject } from "tsyringe";
 import { Server } from "@open-core/framework";
-import { v4 as uuidv4 } from "uuid";
 import { IDENTITY_OPTIONS } from "../../tokens";
 import { IdentityStore } from "../../contracts";
 /**
@@ -85,7 +84,7 @@ let LocalAuthProvider = class LocalAuthProvider extends Server.AuthProviderContr
         if (account.isBanned && (!account.banExpiresAt || account.banExpiresAt > new Date())) {
             return { success: false, error: account.banReason ?? "Account is banned" };
         }
-        return { success: true, accountID: account.linkedId };
+        return { success: true, accountID: String(account.id) };
     }
     /**
      * Clears the authentication state for a player.
@@ -115,8 +114,7 @@ let LocalAuthProvider = class LocalAuthProvider extends Server.AuthProviderContr
             }
             account = await this.store.create({
                 identifier: identifierValue,
-                linkedId: uuidv4(),
-                roleName: "user",
+                roleId: "user",
             });
             isNew = true;
         }
@@ -131,8 +129,9 @@ let LocalAuthProvider = class LocalAuthProvider extends Server.AuthProviderContr
                 };
             }
         }
-        player.linkAccount(account.linkedId);
-        return { success: true, accountID: account.linkedId, isNewAccount: isNew };
+        const accountIdStr = String(account.id);
+        player.linkAccount(accountIdStr);
+        return { success: true, accountID: accountIdStr, isNewAccount: isNew };
     }
     /**
      * Internal implementation for API-based authentication strategy.

package/dist/providers/principal/local-principal.provider.js

@@ -102,29 +102,37 @@ let IdentityPrincipalProvider = class IdentityPrincipalProvider extends Server.P
         if (!account)
             return null;
         let role;
-        if (this.options.principal.mode === "roles") {
-            role = this.options.principal.roles?.[account.roleName];
-        }
-        else if (this.roleStore) {
-            const dbRole = await this.roleStore.findByName(account.roleName);
-            if (dbRole)
-                role = dbRole;
+        const roleId = account.roleId;
+        if (roleId !== undefined && roleId !== null && roleId !== "") {
+            if (this.options.principal.mode === "roles") {
+                role = this.options.principal.roles?.[roleId];
+            }
+            else if (this.roleStore) {
+                const dbRole = await this.roleStore.findById(roleId);
+                if (dbRole)
+                    role = dbRole;
+            }
         }
         if (!role) {
-            const defaultName = this.options.principal.defaultRole || "user";
-            role = this.options.principal.roles?.[defaultName];
+            const defaultRoleId = this.options.principal.defaultRole;
+            if (defaultRoleId !== undefined && defaultRoleId !== null && defaultRoleId !== "") {
+                role = this.options.principal.roles?.[defaultRoleId];
+                if (!role && this.roleStore && this.options.principal.mode === "db") {
+                    role = await this.roleStore.getDefaultRole();
+                }
+            }
         }
         if (!role)
             return null;
         const effectivePermissions = this.mergePermissions(role.permissions, account.customPermissions);
         return {
-            id: account.linkedId,
-            name: role.displayName || role.name,
+            id: linkedId,
+            name: role.displayName || String(role.id),
             rank: role.rank,
             permissions: effectivePermissions,
             meta: {
                 accountId: account.id,
-                roleName: role.name,
+                roleId: role.id,
             },
         };
     }

package/dist/services/account.service.d.ts

@@ -30,10 +30,10 @@ export declare class AccountService {
     /**
      * Assigns a security role to an account.
      *
-     * @param accountId - The linked ID of the account.
-     * @param roleName - Technical name of the role to assign.
+     * @param accountId - The unique ID of the account.
+     * @param roleId - Technical identifier of the role to assign.
      */
-    assignRole(accountId: string, roleName: string): Promise<void>;
+    assignRole(accountId: string | number, roleId: string | number): Promise<void>;
     /**
      * Grants a custom permission override to an account.
      *

package/dist/services/account.service.js

@@ -48,11 +48,11 @@ let AccountService = class AccountService {
     /**
      * Assigns a security role to an account.
      *
-     * @param accountId - The linked ID of the account.
-     * @param roleName - Technical name of the role to assign.
+     * @param accountId - The unique ID of the account.
+     * @param roleId - Technical identifier of the role to assign.
      */
-    async assignRole(accountId, roleName) {
-        await this.store.update(accountId, { roleName });
+    async assignRole(accountId, roleId) {
+        await this.store.update(accountId, { roleId });
     }
     /**
      * Grants a custom permission override to an account.

package/dist/services/role.service.d.ts

@@ -30,23 +30,23 @@ export declare class RoleService {
     /**
      * Updates an existing role's rank or permissions.
      *
-     * @param name - The unique technical name of the role to update.
+     * @param id - The unique technical identifier of the role to update.
      * @param data - Partial object containing the fields to modify.
      * @returns A promise that resolves when the update is complete.
      */
-    update(name: string, data: Partial<Omit<IdentityRole, "name">>): Promise<void>;
+    update(id: string | number, data: Partial<Omit<IdentityRole, "id">>): Promise<void>;
     /**
      * Permanently removes a role definition from the system.
      *
-     * @param name - The technical name of the role to delete.
+     * @param id - The technical identifier of the role to delete.
      * @returns A promise that resolves when the role is deleted.
      */
-    delete(name: string): Promise<void>;
+    delete(id: string | number): Promise<void>;
     /**
      * Retrieves the full list of permissions granted to a specific role.
      *
-     * @param name - The technical name of the role.
+     * @param id - The technical identifier of the role.
      * @returns A promise resolving to an array of permission strings.
      */
-    getPermissions(name: string): Promise<string[]>;
+    getPermissions(id: string | number): Promise<string[]>;
 }

package/dist/services/role.service.js

@@ -46,12 +46,12 @@ let RoleService = class RoleService {
     /**
      * Updates an existing role's rank or permissions.
      *
-     * @param name - The unique technical name of the role to update.
+     * @param id - The unique technical identifier of the role to update.
      * @param data - Partial object containing the fields to modify.
      * @returns A promise that resolves when the update is complete.
      */
-    async update(name, data) {
-        const existing = await this.store.findByName(name);
+    async update(id, data) {
+        const existing = await this.store.findById(id);
         if (!existing)
             return;
         await this.store.save({
@@ -62,20 +62,20 @@ let RoleService = class RoleService {
     /**
      * Permanently removes a role definition from the system.
      *
-     * @param name - The technical name of the role to delete.
+     * @param id - The technical identifier of the role to delete.
      * @returns A promise that resolves when the role is deleted.
      */
-    async delete(name) {
-        await this.store.delete(name);
+    async delete(id) {
+        await this.store.delete(id);
     }
     /**
      * Retrieves the full list of permissions granted to a specific role.
      *
-     * @param name - The technical name of the role.
+     * @param id - The technical identifier of the role.
      * @returns A promise resolving to an array of permission strings.
      */
-    async getPermissions(name) {
-        const role = await this.store.findByName(name);
+    async getPermissions(id) {
+        const role = await this.store.findById(id);
         return role?.permissions || [];
     }
 };

package/dist/types.d.ts

@@ -31,9 +31,9 @@ export type PrincipalMode = "roles" | "db" | "api";
  */
 export interface IdentityRole {
     /**
-     * Technical identifier for the role (e.g., 'admin', 'moderator', 'user').
+     * Technical identifier for the role (e.g., 'admin', 1, 'uuid').
      */
-    name: string;
+    id: string | number;
     /**
      * Hierarchical weight.
      *
@@ -93,12 +93,12 @@ export interface IdentityOptions {
          *
          * Required when mode is 'roles'.
          */
-        roles?: Record<string, IdentityRole>;
+        roles?: Record<string | number, IdentityRole>;
         /**
-         * The name of the role assigned to newly created accounts.
+         * The ID of the role assigned to newly created accounts.
          * @defaultValue 'user'
          */
-        defaultRole?: string;
+        defaultRole?: string | number;
         /**
          * Time-to-live in milliseconds for cached principal data.
          *
@@ -121,21 +121,15 @@ export interface IdentityAccount {
     /**
      * Internal unique database/store ID.
      */
-    id: string;
-    /**
-     * External stable ID used by the framework (linkedID).
-     *
-     * Usually a UUID or an external system ID.
-     */
-    linkedId: string;
+    id: string | number;
     /**
      * Primary connection identifier (e.g., 'license:123...').
      */
     identifier: string;
     /**
-     * Current technical role name assigned to this account.
+     * Current technical role ID assigned to this account.
      */
-    roleName: string;
+    roleId?: string | number;
     /**
      * Optional technical username for credentials-based authentication.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-core/identity",
-  "version": "1.2.2",
+  "version": "1.2.4",
   "description": "Enterprise-grade identity, authentication, and authorization plugin for OpenCore Framework",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -14,6 +14,7 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
+    "prepack": "npm run build",
     "clean": "rimraf dist",
     "lint": "eslint . --ext .ts",
     "lint:fix": "eslint . --ext .ts --fix",