@lilaquadrat/interfaces 1.46.0 → 1.48.0

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 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.48.0](https://github.com/lilaquadrat/interfaces/compare/v1.47.0...v1.48.0) (2026-08-28)
+
+
+### Features
+
+* **me:** added lastSeen & connected status ([9256d37](https://github.com/lilaquadrat/interfaces/commit/9256d3765699044a43cf36d7f271966f626d6cea))
+
+## [1.47.0](https://github.com/lilaquadrat/interfaces/compare/v1.46.0...v1.47.0) (2026-08-28)
+
+
+### Features
+
+* **sla:** add configuration and conversation contracts ([2973218](https://github.com/lilaquadrat/interfaces/commit/2973218714e3fe36c404f6ac09f1679d608cafd4))
+
 ## [1.46.0](https://github.com/lilaquadrat/interfaces/compare/v1.45.0...v1.46.0) (2026-07-27)
 
 

package/lib/cjs/Conversation.d.ts

@@ -1,4 +1,6 @@
 import { ObjectId } from 'mongodb';
+import type { ConversationSla } from './ConversationSla';
+export type SupportStatus = 'awaiting_agent' | 'awaiting_customer' | 'resolved';
 export interface Conversation {
     _id?: ObjectId;
     name?: string;
@@ -11,5 +13,10 @@ export interface Conversation {
     lastActivity?: string;
     /** how the conversation was started. 'support' = backend attaches the support team. */
     operationMode?: 'default' | 'support';
+    supportStatus?: SupportStatus;
+    supportStatusUpdatedAt?: string;
+    supportStatusVersion?: number;
+    /** Current support SLA projection, joined at read time rather than stored on the conversation. */
+    sla?: ConversationSla | null;
     new?: boolean;
 }

package/lib/cjs/ConversationSla.d.ts

@@ -0,0 +1,9 @@
+import type { SupportStatus } from './Conversation';
+export interface ConversationSla {
+    conversation: string;
+    status: SupportStatus;
+    statusVersion: number;
+    startedAt: string;
+    endAt: string;
+    stoppedAt?: string;
+}

package/lib/cjs/Me.d.ts

@@ -8,4 +8,15 @@ export interface Me {
     settings?: Settings['settings'];
     termsAccepted?: boolean;
     emailConfirmed?: boolean;
+    /**
+     * presence: last moment a websocket of this user was proven alive.
+     * written by the chat service only, never through the /me routes.
+    */
+    lastSeen?: Date | string;
+    /**
+     * presence: raw "holds at least one live socket" flag. The `online` state exposed to
+     * clients is derived from this AND lastSeen freshness, so a crashed process that never
+     * cleared the flag still reads as offline.
+    */
+    connected?: boolean;
 }

package/lib/cjs/Sla.d.ts

@@ -0,0 +1,8 @@
+import { SupportDay } from './SupportDay';
+export interface Sla {
+    company: string;
+    providesSupport: boolean;
+    responseTimeHours: number;
+    timeZone: string;
+    supportDays: SupportDay[];
+}

package/lib/cjs/SupportDay.d.ts

@@ -0,0 +1,5 @@
+export interface SupportDay {
+    day: 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday';
+    startTime: string;
+    endTime: string;
+}

package/lib/cjs/index.d.ts

@@ -48,6 +48,7 @@ export * from './ContentOptions';
 export * from './ContentWithPositions';
 export * from './Contract';
 export * from './Conversation';
+export * from './ConversationSla';
 export * from './CookiesModule';
 export * from './CreateResult';
 export * from './CustomerAccounts';
@@ -211,6 +212,7 @@ export * from './ShareClientOptions';
 export * from './ShopifyProjectSettings';
 export * from './ShoppingCartModule';
 export * from './SkipLimitSort';
+export * from './Sla';
 export * from './Storage';
 export * from './StorageCopyAction';
 export * from './StorageFilePaths';
@@ -219,6 +221,7 @@ export * from './Stored';
 export * from './StoryModule';
 export * from './Structure';
 export * from './StudioIframeMessage';
+export * from './SupportDay';
 export * from './SystemDomain';
 export * from './TextModule';
 export * from './Textblock';

package/lib/esm/Conversation.d.ts

@@ -1,4 +1,6 @@
 import { ObjectId } from 'mongodb';
+import type { ConversationSla } from './ConversationSla';
+export type SupportStatus = 'awaiting_agent' | 'awaiting_customer' | 'resolved';
 export interface Conversation {
     _id?: ObjectId;
     name?: string;
@@ -11,5 +13,10 @@ export interface Conversation {
     lastActivity?: string;
     /** how the conversation was started. 'support' = backend attaches the support team. */
     operationMode?: 'default' | 'support';
+    supportStatus?: SupportStatus;
+    supportStatusUpdatedAt?: string;
+    supportStatusVersion?: number;
+    /** Current support SLA projection, joined at read time rather than stored on the conversation. */
+    sla?: ConversationSla | null;
     new?: boolean;
 }

package/lib/esm/ConversationSla.d.ts

@@ -0,0 +1,9 @@
+import type { SupportStatus } from './Conversation';
+export interface ConversationSla {
+    conversation: string;
+    status: SupportStatus;
+    statusVersion: number;
+    startedAt: string;
+    endAt: string;
+    stoppedAt?: string;
+}

package/lib/esm/ConversationSla.js

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

package/lib/esm/ConversationSla.js.map

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

package/lib/esm/Me.d.ts

@@ -8,4 +8,15 @@ export interface Me {
     settings?: Settings['settings'];
     termsAccepted?: boolean;
     emailConfirmed?: boolean;
+    /**
+     * presence: last moment a websocket of this user was proven alive.
+     * written by the chat service only, never through the /me routes.
+    */
+    lastSeen?: Date | string;
+    /**
+     * presence: raw "holds at least one live socket" flag. The `online` state exposed to
+     * clients is derived from this AND lastSeen freshness, so a crashed process that never
+     * cleared the flag still reads as offline.
+    */
+    connected?: boolean;
 }

package/lib/esm/Sla.d.ts

@@ -0,0 +1,8 @@
+import { SupportDay } from './SupportDay';
+export interface Sla {
+    company: string;
+    providesSupport: boolean;
+    responseTimeHours: number;
+    timeZone: string;
+    supportDays: SupportDay[];
+}

package/lib/esm/Sla.js

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

package/lib/esm/Sla.js.map

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

package/lib/esm/SupportDay.d.ts

@@ -0,0 +1,5 @@
+export interface SupportDay {
+    day: 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday';
+    startTime: string;
+    endTime: string;
+}

package/lib/esm/SupportDay.js

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

package/lib/esm/SupportDay.js.map

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

package/lib/esm/index.d.ts

@@ -48,6 +48,7 @@ export * from './ContentOptions';
 export * from './ContentWithPositions';
 export * from './Contract';
 export * from './Conversation';
+export * from './ConversationSla';
 export * from './CookiesModule';
 export * from './CreateResult';
 export * from './CustomerAccounts';
@@ -211,6 +212,7 @@ export * from './ShareClientOptions';
 export * from './ShopifyProjectSettings';
 export * from './ShoppingCartModule';
 export * from './SkipLimitSort';
+export * from './Sla';
 export * from './Storage';
 export * from './StorageCopyAction';
 export * from './StorageFilePaths';
@@ -219,6 +221,7 @@ export * from './Stored';
 export * from './StoryModule';
 export * from './Structure';
 export * from './StudioIframeMessage';
+export * from './SupportDay';
 export * from './SystemDomain';
 export * from './TextModule';
 export * from './Textblock';

package/package.json

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

package/src/Conversation.ts

@@ -1,4 +1,7 @@
 import { ObjectId } from 'mongodb';
+import type { ConversationSla } from './ConversationSla';
+
+export type SupportStatus = 'awaiting_agent' | 'awaiting_customer' | 'resolved';
 
 export interface Conversation {
   _id?: ObjectId;
@@ -12,5 +15,10 @@ export interface Conversation {
   lastActivity?: string;
   /** how the conversation was started. 'support' = backend attaches the support team. */
   operationMode?: 'default' | 'support';
+  supportStatus?: SupportStatus;
+  supportStatusUpdatedAt?: string;
+  supportStatusVersion?: number;
+  /** Current support SLA projection, joined at read time rather than stored on the conversation. */
+  sla?: ConversationSla | null;
   new?: boolean;
 }

package/src/ConversationSla.ts

@@ -0,0 +1,10 @@
+import type { SupportStatus } from './Conversation';
+
+export interface ConversationSla {
+  conversation: string;
+  status: SupportStatus;
+  statusVersion: number;
+  startedAt: string;
+  endAt: string;
+  stoppedAt?: string;
+}

package/src/Me.ts

@@ -11,4 +11,17 @@ export interface Me {
   termsAccepted?: boolean
   emailConfirmed?: boolean
 
+  /**
+   * presence: last moment a websocket of this user was proven alive.
+   * written by the chat service only, never through the /me routes.
+  */
+  lastSeen?: Date | string
+
+  /**
+   * presence: raw "holds at least one live socket" flag. The `online` state exposed to
+   * clients is derived from this AND lastSeen freshness, so a crashed process that never
+   * cleared the flag still reads as offline.
+  */
+  connected?: boolean
+
 }

package/src/Sla.ts

@@ -0,0 +1,9 @@
+import { SupportDay } from './SupportDay';
+
+export interface Sla {
+  company: string;
+  providesSupport: boolean;
+  responseTimeHours: number;
+  timeZone: string;
+  supportDays: SupportDay[];
+}

package/src/SupportDay.ts

@@ -0,0 +1,5 @@
+export interface SupportDay {
+  day: 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday';
+  startTime: string;
+  endTime: string;
+}