@contentstack/studio-client 1.4.0 → 1.5.1

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.
Files changed (97) hide show
  1. package/dist/breakpoints/BreakpointManager.js +17 -5
  2. package/dist/breakpoints/BreakpointManager.js.map +1 -1
  3. package/dist/canvas/canvas.utils.js +1 -1
  4. package/dist/canvas/canvas.utils.js.map +1 -1
  5. package/dist/composable-studio/build-scoped-data.js +101 -0
  6. package/dist/composable-studio/build-scoped-data.js.map +1 -0
  7. package/dist/composable-studio/collect-data-needs.js +226 -0
  8. package/dist/composable-studio/collect-data-needs.js.map +1 -0
  9. package/dist/composable-studio/composition-placement.types.js +7 -0
  10. package/dist/composable-studio/composition-placement.types.js.map +1 -0
  11. package/dist/composable-studio/initializer-sdk.js +1 -9
  12. package/dist/composable-studio/initializer-sdk.js.map +1 -1
  13. package/dist/composable-studio/sdk.js +1551 -195
  14. package/dist/composable-studio/sdk.js.map +1 -1
  15. package/dist/composable-studio/studio-intelligence.manager.js +124 -0
  16. package/dist/composable-studio/studio-intelligence.manager.js.map +1 -0
  17. package/dist/config/config.schema.js +10 -0
  18. package/dist/config/config.schema.js.map +1 -1
  19. package/dist/config/default-config.js +1 -0
  20. package/dist/config/default-config.js.map +1 -1
  21. package/dist/config/process-user-config.js +6 -0
  22. package/dist/config/process-user-config.js.map +1 -1
  23. package/dist/config/stack-sdk-wrapper.js +87 -2
  24. package/dist/config/stack-sdk-wrapper.js.map +1 -1
  25. package/dist/design/handle-active-style-change.js +0 -3
  26. package/dist/design/handle-active-style-change.js.map +1 -1
  27. package/dist/dnd/dnd-manager.js +25 -7
  28. package/dist/dnd/dnd-manager.js.map +1 -1
  29. package/dist/dnd/{utils.js → scroll-utils.js} +2 -27
  30. package/dist/dnd/scroll-utils.js.map +1 -0
  31. package/dist/hidden-element-notification/hidden-element-notification-event.js +7 -0
  32. package/dist/hidden-element-notification/hidden-element-notification-event.js.map +1 -1
  33. package/dist/highlight-node/highlight-node-manager.js +7 -1
  34. package/dist/highlight-node/highlight-node-manager.js.map +1 -1
  35. package/dist/highlight-node/highlight-node.js +38 -18
  36. package/dist/highlight-node/highlight-node.js.map +1 -1
  37. package/dist/index.d.ts +618 -31
  38. package/dist/index.js +16 -5
  39. package/dist/index.js.map +1 -1
  40. package/dist/node_modules/fflate/esm/browser.js +384 -0
  41. package/dist/node_modules/fflate/esm/browser.js.map +1 -0
  42. package/dist/packages/studio-internal/dist/utils/spec-compression.js +43 -0
  43. package/dist/packages/studio-internal/dist/utils/spec-compression.js.map +1 -0
  44. package/dist/query/expression-resolver.js +124 -0
  45. package/dist/query/expression-resolver.js.map +1 -0
  46. package/dist/query/query-executor.js +482 -0
  47. package/dist/query/query-executor.js.map +1 -0
  48. package/dist/shared/dnd-events.js +39 -0
  49. package/dist/shared/dnd-events.js.map +1 -0
  50. package/dist/url-change/url-change.js +65 -0
  51. package/dist/url-change/url-change.js.map +1 -0
  52. package/dist/url-metadata/build-template-query.js +124 -0
  53. package/dist/url-metadata/build-template-query.js.map +1 -0
  54. package/dist/url-metadata/parse-url-metadata.js +75 -0
  55. package/dist/url-metadata/parse-url-metadata.js.map +1 -0
  56. package/dist/url-metadata/rank-url-matches.js +100 -0
  57. package/dist/url-metadata/rank-url-matches.js.map +1 -0
  58. package/dist/url-metadata/select-url-winner.js +45 -0
  59. package/dist/url-metadata/select-url-winner.js.map +1 -0
  60. package/dist/url-metadata/shouldUseUrlMetadataPath.js +22 -0
  61. package/dist/url-metadata/shouldUseUrlMetadataPath.js.map +1 -0
  62. package/dist/url-metadata/types.js +50 -0
  63. package/dist/url-metadata/types.js.map +1 -0
  64. package/dist/url-metadata/url-pattern-matcher.js +311 -0
  65. package/dist/url-metadata/url-pattern-matcher.js.map +1 -0
  66. package/dist/utils/build-composition-fetch-query.js +19 -0
  67. package/dist/utils/build-composition-fetch-query.js.map +1 -0
  68. package/dist/utils/composable-studio-error.js +1 -0
  69. package/dist/utils/composable-studio-error.js.map +1 -1
  70. package/dist/utils/conditionBlock.js +17 -5
  71. package/dist/utils/conditionBlock.js.map +1 -1
  72. package/dist/utils/constants.js +22 -2
  73. package/dist/utils/constants.js.map +1 -1
  74. package/dist/utils/convertCompositionQueryInputToCompositionQuery.js +11 -1
  75. package/dist/utils/convertCompositionQueryInputToCompositionQuery.js.map +1 -1
  76. package/dist/utils/editor-utils.js +9 -0
  77. package/dist/utils/editor-utils.js.map +1 -1
  78. package/dist/utils/error-messages.default.js +1 -1
  79. package/dist/utils/error-messages.default.js.map +1 -1
  80. package/dist/utils/http-error.constants.js +11 -2
  81. package/dist/utils/http-error.constants.js.map +1 -1
  82. package/dist/utils/is-inside-iframe.js +16 -0
  83. package/dist/utils/is-inside-iframe.js.map +1 -0
  84. package/dist/utils/query-param.js +1 -1
  85. package/dist/utils/query-param.js.map +1 -1
  86. package/dist/utils/reference_fetcher.js +125 -14
  87. package/dist/utils/reference_fetcher.js.map +1 -1
  88. package/dist/utils/sdk.js +6 -1
  89. package/dist/utils/sdk.js.map +1 -1
  90. package/dist/utils/spec-analyzer.js +112 -0
  91. package/dist/utils/spec-analyzer.js.map +1 -0
  92. package/package.json +11 -10
  93. package/dist/dnd/utils.js.map +0 -1
  94. package/dist/get-composition-from-slug/get-composition-from-slug.js +0 -59
  95. package/dist/get-composition-from-slug/get-composition-from-slug.js.map +0 -1
  96. package/dist/utils/get-url-patterns.js +0 -40
  97. package/dist/utils/get-url-patterns.js.map +0 -1
