@happyvertical/smrt-education 0.57.40 → 0.57.42

package/dist/enrollment-note-service.d.ts

@@ -0,0 +1,24 @@
+import type { DatabaseInterface } from '@happyvertical/sql';
+import { type LearnerRequest, LearnerService } from './learner-service.js';
+export type EnrollmentParentNoteView = Readonly<{
+    id: string;
+    enrollmentId: string;
+    learnerId: string;
+    text: string;
+    authorUserId: string;
+    authorLabel: string;
+    createdAt: Date;
+}>;
+/** Internal extension shared by the public learner Plan service. */
+export declare class EnrollmentNoteService extends LearnerService {
+    protected createTransactionService(db: DatabaseInterface): this;
+    listEnrollmentNotes(request: LearnerRequest & {
+        enrollmentId: string;
+    }): Promise<EnrollmentParentNoteView[]>;
+    addEnrollmentNote(request: LearnerRequest & {
+        enrollmentId: string;
+        text: string;
+        requestKey: string;
+    }): Promise<EnrollmentParentNoteView>;
+}
+//# sourceMappingURL=enrollment-note-service.d.ts.map

package/dist/enrollment-note-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrollment-note-service.d.ts","sourceRoot":"","sources":["../src/enrollment-note-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAM5D,OAAO,EAAE,KAAK,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3E,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,IAAI,CAAC;CACjB,CAAC,CAAC;AAcH,oEAAoE;AACpE,qBAAa,qBAAsB,SAAQ,cAAc;cACpC,wBAAwB,CAAC,EAAE,EAAE,iBAAiB,GAAG,IAAI;IAQlE,mBAAmB,CACvB,OAAO,EAAE,cAAc,GAAG;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,GACjD,OAAO,CAAC,wBAAwB,EAAE,CAAC;IAiBhC,iBAAiB,CACrB,OAAO,EAAE,cAAc,GAAG;QACxB,YAAY,EAAE,MAAM,CAAC;QACrB,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;KACpB,GACA,OAAO,CAAC,wBAAwB,CAAC;CAkDrC"}

package/dist/enrollment-notes.d.ts

@@ -0,0 +1,22 @@
+import { SmrtCollection, SmrtObject, type SmrtSaveOptions } from '@happyvertical/smrt-core';
+export declare const ENROLLMENT_NOTE_MAX_LENGTH = 4000;
+/** Notes are plain text; consumers render text, never HTML or markdown. */
+export declare function validateEnrollmentNote(text: string, requestKey: string): void;
+/** Private guardian annotations, separate from learning and assessment history. */
+export declare class EnrollmentParentNote extends SmrtObject {
+    tenantId: string;
+    enrollmentId: string;
+    learnerId: string;
+    authorUserId: string;
+    authorLabel: string;
+    text: string;
+    requestKey: string;
+    recordedAt: Date;
+    constructor(options?: Record<string, unknown>);
+    delete(): Promise<void>;
+    save(options?: SmrtSaveOptions): Promise<this>;
+}
+export declare class EnrollmentParentNoteCollection extends SmrtCollection<EnrollmentParentNote> {
+    static readonly _itemClass: typeof EnrollmentParentNote;
+}
+//# sourceMappingURL=enrollment-notes.d.ts.map

package/dist/enrollment-notes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrollment-notes.d.ts","sourceRoot":"","sources":["../src/enrollment-notes.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,cAAc,EACd,UAAU,EACV,KAAK,eAAe,EAErB,MAAM,0BAA0B,CAAC;AAGlC,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAe/C,2EAA2E;AAC3E,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAe7E;AAED,mFAAmF;AACnF,qBAQa,oBAAqB,SAAQ,UAAU;IACtC,QAAQ,SAAM;IACoB,YAAY,SAAM;IACrB,SAAS,SAAM;IAE1D,YAAY,SAAM;IAClB,WAAW,SAAY;IACvB,IAAI,SAAM;IACV,UAAU,SAAM;IAChB,UAAU,OAAc;gBAEZ,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAQlC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvB,IAAI,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CA4B9D;AAED,qBAAa,8BAA+B,SAAQ,cAAc,CAAC,oBAAoB,CAAC;IACtF,MAAM,CAAC,QAAQ,CAAC,UAAU,8BAAwB;CACnD"}

package/dist/group-sharing-authorization.d.ts

