@endora-commerce/mod-organizations 0.100.0

package/dist/backend/services/organization-effective-pricelists-service.js

@@ -0,0 +1,68 @@
+import { evaluateApplicationRule, } from '@endora-commerce/contracts';
+import { Organization } from '../entities/organization.entity.js';
+/**
+ * Returns the set of Price Lists currently applicable to a given
+ * Organization, each tagged with the reasons it applies. Implementation
+ * reuses the existing application-rule evaluator (no new persistence
+ * surface) — see research.md R6.
+ */
+export class OrganizationEffectivePriceListsService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async listApplicable(organizationId) {
+        const em = this.deps.emFactory();
+        const org = await em.findOne(Organization, { id: organizationId, deletedAt: null });
+        if (!org)
+            return [];
+        const salesChannelId = await this.deps.resolveDefaultSalesChannelId();
+        const now = new Date();
+        const candidates = await this.deps.priceListRead.listActive();
+        const ctx = {
+            organizationId: org.id,
+            customerGroupId: org.customerGroupId ?? null,
+            salesChannelId,
+            currencyCode: 'PLN',
+            productCategoryIds: new Set(),
+        };
+        const results = [];
+        for (const pl of candidates) {
+            // Time-window check: skip lists that haven't started or have expired.
+            if (pl.startsAt && pl.startsAt > now)
+                continue;
+            if (pl.endsAt && pl.endsAt < now)
+                continue;
+            const evaluation = evaluateApplicationRule(pl.applicationRule, ctx);
+            if (!evaluation.matched)
+                continue;
+            const reasons = [];
+            if (evaluation.explicitOn.has('organization'))
+                reasons.push('direct_organization_match');
+            if (evaluation.explicitOn.has('customerGroup'))
+                reasons.push('customer_group_match');
+            if (evaluation.explicitOn.has('salesChannel'))
+                reasons.push('sales_channel_inheritance');
+            if (evaluation.explicitOn.has('category'))
+                reasons.push('segment_rule_match');
+            // The "all" rule (kind='all') matches without any explicitOn — surface
+            // as a segment-rule-match-like blanket entry so the UI shows something.
+            if (reasons.length === 0)
+                reasons.push('segment_rule_match');
+            results.push({
+                priceListId: pl.id,
+                name: pl.name,
+                priority: reasons.length, // higher specificity → higher priority
+                reasons,
+            });
+        }
+        // Sort by priority desc, then by name asc for stable display.
+        results.sort((a, b) => {
+            if (b.priority !== a.priority)
+                return b.priority - a.priority;
+            return a.name.localeCompare(b.name);
+        });
+        return results;
+    }
+}
+//# sourceMappingURL=organization-effective-pricelists-service.js.map

package/dist/backend/services/organization-effective-pricelists-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"organization-effective-pricelists-service.js","sourceRoot":"","sources":["../../../src/backend/services/organization-effective-pricelists-service.ts"],"names":[],"mappings":"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"}

package/dist/backend/services/organization-inheritance-service.d.ts

