@teleporthq/teleport-plugin-next-data-source 0.43.55 → 0.43.57

package/dist/cjs/cache/ast.d.ts

@@ -0,0 +1,71 @@
+import * as types from '@babel/types';
+import { UIDLDependency } from '@teleporthq/teleport-types';
+import { ResolvedDataSourceCache } from './types';
+/** Identifiers the emitted page imports from `utils/tq-cache/client`. */
+export declare const CACHE_CLIENT_IMPORTS: string[];
+export declare const cachedValueVarFor: (index: number) => string;
+/**
+ * Registers the client runtime's named imports on the page.
+ *
+ * Each identifier is its own dependency entry because that is how the
+ * import-statements plugin keys them; they share one path, so they collapse
+ * into a single `import { … } from '…/utils/tq-cache/client'`.
+ */
+export declare const registerCacheClientImports: (dependencies: Record<string, UIDLDependency>, folderPath: string[] | undefined) => void;
+/**
+ * The terminal `.then` of a cached fetch: record the version the server
+ * answered with (which purges the scope if it moved) and store the rows.
+ *
+ * `tqCacheSet` returns the value it was given, so the promise still resolves to
+ * exactly what the uncached chain resolved to — `response?.data`.
+ */
+export declare const buildCacheStoreThen: (cache: ResolvedDataSourceCache) => types.ArrowFunctionExpression;
+/** Wraps a network chain in the peek preamble, producing the cached body. */
+export declare const buildCachedFetchBody: (networkChain: types.Expression, cache: ResolvedDataSourceCache) => types.BlockStatement;
+/**
+ * Finds the `return <fetch(...)…>` statement inside a cached `fetchData` body.
+ *
+ * Shared with `loading-state` so both modules agree on what "the network chain"
+ * means: the body also contains an early `return Promise.resolve(hit)`, and
+ * attaching in-flight bookkeeping to THAT would flip the loading flag on every
+ * cache hit — the exact flash this feature exists to remove.
+ */
+export declare const findCachedFetchNetworkChain: (body: types.BlockStatement) => {
+    statement: types.ReturnStatement;
+    index: number;
+} | undefined;
+/**
+ * Hoists a cached provider's `params` into a component const and adds the
+ * synchronous cache peek beside it.
+ *
+ * The peek is what removes the loading flash on a page or search change: those
+ * change the provider's `key`, so it REMOUNTS with `data: undefined` and paints
+ * `renderLoading()` before any promise — even an already-resolved one — can
+ * resume. Feeding a hit into `initialData` makes the provider skip its first
+ * fetch entirely and paint the cached rows on the very first frame.
+ *
+ * `sticky` is set because this value is handed to a mounted provider: once it
+ * has been, TTL expiry must not flip it back to `undefined`, or the list would
+ * blank out without refetching (its `params` never changed).
+ *
+ * Reference identity comes from the runtime's own map, not from this `useMemo`
+ * — the memo only keeps the peek from re-running on unrelated renders.
+ */
+export declare const buildCachedParamsDeclarations: (params: {
+    index: number;
+    paramsMemo: types.Expression;
+    cache: ResolvedDataSourceCache;
+}) => {
+    declarations: types.Statement[];
+    paramsIdentifier: string;
+    cachedIdentifier: string;
+};
+/**
+ * `useEffect(() => { tqMarkHydrated(); tqCacheRevalidate([...]) }, [])`
+ *
+ * One effect per page, covering every scope on it in a single request. Flipping
+ * the hydration latch here rather than at import time is what keeps the first
+ * client render byte-identical to the server render.
+ */
+export declare const buildCacheHydrationEffect: (scopes: string[]) => types.Statement;
+//# sourceMappingURL=ast.d.ts.map

package/dist/cjs/cache/ast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.d.ts","sourceRoot":"","sources":["../../../src/cache/ast.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAA;AAEjD,yEAAyE;AACzE,eAAO,MAAM,oBAAoB,UAOhC,CAAA;AAMD,eAAO,MAAM,iBAAiB,UAAW,MAAM,KAAG,MAA8B,CAAA;AAEhF;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,iBACvB,OAAO,MAAM,EAAE,cAAc,CAAC,cAChC,MAAM,EAAE,GAAG,SAAS,KAC/B,IAaF,CAAA;AAyCD;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,UACvB,uBAAuB,KAC7B,MAAM,uBAkCR,CAAA;AAED,6EAA6E;AAC7E,eAAO,MAAM,oBAAoB,iBACjB,MAAM,UAAU,SACvB,uBAAuB,KAC7B,MAAM,cAIL,CAAA;AAEJ;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,SAChC,MAAM,cAAc,KACzB;IAAE,SAAS,EAAE,MAAM,eAAe,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,SAcxD,CAAA;AAkBD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,6BAA6B,WAAY;IACpD,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,UAAU,CAAA;IAC5B,KAAK,EAAE,uBAAuB,CAAA;CAC/B;kBACe,MAAM,SAAS,EAAE;sBACb,MAAM;sBACN,MAAM;CAkCzB,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,WAAY,MAAM,EAAE,KAAG,MAAM,SAgBhE,CAAA"}

