@shivaedev/quality 0.58.0 → 0.59.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (66) hide show
  1. package/CHANGELOG.md +13 -0
  2. package/README.md +8 -2
  3. package/dist/adapters/bodyReferences.d.ts +10 -0
  4. package/dist/adapters/bodyReferences.d.ts.map +1 -0
  5. package/dist/adapters/bodyReferences.js +125 -0
  6. package/dist/adapters/bodyReferences.js.map +1 -0
  7. package/dist/adapters/engineEscapes.d.ts +10 -0
  8. package/dist/adapters/engineEscapes.d.ts.map +1 -0
  9. package/dist/adapters/engineEscapes.js +103 -0
  10. package/dist/adapters/engineEscapes.js.map +1 -0
  11. package/dist/adapters/outcomeAssertions.d.ts +9 -0
  12. package/dist/adapters/outcomeAssertions.d.ts.map +1 -0
  13. package/dist/adapters/outcomeAssertions.js +94 -0
  14. package/dist/adapters/outcomeAssertions.js.map +1 -0
  15. package/dist/adapters/positiveRefusalFindings.d.ts +4 -0
  16. package/dist/adapters/positiveRefusalFindings.d.ts.map +1 -0
  17. package/dist/adapters/positiveRefusalFindings.js +41 -0
  18. package/dist/adapters/positiveRefusalFindings.js.map +1 -0
  19. package/dist/adapters/rpcBoundaryFindings.d.ts +4 -0
  20. package/dist/adapters/rpcBoundaryFindings.d.ts.map +1 -0
  21. package/dist/adapters/rpcBoundaryFindings.js +90 -0
  22. package/dist/adapters/rpcBoundaryFindings.js.map +1 -0
  23. package/dist/adapters/serviceAccess.d.ts +4 -0
  24. package/dist/adapters/serviceAccess.d.ts.map +1 -0
  25. package/dist/adapters/serviceAccess.js +33 -0
  26. package/dist/adapters/serviceAccess.js.map +1 -0
  27. package/dist/adapters/vitePort.d.ts +2 -0
  28. package/dist/adapters/vitePort.d.ts.map +1 -0
  29. package/dist/adapters/vitePort.js +5 -0
  30. package/dist/adapters/vitePort.js.map +1 -0
  31. package/dist/appViteConfig.d.ts +4 -1
  32. package/dist/appViteConfig.d.ts.map +1 -1
  33. package/dist/appViteConfig.js +7 -3
  34. package/dist/appViteConfig.js.map +1 -1
  35. package/dist/rules/builtIn.d.ts +2 -2
  36. package/dist/rules/builtIn.d.ts.map +1 -1
  37. package/dist/rules/builtIn.js +4 -0
  38. package/dist/rules/builtIn.js.map +1 -1
  39. package/dist/rules/effect/rpcBoundary.d.ts +2 -0
  40. package/dist/rules/effect/rpcBoundary.d.ts.map +1 -0
  41. package/dist/rules/effect/rpcBoundary.js +9 -0
  42. package/dist/rules/effect/rpcBoundary.js.map +1 -0
  43. package/dist/rules/stories/engine.d.ts.map +1 -1
  44. package/dist/rules/stories/engine.js +24 -7
  45. package/dist/rules/stories/engine.js.map +1 -1
  46. package/dist/rules/stories/positiveRefusals.d.ts +2 -0
  47. package/dist/rules/stories/positiveRefusals.d.ts.map +1 -0
  48. package/dist/rules/stories/positiveRefusals.js +17 -0
  49. package/dist/rules/stories/positiveRefusals.js.map +1 -0
  50. package/dist/rules/stories/usesInputs.d.ts.map +1 -1
  51. package/dist/rules/stories/usesInputs.js +3 -2
  52. package/dist/rules/stories/usesInputs.js.map +1 -1
  53. package/package.json +4 -4
  54. package/src/adapters/bodyReferences.ts +141 -0
  55. package/src/adapters/engineEscapes.ts +119 -0
  56. package/src/adapters/outcomeAssertions.ts +110 -0
  57. package/src/adapters/positiveRefusalFindings.ts +52 -0
  58. package/src/adapters/rpcBoundaryFindings.ts +98 -0
  59. package/src/adapters/serviceAccess.ts +38 -0
  60. package/src/adapters/vitePort.ts +5 -0
  61. package/src/appViteConfig.ts +13 -3
  62. package/src/rules/builtIn.ts +4 -0
  63. package/src/rules/effect/rpcBoundary.ts +10 -0
  64. package/src/rules/stories/engine.ts +25 -9
  65. package/src/rules/stories/positiveRefusals.ts +17 -0
  66. package/src/rules/stories/usesInputs.ts +3 -2
