@8medusa/utils 2.7.0

package/dist/modules-sdk/decorators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules-sdk/decorators/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,kBAAkB,CAAA;AAChC,cAAc,yBAAyB,CAAA;AACvC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,uBAAuB,CAAA;AACrC,cAAc,eAAe,CAAA"}

package/dist/modules-sdk/decorators/index.js

@@ -0,0 +1,23 @@
+"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("./context-parameter"), exports);
+__exportStar(require("./inject-manager"), exports);
+__exportStar(require("./inject-shared-context"), exports);
+__exportStar(require("./inject-transaction-manager"), exports);
+__exportStar(require("./inject-into-context"), exports);
+__exportStar(require("./emit-events"), exports);
+//# sourceMappingURL=index.js.map

package/dist/modules-sdk/decorators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules-sdk/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAmC;AACnC,mDAAgC;AAChC,0DAAuC;AACvC,+DAA4C;AAC5C,wDAAqC;AACrC,gDAA6B"}

package/dist/modules-sdk/decorators/inject-into-context.d.ts

@@ -0,0 +1,2 @@
+export declare function InjectIntoContext(properties: Record<string, unknown | Function>): MethodDecorator;
+//# sourceMappingURL=inject-into-context.d.ts.map

package/dist/modules-sdk/decorators/inject-into-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-into-context.d.ts","sourceRoot":"","sources":["../../../src/modules-sdk/decorators/inject-into-context.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,QAAQ,CAAC,GAC7C,eAAe,CA2BjB"}

package/dist/modules-sdk/decorators/inject-into-context.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InjectIntoContext = InjectIntoContext;
+function InjectIntoContext(properties) {
+    return function (target, propertyKey, descriptor) {
+        if (!target.MedusaContextIndex_) {
+            throw new Error(`To apply @InjectIntoContext you have to flag a parameter using @MedusaContext`);
+        }
+        const argIndex = target.MedusaContextIndex_[propertyKey];
+        const original = descriptor.value;
+        descriptor.value = async function (...args) {
+            for (const key of Object.keys(properties)) {
+                args[argIndex] = args[argIndex] ?? {};
+                args[argIndex][key] =
+                    args[argIndex][key] ??
+                        (typeof properties[key] === "function"
+                            ? properties[key].apply(this, args)
+                            : properties[key]);
+            }
+            return await original.apply(this, args);
+        };
+    };
+}
+//# sourceMappingURL=inject-into-context.js.map

package/dist/modules-sdk/decorators/inject-into-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-into-context.js","sourceRoot":"","sources":["../../../src/modules-sdk/decorators/inject-into-context.ts"],"names":[],"mappings":";;AAAA,8CA6BC;AA7BD,SAAgB,iBAAiB,CAC/B,UAA8C;IAE9C,OAAO,UACL,MAAW,EACX,WAA4B,EAC5B,UAAe;QAEf,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,+EAA+E,CAChF,CAAA;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAA;QACxD,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAA;QACjC,UAAU,CAAC,KAAK,GAAG,KAAK,WAAW,GAAG,IAAW;YAC/C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC1C,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAA;gBACrC,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC;oBACjB,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC;wBACnB,CAAC,OAAO,UAAU,CAAC,GAAG,CAAC,KAAK,UAAU;4BACpC,CAAC,CAAE,UAAU,CAAC,GAAG,CAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC;4BACjD,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAA;YACxB,CAAC;YAED,OAAO,MAAM,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QACzC,CAAC,CAAA;IACH,CAAC,CAAA;AACH,CAAC"}

package/dist/modules-sdk/decorators/inject-manager.d.ts

@@ -0,0 +1,2 @@
+export declare function InjectManager(managerProperty?: string): MethodDecorator;
+//# sourceMappingURL=inject-manager.d.ts.map

package/dist/modules-sdk/decorators/inject-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-manager.d.ts","sourceRoot":"","sources":["../../../src/modules-sdk/decorators/inject-manager.ts"],"names":[],"mappings":"AAIA,wBAAgB,aAAa,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,eAAe,CA+DvE"}

