@cosyte/synth 0.0.9 → 0.1.0

package/dist/{providers-B9uVinAe.d.cts → providers-BQtPk3PN.d.cts}

@@ -171,9 +171,23 @@ interface SyntheticIdentifier {
 /** Which SSN reserved space to draw from. */
 type SsnBlock = "never-issued" | "advertising";
 /**
- * A **synthetic SSN**: dashed `AAA-GG-SSSS`. Default draws the SSA never-issued area space
- * (`900–999`); `block: "advertising"` draws SSA's reserved advertising block (`987-65-4320…4329`).
- * A value from this function can never be a real SSN.
+ * A **synthetic SSN**: dashed `AAA-GG-SSSS`, drawn so it can be neither an SSA-assignable Social
+ * Security number nor a validly formatted IRS ITIN. Two authorities share this number space: SSA
+ * never issues area `900-999`, and the IRS issues ITINs *inside* that area, distinguished by the
+ * group digits. So the area rule alone is only half the guarantee, and both blocks below also keep
+ * the group outside every published ITIN group range (see {@link isItinFormatted}).
+ *
+ * Default draws the never-issued area space (`900-999`) with a group from
+ * {@link SSN_SYNTHETIC_GROUPS}; `block: "advertising"` returns the fixed display block
+ * `987-00-4320` to `987-00-4329`, whose group `00` is one SSA never assigns and one no published
+ * ITIN range contains.
+ *
+ * **`"advertising"` no longer means SSA's own advertising block.** That published block is
+ * `987-65-4320` to `987-65-4329`, and group `65` sits inside a published ITIN group range, so every
+ * value in it is ITIN-formatted and none of them can be emitted here. The option keeps its name
+ * (renaming it would break call sites for a property no test asserts) and keeps its purpose, a fixed
+ * ten-value block safe to print on screen, but it is a display block of this package's choosing now,
+ * not a citation of SSA's. Do not reintroduce the `65` group to recover the provenance.
  *
  * @param rng - The seeded generator.
  * @param block - Which reserved space to draw from. Defaults to `"never-issued"`.
@@ -181,7 +195,7 @@ type SsnBlock = "never-issued" | "advertising";
  * @example
  * ```ts
  * import { createRng, ssn } from "@cosyte/synth";
- * ssn(createRng(1)); // e.g. a 900-area, never-issued SSN
+ * ssn(createRng(1)); // e.g. a 900-area, never-issued, never-ITIN-formatted SSN
  * ```
  */
 declare function ssn(rng: Rng, block?: SsnBlock): string;

package/dist/{providers-B9uVinAe.d.ts → providers-BQtPk3PN.d.ts}

@@ -171,9 +171,23 @@ interface SyntheticIdentifier {
 /** Which SSN reserved space to draw from. */
 type SsnBlock = "never-issued" | "advertising";
 /**
- * A **synthetic SSN**: dashed `AAA-GG-SSSS`. Default draws the SSA never-issued area space
- * (`900–999`); `block: "advertising"` draws SSA's reserved advertising block (`987-65-4320…4329`).
- * A value from this function can never be a real SSN.
+ * A **synthetic SSN**: dashed `AAA-GG-SSSS`, drawn so it can be neither an SSA-assignable Social
+ * Security number nor a validly formatted IRS ITIN. Two authorities share this number space: SSA
+ * never issues area `900-999`, and the IRS issues ITINs *inside* that area, distinguished by the
+ * group digits. So the area rule alone is only half the guarantee, and both blocks below also keep
+ * the group outside every published ITIN group range (see {@link isItinFormatted}).
+ *
+ * Default draws the never-issued area space (`900-999`) with a group from
+ * {@link SSN_SYNTHETIC_GROUPS}; `block: "advertising"` returns the fixed display block
+ * `987-00-4320` to `987-00-4329`, whose group `00` is one SSA never assigns and one no published
+ * ITIN range contains.
+ *
+ * **`"advertising"` no longer means SSA's own advertising block.** That published block is
+ * `987-65-4320` to `987-65-4329`, and group `65` sits inside a published ITIN group range, so every
+ * value in it is ITIN-formatted and none of them can be emitted here. The option keeps its name
+ * (renaming it would break call sites for a property no test asserts) and keeps its purpose, a fixed
+ * ten-value block safe to print on screen, but it is a display block of this package's choosing now,
+ * not a citation of SSA's. Do not reintroduce the `65` group to recover the provenance.
  *
  * @param rng - The seeded generator.
  * @param block - Which reserved space to draw from. Defaults to `"never-issued"`.
@@ -181,7 +195,7 @@ type SsnBlock = "never-issued" | "advertising";
  * @example
  * ```ts
  * import { createRng, ssn } from "@cosyte/synth";
- * ssn(createRng(1)); // e.g. a 900-area, never-issued SSN
+ * ssn(createRng(1)); // e.g. a 900-area, never-issued, never-ITIN-formatted SSN
  * ```
  */
 declare function ssn(rng: Rng, block?: SsnBlock): string;

package/dist/{quirk-HZdznAkM.d.ts → quirk-Bzx9g8KG.d.ts}

@@ -1,4 +1,4 @@
-import { m as SynthFormat } from './providers-B9uVinAe.js';
+import { m as SynthFormat } from './providers-BQtPk3PN.js';
 
 /**
  * `defineSynthProfile`: the growth-loop hook for site/vendor fixture recipes. A profile bundles the

package/dist/{quirk-IaHp4z7N.d.cts → quirk-C_lZrspq.d.cts}

@@ -1,4 +1,4 @@
-import { m as SynthFormat } from './providers-B9uVinAe.cjs';
+import { m as SynthFormat } from './providers-BQtPk3PN.cjs';
 
 /**
  * `defineSynthProfile`: the growth-loop hook for site/vendor fixture recipes. A profile bundles the

package/dist/x12/index.cjs

@@ -45,8 +45,7 @@ var SYNTH_FATAL_CODES = {
    * see `resolveKind`: a selector union is erased at run time, and a selector that falls through
    * either mislabels the fixture or hands the value to a peer builder that quotes it back.
    */
-  SYNTH_UNSUPPORTED_KIND: "SYNTH_UNSUPPORTED_KIND"
-};
+  SYNTH_UNSUPPORTED_KIND: "SYNTH_UNSUPPORTED_KIND"};
 var SYNTH_FATAL_MESSAGES = Object.freeze({
   SYNTH_UNSUPPORTED_FORMAT: "The requested format is not generable by this build. A generator has no byte fallback: it builds through a parser's own serializer or it refuses.",
   SYNTH_UNSUPPORTED_QUIRK: "The requested vendor quirk is not in the target format's quirk registry. Compare the request against that format's exported registry (HL7_QUIRKS, CCDA_QUIRKS, ASTM_QUIRKS).",
@@ -57,7 +56,8 @@ var SYNTH_FATAL_MESSAGES = Object.freeze({
   SYNTH_INVALID_RANGE: "An integer range was requested with its maximum below its minimum.",
   SYNTH_EMPTY_POOL: "A value was drawn from an empty pool.",
   SYNTH_INVALID_PROFILE: "defineSynthProfile requires a non-empty string name.",
-  SYNTH_UNSUPPORTED_KIND: "The requested kind, document type, corpus mix entry, variant or profile is not one this generator supports. The supported set is the exported union for that option."
+  SYNTH_UNSUPPORTED_KIND: "The requested kind, document type, corpus mix entry, variant or profile is not one this generator supports. The supported set is the exported union for that option.",
+  SYNTH_PROFILE_NOT_GENERATED: "The requested profile is published by the adopted implementation guide, and this build does not generate it. The coverage surface reports, per adopted profile, whether it is generated."
 });
 var SynthError = class extends Error {
   /** The stable fatal code. */
@@ -143,7 +143,7 @@ function money(n) {
 var SYNTHETIC_ASSIGNING_AUTHORITY = Object.freeze({
   /** The human-readable assigning-authority namespace id (HL7 HD.1). */
   namespaceId: "COSYTE-SYNTH",
-  /** The universal id, an OID under HL7's example arc `2.16.840.1.113883.19` (HD.2). */
+  /** The universal id, an OID this package chose under the root `2.16.840.1.113883.19` (HD.2). */
   universalId: "2.16.840.1.113883.19.999",
   /** The universal id type (HD.3). */
   universalIdType: "ISO"
@@ -162,6 +162,18 @@ var TEST_NET_V4_PREFIXES = Object.freeze([
   // TEST-NET-3
 ]);
 var DOC_V6_PREFIX = "2001:db8";
+var ITIN_GROUP_RANGES = Object.freeze([
+  Object.freeze({ min: 50, max: 65 }),
+  Object.freeze({ min: 70, max: 88 }),
+  Object.freeze({ min: 90, max: 92 }),
+  Object.freeze({ min: 94, max: 99 })
+]);
+var ITIN_EXCLUDED_GROUPS = Object.freeze([89, 93]);
+var SSN_SYNTHETIC_GROUPS = Object.freeze(
+  Array.from({ length: 100 }, (_unused, group) => group).filter(
+    (group) => !ITIN_GROUP_RANGES.some((range) => group >= range.min && group <= range.max) && !ITIN_EXCLUDED_GROUPS.includes(group)
+  ).map((group) => String(group).padStart(2, "0"))
+);
 var NPI_LUHN_PREFIX = "80840";
 function luhnMod10(digits) {
   let sum = 0;
@@ -270,10 +282,10 @@ var SYNTHETIC_CITY_NAMES = Object.freeze([
 // src/safe/providers.ts
 function ssn(rng, block = "never-issued") {
   if (block === "advertising") {
-    return `987-65-432${String(rng.int(0, 9))}`;
+    return `987-00-432${String(rng.int(0, 9))}`;
   }
   const area = rng.int(900, 999);
-  const group = rng.digits(2);
+  const group = rng.pick(SSN_SYNTHETIC_GROUPS);
   const serial = rng.digits(4);
   return `${String(area)}-${group}-${serial}`;
 }