@endora-commerce/mod-pim-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-pim-connector
+
+Shared operator behaviours for PIM connectors: mutual exclusion, run/issue vocabulary and field-protection path grammar.
+
+## What this is
+
+An **Endora Commerce module package**. Its module id is `pim_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-pim-connector` | the module manifest — its id, version, dependencies, settings and activation |
+| `@endora-commerce/mod-pim-connector/backend` | the composition root the platform calls, with the entities, services, routes and workers it registers |
+| `@endora-commerce/mod-pim-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-pim-connector
+```
+
+## Licence
+
+MIT — the text is in `LICENSE`, beside this file.

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

@@ -0,0 +1,15 @@
+import { OptionalProps } from '@mikro-orm/core';
+/** Fixed primary key — one diagnostic row per deployment (feature 089, data-model.md). */
+export declare const PIM_CONNECTOR_ACTIVATION_LOCK_SINGLETON_ID = "00000000-0000-4000-8000-000000000001";
+/**
+ * Mirrors the last successful PIM connector activation write for audit/diagnostics.
+ * Authoritative mutual-exclusion checks read sibling activation Settings.
+ */
+export declare class PimConnectorActivationLock {
+    [OptionalProps]?: 'updatedAt';
+    id: string;
+    activeModuleId?: string | null;
+    updatedAt: Date;
+    updatedByAdminId?: string | null;
+}
+//# sourceMappingURL=pim-connector-activation-lock.entity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pim-connector-activation-lock.entity.d.ts","sourceRoot":"","sources":["../../../src/backend/entities/pim-connector-activation-lock.entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,aAAa,EAAwB,MAAM,iBAAiB,CAAC;AAG9E,0FAA0F;AAC1F,eAAO,MAAM,0CAA0C,yCAAyC,CAAC;AAEjG;;;GAGG;AACH,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/pim-connector-activation-lock.entity.js

@@ -0,0 +1,46 @@
+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 089, data-model.md). */
+export const PIM_CONNECTOR_ACTIVATION_LOCK_SINGLETON_ID = '00000000-0000-4000-8000-000000000001';
+/**
+ * Mirrors the last successful PIM connector activation write for audit/diagnostics.
+ * Authoritative mutual-exclusion checks read sibling activation Settings.
+ */
+let PimConnectorActivationLock = class PimConnectorActivationLock {
+    [OptionalProps];
+    id = PIM_CONNECTOR_ACTIVATION_LOCK_SINGLETON_ID;
+    activeModuleId;
+    updatedAt = new Date();
+    updatedByAdminId;
+};
+__decorate([
+    PrimaryKey({ type: 'uuid' }),
+    __metadata("design:type", String)
+], PimConnectorActivationLock.prototype, "id", void 0);
+__decorate([
+    Property({ type: 'varchar', length: 64, fieldName: 'active_module_id', nullable: true }),
+    __metadata("design:type", Object)
+], PimConnectorActivationLock.prototype, "activeModuleId", void 0);
+__decorate([
+    Property({ type: 'timestamptz', fieldName: 'updated_at' }),
+    __metadata("design:type", Date)
+], PimConnectorActivationLock.prototype, "updatedAt", void 0);
+__decorate([
+    Property({ type: 'uuid', fieldName: 'updated_by_admin_id', nullable: true }),
+    __metadata("design:type", Object)
+], PimConnectorActivationLock.prototype, "updatedByAdminId", void 0);
+PimConnectorActivationLock = __decorate([
+    GlobalEntity(),
+    Entity({ tableName: 'pim_connector_activation_lock' })
+], PimConnectorActivationLock);
+export { PimConnectorActivationLock };
+//# sourceMappingURL=pim-connector-activation-lock.entity.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pim-connector-activation-lock.entity.js","sourceRoot":"","sources":["../../../src/backend/entities/pim-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,GAAG,sCAAsC,CAAC;AAEjG;;;GAGG;AAGI,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 { PimConnectorActivationLock } from './entities/pim-connector-activation-lock.entity.js';
+export declare function registerModule(ctx: ModuleContext): void;
+export declare const entities: (typeof PimConnectorActivationLock)[];
+//# 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;AAYhG,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CA6FvD;AAgBD,eAAO,MAAM,QAAQ,uCAA+B,CAAC"}

