@endora-commerce/contracts 0.107.0 → 0.109.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/admin-actions.d.ts +12 -3
- package/dist/admin-actions.d.ts.map +1 -1
- package/dist/admin-actions.js +34 -3
- package/dist/admin-actions.js.map +1 -1
- package/dist/admin-contributions.d.ts +35 -6
- package/dist/admin-contributions.d.ts.map +1 -1
- package/dist/admin-contributions.js +46 -0
- package/dist/admin-contributions.js.map +1 -1
- package/dist/admin-feedback.d.ts +61 -0
- package/dist/admin-feedback.d.ts.map +1 -0
- package/dist/admin-feedback.js +71 -0
- package/dist/admin-feedback.js.map +1 -0
- package/dist/admin-name.d.ts +21 -0
- package/dist/admin-name.d.ts.map +1 -0
- package/dist/admin-name.js +30 -0
- package/dist/admin-name.js.map +1 -0
- package/dist/admin-notifications.d.ts +17 -1
- package/dist/admin-notifications.d.ts.map +1 -1
- package/dist/admin-preferences.d.ts +108 -0
- package/dist/admin-preferences.d.ts.map +1 -0
- package/dist/admin-preferences.js +133 -0
- package/dist/admin-preferences.js.map +1 -0
- package/dist/admin.d.ts +15 -1
- package/dist/admin.d.ts.map +1 -1
- package/dist/admin.js +7 -0
- package/dist/admin.js.map +1 -1
- package/dist/assets-library.d.ts +97 -3
- package/dist/assets-library.d.ts.map +1 -1
- package/dist/assets-library.js +5 -0
- package/dist/assets-library.js.map +1 -1
- package/dist/blog.d.ts +57 -0
- package/dist/blog.d.ts.map +1 -1
- package/dist/blog.js +63 -1
- package/dist/blog.js.map +1 -1
- package/dist/carts.d.ts +303 -50
- package/dist/carts.d.ts.map +1 -1
- package/dist/carts.js +95 -13
- package/dist/carts.js.map +1 -1
- package/dist/catalog.d.ts +512 -40
- package/dist/catalog.d.ts.map +1 -1
- package/dist/catalog.js +362 -23
- package/dist/catalog.js.map +1 -1
- package/dist/cms-brand.d.ts +2233 -0
- package/dist/cms-brand.d.ts.map +1 -0
- package/dist/cms-brand.js +311 -0
- package/dist/cms-brand.js.map +1 -0
- package/dist/cms-contact-form.d.ts +55 -0
- package/dist/cms-contact-form.d.ts.map +1 -0
- package/dist/cms-contact-form.js +100 -0
- package/dist/cms-contact-form.js.map +1 -0
- package/dist/cms.d.ts +537 -3
- package/dist/cms.d.ts.map +1 -1
- package/dist/cms.js +251 -0
- package/dist/cms.js.map +1 -1
- package/dist/common.d.ts +4 -0
- package/dist/common.d.ts.map +1 -1
- package/dist/common.js +14 -0
- package/dist/common.js.map +1 -1
- package/dist/comparisons.d.ts +7 -0
- package/dist/comparisons.d.ts.map +1 -1
- package/dist/comparisons.js +2 -0
- package/dist/comparisons.js.map +1 -1
- package/dist/credit-limits.d.ts.map +1 -1
- package/dist/credit-limits.js +3 -2
- package/dist/credit-limits.js.map +1 -1
- package/dist/crm-rich-text.d.ts +13 -0
- package/dist/crm-rich-text.d.ts.map +1 -0
- package/dist/crm-rich-text.js +13 -0
- package/dist/crm-rich-text.js.map +1 -0
- package/dist/crm.d.ts +180 -62
- package/dist/crm.d.ts.map +1 -1
- package/dist/crm.js +63 -107
- package/dist/crm.js.map +1 -1
- package/dist/custom-fields.d.ts +436 -5
- package/dist/custom-fields.d.ts.map +1 -1
- package/dist/custom-fields.js +325 -10
- package/dist/custom-fields.js.map +1 -1
- package/dist/customer-accounts.d.ts +30 -0
- package/dist/customer-accounts.d.ts.map +1 -1
- package/dist/customer-accounts.js +31 -0
- package/dist/customer-accounts.js.map +1 -1
- package/dist/document-templates.d.ts +211 -23
- package/dist/document-templates.d.ts.map +1 -1
- package/dist/document-templates.js +98 -1
- package/dist/document-templates.js.map +1 -1
- package/dist/document-values.d.ts +12 -1
- package/dist/document-values.d.ts.map +1 -1
- package/dist/document-values.js +41 -11
- package/dist/document-values.js.map +1 -1
- package/dist/email.d.ts +5 -0
- package/dist/email.d.ts.map +1 -1
- package/dist/errors.d.ts +142 -8
- package/dist/errors.d.ts.map +1 -1
- package/dist/errors.js +189 -8
- package/dist/errors.js.map +1 -1
- package/dist/index.d.ts +24 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +43 -1
- package/dist/index.js.map +1 -1
- package/dist/inventory.d.ts +3 -3
- package/dist/invoices.d.ts +6 -2
- package/dist/invoices.d.ts.map +1 -1
- package/dist/invoices.js +10 -4
- package/dist/invoices.js.map +1 -1
- package/dist/line-groups.d.ts +80 -0
- package/dist/line-groups.d.ts.map +1 -0
- package/dist/line-groups.js +130 -0
- package/dist/line-groups.js.map +1 -0
- package/dist/localized-name.d.ts +20 -0
- package/dist/localized-name.d.ts.map +1 -0
- package/dist/localized-name.js +45 -0
- package/dist/localized-name.js.map +1 -0
- package/dist/megamenu.d.ts +674 -0
- package/dist/megamenu.d.ts.map +1 -1
- package/dist/megamenu.js +96 -3
- package/dist/megamenu.js.map +1 -1
- package/dist/mfa.d.ts +1 -0
- package/dist/mfa.d.ts.map +1 -1
- package/dist/mfa.js +8 -2
- package/dist/mfa.js.map +1 -1
- package/dist/modules.d.ts +8 -1
- package/dist/modules.d.ts.map +1 -1
- package/dist/modules.js +5 -0
- package/dist/modules.js.map +1 -1
- package/dist/money-decimal.d.ts +162 -0
- package/dist/money-decimal.d.ts.map +1 -0
- package/dist/money-decimal.js +365 -0
- package/dist/money-decimal.js.map +1 -0
- package/dist/money-input.d.ts +64 -0
- package/dist/money-input.d.ts.map +1 -0
- package/dist/money-input.js +111 -0
- package/dist/money-input.js.map +1 -0
- package/dist/newsletter.d.ts +3 -3
- package/dist/order-minimums.d.ts +111 -0
- package/dist/order-minimums.d.ts.map +1 -0
- package/dist/order-minimums.js +196 -0
- package/dist/order-minimums.js.map +1 -0
- package/dist/orders.d.ts +206 -2
- package/dist/orders.d.ts.map +1 -1
- package/dist/orders.js +106 -5
- package/dist/orders.js.map +1 -1
- package/dist/page-builder-props.d.ts +1401 -0
- package/dist/page-builder-props.d.ts.map +1 -0
- package/dist/page-builder-props.js +266 -0
- package/dist/page-builder-props.js.map +1 -0
- package/dist/page-builder-values.d.ts +95 -0
- package/dist/page-builder-values.d.ts.map +1 -0
- package/dist/page-builder-values.js +164 -0
- package/dist/page-builder-values.js.map +1 -0
- package/dist/payment-methods.d.ts.map +1 -1
- package/dist/payment-methods.js +2 -1
- package/dist/payment-methods.js.map +1 -1
- package/dist/pim-connector.d.ts +1 -1
- package/dist/platform-language.d.ts +9 -0
- package/dist/platform-language.d.ts.map +1 -1
- package/dist/platform-language.js +14 -0
- package/dist/platform-language.js.map +1 -1
- package/dist/price-book-decimal.d.ts +84 -0
- package/dist/price-book-decimal.d.ts.map +1 -0
- package/dist/price-book-decimal.js +175 -0
- package/dist/price-book-decimal.js.map +1 -0
- package/dist/price-books.d.ts +2206 -0
- package/dist/price-books.d.ts.map +1 -0
- package/dist/price-books.js +777 -0
- package/dist/price-books.js.map +1 -0
- package/dist/price-lists.d.ts +309 -614
- package/dist/price-lists.d.ts.map +1 -1
- package/dist/price-lists.js +113 -453
- package/dist/price-lists.js.map +1 -1
- package/dist/product-feeds.d.ts +195 -54
- package/dist/product-feeds.d.ts.map +1 -1
- package/dist/product-feeds.js +36 -1
- package/dist/product-feeds.js.map +1 -1
- package/dist/product-scopes.d.ts +628 -0
- package/dist/product-scopes.d.ts.map +1 -0
- package/dist/product-scopes.js +365 -0
- package/dist/product-scopes.js.map +1 -0
- package/dist/product-summary-text.d.ts +23 -0
- package/dist/product-summary-text.d.ts.map +1 -0
- package/dist/product-summary-text.js +64 -0
- package/dist/product-summary-text.js.map +1 -0
- package/dist/product-url-keys.d.ts +204 -0
- package/dist/product-url-keys.d.ts.map +1 -0
- package/dist/product-url-keys.js +166 -0
- package/dist/product-url-keys.js.map +1 -0
- package/dist/product-value-resolver.d.ts +6 -0
- package/dist/product-value-resolver.d.ts.map +1 -1
- package/dist/product-value-resolver.js +6 -1
- package/dist/product-value-resolver.js.map +1 -1
- package/dist/projects.d.ts +2355 -0
- package/dist/projects.d.ts.map +1 -0
- package/dist/projects.js +837 -0
- package/dist/projects.js.map +1 -0
- package/dist/promotions.d.ts +2 -2
- package/dist/promotions.d.ts.map +1 -1
- package/dist/promotions.js +8 -2
- package/dist/promotions.js.map +1 -1
- package/dist/prompt-actions.d.ts +19 -1
- package/dist/prompt-actions.d.ts.map +1 -1
- package/dist/prompt-actions.js +31 -2
- package/dist/prompt-actions.js.map +1 -1
- package/dist/quick-order.d.ts +39 -1
- package/dist/quick-order.d.ts.map +1 -1
- package/dist/quick-order.js +44 -1
- package/dist/quick-order.js.map +1 -1
- package/dist/quote-requests.d.ts +305 -1
- package/dist/quote-requests.d.ts.map +1 -1
- package/dist/quote-requests.js +173 -5
- package/dist/quote-requests.js.map +1 -1
- package/dist/record-references.d.ts +252 -0
- package/dist/record-references.d.ts.map +1 -0
- package/dist/record-references.js +179 -0
- package/dist/record-references.js.map +1 -0
- package/dist/record-rich-text.d.ts +66 -0
- package/dist/record-rich-text.d.ts.map +1 -0
- package/dist/record-rich-text.js +303 -0
- package/dist/record-rich-text.js.map +1 -0
- package/dist/returns.d.ts +81 -2
- package/dist/returns.d.ts.map +1 -1
- package/dist/returns.js +39 -4
- package/dist/returns.js.map +1 -1
- package/dist/sales-channels.d.ts +53 -7
- package/dist/sales-channels.d.ts.map +1 -1
- package/dist/sales-channels.js +40 -4
- package/dist/sales-channels.js.map +1 -1
- package/dist/saved-list-views.d.ts +28 -0
- package/dist/saved-list-views.d.ts.map +1 -1
- package/dist/saved-list-views.js +14 -1
- package/dist/saved-list-views.js.map +1 -1
- package/dist/scoped-translations.d.ts +48 -0
- package/dist/scoped-translations.d.ts.map +1 -0
- package/dist/scoped-translations.js +78 -0
- package/dist/scoped-translations.js.map +1 -0
- package/dist/search.d.ts +73 -5
- package/dist/search.d.ts.map +1 -1
- package/dist/search.js +4 -0
- package/dist/search.js.map +1 -1
- package/dist/seo.d.ts +64 -5
- package/dist/seo.d.ts.map +1 -1
- package/dist/seo.js +31 -4
- package/dist/seo.js.map +1 -1
- package/dist/settings.d.ts +32 -3
- package/dist/settings.d.ts.map +1 -1
- package/dist/settings.js +37 -3
- package/dist/settings.js.map +1 -1
- package/dist/shipping-methods.d.ts.map +1 -1
- package/dist/shipping-methods.js +2 -1
- package/dist/shipping-methods.js.map +1 -1
- package/dist/shopping-lists.d.ts +24 -0
- package/dist/shopping-lists.d.ts.map +1 -1
- package/dist/shopping-lists.js +20 -1
- package/dist/shopping-lists.js.map +1 -1
- package/dist/storefront-cache-tags.d.ts +29 -0
- package/dist/storefront-cache-tags.d.ts.map +1 -1
- package/dist/storefront-cache-tags.js +24 -0
- package/dist/storefront-cache-tags.js.map +1 -1
- package/dist/storefront-language-path.d.ts +77 -0
- package/dist/storefront-language-path.d.ts.map +1 -0
- package/dist/storefront-language-path.js +123 -0
- package/dist/storefront-language-path.js.map +1 -0
- package/dist/storefront-value-overrides.d.ts +67 -0
- package/dist/storefront-value-overrides.d.ts.map +1 -0
- package/dist/storefront-value-overrides.js +93 -0
- package/dist/storefront-value-overrides.js.map +1 -0
- package/dist/tasks.d.ts +2842 -0
- package/dist/tasks.d.ts.map +1 -0
- package/dist/tasks.js +901 -0
- package/dist/tasks.js.map +1 -0
- package/dist/transactional-emails.d.ts +7 -4
- package/dist/transactional-emails.d.ts.map +1 -1
- package/dist/transactional-emails.js +13 -0
- package/dist/transactional-emails.js.map +1 -1
- package/package.json +2 -2
|
@@ -0,0 +1,204 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import { type ChannelUrlFacts } from './storefront-language-path.js';
|
|
3
|
+
/**
|
|
4
|
+
* Feature 163 (`specs/163-product-data-scopes/`) — product URL keys per language and
|
|
5
|
+
* per sales channel × language, their redirects, and the one helper that composes a
|
|
6
|
+
* product URL (`contracts/url-keys-and-redirects.md`, research R11, R12, R17, R28).
|
|
7
|
+
*
|
|
8
|
+
* Kept apart from `product-scopes.ts` so the URL-key work edits its own file. This
|
|
9
|
+
* module is a leaf: it imports nothing from the catalogue contracts.
|
|
10
|
+
*/
|
|
11
|
+
/**
|
|
12
|
+
* A product URL key: the grammar of `products.slug` (lower-case kebab case, at most
|
|
13
|
+
* 160 characters — the column width). Global, language and channel × language keys
|
|
14
|
+
* all share it.
|
|
15
|
+
*/
|
|
16
|
+
export declare const productSlugSchema: z.ZodString;
|
|
17
|
+
export type ProductSlug = z.infer<typeof productSlugSchema>;
|
|
18
|
+
export interface ProductPathInput {
|
|
19
|
+
/** The effective key at (channel, language). */
|
|
20
|
+
key: string;
|
|
21
|
+
/** The content language the URL is for — already resolved against the channel. */
|
|
22
|
+
languageCode: string;
|
|
23
|
+
/** The channel's URL-language facts (feature 167): its languages, default and prefix setting. */
|
|
24
|
+
channel: ChannelUrlFacts;
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
* The storefront path of a product page: `/p/<key>` under the language's path prefix
|
|
28
|
+
* (`/en/p/drill`, or `/p/wiertarka` for the default language of a channel that does
|
|
29
|
+
* not prefix it).
|
|
30
|
+
*
|
|
31
|
+
* **This is the only place a product URL is composed.** Every URL the platform
|
|
32
|
+
* emits for a product — the admin's preview link, the resolve answer's redirect
|
|
33
|
+
* target, the PDP's canonical and alternates, the sitemap, the product feeds — is
|
|
34
|
+
* built here by the backend. A key is valid only in its own language (K1), so the
|
|
35
|
+
* language travels with the link as its path prefix
|
|
36
|
+
* (`specs/167-storefront-locale-path/`, which replaced 163's interim `?lang=`).
|
|
37
|
+
*/
|
|
38
|
+
export declare function productPath(input: ProductPathInput): string;
|
|
39
|
+
/** The unprefixed product path — the `x-default` target (`specs/167-storefront-locale-path/` url-shape §8). */
|
|
40
|
+
export declare function productDefaultPath(key: string): string;
|
|
41
|
+
export declare const productUrlKeySourceSchema: z.ZodEnum<{
|
|
42
|
+
language: "language";
|
|
43
|
+
global: "global";
|
|
44
|
+
channel_language: "channel_language";
|
|
45
|
+
}>;
|
|
46
|
+
export type ProductUrlKeySource = z.infer<typeof productUrlKeySourceSchema>;
|
|
47
|
+
export declare const productUrlRedirectSchema: z.ZodObject<{
|
|
48
|
+
id: z.ZodString;
|
|
49
|
+
languageCode: z.ZodNullable<z.ZodString>;
|
|
50
|
+
key: z.ZodString;
|
|
51
|
+
createdAt: z.ZodString;
|
|
52
|
+
}, z.core.$strip>;
|
|
53
|
+
export type ProductUrlRedirect = z.infer<typeof productUrlRedirectSchema>;
|
|
54
|
+
export declare const productUrlKeysResponseSchema: z.ZodObject<{
|
|
55
|
+
data: z.ZodObject<{
|
|
56
|
+
globalKey: z.ZodString;
|
|
57
|
+
languageKeys: z.ZodArray<z.ZodObject<{
|
|
58
|
+
languageCode: z.ZodString;
|
|
59
|
+
key: z.ZodString;
|
|
60
|
+
}, z.core.$strip>>;
|
|
61
|
+
channelKeys: z.ZodArray<z.ZodObject<{
|
|
62
|
+
channelId: z.ZodString;
|
|
63
|
+
languageCode: z.ZodString;
|
|
64
|
+
key: z.ZodString;
|
|
65
|
+
orphaned: z.ZodBoolean;
|
|
66
|
+
}, z.core.$strip>>;
|
|
67
|
+
effective: z.ZodArray<z.ZodObject<{
|
|
68
|
+
channelId: z.ZodString;
|
|
69
|
+
languageCode: z.ZodString;
|
|
70
|
+
key: z.ZodString;
|
|
71
|
+
source: z.ZodEnum<{
|
|
72
|
+
language: "language";
|
|
73
|
+
global: "global";
|
|
74
|
+
channel_language: "channel_language";
|
|
75
|
+
}>;
|
|
76
|
+
url: z.ZodString;
|
|
77
|
+
}, z.core.$strip>>;
|
|
78
|
+
redirects: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
79
|
+
id: z.ZodString;
|
|
80
|
+
languageCode: z.ZodNullable<z.ZodString>;
|
|
81
|
+
key: z.ZodString;
|
|
82
|
+
createdAt: z.ZodString;
|
|
83
|
+
}, z.core.$strip>>>;
|
|
84
|
+
}, z.core.$strip>;
|
|
85
|
+
}, z.core.$strip>;
|
|
86
|
+
export type ProductUrlKeysResponse = z.infer<typeof productUrlKeysResponseSchema>;
|
|
87
|
+
export declare const putProductUrlKeysRequestSchema: z.ZodObject<{
|
|
88
|
+
globalKey: z.ZodOptional<z.ZodString>;
|
|
89
|
+
languageKeys: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
90
|
+
languageCode: z.ZodString;
|
|
91
|
+
key: z.ZodNullable<z.ZodString>;
|
|
92
|
+
}, z.core.$strip>>>;
|
|
93
|
+
channelKeys: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
94
|
+
channelId: z.ZodString;
|
|
95
|
+
languageCode: z.ZodString;
|
|
96
|
+
key: z.ZodNullable<z.ZodString>;
|
|
97
|
+
}, z.core.$strip>>>;
|
|
98
|
+
confirmTakeover: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
99
|
+
languageCode: z.ZodNullable<z.ZodString>;
|
|
100
|
+
key: z.ZodString;
|
|
101
|
+
}, z.core.$strip>>>;
|
|
102
|
+
}, z.core.$strip>;
|
|
103
|
+
export type PutProductUrlKeysRequest = z.infer<typeof putProductUrlKeysRequestSchema>;
|
|
104
|
+
/** `409 URL_KEY_TAKEN` details. */
|
|
105
|
+
export declare const urlKeyTakenDetailsSchema: z.ZodObject<{
|
|
106
|
+
conflicts: z.ZodArray<z.ZodObject<{
|
|
107
|
+
languageCode: z.ZodNullable<z.ZodString>;
|
|
108
|
+
key: z.ZodString;
|
|
109
|
+
heldByProductId: z.ZodString;
|
|
110
|
+
heldByProductName: z.ZodString;
|
|
111
|
+
}, z.core.$strip>>;
|
|
112
|
+
}, z.core.$strip>;
|
|
113
|
+
export type UrlKeyTakenDetails = z.infer<typeof urlKeyTakenDetailsSchema>;
|
|
114
|
+
/** `409 URL_KEY_REDIRECT_TAKEOVER_REQUIRED` details. */
|
|
115
|
+
export declare const urlKeyRedirectTakeoverRequiredDetailsSchema: z.ZodObject<{
|
|
116
|
+
takeovers: z.ZodArray<z.ZodObject<{
|
|
117
|
+
languageCode: z.ZodNullable<z.ZodString>;
|
|
118
|
+
key: z.ZodString;
|
|
119
|
+
losingProductId: z.ZodString;
|
|
120
|
+
losingProductName: z.ZodString;
|
|
121
|
+
}, z.core.$strip>>;
|
|
122
|
+
}, z.core.$strip>;
|
|
123
|
+
export type UrlKeyRedirectTakeoverRequiredDetails = z.infer<typeof urlKeyRedirectTakeoverRequiredDetailsSchema>;
|
|
124
|
+
/** `404 URL_REDIRECT_NOT_FOUND` details. */
|
|
125
|
+
export declare const urlRedirectNotFoundDetailsSchema: z.ZodObject<{
|
|
126
|
+
redirectId: z.ZodString;
|
|
127
|
+
}, z.core.$strip>;
|
|
128
|
+
export type UrlRedirectNotFoundDetails = z.infer<typeof urlRedirectNotFoundDetailsSchema>;
|
|
129
|
+
export declare const productKeyResolutionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
130
|
+
kind: z.ZodLiteral<"product">;
|
|
131
|
+
productId: z.ZodString;
|
|
132
|
+
key: z.ZodString;
|
|
133
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
134
|
+
kind: z.ZodLiteral<"redirect">;
|
|
135
|
+
key: z.ZodString;
|
|
136
|
+
languageCode: z.ZodString;
|
|
137
|
+
path: z.ZodString;
|
|
138
|
+
permanent: z.ZodBoolean;
|
|
139
|
+
}, z.core.$strip>], "kind">;
|
|
140
|
+
export type ProductKeyResolution = z.infer<typeof productKeyResolutionSchema>;
|
|
141
|
+
/**
|
|
142
|
+
* The product page's own URLs, ready-made by catalog with {@link productPath}: the
|
|
143
|
+
* canonical for the request's (channel, language), and one alternate per channel
|
|
144
|
+
* language where the product is available to the **anonymous** audience (FR-074 —
|
|
145
|
+
* `hreflang` advertises only what a crawler may open). The storefront renders them
|
|
146
|
+
* verbatim: it composes no product URL of its own.
|
|
147
|
+
*/
|
|
148
|
+
export declare const productPagePathsSchema: z.ZodObject<{
|
|
149
|
+
canonical: z.ZodString;
|
|
150
|
+
alternates: z.ZodArray<z.ZodObject<{
|
|
151
|
+
languageCode: z.ZodString;
|
|
152
|
+
path: z.ZodString;
|
|
153
|
+
}, z.core.$strip>>;
|
|
154
|
+
xDefault: z.ZodString;
|
|
155
|
+
}, z.core.$strip>;
|
|
156
|
+
export type ProductPagePaths = z.infer<typeof productPagePathsSchema>;
|
|
157
|
+
/**
|
|
158
|
+
* Per key written through `catalogProductScopeWritePort.applyScopes`: written, or
|
|
159
|
+
* not written with the reason. A connector never takes over a redirect and is never
|
|
160
|
+
* asked to confirm one; the product keeps its previous key at that scope (FR-093).
|
|
161
|
+
*/
|
|
162
|
+
export declare const urlKeyWriteOutcomeSchema: z.ZodUnion<readonly [z.ZodObject<{
|
|
163
|
+
written: z.ZodLiteral<true>;
|
|
164
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
165
|
+
written: z.ZodLiteral<false>;
|
|
166
|
+
issue: z.ZodObject<{
|
|
167
|
+
languageCode: z.ZodString;
|
|
168
|
+
channelId: z.ZodNullable<z.ZodString>;
|
|
169
|
+
key: z.ZodString;
|
|
170
|
+
heldByProductId: z.ZodString;
|
|
171
|
+
kind: z.ZodEnum<{
|
|
172
|
+
current: "current";
|
|
173
|
+
redirect: "redirect";
|
|
174
|
+
}>;
|
|
175
|
+
}, z.core.$strip>;
|
|
176
|
+
}, z.core.$strip>]>;
|
|
177
|
+
export type UrlKeyWriteOutcome = z.infer<typeof urlKeyWriteOutcomeSchema>;
|
|
178
|
+
/** A URL key written by an integration: `channelId: null` = the language key. */
|
|
179
|
+
export interface ProductUrlKeyWrite {
|
|
180
|
+
languageCode: string;
|
|
181
|
+
channelId: string | null;
|
|
182
|
+
/** `null` = use inherited. */
|
|
183
|
+
key: string | null;
|
|
184
|
+
}
|
|
185
|
+
/**
|
|
186
|
+
* Container name: `catalogProductUrlKeyReadPort`. Owner: `catalog`.
|
|
187
|
+
*
|
|
188
|
+
* URL keys for whole-channel readers such as `seo`'s sitemap generator (R28).
|
|
189
|
+
* `catalog` is non-deactivatable, so the port is always present.
|
|
190
|
+
*/
|
|
191
|
+
export interface CatalogProductUrlKeyReadPort {
|
|
192
|
+
/**
|
|
193
|
+
* The effective key per channel language for each product: the product's
|
|
194
|
+
* channel × language key, else its language key, else its global key. Products the
|
|
195
|
+
* channel does not carry are absent.
|
|
196
|
+
*
|
|
197
|
+
* **Applies no availability beyond membership** (checkpoint C security review, I8):
|
|
198
|
+
* a member product switched off, outside its window or outside its audience still
|
|
199
|
+
* has keys here. A buyer-facing caller narrows the ids with
|
|
200
|
+
* `catalogProductAvailabilityPort.filterAvailable` first and links only what is left.
|
|
201
|
+
*/
|
|
202
|
+
effectiveKeys(productIds: readonly string[], channelId: string): Promise<Map<string, Map<string, string>>>;
|
|
203
|
+
}
|
|
204
|
+
//# sourceMappingURL=product-url-keys.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"product-url-keys.d.ts","sourceRoot":"","sources":["../src/product-url-keys.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,166 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import { isoDateTimeSchema, uuidSchema } from './common.js';
|
|
3
|
+
import { storefrontPagePath } from './storefront-language-path.js';
|
|
4
|
+
/**
|
|
5
|
+
* Feature 163 (`specs/163-product-data-scopes/`) — product URL keys per language and
|
|
6
|
+
* per sales channel × language, their redirects, and the one helper that composes a
|
|
7
|
+
* product URL (`contracts/url-keys-and-redirects.md`, research R11, R12, R17, R28).
|
|
8
|
+
*
|
|
9
|
+
* Kept apart from `product-scopes.ts` so the URL-key work edits its own file. This
|
|
10
|
+
* module is a leaf: it imports nothing from the catalogue contracts.
|
|
11
|
+
*/
|
|
12
|
+
// --- Key grammar ---------------------------------------------------------------
|
|
13
|
+
/**
|
|
14
|
+
* A product URL key: the grammar of `products.slug` (lower-case kebab case, at most
|
|
15
|
+
* 160 characters — the column width). Global, language and channel × language keys
|
|
16
|
+
* all share it.
|
|
17
|
+
*/
|
|
18
|
+
export const productSlugSchema = z
|
|
19
|
+
.string()
|
|
20
|
+
.min(1)
|
|
21
|
+
.max(160)
|
|
22
|
+
.regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/, 'must be kebab-case');
|
|
23
|
+
const languageCodeSchema = z.string().min(1).max(16);
|
|
24
|
+
/**
|
|
25
|
+
* The storefront path of a product page: `/p/<key>` under the language's path prefix
|
|
26
|
+
* (`/en/p/drill`, or `/p/wiertarka` for the default language of a channel that does
|
|
27
|
+
* not prefix it).
|
|
28
|
+
*
|
|
29
|
+
* **This is the only place a product URL is composed.** Every URL the platform
|
|
30
|
+
* emits for a product — the admin's preview link, the resolve answer's redirect
|
|
31
|
+
* target, the PDP's canonical and alternates, the sitemap, the product feeds — is
|
|
32
|
+
* built here by the backend. A key is valid only in its own language (K1), so the
|
|
33
|
+
* language travels with the link as its path prefix
|
|
34
|
+
* (`specs/167-storefront-locale-path/`, which replaced 163's interim `?lang=`).
|
|
35
|
+
*/
|
|
36
|
+
export function productPath(input) {
|
|
37
|
+
return storefrontPagePath({
|
|
38
|
+
path: `/p/${encodeURIComponent(input.key)}`,
|
|
39
|
+
languageCode: input.languageCode,
|
|
40
|
+
channel: input.channel,
|
|
41
|
+
});
|
|
42
|
+
}
|
|
43
|
+
/** The unprefixed product path — the `x-default` target (`specs/167-storefront-locale-path/` url-shape §8). */
|
|
44
|
+
export function productDefaultPath(key) {
|
|
45
|
+
return `/p/${encodeURIComponent(key)}`;
|
|
46
|
+
}
|
|
47
|
+
// --- Admin read — GET /api/v1/admin/catalog/products/:id/url-keys (§1) -----------
|
|
48
|
+
export const productUrlKeySourceSchema = z.enum(['channel_language', 'language', 'global']);
|
|
49
|
+
export const productUrlRedirectSchema = z.object({
|
|
50
|
+
id: uuidSchema,
|
|
51
|
+
/** `null` = a former global key, redirecting in every language (H1). */
|
|
52
|
+
languageCode: languageCodeSchema.nullable(),
|
|
53
|
+
key: z.string(),
|
|
54
|
+
createdAt: isoDateTimeSchema,
|
|
55
|
+
});
|
|
56
|
+
export const productUrlKeysResponseSchema = z.object({
|
|
57
|
+
data: z.object({
|
|
58
|
+
/** `products.slug`. */
|
|
59
|
+
globalKey: z.string(),
|
|
60
|
+
languageKeys: z.array(z.object({ languageCode: languageCodeSchema, key: z.string() })),
|
|
61
|
+
channelKeys: z.array(z.object({ channelId: uuidSchema, languageCode: languageCodeSchema, key: z.string(), orphaned: z.boolean() })),
|
|
62
|
+
effective: z.array(z.object({
|
|
63
|
+
channelId: uuidSchema,
|
|
64
|
+
languageCode: languageCodeSchema,
|
|
65
|
+
key: z.string(),
|
|
66
|
+
source: productUrlKeySourceSchema,
|
|
67
|
+
/** {@link productPath} for this (channel, language). */
|
|
68
|
+
url: z.string(),
|
|
69
|
+
})),
|
|
70
|
+
/** Omitted when `seo` is not effectively present (Q-C, Constitution XVII). */
|
|
71
|
+
redirects: z.array(productUrlRedirectSchema).optional(),
|
|
72
|
+
}),
|
|
73
|
+
});
|
|
74
|
+
// --- Admin write — PUT /api/v1/admin/catalog/products/:id/url-keys (§2) ----------
|
|
75
|
+
/** The most entries one list of a URL-keys PUT carries (Phase 16 review; the scopes PATCH's bound). */
|
|
76
|
+
const URL_KEY_LIST_MAX = 64;
|
|
77
|
+
export const putProductUrlKeysRequestSchema = z.object({
|
|
78
|
+
globalKey: productSlugSchema.optional(),
|
|
79
|
+
/** `key: null` = use inherited (deletes the language key). */
|
|
80
|
+
languageKeys: z
|
|
81
|
+
.array(z.object({ languageCode: languageCodeSchema, key: productSlugSchema.nullable() }))
|
|
82
|
+
.max(URL_KEY_LIST_MAX)
|
|
83
|
+
.optional(),
|
|
84
|
+
/** `key: null` = use inherited (deletes the channel × language key). */
|
|
85
|
+
channelKeys: z
|
|
86
|
+
.array(z.object({ channelId: uuidSchema, languageCode: languageCodeSchema, key: productSlugSchema.nullable() }))
|
|
87
|
+
.max(URL_KEY_LIST_MAX)
|
|
88
|
+
.optional(),
|
|
89
|
+
/** The operator's confirmation of taking over another product's redirect (FR-072). */
|
|
90
|
+
confirmTakeover: z
|
|
91
|
+
.array(z.object({ languageCode: languageCodeSchema.nullable(), key: productSlugSchema }))
|
|
92
|
+
.max(URL_KEY_LIST_MAX)
|
|
93
|
+
.optional(),
|
|
94
|
+
});
|
|
95
|
+
/** `409 URL_KEY_TAKEN` details. */
|
|
96
|
+
export const urlKeyTakenDetailsSchema = z.object({
|
|
97
|
+
conflicts: z.array(z.object({
|
|
98
|
+
languageCode: languageCodeSchema.nullable(),
|
|
99
|
+
key: z.string(),
|
|
100
|
+
heldByProductId: uuidSchema,
|
|
101
|
+
heldByProductName: z.string(),
|
|
102
|
+
})),
|
|
103
|
+
});
|
|
104
|
+
/** `409 URL_KEY_REDIRECT_TAKEOVER_REQUIRED` details. */
|
|
105
|
+
export const urlKeyRedirectTakeoverRequiredDetailsSchema = z.object({
|
|
106
|
+
takeovers: z.array(z.object({
|
|
107
|
+
languageCode: languageCodeSchema.nullable(),
|
|
108
|
+
key: z.string(),
|
|
109
|
+
losingProductId: uuidSchema,
|
|
110
|
+
losingProductName: z.string(),
|
|
111
|
+
})),
|
|
112
|
+
});
|
|
113
|
+
/** `404 URL_REDIRECT_NOT_FOUND` details. */
|
|
114
|
+
export const urlRedirectNotFoundDetailsSchema = z.object({ redirectId: uuidSchema });
|
|
115
|
+
// --- Public resolve — GET /api/v1/catalog/products/resolve/:key (§4) ------------
|
|
116
|
+
export const productKeyResolutionSchema = z.discriminatedUnion('kind', [
|
|
117
|
+
/** `key` is the effective key at (channel, language). */
|
|
118
|
+
z.object({ kind: z.literal('product'), productId: uuidSchema, key: z.string() }),
|
|
119
|
+
/**
|
|
120
|
+
* `path` = {@link productPath} built by catalog. `permanent: true` — a former key (163),
|
|
121
|
+
* answered 308; `false` — a current key of the same product in another channel
|
|
122
|
+
* language (feature 167, FR-024), answered 307 because the mapping depends on key data
|
|
123
|
+
* that can change hands.
|
|
124
|
+
*/
|
|
125
|
+
z.object({
|
|
126
|
+
kind: z.literal('redirect'),
|
|
127
|
+
key: z.string(),
|
|
128
|
+
languageCode: languageCodeSchema,
|
|
129
|
+
path: z.string(),
|
|
130
|
+
permanent: z.boolean(),
|
|
131
|
+
}),
|
|
132
|
+
]);
|
|
133
|
+
// --- Storefront product page — the PDP response's `paths` (§6) -----------------
|
|
134
|
+
/**
|
|
135
|
+
* The product page's own URLs, ready-made by catalog with {@link productPath}: the
|
|
136
|
+
* canonical for the request's (channel, language), and one alternate per channel
|
|
137
|
+
* language where the product is available to the **anonymous** audience (FR-074 —
|
|
138
|
+
* `hreflang` advertises only what a crawler may open). The storefront renders them
|
|
139
|
+
* verbatim: it composes no product URL of its own.
|
|
140
|
+
*/
|
|
141
|
+
export const productPagePathsSchema = z.object({
|
|
142
|
+
canonical: z.string(),
|
|
143
|
+
alternates: z.array(z.object({ languageCode: languageCodeSchema, path: z.string() })),
|
|
144
|
+
/** {@link productDefaultPath} of the key at the channel's default language — `hreflang="x-default"`. */
|
|
145
|
+
xDefault: z.string(),
|
|
146
|
+
});
|
|
147
|
+
// --- Connectors and import (§5) ------------------------------------------------
|
|
148
|
+
/**
|
|
149
|
+
* Per key written through `catalogProductScopeWritePort.applyScopes`: written, or
|
|
150
|
+
* not written with the reason. A connector never takes over a redirect and is never
|
|
151
|
+
* asked to confirm one; the product keeps its previous key at that scope (FR-093).
|
|
152
|
+
*/
|
|
153
|
+
export const urlKeyWriteOutcomeSchema = z.union([
|
|
154
|
+
z.object({ written: z.literal(true) }),
|
|
155
|
+
z.object({
|
|
156
|
+
written: z.literal(false),
|
|
157
|
+
issue: z.object({
|
|
158
|
+
languageCode: languageCodeSchema,
|
|
159
|
+
channelId: uuidSchema.nullable(),
|
|
160
|
+
key: z.string(),
|
|
161
|
+
heldByProductId: uuidSchema,
|
|
162
|
+
kind: z.enum(['current', 'redirect']),
|
|
163
|
+
}),
|
|
164
|
+
}),
|
|
165
|
+
]);
|
|
166
|
+
//# sourceMappingURL=product-url-keys.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"product-url-keys.js","sourceRoot":"","sources":["../src/product-url-keys.ts"],"names":[],"mappings":"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"}
|
|
@@ -53,6 +53,12 @@ export type ResolveAttributeArgs = {
|
|
|
53
53
|
scope: AttributeScope;
|
|
54
54
|
ctx: ResolverContext;
|
|
55
55
|
};
|
|
56
|
+
/**
|
|
57
|
+
* Whether a value counts as present: not `undefined`/`null`, and not an empty
|
|
58
|
+
* string, array or object. Shared with `storefront-value-overrides`, whose
|
|
59
|
+
* walk stops where the baseline holds a value by this same definition.
|
|
60
|
+
*/
|
|
61
|
+
export declare function isNonEmpty(v: unknown): boolean;
|
|
56
62
|
/**
|
|
57
63
|
* Resolve one attribute value for the given context using the four-step
|
|
58
64
|
* fallback chain. The resolver is tolerant of "orphan" override rows
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"product-value-resolver.d.ts","sourceRoot":"","sources":["../src/product-value-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,eAAe,GAAG;IAC5B,4DAA4D;IAC5D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,sCAAsC;IACtC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,uDAAuD;IACvD,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE;QAAE,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,cAAc,GACtB,kBAAkB,GAClB,SAAS,GACT,iBAAiB,GACjB,QAAQ,GACR,QAAQ,CAAC;AAEb,MAAM,MAAM,QAAQ,GAAG;IACrB,yDAAyD;IACzD,KAAK,EAAE,OAAO,CAAC;IACf,qDAAqD;IACrD,MAAM,EAAE,cAAc,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;;;OAKG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB,kDAAkD;IAClD,SAAS,EAAE,SAAS,WAAW,EAAE,CAAC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,cAAc,CAAC;IACtB,GAAG,EAAE,eAAe,CAAC;CACtB,CAAC;
|
|
1
|
+
{"version":3,"file":"product-value-resolver.d.ts","sourceRoot":"","sources":["../src/product-value-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,eAAe,GAAG;IAC5B,4DAA4D;IAC5D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,sCAAsC;IACtC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,uDAAuD;IACvD,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE;QAAE,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,cAAc,GACtB,kBAAkB,GAClB,SAAS,GACT,iBAAiB,GACjB,QAAQ,GACR,QAAQ,CAAC;AAEb,MAAM,MAAM,QAAQ,GAAG;IACrB,yDAAyD;IACzD,KAAK,EAAE,OAAO,CAAC;IACf,qDAAqD;IACrD,MAAM,EAAE,cAAc,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;;;OAKG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB,kDAAkD;IAClD,SAAS,EAAE,SAAS,WAAW,EAAE,CAAC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,cAAc,CAAC;IACtB,GAAG,EAAE,eAAe,CAAC;CACtB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAM9C;AAmBD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,QAAQ,CA+DrE;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,cAAc,CAAC;IACtB;;;;;;OAMG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACzC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,aAAa,EAAE,SAAS,YAAY,EAAE,EACtC,SAAS,EAAE,SAAS,WAAW,EAAE,EACjC,GAAG,EAAE,eAAe,GACnB,gBAAgB,CAelB"}
|
|
@@ -12,7 +12,12 @@
|
|
|
12
12
|
* The matrix below MUST stay aligned with
|
|
13
13
|
* specs/023-product-scope-editor/contracts/resolver.contract.md §5.
|
|
14
14
|
*/
|
|
15
|
-
|
|
15
|
+
/**
|
|
16
|
+
* Whether a value counts as present: not `undefined`/`null`, and not an empty
|
|
17
|
+
* string, array or object. Shared with `storefront-value-overrides`, whose
|
|
18
|
+
* walk stops where the baseline holds a value by this same definition.
|
|
19
|
+
*/
|
|
20
|
+
export function isNonEmpty(v) {
|
|
16
21
|
if (v === undefined || v === null)
|
|
17
22
|
return false;
|
|
18
23
|
if (typeof v === 'string')
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"product-value-resolver.js","sourceRoot":"","sources":["../src/product-value-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAoDH,
|
|
1
|
+
{"version":3,"file":"product-value-resolver.js","sourceRoot":"","sources":["../src/product-value-resolver.ts"],"names":[],"mappings":"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"}
|