@@ -0,0 +1,73 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { CreditLimitReadPort } from '@endora-commerce/contracts';
+import type { OrganizationTreeService } from './organization-tree-service.js';
+/**
+ * OrganizationInheritanceService (feature 056 US3) — the organizations-owned
+ * resolution port that the price-list resolver and the credit-limit service
+ * call to walk the ancestor chain (Principle I). No schema change to
+ * `price_lists` / `credit_limits`; inheritance is resolution semantics (R5/R6).
+ *
+ * Flat behavior is preserved: for a root org (no ancestors) the price-list org
+ * chain is `[orgId]` and `creditOwner` is the org itself (or none), collapsing
+ * to today's single-org resolution byte-for-byte (FR-013).
+ */
+export type CreditInheritanceMode = 'shared_pool' | 'independent_default';
+export interface CreditOwner {
+    /** Nearest ancestor-or-self holding a `CreditLimit` row, or null when none exists. */
+    readonly ownerOrgId: string | null;
+    /** Effective mode: the owner's per-org column, else the Settings global default. */
+    readonly mode: CreditInheritanceMode;
+}
+export declare class OrganizationInheritanceService {
+    private readonly emFactory;
+    private readonly treeService;
+    /**
+     * `creditLimitReadPort`, owned by `credit_limits` — which links of an
+     * ancestor chain hold a limit at all (feature 077, D-87).
+     *
+     * **Required**, and third rather than last, because the optional shape is
+     * the one that fails open: a composition that omitted it would answer
+     * "nobody in this chain has a limit" for every organisation, which is a
+     * plausible reading and the wrong one. The read it replaces was raw SQL
+     * against that module's table, so an absent or switched-off owner made no
+     * difference to the answer at all.
+     */
+    private readonly creditLimits;
+    /**
+     * Resolves the Settings global default `organizations.hierarchy.credit_inheritance_mode`.
+     * Defaults to `shared_pool` (factory default, R6) when not injected.
+     */
+    private readonly resolveGlobalCreditMode;
+    constructor(emFactory: () => EntityManager, treeService: OrganizationTreeService, 
+    /**
+     * `creditLimitReadPort`, owned by `credit_limits` — which links of an
+     * ancestor chain hold a limit at all (feature 077, D-87).
+     *
+     * **Required**, and third rather than last, because the optional shape is
+     * the one that fails open: a composition that omitted it would answer
+     * "nobody in this chain has a limit" for every organisation, which is a
+     * plausible reading and the wrong one. The read it replaces was raw SQL
+     * against that module's table, so an absent or switched-off owner made no
+     * difference to the answer at all.
+     */
+    creditLimits: CreditLimitReadPort, 
+    /**
+     * Resolves the Settings global default `organizations.hierarchy.credit_inheritance_mode`.
+     * Defaults to `shared_pool` (factory default, R6) when not injected.
+     */
+    resolveGlobalCreditMode?: () => Promise<CreditInheritanceMode>);
+    /** Ancestor ids of `orgId`, nearest-first (parent → … → root). `[]` for a root. */
+    ancestorIds(orgId: string): Promise<string[]>;
+    /**
+     * Ordered org candidate set for price-list resolution: `[orgId, ...ancestorIds]`
+     * (nearest-first). A nearer org outranks a farther ancestor (R5).
+     */
+    priceListOrgChain(orgId: string): Promise<string[]>;
+    /**
+     * Nearest ancestor-or-self holding a `CreditLimit` row, plus the effective
+     * credit-inheritance mode (the owner's per-org column, else the global default).
+     * `ownerOrgId` is null when neither the org nor any ancestor has a limit.
+     */
+    creditOwner(orgId: string): Promise<CreditOwner>;
+}
+//# sourceMappingURL=organization-inheritance-service.d.ts.map

package/dist/backend/services/organization-inheritance-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"organization-inheritance-service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/organization-inheritance-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAE9E;;;;;;;;;GASG;AAEH,MAAM,MAAM,qBAAqB,GAAG,aAAa,GAAG,qBAAqB,CAAC;AAE1E,MAAM,WAAW,WAAW;IAC1B,sFAAsF;IACtF,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,oFAAoF;IACpF,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;CACtC;AAED,qBAAa,8BAA8B;IAEvC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,uBAAuB;gBAlBvB,SAAS,EAAE,MAAM,aAAa,EAC9B,WAAW,EAAE,uBAAuB;IACrD;;;;;;;;;;OAUG;IACc,YAAY,EAAE,mBAAmB;IAClD;;;OAGG;IACc,uBAAuB,GAAE,MAAM,OAAO,CAAC,qBAAqB,CAC9D;IAGjB,mFAAmF;IAC7E,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAInD;;;OAGG;IACG,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIzD;;;;OAIG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAuBvD"}

package/dist/backend/services/organization-inheritance-service.js

