@wildo-ai/saas-models 1.0.1

package/dist/esm/resources/utils/resource-polymorphism.schemas.js.map

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

package/dist/esm/resources/utils/resource-polymorphism.utils.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Resource Polymorphism Utils
+ *
+ * Naming derivation utilities for polymorphic resource expansion.
+ * Given a base resource type and a list of parent variants, derives all
+ * identifiers (resource type, field identifier, enum key, collection name,
+ * route segment) for each variant.
+ *
+ * This is a "developer interface only" mechanism: the engine expands
+ * a single polymorphic declaration into N concrete, fully standard resources
+ * at factory time. Zero runtime polymorphism.
+ *
+ * Works for ANY parent resource type — not tied to ResourcePrimaryScope.
+ * The prefix is always derived from the parent's field identifier via
+ * ResourcesConfigNamingUtils.extractBaseName().
+ *
+ * @see polymorphic-scope-approach-A-expansion.md
+ */
+import type { ResourceType } from '../resources.shared.core.definitions.js';
+/**
+ * Defines a single parent variant for polymorphic expansion.
+ */
+export interface PolymorphicParentVariantDefinition {
+    /** The parent resource type (e.g., CoreResourceType.ORGANIZATIONS) */
+    parentResourceType: ResourceType;
+    /** The parent's field identifier (e.g., 'organizationId') */
+    parentFieldIdentifier: string;
+}
+/**
+ * Full naming kit for a single derived polymorphic variant.
+ * All values are deterministically derived from the parent field identifier
+ * and the base resource identifiers — nothing is hardcoded.
+ */
+export interface PolymorphicVariantNaming {
+    /** The parent resource type this variant is parented to */
+    parentResourceType: ResourceType;
+    /** The parent's field identifier (e.g., 'organizationId') */
+    parentFieldIdentifier: string;
+    /** Derived variant resource type (e.g., 'organizationBillingAccounts') */
+    resourceType: string;
+    /** Derived variant field identifier (e.g., 'organizationBillingAccountId') */
+    fieldIdentifier: string;
+    /** Derived collection/table name — same as resourceType (e.g., 'organizationBillingAccounts') */
+    collectionName: string;
+    /** Derived kebab-case route segment (e.g., 'organization-billing-accounts') */
+    routeSegment: string;
+    /** Derived CONSTANT_CASE enum key (e.g., 'ORGANIZATION_BILLING_ACCOUNTS') */
+    enumKey: string;
+}
+export declare class ResourcePolymorphismUtils {
+    /**
+     * Derive the variant prefix from a parent resource's field identifier.
+     * NOT tied to ResourcePrimaryScope — works for ANY parent resource.
+     *
+     * Uses ResourcesConfigNamingUtils.extractBaseName() — the canonical function
+     * for stripping 'Id'/'Ids' suffix from field identifiers.
+     *
+     * @example
+     *   'organizationId'    → 'organization'
+     *   'userId'            → 'user'
+     *   'applicationId'     → 'application'
+     *   'projectId'         → 'project'
+     *   'teamId'            → 'team'
+     */
+    static getVariantPrefix(parentFieldIdentifier: string): string;
+    /**
+     * Derive variant resource type from parent field identifier + base resource type.
+     * Result is camelCase: prefix (from parent) + PascalCase(baseResourceType).
+     *
+     * @example (base = 'billingAccounts')
+     *   'organizationId' → 'organizationBillingAccounts'
+     *   'userId'         → 'userBillingAccounts'
+     *   'projectId'      → 'projectBillingAccounts'
+     */
+    static deriveVariantResourceType(parentFieldIdentifier: string, baseResourceType: string): string;
+    /**
+     * Derive variant field identifier (FK name) from parent field identifier + base field identifier.
+     * Result is camelCase: prefix (from parent) + PascalCase(baseFieldIdentifier).
+     *
+     * @example (base = 'billingAccountId')
+     *   'organizationId' → 'organizationBillingAccountId'
+     *   'userId'         → 'userBillingAccountId'
+     */
+    static deriveVariantFieldIdentifier(parentFieldIdentifier: string, baseFieldIdentifier: string): string;
+    /**
+     * Derive variant CONSTANT_CASE enum key from parent field identifier + base enum key.
+     *
+     * @example (base = 'BILLING_ACCOUNTS')
+     *   'organizationId' → 'ORGANIZATION_BILLING_ACCOUNTS'
+     *   'userId'         → 'USER_BILLING_ACCOUNTS'
+     */
+    static deriveVariantEnumKey(parentFieldIdentifier: string, baseEnumKey: string): string;
+    /**
+     * Get the full naming kit for all variants of a base resource type.
+     * Returns one PolymorphicVariantNaming per parent variant definition.
+     * All values are deterministically derived — nothing is hardcoded.
+     *
+     * @param baseResourceType   - The base resource type (e.g., 'billingAccounts')
+     * @param baseFieldIdentifier - The base field identifier (e.g., 'billingAccountId')
+     * @param baseEnumKey         - The base CONSTANT_CASE enum key (e.g., 'BILLING_ACCOUNTS')
+     * @param parentVariants      - Array of parent variant definitions
+     *
+     * @example
+     *   getVariants('billingAccounts', 'billingAccountId', 'BILLING_ACCOUNTS', [
+     *     { parentResourceType: 'organizations', parentFieldIdentifier: 'organizationId' },
+     *     { parentResourceType: 'users',         parentFieldIdentifier: 'userId' },
+     *   ])
+     *   // →
+     *   // [
+     *   //   { resourceType: 'organizationBillingAccounts', fieldIdentifier: 'organizationBillingAccountId',
+     *   //     collectionName: 'organizationBillingAccounts', routeSegment: 'organization-billing-accounts',
+     *   //     enumKey: 'ORGANIZATION_BILLING_ACCOUNTS', ... },
+     *   //   { resourceType: 'userBillingAccounts', fieldIdentifier: 'userBillingAccountId',
+     *   //     collectionName: 'userBillingAccounts', routeSegment: 'user-billing-accounts',
+     *   //     enumKey: 'USER_BILLING_ACCOUNTS', ... },
+     *   // ]
+     */
+    static getVariants(baseResourceType: string, baseFieldIdentifier: string, baseEnumKey: string, parentVariants: PolymorphicParentVariantDefinition[]): PolymorphicVariantNaming[];
+}
+//# sourceMappingURL=resource-polymorphism.utils.d.ts.map

