@happyvertical/smrt-education 0.57.43 → 0.57.44

package/dist/course-generation-contracts.d.ts

@@ -0,0 +1,150 @@
+import { CourseAuthoringError } from './course-authoring-contracts.js';
+export type CourseGenerationStatus = 'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled';
+export declare const COURSE_GENERATION_STATUSES: readonly CourseGenerationStatus[];
+export declare const COURSE_GENERATION_TERMINAL: readonly CourseGenerationStatus[];
+/** Provider identity, shaped like the ingestion `ProviderIdentity`. */
+export interface CourseGeneratorIdentity {
+    provider: string;
+    model: string;
+    version: string;
+}
+/** What a generator is given: the exact snapshot retained on the job. */
+export interface CourseGeneratorRequest {
+    tenantId: string;
+    courseId: string;
+    jobId: string;
+    instruction: string;
+    /** Immutable snapshot of the base revision; never contains answer keys. */
+    material: unknown;
+}
+/**
+ * Host-injected generation port. It matches the ingestion `ProposalGenerator`
+ * result contract (untrusted `output`, optional `usage` and `responseModel`).
+ * The service never selects a provider; the output is validated against the
+ * closed proposal schema before anything is written.
+ */
+export interface CourseMaterialGenerator {
+    identity: CourseGeneratorIdentity;
+    generate(request: CourseGeneratorRequest, options: {
+        signal: AbortSignal;
+        maxOutputBytes: number;
+    }): Promise<{
+        output: unknown;
+        completion: 'complete' | 'unknown';
+        usage?: Record<string, number>;
+        responseModel?: string;
+    }>;
+}
+export interface CourseGenerationLimits {
+    timeoutMs: number;
+    maxOutputBytes: number;
+}
+/** Closed, validated generation output. Absent members are not proposed. */
+export interface CourseGenerationProposalLesson {
+    /** Existing lesson to propose changes to; omitted for a new lesson. */
+    lessonKey?: string;
+    /** New lessons only. */
+    sectionKey?: string;
+    sectionTitle?: string;
+    title?: string;
+    body?: string;
+    estimatedMinutes?: number;
+    difficulty?: number;
+}
+export interface CourseGenerationProposal {
+    course: {
+        summary?: string;
+        subject?: string;
+        objectives?: string[];
+    };
+    lessons: CourseGenerationProposalLesson[];
+    rationale: string;
+}
+export type CourseProposalFieldStatus = 'added' | 'filled' | 'conflict' | 'unchanged';
+export type CourseProposalDecisionKind = 'accepted' | 'rejected';
+/** One field of the supplied-versus-proposed comparison. */
+export interface CourseProposalFieldView {
+    /** `course.summary`, `lesson:<key>.body` or `new-lesson:<n>`. */
+    field: string;
+    status: CourseProposalFieldStatus;
+    /** Supplied value when the proposal was made; null when there was none. */
+    supplied: unknown;
+    proposed: unknown;
+    /** Value in the current draft head; differs from `supplied` once edited. */
+    current: unknown;
+    /** A conflict stays undecided until a guardian or delegate decides it. */
+    decision: CourseProposalDecisionKind | null;
+}
+export interface CourseProposalView {
+    proposalId: string;
+    jobId: string;
+    courseId: string;
+    baseRevisionId: string;
+    /** The new draft revision holding only additions and fills. */
+    resultRevisionId: string;
+    rationale: string;
+    fields: CourseProposalFieldView[];
+}
+export interface CourseGenerationUsageView {
+    inputTokens: number | null;
+    outputTokens: number | null;
+    cost: number | null;
+    costCurrency: string | null;
+    raw: Record<string, number>;
+}
+export interface CourseGenerationEventView {
+    sequence: number;
+    status: CourseGenerationStatus;
+    provider: string;
+    model: string;
+    version: string;
+    responseModel: string;
+    usage: CourseGenerationUsageView;
+    errorCode: string | null;
+    detail: string;
+    proposalId: string | null;
+    resultRevisionId: string | null;
+    actorUserId: string;
+    delegatingGuardianUserId: string | null;
+    delegationId: string | null;
+    recordedAt: string;
+}
+export interface CourseGenerationView {
+    jobId: string;
+    courseId: string;
+    baseRevisionId: string;
+    requestKey: string;
+    instruction: string;
+    status: CourseGenerationStatus;
+    provider: string;
+    model: string;
+    usage: CourseGenerationUsageView;
+    errorCode: string | null;
+    proposalId: string | null;
+    resultRevisionId: string | null;
+    requestedByUserId: string;
+    delegatingGuardianUserId: string | null;
+    delegationId: string | null;
+    events: CourseGenerationEventView[];
+}
+export declare class CourseGeneratorNotConfiguredError extends CourseAuthoringError {
+    constructor();
+}
+export declare class CourseGenerationNotFoundError extends CourseAuthoringError {
+    constructor();
+}
+export declare class CourseGenerationInProgressError extends CourseAuthoringError {
+    constructor();
+}
+export declare class CourseGenerationOutputError extends CourseAuthoringError {
+    readonly path: string;
+    constructor(path: string);
+}
+export declare class CourseProposalNotFoundError extends CourseAuthoringError {
+    constructor();
+}
+export declare class CourseProposalFieldError extends CourseAuthoringError {
+    readonly fields: readonly string[];
+    constructor(fields: readonly string[]);
+}
+//# sourceMappingURL=course-generation-contracts.d.ts.map

