@tolinax/ayoune-interfaces 2026.62.0 → 2026.64.0

package/data/modelNames.d.ts

@@ -412,6 +412,10 @@ export declare enum aMN {
     MarketBudgetsByIndustries = "MarketBudgetsByIndustries",
     IndustryKPIs = "IndustryKPIs",
     MarketResearches = "MarketResearches",
+    MarketplaceApps = "MarketplaceApps",
+    MarketplaceBundles = "MarketplaceBundles",
+    MarketplaceInstallations = "MarketplaceInstallations",
+    MarketplaceReviews = "MarketplaceReviews",
     Markets = "Markets",
     MaterialCommissionings = "MaterialCommissionings",
     MeetingLocations = "MeetingLocations",
@@ -531,6 +535,7 @@ export declare enum aMN {
     Repositories = "Repositories",
     Requirements = "Requirements",
     ResearchBudgets = "ResearchBudgets",
+    ResellerDefaultBundles = "ResellerDefaultBundles",
     Retrospectives = "Retrospectives",
     ReturnOrders = "ReturnOrders",
     RewardLogs = "RewardLogs",

package/data/modelNames.js

@@ -416,6 +416,10 @@ var aMN;
     aMN["MarketBudgetsByIndustries"] = "MarketBudgetsByIndustries";
     aMN["IndustryKPIs"] = "IndustryKPIs";
     aMN["MarketResearches"] = "MarketResearches";
+    aMN["MarketplaceApps"] = "MarketplaceApps";
+    aMN["MarketplaceBundles"] = "MarketplaceBundles";
+    aMN["MarketplaceInstallations"] = "MarketplaceInstallations";
+    aMN["MarketplaceReviews"] = "MarketplaceReviews";
     aMN["Markets"] = "Markets";
     aMN["MaterialCommissionings"] = "MaterialCommissionings";
     aMN["MeetingLocations"] = "MeetingLocations";
@@ -535,6 +539,7 @@ var aMN;
     aMN["Repositories"] = "Repositories";
     aMN["Requirements"] = "Requirements";
     aMN["ResearchBudgets"] = "ResearchBudgets";
+    aMN["ResellerDefaultBundles"] = "ResellerDefaultBundles";
     aMN["Retrospectives"] = "Retrospectives";
     aMN["ReturnOrders"] = "ReturnOrders";
     aMN["RewardLogs"] = "RewardLogs";

package/data/modelsAndRights.js

@@ -7933,6 +7933,136 @@ const modelsAndRights = [
         updateBy: "_id",
         availableInSDK: false,
     },
+    // ─── Marketplace (Phase 1 Foundation — 25. April 2026) ─────────────
+    // Five entities model the cross-customer app-distribution mechanism:
+    //   MarketplaceApps         — public listing entity (publisher-owned)
+    //   MarketplaceBundles      — versioned content bundle attached to an app
+    //   MarketplaceInstallations — 1:1 customer ↔ app install record
+    //   MarketplaceReviews      — customer-submitted 1-5 star reviews
+    //   ResellerDefaultBundles  — reseller's auto-install bundles for new customers
+    //
+    // All five belong to the "marketplace" module. Actions beyond CRUD are
+    // declared below; the marketplace-api service (Phase 2) hosts them at
+    // POST /{entity}/:id/actions/{action}. See marketplace-mvm-plan.md.
+    {
+        plural: "MarketplaceApps",
+        singular: "MarketplaceApp",
+        module: "marketplace",
+        right: "marketplace.apps",
+        readOnly: false,
+        importable: false,
+        allowDuplicate: false,
+        updateBy: "_id",
+        availableInSDK: true,
+        sdkOperations: ["find", "findOne", "insert", "update", "aggregate", "count"],
+        piiLevel: "low",
+        searchable: true,
+        searchableFields: ["name", "slug", "description", "category", "industry", "tags"],
+        actions: [
+            { title: "PUBLISH", action: "publish", availability: "single", method: "POST", icon: "publish" },
+            { title: "ARCHIVE", action: "archive", availability: "single", method: "POST", icon: "archive" },
+            { title: "REVIEW_APPROVE", action: "review-approve", availability: "single", method: "POST", icon: "check_circle" },
+            { title: "REVIEW_REJECT", action: "review-reject", availability: "single", method: "POST", icon: "block", dangerous: true },
+            { title: "INSTALL", action: "install", availability: "single", method: "POST", icon: "download" },
+        ],
+        entityActions: [
+            { name: "publish", verb: "POST", emits: "published", icon: "publish", labelKey: "marketplace.apps.actions.publish" },
+            { name: "archive", verb: "POST", emits: "archived", icon: "archive", labelKey: "marketplace.apps.actions.archive" },
+            { name: "review-approve", verb: "POST", emits: "approved", icon: "check_circle", labelKey: "marketplace.apps.actions.review-approve" },
+            { name: "review-reject", verb: "POST", emits: "rejected", icon: "block", dangerous: true, labelKey: "marketplace.apps.actions.review-reject" },
+            { name: "install", verb: "POST", emits: "installed", icon: "download", labelKey: "marketplace.apps.actions.install" },
+        ],
+    },
+    {
+        plural: "MarketplaceBundles",
+        singular: "MarketplaceBundle",
+        module: "marketplace",
+        right: "marketplace.bundles",
+        readOnly: false,
+        importable: false,
+        allowDuplicate: false,
+        updateBy: "_id",
+        availableInSDK: true,
+        sdkOperations: ["find", "findOne", "insert", "update", "aggregate", "count"],
+        piiLevel: "low",
+        searchable: true,
+        searchableFields: ["version", "bundleType", "changelog"],
+        actions: [
+            { title: "PUBLISH", action: "publish", availability: "single", method: "POST", icon: "publish" },
+            { title: "FORK", action: "fork", availability: "single", method: "POST", icon: "fork_right" },
+            { title: "FROM_PUBLISHER", action: "from-publisher", availability: "single", method: "POST", icon: "cloud_download" },
+        ],
+        entityActions: [
+            { name: "publish", verb: "POST", emits: "published", icon: "publish", labelKey: "marketplace.bundles.actions.publish" },
+            { name: "fork", verb: "POST", emits: "forked", icon: "fork_right", labelKey: "marketplace.bundles.actions.fork" },
+            { name: "from-publisher", verb: "POST", emits: "imported", icon: "cloud_download", labelKey: "marketplace.bundles.actions.from-publisher" },
+        ],
+    },
+    {
+        plural: "MarketplaceInstallations",
+        singular: "MarketplaceInstallation",
+        module: "marketplace",
+        right: "marketplace.installations",
+        readOnly: false,
+        importable: false,
+        allowDuplicate: false,
+        updateBy: "_id",
+        availableInSDK: true,
+        sdkOperations: ["find", "findOne", "aggregate", "count"],
+        piiLevel: "low",
+        searchable: true,
+        searchableFields: ["status", "bundleVersion"],
+        actions: [
+            { title: "INSTALL", action: "install", availability: "single", method: "POST", icon: "download" },
+            { title: "UNINSTALL", action: "uninstall", availability: "single", method: "POST", icon: "delete_sweep", dangerous: true },
+            { title: "PAUSE", action: "pause", availability: "single", method: "POST", icon: "pause_circle" },
+            { title: "RESUME", action: "resume", availability: "single", method: "POST", icon: "play_circle" },
+            { title: "UPDATE", action: "update", availability: "single", method: "POST", icon: "system_update_alt" },
+        ],
+        entityActions: [
+            { name: "install", verb: "POST", emits: "installed", icon: "download", labelKey: "marketplace.installations.actions.install" },
+            { name: "uninstall", verb: "POST", emits: "uninstalled", icon: "delete_sweep", dangerous: true, labelKey: "marketplace.installations.actions.uninstall" },
+            { name: "pause", verb: "POST", emits: "paused", icon: "pause_circle", labelKey: "marketplace.installations.actions.pause" },
+            { name: "resume", verb: "POST", emits: "resumed", icon: "play_circle", labelKey: "marketplace.installations.actions.resume" },
+            { name: "update", verb: "POST", emits: "updated", icon: "system_update_alt", labelKey: "marketplace.installations.actions.update" },
+        ],
+    },
+    {
+        plural: "MarketplaceReviews",
+        singular: "MarketplaceReview",
+        module: "marketplace",
+        right: "marketplace.reviews",
+        readOnly: false,
+        importable: false,
+        allowDuplicate: false,
+        updateBy: "_id",
+        availableInSDK: true,
+        sdkOperations: ["find", "findOne", "insert", "update", "aggregate", "count"],
+        piiLevel: "low",
+        searchable: true,
+        searchableFields: ["comment", "publisherReply"],
+        actions: [
+            { title: "PUBLISHER_REPLY", action: "publisher-reply", availability: "single", method: "POST", icon: "reply" },
+        ],
+        entityActions: [
+            { name: "publisher-reply", verb: "POST", emits: "replied", icon: "reply", labelKey: "marketplace.reviews.actions.publisher-reply" },
+        ],
+    },
+    {
+        plural: "ResellerDefaultBundles",
+        singular: "ResellerDefaultBundle",
+        module: "marketplace",
+        right: "marketplace.resellerdefaultbundles",
+        readOnly: false,
+        importable: false,
+        allowDuplicate: false,
+        updateBy: "_id",
+        availableInSDK: true,
+        sdkOperations: ["find", "findOne", "insert", "update", "aggregate", "count"],
+        piiLevel: "low",
+        searchable: true,
+        searchableFields: ["notes"],
+    },
     // ─── Desktop Client module — states + rights per view ──────────────
     // desktopclient is a module in its own right (module: "desktopclient").
     // Each nav entry in the desktop client IS a state — registered via

package/interfaces/IAssignment.d.ts

@@ -1,6 +1,8 @@
 import { IDefaultFields } from "./IDefaultFields";
 import { ITax } from "./ITax";
 import { IFreeFields } from "./IFreeFields";
+import { IaYOUneContract } from "./IaYOUneContract";
+import { IShare } from "./IShare";
 interface MachineUtilization {
     machine: ObjectId;
     name?: string;
@@ -44,8 +46,8 @@ export interface IAssignment extends IDefaultFields, IFreeFields {
     internalDeclined?: boolean;
     internalDeclinedReason?: string;
     ayouneApproval?: string;
-    ayouneContract: any;
-    shares: any[];
+    ayouneContract?: IaYOUneContract;
+    shares?: IShare[];
     editors?: ObjectId[];
     team?: ObjectId[];
     agent?: string;

package/interfaces/IMarketplaceApp.d.ts

@@ -0,0 +1,46 @@
+import { IDefaultFields } from "./IDefaultFields";
+export type MarketplaceAppPublisher = "tolinax" | "reseller" | "customer";
+export type MarketplaceAppStatus = "draft" | "review" | "published" | "archived" | "rejected";
+export type MarketplaceAppSubscriptionInterval = "month" | "year" | null;
+/**
+ * Public listing entity for the aYOUne Marketplace. An `IMarketplaceApp`
+ * is the publisher-facing product record; its content (templates, products,
+ * automations, ...) is attached via one or more `IMarketplaceBundle`s.
+ *
+ * Ownership is multi-tenant: `_customerID` is always the publisher customer.
+ * Tolinax-published apps use the tolinax customer as `_customerID` and
+ * `publisher: "tolinax"`. Resellers publish apps scoped to their own
+ * customer record with `publisher: "reseller"`. Customers can publish
+ * their own private apps for re-use within related customers.
+ */
+export interface IMarketplaceApp extends IDefaultFields {
+    /** Owner / publisher customer (required, multi-tenant scoping field) */
+    _customerID: ObjectId;
+    /** The user within the publisher customer that pushed Publish */
+    _publisherUserID?: ObjectId;
+    publisher: MarketplaceAppPublisher;
+    name: string;
+    /** URL-safe slug, unique per `_customerID` via compound index */
+    slug: string;
+    description?: string;
+    /** e.g. "vertical", "integration", "addon" */
+    category?: string;
+    /** Optional industry tag for discovery (e.g. "dental", "construction") */
+    industry?: string;
+    tags?: string[];
+    /** URLs (uploaded via media-api) */
+    screenshots?: string[];
+    iconUrl?: string;
+    /** 0 = free. In EUR cents to avoid floating-point drift. */
+    price?: number;
+    subscriptionInterval?: MarketplaceAppSubscriptionInterval;
+    /** Basis points for publisher share. Default 7000 (= 70%). */
+    revenueShareBps?: number;
+    status: MarketplaceAppStatus;
+    publishedAt?: Date;
+    /** Human-readable reason shown to publisher when status === "rejected" */
+    rejectionReason?: string;
+    /** Tolinax-internal review metadata (hidden from reseller/customer UIs) */
+    reviewedBy?: ObjectId;
+    reviewedAt?: Date;
+}

package/interfaces/IMarketplaceApp.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/interfaces/IMarketplaceBundle.d.ts

@@ -0,0 +1,42 @@
+import { IDefaultFields } from "./IDefaultFields";
+export type MarketplaceBundleType = "vertical" | "addon" | "integration";
+export type MarketplaceBundleContentType = "mail" | "emailtemplate" | "product" | "wallboard" | "automationtemplate" | "automation";
+/**
+ * "clone" (default) = deep-copy the entity into the installer customer on
+ * install, after which the copy lives its own life.
+ *
+ * "reference" = the installer's customer references the publisher's entity
+ * directly (used for read-mostly catalog items and license-constrained
+ * integrations). Not all content types support referencing; the install
+ * action decides at runtime.
+ */
+export type MarketplaceBundleCopyStrategy = "clone" | "reference";
+export interface IMarketplaceBundleContent {
+    entityType: MarketplaceBundleContentType;
+    /** Points to the source entity in the publisher customer's DB */
+    _entityID: ObjectId;
+    /** Default: "clone" */
+    copyStrategy?: MarketplaceBundleCopyStrategy;
+    /** Optional human-readable label for the admin-v2 bundle editor */
+    label?: string;
+}
+/**
+ * A versioned bundle of content attached to a `IMarketplaceApp`. Installing
+ * an app means installing one bundle (the current `publishedAt`-latest one).
+ * New bundle versions for the same `_app` flip `updateAvailable=true` on
+ * existing installations.
+ */
+export interface IMarketplaceBundle extends IDefaultFields {
+    /** Publisher customer (same as the parent app's `_customerID`) */
+    _customerID: ObjectId;
+    /** -> IMarketplaceApp._id */
+    _app: ObjectId;
+    bundleType: MarketplaceBundleType;
+    /** Semver-ish, e.g. "1.0.0". Compared lexicographically for update detection. */
+    version: string;
+    contents: IMarketplaceBundleContent[];
+    /** Optional release notes shown on the install-update modal */
+    changelog?: string;
+    /** Bumped on every publish — drives "Update available" detection */
+    publishedAt?: Date;
+}

package/interfaces/IMarketplaceBundle.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/interfaces/IMarketplaceInstallation.d.ts

@@ -0,0 +1,46 @@
+import { IDefaultFields } from "./IDefaultFields";
+import { IaYOUneContract } from "./IaYOUneContract";
+export type MarketplaceInstallationStatus = "pending" | "active" | "paused" | "revoked";
+/**
+ * IDs of the copied entities in the installer customer, grouped by
+ * collection. Only populated for content entries with
+ * `copyStrategy: "clone"` — "reference"-strategy entries are resolved live
+ * against the publisher customer and do not appear here.
+ */
+export interface IMarketplaceInstallationCopiedIds {
+    mails?: ObjectId[];
+    emailtemplates?: ObjectId[];
+    products?: ObjectId[];
+    wallboards?: ObjectId[];
+    automations?: ObjectId[];
+    automationtemplates?: ObjectId[];
+}
+/**
+ * 1:1 installation record: one customer ↔ one app. Unique via
+ * `(_customerID, _app)` compound index. Tracks which bundle version is
+ * active, whether an update is available, and the Stripe subscription (for
+ * paid apps).
+ *
+ * The optional `ayouneContract` marker is reserved for an opt-in blockchain
+ * audit layer. It is written once on install and never read by current
+ * code — removing it later requires a migration, so it stays for now.
+ */
+export interface IMarketplaceInstallation extends IDefaultFields {
+    /** Installer (target) customer */
+    _customerID: ObjectId;
+    /** Source (reseller / Tolinax) customer — shortcut to the app's owner */
+    _publisherCustomerID: ObjectId;
+    _app: ObjectId;
+    _bundle: ObjectId;
+    /** Snapshot of `IMarketplaceBundle.version` at install time */
+    bundleVersion: string;
+    status: MarketplaceInstallationStatus;
+    installedAt?: Date;
+    copiedEntityIds: IMarketplaceInstallationCopiedIds;
+    /** Set to true when a newer bundle version is published for the same app */
+    updateAvailable?: boolean;
+    /** Set when the app has `price > 0` and a Stripe subscription backs it */
+    _stripeSubscriptionID?: string;
+    /** Dormant blockchain-audit marker — set on install, never read today */
+    ayouneContract?: IaYOUneContract;
+}

package/interfaces/IMarketplaceInstallation.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/interfaces/IMarketplaceReview.d.ts

@@ -0,0 +1,17 @@
+import { IDefaultFields } from "./IDefaultFields";
+/**
+ * Customer-submitted review for an installed `IMarketplaceApp`. The
+ * publisher can reply once per review via `PUT /marketplacereviews/:id`
+ * (only `publisherReply` + `publisherRepliedAt` writable from the
+ * publisher side).
+ */
+export interface IMarketplaceReview extends IDefaultFields {
+    /** Reviewer customer */
+    _customerID: ObjectId;
+    _app: ObjectId;
+    /** 1-5 integer */
+    rating: number;
+    comment?: string;
+    publisherReply?: string;
+    publisherRepliedAt?: Date;
+}

package/interfaces/IMarketplaceReview.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/interfaces/INotificationAction.d.ts

@@ -3,7 +3,7 @@
  * in the in-app notifications panel and (up to two primary actions) as native
  * Web-Push action buttons on supporting platforms.
  *
- * Four dispatch modes:
+ * Five dispatch modes:
  *   - `link`       — internal router navigation (`href` relative to the app)
  *   - `api`        — `fetch()` call to an absolute endpoint, optionally with
  *                    a confirm prompt; the service-worker can execute this
@@ -12,10 +12,21 @@
  *                    dialog in the PWA; the text is POSTed to `endpoint`.
  *   - `ai-copilot` — opens the Comm-Sidebar Copilot panel with
  *                    `copilotContext` pre-populated as the first user message.
+ *   - `sidebar`    — opens a specific Comm-Sidebar panel with an optional
+ *                    `itemId` / `threadId` / `messageId` target so the
+ *                    PWA scrolls/loads directly to the target item.
+ *                    Consumed by `SidebarDeeplinkService` in the
+ *                    `@tolinax/ayoune-comm-sidebar` library.
  */
-export type NotificationActionType = "link" | "api" | "reply" | "ai-copilot";
+export type NotificationActionType = "link" | "api" | "reply" | "ai-copilot" | "sidebar";
 /** Visual weight of the action button. */
 export type NotificationActionStyle = "primary" | "secondary" | "danger";
+/**
+ * Target panel for `type: "sidebar"` actions. Mirrors the `SidebarPanel`
+ * union in `@tolinax/ayoune-comm-sidebar` — duplicated here so the
+ * interfaces package stays free of Angular/runtime deps.
+ */
+export type NotificationSidebarPanel = "copilot" | "notifications" | "phone" | "video" | "chat" | "contacts" | "channels" | "support" | "inbox";
 export interface INotificationAction {
     /** Stable identifier per notification — used as the Web-Push `action` id. */
     id: string;
@@ -40,6 +51,21 @@ export interface INotificationAction {
      *  that are rendered against the notification's `data` context before
      *  being inserted into the input. */
     copilotContext?: string;
+    /** For `type: "sidebar"` — the target panel to open. */
+    panel?: NotificationSidebarPanel;
+    /** For `type: "sidebar"` — optional target item inside the panel
+     *  (notification id, ticket id, external-inbox conversation id, etc.). */
+    itemId?: string;
+    /** For `type: "sidebar"` with `panel: "chat"` or `panel: "channels"` —
+     *  the thread/channel id to load before scrolling. */
+    threadId?: string;
+    /** For `type: "sidebar"` with `panel: "chat"` or `panel: "channels"` —
+     *  optional message id to scroll into view after the thread loads. */
+    messageId?: string;
+    /** For `type: "sidebar"` with `panel: "phone"` — dialer sub-action
+     *  (`accept`, `reject`, `dial`). Auto-fires `CommBridgeService.voice.*`
+     *  on arrival when set. */
+    panelAction?: "accept" | "reject" | "dial" | "join";
     /** Should this action close/dismiss the notification after firing? */
     dismissOnComplete?: boolean;
 }

package/interfaces/IResellerDefaultBundle.d.ts

@@ -0,0 +1,17 @@
+import { IDefaultFields } from "./IDefaultFields";
+/**
+ * Reseller-scoped default-bundle configuration. Allows a reseller customer
+ * to pre-configure a set of bundles that are auto-installed whenever they
+ * onboard a new sub-customer. The `order` field controls install sequence
+ * when multiple defaults apply.
+ */
+export interface IResellerDefaultBundle extends IDefaultFields {
+    /** Reseller customer (owner of the default configuration) */
+    _customerID: ObjectId;
+    _bundle: ObjectId;
+    _app: ObjectId;
+    autoInstallOnCustomerCreate: boolean;
+    /** Lower = installed earlier */
+    order?: number;
+    notes?: string;
+}

package/interfaces/IResellerDefaultBundle.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/interfaces/index.d.ts

@@ -434,6 +434,10 @@ export * from "./IMarketBudget";
 export * from "./IMarketBudgetByIndustry";
 export * from "./IIndustryKPI";
 export * from "./IMarketResearch";
+export * from "./IMarketplaceApp";
+export * from "./IMarketplaceBundle";
+export * from "./IMarketplaceInstallation";
+export * from "./IMarketplaceReview";
 export * from "./IMaterial";
 export * from "./IMaterialCommissioning";
 export * from "./IMeeting";
@@ -565,6 +569,7 @@ export * from "./IRepository";
 export * from "./IRequirement";
 export * from "./IRequirementSchema";
 export * from "./IResearchBudget";
+export * from "./IResellerDefaultBundle";
 export * from "./IRetrospective";
 export * from "./IReturnOrder";
 export * from "./IRewardLog";

package/interfaces/index.js

@@ -450,6 +450,10 @@ __exportStar(require("./IMarketBudget"), exports);
 __exportStar(require("./IMarketBudgetByIndustry"), exports);
 __exportStar(require("./IIndustryKPI"), exports);
 __exportStar(require("./IMarketResearch"), exports);
+__exportStar(require("./IMarketplaceApp"), exports);
+__exportStar(require("./IMarketplaceBundle"), exports);
+__exportStar(require("./IMarketplaceInstallation"), exports);
+__exportStar(require("./IMarketplaceReview"), exports);
 __exportStar(require("./IMaterial"), exports);
 __exportStar(require("./IMaterialCommissioning"), exports);
 __exportStar(require("./IMeeting"), exports);
@@ -581,6 +585,7 @@ __exportStar(require("./IRepository"), exports);
 __exportStar(require("./IRequirement"), exports);
 __exportStar(require("./IRequirementSchema"), exports);
 __exportStar(require("./IResearchBudget"), exports);
+__exportStar(require("./IResellerDefaultBundle"), exports);
 __exportStar(require("./IRetrospective"), exports);
 __exportStar(require("./IReturnOrder"), exports);
 __exportStar(require("./IRewardLog"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tolinax/ayoune-interfaces",
-  "version": "2026.62.0",
+  "version": "2026.64.0",
   "description": "Houses TypeScript interfaces for aYOUne",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",