@suss/adapter-ruby 0.27.0 → 0.29.0

package/dist/index.d.cts

@@ -214,7 +214,8 @@ type MethodLookup =
  * `cause` says why the search stopped, since a caller deciding
  * whether to look further needs more than the sentence: `unreadAncestor`
  * is a base whose file this run could not open, and `dynamicDefine`
- * is a body that calls `define_method`.
+ * is a `define_method` call that defines this name, or one whose own
+ * name this reader could not read.
  */
  | {
     type: "unsettled";
@@ -327,6 +328,8 @@ interface RbStoragePattern {
     baseClasses: string[];
     /** Methods that change what is stored. Anything else reads. */
     writes: string[];
+    /** Methods whose result is the model again: one record, or a relation a later read narrows to one. */
+    givesBack: string[];
     /** Which database is behind the connection, which the project settles. */
     storageSystem: "postgresql" | "mysql" | "sqlite";
 }
@@ -490,6 +493,10 @@ interface GraphqlObjectFields {
  * class that reaches that base is a database call. The README says why
  * ancestry. A loader pattern from another pack adds calls that are given
  * the model as an argument instead, and those go through the same test.
+ *
+ * A write is also recorded when the receiver is not written as a
+ * constant and the rules settle it on such a class, which is how
+ * `@account.save` after a `before_action` finder counts.
  */
 
 interface RbStorageOptions {
@@ -544,6 +551,8 @@ declare function discoverUnits(root: Node, options: DiscoveryOptions): Promise<R
 interface ConstantDefinition {
     readonly qualifiedName: string;
     readonly key: string;
+    /** `class`/`module` opens a constant every file may open again; `X = ...` sets one. */
+    readonly kind: "declaration" | "assignment";
 }
 /** A constant read somewhere, with the nesting it was read inside. */
 interface ConstantReference {
@@ -583,7 +592,7 @@ declare function nodeId(filePath: string, node: Node): string;
  * expression in hand and wants to ask the rules about it. `enclosing` is
  * the method the expression is written in, or null outside one.
  */
-declare function readKey(filePath: string, node: Node, enclosing: Node | null): string;
+declare function readKey(filePath: string, written: Node, enclosing: Node | null): string;
 /**
  * Walk a file and emit the value facts. A method is walked in its own right,
  * so a body's returns and calls belong to the method that wrote them.

package/dist/index.d.ts

@@ -214,7 +214,8 @@ type MethodLookup =
  * `cause` says why the search stopped, since a caller deciding
  * whether to look further needs more than the sentence: `unreadAncestor`
  * is a base whose file this run could not open, and `dynamicDefine`
- * is a body that calls `define_method`.
+ * is a `define_method` call that defines this name, or one whose own
+ * name this reader could not read.
  */
  | {
     type: "unsettled";
@@ -327,6 +328,8 @@ interface RbStoragePattern {
     baseClasses: string[];
     /** Methods that change what is stored. Anything else reads. */
     writes: string[];
+    /** Methods whose result is the model again: one record, or a relation a later read narrows to one. */
+    givesBack: string[];
     /** Which database is behind the connection, which the project settles. */
     storageSystem: "postgresql" | "mysql" | "sqlite";
 }
@@ -490,6 +493,10 @@ interface GraphqlObjectFields {
  * class that reaches that base is a database call. The README says why
  * ancestry. A loader pattern from another pack adds calls that are given
  * the model as an argument instead, and those go through the same test.
+ *
+ * A write is also recorded when the receiver is not written as a
+ * constant and the rules settle it on such a class, which is how
+ * `@account.save` after a `before_action` finder counts.
  */
 
 interface RbStorageOptions {
@@ -544,6 +551,8 @@ declare function discoverUnits(root: Node, options: DiscoveryOptions): Promise<R
 interface ConstantDefinition {
     readonly qualifiedName: string;
     readonly key: string;
+    /** `class`/`module` opens a constant every file may open again; `X = ...` sets one. */
+    readonly kind: "declaration" | "assignment";
 }
 /** A constant read somewhere, with the nesting it was read inside. */
 interface ConstantReference {
@@ -583,7 +592,7 @@ declare function nodeId(filePath: string, node: Node): string;
  * expression in hand and wants to ask the rules about it. `enclosing` is
  * the method the expression is written in, or null outside one.
  */
-declare function readKey(filePath: string, node: Node, enclosing: Node | null): string;
+declare function readKey(filePath: string, written: Node, enclosing: Node | null): string;
 /**
  * Walk a file and emit the value facts. A method is walked in its own right,
  * so a body's returns and calls belong to the method that wrote them.