@happyvertical/smrt-education 0.57.33 → 0.57.34

package/dist/workbook-photo-ingestion.d.ts

@@ -0,0 +1,70 @@
+import type { OperationHandler } from '@happyvertical/smrt-ingestion/execution';
+import { type IngestionScope, type IngestionService, type ReceiveInput } from '@happyvertical/smrt-ingestion/server';
+import { processEducationAnalysis } from './ingestion.js';
+import type { LearnerRequest } from './learner-service.js';
+import { type WorkbookPhotoService } from './workbook-photo-service.js';
+export declare const WORKBOOK_PHOTO_HANDLER = "@happyvertical/smrt-education:identify-workbook-photo";
+/** Generation proposes material identity only; execution never writes educational outcomes. */
+export declare function workbookPhotoIntakeHandlers(input: {
+    workbooks: WorkbookPhotoService;
+    request: LearnerRequest;
+}): OperationHandler[];
+/** Candidate freshness and authorization on ingestion's supplied executor. */
+export declare function workbookPhotoIntakeTargetResolver(input: {
+    workbooks: WorkbookPhotoService;
+    request: LearnerRequest;
+}): import('@happyvertical/smrt-ingestion/execution').IntakeExecutionOptions['assertTarget'];
+/** Receive before asking for workbook selection; duplicate receipts repair interrupted copying. */
+export declare function receiveWorkbookPhotoIntake(input: {
+    ingestion: IngestionService;
+    scope: Readonly<IngestionScope>;
+    workbooks: WorkbookPhotoService;
+    request: LearnerRequest;
+    receive: ReceiveInput;
+}): Promise<{
+    receipt: import("@happyvertical/smrt-ingestion").ReceiptResult;
+    intake: null;
+} | {
+    receipt: {
+        kind: "accepted" | "duplicate";
+        itemId: string;
+        receiptVersion: number;
+    };
+    intake: import("./workbook-photo-contracts.js").WorkbookPhotoIntakeView;
+}>;
+/** Recovery after a receive succeeded but the private education copy was interrupted. */
+export declare function retainWorkbookPhotoReceipt(input: {
+    ingestion: IngestionService;
+    scope: Readonly<IngestionScope>;
+    workbooks: WorkbookPhotoService;
+    request: LearnerRequest;
+    itemId: string;
+}): Promise<import("./workbook-photo-contracts.js").WorkbookPhotoIntakeView>;
+/** Transfer immutable provider provenance; malformed/ambiguous/failed results stay pending. */
+export declare function preserveWorkbookPhotoIdentification(input: {
+    ingestion: IngestionService;
+    scope: Readonly<IngestionScope>;
+    workbooks: WorkbookPhotoService;
+    request: LearnerRequest & {
+        intakeId: string;
+    };
+}): Promise<import("./workbook-photo-contracts.js").WorkbookPhotoIntakeView>;
+/** Existing durable extraction/interpretation dispatcher, followed by preservation. */
+export declare function processWorkbookPhotoAnalysis(input: Parameters<typeof processEducationAnalysis>[0] & {
+    scope: Readonly<IngestionScope>;
+    workbooks: WorkbookPhotoService;
+    request: LearnerRequest & {
+        intakeId: string;
+    };
+}): Promise<{
+    processing: {
+        kind: "unclaimed" | "extraction_incomplete" | "interpreted";
+    } | {
+        kind: "generation_queued";
+        revision: number;
+    };
+    intake: import("./workbook-photo-contracts.js").WorkbookPhotoIntakeView;
+    capture: import("./workbook-contracts.js").WorkbookAttemptView | null;
+    assessmentRequired: boolean;
+}>;
+//# sourceMappingURL=workbook-photo-ingestion.d.ts.map