@@ -0,0 +1,67 @@
+import type { DatabaseInterface } from '@happyvertical/sql';
+import { type GroupSharingActor, type GroupSharingScope } from './group-sharing-contracts.js';
+export type GroupSharingAction = 'education.group.create' | 'education.group.manage' | 'education.group.read' | 'education.group.invite' | 'education.group.share' | 'education.group.review' | 'education.group.comment' | 'education.group.child-comments';
+export type GroupSharingAuthorizer = (request: GroupSharingActor & {
+    action: GroupSharingAction;
+    executor: DatabaseInterface;
+    groupId?: string;
+    groupTenantId?: string;
+    familyTenantId?: string;
+    learnerId?: string;
+    /** Host must validate current guardian type and effective terms on this executor. */
+    guardianRelationships?: ReadonlyArray<{
+        id: string;
+        typeId: string;
+    }>;
+}) => boolean | Promise<boolean>;
+/** Internal owning predicate; unavailable individual edges may be omitted, host/DB failures may not. */
+export declare function isGroupSharingScopeDenial(error: unknown): boolean;
+/** Same connection queue as workbook mutations, with a real rollback boundary. */
+export declare function groupSharingTransaction<T>(db: DatabaseInterface, operation: (executor: DatabaseInterface) => Promise<T>): Promise<T>;
+/** Internal owning boundary. Never returned from a public sharing operation. */
+export declare class GroupSharingBoundary {
+    readonly db: DatabaseInterface;
+    readonly authorize: GroupSharingAuthorizer;
+    constructor(db: DatabaseInterface, authorize: GroupSharingAuthorizer);
+    private hostDecision;
+    requireIdentity(actor: GroupSharingActor): Promise<{
+        id: string;
+        profileId: string;
+    }>;
+    check(request: GroupSharingActor & {
+        groupId?: string;
+        familyTenantId?: string;
+        learnerId?: string;
+    }, action: GroupSharingAction, extra?: {
+        groupTenantId?: string;
+        guardianRelationships?: ReadonlyArray<{
+            id: string;
+            typeId: string;
+        }>;
+    }): Promise<void>;
+    /** Loading a group reveals no family data; its users tenant must remain active. */
+    loadGroup(groupId: string, allowInactive?: boolean): Promise<import("./group-sharing-models.js").EducationGroup>;
+    requireGroup(request: GroupSharingActor & {
+        groupId: string;
+    }, action?: GroupSharingAction): Promise<import("./group-sharing-models.js").EducationGroup>;
+    /** Discover only this actor's group metadata while retaining their authenticated session context. */
+    discoverGroup(request: GroupSharingActor & {
+        groupId: string;
+    }): Promise<import("./group-sharing-models.js").EducationGroup | null>;
+    /** Own-learner navigation is a separate capability and never synthesizes guardian authority. */
+    requireOwnLearner(request: Omit<GroupSharingScope, 'groupId'>): Promise<import("./learners.js").Learner>;
+    requireGuardian(request: Omit<GroupSharingScope, 'groupId'> & {
+        groupId?: string;
+    }, action?: GroupSharingAction): Promise<import("./learners.js").Learner>;
+    private loadLearner;
+    requireScope(request: GroupSharingScope, action?: GroupSharingAction, mode?: 'supervisor' | 'guardian' | 'child'): Promise<{
+        membership: import("./group-sharing-models.js").GroupLearnerMembership;
+        policyRecord: import("./group-sharing-models.js").GroupSharingPolicy;
+        policy: import("./group-sharing-contracts.js").GroupSharingPolicyV1;
+        group: import("./group-sharing-models.js").EducationGroup;
+        learner: import("./learners.js").Learner;
+    }>;
+}
+/** Fixed lock order shared with workbook: learner, exact group edge, then invitation/comment. */
+export declare function lockGroupSharingScope(db: DatabaseInterface, request: Pick<GroupSharingScope, 'familyTenantId' | 'learnerId' | 'groupId'>): Promise<void>;
+//# sourceMappingURL=group-sharing-authorization.d.ts.map

package/dist/group-sharing-authorization.d.ts.map

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

package/dist/group-sharing-comments.d.ts

