CodeVetter · Repo Unpack · Extension points

keystonejs/keystone

Scanned commit 1a8f2b7fae dated 2026-09-14 — last upstream commit. Generated by codevetter codevetter 1.15.0 on 2026-10-02. Deep analysis by cli:codex via the codex CLI on 2026-10-02 (381s). Source inspection; upstream code and tests were not executed.

Keystone extensions are primarily configuration callbacks and typed factories rather than a central plugin registry. Lists, fields, hooks, actions, schema extensions, sessions, and storage strategies feed into generated runtime and UI structures. Transport and Admin UI generation expose additional integration boundaries.

Custom fields plug in as FieldTypeFunc factories receiving provider/list/field metadata; their result supplies database shape, input/output resolvers, access, hooks, views, and Admin metadata.
packages/core/src/lib/core/initialise-lists.ts#L150-201 packages/core/src/lib/core/initialise-lists.ts#L765-805 packages/core/src/fields/types/file/index.ts#L113-153
graphql.extendGraphqlSchema() receives the generated schema after core query/mutation assembly; createAuth() composes its authentication extension before the application's existing extension.
packages/core/src/lib/graphql.ts#L59-82 packages/auth/src/index.ts#L194-212
list.actions entries are initialized into GraphQL argument types, singular/plural operation names, telemetry labels, and UI prompt/navigation metadata; field-rendered arguments cannot suppress the item prompt.
packages/core/src/lib/core/initialise-lists.ts#L1252-1274 packages/core/src/lib/core/initialise-lists.ts#L1275-1300 packages/core/src/schema.ts#L245-259
Field and list resolveInput hooks transform data in that order; validation and beforeOperation/afterOperation hooks provide separate lifecycle stages around CRUD persistence.
packages/core/src/lib/core/mutations/index.ts#L526-576 packages/core/src/lib/core/mutations/index.ts#L597-619
Database customization uses prismaClientOptions(), extendPrismaClient(), extendPrismaSchema(), and onConnect(); getKeystone() also accepts an existing Prisma client.
packages/core/src/schema.ts#L150-158 packages/core/src/lib/getContext.ts#L92-115
Session strategies implement get/start/end, storedSessions accepts a store factory parameterized by maxAge, and asset StorageStrategy delegates put/delete/url with access to the Keystone context.
packages/core/src/session.ts#L88-135 packages/core/src/session.ts#L138-167 packages/core/src/fields/types/file/index.ts#L65-80 packages/core/src/fields/types/file/index.ts#L139-148
Admin UI generation accepts ui.getAdditionalFiles() and discovers admin/pages files; additional files take precedence, and custom pages override matching generated pages.
packages/core/src/admin-ui/system/generateAdminUI.ts#L78-128
server.extendExpressApp() and extendHttpServer() run before Apollo middleware registration; document consumers separately extend editing through componentBlocks and DocumentFeatures without exposing Slate as the public customization contract.
packages/core/src/lib/express.ts#L61-100 packages/fields-document/src/index.ts#L71-82 packages/fields-document/ARCHITECTURE.md#L69-80 packages/fields-document/ARCHITECTURE.md#L103-105