@ueu/ueu-canvas 0.0.2 → 0.0.4

package/src/content/__tests__/getContentFuncs.test.ts

@@ -1,78 +0,0 @@
-import { getFileLinks, getExternalLinks } from "@/content/getContentFuncs";
-
-describe("Canvas Link Tests", () => {
-  const courseId = 12345;
-
-  it("should correctly identify file links within the course", () => {
-    const body = `
-      <div>
-        <a href="https://unity.instructure.com/files/12345">Course File 1</a>
-        <a href="https://unity.instructure.com/courses/12345/files/67890">Course File 2</a>
-        <a href="https://www.example.com/files/12345">External File</a>
-      </div>
-    `;
-
-    const fileLinks = getFileLinks(body, courseId);
-    expect(fileLinks.length).toBe(2);
-    expect(fileLinks[0]).toBe("https://unity.instructure.com/files/12345");
-    expect(fileLinks[1]).toBe("https://unity.instructure.com/courses/12345/files/67890");
-  });
-
-  it("should correctly identify external links", () => {
-    const body = `
-      <div>
-        <a href="https://unity.instructure.com/files/12345">Course File</a>
-        <a href="https://unity.instructure.com/courses/12345/files/67890">Course File</a>
-        <a href="https://www.example.com/page">External Page</a>
-        <a href="https://anotherexample.com/page">Another External Page</a>
-      </div>
-    `;
-
-    const externalLinks = getExternalLinks(body, courseId);
-    expect(externalLinks.length).toBe(2);
-    expect(externalLinks[0]).toBe("https://www.example.com/page");
-    expect(externalLinks[1]).toBe("https://anotherexample.com/page");
-  });
-
-  it("should handle an empty body", () => {
-    const body = ``;
-
-    const fileLinks = getFileLinks(body, courseId);
-    const externalLinks = getExternalLinks(body, courseId);
-
-    expect(fileLinks.length).toBe(0);
-    expect(externalLinks.length).toBe(0);
-  });
-
-  it("should handle a body with no links", () => {
-    const body = `<div>No links here</div>`;
-
-    const fileLinks = getFileLinks(body, courseId);
-    const externalLinks = getExternalLinks(body, courseId);
-
-    expect(fileLinks.length).toBe(0);
-    expect(externalLinks.length).toBe(0);
-  });
-
-  it("should handle mixed content correctly", () => {
-    const body = `
-      <div>
-        <a href="https://unity.instructure.com/files/12345">Course File</a>
-        <a href="https://www.example.com/page">External Page</a>
-        <a href="https://unity.instructure.com/courses/12345/files/67890">Course File</a>
-        <a href="https://anotherexample.com/page">Another External Page</a>
-      </div>
-    `;
-
-    const fileLinks = getFileLinks(body, courseId);
-    const externalLinks = getExternalLinks(body, courseId);
-
-    expect(fileLinks.length).toBe(2);
-    expect(fileLinks[0]).toBe("https://unity.instructure.com/files/12345");
-    expect(fileLinks[1]).toBe("https://unity.instructure.com/courses/12345/files/67890");
-
-    expect(externalLinks.length).toBe(2);
-    expect(externalLinks[0]).toBe("https://www.example.com/page");
-    expect(externalLinks[1]).toBe("https://anotherexample.com/page");
-  });
-});

package/src/content/assignments/Assignment.ts

