@etohq/link-modules-sdk 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./initialize";
+export * from "./loaders";
+export * from "./migration";
+export * from "./services";
+export * from "./types";
+//# 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":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA"}

package/dist/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./initialize"), exports);
+__exportStar(require("./loaders"), exports);
+__exportStar(require("./migration"), exports);
+__exportStar(require("./services"), exports);
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA4B;AAC5B,4CAAyB;AACzB,8CAA2B;AAC3B,6CAA0B;AAC1B,0CAAuB"}

package/dist/initialize/index.d.ts

@@ -0,0 +1,16 @@
+import { ExternalModuleDeclaration, ILinkModule, InternalModuleDeclaration, ModuleJoinerConfig, ModuleServiceInitializeCustomDataLayerOptions, ModuleServiceInitializeOptions } from "@etohq/framework/types";
+import { MigrationsExecutionPlanner } from "../migration";
+import { InitializeModuleInjectableDependencies } from "../types";
+export declare const buildInitialize: (linkDefinitions: ModuleJoinerConfig[]) => (options?: ModuleServiceInitializeOptions | ModuleServiceInitializeCustomDataLayerOptions | ExternalModuleDeclaration | InternalModuleDeclaration, pluginLinksDefinitions?: ModuleJoinerConfig[], injectedDependencies?: InitializeModuleInjectableDependencies) => Promise<{
+    [link: string]: ILinkModule;
+}>;
+/**
+ * Prepare an execution plan and run the migrations accordingly.
+ * It includes creating, updating, deleting the tables according to the execution plan.
+ * If any unsafe sql is identified then we will notify the user to act manually.
+ *
+ * @param options
+ * @param pluginLinksDefinition
+ */
+export declare function buildMigrationPlanner(linkDefinitions: ModuleJoinerConfig[]): (options: ModuleServiceInitializeOptions, pluginLinksDefinition?: ModuleJoinerConfig[]) => MigrationsExecutionPlanner;
+//# sourceMappingURL=index.d.ts.map

package/dist/initialize/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/initialize/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,yBAAyB,EACzB,WAAW,EACX,yBAAyB,EAGzB,kBAAkB,EAClB,6CAA6C,EAC7C,8BAA8B,EAC/B,MAAM,wBAAwB,CAAA;AAW/B,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,EAAE,sCAAsC,EAAE,MAAM,UAAU,CAAA;AAIjE,eAAO,MAAM,eAAe,oBAAqB,kBAAkB,EAAE,gBAE/D,8BAA8B,GAC9B,6CAA6C,GAC7C,yBAAyB,GACzB,yBAAyB,2BACJ,kBAAkB,EAAE,yBACtB,sCAAsC,KAC5D,OAAO,CAAC;IAAE,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;CAAE,CAuIzC,CAAA;AAED;;;;;;;GAOG;AAEH,wBAAgB,qBAAqB,CAAC,eAAe,EAAE,kBAAkB,EAAE,aAE9D,8BAA8B,0BACf,kBAAkB,EAAE,gCAgD/C"}

