@endora-commerce/contracts 0.100.0

package/dist/shopping-lists.js

@@ -0,0 +1,92 @@
+import { z } from 'zod';
+import { isoDateTimeSchema, uuidSchema } from './common.js';
+/**
+ * Shopping list contracts (T202 / FR-031..FR-033).
+ *
+ * A shopping list is a per-customer, named collection of (product, variant?, quantity)
+ * rows with optional notes. Two terminal actions:
+ *   - convertToCart  — adds the (selected or all) items to the customer's active cart;
+ *                      archived products are skipped and reported.
+ *   - convertToRfq   — adds the (selected or all) items to the customer's draft RFQ;
+ *                      same skip-and-report behaviour.
+ *
+ * Lists are private to the (customer, organization) pair today; sharing within an
+ * organization is intentionally out of scope for the MVP — the entity has no
+ * `isShared` column yet to keep the surface narrow.
+ */
+export const shoppingListItemSchema = z.object({
+    id: uuidSchema,
+    shoppingListId: uuidSchema,
+    productId: uuidSchema,
+    variantId: uuidSchema.nullable(),
+    quantity: z.number().int().positive(),
+    note: z.string().max(2000).nullable(),
+    createdAt: isoDateTimeSchema,
+    updatedAt: isoDateTimeSchema,
+});
+export const shoppingListSchema = z.object({
+    id: uuidSchema,
+    organizationId: z.string(),
+    customerAccountId: uuidSchema,
+    name: z.string().min(1).max(160),
+    /** Whether this is the customer's default shopping list (exactly one per customer). */
+    isDefault: z.boolean(),
+    items: z.array(shoppingListItemSchema),
+    createdAt: isoDateTimeSchema,
+    updatedAt: isoDateTimeSchema,
+});
+/** Lightweight default-list view for the storefront header heart badge. */
+export const defaultShoppingListSummarySchema = z.object({
+    id: uuidSchema,
+    name: z.string(),
+    itemCount: z.number().int().nonnegative(),
+});
+// --- Requests --------------------------------------------------------------
+export const createShoppingListRequestSchema = z.object({
+    name: z.string().min(1).max(160),
+});
+export const renameShoppingListRequestSchema = z
+    .object({
+    name: z.string().min(1).max(160),
+})
+    .strict();
+export const addShoppingListItemRequestSchema = z.object({
+    productId: uuidSchema,
+    variantId: uuidSchema.optional(),
+    quantity: z.number().int().positive(),
+    note: z.string().max(2000).optional(),
+});
+export const updateShoppingListItemRequestSchema = z
+    .object({
+    quantity: z.number().int().positive().optional(),
+    note: z.string().max(2000).nullable().optional(),
+})
+    .strict();
+/**
+ * The convert request optionally narrows by item id; an empty (or missing)
+ * `itemIds` array means "convert every item on the list".
+ */
+export const convertShoppingListRequestSchema = z
+    .object({
+    itemIds: z.array(uuidSchema).optional(),
+})
+    .strict();
+// --- Responses -------------------------------------------------------------
+/** Per-item skip note returned when conversion encounters an archived product. */
+export const conversionSkipSchema = z.object({
+    itemId: uuidSchema,
+    productId: uuidSchema,
+    reason: z.enum(['product_archived', 'variant_unavailable', 'product_not_found']),
+});
+export const convertToCartResponseSchema = z.object({
+    shoppingListId: uuidSchema,
+    added: z.number().int().nonnegative(),
+    skipped: z.array(conversionSkipSchema),
+});
+export const convertToRfqResponseSchema = z.object({
+    shoppingListId: uuidSchema,
+    rfqId: uuidSchema,
+    added: z.number().int().nonnegative(),
+    skipped: z.array(conversionSkipSchema),
+});
+//# sourceMappingURL=shopping-lists.js.map

package/dist/shopping-lists.js.map

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

package/dist/taxes.d.ts

