graphile-history 1.1.1

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "graphile-history",
+  "version": "1.1.1",
+  "description": "PostGraphile v5 history plugin — per-row version history, point-in-time reads, and restore mutations for @history tables",
+  "author": "Constructive <developers@constructive.io>",
+  "homepage": "https://github.com/constructive-io/constructive",
+  "license": "MIT",
+  "main": "index.js",
+  "module": "esm/index.js",
+  "types": "index.d.ts",
+  "scripts": {
+    "clean": "makage clean",
+    "prepack": "npm run build",
+    "build": "makage build",
+    "build:dev": "makage build --dev",
+    "lint": "eslint . --fix",
+    "test": "jest --forceExit",
+    "test:watch": "jest --watch"
+  },
+  "publishConfig": {
+    "access": "public",
+    "directory": "dist"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/constructive-io/constructive"
+  },
+  "bugs": {
+    "url": "https://github.com/constructive-io/constructive/issues"
+  },
+  "peerDependencies": {
+    "@dataplan/pg": "1.0.3",
+    "grafast": "1.0.2",
+    "graphile-build": "5.0.2",
+    "graphile-build-pg": "5.0.2",
+    "graphile-config": "1.0.1",
+    "graphql": "16.13.0",
+    "pg-sql2": "5.0.1",
+    "postgraphile": "5.0.3"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.11",
+    "@types/pg": "^8.20.0",
+    "graphile-test": "^5.9.6",
+    "makage": "^0.3.0",
+    "pg": "^8.21.0",
+    "pgsql-test": "^5.8.6"
+  },
+  "keywords": [
+    "postgraphile",
+    "graphile",
+    "constructive",
+    "plugin",
+    "postgres",
+    "graphql",
+    "history",
+    "audit",
+    "versioning",
+    "temporal",
+    "restore"
+  ],
+  "gitHead": "a430897efa1488ec24fc636f0d5023207bba7ba7"
+}

package/plugin.d.ts

@@ -0,0 +1,36 @@
+/**
+ * PostGraphile v5 History Plugin
+ *
+ * Discovers tables tagged with `@history` (companion `<table>_history` tables
+ * produced by the constructive-db `DataHistory` module) and augments the schema
+ * with:
+ *   - a `history` connection field on each source row type — the row's full
+ *     version stream ordered by `recorded_at DESC`;
+ *   - a `versionAt(at: Datetime!)` field returning the version that was current
+ *     at a given point in time;
+ *   - a `restore<Table>Version` root mutation that rewrites the live row from a
+ *     historical version (optionally re-inserting a deleted row).
+ *
+ * All reads and writes go through the request's `withPgClient` + `pgSettings`,
+ * so row-level security and mutation policies are enforced exactly as they are
+ * for any other operation. Because restores write through the source table, the
+ * source `DataHistory` trigger records the restore itself as a new version.
+ *
+ * Smart tag format (stamped by `metaschema_generators.data_history`):
+ *   @history { "history_table": "posts_history", ... }
+ * The tag value may also be a bare string naming the history table, or simply a
+ * truthy marker (in which case the history table is derived by suffix).
+ */
+import 'graphile-build';
+import 'graphile-build-pg';
+import type { GraphileConfig } from 'graphile-config';
+import type { HistoryPluginOptions } from './types';
+declare global {
+    namespace GraphileConfig {
+        interface Plugins {
+            HistoryPlugin: true;
+        }
+    }
+}
+export declare function createHistoryPlugin(options?: HistoryPluginOptions): GraphileConfig.Plugin;
+export declare const HistoryPlugin: GraphileConfig.Plugin;

package/plugin.js

