@endora-commerce/mod-organizations 0.100.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Endora sp. z o.o. and the Endora Commerce contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,62 @@
+<!-- Generated by `pnpm --filter backend run manifests:generate`. Delete this line to take the file over; a README without it is never regenerated. -->
+
+# @endora-commerce/mod-organizations
+
+B2B organization records, members, addresses, sales-rep assignment, moderation lifecycle, and per-org commercial scoping.
+
+## What this is
+
+An **Endora Commerce module package**. Its module id is `organizations` — the identity of record in the platform's registries, in its migrations and in its setting, permission and translation codes.
+
+A module is not imported by application code. The platform discovers the extension packages an instance has installed, reads the manifest on the root subpath and composes the module from it, so installing this package and starting the instance is the whole integration.
+
+## Entry points
+
+| Import | Contents |
+| --- | --- |
+| `@endora-commerce/mod-organizations` | the module manifest — its id, version, dependencies, settings and activation |
+| `@endora-commerce/mod-organizations/admin` | the Admin UI contribution: the screens, navigation and palette actions it adds |
+| `@endora-commerce/mod-organizations/backend` | the composition root the platform calls, with the entities, services, routes and workers it registers |
+| `@endora-commerce/mod-organizations/migrations` | the module’s own schema migrations, in the order the platform runs them |
+| `@endora-commerce/mod-organizations/ports` | type-only — the port interfaces other modules resolve this one through |
+| `@endora-commerce/mod-organizations/tailwind.css` | the Tailwind source declaration for the admin code above |
+
+## Depends on
+
+Everything below is a **peer** dependency, so the application resolves exactly one copy of each — two copies of a host or of React are a runtime failure rather than a type error. An entry marked *optional* is needed only by the layers that use it.
+
+**Endora packages**
+
+- `@endora-commerce/admin-kit` — *optional*
+- `@endora-commerce/contracts`
+- `@endora-commerce/email-components`
+- `@endora-commerce/platform`
+
+**Third-party**
+
+- `@fastify/cookie` ^11
+- `@mikro-orm/core` ^6
+- `@mikro-orm/migrations` ^6
+- `@mikro-orm/postgresql` ^6
+- `fastify` ^5
+- `lucide-react` ^1 — *optional*
+- `react` ^19 — *optional*
+- `react-router-dom` ^7 — *optional*
+- `zod` ^4
+
+## What the tarball carries
+
+- `dist/` — the compiled JavaScript and its type declarations
+- `i18n/` — the translation bundles this package ships (`en`, `pl`), loaded by the platform
+- `docs/` — the package’s own pages in the Endora Commerce documentation site
+- `tailwind.css` — the Tailwind source declaration
+
+## Install
+
+```bash
+pnpm add @endora-commerce/mod-organizations
+```
+
+## Licence
+
+MIT — the text is in `LICENSE`, beside this file.

package/dist/admin/components/OrganizationSalesRepsTab.d.ts

@@ -0,0 +1,27 @@
+import { type ReactNode } from 'react';
+/**
+ * The gate, and the reason it is here rather than at the call site (D-166).
+ *
+ * The panel used to be mounted unconditionally, so an operator whose role does
+ * not hold the code saw the card and then a red 403 banner inside it, and — while
+ * the three endpoints were still registered by `quote_requests` — an operator who
+ * had switched quote requests off saw a 503 `MODULE_DISABLED` banner on the
+ * organisation screen instead. Constitution XVII item 5 says a module that is
+ * off contributes no tab; a tab that renders its own refusal is the opposite.
+ *
+ * `useSurfaceVisibility` is the predicate the sidebar, the palette and the
+ * dashboard quick actions already share (issue #230), so this is not a fourth
+ * answer to the same question. The **module** is `organizations`, which is where
+ * the three endpoints have belonged since D-166: it is `nonDeactivatable`, so the
+ * presence half cannot close today, and it is written anyway because the honest
+ * gate is "the module that owns these routes", not "the module that happens to
+ * be switchable".
+ *
+ * A wrapper rather than an early return inside the body: hooks cannot be
+ * skipped conditionally, and the body's first effect fetches. Hidden has to mean
+ * *nothing requested*, or every organisation opened logs a 403.
+ */
+export declare function OrganizationSalesRepsTab(props: {
+    organizationId: string;
+}): ReactNode;
+//# sourceMappingURL=OrganizationSalesRepsTab.d.ts.map

