@zealicsolutions/web-ui 1.0.140-beta.221 → 1.0.140-beta.223

package/dist/cjs/helpers/rwoContext.d.ts

@@ -82,10 +82,14 @@ export declare const composeRwoParamsV2: ({ selectedWebpageId, includeRwoRecordI
  *   return; // No context for this webpage
  * }
  *
- * // Get rwoRecordId with priority:
- * // 1. Organism-specific: webpageContext[organismId].rwoRecordId
- * // 2. Webpage-level: webpageContext.rwoRecordId
+ * // Get organism context - ONLY use organism-specific context
+ * // DO NOT fallback to webpage-level rwoRecordId
  * const organismContext = webpageContext[organismId] as Record<string, string> | undefined;
- * const rwoRecordIdForOrganism = organismContext?.rwoRecordId
- *   || (webpageContext.rwoRecordId as string | undefined);
+ *
+ * // Use organism context for data fetching (includes rwoRecordId + other fields)
+ * // Form fetching payload: { [sourceFieldId]: value, rwoRecordId: value }
+ * const fetchPayload = organismContext || {};
+ *
+ * // Use ONLY organism-specific rwoRecordId for form submission
+ * const rwoRecordIdForSubmission = organismContext?.rwoRecordId;
  */

package/dist/cjs/helpers/useRwoContext.d.ts

@@ -2,12 +2,15 @@
  * Hook for organisms to easily access their RWO context from URL parameters.
  * Uses webpage-scoped structure to prevent cross-page context pollution.
  *
- * NEW Structure: { [webpageId]: { rwoRecordId, [organismId]: { rwoRecordId, ... } } }
+ * Structure: { [webpageId]: { [organismId]: { rwoRecordId, [fieldId]: value } } }
+ *
+ * CRITICAL: Forms ONLY use rwoRecordId from their organism-specific context.
+ * DO NOT fallback to webpage-level or top-level rwoRecordId.
  *
  * Organisms look up context by:
  * 1. Get their current webpage ID from prop or URL
- * 2. Look up rwoContext[webpageId] to get the webpage's context
- * 3. Read rwoRecordId with priority: webpageContext[organismId].rwoRecordId > webpageContext.rwoRecordId
+ * 2. Look up rwoContext[webpageId][organismId] to get organism's context
+ * 3. Read rwoRecordId ONLY from organism-specific context
  *
  * @param organismId - The ID of the organism consuming the context
  * @param currentWebpageId - The webpage ID this organism belongs to (REQUIRED for proper scoping)

package/dist/cjs/helpers/utils.d.ts

@@ -13,20 +13,24 @@ export declare const getRwoTargets: (url?: string) => Array<{
     recordId: string;
 }>;
 /**
- * Gets the appropriate RWO record ID for a specific organism using webpage-scoped RWO context.
+ * Gets the RWO record ID for a specific organism using webpage-scoped RWO context.
  *
- * NEW Structure: { [webpageId]: { rwoRecordId, [organismId]: { rwoRecordId, ... } } }
+ * Structure: { [webpageId]: { [organismId]: { rwoRecordId, [fieldId]: value } } }
  *
- * Priority:
- * 1. Organism-specific: rwoContext[webpageId][organismId].rwoRecordId
- * 2. Webpage-level: rwoContext[webpageId].rwoRecordId
+ * CRITICAL: Forms ONLY use rwoRecordId from their organism-specific context.
+ * DO NOT fallback to webpage-level rwoRecordId - this prevents unintended data fetching.
  *
- * This structure ensures organisms ONLY read context for their own webpage.
+ * Organisms read context by:
+ * 1. Get their current webpage ID
+ * 2. Look up rwoContext[webpageId][organismId] to get organism's context
+ * 3. Read rwoRecordId ONLY from organism-specific context
+ *
+ * This ensures forms only fetch/edit data when explicitly navigated to with their own context.
  *
  * @param organismId - The ID of the organism
  * @param url - The URL to parse (defaults to current location)
  * @param currentWebpageId - The current webpage ID (REQUIRED for proper scoping)
- * @returns The record ID to use, or undefined if not found or no context for this webpage
+ * @returns The record ID to use, or undefined if not found or no context for this organism
  */
 export declare const getRwoRecordIdForOrganism: (organismId: string, url?: string, currentWebpageId?: string) => string | undefined;
 export declare const updateSearchParams: (currentParams: URLSearchParams, internalLink?: Nullable<string>, isPreview?: boolean) => URLSearchParams;