@pjts/eslint-style-rules 0.0.0-stage → 0.0.2

package/README.md

@@ -1,3 +1,139 @@
-# Temporary Holding Version
+# @pjts/eslint-style-rules
 
-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.
+ESLint rules and a flat-config preset that enforce the pjts DDD layout and conventions: layer
+boundaries, module structure, repositories, ports, endpoints, errors and tests.
+
+```bash
+npm i -D @pjts/eslint-style-rules eslint typescript-eslint
+```
+
+## Usage
+
+The preset assumes the pjts layout — `src/modules/<module>/{app,domain,infrastructure}`, one
+`<Module>Module.ts` per module, tests next to the file they test.
+
+```js
+// eslint.config.mjs
+import pjts from '@pjts/eslint-style-rules';
+
+export default [
+  { ignores: ['dist/**'] },
+  ...pjts.configs.ddd,
+];
+```
+
+Different paths:
+
+```js
+...pjts.createDddConfig({
+  src: 'src',
+  modules: 'src/modules',
+  exclude: ['src/infrastructure/database/**', 'src/deployments/**'], // migrations, composition root
+  uuidPaths: ['/domain/', '/src/common/values/'],
+  messages: 'src/common/messages',               // one <Name>.ts per message + index.ts (MessageNames)
+  authAccess: { allow: ['NewsletterService.findMany'] }, // opt-in: @AuthAccess('scope:level') on every AuthToken param
+  storages: {
+    pg: { prefix: 'Pg', imports: ['@pjts/infra#PostgresDbClient', 'knex', 'pg'] },
+    nats: { prefix: 'Nats', imports: ['nats', '@nats-io/*'] },
+    memory: { prefix: 'InMemory' },
+  },
+}),
+```
+
+Rules can also be used one by one: `plugins: { pjts }`, then `'pjts/<rule>': 'error'`.
+
+### Adopting it in an existing codebase
+
+Freeze existing violations with ESLint's bulk suppressions (ESLint ≥ 9.24) and burn them down:
+
+```bash
+npx eslint src/ --suppress-all        # writes eslint-suppressions.json
+npx eslint src/ --prune-suppressions  # after fixing old violations
+```
+
+New code must comply; a file may not gain violations of a rule it already has. A justified
+exception is an inline disable with a reason:
+`// eslint-disable-next-line pjts/save-contract -- RETURNING sequence_number`.
+
+## Rules
+
+### Domain
+
+| Rule | What it checks |
+|---|---|
+| `event-sourced-aggregate` | `extends EventSourceable<XEvent>`: `@trackable`, typed event union, `protected apply` with a `case` for every emitted `MessageNames.X`, `apply` replay-safe (no emit / throw / clock / id minting / randomness). Option `stateChangesInApply`: `this.x = …` only in the constructor and `apply` |
+| `no-async-in-domain` | no `async`, `await` or `Promise<…>` — except awaiting/returning a call from `allowedModules` (`bcrypt`) |
+| `entity-constructor-data` | entity constructors take one `<Entity>Data` object (decorated primitives, `…Error`s skipped) |
+| `decorated-class-contract` | classes with a configured decorator implement the listed methods (`@StringDomainPrimitive` → `toJSON`) |
+| `no-reconstitute` | no `reconstitute` definition or call — repositories deserialize, services call `existing.update()` |
+
+### Application
+
+| Rule | What it checks |
+|---|---|
+| `app-class-suffix` | app-layer classes end with `Service` \| `Handler` \| `View` |
+| `app-service-endpoints` | every public method of an `@AppService` has exactly one `@Get`/`@Post`/`@Put`/`@Patch`/`@Delete` and every parameter a request-binding decorator (`@Auth`, `@Body`, `@UrlParam`, `@QueryParam(s)`, `@Header`, `@Ip`, `@File`); non-public methods carry none |
+| `return-entities` | no `.toJSON()` and no `Promise<…ResponseDto/Response/JSON>` — return entities, the framework serializes |
+| `no-entity-assembly-in-app` | no `new Entity({...})` / `Entity.create({...})` from domain imports — use `Entity.fromDTO(...)` |
+| `find-one-naming` | the private owner-scoped fetch helper (`AuthToken` first, throws `AppError.notFound`) is `findOne` |
+| `save-contract` | `save()`'s result is never used; `save` returns `Promise<void>` |
+| `no-entity-mutation-outside-domain` | a loaded entity (`await this.findOne(…)` / `await this.<repo>.find…(…)`) changes through its methods, not `entity.field = …` |
+| `auth-access` | (opt-in) every `AuthToken` parameter of an `@AppService` uses `@AuthAccess('scope:read', …)` with literal rights; plain `@Auth` only for `allow`ed `Service.method` / `File.method` (stale entries reported); `authToken`, or `_authToken` when unread |
+
+### Messages
+
+| Rule | What it checks |
+|---|---|
+| `message-file` | one message per file: an exported interface named like the file, extending `Message` (or a `…Base`), `name: MessageNames.<FileName>`; helper payload types may stay |
+| `message-names` | `MessageNames` in the messages `index.ts`: every key has a file, every message file has a key and a re-export, values are the key in SCREAMING_SNAKE_CASE |
+| `no-message-construction-outside-domain` | an object literal pinning `name: MessageNames.X` exists only under `domain/` — aggregates return or emit message bodies, the app layer passes them on |
+| `message-name-reference` | message names through the enum — no `'CALENDAR_BOOKED'` in `name:`, `case` of a `switch (x.name)`, or a handler's `super([...])` |
+| `message-handler` | `MessageHandlerBase` subclasses: `…Handler` in `app/`, `super([MessageNames.X, …])`, subscribed names = handled `case`s, protected typed `handleMessage`, depends only on ports or app classes (`allowedTypes` for e.g. `MessageInbox`) |
+
+### Infrastructure & database
+
+| Rule | What it checks |
+|---|---|
+| `repository-naming` | repositories live in `infrastructure/repositories/<storage>/` (several: `pg+nats/`), prefixed after it (`Pg`, `PgNats`, `InMemory`); the folder matches the file's imports; one repository per file, named after it |
+| `repository-serialization` | `Pg*Repository` has `serialize` + `deserialize` (no `toDomain`/`toRow`/…); `deserialize` returns `new Entity(...)` |
+| `knex-first` | single-record reads end with `.first()`, not `const [row] = await this.db(…)` |
+| `trackable-repository` | repositories on pjx `RepositoryBase` / `OutboxRepository`: every `deserialize…` is `@reconstitute` (else `save()` inserts a duplicate); an event-sourced aggregate's repository extends `…OutboxRepository` |
+| `db-client-dependency` | only `…Pg…Repository` classes (Pg anywhere in the prefix) take `PostgresDbClient` / knex / pg as a dependency |
+| `db-writes-in-repositories` | insert/update/delete (+ truncate, upsert, increment, decrement, onConflict, transactions, writing raw SQL) happen only in a `…Pg…Repository` under `infrastructure/` |
+
+### Structure
+
+| Rule | What it checks |
+|---|---|
+| `module-layout` | only `rootFiles` at a module root (`<Module>Module.ts`, `<Module>MessageHandlers.ts`, `index.ts`); allowed top-level and `app/` subfolders; required entries exist |
+| `module-service-getters` | a `…Module`'s public getters return only `new X(...)` of a class from its own `./app/`, named `x` (camelCase) |
+| `port-file` | ports live in `app/ports/<Name>Port.ts`, one exported interface per file named like it; only types; no `…Port` elsewhere |
+| `port-has-adapters` | every `XRepositoryPort` has at least one implementation in the module's infrastructure |
+| `test-location` | `<TestedFile>.<optional-suffix>.test.ts` sits next to `<TestedFile>.ts`; no `__tests__/` |
+
+### Cross-cutting
+
+| Rule | What it checks |
+|---|---|
+| `throw-app-error` | only `throw AppError.x(...)` / `throw new AppError(...)` from `@pjts/core`; rethrowing the caught error is allowed |
+| `import-only-in` | a package is imported only under given path fragments (`uuid` → `/domain/`) |
+| `no-duplicate-sdk-types` | frontend: no local type named like one in the generated client's `types.d.ts` |
+
+## Limits
+
+- Rules see one file at a time. `module-layout`, `port-has-adapters`, `test-location`,
+  `message-names` and `trackable-repository` read
+  sibling files from disk, so in an editor they refresh only when the reporting file is re-linted;
+  the CLI is always accurate. Don't use `eslint --cache` with them.
+- `no-entity-assembly-in-app` and `no-duplicate-sdk-types` are name-based heuristics.
+
+## Development
+
+```bash
+npm run test    # RuleTester suites, one <rule>.test.ts next to each rule
+npm run lint
+npm run build   # tsc → dist/
+```
+
+Adding a rule: `src/rules/<name>.ts` (`defineRule({ meta, create })`, policy in options), its
+`<name>.test.ts`, register it in `src/index.ts`, add it to the preset if it is part of the policy.

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+import type { ESLint, Linter } from 'eslint';
+interface DddConfigOptions {
+    /** Source root, relative to the config file. Default `src`. */
+    src?: string;
+    /** Folder holding one directory per module, relative to the config file. Default `src/modules`. */
+    modules?: string;
+    /** Excluded from the cross-cutting rules (DB, errors, uuid): migrations, composition root. */
+    exclude?: string[];
+    /** Path fragments where `uuid` may be imported. */
+    uuidPaths?: string[];
+    /** Messages folder (one `<Name>.ts` per message + index.ts with `MessageNames`). Default `<src>/common/messages`. */
+    messages?: string;
+    /**
+     * Require `@AuthAccess('scope:level')` on every AuthToken parameter of @AppService endpoints.
+     * Off by default; `allow` lists `Service.method` (or `File.method`) entries still on plain `@Auth`.
+     */
+    authAccess?: false | {
+        allow?: string[];
+        rightPattern?: string;
+        decorator?: string;
+        checkParamName?: boolean;
+    };
+    /** Storage folders of `infrastructure/repositories/<storage>/`, their prefixes and import signatures. */
+    storages?: Record<string, {
+        prefix: string;
+        imports?: string[];
+    }>;
+}
+/**
+ * The pjts DDD layer policy as a flat config. Every module in `<modules>/<name>/` has `app/`,
+ * `domain/` and `infrastructure/`; tests sit next to the file they test.
+ */
+declare const createDddConfig: (options?: DddConfigOptions) => Linter.Config[];
+declare const _default: ESLint.Plugin & {
+    createDddConfig: typeof createDddConfig;
+    configs: Record<string, Linter.Config[]>;
+};
+export = _default;