package/dist/cjs/cache/ast.js

@@ -0,0 +1,229 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCacheHydrationEffect = exports.buildCachedParamsDeclarations = exports.findCachedFetchNetworkChain = exports.buildCachedFetchBody = exports.buildCacheStoreThen = exports.registerCacheClientImports = exports.cachedValueVarFor = exports.CACHE_CLIENT_IMPORTS = void 0;
+var types = __importStar(require("@babel/types"));
+/** Identifiers the emitted page imports from `utils/tq-cache/client`. */
+exports.CACHE_CLIENT_IMPORTS = [
+    'tqCacheKey',
+    'tqCacheGet',
+    'tqCacheSet',
+    'tqCacheSetVersion',
+    'tqMarkHydrated',
+    'tqCacheRevalidate',
+];
+/** Local identifiers used inside the generated `fetchData` body. */
+var KEY_VAR = '__tqKey';
+var HIT_VAR = '__tqHit';
+var cachedValueVarFor = function (index) { return "ds_".concat(index, "_cached"); };
+exports.cachedValueVarFor = cachedValueVarFor;
+/**
+ * Registers the client runtime's named imports on the page.
+ *
+ * Each identifier is its own dependency entry because that is how the
+ * import-statements plugin keys them; they share one path, so they collapse
+ * into a single `import { … } from '…/utils/tq-cache/client'`.
+ */
+var registerCacheClientImports = function (dependencies, folderPath) {
+    var depth = (folderPath ? folderPath.length : 0) + 1;
+    var path = "".concat('../'.repeat(depth), "utils/tq-cache/client");
+    exports.CACHE_CLIENT_IMPORTS.forEach(function (identifier) {
+        if (!dependencies[identifier]) {
+            dependencies[identifier] = {
+                type: 'local',
+                path: path,
+                meta: { namedImport: true },
+            };
+        }
+    });
+};
+exports.registerCacheClientImports = registerCacheClientImports;
+/**
+ * `const __tqKey = tqCacheKey(params)` +
+ * `const __tqHit = tqCacheGet(SCOPE, __tqKey)` +
+ * `if (__tqHit !== undefined) return Promise.resolve(__tqHit)`
+ *
+ * The early return is what keeps a hit from ever touching the network — and,
+ * just as importantly, from raising the in-flight flag that would paint the
+ * loading slot. `loading-state` deliberately attaches its bookkeeping to the
+ * network chain BELOW this, never to the `Promise.resolve`.
+ */
+var buildCachePeekPreamble = function (scope) { return [
+    types.variableDeclaration('const', [
+        types.variableDeclarator(types.identifier(KEY_VAR), types.callExpression(types.identifier('tqCacheKey'), [types.identifier('params')])),
+    ]),
+    types.variableDeclaration('const', [
+        types.variableDeclarator(types.identifier(HIT_VAR), types.callExpression(types.identifier('tqCacheGet'), [
+            types.stringLiteral(scope),
+            types.identifier(KEY_VAR),
+        ])),
+    ]),
+    types.ifStatement(types.binaryExpression('!==', types.identifier(HIT_VAR), types.identifier('undefined')), types.blockStatement([
+        types.returnStatement(types.callExpression(types.memberExpression(types.identifier('Promise'), types.identifier('resolve')), [types.identifier(HIT_VAR)])),
+    ])),
+]; };
+/**
+ * The terminal `.then` of a cached fetch: record the version the server
+ * answered with (which purges the scope if it moved) and store the rows.
+ *
+ * `tqCacheSet` returns the value it was given, so the promise still resolves to
+ * exactly what the uncached chain resolved to — `response?.data`.
+ */
+var buildCacheStoreThen = function (cache) {
+    var responseData = types.optionalMemberExpression(types.identifier('response'), types.identifier('data'), false, true);
+    var responseVersion = types.optionalMemberExpression(types.identifier('response'), types.identifier('version'), false, true);
+    return types.arrowFunctionExpression([types.identifier('response')], types.blockStatement([
+        types.expressionStatement(types.callExpression(types.identifier('tqCacheSetVersion'), [
+            types.stringLiteral(cache.scope),
+            types.cloneNode(responseVersion, true),
+        ])),
+        types.returnStatement(types.callExpression(types.identifier('tqCacheSet'), [
+            types.stringLiteral(cache.scope),
+            types.identifier(KEY_VAR),
+            responseData,
+            types.numericLiteral(cache.ttlSeconds),
+            types.cloneNode(responseVersion, true),
+        ])),
+    ]));
+};
+exports.buildCacheStoreThen = buildCacheStoreThen;
+/** Wraps a network chain in the peek preamble, producing the cached body. */
+var buildCachedFetchBody = function (networkChain, cache) {
+    return types.blockStatement(__spreadArray(__spreadArray([], buildCachePeekPreamble(cache.scope), true), [
+        types.returnStatement(networkChain),
+    ], false));
+};
+exports.buildCachedFetchBody = buildCachedFetchBody;
+/**
+ * Finds the `return <fetch(...)…>` statement inside a cached `fetchData` body.
+ *
+ * Shared with `loading-state` so both modules agree on what "the network chain"
+ * means: the body also contains an early `return Promise.resolve(hit)`, and
+ * attaching in-flight bookkeeping to THAT would flip the loading flag on every
+ * cache hit — the exact flash this feature exists to remove.
+ */
+var findCachedFetchNetworkChain = function (body) {
+    for (var index = body.body.length - 1; index >= 0; index--) {
+        var statement = body.body[index];
+        if (statement.type !== 'ReturnStatement' || !statement.argument) {
+            continue;
+        }
+        if (statement.argument.type === 'CallExpression' &&
+            callChainStartsWithFetch(statement.argument)) {
+            return { statement: statement, index: index };
+        }
+    }
+    return undefined;
+};
+exports.findCachedFetchNetworkChain = findCachedFetchNetworkChain;
+var callChainStartsWithFetch = function (expression) {
+    var current = expression;
+    while (current.type === 'CallExpression') {
+        var callee = current.callee;
+        if (callee.type === 'Identifier' && callee.name === 'fetch') {
+            return true;
+        }
+        if (callee.type === 'MemberExpression') {
+            current = callee.object;
+            continue;
+        }
+        return false;
+    }
+    return false;
+};
+/**
+ * Hoists a cached provider's `params` into a component const and adds the
+ * synchronous cache peek beside it.
+ *
+ * The peek is what removes the loading flash on a page or search change: those
+ * change the provider's `key`, so it REMOUNTS with `data: undefined` and paints
+ * `renderLoading()` before any promise — even an already-resolved one — can
+ * resume. Feeding a hit into `initialData` makes the provider skip its first
+ * fetch entirely and paint the cached rows on the very first frame.
+ *
+ * `sticky` is set because this value is handed to a mounted provider: once it
+ * has been, TTL expiry must not flip it back to `undefined`, or the list would
+ * blank out without refetching (its `params` never changed).
+ *
+ * Reference identity comes from the runtime's own map, not from this `useMemo`
+ * — the memo only keeps the peek from re-running on unrelated renders.
+ */
+var buildCachedParamsDeclarations = function (params) {
+    var paramsIdentifier = "ds_".concat(params.index, "_params");
+    var cachedIdentifier = (0, exports.cachedValueVarFor)(params.index);
+    return {
+        paramsIdentifier: paramsIdentifier,
+        cachedIdentifier: cachedIdentifier,
+        declarations: [
+            types.variableDeclaration('const', [
+                types.variableDeclarator(types.identifier(paramsIdentifier), params.paramsMemo),
+            ]),
+            types.variableDeclaration('const', [
+                types.variableDeclarator(types.identifier(cachedIdentifier), types.callExpression(types.identifier('useMemo'), [
+                    types.arrowFunctionExpression([], types.callExpression(types.identifier('tqCacheGet'), [
+                        types.stringLiteral(params.cache.scope),
+                        types.callExpression(types.identifier('tqCacheKey'), [
+                            types.identifier(paramsIdentifier),
+                        ]),
+                        types.objectExpression([
+                            types.objectProperty(types.identifier('sticky'), types.booleanLiteral(true)),
+                        ]),
+                    ])),
+                    types.arrayExpression([types.identifier(paramsIdentifier)]),
+                ])),
+            ]),
+        ],
+    };
+};
+exports.buildCachedParamsDeclarations = buildCachedParamsDeclarations;
+/**
+ * `useEffect(() => { tqMarkHydrated(); tqCacheRevalidate([...]) }, [])`
+ *
+ * One effect per page, covering every scope on it in a single request. Flipping
+ * the hydration latch here rather than at import time is what keeps the first
+ * client render byte-identical to the server render.
+ */
+var buildCacheHydrationEffect = function (scopes) {
+    return types.expressionStatement(types.callExpression(types.identifier('useEffect'), [
+        types.arrowFunctionExpression([], types.blockStatement([
+            types.expressionStatement(types.callExpression(types.identifier('tqMarkHydrated'), [])),
+            types.expressionStatement(types.callExpression(types.identifier('tqCacheRevalidate'), [
+                types.arrayExpression(scopes.map(function (scope) { return types.stringLiteral(scope); })),
+            ])),
+        ])),
+        types.arrayExpression([]),
+    ]));
+};
+exports.buildCacheHydrationEffect = buildCacheHydrationEffect;
+//# sourceMappingURL=ast.js.map

