@relaybus/eslint-plugin 0.0.0-stage → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Berkcan Şavur
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,93 @@
-# Temporary Holding Version
+# @relaybus/eslint-plugin
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+@relaybus/eslint-plugin is the ESLint plugin of relaybus, a reliable, storage-agnostic event bus for NestJS and Node.js: it keeps outbox transactions short and events atomic with your writes by flagging calls to other services inside a transaction and `publish` calls outside one.
+
+```sh
+pnpm add -D @relaybus/eslint-plugin
+```
+
+ESLint 9 or newer, flat config. For TypeScript files with decorators use the `typescript-eslint` parser (type information is not needed).
+
+```js
+// eslint.config.js
+import tseslint from 'typescript-eslint';
+import relaybus from '@relaybus/eslint-plugin';
+
+export default tseslint.config(...tseslint.configs.recommended, relaybus.configs.recommended);
+```
+
+`recommended` turns both rules on at `error` under the plugin name `@relaybus`.
+
+## Where a transaction is
+
+Both rules agree on what runs inside a transaction:
+
+- a method decorated with `@RelayBusTransaction()`;
+- a handler that runs in a transaction: `@RelayBusConsumer(Event, { transactional: true })`, an
+  `on<Event>` method of a `@RelayBusCatalogConsumer(Catalog, { transactional: true })` class (also
+  under the deprecated names `@Subscribe` and `@EventConsumer`), and
+  `bus.subscribe(Event, handler, { transactional: true })`;
+- the callback of `x.transaction(...)`, `x.$transaction(...)` or `x.withTransaction(...)`
+  (`bus.transaction`, TypeORM, Knex, Sequelize, Prisma, MongoDB sessions);
+- any method of the same class called through `this.method()` from one of the above, transitively.
+
+## `@relaybus/no-external-call-in-transaction`
+
+Reports calls to other services inside a transaction: `fetch`, `axios` (`axios(...)`,
+`axios.get(...)`, any method), `got`, `http.request` / `http.get` / `https.*` of Node.js, `undici`
+(`request`, `fetch`, `stream`, `pipeline`), and `HttpService` of `@nestjs/axios`
+(`this.httpService.get(...)`, `this.http.post(...)`, `httpService.axiosRef.get(...)`). Imports,
+renamed imports and `require` are followed.
+
+A transaction holds its row locks and a database connection until it ends. An HTTP call inside it
+makes every other writer of those rows wait for the remote service, and relaybus rolls the
+transaction back with `TransactionTimeoutError` once it outlives `transactionTimeout`.
+
+```ts
+// Reported
+@RelayBusTransaction()
+async place(order: Order): Promise<void> {
+  const price = await this.httpService.axiosRef.get(`/prices/${order.sku}`);
+  await this.orders.insert({ ...order, price: price.data });
+  await this.bus.publish(new OrderPlaced({ orderId: order.id }));
+}
+
+// Fixed: call before the transaction, and react to the event after the commit
+async place(order: Order): Promise<void> {
+  const price = await this.httpService.axiosRef.get(`/prices/${order.sku}`);
+  await this.save({ ...order, price: price.data });
+}
+
+@RelayBusTransaction()
+private async save(order: PricedOrder): Promise<void> {
+  await this.orders.insert(order);
+  await this.bus.publish(new OrderPlaced({ orderId: order.id }));
+}
+```
+
+## `@relaybus/publish-requires-transaction`
+
+Reports `publish` / `publishAll` on a relaybus bus or catalog publisher outside a transaction
+without `{ transaction }`. Such a publish is not atomic with your writes and throws
+`TransactionRequiredError` at runtime (`transactionMode: 'required'`, the default). Options that
+the rule cannot see into (a variable, a spread) are trusted.
+
+The publishers are recognised by name: the object's last name ends in `bus`, `Bus`, `publisher` or
+`Publisher` (`this.bus`, `eventBus`, `orderPublisher`). Set your own pattern when you name them
+differently:
+
+```js
+{ rules: { '@relaybus/publish-requires-transaction': ['error', { publishers: '^(bus|orders)$' }] } }
+```
+
+## Limits
+
+The rules read one file and know names, not types: a call to a service hidden behind your own
+wrapper function, or a transaction opened in another file, is not seen. The runtime checks stay in
+place behind them (`TransactionRequiredError`, `transactionTimeout`).
+
+Documentation: https://berkcansavur.github.io/relaybus/recipes/transactions-in-nestjs
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,342 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+// src/ast.ts
+var FUNCTION_TYPES = /* @__PURE__ */ new Set([
+  "FunctionExpression",
+  "ArrowFunctionExpression",
+  "FunctionDeclaration"
+]);
+function isFunction(node) {
+  return FUNCTION_TYPES.has(node.type);
+}
+function findDecorator(node, names) {
+  for (const { expression } of node.decorators ?? []) {
+    if (expression.type === "CallExpression" && expression.callee.type === "Identifier" && names.has(expression.callee.name)) {
+      return expression;
+    }
+  }
+  return void 0;
+}
+function hasTransactionalOption(call) {
+  return call.arguments.some(
+    (argument) => argument.type === "ObjectExpression" && argument.properties.some(
+      (property) => property.type === "Property" && definitionName(property) === "transactional" && property.value.type === "Literal" && property.value.value === true
+    )
+  );
+}
+function keyName(key) {
+  if (key.type === "Identifier") {
+    return key.name;
+  }
+  if (key.type === "PrivateIdentifier") {
+    return `#${key.name}`;
+  }
+  return key.type === "Literal" && typeof key.value === "string" ? key.value : void 0;
+}
+function memberName(member) {
+  return staticName(member.computed, member.property);
+}
+function definitionName(definition) {
+  return staticName(definition.computed, definition.key);
+}
+function staticName(computed, key) {
+  return computed && key.type !== "Literal" ? void 0 : keyName(key);
+}
+function lastName(node) {
+  if (node.type === "Identifier") {
+    return node.name;
+  }
+  return node.type === "MemberExpression" ? memberName(node) : void 0;
+}
+
+// src/external-calls.ts
+var MODULES = {
+  axios: "axios",
+  got: "got",
+  http: "http",
+  "node:http": "http",
+  https: "http",
+  "node:https": "http",
+  undici: "undici"
+};
+var REQUEST_MEMBERS = {
+  axios: void 0,
+  got: void 0,
+  http: /* @__PURE__ */ new Set(["request", "get"]),
+  undici: /* @__PURE__ */ new Set(["request", "fetch", "stream", "pipeline"])
+};
+var HTTP_SERVICE_NAME = /^(?:http|httpService|axiosRef)$/i;
+var ExternalCallDetector = class {
+  /** Local names of imported HTTP client modules. */
+  #modules = /* @__PURE__ */ new Map([
+    ["axios", "axios"],
+    ["got", "got"]
+  ]);
+  /** Local names of imported request functions, such as `request` from `undici`. */
+  #functions = /* @__PURE__ */ new Set(["fetch"]);
+  /** Records `import x from 'axios'`, `import * as https from 'node:https'`, `import { request } from 'undici'`. */
+  recordImport(declaration) {
+    const module = MODULES[String(declaration.source.value)];
+    if (module === void 0) {
+      return;
+    }
+    for (const specifier of declaration.specifiers) {
+      if (specifier.type !== "ImportSpecifier") {
+        this.#modules.set(specifier.local.name, module);
+      } else if (REQUEST_MEMBERS[module]?.has(importedName(specifier)) === true) {
+        this.#functions.add(specifier.local.name);
+      }
+    }
+  }
+  /** Records `const axios = require('axios')`. */
+  recordRequire(declarator) {
+    const { id, init } = declarator;
+    if (id.type === "Identifier" && init?.type === "CallExpression" && lastName(init.callee) === "require" && init.arguments[0]?.type === "Literal") {
+      const module = MODULES[String(init.arguments[0].value)];
+      if (module !== void 0) {
+        this.#modules.set(id.name, module);
+      }
+    }
+  }
+  /** Whether `call` sends a request to another service. */
+  isExternalCall(call) {
+    const { callee } = call;
+    if (callee.type === "Identifier") {
+      const module = this.#modules.get(callee.name);
+      return this.#functions.has(callee.name) || module === "axios" || module === "got";
+    }
+    return callee.type === "MemberExpression" && this.#isClientMember(callee);
+  }
+  /** `axios.post`, `https.request`, `this.httpService.get`, `httpService.axiosRef.get`. */
+  #isClientMember(callee) {
+    if (HTTP_SERVICE_NAME.test(lastName(callee.object) ?? "")) {
+      return true;
+    }
+    const module = callee.object.type === "Identifier" ? this.#modules.get(callee.object.name) : void 0;
+    if (module === void 0) {
+      return false;
+    }
+    return REQUEST_MEMBERS[module]?.has(memberName(callee) ?? "") ?? true;
+  }
+};
+function importedName(specifier) {
+  const { imported } = specifier;
+  return imported.type === "Identifier" ? imported.name : String(imported.value);
+}
+
+// src/transaction-scopes.ts
+var TRANSACTION_METHODS = /* @__PURE__ */ new Set(["transaction", "$transaction", "withTransaction"]);
+var TRANSACTION_DECORATORS = /* @__PURE__ */ new Set(["RelayBusTransaction"]);
+var CONSUMER_DECORATORS = /* @__PURE__ */ new Set(["RelayBusConsumer", "Subscribe"]);
+var CATALOG_CONSUMER_DECORATORS = /* @__PURE__ */ new Set(["RelayBusCatalogConsumer", "EventConsumer"]);
+var CATALOG_HANDLER_NAME = /^on[A-Z]/;
+function isTransactionalMethod(method) {
+  if (findDecorator(method, TRANSACTION_DECORATORS) !== void 0) {
+    return true;
+  }
+  const consumer = findDecorator(method, CONSUMER_DECORATORS);
+  if (consumer !== void 0 && hasTransactionalOption(consumer)) {
+    return true;
+  }
+  const catalogConsumer = findDecorator(method.parent.parent, CATALOG_CONSUMER_DECORATORS);
+  return catalogConsumer !== void 0 && hasTransactionalOption(catalogConsumer) && CATALOG_HANDLER_NAME.test(definitionName(method) ?? "");
+}
+function isTransactionScope(fn) {
+  const parent = fn.parent;
+  if (parent.type === "MethodDefinition") {
+    return isTransactionalMethod(parent);
+  }
+  if (parent.type !== "CallExpression" || parent.callee.type !== "MemberExpression") {
+    return false;
+  }
+  const method = memberName(parent.callee);
+  if (TRANSACTION_METHODS.has(method ?? "")) {
+    return parent.arguments[0] === fn;
+  }
+  return method === "subscribe" && parent.arguments[1] === fn && hasTransactionalOption(parent);
+}
+
+// src/transaction-tracker.ts
+var TransactionTracker = class {
+  #sourceCode;
+  #thisCalls = [];
+  #transactional = /* @__PURE__ */ new Map();
+  constructor(sourceCode) {
+    this.#sourceCode = sourceCode;
+  }
+  record(call) {
+    const { callee } = call;
+    if (callee.type !== "MemberExpression" || callee.object.type !== "ThisExpression") {
+      return;
+    }
+    const method = memberName(callee);
+    const classBody = this.#ancestors(call).findLast((ancestor) => ancestor.type === "ClassBody");
+    if (method !== void 0 && classBody !== void 0) {
+      this.#thisCalls.push({ node: call, method, classBody });
+    }
+  }
+  isInTransaction(node) {
+    return this.#isInTransaction(node, (classBody) => this.#transactionalMethods(classBody));
+  }
+  #isInTransaction(node, methodsOf) {
+    for (const ancestor of this.#ancestors(node).reverse()) {
+      if (isFunction(ancestor) && isTransactionScope(ancestor)) {
+        return true;
+      }
+      if (ancestor.type === "MethodDefinition") {
+        return methodsOf(ancestor.parent).has(definitionName(ancestor) ?? "");
+      }
+    }
+    return false;
+  }
+  #ancestors(node) {
+    return this.#sourceCode.getAncestors(node);
+  }
+  /** Methods of a class that run in a transaction, directly or through `this.method()` calls. */
+  #transactionalMethods(classBody) {
+    const known = this.#transactional.get(classBody);
+    if (known !== void 0) {
+      return known;
+    }
+    const methods = new Set(
+      classBody.body.filter((member) => member.type === "MethodDefinition").filter((member) => isTransactionalMethod(member)).map((member) => definitionName(member) ?? "")
+    );
+    const calls = this.#thisCalls.filter((call) => call.classBody === classBody);
+    for (let grew = true; grew; ) {
+      const added = calls.filter(
+        (call) => !methods.has(call.method) && this.#isInTransaction(call.node, () => methods)
+      );
+      added.forEach((call) => methods.add(call.method));
+      grew = added.length > 0;
+    }
+    this.#transactional.set(classBody, methods);
+    return methods;
+  }
+};
+
+// src/rules/no-external-call-in-transaction.ts
+var noExternalCallInTransaction = {
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Disallow calls to other services inside a database transaction",
+      url: "https://berkcansavur.github.io/relaybus/recipes/transactions-in-nestjs"
+    },
+    schema: [],
+    messages: {
+      externalCall: "{{call}} calls another service inside a transaction. The transaction keeps its row locks and its database connection until the call returns, and relaybus rolls it back with TransactionTimeoutError once it outlives transactionTimeout. Make the call before the transaction starts or after it commits (for example from the handler of an event you publish)."
+    }
+  },
+  create(context) {
+    const tracker = new TransactionTracker(context.sourceCode);
+    const detector = new ExternalCallDetector();
+    const calls = [];
+    return {
+      ImportDeclaration: (node) => detector.recordImport(node),
+      VariableDeclarator: (node) => detector.recordRequire(node),
+      CallExpression: (node) => {
+        tracker.record(node);
+        calls.push(node);
+      },
+      "Program:exit": () => {
+        for (const call of calls) {
+          if (detector.isExternalCall(call) && tracker.isInTransaction(call)) {
+            context.report({
+              node: call,
+              messageId: "externalCall",
+              data: { call: `${context.sourceCode.getText(call.callee)}()` }
+            });
+          }
+        }
+      }
+    };
+  }
+};
+
+// src/rules/publish-requires-transaction.ts
+var PUBLISH_METHODS = /* @__PURE__ */ new Set(["publish", "publishAll"]);
+var DEFAULT_PUBLISHERS = "(?:^|[a-z_$])(?:[Bb]us|[Pp]ublisher)$|^(?:bus|publisher)$";
+function passesTransaction(call) {
+  const options = call.arguments[1];
+  if (options === void 0) {
+    return false;
+  }
+  if (options.type !== "ObjectExpression") {
+    return true;
+  }
+  return options.properties.some(
+    (property) => property.type === "SpreadElement" || definitionName(property) === "transaction"
+  );
+}
+var publishRequiresTransaction = {
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Require relaybus publish calls to run inside a transaction",
+      url: "https://berkcansavur.github.io/relaybus/recipes/transactions-in-nestjs"
+    },
+    schema: [
+      {
+        type: "object",
+        properties: { publishers: { type: "string" } },
+        additionalProperties: false
+      }
+    ],
+    messages: {
+      noTransaction: "{{call}} runs outside a transaction, so the event is not atomic with your writes and relaybus throws TransactionRequiredError. Publish inside a @RelayBusTransaction() method or a bus.transaction(...) callback, or pass { transaction }."
+    }
+  },
+  create(context) {
+    const [options = {}] = context.options;
+    const publishers = new RegExp(options.publishers ?? DEFAULT_PUBLISHERS);
+    const tracker = new TransactionTracker(context.sourceCode);
+    const publishes = [];
+    return {
+      CallExpression: (node) => {
+        tracker.record(node);
+        const { callee } = node;
+        if (callee.type === "MemberExpression" && PUBLISH_METHODS.has(memberName(callee) ?? "") && publishers.test(lastName(callee.object) ?? "")) {
+          publishes.push(node);
+        }
+      },
+      "Program:exit": () => {
+        for (const call of publishes) {
+          if (!passesTransaction(call) && !tracker.isInTransaction(call)) {
+            context.report({
+              node: call,
+              messageId: "noTransaction",
+              data: { call: `${context.sourceCode.getText(call.callee)}()` }
+            });
+          }
+        }
+      }
+    };
+  }
+};
+
+// src/index.ts
+var rules = {
+  "no-external-call-in-transaction": noExternalCallInTransaction,
+  "publish-requires-transaction": publishRequiresTransaction
+};
+var plugin = { meta: { name: "@relaybus/eslint-plugin" }, rules };
+var configs = {
+  recommended: {
+    name: "@relaybus/recommended",
+    plugins: { "@relaybus": plugin },
+    rules: {
+      "@relaybus/no-external-call-in-transaction": "error",
+      "@relaybus/publish-requires-transaction": "error"
+    }
+  }
+};
+var relaybus = { ...plugin, configs };
+var index_default = relaybus;
+
+exports.configs = configs;
+exports.default = index_default;
+exports.rules = rules;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ast.ts","../src/external-calls.ts","../src/transaction-scopes.ts","../src/transaction-tracker.ts","../src/rules/no-external-call-in-transaction.ts","../src/rules/publish-requires-transaction.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import type { Rule } from 'eslint';\nimport type * as ESTree from 'estree';\n\n/** A function node as ESLint hands it to rules, with its parent. */\nexport type FunctionNode = Rule.Node &\n  (ESTree.FunctionExpression | ESTree.ArrowFunctionExpression | ESTree.FunctionDeclaration);\n\n/** What the TypeScript parser adds to classes and class members. */\ntype Decorated = { readonly decorators?: readonly { readonly expression: ESTree.Node }[] };\n\nconst FUNCTION_TYPES = new Set([\n  'FunctionExpression',\n  'ArrowFunctionExpression',\n  'FunctionDeclaration',\n]);\n\nexport function isFunction(node: Rule.Node): node is FunctionNode {\n  return FUNCTION_TYPES.has(node.type);\n}\n\n/** The call of the first decorator of `node` named one of `names`, such as `@RelayBusTransaction()`. */\nexport function findDecorator(\n  node: object,\n  names: ReadonlySet<string>,\n): ESTree.CallExpression | undefined {\n  for (const { expression } of (node as Decorated).decorators ?? []) {\n    if (\n      expression.type === 'CallExpression' &&\n      expression.callee.type === 'Identifier' &&\n      names.has(expression.callee.name)\n    ) {\n      return expression;\n    }\n  }\n  return undefined;\n}\n\n/** Whether an argument of `call` is an object literal with `transactional: true`. */\nexport function hasTransactionalOption(call: ESTree.CallExpression): boolean {\n  return call.arguments.some(\n    (argument) =>\n      argument.type === 'ObjectExpression' &&\n      argument.properties.some(\n        (property) =>\n          property.type === 'Property' &&\n          definitionName(property) === 'transactional' &&\n          property.value.type === 'Literal' &&\n          property.value.value === true,\n      ),\n  );\n}\n\n/**\n * The name of a property key, class member or import: `name`, `#name` for a private member, the\n * text of a string literal (`'name'`); undefined for anything computed at runtime.\n */\nexport function keyName(key: ESTree.Node): string | undefined {\n  if (key.type === 'Identifier') {\n    return key.name;\n  }\n  if (key.type === 'PrivateIdentifier') {\n    return `#${key.name}`;\n  }\n  return key.type === 'Literal' && typeof key.value === 'string' ? key.value : undefined;\n}\n\n/** The member a member expression reads: `get` for `a.get` and `a['get']`, undefined for `a[name]`. */\nexport function memberName(member: ESTree.MemberExpression): string | undefined {\n  return staticName(member.computed, member.property);\n}\n\n/** The name of a class member or object property: `place` for `place()` and `['place']()`, undefined for `[name]()`. */\nexport function definitionName(\n  definition: ESTree.MethodDefinition | ESTree.Property,\n): string | undefined {\n  return staticName(definition.computed, definition.key);\n}\n\nfunction staticName(computed: boolean, key: ESTree.Node): string | undefined {\n  return computed && key.type !== 'Literal' ? undefined : keyName(key);\n}\n\n/** The last name of an expression: `bus` for `bus`, `this.bus` and `app.services.bus`. */\nexport function lastName(node: ESTree.Node): string | undefined {\n  if (node.type === 'Identifier') {\n    return node.name;\n  }\n  return node.type === 'MemberExpression' ? memberName(node) : undefined;\n}\n","import type { Rule } from 'eslint';\nimport type * as ESTree from 'estree';\nimport { lastName, memberName } from './ast.js';\n\n/** HTTP client modules, by import source. */\ntype ClientModule = 'axios' | 'got' | 'http' | 'undici';\n\nconst MODULES: Readonly<Record<string, ClientModule>> = {\n  axios: 'axios',\n  got: 'got',\n  http: 'http',\n  'node:http': 'http',\n  https: 'http',\n  'node:https': 'http',\n  undici: 'undici',\n};\n\n/** Members of a module object that send a request; `undefined`: every member does. */\nconst REQUEST_MEMBERS: Readonly<Record<ClientModule, ReadonlySet<string> | undefined>> = {\n  axios: undefined,\n  got: undefined,\n  http: new Set(['request', 'get']),\n  undici: new Set(['request', 'fetch', 'stream', 'pipeline']),\n};\n\n/** `HttpService` of `@nestjs/axios`, injected as `httpService` (or `http`), and its `axiosRef`. */\nconst HTTP_SERVICE_NAME = /^(?:http|httpService|axiosRef)$/i;\n\n/**\n * Recognises calls to other services: `fetch`, `axios` and `got` (called or through a method),\n * `http.request` / `https.get` of Node.js, `undici.request` and friends (imported or required),\n * and `HttpService` of `@nestjs/axios`.\n */\nexport class ExternalCallDetector {\n  /** Local names of imported HTTP client modules. */\n  readonly #modules = new Map<string, ClientModule>([\n    ['axios', 'axios'],\n    ['got', 'got'],\n  ]);\n  /** Local names of imported request functions, such as `request` from `undici`. */\n  readonly #functions = new Set<string>(['fetch']);\n\n  /** Records `import x from 'axios'`, `import * as https from 'node:https'`, `import { request } from 'undici'`. */\n  recordImport(declaration: ESTree.ImportDeclaration): void {\n    const module = MODULES[String(declaration.source.value)];\n    if (module === undefined) {\n      return;\n    }\n    for (const specifier of declaration.specifiers) {\n      if (specifier.type !== 'ImportSpecifier') {\n        this.#modules.set(specifier.local.name, module);\n      } else if (REQUEST_MEMBERS[module]?.has(importedName(specifier)) === true) {\n        this.#functions.add(specifier.local.name);\n      }\n    }\n  }\n\n  /** Records `const axios = require('axios')`. */\n  recordRequire(declarator: ESTree.VariableDeclarator): void {\n    const { id, init } = declarator;\n    if (\n      id.type === 'Identifier' &&\n      init?.type === 'CallExpression' &&\n      lastName(init.callee) === 'require' &&\n      init.arguments[0]?.type === 'Literal'\n    ) {\n      const module = MODULES[String(init.arguments[0].value)];\n      if (module !== undefined) {\n        this.#modules.set(id.name, module);\n      }\n    }\n  }\n\n  /** Whether `call` sends a request to another service. */\n  isExternalCall(call: Rule.Node & ESTree.CallExpression): boolean {\n    const { callee } = call;\n    if (callee.type === 'Identifier') {\n      const module = this.#modules.get(callee.name);\n      return this.#functions.has(callee.name) || module === 'axios' || module === 'got';\n    }\n    return callee.type === 'MemberExpression' && this.#isClientMember(callee);\n  }\n\n  /** `axios.post`, `https.request`, `this.httpService.get`, `httpService.axiosRef.get`. */\n  #isClientMember(callee: ESTree.MemberExpression): boolean {\n    if (HTTP_SERVICE_NAME.test(lastName(callee.object) ?? '')) {\n      return true;\n    }\n    const module =\n      callee.object.type === 'Identifier' ? this.#modules.get(callee.object.name) : undefined;\n    if (module === undefined) {\n      return false;\n    }\n    return REQUEST_MEMBERS[module]?.has(memberName(callee) ?? '') ?? true;\n  }\n}\n\n/** `request` for `import { request }` and `import { 'request' as send }`. */\nfunction importedName(specifier: ESTree.ImportSpecifier): string {\n  const { imported } = specifier;\n  return imported.type === 'Identifier' ? imported.name : String(imported.value);\n}\n","import type { Rule } from 'eslint';\nimport type * as ESTree from 'estree';\nimport {\n  findDecorator,\n  definitionName,\n  hasTransactionalOption,\n  memberName,\n  type FunctionNode,\n} from './ast.js';\n\n/** Methods whose callback runs in a database transaction: relaybus, TypeORM, Knex, Sequelize, Prisma, MongoDB sessions. */\nconst TRANSACTION_METHODS = new Set(['transaction', '$transaction', 'withTransaction']);\nconst TRANSACTION_DECORATORS = new Set(['RelayBusTransaction']);\n/** Method decorators of relaybus handlers, current name and deprecated alias. */\nconst CONSUMER_DECORATORS = new Set(['RelayBusConsumer', 'Subscribe']);\n/** Class decorators of relaybus catalog handlers, current name and deprecated alias. */\nconst CATALOG_CONSUMER_DECORATORS = new Set(['RelayBusCatalogConsumer', 'EventConsumer']);\nconst CATALOG_HANDLER_NAME = /^on[A-Z]/;\n\n/**\n * Whether `method` runs in a transaction by itself: `@RelayBusTransaction()`, a\n * `@RelayBusConsumer(..., { transactional: true })` handler, or an `on<Event>` method of a class\n * marked `@RelayBusCatalogConsumer(..., { transactional: true })` (or the deprecated names).\n */\nexport function isTransactionalMethod(method: Rule.Node & ESTree.MethodDefinition): boolean {\n  if (findDecorator(method, TRANSACTION_DECORATORS) !== undefined) {\n    return true;\n  }\n  const consumer = findDecorator(method, CONSUMER_DECORATORS);\n  if (consumer !== undefined && hasTransactionalOption(consumer)) {\n    return true;\n  }\n  // A method's parent is the class body, whose parent is the class.\n  const catalogConsumer = findDecorator(method.parent.parent!, CATALOG_CONSUMER_DECORATORS);\n  return (\n    catalogConsumer !== undefined &&\n    hasTransactionalOption(catalogConsumer) &&\n    CATALOG_HANDLER_NAME.test(definitionName(method) ?? '')\n  );\n}\n\n/**\n * Whether `fn` runs in a transaction: a transactional method, the callback of\n * `x.transaction(fn)` (`bus.transaction`, `dataSource.transaction`, `prisma.$transaction`,\n * `session.withTransaction`), or a handler subscribed with `{ transactional: true }`.\n */\nexport function isTransactionScope(fn: FunctionNode): boolean {\n  const parent = fn.parent;\n  if (parent.type === 'MethodDefinition') {\n    return isTransactionalMethod(parent);\n  }\n  if (parent.type !== 'CallExpression' || parent.callee.type !== 'MemberExpression') {\n    return false;\n  }\n  const method = memberName(parent.callee);\n  if (TRANSACTION_METHODS.has(method ?? '')) {\n    return parent.arguments[0] === fn;\n  }\n  return method === 'subscribe' && parent.arguments[1] === fn && hasTransactionalOption(parent);\n}\n","import type { Rule, SourceCode } from 'eslint';\nimport type * as ESTree from 'estree';\nimport { definitionName, isFunction, memberName } from './ast.js';\nimport { isTransactionScope, isTransactionalMethod } from './transaction-scopes.js';\n\n/** A `this.method()` call and the class body it is written in. */\ntype ThisCall = {\n  readonly node: Rule.Node;\n  readonly method: string;\n  readonly classBody: Rule.Node;\n};\n\n/**\n * Tells whether a node runs inside a transaction. Besides transaction callbacks and transactional\n * methods, a method of the same class that is called with `this.method()` from inside a transaction\n * counts as well, transitively, so helpers of a `@RelayBusTransaction()` method are covered.\n * Record every call with {@link record} while traversing; ask {@link isInTransaction} at `Program:exit`.\n */\nexport class TransactionTracker {\n  readonly #sourceCode: SourceCode;\n  readonly #thisCalls: ThisCall[] = [];\n  readonly #transactional = new Map<Rule.Node, Set<string>>();\n\n  constructor(sourceCode: SourceCode) {\n    this.#sourceCode = sourceCode;\n  }\n\n  record(call: Rule.Node & ESTree.CallExpression): void {\n    const { callee } = call;\n    if (callee.type !== 'MemberExpression' || callee.object.type !== 'ThisExpression') {\n      return;\n    }\n    const method = memberName(callee);\n    const classBody = this.#ancestors(call).findLast((ancestor) => ancestor.type === 'ClassBody');\n    if (method !== undefined && classBody !== undefined) {\n      this.#thisCalls.push({ node: call, method, classBody });\n    }\n  }\n\n  isInTransaction(node: Rule.Node): boolean {\n    return this.#isInTransaction(node, (classBody) => this.#transactionalMethods(classBody));\n  }\n\n  #isInTransaction(node: Rule.Node, methodsOf: (classBody: Rule.Node) => Set<string>): boolean {\n    for (const ancestor of this.#ancestors(node).reverse()) {\n      if (isFunction(ancestor) && isTransactionScope(ancestor)) {\n        return true;\n      }\n      if (ancestor.type === 'MethodDefinition') {\n        return methodsOf(ancestor.parent).has(definitionName(ancestor) ?? '');\n      }\n    }\n    return false;\n  }\n\n  #ancestors(node: Rule.Node): Rule.Node[] {\n    return this.#sourceCode.getAncestors(node) as Rule.Node[];\n  }\n\n  /** Methods of a class that run in a transaction, directly or through `this.method()` calls. */\n  #transactionalMethods(classBody: Rule.Node): Set<string> {\n    const known = this.#transactional.get(classBody);\n    if (known !== undefined) {\n      return known;\n    }\n    const methods = new Set(\n      (classBody as Rule.Node & ESTree.ClassBody).body\n        .filter((member) => member.type === 'MethodDefinition')\n        .filter((member) => isTransactionalMethod(member as Rule.Node & ESTree.MethodDefinition))\n        .map((member) => definitionName(member) ?? ''),\n    );\n    const calls = this.#thisCalls.filter((call) => call.classBody === classBody);\n    for (let grew = true; grew;) {\n      const added = calls.filter(\n        (call) => !methods.has(call.method) && this.#isInTransaction(call.node, () => methods),\n      );\n      added.forEach((call) => methods.add(call.method));\n      grew = added.length > 0;\n    }\n    this.#transactional.set(classBody, methods);\n    return methods;\n  }\n}\n","import type { Rule } from 'eslint';\nimport type * as ESTree from 'estree';\nimport { ExternalCallDetector } from '../external-calls.js';\nimport { TransactionTracker } from '../transaction-tracker.js';\n\n/**\n * Reports calls to other services (HTTP clients) made inside a transaction: a\n * `@RelayBusTransaction()` method, a transactional handler, a `bus.transaction` (or other\n * `.transaction`) callback, and the methods they call through `this`.\n */\nexport const noExternalCallInTransaction: Rule.RuleModule = {\n  meta: {\n    type: 'problem',\n    docs: {\n      description: 'Disallow calls to other services inside a database transaction',\n      url: 'https://berkcansavur.github.io/relaybus/recipes/transactions-in-nestjs',\n    },\n    schema: [],\n    messages: {\n      externalCall:\n        '{{call}} calls another service inside a transaction. The transaction keeps its row locks ' +\n        'and its database connection until the call returns, and relaybus rolls it back with ' +\n        'TransactionTimeoutError once it outlives transactionTimeout. Make the call before the ' +\n        'transaction starts or after it commits (for example from the handler of an event you publish).',\n    },\n  },\n  create(context) {\n    const tracker = new TransactionTracker(context.sourceCode);\n    const detector = new ExternalCallDetector();\n    const calls: (Rule.Node & ESTree.CallExpression)[] = [];\n    return {\n      ImportDeclaration: (node) => detector.recordImport(node),\n      VariableDeclarator: (node) => detector.recordRequire(node),\n      CallExpression: (node) => {\n        tracker.record(node);\n        calls.push(node);\n      },\n      'Program:exit': () => {\n        for (const call of calls) {\n          if (detector.isExternalCall(call) && tracker.isInTransaction(call)) {\n            context.report({\n              node: call,\n              messageId: 'externalCall',\n              data: { call: `${context.sourceCode.getText(call.callee)}()` },\n            });\n          }\n        }\n      },\n    };\n  },\n};\n","import type { Rule } from 'eslint';\nimport type * as ESTree from 'estree';\nimport { definitionName, lastName, memberName } from '../ast.js';\nimport { TransactionTracker } from '../transaction-tracker.js';\n\nconst PUBLISH_METHODS = new Set(['publish', 'publishAll']);\n/** Default names of the objects whose `publish` is a relaybus publish: `bus`, `this.eventBus`, `orderPublisher`. */\nconst DEFAULT_PUBLISHERS = '(?:^|[a-z_$])(?:[Bb]us|[Pp]ublisher)$|^(?:bus|publisher)$';\n\ntype Options = { readonly publishers?: string };\n\n/**\n * Whether `call` passes a transaction itself: `{ transaction }` in its options, or options the\n * rule cannot see into (a variable, a spread).\n */\nfunction passesTransaction(call: ESTree.CallExpression): boolean {\n  const options = call.arguments[1];\n  if (options === undefined) {\n    return false;\n  }\n  if (options.type !== 'ObjectExpression') {\n    return true;\n  }\n  return options.properties.some(\n    (property) => property.type === 'SpreadElement' || definitionName(property) === 'transaction',\n  );\n}\n\n/**\n * Reports `bus.publish` / `bus.publishAll` outside a transaction: not in a\n * `@RelayBusTransaction()` method, a transactional handler or a `.transaction` callback (or a\n * method they call through `this`), and without `{ transaction }`.\n */\nexport const publishRequiresTransaction: Rule.RuleModule = {\n  meta: {\n    type: 'problem',\n    docs: {\n      description: 'Require relaybus publish calls to run inside a transaction',\n      url: 'https://berkcansavur.github.io/relaybus/recipes/transactions-in-nestjs',\n    },\n    schema: [\n      {\n        type: 'object',\n        properties: { publishers: { type: 'string' } },\n        additionalProperties: false,\n      },\n    ],\n    messages: {\n      noTransaction:\n        '{{call}} runs outside a transaction, so the event is not atomic with your writes and ' +\n        'relaybus throws TransactionRequiredError. Publish inside a @RelayBusTransaction() method ' +\n        'or a bus.transaction(...) callback, or pass { transaction }.',\n    },\n  },\n  create(context) {\n    const [options = {}] = context.options as [Options?];\n    const publishers = new RegExp(options.publishers ?? DEFAULT_PUBLISHERS);\n    const tracker = new TransactionTracker(context.sourceCode);\n    const publishes: (Rule.Node & ESTree.CallExpression)[] = [];\n    return {\n      CallExpression: (node) => {\n        tracker.record(node);\n        const { callee } = node;\n        if (\n          callee.type === 'MemberExpression' &&\n          PUBLISH_METHODS.has(memberName(callee) ?? '') &&\n          publishers.test(lastName(callee.object) ?? '')\n        ) {\n          publishes.push(node);\n        }\n      },\n      'Program:exit': () => {\n        for (const call of publishes) {\n          if (!passesTransaction(call) && !tracker.isInTransaction(call)) {\n            context.report({\n              node: call,\n              messageId: 'noTransaction',\n              data: { call: `${context.sourceCode.getText(call.callee)}()` },\n            });\n          }\n        }\n      },\n    };\n  },\n};\n","import type { ESLint, Linter, Rule } from 'eslint';\nimport { noExternalCallInTransaction } from './rules/no-external-call-in-transaction.js';\nimport { publishRequiresTransaction } from './rules/publish-requires-transaction.js';\n\nexport const rules: Readonly<Record<string, Rule.RuleModule>> = {\n  'no-external-call-in-transaction': noExternalCallInTransaction,\n  'publish-requires-transaction': publishRequiresTransaction,\n};\n\nconst plugin = { meta: { name: '@relaybus/eslint-plugin' }, rules } satisfies ESLint.Plugin;\n\n/**\n * Both rules at error level, under the plugin name `@relaybus`:\n *\n * ```js\n * // eslint.config.js\n * import relaybus from '@relaybus/eslint-plugin';\n * export default [relaybus.configs.recommended];\n * ```\n */\nexport const configs: { readonly recommended: Linter.Config } = {\n  recommended: {\n    name: '@relaybus/recommended',\n    plugins: { '@relaybus': plugin },\n    rules: {\n      '@relaybus/no-external-call-in-transaction': 'error',\n      '@relaybus/publish-requires-transaction': 'error',\n    },\n  },\n};\n\nconst relaybus: ESLint.Plugin & { readonly configs: typeof configs } = { ...plugin, configs };\n\nexport default relaybus;\n"]}

package/dist/index.d.cts

@@ -0,0 +1,20 @@
+import { Linter, ESLint, Rule } from 'eslint';
+
+declare const rules: Readonly<Record<string, Rule.RuleModule>>;
+/**
+ * Both rules at error level, under the plugin name `@relaybus`:
+ *
+ * ```js
+ * // eslint.config.js
+ * import relaybus from '@relaybus/eslint-plugin';
+ * export default [relaybus.configs.recommended];
+ * ```
+ */
+declare const configs: {
+    readonly recommended: Linter.Config;
+};
+declare const relaybus: ESLint.Plugin & {
+    readonly configs: typeof configs;
+};
+
+export { configs, relaybus as default, rules };

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+import { Linter, ESLint, Rule } from 'eslint';
+
+declare const rules: Readonly<Record<string, Rule.RuleModule>>;
+/**
+ * Both rules at error level, under the plugin name `@relaybus`:
+ *
+ * ```js
+ * // eslint.config.js
+ * import relaybus from '@relaybus/eslint-plugin';
+ * export default [relaybus.configs.recommended];
+ * ```
+ */
+declare const configs: {
+    readonly recommended: Linter.Config;
+};
+declare const relaybus: ESLint.Plugin & {
+    readonly configs: typeof configs;
+};
+
+export { configs, relaybus as default, rules };

package/dist/index.js

@@ -0,0 +1,336 @@
+// src/ast.ts
+var FUNCTION_TYPES = /* @__PURE__ */ new Set([
+  "FunctionExpression",
+  "ArrowFunctionExpression",
+  "FunctionDeclaration"
+]);
+function isFunction(node) {
+  return FUNCTION_TYPES.has(node.type);
+}
+function findDecorator(node, names) {
+  for (const { expression } of node.decorators ?? []) {
+    if (expression.type === "CallExpression" && expression.callee.type === "Identifier" && names.has(expression.callee.name)) {
+      return expression;
+    }
+  }
+  return void 0;
+}
+function hasTransactionalOption(call) {
+  return call.arguments.some(
+    (argument) => argument.type === "ObjectExpression" && argument.properties.some(
+      (property) => property.type === "Property" && definitionName(property) === "transactional" && property.value.type === "Literal" && property.value.value === true
+    )
+  );
+}
+function keyName(key) {
+  if (key.type === "Identifier") {
+    return key.name;
+  }
+  if (key.type === "PrivateIdentifier") {
+    return `#${key.name}`;
+  }
+  return key.type === "Literal" && typeof key.value === "string" ? key.value : void 0;
+}
+function memberName(member) {
+  return staticName(member.computed, member.property);
+}
+function definitionName(definition) {
+  return staticName(definition.computed, definition.key);
+}
+function staticName(computed, key) {
+  return computed && key.type !== "Literal" ? void 0 : keyName(key);
+}
+function lastName(node) {
+  if (node.type === "Identifier") {
+    return node.name;
+  }
+  return node.type === "MemberExpression" ? memberName(node) : void 0;
+}
+
+// src/external-calls.ts
+var MODULES = {
+  axios: "axios",
+  got: "got",
+  http: "http",
+  "node:http": "http",
+  https: "http",
+  "node:https": "http",
+  undici: "undici"
+};
+var REQUEST_MEMBERS = {
+  axios: void 0,
+  got: void 0,
+  http: /* @__PURE__ */ new Set(["request", "get"]),
+  undici: /* @__PURE__ */ new Set(["request", "fetch", "stream", "pipeline"])
+};
+var HTTP_SERVICE_NAME = /^(?:http|httpService|axiosRef)$/i;
+var ExternalCallDetector = class {
+  /** Local names of imported HTTP client modules. */
+  #modules = /* @__PURE__ */ new Map([
+    ["axios", "axios"],
+    ["got", "got"]
+  ]);
+  /** Local names of imported request functions, such as `request` from `undici`. */
+  #functions = /* @__PURE__ */ new Set(["fetch"]);
+  /** Records `import x from 'axios'`, `import * as https from 'node:https'`, `import { request } from 'undici'`. */
+  recordImport(declaration) {
+    const module = MODULES[String(declaration.source.value)];
+    if (module === void 0) {
+      return;
+    }
+    for (const specifier of declaration.specifiers) {
+      if (specifier.type !== "ImportSpecifier") {
+        this.#modules.set(specifier.local.name, module);
+      } else if (REQUEST_MEMBERS[module]?.has(importedName(specifier)) === true) {
+        this.#functions.add(specifier.local.name);
+      }
+    }
+  }
+  /** Records `const axios = require('axios')`. */
+  recordRequire(declarator) {
+    const { id, init } = declarator;
+    if (id.type === "Identifier" && init?.type === "CallExpression" && lastName(init.callee) === "require" && init.arguments[0]?.type === "Literal") {
+      const module = MODULES[String(init.arguments[0].value)];
+      if (module !== void 0) {
+        this.#modules.set(id.name, module);
+      }
+    }
+  }
+  /** Whether `call` sends a request to another service. */
+  isExternalCall(call) {
+    const { callee } = call;
+    if (callee.type === "Identifier") {
+      const module = this.#modules.get(callee.name);
+      return this.#functions.has(callee.name) || module === "axios" || module === "got";
+    }
+    return callee.type === "MemberExpression" && this.#isClientMember(callee);
+  }
+  /** `axios.post`, `https.request`, `this.httpService.get`, `httpService.axiosRef.get`. */
+  #isClientMember(callee) {
+    if (HTTP_SERVICE_NAME.test(lastName(callee.object) ?? "")) {
+      return true;
+    }
+    const module = callee.object.type === "Identifier" ? this.#modules.get(callee.object.name) : void 0;
+    if (module === void 0) {
+      return false;
+    }
+    return REQUEST_MEMBERS[module]?.has(memberName(callee) ?? "") ?? true;
+  }
+};
+function importedName(specifier) {
+  const { imported } = specifier;
+  return imported.type === "Identifier" ? imported.name : String(imported.value);
+}
+
+// src/transaction-scopes.ts
+var TRANSACTION_METHODS = /* @__PURE__ */ new Set(["transaction", "$transaction", "withTransaction"]);
+var TRANSACTION_DECORATORS = /* @__PURE__ */ new Set(["RelayBusTransaction"]);
+var CONSUMER_DECORATORS = /* @__PURE__ */ new Set(["RelayBusConsumer", "Subscribe"]);
+var CATALOG_CONSUMER_DECORATORS = /* @__PURE__ */ new Set(["RelayBusCatalogConsumer", "EventConsumer"]);
+var CATALOG_HANDLER_NAME = /^on[A-Z]/;
+function isTransactionalMethod(method) {
+  if (findDecorator(method, TRANSACTION_DECORATORS) !== void 0) {
+    return true;
+  }
+  const consumer = findDecorator(method, CONSUMER_DECORATORS);
+  if (consumer !== void 0 && hasTransactionalOption(consumer)) {
+    return true;
+  }
+  const catalogConsumer = findDecorator(method.parent.parent, CATALOG_CONSUMER_DECORATORS);
+  return catalogConsumer !== void 0 && hasTransactionalOption(catalogConsumer) && CATALOG_HANDLER_NAME.test(definitionName(method) ?? "");
+}
+function isTransactionScope(fn) {
+  const parent = fn.parent;
+  if (parent.type === "MethodDefinition") {
+    return isTransactionalMethod(parent);
+  }
+  if (parent.type !== "CallExpression" || parent.callee.type !== "MemberExpression") {
+    return false;
+  }
+  const method = memberName(parent.callee);
+  if (TRANSACTION_METHODS.has(method ?? "")) {
+    return parent.arguments[0] === fn;
+  }
+  return method === "subscribe" && parent.arguments[1] === fn && hasTransactionalOption(parent);
+}
+
+// src/transaction-tracker.ts
+var TransactionTracker = class {
+  #sourceCode;
+  #thisCalls = [];
+  #transactional = /* @__PURE__ */ new Map();
+  constructor(sourceCode) {
+    this.#sourceCode = sourceCode;
+  }
+  record(call) {
+    const { callee } = call;
+    if (callee.type !== "MemberExpression" || callee.object.type !== "ThisExpression") {
+      return;
+    }
+    const method = memberName(callee);
+    const classBody = this.#ancestors(call).findLast((ancestor) => ancestor.type === "ClassBody");
+    if (method !== void 0 && classBody !== void 0) {
+      this.#thisCalls.push({ node: call, method, classBody });
+    }
+  }
+  isInTransaction(node) {
+    return this.#isInTransaction(node, (classBody) => this.#transactionalMethods(classBody));
+  }
+  #isInTransaction(node, methodsOf) {
+    for (const ancestor of this.#ancestors(node).reverse()) {
+      if (isFunction(ancestor) && isTransactionScope(ancestor)) {
+        return true;
+      }
+      if (ancestor.type === "MethodDefinition") {
+        return methodsOf(ancestor.parent).has(definitionName(ancestor) ?? "");
+      }
+    }
+    return false;
+  }
+  #ancestors(node) {
+    return this.#sourceCode.getAncestors(node);
+  }
+  /** Methods of a class that run in a transaction, directly or through `this.method()` calls. */
+  #transactionalMethods(classBody) {
+    const known = this.#transactional.get(classBody);
+    if (known !== void 0) {
+      return known;
+    }
+    const methods = new Set(
+      classBody.body.filter((member) => member.type === "MethodDefinition").filter((member) => isTransactionalMethod(member)).map((member) => definitionName(member) ?? "")
+    );
+    const calls = this.#thisCalls.filter((call) => call.classBody === classBody);
+    for (let grew = true; grew; ) {
+      const added = calls.filter(
+        (call) => !methods.has(call.method) && this.#isInTransaction(call.node, () => methods)
+      );
+      added.forEach((call) => methods.add(call.method));
+      grew = added.length > 0;
+    }
+    this.#transactional.set(classBody, methods);
+    return methods;
+  }
+};
+
+// src/rules/no-external-call-in-transaction.ts
+var noExternalCallInTransaction = {
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Disallow calls to other services inside a database transaction",
+      url: "https://berkcansavur.github.io/relaybus/recipes/transactions-in-nestjs"
+    },
+    schema: [],
+    messages: {
+      externalCall: "{{call}} calls another service inside a transaction. The transaction keeps its row locks and its database connection until the call returns, and relaybus rolls it back with TransactionTimeoutError once it outlives transactionTimeout. Make the call before the transaction starts or after it commits (for example from the handler of an event you publish)."
+    }
+  },
+  create(context) {
+    const tracker = new TransactionTracker(context.sourceCode);
+    const detector = new ExternalCallDetector();
+    const calls = [];
+    return {
+      ImportDeclaration: (node) => detector.recordImport(node),
+      VariableDeclarator: (node) => detector.recordRequire(node),
+      CallExpression: (node) => {
+        tracker.record(node);
+        calls.push(node);
+      },
+      "Program:exit": () => {
+        for (const call of calls) {
+          if (detector.isExternalCall(call) && tracker.isInTransaction(call)) {
+            context.report({
+              node: call,
+              messageId: "externalCall",
+              data: { call: `${context.sourceCode.getText(call.callee)}()` }
+            });
+          }
+        }
+      }
+    };
+  }
+};
+
+// src/rules/publish-requires-transaction.ts
+var PUBLISH_METHODS = /* @__PURE__ */ new Set(["publish", "publishAll"]);
+var DEFAULT_PUBLISHERS = "(?:^|[a-z_$])(?:[Bb]us|[Pp]ublisher)$|^(?:bus|publisher)$";
+function passesTransaction(call) {
+  const options = call.arguments[1];
+  if (options === void 0) {
+    return false;
+  }
+  if (options.type !== "ObjectExpression") {
+    return true;
+  }
+  return options.properties.some(
+    (property) => property.type === "SpreadElement" || definitionName(property) === "transaction"
+  );
+}
+var publishRequiresTransaction = {
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Require relaybus publish calls to run inside a transaction",
+      url: "https://berkcansavur.github.io/relaybus/recipes/transactions-in-nestjs"
+    },
+    schema: [
+      {
+        type: "object",
+        properties: { publishers: { type: "string" } },
+        additionalProperties: false
+      }
+    ],
+    messages: {
+      noTransaction: "{{call}} runs outside a transaction, so the event is not atomic with your writes and relaybus throws TransactionRequiredError. Publish inside a @RelayBusTransaction() method or a bus.transaction(...) callback, or pass { transaction }."
+    }
+  },
+  create(context) {
+    const [options = {}] = context.options;
+    const publishers = new RegExp(options.publishers ?? DEFAULT_PUBLISHERS);
+    const tracker = new TransactionTracker(context.sourceCode);
+    const publishes = [];
+    return {
+      CallExpression: (node) => {
+        tracker.record(node);
+        const { callee } = node;
+        if (callee.type === "MemberExpression" && PUBLISH_METHODS.has(memberName(callee) ?? "") && publishers.test(lastName(callee.object) ?? "")) {
+          publishes.push(node);
+        }
+      },
+      "Program:exit": () => {
+        for (const call of publishes) {
+          if (!passesTransaction(call) && !tracker.isInTransaction(call)) {
+            context.report({
+              node: call,
+              messageId: "noTransaction",
+              data: { call: `${context.sourceCode.getText(call.callee)}()` }
+            });
+          }
+        }
+      }
+    };
+  }
+};
+
+// src/index.ts
+var rules = {
+  "no-external-call-in-transaction": noExternalCallInTransaction,
+  "publish-requires-transaction": publishRequiresTransaction
+};
+var plugin = { meta: { name: "@relaybus/eslint-plugin" }, rules };
+var configs = {
+  recommended: {
+    name: "@relaybus/recommended",
+    plugins: { "@relaybus": plugin },
+    rules: {
+      "@relaybus/no-external-call-in-transaction": "error",
+      "@relaybus/publish-requires-transaction": "error"
+    }
+  }
+};
+var relaybus = { ...plugin, configs };
+var index_default = relaybus;
+
+export { configs, index_default as default, rules };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ast.ts","../src/external-calls.ts","../src/transaction-scopes.ts","../src/transaction-tracker.ts","../src/rules/no-external-call-in-transaction.ts","../src/rules/publish-requires-transaction.ts","../src/index.ts"],"names":[],"mappings":";AAUA,IAAM,cAAA,uBAAqB,GAAA,CAAI;AAAA,EAC7B,oBAAA;AAAA,EACA,yBAAA;AAAA,EACA;AACF,CAAC,CAAA;AAEM,SAAS,WAAW,IAAA,EAAuC;AAChE,EAAA,OAAO,cAAA,CAAe,GAAA,CAAI,IAAA,CAAK,IAAI,CAAA;AACrC;AAGO,SAAS,aAAA,CACd,MACA,KAAA,EACmC;AACnC,EAAA,KAAA,MAAW,EAAE,UAAA,EAAW,IAAM,IAAA,CAAmB,UAAA,IAAc,EAAC,EAAG;AACjE,IAAA,IACE,UAAA,CAAW,IAAA,KAAS,gBAAA,IACpB,UAAA,CAAW,MAAA,CAAO,IAAA,KAAS,YAAA,IAC3B,KAAA,CAAM,GAAA,CAAI,UAAA,CAAW,MAAA,CAAO,IAAI,CAAA,EAChC;AACA,MAAA,OAAO,UAAA;AAAA,IACT;AAAA,EACF;AACA,EAAA,OAAO,MAAA;AACT;AAGO,SAAS,uBAAuB,IAAA,EAAsC;AAC3E,EAAA,OAAO,KAAK,SAAA,CAAU,IAAA;AAAA,IACpB,CAAC,QAAA,KACC,QAAA,CAAS,IAAA,KAAS,kBAAA,IAClB,SAAS,UAAA,CAAW,IAAA;AAAA,MAClB,CAAC,QAAA,KACC,QAAA,CAAS,IAAA,KAAS,cAClB,cAAA,CAAe,QAAQ,CAAA,KAAM,eAAA,IAC7B,SAAS,KAAA,CAAM,IAAA,KAAS,SAAA,IACxB,QAAA,CAAS,MAAM,KAAA,KAAU;AAAA;AAC7B,GACJ;AACF;AAMO,SAAS,QAAQ,GAAA,EAAsC;AAC5D,EAAA,IAAI,GAAA,CAAI,SAAS,YAAA,EAAc;AAC7B,IAAA,OAAO,GAAA,CAAI,IAAA;AAAA,EACb;AACA,EAAA,IAAI,GAAA,CAAI,SAAS,mBAAA,EAAqB;AACpC,IAAA,OAAO,CAAA,CAAA,EAAI,IAAI,IAAI,CAAA,CAAA;AAAA,EACrB;AACA,EAAA,OAAO,GAAA,CAAI,SAAS,SAAA,IAAa,OAAO,IAAI,KAAA,KAAU,QAAA,GAAW,IAAI,KAAA,GAAQ,MAAA;AAC/E;AAGO,SAAS,WAAW,MAAA,EAAqD;AAC9E,EAAA,OAAO,UAAA,CAAW,MAAA,CAAO,QAAA,EAAU,MAAA,CAAO,QAAQ,CAAA;AACpD;AAGO,SAAS,eACd,UAAA,EACoB;AACpB,EAAA,OAAO,UAAA,CAAW,UAAA,CAAW,QAAA,EAAU,UAAA,CAAW,GAAG,CAAA;AACvD;AAEA,SAAS,UAAA,CAAW,UAAmB,GAAA,EAAsC;AAC3E,EAAA,OAAO,YAAY,GAAA,CAAI,IAAA,KAAS,SAAA,GAAY,MAAA,GAAY,QAAQ,GAAG,CAAA;AACrE;AAGO,SAAS,SAAS,IAAA,EAAuC;AAC9D,EAAA,IAAI,IAAA,CAAK,SAAS,YAAA,EAAc;AAC9B,IAAA,OAAO,IAAA,CAAK,IAAA;AAAA,EACd;AACA,EAAA,OAAO,IAAA,CAAK,IAAA,KAAS,kBAAA,GAAqB,UAAA,CAAW,IAAI,CAAA,GAAI,MAAA;AAC/D;;;ACjFA,IAAM,OAAA,GAAkD;AAAA,EACtD,KAAA,EAAO,OAAA;AAAA,EACP,GAAA,EAAK,KAAA;AAAA,EACL,IAAA,EAAM,MAAA;AAAA,EACN,WAAA,EAAa,MAAA;AAAA,EACb,KAAA,EAAO,MAAA;AAAA,EACP,YAAA,EAAc,MAAA;AAAA,EACd,MAAA,EAAQ;AACV,CAAA;AAGA,IAAM,eAAA,GAAmF;AAAA,EACvF,KAAA,EAAO,MAAA;AAAA,EACP,GAAA,EAAK,MAAA;AAAA,EACL,sBAAM,IAAI,GAAA,CAAI,CAAC,SAAA,EAAW,KAAK,CAAC,CAAA;AAAA,EAChC,MAAA,sBAAY,GAAA,CAAI,CAAC,WAAW,OAAA,EAAS,QAAA,EAAU,UAAU,CAAC;AAC5D,CAAA;AAGA,IAAM,iBAAA,GAAoB,kCAAA;AAOnB,IAAM,uBAAN,MAA2B;AAAA;AAAA,EAEvB,QAAA,uBAAe,GAAA,CAA0B;AAAA,IAChD,CAAC,SAAS,OAAO,CAAA;AAAA,IACjB,CAAC,OAAO,KAAK;AAAA,GACd,CAAA;AAAA;AAAA,EAEQ,UAAA,mBAAa,IAAI,GAAA,CAAY,CAAC,OAAO,CAAC,CAAA;AAAA;AAAA,EAG/C,aAAa,WAAA,EAA6C;AACxD,IAAA,MAAM,SAAS,OAAA,CAAQ,MAAA,CAAO,WAAA,CAAY,MAAA,CAAO,KAAK,CAAC,CAAA;AACvD,IAAA,IAAI,WAAW,MAAA,EAAW;AACxB,MAAA;AAAA,IACF;AACA,IAAA,KAAA,MAAW,SAAA,IAAa,YAAY,UAAA,EAAY;AAC9C,MAAA,IAAI,SAAA,CAAU,SAAS,iBAAA,EAAmB;AACxC,QAAA,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,SAAA,CAAU,KAAA,CAAM,MAAM,MAAM,CAAA;AAAA,MAChD,CAAA,MAAA,IAAW,gBAAgB,MAAM,CAAA,EAAG,IAAI,YAAA,CAAa,SAAS,CAAC,CAAA,KAAM,IAAA,EAAM;AACzE,QAAA,IAAA,CAAK,UAAA,CAAW,GAAA,CAAI,SAAA,CAAU,KAAA,CAAM,IAAI,CAAA;AAAA,MAC1C;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,cAAc,UAAA,EAA6C;AACzD,IAAA,MAAM,EAAE,EAAA,EAAI,IAAA,EAAK,GAAI,UAAA;AACrB,IAAA,IACE,GAAG,IAAA,KAAS,YAAA,IACZ,IAAA,EAAM,IAAA,KAAS,oBACf,QAAA,CAAS,IAAA,CAAK,MAAM,CAAA,KAAM,aAC1B,IAAA,CAAK,SAAA,CAAU,CAAC,CAAA,EAAG,SAAS,SAAA,EAC5B;AACA,MAAA,MAAM,MAAA,GAAS,QAAQ,MAAA,CAAO,IAAA,CAAK,UAAU,CAAC,CAAA,CAAE,KAAK,CAAC,CAAA;AACtD,MAAA,IAAI,WAAW,MAAA,EAAW;AACxB,QAAA,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,EAAA,CAAG,IAAA,EAAM,MAAM,CAAA;AAAA,MACnC;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,eAAe,IAAA,EAAkD;AAC/D,IAAA,MAAM,EAAE,QAAO,GAAI,IAAA;AACnB,IAAA,IAAI,MAAA,CAAO,SAAS,YAAA,EAAc;AAChC,MAAA,MAAM,MAAA,GAAS,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,OAAO,IAAI,CAAA;AAC5C,MAAA,OAAO,IAAA,CAAK,WAAW,GAAA,CAAI,MAAA,CAAO,IAAI,CAAA,IAAK,MAAA,KAAW,WAAW,MAAA,KAAW,KAAA;AAAA,IAC9E;AACA,IAAA,OAAO,MAAA,CAAO,IAAA,KAAS,kBAAA,IAAsB,IAAA,CAAK,gBAAgB,MAAM,CAAA;AAAA,EAC1E;AAAA;AAAA,EAGA,gBAAgB,MAAA,EAA0C;AACxD,IAAA,IAAI,kBAAkB,IAAA,CAAK,QAAA,CAAS,OAAO,MAAM,CAAA,IAAK,EAAE,CAAA,EAAG;AACzD,MAAA,OAAO,IAAA;AAAA,IACT;AACA,IAAA,MAAM,MAAA,GACJ,MAAA,CAAO,MAAA,CAAO,IAAA,KAAS,YAAA,GAAe,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,MAAA,CAAO,MAAA,CAAO,IAAI,CAAA,GAAI,MAAA;AAChF,IAAA,IAAI,WAAW,MAAA,EAAW;AACxB,MAAA,OAAO,KAAA;AAAA,IACT;AACA,IAAA,OAAO,eAAA,CAAgB,MAAM,CAAA,EAAG,GAAA,CAAI,WAAW,MAAM,CAAA,IAAK,EAAE,CAAA,IAAK,IAAA;AAAA,EACnE;AACF,CAAA;AAGA,SAAS,aAAa,SAAA,EAA2C;AAC/D,EAAA,MAAM,EAAE,UAAS,GAAI,SAAA;AACrB,EAAA,OAAO,SAAS,IAAA,KAAS,YAAA,GAAe,SAAS,IAAA,GAAO,MAAA,CAAO,SAAS,KAAK,CAAA;AAC/E;;;AC1FA,IAAM,sCAAsB,IAAI,GAAA,CAAI,CAAC,aAAA,EAAe,cAAA,EAAgB,iBAAiB,CAAC,CAAA;AACtF,IAAM,sBAAA,mBAAyB,IAAI,GAAA,CAAI,CAAC,qBAAqB,CAAC,CAAA;AAE9D,IAAM,sCAAsB,IAAI,GAAA,CAAI,CAAC,kBAAA,EAAoB,WAAW,CAAC,CAAA;AAErE,IAAM,8CAA8B,IAAI,GAAA,CAAI,CAAC,yBAAA,EAA2B,eAAe,CAAC,CAAA;AACxF,IAAM,oBAAA,GAAuB,UAAA;AAOtB,SAAS,sBAAsB,MAAA,EAAsD;AAC1F,EAAA,IAAI,aAAA,CAAc,MAAA,EAAQ,sBAAsB,CAAA,KAAM,MAAA,EAAW;AAC/D,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,MAAM,QAAA,GAAW,aAAA,CAAc,MAAA,EAAQ,mBAAmB,CAAA;AAC1D,EAAA,IAAI,QAAA,KAAa,MAAA,IAAa,sBAAA,CAAuB,QAAQ,CAAA,EAAG;AAC9D,IAAA,OAAO,IAAA;AAAA,EACT;AAEA,EAAA,MAAM,eAAA,GAAkB,aAAA,CAAc,MAAA,CAAO,MAAA,CAAO,QAAS,2BAA2B,CAAA;AACxF,EAAA,OACE,eAAA,KAAoB,MAAA,IACpB,sBAAA,CAAuB,eAAe,CAAA,IACtC,qBAAqB,IAAA,CAAK,cAAA,CAAe,MAAM,CAAA,IAAK,EAAE,CAAA;AAE1D;AAOO,SAAS,mBAAmB,EAAA,EAA2B;AAC5D,EAAA,MAAM,SAAS,EAAA,CAAG,MAAA;AAClB,EAAA,IAAI,MAAA,CAAO,SAAS,kBAAA,EAAoB;AACtC,IAAA,OAAO,sBAAsB,MAAM,CAAA;AAAA,EACrC;AACA,EAAA,IAAI,OAAO,IAAA,KAAS,gBAAA,IAAoB,MAAA,CAAO,MAAA,CAAO,SAAS,kBAAA,EAAoB;AACjF,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,MAAM,MAAA,GAAS,UAAA,CAAW,MAAA,CAAO,MAAM,CAAA;AACvC,EAAA,IAAI,mBAAA,CAAoB,GAAA,CAAI,MAAA,IAAU,EAAE,CAAA,EAAG;AACzC,IAAA,OAAO,MAAA,CAAO,SAAA,CAAU,CAAC,CAAA,KAAM,EAAA;AAAA,EACjC;AACA,EAAA,OAAO,MAAA,KAAW,eAAe,MAAA,CAAO,SAAA,CAAU,CAAC,CAAA,KAAM,EAAA,IAAM,uBAAuB,MAAM,CAAA;AAC9F;;;ACzCO,IAAM,qBAAN,MAAyB;AAAA,EACrB,WAAA;AAAA,EACA,aAAyB,EAAC;AAAA,EAC1B,cAAA,uBAAqB,GAAA,EAA4B;AAAA,EAE1D,YAAY,UAAA,EAAwB;AAClC,IAAA,IAAA,CAAK,WAAA,GAAc,UAAA;AAAA,EACrB;AAAA,EAEA,OAAO,IAAA,EAA+C;AACpD,IAAA,MAAM,EAAE,QAAO,GAAI,IAAA;AACnB,IAAA,IAAI,OAAO,IAAA,KAAS,kBAAA,IAAsB,MAAA,CAAO,MAAA,CAAO,SAAS,gBAAA,EAAkB;AACjF,MAAA;AAAA,IACF;AACA,IAAA,MAAM,MAAA,GAAS,WAAW,MAAM,CAAA;AAChC,IAAA,MAAM,SAAA,GAAY,IAAA,CAAK,UAAA,CAAW,IAAI,CAAA,CAAE,SAAS,CAAC,QAAA,KAAa,QAAA,CAAS,IAAA,KAAS,WAAW,CAAA;AAC5F,IAAA,IAAI,MAAA,KAAW,MAAA,IAAa,SAAA,KAAc,MAAA,EAAW;AACnD,MAAA,IAAA,CAAK,WAAW,IAAA,CAAK,EAAE,MAAM,IAAA,EAAM,MAAA,EAAQ,WAAW,CAAA;AAAA,IACxD;AAAA,EACF;AAAA,EAEA,gBAAgB,IAAA,EAA0B;AACxC,IAAA,OAAO,IAAA,CAAK,iBAAiB,IAAA,EAAM,CAAC,cAAc,IAAA,CAAK,qBAAA,CAAsB,SAAS,CAAC,CAAA;AAAA,EACzF;AAAA,EAEA,gBAAA,CAAiB,MAAiB,SAAA,EAA2D;AAC3F,IAAA,KAAA,MAAW,YAAY,IAAA,CAAK,UAAA,CAAW,IAAI,CAAA,CAAE,SAAQ,EAAG;AACtD,MAAA,IAAI,UAAA,CAAW,QAAQ,CAAA,IAAK,kBAAA,CAAmB,QAAQ,CAAA,EAAG;AACxD,QAAA,OAAO,IAAA;AAAA,MACT;AACA,MAAA,IAAI,QAAA,CAAS,SAAS,kBAAA,EAAoB;AACxC,QAAA,OAAO,SAAA,CAAU,SAAS,MAAM,CAAA,CAAE,IAAI,cAAA,CAAe,QAAQ,KAAK,EAAE,CAAA;AAAA,MACtE;AAAA,IACF;AACA,IAAA,OAAO,KAAA;AAAA,EACT;AAAA,EAEA,WAAW,IAAA,EAA8B;AACvC,IAAA,OAAO,IAAA,CAAK,WAAA,CAAY,YAAA,CAAa,IAAI,CAAA;AAAA,EAC3C;AAAA;AAAA,EAGA,sBAAsB,SAAA,EAAmC;AACvD,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,cAAA,CAAe,GAAA,CAAI,SAAS,CAAA;AAC/C,IAAA,IAAI,UAAU,MAAA,EAAW;AACvB,MAAA,OAAO,KAAA;AAAA,IACT;AACA,IAAA,MAAM,UAAU,IAAI,GAAA;AAAA,MACjB,SAAA,CAA2C,KACzC,MAAA,CAAO,CAAC,WAAW,MAAA,CAAO,IAAA,KAAS,kBAAkB,CAAA,CACrD,MAAA,CAAO,CAAC,WAAW,qBAAA,CAAsB,MAA6C,CAAC,CAAA,CACvF,GAAA,CAAI,CAAC,MAAA,KAAW,cAAA,CAAe,MAAM,CAAA,IAAK,EAAE;AAAA,KACjD;AACA,IAAA,MAAM,KAAA,GAAQ,KAAK,UAAA,CAAW,MAAA,CAAO,CAAC,IAAA,KAAS,IAAA,CAAK,cAAc,SAAS,CAAA;AAC3E,IAAA,KAAA,IAAS,IAAA,GAAO,MAAM,IAAA,IAAO;AAC3B,MAAA,MAAM,QAAQ,KAAA,CAAM,MAAA;AAAA,QAClB,CAAC,IAAA,KAAS,CAAC,OAAA,CAAQ,GAAA,CAAI,IAAA,CAAK,MAAM,CAAA,IAAK,IAAA,CAAK,gBAAA,CAAiB,IAAA,CAAK,IAAA,EAAM,MAAM,OAAO;AAAA,OACvF;AACA,MAAA,KAAA,CAAM,QAAQ,CAAC,IAAA,KAAS,QAAQ,GAAA,CAAI,IAAA,CAAK,MAAM,CAAC,CAAA;AAChD,MAAA,IAAA,GAAO,MAAM,MAAA,GAAS,CAAA;AAAA,IACxB;AACA,IAAA,IAAA,CAAK,cAAA,CAAe,GAAA,CAAI,SAAA,EAAW,OAAO,CAAA;AAC1C,IAAA,OAAO,OAAA;AAAA,EACT;AACF,CAAA;;;ACxEO,IAAM,2BAAA,GAA+C;AAAA,EAC1D,IAAA,EAAM;AAAA,IACJ,IAAA,EAAM,SAAA;AAAA,IACN,IAAA,EAAM;AAAA,MACJ,WAAA,EAAa,gEAAA;AAAA,MACb,GAAA,EAAK;AAAA,KACP;AAAA,IACA,QAAQ,EAAC;AAAA,IACT,QAAA,EAAU;AAAA,MACR,YAAA,EACE;AAAA;AAIJ,GACF;AAAA,EACA,OAAO,OAAA,EAAS;AACd,IAAA,MAAM,OAAA,GAAU,IAAI,kBAAA,CAAmB,OAAA,CAAQ,UAAU,CAAA;AACzD,IAAA,MAAM,QAAA,GAAW,IAAI,oBAAA,EAAqB;AAC1C,IAAA,MAAM,QAA+C,EAAC;AACtD,IAAA,OAAO;AAAA,MACL,iBAAA,EAAmB,CAAC,IAAA,KAAS,QAAA,CAAS,aAAa,IAAI,CAAA;AAAA,MACvD,kBAAA,EAAoB,CAAC,IAAA,KAAS,QAAA,CAAS,cAAc,IAAI,CAAA;AAAA,MACzD,cAAA,EAAgB,CAAC,IAAA,KAAS;AACxB,QAAA,OAAA,CAAQ,OAAO,IAAI,CAAA;AACnB,QAAA,KAAA,CAAM,KAAK,IAAI,CAAA;AAAA,MACjB,CAAA;AAAA,MACA,gBAAgB,MAAM;AACpB,QAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,UAAA,IAAI,SAAS,cAAA,CAAe,IAAI,KAAK,OAAA,CAAQ,eAAA,CAAgB,IAAI,CAAA,EAAG;AAClE,YAAA,OAAA,CAAQ,MAAA,CAAO;AAAA,cACb,IAAA,EAAM,IAAA;AAAA,cACN,SAAA,EAAW,cAAA;AAAA,cACX,IAAA,EAAM,EAAE,IAAA,EAAM,CAAA,EAAG,OAAA,CAAQ,WAAW,OAAA,CAAQ,IAAA,CAAK,MAAM,CAAC,CAAA,EAAA,CAAA;AAAK,aAC9D,CAAA;AAAA,UACH;AAAA,QACF;AAAA,MACF;AAAA,KACF;AAAA,EACF;AACF,CAAA;;;AC7CA,IAAM,kCAAkB,IAAI,GAAA,CAAI,CAAC,SAAA,EAAW,YAAY,CAAC,CAAA;AAEzD,IAAM,kBAAA,GAAqB,2DAAA;AAQ3B,SAAS,kBAAkB,IAAA,EAAsC;AAC/D,EAAA,MAAM,OAAA,GAAU,IAAA,CAAK,SAAA,CAAU,CAAC,CAAA;AAChC,EAAA,IAAI,YAAY,MAAA,EAAW;AACzB,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,IAAI,OAAA,CAAQ,SAAS,kBAAA,EAAoB;AACvC,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,OAAO,QAAQ,UAAA,CAAW,IAAA;AAAA,IACxB,CAAC,QAAA,KAAa,QAAA,CAAS,SAAS,eAAA,IAAmB,cAAA,CAAe,QAAQ,CAAA,KAAM;AAAA,GAClF;AACF;AAOO,IAAM,0BAAA,GAA8C;AAAA,EACzD,IAAA,EAAM;AAAA,IACJ,IAAA,EAAM,SAAA;AAAA,IACN,IAAA,EAAM;AAAA,MACJ,WAAA,EAAa,4DAAA;AAAA,MACb,GAAA,EAAK;AAAA,KACP;AAAA,IACA,MAAA,EAAQ;AAAA,MACN;AAAA,QACE,IAAA,EAAM,QAAA;AAAA,QACN,YAAY,EAAE,UAAA,EAAY,EAAE,IAAA,EAAM,UAAS,EAAE;AAAA,QAC7C,oBAAA,EAAsB;AAAA;AACxB,KACF;AAAA,IACA,QAAA,EAAU;AAAA,MACR,aAAA,EACE;AAAA;AAGJ,GACF;AAAA,EACA,OAAO,OAAA,EAAS;AACd,IAAA,MAAM,CAAC,OAAA,GAAU,EAAE,IAAI,OAAA,CAAQ,OAAA;AAC/B,IAAA,MAAM,UAAA,GAAa,IAAI,MAAA,CAAO,OAAA,CAAQ,cAAc,kBAAkB,CAAA;AACtE,IAAA,MAAM,OAAA,GAAU,IAAI,kBAAA,CAAmB,OAAA,CAAQ,UAAU,CAAA;AACzD,IAAA,MAAM,YAAmD,EAAC;AAC1D,IAAA,OAAO;AAAA,MACL,cAAA,EAAgB,CAAC,IAAA,KAAS;AACxB,QAAA,OAAA,CAAQ,OAAO,IAAI,CAAA;AACnB,QAAA,MAAM,EAAE,QAAO,GAAI,IAAA;AACnB,QAAA,IACE,OAAO,IAAA,KAAS,kBAAA,IAChB,eAAA,CAAgB,GAAA,CAAI,WAAW,MAAM,CAAA,IAAK,EAAE,CAAA,IAC5C,WAAW,IAAA,CAAK,QAAA,CAAS,OAAO,MAAM,CAAA,IAAK,EAAE,CAAA,EAC7C;AACA,UAAA,SAAA,CAAU,KAAK,IAAI,CAAA;AAAA,QACrB;AAAA,MACF,CAAA;AAAA,MACA,gBAAgB,MAAM;AACpB,QAAA,KAAA,MAAW,QAAQ,SAAA,EAAW;AAC5B,UAAA,IAAI,CAAC,kBAAkB,IAAI,CAAA,IAAK,CAAC,OAAA,CAAQ,eAAA,CAAgB,IAAI,CAAA,EAAG;AAC9D,YAAA,OAAA,CAAQ,MAAA,CAAO;AAAA,cACb,IAAA,EAAM,IAAA;AAAA,cACN,SAAA,EAAW,eAAA;AAAA,cACX,IAAA,EAAM,EAAE,IAAA,EAAM,CAAA,EAAG,OAAA,CAAQ,WAAW,OAAA,CAAQ,IAAA,CAAK,MAAM,CAAC,CAAA,EAAA,CAAA;AAAK,aAC9D,CAAA;AAAA,UACH;AAAA,QACF;AAAA,MACF;AAAA,KACF;AAAA,EACF;AACF,CAAA;;;AChFO,IAAM,KAAA,GAAmD;AAAA,EAC9D,iCAAA,EAAmC,2BAAA;AAAA,EACnC,8BAAA,EAAgC;AAClC;AAEA,IAAM,SAAS,EAAE,IAAA,EAAM,EAAE,IAAA,EAAM,yBAAA,IAA6B,KAAA,EAAM;AAW3D,IAAM,OAAA,GAAmD;AAAA,EAC9D,WAAA,EAAa;AAAA,IACX,IAAA,EAAM,uBAAA;AAAA,IACN,OAAA,EAAS,EAAE,WAAA,EAAa,MAAA,EAAO;AAAA,IAC/B,KAAA,EAAO;AAAA,MACL,2CAAA,EAA6C,OAAA;AAAA,MAC7C,wCAAA,EAA0C;AAAA;AAC5C;AAEJ;AAEA,IAAM,QAAA,GAAiE,EAAE,GAAG,MAAA,EAAQ,OAAA,EAAQ;AAE5F,IAAO,aAAA,GAAQ","file":"index.js","sourcesContent":["import type { Rule } from 'eslint';\nimport type * as ESTree from 'estree';\n\n/** A function node as ESLint hands it to rules, with its parent. */\nexport type FunctionNode = Rule.Node &\n  (ESTree.FunctionExpression | ESTree.ArrowFunctionExpression | ESTree.FunctionDeclaration);\n\n/** What the TypeScript parser adds to classes and class members. */\ntype Decorated = { readonly decorators?: readonly { readonly expression: ESTree.Node }[] };\n\nconst FUNCTION_TYPES = new Set([\n  'FunctionExpression',\n  'ArrowFunctionExpression',\n  'FunctionDeclaration',\n]);\n\nexport function isFunction(node: Rule.Node): node is FunctionNode {\n  return FUNCTION_TYPES.has(node.type);\n}\n\n/** The call of the first decorator of `node` named one of `names`, such as `@RelayBusTransaction()`. */\nexport function findDecorator(\n  node: object,\n  names: ReadonlySet<string>,\n): ESTree.CallExpression | undefined {\n  for (const { expression } of (node as Decorated).decorators ?? []) {\n    if (\n      expression.type === 'CallExpression' &&\n      expression.callee.type === 'Identifier' &&\n      names.has(expression.callee.name)\n    ) {\n      return expression;\n    }\n  }\n  return undefined;\n}\n\n/** Whether an argument of `call` is an object literal with `transactional: true`. */\nexport function hasTransactionalOption(call: ESTree.CallExpression): boolean {\n  return call.arguments.some(\n    (argument) =>\n      argument.type === 'ObjectExpression' &&\n      argument.properties.some(\n        (property) =>\n          property.type === 'Property' &&\n          definitionName(property) === 'transactional' &&\n          property.value.type === 'Literal' &&\n          property.value.value === true,\n      ),\n  );\n}\n\n/**\n * The name of a property key, class member or import: `name`, `#name` for a private member, the\n * text of a string literal (`'name'`); undefined for anything computed at runtime.\n */\nexport function keyName(key: ESTree.Node): string | undefined {\n  if (key.type === 'Identifier') {\n    return key.name;\n  }\n  if (key.type === 'PrivateIdentifier') {\n    return `#${key.name}`;\n  }\n  return key.type === 'Literal' && typeof key.value === 'string' ? key.value : undefined;\n}\n\n/** The member a member expression reads: `get` for `a.get` and `a['get']`, undefined for `a[name]`. */\nexport function memberName(member: ESTree.MemberExpression): string | undefined {\n  return staticName(member.computed, member.property);\n}\n\n/** The name of a class member or object property: `place` for `place()` and `['place']()`, undefined for `[name]()`. */\nexport function definitionName(\n  definition: ESTree.MethodDefinition | ESTree.Property,\n): string | undefined {\n  return staticName(definition.computed, definition.key);\n}\n\nfunction staticName(computed: boolean, key: ESTree.Node): string | undefined {\n  return computed && key.type !== 'Literal' ? undefined : keyName(key);\n}\n\n/** The last name of an expression: `bus` for `bus`, `this.bus` and `app.services.bus`. */\nexport function lastName(node: ESTree.Node): string | undefined {\n  if (node.type === 'Identifier') {\n    return node.name;\n  }\n  return node.type === 'MemberExpression' ? memberName(node) : undefined;\n}\n","import type { Rule } from 'eslint';\nimport type * as ESTree from 'estree';\nimport { lastName, memberName } from './ast.js';\n\n/** HTTP client modules, by import source. */\ntype ClientModule = 'axios' | 'got' | 'http' | 'undici';\n\nconst MODULES: Readonly<Record<string, ClientModule>> = {\n  axios: 'axios',\n  got: 'got',\n  http: 'http',\n  'node:http': 'http',\n  https: 'http',\n  'node:https': 'http',\n  undici: 'undici',\n};\n\n/** Members of a module object that send a request; `undefined`: every member does. */\nconst REQUEST_MEMBERS: Readonly<Record<ClientModule, ReadonlySet<string> | undefined>> = {\n  axios: undefined,\n  got: undefined,\n  http: new Set(['request', 'get']),\n  undici: new Set(['request', 'fetch', 'stream', 'pipeline']),\n};\n\n/** `HttpService` of `@nestjs/axios`, injected as `httpService` (or `http`), and its `axiosRef`. */\nconst HTTP_SERVICE_NAME = /^(?:http|httpService|axiosRef)$/i;\n\n/**\n * Recognises calls to other services: `fetch`, `axios` and `got` (called or through a method),\n * `http.request` / `https.get` of Node.js, `undici.request` and friends (imported or required),\n * and `HttpService` of `@nestjs/axios`.\n */\nexport class ExternalCallDetector {\n  /** Local names of imported HTTP client modules. */\n  readonly #modules = new Map<string, ClientModule>([\n    ['axios', 'axios'],\n    ['got', 'got'],\n  ]);\n  /** Local names of imported request functions, such as `request` from `undici`. */\n  readonly #functions = new Set<string>(['fetch']);\n\n  /** Records `import x from 'axios'`, `import * as https from 'node:https'`, `import { request } from 'undici'`. */\n  recordImport(declaration: ESTree.ImportDeclaration): void {\n    const module = MODULES[String(declaration.source.value)];\n    if (module === undefined) {\n      return;\n    }\n    for (const specifier of declaration.specifiers) {\n      if (specifier.type !== 'ImportSpecifier') {\n        this.#modules.set(specifier.local.name, module);\n      } else if (REQUEST_MEMBERS[module]?.has(importedName(specifier)) === true) {\n        this.#functions.add(specifier.local.name);\n      }\n    }\n  }\n\n  /** Records `const axios = require('axios')`. */\n  recordRequire(declarator: ESTree.VariableDeclarator): void {\n    const { id, init } = declarator;\n    if (\n      id.type === 'Identifier' &&\n      init?.type === 'CallExpression' &&\n      lastName(init.callee) === 'require' &&\n      init.arguments[0]?.type === 'Literal'\n    ) {\n      const module = MODULES[String(init.arguments[0].value)];\n      if (module !== undefined) {\n        this.#modules.set(id.name, module);\n      }\n    }\n  }\n\n  /** Whether `call` sends a request to another service. */\n  isExternalCall(call: Rule.Node & ESTree.CallExpression): boolean {\n    const { callee } = call;\n    if (callee.type === 'Identifier') {\n      const module = this.#modules.get(callee.name);\n      return this.#functions.has(callee.name) || module === 'axios' || module === 'got';\n    }\n    return callee.type === 'MemberExpression' && this.#isClientMember(callee);\n  }\n\n  /** `axios.post`, `https.request`, `this.httpService.get`, `httpService.axiosRef.get`. */\n  #isClientMember(callee: ESTree.MemberExpression): boolean {\n    if (HTTP_SERVICE_NAME.test(lastName(callee.object) ?? '')) {\n      return true;\n    }\n    const module =\n      callee.object.type === 'Identifier' ? this.#modules.get(callee.object.name) : undefined;\n    if (module === undefined) {\n      return false;\n    }\n    return REQUEST_MEMBERS[module]?.has(memberName(callee) ?? '') ?? true;\n  }\n}\n\n/** `request` for `import { request }` and `import { 'request' as send }`. */\nfunction importedName(specifier: ESTree.ImportSpecifier): string {\n  const { imported } = specifier;\n  return imported.type === 'Identifier' ? imported.name : String(imported.value);\n}\n","import type { Rule } from 'eslint';\nimport type * as ESTree from 'estree';\nimport {\n  findDecorator,\n  definitionName,\n  hasTransactionalOption,\n  memberName,\n  type FunctionNode,\n} from './ast.js';\n\n/** Methods whose callback runs in a database transaction: relaybus, TypeORM, Knex, Sequelize, Prisma, MongoDB sessions. */\nconst TRANSACTION_METHODS = new Set(['transaction', '$transaction', 'withTransaction']);\nconst TRANSACTION_DECORATORS = new Set(['RelayBusTransaction']);\n/** Method decorators of relaybus handlers, current name and deprecated alias. */\nconst CONSUMER_DECORATORS = new Set(['RelayBusConsumer', 'Subscribe']);\n/** Class decorators of relaybus catalog handlers, current name and deprecated alias. */\nconst CATALOG_CONSUMER_DECORATORS = new Set(['RelayBusCatalogConsumer', 'EventConsumer']);\nconst CATALOG_HANDLER_NAME = /^on[A-Z]/;\n\n/**\n * Whether `method` runs in a transaction by itself: `@RelayBusTransaction()`, a\n * `@RelayBusConsumer(..., { transactional: true })` handler, or an `on<Event>` method of a class\n * marked `@RelayBusCatalogConsumer(..., { transactional: true })` (or the deprecated names).\n */\nexport function isTransactionalMethod(method: Rule.Node & ESTree.MethodDefinition): boolean {\n  if (findDecorator(method, TRANSACTION_DECORATORS) !== undefined) {\n    return true;\n  }\n  const consumer = findDecorator(method, CONSUMER_DECORATORS);\n  if (consumer !== undefined && hasTransactionalOption(consumer)) {\n    return true;\n  }\n  // A method's parent is the class body, whose parent is the class.\n  const catalogConsumer = findDecorator(method.parent.parent!, CATALOG_CONSUMER_DECORATORS);\n  return (\n    catalogConsumer !== undefined &&\n    hasTransactionalOption(catalogConsumer) &&\n    CATALOG_HANDLER_NAME.test(definitionName(method) ?? '')\n  );\n}\n\n/**\n * Whether `fn` runs in a transaction: a transactional method, the callback of\n * `x.transaction(fn)` (`bus.transaction`, `dataSource.transaction`, `prisma.$transaction`,\n * `session.withTransaction`), or a handler subscribed with `{ transactional: true }`.\n */\nexport function isTransactionScope(fn: FunctionNode): boolean {\n  const parent = fn.parent;\n  if (parent.type === 'MethodDefinition') {\n    return isTransactionalMethod(parent);\n  }\n  if (parent.type !== 'CallExpression' || parent.callee.type !== 'MemberExpression') {\n    return false;\n  }\n  const method = memberName(parent.callee);\n  if (TRANSACTION_METHODS.has(method ?? '')) {\n    return parent.arguments[0] === fn;\n  }\n  return method === 'subscribe' && parent.arguments[1] === fn && hasTransactionalOption(parent);\n}\n","import type { Rule, SourceCode } from 'eslint';\nimport type * as ESTree from 'estree';\nimport { definitionName, isFunction, memberName } from './ast.js';\nimport { isTransactionScope, isTransactionalMethod } from './transaction-scopes.js';\n\n/** A `this.method()` call and the class body it is written in. */\ntype ThisCall = {\n  readonly node: Rule.Node;\n  readonly method: string;\n  readonly classBody: Rule.Node;\n};\n\n/**\n * Tells whether a node runs inside a transaction. Besides transaction callbacks and transactional\n * methods, a method of the same class that is called with `this.method()` from inside a transaction\n * counts as well, transitively, so helpers of a `@RelayBusTransaction()` method are covered.\n * Record every call with {@link record} while traversing; ask {@link isInTransaction} at `Program:exit`.\n */\nexport class TransactionTracker {\n  readonly #sourceCode: SourceCode;\n  readonly #thisCalls: ThisCall[] = [];\n  readonly #transactional = new Map<Rule.Node, Set<string>>();\n\n  constructor(sourceCode: SourceCode) {\n    this.#sourceCode = sourceCode;\n  }\n\n  record(call: Rule.Node & ESTree.CallExpression): void {\n    const { callee } = call;\n    if (callee.type !== 'MemberExpression' || callee.object.type !== 'ThisExpression') {\n      return;\n    }\n    const method = memberName(callee);\n    const classBody = this.#ancestors(call).findLast((ancestor) => ancestor.type === 'ClassBody');\n    if (method !== undefined && classBody !== undefined) {\n      this.#thisCalls.push({ node: call, method, classBody });\n    }\n  }\n\n  isInTransaction(node: Rule.Node): boolean {\n    return this.#isInTransaction(node, (classBody) => this.#transactionalMethods(classBody));\n  }\n\n  #isInTransaction(node: Rule.Node, methodsOf: (classBody: Rule.Node) => Set<string>): boolean {\n    for (const ancestor of this.#ancestors(node).reverse()) {\n      if (isFunction(ancestor) && isTransactionScope(ancestor)) {\n        return true;\n      }\n      if (ancestor.type === 'MethodDefinition') {\n        return methodsOf(ancestor.parent).has(definitionName(ancestor) ?? '');\n      }\n    }\n    return false;\n  }\n\n  #ancestors(node: Rule.Node): Rule.Node[] {\n    return this.#sourceCode.getAncestors(node) as Rule.Node[];\n  }\n\n  /** Methods of a class that run in a transaction, directly or through `this.method()` calls. */\n  #transactionalMethods(classBody: Rule.Node): Set<string> {\n    const known = this.#transactional.get(classBody);\n    if (known !== undefined) {\n      return known;\n    }\n    const methods = new Set(\n      (classBody as Rule.Node & ESTree.ClassBody).body\n        .filter((member) => member.type === 'MethodDefinition')\n        .filter((member) => isTransactionalMethod(member as Rule.Node & ESTree.MethodDefinition))\n        .map((member) => definitionName(member) ?? ''),\n    );\n    const calls = this.#thisCalls.filter((call) => call.classBody === classBody);\n    for (let grew = true; grew;) {\n      const added = calls.filter(\n        (call) => !methods.has(call.method) && this.#isInTransaction(call.node, () => methods),\n      );\n      added.forEach((call) => methods.add(call.method));\n      grew = added.length > 0;\n    }\n    this.#transactional.set(classBody, methods);\n    return methods;\n  }\n}\n","import type { Rule } from 'eslint';\nimport type * as ESTree from 'estree';\nimport { ExternalCallDetector } from '../external-calls.js';\nimport { TransactionTracker } from '../transaction-tracker.js';\n\n/**\n * Reports calls to other services (HTTP clients) made inside a transaction: a\n * `@RelayBusTransaction()` method, a transactional handler, a `bus.transaction` (or other\n * `.transaction`) callback, and the methods they call through `this`.\n */\nexport const noExternalCallInTransaction: Rule.RuleModule = {\n  meta: {\n    type: 'problem',\n    docs: {\n      description: 'Disallow calls to other services inside a database transaction',\n      url: 'https://berkcansavur.github.io/relaybus/recipes/transactions-in-nestjs',\n    },\n    schema: [],\n    messages: {\n      externalCall:\n        '{{call}} calls another service inside a transaction. The transaction keeps its row locks ' +\n        'and its database connection until the call returns, and relaybus rolls it back with ' +\n        'TransactionTimeoutError once it outlives transactionTimeout. Make the call before the ' +\n        'transaction starts or after it commits (for example from the handler of an event you publish).',\n    },\n  },\n  create(context) {\n    const tracker = new TransactionTracker(context.sourceCode);\n    const detector = new ExternalCallDetector();\n    const calls: (Rule.Node & ESTree.CallExpression)[] = [];\n    return {\n      ImportDeclaration: (node) => detector.recordImport(node),\n      VariableDeclarator: (node) => detector.recordRequire(node),\n      CallExpression: (node) => {\n        tracker.record(node);\n        calls.push(node);\n      },\n      'Program:exit': () => {\n        for (const call of calls) {\n          if (detector.isExternalCall(call) && tracker.isInTransaction(call)) {\n            context.report({\n              node: call,\n              messageId: 'externalCall',\n              data: { call: `${context.sourceCode.getText(call.callee)}()` },\n            });\n          }\n        }\n      },\n    };\n  },\n};\n","import type { Rule } from 'eslint';\nimport type * as ESTree from 'estree';\nimport { definitionName, lastName, memberName } from '../ast.js';\nimport { TransactionTracker } from '../transaction-tracker.js';\n\nconst PUBLISH_METHODS = new Set(['publish', 'publishAll']);\n/** Default names of the objects whose `publish` is a relaybus publish: `bus`, `this.eventBus`, `orderPublisher`. */\nconst DEFAULT_PUBLISHERS = '(?:^|[a-z_$])(?:[Bb]us|[Pp]ublisher)$|^(?:bus|publisher)$';\n\ntype Options = { readonly publishers?: string };\n\n/**\n * Whether `call` passes a transaction itself: `{ transaction }` in its options, or options the\n * rule cannot see into (a variable, a spread).\n */\nfunction passesTransaction(call: ESTree.CallExpression): boolean {\n  const options = call.arguments[1];\n  if (options === undefined) {\n    return false;\n  }\n  if (options.type !== 'ObjectExpression') {\n    return true;\n  }\n  return options.properties.some(\n    (property) => property.type === 'SpreadElement' || definitionName(property) === 'transaction',\n  );\n}\n\n/**\n * Reports `bus.publish` / `bus.publishAll` outside a transaction: not in a\n * `@RelayBusTransaction()` method, a transactional handler or a `.transaction` callback (or a\n * method they call through `this`), and without `{ transaction }`.\n */\nexport const publishRequiresTransaction: Rule.RuleModule = {\n  meta: {\n    type: 'problem',\n    docs: {\n      description: 'Require relaybus publish calls to run inside a transaction',\n      url: 'https://berkcansavur.github.io/relaybus/recipes/transactions-in-nestjs',\n    },\n    schema: [\n      {\n        type: 'object',\n        properties: { publishers: { type: 'string' } },\n        additionalProperties: false,\n      },\n    ],\n    messages: {\n      noTransaction:\n        '{{call}} runs outside a transaction, so the event is not atomic with your writes and ' +\n        'relaybus throws TransactionRequiredError. Publish inside a @RelayBusTransaction() method ' +\n        'or a bus.transaction(...) callback, or pass { transaction }.',\n    },\n  },\n  create(context) {\n    const [options = {}] = context.options as [Options?];\n    const publishers = new RegExp(options.publishers ?? DEFAULT_PUBLISHERS);\n    const tracker = new TransactionTracker(context.sourceCode);\n    const publishes: (Rule.Node & ESTree.CallExpression)[] = [];\n    return {\n      CallExpression: (node) => {\n        tracker.record(node);\n        const { callee } = node;\n        if (\n          callee.type === 'MemberExpression' &&\n          PUBLISH_METHODS.has(memberName(callee) ?? '') &&\n          publishers.test(lastName(callee.object) ?? '')\n        ) {\n          publishes.push(node);\n        }\n      },\n      'Program:exit': () => {\n        for (const call of publishes) {\n          if (!passesTransaction(call) && !tracker.isInTransaction(call)) {\n            context.report({\n              node: call,\n              messageId: 'noTransaction',\n              data: { call: `${context.sourceCode.getText(call.callee)}()` },\n            });\n          }\n        }\n      },\n    };\n  },\n};\n","import type { ESLint, Linter, Rule } from 'eslint';\nimport { noExternalCallInTransaction } from './rules/no-external-call-in-transaction.js';\nimport { publishRequiresTransaction } from './rules/publish-requires-transaction.js';\n\nexport const rules: Readonly<Record<string, Rule.RuleModule>> = {\n  'no-external-call-in-transaction': noExternalCallInTransaction,\n  'publish-requires-transaction': publishRequiresTransaction,\n};\n\nconst plugin = { meta: { name: '@relaybus/eslint-plugin' }, rules } satisfies ESLint.Plugin;\n\n/**\n * Both rules at error level, under the plugin name `@relaybus`:\n *\n * ```js\n * // eslint.config.js\n * import relaybus from '@relaybus/eslint-plugin';\n * export default [relaybus.configs.recommended];\n * ```\n */\nexport const configs: { readonly recommended: Linter.Config } = {\n  recommended: {\n    name: '@relaybus/recommended',\n    plugins: { '@relaybus': plugin },\n    rules: {\n      '@relaybus/no-external-call-in-transaction': 'error',\n      '@relaybus/publish-requires-transaction': 'error',\n    },\n  },\n};\n\nconst relaybus: ESLint.Plugin & { readonly configs: typeof configs } = { ...plugin, configs };\n\nexport default relaybus;\n"]}

package/package.json

@@ -1,6 +1,67 @@
 {
   "name": "@relaybus/eslint-plugin",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.3.0",
+  "description": "ESLint rules for relaybus: no calls to other services inside a transaction, and no publish outside a transaction, so outbox transactions stay short and events stay atomic with your writes.",
+  "license": "MIT",
+  "author": "Berkcan Şavur <berkcansavur@gmail.com>",
+  "homepage": "https://berkcansavur.github.io/relaybus/packages/eslint-plugin",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/berkcansavur/relaybus.git",
+    "directory": "packages/eslint-plugin"
+  },
+  "bugs": "https://github.com/berkcansavur/relaybus/issues",
+  "keywords": [
+    "relaybus",
+    "eslint",
+    "eslintplugin",
+    "eslint-plugin",
+    "transactional-outbox",
+    "outbox-pattern",
+    "nestjs",
+    "transactions",
+    "typescript"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "peerDependencies": {
+    "eslint": ">=9.0.0"
+  },
+  "devDependencies": {
+    "@types/estree": "1.0.9",
+    "eslint": "9.39.5",
+    "typescript-eslint": "8.71.2"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc -p tsconfig.build.json --noEmit"
+  }
 }