package/dist/index.js

@@ -0,0 +1,230 @@
+"use strict";
+const tslib_1 = require("tslib");
+const app_class_suffix_1 = tslib_1.__importDefault(require("./rules/app-class-suffix"));
+const auth_access_1 = tslib_1.__importDefault(require("./rules/auth-access"));
+const event_sourced_aggregate_1 = tslib_1.__importDefault(require("./rules/event-sourced-aggregate"));
+const message_file_1 = tslib_1.__importDefault(require("./rules/message-file"));
+const message_handler_1 = tslib_1.__importDefault(require("./rules/message-handler"));
+const message_name_reference_1 = tslib_1.__importDefault(require("./rules/message-name-reference"));
+const message_names_1 = tslib_1.__importDefault(require("./rules/message-names"));
+const no_entity_mutation_outside_domain_1 = tslib_1.__importDefault(require("./rules/no-entity-mutation-outside-domain"));
+const no_message_construction_outside_domain_1 = tslib_1.__importDefault(require("./rules/no-message-construction-outside-domain"));
+const trackable_repository_1 = tslib_1.__importDefault(require("./rules/trackable-repository"));
+const app_service_endpoints_1 = tslib_1.__importDefault(require("./rules/app-service-endpoints"));
+const db_client_dependency_1 = tslib_1.__importDefault(require("./rules/db-client-dependency"));
+const db_writes_in_repositories_1 = tslib_1.__importDefault(require("./rules/db-writes-in-repositories"));
+const decorated_class_contract_1 = tslib_1.__importDefault(require("./rules/decorated-class-contract"));
+const entity_constructor_data_1 = tslib_1.__importDefault(require("./rules/entity-constructor-data"));
+const find_one_naming_1 = tslib_1.__importDefault(require("./rules/find-one-naming"));
+const import_only_in_1 = tslib_1.__importDefault(require("./rules/import-only-in"));
+const knex_first_1 = tslib_1.__importDefault(require("./rules/knex-first"));
+const module_layout_1 = tslib_1.__importDefault(require("./rules/module-layout"));
+const module_service_getters_1 = tslib_1.__importDefault(require("./rules/module-service-getters"));
+const no_async_in_domain_1 = tslib_1.__importDefault(require("./rules/no-async-in-domain"));
+const no_duplicate_sdk_types_1 = tslib_1.__importDefault(require("./rules/no-duplicate-sdk-types"));
+const no_entity_assembly_in_app_1 = tslib_1.__importDefault(require("./rules/no-entity-assembly-in-app"));
+const no_reconstitute_1 = tslib_1.__importDefault(require("./rules/no-reconstitute"));
+const port_file_1 = tslib_1.__importDefault(require("./rules/port-file"));
+const port_has_adapters_1 = tslib_1.__importDefault(require("./rules/port-has-adapters"));
+const repository_naming_1 = tslib_1.__importDefault(require("./rules/repository-naming"));
+const repository_serialization_1 = tslib_1.__importDefault(require("./rules/repository-serialization"));
+const return_entities_1 = tslib_1.__importDefault(require("./rules/return-entities"));
+const save_contract_1 = tslib_1.__importDefault(require("./rules/save-contract"));
+const test_location_1 = tslib_1.__importDefault(require("./rules/test-location"));
+const throw_app_error_1 = tslib_1.__importDefault(require("./rules/throw-app-error"));
+const rules = {
+    'auth-access': auth_access_1.default,
+    'event-sourced-aggregate': event_sourced_aggregate_1.default,
+    'message-file': message_file_1.default,
+    'message-handler': message_handler_1.default,
+    'message-name-reference': message_name_reference_1.default,
+    'message-names': message_names_1.default,
+    'no-entity-mutation-outside-domain': no_entity_mutation_outside_domain_1.default,
+    'no-message-construction-outside-domain': no_message_construction_outside_domain_1.default,
+    'trackable-repository': trackable_repository_1.default,
+    'app-class-suffix': app_class_suffix_1.default,
+    'app-service-endpoints': app_service_endpoints_1.default,
+    'db-client-dependency': db_client_dependency_1.default,
+    'db-writes-in-repositories': db_writes_in_repositories_1.default,
+    'decorated-class-contract': decorated_class_contract_1.default,
+    'entity-constructor-data': entity_constructor_data_1.default,
+    'find-one-naming': find_one_naming_1.default,
+    'import-only-in': import_only_in_1.default,
+    'knex-first': knex_first_1.default,
+    'module-layout': module_layout_1.default,
+    'module-service-getters': module_service_getters_1.default,
+    'no-async-in-domain': no_async_in_domain_1.default,
+    'no-duplicate-sdk-types': no_duplicate_sdk_types_1.default,
+    'no-entity-assembly-in-app': no_entity_assembly_in_app_1.default,
+    'no-reconstitute': no_reconstitute_1.default,
+    'port-file': port_file_1.default,
+    'port-has-adapters': port_has_adapters_1.default,
+    'repository-naming': repository_naming_1.default,
+    'repository-serialization': repository_serialization_1.default,
+    'return-entities': return_entities_1.default,
+    'save-contract': save_contract_1.default,
+    'test-location': test_location_1.default,
+    'throw-app-error': throw_app_error_1.default,
+};
+/**
+ * The pjts DDD layer policy as a flat config. Every module in `<modules>/<name>/` has `app/`,
+ * `domain/` and `infrastructure/`; tests sit next to the file they test.
+ */
+const createDddConfig = (options = {}) => {
+    // typescript-eslint is a peer dependency: only needed when the preset is used.
+    const tseslint = require('typescript-eslint');
+    const { src = 'src', modules = 'src/modules', exclude = [`${src}/infrastructure/database/**`, `${src}/deployments/**`], uuidPaths = ['/domain/', `/${src}/common/values/`], messages = `${src}/common/messages`, authAccess = false, storages = {
+        pg: { prefix: 'Pg', imports: ['@pjts/infra#PostgresDbClient', 'knex', 'pg'] },
+        nats: { prefix: 'Nats', imports: ['nats', '@nats-io/*'] },
+        memory: { prefix: 'InMemory' },
+    }, } = options;
+    const module = `${modules}/*`;
+    const infrastructureImport = { group: ['**/infrastructure', '**/infrastructure/**'], message: 'Depend on a port in app/ports, not on infrastructure.' };
+    return [
+        {
+            files: [`${src}/**/*.ts`],
+            languageOptions: { parser: tseslint.parser },
+            plugins: { pjts: plugin, '@typescript-eslint': tseslint.plugin },
+            rules: {
+                'pjts/no-reconstitute': 'error',
+                // @AppService public methods are endpoints: one HTTP decorator, every parameter request-bound.
+                'pjts/app-service-endpoints': 'error',
+                // Fields, constructor, static factories (`fromDTO`, `create`), then instance methods.
+                '@typescript-eslint/member-ordering': ['error', { default: ['field', 'constructor', 'static-method', 'instance-method'] }],
+            },
+        },
+        {
+            // pjts DTOs: constructor(data) first, then the validated (decorated) fields, then toJSON.
+            files: [`${module}/app/dto/**/*.ts`],
+            rules: { '@typescript-eslint/member-ordering': ['error', { default: ['constructor', 'field', 'static-method', 'instance-method'] }] },
+        },
+        // ── Cross-cutting: database, errors, identifiers ──────────────────────────
+        {
+            files: [`${src}/**/*.ts`],
+            ignores: exclude,
+            rules: {
+                // Only …Pg…Repository classes depend on the client, and only they write through it.
+                'pjts/db-client-dependency': 'error',
+                'pjts/db-writes-in-repositories': 'error',
+                // Every thrown error is an AppError (rethrowing a caught error unchanged is fine).
+                'pjts/throw-app-error': 'error',
+                // Identities are minted by the domain.
+                'pjts/import-only-in': ['error', {
+                        modules: { uuid: { paths: uuidPaths, reason: 'ids are created by domain factories (`TaskId.create()`), not by services or repositories.' } },
+                    }],
+                // Message names only through the MessageNames enum.
+                'pjts/message-name-reference': 'error',
+                // Message bodies are built by domain methods (returned or emitted), never in app/infrastructure.
+                'pjts/no-message-construction-outside-domain': 'error',
+                ...(authAccess ? { 'pjts/auth-access': ['error', authAccess] } : {}),
+            },
+        },
+        // ── Messages: one per file, MessageNames in step ──────────────────────────
+        {
+            files: [`${messages}/*.ts`],
+            rules: { 'pjts/message-file': 'error', 'pjts/message-names': 'error' },
+        },
+        // ── Module structure ──────────────────────────────────────────────────────
+        {
+            files: [`${module}/**/*.ts`],
+            rules: {
+                'pjts/module-layout': ['error', {
+                        folders: ['app', 'domain', 'infrastructure', 'testing'],
+                        subfolders: { app: ['dto', 'ports'] },
+                        required: ['app', 'index.ts'],
+                        // The module's MessageHandlerBase composition root sits next to its HTTP module.
+                        rootFiles: ['{Module}Module.ts', '{Module}MessageHandlers.ts', 'index.ts'],
+                    }],
+                // Ports: app/ports/<Name>Port.ts, one exported interface named like the file; `…Port` nowhere else.
+                'pjts/port-file': 'error',
+            },
+        },
+        {
+            // Modules expose their own app-layer classes — and nothing else — as camelCase getters.
+            files: [`${module}/*Module.ts`],
+            rules: { 'pjts/module-service-getters': ['error', { suffixes: ['Service', 'View', 'Handler'] }] },
+        },
+        // ── Domain layer: pure, synchronous, no I/O ───────────────────────────────
+        {
+            files: [`${module}/domain/**/*.ts`],
+            rules: {
+                'pjts/no-async-in-domain': ['error', { allowedModules: ['bcrypt'] }],
+                'pjts/decorated-class-contract': ['error', {
+                        contracts: { StringDomainPrimitive: ['toJSON'], NumberDomainPrimitive: ['toJSON'], ObjectDomainPrimitive: ['toJSON'] },
+                    }],
+                'pjts/entity-constructor-data': 'error',
+                // EventSourceable: @trackable, typed events, replay-safe apply() handling every emitted name.
+                'pjts/event-sourced-aggregate': 'error',
+                'no-restricted-imports': ['error', {
+                        patterns: [
+                            { group: ['**/infrastructure', '**/infrastructure/**'], message: 'The domain must not depend on infrastructure.' },
+                            { group: ['knex', 'pg', '@pjts/infra', 'axios', '@aws-sdk/*', '@anthropic-ai/*', '@elevenlabs/*'], message: 'The domain must stay free of I/O libraries.' },
+                            // Importing app-layer DTOs into the domain is fine (Entity.fromDTO) — nothing else from app/.
+                            { group: ['**/app', '**/app/**', '!**/app/dto', '!**/app/dto/**'], message: 'The domain may import app-layer DTOs only.' },
+                        ],
+                    }],
+            },
+        },
+        {
+            // Value objects, domain services and events aren't entities.
+            files: [`${module}/domain/values/**/*.ts`, `${module}/domain/services/**/*.ts`, `${module}/domain/events/**/*.ts`],
+            rules: { 'pjts/entity-constructor-data': 'off' },
+        },
+        // ── Application layer ─────────────────────────────────────────────────────
+        {
+            files: [`${module}/app/*.ts`],
+            ignores: ['**/index.ts'],
+            rules: {
+                'pjts/app-class-suffix': ['error', { allowed: ['Service', 'Handler', 'View'] }],
+                'pjts/return-entities': 'error',
+                'pjts/no-entity-assembly-in-app': 'error',
+                'pjts/find-one-naming': 'error',
+                // MessageHandlerBase consumers: …Handler, subscribed = handled, ports/app classes only.
+                'pjts/message-handler': 'error',
+                // Loaded entities change through their own methods (events, change tracking, invariants).
+                'pjts/no-entity-mutation-outside-domain': 'error',
+                'no-restricted-imports': ['error', { patterns: [infrastructureImport] }],
+            },
+        },
+        {
+            files: [`${module}/app/ports/*.ts`],
+            rules: { 'pjts/port-has-adapters': 'error' },
+        },
+        {
+            files: [`${module}/app/**/*.ts`, `${module}/infrastructure/**/*.ts`],
+            rules: { 'pjts/save-contract': 'error' },
+        },
+        // ── Infrastructure layer ──────────────────────────────────────────────────
+        {
+            files: [`${module}/infrastructure/**/*.ts`],
+            rules: {
+                // One folder per infrastructural dependency set: repositories/pg/, repositories/pg+nats/ → PgNats…Repository.
+                'pjts/repository-naming': ['error', { storages, requireImplementationFolder: true, fileNameMatchesClass: true }],
+                'pjts/repository-serialization': ['error', { classPattern: '^Pg\\w*Repository$' }],
+                'pjts/knex-first': 'error',
+                // RepositoryBase/OutboxRepository: @reconstitute on deserialize, event-sourced → OutboxRepository.
+                'pjts/trackable-repository': 'error',
+            },
+        },
+        // ── Tests: next to the tested file; that is the only rule applied to them ──
+        {
+            files: [`${src}/**/*.test.ts`],
+            rules: {
+                ...Object.fromEntries(Object.keys(rules).map((rule) => [`pjts/${rule}`, 'off'])),
+                '@typescript-eslint/member-ordering': 'off',
+                'no-restricted-imports': 'off',
+                'pjts/test-location': 'error',
+            },
+        },
+    ];
+};
+const plugin = {
+    meta: { name: '@pjts/eslint-style-rules' },
+    rules,
+    configs: {},
+    createDddConfig,
+};
+// `configs.ddd` is built on first access so the plugin itself loads without typescript-eslint.
+Object.defineProperty(plugin.configs, 'ddd', { enumerable: true, get: () => createDddConfig() });
+module.exports = plugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/ast.d.ts