package/dist/esm/resources/utils/resource-polymorphism.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-polymorphism.utils.d.ts","sourceRoot":"","sources":["../../../../src/resources/utils/resource-polymorphism.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAMzE;;GAEG;AACH,MAAM,WAAW,kCAAkC;IACjD,sEAAsE;IACtE,kBAAkB,EAAE,YAAY,CAAC;IACjC,6DAA6D;IAC7D,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,2DAA2D;IAC3D,kBAAkB,EAAE,YAAY,CAAC;IACjC,6DAA6D;IAC7D,qBAAqB,EAAE,MAAM,CAAC;IAC9B,0EAA0E;IAC1E,YAAY,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,eAAe,EAAE,MAAM,CAAC;IACxB,iGAAiG;IACjG,cAAc,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,YAAY,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,qBAAa,yBAAyB;IAEpC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,gBAAgB,CAAC,qBAAqB,EAAE,MAAM,GAAG,MAAM;IAI9D;;;;;;;;OAQG;IACH,MAAM,CAAC,yBAAyB,CAAC,qBAAqB,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM;IAMjG;;;;;;;OAOG;IACH,MAAM,CAAC,4BAA4B,CAAC,qBAAqB,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,GAAG,MAAM;IAMvG;;;;;;OAMG;IACH,MAAM,CAAC,oBAAoB,CAAC,qBAAqB,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IAMvF;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,MAAM,CAAC,WAAW,CAChB,gBAAgB,EAAE,MAAM,EACxB,mBAAmB,EAAE,MAAM,EAC3B,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,kCAAkC,EAAE,GACnD,wBAAwB,EAAE;CAgB9B"}

package/dist/esm/resources/utils/resource-polymorphism.utils.js