@@ -0,0 +1,106 @@
+import { z } from 'zod';
+export declare const taxSchema: z.ZodObject<{
+    id: z.ZodString;
+    code: z.ZodString;
+    name: z.ZodString;
+    rate: z.ZodNumber;
+    country: z.ZodNullable<z.ZodString>;
+    productType: z.ZodNullable<z.ZodEnum<{
+        simple: "simple";
+        configurable: "configurable";
+        grouped: "grouped";
+        bundle: "bundle";
+        virtual: "virtual";
+    }>>;
+    appliesToVatStatuses: z.ZodArray<z.ZodEnum<{
+        vat_payer: "vat_payer";
+        vat_exempt: "vat_exempt";
+        reverse_charge: "reverse_charge";
+    }>>;
+    isDefault: z.ZodBoolean;
+    priority: z.ZodNumber;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type Tax = z.infer<typeof taxSchema>;
+export declare const upsertTaxRequestSchema: z.ZodObject<{
+    code: z.ZodString;
+    name: z.ZodString;
+    rate: z.ZodNumber;
+    country: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    productType: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        simple: "simple";
+        configurable: "configurable";
+        grouped: "grouped";
+        bundle: "bundle";
+        virtual: "virtual";
+    }>>>;
+    appliesToVatStatuses: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        vat_payer: "vat_payer";
+        vat_exempt: "vat_exempt";
+        reverse_charge: "reverse_charge";
+    }>>>;
+    isDefault: z.ZodOptional<z.ZodBoolean>;
+    priority: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const taxResolutionInputSchema: z.ZodObject<{
+    country: z.ZodString;
+    productType: z.ZodEnum<{
+        simple: "simple";
+        configurable: "configurable";
+        grouped: "grouped";
+        bundle: "bundle";
+        virtual: "virtual";
+    }>;
+    vatStatus: z.ZodEnum<{
+        vat_payer: "vat_payer";
+        vat_exempt: "vat_exempt";
+        reverse_charge: "reverse_charge";
+    }>;
+}, z.core.$strip>;
+export type TaxResolutionInput = z.infer<typeof taxResolutionInputSchema>;
+/**
+ * The resolver's answer, as a union rather than a record with a `rate` that is
+ * sometimes meaningless (issue #124).
+ *
+ * A **configured** 0% rate is a legitimate answer — zero-rated supplies exist —
+ * so `rule` and `default` carry a `rate` that a caller may spend. "No rule
+ * matched and no default is configured" is not an answer at all, so the `none`
+ * arm carries **no `rate` field**: a caller has to narrow on `source` before it
+ * can read a number, and therefore has to decide, in the open, what its own
+ * surface does about it.
+ *
+ * `{ rate: 0, source: 'none' }` was the previous shape and it collapsed exactly
+ * that distinction — every consumer read `.rate`, got `0`, and quoted a zero-VAT
+ * figure nobody had configured onto documents that had already gone out.
+ *
+ * A third state, "the `taxes` module is absent", is deliberately **not** in this
+ * union: absence is not a value. The port gate throws `MODULE_DISABLED` before a
+ * resolution runs, so a caller never has to tell an absent owner from a silent
+ * one.
+ */
+export declare const resolvedTaxSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    source: z.ZodLiteral<"rule">;
+    rate: z.ZodNumber;
+    taxId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    source: z.ZodLiteral<"default">;
+    rate: z.ZodNumber;
+    taxId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    source: z.ZodLiteral<"none">;
+}, z.core.$strip>], "source">;
+export type ResolvedTax = z.infer<typeof resolvedTaxSchema>;
+/**
+ * Container name: `taxService`. Owner: `taxes`.
+ *
+ * `ResolvedTax`'s `none` arm is the reason this shape is a union rather than a
+ * number: "no rule matched" is a real answer with real consequences, and a
+ * caller that read a `rate` off the `none` arm would get `undefined` and quote
+ * zero. Issue #124 was exactly that, in `orders`' closure, and the union is
+ * what makes the compiler refuse it.
+ */
+export interface TaxServicePort {
+    taxRateFor(input: TaxResolutionInput): Promise<ResolvedTax>;
+}
+//# sourceMappingURL=taxes.d.ts.map

package/dist/taxes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taxes.d.ts","sourceRoot":"","sources":["../src/taxes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkBxB,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;iBAYpB,CAAC;AACH,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAE5C,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;iBAYjC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;iBAInC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;6BAY5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAU5D;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAC7D"}

package/dist/taxes.js