package/CHANGELOG.md CHANGED
@@ -1,5 +1,18 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.59.0 - 2026-11-04
4
+
5
+ ### Added
6
+
7
+ - `appViteConfig` accepts `{ webPort, apiPort }` as its fourth argument. Omitted ports read `VITE_PORT` and `PORT` respectively, falling back to 5173 and 3000.
8
+ - `tests/positive-refusals` reports negative-only `toBe` and `toEqual` checks on outcome readouts. Pair them with a positive domain reason or public response on the same outcome in the same story, including an `outcomes` row.
9
+ - Report `rpcBoundary` and `rpcBoundaryHandlers` outside modules that build native RPC handlers, keeping service failures typed until the handler edge.
10
+ - Enforce service definitions as operation inventories with imported initializers, operations and state factories, including marked generic methods.
11
+
12
+ ### Breaking
13
+
14
+ - Import `ImportAnalysisFailure` from `@shivaedev/quality/adapters/ImportAnalysisFailure.ts` instead of `@shivaedev/quality/adapters/ImportCompiler.ts`.
15
+
3
16
  ## 0.58.0 - 2026-11-04
4
17
 
5
18
  ### Added
package/README.md CHANGED
@@ -110,6 +110,10 @@ The rule refuses config exceptions and inline suppressions. For existing debt, r
110
110
 
111
111
  `effect/shared-error-classes` reports a tagged error class that reuses a tag exported by `@shivaedev/errors`. Import the shared class from the module named in the finding instead. The rule reads exported class types, including source and declaration exports, and compares literal `_tag` values rather than class names. It uses the repository's installed errors package, or Quality's dependency when the repository does not yet depend on errors. It checks adapters and tests too. Subclasses retaining a shared tag are separate classes and are reported; shared declarations and imports, distinct tags and non-error classes are accepted.
112
112
 
113
+ ### RPC handler boundaries
114
+
115
+ `effect/rpc-boundary` reports calls to `rpcBoundary` or `rpcBoundaryHandlers` outside modules that build native RPC handlers with a group's `toLayer`, `toLayerHandler`, `toHandlers` or `of`. Move the boundary to the handler module so services preserve their typed failures. Imported and local aliases are checked; unrelated functions and methods with the same names are accepted. Test-support kits and the implementation of `rpcBoundaryHandlers` are accepted. The rule refuses config exceptions and inline suppressions.
116
+
113
117
  ### Failure honesty
114
118
 
115
119
  `effect/failure-honesty` checks TypeScript and JavaScript throughout the inventory, including adapters and tests. It reports four failure-hiding shapes:
@@ -253,7 +257,7 @@ Keep story kits and fixtures in `src/test-support` and keep each spec specific t
253
257
 
254
258
  Quality's `tests/story-specs` rule reports a test file that declares tests without a kit's `it`, including plain Vitest `it` and `test` declarations mixed with stories. Typecheck tests are exempt, as are only the packages named `@shivaedev/test-story`, `@shivaedev/test` and `@shivaedev/types`, wherever they live in the workspace or at its root. Other dependencies of test-story, including development dependencies, remain checked.
255
259
 
256
- Quality's `tests/story-engine` rule reports a kit story with no traits whose body never references its verbs, its story or its test context. Drive the engine through one of the kit's verbs or traits, or, if the code under test is pure, move it to `<stem>.unit.test.ts`, which reaches no engine and mocks nothing. The rule follows the same kit origins and prerequisite exemptions as `tests/story-specs`; unit and typecheck files are exempt.
260
+ Quality's `tests/story-engine` rule reports spec bodies that read raw service handles, reach through `story.engine`, or call production constructors to wire an engine outside the kit. It follows local aliases, destructuring and re-exported service tags inside the body, including nested callbacks. Move that access into verbs or traits in `test-support/` and keep expectations in the spec. A constructor can remain the subject of its colocated spec; native SQL handles used only for `withTransaction` can wrap kit verbs. Native Effect data constructors remain available. The rule also reports a kit story with no traits whose body never references its verbs, its story or its test context. Drive the engine through one of the kit's verbs or traits, or, if the code under test is pure, move it to `<stem>.unit.test.ts`, which reaches no engine and mocks nothing. The rule follows the same kit origins and prerequisite exemptions as `tests/story-specs`; unit and typecheck files are exempt.
257
261
 
258
262
  `tests/global-retries` reports a `retry` option on a test, suite or kit story registration, including `retry: 0`. Remove the option: retries are global only and recorded by vitest-rerun so flakes stay visible. The rule follows registrar imports, aliases and modifiers, and options declared as literals, shared variables or spreads. Runner configuration and Effect retry schedules are accepted. It checks registrations throughout the inventory, including unit tests and test-support files, with no story prerequisite exemptions.
259
263
 
@@ -269,6 +273,8 @@ Specs keep expectations visible. `tests/spec-helpers` moves all module-level hel
269
273
 