package/dist/course-generation-contracts.d.ts.map

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

package/dist/course-generation-models.d.ts

@@ -0,0 +1,94 @@
+import { SmrtCollection, SmrtObject, type SmrtSaveOptions } from '@happyvertical/smrt-core';
+/** Immutable generation request with its retained input snapshot. */
+export declare class CourseGenerationJob extends SmrtObject {
+    tenantId: string;
+    courseId: string;
+    baseRevisionId: string;
+    requestKey: string;
+    payloadDigest: string;
+    instruction: string;
+    /** The exact material snapshot offered to the provider. */
+    inputJson: string;
+    requestedByUserId: string;
+    delegatingGuardianUserId: string;
+    delegationId: string;
+    recordedAt: Date;
+    constructor(options?: Record<string, unknown>);
+    delete(): Promise<void>;
+    save(options?: SmrtSaveOptions): Promise<this>;
+}
+export declare class CourseGenerationJobCollection extends SmrtCollection<CourseGenerationJob> {
+    static readonly _itemClass: typeof CourseGenerationJob;
+}
+/** Append-only status log; the highest sequence is the job's status and outcome. */
+export declare class CourseGenerationEvent extends SmrtObject {
+    tenantId: string;
+    jobId: string;
+    courseId: string;
+    sequence: number;
+    status: string;
+    provider: string;
+    model: string;
+    version: string;
+    responseModel: string;
+    inputTokens: number | null;
+    outputTokens: number | null;
+    cost: number | null;
+    costCurrency: string | null;
+    usageJson: string;
+    errorCode: string | null;
+    detail: string;
+    proposalId: string | null;
+    resultRevisionId: string | null;
+    actorUserId: string;
+    delegatingGuardianUserId: string;
+    delegationId: string;
+    requestKey: string;
+    recordedAt: Date;
+    constructor(options?: Record<string, unknown>);
+    delete(): Promise<void>;
+    save(options?: SmrtSaveOptions): Promise<this>;
+}
+export declare class CourseGenerationEventCollection extends SmrtCollection<CourseGenerationEvent> {
+    static readonly _itemClass: typeof CourseGenerationEvent;
+}
+/** The validated proposal for one job and its supplied-versus-proposed plan. */
+export declare class CourseProposal extends SmrtObject {
+    tenantId: string;
+    jobId: string;
+    courseId: string;
+    baseRevisionId: string;
+    resultRevisionId: string;
+    rationale: string;
+    proposalJson: string;
+    planJson: string;
+    recordedAt: Date;
+    constructor(options?: Record<string, unknown>);
+    delete(): Promise<void>;
+    save(options?: SmrtSaveOptions): Promise<this>;
+}
+export declare class CourseProposalCollection extends SmrtCollection<CourseProposal> {
+    static readonly _itemClass: typeof CourseProposal;
+}
+/** Explicit, recorded accept or reject of conflicting proposal fields. */
+export declare class CourseProposalDecision extends SmrtObject {
+    tenantId: string;
+    proposalId: string;
+    courseId: string;
+    decision: string;
+    fieldsJson: string;
+    resultRevisionId: string | null;
+    actorUserId: string;
+    delegatingGuardianUserId: string;
+    delegationId: string;
+    requestKey: string;
+    payloadDigest: string;
+    recordedAt: Date;
+    constructor(options?: Record<string, unknown>);
+    delete(): Promise<void>;
+    save(options?: SmrtSaveOptions): Promise<this>;
+}
+export declare class CourseProposalDecisionCollection extends SmrtCollection<CourseProposalDecision> {
+    static readonly _itemClass: typeof CourseProposalDecision;
+}
+//# sourceMappingURL=course-generation-models.d.ts.map