package/dist/modules-sdk/decorators/inject-manager.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InjectManager = InjectManager;
+const common_1 = require("../../common");
+const context_parameter_1 = require("./context-parameter");
+function InjectManager(managerProperty) {
+    return function (target, propertyKey, descriptor) {
+        if (!target.MedusaContextIndex_) {
+            throw new Error(`To apply @InjectManager you have to flag a parameter using @MedusaContext`);
+        }
+        managerProperty ??= "baseRepository_";
+        const originalMethod = descriptor.value;
+        const argIndex = target.MedusaContextIndex_[propertyKey];
+        descriptor.value = function (...args) {
+            const originalContext = args[argIndex] ?? {};
+            const copiedContext = {};
+            for (const key in originalContext) {
+                if (key === "manager" || key === "transactionManager") {
+                    continue;
+                }
+                Object.defineProperty(copiedContext, key, {
+                    enumerable: true,
+                    get: function () {
+                        return originalContext[key];
+                    },
+                    set: function (value) {
+                        originalContext[key] = value;
+                    },
+                });
+            }
+            const resourceWithManager = !managerProperty
+                ? this
+                : this[managerProperty];
+            if (!(0, common_1.isPresent)(resourceWithManager) &&
+                !(0, common_1.isPresent)(originalContext.manager)) {
+                throw new Error(`Could not find a manager in the context. Ensure that ${this.managerProperty} is set on your service that points to a repository.`);
+            }
+            copiedContext.manager =
+                originalContext.manager ?? resourceWithManager.getFreshManager();
+            if (originalContext?.transactionManager) {
+                copiedContext.transactionManager = originalContext?.transactionManager;
+            }
+            copiedContext.__type = context_parameter_1.MedusaContextType;
+            args[argIndex] = copiedContext;
+            return originalMethod.apply(this, args);
+        };
+    };
+}
+//# sourceMappingURL=inject-manager.js.map

package/dist/modules-sdk/decorators/inject-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-manager.js","sourceRoot":"","sources":["../../../src/modules-sdk/decorators/inject-manager.ts"],"names":[],"mappings":";;AAIA,sCA+DC;AAlED,yCAAwC;AACxC,2DAAuD;AAEvD,SAAgB,aAAa,CAAC,eAAwB;IACpD,OAAO,UACL,MAAW,EACX,WAA4B,EAC5B,UAAe;QAEf,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,2EAA2E,CAC5E,CAAA;QACH,CAAC;QAED,eAAe,KAAK,iBAAiB,CAAA;QAErC,MAAM,cAAc,GAAG,UAAU,CAAC,KAAK,CAAA;QACvC,MAAM,QAAQ,GAAG,MAAM,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAA;QAExD,UAAU,CAAC,KAAK,GAAG,UAAU,GAAG,IAAW;YACzC,MAAM,eAAe,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAA;YAC5C,MAAM,aAAa,GAAG,EAAa,CAAA;YACnC,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;gBAClC,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,oBAAoB,EAAE,CAAC;oBACtD,SAAQ;gBACV,CAAC;gBAED,MAAM,CAAC,cAAc,CAAC,aAAa,EAAE,GAAG,EAAE;oBACxC,UAAU,EAAE,IAAI;oBAChB,GAAG,EAAE;wBACH,OAAO,eAAe,CAAC,GAAG,CAAC,CAAA;oBAC7B,CAAC;oBACD,GAAG,EAAE,UAAU,KAAK;wBAClB,eAAe,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;oBAC9B,CAAC;iBACF,CAAC,CAAA;YACJ,CAAC;YAED,MAAM,mBAAmB,GAAG,CAAC,eAAe;gBAC1C,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;YAEzB,IACE,CAAC,IAAA,kBAAS,EAAC,mBAAmB,CAAC;gBAC/B,CAAC,IAAA,kBAAS,EAAC,eAAe,CAAC,OAAO,CAAC,EACnC,CAAC;gBACD,MAAM,IAAI,KAAK,CACb,wDAAwD,IAAI,CAAC,eAAe,sDAAsD,CACnI,CAAA;YACH,CAAC;YAED,aAAa,CAAC,OAAO;gBACnB,eAAe,CAAC,OAAO,IAAI,mBAAmB,CAAC,eAAe,EAAE,CAAA;YAElE,IAAI,eAAe,EAAE,kBAAkB,EAAE,CAAC;gBACxC,aAAa,CAAC,kBAAkB,GAAG,eAAe,EAAE,kBAAkB,CAAA;YACxE,CAAC;YAED,aAAa,CAAC,MAAM,GAAG,qCAAiB,CAAA;YAExC,IAAI,CAAC,QAAQ,CAAC,GAAG,aAAa,CAAA;YAE9B,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QACzC,CAAC,CAAA;IACH,CAAC,CAAA;AACH,CAAC"}

package/dist/modules-sdk/decorators/inject-shared-context.d.ts

