@teleporthq/teleport-shared 0.43.75 → 0.44.0

package/__tests__/page-arrival/page-export.test.ts

@@ -0,0 +1,109 @@
+import generator from '@babel/generator'
+import * as types from '@babel/types'
+import { ChunkType, ComponentStructure, FileType } from '@teleporthq/teleport-types'
+import { PageArrival } from '../../src'
+
+const makeStructure = (
+  params: {
+    folderPath?: string[]
+    exportContent?: types.Node | null
+    withExtractedResources?: boolean
+  } = {}
+): ComponentStructure => {
+  const {
+    folderPath = [],
+    exportContent = types.exportDefaultDeclaration(types.identifier('Customers')),
+    withExtractedResources = true,
+  } = params
+  return {
+    uidl: {
+      name: 'Customers',
+      node: { type: 'element', content: { elementType: 'container' } },
+      outputOptions: { folderPath },
+    },
+    chunks: exportContent
+      ? [
+          {
+            name: 'export',
+            type: ChunkType.AST,
+            fileType: FileType.JS,
+            content: exportContent,
+            linkAfter: ['jsx-component'],
+          },
+        ]
+      : [],
+    dependencies: {},
+    options: {
+      pagesPath: ['pages'],
+      ...(withExtractedResources ? { extractedResources: {} } : {}),
+    },
+  } as unknown as ComponentStructure
+}
+
+const exportCode = (structure: ComponentStructure): string =>
+  generator(structure.chunks.find((chunk) => chunk.name === 'export')?.content as types.Node).code
+
+describe('PageArrival.remountPageOnArrival', () => {
+  it('wraps the default export, imports the wrapper and emits it once', () => {
+    const structure = makeStructure()
+
+    PageArrival.remountPageOnArrival(structure)
+
+    expect(exportCode(structure)).toBe('export default remountOnPageArrival(Customers);')
+    expect(structure.dependencies.remountOnPageArrival).toEqual({
+      type: 'local',
+      path: '../utils/page-arrival',
+    })
+    expect(structure.options.extractedResources?.['utils/page-arrival']).toEqual({
+      fileName: 'page-arrival',
+      fileType: FileType.JS,
+      path: ['utils'],
+      content: PageArrival.generatePageArrivalRuntime(),
+    })
+  })
+
+  it('reaches the wrapper from a page in a subfolder', () => {
+    const structure = makeStructure({ folderPath: ['profile'] })
+
+    PageArrival.remountPageOnArrival(structure)
+
+    expect(structure.dependencies.remountOnPageArrival).toEqual({
+      type: 'local',
+      path: '../../utils/page-arrival',
+    })
+  })
+
+  it('wraps a page only once when several plugins ask for it', () => {
+    const structure = makeStructure()
+
+    PageArrival.remountPageOnArrival(structure)
+    PageArrival.remountPageOnArrival(structure)
+
+    expect(exportCode(structure)).toBe('export default remountOnPageArrival(Customers);')
+  })
+
+  it('changes nothing when the runtime cannot be emitted', () => {
+    const structure = makeStructure({ withExtractedResources: false })
+
+    PageArrival.remountPageOnArrival(structure)
+
+    expect(exportCode(structure)).toBe('export default Customers;')
+    expect(structure.dependencies).toEqual({})
+  })
+
+  it('changes nothing when there is no plain default export to wrap', () => {
+    const withoutExport = makeStructure({ exportContent: null })
+    PageArrival.remountPageOnArrival(withoutExport)
+    expect(withoutExport.dependencies).toEqual({})
+    expect(withoutExport.options.extractedResources).toEqual({})
+
+    const wrappedElsewhere = makeStructure({
+      exportContent: types.exportDefaultDeclaration(
+        types.callExpression(types.identifier('withLayout'), [types.identifier('Customers')])
+      ),
+    })
+    PageArrival.remountPageOnArrival(wrappedElsewhere)
+    expect(exportCode(wrappedElsewhere)).toBe('export default withLayout(Customers);')
+    expect(wrappedElsewhere.dependencies).toEqual({})
+  })
+})

package/__tests__/page-arrival/runtime.test.ts

