@purpleschool/student-works 1.2.2 → 1.3.1

package/build/models/presentation/slide-content.schema.js

@@ -0,0 +1,358 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SlideContentSchema = exports.TimelineSlideDataSchema = exports.ChartSlideDataSchema = exports.BarChartSlideDataSchema = exports.TableSlideDataSchema = exports.SectionBreakSlideDataSchema = exports.ImageSlideDataSchema = exports.ContentsSlideDataSchema = exports.TextSlideDataSchema = exports.StructuredListSlideDataSchema = exports.ThankYouSlideDataSchema = exports.CoverSlideDataSchema = exports.IconSlotSchema = exports.ImageSlotSchema = exports.SLIDE_CHART_TYPE = void 0;
+const zod_1 = require("zod");
+const constants_1 = require("../../constants");
+var SLIDE_CHART_TYPE;
+(function (SLIDE_CHART_TYPE) {
+    SLIDE_CHART_TYPE["BAR"] = "BAR";
+})(SLIDE_CHART_TYPE || (exports.SLIDE_CHART_TYPE = SLIDE_CHART_TYPE = {}));
+exports.ImageSlotSchema = zod_1.z.object({
+    uuid: zod_1.z
+        .string()
+        .uuid()
+        .describe('Generate a valid uuid for image slot, that will be used for future lookups'),
+    prompt: zod_1.z
+        .string()
+        .describe('Image generation prompt. MUST be written in ENGLISH regardless of the presentation language. ' +
+        'AI image generators excel at: atmospheric scenes, landscapes, cityscapes, architecture, nature, abstract light and texture, anonymous silhouettes, artistic photography. ' +
+        'AI fundamentally cannot render accurately: legible text on any surface, complex diagrams or flowcharts, data charts/graphs, specific product logos, clocks, precise mechanical parts. ' +
+        'Choose scene types from the first category. Avoid anything in the second. ' +
+        'Structure: [subject/scene] → [mood/atmosphere] → [lighting] → [visual style]. ' +
+        'Evoke the emotional register of the slide — do not illustrate the topic literally. ' +
+        'MODERATION: if the slide topic involves conflict, suffering, politics, or crime, redirect to abstract/atmospheric imagery (fog, ruins, empty landscapes) rather than depicting the subject directly — flagged prompts produce empty placeholders. ' +
+        'GOOD: "A lone figure on an observation deck at dusk gazing over an illuminated city. Cinematic wide-angle, golden-hour light, photorealistic." ' +
+        'BAD: "A bar chart showing quarterly growth. A robot at a laptop with code on the screen."'),
+});
+exports.IconSlotSchema = zod_1.z.object({
+    uuid: zod_1.z
+        .string()
+        .uuid()
+        .describe('Generate a valid uuid for icon slot, that will be used for future lookups'),
+    prompt: zod_1.z.string().describe('Provide a search query for an fitting icon. MUST BE IN ENGLISH'),
+});
+exports.CoverSlideDataSchema = zod_1.z.object({
+    contentType: zod_1.z.literal(constants_1.SLIDE_CONTENT_TYPE.COVER),
+    title: zod_1.z.string().describe('Slide title in about 6 words').min(10).max(150),
+    author: zod_1.z.object({
+        label: zod_1.z.string().describe('Literal "Author" in presentation\'s language'),
+        value: zod_1.z
+            .string()
+            .describe('Literal "Author of the presentation" in presentation\'s language'),
+    }),
+    date: zod_1.z.object({
+        label: zod_1.z.string().describe('Literal "Date" in presentation\'s language'),
+        value: zod_1.z
+            .string()
+            .describe('Date of the presentation in the "dd month yyyy" format in presentation\'s locale'),
+    }),
+    email: zod_1.z.object({
+        label: zod_1.z.string().describe('Just default word "Email"'),
+        value: zod_1.z.string().describe('Just default "email@example.com"'),
+    }),
+    version: zod_1.z.literal(1),
+});
+exports.ThankYouSlideDataSchema = zod_1.z.object({
+    contentType: zod_1.z.literal(constants_1.SLIDE_CONTENT_TYPE.THANK_YOU),
+    title: zod_1.z
+        .string()
+        .describe('"Thank you for your attention" in presentation\'s language')
+        .min(10)
+        .max(150),
+    author: zod_1.z.object({
+        label: zod_1.z.string().describe('"Author" in presentation\'s language'),
+        value: zod_1.z.string().describe('"Author of the presentation" in presentation\'s language'),
+    }),
+    date: zod_1.z.object({
+        label: zod_1.z.string().describe('"Date" in presentation\'s language'),
+        value: zod_1.z
+            .string()
+            .describe('Date of the presentation in the "dd month yyyy" format in presentation\'s locale'),
+    }),
+    email: zod_1.z.object({
+        label: zod_1.z.string().describe('Just default word "Email"'),
+        value: zod_1.z.string().describe('Just default "email@example.com"'),
+    }),
+    version: zod_1.z.literal(1),
+});
+exports.StructuredListSlideDataSchema = zod_1.z.object({
+    contentType: zod_1.z.literal(constants_1.SLIDE_CONTENT_TYPE.STRUCTURED_LIST),
+    title: zod_1.z
+        .string()
+        .describe('Slide headline — 2–4 words naming the group. A noun phrase, NOT a full sentence. Displayed in very large font on the left panel.')
+        .min(5)
+        .max(40),
+    description: zod_1.z
+        .string()
+        .describe('One framing sentence answering "What are these 4 things about?". Displayed in small text below the title on the left panel.')
+        .min(30)
+        .max(80),
+    list: zod_1.z
+        .array(zod_1.z.object({
+        title: zod_1.z
+            .string()
+            .describe('2–4 concrete words. A noun phrase or short verb phrase. All 4 titles MUST be grammatically parallel. Displayed in bold next to a large number (01–04).')
+            .min(3)
+            .max(30),
+        description: zod_1.z
+            .string()
+            .describe('ONE complete sentence that expands on the title with a specific fact or benefit. NEVER just restate the title. NEVER cut short mid-word or mid-sentence. All 4 descriptions must be roughly equal in length.')
+            .min(50)
+            .max(100),
+    }))
+        .length(4),
+    version: zod_1.z.literal(1),
+});
+exports.TextSlideDataSchema = zod_1.z.object({
+    contentType: zod_1.z.literal(constants_1.SLIDE_CONTENT_TYPE.TEXT),
+    title: zod_1.z
+        .string()
+        .describe('Slide headline rendered in very large bold font. Keep to 3–7 words (max 70 characters). It should name the topic or thesis — not summarise all content.')
+        .min(10)
+        .max(70),
+    description: zod_1.z
+        .string()
+        .describe('Expository prose split into 2–3 paragraphs separated by \\n\\n (double newline). Total length 300–800 characters. ' +
+        'Use **bold** to highlight 1–3 key terms per paragraph (NOT entire sentences). ' +
+        'Use *italics* for definitions, counter-points, or light emphasis (1 per paragraph max). ' +
+        'NO bullet points, NO markdown headers, NO numbered lists. ' +
+        'Each paragraph covers ONE focused idea: e.g. context → main argument → implication. ' +
+        'Do NOT start consecutive paragraphs with the same word. Do NOT cut text short mid-sentence.')
+        .min(300)
+        .max(800),
+    version: zod_1.z.literal(1),
+});
+exports.ContentsSlideDataSchema = zod_1.z.object({
+    contentType: zod_1.z.literal(constants_1.SLIDE_CONTENT_TYPE.CONTENTS),
+    title: zod_1.z
+        .string()
+        .describe('This slide represents table of contents for the presentation and must be named "Contents" in the presentation language')
+        .min(10)
+        .max(200),
+    items: zod_1.z
+        .array(zod_1.z.object({
+        pageNumber: zod_1.z.number().describe('Page number of the slide'),
+        title: zod_1.z.string().min(1).describe('Title of the slide on said page'),
+    }))
+        .min(1)
+        .describe('List of slide titles. Must be relevant and generated after all the slides are generated'),
+    version: zod_1.z.literal(1),
+});
+exports.ImageSlideDataSchema = zod_1.z
+    .object({
+    contentType: zod_1.z.literal(constants_1.SLIDE_CONTENT_TYPE.TEXT_WITH_IMAGE),
+    title: zod_1.z
+        .string()
+        .describe('Slide headline rendered in very large bold font on the LEFT column. Keep to 3–7 words (max 70 characters). Aim for under 50 characters to avoid overflow. A noun phrase or short declarative phrase — NOT a full sentence.')
+        .min(10)
+        .max(70),
+    description: zod_1.z
+        .string()
+        .describe('Expository prose in 2 paragraphs separated by \\n\\n (double newline). Total length 150–500 characters. ' +
+        'Use **bold** for 1–2 key terms per paragraph (NOT entire sentences). ' +
+        'Use *italics* for definitions or emphasis at most once per paragraph. ' +
+        'NO bullet points, NO headers, NO numbered lists. ' +
+        'Each paragraph covers ONE focused idea. NEVER reference or describe the image in the text. ' +
+        'The image provides visual atmosphere — the text must stand alone as complete, readable prose.')
+        .min(150)
+        .max(500),
+    imageSlot: exports.ImageSlotSchema,
+    version: zod_1.z.literal(1),
+})
+    .describe('Slide with a large title and prose description on the left, and a full-bleed supporting image on the right.');
+exports.SectionBreakSlideDataSchema = zod_1.z.object({
+    contentType: zod_1.z.literal(constants_1.SLIDE_CONTENT_TYPE.SECTION_BREAK),
+    title: zod_1.z
+        .string()
+        .describe('The section name — a clean noun phrase of 3–6 words that names the thematic block which follows. ' +
+        'NEVER prefix with "Раздел:", "Section:", "Part:", "Глава:", or any structural label. ' +
+        'NEVER include numbers. Just the name itself. ' +
+        'GOOD: "Технологические достижения". BAD: "Раздел 2: Технологические достижения".')
+        .min(5)
+        .max(60),
+    description: zod_1.z
+        .string()
+        .describe('One sentence (up to 100 characters) that briefly hints at the content of the upcoming section. ' +
+        'Should complement the title without repeating it. No markdown, no labels.')
+        .min(10)
+        .max(120),
+    version: zod_1.z.literal(1),
+});
+exports.TableSlideDataSchema = zod_1.z.object({
+    contentType: zod_1.z.literal(constants_1.SLIDE_CONTENT_TYPE.TABLE),
+    title: zod_1.z
+        .string()
+        .describe('Table name — 2–4 words rendered as large bold heading above the table. ' +
+        'Doubles as both the slide title and the table heading. Keep concise.')
+        .min(5)
+        .max(55),
+    description: zod_1.z
+        .string()
+        .describe('One short sentence (max 80 characters) describing what the table shows. ' +
+        'Rendered in small gray text below the title. No markdown.')
+        .min(10)
+        .max(100),
+    table: zod_1.z.object({
+        columnHeaders: zod_1.z
+            .array(zod_1.z
+            .string()
+            .min(1)
+            .max(20)
+            .describe('Column label. Keep SHORT — 1–3 words. Include units here (e.g., "Сумма, ₽"), not in cells. ' +
+            'When hasRowHeaders is true, the first header should be a single space " " or a short category label.'))
+            .min(2)
+            .max(5)
+            .describe('Column header labels. MAXIMUM 5 columns total. Recommended 3–4 data columns. ' +
+            'More columns will overflow the slide — NEVER exceed 5.'),
+        rows: zod_1.z
+            .array(zod_1.z
+            .array(zod_1.z
+            .string()
+            .min(1)
+            .max(40)
+            .describe('Cell content. NUMERIC tables: numbers only (e.g., "1 200", "85%"). ' +
+            'TEXTUAL tables: 1–3 words maximum — keywords or short phrases ONLY, NEVER full sentences. ' +
+            'Row header cells (first cell when hasRowHeaders=true): category label, max 22 characters.'))
+            .describe('One row. Cell count MUST equal columnHeaders length exactly.'))
+            .min(2)
+            .max(4)
+            .describe('Table rows. Max 4 rows total. ' +
+            'When hasSummaryRow is true, the LAST row is the summary row — so at most 3 regular rows + 1 summary = 4 total. ' +
+            'NEVER exceed 4 rows.'),
+        hasRowHeaders: zod_1.z
+            .boolean()
+            .describe('True when the first cell of each row is a descriptive label or category (pivot table). ' +
+            'False for plain data tables where all cells are equivalent data.'),
+        hasSummaryRow: zod_1.z
+            .boolean()
+            .describe('True when the last row contains totals, averages, or aggregated values. ' +
+            'That summary row must be the last element of the rows array.'),
+    }),
+    version: zod_1.z.literal(1),
+});
+// Charts
+exports.BarChartSlideDataSchema = zod_1.z.object({
+    type: zod_1.z.literal(SLIDE_CHART_TYPE.BAR),
+    categories: zod_1.z
+        .array(zod_1.z.string().min(1).max(20))
+        .min(3)
+        .max(10)
+        .describe('Category labels (e.g., months, product names, departments). ' +
+        'Recommended: 4–8 items. Keep each label SHORT — 1–3 words, max 15 characters. ' +
+        'Categories work best when naturally ordered: time periods, rankings, or comparable groups.'),
+    series: zod_1.z
+        .array(zod_1.z.object({
+        name: zod_1.z
+            .string()
+            .max(40)
+            .describe('Series name shown in the chart legend. Do NOT include units here — units belong in the unit field. ' +
+            'GOOD: "Рост продаж". BAD: "Рост продаж (%)" or "Выручка (₽)".'),
+        data: zod_1.z
+            .array(zod_1.z.number())
+            .min(3)
+            .describe('Numeric values corresponding to categories. ' +
+            'MUST have EXACTLY the same number of values as categories — mismatch will break the chart. ' +
+            'Use round numbers or simple approximations. NEVER hallucinate precise figures. ' +
+            'Values should show meaningful variation — avoid all bars being the same height.'),
+        type: zod_1.z
+            .number()
+            .min(0)
+            .max(11)
+            .describe('Color index from the theme palette. ALWAYS use 0 (primary blue). Never change this value.'),
+    }))
+        .min(1)
+        .max(1)
+        .describe('Data series. Only ONE series is supported. Never add more than one.'),
+    yAxisLabel: zod_1.z
+        .string()
+        .max(30)
+        .optional()
+        .describe('Y-axis label. Include ONLY when the axis needs a descriptor that is not already covered by the unit field. ' +
+        'GOOD use: "Количество студентов" (when there is no unit symbol). ' +
+        'OMIT when unit is set (e.g., "%", "₽") — the unit already contextualises the values.'),
+    unit: zod_1.z
+        .string()
+        .max(10)
+        .optional()
+        .describe('Unit symbol displayed with each bar value (e.g., "%", "₽", "шт.", "млн"). ' +
+        'ALWAYS include when values represent percentages, currency, or any measurable quantity with a unit. ' +
+        'Omit only for dimensionless counts that are self-explanatory (e.g., raw ranking scores without a fixed scale).'),
+    version: zod_1.z.literal(1),
+});
+exports.ChartSlideDataSchema = zod_1.z.object({
+    contentType: zod_1.z.literal(constants_1.SLIDE_CONTENT_TYPE.CHART),
+    title: zod_1.z
+        .string()
+        .describe('Chart name — 2–4 words rendered as large bold heading on the LEFT panel of the slide. ' +
+        'Keep short: the left panel is narrow and the title font is very large.')
+        .min(5)
+        .max(50),
+    description: zod_1.z
+        .string()
+        .describe('1–2 sentences (max 120 characters) explaining what the chart shows. ' +
+        'Rendered in small gray text below the title on the LEFT panel. No markdown.')
+        .min(10)
+        .max(150),
+    chart: zod_1.z.discriminatedUnion('type', [exports.BarChartSlideDataSchema]),
+    version: zod_1.z.literal(1),
+});
+exports.TimelineSlideDataSchema = zod_1.z.object({
+    contentType: zod_1.z.literal(constants_1.SLIDE_CONTENT_TYPE.TIMELINE),
+    title: zod_1.z
+        .string()
+        .describe('Timeline name — 2–5 words, rendered as large bold heading above the timeline. ' +
+        'Names the subject or scope of the chronological sequence.')
+        .min(5)
+        .max(65),
+    description: zod_1.z
+        .string()
+        .describe('One sentence (max 100 characters) providing context for the timeline. ' +
+        'Rendered in small gray text below the title. No markdown.')
+        .min(10)
+        .max(120),
+    timeline: zod_1.z.object({
+        events: zod_1.z
+            .array(zod_1.z.object({
+            date: zod_1.z
+                .string()
+                .describe('Temporal label displayed inside the arrow/chevron shape at the top of each column. ' +
+                'MUST be SHORT — max 20 characters — to fit inside the arrow. ' +
+                'Use a year ("2015"), a range ("2010–2015"), a quarter ("Q1 2023"), ' +
+                'an approximate period ("Early 2020s", "Середина 2010-х"), ' +
+                'or a phase label ("Этап 1", "Запуск") for process timelines. ' +
+                'NEVER fabricate specific dates you are not certain about.')
+                .min(2)
+                .max(25),
+            title: zod_1.z
+                .string()
+                .describe('Event name in bold below the arrow. 2–3 words maximum. ' +
+                'Short and punchy — the column is narrow, long titles wrap to many lines. ' +
+                'GOOD: "Первый запуск", "Выход на рынок". BAD: "Успешный выход компании на международный рынок".')
+                .min(3)
+                .max(35),
+            description: zod_1.z
+                .string()
+                .describe('Brief description below the event title. 1–2 sentences, max 100 characters. ' +
+                'The column is narrow — text wraps to ~5 lines at this limit. ' +
+                'Do NOT exceed 100 characters or the description will overflow off the slide.')
+                .min(20)
+                .max(110),
+        }))
+            .length(5)
+            .describe('Exactly 5 chronological events in sequential order (oldest → newest). ' +
+            'The template renders exactly 5 equal columns — NEVER generate fewer or more.'),
+    }),
+    version: zod_1.z.literal(1),
+});
+exports.SlideContentSchema = zod_1.z.discriminatedUnion('contentType', [
+    exports.CoverSlideDataSchema,
+    exports.StructuredListSlideDataSchema,
+    exports.TextSlideDataSchema,
+    exports.ContentsSlideDataSchema,
+    exports.SectionBreakSlideDataSchema,
+    exports.ImageSlideDataSchema,
+    exports.ThankYouSlideDataSchema,
+    exports.TableSlideDataSchema,
+    exports.ChartSlideDataSchema,
+    exports.TimelineSlideDataSchema,
+]);

