@lilaquadrat/interfaces 1.48.0 → 1.50.1

package/CHANGELOG.md

@@ -2,6 +2,27 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [1.50.1](https://github.com/lilaquadrat/interfaces/compare/v1.50.0...v1.50.1) (2026-09-25)
+
+
+### Bug Fixes
+
+* **SupportAvailability:** added missing file ([4e5864e](https://github.com/lilaquadrat/interfaces/commit/4e5864ee38e0312a834a7d48cbae18af56670f35))
+
+## [1.50.0](https://github.com/lilaquadrat/interfaces/compare/v1.49.0...v1.50.0) (2026-09-25)
+
+
+### Features
+
+* **conversations:** added supportAvailability ([340f1e3](https://github.com/lilaquadrat/interfaces/commit/340f1e3e0b6fbc9f3526845a8492e86fef103ce1))
+
+## [1.49.0](https://github.com/lilaquadrat/interfaces/compare/v1.48.0...v1.49.0) (2026-09-14)
+
+
+### Features
+
+* **chat:** add conversation message and attachment contracts ([3554030](https://github.com/lilaquadrat/interfaces/commit/35540305e7c99a654af23d0147ce2096e81c0a0d))
+
 ## [1.48.0](https://github.com/lilaquadrat/interfaces/compare/v1.47.0...v1.48.0) (2026-08-28)
 
 

package/lib/cjs/Category.d.ts

@@ -0,0 +1,8 @@
+import { AccessRule } from "./AccessRule";
+export interface Category {
+    company: string;
+    project: string;
+    key: string;
+    label: string;
+    read: AccessRule[];
+}

package/lib/cjs/ChatMessage.d.ts

@@ -0,0 +1,11 @@
+import { ObjectIdString } from './ObjectIdString';
+import { ChatMessageAttachment } from './ChatMessageAttachment';
+import { ChatMessageMetadata } from './ChatMessageMetadata';
+export interface ChatMessage {
+    type: 'message:add';
+    conversation: ObjectIdString;
+    message: string;
+    clientMessageId?: string;
+    metadata?: ChatMessageMetadata;
+    attachments?: ChatMessageAttachment[];
+}

package/lib/cjs/ChatMessageAttachment.d.ts

@@ -0,0 +1,5 @@
+import { ObjectIdString } from './ObjectIdString';
+export interface ChatMessageAttachment {
+    uploadId: ObjectIdString;
+    name: string;
+}

package/lib/cjs/ChatMessageMetadata.d.ts

@@ -0,0 +1,4 @@
+import { ChatSupportContext } from './ChatSupportContext';
+export interface ChatMessageMetadata {
+    supportContext?: ChatSupportContext;
+}

package/lib/cjs/ChatSupportContext.d.ts

@@ -0,0 +1,27 @@
+export interface ChatSupportContext {
+    company?: string;
+    project?: string;
+    url?: string;
+    pageTitle?: string;
+    appVersion?: string;
+    browser?: {
+        name?: string;
+        version?: string;
+    };
+    os?: {
+        name?: string;
+        version?: string;
+    };
+    screen?: {
+        width?: number;
+        height?: number;
+        pixelRatio?: number;
+    };
+    viewport?: {
+        width?: number;
+        height?: number;
+    };
+    locale?: string;
+    timezone?: string;
+    userAgent?: string;
+}

package/lib/cjs/Content.d.ts

@@ -1,3 +1,4 @@
+import { ObjectId } from "mongodb";
 import { ChildData } from "./ChildData";
 import { CompatibleModule } from "./CompatibleModule";
 import { GenericData } from "./GenericData";
@@ -8,6 +9,7 @@ export interface Content {
     project: string;
     modules: CompatibleModule[];
     tags?: string[];
+    categories?: ObjectId[];
     /**
      * a description of the content which will be used as context for AI text generation
      */

package/lib/cjs/Conversation.d.ts

@@ -1,5 +1,6 @@
 import { ObjectId } from 'mongodb';
 import type { ConversationSla } from './ConversationSla';
+import type { SupportAvailability } from './SupportAvailability';
 export type SupportStatus = 'awaiting_agent' | 'awaiting_customer' | 'resolved';
 export interface Conversation {
     _id?: ObjectId;
@@ -18,5 +19,11 @@ export interface Conversation {
     supportStatusVersion?: number;
     /** Current support SLA projection, joined at read time rather than stored on the conversation. */
     sla?: ConversationSla | null;
+    /**
+     * Customer-facing support-hours summary (derived from the Sla config + server time), attached
+     * at read time for support conversations. Absent for non-support conversations and when no
+     * Sla configuration exists. Never carries the raw Sla fields.
+     */
+    supportAvailability?: SupportAvailability | null;
     new?: boolean;
 }

package/lib/cjs/License.d.ts

@@ -0,0 +1,17 @@
+export interface License {
+    id: string;
+    name: string;
+    description?: string;
+    monthlyCost: number;
+    oneTimeCost?: number;
+    minimumContractMonths: number;
+    cancellationPeriodDays: number;
+    includesSupport: boolean;
+    supportSla?: string;
+    active: boolean;
+    autoExtend: boolean;
+    /** app ids that are included in this license */
+    includedApps: string[];
+    /** per-app usage limits, e.g. { editor: { pages: 10 }, media: { storageMb: 500 } } */
+    limits?: Record<string, Record<string, number>>;
+}

package/lib/cjs/Storage.d.ts

@@ -1,7 +1,7 @@
 import { ObjectId } from "mongodb";
 import { MediaMetadata } from "./MediaMetadata";
 export interface Storage {
-    company: string;
+    company?: string;
     project?: string;
     /**
      * this document can be bound to a specific customer
@@ -11,6 +11,7 @@ export interface Storage {
      * this document can be bound to a specific list and customer
      */
     list?: ObjectId;
+    conversation?: ObjectId;
     filename: string;
     prefix?: string;
     path?: string;

package/lib/cjs/SupportAvailability.d.ts

@@ -0,0 +1,13 @@
+import type { SupportDay } from './SupportDay';
+/**
+ * Customer-facing support-hours schedule.
+ *
+ * Only the derived schedule is exposed (`supportDays`, `timeZone`, `responseTimeHours`), never the
+ * raw Sla config. Whether support is open right now is derived by the client from the schedule
+ * and its own clock.
+ */
+export interface SupportAvailability {
+    responseTimeHours: number;
+    timeZone: string;
+    supportDays: SupportDay[];
+}

package/lib/cjs/Upload.d.ts

@@ -8,6 +8,7 @@ export interface Upload {
     project?: string;
     customer?: ObjectIdString | ObjectId;
     list?: ObjectIdString | ObjectId;
+    conversation?: ObjectIdString | ObjectId;
     user?: string;
     app: string;
     assetId?: string;

package/lib/cjs/index.d.ts

@@ -24,11 +24,16 @@ export * from './CallResponse';
 export * from './CallToActionModule';
 export * from './Cart';
 export * from './CartItem';
+export * from './Category';
 export * from './CategoryStructure';
 export * from './CategoryStructureWithRequired';
 export * from './Certificate';
 export * from './CertificateAction';
 export * from './CertificateActionResult';
+export * from './ChatMessage';
+export * from './ChatMessageAttachment';
+export * from './ChatMessageMetadata';
+export * from './ChatSupportContext';
 export * from './ChildData';
 export * from './Command';
 export * from './CommandNginx';
@@ -121,6 +126,7 @@ export * from './InvoiceReferences';
 export * from './InvoiceTaxBreakdown';
 export * from './InvoiceTotals';
 export * from './InvoiceWithXml';
+export * from './License';
 export * from './LimiterBreach';
 export * from './LimiterPluginOptions';
 export * from './LimiterTier';
@@ -221,6 +227,7 @@ export * from './Stored';
 export * from './StoryModule';
 export * from './Structure';
 export * from './StudioIframeMessage';
+export * from './SupportAvailability';
 export * from './SupportDay';
 export * from './SystemDomain';
 export * from './TextModule';

package/lib/esm/Category.d.ts

@@ -0,0 +1,8 @@
+import { AccessRule } from "./AccessRule";
+export interface Category {
+    company: string;
+    project: string;
+    key: string;
+    label: string;
+    read: AccessRule[];
+}

package/lib/esm/Category.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Category.js.map

package/lib/esm/Category.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Category.js","sourceRoot":"","sources":["../../src/Category.ts"],"names":[],"mappings":""}

package/lib/esm/ChatMessage.d.ts

@@ -0,0 +1,11 @@
+import { ObjectIdString } from './ObjectIdString';
+import { ChatMessageAttachment } from './ChatMessageAttachment';
+import { ChatMessageMetadata } from './ChatMessageMetadata';
+export interface ChatMessage {
+    type: 'message:add';
+    conversation: ObjectIdString;
+    message: string;
+    clientMessageId?: string;
+    metadata?: ChatMessageMetadata;
+    attachments?: ChatMessageAttachment[];
+}

package/lib/esm/ChatMessage.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ChatMessage.js.map

package/lib/esm/ChatMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatMessage.js","sourceRoot":"","sources":["../../src/ChatMessage.ts"],"names":[],"mappings":""}

package/lib/esm/ChatMessageAttachment.d.ts

@@ -0,0 +1,5 @@
+import { ObjectIdString } from './ObjectIdString';
+export interface ChatMessageAttachment {
+    uploadId: ObjectIdString;
+    name: string;
+}

package/lib/esm/ChatMessageAttachment.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ChatMessageAttachment.js.map

package/lib/esm/ChatMessageAttachment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatMessageAttachment.js","sourceRoot":"","sources":["../../src/ChatMessageAttachment.ts"],"names":[],"mappings":""}

package/lib/esm/ChatMessageMetadata.d.ts

@@ -0,0 +1,4 @@
+import { ChatSupportContext } from './ChatSupportContext';
+export interface ChatMessageMetadata {
+    supportContext?: ChatSupportContext;
+}

package/lib/esm/ChatMessageMetadata.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ChatMessageMetadata.js.map

package/lib/esm/ChatMessageMetadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatMessageMetadata.js","sourceRoot":"","sources":["../../src/ChatMessageMetadata.ts"],"names":[],"mappings":""}

package/lib/esm/ChatSupportContext.d.ts

@@ -0,0 +1,27 @@
+export interface ChatSupportContext {
+    company?: string;
+    project?: string;
+    url?: string;
+    pageTitle?: string;
+    appVersion?: string;
+    browser?: {
+        name?: string;
+        version?: string;
+    };
+    os?: {
+        name?: string;
+        version?: string;
+    };
+    screen?: {
+        width?: number;
+        height?: number;
+        pixelRatio?: number;
+    };
+    viewport?: {
+        width?: number;
+        height?: number;
+    };
+    locale?: string;
+    timezone?: string;
+    userAgent?: string;
+}

package/lib/esm/ChatSupportContext.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ChatSupportContext.js.map

package/lib/esm/ChatSupportContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatSupportContext.js","sourceRoot":"","sources":["../../src/ChatSupportContext.ts"],"names":[],"mappings":""}

package/lib/esm/Content.d.ts

@@ -1,3 +1,4 @@
+import { ObjectId } from "mongodb";
 import { ChildData } from "./ChildData";
 import { CompatibleModule } from "./CompatibleModule";
 import { GenericData } from "./GenericData";
@@ -8,6 +9,7 @@ export interface Content {
     project: string;
     modules: CompatibleModule[];
     tags?: string[];
+    categories?: ObjectId[];
     /**
      * a description of the content which will be used as context for AI text generation
      */

package/lib/esm/Conversation.d.ts

@@ -1,5 +1,6 @@
 import { ObjectId } from 'mongodb';
 import type { ConversationSla } from './ConversationSla';
+import type { SupportAvailability } from './SupportAvailability';
 export type SupportStatus = 'awaiting_agent' | 'awaiting_customer' | 'resolved';
 export interface Conversation {
     _id?: ObjectId;
@@ -18,5 +19,11 @@ export interface Conversation {
     supportStatusVersion?: number;
     /** Current support SLA projection, joined at read time rather than stored on the conversation. */
     sla?: ConversationSla | null;
+    /**
+     * Customer-facing support-hours summary (derived from the Sla config + server time), attached
+     * at read time for support conversations. Absent for non-support conversations and when no
+     * Sla configuration exists. Never carries the raw Sla fields.
+     */
+    supportAvailability?: SupportAvailability | null;
     new?: boolean;
 }

package/lib/esm/License.d.ts

@@ -0,0 +1,17 @@
+export interface License {
+    id: string;
+    name: string;
+    description?: string;
+    monthlyCost: number;
+    oneTimeCost?: number;
+    minimumContractMonths: number;
+    cancellationPeriodDays: number;
+    includesSupport: boolean;
+    supportSla?: string;
+    active: boolean;
+    autoExtend: boolean;
+    /** app ids that are included in this license */
+    includedApps: string[];
+    /** per-app usage limits, e.g. { editor: { pages: 10 }, media: { storageMb: 500 } } */
+    limits?: Record<string, Record<string, number>>;
+}

package/lib/esm/License.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=License.js.map

package/lib/esm/License.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"License.js","sourceRoot":"","sources":["../../src/License.ts"],"names":[],"mappings":""}

package/lib/esm/Storage.d.ts

@@ -1,7 +1,7 @@
 import { ObjectId } from "mongodb";
 import { MediaMetadata } from "./MediaMetadata";
 export interface Storage {
-    company: string;
+    company?: string;
     project?: string;
     /**
      * this document can be bound to a specific customer
@@ -11,6 +11,7 @@ export interface Storage {
      * this document can be bound to a specific list and customer
      */
     list?: ObjectId;
+    conversation?: ObjectId;
     filename: string;
     prefix?: string;
     path?: string;

package/lib/esm/SupportAvailability.d.ts

@@ -0,0 +1,13 @@
+import type { SupportDay } from './SupportDay';
+/**
+ * Customer-facing support-hours schedule.
+ *
+ * Only the derived schedule is exposed (`supportDays`, `timeZone`, `responseTimeHours`), never the
+ * raw Sla config. Whether support is open right now is derived by the client from the schedule
+ * and its own clock.
+ */
+export interface SupportAvailability {
+    responseTimeHours: number;
+    timeZone: string;
+    supportDays: SupportDay[];
+}

package/lib/esm/SupportAvailability.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SupportAvailability.js.map

package/lib/esm/SupportAvailability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SupportAvailability.js","sourceRoot":"","sources":["../../src/SupportAvailability.ts"],"names":[],"mappings":""}

package/lib/esm/Upload.d.ts

@@ -8,6 +8,7 @@ export interface Upload {
     project?: string;
     customer?: ObjectIdString | ObjectId;
     list?: ObjectIdString | ObjectId;
+    conversation?: ObjectIdString | ObjectId;
     user?: string;
     app: string;
     assetId?: string;

package/lib/esm/index.d.ts

@@ -24,11 +24,16 @@ export * from './CallResponse';
 export * from './CallToActionModule';
 export * from './Cart';
 export * from './CartItem';
+export * from './Category';
 export * from './CategoryStructure';
 export * from './CategoryStructureWithRequired';
 export * from './Certificate';
 export * from './CertificateAction';
 export * from './CertificateActionResult';
+export * from './ChatMessage';
+export * from './ChatMessageAttachment';
+export * from './ChatMessageMetadata';
+export * from './ChatSupportContext';
 export * from './ChildData';
 export * from './Command';
 export * from './CommandNginx';
@@ -121,6 +126,7 @@ export * from './InvoiceReferences';
 export * from './InvoiceTaxBreakdown';
 export * from './InvoiceTotals';
 export * from './InvoiceWithXml';
+export * from './License';
 export * from './LimiterBreach';
 export * from './LimiterPluginOptions';
 export * from './LimiterTier';
@@ -221,6 +227,7 @@ export * from './Stored';
 export * from './StoryModule';
 export * from './Structure';
 export * from './StudioIframeMessage';
+export * from './SupportAvailability';
 export * from './SupportDay';
 export * from './SystemDomain';
 export * from './TextModule';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lilaquadrat/interfaces",
-  "version": "1.48.0",
+  "version": "1.50.1",
   "description": "interfaces in context of lilaquadrat STUDIO",
   "author": {
     "email": "m.schuebel@lila2.de",

package/src/Category.ts

@@ -0,0 +1,9 @@
+import { AccessRule } from "./AccessRule";
+
+export interface Category {
+    company: string
+    project: string
+    key: string
+    label: string
+    read: AccessRule[];
+}

package/src/ChatMessage.ts

@@ -0,0 +1,12 @@
+import { ObjectIdString } from './ObjectIdString';
+import { ChatMessageAttachment } from './ChatMessageAttachment';
+import { ChatMessageMetadata } from './ChatMessageMetadata';
+
+export interface ChatMessage {
+  type: 'message:add';
+  conversation: ObjectIdString;
+  message: string;
+  clientMessageId?: string;
+  metadata?: ChatMessageMetadata;
+  attachments?: ChatMessageAttachment[];
+}

package/src/ChatMessageAttachment.ts

@@ -0,0 +1,6 @@
+import { ObjectIdString } from './ObjectIdString';
+
+export interface ChatMessageAttachment {
+  uploadId: ObjectIdString;
+  name: string;
+}

package/src/ChatMessageMetadata.ts

@@ -0,0 +1,5 @@
+import { ChatSupportContext } from './ChatSupportContext';
+
+export interface ChatMessageMetadata {
+  supportContext?: ChatSupportContext;
+}

package/src/ChatSupportContext.ts

@@ -0,0 +1,27 @@
+export interface ChatSupportContext {
+  company?: string;
+  project?: string;
+  url?: string;
+  pageTitle?: string;
+  appVersion?: string;
+  browser?: {
+    name?: string;
+    version?: string;
+  };
+  os?: {
+    name?: string;
+    version?: string;
+  };
+  screen?: {
+    width?: number;
+    height?: number;
+    pixelRatio?: number;
+  };
+  viewport?: {
+    width?: number;
+    height?: number;
+  };
+  locale?: string;
+  timezone?: string;
+  userAgent?: string;
+}

package/src/Content.ts

@@ -1,3 +1,4 @@
+import { ObjectId } from "mongodb"
 import { ChildData } from "./ChildData"
 import { CompatibleModule } from "./CompatibleModule"
 import { GenericData } from "./GenericData"
@@ -9,6 +10,7 @@ export interface Content {
   project: string
   modules: CompatibleModule[]
   tags?: string[]
+  categories?: ObjectId[]
   /**
    * a description of the content which will be used as context for AI text generation
    */

package/src/Conversation.ts

@@ -1,5 +1,6 @@
 import { ObjectId } from 'mongodb';
 import type { ConversationSla } from './ConversationSla';
+import type { SupportAvailability } from './SupportAvailability';
 
 export type SupportStatus = 'awaiting_agent' | 'awaiting_customer' | 'resolved';
 
@@ -20,5 +21,11 @@ export interface Conversation {
   supportStatusVersion?: number;
   /** Current support SLA projection, joined at read time rather than stored on the conversation. */
   sla?: ConversationSla | null;
+  /**
+   * Customer-facing support-hours summary (derived from the Sla config + server time), attached
+   * at read time for support conversations. Absent for non-support conversations and when no
+   * Sla configuration exists. Never carries the raw Sla fields.
+   */
+  supportAvailability?: SupportAvailability | null;
   new?: boolean;
 }

package/src/License.ts

@@ -0,0 +1,26 @@
+export interface License {
+
+  id: string;
+  name: string;
+
+  description?: string;
+
+  monthlyCost: number;
+  oneTimeCost?: number;
+
+  minimumContractMonths: number;
+  cancellationPeriodDays: number;
+
+  includesSupport: boolean;
+  supportSla?: string;
+
+  active: boolean;
+  autoExtend: boolean;
+
+  /** app ids that are included in this license */
+  includedApps: string[];
+
+  /** per-app usage limits, e.g. { editor: { pages: 10 }, media: { storageMb: 500 } } */
+  limits?: Record<string, Record<string, number>>;
+
+}

package/src/Storage.ts

@@ -2,7 +2,7 @@ import { ObjectId } from "mongodb";
 import { MediaMetadata } from "./MediaMetadata";
 
 export interface Storage {
-    company: string
+    company?: string
     project?: string
 
     /**
@@ -14,6 +14,8 @@ export interface Storage {
      */
     list?: ObjectId
 
+    conversation?: ObjectId
+
     filename: string
     prefix?: string
     
@@ -32,4 +34,4 @@ export interface Storage {
      * binds the storage document to a structure asset definition
      */
     assetId?: string
-}
+}

package/src/SupportAvailability.ts

@@ -0,0 +1,14 @@
+import type { SupportDay } from './SupportDay';
+
+/**
+ * Customer-facing support-hours schedule.
+ *
+ * Only the derived schedule is exposed (`supportDays`, `timeZone`, `responseTimeHours`), never the
+ * raw Sla config. Whether support is open right now is derived by the client from the schedule
+ * and its own clock.
+ */
+export interface SupportAvailability {
+  responseTimeHours: number;
+  timeZone: string;
+  supportDays: SupportDay[];
+}

package/src/Upload.ts

@@ -9,6 +9,7 @@ export interface Upload {
     project?: string;
     customer?: ObjectIdString | ObjectId;
     list?: ObjectIdString | ObjectId;
+    conversation?: ObjectIdString | ObjectId;
     user?: string;
     app: string;
     assetId?: string;