@@ -0,0 +1,27 @@
+/** Forward-slash path of the file being linted. */
+export declare const filePath: (context: any) => any;
+/** `apps/api/src/modules/<module>/<rest>` → `{ module, rest: ['app', 'TaskService.ts'] }`, or null. */
+export declare const moduleLocation: (context: any) => {
+    module: any;
+    rest: any;
+    root: string;
+} | null;
+export declare const methods: (classNode: any) => any;
+export declare const memberName: (member: any) => any;
+export declare const findMethod: (classNode: any, name: any, isStatic?: boolean) => any;
+/** Decorator names on a class: `@Foo` and `@Foo()` both give `Foo`. */
+export declare const decoratorNames: (classNode: any) => any;
+/** Type name of an annotation such as `data: TaskData` → `TaskData`. */
+export declare const annotationTypeName: (annotation: any) => any;
+/**
+ * `Promise<X>` return annotation → the X node; `undefined` when the annotation is not a Promise
+ * (or missing), so callers can tell "not async-typed" from "Promise of nothing".
+ */
+export declare const promiseTypeArgument: (returnType: any) => any;
+/** `foo.bar(...)` → 'bar'. */
+export declare const calledMethodName: (call: any) => any;
+export declare const unwrapAwait: (node: any) => any;
+/** `kebab-case` → `PascalCase`. */
+export declare const pascalCase: (kebab: any) => any;
+/** `Array.prototype.findLast` (ES2023) for the ES2021 target. */
+export declare const findLast: <T>(items: readonly T[], predicate: (item: T) => boolean) => T | undefined;

