@teleporthq/teleport-plugin-next-data-source 0.43.66 → 0.43.68

package/dist/cjs/product-filter-fields.js

@@ -0,0 +1,161 @@
+"use strict";
+/**
+ * Filtering a products list on things that are not a plain column.
+ *
+ * The storefront's product filters ask questions the `teleport_products` row
+ * cannot answer with a single column comparison: "what does it cost right now"
+ * (`price` net of a live markdown), "how many stars" (an aggregate over the
+ * reviews table), "is it on sale", and "does it come in size XL" (a value
+ * inside the `variant_options` JSON). Like the discount-aware sort in
+ * `product-price-sort.ts`, these have to be answered by the DATABASE — the list
+ * is paginated, so filtering the fetched page would only filter 20 of N rows.
+ *
+ * The editor emits such a filter as an ordinary condition whose `source` is
+ * one of the VIRTUAL field names below. Every SQL builder that can receive a
+ * products filter rewrites them into the expressions here:
+ *
+ *   - this file → the generated store's `teleport_products` API route
+ *     (`fetchers/teleport.ts`, `fetchers/postgresql.ts`);
+ *   - `database-provider-worker/src/lib/product-filter-fields.ts` → the editor
+ *     canvas. ⛔ A byte-for-byte mirror of the SQL below; both repos pin the
+ *     strings with a test, because a clause the canvas cannot build is an HTTP
+ *     500 the canvas draws as an EMPTY grid.
+ *
+ * ## The expressions cannot raise
+ *
+ * Same discipline as the sort: the JSON column is cast only when its text
+ * already looks like an array, the axis key is validated against a slug pattern
+ * before it is bound, and an unknown key filters to no rows instead of erroring
+ * — a filter that the database rejects would empty the whole products page.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateProductFilterClauseHelper = exports.buildProductVariantAxisExistsSql = exports.SAFE_VARIANT_OPTIONS_JSONB = exports.buildProductOnSaleSql = exports.buildProductRatingBucketSql = exports.IN_OPERAND = exports.PRODUCT_VARIANT_AXIS_KEY_PATTERN = exports.PRODUCT_VARIANT_AXIS_FILTER_PREFIX = exports.PRODUCT_ON_SALE_FILTER_FIELD = exports.PRODUCT_RATING_FILTER_FIELD = exports.PRODUCT_REVIEWS_TABLE_NAME = void 0;
+var product_price_sort_1 = require("./product-price-sort");
+/** The reviews table the star-rating aggregate reads. Exists once reviews were enabled. */
+exports.PRODUCT_REVIEWS_TABLE_NAME = 'teleport_product_reviews';
+/** Virtual field: the product's star bucket — `ROUND(AVG(approved rating))`, 1..5, NULL when unreviewed. */
+exports.PRODUCT_RATING_FILTER_FIELD = 'rating';
+/** Virtual field: `'true'` while a markdown is live, else `'false'`. */
+exports.PRODUCT_ON_SALE_FILTER_FIELD = 'on_sale';
+/**
+ * Virtual field family: `variant_options.<axisKey>` — the product offers the
+ * axis (e.g. `size`) in one of the given values (e.g. `xl`).
+ */
+exports.PRODUCT_VARIANT_AXIS_FILTER_PREFIX = 'variant_options.';
+/**
+ * What an axis key may look like. Keys are produced by the editor's slug
+ * helper (`deriveOptionKey`), so this is what every real key matches; anything
+ * else is refused before it can reach the database.
+ */
+exports.PRODUCT_VARIANT_AXIS_KEY_PATTERN = '^[a-z0-9][a-z0-9_-]{0,63}$';
+/** Generic multi-value operand: the column equals ANY of the destination values. */
+exports.IN_OPERAND = 'in';
+/**
+ * `ROUND(AVG(rating))` over the product's APPROVED reviews. Only approved rows
+ * count — moderation is the merchant's veto — and the outer row is the
+ * unaliased `teleport_products` the fetchers select from.
+ */
+var buildProductRatingBucketSql = function () {
+    return "(SELECT ROUND(AVG(r.rating)) FROM ".concat(exports.PRODUCT_REVIEWS_TABLE_NAME, " r WHERE r.product_id = ").concat(product_price_sort_1.PRODUCTS_TABLE_NAME, ".id AND r.status = 'approved' AND r.rating IS NOT NULL)");
+};
+exports.buildProductRatingBucketSql = buildProductRatingBucketSql;
+/** `'true'` when the price paid today is below the list price, i.e. a markdown is live. */
+var buildProductOnSaleSql = function () {
+    return "(CASE WHEN ".concat((0, product_price_sort_1.buildProductEffectivePriceSql)(), " < \"price\"::numeric THEN 'true' ELSE 'false' END)");
+};
+exports.buildProductOnSaleSql = buildProductOnSaleSql;
+/**
+ * Only text that already looks like a JSON array is cast; NULL, empty or a
+ * hand-edited scalar reads as "no variant axes".
+ */
+exports.SAFE_VARIANT_OPTIONS_JSONB = "CASE\n        WHEN \"variant_options\" IS NULL OR btrim(\"variant_options\") NOT LIKE '[%' THEN '[]'::jsonb\n        ELSE \"variant_options\"::jsonb\n      END";
+/**
+ * True when the product declares the axis bound to `keyParam` with at least one
+ * of the values bound to `valuesParam` (a `text[]`). Both are PARAMETERS, never
+ * interpolated text.
+ */
+var buildProductVariantAxisExistsSql = function (keyParam, valuesParam) {
+    return "EXISTS (SELECT 1 FROM jsonb_array_elements(".concat(exports.SAFE_VARIANT_OPTIONS_JSONB, ") AS ax, jsonb_array_elements(CASE WHEN jsonb_typeof(ax->'values') = 'array' THEN ax->'values' ELSE '[]'::jsonb END) AS v WHERE ax->>'key' = ").concat(keyParam, " AND v->>'value' = ANY(").concat(valuesParam, "::text[]))");
+};
+exports.buildProductVariantAxisExistsSql = buildProductVariantAxisExistsSql;
+/**
+ * The complete `productFilterClause(field, operand, value, pushParam)` helper a
+ * SQL fetcher embeds in its generated route.
+ *
+ * Returns a finished WHERE clause for a virtual (or rewritten) products field,
+ * or `null` for anything else so the fetcher's ordinary branches run. `pushParam`
+ * binds a value and answers its `$n` placeholder. By the time it is called an
+ * `in` filter has been normalised to `=` with an ARRAY value (see
+ * `normalizeInOperand` in `utils.ts`), which reads as "any of". A virtual field
+ * never answers `null` once matched — an operand it cannot express filters to
+ * no rows rather than falling into a branch that would name a column the table
+ * does not have.
+ *
+ * Emitted through `JSON.stringify` and string concatenation only — no backtick
+ * and no `${` may appear in the output, which is interpolated into a fetcher's
+ * template literal. On a table that is not the products table the helper still
+ * exists and always answers `null`, so a fetcher can embed it unconditionally.
+ */
+var generateProductFilterClauseHelper = function (tableName) {
+    if (!(0, product_price_sort_1.supportsProductPriceSort)(tableName)) {
+        return [
+            '// Virtual products-table filter fields. This table has none, so every',
+            "// condition takes the fetcher's ordinary branches.",
+            'function productFilterClause() {',
+            '  return null',
+            '}',
+        ].join('\n');
+    }
+    var lines = [
+        "// Rewrites the products table's virtual filter fields - the price paid",
+        '// today, the star-rating bucket, the on-sale flag and a variant axis - into',
+        '// SQL. Answers null for a plain column so the ordinary branches run. An',
+        '// "in" filter arrives here already normalised to "=" with an ARRAY value.',
+        'function productFilterClause(field, operand, value, pushParam) {',
+        "  var scalarOps = ['=', '!=', '>', '<', '>=', '<=']",
+        "  var equalityOps = ['=', '!=']",
+        '  var compare = function (expression, allowedOps, virtual) {',
+        '    if (Array.isArray(value)) {',
+        "      if (operand === '=') {",
+        "        return expression + '::text = ANY(' + pushParam(value.map(String)) + '::text[])'",
+        '      }',
+        "      if (operand === '!=') {",
+        "        return expression + '::text <> ALL(' + pushParam(value.map(String)) + '::text[])'",
+        '      }',
+        "      return virtual ? 'FALSE' : null",
+        '    }',
+        "    if (allowedOps.indexOf(operand) === -1) return virtual ? 'FALSE' : null",
+        "    return expression + ' ' + operand + ' ' + pushParam(value)",
+        '  }',
+        "  if (field === ".concat(JSON.stringify(product_price_sort_1.PRODUCT_PRICE_SORT_FIELD), ") {"),
+        "    return compare(".concat(JSON.stringify('(' + (0, product_price_sort_1.buildProductEffectivePriceSql)() + ')'), ", scalarOps, false)"),
+        '  }',
+        "  if (field === ".concat(JSON.stringify(exports.PRODUCT_RATING_FILTER_FIELD), ") {"),
+        "    return compare(".concat(JSON.stringify((0, exports.buildProductRatingBucketSql)()), ", scalarOps, true)"),
+        '  }',
+        "  if (field === ".concat(JSON.stringify(exports.PRODUCT_ON_SALE_FILTER_FIELD), ") {"),
+        "    return compare(".concat(JSON.stringify((0, exports.buildProductOnSaleSql)()), ", equalityOps, true)"),
+        '  }',
+        "  if (field.indexOf(".concat(JSON.stringify(exports.PRODUCT_VARIANT_AXIS_FILTER_PREFIX), ") === 0) {"),
+        "    var axisKey = field.slice(".concat(exports.PRODUCT_VARIANT_AXIS_FILTER_PREFIX.length, ")"),
+        "    if (!new RegExp(".concat(JSON.stringify(exports.PRODUCT_VARIANT_AXIS_KEY_PATTERN), ").test(axisKey)) {"),
+        '      // Not a key the editor could have written: no rows, never an error.',
+        "      return 'FALSE'",
+        '    }',
+        "    if (operand !== '=') return 'FALSE'",
+        '    var values = (Array.isArray(value) ? value : [value]).map(String)',
+        '    var keyParam = pushParam(axisKey)',
+        '    var valuesParam = pushParam(values)',
+        "    return ".concat(JSON.stringify((0, exports.buildProductVariantAxisExistsSql)('__KEY__', '__VALUES__'))),
+        // Function replacements: a "$1" inside a replacement STRING is a special
+        // pattern, so the placeholders are swapped by callback.
+        "      .replace('__KEY__', function () { return keyParam })",
+        "      .replace('__VALUES__', function () { return valuesParam })",
+        '  }',
+        '  return null',
+        '}',
+    ];
+    return lines.join('\n');
+};
+exports.generateProductFilterClauseHelper = generateProductFilterClauseHelper;
+//# sourceMappingURL=product-filter-fields.js.map