@@ -0,0 +1,63 @@
+export class OrganizationInheritanceService {
+    emFactory;
+    treeService;
+    creditLimits;
+    resolveGlobalCreditMode;
+    constructor(emFactory, treeService, 
+    /**
+     * `creditLimitReadPort`, owned by `credit_limits` — which links of an
+     * ancestor chain hold a limit at all (feature 077, D-87).
+     *
+     * **Required**, and third rather than last, because the optional shape is
+     * the one that fails open: a composition that omitted it would answer
+     * "nobody in this chain has a limit" for every organisation, which is a
+     * plausible reading and the wrong one. The read it replaces was raw SQL
+     * against that module's table, so an absent or switched-off owner made no
+     * difference to the answer at all.
+     */
+    creditLimits, 
+    /**
+     * Resolves the Settings global default `organizations.hierarchy.credit_inheritance_mode`.
+     * Defaults to `shared_pool` (factory default, R6) when not injected.
+     */
+    resolveGlobalCreditMode = async () => 'shared_pool') {
+        this.emFactory = emFactory;
+        this.treeService = treeService;
+        this.creditLimits = creditLimits;
+        this.resolveGlobalCreditMode = resolveGlobalCreditMode;
+    }
+    /** Ancestor ids of `orgId`, nearest-first (parent → … → root). `[]` for a root. */
+    async ancestorIds(orgId) {
+        return this.treeService.ancestorIds(orgId);
+    }
+    /**
+     * Ordered org candidate set for price-list resolution: `[orgId, ...ancestorIds]`
+     * (nearest-first). A nearer org outranks a farther ancestor (R5).
+     */
+    async priceListOrgChain(orgId) {
+        return [orgId, ...(await this.treeService.ancestorIds(orgId))];
+    }
+    /**
+     * Nearest ancestor-or-self holding a `CreditLimit` row, plus the effective
+     * credit-inheritance mode (the owner's per-org column, else the global default).
+     * `ownerOrgId` is null when neither the org nor any ancestor has a limit.
+     */
+    async creditOwner(orgId) {
+        const chain = [orgId, ...(await this.treeService.ancestorIds(orgId))]; // nearest-first
+        // Which orgs in the chain hold a credit limit? Asked of the module that
+        // owns the table, not selected out of it (feature 077, D-87). No `catch`:
+        // a switched-off `credit_limits` must refuse here rather than report an
+        // empty chain, which downstream reads as "no limit applies".
+        const hasLimit = new Set(await this.creditLimits.organizationsWithLimit(chain));
+        const ownerOrgId = chain.find((id) => hasLimit.has(id)) ?? null;
+        if (!ownerOrgId) {
+            return { ownerOrgId: null, mode: await this.resolveGlobalCreditMode() };
+        }
+        // This module's own table, so it stays a statement here.
+        const modeRows = (await this.emFactory().getConnection().execute(`select "credit_inheritance_mode" from "organizations" where "id" = ?`, [ownerOrgId]));
+        const ownMode = modeRows[0]?.credit_inheritance_mode ?? null;
+        const mode = ownMode ?? (await this.resolveGlobalCreditMode());
+        return { ownerOrgId, mode };
+    }
+}
+//# sourceMappingURL=organization-inheritance-service.js.map

package/dist/backend/services/organization-inheritance-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"organization-inheritance-service.js","sourceRoot":"","sources":["../../../src/backend/services/organization-inheritance-service.ts"],"names":[],"mappings":"AAwBA,MAAM,OAAO,8BAA8B;IAEtB;IACA;IAYA;IAKA;IAnBnB,YACmB,SAA8B,EAC9B,WAAoC;IACrD;;;;;;;;;;OAUG;IACc,YAAiC;IAClD;;;OAGG;IACc,0BAAgE,KAAK,IAAI,EAAE,CAC1F,aAAa;QAnBE,cAAS,GAAT,SAAS,CAAqB;QAC9B,gBAAW,GAAX,WAAW,CAAyB;QAYpC,iBAAY,GAAZ,YAAY,CAAqB;QAKjC,4BAAuB,GAAvB,uBAAuB,CACzB;IACd,CAAC;IAEJ,mFAAmF;IACnF,KAAK,CAAC,WAAW,CAAC,KAAa;QAC7B,OAAO,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,iBAAiB,CAAC,KAAa;QACnC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACjE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,WAAW,CAAC,KAAa;QAC7B,MAAM,KAAK,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB;QAEvF,wEAAwE;QACxE,0EAA0E;QAC1E,wEAAwE;QACxE,6DAA6D;QAC7D,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC,CAAC;QAChF,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC;QAEhE,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC,uBAAuB,EAAE,EAAE,CAAC;QAC1E,CAAC;QAED,yDAAyD;QACzD,MAAM,QAAQ,GAAG,CAAC,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,aAAa,EAAE,CAAC,OAAO,CAC9D,sEAAsE,EACtE,CAAC,UAAU,CAAC,CACb,CAAqE,CAAC;QACvE,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,uBAAuB,IAAI,IAAI,CAAC;QAC7D,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,MAAM,IAAI,CAAC,uBAAuB,EAAE,CAAC,CAAC;QAC/D,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IAC9B,CAAC;CACF"}

package/dist/backend/services/organization-moderation-service.d.ts