@@ -1,69 +0,0 @@
-import {BaseContentItem} from "@/content/BaseContentItem";
-import {ICanvasCallConfig} from "@/canvasUtils";
-import {Temporal} from "temporal-polyfill";
-import assert from "assert";
-import AssignmentKind from "@/content/assignments/AssignmentKind";
-import {IAssignmentData} from "@canvas/content/types";
-
-export class Assignment extends BaseContentItem {
-    static kind = AssignmentKind;
-    static nameProperty = 'name';
-    static bodyProperty = 'description';
-    static contentUrlTemplate = "/api/v1/courses/{course_id}/assignments/{content_id}";
-    static allContentUrlTemplate = "/api/v1/courses/{course_id}/assignments";
-
-    constructor(assignmentData: IAssignmentData, courseId: number) {
-        super(assignmentData, courseId);
-    }
-
-    async setDueAt(dueAt: Date, config?: ICanvasCallConfig) {
-        const sourceDueAt = this.rawData.due_at ? Temporal.Instant.from(this.rawData.due_at) : null;
-        const targetDueAt = Temporal.Instant.from(dueAt.toISOString());
-
-        const payload: Record<string, { due_at: string, peer_reviews_assign_at?: string }> = {
-            assignment: {
-                due_at: dueAt.toISOString(),
-            }
-        }
-
-        if (this.rawData.peer_reviews && 'automatic_peer_reviews' in this.rawData) {
-            const peerReviewTime = this.rawData.peer_reviews_assign_at ? Temporal.Instant.from(this.rawData.peer_reviews_assign_at) : null;
-            assert(sourceDueAt, "Trying to set peer review date without a due date for the assignment.")
-            if (peerReviewTime) {
-                const peerReviewOffset = sourceDueAt.until(peerReviewTime);
-                const newPeerReviewTime = targetDueAt.add(peerReviewOffset);
-                payload.assignment.peer_reviews_assign_at =
-                    new Date(newPeerReviewTime.epochMilliseconds).toISOString();
-            }
-
-        }
-
-        const data = await this.saveData(payload, config);
-
-
-        this.canvasData['due_at'] = dueAt.toISOString();
-        return data;
-
-    }
-
-    get rawData() {
-        return this.canvasData as IAssignmentData;
-    }
-
-
-    async updateContent(text?: string | null, name?: string | null, config?: ICanvasCallConfig) {
-        const assignmentData: Record<string, any> = {};
-        if (text) {
-            assignmentData.description = text
-            this.rawData.description = text
-        }
-        if (name) {
-            assignmentData.name = name;
-            this.rawData.name = name;
-        }
-
-        return await this.saveData({
-            assignment: assignmentData
-        }, config)
-    }
-}

package/src/content/assignments/AssignmentKind.ts

@@ -1,29 +0,0 @@
-import {CanvasData} from "@/canvasDataDefs";
-import {ICanvasCallConfig} from "@/canvasUtils";
-import {fetchJson} from "@/fetch/fetchJson";
-import {getPagedDataGenerator} from "@/fetch/getPagedDataGenerator";
-import {ContentKind, contentUrlFuncs, putContentFunc} from "@/content/ContentKind";
-import {IAssignmentData, UpdateAssignmentDataOptions} from "@canvas/content/types";
-
-export const assignmentUrlFuncs = contentUrlFuncs('assignments');
-const AssignmentKind: ContentKind<
-    IAssignmentData,
-    CanvasData,
-    UpdateAssignmentDataOptions
-> = {
-    getId: (data) => data.id,
-    dataIsThisKind: (data): data is IAssignmentData => {
-        return 'submission_types' in data
-    },
-    getName: (data) => data.name,
-    getBody: (data) => data.description,
-    async get(courseId: number, contentId: number, config?: ICanvasCallConfig<Record<string, any>>) {
-        const data = await fetchJson(assignmentUrlFuncs.getApiUrl(courseId, contentId), config) as IAssignmentData;
-        return data;
-    },
-    ...assignmentUrlFuncs,
-    dataGenerator: (courseId, config) => getPagedDataGenerator<IAssignmentData>(assignmentUrlFuncs.getAllApiUrl(courseId), config),
-    put: putContentFunc<UpdateAssignmentDataOptions, IAssignmentData>(assignmentUrlFuncs.getApiUrl),
-}
-
-export default AssignmentKind;

package/src/content/assignments/__tests__/AssignmentKind.test.ts

