@rocicorp/zero 1.11.0-canary.26 → 1.11.0-canary.28

package/out/zero-cache/src/config/zero-config.js

@@ -15,7 +15,7 @@ import { timingSafeEqual } from "node:crypto";
 var ZERO_ENV_VAR_PREFIX = "ZERO_";
 var appOptions = {
 	id: {
-		type: valita_exports.string().default("zero").assert((id) => ALLOWED_APP_ID_CHARACTERS.test(id), INVALID_APP_ID_MESSAGE),
+		type: valita_exports.string().optional(() => "zero").assert((id) => ALLOWED_APP_ID_CHARACTERS.test(id), INVALID_APP_ID_MESSAGE),
 		desc: [
 			"Unique identifier for the app.",
 			"",
@@ -65,7 +65,7 @@ var shardOptions = {
 		hidden: true
 	},
 	num: {
-		type: valita_exports.number().default(0),
+		type: valita_exports.number().optional(() => 0),
 		desc: [
 			`The shard number (from 0 to NUM_SHARDS) of the App. zero will eventually`,
 			`support data sharding as a first-class primitive; until then, deploying`,
@@ -77,7 +77,7 @@ var shardOptions = {
 };
 var replicaOptions = {
 	file: {
-		type: valita_exports.string().default("zero.db"),
+		type: valita_exports.string().optional(() => "zero.db"),
 		desc: [
 			`File path to the SQLite replica that zero-cache maintains.`,
 			`This can be lost, but if it is, zero-cache will have to re-replicate next`,
@@ -100,7 +100,7 @@ var perUserMutationLimit = {
 		desc: [`The maximum mutations per user within the specified {bold windowMs}.`, `If unset, no rate limiting is enforced.`]
 	},
 	windowMs: {
-		type: valita_exports.number().default(6e4),
+		type: valita_exports.number().optional(() => 6e4),
 		desc: [`The sliding window over which the {bold perUserMutationLimitMax} is enforced.`]
 	}
 };
@@ -131,11 +131,11 @@ var authOptions = {
 		deprecated: [`Use cookie-based authentication or an auth token instead - see https://zero.rocicorp.dev/docs/auth.`]
 	},
 	revalidateIntervalSeconds: {
-		type: valita_exports.number().default(300),
+		type: valita_exports.number().optional(() => 300),
 		desc: [`The interval in seconds between periodic /query auth revalidation for validated connections.`, `If unset, periodic auth revalidation is disabled.`]
 	},
 	retransformIntervalSeconds: {
-		type: valita_exports.number().default(300),
+		type: valita_exports.number().optional(() => 300),
 		desc: [`The interval in seconds between periodic shared /query retransform work for a client group.`, `If unset, periodic shared retransform is disabled.`]
 	}
 };
@@ -192,7 +192,7 @@ var makeMutatorQueryOptions = (replacement, suffix) => ({
 		...replacement ? { deprecated: [makeDeprecationMessage(`${replacement}-api-key`)] } : {}
 	},
 	forwardCookies: {
-		type: valita_exports.boolean().default(false),
+		type: valita_exports.boolean().optional(() => false),
 		desc: [
 			`If true, zero-cache will forward cookies from the request.`,
 			`This is useful for passing authentication cookies to the API server.`,
@@ -236,7 +236,7 @@ var zeroOptions = {
 			desc: [`The "upstream" authoritative postgres database.`, `In the future we will support other types of upstream besides PG.`]
 		},
 		type: {
-			type: literalUnion("pg", "custom").default("pg"),
+			type: literalUnion("pg", "custom").optional(() => "pg"),
 			desc: [
 				`The meaning of the {bold upstream-db} depends on the upstream type:`,
 				`* {bold pg}: The connection database string, e.g. "postgres://..."`,
@@ -246,7 +246,7 @@ var zeroOptions = {
 			hidden: true
 		},
 		maxConns: {
-			type: valita_exports.number().default(20),
+			type: valita_exports.number().optional(() => 20),
 			desc: [
 				`The maximum number of connections to open to the upstream database`,
 				`for committing mutations. This is divided evenly amongst sync workers.`,
@@ -275,7 +275,7 @@ var zeroOptions = {
 			]
 		},
 		pgReplicationSlotPerReplica: {
-			type: valita_exports.boolean().default(false),
+			type: valita_exports.boolean().optional(() => false),
 			desc: [
 				`Creates a dedicated replication slot for each replication-manager, rather than`,
 				`having a new replication-manager take over the slot of the one it replaces.`,
@@ -312,7 +312,7 @@ var zeroOptions = {
 			hidden: true
 		},
 		pgResumeOrphanedSlotGracePeriodMs: {
-			type: valita_exports.number().default(2e4),
+			type: valita_exports.number().optional(() => 2e4),
 			desc: [
 				`The grace period to wait before taking over an inactive replication slot, "resuming"`,
 				`the replica. With high availability replication, a new replica is generally "forked"`,
@@ -326,7 +326,7 @@ var zeroOptions = {
 			hidden: true
 		},
 		pgReplicationEpoch: {
-			type: valita_exports.number().default(0),
+			type: valita_exports.number().optional(() => 0),
 			desc: [
 				`Replication managers sharing the same epoch attempt to converge on a single`,
 				`generation (i.e. the result of an initial-sync); if multiple tasks are started`,
@@ -345,7 +345,7 @@ var zeroOptions = {
 			hidden: true
 		},
 		pgPartialIndexTriggers: {
-			type: valita_exports.boolean().default(false),
+			type: valita_exports.boolean().optional(() => false),
 			hidden: true
 		},
 		pgStreamInboundTimeoutMs: {
@@ -377,7 +377,7 @@ var zeroOptions = {
 	getQueries: getQueriesOptions,
 	query: queryOptions,
 	enableCrudMutations: {
-		type: valita_exports.boolean().default(true),
+		type: valita_exports.boolean().optional(() => true),
 		desc: [
 			`Enables support for legacy CRUD mutations. When this is {bold false}, no connections`,
 			`are made from view-syncers to the upstream db, and push messages with CRUD mutations`,
@@ -385,7 +385,7 @@ var zeroOptions = {
 		]
 	},
 	allowLegacyQueries: {
-		type: valita_exports.boolean().default(false),
+		type: valita_exports.boolean().optional(() => false),
 		desc: [
 			`Allows clients to send legacy query ASTs directly to zero-cache.`,
 			`Keep this disabled when using custom queries so that zero-cache rejects`,
@@ -402,7 +402,7 @@ var zeroOptions = {
 			]
 		},
 		maxConns: {
-			type: valita_exports.number().default(30),
+			type: valita_exports.number().optional(() => 30),
 			desc: [
 				`The maximum number of connections to open to the CVR database.`,
 				`This is divided evenly amongst sync workers.`,
@@ -416,7 +416,7 @@ var zeroOptions = {
 			hidden: true
 		},
 		garbageCollectionInactivityThresholdHours: {
-			type: valita_exports.number().default(168),
+			type: valita_exports.number().optional(() => 168),
 			desc: [
 				`The duration after which an inactive CVR is eligible for garbage collection.`,
 				`Purging a CVR forces the next connection from that client group to`,
@@ -427,7 +427,7 @@ var zeroOptions = {
 			]
 		},
 		garbageCollectionInitialIntervalSeconds: {
-			type: valita_exports.number().default(60),
+			type: valita_exports.number().optional(() => 60),
 			desc: [
 				`The initial interval at which to check and garbage collect inactive CVRs.`,
 				`This interval is increased exponentially (up to 16 minutes) when there is`,
@@ -435,7 +435,7 @@ var zeroOptions = {
 			]
 		},
 		garbageCollectionInitialBatchSize: {
-			type: valita_exports.number().default(25),
+			type: valita_exports.number().optional(() => 25),
 			desc: [
 				`The initial number of CVRs to purge per garbage collection interval.`,
 				`This number is increased linearly if the rate of new CVRs exceeds the rate of`,
@@ -454,12 +454,12 @@ var zeroOptions = {
 		]
 	},
 	sqliteCorruptionChecks: {
-		type: valita_exports.boolean().default(false),
+		type: valita_exports.boolean().optional(() => false),
 		desc: [`Run SQLite quick_check and integrity_check when corruption is detected.`, `These checks scan the replica and can take a long time on large databases.`],
 		hidden: true
 	},
 	snapshotRowCacheSize: {
-		type: valita_exports.number().default(5e4),
+		type: valita_exports.number().optional(() => 5e4),
 		desc: [
 			`The maximum number of entries in the per-worker cache of replica rows`,
 			`read while advancing IVM pipelines. Every client group on a sync worker`,
@@ -472,7 +472,7 @@ var zeroOptions = {
 		hidden: true
 	},
 	enableQueryPlanner: {
-		type: valita_exports.boolean().default(true),
+		type: valita_exports.boolean().optional(() => true),
 		desc: [
 			`Enable the query planner for optimizing ZQL queries.`,
 			``,
@@ -483,7 +483,7 @@ var zeroOptions = {
 		]
 	},
 	enableCorrelatedPredicatePushdown: {
-		type: valita_exports.boolean().default(true),
+		type: valita_exports.boolean().optional(() => true),
 		desc: [
 			`Copy a query's equality conditions on a relationship's join columns`,
 			`into the related subquery. This reduces the rows that are read when a`,
@@ -494,7 +494,7 @@ var zeroOptions = {
 		hidden: true
 	},
 	enablePlannerAwarePushdown: {
-		type: valita_exports.boolean().default(true),
+		type: valita_exports.boolean().optional(() => true),
 		desc: [
 			`Copy the conditions of correlated predicate pushdown before the query`,
 			`planner runs instead of after, so that the planner can use them. This`,
@@ -505,7 +505,7 @@ var zeroOptions = {
 		hidden: true
 	},
 	enableQueryCovering: {
-		type: valita_exports.boolean().default(true),
+		type: valita_exports.boolean().optional(() => true),
 		desc: [
 			`Enable shadow-mode query covering detection during query hydration.`,
 			``,
@@ -516,7 +516,7 @@ var zeroOptions = {
 		]
 	},
 	deferIvmWrites: {
-		type: valita_exports.boolean().default(true),
+		type: valita_exports.boolean().optional(() => true),
 		desc: [
 			`Derive IVM advancements without writing to the replica snapshot.`,
 			``,
@@ -535,7 +535,7 @@ var zeroOptions = {
 		hidden: true
 	},
 	deferIvmWritesHeapProportion: {
-		type: valita_exports.number().assert((value) => value > 0 && value <= 1, "must be greater than 0 and at most 1").default(.25),
+		type: valita_exports.number().assert((value) => value > 0 && value <= 1, "must be greater than 0 and at most 1").optional(() => .25),
 		desc: [
 			`With {bold deferIvmWrites}, the proportion of {bold --max-old-space-size}`,
 			`that the client groups of one sync worker may hold in memory at once.`,
@@ -552,7 +552,7 @@ var zeroOptions = {
 		hidden: true
 	},
 	yieldThresholdMs: {
-		type: valita_exports.number().default(10),
+		type: valita_exports.number().optional(() => 10),
 		desc: [
 			`The maximum amount of time in milliseconds that a sync worker will`,
 			`spend in IVM (processing query hydration and advancement) before yielding`,
@@ -561,7 +561,7 @@ var zeroOptions = {
 		]
 	},
 	viewSyncerHydrationBudgetMs: {
-		type: valita_exports.number().assert((value) => Number.isSafeInteger(value) && value >= 0, "must be a nonnegative integer").default(0),
+		type: valita_exports.number().assert((value) => Number.isSafeInteger(value) && value >= 0, "must be a nonnegative integer").optional(() => 0),
 		desc: [
 			`The soft time budget in milliseconds for hydrating inactive queries`,
 			`during a view-syncer hydration pass. Active and internal queries always`,
@@ -573,7 +573,7 @@ var zeroOptions = {
 		]
 	},
 	viewSyncerQueryHydrationTimeoutMs: {
-		type: valita_exports.number().assert((value) => Number.isSafeInteger(value) && value >= 0, "must be a nonnegative integer").default(0),
+		type: valita_exports.number().assert((value) => Number.isSafeInteger(value) && value >= 0, "must be a nonnegative integer").optional(() => 0),
 		desc: [
 			`The maximum processing time in milliseconds that a view-syncer spends`,
 			`hydrating a single client query. Time spent yielding to other work is`,
@@ -595,12 +595,12 @@ var zeroOptions = {
 		},
 		/** @deprecated */
 		maxConns: {
-			type: valita_exports.number().default(5),
+			type: valita_exports.number().optional(() => 5),
 			deprecated: [`Connections to the change db are created dynamically for subscriber catchup. Ensure`, `that the database supports sufficient connections for at least 5 + numViewSyncers.`],
 			hidden: true
 		},
 		statementTimeoutMs: {
-			type: valita_exports.number().default(3e4),
+			type: valita_exports.number().optional(() => 3e4),
 			desc: [
 				`Fail change-log db operations that make no progress within the specified timeout. This`,
 				`differs from a postgres {bold statement_timeout} in that it is implemented to handle a`,
@@ -610,7 +610,7 @@ var zeroOptions = {
 			hidden: true
 		},
 		logBatchSize: {
-			type: valita_exports.number().assert((n) => Number.isInteger(n) && n >= 1, `change.logBatchSize must be an integer >= 1`).default(2e3),
+			type: valita_exports.number().assert((n) => Number.isInteger(n) && n >= 1, `change.logBatchSize must be an integer >= 1`).optional(() => 2e3),
 			desc: [
 				`The maximum number of change-log rows written per multi-row INSERT to the change`,
 				`database. Larger upstream transactions are persisted in batches of this size rather`,
@@ -628,7 +628,7 @@ var zeroOptions = {
 	shard: shardOptions,
 	auth: authOptions,
 	port: {
-		type: valita_exports.number().default(4848),
+		type: valita_exports.number().optional(() => 4848),
 		desc: [`The port for sync connections.`]
 	},
 	keepaliveTimeoutMs: {
@@ -662,7 +662,7 @@ var zeroOptions = {
 			]
 		},
 		mode: {
-			type: literalUnion("dedicated", "discover").default("dedicated"),
+			type: literalUnion("dedicated", "discover").optional(() => "dedicated"),
 			desc: [
 				`As an alternative to {bold ZERO_CHANGE_STREAMER_URI}, the {bold ZERO_CHANGE_STREAMER_MODE}`,
 				`can be set to "{bold discover}" to instruct the {bold view-syncer} to connect to the `,
@@ -693,12 +693,12 @@ var zeroOptions = {
 		},
 		/** @deprecated */
 		protocol: {
-			type: literalUnion("ws", "wss").default("ws"),
+			type: literalUnion("ws", "wss").optional(() => "ws"),
 			deprecated: [`Set the {bold ZERO_CHANGE_STREAMER_URI} on view-syncers instead.`],
 			hidden: true
 		},
 		discoveryInterfacePreferences: {
-			type: valita_exports.array(valita_exports.string()).default([...DEFAULT_PREFERRED_PREFIXES]),
+			type: valita_exports.array(valita_exports.string()).optional(() => [...DEFAULT_PREFERRED_PREFIXES]),
 			desc: [
 				`The name prefixes to prefer when introspecting the network interfaces to determine`,
 				`the externally reachable IP address for change-streamer discovery. This defaults`,
@@ -708,7 +708,7 @@ var zeroOptions = {
 			hidden: true
 		},
 		startupDelayMs: {
-			type: valita_exports.number().default(15e3),
+			type: valita_exports.number().optional(() => 15e3),
 			desc: [
 				`The delay to wait before the change-streamer takes over the replication stream`,
 				`(i.e. the handoff during replication-manager updates), to allow loadbalancers to register`,
@@ -718,12 +718,12 @@ var zeroOptions = {
 			]
 		},
 		sqliteChangeLogMode: {
-			type: literalUnion("off", "write", "compare", "serve").default("off"),
+			type: literalUnion("off", "write", "compare", "serve").optional(() => "off"),
 			desc: [`Controls the staged SQLite change-log rollout. Modes are cumulative:`, `{bold off}, {bold write}, {bold compare}, and {bold serve}.`],
 			hidden: true
 		},
 		pgChangeLogEnabled: {
-			type: valita_exports.boolean().default(true),
+			type: valita_exports.boolean().optional(() => true),
 			desc: [
 				`Whether the legacy Postgres change log remains authoritative for`,
 				`stream initialization, persistence, catchup, and upstream ACKs.`,
@@ -732,12 +732,12 @@ var zeroOptions = {
 			hidden: true
 		},
 		sqliteChangeLogReadPercent: {
-			type: valita_exports.number().default(0),
+			type: valita_exports.number().optional(() => 0),
 			desc: [`The stable percentage of eligible catchup subscriptions served from SQLite.`],
 			hidden: true
 		},
 		sqliteChangeLogColdReadPercent: {
-			type: valita_exports.number().default(0),
+			type: valita_exports.number().optional(() => 0),
 			desc: [
 				`The stable percentage of eligible catchup subscriptions served from a`,
 				`SQLite change log that is younger than its retention window, i.e. one`,
@@ -749,27 +749,27 @@ var zeroOptions = {
 			hidden: true
 		},
 		sqliteChangeLogComparePercent: {
-			type: valita_exports.number().default(1),
+			type: valita_exports.number().optional(() => 1),
 			desc: [`The stable percentage of committed transactions whose catchup output is`, `compared between the Postgres and SQLite change logs in {bold compare} mode.`],
 			hidden: true
 		},
 		sqliteChangeLogRetentionMs: {
-			type: valita_exports.number().default(6e4),
+			type: valita_exports.number().optional(() => 6e4),
 			desc: [`The minimum time window retained in the SQLite change log.`],
 			hidden: true
 		},
 		sqliteChangeLogReadBatchRows: {
-			type: valita_exports.number().default(1e3),
+			type: valita_exports.number().optional(() => 1e3),
 			desc: [`The target number of rows in each SQLite catchup read batch.`],
 			hidden: true
 		},
 		sqliteChangeLogPurgeBatchRows: {
-			type: valita_exports.number().default(1e3),
+			type: valita_exports.number().optional(() => 1e3),
 			desc: [`The target number of rows in each SQLite purge batch.`],
 			hidden: true
 		},
 		sqliteChangeLogBarrierTimeoutMs: {
-			type: valita_exports.number().default(3e5),
+			type: valita_exports.number().optional(() => 3e5),
 			desc: [
 				`The maximum wait for the SQLite required-head barrier. This is a`,
 				`backstop for a wedged replica on an idle shard, where waiting costs`,
@@ -781,7 +781,7 @@ var zeroOptions = {
 			hidden: true
 		},
 		backPressureLimitHeapProportion: {
-			type: valita_exports.number().default(.04),
+			type: valita_exports.number().optional(() => .04),
 			desc: [
 				`The percentage of {bold --max-old-space-size} to use as a buffer for absorbing replication`,
 				`stream spikes. When the estimated amount of queued data exceeds this threshold, back pressure`,
@@ -804,7 +804,7 @@ var zeroOptions = {
 			]
 		},
 		flowControlConsensusTimeoutProportion: {
-			type: valita_exports.number().default(4),
+			type: valita_exports.number().optional(() => 4),
 			desc: [
 				`During periodic flow control checks (every 64kb), the amount of time to wait after the majority`,
 				`of subscribers have acked, proportional to that interval, after which replication will continue`,
@@ -831,7 +831,7 @@ var zeroOptions = {
 			]
 		},
 		flowControlSlowSubscriberGracePeriodSeconds: {
-			type: valita_exports.number().default(30),
+			type: valita_exports.number().optional(() => 30),
 			desc: [
 				`The period of time after which a lagging subscriber is disconnected and instructed to`,
 				`restart. A subscriber is considered lagging if it {italic continuously} (1) exceeds the`,
@@ -878,7 +878,7 @@ var zeroOptions = {
 		]
 	},
 	autoReset: {
-		type: valita_exports.boolean().default(true),
+		type: valita_exports.boolean().optional(() => true),
 		desc: [
 			`Automatically wipe and resync the replica when replication is halted.`,
 			`This situation can occur for configurations in which the upstream database`,
@@ -895,7 +895,7 @@ var zeroOptions = {
 	},
 	replicationLag: {
 		reportIntervalMs: {
-			type: valita_exports.number().default(1e4),
+			type: valita_exports.number().optional(() => 1e4),
 			desc: [
 				`The approximate interval at which replication lag reports are written upstream and`,
 				`reported via the {bold zero.replication.total_lag} opentelemetry metric. If`,
@@ -916,7 +916,7 @@ var zeroOptions = {
 			]
 		},
 		initialReadinessThresholdMs: {
-			type: valita_exports.number().default(1e3),
+			type: valita_exports.number().optional(() => 1e3),
 			desc: [
 				`The maximum replication lag in milliseconds that a server is allowed to have`,
 				`before it advertises readiness (to serve traffic). This prevents the server`,
@@ -930,7 +930,7 @@ var zeroOptions = {
 			]
 		},
 		maxReadinessDelayMs: {
-			type: valita_exports.number().default(6e5),
+			type: valita_exports.number().optional(() => 6e5),
 			desc: [
 				`The maximum time in milliseconds that a server will wait for replication lag`,
 				`to fall below the {bold ZERO_REPLICATION_LAG_INITIAL_READINESS_THRESHOLD_MS}`,
@@ -975,7 +975,7 @@ var zeroOptions = {
 		]
 	},
 	websocketCompression: {
-		type: valita_exports.boolean().default(false),
+		type: valita_exports.boolean().optional(() => false),
 		desc: [
 			"Enable WebSocket per-message deflate compression.",
 			"",
@@ -998,7 +998,7 @@ var zeroOptions = {
 		]
 	},
 	websocketMaxPayloadBytes: {
-		type: valita_exports.number().default(10 * 1024 * 1024),
+		type: valita_exports.number().optional(() => 10 * 1024 * 1024),
 		desc: [
 			"Maximum size of incoming WebSocket messages in bytes.",
 			"",
@@ -1026,7 +1026,7 @@ var zeroOptions = {
 			]
 		},
 		restoreUsingV5: {
-			type: valita_exports.boolean().default(true),
+			type: valita_exports.boolean().optional(() => true),
 			desc: [
 				`Restores the backup using the {bold ZERO_LITESTREAM_EXECUTABLE_V5} if specified.`,
 				`This provides a recovery path if rolling back from {bold ZERO_LITESTREAM_BACKUP_USING_V5}`,
@@ -1034,7 +1034,7 @@ var zeroOptions = {
 			]
 		},
 		backupUsingV5: {
-			type: valita_exports.boolean().default(true),
+			type: valita_exports.boolean().optional(() => true),
 			desc: [
 				`Backs up the replica using Litestream v0.5.x. This is required for (upcoming)`,
 				`high-availability replication. Set to false to revert to Litestream v0.3.x backups.`,
@@ -1055,7 +1055,7 @@ var zeroOptions = {
 			]
 		},
 		forkBackup: {
-			type: valita_exports.boolean().default(true),
+			type: valita_exports.boolean().optional(() => true),
 			hidden: true,
 			desc: [
 				`When a replication-manager restores from another replication-manager's`,
@@ -1069,7 +1069,7 @@ var zeroOptions = {
 			]
 		},
 		configPath: {
-			type: valita_exports.string().default("./src/services/litestream/config.yml"),
+			type: valita_exports.string().optional(() => "./src/services/litestream/config.yml"),
 			desc: [
 				`Path to the litestream yaml config file. zero-cache will run this with its`,
 				`environment variables, which can be referenced in the file via $\\{ENV\\}`,
@@ -1081,7 +1081,7 @@ var zeroOptions = {
 			]
 		},
 		configPathV5: {
-			type: valita_exports.string().default("./src/services/litestream/config-v5.yml"),
+			type: valita_exports.string().optional(() => "./src/services/litestream/config-v5.yml"),
 			desc: [
 				`Path to the litestream v5 yaml config file. zero-cache will run this with its`,
 				`environment variables, which can be referenced in the file via $\\{ENV\\}`,
@@ -1092,7 +1092,7 @@ var zeroOptions = {
 				`* {bold ZERO_LOG_FORMAT} for the log type`
 			]
 		},
-		logLevel: { type: literalUnion("debug", "info", "warn", "error").default("warn") },
+		logLevel: { type: literalUnion("debug", "info", "warn", "error").optional(() => "warn") },
 		backupURL: {
 			type: valita_exports.string().optional(),
 			desc: [
@@ -1128,7 +1128,7 @@ var zeroOptions = {
 			]
 		},
 		checkpointThresholdMB: {
-			type: valita_exports.number().default(40),
+			type: valita_exports.number().optional(() => 40),
 			desc: [
 				`The size of the WAL file at which litestream performs background, best-effort (PASSIVE)`,
 				`SQLite checkpoints to apply the writes in the WAL to the main database file. Checkpoints`,
@@ -1155,7 +1155,7 @@ var zeroOptions = {
 			]
 		},
 		forceCheckpointThresholdMB: {
-			type: valita_exports.number().default(256),
+			type: valita_exports.number().optional(() => 256),
 			desc: [
 				`The size of the WAL file at which to pause writes and explicitly initiate a`,
 				`local litestream sync. This is a safeguard for the situation in which litestream's`,
@@ -1177,7 +1177,7 @@ var zeroOptions = {
 			]
 		},
 		maxWalSizeMB: {
-			type: valita_exports.number().default(10240),
+			type: valita_exports.number().optional(() => 10240),
 			desc: [
 				`A fail-safe that pauses writes once the un-checkpointed WAL reaches this size,`,
 				`resuming when litestream manages to checkpoint it. This bounds WAL growth (and`,
@@ -1194,7 +1194,7 @@ var zeroOptions = {
 			]
 		},
 		incrementalBackupIntervalMinutes: {
-			type: valita_exports.number().default(15),
+			type: valita_exports.number().optional(() => 15),
 			desc: [
 				`The interval between incremental v3 backups of the replica. Shorter intervals`,
 				`reduce the amount of change history that needs to be replayed when catching`,
@@ -1207,7 +1207,7 @@ var zeroOptions = {
 			]
 		},
 		snapshotBackupIntervalHours: {
-			type: valita_exports.number().default(12),
+			type: valita_exports.number().optional(() => 12),
 			desc: [
 				`The interval between snapshot backups of the replica. Applies to both`,
 				`litestream v3 and v5 backups.`,
@@ -1225,7 +1225,7 @@ var zeroOptions = {
 			]
 		},
 		incrementalBackupIntervalSeconds: {
-			type: valita_exports.number().default(15),
+			type: valita_exports.number().optional(() => 15),
 			desc: [
 				`The interval between incremental v5 backups of the replica. With litestream v5`,
 				`the upstream change source is not ACKed until the corresponding changes have been`,
@@ -1240,15 +1240,20 @@ var zeroOptions = {
 			]
 		},
 		restoreParallelism: {
-			type: valita_exports.number().default(48),
+			type: valita_exports.number().optional(() => 48),
 			desc: [`The number of WAL files to download in parallel when performing the`, `initial restore of the replica from the backup.`]
 		},
 		multipartConcurrency: {
-			type: valita_exports.number().default(48),
-			desc: [`The number of parts (of size {bold --litestream-multipart-size} bytes)`, `to upload or download in parallel when backing up or restoring the snapshot.`]
+			type: valita_exports.number().optional(),
+			desc: [
+				`The number of parts (of size {bold --litestream-multipart-size} bytes)`,
+				`to upload or download in parallel when backing up or restoring the snapshot.`,
+				`Leave this unset to use 48, reduced as needed to keep the parts within`,
+				`a quarter of the memory available to the container.`
+			]
 		},
 		multipartSize: {
-			type: valita_exports.number().default(16 * 1024 * 1024),
+			type: valita_exports.number().optional(() => 16 * 1024 * 1024),
 			desc: [
 				`The size of each part when uploading or downloading the snapshot with`,
 				`{bold --multipart-concurrency}. Note that up to {bold concurrency * size}`,
@@ -1262,7 +1267,7 @@ var zeroOptions = {
 	},
 	initialSync: {
 		tableCopyWorkers: {
-			type: valita_exports.number().default(5),
+			type: valita_exports.number().optional(() => 5),
 			desc: [
 				`The number of parallel workers used to copy tables during initial sync.`,
 				`Each worker uses a database connection and will buffer up to (approximately)`,
@@ -1277,7 +1282,7 @@ var zeroOptions = {
 			desc: [`Takes a cpu profile during the copy phase initial-sync, storing it as a JSON file`, `initial-copy.cpuprofile in the tmp directory.`]
 		},
 		textCopy: {
-			type: valita_exports.boolean().default(false),
+			type: valita_exports.boolean().optional(() => false),
 			desc: [
 				`Use text-format COPY instead of binary COPY for initial sync and`,
 				`backfill streaming. This is slower but can work around issues with`,
@@ -1287,7 +1292,7 @@ var zeroOptions = {
 	},
 	shadowSync: {
 		enabled: {
-			type: valita_exports.boolean().default(false),
+			type: valita_exports.boolean().optional(() => false),
 			desc: [
 				`Periodically exercises the initial-sync code path against a sample of`,
 				`rows from every published table, writing to a throwaway SQLite database.`,
@@ -1297,7 +1302,7 @@ var zeroOptions = {
 			]
 		},
 		intervalHours: {
-			type: valita_exports.number().default(12),
+			type: valita_exports.number().optional(() => 12),
 			desc: [
 				`The interval between shadow initial-sync runs, in hours. The first`,
 				`run fires within [2/3, 1) of this interval after startup, so the`,
@@ -1307,7 +1312,7 @@ var zeroOptions = {
 			]
 		},
 		sampleRate: {
-			type: valita_exports.number().default(.1),
+			type: valita_exports.number().optional(() => .1),
 			desc: [
 				`The BERNOULLI sampling rate for each table (0 < rate <= 1). A value of`,
 				`1 disables sampling and copies all rows (still subject to`,
@@ -1315,13 +1320,13 @@ var zeroOptions = {
 			]
 		},
 		maxRowsPerTable: {
-			type: valita_exports.number().default(1e4),
+			type: valita_exports.number().optional(() => 1e4),
 			desc: [`The hard upper bound on rows copied per table per shadow run. Guards`, `against unexpectedly large tables consuming disk / upstream bandwidth.`]
 		}
 	},
 	/** @deprecated */
 	targetClientRowCount: {
-		type: valita_exports.number().default(2e4),
+		type: valita_exports.number().optional(() => 2e4),
 		deprecated: [
 			"This option is no longer used and will be removed in a future version.",
 			"The client-side cache no longer enforces a row limit. Instead, TTL-based expiration",
@@ -1330,7 +1335,7 @@ var zeroOptions = {
 		hidden: true
 	},
 	lazyStartup: {
-		type: valita_exports.boolean().default(false),
+		type: valita_exports.boolean().optional(() => false),
 		desc: [
 			"Delay starting the majority of zero-cache until first request.",
 			"",
@@ -1345,7 +1350,7 @@ var zeroOptions = {
 		desc: [`The version string outputted to logs when the server starts up.`]
 	},
 	enableTelemetry: {
-		type: valita_exports.boolean().default(true),
+		type: valita_exports.boolean().optional(() => true),
 		desc: [
 			`Set to false to opt out of telemetry collection.`,
 			``,