@speakai/shared 1.12.0 → 1.15.0

package/dist/enums/automation.d.ts

@@ -1,12 +1,41 @@
 export declare enum AutomationTrigger {
     FOLDERS = "folders",
     TAGS = "tags",
-    KEYWORDS = "keywords"
+    KEYWORDS = "keywords",
+    COMPOSIO = "composio"
 }
 export declare enum AutomationAction {
     MAGIC_PROMPT = "magic-prompt",
     TRANSLATION = "translation"
 }
+/**
+ * The kinds of step a graph automation (schemaVersion >= 2) can contain. Legacy
+ * single-action rows are projected to a one-step graph at read/execution time.
+ */
+export declare enum AutomationStepType {
+    MAGIC_PROMPT = "magic-prompt",
+    TRANSLATION = "translation",
+    COMPOSIO_ACTION = "composio-action",
+    FILTER = "filter"
+}
+/** Lifecycle status of an automation run and of each step within it. */
+export declare enum AutomationRunStatus {
+    PENDING = "pending",
+    RUNNING = "running",
+    COMPLETED = "completed",
+    FAILED = "failed",
+    KILLED = "killed"
+}
+/**
+ * The data type flowing between trigger and steps in a graph. Used by the catalog
+ * to validate that each step accepts what the previous one emits.
+ */
+export declare enum AutomationIOType {
+    FILE = "file",
+    MEDIA = "media",
+    INSIGHT = "insight",
+    NOTIFY = "notify"
+}
 export declare enum AutomationRunType {
     INSTANT = "instant",
     SCHEDULE = "schedule"

package/dist/enums/automation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"automation.d.ts","sourceRoot":"","sources":["../../src/enums/automation.ts"],"names":[],"mappings":"AAAA,oBAAY,iBAAiB;IAC3B,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,QAAQ,aAAa;CACtB;AAED,oBAAY,gBAAgB;IAC1B,YAAY,iBAAiB;IAC7B,WAAW,gBAAgB;CAC5B;AAED,oBAAY,iBAAiB;IAC3B,OAAO,YAAY;IACnB,QAAQ,aAAa;CACtB;AAED,oBAAY,4BAA4B;IACtC,KAAK,UAAU;IACf,SAAS,cAAc;IACvB,WAAW,cAAc;IACzB,YAAY,eAAe;IAC3B,SAAS,aAAa;CACvB;AAED,oBAAY,aAAa;IACvB,UAAU,eAAe;IACzB,QAAQ,aAAa;IACrB,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,MAAM,WAAW;CAClB"}
+{"version":3,"file":"automation.d.ts","sourceRoot":"","sources":["../../src/enums/automation.ts"],"names":[],"mappings":"AAAA,oBAAY,iBAAiB;IAC3B,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,QAAQ,aAAa;IAErB,QAAQ,aAAa;CACtB;AAED,oBAAY,gBAAgB;IAC1B,YAAY,iBAAiB;IAC7B,WAAW,gBAAgB;CAC5B;AAED;;;GAGG;AACH,oBAAY,kBAAkB;IAC5B,YAAY,iBAAiB;IAC7B,WAAW,gBAAgB;IAC3B,eAAe,oBAAoB;IACnC,MAAM,WAAW;CAClB;AAED,wEAAwE;AACxE,oBAAY,mBAAmB;IAC7B,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,MAAM,WAAW;IAEjB,MAAM,WAAW;CAClB;AAED;;;GAGG;AACH,oBAAY,gBAAgB;IAC1B,IAAI,SAAS;IACb,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,MAAM,WAAW;CAClB;AAED,oBAAY,iBAAiB;IAC3B,OAAO,YAAY;IACnB,QAAQ,aAAa;CACtB;AAED,oBAAY,4BAA4B;IACtC,KAAK,UAAU;IACf,SAAS,cAAc;IACvB,WAAW,cAAc;IACzB,YAAY,eAAe;IAC3B,SAAS,aAAa;CACvB;AAED,oBAAY,aAAa;IACvB,UAAU,eAAe;IACzB,QAAQ,aAAa;IACrB,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,MAAM,WAAW;CAClB"}

package/dist/enums/automation.js

@@ -3,12 +3,46 @@ export var AutomationTrigger;
     AutomationTrigger["FOLDERS"] = "folders";
     AutomationTrigger["TAGS"] = "tags";
     AutomationTrigger["KEYWORDS"] = "keywords";