package/dist/workbook-photo-ingestion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workbook-photo-ingestion.d.ts","sourceRoot":"","sources":["../src/workbook-photo-ingestion.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,gBAAgB,EAErB,KAAK,YAAY,EAClB,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAM3D,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,6BAA6B,CAAC;AAGrC,eAAO,MAAM,sBAAsB,0DACsB,CAAC;AAsF1D,+FAA+F;AAC/F,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,SAAS,EAAE,oBAAoB,CAAC;IAChC,OAAO,EAAE,cAAc,CAAC;CACzB,GAAG,gBAAgB,EAAE,CA6GrB;AAID,8EAA8E;AAC9E,wBAAgB,iCAAiC,CAAC,KAAK,EAAE;IACvD,SAAS,EAAE,oBAAoB,CAAC;IAChC,OAAO,EAAE,cAAc,CAAC;CACzB,GAAG,OAAO,yCAAyC,EAAE,sBAAsB,CAAC,cAAc,CAAC,CAwB3F;AACD,mGAAmG;AACnG,wBAAsB,0BAA0B,CAAC,KAAK,EAAE;IACtD,SAAS,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IAChC,SAAS,EAAE,oBAAoB,CAAC;IAChC,OAAO,EAAE,cAAc,CAAC;IACxB,OAAO,EAAE,YAAY,CAAC;CACvB;;;;;;;;;;GAWA;AACD,yFAAyF;AACzF,wBAAsB,0BAA0B,CAAC,KAAK,EAAE;IACtD,SAAS,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IAChC,SAAS,EAAE,oBAAoB,CAAC;IAChC,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB,4EA2CA;AACD,+FAA+F;AAC/F,wBAAsB,mCAAmC,CAAC,KAAK,EAAE;IAC/D,SAAS,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IAChC,SAAS,EAAE,oBAAoB,CAAC;IAChC,OAAO,EAAE,cAAc,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD,4EAsFA;AACD,uFAAuF;AACvF,wBAAsB,4BAA4B,CAChD,KAAK,EAAE,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC,CAAC,CAAC,GAAG;IACtD,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IAChC,SAAS,EAAE,oBAAoB,CAAC;IAChC,OAAO,EAAE,cAAc,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD;;;;;;;;;;GA0BF"}

package/dist/workbook-photo-models.d.ts

@@ -0,0 +1,63 @@
+import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
+/** Durable receipt before any course, enrollment or activity exists. */
+export declare class WorkbookPhotoIntake extends SmrtObject {
+    tenantId: string;
+    learnerId: string;
+    delete(): Promise<void>;
+    itemId: string;
+    actorUserId: string;
+    contentDigest: string;
+    save(): Promise<this>;
+    constructor(options?: Record<string, unknown>);
+}
+export declare class WorkbookPhotoIntakeCollection extends SmrtCollection<WorkbookPhotoIntake> {
+    static readonly _itemClass: typeof WorkbookPhotoIntake;
+}
+/** Sole owner join for original photo intake files. */
+export declare class WorkbookPhotoAsset extends SmrtObject {
+    tenantId: string;
+    learnerId: string;
+    delete(): Promise<void>;
+    intakeId: string;
+    assetId: string;
+    name: string;
+    mimeType: string;
+    sha256: string;
+    position: number;
+    constructor(options?: Record<string, unknown>);
+    save(): Promise<this>;
+}
+export declare class WorkbookPhotoAssetCollection extends SmrtCollection<WorkbookPhotoAsset> {
+    static readonly _itemClass: typeof WorkbookPhotoAsset;
+}
+/** Immutable provider/guardian/capture decision, retaining provenance and retry key. */
+export declare class WorkbookPhotoDecision extends SmrtObject {
+    tenantId: string;
+    learnerId: string;
+    delete(): Promise<void>;
+    intakeId: string;
+    requestKey: string;
+    sequence: number;
+    actorUserId: string;
+    bodyJson: string;
+    constructor(options?: Record<string, unknown>);
+    save(): Promise<this>;
+}
+export declare class WorkbookPhotoDecisionCollection extends SmrtCollection<WorkbookPhotoDecision> {
+    static readonly _itemClass: typeof WorkbookPhotoDecision;
+}
+/** Versioned contextual metadata; never edits Workbook identity or learning evidence. */
+export declare class WorkbookContextRevision extends SmrtObject {
+    tenantId: string;
+    learnerId: string;
+    delete(): Promise<void>;
+    workbookId: string;
+    decisionId: string;
+    metadataJson: string;
+    constructor(options?: Record<string, unknown>);
+    save(): Promise<this>;
+}
+export declare class WorkbookContextRevisionCollection extends SmrtCollection<WorkbookContextRevision> {
+    static readonly _itemClass: typeof WorkbookContextRevision;
+}
+//# sourceMappingURL=workbook-photo-models.d.ts.map

