@sylphx/next 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) Sylphx
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,96 @@
1
+ # @sylphx/next
2
+
3
+ Next.js caching that works when your app runs on more than one replica. It
4
+ stores the ISR page cache, the data cache (`fetch`), route handler responses
5
+ and `'use cache'` entries in your Sylphx KV namespace, and puts large bodies in
6
+ a Sylphx Bucket. Every replica reads the same cache, and `revalidateTag` /
7
+ `revalidatePath` on one replica takes effect on all of them.
8
+
9
+ Works with Next.js 14.1 and later (`cacheHandler`), and Next.js 16
10
+ (`cacheHandlers` for `'use cache'`). Node.js runtime only.
11
+
12
+ ## Set up
13
+
14
+ 1. Create a KV namespace and bind it to the Service. The platform then sets
15
+ `REDIS_URL` (also `CACHE_URL`) to the namespace's private Valkey address, so
16
+ a cache lookup stays inside the cluster and is one network round trip.
17
+ Optionally create a Bucket for large pages.
18
+ 2. Set these environment variables on the Service if you use a Bucket, or a
19
+ namespace that is not bound:
20
+
21
+ | Variable | Value |
22
+ | --- | --- |
23
+ | `NEXT_CACHE_BUCKET` | optional: the Bucket id for bodies over 256 KiB. Without it every body stays in KV. Uses the Data API with `SYLPHX_SECRET_KEY` (needs `data:read`, `data:write`) |
24
+ | `NEXT_CACHE_KV_NAME` | only when `REDIS_URL` is not set: the namespace's full name, `orgs/*/projects/*/envs/*/kv_namespaces/*`; its endpoint is fetched once with `connect` |
25
+ 3. Install and configure:
26
+
27
+ ```sh
28
+ npm install @sylphx/next redis # KV over Valkey
29
+ npm install @sylphx/sdk # only for a Bucket or NEXT_CACHE_KV_NAME
30
+ ```
31
+
32
+ ```js
33
+ // next.config.js
34
+ module.exports = {
35
+ cacheHandler: require.resolve('@sylphx/next/cache-handler'),
36
+ cacheMaxMemorySize: 0, // keep the per-replica memory cache off so replicas agree
37
+ // Next.js 16 only, for 'use cache':
38
+ cacheHandlers: {
39
+ default: require.resolve('@sylphx/next/use-cache-handler'),
40
+ remote: require.resolve('@sylphx/next/use-cache-handler'),
41
+ },
42
+ }
43
+ ```
44
+
45
+ `redis` (node-redis) is used because it is the client the Valkey and Redis
46
+ projects maintain, it pipelines commands on one socket, and it speaks TLS
47
+ (`rediss://`) without extra setup.
48
+
49
+ ## How it works
50
+
51
+ - Each entry is one KV row. A body larger than `blobThresholdBytes` is written
52
+ to the Bucket and the KV row points to it.
53
+ - `revalidateTag(tag)` writes the current time to a KV row for that tag. Every
54
+ `get` reads the tag rows for the entry and treats an entry written before that
55
+ time as stale, so no replica has to be told. A stale page is served once while
56
+ it is rebuilt; a stale `fetch` entry is refetched.
57
+ - Entries of a different build are never read, so a new release does not serve
58
+ old HTML that points at removed chunks. The build id is the first that
59
+ exists of `SYLPHX_IMAGE_DIGEST`, `SYLPHX_DEPLOYMENT_ID`,
60
+ `SYLPHX_GIT_COMMIT_SHA`, `.next/BUILD_ID`; with none the server fails to start
61
+ with a clear error (there is no shared default). Tag times are shared.
62
+ - A lookup is one `MGET` for the entry and its tags. A replica remembers each
63
+ key's tags after it first reads it; the first read of a key, or of an entry
64
+ whose tags changed, costs a second `MGET`.
65
+ - Entries are kept for 30 days (`retentionSeconds`). Next.js decides when a
66
+ page is due for revalidation from its own `revalidate` time, so a stale page
67
+ stays available to serve while it is rebuilt.
68
+ - If KV or the Bucket is unreachable, a read counts as a miss (the page is
69
+ rendered) and a failed write is logged. `revalidateTag` throws, so you learn
70
+ that an invalidation did not land.
71
+ - Replica clocks should agree within a second or so; tag and write times are
72
+ compared across replicas.
73
+
74
+ ## Options
75
+
76
+ To change a default, make your own file and point `cacheHandler` at it:
77
+
78
+ ```js
79
+ // cache-handler.mjs
80
+ import { createCacheHandler } from '@sylphx/next'
81
+ export default createCacheHandler({
82
+ prefix: 'next:web', // give each app sharing a namespace its own prefix
83
+ blobThresholdBytes: 512 * 1024,
84
+ retentionSeconds: 7 * 24 * 3600,
85
+ })
86
+ ```
87
+
88
+ `kv` and `objects` accept any object with the `KvStore` / `ObjectStore` shape
89
+ (see `src/stores.ts`): `redisKv(client)` is the default; `sdkKv(client, namespaceId)`
90
+ is the Data API item routes as an alternative, which is also how the tests
91
+ run without a network.
92
+ Use `createUseCacheHandler` the same way for `cacheHandlers`.
93
+
94
+ Bodies removed from the Bucket when replaced are deleted on a best-effort
95
+ basis. If a replica dies between the two writes an unreferenced object can
96
+ remain; set a Bucket lifecycle rule if that matters.
@@ -0,0 +1,11 @@
1
+ declare const _default: {
2
+ new (_nextContext?: unknown): {
3
+ get(key: string, ctx?: import("./isr.js").GetContext): Promise<import("./isr.js").IsrEntry | null>;
4
+ set(key: string, data: import("./isr.js").CacheData | null, ctx?: import("./isr.js").SetContext): Promise<void>;
5
+ revalidateTag(tags: string | string[], durations?: {
6
+ expire?: number;
7
+ }): Promise<void>;
8
+ resetRequestCache(): void;
9
+ };
10
+ };
11
+ export default _default;
@@ -0,0 +1,4 @@
1
+ // `cacheHandler: require.resolve('@sylphx/next/cache-handler')` in next.config.
2
+ import { createCacheHandler } from './isr.js';
3
+ export default createCacheHandler();
4
+ //# sourceMappingURL=cache-handler.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cache-handler.js","sourceRoot":"","sources":["../src/cache-handler.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAE7C,eAAe,kBAAkB,EAAE,CAAA"}
@@ -0,0 +1,4 @@
1
+ export declare function encode(value: unknown): unknown;
2
+ export declare function decode(value: unknown): unknown;
3
+ export declare const toBytes: (value: unknown) => Uint8Array;
4
+ export declare const fromBytes: (bytes: Uint8Array) => unknown;
package/dist/codec.js ADDED
@@ -0,0 +1,70 @@
1
+ // Next.js cache values hold Buffers, Maps and other non-JSON values (an
2
+ // APP_PAGE entry has a Buffer body and a Map of segment data). This codec turns
3
+ // any such value into JSON text and back, so the handlers can store it as bytes.
4
+ const TAG = '$sx';
5
+ export function encode(value) {
6
+ if (value === null || typeof value !== 'object') {
7
+ if (value === undefined)
8
+ return { [TAG]: 'u' };
9
+ if (typeof value === 'number' && !Number.isFinite(value))
10
+ return { [TAG]: 'n', v: String(value) };
11
+ if (typeof value === 'bigint')
12
+ return { [TAG]: 'i', v: value.toString() };
13
+ return value;
14
+ }
15
+ if (value instanceof Uint8Array)
16
+ return { [TAG]: 'b', v: Buffer.from(value).toString('base64') };
17
+ if (value instanceof ArrayBuffer)
18
+ return { [TAG]: 'b', v: Buffer.from(value).toString('base64') };
19
+ if (value instanceof Map)
20
+ return { [TAG]: 'm', v: [...value].map(([k, v]) => [encode(k), encode(v)]) };
21
+ if (value instanceof Set)
22
+ return { [TAG]: 's', v: [...value].map(encode) };
23
+ if (value instanceof Date)
24
+ return { [TAG]: 'd', v: value.getTime() };
25
+ if (Array.isArray(value))
26
+ return value.map(encode);
27
+ const out = {};
28
+ for (const [k, v] of Object.entries(value))
29
+ out[k] = encode(v);
30
+ // A plain object that already uses the marker key is wrapped so it round-trips.
31
+ return TAG in out ? { [TAG]: 'o', v: out } : out;
32
+ }
33
+ export function decode(value) {
34
+ if (value === null || typeof value !== 'object')
35
+ return value;
36
+ if (Array.isArray(value))
37
+ return value.map(decode);
38
+ const o = value;
39
+ switch (o[TAG]) {
40
+ case 'u':
41
+ return undefined;
42
+ case 'n':
43
+ return Number(o.v);
44
+ case 'i':
45
+ return BigInt(o.v);
46
+ case 'b':
47
+ return Buffer.from(o.v, 'base64');
48
+ case 'm':
49
+ return new Map(o.v.map(([k, v]) => [decode(k), decode(v)]));
50
+ case 's':
51
+ return new Set(o.v.map(decode));
52
+ case 'd':
53
+ return new Date(o.v);
54
+ case 'o': {
55
+ const inner = {};
56
+ for (const [k, v] of Object.entries(o.v))
57
+ inner[k] = decode(v);
58
+ return inner;
59
+ }
60
+ }
61
+ const out = {};
62
+ for (const [k, v] of Object.entries(o))
63
+ out[k] = decode(v);
64
+ return out;
65
+ }
66
+ const enc = new TextEncoder();
67
+ const dec = new TextDecoder();
68
+ export const toBytes = (value) => enc.encode(JSON.stringify(encode(value)));
69
+ export const fromBytes = (bytes) => decode(JSON.parse(dec.decode(bytes)));
70
+ //# sourceMappingURL=codec.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"codec.js","sourceRoot":"","sources":["../src/codec.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,gFAAgF;AAChF,iFAAiF;AAEjF,MAAM,GAAG,GAAG,KAAK,CAAA;AAEjB,MAAM,UAAU,MAAM,CAAC,KAAc;IACpC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACjD,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAA;QAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YACvD,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAA;QACxC,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAA;QACzE,OAAO,KAAK,CAAA;IACb,CAAC;IACD,IAAI,KAAK,YAAY,UAAU;QAAE,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAA;IAChG,IAAI,KAAK,YAAY,WAAW;QAAE,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAA;IACjG,IAAI,KAAK,YAAY,GAAG;QACvB,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC7E,IAAI,KAAK,YAAY,GAAG;QAAE,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAA;IAC1E,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,CAAA;IACpE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAClD,MAAM,GAAG,GAA4B,EAAE,CAAA;IACvC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;IAC9D,gFAAgF;IAChF,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAA;AACjD,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,KAAc;IACpC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IAC7D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAClD,MAAM,CAAC,GAAG,KAAgC,CAAA;IAC1C,QAAQ,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;QAChB,KAAK,GAAG;YACP,OAAO,SAAS,CAAA;QACjB,KAAK,GAAG;YACP,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QACnB,KAAK,GAAG;YACP,OAAO,MAAM,CAAC,CAAC,CAAC,CAAW,CAAC,CAAA;QAC7B,KAAK,GAAG;YACP,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAW,EAAE,QAAQ,CAAC,CAAA;QAC5C,KAAK,GAAG;YACP,OAAO,IAAI,GAAG,CAAE,CAAC,CAAC,CAA0B,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QACtF,KAAK,GAAG;YACP,OAAO,IAAI,GAAG,CAAE,CAAC,CAAC,CAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;QAC/C,KAAK,GAAG;YACP,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,CAAW,CAAC,CAAA;QAC/B,KAAK,GAAG,CAAC,CAAC,CAAC;YACV,MAAM,KAAK,GAA4B,EAAE,CAAA;YACzC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAA4B,CAAC;gBAAE,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;YACzF,OAAO,KAAK,CAAA;QACb,CAAC;IACF,CAAC;IACD,MAAM,GAAG,GAA4B,EAAE,CAAA;IACvC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QAAE,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;IAC1D,OAAO,GAAG,CAAA;AACX,CAAC;AAED,MAAM,GAAG,GAAG,IAAI,WAAW,EAAE,CAAA;AAC7B,MAAM,GAAG,GAAG,IAAI,WAAW,EAAE,CAAA;AAE7B,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,KAAc,EAAc,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AAChG,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAiB,EAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA"}
package/dist/core.d.ts ADDED
@@ -0,0 +1,96 @@
1
+ import { type KvStore, type ObjectStore, type SylphxDataClient } from './stores.js';
2
+ export interface CacheOptions {
3
+ /**
4
+ * The KV store. Default: the namespace's Valkey, at `REDIS_URL` (or `CACHE_URL`), which the platform
5
+ * injects when a namespace is bound; else the URL from `connect` on `NEXT_CACHE_KV_NAME`. Needs the `redis` package.
6
+ */
7
+ kv?: KvStore;
8
+ /** Where bodies larger than `blobThresholdBytes` go. Default: the Bucket named by `NEXT_CACHE_BUCKET` (Data API); without one every body stays in KV. */
9
+ objects?: ObjectStore;
10
+ /** A ready `@sylphx/sdk` client for the Bucket (and `connect`). Default: a new `Sylphx()`. */
11
+ client?: SdkClient;
12
+ /** Start of every key. Default `next:<SYLPHX_SERVICE_NAME or app>`. Give each app in a shared namespace its own. */
13
+ prefix?: string;
14
+ /**
15
+ * Entries of a different build are never read. Default, first that exists: `SYLPHX_IMAGE_DIGEST`,
16
+ * `SYLPHX_DEPLOYMENT_ID`, `SYLPHX_GIT_COMMIT_SHA`, the build id in `<distDir>/BUILD_ID`. None is an error.
17
+ */
18
+ buildId?: string;
19
+ /** Bodies whose stored size is above this many bytes go to the Bucket. Default 262144 (256 KiB). */
20
+ blobThresholdBytes?: number;
21
+ /** The longest an entry is kept, in seconds. Default 30 days. */
22
+ retentionSeconds?: number;
23
+ /** Next.js output directory, where `BUILD_ID` is read. Default `.next` under the working directory. */
24
+ distDir?: string;
25
+ /** Called when a cache read or write fails and the cache falls back to a miss. Default `console.warn`. */
26
+ onError?: (error: unknown, operation: string) => void;
27
+ /** Clock in milliseconds; tests replace it. */
28
+ now?: () => number;
29
+ }
30
+ /** The state of a tag: entries older than `stale` are stale; older than `expired` (once passed) are gone. */
31
+ export interface TagState {
32
+ stale: number;
33
+ expired: number;
34
+ }
35
+ export declare class CacheCore {
36
+ private readonly options;
37
+ readonly prefix: string;
38
+ readonly buildId: string;
39
+ readonly threshold: number;
40
+ readonly retention: number;
41
+ readonly now: () => number;
42
+ readonly onError: (error: unknown, operation: string) => void;
43
+ private stores;
44
+ constructor(options?: CacheOptions);
45
+ private resolve;
46
+ private entryKey;
47
+ private tagKey;
48
+ private blobKey;
49
+ /** Tags each key had when this replica last saw it, so a lookup can ask for them up front. */
50
+ private knownTags;
51
+ private remember;
52
+ /**
53
+ * The entry and the newest tag times for its tags plus `extraTags`, or `undefined` when the entry is
54
+ * absent, unreadable or for another key. One round trip in the steady state: the entry and the tags
55
+ * this replica already knows for the key are read together (MGET); only an entry whose tags
56
+ * changed since needs a second read.
57
+ */
58
+ lookup(key: string, extraTags?: string[]): Promise<{
59
+ payload: unknown;
60
+ tags: string[];
61
+ timestamp: number;
62
+ state: TagState;
63
+ } | undefined>;
64
+ write(key: string, payload: unknown, meta: {
65
+ tags: string[];
66
+ timestamp: number;
67
+ ttlSeconds?: number;
68
+ }): Promise<void>;
69
+ private previousBlob;
70
+ remove(key: string): Promise<void>;
71
+ /** The newest `stale` and `expired` times across `tags`; 0 when none was ever revalidated. */
72
+ tagState(tags: string[]): Promise<TagState>;
73
+ /**
74
+ * Marks tags revalidated now: entries written before now are stale at once.
75
+ * With `expireSeconds` they may still be served until that long from now.
76
+ */
77
+ markTags(tags: string[], expireSeconds?: number): Promise<void>;
78
+ }
79
+ /**
80
+ * The identity of this build. A shared id would serve old HTML that points at
81
+ * chunks a newer deploy removed, so there is no default.
82
+ */
83
+ export declare function resolveBuildId(distDir?: string): string;
84
+ export interface SdkClient extends SylphxDataClient {
85
+ data: SylphxDataClient['data'] & {
86
+ kvNamespaces: {
87
+ connect(r: {
88
+ name: string;
89
+ }): Promise<{
90
+ connectionInfo?: {
91
+ uri?: string;
92
+ };
93
+ }>;
94
+ };
95
+ };
96
+ }
package/dist/core.js ADDED
@@ -0,0 +1,206 @@
1
+ import { createHash, randomUUID } from 'node:crypto';
2
+ import { readFileSync } from 'node:fs';
3
+ import { join } from 'node:path';
4
+ import { fromBytes, toBytes } from './codec.js';
5
+ import { redisKv, sdkObjects, } from './stores.js';
6
+ const sha = (s) => createHash('sha256').update(s).digest('hex');
7
+ const DAY = 86_400;
8
+ const text = new TextEncoder();
9
+ const untext = new TextDecoder();
10
+ export class CacheCore {
11
+ options;
12
+ prefix;
13
+ buildId;
14
+ threshold;
15
+ retention;
16
+ now;
17
+ onError;
18
+ stores;
19
+ constructor(options = {}) {
20
+ this.options = options;
21
+ const env = process.env;
22
+ this.prefix = options.prefix ?? `next:${env.SYLPHX_SERVICE_NAME ?? 'app'}`;
23
+ this.buildId = options.buildId ?? resolveBuildId(options.distDir);
24
+ this.threshold = options.blobThresholdBytes ?? 262_144;
25
+ this.retention = options.retentionSeconds ?? 30 * DAY;
26
+ this.now = options.now ?? Date.now;
27
+ this.onError = options.onError ?? ((e, op) => console.warn(`@sylphx/next: ${op} failed:`, e));
28
+ }
29
+ resolve() {
30
+ this.stores ??= (async () => {
31
+ const o = this.options;
32
+ const env = process.env;
33
+ const bucket = env.NEXT_CACHE_BUCKET;
34
+ let client = o.client;
35
+ const sdk = async () => (client ??= await defaultClient());
36
+ let kv = o.kv;
37
+ if (kv === undefined) {
38
+ let url = env.REDIS_URL ?? env.CACHE_URL;
39
+ if (!url && env.NEXT_CACHE_KV_NAME) {
40
+ const r = await (await sdk()).data.kvNamespaces.connect({ name: env.NEXT_CACHE_KV_NAME });
41
+ url = r.connectionInfo?.uri;
42
+ }
43
+ if (!url)
44
+ throw new Error('@sylphx/next: no KV endpoint. Bind a KV namespace (REDIS_URL), set NEXT_CACHE_KV_NAME, or pass `kv`');
45
+ kv = redisKv(await connectRedis(url));
46
+ }
47
+ const objects = o.objects ?? (bucket ? sdkObjects(await sdk(), bucket) : undefined);
48
+ return { kv, objects };
49
+ })();
50
+ // A failed setup is retried by the next call, not remembered.
51
+ const pending = this.stores;
52
+ pending.catch(() => {
53
+ if (this.stores === pending)
54
+ this.stores = undefined;
55
+ });
56
+ return pending;
57
+ }
58
+ entryKey = (key) => `${this.prefix}:${this.buildId}:e:${sha(key)}`;
59
+ tagKey = (tag) => `${this.prefix}:t:${sha(tag)}`;
60
+ blobKey = () => `${this.prefix}/${this.buildId}/${randomUUID()}`;
61
+ /** Tags each key had when this replica last saw it, so a lookup can ask for them up front. */
62
+ knownTags = new Map();
63
+ remember(key, tags) {
64
+ this.knownTags.delete(key);
65
+ this.knownTags.set(key, tags);
66
+ if (this.knownTags.size > 10_000)
67
+ this.knownTags.delete(this.knownTags.keys().next().value);
68
+ }
69
+ /**
70
+ * The entry and the newest tag times for its tags plus `extraTags`, or `undefined` when the entry is
71
+ * absent, unreadable or for another key. One round trip in the steady state: the entry and the tags
72
+ * this replica already knows for the key are read together (MGET); only an entry whose tags
73
+ * changed since needs a second read.
74
+ */
75
+ async lookup(key, extraTags = []) {
76
+ const { kv, objects } = await this.resolve();
77
+ const asked = [...new Set([...(this.knownTags.get(key) ?? []), ...extraTags])];
78
+ const [raw, ...tagRows] = await kv.getMany([this.entryKey(key), ...asked.map(this.tagKey)]);
79
+ if (raw === undefined)
80
+ return undefined;
81
+ const rec = JSON.parse(untext.decode(raw));
82
+ if (rec.v !== 1 || rec.key !== key)
83
+ return undefined;
84
+ this.remember(key, rec.tags);
85
+ const state = foldTags(tagRows);
86
+ const missing = rec.tags.filter((t) => !asked.includes(t));
87
+ if (missing.length > 0) {
88
+ const more = foldTags(await kv.getMany(missing.map(this.tagKey)));
89
+ state.stale = Math.max(state.stale, more.stale);
90
+ state.expired = Math.max(state.expired, more.expired);
91
+ }
92
+ let payloadBytes;
93
+ if (rec.blob !== undefined)
94
+ payloadBytes = await objects?.get(rec.blob);
95
+ else if (rec.payload !== undefined)
96
+ payloadBytes = text.encode(rec.payload);
97
+ if (payloadBytes === undefined)
98
+ return undefined;
99
+ return { payload: fromBytes(payloadBytes), tags: rec.tags, timestamp: rec.timestamp, state };
100
+ }
101
+ async write(key, payload, meta) {
102
+ const { kv, objects } = await this.resolve();
103
+ const bytes = toBytes(payload);
104
+ const rec = { v: 1, key, tags: meta.tags, timestamp: meta.timestamp };
105
+ const large = objects !== undefined && bytes.length > this.threshold;
106
+ if (large) {
107
+ rec.blob = this.blobKey();
108
+ await objects.put(rec.blob, bytes, 'application/json');
109
+ }
110
+ else
111
+ rec.payload = untext.decode(bytes);
112
+ this.remember(key, meta.tags);
113
+ const ttl = Math.min(meta.ttlSeconds ?? this.retention, this.retention);
114
+ const entryKey = this.entryKey(key);
115
+ const previous = objects !== undefined ? await this.previousBlob(kv, entryKey) : undefined;
116
+ await kv.set(entryKey, text.encode(JSON.stringify(rec)), ttl);
117
+ // The old body is unreachable now; removal is best effort.
118
+ if (previous !== undefined && previous !== rec.blob)
119
+ await objects?.delete(previous).catch(() => { });
120
+ }
121
+ async previousBlob(kv, entryKey) {
122
+ try {
123
+ const raw = await kv.get(entryKey);
124
+ return raw === undefined ? undefined : JSON.parse(untext.decode(raw)).blob;
125
+ }
126
+ catch {
127
+ return undefined;
128
+ }
129
+ }
130
+ async remove(key) {
131
+ const { kv } = await this.resolve();
132
+ await kv.delete(this.entryKey(key));
133
+ }
134
+ /** The newest `stale` and `expired` times across `tags`; 0 when none was ever revalidated. */
135
+ async tagState(tags) {
136
+ if (tags.length === 0)
137
+ return { stale: 0, expired: 0 };
138
+ const { kv } = await this.resolve();
139
+ return foldTags(await kv.getMany([...new Set(tags)].map(this.tagKey)));
140
+ }
141
+ /**
142
+ * Marks tags revalidated now: entries written before now are stale at once.
143
+ * With `expireSeconds` they may still be served until that long from now.
144
+ */
145
+ async markTags(tags, expireSeconds) {
146
+ if (tags.length === 0)
147
+ return;
148
+ const { kv } = await this.resolve();
149
+ const at = this.now();
150
+ const state = { stale: at, expired: at + (expireSeconds ?? 0) * 1000 };
151
+ const bytes = text.encode(JSON.stringify(state));
152
+ // A tag row must outlive every entry it can affect.
153
+ const ttl = this.retention + DAY;
154
+ await Promise.all([...new Set(tags)].map((t) => kv.set(this.tagKey(t), bytes, ttl)));
155
+ }
156
+ }
157
+ function foldTags(rows) {
158
+ const state = { stale: 0, expired: 0 };
159
+ for (const raw of rows) {
160
+ if (raw === undefined)
161
+ continue;
162
+ const t = JSON.parse(untext.decode(raw));
163
+ state.stale = Math.max(state.stale, t.stale);
164
+ state.expired = Math.max(state.expired, t.expired);
165
+ }
166
+ return state;
167
+ }
168
+ /**
169
+ * The identity of this build. A shared id would serve old HTML that points at
170
+ * chunks a newer deploy removed, so there is no default.
171
+ */
172
+ export function resolveBuildId(distDir = join(process.cwd(), '.next')) {
173
+ const env = process.env;
174
+ const fromEnv = env.SYLPHX_IMAGE_DIGEST || env.SYLPHX_DEPLOYMENT_ID || env.SYLPHX_GIT_COMMIT_SHA;
175
+ if (fromEnv)
176
+ return fromEnv;
177
+ try {
178
+ const id = readFileSync(join(distDir, 'BUILD_ID'), 'utf8').trim();
179
+ if (id)
180
+ return id;
181
+ }
182
+ catch { }
183
+ throw new Error('@sylphx/next: no build id. Expected SYLPHX_IMAGE_DIGEST, SYLPHX_DEPLOYMENT_ID, SYLPHX_GIT_COMMIT_SHA or .next/BUILD_ID; pass `buildId`');
184
+ }
185
+ async function importPackage(name, hint) {
186
+ try {
187
+ return (await import(/* webpackIgnore: true */ name));
188
+ }
189
+ catch {
190
+ throw new Error(`@sylphx/next: ${hint}`);
191
+ }
192
+ }
193
+ async function connectRedis(url) {
194
+ const { createClient } = await importPackage('redis', 'install the `redis` package (npm install redis), or pass `kv`');
195
+ const client = createClient({ url });
196
+ // A connection error must not crash the server; commands fail and the cache falls back to a miss.
197
+ client.on('error', () => { });
198
+ await client.connect();
199
+ return client;
200
+ }
201
+ async function defaultClient() {
202
+ const mod = await importPackage('@sylphx/sdk', 'install @sylphx/sdk (npm install @sylphx/sdk), or pass `objects`');
203
+ const env = process.env;
204
+ return new mod.Sylphx({ apiKey: env.SYLPHX_API_KEY ?? env.SYLPHX_SECRET_KEY });
205
+ }
206
+ //# sourceMappingURL=core.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAC/C,OAAO,EAIN,OAAO,EAGP,UAAU,GACV,MAAM,aAAa,CAAA;AAgDpB,MAAM,GAAG,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAC/E,MAAM,GAAG,GAAG,MAAM,CAAA;AAClB,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAA;AAC9B,MAAM,MAAM,GAAG,IAAI,WAAW,EAAE,CAAA;AAEhC,MAAM,OAAO,SAAS;IASQ;IARpB,MAAM,CAAQ;IACd,OAAO,CAAQ;IACf,SAAS,CAAQ;IACjB,SAAS,CAAQ;IACjB,GAAG,CAAc;IACjB,OAAO,CAA6C;IACrD,MAAM,CAAwE;IAEtF,YAA6B,UAAwB,EAAE;QAA1B,YAAO,GAAP,OAAO,CAAmB;QACtD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAA;QACvB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,QAAQ,GAAG,CAAC,mBAAmB,IAAI,KAAK,EAAE,CAAA;QAC1E,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QACjE,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,kBAAkB,IAAI,OAAO,CAAA;QACtD,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,gBAAgB,IAAI,EAAE,GAAG,GAAG,CAAA;QACrD,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAA;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,CAAA;IAC9F,CAAC;IAEO,OAAO;QACd,IAAI,CAAC,MAAM,KAAK,CAAC,KAAK,IAAI,EAAE;YAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAA;YACtB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAA;YACvB,MAAM,MAAM,GAAG,GAAG,CAAC,iBAAiB,CAAA;YACpC,IAAI,MAAM,GAAG,CAAC,CAAC,MAAM,CAAA;YACrB,MAAM,GAAG,GAAG,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,KAAK,MAAM,aAAa,EAAE,CAAC,CAAA;YAC1D,IAAI,EAAE,GAAG,CAAC,CAAC,EAAE,CAAA;YACb,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;gBACtB,IAAI,GAAG,GAAG,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,SAAS,CAAA;gBACxC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,kBAAkB,EAAE,CAAC;oBACpC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,kBAAkB,EAAE,CAAC,CAAA;oBACzF,GAAG,GAAG,CAAC,CAAC,cAAc,EAAE,GAAG,CAAA;gBAC5B,CAAC;gBACD,IAAI,CAAC,GAAG;oBACP,MAAM,IAAI,KAAK,CACd,qGAAqG,CACrG,CAAA;gBACF,EAAE,GAAG,OAAO,CAAC,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC,CAAA;YACtC,CAAC;YACD,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;YACnF,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,CAAA;QACvB,CAAC,CAAC,EAAE,CAAA;QACJ,8DAA8D;QAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAA;QAC3B,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE;YAClB,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO;gBAAE,IAAI,CAAC,MAAM,GAAG,SAAS,CAAA;QACrD,CAAC,CAAC,CAAA;QACF,OAAO,OAAO,CAAA;IACf,CAAC;IAEO,QAAQ,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,MAAM,GAAG,CAAC,GAAG,CAAC,EAAE,CAAA;IAClF,MAAM,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,EAAE,CAAA;IAChE,OAAO,GAAG,GAAW,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,IAAI,UAAU,EAAE,EAAE,CAAA;IAEhF,8FAA8F;IACtF,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAA;IAEvC,QAAQ,CAAC,GAAW,EAAE,IAAc;QAC3C,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAC1B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;QAC7B,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,MAAM;YAC/B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAe,CAAC,CAAA;IACrE,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CACX,GAAW,EACX,YAAsB,EAAE;QAExB,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAA;QAC5C,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAAA;QAC9E,MAAM,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;QAC3F,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,SAAS,CAAA;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAW,CAAA;QACpD,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,GAAG,KAAK,GAAG;YAAE,OAAO,SAAS,CAAA;QACpD,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAA;QAC5B,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAA;QAC/B,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;QAC1D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;YACjE,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;YAC/C,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;QACtD,CAAC;QACD,IAAI,YAAoC,CAAA;QACxC,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS;YAAE,YAAY,GAAG,MAAM,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;aAClE,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS;YAAE,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QAC3E,IAAI,YAAY,KAAK,SAAS;YAAE,OAAO,SAAS,CAAA;QAChD,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,CAAA;IAC7F,CAAC;IAED,KAAK,CAAC,KAAK,CACV,GAAW,EACX,OAAgB,EAChB,IAAgE;QAEhE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAA;QAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;QAC9B,MAAM,GAAG,GAAW,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAA;QAC7E,MAAM,KAAK,GAAG,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAA;QACpE,IAAI,KAAK,EAAE,CAAC;YACX,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAA;YACzB,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,kBAAkB,CAAC,CAAA;QACvD,CAAC;;YAAM,GAAG,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACzC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;QAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;QACvE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;QACnC,MAAM,QAAQ,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QAC1F,MAAM,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;QAC7D,2DAA2D;QAC3D,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,GAAG,CAAC,IAAI;YAClD,MAAM,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IACjD,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,EAAW,EAAE,QAAgB;QACvD,IAAI,CAAC;YACJ,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YAClC,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAY,CAAC,IAAI,CAAA;QACvF,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,SAAS,CAAA;QACjB,CAAC;IACF,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACvB,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAA;QACnC,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAA;IACpC,CAAC;IAED,8FAA8F;IAC9F,KAAK,CAAC,QAAQ,CAAC,IAAc;QAC5B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAA;QACtD,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAA;QACnC,OAAO,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;IACvE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ,CAAC,IAAc,EAAE,aAAsB;QACpD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAM;QAC7B,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAA;QACnC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACrB,MAAM,KAAK,GAAa,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,GAAG,CAAC,aAAa,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,CAAA;QAChF,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;QAChD,oDAAoD;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,GAAG,GAAG,CAAA;QAChC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;IACrF,CAAC;CACD;AAED,SAAS,QAAQ,CAAC,IAAgC;IACjD,MAAM,KAAK,GAAa,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAA;IAChD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACxB,IAAI,GAAG,KAAK,SAAS;YAAE,SAAQ;QAC/B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAa,CAAA;QACpD,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAA;QAC5C,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAA;IACnD,CAAC;IACD,OAAO,KAAK,CAAA;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC;IACpE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAA;IACvB,MAAM,OAAO,GAAG,GAAG,CAAC,mBAAmB,IAAI,GAAG,CAAC,oBAAoB,IAAI,GAAG,CAAC,qBAAqB,CAAA;IAChG,IAAI,OAAO;QAAE,OAAO,OAAO,CAAA;IAC3B,IAAI,CAAC;QACJ,MAAM,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAA;QACjE,IAAI,EAAE;YAAE,OAAO,EAAE,CAAA;IAClB,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IACV,MAAM,IAAI,KAAK,CACd,wIAAwI,CACxI,CAAA;AACF,CAAC;AAED,KAAK,UAAU,aAAa,CAAI,IAAY,EAAE,IAAY;IACzD,IAAI,CAAC;QACJ,OAAO,CAAC,MAAM,MAAM,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAM,CAAA;IAC3D,CAAC;IAAC,MAAM,CAAC;QACR,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAA;IACzC,CAAC;AACF,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,GAAW;IACtC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,aAAa,CAKzC,OAAO,EAAE,+DAA+D,CAAC,CAAA;IAC5E,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,GAAG,EAAE,CAAC,CAAA;IACpC,kGAAkG;IAClG,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IAC5B,MAAM,MAAM,CAAC,OAAO,EAAE,CAAA;IACtB,OAAO,MAAM,CAAA;AACd,CAAC;AAQD,KAAK,UAAU,aAAa;IAC3B,MAAM,GAAG,GAAG,MAAM,aAAa,CAC9B,aAAa,EACb,kEAAkE,CAClE,CAAA;IACD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAA;IACvB,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,cAAc,IAAI,GAAG,CAAC,iBAAiB,EAAE,CAAC,CAAA;AAC/E,CAAC"}
@@ -0,0 +1,4 @@
1
+ export { type CacheOptions, resolveBuildId, type SdkClient } from './core.js';
2
+ export { createCacheHandler, type IsrEntry } from './isr.js';
3
+ export { type KvStore, type ObjectStore, type RedisLike, redisKv, type SylphxDataClient, sdkKv, sdkObjects, } from './stores.js';
4
+ export { createUseCacheHandler, type UseCacheEntry } from './use-cache.js';
package/dist/index.js ADDED
@@ -0,0 +1,5 @@
1
+ export { resolveBuildId } from './core.js';
2
+ export { createCacheHandler } from './isr.js';
3
+ export { redisKv, sdkKv, sdkObjects, } from './stores.js';
4
+ export { createUseCacheHandler } from './use-cache.js';
5
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,cAAc,EAAkB,MAAM,WAAW,CAAA;AAC7E,OAAO,EAAE,kBAAkB,EAAiB,MAAM,UAAU,CAAA;AAC5D,OAAO,EAIN,OAAO,EAEP,KAAK,EACL,UAAU,GACV,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,qBAAqB,EAAsB,MAAM,gBAAgB,CAAA"}
package/dist/isr.d.ts ADDED
@@ -0,0 +1,39 @@
1
+ import { type CacheOptions } from './core.js';
2
+ /** What Next.js passes to `get`, in versions 14 to 16. */
3
+ export interface GetContext {
4
+ kind?: string;
5
+ kindHint?: string;
6
+ tags?: string[];
7
+ softTags?: string[];
8
+ }
9
+ /** What Next.js passes to `set`. */
10
+ export interface SetContext {
11
+ tags?: string[];
12
+ revalidate?: number | false;
13
+ }
14
+ export interface CacheData {
15
+ [field: string]: unknown;
16
+ kind?: string;
17
+ headers?: Record<string, string | string[] | undefined>;
18
+ }
19
+ /** The entry Next.js reads back: the stored value and when it was written. */
20
+ export interface IsrEntry {
21
+ lastModified: number;
22
+ value: unknown;
23
+ }
24
+ /**
25
+ * Builds the class for Next.js `cacheHandler` (ISR, route handlers, fetch cache,
26
+ * images). Entries and tag times live in KV (large bodies in a Bucket), so every
27
+ * replica reads the same cache. `revalidateTag` writes a timestamp; `get` compares
28
+ * it with the entry's write time, so no replica needs to be told.
29
+ */
30
+ export declare function createCacheHandler(options?: CacheOptions): {
31
+ new (_nextContext?: unknown): {
32
+ get(key: string, ctx?: GetContext): Promise<IsrEntry | null>;
33
+ set(key: string, data: CacheData | null, ctx?: SetContext): Promise<void>;
34
+ revalidateTag(tags: string | string[], durations?: {
35
+ expire?: number;
36
+ }): Promise<void>;
37
+ resetRequestCache(): void;
38
+ };
39
+ };
package/dist/isr.js ADDED
@@ -0,0 +1,60 @@
1
+ import { CacheCore } from './core.js';
2
+ /** Pages carry their tags in the `x-next-cache-tags` header (comma separated). */
3
+ function headerTags(data) {
4
+ const h = data?.headers?.['x-next-cache-tags'];
5
+ const text = Array.isArray(h) ? h.join(',') : h;
6
+ return text ? text.split(',').filter(Boolean) : [];
7
+ }
8
+ /**
9
+ * Builds the class for Next.js `cacheHandler` (ISR, route handlers, fetch cache,
10
+ * images). Entries and tag times live in KV (large bodies in a Bucket), so every
11
+ * replica reads the same cache. `revalidateTag` writes a timestamp; `get` compares
12
+ * it with the entry's write time, so no replica needs to be told.
13
+ */
14
+ export function createCacheHandler(options = {}) {
15
+ let shared;
16
+ // Created when Next.js first builds the handler, so a missing build id stops the server at startup.
17
+ const make = () => (shared ??= new CacheCore(options));
18
+ return class SylphxCacheHandler {
19
+ // Next.js constructs the handler with its own context object; nothing in it is needed.
20
+ constructor(_nextContext) {
21
+ make();
22
+ }
23
+ async get(key, ctx = {}) {
24
+ try {
25
+ const entry = await make().lookup(key, [...(ctx.tags ?? []), ...(ctx.softTags ?? [])]);
26
+ if (entry === undefined)
27
+ return null;
28
+ const data = entry.payload;
29
+ const { stale } = entry.state;
30
+ if (stale >= entry.timestamp) {
31
+ // A data-cache (fetch) entry must be refetched; a page may be served once
32
+ // while it is rebuilt: lastModified -1 is Next.js's "stale" marker.
33
+ const isFetch = data.kind === 'FETCH' || ctx.kind === 'FETCH' || ctx.kindHint === 'fetch';
34
+ return isFetch ? null : { lastModified: -1, value: data };
35
+ }
36
+ return { lastModified: entry.timestamp, value: data };
37
+ }
38
+ catch (error) {
39
+ make().onError(error, 'get');
40
+ return null;
41
+ }
42
+ }
43
+ async set(key, data, ctx = {}) {
44
+ try {
45
+ if (data === null || data === undefined)
46
+ return await make().remove(key);
47
+ const tags = [...new Set([...(ctx.tags ?? []), ...headerTags(data)])];
48
+ await make().write(key, data, { tags, timestamp: make().now() });
49
+ }
50
+ catch (error) {
51
+ make().onError(error, 'set');
52
+ }
53
+ }
54
+ async revalidateTag(tags, durations) {
55
+ await make().markTags(Array.isArray(tags) ? tags : [tags], durations?.expire);
56
+ }
57
+ resetRequestCache() { }
58
+ };
59
+ }
60
+ //# sourceMappingURL=isr.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"isr.js","sourceRoot":"","sources":["../src/isr.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAqB,MAAM,WAAW,CAAA;AA4BxD,kFAAkF;AAClF,SAAS,UAAU,CAAC,IAAsB;IACzC,MAAM,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,mBAAmB,CAAC,CAAA;IAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC/C,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AACnD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAwB,EAAE;IAC5D,IAAI,MAA6B,CAAA;IACjC,oGAAoG;IACpG,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,CAAC,MAAM,KAAK,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC,CAAA;IACtD,OAAO,MAAM,kBAAkB;QAC9B,uFAAuF;QACvF,YAAY,YAAsB;YACjC,IAAI,EAAE,CAAA;QACP,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,MAAkB,EAAE;YAC1C,IAAI,CAAC;gBACJ,MAAM,KAAK,GAAG,MAAM,IAAI,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;gBACtF,IAAI,KAAK,KAAK,SAAS;oBAAE,OAAO,IAAI,CAAA;gBACpC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAoB,CAAA;gBACvC,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,KAAK,CAAA;gBAC7B,IAAI,KAAK,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;oBAC9B,0EAA0E;oBAC1E,oEAAoE;oBACpE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,CAAA;oBACzF,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;gBAC1D,CAAC;gBACD,OAAO,EAAE,YAAY,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;YACtD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;gBAC5B,OAAO,IAAI,CAAA;YACZ,CAAC;QACF,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,IAAsB,EAAE,MAAkB,EAAE;YAClE,IAAI,CAAC;gBACJ,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS;oBAAE,OAAO,MAAM,IAAI,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;gBACxE,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;gBACrE,MAAM,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;YACjE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;YAC7B,CAAC;QACF,CAAC;QAED,KAAK,CAAC,aAAa,CAAC,IAAuB,EAAE,SAA+B;YAC3E,MAAM,IAAI,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,CAAA;QAC9E,CAAC;QAED,iBAAiB,KAAU,CAAC;KAC5B,CAAA;AACF,CAAC"}
@@ -0,0 +1,78 @@
1
+ /** A byte key-value store with optional expiry. */
2
+ export interface KvStore {
3
+ get(key: string): Promise<Uint8Array | undefined>;
4
+ /** One answer per key, in order; `undefined` for an absent or expired key. */
5
+ getMany(keys: string[]): Promise<(Uint8Array | undefined)[]>;
6
+ /** `ttlSeconds` of 0 or undefined never expires. */
7
+ set(key: string, value: Uint8Array, ttlSeconds?: number): Promise<void>;
8
+ delete(key: string): Promise<void>;
9
+ }
10
+ /** A byte object store. */
11
+ export interface ObjectStore {
12
+ get(key: string): Promise<Uint8Array | undefined>;
13
+ put(key: string, value: Uint8Array, contentType?: string): Promise<void>;
14
+ delete(key: string): Promise<void>;
15
+ }
16
+ /** The part of the `@sylphx/sdk` client the adapters call. */
17
+ export interface SylphxDataClient {
18
+ data: {
19
+ kv: {
20
+ get(r: {
21
+ namespaceId: string;
22
+ key: string;
23
+ }): Promise<{
24
+ value?: {
25
+ value?: string;
26
+ };
27
+ }>;
28
+ getMany(r: {
29
+ namespaceId: string;
30
+ keys: string[];
31
+ }): Promise<{
32
+ values?: {
33
+ value?: string;
34
+ }[];
35
+ }>;
36
+ put(r: {
37
+ namespaceId: string;
38
+ key: string;
39
+ value?: string;
40
+ ttlSeconds?: string;
41
+ }): Promise<unknown>;
42
+ delete(r: {
43
+ namespaceId: string;
44
+ key: string;
45
+ }): Promise<unknown>;
46
+ };
47
+ objects: {
48
+ get(r: {
49
+ bucketId: string;
50
+ key: string;
51
+ }): Promise<{
52
+ body?: string;
53
+ }>;
54
+ put(r: {
55
+ bucketId: string;
56
+ key: string;
57
+ body?: string;
58
+ contentType?: string;
59
+ }): Promise<unknown>;
60
+ delete(r: {
61
+ bucketId: string;
62
+ key: string;
63
+ }): Promise<unknown>;
64
+ };
65
+ };
66
+ }
67
+ export declare function sdkKv(client: SylphxDataClient, namespaceId: string): KvStore;
68
+ export declare function sdkObjects(client: SylphxDataClient, bucketId: string): ObjectStore;
69
+ /** The part of a node-redis client (`redis` v5 or later) the adapter calls. */
70
+ export interface RedisLike {
71
+ sendCommand(args: string[]): Promise<unknown>;
72
+ }
73
+ /**
74
+ * A KV store on the namespace's Valkey. Values are the handlers' own JSON text,
75
+ * stored as UTF-8 strings. `getMany` is one MGET, so a lookup is one round trip.
76
+ * Commands go through `sendCommand`, which is the same in every node-redis 5.x/6.x.
77
+ */
78
+ export declare function redisKv(client: RedisLike): KvStore;
package/dist/stores.js ADDED
@@ -0,0 +1,100 @@
1
+ // The two stores the handlers need, as small interfaces, and their adapters:
2
+ // - KV: the namespace's own Valkey over TLS (default; `redisKv`), or the Data
3
+ // API's item routes (`sdkKv`, an alternative for a namespace with no
4
+ // reachable Valkey endpoint).
5
+ // - Bucket: the Data API's object routes (`sdkObjects`).
6
+ // The interfaces keep the handlers testable without a network.
7
+ const b64 = (bytes) => Buffer.from(bytes).toString('base64');
8
+ const unb64 = (text) => new Uint8Array(Buffer.from(text, 'base64'));
9
+ function isNotFound(e) {
10
+ const err = e;
11
+ return err?.code === 'RESOURCE_NOT_FOUND' || err?.status === 404;
12
+ }
13
+ /** Reads one value; an absent key is `undefined`, any other failure throws. */
14
+ async function orMissing(call) {
15
+ try {
16
+ return await call();
17
+ }
18
+ catch (e) {
19
+ if (isNotFound(e))
20
+ return undefined;
21
+ throw e;
22
+ }
23
+ }
24
+ export function sdkKv(client, namespaceId) {
25
+ const kv = client.data.kv;
26
+ return {
27
+ async get(key) {
28
+ const r = await orMissing(() => kv.get({ namespaceId, key }));
29
+ return r?.value?.value === undefined ? undefined : unb64(r.value.value);
30
+ },
31
+ async getMany(keys) {
32
+ const out = [];
33
+ // The API takes at most 1000 keys per call.
34
+ for (let i = 0; i < keys.length; i += 1000) {
35
+ const chunk = keys.slice(i, i + 1000);
36
+ const r = await kv.getMany({ namespaceId, keys: chunk });
37
+ for (let j = 0; j < chunk.length; j++) {
38
+ const v = r.values?.[j]?.value;
39
+ out.push(v === undefined ? undefined : unb64(v));
40
+ }
41
+ }
42
+ return out;
43
+ },
44
+ async set(key, value, ttlSeconds) {
45
+ const ttl = ttlSeconds !== undefined && ttlSeconds > 0
46
+ ? { ttlSeconds: String(Math.ceil(ttlSeconds)) }
47
+ : {};
48
+ await kv.put({ namespaceId, key, value: b64(value), ...ttl });
49
+ },
50
+ async delete(key) {
51
+ await orMissing(() => kv.delete({ namespaceId, key }));
52
+ },
53
+ };
54
+ }
55
+ export function sdkObjects(client, bucketId) {
56
+ const objects = client.data.objects;
57
+ return {
58
+ async get(key) {
59
+ const r = await orMissing(() => objects.get({ bucketId, key }));
60
+ return r?.body === undefined ? undefined : unb64(r.body);
61
+ },
62
+ async put(key, value, contentType = 'application/octet-stream') {
63
+ await objects.put({ bucketId, key, body: b64(value), contentType });
64
+ },
65
+ async delete(key) {
66
+ await orMissing(() => objects.delete({ bucketId, key }));
67
+ },
68
+ };
69
+ }
70
+ const utf8 = new TextDecoder();
71
+ const utf8e = new TextEncoder();
72
+ /**
73
+ * A KV store on the namespace's Valkey. Values are the handlers' own JSON text,
74
+ * stored as UTF-8 strings. `getMany` is one MGET, so a lookup is one round trip.
75
+ * Commands go through `sendCommand`, which is the same in every node-redis 5.x/6.x.
76
+ */
77
+ export function redisKv(client) {
78
+ const text = (v) => typeof v === 'string' ? utf8e.encode(v) : v instanceof Uint8Array ? v : undefined;
79
+ return {
80
+ async get(key) {
81
+ return text(await client.sendCommand(['GET', key]));
82
+ },
83
+ async getMany(keys) {
84
+ if (keys.length === 0)
85
+ return [];
86
+ const rows = (await client.sendCommand(['MGET', ...keys]));
87
+ return rows.map(text);
88
+ },
89
+ async set(key, value, ttlSeconds) {
90
+ const args = ['SET', key, utf8.decode(value)];
91
+ if (ttlSeconds !== undefined && ttlSeconds > 0)
92
+ args.push('EX', String(Math.ceil(ttlSeconds)));
93
+ await client.sendCommand(args);
94
+ },
95
+ async delete(key) {
96
+ await client.sendCommand(['DEL', key]);
97
+ },
98
+ };
99
+ }
100
+ //# sourceMappingURL=stores.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stores.js","sourceRoot":"","sources":["../src/stores.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ declare const _default: {
2
+ get(cacheKey: string, softTags?: string[]): Promise<import("./use-cache.js").UseCacheEntry | undefined>;
3
+ set(cacheKey: string, pendingEntry: Promise<import("./use-cache.js").UseCacheEntry>): Promise<void>;
4
+ refreshTags(): Promise<void>;
5
+ getExpiration(tags: string[]): Promise<number>;
6
+ updateTags(tags: string[], durations?: {
7
+ expire?: number;
8
+ }): Promise<void>;
9
+ };
10
+ export default _default;
@@ -0,0 +1,4 @@
1
+ // `cacheHandlers: { default: require.resolve('@sylphx/next/use-cache-handler') }` in next.config.
2
+ import { createUseCacheHandler } from './use-cache.js';
3
+ export default createUseCacheHandler();
4
+ //# sourceMappingURL=use-cache-handler.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-cache-handler.js","sourceRoot":"","sources":["../src/use-cache-handler.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAEtD,eAAe,qBAAqB,EAAE,CAAA"}
@@ -0,0 +1,24 @@
1
+ import { type CacheOptions } from './core.js';
2
+ /** Next.js 16 `cacheHandlers` entry (`'use cache'`). */
3
+ export interface UseCacheEntry {
4
+ value: ReadableStream<Uint8Array>;
5
+ tags: string[];
6
+ stale: number;
7
+ timestamp: number;
8
+ expire: number;
9
+ revalidate: number;
10
+ }
11
+ /**
12
+ * Builds the handler object for Next.js 16 `cacheHandlers` (`'use cache'` and
13
+ * `'use cache: remote'`), sharing entries and tag times through KV like the ISR handler.
14
+ */
15
+ export declare function createUseCacheHandler(options?: CacheOptions): {
16
+ get(cacheKey: string, softTags?: string[]): Promise<UseCacheEntry | undefined>;
17
+ set(cacheKey: string, pendingEntry: Promise<UseCacheEntry>): Promise<void>;
18
+ /** Tag times are read on every `get`, so there is nothing to sync ahead of a request. */
19
+ refreshTags(): Promise<void>;
20
+ getExpiration(tags: string[]): Promise<number>;
21
+ updateTags(tags: string[], durations?: {
22
+ expire?: number;
23
+ }): Promise<void>;
24
+ };
@@ -0,0 +1,97 @@
1
+ import { CacheCore } from './core.js';
2
+ async function readAll(stream) {
3
+ const reader = stream.getReader();
4
+ const chunks = [];
5
+ let size = 0;
6
+ for (;;) {
7
+ const { done, value } = await reader.read();
8
+ if (done)
9
+ break;
10
+ chunks.push(value);
11
+ size += value.length;
12
+ }
13
+ const out = new Uint8Array(size);
14
+ let at = 0;
15
+ for (const c of chunks) {
16
+ out.set(c, at);
17
+ at += c.length;
18
+ }
19
+ return out;
20
+ }
21
+ /**
22
+ * Builds the handler object for Next.js 16 `cacheHandlers` (`'use cache'` and
23
+ * `'use cache: remote'`), sharing entries and tag times through KV like the ISR handler.
24
+ */
25
+ export function createUseCacheHandler(options = {}) {
26
+ let core;
27
+ const c = () => (core ??= new CacheCore(options));
28
+ return {
29
+ async get(cacheKey, softTags = []) {
30
+ c(); // a missing build id is a setup error and throws here, not a cache miss
31
+ try {
32
+ const e = await c().lookup(cacheKey, softTags);
33
+ if (e === undefined)
34
+ return undefined;
35
+ const s = e.payload;
36
+ const now = c().now();
37
+ if (now > e.timestamp + s.expire * 1000)
38
+ return undefined;
39
+ const t = e.state;
40
+ // Past its expire time by a tag: gone. Otherwise a newer stale time means
41
+ // serve it once and rebuild (revalidate -1).
42
+ if (t.expired >= e.timestamp && t.expired <= now)
43
+ return undefined;
44
+ const stale = t.stale >= e.timestamp;
45
+ const bytes = s.value;
46
+ return {
47
+ value: new ReadableStream({
48
+ start(controller) {
49
+ controller.enqueue(bytes);
50
+ controller.close();
51
+ },
52
+ }),
53
+ tags: e.tags,
54
+ stale: s.stale,
55
+ timestamp: e.timestamp,
56
+ expire: s.expire,
57
+ revalidate: stale ? -1 : s.revalidate,
58
+ };
59
+ }
60
+ catch (error) {
61
+ c().onError(error, 'get');
62
+ return undefined;
63
+ }
64
+ },
65
+ async set(cacheKey, pendingEntry) {
66
+ c();
67
+ try {
68
+ const entry = await pendingEntry;
69
+ const value = await readAll(entry.value);
70
+ const stored = {
71
+ value,
72
+ stale: entry.stale,
73
+ expire: entry.expire,
74
+ revalidate: entry.revalidate,
75
+ };
76
+ const ttlSeconds = Number.isFinite(entry.expire) ? Math.max(1, entry.expire) : undefined;
77
+ await c().write(cacheKey, stored, {
78
+ tags: entry.tags,
79
+ timestamp: entry.timestamp,
80
+ ttlSeconds,
81
+ });
82
+ }
83
+ catch (error) {
84
+ c().onError(error, 'set');
85
+ }
86
+ },
87
+ /** Tag times are read on every `get`, so there is nothing to sync ahead of a request. */
88
+ async refreshTags() { },
89
+ async getExpiration(tags) {
90
+ return (await c().tagState(tags)).stale;
91
+ },
92
+ async updateTags(tags, durations) {
93
+ await c().markTags(tags, durations?.expire);
94
+ },
95
+ };
96
+ }
97
+ //# sourceMappingURL=use-cache.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-cache.js","sourceRoot":"","sources":["../src/use-cache.ts"],"names":[],"mappings":"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"}
package/package.json ADDED
@@ -0,0 +1,74 @@
1
+ {
2
+ "name": "@sylphx/next",
3
+ "version": "0.1.0",
4
+ "description": "Next.js cache handlers for Sylphx: ISR and 'use cache' shared across replicas, on Sylphx KV and Buckets.",
5
+ "license": "MIT",
6
+ "type": "module",
7
+ "repository": {
8
+ "type": "git",
9
+ "url": "git+https://github.com/SylphxAI/sylphx-clients.git",
10
+ "directory": "next"
11
+ },
12
+ "homepage": "https://sylphx.com/docs",
13
+ "keywords": [
14
+ "sylphx",
15
+ "nextjs",
16
+ "isr",
17
+ "cache-handler"
18
+ ],
19
+ "engines": {
20
+ "node": ">=20.19"
21
+ },
22
+ "exports": {
23
+ ".": {
24
+ "types": "./dist/index.d.ts",
25
+ "default": "./dist/index.js"
26
+ },
27
+ "./cache-handler": {
28
+ "types": "./dist/cache-handler.d.ts",
29
+ "default": "./dist/cache-handler.js"
30
+ },
31
+ "./use-cache-handler": {
32
+ "types": "./dist/use-cache-handler.d.ts",
33
+ "default": "./dist/use-cache-handler.js"
34
+ }
35
+ },
36
+ "main": "./dist/index.js",
37
+ "types": "./dist/index.d.ts",
38
+ "files": [
39
+ "dist",
40
+ "README.md",
41
+ "LICENSE"
42
+ ],
43
+ "scripts": {
44
+ "build": "rm -rf dist && tsc -p tsconfig.build.json",
45
+ "typecheck": "tsc --noEmit",
46
+ "test": "bun test",
47
+ "prepublishOnly": "bun run build"
48
+ },
49
+ "peerDependencies": {
50
+ "@sylphx/sdk": ">=0.32.0",
51
+ "next": ">=14.1.0",
52
+ "redis": ">=5.0.0"
53
+ },
54
+ "peerDependenciesMeta": {
55
+ "@sylphx/sdk": {
56
+ "optional": true
57
+ },
58
+ "next": {
59
+ "optional": true
60
+ },
61
+ "redis": {
62
+ "optional": true
63
+ }
64
+ },
65
+ "devDependencies": {
66
+ "@types/bun": "1.4.0",
67
+ "typescript": "5.9.3"
68
+ },
69
+ "publishConfig": {
70
+ "access": "public",
71
+ "tag": "next",
72
+ "provenance": true
73
+ }
74
+ }