@@ -1,31 +0,0 @@
-import {mockAssignmentData} from "@/content/__mocks__/mockContentData";
-import AssignmentKind, {assignmentUrlFuncs} from "@/content/assignments/AssignmentKind";
-import {getDataTests, kindUrlTests} from "@/content/__testingUtils__/utils";
-
-
-jest.mock('@/fetch/fetchJson')
-jest.mock('@/fetch/getPagedDataGenerator')
-describe('AssignmentKind', () => {
-    it('getId works', () => expect(AssignmentKind.getId({...mockAssignmentData, id: 100})).toEqual(100))
-    it('getName works', () => expect(AssignmentKind.getName({
-        ...mockAssignmentData,
-        name: "Assignment"
-    })).toEqual('Assignment'))
-    it('getBody works', () => expect(AssignmentKind.getBody({
-        ...mockAssignmentData,
-        description: "<p>Instructions</p>"
-    })).toEqual("<p>Instructions</p>"))
-
-    describe('get Data Tests', getDataTests(AssignmentKind, [
-        {...mockAssignmentData, id: 1},
-    ], { name: "x" }));
-
-})
-
-describe('AssignmentUrlFuncs', kindUrlTests(assignmentUrlFuncs,
-    1, 3,
-    '/api/v1/courses/1/assignments/3',
-    '/courses/1/assignments/3',
-    '/api/v1/courses/1/assignments'
-))
-

package/src/content/assignments/__tests__/assignments.test.ts

@@ -1,72 +0,0 @@
-import {mockCourseData} from "../../../course/__mocks__/mockCourseData";
-import {formDataify, ICanvasCallConfig, range} from "../../../canvasUtils";
-import {updateAssignmentData} from "../index";
-import {mockAssignmentData} from "../../__mocks__/mockContentData";
-import fetchMock from "jest-fetch-mock";
-import {assignmentDataGen} from "@/content/assignments";
-import {returnMockAsyncGen} from "@/__mocks__/utils";
-
-import * as canvasUtils from '@/canvasUtils';
-import {getPagedDataGenerator} from "@/fetch/getPagedDataGenerator";
-import {fetchJson} from "@/fetch/fetchJson";
-import {putContentConfig} from "@/content/BaseContentItem";
-import AssignmentKind from "@/content/assignments/AssignmentKind";
-import {UpdateAssignmentDataOptions} from "@canvas/content/types";
-
-fetchMock.enableMocks();
-
-jest.mock('@/fetch/getPagedDataGenerator', () => ({
-    getPagedDataGenerator: jest.fn(),
-
-}));
-
-jest.mock('@/fetch/fetchJson', () => ({
-    fetchJson: jest.fn(),
-}))
-
-
-it('gets assignments from course id', async () => {
-    const {id} = mockCourseData;
-    const config: ICanvasCallConfig = {
-        queryParams: {
-            bunnies: true,
-        },
-        fetchInit: {}
-    };
-
-
-    const responseDatas = [...range(0, 10)].map(id => ({...mockAssignmentData, id}));
-    (getPagedDataGenerator as jest.Mock).mockImplementation(returnMockAsyncGen(responseDatas));
-    const i = range(0, 10);
-    for await (const assignment of assignmentDataGen(id, config)) {
-        expect(assignment.id).toEqual(i.next().value);
-    }
-})
-
-it('gets assignment HTML url', () => {
-    expect(AssignmentKind.getHtmlUrl(1, 2)).toEqual('/courses/1/assignments/2');
-})
-
-it('updates assignment data', async () => {
-    const mockData = {...mockAssignmentData, name: "X"};
-    const updateData: UpdateAssignmentDataOptions = {
-        assignment: {
-            name: "Y"
-        }
-    };
-    const formData = {
-        data: "FormData"
-    }
-    const config = {};
-    const formDataify = jest.spyOn(canvasUtils, 'formDataify');
-    (fetchJson as jest.Mock).mockResolvedValue(mockData);
-    (formDataify as jest.Mock).mockReturnValue(formData)
-    const result = await updateAssignmentData(0, 0, updateData);
-    expect(formDataify).toHaveBeenCalledWith((updateData));
-    expect(fetchJson).toHaveBeenCalledWith('/api/v1/courses/0/assignments/0', putContentConfig(formData, config));
-
-    expect(result).toEqual(mockData);
-
-
-})
-

package/src/content/assignments/deleteAssignmentGroup.ts

