@suss/adapter-ruby 0.5.9 → 0.5.11

package/dist/index.cjs

@@ -15296,7 +15296,16 @@ function date4(params) {
 // ../../../node_modules/zod/v4/classic/external.js
 config(en_default());
 
-// ../../ir-core/dist/chunk-5KE7OWN3.js
+// ../../ir-core/dist/chunk-WKR5SU4N.js
+function gqlIdentityKey(typeName, fieldName) {
+  return `gql:${typeName}.${fieldName}`;
+}
+function fnIdentityKey(packageName, exportPath) {
+  return `fn:${packageName}::${exportPath.join(".")}`;
+}
+function busIdentityKey(messageBus, subject) {
+  return `bus:${messageBus} ${subject}`;
+}
 function defineBoundarySemantics(definition) {
   return definition;
 }
@@ -15338,6 +15347,12 @@ var functionCallSemantics = defineBoundarySemantics({
     /** A call returns a value, which is not a status and a body. */
     exchangesHttpResponses: false,
     reportsUnpairedItself: false,
+    /**
+     * In-repo units (components, bare handlers) are keyless by design
+     * and pair through call edges rather than the keyed pass, so a
+     * missing key is not a boundary nothing can reach.
+     */
+    canPair: () => true,
     /**
      * `"fn:<package>::<exportPath>"` when both are set. Other in-process
      * function-call units, such as components and bare handlers inside
@@ -15345,7 +15360,7 @@ var functionCallSemantics = defineBoundarySemantics({
      */
     identityKey(semantics) {
       if (semantics.package !== void 0 && semantics.exportPath !== void 0 && semantics.exportPath.length > 0) {
-        return `fn:${semantics.package}::${semantics.exportPath.join(".")}`;
+        return fnIdentityKey(semantics.package, semantics.exportPath);
       }
       return null;
     }
@@ -15368,6 +15383,8 @@ var graphqlOperationSemantics = defineBoundarySemantics({
     exchangesHttpResponses: false,
     reportsUnpairedItself: false,
     identityKey: () => null,
+    /** Keyless by design; the dedicated pass pairs it by its document. */
+    canPair: () => true,
     /** "query GetUser". The contract checker pairs it, the key does not. */
     displayLabel(semantics) {
       return `${semantics.operationType} ${semantics.operationName ?? "<anonymous>"}`;
@@ -15401,7 +15418,7 @@ var graphqlResolverSemantics = defineBoundarySemantics({
       if (semantics.typeName === null || semantics.fieldName === "") {
         return null;
       }
-      return `gql:${semantics.typeName}.${semantics.fieldName}`;
+      return gqlIdentityKey(semantics.typeName, semantics.fieldName);
     }
   }
 });
@@ -15450,6 +15467,12 @@ var messageBusSemantics = defineBoundarySemantics({
      * ones, so the generic unmatched lists leave them alone.
      */
     reportsUnpairedItself: true,
+    /**
+     * A channel unnamed here can still pair: the dedicated pass
+     * collapses env chains before comparing, so a consumer whose
+     * channel arrives at runtime meets the template that declares it.
+     */
+    canPair: () => true,
     /**
      * `"bus:<messageBus> <subject>"`, or null when the channel is null
      * or its subject is empty.
@@ -15472,7 +15495,7 @@ var messageBusSemantics = defineBoundarySemantics({
       if (subject === "") {
         return null;
       }
-      return `bus:${semantics.messageBus} ${subject}`;
+      return busIdentityKey(semantics.messageBus, subject);
     },
     sidesAgree(a, b) {
       if (a.channel === null || b.channel === null) {
@@ -15650,8 +15673,13 @@ var StorageRelationalSemanticsSchema = external_exports.object({
    * and a monorepo with several schemas gives each one its own value.
    */
   scope: external_exports.string(),
-  /** The table or model name, as declared in the schema. */
-  table: external_exports.string()
+  /**
+   * The table or model name as the schema declares it, or null when
+   * the source states one this reader could not settle. A null table
+   * pairs with nothing, rather than with whatever its source text
+   * happens to spell.
+   */
+  table: external_exports.string().nullable()
 });
 var storageRelationalSemantics = defineBoundarySemantics({
   name: "storage-relational",
@@ -15810,6 +15838,14 @@ var SuppressionFileSchema = external_exports.object({
   version: external_exports.literal(1),
   rules: external_exports.array(SuppressionRuleSchema)
 }).strict();
+function namedOrNull(value, field2) {
+  if (value === "") {
+    throw new Error(
+      `${field2} is an empty string; write null when the source does not name it`
+    );
+  }
+  return value;
+}
 function storageRelationalBinding(opts) {
   return {
     transport: opts.storageSystem,
@@ -15817,7 +15853,7 @@ function storageRelationalBinding(opts) {
       name: "storage-relational",
       storageSystem: opts.storageSystem,
       scope: opts.scope,
-      table: opts.table
+      table: namedOrNull(opts.table, "storage table")
     },
     recognition: opts.recognition
   };
@@ -16338,7 +16374,40 @@ function readClassContract(ancestry, pattern) {
     handler(readCallArgs(field(statement, "arguments")), scope, pattern, out);
   }
   const returnType = out.typeCallShape ?? (Object.keys(out.fieldProperties).length > 0 ? { type: "record", properties: out.fieldProperties } : null);
-  return returnType === null ? null : { returnType, args: [...out.args.values()] };
+  if (returnType === null) {
+    return null;
+  }
+  const args = [...out.args.values()];
+  const wrapping = pattern.argumentWrapping;
+  if (wrapping !== void 0 && ancestryReaches(ancestry, wrapping)) {
+    return {
+      returnType,
+      args: [wrapInputArgument(args, wrapping)],
+      methodArgs: args
+    };
+  }
+  return { returnType, args };
+}
+function ancestryReaches(ancestry, wrapping) {
+  return ancestry.some((entry) => entry.name === wrapping.ancestorClassName);
+}
+function wrapInputArgument(args, wrapping) {
+  const properties = {};
+  for (const arg of args) {
+    properties[arg.name] = arg.required ? arg.type : optionalShape(arg.type);
+  }
+  for (const [name, extra] of Object.entries(wrapping.extraFields)) {
+    properties[name] = extra.required ? extra.type : optionalShape(extra.type);
+  }
+  return {
+    name: wrapping.argumentName,
+    type: { type: "record", properties },
+    required: true,
+    typeText: null
+  };
+}
+function optionalShape(shape) {
+  return { type: "union", variants: [shape, { type: "undefined" }] };
 }
 function resolvedName(symbol2, callArgs, pattern) {
   const override = callArgs.keyword[pattern.camelizeKeyword];
@@ -16353,14 +16422,12 @@ function toCamelCase(name) {
   ].join("");
 }
 function buildFieldUnit(pack, typeName, decl, filePath) {
-  const parameters = (decl.contract?.args ?? []).map(
-    (arg, position) => ({
-      name: arg.name,
-      position,
-      role: "args",
-      typeText: arg.typeText
-    })
-  );
+  const parameters = (decl.contract?.methodArgs ?? decl.contract?.args ?? []).map((arg, position) => ({
+    name: arg.name,
+    position,
+    role: "args",
+    typeText: arg.typeText
+  }));
   const graphqlDeclaredContract = decl.contract !== null ? {
     returnType: decl.contract.returnType,
     args: decl.contract.args.map((a) => ({

package/dist/index.d.cts

@@ -202,6 +202,23 @@ interface GraphqlObjectFields {
     /** Module prefixes the same scalars can also be written under when someone spells out the full path. */
     scalarNamePrefixes: string[];
     typeNameConvention: GraphqlTypeNameConvention;
+    /**
+     * A base class that changes a mutation's wire contract. When a wired
+     * class's ancestry reaches `ancestorClassName`, the library wraps
+     * every declared argument into one input-object argument called
+     * `argumentName` and adds `extraFields` to it. graphql-ruby's
+     * RelayClassicMutation is the class this describes: on the wire the
+     * mutation takes a single required `input`, whose fields are the
+     * declared arguments plus an optional `clientMutationId`.
+     */
+    argumentWrapping?: {
+        ancestorClassName: string;
+        argumentName: string;
+        extraFields: Record<string, {
+            type: TypeShape;
+            required: boolean;
+        }>;
+    };
 }
 
 interface RbStorageOptions {

package/dist/index.d.ts

@@ -202,6 +202,23 @@ interface GraphqlObjectFields {
     /** Module prefixes the same scalars can also be written under when someone spells out the full path. */
     scalarNamePrefixes: string[];
     typeNameConvention: GraphqlTypeNameConvention;
+    /**
+     * A base class that changes a mutation's wire contract. When a wired
+     * class's ancestry reaches `ancestorClassName`, the library wraps
+     * every declared argument into one input-object argument called
+     * `argumentName` and adds `extraFields` to it. graphql-ruby's
+     * RelayClassicMutation is the class this describes: on the wire the
+     * mutation takes a single required `input`, whose fields are the
+     * declared arguments plus an optional `clientMutationId`.
+     */
+    argumentWrapping?: {
+        ancestorClassName: string;
+        argumentName: string;
+        extraFields: Record<string, {
+            type: TypeShape;
+            required: boolean;
+        }>;
+    };
 }
 
 interface RbStorageOptions {

package/dist/index.js

@@ -15245,7 +15245,16 @@ function date4(params) {
 // ../../../node_modules/zod/v4/classic/external.js
 config(en_default());
 
-// ../../ir-core/dist/chunk-5KE7OWN3.js
+// ../../ir-core/dist/chunk-WKR5SU4N.js
+function gqlIdentityKey(typeName, fieldName) {
+  return `gql:${typeName}.${fieldName}`;
+}
+function fnIdentityKey(packageName, exportPath) {
+  return `fn:${packageName}::${exportPath.join(".")}`;
+}
+function busIdentityKey(messageBus, subject) {
+  return `bus:${messageBus} ${subject}`;
+}
 function defineBoundarySemantics(definition) {
   return definition;
 }
@@ -15287,6 +15296,12 @@ var functionCallSemantics = defineBoundarySemantics({
     /** A call returns a value, which is not a status and a body. */
     exchangesHttpResponses: false,
     reportsUnpairedItself: false,
+    /**
+     * In-repo units (components, bare handlers) are keyless by design
+     * and pair through call edges rather than the keyed pass, so a
+     * missing key is not a boundary nothing can reach.
+     */
+    canPair: () => true,
     /**
      * `"fn:<package>::<exportPath>"` when both are set. Other in-process
      * function-call units, such as components and bare handlers inside
@@ -15294,7 +15309,7 @@ var functionCallSemantics = defineBoundarySemantics({
      */
     identityKey(semantics) {
       if (semantics.package !== void 0 && semantics.exportPath !== void 0 && semantics.exportPath.length > 0) {
-        return `fn:${semantics.package}::${semantics.exportPath.join(".")}`;
+        return fnIdentityKey(semantics.package, semantics.exportPath);
       }
       return null;
     }
@@ -15317,6 +15332,8 @@ var graphqlOperationSemantics = defineBoundarySemantics({
     exchangesHttpResponses: false,
     reportsUnpairedItself: false,
     identityKey: () => null,
+    /** Keyless by design; the dedicated pass pairs it by its document. */
+    canPair: () => true,
     /** "query GetUser". The contract checker pairs it, the key does not. */
     displayLabel(semantics) {
       return `${semantics.operationType} ${semantics.operationName ?? "<anonymous>"}`;
@@ -15350,7 +15367,7 @@ var graphqlResolverSemantics = defineBoundarySemantics({
       if (semantics.typeName === null || semantics.fieldName === "") {
         return null;
       }
-      return `gql:${semantics.typeName}.${semantics.fieldName}`;
+      return gqlIdentityKey(semantics.typeName, semantics.fieldName);
     }
   }
 });
@@ -15399,6 +15416,12 @@ var messageBusSemantics = defineBoundarySemantics({
      * ones, so the generic unmatched lists leave them alone.
      */
     reportsUnpairedItself: true,
+    /**
+     * A channel unnamed here can still pair: the dedicated pass
+     * collapses env chains before comparing, so a consumer whose
+     * channel arrives at runtime meets the template that declares it.
+     */
+    canPair: () => true,
     /**
      * `"bus:<messageBus> <subject>"`, or null when the channel is null
      * or its subject is empty.
@@ -15421,7 +15444,7 @@ var messageBusSemantics = defineBoundarySemantics({
       if (subject === "") {
         return null;
       }
-      return `bus:${semantics.messageBus} ${subject}`;
+      return busIdentityKey(semantics.messageBus, subject);
     },
     sidesAgree(a, b) {
       if (a.channel === null || b.channel === null) {
@@ -15599,8 +15622,13 @@ var StorageRelationalSemanticsSchema = external_exports.object({
    * and a monorepo with several schemas gives each one its own value.
    */
   scope: external_exports.string(),
-  /** The table or model name, as declared in the schema. */
-  table: external_exports.string()
+  /**
+   * The table or model name as the schema declares it, or null when
+   * the source states one this reader could not settle. A null table
+   * pairs with nothing, rather than with whatever its source text
+   * happens to spell.
+   */
+  table: external_exports.string().nullable()
 });
 var storageRelationalSemantics = defineBoundarySemantics({
   name: "storage-relational",
@@ -15759,6 +15787,14 @@ var SuppressionFileSchema = external_exports.object({
   version: external_exports.literal(1),
   rules: external_exports.array(SuppressionRuleSchema)
 }).strict();
+function namedOrNull(value, field2) {
+  if (value === "") {
+    throw new Error(
+      `${field2} is an empty string; write null when the source does not name it`
+    );
+  }
+  return value;
+}
 function storageRelationalBinding(opts) {
   return {
     transport: opts.storageSystem,
@@ -15766,7 +15802,7 @@ function storageRelationalBinding(opts) {
       name: "storage-relational",
       storageSystem: opts.storageSystem,
       scope: opts.scope,
-      table: opts.table
+      table: namedOrNull(opts.table, "storage table")
     },
     recognition: opts.recognition
   };
@@ -16287,7 +16323,40 @@ function readClassContract(ancestry, pattern) {
     handler(readCallArgs(field(statement, "arguments")), scope, pattern, out);
   }
   const returnType = out.typeCallShape ?? (Object.keys(out.fieldProperties).length > 0 ? { type: "record", properties: out.fieldProperties } : null);
-  return returnType === null ? null : { returnType, args: [...out.args.values()] };
+  if (returnType === null) {
+    return null;
+  }
+  const args = [...out.args.values()];
+  const wrapping = pattern.argumentWrapping;
+  if (wrapping !== void 0 && ancestryReaches(ancestry, wrapping)) {
+    return {
+      returnType,
+      args: [wrapInputArgument(args, wrapping)],
+      methodArgs: args
+    };
+  }
+  return { returnType, args };
+}
+function ancestryReaches(ancestry, wrapping) {
+  return ancestry.some((entry) => entry.name === wrapping.ancestorClassName);
+}
+function wrapInputArgument(args, wrapping) {
+  const properties = {};
+  for (const arg of args) {
+    properties[arg.name] = arg.required ? arg.type : optionalShape(arg.type);
+  }
+  for (const [name, extra] of Object.entries(wrapping.extraFields)) {
+    properties[name] = extra.required ? extra.type : optionalShape(extra.type);
+  }
+  return {
+    name: wrapping.argumentName,
+    type: { type: "record", properties },
+    required: true,
+    typeText: null
+  };
+}
+function optionalShape(shape) {
+  return { type: "union", variants: [shape, { type: "undefined" }] };
 }
 function resolvedName(symbol2, callArgs, pattern) {
   const override = callArgs.keyword[pattern.camelizeKeyword];
@@ -16302,14 +16371,12 @@ function toCamelCase(name) {
   ].join("");
 }
 function buildFieldUnit(pack, typeName, decl, filePath) {
-  const parameters = (decl.contract?.args ?? []).map(
-    (arg, position) => ({
-      name: arg.name,
-      position,
-      role: "args",
-      typeText: arg.typeText
-    })
-  );
+  const parameters = (decl.contract?.methodArgs ?? decl.contract?.args ?? []).map((arg, position) => ({
+    name: arg.name,
+    position,
+    role: "args",
+    typeText: arg.typeText
+  }));
   const graphqlDeclaredContract = decl.contract !== null ? {
     returnType: decl.contract.returnType,
     args: decl.contract.args.map((a) => ({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@suss/adapter-ruby",
-  "version": "0.5.9",
+  "version": "0.5.11",
   "type": "module",
   "description": "Ruby language adapter for suss, parsing source with tree-sitter (WASM), resolving constant nesting with a lexical binder, and emitting raw extractions for the suss pipeline.",
   "keywords": [
@@ -47,9 +47,9 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@suss/behavioral-ir": "0.5.9",
-    "@suss/datalog": "0.5.9",
-    "@suss/extractor": "0.5.9",
+    "@suss/behavioral-ir": "0.5.11",
+    "@suss/datalog": "0.5.11",
+    "@suss/extractor": "0.5.11",
     "web-tree-sitter": "^0.26.11"
   },
   "devDependencies": {