@@ -0,0 +1,80 @@
+import { z } from 'zod';
+import { isoDateTimeSchema, uuidSchema } from './common.js';
+/**
+ * Tax contracts (T128, T131 / FR-051).
+ *
+ * Each rule narrows by zero or more of:
+ *   - `country`         (delivery country, ISO 3166-1 alpha-2)
+ *   - `productType`     (the catalog Product.type — simple/variant/grouped/virtual)
+ *   - `appliesToVatStatuses` (Organization.vatStatus values that match)
+ *
+ * Resolution picks the most specific matching rule (most narrowed
+ * conditions). Ties fall back to the rule with `priority` highest;
+ * when no rule matches, the default rule (if any) is used.
+ */
+const VAT_STATUS = z.enum(['vat_payer', 'vat_exempt', 'reverse_charge']);
+export const taxSchema = z.object({
+    id: uuidSchema,
+    code: z.string().min(1).max(64),
+    name: z.string().min(1).max(160),
+    rate: z.number().finite().nonnegative(),
+    country: z.string().length(2).nullable(),
+    productType: z.enum(['simple', 'configurable', 'grouped', 'bundle', 'virtual']).nullable(),
+    appliesToVatStatuses: z.array(VAT_STATUS),
+    isDefault: z.boolean(),
+    priority: z.number().int(),
+    createdAt: isoDateTimeSchema,
+    updatedAt: isoDateTimeSchema,
+});
+export const upsertTaxRequestSchema = z.object({
+    code: z.string().min(1).max(64),
+    name: z.string().min(1).max(160),
+    rate: z.number().finite().nonnegative(),
+    country: z.string().length(2).nullable().optional(),
+    productType: z
+        .enum(['simple', 'configurable', 'grouped', 'bundle', 'virtual'])
+        .nullable()
+        .optional(),
+    appliesToVatStatuses: z.array(VAT_STATUS).optional(),
+    isDefault: z.boolean().optional(),
+    priority: z.number().int().optional(),
+});
+export const taxResolutionInputSchema = z.object({
+    country: z.string().length(2),
+    productType: z.enum(['simple', 'configurable', 'grouped', 'bundle', 'virtual']),
+    vatStatus: VAT_STATUS,
+});
+/**
+ * The resolver's answer, as a union rather than a record with a `rate` that is
+ * sometimes meaningless (issue #124).
+ *
+ * A **configured** 0% rate is a legitimate answer — zero-rated supplies exist —
+ * so `rule` and `default` carry a `rate` that a caller may spend. "No rule
+ * matched and no default is configured" is not an answer at all, so the `none`
+ * arm carries **no `rate` field**: a caller has to narrow on `source` before it
+ * can read a number, and therefore has to decide, in the open, what its own
+ * surface does about it.
+ *
+ * `{ rate: 0, source: 'none' }` was the previous shape and it collapsed exactly
+ * that distinction — every consumer read `.rate`, got `0`, and quoted a zero-VAT
+ * figure nobody had configured onto documents that had already gone out.
+ *
+ * A third state, "the `taxes` module is absent", is deliberately **not** in this
+ * union: absence is not a value. The port gate throws `MODULE_DISABLED` before a
+ * resolution runs, so a caller never has to tell an absent owner from a silent
+ * one.
+ */
+export const resolvedTaxSchema = z.discriminatedUnion('source', [
+    z.object({
+        source: z.literal('rule'),
+        rate: z.number().finite().nonnegative(),
+        taxId: uuidSchema,
+    }),
+    z.object({
+        source: z.literal('default'),
+        rate: z.number().finite().nonnegative(),
+        taxId: uuidSchema,
+    }),
+    z.object({ source: z.literal('none') }),
+]);
+//# sourceMappingURL=taxes.js.map

package/dist/taxes.js.map

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

package/dist/text-normalization.d.ts

