@cosyte/x12 0.0.5 → 0.0.6

package/dist/index.d.cts

@@ -12528,8 +12528,20 @@ interface InterchangeSpec {
 declare function buildInterchange(spec: InterchangeSpec): X12Interchange;
 
 /**
- * The single route a caller-supplied value takes into a `build*` refusal
- * message.
+ * The single route a caller-supplied value takes into a refusal message
+ * thrown by this library: every `build*` refusal, and every
+ * `defineProfile()` refusal.
+ *
+ * ## The names say `BUILD_REFUSAL_*` and the scope is wider than that
+ *
+ * The two exported constants were introduced by `X12-BUILDER-BOUNDS`, which
+ * bounded the `build*` sites only, and they are published under those names.
+ * `X12-CALLER-VALUE-RESIDUALS` then routed `src/profiles/validate.ts` through
+ * the same renderers, so `X12ProfileError` is bounded by the same numbers.
+ * **The names were deliberately NOT changed**: one ceiling under one name
+ * cannot drift, whereas a second name for the same number is exactly how two
+ * bounds start disagreeing. Read `BUILD_REFUSAL_` as naming where the bound was
+ * introduced, not the only place it applies.
  *
  * ## Why this exists
  *
@@ -12586,8 +12598,9 @@ declare function buildInterchange(spec: InterchangeSpec): X12Interchange;
  * mirrors, which is the one deliberate place a *document's* bytes are copied.
  */
 /**
- * How many characters of a caller-supplied value survive into a `build*`
- * refusal message. Set to mirror the parser's own `SNIPPET_MAX_INPUT` (63),
+ * How many characters of a caller-supplied value survive into a refusal
+ * message, whether it comes from a `build*` function or from
+ * `defineProfile()`. Set to mirror the parser's own `SNIPPET_MAX_INPUT` (63),
  * so the two bounded copies in this library agree rather than each picking a
  * number. Comfortably wider than every slot it guards: an ISA-13 / IEA-02
  * control number is 9, a TA1-05 note code 3, an ST-01 transaction set id 3, an
@@ -12604,6 +12617,8 @@ declare const BUILD_REFUSAL_VALUE_MAX_LENGTH = 63;
  * Hard ceiling, in characters, on the fragment {@link renderCallerValue}
  * returns: {@link BUILD_REFUSAL_VALUE_MAX_LENGTH} surviving characters, two
  * quotes, one ellipsis, and the ` (N characters)` suffix at its widest.
+ * {@link renderCallerJson} is held to the same ceiling and comes in two
+ * characters under it, because JSON supplies its own quotes.
  *
  * **This is the bound on the FRAGMENT, not on the message.** A refusal message
  * is this plus the site's own fixed template text, which differs per site, so

package/dist/index.d.ts

@@ -12528,8 +12528,20 @@ interface InterchangeSpec {
 declare function buildInterchange(spec: InterchangeSpec): X12Interchange;
 
 /**
- * The single route a caller-supplied value takes into a `build*` refusal
- * message.
+ * The single route a caller-supplied value takes into a refusal message
+ * thrown by this library: every `build*` refusal, and every
+ * `defineProfile()` refusal.
+ *
+ * ## The names say `BUILD_REFUSAL_*` and the scope is wider than that
+ *
+ * The two exported constants were introduced by `X12-BUILDER-BOUNDS`, which
+ * bounded the `build*` sites only, and they are published under those names.
+ * `X12-CALLER-VALUE-RESIDUALS` then routed `src/profiles/validate.ts` through
+ * the same renderers, so `X12ProfileError` is bounded by the same numbers.
+ * **The names were deliberately NOT changed**: one ceiling under one name
+ * cannot drift, whereas a second name for the same number is exactly how two
+ * bounds start disagreeing. Read `BUILD_REFUSAL_` as naming where the bound was
+ * introduced, not the only place it applies.
  *
  * ## Why this exists
  *
@@ -12586,8 +12598,9 @@ declare function buildInterchange(spec: InterchangeSpec): X12Interchange;
  * mirrors, which is the one deliberate place a *document's* bytes are copied.
  */
 /**
- * How many characters of a caller-supplied value survive into a `build*`
- * refusal message. Set to mirror the parser's own `SNIPPET_MAX_INPUT` (63),
+ * How many characters of a caller-supplied value survive into a refusal
+ * message, whether it comes from a `build*` function or from
+ * `defineProfile()`. Set to mirror the parser's own `SNIPPET_MAX_INPUT` (63),
  * so the two bounded copies in this library agree rather than each picking a
  * number. Comfortably wider than every slot it guards: an ISA-13 / IEA-02
  * control number is 9, a TA1-05 note code 3, an ST-01 transaction set id 3, an
@@ -12604,6 +12617,8 @@ declare const BUILD_REFUSAL_VALUE_MAX_LENGTH = 63;
  * Hard ceiling, in characters, on the fragment {@link renderCallerValue}
  * returns: {@link BUILD_REFUSAL_VALUE_MAX_LENGTH} surviving characters, two
  * quotes, one ellipsis, and the ` (N characters)` suffix at its widest.
+ * {@link renderCallerJson} is held to the same ceiling and comes in two
+ * characters under it, because JSON supplies its own quotes.
  *
  * **This is the bound on the FRAGMENT, not on the message.** A refusal message
  * is this plus the site's own fixed template text, which differs per site, so