package/dist/cjs/product-filter-fields.js.map

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

package/dist/cjs/request-locale.d.ts

@@ -0,0 +1,49 @@
+import * as types from '@babel/types';
+import type { UIDLDependency } from '@teleporthq/teleport-types';
+/**
+ * How a generated data-source fetch says which language it is for.
+ *
+ * A multi-language project stores a translatable column once per language
+ * (`name`, `es_name`, …) and the generated fetcher resolves each row against
+ * ONE of them (see `transformations/` and `localized-columns.ts`). Nothing
+ * about the API route knows the page it serves — an API route has no locale
+ * segment in its URL — so the page tells it, through this query parameter:
+ *
+ *   - a client-side fetch (`DataProvider` `params`) sends `router.locale`;
+ *   - a build-time fetch inside `getStaticProps` sends `context.locale`.
+ *
+ * Both are what Next.js resolved from the `/es/...` route, so the rows a page
+ * renders are in the language the page is in. The same name the details-page
+ * fetch (`teleport-plugin-next-static-props`) has always sent.
+ */
+export declare const REQUEST_LOCALE_PARAM = "locale";
+/**
+ * `router?.locale` — the client's current locale. Optional-chained like every
+ * other generated `router` read: `useRouter()` answers `null` during a static
+ * export's first paint.
+ */
+export declare const buildClientLocaleExpression: () => types.Expression;
+/** `locale: router?.locale` — the param of a client-side fetch. */
+export declare const buildClientLocaleParam: () => types.ObjectProperty;
+/** `locale: context.locale` — the param of a fetch inside getStaticProps. */
+export declare const buildServerLocaleParam: () => types.ObjectProperty;
+/** Whether an object literal already carries the locale param. */
+export declare const hasLocaleParam: (properties: types.ObjectExpression['properties']) => boolean;
+/**
+ * Adds the client locale to a fetch's params, once, and to the `useMemo` deps
+ * that must rebuild them: a locale switch is a client-side transition on the
+ * SAME page instance, so only a dependency change refetches the rows in the
+ * new language.
+ */
+export declare const appendClientLocaleParam: (paramsProps: types.ObjectExpression['properties'], memoDeps: types.Expression[]) => void;
+/**
+ * Puts `const router = useRouter()` (and its import) in scope, once.
+ *
+ * Idempotent with every sibling plugin that declares the same hook — the i18n
+ * locale mapper, the URL search-params plugin and the base component plugin
+ * all guard on the same identifier, so whichever runs first wins and the rest
+ * find it in place. Unshifted to the top of the body: nothing reads it before
+ * an effect runs, and hooks must not sit below a conditional return.
+ */
+export declare const ensureRouterDeclaration: (body: types.Statement[], dependencies: Record<string, UIDLDependency>) => void;
+//# sourceMappingURL=request-locale.d.ts.map