package/dist/course-generation-models.d.ts.map

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

package/dist/course-generation-output.d.ts

@@ -0,0 +1,31 @@
+import type { CourseDraftInput, CourseRevisionView } from './course-authoring-contracts.js';
+import { type CourseGenerationProposal, type CourseProposalFieldStatus } from './course-generation-contracts.js';
+/**
+ * Validates untrusted provider output against the closed proposal schema.
+ * `existingLessonKeys` are the lessons of the snapshot the job ran against: a
+ * proposal may only address a lesson that exists there.
+ */
+export declare function validateCourseGenerationOutput(output: unknown, existingLessonKeys: ReadonlySet<string>): CourseGenerationProposal;
+/** Field paths a proposal can decide, and how to read the current value. */
+export interface ProposalFieldPlan {
+    field: string;
+    status: CourseProposalFieldStatus;
+    supplied: unknown;
+    proposed: unknown;
+}
+/** Per-field comparison of a proposal against the supplied base revision. */
+export declare function planProposal(base: CourseRevisionView, proposal: CourseGenerationProposal): ProposalFieldPlan[];
+/** Stable key for a generated lesson, so a replayed job reproduces the same row. */
+export declare const generatedLessonKey: (jobId: string, index: number) => string;
+/** Rebuilds a draft input from a stored revision, preserving materials and questions. */
+export declare function draftFromRevision(view: CourseRevisionView): CourseDraftInput;
+/**
+ * Applies the selected plan entries to a draft built from `view`. Returns
+ * the fields that no longer apply (for example a deleted lesson).
+ */
+export declare function applyProposalFields(draft: CourseDraftInput, entries: ReadonlyArray<ProposalFieldPlan>, options: {
+    jobId: string;
+}): {
+    missing: string[];
+};
+//# sourceMappingURL=course-generation-output.d.ts.map

package/dist/course-generation-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"course-generation-output.d.ts","sourceRoot":"","sources":["../src/course-generation-output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAEhB,kBAAkB,EACnB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAEL,KAAK,wBAAwB,EAE7B,KAAK,yBAAyB,EAC/B,MAAM,kCAAkC,CAAC;AAyC1C;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,OAAO,EACf,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAAC,GACtC,wBAAwB,CAkF1B;AAED,4EAA4E;AAC5E,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,yBAAyB,CAAC;IAClC,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAmBD,6EAA6E;AAC7E,wBAAgB,YAAY,CAC1B,IAAI,EAAE,kBAAkB,EACxB,QAAQ,EAAE,wBAAwB,GACjC,iBAAiB,EAAE,CA+CrB;AAED,oFAAoF;AACpF,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,EAAE,OAAO,MAAM,WACS,CAAC;AAIzE,yFAAyF;AACzF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,GAAG,gBAAgB,CAuC5E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,aAAa,CAAC,iBAAiB,CAAC,EACzC,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GACzB;IAAE,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAuEvB"}

package/dist/course-generation-proposal-generator.d.ts

