@decocms/blocks 8.1.0-next.0 → 8.1.0-next.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 (114) hide show
  1. package/package.json +6 -92
  2. package/src/index.ts +2 -12
  3. package/src/protocol/storage/memory.ts +1 -1
  4. package/src/v8/background.ts +3 -3
  5. package/src/v8/builtins/legacy.ts +1 -1
  6. package/src/v8/cli/index.ts +1 -1
  7. package/src/v8/fetch.ts +8 -27
  8. package/src/v8/remoteLoader.ts +1 -1
  9. package/src/v8/telemetry.ts +1 -1
  10. package/src/cms/applySectionConventions.ts +0 -148
  11. package/src/cms/blockSource.ts +0 -228
  12. package/src/cms/client.ts +0 -85
  13. package/src/cms/deferredTrigger.ts +0 -58
  14. package/src/cms/draftSource.ts +0 -476
  15. package/src/cms/index.ts +0 -180
  16. package/src/cms/loadDecofileDirectory.ts +0 -89
  17. package/src/cms/loader.ts +0 -563
  18. package/src/cms/registry.ts +0 -264
  19. package/src/cms/renderJson.ts +0 -179
  20. package/src/cms/resolve.ts +0 -2583
  21. package/src/cms/schema.ts +0 -1219
  22. package/src/cms/sectionLoaderContext.ts +0 -113
  23. package/src/cms/sectionLoaders.ts +0 -686
  24. package/src/cms/sectionMixins.ts +0 -153
  25. package/src/flags/audience.ts +0 -56
  26. package/src/flags/everyone.ts +0 -29
  27. package/src/flags/flag.ts +0 -15
  28. package/src/flags/multivariate/image.ts +0 -11
  29. package/src/flags/multivariate/message.ts +0 -11
  30. package/src/flags/multivariate/page.ts +0 -16
  31. package/src/flags/multivariate/section.ts +0 -16
  32. package/src/flags/multivariate.ts +0 -1
  33. package/src/flags/types.ts +0 -59
  34. package/src/flags/utils/multivariate.ts +0 -20
  35. package/src/hooks/Image.tsx +0 -314
  36. package/src/hooks/JsonLd.tsx +0 -353
  37. package/src/hooks/LazySection.tsx +0 -121
  38. package/src/hooks/LiveControls.tsx +0 -144
  39. package/src/hooks/Picture.tsx +0 -127
  40. package/src/hooks/RenderSection.tsx +0 -91
  41. package/src/hooks/SectionErrorFallback.tsx +0 -97
  42. package/src/hooks/Stats.tsx +0 -134
  43. package/src/hooks/index.ts +0 -35
  44. package/src/hooks/useLoadMore.ts +0 -100
  45. package/src/matchers/builtins.ts +0 -459
  46. package/src/matchers/countryNames.ts +0 -104
  47. package/src/matchers/override.ts +0 -136
  48. package/src/matchers/posthog.ts +0 -154
  49. package/src/middleware/decoState.ts +0 -55
  50. package/src/middleware/healthMetrics.ts +0 -133
  51. package/src/middleware/hydrationContext.ts +0 -79
  52. package/src/middleware/index.ts +0 -88
  53. package/src/middleware/liveness.ts +0 -21
  54. package/src/middleware/observability.ts +0 -800
  55. package/src/middleware/validateSection.ts +0 -100
  56. package/src/preview/DraftPreviewBadge.tsx +0 -306
  57. package/src/preview/decoMark.ts +0 -11
  58. package/src/preview/index.ts +0 -8
  59. package/src/sdk/abTesting.ts +0 -556
  60. package/src/sdk/analytics.ts +0 -147
  61. package/src/sdk/cacheHeaders.ts +0 -633
  62. package/src/sdk/cacheStorage.ts +0 -287
  63. package/src/sdk/cachedLoader.ts +0 -556
  64. package/src/sdk/clx.ts +0 -5
  65. package/src/sdk/cn.ts +0 -28
  66. package/src/sdk/composite.ts +0 -114
  67. package/src/sdk/cookie.ts +0 -129
  68. package/src/sdk/crypto.ts +0 -199
  69. package/src/sdk/csp.ts +0 -59
  70. package/src/sdk/deepOmit.ts +0 -52
  71. package/src/sdk/detectDevice.ts +0 -45
  72. package/src/sdk/djb2.ts +0 -20
  73. package/src/sdk/encoding.ts +0 -44
  74. package/src/sdk/env.ts +0 -54
  75. package/src/sdk/experiments.ts +0 -314
  76. package/src/sdk/fetchCache.ts +0 -269
  77. package/src/sdk/fetchTimeout.ts +0 -58
  78. package/src/sdk/flags.ts +0 -138
  79. package/src/sdk/http.ts +0 -124
  80. package/src/sdk/index.ts +0 -97
  81. package/src/sdk/inflightTimeout.ts +0 -53
  82. package/src/sdk/instrumentedFetch.ts +0 -362
  83. package/src/sdk/invoke.ts +0 -298
  84. package/src/sdk/logger.ts +0 -304
  85. package/src/sdk/mergeCacheControl.ts +0 -150
  86. package/src/sdk/nonce.ts +0 -46
  87. package/src/sdk/normalizeUrls.ts +0 -91
  88. package/src/sdk/observability.ts +0 -116
  89. package/src/sdk/otel.ts +0 -1118
  90. package/src/sdk/otelAdapters/clickhouseCollector.ts +0 -65
  91. package/src/sdk/otelAdapters.ts +0 -144
  92. package/src/sdk/otelHttpLog.ts +0 -419
  93. package/src/sdk/otelHttpMeter.ts +0 -532
  94. package/src/sdk/otelHttpTracer.ts +0 -543
  95. package/src/sdk/redirects.ts +0 -336
  96. package/src/sdk/requestContext.ts +0 -281
  97. package/src/sdk/requestContextStorage.browser.ts +0 -43
  98. package/src/sdk/requestContextStorage.ts +0 -35
  99. package/src/sdk/responseCache.ts +0 -82
  100. package/src/sdk/retry.ts +0 -45
  101. package/src/sdk/serverTimings.ts +0 -68
  102. package/src/sdk/signal.ts +0 -42
  103. package/src/sdk/sitemap.ts +0 -160
  104. package/src/sdk/urlRedaction.ts +0 -82
  105. package/src/sdk/urlUtils.ts +0 -183
  106. package/src/sdk/useDevice.ts +0 -89
  107. package/src/sdk/useDeviceContext.tsx +0 -108
  108. package/src/sdk/useId.ts +0 -7
  109. package/src/sdk/useScript.ts +0 -210
  110. package/src/sdk/useSuggestions.ts +0 -188
  111. package/src/sdk/wrapCaughtErrors.ts +0 -107
  112. package/src/setup.ts +0 -120
  113. package/src/types/index.ts +0 -53
  114. package/src/types/widgets.ts +0 -14