package/dist/cjs/cache/ast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.js","sourceRoot":"","sources":["../../../src/cache/ast.ts"],"names":[],"mappings":"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"}

package/dist/cjs/cache/config.d.ts

@@ -0,0 +1,22 @@
+import { UIDLDataCacheConfig } from '@teleporthq/teleport-types';
+import { DataSourceServerCacheOptions, ResolvedDataSourceCache } from './types';
+/**
+ * Reads the `cache` block off a `cms-list-repeater`.
+ *
+ * Returns `undefined` — meaning "emit exactly what this generator emitted
+ * before caching existed" — for anything that is off, incomplete, or caches
+ * into neither layer.
+ */
+export declare const resolveCacheFromRepeaterContent: (cache: UIDLDataCacheConfig | undefined, resourceDefinition: {
+    dataSourceId?: string;
+    tableName?: string;
+} | undefined) => ResolvedDataSourceCache | undefined;
+/**
+ * Folds several mappers' requests for the same generated file into one.
+ *
+ * Enabled if ANY mapper wants it, but with the SHORTEST requested TTL and the
+ * shortest shared-cache window — a mapper that asked for fresher data must
+ * never be made staler by a sibling that asked for less.
+ */
+export declare const mergeServerCacheOptions: (entries: DataSourceServerCacheOptions[]) => DataSourceServerCacheOptions | undefined;
+//# sourceMappingURL=config.d.ts.map

