timeback 0.0.0-alpha.2 → 0.1.0

package/dist/server/types.d.ts

@@ -0,0 +1,300 @@
+/**
+ * Server Types
+ *
+ * Configuration and internal types for the server SDK.
+ */
+import type { TimebackUser } from '../shared/types';
+/**
+ * Environment configuration.
+ */
+export type Environment = 'local' | 'staging' | 'production';
+/**
+ * API credentials for Timeback API calls.
+ */
+export interface ApiCredentials {
+    clientId: string;
+    clientSecret: string;
+}
+/**
+ * OIDC tokens returned from the identity provider.
+ */
+export interface OIDCTokens {
+    /** Access token for API calls */
+    access_token: string;
+    /** ID token containing user claims */
+    id_token?: string;
+    /** Refresh token for obtaining new access tokens */
+    refresh_token?: string;
+    /** Token type (usually "Bearer") */
+    token_type: string;
+    /** Token expiration in seconds */
+    expires_in?: number;
+}
+/**
+ * Identity provider link info (e.g., Google, Facebook).
+ */
+export interface IdentityProviderLink {
+    /** When the identity was linked */
+    dateCreated: string;
+    /** User ID from the external provider */
+    userId: string;
+    /** Provider name (e.g., "Google", "Facebook") */
+    providerName: string;
+    /** Provider type */
+    providerType: string;
+    /** Issuer URL (if applicable) */
+    issuer: string | null;
+    /** Whether this is the primary identity */
+    primary: string;
+}
+/**
+ * User info claims from the identity provider.
+ */
+export interface OIDCUserInfo {
+    /** Subject identifier (unique user ID from IdP) */
+    sub: string;
+    /** User's email address */
+    email?: string;
+    /** Whether email is verified */
+    email_verified?: boolean | string;
+    /** User's full name */
+    name?: string;
+    /** User's given/first name */
+    given_name?: string;
+    /** User's family/last name */
+    family_name?: string;
+    /** User's profile picture URL */
+    picture?: string;
+    /** Username in the IdP */
+    username?: string;
+    /** Linked identity providers (JSON string from Cognito) */
+    identities?: string | IdentityProviderLink[];
+    /** Additional claims */
+    [key: string]: unknown;
+}
+/**
+ * Context passed to buildState hook.
+ */
+export interface BuildStateContext {
+    /** The incoming sign-in request */
+    req: Request;
+    /** Parsed URL for easy access to query params */
+    url: URL;
+}
+/**
+ * Context passed to onCallbackSuccess hook.
+ */
+export interface CallbackSuccessContext<TState = unknown> {
+    /** OIDC tokens from the identity provider */
+    tokens: OIDCTokens;
+    /** User info claims from the identity provider */
+    user: OIDCUserInfo;
+    /** State data from buildState (if provided) */
+    state: TState;
+    /** The incoming callback request */
+    req: Request;
+    /** Helper to create a redirect response */
+    redirect: (url: string, headers?: HeadersInit) => Response;
+    /** Helper to create a JSON response */
+    json: <T>(data: T, status?: number, headers?: HeadersInit) => Response;
+}
+/**
+ * Context passed to onCallbackError hook.
+ */
+export interface CallbackErrorContext<TState = unknown> {
+    /** The error that occurred */
+    error: Error;
+    /** Error code from OIDC provider (if available) */
+    errorCode?: string;
+    /** State data from buildState (if available) */
+    state: TState | undefined;
+    /** The incoming callback request */
+    req: Request;
+    /** Helper to create a redirect response */
+    redirect: (url: string, headers?: HeadersInit) => Response;
+    /** Helper to create a JSON response */
+    json: <T>(data: T, status?: number, headers?: HeadersInit) => Response;
+}
+/**
+ * SSO identity configuration.
+ *
+ * Provides full control over the OIDC flow without managing user sessions.
+ */
+export interface SsoIdentityConfig<TState = unknown> {
+    mode: 'sso';
+    /** OIDC client ID */
+    clientId: string;
+    /** OIDC client secret */
+    clientSecret: string;
+    /**
+     * Custom OIDC issuer URL.
+     *
+     * Override the default Timeback IdP URL. Useful for:
+     * - Local development with a mock OIDC server
+     * - Self-hosted Timeback instances
+     *
+     * @example 'http://localhost:3001/mock-oidc'
+     */
+    issuer?: string;
+    /**
+     * Custom OAuth redirect URI.
+     *
+     * Override the auto-computed callback URL. Use when your IdP has
+     * pre-configured callback URLs that differ from the SDK default.
+     *
+     * @example 'http://localhost:5174/api/auth/sso/callback/timeback'
+     */
+    redirectUri?: string;
+    /**
+     * Build custom state to pass through the OIDC flow.
+     *
+     * Use this to preserve data across the redirect (e.g., return URL, invite codes).
+     * State is encoded in the OIDC state parameter and returned in onCallbackSuccess.
+     *
+     * @param ctx - Context with request and parsed URL
+     * @returns State object (will be JSON serialized)
+     *
+     * @example
+     * ```typescript
+     * buildState: ({ url }) => ({
+     *   returnTo: url.searchParams.get('returnTo') ?? '/dashboard',
+     *   inviteId: url.searchParams.get('inviteId'),
+     * })
+     * ```
+     */
+    buildState?: (ctx: BuildStateContext) => TState;
+    /**
+     * Called after successful OIDC authentication.
+     *
+     * Use this to:
+     * 1. Upsert the user in your database
+     * 2. Set your own session cookie
+     * 3. Redirect to the appropriate page
+     *
+     * @param ctx - Context with tokens, user info, state, and helpers
+     * @returns Response (typically a redirect)
+     *
+     * @example
+     * ```typescript
+     * onCallbackSuccess: async ({ user, state, redirect }) => {
+     *   await db.user.upsert({ where: { email: user.email }, ... })
+     *   const session = await createSession(user)
+     *   return redirect(state.returnTo ?? '/', {
+     *     'Set-Cookie': `session=${session.id}; HttpOnly; Path=/`,
+     *   })
+     * }
+     * ```
+     */
+    onCallbackSuccess: (ctx: CallbackSuccessContext<TState>) => Promise<Response> | Response;
+    /**
+     * Called when OIDC authentication fails.
+     *
+     * @param ctx - Context with error info and helpers
+     * @returns Response (typically a redirect to an error page)
+     *
+     * @example
+     * ```typescript
+     * onCallbackError: ({ error, redirect }) => {
+     *   console.error('SSO failed:', error)
+     *   return redirect('/login?error=sso_failed')
+     * }
+     * ```
+     */
+    onCallbackError?: (ctx: CallbackErrorContext<TState>) => Promise<Response> | Response;
+    /**
+     * Get the current user from the request.
+     *
+     * This is called by the activity handler to associate activities with users.
+     * Read your session cookie/JWT and return the user, or undefined if not authenticated.
+     *
+     * @param req - The incoming request
+     * @returns User object or undefined
+     *
+     * @example
+     * ```typescript
+     * // Async (with database/session lookup)
+     * getUser: async (req) => {
+     *   const session = await getSession(req)
+     *   if (!session) return undefined
+     *   return { id: session.userId, email: session.email }
+     * }
+     *
+     * // Sync (already have user in memory)
+     * getUser: (req) => currentUser
+     * ```
+     */
+    getUser: (req: Request) => Promise<TimebackUser | undefined> | TimebackUser | undefined;
+}
+/**
+ * Custom identity configuration.
+ *
+ * Use when you have your own auth system (Clerk, Auth0, etc.).
+ */
+export interface CustomIdentityConfig {
+    mode: 'custom';
+    /**
+     * Get the current user from the request.
+     *
+     * Read your session cookie/JWT and return the user, or undefined if not authenticated.
+     * Can return synchronously or as a Promise.
+     *
+     * @param req - The incoming request
+     * @returns User object or undefined (sync or async)
+     */
+    getUser: (req: Request) => Promise<TimebackUser | undefined> | TimebackUser | undefined;
+}
+/**
+ * Identity configuration (SSO or custom).
+ */
+export type IdentityConfig<TState = unknown> = SsoIdentityConfig<TState> | CustomIdentityConfig;
+/**
+ * Full Timeback SDK configuration.
+ */
+export interface TimebackConfig<TState = unknown> {
+    /** Optional path to timeback.config.ts (auto-discovered if not provided) */
+    configPath?: string;
+    /** Environment */
+    env: Environment;
+    /** API credentials for Timeback API */
+    api: ApiCredentials;
+    /** Identity configuration */
+    identity: IdentityConfig<TState>;
+}
+/**
+ * Request handlers namespace.
+ */
+export interface Handlers {
+    /** Activity submission handler */
+    activity: (req: Request) => Promise<Response>;
+    /** Identity-related handlers */
+    identity: {
+        /** Initiate sign-in (SSO only) */
+        signIn: (req: Request) => Promise<Response>;
+        /** Handle OAuth callback (SSO only) */
+        callback: (req: Request) => Promise<Response>;
+        /** Sign out user */
+        signOut: () => Response;
+    };
+    /** User profile handler */
+    user: {
+        /** Get current user profile */
+        me: (req: Request) => Promise<Response>;
+    };
+}
+/**
+ * App configuration from timeback.config.ts.
+ */
+export interface AppConfig {
+    name: string;
+    sensors: string[];
+}
+/**
+ * Timeback SDK instance (framework-agnostic).
+ */
+export interface TimebackInstance<TState = unknown> {
+    /** Configuration */
+    config: TimebackConfig<TState>;
+    /** Request handlers */
+    handle: Handlers;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/shared/constants.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Shared Constants
+ */
+/** Default base path for Timeback API routes */
+export declare const DEFAULT_BASE_PATH = "/api/timeback";
+/** API route paths */
+export declare const ROUTES: {
+    readonly ACTIVITY: "/activity";
+    readonly IDENTITY: {
+        readonly SIGNIN: "/identity/signin";
+        readonly SIGNOUT: "/identity/signout";
+        readonly CALLBACK: "/identity/callback";
+    };
+    readonly USER: {
+        readonly ME: "/user/me";
+    };
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/shared/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/shared/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,gDAAgD;AAChD,eAAO,MAAM,iBAAiB,kBAAkB,CAAA;AAEhD,sBAAsB;AACtB,eAAO,MAAM,MAAM;;;;;;;;;;CAUT,CAAA"}

package/dist/shared/types.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Shared Types
+ *
+ * Types shared between client and server.
+ */
+/**
+ * User identity returned from SSO.
+ */
+export interface TimebackIdentity {
+    id: string;
+    email: string;
+    name?: string;
+}
+/**
+ * @deprecated Use TimebackIdentity instead
+ */
+export type TimebackUser = TimebackIdentity;
+/**
+ * Timeback user profile with enriched data from the Timeback API.
+ */
+export interface TimebackProfile {
+    /** User identity */
+    id: string;
+    email: string;
+    name?: string;
+    /** School information */
+    school?: {
+        id: string;
+        name: string;
+    };
+    /** Grade level */
+    grade?: number;
+    /** XP earned on this app */
+    xp?: number;
+    /** Enrolled courses */
+    courses?: Array<{
+        id: string;
+        code: string;
+        name: string;
+    }>;
+    /** Goals and progress */
+    goals?: {
+        dailyXp?: number;
+        dailyLessons?: number;
+        dailyActiveMinutes?: number;
+    };
+}
+/**
+ * Activity start parameters.
+ */
+export interface ActivityParams {
+    /** Unique identifier for the learning object */
+    id: string;
+    /** Display name of the activity */
+    name: string;
+    /** Course code from timeback.config.ts (e.g., 'FASTMATH-1') */
+    courseCode: string;
+}
+/**
+ * Activity metrics (optional performance data).
+ */
+export interface ActivityMetrics {
+    /** Total questions attempted */
+    totalQuestions?: number;
+    /** Number of correct answers */
+    correctQuestions?: number;
+    /** XP earned from this activity */
+    xpEarned?: number;
+    /** Number of units mastered */
+    masteredUnits?: number;
+}
+/**
+ * Activity state sent to the server when ending.
+ */
+export interface ActivityEndPayload {
+    /** Unique identifier for the learning object */
+    id: string;
+    /** Display name of the activity */
+    name: string;
+    /** Course code from timeback.config.ts */
+    courseCode: string;
+    /** ISO 8601 timestamp when activity started */
+    startedAt: string;
+    /** ISO 8601 timestamp when activity ended */
+    endedAt: string;
+    /** Active time in milliseconds (excluding paused time) */
+    elapsedMs: number;
+    /** Total paused time in milliseconds */
+    pausedMs: number;
+    /** Activity metrics */
+    metrics: ActivityMetrics;
+}
+/**
+ * Activity submission response.
+ */
+export interface ActivityResponse {
+    success: boolean;
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,gBAAgB,CAAA;AAE3C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,oBAAoB;IACpB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb,yBAAyB;IACzB,MAAM,CAAC,EAAE;QACR,EAAE,EAAE,MAAM,CAAA;QACV,IAAI,EAAE,MAAM,CAAA;KACZ,CAAA;IAED,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd,4BAA4B;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAA;IAEX,uBAAuB;IACvB,OAAO,CAAC,EAAE,KAAK,CAAC;QACf,EAAE,EAAE,MAAM,CAAA;QACV,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,MAAM,CAAA;KACZ,CAAC,CAAA;IAEF,yBAAyB;IACzB,KAAK,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,kBAAkB,CAAC,EAAE,MAAM,CAAA;KAC3B,CAAA;CACD;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,gDAAgD;IAChD,EAAE,EAAE,MAAM,CAAA;IACV,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAA;IACZ,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,gCAAgC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,gCAAgC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,+BAA+B;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,gDAAgD;IAChD,EAAE,EAAE,MAAM,CAAA;IACV,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAA;IACZ,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAA;IAClB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAA;IACjB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAA;IACf,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAA;IACjB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAA;IAChB,uBAAuB;IACvB,OAAO,EAAE,eAAe,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACd"}

package/package.json

@@ -1,30 +1,94 @@
 {
-    "name": "timeback",
-    "version": "0.0.0-alpha.2",
-    "type": "module",
-    "exports": {
-        ".": {
-            "types": "./dist/index.d.ts",
-            "import": "./dist/index.js"
-        }
-    },
-    "main": "dist/index.js",
-    "types": "dist/index.d.ts",
-    "files": [
-        "dist"
-    ],
-    "scripts": {
-        "build": "bun build.ts",
-        "release": "bun publish.ts",
-        "sort": "bunx sort-package-json"
-    },
-    "devDependencies": {
-        "@timeback/internal-utils": "0.0.0",
-        "@types/bun": "latest",
-        "@typescript/native-preview": "^7.0.0-dev.20251217.1",
-        "bun-plugin-dts": "^0.3.0"
-    },
-    "peerDependencies": {
-        "typescript": "^5"
-    }
+	"name": "timeback",
+	"version": "0.1.0",
+	"description": "Timeback SDK for frontend and backend integration",
+	"type": "module",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		},
+		"./client": {
+			"types": "./dist/client.d.ts",
+			"import": "./dist/client.js"
+		},
+		"./react": {
+			"types": "./dist/client/adapters/react/index.d.ts",
+			"import": "./dist/client/adapters/react/index.js"
+		},
+		"./svelte": {
+			"types": "./dist/client/adapters/svelte/index.d.ts",
+			"svelte": "./dist/client/adapters/svelte/index.ts",
+			"import": "./dist/client/adapters/svelte/index.ts"
+		},
+		"./solid": {
+			"types": "./dist/client/adapters/solid/index.d.ts",
+			"solid": "./dist/client/adapters/solid/index.ts",
+			"import": "./dist/client/adapters/solid/index.ts"
+		},
+		"./native": {
+			"types": "./dist/server/adapters/native.d.ts",
+			"import": "./dist/server/adapters/native.js"
+		},
+		"./nextjs": {
+			"types": "./dist/server/adapters/nextjs.d.ts",
+			"import": "./dist/server/adapters/nextjs.js"
+		},
+		"./svelte-kit": {
+			"types": "./dist/server/adapters/svelte-kit.d.ts",
+			"import": "./dist/server/adapters/svelte-kit.js"
+		},
+		"./solid-start": {
+			"types": "./dist/server/adapters/solid-start.d.ts",
+			"import": "./dist/server/adapters/solid-start.js"
+		},
+		"./express": {
+			"types": "./dist/server/adapters/express.d.ts",
+			"import": "./dist/server/adapters/express.js"
+		},
+		"./tanstack-start": {
+			"types": "./dist/server/adapters/tanstack-start.d.ts",
+			"import": "./dist/server/adapters/tanstack-start.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": {
+		"jiti": "^2.6.1",
+		"zod": "^4.2.1"
+	},
+	"devDependencies": {
+		"@timeback/caliper": "0.1.0",
+		"@timeback/internal-cli-infra": "0.0.0",
+		"@timeback/internal-logger": "0.0.0",
+		"@timeback/internal-utils": "0.0.0",
+		"@timeback/types": "0.0.0",
+		"@types/bun": "latest",
+		"@types/express": "^5.0.6",
+		"@types/react": "^19.1.8"
+	},
+	"peerDependencies": {
+		"react": "^18 || ^19",
+		"solid-js": "^1.9.10",
+		"svelte": "^4 || ^5",
+		"typescript": "^5"
+	},
+	"peerDependenciesMeta": {
+		"react": {
+			"optional": true
+		},
+		"solid-js": {
+			"optional": true
+		},
+		"svelte": {
+			"optional": true
+		}
+	}
 }