@@ -0,0 +1,122 @@
+/**
+ * Resource Polymorphism Utils
+ *
+ * Naming derivation utilities for polymorphic resource expansion.
+ * Given a base resource type and a list of parent variants, derives all
+ * identifiers (resource type, field identifier, enum key, collection name,
+ * route segment) for each variant.
+ *
+ * This is a "developer interface only" mechanism: the engine expands
+ * a single polymorphic declaration into N concrete, fully standard resources
+ * at factory time. Zero runtime polymorphism.
+ *
+ * Works for ANY parent resource type — not tied to ResourcePrimaryScope.
+ * The prefix is always derived from the parent's field identifier via
+ * ResourcesConfigNamingUtils.extractBaseName().
+ *
+ * @see polymorphic-scope-approach-A-expansion.md
+ */
+import { ResourcesConfigNamingUtils } from './resources-config-naming.utils.js';
+// =============================================================================
+// UTILS
+// =============================================================================
+export class ResourcePolymorphismUtils {
+    /**
+     * Derive the variant prefix from a parent resource's field identifier.
+     * NOT tied to ResourcePrimaryScope — works for ANY parent resource.
+     *
+     * Uses ResourcesConfigNamingUtils.extractBaseName() — the canonical function
+     * for stripping 'Id'/'Ids' suffix from field identifiers.
+     *
+     * @example
+     *   'organizationId'    → 'organization'
+     *   'userId'            → 'user'
+     *   'applicationId'     → 'application'
+     *   'projectId'         → 'project'
+     *   'teamId'            → 'team'
+     */
+    static getVariantPrefix(parentFieldIdentifier) {
+        return ResourcesConfigNamingUtils.extractBaseName(parentFieldIdentifier);
+    }
+    /**
+     * Derive variant resource type from parent field identifier + base resource type.
+     * Result is camelCase: prefix (from parent) + PascalCase(baseResourceType).
+     *
+     * @example (base = 'billingAccounts')
+     *   'organizationId' → 'organizationBillingAccounts'
+     *   'userId'         → 'userBillingAccounts'
+     *   'projectId'      → 'projectBillingAccounts'
+     */
+    static deriveVariantResourceType(parentFieldIdentifier, baseResourceType) {
+        const prefix = this.getVariantPrefix(parentFieldIdentifier);
+        const pascalBase = ResourcesConfigNamingUtils.toPascalCase(baseResourceType);
+        return prefix + pascalBase;
+    }
+    /**
+     * Derive variant field identifier (FK name) from parent field identifier + base field identifier.
+     * Result is camelCase: prefix (from parent) + PascalCase(baseFieldIdentifier).
+     *
+     * @example (base = 'billingAccountId')
+     *   'organizationId' → 'organizationBillingAccountId'
+     *   'userId'         → 'userBillingAccountId'
+     */
+    static deriveVariantFieldIdentifier(parentFieldIdentifier, baseFieldIdentifier) {
+        const prefix = this.getVariantPrefix(parentFieldIdentifier);
+        const pascalBase = ResourcesConfigNamingUtils.toPascalCase(baseFieldIdentifier);
+        return prefix + pascalBase;
+    }
+    /**
+     * Derive variant CONSTANT_CASE enum key from parent field identifier + base enum key.
+     *
+     * @example (base = 'BILLING_ACCOUNTS')
+     *   'organizationId' → 'ORGANIZATION_BILLING_ACCOUNTS'
+     *   'userId'         → 'USER_BILLING_ACCOUNTS'
+     */
+    static deriveVariantEnumKey(parentFieldIdentifier, baseEnumKey) {
+        const prefix = this.getVariantPrefix(parentFieldIdentifier);
+        const constantPrefix = ResourcesConfigNamingUtils.toConstantCase(prefix);
+        return `${constantPrefix}_${baseEnumKey}`;
+    }
+    /**
+     * Get the full naming kit for all variants of a base resource type.
+     * Returns one PolymorphicVariantNaming per parent variant definition.
+     * All values are deterministically derived — nothing is hardcoded.
+     *
+     * @param baseResourceType   - The base resource type (e.g., 'billingAccounts')
+     * @param baseFieldIdentifier - The base field identifier (e.g., 'billingAccountId')
+     * @param baseEnumKey         - The base CONSTANT_CASE enum key (e.g., 'BILLING_ACCOUNTS')
+     * @param parentVariants      - Array of parent variant definitions
+     *
+     * @example
+     *   getVariants('billingAccounts', 'billingAccountId', 'BILLING_ACCOUNTS', [
+     *     { parentResourceType: 'organizations', parentFieldIdentifier: 'organizationId' },
+     *     { parentResourceType: 'users',         parentFieldIdentifier: 'userId' },
+     *   ])
+     *   // →
+     *   // [
+     *   //   { resourceType: 'organizationBillingAccounts', fieldIdentifier: 'organizationBillingAccountId',
+     *   //     collectionName: 'organizationBillingAccounts', routeSegment: 'organization-billing-accounts',
+     *   //     enumKey: 'ORGANIZATION_BILLING_ACCOUNTS', ... },
+     *   //   { resourceType: 'userBillingAccounts', fieldIdentifier: 'userBillingAccountId',
+     *   //     collectionName: 'userBillingAccounts', routeSegment: 'user-billing-accounts',
+     *   //     enumKey: 'USER_BILLING_ACCOUNTS', ... },
+     *   // ]
+     */
+    static getVariants(baseResourceType, baseFieldIdentifier, baseEnumKey, parentVariants) {
+        return parentVariants.map(({ parentResourceType, parentFieldIdentifier }) => {
+            const resourceType = this.deriveVariantResourceType(parentFieldIdentifier, baseResourceType);
+            const fieldIdentifier = this.deriveVariantFieldIdentifier(parentFieldIdentifier, baseFieldIdentifier);
+            const enumKey = this.deriveVariantEnumKey(parentFieldIdentifier, baseEnumKey);
+            return {
+                parentResourceType,
+                parentFieldIdentifier,
+                resourceType,
+                fieldIdentifier,
+                collectionName: resourceType,
+                routeSegment: ResourcesConfigNamingUtils.toKebabCase(resourceType),
+                enumKey,
+            };
+        });
+    }
+}
+//# sourceMappingURL=resource-polymorphism.utils.js.map

