@classytic/repo-core 0.6.0 → 0.6.1

package/CHANGELOG.md

@@ -4,6 +4,24 @@ All notable changes to `@classytic/repo-core` are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.6.1] - 2026-07-04
+
+### Changed — `TenantConfig` optionals widened to `T | undefined` (P10)
+
+Every optional prop on `TenantConfig` (`strategy`, `enabled`, `tenantField`,
+`fieldType`, `ref`, `contextKey`, `required`, `resolve`) is now typed
+`T | undefined`, so downstream packages compiling with
+`exactOptionalPropertyTypes: true` can extend it without redeclaring props
+(unblocks `@classytic/ledger`'s `MultiTenantConfig.required` exception).
+
+`resolveTenantConfig` strips explicit-`undefined` keys before spreading
+over `DEFAULT_TENANT_CONFIG`, so `{ required: maybeUndefined }` can never
+clobber a default with `undefined` — previously the un-widened type made
+that unrepresentable; now it's handled at runtime and pinned by tests.
+`DEFAULT_TENANT_CONFIG`'s annotation moved from `Required<Pick<...>>` to an
+`Exclude<..., undefined>` mapping (`-?` does not strip an explicit
+undefined union member). No runtime behavior change for existing callers.
+
 ## [0.6.0] - 2026-06-11
 
 Standardization release. Coordinated with mongokit 3.16 + sqlitekit 0.6.

package/dist/tenant/resolve.d.mts

@@ -10,18 +10,8 @@ import { ResolvedTenantConfig, TenantConfig } from "./types.mjs";
  * runtime default — `Pick<TenantConfig, 'fieldType'>` extension preserves
  * type-level alignment without forcing a runtime default change.
  */
-declare const DEFAULT_TENANT_CONFIG: Required<Pick<TenantConfig, 'strategy' | 'enabled' | 'tenantField' | 'fieldType' | 'ref' | 'contextKey' | 'required'>>;
-/**
- * Resolve a possibly-partial {@link TenantConfig} against the defaults.
- *
- * - `false` → `enabled: false`, `strategy: 'none'`, `required: false`.
- * - `true` / `undefined` → default field strategy.
- * - Object with `strategy: 'custom'` → `resolve` is required; throws
- *   otherwise so the misconfiguration surfaces at boot, not runtime.
- * - Object with `strategy: 'none'` → `enabled: false` (preserves
- *   user-supplied `tenantField` / `fieldType` / `ref` so the doc field
- *   stays correctly typed even with scoping off).
- */
+type TenantDefaults = { [K in 'strategy' | 'enabled' | 'tenantField' | 'fieldType' | 'ref' | 'contextKey' | 'required']-?: Exclude<TenantConfig[K], undefined> };
+declare const DEFAULT_TENANT_CONFIG: TenantDefaults;
 declare function resolveTenantConfig(config?: TenantConfig | boolean): ResolvedTenantConfig;
 //#endregion
 export { DEFAULT_TENANT_CONFIG, resolveTenantConfig };

package/dist/tenant/resolve.mjs

@@ -1,13 +1,4 @@
 //#region src/tenant/resolve.ts
-/**
-* Sensible defaults for a freshly-built package (field strategy).
-*
-* `fieldType: 'objectId'` is the recommended default for new Mongo-shaped
-* kits because it enables `$lookup` / `.populate()`. Existing kits that
-* historically defaulted to `'string'` (mongokit pre-3.x) keep their own
-* runtime default — `Pick<TenantConfig, 'fieldType'>` extension preserves
-* type-level alignment without forcing a runtime default change.
-*/
 const DEFAULT_TENANT_CONFIG = {
 	strategy: "field",
 	enabled: true,
@@ -17,17 +8,11 @@ const DEFAULT_TENANT_CONFIG = {
 	contextKey: "organizationId",
 	required: true
 };
-/**
-* Resolve a possibly-partial {@link TenantConfig} against the defaults.
-*
-* - `false` → `enabled: false`, `strategy: 'none'`, `required: false`.
-* - `true` / `undefined` → default field strategy.
-* - Object with `strategy: 'custom'` → `resolve` is required; throws
-*   otherwise so the misconfiguration surfaces at boot, not runtime.
-* - Object with `strategy: 'none'` → `enabled: false` (preserves
-*   user-supplied `tenantField` / `fieldType` / `ref` so the doc field
-*   stays correctly typed even with scoping off).
-*/
+function stripUndefined(obj) {
+	const out = {};
+	for (const [k, v] of Object.entries(obj)) if (v !== void 0) out[k] = v;
+	return out;
+}
 function resolveTenantConfig(config) {
 	if (config === false) return {
 		...DEFAULT_TENANT_CONFIG,
@@ -36,33 +21,34 @@ function resolveTenantConfig(config) {
 		required: false
 	};
 	if (config === true || config === void 0) return { ...DEFAULT_TENANT_CONFIG };
-	const strategy = config.strategy ?? (config.enabled === false ? "none" : "field");
-	const contextKey = config.contextKey ?? config.tenantField ?? DEFAULT_TENANT_CONFIG.contextKey;
+	const cleaned = stripUndefined(config);
+	const strategy = cleaned.strategy ?? (cleaned.enabled === false ? "none" : "field");
+	const contextKey = cleaned.contextKey ?? cleaned.tenantField ?? DEFAULT_TENANT_CONFIG.contextKey;
 	if (strategy === "none") return {
 		...DEFAULT_TENANT_CONFIG,
-		...config,
+		...cleaned,
 		contextKey,
 		strategy: "none",
 		enabled: false,
 		required: false
 	};
 	if (strategy === "custom") {
-		if (typeof config.resolve !== "function") throw new Error("[repo-core] TenantConfig.strategy 'custom' requires a 'resolve' function");
+		if (typeof cleaned.resolve !== "function") throw new Error("[repo-core] TenantConfig.strategy 'custom' requires a 'resolve' function");
 		return {
 			...DEFAULT_TENANT_CONFIG,
-			...config,
+			...cleaned,
 			contextKey,
 			strategy: "custom",
-			enabled: config.enabled ?? true,
-			resolve: config.resolve
+			enabled: cleaned.enabled ?? true,
+			resolve: cleaned.resolve
 		};
 	}
 	return {
 		...DEFAULT_TENANT_CONFIG,
-		...config,
+		...cleaned,
 		contextKey,
 		strategy: "field",
-		enabled: config.enabled ?? true
+		enabled: cleaned.enabled ?? true
 	};
 }
 //#endregion

package/dist/tenant/types.d.mts

@@ -50,7 +50,7 @@ interface TenantConfig {
    *
    * @default 'field'
    */
-  strategy?: TenantStrategy;
+  strategy?: TenantStrategy | undefined;
   /**
    * Whether tenant scoping is active. When `false`, the package runs in
    * single-tenant mode — no filter injection, no tenant field on documents.
@@ -58,27 +58,27 @@ interface TenantConfig {
    *
    * @default true
    */
-  enabled?: boolean;
+  enabled?: boolean | undefined;
   /**
    * Document / column field name that stores the tenant id. Used when
    * `strategy === 'field'`.
    *
    * @default 'organizationId'
    */
-  tenantField?: string;
+  tenantField?: string | undefined;
   /**
    * How to store / cast the tenant id.
    *
    * @default 'objectId'
    */
-  fieldType?: TenantFieldType;
+  fieldType?: TenantFieldType | undefined;
   /**
    * Mongoose ref for `'objectId'` types. Ignored by SQL kits and when
    * `fieldType === 'string'`.
    *
    * @default 'organization'
    */
-  ref?: string;
+  ref?: string | undefined;
   /**
    * Which key on the repository context to read the tenant id from.
    *
@@ -92,14 +92,14 @@ interface TenantConfig {
    *
    * @default tenantField ?? 'organizationId'
    */
-  contextKey?: string;
+  contextKey?: string | undefined;
   /**
    * Whether the field is required. When `false`, the package permits
    * unscoped / cross-tenant reads (typically only for admin paths).
    *
    * @default true
    */
-  required?: boolean;
+  required?: boolean | undefined;
   /**
    * Custom resolver — called when `strategy === 'custom'` to produce the
    * filter object injected into queries. Packages pass the request /
@@ -121,7 +121,7 @@ interface TenantConfig {
    * }
    * ```
    */
-  resolve?: (ctx: Record<string, unknown>) => Record<string, unknown>;
+  resolve?: (ctx: Record<string, unknown>) => Record<string, unknown> | undefined;
 }
 /**
  * Resolved shape returned by `resolveTenantConfig`. Always includes the
@@ -136,7 +136,7 @@ type ResolvedTenantConfig = {
   ref: string;
   contextKey: string;
   required: boolean;
-  resolve?: TenantConfig['resolve'];
+  resolve?: TenantConfig['resolve'] | undefined;
 };
 //#endregion
 export { ResolvedTenantConfig, TenantConfig, TenantFieldType, TenantStrategy };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/repo-core",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Driver-agnostic repository primitives: hooks, Filter IR, operations, pagination, cache contract. Foundation for mongokit, sqlitekit, pgkit, and prismakit. Lean by design — no plugins ship here; each kit owns its own.",
   "type": "module",
   "sideEffects": false,