@@ -0,0 +1,209 @@
+import { transformSync } from '@babel/core'
+import { PageArrival } from '../../src'
+
+/**
+ * Runs the emitted `utils/page-arrival.js` against a one-component hook
+ * runtime and a scriptable `next/router`, and reads the key the page is
+ * rendered with — a new key is a remount, which is what re-runs everything the
+ * page computes on arrival.
+ */
+
+type Handler = (...args: unknown[]) => void
+
+const createFakeRouter = (pathname: string) => {
+  const handlers: Record<string, Handler[]> = {}
+  return {
+    pathname,
+    handlers,
+    events: {
+      on: (event: string, handler: Handler) => {
+        handlers[event] = [...(handlers[event] || []), handler]
+      },
+      off: (event: string, handler: Handler) => {
+        handlers[event] = (handlers[event] || []).filter((candidate) => candidate !== handler)
+      },
+    },
+    emit(event: string, ...args: unknown[]) {
+      ;(handlers[event] || []).slice().forEach((handler) => handler(...args))
+    },
+  }
+}
+
+type FakeRouter = ReturnType<typeof createFakeRouter>
+
+const loadWrapper = (router: FakeRouter) => {
+  const source = PageArrival.generatePageArrivalRuntime()
+    .replace(/^import .*$/gm, '')
+    .replace('export default function', 'function')
+  const code = transformSync(source, {
+    presets: ['@babel/preset-react'],
+    babelrc: false,
+    configFile: false,
+  })?.code
+
+  // One mounted component: state slots survive re-renders, an effect with
+  // `[]` runs on the first render only and its cleanup on unmount.
+  const states: unknown[] = []
+  const cleanups: Array<() => void> = []
+  let stateCursor = 0
+  let effectCursor = 0
+  let onUpdate: () => void = () => undefined
+
+  const React = {
+    createElement: (type: unknown, config: { key?: unknown } & Record<string, unknown>) => ({
+      type,
+      key: config.key,
+      props: config,
+    }),
+  }
+  const useState = (initial: unknown) => {
+    const slot = stateCursor++
+    if (!(slot in states)) {
+      states[slot] = initial
+    }
+    const setState = (next: unknown) => {
+      states[slot] =
+        typeof next === 'function' ? (next as (v: unknown) => unknown)(states[slot]) : next
+      onUpdate()
+    }
+    return [states[slot], setState]
+  }
+  const useEffect = (effect: () => (() => void) | void) => {
+    const slot = effectCursor++
+    if (!(slot in cleanups)) {
+      cleanups[slot] = (effect() as () => void) || (() => undefined)
+    }
+  }
+
+  // tslint:disable-next-line:function-constructor
+  const factory = new Function(
+    'React',
+    'useState',
+    'useEffect',
+    'Router',
+    `${code}\nreturn remountOnPageArrival`
+  )
+  const remountOnPageArrival = factory(React, useState, useEffect, router)
+
+  function Customers(): null {
+    return null
+  }
+  const Wrapped = remountOnPageArrival(Customers)
+
+  let updates = 0
+  const render = () => {
+    stateCursor = 0
+    effectCursor = 0
+    return Wrapped({ title: 'Customers' }) as { type: unknown; key: unknown; props: object }
+  }
+  onUpdate = () => {
+    updates++
+  }
+
+  return {
+    Wrapped,
+    Customers,
+    render,
+    unmount: () => cleanups.forEach((cleanup) => cleanup()),
+    updates: () => updates,
+  }
+}
+
+const navigate = (router: FakeRouter, to: string, options: { shallow: boolean }) => {
+  router.emit('routeChangeStart', to, options)
+  router.pathname = to.split('?')[0]
+  router.emit('routeChangeComplete', to, options)
+}
+
+describe('page-arrival runtime', () => {
+  it('renders the page with its props and a stable first key', () => {
+    const router = createFakeRouter('/customers')
+    const page = loadWrapper(router)
+
+    const element = page.render()
+
+    expect(element.type).toBe(page.Customers)
+    expect(element.key).toBe(0)
+    expect(element.props).toMatchObject({ title: 'Customers' })
+    expect(page.render().key).toBe(0)
+  })
+
+  it('remounts the page when a navigation lands on the page already on screen', () => {
+    const router = createFakeRouter('/customers')
+    const page = loadWrapper(router)
+    page.render()
+
+    navigate(router, '/customers', { shallow: false })
+    expect(page.render().key).toBe(1)
+
+    navigate(router, '/customers?status=open', { shallow: false })
+    expect(page.render().key).toBe(2)
+  })
+
+  it('keeps the page as it is for shallow navigations', () => {
+    const router = createFakeRouter('/customers')
+    const page = loadWrapper(router)
+    page.render()
+
+    navigate(router, '/customers?page=2', { shallow: true })
+
+    expect(page.updates()).toBe(0)
+    expect(page.render().key).toBe(0)
+  })
+
+  it('does not count the navigation that brought the page in', () => {
+    const router = createFakeRouter('/customers')
+    const page = loadWrapper(router)
+    page.render()
+
+    // The page mounted while this navigation was in flight, so it only sees
+    // the completion.
+    router.emit('routeChangeComplete', '/customers', { shallow: false })
+
+    expect(page.updates()).toBe(0)
+  })
+
+  it('ignores a navigation that ends on another route', () => {
+    const router = createFakeRouter('/customers')
+    const page = loadWrapper(router)
+    page.render()
+
+    navigate(router, '/', { shallow: false })
+
+    expect(page.updates()).toBe(0)
+  })
+
+  it('forgets a navigation that failed or was cancelled', () => {
+    const router = createFakeRouter('/customers')
+    const page = loadWrapper(router)
+    page.render()
+
+    router.emit('routeChangeStart', '/customers?id=1', { shallow: false })
+    router.emit('routeChangeError', new Error('cancelled'), '/customers?id=1', { shallow: false })
+    router.emit('routeChangeComplete', '/customers?id=1', { shallow: true })
+
+    expect(page.updates()).toBe(0)
+  })
+
+  it('stops listening once the page unmounts', () => {
+    const router = createFakeRouter('/customers')
+    const page = loadWrapper(router)
+    page.render()
+
+    expect(router.handlers.routeChangeStart).toHaveLength(1)
+    expect(router.handlers.routeChangeComplete).toHaveLength(1)
+    expect(router.handlers.routeChangeError).toHaveLength(1)
+
+    page.unmount()
+
+    expect(router.handlers.routeChangeStart).toHaveLength(0)
+    expect(router.handlers.routeChangeComplete).toHaveLength(0)
+    expect(router.handlers.routeChangeError).toHaveLength(0)
+  })
+
+  it('names the wrapper after the page for React DevTools', () => {
+    const page = loadWrapper(createFakeRouter('/customers'))
+
+    expect(page.Wrapped.displayName).toBe('PageArrival(Customers)')
+  })
+})

