@teleporthq/teleport-shared 0.43.74 → 0.43.75

package/dist/esm/utils/table-access.js

@@ -7,6 +7,7 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
     }
     return to.concat(ar || Array.prototype.slice.call(from));
 };
+import { CONTENT_COMMENTS_TABLES } from './content-tables';
 /**
  * Which store tables a browser may touch through the generated data routes.
  *
@@ -58,7 +59,7 @@ export var MONEY_TABLES = [
     'teleport_product_files',
     'teleport_license_keys',
 ];
-export var CUSTOMER_RECORD_TABLES = [
+export var CUSTOMER_RECORD_TABLES = __spreadArray(__spreadArray([
     'users',
     'teleport_orders',
     'teleport_order_items',
@@ -83,11 +84,8 @@ export var CUSTOMER_RECORD_TABLES = [
     'teleport_product_reviews',
     // A push subscription is a capability: whoever holds the endpoint and its
     // keys can notify that device. Only the app's push routes read the table.
-    'teleport_push_subscriptions',
-    // A comment is public once approved, but the row carries the commenter's
-    // email and the comments still waiting for approval; the post page reads
-    // the approved ones server-side, public columns only.
-    'teleport_blog_comments',
+    'teleport_push_subscriptions'
+], CONTENT_COMMENTS_TABLES, true), [
     // What visitors told the AI assistant, and the merchant's private knowledge
     // base it answers from: the assistant reads them in its own server
     // segments, the admin lists them with its session.
@@ -95,7 +93,7 @@ export var CUSTOMER_RECORD_TABLES = [
     'teleport_ai_chat_documents',
     'teleport_ai_chat_conversations',
     'teleport_ai_chat_messages',
-];
+], false);
 export var PROTECTED_TABLES = __spreadArray(__spreadArray([], MONEY_TABLES, true), CUSTOMER_RECORD_TABLES, true);
 export var WRITE_PROTECTED_TABLES = ['teleport_discounts'];
 /**

package/dist/esm/utils/table-access.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@teleporthq/teleport-shared",
-  "version": "0.43.74",
+  "version": "0.43.75",
   "description": "A utility belt for the entire teleportHQ ecosystem",
   "author": "teleportHQ",
   "license": "MIT",
@@ -25,9 +25,9 @@
   },
   "dependencies": {
     "@babel/types": "^7.5.5",
-    "@teleporthq/teleport-types": "^0.43.71",
+    "@teleporthq/teleport-types": "^0.43.75",
     "jss": "^10.0.0",
     "jss-preset-default": "^10.0.0"
   },
-  "gitHead": "ba42bebcf5037a88ca40e2f0714cc476a7aa1f82"
+  "gitHead": "4bc0af8166575b4af971f39e63228ce2eefce661"
 }

package/src/index.ts

@@ -20,12 +20,15 @@ import * as ProductOptions from './utils/product-options'
 import * as CartLinePricing from './utils/cart-line-pricing'
 import * as CartCurrency from './utils/cart-currency'
 import * as TableAccess from './utils/table-access'
+import * as ContentTables from './utils/content-tables'
 import * as SessionCookieResolver from './utils/session-cookie-resolver'
 import * as SubscriptionAccess from './utils/subscription-access'
 import * as FontPreconnect from './utils/font-preconnect'
 import * as EmailDate from './utils/email-date'
 import * as RichTextEmbeds from './utils/rich-text-embeds'
 import * as RichTextEmbedsCodegen from './utils/rich-text-embeds-codegen'
+import * as RichTextContent from './utils/rich-text-content'
+import * as RichTextContentCodegen from './utils/rich-text-content-codegen'
 import * as DataCache from './cache'
 import * as PageRevalidate from './page-revalidate'
 import * as ScrollSceneRuntime from './scroll-scene'
@@ -58,12 +61,15 @@ export {
   CartLinePricing,
   CartCurrency,
   TableAccess,
+  ContentTables,
   SessionCookieResolver,
   SubscriptionAccess,
   FontPreconnect,
   EmailDate,
   RichTextEmbeds,
   RichTextEmbedsCodegen,
+  RichTextContent,
+  RichTextContentCodegen,
   DataCache,
   PageRevalidate,
   ScrollSceneRuntime,

package/src/utils/content-tables.ts

@@ -0,0 +1,151 @@
+/**
+ * The content presets — the Blog, and every feature built like it — and the
+ * tables each one keeps. The ONE list the editor and the generators read: the
+ * editor's `ContentPreset` is built on these entries, the generated site's
+ * read routes, view models and feeds recognise a content table through
+ * `contentTableRole`. A preset added here and nowhere else is caught by the
+ * editor's wiring test; a table named anywhere else is a copy that drifts.
+ */
+
+export type ContentPresetKey = 'blog' | 'help'
+
+export type ContentTableRole = 'posts' | 'comments'
+
+export interface ContentTables {
+  key: ContentPresetKey
+  /** The rows the preset publishes: one per post / article. */
+  posts: string
+  /** Reader comments under a post, when the preset takes them. */
+  comments: string | null
+  /**
+   * Whether a post without a picture is shown with the grey "No image" stand-in.
+   * Off for a preset whose posts are text: its cards and post page close up
+   * instead of drawing an empty grey box on every article.
+   */
+  pictureStandIn: boolean
+}
+
+export const CONTENT_TABLES: ReadonlyArray<ContentTables> = [
+  {
+    key: 'blog',
+    posts: 'teleport_blog_posts',
+    comments: 'teleport_blog_comments',
+    pictureStandIn: true,
+  },
+  // The Help Center: articles at /help/<slug>, no reader comments, and a text
+  // article shows no picture at all rather than a stand-in.
+  { key: 'help', posts: 'teleport_help_articles', comments: null, pictureStandIn: false },
+]
+
+export const CONTENT_POSTS_TABLES: ReadonlyArray<string> = CONTENT_TABLES.map(
+  (tables) => tables.posts
+)
+
+export const CONTENT_COMMENTS_TABLES: ReadonlyArray<string> = CONTENT_TABLES.map(
+  (tables) => tables.comments
+).filter((table): table is string => table !== null)
+
+export const contentTablesByKey = (key: ContentPresetKey): ContentTables => {
+  const tables = CONTENT_TABLES.find((entry) => entry.key === key)
+  if (!tables) {
+    throw new Error(`No content preset is registered under "${key}"`)
+  }
+  return tables
+}
+
+/** Which preset a table belongs to and what it holds there; null for any other table. */
+export const contentTableRole = (
+  tableName: string
+): { key: ContentPresetKey; role: ContentTableRole } | null => {
+  for (const tables of CONTENT_TABLES) {
+    if (tableName === tables.posts) {
+      return { key: tables.key, role: 'posts' }
+    }
+    if (tableName === tables.comments) {
+      return { key: tables.key, role: 'comments' }
+    }
+  }
+  return null
+}
+
+export const isContentPostsTable = (tableName: string): boolean =>
+  contentTableRole(tableName)?.role === 'posts'
+
+export interface VisitorRowPolicy {
+  /** SQL every browser read of the table is narrowed with. */
+  predicate: string
+  /** Keys never served to a browser, wherever they sit in a row (raw and transformed names). */
+  hiddenColumns: ReadonlyArray<string>
+}
+
+/**
+ * What a visitor is served of a posts table: ONLY `published` rows — drafts,
+ * scheduled and archived posts are the author's (the editor's post statuses in
+ * `blog-post-status.ts`) — and never the author's email address.
+ */
+export const CONTENT_POSTS_VISITOR_ROW_POLICY: VisitorRowPolicy = {
+  predicate: "status = 'published'",
+  hiddenColumns: ['author_email', 'authorEmail'],
+}
+
+/**
+ * What a browser is served of the tables whose unpublished rows sit beside the
+ * public ones. Read by both route families of a generated site — the per-table
+ * read routes (teleport-plugin-next-data-source) and the workflow data API
+ * (teleport-plugin-next-workflows) — so no reader can disagree about what a
+ * visitor sees.
+ */
+export const VISITOR_ROW_POLICIES: Readonly<Record<string, VisitorRowPolicy>> = {
+  ...Object.fromEntries(
+    CONTENT_POSTS_TABLES.map((table) => [table, CONTENT_POSTS_VISITOR_ROW_POLICY])
+  ),
+  // The storefront sells `active` products; a draft or inactive one is the
+  // merchant's, spelled in any case the admin form stored it in.
+  teleport_products: {
+    predicate: "LOWER(TRIM(status)) = 'active'",
+    hiddenColumns: [],
+  },
+}
+
+/* ------------------------------------------------------------------------ */
+/* Category pages                                                            */
+/* ------------------------------------------------------------------------ */
+
+/**
+ * The generated module a preset's category page reads from — one function
+ * resolves the category at a slug with its published posts for
+ * `getStaticProps`, the other lists every category's slug for
+ * `getStaticPaths`. The editor names them on the page's UIDL (an external
+ * resource with a local dependency), the Next generator emits them; both read
+ * the names from here, so neither can misspell the other.
+ */
+export const CONTENT_CATEGORY_PAGES_MODULE = '@/content-category-pages'
+
+const presetPascalCase = (key: ContentPresetKey): string =>
+  key.charAt(0).toUpperCase() + key.slice(1)
+
+/** `resolveHelpCategoryPage`: `{ data: category | null }` for a slug. */
+export const contentCategoryPageResolverName = (key: ContentPresetKey): string =>
+  `resolve${presetPascalCase(key)}CategoryPage`
+
+/** `listHelpCategoryPaths`: `{ data: [{ slug }] }`, every category of the tree. */
+export const contentCategoryPathsListerName = (key: ContentPresetKey): string =>
+  `list${presetPascalCase(key)}CategoryPaths`
+
+/* ------------------------------------------------------------------------ */
+/* The live site index                                                       */
+/* ------------------------------------------------------------------------ */
+
+/**
+ * Where the generated site serves a preset's live sitemap: its published posts,
+ * read from the table on request, so a post published after the last publish
+ * is listed too. The editor's own `sitemap.xml` names it from its sitemap
+ * index; both sides read the address from here.
+ */
+export const contentSitemapPath = (key: ContentPresetKey): string => `/sitemap-${key}.xml`
+
+/** The site's list for language models: its pages, then each preset's posts by category. */
+export const LLMS_TXT_PATH = '/llms.txt'
+
+/** Every published post of the presets, in full, as Markdown. */
+export const LLMS_FULL_TXT_PATH = '/llms-full.txt'