package/build/models/presentation/slide-icon-slot.schema.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SlideIconSlotSchema = void 0;
+const zod_1 = require("zod");
+const constants_1 = require("../../constants");
+exports.SlideIconSlotSchema = zod_1.z.object({
+    uuid: zod_1.z.string().uuid(),
+    prompt: zod_1.z.string(),
+    alt: zod_1.z.string(),
+    url: zod_1.z.string().nullable(),
+    slideId: zod_1.z.string(),
+    status: zod_1.z.nativeEnum(constants_1.SLIDE_ICON_SLOT_STATUS),
+    createdAt: zod_1.z.date(),
+    updatedAt: zod_1.z.date(),
+});

package/build/models/presentation/slide-image-slot.schema.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SlideImageSlotSchema = void 0;
+const zod_1 = require("zod");
+const constants_1 = require("../../constants");
+exports.SlideImageSlotSchema = zod_1.z.object({
+    uuid: zod_1.z.string().uuid(),
+    prompt: zod_1.z.string(),
+    alt: zod_1.z.string(),
+    url: zod_1.z.string().nullable(),
+    placeholder: zod_1.z.string(),
+    slideId: zod_1.z.string(),
+    status: zod_1.z.nativeEnum(constants_1.SLIDE_IMAGE_SLOT_STATUS),
+    createdAt: zod_1.z.date(),
+    updatedAt: zod_1.z.date(),
+});

