@protobase/server 0.33.4 → 0.34.1

package/dist/encryption/status.js

@@ -0,0 +1,92 @@
+import { bindingOf } from "./binding.js";
+import { envelopePrefix } from "./envelope-seal.js";
+import { columnId, tableId } from "../sql-parts.js";
+import { UnreadableValue, openText } from "./envelope-open.js";
+import { cascadingKeys } from "./cascading-keys.js";
+import { historyRemnants, outboxRemnants } from "./remnants.js";
+import { scanColumn } from "./scan.js";
+import { sql } from "kysely";
+//#region src/encryption/status.ts
+const encryptedFields = (entry) => Object.values(entry.model.fields).filter((field) => field.encrypted);
+/** Opens one scanned value: its plaintext and key id, or why it does not open. A value that is no envelope is plaintext. */
+const examine = (keyring, entry, field, row, binding = bindingOf(entry.model, field, row.record)) => {
+	if (!row.stored.startsWith("pbenc:")) return { kind: "plaintext" };
+	try {
+		return {
+			kind: "open",
+			plaintext: openText(keyring, binding, row.stored, {
+				resource: entry.name,
+				field: field.name
+			}),
+			kid: row.stored.split(":")[2]
+		};
+	} catch (error) {
+		if (!(error instanceof UnreadableValue)) throw error;
+		return {
+			kind: "unreadable",
+			entry: {
+				key: entry.model.primaryKey.map((name) => String(row.record[name])),
+				...error.kid && { kid: error.kid },
+				kind: error.kind
+			}
+		};
+	}
+};
+const fieldStatus = async (db, entry, field, keyring, changesSchema) => {
+	const status = {
+		resource: entry.name,
+		field: field.name,
+		byKey: {},
+		plaintext: 0,
+		unreadable: [],
+		history: 0,
+		outbox: 0
+	};
+	await scanColumn(db, entry, field, async (rows) => {
+		for (const row of rows) {
+			const found = examine(keyring, entry, field, row);
+			if (found.kind === "plaintext") status.plaintext++;
+			else if (found.kind === "open") status.byKey[found.kid] = (status.byKey[found.kid] ?? 0) + 1;
+			else status.unreadable.push(found.entry);
+		}
+	});
+	status.history = await historyRemnants(db, changesSchema, entry.model, field);
+	status.outbox = await outboxRemnants(db, changesSchema, entry.model, field);
+	return status;
+};
+const strayValues = async (db, entry) => {
+	const fields = Object.values(entry.model.fields).filter((field) => field.type === "text" && !field.encrypted);
+	const stray = [];
+	for (const field of fields) {
+		const { rows } = await sql`select count(*)::text as count from ${tableId(entry.model)} where ${columnId(field)} like ${`${envelopePrefix}%`}`.execute(db);
+		const count = Number(rows[0].count);
+		if (count > 0) stray.push({
+			resource: entry.name,
+			field: field.name,
+			count
+		});
+	}
+	return stray;
+};
+/**
+* Per encrypted field: the values by key, the plaintext ones, those that do not open, and the old plaintext left in the
+* history and the outbox; envelopes in fields that are not encrypted; foreign keys that rewrite a key. It writes nothing.
+*/
+const encryptionStatus = async (db, entries, keyring, changesSchema) => {
+	const fields = [];
+	const stray = [];
+	const cascading = [];
+	for (const entry of entries) {
+		for (const field of encryptedFields(entry)) fields.push(await fieldStatus(db, entry, field, keyring, changesSchema));
+		stray.push(...await strayValues(db, entry));
+		if (encryptedFields(entry).length > 0) cascading.push(...await cascadingKeys(db, entry.model));
+	}
+	return {
+		kid: keyring.current.id,
+		fields,
+		stray,
+		cascading
+	};
+};
+//#endregion
+export { encryptedFields, encryptionStatus, examine };

package/dist/encryption/stored-value.js

@@ -0,0 +1,16 @@
+import { Sealed } from "./envelope-seal.js";
+//#region src/encryption/stored-value.ts
+/**
+* The value a record write sends for `field`: JSON as text, and for an encrypted field only `null` or a value `sealValues`
+* sealed, so no write path stores plaintext in it.
+*/
+const storedValue = (field, value) => {
+	if (field.encrypted) {
+		if (value === null) return null;
+		if (value instanceof Sealed) return Sealed.textOf(value);
+		throw new Error(`"${field.name}" is encrypted, and its value was not sealed`);
+	}
+	return field.type === "json" && value !== null ? JSON.stringify(value) : value;
+};
+//#endregion
+export { storedValue };

package/dist/encryption/tools.d.ts

@@ -0,0 +1,26 @@
+import { EventsOptions } from "../changes/events-options.js";
+import { ResourceSource } from "../resource-source.js";
+import { EncryptionStatus } from "./status.js";
+import { ApplyOptions, ApplyResult } from "./apply.js";
+import { Db } from "@protobase/query";
+//#region src/encryption/tools.d.ts
+export type EncryptionToolsInput = {
+  resources: ResourceSource[];
+  db: Db;
+  events?: EventsOptions;
+  env: Record<string, string | undefined>;
+};
+/**
+ * What `protobase encryption status` and `apply` run on a project: `undefined` when it has no encrypted fields. It fails
+ * on the same config and key problems as the server's startup. `kid` is the id of the current key.
+ */
+export declare const createEncryptionTools: ({ resources, db, events, env }: EncryptionToolsInput) => {
+  kid: string;
+  /** What every encrypted field's column holds, and what remains of its plaintext; it writes nothing. */
+  status: () => Promise<EncryptionStatus>;
+  /** Encrypts the plaintext, moves previous keys' values to the current one, rebinds renamed ones, and scrubs remnants. */
+  apply: (options?: ApplyOptions) => Promise<ApplyResult>;
+} | undefined;
+/** The tools of a project with encrypted fields. */
+export type EncryptionTools = NonNullable<ReturnType<typeof createEncryptionTools>>;
+//#endregion

package/dist/encryption/tools.js