@@ -0,0 +1,30 @@
+import type { DatabaseInterface } from '@happyvertical/sql';
+import { type GroupSharingAuthorizer } from './group-sharing-authorization.js';
+import { type GroupRevisionCommentView, type GroupSharedWorkSelector, type GroupSharingScope } from './group-sharing-contracts.js';
+export type ListRevisionCommentsRequest = GroupSharedWorkSelector & {
+    /** Explicit paths prevent failed supervisor checks from falling back to family authority. */
+    access?: 'supervisor' | 'guardian' | 'child';
+};
+export type AddRevisionCommentRequest = GroupSharedWorkSelector & {
+    body: string;
+};
+export type SetCommentChildVisibilityRequest = GroupSharingScope & {
+    commentId: string;
+    expectedVersion: number;
+    visible: boolean;
+};
+/** Attributed discussion only: this service never writes assessment, grade or progress. */
+export declare class GroupSharingCommentService {
+    private readonly db;
+    private readonly authorize;
+    /** @internal Only the queued GroupSharingService transaction may set this. */
+    private readonly executorBound;
+    constructor(db: DatabaseInterface, authorize: GroupSharingAuthorizer, 
+    /** @internal Only the queued GroupSharingService transaction may set this. */
+    executorBound?: boolean);
+    private run;
+    addRevisionComment(input: AddRevisionCommentRequest): Promise<GroupRevisionCommentView>;
+    listRevisionComments(input: ListRevisionCommentsRequest): Promise<ReadonlyArray<GroupRevisionCommentView>>;
+    setCommentChildVisibility(input: SetCommentChildVisibilityRequest): Promise<GroupRevisionCommentView>;
+}
+//# sourceMappingURL=group-sharing-comments.d.ts.map

package/dist/group-sharing-comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-sharing-comments.d.ts","sourceRoot":"","sources":["../src/group-sharing-comments.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EACL,KAAK,sBAAsB,EAI5B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAG5B,KAAK,iBAAiB,EACvB,MAAM,8BAA8B,CAAC;AAQtC,MAAM,MAAM,2BAA2B,GAAG,uBAAuB,GAAG;IAClE,6FAA6F;IAC7F,MAAM,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,OAAO,CAAC;CAC9C,CAAC;AACF,MAAM,MAAM,yBAAyB,GAAG,uBAAuB,GAAG;IAChE,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AACF,MAAM,MAAM,gCAAgC,GAAG,iBAAiB,GAAG;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AA6HF,2FAA2F;AAC3F,qBAAa,0BAA0B;IAEnC,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,8EAA8E;IAC9E,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAHb,EAAE,EAAE,iBAAiB,EACrB,SAAS,EAAE,sBAAsB;IAClD,8EAA8E;IAC7D,aAAa,UAAQ;IAExC,OAAO,CAAC,GAAG;IAML,kBAAkB,CACtB,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,wBAAwB,CAAC;IA+C9B,oBAAoB,CACxB,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,aAAa,CAAC,wBAAwB,CAAC,CAAC;IAmG7C,yBAAyB,CAC7B,KAAK,EAAE,gCAAgC,GACtC,OAAO,CAAC,wBAAwB,CAAC;CA8DrC"}

package/dist/group-sharing-contracts.d.ts

