@endora-commerce/mod-erp-connector 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,49 @@
+<!-- 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-erp-connector
+
+Shared operator behaviours for ERP connectors: mutual exclusion and sync job vocabulary.
+
+## What this is
+
+An **Endora Commerce module package**. Its module id is `erp_connector` — 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-erp-connector` | the module manifest — its id, version, dependencies, settings and activation |
+| `@endora-commerce/mod-erp-connector/backend` | the composition root the platform calls, with the entities, services, routes and workers it registers |
+| `@endora-commerce/mod-erp-connector/migrations` | the module’s own schema migrations, in the order the platform runs them |
+
+## 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/contracts`
+- `@endora-commerce/platform`
+
+**Third-party**
+
+- `@mikro-orm/core` ^6
+- `@mikro-orm/migrations` ^6
+- `@mikro-orm/postgresql` ^6
+
+## 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
+
+## Install
+
+```bash
+pnpm add @endora-commerce/mod-erp-connector
+```
+
+## Licence
+
+MIT — the text is in `LICENSE`, beside this file.

package/dist/backend/entities/erp-connector-activation-lock.entity.d.ts

@@ -0,0 +1,11 @@
+import { OptionalProps } from '@mikro-orm/core';
+/** Fixed primary key — one diagnostic row per deployment (feature 119, data-model.md). */
+export declare const ERP_CONNECTOR_ACTIVATION_LOCK_SINGLETON_ID = "00000000-0000-4000-8000-000000000002";
+export declare class ErpConnectorActivationLock {
+    [OptionalProps]?: 'updatedAt';
+    id: string;
+    activeModuleId?: string | null;
+    updatedAt: Date;
+    updatedByAdminId?: string | null;
+}
+//# sourceMappingURL=erp-connector-activation-lock.entity.d.ts.map

package/dist/backend/entities/erp-connector-activation-lock.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"erp-connector-activation-lock.entity.d.ts","sourceRoot":"","sources":["../../../src/backend/entities/erp-connector-activation-lock.entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,aAAa,EAAwB,MAAM,iBAAiB,CAAC;AAG9E,0FAA0F;AAC1F,eAAO,MAAM,0CAA0C,yCACf,CAAC;AAEzC,qBAEa,0BAA0B;IACrC,CAAC,aAAa,CAAC,CAAC,EAAE,WAAW,CAAC;IAG9B,EAAE,EAAE,MAAM,CAA8C;IAGxD,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAG/B,SAAS,EAAE,IAAI,CAAc;IAG7B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC"}

package/dist/backend/entities/erp-connector-activation-lock.entity.js

@@ -0,0 +1,42 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { Entity, OptionalProps, PrimaryKey, Property } from '@mikro-orm/core';
+import { GlobalEntity } from '@endora-commerce/platform/tenancy';
+/** Fixed primary key — one diagnostic row per deployment (feature 119, data-model.md). */
+export const ERP_CONNECTOR_ACTIVATION_LOCK_SINGLETON_ID = '00000000-0000-4000-8000-000000000002';
+let ErpConnectorActivationLock = class ErpConnectorActivationLock {
+    [OptionalProps];
+    id = ERP_CONNECTOR_ACTIVATION_LOCK_SINGLETON_ID;
+    activeModuleId;
+    updatedAt = new Date();
+    updatedByAdminId;
+};
+__decorate([
+    PrimaryKey({ type: 'uuid' }),
+    __metadata("design:type", String)
+], ErpConnectorActivationLock.prototype, "id", void 0);
+__decorate([
+    Property({ type: 'varchar', length: 64, fieldName: 'active_module_id', nullable: true }),
+    __metadata("design:type", Object)
+], ErpConnectorActivationLock.prototype, "activeModuleId", void 0);
+__decorate([
+    Property({ type: 'timestamptz', fieldName: 'updated_at' }),
+    __metadata("design:type", Date)
+], ErpConnectorActivationLock.prototype, "updatedAt", void 0);
+__decorate([
+    Property({ type: 'uuid', fieldName: 'updated_by_admin_id', nullable: true }),
+    __metadata("design:type", Object)
+], ErpConnectorActivationLock.prototype, "updatedByAdminId", void 0);
+ErpConnectorActivationLock = __decorate([
+    GlobalEntity(),
+    Entity({ tableName: 'erp_connector_activation_lock' })
+], ErpConnectorActivationLock);
+export { ErpConnectorActivationLock };
+//# sourceMappingURL=erp-connector-activation-lock.entity.js.map

