@happyvertical/smrt-education 0.58.0 → 0.59.0

package/dist/ingestion.js

@@ -1,4 +1,4 @@
-import { F as normalizeWorkObservedLayout, I as normalizeWorkAnswerRegions, It as FamilyIntakeAssetCollection, Lt as FamilyIntakeCollection, M as QuestionExtractionPendingError, N as QuestionExtractionValidationError, Nt as WorkbookPhotoIntakeCollection, P as LessonWorkService, Tt as familyIntakeScopeId, Y as LearnerAuthorizationError, a as questionExtractionProposalDigest, an as aggregateWorkQuestions, kt as WorkbookPhotoAssetCollection, n as preservePhotoProposal, nn as WORK_MATH_VOCABULARY, on as validateWorkAssessment, r as validateWorkbookPhotoIdentification, rn as WorkAssessmentValidationError, sn as workAggregateFeedback, t as WorkbookPhotoService, u as QUESTION_EXTRACTION_ARGS_SCHEMA, zt as FamilyIntakeDecisionCollection } from "./chunks/workbook-photo-service-COtyQL1y.js";
+import { F as normalizeWorkObservedLayout, I as normalizeWorkAnswerRegions, It as FamilyIntakeAssetCollection, Lt as FamilyIntakeCollection, M as QuestionExtractionPendingError, N as QuestionExtractionValidationError, Nt as WorkbookPhotoIntakeCollection, P as LessonWorkService, Tt as familyIntakeScopeId, Y as LearnerAuthorizationError, a as questionExtractionProposalDigest, an as aggregateWorkQuestions, kt as WorkbookPhotoAssetCollection, n as preservePhotoProposal, nn as WORK_MATH_VOCABULARY, on as validateWorkAssessment, r as validateWorkbookPhotoIdentification, rn as WorkAssessmentValidationError, sn as workAggregateFeedback, t as WorkbookPhotoService, u as QUESTION_EXTRACTION_ARGS_SCHEMA, zt as FamilyIntakeDecisionCollection } from "./chunks/workbook-photo-service-CjcB0y8Y.js";
 import { getCurrentTenant, withTenant } from "@happyvertical/smrt-tenancy";
 import { withPrivateAssetAccess } from "@happyvertical/smrt-assets";
 import { registerPermissionDefinitions } from "@happyvertical/smrt-users";

package/dist/manifest.json

@@ -2,7 +2,7 @@
   "version": "1.0.0",
   "timestamp": 0,
   "packageName": "@happyvertical/smrt-education",
-  "packageVersion": "0.58.0",
+  "packageVersion": "0.59.0",
   "objects": {
     "@happyvertical/smrt-education:CatalogProviderCollection": {
       "name": "catalogprovidercollection",
@@ -869,7 +869,8 @@
           "default": "catalog",
           "enum": [
             "catalog",
-            "teacher"
+            "teacher",
+            "operator"
           ]
         },
         "lastSeenRunId": {
@@ -15752,6 +15753,10 @@
           "type": "text",
           "required": false
         },
+        "audience": {
+          "type": "text",
+          "required": false
+        },
         "sectionKey": {
           "type": "text",
           "required": false
@@ -15857,7 +15862,7 @@
       ],
       "schema": {
         "tableName": "course_bundle_members",
-        "ddl": "CREATE TABLE IF NOT EXISTS \"course_bundle_members\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID NOT NULL,\n  \"import_id\" UUID NOT NULL,\n  \"ordinal\" INTEGER NOT NULL DEFAULT 0,\n  \"path\" TEXT,\n  \"sha256\" TEXT,\n  \"size_bytes\" INTEGER NOT NULL DEFAULT 0,\n  \"media_type\" TEXT,\n  \"kind\" TEXT,\n  \"status\" TEXT,\n  \"reason\" TEXT,\n  \"duplicate_of_path\" TEXT,\n  \"role\" TEXT,\n  \"section_key\" TEXT,\n  \"lesson_key\" TEXT,\n  \"rendered_sha256\" TEXT,\n  \"rendered_size_bytes\" INTEGER NOT NULL DEFAULT 0,\n  \"recorded_at\" TEXT\n);",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"course_bundle_members\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID NOT NULL,\n  \"import_id\" UUID NOT NULL,\n  \"ordinal\" INTEGER NOT NULL DEFAULT 0,\n  \"path\" TEXT,\n  \"sha256\" TEXT,\n  \"size_bytes\" INTEGER NOT NULL DEFAULT 0,\n  \"media_type\" TEXT,\n  \"kind\" TEXT,\n  \"status\" TEXT,\n  \"reason\" TEXT,\n  \"duplicate_of_path\" TEXT,\n  \"role\" TEXT,\n  \"audience\" TEXT,\n  \"section_key\" TEXT,\n  \"lesson_key\" TEXT,\n  \"rendered_sha256\" TEXT,\n  \"rendered_size_bytes\" INTEGER NOT NULL DEFAULT 0,\n  \"recorded_at\" TEXT\n);",
         "columns": {
           "id": {
             "type": "UUID",
@@ -15954,6 +15959,11 @@
             "notNull": false,
             "unique": false
           },
+          "audience": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
           "section_key": {
             "type": "TEXT",
             "notNull": false,
@@ -16029,7 +16039,7 @@
             ]
           }
         ],
-        "version": "c9f518ec"
+        "version": "24a188d0"
       },
       "importPath": "@happyvertical/smrt-education"
     },
