@estopia/shared 1.0.39 → 1.0.40

package/dist/helpers/scopeMatching.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Checks if a set of granted scopes satisfies a required scope.
+ * Supports hierarchical matching: a parent scope grants all its children.
+ * Example: 'profile' grants 'profile:read', 'profile:email', etc.
+ *
+ * @param grantedScopes - The list of scopes granted to the user or client.
+ * @param requiredScope - The specific scope being checked.
+ * @returns true if the required scope is granted, false otherwise.
+ */
+export declare function hasScope(grantedScopes: string[], requiredScope: string): boolean;
+//# sourceMappingURL=scopeMatching.d.ts.map

package/dist/helpers/scopeMatching.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scopeMatching.d.ts","sourceRoot":"","sources":["../../src/helpers/scopeMatching.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAYhF"}

package/dist/helpers/scopeMatching.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasScope = hasScope;
+/**
+ * Checks if a set of granted scopes satisfies a required scope.
+ * Supports hierarchical matching: a parent scope grants all its children.
+ * Example: 'profile' grants 'profile:read', 'profile:email', etc.
+ *
+ * @param grantedScopes - The list of scopes granted to the user or client.
+ * @param requiredScope - The specific scope being checked.
+ * @returns true if the required scope is granted, false otherwise.
+ */
+function hasScope(grantedScopes, requiredScope) {
+    if (!grantedScopes || !Array.isArray(grantedScopes))
+        return false;
+    return grantedScopes.some(granted => {
+        // Exact match
+        if (granted === requiredScope)
+            return true;
+        // Parent match (e.g., 'profile' matches 'profile:read')
+        if (requiredScope.startsWith(granted + ':'))
+            return true;
+        return false;
+    });
+}
+//# sourceMappingURL=scopeMatching.js.map

package/dist/helpers/scopeMatching.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scopeMatching.js","sourceRoot":"","sources":["../../src/helpers/scopeMatching.ts"],"names":[],"mappings":";;AASA,4BAYC;AArBD;;;;;;;;GAQG;AACH,SAAgB,QAAQ,CAAC,aAAuB,EAAE,aAAqB;IACrE,IAAI,CAAC,aAAa,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC;QAAE,OAAO,KAAK,CAAC;IAElE,OAAO,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;QAClC,cAAc;QACd,IAAI,OAAO,KAAK,aAAa;YAAE,OAAO,IAAI,CAAC;QAE3C,wDAAwD;QACxD,IAAI,aAAa,CAAC,UAAU,CAAC,OAAO,GAAG,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAEzD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -2,4 +2,5 @@ export type { UserDto } from './types/user';
 export type { DB } from './database/dataTypes';
 export { OAUTH_SCOPES, SCOPE_IDS } from './types/oauth';
 export type { OAuthScope } from './types/oauth';
+export { hasScope } from './helpers/scopeMatching';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EAAE,EAAE,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACxD,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EAAE,EAAE,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACxD,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -1,7 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SCOPE_IDS = exports.OAUTH_SCOPES = void 0;
+exports.hasScope = exports.SCOPE_IDS = exports.OAUTH_SCOPES = void 0;
 var oauth_1 = require("./types/oauth");
 Object.defineProperty(exports, "OAUTH_SCOPES", { enumerable: true, get: function () { return oauth_1.OAUTH_SCOPES; } });
 Object.defineProperty(exports, "SCOPE_IDS", { enumerable: true, get: function () { return oauth_1.SCOPE_IDS; } });
