@suss/ir-core 0.7.2 → 0.9.0

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { T as TypeShape, M as MessageBusSemantics, 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-D6hKT-zV.cjs';
-export { D as DeployableUnit, f as DeployableUnitSchema, 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 methodsAgree, u as normalizePath, v as routePathAdmits, w as typeDefinitionKey, x as withDefinitionsInlined } from './schemas-D6hKT-zV.cjs';
+import { T as TypeShape, M as MessageBusSemantics, S as Semantics, B as BoundaryBindingSchema, C as ConfidenceInfoSchema, a as ConfidenceLevelSchema, b as ConfidenceSourceSchema, c as CorroborationSchema, d as SourceLocationSchema, e as MessageBusTechnology, D as DeployableUnit } from './schemas-CGR6qjFf.cjs';
+export { f as DeployableUnitSchema, 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 methodsAgree, u as normalizePath, v as routePathAdmits, w as typeDefinitionKey, x as withDefinitionsInlined } from './schemas-CGR6qjFf.cjs';
 
 /**
  * Comparing two TypeShapes structurally.
@@ -49,8 +49,33 @@ declare function bodyShapesMatch(actual: TypeShape, declared: TypeShape): MatchR
  * because a published summary has to mean the same thing to a reader
  * who never installed the pack that wrote it. If a pack needs a
  * protocol nobody has defined yet, add a module here.
+ *
+ * A protocol also says which of its words come from OpenTelemetry's
+ * semantic conventions, in `semconv`. The README says why that
+ * matters and where it stops.
  */
 
+/** One identity field written as an OpenTelemetry attribute. */
+interface SemconvAttribute {
+    /** The attribute name, as the semantic conventions spell it. */
+    name: string;
+    /**
+     * Values suss writes where the source named none. A span never says
+     * them, so the projection leaves the attribute off rather than
+     * emitting a string that could only ever mismatch.
+     */
+    placeholderValues?: readonly string[];
+}
+/**
+ * Which identity fields the semantic conventions have an attribute
+ * for. A field is absent when they have no attribute for it, or when
+ * our value is our own string rather than the one a span gets.
+ */
+type SemconvMapping<S extends {
+    name: string;
+}> = {
+    readonly [K in Exclude<keyof S, "name">]?: SemconvAttribute;
+};
 /**
  * How one semantics variant keys its boundaries and pairs them up. Each
  * variant fills this in inside its own module, and nothing else in the
@@ -123,6 +148,11 @@ interface BoundarySemanticsDefinition<Z extends z.ZodType<{
     name: z.infer<Z>["name"];
     schema: Z;
     behavior: BoundaryBehavior<z.infer<Z>>;
+    /**
+     * Every protocol declares this, empty included, so that adding one
+     * means deciding where its words come from.
+     */
+    semconv: SemconvMapping<z.infer<Z>>;
 }
 
 declare const IdentityKeyBrand: unique symbol;
@@ -141,6 +171,39 @@ type BusIdentityKey = `bus:${MessageBusSemantics["messageBus"]} ${string}` & {
     readonly [IdentityKeyBrand]: "bus";
 };
 declare function busIdentityKey(messageBus: MessageBusSemantics["messageBus"], subject: string): BusIdentityKey;