@@ -1,15 +0,0 @@
-import {fetchJson} from "@canvas/fetch/fetchJson";
-import {formDataify} from "@canvas/canvasUtils";
-
-export default async function(courseId:number, groupId:number, moveAssignmentsTo?: number) {
-    const data = moveAssignmentsTo? { move_assignments_to: moveAssignmentsTo} : {};
-
-    const result = await fetchJson(`/api/v1/courses/${courseId}/assignment_groups/${groupId}`, {
-        fetchInit: {
-            method: 'DELETE',
-            body: formDataify(data),
-        }
-    })
-
-
-}

package/src/content/assignments/genAssignmentGroups.ts

@@ -1,15 +0,0 @@
-import {getPagedDataGenerator} from "@canvas/fetch/getPagedDataGenerator";
-
-import {AssignmentGroup} from "@canvas/content/types";
-
-
-export type AssignmentGroupInclude = 'assignments' | 'discussion_topic' | 'all_dates' |
-    'assignment_visibility' | 'overrides' | 'submission' | 'observed_users' | 'can_edit' | 'score_statistics'
-
-export default function(courseId:number, include: AssignmentGroupInclude[]  = ['assignments']) {
-    return getPagedDataGenerator<AssignmentGroup>(`/api/v1/courses/${courseId}/assignment_groups`, {
-        queryParams: {
-            include,
-        }
-    });
-}

package/src/content/assignments/index.ts

@@ -1,31 +0,0 @@
-import AssignmentKind from "@/content/assignments/AssignmentKind";
-import {ICanvasCallConfig} from "@/canvasUtils";
-import {Assignment} from "@/content/assignments/Assignment";
-import {IAssignmentData} from "@canvas/content/types";
-
-
-export const assignmentDataGen = AssignmentKind.dataGenerator;
-export const updateAssignmentData = AssignmentKind.put!;
-
-
-
-type UpdateAssignmentDueDatesOptions = {
-    courseId?: number,
-}
-export async function updateAssignmentDueDates(offset: number, assignments:IAssignmentData[], options?: UpdateAssignmentDueDatesOptions) {
-
-        const promises: Promise<any>[] = [];
-        const returnAssignments: Assignment[] = [];
-        let { courseId } = options ?? {};
-        if (!courseId && courseId !== 0) {
-            courseId = assignments[0].course_id;
-        }
-        if (offset === 0 || offset) {
-            for await (const data of assignments) {
-                const assignment = new Assignment(data, courseId);
-                returnAssignments.push(assignment);
-                promises.push(assignment.dueAtTimeDelta(Number(offset)));
-            }
-        }
-        return returnAssignments;
-    }

package/src/content/assignments/legacy.ts

@@ -1,11 +0,0 @@
-// noinspection JSUnusedGlobalSymbols
-
-import AssignmentKind from "@/content/assignments/AssignmentKind";
-
-
-export const assignmentDataGen = AssignmentKind.dataGenerator;
-export const updateAssignmentData = AssignmentKind.put!;
-export const getAssignmentData = AssignmentKind.get;
-
-
-

package/src/content/assignments/updateAssignmentDueDates.ts

@@ -1,25 +0,0 @@
-import {Assignment} from "@/content/assignments/Assignment";
-import {IAssignmentData} from "@canvas/content/types";
-
-export type UpdateAssignmentDueDatesOptions = {
-    courseId?: number,
-}
-
-export async function updateAssignmentDueDates(offset: number, assignments: IAssignmentData[], options?: UpdateAssignmentDueDatesOptions) {
-
-    const promises: Promise<any>[] = [];
-    const returnAssignments: Assignment[] = [];
-    let {courseId} = options ?? {};
-    if (!courseId && courseId !== 0) {
-        courseId = assignments[0].course_id;
-    }
-    if (offset === 0 || offset) {
-        for await (const data of assignments) {
-            const assignment = new Assignment(data, courseId);
-            returnAssignments.push(assignment);
-            promises.push(assignment.dueAtTimeDelta(Number(offset)));
-        }
-    }
-    await Promise.all(promises);
-    return returnAssignments;
-}

package/src/content/determineContent.ts

