@wildo-ai/saas-models 1.1.3 → 1.1.5

package/dist/esm/resources/utils/initiator-stamped-field-satisfiability.validation.js

@@ -0,0 +1,80 @@
+import { getObjectShape, getZodDefArrayProperty, isDiscriminatedUnion, isOptional, isZodTypeAny, } from '@wildo-ai/zod-decorators';
+/**
+ * Registry-level guard: a field the ENGINE stamps from the initiator's USER must not be REQUIRED.
+ *
+ * ## The shape (#584)
+ *
+ * `createdByUserId` is stripped from the CREATE DTO by name — a client may never author it — and is
+ * stamped by the repository from `executionContext.initiatorIds.userId`, guarded by `if (userId)` in
+ * both adapters (`addUserTracking`, and the PostgreSQL adapter's own copy). `updatedByUserId` /
+ * `lastUpdatedByUserId` are stamped the same way on UPDATE.
+ *
+ * **A machine principal has no `userId`.** An org or application service acting over MCP, A2A,
+ * client credentials, a worker or a batch supplies none, so a REQUIRED one of these fields is
+ * satisfied by nobody: not the client (stripped), not the repository (the guard skips). Nothing said
+ * so at registration or at exposure, and the write failed — or committed and then failed to describe
+ * itself — the first time a machine caller reached the resource. That is how `todos` and `todoLists`
+ * were found (#577), each only after being exposed.
+ *
+ * ## A refusal at boot, and why it was a report first
+ *
+ * The backend refuses to start when this returns anything — the engine's own measurement is that a
+ * declaration gets made if and only if the framework refuses to start without it.
+ *
+ * It shipped as a startup REPORT on the belief that flipping the existing declarations to optional
+ * changes PostgreSQL column nullability and so owes a migration in every surface. It does not: the
+ * schema planner's contract (version 3) records `sqlType`, `hasIndex`, `isPrimaryKey`, `unique` and
+ * `defaultClause` per column and no nullability, so a required-vs-optional change is enforced by the
+ * Zod layer alone and leaves every lockfile in sync. Measured on all three PostgreSQL surfaces
+ * before the promotion, with the existing declarations flipped in the same change.
+ *
+ * ## Scope
+ *
+ * - Only the user-stamped identifiers. The primary-scope foreign keys (`organizationId`, …) are also
+ *   context-populated, but from the SCOPE, which a machine principal does carry — they are required on
+ *   purpose.
+ * - System resources are skipped: the framework owns their write paths and supplies or refuses the
+ *   attribution explicitly (the SCIM token mint refuses a principal with no user).
+ * - Discriminated-union (polymorphic) schemas are checked on every variant that declares the field.
+ */
+export const INITIATOR_USER_STAMPED_FIELD_IDENTIFIERS = ['createdByUserId', 'updatedByUserId', 'lastUpdatedByUserId'];
+/** Every object shape a main schema can present: itself, or each discriminated-union variant. */
+function objectShapesOf(mainSchema) {
+    const direct = getObjectShape(mainSchema);
+    if (direct)
+        return [direct];
+    if (!isDiscriminatedUnion(mainSchema))
+        return [];
+    return (getZodDefArrayProperty(mainSchema, 'options') ?? [])
+        .filter(isZodTypeAny)
+        .map((option) => getObjectShape(option))
+        .filter((shape) => !!shape);
+}
+/**
+ * Report every non-system resource that declares an initiator-user-stamped field as REQUIRED.
+ * `isOptional` treats `.optional()`, `.default()` and `.nullish()` as optional; a bare `.nullable()`
+ * stays required, which is correct — `null` is not what the stamp's absence produces.
+ */
+export function validateInitiatorStampedFieldSatisfiability(resourceConfigurations) {
+    const violations = [];
+    for (const configuration of Object.values(resourceConfigurations)) {
+        if (!configuration?.mainSchema || configuration.isSystemResource)
+            continue;
+        const shapes = objectShapesOf(configuration.mainSchema);
+        for (const field of INITIATOR_USER_STAMPED_FIELD_IDENTIFIERS) {
+            const requiredSomewhere = shapes.some((shape) => shape[field] && !isOptional(shape[field]));
+            if (!requiredSomewhere)
+                continue;
+            violations.push({
+                resourceType: configuration.resourceIdentifier,
+                field,
+                message: `[${String(configuration.resourceIdentifier)}] declares '${field}' as REQUIRED, but the engine stamps it only when`
+                    + ' the initiator has a userId. A machine principal (MCP, A2A, client credentials, a worker, a batch) has none,'
+                    + ' and a client may never send it, so a machine write to this resource cannot be satisfied.'
+                    + ` Declare it \`.optional()\` — and generate the migration its nullability change owes.`,
+            });
+        }
+    }
+    return violations;
+}
+//# sourceMappingURL=initiator-stamped-field-satisfiability.validation.js.map

package/dist/esm/resources/utils/initiator-stamped-field-satisfiability.validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initiator-stamped-field-satisfiability.validation.js","sourceRoot":"","sources":["../../../../../src/resources/utils/initiator-stamped-field-satisfiability.validation.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,UAAU,EACV,YAAY,GACb,MAAM,0BAA0B,CAAC;AAGlC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,CAAC,MAAM,wCAAwC,GAAG,CAAC,iBAAiB,EAAE,iBAAiB,EAAE,qBAAqB,CAAU,CAAC;AAiB/H,iGAAiG;AACjG,SAAS,cAAc,CAAC,UAAwB;IAC9C,MAAM,MAAM,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,MAAM;QAAE,OAAO,CAAC,MAAsC,CAAC,CAAC;IAC5D,IAAI,CAAC,oBAAoB,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,CAAC;IACjD,OAAO,CAAC,sBAAsB,CAAC,UAAU,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC;SACzD,MAAM,CAAC,YAAY,CAAC;SACpB,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;SACvC,MAAM,CAAC,CAAC,KAAK,EAAyC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AACvE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2CAA2C,CACzD,sBAAoF;IAEpF,MAAM,UAAU,GAAqC,EAAE,CAAC;IACxD,KAAK,MAAM,aAAa,IAAI,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,EAAE,CAAC;QAClE,IAAI,CAAC,aAAa,EAAE,UAAU,IAAI,aAAa,CAAC,gBAAgB;YAAE,SAAS;QAC3E,MAAM,MAAM,GAAG,cAAc,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QACxD,KAAK,MAAM,KAAK,IAAI,wCAAwC,EAAE,CAAC;YAC7D,MAAM,iBAAiB,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC5F,IAAI,CAAC,iBAAiB;gBAAE,SAAS;YACjC,UAAU,CAAC,IAAI,CAAC;gBACd,YAAY,EAAE,aAAa,CAAC,kBAAkB;gBAC9C,KAAK;gBACL,OAAO,EACL,IAAI,MAAM,CAAC,aAAa,CAAC,kBAAkB,CAAC,eAAe,KAAK,mDAAmD;sBACjH,8GAA8G;sBAC9G,2FAA2F;sBAC3F,uFAAuF;aAC5F,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC","sourcesContent":["import { z } from 'zod';\nimport {\n  getObjectShape,\n  getZodDefArrayProperty,\n  isDiscriminatedUnion,\n  isOptional,\n  isZodTypeAny,\n} from '@wildo-ai/zod-decorators';\nimport type { ResourceType } from '../resources.shared.core.definitions';\n\n/**\n * Registry-level guard: a field the ENGINE stamps from the initiator's USER must not be REQUIRED.\n *\n * ## The shape (#584)\n *\n * `createdByUserId` is stripped from the CREATE DTO by name — a client may never author it — and is\n * stamped by the repository from `executionContext.initiatorIds.userId`, guarded by `if (userId)` in\n * both adapters (`addUserTracking`, and the PostgreSQL adapter's own copy). `updatedByUserId` /\n * `lastUpdatedByUserId` are stamped the same way on UPDATE.\n *\n * **A machine principal has no `userId`.** An org or application service acting over MCP, A2A,\n * client credentials, a worker or a batch supplies none, so a REQUIRED one of these fields is\n * satisfied by nobody: not the client (stripped), not the repository (the guard skips). Nothing said\n * so at registration or at exposure, and the write failed — or committed and then failed to describe\n * itself — the first time a machine caller reached the resource. That is how `todos` and `todoLists`\n * were found (#577), each only after being exposed.\n *\n * ## A refusal at boot, and why it was a report first\n *\n * The backend refuses to start when this returns anything — the engine's own measurement is that a\n * declaration gets made if and only if the framework refuses to start without it.\n *\n * It shipped as a startup REPORT on the belief that flipping the existing declarations to optional\n * changes PostgreSQL column nullability and so owes a migration in every surface. It does not: the\n * schema planner's contract (version 3) records `sqlType`, `hasIndex`, `isPrimaryKey`, `unique` and\n * `defaultClause` per column and no nullability, so a required-vs-optional change is enforced by the\n * Zod layer alone and leaves every lockfile in sync. Measured on all three PostgreSQL surfaces\n * before the promotion, with the existing declarations flipped in the same change.\n *\n * ## Scope\n *\n * - Only the user-stamped identifiers. The primary-scope foreign keys (`organizationId`, …) are also\n *   context-populated, but from the SCOPE, which a machine principal does carry — they are required on\n *   purpose.\n * - System resources are skipped: the framework owns their write paths and supplies or refuses the\n *   attribution explicitly (the SCIM token mint refuses a principal with no user).\n * - Discriminated-union (polymorphic) schemas are checked on every variant that declares the field.\n */\nexport const INITIATOR_USER_STAMPED_FIELD_IDENTIFIERS = ['createdByUserId', 'updatedByUserId', 'lastUpdatedByUserId'] as const;\n\nexport type InitiatorUserStampedFieldIdentifier = typeof INITIATOR_USER_STAMPED_FIELD_IDENTIFIERS[number];\n\nexport interface InitiatorStampedFieldViolation {\n  readonly resourceType: ResourceType;\n  readonly field: InitiatorUserStampedFieldIdentifier;\n  readonly message: string;\n}\n\n/** Structural subset of a resource configuration this validator needs. */\nexport interface InitiatorStampedFieldResourceInput {\n  readonly resourceIdentifier: ResourceType;\n  readonly mainSchema: z.ZodTypeAny;\n  readonly isSystemResource?: boolean;\n}\n\n/** Every object shape a main schema can present: itself, or each discriminated-union variant. */\nfunction objectShapesOf(mainSchema: z.ZodTypeAny): Record<string, z.ZodTypeAny>[] {\n  const direct = getObjectShape(mainSchema);\n  if (direct) return [direct as Record<string, z.ZodTypeAny>];\n  if (!isDiscriminatedUnion(mainSchema)) return [];\n  return (getZodDefArrayProperty(mainSchema, 'options') ?? [])\n    .filter(isZodTypeAny)\n    .map((option) => getObjectShape(option))\n    .filter((shape): shape is Record<string, z.ZodTypeAny> => !!shape);\n}\n\n/**\n * Report every non-system resource that declares an initiator-user-stamped field as REQUIRED.\n * `isOptional` treats `.optional()`, `.default()` and `.nullish()` as optional; a bare `.nullable()`\n * stays required, which is correct — `null` is not what the stamp's absence produces.\n */\nexport function validateInitiatorStampedFieldSatisfiability(\n  resourceConfigurations: Readonly<Record<string, InitiatorStampedFieldResourceInput>>,\n): InitiatorStampedFieldViolation[] {\n  const violations: InitiatorStampedFieldViolation[] = [];\n  for (const configuration of Object.values(resourceConfigurations)) {\n    if (!configuration?.mainSchema || configuration.isSystemResource) continue;\n    const shapes = objectShapesOf(configuration.mainSchema);\n    for (const field of INITIATOR_USER_STAMPED_FIELD_IDENTIFIERS) {\n      const requiredSomewhere = shapes.some((shape) => shape[field] && !isOptional(shape[field]));\n      if (!requiredSomewhere) continue;\n      violations.push({\n        resourceType: configuration.resourceIdentifier,\n        field,\n        message:\n          `[${String(configuration.resourceIdentifier)}] declares '${field}' as REQUIRED, but the engine stamps it only when`\n          + ' the initiator has a userId. A machine principal (MCP, A2A, client credentials, a worker, a batch) has none,'\n          + ' and a client may never send it, so a machine write to this resource cannot be satisfied.'\n          + ` Declare it \\`.optional()\\` — and generate the migration its nullability change owes.`,\n      });\n    }\n  }\n  return violations;\n}\n"]}