package/dist/cjs/request-locale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-locale.d.ts","sourceRoot":"","sources":["../../src/request-locale.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAEhE;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,oBAAoB,WAAW,CAAA;AAU5C;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,QAAO,MAAM,UAMlD,CAAA;AAEH,mEAAmE;AACnE,eAAO,MAAM,sBAAsB,QAAO,MAAM,cAC6C,CAAA;AAE7F,6EAA6E;AAC7E,eAAO,MAAM,sBAAsB,QAAO,MAAM,cAI7C,CAAA;AAEH,kEAAkE;AAClE,eAAO,MAAM,cAAc,eAAgB,MAAM,gBAAgB,CAAC,YAAY,CAAC,KAAG,OAM/E,CAAA;AAEH;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,gBACrB,MAAM,gBAAgB,CAAC,YAAY,CAAC,YACvC,MAAM,UAAU,EAAE,KAC3B,IAKF,CAAA;AASD;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,SAC5B,MAAM,SAAS,EAAE,gBACT,OAAO,MAAM,EAAE,cAAc,CAAC,KAC3C,IAeF,CAAA"}

package/dist/cjs/request-locale.js

@@ -0,0 +1,130 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureRouterDeclaration = exports.appendClientLocaleParam = exports.hasLocaleParam = exports.buildServerLocaleParam = exports.buildClientLocaleParam = exports.buildClientLocaleExpression = exports.REQUEST_LOCALE_PARAM = void 0;
+var types = __importStar(require("@babel/types"));
+/**
+ * How a generated data-source fetch says which language it is for.
+ *
+ * A multi-language project stores a translatable column once per language
+ * (`name`, `es_name`, …) and the generated fetcher resolves each row against
+ * ONE of them (see `transformations/` and `localized-columns.ts`). Nothing
+ * about the API route knows the page it serves — an API route has no locale
+ * segment in its URL — so the page tells it, through this query parameter:
+ *
+ *   - a client-side fetch (`DataProvider` `params`) sends `router.locale`;
+ *   - a build-time fetch inside `getStaticProps` sends `context.locale`.
+ *
+ * Both are what Next.js resolved from the `/es/...` route, so the rows a page
+ * renders are in the language the page is in. The same name the details-page
+ * fetch (`teleport-plugin-next-static-props`) has always sent.
+ */
+exports.REQUEST_LOCALE_PARAM = 'locale';
+/** The dependency behind the `router` every client-side locale read closes over. */
+var USE_ROUTER_DEPENDENCY = {
+    type: 'library',
+    path: 'next/router',
+    version: '^12.1.10',
+    meta: { namedImport: true },
+};
+/**
+ * `router?.locale` — the client's current locale. Optional-chained like every
+ * other generated `router` read: `useRouter()` answers `null` during a static
+ * export's first paint.
+ */
+var buildClientLocaleExpression = function () {
+    return types.optionalMemberExpression(types.identifier('router'), types.identifier('locale'), false, true);
+};
+exports.buildClientLocaleExpression = buildClientLocaleExpression;
+/** `locale: router?.locale` — the param of a client-side fetch. */
+var buildClientLocaleParam = function () {
+    return types.objectProperty(types.identifier(exports.REQUEST_LOCALE_PARAM), (0, exports.buildClientLocaleExpression)());
+};
+exports.buildClientLocaleParam = buildClientLocaleParam;
+/** `locale: context.locale` — the param of a fetch inside getStaticProps. */
+var buildServerLocaleParam = function () {
+    return types.objectProperty(types.identifier(exports.REQUEST_LOCALE_PARAM), types.memberExpression(types.identifier('context'), types.identifier('locale')));
+};
+exports.buildServerLocaleParam = buildServerLocaleParam;
+/** Whether an object literal already carries the locale param. */
+var hasLocaleParam = function (properties) {
+    return properties.some(function (property) {
+        return property.type === 'ObjectProperty' &&
+            ((property.key.type === 'Identifier' && property.key.name === exports.REQUEST_LOCALE_PARAM) ||
+                (property.key.type === 'StringLiteral' && property.key.value === exports.REQUEST_LOCALE_PARAM));
+    });
+};
+exports.hasLocaleParam = hasLocaleParam;
+/**
+ * Adds the client locale to a fetch's params, once, and to the `useMemo` deps
+ * that must rebuild them: a locale switch is a client-side transition on the
+ * SAME page instance, so only a dependency change refetches the rows in the
+ * new language.
+ */
+var appendClientLocaleParam = function (paramsProps, memoDeps) {
+    if (!(0, exports.hasLocaleParam)(paramsProps)) {
+        paramsProps.push((0, exports.buildClientLocaleParam)());
+    }
+    memoDeps.push((0, exports.buildClientLocaleExpression)());
+};
+exports.appendClientLocaleParam = appendClientLocaleParam;
+/** Any declaration of `router` — a second one, however it is initialised, is a syntax error. */
+var declaresRouter = function (statement) {
+    return statement.type === 'VariableDeclaration' &&
+        statement.declarations.some(function (declaration) { return declaration.id.type === 'Identifier' && declaration.id.name === 'router'; });
+};
+/**
+ * Puts `const router = useRouter()` (and its import) in scope, once.
+ *
+ * Idempotent with every sibling plugin that declares the same hook — the i18n
+ * locale mapper, the URL search-params plugin and the base component plugin
+ * all guard on the same identifier, so whichever runs first wins and the rest
+ * find it in place. Unshifted to the top of the body: nothing reads it before
+ * an effect runs, and hooks must not sit below a conditional return.
+ */
+var ensureRouterDeclaration = function (body, dependencies) {
+    if (!dependencies.useRouter) {
+        dependencies.useRouter = __assign({}, USE_ROUTER_DEPENDENCY);
+    }
+    if (body.some(declaresRouter)) {
+        return;
+    }
+    body.unshift(types.variableDeclaration('const', [
+        types.variableDeclarator(types.identifier('router'), types.callExpression(types.identifier('useRouter'), [])),
+    ]));
+};
+exports.ensureRouterDeclaration = ensureRouterDeclaration;
+//# sourceMappingURL=request-locale.js.map