package/dist/backend/entities/erp-connector-activation-lock.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"erp-connector-activation-lock.entity.js","sourceRoot":"","sources":["../../../src/backend/entities/erp-connector-activation-lock.entity.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAEjE,0FAA0F;AAC1F,MAAM,CAAC,MAAM,0CAA0C,GACrD,sCAAsC,CAAC;AAIlC,IAAM,0BAA0B,GAAhC,MAAM,0BAA0B;IACrC,CAAC,aAAa,CAAC,CAAe;IAG9B,EAAE,GAAW,0CAA0C,CAAC;IAGxD,cAAc,CAAiB;IAG/B,SAAS,GAAS,IAAI,IAAI,EAAE,CAAC;IAG7B,gBAAgB,CAAiB;CAClC,CAAA;AAVC;IADC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;sDAC2B;AAGxD;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;kEAC1D;AAG/B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;8BAChD,IAAI;6DAAc;AAG7B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,qBAAqB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;oEAC5C;AAbtB,0BAA0B;IAFtC,YAAY,EAAE;IACd,MAAM,CAAC,EAAE,SAAS,EAAE,+BAA+B,EAAE,CAAC;GAC1C,0BAA0B,CActC"}

package/dist/backend/index.d.ts

@@ -0,0 +1,5 @@
+import type { ModuleContext } from '@endora-commerce/platform/kernel';
+import { ErpConnectorActivationLock } from './entities/erp-connector-activation-lock.entity.js';
+export declare function registerModule(ctx: ModuleContext): void;
+export declare const entities: (typeof ErpConnectorActivationLock)[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAGtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,oDAAoD,CAAC;AA+ChG,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CA6CvD;AAED,eAAO,MAAM,QAAQ,uCAA+B,CAAC"}

package/dist/backend/index.js

@@ -0,0 +1,74 @@
+import { effectiveState, lazyPort } from '@endora-commerce/platform/kernel';
+import { CAPABILITY_KEYS } from '@endora-commerce/contracts';
+import { ErpConnectorActivationLock } from './entities/erp-connector-activation-lock.entity.js';
+import { ErpConnectorRegistryService } from './services/erp-connector-registry.service.js';
+/**
+ * Feature 132 (T027) — family membership, derived and read when it is asked.
+ *
+ * This was a union type and a module-level `Set`, both built from
+ * `ERP_CONNECTOR_MODULES` at import time. The union was the sharper problem: it
+ * made "is this module an ERP connector" a **compile-time** question, so a
+ * connector installed from npm or shipped by a deployment's overlay could not be
+ * one — which is exactly the population the exclusion has to cover.
+ *
+ * **Declared** membership, not effective: on a *deactivation* the member is already
+ * absent, and an effective-presence test would drop the event that clears the lock.
+ */
+function isErpConnectorModuleId(moduleId) {
+    return effectiveState
+        .declaredMembersOfCapability(CAPABILITY_KEYS.ERP_CONNECTOR)
+        .includes(moduleId);
+}
+function moduleActivationRequest(input) {
+    const moduleId = input.params !== null && typeof input.params === 'object' && 'id' in input.params
+        ? String(input.params.id)
+        : '';
+    const active = input.body !== null &&
+        typeof input.body === 'object' &&
+        'active' in input.body &&
+        input.body.active === true;
+    if (!moduleId || !active || !isErpConnectorModuleId(moduleId))
+        return null;
+    return { moduleId, active };
+}
+export function registerModule(ctx) {
+    ctx.di.providePort('erpConnectorRegistryPort', ctx
+        .asFunction(({ emFactory }) => new ErpConnectorRegistryService(emFactory))
+        .singleton());
+    /**
+     * Feature 119 / FR-006 — mutual exclusion on the operator-activation axis for
+     * every `erpConnector: true` module. Owned here (always present) so the check
+     * runs while any connector is operator-deactivated — exactly when an activation
+     * attempt arrives.
+     */
+    ctx.interceptors([
+        {
+            id: 'refuse-when-sibling-erp-active',
+            target: 'POST /api/v1/admin/modules/:id/activation',
+            phase: 'pre',
+            handler: async (interceptorCtx) => {
+                const request = moduleActivationRequest(interceptorCtx);
+                if (!request)
+                    return;
+                await lazyPort(ctx, 'erpConnectorRegistryPort').assertCanActivate(request.moduleId);
+            },
+        },
+    ]);
+    ctx.subscribe('module.activation.changed', async (payload) => {
+        const event = payload;
+        if (!event.moduleId ||
+            typeof event.active !== 'boolean' ||
+            !isErpConnectorModuleId(event.moduleId)) {
+            return;
+        }
+        const registry = lazyPort(ctx, 'erpConnectorRegistryPort');
+        if (event.active) {
+            await registry.recordActive(event.moduleId, null);
+        }
+        else {
+            await registry.clearActive(event.moduleId);
+        }
+    });
+}
+export const entities = [ErpConnectorActivationLock];
+//# sourceMappingURL=index.js.map

package/dist/backend/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAiC,MAAM,4BAA4B,CAAC;AAC5F,OAAO,EAAE,0BAA0B,EAAE,MAAM,oDAAoD,CAAC;AAChG,OAAO,EAAE,2BAA2B,EAAE,MAAM,8CAA8C,CAAC;AAW3F;;;;;;;;;;;GAWG;AACH,SAAS,sBAAsB,CAAC,QAAgB;IAC9C,OAAO,cAAc;SAClB,2BAA2B,CAAC,eAAe,CAAC,aAAa,CAAC;SAC1D,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACxB,CAAC;AAED,SAAS,uBAAuB,CAAC,KAGhC;IACC,MAAM,QAAQ,GACZ,KAAK,CAAC,MAAM,KAAK,IAAI,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,IAAI,KAAK,CAAC,MAAM;QAC/E,CAAC,CAAC,MAAM,CAAE,KAAK,CAAC,MAA0B,CAAC,EAAE,CAAC;QAC9C,CAAC,CAAC,EAAE,CAAC;IACT,MAAM,MAAM,GACV,KAAK,CAAC,IAAI,KAAK,IAAI;QACnB,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9B,QAAQ,IAAI,KAAK,CAAC,IAAI;QACrB,KAAK,CAAC,IAA4B,CAAC,MAAM,KAAK,IAAI,CAAC;IACtD,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3E,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAkB;IAC/C,GAAG,CAAC,EAAE,CAAC,WAAW,CAChB,0BAA0B,EAC1B,GAAG;SACA,UAAU,CAAC,CAAC,EAAE,SAAS,EAAsB,EAAE,EAAE,CAAC,IAAI,2BAA2B,CAAC,SAAS,CAAC,CAAC;SAC7F,SAAS,EAAE,CACf,CAAC;IAEF;;;;;OAKG;IACH,GAAG,CAAC,YAAY,CAAC;QACf;YACE,EAAE,EAAE,gCAAgC;YACpC,MAAM,EAAE,2CAA2C;YACnD,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,KAAK,EAAE,cAAkD,EAAiB,EAAE;gBACnF,MAAM,OAAO,GAAG,uBAAuB,CAAC,cAAc,CAAC,CAAC;gBACxD,IAAI,CAAC,OAAO;oBAAE,OAAO;gBACrB,MAAM,QAAQ,CAA2B,GAAG,EAAE,0BAA0B,CAAC,CAAC,iBAAiB,CACzF,OAAO,CAAC,QAAQ,CACjB,CAAC;YACJ,CAAC;SACF;KACF,CAAC,CAAC;IAEH,GAAG,CAAC,SAAS,CAAC,2BAA2B,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAC3D,MAAM,KAAK,GAAG,OAAyC,CAAC;QACxD,IACE,CAAC,KAAK,CAAC,QAAQ;YACf,OAAO,KAAK,CAAC,MAAM,KAAK,SAAS;YACjC,CAAC,sBAAsB,CAAC,KAAK,CAAC,QAAQ,CAAC,EACvC,CAAC;YACD,OAAO;QACT,CAAC;QACD,MAAM,QAAQ,GAAG,QAAQ,CAA2B,GAAG,EAAE,0BAA0B,CAAC,CAAC;QACrF,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACpD,CAAC;aAAM,CAAC;YACN,MAAM,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,0BAA0B,CAAC,CAAC"}

package/dist/backend/services/erp-connector-registry.service.d.ts

@@ -0,0 +1,45 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { type ErpConnectorRegistryPort } from '@endora-commerce/contracts';
+export interface ErpActivationPresenceReader {
+    isOperatorActivated(moduleId: string): boolean;
+}
+/**
+ * The ERP family, from the members' own manifest declarations.
+ *
+ * This was `ERP_CONNECTOR_MODULES` in `@endora-commerce/contracts`, and this family
+ * is the one whose array carried a live Principle XV violation: an **overlay**
+ * module of the `example` deployment had to be written into that core file to join,
+ * because there was no other way in. It declares `capabilities` in its own manifest
+ * now and core is untouched.
+ */
+export declare function declaredErpConnectorModules(): ReadonlyArray<{
+    id: string;
+}>;
+export declare class ErpConnectorRegistryService implements ErpConnectorRegistryPort {
+    private readonly emFactory;
+    private readonly presence;
+    /**
+     * A **function**, because the derived family is re-installed by every
+     * `b2b:module:state-changed` refresh and a list captured when this singleton was
+     * built would answer for the deployment as it was then.
+     */
+    private readonly modules;
+    constructor(emFactory: () => EntityManager, presence?: ErpActivationPresenceReader, 
+    /**
+     * A **function**, because the derived family is re-installed by every
+     * `b2b:module:state-changed` refresh and a list captured when this singleton was
+     * built would answer for the deployment as it was then.
+     */
+    modules?: ReadonlyArray<{
+        id: string;
+    }> | (() => ReadonlyArray<{
+        id: string;
+    }>));
+    private connectorModules;
+    assertCanActivate(moduleId: string): Promise<void>;
+    recordActive(moduleId: string, adminId: string | null): Promise<void>;
+    clearActive(moduleId: string): Promise<void>;
+    getActiveModuleId(): Promise<string | null>;
+    private findActiveSibling;
+}
+//# sourceMappingURL=erp-connector-registry.service.d.ts.map

package/dist/backend/services/erp-connector-registry.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"erp-connector-registry.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/erp-connector-registry.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,4BAA4B,CAAC;AAQpC,MAAM,WAAW,2BAA2B;IAC1C,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAChD;AAgBD;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,IAAI,aAAa,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAI3E;AAED,qBAAa,2BAA4B,YAAW,wBAAwB;IAExE,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAPP,SAAS,EAAE,MAAM,aAAa,EAC9B,QAAQ,GAAE,2BAAmD;IAC9E;;;;OAIG;IACc,OAAO,GACpB,aAAa,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,GAC7B,CAAC,MAAM,aAAa,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAA+B;IAGzE,OAAO,CAAC,gBAAgB;IAIlB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBrE,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc5C,iBAAiB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQjD,OAAO,CAAC,iBAAiB;CAS1B"}