package/dist/esm/resources/utils/resource-polymorphism.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-polymorphism.utils.js","sourceRoot":"","sources":["../../../../src/resources/utils/resource-polymorphism.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAuC7E,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF,MAAM,OAAO,yBAAyB;IAEpC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,gBAAgB,CAAC,qBAA6B;QACnD,OAAO,0BAA0B,CAAC,eAAe,CAAC,qBAAqB,CAAC,CAAC;IAC3E,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,yBAAyB,CAAC,qBAA6B,EAAE,gBAAwB;QACtF,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,qBAAqB,CAAC,CAAC;QAC5D,MAAM,UAAU,GAAG,0BAA0B,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC;QAC7E,OAAO,MAAM,GAAG,UAAU,CAAC;IAC7B,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,4BAA4B,CAAC,qBAA6B,EAAE,mBAA2B;QAC5F,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,qBAAqB,CAAC,CAAC;QAC5D,MAAM,UAAU,GAAG,0BAA0B,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAC;QAChF,OAAO,MAAM,GAAG,UAAU,CAAC;IAC7B,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,oBAAoB,CAAC,qBAA6B,EAAE,WAAmB;QAC5E,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,qBAAqB,CAAC,CAAC;QAC5D,MAAM,cAAc,GAAG,0BAA0B,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QACzE,OAAO,GAAG,cAAc,IAAI,WAAW,EAAE,CAAC;IAC5C,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,MAAM,CAAC,WAAW,CAChB,gBAAwB,EACxB,mBAA2B,EAC3B,WAAmB,EACnB,cAAoD;QAEpD,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,EAAE,EAAE;YAC1E,MAAM,YAAY,GAAG,IAAI,CAAC,yBAAyB,CAAC,qBAAqB,EAAE,gBAAgB,CAAC,CAAC;YAC7F,MAAM,eAAe,GAAG,IAAI,CAAC,4BAA4B,CAAC,qBAAqB,EAAE,mBAAmB,CAAC,CAAC;YACtG,MAAM,OAAO,GAAG,IAAI,CAAC,oBAAoB,CAAC,qBAAqB,EAAE,WAAW,CAAC,CAAC;YAC9E,OAAO;gBACL,kBAAkB;gBAClB,qBAAqB;gBACrB,YAAY;gBACZ,eAAe;gBACf,cAAc,EAAE,YAAY;gBAC5B,YAAY,EAAE,0BAA0B,CAAC,WAAW,CAAC,YAAY,CAAC;gBAClE,OAAO;aACR,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/esm/resources/utils/resource-subtree.utils.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Resource Subtree Map Utility
+ *
+ * Computes a pre-built map from each resource type to all its descendants
+ * in the relationship graph. Used by the navigation resolver to determine
+ * whether a target resource is "in scope" of the PRIMARY zone's current
+ * content (PROMOTE decision — D23).
+ *
+ * Convention: resourceType1 = parent, resourceType2 = child.
+ * Cycles are handled via the `allowCycle` flag — edges with `allowCycle: true`
+ * are still traversed, but the visited-set prevents infinite recursion.
+ */
+import type { ResourceRelationship } from '../resources.shared.schemas.js';
+export type SubtreeMap = Map<string, Set<string>>;
+/**
+ * Compute the subtree map for all resource types in the relationship graph.
+ *
+ * For each resource type that appears as a parent (resourceType1), computes
+ * the full set of transitive descendants. Self-references and cycles are
+ * handled by the visited-set guard in `collectDescendants`.
+ *
+ * @param relationships - All registered resource relationships
+ * @returns Map from resource type to the set of all its descendant resource types
+ */
+export declare function computeSubtreeMap(relationships: ResourceRelationship[]): SubtreeMap;
+//# sourceMappingURL=resource-subtree.utils.d.ts.map