@@ -1,72 +0,0 @@
-import {Quiz} from "@/content/quizzes/Quiz";
-import {Page} from "@/content/pages/Page";
-import {Discussion} from "@/content/discussions/Discussion";
-import {ICanvasCallConfig} from "@/canvasUtils";
-import {Assignment} from "@/content/assignments/Assignment";
-import {ContentData} from "@/content/types";
-import AssignmentKind from "@/content/assignments/AssignmentKind";
-import QuizKind from "@/content/quizzes/QuizKind";
-import PageKind from "@/content/pages/PageKind";
-import DiscussionKind from "@/content/discussions/DiscussionKind";
-import {ContentKind} from "@/content/ContentKind";
-
-
-export const CONTENT_KINDS = [
-    DiscussionKind,
-    AssignmentKind,
-    PageKind,
-    QuizKind,
-]
-
-export const ContentKinds = {
-    fromUrl: getContentKindFromUrl,
-    fromContent: getContentKindFromContent,
-    getBody<Type extends ContentData>(contentData:Type) {
-        const kind = getContentKindFromContent(contentData);
-        return (kind?.getBody as (a:any) => string)(contentData);
-    }
-}
-
-
-export function getContentClassFromUrl(url: string | null = null) {
-    if (!url) url = document.documentURI;
-    for (const class_ of [Assignment, Quiz, Page, Discussion]) {
-        if (class_.contentUrlPart && url.includes(class_.contentUrlPart)) return class_;
-    }
-    return null;
-}
-
-export async function getContentItemFromUrl(url: string | null = null) {
-    const ContentClass = getContentClassFromUrl(url);
-    if (!ContentClass) return null;
-    return await ContentClass.getFromUrl(url);
-}
-
-export function getContentKindFromUrl(url:string) {
-    return CONTENT_KINDS.find(a => a.isValidUrl(url))
-}
-
-
-export type ContentKindInPractice = (typeof CONTENT_KINDS[number]);
-export type ContentDataType<Kind extends ContentKindInPractice> = Awaited<ReturnType<Kind['get']>>
-export function getContentKindFromContent<Kind extends ContentKindInPractice>(contentData:ContentDataType<Kind>) {
-
-
-    const result = CONTENT_KINDS.find(a => a.dataIsThisKind(contentData)) as Kind;
-    function typeGuard(result: ContentKindInPractice) : result is  Kind{
-        return true;
-    }
-    if(!typeGuard(result)) throw new Error("Faulty content type coercion");
-    return result;
-
-}
-
-
-
-export async function getContentDataFromUrl(url:string, config:ICanvasCallConfig) {
-    const kind = getContentKindFromUrl(url);
-    if(!kind) return;
-    const [courseId, id] = kind.getCourseAndContentIdFromUrl(url);
-    if(!courseId || !id) return;
-    return await kind.get(courseId, id, config);
-}

package/src/content/discussions/Discussion.ts

@@ -1,32 +0,0 @@
-import {BaseContentItem} from "@/content/BaseContentItem";
-import {ICanvasCallConfig} from "@/canvasUtils";
-import {Temporal} from "temporal-polyfill";
-import DiscussionKind from "@/content/discussions/DiscussionKind";
-
-
-import {IDiscussionData} from "@canvas/content/types";
-
-export class Discussion extends BaseContentItem {
-    static kindInfo = DiscussionKind;
-    static nameProperty = 'title';
-    static bodyProperty = 'message';
-    static contentUrlTemplate = "/api/v1/courses/{course_id}/discussion_topics/{content_id}";
-    static allContentUrlTemplate = "/api/v1/courses/{course_id}/discussion_topics"
-
-
-    async offsetPublishDelay(days: number, config?: ICanvasCallConfig) {
-        const data = this.rawData
-        if (!this.rawData.delayed_post_at) return;
-        let delayedPostAt = Temporal.Instant.from(this.rawData.delayed_post_at).toZonedDateTimeISO('UTC');
-        delayedPostAt = delayedPostAt.add({days})
-
-        const payload = {
-            delayed_post_at: new Date(delayedPostAt.epochMilliseconds).toISOString()
-        }
-        await this.saveData(payload, config);
-    }
-
-    get rawData() {
-        return this.canvasData as IDiscussionData;
-    }
-}

package/src/content/discussions/DiscussionKind.ts