package/__tests__/utils/table-access-trusted-reader-roles.ts

@@ -0,0 +1,144 @@
+/* tslint:disable:function-constructor */
+import type { UIDLAuthentication } from '@teleporthq/teleport-types'
+import {
+  generateTableAccessHelperCode,
+  resolveTrustedReaderRoles,
+} from '../../src/utils/table-access'
+
+/**
+ * Who may read the store's private tables (accounts, sent emails, orders,
+ * gift cards …) from a browser: the roles the generated admin panel's FOLDER
+ * admits. Some admin pages also admit another role (staff screens: the
+ * dashboard, a table's list and views), and a role on one of those pages must
+ * never become a reader of every protected table.
+ */
+
+const authWith = (
+  pageProtection: UIDLAuthentication['pageProtection'],
+  folderProtection: UIDLAuthentication['folderProtection']
+): UIDLAuthentication => ({
+  enabled: true,
+  dataSourceId: 'ds-1',
+  dataSourceType: 'teleport',
+  passwordAuthEnabled: true,
+  providers: [],
+  roles: ['admin', 'staff', 'user'],
+  tables: {},
+  pageProtection,
+  folderProtection,
+  authPages: {},
+  callbackBaseUrl: '/api/auth/callback',
+  envKeys: {},
+  customUserProperties: [],
+})
+
+const page = (route: string, allowedRoles: string[]) => ({
+  requiresAuth: true,
+  allowedRoles,
+  pageName: route.split('/').pop() || 'home',
+  route,
+})
+
+const folder = (
+  folderName: string,
+  allowedRoles: string[],
+  parentId: string | null,
+  children: Record<string, 'page' | 'folder'>
+) => ({ requiresAuth: true, allowedRoles, folderName, parentId, children })
+
+// An admin panel whose folder admits admins, some of whose screens (and their
+// entity folder) admit staff too, and whose built-in entities stay admin only.
+const STAFF_SCREENS_AUTH = authWith(
+  {
+    'p-dashboard': page('/admin/dashboard', ['admin', 'staff']),
+    'p-tasks': page('/admin/tasks', ['admin', 'staff']),
+    'p-tasks-create': page('/admin/tasks/create', ['admin', 'staff']),
+    'p-tasks-board': page('/admin/tasks/board', ['admin', 'staff']),
+    'p-users': page('/admin/users', ['admin']),
+    'p-sent-emails': page('/admin/sent-emails', ['admin']),
+  },
+  {
+    'f-admin': folder('admin-panel', ['admin'], 'pages', {
+      'p-dashboard': 'page',
+      'f-tasks': 'folder',
+      'f-users': 'folder',
+      'f-sent-emails': 'folder',
+    }),
+    'f-tasks': folder('tasks', ['admin', 'staff'], 'f-admin', {
+      'p-tasks': 'page',
+      'p-tasks-create': 'page',
+      'p-tasks-board': 'page',
+    }),
+    'f-users': folder('users', ['admin'], 'f-admin', { 'p-users': 'page' }),
+    'f-sent-emails': folder('sent-emails', ['admin'], 'f-admin', { 'p-sent-emails': 'page' }),
+  }
+)
+
+describe('resolveTrustedReaderRoles', () => {
+  it("trusts the admin folder's roles, never the staff an admin page admits", () => {
+    expect(resolveTrustedReaderRoles(STAFF_SCREENS_AUTH)).toEqual(['admin'])
+  })
+
+  it('answers what it always did for an admin panel without staff pages', () => {
+    const storeAuth = authWith(
+      {
+        'p-dashboard': page('/admin/dashboard', ['admin']),
+        'p-orders': page('/admin/orders', ['admin']),
+      },
+      { 'f-admin': folder('admin-panel', ['admin'], 'pages', { 'p-dashboard': 'page' }) }
+    )
+    expect(resolveTrustedReaderRoles(storeAuth)).toEqual(['admin'])
+  })
+
+  it('falls back to the roles EVERY admin page admits when the folder records none', () => {
+    const pages = STAFF_SCREENS_AUTH.pageProtection
+    expect(resolveTrustedReaderRoles(authWith(pages, {}))).toEqual(['admin'])
+    const roleless = authWith(pages, {
+      'f-admin': folder('admin-panel', [], 'pages', { 'p-dashboard': 'page' }),
+    })
+    expect(resolveTrustedReaderRoles(roleless)).toEqual(['admin'])
+  })
+
+  it('ignores pages outside the admin panel, and trusts nobody without one', () => {
+    const noPanel = authWith(
+      {
+        'p-profile': page('/profile', ['user']),
+        'p-administration': page('/administration', ['staff']),
+      },
+      { 'f-members': folder('members', ['user'], null, {}) }
+    )
+    expect(resolveTrustedReaderRoles(noPanel)).toEqual([])
+    expect(resolveTrustedReaderRoles(undefined)).toEqual([])
+  })
+})
+
+describe('the emitted guard with those roles', () => {
+  const bootGuard = (trustedReaderRoles: string[]) => {
+    let session: { role: string } | null = null
+    const guardRead = new Function(
+      'process',
+      '__tqSessionToken',
+      `${generateTableAccessHelperCode({ trustedReaderRoles })}
+return __taGuardRead`
+    )({ env: { NEXTAUTH_SECRET: 'server-secret' } }, async () =>
+      session ? { sub: 'u1', role: session.role } : null
+    ) as (req: unknown, tableName: string, rawQuery: string | null) => Promise<unknown>
+    return async (role: string, tableName: string) => {
+      session = { role }
+      return guardRead({ headers: {} }, tableName, null)
+    }
+  }
+
+  it('refuses staff admitted to some admin pages every account, email and order', async () => {
+    const readAs = bootGuard(resolveTrustedReaderRoles(STAFF_SCREENS_AUTH))
+    for (const table of [
+      'users',
+      'teleport_sent_emails',
+      'teleport_orders',
+      'teleport_gift_cards',
+    ]) {
+      expect(await readAs('staff', table)).toMatchObject({ status: 403 })
+      expect(await readAs('admin', table)).toBeNull()
+    }
+  })
+})