package/src/utils/rich-text-content-codegen.ts

@@ -0,0 +1,52 @@
+/**
+ * Code-generation half of the rich-text content contract. Kept apart from
+ * `rich-text-content.ts` on purpose: that module is imported by the studio
+ * editor and the canvas renderer, which are browser bundles. Only the project
+ * generator imports this file.
+ */
+import { RICH_TEXT_CONTENT_RUNTIME_MODULE_SOURCE } from './rich-text-content-runtime-source'
+
+/**
+ * `components/rich-text-content.js` for the generated project: the converter
+ * its rich-text editor runs on the way in and out, and the protected block's
+ * helpers. A STRING committed beside this file for the same reason the embed
+ * runtime is (`generateEmbedRuntimeModuleSource`): the generator runs inside a
+ * minified bundle where `Function.prototype.toString` prints renamed code.
+ * `__tests__/utils/rich-text-content-runtime-module.ts` fails when the string
+ * drifts from `rich-text-content.ts` and regenerates it with
+ * UPDATE_RICH_TEXT_CONTENT_RUNTIME=1.
+ */
+export function generateRichTextContentRuntimeModuleSource(): string {
+  return RICH_TEXT_CONTENT_RUNTIME_MODULE_SOURCE
+}
+
+const RENDER_TIME_NAMES = [
+  'QUILL_LIST_ITEM_ATTR',
+  'escapeRichTextText',
+  'buildCodeBlockHtml',
+  'normalizeLegacyRichTextHtml',
+  'rebuildQuillListHtml',
+  'rebuildQuillCodeBlockHtml',
+  'mergeBlockquoteLines',
+]
+
+/**
+ * The string-only half of the contract as plain declarations, for the data
+ * modules a generated page runs in `getStaticProps`: a post stored before the
+ * contract (the studio's flat list lines, the admin panel's no-break spaces)
+ * renders as stored HTML would, without waiting for its next save. Cut from
+ * the committed runtime module, so it can never drift from it.
+ */
+export function generateLegacyRichTextNormalizerCode(): string {
+  const chunks = RICH_TEXT_CONTENT_RUNTIME_MODULE_SOURCE.split(/\n\n(?=export )/)
+  const picked = RENDER_TIME_NAMES.map((name) => {
+    const chunk = chunks.find((candidate) =>
+      new RegExp(`^export (?:var|function) ${name}\\b`).test(candidate)
+    )
+    if (!chunk) {
+      throw new Error(`Rich-text content runtime has no ${name} to cut for the data module`)
+    }
+    return chunk.replace(/^export /, '').replace(/\n$/, '')
+  })
+  return picked.join('\n\n')
+}