package/dist/esm/resources/utils/resource-subtree.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-subtree.utils.d.ts","sourceRoot":"","sources":["../../../../src/resources/utils/resource-subtree.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAExE,MAAM,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAqDlD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,oBAAoB,EAAE,GAAG,UAAU,CAWnF"}

package/dist/esm/resources/utils/resource-subtree.utils.js

@@ -0,0 +1,75 @@
+/**
+ * Resource Subtree Map Utility
+ *
+ * Computes a pre-built map from each resource type to all its descendants
+ * in the relationship graph. Used by the navigation resolver to determine
+ * whether a target resource is "in scope" of the PRIMARY zone's current
+ * content (PROMOTE decision — D23).
+ *
+ * Convention: resourceType1 = parent, resourceType2 = child.
+ * Cycles are handled via the `allowCycle` flag — edges with `allowCycle: true`
+ * are still traversed, but the visited-set prevents infinite recursion.
+ */
+/**
+ * Build an adjacency list (parent → children) from flat relationship array.
+ * Disabled relationships are excluded.
+ */
+function buildAdjacencyList(relationships) {
+    const adj = new Map();
+    for (const rel of relationships) {
+        if (rel.isDisabled)
+            continue;
+        const parent = rel.resourceType1;
+        const child = rel.resourceType2;
+        let children = adj.get(parent);
+        if (!children) {
+            children = new Set();
+            adj.set(parent, children);
+        }
+        children.add(child);
+    }
+    return adj;
+}
+/**
+ * Compute transitive descendants for a single resource type via DFS.
+ * Returns the set of all resource types reachable as descendants.
+ */
+function collectDescendants(root, adjacency) {
+    const descendants = new Set();
+    const stack = [root];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        const children = adjacency.get(current);
+        if (!children)
+            continue;
+        for (const child of children) {
+            if (child === root)
+                continue;
+            if (descendants.has(child))
+                continue;
+            descendants.add(child);
+            stack.push(child);
+        }
+    }
+    return descendants;
+}
+/**
+ * Compute the subtree map for all resource types in the relationship graph.
+ *
+ * For each resource type that appears as a parent (resourceType1), computes
+ * the full set of transitive descendants. Self-references and cycles are
+ * handled by the visited-set guard in `collectDescendants`.
+ *
+ * @param relationships - All registered resource relationships
+ * @returns Map from resource type to the set of all its descendant resource types
+ */
+export function computeSubtreeMap(relationships) {
+    const adjacency = buildAdjacencyList(relationships);
+    const subtreeMap = new Map();
+    const allParents = new Set(adjacency.keys());
+    for (const parent of allParents) {
+        subtreeMap.set(parent, collectDescendants(parent, adjacency));
+    }
+    return subtreeMap;
+}
+//# sourceMappingURL=resource-subtree.utils.js.map