package/dist/backend/index.js

@@ -0,0 +1,106 @@
+import { effectiveState, lazyPort } from '@endora-commerce/platform/kernel';
+import { CAPABILITY_KEYS } from '@endora-commerce/contracts';
+import { PimConnectorActivationLock } from './entities/pim-connector-activation-lock.entity.js';
+import { PimConnectorRegistryService } from './services/pim-connector-registry.service.js';
+export function registerModule(ctx) {
+    ctx.di.providePort('pimConnectorRegistryPort', ctx
+        .asFunction(({ emFactory }) => new PimConnectorRegistryService(emFactory))
+        .singleton());
+    /**
+     * **The** exclusivity seam — one interceptor, registered by the capability's
+     * owner over the derived family (feature 132,
+     * `specs/132-connector-family-discovery/contracts/capability-exclusivity.md`
+     * R1.1–R1.2).
+     *
+     * It used to be registered by **one member**, with that member's own id
+     * hard-coded in the handler, so every new connector had to remember to write one
+     * — and two of the four shipped ones did not. Registered here over
+     * `declaredMembersOfCapability`, a connector that declares membership is
+     * covered **by existing**, and the failure mode stops being a silent gap.
+     *
+     * Three properties of the placement are load-bearing:
+     *
+     *  - **This module is always present.** It declares
+     *    `activation.nonDeactivatable`, so the seam cannot be switched off by the
+     *    operator whose activation attempt it is judging.
+     *  - **Interceptor gating uses the platform axis** (`registryCache.isEnabled`),
+     *    so the handler still runs while the *member* is operator-deactivated —
+     *    which is exactly when an activation attempt arrives.
+     *  - **It refuses before the audited Command runs** (`pre`), so a refused
+     *    activation writes nothing: Principle XIII keeps the write audited and this
+     *    keeps the refusal out of the write's way.
+     *
+     * The membership test reads **declared** members, not effective ones: the
+     * question is "is the module being activated one of mine", and a module about
+     * to be switched on is by definition not effectively present. Which members
+     * *hold* the claim is the registry's question, and it resolves effective
+     * presence (R2.2).
+     */
+    ctx.interceptors([
+        {
+            id: 'refuse-when-another-family-member-is-active',
+            target: 'POST /api/v1/admin/modules/:id/activation',
+            phase: 'pre',
+            handler: async (interceptorCtx) => {
+                const { params, body } = interceptorCtx;
+                const moduleId = params !== null && typeof params === 'object' && 'id' in params
+                    ? String(params.id)
+                    : '';
+                const active = body !== null &&
+                    typeof body === 'object' &&
+                    'active' in body &&
+                    body.active === true;
+                // Deactivation is never refused by this seam (R2.4).
+                if (moduleId === '' || !active)
+                    return;
+                if (!isFamilyMember(moduleId))
+                    return;
+                await lazyPort(ctx, 'pimConnectorRegistryPort').assertCanActivate(moduleId);
+            },
+        },
+    ]);
+    /**
+     * Feature 089 / T079 — mirror a member's successful activation flip onto the
+     * diagnostic lock row. Owned here (always present) so the handler still runs
+     * when the event fires before local presence has refreshed after activate, and
+     * after deactivate when the member itself is already absent.
+     *
+     * Feature 132 — the test compared `event.moduleId` against one connector's id
+     * written out here, so the lock was accurate for one connector out of four and
+     * this module named a member it does not own. It is a membership test over the
+     * derived family now, and **declared**
+     * membership is the right side of it for the reason above: on a deactivation the
+     * member is already absent, so an effective-presence test would drop exactly the
+     * event that has to clear the lock.
+     */
+    ctx.subscribe('module.activation.changed', async (payload) => {
+        const event = payload;
+        const moduleId = event.moduleId;
+        if (moduleId === undefined || typeof event.active !== 'boolean')
+            return;
+        if (!isFamilyMember(moduleId))
+            return;
+        const registry = lazyPort(ctx, 'pimConnectorRegistryPort');
+        if (event.active) {
+            await registry.recordActive(moduleId, null);
+        }
+        else {
+            await registry.clearActive(moduleId);
+        }
+    });
+}
+/**
+ * Whether `moduleId` declared membership of the capability this module owns.
+ *
+ * The family is read from the platform on every call rather than captured at
+ * registration: `registryCache` is re-installed by the `b2b:module:state-changed`
+ * refresh, and a list closed over at composition time would answer for the
+ * deployment as it was when this module registered.
+ */
+function isFamilyMember(moduleId) {
+    return effectiveState
+        .declaredMembersOfCapability(CAPABILITY_KEYS.PIM_CONNECTOR)
+        .includes(moduleId);
+}
+export const entities = [PimConnectorActivationLock];
+//# 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,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,GAAG,CAAC,YAAY,CAAC;QACf;YACE,EAAE,EAAE,6CAA6C;YACjD,MAAM,EAAE,2CAA2C;YACnD,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,KAAK,EAAE,cAGf,EAAiB,EAAE;gBAClB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,cAAc,CAAC;gBACxC,MAAM,QAAQ,GACZ,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,IAAI,IAAI,MAAM;oBAC7D,CAAC,CAAC,MAAM,CAAE,MAA0B,CAAC,EAAE,CAAC;oBACxC,CAAC,CAAC,EAAE,CAAC;gBACT,MAAM,MAAM,GACV,IAAI,KAAK,IAAI;oBACb,OAAO,IAAI,KAAK,QAAQ;oBACxB,QAAQ,IAAI,IAAI;oBACf,IAA4B,CAAC,MAAM,KAAK,IAAI,CAAC;gBAChD,qDAAqD;gBACrD,IAAI,QAAQ,KAAK,EAAE,IAAI,CAAC,MAAM;oBAAE,OAAO;gBACvC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC;oBAAE,OAAO;gBACtC,MAAM,QAAQ,CAA2B,GAAG,EAAE,0BAA0B,CAAC,CAAC,iBAAiB,CACzF,QAAQ,CACT,CAAC;YACJ,CAAC;SACF;KACF,CAAC,CAAC;IAEH;;;;;;;;;;;;;OAaG;IACH,GAAG,CAAC,SAAS,CAAC,2BAA2B,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAC3D,MAAM,KAAK,GAAG,OAAyC,CAAC;QACxD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAChC,IAAI,QAAQ,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO;QACxE,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC;YAAE,OAAO;QACtC,MAAM,QAAQ,GAAG,QAAQ,CAA2B,GAAG,EAAE,0BAA0B,CAAC,CAAC;QACrF,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,QAAQ,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,MAAM,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,cAAc,CAAC,QAAgB;IACtC,OAAO,cAAc;SAClB,2BAA2B,CAAC,eAAe,CAAC,aAAa,CAAC;SAC1D,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,0BAA0B,CAAC,CAAC"}

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

