@btst/stack 5.0.0 → 5.2.0

package/dist/shared/stack.E9hDcTh0.d.cts

@@ -0,0 +1,234 @@
+import { z } from 'zod';
+import { ContentTypeConfig } from '@btst/stack/plugins/cms/api';
+
+/** Course content stored by the CMS plugin. Prices are integer minor currency units. */
+declare const courseSchema: z.ZodObject<{
+    title: z.ZodString;
+    slug: z.ZodString;
+    description: z.ZodDefault<z.ZodString>;
+    coverImage: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"">]>>;
+    instructorId: z.ZodString;
+    instructorName: z.ZodDefault<z.ZodString>;
+    instructorBio: z.ZodDefault<z.ZodString>;
+    category: z.ZodDefault<z.ZodString>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    difficulty: z.ZodDefault<z.ZodEnum<{
+        beginner: "beginner";
+        intermediate: "intermediate";
+        advanced: "advanced";
+    }>>;
+    durationMins: z.ZodDefault<z.ZodNumber>;
+    price: z.ZodDefault<z.ZodNumber>;
+    currency: z.ZodDefault<z.ZodString>;
+    status: z.ZodDefault<z.ZodEnum<{
+        archived: "archived";
+        draft: "draft";
+        published: "published";
+    }>>;
+    featured: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/** Register alongside the School backend in cmsBackendPlugin({ contentTypes }). */
+declare const SCHOOL_COURSE_CONTENT_TYPE: ContentTypeConfig;
+/** Public course list filtering. Draft/publication controls are deliberately absent. */
+declare const courseFiltersSchema: z.ZodObject<{
+    category: z.ZodOptional<z.ZodString>;
+    difficulty: z.ZodOptional<z.ZodEnum<{
+        beginner: "beginner";
+        intermediate: "intermediate";
+        advanced: "advanced";
+    }>>;
+    maxDurationMins: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    pricing: z.ZodOptional<z.ZodEnum<{
+        paid: "paid";
+        free: "free";
+    }>>;
+    featured: z.ZodOptional<z.ZodUnion<[z.ZodPipe<z.ZodEnum<{
+        true: "true";
+        false: "false";
+    }>, z.ZodTransform<boolean, "true" | "false">>, z.ZodBoolean]>>;
+    query: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Multiple choice quiz definition. Correct answer indexes are only returned to instructors. */
+declare const quizSchema: z.ZodObject<{
+    questions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        question: z.ZodString;
+        options: z.ZodArray<z.ZodString>;
+        correctAnswer: z.ZodNumber;
+    }, z.core.$strip>>;
+    passMark: z.ZodOptional<z.ZodNumber>;
+    maxAttempts: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/** Lesson content, resource links, and optional server-scored quiz. */
+declare const lessonSchema: z.ZodObject<{
+    title: z.ZodString;
+    sectionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    type: z.ZodEnum<{
+        video: "video";
+        text: "text";
+        quiz: "quiz";
+    }>;
+    content: z.ZodDefault<z.ZodString>;
+    videoUrl: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"">]>>;
+    durationMins: z.ZodDefault<z.ZodNumber>;
+    order: z.ZodDefault<z.ZodNumber>;
+    isFreePreview: z.ZodDefault<z.ZodBoolean>;
+    resources: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        url: z.ZodString;
+    }, z.core.$strip>>>;
+    quiz: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        questions: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            question: z.ZodString;
+            options: z.ZodArray<z.ZodString>;
+            correctAnswer: z.ZodNumber;
+        }, z.core.$strip>>;
+        passMark: z.ZodOptional<z.ZodNumber>;
+        maxAttempts: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+
+/** CMS-backed course with serialized timestamps and curriculum count. */
+type Course = z.output<typeof courseSchema> & {
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    lessonCount: number;
+};
+type CourseFilters = z.input<typeof courseFiltersSchema>;
+type Quiz = z.output<typeof quizSchema>;
+/** Student-safe quiz question; answer keys are removed from lesson responses. */
+type PublicQuiz = Omit<Quiz, "questions"> & {
+    questions: Omit<Quiz["questions"][number], "correctAnswer">[];
+};
+type Section = {
+    id: string;
+    courseId: string;
+    title: string;
+    order: number;
+};
+type Lesson = Omit<z.output<typeof lessonSchema>, "quiz"> & {
+    id: string;
+    courseId: string;
+    quiz?: Quiz | PublicQuiz | null;
+};
+type LessonSummary = Pick<Lesson, "id" | "courseId" | "title" | "sectionId" | "type" | "durationMins" | "order" | "isFreePreview">;
+type Enrollment = {
+    id: string;
+    courseId: string;
+    userId: string;
+    status: "enrolled" | "completed" | "cancelled";
+    progressPct: number;
+    lastLessonId?: string | null;
+    certificateId?: string | null;
+    paymentRef?: string | null;
+    enrolledAt: string;
+    completedAt?: string | null;
+};
+type LessonProgress = {
+    id: string;
+    enrollmentId: string;
+    lessonId: string;
+    completed: boolean;
+    completedAt?: string | null;
+    positionSecs: number;
+};
+type QuizAttempt = {
+    id: string;
+    lessonId: string;
+    userId: string;
+    answers: {
+        questionId: string;
+        answer: number;
+    }[];
+    score: number;
+    passed: boolean;
+    attemptedAt: string;
+};
+type Review = {
+    id: string;
+    courseId: string;
+    userId: string;
+    rating: number;
+    body: string;
+    createdAt: string;
+};
+type CourseDetail = Course & {
+    sections: Section[];
+    lessons: LessonSummary[];
+    reviews: Review[];
+    enrollment: null;
+};
+/** Enrollment, payment, assessment, and completion lifecycle callbacks. */
+interface SchoolPluginHooks {
+    /** Runs before enrollment. Returning false rejects the request. */
+    onBeforeEnroll?: (userId: string, course: Course) => Promise<boolean> | boolean;
+    /** Runs after the enrollment has been persisted. */
+    onAfterEnroll?: (enrollment: Enrollment, course: Course) => Promise<void> | void;
+    /** Generate a certificate after completion; the returned unique ID is stored on the enrollment. */
+    onCourseComplete?: (enrollment: Enrollment, course: Course) => Promise<{
+        certificateId: string;
+    }> | {
+        certificateId: string;
+    };
+    /** Runs after a scored quiz attempt is persisted. */
+    onQuizSubmit?: (attempt: QuizAttempt, lesson: Lesson) => Promise<void> | void;
+}
+/** School backend configuration. */
+interface SchoolBackendOptions {
+    /** Enrollment and completion lifecycle callbacks. */
+    hooks?: SchoolPluginHooks;
+    /** Default quiz pass percentage, used when a quiz has no override. @default 70 */
+    quizPassMark?: number;
+    /** Enable certificate generation and public verification. @default true */
+    certificatesEnabled?: boolean;
+    /** Verify or collect payment on the server. Required for paid courses; falsy results reject enrollment. */
+    paymentAdapter?: {
+        createPayment: (input: {
+            userId: string;
+            course: Course;
+            idempotencyKey: string;
+        }) => Promise<{
+            paymentRef: string;
+        } | null>;
+    };
+}
+/** Validated authoring input shapes used by instructor forms. */
+type CourseInput = z.input<typeof courseSchema>;
+type LessonInput = z.input<typeof lessonSchema>;
+type CatalogFilters = CourseFilters;
+type StudentCoursesResult = {
+    items: (Enrollment & {
+        course: Course;
+        lessons: LessonSummary[];
+        /** A configured certificate provider has not yet issued this completed course's certificate. */
+        certificatePending: boolean;
+    })[];
+};
+type LessonResult = {
+    lesson: Lesson;
+    enrollment: Enrollment | null;
+    progress: LessonProgress | null;
+    attempts: QuizAttempt[];
+};
+type CourseStudentsResult = {
+    items: Enrollment[];
+    analytics: {
+        totalEnrolled: number;
+        totalCompleted: number;
+        completionRate: number;
+        enrollmentsOverTime: {
+            date: string;
+            count: number;
+        }[];
+    };
+};
+type CertificateResult = {
+    certificateId: string;
+    courseTitle: string;
+    completedAt?: string | null;
+};
+
+export { courseSchema as c, lessonSchema as l, SCHOOL_COURSE_CONTENT_TYPE as p, quizSchema as r };
+export type { CourseDetail as C, Enrollment as E, Lesson as L, PublicQuiz as P, QuizAttempt as Q, Review as R, StudentCoursesResult as S, Course as a, LessonSummary as b, Section as d, SchoolBackendOptions as e, CourseFilters as f, Quiz as g, LessonProgress as h, CatalogFilters as i, CertificateResult as j, CourseInput as k, CourseStudentsResult as m, LessonInput as n, LessonResult as o, SchoolPluginHooks as q };

