@qoretechnologies/reqraft 0.10.64 → 0.10.65-pr.148.gc6381e4

package/src/components/ticketThread/index.ts

@@ -1,5 +1,6 @@
 export { TicketThread, ticketMessageDomId } from './TicketThread';
 export type {
+  ITicketSystemEventAction,
   ITicketThreadAttachment,
   ITicketThreadMessage,
   ITicketThreadProps,

package/src/index.tsx

@@ -36,6 +36,7 @@ export { currentUserStore as ReqraftCurrentUserStore } from './stores/currentUse
 export type {
   ICurrentUser,
   ICurrentUserStore,
+  ICurrentUserSupportSession,
 } from './stores/currentUser/currentUser';
 export {
   fetchConfig,

package/src/providers/StorageProvider.tsx

@@ -6,7 +6,7 @@ import { ReqraftStorageContext, TReqraftStorage } from '../contexts/StorageConte
 import { useFetch } from '../hooks/useFetch/useFetch';
 import { useReqraftProperty } from '../hooks/useReqraftProperty';
 import { TReqraftStorageValue } from '../hooks/useStorage/useStorage';
-import { currentUserStore } from '../stores/currentUser/currentUser';
+import { currentUserStore, ICurrentUser } from '../stores/currentUser/currentUser';
 import { isQueryCancelled } from '../utils/fetch';
 import { IReqraftProviderProps } from './ReqraftProvider';
 
@@ -27,6 +27,18 @@ export const applyStorageWrite = (
   value: unknown
 ): TReqraftStorage => set(cloneDeep(storage) ?? {}, path, value);
 
+/**
+ * Whether the current user's storage may be persisted. The server answers
+ * `storage_writable: false` for an identity whose storage is not its own to keep — a
+ * staff member in an interactive support session reads a customer's workspace as the
+ * workspace's reader principal, and a preference they flip must not land in that
+ * principal's storage (qorus#693). A write for such a user is applied in memory only,
+ * so the page behaves as it always does, and nothing is sent. A user the flag is
+ * absent for is writable: that is every server from before the flag existed.
+ */
+export const storageIsWritable = (user?: Pick<ICurrentUser, 'storage_writable'>): boolean =>
+  user?.storage_writable !== false;
+
 export interface IReqraftStorageProviderProps
   extends Pick<IReqraftProviderProps, 'waitForStorage'> {
   children: ReactNode;
@@ -95,7 +107,10 @@ export const ReqraftUserProvider = ({ children, waitForStorage }: IReqraftStorag
 
       updateCurrentUserStorage(updatedStorage);
 
-      load({ body: { storage: updatedStorage } });
+      // in memory only for a user whose storage is not theirs to keep
+      if (storageIsWritable(currentUserStore.getState().currentUser)) {
+        load({ body: { storage: updatedStorage } });
+      }
     },
     [appName, load, updateCurrentUserStorage]
   );
@@ -111,7 +126,9 @@ export const ReqraftUserProvider = ({ children, waitForStorage }: IReqraftStorag
 
       updateCurrentUserStorage(updatedStorage);
 
-      load({ body: { storage_path: _path } });
+      if (storageIsWritable(currentUserStore.getState().currentUser)) {
+        load({ body: { storage_path: _path } });
+      }
     },
     [appName, load, updateCurrentUserStorage]
   );

package/src/stores/currentUser/currentUser.tsx

@@ -1,6 +1,39 @@
 import { create } from 'zustand';
 import { IReqraftFetchResponse, isQueryCancelled, query } from '../../utils/fetch';
 
+/**
+ * The interactive support session a current user is in, when it is one (qorus#693
+ * Layer 3): a staff member reading a customer's workspace in the IDE, read-only, as
+ * the workspace's support reader. Exactly what the server puts on the request context
+ * for such a session, never a token. Absent for every ordinary user.
+ */
+export interface ICurrentUserSupportSession {
+  /** the session's id on the control plane */
+  session_id: string;
+  /** the customer's grant the session runs under */
+  grant_id: string;
+  /** the ticket the grant belongs to */
+  ticket_id: string;
+  /** the ticket's number, for display */
+  ticket_number?: number;
+  /** the control-plane staff identity the session belongs to */
+  actor: string;
+  /** the staff member's display name, when the control plane has it */
+  actor_name?: string;
+  /** the workspace's portable namespace */
+  group_namespace: number;
+  /** the workspace group's name */
+  group_name?: string;
+  /** the identity profile, `workspace-read` */
+  profile: string;
+  /** when the session ends at the latest: the grant's expiry (ISO 8601) */
+  expires: string;
+  /** where the IDE opens — `kind` and `name` or `id` — when the staff member came from a reference */
+  target?: Record<string, unknown>;
+  /** the control-plane page to return to */
+  portal_url?: string;
+}
+
 export interface ICurrentUser {
   provider: string;
   username: string;
@@ -19,6 +52,16 @@ export interface ICurrentUser {
   storage?: Record<string, any>;
   sandboxed?: boolean;
   default_group?: string;
+  /**
+   * Whether the user's storage can be written back to the server. `false` for an
+   * identity whose storage is not its own to keep — an interactive support session
+   * reads a workspace as its reader principal — and then every storage write stays
+   * in memory for the page's lifetime (see `ReqraftUserProvider`). Absent means
+   * writable, as on every server from before the flag.
+   */
+  storage_writable?: boolean;
+  /** present only in an interactive support session (qorus#693 Layer 3) */
+  support_session?: ICurrentUserSupportSession;
 }
 
 export interface ICurrentUserStore {