package/dist/workbook-photo-models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workbook-photo-models.d.ts","sourceRoot":"","sources":["../src/workbook-photo-models.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,cAAc,EACd,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAyBlC,wEAAwE;AACxE,qBAMa,mBAAoB,SAAQ,UAAU;IACrC,QAAQ,SAAM;IACiB,SAAS,SAAM;IAC3C,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAGtC,MAAM,SAAM;IACZ,WAAW,SAAM;IACjB,aAAa,SAAM;IACJ,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;gBAIxB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CASlD;AACD,qBAAa,6BAA8B,SAAQ,cAAc,CAAC,mBAAmB,CAAC;IACpF,MAAM,CAAC,QAAQ,CAAC,UAAU,6BAAuB;CAClD;AACD,uDAAuD;AACvD,qBAMa,kBAAmB,SAAQ,UAAU;IACpC,QAAQ,SAAM;IACiB,SAAS,SAAM;IAC3C,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAGiB,QAAQ,SAAM;IAChB,OAAO,SAAM;IAClE,IAAI,SAAM;IACV,QAAQ,SAAM;IACd,MAAM,SAAM;IACZ,QAAQ,SAAK;gBACD,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IASlC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CA0BrC;AACD,qBAAa,4BAA6B,SAAQ,cAAc,CAAC,kBAAkB,CAAC;IAClF,MAAM,CAAC,QAAQ,CAAC,UAAU,4BAAsB;CACjD;AACD,wFAAwF;AACxF,qBAMa,qBAAsB,SAAQ,UAAU;IACvC,QAAQ,SAAM;IACiB,SAAS,SAAM;IAC3C,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAGiB,QAAQ,SAAM;IACrE,UAAU,SAAM;IAChB,QAAQ,SAAK;IACb,WAAW,SAAM;IACQ,QAAQ,SAAQ;gBAC7B,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IASlC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAYrC;AACD,qBAAa,+BAAgC,SAAQ,cAAc,CAAC,qBAAqB,CAAC;IACxF,MAAM,CAAC,QAAQ,CAAC,UAAU,+BAAyB;CACpD;AACD,yFAAyF;AACzF,qBAMa,uBAAwB,SAAQ,UAAU;IACzC,QAAQ,SAAM;IACiB,SAAS,SAAM;IAC3C,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAGM,UAAU,SAAM;IACH,UAAU,SAAM;IAChD,YAAY,SAAQ;gBACjC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IASlC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAoBrC;AACD,qBAAa,iCAAkC,SAAQ,cAAc,CAAC,uBAAuB,CAAC;IAC5F,MAAM,CAAC,QAAQ,CAAC,UAAU,iCAA2B;CACtD"}

package/dist/workbook-photo-service.d.ts

