@aidc-toolkit/gs1 1.0.39-beta → 1.0.41-beta

package/README.md

@@ -20,20 +20,20 @@ The GS1 system supports four character sets:
   - Digits '0' to '9'.
   - Required by most GS1 identifiers.
   - Required by many GS1 Application Identifiers.
-  - [Validator](https://aidc-toolkit.com/api/Utility/variables/NUMERIC_VALIDATOR.html) and [creator](https://aidc-toolkit.com/api/Utility/variables/NUMERIC_CREATOR.html) defined in the Utility package.
+  - [Validator](https://aidc-toolkit.com/v1.0/api/Utility/variables/NUMERIC_VALIDATOR.html) and [creator](https://aidc-toolkit.com/v1.0/api/Utility/variables/NUMERIC_CREATOR.html) defined in the Utility package.
 - GS1 AI encodable character set 82
   - Equivalent to ISO/IEC 646 Table 1 - Unique graphic character allocations.
   - Required by all non-numeric GS1 identifiers except CPID.
   - Required by many GS1 Application Identifiers.
-  - [Validator](https://aidc-toolkit.com/api/GS1/variables/AI82_VALIDATOR.html) and [creator](https://aidc-toolkit.com/api/GS1/variables/AI82_CREATOR.html) defined in this package.
+  - [Validator](https://aidc-toolkit.com/v1.0/api/GS1/variables/AI82_VALIDATOR.html) and [creator](https://aidc-toolkit.com/v1.0/api/GS1/variables/AI82_CREATOR.html) defined in this package.
 - GS1 AI encodable character set 39
   - Digits '0' to '9', uppercase letters 'A' to 'Z', and the characters '#', '-', and '/'.
   - Required by the CPID GS1 identifier.
-  - [Validator](https://aidc-toolkit.com/api/GS1/variables/AI39_VALIDATOR.html) and [creator](https://aidc-toolkit.com/api/GS1/variables/AI39_CREATOR.html) defined in this package.
+  - [Validator](https://aidc-toolkit.com/v1.0/api/GS1/variables/AI39_VALIDATOR.html) and [creator](https://aidc-toolkit.com/v1.0/api/GS1/variables/AI39_CREATOR.html) defined in this package.
 - GS1 AI encodable character set 64
   - Characters that result from base 64 encoding [as described in RFC 4648](https://www.rfc-editor.org/rfc/rfc4648.html#section-4).
   - Required by GS1 Application Identifier 8030 Digital Signature.
-  - [Validator](https://aidc-toolkit.com/api/GS1/variables/AI64_VALIDATOR.html) defined in this package.
+  - [Validator](https://aidc-toolkit.com/v1.0/api/GS1/variables/AI64_VALIDATOR.html) defined in this package.
     - No creator is defined as creation is the base 64 process.
 
 ## Check Calculation and Validation Functions
@@ -42,23 +42,23 @@ The check calculation and validation functions are separate from the string vali
 
 ### Check Digit - GS1 Identifier
 
-The [`checkDigit()`](https://aidc-toolkit.com/api/GS1/functions/checkDigit.html) function calculates the check digit for a numeric GS1 identifier.
+The [`checkDigit()`](https://aidc-toolkit.com/v1.0/api/GS1/functions/checkDigit.html) function calculates the check digit for a numeric GS1 identifier.
 
-The [`hasValidCheckDigit()`](https://aidc-toolkit.com/api/GS1/functions/hasValidCheckDigit.html) function validates the check digit for a numeric GS1 identifier.
+The [`hasValidCheckDigit()`](https://aidc-toolkit.com/v1.0/api/GS1/functions/hasValidCheckDigit.html) function validates the check digit for a numeric GS1 identifier.
 
 ### Check Digit - Price or Weight Encoding
 
-The [`priceOrWeightCheckDigit()`](https://aidc-toolkit.com/api/GS1/functions/priceOrWeightCheckDigit.html) function calculates the check digit for a price or weight.
+The [`priceOrWeightCheckDigit()`](https://aidc-toolkit.com/v1.0/api/GS1/functions/priceOrWeightCheckDigit.html) function calculates the check digit for a price or weight.
 
-The [`isValidPriceOrWeightCheckDigit()`](https://aidc-toolkit.com/api/GS1/functions/isValidPriceOrWeightCheckDigit.html) function validates the check digit for a price or weight.
+The [`isValidPriceOrWeightCheckDigit()`](https://aidc-toolkit.com/v1.0/api/GS1/functions/isValidPriceOrWeightCheckDigit.html) function validates the check digit for a price or weight.
 
 These functions are seldom used directly, as there are no use cases for prices or weights on their own. They are used by the variable measure RCN functions if the RCN format requires a price or weight check digit.
 
 ### Check Character Pair - GS1 Identifier
 
-The [`checkCharacterPair()`](https://aidc-toolkit.com/api/GS1/functions/checkCharacterPair.html) function calculates the check character pair for a non-numeric GS1 identifier, if supported.
+The [`checkCharacterPair()`](https://aidc-toolkit.com/v1.0/api/GS1/functions/checkCharacterPair.html) function calculates the check character pair for a non-numeric GS1 identifier, if supported.
 
-The [`hasValidCheckCharacterPair()`](https://aidc-toolkit.com/api/GS1/functions/hasValidCheckCharacterPair.html) function validates the check character pair for a non-numeric GS1 identifier, if supported.
+The [`hasValidCheckCharacterPair()`](https://aidc-toolkit.com/v1.0/api/GS1/functions/hasValidCheckCharacterPair.html) function validates the check character pair for a non-numeric GS1 identifier, if supported.
 
 ## GS1 Identifiers
 
@@ -68,15 +68,15 @@ At the core of the AIDC Toolkit `gs1` package is GS1 identifier validation and c
 
 Before going into the identifiers themselves, it's necessary to understand the prefix types supported by the GS1 system.
 
-- [GS1 Company Prefix](https://aidc-toolkit.com/api/GS1/variables/PrefixTypes.html#gs1companyprefix)
+- [GS1 Company Prefix](https://aidc-toolkit.com/v1.0/api/GS1/variables/PrefixTypes.html#gs1companyprefix)
   - This is the core prefix type and the one to which all others can be converted. Every GS1 identifier contains a GS1 Company Prefix.
     - For example, using GS1 Company Prefix 9521234 and item reference 99999, you can create the 13-digit GTIN 9521234999997. Similarly, using GS1 Company Prefix 9521234 and model reference ABCDEF, you can create the GMN 9521234ABCDEFK2. 
-- [U.P.C. Company Prefix](https://aidc-toolkit.com/api/GS1/variables/PrefixTypes.html#upccompanyprefix)
+- [U.P.C. Company Prefix](https://aidc-toolkit.com/v1.0/api/GS1/variables/PrefixTypes.html#upccompanyprefix)
   - This is a special version of the GS1 Company Prefix used **only** to create 12-digit GTINs. All U.P.C. Company Prefixes are issued directly or indirectly by GS1 US to support the requirement for 12-digit GTINs in the North American marketplace.
     - For example, using U.P.C. Company Prefix 614141 and item reference 99999, you can create the 12-digit GTIN 614141999996.
   - A U.P.C. Company Prefix may be used to create other GS1 identifiers, but it must first be converted to a GS1 Company Prefix by prepending a zero.
     - For example, using U.P.C. Company Prefix 614141 and model reference ABCDEF, you can convert the prefix to GS1 Company Prefix 0614141 and create the GMN 0614141ABCDEF8P.
-- [GS1-8 Prefix](https://aidc-toolkit.com/api/GS1/variables/PrefixTypes.html#gs18prefix)
+- [GS1-8 Prefix](https://aidc-toolkit.com/v1.0/api/GS1/variables/PrefixTypes.html#gs18prefix)
   - This is a special version of the GS1 Company Prefix used **only** to create 8-digit GTINs for special purpose applications where a trade item isn't large enough to support a 13-digit GTIN. GS1-8 Prefixes are managed by individual GS1 Member Organizations and, while they are supported within this library, they are not available to users directly.
   - A GS1-8 Prefix may **not** be used to create other GS1 identifiers.
 
@@ -92,111 +92,111 @@ If you're unsure, contact your local [GS1 Member Organization](https://www.gs1.o
 
 ### Identifier Types and Descriptors
 
-All identifier types are supported. Constants are defined in [`IdentifierTypes`](https://aidc-toolkit.com/api/GS1/variables/IdentifierTypes.html), which is used to define the type alias [`IdentifierType`](https://aidc-toolkit.com/api/GS1/type-aliases/IdentifierType.html).
+All identifier types are supported. Constants are defined in [`IdentifierTypes`](https://aidc-toolkit.com/v1.0/api/GS1/variables/IdentifierTypes.html), which is used to define the type alias [`IdentifierType`](https://aidc-toolkit.com/v1.0/api/GS1/type-aliases/IdentifierType.html).
 
 Internally, identifier types are broken down into categories. Each category builds on the one above by adding new properties, defined in a descriptor type:
 
-- [Base identifier descriptor](https://aidc-toolkit.com/api/GS1/interfaces/IdentifierDescriptor.html)
-  - [Numeric identifier descriptor](https://aidc-toolkit.com/api/GS1/interfaces/NumericIdentifierDescriptor.html)
-    - [GTIN descriptor](https://aidc-toolkit.com/api/GS1/interfaces/GTINDescriptor.html) - Global Trade Item Number
+- [Base identifier descriptor](https://aidc-toolkit.com/v1.0/api/GS1/interfaces/IdentifierDescriptor.html)
+  - [Numeric identifier descriptor](https://aidc-toolkit.com/v1.0/api/GS1/interfaces/NumericIdentifierDescriptor.html)
+    - [GTIN descriptor](https://aidc-toolkit.com/v1.0/api/GS1/interfaces/GTINDescriptor.html) - Global Trade Item Number
       - *GTIN-13*
       - *GTIN-12*
       - *GTIN-8*
-    - [Non-GTIN numeric identifier descriptor](https://aidc-toolkit.com/api/GS1/interfaces/NonGTINNumericIdentifierDescriptor.html)
-      - [Non-serializable numeric identifier descriptor](https://aidc-toolkit.com/api/GS1/interfaces/NonSerializableNumericIdentifierDescriptor.html)
+    - [Non-GTIN numeric identifier descriptor](https://aidc-toolkit.com/v1.0/api/GS1/interfaces/NonGTINNumericIdentifierDescriptor.html)
+      - [Non-serializable numeric identifier descriptor](https://aidc-toolkit.com/v1.0/api/GS1/interfaces/NonSerializableNumericIdentifierDescriptor.html)
         - *GLN* - Global Location Number
         - *SSCC* - Serial Shipping Container Code
         - *GSRN* - Global Service Relation Number
         - *GSIN* - Global Shipment Identification Number
-      - [Serializable numeric identifier descriptor](https://aidc-toolkit.com/api/GS1/interfaces/SerializableNumericIdentifierDescriptor.html)
+      - [Serializable numeric identifier descriptor](https://aidc-toolkit.com/v1.0/api/GS1/interfaces/SerializableNumericIdentifierDescriptor.html)
         - *GRAI* - Global Returnable Asset Identifier
         - *GDTI* - Global Document Type Identifier
         - *GCN* - Global Coupon Number
-  - [Non-numeric identifier descriptor](https://aidc-toolkit.com/api/GS1/interfaces/NonNumericIdentifierDescriptor.html)
+  - [Non-numeric identifier descriptor](https://aidc-toolkit.com/v1.0/api/GS1/interfaces/NonNumericIdentifierDescriptor.html)
     - *GIAI* - Global Individual Asset Identifier
     - *GINC* - Global Identification Number for Consignment
     - *CPID* - Component/Part Identifier
     - *GMN* - Global Model Number
 
-The identifier descriptors are stored in a [record object](https://aidc-toolkit.com/api/GS1/variables/IdentifierDescriptors.html), keyed on identifier type. The GTIN entry is an array (GTIN-13, GTIN-12, and GTIN-8); all others are singletons. To deal with an unknown identifier descriptor, there are typeguards available, aligned with the categories above:
+The identifier descriptors are stored in a [record object](https://aidc-toolkit.com/v1.0/api/GS1/variables/IdentifierDescriptors.html), keyed on identifier type. The GTIN entry is an array (GTIN-13, GTIN-12, and GTIN-8); all others are singletons. To deal with an unknown identifier descriptor, there are typeguards available, aligned with the categories above:
 
-- [`isGTINDescriptors()`](https://aidc-toolkit.com/api/GS1/functions/isGTINDescriptors.html)
+- [`isGTINDescriptors()`](https://aidc-toolkit.com/v1.0/api/GS1/functions/isGTINDescriptors.html)
   - Special case to identify the GTIN descriptors array entry. 
-- [`isNumericIdentifierDescriptor()`](https://aidc-toolkit.com/api/GS1/functions/isNumericIdentifierDescriptor.html)
-  - [`isGTINDescriptor()`](https://aidc-toolkit.com/api/GS1/functions/isGTINDescriptor.html)
-  - [`isNonGTINNumericIdentifierDescriptor()`](https://aidc-toolkit.com/api/GS1/functions/isNonGTINNumericIdentifierDescriptor.html)
-    - [`isNonSerializableNumericIdentifierDescriptor()`](https://aidc-toolkit.com/api/GS1/functions/isNonSerializableNumericIdentifierDescriptor.html)
-    - [`isSerializableNumericIdentifierDescriptor()`](https://aidc-toolkit.com/api/GS1/functions/isSerializableNumericIdentifierDescriptor.html)
-- [`isNonNumericIdentifierDescriptor()`](https://aidc-toolkit.com/api/GS1/functions/isNonNumericIdentifierDescriptor.html)
+- [`isNumericIdentifierDescriptor()`](https://aidc-toolkit.com/v1.0/api/GS1/functions/isNumericIdentifierDescriptor.html)
+  - [`isGTINDescriptor()`](https://aidc-toolkit.com/v1.0/api/GS1/functions/isGTINDescriptor.html)
+  - [`isNonGTINNumericIdentifierDescriptor()`](https://aidc-toolkit.com/v1.0/api/GS1/functions/isNonGTINNumericIdentifierDescriptor.html)
+    - [`isNonSerializableNumericIdentifierDescriptor()`](https://aidc-toolkit.com/v1.0/api/GS1/functions/isNonSerializableNumericIdentifierDescriptor.html)
+    - [`isSerializableNumericIdentifierDescriptor()`](https://aidc-toolkit.com/v1.0/api/GS1/functions/isSerializableNumericIdentifierDescriptor.html)
+- [`isNonNumericIdentifierDescriptor()`](https://aidc-toolkit.com/v1.0/api/GS1/functions/isNonNumericIdentifierDescriptor.html)
 
 ### Identifier Validation
 
-Every identifier descriptor interface has a corresponding identifier validator class, which implements the interface and adds validation logic. The core method is [`validate()`](https://aidc-toolkit.com/api/GS1/classes/IdentifierValidator.html#validate), which takes an identifier string and either returns if valid or throws a [`RangeError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RangeError) if not.
+Every identifier descriptor interface has a corresponding identifier validator class, which implements the interface and adds validation logic. The core method is [`validate()`](https://aidc-toolkit.com/v1.0/api/GS1/classes/IdentifierValidator.html#validate), which takes an identifier string and either returns if valid or throws a [`RangeError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RangeError) if not.
 
 Validation is based on the string validation functions defined in the Utility package. As such, the `validate()` method can take additional validation parameters, depending on the identifier type.
 
-- [Base identifier validator](https://aidc-toolkit.com/api/GS1/classes/IdentifierValidator.html)
-  - [Numeric identifier validator](https://aidc-toolkit.com/api/GS1/classes/NumericIdentifierValidator.html)
+- [Base identifier validator](https://aidc-toolkit.com/v1.0/api/GS1/classes/IdentifierValidator.html)
+  - [Numeric identifier validator](https://aidc-toolkit.com/v1.0/api/GS1/classes/NumericIdentifierValidator.html)
     - Validation can include a position offset, but this is managed internally by derived classes.
-    - [GTIN validator](https://aidc-toolkit.com/api/GS1/classes/GTINValidator.html)
-    - [Non-GTIN numeric identifier validator](https://aidc-toolkit.com/api/GS1/classes/NonGTINNumericIdentifierValidator.html)
-      - [Non-serializable numeric identifier validator](https://aidc-toolkit.com/api/GS1/classes/NonSerializableNumericIdentifierValidator.html)
-      - [Serializable numeric identifier validator](https://aidc-toolkit.com/api/GS1/classes/SerializableNumericIdentifierValidator.html)
-  - [Non-numeric identifier validator](https://aidc-toolkit.com/api/GS1/classes/NonNumericIdentifierValidator.html)
+    - [GTIN validator](https://aidc-toolkit.com/v1.0/api/GS1/classes/GTINValidator.html)
+    - [Non-GTIN numeric identifier validator](https://aidc-toolkit.com/v1.0/api/GS1/classes/NonGTINNumericIdentifierValidator.html)
+      - [Non-serializable numeric identifier validator](https://aidc-toolkit.com/v1.0/api/GS1/classes/NonSerializableNumericIdentifierValidator.html)
+      - [Serializable numeric identifier validator](https://aidc-toolkit.com/v1.0/api/GS1/classes/SerializableNumericIdentifierValidator.html)
+  - [Non-numeric identifier validator](https://aidc-toolkit.com/v1.0/api/GS1/classes/NonNumericIdentifierValidator.html)
     - Validation can include exclusion of all-numeric references. The check character pair, if applicable, is not included in the all-numeric check (e.g., GMNs `9528888123423` and `952999912343X` both fail exclude all-numeric validation even though the latter has a non-numeric check character pair).
 
-The identifier validators are stored in a [record object](https://aidc-toolkit.com/api/GS1/variables/IdentifierValidators.html), keyed on identifier type. The GTIN entry is an array (GTIN-13, GTIN-12, and GTIN-8); all others are singletons. To deal with an unknown identifier validator, there are typeguards available, aligned with the categories above:
+The identifier validators are stored in a [record object](https://aidc-toolkit.com/v1.0/api/GS1/variables/IdentifierValidators.html), keyed on identifier type. The GTIN entry is an array (GTIN-13, GTIN-12, and GTIN-8); all others are singletons. To deal with an unknown identifier validator, there are typeguards available, aligned with the categories above:
 
-- [`isGTINValidators()`](https://aidc-toolkit.com/api/GS1/functions/isGTINValidators.html)
+- [`isGTINValidators()`](https://aidc-toolkit.com/v1.0/api/GS1/functions/isGTINValidators.html)
   - Special case to identify the GTIN validators array entry.
-- [`isNumericIdentifierValidator()`](https://aidc-toolkit.com/api/GS1/functions/isNumericIdentifierValidator.html)
-  - [`isGTINValidator()`](https://aidc-toolkit.com/api/GS1/functions/isGTINValidator.html)
-  - [`isNonGTINNumericIdentifierValidator()`](https://aidc-toolkit.com/api/GS1/functions/isNonGTINNumericIdentifierValidator.html)
-    - [`isNonSerializableNumericIdentifierValidator()`](https://aidc-toolkit.com/api/GS1/functions/isNonSerializableNumericIdentifierValidator.html)
-    - [`isSerializableNumericIdentifierValidator()`](https://aidc-toolkit.com/api/GS1/functions/isSerializableNumericIdentifierValidator.html)
-- [`isNonNumericIdentifierValidator()`](https://aidc-toolkit.com/api/GS1/functions/isNonNumericIdentifierValidator.html)
+- [`isNumericIdentifierValidator()`](https://aidc-toolkit.com/v1.0/api/GS1/functions/isNumericIdentifierValidator.html)
+  - [`isGTINValidator()`](https://aidc-toolkit.com/v1.0/api/GS1/functions/isGTINValidator.html)
+  - [`isNonGTINNumericIdentifierValidator()`](https://aidc-toolkit.com/v1.0/api/GS1/functions/isNonGTINNumericIdentifierValidator.html)
+    - [`isNonSerializableNumericIdentifierValidator()`](https://aidc-toolkit.com/v1.0/api/GS1/functions/isNonSerializableNumericIdentifierValidator.html)
+    - [`isSerializableNumericIdentifierValidator()`](https://aidc-toolkit.com/v1.0/api/GS1/functions/isSerializableNumericIdentifierValidator.html)
+- [`isNonNumericIdentifierValidator()`](https://aidc-toolkit.com/v1.0/api/GS1/functions/isNonNumericIdentifierValidator.html)
 
 #### GTIN Validation
 
-GTIN validation is special in that there are multiple lengths of GTINs and variations in use cases that limit what GTINs may be used for what purpose. To support this, there are static functions defined in the [`GTINValidator`](https://aidc-toolkit.com/api/GS1/classes/GTINValidator.html) class:
+GTIN validation is special in that there are multiple lengths of GTINs and variations in use cases that limit what GTINs may be used for what purpose. To support this, there are static functions defined in the [`GTINValidator`](https://aidc-toolkit.com/v1.0/api/GS1/classes/GTINValidator.html) class:
 
-- [`zeroSuppress()`](https://aidc-toolkit.com/api/GS1/classes/GTINValidator.html#zerosuppress) - Applies a special compression algorithm to certain GTIN-12s to suppress zeros and reduce the length to 8 digits for encoding in a UPC-E barcode.
-- [`zeroExpand()`](https://aidc-toolkit.com/api/GS1/classes/GTINValidator.html#zeroexpand) - Expands a zero-suppressed GTIN-12 to its original form.
-- [`convertToGTIN14()`](https://aidc-toolkit.com/api/GS1/classes/GTINValidator.html#converttogtin14) - Converts any GTIN to GTIN-14 form with an indicator digit. If the indicator digit is not provided, the default is "0", unless the input is already a GTIN-14, in which case the indicator digit is preserved.
-- [`normalize()`](https://aidc-toolkit.com/api/GS1/classes/GTINValidator.html#normalize) - Normalizes a GTIN to the shortest form possible.
-- [`validateAny()`](https://aidc-toolkit.com/api/GS1/classes/GTINValidator.html#validateany) - Validates a GTIN of any length and optionally against the [level at which it is used](https://aidc-toolkit.com/api/GS1/variables/GTINLevels.html).
-- [`validateGTIN14()`](https://aidc-toolkit.com/api/GS1/classes/GTINValidator.html#validategtin14) - The GTIN-14 doesn't have its own instance of `GTINValidator` as it is subordinate to the other lengths, so this method specifically validates a GTIN-14.
+- [`zeroSuppress()`](https://aidc-toolkit.com/v1.0/api/GS1/classes/GTINValidator.html#zerosuppress) - Applies a special compression algorithm to certain GTIN-12s to suppress zeros and reduce the length to 8 digits for encoding in a UPC-E barcode.
+- [`zeroExpand()`](https://aidc-toolkit.com/v1.0/api/GS1/classes/GTINValidator.html#zeroexpand) - Expands a zero-suppressed GTIN-12 to its original form.
+- [`convertToGTIN14()`](https://aidc-toolkit.com/v1.0/api/GS1/classes/GTINValidator.html#converttogtin14) - Converts any GTIN to GTIN-14 form with an indicator digit. If the indicator digit is not provided, the default is "0", unless the input is already a GTIN-14, in which case the indicator digit is preserved.
+- [`normalize()`](https://aidc-toolkit.com/v1.0/api/GS1/classes/GTINValidator.html#normalize) - Normalizes a GTIN to the shortest form possible.
+- [`validateAny()`](https://aidc-toolkit.com/v1.0/api/GS1/classes/GTINValidator.html#validateany) - Validates a GTIN of any length and optionally against the [level at which it is used](https://aidc-toolkit.com/v1.0/api/GS1/variables/GTINLevels.html).
+- [`validateGTIN14()`](https://aidc-toolkit.com/v1.0/api/GS1/classes/GTINValidator.html#validategtin14) - The GTIN-14 doesn't have its own instance of `GTINValidator` as it is subordinate to the other lengths, so this method specifically validates a GTIN-14.
 
 ### Identifier Creation
 
 Every identifier validator class has an extending identifier creator class which adds creation logic. To create an identifier, **you must have a properly licensed GS1 Company Prefix or U.P.C. Company Prefix**. To acquire a licence, contact your local [GS1 Member Organization](https://www.gs1.org/contact/overview).
 
-Creation is based on the string creation functions defined in the Utility package, with additional rules for prefixes and check digits and check character pairs. The constructor for every class takes a [`PrefixProvider`](https://aidc-toolkit.com/api/GS1/interfaces/PrefixProvider.html) object, which defines the prefix type and the prefix itself. Every class has one or more `create*()` methods whose parameters depend on the identifier type.
+Creation is based on the string creation functions defined in the Utility package, with additional rules for prefixes and check digits and check character pairs. The constructor for every class takes a [`PrefixProvider`](https://aidc-toolkit.com/v1.0/api/GS1/interfaces/PrefixProvider.html) object, which defines the prefix type and the prefix itself. Every class has one or more `create*()` methods whose parameters depend on the identifier type.
 
 Architecturally, base functionality is defined via interfaces, with only concrete classes exposed.
 
-- [Base identifier creator](https://aidc-toolkit.com/api/GS1/interfaces/IdentifierCreator.html)
-  - [Numeric identifier creator](https://aidc-toolkit.com/api/GS1/interfaces/NumericIdentifierCreator.html)
-    - [`create()`](https://aidc-toolkit.com/api/GS1/interfaces/NumericIdentifierCreator.html#create) - Create a single numeric identifier or a sequence of numeric identifiers.
-    - [`createAll()`](https://aidc-toolkit.com/api/GS1/interfaces/NumericIdentifierCreator.html#createall) - Create all numeric identifiers for a prefix.
-    - [GTIN creator](https://aidc-toolkit.com/api/GS1/classes/GTINCreator.html)
-      - [`createGTIN14()`](https://aidc-toolkit.com/api/GS1/classes/GTINCreator.html#creategtin14) - Create a single GTIN-14 or a sequence of GTIN-14s.
-    - [Non-GTIN numeric identifier creator](https://aidc-toolkit.com/api/GS1/interfaces/NonGTINNumericIdentifierCreator.html)
-      - [Non-serializable numeric identifier creator](https://aidc-toolkit.com/api/GS1/classes/NonSerializableNumericIdentifierCreator.html)
-      - [Serializable numeric identifier creator](https://aidc-toolkit.com/api/GS1/classes/SerializableNumericIdentifierCreator.html)
-        - [`createSerialized()`](https://aidc-toolkit.com/api/GS1/classes/SerializableNumericIdentifierCreator.html#createserialized) - Create a single serialized numeric identifier or a sequence of serialized numeric identifiers.
-        - [`concatenate()`](https://aidc-toolkit.com/api/GS1/classes/SerializableNumericIdentifierCreator.html#concatenate) - Concatenate a base (non-serialized) with a single serialized component or a sequence of serialized components.
-  - [Non-numeric identifier creator](https://aidc-toolkit.com/api/GS1/classes/NonNumericIdentifierCreator.html)
-    - [`create()`](https://aidc-toolkit.com/api/GS1/classes/NonNumericIdentifierCreator.html#create) - Create a single non-numeric identifier or a sequence of non-numeric i[numeric-identifier-creator.ts](src/numeric-identifier-creator.ts)dentifiers.
+- [Base identifier creator](https://aidc-toolkit.com/v1.0/api/GS1/interfaces/IdentifierCreator.html)
+  - [Numeric identifier creator](https://aidc-toolkit.com/v1.0/api/GS1/interfaces/NumericIdentifierCreator.html)
+    - [`create()`](https://aidc-toolkit.com/v1.0/api/GS1/interfaces/NumericIdentifierCreator.html#create) - Create a single numeric identifier or a sequence of numeric identifiers.
+    - [`createAll()`](https://aidc-toolkit.com/v1.0/api/GS1/interfaces/NumericIdentifierCreator.html#createall) - Create all numeric identifiers for a prefix.
+    - [GTIN creator](https://aidc-toolkit.com/v1.0/api/GS1/classes/GTINCreator.html)
+      - [`createGTIN14()`](https://aidc-toolkit.com/v1.0/api/GS1/classes/GTINCreator.html#creategtin14) - Create a single GTIN-14 or a sequence of GTIN-14s.
+    - [Non-GTIN numeric identifier creator](https://aidc-toolkit.com/v1.0/api/GS1/interfaces/NonGTINNumericIdentifierCreator.html)
+      - [Non-serializable numeric identifier creator](https://aidc-toolkit.com/v1.0/api/GS1/classes/NonSerializableNumericIdentifierCreator.html)
+      - [Serializable numeric identifier creator](https://aidc-toolkit.com/v1.0/api/GS1/classes/SerializableNumericIdentifierCreator.html)
+        - [`createSerialized()`](https://aidc-toolkit.com/v1.0/api/GS1/classes/SerializableNumericIdentifierCreator.html#createserialized) - Create a single serialized numeric identifier or a sequence of serialized numeric identifiers.
+        - [`concatenate()`](https://aidc-toolkit.com/v1.0/api/GS1/classes/SerializableNumericIdentifierCreator.html#concatenate) - Concatenate a base (non-serialized) with a single serialized component or a sequence of serialized components.
+  - [Non-numeric identifier creator](https://aidc-toolkit.com/v1.0/api/GS1/classes/NonNumericIdentifierCreator.html)
+    - [`create()`](https://aidc-toolkit.com/v1.0/api/GS1/classes/NonNumericIdentifierCreator.html#create) - Create a single non-numeric identifier or a sequence of non-numeric i[numeric-identifier-creator.ts](src/numeric-identifier-creator.ts)dentifiers.
 
 Because identifier creators depend on a prefix, there are no instantiations of them. To deal with an unknown identifier creator, there are typeguards available, aligned with the categories above:
 
-- [`isNumericIdentifierCreator()`](https://aidc-toolkit.com/api/GS1/functions/isNumericIdentifierCreator.html)
-  - [`isGTINCreator()`](https://aidc-toolkit.com/api/GS1/functions/isGTINCreator.html)
-  - [`isNonGTINNumericIdentifierCreator()`](https://aidc-toolkit.com/api/GS1/functions/isNonGTINNumericIdentifierCreator.html)
-    - [`isNonSerializableNumericIdentifierCreator()`](https://aidc-toolkit.com/api/GS1/functions/isNonSerializableNumericIdentifierCreator.html)
-    - [`isSerializableNumericIdentifierCreator()`](https://aidc-toolkit.com/api/GS1/functions/isSerializableNumericIdentifierCreator.html)
-- [`isNonNumericIdentifierCreator()`](https://aidc-toolkit.com/api/GS1/functions/isNonNumericIdentifierCreator.html)
+- [`isNumericIdentifierCreator()`](https://aidc-toolkit.com/v1.0/api/GS1/functions/isNumericIdentifierCreator.html)
+  - [`isGTINCreator()`](https://aidc-toolkit.com/v1.0/api/GS1/functions/isGTINCreator.html)
+  - [`isNonGTINNumericIdentifierCreator()`](https://aidc-toolkit.com/v1.0/api/GS1/functions/isNonGTINNumericIdentifierCreator.html)
+    - [`isNonSerializableNumericIdentifierCreator()`](https://aidc-toolkit.com/v1.0/api/GS1/functions/isNonSerializableNumericIdentifierCreator.html)
+    - [`isSerializableNumericIdentifierCreator()`](https://aidc-toolkit.com/v1.0/api/GS1/functions/isSerializableNumericIdentifierCreator.html)
+- [`isNonNumericIdentifierCreator()`](https://aidc-toolkit.com/v1.0/api/GS1/functions/isNonNumericIdentifierCreator.html)
 
 #### Sparse Creation
 
@@ -231,7 +231,7 @@ console.log(Array.from(ssccCreator.create(new Sequence(0, 4))));
 console.log(Array.from(ssccCreator.create(new Sequence(0, 4), true)));
 ```
 
-Each call to `create()` returns the first four SSCCs in sequence, but the second call uses the [`EncryptionTransformer`](https://aidc-toolkit.com/api/Utility/classes/EncryptionTransformer.html) to obfuscate the sequence.
+Each call to `create()` returns the first four SSCCs in sequence, but the second call uses the [`EncryptionTransformer`](https://aidc-toolkit.com/v1.0/api/Utility/classes/EncryptionTransformer.html) to obfuscate the sequence.
 
 The `create()` method for non-numeric identifiers works on a string or sequence of strings, so it doesn't support the `sparse` parameter. The obfuscation must applied to the strings before they are passed to the creator:
 
@@ -264,31 +264,31 @@ console.log(Array.from(gmnCreator.create(
 )));
 ```
 
-Again, each call to `create()` returns the first four GMNs in sequence (indirectly via the alphanumeric string creator), but the second call uses the [`EncryptionTransformer`](https://aidc-toolkit.com/api/Utility/classes/EncryptionTransformer.html) to obfuscate the sequence.
+Again, each call to `create()` returns the first four GMNs in sequence (indirectly via the alphanumeric string creator), but the second call uses the [`EncryptionTransformer`](https://aidc-toolkit.com/v1.0/api/Utility/classes/EncryptionTransformer.html) to obfuscate the sequence.
 
 ### Prefix Manager
 
-The [`PrefixProvider`](https://aidc-toolkit.com/api/GS1/interfaces/PrefixProvider.html) required by every identifier creator is just an object. It has no validation logic, and the creator classes assume that its contents are correct. The  [`PrefixManager`](https://aidc-toolkit.com/api/GS1/classes/PrefixManager.html) class implements the `PrefixProvider` interface and provides a convenient way to access the various identifier creators. It also manages the tweak values for sparse numeric identifier creation.
+The [`PrefixProvider`](https://aidc-toolkit.com/v1.0/api/GS1/interfaces/PrefixProvider.html) required by every identifier creator is just an object. It has no validation logic, and the creator classes assume that its contents are correct. The  [`PrefixManager`](https://aidc-toolkit.com/v1.0/api/GS1/classes/PrefixManager.html) class implements the `PrefixProvider` interface and provides a convenient way to access the various identifier creators. It also manages the tweak values for sparse numeric identifier creation.
 
-There are two ways to create a `PrefixManager`, both of which take a [prefix type](https://aidc-toolkit.com/api/GS1/type-aliases/PrefixType.html) and a prefix:
+There are two ways to create a `PrefixManager`, both of which take a [prefix type](https://aidc-toolkit.com/v1.0/api/GS1/type-aliases/PrefixType.html) and a prefix:
 
 - Directly via the constructor.
-- Indirectly via the [`PrefixManager.get()`](https://aidc-toolkit.com/api/GS1/classes/PrefixManager.html#get) static method.
+- Indirectly via the [`PrefixManager.get()`](https://aidc-toolkit.com/v1.0/api/GS1/classes/PrefixManager.html#get) static method.
 
 Using the static method is preferred because guarantees that only one instance of the prefix manager is maintained for each prefix and it preserves changes to the prefix manager, such as setting the tweak factor for sparse numeric identifier creation.
 
 The default tweak factor for sparse numeric identifier creation is the numeric value of "1" plus the GS1 Company Prefix (e.g., 19521234 for GS1 Company Prefix 9521234, 10614141 for U.P.C. Company Prefix 614141). The tweak factor isn't used directly by the identifier creators; instead, it is used as a multiplier together with an internally-defined prime number per numeric identifier type so that each numeric identifier creator returns a different sequence of identifiers.
 
-The prefix manager maintains a cache of identifier creators, each accessible by name (e.g., `prefixManager.ssccCreator` for the SSCC creator), as well as the method [`getIdentifierCreator()`](https://aidc-toolkit.com/api/GS1/classes/PrefixManager.html#getidentifiercreator) to get any identifier creator by identifier type.
+The prefix manager maintains a cache of identifier creators, each accessible by name (e.g., `prefixManager.ssccCreator` for the SSCC creator), as well as the method [`getIdentifierCreator()`](https://aidc-toolkit.com/v1.0/api/GS1/classes/PrefixManager.html#getidentifiercreator) to get any identifier creator by identifier type.
 
 ### Additional Identifier Capability
 
 #### Variable Measure
 
-The [`VariableMeasure`](https://aidc-toolkit.com/api/GS1/classes/VariableMeasure.html) class provides static methods to parse and create a variable measure identifiers:
+The [`VariableMeasure`](https://aidc-toolkit.com/v1.0/api/GS1/classes/VariableMeasure.html) class provides static methods to parse and create a variable measure identifiers:
 
-- [`parseRCN()`](https://aidc-toolkit.com/api/GS1/classes/VariableMeasure.html#parsercn) - Parse a Restricted Circulation Number (RCN) into an item reference and price or weight.
-- [`createRCN()`](https://aidc-toolkit.com/api/GS1/classes/VariableMeasure.html#creatercn) - Create a Restricted Circulation Number (RCN) from an item reference and price or weight.
+- [`parseRCN()`](https://aidc-toolkit.com/v1.0/api/GS1/classes/VariableMeasure.html#parsercn) - Parse a Restricted Circulation Number (RCN) into an item reference and price or weight.
+- [`createRCN()`](https://aidc-toolkit.com/v1.0/api/GS1/classes/VariableMeasure.html#creatercn) - Create a Restricted Circulation Number (RCN) from an item reference and price or weight.
 
 ### GS1 Services
 
@@ -296,27 +296,10 @@ GS1 provides a lookup service called [Verified by GS1](https://www.gs1.org/servi
 
 #### Verified by GS1
 
-The [`verifiedByGS1()`](https://aidc-toolkit.com/api/GS1/functions/verifiedByGS1.html) function creates a [`Hyperlink`](https://aidc-toolkit.com/api/Core/interfaces/Hyperlink.html) object with the appropriate path to query any GS1 identifier. The link is to a user interface, so automated retrieval of the data is not supported.
+The [`verifiedByGS1()`](https://aidc-toolkit.com/v1.0/api/GS1/functions/verifiedByGS1.html) function creates a [`Hyperlink`](https://aidc-toolkit.com/v1.0/api/Core/interfaces/Hyperlink.html) object with the appropriate path to query any GS1 identifier. The link is to a user interface, so automated retrieval of the data is not supported.
 
 #### GS1 Company Prefix Length Determination
 
-GS1 Company Prefix length determination is required when encoding a GS1 identifier as an EPC URN. Though this is typically done by the GS1 Company Prefix licensee (who knows the length), it's occasionally required by downstream trading partners such as distributors.
+GS1 Company Prefix length determination is required when encoding a GS1 identifier as an EPC URN. Although this is typically done by the GS1 Company Prefix licensee (who knows the length), it's occasionally required by downstream trading partners such as distributors.
 
-This functionality part of the [`PrefixManager`](https://aidc-toolkit.com/api/GS1/classes/PrefixManager.html) class.
-
-The first step is to load the GS1 Company Prefix length data. This is done using [`loadGCPLengthData()`](https://aidc-toolkit.com/api/GS1/classes/PrefixManager.html#loadgcplengthdata) static method, which takes a [`GCPLengthCache`](https://aidc-toolkit.com/api/GS1/classes/GCPLengthCache.html) object. The cache object is used to store the data so that it can be shared across multiple instances of the prefix manager.
-
-The `loadGCPLengthData()` method works as follows:
-
-- If the next check date/time is in the future, the method returns immediately, regardless of whether any data is available. It does this to prevent a large number of requests to the source in the event of a failure.
-- Otherwise, if the cache date/time is undefined or less than the source date/time, it loads from the source, converts the data if necessary, and updates the cache.
-- Otherwise, it continues with the cached data.
-- The next check date/time is updated to the later of the source date/time plus one week and the current date/time plus one day.
-
-The base class implementation of the `GCPLengthCache` manages only the cache itself, and it requires an application-provided [`AppDataStorage`](https://aidc-toolkit.com/api/Core/classes/AppDataStorage.html) storage implementation. The source is expected to be either a [`GCPLengthData`](https://aidc-toolkit.com/api/GS1/interfaces/GCPLengthData.html) object (created via another cache implementation) or a [`GCPLengthSourceJSON`](https://aidc-toolkit.com/api/GS1/interfaces/GCPLengthSourceJSON.html) object, which is the format of the file provided by GS1.
-
-The [`RemoteGCPLengthCache`](https://aidc-toolkit.com/api/GS1/classes/RemoteGCPLengthCache.html) class provides access to the data from a remote source, by default the AIDC Toolkit website. If any error occurs, the next check date/time is set to the current date/time plus ten minutes to prevent the network from being overloaded.
-
-The data on the AIDC Toolkit website is updated regularly with the data provided by GS1, and it's stored in binary format for faster retrieval.
-
-Once the data is loaded, the [`gcpLength()`](https://aidc-toolkit.com/api/GS1/classes/PrefixManager.html#gcplength) method can be used to get the length of a GS1 Company Prefix for a given identifier type.
+This functionality is provided by the [`GCPLength`](https://aidc-toolkit.com/v1.0/api/GS1/classes/GCPLength.html) class.

package/dist/gcp-length-cache.d.ts

@@ -50,7 +50,12 @@ export declare abstract class GCPLengthCache extends Cache<GCPLengthData, GCPLen
     update(nextCheckDateTime: Date, _cacheDateTime?: Date, cacheData?: GCPLengthData): Promise<void>;
 }
 /**
- * GS1 Company Prefix length cache with remote source.
+ * GS1 Company Prefix length cache with remote source. This class provides access to the data from a remote source, by
+ * default the AIDC Toolkit website. If any error occurs, the next check date/time is set to the current date/time plus
+ * ten minutes to prevent the network from being overloaded.
+ *
+ * The data on the AIDC Toolkit website is updated regularly with the data provided by GS1, and it's stored in binary
+ * format for faster retrieval.
  */
 export declare class RemoteGCPLengthCache extends GCPLengthCache {
     #private;

package/dist/gcp-length-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gcp-length-cache.d.ts","sourceRoot":"","sources":["../src/gcp-length-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,KAAK,cAAc,EACnB,KAAK,EAIR,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEH,KAAK,aAAa,EAElB,KAAK,mBAAmB,EAG3B,MAAM,sBAAsB,CAAC;AAG9B;;GAEG;AACH,8BAAsB,cAAe,SAAQ,KAAK,CAAC,aAAa,EAAE,aAAa,GAAG,mBAAmB,CAAC;;IAClG;;OAEG;IACH,MAAM,CAAC,oBAAoB,SAAgB;IAE3C;;OAEG;IACH,MAAM,CAAC,gCAAgC,SAAqC;IAE5E;;OAEG;IACH,MAAM,CAAC,kBAAkB,SAAuB;IAEhD;;OAEG;IACH,MAAM,CAAC,gBAAgB,SAAqB;IAY5C;;;;;OAKG;gBACS,cAAc,EAAE,cAAc,CAAC,OAAO,CAAC;IAMnD;;OAEG;IACH,IAAI,cAAc,IAAI,cAAc,CAAC,OAAO,CAAC,CAE5C;IA6CD;;OAEG;IACH,IAAa,iBAAiB,IAAI,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAE1D;IAED;;OAEG;IACH,IAAa,aAAa,IAAI,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAEtD;IAED;;OAEG;IACH,IAAa,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC,CAS/C;IAED;;OAEG;IACY,MAAM,CAAC,iBAAiB,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;CAmBlH;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,cAAc;;IACpD;;OAEG;IACH,MAAM,CAAC,gBAAgB,SAA8B;IAYrD;;;;;;;;;OASG;gBACS,cAAc,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,OAAO,GAAE,MAA8C;IA0C5G;;OAEG;IACH,IAAa,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAY3C;IAED;;OAEG;IACH,IAAa,UAAU,IAAI,OAAO,CAAC,aAAa,CAAC,CAmBhD;CACJ"}
+{"version":3,"file":"gcp-length-cache.d.ts","sourceRoot":"","sources":["../src/gcp-length-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,KAAK,cAAc,EACnB,KAAK,EAIR,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEH,KAAK,aAAa,EAElB,KAAK,mBAAmB,EAG3B,MAAM,sBAAsB,CAAC;AAG9B;;GAEG;AACH,8BAAsB,cAAe,SAAQ,KAAK,CAAC,aAAa,EAAE,aAAa,GAAG,mBAAmB,CAAC;;IAClG;;OAEG;IACH,MAAM,CAAC,oBAAoB,SAAgB;IAE3C;;OAEG;IACH,MAAM,CAAC,gCAAgC,SAAqC;IAE5E;;OAEG;IACH,MAAM,CAAC,kBAAkB,SAAuB;IAEhD;;OAEG;IACH,MAAM,CAAC,gBAAgB,SAAqB;IAY5C;;;;;OAKG;gBACS,cAAc,EAAE,cAAc,CAAC,OAAO,CAAC;IAMnD;;OAEG;IACH,IAAI,cAAc,IAAI,cAAc,CAAC,OAAO,CAAC,CAE5C;IA6CD;;OAEG;IACH,IAAa,iBAAiB,IAAI,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAE1D;IAED;;OAEG;IACH,IAAa,aAAa,IAAI,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAEtD;IAED;;OAEG;IACH,IAAa,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC,CAS/C;IAED;;OAEG;IACY,MAAM,CAAC,iBAAiB,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;CAmBlH;AAED;;;;;;;GAOG;AACH,qBAAa,oBAAqB,SAAQ,cAAc;;IACpD;;OAEG;IACH,MAAM,CAAC,gBAAgB,SAA8B;IAYrD;;;;;;;;;OASG;gBACS,cAAc,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,OAAO,GAAE,MAA8C;IA0C5G;;OAEG;IACH,IAAa,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAY3C;IAED;;OAEG;IACH,IAAa,UAAU,IAAI,OAAO,CAAC,aAAa,CAAC,CAmBhD;CACJ"}

package/dist/gcp-length-cache.js

@@ -133,7 +133,12 @@ export class GCPLengthCache extends Cache {
 }
 _a = GCPLengthCache;
 /**
- * GS1 Company Prefix length cache with remote source.
+ * GS1 Company Prefix length cache with remote source. This class provides access to the data from a remote source, by
+ * default the AIDC Toolkit website. If any error occurs, the next check date/time is set to the current date/time plus
+ * ten minutes to prevent the network from being overloaded.
+ *
+ * The data on the AIDC Toolkit website is updated regularly with the data provided by GS1, and it's stored in binary
+ * format for faster retrieval.
  */
 export class RemoteGCPLengthCache extends GCPLengthCache {
     /**
@@ -181,7 +186,7 @@ export class RemoteGCPLengthCache extends GCPLengthCache {
     async #getRemoteAppData(pathKey, asBinary, callback) {
         return this.#remoteAppDataStorage.read(pathKey, asBinary).then((appData) => {
             if (appData === undefined) {
-                throw new RangeError(i18nextGS1.t("Prefix.gs1CompanyPrefixLengthDataFileNotFound", {
+                throw new RangeError(i18nextGS1.t("GCPLength.gs1CompanyPrefixLengthDataFileNotFound", {
                     key: pathKey
                 }));
             }

package/dist/gcp-length-cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"gcp-length-cache.js","sourceRoot":"","sources":["../src/gcp-length-cache.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"gcp-length-cache.js","sourceRoot":"","sources":["../src/gcp-length-cache.ts"],"names":[],"mappings":"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"}

package/dist/gcp-length-tree.d.ts

@@ -0,0 +1,33 @@
+import type { GCPLengthHeader } from "./gcp-length-data.js";
+/**
+ * Leaf of GS1 Company Prefix length tree.
+ */
+export interface Leaf {
+    readonly length: number;
+}
+/**
+ * Branch of GS1 Company Prefix length tree.
+ */
+export interface Branch {
+    readonly childNodes: ReadonlyArray<Node | undefined>;
+}
+/**
+ * Root of GS1 Company Prefix length tree.
+ */
+export interface Root extends GCPLengthHeader, Branch {
+}
+/**
+ * Node in GS1 Company Prefix length tree.
+ */
+export type Node = Branch | Leaf;
+/**
+ * Determine if a node is a leaf.
+ *
+ * @param node
+ * Node.
+ *
+ * @returns
+ * True if node is a leaf.
+ */
+export declare function isLeaf(node: Node): node is Leaf;
+//# sourceMappingURL=gcp-length-tree.d.ts.map

package/dist/gcp-length-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcp-length-tree.d.ts","sourceRoot":"","sources":["../src/gcp-length-tree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,IAAI;IACjB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACnB,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC;CACxD;AAED;;GAEG;AACH,MAAM,WAAW,IAAK,SAAQ,eAAe,EAAE,MAAM;CACpD;AAED;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;AAEjC;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,IAAI,IAAI,CAE/C"}

package/dist/gcp-length-tree.js

@@ -0,0 +1,13 @@
+/**
+ * Determine if a node is a leaf.
+ *
+ * @param node
+ * Node.
+ *
+ * @returns
+ * True if node is a leaf.
+ */
+export function isLeaf(node) {
+    return "length" in node;
+}
+//# sourceMappingURL=gcp-length-tree.js.map

package/dist/gcp-length-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcp-length-tree.js","sourceRoot":"","sources":["../src/gcp-length-tree.ts"],"names":[],"mappings":"AA2BA;;;;;;;;GAQG;AACH,MAAM,UAAU,MAAM,CAAC,IAAU;IAC7B,OAAO,QAAQ,IAAI,IAAI,CAAC;AAC5B,CAAC"}

package/dist/gcp-length.d.ts

@@ -1,61 +1,75 @@
 import type { GCPLengthCache } from "./gcp-length-cache.js";
-import { type GCPLengthHeader } from "./gcp-length-data.js";
+import * as GCPLengthTree from "./gcp-length-tree.js";
 import { type IdentifierType } from "./identifier-type.js";
 /**
- * Leaf of GS1 Company Prefix length tree.
+ * Interim branch of GS1 Company Prefix length tree with writeable child nodes.
  */
-export interface Leaf {
-    length: number;
+export interface InterimBranch {
+    readonly childNodes: Array<InterimBranch | GCPLengthTree.Leaf | undefined>;
 }
 /**
- * Branch of GS1 Company Prefix length tree.
- */
-export interface Branch {
-    childNodes: Array<Node | undefined>;
-}
-/**
- * Root of GS1 Company Prefix length tree.
- */
-export interface Root extends GCPLengthHeader, Branch {
-}
-/**
- * Node in GS1 Company Prefix length tree.
- */
-export type Node = Root | Branch | Leaf;
-/**
- * Determine if a node is a leaf.
+ * GS1 Company Prefix length service. The constructor takes a {@linkcode GCPLengthCache} object, which is responsible
+ * for managing the cache and source.
  *
- * @param node
- * Node.
+ * The first step is to load the GS1 Company Prefix length data. This is done using the
+ * {@linkcode GCPLength.load | load()} method, which works as follows:
  *
- * @returns
- * True if node is a leaf.
- */
-export declare function isLeaf(node: Node): node is Leaf;
-/**
- * Load the GS1 Company Prefix length data.
- *
- * @param gcpLengthCache
- * GS1 Company Prefix length cache.
- *
- * @returns
- * Root of tree.
- */
-export declare function loadData(gcpLengthCache: GCPLengthCache): Promise<Root | undefined>;
-/**
- * Get the length of a GS1 Company Prefix for an identifier.
- *
- * @param root
- * Root of tree.
+ * - If the next check date/time is in the future, the method returns immediately, regardless of whether any data is
+ * available. It does this to prevent a large number of requests to the source in the event of a failure.
+ * - Otherwise, if the cache date/time is undefined or less than the source date/time, it loads from the source,
+ * converts the data if necessary, and updates the cache.
+ * - Otherwise, it continues with the cached data.
+ * - The next check date/time is updated to the later of the source date/time plus one week and the current date/time
+ * plus one day.
  *
- * @param identifierType
- * Identifier type.
+ * The base class implementation of the `GCPLengthCache` manages only the cache itself, and it requires an
+ * application-provided storage implementation. The source is expected to be either a {@linkcode GCPLengthData} object
+ * (created via another cache implementation) or a {@linkcode GCPLengthSourceJSON} object, which is the format of the
+ * file provided by GS1.
  *
- * @param identifier
- * Identifier.
- *
- * @returns
- * Length of GS1 Company Prefix, 0 if not a GS1 Company Prefix, or -1 if not found.
+ * Once the data is loaded, the {@linkcode GCPLength.lengthOf | lengthOf()} method can be used to get the length of a
+ * GS1 Company Prefix for an identifier type and identifier.
  */
-export declare function getFor(root: Root, identifierType: IdentifierType, identifier: string): number;
+export declare class GCPLength {
+    #private;
+    /**
+     * Constructor.
+     *
+     * @param gcpLengthCache
+     * GS1 Company Prefix length cache.
+     */
+    constructor(gcpLengthCache: GCPLengthCache);
+    /**
+     * Get the GS1 Company Prefix length tree root.
+     *
+     * @returns
+     * GS1 Company Prefix length tree root.
+     */
+    get root(): GCPLengthTree.Root;
+    /**
+     * Get the date/time the GS1 Company Prefix length data was last updated.
+     */
+    get dateTime(): Date;
+    /**
+     * Get the disclaimer for the GS1 Company Prefix length data.
+     */
+    get disclaimer(): string;
+    /**
+     * Load the GS1 Company Prefix length data.
+     */
+    load(): Promise<void>;
+    /**
+     * Get the length of a GS1 Company Prefix for an identifier.
+     *
+     * @param identifierType
+     * Identifier type.
+     *
+     * @param identifier
+     * Identifier.
+     *
+     * @returns
+     * Length of GS1 Company Prefix, 0 if not a GS1 Company Prefix, or -1 if not found.
+     */
+    lengthOf(identifierType: IdentifierType, identifier: string): number;
+}
 //# sourceMappingURL=gcp-length.d.ts.map