package/dist/cjs/cache/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/cache/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,EAAE,4BAA4B,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAA;AAE/E;;;;;;GAMG;AACH,eAAO,MAAM,+BAA+B,UACnC,mBAAmB,GAAG,SAAS,sBAClB;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,KAC5E,uBAAuB,GAAG,SAoC5B,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,YACzB,4BAA4B,EAAE,KACtC,4BAA4B,GAAG,SAiBjC,CAAA"}

package/dist/cjs/cache/config.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeServerCacheOptions = exports.resolveCacheFromRepeaterContent = void 0;
+var teleport_shared_1 = require("@teleporthq/teleport-shared");
+/**
+ * Reads the `cache` block off a `cms-list-repeater`.
+ *
+ * Returns `undefined` — meaning "emit exactly what this generator emitted
+ * before caching existed" — for anything that is off, incomplete, or caches
+ * into neither layer.
+ */
+var resolveCacheFromRepeaterContent = function (cache, resourceDefinition) {
+    if (!cache || cache.enabled !== true) {
+        return undefined;
+    }
+    var client = cache.client === true;
+    var server = cache.server === true;
+    if (!client && !server) {
+        return undefined;
+    }
+    var scope = cache.versionScope ||
+        ((resourceDefinition === null || resourceDefinition === void 0 ? void 0 : resourceDefinition.dataSourceId) && (resourceDefinition === null || resourceDefinition === void 0 ? void 0 : resourceDefinition.tableName)
+            ? teleport_shared_1.DataCache.cacheScopeFor(resourceDefinition.dataSourceId, resourceDefinition.tableName)
+            : '');
+    if (!scope) {
+        return undefined;
+    }
+    var ttlSeconds = typeof cache.ttlSeconds === 'number' && cache.ttlSeconds > 0
+        ? Math.trunc(cache.ttlSeconds)
+        : teleport_shared_1.DataCache.DEFAULT_CACHE_TTL_SECONDS;
+    return {
+        scope: scope,
+        ttlSeconds: ttlSeconds,
+        client: client,
+        server: server,
+        sMaxAge: typeof cache.cdnSMaxAge === 'number' && cache.cdnSMaxAge > 0 ? cache.cdnSMaxAge : 0,
+        staleWhileRevalidate: typeof cache.cdnStaleWhileRevalidate === 'number' && cache.cdnStaleWhileRevalidate > 0
+            ? cache.cdnStaleWhileRevalidate
+            : undefined,
+    };
+};
+exports.resolveCacheFromRepeaterContent = resolveCacheFromRepeaterContent;
+/**
+ * Folds several mappers' requests for the same generated file into one.
+ *
+ * Enabled if ANY mapper wants it, but with the SHORTEST requested TTL and the
+ * shortest shared-cache window — a mapper that asked for fresher data must
+ * never be made staler by a sibling that asked for less.
+ */
+var mergeServerCacheOptions = function (entries) {
+    var enabled = entries.filter(function (entry) { return entry.ttlSeconds > 0 || (entry.sMaxAge || 0) > 0; });
+    if (!enabled.length) {
+        return undefined;
+    }
+    var positive = function (values) { return values.filter(function (value) { return value > 0; }); };
+    var ttls = positive(enabled.map(function (entry) { return entry.ttlSeconds; }));
+    var sMaxAges = positive(enabled.map(function (entry) { return entry.sMaxAge || 0; }));
+    var swrs = positive(enabled.map(function (entry) { return entry.staleWhileRevalidate || 0; }));
+    return {
+        scope: enabled[0].scope,
+        ttlSeconds: ttls.length ? Math.min.apply(Math, ttls) : 0,
+        sMaxAge: sMaxAges.length ? Math.min.apply(Math, sMaxAges) : 0,
+        staleWhileRevalidate: swrs.length ? Math.min.apply(Math, swrs) : undefined,
+    };
+};
+exports.mergeServerCacheOptions = mergeServerCacheOptions;
+//# sourceMappingURL=config.js.map