@@ -0,0 +1,201 @@
+import type { WorkbookAssessment, WorkbookConceptSummary } from './workbook-contracts.js';
+export type GroupSharingSelector = {
+    mode: 'all';
+} | {
+    mode: 'include';
+    values: string[];
+};
+export interface GroupSharingPolicyV1 {
+    schemaVersion: 1;
+    shareWork: boolean;
+    shareMedia: boolean;
+    shareFeedback: boolean;
+    shareProgress: boolean;
+    parentReviewedOnly: boolean;
+    commentVisibility: 'parent-only' | 'learner-visible';
+    historyFrom: string;
+    subjects: GroupSharingSelector;
+    courseIds: GroupSharingSelector;
+}
+export interface GroupSharingActor {
+    actorUserId: string;
+    sessionId: string;
+}
+export interface GroupSharingScope extends GroupSharingActor {
+    groupId: string;
+    familyTenantId: string;
+    learnerId: string;
+}
+export interface GroupSharedWorkSelector extends GroupSharingScope {
+    activityId: string;
+    attemptId: string;
+    revisionId?: string;
+}
+export interface GroupSharingWorkFacts {
+    capturedAt: string;
+    courseId: string | null;
+    subject: string | null;
+    parentReviewed: boolean;
+}
+export interface GroupSharingDecision {
+    eligible: boolean;
+    work: boolean;
+    media: boolean;
+    feedback: boolean;
+    progress: boolean;
+    reasons: string[];
+}
+export type GroupLearnerInvitationStatus = 'pending' | 'accepted' | 'revoked' | 'declined';
+export type GroupLearnerMembershipStatus = 'active' | 'revoked';
+export interface EducationGroupView {
+    readonly id: string;
+    readonly tenantId: string;
+    readonly name: string;
+    readonly active: boolean;
+    readonly creatorUserId: string;
+    readonly creatorProfileId: string;
+}
+export interface GroupLearnerInvitationView {
+    readonly id: string;
+    readonly groupId: string;
+    readonly familyTenantId: string;
+    readonly learnerId: string;
+    readonly invitedParentUserId: string;
+    readonly creatorUserId: string;
+    readonly expiresAt: string;
+    readonly status: GroupLearnerInvitationStatus;
+    readonly acceptedMembershipId: string | null;
+    readonly acceptedPolicyDigest: string;
+}
+/** Parent-only invitation detail; current exact guardian proof is required. */
+export interface GroupLearnerParentInvitationView extends GroupLearnerInvitationView {
+    readonly groupName: string;
+    readonly learnerDisplayName: string;
+}
+export interface GroupLearnerMembershipView {
+    readonly id: string;
+    readonly familyTenantId: string;
+    readonly groupId: string;
+    readonly learnerId: string;
+    readonly consentParentUserId: string;
+    readonly status: GroupLearnerMembershipStatus;
+    readonly policyVersion: number;
+}
+/** Family-owned participation summary retained after leaving or group disabling. */
+export interface GroupLearnerMembershipSummaryView extends GroupLearnerMembershipView {
+    readonly groupName: string;
+    readonly groupActive: boolean;
+}
+export interface GroupSharingPolicyHistoryEntryView {
+    readonly id: string;
+    readonly membershipId: string;
+    readonly familyTenantId: string;
+    readonly version: number;
+    readonly schemaVersion: 1;
+    readonly policy: GroupSharingPolicyV1;
+    readonly actorUserId: string;
+    readonly recordedAt: string;
+}
+export interface GroupSharingPolicyHistoryView {
+    readonly policies: ReadonlyArray<GroupSharingPolicyHistoryEntryView>;
+    readonly nextAfterVersion: number | null;
+}
+/** Authorized roster identity; exposes no family account or profile metadata. */
+export interface GroupLearnerRosterView extends GroupLearnerMembershipView {
+    readonly learnerDisplayName: string;
+}
+export interface GroupSharedWorkView {
+    readonly activityId: string;
+    readonly attemptId: string;
+    readonly submissionId: string;
+    readonly capturedAt: string;
+    readonly courseId: string | null;
+    readonly subject: string | null;
+    readonly facets: GroupSharingDecision;
+    readonly revisionId: string | null;
+    readonly commentRevisionId: string | null;
+    readonly media: ReadonlyArray<{
+        assetId: string;
+        sha256: string;
+        pageCount: number;
+    }>;
+}
+export interface GroupSharedRevisionView {
+    readonly activityId: string;
+    readonly attemptId: string;
+    readonly submissionId: string;
+    readonly revisionId: string;
+    readonly createdAt: string;
+    readonly kind: 'ai' | 'guardian';
+    readonly assessment: WorkbookAssessment;
+}
+export interface GroupSharingPreview {
+    readonly policy: GroupSharingPolicyV1;
+    readonly works: ReadonlyArray<{
+        activityId: string;
+        attemptId: string;
+        submissionId: string;
+        decision: GroupSharingDecision;
+    }>;
+}
+export interface GroupSharedProgressView {
+    readonly algorithmVersion: 'workbook-descriptive-v1';
+    readonly counts: {
+        attempts: number;
+        episodes: number;
+        assistance: {
+            independent: number;
+            assisted: number;
+            unknown: number;
+        };
+    };
+    readonly concepts: ReadonlyArray<WorkbookConceptSummary>;
+}
+export interface GroupRevisionCommentView {
+    readonly id: string;
+    readonly familyTenantId: string;
+    readonly membershipId: string;
+    readonly learnerId: string;
+    readonly activityId: string;
+    readonly attemptId: string;
+    readonly revisionId: string;
+    readonly authorUserId: string;
+    readonly authorProfileId: string;
+    readonly body: string;
+    readonly recordedAt: string;
+    readonly childVisible: boolean;
+    readonly visibilityActorUserId: string | null;
+    readonly visibilityChangedAt: string | null;
+    readonly visibilityVersion: number;
+}
+export declare class GroupSharingAuthorizationError extends Error {
+    constructor(message?: string);
+}
+export declare class GroupSharingConflictError extends Error {
+    constructor(message?: string);
+}
+export declare class GroupSharingPolicyValidationError extends Error {
+    constructor(message?: string);
+}
+/** Reject missing/unknown fields and unsupported versions rather than widening consent. */
+export declare function validateGroupSharingPolicy(value: unknown): asserts value is GroupSharingPolicyV1;
+/** Stable representation for immutable acceptance digests and policy snapshots. */
+export declare function canonicalGroupSharingPolicy(value: unknown): string;
+/** Submitted opaque selectors only; conveys no family data or continuing authority. */
+export interface GroupLearnerRosterEntryView {
+    readonly id: string;
+    readonly groupId: string;
+    readonly familyTenantId: string;
+    readonly learnerId: string;
+    readonly membershipId: string;
+}
+/** Current guardian choices for this learner, independent of any group consent. */
+export interface GroupSharingPolicyOptionsView {
+    readonly courses: ReadonlyArray<{
+        id: string;
+        label: string;
+        subject: string | null;
+    }>;
+    readonly subjects: ReadonlyArray<string>;
+}
+//# sourceMappingURL=group-sharing-contracts.d.ts.map