@@ -0,0 +1,34 @@
+import { changesSchema } from "../changes/events-options.js";
+import { createEncryptionRuntime } from "./runtime.js";
+import { buildRegistry } from "../registry.js";
+import { encryptionStatus } from "./status.js";
+import { applyEncryption } from "./apply.js";
+import { rebindProblem } from "./rebind-check.js";
+//#region src/encryption/tools.ts
+/**
+* What `protobase encryption status` and `apply` run on a project: `undefined` when it has no encrypted fields. It fails
+* on the same config and key problems as the server's startup. `kid` is the id of the current key.
+*/
+const createEncryptionTools = ({ resources, db, events, env }) => {
+	const { entries } = buildRegistry(resources);
+	const runtime = createEncryptionRuntime({
+		models: entries.map((entry) => entry.model),
+		env
+	});
+	if (!runtime) return void 0;
+	const { keyring } = runtime;
+	const schema = changesSchema(events);
+	return {
+		kid: keyring.current.id,
+		/** What every encrypted field's column holds, and what remains of its plaintext; it writes nothing. */
+		status: () => encryptionStatus(db, entries, keyring, schema),
+		/** Encrypts the plaintext, moves previous keys' values to the current one, rebinds renamed ones, and scrubs remnants. */
+		apply: async (options = {}) => {
+			const problem = options.rebind && rebindProblem(entries, options.rebind);
+			if (problem) throw new Error(problem);
+			return applyEncryption(db, entries, keyring, schema, options);
+		}
+	};
+};
+//#endregion
+export { createEncryptionTools };

package/dist/forms/check-forms.js