@@ -16060,7 +16070,7 @@
       ],
       "schema": {
         "tableName": "course_bundle_members",
-        "ddl": "CREATE TABLE IF NOT EXISTS \"course_bundle_members\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID NOT NULL,\n  \"import_id\" UUID NOT NULL,\n  \"ordinal\" INTEGER NOT NULL DEFAULT 0,\n  \"path\" TEXT,\n  \"sha256\" TEXT,\n  \"size_bytes\" INTEGER NOT NULL DEFAULT 0,\n  \"media_type\" TEXT,\n  \"kind\" TEXT,\n  \"status\" TEXT,\n  \"reason\" TEXT,\n  \"duplicate_of_path\" TEXT,\n  \"role\" TEXT,\n  \"section_key\" TEXT,\n  \"lesson_key\" TEXT,\n  \"rendered_sha256\" TEXT,\n  \"rendered_size_bytes\" INTEGER NOT NULL DEFAULT 0,\n  \"recorded_at\" TEXT\n);",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"course_bundle_members\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID NOT NULL,\n  \"import_id\" UUID NOT NULL,\n  \"ordinal\" INTEGER NOT NULL DEFAULT 0,\n  \"path\" TEXT,\n  \"sha256\" TEXT,\n  \"size_bytes\" INTEGER NOT NULL DEFAULT 0,\n  \"media_type\" TEXT,\n  \"kind\" TEXT,\n  \"status\" TEXT,\n  \"reason\" TEXT,\n  \"duplicate_of_path\" TEXT,\n  \"role\" TEXT,\n  \"audience\" TEXT,\n  \"section_key\" TEXT,\n  \"lesson_key\" TEXT,\n  \"rendered_sha256\" TEXT,\n  \"rendered_size_bytes\" INTEGER NOT NULL DEFAULT 0,\n  \"recorded_at\" TEXT\n);",
         "columns": {
           "id": {
             "type": "UUID",
@@ -16157,6 +16167,11 @@
             "notNull": false,
             "unique": false
           },
+          "audience": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
           "section_key": {
             "type": "TEXT",
             "notNull": false,
@@ -16232,7 +16247,404 @@
             ]
           }
         ],