package/build/models/presentation/slide-outline.schema.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SlideOutlineBulkUpdateSchema = exports.SlideOutlineUpdateSchema = exports.SlideOutlineSchema = void 0;
+const zod_1 = require("zod");
+const constants_1 = require("../../constants");
+exports.SlideOutlineSchema = zod_1.z.object({
+    uuid: zod_1.z.string(),
+    order: zod_1.z.number(),
+    title: zod_1.z.string().max(80),
+    body: zod_1.z.string().max(500),
+    contentTypeId: zod_1.z.nativeEnum(constants_1.SLIDE_CONTENT_TYPE),
+    presentationId: zod_1.z.string(),
+    createdAt: zod_1.z.date(),
+    updatedAt: zod_1.z.date(),
+});
+exports.SlideOutlineUpdateSchema = exports.SlideOutlineSchema.pick({
+    title: true,
+    body: true,
+    contentTypeId: true,
+}).partial();
+exports.SlideOutlineBulkUpdateSchema = exports.SlideOutlineSchema.pick({
+    order: true,
+    title: true,
+    body: true,
+    contentTypeId: true,
+    presentationId: true,
+})
+    .extend({
+    uuid: zod_1.z.string().uuid().optional(),
+})
+    .array()
+    .min(1, 'Must include at least one slide outline')
+    .refine((arr) => {
+    const orders = arr.map((s) => s.order);
+    const unique = new Set(orders);
+    if (unique.size !== orders.length)
+        return false;
+    const sorted = [...orders].sort((a, b) => a - b);
+    return sorted.every((val, idx) => val === idx);
+}, {
+    message: 'Slide orders must be unique and sequential starting at 0',
+    path: ['order'],
+})
+    .refine((arr) => {
+    const [firstId, ...rest] = arr.map((s) => s.presentationId);
+    return rest.every((id) => id === firstId);
+}, {
+    message: 'All slide outlines must belong to the same presentation',
+    path: ['presentationId'],
+});