@@ -1,30 +0,0 @@
-import {ICanvasCallConfig} from "@/canvasUtils";
-import {fetchJson} from "@/fetch/fetchJson";
-import {getPagedDataGenerator} from "@/fetch/getPagedDataGenerator";
-import {ContentKind, contentUrlFuncs, putContentFunc} from "@/content/ContentKind";
-
-
-import {IDiscussionData, SaveDiscussionData} from "@canvas/content/types";
-
-export type GetDiscussionOptions = Record<string, any>;
-export const discussionUrlFuncs = contentUrlFuncs('discussion_topics');
-const DiscussionKind: ContentKind<
-    IDiscussionData,
-    GetDiscussionOptions,
-    SaveDiscussionData
-> = {
-    ...discussionUrlFuncs,
-    dataIsThisKind(data): data is IDiscussionData {
-        return data.hasOwnProperty('discussion_type');
-    },
-    getId: (data) => data.id,
-    getName: (data) => data.title,
-    getBody: (data) => data.message,
-    async get(courseId: number, contentId: number, config?: ICanvasCallConfig<GetDiscussionOptions>) {
-        return await fetchJson(discussionUrlFuncs.getApiUrl(courseId, contentId), config) as IDiscussionData;
-    },
-    dataGenerator: (courseId, config) => getPagedDataGenerator<IDiscussionData>(discussionUrlFuncs.getAllApiUrl(courseId), config),
-    put: putContentFunc<SaveDiscussionData, IDiscussionData>(discussionUrlFuncs.getApiUrl),
-}
-
-export default DiscussionKind;

package/src/content/discussions/__tests__/DiscussionKind.test.ts

@@ -1,31 +0,0 @@
-import AssignmentKind, {assignmentUrlFuncs} from "@/content/assignments/AssignmentKind";
-import {mockAssignmentData, mockDiscussionData} from "@/content/__mocks__/mockContentData";
-import {getDataTests, kindUrlTests} from "@/content/__testingUtils__/utils";
-import DiscussionKind, {discussionUrlFuncs} from "@/content/discussions/DiscussionKind";
-
-jest.mock('@/fetch/fetchJson')
-jest.mock('@/fetch/getPagedDataGenerator')
-describe('DiscussionKind', () => {
-    it('getId works', () => expect(DiscussionKind.getId({...mockDiscussionData, id: 100})).toEqual(100))
-    it('getName works', () => expect(DiscussionKind.getName({
-        ...mockDiscussionData,
-        title: "Discussion"
-    })).toEqual('Discussion'))
-    it('getBody works', () => expect(DiscussionKind.getBody({
-        ...mockDiscussionData,
-        message: "<p>Instructions</p>"
-    })).toEqual("<p>Instructions</p>"))
-
-    describe('get Data Tests', getDataTests(DiscussionKind, [
-        {...mockDiscussionData, id: 1},
-    ], { title: "x" }));
-
-})
-
-
-describe('DiscussionUrlFuncs', kindUrlTests(discussionUrlFuncs,
-    1, 3,
-    '/api/v1/courses/1/discussion_topics/3',
-    '/courses/1/discussion_topics/3',
-    '/api/v1/courses/1/discussion_topics'
-))

package/src/content/discussions/genEquivalentDiscussionData.ts