package/dist/admin/components/OrganizationSalesRepsTab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrganizationSalesRepsTab.d.ts","sourceRoot":"","sources":["../../../src/admin/components/OrganizationSalesRepsTab.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAqD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAkD1F;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAAE,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAWrF"}

package/dist/admin/components/OrganizationSalesRepsTab.js

@@ -0,0 +1,170 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { Trash2, UserPlus } from 'lucide-react';
+import { ApiError, apiClient, useSurfaceVisibility } from '@endora-commerce/admin-kit/lib';
+import { Alert, AlertDescription, Button, Card, CardContent, CardHeader, CardTitle, Combobox, Label, Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from '@endora-commerce/admin-kit/ui';
+import { useTranslation } from '@endora-commerce/admin-kit/i18n';
+const SEARCH_DEBOUNCE_MS = 250;
+const SEARCH_PAGE_SIZE = 20;
+function adminUserToOption(u) {
+    const fullName = `${u.firstName} ${u.lastName}`.trim();
+    return {
+        value: u.id,
+        label: fullName.length > 0 ? fullName : u.email,
+        description: fullName.length > 0 ? u.email : undefined,
+    };
+}
+/**
+ * The gate, and the reason it is here rather than at the call site (D-166).
+ *
+ * The panel used to be mounted unconditionally, so an operator whose role does
+ * not hold the code saw the card and then a red 403 banner inside it, and — while
+ * the three endpoints were still registered by `quote_requests` — an operator who
+ * had switched quote requests off saw a 503 `MODULE_DISABLED` banner on the
+ * organisation screen instead. Constitution XVII item 5 says a module that is
+ * off contributes no tab; a tab that renders its own refusal is the opposite.
+ *
+ * `useSurfaceVisibility` is the predicate the sidebar, the palette and the
+ * dashboard quick actions already share (issue #230), so this is not a fourth
+ * answer to the same question. The **module** is `organizations`, which is where
+ * the three endpoints have belonged since D-166: it is `nonDeactivatable`, so the
+ * presence half cannot close today, and it is written anyway because the honest
+ * gate is "the module that owns these routes", not "the module that happens to
+ * be switchable".
+ *
+ * A wrapper rather than an early return inside the body: hooks cannot be
+ * skipped conditionally, and the body's first effect fetches. Hidden has to mean
+ * *nothing requested*, or every organisation opened logs a 403.
+ */
+export function OrganizationSalesRepsTab(props) {
+    const isVisible = useSurfaceVisibility();
+    if (!isVisible({
+        module: 'organizations',
+        requiredPermission: 'organizations:assign-sales-rep',
+    })) {
+        return null;
+    }
+    return _jsx(OrganizationSalesRepsPanel, { organizationId: props.organizationId });
+}
+function OrganizationSalesRepsPanel({ organizationId, }) {
+    const t = useTranslation('core');
+    const [rows, setRows] = useState([]);
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const [info, setInfo] = useState(null);
+    const [selectedAdminUserId, setSelectedAdminUserId] = useState(null);
+    const [selectedLabel, setSelectedLabel] = useState('');
+    const [busy, setBusy] = useState(false);
+    const [pickerOptions, setPickerOptions] = useState([]);
+    const [pickerSearching, setPickerSearching] = useState(false);
+    const refresh = useCallback(async () => {
+        setLoading(true);
+        setError(null);
+        try {
+            const reps = await apiClient.get(`/api/v1/admin/organizations/${organizationId}/sales-reps`);
+            setRows(reps.data);
+        }
+        catch (err) {
+            setError(err instanceof ApiError ? err.envelope.error.message : t('organizations.salesReps.error.load'));
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [organizationId, t]);
+    useEffect(() => {
+        void refresh();
+    }, [refresh]);
+    const assignedIds = useMemo(() => new Set(rows.map((r) => r.adminUserId)), [rows]);
+    // Debounced server-side search. The latest request id wins so out-of-order
+    // responses (slow first request, fast second) don't overwrite fresh state.
+    const searchTimerRef = useRef(null);
+    const searchSeqRef = useRef(0);
+    useEffect(() => () => {
+        if (searchTimerRef.current !== null)
+            clearTimeout(searchTimerRef.current);
+    }, []);
+    const runSearch = useCallback(async (query, seq) => {
+        setPickerSearching(true);
+        try {
+            const params = new URLSearchParams();
+            params.set('page', '0');
+            params.set('pageSize', String(SEARCH_PAGE_SIZE));
+            if (query.trim().length > 0)
+                params.set('q', query.trim());
+            const res = await apiClient.get(`/api/v1/admin/admin-users?${params.toString()}`);
+            if (seq !== searchSeqRef.current)
+                return; // stale response
+            const filtered = res.data
+                .filter((u) => u.status === 'active' && !assignedIds.has(u.id))
+                .map(adminUserToOption);
+            setPickerOptions(filtered);
+        }
+        catch (err) {
+            if (seq !== searchSeqRef.current)
+                return;
+            setError(err instanceof ApiError ? err.envelope.error.message : t('organizations.salesReps.error.search'));
+            setPickerOptions([]);
+        }
+        finally {
+            if (seq === searchSeqRef.current)
+                setPickerSearching(false);
+        }
+    }, [assignedIds, t]);
+    const handleSearchChange = useCallback((query) => {
+        if (searchTimerRef.current !== null)
+            clearTimeout(searchTimerRef.current);
+        const seq = ++searchSeqRef.current;
+        searchTimerRef.current = setTimeout(() => {
+            void runSearch(query, seq);
+        }, SEARCH_DEBOUNCE_MS);
+    }, [runSearch]);
+    const handlePickerChange = useCallback((next) => {
+        setSelectedAdminUserId(next);
+        if (next === null) {
+            setSelectedLabel('');
+            return;
+        }
+        const opt = pickerOptions.find((o) => o.value === next);
+        if (opt)
+            setSelectedLabel(opt.label);
+    }, [pickerOptions]);
+    const assign = async () => {
+        if (selectedAdminUserId === null)
+            return;
+        setBusy(true);
+        setError(null);
+        setInfo(null);
+        try {
+            await apiClient.post(`/api/v1/admin/organizations/${organizationId}/sales-reps`, { adminUserId: selectedAdminUserId });
+            setInfo(t('organizations.salesReps.info.assigned'));
+            setSelectedAdminUserId(null);
+            setSelectedLabel('');
+            setPickerOptions([]);
+            await refresh();
+        }
+        catch (err) {
+            setError(err instanceof ApiError ? err.envelope.error.message : t('organizations.salesReps.error.assign'));
+        }
+        finally {
+            setBusy(false);
+        }
+    };
+    const unassign = async (id) => {
+        setBusy(true);
+        setError(null);
+        setInfo(null);
+        try {
+            await apiClient.delete(`/api/v1/admin/organizations/${organizationId}/sales-reps/${id}`);
+            setInfo(t('organizations.salesReps.info.unassigned'));
+            await refresh();
+        }
+        catch (err) {
+            setError(err instanceof ApiError ? err.envelope.error.message : t('organizations.salesReps.error.unassign'));
+        }
+        finally {
+            setBusy(false);
+        }
+    };
+    return (_jsxs(Card, { children: [_jsx(CardHeader, { children: _jsx(CardTitle, { children: t('organizations.salesReps.title') }) }), _jsxs(CardContent, { style: { display: 'flex', flexDirection: 'column', gap: 16 }, children: [error ? (_jsx(Alert, { variant: "destructive", children: _jsx(AlertDescription, { children: error }) })) : null, info ? (_jsx(Alert, { children: _jsx(AlertDescription, { children: info }) })) : null, rows.length === 0 && !loading ? (_jsx("p", { style: { color: 'var(--b2b-muted)', fontSize: 13 }, children: t('organizations.salesReps.empty') })) : (_jsxs(Table, { children: [_jsx(TableHeader, { children: _jsxs(TableRow, { children: [_jsx(TableHead, { children: t('organizations.salesReps.column.name') }), _jsx(TableHead, { children: t('organizations.salesReps.column.email') }), _jsx(TableHead, { children: t('organizations.salesReps.column.assignedAt') }), _jsx(TableHead, { style: { width: 60 } })] }) }), _jsx(TableBody, { children: rows.map((r) => (_jsxs(TableRow, { children: [_jsx(TableCell, { children: r.displayName }), _jsx(TableCell, { children: r.email }), _jsx(TableCell, { children: new Date(r.assignedAt).toLocaleDateString('pl-PL') }), _jsx(TableCell, { children: _jsx(Button, { variant: "ghost", size: "sm", onClick: () => void unassign(r.adminUserId), disabled: busy, children: _jsx(Trash2, { size: 14 }) }) })] }, r.id))) })] })), _jsxs("div", { style: { display: 'flex', gap: 8, alignItems: 'flex-end' }, children: [_jsxs("div", { style: { flex: 1 }, children: [_jsx(Label, { htmlFor: "rep-picker", children: t('organizations.salesReps.assignLabel') }), _jsx(Combobox, { id: "rep-picker", options: pickerOptions, value: selectedAdminUserId, selectedLabel: selectedLabel, onChange: handlePickerChange, onSearchChange: handleSearchChange, manualFilter: true, loading: pickerSearching, placeholder: t('organizations.salesReps.searchPlaceholder'), disabled: busy, emptyMessage: pickerSearching ? t('organizations.salesReps.searching') : t('organizations.salesReps.noMatch') })] }), _jsxs(Button, { onClick: () => void assign(), disabled: busy || loading || selectedAdminUserId === null, children: [_jsx(UserPlus, { size: 14, style: { marginRight: 4 } }), " ", t('organizations.salesReps.assign')] })] })] })] }));
+}
+//# sourceMappingURL=OrganizationSalesRepsTab.js.map

package/dist/admin/components/OrganizationSalesRepsTab.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrganizationSalesRepsTab.js","sourceRoot":"","sources":["../../../src/admin/components/OrganizationSalesRepsTab.tsx"],"names":[],"mappings":"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"}

package/dist/admin/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * `organizations`' admin surface — two routes and one sidebar entry (feature
+ * 091, Phase 4 batch 14).
+ *
+ * **This module is a zone *host*, and the busiest one in the feature.**
+ * `OrganizationDetail.tsx` renders `organization.detail.after`, the member P7b
+ * published for it, and **four** modules contribute there: `sales_channels`'
+ * channel membership at 100, `price_lists`' display-mode override at 200,
+ * `quick_order`'s ordering defaults at 300 and `carts`' approval policy at 400.
+ * The publication is what freed this directory to move —
+ * `check:admin-registrations` counts routes and nav entries and a zone is
+ * neither, so a host may move whether or not its contributors have.
+ *
+ * **What it drains: nothing, and the zero is measured rather than assumed.**
+ * Before anything moved on this branch, this module owned no
+ * `backend/scripts/ledgers/cross-module-imports/` shard, was named as a target
+ * by none, had no key in `admin-surface.ts` (which is empty) and none in
+ * `foreign-module-ids.ts` — its one key there, `CartApprovalPolicyPanel.tsx`'s
+ * `module-namespace:carts`, retired in P7b, which is what the four
+ * contributions above cost that merge request instead of costing this one.
+ * `check:module-boundary` reads `cross-module reaches=7 ledger-size=7 shards=4`
+ * on both sides of the move, and that agreement is the measurement rather than
+ * a silence.
+ *
+ * **This entry exports data and nothing else** (R2); every component is a
+ * dynamic-import factory (R6).
+ */
+import type { AdminContributions } from '@endora-commerce/admin-kit/contributions';
+export declare const contributions: AdminContributions;
+//# sourceMappingURL=index.d.ts.map

package/dist/admin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/admin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AAsBnF,eAAO,MAAM,aAAa,EAAE,kBAuC3B,CAAC"}

package/dist/admin/index.js

@@ -0,0 +1,59 @@
+/**
+ * The codes that open the two screens, **any-of** because the route is any-of.
+ *
+ * `packages/modules/organizations/src/backend/routes.admin.ts:169` builds one
+ * `requireAdminAny(['customers:read', 'customers:manage'])` gate and reads
+ * every organization endpoint through it; the sixteen writes below it enforce
+ * `customers:manage` alone. Naming only the read code — as the sidebar row did
+ * until 2026-08-29 — hid the screen from a role holding just
+ * `customers:manage`, which is why `AdminNavDeclaration.requiredPermission`
+ * takes a `PermissionRequirement` and not a bare string.
+ *
+ * Both codes are this module's own declaration (`manifest.ts`, D-173), so an
+ * operator switching `customers` off does not make them ungrantable while these
+ * screens — owned by a module that cannot be switched off — go on answering.
+ */
+const READ_PERMISSION = ['customers:read', 'customers:manage'];
+/** The module's landing route: the organization roster. */
+const ROUTE_PATH = '/organizations';
+export const contributions = {
+    routes: [
+        {
+            path: ROUTE_PATH,
+            component: () => import('./pages/OrganizationsList.js'),
+            requiredPermission: [...READ_PERMISSION],
+            index: true,
+        },
+        {
+            path: `${ROUTE_PATH}/:id`,
+            component: () => import('./pages/OrganizationDetail.js'),
+            requiredPermission: [...READ_PERMISSION],
+        },
+    ],
+    // One row for two screens, and the one without it is deliberate:
+    // `/organizations/:id` is a detail reached from the roster. A route is what
+    // `App.tsx` used to hold; a row in a table is not a route.
+    nav: [
+        {
+            to: ROUTE_PATH,
+            // Module-relative (R8), resolved in this module's own namespace out of
+            // `packages/modules/organizations/i18n/`. It was
+            // `appShell.nav.organizations` in the shared `_i18n` bundle, one of the
+            // four shared files a module author had to edit — and this module's
+            // bundle held nothing but error sentences until now.
+            labelKey: 'nav.organizations.label',
+            // The glyph `AppShell.tsx` rendered by hand, and already on
+            // `KnownIconNameSchema` — the palette action this batch declares names
+            // the same one.
+            icon: 'Building2',
+            section: 'customers',
+            // Third in *Customers*, which is where the hand-written table put it:
+            // after `customers`' two rows (100 and 200, declared in this same batch)
+            // and before `customer_accounts`' and `credit_limits`' 400 and
+            // `comparisons`' 600.
+            weight: 300,
+            requiredPermission: [...READ_PERMISSION],
+        },
+    ],
+};
+//# sourceMappingURL=index.js.map

package/dist/admin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/admin/index.ts"],"names":[],"mappings":"AA6BA;;;;;;;;;;;;;;GAcG;AACH,MAAM,eAAe,GAA8B,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAAC;AAE1F,2DAA2D;AAC3D,MAAM,UAAU,GAAG,gBAAgB,CAAC;AAEpC,MAAM,CAAC,MAAM,aAAa,GAAuB;IAC/C,MAAM,EAAE;QACN;YACE,IAAI,EAAE,UAAU;YAChB,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,8BAA8B,CAAC;YACvD,kBAAkB,EAAE,CAAC,GAAG,eAAe,CAAC;YACxC,KAAK,EAAE,IAAI;SACZ;QACD;YACE,IAAI,EAAE,GAAG,UAAU,MAAM;YACzB,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,+BAA+B,CAAC;YACxD,kBAAkB,EAAE,CAAC,GAAG,eAAe,CAAC;SACzC;KACF;IACD,iEAAiE;IACjE,4EAA4E;IAC5E,2DAA2D;IAC3D,GAAG,EAAE;QACH;YACE,EAAE,EAAE,UAAU;YACd,uEAAuE;YACvE,iDAAiD;YACjD,wEAAwE;YACxE,oEAAoE;YACpE,qDAAqD;YACrD,QAAQ,EAAE,yBAAyB;YACnC,4DAA4D;YAC5D,uEAAuE;YACvE,gBAAgB;YAChB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,WAAW;YACpB,sEAAsE;YACtE,yEAAyE;YACzE,+DAA+D;YAC/D,sBAAsB;YACtB,MAAM,EAAE,GAAG;YACX,kBAAkB,EAAE,CAAC,GAAG,eAAe,CAAC;SACzC;KACF;CACF,CAAC"}

package/dist/admin/pages/OrganizationDetail.d.ts

@@ -0,0 +1,9 @@
+import { type ReactNode } from 'react';
+export declare function OrganizationDetail(): ReactNode;
+/**
+ * The registry loads a route component through a dynamic-import factory and
+ * reads its default export (feature 091, FR-013). The named export stays: it is
+ * the spelling this module's own code and its tests use.
+ */
+export default OrganizationDetail;
+//# sourceMappingURL=OrganizationDetail.d.ts.map

package/dist/admin/pages/OrganizationDetail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrganizationDetail.d.ts","sourceRoot":"","sources":["../../../src/admin/pages/OrganizationDetail.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AA+DzE,wBAAgB,kBAAkB,IAAI,SAAS,CAwoB9C;AAED;;;;GAIG;AACH,eAAe,kBAAkB,CAAC"}