@@ -0,0 +1,94 @@
+import type { ProposalGenerator } from '@happyvertical/smrt-ingestion/proposals';
+import type { CourseMaterialGenerator } from './course-generation-contracts.js';
+export declare const COURSE_PROPOSAL_HANDLER = "@happyvertical/smrt-education:propose-course-material";
+/** The closed JSON shape a model is asked to produce; validated again on receipt. */
+export declare const COURSE_PROPOSAL_ARGS_SCHEMA: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+        readonly course: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly summary: {
+                    type: string;
+                    minLength: number;
+                    maxLength: number;
+                };
+                readonly subject: {
+                    type: string;
+                    minLength: number;
+                    maxLength: number;
+                };
+                readonly objectives: {
+                    readonly type: "array";
+                    readonly minItems: 1;
+                    readonly maxItems: 50;
+                    readonly items: {
+                        type: string;
+                        minLength: number;
+                        maxLength: number;
+                    };
+                };
+            };
+        };
+        readonly lessons: {
+            readonly type: "array";
+            readonly maxItems: 50;
+            readonly items: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly properties: {
+                    readonly lessonKey: {
+                        type: string;
+                        minLength: number;
+                        maxLength: number;
+                    };
+                    readonly sectionKey: {
+                        type: string;
+                        minLength: number;
+                        maxLength: number;
+                    };
+                    readonly sectionTitle: {
+                        type: string;
+                        minLength: number;
+                        maxLength: number;
+                    };
+                    readonly title: {
+                        type: string;
+                        minLength: number;
+                        maxLength: number;
+                    };
+                    readonly body: {
+                        type: string;
+                        minLength: number;
+                        maxLength: number;
+                    };
+                    readonly estimatedMinutes: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly maximum: 1440;
+                    };
+                    readonly difficulty: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly maximum: 10;
+                    };
+                };
+            };
+        };
+        readonly rationale: {
+            type: string;
+            minLength: number;
+            maxLength: number;
+        };
+    };
+};
+/**
+ * Adapts an ingestion `ProposalGenerator` (the host's trusted SDK-bound
+ * adapter) to the course generation port. The material is offered as one
+ * evidence segment; the model's output stays untrusted and is validated by the
+ * service against the closed proposal schema. No provider is chosen here.
+ */
+export declare function createProposalCourseGenerator(generator: ProposalGenerator): CourseMaterialGenerator;
+//# sourceMappingURL=course-generation-proposal-generator.d.ts.map

package/dist/course-generation-proposal-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"course-generation-proposal-generator.d.ts","sourceRoot":"","sources":["../src/course-generation-proposal-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AACjF,OAAO,KAAK,EAEV,uBAAuB,EACxB,MAAM,kCAAkC,CAAC;AAG1C,eAAO,MAAM,uBAAuB,0DACqB,CAAC;AAO1D,qFAAqF;AACrF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqC9B,CAAC;AAEX;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,iBAAiB,GAC3B,uBAAuB,CAoDzB"}

package/dist/course-generation-review-service.d.ts