@@ -1,97 +0,0 @@
-// import {genBlueprintDataForCode} from "@canvas/course/blueprint";
-// import {Course} from "@canvas/course/Course";
-// import AssignmentKind from "@canvas/content/assignments/AssignmentKind";
-// import {ContentData, IAssignmentData, IDiscussionData} from "@canvas/content/types";
-// import {Assignment} from "@canvas/content/assignments/Assignment";
-// import DiscussionKind from "@canvas/content/discussions/DiscussionKind";
-// import {getModuleWeekNumber, moduleGenerator} from "@canvas/course/modules";
-// import {ContentKind} from "@canvas/content/ContentKind";
-// import {
-//     CONTENT_KINDS,
-//     ContentKindInPractice,
-//     ContentDataType,
-//     getContentKindFromContent
-// } from "@canvas/content/determineContent";
-// import {getModuleInfo} from "@/ui/speedGrader/modules";
-// import {renderAsyncGen} from "@canvas/canvasUtils";
-// import {IModuleItemData} from "@canvas/canvasDataDefs";
-
-/**
- * Retrieves the equivalent discussion data for a given assignment across multiple course blueprints.
- *
- * This function searches through the assignments in various blueprints of a course, attempting to find
- * discussions that were originally associated with a given assignment (identified by its `assignmentId`).
- * If a matching discussion is found in any blueprint, the corresponding discussion data (`IDiscussionData`) is yielded.
- * This is useful for recovering lost or missing discussion data when the original discussion ID is not available,
- * but the assignment information is accessible.
- *
- * The function processes the blueprints lazily, yielding results one by one as they are found. This ensures efficient memory usage
- * when dealing with large sets of blueprint data.
- *
- * @param {Course} course - The course from which the blueprint data is being retrieved. This course is used to find
- *                           the relevant blueprints through the `genBlueprintDataForCode` function.
- * @param {number} assignmentId - The ID of the assignment whose associated discussion data is being retrieved.
- *                                The function will search across blueprints to find discussions linked to this assignment.
- *
- * @yields {IDiscussionData} - The `IDiscussionData` object that corresponds to the found discussion, if any.
- *                              This data includes the discussion properties like `discussion_type`, `require_initial_post`, etc.
- *
- * @remarks
- * - If no discussion is found for the given assignment ID across the blueprints, the generator will complete without yielding any values.
- * - If the discussion is found, the function will yield the associated `discussion_topic` object, which can then be processed or restored as needed.
- * - The function operates asynchronously and uses a generator to lazily fetch and yield discussion data, ensuring efficient handling of large datasets.
- *
- * @example
- * const generator = getEquivalentDiscussionData(course, 123);
- * for await (const discussion of generator) {
- *     console.log(discussion);  // Process each matching discussion found
- * }
- */
-
-// export async function* genEquivalentDiscussionData(course: {id: number, courseCode: string, accountId: number }, assignmentId: number): AsyncGenerator {
-//     const blueprintGen = genBlueprintDataForCode(course.courseCode, [course.accountId]);
-//     if (!blueprintGen) throw new Error("Blueprint generator not found");
-//     const assignmentData = await AssignmentKind.get(course.id, assignmentId, { });
-//     if(!assignmentData) return;
-//     for await (const blueprint of blueprintGen) {
-//         const bpModules = await renderAsyncGen(moduleGenerator(blueprint.id));
-//         for await (const bpModule of bpModules) {
-//             const items = bpModule.items;
-//             for(const item of items) {
-//                 if(item.title == assignmentData.name) {
-//                     let analogAssignment: IAssignmentData;
-//                     const contentKind = item.type === 'Assignment' ? AssignmentKind :
-//                         item.type === 'Discussion' ? DiscussionKind :
-//                             undefined;
-//                     if(!contentKind) continue; //this is not a relevant data type
-//                     const primaryData = await contentKind.get(blueprint.id, item.content_id);
-//
-//
-//                     if (!analogDiscussionId) return undefined;
-//                     const analogDiscussionData = await DiscussionKind.get(analogAssignment.courseId, analogDiscussionId);
-//
-//
-//                 }
-//             }
-//
-//         }
-//         // Iterate through assignments in this blueprint
-//         // Find assignments in the blueprint that match the given assignmentId
-//         const moduleItem = getModuleInfo(analogAssignment.id);
-//         // If a match is found, yield the associated discussion
-//     }
-// }
-//
-//
-// async function getByName<Kind extends ContentKindInPractice>(items: AsyncGenerator<ContentDataType<Kind>>, search: string | ((toCheck: string) => boolean)) {
-//
-//   const checkFunc = typeof search != 'string' ? search : (toCheck:string) => search == toCheck;
-//   for await (const item of items) {
-//     const contentKind = getContentKindFromContent(item) as Kind & { getByName: (name:string) => typeof item};
-//     if(!contentKind) continue;
-//     if(!contentKind.dataIsThisKind(item)) throw new Error("Data constraint violation in getting content by name");
-//     const name = (contentKind as { getName: (data:ContentDataType<Kind>) => string|undefined}).getName(item);
-//     if(name && checkFunc(name)) return item;
-//   }
-//   return undefined;
-// }