@@ -0,0 +1,2 @@
+export declare function InjectSharedContext(): MethodDecorator;
+//# sourceMappingURL=inject-shared-context.d.ts.map

package/dist/modules-sdk/decorators/inject-shared-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-shared-context.d.ts","sourceRoot":"","sources":["../../../src/modules-sdk/decorators/inject-shared-context.ts"],"names":[],"mappings":"AAGA,wBAAgB,mBAAmB,IAAI,eAAe,CAwBrD"}

package/dist/modules-sdk/decorators/inject-shared-context.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InjectSharedContext = InjectSharedContext;
+const context_parameter_1 = require("./context-parameter");
+function InjectSharedContext() {
+    return function (target, propertyKey, descriptor) {
+        if (!target.MedusaContextIndex_) {
+            throw new Error(`To apply @InjectSharedContext you have to flag a parameter using @MedusaContext`);
+        }
+        const originalMethod = descriptor.value;
+        const argIndex = target.MedusaContextIndex_[propertyKey];
+        descriptor.value = function (...args) {
+            const context = {
+                ...(args[argIndex] ?? { __type: context_parameter_1.MedusaContextType }),
+            };
+            args[argIndex] = context;
+            return originalMethod.apply(this, args);
+        };
+    };
+}
+//# sourceMappingURL=inject-shared-context.js.map

package/dist/modules-sdk/decorators/inject-shared-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-shared-context.js","sourceRoot":"","sources":["../../../src/modules-sdk/decorators/inject-shared-context.ts"],"names":[],"mappings":";;AAGA,kDAwBC;AA1BD,2DAAuD;AAEvD,SAAgB,mBAAmB;IACjC,OAAO,UACL,MAAW,EACX,WAA4B,EAC5B,UAAe;QAEf,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,iFAAiF,CAClF,CAAA;QACH,CAAC;QAED,MAAM,cAAc,GAAG,UAAU,CAAC,KAAK,CAAA;QACvC,MAAM,QAAQ,GAAG,MAAM,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAA;QAExD,UAAU,CAAC,KAAK,GAAG,UAAU,GAAG,IAAW;YACzC,MAAM,OAAO,GAAY;gBACvB,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,qCAAiB,EAAE,CAAC;aACrD,CAAA;YACD,IAAI,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAA;YAExB,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QACzC,CAAC,CAAA;IACH,CAAC,CAAA;AACH,CAAC"}

package/dist/modules-sdk/decorators/inject-transaction-manager.d.ts

@@ -0,0 +1,2 @@
+export declare function InjectTransactionManager(managerProperty?: string): MethodDecorator;
+//# sourceMappingURL=inject-transaction-manager.d.ts.map

package/dist/modules-sdk/decorators/inject-transaction-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-transaction-manager.d.ts","sourceRoot":"","sources":["../../../src/modules-sdk/decorators/inject-transaction-manager.ts"],"names":[],"mappings":"AAGA,wBAAgB,wBAAwB,CACtC,eAAe,CAAC,EAAE,MAAM,GACvB,eAAe,CAoEjB"}

package/dist/modules-sdk/decorators/inject-transaction-manager.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InjectTransactionManager = InjectTransactionManager;
+const context_parameter_1 = require("./context-parameter");
+function InjectTransactionManager(managerProperty) {
+    return function (target, propertyKey, descriptor) {
+        if (!target.MedusaContextIndex_) {
+            throw new Error(`An error occured applying decorator '@InjectTransactionManager' to method ${String(propertyKey)}: Missing parameter with flag @MedusaContext`);
+        }
+        const originalMethod = descriptor.value;
+        managerProperty ??= "baseRepository_";
+        const argIndex = target.MedusaContextIndex_[propertyKey];
+        descriptor.value = async function (...args) {
+            const originalContext = args[argIndex] ?? {};
+            if (originalContext?.transactionManager) {
+                return await originalMethod.apply(this, args);
+            }
+            return await (!managerProperty
+                ? this
+                : this[managerProperty]).transaction(async (transactionManager) => {
+                const copiedContext = {};
+                for (const key in originalContext) {
+                    if (key === "manager" || key === "transactionManager") {
+                        continue;
+                    }
+                    Object.defineProperty(copiedContext, key, {
+                        enumerable: true,
+                        get: function () {
+                            return originalContext[key];
+                        },
+                        set: function (value) {
+                            originalContext[key] = value;
+                        },
+                    });
+                }
+                copiedContext.transactionManager = transactionManager;
+                if (originalContext?.manager) {
+                    copiedContext.manager = originalContext?.manager;
+                }
+                copiedContext.__type = context_parameter_1.MedusaContextType;
+                args[argIndex] = copiedContext;
+                return await originalMethod.apply(this, args);
+            }, {
+                transaction: originalContext?.transactionManager,
+                isolationLevel: originalContext?.isolationLevel,
+                enableNestedTransactions: originalContext.enableNestedTransactions ?? false,
+            });
+        };
+    };
+}
+//# sourceMappingURL=inject-transaction-manager.js.map