package/dist/cjs/request-locale.js.map

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

package/dist/cjs/search-clear.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The "clear search" button a listing's search field carries — marked
+ * `data-tq-search-clear` by the editor (`listing-search-field.ts`), the same
+ * marker the canvas renderer acts on. The search keyword is the mapper's own
+ * React state, which no authored workflow can reach, so the generator wires
+ * the button here: a click empties the query, and the button renders only
+ * while the query is non-empty.
+ *
+ * A button belongs to the search input it shares a parent with — the field
+ * wrapper — never to "the next search-enabled mapper": a page with two lists
+ * and one clear button would otherwise wire it to the wrong list.
+ */
+export declare const SEARCH_CLEAR_ATTR = "data-tq-search-clear";
+export interface SearchClearButton {
+    node: any;
+    parent: any;
+    index: number;
+}
+/** Every marked button under `root`, with the JSX parent and child index it sits at. */
+export declare function findAllSearchClearButtonsInJSX(root: any): SearchClearButton[];
+/** The search input the button shares its parent with, or null. */
+export declare function findSiblingSearchInput(button: SearchClearButton, searchInputs: any[]): any | null;
+/**
+ * Wires one button: `onClick` empties the query, and the element is replaced
+ * in its parent by `{query ? <button…/> : null}`.
+ */
+export declare function wireSearchClearButton(button: SearchClearButton, vars: {
+    searchQueryVar: string;
+    setSearchQueryVar: string;
+}): void;
+//# sourceMappingURL=search-clear.d.ts.map