+/** `metric:system type`, the key both sides of a metric pair on. */
+type MetricIdentityKey = `metric:${string} ${string}` & {
+    readonly [IdentityKeyBrand]: "metric";
+};
+declare function metricIdentityKey(metricSystem: string, metricType: string): MetricIdentityKey;
+
+declare const MetricSemanticsSchema: z.ZodObject<{
+    name: z.ZodLiteral<"metric">;
+    metricSystem: z.ZodString;
+    metricType: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+type MetricSemantics = z.infer<typeof MetricSemanticsSchema>;
+
+/**
+ * A boundary binding read as OpenTelemetry attributes.
+ *
+ * A summary says what a unit can reach and a span says what it did
+ * reach. Joining the two means both sides spelling the boundary the
+ * same way, so suss writes the value a span gets wherever the semantic
+ * conventions have a word for it, and this projection puts those
+ * values under the attributes a trace store already indexes.
+ *
+ * Which fields those are is each protocol's own declaration, in its
+ * module under `semantics/`. Nothing here knows about any protocol.
+ */
+
+/**
+ * The attributes a boundary states, by name. A field the source never
+ * gave, a placeholder, and a field the conventions have no attribute
+ * for are all left out, so every pair here compares byte for byte
+ * against the same attribute on a span.
+ */
+declare function semconvAttributes(binding: BoundaryBinding): Record<string, string>;
 
 /**
  * Keys for a boundary binding, and whether two of them agree. Every
@@ -269,12 +332,13 @@ declare function dispatchByType<T extends {
  * a template writes `!Sub "${StageName}-orders-v1"` and the code writes
  * `` `${stage}-orders-v1` ``. Neither side states a string, both agree
  * about the fixed text, and each spells the parameter its own way. So a
- * name is written here as fixed text with `{}` holes, the way a REST
- * path is written with `{id}`, and two names agree when their fixed
- * parts line up.
+ * name is written here as fixed text with `{}` holes, and two names
+ * agree when their fixed parts line up.
  *
- * A hole covers a whole parameter rather than one path segment,
- * because a name has no separator that every project agrees on.
+ * A hole covers a whole parameter rather than one piece of a name,
+ * because a name has no separator every project agrees on. Two
+ * patterns that both cover one name are told apart by how much fixed
+ * text each states, rather than by narrowing what a hole can cover.
  */
 /**
  * The name a CloudFormation `Fn::Sub` value states. The array form
@@ -297,6 +361,8 @@ declare function hasNameHole(name: string): boolean;
  * token, since the two sides pick their own name for the parameter.
  */
 declare function namePatternKey(name: string): string;
+/** How much of a name the writer stated rather than left for deploy time. */
+declare function fixedTextLength(name: string): number;
 /**
  * Whether two names are the same name. Two patterns agree when their
  * fixed parts line up, since a hole on one side meets a hole on the
@@ -515,7 +581,7 @@ declare function isGraphqlOperationBinding(binding: BoundaryBinding | null | und
  */
 declare function runtimeConfigBinding(opts: {
     recognition: string;
-    deploymentTarget: "lambda" | "ecs-task" | "container" | "k8s-deployment";
+    deploymentTarget: DeployableUnit["deploymentTarget"];
     instanceName: string;
 }): BoundaryBinding;
 /**
@@ -545,5 +611,15 @@ declare function messageBusBinding(opts: {
     /** Null when this source does not say which channel. */
     channel: string | null;
 }): BoundaryBinding;
+/**
+ * Build a metric binding, the boundary between whatever declares a
+ * named series of measurements and whatever reads it back by that name.
+ */
+declare function metricBinding(opts: {
+    recognition: string;
+    metricSystem: string;
+    /** Null when this source states a metric it could not name. */
+    metricType: string | null;
+}): BoundaryBinding;
 