package/src/sdk/logger.ts DELETED
@@ -1,304 +0,0 @@
1
- /**
2
- * Pluggable structured logger for @decocms/start.
3
- *
4
- * Mirrors the public shape of `@deco/deco/o11y` logger so site code that
5
- * does `logger.info("...", { key: "value" })` keeps working unchanged
6
- * after the Fresh → TanStack migration.
7
- *
8
- * Backed by a `LoggerAdapter`. The default adapter writes one JSON line
9
- * to `console.log` per call — that line is what Cloudflare Logs / Logpush
10
- * captures, so logging works out of the box on Workers without any
11
- * additional configuration.
12
- *
13
- * To dual-emit to OTLP (HyperDX, etc.), wrap the default with
14
- * `createCompositeLogger([defaultLoggerAdapter, otelLoggerAdapter])`
15
- * inside `instrumentWorker()`.
16
- *
17
- * @example
18
- * ```ts
19
- * import { logger } from "@decocms/start/sdk/logger";
20
- *
21
- * logger.info("checkout started", { orderFormId, items: cart.items.length });
22
- * logger.warn("retrying vtex call", { attempt, host });
23
- * logger.error("payment failed", { reason, code, traceId });
24
- * ```
25
- */
26
-
27
- import { getActiveSpan } from "./observability";
28
- import { RequestContext } from "./requestContext";
29
-
30
- export type LogLevel = "debug" | "info" | "warn" | "error";
31
-
32
- const LEVEL_RANK: Record<LogLevel, number> = {
33
- debug: 10,
34
- info: 20,
35
- warn: 30,
36
- error: 40,
37
- };
38
-
39
- export interface LoggerAdapter {
40
- log(level: LogLevel, msg: string, attrs?: Record<string, unknown>): void;
41
- }
42
-
43
- // ---------------------------------------------------------------------------
44
- // Default adapter — structured JSON to console.log
45
- // ---------------------------------------------------------------------------
46
-
47
- /**
48
- * Cloudflare-Logs-friendly default. One JSON object per call, on stdout.
49
- * Always safe to use — never throws, never depends on env, never makes
50
- * a network call.
51
- */
52
- export const defaultLoggerAdapter: LoggerAdapter = {
53
- log(level, msg, attrs) {
54
- const payload: Record<string, unknown> = {
55
- level,
56
- msg,
57
- timestamp: new Date().toISOString(),
58
- };
59
- if (attrs) {
60
- // Spread last so explicit attrs win over our defaults except
61
- // for `level` / `msg` / `timestamp` which we always want canonical.
62
- for (const [k, v] of Object.entries(attrs)) {
63
- if (k !== "level" && k !== "msg" && k !== "timestamp") {
64
- payload[k] = v;
65
- }
66
- }
67
- }
68
- // Route by level so Cloudflare's log dashboard colorises correctly.
69
- const fn =
70
- level === "error"
71
- ? console.error
72
- : level === "warn"
73
- ? console.warn
74
- : level === "debug"
75
- ? console.debug
76
- : console.log;
77
- try {
78
- fn(JSON.stringify(payload));
79
- } catch {
80
- // Last-resort: fall back to plain string. Never crash the request
81
- // because of a circular-ref or non-serialisable attribute.
82
- fn(`${level} ${msg}`);
83
- }
84
- },
85
- };
86
-
87
- // ---------------------------------------------------------------------------
88
- // Configurable global state
89
- // ---------------------------------------------------------------------------
90
-
91
- // ---------------------------------------------------------------------------
92
- // Shared module state — pinned to globalThis via Symbol.for so multiple
93
- // inlined copies of this module (one per bundled entry file in dist/) all
94
- // converge on the SAME state. See the matching comment in
95
- // `observability.ts` for the rationale — `configureLogger()` from one
96
- // entry file's copy of this module would otherwise write to an
97
- // `activeAdapter` that `logger.error()` in another entry's copy never
98
- // reads, and direct-POST error-log capture silently no-ops.
99
- // ---------------------------------------------------------------------------
100
-
101
- interface LoggerState {
102
- activeAdapter: LoggerAdapter;
103
- minLevel: LogLevel;
104
- attributeFloor: Record<string, unknown>;
105
- }
106
-
107
- const STATE_KEY = Symbol.for("@decocms/start/logger/state.v1");
108
-
109
- function getState(): LoggerState {
110
- const g = globalThis as Record<symbol, unknown>;
111
- if (!g[STATE_KEY]) {
112
- g[STATE_KEY] = {
113
- activeAdapter: defaultLoggerAdapter,
114
- minLevel: "info" as LogLevel,
115
- attributeFloor: {},
116
- } satisfies LoggerState;
117
- }
118
- return g[STATE_KEY] as LoggerState;
119
- }
120
-
121
- /**
122
- * Replace the active logger adapter.
123
- * Call once at worker boot from `instrumentWorker()`.
124
- */
125
- export function configureLogger(adapter: LoggerAdapter): void {
126
- getState().activeAdapter = adapter;
127
- }
128
-
129
- /**
130
- * Replace the per-record attribute floor — keys here will be added to
131
- * every log line UNLESS the caller passes the same key in their `attrs`
132
- * (caller wins). Set once at worker boot from `instrumentWorker()`.
133
- *
134
- * Used to stamp `deco.runtime.version`, `deco.apps.version`,
135
- * `deployment.environment` on every log so HyperDX panels filtering on
136
- * these dimensions keep working under Cloudflare-managed log export
137
- * (which otherwise strips our resource attributes — only the JSON record
138
- * body survives).
139
- */
140
- export function setLoggerAttributeFloor(attrs: Record<string, unknown>): void {
141
- getState().attributeFloor = { ...attrs };
142
- }
143
-
144
- /**
145
- * Test-only: read the current attribute floor. Do not call from app code.
146
- */
147
- export function _getLoggerAttributeFloorForTests(): Record<string, unknown> {
148
- return { ...getState().attributeFloor };
149
- }
150
-
151
- /**
152
- * Get the current active logger adapter (for tests / advanced wiring).
153
- */
154
- export function getLoggerAdapter(): LoggerAdapter {
155
- return getState().activeAdapter;
156
- }
157
-
158
- /**
159
- * Set the minimum log level. Calls below this level are dropped before
160
- * reaching any adapter — useful to silence `debug` in production.
161
- *
162
- * Defaults to `info`. Override per environment via `setLogLevel("debug")`
163
- * or by reading an env var at boot.
164
- */
165
- export function setLogLevel(level: LogLevel): void {
166
- getState().minLevel = level;
167
- }
168
-
169
- export function getLogLevel(): LogLevel {
170
- return getState().minLevel;
171
- }
172
-
173
- function shouldLog(level: LogLevel): boolean {
174
- return LEVEL_RANK[level] >= LEVEL_RANK[getState().minLevel];
175
- }
176
-
177
- // ---------------------------------------------------------------------------
178
- // Public logger surface
179
- // ---------------------------------------------------------------------------
180
-
181
- /**
182
- * Strict structured logger. Mirrors `@deco/deco/o11y`:
183
- * - first arg is a human-readable message string
184
- * - optional second arg is a flat attributes object
185
- *
186
- * Adapters decide the destination (stdout JSON, OTLP, both, …). The
187
- * contract is intentionally narrow so structured output stays predictable
188
- * across all sinks.
189
- *
190
- * @example
191
- * ```ts
192
- * logger.info("checkout started", { orderFormId, items });
193
- * logger.warn("retrying vtex call", { attempt, host });
194
- *
195
- * // For Errors, serialize explicitly into the attrs payload:
196
- * try { ... } catch (err) {
197
- * const e = serializeError(err);
198
- * logger.error(e.message, { error: e, stage: "checkout" });
199
- * }
200
- * ```
201
- */
202
- export interface Logger {
203
- debug(msg: string, attrs?: Record<string, unknown>): void;
204
- info(msg: string, attrs?: Record<string, unknown>): void;
205
- warn(msg: string, attrs?: Record<string, unknown>): void;
206
- error(msg: string, attrs?: Record<string, unknown>): void;
207
- }
208
-
209
- /**
210
- * Normalised, JSON-safe error shape suitable for inclusion in logger
211
- * attributes. `serializeError` always returns this shape regardless of
212
- * what was thrown.
213
- */
214
- export interface SerializedError {
215
- name: string;
216
- message: string;
217
- stack?: string;
218
- }
219
-
220
- /**
221
- * Convert any thrown value into a flat, structured object that survives
222
- * `JSON.stringify` and round-trips cleanly to OTel / Cloudflare Logs.
223
- * Strict logger sites should call this from their catch blocks rather
224
- * than passing the Error directly.
225
- *
226
- * @example
227
- * ```ts
228
- * try { ... } catch (err) {
229
- * const e = serializeError(err);
230
- * logger.error(e.message, { error: e });
231
- * }
232
- * ```
233
- */
234
- export function serializeError(err: unknown): SerializedError {
235
- if (err instanceof Error) {
236
- return { name: err.name, message: err.message, stack: err.stack };
237
- }
238
- if (err && typeof err === "object") {
239
- let body: string;
240
- try {
241
- body = JSON.stringify(err);
242
- } catch {
243
- body = String(err);
244
- }
245
- return { name: "NonError", message: body };
246
- }
247
- return { name: "NonError", message: String(err) };
248
- }
249
-
250
- function emit(level: LogLevel, msg: string, attrs?: Record<string, unknown>): void {
251
- if (!shouldLog(level)) return;
252
- // Pull trace context from the active span so every log line correlates
253
- // to its trace in ClickStack/HyperDX. No active span → no-op; caller
254
- // attrs always win so explicit `trace_id` overrides keep working.
255
- const ctx = getActiveSpan()?.spanContext?.();
256
- // Pull request.id from the AsyncLocalStorage-backed RequestContext so
257
- // every log line in the request also carries the join key used by
258
- // direct-POST metrics + tail-worker rows. Single read, no allocation
259
- // when outside a request scope.
260
- const requestId = RequestContext.requestId;
261
- const requestAttrs: Record<string, unknown> | undefined =
262
- ctx || requestId
263
- ? {
264
- ...(ctx ? { trace_id: ctx.traceId, span_id: ctx.spanId } : {}),
265
- ...(requestId ? { "request.id": requestId } : {}),
266
- }
267
- : undefined;
268
- // Merge order: floor → trace / request context → caller attrs. Caller
269
- // wins; the request-scoped context only overrides floor keys (which
270
- // never set `trace_id` / `request.id` anyway).
271
- const s = getState();
272
- const hasFloor = Object.keys(s.attributeFloor).length > 0;
273
- let merged: Record<string, unknown> | undefined;
274
- if (!hasFloor && !requestAttrs && !attrs) {
275
- merged = undefined;
276
- } else {
277
- merged = {
278
- ...(hasFloor ? s.attributeFloor : {}),
279
- ...(requestAttrs ?? {}),
280
- ...(attrs ?? {}),
281
- };
282
- }
283
- try {
284
- s.activeAdapter.log(level, msg, merged);
285
- } catch {
286
- // Adapter blew up. Fall back to default so we don't lose the line.
287
- if (s.activeAdapter !== defaultLoggerAdapter) {
288
- try {
289
- defaultLoggerAdapter.log(level, msg, merged);
290
- } catch {
291
- /* swallow */
292
- }
293
- }
294
- }
295
- }
296
-
297
- export const logger: Logger = {
298
- debug: (msg, attrs) => emit("debug", msg, attrs),
299
- info: (msg, attrs) => emit("info", msg, attrs),
300
- warn: (msg, attrs) => emit("warn", msg, attrs),
301
- error: (msg, attrs) => emit("error", msg, attrs),
302
- };
303
-
304
- export default logger;
@@ -1,150 +0,0 @@
1
- /**
2
- * Cache-Control merge utility.
3
- *
4
- * When a page makes multiple backend calls with different cache lifetimes,
5
- * the final page response must use the most restrictive (shortest) cache
6
- * values. This utility merges multiple Cache-Control headers following
7
- * the "most restrictive wins" strategy.
8
- *
9
- * @example
10
- * ```ts
11
- * import { mergeCacheControl } from "@decocms/start/sdk/mergeCacheControl";
12
- *
13
- * // Product loader returns 60s, mega menu returns 3600s
14
- * const merged = mergeCacheControl([
15
- * "public, s-maxage=60, stale-while-revalidate=300",
16
- * "public, s-maxage=3600, stale-while-revalidate=86400",
17
- * ]);
18
- * // => "public, s-maxage=60, stale-while-revalidate=300"
19
- * ```
20
- */
21
-
22
- interface ParsedCacheControl {
23
- isPublic: boolean;
24
- isPrivate: boolean;
25
- noCache: boolean;
26
- noStore: boolean;
27
- maxAge?: number;
28
- sMaxAge?: number;
29
- staleWhileRevalidate?: number;
30
- staleIfError?: number;
31
- mustRevalidate: boolean;
32
- }
33
-
34
- function safeParseInt(value: string | undefined): number | undefined {
35
- if (!value) return undefined;
36
- const n = parseInt(value, 10);
37
- return Number.isFinite(n) ? n : undefined;
38
- }
39
-
40
- function parse(header: string): ParsedCacheControl {
41
- const directives = header.split(",").map((d) => d.trim().toLowerCase());
42
-
43
- const result: ParsedCacheControl = {
44
- isPublic: false,
45
- isPrivate: false,
46
- noCache: false,
47
- noStore: false,
48
- mustRevalidate: false,
49
- };
50
-
51
- for (const directive of directives) {
52
- if (directive === "public") result.isPublic = true;
53
- else if (directive === "private") result.isPrivate = true;
54
- else if (directive === "no-cache") result.noCache = true;
55
- else if (directive === "no-store") result.noStore = true;
56
- else if (directive === "must-revalidate") result.mustRevalidate = true;
57
- else if (directive.startsWith("max-age=")) {
58
- result.maxAge = safeParseInt(directive.split("=")[1]);
59
- } else if (directive.startsWith("s-maxage=")) {
60
- result.sMaxAge = safeParseInt(directive.split("=")[1]);
61
- } else if (directive.startsWith("stale-while-revalidate=")) {
62
- result.staleWhileRevalidate = safeParseInt(directive.split("=")[1]);
63
- } else if (directive.startsWith("stale-if-error=")) {
64
- result.staleIfError = safeParseInt(directive.split("=")[1]);
65
- }
66
- }
67
-
68
- return result;
69
- }
70
-
71
- function minDefined(...values: (number | undefined)[]): number | undefined {
72
- const defined = values.filter((v): v is number => v != null);
73
- return defined.length > 0 ? Math.min(...defined) : undefined;
74
- }
75
-
76
- /**
77
- * Merge multiple Cache-Control headers using "most restrictive wins".
78
- *
79
- * - If any header is `private`, the result is `private`
80
- * - If any header has `no-store`, the result has `no-store`
81
- * - Numeric values (max-age, s-maxage, swr) use the minimum
82
- */
83
- export function mergeCacheControl(headers: string[]): string {
84
- if (headers.length === 0) return "public, s-maxage=0";
85
- if (headers.length === 1) return headers[0];
86
-
87
- const parsed = headers.map(parse);
88
-
89
- const anyPrivate = parsed.some((p) => p.isPrivate);
90
- const anyNoStore = parsed.some((p) => p.noStore);
91
- const anyNoCache = parsed.some((p) => p.noCache);
92
- const anyMustRevalidate = parsed.some((p) => p.mustRevalidate);
93
-
94
- if (anyNoStore) {
95
- return "private, no-cache, no-store, must-revalidate";
96
- }
97
-
98
- if (anyPrivate) {
99
- const maxAge = minDefined(...parsed.map((p) => p.maxAge));
100
- const parts = ["private"];
101
- if (anyNoCache) parts.push("no-cache");
102
- if (maxAge != null) parts.push(`max-age=${maxAge}`);
103
- if (anyMustRevalidate) parts.push("must-revalidate");
104
- return parts.join(", ");
105
- }
106
-
107
- const maxAge = minDefined(...parsed.map((p) => p.maxAge));
108
- const sMaxAge = minDefined(...parsed.map((p) => p.sMaxAge));
109
- const swr = minDefined(...parsed.map((p) => p.staleWhileRevalidate));
110
- const sie = minDefined(...parsed.map((p) => p.staleIfError));
111
-
112
- const parts: string[] = ["public"];
113
- if (maxAge != null) parts.push(`max-age=${maxAge}`);
114
- if (sMaxAge != null) parts.push(`s-maxage=${sMaxAge}`);
115
- if (swr != null) parts.push(`stale-while-revalidate=${swr}`);
116
- if (sie != null) parts.push(`stale-if-error=${sie}`);
117
- if (anyMustRevalidate) parts.push("must-revalidate");
118
-
119
- return parts.join(", ");
120
- }
121
-
122
- /**
123
- * Accumulator for collecting cache control headers across loaders.
124
- *
125
- * Use in middleware to collect headers from each loader call and
126
- * compute the final merged header at the end.
127
- *
128
- * @example
129
- * ```ts
130
- * const collector = createCacheControlCollector();
131
- * collector.add("public, s-maxage=60");
132
- * collector.add("public, s-maxage=3600");
133
- * response.headers.set("Cache-Control", collector.result());
134
- * // => "public, s-maxage=60"
135
- * ```
136
- */
137
- export function createCacheControlCollector() {
138
- const headers: string[] = [];
139
- return {
140
- add(header: string) {
141
- headers.push(header);
142
- },
143
- result(): string {
144
- return mergeCacheControl(headers);
145
- },
146
- get count() {
147
- return headers.length;
148
- },
149
- };
150
- }
package/src/sdk/nonce.ts DELETED
@@ -1,46 +0,0 @@
1
- /**
2
- * Per-request CSP nonce.
3
- *
4
- * When the TanStack worker entry runs with `cspMode: "enforce"`, it generates a
5
- * fresh nonce per request, stashes it in the RequestContext bag (below), and
6
- * threads it into:
7
- *
8
- * - the TanStack router (`router.options.ssr.nonce`), so `ScriptOnce` and the
9
- * framework's own hydration scripts carry `nonce=…`;
10
- * - the hand-written inline `<script>` tags in the deco layout / live-controls
11
- * components (they read it via `getRequestNonce()`);
12
- * - the enforced `Content-Security-Policy` header's `script-src`.
13
- *
14
- * Lives in `runtime` (not `tanstack`) so both the tanstack worker and the
15
- * runtime components (e.g. LiveControls) can reach it without crossing the
16
- * one-way package dependency graph.
17
- *
18
- * The nonce is only produced on the server and only in enforce mode; in the
19
- * browser the RequestContext is a no-op stub, so `getRequestNonce()` returns
20
- * `undefined` and every consumer degrades to "no nonce attribute".
21
- */
22
- import { RequestContext } from "./requestContext";
23
-
24
- /** RequestContext bag key holding the current request's CSP nonce. */
25
- export const NONCE_BAG_KEY = "deco.csp.nonce";
26
-
27
- /**
28
- * Generate a CSP nonce: 128 bits of CSPRNG randomness, base64-encoded. Fresh
29
- * per request — never reuse across responses, or the nonce loses all value.
30
- */
31
- export function generateNonce(): string {
32
- const bytes = new Uint8Array(16);
33
- crypto.getRandomValues(bytes);
34
- let binary = "";
35
- for (const byte of bytes) binary += String.fromCharCode(byte);
36
- return btoa(binary);
37
- }
38
-
39
- /**
40
- * The current request's CSP nonce, or `undefined` when CSP is not enforced
41
- * (report-only mode) or on the client. Read this in an SSR component to nonce
42
- * an inline `<script>`: `<script nonce={getRequestNonce()} … />`.
43
- */
44
- export function getRequestNonce(): string | undefined {
45
- return RequestContext.getBag<string>(NONCE_BAG_KEY);
46
- }
@@ -1,91 +0,0 @@
1
- /**
2
- * URL normalization for CMS-resolved props.
3
- *
4
- * Strips registered production origins from absolute URLs, converting them to
5
- * relative paths. This allows staging/preview deployments to work without
6
- * every CMS-authored link sending users to the production domain.
7
- *
8
- * Only affects strings that START with a registered origin + "/" — image CDN
9
- * URLs, API endpoints on different domains, and non-URL strings are untouched.
10
- *
11
- * @example
12
- * ```ts
13
- * // In site's setup.ts:
14
- * import { registerProductionOrigins } from "@decocms/start/sdk/normalizeUrls";
15
- * registerProductionOrigins([
16
- * "https://www.acme.com.br",
17
- * "https://acme.com.br",
18
- * ]);
19
- * ```
20
- */
21
-
22
- let origins: string[] = [];
23
-
24
- /**
25
- * Register production origins that should be stripped from CMS-resolved URLs.
26
- * Call once in your site's setup.ts before any page loads.
27
- */
28
- export function registerProductionOrigins(productionOrigins: string[]) {
29
- origins = productionOrigins.map((o) => o.replace(/\/+$/, ""));
30
- }
31
-
32
- export function getProductionOrigins(): readonly string[] {
33
- return origins;
34
- }
35
-
36
- function normalizeString(str: string): string {
37
- for (const origin of origins) {
38
- if (str.startsWith(origin + "/")) {
39
- return str.slice(origin.length);
40
- }
41
- if (str === origin) {
42
- return "/";
43
- }
44
- }
45
- return str;
46
- }
47
-
48
- /**
49
- * Deep-walk an object tree and rewrite any string value that starts with a
50
- * registered production origin to a relative path. Returns the same reference
51
- * if nothing was changed (structural sharing).
52
- */
53
- export function normalizeUrlsInObject<T>(obj: T): T {
54
- if (!origins.length) return obj;
55
- return deepNormalize(obj) as T;
56
- }
57
-
58
- function deepNormalize(val: unknown): unknown {
59
- if (val == null) return val;
60
-
61
- if (typeof val === "string") {
62
- return normalizeString(val);
63
- }
64
-
65
- if (Array.isArray(val)) {
66
- let changed = false;
67
- const result = val.map((item) => {
68
- const normalized = deepNormalize(item);
69
- if (normalized !== item) changed = true;
70
- return normalized;
71
- });
72
- return changed ? result : val;
73
- }
74
-
75
- if (typeof val === "object") {
76
- // Skip React elements, Dates, RegExps, and other non-plain objects
77
- const proto = Object.getPrototypeOf(val);
78
- if (proto !== Object.prototype && proto !== null) return val;
79
-
80
- let changed = false;
81
- const result: Record<string, unknown> = {};
82
- for (const [key, value] of Object.entries(val as Record<string, unknown>)) {
83
- const normalized = deepNormalize(value);
84
- result[key] = normalized;
85
- if (normalized !== value) changed = true;
86
- }
87
- return changed ? result : val;
88
- }
89
-
90
- return val;
91
- }
@@ -1,116 +0,0 @@
1
- /**
2
- * One-stop import for everything observability-related in `@decocms/start`.
3
- *
4
- * Consumers (sites, apps) should prefer importing from here so future
5
- * re-organisations don't ripple through every site:
6
- *
7
- * ```ts
8
- * import {
9
- * instrumentWorker,
10
- * logger,
11
- * setLogLevel,
12
- * withTracing,
13
- * recordRequestMetric,
14
- * recordCacheMetric,
15
- * MetricNames,
16
- * } from "@decocms/start/sdk/observability";
17
- * ```
18
- *
19
- * The granular modules (`@decocms/start/sdk/logger`, `.../otelAdapters`)
20
- * remain importable for advanced use cases (custom adapters, tests, etc.)
21
- * but the common path stays here.
22
- *
23
- * **5.0.0 surface change.** The OTLP exporters (`createOtelLoggerAdapter`,
24
- * `createOtelMeterAdapter`), the flush registry (`flushOtelProviders`,
25
- * `registerOtelFlushHandler`), and the URL-based sampler
26
- * (`URLBasedSampler`, `decodeSamplingConfig`, `createUrlBasedHeadSampler`,
27
- * `SamplingConfig`, `SamplingRule`) were removed. They will be reintroduced
28
- * via `./otelAdapters/clickhouseCollector.ts` when the platform-side OTel
29
- * collector ships. The `instrumentWorker` / `withTracing` / `logger` /
30
- * `recordRequestMetric` / `recordCacheMetric` surface is unchanged — only
31
- * the transport layer was stripped.
32
- */
33
-
34
- // Composite helpers (for advanced multi-backend wiring — e.g. AE + future
35
- // ClickHouse-collector meter, or default-console + future-collector logger)
36
- export { createCompositeLogger, createCompositeMeter } from "./composite";
37
- // Logger surface
38
- export {
39
- configureLogger,
40
- defaultLoggerAdapter,
41
- getLoggerAdapter,
42
- getLogLevel,
43
- type Logger,
44
- type LoggerAdapter,
45
- type LogLevel,
46
- logger,
47
- type SerializedError,
48
- serializeError,
49
- setLoggerAttributeFloor,
50
- setLogLevel,
51
- } from "./logger";
52
- // Tracer / meter / request log primitives (re-exported from the middleware)
53
- export {
54
- type CacheDecision,
55
- type CacheLayer,
56
- type CommerceMetricLabels,
57
- configureMeter,
58
- configureTracer,
59
- getActiveSpan,
60
- getMeter,
61
- getTracer,
62
- injectTraceContext,
63
- logRequest,
64
- type MeterAdapter,
65
- MetricNames,
66
- recordCacheMetric,
67
- recordCacheSizeMetric,
68
- recordCommerceMetric,
69
- recordLoaderError,
70
- recordLoaderMetric,
71
- recordRequestMetric,
72
- type RequestMetricLabels,
73
- type RequestStore,
74
- type Span,
75
- setObservabilitySpanStore,
76
- setSpanAttribute,
77
- statusClassFor,
78
- type TracerAdapter,
79
- withTracing,
80
- } from "../middleware/observability";
81
- // Worker-entry wrapper + adapter wiring
82
- export {
83
- bootObservability,
84
- flushObservability,
85
- instrumentWorker,
86
- instrumentWorkflowRun,
87
- type OtelOptions,
88
- } from "./otel";
89
- // Direct-POST OTLP trace exporter (Phase 3 / D-12). Exported for sites
90
- // that need to wire a custom traces endpoint outside `instrumentWorker`,
91
- // and for the audit tooling that asserts framework spans are flowing.
92
- export {
93
- createOtlpHttpTracerAdapter,
94
- newSpanId,
95
- newTraceId,
96
- type OtlpHttpTracer,
97
- type OtlpHttpTracerOptions,
98
- parseTraceparent,
99
- shouldSampleTrace,
100
- type TraceContext,
101
- } from "./otelHttpTracer";
102
- // AE meter adapter + runtime env helpers (for tests / custom wiring)
103
- export {
104
- type AnalyticsEngineDataset,
105
- type AnalyticsEngineMeterAdapterOptions,
106
- createAnalyticsEngineMeterAdapter,
107
- getRuntimeEnv,
108
- setRuntimeEnv,
109
- } from "./otelAdapters";
110
- // ClickHouse collector adapter — stub today, real exporter when the
111
- // collector lands. Re-exported from here so site code can import the
112
- // future-target symbol via the canonical observability barrel.
113
- export {
114
- type ClickhouseCollectorOptions,
115
- createClickhouseCollectorAdapter,
116
- } from "./otelAdapters/clickhouseCollector";