-        "version": "c9f518ec"
+        "version": "24a188d0"
+      },
+      "importPath": "@happyvertical/smrt-education"
+    },
+    "@happyvertical/smrt-education:CourseBundleRendering": {
+      "name": "coursebundlerendering",
+      "className": "CourseBundleRendering",
+      "qualifiedName": "@happyvertical/smrt-education:CourseBundleRendering",
+      "collection": "coursebundlerenderings",
+      "description": "Append-only record that a Word/PowerPoint member whose first rendering failed was rendered later by a deliberate retry (SMRT #4615).",
+      "filePath": "/home/runner/work/smrt/smrt/packages/education/src/course-bundle-models.ts",
+      "packageName": "@happyvertical/smrt-education",
+      "fields": {
+        "tenantId": {
+          "type": "text",
+          "required": true,
+          "_meta": {
+            "sqlType": "UUID",
+            "__tenancy": {
+              "isTenantIdField": true,
+              "autoFilter": true,
+              "required": true,
+              "autoPopulate": true,
+              "nullable": false,
+              "mode": "required",
+              "field": "tenantId",
+              "allowSuperAdminBypass": false
+            }
+          }
+        },
+        "importId": {
+          "type": "foreignKey",
+          "required": true,
+          "related": "CourseBundleImport",
+          "_meta": {
+            "required": true
+          }
+        },
+        "sha256": {
+          "type": "text",
+          "required": false
+        },
+        "renderedSha256": {
+          "type": "text",
+          "required": false
+        },
+        "renderedSizeBytes": {
+          "type": "integer",
+          "required": true,
+          "default": 0
+        },
+        "converterId": {
+          "type": "text",
+          "required": false
+        },
+        "retriedByUserId": {
+          "type": "text",
+          "required": false
+        },
+        "recordedAt": {
+          "type": "text",
+          "required": false
+        }
+      },
+      "methods": {
+        "delete": {
+          "name": "delete",
+          "async": true,
+          "parameters": [],
+          "returnType": "Promise<void>",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "save": {
+          "name": "save",
+          "async": true,
+          "parameters": [
+            {
+              "name": "options",
+              "type": "SmrtSaveOptions",
+              "optional": true
+            }
+          ],
+          "returnType": "Promise<this>",
+          "isStatic": false,
+          "isPublic": true
+        }
+      },
+      "decoratorConfig": {
+        "tableName": "course_bundle_renderings",
+        "conflictColumns": [
+          "tenant_id",
+          "import_id",
+          "sha256"
+        ],
+        "indexes": [
+          {
+            "name": "course_bundle_renderings_unique",
+            "columns": [
+              "tenantId",
+              "importId",
+              "sha256"
+            ],
+            "unique": true
+          }
+        ],
+        "api": false,
+        "mcp": false,
+        "cli": false,
+        "tenantScoped": {
+          "mode": "required"
+        }
+      },
+      "extends": "SmrtObject",
+      "exportName": "CourseBundleRendering",
+      "collectionExportName": "CourseBundleRenderingCollection",
+      "validationRules": [
+        {
+          "field": "importId",
+          "rule": "required",
+          "fieldType": "foreignKey"
+        },
+        {
+          "field": "renderedSizeBytes",
+          "rule": "required",
+          "fieldType": "integer"
+        }
+      ],
+      "schema": {
+        "tableName": "course_bundle_renderings",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"course_bundle_renderings\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID NOT NULL,\n  \"import_id\" UUID NOT NULL,\n  \"sha256\" TEXT,\n  \"rendered_sha256\" TEXT,\n  \"rendered_size_bytes\" INTEGER NOT NULL DEFAULT 0,\n  \"converter_id\" TEXT,\n  \"retried_by_user_id\" TEXT,\n  \"recorded_at\" TEXT\n);",
+        "columns": {
+          "id": {
+            "type": "UUID",
+            "primaryKey": true,
+            "referenceKind": "id",
+            "notNull": true
+          },
+          "slug": {
+            "type": "TEXT",
+            "notNull": true
+          },
+          "context": {
+            "type": "TEXT",
+            "notNull": true,
+            "default": ""
+          },
+          "created_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "updated_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "tenant_id": {
+            "type": "UUID",
+            "referenceKind": "tenantId",
+            "notNull": true,
+            "unique": false
+          },
+          "import_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": true,
+            "unique": false,
+            "foreignKey": {
+              "table": "course_bundle_imports",
+              "column": "id",
+              "onDelete": "CASCADE",
+              "onUpdate": "CASCADE"
+            }
+          },
+          "sha256": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "rendered_sha256": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "rendered_size_bytes": {
+            "type": "INTEGER",
+            "notNull": true,
+            "unique": false,
+            "default": 0
+          },
+          "converter_id": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "retried_by_user_id": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "recorded_at": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          }
+        },
+        "indexes": [
+          {
+            "name": "course_bundle_renderings_tenant_id_import_id_idx",
+            "columns": [
+              "tenant_id",
+              "import_id",
+              "sha256"
+            ],
+            "unique": true,
+            "nullsNotDistinct": true
+          },
+          {
+            "name": "course_bundle_renderings_slug_context_idx",
+            "columns": [
+              "slug",
+              "context"
+            ]
+          },
+          {
+            "name": "course_bundle_renderings_unique",
+            "columns": [
+              "tenant_id",
+              "import_id",
+              "sha256"
+            ],
+            "unique": true
+          },
+          {
+            "name": "course_bundle_renderings_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
+          },
+          {
+            "name": "course_bundle_renderings_import_id_idx",
+            "columns": [
+              "import_id"
+            ]
+          }
+        ],
+        "version": "8f393b32"
+      },
+      "importPath": "@happyvertical/smrt-education"
+    },
+    "@happyvertical/smrt-education:CourseBundleRenderingCollection": {
+      "name": "coursebundlerenderingcollection",
+      "className": "CourseBundleRenderingCollection",
+      "qualifiedName": "@happyvertical/smrt-education:CourseBundleRenderingCollection",
+      "collection": "coursebundlerenderings",
+      "filePath": "/home/runner/work/smrt/smrt/packages/education/src/course-bundle-models.ts",
+      "packageName": "@happyvertical/smrt-education",
+      "fields": {},
+      "methods": {},
+      "decoratorConfig": {
+        "tableName": "course_bundle_renderings",
+        "api": false,
+        "mcp": false,
+        "cli": false
+      },
+      "extends": "SmrtCollection",
+      "extendsTypeArg": "CourseBundleRendering",
+      "exportName": "CourseBundleRenderingCollection",
+      "collectionExportName": "CourseBundleRenderingCollectionCollection",
+      "collectionOf": "@happyvertical/smrt-education:CourseBundleRendering",
+      "inheritedExposure": [
+        "api",
+        "mcp",
+        "cli"
+      ],
+      "schema": {
+        "tableName": "course_bundle_renderings",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"course_bundle_renderings\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID NOT NULL,\n  \"import_id\" UUID NOT NULL,\n  \"sha256\" TEXT,\n  \"rendered_sha256\" TEXT,\n  \"rendered_size_bytes\" INTEGER NOT NULL DEFAULT 0,\n  \"converter_id\" TEXT,\n  \"retried_by_user_id\" TEXT,\n  \"recorded_at\" TEXT\n);",
+        "columns": {
+          "id": {
+            "type": "UUID",
+            "primaryKey": true,
+            "referenceKind": "id",
+            "notNull": true
+          },
+          "slug": {
+            "type": "TEXT",
+            "notNull": true
+          },
+          "context": {
+            "type": "TEXT",
+            "notNull": true,
+            "default": ""
+          },
+          "created_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "updated_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "tenant_id": {
+            "type": "UUID",
+            "referenceKind": "tenantId",
+            "notNull": true,
+            "unique": false
+          },
+          "import_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": true,
+            "unique": false,
+            "foreignKey": {
+              "table": "course_bundle_imports",
+              "column": "id",
+              "onDelete": "CASCADE",
+              "onUpdate": "CASCADE"
+            }
+          },
+          "sha256": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "rendered_sha256": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "rendered_size_bytes": {
+            "type": "INTEGER",
+            "notNull": true,
+            "unique": false,
+            "default": 0
+          },
+          "converter_id": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "retried_by_user_id": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "recorded_at": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          }
+        },
+        "indexes": [
+          {
+            "name": "course_bundle_renderings_tenant_id_import_id_idx",
+            "columns": [
+              "tenant_id",
+              "import_id",
+              "sha256"
+            ],
+            "unique": true,
+            "nullsNotDistinct": true
+          },
+          {
+            "name": "course_bundle_renderings_slug_context_idx",
+            "columns": [
+              "slug",
+              "context"
+            ]
+          },
+          {
+            "name": "course_bundle_renderings_unique",
+            "columns": [
+              "tenant_id",
+              "import_id",
+              "sha256"
+            ],
+            "unique": true
+          },
+          {
+            "name": "course_bundle_renderings_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
+          },
+          {
+            "name": "course_bundle_renderings_import_id_idx",
+            "columns": [
+              "import_id"
+            ]
+          }
+        ],
+        "version": "8f393b32"
       },
       "importPath": "@happyvertical/smrt-education"
     },