package/dist/initialize/index.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildInitialize = void 0;
+exports.buildMigrationPlanner = buildMigrationPlanner;
+const modules_sdk_1 = require("@etohq/framework/modules-sdk");
+const utils_1 = require("@etohq/utils");
+const migration_1 = require("../migration");
+const utils_2 = require("../utils");
+const module_definition_1 = require("./module-definition");
+const buildInitialize = (linkDefinitions) => async (options, pluginLinksDefinitions, injectedDependencies) => {
+    const allLinks = {};
+    const modulesLoadedKeys = modules_sdk_1.EtoModule.getLoadedModules().map((mod) => Object.keys(mod)[0]);
+    const allLinksToLoad = Object.values(linkDefinitions).concat(pluginLinksDefinitions ?? []);
+    for (const linkDefinition of allLinksToLoad) {
+        const definition = JSON.parse(JSON.stringify(linkDefinition));
+        const [primary, foreign] = definition.relationships ?? [];
+        if (definition.relationships?.length !== 2 && !definition.isReadOnlyLink) {
+            throw new Error(`Link module ${definition.serviceName} can only link 2 modules.`);
+        }
+        else if (foreign?.foreignKey?.split(",").length > 1 &&
+            !definition.isReadOnlyLink) {
+            throw new Error(`Foreign key cannot be a composed key.`);
+        }
+        if (Array.isArray(definition.extraDataFields)) {
+            const extraDataFields = definition.extraDataFields;
+            const definedDbFields = Object.keys(definition.databaseConfig?.extraFields || {});
+            const difference = (0, utils_1.arrayDifference)(extraDataFields, definedDbFields);
+            if (difference.length) {
+                throw new Error(`extraDataFields (fieldNames: ${difference.join(",")}) need to be configured under databaseConfig (serviceName: ${definition.serviceName}).`);
+            }
+        }
+        const serviceKey = !definition.isReadOnlyLink
+            ? definition.serviceName ??
+                (0, utils_1.composeLinkName)(primary.serviceName, primary.foreignKey, foreign.serviceName, foreign.foreignKey)
+            : (0, utils_1.simpleHash)(JSON.stringify(definition.extends));
+        if (modulesLoadedKeys.includes(serviceKey)) {
+            continue;
+        }
+        else if (serviceKey in allLinks) {
+            throw new Error(`Link module ${serviceKey} already defined.`);
+        }
+        if (definition.isReadOnlyLink) {
+            const extended = [];
+            for (const extension of definition.extends ?? []) {
+                if (modulesLoadedKeys.includes(extension.serviceName) &&
+                    modulesLoadedKeys.includes(extension.relationship.serviceName)) {
+                    extended.push(extension);
+                }
+            }
+            definition.extends = extended;
+            if (extended.length === 0) {
+                continue;
+            }
+        }
+        else if (!modulesLoadedKeys.includes(primary.serviceName) ||
+            !modulesLoadedKeys.includes(foreign.serviceName)) {
+            continue;
+        }
+        const logger = injectedDependencies?.[utils_1.ContainerRegistrationKeys.LOGGER] ?? console;
+        definition.schema = (0, utils_2.generateGraphQLSchema)(definition, primary, foreign, {
+            logger,
+        });
+        if (!Array.isArray(definition.alias)) {
+            definition.alias = definition.alias ? [definition.alias] : [];
+        }
+        for (const alias of definition.alias) {
+            alias.args ??= {};
+            alias.entity = (0, utils_1.toPascalCase)("Link_" +
+                (definition.databaseConfig?.tableName ??
+                    (0, utils_1.composeTableName)(primary.serviceName, primary.foreignKey, foreign.serviceName, foreign.foreignKey)));
+        }
+        const moduleDefinition = (0, module_definition_1.getLinkModuleDefinition)(definition, primary, foreign);
+        const linkModuleDefinition = {
+            key: serviceKey,
+            label: serviceKey,
+            dependencies: [utils_1.Modules.EVENT_BUS],
+            defaultModuleDeclaration: {
+                scope: modules_sdk_1.MODULE_SCOPE.INTERNAL,
+            },
+        };
+        const loaded = await modules_sdk_1.EtoModule.bootstrapLink({
+            definition: linkModuleDefinition,
+            declaration: options,
+            moduleExports: moduleDefinition,
+            injectedDependencies,
+        });
+        allLinks[serviceKey] = Object.values(loaded)[0];
+    }
+    return allLinks;
+};
+exports.buildInitialize = buildInitialize;
+/**
+ * Prepare an execution plan and run the migrations accordingly.
+ * It includes creating, updating, deleting the tables according to the execution plan.
+ * If any unsafe sql is identified then we will notify the user to act manually.
+ *
+ * @param options
+ * @param pluginLinksDefinition
+ */
+function buildMigrationPlanner(linkDefinitions) {
+    return function (options, pluginLinksDefinition) {
+        const modulesLoadedKeys = modules_sdk_1.EtoModule.getLoadedModules().map((mod) => Object.keys(mod)[0]);
+        const allLinksToLoad = Object.values(linkDefinitions).concat(pluginLinksDefinition ?? []);
+        const allLinks = new Set();
+        for (const definition of allLinksToLoad) {
+            if (definition.isReadOnlyLink) {
+                continue;
+            }
+            if (definition.relationships?.length !== 2) {
+                throw new Error(`Link module ${definition.serviceName} must have 2 relationships.`);
+            }
+            const [primary, foreign] = definition.relationships ?? [];
+            const serviceKey = definition.serviceName ??
+                (0, utils_1.composeLinkName)(primary.serviceName, primary.foreignKey, foreign.serviceName, foreign.foreignKey);
+            if (allLinks.has(serviceKey)) {
+                throw new Error(`Link module ${serviceKey} already exists.`);
+            }
+            allLinks.add(serviceKey);
+            if (!modulesLoadedKeys.includes(primary.serviceName) ||
+                !modulesLoadedKeys.includes(foreign.serviceName)) {
+                continue;
+            }
+        }
+        return new migration_1.MigrationsExecutionPlanner(allLinksToLoad, options);
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/initialize/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/initialize/index.ts"],"names":[],"mappings":";;;AAqLA,sDAmDC;AAxOD,8DAAuE;AAavE,wCAQqB;AACrB,4CAAyD;AAEzD,oCAAgD;AAChD,2DAA6D;AAEtD,MAAM,eAAe,GAAG,CAAC,eAAqC,EAAE,EAAE,CAAC,KAAK,EAC7E,OAI6B,EAC7B,sBAA6C,EAC7C,oBAA6D,EACnB,EAAE;IAC5C,MAAM,QAAQ,GAAG,EAAE,CAAA;IACnB,MAAM,iBAAiB,GAAG,uBAAS,CAAC,gBAAgB,EAAE,CAAC,GAAG,CACxD,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAC7B,CAAA;IAED,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,MAAM,CAC1D,sBAAsB,IAAI,EAAE,CAC7B,CAAA;IAED,KAAK,MAAM,cAAc,IAAI,cAAc,EAAE,CAAC;QAC5C,MAAM,UAAU,GAAuB,IAAI,CAAC,KAAK,CAC/C,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAC/B,CAAA;QAED,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,UAAU,CAAC,aAAa,IAAI,EAAE,CAAA;QAEzD,IAAI,UAAU,CAAC,aAAa,EAAE,MAAM,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC;YACzE,MAAM,IAAI,KAAK,CACb,eAAe,UAAU,CAAC,WAAW,2BAA2B,CACjE,CAAA;QACH,CAAC;aAAM,IACL,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC;YAC1C,CAAC,UAAU,CAAC,cAAc,EAC1B,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAA;QAC1D,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YAC9C,MAAM,eAAe,GAAG,UAAU,CAAC,eAAe,CAAA;YAClD,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CACjC,UAAU,CAAC,cAAc,EAAE,WAAW,IAAI,EAAE,CAC7C,CAAA;YACD,MAAM,UAAU,GAAG,IAAA,uBAAe,EAAC,eAAe,EAAE,eAAe,CAAC,CAAA;YAEpE,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CACb,gCAAgC,UAAU,CAAC,IAAI,CAC7C,GAAG,CACJ,8DAA8D,UAAU,CAAC,WAC1E,IAAI,CACL,CAAA;YACH,CAAC;QACH,CAAC;QAED,MAAM,UAAU,GAAG,CAAC,UAAU,CAAC,cAAc;YAC3C,CAAC,CAAC,UAAU,CAAC,WAAW;gBACxB,IAAA,uBAAe,EACb,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,UAAU,EAClB,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,UAAU,CACnB;YACD,CAAC,CAAC,IAAA,kBAAU,EAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAA;QAElD,IAAI,iBAAiB,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3C,SAAQ;QACV,CAAC;aAAM,IAAI,UAAU,IAAI,QAAQ,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,eAAe,UAAU,mBAAmB,CAAC,CAAA;QAC/D,CAAC;QAED,IAAI,UAAU,CAAC,cAAc,EAAE,CAAC;YAC9B,MAAM,QAAQ,GAAU,EAAE,CAAA;YAC1B,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;gBACjD,IACE,iBAAiB,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,CAAC;oBACjD,iBAAiB,CAAC,QAAQ,CAAC,SAAS,CAAC,YAAY,CAAC,WAAW,CAAC,EAC9D,CAAC;oBACD,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;gBAC1B,CAAC;YACH,CAAC;YAED,UAAU,CAAC,OAAO,GAAG,QAAQ,CAAA;YAC7B,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,SAAQ;YACV,CAAC;QACH,CAAC;aAAM,IACL,CAAC,iBAAiB,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC;YAChD,CAAC,iBAAiB,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,EAChD,CAAC;YACD,SAAQ;QACV,CAAC;QAED,MAAM,MAAM,GACV,oBAAoB,EAAE,CAAC,iCAAyB,CAAC,MAAM,CAAC,IAAI,OAAO,CAAA;QAErE,UAAU,CAAC,MAAM,GAAG,IAAA,6BAAqB,EAAC,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE;YACtE,MAAM;SACP,CAAC,CAAA;QAEF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACrC,UAAU,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QAC/D,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,KAAK,EAAE,CAAA;YAEjB,KAAK,CAAC,MAAM,GAAG,IAAA,oBAAY,EACzB,OAAO;gBACP,CAAC,UAAU,CAAC,cAAc,EAAE,SAAS;oBACnC,IAAA,wBAAgB,EACd,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,UAAU,EAClB,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,UAAU,CACnB,CAAC,CACL,CAAA;QACH,CAAC;QAED,MAAM,gBAAgB,GAAG,IAAA,2CAAuB,EAC9C,UAAU,EACV,OAAO,EACP,OAAO,CACS,CAAA;QAElB,MAAM,oBAAoB,GAAyB;YACjD,GAAG,EAAE,UAAU;YACf,KAAK,EAAE,UAAU;YACjB,YAAY,EAAE,CAAC,eAAO,CAAC,SAAS,CAAC;YACjC,wBAAwB,EAAE;gBACxB,KAAK,EAAE,0BAAY,CAAC,QAAQ;aAC7B;SACF,CAAA;QAED,MAAM,MAAM,GAAG,MAAM,uBAAS,CAAC,aAAa,CAAC;YAC3C,UAAU,EAAE,oBAAoB;YAChC,WAAW,EAAE,OAAoC;YACjD,aAAa,EAAE,gBAAgB;YAC/B,oBAAoB;SACrB,CAAC,CAAA;QAEF,QAAQ,CAAC,UAAoB,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;IAC3D,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC,CAAA;AA/IY,QAAA,eAAe,mBA+I3B;AAED;;;;;;;GAOG;AAEH,SAAgB,qBAAqB,CAAC,eAAqC;IACzE,OAAO,UACL,OAAuC,EACvC,qBAA4C;QAE5C,MAAM,iBAAiB,GAAG,uBAAS,CAAC,gBAAgB,EAAE,CAAC,GAAG,CACxD,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAC7B,CAAA;QAED,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,MAAM,CAC1D,qBAAqB,IAAI,EAAE,CAC5B,CAAA;QAED,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAA;QAClC,KAAK,MAAM,UAAU,IAAI,cAAc,EAAE,CAAC;YACxC,IAAI,UAAU,CAAC,cAAc,EAAE,CAAC;gBAC9B,SAAQ;YACV,CAAC;YAED,IAAI,UAAU,CAAC,aAAa,EAAE,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3C,MAAM,IAAI,KAAK,CACb,eAAe,UAAU,CAAC,WAAW,6BAA6B,CACnE,CAAA;YACH,CAAC;YAED,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,UAAU,CAAC,aAAa,IAAI,EAAE,CAAA;YACzD,MAAM,UAAU,GACd,UAAU,CAAC,WAAW;gBACtB,IAAA,uBAAe,EACb,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,UAAU,EAClB,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,UAAU,CACnB,CAAA;YAEH,IAAI,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,eAAe,UAAU,kBAAkB,CAAC,CAAA;YAC9D,CAAC;YAED,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;YAExB,IACE,CAAC,iBAAiB,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC;gBAChD,CAAC,iBAAiB,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,EAChD,CAAC;gBACD,SAAQ;YACV,CAAC;QACH,CAAC;QAED,OAAO,IAAI,sCAA0B,CAAC,cAAc,EAAE,OAAO,CAAC,CAAA;IAChE,CAAC,CAAA;AACH,CAAC"}

package/dist/initialize/module-definition.d.ts

@@ -0,0 +1,3 @@
+import { JoinerRelationship, ModuleExports, ModuleJoinerConfig } from "@etohq/types";
+export declare function getLinkModuleDefinition(joinerConfig: ModuleJoinerConfig, primary: JoinerRelationship, foreign: JoinerRelationship): ModuleExports;
+//# sourceMappingURL=module-definition.d.ts.map

package/dist/initialize/module-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-definition.d.ts","sourceRoot":"","sources":["../../src/initialize/module-definition.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EACnB,MAAM,cAAc,CAAA;AAIrB,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,kBAAkB,EAChC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,kBAAkB,GAC1B,aAAa,CAWf"}

package/dist/initialize/module-definition.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLinkModuleDefinition = getLinkModuleDefinition;
+const services_1 = require("../services");
+const loaders_1 = require("../loaders");
+function getLinkModuleDefinition(joinerConfig, primary, foreign) {
+    return {
+        service: joinerConfig.isReadOnlyLink
+            ? (0, services_1.getReadOnlyModuleService)(joinerConfig)
+            : (0, services_1.getModuleService)(joinerConfig),
+        loaders: (0, loaders_1.getLoaders)({
+            joinerConfig,
+            primary,
+            foreign,
+        }),
+    };
+}
+//# sourceMappingURL=module-definition.js.map

package/dist/initialize/module-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-definition.js","sourceRoot":"","sources":["../../src/initialize/module-definition.ts"],"names":[],"mappings":";;AAQA,0DAeC;AAlBD,0CAAwE;AACxE,wCAAuC;AAEvC,SAAgB,uBAAuB,CACrC,YAAgC,EAChC,OAA2B,EAC3B,OAA2B;IAE3B,OAAO;QACL,OAAO,EAAE,YAAY,CAAC,cAAc;YAClC,CAAC,CAAC,IAAA,mCAAwB,EAAC,YAAY,CAAC;YACxC,CAAC,CAAC,IAAA,2BAAgB,EAAC,YAAY,CAAC;QAClC,OAAO,EAAE,IAAA,oBAAU,EAAC;YAClB,YAAY;YACZ,OAAO;YACP,OAAO;SACR,CAAC;KACH,CAAA;AACH,CAAC"}

package/dist/loaders/connection.d.ts

@@ -0,0 +1,4 @@
+import { InternalModuleDeclaration, LoaderOptions, ModuleServiceInitializeCustomDataLayerOptions, ModuleServiceInitializeOptions } from "@etohq/framework/types";
+import { EntitySchema } from "@mikro-orm/core";
+export declare function connectionLoader(entity: EntitySchema): ({ options, container, logger, }: LoaderOptions<ModuleServiceInitializeOptions | ModuleServiceInitializeCustomDataLayerOptions>, moduleDeclaration?: InternalModuleDeclaration) => Promise<void>;
+//# sourceMappingURL=connection.d.ts.map

package/dist/loaders/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/loaders/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,aAAa,EACb,6CAA6C,EAC7C,8BAA8B,EAC/B,MAAM,wBAAwB,CAAA;AAG/B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,qCAM9C,aAAa,CACZ,8BAA8B,GAC9B,6CAA6C,CAChD,sBACmB,yBAAyB,KAC5C,OAAO,CAAC,IAAI,CAAC,CAajB"}

package/dist/loaders/connection.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.connectionLoader = connectionLoader;
+const utils_1 = require("@etohq/utils");
+function connectionLoader(entity) {
+    return async ({ options, container, logger, }, moduleDeclaration) => {
+        const pathToMigrations = __dirname + "/../migrations";
+        await utils_1.ModulesSdkUtils.mikroOrmConnectionLoader({
+            moduleName: "link_module",
+            entities: [entity],
+            container,
+            options,
+            moduleDeclaration,
+            logger,
+            pathToMigrations,
+        });
+    };
+}
+//# sourceMappingURL=connection.js.map

package/dist/loaders/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/loaders/connection.ts"],"names":[],"mappings":";;AAUA,4CAwBC;AA5BD,wCAA8C;AAI9C,SAAgB,gBAAgB,CAAC,MAAoB;IACnD,OAAO,KAAK,EACV,EACE,OAAO,EACP,SAAS,EACT,MAAM,GAIP,EACD,iBAA6C,EAC9B,EAAE;QACjB,MAAM,gBAAgB,GAAG,SAAS,GAAG,gBAAgB,CAAA;QAErD,MAAM,uBAAe,CAAC,wBAAwB,CAAC;YAC7C,UAAU,EAAE,aAAa;YACzB,QAAQ,EAAE,CAAC,MAAM,CAAC;YAClB,SAAS;YACT,OAAO;YACP,iBAAiB;YACjB,MAAM;YACN,gBAAgB;SACjB,CAAC,CAAA;IACJ,CAAC,CAAA;AACH,CAAC"}

package/dist/loaders/container.d.ts

@@ -0,0 +1,3 @@
+import { InternalModuleDeclaration, LoaderOptions, ModuleJoinerConfig, ModulesSdkTypes } from "@etohq/framework/types";
+export declare function containerLoader(entity: any, joinerConfig: ModuleJoinerConfig): ({ options, container, }: LoaderOptions<ModulesSdkTypes.ModuleServiceInitializeOptions | ModulesSdkTypes.ModuleServiceInitializeCustomDataLayerOptions>, moduleDeclaration?: InternalModuleDeclaration) => Promise<void>;
+//# sourceMappingURL=container.d.ts.map

package/dist/loaders/container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../src/loaders/container.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,yBAAyB,EACzB,aAAa,EACb,kBAAkB,EAClB,eAAe,EAChB,MAAM,wBAAwB,CAAA;AAS/B,wBAAgB,eAAe,CAAC,MAAM,KAAA,EAAE,YAAY,EAAE,kBAAkB,6BAKjE,aAAa,CACZ,eAAe,CAAC,8BAA8B,GAC9C,eAAe,CAAC,6CAA6C,CAChE,sBACmB,yBAAyB,KAC5C,OAAO,CAAC,IAAI,CAAC,CAyCjB"}

package/dist/loaders/container.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.containerLoader = containerLoader;
+const repositories_1 = require("../repositories");
+const services_1 = require("../services");
+const utils_1 = require("@etohq/utils");
+const awilix_1 = require("awilix");
+function containerLoader(entity, joinerConfig) {
+    return async ({ options, container, }, moduleDeclaration) => {
+        const [primary, foreign] = joinerConfig.relationships;
+        const serviceName = !joinerConfig.isReadOnlyLink
+            ? joinerConfig.serviceName ??
+                (0, utils_1.composeLinkName)(primary.serviceName, primary.foreignKey, foreign.serviceName, foreign.foreignKey)
+            : (0, utils_1.simpleHash)(JSON.stringify(joinerConfig.extends));
+        const entityName = (0, utils_1.toPascalCase)("Link_" +
+            (joinerConfig.databaseConfig?.tableName ??
+                (0, utils_1.composeTableName)(primary.serviceName, primary.foreignKey, foreign.serviceName, foreign.foreignKey)));
+        container.register({
+            joinerConfig: (0, awilix_1.asValue)(joinerConfig),
+            primaryKey: (0, awilix_1.asValue)(primary.foreignKey.split(",")),
+            foreignKey: (0, awilix_1.asValue)(foreign.foreignKey),
+            extraFields: (0, awilix_1.asValue)(Object.keys(joinerConfig.databaseConfig?.extraFields || {})),
+            linkModuleService: (0, awilix_1.asClass)((0, services_1.getModuleService)(joinerConfig)).singleton(),
+            linkService: (0, awilix_1.asClass)(services_1.LinkService).singleton(),
+            baseRepository: (0, awilix_1.asClass)(repositories_1.BaseRepository).singleton(),
+            linkRepository: (0, awilix_1.asClass)((0, repositories_1.getLinkRepository)(entity)).singleton(),
+            entityName: (0, awilix_1.asValue)(entityName),
+            serviceName: (0, awilix_1.asValue)(serviceName),
+        });
+    };
+}
+//# sourceMappingURL=container.js.map

package/dist/loaders/container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.js","sourceRoot":"","sources":["../../src/loaders/container.ts"],"names":[],"mappings":";;AAiBA,0CAmDC;AApED,kDAAmE;AACnE,0CAA2D;AAQ3D,wCAKqB;AACrB,mCAAyC;AAEzC,SAAgB,eAAe,CAAC,MAAM,EAAE,YAAgC;IACtE,OAAO,KAAK,EACV,EACE,OAAO,EACP,SAAS,GAIV,EACD,iBAA6C,EAC9B,EAAE;QACjB,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,YAAY,CAAC,aAAc,CAAA;QAEtD,MAAM,WAAW,GAAG,CAAC,YAAY,CAAC,cAAc;YAC9C,CAAC,CAAC,YAAY,CAAC,WAAW;gBACxB,IAAA,uBAAe,EACb,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,UAAU,EAClB,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,UAAU,CACnB;YACH,CAAC,CAAC,IAAA,kBAAU,EAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAA;QAEpD,MAAM,UAAU,GAAG,IAAA,oBAAY,EAC7B,OAAO;YACL,CAAC,YAAY,CAAC,cAAc,EAAE,SAAS;gBACrC,IAAA,wBAAgB,EACd,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,UAAU,EAClB,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,UAAU,CACnB,CAAC,CACP,CAAA;QAED,SAAS,CAAC,QAAQ,CAAC;YACjB,YAAY,EAAE,IAAA,gBAAO,EAAC,YAAY,CAAC;YACnC,UAAU,EAAE,IAAA,gBAAO,EAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAClD,UAAU,EAAE,IAAA,gBAAO,EAAC,OAAO,CAAC,UAAU,CAAC;YACvC,WAAW,EAAE,IAAA,gBAAO,EAClB,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,cAAc,EAAE,WAAW,IAAI,EAAE,CAAC,CAC5D;YAED,iBAAiB,EAAE,IAAA,gBAAO,EAAC,IAAA,2BAAgB,EAAC,YAAY,CAAC,CAAC,CAAC,SAAS,EAAE;YACtE,WAAW,EAAE,IAAA,gBAAO,EAAC,sBAAW,CAAC,CAAC,SAAS,EAAE;YAE7C,cAAc,EAAE,IAAA,gBAAO,EAAC,6BAAc,CAAC,CAAC,SAAS,EAAE;YACnD,cAAc,EAAE,IAAA,gBAAO,EAAC,IAAA,gCAAiB,EAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EAAE;YAC9D,UAAU,EAAE,IAAA,gBAAO,EAAC,UAAU,CAAC;YAC/B,WAAW,EAAE,IAAA,gBAAO,EAAC,WAAW,CAAC;SAClC,CAAC,CAAA;IACJ,CAAC,CAAA;AACH,CAAC"}

package/dist/loaders/index.d.ts

@@ -0,0 +1,9 @@
+import { JoinerRelationship, ModuleJoinerConfig, ModuleLoaderFunction } from "@etohq/framework/types";
+import { connectionLoader } from "./connection";
+declare function getLoaders({ joinerConfig, primary, foreign, }: {
+    joinerConfig: ModuleJoinerConfig;
+    primary: JoinerRelationship;
+    foreign: JoinerRelationship;
+}): ModuleLoaderFunction[];
+export { connectionLoader, getLoaders };
+//# sourceMappingURL=index.d.ts.map

package/dist/loaders/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/loaders/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,wBAAwB,CAAA;AAG/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAG/C,iBAAS,UAAU,CAAC,EAClB,YAAY,EACZ,OAAO,EACP,OAAO,GACR,EAAE;IACD,YAAY,EAAE,kBAAkB,CAAA;IAChC,OAAO,EAAE,kBAAkB,CAAA;IAC3B,OAAO,EAAE,kBAAkB,CAAA;CAC5B,GAAG,oBAAoB,EAAE,CAOzB;AAGD,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,CAAA"}

package/dist/loaders/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.connectionLoader = void 0;
+exports.getLoaders = getLoaders;
+const utils_1 = require("../utils");
+const connection_1 = require("./connection");
+Object.defineProperty(exports, "connectionLoader", { enumerable: true, get: function () { return connection_1.connectionLoader; } });
+const container_1 = require("./container");
+function getLoaders({ joinerConfig, primary, foreign, }) {
+    if (joinerConfig.isReadOnlyLink) {
+        return [];
+    }
+    const entity = (0, utils_1.generateEntity)(joinerConfig, primary, foreign);
+    return [(0, connection_1.connectionLoader)(entity), (0, container_1.containerLoader)(entity, joinerConfig)];
+}
+//# sourceMappingURL=index.js.map

package/dist/loaders/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/loaders/index.ts"],"names":[],"mappings":";;;AA4B2B,gCAAU;AAtBrC,oCAAyC;AACzC,6CAA+C;AAqBtC,iGArBA,6BAAgB,OAqBA;AApBzB,2CAA6C;AAE7C,SAAS,UAAU,CAAC,EAClB,YAAY,EACZ,OAAO,EACP,OAAO,GAKR;IACC,IAAI,YAAY,CAAC,cAAc,EAAE,CAAC;QAChC,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,MAAM,GAAG,IAAA,sBAAc,EAAC,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IAC7D,OAAO,CAAC,IAAA,6BAAgB,EAAC,MAAM,CAAC,EAAE,IAAA,2BAAe,EAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAA;AAC1E,CAAC"}

package/dist/migration/index.d.ts

@@ -0,0 +1,103 @@
+import { ILinkMigrationsPlanner, LinkMigrationsPlannerAction, ModuleJoinerConfig, ModuleServiceInitializeOptions, PlannerActionLinkDescriptor } from "@etohq/framework/types";
+import { EntitySchema, MikroORM } from "@mikro-orm/core";
+import { PostgreSqlDriver } from "@mikro-orm/postgresql";
+/**
+ * The migrations execution planner creates a plan of SQL queries
+ * to be executed to keep link modules database state in sync
+ * with the links defined inside the user application.
+ */
+export declare class MigrationsExecutionPlanner implements ILinkMigrationsPlanner {
+    #private;
+    /**
+     * The table that keeps a track of tables generated by the link
+     * module.
+     */
+    protected tableName: string;
+    constructor(joinerConfig: ModuleJoinerConfig[], options?: ModuleServiceInitializeOptions);
+    /**
+     * Initializes the ORM using the normalized dbConfig and set
+     * of provided entities
+     */
+    protected createORM(entities?: EntitySchema[]): Promise<MikroORM<PostgreSqlDriver>>;
+    /**
+     * Ensure the table to track link modules migrations
+     * exists.
+     *
+     * @param orm MikroORM
+     */
+    protected ensureMigrationsTable(orm: MikroORM<PostgreSqlDriver>): Promise<void>;
+    /**
+     * Ensure the migrations table is in sync
+     *
+     * @param orm
+     * @protected
+     */
+    protected ensureMigrationsTableUpToDate(orm: MikroORM<PostgreSqlDriver>): Promise<void>;
+    /**
+     * Insert tuple to the migrations table and create the link table
+     *
+     * @param orm
+     * @param action
+     * @protected
+     */
+    protected createLinkTable(orm: MikroORM<PostgreSqlDriver>, action: LinkMigrationsPlannerAction & {
+        linkDescriptor: PlannerActionLinkDescriptor;
+        sql: string;
+    }): Promise<void>;
+    /**
+     * Drops the link table and untracks it from the "link_modules_migrations"
+     * table.
+     */
+    protected dropLinkTable(orm: MikroORM<PostgreSqlDriver>, tableName: string): Promise<void>;
+    /**
+     * Returns an array of table names that have been tracked during
+     * the last run. In short, these tables were created by the
+     * link modules migrations runner.
+     *
+     * @param orm MikroORM
+     */
+    protected getTrackedLinksTables(orm: MikroORM<PostgreSqlDriver>): Promise<{
+        table_name: string;
+        link_descriptor: PlannerActionLinkDescriptor;
+    }[]>;
+    /**
+     * Returns the migration plan for a specific link entity.
+     */
+    protected getEntityMigrationPlan(linkDescriptor: PlannerActionLinkDescriptor, entity: EntitySchema, trackedLinksTables: string[]): Promise<LinkMigrationsPlannerAction>;
+    /**
+     * This method loops over the tables we have fetched from the
+     * "link_module_migrations" tables and checks if their new
+     * name is different from the tracked name and in that
+     * case it will rename the actual table and also the
+     * tracked entry.
+     */
+    protected migrateOldTables(orm: MikroORM<PostgreSqlDriver>, trackedTables: {
+        table_name: string;
+        link_descriptor: PlannerActionLinkDescriptor;
+    }[]): Promise<{
+        table_name: string;
+        link_descriptor: PlannerActionLinkDescriptor;
+    }[]>;
+    /**
+     * Renames existing table and also its tracked entry
+     */
+    protected renameOldTable(orm: MikroORM<PostgreSqlDriver>, oldName: string, newName: string, descriptor: PlannerActionLinkDescriptor): Promise<void>;
+    /**
+     * Creates a plan to executed in order to keep the database state in
+     * sync with the user-defined links.
+     *
+     * This method only creates a plan and does not change the database
+     * state. You must call the "executePlan" method for that.
+     */
+    createPlan(): Promise<LinkMigrationsPlannerAction[]>;
+    /**
+     * Executes the actionsPlan actions where the action is one of 'create' | 'update' | 'delete'.
+     * 'noop' and 'notify' actions are implicitly ignored. If a notify action needs to be
+     * executed, you can mutate its action to 'update', in that scenario it means that an unsafe
+     * update sql (from our point of view) will be executed and some data could be lost.
+     *
+     * @param actionPlan
+     */
+    executePlan(actionPlan: LinkMigrationsPlannerAction[]): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/migration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migration/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,2BAA2B,EAC3B,kBAAkB,EAClB,8BAA8B,EAC9B,2BAA2B,EAC5B,MAAM,wBAAwB,CAAA;AAS/B,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,EAAkB,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAGxE;;;;GAIG;AAGH,qBAAa,0BAA2B,YAAW,sBAAsB;;IAoBvE;;;OAGG;IACH,SAAS,CAAC,SAAS,SAA2B;gBAG5C,YAAY,EAAE,kBAAkB,EAAE,EAClC,OAAO,CAAC,EAAE,8BAA8B;IAyB1C;;;OAGG;cACa,SAAS,CAAC,QAAQ,GAAE,YAAY,EAAO;IAIvD;;;;;OAKG;cACa,qBAAqB,CACnC,GAAG,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAC9B,OAAO,CAAC,IAAI,CAAC;IAWhB;;;;;OAKG;cACa,6BAA6B,CAC3C,GAAG,EAAE,QAAQ,CAAC,gBAAgB,CAAC;IAoDjC;;;;;;OAMG;cACa,eAAe,CAC7B,GAAG,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAC/B,MAAM,EAAE,2BAA2B,GAAG;QACpC,cAAc,EAAE,2BAA2B,CAAA;QAC3C,GAAG,EAAE,MAAM,CAAA;KACZ;IAgBH;;;OAGG;cACa,aAAa,CAC3B,GAAG,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAC/B,SAAS,EAAE,MAAM;IAQnB;;;;;;OAMG;cACa,qBAAqB,CACnC,GAAG,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAC9B,OAAO,CACR;QACE,UAAU,EAAE,MAAM,CAAA;QAClB,eAAe,EAAE,2BAA2B,CAAA;KAC7C,EAAE,CACJ;IAgBD;;OAEG;cACa,sBAAsB,CACpC,cAAc,EAAE,2BAA2B,EAC3C,MAAM,EAAE,YAAY,EACpB,kBAAkB,EAAE,MAAM,EAAE,GAC3B,OAAO,CAAC,2BAA2B,CAAC;IA2EvC;;;;;;OAMG;cACa,gBAAgB,CAC9B,GAAG,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAC/B,aAAa,EAAE;QACb,UAAU,EAAE,MAAM,CAAA;QAClB,eAAe,EAAE,2BAA2B,CAAA;KAC7C,EAAE;oBAGW,MAAM;yBACD,2BAA2B;;IA0ChD;;OAEG;cACa,cAAc,CAC5B,GAAG,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAC/B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,2BAA2B;IAYzC;;;;;;OAMG;IACG,UAAU;IA2DhB;;;;;;;OAOG;IACG,WAAW,CAAC,UAAU,EAAE,2BAA2B,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAkB5E"}