@tolinax/ayoune-interfaces 2026.43.0 → 2026.45.0

package/data/modelNames.d.ts

@@ -173,6 +173,7 @@ export declare enum aMN {
     ChatMessages = "ChatMessages",
     Chats = "Chats",
     ChatWidgets = "ChatWidgets",
+    ChangelogEntries = "ChangelogEntries",
     CheckLists = "CheckLists",
     CheckListTemplates = "CheckListTemplates",
     CheckResults = "CheckResults",
@@ -520,6 +521,7 @@ export declare enum aMN {
     RatingTemplates = "RatingTemplates",
     Recommendations = "Recommendations",
     RecommendationTemplates = "RecommendationTemplates",
+    Releases = "Releases",
     Reminders = "Reminders",
     References = "References",
     CustomerLogos = "CustomerLogos",

package/data/modelNames.js

@@ -177,6 +177,7 @@ var aMN;
     aMN["ChatMessages"] = "ChatMessages";
     aMN["Chats"] = "Chats";
     aMN["ChatWidgets"] = "ChatWidgets";
+    aMN["ChangelogEntries"] = "ChangelogEntries";
     aMN["CheckLists"] = "CheckLists";
     aMN["CheckListTemplates"] = "CheckListTemplates";
     aMN["CheckResults"] = "CheckResults";
@@ -524,6 +525,7 @@ var aMN;
     aMN["RatingTemplates"] = "RatingTemplates";
     aMN["Recommendations"] = "Recommendations";
     aMN["RecommendationTemplates"] = "RecommendationTemplates";
+    aMN["Releases"] = "Releases";
     aMN["Reminders"] = "Reminders";
     aMN["References"] = "References";
     aMN["CustomerLogos"] = "CustomerLogos";

package/data/modelsAndRights.js

@@ -2334,6 +2334,24 @@ const modelsAndRights = [
         updateBy: "_id",
         availableInSDK: false,
     },
+    {
+        plural: "ChangelogEntries",
+        singular: "ChangelogEntry",
+        module: "pm",
+        right: "pm.changelogentries",
+        readOnly: false,
+        importable: false,
+        allowDuplicate: false,
+        updateBy: "_id",
+        availableInSDK: false,
+        searchable: true,
+        searchableFields: ['title', 'body', 'scope'],
+        actions: [
+            { title: "PUBLISH", action: "publish", availability: "both", method: "POST", icon: "public" },
+            { title: "UNPUBLISH", action: "unpublish", availability: "single", method: "POST", icon: "visibility_off" },
+            { title: "TRANSLATE", action: "translate", availability: "single", method: "POST", icon: "translate" },
+        ],
+    },
     {
         plural: "Checks",
         singular: "Check",
@@ -3657,6 +3675,15 @@ const modelsAndRights = [
         allowDuplicate: false,
         updateBy: "_id",
         availableInSDK: false,
+        searchable: true,
+        searchableFields: ['subject', 'note'],
+        actions: [
+            { title: "PUBLISH", action: "publish", availability: "single", method: "POST", icon: "public" },
+            { title: "REJECT", action: "reject", availability: "single", method: "POST", icon: "block", dangerous: true },
+            { title: "MOVE_TO_LANE", action: "move", availability: "single", method: "POST", icon: "swap_horiz" },
+            { title: "REORDER_ROADMAP", action: "reorder", availability: "many", method: "POST", icon: "sort" },
+            { title: "CONVERT_TO_TASK", action: "convert", availability: "single", method: "POST", icon: "task_alt" },
+        ],
     },
     {
         plural: "FeedbackAnswers",
@@ -6098,6 +6125,27 @@ const modelsAndRights = [
         updateBy: "_id",
         availableInSDK: false,
     },
+    {
+        plural: "Releases",
+        singular: "Release",
+        module: "pm",
+        right: "pm.releases",
+        readOnly: false,
+        importable: false,
+        allowDuplicate: false,
+        updateBy: "_id",
+        availableInSDK: false,
+        searchable: true,
+        searchableFields: ['title', 'version', 'summary'],
+        actions: [
+            { title: "STAGE", action: "stage", availability: "single", method: "POST", icon: "preview" },
+            { title: "PUBLISH", action: "publish", availability: "single", method: "POST", icon: "public" },
+            { title: "UNPUBLISH", action: "unpublish", availability: "single", method: "POST", icon: "visibility_off" },
+            { title: "ARCHIVE", action: "archive", availability: "single", method: "POST", icon: "archive" },
+            { title: "ROLLUP", action: "rollup", availability: "single", method: "POST", icon: "merge_type" },
+            { title: "FROM_COMMITS", action: "from-commits", availability: "single", method: "POST", icon: "commit" },
+        ],
+    },
     {
         plural: "Reminders",
         singular: "Reminder",

package/interfaces/IChangelogEntry.d.ts

@@ -0,0 +1,46 @@
+import { IDefaultFields } from "./IDefaultFields";
+export type IChangelogEntryType = "feature" | "fix" | "breaking" | "security" | "perf" | "docs" | "chore";
+export interface IChangelogEntryTranslation {
+    title?: string;
+    body?: string;
+    /** ISO-2 locale code, e.g. "de", "en", "fr" */
+    locale: string;
+    /** Source: "manual" | "ai" — for UI badge */
+    source?: "manual" | "ai";
+    translatedAt?: Date;
+}
+export interface IChangelogEntry extends IDefaultFields {
+    _customerID: ObjectId;
+    _clientID?: ObjectId[];
+    _subID?: ObjectId[];
+    _project?: ObjectId;
+    _release?: ObjectId;
+    _task?: ObjectId;
+    _pipeline?: ObjectId;
+    type: IChangelogEntryType;
+    /** Conventional-commit scope (e.g. "pm", "shop") */
+    scope?: string;
+    /** Default-locale title (typically de or en) */
+    title: string;
+    /** Default-locale body, markdown allowed */
+    body?: string;
+    /** Default locale of title/body, e.g. "de" */
+    defaultLocale?: string;
+    /** Per-locale translations. Fallback-chain: requested → en → de → first available */
+    translations?: IChangelogEntryTranslation[];
+    /** Public/Moderation gating */
+    public?: boolean;
+    publishedAt?: Date;
+    /** Sort order within a Release */
+    order?: number;
+    /** Optional commit metadata copied from Task.commits[] */
+    commit?: {
+        hash?: string;
+        author?: string;
+        date?: Date;
+        repo?: string;
+        url?: string;
+    };
+    /** Optional deep-link back to PR/Ticket for public changelog */
+    sourceUrl?: string;
+}

package/interfaces/IChangelogEntry.js

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

package/interfaces/ICharge.d.ts

@@ -1,4 +1,15 @@
 import { IDefaultFields } from "./IDefaultFields";
+/**
+ * Direction of a charge entry.
+ *   - "inbound"  = customer → Tolinax  (metered usage, existing default)
+ *   - "outbound" = Tolinax → third-party provider (platform cost telemetry)
+ */
+export type ChargeDirection = "inbound" | "outbound";
+/**
+ * Known outbound providers. Kept as a string literal union rather than an
+ * enum so consumers can declare their own providers without a type release.
+ */
+export type ChargeProvider = "gcp" | "openai" | "anthropic" | "vertex" | "bitbucket" | "atlas" | "hetzner" | "cloudflare" | "npm" | string;
 export interface ICharge extends IDefaultFields {
     _customerID: ObjectId;
     _product?: ObjectId;
@@ -22,4 +33,23 @@ export interface ICharge extends IDefaultFields {
     dateTime?: Date;
     billable?: boolean;
     invoiced?: boolean;
+    /**
+     * Cost-telemetry extension (2026-04-20). All fields optional; existing
+     * inbound customer charges stay untouched. For outbound charges the
+     * `direction` field flips to "outbound" and `_customerID` is set to
+     * the TOLINAX_CUSTOMERID so multi-tenant indexes keep working without
+     * special-cases.
+     */
+    direction?: ChargeDirection;
+    provider?: ChargeProvider;
+    amountUSD?: number;
+    exchangeRate?: number;
+    /**
+     * When an outbound cost can be attributed to a specific customer (e.g.
+     * AI tokens consumed by a customer-scoped request), set this to that
+     * customer's _id. Leave undefined for platform-wide overhead.
+     */
+    attributedCustomerID?: ObjectId;
+    /** Provider-specific payload (gcp service code, openai model, etc.). */
+    meta?: any;
 }

package/interfaces/IFeatureRequest.d.ts

@@ -1,6 +1,8 @@
 import { IDefaultFields } from "./IDefaultFields";
 import { IVote } from "./IVote";
 import { IComment } from "./IComment";
+export type IFeatureRequestRoadmapLane = "now" | "next" | "later" | "shipped";
+export type IFeatureRequestModerationStatus = "submitted" | "accepted" | "rejected";
 export interface IFeatureRequest extends IDefaultFields {
     user?: ObjectId;
     username?: string;
@@ -15,4 +17,12 @@ export interface IFeatureRequest extends IDefaultFields {
     comments: IComment[];
     votes: IVote[];
     created?: Date;
+    /** Public moderation & roadmap fields (dogfooding, v2026.4x+) */
+    public?: boolean;
+    moderationStatus?: IFeatureRequestModerationStatus;
+    moderationReason?: string;
+    roadmapLane?: IFeatureRequestRoadmapLane;
+    roadmapOrder?: number;
+    /** Linked Task spawned via convertToTask action */
+    _task?: ObjectId;
 }

package/interfaces/IMilestone.d.ts

@@ -24,4 +24,6 @@ export interface IMilestone extends IDefaultFields {
     progress: number;
     unit: string;
     tasks: any[];
+    /** Optional Release this milestone rolls up into */
+    _release?: ObjectId;
 }

package/interfaces/INormalizedSerp.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Provider-agnostic normalized SERP representation.
+ *
+ * All Scraper-Provider-Adapter (Nimble, Oxy, Soax, ownInfra) müssen auf diesen
+ * Typ normalisieren. Downstream-Konsumenten (Storage, Ads-Upsert, Budget-Kalkulation)
+ * lesen gegen diesen Typ — NICHT gegen Provider-spezifische Feldnamen wie
+ * `.Ad` (Nimble) vs `.paid` (Oxy) vs `.description` vs `.desc`.
+ *
+ * Engine-agnostisch designt für spätere Erweiterung auf Bing, Google Maps,
+ * Google Shopping ohne Breaking Change. Phase 1 implementiert ausschließlich
+ * `engine: 'google.search'`.
+ */
+export type ScraperProviderName = 'nimble' | 'oxy' | 'soax' | 'ownInfra';
+export type SearchEngine = 'google.search' | 'google.maps' | 'google.shopping' | 'bing.search' | string;
+export interface INormalizedCost {
+    amount: number;
+    currency: 'USD' | 'EUR';
+    units?: number;
+    reference?: string;
+}
+export interface INormalizedSitelink {
+    title: string;
+    linkUrl: string;
+    description?: string;
+}
+export interface INormalizedAd {
+    position: number;
+    title: string;
+    description: string;
+    displayUrl: string;
+    linkUrl: string;
+    phone?: string;
+    sitelinks?: INormalizedSitelink[];
+    extensions?: Record<string, unknown>;
+}
+export interface INormalizedOrganic {
+    position: number;
+    title: string;
+    description: string;
+    linkUrl: string;
+    displayUrl?: string;
+    sitelinks?: INormalizedSitelink[];
+    rich?: Record<string, unknown>;
+}
+export interface INormalizedPla {
+    position: number;
+    title: string;
+    price?: string;
+    seller?: string;
+    linkUrl: string;
+    imageUrl?: string;
+}
+export interface INormalizedSerp {
+    provider: ScraperProviderName;
+    engine: SearchEngine;
+    requestedAt: Date;
+    respondedAt: Date;
+    cost?: INormalizedCost;
+    ads: INormalizedAd[];
+    organic: INormalizedOrganic[];
+    pla: INormalizedPla[];
+    knowledgeGraph?: Record<string, unknown>;
+    relatedQuestions?: Array<Record<string, unknown>>;
+    relatedSearches?: string[];
+    rawResponse: unknown;
+}

package/interfaces/INormalizedSerp.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * Provider-agnostic normalized SERP representation.
+ *
+ * All Scraper-Provider-Adapter (Nimble, Oxy, Soax, ownInfra) müssen auf diesen
+ * Typ normalisieren. Downstream-Konsumenten (Storage, Ads-Upsert, Budget-Kalkulation)
+ * lesen gegen diesen Typ — NICHT gegen Provider-spezifische Feldnamen wie
+ * `.Ad` (Nimble) vs `.paid` (Oxy) vs `.description` vs `.desc`.
+ *
+ * Engine-agnostisch designt für spätere Erweiterung auf Bing, Google Maps,
+ * Google Shopping ohne Breaking Change. Phase 1 implementiert ausschließlich
+ * `engine: 'google.search'`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/interfaces/IRelease.d.ts

@@ -0,0 +1,39 @@
+import { IDefaultFields } from "./IDefaultFields";
+import { IComment } from "./IComment";
+export type IReleaseStatus = "draft" | "staged" | "published" | "archived";
+export interface IReleasePackageVersion {
+    /** e.g. "@tolinax/ayoune-core" */
+    name: string;
+    /** e.g. "2026.31.1" */
+    version: string;
+    /** Optional git tag or commit hash for traceability */
+    ref?: string;
+}
+export interface IRelease extends IDefaultFields {
+    _customerID: ObjectId;
+    _clientID?: ObjectId[];
+    _subID?: ObjectId[];
+    _project?: ObjectId;
+    _milestone?: ObjectId;
+    /** Human-readable release identifier, e.g. "Platform 2026.17" */
+    title: string;
+    /** Meta-CalVer, e.g. "2026.17" or "2026.17.0" */
+    version: string;
+    /** Slug for URL routing, e.g. "platform-2026-17" */
+    slug?: string;
+    status: IReleaseStatus;
+    publishedAt?: Date;
+    stagedAt?: Date;
+    archivedAt?: Date;
+    /** Short summary shown in Release-Lists and RSS */
+    summary?: string;
+    /** Long-form notes (markdown) */
+    notes?: string;
+    /** Per-package CalVer for all Domain-Pakete in this meta-release */
+    domainPackageVersions?: IReleasePackageVersion[];
+    /** Flag: Release darf public auf consumer-app erscheinen */
+    public?: boolean;
+    /** Linked Pipelines that triggered this release (auto-populated when available) */
+    _pipelines?: ObjectId[];
+    comments?: IComment[];
+}

package/interfaces/IRelease.js

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

package/interfaces/ITask.d.ts

@@ -149,6 +149,8 @@ export interface ITask extends IDefaultFields {
     changelog?: any;
     releaseNote?: string;
     releaseNoteTitle?: string;
+    /** Optional Release this task rolls up into */
+    _release?: ObjectId;
     comments: IComment[];
     commits?: any[];
     watchers?: any[];

package/interfaces/IWebsite.d.ts

@@ -198,5 +198,7 @@ export interface IWebsite extends IDefaultFields {
         developerPortal?: boolean;
         /** Enable consumer portal (authenticated area: invoices, tickets, etc.) */
         consumerPortal?: boolean;
+        /** Enable public roadmap + feature requests + changelog pages (dogfooding) */
+        publicRoadmap?: boolean;
     };
 }

package/interfaces/index.d.ts

@@ -188,6 +188,7 @@ export * from "./ICheck";
 export * from "./ICheckList";
 export * from "./ICheckListTemplate";
 export * from "./ICheckResult";
+export * from "./IChangelogEntry";
 export * from "./IClick";
 export * from "./ICloudTag";
 export * from "./ICloudTagView";
@@ -459,6 +460,7 @@ export * from "./INewsletterLink";
 export * from "./INewsletterSnapshot";
 export * from "./INewsletterType";
 export * from "./INewsSource";
+export * from "./INormalizedSerp";
 export * from "./INotification";
 export * from "./INotificationPolicy";
 export * from "./INotificationPreference";
@@ -552,6 +554,7 @@ export * from "./IRatingTemplate";
 export * from "./IReaction";
 export * from "./IRecommendation";
 export * from "./IRecommendationTemplate";
+export * from "./IRelease";
 export * from "./IReminder";
 export * from "./IReplenishmentOrder";
 export * from "./IReport";

package/interfaces/index.js

@@ -204,6 +204,7 @@ __exportStar(require("./ICheck"), exports);
 __exportStar(require("./ICheckList"), exports);
 __exportStar(require("./ICheckListTemplate"), exports);
 __exportStar(require("./ICheckResult"), exports);
+__exportStar(require("./IChangelogEntry"), exports);
 __exportStar(require("./IClick"), exports);
 __exportStar(require("./ICloudTag"), exports);
 __exportStar(require("./ICloudTagView"), exports);
@@ -475,6 +476,7 @@ __exportStar(require("./INewsletterLink"), exports);
 __exportStar(require("./INewsletterSnapshot"), exports);
 __exportStar(require("./INewsletterType"), exports);
 __exportStar(require("./INewsSource"), exports);
+__exportStar(require("./INormalizedSerp"), exports);
 __exportStar(require("./INotification"), exports);
 __exportStar(require("./INotificationPolicy"), exports);
 __exportStar(require("./INotificationPreference"), exports);
@@ -568,6 +570,7 @@ __exportStar(require("./IRatingTemplate"), exports);
 __exportStar(require("./IReaction"), exports);
 __exportStar(require("./IRecommendation"), exports);
 __exportStar(require("./IRecommendationTemplate"), exports);
+__exportStar(require("./IRelease"), exports);
 __exportStar(require("./IReminder"), exports);
 __exportStar(require("./IReplenishmentOrder"), exports);
 __exportStar(require("./IReport"), exports);

package/package.json

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