@@ -0,0 +1,516 @@
+"use strict";
+/**
+ * PostGraphile v5 History Plugin
+ *
+ * Discovers tables tagged with `@history` (companion `<table>_history` tables
+ * produced by the constructive-db `DataHistory` module) and augments the schema
+ * with:
+ *   - a `history` connection field on each source row type — the row's full
+ *     version stream ordered by `recorded_at DESC`;
+ *   - a `versionAt(at: Datetime!)` field returning the version that was current
+ *     at a given point in time;
+ *   - a `restore<Table>Version` root mutation that rewrites the live row from a
+ *     historical version (optionally re-inserting a deleted row).
+ *
+ * All reads and writes go through the request's `withPgClient` + `pgSettings`,
+ * so row-level security and mutation policies are enforced exactly as they are
+ * for any other operation. Because restores write through the source table, the
+ * source `DataHistory` trigger records the restore itself as a new version.
+ *
+ * Smart tag format (stamped by `metaschema_generators.data_history`):
+ *   @history { "history_table": "posts_history", ... }
+ * The tag value may also be a bare string naming the history table, or simply a
+ * truthy marker (in which case the history table is derived by suffix).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HistoryPlugin = void 0;
+exports.createHistoryPlugin = createHistoryPlugin;
+require("graphile-build");
+require("graphile-build-pg");
+const grafast_1 = require("grafast");
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+function readHistoryTag(codec) {
+    const tags = codec.extensions?.tags;
+    if (!tags)
+        return false;
+    const val = tags.history;
+    if (val === undefined || val === null || val === false)
+        return false;
+    if (typeof val === 'string') {
+        // Tag may be a bare table name or a JSON object encoded as a string.
+        const trimmed = val.trim();
+        if (trimmed.startsWith('{')) {
+            try {
+                const parsed = JSON.parse(trimmed);
+                return parsed?.history_table ?? true;
+            }
+            catch {
+                return trimmed.length > 0 ? trimmed : true;
+            }
+        }
+        return trimmed.length > 0 ? trimmed : true;
+    }
+    if (typeof val === 'object') {
+        return val.history_table ?? true;
+    }
+    return true;
+}
+function resolvePgTypeName(codec) {
+    const name = codec?.name;
+    if (name)
+        return name;
+    return 'text';
+}
+function pgTypeToGraphQLType(build, pgType) {
+    const { graphql: { GraphQLString, GraphQLInt, GraphQLFloat, GraphQLBoolean } } = build;
+    const byName = (n) => build.getTypeByName(n);
+    switch (pgType) {
+        case 'uuid':
+            return byName('UUID') ?? GraphQLString;
+        case 'int2':
+        case 'int4':
+            return GraphQLInt;
+        case 'int8':
+            return byName('BigInt') ?? GraphQLString;
+        case 'bool':
+            return GraphQLBoolean;
+        case 'float4':
+        case 'float8':
+            return GraphQLFloat;
+        case 'numeric':
+            return byName('BigFloat') ?? GraphQLString;
+        case 'timestamptz':
+        case 'timestamp':
+        case 'date':
+        case 'time':
+        case 'timetz':
+            return byName('Datetime') ?? GraphQLString;
+        case 'json':
+        case 'jsonb':
+            return byName('JSON') ?? GraphQLString;
+        default:
+            return GraphQLString;
+    }
+}
+function quoteIdent(ident) {
+    return `"${ident.replace(/"/g, '""')}"`;
+}
+// ─── Plugin Factory ──────────────────────────────────────────────────────────
+function createHistoryPlugin(options = {}) {
+    const { historySuffix = '_history', recordedAtColumn = 'recorded_at', operationColumn = 'history_op', immutableColumns = ['created_at', 'updated_at'] } = options;
+    // Closure state shared across hooks
+    let registry = {};
+    const versionTypeCache = {};
+    function getVersionType(build, info) {
+        const { graphql: { GraphQLObjectType, GraphQLString } } = build;
+        const typeName = `${info.sourceTypeName}HistoryVersion`;
+        if (versionTypeCache[typeName])
+            return versionTypeCache[typeName];
+        const fieldsConfig = {};
+        for (const col of info.copyColumns) {
+            fieldsConfig[col.gqlName] = { type: pgTypeToGraphQLType(build, col.pgType) };
+        }
+        fieldsConfig.recordedAt = { type: build.getTypeByName('Datetime') ?? GraphQLString };
+        fieldsConfig.historyOp = { type: GraphQLString };
+        const type = new GraphQLObjectType({
+            name: typeName,
+            description: `A single historical version of a ${info.sourceTypeName} row.`,
+            fields: fieldsConfig
+        });
+        versionTypeCache[typeName] = type;
+        return type;
+    }
+    // Map a raw history row (physical column keys) to the GraphQL version shape.
+    function mapVersionRow(info, row) {
+        if (!row)
+            return null;
+        const out = {};
+        for (const col of info.copyColumns) {
+            out[col.gqlName] = row[col.column] ?? null;
+        }
+        out.recordedAt = row[info.recordedAtColumn] ?? null;
+        out.historyOp = row[info.operationColumn] ?? null;
+        return out;
+    }
+    function selectColumnsSql(info) {
+        const cols = info.copyColumns.map((c) => quoteIdent(c.column));
+        cols.push(quoteIdent(info.recordedAtColumn));
+        cols.push(quoteIdent(info.operationColumn));
+        return cols.join(', ');
+    }
+    return {
+        name: 'HistoryPlugin',
+        version: '1.0.0',
+        schema: {
+            hooks: {
+                init: {
+                    callback(_, build) {
+                        registry = {};
+                        const pgResources = build.input.pgRegistry.pgResources;
+                        for (const [, resource] of Object.entries(pgResources)) {
+                            const r = resource;
+                            const codec = r.codec;
+                            if (!codec?.attributes)
+                                continue;
+                            const tagValue = readHistoryTag(codec);
+                            if (!tagValue)
+                                continue;
+                            const schemaName = r.extensions?.pg?.schemaName ?? codec.extensions?.pg?.schemaName ?? 'public';
+                            const sourceSqlName = codec.extensions?.pg?.name ?? r.name ?? codec.name;
+                            // Resolve history table name: explicit tag value, else suffix convention.
+                            const historyTableName = typeof tagValue === 'string' ? tagValue : `${sourceSqlName}${historySuffix}`;
+                            // Locate the history resource/codec by SQL name in the same schema.
+                            let historyCodec = null;
+                            for (const [, hres] of Object.entries(pgResources)) {
+                                const hr = hres;
+                                const hcodec = hr.codec;
+                                if (!hcodec?.attributes)
+                                    continue;
+                                const hSchema = hr.extensions?.pg?.schemaName ?? hcodec.extensions?.pg?.schemaName ?? 'public';
+                                const hName = hcodec.extensions?.pg?.name ?? hr.name ?? hcodec.name;
+                                if (hName === historyTableName && hSchema === schemaName) {
+                                    historyCodec = hcodec;
+                                    break;
+                                }
+                            }
+                            if (!historyCodec)
+                                continue;
+                            // The history table must carry the reserved columns.
+                            if (!historyCodec.attributes[recordedAtColumn] || !historyCodec.attributes[operationColumn]) {
+                                continue;
+                            }
+                            // Primary key columns from the source resource's uniques.
+                            const uniques = r.uniques;
+                            const pk = uniques?.find((u) => u.isPrimary);
+                            if (!pk || pk.attributes.length === 0)
+                                continue;
+                            const pkColumns = pk.attributes.map((attr) => ({
+                                column: attr,
+                                gqlName: build.inflection.camelCase(attr),
+                                pgType: resolvePgTypeName(codec.attributes[attr]?.codec)
+                            }));
+                            // Copied columns = history columns present on the source, minus reserved.
+                            const copyColumns = [];
+                            for (const [attrName, attr] of Object.entries(historyCodec.attributes)) {
+                                if (attrName === recordedAtColumn || attrName === operationColumn)
+                                    continue;
+                                if (!codec.attributes[attrName])
+                                    continue;
+                                copyColumns.push({
+                                    column: attrName,
+                                    gqlName: build.inflection.camelCase(attrName),
+                                    pgType: resolvePgTypeName(attr.codec)
+                                });
+                            }
+                            if (copyColumns.length === 0)
+                                continue;
+                            const sourceTypeName = build.inflection.tableType(codec);
+                            registry[sourceTypeName] = {
+                                sourceTable: sourceSqlName,
+                                historyTable: historyTableName,
+                                schemaName,
+                                pkColumns,
+                                recordedAtColumn,
+                                operationColumn,
+                                copyColumns,
+                                sourceTypeName
+                            };
+                        }
+                        return _;
+                    }
+                },
+                GraphQLObjectType_fields(fields, build, context) {
+                    const { graphql: { GraphQLNonNull, GraphQLList, GraphQLBoolean, GraphQLInputObjectType, GraphQLObjectType, GraphQLString } } = build;
+                    const { scope } = context;
+                    // ── Root mutation: restore<Table>Version ────────────────────────────
+                    if (scope.isRootMutation) {
+                        const mutationFields = {};
+                        for (const info of Object.values(registry)) {
+                            const versionType = getVersionType(build, info);
+                            const inputFieldsConfig = {};
+                            for (const pk of info.pkColumns) {
+                                inputFieldsConfig[pk.gqlName] = {
+                                    type: new GraphQLNonNull(pgTypeToGraphQLType(build, pk.pgType))
+                                };
+                            }
+                            inputFieldsConfig.recordedAt = {
+                                type: new GraphQLNonNull(build.getTypeByName('Datetime') ?? GraphQLString)
+                            };
+                            inputFieldsConfig.reinsert = { type: GraphQLBoolean };
+                            const inputTypeName = `Restore${info.sourceTypeName}VersionInput`;
+                            const inputType = new GraphQLInputObjectType({
+                                name: inputTypeName,
+                                fields: inputFieldsConfig
+                            });
+                            const payloadTypeName = `Restore${info.sourceTypeName}VersionPayload`;
+                            const payloadType = new GraphQLObjectType({
+                                name: payloadTypeName,
+                                fields: {
+                                    version: { type: versionType },
+                                    restored: { type: versionType }
+                                }
+                            });
+                            const fieldName = `restore${info.sourceTypeName}Version`;
+                            mutationFields[fieldName] = {
+                                type: payloadType,
+                                args: {
+                                    input: { type: new GraphQLNonNull(inputType) }
+                                },
+                                plan(_$root, fieldArgs) {
+                                    const $input = fieldArgs.getRaw('input');
+                                    const $withPgClient = (0, grafast_1.context)().get('withPgClient');
+                                    const $pgSettings = (0, grafast_1.context)().get('pgSettings');
+                                    const $combined = (0, grafast_1.object)({
+                                        input: $input,
+                                        withPgClient: $withPgClient,
+                                        pgSettings: $pgSettings
+                                    });
+                                    return (0, grafast_1.lambda)($combined, async (vals) => {
+                                        const { input, withPgClient, pgSettings } = vals;
+                                        if (!withPgClient || !input)
+                                            return null;
+                                        const schema = quoteIdent(info.schemaName);
+                                        const source = `${schema}.${quoteIdent(info.sourceTable)}`;
+                                        const history = `${schema}.${quoteIdent(info.historyTable)}`;
+                                        // 1. Locate the requested version (point-in-time: latest at/<= recordedAt).
+                                        const params = [];
+                                        const pkPredicates = info.pkColumns.map((pk) => {
+                                            params.push(input[pk.gqlName]);
+                                            return `${quoteIdent(pk.column)} = $${params.length}`;
+                                        });
+                                        params.push(input.recordedAt);
+                                        const atParam = `$${params.length}`;
+                                        const versionSql = `SELECT ${selectColumnsSql(info)}
+                      FROM ${history}
+                      WHERE ${pkPredicates.join(' AND ')}
+                        AND ${quoteIdent(info.recordedAtColumn)} <= ${atParam}
+                      ORDER BY ${quoteIdent(info.recordedAtColumn)} DESC
+                      LIMIT 1`;
+                                        return withPgClient(pgSettings, async (pgClient) => {
+                                            const versionRes = await pgClient.query({ text: versionSql, values: params });
+                                            const versionRow = versionRes.rows[0] ?? null;
+                                            if (!versionRow) {
+                                                return { version: null, restored: null };
+                                            }
+                                            // 2. Columns we may write back: copied columns minus PK / immutable.
+                                            const pkNames = new Set(info.pkColumns.map((c) => c.column));
+                                            const immutable = new Set(immutableColumns);
+                                            const writable = info.copyColumns.filter((c) => !pkNames.has(c.column) && !immutable.has(c.column));
+                                            // 3. Does the live row still exist?
+                                            const existsParams = [];
+                                            const existsPreds = info.pkColumns.map((pk) => {
+                                                existsParams.push(input[pk.gqlName]);
+                                                return `${quoteIdent(pk.column)} = $${existsParams.length}`;
+                                            });
+                                            const existsRes = await pgClient.query({
+                                                text: `SELECT 1 FROM ${source} WHERE ${existsPreds.join(' AND ')} LIMIT 1`,
+                                                values: existsParams
+                                            });
+                                            const rowExists = existsRes.rows.length > 0;
+                                            if (rowExists) {
+                                                if (writable.length > 0) {
+                                                    const setParams = [];
+                                                    const setClauses = writable.map((c) => {
+                                                        setParams.push(versionRow[c.column] ?? null);
+                                                        return `${quoteIdent(c.column)} = $${setParams.length}`;
+                                                    });
+                                                    const wherePreds = info.pkColumns.map((pk) => {
+                                                        setParams.push(input[pk.gqlName]);
+                                                        return `${quoteIdent(pk.column)} = $${setParams.length}`;
+                                                    });
+                                                    await pgClient.query({
+                                                        text: `UPDATE ${source} SET ${setClauses.join(', ')} WHERE ${wherePreds.join(' AND ')}`,
+                                                        values: setParams
+                                                    });
+                                                }
+                                            }
+                                            else if (input.reinsert) {
+                                                const insertCols = info.copyColumns.filter((c) => !immutable.has(c.column));
+                                                const insParams = [];
+                                                const placeholders = insertCols.map((c) => {
+                                                    insParams.push(versionRow[c.column] ?? null);
+                                                    return `$${insParams.length}`;
+                                                });
+                                                await pgClient.query({
+                                                    text: `INSERT INTO ${source} (${insertCols
+                                                        .map((c) => quoteIdent(c.column))
+                                                        .join(', ')}) VALUES (${placeholders.join(', ')})`,
+                                                    values: insParams
+                                                });
+                                            }
+                                            else {
+                                                // Row is deleted and reinsert not requested — nothing to restore.
+                                                return { version: mapVersionRow(info, versionRow), restored: null };
+                                            }
+                                            // 4. Re-read the current source row to report the restored state.
+                                            const curParams = [];
+                                            const curPreds = info.pkColumns.map((pk) => {
+                                                curParams.push(input[pk.gqlName]);
+                                                return `${quoteIdent(pk.column)} = $${curParams.length}`;
+                                            });
+                                            const curCols = info.copyColumns.map((c) => quoteIdent(c.column)).join(', ');
+                                            const curRes = await pgClient.query({
+                                                text: `SELECT ${curCols} FROM ${source} WHERE ${curPreds.join(' AND ')} LIMIT 1`,
+                                                values: curParams
+                                            });
+                                            const curRow = curRes.rows[0] ?? null;
+                                            const restored = curRow
+                                                ? (() => {
+                                                    const out = {};
+                                                    for (const c of info.copyColumns)
+                                                        out[c.gqlName] = curRow[c.column] ?? null;
+                                                    out.recordedAt = null;
+                                                    out.historyOp = null;
+                                                    return out;
+                                                })()
+                                                : null;
+                                            return { version: mapVersionRow(info, versionRow), restored };
+                                        });
+                                    });
+                                }
+                            };
+                        }
+                        if (Object.keys(mutationFields).length === 0)
+                            return fields;
+                        return build.extend(fields, mutationFields, 'Adding history restore mutations');
+                    }
+                    // ── Source row type: history + versionAt ────────────────────────────
+                    if (!scope.pgCodec || !scope.isPgClassType)
+                        return fields;
+                    const codec = scope.pgCodec;
+                    const sourceTypeName = build.inflection.tableType(codec);
+                    const info = registry[sourceTypeName];
+                    if (!info)
+                        return fields;
+                    const versionType = getVersionType(build, info);
+                    const historyQualified = `${quoteIdent(info.schemaName)}.${quoteIdent(info.historyTable)}`;
+                    const orderClause = `ORDER BY ${quoteIdent(info.recordedAtColumn)} DESC`;
+                    function planParentPk($parent) {
+                        const pkSteps = {};
+                        for (const pk of info.pkColumns) {
+                            pkSteps[`pk_${pk.column}`] = $parent.get(pk.column);
+                        }
+                        return pkSteps;
+                    }
+                    return build.extend(fields, {
+                        history: {
+                            type: new GraphQLNonNull(new GraphQLList(new GraphQLNonNull(versionType))),
+                            description: `Full version history of this ${info.sourceTypeName}, newest first.`,
+                            plan($parent) {
+                                const $withPgClient = (0, grafast_1.context)().get('withPgClient');
+                                const $pgSettings = (0, grafast_1.context)().get('pgSettings');
+                                const $combined = (0, grafast_1.object)({
+                                    withPgClient: $withPgClient,
+                                    pgSettings: $pgSettings,
+                                    ...planParentPk($parent)
+                                });
+                                return (0, grafast_1.lambda)($combined, async (vals) => {
+                                    const { withPgClient, pgSettings } = vals;
+                                    if (!withPgClient)
+                                        return [];
+                                    const params = [];
+                                    const preds = info.pkColumns.map((pk) => {
+                                        params.push(vals[`pk_${pk.column}`]);
+                                        return `${quoteIdent(pk.column)} = $${params.length}`;
+                                    });
+                                    const sql = `SELECT ${selectColumnsSql(info)} FROM ${historyQualified}
+                      WHERE ${preds.join(' AND ')} ${orderClause}`;
+                                    const rows = await withPgClient(pgSettings, async (pgClient) => {
+                                        const res = await pgClient.query({ text: sql, values: params });
+                                        return res.rows;
+                                    });
+                                    return rows.map((row) => mapVersionRow(info, row));
+                                });
+                            }
+                        },
+                        versionAt: {
+                            type: versionType,
+                            description: `The version of this ${info.sourceTypeName} that was current at the given time.`,
+                            args: {
+                                at: { type: new GraphQLNonNull(build.getTypeByName('Datetime') ?? GraphQLString) }
+                            },
+                            plan($parent, fieldArgs) {
+                                const $at = fieldArgs.getRaw('at');
+                                const $withPgClient = (0, grafast_1.context)().get('withPgClient');
+                                const $pgSettings = (0, grafast_1.context)().get('pgSettings');
+                                const $combined = (0, grafast_1.object)({
+                                    at: $at,
+                                    withPgClient: $withPgClient,
+                                    pgSettings: $pgSettings,
+                                    ...planParentPk($parent)
+                                });
+                                return (0, grafast_1.lambda)($combined, async (vals) => {
+                                    const { at, withPgClient, pgSettings } = vals;
+                                    if (!withPgClient)
+                                        return null;
+                                    const params = [];
+                                    const preds = info.pkColumns.map((pk) => {
+                                        params.push(vals[`pk_${pk.column}`]);
+                                        return `${quoteIdent(pk.column)} = $${params.length}`;
+                                    });
+                                    params.push(at);
+                                    const atParam = `$${params.length}`;
+                                    const sql = `SELECT ${selectColumnsSql(info)} FROM ${historyQualified}
+                      WHERE ${preds.join(' AND ')}
+                        AND ${quoteIdent(info.recordedAtColumn)} <= ${atParam}
+                      ${orderClause} LIMIT 1`;
+                                    const row = await withPgClient(pgSettings, async (pgClient) => {
+                                        const res = await pgClient.query({ text: sql, values: params });
+                                        return res.rows[0] ?? null;
+                                    });
+                                    return mapVersionRow(info, row);
+                                });
+                            }
+                        },
+                        versionsBetween: {
+                            type: new GraphQLNonNull(new GraphQLList(new GraphQLNonNull(versionType))),
+                            description: `Versions of this ${info.sourceTypeName} recorded within the given time window (inclusive), newest first.`,
+                            args: {
+                                from: { type: new GraphQLNonNull(build.getTypeByName('Datetime') ?? GraphQLString) },
+                                to: { type: new GraphQLNonNull(build.getTypeByName('Datetime') ?? GraphQLString) }
+                            },
+                            plan($parent, fieldArgs) {
+                                const $from = fieldArgs.getRaw('from');
+                                const $to = fieldArgs.getRaw('to');
+                                const $withPgClient = (0, grafast_1.context)().get('withPgClient');
+                                const $pgSettings = (0, grafast_1.context)().get('pgSettings');
+                                const $combined = (0, grafast_1.object)({
+                                    from: $from,
+                                    to: $to,
+                                    withPgClient: $withPgClient,
+                                    pgSettings: $pgSettings,
+                                    ...planParentPk($parent)
+                                });
+                                return (0, grafast_1.lambda)($combined, async (vals) => {
+                                    const { from, to, withPgClient, pgSettings } = vals;
+                                    if (!withPgClient)
+                                        return [];
+                                    const params = [];
+                                    const preds = info.pkColumns.map((pk) => {
+                                        params.push(vals[`pk_${pk.column}`]);
+                                        return `${quoteIdent(pk.column)} = $${params.length}`;
+                                    });
+                                    params.push(from);
+                                    const fromParam = `$${params.length}`;
+                                    params.push(to);
+                                    const toParam = `$${params.length}`;
+                                    const sql = `SELECT ${selectColumnsSql(info)} FROM ${historyQualified}
+                      WHERE ${preds.join(' AND ')}
+                        AND ${quoteIdent(info.recordedAtColumn)} >= ${fromParam}
+                        AND ${quoteIdent(info.recordedAtColumn)} <= ${toParam}
+                      ${orderClause}`;
+                                    const rows = await withPgClient(pgSettings, async (pgClient) => {
+                                        const res = await pgClient.query({ text: sql, values: params });
+                                        return res.rows;
+                                    });
+                                    return rows.map((row) => mapVersionRow(info, row));
+                                });
+                            }
+                        }
+                    }, `Adding history fields to ${info.sourceTypeName}`);
+                }
+            }
+        }
+    };
+}
+exports.HistoryPlugin = createHistoryPlugin();

package/preset.d.ts

@@ -0,0 +1,20 @@
+/**
+ * PostGraphile v5 History Preset
+ *
+ * Convenience preset that bundles the history plugin with configurable options.
+ *
+ * @example
+ * ```typescript
+ * import { HistoryPreset } from 'graphile-history';
+ *
+ * const preset = {
+ *   extends: [
+ *     HistoryPreset(),
+ *   ],
+ * };
+ * ```
+ */
+import type { GraphileConfig } from 'graphile-config';
+import type { HistoryPluginOptions } from './types';
+export declare function HistoryPreset(options?: HistoryPluginOptions): GraphileConfig.Preset;
+export default HistoryPreset;

package/preset.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * PostGraphile v5 History Preset
+ *
+ * Convenience preset that bundles the history plugin with configurable options.
+ *
+ * @example
+ * ```typescript
+ * import { HistoryPreset } from 'graphile-history';
+ *
+ * const preset = {
+ *   extends: [
+ *     HistoryPreset(),
+ *   ],
+ * };
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HistoryPreset = HistoryPreset;
+const plugin_1 = require("./plugin");
+function HistoryPreset(options = {}) {
+    return {
+        plugins: [(0, plugin_1.createHistoryPlugin)(options)]
+    };
+}
+exports.default = HistoryPreset;