package/dist/cjs/index.d.ts

@@ -31,11 +31,12 @@ 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 PageArrival from './page-arrival';
 import * as ScrollSceneRuntime from './scroll-scene';
 import * as MotionRuntime from './motion-runtime';
 import * as PageTransition from './page-transition';
 import * as StateBindings from './state-bindings';
 import * as WebPush from './utils/web-push';
 import * as InlineScriptErrorGuard from './utils/inline-script-error-guard';
-export { Constants, StringUtils, UIDLUtils, GenericUtils, LocalImports, JSIdentifiers, ASTScope, ASTStatementOrder, ASTEffectCleanup, RoutePaths, LayoutTopology, HtmlContentModel, StyleDeclarations, StorefrontTax, ProductDiscounts, ProductRatings, RegionalPricing, DiscountEngine, ProductOptions, CartLinePricing, CartCurrency, TableAccess, ContentTables, SessionCookieResolver, SubscriptionAccess, FontPreconnect, EmailDate, RichTextEmbeds, RichTextEmbedsCodegen, RichTextContent, RichTextContentCodegen, DataCache, PageRevalidate, ScrollSceneRuntime, MotionRuntime, PageTransition, StateBindings, WebPush, InlineScriptErrorGuard, };
+export { Constants, StringUtils, UIDLUtils, GenericUtils, LocalImports, JSIdentifiers, ASTScope, ASTStatementOrder, ASTEffectCleanup, RoutePaths, LayoutTopology, HtmlContentModel, StyleDeclarations, StorefrontTax, ProductDiscounts, ProductRatings, RegionalPricing, DiscountEngine, ProductOptions, CartLinePricing, CartCurrency, TableAccess, ContentTables, SessionCookieResolver, SubscriptionAccess, FontPreconnect, EmailDate, RichTextEmbeds, RichTextEmbedsCodegen, RichTextContent, RichTextContentCodegen, DataCache, PageRevalidate, PageArrival, ScrollSceneRuntime, MotionRuntime, PageTransition, StateBindings, WebPush, InlineScriptErrorGuard, };
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,aAAa,CAAA;AACxC,OAAO,KAAK,WAAW,MAAM,sBAAsB,CAAA;AACnD,OAAO,KAAK,SAAS,MAAM,oBAAoB,CAAA;AAC/C,OAAO,KAAK,YAAY,MAAM,iBAAiB,CAAA;AAC/C,OAAO,KAAK,YAAY,MAAM,uBAAuB,CAAA;AACrD,OAAO,KAAK,aAAa,MAAM,wBAAwB,CAAA;AACvD,OAAO,KAAK,QAAQ,MAAM,mBAAmB,CAAA;AAC7C,OAAO,KAAK,iBAAiB,MAAM,6BAA6B,CAAA;AAChE,OAAO,KAAK,gBAAgB,MAAM,4BAA4B,CAAA;AAC9D,OAAO,KAAK,UAAU,MAAM,qBAAqB,CAAA;AACjD,OAAO,KAAK,cAAc,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,gBAAgB,MAAM,4BAA4B,CAAA;AAC9D,OAAO,KAAK,iBAAiB,MAAM,4BAA4B,CAAA;AAC/D,OAAO,KAAK,aAAa,MAAM,wBAAwB,CAAA;AACvD,OAAO,KAAK,gBAAgB,MAAM,2BAA2B,CAAA;AAC7D,OAAO,KAAK,cAAc,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,eAAe,MAAM,0BAA0B,CAAA;AAC3D,OAAO,KAAK,cAAc,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,cAAc,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,eAAe,MAAM,2BAA2B,CAAA;AAC5D,OAAO,KAAK,YAAY,MAAM,uBAAuB,CAAA;AACrD,OAAO,KAAK,WAAW,MAAM,sBAAsB,CAAA;AACnD,OAAO,KAAK,aAAa,MAAM,wBAAwB,CAAA;AACvD,OAAO,KAAK,qBAAqB,MAAM,iCAAiC,CAAA;AACxE,OAAO,KAAK,kBAAkB,MAAM,6BAA6B,CAAA;AACjE,OAAO,KAAK,cAAc,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,SAAS,MAAM,oBAAoB,CAAA;AAC/C,OAAO,KAAK,cAAc,MAAM,0BAA0B,CAAA;AAC1D,OAAO,KAAK,qBAAqB,MAAM,kCAAkC,CAAA;AACzE,OAAO,KAAK,eAAe,MAAM,2BAA2B,CAAA;AAC5D,OAAO,KAAK,sBAAsB,MAAM,mCAAmC,CAAA;AAC3E,OAAO,KAAK,SAAS,MAAM,SAAS,CAAA;AACpC,OAAO,KAAK,cAAc,MAAM,mBAAmB,CAAA;AACnD,OAAO,KAAK,kBAAkB,MAAM,gBAAgB,CAAA;AACpD,OAAO,KAAK,aAAa,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,cAAc,MAAM,mBAAmB,CAAA;AACnD,OAAO,KAAK,aAAa,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,sBAAsB,MAAM,mCAAmC,CAAA;AAE3E,OAAO,EACL,SAAS,EACT,WAAW,EACX,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,cAAc,EACd,cAAc,EACd,eAAe,EACf,YAAY,EACZ,WAAW,EACX,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,SAAS,EACT,cAAc,EACd,qBAAqB,EACrB,eAAe,EACf,sBAAsB,EACtB,SAAS,EACT,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,aAAa,EACb,OAAO,EACP,sBAAsB,GACvB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,aAAa,CAAA;AACxC,OAAO,KAAK,WAAW,MAAM,sBAAsB,CAAA;AACnD,OAAO,KAAK,SAAS,MAAM,oBAAoB,CAAA;AAC/C,OAAO,KAAK,YAAY,MAAM,iBAAiB,CAAA;AAC/C,OAAO,KAAK,YAAY,MAAM,uBAAuB,CAAA;AACrD,OAAO,KAAK,aAAa,MAAM,wBAAwB,CAAA;AACvD,OAAO,KAAK,QAAQ,MAAM,mBAAmB,CAAA;AAC7C,OAAO,KAAK,iBAAiB,MAAM,6BAA6B,CAAA;AAChE,OAAO,KAAK,gBAAgB,MAAM,4BAA4B,CAAA;AAC9D,OAAO,KAAK,UAAU,MAAM,qBAAqB,CAAA;AACjD,OAAO,KAAK,cAAc,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,gBAAgB,MAAM,4BAA4B,CAAA;AAC9D,OAAO,KAAK,iBAAiB,MAAM,4BAA4B,CAAA;AAC/D,OAAO,KAAK,aAAa,MAAM,wBAAwB,CAAA;AACvD,OAAO,KAAK,gBAAgB,MAAM,2BAA2B,CAAA;AAC7D,OAAO,KAAK,cAAc,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,eAAe,MAAM,0BAA0B,CAAA;AAC3D,OAAO,KAAK,cAAc,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,cAAc,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,eAAe,MAAM,2BAA2B,CAAA;AAC5D,OAAO,KAAK,YAAY,MAAM,uBAAuB,CAAA;AACrD,OAAO,KAAK,WAAW,MAAM,sBAAsB,CAAA;AACnD,OAAO,KAAK,aAAa,MAAM,wBAAwB,CAAA;AACvD,OAAO,KAAK,qBAAqB,MAAM,iCAAiC,CAAA;AACxE,OAAO,KAAK,kBAAkB,MAAM,6BAA6B,CAAA;AACjE,OAAO,KAAK,cAAc,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,SAAS,MAAM,oBAAoB,CAAA;AAC/C,OAAO,KAAK,cAAc,MAAM,0BAA0B,CAAA;AAC1D,OAAO,KAAK,qBAAqB,MAAM,kCAAkC,CAAA;AACzE,OAAO,KAAK,eAAe,MAAM,2BAA2B,CAAA;AAC5D,OAAO,KAAK,sBAAsB,MAAM,mCAAmC,CAAA;AAC3E,OAAO,KAAK,SAAS,MAAM,SAAS,CAAA;AACpC,OAAO,KAAK,cAAc,MAAM,mBAAmB,CAAA;AACnD,OAAO,KAAK,WAAW,MAAM,gBAAgB,CAAA;AAC7C,OAAO,KAAK,kBAAkB,MAAM,gBAAgB,CAAA;AACpD,OAAO,KAAK,aAAa,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,cAAc,MAAM,mBAAmB,CAAA;AACnD,OAAO,KAAK,aAAa,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,sBAAsB,MAAM,mCAAmC,CAAA;AAE3E,OAAO,EACL,SAAS,EACT,WAAW,EACX,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,cAAc,EACd,cAAc,EACd,eAAe,EACf,YAAY,EACZ,WAAW,EACX,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,SAAS,EACT,cAAc,EACd,qBAAqB,EACrB,eAAe,EACf,sBAAsB,EACtB,SAAS,EACT,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,aAAa,EACb,OAAO,EACP,sBAAsB,GACvB,CAAA"}