package/dist/group-sharing-contracts.d.ts.map

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

package/dist/group-sharing-hash.d.ts

@@ -0,0 +1,3 @@
+/** Resolve server hashing only when called; recipe/model roots remain browser-safe. */
+export declare function groupSharingDigest(value: string | Uint8Array): string;
+//# sourceMappingURL=group-sharing-hash.d.ts.map

package/dist/group-sharing-hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-sharing-hash.d.ts","sourceRoot":"","sources":["../src/group-sharing-hash.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAMrE"}

package/dist/group-sharing-models.d.ts

@@ -0,0 +1,106 @@
+import { SmrtCollection, SmrtObject, type SmrtSaveOptions } from '@happyvertical/smrt-core';
+import { type GroupLearnerInvitationStatus, type GroupLearnerMembershipStatus, type GroupSharingPolicyV1 } from './group-sharing-contracts.js';
+/** Independent group tenant metadata; no family authority is implied. */
+export declare class EducationGroup extends SmrtObject {
+    tenantId: string;
+    name: string;
+    active: boolean;
+    creatorUserId: string;
+    creatorProfileId: string;
+    constructor(options?: Record<string, unknown>);
+    save(options?: SmrtSaveOptions): Promise<this>;
+    delete(): Promise<void>;
+}
+export declare class EducationGroupCollection extends SmrtCollection<EducationGroup> {
+    static readonly _itemClass: typeof EducationGroup;
+}
+/** Group-owned target selectors are opaque until the exact parent accepts. */
+export declare class GroupLearnerInvitation extends SmrtObject {
+    tenantId: string;
+    groupId: string;
+    familyTenantId: string;
+    learnerId: string;
+    invitedParentUserId: string;
+    creatorUserId: string;
+    expiresAt: Date;
+    status: GroupLearnerInvitationStatus;
+    acceptedMembershipId: string | null;
+    acceptedPolicyDigest: string;
+    constructor(options?: Record<string, unknown>);
+    save(options?: SmrtSaveOptions): Promise<this>;
+    delete(): Promise<void>;
+}
+export declare class GroupLearnerInvitationCollection extends SmrtCollection<GroupLearnerInvitation> {
+    static readonly _itemClass: typeof GroupLearnerInvitation;
+}
+/** Family-owned per-child consent edge, never a users membership. */
+export declare class GroupLearnerMembership extends SmrtObject {
+    tenantId: string;
+    groupId: string;
+    learnerId: string;
+    consentParentUserId: string;
+    status: GroupLearnerMembershipStatus;
+    policyVersion: number;
+    constructor(options?: Record<string, unknown>);
+    save(options?: SmrtSaveOptions): Promise<this>;
+    delete(): Promise<void>;
+}
+export declare class GroupLearnerMembershipCollection extends SmrtCollection<GroupLearnerMembership> {
+    static readonly _itemClass: typeof GroupLearnerMembership;
+}
+/** Immutable explicit policy snapshot. */
+export declare class GroupSharingPolicy extends SmrtObject {
+    tenantId: string;
+    membershipId: string;
+    version: number;
+    schemaVersion: number;
+    policyJson: string;
+    actorUserId: string;
+    recordedAt: Date;
+    constructor(options?: Record<string, unknown>);
+    getPolicy(): GroupSharingPolicyV1;
+    setPolicy(value: unknown): void;
+    save(options?: SmrtSaveOptions): Promise<this>;
+    delete(): Promise<void>;
+}
+export declare class GroupSharingPolicyCollection extends SmrtCollection<GroupSharingPolicy> {
+    static readonly _itemClass: typeof GroupSharingPolicy;
+}
+/** Attributed revision comment, separate from grading and evidence. */
+export declare class GroupRevisionComment extends SmrtObject {
+    tenantId: string;
+    membershipId: string;
+    learnerId: string;
+    activityId: string;
+    attemptId: string;
+    revisionId: string;
+    authorUserId: string;
+    authorProfileId: string;
+    body: string;
+    recordedAt: Date;
+    childVisible: boolean;
+    visibilityActorUserId: string | null;
+    visibilityChangedAt: Date | null;
+    visibilityVersion: number;
+    constructor(options?: Record<string, unknown>);
+    save(options?: SmrtSaveOptions): Promise<this>;
+    delete(): Promise<void>;
+}
+export declare class GroupRevisionCommentCollection extends SmrtCollection<GroupRevisionComment> {
+    static readonly _itemClass: typeof GroupRevisionComment;
+}
+/** Group-owned opaque roster index; authoritative consent remains family-owned. */
+export declare class GroupLearnerRosterEntry extends SmrtObject {
+    tenantId: string;
+    groupId: string;
+    familyTenantId: string;
+    learnerId: string;
+    membershipId: string;
+    constructor(options?: Record<string, unknown>);
+    save(options?: SmrtSaveOptions): Promise<this>;
+    delete(): Promise<void>;
+}
+export declare class GroupLearnerRosterEntryCollection extends SmrtCollection<GroupLearnerRosterEntry> {
+    static readonly _itemClass: typeof GroupLearnerRosterEntry;
+}
+//# sourceMappingURL=group-sharing-models.d.ts.map