@@ -0,0 +1,124 @@
1
+ import { COMPOSITION_PREVIEW_URL_SOURCES } from './types.js';
2
+
3
+ /** Non-empty predicate for scalar entry fields. */
4
+ const NON_EMPTY = {
5
+ $nin: ["", null],
6
+ };
7
+ /** Existence predicate for taxonomy variables (entry has at least one term). */
8
+ const TAXONOMY_EXISTS = { $exists: true };
9
+ /**
10
+ * Build the plain JSON query object for a composition's URL metadata.
11
+ *
12
+ * Shared between the SDK (production composition resolution) and the Studio
13
+ * UI (iframe-URL preview-entry fetch). The SDK passes the returned object (possibly
14
+ * wrapped in an `$or` by `buildTemplateQuery`) to `ctQuery({ query })`; the UI
15
+ * stringifies it and passes it to `api.cma.entry.getAll` via the `query` param.
16
+ *
17
+ * In `existence` mode for `legacy_url` and `content_type_url_pattern` the
18
+ * object is `{ url: { $nin: ["", null] } }` regardless of `extractedVariables`.
19
+ */
20
+ function buildUrlMetadataQueryObject(context, mode = "match") {
21
+ const { url_source, compositionQuery, extractedVariables } = context;
22
+ const query = {};
23
+ if (url_source === COMPOSITION_PREVIEW_URL_SOURCES.CONTENT_TYPE_URL_PATTERN ||
24
+ url_source === COMPOSITION_PREVIEW_URL_SOURCES.LEGACY_URL) {
25
+ if (mode === "existence") {
26
+ query.url = { ...NON_EMPTY };
27
+ }
28
+ else if (compositionQuery.url) {
29
+ query.url = compositionQuery.url;
30
+ }
31
+ return query;
32
+ }
33
+ // Pattern-based sources: emit one predicate per entry-field / taxonomy.
34
+ for (const [fieldName, fieldValue] of Object.entries(extractedVariables.fields)) {
35
+ if (isReferenceFieldValue(fieldValue)) {
36
+ query[fieldName] = {
37
+ $in_query: buildReferencePredicate(fieldValue, mode),
38
+ };
39
+ }
40
+ else {
41
+ query[fieldName] = mode === "existence" ? { ...NON_EMPTY } : fieldValue;
42
+ }
43
+ }
44
+ for (const taxonomyUid of Object.keys(extractedVariables.taxonomies)) {
45
+ const field = `taxonomies.${taxonomyUid}`;
46
+ query[field] =
47
+ mode === "existence"
48
+ ? { ...TAXONOMY_EXISTS }
49
+ : extractedVariables.taxonomies[taxonomyUid];
50
+ }
51
+ return query;
52
+ }
53
+ function isReferenceFieldValue(value) {
54
+ return typeof value === "object" && value !== null;
55
+ }
56
+ function buildReferencePredicate(ref, mode) {
57
+ const predicate = {};
58
+ for (const [field, value] of Object.entries(ref)) {
59
+ predicate[field] = mode === "existence" ? { ...NON_EMPTY } : value;
60
+ }
61
+ return predicate;
62
+ }
63
+ /**
64
+ * Build the full template-entry query as a single raw query object and hand it
65
+ * to `ctQuery({ query })`.
66
+ *
67
+ * Unlike the old per-field `where()` chaining, this builds one object so it can
68
+ * express a top-level `$or` and embed `taxonomies.<uid>` directly (the dedicated
69
+ * `applyTaxonomyFilters`/`Taxonomies()` path cannot compose inside an `$or`).
70
+ *
71
+ * For `{{entry.url}}` in a pattern-based source (match mode), the query becomes
72
+ * `{ $or: [ <per-field decomposition>, { url: <full request path> } ] }` so the
73
+ * `url` field matches the whole request path as well as the captured segment —
74
+ * the prefix-duplication / bare-`/{{entry.url}}` case. Other sources and modes
75
+ * pass the per-field object unchanged.
76
+ */
77
+ function buildTemplateQuery(stackSdk, context, queryOptions, mode = "match") {
78
+ const { parsedUrlQueries, connectedContentType, extractedVariables, url_source, } = context;
79
+ const queryObject = buildUrlMetadataQueryObject(context, mode);
80
+ // Full-path `$or` branch for `{{entry.url}}` (entry.url-only for now). The
81
+ // `url` field holds the full path, so we match it against the whole request
82
+ // path as well as the captured fragment. See COMS-1487 (decisions doc §4.5)
83
+ // for why `entry.url` is treated specially.
84
+ const isPatternSource = url_source !== COMPOSITION_PREVIEW_URL_SOURCES.CONTENT_TYPE_URL_PATTERN &&
85
+ url_source !== COMPOSITION_PREVIEW_URL_SOURCES.LEGACY_URL;
86
+ const hasEntryUrl = typeof extractedVariables.fields.url === "string" ||
87
+ typeof extractedVariables.fields.url === "number";
88
+ const finalQuery = mode === "match" &&
89
+ isPatternSource &&
90
+ hasEntryUrl &&
91
+ extractedVariables.requestPath
92
+ ? { $or: [queryObject, { url: extractedVariables.requestPath }] }
93
+ : queryObject;
94
+ return stackSdk
95
+ .ctQuery(connectedContentType, {
96
+ references: [
97
+ ...queryOptions.references,
98
+ ...parsedUrlQueries.include,
99
+ ].filter((v, i, arr) => arr.indexOf(v) === i),
100
+ only: queryOptions.only,
101
+ variantAlias: queryOptions.variantAlias,
102
+ locale: queryOptions.locale,
103
+ branch: queryOptions.branch,
104
+ environment: queryOptions.environment,
105
+ query: finalQuery,
106
+ })
107
+ .limit(1);
108
+ }
109
+ /**
110
+ * Resolve template entry based on url_source type and query context
111
+ */
112
+ function resolveByUrlSource(stackSdk, url_source, compositionQuery, extractedVariables, parsedUrlQueries, connectedContentType, queryOptions) {
113
+ const context = {
114
+ compositionQuery,
115
+ extractedVariables,
116
+ parsedUrlQueries,
117
+ connectedContentType,
118
+ url_source: url_source,
119
+ };
120
+ return buildTemplateQuery(stackSdk, context, queryOptions);
121
+ }
122
+
123
+ export { buildTemplateQuery, buildUrlMetadataQueryObject, resolveByUrlSource };
124
+ //# sourceMappingURL=build-template-query.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"build-template-query.js","sources":["../../src/url-metadata/build-template-query.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
@@ -0,0 +1,75 @@
1
+ import { COMPOSITION_PREVIEW_URL_SOURCES, COMPOSITION_PREVIEW_URL_SOURCES_VALUES } from './types.js';
2
+
3
+ /**
4
+ * Parse and validate url_metadata field from a composition entry
5
+ * Returns parsed metadata or legacy object if metadata is missing, malformed, or legacy
6
+ */
7
+ function parseUrlMetadata(url_metadata) {
8
+ const legacyMetadata = {
9
+ url_source: COMPOSITION_PREVIEW_URL_SOURCES.LEGACY_URL,
10
+ url_queries: {
11
+ include: [],
12
+ only: {},
13
+ where: {},
14
+ },
15
+ };
16
+ if (!url_metadata || !url_metadata.url_source) {
17
+ // Default to legacy behavior when no metadata provided
18
+ return legacyMetadata;
19
+ }
20
+ // Legacy or unknown url_source — return consistent legacy object
21
+ if (url_metadata.url_source === COMPOSITION_PREVIEW_URL_SOURCES.LEGACY_URL ||
22
+ !COMPOSITION_PREVIEW_URL_SOURCES_VALUES.includes(url_metadata.url_source)) {
23
+ return legacyMetadata;
24
+ }
25
+ let parsedQueries;
26
+ try {
27
+ if (typeof url_metadata.url_queries === "string") {
28
+ parsedQueries = JSON.parse(url_metadata.url_queries);
29
+ }
30
+ else if (url_metadata.url_queries) {
31
+ parsedQueries = url_metadata.url_queries;
32
+ }
33
+ else {
34
+ // Default empty structure if no url_queries
35
+ parsedQueries = {
36
+ include: [],
37
+ only: {},
38
+ where: {},
39
+ };
40
+ }
41
+ }
42
+ catch {
43
+ // Invalid JSON in url_queries - fall back to legacy
44
+ return legacyMetadata;
45
+ }
46
+ // Validate parsed queries structure
47
+ if (typeof parsedQueries !== "object" || parsedQueries === null) {
48
+ return legacyMetadata;
49
+ }
50
+ // Ensure required fields exist with defaults
51
+ const safeQueries = {
52
+ include: Array.isArray(parsedQueries.include) ? parsedQueries.include : [],
53
+ only: typeof parsedQueries.only === "object" && parsedQueries.only !== null
54
+ ? parsedQueries.only
55
+ : {},
56
+ where: typeof parsedQueries.where === "object" && parsedQueries.where !== null
57
+ ? parsedQueries.where
58
+ : {},
59
+ };
60
+ return {
61
+ url_source: url_metadata.url_source,
62
+ url_queries: safeQueries,
63
+ };
64
+ }
65
+ /**
66
+ * Check if a composition entry has taxonomy extraction enabled
67
+ * Returns true if only.BASE includes "taxonomies"
68
+ */
69
+ function shouldExtractTaxonomies(parsedMetadata) {
70
+ const baseFields = parsedMetadata.url_queries.only?.BASE;
71
+ return Array.isArray(baseFields) && baseFields.includes("taxonomies");
72
+ }
73
+
74
+ export { parseUrlMetadata, shouldExtractTaxonomies };
75
+ //# sourceMappingURL=parse-url-metadata.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"parse-url-metadata.js","sources":["../../src/url-metadata/parse-url-metadata.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAOA;;;AAGG;AACG,SAAU,gBAAgB,CAC9B,YAAwD,EAAA;AAExD,IAAA,MAAM,cAAc,GAAG;QACrB,UAAU,EAAE,+BAA+B,CAAC,UAAU;AACtD,QAAA,WAAW,EAAE;AACX,YAAA,OAAO,EAAE,EAAE;AACX,YAAA,IAAI,EAAE,EAAE;AACR,YAAA,KAAK,EAAE,EAAE;AACV,SAAA;KACF;IACD,IAAI,CAAC,YAAY,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE;;AAE7C,QAAA,OAAO,cAAc;IACvB;;AAGA,IAAA,IACE,YAAY,CAAC,UAAU,KAAK,+BAA+B,CAAC,UAAU;QACtE,CAAC,sCAAsC,CAAC,QAAQ,CAAC,YAAY,CAAC,UAAU,CAAC,EACzE;AACA,QAAA,OAAO,cAAc;IACvB;AAEA,IAAA,IAAI,aAAa;AACjB,IAAA,IAAI;AACF,QAAA,IAAI,OAAO,YAAY,CAAC,WAAW,KAAK,QAAQ,EAAE;YAChD,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,CAAC;QACtD;AAAO,aAAA,IAAI,YAAY,CAAC,WAAW,EAAE;AACnC,YAAA,aAAa,GAAG,YAAY,CAAC,WAAW;QAC1C;aAAO;;AAEL,YAAA,aAAa,GAAG;AACd,gBAAA,OAAO,EAAE,EAAE;AACX,gBAAA,IAAI,EAAE,EAAE;AACR,gBAAA,KAAK,EAAE,EAAE;aACV;QACH;IACF;AAAE,IAAA,MAAM;;AAEN,QAAA,OAAO,cAAc;IACvB;;IAGA,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,aAAa,KAAK,IAAI,EAAE;AAC/D,QAAA,OAAO,cAAc;IACvB;;AAGA,IAAA,MAAM,WAAW,GAAG;AAClB,QAAA,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,aAAa,CAAC,OAAO,GAAG,EAAE;AAC1E,QAAA,IAAI,EACF,OAAO,aAAa,CAAC,IAAI,KAAK,QAAQ,IAAI,aAAa,CAAC,IAAI,KAAK;cAC7D,aAAa,CAAC;AAChB,cAAE,EAAE;AACR,QAAA,KAAK,EACH,OAAO,aAAa,CAAC,KAAK,KAAK,QAAQ,IAAI,aAAa,CAAC,KAAK,KAAK;cAC/D,aAAa,CAAC;AAChB,cAAE,EAAE;KACT;IAED,OAAO;QACL,UAAU,EAAE,YAAY,CAAC,UAAU;AACnC,QAAA,WAAW,EAAE,WAAW;KACzB;AACH;AAEA;;;AAGG;AACG,SAAU,uBAAuB,CACrC,cAAsC,EAAA;IAEtC,MAAM,UAAU,GAAG,cAAc,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI;AACxD,IAAA,OAAO,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC;AACvE;;;;"}
@@ -0,0 +1,100 @@
1
+ import { matchCompositionUrl } from './url-pattern-matcher.js';
2
+
3
+ /**
4
+ * Rank URL matches across multiple composition entries
5
+ * Returns all composable_uid strings tied at the highest specificity score
6
+ *
7
+ * @param requestUrl The incoming URL to match against
8
+ * @param lightweightEntries Composition entries with url and composable_uid
9
+ * @returns Ranking result with all entries at max specificity tier
10
+ */
11
+ function rankUrlMatches(requestUrl, lightweightEntries) {
12
+ if (!lightweightEntries.length) {
13
+ return {
14
+ composableUids: [],
15
+ freeformComposableUids: [],
16
+ templatedComposableUids: [],
17
+ specificity: 0,
18
+ matches: [],
19
+ allMatches: [],
20
+ };
21
+ }
22
+ // Match each entry and collect results
23
+ const matches = [];
24
+ // Every successful match across all specificity tiers — for diagnostics.
25
+ const allMatches = [];
26
+ let maxSpecificity = -1;
27
+ for (const entry of lightweightEntries) {
28
+ if (!entry.url) {
29
+ continue; // Skip entries without URL patterns
30
+ }
31
+ const matchResult = matchCompositionUrl(requestUrl, entry.url, entry.composable_uid, {
32
+ connected_content_type: entry.connected_content_type,
33
+ });
34
+ if (matchResult.matched && matchResult.variables) {
35
+ // Additional validation: if composition_uid is in the URL pattern, it must match the entry's composable_uid
36
+ const extractedCompositionUid = matchResult.variables.metadata.composition_uid;
37
+ if (extractedCompositionUid &&
38
+ extractedCompositionUid !== entry.composable_uid) {
39
+ continue; // Skip this match as composition_uid doesn't match
40
+ }
41
+ // If content_type_uid is in the URL pattern, the composition's linked
42
+ // content type must match. Freeform compositions (no connected_content_type)
43
+ // are naturally excluded — this is intentional, content_type_uid is a
44
+ // linked-composition concept.
45
+ const extractedContentTypeUid = matchResult.variables.metadata.content_type_uid;
46
+ if (extractedContentTypeUid &&
47
+ extractedContentTypeUid !== entry.connected_content_type) {
48
+ continue;
49
+ }
50
+ const specificity = matchResult.variables.literalCharCount;
51
+ matches.push(matchResult);
52
+ allMatches.push({
53
+ composable_uid: entry.composable_uid,
54
+ url: entry.url,
55
+ specificity,
56
+ connected_content_type: entry.connected_content_type,
57
+ });
58
+ if (specificity > maxSpecificity) {
59
+ maxSpecificity = specificity;
60
+ }
61
+ }
62
+ }
63
+ // No matches found
64
+ if (maxSpecificity === -1) {
65
+ return {
66
+ composableUids: [],
67
+ freeformComposableUids: [],
68
+ templatedComposableUids: [],
69
+ specificity: 0,
70
+ matches: [],
71
+ allMatches: [],
72
+ };
73
+ }
74
+ // Collect all entries tied at the maximum specificity
75
+ const topTierMatches = matches.filter((match) => match.matched &&
76
+ match.variables &&
77
+ match.variables.literalCharCount === maxSpecificity);
78
+ // Separate freeform and templated matches
79
+ const freeformMatches = topTierMatches.filter((match) => !match.connected_content_type);
80
+ const templatedMatches = topTierMatches.filter((match) => !!match.connected_content_type);
81
+ // Extract UIDs for each category
82
+ const freeformComposableUids = freeformMatches.map((match) => match.composable_uid);
83
+ const templatedComposableUids = templatedMatches.map((match) => match.composable_uid);
84
+ // For backward compatibility, combine both (freeform first for priority)
85
+ const composableUids = [
86
+ ...freeformComposableUids,
87
+ ...templatedComposableUids,
88
+ ];
89
+ return {
90
+ composableUids,
91
+ freeformComposableUids,
92
+ templatedComposableUids,
93
+ specificity: maxSpecificity,
94
+ matches: topTierMatches,
95
+ allMatches,
96
+ };
97
+ }
98
+
99
+ export { rankUrlMatches };
100
+ //# sourceMappingURL=rank-url-matches.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rank-url-matches.js","sources":["../../src/url-metadata/rank-url-matches.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
@@ -0,0 +1,45 @@
1
+ /**
2
+ * Pick the winning composition among the top-tier (equally-specific) candidates,
3
+ * given the entry-existence probe results.
4
+ *
5
+ * Rules:
6
+ * - 0 candidates → no winner.
7
+ * - 1 candidate → it wins, marked `not-checked` (the happy path never probes).
8
+ * - >1 candidates → a freeform candidate (no content type) is unconditionally
9
+ * valid; a linked candidate is valid only if its content type owns a matching
10
+ * entry (`ownsByUid`). The first valid candidate in the given order wins. If
11
+ * none are valid, there is no winner (→ caller surfaces a not-found error).
12
+ *
13
+ * `ownershipByUid` records the per-candidate outcome for Studio diagnostics.
14
+ *
15
+ * The result is deterministic given the candidate order; a residual multi-owner
16
+ * tie is a content mistake (two entries at one URL) reported via diagnostics, not
17
+ * an error — we still return the first valid one.
18
+ */
19
+ function selectUrlWinner(topTier, ownsByUid) {
20
+ const ownershipByUid = new Map();
21
+ // Happy path — a single (or no) top-tier candidate needs no probe.
22
+ if (topTier.length <= 1) {
23
+ if (topTier[0]) {
24
+ ownershipByUid.set(topTier[0].composable_uid, "not-checked");
25
+ }
26
+ return { winnerUid: topTier[0]?.composable_uid, ownershipByUid };
27
+ }
28
+ let winnerUid;
29
+ for (const candidate of topTier) {
30
+ const isFreeform = !candidate.connected_content_type;
31
+ const result = isFreeform
32
+ ? "not-checked"
33
+ : ownsByUid.get(candidate.composable_uid)
34
+ ? "found"
35
+ : "absent";
36
+ ownershipByUid.set(candidate.composable_uid, result);
37
+ if (!winnerUid && (isFreeform || result === "found")) {
38
+ winnerUid = candidate.composable_uid;
39
+ }
40
+ }
41
+ return { winnerUid, ownershipByUid };
42
+ }
43
+
44
+ export { selectUrlWinner };
45
+ //# sourceMappingURL=select-url-winner.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"select-url-winner.js","sources":["../../src/url-metadata/select-url-winner.ts"],"sourcesContent":[null],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;;AAiBG;AACG,SAAU,eAAe,CAC7B,OAA0B,EAC1B,SAA+B,EAAA;AAK/B,IAAA,MAAM,cAAc,GAAG,IAAI,GAAG,EAAgC;;AAG9D,IAAA,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE;AACvB,QAAA,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE;AACd,YAAA,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,cAAc,EAAE,aAAa,CAAC;QAC9D;AACA,QAAA,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,cAAc,EAAE;IAClE;AAEA,IAAA,IAAI,SAA6B;AACjC,IAAA,KAAK,MAAM,SAAS,IAAI,OAAO,EAAE;AAC/B,QAAA,MAAM,UAAU,GAAG,CAAC,SAAS,CAAC,sBAAsB;QACpD,MAAM,MAAM,GAAyB;AACnC,cAAE;cACA,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,cAAc;AACtC,kBAAE;kBACA,QAAQ;QACd,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,MAAM,CAAC;QACpD,IAAI,CAAC,SAAS,KAAK,UAAU,IAAI,MAAM,KAAK,OAAO,CAAC,EAAE;AACpD,YAAA,SAAS,GAAG,SAAS,CAAC,cAAc;QACtC;IACF;AAEA,IAAA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE;AACtC;;;;"}
@@ -0,0 +1,22 @@
1
+ import { parseUrlMetadata } from './parse-url-metadata.js';
2
+ import { COMPOSITION_PREVIEW_URL_SOURCES } from './types.js';
3
+
4
+ /**
5
+ * Determine if the metadata-driven path should be used
6
+ * It means whether we want to fallback to the wildcard routes
7
+ * or parse the URL for variables and determine the composition
8
+ * Returns false if metadata is missing, invalid JSON, or url_source is legacy_url
9
+ *
10
+ * @param url_metadata Raw url_metadata from composition entry
11
+ * @returns true if metadata path should be used, false for legacy path
12
+ */
13
+ function shouldUseUrlMetadataPath(url_metadata) {
14
+ if (!url_metadata) {
15
+ return false;
16
+ }
17
+ const parsed = parseUrlMetadata(url_metadata);
18
+ return parsed.url_source !== COMPOSITION_PREVIEW_URL_SOURCES.LEGACY_URL;
19
+ }
20
+
21
+ export { shouldUseUrlMetadataPath };
22
+ //# sourceMappingURL=shouldUseUrlMetadataPath.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"shouldUseUrlMetadataPath.js","sources":["../../src/url-metadata/shouldUseUrlMetadataPath.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAIA;;;;;;;;AAQG;AACG,SAAU,wBAAwB,CACtC,YAAwD,EAAA;IAExD,IAAI,CAAC,YAAY,EAAE;AACjB,QAAA,OAAO,KAAK;IACd;AAEA,IAAA,MAAM,MAAM,GAAG,gBAAgB,CAAC,YAAY,CAAC;AAC7C,IAAA,OAAO,MAAM,CAAC,UAAU,KAAK,+BAA+B,CAAC,UAAU;AACzE;;;;"}
@@ -0,0 +1,50 @@
1
+ /**
2
+ * Composition preview URL source types for CMS field `url_metadata.url_source`
3
+ *
4
+ * These constants define how the composition's preview URL is derived:
5
+ * - From custom preview URLs
6
+ * - From content type URL patterns
7
+ * - From default URL patterns
8
+ * - From user-specified patterns
9
+ * - From legacy URL configuration
10
+ */
11
+ const COMPOSITION_PREVIEW_URL_SOURCES = {
12
+ CUSTOM_PREVIEW_URL: "custom_preview_url",
13
+ CONTENT_TYPE_URL_PATTERN: "content_type_url_pattern",
14
+ DEFAULT_URL_PATTERN: "default_url_pattern",
15
+ USER_SPECIFIED_PATTERN: "user_specified_pattern",
16
+ LEGACY_URL: "legacy_url",
17
+ };
18
+ const COMPOSITION_PREVIEW_URL_SOURCES_VALUES = Object.values(COMPOSITION_PREVIEW_URL_SOURCES);
19
+ // Default URL source configuration
20
+ const DEFAULT_COMPOSITION_PREVIEW_URL_SOURCE = COMPOSITION_PREVIEW_URL_SOURCES.LEGACY_URL;
21
+ // Constants to avoid magic strings and typos for URL pattern variable types
22
+ const URL_PATTERN_VARIABLE_TYPES = {
23
+ ENTRY: "entry",
24
+ TAXONOMY: "taxonomy",
25
+ METADATA: "metadata", // Changed from 'system' to 'metadata'
26
+ DATE: "date",
27
+ // Anonymous `*` glob (legacy linked patterns). Matches exactly one path
28
+ // segment, captures a group for regex alignment, but carries no value and is
29
+ // skipped during variable extraction and query building.
30
+ WILDCARD: "wildcard",
31
+ };
32
+ const URL_PATTERN_METADATA_FIELDS = {
33
+ COMPOSITION_UID: "composition_uid",
34
+ CONTENT_TYPE_UID: "content_type_uid",
35
+ ENVIRONMENT: "environment",
36
+ LOCALE: "locale",
37
+ BRANCH: "branch",
38
+ };
39
+ const URL_PATTERN_METADATA_FIELDS_VALUES = Object.values(URL_PATTERN_METADATA_FIELDS);
40
+ const URL_PATTERN_DATE_VARIABLES = {
41
+ YEAR: "entry_created_date:year",
42
+ YEAR_SHORT: "entry_created_date:year_short",
43
+ MONTH: "entry_created_date:month",
44
+ MONTH_NAME: "entry_created_date:monthname",
45
+ MONTH_NAME_SHORT: "entry_created_date:monthname_short",
46
+ DAY: "entry_created_date:day",
47
+ };
48
+
49
+ export { COMPOSITION_PREVIEW_URL_SOURCES, COMPOSITION_PREVIEW_URL_SOURCES_VALUES, DEFAULT_COMPOSITION_PREVIEW_URL_SOURCE, URL_PATTERN_DATE_VARIABLES, URL_PATTERN_METADATA_FIELDS, URL_PATTERN_METADATA_FIELDS_VALUES, URL_PATTERN_VARIABLE_TYPES };
50
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sources":["../../src/url-metadata/types.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;;;;;AASG;AAEI,MAAM,+BAA+B,GAAG;AAC7C,IAAA,kBAAkB,EAAE,oBAAoB;AACxC,IAAA,wBAAwB,EAAE,0BAA0B;AACpD,IAAA,mBAAmB,EAAE,qBAAqB;AAC1C,IAAA,sBAAsB,EAAE,wBAAwB;AAChD,IAAA,UAAU,EAAE,YAAY;;AAGnB,MAAM,sCAAsC,GAAG,MAAM,CAAC,MAAM,CACjE,+BAA+B;AAQjC;AACO,MAAM,sCAAsC,GACjD,+BAA+B,CAAC;AA4BlC;AACO,MAAM,0BAA0B,GAAG;AACxC,IAAA,KAAK,EAAE,OAAO;AACd,IAAA,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;AACpB,IAAA,IAAI,EAAE,MAAM;;;;AAIZ,IAAA,QAAQ,EAAE,UAAU;;AAGf,MAAM,2BAA2B,GAAG;AACzC,IAAA,eAAe,EAAE,iBAAiB;AAClC,IAAA,gBAAgB,EAAE,kBAAkB;AACpC,IAAA,WAAW,EAAE,aAAa;AAC1B,IAAA,MAAM,EAAE,QAAQ;AAChB,IAAA,MAAM,EAAE,QAAQ;;AAGX,MAAM,kCAAkC,GAAG,MAAM,CAAC,MAAM,CAC7D,2BAA2B;AAQtB,MAAM,0BAA0B,GAAG;AACxC,IAAA,IAAI,EAAE,yBAAyB;AAC/B,IAAA,UAAU,EAAE,+BAA+B;AAC3C,IAAA,KAAK,EAAE,0BAA0B;AACjC,IAAA,UAAU,EAAE,8BAA8B;AAC1C,IAAA,gBAAgB,EAAE,oCAAoC;AACtD,IAAA,GAAG,EAAE,wBAAwB;;;;;"}