package/dist/cjs/search-clear.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-clear.d.ts","sourceRoot":"","sources":["../../src/search-clear.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,iBAAiB,yBAAyB,CAAA;AAIvD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,GAAG,CAAA;IACT,MAAM,EAAE,GAAG,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;CACd;AAQD,wFAAwF;AACxF,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,GAAG,GAAG,iBAAiB,EAAE,CAqC7E;AAED,mEAAmE;AACnE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,iBAAiB,EAAE,YAAY,EAAE,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,CAGjG;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,GAC1D,IAAI,CAgBN"}

package/dist/cjs/search-clear.js

@@ -0,0 +1,103 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wireSearchClearButton = exports.findSiblingSearchInput = exports.findAllSearchClearButtonsInJSX = exports.SEARCH_CLEAR_ATTR = void 0;
+var types = __importStar(require("@babel/types"));
+var pagination_controls_1 = require("./pagination-controls");
+/**
+ * The "clear search" button a listing's search field carries — marked
+ * `data-tq-search-clear` by the editor (`listing-search-field.ts`), the same
+ * marker the canvas renderer acts on. The search keyword is the mapper's own
+ * React state, which no authored workflow can reach, so the generator wires
+ * the button here: a click empties the query, and the button renders only
+ * while the query is non-empty.
+ *
+ * A button belongs to the search input it shares a parent with — the field
+ * wrapper — never to "the next search-enabled mapper": a page with two lists
+ * and one clear button would otherwise wire it to the wrong list.
+ */
+exports.SEARCH_CLEAR_ATTR = 'data-tq-search-clear';
+function hasSearchClearMarker(node) {
+    var _a, _b;
+    return !!((_b = (_a = node === null || node === void 0 ? void 0 : node.openingElement) === null || _a === void 0 ? void 0 : _a.attributes) === null || _b === void 0 ? void 0 : _b.some(function (attr) { var _a; return attr.type === 'JSXAttribute' && ((_a = attr.name) === null || _a === void 0 ? void 0 : _a.name) === exports.SEARCH_CLEAR_ATTR; }));
+}
+/** Every marked button under `root`, with the JSX parent and child index it sits at. */
+function findAllSearchClearButtonsInJSX(root) {
+    var results = [];
+    var traverse = function (node) {
+        if (!node) {
+            return;
+        }
+        if (node.type === 'JSXElement' && Array.isArray(node.children)) {
+            node.children.forEach(function (child, index) {
+                if ((child === null || child === void 0 ? void 0 : child.type) === 'JSXElement' && hasSearchClearMarker(child)) {
+                    results.push({ node: child, parent: node, index: index });
+                }
+                traverse(child);
+            });
+            return;
+        }
+        if (node.body) {
+            if (Array.isArray(node.body)) {
+                node.body.forEach(function (statement) { return traverse(statement); });
+            }
+            else {
+                traverse(node.body);
+            }
+        }
+        if (node.consequent) {
+            traverse(node.consequent);
+        }
+        if (node.alternate) {
+            traverse(node.alternate);
+        }
+        if (node.expression) {
+            traverse(node.expression);
+        }
+        if (node.argument) {
+            traverse(node.argument);
+        }
+    };
+    traverse(root);
+    return results;
+}
+exports.findAllSearchClearButtonsInJSX = findAllSearchClearButtonsInJSX;
+/** The search input the button shares its parent with, or null. */
+function findSiblingSearchInput(button, searchInputs) {
+    var _a, _b;
+    var siblings = (_a = button.parent.children) !== null && _a !== void 0 ? _a : [];
+    return (_b = siblings.find(function (sibling) { return searchInputs.includes(sibling); })) !== null && _b !== void 0 ? _b : null;
+}
+exports.findSiblingSearchInput = findSiblingSearchInput;
+/**
+ * Wires one button: `onClick` empties the query, and the element is replaced
+ * in its parent by `{query ? <button…/> : null}`.
+ */
+function wireSearchClearButton(button, vars) {
+    (0, pagination_controls_1.setJSXExpressionAttribute)(button.node, 'onClick', types.arrowFunctionExpression([], types.callExpression(types.identifier(vars.setSearchQueryVar), [types.stringLiteral('')])));
+    button.parent.children[button.index] = types.jsxExpressionContainer(types.conditionalExpression(types.identifier(vars.searchQueryVar), button.node, types.nullLiteral()));
+}
+exports.wireSearchClearButton = wireSearchClearButton;
+//# sourceMappingURL=search-clear.js.map