package/dist/esm/resources/utils/resource-subtree.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-subtree.utils.js","sourceRoot":"","sources":["../../../../src/resources/utils/resource-subtree.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH;;;GAGG;AACH,SAAS,kBAAkB,CAAC,aAAqC;IAC/D,MAAM,GAAG,GAAG,IAAI,GAAG,EAAuB,CAAC;IAE3C,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QAChC,IAAI,GAAG,CAAC,UAAU;YAAE,SAAS;QAE7B,MAAM,MAAM,GAAG,GAAG,CAAC,aAAa,CAAC;QACjC,MAAM,KAAK,GAAG,GAAG,CAAC,aAAa,CAAC;QAEhC,IAAI,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;YAC7B,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC5B,CAAC;QACD,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,SAAS,kBAAkB,CACzB,IAAY,EACZ,SAAmC;IAEnC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,MAAM,KAAK,GAAa,CAAC,IAAI,CAAC,CAAC;IAE/B,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,EAAG,CAAC;QAC7B,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ;YAAE,SAAS;QAExB,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,IAAI,KAAK,KAAK,IAAI;gBAAE,SAAS;YAC7B,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,SAAS;YACrC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAC,aAAqC;IACrE,MAAM,SAAS,GAAG,kBAAkB,CAAC,aAAa,CAAC,CAAC;IACpD,MAAM,UAAU,GAAe,IAAI,GAAG,EAAE,CAAC;IAEzC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IAE7C,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;QAChC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/esm/resources/utils/resources-config-context-needs.utils.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Utilities for extracting context needs from resource configuration functions.
+ * Similar to how virtual fields extract needsObjectContext/needsUserContext flags.
+ */
+import type { ResourceConfiguration_FunctionContextNeeds, ResourceConfiguration_FunctionWithContextNeeds } from '../resources-config.shared.schemas.js';
+/**
+ * Extract context needs from a function that may have needsObjectContext/needsUserContext flags.
+ * Functions can be either:
+ * 1. Plain functions (no flags) - returns { needsObjectContext: false, needsUserContext: false }
+ * 2. Functions with flags attached as properties - returns the flags
+ */
+export declare function extractFunctionContextNeeds<TFunction extends (...args: any[]) => any>(fn: ResourceConfiguration_FunctionWithContextNeeds<TFunction> | TFunction | undefined): ResourceConfiguration_FunctionContextNeeds;
+/**
+ * Check if a function needs object context.
+ */
+export declare function functionNeedsObjectContext<TFunction extends (...args: any[]) => any>(fn: ResourceConfiguration_FunctionWithContextNeeds<TFunction> | TFunction | undefined): boolean;
+/**
+ * Check if a function needs user context.
+ */
+export declare function functionNeedsUserContext<TFunction extends (...args: any[]) => any>(fn: ResourceConfiguration_FunctionWithContextNeeds<TFunction> | TFunction | undefined): boolean;
+/**
+ * Analyze context needs from an operation's enabledCondition and basicPrefixOperation.
+ * Returns aggregated context needs.
+ */
+export declare function analyzeOperationContextNeeds<TOperation extends {
+    enabledCondition?: ResourceConfiguration_FunctionWithContextNeeds<any>;
+    basicPrefixOperation?: ResourceConfiguration_FunctionWithContextNeeds<any>;
+}>(operation: TOperation): ResourceConfiguration_FunctionContextNeeds;
+//# sourceMappingURL=resources-config-context-needs.utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resources-config-context-needs.utils.d.ts","sourceRoot":"","sources":["../../../../src/resources/utils/resources-config-context-needs.utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,0CAA0C,EAAE,8CAA8C,EAAE,MAAM,oCAAoC,CAAC;AAErJ;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACnF,EAAE,EAAE,8CAA8C,CAAC,SAAS,CAAC,GAAG,SAAS,GAAG,SAAS,GACpF,0CAA0C,CAa5C;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAClF,EAAE,EAAE,8CAA8C,CAAC,SAAS,CAAC,GAAG,SAAS,GAAG,SAAS,GACpF,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAChF,EAAE,EAAE,8CAA8C,CAAC,SAAS,CAAC,GAAG,SAAS,GAAG,SAAS,GACpF,OAAO,CAET;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,UAAU,SAAS;IAC9D,gBAAgB,CAAC,EAAE,8CAA8C,CAAC,GAAG,CAAC,CAAC;IACvE,oBAAoB,CAAC,EAAE,8CAA8C,CAAC,GAAG,CAAC,CAAC;CAC5E,EAAE,SAAS,EAAE,UAAU,GAAG,0CAA0C,CAQpE"}

package/dist/esm/resources/utils/resources-config-context-needs.utils.js

