factor-based-permissions 0.0.1 → 0.0.2

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export declare class FactorBasedPermissions<TFactor extends number, TPermission extends number> {
+    private _factorsLookup;
+    private _permissionsLookup;
+    private _permissionCheckLookup;
+    constructor(serialized?: string | null | undefined);
+    private _parseFactors;
+    private _parsePermissions;
+    checkPermission(permission: TPermission): boolean | null;
+    getSatisfiedFactors(permission: TPermission): TFactor[];
+    getMissingFactors(permission: TPermission): TFactor[];
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAmBA,qBAAa,sBAAsB,CAAC,OAAO,SAAS,MAAM,EAAE,WAAW,SAAS,MAAM;IACpF,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,kBAAkB,CAAqC;IAC/D,OAAO,CAAC,sBAAsB,CAA0C;gBAErD,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAQzD,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,iBAAiB;IAsBlB,eAAe,CAAC,UAAU,EAAE,WAAW;IAyBvC,mBAAmB,CAAC,UAAU,EAAE,WAAW;IAW3C,iBAAiB,CAAC,UAAU,EAAE,WAAW;CAUjD"}

package/dist/index.js

@@ -0,0 +1,90 @@
+const SATISFIED_FACTORS_PREFIX = "!";
+const PERMISSIONS_PREFIX = "#";
+const ITEMS_DELIM = ",";
+const GROUP_DELIM = "&";
+const REQUIRED_FACTORS_DELIM = "+";
+const groupsRegex = buildGroupsRegex();
+function buildGroupsRegex() {
+    const groupPrefixes = SATISFIED_FACTORS_PREFIX + PERMISSIONS_PREFIX;
+    const satisfiedFactorsGroup = `(?:${SATISFIED_FACTORS_PREFIX}([^${groupPrefixes}]*))?`;
+    const permissionGroupsGroup = `(?:${PERMISSIONS_PREFIX}([^${groupPrefixes}]*))?`;
+    return new RegExp(satisfiedFactorsGroup + permissionGroupsGroup);
+}
+function parseNumeric(value) {
+    return parseInt(value, 32);
+}
+export class FactorBasedPermissions {
+    _factorsLookup = new Map();
+    _permissionsLookup = new Map();
+    _permissionCheckLookup = new Map();
+    constructor(serialized) {
+        if (typeof serialized === "string") {
+            const matches = groupsRegex.exec(serialized);
+            this._parseFactors(matches?.[1] ?? null);
+            this._parsePermissions(matches?.[2] ?? null);
+        }
+    }
+    _parseFactors(satisfiedFactorsGroup) {
+        if (!satisfiedFactorsGroup) {
+            return;
+        }
+        for (const factor of satisfiedFactorsGroup.split(ITEMS_DELIM)) {
+            const factorNumeric = parseNumeric(factor);
+            this._factorsLookup.set(factorNumeric, true);
+        }
+    }
+    _parsePermissions(permissionGroupsGroup) {
+        if (!permissionGroupsGroup) {
+            return;
+        }
+        for (const permissionGroup of permissionGroupsGroup.split(GROUP_DELIM)) {
+            const [permissionsRaw, requiredFactorsRaw] = permissionGroup.split(REQUIRED_FACTORS_DELIM);
+            const permissions = permissionsRaw?.split(ITEMS_DELIM)?.map((parseNumeric)) ?? [];
+            const requiredFactors = requiredFactorsRaw?.split(ITEMS_DELIM)?.map((parseNumeric)) ?? [];
+            for (const permission of permissions) {
+                this._permissionsLookup.set(permission, requiredFactors);
+            }
+            for (const requiredFactor of requiredFactors) {
+                if (!this._factorsLookup.has(requiredFactor)) {
+                    this._factorsLookup.set(requiredFactor, false);
+                }
+            }
+        }
+    }
+    checkPermission(permission) {
+        const cachedResult = this._permissionCheckLookup.get(permission);
+        if (cachedResult !== undefined) {
+            return cachedResult;
+        }
+        const requiredFactors = this._permissionsLookup.get(permission);
+        if (!requiredFactors) {
+            this._permissionCheckLookup.set(permission, null);
+            return null;
+        }
+        for (const requiredFactor of requiredFactors) {
+            if (!this._factorsLookup.get(requiredFactor)) {
+                this._permissionCheckLookup.set(permission, false);
+                return false;
+            }
+        }
+        this._permissionCheckLookup.set(permission, true);
+        return true;
+    }
+    getSatisfiedFactors(permission) {
+        const cachedResult = this._permissionCheckLookup.get(permission);
+        const requiredFactors = this._permissionsLookup.get(permission) ?? [];
+        if (cachedResult === true) {
+            return requiredFactors;
+        }
+        return requiredFactors.filter((factor) => this._factorsLookup.get(factor));
+    }
+    getMissingFactors(permission) {
+        const cachedResult = this._permissionCheckLookup.get(permission);
+        if (cachedResult === true) {
+            return [];
+        }
+        const requiredFactors = this._permissionsLookup.get(permission) ?? [];
+        return requiredFactors.filter((factor) => !this._factorsLookup.get(factor));
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -1,9 +1,25 @@
 {
   "name": "factor-based-permissions",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "",
   "license": "MIT",
-  "author": "",
-  "type": "commonjs",
-  "main": "index.js"
+  "author": "0x2E757",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  }
 }

package/index.js

@@ -1 +0,0 @@
-export default function noop() { }