package/dist/cjs/search-clear.js.map

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

package/dist/cjs/transformations/blog-adjacent-posts.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Generates the code that finds a post's neighbours for its "previous / next"
+ * navigation: the published posts right before and after it in the order the
+ * blog listing shows them (`created_at`, then `id`, newest first). "Previous"
+ * is the older one.
+ *
+ * Only a post DETAILS fetch (a single record) asks. A neighbour whose row
+ * carries a redirect is skipped — linking to it would only bounce the reader
+ * somewhere else — which is read off the row in code rather than in SQL, so a
+ * table provisioned before the SEO columns still works.
+ *
+ * MUST mirror `findAdjacentBlogPosts` in teleport-gui
+ * `packages/renderer/src/utils/blog-adjacent-posts.ts` (the canvas).
+ */
+export declare const generateAdjacentPostsCode: () => string;
+//# sourceMappingURL=blog-adjacent-posts.d.ts.map

package/dist/cjs/transformations/blog-adjacent-posts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog-adjacent-posts.d.ts","sourceRoot":"","sources":["../../../src/transformations/blog-adjacent-posts.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,yBAAyB,QAAO,MAqD5C,CAAA"}

package/dist/cjs/transformations/blog-adjacent-posts.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateAdjacentPostsCode = void 0;
+/**
+ * How many posts each direction is read, so a neighbour that only REDIRECTS
+ * elsewhere can be stepped over without a second query.
+ */
+var ADJACENT_POST_CANDIDATES = 5;
+/**
+ * Generates the code that finds a post's neighbours for its "previous / next"
+ * navigation: the published posts right before and after it in the order the
+ * blog listing shows them (`created_at`, then `id`, newest first). "Previous"
+ * is the older one.
+ *
+ * Only a post DETAILS fetch (a single record) asks. A neighbour whose row
+ * carries a redirect is skipped — linking to it would only bounce the reader
+ * somewhere else — which is read off the row in code rather than in SQL, so a
+ * table provisioned before the SEO columns still works.
+ *
+ * MUST mirror `findAdjacentBlogPosts` in teleport-gui
+ * `packages/renderer/src/utils/blog-adjacent-posts.ts` (the canvas).
+ */
+var generateAdjacentPostsCode = function () { return "\nvar BLOG_ADJACENT_CANDIDATES = ".concat(ADJACENT_POST_CANDIDATES, "\n\nfunction blogAdjacentPostsSql(comparison, direction) {\n  return (\n    'SELECT p.* FROM teleport_blog_posts p,' +\n    ' (SELECT created_at, id FROM teleport_blog_posts WHERE id = $1) cur' +\n    \" WHERE p.status = 'published' AND (p.created_at, p.id) \" + comparison + ' (cur.created_at, cur.id)' +\n    ' ORDER BY p.created_at ' + direction + ', p.id ' + direction +\n    ' LIMIT ' + BLOG_ADJACENT_CANDIDATES\n  )\n}\n\nfunction firstLinkableBlogPost(result) {\n  var rows = result && Array.isArray(result.rows) ? result.rows : []\n  for (var i = 0; i < rows.length; i++) {\n    var row = rows[i]\n    if (!row) continue\n    var redirect = pickFirst(row.redirect_url, row.redirectUrl)\n    if (typeof redirect === 'string' && redirect.trim() !== '') continue\n    // Through JSON, like the rows the fetcher itself hands the transform.\n    return JSON.parse(JSON.stringify(row))\n  }\n  return null\n}\n\n// { [postId]: { previous, next } } \u2014 raw rows or null \u2014 for a single-record\n// fetch; {} otherwise and on any failure (the navigation then hides).\nasync function getAdjacentPostsMap(getClientFn, records) {\n  var map = {}\n  if (!Array.isArray(records) || records.length !== 1) return map\n  var postId = records[0] && records[0].id\n  if (postId === null || postId === undefined) return map\n\n  var client\n  try {\n    client = getClientFn()\n    await client.connect()\n    var older = await client.query(blogAdjacentPostsSql('<', 'DESC'), [String(postId)])\n    var newer = await client.query(blogAdjacentPostsSql('>', 'ASC'), [String(postId)])\n    map[String(postId)] = {\n      previous: firstLinkableBlogPost(older),\n      next: firstLinkableBlogPost(newer),\n    }\n  } catch (e) {\n    // Leaves the navigation hidden.\n  } finally {\n    if (client) {\n      try { await client.end() } catch (e) { /* ignore */ }\n    }\n  }\n  return map\n}\n"); };
+exports.generateAdjacentPostsCode = generateAdjacentPostsCode;
+//# sourceMappingURL=blog-adjacent-posts.js.map

