@timeback/edubridge 0.1.0

package/dist/types/applications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applications.d.ts","sourceRoot":"","sources":["../../src/types/applications.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CACzC;AAMD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,oBAAoB,EAAE,MAAM,CAAA;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC"}

package/dist/types/base.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Base Types
+ *
+ * Common types shared across Edubridge resources.
+ */
+/**
+ * Resource status.
+ */
+export type Status = 'active' | 'tobedeleted';
+/**
+ * User roles in the system.
+ */
+export type Role = 'administrator' | 'aide' | 'guardian' | 'parent' | 'proctor' | 'relative' | 'student' | 'teacher';
+/**
+ * Enrollment-specific roles.
+ */
+export type EnrollmentRole = 'administrator' | 'proctor' | 'student' | 'teacher';
+/**
+ * Reference to another entity.
+ */
+export interface GUIDRef {
+    href: string;
+    sourcedId: string;
+    type: string;
+}
+/**
+ * Standard Edubridge API response wrapper.
+ */
+export interface DataResponse<T> {
+    data: T;
+}
+/**
+ * Paginated list response with optional metadata.
+ */
+export interface ListResponse<T> {
+    data: T[];
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/types/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/types/base.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,QAAQ,GAAG,aAAa,CAAA;AAE7C;;GAEG;AACH,MAAM,MAAM,IAAI,GACb,eAAe,GACf,MAAM,GACN,UAAU,GACV,QAAQ,GACR,SAAS,GACT,UAAU,GACV,SAAS,GACT,SAAS,CAAA;AAEZ;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAA;AAEhF;;GAEG;AACH,MAAM,WAAW,OAAO;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;CACZ;AAMD;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAA;CACP;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC9B,IAAI,EAAE,CAAC,EAAE,CAAA;CACT"}

package/dist/types/client.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Client Configuration Types
+ */
+import type { ClientConfig, EdubridgePaths, ProviderClientConfig, RequestOptions, ResolvedProvider, TransportConfigWithTokenProvider, TransportOnlyConfig } from '@timeback/internal-client-infra';
+/**
+ * Re-export vital config types for SDK users.
+ */
+export type { Environment, EnvAuth, ExplicitAuth, Platform } from '@timeback/internal-client-infra';
+/**
+ * Transport interface for Edubridge client.
+ *
+ * Extends base transport requirements with Edubridge-specific paths.
+ * Required when using transport mode with EdubridgeClient.
+ */
+export interface EdubridgeTransportLike {
+    /** Base URL of the API */
+    baseUrl: string;
+    /** API path profiles for Edubridge operations */
+    paths: EdubridgePaths;
+    /** Make an authenticated request */
+    request<T>(path: string, options?: RequestOptions): Promise<T>;
+}
+/**
+ * All supported Edubridge client configuration types.
+ *
+ * Supports four modes:
+ * - **Provider mode**: `{ provider: TimebackProvider }` — pre-built provider with token sharing
+ * - **Environment mode**: `{ platform?, env, auth }` — Timeback hosted APIs
+ * - **Explicit mode**: `{ baseUrl, auth: { authUrl } }` — custom API URLs
+ * - **Transport mode**: `{ transport }` — custom transport with paths
+ *
+ * The `platform` field (in env mode) selects which Timeback implementation to use:
+ * - `'BEYOND_AI'` (default): BeyondAI's Timeback platform
+ * - `'LEARNWITH_AI'`: Samy's LearnWith.AI platform
+ */
+export type EdubridgeClientConfig = ClientConfig | TransportOnlyConfig<EdubridgeTransportLike> | ProviderClientConfig;
+/**
+ * Configuration for Edubridge transport.
+ */
+export interface EdubridgeTransportConfig extends TransportConfigWithTokenProvider {
+    /** API path profiles for Edubridge operations */
+    paths: EdubridgePaths;
+}
+/**
+ * Resolved provider type for Edubridge client.
+ */
+export type EdubridgeResolvedProvider = ResolvedProvider<EdubridgeTransportLike>;
+/**
+ * Instance type of EdubridgeClient.
+ */
+export type EdubridgeClientInstance = InstanceType<typeof import('../client').EdubridgeClient>;
+//# sourceMappingURL=client.d.ts.map

package/dist/types/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/types/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACX,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,gCAAgC,EAChC,mBAAmB,EACnB,MAAM,iCAAiC,CAAA;AAExC;;GAEG;AACH,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAEnG;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACtC,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,iDAAiD;IACjD,KAAK,EAAE,cAAc,CAAA;IACrB,oCAAoC;IACpC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;CAC9D;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,qBAAqB,GAC9B,YAAY,GACZ,mBAAmB,CAAC,sBAAsB,CAAC,GAC3C,oBAAoB,CAAA;AAEvB;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,gCAAgC;IACjF,iDAAiD;IACjD,KAAK,EAAE,cAAc,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,gBAAgB,CAAC,sBAAsB,CAAC,CAAA;AAEhF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,YAAY,CAAC,cAAc,WAAW,EAAE,eAAe,CAAC,CAAA"}

package/dist/types/enrollments.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Enrollment Types
+ *
+ * Types for course-centric enrollment management.
+ */
+import type { EnrollmentRole } from './base';
+/**
+ * Course information within an enrollment.
+ */
+export interface EnrollmentCourse {
+    id: string;
+    title: string;
+    metadata: Record<string, unknown>;
+    subjects?: string[] | null;
+    grades?: string[] | null;
+    primaryApp?: {
+        id: string;
+        name: string;
+        domains: string[];
+    } | null;
+}
+/**
+ * School information within an enrollment.
+ */
+export interface EnrollmentSchool {
+    id: string;
+    name: string;
+}
+/**
+ * Enrollment goals metadata.
+ */
+export interface EnrollmentGoals {
+    dailyXp?: number;
+    dailyLessons?: number;
+    dailyActiveMinutes?: number;
+    dailyAccuracy?: number;
+    dailyMasteredUnits?: number;
+}
+/**
+ * Enrollment metrics metadata.
+ */
+export interface EnrollmentMetrics {
+    totalXp?: number;
+    totalLessons?: number;
+    totalGrades?: number;
+    courseType?: string;
+    isSupplemental?: boolean;
+}
+/**
+ * Enrollment metadata.
+ */
+export interface EnrollmentMetadata {
+    goals?: EnrollmentGoals;
+    metrics?: EnrollmentMetrics;
+    [key: string]: unknown;
+}
+/**
+ * Period information for enrollments.
+ */
+export interface EnrollmentPeriod {
+    id: string;
+    title: string;
+    startDate: string | null;
+    endDate: string | null;
+}
+/**
+ * A user's enrollment in a course.
+ */
+export interface Enrollment {
+    id: string;
+    role: EnrollmentRole;
+    beginDate: string | null;
+    endDate: string | null;
+    metadata?: EnrollmentMetadata;
+    course: EnrollmentCourse;
+    school: EnrollmentSchool;
+    periods?: EnrollmentPeriod[];
+}
+/**
+ * Parameters for listing enrollments.
+ */
+export interface ListEnrollmentsParams {
+    /** User ID to filter enrollments by */
+    userId: string;
+}
+/**
+ * Options for enrolling a user in a course.
+ */
+export interface EnrollOptions {
+    /** Optional client-provided ID for the enrollment */
+    sourcedId?: string;
+    /** Role for the enrollment (default: 'student') */
+    role?: EnrollmentRole;
+    /** Start date for the enrollment */
+    beginDate?: string;
+    /** Enrollment metadata including goals and metrics */
+    metadata?: EnrollmentMetadata;
+}
+/**
+ * Response from reset goals operation.
+ */
+export interface ResetGoalsResult {
+    updated: number;
+    errors: string[];
+}
+/**
+ * Default class information for a course.
+ */
+export interface DefaultClass {
+    classSourcedId: string;
+    termSourcedId: string;
+}
+//# sourceMappingURL=enrollments.d.ts.map

package/dist/types/enrollments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrollments.d.ts","sourceRoot":"","sources":["../../src/types/enrollments.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAA;AAM5C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IAC1B,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IACxB,UAAU,CAAC,EAAE;QACZ,EAAE,EAAE,MAAM,CAAA;QACV,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,MAAM,EAAE,CAAA;KACjB,GAAG,IAAI,CAAA;CACR;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,OAAO,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,KAAK,CAAC,EAAE,eAAe,CAAA;IACvB,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,cAAc,CAAA;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,QAAQ,CAAC,EAAE,kBAAkB,CAAA;IAC7B,MAAM,EAAE,gBAAgB,CAAA;IACxB,MAAM,EAAE,gBAAgB,CAAA;IACxB,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAA;CAC5B;AAMD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mDAAmD;IACnD,IAAI,CAAC,EAAE,cAAc,CAAA;IACrB,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,kBAAkB,CAAA;CAC7B;AAMD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,EAAE,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,cAAc,EAAE,MAAM,CAAA;IACtB,aAAa,EAAE,MAAM,CAAA;CACrB"}

package/dist/types/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Edubridge Types
+ *
+ * All entity and domain types for `@timeback/edubridge`.
+ */
+export * from './analytics';
+export * from './applications';
+export * from './base';
+export * from './client';
+export * from './enrollments';
+export * from './learning-reports';
+export * from './subject-track';
+export * from './users';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,QAAQ,CAAA;AACtB,cAAc,UAAU,CAAA;AACxB,cAAc,eAAe,CAAA;AAC7B,cAAc,oBAAoB,CAAA;AAClC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,SAAS,CAAA"}

package/dist/types/learning-reports.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Learning Reports Types
+ *
+ * Types for learning reports endpoints.
+ */
+/**
+ * MAP (Measures of Academic Progress) profile data.
+ */
+export interface MapProfile {
+    userId: string;
+    ritScore?: number;
+    percentile?: number;
+    gradeLevel?: string;
+    testDate?: string;
+    subject?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Time saved metrics for a user.
+ */
+export interface TimeSaved {
+    userId: string;
+    totalMinutesSaved?: number;
+    breakdownBySubject?: Record<string, number>;
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=learning-reports.d.ts.map

package/dist/types/learning-reports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning-reports.d.ts","sourceRoot":"","sources":["../../src/types/learning-reports.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC;AAMD;;GAEG;AACH,MAAM,WAAW,SAAS;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC"}

package/dist/types/subject-track.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Subject Track Types
+ *
+ * Types for subject track management.
+ */
+/**
+ * A subject track mapping subject + grade to a target course.
+ */
+export interface SubjectTrack {
+    id: string;
+    subject: string;
+    gradeLevel: string;
+    targetCourseId: string;
+    targetCourseName?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * A group of subject tracks.
+ */
+export interface SubjectTrackGroup {
+    id: string;
+    name: string;
+    description?: string;
+    tracks: SubjectTrack[];
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Response from the subject tracks list endpoint.
+ */
+export interface SubjectTrackListResponse {
+    subjectTrack: SubjectTrack[];
+}
+/**
+ * Response from the subject track groups endpoint.
+ */
+export interface SubjectTrackGroupsResponse {
+    groups: SubjectTrackGroup[];
+}
+/**
+ * Response from the subject track update (PUT) endpoint.
+ */
+export interface SubjectTrackUpdateResponse {
+    subjectTrack: SubjectTrack;
+}
+/**
+ * Parameters for creating/updating a subject track.
+ */
+export interface SubjectTrackInput {
+    subject: string;
+    gradeLevel: string;
+    targetCourseId: string;
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=subject-track.d.ts.map

package/dist/types/subject-track.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subject-track.d.ts","sourceRoot":"","sources":["../../src/types/subject-track.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,MAAM,CAAA;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,YAAY,EAAE,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC;AAMD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACxC,YAAY,EAAE,YAAY,EAAE,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IAC1C,MAAM,EAAE,iBAAiB,EAAE,CAAA;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IAC1C,YAAY,EAAE,YAAY,CAAA;CAC1B;AAMD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC"}

package/dist/types/users.d.ts

@@ -0,0 +1,107 @@
+/**
+ * User Types
+ *
+ * Types for user management.
+ */
+import type { GUIDRef, Role, Status } from './base';
+/**
+ * User identifier (external ID).
+ */
+export interface UserId {
+    type: string;
+    identifier: string;
+}
+/**
+ * User role assignment.
+ */
+export interface UserRole {
+    roleType: 'primary' | 'secondary';
+    role: Role;
+    org: GUIDRef;
+    userProfile?: string;
+    metadata?: Record<string, unknown> | null;
+    beginDate?: string | null;
+    endDate?: string | null;
+}
+/**
+ * Application credentials for a user.
+ */
+export interface UserCredential {
+    id: string;
+    type: string;
+    username: string;
+    password?: string | null;
+}
+/**
+ * Application info within a user profile.
+ */
+export interface UserApp {
+    sourcedId: string;
+    name: string;
+    description?: string | null;
+    domain: string[];
+    metadata?: Record<string, unknown> | null;
+}
+/**
+ * User profile for an application.
+ */
+export interface UserProfile {
+    profileId: string;
+    profileType: string;
+    vendorId: string;
+    applicationId: string;
+    description?: string | null;
+    app: UserApp;
+    credentials: UserCredential[];
+}
+/**
+ * Primary organization reference.
+ */
+export interface PrimaryOrg {
+    sourcedId: string;
+    name: string;
+}
+/**
+ * A user in the system.
+ */
+export interface User {
+    sourcedId: string;
+    status: Status;
+    dateLastModified: string;
+    metadata?: Record<string, unknown> | null;
+    userMasterIdentifier?: string | null;
+    username?: string | null;
+    userIds: UserId[];
+    enabledUser: boolean;
+    givenName: string;
+    familyName: string;
+    middleName?: string | null;
+    roles: UserRole[];
+    agents: GUIDRef[];
+    userProfiles: UserProfile[];
+    primaryOrg?: PrimaryOrg;
+}
+/**
+ * Parameters for listing users by role.
+ */
+export interface ListUsersParams {
+    /** Fields to include in response */
+    fields?: string;
+    /** Maximum items to return */
+    limit?: number;
+    /** Items to skip */
+    offset?: number;
+    /** Field to sort by */
+    sort?: string;
+    /** Sort order */
+    orderBy?: 'asc' | 'desc';
+    /** OneRoster filter expression */
+    filter?: string;
+    /** Free-text search */
+    search?: string;
+    /** Roles to filter by (required) */
+    roles: Role[];
+    /** Organization IDs to filter by */
+    orgSourcedIds?: string[];
+}
+//# sourceMappingURL=users.d.ts.map

package/dist/types/users.d.ts.map

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

package/dist/types.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Subpath export for all entity types.
+ *
+ * @example
+ * ```typescript
+ * import type { Enrollment, User } from '@timeback/edubridge/types'
+ * ```
+ */
+export * from './types/index';
+//# 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;;;;;;;GAOG;AAEH,cAAc,eAAe,CAAA"}

package/dist/utils.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Utility Functions
+ *
+ * Internal utilities for the Edubridge client.
+ */
+import type { AggregatedMetrics, DailyActivityMap } from './types/analytics';
+/**
+ * Scoped logger for the Edubridge client.
+ * Only logs debug/info when DEBUG=1 or DEBUG=true.
+ */
+export declare const log: import("@timeback/internal-logger").Logger;
+/**
+ * Normalize a boolean-like value to a boolean.
+ *
+ * The Beyond-AI API sometimes returns boolean fields as strings (`"true"`/`"false"`).
+ * This normalizes them to actual booleans for a stable, predictable API.
+ *
+ * @param value - Boolean-like value from the API
+ * @returns Normalized boolean
+ */
+export declare function normalizeBoolean(value: boolean | string): boolean;
+/**
+ * Normalize a User object from the API.
+ *
+ * Applies all necessary field normalizations to ensure consistent types.
+ * Currently normalizes:
+ * - `enabledUser`: string → boolean
+ *
+ * @param user - Raw user from the API
+ * @returns User with normalized fields
+ */
+export declare function normalizeUser<T extends {
+    enabledUser: boolean;
+}>(user: T): T;
+/**
+ * Normalize a date string to full ISO 8601 format.
+ *
+ * The Edubridge API requires full ISO 8601 datetime format (e.g., `2025-12-25T00:00:00.000Z`).
+ * This function accepts multiple input formats for developer convenience:
+ * - Date-only: `2025-12-25` → `2025-12-25T00:00:00.000Z`
+ * - Full ISO: `2025-12-25T10:30:00.000Z` → passed through unchanged
+ * - Date object: `new Date()` → `.toISOString()`
+ *
+ * @param date - Date string or Date object
+ * @returns Full ISO 8601 datetime string, or undefined if input is undefined
+ */
+export declare function normalizeDate(date: string | Date | undefined): string | undefined;
+/**
+ * Aggregate activity metrics from a DailyActivityMap.
+ *
+ * Sums up all metrics across dates and subjects into a single totals object.
+ *
+ * @param data - Activity data grouped by date and subject
+ * @returns Aggregated totals
+ *
+ * @example
+ * ```typescript
+ * const activity = await client.analytics.getActivity({ ... })
+ * const totals = aggregateActivityMetrics(activity)
+ * console.log(`Total XP: ${totals.totalXp}`)
+ * ```
+ */
+export declare function aggregateActivityMetrics(data: DailyActivityMap): AggregatedMetrics;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAE5E;;;GAGG;AACH,eAAO,MAAM,GAAG,4CAAkC,CAAA;AAElD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAGjE;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS;IAAE,WAAW,EAAE,OAAO,CAAA;CAAE,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAK5E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CA8BjF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,gBAAgB,GAAG,iBAAiB,CAoClF"}

package/package.json

@@ -0,0 +1,40 @@
+{
+	"name": "@timeback/edubridge",
+	"version": "0.1.0",
+	"type": "module",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		},
+		"./errors": {
+			"types": "./dist/errors.d.ts",
+			"import": "./dist/errors.js"
+		},
+		"./types": {
+			"types": "./dist/types.d.ts",
+			"import": "./dist/types.js"
+		}
+	},
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"build": "bun build.ts",
+		"test": "bun test --no-env-file unit.test.ts"
+	},
+	"devDependencies": {
+		"@timeback/internal-client-infra": "0.0.0",
+		"@timeback/internal-constants": "0.0.0",
+		"@timeback/internal-logger": "0.0.0",
+		"@timeback/internal-test": "0.0.0",
+		"@timeback/internal-utils": "0.0.0",
+		"@timeback/types": "0.0.0",
+		"@types/bun": "latest"
+	},
+	"peerDependencies": {
+		"typescript": "^5"
+	}
+}