package/dist/esm/resources/utils/populated-file-fields.shared.utils.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+/** The key a populated single-file field carries its metadata under, beside `fileId`. */
+export declare const POPULATED_SINGLE_FILE_KEY: "file";
+/** The key a populated multiple-file field carries its metadata list under, beside `fileIds`. */
+export declare const POPULATED_MULTIPLE_FILES_KEY: "files";
+/**
+ * `FileMetadata` (`@wildo-ai/zod-decorators`) as a Zod schema, at the NETWORK boundary: `uploadedAt`
+ * coerces an ISO string, and the object is loose so a metadata key added later is carried rather
+ * than stripped — this is server-produced data, never a request.
+ */
+export declare const PopulatedFileMetadataSchema: z.ZodTypeAny;
+/**
+ * Rebuild `schema` so every `z_file()` field accepts its populated companion beside the stored
+ * reference. Identity-preserving where nothing beneath changed (a wrapper returns the ORIGINAL
+ * instance, so an enclosing object is not rebuilt and keeps its metadata — the #989 lesson recorded
+ * on `stripTemplatableFileFieldsRecursively`). Applied to READ-side DTOs only, after date coercion.
+ */
+export declare function widenFileFieldsForPopulatedReads(schema: z.ZodTypeAny, activeSchemas?: WeakSet<object>): z.ZodTypeAny;
+export declare function widenFileFieldsForPopulatedReads(schema: undefined, activeSchemas?: WeakSet<object>): undefined;
+export declare function widenFileFieldsForPopulatedReads(schema: z.ZodTypeAny | undefined, activeSchemas?: WeakSet<object>): z.ZodTypeAny | undefined;
+//# sourceMappingURL=populated-file-fields.shared.utils.d.ts.map

package/dist/esm/resources/utils/populated-file-fields.shared.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"populated-file-fields.shared.utils.d.ts","sourceRoot":"","sources":["../../../../../src/resources/utils/populated-file-fields.shared.utils.ts"],"names":[],"mappings":"AAgDA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,yFAAyF;AACzF,eAAO,MAAM,yBAAyB,EAAG,MAAe,CAAC;AACzD,iGAAiG;AACjG,eAAO,MAAM,4BAA4B,EAAG,OAAgB,CAAC;AAE7D;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,EAAE,CAAC,CAAC,UAkB1C,CAAC;AAqBH;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,EAAE,aAAa,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC;AACtH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,SAAS,EAAE,aAAa,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;AAChH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,SAAS,EAAE,aAAa,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,UAAU,GAAG,SAAS,CAAC"}

package/dist/esm/resources/utils/populated-file-fields.shared.utils.js

@@ -0,0 +1,159 @@
+/**
+ * The shape a file field takes on a POPULATED read, and the DTO that describes it (issue #1059).
+ *
+ * A file field is STORED as a reference — `{ fileId, updatedAt }` for one file, `{ fileIds, updatedAt }`
+ * for several. A SUMMARY or CONTEXT read runs file population, which used to REPLACE that reference with
+ * the file's metadata (`toMetadataResponse`: readiness, filename, size, url, …). The operation's DTO still
+ * described the reference, so `transformOutput` refused every context read of a resource whose file
+ * existed: `expected date, received Invalid Date` at `<field>.updatedAt`, a 500, and a degraded body
+ * instead of the record. Measured 2026-09-14 on Wonder Todos.
+ *
+ * Population now keeps the reference and adds the metadata BESIDE it — `file` for one, `files` for
+ * several — and the SUMMARY / CONTEXT DTOs declare that companion. Three candidates were weighed:
+ *
+ * - **Declare the replacement.** The frontend reads a file field as its stored reference (`'fileId' in
+ *   value` / `'fileIds' in value`, then fetches metadata by id itself), so a metadata array in place of
+ *   `{ fileIds }` fails its multiple-file guard outright. Declaring the replacement would have made the
+ *   DTO agree with a shape one consumer cannot read.
+ * - **Populate after `transformOutput`.** Validation would then never see the populated value, and the
+ *   response DTO — the OpenAPI contract — would describe less than the wire carries.
+ * - **Keep the reference (chosen).** Every reader of the reference keeps working, the companion is
+ *   OPTIONAL so a read with population disabled or failed (`populateFileFieldsForSingle` keeps the
+ *   original value on any error) still validates, and a consumer that wants the metadata finds it at a
+ *   named key.
+ *
+ * The companion's schema carries the file field's decorator metadata forward, so the widened field is
+ * still detected as a FILE field (`isFileSchema`, `getSchemaType`) — the same property
+ * `resources-config-operations.dtos-builder.file-metadata-coercion.test.ts` pins for date coercion.
+ */
+import { FileDisplayNature, FileReadiness, FileUploaderEntityType, getFileMetadata, getZodDef, getZodDefArrayProperty, getZodDefProperty, getZodDefSchemaProperty, getZodDefStringProperty, getZodObjectShape, getZodType, isZodArray, isZodDefault, isZodNullable, isZodObject, isZodOptional, SCHEMA_METADATA, withArrayElement, } from '@wildo-ai/zod-decorators';
+import { z } from 'zod';
+/** The key a populated single-file field carries its metadata under, beside `fileId`. */
+export const POPULATED_SINGLE_FILE_KEY = 'file';
+/** The key a populated multiple-file field carries its metadata list under, beside `fileIds`. */
+export const POPULATED_MULTIPLE_FILES_KEY = 'files';
+/**
+ * `FileMetadata` (`@wildo-ai/zod-decorators`) as a Zod schema, at the NETWORK boundary: `uploadedAt`
+ * coerces an ISO string, and the object is loose so a metadata key added later is carried rather
+ * than stripped — this is server-produced data, never a request.
+ */
+export const PopulatedFileMetadataSchema = z.looseObject({
+    readiness: z.enum(FileReadiness),
+    fileId: z.string().min(1),
+    filename: z.string(),
+    size: z.number(),
+    mimeType: z.string(),
+    extension: z.string().optional(),
+    checksum: z.string().optional(),
+    url: z.string().optional(),
+    thumbnailUrl: z.string().optional(),
+    nature: z.enum(FileDisplayNature).optional(),
+    width: z.number().optional(),
+    height: z.number().optional(),
+    duration: z.number().optional(),
+    pageCount: z.number().optional(),
+    uploadedAt: z.coerce.date(),
+    uploadedBy: z.string().optional(),
+    uploadedByEntityType: z.enum(FileUploaderEntityType).optional(),
+});
+function carrySchemaMetadata(source, rebuilt) {
+    const metadata = source[SCHEMA_METADATA];
+    if (metadata !== undefined) {
+        rebuilt[SCHEMA_METADATA] = metadata;
+    }
+    return rebuilt;
+}
+/** A `z_file()` leaf (the reference object, metadata attached) widened with its optional populated companion. */
+function widenFileLeaf(leaf) {
+    const fileMetadata = getFileMetadata(leaf);
+    if (!fileMetadata || !isZodObject(leaf))
+        return leaf;
+    const shape = getZodObjectShape(leaf);
+    const companionKey = fileMetadata.multiple ? POPULATED_MULTIPLE_FILES_KEY : POPULATED_SINGLE_FILE_KEY;
+    if (companionKey in shape)
+        return leaf; // already widened (a DTO derived from a widened DTO)
+    const companion = fileMetadata.multiple ? z.array(PopulatedFileMetadataSchema).optional() : PopulatedFileMetadataSchema.optional();
+    return carrySchemaMetadata(leaf, leaf.extend({ [companionKey]: companion }));
+}
+export function widenFileFieldsForPopulatedReads(schema, activeSchemas = new WeakSet()) {
+    // An ABSENT schema passes through (#1138). `activeSchemas.add(undefined)` throws
+    // `TypeError: Invalid value used in weak set` — a message naming neither a DTO nor an operation,
+    // raised while a registry is being initialized, so it reaches a human as a backend that will not
+    // boot. `summaryDto` and `contextDto` are declared OPTIONAL on an operation
+    // (`resources-config.shared.schemas.ts:2098`), so absent is a state the contract permits.
+    //
+    // Measured rather than assumed about where it arrives from: `buildAllOperationDtos` DERIVES both
+    // (:545, :572), so its own four call sites never pass an absent one. The reported failure was the
+    // dev companion's projector rebuilding DTOs against the runtime registry — an EXTERNAL caller of
+    // this exported function, which is exactly why the guard belongs here and not at those call
+    // sites (`invariant-call-site-enumeration.md`: prefer making the invariant unbypassable).
+    //
+    // The overloads keep a definite schema in returning a definite schema, so no caller is handed a
+    // widened `| undefined` it then has to narrow.
+    if (!schema)
+        return schema;
+    if (activeSchemas.has(schema))
+        return schema;
+    activeSchemas.add(schema);
+    try {
+        if (getFileMetadata(schema) && isZodObject(schema))
+            return widenFileLeaf(schema);
+        if (isZodOptional(schema) || isZodNullable(schema) || isZodDefault(schema)) {
+            const inner = getZodDefSchemaProperty(schema, 'innerType');
+            if (!inner)
+                return schema;
+            const widenedInner = widenFileFieldsForPopulatedReads(inner, activeSchemas);
+            if (widenedInner === inner)
+                return schema;
+            const rewrapped = isZodOptional(schema)
+                ? widenedInner.optional()
+                : isZodNullable(schema)
+                    ? widenedInner.nullable()
+                    : widenedInner.default(() => getZodDefProperty(schema, 'defaultValue'));
+            return carrySchemaMetadata(schema, rewrapped);
+        }
+        const schemaType = getZodType(schema);
+        if (schemaType === 'lazy') {
+            const getter = getZodDef(schema)?.getter;
+            return typeof getter === 'function' ? z.lazy(() => widenFileFieldsForPopulatedReads(getter(), activeSchemas)) : schema;
+        }
+        if (schemaType === 'union') {
+            const discriminator = getZodDefStringProperty(schema, 'discriminator');
+            const options = getZodDefArrayProperty(schema, 'options');
+            if (!options?.length)
+                return schema;
+            const widened = options.map((option) => widenFileFieldsForPopulatedReads(option, activeSchemas));
+            if (widened.every((option, index) => option === options[index]))
+                return schema;
+            const rebuilt = discriminator
+                ? z.discriminatedUnion(discriminator, widened)
+                : z.union(widened);
+            return carrySchemaMetadata(schema, rebuilt);
+        }
+        if (isZodArray(schema)) {
+            const element = getZodDefProperty(schema, 'element');
+            if (!element)
+                return schema;
+            const widenedElement = widenFileFieldsForPopulatedReads(element, activeSchemas);
+            return widenedElement === element ? schema : withArrayElement(schema, widenedElement);
+        }
+        if (!isZodObject(schema))
+            return schema;
+        const shape = getZodObjectShape(schema);
+        const widenedShape = {};
+        let changed = false;
+        for (const [fieldName, fieldSchema] of Object.entries(shape)) {
+            const widened = widenFileFieldsForPopulatedReads(fieldSchema, activeSchemas);
+            if (widened !== fieldSchema)
+                changed = true;
+            widenedShape[fieldName] = widened;
+        }
+        if (!changed)
+            return schema;
+        return carrySchemaMetadata(schema, schema.extend(widenedShape));
+    }
+    finally {
+        activeSchemas.delete(schema);
+    }
+}
+//# sourceMappingURL=populated-file-fields.shared.utils.js.map

