@magek/core 0.0.1

package/dist/subscribers-notifier.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MagekSubscribersNotifier = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@magek/common");
+const graphql = require("graphql");
+const graphql_generator_1 = require("./services/graphql/graphql-generator");
+const read_model_pub_sub_1 = require("./services/pub-sub/read-model-pub-sub");
+const instrumentation_1 = require("./instrumentation");
+class MagekSubscribersNotifier {
+    constructor(config) {
+        this.config = config;
+        this.graphQLSchema = graphql_generator_1.GraphQLGenerator.generateSchema(config);
+    }
+    async dispatch(request) {
+        const logger = (0, common_1.getLogger)(this.config, 'MagekSubscribersNotifier#dispatch');
+        try {
+            logger.debug('Received the following event for subscription dispatching: ', request);
+            const readModelEnvelopes = await this.config.readModelStore.rawToEnvelopes(this.config, request);
+            logger.debug('[SubsciptionDispatcher] The following ReadModels were updated: ', readModelEnvelopes);
+            const subscriptions = await this.getSubscriptions(readModelEnvelopes);
+            logger.debug('Found the following subscriptions for those read models: ', subscriptions);
+            const pubSub = this.getPubSub(readModelEnvelopes);
+            await common_1.Promises.allSettledAndFulfilled(subscriptions.map(this.runSubscriptionAndNotify.bind(this, pubSub)));
+        }
+        catch (e) {
+            logger.error(e);
+        }
+    }
+    getReadModelInstance(envelope) {
+        const readModelMetadata = this.config.readModels[envelope.typeName];
+        if (!readModelMetadata) {
+            throw new Error('Could not get information about read model with name: ' + envelope.typeName);
+        }
+        const readModelInstance = new readModelMetadata.class();
+        Object.assign(readModelInstance, envelope.value);
+        return readModelInstance;
+    }
+    async getSubscriptions(readModelEnvelopes) {
+        const readModelNames = readModelEnvelopes.map((readModelEnvelope) => readModelEnvelope.typeName);
+        const readModelUniqueNames = [...new Set(readModelNames)];
+        const subscriptionSets = await Promise.all(readModelUniqueNames.map((name) => this.config.sessionStore.fetchSubscriptionsByClassName(this.config, name)));
+        return subscriptionSets.flat();
+    }
+    getPubSub(readModelEnvelopes) {
+        const readModelInstances = readModelEnvelopes.map(this.getReadModelInstance, this);
+        return new read_model_pub_sub_1.FilteredReadModelPubSub(readModelInstances);
+    }
+    async runSubscriptionAndNotify(pubSub, subscription) {
+        const logger = (0, common_1.getLogger)(this.config, 'MagekSubscribersNotifier#runSubscriptionAndNotify');
+        const context = {
+            connectionID: subscription.connectionID,
+            responseHeaders: {},
+            requestID: subscription.requestID,
+            user: subscription.currentUser,
+            operation: subscription.operation,
+            pubSub,
+            storeSubscriptions: false, // We don't store the subscription again, just get the result now
+        };
+        const document = this.parseSubscriptionQuery(subscription.operation.query);
+        logger.debug('Running subscription with context: ', context);
+        const iterator = await graphql.subscribe({
+            contextValue: context,
+            document: document,
+            schema: this.graphQLSchema,
+            variableValues: subscription.operation.variables,
+        });
+        if ('next' in iterator) {
+            // It is an AsyncIterator
+            return this.processSubscriptionsIterator(iterator, subscription);
+        }
+        // If "subscribe" returns an ExecutionResult (instead of an async iterator) the subscription failed.
+        throw iterator.errors;
+    }
+    parseSubscriptionQuery(query) {
+        const document = graphql.parse(query);
+        // We probably don't need to validate this again, as it was validated before storing it. BUT! It's always better to fail early
+        const errors = graphql.validate(this.graphQLSchema, document);
+        if (errors.length > 0) {
+            throw errors;
+        }
+        return document;
+    }
+    async processSubscriptionsIterator(iterator, subscription) {
+        const notificationPromises = [];
+        for await (const result of iterator) {
+            notificationPromises.push(this.notifyWithGraphQLResult(subscription, result));
+        }
+        return Promise.all(notificationPromises);
+    }
+    async notifyWithGraphQLResult(subscription, result) {
+        const logger = (0, common_1.getLogger)(this.config, 'MagekSubscribersNotifier#notifyWithGraphQLResult');
+        if (result.errors) {
+            throw result.errors;
+        }
+        const readModel = result.data;
+        const message = new common_1.GraphQLData(subscription.operation.id, { data: readModel });
+        logger.debug(`Notifying connectionID '${subscription.connectionID}' with the following wrappeed read model: `, readModel);
+        await this.config.provider.messaging.sendMessage(this.config, subscription.connectionID, message);
+        logger.debug('Notifications sent');
+    }
+}
+exports.MagekSubscribersNotifier = MagekSubscribersNotifier;
+tslib_1.__decorate([
+    (0, instrumentation_1.Trace)(common_1.TraceActionTypes.DISPATCH_SUBSCRIBER_NOTIFIER),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], MagekSubscribersNotifier.prototype, "dispatch", null);

