@timeback/masterytrack 0.1.1-beta.20260219190739

package/dist/lib/index.d.ts

@@ -0,0 +1,4 @@
+export { isTransportConfig, resolveMasteryTrackConfig } from './resolve';
+export { MasteryTrackJwtProvider } from './token-provider';
+export { Transport } from './transport';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAA;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA"}

package/dist/lib/resolve.d.ts

@@ -0,0 +1,25 @@
+/**
+ * MasteryTrack Config Resolution
+ */
+import type { MasteryTrackAuth, MasteryTrackClientConfig, MasteryTrackTransportConfig } from '../types';
+interface ResolvedMasteryTrackConfig {
+    baseUrl: string;
+    auth: MasteryTrackAuth;
+    timeout: number;
+}
+/**
+ * Check whether config is using custom transport mode.
+ *
+ * @param config - Client config
+ * @returns True when config is transport mode
+ */
+declare function isTransportConfig(config: MasteryTrackClientConfig): config is MasteryTrackTransportConfig;
+/**
+ * Resolve MasteryTrack config into concrete base URL/auth/timeout values.
+ *
+ * @param config - Client config input
+ * @returns Resolved configuration for transport initialization
+ */
+export declare function resolveMasteryTrackConfig(config: MasteryTrackClientConfig): ResolvedMasteryTrackConfig;
+export { isTransportConfig };
+//# sourceMappingURL=resolve.d.ts.map

package/dist/lib/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/lib/resolve.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EACX,gBAAgB,EAChB,wBAAwB,EAExB,2BAA2B,EAC3B,MAAM,UAAU,CAAA;AAIjB,UAAU,0BAA0B;IACnC,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,gBAAgB,CAAA;IACtB,OAAO,EAAE,MAAM,CAAA;CACf;AAkBD;;;;;GAKG;AACH,iBAAS,iBAAiB,CACzB,MAAM,EAAE,wBAAwB,GAC9B,MAAM,IAAI,2BAA2B,CAEvC;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACxC,MAAM,EAAE,wBAAwB,GAC9B,0BAA0B,CAoC5B;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAA"}

package/dist/lib/token-provider.d.ts

@@ -0,0 +1,34 @@
+/**
+ * MasteryTrack JWT Provider
+ *
+ * Acquires and caches JWT tokens via POST /authorizer.
+ */
+import type { MasteryTrackAuth } from '../types';
+import type { AuthCheckResult } from '@timeback/internal-client-infra';
+interface MasteryTrackJwtProviderConfig {
+    baseUrl: string;
+    auth: MasteryTrackAuth;
+    fetch?: typeof globalThis.fetch;
+    refreshAfterMs?: number;
+}
+/**
+ * JWT provider for MasteryTrack API access.
+ *
+ * Calls `/authorizer` using `x-api-key` and caches JWT responses.
+ */
+export declare class MasteryTrackJwtProvider {
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    private readonly apiKey;
+    private readonly defaultEmail;
+    private readonly refreshAfterMs;
+    private token?;
+    private tokenEmail?;
+    private refreshAt;
+    constructor(config: MasteryTrackJwtProviderConfig);
+    getToken(emailOverride?: string): Promise<string>;
+    invalidate(): void;
+    checkAuth(): Promise<AuthCheckResult>;
+}
+export {};
+//# sourceMappingURL=token-provider.d.ts.map

package/dist/lib/token-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-provider.d.ts","sourceRoot":"","sources":["../../src/lib/token-provider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AAatE,UAAU,6BAA6B;IACtC,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,gBAAgB,CAAA;IACtB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;;;GAIG;AACH,qBAAa,uBAAuB;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,KAAK,CAAC,CAAQ;IACtB,OAAO,CAAC,UAAU,CAAC,CAAQ;IAC3B,OAAO,CAAC,SAAS,CAAI;IAErB,YAAY,MAAM,EAAE,6BAA6B,EAMhD;IAEK,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA+CtD;IAED,UAAU,IAAI,IAAI,CAIjB;IAEK,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC,CAiB1C;CACD"}