package/dist/cjs/cache/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/cache/config.ts"],"names":[],"mappings":";;;AAAA,+DAAuD;AAIvD;;;;;;GAMG;AACI,IAAM,+BAA+B,GAAG,UAC7C,KAAsC,EACtC,kBAA6E;IAE7E,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE;QACpC,OAAO,SAAS,CAAA;KACjB;IAED,IAAM,MAAM,GAAG,KAAK,CAAC,MAAM,KAAK,IAAI,CAAA;IACpC,IAAM,MAAM,GAAG,KAAK,CAAC,MAAM,KAAK,IAAI,CAAA;IACpC,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE;QACtB,OAAO,SAAS,CAAA;KACjB;IAED,IAAM,KAAK,GACT,KAAK,CAAC,YAAY;QAClB,CAAC,CAAA,kBAAkB,aAAlB,kBAAkB,uBAAlB,kBAAkB,CAAE,YAAY,MAAI,kBAAkB,aAAlB,kBAAkB,uBAAlB,kBAAkB,CAAE,SAAS,CAAA;YAChE,CAAC,CAAC,2BAAS,CAAC,aAAa,CAAC,kBAAkB,CAAC,YAAY,EAAE,kBAAkB,CAAC,SAAS,CAAC;YACxF,CAAC,CAAC,EAAE,CAAC,CAAA;IACT,IAAI,CAAC,KAAK,EAAE;QACV,OAAO,SAAS,CAAA;KACjB;IAED,IAAM,UAAU,GACd,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,GAAG,CAAC;QAC1D,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC;QAC9B,CAAC,CAAC,2BAAS,CAAC,yBAAyB,CAAA;IAEzC,OAAO;QACL,KAAK,OAAA;QACL,UAAU,YAAA;QACV,MAAM,QAAA;QACN,MAAM,QAAA;QACN,OAAO,EAAE,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC5F,oBAAoB,EAClB,OAAO,KAAK,CAAC,uBAAuB,KAAK,QAAQ,IAAI,KAAK,CAAC,uBAAuB,GAAG,CAAC;YACpF,CAAC,CAAC,KAAK,CAAC,uBAAuB;YAC/B,CAAC,CAAC,SAAS;KAChB,CAAA;AACH,CAAC,CAAA;AAvCY,QAAA,+BAA+B,mCAuC3C;AAED;;;;;;GAMG;AACI,IAAM,uBAAuB,GAAG,UACrC,OAAuC;IAEvC,IAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,UAAC,KAAK,IAAK,OAAA,KAAK,CAAC,UAAU,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,EAAhD,CAAgD,CAAC,CAAA;IAC3F,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;QACnB,OAAO,SAAS,CAAA;KACjB;IAED,IAAM,QAAQ,GAAG,UAAC,MAAgB,IAAK,OAAA,MAAM,CAAC,MAAM,CAAC,UAAC,KAAK,IAAK,OAAA,KAAK,GAAG,CAAC,EAAT,CAAS,CAAC,EAAnC,CAAmC,CAAA;IAC1E,IAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,UAAC,KAAK,IAAK,OAAA,KAAK,CAAC,UAAU,EAAhB,CAAgB,CAAC,CAAC,CAAA;IAC/D,IAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,UAAC,KAAK,IAAK,OAAA,KAAK,CAAC,OAAO,IAAI,CAAC,EAAlB,CAAkB,CAAC,CAAC,CAAA;IACrE,IAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,UAAC,KAAK,IAAK,OAAA,KAAK,CAAC,oBAAoB,IAAI,CAAC,EAA/B,CAA+B,CAAC,CAAC,CAAA;IAE9E,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK;QACvB,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,OAAR,IAAI,EAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;QAC/C,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,OAAR,IAAI,EAAQ,QAAQ,EAAE,CAAC,CAAC,CAAC;QACpD,oBAAoB,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,OAAR,IAAI,EAAQ,IAAI,EAAE,CAAC,CAAC,SAAS;KAClE,CAAA;AACH,CAAC,CAAA;AAnBY,QAAA,uBAAuB,2BAmBnC"}

package/dist/cjs/cache/types.d.ts