package/dist/modules-sdk/decorators/inject-transaction-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-transaction-manager.js","sourceRoot":"","sources":["../../../src/modules-sdk/decorators/inject-transaction-manager.ts"],"names":[],"mappings":";;AAGA,4DAsEC;AAxED,2DAAuD;AAEvD,SAAgB,wBAAwB,CACtC,eAAwB;IAExB,OAAO,UACL,MAAW,EACX,WAA4B,EAC5B,UAAe;QAEf,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,6EAA6E,MAAM,CACjF,WAAW,CACZ,8CAA8C,CAChD,CAAA;QACH,CAAC;QAED,MAAM,cAAc,GAAG,UAAU,CAAC,KAAK,CAAA;QACvC,eAAe,KAAK,iBAAiB,CAAA;QAErC,MAAM,QAAQ,GAAG,MAAM,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAA;QACxD,UAAU,CAAC,KAAK,GAAG,KAAK,WAAW,GAAG,IAAW;YAC/C,MAAM,eAAe,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAA;YAE5C,IAAI,eAAe,EAAE,kBAAkB,EAAE,CAAC;gBACxC,OAAO,MAAM,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;YAC/C,CAAC;YAED,OAAO,MAAM,CAAC,CAAC,eAAe;gBAC5B,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CACxB,CAAC,WAAW,CACX,KAAK,EAAE,kBAAkB,EAAE,EAAE;gBAC3B,MAAM,aAAa,GAAG,EAAa,CAAA;gBACnC,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;oBAClC,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,oBAAoB,EAAE,CAAC;wBACtD,SAAQ;oBACV,CAAC;oBAED,MAAM,CAAC,cAAc,CAAC,aAAa,EAAE,GAAG,EAAE;wBACxC,UAAU,EAAE,IAAI;wBAChB,GAAG,EAAE;4BACH,OAAO,eAAe,CAAC,GAAG,CAAC,CAAA;wBAC7B,CAAC;wBACD,GAAG,EAAE,UAAU,KAAK;4BAClB,eAAe,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;wBAC9B,CAAC;qBACF,CAAC,CAAA;gBACJ,CAAC;gBAED,aAAa,CAAC,kBAAkB,GAAG,kBAAkB,CAAA;gBAErD,IAAI,eAAe,EAAE,OAAO,EAAE,CAAC;oBAC7B,aAAa,CAAC,OAAO,GAAG,eAAe,EAAE,OAAO,CAAA;gBAClD,CAAC;gBAED,aAAa,CAAC,MAAM,GAAG,qCAAiB,CAAA;gBAExC,IAAI,CAAC,QAAQ,CAAC,GAAG,aAAa,CAAA;gBAE9B,OAAO,MAAM,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;YAC/C,CAAC,EACD;gBACE,WAAW,EAAE,eAAe,EAAE,kBAAkB;gBAChD,cAAc,EAAG,eAA2B,EAAE,cAAc;gBAC5D,wBAAwB,EACrB,eAA2B,CAAC,wBAAwB,IAAI,KAAK;aACjE,CACF,CAAA;QACH,CAAC,CAAA;IACH,CAAC,CAAA;AACH,CAAC"}

package/dist/modules-sdk/decorators/module.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=module.d.ts.map

package/dist/modules-sdk/decorators/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../src/modules-sdk/decorators/module.ts"],"names":[],"mappings":""}

package/dist/modules-sdk/decorators/module.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=module.js.map

package/dist/modules-sdk/decorators/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../../src/modules-sdk/decorators/module.ts"],"names":[],"mappings":""}

package/dist/modules-sdk/define-link.d.ts

