@eintrek/erp-shell 0.1.60 → 0.1.61

package/dist/navigation/url-org-gate.d.ts

@@ -54,3 +54,25 @@ export interface UrlOrgGateInput {
 /** The organisation a `[code]` segment names, among the caller's. */
 export declare function findOrganizationForCode<T extends UrlOrgGateOrganization>(code: string | undefined, organizations: readonly T[]): T | null;
 export declare function resolveUrlOrgGate({ code, organizations, organizationsStatus, organizationId, }: UrlOrgGateInput): UrlOrgGate;
+/**
+ * What to do when the active organisation is not one of the user's — a
+ * browser that remembers an organisation that was deleted, or that the user
+ * has left. Pure, tested in url-org-gate.test.ts.
+ *
+ *   none     nothing to recover: the list has not loaded, there is no active
+ *            organisation, or the active one is the user's.
+ *   use      make `targetId` active: the URL's organisation when the user is
+ *            a member of it, otherwise the user's only organisation.
+ *   forget   clear it; the user has several organisations and the URL names
+ *            none of them, so they pick one.
+ */
+export type StaleOrganizationRecovery = {
+    action: "none";
+} | {
+    action: "use";
+    targetId: string;
+    fromUrl: boolean;
+} | {
+    action: "forget";
+};
+export declare function resolveStaleOrganization({ code, organizations, organizationsStatus, organizationId, }: UrlOrgGateInput): StaleOrganizationRecovery;

package/dist/organization/active-organization.d.ts

@@ -20,14 +20,63 @@
 export declare function getTabOrganizationId(): string | null;
 /** Record the organisation this tab is working in (browser only). */
 export declare function setTabOrganizationId(id: string | number | null | undefined): void;
+/**
+ * Record the user's organisations (browser only). From then on a stored or
+ * tab organisation that is not among them loses to one that is: a browser
+ * that still remembers a deleted organisation — or one the user has left —
+ * must not keep sending it while the cookie names a good one.
+ */
+export declare function setKnownOrganizationIds(ids: Iterable<string | number> | null): void;
+/** Whether the loaded list says the user is NOT a member of `id`. */
+export declare function isKnownStaleOrganizationId(id: string | number | null | undefined): boolean;
+/**
+ * Marks a request that must not carry X-Organization-ID: the user's own list
+ * of organisations is how a stale organisation id is found out, so it cannot
+ * depend on one. An app's interceptor honours it by passing the request's
+ * config to getRequestOrganizationId(config).
+ *
+ *   axiosInstance.get("/organizations", withoutOrganization({ params }))
+ */
+export declare const WITHOUT_ORGANIZATION_FLAG = "erpWithoutOrganization";
+export declare function withoutOrganization<T extends object = Record<never, never>>(config?: T): T & {
+    erpWithoutOrganization: true;
+};
+/**
+ * Marks a request for one particular organisation, whatever this tab has
+ * active. Used to retry the organisation list under each stored id when an
+ * API refuses it without one (see http/organization-fallback.ts).
+ */
+export declare const FOR_ORGANIZATION_FIELD = "erpOrganizationId";
+/**
+ * Every organisation id this browser has stored for the tab — the tab's
+ * own, localStorage, the cookie — distinct, in that order.
+ */
+export declare function getStoredOrganizationIds(): string[];
 /**
  * The organisation a request from this tab belongs to: the tab's own, then
  * localStorage, then the cookie. Use it for the X-Organization-ID header —
  * and read it before any `await` in the interceptor, so the header names the
  * organisation that was active when the request was made.
  *
+ * Pass the request's config: a request marked withoutOrganization() gets
+ * null, so no header.
+ *
  * localStorage before the cookie: setOrganizationId writes localStorage
  * synchronously and then awaits a server action for the cookie, so during
  * that round trip the cookie still names the previous organisation.
+ *
+ * Once the user's organisations are known (setKnownOrganizationIds), the
+ * first of those that is one of them wins: 0.1.60 let a deleted
+ * organisation's id left in localStorage beat a valid cookie, and every
+ * request — the organisation list included — was refused. If none is a
+ * member the first is still sent, as before: the list may simply be behind
+ * (an organisation created a moment ago).
+ */
+export declare function getRequestOrganizationId(config?: unknown): string | null;
+/**
+ * Forget the active organisation everywhere this browser keeps it: the tab,
+ * localStorage and the `erp.organizationId` cookie. Call on sign-out, so the
+ * next person to sign in on this browser does not start in the previous
+ * person's organisation.
  */
-export declare function getRequestOrganizationId(): string | null;
+export declare function clearStoredOrganization(): void;

package/dist/version.d.ts

@@ -2,4 +2,4 @@
  * This package's version, attached to help messages so the back office can
  * tell which shell a report came from. Keep in step with package.json.
  */
-export declare const SHELL_VERSION = "0.1.60";
+export declare const SHELL_VERSION = "0.1.61";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eintrek/erp-shell",
-  "version": "0.1.60",
+  "version": "0.1.61",
   "private": false,
   "type": "module",
   "description": "Shared frontend platform for ERP apps — HTTP client, providers, navigation, hooks.",