package/dist/lib/transport.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Transport Layer
+ *
+ * HTTP transport for MasteryTrack API communication.
+ */
+import { BaseTransport } from '@timeback/internal-client-infra';
+import type { RequestOptions } from '@timeback/internal-client-infra';
+import type { MasteryTrackJwtProvider } from './token-provider';
+interface TransportInit {
+    baseUrl: string;
+    timeout?: number;
+    jwtProvider: MasteryTrackJwtProvider;
+    fetch?: typeof globalThis.fetch;
+}
+/**
+ * HTTP transport for MasteryTrack API communication.
+ *
+ * MasteryTrack expects auth via X-Auth-Token (Bearer JWT) header
+ * rather than Authorization.
+ */
+export declare class Transport extends BaseTransport {
+    private readonly jwtProvider;
+    constructor(config: TransportInit);
+    requestRaw(path: string, options?: RequestOptions): Promise<Response>;
+    protected handleErrorResponse(response: Response, requestId?: string): Promise<never>;
+}
+export {};
+//# sourceMappingURL=transport.d.ts.map

package/dist/lib/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/lib/transport.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAA;AAI/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAE/D,UAAU,aAAa;IACtB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,uBAAuB,CAAA;IACpC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAC/B;AAED;;;;;GAKG;AACH,qBAAa,SAAU,SAAQ,aAAa;IAC3C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyB;IAErD,YAAY,MAAM,EAAE,aAAa,EAUhC;IAEc,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAOvF;IAED,UAAmB,mBAAmB,CACrC,QAAQ,EAAE,QAAQ,EAClB,SAAS,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,KAAK,CAAC,CAMhB;CACD"}

package/dist/public-types.d.ts