package/dist/esm/resources/utils/populated-file-fields.shared.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"populated-file-fields.shared.utils.js","sourceRoot":"","sources":["../../../../../src/resources/utils/populated-file-fields.shared.utils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The shape a file field takes on a POPULATED read, and the DTO that describes it (issue #1059).\n *\n * A file field is STORED as a reference — `{ fileId, updatedAt }` for one file, `{ fileIds, updatedAt }`\n * for several. A SUMMARY or CONTEXT read runs file population, which used to REPLACE that reference with\n * the file's metadata (`toMetadataResponse`: readiness, filename, size, url, …). The operation's DTO still\n * described the reference, so `transformOutput` refused every context read of a resource whose file\n * existed: `expected date, received Invalid Date` at `<field>.updatedAt`, a 500, and a degraded body\n * instead of the record. Measured 2026-09-14 on Wonder Todos.\n *\n * Population now keeps the reference and adds the metadata BESIDE it — `file` for one, `files` for\n * several — and the SUMMARY / CONTEXT DTOs declare that companion. Three candidates were weighed:\n *\n * - **Declare the replacement.** The frontend reads a file field as its stored reference (`'fileId' in\n *   value` / `'fileIds' in value`, then fetches metadata by id itself), so a metadata array in place of\n *   `{ fileIds }` fails its multiple-file guard outright. Declaring the replacement would have made the\n *   DTO agree with a shape one consumer cannot read.\n * - **Populate after `transformOutput`.** Validation would then never see the populated value, and the\n *   response DTO — the OpenAPI contract — would describe less than the wire carries.\n * - **Keep the reference (chosen).** Every reader of the reference keeps working, the companion is\n *   OPTIONAL so a read with population disabled or failed (`populateFileFieldsForSingle` keeps the\n *   original value on any error) still validates, and a consumer that wants the metadata finds it at a\n *   named key.\n *\n * The companion's schema carries the file field's decorator metadata forward, so the widened field is\n * still detected as a FILE field (`isFileSchema`, `getSchemaType`) — the same property\n * `resources-config-operations.dtos-builder.file-metadata-coercion.test.ts` pins for date coercion.\n */\nimport {\n  FileDisplayNature,\n  FileReadiness,\n  FileUploaderEntityType,\n  getFileMetadata,\n  getZodDef,\n  getZodDefArrayProperty,\n  getZodDefProperty,\n  getZodDefSchemaProperty,\n  getZodDefStringProperty,\n  getZodObjectShape,\n  getZodType,\n  isZodArray,\n  isZodDefault,\n  isZodNullable,\n  isZodObject,\n  isZodOptional,\n  SCHEMA_METADATA,\n  withArrayElement,\n} from '@wildo-ai/zod-decorators';\nimport { z } from 'zod';\n\n/** The key a populated single-file field carries its metadata under, beside `fileId`. */\nexport const POPULATED_SINGLE_FILE_KEY = 'file' as const;\n/** The key a populated multiple-file field carries its metadata list under, beside `fileIds`. */\nexport const POPULATED_MULTIPLE_FILES_KEY = 'files' as const;\n\n/**\n * `FileMetadata` (`@wildo-ai/zod-decorators`) as a Zod schema, at the NETWORK boundary: `uploadedAt`\n * coerces an ISO string, and the object is loose so a metadata key added later is carried rather\n * than stripped — this is server-produced data, never a request.\n */\nexport const PopulatedFileMetadataSchema: z.ZodTypeAny = z.looseObject({\n  readiness: z.enum(FileReadiness),\n  fileId: z.string().min(1),\n  filename: z.string(),\n  size: z.number(),\n  mimeType: z.string(),\n  extension: z.string().optional(),\n  checksum: z.string().optional(),\n  url: z.string().optional(),\n  thumbnailUrl: z.string().optional(),\n  nature: z.enum(FileDisplayNature).optional(),\n  width: z.number().optional(),\n  height: z.number().optional(),\n  duration: z.number().optional(),\n  pageCount: z.number().optional(),\n  uploadedAt: z.coerce.date(),\n  uploadedBy: z.string().optional(),\n  uploadedByEntityType: z.enum(FileUploaderEntityType).optional(),\n});\n\nfunction carrySchemaMetadata<TSchema extends z.ZodTypeAny>(source: z.ZodTypeAny, rebuilt: TSchema): TSchema {\n  const metadata = (source as any)[SCHEMA_METADATA];\n  if (metadata !== undefined) {\n    (rebuilt as any)[SCHEMA_METADATA] = metadata;\n  }\n  return rebuilt;\n}\n\n/** A `z_file()` leaf (the reference object, metadata attached) widened with its optional populated companion. */\nfunction widenFileLeaf(leaf: z.ZodTypeAny): z.ZodTypeAny {\n  const fileMetadata = getFileMetadata(leaf);\n  if (!fileMetadata || !isZodObject(leaf)) return leaf;\n  const shape = getZodObjectShape(leaf);\n  const companionKey = fileMetadata.multiple ? POPULATED_MULTIPLE_FILES_KEY : POPULATED_SINGLE_FILE_KEY;\n  if (companionKey in shape) return leaf; // already widened (a DTO derived from a widened DTO)\n  const companion = fileMetadata.multiple ? z.array(PopulatedFileMetadataSchema).optional() : PopulatedFileMetadataSchema.optional();\n  return carrySchemaMetadata(leaf, leaf.extend({ [companionKey]: companion }));\n}\n\n/**\n * Rebuild `schema` so every `z_file()` field accepts its populated companion beside the stored\n * reference. Identity-preserving where nothing beneath changed (a wrapper returns the ORIGINAL\n * instance, so an enclosing object is not rebuilt and keeps its metadata — the #989 lesson recorded\n * on `stripTemplatableFileFieldsRecursively`). Applied to READ-side DTOs only, after date coercion.\n */\nexport function widenFileFieldsForPopulatedReads(schema: z.ZodTypeAny, activeSchemas?: WeakSet<object>): z.ZodTypeAny;\nexport function widenFileFieldsForPopulatedReads(schema: undefined, activeSchemas?: WeakSet<object>): undefined;\nexport function widenFileFieldsForPopulatedReads(schema: z.ZodTypeAny | undefined, activeSchemas?: WeakSet<object>): z.ZodTypeAny | undefined;\nexport function widenFileFieldsForPopulatedReads(schema: z.ZodTypeAny | undefined, activeSchemas: WeakSet<object> = new WeakSet<object>()): z.ZodTypeAny | undefined {\n  // An ABSENT schema passes through (#1138). `activeSchemas.add(undefined)` throws\n  // `TypeError: Invalid value used in weak set` — a message naming neither a DTO nor an operation,\n  // raised while a registry is being initialized, so it reaches a human as a backend that will not\n  // boot. `summaryDto` and `contextDto` are declared OPTIONAL on an operation\n  // (`resources-config.shared.schemas.ts:2098`), so absent is a state the contract permits.\n  //\n  // Measured rather than assumed about where it arrives from: `buildAllOperationDtos` DERIVES both\n  // (:545, :572), so its own four call sites never pass an absent one. The reported failure was the\n  // dev companion's projector rebuilding DTOs against the runtime registry — an EXTERNAL caller of\n  // this exported function, which is exactly why the guard belongs here and not at those call\n  // sites (`invariant-call-site-enumeration.md`: prefer making the invariant unbypassable).\n  //\n  // The overloads keep a definite schema in returning a definite schema, so no caller is handed a\n  // widened `| undefined` it then has to narrow.\n  if (!schema) return schema;\n  if (activeSchemas.has(schema)) return schema;\n  activeSchemas.add(schema);\n  try {\n    if (getFileMetadata(schema) && isZodObject(schema)) return widenFileLeaf(schema);\n\n    if (isZodOptional(schema) || isZodNullable(schema) || isZodDefault(schema)) {\n      const inner = getZodDefSchemaProperty(schema, 'innerType');\n      if (!inner) return schema;\n      const widenedInner = widenFileFieldsForPopulatedReads(inner, activeSchemas);\n      if (widenedInner === inner) return schema;\n      const rewrapped = isZodOptional(schema)\n        ? widenedInner.optional()\n        : isZodNullable(schema)\n          ? widenedInner.nullable()\n          : widenedInner.default(() => getZodDefProperty(schema, 'defaultValue') as unknown);\n      return carrySchemaMetadata(schema, rewrapped);\n    }\n\n    const schemaType = getZodType(schema);\n    if (schemaType === 'lazy') {\n      const getter = getZodDef(schema)?.getter;\n      return typeof getter === 'function' ? z.lazy(() => widenFileFieldsForPopulatedReads(getter() as z.ZodTypeAny, activeSchemas)) : schema;\n    }\n\n    if (schemaType === 'union') {\n      const discriminator = getZodDefStringProperty(schema, 'discriminator');\n      const options = getZodDefArrayProperty(schema, 'options') as z.ZodTypeAny[] | undefined;\n      if (!options?.length) return schema;\n      const widened = options.map((option) => widenFileFieldsForPopulatedReads(option, activeSchemas));\n      if (widened.every((option, index) => option === options[index])) return schema;\n      const rebuilt: z.ZodTypeAny = discriminator\n        ? z.discriminatedUnion(discriminator, widened as [z.ZodObject<any>, z.ZodObject<any>, ...z.ZodObject<any>[]])\n        : z.union(widened as [z.ZodTypeAny, z.ZodTypeAny, ...z.ZodTypeAny[]]);\n      return carrySchemaMetadata(schema, rebuilt);\n    }\n\n    if (isZodArray(schema)) {\n      const element = getZodDefProperty(schema, 'element') as z.ZodTypeAny | undefined;\n      if (!element) return schema;\n      const widenedElement = widenFileFieldsForPopulatedReads(element, activeSchemas);\n      return widenedElement === element ? schema : withArrayElement(schema, widenedElement);\n    }\n\n    if (!isZodObject(schema)) return schema;\n\n    const shape = getZodObjectShape(schema);\n    const widenedShape: Record<string, z.ZodTypeAny> = {};\n    let changed = false;\n    for (const [fieldName, fieldSchema] of Object.entries(shape)) {\n      const widened = widenFileFieldsForPopulatedReads(fieldSchema as z.ZodTypeAny, activeSchemas);\n      if (widened !== fieldSchema) changed = true;\n      widenedShape[fieldName] = widened;\n    }\n    if (!changed) return schema;\n    return carrySchemaMetadata(schema, schema.extend(widenedShape));\n  } finally {\n    activeSchemas.delete(schema);\n  }\n}\n"]}