package/dist/cjs/transformations/blog-adjacent-posts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog-adjacent-posts.js","sourceRoot":"","sources":["../../../src/transformations/blog-adjacent-posts.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,IAAM,wBAAwB,GAAG,CAAC,CAAA;AAElC;;;;;;;;;;;;;GAaG;AACI,IAAM,yBAAyB,GAAG,cAAc,OAAA,2CACtB,wBAAwB,g2DAoDxD,EArDsD,CAqDtD,CAAA;AArDY,QAAA,yBAAyB,6BAqDrC"}

package/dist/cjs/transformations/blog-comments.d.ts

@@ -0,0 +1,30 @@
+/**
+ * How many TOP-LEVEL comments a post page carries: the newest ones, shown
+ * oldest-first, each with all of its replies. The count in the section's
+ * heading still counts every approved comment.
+ *
+ * ⛔ PAIRED with `BLOG_COMMENTS_RENDER_LIMIT` in teleport-gui
+ * `features/blog/constants/blog-comments.ts` (the canvas mirror).
+ */
+export declare const BLOG_COMMENTS_RENDER_LIMIT = 200;
+/**
+ * Generates the code that loads and shapes a post's approved comments.
+ *
+ * Read server-side, with the post: only a post DETAILS fetch (a single record)
+ * asks, so a listing never pays for it, and the comments arrive in the page's
+ * HTML — rendered by SSR/ISR, carried along a client-side navigation to another
+ * post, no request of their own.
+ *
+ * Public columns only. `teleport_blog_comments` holds the commenters' email
+ * addresses and the comments still waiting for approval, which is why it is a
+ * customer-record table no browser may read (see teleport-shared's
+ * `table-access.ts`); nothing here selects either.
+ *
+ * Replies are one level deep: a reply whose parent is not among the rows (not
+ * approved, deleted) is dropped rather than promoted to the top level.
+ *
+ * MUST mirror `buildBlogComments` in teleport-gui
+ * `packages/renderer/src/utils/blog-comments.ts` (the canvas).
+ */
+export declare const generateBlogCommentsCode: () => string;
+//# sourceMappingURL=blog-comments.d.ts.map

package/dist/cjs/transformations/blog-comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog-comments.d.ts","sourceRoot":"","sources":["../../../src/transformations/blog-comments.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,MAAM,CAAA;AAE7C;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,wBAAwB,QAAO,MAsG3C,CAAA"}