package/dist/token-verifier.d.ts

@@ -0,0 +1,11 @@
+import { UserEnvelope, MagekConfig } from '@magek/common';
+export declare class MagekTokenVerifier {
+    private config;
+    constructor(config: MagekConfig);
+    verify(token: string): Promise<UserEnvelope>;
+    private rejectVerification;
+    private getTokenNotBeforeErrors;
+    private getTokenExpiredErrors;
+    private getErrors;
+    private static joinReasons;
+}

package/dist/token-verifier.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MagekTokenVerifier = void 0;
+const common_1 = require("@magek/common");
+const jsonwebtoken_1 = require("jsonwebtoken");
+class MagekTokenVerifier {
+    constructor(config) {
+        this.config = config;
+    }
+    async verify(token) {
+        const userEnvelopes = await Promise.allSettled(this.config.tokenVerifiers.map((tokenVerifier) => tokenVerifier.verify(token).then((decodedToken) => Promise.resolve(tokenVerifier.toUserEnvelope(decodedToken)))));
+        const winner = userEnvelopes.find((result) => result.status === 'fulfilled');
+        if (!winner)
+            return this.rejectVerification(userEnvelopes);
+        return Promise.resolve(winner.value);
+    }
+    rejectVerification(results) {
+        const tokenExpiredErrors = this.getTokenExpiredErrors(results);
+        if (tokenExpiredErrors && tokenExpiredErrors.length > 0) {
+            const reasons = MagekTokenVerifier.joinReasons(tokenExpiredErrors);
+            return Promise.reject(new common_1.MagekTokenExpiredError(reasons));
+        }
+        const tokenNotBeforeErrors = this.getTokenNotBeforeErrors(results);
+        if (tokenNotBeforeErrors && tokenNotBeforeErrors.length > 0) {
+            const reasons = MagekTokenVerifier.joinReasons(tokenNotBeforeErrors);
+            return Promise.reject(new common_1.MagekTokenNotBeforeError(reasons));
+        }
+        const reasons = MagekTokenVerifier.joinReasons(results);
+        return Promise.reject(new common_1.NotAuthorizedError(reasons));
+    }
+    getTokenNotBeforeErrors(results) {
+        return this.getErrors(results).filter((result) => result.reason instanceof jsonwebtoken_1.NotBeforeError);
+    }
+    getTokenExpiredErrors(results) {
+        return this.getErrors(results).filter((result) => result.reason instanceof jsonwebtoken_1.TokenExpiredError);
+    }
+    getErrors(results) {
+        return results
+            .filter((result) => (result === null || result === void 0 ? void 0 : result.status) && (result === null || result === void 0 ? void 0 : result.status) !== 'fulfilled')
+            .map((result) => result);
+    }
+    static joinReasons(errors) {
+        return errors.map((error) => error.reason).join('\n');
+    }
+}
+exports.MagekTokenVerifier = MagekTokenVerifier;

