@epic-web/workshop-utils 6.59.1 → 6.61.0

package/dist/apps.server.d.ts

@@ -4871,6 +4871,14 @@ export declare function getAppFromFile(filePath: string): Promise<{
     epicVideoEmbeds?: string[] | undefined;
 } | undefined>;
 export declare function savePlayground(): Promise<void>;
+export type SavedPlayground = {
+    id: string;
+    appName: string;
+    createdAt: string;
+    createdAtMs: number;
+    fullPath: string;
+};
+export declare function getSavedPlaygrounds(): Promise<Array<SavedPlayground>>;
 export declare function setPlayground(srcDir: string, { reset }?: {
     reset?: boolean;
 }): Promise<void>;
@@ -4895,6 +4903,21 @@ export declare function getWorkshopInstructions({ request, }?: {
     readonly file: string;
     readonly relativePath: "exercises";
 }>;
+export declare function getExamplesInstructions({ request, }?: {
+    request?: Request;
+}): Promise<{
+    readonly compiled: {
+        readonly status: "success";
+        readonly code: string;
+        readonly title: string | null;
+        readonly epicVideoEmbeds: Array<string>;
+    } | {
+        readonly status: "error";
+        readonly error: string;
+    };
+    readonly file: string;
+    readonly relativePath: "examples/README.mdx";
+}>;
 export declare function getWorkshopFinished({ request, }?: {
     request?: Request;
 }): Promise<{

package/dist/apps.server.js

@@ -1049,6 +1049,46 @@ locally and uncheck "Enable saving playground."
     }
     await fsExtra.copy(playgroundDir, path.join(savedPlaygroundsDir, savedPlaygroundDirName));
 }
+const savedPlaygroundTimestampPattern = /^(\d{4})\.(\d{2})\.(\d{2})_(\d{2})\.(\d{2})\.(\d{2})$/;
+function parseSavedPlaygroundDirName(dirName) {
+    const parts = dirName.split('_');
+    if (parts.length < 3)
+        return null;
+    const timestampPart = `${parts[0]}_${parts[1]}`;
+    const appName = parts.slice(2).join('_') || dirName;
+    const match = savedPlaygroundTimestampPattern.exec(timestampPart);
+    if (!match)
+        return null;
+    const [, year, month, day, hour, minute, second] = match;
+    const createdAt = new Date(Number(year), Number(month) - 1, Number(day), Number(hour), Number(minute), Number(second));
+    if (Number.isNaN(createdAt.getTime()))
+        return null;
+    return { appName, createdAt };
+}
+export async function getSavedPlaygrounds() {
+    const savedPlaygroundsDir = path.join(getWorkshopRoot(), 'saved-playgrounds');
+    if (!(await exists(savedPlaygroundsDir)))
+        return [];
+    const dirEntries = await fsExtra.readdir(savedPlaygroundsDir, {
+        withFileTypes: true,
+    });
+    const savedPlaygrounds = await Promise.all(dirEntries
+        .filter((entry) => entry.isDirectory())
+        .map(async (entry) => {
+        const fullPath = path.join(savedPlaygroundsDir, entry.name);
+        const parsed = parseSavedPlaygroundDirName(entry.name);
+        const stat = await fsExtra.stat(fullPath).catch(() => null);
+        const createdAt = parsed?.createdAt ?? (stat ? new Date(stat.mtimeMs) : new Date(0));
+        return {
+            id: entry.name,
+            appName: parsed?.appName ?? entry.name,
+            createdAt: createdAt.toISOString(),
+            createdAtMs: createdAt.getTime(),
+            fullPath,
+        };
+    }));
+    return savedPlaygrounds.sort((a, b) => b.createdAtMs - a.createdAtMs);
+}
 export async function setPlayground(srcDir, { reset } = {}) {
     const preferences = await getPreferences();
     const playgroundApp = await getAppByName('playground');
@@ -1219,6 +1259,18 @@ export async function getWorkshopInstructions({ request, } = {}) {
     });
     return { compiled, file: readmeFilepath, relativePath: 'exercises' };
 }
+export async function getExamplesInstructions({ request, } = {}) {
+    const readmeFilepath = path.join(getWorkshopRoot(), 'examples', 'README.mdx');
+    const compiled = await compileMdx(readmeFilepath, { request }).then((r) => ({ ...r, status: 'success' }), (e) => {
+        console.error(`There was an error compiling the examples README.mdx`, readmeFilepath, e);
+        return { status: 'error', error: getErrorMessage(e) };
+    });
+    return {
+        compiled,
+        file: readmeFilepath,
+        relativePath: 'examples/README.mdx',
+    };
+}
 export async function getWorkshopFinished({ request, } = {}) {
     const finishedFilepath = path.join(getWorkshopRoot(), 'exercises', 'FINISHED.mdx');
     const compiled = await compileMdx(finishedFilepath, { request }).then((r) => ({ ...r, status: 'success' }), (e) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epic-web/workshop-utils",
-  "version": "6.59.1",
+  "version": "6.61.0",
   "publishConfig": {
     "access": "public"
   },