package/dist/lib/ast.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findLast = exports.pascalCase = exports.unwrapAwait = exports.calledMethodName = exports.promiseTypeArgument = exports.annotationTypeName = exports.decoratorNames = exports.findMethod = exports.memberName = exports.methods = exports.moduleLocation = exports.filePath = void 0;
+const tslib_1 = require("tslib");
+const node_path_1 = tslib_1.__importDefault(require("node:path"));
+/** Forward-slash path of the file being linted. */
+const filePath = (context) => context.filename.split(node_path_1.default.sep).join('/');
+exports.filePath = filePath;
+/** `apps/api/src/modules/<module>/<rest>` → `{ module, rest: ['app', 'TaskService.ts'] }`, or null. */
+const moduleLocation = (context) => {
+    const match = (0, exports.filePath)(context).match(/\/src\/modules\/([^/]+)\/(.+)$/);
+    return match ? { module: match[1], rest: match[2].split('/'), root: (0, exports.filePath)(context).slice(0, match.index) + `/src/modules/${match[1]}` } : null;
+};
+exports.moduleLocation = moduleLocation;
+const methods = (classNode) => classNode.body.body.filter((member) => member.type === 'MethodDefinition');
+exports.methods = methods;
+const memberName = (member) => member.key?.name ?? member.key?.value ?? null;
+exports.memberName = memberName;
+const findMethod = (classNode, name, isStatic) => (0, exports.methods)(classNode).find((m) => (0, exports.memberName)(m) === name && (isStatic === undefined || m.static === isStatic));
+exports.findMethod = findMethod;
+/** Decorator names on a class: `@Foo` and `@Foo()` both give `Foo`. */
+const decoratorNames = (classNode) => (classNode.decorators ?? []).map((d) => (d.expression.type === 'CallExpression' ? d.expression.callee.name : d.expression.name));
+exports.decoratorNames = decoratorNames;
+/** Type name of an annotation such as `data: TaskData` → `TaskData`. */
+const annotationTypeName = (annotation) => {
+    const type = annotation?.typeAnnotation ?? annotation;
+    return type?.type === 'TSTypeReference' && type.typeName.type === 'Identifier' ? type.typeName.name : null;
+};
+exports.annotationTypeName = annotationTypeName;
+/**
+ * `Promise<X>` return annotation → the X node; `undefined` when the annotation is not a Promise
+ * (or missing), so callers can tell "not async-typed" from "Promise of nothing".
+ */
+const promiseTypeArgument = (returnType) => {
+    const type = returnType?.typeAnnotation;
+    if (type?.type !== 'TSTypeReference' || type.typeName.name !== 'Promise')
+        return undefined;
+    return type.typeArguments?.params?.[0] ?? null;
+};
+exports.promiseTypeArgument = promiseTypeArgument;
+/** `foo.bar(...)` → 'bar'. */
+const calledMethodName = (call) => call?.type === 'CallExpression' && call.callee.type === 'MemberExpression' && !call.callee.computed
+    ? call.callee.property.name
+    : null;
+exports.calledMethodName = calledMethodName;
+const unwrapAwait = (node) => (node?.type === 'AwaitExpression' ? node.argument : node);
+exports.unwrapAwait = unwrapAwait;
+/** `kebab-case` → `PascalCase`. */
+const pascalCase = (kebab) => kebab.split('-').map((part) => part[0].toUpperCase() + part.slice(1)).join('');
+exports.pascalCase = pascalCase;
+/** `Array.prototype.findLast` (ES2023) for the ES2021 target. */
+const findLast = (items, predicate) => {
+    for (let index = items.length - 1; index >= 0; index--) {
+        if (predicate(items[index]))
+            return items[index];
+    }
+    return undefined;
+};
+exports.findLast = findLast;
+//# sourceMappingURL=ast.js.map

