@wildo-ai/saas-models 1.0.1 → 1.1.0

package/dist/esm/resources/resources.shared.utils.d.ts

@@ -5,9 +5,11 @@
  * consumers. This includes ID helpers plus runtime relationship activation
  * evaluation.
  */
-import { ChildLifecycleMode } from './child-operations.shared.schemas.js';
-import { CoreResourceOperation, type ResourceType } from './resources.shared.core.definitions.js';
-import { RelationshipNature, ResourceRelationshipBulkAction, ResourceIdFormat, type ResolvedRelationshipNatureCalculationMode, type ResolvedRelationshipSemantics, type ResourceRelationship, type ResourceRelationshipDeclaration, type ResourceRelationshipCardinality } from './resources.shared.schemas.js';
+import { ChildLifecycleMode, ChildLifecycleStrategy } from './child-operations.shared.schemas';
+import { CoreResourceOperation, type ResourceType } from './resources.shared.core.definitions';
+import { RelationshipNature, ResourceRelationshipBulkAction, ResourceIdFormat, type ResolvedRelationshipNatureCalculationMode, type ResolvedRelationshipSemantics, type ResourceRelationship, type ResourceRelationshipDeclaration, type ResourceRelationshipCardinality, type ResourcePrimaryScope, type ManyToManyScopeJunction, type ManyToManyScopeJunctionMap } from './resources.shared.schemas';
+import type { PolymorphicFkVariant } from '@wildo-ai/zod-decorators';
+import type { z } from 'zod';
 export type RelationshipActivationConditionErrorMode = 'throw' | 'exclude';
 export type RelationshipActivationMissingParentMode = 'include' | 'exclude';
 export interface RelationshipActivationEvaluationOptions {
@@ -47,6 +49,13 @@ export type RelationshipResourcePerspective = 'resourceType1' | 'resourceType2';
  * Used across the entire stack for ID validation and format detection.
  */
 export declare class Resources_SharedUtils {
+    private static readonly GENERATED_FILE_REGENERATE_OPERATION_PREFIX;
+    /**
+     * Namespace for the derived export companion of a LIST/SEARCH operation. Prefixed, like its
+     * sibling above, so a derived identifier can never collide with an authored custom operation and a
+     * reader can tell at a glance that nobody wrote it by hand.
+     */
+    private static readonly GENERATED_COLLECTION_EXPORT_OPERATION_PREFIX;
     private static createConfigurationError;
     private static areResolvedRelationshipSemanticsEquivalent;
     private static hasValidResolvedRelationshipSemantics;
@@ -129,6 +138,31 @@ export declare class Resources_SharedUtils {
      * Resources_SharedUtils.isValidResourceIdForFormat('507f1f77bcf86cd799439011', ResourceIdFormat.UUID) // false
      */
     static isValidResourceIdForFormat(id: string, format: ResourceIdFormat): boolean;
+    /**
+     * Lexical shape of an `HTTP_API`-backed resource's synthesized id — the codec charset law.
+     *
+     * Deliberately NOT consulted by {@link detectIdFormat} / {@link isValidResourceId}: every
+     * ObjectId and UUID also matches this charset, so lexical detection cannot distinguish the
+     * formats, and widening the generic validators would silently relax id validation for every
+     * PLATFORM-backed resource. This predicate participates only where the resource is already
+     * known to be HTTP_API-backed (`ResourceIdBackendService.getFormatForResource` resolves that
+     * from the registry). Canonicality (one row, one id) is enforced by the codec's decode, not
+     * here — this is shape admission, not decode.
+     */
+    static isHttpApiSynthesizedId(id: string): boolean;
+    /**
+     * Lexical shape of an `INTROSPECTION`-backed resource's id.
+     *
+     * The SAME charset law as its HTTP-API sibling — URL-unreserved characters — reused rather than
+     * restated so the two cannot drift into disagreeing about what a URL-safe key is. The predicates
+     * stay separate because the FORMATS are separate: a caller asks "is this a valid id for THIS
+     * resource", and answering through the sibling's name would make the next reader think an
+     * introspected row had been through the HTTP-API codec.
+     *
+     * Carries the same exclusion: not consulted by {@link isValidResourceId}, so no platform-backed
+     * row is loosened by its existence.
+     */
+    static isIntrospectionSynthesizedId(id: string): boolean;
     /**
      * Asserts that a value is a valid resource ID, throwing an error if not
      * @param id - Value to validate
@@ -144,12 +178,41 @@ export declare class Resources_SharedUtils {
      * Resolve the relationship identifier field used to expose nested/context
      * object names to framework consumers.
      *
-     * Priority:
-     * 1. explicit `foreignKeyField`
-     * 2. related resource default field identifier from `allResourceFieldIdentifiers`
-     * 3. fallback to naming convention from the related resource type
+     * Naming follows the FK-anchor / FK-target distinction:
+     *
+     *   - `foreignKeyField` lives on `resourceType2` (the FK-anchor side) and
+     *     semantically identifies `resourceType1` (the FK-target side).
+     *     `'assignedToUserId'` on a `tasks` row identifies the assigned-to user;
+     *     `'userId'` on an `organizationMembers` row identifies the user it
+     *     belongs to.
+     *
+     *   - When the caller is naming the **FK-target side** (i.e.
+     *     `relatedResourceType === resourceType1`), the FK is the semantic name
+     *     carrier — e.g. `'assignedToUser'` falls out of `'assignedToUserId'`.
+     *     Using the FK preserves multi-edge differentiation when several FKs
+     *     point to the same parent type (createdBy / assignedTo / reviewer all
+     *     resolve to distinct field names).
+     *
+     *   - When the caller is naming the **FK-anchor side** (i.e.
+     *     `relatedResourceType === resourceType2`), the FK is *not* a name for
+     *     this side — it names the OTHER side. Using it produces a wrong
+     *     parent-flavoured name on the child field (e.g. `userId` would yield
+     *     `'users'` instead of `'organizationMembers'`). The correct name is
+     *     derived from the related resource type itself.
+     *
+     *   - Self-references (`resourceType1 === resourceType2`) always use the FK
+     *     for semantic differentiation (`parentDocumentId` → `'parentDocument'`
+     *     vs `childDocumentId` → `'childDocument'`).
+     *
+     * Population (`fetchChildResourcesWithPolicy` /
+     * `populateForContext`) keys child collections directly off
+     * `resourceType2` with optional singularization for 1:1 — which is
+     * structurally equivalent to the FK-anchor-side branch below. Keeping the
+     * two sites aligned is what unblocks context-mode response fields like
+     * `organizationMembers`, `userSelfProfile`, `userSelfPreference` from being
+     * silently Zod-stripped on the way out the controller.
      */
-    static resolveRelationshipObjectIdentity(relationship: Pick<ResourceRelationship, 'foreignKeyField'>, relatedResourceType: ResourceType, cardinality: ResourceRelationshipCardinality, allResourceFieldIdentifiers: Partial<Record<ResourceType, string>> | Record<string, string>): ResolvedRelationshipObjectIdentity;
+    static resolveRelationshipObjectIdentity(relationship: Pick<ResourceRelationship, 'foreignKeyField' | 'resourceType1' | 'resourceType2'>, relatedResourceType: ResourceType, cardinality: ResourceRelationshipCardinality, allResourceFieldIdentifiers: Partial<Record<ResourceType, string>> | Record<string, string>): ResolvedRelationshipObjectIdentity;
     /**
      * Resolve the relationship object identity from the perspective of one of the
      * relationship's two resource types.
@@ -160,6 +223,227 @@ export declare class Resources_SharedUtils {
      */
     static resolveRelationshipObjectIdentityForResource(relationship: Pick<ResourceRelationship, 'resourceType1' | 'resourceType2' | 'cardinality1' | 'cardinality2' | 'foreignKeyField'>, currentResourceType: ResourceType, allResourceFieldIdentifiers: Partial<Record<ResourceType, string>> | Record<string, string>): ResolvedRelationshipObjectIdentity;
     static getRelationshipPerspectiveForResource(relationship: Pick<ResourceRelationship, 'resourceType1' | 'resourceType2'>, currentResourceType: ResourceType): RelationshipResourcePerspective | undefined;
+    /**
+     * Resolve which resource a foreign-key relationship REFERENCES (the target),
+     * vs which resource HOLDS the FK column (the holder).
+     *
+     * The registry's `fieldIdentifierToResourceType` must map a foreign-key field
+     * to the resource it **references** (`assignedToUserId → users`,
+     * `createdByUserId → users`) so reference pickers, FK display links, and
+     * `resolveResourceTypeForForeignKey` all resolve the referenced resource — NOT
+     * the resource that stores the column.
+     *
+     * `resourceType1` / `resourceType2` order is author-declaration dependent and
+     * is therefore NOT a reliable target signal: a child-first declaration like
+     * `createResourcesRelationship(TODOS, USERS, MANY, ONE, { foreignKeyField:
+     * 'assignedToUserId' })` stores `rt1 = todos` (the HOLDER), `rt2 = users` (the
+     * target). Mapping the FK to `resourceType1` (the historical behavior) yields
+     * `assignedToUserId → todos`, which sends a user-reference picker to search
+     * todos and links FK values to the wrong resource.
+     *
+     * Ground truth = **schema membership**: the FK column is declared on exactly
+     * one of the two resources (the holder); the other side is the referenced
+     * target. The loop that builds the map only processes explicit
+     * `foreignKeyField`s, which are always real columns on their holder's schema,
+     * so membership resolves every real case (N:1, 1:N, 1:1) regardless of
+     * declaration order. `allResourceFieldIdentifiers` standard-id equality is a
+     * belt-and-suspenders fallback for callers that cannot introspect schemas.
+     *
+     * @param relationship the FK relationship (must carry `foreignKeyField`)
+     * @param context.allResourceFieldIdentifiers resourceType → its standard id field
+     * @param context.schemaDeclaresField `(resourceType, field) => true` iff the
+     *        resource's OWN main schema declares `field` as a column (it HOLDS the FK)
+     */
+    static resolveForeignKeyReferencedResourceType(relationship: Pick<ResourceRelationship, 'resourceType1' | 'resourceType2' | 'foreignKeyField'>, context: {
+        allResourceFieldIdentifiers: Record<string, string>;
+        schemaDeclaresField: (resourceType: string, fieldName: string) => boolean;
+    }): {
+        referencedResourceType: string;
+        holderResourceType: string;
+    };
+    /**
+     * Build the registry's `fieldIdentifierToResourceType` reverse map — THE ONE
+     * implementation.
+     *
+     * This logic existed as two hand-kept copies (the backend registry service
+     * and the frontend resources repository) plus was about to grow a third for
+     * the app-creation FK-resolution verification check — exactly the
+     * security-predicate-drift shape `two-buildcontextualfilter-implementations`
+     * records. Every consumer now routes through here; a semantic change to FK
+     * resolution lands once.
+     *
+     * Semantics (unchanged from the two copies it replaces):
+     * 1. Seed from standard field identifiers (`userId → USERS`), tracking
+     *    identifiers SHARED by several resource types (USERS / USER_SELF).
+     * 2. Enrich with every relationship's explicit `foreignKeyField`, mapped to
+     *    the resource it REFERENCES (resolved structurally via schema
+     *    membership — declaration-order independent, see
+     *    {@link resolveForeignKeyReferencedResourceType}). Shared-identifier
+     *    convergence and per-record discriminated polymorphic FKs are tolerated;
+     *    a genuine same-name-different-target clash is reported through
+     *    `onForeignKeyCollision` (log, never throw — an authoring slip must not
+     *    crash registry boot) and the FIRST mapping is kept.
+     * 3. Canonical-priority pass for shared identifiers
+     *    (`coreResourceShared_FieldIdentifierPriority`), so the winner is policy,
+     *    not iteration order.
+     */
+    static buildFieldIdentifierToResourceTypeMap(input: {
+        allResourceFieldIdentifiers: Record<string, string>;
+        allResourceRelationships: ReadonlyArray<ResourceRelationship>;
+        /** resourceType → its materialized main schema (used for holder resolution + polymorphic tolerance). */
+        getMainSchema: (resourceType: string) => z.ZodTypeAny | undefined;
+        /** resourceType → canonical priority for SHARED standard identifiers. */
+        fieldIdentifierPriority: Record<string, string>;
+        onForeignKeyCollision?: (collision: {
+            foreignKeyField: string;
+            existingType: string;
+            referencedResourceType: string;
+        }) => void;
+    }): Record<string, string>;
+    /**
+     * The FK-resolution SWEEP: every schema field carrying `.isForeignKey()` that
+     * the map above cannot resolve to a resource type.
+     *
+     * This is the exact eager check the frontend registry runs at
+     * initialization (where an unresolved field is `frontend_fk_resolution_failed`
+     * and, in development, refuses the whole app). Exposed here so the
+     * app-creation verification lane can run the SAME sweep headless — after a
+     * compose or a coding mutation — instead of the defect surfacing in the
+     * builder's browser (wonder-crm, 2026-08-27: three composed resources carried
+     * a decorated `createdByUserId` with no relationship edge; typecheck and the
+     * backend boot were both green).
+     */
+    static collectUnresolvableForeignKeyFields(input: {
+        /** resourceType → materialized main schema. */
+        mainSchemasByResourceType: Record<string, z.ZodTypeAny | undefined>;
+        fieldIdentifierToResourceType: Record<string, string>;
+    }): Array<{
+        resourceType: string;
+        fieldName: string;
+    }>;
+    /**
+     * Resolve which side of a foreign-key relationship HOLDS the FK column, from
+     * cardinality topology alone — no registry / schema access required.
+     *
+     * The FK column physically lives on the collection side of a 1:N / N:1
+     * relationship: each of the "many" rows carries one reference to its "one"
+     * counterpart. Declaration order is an authoring convenience — parent-first
+     * `(ORGANIZATIONS, TODOS, ONE, MANY)` and child-first
+     * `(TODOS, USERS, MANY, ONE, { foreignKeyField: 'assignedToUserId' })` are
+     * both valid — so positional `resourceType2` reads are NOT a holder signal
+     * (see {@link resolveForeignKeyReferencedResourceType}, the schema-membership
+     * variant of the same invariant used where registry schemas are available).
+     *
+     * Resolution rules:
+     * - self-reference (`resourceType1 === resourceType2`) → the resource holds
+     *   its own FK (tree parent ids, self-referencing junction arrays);
+     * - exactly one collection side (`MANY` / `ONE_OR_MANY`) → that side holds;
+     * - 1:1 (no collection side) → `resourceType2`, per the parent-first child
+     *   convention (`resourceType1` = parent, `resourceType2` = child carrying
+     *   the unique FK — e.g. context-addressed composition singletons);
+     * - both sides collections (M:N) only carries a `foreignKeyField`
+     *   self-referentially (guarded at declaration time), which the
+     *   self-reference rule already covers; the defensive fallback stays
+     *   `resourceType2`.
+     */
+    static resolveForeignKeyHolderResourceType(relationship: Pick<ResourceRelationshipDeclaration, 'resourceType1' | 'resourceType2' | 'cardinality1' | 'cardinality2'>): ResourceType;
+    /**
+     * Collect the candidate referenced resource types for a SHARED foreign-key
+     * field on a given holder — every resource the holder's `foreignKeyField` can
+     * point at, gathered from the registered relationships.
+     *
+     * Used to enumerate the branches of a per-record discriminated polymorphic FK
+     * (e.g. referrals' `referrerBillingAccountId` → [`userBillingAccounts`,
+     * `organizationBillingAccounts`]). The holder DECLARES the FK column, so the
+     * referenced side of each matching relationship is the side that is NOT the
+     * holder.
+     */
+    static getForeignKeyCandidateReferencedTypes(foreignKeyField: string, holderResourceType: string, relationships: ReadonlyArray<Pick<ResourceRelationship, 'resourceType1' | 'resourceType2' | 'foreignKeyField'>>): string[];
+    /**
+     * Resolve the concrete branch a per-record DISCRIMINATED polymorphic FK points
+     * at, for a specific holder record.
+     *
+     * A flat resource (e.g. `referrals`) may hold ONE shared FK column
+     * (`referrerBillingAccountId`) that targets a polymorphic branch GROUP
+     * (`billingAccounts` → `userBillingAccounts` | `organizationBillingAccounts`).
+     * Which branch a given record points at is decided by a sibling discriminator
+     * field on the SAME record (`referrerScopeType`).
+     *
+     * Resolution rides the scope axis the polymorphic system is already built on
+     * — there is NO bespoke value→target map:
+     *  1. Read the discriminator value off the record.
+     *  2. Find the {@link PolymorphicFkVariant} whose `discriminatorValue` matches —
+     *     this yields the variant's scope-root `parentResourceType` (e.g.
+     *     `'organizations'`).
+     *  3. Return the candidate branch whose `resourcePrimaryScope`, mapped back to
+     *     its scope root via `PRIMARY_SCOPE_TO_CORE_RESOURCE_TYPE`, equals that
+     *     `parentResourceType`.
+     *
+     * Returns `undefined` (caller degrades to the registry's non-authoritative
+     * representative) when the discriminator value is absent/unknown or no
+     * candidate branch matches the variant's scope.
+     *
+     * @param context.record the holder record (must carry the discriminator field)
+     * @param context.discriminatorField sibling field naming the branch selector
+     * @param context.variants the FK's polymorphic variants (each with `discriminatorValue`)
+     * @param context.candidateReferencedTypes branches from
+     *        {@link getForeignKeyCandidateReferencedTypes}
+     * @param context.getResourcePrimaryScope `(rt) => its primary scope` (registry lookup)
+     */
+    static resolveDiscriminatedPolymorphicForeignKeyTarget(context: {
+        record: Record<string, unknown>;
+        discriminatorField: string;
+        variants: ReadonlyArray<PolymorphicFkVariant>;
+        candidateReferencedTypes: ReadonlyArray<string>;
+        getResourcePrimaryScope: (resourceType: string) => ResourcePrimaryScope | undefined;
+    }): string | undefined;
+    /**
+     * Stable key for {@link ManyToManyScopeJunctionMap}: a `(target, scope)` pair.
+     * Uses a `|` separator, which cannot appear in resource-type identifiers, so
+     * `(a, b|c)` and `(a|b, c)` can never collide.
+     */
+    static manyToManyScopeJunctionKey(targetResourceType: string, scopeResourceType: string): string;
+    /**
+     * Derive the {@link ManyToManyScopeJunctionMap} from the registered
+     * relationships — the registry signal that powers inference-based scope-required
+     * reference search (see `.claude/plans/fk-filter-reference-search.md`).
+     *
+     * For every MANY-to-MANY relationship (one carrying a `jointResourceType` whose
+     * two sides are the PEERS, not the junction itself), both orderings are
+     * recorded: either peer may be the search TARGET with the other as the SCOPE.
+     * The junction's per-peer FK columns are resolved by convention as each peer's
+     * `resourceFieldIdentifier` (e.g. `organizationMembers` carries `userId` /
+     * `organizationId`).
+     *
+     * Robust to being called on raw OR post-expansion relationships: synthetic
+     * `peer → junction` edges (which also carry `jointResourceType`) are excluded
+     * because one of their sides IS the junction.
+     *
+     * Q4 (fail-closed): if two DISTINCT junctions relate the same `(target, scope)`
+     * pair, throws a configuration error — a scope-required search cannot
+     * deterministically choose a junction. No such case exists in core today
+     * (`organizations ↔ users via organizationMembers` is the only M:N).
+     *
+     * @param relationships the registered relationships (compiled or raw)
+     * @param allResourceFieldIdentifiers `resourceType → its standard id field`
+     */
+    static buildManyToManyScopeJunctionMap(relationships: ReadonlyArray<Pick<ResourceRelationship, 'resourceType1' | 'resourceType2' | 'jointResourceType'>>, allResourceFieldIdentifiers: Record<string, string>): ManyToManyScopeJunctionMap;
+    /**
+     * Resolve the M:N scope junction to use for a **scope-required reference
+     * search** of `targetResourceType`, given the scope parameters available in
+     * the current context (e.g. a people-picker on a task filter has the caller's
+     * `organizationId` injected by the app scope).
+     *
+     * Returns the junction for the first `(target, scope)` entry whose
+     * `scopeFkField` is present in `availableContextFields` — i.e. "search this
+     * target scoped through the junction to the scope the caller is already in".
+     * Returns `undefined` when the target has no M:N junction reachable from the
+     * available context, meaning the picker should do a plain unscoped target
+     * search. This is the registry-inference that drives scope-required reference
+     * search on the frontend (see `.claude/plans/fk-filter-reference-search.md`) —
+     * no per-field declaration needed.
+     */
+    static findScopeJunctionForTargetInContext(manyToManyScopeJunctions: ManyToManyScopeJunctionMap, targetResourceType: string, availableContextFields: ReadonlySet<string>): ManyToManyScopeJunction | undefined;
     /**
      * Build the generated custom-operation identifier used to expose explicit bulk
      * relationship actions at the resource-operation layer.
@@ -173,6 +457,18 @@ export declare class Resources_SharedUtils {
         action: ResourceRelationshipBulkAction;
         relationshipField: string;
     } | undefined;
+    static buildGeneratedFileRegenerateOperationIdentifier(fieldName: string): string;
+    static parseGeneratedFileRegenerateOperationIdentifier(operationIdentifier: string): {
+        fieldName: string;
+    } | undefined;
+    /**
+     * Identifier of the export companion of `sourceOperationIdentifier`
+     * (e.g. `collectionExport:list`, `collectionExport:mySearchVariant`).
+     */
+    static buildGeneratedCollectionExportOperationIdentifier(sourceOperationIdentifier: string): string;
+    static parseGeneratedCollectionExportOperationIdentifier(operationIdentifier: string): {
+        sourceOperationIdentifier: string;
+    } | undefined;
     /**
      * Resolve the FK field identity for a relationship.
      *
@@ -226,7 +522,7 @@ export declare class Resources_SharedUtils {
      * where the framework derives the deeper internal handling contract and the
      * effective low-level `childOperations` shape consumed today.
      */
-    static resolveRelationshipSemantics(relationship: Pick<ResourceRelationshipDeclaration, 'nature' | 'jointResourceType' | 'childOperations' | 'read'>): ResolvedRelationshipSemantics;
+    static resolveRelationshipSemantics(relationship: Pick<ResourceRelationshipDeclaration, 'resourceType1' | 'resourceType2' | 'nature' | 'jointResourceType' | 'childOperations' | 'read' | 'foreignKeyField' | 'parentResourceRequirement' | 'cardinality1' | 'cardinality2'>, allResourceFieldIdentifiers?: Partial<Record<ResourceType, string>> | Record<string, string>): ResolvedRelationshipSemantics;
     /**
      * Resolve the effective nested mutation projection for the given operation.
      *
@@ -246,9 +542,9 @@ export declare class Resources_SharedUtils {
      * comes from the current operational projection.
      */
     static resolveRelationshipNestedReadConfig(relationship: ResourceRelationship): {
-        dataMode: import("./resources-config.shared.schemas.js").DataMode;
+        dataMode: import("./resources-config.shared.schemas").DataMode;
         enabledOnList: boolean;
-        listDataMode: import("./resources-config.shared.schemas.js").DataMode;
+        listDataMode: import("./resources-config.shared.schemas").DataMode;
         maxDepth: number;
         maxItems?: number;
         sortBy?: string;
@@ -262,13 +558,30 @@ export declare class Resources_SharedUtils {
     static resolveRelationshipLifecycleOnParentDeleteConfig(relationship: ResourceRelationship): {
         enabled: boolean;
         mode: ChildLifecycleMode;
+        strategy: ChildLifecycleStrategy;
+        maxDepth: number;
+    };
+    /**
+     * Resolve the effective lifecycle-on-parent-create projection — the eager
+     * composition-child seeding policy. Mirror of
+     * {@link resolveRelationshipLifecycleOnParentDeleteConfig}: `lifecycleModelMode`
+     * is the semantic gate (INDEPENDENT / aggregation → no eager seed), and the
+     * detailed create policy comes from the operational
+     * `childOperations.lifecycle.onParentCreate` projection.
+     */
+    static resolveRelationshipLifecycleOnParentCreateConfig(relationship: ResourceRelationship): {
+        enabled: boolean;
+        mode: import("./child-operations.shared.schemas").CompositionSeedMode.POST_COMMIT;
         maxDepth: number;
+        initialData?: {
+            override?: (ctx: import("./child-operations.shared.schemas").CompositionCreateContext) => Record<string, unknown> | undefined;
+        };
     };
     /**
      * Compile the developer-authored declaration into the runtime relationship
      * shape used by the framework.
      */
-    static compileRelationshipDeclaration(relationship: ResourceRelationshipDeclaration): ResourceRelationship;
+    static compileRelationshipDeclaration(relationship: ResourceRelationshipDeclaration, allResourceFieldIdentifiers?: Partial<Record<ResourceType, string>> | Record<string, string>): ResourceRelationship;
     /**
      * Ensure a relationship is in the compiled runtime shape.
      *
@@ -276,8 +589,17 @@ export declare class Resources_SharedUtils {
      * relationships from multiple sources before they are stored on registries or
      * resource configurations.
      */
-    static ensureCompiledRelationship(relationship: ResourceRelationship | ResourceRelationshipDeclaration): ResourceRelationship;
-    static ensureCompiledRelationships(relationships: readonly (ResourceRelationship | ResourceRelationshipDeclaration)[]): ResourceRelationship[];
+    static ensureCompiledRelationship(relationship: ResourceRelationship | ResourceRelationshipDeclaration, allResourceFieldIdentifiers?: Partial<Record<ResourceType, string>> | Record<string, string>): ResourceRelationship;
+    static ensureCompiledRelationships(relationships: readonly (ResourceRelationship | ResourceRelationshipDeclaration)[], allResourceFieldIdentifiers?: Partial<Record<ResourceType, string>> | Record<string, string>): ResourceRelationship[];
+    static ensureCompiledRelationshipBuckets<TResourceRelationships extends {
+        parentRelationships: readonly (ResourceRelationship | ResourceRelationshipDeclaration)[];
+        childRelationships: readonly (ResourceRelationship | ResourceRelationshipDeclaration)[];
+        selfRelationships: readonly (ResourceRelationship | ResourceRelationshipDeclaration)[];
+    }>(resourceRelationships: TResourceRelationships, allResourceFieldIdentifiers?: Partial<Record<ResourceType, string>> | Record<string, string>): {
+        parentRelationships: ResourceRelationship[];
+        childRelationships: ResourceRelationship[];
+        selfRelationships: ResourceRelationship[];
+    };
     /**
      * Strict runtime reader for already-compiled relationships.
      *
@@ -289,7 +611,7 @@ export declare class Resources_SharedUtils {
      * Read the stored runtime semantics when present. This keeps current call
      * sites resilient while Step 3 finishes converging on fully compiled edges.
      */
-    static getResolvedRelationshipSemantics(relationship: Pick<ResourceRelationship | ResourceRelationshipDeclaration, 'nature' | 'jointResourceType' | 'childOperations' | 'read'> & Partial<Pick<ResourceRelationship, 'resolvedSemantics'>>): ResolvedRelationshipSemantics;
+    static getResolvedRelationshipSemantics(relationship: Pick<ResourceRelationship | ResourceRelationshipDeclaration, 'resourceType1' | 'resourceType2' | 'nature' | 'jointResourceType' | 'childOperations' | 'read' | 'foreignKeyField' | 'parentResourceRequirement' | 'cardinality1' | 'cardinality2'> & Partial<Pick<ResourceRelationship, 'resolvedSemantics'>>): ResolvedRelationshipSemantics;
     /**
      * Derive the engine-facing handling contract from the authored relationship
      * semantics plus low-level nested/lifecycle settings.
@@ -313,6 +635,32 @@ export declare class Resources_SharedUtils {
      *   shortcut to explain its meaning
      */
     private static deriveRelationshipHandlingContract;
+    /**
+     * Derive runtime persistence behavior from the authored relationship topology.
+     *
+     * The declaration remains small: developers author cardinality, parent
+     * requirement, nature, and the FK field when disambiguation is needed. The
+     * framework compiles the persistence consequence here so storage adapters do
+     * not reinterpret relationship meaning independently.
+     *
+     * The contract is expressed from the HOLDER's perspective
+     * ({@link resolveForeignKeyHolderResourceType} — the side whose rows carry
+     * the FK column, resolved from cardinality, never from declaration order):
+     * - `holderResourceType` tells storage adapters WHICH resource the contract
+     *   applies to — an adapter building any other resource of the relationship
+     *   must not materialize or validate this FK there;
+     * - `required` means the holder's FK column is non-nullable (the referenced
+     *   parent is mandatory for every holder row);
+     * - `unique` means at most one holder row per referenced row, which is true
+     *   exactly when the relationship is a genuine 1:1 — BOTH sides
+     *   single-valued. Keying uniqueness off `cardinality2` alone (the previous
+     *   derivation) assumed parent-first declaration order: for child-first
+     *   N:1 references (`(TODOS, USERS, MANY, ONE)`) and self-referencing trees
+     *   (`(UNITS, UNITS, ONE, MANY)`) a single positional cardinality is ONE
+     *   while the relationship is not 1:1, which would emit a bogus unique
+     *   index on a shared FK.
+     */
+    private static deriveRelationshipPersistenceContract;
     private static assertRelationshipSemanticsCoherence;
     /**
      * M:N expansion is only safe when the declaration maps to one unambiguous edge

package/dist/esm/resources/resources.shared.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resources.shared.utils.d.ts","sourceRoot":"","sources":["../../../src/resources/resources.shared.utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"resources.shared.utils.d.ts","sourceRoot":"","sources":["../../../../src/resources/resources.shared.utils.ts"],"names":[],"mappings":"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"}