@@ -0,0 +1,210 @@
+/**
+ * MasteryTrack Types
+ *
+ * Types for the MasteryTrack API integration.
+ */
+
+interface MasteryTrackErrorDetails {
+	[key: string]: unknown
+}
+
+/**
+ * Standard error response envelope used by MasteryTrack endpoints.
+ */
+interface MasteryTrackErrorResponse {
+	success: false
+	error: string
+	code?: string
+	details?: MasteryTrackErrorDetails
+}
+
+/**
+ * Authorizer success payload.
+ */
+interface MasteryTrackAuthorizerResponse {
+	success: true
+	jwt: string
+}
+
+interface MasteryTrackInventoryMetadata {
+	url?: string
+	type?: string
+	subType?: string
+	year?: string
+	format?: string
+	questionTypes?: string[]
+	[key: string]: unknown
+}
+
+interface MasteryTrackInventoryItem {
+	id: number
+	timeback_id: string
+	name: string
+	subject: string
+	grade: string
+	grade_rank: number
+	version: number
+	active: boolean
+	metadata?: MasteryTrackInventoryMetadata
+	supported: boolean
+	created_at: string
+	updated_at: string
+	invalidated_on: string | null
+}
+
+interface MasteryTrackInventorySearchResponse {
+	success: true
+	data: MasteryTrackInventoryItem[]
+}
+
+interface MasteryTrackAssignment {
+	id: number
+	student_email: string
+	test_name: string
+	assigned_by?: number
+	test_url: string
+	status: string
+	expires_at?: string
+	metadata?: Record<string, unknown>
+	created_at: string
+}
+
+interface MasteryTrackAssignResponse {
+	success: true
+	platform?: string
+	data: {
+		assignment: MasteryTrackAssignment
+		message: string
+	}
+}
+
+interface MasteryTrackInvalidatedAssignment {
+	assignment_id: number
+	student_email: string
+}
+
+interface MasteryTrackInvalidateResponse {
+	success: true
+	data: {
+		message: string
+		total_invalidated: number
+		invalidated_assignments: MasteryTrackInvalidatedAssignment[]
+	}
+}
+
+type input<T> = T extends {
+    _zod: {
+        input: any;
+    };
+} ? T["_zod"]["input"] : unknown;
+
+/**
+ * MasteryTrack Schemas
+ *
+ * Zod schemas for MasteryTrack requests and responses.
+ */
+
+
+
+declare const MasteryTrackAuthorizerInput = z.object({
+	email: z.email(),
+})
+
+type MasteryTrackAuthorizerInput = input<typeof MasteryTrackAuthorizerInput>
+
+declare const MasteryTrackInventorySearchParams = z.object({
+	name: NonEmptyString.optional(),
+	timeback_id: NonEmptyString.optional(),
+	grade: NonEmptyString.optional(),
+	subject: NonEmptyString.optional(),
+	all: z.boolean().optional(),
+})
+type MasteryTrackInventorySearchParams = input<typeof MasteryTrackInventorySearchParams>
+
+declare const MasteryTrackAssignmentInput = z
+	.object({
+		student_email: z.email(),
+		timeback_id: NonEmptyString.optional(),
+		subject: NonEmptyString.optional(),
+		grade_rank: z.number().int().min(0).max(12).optional(),
+		assessment_line_item_sourced_id: NonEmptyString.optional(),
+		assessment_result_sourced_id: NonEmptyString.optional(),
+	})
+	.superRefine((value, ctx) => {
+		const hasTimebackId = !!value.timeback_id
+		const hasSubject = !!value.subject
+		const hasGradeRank = value.grade_rank !== undefined
+
+		if (!hasTimebackId && !hasSubject) {
+			ctx.addIssue({
+				code: z.ZodIssueCode.custom,
+				message: 'must provide either timeback_id or subject',
+				path: ['timeback_id'],
+			})
+			ctx.addIssue({
+				code: z.ZodIssueCode.custom,
+				message: 'must provide either timeback_id or subject',
+				path: ['subject'],
+			})
+		}
+
+		if (hasGradeRank && !hasSubject) {
+			ctx.addIssue({
+				code: z.ZodIssueCode.custom,
+				message: 'grade_rank requires subject',
+				path: ['grade_rank'],
+			})
+		}
+
+		const hasLineItem = !!value.assessment_line_item_sourced_id
+		const hasResultId = !!value.assessment_result_sourced_id
+
+		if (hasLineItem !== hasResultId) {
+			ctx.addIssue({
+				code: z.ZodIssueCode.custom,
+				message:
+					'assessment_line_item_sourced_id and assessment_result_sourced_id must be provided together',
+				path: hasLineItem
+					? ['assessment_result_sourced_id']
+					: ['assessment_line_item_sourced_id'],
+			})
+		}
+	})
+type MasteryTrackAssignmentInput = input<typeof MasteryTrackAssignmentInput>
+
+declare const MasteryTrackInvalidateAssignmentInput = z
+	.object({
+		student_email: z.email(),
+		assignment_id: z.number().int().positive().optional(),
+		timeback_id: NonEmptyString.optional(),
+		subject: NonEmptyString.optional(),
+		grade_rank: z.number().int().min(0).max(12).optional(),
+	})
+	.superRefine((value, ctx) => {
+		const byAssignment = value.assignment_id !== undefined
+		const byTimeback = !!value.timeback_id
+		const bySubjectGrade = !!value.subject && value.grade_rank !== undefined
+
+		if (!byAssignment && !byTimeback && !bySubjectGrade) {
+			ctx.addIssue({
+				code: z.ZodIssueCode.custom,
+				message:
+					'Either assignment_id, timeback_id, or (subject and grade_rank) is required',
+				path: ['assignment_id'],
+			})
+		}
+
+		if (value.grade_rank !== undefined && !value.subject) {
+			ctx.addIssue({
+				code: z.ZodIssueCode.custom,
+				message: 'grade_rank requires subject',
+				path: ['grade_rank'],
+			})
+		}
+	})
+type MasteryTrackInvalidateAssignmentInput = input<
+	typeof MasteryTrackInvalidateAssignmentInput
+>
+
+export { MasteryTrackAssignmentInput, MasteryTrackAuthorizerInput, MasteryTrackInvalidateAssignmentInput, MasteryTrackInventorySearchParams };
+export type { MasteryTrackAssignResponse, MasteryTrackAssignment, MasteryTrackAuthorizerResponse, MasteryTrackErrorDetails, MasteryTrackErrorResponse, MasteryTrackInvalidateResponse, MasteryTrackInvalidatedAssignment, MasteryTrackInventoryItem, MasteryTrackInventoryMetadata, MasteryTrackInventorySearchResponse };