package/dist/lib/ast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.js","sourceRoot":"","sources":["../../src/lib/ast.ts"],"names":[],"mappings":"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"}

package/dist/lib/db.d.ts

@@ -0,0 +1,13 @@
+/** Default DB client types: `module#ImportedName` specs (see `clientTypeTracker`). */
+export declare const DEFAULT_CLIENTS: string[];
+/**
+ * Tracks which local names refer to a DB client type, from the file's imports, and tells whether a
+ * type annotation uses one (`PostgresDbClient`, `Knex`, `Knex.Transaction`, `PostgresDbClient | null`).
+ */
+export declare const clientTypeTracker: (clients?: string[]) => {
+    names: Set<unknown>;
+    onImport(node: any): void;
+    usesClient: (type: any) => any;
+};
+/** `param`, `private readonly param`, `param = x` → the binding node carrying the annotation. */
+export declare const paramBinding: (param: any) => any;

package/dist/lib/db.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.paramBinding = exports.clientTypeTracker = exports.DEFAULT_CLIENTS = void 0;
+/** Default DB client types: `module#ImportedName` specs (see `clientTypeTracker`). */
+exports.DEFAULT_CLIENTS = ['@pjts/infra#PostgresDbClient', 'knex#Knex', 'pg#Pool', 'pg#Client', 'pg#PoolClient'];
+const matchesSpec = (spec, source, importedName) => {
+    const [module, name] = spec.split('#');
+    return source === module && (!name || importedName === name);
+};
+/**
+ * Tracks which local names refer to a DB client type, from the file's imports, and tells whether a
+ * type annotation uses one (`PostgresDbClient`, `Knex`, `Knex.Transaction`, `PostgresDbClient | null`).
+ */
+const clientTypeTracker = (clients = exports.DEFAULT_CLIENTS) => {
+    const names = new Set();
+    const usesClient = (type) => {
+        if (!type)
+            return false;
+        if (type.type === 'TSTypeAnnotation')
+            return usesClient(type.typeAnnotation);
+        if (type.type === 'TSTypeReference') {
+            let name = type.typeName;
+            while (name.type === 'TSQualifiedName')
+                name = name.left;
+            return names.has(name.name);
+        }
+        if (type.type === 'TSUnionType' || type.type === 'TSIntersectionType')
+            return type.types.some(usesClient);
+        return false;
+    };
+    return {
+        names,
+        onImport(node) {
+            for (const specifier of node.specifiers) {
+                const imported = specifier.imported?.name ?? specifier.local.name;
+                if (clients.some((spec) => matchesSpec(spec, node.source.value, imported)))
+                    names.add(specifier.local.name);
+            }
+        },
+        usesClient,
+    };
+};
+exports.clientTypeTracker = clientTypeTracker;
+/** `param`, `private readonly param`, `param = x` → the binding node carrying the annotation. */
+const paramBinding = (param) => {
+    const node = param.type === 'TSParameterProperty' ? param.parameter : param;
+    return node.type === 'AssignmentPattern' ? node.left : node;
+};
+exports.paramBinding = paramBinding;
+//# sourceMappingURL=db.js.map