package/dist/group-sharing-models.d.ts.map

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

package/dist/group-sharing-policy.d.ts

@@ -0,0 +1,19 @@
+import { type GroupSharingDecision, type GroupSharingPolicyV1, type GroupSharingWorkFacts } from './group-sharing-contracts.js';
+import type { WorkbookAssessment, WorkbookConceptSummary } from './workbook-contracts.js';
+/** All facets use the same fail-closed eligibility gates. Facts come from owned records. */
+export declare function evaluateGroupSharingPolicy(policy: GroupSharingPolicyV1, facts: GroupSharingWorkFacts): GroupSharingDecision;
+export interface WorkbookEvidenceInput {
+    attempt: {
+        submissionId: string;
+        episodeId: string;
+        previousAttemptId: string | null;
+        assistance: string;
+        capturedAt: Date;
+    };
+    revisionId: string;
+    assessment: WorkbookAssessment;
+    confirmed: boolean;
+}
+/** Owning workbook aggregation shared by family and filtered group projections. */
+export declare function summarizeWorkbookEvidence(evidence: WorkbookEvidenceInput[]): WorkbookConceptSummary[];
+//# sourceMappingURL=group-sharing-policy.d.ts.map

package/dist/group-sharing-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-sharing-policy.d.ts","sourceRoot":"","sources":["../src/group-sharing-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAE3B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EACV,kBAAkB,EAElB,sBAAsB,EACvB,MAAM,yBAAyB,CAAC;AAEjC,4FAA4F;AAC5F,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,oBAAoB,EAC5B,KAAK,EAAE,qBAAqB,GAC3B,oBAAoB,CA+BtB;AACD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE;QACP,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;QACjC,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,IAAI,CAAC;KAClB,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,SAAS,EAAE,OAAO,CAAC;CACpB;AACD,mFAAmF;AACnF,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,qBAAqB,EAAE,GAChC,sBAAsB,EAAE,CAsF1B"}

package/dist/group-sharing-reader.d.ts