package/dist/cjs/index.js

@@ -23,7 +23,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.InlineScriptErrorGuard = exports.WebPush = exports.StateBindings = exports.PageTransition = exports.MotionRuntime = exports.ScrollSceneRuntime = exports.PageRevalidate = exports.DataCache = exports.RichTextContentCodegen = exports.RichTextContent = exports.RichTextEmbedsCodegen = exports.RichTextEmbeds = exports.EmailDate = exports.FontPreconnect = exports.SubscriptionAccess = exports.SessionCookieResolver = exports.ContentTables = exports.TableAccess = exports.CartCurrency = exports.CartLinePricing = exports.ProductOptions = exports.DiscountEngine = exports.RegionalPricing = exports.ProductRatings = exports.ProductDiscounts = exports.StorefrontTax = exports.StyleDeclarations = exports.HtmlContentModel = exports.LayoutTopology = exports.RoutePaths = exports.ASTEffectCleanup = exports.ASTStatementOrder = exports.ASTScope = exports.JSIdentifiers = exports.LocalImports = exports.GenericUtils = exports.UIDLUtils = exports.StringUtils = exports.Constants = void 0;
+exports.InlineScriptErrorGuard = exports.WebPush = exports.StateBindings = exports.PageTransition = exports.MotionRuntime = exports.ScrollSceneRuntime = exports.PageArrival = exports.PageRevalidate = exports.DataCache = exports.RichTextContentCodegen = exports.RichTextContent = exports.RichTextEmbedsCodegen = exports.RichTextEmbeds = exports.EmailDate = exports.FontPreconnect = exports.SubscriptionAccess = exports.SessionCookieResolver = exports.ContentTables = exports.TableAccess = exports.CartCurrency = exports.CartLinePricing = exports.ProductOptions = exports.DiscountEngine = exports.RegionalPricing = exports.ProductRatings = exports.ProductDiscounts = exports.StorefrontTax = exports.StyleDeclarations = exports.HtmlContentModel = exports.LayoutTopology = exports.RoutePaths = exports.ASTEffectCleanup = exports.ASTStatementOrder = exports.ASTScope = exports.JSIdentifiers = exports.LocalImports = exports.GenericUtils = exports.UIDLUtils = exports.StringUtils = exports.Constants = void 0;
 var Constants = __importStar(require("./constants"));
 exports.Constants = Constants;
 var StringUtils = __importStar(require("./utils/string-utils"));