@@ -0,0 +1,68 @@
+import { LinkModulesExtraFields } from "@8medusa/types";
+export declare const DefineLinkSymbol: unique symbol;
+export interface DefineLinkExport {
+    [DefineLinkSymbol]: boolean;
+    serviceName: string;
+    entity?: string;
+    entryPoint: string;
+}
+type InputSource = {
+    serviceName: string;
+    field: string;
+    entity?: string;
+    alias?: string;
+    linkable: string;
+    primaryKey: string;
+};
+type ReadOnlyInputSource = {
+    linkable: CombinedSource | InputSource | {
+        serviceName: string;
+        entity?: string;
+    };
+    field?: string;
+};
+type InputToJson = {
+    toJSON: () => InputSource;
+};
+type CombinedSource = Record<any, any> & InputToJson;
+type InputOptions = {
+    linkable: CombinedSource | InputSource;
+    field?: string;
+    isList?: boolean;
+    deleteCascade?: boolean;
+};
+type Shortcut = {
+    property: string;
+    path: string;
+    isList?: boolean;
+    forwardArguments?: string | string[];
+};
+type ExtraOptions = {
+    pk?: {
+        [key: string]: string;
+    };
+    database?: {
+        table?: string;
+        idPrefix?: string;
+        extraColumns?: LinkModulesExtraFields;
+    };
+    readOnly?: boolean;
+};
+type ReadOnlyExtraOptions = {
+    readOnly: true;
+    isList?: boolean;
+    shortcut?: Shortcut | Shortcut[];
+};
+type DefineLinkInputSource = InputSource | InputOptions | CombinedSource;
+type DefineReadOnlyLinkInputSource = ReadOnlyInputSource | InputOptions | CombinedSource;
+/**
+ * Generate a ModuleJoinerConfig for the link definition on the fly.
+ * All naming, aliases etc are following our conventional naming.
+ *
+ * @param leftService
+ * @param rightService
+ * @param linkServiceOptions
+ */
+export declare function defineLink(leftService: DefineLinkInputSource | DefineReadOnlyLinkInputSource, rightService: DefineLinkInputSource | DefineReadOnlyLinkInputSource, linkServiceOptions?: ExtraOptions | ReadOnlyExtraOptions): DefineLinkExport;
+export {};
+//# sourceMappingURL=define-link.d.ts.map

package/dist/modules-sdk/define-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-link.d.ts","sourceRoot":"","sources":["../../src/modules-sdk/define-link.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAsB,MAAM,gBAAgB,CAAA;AAI3E,eAAO,MAAM,gBAAgB,eAA2B,CAAA;AAExD,MAAM,WAAW,gBAAgB;IAC/B,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,KAAK,WAAW,GAAG;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,KAAK,mBAAmB,GAAG;IACzB,QAAQ,EACJ,cAAc,GACd,WAAW,GACX;QACE,WAAW,EAAE,MAAM,CAAA;QACnB,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;IACL,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED,KAAK,WAAW,GAAG;IACjB,MAAM,EAAE,MAAM,WAAW,CAAA;CAC1B,CAAA;AAED,KAAK,cAAc,GAAG,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,WAAW,CAAA;AAEpD,KAAK,YAAY,GAAG;IAClB,QAAQ,EAAE,cAAc,GAAG,WAAW,CAAA;IACtC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB,CAAA;AAED,KAAK,QAAQ,GAAG;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CACrC,CAAA;AAED,KAAK,YAAY,GAAG;IAClB,EAAE,CAAC,EAAE;QACH,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KACtB,CAAA;IACD,QAAQ,CAAC,EAAE;QACT,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,YAAY,CAAC,EAAE,sBAAsB,CAAA;KACtC,CAAA;IACD,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,KAAK,oBAAoB,GAAG;IAC1B,QAAQ,EAAE,IAAI,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAAA;CACjC,CAAA;AAED,KAAK,qBAAqB,GAAG,WAAW,GAAG,YAAY,GAAG,cAAc,CAAA;AAExE,KAAK,6BAA6B,GAC9B,mBAAmB,GACnB,YAAY,GACZ,cAAc,CAAA;AAqGlB;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,WAAW,EAAE,qBAAqB,GAAG,6BAA6B,EAClE,YAAY,EAAE,qBAAqB,GAAG,6BAA6B,EACnE,kBAAkB,CAAC,EAAE,YAAY,GAAG,oBAAoB,GACvD,gBAAgB,CAqQlB"}

package/dist/modules-sdk/define-link.js