@@ -0,0 +1,48 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { type PimConnectorRegistryPort } from '@endora-commerce/contracts';
+/**
+ * How the registry asks **who is in the family and present** (feature 132,
+ * `capability-exclusivity.md` R2.1–R2.2).
+ *
+ * Two things moved here and both were defects.
+ *
+ * The member list was `PIM_CONNECTOR_MODULES`, a hand-written array in
+ * `@endora-commerce/contracts` that named two of the four shipped connectors — so
+ * exclusivity covered 2 of the 12 ordered pairs, a connector outside this
+ * repository could not join at all, and an overlay module had to edit a core file
+ * to. It is now the members' own manifest declarations, derived on every
+ * composition, so a connector that declares membership is covered **by existing**.
+ *
+ * The axis was `presence(id)?.operatorActivated`, which answers `true` for a
+ * module whose *platform* availability is off — a connector the deployment never
+ * installed holding a claim that refuses another. It is now the conjunction
+ * `effectiveState.membersOfCapability` computes: a module that is off behaves as
+ * if never installed (Principle XVII, spec FR-012).
+ *
+ * The default reads the platform's effective state directly, so it stays in
+ * lockstep with `/platform/modules` flips — those refresh presence immediately
+ * and do not go through the settings cache the activation Command bypasses.
+ */
+export interface PimConnectorFamilyReader {
+    /** The family members whose **effective** presence is true, in manifest order. */
+    activeMembers(): readonly string[];
+}
+export declare class PimConnectorRegistryService implements PimConnectorRegistryPort {
+    private readonly emFactory;
+    private readonly family;
+    constructor(emFactory: () => EntityManager, family?: PimConnectorFamilyReader);
+    assertCanActivate(moduleId: string): Promise<void>;
+    recordActive(moduleId: string, adminId: string | null): Promise<void>;
+    clearActive(moduleId: string): Promise<void>;
+    getActiveModuleId(): Promise<string | null>;
+    /**
+     * The member holding the claim, or `null`.
+     *
+     * `exceptModuleId` is excluded even though an effectively-present module is by
+     * definition not the one being switched on: the activation route is idempotent,
+     * so `POST {active:true}` against the module that already holds the claim must
+     * not be refused by the claim it holds.
+     */
+    private findActiveSibling;
+}
+//# sourceMappingURL=pim-connector-registry.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pim-connector-registry.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/pim-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;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,wBAAwB;IACvC,kFAAkF;IAClF,aAAa,IAAI,SAAS,MAAM,EAAE,CAAC;CACpC;AAQD,qBAAa,2BAA4B,YAAW,wBAAwB;IAExE,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,SAAS,EAAE,MAAM,aAAa,EAC9B,MAAM,GAAE,wBAA8C;IAGnE,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;IAsBrE,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe5C,iBAAiB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQjD;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB;CAO1B"}

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