@@ -0,0 +1,149 @@
+import type { DatabaseInterface } from '@happyvertical/sql';
+import { type CourseAuthoringActor, type CourseAuthoringAuthorizer } from './course-authoring-contracts.js';
+import { type CourseGenerationLimits, type CourseGenerationView, type CourseMaterialGenerator, type CourseProposalView } from './course-generation-contracts.js';
+import { type CourseFindingResolutionKind, type CourseReviewContextInput, type CourseReviewFindingInput, type CourseReviewView } from './course-review-contracts.js';
+import { QuestionAuthoringService, type QuestionAuthoringServiceOptions } from './question-authoring-service.js';
+type Tx = DatabaseInterface;
+export interface CourseGenerationReviewServiceOptions extends QuestionAuthoringServiceOptions {
+    /** Host-supplied generation port; without it `runGeneration` fails closed. */
+    generator?: CourseMaterialGenerator;
+    generationLimits?: Partial<CourseGenerationLimits>;
+}
+/**
+ * Generation proposals and revision-bound educational review (SMRT #4516).
+ * It extends `QuestionAuthoringService`, so it adds only the generation and
+ * review operations and uses the same authorizer, tenancy checks and CAS save
+ * path. Its release gate and discard guard default to the review-backed ones.
+ */
+export declare class CourseGenerationReviewService extends QuestionAuthoringService {
+    private readonly generator;
+    private readonly limits;
+    constructor(db: DatabaseInterface, authorizer: CourseAuthoringAuthorizer, options?: CourseGenerationReviewServiceOptions);
+    private baseView;
+    /** Provider-facing snapshot: no keys, assets or personal-use lesson bodies. */
+    private material;
+    private jobRow;
+    private jobEvents;
+    private usageView;
+    private eventView;
+    private generationView;
+    private appendEvent;
+    /**
+     * Records a generation request against the draft head the caller saw. A
+     * retried key returns the existing job and its proposal; the same key with
+     * different input is a typed conflict. Nothing is generated or written to the
+     * draft here.
+     */
+    requestGeneration(request: CourseAuthoringActor & {
+        courseId: string;
+        expectedHeadRevisionId: string;
+        requestKey: string;
+        instruction?: string;
+    }): Promise<CourseGenerationView>;
+    /**
+     * Runs a queued job through the injected generator outside any transaction,
+     * then records the outcome. Success writes a new draft revision holding only
+     * additions and fills; conflicting proposals wait for an explicit decision.
+     * Failure, timeout, cancellation, a stale head or invalid output leave the
+     * head unchanged and keep the input.
+     */
+    runGeneration(request: CourseAuthoringActor & {
+        jobId: string;
+    }): Promise<CourseGenerationView>;
+    /** Cancels a queued or running job; a finished job is returned unchanged. */
+    cancelGeneration(request: CourseAuthoringActor & {
+        jobId: string;
+        requestKey: string;
+    }): Promise<CourseGenerationView>;
+    getGeneration(request: CourseAuthoringActor & {
+        jobId: string;
+    }): Promise<CourseGenerationView>;
+    private currentValue;
+    private proposalView;
+    private proposalRow;
+    /** Supplied-versus-proposed comparison, per field, against the current head. */
+    getProposal(request: CourseAuthoringActor & {
+        courseId: string;
+        proposalId: string;
+    }): Promise<CourseProposalView>;
+    /**
+     * Explicitly accepts or rejects conflicting proposal fields. Accepting appends
+     * a new draft revision on the expected head (compare and swap); supplied
+     * content is replaced only by this recorded decision.
+     */
+    decideProposal(request: CourseAuthoringActor & {
+        courseId: string;
+        proposalId: string;
+        expectedHeadRevisionId: string;
+        decision: 'accept' | 'reject';
+        fields: string[];
+        requestKey: string;
+    }): Promise<CourseProposalView & {
+        headRevisionId: string;
+    }>;
+    private normalizeFindings;
+    private reviewContext;
+    private reviewView;
+    /** Revision ids a finding may point at: the course revision, its lessons and questions. */
+    private targetIds;
+    /**
+     * Records an educational review of one exact revision, authored by the
+     * caller (a guardian, or an agent for its delegating guardian). The review
+     * has no score; level target and theme come from the revision, and a learner
+     * review must name the evidence snapshot it used.
+     */
+    recordReview(request: CourseAuthoringActor & {
+        courseId: string;
+        revisionId: string;
+        requestKey: string;
+        context?: CourseReviewContextInput;
+        generalSummary?: string;
+        learnerSummary?: string;
+        findings: CourseReviewFindingInput[];
+        reviewer?: {
+            provider?: string;
+            model?: string;
+        };
+    }): Promise<CourseReviewView>;
+    /** Reviews of a course, newest first, with findings, resolutions and outdated state. */
+    listReviews(request: CourseAuthoringActor & {
+        courseId: string;
+        revisionId?: string;
+    }): Promise<CourseReviewView[]>;
+    getReview(request: CourseAuthoringActor & {
+        courseId: string;
+        reviewId: string;
+    }): Promise<CourseReviewView>;
+    private markOutdated;
+    /** A new draft revision makes every review of an earlier revision outdated. */
+    protected onDraftRevisionAppended(tx: Tx, actor: CourseAuthoringActor, revision: {
+        courseId: string;
+        revisionId: string;
+    }): Promise<void>;
+    /**
+     * Records that a learner's evidence snapshot changed: learner reviews of this
+     * course that used a different snapshot become outdated.
+     */
+    noteContextChange(request: CourseAuthoringActor & {
+        courseId: string;
+        learnerId: string;
+        evidenceSnapshotRef: string;
+        requestKey: string;
+    }): Promise<{
+        outdatedReviewIds: string[];
+    }>;
+    /**
+     * Resolves one finding. Only a person may resolve a finding flagged for human
+     * verification; a delegated agent is refused. Release stays blocked while any
+     * blocking or human-verification finding is unresolved.
+     */
+    resolveFinding(request: CourseAuthoringActor & {
+        courseId: string;
+        findingId: string;
+        resolution: CourseFindingResolutionKind;
+        note?: string;
+        requestKey: string;
+    }): Promise<CourseReviewView>;
+}
+export {};
+//# sourceMappingURL=course-generation-review-service.d.ts.map