@@ -0,0 +1,199 @@
+/**
+ * One diacritic fold — and, since issue #245, one slug generator — for every
+ * package that has to compare or key two spellings of the same word.
+ *
+ * `foldDiacritics` is the fold (issue #240). `slugify` is the generator built
+ * on it, and it replaced **eight** private copies; its own doc block carries
+ * the reasons that are specific to slugs. Everything below is about the fold.
+ *
+ * ## Why this file exists rather than a helper inside one consumer
+ *
+ * The fold was correct and unreachable. It lived inside
+ * `normalizeOrganizationName` in `organizations.ts` — published from
+ * `@endora-commerce/contracts`, so importable from `backend/`, `admin/` and `storefront/`
+ * alike, but named after **one caller**. Nobody looking for "how do I compare
+ * `Łatwy` with `latwy`" searches for an organisation helper, so within a year
+ * four private copies had grown in `admin/` (repaired by !745) and two more
+ * stand in `backend/` today. Every one of them was the same one-liner and every
+ * one of them shipped the same bug.
+ *
+ * ## The bug the one-liner has
+ *
+ * ```
+ * input.normalize('NFD').replace(/\p{Diacritic}/gu, '').toLowerCase()
+ * ```
+ *
+ * reads as complete and is not. `ł` is U+0142: a single indivisible code point
+ * with **no canonical decomposition**, so NFD leaves it exactly where it was,
+ * the strip finds no combining mark to remove, and the `[^a-z0-9]+` pass a
+ * slugifier runs next deletes the letter outright — `Łatwy szablon` becomes
+ * `atwy-szablon`. The same holds for `Ø ø Đ đ Ð ð Þ þ ß Æ æ Œ œ`. The fix is one
+ * extra step, and it is the only reason this is longer than a line: map those
+ * letters explicitly.
+ *
+ * ## A function, not a port
+ *
+ * It is pure over its argument, so it cannot answer differently depending on
+ * which modules are switched on, and a gated port answering 503 `MODULE_DISABLED`
+ * to "fold these diacritics" would be a bug rather than a safety property.
+ * Node natives only (Principle IV) — a full Unicode-folding library is not worth
+ * a dependency for fifteen letters.
+ */
+/**
+ * Latin letters NFD does not decompose, and their ASCII approximations.
+ *
+ * Every entry is a **single code point** whose Unicode decomposition is empty:
+ * a stroked, hooked or ligated letter rather than a base plus a combining mark.
+ * That is precisely the set NFD cannot help with, which is why it is hand-written.
+ *
+ * Exported so a test can enumerate it and a reader can see the whole set at
+ * once — not as an invitation to write a second fold around it. Reach for
+ * `foldDiacritics` instead; a copy of the map without the decomposition step
+ * is half a fold, and half a fold is what this file exists to end.
+ */
+export declare const NON_DECOMPOSING_LATIN: Readonly<Record<string, string>>;
+/**
+ * Fold a string so two spellings of the same word compare equal: diacritics
+ * removed, non-decomposing Latin letters mapped to ASCII, lowercased.
+ *
+ * In order:
+ *
+ * 1. **Decompose (NFD)** — separate every base character from its combining
+ *    marks, so `ó` becomes `o` + U+0301.
+ * 2. **Strip the combining marks** via `\p{Diacritic}`.
+ * 3. **Map what NFD could not decompose**, per `NON_DECOMPOSING_LATIN`. This
+ *    step runs **after** the decomposition on purpose: `Ǿ` (U+01FE) decomposes
+ *    to `Ø` + U+0301, so a map applied first would not see the `Ø` that step 1
+ *    is about to expose. Mapping first — as `admin/`'s copy did until issue
+ *    #240 — folds `Ǿ` to `ø` instead of `o`.
+ * 4. **Lowercase.** Callers compare case-insensitively without exception, and
+ *    the ASCII expansions above (`Th`, `AE`, `OE`) have to be lowered anyway.
+ *
+ * Whitespace is deliberately **not** touched: what counts as one space is the
+ * caller's policy, not the fold's. `normalizeOrganizationName` collapses runs
+ * and trims because it writes a search column; `admin`'s `normalize` only
+ * trims. Both compose it here rather than each folding its own way.
+ *
+ * Not a case-folding routine in the Unicode sense: it lowercases, it does not
+ * apply full case folding, and anything outside Latin (Cyrillic, CJK, Greek)
+ * passes through with its case lowered and nothing else changed.
+ */
+export declare function foldDiacritics(input: string): string;
+/**
+ * How one caller's slug grammar differs from another's. Every field is the
+ * caller's own policy; the *steps* are not negotiable and are not options.
+ */
+export interface SlugifyOptions {
+    /**
+     * What a run of unusable characters collapses to. `-` everywhere except the
+     * newsletter tag code, whose stored grammar is `_`.
+     */
+    readonly separator?: string;
+    /**
+     * The caller's own column or contract limit. **Deliberately not defaulted to
+     * a repo-wide number**: eight call sites cap at 80, 150, 160, 180 or not at
+     * all, and each cap decides which *new* values collide under that caller's
+     * unique constraint. Normalising them would be a data decision dressed as a
+     * tidy-up.
+     */
+    readonly maxLength?: number;
+    /** What an input that folds away to nothing produces. Empty string by default. */
+    readonly fallback?: string;
+    /**
+     * Characters the caller's grammar allows **besides** `[a-z0-9]`, which
+     * therefore survive instead of collapsing to the separator.
+     *
+     * Empty for every slug in the kebab family, and that is the reason this is an
+     * option rather than a widening of the rule: `pim_ergonode`'s option values
+     * are stored under `^[a-z0-9_-]{1,200}$`, a grammar with **two** usable
+     * punctuation characters, so a generator that knows only one separator cannot
+     * express it. Without this, folding those values correctly would also have
+     * turned every already-correct `xl-red` into `xl_red` — a rename with no
+     * defect behind it, and one that orphans the option every product already
+     * points at (issue #260).
+     *
+     * Members are matched literally inside a negated character class, so a
+     * caller passes the characters themselves (`'-'`), not an escaped class.
+     */
+    readonly preserve?: string;
+}
+/**
+ * The repository's one slug generator (issue #245).
+ *
+ * There were **eight**: three in `backend/`, five in `admin/`, each a private
+ * four-line chain that read as obviously right. Two of them
+ * (`cms-template-layout.ts`, `pim_ergonode`'s `slugFromSourceCode`) had no fold
+ * step at all — `Żółw` produced `w` and `Świeże Ćwikła` produced `wie-e-wik-a`
+ * — and `check:diacritic-folds` was structurally blind to both, because it
+ * counts folds written *outside* the shared helper and a site that folds
+ * nothing writes none. A shared generator is what makes "does this slug fold?"
+ * a question with one answer.
+ *
+ * The steps, in order:
+ *
+ * 1. **Fold** via `foldDiacritics` — decompose, strip the combining marks, map
+ *    the letters NFD leaves standing, lowercase.
+ * 2. **Collapse** every run of `[^a-z0-9]` — minus whatever `preserve` adds to
+ *    the usable set — to the separator.
+ * 3. **Strip a leading separator**, before the slice — a leading separator can
+ *    never survive, so it must not spend a character of the caller's budget.
+ * 4. **Slice** to `maxLength`, when the caller has one.
+ * 5. **Strip trailing separators**, after the slice — the cut can *create* one,
+ *    which is the whole point (see below).
+ * 6. **Fall back** when nothing survived.
+ *
+ * ## NFD, not NFKD, and that is a decision
+ *
+ * Three of the eight normalised with `NFKD`, which additionally maps the
+ * compatibility characters: `fi` to `fi`, `²` to `2`, the full-width forms to
+ * their ASCII. Those mappings reach a slug **only** through characters that map
+ * *into* `[a-z0-9]`, and none of them is typed into a product name, a feed
+ * template name or a CMS page title. Where one does appear it now collapses to
+ * the separator rather than to a letter, so the slug stays legal and merely
+ * loses a character nobody could see in it. Against that, `ł` was being deleted
+ * out of every Polish name those three touched. The trade was taken for the
+ * admin pair in !753 and holds identically here.
+ *
+ * It has one consequence worth naming: two inputs `NFKD` kept apart can now
+ * fold together (`Kabel²` and `Kabel³` both become `kabel`). Every caller whose
+ * slug is unique-constrained already allocates against the live table —
+ * `CatalogAdminService.allocateUniqueSlug`, `pim_ergonode`'s
+ * `createWithFreeSlug` — so the second one is suffixed rather than rejected,
+ * exactly as two products sharing a plain name already are.
+ *
+ * ## The trailing strip runs after the slice, which is a change for six sites
+ *
+ * Six of the eight stripped **both** edge separators before cutting to length,
+ * so a cut landing on a separator left the slug ending in one:
+ * `...w-wersji-rozszerzona-`. Only `BlockEditor` and `PageEditor` had it right.
+ * This is the one change here that is not about diacritics; it shows only on an
+ * input long enough to be truncated, and it makes the result satisfy the kebab
+ * grammar (`^[a-z0-9]+(?:-[a-z0-9]+)*$`) that `pim_ergonode`'s own doc block
+ * already claimed for it.
+ *
+ * The **leading** strip stays where all eight had it — before the slice — for a
+ * reason that is not symmetry: a leading separator is never part of the answer,
+ * so letting it consume a character of `maxLength` would shorten every slug
+ * whose input begins with punctuation by one, in six sites at once, for no
+ * gain. Only the trailing edge can be *created* by the cut, so only the
+ * trailing strip has to run after it.
+ *
+ * Historical values are **not** migrated (owner's ruling, 2026-08-19,
+ * originally for the admin pair in !753 and extended to the rest): only two
+ * developer environments exist, so re-slugging live rows buys nobody anything,
+ * and every one of these values is computed fresh at create time rather than
+ * re-derived to look an existing row up. New values are correct from here on.
+ *
+ * **`pim_ergonode` is the exception the ruling names, and it is the reason
+ * `preserve` exists.** Its two derivations are re-derived on every import run
+ * *to find the row a previous run created*, so a changed derivation orphans the
+ * row rather than improving it. Those values are migrated (issue #260), and the
+ * migration is only affordable because the derivation change is confined to the
+ * fold — which is what `preserve` buys.
+ *
+ * `normalizeOrganizationName` is **not** a caller and must not become one: it
+ * writes the persisted `organizations.name_search` column, which is a folded
+ * name rather than a slug.
+ */
+export declare function slugify(input: string, options?: SlugifyOptions): string;
+//# sourceMappingURL=text-normalization.d.ts.map

package/dist/text-normalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-normalization.d.ts","sourceRoot":"","sources":["../src/text-normalization.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgBlE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOpD;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAOD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6EG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,MAAM,CAmB3E"}