package/dist/backend/services/erp-connector-registry.service.js

@@ -0,0 +1,108 @@
+import { CAPABILITY_KEYS, ERROR_CODES, } from '@endora-commerce/contracts';
+import { effectiveState } from '@endora-commerce/platform/kernel';
+import { HttpError } from '@endora-commerce/platform/http';
+import { ERP_CONNECTOR_ACTIVATION_LOCK_SINGLETON_ID, ErpConnectorActivationLock, } from '../entities/erp-connector-activation-lock.entity.js';
+/**
+ * Feature 132 (T027) — **effective** presence, not the activation Setting alone.
+ *
+ * `presence(moduleId)?.operatorActivated` answers `true` for a module whose
+ * platform availability is off, so a connector the deployment never installed held
+ * a claim that refused another. `isPresent` is the conjunction Principle XVII
+ * means and the one place the two axes are combined (spec FR-012).
+ */
+const defaultPresenceReader = {
+    isOperatorActivated(moduleId) {
+        return effectiveState.isPresent(moduleId);
+    },
+};
+/**
+ * The ERP family, from the members' own manifest declarations.
+ *
+ * This was `ERP_CONNECTOR_MODULES` in `@endora-commerce/contracts`, and this family
+ * is the one whose array carried a live Principle XV violation: an **overlay**
+ * module of the `example` deployment had to be written into that core file to join,
+ * because there was no other way in. It declares `capabilities` in its own manifest
+ * now and core is untouched.
+ */
+export function declaredErpConnectorModules() {
+    return effectiveState
+        .declaredMembersOfCapability(CAPABILITY_KEYS.ERP_CONNECTOR)
+        .map((id) => ({ id }));
+}
+export class ErpConnectorRegistryService {
+    emFactory;
+    presence;
+    modules;
+    constructor(emFactory, presence = defaultPresenceReader, 
+    /**
+     * A **function**, because the derived family is re-installed by every
+     * `b2b:module:state-changed` refresh and a list captured when this singleton was
+     * built would answer for the deployment as it was then.
+     */
+    modules = declaredErpConnectorModules) {
+        this.emFactory = emFactory;
+        this.presence = presence;
+        this.modules = modules;
+    }
+    connectorModules() {
+        return typeof this.modules === 'function' ? this.modules() : this.modules;
+    }
+    async assertCanActivate(moduleId) {
+        const activeSibling = this.findActiveSibling(moduleId);
+        if (activeSibling !== null) {
+            throw new HttpError(409, ERROR_CODES.ERP_CONNECTOR_ALREADY_ACTIVE, `Another ERP connector is already active: ${activeSibling}`, { activeModuleId: activeSibling });
+        }
+    }
+    async recordActive(moduleId, adminId) {
+        const em = this.emFactory();
+        let row = await em.findOne(ErpConnectorActivationLock, {
+            id: ERP_CONNECTOR_ACTIVATION_LOCK_SINGLETON_ID,
+        });
+        if (row === null) {
+            // command-coverage-ignore: mutual-exclusion bookkeeping mirrors operator activation.
+            row = em.create(ErpConnectorActivationLock, {
+                id: ERP_CONNECTOR_ACTIVATION_LOCK_SINGLETON_ID,
+                activeModuleId: moduleId,
+                updatedByAdminId: adminId,
+                updatedAt: new Date(),
+            });
+        }
+        else {
+            row.activeModuleId = moduleId;
+            row.updatedByAdminId = adminId;
+            row.updatedAt = new Date();
+        }
+        await em.flush();
+    }
+    async clearActive(moduleId) {
+        const em = this.emFactory();
+        const row = await em.findOne(ErpConnectorActivationLock, {
+            id: ERP_CONNECTOR_ACTIVATION_LOCK_SINGLETON_ID,
+        });
+        if (row === null || row.activeModuleId !== moduleId) {
+            return;
+        }
+        // command-coverage-ignore: mutual-exclusion bookkeeping clears the lock on deactivation.
+        row.activeModuleId = null;
+        row.updatedAt = new Date();
+        await em.flush();
+    }
+    async getActiveModuleId() {
+        const em = this.emFactory();
+        const row = await em.findOne(ErpConnectorActivationLock, {
+            id: ERP_CONNECTOR_ACTIVATION_LOCK_SINGLETON_ID,
+        });
+        return row?.activeModuleId ?? null;
+    }
+    findActiveSibling(exceptModuleId) {
+        for (const sibling of this.connectorModules()) {
+            if (sibling.id === exceptModuleId)
+                continue;
+            if (this.presence.isOperatorActivated(sibling.id)) {
+                return sibling.id;
+            }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=erp-connector-registry.service.js.map

package/dist/backend/services/erp-connector-registry.service.js.map

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

package/dist/manifest.d.ts

@@ -0,0 +1,162 @@
+/** Shared ERP connector infrastructure — feature 119. */
+export declare const manifest: {
+    id: string;
+    name: string;
+    version: string;
+    dependencies: string[];
+    description?: string | undefined;
+    acknowledgedDependencies?: {
+        moduleId: string;
+        port: string;
+        reason: string;
+    }[] | undefined;
+    nonBindingDependencies?: {
+        moduleId: string;
+        name: string;
+        kind: "contributes-to" | "degrades-without" | "refuses-without";
+        reason: string;
+        whenAbsent?: string | undefined;
+    }[] | undefined;
+    activation?: {
+        settingCode: string;
+        default: boolean;
+    } | {
+        nonDeactivatable: true;
+        reason: string;
+    } | undefined;
+    settings?: {
+        moduleCode: string;
+        groups: {
+            code: string;
+            name: string;
+            salesChannelCodes?: string[] | undefined;
+            isSystemProtected?: boolean | undefined;
+        }[];
+        settings: {
+            code: string;
+            name: string;
+            valueType: "string" | "number" | "boolean" | "json" | "string_list" | "secret" | "credential_ref";
+            defaultValue: unknown;
+            description?: string | undefined;
+            groupCode?: string | undefined;
+            previousDefaultValues?: unknown[] | undefined;
+            salesChannelCodes?: string[] | undefined;
+            enumOptions?: string[] | undefined;
+            configurationType?: string | undefined;
+            hidden?: boolean | undefined;
+        }[];
+    } | undefined;
+    i18n?: {
+        bundlesDir: string;
+    } | undefined;
+    docs?: false | {
+        dir: string;
+    } | undefined;
+    demo?: false | {
+        summary: string;
+        seed: (context: import("@endora-commerce/contracts").ModuleDemoContext<never>) => Promise<import("@endora-commerce/contracts").DemoSeedResult>;
+        reset: (context: import("@endora-commerce/contracts").ModuleDemoContext<never>) => Promise<import("@endora-commerce/contracts").DemoResetResult>;
+        after?: readonly string[] | undefined;
+        package?: string | undefined;
+    } | undefined;
+    actions?: {
+        id: string;
+        labelKey: string;
+        icon: "Plus" | "Sparkles" | "Settings" | "Search" | "Boxes" | "Layers" | "Menu" | "PlusCircle" | "PlusSquare" | "FilePlus" | "FolderPlus" | "Upload" | "FileUp" | "CloudUpload" | "Download" | "FileDown" | "FileText" | "BookOpen" | "Rss" | "Package" | "Tag" | "ShoppingCart" | "Receipt" | "CreditCard" | "Users" | "UserPlus" | "Inbox" | "ListChecks" | "ClipboardList" | "Image" | "Video" | "LayoutDashboard" | "PanelLeft" | "KeyRound" | "ShieldCheck" | "Edit" | "Archive" | "Box" | "Truck" | "CircleDollarSign" | "Activity" | "LineChart" | "Smartphone" | "Webhook" | "Scale" | "PlugZap" | "PercentDiamond" | "Newspaper" | "Languages" | "Eraser" | "Warehouse" | "TrendingDown" | "Bell" | "PackageOpen" | "Building2" | "Store" | "ClipboardCheck";
+        targetRoute: string;
+        keywords: string[];
+        weight: number;
+        descriptionKey?: string | undefined;
+        requiredPermission?: string | undefined;
+    }[] | undefined;
+    permissions?: {
+        code: string;
+        label: string;
+        module?: string | undefined;
+        description?: string | undefined;
+        requires?: string[] | undefined;
+    }[] | undefined;
+    transactionalEmails?: {
+        code: string;
+        name: string;
+        variables: {
+            key: string;
+            label: string;
+            sampleValue?: string | undefined;
+            description?: string | undefined;
+        }[];
+        description?: string | undefined;
+        group?: string | undefined;
+    }[] | undefined;
+    capabilities?: string[] | undefined;
+    exclusiveCapabilities?: {
+        key: string;
+        errorCode: string;
+    }[] | undefined;
+    errorCodes?: {
+        code: string;
+        tokens?: string[] | undefined;
+    }[] | undefined;
+    blocks?: {
+        name: string;
+        labelKey: string;
+        category: string;
+        contexts: ("invoice" | "email" | "cms" | "newsletter")[];
+        fields: Record<string, {
+            type: "number" | "object" | "array" | "text" | "textarea" | "select" | "radio" | "external" | "uuid" | "richtext";
+            label?: string | undefined;
+            required?: boolean | undefined;
+            options?: {
+                label: string;
+                value: string | number;
+            }[] | undefined;
+            refKind?: string | undefined;
+        }>;
+        descriptionKey?: string | undefined;
+        defaultProps?: Record<string, unknown> | undefined;
+        responsiveFields?: string[] | undefined;
+        previewIcon?: string | undefined;
+        weight?: number | undefined;
+    }[] | undefined;
+    blockCategories?: {
+        key: string;
+        titleKey: string;
+        contexts: ("invoice" | "email" | "cms" | "newsletter")[];
+        weight?: number | undefined;
+        visible?: boolean | undefined;
+    }[] | undefined;
+    env?: {
+        name: string;
+        describes: {
+            en: string;
+            pl: string;
+        };
+        requirement: {
+            kind: "required";
+        } | {
+            kind: "requiredWhen";
+            input: string;
+            equals: string;
+        } | {
+            kind: "optional";
+            without: {
+                en: string;
+                pl: string;
+            };
+        };
+        secret: boolean;
+        generable: boolean;
+        owner: {
+            kind: "platform";
+        } | {
+            kind: "application";
+            application: "admin" | "backend" | "storefront";
+        } | {
+            kind: "module";
+            moduleId: string;
+        };
+        consumers: ("admin" | "backend" | "storefront")[];
+        addressOf: "admin" | "backend" | "storefront" | null;
+    }[] | undefined;
+};
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAEA,yDAAyD;AAEzD,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCnB,CAAC"}

package/dist/manifest.js

@@ -0,0 +1,34 @@
+import { CAPABILITY_KEYS, defineModuleManifest } from '@endora-commerce/contracts';
+/** Shared ERP connector infrastructure — feature 119. */
+export const manifest = defineModuleManifest({
+    id: 'erp_connector',
+    name: 'ERP connector shared layer',
+    description: 'Shared operator behaviours for ERP connectors: mutual exclusion and sync job vocabulary.',
+    version: '1.0.0',
+    dependencies: ['settings', 'admin_users'],
+    activation: {
+        nonDeactivatable: true,
+        reason: 'The shared ERP connector registry must stay available so operator activation of an ERP connector can be refused when another is already active.',
+    },
+    i18n: { bundlesDir: 'i18n' },
+    docs: false,
+    /**
+     * Feature 132 — this module **owns** the ERP connector capability and declares it
+     * mutually exclusive (`contracts/module-capabilities.md` R3.1).
+     *
+     * This is the family whose old shape carried a live Principle XV violation: one
+     * of its members is a per-deployment **overlay** module, and it had to be written
+     * into `packages/contracts/src/erp-connector.ts` — a core file the deployment does
+     * not own — to be seen by the exclusion at all. There was no other way in. After
+     * this, it declares membership in its own manifest and core is untouched, which
+     * `backend/test/integration/erp_connector/overlay-joins.test.ts` asserts directly.
+     */
+    exclusiveCapabilities: [
+        {
+            key: CAPABILITY_KEYS.ERP_CONNECTOR,
+            errorCode: 'ERP_CONNECTOR_ALREADY_ACTIVE',
+        },
+    ],
+    errorCodes: [{ code: 'ERP_CONNECTOR_ALREADY_ACTIVE' }],
+});
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAEnF,yDAAyD;AAEzD,MAAM,CAAC,MAAM,QAAQ,GAAG,oBAAoB,CAAC;IAC3C,EAAE,EAAE,eAAe;IACnB,IAAI,EAAE,4BAA4B;IAClC,WAAW,EACT,0FAA0F;IAC5F,OAAO,EAAE,OAAO;IAChB,YAAY,EAAE,CAAC,UAAU,EAAE,aAAa,CAAC;IACzC,UAAU,EAAE;QACV,gBAAgB,EAAE,IAAI;QACtB,MAAM,EACJ,iJAAiJ;KACpJ;IACD,IAAI,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE;IAC5B,IAAI,EAAE,KAAK;IACX;;;;;;;;;;OAUG;IACH,qBAAqB,EAAE;QACrB;YACE,GAAG,EAAE,eAAe,CAAC,aAAa;YAClC,SAAS,EAAE,8BAA8B;SAC1C;KACF;IACD,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,8BAA8B,EAAE,CAAC;CACvD,CAAC,CAAC"}

package/dist/migrations/20260911T120000_erp_connector_init.d.ts

@@ -0,0 +1,7 @@
+import { Migration } from '@mikro-orm/migrations';
+/** Feature 119 — `erp_connector` shared layer (init). */
+export declare class Migration20260911T120000ErpConnectorInit extends Migration {
+    up(): Promise<void>;
+    down(): Promise<void>;
+}
+//# sourceMappingURL=20260911T120000_erp_connector_init.d.ts.map

package/dist/migrations/20260911T120000_erp_connector_init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260911T120000_erp_connector_init.d.ts","sourceRoot":"","sources":["../../src/migrations/20260911T120000_erp_connector_init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,yDAAyD;AACzD,qBAAa,wCAAyC,SAAQ,SAAS;IACtD,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBnB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAGrC"}

package/dist/migrations/20260911T120000_erp_connector_init.js

@@ -0,0 +1,25 @@
+import { Migration } from '@mikro-orm/migrations';
+/** Feature 119 — `erp_connector` shared layer (init). */
+export class Migration20260911T120000ErpConnectorInit extends Migration {
+    async up() {
+        this.addSql(`
+      create table "erp_connector_activation_lock" (
+        "id" uuid not null,
+        "active_module_id" varchar(64) null,
+        "updated_at" timestamptz not null,
+        "updated_by_admin_id" uuid null,
+        constraint "erp_connector_activation_lock_pkey" primary key ("id")
+      );
+    `);
+        this.addSql(`
+      alter table "erp_connector_activation_lock"
+        add constraint "erp_connector_activation_lock_updated_by_admin_id_foreign"
+        foreign key ("updated_by_admin_id") references "admin_users" ("id")
+        on update cascade on delete set null;
+    `);
+    }
+    async down() {
+        this.addSql(`drop table if exists "erp_connector_activation_lock" cascade;`);
+    }
+}
+//# sourceMappingURL=20260911T120000_erp_connector_init.js.map

package/dist/migrations/20260911T120000_erp_connector_init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260911T120000_erp_connector_init.js","sourceRoot":"","sources":["../../src/migrations/20260911T120000_erp_connector_init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,yDAAyD;AACzD,MAAM,OAAO,wCAAyC,SAAQ,SAAS;IAC5D,KAAK,CAAC,EAAE;QACf,IAAI,CAAC,MAAM,CAAC;;;;;;;;KAQX,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC;;;;;KAKX,CAAC,CAAC;IACL,CAAC;IAEQ,KAAK,CAAC,IAAI;QACjB,IAAI,CAAC,MAAM,CAAC,+DAA+D,CAAC,CAAC;IAC/E,CAAC;CACF"}

package/dist/migrations/index.d.ts

@@ -0,0 +1,4 @@
+import { Migration20260911T120000ErpConnectorInit } from './20260911T120000_erp_connector_init.js';
+export declare const migrations: (typeof Migration20260911T120000ErpConnectorInit)[];
+export { Migration20260911T120000ErpConnectorInit };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wCAAwC,EAAE,MAAM,yCAAyC,CAAC;AAEnG,eAAO,MAAM,UAAU,qDAA6C,CAAC;AAErE,OAAO,EAAE,wCAAwC,EAAE,CAAC"}

package/dist/migrations/index.js

@@ -0,0 +1,4 @@
+import { Migration20260911T120000ErpConnectorInit } from './20260911T120000_erp_connector_init.js';
+export const migrations = [Migration20260911T120000ErpConnectorInit];
+export { Migration20260911T120000ErpConnectorInit };
+//# sourceMappingURL=index.js.map

package/dist/migrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wCAAwC,EAAE,MAAM,yCAAyC,CAAC;AAEnG,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,wCAAwC,CAAC,CAAC;AAErE,OAAO,EAAE,wCAAwC,EAAE,CAAC"}

package/i18n/en.json

@@ -0,0 +1,5 @@
+{
+  "erp_connector.nav.label": "ERP connectors",
+  "erp_connector.nav.description": "Shared ERP connector infrastructure",
+  "errors.ERP_CONNECTOR_ALREADY_ACTIVE": "Another ERP connector is already active ({activeModuleId}). Switch it off first."
+}

package/i18n/pl.json

@@ -0,0 +1,5 @@
+{
+  "erp_connector.nav.label": "Konektory ERP",
+  "erp_connector.nav.description": "Wspólna warstwa konektorów ERP",
+  "errors.ERP_CONNECTOR_ALREADY_ACTIVE": "Inny connector ERP jest już aktywny ({activeModuleId}). Najpierw go wyłącz."
+}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@endora-commerce/mod-erp-connector",
+  "version": "0.100.0",
+  "type": "module",
+  "sideEffects": false,
+  "description": "Shared operator behaviours for ERP connectors: mutual exclusion and sync job vocabulary.",
+  "license": "MIT",
+  "endora": {
+    "type": "module",
+    "id": "erp_connector"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/endora-commerce/endora-commerce.git",
+    "directory": "packages/modules/erp_connector"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/manifest.d.ts",
+      "default": "./dist/manifest.js"
+    },
+    "./backend": {
+      "types": "./dist/backend/index.d.ts",
+      "default": "./dist/backend/index.js"
+    },
+    "./migrations": {
+      "types": "./dist/migrations/index.d.ts",
+      "default": "./dist/migrations/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "i18n"
+  ],
+  "engines": {
+    "node": ">=22.18.0"
+  },
+  "peerDependencies": {
+    "@mikro-orm/core": "^6",
+    "@mikro-orm/migrations": "^6",
+    "@mikro-orm/postgresql": "^6",
+    "@endora-commerce/contracts": "0.100.0",
+    "@endora-commerce/platform": "0.100.0"
+  },
+  "devDependencies": {
+    "@mikro-orm/core": "^6.6.13",
+    "@mikro-orm/migrations": "^6.6.13",
+    "@mikro-orm/postgresql": "^6.6.13",
+    "@types/node": "^22.9.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.11",
+    "@endora-commerce/contracts": "0.100.0",
+    "@endora-commerce/platform": "0.100.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json",
+    "lint": "eslint src",
+    "test": "vitest run"
+  }
+}