@sigil-dev/grimoire 0.9.28 → 0.9.30
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/bin/sigil.ts +4 -0
- package/index.ts +16 -10
- package/package.json +14 -6
- package/server.ts +2 -2
- package/src/adapters/bun.ts +17 -17
- package/src/adapters/static.ts +41 -41
- package/src/adapters/types.ts +36 -36
- package/src/base.ts +4 -1
- package/src/client/csrf.ts +47 -47
- package/src/client/deferred.ts +1 -4
- package/src/client/enhance.ts +160 -160
- package/src/client/router.ts +927 -926
- package/src/config-file.ts +84 -0
- package/src/dev/compile-module.ts +199 -193
- package/src/dev/hmr-client.ts +229 -229
- package/src/dev/hmr-server.ts +274 -266
- package/src/dev/loader.ts +144 -144
- package/src/dev/runtime-bundle.ts +5 -3
- package/src/duration.ts +46 -0
- package/src/env/modules.ts +62 -62
- package/src/env/required.ts +42 -42
- package/src/env/typegen.ts +61 -61
- package/src/headers.ts +105 -105
- package/src/logger/transports.ts +117 -117
- package/src/plugin-order.ts +88 -0
- package/src/rendering/head.ts +49 -49
- package/src/rendering/hydrate.ts +162 -162
- package/src/rendering/images.ts +43 -43
- package/src/rendering/preload.ts +22 -8
- package/src/rendering/ssrPlugin.ts +107 -107
- package/src/rendering/timing.ts +40 -40
- package/src/routing/route-ids.ts +65 -0
- package/src/routing/route.ts +65 -0
- package/src/routing/router.ts +84 -32
- package/src/routing/scanner.ts +18 -5
- package/src/routing/transform-routes.ts +102 -102
- package/src/server/after-response.ts +206 -206
- package/src/server/asset-cache.ts +57 -57
- package/src/server/build.ts +304 -295
- package/src/server/cached.ts +114 -114
- package/src/server/client-address.ts +82 -82
- package/src/server/client-dir.ts +63 -63
- package/src/server/client-entry.ts +44 -44
- package/src/server/context.ts +18 -10
- package/src/server/cookie-utils.ts +80 -80
- package/src/server/coordinator.ts +476 -476
- package/src/server/hooks.ts +122 -122
- package/src/server/index.ts +8 -0
- package/src/server/plugins.ts +172 -172
- package/src/server/prerender.ts +473 -473
- package/src/server/reserved.ts +17 -17
- package/src/server/resolver.ts +149 -123
- package/src/server/rewrite.ts +28 -28
- package/src/server/warm.ts +9 -3
- package/src/server/with-headers.ts +27 -27
- package/src/server/worker.ts +2 -6
- package/src/server-only.ts +78 -0
- package/src/testing/dom.ts +73 -73
- package/src/testing/index.ts +169 -169
- package/src/testing/server.ts +1 -0
- package/src/typegen/index.ts +97 -2
- package/src/types.ts +140 -19
- package/test/after-response.test.ts +132 -132
- package/test/asset-cache-policy.test.ts +6 -2
- package/test/base.test.ts +20 -6
- package/test/cached.test.ts +126 -126
- package/test/client-address.test.ts +78 -78
- package/test/client-csrf.test.ts +61 -61
- package/test/client-dir.test.ts +101 -101
- package/test/client-router.test.ts +37 -5
- package/test/config-file.test.ts +84 -0
- package/test/coordinator.test.ts +9 -2
- package/test/deferred.test.ts +4 -2
- package/test/dev-loader.test.ts +30 -30
- package/test/env.test.ts +171 -171
- package/test/force-production.test.ts +7 -2
- package/test/images.test.ts +20 -8
- package/test/locals-header.test.ts +61 -61
- package/test/middleware.test.ts +243 -243
- package/test/parser-plugins.test.ts +98 -92
- package/test/plugin-handle.test.ts +62 -62
- package/test/plugin-order.test.ts +98 -0
- package/test/plugin-routes.test.ts +47 -42
- package/test/plugin-services-context.test.ts +7 -2
- package/test/preload.test.ts +4 -1
- package/test/prerender.test.ts +3 -1
- package/test/rendering.test.ts +3 -2
- package/test/required-env.test.ts +32 -32
- package/test/resolver-windows.test.ts +22 -23
- package/test/rewrite-html.test.ts +90 -90
- package/test/route-group-layouts.test.ts +38 -36
- package/test/route.test.ts +103 -0
- package/test/routing.test.ts +225 -197
- package/test/scanning.test.ts +53 -33
- package/test/server-context.test.ts +22 -0
- package/test/server-only.test.ts +110 -0
- package/test/server.test.ts +640 -640
- package/test/services.test.ts +3 -3
- package/test/streaming.test.ts +11 -6
- package/test/testing-helpers.test.ts +166 -166
- package/test/typegen.test.ts +209 -112
- package/test/warm.test.ts +96 -96
- package/test/worker-context.test.ts +59 -59
- package/test/workspace-files.test.ts +26 -10
- package/test/workspace-versions.test.ts +146 -131
|
@@ -1,57 +1,57 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* The cache policy for files served out of public/.
|
|
3
|
-
*
|
|
4
|
-
* Extracted from the server so the decision can be tested without booting
|
|
5
|
-
* one, and so there is exactly one copy of it. A policy test that keeps its
|
|
6
|
-
* own duplicate of the logic passes forever regardless of what the server
|
|
7
|
-
* does, which is worse than having no test.
|
|
8
|
-
*/
|
|
9
|
-
|
|
10
|
-
/**
|
|
11
|
-
* A URL that changes whenever its content changes: a build-stamped hash, or
|
|
12
|
-
* a version query the app bumps per deploy.
|
|
13
|
-
*
|
|
14
|
-
* `?v=` deliberately counts. A file that a caller knows to re-request under
|
|
15
|
-
* a new query is content-addressed by that query, and that is the same
|
|
16
|
-
* guarantee a hash gives — the URL is the key. Requiring a literal hash in
|
|
17
|
-
* the path would send every project that uses the query form back to
|
|
18
|
-
* revalidation for no reason.
|
|
19
|
-
*/
|
|
20
|
-
export function isContentAddressed(pathname: string, search: string): boolean {
|
|
21
|
-
// /style.a1b2c3d4.css — a hash inserted before the extension.
|
|
22
|
-
if (/\.[0-9a-f]{8,}\.[a-z0-9]+$/i.test(pathname)) return true;
|
|
23
|
-
// /__grimoire__/chunk-jp4kgm87.js — the name the bundler gives a shared
|
|
24
|
-
// chunk: "chunk-" and a hash of the contents. Anchored on the prefix, since
|
|
25
|
-
// a bare "8+ letters before the extension" would also match hero-background.png.
|
|
26
|
-
if (/(^|\/)chunk-[a-z0-9]{8,}\.[a-z0-9]+$/i.test(pathname)) return true;
|
|
27
|
-
// /__grimoire__/hydrate-a1b2c3d4.js — an entry named by its contents
|
|
28
|
-
if (/^\/__grimoire__\/[a-z]+-[a-z0-9]{8,}\.js$/i.test(pathname)) return true;
|
|
29
|
-
// A non-empty version query, e.g. /style.css?v=3. Deliberately does not
|
|
30
|
-
// treat `?` with an empty value as addressed: /style.css? is the same
|
|
31
|
-
// URL and would cache forever without ever changing.
|
|
32
|
-
return /[?&]v=[^&#]+/.test(search);
|
|
33
|
-
}
|
|
34
|
-
|
|
35
|
-
/** The `Cache-Control` for a public asset, by its URL. */
|
|
36
|
-
export function cacheControlFor(
|
|
37
|
-
pathname: string,
|
|
38
|
-
search: string,
|
|
39
|
-
): "no-cache" | "immutable" | "revalidate" {
|
|
40
|
-
// The document is what references the assets. Caching it hard means
|
|
41
|
-
// serving stale references to assets that are long gone.
|
|
42
|
-
if (pathname === "/" || pathname.endsWith(".html")) return "no-cache";
|
|
43
|
-
if (isContentAddressed(pathname, search)) return "immutable";
|
|
44
|
-
// Cached, but revalidated every time. Costs a conditional request and
|
|
45
|
-
// guarantees a deploy is visible on the next load — the right trade for a
|
|
46
|
-
// file whose URL is not content-addressed.
|
|
47
|
-
return "revalidate";
|
|
48
|
-
}
|
|
49
|
-
|
|
50
|
-
export const CACHE_CONTROL: Record<
|
|
51
|
-
ReturnType<typeof cacheControlFor>,
|
|
52
|
-
string
|
|
53
|
-
> = {
|
|
54
|
-
"no-cache": "no-cache",
|
|
55
|
-
immutable: "public, max-age=31536000, immutable",
|
|
56
|
-
revalidate: "public, max-age=0, must-revalidate",
|
|
57
|
-
};
|
|
1
|
+
/**
|
|
2
|
+
* The cache policy for files served out of public/.
|
|
3
|
+
*
|
|
4
|
+
* Extracted from the server so the decision can be tested without booting
|
|
5
|
+
* one, and so there is exactly one copy of it. A policy test that keeps its
|
|
6
|
+
* own duplicate of the logic passes forever regardless of what the server
|
|
7
|
+
* does, which is worse than having no test.
|
|
8
|
+
*/
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* A URL that changes whenever its content changes: a build-stamped hash, or
|
|
12
|
+
* a version query the app bumps per deploy.
|
|
13
|
+
*
|
|
14
|
+
* `?v=` deliberately counts. A file that a caller knows to re-request under
|
|
15
|
+
* a new query is content-addressed by that query, and that is the same
|
|
16
|
+
* guarantee a hash gives — the URL is the key. Requiring a literal hash in
|
|
17
|
+
* the path would send every project that uses the query form back to
|
|
18
|
+
* revalidation for no reason.
|
|
19
|
+
*/
|
|
20
|
+
export function isContentAddressed(pathname: string, search: string): boolean {
|
|
21
|
+
// /style.a1b2c3d4.css — a hash inserted before the extension.
|
|
22
|
+
if (/\.[0-9a-f]{8,}\.[a-z0-9]+$/i.test(pathname)) return true;
|
|
23
|
+
// /__grimoire__/chunk-jp4kgm87.js — the name the bundler gives a shared
|
|
24
|
+
// chunk: "chunk-" and a hash of the contents. Anchored on the prefix, since
|
|
25
|
+
// a bare "8+ letters before the extension" would also match hero-background.png.
|
|
26
|
+
if (/(^|\/)chunk-[a-z0-9]{8,}\.[a-z0-9]+$/i.test(pathname)) return true;
|
|
27
|
+
// /__grimoire__/hydrate-a1b2c3d4.js — an entry named by its contents
|
|
28
|
+
if (/^\/__grimoire__\/[a-z]+-[a-z0-9]{8,}\.js$/i.test(pathname)) return true;
|
|
29
|
+
// A non-empty version query, e.g. /style.css?v=3. Deliberately does not
|
|
30
|
+
// treat `?` with an empty value as addressed: /style.css? is the same
|
|
31
|
+
// URL and would cache forever without ever changing.
|
|
32
|
+
return /[?&]v=[^&#]+/.test(search);
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
/** The `Cache-Control` for a public asset, by its URL. */
|
|
36
|
+
export function cacheControlFor(
|
|
37
|
+
pathname: string,
|
|
38
|
+
search: string,
|
|
39
|
+
): "no-cache" | "immutable" | "revalidate" {
|
|
40
|
+
// The document is what references the assets. Caching it hard means
|
|
41
|
+
// serving stale references to assets that are long gone.
|
|
42
|
+
if (pathname === "/" || pathname.endsWith(".html")) return "no-cache";
|
|
43
|
+
if (isContentAddressed(pathname, search)) return "immutable";
|
|
44
|
+
// Cached, but revalidated every time. Costs a conditional request and
|
|
45
|
+
// guarantees a deploy is visible on the next load — the right trade for a
|
|
46
|
+
// file whose URL is not content-addressed.
|
|
47
|
+
return "revalidate";
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
export const CACHE_CONTROL: Record<
|
|
51
|
+
ReturnType<typeof cacheControlFor>,
|
|
52
|
+
string
|
|
53
|
+
> = {
|
|
54
|
+
"no-cache": "no-cache",
|
|
55
|
+
immutable: "public, max-age=31536000, immutable",
|
|
56
|
+
revalidate: "public, max-age=0, must-revalidate",
|
|
57
|
+
};
|