package/dist/course-generation-review-service.d.ts.map

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

package/dist/course-release-scope.d.ts

@@ -0,0 +1,37 @@
+import type { DatabaseInterface } from '@happyvertical/sql';
+import type { EffectiveLessonView } from './course-authoring-contracts.js';
+/**
+ * The single rule for which immutable lesson rows apply to a pinned enrollment.
+ * Callers authorize the actor and enrollment first; every read here is bound to
+ * the supplied executor (so it joins the caller's transaction) and the exact
+ * tenant and enrollment. `getEnrollmentRelease` and the learner projections both
+ * call this, so the two can never disagree.
+ */
+export type EnrollmentLessonSelection = Readonly<{
+    /** The release the enrollment currently follows. */
+    currentReleaseId: string;
+    /** Every release the enrollment has been pinned to, oldest first. */
+    lineage: ReadonlyArray<string>;
+    /** Effective lessons, sorted by stable lessonKey. */
+    lessons: EffectiveLessonView[];
+    /** The materialized Course row of each release that contributes a lesson. */
+    releaseCourseIds: ReadonlyMap<string, string>;
+    /** Stable lessonKey to lesson row id, per release in the lineage. */
+    keysByRelease: ReadonlyMap<string, ReadonlyMap<string, string>>;
+    /** Learner ids recorded on the pins (a mismatch with the enrollment fails closed). */
+    pinLearnerIds: ReadonlySet<string>;
+}>;
+/**
+ * Started lessons stay on the immutable row they were started on, in every
+ * release the enrollment has followed; unstarted lessons follow the current
+ * release. Returns null for an enrollment that has never been pinned.
+ */
+export declare function resolveEnrollmentLessons(db: DatabaseInterface, tenantId: string, enrollmentId: string): Promise<EnrollmentLessonSelection | null>;
+/**
+ * Orders effective lessons for learners: the current release's own order first,
+ * then lessons kept only because they were started (removed from the current
+ * release) by release age and their original order. `orderOf` lists a release's
+ * lesson row ids in course order.
+ */
+export declare function orderEffectiveLessons(selection: EnrollmentLessonSelection, orderOf: (releaseId: string) => ReadonlyArray<string>): EffectiveLessonView[];
+//# sourceMappingURL=course-release-scope.d.ts.map

package/dist/course-release-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"course-release-scope.d.ts","sourceRoot":"","sources":["../src/course-release-scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAM3E;;;;;;GAMG;AACH,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAC/C,oDAAoD;IACpD,gBAAgB,EAAE,MAAM,CAAC;IACzB,qEAAqE;IACrE,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC/B,qDAAqD;IACrD,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,6EAA6E;IAC7E,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,qEAAqE;IACrE,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAChE,sFAAsF;IACtF,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACpC,CAAC,CAAC;AAEH;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,EAAE,EAAE,iBAAiB,EACrB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAwE3C;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,yBAAyB,EACpC,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,aAAa,CAAC,MAAM,CAAC,GACpD,mBAAmB,EAAE,CAuBvB"}