package/build/models/presentation/slide.schema.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SlideBulkUpdateSchema = exports.SlideUpdateSchema = exports.SlideSchema = void 0;
+const zod_1 = require("zod");
+const slide_content_schema_1 = require("./slide-content.schema");
+const constants_1 = require("../../constants");
+const slide_icon_slot_schema_1 = require("./slide-icon-slot.schema");
+const slide_image_slot_schema_1 = require("./slide-image-slot.schema");
+const slide_content_edit_schema_1 = require("./slide-content-edit.schema");
+exports.SlideSchema = zod_1.z.object({
+    uuid: zod_1.z.string().uuid(),
+    order: zod_1.z.number(),
+    contentTypeId: zod_1.z.nativeEnum(constants_1.SLIDE_CONTENT_TYPE),
+    layoutId: zod_1.z.nativeEnum(constants_1.SLIDE_LAYOUT),
+    content: slide_content_schema_1.SlideContentSchema,
+    presentationId: zod_1.z.string(),
+    iconSlots: zod_1.z.array(slide_icon_slot_schema_1.SlideIconSlotSchema),
+    imageSlots: zod_1.z.array(slide_image_slot_schema_1.SlideImageSlotSchema),
+    createdAt: zod_1.z.date(),
+    updatedAt: zod_1.z.date(),
+});
+exports.SlideUpdateSchema = exports.SlideSchema.pick({
+    layoutId: true,
+})
+    .extend({
+    content: slide_content_edit_schema_1.SlideContentUserEditSchema,
+})
+    .partial();
+exports.SlideBulkUpdateSchema = exports.SlideSchema.pick({
+    order: true,
+    contentTypeId: true,
+    layoutId: true,
+    presentationId: true,
+})
+    .extend({
+    uuid: zod_1.z.string().uuid().optional(),
+    content: slide_content_edit_schema_1.SlideContentUserEditSchema,
+})
+    .array()
+    .min(1, 'Must include at least one slide')
+    .refine((arr) => {
+    const orders = arr.map((s) => s.order);
+    const unique = new Set(orders);
+    if (unique.size !== orders.length)
+        return false;
+    const sorted = [...orders].sort((a, b) => a - b);
+    return sorted.every((val, idx) => val === idx);
+}, {
+    message: 'Slide orders must be unique and sequential starting at 0',
+    path: ['order'],
+})
+    .refine((arr) => {
+    const [firstId, ...rest] = arr.map((s) => s.presentationId);
+    return rest.every((id) => id === firstId);
+}, {
+    message: 'All slides must belong to the same presentation',
+    path: ['presentationId'],
+});