package/dist/cjs/transformations/blog-comments.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateBlogCommentsCode = exports.BLOG_COMMENTS_RENDER_LIMIT = void 0;
+/**
+ * How many TOP-LEVEL comments a post page carries: the newest ones, shown
+ * oldest-first, each with all of its replies. The count in the section's
+ * heading still counts every approved comment.
+ *
+ * ⛔ PAIRED with `BLOG_COMMENTS_RENDER_LIMIT` in teleport-gui
+ * `features/blog/constants/blog-comments.ts` (the canvas mirror).
+ */
+exports.BLOG_COMMENTS_RENDER_LIMIT = 200;
+/**
+ * Generates the code that loads and shapes a post's approved comments.
+ *
+ * Read server-side, with the post: only a post DETAILS fetch (a single record)
+ * asks, so a listing never pays for it, and the comments arrive in the page's
+ * HTML — rendered by SSR/ISR, carried along a client-side navigation to another
+ * post, no request of their own.
+ *
+ * Public columns only. `teleport_blog_comments` holds the commenters' email
+ * addresses and the comments still waiting for approval, which is why it is a
+ * customer-record table no browser may read (see teleport-shared's
+ * `table-access.ts`); nothing here selects either.
+ *
+ * Replies are one level deep: a reply whose parent is not among the rows (not
+ * approved, deleted) is dropped rather than promoted to the top level.
+ *
+ * MUST mirror `buildBlogComments` in teleport-gui
+ * `packages/renderer/src/utils/blog-comments.ts` (the canvas).
+ */
+var generateBlogCommentsCode = function () { return "\nvar BLOG_COMMENTS_RENDER_LIMIT = ".concat(exports.BLOG_COMMENTS_RENDER_LIMIT, "\n\nvar BLOG_COMMENTS_SQL =\n  'WITH top AS (' +\n  ' SELECT id FROM teleport_blog_comments' +\n  \" WHERE post_id = $1 AND parent_id IS NULL AND status = 'approved'\" +\n  ' ORDER BY created_at DESC, id DESC LIMIT ' + BLOG_COMMENTS_RENDER_LIMIT +\n  ')' +\n  ' SELECT c.id, c.parent_id, c.author_name, c.content, c.is_author_reply, c.created_at' +\n  ' FROM teleport_blog_comments c' +\n  \" WHERE c.post_id = $1 AND c.status = 'approved'\" +\n  ' AND (c.id IN (SELECT id FROM top) OR c.parent_id IN (SELECT id FROM top))' +\n  ' ORDER BY c.created_at ASC, c.id ASC'\n\n// Every approved comment the page could show \u2014 a reply counts only while the\n// comment it answers is approved too.\nvar BLOG_COMMENTS_COUNT_SQL =\n  'SELECT COUNT(*) AS n FROM teleport_blog_comments c' +\n  \" WHERE c.post_id = $1 AND c.status = 'approved'\" +\n  ' AND (c.parent_id IS NULL OR EXISTS (' +\n  ' SELECT 1 FROM teleport_blog_comments p' +\n  \" WHERE p.id = c.parent_id AND p.status = 'approved'))\"\n\nfunction blogAuthorInitials(name) {\n  if (typeof name !== 'string') return ''\n  var words = name.trim().split(' ').filter(function(word) { return word !== '' })\n  if (words.length === 0) return ''\n  // Code points, not UTF-16 units: an initial may be an emoji or a letter\n  // outside the BMP, and half of a surrogate pair renders as a box.\n  var first = Array.from(words[0])[0] || ''\n  var last = words.length > 1 ? Array.from(words[words.length - 1])[0] || '' : ''\n  return (first + last).toUpperCase()\n}\n\nfunction buildBlogComment(row) {\n  var name = typeof row.author_name === 'string' ? row.author_name.trim() : ''\n  var authorName = name || 'Reader'\n  return {\n    id: String(row.id),\n    authorName: authorName,\n    authorInitials: blogAuthorInitials(authorName),\n    content: typeof row.content === 'string' ? row.content : '',\n    createdAt: normalizeTimestamp(row.created_at),\n    isAuthorReply: coerceBoolean(row.is_author_reply, false),\n  }\n}\n\nfunction isTopLevelComment(row) {\n  return row.parent_id === null || row.parent_id === undefined || row.parent_id === ''\n}\n\nfunction buildBlogComments(rows) {\n  var comments = []\n  if (!Array.isArray(rows)) return comments\n  var byId = {}\n  for (var i = 0; i < rows.length; i++) {\n    var row = rows[i]\n    if (!row || row.id == null || !isTopLevelComment(row)) continue\n    var comment = buildBlogComment(row)\n    comment.replies = []\n    byId[comment.id] = comment\n    comments.push(comment)\n  }\n  for (var j = 0; j < rows.length; j++) {\n    var reply = rows[j]\n    if (!reply || reply.id == null || isTopLevelComment(reply)) continue\n    var parent = byId[String(reply.parent_id)]\n    if (parent) parent.replies.push(buildBlogComment(reply))\n  }\n  return comments\n}\n\n// { [postId]: { rows, count } } for a single-record (details) fetch; {} for\n// anything else, and on any failure \u2014 a blog whose comments table does not\n// exist yet renders its posts without comments rather than failing the page.\nasync function getBlogCommentsMap(getClientFn, records) {\n  var map = {}\n  if (!Array.isArray(records) || records.length !== 1) return map\n  var postId = records[0] && records[0].id\n  if (postId === null || postId === undefined) return map\n\n  var client\n  try {\n    client = getClientFn()\n    await client.connect()\n    var listed = await client.query(BLOG_COMMENTS_SQL, [String(postId)])\n    var counted = await client.query(BLOG_COMMENTS_COUNT_SQL, [String(postId)])\n    // Through JSON, like every other row the fetcher hands the transform: the\n    // driver returns timestamps as Date objects.\n    var rows = listed && Array.isArray(listed.rows) ? JSON.parse(JSON.stringify(listed.rows)) : []\n    var count = counted && counted.rows && counted.rows[0] ? Number(counted.rows[0].n) : NaN\n    map[String(postId)] = { rows: rows, count: isNaN(count) ? rows.length : count }\n  } catch (e) {\n    // Leaves the post without comments.\n  } finally {\n    if (client) {\n      try { await client.end() } catch (e) { /* ignore */ }\n    }\n  }\n  return map\n}\n"); };
+exports.generateBlogCommentsCode = generateBlogCommentsCode;
+//# sourceMappingURL=blog-comments.js.map