@@ -0,0 +1,72 @@
+import type { DatabaseInterface } from '@happyvertical/sql';
+import type { CatalogAuthorizer } from './catalog-service.js';
+import { type LearnerAuthorizer, type LearnerRequest } from './learner-service.js';
+import type { SubmissionPage, SubmissionServiceOptions } from './submission-service.js';
+import type { WorkbookAssessment, WorkbookAssistance } from './workbook-contracts.js';
+import { type WorkbookPhotoIdentification, type WorkbookPhotoIntakeView, type WorkbookPhotoProposal, type WorkbookPhotoWorkbookView } from './workbook-photo-contracts.js';
+import { WorkbookService } from './workbook-service.js';
+/** Internal bridge capability, intentionally absent from package exports. */
+export declare const preservePhotoProposal: unique symbol;
+type PhotoRequest = LearnerRequest & {
+    intakeId: string;
+};
+/** Server-owned intake before assignment. All originals survive ingestion scratch expiry. */
+export declare class WorkbookPhotoService extends WorkbookService {
+    private readonly photoOptions;
+    constructor(db: DatabaseInterface, authorize: LearnerAuthorizer, authorizeCatalog: CatalogAuthorizer, photoOptions: SubmissionServiceOptions & {
+        workbookVocabulary?: WorkbookAssessment['vocabulary'];
+    });
+    protected createTransactionService(db: DatabaseInterface): this;
+    authorizePhotoIntake(request: LearnerRequest): Promise<void>;
+    private lockPhoto;
+    private receipt;
+    private decisions;
+    private append;
+    retainWorkbookPhotoIntake(request: LearnerRequest & {
+        itemId: string;
+        pages: readonly SubmissionPage[];
+    }): Promise<WorkbookPhotoIntakeView>;
+    getWorkbookPhotoIntake(request: PhotoRequest): Promise<WorkbookPhotoIntakeView>;
+    /** Exact receipt lookup for processing/retry; inbox pagination grants no authority. */
+    getWorkbookPhotoIntakeByItem(request: LearnerRequest & {
+        itemId: string;
+    }): Promise<WorkbookPhotoIntakeView>;
+    listWorkbookPhotoIntakes(request: LearnerRequest, options?: {
+        newestFirst?: boolean;
+    }): Promise<WorkbookPhotoIntakeView[]>;
+    /** Authorized contextual catalog, including books identified from covers alone. */
+    listWorkbookPhotoWorkbooks(request: LearnerRequest): Promise<WorkbookPhotoWorkbookView[]>;
+    readWorkbookPhotoOriginal(request: PhotoRequest & {
+        assetId: string;
+    }): Promise<{
+        data: Uint8Array;
+        mimeType: string;
+    }>;
+    resolveWorkbookPhotoIntake(request: PhotoRequest & {
+        requestKey: string;
+        identification: WorkbookPhotoIdentification;
+    }): Promise<WorkbookPhotoIntakeView>;
+    private resolvePhoto;
+    /** Trusted server bridge only: proposal provenance must come from the public ingestion snapshot. */
+    [preservePhotoProposal](request: PhotoRequest & {
+        requestKey: string;
+        proposal: WorkbookPhotoProposal;
+        provenance: Record<string, unknown>;
+        sourceHashes: string[];
+        allowAutomaticResolution?: boolean;
+    }): Promise<WorkbookPhotoIntakeView>;
+    /** Exact authorized receipt history; filing does not move the stable work unit. */
+    getWorkbookPhotoTimeline(request: PhotoRequest & {
+        limit?: number;
+        cursor?: string;
+        revisionId?: string;
+    }): Promise<import("./workbook-contracts.js").WorkbookTimeline>;
+    captureWorkbookPhotoIntake(request: PhotoRequest & {
+        requestKey: string;
+        assistance?: WorkbookAssistance;
+        previousSubmissionId?: string;
+        completedWork?: boolean;
+    }): Promise<import("./workbook-contracts.js").WorkbookAttemptView>;
+}
+export {};
+//# sourceMappingURL=workbook-photo-service.d.ts.map

package/dist/workbook-photo-service.d.ts.map

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

package/dist/workbook-service.d.ts