package/dist/esm/resources/utils/resources-config-naming.utils.d.ts

@@ -9,6 +9,21 @@ export declare class ResourcesConfigNamingUtils {
      * This is a reliable implementation covering most common cases
      */
     static singularize(word: string): string;
+    /**
+     * The singular nouns whose plural changes `f` / `fe` to `ves`. Deliberately SMALL and closed:
+     * everything else ending in `f` or `fe` takes a plain `s`, which is the common case in the
+     * identifiers this framework derives (`…Ref`, `…Proof`). Shared by `pluralize` and `singularize`
+     * so the two directions cannot disagree about which words are exceptions.
+     */
+    private static readonly F_TO_VES_WORDS;
+    private static readonly FE_TO_VES_WORDS;
+    /**
+     * The last English word of a lower-cased identifier. Word boundaries are lost by lower-casing, so
+     * this matches a trailing exception word against the whole-string suffix instead: `bookshelf`
+     * yields `shelf`, `organizationinvoiceref` yields itself (no exception word is its suffix), and a
+     * `snake_case` or `kebab-case` tail is split on its separator.
+     */
+    private static lastWordOf;
     /**
      * Preserve the case pattern of the original word in the result
      */

package/dist/esm/resources/utils/resources-config-naming.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resources-config-naming.utils.d.ts","sourceRoot":"","sources":["../../../../../src/resources/utils/resources-config-naming.utils.ts"],"names":[],"mappings":"AAAA,qBAAa,0BAA0B;IAMnC;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IA2DtC;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IA0DxC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAiB3B;;;;;;OAMG;IACH,MAAM,CAAC,cAAc,CAAC,uBAAuB,EAAE,MAAM,GAAG,MAAM;IAqB9D;;;;;;OAMG;IACH,MAAM,CAAC,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAW9D;;;;;OAKG;IACH,MAAM,CAAC,sBAAsB,CAAC,uBAAuB,EAAE,MAAM,GAAG,MAAM;IAKtE;;;;;OAKG;IACH,MAAM,CAAC,uBAAuB,CAAC,uBAAuB,EAAE,MAAM,GAAG,MAAM;IAiBvE;;;;;OAKG;IACH,MAAM,CAAC,yBAAyB,CAAC,uBAAuB,EAAE,MAAM,GAAG,MAAM;IAiBzE;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAAC,uBAAuB,EAAE,MAAM,GAAG,OAAO;IAIxE;;OAEG;IACH,MAAM,CAAC,yBAAyB,CAAC,uBAAuB,EAAE,MAAM,GAAG,OAAO;IAQ1E;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAQvC;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAMvC;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAKxC;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAQvC;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAI1C;;;;;OAKG;IACH,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAI5C;;;;;OAKG;IACH,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAQ5C;;;OAGG;IACH,MAAM,CAAC,8BAA8B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAa3D;;;OAGG;IACH,MAAM,CAAC,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAiBhD;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG;QAClD,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;KACzB;IAYD;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,eAAe,CAAC,uBAAuB,EAAE,MAAM,GAAG,MAAM;CAalE"}
+{"version":3,"file":"resources-config-naming.utils.d.ts","sourceRoot":"","sources":["../../../../../src/resources/utils/resources-config-naming.utils.ts"],"names":[],"mappings":"AAAA,qBAAa,0BAA0B;IAMnC;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAgEtC;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAwExC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAEnC;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAA2D;IAElG;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;IAUzB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAiB3B;;;;;;OAMG;IACH,MAAM,CAAC,cAAc,CAAC,uBAAuB,EAAE,MAAM,GAAG,MAAM;IAqB9D;;;;;;OAMG;IACH,MAAM,CAAC,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAW9D;;;;;OAKG;IACH,MAAM,CAAC,sBAAsB,CAAC,uBAAuB,EAAE,MAAM,GAAG,MAAM;IAKtE;;;;;OAKG;IACH,MAAM,CAAC,uBAAuB,CAAC,uBAAuB,EAAE,MAAM,GAAG,MAAM;IAiBvE;;;;;OAKG;IACH,MAAM,CAAC,yBAAyB,CAAC,uBAAuB,EAAE,MAAM,GAAG,MAAM;IAiBzE;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAAC,uBAAuB,EAAE,MAAM,GAAG,OAAO;IAIxE;;OAEG;IACH,MAAM,CAAC,yBAAyB,CAAC,uBAAuB,EAAE,MAAM,GAAG,OAAO;IAQ1E;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAQvC;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAMvC;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAKxC;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAQvC;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAI1C;;;;;OAKG;IACH,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAI5C;;;;;OAKG;IACH,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAQ5C;;;OAGG;IACH,MAAM,CAAC,8BAA8B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAa3D;;;OAGG;IACH,MAAM,CAAC,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAiBhD;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG;QAClD,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;KACzB;IAYD;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,eAAe,CAAC,uBAAuB,EAAE,MAAM,GAAG,MAAM;CAalE"}

package/dist/esm/resources/utils/resources-config-naming.utils.js

@@ -35,19 +35,24 @@ export class ResourcesConfigNamingUtils {
         if (irregularPlurals[lowerWord]) {
             return this.preserveCase(word, irregularPlurals[lowerWord]);
         }
-        // Words ending in 's', 'ss', 'sh', 'ch', 'x', 'z' add 'es'
-        if (/[sxz]$/.test(lowerWord) || /[sh]$/.test(lowerWord) || /ch$/.test(lowerWord)) {
+        // Words ending in 's', 'ss', 'sh', 'ch', 'x', 'z' add 'es'. `sh`, not `[sh]`: a bare 'h'
+        // takes a plain 's' (`path` → `paths`, `month` → `months`).
+        if (/[sxz]$/.test(lowerWord) || /sh$/.test(lowerWord) || /ch$/.test(lowerWord)) {
             return word + 'es';
         }
         // Words ending in consonant + 'y' change 'y' to 'ies'
         if (/[bcdfghjklmnpqrstvwxz]y$/.test(lowerWord)) {
             return word.slice(0, -1) + 'ies';
         }
-        // Words ending in 'f' or 'fe' change to 'ves'
-        if (/f$/.test(lowerWord)) {
+        // `f → ves` is the English EXCEPTION, not the rule: `ref`, `proof`, `chef`, `roof`, `belief`
+        // and `safe` take a plain 's'. A blanket `/f$/` put `organizationInvoiceReves` and
+        // `workbenchMarketProoves` on the wire (#580). Only the closed list below changes form, and it
+        // is matched on the LAST camelCase word so a compound (`bookShelf`) behaves like its head noun.
+        const lastWord = ResourcesConfigNamingUtils.lastWordOf(lowerWord);
+        if (ResourcesConfigNamingUtils.F_TO_VES_WORDS.has(lastWord)) {
             return word.slice(0, -1) + 'ves';
         }
-        if (/fe$/.test(lowerWord)) {
+        if (ResourcesConfigNamingUtils.FE_TO_VES_WORDS.has(lastWord)) {
             return word.slice(0, -2) + 'ves';
         }
         // Words ending in consonant + 'o' add 'es'
@@ -86,17 +91,30 @@ export class ResourcesConfigNamingUtils {
         if (/ies$/.test(lowerWord)) {
             return word.slice(0, -3) + 'y';
         }
-        // Words ending in 'ves' change to 'f' or 'fe'
+        // 'ves' → 'f' / 'fe' ONLY for the closed exception list `pluralize` uses; every other 'ves'
+        // word just drops its 's' (`workbenchMarketAlternatives` → `…Alternative`, not `…Alternatif`).
         if (/ves$/.test(lowerWord)) {
-            // Common words that end in 'fe' when singular
-            const fWords = ['wives', 'knives', 'lives'];
-            if (fWords.includes(lowerWord)) {
+            const lastWord = ResourcesConfigNamingUtils.lastWordOf(lowerWord).slice(0, -3);
+            if (ResourcesConfigNamingUtils.FE_TO_VES_WORDS.has(lastWord + 'fe')) {
                 return word.slice(0, -3) + 'fe';
             }
-            return word.slice(0, -3) + 'f';
+            if (ResourcesConfigNamingUtils.F_TO_VES_WORDS.has(lastWord + 'f')) {
+                return word.slice(0, -3) + 'f';
+            }
+            return word.slice(0, -1);
+        }
+        // '-ses' is ambiguous in English, and the naive "remove 'es'" turned `workbenchRoadmapPhases`
+        // into `…Phas`. A stem that itself ends in 's' (`classes`, `addresses`) or in 'us' (`buses`,
+        // `statuses`) drops 'es'; a vowel or n/l/r before 'se' (`phases`, `cases`, `databases`,
+        // `responses`, `licenses`, `courses`) marks a singular that ENDS in 'e', so only 's' goes.
+        if (/(sses|uses)$/.test(lowerWord)) {
+            return word.slice(0, -2);
+        }
+        if (/[aeionlr]ses$/.test(lowerWord)) {
+            return word.slice(0, -1);
         }
         // Words ending in 'ses', 'xes', 'zes', 'shes', 'ches' remove 'es'
-        if (/[sxz]es$/.test(lowerWord) || /[sh]es$/.test(lowerWord) || /ches$/.test(lowerWord)) {
+        if (/[sxz]es$/.test(lowerWord) || /shes$/.test(lowerWord) || /ches$/.test(lowerWord)) {
             return word.slice(0, -2);
         }
         // Words ending in 'oes' remove 'es'
@@ -110,6 +128,33 @@ export class ResourcesConfigNamingUtils {
         // If doesn't match any pattern, return as is (might already be singular)
         return word;
     }
+    /**
+     * The singular nouns whose plural changes `f` / `fe` to `ves`. Deliberately SMALL and closed:
+     * everything else ending in `f` or `fe` takes a plain `s`, which is the common case in the
+     * identifiers this framework derives (`…Ref`, `…Proof`). Shared by `pluralize` and `singularize`
+     * so the two directions cannot disagree about which words are exceptions.
+     */
+    static F_TO_VES_WORDS = new Set([
+        'calf', 'elf', 'half', 'leaf', 'loaf', 'self', 'sheaf', 'shelf', 'thief', 'wolf',
+    ]);
+    static FE_TO_VES_WORDS = new Set(['knife', 'life', 'wife']);
+    /**
+     * The last English word of a lower-cased identifier. Word boundaries are lost by lower-casing, so
+     * this matches a trailing exception word against the whole-string suffix instead: `bookshelf`
+     * yields `shelf`, `organizationinvoiceref` yields itself (no exception word is its suffix), and a
+     * `snake_case` or `kebab-case` tail is split on its separator.
+     */
+    static lastWordOf(lowerWord) {
+        const tail = lowerWord.split(/[_\-\s]/).pop() ?? lowerWord;
+        for (const candidate of [...ResourcesConfigNamingUtils.F_TO_VES_WORDS, ...ResourcesConfigNamingUtils.FE_TO_VES_WORDS]) {
+            if (tail.endsWith(candidate))
+                return candidate;
+            const plural = candidate.endsWith('fe') ? candidate.slice(0, -2) + 'ves' : candidate.slice(0, -1) + 'ves';
+            if (tail.endsWith(plural))
+                return plural;
+        }
+        return tail;
+    }
     /**
      * Preserve the case pattern of the original word in the result
      */

package/dist/esm/resources/utils/resources-config-naming.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"resources-config-naming.utils.js","sourceRoot":"","sources":["../../../../../src/resources/utils/resources-config-naming.utils.ts"],"names":[],"mappings":"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","sourcesContent":["export class ResourcesConfigNamingUtils {\n    \n    // ================================\n    // PLURALIZATION AND SINGULARIZATION\n    // ================================\n    \n    /**\n     * Pluralize an English word using common English rules\n     * This is a reliable implementation covering most common cases\n     */\n    static pluralize(word: string): string {\n        if (!word || word.length === 0) return word;\n        \n        const lowerWord = word.toLowerCase();\n        \n        // Irregular plurals\n        const irregularPlurals: Record<string, string> = {\n            'person': 'people',\n            'man': 'men',\n            'woman': 'women',\n            'child': 'children',\n            'tooth': 'teeth',\n            'foot': 'feet',\n            'mouse': 'mice',\n            'goose': 'geese',\n            // Technical/borrowed words that don't follow consonant+o rule\n            'todo': 'todos',\n            'photo': 'photos',\n            'memo': 'memos',\n            'logo': 'logos',\n            'piano': 'pianos',\n            'video': 'videos',\n            'studio': 'studios',\n            // Words ending in z that double the z\n            'quiz': 'quizzes',\n            'fez': 'fezzes',\n        };\n        \n        if (irregularPlurals[lowerWord]) {\n            return this.preserveCase(word, irregularPlurals[lowerWord]);\n        }\n        \n        // Words ending in 's', 'ss', 'sh', 'ch', 'x', 'z' add 'es'\n        if (/[sxz]$/.test(lowerWord) || /[sh]$/.test(lowerWord) || /ch$/.test(lowerWord)) {\n            return word + 'es';\n        }\n        \n        // Words ending in consonant + 'y' change 'y' to 'ies'\n        if (/[bcdfghjklmnpqrstvwxz]y$/.test(lowerWord)) {\n            return word.slice(0, -1) + 'ies';\n        }\n        \n        // Words ending in 'f' or 'fe' change to 'ves'\n        if (/f$/.test(lowerWord)) {\n            return word.slice(0, -1) + 'ves';\n        }\n        if (/fe$/.test(lowerWord)) {\n            return word.slice(0, -2) + 'ves';\n        }\n        \n        // Words ending in consonant + 'o' add 'es'\n        if (/[bcdfghjklmnpqrstvwxz]o$/.test(lowerWord)) {\n            return word + 'es';\n        }\n        \n        // Default: add 's'\n        return word + 's';\n    }\n    \n    /**\n     * Singularize an English word using common English rules\n     * This is a reliable implementation covering most common cases\n     */\n    static singularize(word: string): string {\n        if (!word || word.length === 0) return word;\n        \n        const lowerWord = word.toLowerCase();\n        \n        // Irregular singulars\n        const irregularSingulars: Record<string, string> = {\n            'people': 'person',\n            'men': 'man',\n            'women': 'woman',\n            'children': 'child',\n            'teeth': 'tooth',\n            'feet': 'foot',\n            'mice': 'mouse',\n            'geese': 'goose',\n            // Words with doubled z\n            'quizzes': 'quiz',\n            'fezzes': 'fez',\n        };\n        \n        if (irregularSingulars[lowerWord]) {\n            return this.preserveCase(word, irregularSingulars[lowerWord]);\n        }\n        \n        // Words ending in 'ies' change to 'y'\n        if (/ies$/.test(lowerWord)) {\n            return word.slice(0, -3) + 'y';\n        }\n        \n        // Words ending in 'ves' change to 'f' or 'fe'\n        if (/ves$/.test(lowerWord)) {\n            // Common words that end in 'fe' when singular\n            const fWords = ['wives', 'knives', 'lives'];\n            if (fWords.includes(lowerWord)) {\n                return word.slice(0, -3) + 'fe';\n            }\n            return word.slice(0, -3) + 'f';\n        }\n        \n        // Words ending in 'ses', 'xes', 'zes', 'shes', 'ches' remove 'es'\n        if (/[sxz]es$/.test(lowerWord) || /[sh]es$/.test(lowerWord) || /ches$/.test(lowerWord)) {\n            return word.slice(0, -2);\n        }\n        \n        // Words ending in 'oes' remove 'es'\n        if (/oes$/.test(lowerWord)) {\n            return word.slice(0, -2);\n        }\n        \n        // Words ending in 's' but not 'ss' remove 's'\n        if (/[^s]s$/.test(lowerWord)) {\n            return word.slice(0, -1);\n        }\n        \n        // If doesn't match any pattern, return as is (might already be singular)\n        return word;\n    }\n    \n    /**\n     * Preserve the case pattern of the original word in the result\n     */\n    private static preserveCase(original: string, result: string): string {\n        if (original === original.toUpperCase()) {\n            return result.toUpperCase();\n        }\n        if (original === original.toLowerCase()) {\n            return result.toLowerCase();\n        }\n        if (original[0] === original[0].toUpperCase()) {\n            return result.charAt(0).toUpperCase() + result.slice(1).toLowerCase();\n        }\n        return result;\n    }\n    \n    // ================================\n    // RESOURCE NAME CONVERSIONS\n    // ================================\n    \n    /**\n     * Convert resourceFieldIdentifier to resourceName (plural)\n     * Examples:\n     * - \"userId\" -> \"users\"\n     * - \"organizationIds\" -> \"organizations\" \n     * - \"todoListId\" -> \"todoLists\"\n     */\n    static toResourceName(resourceFieldIdentifier: string): string {\n        if (!resourceFieldIdentifier) return '';\n        \n        let baseName: string;\n        \n        // Handle plural form (ends with 'Ids')\n        if (resourceFieldIdentifier.endsWith('Ids')) {\n            baseName = resourceFieldIdentifier.slice(0, -3);\n            return this.pluralize(baseName);\n        }\n        \n        // Handle singular form (ends with 'Id')\n        if (resourceFieldIdentifier.endsWith('Id')) {\n            baseName = resourceFieldIdentifier.slice(0, -2);\n            return this.pluralize(baseName);\n        }\n        \n        // If doesn't end with Id/Ids, assume it's already a resource name\n        return this.pluralize(resourceFieldIdentifier);\n    }\n    \n    /**\n     * Convert resourceName to resourceFieldIdentifier\n     * Examples:\n     * - \"users\" -> \"userId\"\n     * - \"organizations\" -> \"organizationId\"\n     * - \"todoLists\" -> \"todoListId\"\n     */\n    static toResourceFieldIdentifier(resourceName: string): string {\n        if (!resourceName) return '';\n        \n        const singularName = this.singularize(resourceName);\n        return singularName + 'Id';\n    }\n    \n    // ================================\n    // QUICK WIN FUNCTIONS\n    // ================================\n    \n    /**\n     * Convert resourceFieldIdentifier to singular resource name\n     * Examples:\n     * - \"userId\" -> \"user\"\n     * - \"organizationIds\" -> \"organization\"\n     */\n    static toResourceNameSingular(resourceFieldIdentifier: string): string {\n        const resourceName = this.toResourceName(resourceFieldIdentifier);\n        return this.singularize(resourceName);\n    }\n    \n    /**\n     * Convert resourceFieldIdentifier to plural field identifier\n     * Examples:\n     * - \"userId\" -> \"userIds\"\n     * - \"organizationId\" -> \"organizationIds\"\n     */\n    static toFieldIdentifierPlural(resourceFieldIdentifier: string): string {\n        if (!resourceFieldIdentifier) return '';\n        \n        // If already plural (ends with 'Ids'), return as is\n        if (resourceFieldIdentifier.endsWith('Ids')) {\n            return resourceFieldIdentifier;\n        }\n        \n        // If singular (ends with 'Id'), make plural\n        if (resourceFieldIdentifier.endsWith('Id')) {\n            return resourceFieldIdentifier.slice(0, -2) + 'Ids';\n        }\n        \n        // If doesn't end with Id/Ids, add 'Ids'\n        return resourceFieldIdentifier + 'Ids';\n    }\n    \n    /**\n     * Convert resourceFieldIdentifier to singular field identifier\n     * Examples:\n     * - \"userIds\" -> \"userId\"\n     * - \"organizationId\" -> \"organizationId\"\n     */\n    static toFieldIdentifierSingular(resourceFieldIdentifier: string): string {\n        if (!resourceFieldIdentifier) return '';\n        \n        // If plural (ends with 'Ids'), make singular\n        if (resourceFieldIdentifier.endsWith('Ids')) {\n            return resourceFieldIdentifier.slice(0, -3) + 'Id';\n        }\n        \n        // If already singular (ends with 'Id'), return as is\n        if (resourceFieldIdentifier.endsWith('Id')) {\n            return resourceFieldIdentifier;\n        }\n        \n        // If doesn't end with Id/Ids, add 'Id'\n        return resourceFieldIdentifier + 'Id';\n    }\n    \n    /**\n     * Check if a resourceFieldIdentifier is plural\n     */\n    static isFieldIdentifierPlural(resourceFieldIdentifier: string): boolean {\n        return resourceFieldIdentifier.endsWith('Ids');\n    }\n    \n    /**\n     * Check if a resourceFieldIdentifier is singular\n     */\n    static isFieldIdentifierSingular(resourceFieldIdentifier: string): boolean {\n        return resourceFieldIdentifier.endsWith('Id') && !resourceFieldIdentifier.endsWith('Ids');\n    }\n    \n    // ================================\n    // CASE CONVERSION UTILITIES\n    // ================================\n    \n    /**\n     * Convert to snake_case\n     * Examples:\n     * - \"createdByUser\" -> \"created_by_user\"\n     * - \"TodoList\" -> \"todo_list\"\n     */\n    static toSnakeCase(str: string): string {\n        return str\n            .replace(/([A-Z])/g, '_$1')\n            .replace(/^_/, '')\n            .replace(/[-\\s]+/g, '_')\n            .toLowerCase();\n    }\n    \n    /**\n     * Convert to camelCase\n     * Examples:\n     * - \"created-by-user\" -> \"createdByUser\"\n     * - \"todo_list\" -> \"todoList\"\n     */\n    static toCamelCase(str: string): string {\n        return str\n            .replace(/[-_\\s]+(.)?/g, (_, char) => char ? char.toUpperCase() : '')\n            .replace(/^([A-Z])/, (char) => char.toLowerCase());\n    }\n    \n    /**\n     * Convert to PascalCase\n     * Examples:\n     * - \"created-by-user\" -> \"CreatedByUser\"\n     * - \"todo_list\" -> \"TodoList\"\n     */\n    static toPascalCase(str: string): string {\n        const camelCase = this.toCamelCase(str);\n        return camelCase.charAt(0).toUpperCase() + camelCase.slice(1);\n    }\n    \n    /**\n     * Convert to kebab-case\n     * Examples:\n     * - \"createdByUser\" -> \"created-by-user\"\n     * - \"TodoList\" -> \"todo-list\"\n     */\n    static toKebabCase(str: string): string {\n        return str\n            .replace(/([A-Z])/g, '-$1')\n            .replace(/^-/, '')\n            .replace(/[_\\s]+/g, '-')\n            .toLowerCase();\n    }\n    \n    /**\n     * Convert to CONSTANT_CASE\n     * Examples:\n     * - \"createdByUser\" -> \"CREATED_BY_USER\"\n     * - \"todo-list\" -> \"TODO_LIST\"\n     */\n    static toConstantCase(str: string): string {\n        return this.toSnakeCase(str).toUpperCase();\n    }\n    \n    /**\n     * Convert from kebab-case to camelCase (as specifically requested)\n     * Examples:\n     * - \"created-by-user\" -> \"createdByUser\"\n     * - \"todo-list-item\" -> \"todoListItem\"\n     */\n    static kebabToCamelCase(str: string): string {\n        return this.toCamelCase(str);\n    }\n    \n    /**\n     * Convert from snake_case to camelCase\n     * Examples:\n     * - \"created_by_user\" -> \"createdByUser\"\n     * - \"todo_list_item\" -> \"todoListItem\"\n     */\n    static snakeToCamelCase(str: string): string {\n        return this.toCamelCase(str);\n    }\n    \n    // ================================\n    // VALIDATION UTILITIES\n    // ================================\n    \n    /**\n     * Validate if a string is a valid resourceFieldIdentifier\n     * Must end with 'Id' or 'Ids' and be in camelCase\n     */\n    static isValidResourceFieldIdentifier(str: string): boolean {\n        if (!str) return false;\n        \n        // Must end with Id or Ids\n        if (!str.endsWith('Id') && !str.endsWith('Ids')) return false;\n        \n        // Must be in camelCase (starts with lowercase)\n        if (str[0] !== str[0].toLowerCase()) return false;\n        \n        // Should not contain special characters except camelCase\n        return /^[a-z][a-zA-Z0-9]*I(d|ds)$/.test(str);\n    }\n    \n    /**\n     * Validate if a string is a valid resourceName\n     * Should be in camelCase and plural\n     */\n    static isValidResourceName(str: string): boolean {\n        if (!str) return false;\n        \n        // Must be in camelCase (starts with lowercase)\n        if (str[0] !== str[0].toLowerCase()) return false;\n        \n        // Should not contain special characters\n        if (!/^[a-z][a-zA-Z0-9]*$/.test(str)) return false;\n        \n        // Should be plural (this is a heuristic check)\n        return str !== this.singularize(str);\n    }\n    \n    // ================================\n    // UTILITY HELPERS\n    // ================================\n    \n    /**\n     * Get both singular and plural forms of a resource name\n     */\n    static getResourceNameVariants(resourceName: string): {\n        singular: string;\n        plural: string;\n        singularFieldId: string;\n        pluralFieldId: string;\n    } {\n        const singular = this.singularize(resourceName);\n        const plural = this.pluralize(resourceName);\n        \n        return {\n            singular,\n            plural,\n            singularFieldId: singular + 'Id',\n            pluralFieldId: singular + 'Ids'\n        };\n    }\n    \n    /**\n     * Extract the base name from a resourceFieldIdentifier.\n     * \n     * THIS IS THE CANONICAL FUNCTION for deriving populated sibling field names.\n     * Used by:\n     * - Backend: resource-population.backend.service.ts (populateForSummary, populateListForSummary)\n     * - Backend: services-registry-handler.backend.service.ts (getNestedFieldName for 1:1 relationships)\n     * - Backend: resources-config-operations.dtos-builder.utils.ts (nested DTO fields for 1:1)\n     * - Frontend: DisplayField.tsx (extractPopulatedSibling)\n     * \n     * DO NOT create alternative implementations. Use this function.\n     * For 1:N nested fields, use toResourceName() instead (pluralized form).\n     * \n     * Examples:\n     * - \"userId\" -> \"user\"\n     * - \"organizationIds\" -> \"organization\"\n     * - \"assignedToUserId\" -> \"assignedToUser\"\n     */\n    static extractBaseName(resourceFieldIdentifier: string): string {\n        if (!resourceFieldIdentifier) return '';\n        \n        if (resourceFieldIdentifier.endsWith('Ids')) {\n            return resourceFieldIdentifier.slice(0, -3);\n        }\n        \n        if (resourceFieldIdentifier.endsWith('Id')) {\n            return resourceFieldIdentifier.slice(0, -2);\n        }\n        \n        return resourceFieldIdentifier;\n    }\n}"]}
+{"version":3,"file":"resources-config-naming.utils.js","sourceRoot":"","sources":["../../../../../src/resources/utils/resources-config-naming.utils.ts"],"names":[],"mappings":"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","sourcesContent":["export class ResourcesConfigNamingUtils {\n    \n    // ================================\n    // PLURALIZATION AND SINGULARIZATION\n    // ================================\n    \n    /**\n     * Pluralize an English word using common English rules\n     * This is a reliable implementation covering most common cases\n     */\n    static pluralize(word: string): string {\n        if (!word || word.length === 0) return word;\n        \n        const lowerWord = word.toLowerCase();\n        \n        // Irregular plurals\n        const irregularPlurals: Record<string, string> = {\n            'person': 'people',\n            'man': 'men',\n            'woman': 'women',\n            'child': 'children',\n            'tooth': 'teeth',\n            'foot': 'feet',\n            'mouse': 'mice',\n            'goose': 'geese',\n            // Technical/borrowed words that don't follow consonant+o rule\n            'todo': 'todos',\n            'photo': 'photos',\n            'memo': 'memos',\n            'logo': 'logos',\n            'piano': 'pianos',\n            'video': 'videos',\n            'studio': 'studios',\n            // Words ending in z that double the z\n            'quiz': 'quizzes',\n            'fez': 'fezzes',\n        };\n        \n        if (irregularPlurals[lowerWord]) {\n            return this.preserveCase(word, irregularPlurals[lowerWord]);\n        }\n        \n        // Words ending in 's', 'ss', 'sh', 'ch', 'x', 'z' add 'es'. `sh`, not `[sh]`: a bare 'h'\n        // takes a plain 's' (`path` → `paths`, `month` → `months`).\n        if (/[sxz]$/.test(lowerWord) || /sh$/.test(lowerWord) || /ch$/.test(lowerWord)) {\n            return word + 'es';\n        }\n        \n        // Words ending in consonant + 'y' change 'y' to 'ies'\n        if (/[bcdfghjklmnpqrstvwxz]y$/.test(lowerWord)) {\n            return word.slice(0, -1) + 'ies';\n        }\n        \n        // `f → ves` is the English EXCEPTION, not the rule: `ref`, `proof`, `chef`, `roof`, `belief`\n        // and `safe` take a plain 's'. A blanket `/f$/` put `organizationInvoiceReves` and\n        // `workbenchMarketProoves` on the wire (#580). Only the closed list below changes form, and it\n        // is matched on the LAST camelCase word so a compound (`bookShelf`) behaves like its head noun.\n        const lastWord = ResourcesConfigNamingUtils.lastWordOf(lowerWord);\n        if (ResourcesConfigNamingUtils.F_TO_VES_WORDS.has(lastWord)) {\n            return word.slice(0, -1) + 'ves';\n        }\n        if (ResourcesConfigNamingUtils.FE_TO_VES_WORDS.has(lastWord)) {\n            return word.slice(0, -2) + 'ves';\n        }\n        \n        // Words ending in consonant + 'o' add 'es'\n        if (/[bcdfghjklmnpqrstvwxz]o$/.test(lowerWord)) {\n            return word + 'es';\n        }\n        \n        // Default: add 's'\n        return word + 's';\n    }\n    \n    /**\n     * Singularize an English word using common English rules\n     * This is a reliable implementation covering most common cases\n     */\n    static singularize(word: string): string {\n        if (!word || word.length === 0) return word;\n        \n        const lowerWord = word.toLowerCase();\n        \n        // Irregular singulars\n        const irregularSingulars: Record<string, string> = {\n            'people': 'person',\n            'men': 'man',\n            'women': 'woman',\n            'children': 'child',\n            'teeth': 'tooth',\n            'feet': 'foot',\n            'mice': 'mouse',\n            'geese': 'goose',\n            // Words with doubled z\n            'quizzes': 'quiz',\n            'fezzes': 'fez',\n        };\n        \n        if (irregularSingulars[lowerWord]) {\n            return this.preserveCase(word, irregularSingulars[lowerWord]);\n        }\n        \n        // Words ending in 'ies' change to 'y'\n        if (/ies$/.test(lowerWord)) {\n            return word.slice(0, -3) + 'y';\n        }\n        \n        // 'ves' → 'f' / 'fe' ONLY for the closed exception list `pluralize` uses; every other 'ves'\n        // word just drops its 's' (`workbenchMarketAlternatives` → `…Alternative`, not `…Alternatif`).\n        if (/ves$/.test(lowerWord)) {\n            const lastWord = ResourcesConfigNamingUtils.lastWordOf(lowerWord).slice(0, -3);\n            if (ResourcesConfigNamingUtils.FE_TO_VES_WORDS.has(lastWord + 'fe')) {\n                return word.slice(0, -3) + 'fe';\n            }\n            if (ResourcesConfigNamingUtils.F_TO_VES_WORDS.has(lastWord + 'f')) {\n                return word.slice(0, -3) + 'f';\n            }\n            return word.slice(0, -1);\n        }\n\n        // '-ses' is ambiguous in English, and the naive \"remove 'es'\" turned `workbenchRoadmapPhases`\n        // into `…Phas`. A stem that itself ends in 's' (`classes`, `addresses`) or in 'us' (`buses`,\n        // `statuses`) drops 'es'; a vowel or n/l/r before 'se' (`phases`, `cases`, `databases`,\n        // `responses`, `licenses`, `courses`) marks a singular that ENDS in 'e', so only 's' goes.\n        if (/(sses|uses)$/.test(lowerWord)) {\n            return word.slice(0, -2);\n        }\n        if (/[aeionlr]ses$/.test(lowerWord)) {\n            return word.slice(0, -1);\n        }\n\n        // Words ending in 'ses', 'xes', 'zes', 'shes', 'ches' remove 'es'\n        if (/[sxz]es$/.test(lowerWord) || /shes$/.test(lowerWord) || /ches$/.test(lowerWord)) {\n            return word.slice(0, -2);\n        }\n        \n        // Words ending in 'oes' remove 'es'\n        if (/oes$/.test(lowerWord)) {\n            return word.slice(0, -2);\n        }\n        \n        // Words ending in 's' but not 'ss' remove 's'\n        if (/[^s]s$/.test(lowerWord)) {\n            return word.slice(0, -1);\n        }\n        \n        // If doesn't match any pattern, return as is (might already be singular)\n        return word;\n    }\n    \n    /**\n     * The singular nouns whose plural changes `f` / `fe` to `ves`. Deliberately SMALL and closed:\n     * everything else ending in `f` or `fe` takes a plain `s`, which is the common case in the\n     * identifiers this framework derives (`…Ref`, `…Proof`). Shared by `pluralize` and `singularize`\n     * so the two directions cannot disagree about which words are exceptions.\n     */\n    private static readonly F_TO_VES_WORDS: ReadonlySet<string> = new Set([\n        'calf', 'elf', 'half', 'leaf', 'loaf', 'self', 'sheaf', 'shelf', 'thief', 'wolf',\n    ]);\n    private static readonly FE_TO_VES_WORDS: ReadonlySet<string> = new Set(['knife', 'life', 'wife']);\n\n    /**\n     * The last English word of a lower-cased identifier. Word boundaries are lost by lower-casing, so\n     * this matches a trailing exception word against the whole-string suffix instead: `bookshelf`\n     * yields `shelf`, `organizationinvoiceref` yields itself (no exception word is its suffix), and a\n     * `snake_case` or `kebab-case` tail is split on its separator.\n     */\n    private static lastWordOf(lowerWord: string): string {\n        const tail = lowerWord.split(/[_\\-\\s]/).pop() ?? lowerWord;\n        for (const candidate of [...ResourcesConfigNamingUtils.F_TO_VES_WORDS, ...ResourcesConfigNamingUtils.FE_TO_VES_WORDS]) {\n            if (tail.endsWith(candidate)) return candidate;\n            const plural = candidate.endsWith('fe') ? candidate.slice(0, -2) + 'ves' : candidate.slice(0, -1) + 'ves';\n            if (tail.endsWith(plural)) return plural;\n        }\n        return tail;\n    }\n\n    /**\n     * Preserve the case pattern of the original word in the result\n     */\n    private static preserveCase(original: string, result: string): string {\n        if (original === original.toUpperCase()) {\n            return result.toUpperCase();\n        }\n        if (original === original.toLowerCase()) {\n            return result.toLowerCase();\n        }\n        if (original[0] === original[0].toUpperCase()) {\n            return result.charAt(0).toUpperCase() + result.slice(1).toLowerCase();\n        }\n        return result;\n    }\n    \n    // ================================\n    // RESOURCE NAME CONVERSIONS\n    // ================================\n    \n    /**\n     * Convert resourceFieldIdentifier to resourceName (plural)\n     * Examples:\n     * - \"userId\" -> \"users\"\n     * - \"organizationIds\" -> \"organizations\" \n     * - \"todoListId\" -> \"todoLists\"\n     */\n    static toResourceName(resourceFieldIdentifier: string): string {\n        if (!resourceFieldIdentifier) return '';\n        \n        let baseName: string;\n        \n        // Handle plural form (ends with 'Ids')\n        if (resourceFieldIdentifier.endsWith('Ids')) {\n            baseName = resourceFieldIdentifier.slice(0, -3);\n            return this.pluralize(baseName);\n        }\n        \n        // Handle singular form (ends with 'Id')\n        if (resourceFieldIdentifier.endsWith('Id')) {\n            baseName = resourceFieldIdentifier.slice(0, -2);\n            return this.pluralize(baseName);\n        }\n        \n        // If doesn't end with Id/Ids, assume it's already a resource name\n        return this.pluralize(resourceFieldIdentifier);\n    }\n    \n    /**\n     * Convert resourceName to resourceFieldIdentifier\n     * Examples:\n     * - \"users\" -> \"userId\"\n     * - \"organizations\" -> \"organizationId\"\n     * - \"todoLists\" -> \"todoListId\"\n     */\n    static toResourceFieldIdentifier(resourceName: string): string {\n        if (!resourceName) return '';\n        \n        const singularName = this.singularize(resourceName);\n        return singularName + 'Id';\n    }\n    \n    // ================================\n    // QUICK WIN FUNCTIONS\n    // ================================\n    \n    /**\n     * Convert resourceFieldIdentifier to singular resource name\n     * Examples:\n     * - \"userId\" -> \"user\"\n     * - \"organizationIds\" -> \"organization\"\n     */\n    static toResourceNameSingular(resourceFieldIdentifier: string): string {\n        const resourceName = this.toResourceName(resourceFieldIdentifier);\n        return this.singularize(resourceName);\n    }\n    \n    /**\n     * Convert resourceFieldIdentifier to plural field identifier\n     * Examples:\n     * - \"userId\" -> \"userIds\"\n     * - \"organizationId\" -> \"organizationIds\"\n     */\n    static toFieldIdentifierPlural(resourceFieldIdentifier: string): string {\n        if (!resourceFieldIdentifier) return '';\n        \n        // If already plural (ends with 'Ids'), return as is\n        if (resourceFieldIdentifier.endsWith('Ids')) {\n            return resourceFieldIdentifier;\n        }\n        \n        // If singular (ends with 'Id'), make plural\n        if (resourceFieldIdentifier.endsWith('Id')) {\n            return resourceFieldIdentifier.slice(0, -2) + 'Ids';\n        }\n        \n        // If doesn't end with Id/Ids, add 'Ids'\n        return resourceFieldIdentifier + 'Ids';\n    }\n    \n    /**\n     * Convert resourceFieldIdentifier to singular field identifier\n     * Examples:\n     * - \"userIds\" -> \"userId\"\n     * - \"organizationId\" -> \"organizationId\"\n     */\n    static toFieldIdentifierSingular(resourceFieldIdentifier: string): string {\n        if (!resourceFieldIdentifier) return '';\n        \n        // If plural (ends with 'Ids'), make singular\n        if (resourceFieldIdentifier.endsWith('Ids')) {\n            return resourceFieldIdentifier.slice(0, -3) + 'Id';\n        }\n        \n        // If already singular (ends with 'Id'), return as is\n        if (resourceFieldIdentifier.endsWith('Id')) {\n            return resourceFieldIdentifier;\n        }\n        \n        // If doesn't end with Id/Ids, add 'Id'\n        return resourceFieldIdentifier + 'Id';\n    }\n    \n    /**\n     * Check if a resourceFieldIdentifier is plural\n     */\n    static isFieldIdentifierPlural(resourceFieldIdentifier: string): boolean {\n        return resourceFieldIdentifier.endsWith('Ids');\n    }\n    \n    /**\n     * Check if a resourceFieldIdentifier is singular\n     */\n    static isFieldIdentifierSingular(resourceFieldIdentifier: string): boolean {\n        return resourceFieldIdentifier.endsWith('Id') && !resourceFieldIdentifier.endsWith('Ids');\n    }\n    \n    // ================================\n    // CASE CONVERSION UTILITIES\n    // ================================\n    \n    /**\n     * Convert to snake_case\n     * Examples:\n     * - \"createdByUser\" -> \"created_by_user\"\n     * - \"TodoList\" -> \"todo_list\"\n     */\n    static toSnakeCase(str: string): string {\n        return str\n            .replace(/([A-Z])/g, '_$1')\n            .replace(/^_/, '')\n            .replace(/[-\\s]+/g, '_')\n            .toLowerCase();\n    }\n    \n    /**\n     * Convert to camelCase\n     * Examples:\n     * - \"created-by-user\" -> \"createdByUser\"\n     * - \"todo_list\" -> \"todoList\"\n     */\n    static toCamelCase(str: string): string {\n        return str\n            .replace(/[-_\\s]+(.)?/g, (_, char) => char ? char.toUpperCase() : '')\n            .replace(/^([A-Z])/, (char) => char.toLowerCase());\n    }\n    \n    /**\n     * Convert to PascalCase\n     * Examples:\n     * - \"created-by-user\" -> \"CreatedByUser\"\n     * - \"todo_list\" -> \"TodoList\"\n     */\n    static toPascalCase(str: string): string {\n        const camelCase = this.toCamelCase(str);\n        return camelCase.charAt(0).toUpperCase() + camelCase.slice(1);\n    }\n    \n    /**\n     * Convert to kebab-case\n     * Examples:\n     * - \"createdByUser\" -> \"created-by-user\"\n     * - \"TodoList\" -> \"todo-list\"\n     */\n    static toKebabCase(str: string): string {\n        return str\n            .replace(/([A-Z])/g, '-$1')\n            .replace(/^-/, '')\n            .replace(/[_\\s]+/g, '-')\n            .toLowerCase();\n    }\n    \n    /**\n     * Convert to CONSTANT_CASE\n     * Examples:\n     * - \"createdByUser\" -> \"CREATED_BY_USER\"\n     * - \"todo-list\" -> \"TODO_LIST\"\n     */\n    static toConstantCase(str: string): string {\n        return this.toSnakeCase(str).toUpperCase();\n    }\n    \n    /**\n     * Convert from kebab-case to camelCase (as specifically requested)\n     * Examples:\n     * - \"created-by-user\" -> \"createdByUser\"\n     * - \"todo-list-item\" -> \"todoListItem\"\n     */\n    static kebabToCamelCase(str: string): string {\n        return this.toCamelCase(str);\n    }\n    \n    /**\n     * Convert from snake_case to camelCase\n     * Examples:\n     * - \"created_by_user\" -> \"createdByUser\"\n     * - \"todo_list_item\" -> \"todoListItem\"\n     */\n    static snakeToCamelCase(str: string): string {\n        return this.toCamelCase(str);\n    }\n    \n    // ================================\n    // VALIDATION UTILITIES\n    // ================================\n    \n    /**\n     * Validate if a string is a valid resourceFieldIdentifier\n     * Must end with 'Id' or 'Ids' and be in camelCase\n     */\n    static isValidResourceFieldIdentifier(str: string): boolean {\n        if (!str) return false;\n        \n        // Must end with Id or Ids\n        if (!str.endsWith('Id') && !str.endsWith('Ids')) return false;\n        \n        // Must be in camelCase (starts with lowercase)\n        if (str[0] !== str[0].toLowerCase()) return false;\n        \n        // Should not contain special characters except camelCase\n        return /^[a-z][a-zA-Z0-9]*I(d|ds)$/.test(str);\n    }\n    \n    /**\n     * Validate if a string is a valid resourceName\n     * Should be in camelCase and plural\n     */\n    static isValidResourceName(str: string): boolean {\n        if (!str) return false;\n        \n        // Must be in camelCase (starts with lowercase)\n        if (str[0] !== str[0].toLowerCase()) return false;\n        \n        // Should not contain special characters\n        if (!/^[a-z][a-zA-Z0-9]*$/.test(str)) return false;\n        \n        // Should be plural (this is a heuristic check)\n        return str !== this.singularize(str);\n    }\n    \n    // ================================\n    // UTILITY HELPERS\n    // ================================\n    \n    /**\n     * Get both singular and plural forms of a resource name\n     */\n    static getResourceNameVariants(resourceName: string): {\n        singular: string;\n        plural: string;\n        singularFieldId: string;\n        pluralFieldId: string;\n    } {\n        const singular = this.singularize(resourceName);\n        const plural = this.pluralize(resourceName);\n        \n        return {\n            singular,\n            plural,\n            singularFieldId: singular + 'Id',\n            pluralFieldId: singular + 'Ids'\n        };\n    }\n    \n    /**\n     * Extract the base name from a resourceFieldIdentifier.\n     * \n     * THIS IS THE CANONICAL FUNCTION for deriving populated sibling field names.\n     * Used by:\n     * - Backend: resource-population.backend.service.ts (populateForSummary, populateListForSummary)\n     * - Backend: services-registry-handler.backend.service.ts (getNestedFieldName for 1:1 relationships)\n     * - Backend: resources-config-operations.dtos-builder.utils.ts (nested DTO fields for 1:1)\n     * - Frontend: DisplayField.tsx (extractPopulatedSibling)\n     * \n     * DO NOT create alternative implementations. Use this function.\n     * For 1:N nested fields, use toResourceName() instead (pluralized form).\n     * \n     * Examples:\n     * - \"userId\" -> \"user\"\n     * - \"organizationIds\" -> \"organization\"\n     * - \"assignedToUserId\" -> \"assignedToUser\"\n     */\n    static extractBaseName(resourceFieldIdentifier: string): string {\n        if (!resourceFieldIdentifier) return '';\n        \n        if (resourceFieldIdentifier.endsWith('Ids')) {\n            return resourceFieldIdentifier.slice(0, -3);\n        }\n        \n        if (resourceFieldIdentifier.endsWith('Id')) {\n            return resourceFieldIdentifier.slice(0, -2);\n        }\n        \n        return resourceFieldIdentifier;\n    }\n}"]}