package/commands/index.ts

@@ -14,3 +14,4 @@ export * from './account-merge';
 export * from './files';
 export * from './user-balance';
 export * from './solving-edu-task';
+export * from './presentation';

package/commands/presentation/build-blank-slide.command.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+import { SLIDE_CONTENT_TYPE } from '../../constants';
+import { SlideSchema } from '../../models';
+
+export namespace BuildBlankSlideCommand {
+    export const RequestSchema = z.object({
+        slideContentType: z.nativeEnum(SLIDE_CONTENT_TYPE),
+        layoutId: z.string(),
+    });
+
+    export type Request = z.infer<typeof RequestSchema>;
+
+    export const ResponseSchema = z.object({
+        data: SlideSchema,
+    });
+
+    export type Response = z.infer<typeof ResponseSchema>;
+}

package/commands/presentation/create-presentation.command.ts

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+import { PresentationSchema } from '../../models/presentation';
+
+export namespace CreatePresentationCommand {
+    export const RequestSchema = z.object({
+        prompt: z.string().min(1).max(10000),
+        slideCount: z.number().min(1).max(20),
+        templateId: z.string().uuid(),
+        languageId: z.string().uuid(),
+    });
+
+    export type Request = z.infer<typeof RequestSchema>;
+
+    export const ResponseSchema = z.object({
+        data: PresentationSchema,
+    });
+
+    export type Response = z.infer<typeof ResponseSchema>;
+}