package/dist/public-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-types.d.ts","sourceRoot":"","sources":["../src/public-types.ts"],"names":[],"mappings":"AAAA,cAAc,wCAAwC,CAAA;AAEtD,YAAY,EACX,2BAA2B,EAC3B,2BAA2B,EAC3B,qCAAqC,EACrC,iCAAiC,GACjC,MAAM,qBAAqB,CAAA"}

package/dist/resources/assignments.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Assignments Resource
+ *
+ * MasteryTrack test assignment operations.
+ */
+import type { MasteryTrackAssignmentInput as MasteryTrackAssignmentInputType, MasteryTrackInvalidateAssignmentInput as MasteryTrackInvalidateAssignmentInputType } from '@timeback/types/zod';
+import type { MasteryTrackAssignResponse, MasteryTrackInvalidateResponse } from '@timeback/types/protocols/masterytrack';
+import type { MasteryTrackTransportLike } from '../types';
+/**
+ * Resource for MasteryTrack assignment operations.
+ */
+export declare class AssignmentsResource {
+    private readonly transport;
+    constructor(transport: MasteryTrackTransportLike);
+    /**
+     * Assign a test to a student.
+     *
+     * @param input - Assignment payload
+     * @returns Assignment response envelope
+     */
+    assign(input: MasteryTrackAssignmentInputType): Promise<MasteryTrackAssignResponse>;
+    /**
+     * Invalidate one or more assignments for a student.
+     *
+     * @param input - Invalidate payload
+     * @returns Invalidate response envelope
+     */
+    invalidate(input: MasteryTrackInvalidateAssignmentInputType): Promise<MasteryTrackInvalidateResponse>;
+}
+//# sourceMappingURL=assignments.d.ts.map

package/dist/resources/assignments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assignments.d.ts","sourceRoot":"","sources":["../../src/resources/assignments.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,KAAK,EACX,2BAA2B,IAAI,+BAA+B,EAC9D,qCAAqC,IAAI,yCAAyC,EAClF,MAAM,qBAAqB,CAAA;AAC5B,OAAO,KAAK,EACX,0BAA0B,EAC1B,8BAA8B,EAC9B,MAAM,wCAAwC,CAAA;AAC/C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAA;AAEzD;;GAEG;AACH,qBAAa,mBAAmB;IACnB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAAtC,YAA6B,SAAS,EAAE,yBAAyB,EAAI;IAErE;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,+BAA+B,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAMlF;IAED;;;;;OAKG;IACH,UAAU,CACT,KAAK,EAAE,yCAAyC,GAC9C,OAAO,CAAC,8BAA8B,CAAC,CAUzC;CACD"}

package/dist/resources/authorizer.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Authorizer Resource
+ *
+ * MasteryTrack authorizer endpoint access.
+ */
+import type { MasteryTrackAuthorizerResponse } from '@timeback/types/protocols/masterytrack';
+import type { MasteryTrackAuthenticatorLike } from '../types';
+/**
+ * Resource for MasteryTrack authorizer operations.
+ */
+export declare class AuthorizerResource {
+    private readonly authenticator;
+    constructor(authenticator: MasteryTrackAuthenticatorLike);
+    /**
+     * Authenticate and return a fresh MasteryTrack JWT.
+     *
+     * @param email - Optional email override for authorizer request
+     * @returns Authorizer success payload with JWT
+     */
+    getToken(email?: string): Promise<MasteryTrackAuthorizerResponse>;
+}
+//# sourceMappingURL=authorizer.d.ts.map