@@ -0,0 +1,329 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefineLinkSymbol = void 0;
+exports.defineLink = defineLink;
+const common_1 = require("../common");
+const compose_link_name_1 = require("../link/compose-link-name");
+exports.DefineLinkSymbol = Symbol.for("DefineLink");
+function isInputOptions(input) {
+    return (0, common_1.isObject)(input) && input?.["linkable"];
+}
+function isInputSource(input) {
+    return ((0, common_1.isObject)(input) && input?.["serviceName"]) || input?.["toJSON"];
+}
+function isToJSON(input) {
+    return (0, common_1.isObject)(input) && input?.["toJSON"];
+}
+function buildFieldAlias(fieldAliases) {
+    if (!fieldAliases) {
+        return;
+    }
+    const fieldAlias = {};
+    const shortcuts = Array.isArray(fieldAliases) ? fieldAliases : [fieldAliases];
+    for (const sc of shortcuts) {
+        const fwArgs = sc.forwardArguments
+            ? Array.isArray(sc.forwardArguments)
+                ? sc.forwardArguments
+                : [sc.forwardArguments]
+            : [];
+        fieldAlias[sc.property] = {
+            path: sc.path,
+            isList: !!sc.isList,
+            forwardArgumentsOnPath: fwArgs,
+        };
+    }
+    return fieldAlias;
+}
+function prepareServiceConfig(input) {
+    let serviceConfig = {};
+    if (isInputSource(input)) {
+        const source = isToJSON(input) ? input.toJSON() : input;
+        serviceConfig = {
+            key: source.linkable,
+            alias: source.alias ?? (0, common_1.camelToSnakeCase)(source.field ?? ""),
+            field: input.field ?? source.field,
+            primaryKey: source.primaryKey,
+            isList: false,
+            hasMany: false,
+            deleteCascade: false,
+            module: source.serviceName,
+            entity: source.entity,
+        };
+    }
+    else if (isInputOptions(input)) {
+        const source = isToJSON(input.linkable)
+            ? input.linkable.toJSON()
+            : input.linkable;
+        const hasMany = !!input.isList;
+        serviceConfig = {
+            key: source.linkable,
+            alias: source.alias ?? (0, common_1.camelToSnakeCase)(source.field ?? ""),
+            field: input.field ?? source.field,
+            primaryKey: source.primaryKey,
+            isList: input.isList ?? false,
+            hasMany,
+            deleteCascade: input.deleteCascade ?? false,
+            module: source.serviceName,
+            entity: source.entity,
+        };
+    }
+    else {
+        throw new Error(`Invalid linkable passed for the argument\n${JSON.stringify(input, null, 2)}`);
+    }
+    return serviceConfig;
+}
+/**
+ * Generate a ModuleJoinerConfig for the link definition on the fly.
+ * All naming, aliases etc are following our conventional naming.
+ *
+ * @param leftService
+ * @param rightService
+ * @param linkServiceOptions
+ */
+function defineLink(leftService, rightService, linkServiceOptions) {
+    const serviceAObj = prepareServiceConfig(leftService);
+    const serviceBObj = prepareServiceConfig(rightService);
+    if (linkServiceOptions?.readOnly) {
+        return defineReadOnlyLink(serviceAObj, serviceBObj, linkServiceOptions);
+    }
+    const output = {
+        [exports.DefineLinkSymbol]: true,
+        serviceName: "",
+        entity: "",
+        entryPoint: "",
+    };
+    const register = function (modules) {
+        const serviceAInfo = modules.find((mod) => mod.serviceName === serviceAObj.module);
+        const serviceBInfo = modules.find((mod) => mod.serviceName === serviceBObj.module);
+        if (!serviceAInfo) {
+            throw new Error(`Service ${serviceAObj.module} was not found. If this is your module, make sure you set isQueryable to true in medusa-config.js:
+        
+${serviceAObj.module}: {
+  // ...
+  definition: {
+    isQueryable: true
+  }
+}`);
+        }
+        if (!serviceBInfo) {
+            throw new Error(`Service ${serviceBObj.module} was not found. If this is your module, make sure you set isQueryable to true in medusa-config.js:
+        
+${serviceBObj.module}: {
+  // ...
+  definition: {
+    isQueryable: true
+  }
+}`);
+        }
+        const serviceAKeyEntity = serviceAInfo.linkableKeys?.[serviceAObj.key];
+        const serviceBKeyInfo = serviceBInfo.linkableKeys?.[serviceBObj.key];
+        if (!serviceAKeyEntity) {
+            throw new Error(`Key ${serviceAObj.key} is not linkable on service ${serviceAObj.module}`);
+        }
+        if (!serviceBKeyInfo) {
+            throw new Error(`Key ${serviceBObj.key} is not linkable on service ${serviceBObj.module}`);
+        }
+        let serviceAAliases = serviceAInfo.alias ?? [];
+        if (!Array.isArray(serviceAAliases)) {
+            serviceAAliases = [serviceAAliases];
+        }
+        let aliasAOptions = serviceAObj.alias ??
+            serviceAAliases.find((a) => {
+                return a.entity == serviceAKeyEntity;
+            })?.name;
+        let aliasA = aliasAOptions;
+        if (Array.isArray(aliasAOptions)) {
+            aliasA = aliasAOptions[0];
+        }
+        if (!aliasA) {
+            throw new Error(`You need to provide an alias for ${serviceAObj.module}.${serviceAObj.key}`);
+        }
+        const serviceAObjEntryPoint = (0, common_1.camelToSnakeCase)(serviceAObj.field);
+        const serviceAMethodSuffix = serviceAAliases.find((serviceAlias) => {
+            return Array.isArray(serviceAlias.name)
+                ? serviceAlias.name.includes(serviceAObjEntryPoint)
+                : serviceAlias.name === serviceAObjEntryPoint;
+        })?.args?.methodSuffix;
+        let serviceBAliases = serviceBInfo.alias ?? [];
+        if (!Array.isArray(serviceBAliases)) {
+            serviceBAliases = [serviceBAliases];
+        }
+        let aliasBOptions = serviceBObj.alias ??
+            serviceBAliases.find((a) => {
+                return a.entity == serviceBKeyInfo;
+            })?.name;
+        let aliasB = aliasBOptions;
+        if (Array.isArray(aliasBOptions)) {
+            aliasB = aliasBOptions[0];
+        }
+        if (!aliasB) {
+            throw new Error(`You need to provide an alias for ${serviceBObj.module}.${serviceBObj.key}`);
+        }
+        const serviceBObjEntryPoint = (0, common_1.camelToSnakeCase)(serviceBObj.field);
+        const serviceBMethodSuffix = serviceBAliases.find((serviceAlias) => {
+            return Array.isArray(serviceAlias.name)
+                ? serviceAlias.name.includes(serviceBObjEntryPoint)
+                : serviceAlias.name === serviceBObjEntryPoint;
+        })?.args?.methodSuffix;
+        const moduleAPrimaryKeys = serviceAInfo.primaryKeys ?? [];
+        let serviceAPrimaryKey = serviceAObj.primaryKey ??
+            linkServiceOptions?.pk?.[serviceAObj.module] ??
+            moduleAPrimaryKeys;
+        if (Array.isArray(serviceAPrimaryKey)) {
+            serviceAPrimaryKey = serviceAPrimaryKey[0];
+        }
+        const isModuleAPrimaryKeyValid = moduleAPrimaryKeys.includes(serviceAPrimaryKey);
+        if (!isModuleAPrimaryKeyValid) {
+            throw new Error(`Primary key ${serviceAPrimaryKey} is not defined on service ${serviceAObj.module}`);
+        }
+        const moduleBPrimaryKeys = serviceBInfo.primaryKeys ?? [];
+        let serviceBPrimaryKey = serviceBObj.primaryKey ??
+            linkServiceOptions?.pk?.[serviceBObj.module] ??
+            moduleBPrimaryKeys;
+        if (Array.isArray(serviceBPrimaryKey)) {
+            serviceBPrimaryKey = serviceBPrimaryKey[0];
+        }
+        const isModuleBPrimaryKeyValid = moduleBPrimaryKeys.includes(serviceBPrimaryKey);
+        if (!isModuleBPrimaryKeyValid) {
+            throw new Error(`Primary key ${serviceBPrimaryKey} is not defined on service ${serviceBObj.module}`);
+        }
+        output.serviceName = (0, compose_link_name_1.composeLinkName)(serviceAObj.module, aliasA, serviceBObj.module, aliasB);
+        output.entryPoint = aliasA + "_" + aliasB;
+        output.entity = (0, common_1.toPascalCase)(["Link", serviceAObj.module, aliasA, serviceBObj.module, aliasB].join("_"));
+        const linkDefinition = {
+            serviceName: output.serviceName,
+            isLink: true,
+            alias: [
+                {
+                    name: [output.entryPoint],
+                    args: {
+                        entity: output.entity,
+                    },
+                },
+            ],
+            primaryKeys: ["id", serviceAObj.key, serviceBObj.key],
+            relationships: [
+                {
+                    serviceName: serviceAObj.module,
+                    entity: serviceAObj.entity,
+                    primaryKey: serviceAPrimaryKey,
+                    foreignKey: serviceAObj.key,
+                    alias: aliasA,
+                    args: {
+                        methodSuffix: serviceAMethodSuffix,
+                    },
+                    deleteCascade: serviceAObj.deleteCascade,
+                    hasMany: serviceAObj.hasMany,
+                },
+                {
+                    serviceName: serviceBObj.module,
+                    entity: serviceBObj.entity,
+                    primaryKey: serviceBPrimaryKey,
+                    foreignKey: serviceBObj.key,
+                    alias: aliasB,
+                    args: {
+                        methodSuffix: serviceBMethodSuffix,
+                    },
+                    deleteCascade: serviceBObj.deleteCascade,
+                    hasMany: serviceBObj.hasMany,
+                },
+            ],
+            extends: [
+                {
+                    serviceName: serviceAObj.module,
+                    entity: serviceAObj.entity,
+                    fieldAlias: buildFieldAlias({
+                        property: serviceBObj.isList ? (0, common_1.pluralize)(aliasB) : aliasB,
+                        path: aliasB + "_link." + aliasB,
+                        isList: serviceBObj.isList,
+                        forwardArguments: [aliasB + "_link." + aliasB],
+                    }),
+                    relationship: {
+                        serviceName: output.serviceName,
+                        entity: output.entity,
+                        primaryKey: serviceAObj.key,
+                        foreignKey: serviceAPrimaryKey,
+                        alias: aliasB + "_link",
+                        isList: serviceBObj.isList,
+                    },
+                },
+                {
+                    serviceName: serviceBObj.module,
+                    entity: serviceBObj.entity,
+                    fieldAlias: buildFieldAlias({
+                        property: serviceAObj.isList ? (0, common_1.pluralize)(aliasA) : aliasA,
+                        path: aliasA + "_link." + aliasA,
+                        isList: serviceAObj.isList,
+                        forwardArguments: [aliasA + "_link." + aliasA],
+                    }),
+                    relationship: {
+                        serviceName: output.serviceName,
+                        entity: output.entity,
+                        primaryKey: serviceBObj.key,
+                        foreignKey: serviceBPrimaryKey,
+                        alias: aliasA + "_link",
+                        isList: serviceAObj.isList,
+                    },
+                },
+            ],
+        };
+        if (linkServiceOptions?.database) {
+            const { table, idPrefix, extraColumns } = linkServiceOptions.database;
+            linkDefinition.databaseConfig = {
+                tableName: table,
+                idPrefix,
+                extraFields: extraColumns,
+            };
+        }
+        return linkDefinition;
+    };
+    global.MedusaModule.setCustomLink(register);
+    return output;
+}
+function defineReadOnlyLink(serviceAObj, serviceBObj, readOnlyLinkOptions) {
+    const register = function (modules) {
+        const serviceAInfo = modules.find((mod) => mod.serviceName === serviceAObj.module);
+        const serviceBInfo = modules.find((mod) => mod.serviceName === serviceBObj.module);
+        if (!serviceAInfo) {
+            throw new Error(`Service ${serviceAObj.module} was not found. If this is your module, make sure you set isQueryable to true in medusa-config.js:
+        
+${serviceAObj.module}: {
+  // ...
+  definition: {
+    isQueryable: true
+  }
+}`);
+        }
+        if (!serviceBInfo) {
+            throw new Error(`Service ${serviceBObj.module} was not found. If this is your module, make sure you set isQueryable to true in medusa-config.js:
+        
+${serviceBObj.module}: {
+  // ...
+  definition: {
+    isQueryable: true
+  }
+}`);
+        }
+        return {
+            isLink: true,
+            isReadOnlyLink: true,
+            extends: [
+                {
+                    serviceName: serviceAObj.module,
+                    entity: serviceAObj.entity,
+                    fieldAlias: buildFieldAlias(readOnlyLinkOptions?.shortcut),
+                    relationship: {
+                        serviceName: serviceBObj.module,
+                        entity: serviceBObj.entity,
+                        primaryKey: serviceBObj.primaryKey,
+                        foreignKey: serviceAObj.field,
+                        alias: serviceBObj.alias,
+                        isList: readOnlyLinkOptions?.isList ?? serviceAObj.isList,
+                    },
+                },
+            ],
+        };
+    };
+    global.MedusaModule.setCustomLink(register);
+}
+//# sourceMappingURL=define-link.js.map