package/dist/shared/stack.E9hDcTh0.d.mts

@@ -0,0 +1,234 @@
+import { z } from 'zod';
+import { ContentTypeConfig } from '@btst/stack/plugins/cms/api';
+
+/** Course content stored by the CMS plugin. Prices are integer minor currency units. */
+declare const courseSchema: z.ZodObject<{
+    title: z.ZodString;
+    slug: z.ZodString;
+    description: z.ZodDefault<z.ZodString>;
+    coverImage: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"">]>>;
+    instructorId: z.ZodString;
+    instructorName: z.ZodDefault<z.ZodString>;
+    instructorBio: z.ZodDefault<z.ZodString>;
+    category: z.ZodDefault<z.ZodString>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    difficulty: z.ZodDefault<z.ZodEnum<{
+        beginner: "beginner";
+        intermediate: "intermediate";
+        advanced: "advanced";
+    }>>;
+    durationMins: z.ZodDefault<z.ZodNumber>;
+    price: z.ZodDefault<z.ZodNumber>;
+    currency: z.ZodDefault<z.ZodString>;
+    status: z.ZodDefault<z.ZodEnum<{
+        archived: "archived";
+        draft: "draft";
+        published: "published";
+    }>>;
+    featured: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/** Register alongside the School backend in cmsBackendPlugin({ contentTypes }). */
+declare const SCHOOL_COURSE_CONTENT_TYPE: ContentTypeConfig;
+/** Public course list filtering. Draft/publication controls are deliberately absent. */
+declare const courseFiltersSchema: z.ZodObject<{
+    category: z.ZodOptional<z.ZodString>;
+    difficulty: z.ZodOptional<z.ZodEnum<{
+        beginner: "beginner";
+        intermediate: "intermediate";
+        advanced: "advanced";
+    }>>;
+    maxDurationMins: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    pricing: z.ZodOptional<z.ZodEnum<{
+        paid: "paid";
+        free: "free";
+    }>>;
+    featured: z.ZodOptional<z.ZodUnion<[z.ZodPipe<z.ZodEnum<{
+        true: "true";
+        false: "false";
+    }>, z.ZodTransform<boolean, "true" | "false">>, z.ZodBoolean]>>;
+    query: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Multiple choice quiz definition. Correct answer indexes are only returned to instructors. */
+declare const quizSchema: z.ZodObject<{
+    questions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        question: z.ZodString;
+        options: z.ZodArray<z.ZodString>;
+        correctAnswer: z.ZodNumber;
+    }, z.core.$strip>>;
+    passMark: z.ZodOptional<z.ZodNumber>;
+    maxAttempts: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/** Lesson content, resource links, and optional server-scored quiz. */
+declare const lessonSchema: z.ZodObject<{
+    title: z.ZodString;
+    sectionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    type: z.ZodEnum<{
+        video: "video";
+        text: "text";
+        quiz: "quiz";
+    }>;
+    content: z.ZodDefault<z.ZodString>;
+    videoUrl: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"">]>>;
+    durationMins: z.ZodDefault<z.ZodNumber>;
+    order: z.ZodDefault<z.ZodNumber>;
+    isFreePreview: z.ZodDefault<z.ZodBoolean>;
+    resources: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        url: z.ZodString;
+    }, z.core.$strip>>>;
+    quiz: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        questions: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            question: z.ZodString;
+            options: z.ZodArray<z.ZodString>;
+            correctAnswer: z.ZodNumber;
+        }, z.core.$strip>>;
+        passMark: z.ZodOptional<z.ZodNumber>;
+        maxAttempts: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+
+/** CMS-backed course with serialized timestamps and curriculum count. */
+type Course = z.output<typeof courseSchema> & {
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    lessonCount: number;
+};
+type CourseFilters = z.input<typeof courseFiltersSchema>;
+type Quiz = z.output<typeof quizSchema>;
+/** Student-safe quiz question; answer keys are removed from lesson responses. */
+type PublicQuiz = Omit<Quiz, "questions"> & {
+    questions: Omit<Quiz["questions"][number], "correctAnswer">[];
+};
+type Section = {
+    id: string;
+    courseId: string;
+    title: string;
+    order: number;
+};
+type Lesson = Omit<z.output<typeof lessonSchema>, "quiz"> & {
+    id: string;
+    courseId: string;
+    quiz?: Quiz | PublicQuiz | null;
+};
+type LessonSummary = Pick<Lesson, "id" | "courseId" | "title" | "sectionId" | "type" | "durationMins" | "order" | "isFreePreview">;
+type Enrollment = {
+    id: string;
+    courseId: string;
+    userId: string;
+    status: "enrolled" | "completed" | "cancelled";
+    progressPct: number;
+    lastLessonId?: string | null;
+    certificateId?: string | null;
+    paymentRef?: string | null;
+    enrolledAt: string;
+    completedAt?: string | null;
+};
+type LessonProgress = {
+    id: string;
+    enrollmentId: string;
+    lessonId: string;
+    completed: boolean;
+    completedAt?: string | null;
+    positionSecs: number;
+};
+type QuizAttempt = {
+    id: string;
+    lessonId: string;
+    userId: string;
+    answers: {
+        questionId: string;
+        answer: number;
+    }[];
+    score: number;
+    passed: boolean;
+    attemptedAt: string;
+};
+type Review = {
+    id: string;
+    courseId: string;
+    userId: string;
+    rating: number;
+    body: string;
+    createdAt: string;
+};
+type CourseDetail = Course & {
+    sections: Section[];
+    lessons: LessonSummary[];
+    reviews: Review[];
+    enrollment: null;
+};
+/** Enrollment, payment, assessment, and completion lifecycle callbacks. */
+interface SchoolPluginHooks {
+    /** Runs before enrollment. Returning false rejects the request. */
+    onBeforeEnroll?: (userId: string, course: Course) => Promise<boolean> | boolean;
+    /** Runs after the enrollment has been persisted. */
+    onAfterEnroll?: (enrollment: Enrollment, course: Course) => Promise<void> | void;
+    /** Generate a certificate after completion; the returned unique ID is stored on the enrollment. */
+    onCourseComplete?: (enrollment: Enrollment, course: Course) => Promise<{
+        certificateId: string;
+    }> | {
+        certificateId: string;
+    };
+    /** Runs after a scored quiz attempt is persisted. */
+    onQuizSubmit?: (attempt: QuizAttempt, lesson: Lesson) => Promise<void> | void;
+}
+/** School backend configuration. */
+interface SchoolBackendOptions {
+    /** Enrollment and completion lifecycle callbacks. */
+    hooks?: SchoolPluginHooks;
+    /** Default quiz pass percentage, used when a quiz has no override. @default 70 */
+    quizPassMark?: number;
+    /** Enable certificate generation and public verification. @default true */
+    certificatesEnabled?: boolean;
+    /** Verify or collect payment on the server. Required for paid courses; falsy results reject enrollment. */
+    paymentAdapter?: {
+        createPayment: (input: {
+            userId: string;
+            course: Course;
+            idempotencyKey: string;
+        }) => Promise<{
+            paymentRef: string;
+        } | null>;
+    };
+}
+/** Validated authoring input shapes used by instructor forms. */
+type CourseInput = z.input<typeof courseSchema>;
+type LessonInput = z.input<typeof lessonSchema>;
+type CatalogFilters = CourseFilters;
+type StudentCoursesResult = {
+    items: (Enrollment & {
+        course: Course;
+        lessons: LessonSummary[];
+        /** A configured certificate provider has not yet issued this completed course's certificate. */
+        certificatePending: boolean;
+    })[];
+};
+type LessonResult = {
+    lesson: Lesson;
+    enrollment: Enrollment | null;
+    progress: LessonProgress | null;
+    attempts: QuizAttempt[];
+};
+type CourseStudentsResult = {
+    items: Enrollment[];
+    analytics: {
+        totalEnrolled: number;
+        totalCompleted: number;
+        completionRate: number;
+        enrollmentsOverTime: {
+            date: string;
+            count: number;
+        }[];
+    };
+};
+type CertificateResult = {
+    certificateId: string;
+    courseTitle: string;
+    completedAt?: string | null;
+};
+
+export { courseSchema as c, lessonSchema as l, SCHOOL_COURSE_CONTENT_TYPE as p, quizSchema as r };
+export type { CourseDetail as C, Enrollment as E, Lesson as L, PublicQuiz as P, QuizAttempt as Q, Review as R, StudentCoursesResult as S, Course as a, LessonSummary as b, Section as d, SchoolBackendOptions as e, CourseFilters as f, Quiz as g, LessonProgress as h, CatalogFilters as i, CertificateResult as j, CourseInput as k, CourseStudentsResult as m, LessonInput as n, LessonResult as o, SchoolPluginHooks as q };