@@ -90,6 +90,8 @@ var DataCache = __importStar(require("./cache"));
 exports.DataCache = DataCache;
 var PageRevalidate = __importStar(require("./page-revalidate"));
 exports.PageRevalidate = PageRevalidate;
+var PageArrival = __importStar(require("./page-arrival"));
+exports.PageArrival = PageArrival;
 var ScrollSceneRuntime = __importStar(require("./scroll-scene"));
 exports.ScrollSceneRuntime = ScrollSceneRuntime;
 var MotionRuntime = __importStar(require("./motion-runtime"));

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,qDAAwC;AAyCtC,8BAAS;AAxCX,gEAAmD;AAyCjD,kCAAW;AAxCb,4DAA+C;AAyC7C,8BAAS;AAxCX,4DAA+C;AAyC7C,oCAAY;AAxCd,kEAAqD;AAyCnD,oCAAY;AAxCd,oEAAuD;AAyCrD,sCAAa;AAxCf,0DAA6C;AAyC3C,4BAAQ;AAxCV,6EAAgE;AAyC9D,8CAAiB;AAxCnB,2EAA8D;AAyC5D,4CAAgB;AAxClB,8DAAiD;AAyC/C,gCAAU;AAxCZ,sEAAyD;AAyCvD,wCAAc;AAxChB,2EAA8D;AAyC5D,4CAAgB;AAxClB,4EAA+D;AAyC7D,8CAAiB;AAxCnB,oEAAuD;AAyCrD,sCAAa;AAxCf,0EAA6D;AAyC3D,4CAAgB;AAxClB,sEAAyD;AAyCvD,wCAAc;AAxChB,wEAA2D;AAyCzD,0CAAe;AAxCjB,sEAAyD;AAyCvD,wCAAc;AAxChB,sEAAyD;AAyCvD,wCAAc;AAxChB,yEAA4D;AAyC1D,0CAAe;AAxCjB,kEAAqD;AAyCnD,oCAAY;AAxCd,gEAAmD;AAyCjD,kCAAW;AAxCb,oEAAuD;AAyCrD,sCAAa;AAxCf,qFAAwE;AAyCtE,sDAAqB;AAxCvB,8EAAiE;AAyC/D,gDAAkB;AAxCpB,sEAAyD;AAyCvD,wCAAc;AAxChB,4DAA+C;AAyC7C,8BAAS;AAxCX,uEAA0D;AAyCxD,wCAAc;AAxChB,sFAAyE;AAyCvE,sDAAqB;AAxCvB,yEAA4D;AAyC1D,0CAAe;AAxCjB,wFAA2E;AAyCzE,wDAAsB;AAxCxB,iDAAoC;AAyClC,8BAAS;AAxCX,gEAAmD;AAyCjD,wCAAc;AAxChB,iEAAoD;AAyClD,gDAAkB;AAxCpB,8DAAiD;AAyC/C,sCAAa;AAxCf,gEAAmD;AAyCjD,wCAAc;AAxChB,8DAAiD;AAyC/C,sCAAa;AAxCf,wDAA2C;AAyCzC,0BAAO;AAxCT,wFAA2E;AAyCzE,wDAAsB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,qDAAwC;AA0CtC,8BAAS;AAzCX,gEAAmD;AA0CjD,kCAAW;AAzCb,4DAA+C;AA0C7C,8BAAS;AAzCX,4DAA+C;AA0C7C,oCAAY;AAzCd,kEAAqD;AA0CnD,oCAAY;AAzCd,oEAAuD;AA0CrD,sCAAa;AAzCf,0DAA6C;AA0C3C,4BAAQ;AAzCV,6EAAgE;AA0C9D,8CAAiB;AAzCnB,2EAA8D;AA0C5D,4CAAgB;AAzClB,8DAAiD;AA0C/C,gCAAU;AAzCZ,sEAAyD;AA0CvD,wCAAc;AAzChB,2EAA8D;AA0C5D,4CAAgB;AAzClB,4EAA+D;AA0C7D,8CAAiB;AAzCnB,oEAAuD;AA0CrD,sCAAa;AAzCf,0EAA6D;AA0C3D,4CAAgB;AAzClB,sEAAyD;AA0CvD,wCAAc;AAzChB,wEAA2D;AA0CzD,0CAAe;AAzCjB,sEAAyD;AA0CvD,wCAAc;AAzChB,sEAAyD;AA0CvD,wCAAc;AAzChB,yEAA4D;AA0C1D,0CAAe;AAzCjB,kEAAqD;AA0CnD,oCAAY;AAzCd,gEAAmD;AA0CjD,kCAAW;AAzCb,oEAAuD;AA0CrD,sCAAa;AAzCf,qFAAwE;AA0CtE,sDAAqB;AAzCvB,8EAAiE;AA0C/D,gDAAkB;AAzCpB,sEAAyD;AA0CvD,wCAAc;AAzChB,4DAA+C;AA0C7C,8BAAS;AAzCX,uEAA0D;AA0CxD,wCAAc;AAzChB,sFAAyE;AA0CvE,sDAAqB;AAzCvB,yEAA4D;AA0C1D,0CAAe;AAzCjB,wFAA2E;AA0CzE,wDAAsB;AAzCxB,iDAAoC;AA0ClC,8BAAS;AAzCX,gEAAmD;AA0CjD,wCAAc;AAzChB,0DAA6C;AA0C3C,kCAAW;AAzCb,iEAAoD;AA0ClD,gDAAkB;AAzCpB,8DAAiD;AA0C/C,sCAAa;AAzCf,gEAAmD;AA0CjD,wCAAc;AAzChB,8DAAiD;AA0C/C,sCAAa;AAzCf,wDAA2C;AA0CzC,0BAAO;AAzCT,wFAA2E;AA0CzE,wDAAsB"}