+    // Reserved for the Composio integration slice; native execution ignores it for now.
+    AutomationTrigger["COMPOSIO"] = "composio";
 })(AutomationTrigger || (AutomationTrigger = {}));
 export var AutomationAction;
 (function (AutomationAction) {
     AutomationAction["MAGIC_PROMPT"] = "magic-prompt";
     AutomationAction["TRANSLATION"] = "translation";
 })(AutomationAction || (AutomationAction = {}));
+/**
+ * The kinds of step a graph automation (schemaVersion >= 2) can contain. Legacy
+ * single-action rows are projected to a one-step graph at read/execution time.
+ */
+export var AutomationStepType;
+(function (AutomationStepType) {
+    AutomationStepType["MAGIC_PROMPT"] = "magic-prompt";
+    AutomationStepType["TRANSLATION"] = "translation";
+    AutomationStepType["COMPOSIO_ACTION"] = "composio-action";
+    AutomationStepType["FILTER"] = "filter";
+})(AutomationStepType || (AutomationStepType = {}));
+/** Lifecycle status of an automation run and of each step within it. */
+export var AutomationRunStatus;
+(function (AutomationRunStatus) {
+    AutomationRunStatus["PENDING"] = "pending";
+    AutomationRunStatus["RUNNING"] = "running";
+    AutomationRunStatus["COMPLETED"] = "completed";
+    AutomationRunStatus["FAILED"] = "failed";
+    // Filter step did not match: the run stops here without being an error.
+    AutomationRunStatus["KILLED"] = "killed";
+})(AutomationRunStatus || (AutomationRunStatus = {}));
+/**
+ * The data type flowing between trigger and steps in a graph. Used by the catalog
+ * to validate that each step accepts what the previous one emits.
+ */
+export var AutomationIOType;
+(function (AutomationIOType) {
+    AutomationIOType["FILE"] = "file";
+    AutomationIOType["MEDIA"] = "media";
+    AutomationIOType["INSIGHT"] = "insight";
+    AutomationIOType["NOTIFY"] = "notify";
+})(AutomationIOType || (AutomationIOType = {}));
 export var AutomationRunType;
 (function (AutomationRunType) {
     AutomationRunType["INSTANT"] = "instant";

package/dist/enums/automation.js.map

@@ -1 +1 @@
-{"version":3,"file":"automation.js","sourceRoot":"","sources":["../../src/enums/automation.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,iBAIX;AAJD,WAAY,iBAAiB;IAC3B,wCAAmB,CAAA;IACnB,kCAAa,CAAA;IACb,0CAAqB,CAAA;AACvB,CAAC,EAJW,iBAAiB,KAAjB,iBAAiB,QAI5B;AAED,MAAM,CAAN,IAAY,gBAGX;AAHD,WAAY,gBAAgB;IAC1B,iDAA6B,CAAA;IAC7B,+CAA2B,CAAA;AAC7B,CAAC,EAHW,gBAAgB,KAAhB,gBAAgB,QAG3B;AAED,MAAM,CAAN,IAAY,iBAGX;AAHD,WAAY,iBAAiB;IAC3B,wCAAmB,CAAA;IACnB,0CAAqB,CAAA;AACvB,CAAC,EAHW,iBAAiB,KAAjB,iBAAiB,QAG5B;AAED,MAAM,CAAN,IAAY,4BAMX;AAND,WAAY,4BAA4B;IACtC,+CAAe,CAAA;IACf,uDAAuB,CAAA;IACvB,yDAAyB,CAAA;IACzB,2DAA2B,CAAA;IAC3B,sDAAsB,CAAA;AACxB,CAAC,EANW,4BAA4B,KAA5B,4BAA4B,QAMvC;AAED,MAAM,CAAN,IAAY,aAOX;AAPD,WAAY,aAAa;IACvB,0CAAyB,CAAA;IACzB,sCAAqB,CAAA;IACrB,gCAAe,CAAA;IACf,oCAAmB,CAAA;IACnB,wCAAuB,CAAA;IACvB,kCAAiB,CAAA;AACnB,CAAC,EAPW,aAAa,KAAb,aAAa,QAOxB"}
+{"version":3,"file":"automation.js","sourceRoot":"","sources":["../../src/enums/automation.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,iBAMX;AAND,WAAY,iBAAiB;IAC3B,wCAAmB,CAAA;IACnB,kCAAa,CAAA;IACb,0CAAqB,CAAA;IACrB,oFAAoF;IACpF,0CAAqB,CAAA;AACvB,CAAC,EANW,iBAAiB,KAAjB,iBAAiB,QAM5B;AAED,MAAM,CAAN,IAAY,gBAGX;AAHD,WAAY,gBAAgB;IAC1B,iDAA6B,CAAA;IAC7B,+CAA2B,CAAA;AAC7B,CAAC,EAHW,gBAAgB,KAAhB,gBAAgB,QAG3B;AAED;;;GAGG;AACH,MAAM,CAAN,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAC5B,mDAA6B,CAAA;IAC7B,iDAA2B,CAAA;IAC3B,yDAAmC,CAAA;IACnC,uCAAiB,CAAA;AACnB,CAAC,EALW,kBAAkB,KAAlB,kBAAkB,QAK7B;AAED,wEAAwE;AACxE,MAAM,CAAN,IAAY,mBAOX;AAPD,WAAY,mBAAmB;IAC7B,0CAAmB,CAAA;IACnB,0CAAmB,CAAA;IACnB,8CAAuB,CAAA;IACvB,wCAAiB,CAAA;IACjB,wEAAwE;IACxE,wCAAiB,CAAA;AACnB,CAAC,EAPW,mBAAmB,KAAnB,mBAAmB,QAO9B;AAED;;;GAGG;AACH,MAAM,CAAN,IAAY,gBAKX;AALD,WAAY,gBAAgB;IAC1B,iCAAa,CAAA;IACb,mCAAe,CAAA;IACf,uCAAmB,CAAA;IACnB,qCAAiB,CAAA;AACnB,CAAC,EALW,gBAAgB,KAAhB,gBAAgB,QAK3B;AAED,MAAM,CAAN,IAAY,iBAGX;AAHD,WAAY,iBAAiB;IAC3B,wCAAmB,CAAA;IACnB,0CAAqB,CAAA;AACvB,CAAC,EAHW,iBAAiB,KAAjB,iBAAiB,QAG5B;AAED,MAAM,CAAN,IAAY,4BAMX;AAND,WAAY,4BAA4B;IACtC,+CAAe,CAAA;IACf,uDAAuB,CAAA;IACvB,yDAAyB,CAAA;IACzB,2DAA2B,CAAA;IAC3B,sDAAsB,CAAA;AACxB,CAAC,EANW,4BAA4B,KAA5B,4BAA4B,QAMvC;AAED,MAAM,CAAN,IAAY,aAOX;AAPD,WAAY,aAAa;IACvB,0CAAyB,CAAA;IACzB,sCAAqB,CAAA;IACrB,gCAAe,CAAA;IACf,oCAAmB,CAAA;IACnB,wCAAuB,CAAA;IACvB,kCAAiB,CAAA;AACnB,CAAC,EAPW,aAAa,KAAb,aAAa,QAOxB"}

package/dist/interfaces/automation.d.ts

@@ -1,27 +1,61 @@
-import { AutomationTrigger, AutomationAction, AutomationRunType, AutomationScheduleTimePeriod, AssistantType, AllowedValuesMode } from '../enums/index.js';
+import { AutomationTrigger, AutomationAction, AutomationRunType, AutomationScheduleTimePeriod, AutomationStepType, AutomationRunStatus, AssistantType, AllowedValuesMode } from '../enums/index.js';
+/** Configuration of a magic-prompt action/step. Shared by the legacy action body and graph steps. */
+export interface IAutomationMagicPromptConfig {
+    title: string;
+    assistantType: AssistantType;
+    assistantTemplateId: string;
+    prompt: string;
+    fieldId?: string;
+    fieldIds?: string[];
+    isIndividualFolder?: boolean;
+    allowedValues?: string[];
+    allowedValuesMode?: AllowedValuesMode;
+    otherValues?: boolean;
+    notApplicableValues?: string;
+}
+/** Configuration of a translation action/step. */
+export interface IAutomationTranslationConfig {
+    targetLanguage: string;
+}
 export interface IAutomationAction {
     type: AutomationAction;
-    magicPrompt: {
-        title: string;
-        assistantType: AssistantType;
-        assistantTemplateId: string;
-        prompt: string;
-        fieldId?: string;
-        isIndividualFolder?: boolean;
-        allowedValues?: string[];
-        allowedValuesMode?: AllowedValuesMode;
-        otherValues?: boolean;
-        notApplicableValues?: string;
-    };
-    translation: {
-        targetLanguage: string;
+    magicPrompt: IAutomationMagicPromptConfig;
+    translation: IAutomationTranslationConfig;
+}
+/** Configuration of a Composio integration step (reserved for the Composio slice). */
+export interface IAutomationComposioConfig {
+    app: string;
+    action: string;
+    connectedAccountId?: string;
+    argsTemplate?: Record<string, unknown>;
+    destructive?: boolean;
+    acknowledged?: boolean;
+}
+/** A single condition inside a filter step. */
+export interface IAutomationFilterRule {
+    field: string;
+    op: string;
+    value?: string | number;
+}
+/** A node in a graph automation (schemaVersion >= 2). */
+export interface IAutomationStep {
+    stepId: string;
+    stepType: AutomationStepType;
+    magicPrompt?: IAutomationMagicPromptConfig;
+    translation?: IAutomationTranslationConfig;
+    composio?: IAutomationComposioConfig;
+    filter?: {
+        logic: 'AND' | 'OR';
+        rules: IAutomationFilterRule[];
     };
+    dependsOn?: string[];
 }
 export interface IAutomation {
     _id: string;
     automationId: string;
     name: string;
     description: string;
+    schemaVersion?: number;
     isActive: boolean;
     isUpdated: boolean;
     isDeleted: boolean;
@@ -30,8 +64,12 @@ export interface IAutomation {
         type: AutomationTrigger;
         folderIds: string[];
         values: string[];
+        provider?: 'speak' | 'composio';
+        app?: string;
+        triggerSlug?: string;
     };
     action: IAutomationAction;
+    steps?: IAutomationStep[];
     schedule: {
         timePeriod: AutomationScheduleTimePeriod;
         repeatAt: string;
@@ -43,4 +81,45 @@ export interface IAutomation {
     createdAt: Date;
     updatedAt: Date;
 }
+/** Per-step execution record on a run. */
+export interface IAutomationRunStep {
+    stepId: string;
+    stepType: AutomationStepType;
+    status: AutomationRunStatus;
+    startedAt?: Date;
+    finishedAt?: Date;
+    attemptCount?: number;
+    /**
+     * Executor config (magicPrompt/translation/filter/composio block) snapshotted at
+     * run creation, so resuming a deferred step cannot be misaligned by a mid-flight
+     * edit to the automation. Absent on runs created before snapshots shipped.
+     */
+    config?: Record<string, unknown>;
+    output?: Record<string, unknown>;
+    error?: string;
+}
+/** One document per automation execution (graph engine run ledger). */
+export interface IAutomationRun {
+    _id: string;
+    runId: string;
+    automationId: string;
+    companyId: string;
+    userId: string;
+    schemaVersion: number;
+    externalEventId?: string;
+    status: AutomationRunStatus;
+    trigger: {
+        source: string;
+        mediaId?: string;
+        folderId?: string;
+        payload?: Record<string, unknown>;
+    };
+    awaitingMediaId?: string;
+    nextStepId?: string;
+    /** Run-level failure reason (deferred-seam failures, stale-run sweep). */
+    error?: string;
+    steps: IAutomationRunStep[];
+    createdAt: Date;
+    updatedAt: Date;
+}
 //# sourceMappingURL=automation.d.ts.map

package/dist/interfaces/automation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"automation.d.ts","sourceRoot":"","sources":["../../src/interfaces/automation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,4BAA4B,EAC5B,aAAa,EACb,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,gBAAgB,CAAC;IACvB,WAAW,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,aAAa,EAAE,aAAa,CAAC;QAC7B,mBAAmB,EAAE,MAAM,CAAC;QAC5B,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QACzB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;QACtC,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF,WAAW,EAAE;QACX,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,OAAO,EAAE;QACP,IAAI,EAAE,iBAAiB,CAAC;QACxB,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;IACF,MAAM,EAAE,iBAAiB,CAAC;IAC1B,QAAQ,EAAE;QACR,UAAU,EAAE,4BAA4B,CAAC;QACzC,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,aAAa,EAAE;QACb,IAAI,EAAE,gBAAgB,CAAC;QACvB,EAAE,EAAE,MAAM,CAAC;KACZ,EAAE,CAAC;IACJ,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB"}
+{"version":3,"file":"automation.d.ts","sourceRoot":"","sources":["../../src/interfaces/automation.ts"],"names":[],"mappings":"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"}

package/dist/interfaces/dashboard.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Dashboard feature — shared wire contract.
+ *
+ * Single source of truth for the Dashboards API shape, consumed by speak-client
+ * (builder + queries) and speak-server (@speak-dashboards). The server's Mongoose
+ * document type may extend these; the client imports them directly.
+ */
+/** Built-in dashboard widget types. */
+export type DashboardWidgetType = 'stat-cards' | 'sentiment' | 'media-list' | 'field-distribution' | 'upload-timeline' | 'themes' | 'team-activity' | 'kpi-trend';
+/** Grid placement for a widget (react-grid-layout geometry; legacy order/colSpan optional). */
+export interface IDashboardWidgetLayout {
+    x?: number;
+    y?: number;
+    w?: number;
+    h?: number;
+    minW?: number;
+    minH?: number;
+    /** @deprecated legacy linear ordering — superseded by x/y. */
+    order?: number;
+    /** @deprecated legacy column span — superseded by w. */
+    colSpan?: number;
+}
+/** A single configured widget on a dashboard. */
+export interface IDashboardWidget {
+    id: string;
+    type: DashboardWidgetType | string;
+    title: string;
+    /** Render-only, widget-type-specific settings (chartType, fieldId, accentColor, …). */
+    config: Record<string, unknown>;
+    layout: IDashboardWidgetLayout;
+}
+/** Date scope for a dashboard (preset key, with optional explicit bounds). */
+export interface IDashboardDateRange {
+    preset?: string;
+    startDate?: string | Date;
+    endDate?: string | Date;
+}
+/** Full dashboard wire shape (owner/authed view). */
+export interface IDashboard {
+    dashboardId: string;
+    title: string;
+    description?: string;
+    icon?: string;
+    /** Folder ids the dashboard is scoped to (empty = all accessible). */
+    folderScope: string[];
+    dateRange?: IDashboardDateRange;
+    filters?: Record<string, unknown>;
+    widgets: IDashboardWidget[];
+    /** Public share token — present only to the owner when sharing is enabled. */
+    shareToken?: string;
+    isShareEnabled?: boolean;
+    /** Team/group ids the dashboard is shared with ("<id> (G)" convention). */
+    sharedWithGroups?: string[];
+    isDefault?: boolean;
+    schemaVersion?: number;
+    createdAt?: string | Date;
+    updatedAt?: string | Date;
+}
+/** Public (token-resolved, unauthenticated) projection — secret/internal fields stripped. */
+export interface IPublicDashboard {
+    title: string;
+    description?: string;
+    icon?: string;
+    widgets: IDashboardWidget[];
+    folderScope: string[];
+    dateRange?: IDashboardDateRange;
+}
+/** Create payload. */
+export interface ICreateDashboardPayload {
+    title: string;
+    description?: string;
+    icon?: string;
+    folderScope?: string[];
+    dateRange?: IDashboardDateRange;
+    filters?: Record<string, unknown>;
+    widgets?: IDashboardWidget[];
+    sharedWithGroups?: string[];
+    isDefault?: boolean;
+}
+/** Update payload (partial). */
+export type IUpdateDashboardPayload = Partial<ICreateDashboardPayload>;
+//# sourceMappingURL=dashboard.d.ts.map

package/dist/interfaces/dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../src/interfaces/dashboard.ts"],"names":[],"mappings":"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"}

package/dist/interfaces/dashboard.js

@@ -0,0 +1,9 @@
+/**
+ * Dashboard feature — shared wire contract.
+ *
+ * Single source of truth for the Dashboards API shape, consumed by speak-client
+ * (builder + queries) and speak-server (@speak-dashboards). The server's Mongoose
+ * document type may extend these; the client imports them directly.
+ */
+export {};
+//# sourceMappingURL=dashboard.js.map

package/dist/interfaces/dashboard.js.map

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

package/dist/interfaces/index.d.ts

@@ -17,4 +17,5 @@ export * from './subscription.js';
 export * from './calendar.js';
 export * from './category.js';
 export * from './clip.js';
+export * from './dashboard.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/interfaces/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC"}

package/dist/interfaces/index.js

@@ -17,4 +17,5 @@ export * from './subscription.js';
 export * from './calendar.js';
 export * from './category.js';
 export * from './clip.js';
+export * from './dashboard.js';
 //# sourceMappingURL=index.js.map

package/dist/interfaces/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@speakai/shared",
-  "version": "1.12.0",
+  "version": "1.15.0",
   "description": "Shared types, enums and interfaces for Speak AI platform",
   "type": "module",
   "main": "dist/index.js",