@suss/ir-core 0.8.0 → 0.10.0

package/dist/index.js

@@ -9,6 +9,7 @@ import {
   GraphqlOperationSemanticsSchema,
   GraphqlResolverSemanticsSchema,
   MessageBusSemanticsSchema,
+  MetricSemanticsSchema,
   RestSemanticsSchema,
   RuntimeConfigSemanticsSchema,
   SemanticsSchema,
@@ -25,12 +26,33 @@ import {
   formatChannel,
   gqlIdentityKey,
   methodsAgree,
+  metricIdentityKey,
   normalizePath,
   parseChannel,
   routePathAdmits,
+  semconvMappingOf,
   typeDefinitionKey,
   withDefinitionsInlined
-} from "./chunk-WRRENYBR.js";
+} from "./chunk-HBAMPBAO.js";
+
+// src/semconv.ts
+function semconvAttributes(binding) {
+  const semantics = binding.semantics;
+  const attributes = {};
+  for (const [field, attribute] of Object.entries(
+    semconvMappingOf(binding.semantics)
+  )) {
+    const value = semantics[field];
+    if (typeof value !== "string") {
+      continue;
+    }
+    if (attribute.placeholderValues?.includes(value) === true) {
+      continue;
+    }
+    attributes[attribute.name] = value;
+  }
+  return attributes;
+}
 
 // src/boundaryKey.ts
 function boundaryKey(binding) {
@@ -84,29 +106,47 @@ function servesRequest(binding, method, path) {
   return serves(binding.semantics, method, path);
 }
 
-// src/codeScope.ts
-function codeScopePath(raw) {
-  return raw.trim().replace(/^\.\//, "").replace(/\/+$/, "");
-}
-function fileInCodeScope(file, scope) {
-  const prefix = codeScopePath(scope);
-  if (prefix === "" || prefix === ".") {
-    return true;
-  }
-  const path = codeScopePath(file);
-  return path === prefix || path.startsWith(`${prefix}/`);
-}
-
 // src/dispatch.ts
 function dispatchByType(table, value) {
   const handler = table[value.type];
   return handler(value);
 }
 
-// src/namePattern.ts
-var HOLE = /\{[^}]*\}/g;
+// src/boundaryName.ts
+var HOLE_SPLIT = /(\{[^}]*\})/;
 var SUB_TOKEN = /\$\{([^}]*)\}/g;
 var SUB_ESCAPE = /\$\{!/;
+function isHole(piece) {
+  return piece.startsWith("{") && piece.endsWith("}");
+}
+function parseBoundaryName(name) {
+  const parts = name.split(HOLE_SPLIT).filter((piece) => piece !== "").map(
+    (piece) => isHole(piece) ? { type: "hole", label: piece.slice(1, -1) } : { type: "text", text: piece }
+  );
+  const only = parts.length === 1 ? parts[0] : void 0;
+  if (only !== void 0 && only.type === "hole") {
+    return { type: "reference", path: only.label.split(".") };
+  }
+  if (parts.some((part) => part.type === "hole")) {
+    return { type: "pattern", parts };
+  }
+  return { type: "literal", value: name };
+}
+var partString = {
+  text: (part) => part.text,
+  hole: (part) => patternHole(part.label)
+};
+var nameString = {
+  literal: (name) => name.value,
+  pattern: (name) => name.parts.map((part) => dispatchByType(partString, part)).join(""),
+  reference: (name) => patternHole(name.path.join("."))
+};
+function boundaryNameString(name) {
+  return dispatchByType(nameString, name);
+}
+function patternHole(label) {
+  return `{${label}}`;
+}
 function namePatternFromSub(value) {
   if (Array.isArray(value)) {
     return typeof value[0] === "string" ? namePatternFromSub(value[0]) : null;
@@ -117,43 +157,101 @@ function namePatternFromSub(value) {
   if (SUB_ESCAPE.test(value)) {
     return null;
   }
-  return value.replace(SUB_TOKEN, (_whole, inner) => `{${inner}}`);
+  return value.replace(
+    SUB_TOKEN,
+    (_whole, inner) => patternHole(inner)
+  );
 }
 function namesNothing(name) {
-  return /^\{[^}]*\}$/.test(name);
+  return parseBoundaryName(name).type === "reference";
 }
 function hasNameHole(name) {
-  HOLE.lastIndex = 0;
-  return HOLE.test(name);
+  return parseBoundaryName(name).type !== "literal";
 }
 function namePatternKey(name) {
-  return name.replace(HOLE, "{}");
+  return dispatchByType(
+    {
+      literal: (parsed) => parsed.value,
+      pattern: (parsed) => boundaryNameString({
+        type: "pattern",
+        parts: parsed.parts.map(
+          (part) => part.type === "hole" ? { type: "hole", label: "" } : part
+        )
+      }),
+      reference: () => patternHole("")
+    },
+    parseBoundaryName(name)
+  );
+}
+function fixedTextLength(name) {
+  return dispatchByType(
+    {
+      literal: (parsed) => parsed.value.length,
+      pattern: (parsed) => parsed.parts.reduce(
+        (total, part) => total + (part.type === "text" ? part.text.length : 0),
+        0
+      ),
+      reference: () => 0
+    },
+    parseBoundaryName(name)
+  );
+}
+function quote(text) {
+  return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function admits(pattern, name) {
-  const source = pattern.split(/(\{[^}]*\})/).map(
-    (part) => part.startsWith("{") && part.endsWith("}") ? ".+" : part.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")
-  ).join("");
+  const source = pattern.parts.map((part) => part.type === "hole" ? ".+" : quote(part.text)).join("");
   return new RegExp(`^${source}$`).test(name);
 }
 function namesAgree(a, b) {
-  if (namesNothing(a) || namesNothing(b)) {
+  const left = parseBoundaryName(a);
+  const right = parseBoundaryName(b);
+  if (left.type === "reference" || right.type === "reference") {
     return false;
   }
-  if (a === b) {
-    return true;
-  }
-  const aHasHole = hasNameHole(a);
-  const bHasHole = hasNameHole(b);
-  if (aHasHole && bHasHole) {
+  if (left.type === "pattern" && right.type === "pattern") {
     return namePatternKey(a) === namePatternKey(b);
   }
-  if (aHasHole) {
-    return admits(a, b);
+  if (left.type === "pattern") {
+    return admits(left, b);
   }
-  if (bHasHole) {
-    return admits(b, a);
+  if (right.type === "pattern") {
+    return admits(right, a);
   }
-  return false;
+  return a === b;
+}
+function referenceName(reference) {
+  const path = [reference.root, ...reference.fields];
+  if (path.some((part) => part === "")) {
+    return null;
+  }
+  return boundaryNameString({ type: "reference", path });
+}
+function referenceOf(name) {
+  if (name.type !== "reference") {
+    return null;
+  }
+  const root = name.path[0];
+  if (root === void 0 || name.path.some((part) => part === "")) {
+    return null;
+  }
+  return { root, fields: name.path.slice(1) };
+}
+function referenceFromName(name) {
+  return referenceOf(parseBoundaryName(name));
+}
+
+// src/codeScope.ts
+function codeScopePath(raw) {
+  return raw.trim().replace(/^\.\//, "").replace(/\/+$/, "");
+}
+function fileInCodeScope(file, scope) {
+  const prefix = codeScopePath(scope);
+  if (prefix === "" || prefix === ".") {
+    return true;
+  }
+  const path = codeScopePath(file);
+  return path === prefix || path.startsWith(`${prefix}/`);
 }
 
 // src/suppressions.ts
@@ -520,6 +618,17 @@ function messageBusBinding(opts) {
     recognition: opts.recognition
   };
 }
+function metricBinding(opts) {
+  return {
+    transport: opts.metricSystem,
+    semantics: {
+      name: "metric",
+      metricSystem: opts.metricSystem,
+      metricType: namedOrNull(opts.metricType, "metric type")
+    },
+    recognition: opts.recognition
+  };
+}
 export {
   BoundaryBindingSchema,
   ConfidenceInfoSchema,
@@ -531,6 +640,7 @@ export {
   GraphqlOperationSemanticsSchema,
   GraphqlResolverSemanticsSchema,
   MessageBusSemanticsSchema,
+  MetricSemanticsSchema,
   RestSemanticsSchema,
   RuntimeConfigSemanticsSchema,
   SemanticsSchema,
@@ -543,6 +653,7 @@ export {
   bodyShapesMatch,
   boundaryKey,
   boundaryLabel,
+  boundaryNameString,
   busIdentityKey,
   busesAgree,
   canPair,
@@ -554,6 +665,7 @@ export {
   ecsContainerInstanceName,
   exchangesHttpResponses,
   fileInCodeScope,
+  fixedTextLength,
   fnIdentityKey,
   formatChannel,
   functionCallBinding,
@@ -564,6 +676,8 @@ export {
   isGraphqlOperationBinding,
   messageBusBinding,
   methodsAgree,
+  metricBinding,
+  metricIdentityKey,
   namePatternFromSub,
   namePatternKey,
   namesAgree,
@@ -572,13 +686,19 @@ export {
   normalizeRuleBoundary,
   packageExportBinding,
   pairingKey,
+  parseBoundaryName,
   parseChannel,
+  patternHole,
+  referenceFromName,
+  referenceName,
+  referenceOf,
   reportsUnpairedItself,
   restBinding,
   routePathAdmits,
   ruleBoundaryMatchesKey,
   runtimeConfigBinding,
   semanticsAgree,
+  semconvAttributes,
   servesRequest,
   storageBinding,
   typeDefinitionKey,

package/dist/{schemas-BLS4PXwc.d.cts → schemas-CGR6qjFf.d.cts}

@@ -62,8 +62,8 @@ type GraphqlResolverSemantics = z.infer<typeof GraphqlResolverSemanticsSchema>;
 declare const MessageBusSemanticsSchema: z.ZodObject<{
     name: z.ZodLiteral<"message-bus">;
     messageBus: z.ZodEnum<{
-        sqs: "sqs";
-        sns: "sns";
+        aws_sqs: "aws_sqs";
+        "aws.sns": "aws.sns";
         s3: "s3";
         eventbridge: "eventbridge";
         bullmq: "bullmq";
@@ -139,8 +139,8 @@ declare const SemanticsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
     name: z.ZodLiteral<"message-bus">;
     messageBus: z.ZodEnum<{
-        sqs: "sqs";
-        sns: "sns";
+        aws_sqs: "aws_sqs";
+        "aws.sns": "aws.sns";
         s3: "s3";
         eventbridge: "eventbridge";
         bullmq: "bullmq";
@@ -151,6 +151,10 @@ declare const SemanticsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         "cloudflare-tail": "cloudflare-tail";
     }>;
     channel: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    name: z.ZodLiteral<"metric">;
+    metricSystem: z.ZodString;
+    metricType: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>], "name">;
 type Semantics = z.infer<typeof SemanticsSchema>;
 
@@ -334,8 +338,8 @@ declare const BoundaryBindingSchema: z.ZodObject<{
     }, z.core.$strip>, z.ZodObject<{
         name: z.ZodLiteral<"message-bus">;
         messageBus: z.ZodEnum<{
-            sqs: "sqs";
-            sns: "sns";
+            aws_sqs: "aws_sqs";
+            "aws.sns": "aws.sns";
             s3: "s3";
             eventbridge: "eventbridge";
             bullmq: "bullmq";
@@ -346,6 +350,10 @@ declare const BoundaryBindingSchema: z.ZodObject<{
             "cloudflare-tail": "cloudflare-tail";
         }>;
         channel: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        name: z.ZodLiteral<"metric">;
+        metricSystem: z.ZodString;
+        metricType: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>], "name">;
     recognition: z.ZodString;
 }, z.core.$strip>;

package/dist/{schemas-BLS4PXwc.d.ts → schemas-CGR6qjFf.d.ts}

@@ -62,8 +62,8 @@ type GraphqlResolverSemantics = z.infer<typeof GraphqlResolverSemanticsSchema>;
 declare const MessageBusSemanticsSchema: z.ZodObject<{
     name: z.ZodLiteral<"message-bus">;
     messageBus: z.ZodEnum<{
-        sqs: "sqs";
-        sns: "sns";
+        aws_sqs: "aws_sqs";
+        "aws.sns": "aws.sns";
         s3: "s3";
         eventbridge: "eventbridge";
         bullmq: "bullmq";
@@ -139,8 +139,8 @@ declare const SemanticsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
     name: z.ZodLiteral<"message-bus">;
     messageBus: z.ZodEnum<{
-        sqs: "sqs";
-        sns: "sns";
+        aws_sqs: "aws_sqs";
+        "aws.sns": "aws.sns";
         s3: "s3";
         eventbridge: "eventbridge";
         bullmq: "bullmq";
@@ -151,6 +151,10 @@ declare const SemanticsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         "cloudflare-tail": "cloudflare-tail";
     }>;
     channel: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    name: z.ZodLiteral<"metric">;
+    metricSystem: z.ZodString;
+    metricType: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>], "name">;
 type Semantics = z.infer<typeof SemanticsSchema>;
 
@@ -334,8 +338,8 @@ declare const BoundaryBindingSchema: z.ZodObject<{
     }, z.core.$strip>, z.ZodObject<{
         name: z.ZodLiteral<"message-bus">;
         messageBus: z.ZodEnum<{
-            sqs: "sqs";
-            sns: "sns";
+            aws_sqs: "aws_sqs";
+            "aws.sns": "aws.sns";
             s3: "s3";
             eventbridge: "eventbridge";
             bullmq: "bullmq";
@@ -346,6 +350,10 @@ declare const BoundaryBindingSchema: z.ZodObject<{
             "cloudflare-tail": "cloudflare-tail";
         }>;
         channel: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        name: z.ZodLiteral<"metric">;
+        metricSystem: z.ZodString;
+        metricType: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>], "name">;
     recognition: z.ZodString;
 }, z.core.$strip>;