package/dist/node.d.ts

@@ -0,0 +1,3 @@
+/** Server-only readers for Class CrunchLabs downloads on disk. Never import from browser code. */
+export { folderClassCrunchLabsSource } from './sources/class-crunchlabs-files.js';
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/node.js

@@ -0,0 +1,134 @@
+import { s as COURSE_BUNDLE_LIMITS, t as crc32 } from "./chunks/course-bundle-zip-5KUe3C5H.js";
+import { open, readFile, readdir } from "node:fs/promises";
+import { basename, join, relative, sep } from "node:path";
+import { lstatSync } from "node:fs";
+import { inflateRawSync } from "node:zlib";
+//#region src/sources/class-crunchlabs-files.ts
+var EOCD = 101010256;
+var CENTRAL = 33639248;
+var LOCAL = 67324752;
+var MAX_CENTRAL_DIRECTORY = 16 * 1024 * 1024;
+var MAX_DEPTH = 8;
+async function readAt(path, position, length) {
+	const handle = await open(path, "r");
+	try {
+		const available = Math.max(0, (await handle.stat()).size - position);
+		const buffer = Buffer.alloc(Math.min(length, available));
+		const { bytesRead } = await handle.read(buffer, 0, buffer.length, position);
+		return buffer.subarray(0, bytesRead);
+	} finally {
+		await handle.close();
+	}
+}
+async function sizeOf(path) {
+	const handle = await open(path, "r");
+	try {
+		return (await handle.stat()).size;
+	} finally {
+		await handle.close();
+	}
+}
+async function listZip(path) {
+	const handle = await open(path, "r");
+	let total;
+	try {
+		total = (await handle.stat()).size;
+	} finally {
+		await handle.close();
+	}
+	const tailLength = Math.min(total, 65557);
+	const tail = await readAt(path, total - tailLength, tailLength);
+	let eocd = -1;
+	for (let i = tail.length - 22; i >= 0; i--) if (tail.readUInt32LE(i) === EOCD && i + 22 + tail.readUInt16LE(i + 20) === tail.length) {
+		eocd = i;
+		break;
+	}
+	if (eocd === -1) throw new Error(`${basename(path)} is not a readable zip.`);
+	const entries = tail.readUInt16LE(eocd + 10);
+	const size = tail.readUInt32LE(eocd + 12);
+	const offset = tail.readUInt32LE(eocd + 16);
+	if (tail.readUInt16LE(eocd + 4) !== 0 || tail.readUInt16LE(eocd + 6) !== 0 || entries === 65535 || size === 4294967295 || offset === 4294967295) throw new Error(`${basename(path)} is a zip64 or multi-disk archive.`);
+	if (size > MAX_CENTRAL_DIRECTORY || offset + size > total) throw new Error(`${basename(path)} has an invalid central directory.`);
+	const central = await readAt(path, offset, size);
+	const out = [];
+	let at = 0;
+	for (let n = 0; n < entries; n++) {
+		if (at + 46 > central.length || central.readUInt32LE(at) !== CENTRAL) throw new Error(`${basename(path)} has a damaged central directory.`);
+		const flags = central.readUInt16LE(at + 8);
+		const nameLength = central.readUInt16LE(at + 28);
+		const extraLength = central.readUInt16LE(at + 30);
+		const commentLength = central.readUInt16LE(at + 32);
+		const name = central.toString("utf8", at + 46, at + 46 + nameLength);
+		const entry = {
+			name,
+			method: central.readUInt16LE(at + 10),
+			crc: central.readUInt32LE(at + 16),
+			compressed: central.readUInt32LE(at + 20),
+			size: central.readUInt32LE(at + 24),
+			offset: central.readUInt32LE(at + 42)
+		};
+		at += 46 + nameLength + extraLength + commentLength;
+		if (name.endsWith("/") || flags & 1 || entry.method !== 0 && entry.method !== 8) continue;
+		if (entry.size === 4294967295 || entry.compressed === 4294967295) continue;
+		out.push(entry);
+	}
+	return out;
+}
+async function readZipEntry(path, entry) {
+	if (entry.size > COURSE_BUNDLE_LIMITS.maxEntryBytes) throw new Error(`${entry.name} is larger than a bundle member may be.`);
+	const fileSize = await sizeOf(path);
+	if (entry.compressed > COURSE_BUNDLE_LIMITS.maxEntryBytes || entry.offset + 30 + entry.compressed > fileSize) throw new Error(`${entry.name} has an implausible compressed size.`);
+	const local = await readAt(path, entry.offset, 30);
+	if (local.length < 30 || local.readUInt32LE(0) !== LOCAL) throw new Error(`${entry.name} has a damaged local header.`);
+	const data = await readAt(path, entry.offset + 30 + local.readUInt16LE(26) + local.readUInt16LE(28), entry.compressed);
+	if (data.length !== entry.compressed) throw new Error(`${entry.name} is truncated.`);
+	const bytes = entry.method === 0 ? data : inflateRawSync(data, { maxOutputLength: Math.max(entry.size, 1) });
+	if (bytes.length !== entry.size || crc32(bytes) !== entry.crc) throw new Error(`${entry.name} failed its size or checksum check.`);
+	return new Uint8Array(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+}
+var exportOf = (zipName) => /-(\d{8}T\d{6}Z)-/.exec(zipName)?.[1] ?? "";
+function folderClassCrunchLabsSource(directory) {
+	return { async files() {
+		const out = [];
+		const walk = async (dir, depth) => {
+			if (depth > MAX_DEPTH) return;
+			const children = await readdir(dir, { withFileTypes: true });
+			for (const child of children.sort((a, b) => a.name < b.name ? -1 : 1)) {
+				if (child.name.startsWith(".")) continue;
+				const full = join(dir, child.name);
+				if (child.isSymbolicLink()) continue;
+				if (child.isDirectory()) {
+					await walk(full, depth + 1);
+					continue;
+				}
+				if (!child.isFile()) continue;
+				if (/\.zip$/i.test(child.name)) {
+					const exportId = exportOf(child.name);
+					for (const entry of await listZip(full)) out.push({
+						path: entry.name,
+						size: entry.size,
+						crc32: entry.crc.toString(16).padStart(8, "0"),
+						exportId,
+						read: () => readZipEntry(full, entry)
+					});
+					continue;
+				}
+				const size = lstatSync(full).size;
+				out.push({
+					path: relative(directory, full).split(sep).join("/"),
+					size,
+					read: async () => {
+						if (size > COURSE_BUNDLE_LIMITS.maxEntryBytes) throw new Error(`${child.name} is larger than a bundle member may be.`);
+						return new Uint8Array(await readFile(full));
+					}
+				});
+			}
+		};
+		await walk(directory, 0);
+		return out;
+	} };
+}
+//#endregion
+export { folderClassCrunchLabsSource };
+
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","names":[],"sources":["../src/sources/class-crunchlabs-files.ts"],"sourcesContent":["/**\n * Node readers for Class CrunchLabs unit downloads on disk (SMRT #4616): a\n * folder, or the zip parts a Drive export splits it into, or both mixed. Zips\n * are read lazily from their central directory, so a multi-gigabyte part that\n * is mostly video costs only the few entries that are actually used. Server\n * only (`node:fs`, `node:zlib`).\n */\nimport { type Dirent, lstatSync } from 'node:fs';\nimport { open, readdir, readFile } from 'node:fs/promises';\nimport { basename, join, relative, sep } from 'node:path';\nimport { inflateRawSync } from 'node:zlib';\nimport { COURSE_BUNDLE_LIMITS } from '../course-bundle-contracts.js';\nimport { crc32 } from '../course-bundle-zip.js';\nimport type {\n  ClassCrunchLabsFile,\n  ClassCrunchLabsFileSource,\n} from './class-crunchlabs.js';\n\nconst EOCD = 0x06054b50;\nconst CENTRAL = 0x02014b50;\nconst LOCAL = 0x04034b50;\nconst MAX_CENTRAL_DIRECTORY = 16 * 1024 * 1024;\nconst MAX_DEPTH = 8;\n\ninterface ZipEntry {\n  name: string;\n  method: number;\n  crc: number;\n  compressed: number;\n  size: number;\n  offset: number;\n}\n\nasync function readAt(\n  path: string,\n  position: number,\n  length: number,\n): Promise<Buffer> {\n  const handle = await open(path, 'r');\n  try {\n    // Never allocate more than the file can supply, whatever a header claims.\n    const available = Math.max(0, (await handle.stat()).size - position);\n    const buffer = Buffer.alloc(Math.min(length, available));\n    const { bytesRead } = await handle.read(buffer, 0, buffer.length, position);\n    return buffer.subarray(0, bytesRead);\n  } finally {\n    await handle.close();\n  }\n}\n\nasync function sizeOf(path: string): Promise<number> {\n  const handle = await open(path, 'r');\n  try {\n    return (await handle.stat()).size;\n  } finally {\n    await handle.close();\n  }\n}\n\n/** The file entries of a zip, from its central directory alone. */\nasync function listZip(path: string): Promise<ZipEntry[]> {\n  const handle = await open(path, 'r');\n  let total: number;\n  try {\n    total = (await handle.stat()).size;\n  } finally {\n    await handle.close();\n  }\n  const tailLength = Math.min(total, 22 + 0xffff);\n  const tail = await readAt(path, total - tailLength, tailLength);\n  let eocd = -1;\n  for (let i = tail.length - 22; i >= 0; i--) {\n    if (\n      tail.readUInt32LE(i) === EOCD &&\n      i + 22 + tail.readUInt16LE(i + 20) === tail.length\n    ) {\n      eocd = i;\n      break;\n    }\n  }\n  if (eocd === -1) throw new Error(`${basename(path)} is not a readable zip.`);\n  const entries = tail.readUInt16LE(eocd + 10);\n  const size = tail.readUInt32LE(eocd + 12);\n  const offset = tail.readUInt32LE(eocd + 16);\n  if (\n    tail.readUInt16LE(eocd + 4) !== 0 ||\n    tail.readUInt16LE(eocd + 6) !== 0 ||\n    entries === 0xffff ||\n    size === 0xffffffff ||\n    offset === 0xffffffff\n  )\n    throw new Error(`${basename(path)} is a zip64 or multi-disk archive.`);\n  if (size > MAX_CENTRAL_DIRECTORY || offset + size > total)\n    throw new Error(`${basename(path)} has an invalid central directory.`);\n  const central = await readAt(path, offset, size);\n  const out: ZipEntry[] = [];\n  let at = 0;\n  for (let n = 0; n < entries; n++) {\n    if (at + 46 > central.length || central.readUInt32LE(at) !== CENTRAL)\n      throw new Error(`${basename(path)} has a damaged central directory.`);\n    const flags = central.readUInt16LE(at + 8);\n    const nameLength = central.readUInt16LE(at + 28);\n    const extraLength = central.readUInt16LE(at + 30);\n    const commentLength = central.readUInt16LE(at + 32);\n    const name = central.toString('utf8', at + 46, at + 46 + nameLength);\n    const entry: ZipEntry = {\n      name,\n      method: central.readUInt16LE(at + 10),\n      crc: central.readUInt32LE(at + 16),\n      compressed: central.readUInt32LE(at + 20),\n      size: central.readUInt32LE(at + 24),\n      offset: central.readUInt32LE(at + 42),\n    };\n    at += 46 + nameLength + extraLength + commentLength;\n    // Directories, encrypted entries and exotic methods are not unit files.\n    if (\n      name.endsWith('/') ||\n      flags & 1 ||\n      (entry.method !== 0 && entry.method !== 8)\n    )\n      continue;\n    if (entry.size === 0xffffffff || entry.compressed === 0xffffffff) continue;\n    out.push(entry);\n  }\n  return out;\n}\n\nasync function readZipEntry(\n  path: string,\n  entry: ZipEntry,\n): Promise<Uint8Array> {\n  if (entry.size > COURSE_BUNDLE_LIMITS.maxEntryBytes)\n    throw new Error(`${entry.name} is larger than a bundle member may be.`);\n  // A hostile header may claim a payload far beyond the member limit or the file.\n  const fileSize = await sizeOf(path);\n  if (\n    entry.compressed > COURSE_BUNDLE_LIMITS.maxEntryBytes ||\n    entry.offset + 30 + entry.compressed > fileSize\n  )\n    throw new Error(`${entry.name} has an implausible compressed size.`);\n  const local = await readAt(path, entry.offset, 30);\n  if (local.length < 30 || local.readUInt32LE(0) !== LOCAL)\n    throw new Error(`${entry.name} has a damaged local header.`);\n  const start =\n    entry.offset + 30 + local.readUInt16LE(26) + local.readUInt16LE(28);\n  const data = await readAt(path, start, entry.compressed);\n  if (data.length !== entry.compressed)\n    throw new Error(`${entry.name} is truncated.`);\n  const bytes =\n    entry.method === 0\n      ? data\n      : inflateRawSync(data, { maxOutputLength: Math.max(entry.size, 1) });\n  if (bytes.length !== entry.size || crc32(bytes) !== entry.crc)\n    throw new Error(`${entry.name} failed its size or checksum check.`);\n  return new Uint8Array(bytes.buffer, bytes.byteOffset, bytes.byteLength);\n}\n\n/** Drive names parts like `Unit_Class CrunchLabs-20261102T164712Z-1-001.zip`; the timestamp orders exports. */\nconst exportOf = (zipName: string) =>\n  /-(\\d{8}T\\d{6}Z)-/.exec(zipName)?.[1] ?? '';\n\n/**\n * Every unit file under `directory`: plain files, and the entries of any `.zip`\n * (a zip is not expanded into the filesystem, and a zip inside a zip is not\n * opened). Symbolic links are skipped; hidden files are ignored.\n */\nexport function folderClassCrunchLabsSource(\n  directory: string,\n): ClassCrunchLabsFileSource {\n  return {\n    async files() {\n      const out: ClassCrunchLabsFile[] = [];\n      const walk = async (dir: string, depth: number): Promise<void> => {\n        if (depth > MAX_DEPTH) return;\n        const children: Dirent[] = await readdir(dir, { withFileTypes: true });\n        for (const child of children.sort((a, b) =>\n          a.name < b.name ? -1 : 1,\n        )) {\n          if (child.name.startsWith('.')) continue;\n          const full = join(dir, child.name);\n          if (child.isSymbolicLink()) continue;\n          if (child.isDirectory()) {\n            await walk(full, depth + 1);\n            continue;\n          }\n          if (!child.isFile()) continue;\n          if (/\\.zip$/i.test(child.name)) {\n            const exportId = exportOf(child.name);\n            for (const entry of await listZip(full))\n              out.push({\n                path: entry.name,\n                size: entry.size,\n                crc32: entry.crc.toString(16).padStart(8, '0'),\n                exportId,\n                read: () => readZipEntry(full, entry),\n              });\n            continue;\n          }\n          const size = lstatSync(full).size;\n          out.push({\n            path: relative(directory, full).split(sep).join('/'),\n            size,\n            read: async () => {\n              if (size > COURSE_BUNDLE_LIMITS.maxEntryBytes)\n                throw new Error(\n                  `${child.name} is larger than a bundle member may be.`,\n                );\n              return new Uint8Array(await readFile(full));\n            },\n          });\n        }\n      };\n      await walk(directory, 0);\n      return out;\n    },\n  };\n}\n"],"mappings":";;;;;;AAkBA,IAAM,OAAO;AACb,IAAM,UAAU;AAChB,IAAM,QAAQ;AACd,IAAM,wBAAwB,KAAK,OAAO;AAC1C,IAAM,YAAY;AAWlB,eAAe,OACb,MACA,UACA,QACiB;CACjB,MAAM,SAAS,MAAM,KAAK,MAAM,GAAG;CACnC,IAAI;EAEF,MAAM,YAAY,KAAK,IAAI,IAAI,MAAM,OAAO,KAAK,EAAA,CAAG,OAAO,QAAQ;EACnE,MAAM,SAAS,OAAO,MAAM,KAAK,IAAI,QAAQ,SAAS,CAAC;EACvD,MAAM,EAAE,cAAc,MAAM,OAAO,KAAK,QAAQ,GAAG,OAAO,QAAQ,QAAQ;EAC1E,OAAO,OAAO,SAAS,GAAG,SAAS;CACrC,UAAE;EACA,MAAM,OAAO,MAAM;CACrB;AACF;AAEA,eAAe,OAAO,MAA+B;CACnD,MAAM,SAAS,MAAM,KAAK,MAAM,GAAG;CACnC,IAAI;EACF,QAAQ,MAAM,OAAO,KAAK,EAAA,CAAG;CAC/B,UAAE;EACA,MAAM,OAAO,MAAM;CACrB;AACF;AAGA,eAAe,QAAQ,MAAmC;CACxD,MAAM,SAAS,MAAM,KAAK,MAAM,GAAG;CACnC,IAAI;CACJ,IAAI;EACF,SAAS,MAAM,OAAO,KAAK,EAAA,CAAG;CAChC,UAAE;EACA,MAAM,OAAO,MAAM;CACrB;CACA,MAAM,aAAa,KAAK,IAAI,OAAO,KAAW;CAC9C,MAAM,OAAO,MAAM,OAAO,MAAM,QAAQ,YAAY,UAAU;CAC9D,IAAI,OAAO;CACX,KAAA,IAAS,IAAI,KAAK,SAAS,IAAI,KAAK,GAAG,KACrC,IACE,KAAK,aAAa,CAAC,MAAM,QACzB,IAAI,KAAK,KAAK,aAAa,IAAI,EAAE,MAAM,KAAK,QAC5C;EACA,OAAO;EACP;CACF;CAEF,IAAI,SAAS,IAAI,MAAM,IAAI,MAAM,GAAG,SAAS,IAAI,EAAC,wBAAyB;CAC3E,MAAM,UAAU,KAAK,aAAa,OAAO,EAAE;CAC3C,MAAM,OAAO,KAAK,aAAa,OAAO,EAAE;CACxC,MAAM,SAAS,KAAK,aAAa,OAAO,EAAE;CAC1C,IACE,KAAK,aAAa,OAAO,CAAC,MAAM,KAChC,KAAK,aAAa,OAAO,CAAC,MAAM,KAChC,YAAY,SACZ,SAAS,cACT,WAAW,YAEX,MAAM,IAAI,MAAM,GAAG,SAAS,IAAI,EAAC,mCAAoC;CACvE,IAAI,OAAO,yBAAyB,SAAS,OAAO,OAClD,MAAM,IAAI,MAAM,GAAG,SAAS,IAAI,EAAC,mCAAoC;CACvE,MAAM,UAAU,MAAM,OAAO,MAAM,QAAQ,IAAI;CAC/C,MAAM,MAAkB,CAAC;CACzB,IAAI,KAAK;CACT,KAAA,IAAS,IAAI,GAAG,IAAI,SAAS,KAAK;EAChC,IAAI,KAAK,KAAK,QAAQ,UAAU,QAAQ,aAAa,EAAE,MAAM,SAC3D,MAAM,IAAI,MAAM,GAAG,SAAS,IAAI,EAAC,kCAAmC;EACtE,MAAM,QAAQ,QAAQ,aAAa,KAAK,CAAC;EACzC,MAAM,aAAa,QAAQ,aAAa,KAAK,EAAE;EAC/C,MAAM,cAAc,QAAQ,aAAa,KAAK,EAAE;EAChD,MAAM,gBAAgB,QAAQ,aAAa,KAAK,EAAE;EAClD,MAAM,OAAO,QAAQ,SAAS,QAAQ,KAAK,IAAI,KAAK,KAAK,UAAU;EACnE,MAAM,QAAkB;GACtB;GACA,QAAQ,QAAQ,aAAa,KAAK,EAAE;GACpC,KAAK,QAAQ,aAAa,KAAK,EAAE;GACjC,YAAY,QAAQ,aAAa,KAAK,EAAE;GACxC,MAAM,QAAQ,aAAa,KAAK,EAAE;GAClC,QAAQ,QAAQ,aAAa,KAAK,EAAE;EACtC;EACA,MAAM,KAAK,aAAa,cAAc;EAEtC,IACE,KAAK,SAAS,GAAG,KACjB,QAAQ,KACP,MAAM,WAAW,KAAK,MAAM,WAAW,GAExC;EACF,IAAI,MAAM,SAAS,cAAc,MAAM,eAAe,YAAY;EAClE,IAAI,KAAK,KAAK;CAChB;CACA,OAAO;AACT;AAEA,eAAe,aACb,MACA,OACqB;CACrB,IAAI,MAAM,OAAO,qBAAqB,eACpC,MAAM,IAAI,MAAM,GAAG,MAAM,KAAI,wCAAyC;CAExE,MAAM,WAAW,MAAM,OAAO,IAAI;CAClC,IACE,MAAM,aAAa,qBAAqB,iBACxC,MAAM,SAAS,KAAK,MAAM,aAAa,UAEvC,MAAM,IAAI,MAAM,GAAG,MAAM,KAAI,qCAAsC;CACrE,MAAM,QAAQ,MAAM,OAAO,MAAM,MAAM,QAAQ,EAAE;CACjD,IAAI,MAAM,SAAS,MAAM,MAAM,aAAa,CAAC,MAAM,OACjD,MAAM,IAAI,MAAM,GAAG,MAAM,KAAI,6BAA8B;CAG7D,MAAM,OAAO,MAAM,OAAO,MADxB,MAAM,SAAS,KAAK,MAAM,aAAa,EAAE,IAAI,MAAM,aAAa,EAAE,GAC7B,MAAM,UAAU;CACvD,IAAI,KAAK,WAAW,MAAM,YACxB,MAAM,IAAI,MAAM,GAAG,MAAM,KAAI,eAAgB;CAC/C,MAAM,QACJ,MAAM,WAAW,IACb,OACA,eAAe,MAAM,EAAE,iBAAiB,KAAK,IAAI,MAAM,MAAM,CAAC,EAAE,CAAC;CACvE,IAAI,MAAM,WAAW,MAAM,QAAQ,MAAM,KAAK,MAAM,MAAM,KACxD,MAAM,IAAI,MAAM,GAAG,MAAM,KAAI,oCAAqC;CACpE,OAAO,IAAI,WAAW,MAAM,QAAQ,MAAM,YAAY,MAAM,UAAU;AACxE;AAGA,IAAM,YAAY,YAChB,mBAAmB,KAAK,OAAO,CAAA,GAAI,MAAM;AAOpC,SAAS,4BACd,WAC2B;CAC3B,OAAO,EACL,MAAM,QAAQ;EACZ,MAAM,MAA6B,CAAC;EACpC,MAAM,OAAO,OAAO,KAAa,UAAiC;GAChE,IAAI,QAAQ,WAAW;GACvB,MAAM,WAAqB,MAAM,QAAQ,KAAK,EAAE,eAAe,KAAK,CAAC;GACrE,KAAA,MAAW,SAAS,SAAS,MAAM,GAAG,MACpC,EAAE,OAAO,EAAE,OAAO,KAAK,CACzB,GAAG;IACD,IAAI,MAAM,KAAK,WAAW,GAAG,GAAG;IAChC,MAAM,OAAO,KAAK,KAAK,MAAM,IAAI;IACjC,IAAI,MAAM,eAAe,GAAG;IAC5B,IAAI,MAAM,YAAY,GAAG;KACvB,MAAM,KAAK,MAAM,QAAQ,CAAC;KAC1B;IACF;IACA,IAAI,CAAC,MAAM,OAAO,GAAG;IACrB,IAAI,UAAU,KAAK,MAAM,IAAI,GAAG;KAC9B,MAAM,WAAW,SAAS,MAAM,IAAI;KACpC,KAAA,MAAW,SAAS,MAAM,QAAQ,IAAI,GACpC,IAAI,KAAK;MACP,MAAM,MAAM;MACZ,MAAM,MAAM;MACZ,OAAO,MAAM,IAAI,SAAS,EAAE,CAAA,CAAE,SAAS,GAAG,GAAG;MAC7C;MACA,YAAY,aAAa,MAAM,KAAK;KACtC,CAAC;KACH;IACF;IACA,MAAM,OAAO,UAAU,IAAI,CAAA,CAAE;IAC7B,IAAI,KAAK;KACP,MAAM,SAAS,WAAW,IAAI,CAAA,CAAE,MAAM,GAAG,CAAA,CAAE,KAAK,GAAG;KACnD;KACA,MAAM,YAAY;MAChB,IAAI,OAAO,qBAAqB,eAC9B,MAAM,IAAI,MACR,GAAG,MAAM,KAAI,wCACf;MACF,OAAO,IAAI,WAAW,MAAM,SAAS,IAAI,CAAC;KAC5C;IACF,CAAC;GACH;EACF;EACA,MAAM,KAAK,WAAW,CAAC;EACvB,OAAO;CACT,EACF;AACF"}