@@ -0,0 +1,31 @@
+/**
+ * A mapper's caching setup once the UIDL has been read and the defaults filled
+ * in. `client` and `server` are independent — both layers may run at once.
+ */
+export interface ResolvedDataSourceCache {
+    scope: string;
+    ttlSeconds: number;
+    client: boolean;
+    server: boolean;
+    /** `Cache-Control: s-maxage`. Zero unless a shared window was granted. */
+    sMaxAge: number;
+    staleWhileRevalidate?: number;
+}
+/**
+ * Cache configuration as it reaches the emitters.
+ *
+ * Resolved per generated data-source FILE, not per array mapper: the
+ * `utils/data-sources/<file>.js` module is shared by every mapper reading the
+ * same `(type, table, dataSourceId)` triple, so two mappers on two pages must
+ * agree on one server-side setup. See `mergeServerCacheOptions`.
+ */
+export interface DataSourceServerCacheOptions {
+    /** `<dataSourceId>:<tableName>` — the unit of invalidation. */
+    scope: string;
+    /** In-process TTL, seconds. `0` disables the server cache. */
+    ttlSeconds: number;
+    /** `Cache-Control: s-maxage`, seconds. `0` keeps the response private. */
+    sMaxAge?: number;
+    staleWhileRevalidate?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/cache/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cache/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,OAAO,CAAA;IACf,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAA;IACf,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,4BAA4B;IAC3C,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAA;IACb,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAA;IAClB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAC9B"}

package/dist/cjs/cache/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/cache/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/cache/types.ts"],"names":[],"mappings":""}

package/dist/cjs/data-source-fetchers.d.ts

@@ -1,5 +1,7 @@
-import { DataSourceType, UIDLDataSource, UIDLEcommerceCategory } from '@teleporthq/teleport-types';
+import { DataSourceType, UIDLDataSource } from '@teleporthq/teleport-types';
 import { generateRawQueryFetcher, parseQueryTemplateVariables } from './fetchers';
+import type { EcommerceProductTransformOptions } from './transformations';
+import type { DataSourceServerCacheOptions } from './cache/types';
 export { generateRawQueryFetcher, parseQueryTemplateVariables };
 interface DataSourceFetcherDependencies {
     packages: string[];
@@ -7,10 +9,10 @@ interface DataSourceFetcherDependencies {
 }
 export declare const isSupabaseConnectionStringFallback: (config: Record<string, unknown>) => boolean;
 export declare const getDataSourceDependencies: (type: DataSourceType, config?: Record<string, unknown>) => DataSourceFetcherDependencies;
-export declare function generateDataSourceFetcher(dataSource: UIDLDataSource, tableName: string, categories?: UIDLEcommerceCategory[]): string;
+export declare function generateDataSourceFetcher(dataSource: UIDLDataSource, tableName: string, transformOptions?: EcommerceProductTransformOptions): string;
 /**
  * Generates a fetcher with both a core fetchData function (for server-side use in getStaticProps)
  * and an API handler (for client-side use)
  */
-export declare function generateDataSourceFetcherWithCore(dataSource: UIDLDataSource, tableName: string, isApiRoute?: boolean, categories?: UIDLEcommerceCategory[]): string;
+export declare function generateDataSourceFetcherWithCore(dataSource: UIDLDataSource, tableName: string, isApiRoute?: boolean, transformOptions?: EcommerceProductTransformOptions, cacheOptions?: DataSourceServerCacheOptions): string;
 //# sourceMappingURL=data-source-fetchers.d.ts.map

package/dist/cjs/data-source-fetchers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-source-fetchers.d.ts","sourceRoot":"","sources":["../../src/data-source-fetchers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAClG,OAAO,EA6BL,uBAAuB,EACvB,2BAA2B,EAC5B,MAAM,YAAY,CAAA;AAInB,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,CAAA;AAE/D,UAAU,6BAA6B;IACrC,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED,eAAO,MAAM,kCAAkC,WAAY,OAAO,MAAM,EAAE,OAAO,CAAC,KAAG,OAEpF,CAAA;AAED,eAAO,MAAM,yBAAyB,SAC9B,cAAc,WACX,OAAO,MAAM,EAAE,OAAO,CAAC,KAC/B,6BA4BF,CAAA;AAED,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,cAAc,EAC1B,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,qBAAqB,EAAE,GACnC,MAAM,CAsKR;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,CAC/C,UAAU,EAAE,cAAc,EAC1B,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,OAAe,EAC3B,UAAU,CAAC,EAAE,qBAAqB,EAAE,GACnC,MAAM,CAmGR"}
+{"version":3,"file":"data-source-fetchers.d.ts","sourceRoot":"","sources":["../../src/data-source-fetchers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAC3E,OAAO,EA6BL,uBAAuB,EACvB,2BAA2B,EAC5B,MAAM,YAAY,CAAA;AAGnB,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,mBAAmB,CAAA;AAEzE,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAA;AAEjE,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,CAAA;AAE/D,UAAU,6BAA6B;IACrC,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED,eAAO,MAAM,kCAAkC,WAAY,OAAO,MAAM,EAAE,OAAO,CAAC,KAAG,OAEpF,CAAA;AAED,eAAO,MAAM,yBAAyB,SAC9B,cAAc,WACX,OAAO,MAAM,EAAE,OAAO,CAAC,KAC/B,6BA4BF,CAAA;AAED,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,cAAc,EAC1B,SAAS,EAAE,MAAM,EACjB,gBAAgB,GAAE,gCAAqC,GACtD,MAAM,CAsKR;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,CAC/C,UAAU,EAAE,cAAc,EAC1B,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,OAAe,EAC3B,gBAAgB,GAAE,gCAAqC,EACvD,YAAY,CAAC,EAAE,4BAA4B,GAC1C,MAAM,CAqJR"}

package/dist/cjs/data-source-fetchers.js

@@ -15,6 +15,7 @@ Object.defineProperty(exports, "generateRawQueryFetcher", { enumerable: true, ge
 Object.defineProperty(exports, "parseQueryTemplateVariables", { enumerable: true, get: function () { return fetchers_1.parseQueryTemplateVariables; } });
 var validation_1 = require("./validation");
 var count_fetchers_1 = require("./count-fetchers");
+var teleport_shared_1 = require("@teleporthq/teleport-shared");
 var isSupabaseConnectionStringFallback = function (config) {
     return !!(config === null || config === void 0 ? void 0 : config.connectionString) && !(config === null || config === void 0 ? void 0 : config.supabaseUrl);
 };
@@ -47,7 +48,8 @@ var getDataSourceDependencies = function (type, config) {
     return dependencyMap[type];
 };
 exports.getDataSourceDependencies = getDataSourceDependencies;
-function generateDataSourceFetcher(dataSource, tableName, categories) {
+function generateDataSourceFetcher(dataSource, tableName, transformOptions) {
+    if (transformOptions === void 0) { transformOptions = {}; }
     if (!dataSource || typeof dataSource !== 'object') {
         throw new Error('Invalid data source: data source must be a valid object');
     }
@@ -180,7 +182,7 @@ function generateDataSourceFetcher(dataSource, tableName, categories) {
                 if (!validation.isValid) {
                     throw new Error("Teleport config validation failed: ".concat(validation.error));
                 }
-                return (0, fetchers_1.generateTeleportFetcher)(config, tableName, categories);
+                return (0, fetchers_1.generateTeleportFetcher)(config, tableName, transformOptions);
             }
             default:
                 throw new Error("Unsupported data source type: ".concat(type));
@@ -197,9 +199,10 @@ exports.generateDataSourceFetcher = generateDataSourceFetcher;
  * Generates a fetcher with both a core fetchData function (for server-side use in getStaticProps)
  * and an API handler (for client-side use)
  */
-function generateDataSourceFetcherWithCore(dataSource, tableName, isApiRoute, categories) {
+function generateDataSourceFetcherWithCore(dataSource, tableName, isApiRoute, transformOptions, cacheOptions) {
     if (isApiRoute === void 0) { isApiRoute = false; }
-    var apiHandler = generateDataSourceFetcher(dataSource, tableName, categories);
+    if (transformOptions === void 0) { transformOptions = {}; }
+    var apiHandler = generateDataSourceFetcher(dataSource, tableName, transformOptions);
     // Extract the handler function body from the API route
     // The API route is structured as: export default async function handler(req, res) { ... }
     // We need to create a fetchData function that can be called directly
@@ -215,12 +218,52 @@ function generateDataSourceFetcherWithCore(dataSource, tableName, isApiRoute, ca
     var countFetcherWithoutImports = countFetcherCode.replace(importRegex, '').trim();
     // Combine and deduplicate imports
     var allImports = Array.from(new Set(__spreadArray(__spreadArray([], imports, true), countImports, true)));
+    // Caching is applied HERE rather than in the API route because four separate
+    // places emit an `api/<file>` route and a fifth path (`getStaticProps` →
+    // `fetchData` → `handler`) never goes through a route at all. Wrapping the
+    // module's exports is the one point that covers all five, and leaves every
+    // route emitter untouched.
+    //
+    // The import depth differs by destination: this module is written to
+    // `utils/data-sources/` normally, but the `isApiRoute` variant is inlined
+    // straight into `pages/api/`.
+    var cachePreamble = cacheOptions
+        ? "import { tqWithCache } from '".concat(isApiRoute ? '../../' : '../', "tq-cache/server'")
+        : '';
+    var cacheWiring = cacheOptions
+        ? "\nconst __tqDataCache = ".concat(JSON.stringify({
+            scope: cacheOptions.scope,
+            ttl: cacheOptions.ttlSeconds,
+            sMaxAge: cacheOptions.sMaxAge || 0,
+            swr: cacheOptions.staleWhileRevalidate || 0,
+        }), "\nconst __tqCountCache = ").concat(JSON.stringify({
+            scope: teleport_shared_1.DataCache.countScopeFor(cacheOptions.scope),
+            // Its OWN keyspace, but the DATA scope's version row. A write bumps one
+            // row; if the count kept a separate version nothing would ever bump it,
+            // and the total would stay stale after every create and delete — the
+            // grid showing one more row than the pager counts.
+            versionScope: cacheOptions.scope,
+            ttl: cacheOptions.ttlSeconds,
+            sMaxAge: cacheOptions.sMaxAge || 0,
+            swr: cacheOptions.staleWhileRevalidate || 0,
+        }), "\n\nconst cachedHandler = tqWithCache(handler, __tqDataCache)\nconst cachedGetCount = tqWithCache(getCount, __tqCountCache)\n")
+        : '';
+    var handlerExport = cacheOptions ? 'cachedHandler' : 'handler';
+    var countExport = cacheOptions ? 'cachedGetCount' : 'getCount';
     // For API routes, export just the handler function
     // For utils files, export the full object with all functions
-    var exports = isApiRoute
-        ? 'export default handler'
-        : "export { fetchData, fetchCount, handler, getCount }\nexport default { fetchData, fetchCount, handler, getCount }";
-    return "".concat(allImports.join('\n'), "\n\nasync function fetchData(params = {}) {\n  const req = {\n    query: params,\n    method: 'GET',\n  }\n  \n  let result = null\n  let statusCode = 200\n  \n  const res = {\n    status: (code) => {\n      statusCode = code\n      return res\n    },\n    json: (data) => {\n      result = data\n      return res\n    },\n  }\n  \n  await handler(req, res)\n  \n  if (statusCode !== 200 || !result || !result.success) {\n    throw new Error(result?.error || 'Failed to fetch data')\n  }\n  \n  return result.data\n}\n\nasync function fetchCount(params = {}) {\n  const req = {\n    query: params,\n    method: 'GET',\n  }\n  \n  let result = null\n  let statusCode = 200\n  \n  const res = {\n    status: (code) => {\n      statusCode = code\n      return res\n    },\n    json: (data) => {\n      result = data\n      return res\n    },\n  }\n  \n  await getCount(req, res)\n  \n  if (statusCode !== 200 || !result || !result.success) {\n    throw new Error(result?.error || 'Failed to get count')\n  }\n  \n  return result.count\n}\n\n").concat(countFetcherWithoutImports, "\n\n").concat(handlerWithoutImports, "\n\n").concat(exports, "\n");
+    //
+    // The uncached branch is spelled out verbatim rather than interpolated, so an
+    // uncached project keeps generating byte-identical output — `handler as
+    // handler` would be harmless at runtime and still a diff in every snapshot.
+    var exports = !cacheOptions
+        ? isApiRoute
+            ? 'export default handler'
+            : "export { fetchData, fetchCount, handler, getCount }\nexport default { fetchData, fetchCount, handler, getCount }"
+        : isApiRoute
+            ? "export default ".concat(handlerExport)
+            : "export { fetchData, fetchCount, ".concat(handlerExport, " as handler, ").concat(countExport, " as getCount }\nexport default { fetchData, fetchCount, handler: ").concat(handlerExport, ", getCount: ").concat(countExport, " }");
+    return "".concat(__spreadArray(__spreadArray([], allImports, true), [cachePreamble], false).filter(Boolean).join('\n'), "\n\nasync function fetchData(params = {}) {\n  const req = {\n    query: params,\n    method: 'GET',\n  }\n  \n  let result = null\n  let statusCode = 200\n  \n  const res = {\n    status: (code) => {\n      statusCode = code\n      return res\n    },\n    json: (data) => {\n      result = data\n      return res\n    },\n  }\n  \n  await ").concat(handlerExport, "(req, res)\n  \n  if (statusCode !== 200 || !result || !result.success) {\n    throw new Error(result?.error || 'Failed to fetch data')\n  }\n  \n  return result.data\n}\n\nasync function fetchCount(params = {}) {\n  const req = {\n    query: params,\n    method: 'GET',\n  }\n  \n  let result = null\n  let statusCode = 200\n  \n  const res = {\n    status: (code) => {\n      statusCode = code\n      return res\n    },\n    json: (data) => {\n      result = data\n      return res\n    },\n  }\n  \n  await ").concat(countExport, "(req, res)\n  \n  if (statusCode !== 200 || !result || !result.success) {\n    throw new Error(result?.error || 'Failed to get count')\n  }\n  \n  return result.count\n}\n\n").concat(countFetcherWithoutImports, "\n\n").concat(handlerWithoutImports, "\n").concat(cacheWiring, "\n").concat(exports, "\n");
 }
 exports.generateDataSourceFetcherWithCore = generateDataSourceFetcherWithCore;
 //# sourceMappingURL=data-source-fetchers.js.map