package/dist/shared/stack.E9hDcTh0.d.ts

@@ -0,0 +1,234 @@
+import { z } from 'zod';
+import { ContentTypeConfig } from '@btst/stack/plugins/cms/api';
+
+/** Course content stored by the CMS plugin. Prices are integer minor currency units. */
+declare const courseSchema: z.ZodObject<{
+    title: z.ZodString;
+    slug: z.ZodString;
+    description: z.ZodDefault<z.ZodString>;
+    coverImage: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"">]>>;
+    instructorId: z.ZodString;
+    instructorName: z.ZodDefault<z.ZodString>;
+    instructorBio: z.ZodDefault<z.ZodString>;
+    category: z.ZodDefault<z.ZodString>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    difficulty: z.ZodDefault<z.ZodEnum<{
+        beginner: "beginner";
+        intermediate: "intermediate";
+        advanced: "advanced";
+    }>>;
+    durationMins: z.ZodDefault<z.ZodNumber>;
+    price: z.ZodDefault<z.ZodNumber>;
+    currency: z.ZodDefault<z.ZodString>;
+    status: z.ZodDefault<z.ZodEnum<{
+        archived: "archived";
+        draft: "draft";
+        published: "published";
+    }>>;
+    featured: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/** Register alongside the School backend in cmsBackendPlugin({ contentTypes }). */
+declare const SCHOOL_COURSE_CONTENT_TYPE: ContentTypeConfig;
+/** Public course list filtering. Draft/publication controls are deliberately absent. */
+declare const courseFiltersSchema: z.ZodObject<{
+    category: z.ZodOptional<z.ZodString>;
+    difficulty: z.ZodOptional<z.ZodEnum<{
+        beginner: "beginner";
+        intermediate: "intermediate";
+        advanced: "advanced";
+    }>>;
+    maxDurationMins: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    pricing: z.ZodOptional<z.ZodEnum<{
+        paid: "paid";
+        free: "free";
+    }>>;
+    featured: z.ZodOptional<z.ZodUnion<[z.ZodPipe<z.ZodEnum<{
+        true: "true";
+        false: "false";
+    }>, z.ZodTransform<boolean, "true" | "false">>, z.ZodBoolean]>>;
+    query: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Multiple choice quiz definition. Correct answer indexes are only returned to instructors. */
+declare const quizSchema: z.ZodObject<{
+    questions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        question: z.ZodString;
+        options: z.ZodArray<z.ZodString>;
+        correctAnswer: z.ZodNumber;
+    }, z.core.$strip>>;
+    passMark: z.ZodOptional<z.ZodNumber>;
+    maxAttempts: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/** Lesson content, resource links, and optional server-scored quiz. */
+declare const lessonSchema: z.ZodObject<{
+    title: z.ZodString;
+    sectionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    type: z.ZodEnum<{
+        video: "video";
+        text: "text";
+        quiz: "quiz";
+    }>;
+    content: z.ZodDefault<z.ZodString>;
+    videoUrl: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"">]>>;
+    durationMins: z.ZodDefault<z.ZodNumber>;
+    order: z.ZodDefault<z.ZodNumber>;
+    isFreePreview: z.ZodDefault<z.ZodBoolean>;
+    resources: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        url: z.ZodString;
+    }, z.core.$strip>>>;
+    quiz: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        questions: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            question: z.ZodString;
+            options: z.ZodArray<z.ZodString>;
+            correctAnswer: z.ZodNumber;
+        }, z.core.$strip>>;
+        passMark: z.ZodOptional<z.ZodNumber>;
+        maxAttempts: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+
+/** CMS-backed course with serialized timestamps and curriculum count. */
+type Course = z.output<typeof courseSchema> & {
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    lessonCount: number;
+};
+type CourseFilters = z.input<typeof courseFiltersSchema>;
+type Quiz = z.output<typeof quizSchema>;
+/** Student-safe quiz question; answer keys are removed from lesson responses. */
+type PublicQuiz = Omit<Quiz, "questions"> & {
+    questions: Omit<Quiz["questions"][number], "correctAnswer">[];
+};
+type Section = {
+    id: string;
+    courseId: string;
+    title: string;
+    order: number;
+};
+type Lesson = Omit<z.output<typeof lessonSchema>, "quiz"> & {
+    id: string;
+    courseId: string;
+    quiz?: Quiz | PublicQuiz | null;
+};
+type LessonSummary = Pick<Lesson, "id" | "courseId" | "title" | "sectionId" | "type" | "durationMins" | "order" | "isFreePreview">;
+type Enrollment = {
+    id: string;
+    courseId: string;
+    userId: string;
+    status: "enrolled" | "completed" | "cancelled";
+    progressPct: number;
+    lastLessonId?: string | null;
+    certificateId?: string | null;
+    paymentRef?: string | null;
+    enrolledAt: string;
+    completedAt?: string | null;
+};
+type LessonProgress = {
+    id: string;
+    enrollmentId: string;
+    lessonId: string;
+    completed: boolean;
+    completedAt?: string | null;
+    positionSecs: number;
+};
+type QuizAttempt = {
+    id: string;
+    lessonId: string;
+    userId: string;
+    answers: {
+        questionId: string;
+        answer: number;
+    }[];
+    score: number;
+    passed: boolean;
+    attemptedAt: string;
+};
+type Review = {
+    id: string;
+    courseId: string;
+    userId: string;
+    rating: number;
+    body: string;
+    createdAt: string;
+};
+type CourseDetail = Course & {
+    sections: Section[];
+    lessons: LessonSummary[];
+    reviews: Review[];
+    enrollment: null;
+};
+/** Enrollment, payment, assessment, and completion lifecycle callbacks. */
+interface SchoolPluginHooks {
+    /** Runs before enrollment. Returning false rejects the request. */
+    onBeforeEnroll?: (userId: string, course: Course) => Promise<boolean> | boolean;
+    /** Runs after the enrollment has been persisted. */
+    onAfterEnroll?: (enrollment: Enrollment, course: Course) => Promise<void> | void;
+    /** Generate a certificate after completion; the returned unique ID is stored on the enrollment. */
+    onCourseComplete?: (enrollment: Enrollment, course: Course) => Promise<{
+        certificateId: string;
+    }> | {
+        certificateId: string;
+    };
+    /** Runs after a scored quiz attempt is persisted. */
+    onQuizSubmit?: (attempt: QuizAttempt, lesson: Lesson) => Promise<void> | void;
+}
+/** School backend configuration. */
+interface SchoolBackendOptions {
+    /** Enrollment and completion lifecycle callbacks. */
+    hooks?: SchoolPluginHooks;
+    /** Default quiz pass percentage, used when a quiz has no override. @default 70 */
+    quizPassMark?: number;
+    /** Enable certificate generation and public verification. @default true */
+    certificatesEnabled?: boolean;
+    /** Verify or collect payment on the server. Required for paid courses; falsy results reject enrollment. */
+    paymentAdapter?: {
+        createPayment: (input: {
+            userId: string;
+            course: Course;
+            idempotencyKey: string;
+        }) => Promise<{
+            paymentRef: string;
+        } | null>;
+    };
+}
+/** Validated authoring input shapes used by instructor forms. */
+type CourseInput = z.input<typeof courseSchema>;
+type LessonInput = z.input<typeof lessonSchema>;
+type CatalogFilters = CourseFilters;
+type StudentCoursesResult = {
+    items: (Enrollment & {
+        course: Course;
+        lessons: LessonSummary[];
+        /** A configured certificate provider has not yet issued this completed course's certificate. */
+        certificatePending: boolean;
+    })[];
+};
+type LessonResult = {
+    lesson: Lesson;
+    enrollment: Enrollment | null;
+    progress: LessonProgress | null;
+    attempts: QuizAttempt[];
+};
+type CourseStudentsResult = {
+    items: Enrollment[];
+    analytics: {
+        totalEnrolled: number;
+        totalCompleted: number;
+        completionRate: number;
+        enrollmentsOverTime: {
+            date: string;
+            count: number;
+        }[];
+    };
+};
+type CertificateResult = {
+    certificateId: string;
+    courseTitle: string;
+    completedAt?: string | null;
+};
+
+export { courseSchema as c, lessonSchema as l, SCHOOL_COURSE_CONTENT_TYPE as p, quizSchema as r };
+export type { CourseDetail as C, Enrollment as E, Lesson as L, PublicQuiz as P, QuizAttempt as Q, Review as R, StudentCoursesResult as S, Course as a, LessonSummary as b, Section as d, SchoolBackendOptions as e, CourseFilters as f, Quiz as g, LessonProgress as h, CatalogFilters as i, CertificateResult as j, CourseInput as k, CourseStudentsResult as m, LessonInput as n, LessonResult as o, SchoolPluginHooks as q };