package/dist/resources/authorizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authorizer.d.ts","sourceRoot":"","sources":["../../src/resources/authorizer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAA;AAC5F,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,UAAU,CAAA;AAE7D;;GAEG;AACH,qBAAa,kBAAkB;IAClB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAA1C,YAA6B,aAAa,EAAE,6BAA6B,EAAI;IAE7E;;;;;OAKG;IACG,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAMtE;CACD"}

package/dist/resources/index.d.ts

@@ -0,0 +1,4 @@
+export { AssignmentsResource } from './assignments';
+export { AuthorizerResource } from './authorizer';
+export { InventoryResource } from './inventory';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA"}

package/dist/resources/inventory.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Inventory Resource
+ *
+ * MasteryTrack test inventory operations.
+ */
+import type { MasteryTrackInventorySearchResponse } from '@timeback/types/protocols/masterytrack';
+import type { MasteryTrackInventorySearchParams as MasteryTrackInventorySearchParamsInput } from '@timeback/types/zod';
+import type { MasteryTrackTransportLike } from '../types';
+/**
+ * Resource for MasteryTrack inventory operations.
+ */
+export declare class InventoryResource {
+    private readonly transport;
+    constructor(transport: MasteryTrackTransportLike);
+    /**
+     * Search and filter tests in MasteryTrack inventory.
+     *
+     * @param params - Optional inventory search filters
+     * @returns Inventory search response envelope
+     */
+    search(params?: MasteryTrackInventorySearchParamsInput): Promise<MasteryTrackInventorySearchResponse>;
+}
+//# sourceMappingURL=inventory.d.ts.map

package/dist/resources/inventory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inventory.d.ts","sourceRoot":"","sources":["../../src/resources/inventory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,wCAAwC,CAAA;AACjG,OAAO,KAAK,EACX,iCAAiC,IAAI,sCAAsC,EAC3E,MAAM,qBAAqB,CAAA;AAC5B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAA;AAEzD;;GAEG;AACH,qBAAa,iBAAiB;IACjB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAAtC,YAA6B,SAAS,EAAE,yBAAyB,EAAI;IAErE;;;;;OAKG;IACH,MAAM,CACL,MAAM,GAAE,sCAA2C,GACjD,OAAO,CAAC,mCAAmC,CAAC,CAG9C;CACD"}