package/dist/lib/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../../src/lib/db.ts"],"names":[],"mappings":";;;AAAA,sFAAsF;AACzE,QAAA,eAAe,GAAG,CAAC,8BAA8B,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC;AAEtH,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE;IACjD,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACvC,OAAO,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,IAAI,YAAY,KAAK,IAAI,CAAC,CAAC;AAC/D,CAAC,CAAC;AAEF;;;GAGG;AACI,MAAM,iBAAiB,GAAG,CAAC,OAAO,GAAG,uBAAe,EAAE,EAAE;IAC7D,MAAM,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;IACxB,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,EAAE;QAC1B,IAAI,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QACxB,IAAI,IAAI,CAAC,IAAI,KAAK,kBAAkB;YAAE,OAAO,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC7E,IAAI,IAAI,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;YACpC,IAAI,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC;YACzB,OAAO,IAAI,CAAC,IAAI,KAAK,iBAAiB;gBAAE,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;YACzD,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,IAAI,IAAI,CAAC,IAAI,KAAK,oBAAoB;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1G,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IACF,OAAO;QACL,KAAK;QACL,QAAQ,CAAC,IAAI;YACX,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACxC,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,EAAE,IAAI,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC;gBAClE,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;oBAAE,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC9G,CAAC;QACH,CAAC;QACD,UAAU;KACX,CAAC;AACJ,CAAC,CAAC;AAvBW,QAAA,iBAAiB,qBAuB5B;AAEF,iGAAiG;AAC1F,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,EAAE;IACpC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,qBAAqB,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;IAC5E,OAAO,IAAI,CAAC,IAAI,KAAK,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9D,CAAC,CAAC;AAHW,QAAA,YAAY,gBAGvB"}

package/dist/lib/messages.d.ts

@@ -0,0 +1,13 @@
+/** `CatalogProfilePublished` → `CATALOG_PROFILE_PUBLISHED`. */
+export declare const screamingSnake: (name: string) => string;
+/** `MessageNames.X` (expression or type position) → 'X'; anything else → null. */
+export declare const messageNameOf: (node: any, enumName?: string) => string | null;
+/** Names set in `name: MessageNames.X` of an object literal (spreads ignored). */
+export declare const nameProperty: (objectExpression: any, enumName?: string) => {
+    name: string | null;
+    node: any;
+} | null;
+/** Every `case MessageNames.X:` inside `node` (any switch). */
+export declare const switchCaseNames: (node: any, enumName?: string) => Set<string>;
+/** Depth-first walk that does not enter nested functions or classes. */
+export declare const walkOwnBody: (node: any, visit: (node: any) => void) => void;