package/commands/presentation/delete-all-user-presentations.command.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+
+export namespace DeleteAllUserPresentationsCommand {
+    export const RequestSchema = z.void();
+    export type Request = z.infer<typeof RequestSchema>;
+
+    export const ResponseSchema = z.void();
+    export type Response = z.infer<typeof ResponseSchema>;
+}

package/commands/presentation/delete-presentation.command.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+
+export namespace DeletePresentationCommand {
+    export const RequestParamsSchema = z.object({
+        uuid: z.string().uuid(),
+    });
+
+    export type Request = z.infer<typeof RequestParamsSchema>;
+
+    export const ResponseSchema = z.void();
+
+    export type Response = z.infer<typeof ResponseSchema>;
+}

package/commands/presentation/delete-slide-outline.command.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+
+export namespace DeleteSlideOutlineCommand {
+    export const RequestParamsSchema = z.object({
+        presentationId: z.string().uuid(),
+        slideOutlineId: z.string().uuid(),
+    });
+
+    export const ResponseSchema = z.void();
+
+    export type Response = z.infer<typeof ResponseSchema>;
+}

package/commands/presentation/export-presentation-as-pptx.command.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import { PPTXExportPayloadSchema } from '../../models/presentation';
+
+export namespace ExportPresentationAsPptxCommand {
+    export const RequestSchema = PPTXExportPayloadSchema;
+    export type Request = z.infer<typeof RequestSchema>;
+
+    export const RequestParamsSchema = z.object({
+        uuid: z.string().uuid(),
+    });
+    export type RequestParams = z.infer<typeof RequestParamsSchema>;
+
+    export const ResponseSchema = z.object({
+        data: z.object({
+            url: z.string(),
+        }),
+    });
+
+    export type Response = z.infer<typeof ResponseSchema>;
+}