@@ -0,0 +1,47 @@
+/**
+ * Utilities for extracting context needs from resource configuration functions.
+ * Similar to how virtual fields extract needsObjectContext/needsUserContext flags.
+ */
+/**
+ * Extract context needs from a function that may have needsObjectContext/needsUserContext flags.
+ * Functions can be either:
+ * 1. Plain functions (no flags) - returns { needsObjectContext: false, needsUserContext: false }
+ * 2. Functions with flags attached as properties - returns the flags
+ */
+export function extractFunctionContextNeeds(fn) {
+    if (!fn) {
+        return { needsObjectContext: false, needsUserContext: false };
+    }
+    // Check if function has context needs flags attached
+    const needsObjectContext = fn.needsObjectContext === true;
+    const needsUserContext = fn.needsUserContext === true;
+    return {
+        needsObjectContext,
+        needsUserContext,
+    };
+}
+/**
+ * Check if a function needs object context.
+ */
+export function functionNeedsObjectContext(fn) {
+    return extractFunctionContextNeeds(fn).needsObjectContext === true;
+}
+/**
+ * Check if a function needs user context.
+ */
+export function functionNeedsUserContext(fn) {
+    return extractFunctionContextNeeds(fn).needsUserContext === true;
+}
+/**
+ * Analyze context needs from an operation's enabledCondition and basicPrefixOperation.
+ * Returns aggregated context needs.
+ */
+export function analyzeOperationContextNeeds(operation) {
+    const enabledConditionNeeds = extractFunctionContextNeeds(operation.enabledCondition);
+    const basicPrefixOperationNeeds = extractFunctionContextNeeds(operation.basicPrefixOperation);
+    return {
+        needsObjectContext: enabledConditionNeeds.needsObjectContext || basicPrefixOperationNeeds.needsObjectContext,
+        needsUserContext: enabledConditionNeeds.needsUserContext || basicPrefixOperationNeeds.needsUserContext,
+    };
+}
+//# sourceMappingURL=resources-config-context-needs.utils.js.map