270
274
  Three more rules keep a spec readable as a story, as the [story-testing skill](https://github.com/ShivaeDev/platform/blob/main/packages/skills/skills/story-testing/SKILL.md) describes. Together with `tests/spec-helpers`, `tests/named-values` and `tests/no-limit-imports`, they read files whose test declarations trace to a story kit, whatever their suffix: a `.test` or `.spec` file outside `test-support` that is not a type or unit test, such as `orders.spec.ts`, `pane.dom.test.ts` or `orders.slow.test.ts`. The suffix says where a test sits under `tests/follow`, not whether it is a story, and `tests/story-specs` already holds every such file to the story kit. They exempt the same test-story prerequisites as `tests/story-specs`. `tests/domain-outcomes` reports each use of Effect's `Exit`, `Cause` or `Result` module, each `_tag` read or destructuring, and each object literal tagged `"Success"` or `"Failure"`: the kit's verb or readout returns the outcome in the domain's words, such as `"unauthorized"`, and a trait builds any failing input. A domain's own tagged value, such as `{ _tag: "Resync" }`, passes. `tests/grouped-outcomes` reports each run of two or more consecutive `expect(yield* …)` statements once, at its first statement: write the outcomes as rows of one `outcomes` call. `tests/wait-on-events` reports `Effect.sleep`, `setTimeout` and `setInterval`, calls to an imported `eventually`, Vitest's fake timers, `vi.waitFor`, and `TestClock.adjust` and `TestClock.setTime`: settle on the engine's own signal through a kit verb, and when time passing is the behaviour, advance the clock in a verb named for it.
271
275
 
276
+ `tests/positive-refusals` reports `.not.toBe` and `.not.toEqual` on a readout or field whose name ends in `outcome` (case insensitive), including locally stored readout aliases. In the same story, positively assert a concrete domain reason or public response on that same outcome with `toBe`, `toEqual`, `toMatchObject` or an `outcomes` row. For example, pair `expect(yield* submitOutcome()).not.toBe("saved")` with `expect(yield* submitOutcome()).toBe("unauthorized")`, or replace the negative check with the positive one. Another story, another outcome, an empty object or a boolean does not supply that evidence. The rule uses the same story-file scope and prerequisite exemptions as `tests/domain-outcomes`; it checks visible assertion syntax, while review establishes that a readout preserves unexpected failures.
277
+
272
278
  `tests/queue-readouts` reports access to jobs-testing's `jobs` and `snapshot` readouts in tests and `test-support/`, including wrappers that return counts or job states. An enqueued job does not prove the work ran: assert the application's visible result instead. Worker controls and waits remain available. The check recognizes receivers named `jobsTesting`, controllers constructed with `makePgBossTesting` or annotated with the imported `PgBossTesting` type, local and imported aliases, destructuring and literal bracket access. It does not evaluate dynamic property names or arbitrary controller factories. The package named `@shivaedev/jobs` is exempt, at the repository root or wherever it lives in the workspace; nested application packages remain checked. This rule refuses config exceptions and inline suppressions.
273
279
 
274
280
  `boundaries/queue-sql` rejects SQL mentioning the private `pgboss.` schema. Apps use their queue definitions and let workers process jobs; there is no queue-purge API by design. `boundaries/auth-sql` rejects SQL accessing Better Auth's `user`, `account`, `session` and `verification` tables. App tables reference users by foreign key: migrations may reference only `user(id)` with `ON DELETE CASCADE` or `ON DELETE SET NULL`. Import `userReference` from `@shivaedev/identity/server/better-auth/userReference.ts` and interpolate `sql(userReference.table)` and `sql(userReference.column)` in the reference. Apps use identity for account data; `options.owners` names platform's own auth implementation and its migrations. These rules inspect SQL templates, literal query calls and query variables, and inventoried `.sql` files. They do not evaluate arbitrary runtime SQL construction.
@@ -555,7 +561,7 @@ import { appViteConfig } from "@shivaedev/quality/appViteConfig.ts";
555
561
  export default appViteConfig([tailwindcss(), react()]);
556
562
  ```
557
563
 
558
- Use this in `vite.config.ts`. Plugins belong to the app. The shared server proxies `/api/auth` and `/rpc` to the local host on port 3000, preserving the request Host. Pass extra host routes as the third argument, for example `appViteConfig(plugins, [], ["/health"])`, to proxy them to the same host during development. It enables TypeScript path resolution. Client routes, including administration pages, stay on Vite.
564
+ Use this in `vite.config.ts`. Plugins belong to the app. The web server port defaults to `VITE_PORT`, then 5173. The API port defaults to `PORT`, then 3000. These variables come from the process environment. Pass `{ webPort: 5273, apiPort: 3100 }` as the fourth argument to override either port, for example `appViteConfig(plugins, [], ["/health"], { webPort: 5273, apiPort: 3100 })`. The shared server proxies `/api/auth` and `/rpc` to the API port on `127.0.0.1`, preserving the request Host. Pass extra host routes as the third argument to proxy them to the same host during development. It enables TypeScript path resolution. Client routes, including administration pages, stay on Vite.
559
565
 
560
566
  ```ts
561
567
  import { appTestConfig } from "@shivaedev/quality/appTestConfig.ts";
@@ -0,0 +1,10 @@
1
+ import ts from "typescript";
2
+ export interface BodyReference {
3
+ readonly file?: string | undefined;
4
+ readonly kind: "data" | "import" | "service" | "told";
5
+ readonly module: string;
6
+ readonly path: readonly string[];
7
+ }
8
+ export declare function storyBody(body: ts.Expression, checker: ts.TypeChecker): ts.ArrowFunction | ts.ConstructorDeclaration | ts.FunctionDeclaration | ts.FunctionExpression | ts.GetAccessorDeclaration | ts.MethodDeclaration | ts.SetAccessorDeclaration | undefined;
9
+ export declare function bodyReferences(body: ts.SignatureDeclaration, checker: ts.TypeChecker): (node: ts.Node) => BodyReference | undefined;
10
+ //# sourceMappingURL=bodyReferences.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bodyReferences.d.ts","sourceRoot":"","sources":["../../src/adapters/bodyReferences.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAI5B,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;IACtD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC,WAAW,4LAGrE;AAiBD,wBAAgB,cAAc,CAAC,IAAI,EAAE,EAAE,CAAC,oBAAoB,EAAE,OAAO,EAAE,EAAE,CAAC,WAAW,UAqF/D,EAAE,CAAC,IAAI,KAAG,aAAa,GAAG,SAAS,CAWxD"}
@@ -0,0 +1,125 @@
1
+ import ts from "typescript";
2
+ import { importFrom } from "#rules/stories/importOrigin.ts";
3
+ import { memberName, unwrapped } from "#rules/stories/syntax.ts";
4
+ export function storyBody(body, checker) {
5
+ const declaration = checker.getTypeAtLocation(body).getCallSignatures()[0]?.declaration;
6
+ return declaration !== undefined && "body" in declaration ? declaration : undefined;
7
+ }
8
+ function importName(node) {
9
+ if (ts.isImportSpecifier(node)) {
10
+ return (node.propertyName ?? node.name).text;
11
+ }
12
+ return ts.isImportClause(node) ? "default" : undefined;
13
+ }
14
+ function wrapped(node) {
15
+ return ts.isParenthesizedExpression(node) || ts.isAsExpression(node) || ts.isSatisfiesExpression(node) || ts.isNonNullExpression(node);
16
+ }
17
+ function importBinding(node) {
18
+ return ts.isImportSpecifier(node) || ts.isNamespaceImport(node) || ts.isImportClause(node);
19
+ }
20
+ export function bodyReferences(body, checker) {
21
+ const known = new Map();
22
+ const visiting = new Set();
23
+ const told = body.parameters[0];
24
+ function symbol(value) {
25
+ return value?.declarations?.map(visit).find((reference) => reference !== undefined);
26
+ }
27
+ function imported(node) {
28
+ const name = importName(node);
29
+ const module = importFrom(node);
30
+ if (module === undefined) {
31
+ return undefined;
32
+ }
33
+ const value = checker.getSymbolAtLocation(node.name ?? node);
34
+ const target = value !== undefined && value.flags & ts.SymbolFlags.Alias ? checker.getAliasedSymbol(value) : undefined;
35
+ const resolved = symbol(target);
36
+ if (resolved?.kind === "service" || resolved?.kind === "data") {
37
+ return resolved;
38
+ }
39
+ const canonical = target?.declarations === undefined ? name : target.name;
40
+ return { file: target?.declarations?.[0]?.getSourceFile().fileName, kind: "import", module, path: name === undefined ? [] : [canonical ?? name] };
41
+ }
42
+ function member(reference, name) {
43
+ return reference === undefined ? undefined : { ...reference, path: [...reference.path, name] };
44
+ }
45
+ function binding(node) {
46
+ const name = node.propertyName ?? node.name;
47
+ return ts.isIdentifier(name) || ts.isStringLiteral(name) ? member(visit(node.parent.parent), name.text) : undefined;
48
+ }
49
+ function call(node) {
50
+ const called = visit(node.expression);
51
+ if ((called?.kind === "service" && called.path.length === 0) || (called?.kind === "import" && serviceFactory(called))) {
52
+ return { kind: "service", module: called.module, path: [] };
53
+ }
54
+ if (called?.kind === "data" || (called?.kind === "import" && dataFactory(called))) {
55
+ return { kind: "data", module: called.module, path: [] };
56
+ }
57
+ return undefined;
58
+ }
59
+ function property(node) {
60
+ const receiver = visit(node.expression);
61
+ if (receiver?.kind === "import" && receiver.path.length === 0) {
62
+ const resolved = symbol(checker.getSymbolAtLocation(ts.isPropertyAccessExpression(node) ? node.name : node));
63
+ if (resolved?.kind === "service" || resolved?.kind === "data") {
64
+ return resolved;
65
+ }
66
+ }
67
+ return member(receiver, memberName(node) ?? "");
68
+ }
69
+ function expression(node) {
70
+ if (ts.isIdentifier(node)) {
71
+ return symbol(checker.getSymbolAtLocation(node));
72
+ }
73
+ if (ts.isPropertyAccessExpression(node) || ts.isElementAccessExpression(node)) {
74
+ return property(node);
75
+ }
76
+ return ts.isCallExpression(node) ? call(node) : undefined;
77
+ }
78
+ function classReference(node) {
79
+ return node.heritageClauses
80
+ ?.flatMap((clause) => clause.types.map((base) => visit(base.expression)))
81
+ .find((value) => value?.kind === "service" || value?.kind === "data");
82
+ }
83
+ function origin(node) {
84
+ if (wrapped(node)) {
85
+ return visit(node.expression);
86
+ }
87
+ if (node === told) {
88
+ return { kind: "told", module: "", path: [] };
89
+ }
90
+ if (importBinding(node)) {
91
+ return imported(node);
92
+ }
93
+ if (ts.isVariableDeclaration(node)) {
94
+ return node.initializer === undefined ? undefined : visit(unwrapped(node.initializer));
95
+ }
96
+ if (ts.isBindingElement(node)) {
97
+ return binding(node);
98
+ }
99
+ if (ts.isClassDeclaration(node)) {
100
+ return classReference(node);
101
+ }
102
+ return expression(node);
103
+ }
104
+ function visit(node) {
105
+ if (visiting.has(node) || known.has(node)) {
106
+ return known.get(node);
107
+ }
108
+ visiting.add(node);
109
+ const value = origin(node);
110
+ visiting.delete(node);
111
+ known.set(node, value);
112
+ return value;
113
+ }
114
+ return visit;
115
+ }
116
+ function dataFactory({ module, path }) {
117
+ return (module === "effect" && (path[0] === "Schema" || path[0] === "Data")) || module === "effect/Schema" || module === "effect/Data";
118
+ }
119
+ function serviceFactory({ module, path }) {
120
+ return ((module === "@shivaedev/service/defineService.ts" && path[0] === "defineService")
121
+ || ((module === "effect" || module === "effect/Context")
122
+ && path.at(-1) !== undefined
123
+ && ["Service", "Tag", "GenericTag", "Reference"].includes(path.at(-1) ?? "")));
124
+ }
125
+ //# sourceMappingURL=bodyReferences.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bodyReferences.js","sourceRoot":"","sources":["../../src/adapters/bodyReferences.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ import ts from "typescript";
2
+ export interface EngineEscape {
3
+ readonly node: ts.Node;
4
+ readonly reason: string;
5
+ }
6
+ export declare function engineEscapes(body: ts.Expression, checker: ts.TypeChecker, file: string): {
7
+ drivesSubject: boolean;
8
+ escapes: EngineEscape[];
9
+ };
10
+ //# sourceMappingURL=engineEscapes.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"engineEscapes.d.ts","sourceRoot":"","sources":["../../src/adapters/engineEscapes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,YAAY,CAAC;AAO5B,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AA0BD,wBAAgB,aAAa,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,MAAM;;;EAiFvF"}
@@ -0,0 +1,103 @@
1
+ import { posix } from "node:path";
2
+ import ts from "typescript";
3
+ import { isTestSupport, testName } from "#naming/testName.ts";
4
+ import { engineOf } from "#rules/stories/engineOf.ts";
5
+ import { memberName, unwrapped } from "#rules/stories/syntax.ts";
6
+ import { bodyReferences, storyBody } from "./bodyReferences.js";
7
+ import { serviceAccess } from "./serviceAccess.js";
8
+ function production({ file, module }) {
9
+ return (!(isTestSupport(file ?? module) || module.startsWith("@shivaedev/test"))
10
+ && (/^[.#/]/u.test(module)
11
+ || module.startsWith("@shivaedev/")
12
+ || engineOf({ kind: "external", package: module, specifier: module }) !== undefined));
13
+ }
14
+ function constructorTest(file, reference) {
15
+ const name = testName(file);
16
+ const target = reference.file ?? posix.join(posix.dirname(file), reference.module);
17
+ return name !== undefined && target.endsWith(`/${posix.join(name.folder, name.stem)}${name.extension}`);
18
+ }
19
+ function constructorCall(node, called) {
20
+ const name = called.path.at(-1) ?? "";
21
+ return (called.kind === "import"
22
+ && production(called)
23
+ && (ts.isNewExpression(node) || /^(?:(?:make|create|build)[A-Z]|make$|create$|build$|defineService$|layer(?:$|[A-Z]))/u.test(name)));
24
+ }
25
+ export function engineEscapes(body, checker, file) {
26
+ const declaration = storyBody(body, checker);
27
+ if (declaration?.body === undefined) {
28
+ return { drivesSubject: false, escapes: [] };
29
+ }
30
+ const reference = bodyReferences(declaration, checker);
31
+ const block = declaration.body;
32
+ const escapes = [];
33
+ let drivesSubject = false;
34
+ function transactionHandle(node, value) {
35
+ if (!((value.module === "effect/sql/SqlClient" || value.module === "effect/sql") && value.path.at(-1) === "SqlClient")) {
36
+ return false;
37
+ }
38
+ const yielded = node.parent;
39
+ const binding = yielded.parent;
40
+ if (!(ts.isYieldExpression(yielded) && ts.isVariableDeclaration(binding) && ts.isIdentifier(binding.name))) {
41
+ return false;
42
+ }
43
+ const name = binding.name;
44
+ const symbol = checker.getSymbolAtLocation(name);
45
+ const uses = [];
46
+ function collect(current) {
47
+ if (ts.isIdentifier(current) && current !== name && checker.getSymbolAtLocation(current) === symbol) {
48
+ uses.push(current);
49
+ }
50
+ ts.forEachChild(current, collect);
51
+ }
52
+ collect(block);
53
+ return (uses.length > 0
54
+ && uses.every((use) => (ts.isPropertyAccessExpression(use.parent) || ts.isElementAccessExpression(use.parent))
55
+ && use.parent.expression === use
56
+ && memberName(use.parent) === "withTransaction"));
57
+ }
58
+ function accessReason(node) {
59
+ const value = reference(node);
60
+ if (value?.kind === "told" && value.path[0] === "story" && value.path[1] === "engine") {
61
+ return "Reads story.engine";
62
+ }
63
+ if (value === undefined || !serviceAccess(node, value, reference)) {
64
+ return undefined;
65
+ }
66
+ if (transactionHandle(node, value)) {
67
+ drivesSubject = true;
68
+ return undefined;
69
+ }
70
+ return "Reads a raw service handle";
71
+ }
72
+ function checkConstructor(node) {
73
+ const called = reference(unwrapped(node.expression));
74
+ if (called === undefined || !constructorCall(node, called)) {
75
+ return;
76
+ }
77
+ if (constructorTest(file, called)) {
78
+ drivesSubject = true;
79
+ }
80
+ else {
81
+ escapes.push({ node, reason: "Calls a production constructor" });
82
+ }
83
+ }
84
+ function visit(node) {
85
+ if (ts.isTypeNode(node)) {
86
+ return;
87
+ }
88
+ if (ts.isIdentifier(node) || ts.isPropertyAccessExpression(node) || ts.isElementAccessExpression(node)) {
89
+ const reason = accessReason(node);
90
+ if (reason !== undefined) {
91
+ escapes.push({ node, reason });
92
+ return;
93
+ }
94
+ }
95
+ if (ts.isCallExpression(node) || ts.isNewExpression(node)) {
96
+ checkConstructor(node);
97
+ }
98
+ ts.forEachChild(node, visit);
99
+ }
100
+ visit(declaration.body);
101
+ return { drivesSubject, escapes: escapes.filter((found, index) => escapes.findIndex((other) => other.reason === found.reason) === index) };
102
+ }
103
+ //# sourceMappingURL=engineEscapes.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"engineEscapes.js","sourceRoot":"","sources":["../../src/adapters/engineEscapes.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,9 @@
1
+ import ts from "typescript";
2
+ export interface OutcomeAssertion {
3
+ readonly expected: ts.Expression;
4
+ readonly negative: boolean;
5
+ readonly node: ts.Node;
6
+ readonly subject: string;
7
+ }
8
+ export declare function outcomeAssertions(body: ts.Node, checker: ts.TypeChecker): readonly OutcomeAssertion[];
9
+ //# sourceMappingURL=outcomeAssertions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"outcomeAssertions.d.ts","sourceRoot":"","sources":["../../src/adapters/outcomeAssertions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAI5B,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB;AAqFD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,WAAW,GAAG,SAAS,gBAAgB,EAAE,CAerG"}
@@ -0,0 +1,94 @@
1
+ import ts from "typescript";
2
+ import { importBindings } from "#rules/stories/importBindings.ts";
3
+ import { memberName, unwrapped } from "#rules/stories/syntax.ts";
4
+ function receiver(node) {
5
+ const value = unwrapped(node);
6
+ return ts.isPropertyAccessExpression(value) || ts.isElementAccessExpression(value) ? unwrapped(value.expression) : undefined;
7
+ }
8
+ function imported(node, name, modules, bindings) {
9
+ const value = unwrapped(node);
10
+ if (!ts.isIdentifier(value)) {
11
+ return false;
12
+ }
13
+ const binding = bindings.get(value.text);
14
+ return binding === undefined ? value.text === name : binding.imported === name && modules.includes(binding.module);
15
+ }
16
+ function subject(node, checker) {
17
+ const value = unwrapped(node);
18
+ if (ts.isYieldExpression(value)) {
19
+ return value.expression === undefined ? undefined : subject(value.expression, checker);
20
+ }
21
+ if (ts.isIdentifier(value)) {
22
+ const declaration = checker.getSymbolAtLocation(value)?.valueDeclaration;
23
+ if (declaration !== undefined && ts.isVariableDeclaration(declaration) && declaration.initializer !== undefined) {
24
+ return subject(declaration.initializer, checker);
25
+ }
26
+ }
27
+ const named = ts.isCallExpression(value) ? unwrapped(value.expression) : value;
28
+ const name = ts.isIdentifier(named) ? named.text : memberName(named);
29
+ return name !== undefined && /outcome$/iu.test(name) ? value.getText() : undefined;
30
+ }
31
+ function assertion(node, checker, bindings) {
32
+ const matcher = memberName(node.expression);
33
+ if (matcher === undefined || !["toBe", "toEqual", "toMatchObject"].includes(matcher)) {
34
+ return;
35
+ }
36
+ let root = receiver(node.expression);
37
+ const negative = root !== undefined && memberName(root) === "not";
38
+ if (negative && root !== undefined) {
39
+ root = receiver(root);
40
+ }
41
+ if (root === undefined || !ts.isCallExpression(root)) {
42
+ return;
43
+ }
44
+ const callee = memberName(root.expression) === "soft" ? receiver(root.expression) : root.expression;
45
+ const actual = root.arguments[0];
46
+ const expected = node.arguments[0];
47
+ const key = actual === undefined ? undefined : subject(actual, checker);
48
+ if (callee !== undefined
49
+ && imported(callee, "expect", ["vitest", "@effect/vitest"], bindings)
50
+ && key !== undefined
51
+ && expected !== undefined
52
+ && (!negative || matcher !== "toMatchObject")) {
53
+ return { expected, negative, node, subject: key };
54
+ }
55
+ return undefined;
56
+ }
57
+ function grouped(node, checker, bindings) {
58
+ const rows = node.arguments[0];
59
+ if (!imported(node.expression, "outcomes", ["@shivaedev/test-story/server/outcomes.ts"], bindings)
60
+ || rows === undefined
61
+ || !ts.isArrayLiteralExpression(rows)) {
62
+ return [];
63
+ }
64
+ const assertions = [];
65
+ for (const row of rows.elements) {
66
+ if (!ts.isArrayLiteralExpression(row)) {
67
+ continue;
68
+ }
69
+ const read = row.elements[1];
70
+ const expected = row.elements[2];
71
+ const key = read !== undefined && ts.isArrowFunction(read) && !ts.isBlock(read.body) ? subject(read.body, checker) : undefined;
72
+ if (key !== undefined && expected !== undefined) {
73
+ assertions.push({ expected, negative: false, node: row, subject: key });
74
+ }
75
+ }
76
+ return assertions;
77
+ }
78
+ export function outcomeAssertions(body, checker) {
79
+ const bindings = importBindings(body.getSourceFile());
80
+ const assertions = [];
81
+ function visit(node) {
82
+ if (ts.isFunctionLike(node) && node !== body) {
83
+ return;
84
+ }
85
+ if (ts.isCallExpression(node)) {
86
+ const direct = assertion(node, checker, bindings);
87
+ assertions.push(...(direct === undefined ? [] : [direct]), ...grouped(node, checker, bindings));
88
+ }
89
+ ts.forEachChild(node, visit);
90
+ }
91
+ visit(body);
92
+ return assertions;
93
+ }
94
+ //# sourceMappingURL=outcomeAssertions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"outcomeAssertions.js","sourceRoot":"","sources":["../../src/adapters/outcomeAssertions.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { Finding, SourceFile } from "#rule.ts";
2
+ import type { storyOrigins } from "#rules/stories/origins.ts";
3
+ export declare function positiveRefusalFindings(file: SourceFile, origins: ReturnType<typeof storyOrigins>): readonly Finding[];
4
+ //# sourceMappingURL=positiveRefusalFindings.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"positiveRefusalFindings.d.ts","sourceRoot":"","sources":["../../src/adapters/positiveRefusalFindings.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AA4B9D,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,GAAG,SAAS,OAAO,EAAE,CAqBtH"}
@@ -0,0 +1,41 @@
1
+ import ts from "typescript";
2
+ import { nodesWhere, unwrapped } from "#rules/stories/syntax.ts";
3
+ import { outcomeAssertions } from "./outcomeAssertions.js";
4
+ const MESSAGE = "Only rules out an outcome. Assert the expected refusal's domain reason or public response positively on the same outcome in this story; an unrelated failure must fail the story too.";
5
+ function concrete(node) {
6
+ const value = unwrapped(node);
7
+ return ((ts.isStringLiteralLike(value) && value.text.length > 0)
8
+ || (ts.isObjectLiteralExpression(value)
9
+ && value.properties.some((property) => ts.isPropertyAssignment(property) && concrete(property.initializer))));
10
+ }
11
+ function sameExpected(left, right) {
12
+ const a = unwrapped(left);
13
+ const b = unwrapped(right);
14
+ return ts.isStringLiteralLike(a) && ts.isStringLiteralLike(b) ? a.text === b.text : a.getText() === b.getText();
15
+ }
16
+ function confirmsRefusal(positive, negative) {
17
+ return (!positive.negative && positive.subject === negative.subject && concrete(positive.expected) && !sameExpected(positive.expected, negative.expected));
18
+ }
19
+ export function positiveRefusalFindings(file, origins) {
20
+ const source = origins.source(file.path);
21
+ if (source === undefined) {
22
+ return [];
23
+ }
24
+ return nodesWhere(source, (node) => ts.isCallExpression(node) && origins.origin(node.expression) === "story")
25
+ .filter(ts.isCallExpression)
26
+ .flatMap((story) => {
27
+ const body = story.arguments[2];
28
+ if (body === undefined) {
29
+ return [];
30
+ }
31
+ const assertions = outcomeAssertions(body, origins.checker);
32
+ return assertions
33
+ .filter((negative) => negative.negative && !assertions.some((positive) => confirmsRefusal(positive, negative)))
34
+ .map(({ node }) => ({
35
+ file: file.path,
36
+ line: source.getLineAndCharacterOfPosition(node.getStart(source)).line + 1,
37
+ message: MESSAGE,
38
+ }));
39
+ });
40
+ }
41
+ //# sourceMappingURL=positiveRefusalFindings.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"positiveRefusalFindings.js","sourceRoot":"","sources":["../../src/adapters/positiveRefusalFindings.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import { Effect } from "effect";
2
+ import type { Finding, RuleInputs } from "#rule.ts";
3
+ export declare const rpcBoundaryFindings: (inputs: RuleInputs) => Effect.Effect<Finding[], import("./ImportAnalysisFailure.ts").ImportAnalysisFailure, never>;
4
+ //# sourceMappingURL=rpcBoundaryFindings.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rpcBoundaryFindings.d.ts","sourceRoot":"","sources":["../../src/adapters/rpcBoundaryFindings.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AA4DpD,eAAO,MAAM,mBAAmB,qHAgC9B,CAAC"}
@@ -0,0 +1,90 @@
1
+ import { join } from "node:path";
2
+ import { Effect } from "effect";
3
+ import ts from "typescript";
4
+ import { importGraph } from "#imports/graph.ts";
5
+ import { isTestSupport } from "#naming/testName.ts";
6
+ import { effectProgram } from "#rules/effect/program.ts";
7
+ import { nodesWhere } from "#rules/stories/syntax.ts";
8
+ function boundaryName(declaration) {
9
+ if (declaration === undefined || !ts.isFunctionDeclaration(declaration)) {
10
+ return undefined;
11
+ }
12
+ const name = declaration.name?.text;
13
+ const path = declaration.getSourceFile().fileName.replaceAll("\\", "/");
14
+ return /\/(?:@shivaedev\/)?errors\/(?:src|dist)\/(?:boundary|rpcBoundaryHandlers)\.(?:d\.)?ts$/u.test(path)
15
+ && (name === "rpcBoundary" || name === "rpcBoundaryHandlers")
16
+ ? name
17
+ : undefined;
18
+ }
19
+ function handlerBuilder(declaration) {
20
+ if (declaration === undefined) {
21
+ return false;
22
+ }
23
+ const path = declaration.getSourceFile().fileName.replaceAll("\\", "/");
24
+ return (ts.isMethodSignature(declaration)
25
+ && ["toLayer", "toLayerHandler", "toHandlers", "of"].includes(declaration.name.getText())
26
+ && /\/effect\/(?:src|dist(?:\/dts)?)\/(?:unstable\/)?rpc\/RpcGroup\.(?:d\.)?ts$/u.test(path));
27
+ }
28
+ function checkSources(inputs) {
29
+ const program = effectProgram(inputs);
30
+ const checker = program.getTypeChecker();
31
+ return inputs.sources.flatMap((file) => {
32
+ const source = program.getSourceFile(join(inputs.root, file.path));
33
+ if (source === undefined) {
34
+ return [];
35
+ }
36
+ const calls = nodesWhere(source, ts.isCallExpression)
37
+ .filter(ts.isCallExpression)
38
+ .map((call) => ({ call, declaration: checker.getTypeAtLocation(call.expression).getCallSignatures()[0]?.getDeclaration() }));
39
+ if (calls.some(({ declaration }) => handlerBuilder(declaration))
40
+ || source.statements.some((statement) => ts.isFunctionDeclaration(statement) && boundaryName(statement) === "rpcBoundaryHandlers")) {
41
+ return [];
42
+ }
43
+ return calls.flatMap(({ call, declaration }) => {
44
+ const name = boundaryName(declaration);
45
+ return name === undefined
46
+ ? []
47
+ : [
48
+ {
49
+ file: file.path,
50
+ line: source.getLineAndCharacterOfPosition(call.getStart(source)).line + 1,
51
+ message: `Uses ${name} outside a module that builds RPC handlers. Move the boundary into the module calling the RPC group's toLayer, toLayerHandler, toHandlers or of; services must keep their own typed failures.`,
52
+ },
53
+ ];
54
+ });
55
+ });
56
+ }
57
+ export const rpcBoundaryFindings = Effect.fn("RpcBoundary.rpcBoundaryFindings")(function* (inputs) {
58
+ const candidates = new Set(inputs.sources.filter((source) => source.text.includes("rpcBoundary")).map((source) => source.path));
59
+ if (candidates.size === 0) {
60
+ return [];
61
+ }
62
+ const graph = yield* importGraph(inputs);
63
+ const importers = new Map();
64
+ for (const edge of graph.edges) {
65
+ if (edge.to.kind === "file" && !edge.type) {
66
+ const paths = importers.get(edge.to.path) ?? [];
67
+ paths.push(edge.from);
68
+ importers.set(edge.to.path, paths);
69
+ }
70
+ }
71
+ for (const path of candidates) {
72
+ for (const importer of importers.get(path) ?? []) {
73
+ candidates.add(importer);
74
+ }
75
+ }
76
+ return yield* Effect.sync(() => {
77
+ const groups = new Map();
78
+ for (const source of inputs.sources) {
79
+ if (isTestSupport(source.path) || !/\.[cm]?[jt]sx?$/u.test(source.path) || !candidates.has(source.path)) {
80
+ continue;
81
+ }
82
+ const group = /^(?:packages|examples)\/[^/]+/u.exec(source.path)?.[0] ?? ".";
83
+ const sources = groups.get(group) ?? [];
84
+ sources.push(source);
85
+ groups.set(group, sources);
86
+ }
87
+ return [...groups.values()].flatMap((sources) => checkSources({ ...inputs, sources }));
88
+ });
89
+ });
90
+ //# sourceMappingURL=rpcBoundaryFindings.js.map