@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.
- package/package.json +6 -92
- package/src/index.ts +2 -12
- package/src/protocol/storage/memory.ts +1 -1
- package/src/v8/background.ts +3 -3
- package/src/v8/builtins/legacy.ts +1 -1
- package/src/v8/cli/index.ts +1 -1
- package/src/v8/fetch.ts +8 -27
- package/src/v8/remoteLoader.ts +1 -1
- package/src/v8/telemetry.ts +1 -1
- package/src/cms/applySectionConventions.ts +0 -148
- package/src/cms/blockSource.ts +0 -228
- package/src/cms/client.ts +0 -85
- package/src/cms/deferredTrigger.ts +0 -58
- package/src/cms/draftSource.ts +0 -476
- package/src/cms/index.ts +0 -180
- package/src/cms/loadDecofileDirectory.ts +0 -89
- package/src/cms/loader.ts +0 -563
- package/src/cms/registry.ts +0 -264
- package/src/cms/renderJson.ts +0 -179
- package/src/cms/resolve.ts +0 -2583
- package/src/cms/schema.ts +0 -1219
- package/src/cms/sectionLoaderContext.ts +0 -113
- package/src/cms/sectionLoaders.ts +0 -686
- package/src/cms/sectionMixins.ts +0 -153
- package/src/flags/audience.ts +0 -56
- package/src/flags/everyone.ts +0 -29
- package/src/flags/flag.ts +0 -15
- package/src/flags/multivariate/image.ts +0 -11
- package/src/flags/multivariate/message.ts +0 -11
- package/src/flags/multivariate/page.ts +0 -16
- package/src/flags/multivariate/section.ts +0 -16
- package/src/flags/multivariate.ts +0 -1
- package/src/flags/types.ts +0 -59
- package/src/flags/utils/multivariate.ts +0 -20
- package/src/hooks/Image.tsx +0 -314
- package/src/hooks/JsonLd.tsx +0 -353
- package/src/hooks/LazySection.tsx +0 -121
- package/src/hooks/LiveControls.tsx +0 -144
- package/src/hooks/Picture.tsx +0 -127
- package/src/hooks/RenderSection.tsx +0 -91
- package/src/hooks/SectionErrorFallback.tsx +0 -97
- package/src/hooks/Stats.tsx +0 -134
- package/src/hooks/index.ts +0 -35
- package/src/hooks/useLoadMore.ts +0 -100
- package/src/matchers/builtins.ts +0 -459
- package/src/matchers/countryNames.ts +0 -104
- package/src/matchers/override.ts +0 -136
- package/src/matchers/posthog.ts +0 -154
- package/src/middleware/decoState.ts +0 -55
- package/src/middleware/healthMetrics.ts +0 -133
- package/src/middleware/hydrationContext.ts +0 -79
- package/src/middleware/index.ts +0 -88
- package/src/middleware/liveness.ts +0 -21
- package/src/middleware/observability.ts +0 -800
- package/src/middleware/validateSection.ts +0 -100
- package/src/preview/DraftPreviewBadge.tsx +0 -306
- package/src/preview/decoMark.ts +0 -11
- package/src/preview/index.ts +0 -8
- package/src/sdk/abTesting.ts +0 -556
- package/src/sdk/analytics.ts +0 -147
- package/src/sdk/cacheHeaders.ts +0 -633
- package/src/sdk/cacheStorage.ts +0 -287
- package/src/sdk/cachedLoader.ts +0 -556
- package/src/sdk/clx.ts +0 -5
- package/src/sdk/cn.ts +0 -28
- package/src/sdk/composite.ts +0 -114
- package/src/sdk/cookie.ts +0 -129
- package/src/sdk/crypto.ts +0 -199
- package/src/sdk/csp.ts +0 -59
- package/src/sdk/deepOmit.ts +0 -52
- package/src/sdk/detectDevice.ts +0 -45
- package/src/sdk/djb2.ts +0 -20
- package/src/sdk/encoding.ts +0 -44
- package/src/sdk/env.ts +0 -54
- package/src/sdk/experiments.ts +0 -314
- package/src/sdk/fetchCache.ts +0 -269
- package/src/sdk/fetchTimeout.ts +0 -58
- package/src/sdk/flags.ts +0 -138
- package/src/sdk/http.ts +0 -124
- package/src/sdk/index.ts +0 -97
- package/src/sdk/inflightTimeout.ts +0 -53
- package/src/sdk/instrumentedFetch.ts +0 -362
- package/src/sdk/invoke.ts +0 -298
- package/src/sdk/logger.ts +0 -304
- package/src/sdk/mergeCacheControl.ts +0 -150
- package/src/sdk/nonce.ts +0 -46
- package/src/sdk/normalizeUrls.ts +0 -91
- package/src/sdk/observability.ts +0 -116
- package/src/sdk/otel.ts +0 -1118
- package/src/sdk/otelAdapters/clickhouseCollector.ts +0 -65
- package/src/sdk/otelAdapters.ts +0 -144
- package/src/sdk/otelHttpLog.ts +0 -419
- package/src/sdk/otelHttpMeter.ts +0 -532
- package/src/sdk/otelHttpTracer.ts +0 -543
- package/src/sdk/redirects.ts +0 -336
- package/src/sdk/requestContext.ts +0 -281
- package/src/sdk/requestContextStorage.browser.ts +0 -43
- package/src/sdk/requestContextStorage.ts +0 -35
- package/src/sdk/responseCache.ts +0 -82
- package/src/sdk/retry.ts +0 -45
- package/src/sdk/serverTimings.ts +0 -68
- package/src/sdk/signal.ts +0 -42
- package/src/sdk/sitemap.ts +0 -160
- package/src/sdk/urlRedaction.ts +0 -82
- package/src/sdk/urlUtils.ts +0 -183
- package/src/sdk/useDevice.ts +0 -89
- package/src/sdk/useDeviceContext.tsx +0 -108
- package/src/sdk/useId.ts +0 -7
- package/src/sdk/useScript.ts +0 -210
- package/src/sdk/useSuggestions.ts +0 -188
- package/src/sdk/wrapCaughtErrors.ts +0 -107
- package/src/setup.ts +0 -120
- package/src/types/index.ts +0 -53
- package/src/types/widgets.ts +0 -14
package/src/matchers/posthog.ts
DELETED
|
@@ -1,154 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* PostHog feature flag matcher bridge.
|
|
3
|
-
*
|
|
4
|
-
* Bridges deco's CMS matcher interface (`evaluateMatcher`) to PostHog's
|
|
5
|
-
* feature flag system for experiment-grade A/B testing with sticky sessions.
|
|
6
|
-
*
|
|
7
|
-
* This module is designed to be used with `registerMatcher()` from the CMS.
|
|
8
|
-
* PostHog itself is NOT a dependency of `@decocms/start` — the storefront
|
|
9
|
-
* provides the PostHog client via `configurePostHogMatcher()`.
|
|
10
|
-
*
|
|
11
|
-
* @example
|
|
12
|
-
* ```ts
|
|
13
|
-
* // In your storefront setup.ts
|
|
14
|
-
* import { registerMatcher } from "@decocms/start/cms";
|
|
15
|
-
* import { createPostHogMatcher, configurePostHogMatcher } from "@decocms/start/matchers/posthog";
|
|
16
|
-
* import posthog from "posthog-js";
|
|
17
|
-
*
|
|
18
|
-
* configurePostHogMatcher({
|
|
19
|
-
* isFeatureEnabled: (key) => posthog.isFeatureEnabled(key) ?? false,
|
|
20
|
-
* getFeatureFlagVariant: (key) => posthog.getFeatureFlag(key),
|
|
21
|
-
* });
|
|
22
|
-
*
|
|
23
|
-
* registerMatcher("posthog/matchers/featureFlag.ts", createPostHogMatcher());
|
|
24
|
-
* ```
|
|
25
|
-
*/
|
|
26
|
-
|
|
27
|
-
import type { MatcherContext } from "../cms/resolve";
|
|
28
|
-
|
|
29
|
-
export interface PostHogAdapter {
|
|
30
|
-
/**
|
|
31
|
-
* Evaluate a boolean feature flag.
|
|
32
|
-
* Should return `true` if the flag is enabled for the current user.
|
|
33
|
-
*/
|
|
34
|
-
isFeatureEnabled: (flagKey: string) => boolean;
|
|
35
|
-
/**
|
|
36
|
-
* Get the variant key for a multivariate feature flag.
|
|
37
|
-
* Returns the variant string or `undefined`/`false` if not matched.
|
|
38
|
-
*/
|
|
39
|
-
getFeatureFlagVariant?: (flagKey: string) => string | boolean | undefined;
|
|
40
|
-
}
|
|
41
|
-
|
|
42
|
-
let adapter: PostHogAdapter | null = null;
|
|
43
|
-
|
|
44
|
-
/**
|
|
45
|
-
* Provide the PostHog client adapter. Must be called before
|
|
46
|
-
* any PostHog matchers are evaluated.
|
|
47
|
-
*/
|
|
48
|
-
export function configurePostHogMatcher(ph: PostHogAdapter) {
|
|
49
|
-
adapter = ph;
|
|
50
|
-
}
|
|
51
|
-
|
|
52
|
-
/**
|
|
53
|
-
* Creates a matcher function compatible with `registerMatcher()`.
|
|
54
|
-
*
|
|
55
|
-
* CMS rule shape (in the decofile JSON):
|
|
56
|
-
* ```json
|
|
57
|
-
* {
|
|
58
|
-
* "__resolveType": "posthog/matchers/featureFlag.ts",
|
|
59
|
-
* "flagKey": "my-experiment",
|
|
60
|
-
* "variant": "treatment"
|
|
61
|
-
* }
|
|
62
|
-
* ```
|
|
63
|
-
*
|
|
64
|
-
* - If only `flagKey` is provided, matches when the flag is enabled (boolean).
|
|
65
|
-
* - If `variant` is also provided, matches when the flag's variant equals it.
|
|
66
|
-
*/
|
|
67
|
-
export function createPostHogMatcher() {
|
|
68
|
-
return (rule: Record<string, unknown>, _ctx: MatcherContext): boolean => {
|
|
69
|
-
if (!adapter) {
|
|
70
|
-
console.warn(
|
|
71
|
-
"[PostHog Matcher] No adapter configured. Call configurePostHogMatcher() first.",
|
|
72
|
-
);
|
|
73
|
-
return false;
|
|
74
|
-
}
|
|
75
|
-
|
|
76
|
-
const flagKey = rule.flagKey as string | undefined;
|
|
77
|
-
if (!flagKey) {
|
|
78
|
-
console.warn("[PostHog Matcher] Missing `flagKey` in matcher rule.");
|
|
79
|
-
return false;
|
|
80
|
-
}
|
|
81
|
-
|
|
82
|
-
const expectedVariant = rule.variant as string | undefined;
|
|
83
|
-
|
|
84
|
-
if (expectedVariant && adapter.getFeatureFlagVariant) {
|
|
85
|
-
const actual = adapter.getFeatureFlagVariant(flagKey);
|
|
86
|
-
return actual === expectedVariant;
|
|
87
|
-
}
|
|
88
|
-
|
|
89
|
-
return adapter.isFeatureEnabled(flagKey);
|
|
90
|
-
};
|
|
91
|
-
}
|
|
92
|
-
|
|
93
|
-
/**
|
|
94
|
-
* Server-side PostHog evaluation for SSR.
|
|
95
|
-
*
|
|
96
|
-
* Uses the PostHog Node SDK to evaluate flags server-side,
|
|
97
|
-
* ensuring the first render has the correct variant without a flash.
|
|
98
|
-
*
|
|
99
|
-
* @example
|
|
100
|
-
* ```ts
|
|
101
|
-
* import { PostHog } from "posthog-node";
|
|
102
|
-
* import { configurePostHogMatcher, createServerPostHogAdapter } from "@decocms/start/matchers/posthog";
|
|
103
|
-
*
|
|
104
|
-
* const phServer = new PostHog(process.env.POSTHOG_API_KEY);
|
|
105
|
-
*
|
|
106
|
-
* // In your middleware, per-request:
|
|
107
|
-
* const adapter = createServerPostHogAdapter(phServer, distinctId);
|
|
108
|
-
* configurePostHogMatcher(adapter);
|
|
109
|
-
* ```
|
|
110
|
-
*/
|
|
111
|
-
export function createServerPostHogAdapter(
|
|
112
|
-
client: {
|
|
113
|
-
isFeatureEnabled: (key: string, distinctId: string) => Promise<boolean> | boolean;
|
|
114
|
-
getFeatureFlag: (
|
|
115
|
-
key: string,
|
|
116
|
-
distinctId: string,
|
|
117
|
-
) => Promise<string | boolean | undefined> | string | boolean | undefined;
|
|
118
|
-
},
|
|
119
|
-
distinctId: string,
|
|
120
|
-
): PostHogAdapter {
|
|
121
|
-
const flagCache = new Map<string, boolean>();
|
|
122
|
-
const variantCache = new Map<string, string | boolean | undefined>();
|
|
123
|
-
|
|
124
|
-
return {
|
|
125
|
-
isFeatureEnabled(key: string): boolean {
|
|
126
|
-
if (flagCache.has(key)) return flagCache.get(key)!;
|
|
127
|
-
|
|
128
|
-
// Synchronous path — pre-warm the cache in middleware before resolution
|
|
129
|
-
const result = client.isFeatureEnabled(key, distinctId);
|
|
130
|
-
if (result instanceof Promise) {
|
|
131
|
-
console.warn(
|
|
132
|
-
"[PostHog] Async flag evaluation used synchronously. Pre-warm flags in middleware.",
|
|
133
|
-
);
|
|
134
|
-
return false;
|
|
135
|
-
}
|
|
136
|
-
flagCache.set(key, result);
|
|
137
|
-
return result;
|
|
138
|
-
},
|
|
139
|
-
|
|
140
|
-
getFeatureFlagVariant(key: string): string | boolean | undefined {
|
|
141
|
-
if (variantCache.has(key)) return variantCache.get(key);
|
|
142
|
-
|
|
143
|
-
const result = client.getFeatureFlag(key, distinctId);
|
|
144
|
-
if (result instanceof Promise) {
|
|
145
|
-
console.warn(
|
|
146
|
-
"[PostHog] Async variant evaluation used synchronously. Pre-warm flags in middleware.",
|
|
147
|
-
);
|
|
148
|
-
return undefined;
|
|
149
|
-
}
|
|
150
|
-
variantCache.set(key, result);
|
|
151
|
-
return result;
|
|
152
|
-
},
|
|
153
|
-
};
|
|
154
|
-
}
|
|
@@ -1,55 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Per-request Deco state that the middleware pipeline builds up
|
|
3
|
-
* and passes through the request lifecycle.
|
|
4
|
-
*/
|
|
5
|
-
import { createServerTimings, type ServerTimings } from "../sdk/serverTimings";
|
|
6
|
-
import type { Flag } from "../types/index";
|
|
7
|
-
|
|
8
|
-
export interface DecoState {
|
|
9
|
-
/** Site name / identifier. */
|
|
10
|
-
site: string;
|
|
11
|
-
/** Per-request Server-Timing tracker. */
|
|
12
|
-
timings: ServerTimings;
|
|
13
|
-
/** Active feature flags for this request. */
|
|
14
|
-
flags: Flag[];
|
|
15
|
-
/** Whether the request is from a deco admin origin. */
|
|
16
|
-
isAdmin: boolean;
|
|
17
|
-
/** Whether debug mode is enabled (via `?__d=true` or admin). */
|
|
18
|
-
debug: boolean;
|
|
19
|
-
/** Start time of the request (ms). */
|
|
20
|
-
startedAt: number;
|
|
21
|
-
}
|
|
22
|
-
|
|
23
|
-
export function buildDecoState(request: Request, site?: string): DecoState {
|
|
24
|
-
const url = new URL(request.url);
|
|
25
|
-
const origin = request.headers.get("origin") || request.headers.get("referer") || "";
|
|
26
|
-
|
|
27
|
-
const ADMIN_ORIGINS = [
|
|
28
|
-
"https://admin.deco.cx",
|
|
29
|
-
"https://v0-admin.deco.cx",
|
|
30
|
-
"https://play.deco.cx",
|
|
31
|
-
"https://admin-cx.deco.page",
|
|
32
|
-
"https://deco.chat",
|
|
33
|
-
"https://admin.decocms.com",
|
|
34
|
-
"https://decocms.com",
|
|
35
|
-
];
|
|
36
|
-
|
|
37
|
-
const isAdmin =
|
|
38
|
-
origin.includes("localhost") ||
|
|
39
|
-
origin.includes("127.0.0.1") ||
|
|
40
|
-
ADMIN_ORIGINS.some((d) => origin.startsWith(d));
|
|
41
|
-
|
|
42
|
-
const debug = url.searchParams.has("__d") || isAdmin;
|
|
43
|
-
|
|
44
|
-
return {
|
|
45
|
-
site:
|
|
46
|
-
site ||
|
|
47
|
-
(typeof globalThis.process !== "undefined" ? globalThis.process.env?.DECO_SITE : undefined) ||
|
|
48
|
-
"storefront",
|
|
49
|
-
timings: createServerTimings(),
|
|
50
|
-
flags: [],
|
|
51
|
-
isAdmin,
|
|
52
|
-
debug,
|
|
53
|
-
startedAt: performance.now(),
|
|
54
|
-
};
|
|
55
|
-
}
|
|
@@ -1,133 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Health metrics collection for request tracking and diagnostics.
|
|
3
|
-
*
|
|
4
|
-
* Provides atomic counters for requests (total, inflight, errors)
|
|
5
|
-
* and a health endpoint with cache stats and uptime.
|
|
6
|
-
*
|
|
7
|
-
* @example
|
|
8
|
-
* ```ts
|
|
9
|
-
* import { trackRequest, getHealthMetrics, handleHealthCheck } from "@decocms/start/middleware/healthMetrics";
|
|
10
|
-
*
|
|
11
|
-
* // In middleware:
|
|
12
|
-
* trackRequest.start();
|
|
13
|
-
* const response = await next();
|
|
14
|
-
* trackRequest.end(response.status);
|
|
15
|
-
* ```
|
|
16
|
-
*/
|
|
17
|
-
|
|
18
|
-
import { getLoaderCacheStats } from "../sdk/cachedLoader";
|
|
19
|
-
|
|
20
|
-
// ---------------------------------------------------------------------------
|
|
21
|
-
// Counters
|
|
22
|
-
// ---------------------------------------------------------------------------
|
|
23
|
-
|
|
24
|
-
let totalRequests = 0;
|
|
25
|
-
let inflightRequests = 0;
|
|
26
|
-
let totalErrors = 0;
|
|
27
|
-
const startedAt = Date.now();
|
|
28
|
-
|
|
29
|
-
const statusCounts: Record<string, number> = {};
|
|
30
|
-
|
|
31
|
-
export const trackRequest = {
|
|
32
|
-
start() {
|
|
33
|
-
totalRequests++;
|
|
34
|
-
inflightRequests++;
|
|
35
|
-
},
|
|
36
|
-
|
|
37
|
-
end(status: number) {
|
|
38
|
-
inflightRequests--;
|
|
39
|
-
const bucket = `${Math.floor(status / 100)}xx`;
|
|
40
|
-
statusCounts[bucket] = (statusCounts[bucket] || 0) + 1;
|
|
41
|
-
if (status >= 500) totalErrors++;
|
|
42
|
-
},
|
|
43
|
-
};
|
|
44
|
-
|
|
45
|
-
// ---------------------------------------------------------------------------
|
|
46
|
-
// Metrics access
|
|
47
|
-
// ---------------------------------------------------------------------------
|
|
48
|
-
|
|
49
|
-
export interface HealthMetrics {
|
|
50
|
-
uptime: number;
|
|
51
|
-
uptimeHuman: string;
|
|
52
|
-
requests: {
|
|
53
|
-
total: number;
|
|
54
|
-
inflight: number;
|
|
55
|
-
errors: number;
|
|
56
|
-
statusCodes: Record<string, number>;
|
|
57
|
-
};
|
|
58
|
-
cache: {
|
|
59
|
-
entries: number;
|
|
60
|
-
inflight: number;
|
|
61
|
-
estimatedBytes: number;
|
|
62
|
-
maxBytes: number;
|
|
63
|
-
};
|
|
64
|
-
memory?: {
|
|
65
|
-
rss: number;
|
|
66
|
-
heapUsed: number;
|
|
67
|
-
heapTotal: number;
|
|
68
|
-
};
|
|
69
|
-
}
|
|
70
|
-
|
|
71
|
-
function formatUptime(ms: number): string {
|
|
72
|
-
const seconds = Math.floor(ms / 1000);
|
|
73
|
-
const h = Math.floor(seconds / 3600);
|
|
74
|
-
const m = Math.floor((seconds % 3600) / 60);
|
|
75
|
-
const s = seconds % 60;
|
|
76
|
-
return `${h}h ${m}m ${s}s`;
|
|
77
|
-
}
|
|
78
|
-
|
|
79
|
-
export function getHealthMetrics(): HealthMetrics {
|
|
80
|
-
const uptime = Date.now() - startedAt;
|
|
81
|
-
const cacheStats = getLoaderCacheStats();
|
|
82
|
-
|
|
83
|
-
const metrics: HealthMetrics = {
|
|
84
|
-
uptime,
|
|
85
|
-
uptimeHuman: formatUptime(uptime),
|
|
86
|
-
requests: {
|
|
87
|
-
total: totalRequests,
|
|
88
|
-
inflight: inflightRequests,
|
|
89
|
-
errors: totalErrors,
|
|
90
|
-
statusCodes: { ...statusCounts },
|
|
91
|
-
},
|
|
92
|
-
cache: cacheStats,
|
|
93
|
-
};
|
|
94
|
-
|
|
95
|
-
// Memory info is only available in Node.js / Deno environments
|
|
96
|
-
if (typeof globalThis.process !== "undefined" && globalThis.process.memoryUsage) {
|
|
97
|
-
try {
|
|
98
|
-
const mem = globalThis.process.memoryUsage();
|
|
99
|
-
metrics.memory = {
|
|
100
|
-
rss: mem.rss,
|
|
101
|
-
heapUsed: mem.heapUsed,
|
|
102
|
-
heapTotal: mem.heapTotal,
|
|
103
|
-
};
|
|
104
|
-
} catch {
|
|
105
|
-
// not available in this runtime
|
|
106
|
-
}
|
|
107
|
-
}
|
|
108
|
-
|
|
109
|
-
return metrics;
|
|
110
|
-
}
|
|
111
|
-
|
|
112
|
-
// ---------------------------------------------------------------------------
|
|
113
|
-
// Health check handler
|
|
114
|
-
// ---------------------------------------------------------------------------
|
|
115
|
-
|
|
116
|
-
/**
|
|
117
|
-
* Handle `/deco/_health` requests with detailed metrics.
|
|
118
|
-
* Returns null for non-matching requests.
|
|
119
|
-
*/
|
|
120
|
-
export function handleHealthCheck(request: Request): Response | null {
|
|
121
|
-
const url = new URL(request.url);
|
|
122
|
-
if (url.pathname !== "/deco/_health") return null;
|
|
123
|
-
|
|
124
|
-
const metrics = getHealthMetrics();
|
|
125
|
-
|
|
126
|
-
return new Response(JSON.stringify(metrics, null, 2), {
|
|
127
|
-
status: 200,
|
|
128
|
-
headers: {
|
|
129
|
-
"Content-Type": "application/json",
|
|
130
|
-
"Cache-Control": "no-store",
|
|
131
|
-
},
|
|
132
|
-
});
|
|
133
|
-
}
|
|
@@ -1,79 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Hydration context utilities for consistent SSR/client rendering.
|
|
3
|
-
*
|
|
4
|
-
* Provides patterns for extracting locale, timezone, and other
|
|
5
|
-
* request-specific data that must be consistent between server
|
|
6
|
-
* and client to avoid hydration mismatches.
|
|
7
|
-
*
|
|
8
|
-
* @example
|
|
9
|
-
* ```tsx
|
|
10
|
-
* // In your storefront's middleware.ts:
|
|
11
|
-
* import { createMiddleware } from "@tanstack/react-start";
|
|
12
|
-
* import { buildHydrationContext } from "@decocms/start/middleware/hydrationContext";
|
|
13
|
-
*
|
|
14
|
-
* export const hydrationMiddleware = createMiddleware().server(async ({ request, next }) => {
|
|
15
|
-
* const hydrationCtx = buildHydrationContext(request);
|
|
16
|
-
* return next({ context: { hydration: hydrationCtx } });
|
|
17
|
-
* });
|
|
18
|
-
* ```
|
|
19
|
-
*
|
|
20
|
-
* Then in components:
|
|
21
|
-
* ```tsx
|
|
22
|
-
* // Use the cookie-based values for deterministic SSR rendering
|
|
23
|
-
* const locale = hydrationCtx.locale; // same on server and client
|
|
24
|
-
* ```
|
|
25
|
-
*/
|
|
26
|
-
|
|
27
|
-
export interface HydrationContext {
|
|
28
|
-
/** Locale from cookie or Accept-Language header. */
|
|
29
|
-
locale: string;
|
|
30
|
-
/** Timezone from cookie. Falls back to "UTC" for deterministic SSR. */
|
|
31
|
-
timeZone: string;
|
|
32
|
-
/** Country code from Cloudflare headers or cookie. */
|
|
33
|
-
country?: string;
|
|
34
|
-
}
|
|
35
|
-
|
|
36
|
-
/**
|
|
37
|
-
* Build hydration context from a request.
|
|
38
|
-
*
|
|
39
|
-
* Values are extracted from cookies first (set by the client on first visit),
|
|
40
|
-
* then from headers. Cookie-based values are deterministic because the same
|
|
41
|
-
* cookie is sent on both SSR and client-side navigations.
|
|
42
|
-
*
|
|
43
|
-
* Recommended: set these cookies on first client render:
|
|
44
|
-
* ```tsx
|
|
45
|
-
* useEffect(() => {
|
|
46
|
-
* const tz = Intl.DateTimeFormat().resolvedOptions().timeZone;
|
|
47
|
-
* document.cookie = `tz=${tz}; path=/; max-age=31536000; SameSite=Lax`;
|
|
48
|
-
* document.cookie = `locale=${navigator.language}; path=/; max-age=31536000; SameSite=Lax`;
|
|
49
|
-
* }, []);
|
|
50
|
-
* ```
|
|
51
|
-
*/
|
|
52
|
-
export function buildHydrationContext(request: Request): HydrationContext {
|
|
53
|
-
const cookies = parseCookies(request.headers.get("cookie") ?? "");
|
|
54
|
-
|
|
55
|
-
// Locale: cookie → Accept-Language → fallback
|
|
56
|
-
const locale =
|
|
57
|
-
cookies.locale ||
|
|
58
|
-
request.headers.get("accept-language")?.split(",")[0]?.split(";")[0]?.trim() ||
|
|
59
|
-
"en-US";
|
|
60
|
-
|
|
61
|
-
// Timezone: cookie → UTC fallback (never guess — causes hydration mismatch)
|
|
62
|
-
const timeZone = cookies.tz || "UTC";
|
|
63
|
-
|
|
64
|
-
// Country: Cloudflare header → cookie
|
|
65
|
-
const country =
|
|
66
|
-
request.headers.get("cf-ipcountry") || cookies.country || undefined;
|
|
67
|
-
|
|
68
|
-
return { locale, timeZone, country };
|
|
69
|
-
}
|
|
70
|
-
|
|
71
|
-
function parseCookies(cookieHeader: string): Record<string, string> {
|
|
72
|
-
const cookies: Record<string, string> = {};
|
|
73
|
-
for (const part of cookieHeader.split(";")) {
|
|
74
|
-
const [key, ...rest] = part.split("=");
|
|
75
|
-
const k = key?.trim();
|
|
76
|
-
if (k) cookies[k] = rest.join("=").trim();
|
|
77
|
-
}
|
|
78
|
-
return cookies;
|
|
79
|
-
}
|
package/src/middleware/index.ts
DELETED
|
@@ -1,88 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Deco middleware utilities for TanStack Start.
|
|
3
|
-
*
|
|
4
|
-
* These are NOT TanStack `createMiddleware()` instances because
|
|
5
|
-
* `@decocms/start` doesn't depend on `@tanstack/react-start`.
|
|
6
|
-
* Instead, they export composable handler functions that storefronts
|
|
7
|
-
* wire into their own `createMiddleware()` chain.
|
|
8
|
-
*
|
|
9
|
-
* @example
|
|
10
|
-
* ```ts
|
|
11
|
-
* // In your storefront's middleware.ts
|
|
12
|
-
* import { createMiddleware } from "@tanstack/react-start";
|
|
13
|
-
* import { buildDecoState, handleLiveness, applyServerTiming, applyCorsHeaders } from "@decocms/start/middleware";
|
|
14
|
-
*
|
|
15
|
-
* export const decoMiddleware = createMiddleware().server(async ({ request, next }) => {
|
|
16
|
-
* const liveness = handleLiveness(request);
|
|
17
|
-
* if (liveness) return { result: undefined, response: liveness };
|
|
18
|
-
*
|
|
19
|
-
* const state = buildDecoState(request, "my-site");
|
|
20
|
-
* const endTotal = state.timings.start("total");
|
|
21
|
-
*
|
|
22
|
-
* const result = await next();
|
|
23
|
-
*
|
|
24
|
-
* endTotal();
|
|
25
|
-
* applyServerTiming(result.response, state);
|
|
26
|
-
* if (state.isAdmin) applyCorsHeaders(result.response, request);
|
|
27
|
-
*
|
|
28
|
-
* return result;
|
|
29
|
-
* });
|
|
30
|
-
* ```
|
|
31
|
-
*/
|
|
32
|
-
|
|
33
|
-
export {
|
|
34
|
-
type CacheDecision,
|
|
35
|
-
configureMeter,
|
|
36
|
-
configureTracer,
|
|
37
|
-
getActiveSpan,
|
|
38
|
-
getMeter,
|
|
39
|
-
getTracer,
|
|
40
|
-
injectTraceContext,
|
|
41
|
-
logRequest,
|
|
42
|
-
type MeterAdapter,
|
|
43
|
-
MetricNames,
|
|
44
|
-
recordCacheMetric,
|
|
45
|
-
recordRequestMetric,
|
|
46
|
-
type Span,
|
|
47
|
-
setSpanAttribute,
|
|
48
|
-
type TracerAdapter,
|
|
49
|
-
withTracing,
|
|
50
|
-
} from "../sdk/observability";
|
|
51
|
-
export { buildDecoState, type DecoState } from "./decoState";
|
|
52
|
-
export {
|
|
53
|
-
getHealthMetrics,
|
|
54
|
-
type HealthMetrics,
|
|
55
|
-
handleHealthCheck,
|
|
56
|
-
trackRequest,
|
|
57
|
-
} from "./healthMetrics";
|
|
58
|
-
export { buildHydrationContext, type HydrationContext } from "./hydrationContext";
|
|
59
|
-
export { handleLiveness } from "./liveness";
|
|
60
|
-
export {
|
|
61
|
-
createSectionValidator,
|
|
62
|
-
type DeferredSectionInput,
|
|
63
|
-
validateDeferredSectionInput,
|
|
64
|
-
} from "./validateSection";
|
|
65
|
-
|
|
66
|
-
/**
|
|
67
|
-
* Appends Server-Timing header to a response from the accumulated timings.
|
|
68
|
-
*/
|
|
69
|
-
export function applyServerTiming(response: Response, state: { timings: { toHeader(): string } }) {
|
|
70
|
-
const header = state.timings.toHeader();
|
|
71
|
-
if (header) {
|
|
72
|
-
response.headers.append("Server-Timing", header);
|
|
73
|
-
}
|
|
74
|
-
}
|
|
75
|
-
|
|
76
|
-
/**
|
|
77
|
-
* Applies CORS headers for deco admin origins to a response.
|
|
78
|
-
*/
|
|
79
|
-
export function applyCorsHeaders(response: Response, request: Request) {
|
|
80
|
-
const origin = request.headers.get("origin") || "*";
|
|
81
|
-
response.headers.set("Access-Control-Allow-Origin", origin);
|
|
82
|
-
response.headers.set("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
|
|
83
|
-
response.headers.set(
|
|
84
|
-
"Access-Control-Allow-Headers",
|
|
85
|
-
"Content-Type, Authorization, If-None-Match",
|
|
86
|
-
);
|
|
87
|
-
response.headers.set("Access-Control-Allow-Credentials", "true");
|
|
88
|
-
}
|
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Liveness and readiness probe handlers.
|
|
3
|
-
*
|
|
4
|
-
* - `/_liveness` — simple 200 OK for load balancers (K8s, Cloudflare)
|
|
5
|
-
* - `/deco/_health` — detailed JSON health metrics (delegated to healthMetrics)
|
|
6
|
-
*/
|
|
7
|
-
|
|
8
|
-
import { handleHealthCheck } from "./healthMetrics";
|
|
9
|
-
|
|
10
|
-
export function handleLiveness(request: Request): Response | null {
|
|
11
|
-
const url = new URL(request.url);
|
|
12
|
-
|
|
13
|
-
if (url.pathname === "/_liveness" || url.pathname === "/deco/_liveness") {
|
|
14
|
-
return new Response("OK", {
|
|
15
|
-
status: 200,
|
|
16
|
-
headers: { "Content-Type": "text/plain", "Cache-Control": "no-store" },
|
|
17
|
-
});
|
|
18
|
-
}
|
|
19
|
-
|
|
20
|
-
return handleHealthCheck(request);
|
|
21
|
-
}
|