@@ -0,0 +1,45 @@
+import type { DatabaseInterface } from '@happyvertical/sql';
+import { type GroupSharingAction, type GroupSharingAuthorizer } from './group-sharing-authorization.js';
+import { type GroupSharedProgressView, type GroupSharedRevisionView, type GroupSharedWorkSelector, type GroupSharedWorkView, type GroupSharingPolicyOptionsView, type GroupSharingPolicyV1, type GroupSharingPreview, type GroupSharingScope } from './group-sharing-contracts.js';
+import type { SubmissionServiceOptions } from './submission-service.js';
+/** Exact immutable binding seam for comments already executing inside the owning transaction. */
+export declare function readSharedRevisionInScope(db: DatabaseInterface, authorize: GroupSharingAuthorizer, request: GroupSharedWorkSelector, action?: GroupSharingAction): Promise<{
+    activityId: string;
+    attemptId: string;
+    submissionId: string;
+    revisionId: string;
+}>;
+/** Read-only owning boundary. Every method revalidates current authority on its active executor. */
+export declare class GroupSharingReader {
+    private readonly db;
+    private readonly authorize;
+    private readonly options?;
+    private readonly executorBound;
+    constructor(db: DatabaseInterface, authorize: GroupSharingAuthorizer, options?: SubmissionServiceOptions | undefined, executorBound?: boolean);
+    private run;
+    /** Guardian-owned choices before invitation acceptance; never enumerates another child's courses. */
+    getSharingPolicyOptions(request: Omit<GroupSharingScope, 'groupId'>): Promise<GroupSharingPolicyOptionsView>;
+    private enumerate;
+    previewSharing(request: GroupSharingScope & {
+        policy?: GroupSharingPolicyV1;
+    }): Promise<GroupSharingPreview>;
+    private project;
+    listSharedWork(request: GroupSharingScope & {
+        cursor?: string;
+        limit?: number;
+    }): Promise<{
+        works: GroupSharedWorkView[];
+        nextCursor: string | null;
+    }>;
+    getSharedWork(request: GroupSharedWorkSelector): Promise<GroupSharedWorkView>;
+    getSharedRevision(request: GroupSharedWorkSelector): Promise<GroupSharedRevisionView>;
+    getSharedProgress(request: GroupSharingScope): Promise<GroupSharedProgressView>;
+    readSharedMedia(request: GroupSharedWorkSelector & {
+        assetId: string;
+    }): Promise<{
+        data: Buffer;
+        mimeType: string;
+        cacheControl: 'private, no-store';
+    }>;
+}
+//# sourceMappingURL=group-sharing-reader.d.ts.map

package/dist/group-sharing-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-sharing-reader.d.ts","sourceRoot":"","sources":["../src/group-sharing-reader.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAY5D,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAG5B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EAExB,KAAK,6BAA6B,EAClC,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EAEvB,MAAM,8BAA8B,CAAC;AAOtC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AA4PxE,iGAAiG;AACjG,wBAAsB,yBAAyB,CAC7C,EAAE,EAAE,iBAAiB,EACrB,SAAS,EAAE,sBAAsB,EACjC,OAAO,EAAE,uBAAuB,EAChC,MAAM,GAAE,kBAA8C;;;;;GAcvD;AACD,oGAAoG;AACpG,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAHb,EAAE,EAAE,iBAAiB,EACrB,SAAS,EAAE,sBAAsB,EACjC,OAAO,CAAC,EAAE,wBAAwB,YAAA,EAClC,aAAa,UAAQ;IAExC,OAAO,CAAC,GAAG;IA+CX,qGAAqG;IAC/F,uBAAuB,CAC3B,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,SAAS,CAAC,GAC1C,OAAO,CAAC,6BAA6B,CAAC;YA4E3B,SAAS;IAwCjB,cAAc,CAClB,OAAO,EAAE,iBAAiB,GAAG;QAAE,MAAM,CAAC,EAAE,oBAAoB,CAAA;KAAE,GAC7D,OAAO,CAAC,mBAAmB,CAAC;IAqB/B,OAAO,CAAC,OAAO;IAkBT,cAAc,CAClB,OAAO,EAAE,iBAAiB,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/D,OAAO,CAAC;QAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAqBjE,aAAa,CACjB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,mBAAmB,CAAC;IAOzB,iBAAiB,CACrB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,uBAAuB,CAAC;IAsB7B,iBAAiB,CACrB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,uBAAuB,CAAC;IA+C7B,eAAe,CACnB,OAAO,EAAE,uBAAuB,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GACrD,OAAO,CAAC;QACT,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,mBAAmB,CAAC;KACnC,CAAC;CA2DH"}