@postman-cse/onboarding-bootstrap 2.1.0 → 2.1.1

package/dist/index.cjs

@@ -298375,9 +298375,19 @@ function collectParameterChecks(root, pathItem, operation, version2, operationId
       if (defaultSerialization) warnings.push(`CONTRACT_SCHEMA_NOT_COMPILED: parameter ${location2}:${name} schema on ${operationId} skipped (${packed.unsupported})`);
       continue;
     }
-    if (location2 === "path" && !pathTemplate.split("/").includes(`{${name}}`)) {
-      warnings.push(`CONTRACT_PATH_PARAM_COMPOUND_SEGMENT_NOT_VALIDATED: path parameter ${name} of ${operationId} is embedded in a compound path segment and is not schema-validated`);
-      continue;
+    if (location2 === "path") {
+      const containingSegment = pathTemplate.split("/").find((segment) => segment.includes(`{${name}}`));
+      if (containingSegment !== void 0 && containingSegment !== `{${name}}`) {
+        const segmentParts = containingSegment.split(/(\{[^}]+\})/).filter(Boolean);
+        let extractable = true;
+        for (let partIndex = 0; partIndex < segmentParts.length - 1; partIndex += 1) {
+          if (/^\{[^}]+\}$/.test(segmentParts[partIndex]) && /^\{[^}]+\}$/.test(segmentParts[partIndex + 1])) extractable = false;
+        }
+        if (!extractable) {
+          warnings.push(`CONTRACT_PATH_PARAM_COMPOUND_SEGMENT_NOT_VALIDATED: path parameter ${name} of ${operationId} is in an ambiguous adjacent-parameter path segment and is not schema-validated`);
+          continue;
+        }
+      }
     }
     const scalarSchema = packedScalarSchema(packed);
     if (scalarSchema !== void 0) {
@@ -299097,7 +299107,7 @@ function createContractScript(operation, warnings = []) {
       '  function requestPathSegments() { var raw = ""; try { raw = typeof pm.request.url.getPath === "function" ? String(pm.request.url.getPath() || "") : ""; } catch (ignored) {} if (!raw) { var path = pm.request.url.path; raw = Array.isArray(path) ? "/" + path.join("/") : String(path || ""); } return raw.split("?")[0].split("#")[0].split("/").filter(function (segment) { return segment.length > 0; }); }',
       // Server path prefixes sit ahead of the template segments, so the
       // template aligns against the trailing request segments.
-      '  function pathParamValue(name) { var template = String(contract.path).split("/").filter(function (segment) { return segment.length > 0; }); var actual = requestPathSegments(); var offset = actual.length - template.length; if (offset < 0) return undefined; for (var i = 0; i < template.length; i += 1) { if (template[i] === "{" + name + "}") { var segment = actual[offset + i]; try { return decodeURIComponent(segment); } catch (ignored) { return segment; } } } return undefined; }',
+      '  function pathParamValue(name) { var template = String(contract.path).split("/").filter(function (segment) { return segment.length > 0; }); var actual = requestPathSegments(); var offset = actual.length - template.length; if (offset < 0) return undefined; var token = "{" + name + "}"; for (var i = 0; i < template.length; i += 1) { var seg = template[i]; var actualSeg = actual[offset + i]; if (actualSeg === undefined) continue; if (seg === token) { try { return decodeURIComponent(actualSeg); } catch (ignored) { return actualSeg; } } if (seg.indexOf(token) === -1) continue; var chunks = [], j = 0, bad = false; while (j < seg.length) { if (seg.charAt(j) === "{") { var close = seg.indexOf("}", j); if (close === -1) { bad = true; break; } chunks.push({ p: seg.slice(j + 1, close) }); j = close + 1; } else { var nb = seg.indexOf("{", j); var lit = nb === -1 ? seg.slice(j) : seg.slice(j, nb); chunks.push({ l: lit }); j = nb === -1 ? seg.length : nb; } } if (bad) return undefined; var pos = 0, found, ok = true; for (var c = 0; c < chunks.length; c += 1) { var ch = chunks[c]; if (ch.l !== undefined) { if (actualSeg.indexOf(ch.l, pos) === pos) pos += ch.l.length; else { ok = false; break; } } else { var nextLit = (chunks[c + 1] && chunks[c + 1].l !== undefined) ? chunks[c + 1].l : undefined; var isLast = c === chunks.length - 1; var end; if (isLast) { end = actualSeg.length; } else if (nextLit === undefined) { ok = false; break; } else { var idx = actualSeg.indexOf(nextLit, pos + 1); if (idx === -1) { ok = false; break; } end = idx; } if (end <= pos) { ok = false; break; } if (ch.p === name) found = actualSeg.slice(pos, end); pos = end; } } if (ok && pos === actualSeg.length && found !== undefined) { try { return decodeURIComponent(found); } catch (ignored) { return found; } } } return undefined; }',
       '  function isPlaceholder(value) { var text = String(value).trim(); return /^<[^<>]*>$/.test(text) || text.indexOf("{{") !== -1; }',
       '  function splitDelimited(value, decode) { if (decode === "csv") return value.split(","); if (decode === "ssv") return value.split(/%20| /); return value.split(/%7C|\\|/i); }',
       "  function decodeComponent(value) { try { return decodeURIComponent(value); } catch (ignored) { return value; } }",
@@ -301054,7 +301064,7 @@ function resolveActionVersion(explicit) {
   if (explicit) {
     return explicit;
   }
-  return "2.1.0" ? "2.1.0" : "unknown";
+  return "2.1.1" ? "2.1.1" : "unknown";
 }
 function telemetryDisabled(env) {
   const flag = String(env.POSTMAN_ACTIONS_TELEMETRY ?? "").trim().toLowerCase();
@@ -313638,27 +313648,28 @@ function classifyNamedType(named) {
 function describeType(type) {
   let current = type;
   let nonNull = false;
-  let list = false;
-  let listItemNonNull = false;
   if ((0, import_graphql.isNonNullType)(current)) {
     nonNull = true;
     current = current.ofType;
   }
-  if ((0, import_graphql.isListType)(current)) {
-    list = true;
+  const lists = [];
+  while ((0, import_graphql.isListType)(current)) {
     current = current.ofType;
+    let itemNonNull = false;
     if ((0, import_graphql.isNonNullType)(current)) {
-      listItemNonNull = true;
+      itemNonNull = true;
       current = current.ofType;
     }
+    lists.push({ itemNonNull });
   }
   const named = (0, import_graphql.getNamedType)(current);
   return {
     name: named.name,
     kind: classifyNamedType(named),
     nonNull,
-    list,
-    listItemNonNull
+    list: lists.length > 0,
+    listItemNonNull: lists.length > 0 ? lists[0].itemNonNull : false,
+    lists
   };
 }
 function describeArgument(arg) {
@@ -313695,7 +313706,7 @@ function collectRootOperations(rootType, kind, schema, shapes) {
     }
     if (returns.kind === "union") {
       opWarnings.push(
-        `GQL_UNION_RETURN_NOT_SHAPE_ASSERTED: ${kind}.${fieldName} returns union ${returns.name}; only data.${fieldName} presence is asserted, not member-type fields`
+        `GQL_UNION_MEMBER_FIELDS_NOT_EXPANDED: ${kind}.${fieldName} returns union ${returns.name}; its __typename is validated (object + declared member name) but member-specific fields are not expanded or asserted`
       );
     }
     if (returns.kind === "unknown") {
@@ -313759,9 +313770,12 @@ function parseGraphQLSchema(content, opts = {}) {
   }
   for (const operation of operations) warnings.push(...operation.warnings);
   const enumValues = {};
+  const unionMembers = {};
   for (const namedType of Object.values(schema.getTypeMap())) {
     if ((0, import_graphql.isEnumType)(namedType)) {
       enumValues[namedType.name] = namedType.getValues().map((value) => value.name);
+    } else if ((0, import_graphql.isUnionType)(namedType)) {
+      unionMembers[namedType.name] = namedType.getTypes().map((member) => member.name).sort((x, y) => x.localeCompare(y));
     }
   }
   return {
@@ -313769,6 +313783,7 @@ function parseGraphQLSchema(content, opts = {}) {
     operations,
     objectShapes,
     enumValues,
+    unionMembers,
     warnings
   };
 }
@@ -313776,6 +313791,7 @@ function parseGraphQLSchema(content, opts = {}) {
 // src/lib/protocols/graphql/selection.ts
 var SELECTION_DEPTH = 1;
 function selectFields(typeRef, index, depth) {
+  if (typeRef.kind === "union") return [];
   if (typeRef.kind !== "object" && typeRef.kind !== "interface") return null;
   const shape = index.objectShapes[typeRef.name];
   if (!shape) return [];
@@ -313809,8 +313825,8 @@ var DEFAULT_URL = "{{baseUrl}}/graphql";
 function argTypeSdl(arg) {
   const ref = arg.type;
   let inner = ref.name;
-  if (ref.list) {
-    inner = ref.listItemNonNull ? `[${ref.name}!]` : `[${ref.name}]`;
+  for (let i = ref.lists.length - 1; i >= 0; i -= 1) {
+    inner = ref.lists[i].itemNonNull ? `[${inner}!]` : `[${inner}]`;
   }
   return ref.nonNull ? `${inner}!` : inner;
 }
@@ -313979,12 +313995,25 @@ function buildShapeAssertions(operation, index, warnings) {
   return emitValueAssertions("value", operation.returns, selection, operation.id, index, warnings);
 }
 function emitValueAssertions(accessor, ref, selection, ctx, index, warnings) {
-  if (ref.list) {
-    const elementRef = { ...ref, list: false };
-    const elementLines = emitValueAssertions("__el", elementRef, selection, `${ctx} (list element)`, index, warnings);
+  if (ref.lists.length > 0) {
+    const [outer, ...rest] = ref.lists;
+    const innerRef = {
+      ...ref,
+      lists: rest,
+      list: rest.length > 0,
+      listItemNonNull: rest.length > 0 ? rest[0].itemNonNull : false
+    };
+    const elementLines = emitValueAssertions("__el", innerRef, selection, `${ctx} (list element)`, index, warnings);
     const lines = [`pm.expect(${accessor}, ${JSON.stringify(`${ctx}: expected a list`)}).to.be.an("array");`];
-    if (elementLines.length > 0) {
-      lines.push(`${accessor}.forEach(function (__el) {`, ...elementLines.map((line) => `    ${line}`), "});");
+    const body = [];
+    if (outer.itemNonNull) {
+      body.push(`pm.expect(__el, ${JSON.stringify(`${ctx} (list element): a non-null list item ([T!]) was null`)}).to.not.be.null;`);
+      body.push(...elementLines);
+    } else if (elementLines.length > 0) {
+      body.push("if (__el === null || __el === undefined) return;", ...elementLines);
+    }
+    if (body.length > 0) {
+      lines.push(`${accessor}.forEach(function (__el) {`, ...body.map((line) => `    ${line}`), "});");
     }
     return lines;
   }
@@ -314002,8 +314031,22 @@ function emitValueAssertions(accessor, ref, selection, ctx, index, warnings) {
     return lines;
   }
   if (ref.kind === "union") {
-    warnings.push(`GQL_UNION_RETURN_NOT_SHAPE_ASSERTED: ${ctx} returns union ${ref.name}; only presence is asserted`);
-    return [];
+    const members = index.unionMembers[ref.name];
+    const objMsg = JSON.stringify(ctx + ": expected union " + ref.name + " value as an object");
+    const presentMsg = JSON.stringify(ctx + ": union " + ref.name + " value must carry __typename");
+    const stringMsg = JSON.stringify(ctx + ": union " + ref.name + " __typename must be a string");
+    const lines = [
+      "pm.expect(" + accessor + ", " + objMsg + ').to.be.an("object");',
+      "pm.expect(" + accessor + ", " + presentMsg + ').to.have.property("__typename");',
+      "pm.expect(" + accessor + " && " + accessor + ".__typename, " + stringMsg + ').to.be.a("string");'
+    ];
+    if (members && members.length > 0) {
+      const memberMsg = JSON.stringify(ctx + ": __typename is not a declared member of union " + ref.name);
+      lines.push("pm.expect(" + accessor + " && " + accessor + ".__typename, " + memberMsg + ").to.be.oneOf(" + JSON.stringify(members) + ");");
+    } else {
+      warnings.push("GQL_UNION_MEMBERS_UNKNOWN: " + ctx + " union " + ref.name + " member set was not resolved; only object + string __typename is asserted");
+    }
+    return lines;
   }
   warnings.push(`GQL_UNKNOWN_RETURN_TYPE: ${ctx} return type ${ref.name} could not be classified; only presence is asserted`);
   return [];
@@ -314014,6 +314057,7 @@ function emitFieldAssertions(objectAccessor, parentTypeName, field, ctx, index,
   const lines = [];
   if (field.type.nonNull) {
     lines.push(`pm.expect(${objectAccessor}, ${JSON.stringify(`${parentTypeName} is missing non-null field '${field.name}'`)}).to.have.property(${propName});`);
+    lines.push(`pm.expect(${prop}, ${JSON.stringify(`${parentTypeName}.${field.name} is declared non-null but was null`)}).to.not.be.null;`);
   }
   const valueLines = emitValueAssertions(prop, field.type, field.selection, `${ctx}.${field.name}`, index, warnings);
   if (valueLines.length > 0) {
@@ -314119,19 +314163,25 @@ function asArray6(value) {
 }
 var SCALAR_JSON_TYPE = {
   double: { jsonType: "double" },
-  float: { jsonType: "double" },
-  int32: { jsonType: "number" },
-  sint32: { jsonType: "number" },
-  sfixed32: { jsonType: "number" },
-  fixed32: { jsonType: "number" },
-  uint32: { jsonType: "number" },
-  // 64-bit integers are JSON-encoded as strings by the proto JSON mapping and
-  // by protobufjs default toObject, so we assert `string`.
-  int64: { jsonType: "string" },
-  uint64: { jsonType: "string" },
-  sint64: { jsonType: "string" },
-  fixed64: { jsonType: "string" },
-  sfixed64: { jsonType: "string" },
+  // proto float is float32; carry a format so the runtime enforces float32 range
+  // (a finite double like 3.5e38 overflows float32 and must fail).
+  float: { jsonType: "double", jsonFormat: "proto-float32" },
+  // 32-bit integers JSON-encode as numbers; `intType` carries the exact protobuf
+  // integer domain so the runtime range/sign-checks it (not just integrality).
+  int32: { jsonType: "number", intType: "int32" },
+  sint32: { jsonType: "number", intType: "sint32" },
+  sfixed32: { jsonType: "number", intType: "sfixed32" },
+  fixed32: { jsonType: "number", intType: "fixed32" },
+  uint32: { jsonType: "number", intType: "uint32" },
+  // 64-bit integers are JSON-encoded as strings by the proto JSON mapping and by
+  // protobufjs default toObject; `intType` carries the exact domain so the runtime
+  // lexically validates and RANGE-checks the string (string comparison avoids JS
+  // double precision loss beyond 2^53).
+  int64: { jsonType: "string", intType: "int64" },
+  uint64: { jsonType: "string", intType: "uint64" },
+  sint64: { jsonType: "string", intType: "sint64" },
+  fixed64: { jsonType: "string", intType: "fixed64" },
+  sfixed64: { jsonType: "string", intType: "sfixed64" },
   bool: { jsonType: "boolean" },
   string: { jsonType: "string" },
   // bytes are base64 strings in proto JSON.
@@ -314142,11 +314192,11 @@ var WELL_KNOWN_JSON_TYPE = {
   "google.protobuf.Duration": { jsonType: "string", jsonFormat: "proto-duration" },
   "google.protobuf.FieldMask": { jsonType: "string", jsonFormat: "proto-field-mask" },
   "google.protobuf.DoubleValue": { jsonType: "double", nullable: true },
-  "google.protobuf.FloatValue": { jsonType: "double", nullable: true },
-  "google.protobuf.Int32Value": { jsonType: "number", nullable: true },
-  "google.protobuf.UInt32Value": { jsonType: "number", nullable: true },
-  "google.protobuf.Int64Value": { jsonType: "string", nullable: true },
-  "google.protobuf.UInt64Value": { jsonType: "string", nullable: true },
+  "google.protobuf.FloatValue": { jsonType: "double", jsonFormat: "proto-float32", nullable: true },
+  "google.protobuf.Int32Value": { jsonType: "number", intType: "int32", nullable: true },
+  "google.protobuf.UInt32Value": { jsonType: "number", intType: "uint32", nullable: true },
+  "google.protobuf.Int64Value": { jsonType: "string", intType: "int64", nullable: true },
+  "google.protobuf.UInt64Value": { jsonType: "string", intType: "uint64", nullable: true },
   "google.protobuf.BoolValue": { jsonType: "boolean", nullable: true },
   "google.protobuf.StringValue": { jsonType: "string", nullable: true },
   "google.protobuf.BytesValue": { jsonType: "string", jsonFormat: "proto-bytes", nullable: true },
@@ -314193,7 +314243,7 @@ function stripLeadingDot(name) {
 }
 function classifyValueType(protoType, resolved) {
   const wkt = WELL_KNOWN_JSON_TYPE[stripLeadingDot(protoType)];
-  if (wkt) return { jsonType: wkt.jsonType, jsonFormat: wkt.jsonFormat, nullable: wkt.nullable };
+  if (wkt) return { jsonType: wkt.jsonType, jsonFormat: wkt.jsonFormat, nullable: wkt.nullable, intType: wkt.intType };
   if (resolved && Array.isArray(resolved.fieldsArray)) {
     return { jsonType: "object", messageType: stripLeadingDot(resolved.fullName) };
   }
@@ -314201,9 +314251,14 @@ function classifyValueType(protoType, resolved) {
     return { jsonType: "enum", enumType: stripLeadingDot(resolved.fullName) };
   }
   const scalar = SCALAR_JSON_TYPE[protoType];
-  if (scalar) return { jsonType: scalar.jsonType, jsonFormat: scalar.jsonFormat };
+  if (scalar) return { jsonType: scalar.jsonType, jsonFormat: scalar.jsonFormat, intType: scalar.intType };
   return { jsonType: "unknown" };
 }
+function classifyMapKey(keyType) {
+  if (keyType === "bool") return "boolean";
+  if (keyType && /^(?:u?int|sint|s?fixed)(?:32|64)$/.test(keyType)) return keyType;
+  return void 0;
+}
 function toLowerCamelCase(name) {
   return name.replace(/_+([a-zA-Z0-9])/g, (_match, char) => char.toUpperCase()).replace(/_+$/g, "");
 }
@@ -314232,6 +314287,7 @@ function fieldDescriptor(field, warnings, context) {
     if (value.jsonType === "unknown") {
       warnings.push(`PROTO_FIELD_TYPE_UNRESOLVED: map field ${context}.${field.name} has value type ${protoType} that could not be resolved; map values are not asserted`);
     }
+    const mapKeyType = classifyMapKey(field.keyType);
     return {
       name: String(field.name),
       jsonName: protoJsonName(field),
@@ -314241,8 +314297,10 @@ function fieldDescriptor(field, warnings, context) {
       map: true,
       optional: Boolean(field.optional),
       required: Boolean(field.required),
+      ...mapKeyType ? { mapKeyType } : {},
       ...value.jsonType !== "unknown" ? { mapValueType: value.jsonType } : {},
       ...value.jsonFormat ? { mapValueFormat: value.jsonFormat } : {},
+      ...value.intType ? { mapValueIntType: value.intType } : {},
       ...value.enumType ? { mapValueEnumType: value.enumType } : {},
       ...value.messageType ? { mapValueMessageType: value.messageType } : {}
     };
@@ -314262,6 +314320,7 @@ function fieldDescriptor(field, warnings, context) {
     optional: Boolean(field.optional),
     required: Boolean(field.required),
     ...classified.nullable ? { nullable: true } : {},
+    ...classified.intType ? { intType: classified.intType } : {},
     ...classified.messageType ? { messageType: classified.messageType } : {},
     ...classified.enumType ? { enumType: classified.enumType } : {}
   };
@@ -314497,13 +314556,16 @@ function buildShape(messageFullName, index, warnings, operationId, label, depth,
       jsonName: field.jsonName,
       jsonType: field.jsonType,
       ...field.jsonFormat ? { jsonFormat: field.jsonFormat } : {},
+      ...field.intType ? { intType: field.intType } : {},
       repeated: field.repeated,
       map: field.map,
       required: field.required,
       ...field.nullable ? { nullable: true } : {},
       ...enumValues ? { enumValues } : {},
+      ...field.mapKeyType ? { mapKeyType: field.mapKeyType } : {},
       ...field.mapValueType ? { mapValueType: field.mapValueType } : {},
       ...field.mapValueFormat ? { mapValueFormat: field.mapValueFormat } : {},
+      ...field.mapValueIntType ? { mapValueIntType: field.mapValueIntType } : {},
       ...mapValueEnumValues ? { mapValueEnumValues } : {}
     };
     if (field.messageType && field.jsonType === "object" && !field.map) {
@@ -314570,18 +314632,38 @@ function createGrpcScript(spec) {
     '  if (expected === "any") return true;',
     "  return true;",
     "}",
+    'var GRPC_INT_SPECS = { int32:{s:true,b:32,min:"-2147483648",max:"2147483647"}, sint32:{s:true,b:32,min:"-2147483648",max:"2147483647"}, sfixed32:{s:true,b:32,min:"-2147483648",max:"2147483647"}, uint32:{s:false,b:32,min:"0",max:"4294967295"}, fixed32:{s:false,b:32,min:"0",max:"4294967295"}, int64:{s:true,b:64,min:"-9223372036854775808",max:"9223372036854775807"}, sint64:{s:true,b:64,min:"-9223372036854775808",max:"9223372036854775807"}, sfixed64:{s:true,b:64,min:"-9223372036854775808",max:"9223372036854775807"}, uint64:{s:false,b:64,min:"0",max:"18446744073709551615"}, fixed64:{s:false,b:64,min:"0",max:"18446744073709551615"} };',
+    'function grpcDecStr(n) { var s = String(n); return (s.indexOf("e") === -1 && s.indexOf("E") === -1 && s.indexOf(".") === -1) ? s : null; }',
+    'function grpcCmpIntStr(a, b) { var na = a.charAt(0) === "-", nb = b.charAt(0) === "-"; if (na !== nb) return na ? -1 : 1; var aa = (na ? a.slice(1) : a).replace(/^0+(?=[0-9])/, ""); var bb = (nb ? b.slice(1) : b).replace(/^0+(?=[0-9])/, ""); var mag; if (aa.length !== bb.length) mag = aa.length < bb.length ? -1 : 1; else mag = aa < bb ? -1 : (aa > bb ? 1 : 0); return na ? -mag : mag; }',
+    'function grpcNormIntStr(s) { var neg = false; if (s.charAt(0) === "-") { neg = true; s = s.slice(1); } else if (s.charAt(0) === "+") { s = s.slice(1); } var ei = s.indexOf("e"); if (ei === -1) ei = s.indexOf("E"); var exp = 0; if (ei !== -1) { exp = parseInt(s.slice(ei + 1), 10); s = s.slice(0, ei); } var dot = s.indexOf("."); var intp = dot === -1 ? s : s.slice(0, dot); var frac = dot === -1 ? "" : s.slice(dot + 1); var digits = intp + frac; if (digits.length === 0) return null; if (/^0+$/.test(digits)) return "0"; if (exp >= 0) { var intpSize = intp === "0" ? 0 : intp.length; if (intpSize + exp > 20) return null; } var netExp = exp - frac.length; var out; if (netExp >= 0) { if (digits.length + netExp > 40) return null; out = digits; for (var z = 0; z < netExp; z++) out += "0"; } else { var cut = -netExp; var keepLen = digits.length - cut; var dropped = keepLen <= 0 ? digits : digits.slice(keepLen); for (var d = 0; d < dropped.length; d++) { if (dropped.charAt(d) !== "0") return null; } out = keepLen <= 0 ? "0" : digits.slice(0, keepLen); } var st = 0; while (st < out.length - 1 && out.charAt(st) === "0") st++; out = out.slice(st); if (out === "0") return "0"; if (out.length > 40) return null; return neg ? "-" + out : out; }',
+    "function matchesInt(intType, value) {",
+    "  var spec = GRPC_INT_SPECS[intType]; if (!spec) return true;",
+    "  var num, canonical;",
+    '  if (typeof value === "number") { if (!Number.isFinite(value) || !Number.isInteger(value)) return false; num = value; canonical = grpcDecStr(value); }',
+    '  else if (typeof value === "string") { if (!/^-?(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$/.test(value)) return false; canonical = grpcNormIntStr(value); if (canonical === null) return false; num = Number(value); }',
+    "  else { return false; }",
+    '  if (canonical === "-0") canonical = "0";',
+    '  if (!spec.s && ((canonical !== null && canonical.charAt(0) === "-") || num < 0)) return false;',
+    "  if (spec.b === 32) return num >= Number(spec.min) && num <= Number(spec.max);",
+    "  if (canonical !== null) return grpcCmpIntStr(canonical, spec.min) >= 0 && grpcCmpIntStr(canonical, spec.max) <= 0;",
+    "  return false;",
+    "}",
+    'function matchesIntKey(intType, key) { var spec = GRPC_INT_SPECS[intType]; if (!spec) return true; if (!(spec.s ? /^[+-]?[0-9]+$/ : /^[0-9]+$/).test(key)) return false; var neg = key.charAt(0) === "-"; var body = (key.charAt(0) === "+" || key.charAt(0) === "-") ? key.slice(1) : key; if (body.length === 0) return false; var canon = neg ? "-" + body : body; return grpcCmpIntStr(canon, spec.min) >= 0 && grpcCmpIntStr(canon, spec.max) <= 0; }',
+    "function matchesEnumNumber(n) { return Number.isInteger(n) && n >= -2147483648 && n <= 2147483647; }",
     "function daysFromCivil(y, m, d) { y -= m <= 2 ? 1 : 0; var era = Math.floor(y / 400); var yoe = y - era * 400; var mp = m + (m > 2 ? -3 : 9); var doy = Math.floor((153 * mp + 2) / 5) + d - 1; var doe = yoe * 365 + Math.floor(yoe / 4) - Math.floor(yoe / 100) + doy; return era * 146097 + doe - 719468; }",
     "function validDate(y, m, d) { if (y < 1 || y > 9999 || m < 1 || m > 12 || d < 1) return false; var mdays = [31, ((y % 4 === 0 && y % 100 !== 0) || y % 400 === 0) ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]; return d <= mdays[m - 1]; }",
     'function validProtoTimestamp(value) { if (typeof value !== "string") return false; var m = value.match(/^([0-9]{4})-([0-9]{2})-([0-9]{2})T([0-9]{2}):([0-9]{2}):([0-9]{2})(?:\\.([0-9]{1,9}))?(Z|[+-][0-9]{2}:[0-9]{2})$/); if (!m) return false; var y = Number(m[1]), mo = Number(m[2]), d = Number(m[3]), h = Number(m[4]), mi = Number(m[5]), s = Number(m[6]); if (!validDate(y, mo, d) || h > 23 || mi > 59 || s > 59) return false; var off = 0; if (m[8] !== "Z") { var sign = m[8][0] === "-" ? -1 : 1; var oh = Number(m[8].slice(1, 3)), om = Number(m[8].slice(4, 6)); if (oh > 23 || om > 59) return false; off = sign * (oh * 3600 + om * 60); } var sec = daysFromCivil(y, mo, d) * 86400 + h * 3600 + mi * 60 + s - off; return sec >= -62135596800 && sec <= 253402300799; }',
     'function validProtoDuration(value) { if (typeof value !== "string") return false; var m = value.match(/^[+-]?(?:(0|[1-9][0-9]*)(?:\\.[0-9]{0,9})?|\\.[0-9]{0,9})s$/); if (!m) return false; return !m[1] || Number(m[1]) <= 315576000000; }',
     'function validProtoFieldMask(value) { if (typeof value !== "string") return false; if (value === "") return true; var paths = value.split(","); for (var i = 0; i < paths.length; i++) { if (!/^[a-z][A-Za-z0-9]*(\\.[a-z][A-Za-z0-9]*)*$/.test(paths[i])) return false; } return true; }',
     'function validProtoBytes(value) { if (typeof value !== "string") return false; if (!/^(?:[A-Za-z0-9+/]*|[A-Za-z0-9_-]*)={0,2}$/.test(value)) return false; var firstPad = value.indexOf("="); if (firstPad !== -1 && firstPad < value.length - (value.endsWith("==") ? 2 : 1)) return false; var pad = value.endsWith("==") ? 2 : value.endsWith("=") ? 1 : 0; var raw = value.length - pad; if (raw % 4 === 1) return false; return pad === 0 || (raw + pad) % 4 === 0 && pad === (4 - raw % 4) % 4; }',
+    'function validProtoFloat32(value) { if (value === "NaN" || value === "Infinity" || value === "-Infinity") return true; var n = typeof value === "number" ? value : Number(value); if (!Number.isFinite(n)) return false; return Number.isFinite(Math.fround(n)); }',
     "function matchesFormat(format, value) {",
     "  if (!format) return true;",
     '  if (format === "proto-timestamp") return validProtoTimestamp(value);',
     '  if (format === "proto-duration") return validProtoDuration(value);',
     '  if (format === "proto-field-mask") return validProtoFieldMask(value);',
     '  if (format === "proto-bytes") return validProtoBytes(value);',
+    '  if (format === "proto-float32") return validProtoFloat32(value);',
     "  return true;",
     "}",
     "function formatLabel(format) {",
@@ -314589,6 +314671,7 @@ function createGrpcScript(spec) {
     '  if (format === "proto-duration") return "a valid ProtoJSON Duration";',
     '  if (format === "proto-field-mask") return "a valid ProtoJSON FieldMask";',
     '  if (format === "proto-bytes") return "valid ProtoJSON base64 bytes";',
+    '  if (format === "proto-float32") return "a float32-representable number";',
     '  return format || "valid ProtoJSON";',
     "}",
     // Recursive shape checker: validates fields (with nested message descent,
@@ -314602,14 +314685,15 @@ function createGrpcScript(spec) {
     '  if (field.required && !present) { pm.expect.fail("gRPC response is missing required field " + label); return; }',
     "  if (!present) return;",
     "  var value = obj[key];",
-    "  if (field.nullable && value === null) return;",
+    "  if (value === null) return;",
     "  if (field.repeated) {",
     '    if (!matchesScalar("array", value)) { pm.expect.fail("gRPC field " + label + " must be a repeated (array) value but was " + jsonTypeOf(value)); return; }',
     "    for (var i = 0; i < value.length; i++) {",
     '      var elem = value[i]; var elemLabel = label + "[" + i + "]";',
     '      if (field.shape) { if (!matchesScalar("object", elem)) { pm.expect.fail("gRPC repeated field " + elemLabel + " must be an object but was " + jsonTypeOf(elem)); } else { grpcCheckShape(elem, field.shape, elemLabel + "."); } continue; }',
-    '      if (field.enumValues && field.enumValues.length > 0) { if (typeof elem === "number") { if (!Number.isInteger(elem)) pm.expect.fail("gRPC repeated enum field " + elemLabel + " must be an integer but was " + elem); continue; } if (typeof elem !== "string") { pm.expect.fail("gRPC repeated enum field " + elemLabel + " must be a string or number but was " + jsonTypeOf(elem)); } else if (field.enumValues.indexOf(elem) === -1) { pm.expect.fail("gRPC repeated enum field " + elemLabel + " has value " + elem + " not in [" + field.enumValues.join(", ") + "]"); } continue; }',
+    '      if (field.enumValues && field.enumValues.length > 0) { if (typeof elem === "number") { if (!matchesEnumNumber(elem)) pm.expect.fail("gRPC repeated enum field " + elemLabel + " must be an int32-range integer but was " + elem); continue; } if (typeof elem !== "string") { pm.expect.fail("gRPC repeated enum field " + elemLabel + " must be a string or number but was " + jsonTypeOf(elem)); } else if (field.enumValues.indexOf(elem) === -1) { pm.expect.fail("gRPC repeated enum field " + elemLabel + " has value " + elem + " not in [" + field.enumValues.join(", ") + "]"); } continue; }',
     '      if (field.jsonType === "any") continue;',
+    '      if (field.intType) { if (!matchesInt(field.intType, elem)) pm.expect.fail("gRPC repeated field " + elemLabel + " must be a valid " + field.intType + " (in range) but was " + JSON.stringify(elem)); continue; }',
     '      if (!matchesScalar(field.jsonType, elem)) pm.expect.fail("gRPC repeated field " + elemLabel + " must be " + field.jsonType + " but was " + jsonTypeOf(elem));',
     '      else if (!matchesFormat(field.jsonFormat, elem)) pm.expect.fail("gRPC repeated field " + elemLabel + " must be " + formatLabel(field.jsonFormat));',
     "    }",
@@ -314617,17 +314701,28 @@ function createGrpcScript(spec) {
     "  }",
     "  if (field.map) {",
     '    if (!matchesScalar("object", value)) { pm.expect.fail("gRPC map field " + label + " must be an object but was " + jsonTypeOf(value)); return; }',
-    '    if (field.mapValueType) { var keys = Object.keys(value); for (var k = 0; k < keys.length; k++) { var mv = value[keys[k]], mvLabel = label + "[" + keys[k] + "]"; if (field.mapValueShape && matchesScalar("object", mv)) { grpcCheckShape(mv, field.mapValueShape, mvLabel + "."); } else if (field.mapValueEnumValues && field.mapValueEnumValues.length > 0) { if (typeof mv === "number") { if (!Number.isInteger(mv)) pm.expect.fail("gRPC map enum value " + mvLabel + " must be an integer but was " + mv); } else if (typeof mv !== "string") { pm.expect.fail("gRPC map enum value " + mvLabel + " must be a string or number but was " + jsonTypeOf(mv)); } else if (field.mapValueEnumValues.indexOf(mv) === -1) { pm.expect.fail("gRPC map enum value " + mvLabel + " has value " + mv + " not in [" + field.mapValueEnumValues.join(", ") + "]"); } } else if (!matchesScalar(field.mapValueType, mv)) { pm.expect.fail("gRPC map value " + mvLabel + " must be " + field.mapValueType + " but was " + jsonTypeOf(mv)); } else if (!matchesFormat(field.mapValueFormat, mv)) { pm.expect.fail("gRPC map value " + mvLabel + " must be " + formatLabel(field.mapValueFormat)); } } }',
+    "    var keys = Object.keys(value);",
+    "    for (var k = 0; k < keys.length; k++) {",
+    '      var mk = keys[k], mv = value[mk], mvLabel = label + "[" + mk + "]";',
+    '      if (field.mapKeyType === "boolean") { if (mk !== "true" && mk !== "false") pm.expect.fail("gRPC map key " + mvLabel + " must be the string true or false but was " + mk); }',
+    '      else if (field.mapKeyType) { if (!matchesIntKey(field.mapKeyType, mk)) pm.expect.fail("gRPC map key " + mvLabel + " must be a valid " + field.mapKeyType + " string (in range) but was " + mk); }',
+    '      if (field.mapValueShape && matchesScalar("object", mv)) { grpcCheckShape(mv, field.mapValueShape, mvLabel + "."); }',
+    '      else if (field.mapValueIntType) { if (!matchesInt(field.mapValueIntType, mv)) pm.expect.fail("gRPC map value " + mvLabel + " must be a valid " + field.mapValueIntType + " (in range) but was " + JSON.stringify(mv)); }',
+    '      else if (field.mapValueEnumValues && field.mapValueEnumValues.length > 0) { if (typeof mv === "number") { if (!matchesEnumNumber(mv)) pm.expect.fail("gRPC map enum value " + mvLabel + " must be an int32-range integer but was " + mv); } else if (typeof mv !== "string") { pm.expect.fail("gRPC map enum value " + mvLabel + " must be a string or number but was " + jsonTypeOf(mv)); } else if (field.mapValueEnumValues.indexOf(mv) === -1) { pm.expect.fail("gRPC map enum value " + mvLabel + " has value " + mv + " not in [" + field.mapValueEnumValues.join(", ") + "]"); } }',
+    '      else if (field.mapValueType && !matchesScalar(field.mapValueType, mv)) { pm.expect.fail("gRPC map value " + mvLabel + " must be " + field.mapValueType + " but was " + jsonTypeOf(mv)); }',
+    '      else if (field.mapValueType && !matchesFormat(field.mapValueFormat, mv)) { pm.expect.fail("gRPC map value " + mvLabel + " must be " + formatLabel(field.mapValueFormat)); }',
+    "    }",
     "    return;",
     "  }",
     "  if (field.enumValues && field.enumValues.length > 0) {",
-    '    if (typeof value === "number") { if (!Number.isInteger(value)) pm.expect.fail("gRPC enum field " + label + " must be an integer but was " + value); return; }',
+    '    if (typeof value === "number") { if (!matchesEnumNumber(value)) pm.expect.fail("gRPC enum field " + label + " must be an int32-range integer but was " + value); return; }',
     '    if (typeof value !== "string") { pm.expect.fail("gRPC enum field " + label + " must be a string or number but was " + jsonTypeOf(value)); return; }',
     '    if (field.enumValues.indexOf(value) === -1) pm.expect.fail("gRPC enum field " + label + " has value " + value + " not in [" + field.enumValues.join(", ") + "]");',
     "    return;",
     "  }",
     '  if (field.jsonType === "any") return;',
     '  if (field.shape) { if (!matchesScalar("object", value)) { pm.expect.fail("gRPC field " + label + " must be an object but was " + jsonTypeOf(value)); return; } grpcCheckShape(value, field.shape, label + "."); return; }',
+    '  if (field.intType) { if (!matchesInt(field.intType, value)) pm.expect.fail("gRPC field " + label + " must be a valid " + field.intType + " (in range) but was " + JSON.stringify(value)); return; }',
     '  if (!matchesScalar(field.jsonType, value)) pm.expect.fail("gRPC field " + label + " must be " + field.jsonType + " but was " + jsonTypeOf(value));',
     '  else if (!matchesFormat(field.jsonFormat, value)) pm.expect.fail("gRPC field " + label + " must be " + formatLabel(field.jsonFormat));',
     "}",
@@ -314677,6 +314772,103 @@ function methodPathOf(item) {
   const value = payload?.methodPath;
   return typeof value === "string" ? value : "";
 }
+var GRPC_INT_SPECS = {
+  int32: { signed: true, bits: 32, min: "-2147483648", max: "2147483647" },
+  sint32: { signed: true, bits: 32, min: "-2147483648", max: "2147483647" },
+  sfixed32: { signed: true, bits: 32, min: "-2147483648", max: "2147483647" },
+  uint32: { signed: false, bits: 32, min: "0", max: "4294967295" },
+  fixed32: { signed: false, bits: 32, min: "0", max: "4294967295" },
+  int64: { signed: true, bits: 64, min: "-9223372036854775808", max: "9223372036854775807" },
+  sint64: { signed: true, bits: 64, min: "-9223372036854775808", max: "9223372036854775807" },
+  sfixed64: { signed: true, bits: 64, min: "-9223372036854775808", max: "9223372036854775807" },
+  uint64: { signed: false, bits: 64, min: "0", max: "18446744073709551615" },
+  fixed64: { signed: false, bits: 64, min: "0", max: "18446744073709551615" }
+};
+function grpcDecStr(n) {
+  const s = String(n);
+  return s.indexOf("e") === -1 && s.indexOf("E") === -1 && s.indexOf(".") === -1 ? s : null;
+}
+function grpcCmpIntStr(a, b) {
+  const na = a.charAt(0) === "-";
+  const nb = b.charAt(0) === "-";
+  if (na !== nb) return na ? -1 : 1;
+  const aa = (na ? a.slice(1) : a).replace(/^0+(?=[0-9])/, "");
+  const bb = (nb ? b.slice(1) : b).replace(/^0+(?=[0-9])/, "");
+  let mag;
+  if (aa.length !== bb.length) mag = aa.length < bb.length ? -1 : 1;
+  else mag = aa < bb ? -1 : aa > bb ? 1 : 0;
+  return na ? -mag : mag;
+}
+function grpcNormIntStr(input) {
+  let s = input;
+  let neg = false;
+  if (s.charAt(0) === "-") {
+    neg = true;
+    s = s.slice(1);
+  } else if (s.charAt(0) === "+") {
+    s = s.slice(1);
+  }
+  let ei = s.indexOf("e");
+  if (ei === -1) ei = s.indexOf("E");
+  let exp = 0;
+  if (ei !== -1) {
+    exp = parseInt(s.slice(ei + 1), 10);
+    s = s.slice(0, ei);
+  }
+  const dot = s.indexOf(".");
+  const intp = dot === -1 ? s : s.slice(0, dot);
+  const frac = dot === -1 ? "" : s.slice(dot + 1);
+  const digits = intp + frac;
+  if (digits.length === 0) return null;
+  if (/^0+$/.test(digits)) return "0";
+  if (exp >= 0) {
+    const intpSize = intp === "0" ? 0 : intp.length;
+    if (intpSize + exp > 20) return null;
+  }
+  const netExp = exp - frac.length;
+  let out;
+  if (netExp >= 0) {
+    if (digits.length + netExp > 40) return null;
+    out = digits + "0".repeat(netExp);
+  } else {
+    const cut = -netExp;
+    const keepLen = digits.length - cut;
+    const dropped = keepLen <= 0 ? digits : digits.slice(keepLen);
+    for (let d = 0; d < dropped.length; d += 1) {
+      if (dropped.charAt(d) !== "0") return null;
+    }
+    out = keepLen <= 0 ? "0" : digits.slice(0, keepLen);
+  }
+  let st = 0;
+  while (st < out.length - 1 && out.charAt(st) === "0") st += 1;
+  out = out.slice(st);
+  if (out === "0") return "0";
+  if (out.length > 40) return null;
+  return neg ? `-${out}` : out;
+}
+function matchesIntValue(intType, value) {
+  const spec = GRPC_INT_SPECS[intType];
+  if (!spec) return true;
+  let num;
+  let canonical;
+  if (typeof value === "number") {
+    if (!Number.isFinite(value) || !Number.isInteger(value)) return false;
+    num = value;
+    canonical = grpcDecStr(value);
+  } else if (typeof value === "string") {
+    if (!/^-?(?:0|[1-9][0-9]*)(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$/.test(value)) return false;
+    canonical = grpcNormIntStr(value);
+    if (canonical === null) return false;
+    num = Number(value);
+  } else {
+    return false;
+  }
+  if (canonical === "-0") canonical = "0";
+  if (!spec.signed && (canonical !== null && canonical.charAt(0) === "-" || num < 0)) return false;
+  if (spec.bits === 32) return num >= Number(spec.min) && num <= Number(spec.max);
+  if (canonical !== null) return grpcCmpIntStr(canonical, spec.min) >= 0 && grpcCmpIntStr(canonical, spec.max) <= 0;
+  return false;
+}
 function matchesScalarValue(expected, value) {
   const isJsonNumberString = (text) => /^-?(?:0|[1-9][0-9]*)(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$/.test(text) && Number.isFinite(Number(text));
   switch (expected) {
@@ -314765,6 +314957,12 @@ function validProtoBytes(value) {
   if (raw % 4 === 1) return false;
   return pad === 0 || (raw + pad) % 4 === 0 && pad === (4 - raw % 4) % 4;
 }
+function validProtoFloat32(value) {
+  if (value === "NaN" || value === "Infinity" || value === "-Infinity") return true;
+  const n = typeof value === "number" ? value : Number(value);
+  if (!Number.isFinite(n)) return false;
+  return Number.isFinite(Math.fround(n));
+}
 function matchesFormatValue(format3, value) {
   switch (format3) {
     case void 0:
@@ -314777,6 +314975,8 @@ function matchesFormatValue(format3, value) {
       return validProtoFieldMask(value);
     case "proto-bytes":
       return validProtoBytes(value);
+    case "proto-float32":
+      return validProtoFloat32(value);
     default:
       return true;
   }
@@ -314811,6 +315011,12 @@ function staticRequestCheck(item, shape, methodPath2, warnings) {
       continue;
     }
     if (field.jsonType === "any" || field.enumValues || field.map || field.shape) continue;
+    if (field.intType) {
+      if (!matchesIntValue(field.intType, value)) {
+        warnings.push(`PROTO_REQUEST_FIELD_TYPE_MISMATCH: ${methodPath2} request field ${field.name} must be a valid ${field.intType} (in range)`);
+      }
+      continue;
+    }
     if (!matchesScalarValue(field.jsonType, value)) {
       warnings.push(`PROTO_REQUEST_FIELD_TYPE_MISMATCH: ${methodPath2} request field ${field.name} must be ${field.jsonType}`);
     } else if (!matchesFormatValue(field.jsonFormat, value)) {
@@ -314820,6 +315026,7 @@ function staticRequestCheck(item, shape, methodPath2, warnings) {
 }
 function instrumentGrpcCollection(collection, index) {
   const warnings = [...index.warnings, ...index.operations.flatMap((operation) => operation.warnings)];
+  warnings.push("GRPC_UNKNOWN_FIELDS_NOT_REJECTED: extra response JSON keys are not rejected (proto3 forward-compat + open well-known types; unknown wire fields are not surfaced by the binary->JSON decode)");
   const specs = /* @__PURE__ */ new Map();
   const requestShapes = /* @__PURE__ */ new Map();
   for (const operation of index.operations) {
@@ -315326,6 +315533,7 @@ function createSoapScript(operation, warnings = []) {
       `  pm.expect(bodyText, "expected SOAP response element <" + soap.expectedResponseElement + "> not found").to.match(new RegExp(${JSON.stringify(responseRegex)}));`,
       "});"
     );
+    warnings.push(`SOAP_RESPONSE_BODY_WRAPPER_ONLY: operation ${operation.name} asserts the SOAP envelope/body/fault and the top-level response element <${operation.expectedResponseElement}> but NOT its child element/scalar shapes (WSDL/XSD payload validation is out of scope)`);
   } else if (operation.output) {
     warnings.push(`SOAP_RESPONSE_ELEMENT_UNKNOWN: operation ${operation.name} has an output message but no resolvable response element; only Envelope/Body/Fault are asserted`);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@postman-cse/onboarding-bootstrap",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "description": "Bootstrap Postman workspaces, specs, and collections from OpenAPI.",
   "type": "module",
   "main": "dist/index.cjs",