@happyvertical/smrt-education 0.57.8 → 0.57.10

package/dist/source-import-service.d.ts

@@ -6,11 +6,13 @@ export interface SourceImportRequest {
     sourceId: string;
     /** Host-stable identity, independent of the page's current URL. */
     courseRef: string;
+    /** Optional trusted catalog classification retained on the tenant course. */
+    subject?: string;
     pageUrl: string;
     destination: 'private' | 'group';
 }
 export interface SourceImportAuthorization {
-    action: 'education.source.import';
+    action: 'education.source.import' | 'education.source.ensure';
     actorTenantId: string;
     actorUserId: string;
     sourceId: string;
@@ -36,6 +38,13 @@ export interface SourceImportResult {
     /** Source-hosted packet link, returned without fetching or persisting its content. */
     packetUrl?: string;
 }
+export interface EnsureEasyPeasyCourseSourceRequest {
+    tenantId: string;
+    actorUserId: string;
+}
+export interface EnsureEasyPeasyCourseSourceResult {
+    sourceId: string;
+}
 /** Opt-in, pointer-only import. Host authorization defines family/group roles. */
 export declare class SourceImportService {
     private readonly db;
@@ -43,6 +52,7 @@ export declare class SourceImportService {
     private easyPeasy?;
     constructor(db: DatabaseInterface, authorize: SourceImportAuthorizer);
     registerEasyPeasy(registration: EasyPeasyRegistration): void;
+    ensureEasyPeasyCourseSource(input: EnsureEasyPeasyCourseSourceRequest): Promise<EnsureEasyPeasyCourseSourceResult>;
     private actor;
     private source;
     importCourse(input: SourceImportRequest): Promise<SourceImportResult>;

package/dist/source-import-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source-import-service.d.ts","sourceRoot":"","sources":["../src/source-import-service.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAW5D,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAM5B,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,SAAS,GAAG,OAAO,CAAC;CAClC;AACD,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,yBAAyB,CAAC;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,aAAa,CAAC;IAC7B,WAAW,EAAE,SAAS,GAAG,OAAO,CAAC;IACjC,eAAe,EAAE,MAAM,CAAC;CACzB;AACD,MAAM,MAAM,sBAAsB,GAAG,CACnC,OAAO,EAAE,yBAAyB,KAC/B,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAChC,MAAM,WAAW,qBAAqB;IACpC,kFAAkF;IAClF,aAAa,EAAE,IAAI,CAAC;IACpB,gFAAgF;IAChF,SAAS,EAAE,CACT,GAAG,EAAE,MAAM,EACX,OAAO,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,KAC3B,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7C;AACD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,sFAAsF;IACtF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAuDD,kFAAkF;AAClF,qBAAa,mBAAmB;IAG5B,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAH5B,OAAO,CAAC,SAAS,CAAC,CAAkC;gBAEjC,EAAE,EAAE,iBAAiB,EACrB,SAAS,EAAE,sBAAsB;IAGpD,iBAAiB,CAAC,YAAY,EAAE,qBAAqB,GAAG,IAAI;IAc5D,OAAO,CAAC,KAAK;YAsBC,MAAM;IAwCd,YAAY,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CA6J5E"}
+{"version":3,"file":"source-import-service.d.ts","sourceRoot":"","sources":["../src/source-import-service.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAW5D,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAM5B,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,SAAS,GAAG,OAAO,CAAC;CAClC;AACD,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,yBAAyB,GAAG,yBAAyB,CAAC;IAC9D,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,aAAa,CAAC;IAC7B,WAAW,EAAE,SAAS,GAAG,OAAO,CAAC;IACjC,eAAe,EAAE,MAAM,CAAC;CACzB;AACD,MAAM,MAAM,sBAAsB,GAAG,CACnC,OAAO,EAAE,yBAAyB,KAC/B,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAChC,MAAM,WAAW,qBAAqB;IACpC,kFAAkF;IAClF,aAAa,EAAE,IAAI,CAAC;IACpB,gFAAgF;IAChF,SAAS,EAAE,CACT,GAAG,EAAE,MAAM,EACX,OAAO,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,KAC3B,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7C;AACD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,sFAAsF;IACtF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AACD,MAAM,WAAW,kCAAkC;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AACD,MAAM,WAAW,iCAAiC;IAChD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAuDD,kFAAkF;AAClF,qBAAa,mBAAmB;IAG5B,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAH5B,OAAO,CAAC,SAAS,CAAC,CAAkC;gBAEjC,EAAE,EAAE,iBAAiB,EACrB,SAAS,EAAE,sBAAsB;IAGpD,iBAAiB,CAAC,YAAY,EAAE,qBAAqB,GAAG,IAAI;IActD,2BAA2B,CAC/B,KAAK,EAAE,kCAAkC,GACxC,OAAO,CAAC,iCAAiC,CAAC;IA8E7C,OAAO,CAAC,KAAK;YAwBC,MAAM;IAwCd,YAAY,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CA+J5E"}

package/dist/sources/easy-peasy-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"easy-peasy-parser.d.ts","sourceRoot":"","sources":["../../src/sources/easy-peasy-parser.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAOD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAY5E;AAiLD,oFAAoF;AACpF,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,kBAAkB,CA+CpB"}
+{"version":3,"file":"easy-peasy-parser.d.ts","sourceRoot":"","sources":["../../src/sources/easy-peasy-parser.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAOD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAY5E;AA+ZD,oFAAoF;AACpF,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,kBAAkB,CA0DpB"}

package/dist/sources/google-drive-adapter.d.ts

@@ -0,0 +1,125 @@
+import type { DriveAcquisition, DriveAcquisitionOptions, DriveFileMetadata, DriveMetadataPage, DriveMetadataPageOptions, GoogleDriveProvider } from '@happyvertical/files';
+import type { CatalogAcquireAdapter, CatalogSourceRecord, CatalogSyncAdapter, CatalogSyncPage } from '../catalog-contracts.js';
+export type { DriveAcquisition, DriveAcquisitionOptions, DriveFileMetadata, DriveMetadataPage, DriveMetadataPageOptions, };
+/**
+ * Metadata-only Google Drive curriculum discovery.
+ *
+ * This module deliberately accepts the public @happyvertical/files Drive
+ * surface as a port. Hosts construct that SDK provider with their own
+ * application credentials and pass it here; neither discovery records nor
+ * checkpoints contain credentials or downloaded content.
+ */
+export declare const DRIVE_CURRICULUM_SEED_ROOTS: readonly [{
+    readonly id: "1K_au1upSRuakX55PF3aZzQLHWI70KwZd";
+    readonly title: "Carnival of Collisions (Contact Forces)";
+}, {
+    readonly id: "1N1xFJ2omm-M1TuAxDOXQxZndkw70-KxM";
+    readonly title: "Mission Maglev (Electric and Magnetic Forces)";
+}, {
+    readonly id: "1v0LXs7iky2R4FsiqZkWOjWyJmRu-aVIa";
+    readonly title: "Rocks vs. Big Rigs, Unit-Wide View";
+}, {
+    readonly id: "1sFDNXdw8q-xrhgy8HFAMELXUoqKgp9tu";
+    readonly title: "Operation Space Jump (Gravitational Forces)";
+}];
+/** The adapter only uses public SDK methods, never a raw Google API client. */
+export type GoogleDriveFilesClient = Pick<GoogleDriveProvider, 'listMetadataPage' | 'getMetadataById' | 'acquireById'>;
+export interface DriveCatalogRecord extends CatalogSourceRecord {
+    providerId: 'google-drive';
+    checksum?: string;
+    mimeType: string;
+    size?: number;
+    modifiedTime?: string;
+}
+export interface DriveExclusion {
+    stableId: string;
+    reason: 'missing-revision' | 'shortcut-target-inaccessible' | 'shortcut-target-outside-boundary' | 'shortcut-target-unsupported';
+}
+interface FolderCursor {
+    folderId: string;
+    pageToken?: string;
+    visibility: 'catalog' | 'teacher';
+}
+/** Serializable traversal state; persist it after every returned page. */
+export interface DriveDiscoveryCheckpoint {
+    version: 1;
+    roots: string[];
+    pendingFolders: FolderCursor[];
+    visitedFolders: string[];
+}
+export interface DriveDiscoveryPage {
+    records: DriveCatalogRecord[];
+    exclusions: DriveExclusion[];
+    checkpoint?: DriveDiscoveryCheckpoint;
+    complete: boolean;
+}
+export interface DriveDiscoveryOptions {
+    /** Defaults to the four owner-authorized curriculum roots. */
+    roots?: readonly {
+        id: string;
+        title?: string;
+    }[];
+    checkpoint?: DriveDiscoveryCheckpoint;
+    pageSize?: number;
+    /**
+     * Exact Drive file IDs the trusted host has reviewed as learner-safe.
+     * Folder IDs never grant visibility to their contents.
+     */
+    studentSafeFileIds?: readonly string[];
+    /**
+     * Shortcut targets are re-read by ID and must pass this host boundary check
+     * before a folder can enter traversal. The secure default is deny.
+     */
+    authorizeShortcutTarget?: (target: DriveFileMetadata, context: {
+        sourceFolderId: string;
+        configuredRootIds: readonly string[];
+    }) => boolean | Promise<boolean>;
+}
+export interface DriveSelectionAuthorization {
+    stableId: string;
+    revision: string;
+    exportMimeType?: string;
+    /** True only after the host's resource-level license policy allows use. */
+    allowed: boolean;
+}
+export interface PinnedDriveContent {
+    stableId: string;
+    revision?: string;
+    checksum?: string;
+    sha256: string;
+    bytes: Buffer;
+    exportMimeType?: string;
+}
+/**
+ * One call reads at most one Drive metadata page. Repeated calls with the
+ * returned checkpoint provide durable pagination without content acquisition.
+ */
+export declare class GoogleDriveCurriculumAdapter implements CatalogSyncAdapter, CatalogAcquireAdapter {
+    private readonly drive;
+    private readonly configuration;
+    static readonly providerId = "google-drive";
+    constructor(drive: GoogleDriveFilesClient, configuration?: Omit<DriveDiscoveryOptions, 'checkpoint'> & {
+        maxAcquisitionBytes?: number;
+    });
+    enumerate(input: {
+        cursor?: string;
+    }): Promise<CatalogSyncPage>;
+    discover(options?: DriveDiscoveryOptions): Promise<DriveDiscoveryPage>;
+    private resolveShortcut;
+    /**
+     * Content is available only after explicit selection and policy approval.
+     * A revision is mandatory so retries cannot silently acquire changed bytes.
+     */
+    acquireSelected(authorization: DriveSelectionAuthorization, options: Omit<DriveAcquisitionOptions, 'expectedRevision'>): Promise<PinnedDriveContent>;
+    acquire(input: {
+        providerId: string;
+        stableId: string;
+        revision: string;
+        format: string;
+    }): Promise<{
+        bytes: Uint8Array;
+        sha256: string;
+        revision: string;
+    }>;
+}
+//# sourceMappingURL=google-drive-adapter.d.ts.map

package/dist/sources/google-drive-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-drive-adapter.d.ts","sourceRoot":"","sources":["../../src/sources/google-drive-adapter.ts"],"names":[],"mappings":"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"}

package/dist/sources/illustrative-mathematics-parser.d.ts

@@ -0,0 +1,8 @@
+import type { CatalogSourceRecord } from '../catalog-contracts.js';
+/**
+ * Parses the publicly linked K-5 family curriculum index published by the IM
+ * Certified Kendall Hunt site. It is deliberately metadata-only: unit and
+ * lesson pages are not fetched or acquired here.
+ */
+export declare function parseIllustrativeMathematicsK5Index(html: string, revision: string, pageUrl?: string): CatalogSourceRecord[];
+//# sourceMappingURL=illustrative-mathematics-parser.d.ts.map

package/dist/sources/illustrative-mathematics-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"illustrative-mathematics-parser.d.ts","sourceRoot":"","sources":["../../src/sources/illustrative-mathematics-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAWnE;;;;GAIG;AACH,wBAAgB,mCAAmC,CACjD,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,SAAkD,GACxD,mBAAmB,EAAE,CAyDvB"}

package/dist/sources/oer-commons-rss-parser.d.ts

@@ -0,0 +1,8 @@
+import type { CatalogSourceRecord } from '../catalog-contracts.js';
+/**
+ * Parses a configured OER Commons/ISKME RSS or Dublin Core feed without entity
+ * expansion or external resolution. The configured feed is authoritative for
+ * scope; this parser never represents its page as global catalog coverage.
+ */
+export declare function parseOerCommonsRssFeed(xml: string, revision: string): CatalogSourceRecord[];
+//# sourceMappingURL=oer-commons-rss-parser.d.ts.map

package/dist/sources/oer-commons-rss-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oer-commons-rss-parser.d.ts","sourceRoot":"","sources":["../../src/sources/oer-commons-rss-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AA8DnE;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GACf,mBAAmB,EAAE,CA4CvB"}

package/dist/submission-service.d.ts

@@ -2,7 +2,7 @@ import { type AssetRuntimeOptions } from '@happyvertical/smrt-assets';
 import type { DatabaseInterface } from '@happyvertical/sql';
 import type { CatalogAuthorizer } from './catalog-service.js';
 import { type LearnerAuthorizer, type LearnerRequest, LearnerService } from './learner-service.js';
-import type { Grade, Submission } from './submissions.js';
+import type { Grade, Submission, SubmissionKind } from './submissions.js';
 /** A single captured page. No model patches or pre-existing asset IDs are accepted. */
 export interface SubmissionPage {
     name: string;
@@ -18,6 +18,12 @@ export interface SubmissionAssetClaim {
     assetId: string;
     expiresAt: Date;
 }
+/** Immutable external receipt binding for a scan; supplied only by a trusted host. */
+export interface SubmissionIntake {
+    intakeItemId: string;
+    kind: SubmissionKind;
+    previousSubmissionId?: string;
+}
 /** Server configuration; never populate this from request JSON. */
 export interface SubmissionServiceOptions {
     storage: AssetRuntimeOptions['storage'];
@@ -33,6 +39,9 @@ export type SubmissionView = Readonly<{
     status: Submission['status'];
     submittedAt: Date;
     notes: string;
+    kind: SubmissionKind;
+    previousSubmissionId: string | null;
+    intakeItemId: string | null;
     pages: ReadonlyArray<{
         assetId: string;
         sortOrder: number;
@@ -71,10 +80,31 @@ export declare class SubmissionService extends LearnerService {
     private progress;
     private requireSubmission;
     private view;
+    /** Recheck the exact assignment without creating progress or accepting bytes.
+     * Trusted intake bridges call this before reading retained evidence.
+     */
+    assertLessonAssignment(request: LessonRequest): Promise<void>;
     captureSubmission(request: LessonRequest & {
         requestKey: string;
         pages: readonly SubmissionPage[];
         notes?: string;
+        /** Trusted ingestion identity; ordinary host upload omits this. */
+        intake?: SubmissionIntake;
+    }): Promise<SubmissionView>;
+    /** Capture a blank workbook scan without claiming completion or a grade. */
+    captureBlankReference(request: LessonRequest & {
+        requestKey: string;
+        pages: readonly SubmissionPage[];
+        notes?: string;
+        intakeItemId: string;
+    }): Promise<SubmissionView>;
+    /** Rescan corrections as a new immutable completed-work attempt. */
+    resubmitSubmission(request: LessonRequest & {
+        previousSubmissionId: string;
+        requestKey: string;
+        pages: readonly SubmissionPage[];
+        notes?: string;
+        intakeItemId: string;
     }): Promise<SubmissionView>;
     getSubmission(request: SubmissionRequest): Promise<SubmissionView>;
     private grade;
@@ -82,6 +112,16 @@ export declare class SubmissionService extends LearnerService {
         score?: number | null;
         feedback?: string;
     }): Promise<SubmissionView>;
+    /** Bridge-only alias: uses the same guardian authorization and current-attempt checks. */
+    applyReviewedSubmission(request: SubmissionRequest & {
+        score?: number | null;
+        feedback?: string;
+    }): Promise<SubmissionView>;
+    /** Record a non-authoritative automated proposal; it never completes progress. */
+    proposeSubmissionGrade(request: SubmissionRequest & {
+        score?: number | null;
+        feedback?: string;
+    }): Promise<SubmissionView>;
     attestLesson(request: LessonRequest & {
         score?: number | null;
         feedback?: string;
@@ -92,6 +132,13 @@ export declare class SubmissionService extends LearnerService {
         url: string;
         expiresAt: Date;
     }>;
+    /** Sign only an exact authorized printable join; answer keys never qualify. */
+    signLessonPrintable(request: LessonRequest & {
+        assetId: string;
+    }): Promise<{
+        url: string;
+        expiresAt: Date;
+    }>;
     /** Extract inclusive one-based, disjoint ranges into private worksheet PDFs. */
     splitWorksheetPacket(request: LearnerRequest & {
         courseId: string;

package/dist/submission-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"submission-service.d.ts","sourceRoot":"","sources":["../src/submission-service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"submission-service.d.ts","sourceRoot":"","sources":["../src/submission-service.ts"],"names":[],"mappings":"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"}

package/dist/submissions.d.ts

@@ -3,6 +3,8 @@ export type SubmissionStatus = 'captured' | 'extracting' | 'needs_review' | 'gra
 export type ExternalCompletionReporter = 'learner' | 'guardian' | 'source';
 export type SubmissionAssetRelationship = 'page' | 'attachment';
 export type GraderKind = 'auto' | 'ai' | 'guardian' | 'instructor';
+/** Blank workbook evidence is deliberately distinct from completed work. */
+export type SubmissionKind = 'blank_reference' | 'completed_work';
 /** Evidence that a learner completed one progress item. */
 export declare class Submission extends SmrtObject {
     tenantId: string;
@@ -16,6 +18,22 @@ export declare class Submission extends SmrtObject {
     captureKey: string;
     /** Service-owned content digest used to detect changed retry payloads. */
     captureDigest: string;
+    /** A retained blank workbook reference never becomes a completed attempt. */
+    kind: SubmissionKind;
+    /** Immutable predecessor for a correction/rescan chain. */
+    previousSubmissionId: string | null;
+    /** Stable external intake identity, unique in service scope when supplied. */
+    intakeItemId: string | null;
+    constructor(options?: Record<string, unknown>);
+    save(): Promise<this>;
+}
+/** Durable tenant/item claim for trusted ingestion receipts. This separate table
+ * keeps ordinary uploads (which have no intake item) out of the uniqueness key.
+ */
+export declare class SubmissionIntakeBinding extends SmrtObject {
+    tenantId: string;
+    intakeItemId: string;
+    submissionId: string;
     constructor(options?: Record<string, unknown>);
     save(): Promise<this>;
 }

package/dist/submissions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"submissions.d.ts","sourceRoot":"","sources":["../src/submissions.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAiElC,MAAM,MAAM,gBAAgB,GACxB,UAAU,GACV,YAAY,GACZ,cAAc,GACd,QAAQ,GACR,UAAU,CAAC;AACf,MAAM,MAAM,0BAA0B,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;AAC3E,MAAM,MAAM,2BAA2B,GAAG,MAAM,GAAG,YAAY,CAAC;AAChE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,IAAI,GAAG,UAAU,GAAG,YAAY,CAAC;AAEnE,2DAA2D;AAC3D,qBAEa,UAAW,SAAQ,UAAU;IAC5B,QAAQ,SAAM;IACiB,SAAS,SAAM;IAChB,QAAQ,SAAM;IACN,UAAU,SAAM;IAClE,WAAW,OAAc;IACzB,MAAM,EAAE,gBAAgB,CAAc;IACtC,KAAK,SAAM;IACX,8EAA8E;IAC9E,UAAU,SAAM;IAChB,0EAA0E;IAC1E,aAAa,SAAM;gBAEP,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAKlC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CA0BrC;AAED,oDAAoD;AACpD,qBACa,iBAAkB,SAAQ,UAAU;IAC/C,SAAS,SAAK;IACd,OAAO,SAAM;IACb,SAAS,SAAQ;gBAEL,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAKjD,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIvC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAInC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAIrC;AAED,wEAAwE;AACxE,qBACa,kBAAmB,SAAQ,UAAU;IAChD,UAAU,EAAE,0BAA0B,CAAa;IACnD,WAAW,SAAM;IACW,aAAa,SAAO;gBAEpC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAKlC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAKrC;AAED,sDAAsD;AACtD,qBACa,WAAY,SAAQ,UAAU;CAAG;AAE9C,uDAAuD;AACvD,qBAMa,eAAgB,SAAQ,UAAU;IACjC,QAAQ,SAAM;IACoB,YAAY,SAAM;IAEhE,OAAO,SAAM;IACc,YAAY,EAAE,2BAA2B,CAAU;IAC9E,SAAS,SAAK;gBAEF,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAKlC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CA8BrC;AAED,kFAAkF;AAClF,qBAEa,KAAM,SAAQ,UAAU;IACvB,QAAQ,SAAM;IACoB,YAAY,SAAM;IACrC,UAAU,EAAE,UAAU,CAAU;IAE3D,eAAe,EAAE,MAAM,GAAG,IAAI,CAAQ;IACM,KAAK,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAChE;IACqC,cAAc,EAAE,MAAM,GAAG,IAAI,CAClE;IACP,aAAa,SAAQ;IACrB,QAAQ,SAAM;IACd,QAAQ,OAAc;gBAEV,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAKjD,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI3C,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIvC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CA0BrC"}
+{"version":3,"file":"submissions.d.ts","sourceRoot":"","sources":["../src/submissions.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-education",
-  "version": "0.57.8",
+  "version": "0.57.10",
   "smrtJsdoc": "strict",
   "description": "Tenant-aware learning catalog models and authorized catalog access for SMRT",
   "type": "module",
@@ -18,19 +18,25 @@
       "import": "./dist/index.js"
     },
     "./manifest": "./dist/manifest.json",
-    "./manifest.json": "./dist/manifest.json"
+    "./manifest.json": "./dist/manifest.json",
+    "./ingestion": {
+      "types": "./dist/ingestion.d.ts",
+      "import": "./dist/ingestion.js"
+    }
   },
   "dependencies": {
-    "@happyvertical/smrt-assets": "0.57.8",
-    "@happyvertical/smrt-core": "0.57.8",
-    "@happyvertical/smrt-profiles": "0.57.8",
-    "@happyvertical/smrt-tenancy": "0.57.8",
-    "@happyvertical/smrt-users": "0.57.8",
-    "@happyvertical/sql": "^0.105.2",
-    "pdf-lib": "1.17.1"
+    "@happyvertical/smrt-assets": "0.57.10",
+    "@happyvertical/smrt-core": "0.57.10",
+    "@happyvertical/smrt-profiles": "0.57.10",
+    "@happyvertical/smrt-tenancy": "0.57.10",
+    "@happyvertical/smrt-users": "0.57.10",
+    "@happyvertical/files": "^0.105.3",
+    "@happyvertical/sql": "^0.105.3",
+    "pdf-lib": "1.17.1",
+    "@happyvertical/smrt-ingestion": "0.57.10"
   },
   "devDependencies": {
-    "@happyvertical/smrt-vitest": "0.57.8",
+    "@happyvertical/smrt-vitest": "0.57.10",
     "@types/node": "24.13.6",
     "typescript": "6.0.3",
     "vite": "8.1.4",