@@ -0,0 +1,124 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { Organization, type OrganizationStatus } from '../entities/organization.entity.js';
+import type { AuditPort } from '@endora-commerce/platform/kernel';
+import type { CustomerAccountReadPort, EmailMailerPort } from '@endora-commerce/contracts';
+import type { OrganizationEventBus } from './registration-service.js';
+import { type OrgTemplateEmail } from './org-template-email.js';
+/**
+ * OrganizationModerationService — owns every status transition on the
+ * Organization entity (feature 026 US1 + US3).
+ *
+ * Lifecycle (see `data-model.md` §3 state diagram):
+ *   pending_verification -> active   via approve()
+ *   pending_verification -> rejected via reject(reason)
+ *   active               -> blocked  via block(reason?)
+ *   blocked              -> active   via unblock()
+ *
+ * Every transition is recorded to `audit_log_entries` with `before/after`
+ * snapshots and the actor; emits `organization.status_changed.v1` so the
+ * notifier + downstream consumers (pricing cache, sales-rep dashboards)
+ * can react. Each write is gated by the Organization's `version` column
+ * — mismatch raises `OrganizationVersionMismatchError` which routes map
+ * to HTTP 409 with `currentVersion` in the body.
+ *
+ * The service also exposes `handleNewlyRegistered(orgId)` — invoked by
+ * the registration-event subscriber so the moderation-mode setting
+ * (`organizations.moderation.mode`) flips the new org straight to
+ * `active` when the platform runs in `auto` mode. The subscriber is
+ * wired in the composition root.
+ *
+ * Customer email notifications (approval, rejection) go through the
+ * admin-editable transactional template, which resolves them in the
+ * recipient's language, and fall back to the English in-code builders below
+ * only when the platform holds no definition for the code. The recipient is
+ * the Organization's first `organization_admin` Customer account, read through
+ * `customer_accounts`' published port (feature 075, D-87).
+ */
+export interface ModerationActorContext {
+    actorAdminUserId?: string | null;
+    requestId?: string | null;
+}
+export interface ApproveOptions extends ModerationActorContext {
+    expectedVersion: number;
+}
+export interface RejectOptions extends ModerationActorContext {
+    expectedVersion: number;
+    reason: string;
+    notifyCustomerEmail?: boolean;
+}
+export interface BlockOptions extends ModerationActorContext {
+    expectedVersion: number;
+    reason?: string | null;
+}
+export interface UnblockOptions extends ModerationActorContext {
+    expectedVersion: number;
+}
+export declare class OrganizationModerationService {
+    private readonly emFactory;
+    private readonly auditLogService;
+    private readonly events;
+    private readonly mailer;
+    /**
+     * `customer_accounts`' published read, for the one question this service
+     * asks it: who receives the approval or rejection message.
+     */
+    private readonly customerAccounts;
+    /** Resolver for the moderation-mode setting. Returns 'auto' or 'manual'. */
+    private readonly resolveModerationMode;
+    /**
+     * The transactional-template seam, which is where the language comes from.
+     *
+     * Defaulted to the no-op rather than made required so a composition that
+     * does not wire it keeps sending — silence would be worse than the
+     * fallback language, which is the whole argument for keeping the in-code
+     * builders below.
+     */
+    private readonly templateEmail;
+    constructor(emFactory: () => EntityManager, auditLogService: AuditPort, events: OrganizationEventBus, mailer: EmailMailerPort, 
+    /**
+     * `customer_accounts`' published read, for the one question this service
+     * asks it: who receives the approval or rejection message.
+     */
+    customerAccounts: CustomerAccountReadPort, 
+    /** Resolver for the moderation-mode setting. Returns 'auto' or 'manual'. */
+    resolveModerationMode: () => Promise<'auto' | 'manual'>, 
+    /**
+     * The transactional-template seam, which is where the language comes from.
+     *
+     * Defaulted to the no-op rather than made required so a composition that
+     * does not wire it keeps sending — silence would be worse than the
+     * fallback language, which is the whole argument for keeping the in-code
+     * builders below.
+     */
+    templateEmail?: OrgTemplateEmail);
+    /**
+     * Invoked by the `organization.registered.v1` subscriber. When the
+     * setting is `auto`, the freshly created org is approved immediately
+     * (system actor = null adminUserId). When `manual`, this is a no-op
+     * — the org stays in `pending_verification` until an admin acts.
+     */
+    handleNewlyRegistered(organizationId: string): Promise<void>;
+    approve(organizationId: string, options: ApproveOptions): Promise<Organization>;
+    reject(organizationId: string, options: RejectOptions): Promise<Organization>;
+    block(organizationId: string, options: BlockOptions): Promise<Organization>;
+    unblock(organizationId: string, options: UnblockOptions): Promise<Organization>;
+    private transition;
+    private notifyCustomer;
+}
+export declare class OrganizationNotFoundError extends Error {
+    readonly organizationId: string;
+    constructor(organizationId: string);
+}
+export declare class OrganizationVersionMismatchError extends Error {
+    readonly organizationId: string;
+    readonly expectedVersion: number;
+    readonly currentVersion: number;
+    constructor(organizationId: string, expectedVersion: number, currentVersion: number);
+}
+export declare class OrganizationStatusGuardError extends Error {
+    readonly organizationId: string;
+    readonly currentStatus: OrganizationStatus;
+    readonly requiredStatus: OrganizationStatus;
+    constructor(organizationId: string, currentStatus: OrganizationStatus, requiredStatus: OrganizationStatus);
+}
+//# sourceMappingURL=organization-moderation-service.d.ts.map

package/dist/backend/services/organization-moderation-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"organization-moderation-service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/organization-moderation-service.ts"],"names":[],"mappings":"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"}