-export { type BoundaryBehavior, type BoundaryBinding, BoundaryBindingSchema, type BoundarySemanticsDefinition, type BusIdentityKey, type Channel, type ConfidenceInfo, ConfidenceInfoSchema, type ConfidenceLevel, ConfidenceLevelSchema, type ConfidenceSource, ConfidenceSourceSchema, type Corroboration, CorroborationSchema, type DispatchTable, type FindingSuppression, type FnIdentityKey, type GqlIdentityKey, type MatchResult, MessageBusSemantics, MessageBusTechnology, type ParsedChannel, Semantics, type SourceLocation, SourceLocationSchema, type SuppressableSeverity, type SuppressibleFinding, type SuppressionFile, SuppressionFileSchema, type SuppressionRule, SuppressionRuleSchema, TypeShape, applySuppressionsToFindings, bodyShapesMatch, boundaryKey, boundaryLabel, busIdentityKey, busesAgree, canPair, channelsPair, codeScopePath, countsForThreshold, dispatchByType, displayLabel, exchangesHttpResponses, fileInCodeScope, fnIdentityKey, formatChannel, functionCallBinding, gqlIdentityKey, graphqlOperationBinding, graphqlResolverBinding, hasNameHole, isGraphqlOperationBinding, messageBusBinding, namePatternFromSub, namePatternKey, namesAgree, namesNothing, normalizeRuleBoundary, packageExportBinding, pairingKey, parseChannel, reportsUnpairedItself, restBinding, ruleBoundaryMatchesKey, runtimeConfigBinding, semanticsAgree, servesRequest, storageBinding, validateRule };
+export { type BoundaryBehavior, type BoundaryBinding, BoundaryBindingSchema, type BoundarySemanticsDefinition, type BusIdentityKey, type Channel, type ConfidenceInfo, ConfidenceInfoSchema, type ConfidenceLevel, ConfidenceLevelSchema, type ConfidenceSource, ConfidenceSourceSchema, type Corroboration, CorroborationSchema, DeployableUnit, type DispatchTable, type FindingSuppression, type FnIdentityKey, type GqlIdentityKey, type MatchResult, MessageBusSemantics, MessageBusTechnology, type MetricIdentityKey, type MetricSemantics, MetricSemanticsSchema, type ParsedChannel, Semantics, type SemconvAttribute, type SemconvMapping, type SourceLocation, SourceLocationSchema, type SuppressableSeverity, type SuppressibleFinding, type SuppressionFile, SuppressionFileSchema, type SuppressionRule, SuppressionRuleSchema, TypeShape, applySuppressionsToFindings, bodyShapesMatch, boundaryKey, boundaryLabel, busIdentityKey, busesAgree, canPair, channelsPair, codeScopePath, countsForThreshold, dispatchByType, displayLabel, exchangesHttpResponses, fileInCodeScope, fixedTextLength, fnIdentityKey, formatChannel, functionCallBinding, gqlIdentityKey, graphqlOperationBinding, graphqlResolverBinding, hasNameHole, isGraphqlOperationBinding, messageBusBinding, metricBinding, metricIdentityKey, namePatternFromSub, namePatternKey, namesAgree, namesNothing, normalizeRuleBoundary, packageExportBinding, pairingKey, parseChannel, reportsUnpairedItself, restBinding, ruleBoundaryMatchesKey, runtimeConfigBinding, semanticsAgree, semconvAttributes, servesRequest, storageBinding, validateRule };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { T as TypeShape, M as MessageBusSemantics, 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-D6hKT-zV.js';
-export { D as DeployableUnit, f as DeployableUnitSchema, 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 methodsAgree, u as normalizePath, v as routePathAdmits, w as typeDefinitionKey, x as withDefinitionsInlined } from './schemas-D6hKT-zV.js';
+import { T as TypeShape, M as MessageBusSemantics, S as Semantics, B as BoundaryBindingSchema, C as ConfidenceInfoSchema, a as ConfidenceLevelSchema, b as ConfidenceSourceSchema, c as CorroborationSchema, d as SourceLocationSchema, e as MessageBusTechnology, D as DeployableUnit } from './schemas-CGR6qjFf.js';
+export { f as DeployableUnitSchema, 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 methodsAgree, u as normalizePath, v as routePathAdmits, w as typeDefinitionKey, x as withDefinitionsInlined } from './schemas-CGR6qjFf.js';
 
 /**
  * Comparing two TypeShapes structurally.
@@ -49,8 +49,33 @@ declare function bodyShapesMatch(actual: TypeShape, declared: TypeShape): MatchR
  * because a published summary has to mean the same thing to a reader
  * who never installed the pack that wrote it. If a pack needs a
  * protocol nobody has defined yet, add a module here.
+ *
+ * A protocol also says which of its words come from OpenTelemetry's
+ * semantic conventions, in `semconv`. The README says why that
+ * matters and where it stops.
  */
 
+/** One identity field written as an OpenTelemetry attribute. */
+interface SemconvAttribute {
+    /** The attribute name, as the semantic conventions spell it. */
+    name: string;
+    /**
+     * Values suss writes where the source named none. A span never says
+     * them, so the projection leaves the attribute off rather than
+     * emitting a string that could only ever mismatch.
+     */
+    placeholderValues?: readonly string[];
+}
+/**
+ * Which identity fields the semantic conventions have an attribute
+ * for. A field is absent when they have no attribute for it, or when
+ * our value is our own string rather than the one a span gets.
+ */
+type SemconvMapping<S extends {
+    name: string;
+}> = {
+    readonly [K in Exclude<keyof S, "name">]?: SemconvAttribute;
+};
 /**
  * How one semantics variant keys its boundaries and pairs them up. Each
  * variant fills this in inside its own module, and nothing else in the
@@ -123,6 +148,11 @@ interface BoundarySemanticsDefinition<Z extends z.ZodType<{
     name: z.infer<Z>["name"];
     schema: Z;
     behavior: BoundaryBehavior<z.infer<Z>>;
+    /**
+     * Every protocol declares this, empty included, so that adding one
+     * means deciding where its words come from.
+     */
+    semconv: SemconvMapping<z.infer<Z>>;
 }
 
 declare const IdentityKeyBrand: unique symbol;
