@tolinax/ayoune-interfaces 2026.63.0 → 2026.65.0

package/data/modelNames.d.ts

@@ -384,6 +384,7 @@ export declare enum aMN {
     KPITemplates = "KPITemplates",
     Leads = "Leads",
     LinkPortalClicks = "LinkPortalClicks",
+    LinkPortals = "LinkPortals",
     LinkPortalViews = "LinkPortalViews",
     LoadingLists = "LoadingLists",
     Localizations = "Localizations",
@@ -412,6 +413,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 +536,7 @@ export declare enum aMN {
     Repositories = "Repositories",
     Requirements = "Requirements",
     ResearchBudgets = "ResearchBudgets",
+    ResellerDefaultBundles = "ResellerDefaultBundles",
     Retrospectives = "Retrospectives",
     ReturnOrders = "ReturnOrders",
     RewardLogs = "RewardLogs",

package/data/modelNames.js

@@ -388,6 +388,7 @@ var aMN;
     aMN["KPITemplates"] = "KPITemplates";
     aMN["Leads"] = "Leads";
     aMN["LinkPortalClicks"] = "LinkPortalClicks";
+    aMN["LinkPortals"] = "LinkPortals";
     aMN["LinkPortalViews"] = "LinkPortalViews";
     aMN["LoadingLists"] = "LoadingLists";
     aMN["Localizations"] = "Localizations";
@@ -416,6 +417,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 +540,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

@@ -4699,6 +4699,30 @@ const modelsAndRights = [
         updateBy: "_id",
         availableInSDK: false,
     },
+    {
+        plural: "LinkPortals",
+        singular: "LinkPortal",
+        module: "marketing",
+        right: "marketing.linkportals",
+        readOnly: false,
+        importable: false,
+        allowDuplicate: true,
+        updateBy: "_id",
+        availableInSDK: true,
+        sdkOperations: ["find", "findOne", "insert", "update"],
+        searchable: true,
+        searchableFields: ["slug", "title", "customDomain"],
+        labelKey: "marketing.linkportal.label",
+        labelPluralKey: "marketing.linkportals.label",
+        descriptionKey: "marketing.linkportals.description",
+        piiLevel: "none",
+        events: ["created", "updated", "deleted"],
+        entityActions: [
+            { name: "publish", verb: "POST", emits: "published", icon: "publish", labelKey: "marketing.linkportals.actions.publish" },
+            { name: "unpublish", verb: "POST", emits: "unpublished", icon: "unpublished", labelKey: "marketing.linkportals.actions.unpublish" },
+            { name: "duplicate", verb: "POST", emits: "duplicated", icon: "content_copy", labelKey: "marketing.linkportals.actions.duplicate" },
+        ],
+    },
     {
         plural: "LinkPortalViews",
         singular: "LinkPortalView",
@@ -7933,6 +7957,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/ILinkPortal.d.ts

@@ -0,0 +1,197 @@
+import { IDefaultFields } from "./IDefaultFields";
+/**
+ * Discriminator for polymorphic ILinkPortalBlock.data shape.
+ *
+ * Phase 1 (Migration-Compat) — Pflicht-Set, deckt das gesamte Legacy
+ * `Settings.linkPortal`-Universum (groups/links/persons/customArea/headers/social) ab.
+ * Phase 2 — Schema-Slots, Renderer kommt on-demand. Der link-portal-Service
+ * rendert Phase-2-Blöcke heute mit `mixin-unsupported` (silent-skip + Logger-Warn),
+ * damit ein eingestellter Block keinen Render-Crash auslöst.
+ */
+export type LinkPortalBlockType = "header" | "link" | "group" | "person" | "customHtml" | "vcard" | "qr" | "social" | "text" | "image" | "gallery" | "video" | "audio" | "pdf" | "map" | "faq" | "embed" | "newsletter" | "contactForm" | "booking" | "tipJar" | "product" | "countdown" | "divider" | "spacer";
+export interface ILinkPortalVisibility {
+    devices?: ("mobile" | "tablet" | "desktop")[];
+    geo?: {
+        include?: string[];
+        exclude?: string[];
+    };
+    schedule?: {
+        from?: Date;
+        to?: Date;
+    };
+    abTest?: {
+        variant: string;
+        weight: number;
+    };
+}
+export interface ILinkPortalGating {
+    type: "password" | "email" | "age" | "login" | "paywall";
+    config: Record<string, any>;
+}
+/**
+ * Polymorpher Page-Block. `type` ist der Discriminator, `data` die
+ * type-spezifische Payload (siehe LinkPortalBlockData* unten).
+ *
+ * `translations[lang]` shadowed Felder aus `data` für die jeweilige Sprache.
+ * Nicht übersetzte Felder fallen auf `data` zurück (Default-Locale-Pfad in
+ * `clients/link-portal/src/lib/i18nBlock.ts` → `pickLocalized`).
+ */
+export interface ILinkPortalBlock {
+    _id: ObjectId;
+    type: LinkPortalBlockType;
+    position: number;
+    visibility?: ILinkPortalVisibility;
+    gating?: ILinkPortalGating;
+    data: Record<string, any>;
+    translations?: {
+        [lang: string]: {
+            [field: string]: any;
+        };
+    };
+    metadata?: {
+        og?: {
+            title?: string;
+            description?: string;
+            image?: string;
+        };
+    };
+    isDraft?: boolean;
+}
+export interface LinkPortalBlockDataHeader {
+    title: string;
+    description?: string;
+}
+export interface LinkPortalBlockDataLink {
+    title: string;
+    tagLine?: string;
+    icon?: string;
+    link: string;
+    adult?: boolean;
+}
+export interface LinkPortalBlockDataGroup {
+    headerText?: string;
+    description?: string;
+    /** Children werden im selben Block-Array über `parentId` referenziert
+     *  (flach für DB-Indizierbarkeit). Falls echtes Nesting gewünscht wird,
+     *  kann der Adapter es in `children: ILinkPortalBlock[]` materialisieren. */
+    childIds?: ObjectId[];
+}
+export interface LinkPortalBlockDataPerson {
+    personRef: ObjectId;
+    description?: string;
+    tagLine?: string;
+    role?: string;
+}
+export interface LinkPortalBlockDataCustomHtml {
+    title?: string;
+    content: string;
+}
+export interface LinkPortalBlockDataVcard {
+    headerText?: string;
+}
+export interface LinkPortalBlockDataQr {
+    headerText?: string;
+    target?: string;
+}
+export interface LinkPortalBlockDataSocial {
+    headerText?: string;
+    links: {
+        provider: string;
+        url: string;
+    }[];
+}
+export interface ILinkPortalTheme {
+    backgroundMode: "gradient" | "image" | "video" | "solid";
+    color1: string;
+    color2: string;
+    fontColor: string;
+    backgroundImage?: string;
+    backgroundVideo?: string;
+    buttonColor1: string;
+    buttonColor2: string;
+    buttonFontColor: string;
+    buttonStyle?: "fill" | "outline" | "soft" | "gradient" | "glass";
+    buttonRadius?: number;
+    avatarShape?: "circle" | "square" | "rounded";
+    fontFamily?: string;
+    /** Premium-Slot. Wird nur bei publizierten Portals mit erlaubtem Right gerendert. */
+    customCss?: string;
+}
+export interface ILinkPortalBranding {
+    logo?: string;
+    logoLight?: string;
+    favicon?: string;
+    showLogo?: boolean;
+    showClaim?: boolean;
+    /** Sprach-Map: { de: '…', en: '…' } */
+    claimText?: {
+        [lang: string]: string;
+    };
+}
+export interface ILinkPortalMetadata {
+    /** Pro-Sprache OG-Tags. Fallback: `defaultLanguage`. */
+    og?: {
+        [lang: string]: {
+            title?: string;
+            description?: string;
+            image?: string;
+        };
+    };
+    schemaOrg?: Record<string, any>;
+    sitemap?: {
+        include: boolean;
+        priority?: number;
+    };
+}
+export interface ILinkPortalAnalyticsPixel {
+    provider: "meta" | "tiktok" | "ga4" | "google-ads" | "pinterest" | "snap";
+    id: string;
+}
+export interface ILinkPortalAnalyticsWebhook {
+    event: "view" | "click" | "gate-pass";
+    url: string;
+}
+export interface ILinkPortalAnalytics {
+    pixels?: ILinkPortalAnalyticsPixel[];
+    utmInherit?: boolean;
+    webhooks?: ILinkPortalAnalyticsWebhook[];
+}
+/**
+ * Optionale Migrations-Audit-Spur. Wird vom Renderer ignoriert, dient
+ * Stichproben + Hard-Remove-Phase G als verifizierbare Quelle.
+ */
+export interface ILinkPortalLegacyTrace {
+    sourceSettingsId?: ObjectId;
+    migratedAt?: Date;
+    /** Verbatim Backup des originalen Settings.linkPortal-Sub-Docs. NIE löschen vor Phase G. */
+    raw?: Record<string, any>;
+}
+export interface ILinkPortal extends IDefaultFields {
+    _customerID: ObjectId;
+    _clientID?: ObjectId[];
+    _subID?: ObjectId[];
+    /** Globally unique Identifier (URL-Segment unter link.sb/<slug>/...). */
+    slug: string;
+    /** Optionaler Custom-Domain (FQDN). Unique sparse. */
+    customDomain?: string;
+    /** Interner Anzeigename in der Admin-Liste (nicht öffentlich gerendert). */
+    title: string;
+    /** Beschreibung (intern). */
+    description?: string;
+    status: "draft" | "published" | "scheduled";
+    publishAt?: Date;
+    unpublishAt?: Date;
+    /** ISO 639-1 (z.B. "de"). Fallback für Block-Translations. */
+    defaultLanguage: string;
+    /** Liste aller in diesem Portal aktivierten Sprachen. */
+    supportedLanguages: string[];
+    theme: ILinkPortalTheme;
+    branding: ILinkPortalBranding;
+    metadata: ILinkPortalMetadata;
+    analytics: ILinkPortalAnalytics;
+    /** Optionales Page-Level-Gate (vor jedem Block). */
+    pageGating?: ILinkPortalGating;
+    /** Polymorpher Block-Stream. Reihenfolge ergibt sich aus block.position. */
+    blocks: ILinkPortalBlock[];
+    legacy?: ILinkPortalLegacyTrace;
+}

package/interfaces/ILinkPortal.js

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

package/interfaces/ILinkPortalClick.d.ts

@@ -8,4 +8,10 @@ export interface ILinkPortalClick extends IaYOUneTrackingParams, IGeoIPLocationT
     _subID?: ObjectId[];
     _linkID?: ObjectId;
     channel?: string;
+    /** Reference to the LinkPortal entity (chapter 1.72). Sparse — pre-migration clicks lack this. */
+    _linkPortalID?: ObjectId;
+    /** Reference to the specific block clicked (chapter 1.72). Replaces legacy `_linkID`. */
+    _blockID?: ObjectId;
+    /** Resolved render-language at click time (ISO 639-1). Sparse — pre-i18n clicks lack this. */
+    lang?: string;
 }

package/interfaces/ILinkPortalView.d.ts

@@ -7,4 +7,8 @@ export interface ILinkPortalView extends IaYOUneTrackingParams, IGeoIPLocationTr
     _clientID: ObjectId[];
     _subID: ObjectId[];
     channel: string;
+    /** Reference to the LinkPortal entity (chapter 1.72). Sparse — pre-migration views lack this. */
+    _linkPortalID?: ObjectId;
+    /** Resolved render-language for the visit (ISO 639-1). Sparse — pre-i18n views lack this. */
+    lang?: 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/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/ISetting.d.ts

@@ -1005,7 +1005,18 @@ interface ISupportPortal {
     roadMapProjects: ObjectId[];
     seo: SEOAttributes;
 }
-interface ILinkPortal {
+/**
+ * @deprecated Use the standalone `LinkPortals` collection (see `ILinkPortal`).
+ *
+ * Lives only as `ISetting.linkPortal` for the dual-read window described in
+ * `docs/migration/concept/migration-concept.md` chapter 1.72. The link-portal
+ * service auto-migrates customers reading this sub-doc into a fresh
+ * `LinkPortals` document on first request, then continues to serve from the
+ * new collection. Hard-removal happens in Phase G after a 30+ day cool-down.
+ *
+ * Renamed from `ILinkPortal` to free that name for the new entity interface.
+ */
+interface ILinkPortalLegacy {
     title: string;
     description: string;
     style: LinkPortalStyle;
@@ -1065,7 +1076,8 @@ export interface ISetting extends IDefaultFields {
     products: ProductsSettings;
     slides: SlidesSettings;
     customerportal: ISettingCustomerPortal;
-    linkPortal: ILinkPortal;
+    /** @deprecated Migrated to standalone `LinkPortals` collection in chapter 1.72. */
+    linkPortal: ILinkPortalLegacy;
     supportPortal: ISupportPortal;
     warehouse?: IWarehouseSettings;
     [x: string]: any;

package/interfaces/index.d.ts

@@ -404,6 +404,7 @@ export * from "./IKPINewsletterType";
 export * from "./IKPITemplate";
 export * from "./ILabel";
 export * from "./ILead";
+export * from "./ILinkPortal";
 export * from "./ILinkPortalClick";
 export * from "./ILinkPortalView";
 export * from "./ILoadingList";
@@ -434,6 +435,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 +570,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

@@ -420,6 +420,7 @@ __exportStar(require("./IKPINewsletterType"), exports);
 __exportStar(require("./IKPITemplate"), exports);
 __exportStar(require("./ILabel"), exports);
 __exportStar(require("./ILead"), exports);
+__exportStar(require("./ILinkPortal"), exports);
 __exportStar(require("./ILinkPortalClick"), exports);
 __exportStar(require("./ILinkPortalView"), exports);
 __exportStar(require("./ILoadingList"), exports);
@@ -450,6 +451,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 +586,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.63.0",
+  "version": "2026.65.0",
   "description": "Houses TypeScript interfaces for aYOUne",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",