package/dist/cjs/page-arrival/constants.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Where the generated page-arrival wrapper lives and what pages import it as.
+ *
+ * Lives in `teleport-shared` because two page plugins in two packages ask for
+ * it — the workflows plugin (page-load and element-visible triggers) and the
+ * state data-source plugin (state seeded from a data source) — and they must
+ * emit the same file under the same name.
+ */
+/** Folder of the emitted runtime, relative to the generated project root. */
+export declare const PAGE_ARRIVAL_DIR: string[];
+export declare const PAGE_ARRIVAL_FILE_NAME = "page-arrival";
+/** The default export of the runtime, as the page module imports it. */
+export declare const PAGE_ARRIVAL_WRAPPER = "remountOnPageArrival";
+//# sourceMappingURL=constants.d.ts.map

package/dist/cjs/page-arrival/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/page-arrival/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,UAAY,CAAA;AACzC,eAAO,MAAM,sBAAsB,iBAAiB,CAAA;AAEpD,wEAAwE;AACxE,eAAO,MAAM,oBAAoB,yBAAyB,CAAA"}

package/dist/cjs/page-arrival/constants.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * Where the generated page-arrival wrapper lives and what pages import it as.
+ *
+ * Lives in `teleport-shared` because two page plugins in two packages ask for
+ * it — the workflows plugin (page-load and element-visible triggers) and the
+ * state data-source plugin (state seeded from a data source) — and they must
+ * emit the same file under the same name.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PAGE_ARRIVAL_WRAPPER = exports.PAGE_ARRIVAL_FILE_NAME = exports.PAGE_ARRIVAL_DIR = void 0;
+/** Folder of the emitted runtime, relative to the generated project root. */
+exports.PAGE_ARRIVAL_DIR = ['utils'];
+exports.PAGE_ARRIVAL_FILE_NAME = 'page-arrival';
+/** The default export of the runtime, as the page module imports it. */
+exports.PAGE_ARRIVAL_WRAPPER = 'remountOnPageArrival';
+//# sourceMappingURL=constants.js.map