@@ -141,6 +171,39 @@ type BusIdentityKey = `bus:${MessageBusSemantics["messageBus"]} ${string}` & {
     readonly [IdentityKeyBrand]: "bus";
 };
 declare function busIdentityKey(messageBus: MessageBusSemantics["messageBus"], subject: string): BusIdentityKey;
+/** `metric:system type`, the key both sides of a metric pair on. */
+type MetricIdentityKey = `metric:${string} ${string}` & {
+    readonly [IdentityKeyBrand]: "metric";
+};
+declare function metricIdentityKey(metricSystem: string, metricType: string): MetricIdentityKey;
+
+declare const MetricSemanticsSchema: z.ZodObject<{
+    name: z.ZodLiteral<"metric">;
+    metricSystem: z.ZodString;
+    metricType: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+type MetricSemantics = z.infer<typeof MetricSemanticsSchema>;
+
+/**
+ * A boundary binding read as OpenTelemetry attributes.
+ *
+ * A summary says what a unit can reach and a span says what it did
+ * reach. Joining the two means both sides spelling the boundary the
+ * same way, so suss writes the value a span gets wherever the semantic
+ * conventions have a word for it, and this projection puts those
+ * values under the attributes a trace store already indexes.
+ *
+ * Which fields those are is each protocol's own declaration, in its
+ * module under `semantics/`. Nothing here knows about any protocol.
+ */
+
+/**
+ * The attributes a boundary states, by name. A field the source never
+ * gave, a placeholder, and a field the conventions have no attribute
+ * for are all left out, so every pair here compares byte for byte
+ * against the same attribute on a span.
+ */
+declare function semconvAttributes(binding: BoundaryBinding): Record<string, string>;
 
 /**
  * Keys for a boundary binding, and whether two of them agree. Every
@@ -269,12 +332,13 @@ declare function dispatchByType<T extends {
  * a template writes `!Sub "${StageName}-orders-v1"` and the code writes
  * `` `${stage}-orders-v1` ``. Neither side states a string, both agree
  * about the fixed text, and each spells the parameter its own way. So a
- * name is written here as fixed text with `{}` holes, the way a REST
- * path is written with `{id}`, and two names agree when their fixed
- * parts line up.
+ * name is written here as fixed text with `{}` holes, and two names
+ * agree when their fixed parts line up.
  *
- * A hole covers a whole parameter rather than one path segment,
- * because a name has no separator that every project agrees on.
+ * A hole covers a whole parameter rather than one piece of a name,
+ * because a name has no separator every project agrees on. Two
+ * patterns that both cover one name are told apart by how much fixed
+ * text each states, rather than by narrowing what a hole can cover.
  */
 /**
  * The name a CloudFormation `Fn::Sub` value states. The array form
@@ -297,6 +361,8 @@ declare function hasNameHole(name: string): boolean;
  * token, since the two sides pick their own name for the parameter.
  */
 declare function namePatternKey(name: string): string;
+/** How much of a name the writer stated rather than left for deploy time. */
+declare function fixedTextLength(name: string): number;
 /**
  * Whether two names are the same name. Two patterns agree when their
  * fixed parts line up, since a hole on one side meets a hole on the
@@ -515,7 +581,7 @@ declare function isGraphqlOperationBinding(binding: BoundaryBinding | null | und
  */
 declare function runtimeConfigBinding(opts: {
     recognition: string;
-    deploymentTarget: "lambda" | "ecs-task" | "container" | "k8s-deployment";
+    deploymentTarget: DeployableUnit["deploymentTarget"];
     instanceName: string;
 }): BoundaryBinding;
 /**
@@ -545,5 +611,15 @@ declare function messageBusBinding(opts: {
     /** Null when this source does not say which channel. */
     channel: string | null;
 }): BoundaryBinding;
