timeback-studio 0.1.0

package/dist/server/services/bootstrap.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Bootstrap Service
+ *
+ * Business logic for bootstrapping Studio with user and course data.
+ */
+import type { TimebackClient } from '@timeback/core';
+import type { BootstrapResult, GetBootstrapOptions } from './types';
+/**
+ * Service for bootstrapping Studio with initial data.
+ *
+ * Fetches user, courses, components, classes, enrollments, and resources.
+ */
+export declare class BootstrapService {
+    private readonly client;
+    constructor(client: TimebackClient);
+    /**
+     * Get bootstrap data.
+     *
+     * @param options - Bootstrap options (email, courseIds)
+     * @returns User, courses, components, classes, enrollments, and errors
+     */
+    getBootstrap(options: GetBootstrapOptions): Promise<BootstrapResult>;
+    /**
+     * Compute stats from enrollment data.
+     *
+     * @param enrollmentData - Enrollment data with unique IDs
+     * @param courses - All courses
+     * @returns Aggregate stats
+     */
+    private computeStats;
+    private fetchCourseStructure;
+    private enrichEnrollmentsWithUsers;
+    private fetchResources;
+    private fetchCourses;
+    private fetchCurrentUser;
+    private fetchEnrollments;
+}
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/server/services/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../../src/server/services/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAGpD,OAAO,KAAK,EACX,eAAe,EAIf,mBAAmB,EACnB,MAAM,SAAS,CAAA;AAyBhB;;;;GAIG;AACH,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IAEvC,YAAY,MAAM,EAAE,cAAc,EAEjC;IAED;;;;;OAKG;IACG,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,CA8CzE;IAMD;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;YAkBN,oBAAoB;YAoEpB,0BAA0B;YAuC1B,cAAc;YA0Cd,YAAY;YAgCZ,gBAAgB;YAyBhB,gBAAgB;CAuD9B"}

package/dist/server/services/enrollment.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Enrollment Service
+ *
+ * Business logic for enrolling and unenrolling students.
+ */
+import type { TimebackClient } from '@timeback/core';
+import type { EnrollmentActionOptions, EnrollmentResult, EnrollStudentOptions } from './types';
+/**
+ * Service for managing student enrollments.
+ *
+ * Handles enrolling, unenrolling, and reactivating students in classes.
+ */
+export declare class EnrollmentService {
+    private readonly client;
+    constructor(client: TimebackClient);
+    /**
+     * Enroll a student in a class.
+     *
+     * Creates a new enrollment linking the student to the specified class.
+     *
+     * @param options - Enrollment options (classId, userId)
+     * @returns Result with enrollment ID or errors
+     */
+    enroll(options: EnrollStudentOptions): Promise<EnrollmentResult>;
+    /**
+     * Unenroll a student from a class.
+     *
+     * Marks the enrollment as 'tobedeleted'.
+     *
+     * @param options - Unenrollment options (enrollmentId)
+     * @returns Result indicating success or errors
+     */
+    unenroll(options: EnrollmentActionOptions): Promise<EnrollmentResult>;
+    /**
+     * Reactivate a student enrollment.
+     *
+     * Marks the enrollment as 'active'.
+     *
+     * @param options - Reactivation options (enrollmentId)
+     * @returns Result indicating success or errors
+     */
+    reactivate(options: EnrollmentActionOptions): Promise<EnrollmentResult>;
+    /**
+     * Handle enrollment operation errors consistently.
+     *
+     * @param error - The caught error
+     * @param operation - Name of the operation for logging
+     * @param context - Context data for logging
+     * @param errors - Error array to push to
+     * @returns Failure result
+     */
+    private handleEnrollmentError;
+}
+//# sourceMappingURL=enrollment.d.ts.map