+var scopeMatching_1 = require("./helpers/scopeMatching");
+Object.defineProperty(exports, "hasScope", { enumerable: true, get: function () { return scopeMatching_1.hasScope; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAEA,uCAAwD;AAA/C,qGAAA,YAAY,OAAA;AAAE,kGAAA,SAAS,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAEA,uCAAwD;AAA/C,qGAAA,YAAY,OAAA;AAAE,kGAAA,SAAS,OAAA;AAEhC,yDAAmD;AAA1C,yGAAA,QAAQ,OAAA"}

package/dist/server.d.ts

@@ -9,6 +9,7 @@ export { EventPublisher } from './broker/publisher';
 export { EventSubscriber } from './broker/subscriber';
 export type { EventPayloads } from './broker/eventTypes';
 export { validateJWTToken, tryValidateJWTToken } from './helpers/validateJWTToken';
+export { hasScope } from './helpers/scopeMatching';
 export type { EstopiaRequest } from './types/request';
 export { requireAuth } from './helpers/middlware/auth';
 export { requireSecure } from './helpers/middlware/secure';

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAGnE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGxD,OAAO,EAAE,IAAI,IAAI,iBAAiB,EAAE,MAAM,IAAI,CAAC;AAC/C,OAAO,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,MAAM,IAAI,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEnF,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAGnE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGxD,OAAO,EAAE,IAAI,IAAI,iBAAiB,EAAE,MAAM,IAAI,CAAC;AAC/C,OAAO,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,MAAM,IAAI,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACnF,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEnD,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/server.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.requireAdmin = exports.requireSecure = exports.requireAuth = exports.tryValidateJWTToken = exports.validateJWTToken = exports.EventSubscriber = exports.EventPublisher = exports.DB = exports.ScyllaDBClient = exports.CockroachDBClient = exports.createCockroachDBConnection = exports.createLogger = void 0;
+exports.requireAdmin = exports.requireSecure = exports.requireAuth = exports.hasScope = exports.tryValidateJWTToken = exports.validateJWTToken = exports.EventSubscriber = exports.EventPublisher = exports.DB = exports.ScyllaDBClient = exports.CockroachDBClient = exports.createCockroachDBConnection = exports.createLogger = void 0;
 var logger_1 = require("./logging/logger");
 Object.defineProperty(exports, "createLogger", { enumerable: true, get: function () { return logger_1.createLogger; } });
 var cockroach_1 = require("./database/cockroach");
@@ -19,6 +19,8 @@ Object.defineProperty(exports, "EventSubscriber", { enumerable: true, get: funct
 var validateJWTToken_1 = require("./helpers/validateJWTToken");
 Object.defineProperty(exports, "validateJWTToken", { enumerable: true, get: function () { return validateJWTToken_1.validateJWTToken; } });
 Object.defineProperty(exports, "tryValidateJWTToken", { enumerable: true, get: function () { return validateJWTToken_1.tryValidateJWTToken; } });
+var scopeMatching_1 = require("./helpers/scopeMatching");
+Object.defineProperty(exports, "hasScope", { enumerable: true, get: function () { return scopeMatching_1.hasScope; } });
 var auth_1 = require("./helpers/middlware/auth");
 Object.defineProperty(exports, "requireAuth", { enumerable: true, get: function () { return auth_1.requireAuth; } });
 var secure_1 = require("./helpers/middlware/secure");

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";;;AAAA,2CAAgD;AAAvC,sGAAA,YAAY,OAAA;AAGrB,kDAAmE;AAA1D,wHAAA,2BAA2B,OAAA;AAKpC,iEAAiE;AACjE,yBAA+C;AAAtC,uGAAA,IAAI,OAAqB;AAClC,qDAA4D;AAAnD,kHAAA,MAAM,OAAkB;AACjC,iCAAsC;AAA7B,4FAAA,MAAM,OAAM;AAErB,gDAAoD;AAA3C,2GAAA,cAAc,OAAA;AACvB,kDAAsD;AAA7C,6GAAA,eAAe,OAAA;AAGxB,+DAAmF;AAA1E,oHAAA,gBAAgB,OAAA;AAAE,uHAAA,mBAAmB,OAAA;AAG9C,iDAAuD;AAA9C,mGAAA,WAAW,OAAA;AACpB,qDAA2D;AAAlD,uGAAA,aAAa,OAAA;AACtB,mDAAyD;AAAhD,qGAAA,YAAY,OAAA"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";;;AAAA,2CAAgD;AAAvC,sGAAA,YAAY,OAAA;AAGrB,kDAAmE;AAA1D,wHAAA,2BAA2B,OAAA;AAKpC,iEAAiE;AACjE,yBAA+C;AAAtC,uGAAA,IAAI,OAAqB;AAClC,qDAA4D;AAAnD,kHAAA,MAAM,OAAkB;AACjC,iCAAsC;AAA7B,4FAAA,MAAM,OAAM;AAErB,gDAAoD;AAA3C,2GAAA,cAAc,OAAA;AACvB,kDAAsD;AAA7C,6GAAA,eAAe,OAAA;AAGxB,+DAAmF;AAA1E,oHAAA,gBAAgB,OAAA;AAAE,uHAAA,mBAAmB,OAAA;AAC9C,yDAAmD;AAA1C,yGAAA,QAAQ,OAAA;AAGjB,iDAAuD;AAA9C,mGAAA,WAAW,OAAA;AACpB,qDAA2D;AAAlD,uGAAA,aAAa,OAAA;AACtB,mDAAyD;AAAhD,qGAAA,YAAY,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@estopia/shared",
-  "version": "1.0.39",
+  "version": "1.0.40",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {