@budiauktioner/buildi-primitives 0.1.0 → 0.2.0

package/dist/esm/contact/contact-address.js

@@ -0,0 +1,122 @@
+import { PrimitivesDefaults } from "../primitives-defaults.js";
+import { SwedishOrganizationName } from "../organization/swedish-organization-name.js";
+import { PersonFullName } from "../person/person-full-name.js";
+import { Address } from "./address.js";
+class ContactAddress {
+  static typeInfo = Object.freeze({
+    englishName: "Contact Address",
+    localizedName: "Kontaktuppgift",
+    emoji: "\u{1F4EC}",
+    sources: Object.freeze([])
+  });
+  personName;
+  organizationName;
+  address;
+  get hasPersonName() {
+    return this.personName !== null;
+  }
+  get hasOrganizationName() {
+    return this.organizationName !== null;
+  }
+  get hasAddress() {
+    return this.address !== null;
+  }
+  constructor(personName, organizationName, address) {
+    this.personName = personName;
+    this.organizationName = organizationName;
+    this.address = address;
+  }
+  static create(personName = null, organizationName = null, address = null) {
+    if (personName === null && organizationName === null && address === null) {
+      throw new Error("At least one of personName, organizationName, or address must be provided.");
+    }
+    return new ContactAddress(personName, organizationName, address);
+  }
+  static builder() {
+    return new ContactAddressBuilder();
+  }
+  toMultilineString() {
+    const lines = [];
+    if (this.personName) lines.push(this.personName.value);
+    if (this.organizationName) lines.push(this.organizationName.value);
+    if (this.address) lines.push(this.address.toMultilineString());
+    return lines.join("\n");
+  }
+  toDisplayString() {
+    return this.buildSingleLine(!PrimitivesDefaults.useLocalizedDisplayNames);
+  }
+  toEnglishString() {
+    return this.buildSingleLine(true);
+  }
+  toNativeString() {
+    const parts = this.buildNameParts();
+    if (this.address) parts.push(this.address.toNativeString());
+    return parts.join(", ");
+  }
+  toString() {
+    return this.toDisplayString();
+  }
+  buildSingleLine(useEnglish) {
+    const parts = this.buildNameParts();
+    if (this.address) {
+      parts.push(useEnglish ? this.address.toEnglishString() : this.address.toDisplayString());
+    }
+    return parts.join(", ");
+  }
+  buildNameParts() {
+    const parts = [];
+    if (this.personName) parts.push(this.personName.value);
+    if (this.organizationName) parts.push(this.organizationName.value);
+    return parts;
+  }
+}
+class ContactAddressBuilder {
+  personName = null;
+  organizationName = null;
+  address = null;
+  withPersonName(value) {
+    if (value instanceof PersonFullName) this.personName = value;
+    else {
+      const parsed = PersonFullName.tryParse(value);
+      if (parsed) this.personName = parsed;
+    }
+    return this;
+  }
+  withOrganizationName(value) {
+    if (value instanceof SwedishOrganizationName) this.organizationName = value;
+    else {
+      const parsed = SwedishOrganizationName.tryParse(value);
+      if (parsed) this.organizationName = parsed;
+    }
+    return this;
+  }
+  withAddress(valueOrStreet, zipCode, city, country) {
+    if (valueOrStreet instanceof Address) {
+      this.address = valueOrStreet;
+      return this;
+    }
+    const parsed = zipCode !== void 0 || city !== void 0 || country !== void 0 ? Address.tryParse({ street: valueOrStreet, zipCode, city, country }) : Address.tryParse(valueOrStreet);
+    if (parsed) this.address = parsed;
+    return this;
+  }
+  tryBuild() {
+    if (this.personName === null && this.organizationName === null && this.address === null) {
+      return null;
+    }
+    return ContactAddress.create(this.personName, this.organizationName, this.address);
+  }
+  build() {
+    const result = this.tryBuild();
+    if (result === null) {
+      throw new Error(
+        "At least one of person name, organization name, or address must be provided."
+      );
+    }
+    return result;
+  }
+}
+export {
+  ContactAddress,
+  ContactAddressBuilder
+};
+//# sourceMappingURL=contact-address.js.map

package/dist/esm/contact/contact-address.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/contact/contact-address.ts"],
+  "sourcesContent": ["import { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { PrimitivesDefaults } from \"../primitives-defaults.js\";\nimport { SwedishOrganizationName } from \"../organization/swedish-organization-name.js\";\nimport { PersonFullName } from \"../person/person-full-name.js\";\nimport { Address } from \"./address.js\";\n\n/** A contact address combining optional person name, organization name, and postal address. */\nexport class ContactAddress {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Contact Address\",\n    localizedName: \"Kontaktuppgift\",\n    emoji: \"\\u{1F4EC}\",\n    sources: Object.freeze([]),\n  });\n\n  readonly personName: PersonFullName | null;\n  readonly organizationName: SwedishOrganizationName | null;\n  readonly address: Address | null;\n\n  get hasPersonName(): boolean {\n    return this.personName !== null;\n  }\n\n  get hasOrganizationName(): boolean {\n    return this.organizationName !== null;\n  }\n\n  get hasAddress(): boolean {\n    return this.address !== null;\n  }\n\n  private constructor(\n    personName: PersonFullName | null,\n    organizationName: SwedishOrganizationName | null,\n    address: Address | null,\n  ) {\n    this.personName = personName;\n    this.organizationName = organizationName;\n    this.address = address;\n  }\n\n  static create(\n    personName: PersonFullName | null = null,\n    organizationName: SwedishOrganizationName | null = null,\n    address: Address | null = null,\n  ): ContactAddress {\n    if (personName === null && organizationName === null && address === null) {\n      throw new Error(\"At least one of personName, organizationName, or address must be provided.\");\n    }\n    return new ContactAddress(personName, organizationName, address);\n  }\n\n  static builder(): ContactAddressBuilder {\n    return new ContactAddressBuilder();\n  }\n\n  toMultilineString(): string {\n    const lines: string[] = [];\n    if (this.personName) lines.push(this.personName.value);\n    if (this.organizationName) lines.push(this.organizationName.value);\n    if (this.address) lines.push(this.address.toMultilineString());\n    return lines.join(\"\\n\");\n  }\n\n  toDisplayString(): string {\n    return this.buildSingleLine(!PrimitivesDefaults.useLocalizedDisplayNames);\n  }\n\n  toEnglishString(): string {\n    return this.buildSingleLine(true);\n  }\n\n  toNativeString(): string {\n    const parts = this.buildNameParts();\n    if (this.address) parts.push(this.address.toNativeString());\n    return parts.join(\", \");\n  }\n\n  toString(): string {\n    return this.toDisplayString();\n  }\n\n  private buildSingleLine(useEnglish: boolean): string {\n    const parts = this.buildNameParts();\n    if (this.address) {\n      parts.push(useEnglish ? this.address.toEnglishString() : this.address.toDisplayString());\n    }\n    return parts.join(\", \");\n  }\n\n  private buildNameParts(): string[] {\n    const parts: string[] = [];\n    if (this.personName) parts.push(this.personName.value);\n    if (this.organizationName) parts.push(this.organizationName.value);\n    return parts;\n  }\n}\n\n/** Fluent builder for creating a ContactAddress from parsed instances or raw strings. */\nexport class ContactAddressBuilder {\n  private personName: PersonFullName | null = null;\n  private organizationName: SwedishOrganizationName | null = null;\n  private address: Address | null = null;\n\n  withPersonName(value: string | PersonFullName | null | undefined): ContactAddressBuilder {\n    if (value instanceof PersonFullName) this.personName = value;\n    else {\n      const parsed = PersonFullName.tryParse(value);\n      if (parsed) this.personName = parsed;\n    }\n    return this;\n  }\n\n  withOrganizationName(\n    value: string | SwedishOrganizationName | null | undefined,\n  ): ContactAddressBuilder {\n    if (value instanceof SwedishOrganizationName) this.organizationName = value;\n    else {\n      const parsed = SwedishOrganizationName.tryParse(value);\n      if (parsed) this.organizationName = parsed;\n    }\n    return this;\n  }\n\n  withAddress(value: string | Address | null | undefined): ContactAddressBuilder;\n  withAddress(\n    street: string | null | undefined,\n    zipCode: string | null | undefined,\n    city: string | null | undefined,\n    country?: string | null,\n  ): ContactAddressBuilder;\n  withAddress(\n    valueOrStreet: string | Address | null | undefined,\n    zipCode?: string | null,\n    city?: string | null,\n    country?: string | null,\n  ): ContactAddressBuilder {\n    if (valueOrStreet instanceof Address) {\n      this.address = valueOrStreet;\n      return this;\n    }\n\n    const parsed =\n      zipCode !== undefined || city !== undefined || country !== undefined\n        ? Address.tryParse({ street: valueOrStreet, zipCode, city, country })\n        : Address.tryParse(valueOrStreet);\n    if (parsed) this.address = parsed;\n    return this;\n  }\n\n  tryBuild(): ContactAddress | null {\n    if (this.personName === null && this.organizationName === null && this.address === null) {\n      return null;\n    }\n    return ContactAddress.create(this.personName, this.organizationName, this.address);\n  }\n\n  build(): ContactAddress {\n    const result = this.tryBuild();\n    if (result === null) {\n      throw new Error(\n        \"At least one of person name, organization name, or address must be provided.\",\n      );\n    }\n    return result;\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/contact/contact-external-links.js

@@ -0,0 +1,19 @@
+function getGoogleMapsUrl(address) {
+  return new URL(
+    `https://www.google.com/maps/search/?api=1&query=${encodeURIComponent(address.toString())}`
+  );
+}
+function getBingMapsUrl(address) {
+  return new URL(`https://www.bing.com/maps?q=${encodeURIComponent(address.toString())}`);
+}
+function getHittaUrl(phone) {
+  return new URL(
+    `https://www.hitta.se/s\xF6k?vad=${encodeURIComponent(phone.toInternationalString())}`
+  );
+}
+export {
+  getBingMapsUrl,
+  getGoogleMapsUrl,
+  getHittaUrl
+};
+//# sourceMappingURL=contact-external-links.js.map

package/dist/esm/contact/contact-external-links.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/contact/contact-external-links.ts"],
+  "sourcesContent": ["import { Address } from \"./address.js\";\nimport { PhoneNumber } from \"./phone-number.js\";\nimport { SwedishAddress } from \"./swedish-address.js\";\n\n/** Google Maps search URL for an address. */\nexport function getGoogleMapsUrl(address: Address | SwedishAddress): URL {\n  return new URL(\n    `https://www.google.com/maps/search/?api=1&query=${encodeURIComponent(address.toString())}`,\n  );\n}\n\n/** Bing Maps search URL for an address. */\nexport function getBingMapsUrl(address: Address | SwedishAddress): URL {\n  return new URL(`https://www.bing.com/maps?q=${encodeURIComponent(address.toString())}`);\n}\n\n/** Hitta.se search URL for a phone number. */\nexport function getHittaUrl(phone: PhoneNumber): URL {\n  return new URL(\n    `https://www.hitta.se/s\u00F6k?vad=${encodeURIComponent(phone.toInternationalString())}`,\n  );\n}\n"],
+  "mappings": "AAKO,SAAS,iBAAiB,SAAwC;AACvE,SAAO,IAAI;AAAA,IACT,mDAAmD,mBAAmB,QAAQ,SAAS,CAAC,CAAC;AAAA,EAC3F;AACF;AAGO,SAAS,eAAe,SAAwC;AACrE,SAAO,IAAI,IAAI,+BAA+B,mBAAmB,QAAQ,SAAS,CAAC,CAAC,EAAE;AACxF;AAGO,SAAS,YAAY,OAAyB;AACnD,SAAO,IAAI;AAAA,IACT,mCAAgC,mBAAmB,MAAM,sBAAsB,CAAC,CAAC;AAAA,EACnF;AACF;",
+  "names": []
+}

package/dist/esm/contact/contact-lookup.js

@@ -0,0 +1,11 @@
+function getTelUri(phone) {
+  return `tel:${phone.toNormalizedString()}`;
+}
+function getGoogleMapsUrlForAddress(address) {
+  return `https://www.google.com/maps/search/?api=1&query=${encodeURIComponent(address.toString())}`;
+}
+export {
+  getGoogleMapsUrlForAddress,
+  getTelUri
+};
+//# sourceMappingURL=contact-lookup.js.map

package/dist/esm/contact/contact-lookup.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/contact/contact-lookup.ts"],
+  "sourcesContent": ["import { Address } from \"./address.js\";\nimport { PhoneNumber } from \"./phone-number.js\";\nimport { SwedishAddress } from \"./swedish-address.js\";\n\n/** Returns a `tel:` URI, e.g. `tel:0046701740633`. */\nexport function getTelUri(phone: PhoneNumber): string {\n  return `tel:${phone.toNormalizedString()}`;\n}\n\n/** Google Maps search URL for an address. */\nexport function getGoogleMapsUrlForAddress(address: Address | SwedishAddress): string {\n  return `https://www.google.com/maps/search/?api=1&query=${encodeURIComponent(address.toString())}`;\n}\n"],
+  "mappings": "AAKO,SAAS,UAAU,OAA4B;AACpD,SAAO,OAAO,MAAM,mBAAmB,CAAC;AAC1C;AAGO,SAAS,2BAA2B,SAA2C;AACpF,SAAO,mDAAmD,mBAAmB,QAAQ,SAAS,CAAC,CAAC;AAClG;",
+  "names": []
+}

package/dist/esm/contact/contact-masking.js

@@ -0,0 +1,97 @@
+const MASK = "*";
+function maskAddressZipCode(zip) {
+  return [...zip.formatted].map((c) => c === " " ? " " : MASK).join("");
+}
+function maskSwedishAddressZipCode(zip) {
+  return maskAddressZipCode(zip.zipCode);
+}
+function maskAddressCity(city) {
+  const v = city.value;
+  if (v.length <= 1) return MASK.repeat(v.length);
+  return v[0] + MASK.repeat(v.length - 1);
+}
+function maskAddressStreet(street) {
+  if (street.streetName === null) return MASK.repeat(street.street.length);
+  if (street.streetNumber === null) return street.streetName;
+  return `${street.streetName} ${MASK.repeat(street.streetNumber.length)}`;
+}
+function maskAddress(address) {
+  let out = "";
+  if (address.careOf) out += `c/o ${maskKeepFirst(address.careOf, 1)}, `;
+  if (address.isPostBox && address.postBox) {
+    out += `Box ${MASK.repeat(address.postBox.length)}`;
+  } else {
+    if (address.street.streetName !== null) out += address.street.streetName;
+    else out += address.street.street;
+    if (address.street.streetNumber !== null) {
+      out += ` ${MASK.repeat(address.street.streetNumber.length)}`;
+    }
+    if (address.apartmentNumber) {
+      out += ` lgh ${MASK.repeat(address.apartmentNumber.length)}`;
+    }
+  }
+  if (address.zipCode !== null) {
+    out += ", ";
+    out += maskAddressZipCode(address.zipCode);
+  }
+  if (address.city !== null) {
+    out += address.zipCode !== null ? " " : ", ";
+    out += address.city.value;
+  }
+  if (address.country !== null) {
+    out += ", ";
+    out += address.country.localizedName;
+  }
+  return out;
+}
+function maskSwedishAddress(address) {
+  return maskAddress(address.address);
+}
+function maskPhoneNumberDetailed(phone, visibleDigitsAtEnd = 2) {
+  const formatted = phone.toString();
+  let visiblePrefix;
+  if (phone.isSwedish) {
+    const local = phone.toLocalString();
+    const dash = local.indexOf("-");
+    visiblePrefix = dash > 0 ? countDigits(local.slice(0, dash)) : 3;
+  } else {
+    visiblePrefix = phone.countryCallingCode.value.length;
+  }
+  const totalDigits = countDigits(formatted);
+  const revealEnd = Math.min(
+    Math.max(0, visibleDigitsAtEnd),
+    Math.max(0, totalDigits - visiblePrefix)
+  );
+  const maskEnd = totalDigits - revealEnd;
+  let digitIdx = 0;
+  let out = "";
+  for (const c of formatted) {
+    if (c >= "0" && c <= "9") {
+      if (digitIdx >= visiblePrefix && digitIdx < maskEnd) out += MASK;
+      else out += c;
+      digitIdx++;
+    } else {
+      out += c;
+    }
+  }
+  return out;
+}
+function countDigits(s) {
+  let n = 0;
+  for (const c of s) if (c >= "0" && c <= "9") n++;
+  return n;
+}
+function maskKeepFirst(value, visible) {
+  if (value.length <= visible) return value;
+  return value.slice(0, visible) + MASK.repeat(value.length - visible);
+}
+export {
+  maskAddress,
+  maskAddressCity,
+  maskAddressStreet,
+  maskAddressZipCode,
+  maskPhoneNumberDetailed,
+  maskSwedishAddress,
+  maskSwedishAddressZipCode
+};
+//# sourceMappingURL=contact-masking.js.map

package/dist/esm/contact/contact-masking.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/contact/contact-masking.ts"],
+  "sourcesContent": ["import { Address } from \"./address.js\";\nimport { AddressCity } from \"./address-city.js\";\nimport { AddressStreet } from \"./address-street.js\";\nimport { AddressZipCode } from \"./address-zip-code.js\";\nimport { PhoneNumber } from \"./phone-number.js\";\nimport { SwedishAddress } from \"./swedish-address.js\";\nimport { SwedishAddressZipCode } from \"./swedish-address-zip-code.js\";\n\nconst MASK = \"*\";\n\n/** Mask each digit in a zip code while preserving spaces, e.g. `114 53` \u2192 `*** **`. */\nexport function maskAddressZipCode(zip: AddressZipCode): string {\n  return [...zip.formatted].map((c) => (c === \" \" ? \" \" : MASK)).join(\"\");\n}\n\n/** Mask Swedish zip code (delegates to the wrapped `AddressZipCode`). */\nexport function maskSwedishAddressZipCode(zip: SwedishAddressZipCode): string {\n  return maskAddressZipCode(zip.zipCode);\n}\n\n/** Mask city name showing only the first character, e.g. `Stockholm` \u2192 `S********`. */\nexport function maskAddressCity(city: AddressCity): string {\n  const v = city.value;\n  if (v.length <= 1) return MASK.repeat(v.length);\n  return v[0]! + MASK.repeat(v.length - 1);\n}\n\n/** Mask street keeping street name but masking the house number, e.g. `Storgatan 12` \u2192 `Storgatan **`. */\nexport function maskAddressStreet(street: AddressStreet): string {\n  if (street.streetName === null) return MASK.repeat(street.street.length);\n  if (street.streetNumber === null) return street.streetName;\n  return `${street.streetName} ${MASK.repeat(street.streetNumber.length)}`;\n}\n\n/**\n * Mask a complete address, preserving street name, city, and country while masking\n * house number, apartment number, and zip code.\n */\nexport function maskAddress(address: Address): string {\n  let out = \"\";\n  if (address.careOf) out += `c/o ${maskKeepFirst(address.careOf, 1)}, `;\n  if (address.isPostBox && address.postBox) {\n    out += `Box ${MASK.repeat(address.postBox.length)}`;\n  } else {\n    if (address.street.streetName !== null) out += address.street.streetName;\n    else out += address.street.street;\n    if (address.street.streetNumber !== null) {\n      out += ` ${MASK.repeat(address.street.streetNumber.length)}`;\n    }\n    if (address.apartmentNumber) {\n      out += ` lgh ${MASK.repeat(address.apartmentNumber.length)}`;\n    }\n  }\n  if (address.zipCode !== null) {\n    out += \", \";\n    out += maskAddressZipCode(address.zipCode);\n  }\n  if (address.city !== null) {\n    out += address.zipCode !== null ? \" \" : \", \";\n    out += address.city.value;\n  }\n  if (address.country !== null) {\n    out += \", \";\n    out += address.country.localizedName;\n  }\n  return out;\n}\n\n/** Mask a Swedish address (delegates to the wrapped generic `Address`). */\nexport function maskSwedishAddress(address: SwedishAddress): string {\n  return maskAddress(address.address);\n}\n\n/**\n * Mask a phone number, keeping country/area code prefix and the last\n * `visibleDigitsAtEnd` digits visible.\n */\nexport function maskPhoneNumberDetailed(phone: PhoneNumber, visibleDigitsAtEnd = 2): string {\n  const formatted = phone.toString();\n\n  let visiblePrefix: number;\n  if (phone.isSwedish) {\n    const local = phone.toLocalString();\n    const dash = local.indexOf(\"-\");\n    visiblePrefix = dash > 0 ? countDigits(local.slice(0, dash)) : 3;\n  } else {\n    visiblePrefix = phone.countryCallingCode.value.length;\n  }\n\n  const totalDigits = countDigits(formatted);\n  const revealEnd = Math.min(\n    Math.max(0, visibleDigitsAtEnd),\n    Math.max(0, totalDigits - visiblePrefix),\n  );\n  const maskEnd = totalDigits - revealEnd;\n\n  let digitIdx = 0;\n  let out = \"\";\n  for (const c of formatted) {\n    if (c >= \"0\" && c <= \"9\") {\n      if (digitIdx >= visiblePrefix && digitIdx < maskEnd) out += MASK;\n      else out += c;\n      digitIdx++;\n    } else {\n      out += c;\n    }\n  }\n  return out;\n}\n\nfunction countDigits(s: string): number {\n  let n = 0;\n  for (const c of s) if (c >= \"0\" && c <= \"9\") n++;\n  return n;\n}\n\nfunction maskKeepFirst(value: string, visible: number): string {\n  if (value.length <= visible) return value;\n  return value.slice(0, visible) + MASK.repeat(value.length - visible);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/contact/country-address-factory.js

@@ -0,0 +1,80 @@
+import { Address } from "./address.js";
+import {
+  CountryAddressBase,
+  tryWrapCountryAddress
+} from "./country-address.js";
+class CountryAddress extends CountryAddressBase {
+  zipCode;
+  constructor(street, zipCode, city, address) {
+    super(street, city, address);
+    this.zipCode = zipCode;
+  }
+  get countryZipCode() {
+    return this.zipCode;
+  }
+}
+function defineCountryAddress(config) {
+  const typeInfo = Object.freeze({
+    englishName: config.englishName,
+    localizedName: config.localizedName,
+    emoji: config.emoji,
+    sources: Object.freeze([...config.sources])
+  });
+  const tryWrap = (address) => tryWrapCountryAddress(
+    address,
+    config.country.alpha2Code,
+    config.country,
+    (v) => config.zipCode.tryParse(v),
+    (s, z, c, a) => new CountryAddress(s, z, c, a)
+  );
+  const tryParse = (input) => {
+    const a = Address.tryParse(input);
+    if (a === null) return null;
+    return tryWrap(a);
+  };
+  const stat = {
+    typeInfo,
+    country: config.country,
+    zipCodeType: config.zipCode,
+    tryWrap,
+    tryParse,
+    tryParseStructured(parts) {
+      const a = Address.tryParse(parts);
+      if (a === null) return null;
+      return tryWrap(a);
+    },
+    parse(input) {
+      const r = tryParse(input);
+      if (r === null) throw new Error(config.invalidMessage);
+      return r;
+    },
+    isValid(input) {
+      return tryParse(input) !== null;
+    },
+    format(input, options) {
+      const r = tryParse(input);
+      if (r) return r.toString();
+      if (options?.fallbackToTrimmedInputWhenInvalid && input != null && input.trim() !== "") {
+        return input.trim();
+      }
+      return null;
+    },
+    normalize(input, options) {
+      const r = tryParse(input);
+      if (r) return r.toNormalizedString();
+      if (options?.fallbackToTrimmedInputWhenInvalid && input != null) {
+        const t = input.trim();
+        return t.length > 0 ? t : null;
+      }
+      return null;
+    },
+    isNormalized(input) {
+      return input != null && stat.normalize(input) === input;
+    }
+  };
+  return stat;
+}
+export {
+  defineCountryAddress
+};
+//# sourceMappingURL=country-address-factory.js.map

package/dist/esm/contact/country-address-factory.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/contact/country-address-factory.ts"],
+  "sourcesContent": ["import { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { Country } from \"../geography/index.js\";\nimport { Address } from \"./address.js\";\nimport { AddressCity } from \"./address-city.js\";\nimport { AddressStreet } from \"./address-street.js\";\nimport {\n  CountryAddressBase,\n  ICountryAddress,\n  ICountryAddressZipCode,\n  tryWrapCountryAddress,\n} from \"./country-address.js\";\nimport { CountryZipCodeStatic } from \"./country-zip-code-factory.js\";\n\nexport interface CountryAddressConfig<TZip extends ICountryAddressZipCode> {\n  englishName: string;\n  localizedName: string;\n  emoji: string;\n  sources: readonly string[];\n  country: Country;\n  invalidMessage: string;\n  zipCode: CountryZipCodeStatic<TZip>;\n}\n\nclass CountryAddress<TZip extends ICountryAddressZipCode> extends CountryAddressBase {\n  readonly zipCode: TZip;\n  constructor(street: AddressStreet, zipCode: TZip, city: AddressCity, address: Address) {\n    super(street, city, address);\n    this.zipCode = zipCode;\n  }\n  override get countryZipCode(): ICountryAddressZipCode {\n    return this.zipCode;\n  }\n}\n\nexport interface CountryAddressStatic<TZip extends ICountryAddressZipCode> {\n  readonly typeInfo: PrimitiveTypeInfo;\n  readonly country: Country;\n  /** The country's zip-code type. Used by the country-address registry. */\n  readonly zipCodeType: CountryZipCodeStatic<TZip>;\n  /** Wraps an already-parsed {@link Address}. Used by the country-address registry. */\n  tryWrap(address: Address): (ICountryAddress & { readonly zipCode: TZip }) | null;\n  tryParse(input: string | null | undefined): (ICountryAddress & { readonly zipCode: TZip }) | null;\n  tryParseStructured(parts: {\n    street: string | null | undefined;\n    zipCode?: string | null;\n    city?: string | null;\n    country?: string | null;\n  }): (ICountryAddress & { readonly zipCode: TZip }) | null;\n  parse(input: string): ICountryAddress;\n  isValid(input: string | null | undefined): boolean;\n  format(\n    input: string | null | undefined,\n    options?: { fallbackToTrimmedInputWhenInvalid?: boolean },\n  ): string | null;\n  normalize(\n    input: string | null | undefined,\n    options?: { fallbackToTrimmedInputWhenInvalid?: boolean },\n  ): string | null;\n  isNormalized(input: string | null | undefined): boolean;\n}\n\nexport function defineCountryAddress<TZip extends ICountryAddressZipCode>(\n  config: CountryAddressConfig<TZip>,\n): CountryAddressStatic<TZip> {\n  const typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: config.englishName,\n    localizedName: config.localizedName,\n    emoji: config.emoji,\n    sources: Object.freeze([...config.sources]),\n  });\n\n  const tryWrap = (address: Address): CountryAddress<TZip> | null =>\n    tryWrapCountryAddress(\n      address,\n      config.country.alpha2Code,\n      config.country,\n      (v) => config.zipCode.tryParse(v),\n      (s, z, c, a) => new CountryAddress<TZip>(s, z, c, a),\n    );\n\n  const tryParse = (input: string | null | undefined): CountryAddress<TZip> | null => {\n    const a = Address.tryParse(input);\n    if (a === null) return null;\n    return tryWrap(a);\n  };\n\n  const stat: CountryAddressStatic<TZip> = {\n    typeInfo,\n    country: config.country,\n    zipCodeType: config.zipCode,\n    tryWrap,\n    tryParse,\n    tryParseStructured(parts) {\n      const a = Address.tryParse(parts);\n      if (a === null) return null;\n      return tryWrap(a);\n    },\n    parse(input) {\n      const r = tryParse(input);\n      if (r === null) throw new Error(config.invalidMessage);\n      return r;\n    },\n    isValid(input) {\n      return tryParse(input) !== null;\n    },\n    format(input, options) {\n      const r = tryParse(input);\n      if (r) return r.toString();\n      if (options?.fallbackToTrimmedInputWhenInvalid && input != null && input.trim() !== \"\") {\n        return input.trim();\n      }\n      return null;\n    },\n    normalize(input, options) {\n      const r = tryParse(input);\n      if (r) return r.toNormalizedString();\n      if (options?.fallbackToTrimmedInputWhenInvalid && input != null) {\n        const t = input.trim();\n        return t.length > 0 ? t : null;\n      }\n      return null;\n    },\n    isNormalized(input) {\n      return input != null && stat.normalize(input) === input;\n    },\n  };\n  return stat;\n}\n"],
+  "mappings": "AAEA,SAAS,eAAe;AAGxB;AAAA,EACE;AAAA,EAGA;AAAA,OACK;AAaP,MAAM,uBAA4D,mBAAmB;AAAA,EAC1E;AAAA,EACT,YAAY,QAAuB,SAAe,MAAmB,SAAkB;AACrF,UAAM,QAAQ,MAAM,OAAO;AAC3B,SAAK,UAAU;AAAA,EACjB;AAAA,EACA,IAAa,iBAAyC;AACpD,WAAO,KAAK;AAAA,EACd;AACF;AA6BO,SAAS,qBACd,QAC4B;AAC5B,QAAM,WAA8B,OAAO,OAAO;AAAA,IAChD,aAAa,OAAO;AAAA,IACpB,eAAe,OAAO;AAAA,IACtB,OAAO,OAAO;AAAA,IACd,SAAS,OAAO,OAAO,CAAC,GAAG,OAAO,OAAO,CAAC;AAAA,EAC5C,CAAC;AAED,QAAM,UAAU,CAAC,YACf;AAAA,IACE;AAAA,IACA,OAAO,QAAQ;AAAA,IACf,OAAO;AAAA,IACP,CAAC,MAAM,OAAO,QAAQ,SAAS,CAAC;AAAA,IAChC,CAAC,GAAG,GAAG,GAAG,MAAM,IAAI,eAAqB,GAAG,GAAG,GAAG,CAAC;AAAA,EACrD;AAEF,QAAM,WAAW,CAAC,UAAkE;AAClF,UAAM,IAAI,QAAQ,SAAS,KAAK;AAChC,QAAI,MAAM,KAAM,QAAO;AACvB,WAAO,QAAQ,CAAC;AAAA,EAClB;AAEA,QAAM,OAAmC;AAAA,IACvC;AAAA,IACA,SAAS,OAAO;AAAA,IAChB,aAAa,OAAO;AAAA,IACpB;AAAA,IACA;AAAA,IACA,mBAAmB,OAAO;AACxB,YAAM,IAAI,QAAQ,SAAS,KAAK;AAChC,UAAI,MAAM,KAAM,QAAO;AACvB,aAAO,QAAQ,CAAC;AAAA,IAClB;AAAA,IACA,MAAM,OAAO;AACX,YAAM,IAAI,SAAS,KAAK;AACxB,UAAI,MAAM,KAAM,OAAM,IAAI,MAAM,OAAO,cAAc;AACrD,aAAO;AAAA,IACT;AAAA,IACA,QAAQ,OAAO;AACb,aAAO,SAAS,KAAK,MAAM;AAAA,IAC7B;AAAA,IACA,OAAO,OAAO,SAAS;AACrB,YAAM,IAAI,SAAS,KAAK;AACxB,UAAI,EAAG,QAAO,EAAE,SAAS;AACzB,UAAI,SAAS,qCAAqC,SAAS,QAAQ,MAAM,KAAK,MAAM,IAAI;AACtF,eAAO,MAAM,KAAK;AAAA,MACpB;AACA,aAAO;AAAA,IACT;AAAA,IACA,UAAU,OAAO,SAAS;AACxB,YAAM,IAAI,SAAS,KAAK;AACxB,UAAI,EAAG,QAAO,EAAE,mBAAmB;AACnC,UAAI,SAAS,qCAAqC,SAAS,MAAM;AAC/D,cAAM,IAAI,MAAM,KAAK;AACrB,eAAO,EAAE,SAAS,IAAI,IAAI;AAAA,MAC5B;AACA,aAAO;AAAA,IACT;AAAA,IACA,aAAa,OAAO;AAClB,aAAO,SAAS,QAAQ,KAAK,UAAU,KAAK,MAAM;AAAA,IACpD;AAAA,EACF;AACA,SAAO;AACT;",
+  "names": []
+}

package/dist/esm/contact/country-address-registry.js

@@ -0,0 +1,16 @@
+const registry = /* @__PURE__ */ new Map();
+function registerCountryAddress(registration) {
+  registry.set(registration.country.alpha2Code.toUpperCase(), registration);
+}
+function getCountryAddressRegistration(alpha2Code) {
+  return registry.get(alpha2Code.toUpperCase()) ?? null;
+}
+function getRegisteredCountryAddressCountries() {
+  return Object.freeze([...registry.values()].map((r) => r.country));
+}
+export {
+  getCountryAddressRegistration,
+  getRegisteredCountryAddressCountries,
+  registerCountryAddress
+};
+//# sourceMappingURL=country-address-registry.js.map

package/dist/esm/contact/country-address-registry.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/contact/country-address-registry.ts"],
+  "sourcesContent": ["import type { Country } from \"../geography/index.js\";\nimport type { Address } from \"./address.js\";\nimport type { ICountryAddress } from \"./country-address.js\";\n\n/**\n * A country-specific address implementation, registered by the module that\n * defines it.\n *\n * `Address` lives below the country-specific address types in the import graph,\n * so it cannot reference them directly. Each implementation registers itself on\n * module load instead, mirroring the static registry the .NET `Address` type\n * builds at type-initialization time.\n *\n * Registration happens in `registerDefaultCountryAddresses()`, which every\n * package entry point calls via `contact/index.ts`. Code inside this package\n * that deep-imports `address.ts` alone will only see the countries it\n * registered itself.\n */\nexport interface CountryAddressRegistration {\n  readonly country: Country;\n  readonly tryWrap: (address: Address) => ICountryAddress | null;\n  readonly formatZip: (value: string) => string | null;\n}\n\nconst registry = new Map<string, CountryAddressRegistration>();\n\n/** Registration order determines the order of `Address.supportedCountryAddressTypes`. */\nexport function registerCountryAddress(registration: CountryAddressRegistration): void {\n  registry.set(registration.country.alpha2Code.toUpperCase(), registration);\n}\n\nexport function getCountryAddressRegistration(\n  alpha2Code: string,\n): CountryAddressRegistration | null {\n  return registry.get(alpha2Code.toUpperCase()) ?? null;\n}\n\nexport function getRegisteredCountryAddressCountries(): readonly Country[] {\n  return Object.freeze([...registry.values()].map((r) => r.country));\n}\n"],
+  "mappings": "AAwBA,MAAM,WAAW,oBAAI,IAAwC;AAGtD,SAAS,uBAAuB,cAAgD;AACrF,WAAS,IAAI,aAAa,QAAQ,WAAW,YAAY,GAAG,YAAY;AAC1E;AAEO,SAAS,8BACd,YACmC;AACnC,SAAO,SAAS,IAAI,WAAW,YAAY,CAAC,KAAK;AACnD;AAEO,SAAS,uCAA2D;AACzE,SAAO,OAAO,OAAO,CAAC,GAAG,SAAS,OAAO,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC;AACnE;",
+  "names": []
+}

package/dist/esm/contact/country-address.js

@@ -0,0 +1,78 @@
+import { Address } from "./address.js";
+class CountryAddressZipCodeBase {
+  value;
+  formatted;
+  zipCode;
+  constructor(value, formatted, zipCode) {
+    this.value = value;
+    this.formatted = formatted;
+    this.zipCode = zipCode;
+  }
+  toNormalizedString() {
+    return this.value;
+  }
+  toString() {
+    return this.formatted;
+  }
+}
+class CountryAddressBase {
+  street;
+  city;
+  address;
+  get country() {
+    return this.address.country;
+  }
+  get careOf() {
+    return this.street.careOf;
+  }
+  get postBox() {
+    return this.street.postBox;
+  }
+  get isPostBox() {
+    return this.street.isPostBox;
+  }
+  get value() {
+    return this.toNormalizedString();
+  }
+  get formatted() {
+    return this.toString();
+  }
+  constructor(street, city, address) {
+    this.street = street;
+    this.city = city;
+    this.address = address;
+  }
+  toNormalizedString() {
+    return this.address.toNormalizedString();
+  }
+  toString() {
+    const parts = [];
+    if (this.careOf) parts.push(`c/o ${this.careOf}`);
+    parts.push(this.street.street);
+    parts.push(`${this.countryZipCode.formatted} ${this.city.value}`);
+    return parts.join(", ");
+  }
+  toMultilineString() {
+    const lines = [];
+    if (this.careOf) lines.push(`c/o ${this.careOf}`);
+    lines.push(this.street.street);
+    lines.push(`${this.countryZipCode.formatted} ${this.city.value}`);
+    return lines.join("\n");
+  }
+}
+function tryWrapCountryAddress(address, alpha2, defaultCountry, tryParseZip, factory) {
+  if (address.country && address.country.alpha2Code.toUpperCase() !== alpha2.toUpperCase()) {
+    return null;
+  }
+  if (address.zipCode === null || address.city === null) return null;
+  const zip = tryParseZip(address.zipCode.value);
+  if (zip === null) return null;
+  const withCountry = address.country !== null ? address : new Address(address.street, address.zipCode, address.city, defaultCountry);
+  return factory(address.street, zip, address.city, withCountry);
+}
+export {
+  CountryAddressBase,
+  CountryAddressZipCodeBase,
+  tryWrapCountryAddress
+};
+//# sourceMappingURL=country-address.js.map

package/dist/esm/contact/country-address.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/contact/country-address.ts"],
+  "sourcesContent": ["import { Country } from \"../geography/index.js\";\nimport { Address } from \"./address.js\";\nimport { AddressCity } from \"./address-city.js\";\nimport { AddressStreet } from \"./address-street.js\";\nimport { AddressZipCode } from \"./address-zip-code.js\";\n\n/** Common interface for all country-specific zip code types. */\nexport interface ICountryAddressZipCode {\n  readonly country: Country;\n  readonly value: string;\n  readonly formatted: string;\n  readonly zipCode: AddressZipCode;\n  toNormalizedString(): string;\n  toString(): string;\n}\n\n/** Common interface for all country-specific address types. */\nexport interface ICountryAddress {\n  readonly country: Country;\n  readonly street: AddressStreet;\n  readonly countryZipCode: ICountryAddressZipCode;\n  readonly city: AddressCity;\n  readonly address: Address;\n  readonly careOf: string | null;\n  readonly postBox: string | null;\n  readonly isPostBox: boolean;\n  readonly value: string;\n  readonly formatted: string;\n  toNormalizedString(): string;\n  toMultilineString(): string;\n  toString(): string;\n}\n\n/** Abstract base class for country-specific zip code types. */\nexport abstract class CountryAddressZipCodeBase implements ICountryAddressZipCode {\n  readonly value: string;\n  readonly formatted: string;\n  readonly zipCode: AddressZipCode;\n\n  abstract get country(): Country;\n\n  protected constructor(value: string, formatted: string, zipCode: AddressZipCode) {\n    this.value = value;\n    this.formatted = formatted;\n    this.zipCode = zipCode;\n  }\n\n  toNormalizedString(): string {\n    return this.value;\n  }\n  toString(): string {\n    return this.formatted;\n  }\n}\n\n/** Abstract base class for country-specific address types. */\nexport abstract class CountryAddressBase implements ICountryAddress {\n  readonly street: AddressStreet;\n  readonly city: AddressCity;\n  readonly address: Address;\n\n  abstract get countryZipCode(): ICountryAddressZipCode;\n\n  get country(): Country {\n    return this.address.country!;\n  }\n  get careOf(): string | null {\n    return this.street.careOf;\n  }\n  get postBox(): string | null {\n    return this.street.postBox;\n  }\n  get isPostBox(): boolean {\n    return this.street.isPostBox;\n  }\n  get value(): string {\n    return this.toNormalizedString();\n  }\n  get formatted(): string {\n    return this.toString();\n  }\n\n  protected constructor(street: AddressStreet, city: AddressCity, address: Address) {\n    this.street = street;\n    this.city = city;\n    this.address = address;\n  }\n\n  toNormalizedString(): string {\n    return this.address.toNormalizedString();\n  }\n\n  toString(): string {\n    const parts: string[] = [];\n    if (this.careOf) parts.push(`c/o ${this.careOf}`);\n    parts.push(this.street.street);\n    parts.push(`${this.countryZipCode.formatted} ${this.city.value}`);\n    return parts.join(\", \");\n  }\n\n  toMultilineString(): string {\n    const lines: string[] = [];\n    if (this.careOf) lines.push(`c/o ${this.careOf}`);\n    lines.push(this.street.street);\n    lines.push(`${this.countryZipCode.formatted} ${this.city.value}`);\n    return lines.join(\"\\n\");\n  }\n}\n\n/**\n * Validates and unwraps a generic {@link Address} for a specific country, then constructs\n * a typed country-specific address. Used by every `XxxAddress.tryParse` implementation.\n */\nexport function tryWrapCountryAddress<TZip, TAddr>(\n  address: Address,\n  alpha2: string,\n  defaultCountry: Country,\n  tryParseZip: (value: string) => TZip | null,\n  factory: (street: AddressStreet, zip: TZip, city: AddressCity, address: Address) => TAddr,\n): TAddr | null {\n  if (address.country && address.country.alpha2Code.toUpperCase() !== alpha2.toUpperCase()) {\n    return null;\n  }\n  if (address.zipCode === null || address.city === null) return null;\n  const zip = tryParseZip(address.zipCode.value);\n  if (zip === null) return null;\n  const withCountry =\n    address.country !== null\n      ? address\n      : new Address(address.street, address.zipCode, address.city, defaultCountry);\n  return factory(address.street, zip, address.city, withCountry);\n}\n"],
+  "mappings": "AACA,SAAS,eAAe;AAiCjB,MAAe,0BAA4D;AAAA,EACvE;AAAA,EACA;AAAA,EACA;AAAA,EAIC,YAAY,OAAe,WAAmB,SAAyB;AAC/E,SAAK,QAAQ;AACb,SAAK,YAAY;AACjB,SAAK,UAAU;AAAA,EACjB;AAAA,EAEA,qBAA6B;AAC3B,WAAO,KAAK;AAAA,EACd;AAAA,EACA,WAAmB;AACjB,WAAO,KAAK;AAAA,EACd;AACF;AAGO,MAAe,mBAA8C;AAAA,EACzD;AAAA,EACA;AAAA,EACA;AAAA,EAIT,IAAI,UAAmB;AACrB,WAAO,KAAK,QAAQ;AAAA,EACtB;AAAA,EACA,IAAI,SAAwB;AAC1B,WAAO,KAAK,OAAO;AAAA,EACrB;AAAA,EACA,IAAI,UAAyB;AAC3B,WAAO,KAAK,OAAO;AAAA,EACrB;AAAA,EACA,IAAI,YAAqB;AACvB,WAAO,KAAK,OAAO;AAAA,EACrB;AAAA,EACA,IAAI,QAAgB;AAClB,WAAO,KAAK,mBAAmB;AAAA,EACjC;AAAA,EACA,IAAI,YAAoB;AACtB,WAAO,KAAK,SAAS;AAAA,EACvB;AAAA,EAEU,YAAY,QAAuB,MAAmB,SAAkB;AAChF,SAAK,SAAS;AACd,SAAK,OAAO;AACZ,SAAK,UAAU;AAAA,EACjB;AAAA,EAEA,qBAA6B;AAC3B,WAAO,KAAK,QAAQ,mBAAmB;AAAA,EACzC;AAAA,EAEA,WAAmB;AACjB,UAAM,QAAkB,CAAC;AACzB,QAAI,KAAK,OAAQ,OAAM,KAAK,OAAO,KAAK,MAAM,EAAE;AAChD,UAAM,KAAK,KAAK,OAAO,MAAM;AAC7B,UAAM,KAAK,GAAG,KAAK,eAAe,SAAS,IAAI,KAAK,KAAK,KAAK,EAAE;AAChE,WAAO,MAAM,KAAK,IAAI;AAAA,EACxB;AAAA,EAEA,oBAA4B;AAC1B,UAAM,QAAkB,CAAC;AACzB,QAAI,KAAK,OAAQ,OAAM,KAAK,OAAO,KAAK,MAAM,EAAE;AAChD,UAAM,KAAK,KAAK,OAAO,MAAM;AAC7B,UAAM,KAAK,GAAG,KAAK,eAAe,SAAS,IAAI,KAAK,KAAK,KAAK,EAAE;AAChE,WAAO,MAAM,KAAK,IAAI;AAAA,EACxB;AACF;AAMO,SAAS,sBACd,SACA,QACA,gBACA,aACA,SACc;AACd,MAAI,QAAQ,WAAW,QAAQ,QAAQ,WAAW,YAAY,MAAM,OAAO,YAAY,GAAG;AACxF,WAAO;AAAA,EACT;AACA,MAAI,QAAQ,YAAY,QAAQ,QAAQ,SAAS,KAAM,QAAO;AAC9D,QAAM,MAAM,YAAY,QAAQ,QAAQ,KAAK;AAC7C,MAAI,QAAQ,KAAM,QAAO;AACzB,QAAM,cACJ,QAAQ,YAAY,OAChB,UACA,IAAI,QAAQ,QAAQ,QAAQ,QAAQ,SAAS,QAAQ,MAAM,cAAc;AAC/E,SAAO,QAAQ,QAAQ,QAAQ,KAAK,QAAQ,MAAM,WAAW;AAC/D;",
+  "names": []
+}