package/dist/server/services/enrollment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrollment.d.ts","sourceRoot":"","sources":["../../../src/server/services/enrollment.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEpD,OAAO,KAAK,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAI9F;;;;GAIG;AACH,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IAEvC,YAAY,MAAM,EAAE,cAAc,EAEjC;IAED;;;;;;;OAOG;IACG,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA0BrE;IAED;;;;;;;OAOG;IACG,QAAQ,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAqB1E;IAED;;;;;;;OAOG;IACG,UAAU,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAqB5E;IAED;;;;;;;;OAQG;IACH,OAAO,CAAC,qBAAqB;CAuB7B"}

package/dist/server/services/events.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Events Service
+ *
+ * Business logic for fetching Caliper events (Activity and Time Spent).
+ */
+import type { TimebackClient } from '@timeback/core';
+import type { Caliper } from '@timeback/core/types';
+import type { GetNewEventsOptions, GetRecentEventsOptions } from './types';
+/**
+ * Service for fetching and managing Caliper events.
+ *
+ * Handles delta sync, backward pagination, and real-time polling.
+ */
+export declare class EventsService {
+    private readonly client;
+    private readonly sensors;
+    constructor(client: TimebackClient, sensors?: string[]);
+    /**
+     * Fetch recent events, optionally filtered by timestamp.
+     *
+     * Supports two pagination modes:
+     * - `since`: Delta sync - paginates to catch up on ALL events after this timestamp
+     * - `before`: Backward pagination - fetch events BEFORE this timestamp (for older events)
+     *
+     * Delta sync uses large batch limits and paginates until caught up, capped at syncMaxTotal.
+     *
+     * @param options - Fetch options (limit, since, before)
+     * @returns Array of stored events
+     */
+    getRecent(options?: GetRecentEventsOptions): Promise<Caliper.StoredEvent[]>;
+    /**
+     * Fetch new events since a given timestamp.
+     *
+     * Used for polling to get events that occurred after the last fetch.
+     *
+     * @param options - Fetch options (since)
+     * @returns Array of new events
+     */
+    getNew(options: GetNewEventsOptions): Promise<Caliper.StoredEvent[]>;
+    /**
+     * Deduplicate events by id and sort by eventTime descending.
+     *
+     * @param events - Array of events (may contain duplicates)
+     * @returns Deduplicated and sorted events
+     */
+    private dedupeAndSort;
+    private fetchEvents;
+    private fetchEventsSince;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/server/services/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/server/services/events.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAA;AAa1E;;;;GAIG;AACH,qBAAa,aAAa;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAE9C,YAAY,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,EAGrD;IAMD;;;;;;;;;;;OAWG;IACG,SAAS,CAAC,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAqCpF;IAED;;;;;;;OAOG;IACG,MAAM,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAiBzE;IAMD;;;;;OAKG;IACH,OAAO,CAAC,aAAa;YAwBP,WAAW;YA4BX,gBAAgB;CA+C9B"}

package/dist/server/services/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Services Index
+ *
+ * Exports all service classes and their types.
+ */
+export { BootstrapService } from './bootstrap';
+export { EnrollmentService } from './enrollment';
+export { EventsService } from './events';
+export { LiveService } from './live';
+export { StatusService } from './status';
+export { StudentSearchService } from './student-search';
+export type { BootstrapResult, BootstrapStats, EnrichedComponentResource, EnrichedEnrollment, GetBootstrapOptions, EnrollmentActionOptions, EnrollmentResult, EnrollStudentOptions, GetNewEventsOptions, GetRecentEventsOptions, TickResult, TickState, SearchStudentsOptions, StudentSearchResponse, StudentSearchResult, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAMvD,YAAY,EAEX,eAAe,EACf,cAAc,EACd,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EAEnB,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,EAEpB,mBAAmB,EACnB,sBAAsB,EAEtB,UAAU,EACV,SAAS,EAET,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,GACnB,MAAM,SAAS,CAAA"}

package/dist/server/services/live.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Live Service
+ *
+ * Orchestrates multiple data sources for the multiplexed /api/live SSE endpoint.
+ *
+ * ## How It Works
+ *
+ * The SSE connection ticks every 1 second (base interval). On each tick,
+ * this service decides what to check based on each data source's rules:
+ *
+ * ```
+ * runSSE setInterval(1s)
+ *   => every tick, calls liveService.tick(state)
+ *
+ *   liveService.tick():
+ *     => ALWAYS fetch status, but only emit if hash changed
+ *     => Check if 30s elapsed since lastEventsTick:
+ *        - YES: fetch events, emit if any new
+ *        - NO: skip events entirely
+ *
+ *     => return { updates: [...], newState }
+ * ```
+ *
+ * ## Data Sources
+ *
+ * | Source  | Check Frequency | Emit Condition      |
+ * |---------|-----------------|---------------------|
+ * | Status  | Every tick (1s) | Payload hash changed |
+ * | Events  | Every 30s       | New events exist    |
+ *
+ * This means 29 out of 30 ticks only check status. The 30th tick checks both.
+ */
+import type { EventsService } from './events';
+import type { StatusService } from './status';
+import type { TickResult, TickState } from './types';
+/**
+ * Options for creating a LiveService.
+ */
+interface LiveServiceOptions {
+    statusService: StatusService;
+    eventsService: EventsService;
+}
+/**
+ * Service that orchestrates status and event updates for the multiplexed SSE endpoint.
+ *
+ * Each SSE connection gets its own instance. The service manages independent tick
+ * intervals: status is checked every tick (1s) but only emitted on hash change,
+ * while events are fetched every 30s and emitted when new events exist.
+ */
+export declare class LiveService {
+    private readonly statusService;
+    private readonly eventsService;
+    constructor(options: LiveServiceOptions);
+    /**
+     * Create initial tick state for a new SSE connection.
+     *
+     * @returns Fresh tick state with empty hash and current timestamps
+     */
+    static createInitialState(): TickState;
+    /**
+     * Perform a tick operation.
+     *
+     * Called every base tick (1s) by the SSE loop. Checks each data source
+     * according to its rules and returns any updates to emit.
+     *
+     * @param state - Current tick state from previous tick
+     * @returns Updates to emit and new state for next tick
+     */
+    tick(state: TickState): Promise<TickResult>;
+    /**
+     * Check if enough time has passed since the last check.
+     *
+     * @param lastTick - Timestamp (ms) of last check
+     * @param now - Current timestamp (ms)
+     * @param intervalMs - Required interval between checks
+     * @returns True if interval has elapsed
+     */
+    private hasIntervalElapsed;
+    private fetchStatusIfChanged;
+    private fetchEventsIfNew;
+}
+export {};
+//# sourceMappingURL=live.d.ts.map

package/dist/server/services/live.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../../../src/server/services/live.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAYH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAIpD;;GAEG;AACH,UAAU,kBAAkB;IAC3B,aAAa,EAAE,aAAa,CAAA;IAC5B,aAAa,EAAE,aAAa,CAAA;CAC5B;AAED;;;;;;GAMG;AACH,qBAAa,WAAW;IACvB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAC7C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAE7C,YAAY,OAAO,EAAE,kBAAkB,EAGtC;IAED;;;;OAIG;IACH,MAAM,CAAC,kBAAkB,IAAI,SAAS,CAQrC;IAED;;;;;;;;OAQG;IACG,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAoChD;IAED;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB;YAUZ,oBAAoB;YA4BpB,gBAAgB;CAiC9B"}

package/dist/server/services/status.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Status Service
+ *
+ * Business logic for server status and configuration.
+ */
+import type { AppContext } from '../../config';
+import type { StatusEventPayload } from '../../types';
+/**
+ * Service for server status and configuration.
+ *
+ * Note: This service uses AppContext rather than TimebackClient,
+ * so it's instantiated separately from other services.
+ */
+export declare class StatusService {
+    private readonly ctx;
+    constructor(ctx: AppContext);
+    /**
+ * Build the status payload.
+ *
+ * @returns Status payload object
+ */
+    getStatus(): Promise<StatusEventPayload>;
+}
+//# sourceMappingURL=status.d.ts.map

package/dist/server/services/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/server/services/status.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAErD;;;;;GAKG;AACH,qBAAa,aAAa;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;IAEhC,YAAY,GAAG,EAAE,UAAU,EAE1B;IAED;;;;GAIE;IACI,SAAS,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAU7C;CACD"}

package/dist/server/services/student-search.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Student Search Service
+ *
+ * Business logic for searching students globally.
+ */
+import type { TimebackClient } from '@timeback/core';
+import type { SearchStudentsOptions, StudentSearchResponse } from './types';
+/**
+ * Service for searching students.
+ */
+export declare class StudentSearchService {
+    private readonly client;
+    constructor(client: TimebackClient);
+    /**
+     * Search students by name or email.
+     *
+     * Uses the `search` parameter which performs free-text search across
+     * givenName, familyName, and email fields.
+     *
+     * @param options - Search options (query, max)
+     * @returns Matching students and any errors
+     */
+    search(options: SearchStudentsOptions): Promise<StudentSearchResponse>;
+    /**
+     * Transform OneRoster User to simplified StudentSearchResult.
+     *
+     * @param user - OneRoster user object
+     * @returns Simplified student result
+     */
+    private toSearchResult;
+}
+//# sourceMappingURL=student-search.d.ts.map

package/dist/server/services/student-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"student-search.d.ts","sourceRoot":"","sources":["../../../src/server/services/student-search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAGpD,OAAO,KAAK,EAAE,qBAAqB,EAAE,qBAAqB,EAAuB,MAAM,SAAS,CAAA;AAIhG;;GAEG;AACH,qBAAa,oBAAoB;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IAEvC,YAAY,MAAM,EAAE,cAAc,EAEjC;IAED;;;;;;;;OAQG;IACG,MAAM,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAwC3E;IAED;;;;;OAKG;IACH,OAAO,CAAC,cAAc;CAUtB"}

package/dist/server/services/types/bootstrap.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Bootstrap Service Types
+ */
+import type { OneRoster } from '@timeback/core/types';
+import type { StudioError } from '../../lib';
+/**
+ * Enrollment with embedded user details.
+ */
+export interface EnrichedEnrollment extends OneRoster.Enrollment {
+    userDetails?: OneRoster.User;
+}
+/**
+ * ComponentResource with embedded resource details.
+ */
+export interface EnrichedComponentResource extends OneRoster.ComponentResource {
+    resourceDetails?: OneRoster.Resource;
+}
+/**
+ * Bootstrap statistics.
+ */
+export interface BootstrapStats {
+    totalStudents: number;
+    totalTeachers: number;
+    totalCourses: number;
+}
+/**
+ * Options for getting bootstrap data.
+ */
+export interface GetBootstrapOptions {
+    email?: string;
+    courseIds: string[];
+}
+/**
+ * Result of bootstrap data fetch.
+ */
+export interface BootstrapResult {
+    user: OneRoster.User | null;
+    courses: OneRoster.Course[];
+    components: OneRoster.CourseComponent[];
+    componentResources: EnrichedComponentResource[];
+    classes: OneRoster.Class[];
+    enrollments: EnrichedEnrollment[];
+    classEnrollmentCounts: Record<string, number>;
+    stats: BootstrapStats;
+    errors: StudioError[];
+}
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/server/services/types/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../../../src/server/services/types/bootstrap.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAE5C;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,SAAS,CAAC,UAAU;IAC/D,WAAW,CAAC,EAAE,SAAS,CAAC,IAAI,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,SAAS,CAAC,iBAAiB;IAC7E,eAAe,CAAC,EAAE,SAAS,CAAC,QAAQ,CAAA;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,SAAS,CAAC,IAAI,GAAG,IAAI,CAAA;IAC3B,OAAO,EAAE,SAAS,CAAC,MAAM,EAAE,CAAA;IAC3B,UAAU,EAAE,SAAS,CAAC,eAAe,EAAE,CAAA;IACvC,kBAAkB,EAAE,yBAAyB,EAAE,CAAA;IAC/C,OAAO,EAAE,SAAS,CAAC,KAAK,EAAE,CAAA;IAC1B,WAAW,EAAE,kBAAkB,EAAE,CAAA;IACjC,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7C,KAAK,EAAE,cAAc,CAAA;IACrB,MAAM,EAAE,WAAW,EAAE,CAAA;CACrB"}

package/dist/server/services/types/enrollment.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Enrollment Service Types
+ */
+import type { StudioError } from '../../lib';
+/**
+ * Result of an enrollment operation.
+ */
+export interface EnrollmentResult {
+    success: boolean;
+    enrollmentId?: string;
+    errors: StudioError[];
+}
+/**
+ * Options for enrolling a student.
+ */
+export interface EnrollStudentOptions {
+    classId: string;
+    userId: string;
+}
+/**
+ * Options for unenrolling or reactivating a student.
+ */
+export interface EnrollmentActionOptions {
+    enrollmentId: string;
+}
+//# sourceMappingURL=enrollment.d.ts.map

package/dist/server/services/types/enrollment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrollment.d.ts","sourceRoot":"","sources":["../../../../src/server/services/types/enrollment.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAE5C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,OAAO,EAAE,OAAO,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,WAAW,EAAE,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC,YAAY,EAAE,MAAM,CAAA;CACpB"}

package/dist/server/services/types/events.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Events Service Types
+ */
+/**
+ * Options for fetching recent events.
+ */
+export interface GetRecentEventsOptions {
+    /** Maximum number of events to fetch */
+    limit?: number;
+    /** Only fetch events after this ISO timestamp (delta sync) */
+    since?: string;
+    /** Only fetch events before this ISO timestamp (pagination for older events) */
+    before?: string;
+}
+/**
+ * Options for fetching new events (polling).
+ */
+export interface GetNewEventsOptions {
+    /** ISO timestamp to fetch events after */
+    since: string;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/server/services/types/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../src/server/services/types/events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAA;CACb"}

package/dist/server/services/types/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Service Types
+ *
+ * Barrel file for all service type exports.
+ */
+export type { BootstrapResult, BootstrapStats, EnrichedComponentResource, EnrichedEnrollment, GetBootstrapOptions, } from './bootstrap';
+export type { EnrollmentActionOptions, EnrollmentResult, EnrollStudentOptions } from './enrollment';
+export type { GetNewEventsOptions, GetRecentEventsOptions } from './events';
+export type { SearchStudentsOptions, StudentSearchResponse, StudentSearchResult, } from './student-search';
+export type { TickResult, TickState } from './live';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/services/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/services/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACX,eAAe,EACf,cAAc,EACd,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,GACnB,MAAM,aAAa,CAAA;AAEpB,YAAY,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAEnG,YAAY,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAA;AAE3E,YAAY,EACX,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,GACnB,MAAM,kBAAkB,CAAA;AAEzB,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA"}

package/dist/server/services/types/live.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Live Service Types
+ *
+ * Types for the multiplexed SSE endpoint that combines status and events.
+ */
+import type { LiveUpdate } from '../../../types';
+/**
+ * Per-connection state for tracking when to check each data source.
+ *
+ * Each SSE connection maintains its own TickState. The LiveService uses
+ * this state to determine:
+ * - Status: Has the payload hash changed since last emit?
+ * - Events: Has 30s elapsed since last check?
+ */
+export interface TickState {
+    /** Hash of last emitted status payload. Empty string on first tick. */
+    lastStatusHash: string;
+    /** Timestamp (ms) of last status check. Used for diagnostics. */
+    lastStatusTick: number;
+    /** ISO timestamp of most recent event. Used as cursor for "since" queries. */
+    lastEventTime: string;
+    /** Timestamp (ms) of last events check. Used to enforce 30s interval. */
+    lastEventsTick: number;
+}
+/**
+ * Result of a tick operation.
+ */
+export interface TickResult {
+    /** Updates to emit to the client (may be empty if nothing changed) */
+    updates: LiveUpdate[];
+    /** Updated state to pass to the next tick */
+    newState: TickState;
+}
+//# sourceMappingURL=live.d.ts.map

package/dist/server/services/types/live.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../../../../src/server/services/types/live.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAEhD;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IAKzB,uEAAuE;IACvE,cAAc,EAAE,MAAM,CAAA;IAEtB,iEAAiE;IACjE,cAAc,EAAE,MAAM,CAAA;IAMtB,8EAA8E;IAC9E,aAAa,EAAE,MAAM,CAAA;IAErB,yEAAyE;IACzE,cAAc,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,sEAAsE;IACtE,OAAO,EAAE,UAAU,EAAE,CAAA;IAErB,6CAA6C;IAC7C,QAAQ,EAAE,SAAS,CAAA;CACnB"}

package/dist/server/services/types/student-search.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Student Search Service Types
+ */
+import type { StudioError } from '../../lib';
+/**
+ * Simplified student search result.
+ */
+export interface StudentSearchResult {
+    id: string;
+    name: string;
+    email: string;
+    givenName: string;
+    familyName: string;
+    grades: string[];
+}
+/**
+ * Options for searching students.
+ */
+export interface SearchStudentsOptions {
+    query: string;
+    /** Maximum total results to return */
+    max?: number;
+}
+/**
+ * Result of a student search.
+ */
+export interface StudentSearchResponse {
+    students: StudentSearchResult[];
+    errors: StudioError[];
+}
+//# sourceMappingURL=student-search.d.ts.map

package/dist/server/services/types/student-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"student-search.d.ts","sourceRoot":"","sources":["../../../../src/server/services/types/student-search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAE5C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,EAAE,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,KAAK,EAAE,MAAM,CAAA;IACb,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAA;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,QAAQ,EAAE,mBAAmB,EAAE,CAAA;IAC/B,MAAM,EAAE,WAAW,EAAE,CAAA;CACrB"}

package/dist/types.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Studio Shared Types
+ *
+ * Shared type definitions for server and client.
+ * Used by both server (packages/studio) and client (apps/studio).
+ */
+import type { Caliper } from '@timeback/core/types';
+import type { LoadedUserConfig, StudioEnvironment } from './config/types';
+export type { StudioEnvironment } from './config/types';
+export type { LoadedUserConfig as StudioConfig } from './config/types';
+/**
+ * Standard error codes for Studio API.
+ */
+export type StudioErrorCode = 'USER_FETCH_FAILED' | 'USERS_FETCH_FAILED' | 'COURSE_FETCH_FAILED' | 'COMPONENTS_FETCH_FAILED' | 'COMPONENT_RESOURCES_FETCH_FAILED' | 'RESOURCES_FETCH_FAILED' | 'CLASSES_FETCH_FAILED' | 'ANALYTICS_FETCH_FAILED' | 'ENV_NOT_CONFIGURED' | 'ENV_INVALID' | 'ENROLLMENT_FAILED' | 'UNENROLLMENT_FAILED' | 'UNKNOWN_ERROR';
+/**
+ * Serializable error in Studio API responses.
+ *
+ * Not to be confused with `ApiError` from `@timeback/internal-client-infra`,
+ * which is a throwable Error class for HTTP failures.
+ */
+export interface StudioError {
+    /** Error code for programmatic handling */
+    code: StudioErrorCode;
+    /** Human-readable message */
+    message: string;
+    /** Additional context (e.g., IDs, field names) */
+    details?: Record<string, unknown>;
+}
+/** Payload for 'status' events */
+export interface StatusEventPayload {
+    config: LoadedUserConfig;
+    environment: StudioEnvironment;
+    configuredEnvironments: StudioEnvironment[];
+    hasEmail: boolean;
+}
+/** Payload for 'events' SSE events (Caliper events stream) */
+export interface EventsEventPayload {
+    /** New events since last poll */
+    events: Caliper.StoredEvent[];
+    /** Timestamp of this payload for client-side deduplication */
+    timestamp: string;
+}
+/** Types of updates that can be sent via the multiplexed /api/live endpoint */
+export type LiveUpdateType = 'status' | 'events';
+/** Status update wrapper for live endpoint */
+export interface LiveStatusUpdate {
+    type: 'status';
+    data: StatusEventPayload;
+}
+/** Events update wrapper for live endpoint */
+export interface LiveEventsUpdate {
+    type: 'events';
+    data: EventsEventPayload;
+}
+/** Union of all live update types */
+export type LiveUpdate = LiveStatusUpdate | LiveEventsUpdate;
+/**
+ * Map of SSE event names to their payload types.
+ *
+ * Add new events here as the API grows.
+ */
+export interface StudioEventMap {
+    status: StatusEventPayload;
+    events: EventsEventPayload;
+    live: LiveUpdate[];
+}
+/** Union of all valid SSE event names */
+export type StudioEventName = keyof StudioEventMap;
+/**
+ * Event handlers for a subset of studio events.
+ *
+ * @example
+ * ```typescript
+ * const handlers: StudioEventHandlers<'status' | 'enrollment'> = {
+ *   status: (data) => setStatus(data),
+ *   enrollment: (data) => handleEnrollment(data),
+ * }
+ * ```
+ */
+export type StudioEventHandlers<K extends StudioEventName = StudioEventName> = {
+    [E in K]?: (data: StudioEventMap[E]) => void;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAGzE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AACvD,YAAY,EAAE,gBAAgB,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAMtE;;GAEG;AACH,MAAM,MAAM,eAAe,GAExB,mBAAmB,GACnB,oBAAoB,GACpB,qBAAqB,GACrB,yBAAyB,GACzB,kCAAkC,GAClC,wBAAwB,GACxB,sBAAsB,GACtB,wBAAwB,GAExB,oBAAoB,GACpB,aAAa,GAEb,mBAAmB,GACnB,qBAAqB,GAErB,eAAe,CAAA;AAElB;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC3B,2CAA2C;IAC3C,IAAI,EAAE,eAAe,CAAA;IACrB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAMD,kCAAkC;AAClC,MAAM,WAAW,kBAAkB;IAClC,MAAM,EAAE,gBAAgB,CAAA;IACxB,WAAW,EAAE,iBAAiB,CAAA;IAC9B,sBAAsB,EAAE,iBAAiB,EAAE,CAAA;IAC3C,QAAQ,EAAE,OAAO,CAAA;CACjB;AAED,8DAA8D;AAC9D,MAAM,WAAW,kBAAkB;IAClC,iCAAiC;IACjC,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,CAAA;IAC7B,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAA;CACjB;AAMD,+EAA+E;AAC/E,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAEhD,8CAA8C;AAC9C,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,QAAQ,CAAA;IACd,IAAI,EAAE,kBAAkB,CAAA;CACxB;AAED,8CAA8C;AAC9C,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,QAAQ,CAAA;IACd,IAAI,EAAE,kBAAkB,CAAA;CACxB;AAED,qCAAqC;AACrC,MAAM,MAAM,UAAU,GAAG,gBAAgB,GAAG,gBAAgB,CAAA;AAM5D;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,kBAAkB,CAAA;IAC1B,MAAM,EAAE,kBAAkB,CAAA;IAC1B,IAAI,EAAE,UAAU,EAAE,CAAA;CAClB;AAED,yCAAyC;AACzC,MAAM,MAAM,eAAe,GAAG,MAAM,cAAc,CAAA;AAMlD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,IAAI;KAC7E,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,IAAI;CAC5C,CAAA"}