package/dist/types/client.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Client Configuration Types
+ */
+import type { RequestOptions } from '@timeback/internal-client-infra';
+import type { AuthCheckResult } from '@timeback/internal-client-infra';
+export type MasteryTrackEnvironment = 'staging' | 'production';
+/**
+ * Credentials used for MasteryTrack authentication.
+ */
+export interface MasteryTrackAuth {
+    apiKey: string;
+    email: string;
+}
+/**
+ * Config for environment mode (uses known MasteryTrack base URLs).
+ */
+export interface MasteryTrackEnvConfig {
+    env?: MasteryTrackEnvironment;
+    auth: MasteryTrackAuth;
+    timeout?: number;
+}
+/**
+ * Config for explicit URL mode.
+ */
+export interface MasteryTrackExplicitConfig {
+    baseUrl: string;
+    auth: MasteryTrackAuth;
+    timeout?: number;
+}
+/**
+ * Authenticator interface for custom transport mode.
+ */
+export interface MasteryTrackAuthenticatorLike {
+    getToken(emailOverride?: string): Promise<string>;
+    invalidate(): void;
+    checkAuth(): Promise<AuthCheckResult>;
+}
+/**
+ * Transport interface for MasteryTrack client.
+ */
+export interface MasteryTrackTransportLike {
+    baseUrl: string;
+    request<T>(path: string, options?: RequestOptions): Promise<T>;
+    requestRaw(path: string, options?: RequestOptions): Promise<Response>;
+}
+/**
+ * Transport mode config for custom transports.
+ */
+export interface MasteryTrackTransportConfig {
+    transport: MasteryTrackTransportLike;
+    authenticator: MasteryTrackAuthenticatorLike;
+}
+/**
+ * All supported MasteryTrack client configuration types.
+ */
+export type MasteryTrackClientConfig = MasteryTrackEnvConfig | MasteryTrackExplicitConfig | MasteryTrackTransportConfig | undefined;
+/**
+ * Instance type of MasteryTrackClient.
+ */
+export type MasteryTrackClientInstance = InstanceType<typeof import('../client').MasteryTrackClient>;
+//# 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,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AAEtE,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,YAAY,CAAA;AAE9D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,GAAG,CAAC,EAAE,uBAAuB,CAAA;IAC7B,IAAI,EAAE,gBAAgB,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IAC1C,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,gBAAgB,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC7C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACjD,UAAU,IAAI,IAAI,CAAA;IAClB,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC,CAAA;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACzC,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IAC9D,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;CACrE;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC3C,SAAS,EAAE,yBAAyB,CAAA;IACpC,aAAa,EAAE,6BAA6B,CAAA;CAC5C;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GACjC,qBAAqB,GACrB,0BAA0B,GAC1B,2BAA2B,GAC3B,SAAS,CAAA;AAEZ;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,YAAY,CACpD,cAAc,WAAW,EAAE,kBAAkB,CAC7C,CAAA"}

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+export type { MasteryTrackAuth, MasteryTrackAuthenticatorLike, MasteryTrackClientConfig, MasteryTrackClientInstance, MasteryTrackEnvironment, MasteryTrackTransportConfig, MasteryTrackTransportLike, } from './client';
+//# 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,YAAY,EACX,gBAAgB,EAChB,6BAA6B,EAC7B,wBAAwB,EACxB,0BAA0B,EAC1B,uBAAuB,EACvB,2BAA2B,EAC3B,yBAAyB,GACzB,MAAM,UAAU,CAAA"}

package/dist/types.d.ts

@@ -0,0 +1,2 @@
+export type { MasteryTrackAuth, MasteryTrackAuthenticatorLike, MasteryTrackClientConfig, MasteryTrackClientInstance, MasteryTrackEnvironment, MasteryTrackTransportConfig, MasteryTrackTransportLike, } 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,YAAY,EACX,gBAAgB,EAChB,6BAA6B,EAC7B,wBAAwB,EACxB,0BAA0B,EAC1B,uBAAuB,EACvB,2BAA2B,EAC3B,yBAAyB,GACzB,MAAM,eAAe,CAAA"}

package/dist/utils.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Utility Functions
+ *
+ * Internal utilities for the MasteryTrack client.
+ */
+/**
+ * Scoped logger for the MasteryTrack client.
+ * Only logs debug/info when DEBUG=1 or DEBUG=true.
+ */
+export declare const log: import("@timeback/internal-logger").Logger;
+//# 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;;;GAGG;AACH,eAAO,MAAM,GAAG,4CAAqC,CAAA"}

package/package.json

@@ -0,0 +1,42 @@
+{
+	"name": "@timeback/masterytrack",
+	"version": "0.1.1-beta.20260219190739",
+	"description": "MasteryTrack client SDK for Timeback",
+	"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/public-types.d.ts",
+			"import": "./dist/public-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"
+	},
+	"dependencies": {
+		"zod": "^4.2.1"
+	},
+	"devDependencies": {
+		"@timeback/internal-client-infra": "0.0.0",
+		"@timeback/internal-utils": "0.0.0",
+		"@timeback/types": "0.0.0",
+		"@types/bun": "latest",
+		"esbuild": "^0.27.3"
+	},
+	"peerDependencies": {
+		"typescript": "^5"
+	}
+}