@suss/ir-core 0.35.1 → 0.36.0

package/dist/{chunk-A46EUIKC.js → chunk-7IOGU4OC.js}

@@ -1464,7 +1464,21 @@ var SourceLocationSchema = z13.object({
    * project's `suss.json` gives it. Set only when the project lists its
    * modules, and then on every unit whose file is under a module's root.
    */
-  module: z13.string().optional()
+  module: z13.string().optional(),
+  /**
+   * The git repository the extract ran in. Summaries from several
+   * repositories can share a folder, and two of them can both have
+   * `src/index.ts::handler`; this says which one each came from, and
+   * which commit, so a link opens the file that was read. `path` is
+   * where `file` is measured from, relative to the repository's top.
+   * Absent outside a repository.
+   */
+  repository: z13.object({
+    name: z13.string(),
+    path: z13.string(),
+    remote: z13.string().optional(),
+    commit: z13.string().optional()
+  }).optional()
 });
 var BoundaryBindingSchema = z13.object({
   transport: z13.string(),

package/dist/index.cjs

@@ -1608,7 +1608,21 @@ var SourceLocationSchema = import_zod13.z.object({
    * project's `suss.json` gives it. Set only when the project lists its
    * modules, and then on every unit whose file is under a module's root.
    */
-  module: import_zod13.z.string().optional()
+  module: import_zod13.z.string().optional(),
+  /**
+   * The git repository the extract ran in. Summaries from several
+   * repositories can share a folder, and two of them can both have
+   * `src/index.ts::handler`; this says which one each came from, and
+   * which commit, so a link opens the file that was read. `path` is
+   * where `file` is measured from, relative to the repository's top.
+   * Absent outside a repository.
+   */
+  repository: import_zod13.z.object({
+    name: import_zod13.z.string(),
+    path: import_zod13.z.string(),
+    remote: import_zod13.z.string().optional(),
+    commit: import_zod13.z.string().optional()
+  }).optional()
 });
 var BoundaryBindingSchema = import_zod13.z.object({
   transport: import_zod13.z.string(),
@@ -1888,15 +1902,27 @@ function fileInCodeScope(file, scope) {
   const path = codeScopePath(file);
   return path === prefix || path.startsWith(`${prefix}/`);
 }
-function parseHandler(handler) {
+function parseHandler(handler, runtime) {
   const trimmed = handler.trim();
-  const lastDot = trimmed.lastIndexOf(".");
-  if (lastDot <= 0 || lastDot === trimmed.length - 1) {
+  return HANDLER_SPLITS[handlerSpelling(trimmed, runtime)](trimmed);
+}
+function handlerSpelling(handler, runtime) {
+  if (runtime !== void 0) {
+    return runtime.trim().toLowerCase().startsWith("ruby") ? "ruby" : "lastDot";
+  }
+  return handler.includes("::") ? "ruby" : "lastDot";
+}
+var HANDLER_SPLITS = {
+  lastDot: (handler) => splitAt(handler, handler.lastIndexOf(".")),
+  ruby: (handler) => splitAt(handler, handler.indexOf(".", handler.lastIndexOf("/") + 1))
+};
+function splitAt(handler, dot) {
+  if (dot <= 0 || dot === handler.length - 1) {
     return null;
   }
   return {
-    modulePath: trimmed.slice(0, lastDot),
-    exportName: trimmed.slice(lastDot + 1)
+    modulePath: handler.slice(0, dot),
+    exportName: handler.slice(dot + 1)
   };
 }
 

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { T as TypeShape, M as MessageBusSemantics, D as DeployableUnit, S as Semantics, B as BoundaryBindingSchema, C as ConfidenceInfoSchema, a as ConfidenceLevelSchema, b as ConfidenceSourceSchema, c as CorroborationSchema, d as SourceLocationSchema, e as MessageBusTechnology } from './schemas-lfg8kvak.cjs';
-export { f as DeployableUnitSchema, E as EVERY_FIELD, F as FunctionCallSemantics, g as FunctionCallSemanticsSchema, G as GraphqlOperationSemantics, h as GraphqlOperationSemanticsSchema, i as GraphqlResolverSemantics, j as GraphqlResolverSemanticsSchema, k as MessageBusSemanticsSchema, R as RestSemantics, l as RestSemanticsSchema, m as RuntimeConfigSemantics, n as RuntimeConfigSemanticsSchema, o as SemanticsSchema, p as StorageSemantics, q as StorageSemanticsSchema, r as TypeShapeSchema, s as ecsContainerInstanceName, t as isModuleName, u as methodsAgree, v as normalizePath, w as pathShape, x as routePathAdmits, y as routePathsMeet, z as storageContainerLabel, A as storageLabel, H as storageSystemLabel, I as typeDefinitionKey, J as withDefinitionsInlined } from './schemas-lfg8kvak.cjs';
+import { T as TypeShape, M as MessageBusSemantics, D as DeployableUnit, S as Semantics, B as BoundaryBindingSchema, C as ConfidenceInfoSchema, a as ConfidenceLevelSchema, b as ConfidenceSourceSchema, c as CorroborationSchema, d as SourceLocationSchema, e as MessageBusTechnology } from './schemas-D-cxOSiQ.cjs';
+export { f as DeployableUnitSchema, E as EVERY_FIELD, F as FunctionCallSemantics, g as FunctionCallSemanticsSchema, G as GraphqlOperationSemantics, h as GraphqlOperationSemanticsSchema, i as GraphqlResolverSemantics, j as GraphqlResolverSemanticsSchema, k as MessageBusSemanticsSchema, R as RestSemantics, l as RestSemanticsSchema, m as RuntimeConfigSemantics, n as RuntimeConfigSemanticsSchema, o as SemanticsSchema, p as StorageSemantics, q as StorageSemanticsSchema, r as TypeShapeSchema, s as ecsContainerInstanceName, t as isModuleName, u as methodsAgree, v as normalizePath, w as pathShape, x as routePathAdmits, y as routePathsMeet, z as storageContainerLabel, A as storageLabel, H as storageSystemLabel, I as typeDefinitionKey, J as withDefinitionsInlined } from './schemas-D-cxOSiQ.cjs';
 
 /**
  * The boundary-name syntax, parsed and printed in one place.
@@ -493,6 +493,14 @@ interface PackConfiguration {
      * not say.
      */
     readFromProject?: (projectRoot: string) => Record<string, unknown> | null;
+    /**
+     * The options whose value is a file or directory path, either one
+     * string or a list of them. A relative one is read against the config
+     * file, so a file kept outside the project points somewhere else. The
+     * CLI reports each path where nothing exists, instead of letting the
+     * pack look up classes in a directory that is not there.
+     */
+    paths?: readonly string[];
 }
 interface PackDeclaration {
     /**
@@ -761,15 +769,28 @@ declare function codeScopePath(raw: string): string;
 declare function fileInCodeScope(file: string, scope: string): boolean;
 interface ParsedHandler {
     modulePath: string;
+    /**
+     * The function the platform calls, written the way the module's
+     * language writes it: `handler`, or `Billing::Handler.process` for a
+     * class method in Ruby.
+     */
     exportName: string;
 }
 /**
- * Split a handler string into its module path and exported symbol.
- * The final dot separates them: `"src/handlers/confirmToken.handler"` →
+ * Split a handler string into its module path and the function the
+ * platform calls. Most runtimes put the function after the final dot:
+ * `"src/handlers/confirmToken.handler"` gives
  * `{ modulePath: "src/handlers/confirmToken", exportName: "handler" }`.
+ *
+ * Ruby writes `file.method` or `file.Class.method`, and the class can be
+ * namespaced, as in `app.Billing::Handler.process`. A Ruby file name has
+ * no dot, so the module ends at the first dot. The runtime, when the
+ * manifest gives one, says which language wrote the handler; without
+ * one, a `::` marks a Ruby class.
+ *
  * Returns null when there's no dot, since there's no export to bind to.
  */
-declare function parseHandler(handler: string): ParsedHandler | null;
+declare function parseHandler(handler: string, runtime?: string): ParsedHandler | null;
 
 /**
  * Dispatch on a discriminated union through a mapped-type Record, so a

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { T as TypeShape, M as MessageBusSemantics, D as DeployableUnit, S as Semantics, B as BoundaryBindingSchema, C as ConfidenceInfoSchema, a as ConfidenceLevelSchema, b as ConfidenceSourceSchema, c as CorroborationSchema, d as SourceLocationSchema, e as MessageBusTechnology } from './schemas-lfg8kvak.js';
-export { f as DeployableUnitSchema, E as EVERY_FIELD, F as FunctionCallSemantics, g as FunctionCallSemanticsSchema, G as GraphqlOperationSemantics, h as GraphqlOperationSemanticsSchema, i as GraphqlResolverSemantics, j as GraphqlResolverSemanticsSchema, k as MessageBusSemanticsSchema, R as RestSemantics, l as RestSemanticsSchema, m as RuntimeConfigSemantics, n as RuntimeConfigSemanticsSchema, o as SemanticsSchema, p as StorageSemantics, q as StorageSemanticsSchema, r as TypeShapeSchema, s as ecsContainerInstanceName, t as isModuleName, u as methodsAgree, v as normalizePath, w as pathShape, x as routePathAdmits, y as routePathsMeet, z as storageContainerLabel, A as storageLabel, H as storageSystemLabel, I as typeDefinitionKey, J as withDefinitionsInlined } from './schemas-lfg8kvak.js';
+import { T as TypeShape, M as MessageBusSemantics, D as DeployableUnit, S as Semantics, B as BoundaryBindingSchema, C as ConfidenceInfoSchema, a as ConfidenceLevelSchema, b as ConfidenceSourceSchema, c as CorroborationSchema, d as SourceLocationSchema, e as MessageBusTechnology } from './schemas-D-cxOSiQ.js';
+export { f as DeployableUnitSchema, E as EVERY_FIELD, F as FunctionCallSemantics, g as FunctionCallSemanticsSchema, G as GraphqlOperationSemantics, h as GraphqlOperationSemanticsSchema, i as GraphqlResolverSemantics, j as GraphqlResolverSemanticsSchema, k as MessageBusSemanticsSchema, R as RestSemantics, l as RestSemanticsSchema, m as RuntimeConfigSemantics, n as RuntimeConfigSemanticsSchema, o as SemanticsSchema, p as StorageSemantics, q as StorageSemanticsSchema, r as TypeShapeSchema, s as ecsContainerInstanceName, t as isModuleName, u as methodsAgree, v as normalizePath, w as pathShape, x as routePathAdmits, y as routePathsMeet, z as storageContainerLabel, A as storageLabel, H as storageSystemLabel, I as typeDefinitionKey, J as withDefinitionsInlined } from './schemas-D-cxOSiQ.js';
 
 /**
  * The boundary-name syntax, parsed and printed in one place.
@@ -493,6 +493,14 @@ interface PackConfiguration {
      * not say.
      */
     readFromProject?: (projectRoot: string) => Record<string, unknown> | null;
+    /**
+     * The options whose value is a file or directory path, either one
+     * string or a list of them. A relative one is read against the config
+     * file, so a file kept outside the project points somewhere else. The
+     * CLI reports each path where nothing exists, instead of letting the
+     * pack look up classes in a directory that is not there.
+     */
+    paths?: readonly string[];
 }
 interface PackDeclaration {
     /**
@@ -761,15 +769,28 @@ declare function codeScopePath(raw: string): string;
 declare function fileInCodeScope(file: string, scope: string): boolean;
 interface ParsedHandler {
     modulePath: string;
+    /**
+     * The function the platform calls, written the way the module's
+     * language writes it: `handler`, or `Billing::Handler.process` for a
+     * class method in Ruby.
+     */
     exportName: string;
 }
 /**
- * Split a handler string into its module path and exported symbol.
- * The final dot separates them: `"src/handlers/confirmToken.handler"` →
+ * Split a handler string into its module path and the function the
+ * platform calls. Most runtimes put the function after the final dot:
+ * `"src/handlers/confirmToken.handler"` gives
  * `{ modulePath: "src/handlers/confirmToken", exportName: "handler" }`.
+ *
+ * Ruby writes `file.method` or `file.Class.method`, and the class can be
+ * namespaced, as in `app.Billing::Handler.process`. A Ruby file name has
+ * no dot, so the module ends at the first dot. The runtime, when the
+ * manifest gives one, says which language wrote the handler; without
+ * one, a `::` marks a Ruby class.
+ *
  * Returns null when there's no dot, since there's no export to bind to.
  */
-declare function parseHandler(handler: string): ParsedHandler | null;
+declare function parseHandler(handler: string, runtime?: string): ParsedHandler | null;
 
 /**
  * Dispatch on a discriminated union through a mapped-type Record, so a

package/dist/index.js

@@ -63,7 +63,7 @@ import {
   typeDefinitionKey,
   unitIdentityKey,
   withDefinitionsInlined
-} from "./chunk-A46EUIKC.js";
+} from "./chunk-7IOGU4OC.js";
 
 // src/semconv.ts
 function semconvAttributes(binding) {
@@ -261,15 +261,27 @@ function fileInCodeScope(file, scope) {
   const path = codeScopePath(file);
   return path === prefix || path.startsWith(`${prefix}/`);
 }
-function parseHandler(handler) {
+function parseHandler(handler, runtime) {
   const trimmed = handler.trim();
-  const lastDot = trimmed.lastIndexOf(".");
-  if (lastDot <= 0 || lastDot === trimmed.length - 1) {
+  return HANDLER_SPLITS[handlerSpelling(trimmed, runtime)](trimmed);
+}
+function handlerSpelling(handler, runtime) {
+  if (runtime !== void 0) {
+    return runtime.trim().toLowerCase().startsWith("ruby") ? "ruby" : "lastDot";
+  }
+  return handler.includes("::") ? "ruby" : "lastDot";
+}
+var HANDLER_SPLITS = {
+  lastDot: (handler) => splitAt(handler, handler.lastIndexOf(".")),
+  ruby: (handler) => splitAt(handler, handler.indexOf(".", handler.lastIndexOf("/") + 1))
+};
+function splitAt(handler, dot) {
+  if (dot <= 0 || dot === handler.length - 1) {
     return null;
   }
   return {
-    modulePath: trimmed.slice(0, lastDot),
-    exportName: trimmed.slice(lastDot + 1)
+    modulePath: handler.slice(0, dot),
+    exportName: handler.slice(dot + 1)
   };
 }
 

package/dist/{schemas-lfg8kvak.d.cts → schemas-D-cxOSiQ.d.cts}

@@ -365,6 +365,12 @@ declare const SourceLocationSchema: z.ZodObject<{
     exportName: z.ZodNullable<z.ZodString>;
     workspace: z.ZodOptional<z.ZodString>;
     module: z.ZodOptional<z.ZodString>;
+    repository: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        path: z.ZodString;
+        remote: z.ZodOptional<z.ZodString>;
+        commit: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 declare const BoundaryBindingSchema: z.ZodObject<{
     transport: z.ZodString;

package/dist/{schemas-lfg8kvak.d.ts → schemas-D-cxOSiQ.d.ts}

@@ -365,6 +365,12 @@ declare const SourceLocationSchema: z.ZodObject<{
     exportName: z.ZodNullable<z.ZodString>;
     workspace: z.ZodOptional<z.ZodString>;
     module: z.ZodOptional<z.ZodString>;
+    repository: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        path: z.ZodString;
+        remote: z.ZodOptional<z.ZodString>;
+        commit: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 declare const BoundaryBindingSchema: z.ZodObject<{
     transport: z.ZodString;

package/dist/schemas.cjs

@@ -1360,7 +1360,21 @@ var SourceLocationSchema = import_zod13.z.object({
    * project's `suss.json` gives it. Set only when the project lists its
    * modules, and then on every unit whose file is under a module's root.
    */
-  module: import_zod13.z.string().optional()
+  module: import_zod13.z.string().optional(),
+  /**
+   * The git repository the extract ran in. Summaries from several
+   * repositories can share a folder, and two of them can both have
+   * `src/index.ts::handler`; this says which one each came from, and
+   * which commit, so a link opens the file that was read. `path` is
+   * where `file` is measured from, relative to the repository's top.
+   * Absent outside a repository.
+   */
+  repository: import_zod13.z.object({
+    name: import_zod13.z.string(),
+    path: import_zod13.z.string(),
+    remote: import_zod13.z.string().optional(),
+    commit: import_zod13.z.string().optional()
+  }).optional()
 });
 var BoundaryBindingSchema = import_zod13.z.object({
   transport: import_zod13.z.string(),

package/dist/schemas.d.cts

@@ -1,2 +1,2 @@
 import 'zod';
-export { B as BoundaryBindingSchema, C as ConfidenceInfoSchema, a as ConfidenceLevelSchema, b as ConfidenceSourceSchema, c as CorroborationSchema, f as DeployableUnitSchema, g as FunctionCallSemanticsSchema, h as GraphqlOperationSemanticsSchema, j as GraphqlResolverSemanticsSchema, k as MessageBusSemanticsSchema, l as RestSemanticsSchema, n as RuntimeConfigSemanticsSchema, o as SemanticsSchema, d as SourceLocationSchema, q as StorageSemanticsSchema, T as TypeShape, r as TypeShapeSchema, I as typeDefinitionKey, J as withDefinitionsInlined } from './schemas-lfg8kvak.cjs';
+export { B as BoundaryBindingSchema, C as ConfidenceInfoSchema, a as ConfidenceLevelSchema, b as ConfidenceSourceSchema, c as CorroborationSchema, f as DeployableUnitSchema, g as FunctionCallSemanticsSchema, h as GraphqlOperationSemanticsSchema, j as GraphqlResolverSemanticsSchema, k as MessageBusSemanticsSchema, l as RestSemanticsSchema, n as RuntimeConfigSemanticsSchema, o as SemanticsSchema, d as SourceLocationSchema, q as StorageSemanticsSchema, T as TypeShape, r as TypeShapeSchema, I as typeDefinitionKey, J as withDefinitionsInlined } from './schemas-D-cxOSiQ.cjs';

package/dist/schemas.d.ts

@@ -1,2 +1,2 @@
 import 'zod';
-export { B as BoundaryBindingSchema, C as ConfidenceInfoSchema, a as ConfidenceLevelSchema, b as ConfidenceSourceSchema, c as CorroborationSchema, f as DeployableUnitSchema, g as FunctionCallSemanticsSchema, h as GraphqlOperationSemanticsSchema, j as GraphqlResolverSemanticsSchema, k as MessageBusSemanticsSchema, l as RestSemanticsSchema, n as RuntimeConfigSemanticsSchema, o as SemanticsSchema, d as SourceLocationSchema, q as StorageSemanticsSchema, T as TypeShape, r as TypeShapeSchema, I as typeDefinitionKey, J as withDefinitionsInlined } from './schemas-lfg8kvak.js';
+export { B as BoundaryBindingSchema, C as ConfidenceInfoSchema, a as ConfidenceLevelSchema, b as ConfidenceSourceSchema, c as CorroborationSchema, f as DeployableUnitSchema, g as FunctionCallSemanticsSchema, h as GraphqlOperationSemanticsSchema, j as GraphqlResolverSemanticsSchema, k as MessageBusSemanticsSchema, l as RestSemanticsSchema, n as RuntimeConfigSemanticsSchema, o as SemanticsSchema, d as SourceLocationSchema, q as StorageSemanticsSchema, T as TypeShape, r as TypeShapeSchema, I as typeDefinitionKey, J as withDefinitionsInlined } from './schemas-D-cxOSiQ.js';

package/dist/schemas.js

@@ -17,7 +17,7 @@ import {
   TypeShapeSchema,
   typeDefinitionKey,
   withDefinitionsInlined
-} from "./chunk-A46EUIKC.js";
+} from "./chunk-7IOGU4OC.js";
 export {
   BoundaryBindingSchema,
   ConfidenceInfoSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@suss/ir-core",
-  "version": "0.35.1",
+  "version": "0.36.0",
   "type": "module",
   "description": "The type primitives every suss summary is built from: type shapes, boundary bindings, source locations and confidence.",
   "keywords": [