@@ -0,0 +1,158 @@
+import type { DatabaseInterface } from '@happyvertical/sql';
+import type { CatalogAuthorizer } from './catalog-service.js';
+import { type LearnerAuthorizer, type LearnerRequest } from './learner-service.js';
+import { type SubmissionPage, SubmissionService, type SubmissionServiceOptions } from './submission-service.js';
+import { type WorkbookActivityView, type WorkbookAssessment, type WorkbookAssistance, type WorkbookAttemptView, type WorkbookConceptSummary, type WorkbookPreservationState, type WorkbookRevisionView, type WorkbookTimeline } from './workbook-contracts.js';
+type ActivityRequest = LearnerRequest & {
+    activityId: string;
+};
+type AttemptRequest = ActivityRequest & {
+    submissionId: string;
+};
+/** Actor-bound durable physical workbook workflow. No generated write surface. */
+export declare class WorkbookService extends SubmissionService {
+    private readonly workbookOptions;
+    constructor(db: DatabaseInterface, authorize: LearnerAuthorizer, authorizeCatalog: CatalogAuthorizer, workbookOptions: SubmissionServiceOptions & {
+        workbookVocabulary?: WorkbookAssessment['vocabulary'];
+    });
+    protected createTransactionService(db: DatabaseInterface): this;
+    private serialize;
+    private activity;
+    private filingHead;
+    private activityView;
+    getWorkbookActivity(request: ActivityRequest): Promise<WorkbookActivityView>;
+    /** Receipt-bound technical routing only; the caller already owns the surrounding mutation. */
+    protected resolveUnfiledWorkbookActivityInScope(request: LearnerRequest & {
+        intakeId: string;
+    }, action?: 'education.learner.submit' | 'education.learner.plan'): Promise<WorkbookActivityView>;
+    /** Append a filing association without modifying capture policy or learning history. */
+    fileWorkbookWork(request: ActivityRequest & {
+        workbookId?: string;
+        newWorkbook?: {
+            title: string;
+            edition?: string;
+            workbookKey?: string;
+        };
+        canonicalActivityId?: string;
+        expectedRevisionId: string | null;
+        requestKey: string;
+        reason: string;
+    }): Promise<WorkbookActivityView>;
+    /** Explicit keys distinguish editions, repeated printed labels and page sides. */
+    resolveWorkbookActivity(request: LearnerRequest & {
+        workbookKey: string;
+        title: string;
+        edition?: string;
+        pageKey: string;
+        pageLabel: string;
+    }): Promise<WorkbookActivityView>;
+    /** Owning intake extension: caller validates evidence before upload-authorized creation. */
+    protected resolveWorkbookActivityInScope(request: LearnerRequest & {
+        workbookKey: string;
+        title: string;
+        edition?: string;
+        pageKey: string;
+        pageLabel: string;
+    }, action: 'education.learner.plan' | 'education.learner.submit'): Promise<WorkbookActivityView>;
+    listWorkbookActivities(request: LearnerRequest): Promise<WorkbookActivityView[]>;
+    setWorkbookFeedbackPolicy(request: ActivityRequest & {
+        expectedPolicyVersion: number;
+        reviewRequired: boolean;
+    }): Promise<WorkbookActivityView>;
+    private attempt;
+    private attemptView;
+    captureWorkbookWork(request: ActivityRequest & {
+        requestKey: string;
+        pages: readonly SubmissionPage[];
+        notes?: string;
+        previousSubmissionId?: string;
+        assistance?: WorkbookAssistance;
+        intakeItemId?: string;
+    }): Promise<WorkbookAttemptView>;
+    /** Trusted host lookup, preserving exact enrollment and actor authorization. */
+    getWorkbookAttemptBySubmission(request: LearnerRequest & {
+        enrollmentId: string;
+        submissionId: string;
+    }): Promise<WorkbookAttemptView | null>;
+    /** Authorized content-free preservation status; never exposes withheld marks. */
+    getWorkbookPreservationState(request: AttemptRequest): Promise<WorkbookPreservationState>;
+    /** Public data-only digest map used to preserve ingestion source anchors. */
+    getWorkbookSourceAnchors(request: AttemptRequest): Promise<{
+        assetId: string;
+        sha256: string;
+        pageCount: number;
+    }[]>;
+    /** Stable IDs only: historical prompts may themselves contain learner answers. */
+    getWorkbookQuestionIdentity(request: AttemptRequest): Promise<{
+        id: string;
+    }[]>;
+    /** Canonical transcriptions only for this exact capture, never its predecessor.
+     * A correction without its own revision receives IDs only. Both paths retain
+     * the same source/revision and full ancestry visibility checks as identity. */
+    getWorkbookQuestionContext(request: AttemptRequest & {
+        analysisRevision?: number;
+    }): Promise<{
+        kind: 'same_capture';
+        questions: {
+            id: string;
+            prompt: string;
+        }[];
+    } | {
+        kind: 'identity_only';
+        questions: {
+            id: string;
+        }[];
+    }>;
+    private revisionPayloadVisible;
+    private revisions;
+    private identityRevision;
+    /** Call after actor/resource authorization, only for own-learner projections.
+     * Semantic IDs are source content. A descendant release cannot publish a
+     * hidden ancestor; exact published ID sets keep old public snapshots usable. */
+    private questionIdentityVisible;
+    private validateAssessment;
+    private appendRevision;
+    recordWorkbookAnalysis(request: AttemptRequest & {
+        requestKey: string;
+        assessment: WorkbookAssessment;
+    }): Promise<WorkbookRevisionView>;
+    reviewWorkbookAssessment(request: AttemptRequest & {
+        revisionId: string;
+        expectedHeadId: string | null;
+        requestKey: string;
+        assessment?: WorkbookAssessment;
+        decisionReason?: string;
+    }): Promise<WorkbookRevisionView>;
+    releaseWorkbookFeedback(request: AttemptRequest & {
+        revisionId: string;
+        requestKey: string;
+        expectedHeadId: string | null;
+    }): Promise<{
+        id: string;
+        revisionId: string;
+        createdAt: Date;
+        actorUserId: string;
+    }>;
+    /** Record an authenticated own-learner render acknowledgment, never 'read'. */
+    acknowledgeWorkbookFeedbackDelivery(request: AttemptRequest & {
+        revisionId: string;
+        requestKey: string;
+    }): Promise<{
+        id: string;
+        revisionId: string;
+        actorUserId: string;
+        createdAt: Date;
+    }>;
+    getWorkbookTimeline(request: ActivityRequest & {
+        cursor?: string;
+        limit?: number;
+        revisionId?: string;
+    }): Promise<WorkbookTimeline>;
+    /** Descriptive guardian projection; corrections stay within one practice episode. */
+    getConceptEvidenceSummary(request: ActivityRequest): Promise<{
+        algorithmVersion: 'workbook-descriptive-v1';
+        concepts: WorkbookConceptSummary[];
+    }>;
+}
+export {};
+//# sourceMappingURL=workbook-service.d.ts.map

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-education",
-  "version": "0.57.33",
+  "version": "0.57.34",
   "smrtJsdoc": "strict",
   "description": "Tenant-aware learning catalog models and authorized catalog access for SMRT",
   "type": "module",
@@ -25,18 +25,18 @@
     }
   },
   "dependencies": {
-    "@happyvertical/smrt-assets": "0.57.33",
-    "@happyvertical/smrt-core": "0.57.33",
-    "@happyvertical/smrt-profiles": "0.57.33",
-    "@happyvertical/smrt-tenancy": "0.57.33",
-    "@happyvertical/smrt-users": "0.57.33",
+    "@happyvertical/smrt-assets": "0.57.34",
+    "@happyvertical/smrt-core": "0.57.34",
+    "@happyvertical/smrt-profiles": "0.57.34",
+    "@happyvertical/smrt-tenancy": "0.57.34",
+    "@happyvertical/smrt-users": "0.57.34",
     "@happyvertical/files": "^0.108.0",
     "@happyvertical/sql": "^0.108.0",
     "pdf-lib": "1.17.1",
-    "@happyvertical/smrt-ingestion": "0.57.33"
+    "@happyvertical/smrt-ingestion": "0.57.34"
   },
   "devDependencies": {
-    "@happyvertical/smrt-vitest": "0.57.33",
+    "@happyvertical/smrt-vitest": "0.57.34",
     "@types/node": "24.13.6",
     "typescript": "6.0.3",
     "vite": "8.1.6",