package/dist/esm/resources/utils/resources-config-context-needs.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources-config-context-needs.utils.js","sourceRoot":"","sources":["../../../../src/resources/utils/resources-config-context-needs.utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CACzC,EAAqF;IAErF,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC;IAChE,CAAC;IAED,qDAAqD;IACrD,MAAM,kBAAkB,GAAI,EAAU,CAAC,kBAAkB,KAAK,IAAI,CAAC;IACnE,MAAM,gBAAgB,GAAI,EAAU,CAAC,gBAAgB,KAAK,IAAI,CAAC;IAE/D,OAAO;QACL,kBAAkB;QAClB,gBAAgB;KACjB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,EAAqF;IAErF,OAAO,2BAA2B,CAAC,EAAE,CAAC,CAAC,kBAAkB,KAAK,IAAI,CAAC;AACrE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,EAAqF;IAErF,OAAO,2BAA2B,CAAC,EAAE,CAAC,CAAC,gBAAgB,KAAK,IAAI,CAAC;AACnE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAGzC,SAAqB;IACtB,MAAM,qBAAqB,GAAG,2BAA2B,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;IACtF,MAAM,yBAAyB,GAAG,2BAA2B,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;IAE9F,OAAO;QACL,kBAAkB,EAAE,qBAAqB,CAAC,kBAAkB,IAAI,yBAAyB,CAAC,kBAAkB;QAC5G,gBAAgB,EAAE,qBAAqB,CAAC,gBAAgB,IAAI,yBAAyB,CAAC,gBAAgB;KACvG,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,149 @@
+export declare class ResourcesConfigNamingUtils {
+    /**
+     * Pluralize an English word using common English rules
+     * This is a reliable implementation covering most common cases
+     */
+    static pluralize(word: string): string;
+    /**
+     * Singularize an English word using common English rules
+     * This is a reliable implementation covering most common cases
+     */
+    static singularize(word: string): string;
+    /**
+     * Preserve the case pattern of the original word in the result
+     */
+    private static preserveCase;
+    /**
+     * Convert resourceFieldIdentifier to resourceName (plural)
+     * Examples:
+     * - "userId" -> "users"
+     * - "organizationIds" -> "organizations"
+     * - "todoListId" -> "todoLists"
+     */
+    static toResourceName(resourceFieldIdentifier: string): string;
+    /**
+     * Convert resourceName to resourceFieldIdentifier
+     * Examples:
+     * - "users" -> "userId"
+     * - "organizations" -> "organizationId"
+     * - "todoLists" -> "todoListId"
+     */
+    static toResourceFieldIdentifier(resourceName: string): string;
+    /**
+     * Convert resourceFieldIdentifier to singular resource name
+     * Examples:
+     * - "userId" -> "user"
+     * - "organizationIds" -> "organization"
+     */
+    static toResourceNameSingular(resourceFieldIdentifier: string): string;
+    /**
+     * Convert resourceFieldIdentifier to plural field identifier
+     * Examples:
+     * - "userId" -> "userIds"
+     * - "organizationId" -> "organizationIds"
+     */
+    static toFieldIdentifierPlural(resourceFieldIdentifier: string): string;
+    /**
+     * Convert resourceFieldIdentifier to singular field identifier
+     * Examples:
+     * - "userIds" -> "userId"
+     * - "organizationId" -> "organizationId"
+     */
+    static toFieldIdentifierSingular(resourceFieldIdentifier: string): string;
+    /**
+     * Check if a resourceFieldIdentifier is plural
+     */
+    static isFieldIdentifierPlural(resourceFieldIdentifier: string): boolean;
+    /**
+     * Check if a resourceFieldIdentifier is singular
+     */
+    static isFieldIdentifierSingular(resourceFieldIdentifier: string): boolean;
+    /**
+     * Convert to snake_case
+     * Examples:
+     * - "createdByUser" -> "created_by_user"
+     * - "TodoList" -> "todo_list"
+     */
+    static toSnakeCase(str: string): string;
+    /**
+     * Convert to camelCase
+     * Examples:
+     * - "created-by-user" -> "createdByUser"
+     * - "todo_list" -> "todoList"
+     */
+    static toCamelCase(str: string): string;
+    /**
+     * Convert to PascalCase
+     * Examples:
+     * - "created-by-user" -> "CreatedByUser"
+     * - "todo_list" -> "TodoList"
+     */
+    static toPascalCase(str: string): string;
+    /**
+     * Convert to kebab-case
+     * Examples:
+     * - "createdByUser" -> "created-by-user"
+     * - "TodoList" -> "todo-list"
+     */
+    static toKebabCase(str: string): string;
+    /**
+     * Convert to CONSTANT_CASE
+     * Examples:
+     * - "createdByUser" -> "CREATED_BY_USER"
+     * - "todo-list" -> "TODO_LIST"
+     */
+    static toConstantCase(str: string): string;
+    /**
+     * Convert from kebab-case to camelCase (as specifically requested)
+     * Examples:
+     * - "created-by-user" -> "createdByUser"
+     * - "todo-list-item" -> "todoListItem"
+     */
+    static kebabToCamelCase(str: string): string;
+    /**
+     * Convert from snake_case to camelCase
+     * Examples:
+     * - "created_by_user" -> "createdByUser"
+     * - "todo_list_item" -> "todoListItem"
+     */
+    static snakeToCamelCase(str: string): string;
+    /**
+     * Validate if a string is a valid resourceFieldIdentifier
+     * Must end with 'Id' or 'Ids' and be in camelCase
+     */
+    static isValidResourceFieldIdentifier(str: string): boolean;
+    /**
+     * Validate if a string is a valid resourceName
+     * Should be in camelCase and plural
+     */
+    static isValidResourceName(str: string): boolean;
+    /**
+     * Get both singular and plural forms of a resource name
+     */
+    static getResourceNameVariants(resourceName: string): {
+        singular: string;
+        plural: string;
+        singularFieldId: string;
+        pluralFieldId: string;
+    };
+    /**
+     * Extract the base name from a resourceFieldIdentifier.
+     *
+     * THIS IS THE CANONICAL FUNCTION for deriving populated sibling field names.
+     * Used by:
+     * - Backend: resource-population.backend.service.ts (populateForSummary, populateListForSummary)
+     * - Backend: services-registry-handler.backend.service.ts (getNestedFieldName for 1:1 relationships)
+     * - Backend: resources-config-operations.dtos-builder.utils.ts (nested DTO fields for 1:1)
+     * - Frontend: DisplayField.tsx (extractPopulatedSibling)
+     *
+     * DO NOT create alternative implementations. Use this function.
+     * For 1:N nested fields, use toResourceName() instead (pluralized form).
+     *
+     * Examples:
+     * - "userId" -> "user"
+     * - "organizationIds" -> "organization"
+     * - "assignedToUserId" -> "assignedToUser"
+     */
+    static extractBaseName(resourceFieldIdentifier: string): string;
+}
+//# sourceMappingURL=resources-config-naming.utils.d.ts.map

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

@@ -0,0 +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"}