package/commands/presentation/find-presentation-by-uuid.command.ts

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+import { PresentationWithSlidesSchema } from '../../models/presentation';
+
+export namespace FindPresentationByUuidCommand {
+    export const RequestParamsSchema = z.object({
+        uuid: z.string().uuid(),
+    });
+
+    export type RequestParams = z.infer<typeof RequestParamsSchema>;
+
+    export const ResponseSchema = z.object({
+        data: PresentationWithSlidesSchema,
+    });
+
+    export type Response = z.infer<typeof ResponseSchema>;
+}

package/commands/presentation/find-presentation-outline.command.ts

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+import { SlideOutlineSchema } from '../../models/presentation';
+
+export namespace FindPresentationOutlineCommand {
+    export const RequestParamsSchema = z.object({
+        uuid: z.string().uuid(),
+    });
+
+    export type RequestParams = z.infer<typeof RequestParamsSchema>;
+
+    export const ResponseSchema = z.object({
+        data: z.array(SlideOutlineSchema),
+    });
+
+    export type Response = z.infer<typeof ResponseSchema>;
+}

package/commands/presentation/find-presentations.command.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+import { PresentationSchema } from '../../models/presentation';
+
+export namespace FindPresentationsCommand {
+    export const RequestQuerySchema = z.object({
+        limit: z.coerce.number().min(1).optional(),
+        offset: z.coerce.number().min(0).default(0).optional(),
+        title: z.string().optional(),
+    });
+    export type RequestQuery = z.infer<typeof RequestQuerySchema>;
+
+    export const ResponseSchema = z.object({
+        data: z.array(PresentationSchema),
+        totalPages: z.number(),
+        page: z.number(),
+    });
+    export type Response = z.infer<typeof ResponseSchema>;
+}