@zealicsolutions/web-ui 1.0.140-beta.152 → 1.0.140-beta.154

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

@@ -21,10 +21,26 @@ export declare const encodeObjectToBase64Url: (obj: Record<string, unknown>) =>
  */
 export declare const decodeBase64UrlToObject: <T>(input: string) => T | null;
 /**
- * Compose organism-namespaced `rwoContext` and page-level `rwoRecordId` from inputs
- * mapping entries provide source field id and target organism ids
+ * Compose organism-namespaced `rwoContext` from inputs.
+ * All RWO data is stored inside rwoContext - no separate rwoRecordId URL param.
+ *
+ * Structure:
+ * {
+ *   "selectedWebpageId": "target-webpage-uuid",  // Scopes context to webpage
+ *   "[organismId]": {
+ *     "rwoRecordId": "record-uuid",
+ *     "[fieldId]": "value"
+ *   }
+ * }
+ *
+ * @param selectedWebpageId - Target webpage ID to scope the context
+ * @param includeRwoRecordId - Whether to include rwoRecordId in organism contexts
+ * @param recordId - The primary record ID
+ * @param mapping - Field mappings to target organisms
+ * @param contextSource - Source data for field resolution
  */
-export declare const composeRwoParamsV2: ({ includeRwoRecordId, recordId, mapping, contextSource, }: {
+export declare const composeRwoParamsV2: ({ selectedWebpageId, includeRwoRecordId, recordId, mapping, contextSource, }: {
+    selectedWebpageId?: string | undefined;
     includeRwoRecordId?: boolean | undefined;
     recordId?: string | undefined;
     mapping?: {
@@ -40,10 +56,21 @@ export declare const composeRwoParamsV2: ({ includeRwoRecordId, recordId, mappin
  *
  * const [searchParams] = useSearchParams();
  * const rwoContextParam = searchParams.get('rwoContext') || '';
- * const rwoRecordId = searchParams.get('rwoRecordId');
+ * const selectedWebpageId = searchParams.get('selectedWebpageId');
  *
  * // Decode rwoContext to get organism-specific context
- * const rwoContext = rwoContextParam ? decodeBase64UrlToObject<Record<string, Record<string, string>>>(rwoContextParam) : null;
- * const organismContext = rwoContext?.[organismId];
- * const rwoRecordIdForOrganism = organismContext?.rwoRecordId || rwoRecordId || undefined;
+ * const rwoContext = rwoContextParam
+ *   ? decodeBase64UrlToObject<Record<string, unknown>>(rwoContextParam)
+ *   : null;
+ *
+ * // Verify context is for current webpage before using
+ * const contextWebpageId = rwoContext?.selectedWebpageId as string | undefined;
+ * if (contextWebpageId && contextWebpageId !== selectedWebpageId) {
+ *   // Context is for a different page, ignore it
+ *   return;
+ * }
+ *
+ * // Get organism-specific context (rwoRecordId is inside organism context, NOT separate URL param)
+ * const organismContext = rwoContext?.[organismId] as Record<string, string> | undefined;
+ * const rwoRecordIdForOrganism = organismContext?.rwoRecordId;
  */