TableTheory integration

FaceTheory uses TableTheory for blocking ISR’s cache metadata, regeneration leases, and (optionally) cache HTML payload pointers. TableTheory is the data layer underneath; FaceTheory consumes it through a typed integration surface rather than reaching at DynamoDB directly.

Install

npm install --save-exact \
  https://github.com/theory-cloud/TableTheory/releases/download/v1.8.4/theory-cloud-tabletheory-ts-1.8.4.tgz

The TableTheory entry point

FaceTheory exposes @theory-cloud/facetheory/tabletheory for the TableTheory-backed ISR stores:

import { /* FaceTheoryIsrMetaStore, ... */ } from '@theory-cloud/facetheory/tabletheory';

The store implements FaceTheory’s IsrMetaStore interface (get, tryAcquireLease, commitGeneration, releaseLease) on top of a TableTheory model with the canonical cache-record shape.

Cache record shape

The TableTheory-modeled ISR cache record lives on the TableTheory documentation site so the schema can stay close to TableTheory’s contract:

ISR cache schema — table layout, attributes, lifecycle tags.
ISR transaction recipes — metadata + pointer-swap patterns.
ISR idempotency — request-ID driven regeneration.
TTL cache patterns — TTL-first cache eviction.

Wiring in production

import { createFaceApp } from '@theory-cloud/facetheory';
import { /* createTableTheoryIsrMetaStore */ } from '@theory-cloud/facetheory/tabletheory';
// import the S3HtmlStore from the AWS S3 entry point for HTML payload storage:
import { /* S3HtmlStore */ } from '@theory-cloud/facetheory/aws-s3';

export const app = createFaceApp({
  faces,
  isr: {
    htmlStore: /* S3HtmlStore instance */,
    metaStore: /* TableTheory-backed IsrMetaStore */,
  },
});

See the API Reference → ISR Storage And Cache APIs for the exact exported names and construction patterns at the current version.

Cross-repo coordination

A FaceTheory change that needs a new TableTheory model attribute, tag, or transaction shape is a cross-repo coordination event — not a unilateral FaceTheory edit. Conversely, TableTheory changes that affect the tags or semantics FaceTheory’s ISR relies on need cross-steward review.