package/dist/cjs/page-arrival/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/page-arrival/constants.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,6EAA6E;AAChE,QAAA,gBAAgB,GAAG,CAAC,OAAO,CAAC,CAAA;AAC5B,QAAA,sBAAsB,GAAG,cAAc,CAAA;AAEpD,wEAAwE;AAC3D,QAAA,oBAAoB,GAAG,sBAAsB,CAAA"}

package/dist/cjs/page-arrival/index.d.ts

@@ -0,0 +1,4 @@
+export * from './constants';
+export * from './runtime';
+export * from './page-export';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/page-arrival/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/page-arrival/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA"}

package/dist/cjs/page-arrival/index.js

@@ -0,0 +1,20 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./constants"), exports);
+__exportStar(require("./runtime"), exports);
+__exportStar(require("./page-export"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/page-arrival/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/page-arrival/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA2B;AAC3B,4CAAyB;AACzB,gDAA6B"}

package/dist/cjs/page-arrival/page-export.d.ts

@@ -0,0 +1,14 @@
+import { ComponentStructure } from '@teleporthq/teleport-types';
+/**
+ * Makes the page start fresh on every arrival — see `generatePageArrivalRuntime`
+ * for why Next.js does not do it on its own.
+ *
+ * Rewrites `export default Page` into `export default remountOnPageArrival(Page)`,
+ * imports the wrapper and emits it once per project. Several plugins may ask for
+ * the same page, so a page that is already wrapped is left alone. Nothing is
+ * changed when the page has no plain default export to wrap, or when the
+ * generation has nowhere to emit the runtime — an import of a file that is never
+ * written would break the build.
+ */
+export declare const remountPageOnArrival: (structure: ComponentStructure) => void;
+//# sourceMappingURL=page-export.d.ts.map

package/dist/cjs/page-arrival/page-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-export.d.ts","sourceRoot":"","sources":["../../../src/page-arrival/page-export.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAY,MAAM,4BAA4B,CAAA;AAazE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,cAAe,kBAAkB,KAAG,IAgCpE,CAAA"}