package/dist/touch-entity-handler.d.ts

@@ -0,0 +1,4 @@
+import { UUID } from '@magek/common';
+export declare class MagekTouchEntityHandler {
+    static touchEntity(entityName: string, entityId: UUID): Promise<void>;
+}

package/dist/touch-entity-handler.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MagekTouchEntityHandler = void 0;
+const common_1 = require("@magek/common");
+const register_handler_1 = require("./register-handler");
+const index_1 = require("./index");
+const entity_touched_1 = require("./core-concepts/touch-entity/events/entity-touched");
+class MagekTouchEntityHandler {
+    static async touchEntity(entityName, entityId) {
+        const requestID = common_1.UUID.generate();
+        const register = new common_1.Register(requestID, {}, register_handler_1.RegisterHandler.flush);
+        register.events(new entity_touched_1.MagekEntityTouched(entityName, entityId));
+        return register_handler_1.RegisterHandler.handle(index_1.Magek.config, register);
+    }
+}
+exports.MagekTouchEntityHandler = MagekTouchEntityHandler;

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@magek/core",
+  "version": "0.0.1",
+  "description": "Library for your Magek apps",
+  "author": "Boosterin Labs SLU",
+  "homepage": "https://magek.ai",
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/theam/magek.git"
+  },
+  "bugs": {
+    "url": "https://github.com/theam/magek/issues"
+  },
+  "engines": {
+    "node": ">=22.0.0 <23.0.0"
+  },
+  "dependencies": {
+    "@magek/common": "^0.0.1",
+    "fp-ts": "2.16.11",
+    "graphql-scalars": "1.25.0",
+    "inflected": "2.1.0",
+    "iterall": "1.3.0",
+    "jsonwebtoken": "9.0.3",
+    "jwks-rsa": "3.2.0",
+    "tslib": "2.8.1",
+    "validator": "13.15.26",
+    "@oclif/core": "4.8.0",
+    "fast-check": "4.5.3"
+  },
+  "devDependencies": {
+    "@magek/eslint-config": "^0.0.1",
+    "@types/chai": "5.2.3",
+    "@types/chai-as-promised": "8.0.2",
+    "@types/inflected": "2.1.3",
+    "@types/jsonwebtoken": "9.0.10",
+    "@types/mocha": "10.0.10",
+    "@types/node": "22.19.3",
+    "@types/sinon": "21.0.0",
+    "@types/sinon-chai": "4.0.0",
+    "chai": "6.2.2",
+    "chai-as-promised": "8.0.2",
+    "cross-env": "10.1.0",
+    "@faker-js/faker": "10.2.0",
+    "mocha": "11.7.5",
+    "mock-jwks": "3.3.5",
+    "c8": "^10.1.3",
+    "rimraf": "6.1.2",
+    "sinon": "21.0.1",
+    "sinon-chai": "4.0.1",
+    "tsx": "^4.19.2",
+    "typescript": "5.9.3",
+    "graphql": "16.12.0"
+  },
+  "scripts": {
+    "format": "prettier --write --ext '.js,.ts' **/*.ts **/*/*.ts",
+    "lint:check": "eslint \"**/*.ts\"",
+    "lint:fix": "eslint --quiet --fix \"**/*.ts\"",
+    "build": "tsc -b tsconfig.json",
+    "clean": "rimraf ./dist tsconfig.tsbuildinfo",
+    "test:core": "npm run test",
+    "test": "tsc --noEmit -p tsconfig.test.json && cross-env MAGEK_ENV=test c8 mocha --forbid-only \"test/**/*.test.ts\""
+  }
+}