@@ -0,0 +1,83 @@
+import { CAPABILITY_KEYS, ERROR_CODES, } from '@endora-commerce/contracts';
+import { effectiveState } from '@endora-commerce/platform/kernel';
+import { HttpError } from '@endora-commerce/platform/http';
+import { PIM_CONNECTOR_ACTIVATION_LOCK_SINGLETON_ID, PimConnectorActivationLock, } from '../entities/pim-connector-activation-lock.entity.js';
+const defaultFamilyReader = {
+    activeMembers() {
+        return effectiveState.membersOfCapability(CAPABILITY_KEYS.PIM_CONNECTOR);
+    },
+};
+export class PimConnectorRegistryService {
+    emFactory;
+    family;
+    constructor(emFactory, family = defaultFamilyReader) {
+        this.emFactory = emFactory;
+        this.family = family;
+    }
+    async assertCanActivate(moduleId) {
+        const activeSibling = this.findActiveSibling(moduleId);
+        if (activeSibling !== null) {
+            throw new HttpError(409, ERROR_CODES.PIM_CONNECTOR_ALREADY_ACTIVE, `Another PIM connector is already active: ${activeSibling}`, { activeModuleId: activeSibling });
+        }
+    }
+    async recordActive(moduleId, adminId) {
+        const em = this.emFactory();
+        let row = await em.findOne(PimConnectorActivationLock, {
+            id: PIM_CONNECTOR_ACTIVATION_LOCK_SINGLETON_ID,
+        });
+        if (row === null) {
+            // command-coverage-ignore: mutual-exclusion bookkeeping. Mirrors the operator's
+            // PIM activation choice in the lock row; the activation write itself is audited.
+            row = em.create(PimConnectorActivationLock, {
+                id: PIM_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(PimConnectorActivationLock, {
+            id: PIM_CONNECTOR_ACTIVATION_LOCK_SINGLETON_ID,
+        });
+        if (row === null || row.activeModuleId !== moduleId) {
+            return;
+        }
+        // command-coverage-ignore: mutual-exclusion bookkeeping. Clears the lock when the
+        // named connector deactivates; the activation write itself is audited.
+        row.activeModuleId = null;
+        row.updatedAt = new Date();
+        await em.flush();
+    }
+    async getActiveModuleId() {
+        const em = this.emFactory();
+        const row = await em.findOne(PimConnectorActivationLock, {
+            id: PIM_CONNECTOR_ACTIVATION_LOCK_SINGLETON_ID,
+        });
+        return row?.activeModuleId ?? null;
+    }
+    /**
+     * The member holding the claim, or `null`.
+     *
+     * `exceptModuleId` is excluded even though an effectively-present module is by
+     * definition not the one being switched on: the activation route is idempotent,
+     * so `POST {active:true}` against the module that already holds the claim must
+     * not be refused by the claim it holds.
+     */
+    findActiveSibling(exceptModuleId) {
+        for (const moduleId of this.family.activeMembers()) {
+            if (moduleId === exceptModuleId)
+                continue;
+            return moduleId;
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=pim-connector-registry.service.js.map

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

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

package/dist/manifest.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Shared PIM connector infrastructure — feature 089.
+ *
+ * Owns mutual-exclusion registry and field-path grammar shared by UnoPim now
+ * and future PIM connectors. No import pipeline.
+ */
+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;;;;;GAKG;AAEH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCnB,CAAC"}

package/dist/manifest.js

@@ -0,0 +1,45 @@
+import { CAPABILITY_KEYS, defineModuleManifest } from '@endora-commerce/contracts';
+/**
+ * Shared PIM connector infrastructure — feature 089.
+ *
+ * Owns mutual-exclusion registry and field-path grammar shared by UnoPim now
+ * and future PIM connectors. No import pipeline.
+ */
+export const manifest = defineModuleManifest({
+    id: 'pim_connector',
+    name: 'PIM connector shared layer',
+    description: 'Shared operator behaviours for PIM connectors: mutual exclusion, run/issue vocabulary and field-protection path grammar.',
+    version: '1.0.0',
+    dependencies: ['settings', 'admin_users'],
+    activation: {
+        nonDeactivatable: true,
+        reason: 'The shared PIM connector registry must stay available so operator activation of a PIM connector can be refused when another is already active.',
+    },
+    i18n: { bundlesDir: 'i18n' },
+    /**
+     * Feature 132 — this module **owns** the PIM connector capability and declares
+     * it mutually exclusive, minting the code an operator meets
+     * (`contracts/module-capabilities.md` R3.1).
+     *
+     * The owner declares exclusivity and a member never can, which is what keeps
+     * three things from coming loose. The refusal code stays on the semantic owner,
+     * so a member raises `PIM_CONNECTOR_ALREADY_ACTIVE` and must **not** declare it
+     * (D-95.2, and one member's manifest carries the paragraph explaining that).
+     * A connector cannot make the family exclusive by accident and cannot un-make
+     * it. And a deployment that installs a connector without this shared layer has
+     * a family that is simply not exclusive there (R3.5) — the honest answer, since
+     * without this module there is no lock row and nothing to enforce with.
+     *
+     * This module is **not** a member of the key it owns: an owner that were also a
+     * member would exclude itself from its own family, and `defineModuleManifest`
+     * refuses the pair (R3.3 / R4.4).
+     */
+    exclusiveCapabilities: [
+        {
+            key: CAPABILITY_KEYS.PIM_CONNECTOR,
+            errorCode: 'PIM_CONNECTOR_ALREADY_ACTIVE',
+        },
+    ],
+    errorCodes: [{ code: 'PIM_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;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAG,oBAAoB,CAAC;IAC3C,EAAE,EAAE,eAAe;IACnB,IAAI,EAAE,4BAA4B;IAClC,WAAW,EACT,0HAA0H;IAC5H,OAAO,EAAE,OAAO;IAChB,YAAY,EAAE,CAAC,UAAU,EAAE,aAAa,CAAC;IACzC,UAAU,EAAE;QACV,gBAAgB,EAAE,IAAI;QACtB,MAAM,EACJ,gJAAgJ;KACnJ;IACD,IAAI,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE;IAC5B;;;;;;;;;;;;;;;;;OAiBG;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/20260826T153500_pim_connector_init.d.ts

@@ -0,0 +1,11 @@
+import { Migration } from '@mikro-orm/migrations';
+/**
+ * Feature 089 — `pim_connector` shared layer (init).
+ *
+ * Creates `pim_connector_activation_lock` per data-model.md.
+ */
+export declare class Migration20260826T153500PimConnectorInit extends Migration {
+    up(): Promise<void>;
+    down(): Promise<void>;
+}
+//# sourceMappingURL=20260826T153500_pim_connector_init.d.ts.map

package/dist/migrations/20260826T153500_pim_connector_init.d.ts.map

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

package/dist/migrations/20260826T153500_pim_connector_init.js

@@ -0,0 +1,29 @@
+import { Migration } from '@mikro-orm/migrations';
+/**
+ * Feature 089 — `pim_connector` shared layer (init).
+ *
+ * Creates `pim_connector_activation_lock` per data-model.md.
+ */
+export class Migration20260826T153500PimConnectorInit extends Migration {
+    async up() {
+        this.addSql(`
+      create table "pim_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 "pim_connector_activation_lock_pkey" primary key ("id")
+      );
+    `);
+        this.addSql(`
+      alter table "pim_connector_activation_lock"
+        add constraint "pim_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 "pim_connector_activation_lock" cascade;`);
+    }
+}
+//# sourceMappingURL=20260826T153500_pim_connector_init.js.map

package/dist/migrations/20260826T153500_pim_connector_init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260826T153500_pim_connector_init.js","sourceRoot":"","sources":["../../src/migrations/20260826T153500_pim_connector_init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;GAIG;AACH,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 { Migration20260826T153500PimConnectorInit } from './20260826T153500_pim_connector_init.js';
+export declare const migrations: (typeof Migration20260826T153500PimConnectorInit)[];
+export { Migration20260826T153500PimConnectorInit };
+//# 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 { Migration20260826T153500PimConnectorInit } from './20260826T153500_pim_connector_init.js';
+export const migrations = [Migration20260826T153500PimConnectorInit];
+export { Migration20260826T153500PimConnectorInit };
+//# 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 @@
+{
+  "registry.alreadyActive": "Another PIM connector is already active: {{moduleId}}",
+  "registry.alreadyActive.detail": "Deactivate the other connector before activating this one.",
+  "errors.PIM_CONNECTOR_ALREADY_ACTIVE": "Another PIM connector is already active ({activeModuleId}). Switch it off first."
+}

package/i18n/pl.json

@@ -0,0 +1,5 @@
+{
+  "registry.alreadyActive": "Inny konektor PIM jest już aktywny: {{moduleId}}",
+  "registry.alreadyActive.detail": "Dezaktywuj drugi konektor przed włączeniem tego.",
+  "errors.PIM_CONNECTOR_ALREADY_ACTIVE": "Inny connector PIM jest już aktywny ({activeModuleId}). Najpierw go wyłącz."
+}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@endora-commerce/mod-pim-connector",
+  "version": "0.100.0",
+  "type": "module",
+  "sideEffects": false,
+  "description": "Shared operator behaviours for PIM connectors: mutual exclusion, run/issue vocabulary and field-protection path grammar.",
+  "license": "MIT",
+  "endora": {
+    "type": "module",
+    "id": "pim_connector"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/endora-commerce/endora-commerce.git",
+    "directory": "packages/modules/pim_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"
+  }
+}