+/**
+ * Build a metric binding, the boundary between whatever declares a
+ * named series of measurements and whatever reads it back by that name.
+ */
+declare function metricBinding(opts: {
+    recognition: string;
+    metricSystem: string;
+    /** Null when this source states a metric it could not name. */
+    metricType: string | null;
+}): BoundaryBinding;
 
-export { type BoundaryBehavior, type BoundaryBinding, BoundaryBindingSchema, type BoundarySemanticsDefinition, type BusIdentityKey, type Channel, type ConfidenceInfo, ConfidenceInfoSchema, type ConfidenceLevel, ConfidenceLevelSchema, type ConfidenceSource, ConfidenceSourceSchema, type Corroboration, CorroborationSchema, type DispatchTable, type FindingSuppression, type FnIdentityKey, type GqlIdentityKey, type MatchResult, MessageBusSemantics, MessageBusTechnology, type ParsedChannel, Semantics, type SourceLocation, SourceLocationSchema, type SuppressableSeverity, type SuppressibleFinding, type SuppressionFile, SuppressionFileSchema, type SuppressionRule, SuppressionRuleSchema, TypeShape, applySuppressionsToFindings, bodyShapesMatch, boundaryKey, boundaryLabel, busIdentityKey, busesAgree, canPair, channelsPair, codeScopePath, countsForThreshold, dispatchByType, displayLabel, exchangesHttpResponses, fileInCodeScope, fnIdentityKey, formatChannel, functionCallBinding, gqlIdentityKey, graphqlOperationBinding, graphqlResolverBinding, hasNameHole, isGraphqlOperationBinding, messageBusBinding, namePatternFromSub, namePatternKey, namesAgree, namesNothing, normalizeRuleBoundary, packageExportBinding, pairingKey, parseChannel, reportsUnpairedItself, restBinding, ruleBoundaryMatchesKey, runtimeConfigBinding, semanticsAgree, servesRequest, storageBinding, validateRule };
+export { type BoundaryBehavior, type BoundaryBinding, BoundaryBindingSchema, type BoundarySemanticsDefinition, type BusIdentityKey, type Channel, type ConfidenceInfo, ConfidenceInfoSchema, type ConfidenceLevel, ConfidenceLevelSchema, type ConfidenceSource, ConfidenceSourceSchema, type Corroboration, CorroborationSchema, DeployableUnit, type DispatchTable, type FindingSuppression, type FnIdentityKey, type GqlIdentityKey, type MatchResult, MessageBusSemantics, MessageBusTechnology, type MetricIdentityKey, type MetricSemantics, MetricSemanticsSchema, type ParsedChannel, Semantics, type SemconvAttribute, type SemconvMapping, type SourceLocation, SourceLocationSchema, type SuppressableSeverity, type SuppressibleFinding, type SuppressionFile, SuppressionFileSchema, type SuppressionRule, SuppressionRuleSchema, TypeShape, applySuppressionsToFindings, bodyShapesMatch, boundaryKey, boundaryLabel, busIdentityKey, busesAgree, canPair, channelsPair, codeScopePath, countsForThreshold, dispatchByType, displayLabel, exchangesHttpResponses, fileInCodeScope, fixedTextLength, fnIdentityKey, formatChannel, functionCallBinding, gqlIdentityKey, graphqlOperationBinding, graphqlResolverBinding, hasNameHole, isGraphqlOperationBinding, messageBusBinding, metricBinding, metricIdentityKey, namePatternFromSub, namePatternKey, namesAgree, namesNothing, normalizeRuleBoundary, packageExportBinding, pairingKey, parseChannel, reportsUnpairedItself, restBinding, ruleBoundaryMatchesKey, runtimeConfigBinding, semanticsAgree, semconvAttributes, servesRequest, storageBinding, validateRule };

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-TEXSN75M.js";
+} from "./chunk-XUXN6DIX.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) {
@@ -129,9 +151,22 @@ function hasNameHole(name) {
 function namePatternKey(name) {
   return name.replace(HOLE, "{}");
 }
+function fixedTextLength(name) {
+  return name.replace(HOLE, "").length;
+}
+function isHole(part) {
+  return part.startsWith("{") && part.endsWith("}");
+}
+function quote(text) {
+  return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function holeSource(_following) {
+  return ".+";
+}
 function admits(pattern, name) {
-  const source = pattern.split(/(\{[^}]*\})/).map(
-    (part) => part.startsWith("{") && part.endsWith("}") ? ".+" : part.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")
+  const parts = pattern.split(/(\{[^}]*\})/);
+  const source = parts.map(
+    (part, index) => isHole(part) ? holeSource(parts[index + 1] ?? "") : quote(part)
   ).join("");
   return new RegExp(`^${source}$`).test(name);
 }
@@ -520,6 +555,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 +577,7 @@ export {
   GraphqlOperationSemanticsSchema,
   GraphqlResolverSemanticsSchema,
   MessageBusSemanticsSchema,
+  MetricSemanticsSchema,
   RestSemanticsSchema,
   RuntimeConfigSemanticsSchema,
   SemanticsSchema,
@@ -554,6 +601,7 @@ export {
   ecsContainerInstanceName,
   exchangesHttpResponses,
   fileInCodeScope,
+  fixedTextLength,
   fnIdentityKey,
   formatChannel,
   functionCallBinding,
@@ -564,6 +612,8 @@ export {
   isGraphqlOperationBinding,
   messageBusBinding,
   methodsAgree,
+  metricBinding,
+  metricIdentityKey,
   namePatternFromSub,
   namePatternKey,
   namesAgree,
@@ -579,6 +629,7 @@ export {
   ruleBoundaryMatchesKey,
   runtimeConfigBinding,
   semanticsAgree,
+  semconvAttributes,
   servesRequest,
   storageBinding,
   typeDefinitionKey,

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

@@ -2,13 +2,15 @@ import { z } from 'zod';
 
 /**
  * One thing that gets deployed and runs on its own: a Lambda function,
- * an ECS task's container, a plain container, or a k8s deployment.
+ * an ECS task's container, a plain container, a k8s deployment, or an
+ * edge worker.
  */
 
 /**
  * `instanceName` is the stable identifier the deployment medium uses:
  * the CFN logical resource id for Lambda and ECS, the deployment name
- * for k8s, the container name for a plain container.
+ * for k8s, the container name for a plain container, and the script
+ * name for an edge worker.
  */
 declare const DeployableUnitSchema: z.ZodObject<{
     deploymentTarget: z.ZodEnum<{
@@ -16,6 +18,7 @@ declare const DeployableUnitSchema: z.ZodObject<{
         "ecs-task": "ecs-task";
         container: "container";
         "k8s-deployment": "k8s-deployment";
+        worker: "worker";
     }>;
     instanceName: z.ZodString;
 }, z.core.$strip>;
@@ -59,13 +62,16 @@ 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";
         kafka: "kafka";
         nats: "nats";
+        "cloudflare-queues": "cloudflare-queues";
+        "cloudflare-cron": "cloudflare-cron";
+        "cloudflare-tail": "cloudflare-tail";
     }>;
     channel: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
@@ -120,6 +126,7 @@ declare const SemanticsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         "ecs-task": "ecs-task";
         container: "container";
         "k8s-deployment": "k8s-deployment";
+        worker: "worker";
     }>;
     instanceName: z.ZodString;
     name: z.ZodLiteral<"runtime-config">;
@@ -132,15 +139,22 @@ 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";
         kafka: "kafka";
         nats: "nats";
+        "cloudflare-queues": "cloudflare-queues";
+        "cloudflare-cron": "cloudflare-cron";
+        "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>;
 
@@ -183,6 +197,7 @@ declare const RuntimeConfigSemanticsSchema: z.ZodObject<{
         "ecs-task": "ecs-task";
         container: "container";
         "k8s-deployment": "k8s-deployment";
+        worker: "worker";
     }>;
     instanceName: z.ZodString;
     name: z.ZodLiteral<"runtime-config">;
@@ -310,6 +325,7 @@ declare const BoundaryBindingSchema: z.ZodObject<{
             "ecs-task": "ecs-task";
             container: "container";
             "k8s-deployment": "k8s-deployment";
+            worker: "worker";
         }>;
         instanceName: z.ZodString;
         name: z.ZodLiteral<"runtime-config">;
@@ -322,15 +338,22 @@ 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";
             kafka: "kafka";
             nats: "nats";
+            "cloudflare-queues": "cloudflare-queues";
+            "cloudflare-cron": "cloudflare-cron";
+            "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-D6hKT-zV.d.ts → schemas-CGR6qjFf.d.ts}

@@ -2,13 +2,15 @@ import { z } from 'zod';
 
 /**
  * One thing that gets deployed and runs on its own: a Lambda function,
- * an ECS task's container, a plain container, or a k8s deployment.
+ * an ECS task's container, a plain container, a k8s deployment, or an
+ * edge worker.
  */
 
 /**
  * `instanceName` is the stable identifier the deployment medium uses:
  * the CFN logical resource id for Lambda and ECS, the deployment name
- * for k8s, the container name for a plain container.
+ * for k8s, the container name for a plain container, and the script
+ * name for an edge worker.
  */
 declare const DeployableUnitSchema: z.ZodObject<{
     deploymentTarget: z.ZodEnum<{
@@ -16,6 +18,7 @@ declare const DeployableUnitSchema: z.ZodObject<{
         "ecs-task": "ecs-task";
         container: "container";
         "k8s-deployment": "k8s-deployment";
+        worker: "worker";
     }>;
     instanceName: z.ZodString;
 }, z.core.$strip>;
@@ -59,13 +62,16 @@ 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";
         kafka: "kafka";
         nats: "nats";
+        "cloudflare-queues": "cloudflare-queues";
+        "cloudflare-cron": "cloudflare-cron";
+        "cloudflare-tail": "cloudflare-tail";
     }>;
     channel: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
@@ -120,6 +126,7 @@ declare const SemanticsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         "ecs-task": "ecs-task";
         container: "container";
         "k8s-deployment": "k8s-deployment";
+        worker: "worker";
     }>;
     instanceName: z.ZodString;
     name: z.ZodLiteral<"runtime-config">;
@@ -132,15 +139,22 @@ 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";
         kafka: "kafka";
         nats: "nats";
+        "cloudflare-queues": "cloudflare-queues";
+        "cloudflare-cron": "cloudflare-cron";
+        "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>;
 
@@ -183,6 +197,7 @@ declare const RuntimeConfigSemanticsSchema: z.ZodObject<{
         "ecs-task": "ecs-task";
         container: "container";
         "k8s-deployment": "k8s-deployment";
+        worker: "worker";
     }>;
     instanceName: z.ZodString;
     name: z.ZodLiteral<"runtime-config">;
@@ -310,6 +325,7 @@ declare const BoundaryBindingSchema: z.ZodObject<{
             "ecs-task": "ecs-task";
             container: "container";
             "k8s-deployment": "k8s-deployment";
+            worker: "worker";
         }>;
         instanceName: z.ZodString;
         name: z.ZodLiteral<"runtime-config">;
@@ -322,15 +338,22 @@ 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";
             kafka: "kafka";
             nats: "nats";
+            "cloudflare-queues": "cloudflare-queues";
+            "cloudflare-cron": "cloudflare-cron";
+            "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>;