@@ -20,7 +20,7 @@ const fieldErrors = (registry, { form, view }, granted) => {
 		const field = model.fields[name];
 		if (!field) return [`field "${name}" does not exist on ${view.resource}`];
 		if (field.readOnly) return [`field "${name}" is read-only, so nobody fills it in`];
-		if (field.sensitive) return [`field "${name}" is sensitive, and a public form does not take sensitive fields`];
+		if (field.sensitive && !field.encrypted) return [`field "${name}" is sensitive, and a public form takes only encrypted ones of them`];
 		if (field.type === "relation") return [`field "${name}" is a relation, whose records a visitor cannot read to pick one`];
 		if (field.type === "file") return [`field "${name}" is a file field, and a visitor cannot upload`];
 		if (!plainTypes.includes(field.type)) return [`field "${name}" is ${field.type}, which a form has no input for`];

package/dist/gotrue/user-routes.js

@@ -2,6 +2,7 @@ import { effectiveSignInPolicy } from "../better-auth/sign-in-policy.js";
 import { readSignInPolicy } from "../better-auth/policy-store.js";
 import { goTrueUser, userMetadata } from "./user-json.js";
 import { checkNewAccountPassword } from "../better-auth/new-account-password.js";
+import { revokeMcpGrants } from "../better-auth/mcp/revoke-grants.js";
 import { goTrueTokens } from "./access-tokens.js";
 import { GoTrueError } from "./errors.js";
 import { readBody } from "./request-body.js";
@@ -22,6 +23,9 @@ const logoutScopes = [
 /**
 * The signed-in user's own endpoints, with their access token: `GET /user`, `PUT /user` for a new password or metadata,
 * and `POST /logout`. A token whose session has ended, by signing out or a ban, is GoTrue's `session_not_found`.
+* With MCP on, signing out everywhere or the other sessions, and setting a password, disconnect the user's MCP clients,
+* as the same steps do through Better Auth: GoTrue has no way to tell a password reset from a change, so every new
+* password does.
 */
 const userRoutes = ({ auth, context }) => {
 	const claimsOf = accessClaimsOf(goTrueTokens({ auth }));
@@ -61,6 +65,7 @@ const userRoutes = ({ auth, context }) => {
 			model: "session",
 			where
 		});
+		if (scope !== "local" && auth.mcp) await revokeMcpGrants(adapter, claims.sub);
 	};
 	return new Hono().get("/user", async (c) => c.json(await userJson(await signedIn(c.req.raw)))).put("/user", async (c) => {
 		const { email, password, data } = await readBody(c.req.raw, updateBody);
@@ -78,6 +83,7 @@ const userRoutes = ({ auth, context }) => {
 				accountId: user.id,
 				password: hash
 			});
+			if (auth.mcp) await revokeMcpGrants(ctx.adapter, user.id);
 		}
 		const merged = data && Object.fromEntries(Object.entries({
 			...userMetadata(user.metadata),

package/dist/index.d.ts

@@ -2,13 +2,13 @@ import { MobileConfig } from "./mobile-config.js";
 import { AppIdentity } from "./app-identity.js";
 import { AppIcons, PngIcon, pngIcons } from "./web-app/app-icons.js";
 import { StaffSignIn } from "./better-auth/staff-log.js";
+import { RoleDefinition, RolesInput } from "./better-auth/organizations/role-definitions.js";
 import { MailMessage, Mailer } from "./mail/smtp-mailer.js";
 import { OperatorProvider, readOperatorSettings } from "./better-auth/operator-provider.js";
-import { RoleDefinition, RolesInput } from "./better-auth/organizations/role-definitions.js";
 import { OrganizationRole, StoredMember, StoredOrganization } from "./better-auth/organizations/store.js";
+import { SignInPolicy, SignInRule, StaffAccessRule, defaultSignInPolicy, signInPolicyMethods } from "./better-auth/sign-in-policy.js";
 import { OrganizationsOptions } from "./better-auth/organizations/options.js";
 import { PlatformSignIn, readPlatformSignIn } from "./better-auth/platform-sign-in.js";
-import { SignInPolicy, SignInRule, StaffAccessRule, defaultSignInPolicy, signInPolicyMethods } from "./better-auth/sign-in-policy.js";
 import { EmailComponent, EmailOptions, EmailTemplate, RenderedEmail, defineEmail } from "./mail/define-email.js";
 import { AdminAuth, CreateAuthOptions, UserCreatedHook, createAuth, normalizeRoles } from "./better-auth/create-auth.js";
 import { EventsOptions } from "./changes/events-options.js";
@@ -54,11 +54,12 @@ import { consoleAuditQueue } from "./audit/console-queue.js";
 import { JwtOptions, JwtVerifyOptions, jwtAuthenticator, jwtVerifier } from "./auth/jwt.js";
 import { HttpProblem, MissingCredentials, badRequest, forbidden, notFound, unauthorized } from "./problem.js";
 import { TrustedApp, withTrustedApps } from "./better-auth/app-tokens.js";
-import { BetterAuthAuthenticatorOptions, betterAuthAuthenticator, betterAuthTokens } from "./better-auth/authenticator.js";
+import { BetterAuthAuthenticator, BetterAuthAuthenticatorOptions, betterAuthAuthenticator, betterAuthTokens } from "./better-auth/authenticator.js";
 import { parseRoles } from "./better-auth/parse-roles.js";
 import { LinkedAccount, NewUser, StoredUser, createUser, deleteUser, hasUsers, listUsers, roleChoices, setUserBanned, setUserRole } from "./better-auth/users.js";
 import { IssueTokenOptions, issueToken, maxTokenTtlSeconds } from "./better-auth/tokens.js";
-import { webauthnPath } from "./better-auth/origins.js";
+import { passwordLength } from "./better-auth/new-account-password.js";
+import { isOAuthWellKnownPath, oauthWellKnownPaths, webauthnPath } from "./better-auth/origins.js";
 import { goTruePath } from "./gotrue/keys.js";
 import { supabasePath } from "./supabase-paths.js";
 import { defaultAppName } from "./app-name.js";
@@ -97,6 +98,10 @@ import { S3Bucket, S3FilesOptions, S3ListPage, S3Object, s3FileStore, s3Files }
 import { storageProvider } from "./files/storage-provider.js";
 import { objectKey } from "./storage/object-key.js";
 import { FileCleanupInput, createFileCleanup } from "./files/file-cleanup.js";
+import { CascadingKey } from "./encryption/cascading-keys.js";
+import { EncryptionStatus, FieldStatus, StrayValues, UnreadableEntry } from "./encryption/status.js";
+import { ApplyOptions, ApplyResult, FieldApplied, RebindOption } from "./encryption/apply.js";
+import { EncryptionTools, EncryptionToolsInput, createEncryptionTools } from "./encryption/tools.js";
 import { FileObject, FileVariantObject } from "./files/present.js";
 import { FileRef, formatUri, variantPath } from "./files/uri.js";
 import { aspectRatio, fileSize, fileType, imageSize, processor } from "./files/processors.js";
@@ -106,4 +111,4 @@ import { isSchedule } from "./jobs/schedule.js";
 import { DrainResult, JobsRuntime, StartJobsOptions, startJobs } from "./jobs/runtime.js";
 import { jobsDrainApp } from "./jobs/drain-route.js";
 import { checkJobsSchema, jobsSchema, jobsSchemaMigration } from "./jobs/schema.js";
-export { type Admin, type AdminAuth, type AdminOptions, type ApiFunction, type ApiKeys, type ApiKeysOptions, type AppIcons, type AppIdentity, type ApprovalAnswer, type ApprovalRequest, type AssistantBackend, type AssistantOptions, type AssistantSettings, type AssistantTool, type AuditEvent, type AuditQueue, type Authenticator, type BetterAuthAuthenticatorOptions, type Caller, type CallerOptions, type CapturedRow, type ChatMessage, type ChatTextPart, type CheckAiInput, type CleanupEntry, type CleanupReport, type CleanupSchedule, type CoalescedChange, type CommentItem, type CommentUsers, type Completion, type CompletionOptions, type Conversation, type ConversationRecord, type ConversationStore, type ConversationsOptions, type CorsOptions, type CorsOrigins, type CreateAdminInput, type CreateAuthOptions, type DrainResult, type EmailComponent, type EmailOptions, type EmailTemplate, type EnqueueOptions, type ErrorReporter, type ErrorReportingOptions, type ErrorReportingSettings, type EventData, type EventsOptions, FatalJobError, type FileCleanupInput, type FileLimits, type FileObject, type FileProvider, type FileRef, type FileStore, type FileVariantObject, type FilesOptions, type FunctionApp, type FunctionCaller, type FunctionContext, type FunctionEnv, type FunctionHandler, type FunctionOptions, type FunctionRecords, type FunctionSocket, type FunctionSource, type HistoryOptions, HttpProblem, type IssueTokenOptions, type JobContext, type JobDefinition, type JobOptions, type JobsRuntime, type JwtOptions, type JwtVerifyOptions, type KeyFunctionContext, type LinkedAccount, type ListParams, type LocalFilesOptions, type MailMessage, type Mailer, type MapLayer, type MapOptions, type MapSettings, type MemberInput, MissingCredentials, type MobileConfig, ModelError, type ModelSettings, type NewOrganization, type NewUser, type OperatorProvider, type OrganizationRole, type OrganizationsOptions, type PipelineHook, type PlatformSignIn, type PluginOption, type PluginRef, type PngIcon, type ProjectConfig, type ProtectedFunctionOptions, type PublicFunctionContext, type PublicFunctionEnv, type PublicFunctionHandler, type PublicFunctionOptions, type QueryOptions, type QueryResult, type ReasoningDetail, type ReasoningEffort, type RecordKeyInput, type RecordPage, type RenderedEmail, type ResourceChange, type ResourceSource, type RoleDefinition, type RolesInput, type RunContext, type RuntimeOptions, type S3Bucket, type S3FilesOptions, type S3ListPage, type S3Object, type ScanGuardMode, type ScheduledDelete, type Session, type SessionOrganization, type Sharp, type SignInPolicy, type SignInRule, type SignatureOptions, type SocketEvents, type SourceOption, type SourceRef, type StaffAccessRule, type StaffSignIn, type StandardSchema, type StandardWebhookOptions, type StartJobsOptions, type StoreFileInput, type StoredMember, type StoredObject, type StoredOrganization, type StoredUser, type SubscriptionDefinition, type SubscriptionEvent, type SubscriptionOptions, type TenantValue, type ToolCall, type ToolContext, type ToolRecord, type ToolRecords, type ToolSpec, type TrustedApp, type TurnOptions, type User, type UserCreatedHook, type ViewSource, type WebhooksOptions, type WidgetOptions, type WriteEvent, type WriteOperation, addAppRoleToOwners, addMember, apiKeyCaller, apiKeySettings, apiKeyVariables, aspectRatio, assistantProtocolRoutes, assistantRoles, assistantSettings, assistantVariables, authSchemaMigration, backgroundSettled, badRequest, beforeSignInPluginsVariable, betterAuthAuthenticator, betterAuthTokens, changesMigration, checkAi, checkAuthSchema, checkChanges, checkComments, checkComputed, checkJobsSchema, checkSourceNames, checkViewQueries, checkWebhooksSchema, coalesce, commentsMigration, computedMigration, configExports, consoleAuditQueue, conversationKey, createAdmin, createAuth, createConversations, createFileCleanup, createOrganization, createUser, defaultAppName, defaultSignInPolicy, defineConfig, defineEmail, defineFunction, defineJob, defineTool, deleteUser, errorReportingSettings, errorReportingVariable, eventMatcher, fileConversationStore, fileSize, fileType, forbidden, formatUri, functionApp, goTruePath, handleDroppedConnections, hasUsers, imageSize, isBackgroundWork, isCaptured, isJobDefinition, isSchedule, issueToken, jobDefinitions, jobsDrainApp, jobsSchema, jobsSchemaMigration, jwtAuthenticator, jwtVerifier, limitedFileStore, listOrganizations, listUsers, localFileStore, localFiles, mapSettings, mapStyleUrl, mapStyleVariable, maxTokenTtlSeconds, maxWidgetPropsBytes, mergeConfig, migrationCommand, newWebhookSecret, normalizeRoles, notFound, objectKey, parseColumns, parseRoles, pluginOptions, pluginsBeforeSignIn, pluginsFor, pluginsVariable, pngIcons, processor, readJson, readOnlyQueryTool, readOperatorSettings, readOutbox, readPlatformSignIn, readWriteQueryTool, recordOf, removeMember, renderVariant, requestApproval, requireEnv, resourceChange, roleChoices, runInBackground, runReadOnlyQuery, runReadWriteQuery, runTurn, runtimeUrl, runtimeVariable, s3FileStore, s3Files, seesAssistant, seesRuntime, setMemberRoles, setUserBanned, setUserRole, signInPolicyMethods, sourceOptions, sourcesFor, sourcesVariable, startErrorReporting, startJobs, storageCleanupSchedule, storageProvider, storeFile, storeUsage, streamChatCompletion, subscription, supabasePath, thumbHash, unauthorized, variantPath, verifySignature, verifyStandardWebhook, waitUntil, webauthnPath, webhooks, webhooksMigration, widget, withCacheBreakpoints, withTrustedApps };
+export { type Admin, type AdminAuth, type AdminOptions, type ApiFunction, type ApiKeys, type ApiKeysOptions, type AppIcons, type AppIdentity, type ApplyOptions, type ApplyResult, type ApprovalAnswer, type ApprovalRequest, type AssistantBackend, type AssistantOptions, type AssistantSettings, type AssistantTool, type AuditEvent, type AuditQueue, type Authenticator, type BetterAuthAuthenticator, type BetterAuthAuthenticatorOptions, type Caller, type CallerOptions, type CapturedRow, type CascadingKey, type ChatMessage, type ChatTextPart, type CheckAiInput, type CleanupEntry, type CleanupReport, type CleanupSchedule, type CoalescedChange, type CommentItem, type CommentUsers, type Completion, type CompletionOptions, type Conversation, type ConversationRecord, type ConversationStore, type ConversationsOptions, type CorsOptions, type CorsOrigins, type CreateAdminInput, type CreateAuthOptions, type DrainResult, type EmailComponent, type EmailOptions, type EmailTemplate, type EncryptionStatus, type EncryptionTools, type EncryptionToolsInput, type EnqueueOptions, type ErrorReporter, type ErrorReportingOptions, type ErrorReportingSettings, type EventData, type EventsOptions, FatalJobError, type FieldApplied, type FieldStatus, type FileCleanupInput, type FileLimits, type FileObject, type FileProvider, type FileRef, type FileStore, type FileVariantObject, type FilesOptions, type FunctionApp, type FunctionCaller, type FunctionContext, type FunctionEnv, type FunctionHandler, type FunctionOptions, type FunctionRecords, type FunctionSocket, type FunctionSource, type HistoryOptions, HttpProblem, type IssueTokenOptions, type JobContext, type JobDefinition, type JobOptions, type JobsRuntime, type JwtOptions, type JwtVerifyOptions, type KeyFunctionContext, type LinkedAccount, type ListParams, type LocalFilesOptions, type MailMessage, type Mailer, type MapLayer, type MapOptions, type MapSettings, type MemberInput, MissingCredentials, type MobileConfig, ModelError, type ModelSettings, type NewOrganization, type NewUser, type OperatorProvider, type OrganizationRole, type OrganizationsOptions, type PipelineHook, type PlatformSignIn, type PluginOption, type PluginRef, type PngIcon, type ProjectConfig, type ProtectedFunctionOptions, type PublicFunctionContext, type PublicFunctionEnv, type PublicFunctionHandler, type PublicFunctionOptions, type QueryOptions, type QueryResult, type ReasoningDetail, type ReasoningEffort, type RebindOption, type RecordKeyInput, type RecordPage, type RenderedEmail, type ResourceChange, type ResourceSource, type RoleDefinition, type RolesInput, type RunContext, type RuntimeOptions, type S3Bucket, type S3FilesOptions, type S3ListPage, type S3Object, type ScanGuardMode, type ScheduledDelete, type Session, type SessionOrganization, type Sharp, type SignInPolicy, type SignInRule, type SignatureOptions, type SocketEvents, type SourceOption, type SourceRef, type StaffAccessRule, type StaffSignIn, type StandardSchema, type StandardWebhookOptions, type StartJobsOptions, type StoreFileInput, type StoredMember, type StoredObject, type StoredOrganization, type StoredUser, type StrayValues, type SubscriptionDefinition, type SubscriptionEvent, type SubscriptionOptions, type TenantValue, type ToolCall, type ToolContext, type ToolRecord, type ToolRecords, type ToolSpec, type TrustedApp, type TurnOptions, type UnreadableEntry, type User, type UserCreatedHook, type ViewSource, type WebhooksOptions, type WidgetOptions, type WriteEvent, type WriteOperation, addAppRoleToOwners, addMember, apiKeyCaller, apiKeySettings, apiKeyVariables, aspectRatio, assistantProtocolRoutes, assistantRoles, assistantSettings, assistantVariables, authSchemaMigration, backgroundSettled, badRequest, beforeSignInPluginsVariable, betterAuthAuthenticator, betterAuthTokens, changesMigration, checkAi, checkAuthSchema, checkChanges, checkComments, checkComputed, checkJobsSchema, checkSourceNames, checkViewQueries, checkWebhooksSchema, coalesce, commentsMigration, computedMigration, configExports, consoleAuditQueue, conversationKey, createAdmin, createAuth, createConversations, createEncryptionTools, createFileCleanup, createOrganization, createUser, defaultAppName, defaultSignInPolicy, defineConfig, defineEmail, defineFunction, defineJob, defineTool, deleteUser, errorReportingSettings, errorReportingVariable, eventMatcher, fileConversationStore, fileSize, fileType, forbidden, formatUri, functionApp, goTruePath, handleDroppedConnections, hasUsers, imageSize, isBackgroundWork, isCaptured, isJobDefinition, isOAuthWellKnownPath, isSchedule, issueToken, jobDefinitions, jobsDrainApp, jobsSchema, jobsSchemaMigration, jwtAuthenticator, jwtVerifier, limitedFileStore, listOrganizations, listUsers, localFileStore, localFiles, mapSettings, mapStyleUrl, mapStyleVariable, maxTokenTtlSeconds, maxWidgetPropsBytes, mergeConfig, migrationCommand, newWebhookSecret, normalizeRoles, notFound, oauthWellKnownPaths, objectKey, parseColumns, parseRoles, passwordLength, pluginOptions, pluginsBeforeSignIn, pluginsFor, pluginsVariable, pngIcons, processor, readJson, readOnlyQueryTool, readOperatorSettings, readOutbox, readPlatformSignIn, readWriteQueryTool, recordOf, removeMember, renderVariant, requestApproval, requireEnv, resourceChange, roleChoices, runInBackground, runReadOnlyQuery, runReadWriteQuery, runTurn, runtimeUrl, runtimeVariable, s3FileStore, s3Files, seesAssistant, seesRuntime, setMemberRoles, setUserBanned, setUserRole, signInPolicyMethods, sourceOptions, sourcesFor, sourcesVariable, startErrorReporting, startJobs, storageCleanupSchedule, storageProvider, storeFile, storeUsage, streamChatCompletion, subscription, supabasePath, thumbHash, unauthorized, variantPath, verifySignature, verifyStandardWebhook, waitUntil, webauthnPath, webhooks, webhooksMigration, widget, withCacheBreakpoints, withTrustedApps };

package/dist/index.js

@@ -17,7 +17,7 @@ import { requestApproval } from "./assistant/approval.js";
 import { withCacheBreakpoints } from "./assistant/cache-breakpoints.js";
 import { runTurn } from "./assistant/turn.js";
 import { consoleAuditQueue } from "./audit/console-queue.js";
-import { webauthnPath } from "./better-auth/origins.js";
+import { isOAuthWellKnownPath, oauthWellKnownPaths, webauthnPath } from "./better-auth/origins.js";
 import { apiKeySettings, apiKeyVariables } from "./api-keys/api-key-settings.js";
 import { apiKeyCaller } from "./api-keys/resolve-caller.js";
 import { jwtAuthenticator, jwtVerifier } from "./auth/jwt.js";
@@ -27,6 +27,7 @@ import { supabasePath } from "./supabase-paths.js";
 import { goTruePath } from "./gotrue/keys.js";
 import { defaultSignInPolicy, signInPolicyMethods } from "./better-auth/sign-in-policy.js";
 import { parseRoles } from "./better-auth/parse-roles.js";
+import { passwordLength } from "./better-auth/new-account-password.js";
 import { readOperatorSettings } from "./better-auth/operator-provider.js";
 import { readPlatformSignIn } from "./better-auth/platform-sign-in.js";
 import { createAuth, normalizeRoles } from "./better-auth/create-auth.js";
@@ -76,8 +77,9 @@ import { requireEnv } from "./functions/require-env.js";
 import { backgroundSettled, waitUntil } from "./functions/wait-until.js";
 import { storeFile } from "./files/store-file.js";
 import { createFileCleanup } from "./files/file-cleanup.js";
+import { createEncryptionTools } from "./encryption/tools.js";
 import { aspectRatio, fileSize, fileType, imageSize, processor } from "./files/processors.js";
 import { defineEmail } from "./mail/define-email.js";
 import { startJobs } from "./jobs/runtime.js";
 import { jobsDrainApp } from "./jobs/drain-route.js";
-export { FatalJobError, HttpProblem, MissingCredentials, ModelError, addAppRoleToOwners, addMember, apiKeyCaller, apiKeySettings, apiKeyVariables, aspectRatio, assistantProtocolRoutes, assistantRoles, assistantSettings, assistantVariables, authSchemaMigration, backgroundSettled, badRequest, beforeSignInPluginsVariable, betterAuthAuthenticator, betterAuthTokens, changesMigration, checkAi, checkAuthSchema, checkChanges, checkComments, checkComputed, checkJobsSchema, checkSourceNames, checkViewQueries, checkWebhooksSchema, coalesce, commentsMigration, computedMigration, configExports, consoleAuditQueue, conversationKey, createAdmin, createAuth, createConversations, createFileCleanup, createOrganization, createUser, defaultAppName, defaultSignInPolicy, defineConfig, defineEmail, defineFunction, defineJob, defineTool, deleteUser, errorReportingSettings, errorReportingVariable, eventMatcher, fileConversationStore, fileSize, fileType, forbidden, formatUri, functionApp, goTruePath, handleDroppedConnections, hasUsers, imageSize, isBackgroundWork, isCaptured, isJobDefinition, isSchedule, issueToken, jobDefinitions, jobsDrainApp, jobsSchema, jobsSchemaMigration, jwtAuthenticator, jwtVerifier, limitedFileStore, listOrganizations, listUsers, localFileStore, localFiles, mapSettings, mapStyleUrl, mapStyleVariable, maxTokenTtlSeconds, maxWidgetPropsBytes, mergeConfig, migrationCommand, newWebhookSecret, normalizeRoles, notFound, objectKey, parseColumns, parseRoles, pluginOptions, pluginsBeforeSignIn, pluginsFor, pluginsVariable, pngIcons, processor, readJson, readOnlyQueryTool, readOperatorSettings, readOutbox, readPlatformSignIn, readWriteQueryTool, recordOf, removeMember, renderVariant, requestApproval, requireEnv, resourceChange, roleChoices, runInBackground, runReadOnlyQuery, runReadWriteQuery, runTurn, runtimeUrl, runtimeVariable, s3FileStore, s3Files, seesAssistant, seesRuntime, setMemberRoles, setUserBanned, setUserRole, signInPolicyMethods, sourceOptions, sourcesFor, sourcesVariable, startErrorReporting, startJobs, storageCleanupSchedule, storageProvider, storeFile, storeUsage, streamChatCompletion, subscription, supabasePath, thumbHash, unauthorized, variantPath, verifySignature, verifyStandardWebhook, waitUntil, webauthnPath, webhooks, webhooksMigration, widget, withCacheBreakpoints, withTrustedApps };
+export { FatalJobError, HttpProblem, MissingCredentials, ModelError, addAppRoleToOwners, addMember, apiKeyCaller, apiKeySettings, apiKeyVariables, aspectRatio, assistantProtocolRoutes, assistantRoles, assistantSettings, assistantVariables, authSchemaMigration, backgroundSettled, badRequest, beforeSignInPluginsVariable, betterAuthAuthenticator, betterAuthTokens, changesMigration, checkAi, checkAuthSchema, checkChanges, checkComments, checkComputed, checkJobsSchema, checkSourceNames, checkViewQueries, checkWebhooksSchema, coalesce, commentsMigration, computedMigration, configExports, consoleAuditQueue, conversationKey, createAdmin, createAuth, createConversations, createEncryptionTools, createFileCleanup, createOrganization, createUser, defaultAppName, defaultSignInPolicy, defineConfig, defineEmail, defineFunction, defineJob, defineTool, deleteUser, errorReportingSettings, errorReportingVariable, eventMatcher, fileConversationStore, fileSize, fileType, forbidden, formatUri, functionApp, goTruePath, handleDroppedConnections, hasUsers, imageSize, isBackgroundWork, isCaptured, isJobDefinition, isOAuthWellKnownPath, isSchedule, issueToken, jobDefinitions, jobsDrainApp, jobsSchema, jobsSchemaMigration, jwtAuthenticator, jwtVerifier, limitedFileStore, listOrganizations, listUsers, localFileStore, localFiles, mapSettings, mapStyleUrl, mapStyleVariable, maxTokenTtlSeconds, maxWidgetPropsBytes, mergeConfig, migrationCommand, newWebhookSecret, normalizeRoles, notFound, oauthWellKnownPaths, objectKey, parseColumns, parseRoles, passwordLength, pluginOptions, pluginsBeforeSignIn, pluginsFor, pluginsVariable, pngIcons, processor, readJson, readOnlyQueryTool, readOperatorSettings, readOutbox, readPlatformSignIn, readWriteQueryTool, recordOf, removeMember, renderVariant, requestApproval, requireEnv, resourceChange, roleChoices, runInBackground, runReadOnlyQuery, runReadWriteQuery, runTurn, runtimeUrl, runtimeVariable, s3FileStore, s3Files, seesAssistant, seesRuntime, setMemberRoles, setUserBanned, setUserRole, signInPolicyMethods, sourceOptions, sourcesFor, sourcesVariable, startErrorReporting, startJobs, storageCleanupSchedule, storageProvider, storeFile, storeUsage, streamChatCompletion, subscription, supabasePath, thumbHash, unauthorized, variantPath, verifySignature, verifyStandardWebhook, waitUntil, webauthnPath, webhooks, webhooksMigration, widget, withCacheBreakpoints, withTrustedApps };

package/dist/records.js

@@ -1,3 +1,4 @@
+import { storedValue } from "./encryption/stored-value.js";
 import { columnId, filterCondition, keyConditions, returningList, scopeConditions, tableId, whereClause } from "./sql-parts.js";
 import { etagOf } from "./etag.js";
 import { exposeRow, pickFields } from "./rows.js";
@@ -24,10 +25,9 @@ const fetchRecord = async (db, entry, key, tenant, options = {}) => {
 	const query = sql`select ${returningList(entry, shape.fields)} from ${tableId(entry.model)} as t${whereClause(conditions)} limit 1${lockClause(lock)}`;
 	return stored(entry, (await rowsOf(db, query))[0], shape);
 };
-const writeValue = (field, value) => field.type === "json" && value !== null ? JSON.stringify(value) : value;
 const insertRecord = async (db, entry, values, shape = {}) => {
 	const fields = Object.keys(values).map((name) => entry.model.fields[name]);
-	const body = fields.length === 0 ? sql`default values` : sql`(${sql.join(fields.map(columnId))}) values (${sql.join(fields.map((field) => writeValue(field, values[field.name])))})`;
+	const body = fields.length === 0 ? sql`default values` : sql`(${sql.join(fields.map(columnId))}) values (${sql.join(fields.map((field) => storedValue(field, values[field.name])))})`;
 	const query = sql`insert into ${tableId(entry.model)} ${body} returning ${returningList(entry, shape.fields)}`;
 	return await stored(entry, (await rowsOf(db, query))[0], shape);
 };
@@ -39,7 +39,7 @@ const etagBump = (entry) => {
 const updateRecord = async (db, entry, key, tenant, values, shape = {}) => {
 	const assignments = [...Object.entries(values).map(([name, value]) => {
 		const field = entry.model.fields[name];
-		return sql`${columnId(field)} = ${writeValue(field, value)}`;
+		return sql`${columnId(field)} = ${storedValue(field, value)}`;
 	}), ...etagBump(entry)];
 	const conditions = [...scopeConditions(entry.model, tenant), ...keyConditions(entry.model, key)];
 	const query = sql`update ${tableId(entry.model)} as t set ${sql.join(assignments)}${whereClause(conditions)} returning ${returningList(entry, shape.fields)}`;

package/dist/request-access.js

@@ -1,3 +1,4 @@
+import { maskEncrypted } from "./encryption/mask-stored.js";
 import { forbidden, notFound, unauthorized } from "./problem.js";
 import { checkedFilter } from "./filter-input.js";
 import { checkOwnerId } from "./owner-id.js";
@@ -98,7 +99,7 @@ const trusted = (model) => ({
 	...model,
 	fields: Object.fromEntries(Object.entries(model.fields).map(([name, field]) => [name, {
 		...field,
-		filterable: true
+		filterable: !field.encrypted
 	}]))
 });
 const asFilter = (access, expr, operation) => {
@@ -109,13 +110,16 @@ const asFilter = (access, expr, operation) => {
 };
 /**
 * The record-level rule of an operation, run with the stored record (and the input of a write). Returns a verdict, or a
-* filter that the caller checks in the database, so its semantics match reads exactly.
+* filter that the caller checks in the database, so its semantics match reads exactly. The rule gets a set encrypted
+* field of the stored record as `encrypted`, never its ciphertext; the input it gets as written.
 */
 const recordDecision = async (access, operation, record, input) => {
 	const { entry, deps, full, session } = access;
 	const explicit = entry.source.accessRules[operation] ?? (operation === "list" ? entry.source.accessRules.read : void 0);
 	const fallback = deps.accessOptions.defaultAccess ? () => deps.accessOptions.defaultAccess === "allow" : deps.accessOptions.roles ? deps.accessOptions.roles.can(`${entry.name}.${operation === "list" ? "read" : operation}`) : () => true;
-	const result = await (explicit ?? fallback)({
+	const rule = explicit ?? fallback;
+	const stored = record && maskEncrypted(full, record);
+	const result = await rule({
 		user: {
 			id: session.user.id,
 			roles: session.user.roles
@@ -123,8 +127,8 @@ const recordDecision = async (access, operation, record, input) => {
 		...organizationOf(session),
 		model: full,
 		operation,
-		record
-	}, record, input);
+		record: stored
+	}, stored, input);
 	if (typeof result === "boolean") return result;
 	return asFilter(access, result, operation);
 };

package/dist/rest/encrypted-columns.js

@@ -0,0 +1,37 @@
+import { restError } from "./rest-error.js";
+import { sameTable } from "../encryption/shared-columns.js";
+//#region src/rest/encrypted-columns.ts
+const guardedTable = (served, models) => ({
+	name: served.table.name,
+	models: models.filter((model) => sameTable(model, served))
+});
+const encryptedColumns = (table) => new Set(table.models.flatMap((model) => Object.values(model.fields).filter((field) => field.encrypted).map((field) => field.column)));
+const bindingColumns = (table) => table.models.filter((model) => Object.values(model.fields).some((field) => field.encrypted)).flatMap((model) => [...model.primaryKey, ...model.tenant ? [model.tenant] : []].map((name) => model.fields[name].column));
+const refusal = (table, column, what) => restError(400, "encrypted-column", `Column '${column}' of '${table.name}' is encrypted: it cannot be ${what} here`, null, "Write and reveal encrypted fields through /api/v1");
+const filterColumns = (filter) => filter.kind === "condition" ? [filter.field.column] : filter.args.flatMap(filterColumns);
+/** Refuses filters, a sort or a join on an encrypted column, whose ciphertext no comparison matches. */
+const refuseEncryptedReads = (table, filters, order, joined = []) => {
+	const encrypted = encryptedColumns(table);
+	const read = [
+		...filters.flatMap(filterColumns),
+		...order.map((term) => term.field.column),
+		...joined
+	].find((column) => encrypted.has(column));
+	if (read !== void 0) throw refusal(table, read, "filtered, sorted or joined on");
+};
+/** Refuses a write of an encrypted column, or matching an upsert's rows on one. */
+const refuseEncryptedWrite = (table, columns) => {
+	const encrypted = encryptedColumns(table);
+	const written = columns.find((column) => encrypted.has(column));
+	if (written !== void 0) throw refusal(table, written, "written or matched on");
+};
+/**
+* On a table with encrypted fields, refuses a write that changes the key or tenant of a row, which its encrypted values
+* are bound to: an update's `columns`, or an upsert's beyond the `kept` ones it matches rows on and so writes unchanged.
+*/
+const refuseRebinding = (table, columns, kept = []) => {
+	const rebound = bindingColumns(table).find((column) => columns.includes(column) && !kept.includes(column));
+	if (rebound !== void 0) throw restError(400, "encrypted-column", `Column '${rebound}' of '${table.name}' cannot change here: its encrypted fields are bound to it`, null, "Change it through /api/v1");
+};
+//#endregion
+export { guardedTable, refuseEncryptedReads, refuseEncryptedWrite, refuseRebinding };

package/dist/rest/table-routes.js

@@ -7,6 +7,7 @@ import { parseQuery } from "./parse-query.js";
 import { embedsOf, resolveShape } from "./embed-shape.js";
 import { readRows } from "./read-rows.js";
 import { asCaller, queryParams, readBody } from "./rest-context.js";
+import { guardedTable, refuseEncryptedReads, refuseEncryptedWrite, refuseRebinding } from "./encrypted-columns.js";
 import { scanRefusal, uncoveredReads } from "./rest-scan.js";
 import { deleteRows, insertRows, updateRows } from "./write-rows.js";
 import { Hono } from "hono";
@@ -35,27 +36,32 @@ const shapeOf = async (deps, foreignKeys, entry, query) => {
 		embedded: query.embedded
 	}, entry.model.table.name, query.select);
 };
+const guarded = (deps, entry) => guardedTable(entry.model, deps.registry.entries.map((one) => one.model));
 const targetOf = (entry) => ({
 	table: tableId(entry.model),
 	alias: entry.model.table.name
 });
+/** What a request reads of the table and of every embedded one: its filters, its sort and the columns it joins on. */
+const readsOf = (deps, entry, filters, order, shape) => [{
+	entry,
+	filters,
+	order,
+	joined: []
+}, ...embedsOf(shape).map((embed) => ({
+	entry: tableEntry(deps, embed.table),
+	filters: embed.params.filters,
+	order: embed.params.order,
+	joined: embed.relationship.join.map((pair) => pair.target)
+}))];
 /**
-* Refuses filters and a sort no index serves, as the scan guard does on `/api/v1`, on the table and on every embedded
-* one, whose join columns need an index too; in `warn` mode, a warning header instead.
+* Refuses filters, a sort or a join on an encrypted column; then filters and a sort no index serves, as the scan guard
+* does on `/api/v1`, on the table and on every embedded one, whose join columns need an index too; in `warn` mode, a
+* warning header instead.
 */
 const scanCheck = async (deps, entry, filters, order, shape = []) => {
+	const reads = readsOf(deps, entry, filters, order, shape);
+	for (const read of reads) refuseEncryptedReads(guarded(deps, read.entry), read.filters, read.order, read.joined);
 	if (deps.guard.mode === "off") return {};
-	const reads = [{
-		entry,
-		filters,
-		order,
-		joined: []
-	}, ...embedsOf(shape).map((embed) => ({
-		entry: tableEntry(deps, embed.table),
-		filters: embed.params.filters,
-		order: embed.params.order,
-		joined: embed.relationship.join.map((pair) => pair.target)
-	}))];
 	for (const read of reads) {
 		const [first] = uncoveredReads(await deps.guard.indexesOf(read.entry), read.filters, read.order, read.joined);
 		if (!first) continue;
@@ -130,6 +136,9 @@ const insert = async (deps, foreignKeys, c) => {
 	if (columns.length === 0 && rows.length > 1) throw restError(400, "PGRST102", "Several rows without any column cannot be inserted at once");
 	if (rows.length === 0 && object) checkSingle(0);
 	const conflict = query.onConflict ?? entry.model.primaryKey.map((name) => entry.model.fields[name].column);
+	const table = guarded(deps, entry);
+	refuseEncryptedWrite(table, prefer.resolution ? [...columns, ...conflict] : columns);
+	if (prefer.resolution === "merge-duplicates") refuseRebinding(table, columns, conflict);
 	const written = rows.length === 0 ? {
 		total: 0,
 		...prefer.return === "representation" && { body: "[]" }
@@ -154,6 +163,9 @@ const update = async (deps, foreignKeys, c) => {
 	const object = wantsObject(c.req.raw);
 	const body = await readBody(c);
 	if (!isRecord(body)) throw restError(400, "PGRST102", "Empty or invalid json");
+	const table = guarded(deps, entry);
+	refuseEncryptedWrite(table, Object.keys(body));
+	refuseRebinding(table, Object.keys(body));
 	const shape = await shapeOf(deps, foreignKeys, entry, query);
 	const warning = await scanCheck(deps, entry, query.filters, [], shape);
 	const written = Object.keys(body).length === 0 ? {

package/dist/reveal-service.js

@@ -1,10 +1,21 @@
 import { badRequest, notFound } from "./problem.js";
 import { tenantScope } from "./tenant.js";
 import { requestAccess, requireOperation } from "./request-access.js";
+import { bindingOf } from "./encryption/binding.js";
 import { fetchReadable } from "./fetch-readable.js";
 import { readTransaction } from "./transactions.js";
+import { openText } from "./encryption/envelope-open.js";
 import { encodeKey } from "@protobase/schema/internal";
 //#region src/reveal-service.ts
+const revealedValue = (deps, model, field, record) => {
+	const stored = record[field.name] ?? null;
+	if (!field.encrypted || stored === null) return stored;
+	if (!deps.encryption) throw new Error(`"${model.name}" has encrypted fields but no encryption runtime`);
+	return openText(deps.encryption.keyring, bindingOf(model, field, record), String(stored), {
+		resource: model.name,
+		field: field.name
+	});
+};
 /**
 * The value of one sensitive field of one record, for a caller who may read the record and the field: the same tenant,
 * row filter and record-level rule as a get. The reveal is published to the audit queue before the value is returned;
@@ -17,9 +28,12 @@ const revealField = async (deps, entry, session, request) => {
 	const field = Object.hasOwn(access.readable.fields, name) ? access.readable.fields[name] : void 0;
 	if (!field) throw badRequest("invalid-parameter", `Unknown field "${name}"`);
 	if (!field.sensitive) throw badRequest("invalid-parameter", `"${name}" is not sensitive; it comes with the record`);
-	const keyFields = access.full.primaryKey.map((part) => access.full.fields[part]);
-	const found = await readTransaction(deps.db, deps.statementTimeoutMs, (trx) => fetchReadable(trx, access, request.key, "hide", { fields: [...keyFields, access.full.fields[name]] }));
+	const { full } = access;
+	const tenantField = full.fields[name].encrypted && full.tenant && !full.primaryKey.includes(full.tenant) ? [full.tenant] : [];
+	const keyFields = [...full.primaryKey, ...tenantField].map((part) => full.fields[part]);
+	const found = await readTransaction(deps.db, deps.statementTimeoutMs, (trx) => fetchReadable(trx, access, request.key, "hide", { fields: [...keyFields, full.fields[name]] }));
 	if (!found) throw notFound(`No ${entry.name} with this key`);
+	const value = revealedValue(deps, access.full, full.fields[name], found.record);
 	const tenant = tenantScope(entry, session)?.tenantValue;
 	await deps.audit.publish({
 		type: "field.revealed",
@@ -36,7 +50,7 @@ const revealField = async (deps, entry, session, request) => {
 	});
 	return {
 		field: name,
-		value: found.record[name] ?? null
+		value
 	};
 };
 //#endregion

package/dist/types.d.ts

@@ -19,6 +19,11 @@ export type Session = {
   tenant?: TenantValue;
   organization?: SessionOrganization;
   anonymous?: true;
+  /** The outside app acting as the user, such as an MCP client: its OAuth client id and the scopes its token carries. */
+  client?: {
+    id: string;
+    scopes: string[];
+  };
 };
 /**
  * Resolves the caller of a request, or throws a 401 problem (see `unauthorized`). `userIdType` declares the type of

package/dist/validate-body.js

@@ -1,3 +1,4 @@
+import { maskEncrypted } from "./encryption/mask-stored.js";
 import { badRequest } from "./problem.js";
 import { writableFields } from "./request-access.js";
 //#region src/validate-body.ts
@@ -31,7 +32,8 @@ const requiredOnCreate = (field, schema) => !(field.default && "db" in field.def
 * for a text field that may not be null counts as not given: a create fills in its default or reports it required,
 * an update reports it required. Only the values written are checked, so a stored '' still reads.
 * Returns only the values to write: on create the defaults are filled in, on update only the provided fields.
-* `current` is the stored record an update merges into for `.validate()` rules.
+* `current` is the stored record an update merges into for `.validate()` rules, which get a set encrypted field of it as
+* `encrypted`: they see an encrypted value as text only when this write gives it.
 */
 const validateBody = (access, mode, body, current = {}) => {
 	if (!isObject(body)) throw badRequest("invalid-record", "The request body must be a JSON object");
@@ -85,7 +87,7 @@ const validateBody = (access, mode, body, current = {}) => {
 	}
 	if (errors.length > 0) throw fail(errors);
 	const merged = {
-		...current,
+		...maskEncrypted(full, current),
 		...values
 	};
 	const issues = entry.source.validators.flatMap((validate) => validate(merged) ?? []);

package/dist/webhooks/subscriber-view.js

@@ -40,7 +40,20 @@ const subscriptionEvent = (change, event, { fields, thin = false } = {}) => ({
 		transaction: change.transaction
 	}
 });
-const mayRead = async (access, record) => {
+const withUnknownEncrypted = (model, record) => {
+	const fields = Object.values(model.fields).filter((field) => field.encrypted);
+	if (fields.length === 0) return record;
+	const unknown = { ...record };
+	for (const field of fields) Object.defineProperty(unknown, field.name, {
+		enumerable: true,
+		get: () => {
+			throw new Error(`a subscription's access check cannot tell whether the encrypted field "${field.name}" is set`);
+		}
+	});
+	return unknown;
+};
+const mayRead = async (access, captured) => {
+	const record = withUnknownEncrypted(access.full, captured);
 	const { resolved, session, entry } = access;
 	if (!resolved.operations.read) return false;
 	if (resolved.rowFilter.read && evaluateFilter(resolved.rowFilter.read, record) !== true) return false;